Utilizzare il driver ODBC per BigQuery

Il driver Open Database Connectivity (ODBC) per BigQuery connette le tue applicazioni non Java a BigQuery, consentendoti di utilizzare le funzionalità di BigQuery con gli strumenti e l'infrastruttura che preferisci. Per connettere le applicazioni Java a BigQuery, utilizza il driver JDBC per BigQuery.

Il driver ODBC per BigQuery è disponibile con la licenza Apache 2.0.

Prima di iniziare

1. Assicurati di avere familiarità con i driver ODBC e i gestori dei driver.

2. Assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

   Sistema operativo	Architetture supportate	Versione minima e dipendenze
   Windows	32 bit (x86), 64 bit (x64)	Versione: Windows 10, Windows Server 2016 o versioni successive Dipendenza: Microsoft Visual C++ Redistributable per Visual Studio 2019 o 2022
   macOS	64 bit (x86_64), ARM64 (Apple Silicon)	Versione: macOS 12 (Monterey) o versioni successive Dipendenza: un gestore di driver ODBC (ad esempio unixODBC). Assicurati di aggiungere la directory di installazione a DYLD_LIBRARY_PATH.
   Linux	64 bit (x86_64)	Versione: qualsiasi distribuzione con glibc 2.27 o versioni successive (ad esempio Ubuntu 20.04 LTS+, Debian 11+) Dipendenza: un gestore di driver ODBC (ad esempio unixODBC). Assicurati di aggiungere la directory di installazione a LD_LIBRARY_PATH.

3. Autenticati in BigQuery e prendi nota delle seguenti informazioni, che verranno utilizzate in un secondo momento quando stabilisci una connessione con il driver ODBC per BigQuery. Devi annotare solo le informazioni corrispondenti al metodo di autenticazione che utilizzi.

   Metodo di autenticazione	Informazioni di autenticazione	Esempio	Proprietà della connessione (da impostare in un secondo momento)
   Account di servizio standard	Chiave del service account (oggetto JSON)	my-sa-key	KeyFilePath
   Federazione delle identità per i workload o per la forza lavoro	Proprietà Segmento di pubblico del file di configurazione dell'account esterno	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	File di recupero dei token e informazioni sull'ambiente	{"file":"/path/to/file"}	BYOID_CredentialSource
   	Progetto utente (solo per il pool di forza lavoro)	my_project	BYOID_PoolUserProject
   	Tipo di token STS	id_token	BYOID_SubjectTokenType
   	Endpoint di scambio token STS	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   Credenziali predefinite dell'applicazione	Nessuno	N/D	N/D

Installare e configurare il driver ODBC

Puoi installare e configurare il driver ODBC per BigQuery utilizzando un sistema operativo Windows o non Windows.

Stabilire una connessione

Per stabilire una connessione tra la tua applicazione e BigQuery con il driver ODBC per BigQuery, identifica la stringa di connessione. Puoi saltare questo passaggio se hai già configurato le proprietà di connessione tramite il DSN.

La stringa di connessione ha il seguente formato:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto BigQuery.
• AUTH_TYPE: un numero che specifica il tipo di autenticazione che hai utilizzato. Seleziona una delle seguenti opzioni:
  • 0: per l'autenticazione del account di servizio
  • 3: per l'autenticazione delle credenziali predefinite dell'applicazione
  • 4: per l'autenticazione della federazione delle identità per i workload o della federazione delle identità per la forza lavoro
• AUTH_PROPS: le informazioni di autenticazione che hai annotato quando ti sei autenticato in BigQuery, elencate nel formato property_1=value_1; property_2=value_2;..., ad esempio, KeyFilePath=my-sa-key, se ti sei autenticato con un account di servizio.
• OTHER_PROPS (facoltativo): proprietà di connessione aggiuntive per il driver ODBC, elencate nel formato property_1=value_1; property_2=value_2;.... Per un elenco completo delle proprietà di connessione, consulta Proprietà di connessione.

Proprietà di connessione

Le proprietà di connessione del driver ODBC sono parametri di configurazione che includi nella stringa di connessione quando stabilisci una connessione a un database. Il driver ODBC per BigQuery supporta le seguenti proprietà di connessione.

Mappatura dei tipi di dati

Quando esegui query tramite il driver ODBC per BigQuery, viene eseguito il seguente mapping dei tipi di dati:

Esempi

Gli esempi seguenti mostrano come utilizzare le query con parametri e gli script con più istruzioni con il driver ODBC.

Query con parametri

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

Script con più istruzioni

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

Prezzi

Puoi scaricare il driver ODBC per BigQuery senza costi. Tuttavia, quando utilizzi il driver, si applicano i prezzi standard dell'analisi BigQuery.

Passaggi successivi

• Scopri di più sul driver JDBC per BigQuery.
• Esplora altri strumenti per sviluppatori BigQuery.