Configurar una base de datos de Cloud SQL para PostgreSQL para CDC
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En esta página se describe cómo configurar la captura de datos de cambios (CDC) para transmitir datos de una base de datos de Cloud SQL para PostgreSQL a un destino admitido, como BigQuery o Cloud Storage.
Habilitar la replicación lógica
Ve a Cloud SQL en la Google Cloud consola.
Abre la instancia de Cloud SQL y haz clic en EDITAR.
Ve a la sección Banderas.
Haz clic en AÑADIR MARCA.
Selecciona la bandera cloudsql.logical_decoding en el menú desplegable.
Asigna el valor on a la marca.
Haz clic en GUARDAR para guardar los cambios. Tendrás que reiniciar tu instancia para actualizarla con los cambios.
Una vez que se haya reiniciado la instancia, confirma los cambios en Database flags (Indicadores de base de datos) en la página Overview (Resumen).
Crear una publicación y un slot de replicación
Conéctate a la base de datos como usuario con los privilegios suficientes para crear un slot de replicación. De lo contrario, ejecuta el siguiente comando:
ALTER USER USER_NAME WITH REPLICATION;
Haz los cambios siguientes:
USER_NAME: el nombre del usuario al que quieres conceder privilegios de replicación.
Crea una publicación. Te recomendamos que crees una publicación solo para las tablas que quieras replicar. De esta forma, Datastream puede leer los datos relevantes y se reduce la carga de la base de datos y de Datastream:
CREATE PUBLICATION PUBLICATION_NAME
FOR TABLE SCHEMA1.TABLE1, SCHEMA2.TABLE2;
Haz los cambios siguientes:
PUBLICATION_NAME: el nombre de tu publicación. Deberá proporcionar este nombre cuando cree un flujo en el asistente de creación de flujos de Datastream.
SCHEMA: el nombre del esquema que contiene la tabla.
TABLE: el nombre de la tabla que quieres replicar.
También puede crear una publicación para todas las tablas de su base de datos. Tenga en cuenta que este enfoque aumenta la carga tanto en la base de datos de origen como en Datastream:
CREATE PUBLICATION PUBLICATION_NAME FOR ALL TABLES;
Crea un slot de replicación introduciendo el siguiente comando SQL:
REPLICATION_SLOT_NAME: el nombre de tu ranura de replicación.
Deberá proporcionar este nombre cuando cree un flujo en el asistente de creación de flujos de datos.
Crear un usuario de Datastream
Conéctate a la base de datos mediante un cliente de PostgreSQL.
Introduce el siguiente comando de PostgreSQL:
CREATE USER USER_NAME WITH REPLICATION LOGIN PASSWORD 'USER_PASSWORD';
Haz los cambios siguientes:
USER_NAME: nombre del usuario de Datastream que quieras crear.
USER_PASSWORD: la contraseña de inicio de sesión del usuario de flujo de datos que quieras crear.
Concede los siguientes privilegios al usuario que has creado:
GRANT SELECT ON ALL TABLES IN SCHEMA SCHEMA_NAME TO USER_NAME;
GRANT USAGE ON SCHEMA SCHEMA_NAME TO USER_NAME;
ALTER DEFAULT PRIVILEGES IN SCHEMA SCHEMA_NAME
GRANT SELECT ON TABLES TO USER_NAME;
Haz los cambios siguientes:
SCHEMA_NAME: el nombre del esquema al que quieres conceder los privilegios.
USER_NAME: el usuario al que quieres conceder los privilegios.
Siguientes pasos
Consulta más información sobre cómo funciona Datastream con las fuentes de PostgreSQL.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-10 (UTC)."],[[["\u003cp\u003eEnable logical replication in Cloud SQL by setting the \u003ccode\u003ecloudsql.logical_decoding\u003c/code\u003e flag to 'on' and restarting the instance to apply the changes.\u003c/p\u003e\n"],["\u003cp\u003eCreate a publication for specific tables or all tables, using the \u003ccode\u003eCREATE PUBLICATION\u003c/code\u003e command, to manage the data intended for replication.\u003c/p\u003e\n"],["\u003cp\u003eEstablish a replication slot with a unique name using the \u003ccode\u003ePG_CREATE_LOGICAL_REPLICATION_SLOT\u003c/code\u003e function for each stream replicating from the database.\u003c/p\u003e\n"],["\u003cp\u003eCreate a dedicated Datastream user with replication and login privileges, then grant it necessary \u003ccode\u003eSELECT\u003c/code\u003e and \u003ccode\u003eUSAGE\u003c/code\u003e privileges on the required schemas.\u003c/p\u003e\n"]]],[],null,["# Configure a Cloud SQL for PostgreSQL database\n\nThe following sections cover how to configure a Cloud SQL for PostgreSQL database.\n\n### Enable logical replication\n\n1. Navigate to Cloud SQL in the Google Cloud console.\n\n2. Open the Cloud SQL instance and click **EDIT**.\n\n3. Go to the **Flags** section.\n\n4. Click **ADD FLAG**.\n\n5. Choose the `cloudsql.logical_decoding` flag from the drop-down menu.\n\n6. Set the flag value to **on**.\n\n7. Click **SAVE** to save your changes. You'll need to restart your instance to\n update your instance with the changes.\n\n8. Once your instance has been restarted, confirm your changes under\n **Database flags** on the **Overview** page.\n\n### Create a publication and a replication slot\n\n1. Connect to the database as a user with sufficient privileges to create a replication slot; otherwise, run the following command:\n\n ```\n ALTER USER USER_NAME WITH REPLICATION;\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eUSER_NAME\u003c/var\u003e: The name of the user to whom you want to grant replication privileges.\n\n | If your current user can't run the command, then reconnect to the database with the default `postgres` username and run the command.\n2. Create a publication. We recommend that you create a publication only for the\n tables that you want to replicate. This allows Datastream to read-only\n the relevant data, and lowers the load on the database and Datastream:\n\n ```\n CREATE PUBLICATION PUBLICATION_NAME\n FOR TABLE SCHEMA1.TABLE1, SCHEMA2.TABLE2;\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003ePUBLICATION_NAME\u003c/var\u003e: The name of your publication. You'll need to provide this name when you create a stream in the Datastream stream creation wizard.\n - \u003cvar translate=\"no\"\u003eSCHEMA\u003c/var\u003e: The name of the schema that contains the table.\n - \u003cvar translate=\"no\"\u003eTABLE\u003c/var\u003e: The name of the table that you want to replicate.\n\n You can also create a publication for all tables in your database. Note that\n this approach increases the load on both the source database and Datastream: \n\n ```\n CREATE PUBLICATION PUBLICATION_NAME FOR ALL TABLES;\n ```\n | For PostgreSQL 15 and later, you can create a publication for all tables in a schema. This approach lets you replicate changes for tables in the specified list of schemas, including tables that you create in the future: \n |\n | ```\n | CREATE PUBLICATION PUBLICATION_NAME\n | FOR TABLES IN SCHEMA SCHEMA1, SCHEMA2;\n | ```\n3. Create a replication slot by entering the following SQL command:\n\n ```\n SELECT PG_CREATE_LOGICAL_REPLICATION_SLOT('REPLICATION_SLOT_NAME', 'pgoutput');\n ```\n\n \u003cbr /\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eREPLICATION_SLOT_NAME\u003c/var\u003e: The name of your replication slot. You'll need to provide this name when you create a stream in the Datastream stream creation wizard.\n\n | The replication slot name must be unique for each stream that's replicating from this database.\n\n### Create a Datastream user\n\n1. Connect to the database using a PostgreSQL client.\n\n2. Enter the following PostgreSQL command:\n\n ```\n CREATE USER USER_NAME WITH REPLICATION LOGIN PASSWORD 'USER_PASSWORD';\n ```\n\n \u003cbr /\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eUSER_NAME\u003c/var\u003e: The name of the Datastream user that you want to create.\n - \u003cvar translate=\"no\"\u003eUSER_PASSWORD\u003c/var\u003e: The login password for the Datastream user that you want to create.\n3. Grant the following privileges to the user you created:\n\n ```\n GRANT SELECT ON ALL TABLES IN SCHEMA SCHEMA_NAME TO USER_NAME;\n GRANT USAGE ON SCHEMA SCHEMA_NAME TO USER_NAME;\n ALTER DEFAULT PRIVILEGES IN SCHEMA SCHEMA_NAME\n GRANT SELECT ON TABLES TO USER_NAME;\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eSCHEMA_NAME\u003c/var\u003e: The name of the schema to which you want to grant the privileges.\n - \u003cvar translate=\"no\"\u003eUSER_NAME\u003c/var\u003e: The user to whom you want to grant the privileges.\n\nWhat's next\n-----------\n\n- Learn more about how Datastream works with [PostgreSQL sources](/datastream/docs/sources-postgresql)."]]
