Creare e gestire viste logiche

In Bigtable, una visualizzazione logica è il risultato di una query SQL che funge da tabella virtuale su cui è possibile eseguire query con altre query SQL. I dati rimangono nella tabella di origine.

Questo documento descrive le visualizzazioni logiche e come crearle ed eseguire operazioni su di esse. Per un confronto con le visualizzazioni materializzate e le visualizzazioni autorizzate, consulta Tabelle e visualizzazioni.

Le viste logiche ti consentono di eseguire le seguenti operazioni con i dati Bigtable:

• Evita la ripetizione delle query: puoi memorizzare ed evolvere la logica di mappatura e di conversione delle colonne in una visualizzazione logica, che altre visualizzazioni logiche possono utilizzare anziché copiare e incollare la logica o doverla comprendere.
• Integrazione con sistemi progettati per la lettura da database relazionali: le viste logiche ti consentono di leggere i dati di Bigtable come una tabella di database relazionale o una tabella Cassandra.
• Esegui la stessa visualizzazione logica su più tabelle: modificando la clausola FROM, puoi utilizzare la stessa visualizzazione per eseguire query su qualsiasi tabella dell'istanza Bigtable.
• Fornisci un'interfaccia coerente: l'applicazione può utilizzare una vista logica anche se la tabella di origine cambia.

Una vista logica è una risorsa a livello di istanza. Puoi creare una vista logica utilizzando Google Cloud CLI o l'editor di query di Bigtable Studio nella Google Cloud console. Per eseguire query su una vista logica, puoi utilizzare l'editor di query di Bigtable Studio o una delle librerie client di Bigtable che supportano SQL.

Una vista logica ha le seguenti caratteristiche:

• Devi utilizzare le funzionalità SQL supportate da GoogleSQL per Bigtable
• Sola lettura
• Deve essere letto con SQL anziché con una chiamata a ReadRows
• Utilizza i diritti di definizione. Puoi eseguire query su una vista logica se disponi delle autorizzazioni per leggerla anche se non disponi delle autorizzazioni per leggere dalla tabella di origine.

Prima di iniziare

Se prevedi di utilizzare l'interfaccia a riga di comando gcloud:

1. Install the Google Cloud CLI.

2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire le visualizzazioni logiche, chiedi all'amministratore di concederti il ruolo Amministratore Bigtable (roles/bigtable.admin) nell'istanza. In caso contrario, richiedi le seguenti autorizzazioni a livello di istanza, a seconda dell'operazione che vuoi eseguire:

• Crea: bigtable.logicalViews.create
• Aggiorna: bigtable.logicalViews.update
• Elimina: roles/bigtable.logicalViews.delete
• Elenco: bigtable.logicalViews.list
• Descrizione: bigtable.logicalViews.get

Per creare una vista logica, devi disporre anche dell'autorizzazione bigtable.table.readRows per la tabella di origine.

Per visualizzare tutti i ruoli e le autorizzazioni disponibili, consulta Controllo dell'accesso a Bigtable con IAM.

Creare una vista logica

gcloud bigtable logical-views create VIEW \
  --instance=INSTANCE --query=QUERY

Sostituisci quanto segue:

• VIEW: un ID lungo massimo 128 caratteri per la nuova vista. L'ID deve essere univoco tra gli ID tabella e visualizzazione nell'istanza.
• QUERY: una query GoogleSQL per Bigtable valida
• INSTANCE: l'ID dell'istanza in cui creare la visualizzazione

Aggiornare una vista logica

gcloud bigtable logical-views update VIEW  \
    --instance=INSTANCE --query=QUERY

Eliminare una vista logica

Questa azione è definitiva. Per eliminare una vista logica, utilizza il comando gcloud bigtable logical-views delete.

    gcloud bigtable logical-views delete VIEW \
      --instance=INSTANCE

Sostituisci quanto segue:

• VIEW: l'ID della vista logica da aggiornare
• INSTANCE: l'ID dell'istanza contenente la vista logica

Visualizza un elenco di visualizzazioni logiche per un'istanza

Puoi visualizzare un elenco di visualizzazioni logiche per un'istanza.

gcloud bigtable logical-views list --instance=INSTANCE

Descrivere una visualizzazione logica

Per ottenere i dettagli di una visualizzazione logica, utilizza il comando gcloud bigtable logical-views describe.

  gcloud bigtable logical-views describe VIEW \
      --instance=INSTANCE

Il terminale mostra dettagli simili ai seguenti:

  createTime: '2025-03-07T19:49:56.316578Z'
  etag: W/"/v1/17919275593532352351"
  name: projects/my-project/instances/my-instance/logicalViews/my-view
  query: SELECT street FROM addresses
  updateTime: '2025-03-07T19:49:56.316578Z'

Passaggi successivi

• Panoramica di GoogleSQL per Bigtable
• Viste materializzate
• Panoramica delle visualizzazioni autorizzate