Ripristinare tabelle eliminate
Questo documento descrive come ripristinare (o recuperare) una tabella eliminata in BigQuery. Puoi ripristinare una tabella eliminata entro la finestra di spostamento cronologico specificata per il set di dati, incluse le eliminazioni esplicite e quelle implicite dovute alla scadenza della tabella. Puoi anche configurare la finestra di time travel.
Per informazioni su come ripristinare un intero set di dati o snapshot eliminato, consulta le seguenti risorse:
La finestra di spostamento cronologico può avere una durata compresa tra 2 e 7 giorni. Una volta trascorso il periodo di time travel, BigQuery fornisce un periodo di sicurezza in cui i dati eliminati vengono conservati automaticamente per altri sette giorni. Una volta trascorso il periodo di sicurezza, non è possibile ripristinare una tabella con alcun metodo, inclusa l'apertura di unaticket di assistenzaa.
Prima di iniziare
Assicurati di disporre delle autorizzazioni Identity and Access Management (IAM) necessarie per ripristinare una tabella eliminata.
Ruoli obbligatori
Per ottenere le autorizzazioni
necessarie per ripristinare una tabella eliminata,
chiedi all'amministratore di concederti il
ruolo IAM Utente BigQuery (roles/bigquery.user
)
nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Ripristinare una tabella
Quando ripristini una tabella dai dati storici, i tag della tabella di origine non vengono copiati nella tabella di destinazione.
Puoi ripristinare una tabella eliminata, ma ancora all'interno della finestra di Time Travel,
copiandola in una nuova tabella utilizzando il decoratore temporale @<time>
.
Non puoi eseguire query su una tabella eliminata, anche se utilizzi un decoratore temporale. Devi prima
ripristinarlo.
Per ripristinare una tabella, seleziona una delle seguenti opzioni:
Console
Non puoi recuperare una tabella utilizzando la console Google Cloud .
bq
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per ripristinare una tabella, determina innanzitutto un timestamp UNIX di quando esisteva la tabella (in millisecondi). Puoi utilizzare il comando Linux
date
per generare il timestamp Unix da un valore di timestamp normale:date -d '2023-08-04 16:00:34.456789Z' +%s000
Quindi, utilizza il comando
bq copy
con il decoratore di time travel@<time>
per eseguire l'operazione di copia della tabella.Ad esempio, inserisci il seguente comando per copiare la tabella
mydataset.mytable
al momento1418864998000
in una nuova tabellamydataset.newtable
.bq cp mydataset.mytable@1418864998000 mydataset.newtable
(Facoltativo) Fornisci il flag
--location
e imposta il valore sulla tua posizione.Puoi anche specificare un offset relativo. Il seguente esempio copia la versione di una tabella di un'ora fa:
bq cp mydataset.mytable@-3600000 mydataset.newtable
Per ulteriori informazioni, vedi Ripristinare una tabella da un punto nel tempo.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Se prevedi di voler ripristinare una tabella in un momento successivo a quello consentito dalla finestra di Time Travel, crea uno snapshot della tabella. Per saperne di più, consulta la pagina Introduzione agli snapshot delle tabelle.
Passaggi successivi
- Scopri come creare e utilizzare le tabelle.
- Scopri come gestire le tabelle.
- Scopri come modificare gli schemi delle tabelle.
- Scopri di più su come utilizzare i dati delle tabelle.