Elenca gli snapshot delle tabelle
Questo documento descrive come ottenere un elenco degli snapshot delle tabelle in un set di dati BigQuery nella console Google Cloud, eseguendo una query sulla tabella INFORMATION_SCHEMA.TABLE_SNAPSHOTS
, utilizzando il comando bq ls
o chiamando l'API tables.list
. Descrive inoltre come elencare tutti gli snapshot di tabella di una tabella di base specificata eseguendo una query sulla tabella INFORMATION_SCHEMA.TABLE_SNAPSHOTS
.
Questo documento è rivolto agli utenti che hanno dimestichezza con le tabelle e gli snapshot delle tabelle di BigQuery.
Autorizzazioni e ruoli
Questa sezione descrive le autorizzazioni IAM (Identity and Access Management) di cui hai bisogno per elencare gli snapshot delle tabelle in un set di dati e i ruoli IAM predefiniti che concedono queste autorizzazioni. Le autorizzazioni e i ruoli per elencare gli istantanei delle tabelle sono gli stessi richiesti per elencare altri tipi di tabelle.
Autorizzazioni
Per elencare gli snapshot delle tabelle in un set di dati, devi disporre della seguente autorizzazione:
Autorizzazione | Risorsa |
---|---|
bigquery.tables.list
|
Il set di dati che contiene gli snapshot delle tabelle. |
Ruoli
I ruoli BigQuery predefiniti che forniscono l'autorizzazione richiesta sono i seguenti:
Role | Risorsa |
---|---|
Uno dei seguenti: bigquery.dataUser bigquery.dataViewer bigquery.dataEditor bigquery.dataOwner bigquery.admin
|
Il set di dati che contiene gli snapshot delle tabelle. |
Elenca gli snapshot delle tabelle in un set di dati
Ottenere un elenco di snapshot di tabelle in un set di dati è simile all'elenco di altri tipi di tabelle. Gli snapshot delle tabelle hanno il tipo SNAPSHOT
.
Puoi elencare gli snapshot delle tabelle utilizzando una delle seguenti opzioni:
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi i nodi del progetto e del set di dati del set di dati di cui vuoi elencare gli snapshot delle tabelle.
Puoi identificare gli istantanei delle tabelle nel set di dati dalla relativa icona.
SQL
Esegui una query sulla
visualizzazione INFORMATION_SCHEMA.TABLE_SNAPSHOTS
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT * FROM PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene gli snapshot da elencare.DATASET_NAME
: il nome del set di dati che contiene gli snapshot che vuoi elencare.
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.
Il risultato è simile al seguente:
+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+ | table_catalog | table_schema | table_name | base_table_catalog | base_table_schema | base_table_name | snapshot_time | +---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+ | myproject | mydataset | mysnapshot | basetableproject | basetabledataset | basetable | 2021-04-16 14:05:27.519 UTC | +---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+
bq
Inserisci il seguente comando in Cloud Shell:
bq ls \ PROJECT_ID:DATASET_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene gli snapshot da elencare.DATASET_NAME
: il nome del set di dati che contiene gli snapshot che vuoi elencare.
L'output è simile al seguente:
+-------------------------+--------+---------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+--------+---------------------+-------------------+ | mysnapshot |SNAPSHOT| | | +-------------------------+--------+---------------------+-------------------+
API
Chiama il metodo
tables.list
con i seguenti parametri:
Parametro | Valore |
---|---|
projectId |
L'ID del progetto che contiene gli snapshot da elencare. |
datasetId |
Il nome del set di dati che contiene gli snapshot da elencare. |
Elenca gli snapshot delle tabelle di una tabella di base specificata
Puoi elencare gli istantanei della tabella di una tabella di base specificata eseguendo una query sulla vistaINFORMATION_SCHEMA.TABLE_SNAPSHOTS
:
SELECT * FROM PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS WHERE base_table_name = 'books';
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene gli snapshot da elencare.DATASET_NAME
: il nome del set di dati che contiene gli snapshot da elencare.
Passaggi successivi
- Ottenere informazioni su uno snapshot della tabella.
- Aggiorna la descrizione, la data di scadenza o il criterio di accesso di uno snapshot di tabella.
- Elimina uno snapshot della tabella.