Configurar flujos de cambios

Si quieres hacer un seguimiento de los cambios en los datos realizados en una tabla de Bigtable, puedes habilitar un flujo de cambios para la tabla y, luego, leerlo con una aplicación como Dataflow. Antes de leer este documento, consulta la Descripción general de flujos de cambios. En particular, asegúrate de conocer los costos que se generan cuando la transmisión cambia.

En esta página, se describe cómo habilitar, inhabilitar y cambiar el período de retención de un flujo de cambios.

Para obtener instrucciones sobre cómo crear una tabla nueva con un flujo de cambios habilitado, consulta Crea un de la tabla.

Función requerida

Para obtener los permisos que necesitas para habilitar, inhabilitar o modificar un flujo de cambios de Bigtable, pídele a tu administrador que te otorgue el siguiente rol de IAM.

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

Habilita un flujo de cambios

Para habilitar un flujo de cambios en una tabla existente, completa los siguientes pasos:

Console

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

    Abrir la lista de instancias

  2. Haz clic en la instancia que contiene la tabla para la que deseas habilitar un cambio para lo que necesitas.

  3. Haz clic en Tablas en el panel izquierdo.

    La página Tablas muestra una lista de tablas en la instancia.

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

  5. Haz clic en Habilitar flujo de cambios.

  6. En el campo Hora de vencimiento, ingresa un número del 1 al 7. configura la cantidad de días que deben durar los registros de flujos de datos en la retención.

  7. Haz clic en Guardar.

gcloud

Para habilitar un flujo de cambios en una tabla, usa 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

Reemplaza lo siguiente:

  • TABLE_ID: Es el ID de la tabla cuyos cambios deseas. para transmitir
  • INSTANCE_ID: Es la instancia que contiene la tabla.
  • PROJECT_ID: Es el proyecto que contiene la instancia.
  • CHANGE_STREAM_RETENTION_PERIOD: Es la cantidad de tiempo que Bigtable debe conservar los datos de los flujos de cambios en la tabla. Debe ser de al menos un día y no más de siete, 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

Cómo inhabilitar un flujo de cambios

Puedes inhabilitar el flujo de cambios de una tabla en cualquier momento. El flujo de datos registra que se crearon antes de inhabilitar el flujo de cambios siguen consumiendo almacenamiento hasta la próxima compactación, pero no más tiempo por ese almacenamiento. No puedes leer un flujo de cambios después de inhabilitarla, incluidos los cambios registrados antes de inhabilitar la transmisión.

Console

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

    Abrir la lista de instancias

  2. Haz clic en la instancia que tiene las tablas deseas ver.

  3. Haz clic en Tablas en el panel izquierdo.

    La página Tablas muestra una lista de tablas en la instancia.

  4. Haz clic en Editar en la tabla para la que deseas configurar el flujo de cambios. inhabilitar.

  5. Desmarca la marca de verificación de Habilitar flujo de cambios.

  6. Haz clic en Guardar.

gcloud

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

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

Reemplaza lo siguiente:

  • TABLE_ID: Es el ID de la tabla cuyos cambios deseas. para transmitir
  • INSTANCE_ID: Es la instancia que contiene la tabla.
  • PROJECT_ID: Es el proyecto que contiene la instancia.

Modifica el tiempo de retención de un flujo de cambios

Puedes modificar la cantidad de días que Bigtable conserva el cambio de transmisión continua. Si reduces la cantidad de días, los registros que se transmitieron antes de que el cambio de configuración siga consumiendo almacenamiento hasta la próxima compactación. Después del cambio de configuración, solo podrás transmitir los cambios del período especificado recientemente.

Si aumentas el tiempo de retención, el tiempo de retención no es retroactivo; debes flujos de cambios se conservan durante un mayor número de días a partir del momento en que modificas configuración.

Console

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

    Abrir la lista de instancias

  2. Haz clic en la instancia que tiene las tablas deseas ver.

  3. Haz clic en Tablas en el panel izquierdo.

    La página Tablas muestra una lista de tablas en la instancia.

  4. Haz clic en Editar en la tabla para la que deseas configurar el flujo de cambios. modificar.

  5. En el campo Hora de vencimiento, ingresa un número del 1 al 7. de días durante los que se deben conservar los registros de flujos de datos.

  6. Haz clic en Guardar.

gcloud

Para cambiar el período de retención del flujo de cambios de una tabla, usa 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

Reemplaza lo siguiente:

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

¿Qué sigue?