BigQuery용 ODBC 드라이버 사용

BigQuery용 Open Database Connectivity (ODBC) 드라이버는 Java가 아닌 애플리케이션을 BigQuery에 연결하여 원하는 도구 및 인프라로 BigQuery 기능을 사용할 수 있도록 지원합니다. Java 애플리케이션을 BigQuery에 연결하려면 BigQuery용 JDBC 드라이버를 사용하세요.

BigQuery용 ODBC 드라이버는 Apache 2.0 라이선스에 따라 제공됩니다.

시작하기 전에

1. ODBC 드라이버 및 드라이버 관리자를 숙지해야 합니다.

2. 운영체제가 다음 요구사항을 충족하는지 확인합니다.

   운영체제	지원되는 아키텍처	최소 버전 및 종속 항목
   Windows	32비트 (x86), 64비트 (x64)	버전: Windows 10, Windows Server 2016 이상 종속 항목: Microsoft Visual C++ 재배포 가능 패키지(Visual Studio 2019 또는 2022용)
   macOS	64비트 (x86_64), ARM64 (Apple Silicon)	버전: macOS 12 (Monterey) 이상 종속 항목: ODBC 드라이버 관리자 (예: unixODBC) 설치 디렉터리를 DYLD_LIBRARY_PATH에 추가해야 합니다.
   Linux	64비트 (x86_64)	버전: glibc 2.27 이상이 있는 배포판 (예: Ubuntu 20.04 LTS+, Debian 11+) 종속 항목: ODBC 드라이버 관리자 (예: unixODBC) 설치 디렉터리를 LD_LIBRARY_PATH에 추가해야 합니다.

3. BigQuery에 인증하고 나중에 BigQuery용 ODBC 드라이버와 연결을 설정할 때 사용되는 다음 정보를 기록해 둡니다. 사용하는 인증 방법에 해당하는 정보만 기록하면 됩니다.

   인증 방법	인증 정보	예시	연결 속성 (나중에 설정)
   표준 서비스 계정	서비스 계정 키 (JSON 객체)	my-sa-key	KeyFilePath
   워크로드 아이덴티티 제휴 또는 직원 ID 제휴	외부 계정 구성 파일의 잠재고객 속성	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	토큰 가져오기 및 환경 정보 파일	{"file":"/path/to/file"}	BYOID_CredentialSource
   	사용자 프로젝트 (직원 풀만 해당)	my_project	BYOID_PoolUserProject
   	STS 토큰 유형	id_token	BYOID_SubjectTokenType
   	STS 토큰 교환 엔드포인트	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   애플리케이션 기본 사용자 인증 정보	없음	해당 사항 없음	해당 사항 없음

ODBC 드라이버 설치 및 구성

Windows 또는 비 Windows 운영체제를 사용하여 BigQuery용 ODBC 드라이버를 설치하고 구성할 수 있습니다.

연결 설정

BigQuery용 ODBC 드라이버를 사용하여 애플리케이션과 BigQuery 간의 연결을 설정하려면 연결 문자열을 식별하세요. DSN을 통해 연결 속성을 이미 구성한 경우 이 단계를 건너뛸 수 있습니다.

연결 문자열의 형식은 다음과 같습니다.

Driver=ODBC Driver for BigQuery;ProjectId=PROJECT_ID;OAuthType=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

다음을 바꿉니다.

• PROJECT_ID: BigQuery 프로젝트의 ID입니다.
• AUTH_TYPE: 사용한 인증 유형을 지정하는 숫자입니다. 다음 중 하나를 선택합니다.
  • 0: 서비스 계정 인증
  • 3: 애플리케이션 기본 사용자 인증 정보 인증
  • 4: 워크로드 아이덴티티 제휴 또는 직원 ID 제휴 인증
• AUTH_PROPS: BigQuery에 인증할 때 기록한 인증 정보입니다. property_1=value_1; property_2=value_2;... 형식으로 나열됩니다. 예를 들어 서비스 계정으로 인증한 경우 KeyFilePath=my-sa-key입니다.
• OTHER_PROPS (선택사항): property_1=value_1; property_2=value_2;... 형식으로 나열된 ODBC 드라이버의 추가 연결 속성입니다. 연결 속성의 전체 목록은 연결 속성을 참고하세요.

연결 속성

ODBC 드라이버 연결 속성은 데이터베이스에 연결을 설정할 때 연결 문자열에 포함하는 구성 매개변수입니다. BigQuery용 ODBC 드라이버는 다음 연결 속성을 지원합니다.

데이터 유형 매핑

BigQuery용 ODBC 드라이버를 통해 쿼리를 실행하면 다음 데이터 유형 매핑이 발생합니다.

예시

다음 예에서는 ODBC 드라이버를 사용하여 매개변수화된 쿼리와 다중 문 스크립트를 사용하는 방법을 보여줍니다.

매개변수화된 쿼리

// 1. Prepare statement
std::string insert_stmt = "INSERT INTO MyTable VALUES (?, ?, ?)";
status = SQLPrepare(hstmt, (SQLCHAR*)insert_stmt.c_str(), SQL_NTS);

// 2. Bind parameters
std::string str_val = "example_string";
long long int_val = 12345;
double float_val = 1.2345;

// Bind string field
status = SQLBindParameter(
    hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR, 50, 0,
    (SQLPOINTER)str_val.c_str(), str_val.size(), NULL);

// Bind integer field
status = SQLBindParameter(
    hstmt, 2, SQL_PARAM_INPUT, SQL_C_UBIGINT, SQL_BIGINT, 0, 0,
    &int_val, 0, NULL);

// Bind float field
status = SQLBindParameter(
    hstmt, 3, SQL_PARAM_INPUT, SQL_C_DOUBLE, SQL_DOUBLE, 0, 0,
    &float_val, 0, NULL);

// 3. Execute statement
status = SQLExecute(hstmt);

멀티 문 스크립트

// 1. Prepare and execute the multi-statement script
std::string query =
    "CREATE OR REPLACE TABLE MyTable (StringField STRING, IntegerField INTEGER); "
    "INSERT INTO MyTable VALUES ('example', 123); "
    "SELECT * FROM MyTable;";

status = SQLExecDirect(hstmt, (SQLCHAR*)query.c_str(), SQL_NTS);

// 2. Process results for each statement using SQLMoreResults
do {
    SQLSMALLINT num_cols;
    status = SQLNumResultCols(hstmt, &num_cols);

    if (num_cols > 0) {
        // This is a result-returning statement (e.g., SELECT)
        while (SQLFetch(hstmt) == SQL_SUCCESS) {
            // Process rows...
        }
    } else {
        // This is a non-result statement (e.g., CREATE, INSERT)
        SQLLEN row_count;
        SQLRowCount(hstmt, &row_count);
        // Process affected rows...
    }
} while (SQLMoreResults(hstmt) == SQL_SUCCESS);

가격 책정

BigQuery용 ODBC 드라이버는 무료로 다운로드할 수 있습니다. 하지만 드라이버를 사용하는 경우 표준 BigQuery 분석 가격 책정이 적용됩니다.

다음 단계

• BigQuery용 JDBC 드라이버에 대해 자세히 알아보세요.
• 다른 BigQuery 개발자 도구를 살펴봅니다.