ODBC- und JDBC-Treiber für BigQuery

Einführung

Damit Nutzer die Funktionen von BigQuery und GoogleSQL nutzen können, arbeitet Google mit Simba zusammen, um spezielle JDBC- (Java Database Connectivity) und ODBC-Treiber (Open Database Connectivity) bereitzustellen.

Mit den JDBC- und ODBC-Treibern können Sie BigQuery mit Ihren bevorzugten Tools und Infrastrukturen verwenden. Mit diesen Treibern können Sie auf BigQuery-Funktionen wie die leistungsstarke Speicherintegration und die Reservierungsverwaltung zugreifen, die ansonsten nur über die BigQuery APIs verfügbar sind. Diese speziellen Treiber sind speziell für BigQuery konzipiert und können nicht mit anderen Produkten oder Diensten verwendet werden. Für die Verwendung dieser Treiber sind keine zusätzlichen Lizenzen erforderlich.

Aktuelle ODBC-Treiber

Die folgenden Treiber sind die neuesten stabilen Releases des ODBC-Treibers.

ODBC-Version 3.1.2.1009

ODBC-Version 2.5.2.1004

Wir empfehlen ein Upgrade auf den 3.x-Release. Der 2.5.x-Release wird für Fehlerkorrekturen und kritische Sicherheitsupdates unterstützt, neue BigQuery-Features werden jedoch nur dem 3.x-Release hinzugefügt.

Aktuelle JDBC-Treiber

Die folgenden Treiber sind die neuesten stabilen Releases des JDBC-Treibers.

JDBC-Version 1.6.3.1004

Erforderliche Berechtigungen für die ODBC HTAPI

Die High-Throughput API (HTAPI) ist eine optionale API für ODBC. Weitere Informationen zur HTAPI finden Sie im Installations- und Konfigurationsleitfaden.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle BigQuery Read Session User (roles/bigquery.readSessionUser) für Ihr BigQuery-Projekt zuzuweisen. Diese Rolle enthält die Berechtigungen, die Sie zum Verwenden der High-Throughput API benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die für die Verwendung der High-Throughput API erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um die High-Throughput API zu verwenden:

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

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Beschränkungen

  • JDBC- und ODBC-Treiber unterstützen die BigQuery-Funktionen für Hochleistungsladen oder Export nicht. Bei JDBC liegt das Limit für Ergebnisse pro Seite bei 10.000. Dieses Limit ist konfigurierbar. Sie können Daten mit DML-Anweisungen (Data Manipulation Language) einfügen. Diese Anweisungen unterliegen jedoch den DML-Anweisungslimits.
  • JDBC- und ODBC-Treiber unterstützen die GoogleSQL-Datentypen ARRAY und STRUCT nicht. Wenn die Ausgabe für diese Datentypen von den Treibern angefordert wird, rendern die Treiber die Datentypen in einem JSON-Format. Um die Ausgabe JSON zu vermeiden, sollten Sie wiederholte Werte vereinfachen oder bestimmte Felder aus einem Datensatz auswählen.
  • JDBC- und ODBC-Treiber unterstützen keine Abfragepräfixe.
  • JDBC- und ODBC-Treiber unterstützen parametrisierte Abfragen, aber durch das Vorbereiten einer Abfrage mit Parametern wird nur die Abfrage validiert. Parametrisierte Abfragen mit den JDBC- und ODBC-Treibern wirken sich nicht auf die Abfrageleistung aus.

Support

Support für die JDBC- und ODBC-Treiber ist bei Cloud Customer Care verfügbar.

Preise

Die Treiber stehen als kostenlose Downloads zur Verfügung. Die Kosten für das Ausführen von Abfragen mit den Treibern variieren jedoch je nach Konfiguration:

  • Abfragepreise gelten standardmäßig für alle Abfragen von dem Treiber. Dieses Preismodell wird nur verwendet, wenn der Treiber nicht für die Unterstützung großer Ergebnismengen konfiguriert ist.
  • Speicherpreise gelten zusätzlich zu Abfragepreisen, wenn der Treiber dafür konfiguriert ist, große Ergebnismengen in eine Zieltabelle zu schreiben. Diese Daten werden 24 Stunden lang gespeichert und für diesen Zeitraum fallen Speichergebühren an.
  • Storage API-Preise gelten nur, wenn Sie den Treiber zum Aufrufen der Storage API verwenden. Dieses Preismodell gilt für Daten, die direkt aus Abfrageergebnissen gelesen werden, nicht für die Daten, die während der Abfrageausführung gescannt werden. Storage API-Preise gelten nur für große Ergebnismengen.