BigQuery용 ODBC 및 JDBC 드라이버

소개

사용자가 BigQuery 및 GoogleSQL의 기능을 활용할 수 있도록 Google은 Simba와 협력하여 전용 Java Database Connectivity(JDBC) 및 Open Database Connectivity(ODBC) 드라이버를 제공합니다.

JDBC 및 ODBC 드라이버를 사용하면 원하는 도구 및 인프라로 BigQuery를 사용할 수 있습니다. 이러한 드라이버를 통해 BigQuery API를 통해서만 사용할 수 있는 고성능 스토리지 통합 및 예약 관리와 같은 BigQuery 기능을 이용할 수 있습니다. 이러한 전문 드라이버는 BigQuery용으로 특별히 설계되었으며 다른 제품 또는 서비스에는 사용할 수 없습니다. 추가 라이선스 없이 드라이버를 사용할 수 있습니다.

현재 ODBC 드라이버

다음 드라이버는 ODBC 드라이버의 최신 안정 버전입니다.

ODBC 출시 버전 3.1.5.1022

ODBC 출시 버전 2.5.2.1004

3.x 출시 버전으로 업그레이드하는 것이 좋습니다. 2.5.x 출시 버전은 버그 수정 및 중요 보안 업데이트를 지원하지만 새로운 BigQuery 기능은 3.x 출시 버전에만 추가됩니다.

현재 JDBC 드라이버

다음 드라이버는 JDBC 드라이버의 최신 안정 버전입니다.

JDBC 출시 버전 1.6.3.1004

ODBC HTAPI에 필요한 권한

High-Throughput API(HTAPI)는 ODBC의 선택적 API입니다. HTAPI에 관한 자세한 내용은 설치 및 구성 가이드를 참조하세요.

High-Throughput API를 사용하는 데 필요한 권한을 얻으려면 관리자에게 BigQuery 프로젝트에 대한 BigQuery 읽기 세션 사용자 (roles/bigquery.readSessionUser) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 High-Throughput API를 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

High-Throughput API를 사용하려면 다음 권한이 필요합니다.

  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • bigquery.readsessions.create
  • bigquery.readsessions.getData
  • bigquery.readsessions.update

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

제한사항

  • JDBC 및 ODBC 드라이버는 BigQuery 고성능 로드 또는 내보내기 기능을 지원하지 않습니다. JDBC의 경우 페이지당 결과 제한은 10,000개입니다. 이 한도는 구성할 수 있습니다. DML 문을 사용하여 데이터 삽입을 수행할 수 있지만 이러한 문에는 DML 문 한도가 적용됩니다.
  • JDBC 및 ODBC 드라이버는 GoogleSQL ARRAY 및 STRUCT 데이터 유형을 지원하지 않습니다. 이러한 데이터 유형의 출력이 드라이버에서 요청되면 드라이버는 데이터 유형을 JSON 형식으로 렌더링합니다. JSON 출력을 방지하려면 반복되는 값을 병합하거나 레코드에서 특정 필드를 선택하는 것이 좋습니다.
  • JDBC 및 ODBC 드라이버는 쿼리 프리픽스를 지원하지 않습니다.
  • JDBC 및 ODBC 드라이버는 파라미터화된 쿼리를 지원하지만 파라미터를 사용하여 쿼리를 준비하면 쿼리 검증만 제공됩니다. JDBC 및 ODBC 드라이버를 사용하는 파라미터화된 쿼리는 쿼리 성능에 영향을 미치지 않습니다.

지원

JDBC 및 ODBC 드라이버에 대한 지원은 Cloud Customer Care에서 제공합니다.

가격 책정

드라이버는 무료로 다운로드할 수 있습니다. 하지만 드라이버를 사용하여 쿼리를 실행하는 비용은 구성에 따라 다릅니다.

  • 쿼리 가격은 기본적으로 드라이버의 모든 쿼리에 적용됩니다. 드라이버가 대규모 결과 조합을 지원하도록 구성되지 않는 한 이 가격 책정 모델만 사용됩니다.
  • 드라이버가 대상 테이블에 대규모 결과 조합을 기록하도록 구성된 경우 스토리지 가격은 쿼리 가격과 별도로 적용됩니다. 이 데이터는 24시간 동안 저장되며 이 기간 동안 스토리지 요금이 발생합니다.
  • Storage API 가격 책정은 드라이버를 사용하여 Storage API를 호출하는 경우에만 적용됩니다. 이 가격 책정 모델은 쿼리 결과에서 직접 읽은 데이터에 적용되며 쿼리 실행 중에 검색된 데이터에는 적용되지 않습니다. Storage API 가격 책정은 대규모 결과 집합에만 적용됩니다.

다음 단계

  • Simba ODBC 드라이버 또는 DataHub를 사용하여 BigQuery에 연결하는 Microsoft Power BI의 오류 메시지를 해결하려면 BigQuery 문제 해결 페이지를 참고하세요.