Esegui query federate con Data Boost

Questa pagina spiega come utilizzare Spanner Data Boost durante l'esecuzione di query federate da BigQuery a Spanner. Con Data Boost, le query federate vengono eseguite con un impatto quasi zero sui carichi di lavoro esistenti sull'istanza Spanner di cui è stato eseguito il provisioning.

La federazione di Spanner consente a BigQuery di eseguire query sui dati presenti in Spanner in tempo reale, senza copiare o spostare dati.

Per scoprire di più sulle query federate di Spanner, vedi Query federate di Spanner.

Per informazioni su Data Boost, consulta la panoramica di Data Boost.

Prima di iniziare

Completa le seguenti attività prima di tentare di eseguire query federate con Data Boost.

Abilita l'API BigQuery connection

L'API BigQuery connection consente di gestire le connessioni BigQuery alle origini dati esterne.

  • Attiva BigQuery connection API.

    Abilita l'API

Per maggiori informazioni, consulta API di connessione BigQuery.

Concedi alle entità le autorizzazioni IAM per Data Boost

Le entità devono disporre delle autorizzazioni spanner.instances.get e spanner.databases.useDataBoost Identity and Access Management (IAM) per eseguire query ed esportazioni con Data Boost.

Ti consigliamo di creare un ruolo IAM personalizzato basato su Spanner Database Reader (roles/spanner.databaseReader) e di aggiungere spanner.instances.get e spanner.databases.useDataBoost.

Per saperne di più, vedi Ruoli predefiniti.

Crea connessioni BigQuery per Spanner con Data Boost

Le connessioni BigQuery consentono di eseguire query sui dati archiviati al di fuori di BigQuery. Per stabilire una connessione tra BigQuery e Spanner, devi creare una connessione dati esterna. Puoi quindi eseguire query che uniscono i dati BigQuery con i dati di Spanner.

Per creare una connessione dati esterna a Spanner che utilizza Data Boost, seleziona una delle seguenti opzioni:

Console

  1. Vai a Crea connessioni Spanner nella documentazione di BigQuery e segui le istruzioni per la console.

  2. Nel riquadro Origine dati esterna, seleziona le caselle di controllo Leggi dati in parallelo e Utilizza Spanner Data Boost.

bq

  1. Vai a Crea connessioni Spanner nella documentazione di BigQuery e segui le istruzioni bq.

  2. Imposta le seguenti proprietà di connessione su true:

  • useParallelism
  • useDataBoost

L'esempio seguente utilizza il comando bq mk per creare una nuova connessione denominata my_connection con le due proprietà obbligatorie per Data Boost:

bq mk --connection --connection_type='CLOUD_SPANNER' --location='us' \
--properties='{"database":"projects/my-project/instances/my-instance/databases/my-database", "useParallelism":true, "useDataBoost": true}' my_connection

Esegui una query federata

Per eseguire una query federata con Data Boost, utilizza una connessione a BigQuery che specifichi l'utilizzo di Data Boost. Per maggiori informazioni, consulta Creare connessioni BigQuery per Spanner con Data Boost.

Puoi iniziare dalla pagina Spanner della console Google Cloud o da BigQuery.

Inizia dalla pagina Spanner della console

  1. Vai alla pagina Istanze di Spanner nella console Google Cloud.

    Vai alla pagina Istanze

    La console mostra un elenco delle tue istanze Spanner.

  2. Seleziona un'istanza Spanner, quindi seleziona un database.

  3. Nella pagina Panoramica del database, nel menu di navigazione, fai clic su Spanner Studio.

  4. Fai clic sulla scheda Visualizza in BigQuery.

  5. Nella finestra di dialogo Visualizza in BigQuery, inserisci un ID connessione.

    Viene creata una nuova connessione. Se l'ID esiste già, si verifica un errore.

  6. Compila il resto della finestra di dialogo e seleziona le caselle di controllo Leggi i dati in parallelo e Utilizza Spanner Data Boost.

  7. Fai clic su Visualizza in BigQuery.

    Si apre BigQuery Studio. Inserisci ed esegui lì la query federata.

    L'esempio seguente crea una query federata in un database Spanner denominato orders e unisce i risultati a una tabella BigQuery denominata mydataset.customers.

    SELECT c.customer_id, c.name, rq.first_order_date
FROM mydataset.customers AS c
LEFT OUTER JOIN EXTERNAL_QUERY(
  'my-project.us.example-db',
  '''SELECT customer_id, MIN(order_date) AS first_order_date
  FROM orders
  GROUP BY customer_id''') AS rq
  ON rq.customer_id = c.customer_id
GROUP BY c.customer_id, c.name, rq.first_order_date;

Inizia da BigQuery

  • Inserisci il seguente URL nel tuo browser:

    https://console.cloud.google.com/bigquery

    BigQuery si apre nel progetto a cui hai eseguito l'accesso più di recente e mostra BigQuery Studio. Esegui qui la tua query federata.

Passaggi successivi