Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Configura flujos de cambios
Si deseas hacer un seguimiento de los cambios de datos realizados en una tabla de Bigtable, puedes
habilitar un flujo de cambios para la tabla y, luego, leerla con una aplicación
como Dataflow. Antes de leer este documento, consulta la descripción general de los flujos de cambios. En particular, asegúrate de conocer los costos que se incurren cuando se realizan cambios en la transmisión.
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 una 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 desde la que planeas transmitir cambios
Habilita un flujo de cambios
Para habilitar un flujo de cambios en una tabla existente, completa los siguientes pasos:
Console
Abre la lista de instancias de Bigtable en la consola de Google Cloud .
Haz clic en la instancia que contiene la tabla para la que deseas habilitar un flujo de cambios.
Haz clic en Tablas en el panel izquierdo.
La página Tablas muestra una lista de tablas en la instancia.
Haz clic en Editar en la tabla para la que deseas habilitar un flujo de cambios.
Haz clic en Habilitar el flujo de cambios.
En el campo Hora de vencimiento, ingresa un número entre 1 y 7 para configurar la cantidad de días que se deben retener los registros del flujo de datos.
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 del flujo de cambios de 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
Inhabilitar un flujo de cambios
Puedes inhabilitar el flujo de cambios de una tabla en cualquier momento. Los registros del flujo de datos que se crearon antes de inhabilitar el flujo de cambios siguen consumiendo almacenamiento hasta la próxima compactación, pero ya no se te cobra por ese almacenamiento. No puedes leer un flujo de cambios después de inhabilitarlo, incluidos los cambios registrados antes de inhabilitarlo.
Console
Abre la lista de instancias de Bigtable en la consola de Google Cloud .
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.
Modifica el tiempo de retención de un flujo de cambios
Puedes modificar la cantidad de días que Bigtable conserva los registros de tu
transmisión de cambios. Si reduces la cantidad de días, los registros que se transmitieron antes del cambio de configuración seguirán 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, no se aplica de forma retroactiva, es decir, los flujos de cambios se conservan durante la cantidad de días aumentada a partir del momento en que modificas la configuración.
Console
Abre la lista de instancias de Bigtable en la consola de Google Cloud .
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 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
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eChange streams on Bigtable tables can be enabled to track data modifications, which can be read by applications like Dataflow.\u003c/p\u003e\n"],["\u003cp\u003eChange stream retention periods can be configured for a duration between one and seven days, specifying how long Bigtable keeps the change stream data.\u003c/p\u003e\n"],["\u003cp\u003eYou can enable, disable, or modify the change stream retention period for existing tables via the Google Cloud console or using \u003ccode\u003egcloud\u003c/code\u003e commands.\u003c/p\u003e\n"],["\u003cp\u003eDisabling a change stream immediately halts new data capture, although previously recorded data will remain until the next compaction.\u003c/p\u003e\n"],["\u003cp\u003eTo make changes to a table's change stream, the user must have the Bigtable Administrator role, which is \u003ccode\u003eroles/bigtable.admin\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Configure change streams\n========================\n\nIf you want to track data changes made to a Bigtable table, you can\nenable a change stream for the table and then read it using an application\nsuch as Dataflow. Before you read this document, read the [Overview of\nchange streams](/bigtable/docs/change-streams-overview). In particular, make\nsure that you are aware of the costs incurred when streaming changes.\n\nThis page describes how to enable, disable, and change the retention period for\na change stream.\n\nFor instructions on creating a new table with a change stream enabled, see\n[Create a\ntable](/bigtable/docs/managing-tables#create-table).\n\nRequired role\n-------------\n\nTo get the permissions that you need to enable, disable, or modify a\nBigtable change stream, ask your administrator to grant you the\nfollowing IAM role.\n\n- Bigtable Administrator ([`roles/bigtable.admin`](/bigtable/docs/access-control#bigtable.admin)) on the Bigtable instance that contains the table you plan to stream changes from\n\nEnable a change stream\n----------------------\n\nTo enable a change stream on an existing table, complete the following steps: \n\n### Console\n\n1.\n Open the list of Bigtable instances in the Google Cloud console.\n\n\n [Open the instance list](https://console.cloud.google.com/bigtable/instances)\n2. Click the instance containing the table that you want to enable a change\n stream for.\n\n3. Click **Tables** in the left pane.\n\n The Tables page displays a list of tables in the instance.\n4. Click **Edit** for the table for which you want to enable a change\n stream.\n\n5. Click **Enable change stream**.\n\n6. In the **Expiration time** field, enter a number from 1 to 7 to\n configure the number of days that data stream records should be\n retained.\n\n7. Click **Save**.\n\n### gcloud\n\nTo enable a change stream on a table, use the [`gcloud bigtable instances\ntables update`](/sdk/gcloud/reference/bigtable/instances/tables/update)\ncommand. \n\n gcloud bigtable instances tables update \u003cvar translate=\"no\"\u003eTABLE_ID\u003c/var\u003e \\\n --instance=\u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --change-stream-retention-period=\u003cvar translate=\"no\"\u003eCHANGE_STREAM_RETENTION_PERIOD\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eTABLE_ID\u003c/code\u003e\u003c/var\u003e: the ID for the table whose changes you want to stream\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eINSTANCE_ID\u003c/code\u003e\u003c/var\u003e: the instance that contains the table\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e: the project that contains the instance\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eCHANGE_STREAM_RETENTION_PERIOD\u003c/code\u003e\u003c/var\u003e: the length of time that Bigtable should keep change stream data for the table. Must be no less than one day and no more than seven days, expressed as a number and a letter for the unit. Acceptable units are days (d), hours (h), minutes (m), and seconds (s). Example: `5d`\n\nDisable a change stream\n-----------------------\n\nYou can disable a table's change stream at any time. Data stream records that\nwere created before you disable the change stream continue to consume storage\nuntil the next [compaction](/bigtable/docs/overview#compactions), but you are no\nlonger charged for that storage. You can't read a change stream after you\ndisable it, including changes recorded before you disable the stream. \n\n### Console\n\n1.\n Open the list of Bigtable instances in the Google Cloud console.\n\n\n [Open the instance list](https://console.cloud.google.com/bigtable/instances)\n2. Click the instance whose tables you want to view.\n\n3. Click **Tables** in the left pane.\n\n The Tables page displays a list of tables in the instance.\n4. Click **Edit** for the table whose change stream configuration you want\n to disable.\n\n5. Clear the checkmark from **Enable change stream**.\n\n6. Click **Save**.\n\n### gcloud\n\nTo disable a change stream on a table, use the [`gcloud bigtable instances\ntables update`](/sdk/gcloud/reference/bigtable/instances/tables/update)\ncommand. \n\n gcloud bigtable instances tables update \u003cvar translate=\"no\"\u003eTABLE_ID\u003c/var\u003e \\\n --instance=\u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --clear-change-stream-retention-period\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eTABLE_ID\u003c/code\u003e\u003c/var\u003e: the ID for the table whose changes you want to stream\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eINSTANCE_ID\u003c/code\u003e\u003c/var\u003e: the instance that contains the table\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e: the project that contains the instance\n\nModify a change stream's retention time\n---------------------------------------\n\nYou can modify the number of days that Bigtable keeps your change\nstream records. If you reduce the number of days, records that were streamed\nbefore the configuration change continue to consume storage until the next\n[compaction](/bigtable/docs/overview#compactions). After the configuration\nchange, you can only stream changes from the newly specified time period.\n\nIf you increase the retention time, it's not retroactive --- change streams\nare kept for the increased number of days starting when you modify the\nconfiguration. \n\n### Console\n\n1.\n Open the list of Bigtable instances in the Google Cloud console.\n\n\n [Open the instance list](https://console.cloud.google.com/bigtable/instances)\n2. Click the instance whose tables you want to view.\n\n3. Click **Tables** in the left pane.\n\n The Tables page displays a list of tables in the instance.\n4. Click **Edit** for the table whose change stream configuration you want\n to modify.\n\n5. In the Expiration time field, enter a number from 1 to 7 for the number\n of days that data stream records should be retained.\n\n6. Click **Save**.\n\n### gcloud\n\nTo change the retention period for a table's change stream, use the [`gcloud\nbigtable instances tables\nupdate`](/sdk/gcloud/reference/bigtable/instances/tables/update)\ncommand. \n\n gcloud bigtable instances tables update \u003cvar translate=\"no\"\u003eTABLE_ID\u003c/var\u003e \\\n --instance=\u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --change-stream-retention-period=\u003cvar translate=\"no\"\u003eCHANGE_STREAM_RETENTION_PERIOD\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eTABLE_ID\u003c/code\u003e\u003c/var\u003e: the ID for the table whose changes you want to stream\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eINSTANCE_ID\u003c/code\u003e\u003c/var\u003e: the instance that contains the table\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e: the project that contains the instance\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eCHANGE_STREAM_RETENTION_PERIOD\u003c/code\u003e\u003c/var\u003e: the length of time that Bigtable should keep change stream data for the table. Must be from one to seven days, expressed as a number and a letter for the unit. Acceptable units are days (d), hours (h), minutes (m), and seconds (s). Example: `5d`\n\nWhat's next\n-----------\n\n- [Read a change stream with Dataflow.](/bigtable/docs/change-streams-use-dataflow)\n- [Review Bigtable pricing.](/bigtable/pricing)\n- [Complete a quickstart to learn how to enable a change stream and view changes.](/bigtable/docs/change-streams-quickstart)\n- [Use the Cloud Bigtable client library for Java to read change streams.](/bigtable/docs/change-streams-read-java)\n- [Work through a tutorial about processing a change stream.](/bigtable/docs/change-streams-tutorial)"]]
