Eseguire 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 pari a zero sui carichi di lavoro esistenti sull'istanza di Spanner di cui è stato eseguito il provisioning.

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

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

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

Prima di iniziare

Completa le attività seguenti 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 ulteriori informazioni, consulta API BigQuery Connection.

Concedi alle entità le autorizzazioni IAM per Data Boost

Le entità devono avere le 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 ulteriori informazioni, consulta 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 Creare connessioni Spanner nella documentazione di BigQuery e segui le istruzioni della console.

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

bq

  1. Vai a Creare 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

Eseguire una query federata

Per eseguire una query federata con Data Boost, utilizza una connessione BigQuery che specifichi l'utilizzo di Data Boost. Per saperne di più, 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 istanze Spanner.

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

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

  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 a 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 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 la query federata qui.

Passaggi successivi