Configurar flujos de cambios

Si quieres hacer un seguimiento de los cambios que se hacen en los datos de una tabla de Bigtable, puedes habilitar un flujo de cambios en la tabla y, a continuación, leerlo con una aplicación como Dataflow. Antes de leer este documento, consulta la descripción general de los flujos de cambios. En concreto, asegúrate de que conoces los costes que se aplican al hacer cambios en el streaming.

En esta página se describe cómo habilitar, inhabilitar y cambiar el periodo de conservación de un flujo de cambios.

Para obtener instrucciones sobre cómo crear una tabla con un flujo de cambios habilitado, consulta el artículo Crear una tabla.

Rol necesario

Para obtener los permisos que necesitas para habilitar, inhabilitar o modificar un flujo de cambios de Bigtable, pide a tu administrador que te conceda el siguiente rol de gestión de identidades y accesos.

  • Administrador de Bigtable (roles/bigtable.admin) en la instancia de Bigtable que contiene la tabla de la que quieres transmitir los cambios

Habilitar un flujo de cambios

Para habilitar un flujo de cambios en una tabla, sigue estos pasos:

Consola

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

    Abrir la lista de instancias

  2. Haz clic en la instancia que contiene la tabla para la que quieras habilitar un flujo de cambios.

  3. En el panel de la izquierda, haz clic en Tablas.

    En la página Tablas se muestra una lista de las tablas de la instancia.

  4. Haz clic en Editar en la tabla en la que quieras habilitar un flujo de cambios.

  5. Haz clic en Habilitar flujo de cambios.

  6. En el campo Tiempo de vencimiento, introduce un número del 1 al 7 para configurar el número de días que se deben conservar los registros de la secuencia de datos.

  7. Haz clic en Guardar.

gcloud

Para habilitar un flujo de cambios en una tabla, usa el comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Haz los cambios siguientes:

  • TABLE_ID: el ID de la tabla cuyos cambios quieres transmitir
  • INSTANCE_ID: la instancia que contiene la tabla
  • PROJECT_ID: el proyecto que contiene la instancia
  • CHANGE_STREAM_RETENTION_PERIOD: el periodo durante el que Bigtable debe conservar los datos del flujo de cambios de la tabla. Debe ser de entre uno y siete días, expresado como un número y una letra para la unidad. Las unidades aceptadas son días (d), horas (h), minutos (m) y segundos (s). Ejemplo: 5d

Inhabilitar un flujo de cambios

Puedes inhabilitar el flujo de cambios de una tabla en cualquier momento. Los registros de flujo de datos que se crearon antes de inhabilitar el flujo de cambios seguirán consumiendo almacenamiento hasta la siguiente compactación, pero ya no se te cobrará por ese almacenamiento. No puedes leer un flujo de cambios después de inhabilitarlo, incluidos los cambios registrados antes de inhabilitar el flujo.

Consola

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

    Abrir la lista de instancias

  2. Haz clic en la instancia cuyas tablas quieras ver.

  3. En el panel de la izquierda, haz clic en Tablas.

    En la página Tablas se muestra una lista de las tablas de la instancia.

  4. Haz clic en Editar en la tabla cuya configuración de flujo de cambios quieras inhabilitar.

  5. Desmarca la opción Habilitar flujo de cambios.

  6. Haz clic en Guardar.

gcloud

Para inhabilitar un flujo de cambios en una tabla, usa el comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

Haz los cambios siguientes:

  • TABLE_ID: el ID de la tabla cuyos cambios quieres transmitir
  • INSTANCE_ID: la instancia que contiene la tabla
  • PROJECT_ID: el proyecto que contiene la instancia

Modificar el tiempo de conservación de un flujo de cambios

Puedes modificar el número de días que Bigtable conserva los registros de tu flujo de cambios. Si reduces el número de días, los registros que se hayan transmitido antes del cambio de configuración seguirán consumiendo almacenamiento hasta la próxima compresión. Después de cambiar la configuración, solo podrás transmitir los cambios del periodo especificado.

Si aumentas el tiempo de conservación, no será retroactivo. Los flujos de cambios se conservarán durante el número de días aumentado a partir del momento en que modifiques la configuración.

Consola

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

    Abrir la lista de instancias

  2. Haz clic en la instancia cuyas tablas quieras ver.

  3. En el panel de la izquierda, haz clic en Tablas.

    En la página Tablas se muestra una lista de las tablas de la instancia.

  4. Haz clic en Editar en la tabla cuya configuración de flujo de cambios quieras modificar.

  5. En el campo Tiempo de vencimiento, introduce un número del 1 al 7 para indicar el número de días que deben conservarse los registros del flujo de datos.

  6. Haz clic en Guardar.

gcloud

Para cambiar el periodo de retención de un flujo de cambios de una tabla, usa el comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Haz los cambios siguientes:

  • TABLE_ID: el ID de la tabla cuyos cambios quieres transmitir
  • INSTANCE_ID: la instancia que contiene la tabla
  • PROJECT_ID: el proyecto que contiene la instancia
  • CHANGE_STREAM_RETENTION_PERIOD: el periodo durante el que Bigtable debe conservar los datos del flujo de cambios de la tabla. Debe ser de uno a siete días, expresado como un número y una letra para la unidad. Las unidades aceptables son días (d), horas (h), minutos (m) y segundos (s). Ejemplo: 5d

Siguientes pasos