Borra instantáneas de tablas

En este documento, se describe cómo borrar una instantánea de tabla con la consola deGoogle Cloud , una instrucción 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:

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

Ir a BigQuery

  1. En el panel de la izquierda, haz clic en Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

  2. En el panel Explorador, expande tu proyecto, haz clic en Conjuntos de datos y, luego, en el conjunto de datos que tiene la instantánea de la tabla.

  3. Haz clic en Descripción general > Tablas y, luego, en el nombre de la instantánea de la tabla.

  4. En el panel de detalles que aparece, haz clic en Borrar.

  5. En el diálogo que aparece, escribe delete y, luego, vuelve a hacer clic en Borrar.

SQL

Usa la declaración DDL DROP SNAPSHOT TABLE:

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. En el editor de consultas, escribe la siguiente oración:

    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.

  3. Haz clic en Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Escribe el siguiente comando en Cloud Shell:

Ir a 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 instantáneas de tablas.

¿Qué sigue?