Borra instantáneas de tablas
En este documento, se describe cómo borrar una instantánea de tabla con la consola de Google Cloud, una sentencia de GoogleSQL DROP SNAPSHOT TABLE
, un comando bq rm
o una llamada tables.delete
a la API de BigQuery.
También se proporciona información sobre cómo recuperar una instantánea de tabla que se borró o que venció en los últimos siete días.
Está dirigido a usuarios que estén familiarizados con las instantáneas de tablas.
Permisos y funciones
En esta sección, se describe el permiso de administración de identidades y accesos (IAM) que necesitas para borrar una instantánea de la tabla y las funciones predefinidas de IAM que otorgan esos permisos.
Permisos
Para borrar una instantánea de tabla, necesitas el siguiente permiso:
Permiso | Recurso |
---|---|
bigquery.tables.deleteSnapshot
|
La instantánea de la tabla que deseas restablecer |
Funciones
A continuación, se enumeran los roles predefinidos de BigQuery que proporcionan los permisos necesarios:
Función | Recurso |
---|---|
Cualquiera de los siguientes:bigquery.dataOwner bigquery.admin
|
La instantánea de la tabla que deseas restablecer. |
Borra una instantánea de tabla
Borra una instantánea de tabla como lo harías con una tabla estándar. No es necesario que borres una instantánea de tabla que haya vencido.
Puedes borrar una instantánea de tabla mediante una de las siguientes opciones:
Consola
- En la consola de Google Cloud, ve a la página de BigQuery.
En el panel Explorador, expande los nodos del proyecto y del conjunto de datos de la instantánea de tabla que deseas ver.
Haz clic en el nombre de la instantánea de la tabla.
En el panel de instantánea de tabla que aparece, haz clic en Borrar.
Confirma y, luego, vuelve a hacer clic en Borrar.
SQL
Usa la declaración DDL DROP SNAPSHOT TABLE
:
En la consola de Google Cloud, ve a la página de BigQuery.
En el editor de consultas, ingresa la siguiente sentencia:
DROP SNAPSHOT TABLE PROJECT_ID.DATASET_NAME.SNAPSHOT_NAME;
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto que contiene la instantánea.DATASET_NAME
: Es el nombre del conjunto de datos que contiene la instantánea.SNAPSHOT_NAME
: Es el nombre de la instantánea.
Haz clic en
Ejecutar.
Para obtener más información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.
bq
Ingresa el siguiente comando en Cloud Shell:
bq rm \ PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto que contiene la instantánea.DATASET_NAME
: Es el nombre del conjunto de datos que contiene la instantánea.SNAPSHOT_NAME
: Es el nombre de la instantánea.
API
Llama al método tables.delete
con los siguientes parámetros:
Parámetro | Valor |
---|---|
projectId |
El ID del proyecto que contiene la instantánea |
datasetId |
El nombre del conjunto de datos que contiene la instantánea. |
tableId |
El nombre de la instantánea. |
Restablece una instantánea de tabla borrada o vencida
Puedes recuperar una instantánea de tabla que se borró o que venció en los últimos siete días de la misma manera que recuperas una tabla estándar. Para obtener más información, consulta Restablece tablas borradas.