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

  • Crear: 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 y asegúrate de que puedan aumentar su escala 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 que tengas permiso para leer y que se usará como fuente para la vista materializada continua.
  • Prepara la consulta en SQL que define tu vista materializada continua. Para conocer los requisitos de las consultas, consulta Consultas de vistas materializadas continuas.

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

Console

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

    Abrir la lista de instancias

  2. Selecciona una instancia.

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

  4. Abre una pestaña nueva haciendo 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 el mensaje Válida.

    2. Opcional: Para darle 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 conforme con la consulta, haz clic en Guardar y, luego, elige Vista materializada.

    Para obtener más información sobre cómo usar el 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: Es 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 instrucción de SQL válida que define la vista materializada continua.

Opcional: Para habilitar la protección contra eliminación de la vista materializada continua, agrega lo siguiente 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 de 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. En su lugar, usa la CLI de gcloud.

gcloud

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

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

Reemplaza lo siguiente:

  • VIEW: Es el identificador único de la vista materializada continua que deseas actualizar.
  • INSTANCE: Es 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 eliminación. No puedes deshacer esta operación.

Console

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

    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 menú de acciones more_vert y, luego, en Borrar.

gcloud

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: Es el identificador único de la vista materializada continua que deseas borrar.
  • INSTANCE: Es el identificador de la instancia que contiene la vista materializada continua.

Obtén una lista de vistas materializadas continuas

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

Console

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

    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 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?