Crea y administra vistas materializadas continuas

En este documento, se describe cómo crear y realizar operaciones en una vista materializada continua en Bigtable. Antes de leer este documento, lee la descripción general en Vistas materializadas continuas.

Puedes crear una vista materializada continua con Google Cloud CLI, el editor de consultas de Bigtable Studio en la consola de Google Cloud o las bibliotecas cliente de Bigtable para Java y Go.

Antes de comenzar

Sigue los pasos que se indican a continuación si planeas usar la CLI de gcloud.

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

Roles obligatorios

Para obtener los permisos que necesitas para crear y administrar vistas materializadas continuas, pídele a tu administrador que te otorgue el rol de administrador de Bigtable (roles/bigtable.admin) en la instancia. De lo contrario, solicita los siguientes permisos a nivel de la instancia, según la operación que desees realizar:

  • Creación: bigtable.materializedViews.create
  • Actualización: bigtable.materializedViews.update
  • Borrar: bigtable.materializedViews.delete
  • Lista: bigtable.materializedViews.list

Para crear una vista materializada continua, también debes tener al menos el permiso bigtable.tables.readRows en la tabla de origen.

Para ver todos los roles y permisos disponibles, consulta Control de acceso de Bigtable con IAM.

Crea una vista materializada continua

Antes de crear una vista materializada continua, haz lo siguiente:

  • Opcional: Como práctica recomendada, habilita el ajuste de escala automático para los clústeres de tu instancia para asegurarte de que puedan escalar si es necesario mientras Bigtable procesa y sincroniza la vista materializada continua, y para controlar cualquier uso de almacenamiento adicional.
  • Identifica una tabla de Bigtable para la que tengas permiso de lectura para usarla como fuente de la vista materializada continua.
  • Prepara la consulta de SQL que define tu vista materializada continua. Para conocer los requisitos de consulta, consulta Consultas de vistas materializadas continuas.

Después de crear una vista materializada continua, es posible que tarde unos minutos en activarse y poder consultarse. Puedes consultar las métricas de la vista para supervisar su progreso.

Console

  1. Abre la lista de instancias de Bigtable en la consola de Google Cloud.

    Abrir la lista de instancias

  2. Selecciona una instancia.

  3. En el panel de navegación, haz clic en Bigtable Studio.

  4. Para abrir una pestaña nueva, haz clic en y, luego, elige Editor.

    1. Escribe tu consulta cuando aparezca el editor de consultas. Si la consulta es SQL válida, se muestra un mensaje Valid.

    2. Opcional: Para dar formato a tu sentencia en estilo SQL, haz clic en Formato.

    3. Haz clic en Ejecutar. Los resultados de tu consulta aparecen en la tabla Resultados.

    4. Cuando estés conforme con la consulta, haz clic en Guardar y, luego, elige Vista materializada.

    Para obtener más información sobre el uso del editor de consultas, consulta Administra tus datos con Bigtable Studio.

gcloud

Para crear una vista materializada continua, usa el comando gcloud beta bigtable materialized-views create:

    gcloud beta bigtable materialized-views create VIEW \
            --instance=INSTANCE --query=QUERY

Reemplaza lo siguiente:

  • VIEW: Un identificador único para la vista materializada continua. Usas este ID como el ID de la tabla cuando consultas la vista materializada continua.
  • INSTANCE: Es el identificador de la instancia en la que se creará la vista materializada continua. Debe ser la misma instancia que la tabla de origen.
  • QUERY: Es una sentencia SQL válida que define la vista materializada continua.

Opcional: Para habilitar la protección contra la eliminación para la vista materializada continua, agrega el siguiente texto al comando:

--deletion-protection=DELETION_PROTECTION

Reemplaza DELETION_PROTECTION por true o false.

Actualiza una vista materializada continua

Puedes actualizar la protección contra la eliminación para una vista materializada continua. No puedes actualizar la consulta de SQL que define una vista materializada continua. Si necesitas modificar la consulta, debes borrar la vista materializada continua y, luego, crear una nueva que incluya los cambios.

Console

No puedes actualizar una vista materializada continua en la consola. En su lugar, usa la CLI de gcloud.

gcloud

Para habilitar o inhabilitar la protección contra la eliminación de una vista materializada continua, usa gcloud beta bigtable materialized-views update command.

gcloud beta bigtable materialized-views update VIEW \
        -–instance=INSTANCE --deletion-protection=DELETION_PROTECTION

Reemplaza lo siguiente:

  • VIEW: El identificador único de la vista materializada continua que deseas actualizar
  • INSTANCE: El identificador de la instancia que contiene la vista materializada continua
  • DELETION_PROTECTION: true o false

Cómo borrar una vista materializada continua

Puedes borrar una vista materializada continua que no tenga habilitada la protección contra la eliminación. No puedes deshacer esta operación.

Para borrar una vista materializada continua, usa el comando gcloud beta bigtable materialized-views delete:

gcloud beta bigtable materialized-views delete VIEW \
        --instance=INSTANCE

Reemplaza lo siguiente:

  • VIEW: El identificador único de la vista materializada continua que deseas borrar
  • INSTANCE: El identificador de la instancia que contiene la vista materializada continua

Obtén una lista de vistas materializadas continuas

Puedes ver una lista de vistas materializadas continuas para una instancia.

Console

  1. Abre la lista de instancias de Bigtable en la consola de Google Cloud.

    Abrir la lista de instancias

  2. Elige una instancia de la lista.

  3. En el panel de navegación, haz clic en Bigtable Studio. Aparecerá una lista de las vistas materializadas continuas.

  4. Opcional: Se muestran las primeras 10 vistas de la instancia. Para ver 10 más, haz clic en Mostrar más.

gcloud

Para enumerar todas las vistas materializadas continuas de una instancia, usa el comando gcloud bigtable materialized-views list.

gcloud bigtable materialized-views list --instance=INSTANCE

Reemplaza INSTANCE por el ID de la instancia.

¿Qué sigue?