Restablece tablas borradas
En este documento, se describe cómo restablecer (o recuperar) una tabla borrada en BigQuery. Puedes restablecer una tabla borrada dentro del período de viaje en el tiempo especificado para el conjunto de datos, que incluye las eliminaciones explícitas y las implícitas debidas al vencimiento de la tabla. También puedes configurar el período de viaje en el tiempo.
Para obtener información sobre cómo restablecer un conjunto de datos o una instantánea borrados por completo, consulta los siguientes recursos:
El período de viaje en el tiempo puede tener una duración de dos a siete días. Después de que finaliza el período de viaje en el tiempo, BigQuery proporciona un período de seguridad ante fallas en el que los datos borrados se conservan automáticamente durante siete días más. Una vez que transcurre el período de seguridad, no es posible restablecer una tabla con ningún método, incluida la apertura de un ticket de asistencia.
Antes de comenzar
Asegúrate de tener los permisos necesarios de Identity and Access Management (IAM) para restablecer una tabla borrada.
Roles obligatorios
Para obtener los permisos que necesitas para restablecer una tabla borrada, pídele a tu administrador que te otorgue el rol de IAM de usuario de BigQuery (roles/bigquery.user
) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Cómo restablecer una tabla
Cuando restableces una tabla a partir de datos históricos, las etiquetas de la tabla de origen no se copian en la tabla de destino.
Puedes restablecer una tabla que se haya borrado, pero que aún se encuentre dentro del período. Para ello, copia la tabla en una tabla nueva con el decorador de tiempo @<time>
.
No puedes consultar una tabla borrada, incluso si usas un decorador de tiempo. Primero debes restablecerlo.
Para restablecer una tabla, elige una de las siguientes opciones:
Console
No puedes recuperar una tabla con la Google Cloud consola.
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.
Para restablecer una tabla, primero determina una marca de tiempo UNIX de cuando existió la tabla (en milisegundos). Puedes usar el comando
date
de Linux para generar la marca de tiempo de Unix a partir de un valor de marca de tiempo normal:date -d '2023-08-04 16:00:34.456789Z' +%s000
Luego, usa el comando
bq copy
con el decorador de viajes en el tiempo@<time>
para realizar la operación de copia de tabla.Por ejemplo, ingresa el siguiente comando para copiar la tabla
mydataset.mytable
en el momento1418864998000
en una nueva tablamydataset.newtable
.bq cp mydataset.mytable@1418864998000 mydataset.newtable
Opcional: Proporciona la marca
--location
y configura el valor en tu ubicación.También puedes especificar un desplazamiento relativo. En el siguiente ejemplo, se copia la versión de una tabla de hace una hora atrás:
bq cp mydataset.mytable@-3600000 mydataset.newtable
Para obtener más información, consulta Cómo restablecer una tabla a partir de un momento determinado.
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Go.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Node.js.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python incluidas en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Python.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Si prevés que quieres restablecer una tabla más tarde de lo que permite el período de viaje en el tiempo, crea una instantánea de la tabla. Para obtener más información, consulta Introducción a las instantáneas de tablas.
¿Qué sigue?
- Aprende cómo crear y utilizar tablas.
- Aprende a administrar tablas.
- Aprende a modificar esquemas de tablas.
- Obtén más información sobre cómo trabajar con datos de tablas.