Driver ODBC e JDBC per BigQuery

Introduzione

Per consentire agli utenti di sfruttare le funzionalità di BigQuery e GoogleSQL, Google collabora con Simba per fornire driver Java Database Connectivity (JDBC) e Open Database Connectivity (ODBC) dedicati.

I driver JDBC e ODBC ti consentono di utilizzare BigQuery con gli strumenti e l'infrastruttura che preferisci. Questi driver consentono di accedere alle funzionalità di BigQuery come l'integrazione di archiviazione ad alte prestazioni e la gestione delle prenotazioni, che altrimenti sono disponibili solo tramite le API BigQuery. Questi driver specializzati sono progettati specificamente per BigQuery e non possono essere utilizzati con altri prodotti o servizi. Per utilizzare questi driver non sono necessarie licenze aggiuntive.

Driver ODBC attuali

I seguenti driver sono le ultime release stabili del driver ODBC.

ODBC release 3.1.2.1009

ODBC release 2.5.2.1004

Ti consigliamo di eseguire l'upgrade alla versione 3.x. La release 2.5.x è supportata per le correzioni di bug e gli aggiornamenti della sicurezza critici, ma le nuove funzionalità BigQuery vengono aggiunte solo alla release 3.x.

Driver JDBC attuali

I seguenti driver sono le ultime release stabili del driver JDBC.

JDBC release 1.6.3.1004

Autorizzazioni richieste per l'API HTAPI ODBC

L'API High-Throughput (HTAPI) è un'API facoltativa per ODBC. Per ulteriori informazioni sull'HTAPI, consulta la guida all'installazione e alla configurazione.

Per ottenere le autorizzazioni necessarie per utilizzare l'API High-Throughput, chiedi all'amministratore di concederti il ruolo IAM Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser) nel tuo progetto BigQuery. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare l'API High-Throughput. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per utilizzare l'API High-Throughput sono necessarie le seguenti autorizzazioni:

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

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

  • I driver JDBC e ODBC non supportano le funzionalità di caricamento ad alte prestazioni o di esportazione di BigQuery. Per JDBC, il limite di risultati per pagina è 10.000. Questo limite è configurabile. Puoi eseguire inserimenti di dati con le istruzioni DML (Data Manipulation Language), ma queste istruzioni sono soggette ai limiti delle istruzioni DML.
  • I driver JDBC e ODBC non supportano i tipi di dati ARRAY e STRUCT di GoogleSQL. Se i driver richiedono l'output per questi tipi di dati, i driver li visualizzano in formato JSON. Per evitare l'output JSON, valuta la possibilità di appiattire i valori ripetuti o selezionare campi specifici da un record.
  • I driver JDBC e ODBC non supportano i prefissi delle query.
  • I driver JDBC e ODBC supportano le query con parametri, ma la preparazione di una query con parametri fornisce solo la convalida della query. Le query con parametri con i driver JDBC e ODBC non influiscono sul rendimento delle query.

Assistenza

L'assistenza per i driver JDBC e ODBC è disponibile tramite l'assistenza clienti Google Cloud.

Prezzi

I driver sono disponibili per il download senza costi. Tuttavia, i costi per l'esecuzione di query utilizzando i driver variano in base alla configurazione:

  • Prezzi delle query si applicano per impostazione predefinita a tutte le query del driver. Questo è l'unico modello di prezzo utilizzato, a meno che il driver non sia configurato per supportare set di risultati di grandi dimensioni.
  • I prezzi dello spazio di archiviazione si applicano in aggiunta ai prezzi delle query quando il driver è configurato per scrivere set di risultati di grandi dimensioni in una tabella di destinazione. Questi dati vengono archiviati per 24 ore e ti vengono addebitati costi di archiviazione per questa durata.
  • I prezzi dell'API Storage si applicano solo quando utilizzi il driver per richiamare l'API Storage. Questo modello di prezzi copre la lettura dei dati direttamente dai risultati della query, non i dati scansionati durante l'esecuzione della query. È importante notare che i prezzi dell'API Storage si applicano solo a set di risultati di grandi dimensioni.