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, consulta 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 Google Cloud consola de Google Cloud o las bibliotecas cliente de Bigtable para Java y Go.

Antes de comenzar

Sigue estos pasos si planeas usar gcloud CLI.

  1. Instala Google Cloud CLI.

  2. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  3. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    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 deseas realizar:

  • Crear: bigtable.materializedViews.create
  • Actualizar: 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 escalado automático para los clústeres de tu instancia para asegurarte de que puedan escalar verticalmente si es necesario mientras Bigtable procesa y sincroniza la vista materializada continua, y para controlar cualquier uso del almacenamiento adicional.
  • Identifica una tabla de Bigtable que tengas permiso para leer y usar como fuente para la vista materializada continua.
  • Prepara la consulta en SQL que define tu vista materializada continua. Para conocer los requisitos de la consulta, consulta Consultas de vistas materializadas continuas queries.

Después de crear una vista materializada continua, Bigtable completa la población inicial. La vista se activa y se puede consultar solo después de que se completa este proceso. Puedes consultar las métricas de la vista para supervisar su progreso. Para obtener información sobre cómo consultar la vista antes de que finalice la población inicial, consulta Lee datos durante la población inicial.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud 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 un SQL válido, se muestra un mensaje Válido.

    2. Opcional: Para dar formato a tu instrucción 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 satisfecho con la consulta, haz clic en la flecha del expansor Guardar como y elige Guardar como vista materializada.

  5. En el diálogo Guarda tu vista materializada , ingresa un nombre para la vista y, luego, haz clic en Guardar.

    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 gcloud bigtable materialized-views create comando:

    gcloud 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: 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: una instrucción de SQL válida que define la vista materializada continua.

El comando acepta las siguientes marcas opcionales:

  • Para habilitar la protección contra eliminaciones para la vista materializada continua, agrega el comando con --deletion-protection=DELETION_PROTECTION. Reemplaza DELETION_PROTECTION por true o false.
  • Si tu consulta en SQL usa funciones no deterministas, agrega el comando con la marca --ignore-warnings. Esta marca garantiza que reconozcas que estas funciones pueden hacer que diferentes clústeres produzcan resultados diferentes para la misma vista. Si omites la marca, falla la validación de la consulta.

Actualiza una vista materializada continua

Puedes actualizar la protección contra eliminaciones para una vista materializada continua. No puedes actualizar la consulta en 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 tus cambios.

Console

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

gcloud

Para habilitar o inhabilitar la protección contra eliminaciones para una vista materializada continua, usa el gcloud bigtable materialized-views update comando.

gcloud 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

Borra una vista materializada continua

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

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud 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.

  4. Expande Vistas materializadas.

  5. Junto a la vista que deseas borrar, haz clic en el more_vert, y, luego, en Borrar.

gcloud

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

gcloud 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 Google Cloud 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. Se muestra una lista de 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 gcloud bigtable materialized-views list comando.

gcloud bigtable materialized-views list --instance=INSTANCE

Reemplaza INSTANCE por el ID de la instancia.

¿Qué sigue?