ODBC-Treiber für BigQuery verwenden

Mit dem ODBC-Treiber (Open Database Connectivity) für BigQuery können Sie Ihre Nicht-Java-Anwendungen mit BigQuery verbinden und BigQuery-Funktionen mit Ihren bevorzugten Tools und Infrastrukturen nutzen. Wenn Sie Java-Anwendungen mit BigQuery verbinden möchten, verwenden Sie den JDBC-Treiber für BigQuery.

Der ODBC-Treiber für BigQuery ist unter der Apache 2.0-Lizenz verfügbar.

Hinweis

1. Machen Sie sich mit ODBC-Treibern und Treibermanagern vertraut.

2. Ihr Betriebssystem muss die folgenden Anforderungen erfüllen:

   Betriebssystem	Unterstützte Architekturen	Mindestversion und Abhängigkeiten
   Windows	32-Bit (x86), 64-Bit (x64)	Version: Windows 10, Windows Server 2016 oder höher Abhängigkeit: Microsoft Visual C++ Redistributable für Visual Studio 2019 oder 2022
   macOS	64-Bit (x86_64), ARM64 (Apple Silicon)	Version: macOS 12 (Monterey) oder höher Abhängigkeit: Ein ODBC-Treibermanager (z. B. unixODBC). Fügen Sie das Installationsverzeichnis zu DYLD_LIBRARY_PATH hinzu.
   Linux	64-Bit (x86_64)	Version: Beliebige Distribution mit glibc 2.27 oder höher (z. B. Ubuntu 20.04 LTS+, Debian 11+) Abhängigkeit: Ein ODBC-Treibermanager (z. B. unixODBC). Achten Sie darauf, dass Sie das Installationsverzeichnis zu Ihrer LD_LIBRARY_PATH hinzufügen.

3. Authentifizieren Sie sich bei BigQuery und notieren Sie sich die folgenden Informationen, die später verwendet werden, wenn Sie eine Verbindung mit dem ODBC-Treiber für BigQuery herstellen. Sie müssen nur die Informationen beachten, die der von Ihnen verwendeten Authentifizierungsmethode entsprechen.

   Authentifizierungsmethode	Authentifizierungsinformationen	Beispiel	Verbindungsproperty (wird später festgelegt)
   Standarddienstkonto	Dienstkontoschlüssel (JSON-Objekt)	my-sa-key	KeyFilePath
   Identitätsföderation von Arbeitslasten oder Mitarbeiteridentitätsföderation	Zielgruppen-Property der Konfigurationsdatei für das externe Konto	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	Abrufen von Tokens und Datei mit Umgebungsinformationen	{"file":"/path/to/file"}	BYOID_CredentialSource
   	Nutzerprojekt (nur für Personalpool)	my_project	BYOID_PoolUserProject
   	STS-Tokentyp	id_token	BYOID_SubjectTokenType
   	STS-Tokenaustausch-Endpunkt	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   Standardanmeldedaten für Anwendungen	Keine	–	–

ODBC-Treiber installieren und konfigurieren

Sie können den ODBC-Treiber für BigQuery unter Windows oder einem anderen Betriebssystem installieren und konfigurieren.

Verbindung herstellen

Um eine Verbindung zwischen Ihrer Anwendung und BigQuery mit dem ODBC-Treiber für BigQuery herzustellen, müssen Sie den Verbindungsstring ermitteln. Sie können diesen Schritt überspringen, wenn Sie die Verbindungseigenschaften bereits über Ihren DSN konfiguriert haben.

Der Verbindungsstring hat das folgende Format:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres BigQuery-Projekts.
• AUTH_TYPE: Eine Zahl, die den von Ihnen verwendeten Authentifizierungstyp angibt. Wählen Sie eine der folgenden Optionen aus:
  • 0: für die Dienstkonto-Authentifizierung
  • 3: für die Authentifizierung mit Standardanmeldedaten für Anwendungen
  • 4: für die Authentifizierung mit Identitätsföderation von Arbeitslasten oder Mitarbeiteridentitätsföderation
• AUTH_PROPS: die Authentifizierungsinformationen, die Sie sich bei der Authentifizierung bei BigQuery notiert haben, im Format property_1=value_1; property_2=value_2;..., z. B. KeyFilePath=my-sa-key, wenn Sie sich mit einem Dienstkonto authentifiziert haben.
• OTHER_PROPS (optional): zusätzliche Verbindungseigenschaften für den ODBC-Treiber im Format property_1=value_1; property_2=value_2;.... Eine vollständige Liste der Verbindungseigenschaften finden Sie unter Verbindungseigenschaften.

Verbindungsattribute

ODBC-Treiberverbindungseigenschaften sind Konfigurationsparameter, die Sie in die Verbindungszeichenfolge einfügen, wenn Sie eine Verbindung zu einer Datenbank herstellen. Der ODBC-Treiber für BigQuery unterstützt die folgenden Verbindungseigenschaften.

Datentypzuordnung

Wenn Sie Abfragen über den ODBC-Treiber für BigQuery ausführen, erfolgt die folgende Datentypzuordnung:

Beispiele

Die folgenden Beispiele zeigen, wie parametrisierte Abfragen und Scripts mit mehreren Anweisungen mit dem ODBC-Treiber verwendet werden.

Parametrisierte Abfragen

// 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);

Skripts mit mehreren Anweisungen

// 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);

Preise

Sie können den ODBC-Treiber für BigQuery kostenlos herunterladen. Wenn Sie den Treiber verwenden, gelten jedoch die standardmäßigen Preise für BigQuery-Analysen.

Nächste Schritte

• Weitere Informationen zum JDBC-Treiber für BigQuery
• Weitere BigQuery-Entwicklertools