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

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

Ir a BigQuery

  1. En el panel Explorador, expande los nodos del proyecto y del conjunto de datos de la instantánea de tabla que deseas ver.

  2. Haz clic en el nombre de la instantánea de la tabla.

  3. En el panel de instantánea de tabla que aparece, haz clic en Borrar.

  4. Confirma 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 de BigQuery.

    Ir a BigQuery

  2. 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.

  3. 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:

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 tablas borradas.

¿Qué sigue?