Creare e gestire viste logiche

Le viste logiche in Bigtable ti consentono di salvare le query SQL come tabelle virtuali a cui altre query SQL possono fare riferimento mentre i dati rimangono nella tabella di origine. L'utilizzo di queste visualizzazioni ti consente di:

• Evitare la ripetizione della logica di query
• Presentare i dati in un formato relazionale
• Limitare l'accesso in lettura a righe o colonne specifiche

Puoi creare e gestire viste logiche utilizzando Google Cloud CLI o l'editor di query Bigtable Studio nella console Cloud de Confiance . Puoi eseguire query sulle viste logiche utilizzando l'editor di query o una delle librerie client Bigtable che supportano SQL. Per un confronto con le viste materializzate continue e le viste autorizzate, consulta Tabelle e viste.

Informazioni sulle viste logiche

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

• Evita la ripetizione delle query: puoi archiviare e sviluppare la logica di mapping e cast delle colonne in una visualizzazione logica, che le visualizzazioni logiche aggiuntive possono utilizzare invece di copiare e incollare la logica o doverla comprendere.
• Esegui l'integrazione con sistemi progettati per leggere da database relazionali: le viste logiche ti consentono di leggere i dati 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 nell'istanza Bigtable.
• Fornisci un'interfaccia coerente: la tua applicazione può utilizzare una visualizzazione logica anche se la tabella di origine cambia.
• Limitare l'accesso in lettura a colonne o righe specifiche: puoi esporre solo i dati che vuoi consentire agli utenti di leggere, senza concedere loro l'accesso all'intera tabella.

Una visualizzazione logica è una risorsa a livello di istanza con le seguenti caratteristiche:

• Devi utilizzare le funzionalità SQL supportate da GoogleSQL per Bigtable
• La query SQL che definisce una vista logica non può utilizzare SELECT *.
• Sola lettura
• Deve essere letto con SQL anziché con una chiamata a ReadRows
• Può essere eseguito utilizzando una qualsiasi delle librerie client di Bigtable che supportano SQL
• Utilizza i diritti di definizione. Puoi eseguire query su una vista logica se disponi delle autorizzazioni per leggerla anche se non disponi dell'autorizzazione per leggere la tabella di origine.

La chiave di riga, il qualificatore di colonna e i valori di colonna che utilizzi per definire una vista logica vengono trattati come dati del servizio. Per questo motivo, non creare una vista logica utilizzando la chiave di riga, il qualificatore di colonna o i valori delle colonne che contengono informazioni sensibili. Per informazioni su come vengono gestiti i dati del servizio, consulta l'Cloud de Confiance by S3NS Informativa sulla privacy.

Prima di iniziare

Se prevedi di utilizzare gcloud CLI, segui questi passaggi:

1. Installa Google Cloud CLI.

2. Configura gcloud CLI per utilizzare la tua identità federata.

   Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.

3. Per inizializzare gcloud CLI, esegui questo comando:

   gcloud init

Ruoli obbligatori

Per lavorare con le visualizzazioni logiche, devi disporre delle seguenti autorizzazioni:

Per gestire le viste logiche:

• Per creare, aggiornare o eliminare viste logiche, devi disporre del ruolo Bigtable Admin (roles/bigtable.admin) nell'istanza.
• In alternativa, puoi chiedere all'amministratore di concederti le seguenti autorizzazioni a livello di istanza:
  • Crea: bigtable.logicalViews.create
  • Aggiorna: bigtable.logicalViews.update
  • Elimina: bigtable.logicalViews.delete

Per visualizzare ed eseguire query sulle viste logiche:

• Per elencare o descrivere le viste logiche, devi disporre del ruolo Bigtable Reader (roles/bigtable.reader) nell'istanza.

• In alternativa, puoi chiedere all'amministratore di concederti le seguenti autorizzazioni a livello di istanza:

  • Elenco: bigtable.logicalViews.list
  • Descrivi: bigtable.logicalViews.get

• Per eseguire una query su una vista logica, devi disporre dell'autorizzazione bigtable.logicalViews.readRows per la vista logica.

Per creare una vista logica:

• Devi disporre almeno dell'autorizzazione bigtable.tables.readRows sulla tabella di origine.

Per concedere l'accesso in lettura a una visualizzazione specifica:

Puoi concedere a un utente l'autorizzazione a leggere una visualizzazione logica specifica, anche se non dispone di altre autorizzazioni Bigtable. Per farlo, utilizza una condizione IAM per concedere l'autorizzazione bigtable.logicalViews.readRows solo per quella visualizzazione:

1. Concedi all'utente il ruolo bigtable.reader sul progetto.

2. Crea una condizione IAM che limiti l'autorizzazione bigtable.logicalViews.readRows alla vista logica specifica. Ad esempio:

   resource.name == projects/PROJECT_ID/instances/INSTANCE_ID/logicalViews/VIEW
   

   Sostituisci quanto segue:

   • PROJECT_ID: il Cloud de Confiance progetto in cui si trova l'istanza Bigtable.
   • VIEW: un ID lungo fino a 128 caratteri per la nuova visualizzazione logica. L'ID deve essere univoco tra gli ID tabella e gli ID vista nell'istanza.
   • INSTANCE_ID: l'ID dell'istanza in cui creare la visualizzazione logica.

   Per saperne di più, consulta Gestire l'accesso alle risorse utilizzando le condizioni IAM.

Per saperne di più su tutti i ruoli e le autorizzazioni disponibili, consulta Controllo dell'controllo dell'accesso con IAM.

Creare una vista logica

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

Aggiorna una vista logica

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

gcloud bigtable logical-views update VIEW \
    --instance=INSTANCE \
    --deletion-protection=true

gcloud bigtable logical-views update VIEW \
    --instance=INSTANCE \
    --deletion-protection=false

Eliminare una vista logica

Questa azione è definitiva.

Se una visualizzazione logica ha la protezione da eliminazione abilitata, non puoi eliminarla. Per eliminare una vista logica per cui è abilitata la protezione da eliminazione, devi aggiornarla per disabilitare la protezione da eliminazione. Per saperne di più, consulta la sezione Aggiornare una visualizzazione logica di questo documento.

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

Ottieni un elenco di viste logiche per un'istanza

Puoi visualizzare un elenco delle viste logiche per un'istanza.

gcloud bigtable logical-views list --instance=INSTANCE

Descrivere una vista logica

Per ottenere dettagli su una vista 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'
  deletion_protection: true

Eseguire query su una vista logica

Dopo aver creato una vista logica, puoi eseguirvi query utilizzando SQL, proprio come faresti con una tabella normale. Puoi utilizzare le viste logiche nella clausola FROM delle istruzioni SELECT.

Nell'editor di query, inserisci una query GoogleSQL che faccia riferimento al nome della vista. Ad esempio, se la tua visualizzazione si chiama MyLogicalView:

SELECT *
FROM MyLogicalView
LIMIT 100;

Per saperne di più sull'esecuzione di query SQL in Bigtable, consulta Eseguire query sui dati con SQL nell'editor query.

Passaggi successivi

• Per scoprire di più sull'esecuzione di query sui dati Bigtable con SQL, consulta la panoramica di GoogleSQL per Bigtable.
• Per precalcolare e memorizzare nella cache i risultati delle query da una tabella di origine, consulta Viste materializzate continue.
• Per configurare l'accesso in lettura e scrittura granulare a sottoinsiemi specifici di dati, consulta la panoramica delle viste autorizzate.
• Per filtrare dinamicamente i dati della vista logica in base al contesto dell'applicazione, consulta la panoramica delle viste parametrizzate.