Antes de crear una transmisión en Datastream, configura perfiles de conexión que almacenen parámetros de configuración de autenticación y conectividad de red reutilizables para los recursos de la misma región.
Puedes crear perfiles de conexión de origen para Oracle, MySQL, PostgreSQL, SQL Server, MongoDB, Spanner, Salesforce, Salesforce Marketing Cloud, ServiceNow, Microsoft Dataverse o Workday. En el caso de los destinos, puedes crear perfiles de conexión para conjuntos de datos de BigQuery o un bucket de Cloud Storage.
Antes de comenzar
- Asegúrate de haber configurado la base de datos de origen para la replicación. Para obtener información sobre los pasos necesarios para cada tipo de fuente compatible, consulta Configura fuentes.
- Descubre qué pasos podrían ser necesarios para configurar el destino seleccionado. Para obtener más información, consulta Configura destinos.
Crea un perfil de conexión para la base de datos de Oracle
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crea un perfil de conexión, haz clic en el tipo de perfil Oracle.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de conexión de la página Crear perfil de Oracle:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de Oracle de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. IP o nombre de host Ingresa un nombre de host o una dirección IP que Datastream pueda usar para conectarse a la base de datos de origen de Oracle.
Si usas la conectividad privada para comunicarte con la base de datos de origen, especifica la dirección IP privada (interna) de la base de datos de origen.
Para otros métodos de conectividad, como la lista de IP permitidas, proporciona la dirección IP pública.
Puerto Ingresa el número de puerto reservado para la base de datos de origen (por lo general, el puerto predeterminado es 1521). Username Ingresa el nombre de usuario de la cuenta de la base de datos de origen (por ejemplo, ROOT). Este es el usuario de Datastream que creaste para la base de datos.Para obtener más información sobre cómo crear este usuario, consulta Configura tu base de datos de Oracle de origen.
Selecciona la contraseña de Secret Manager Selecciona esta opción si quieres autenticarte con un secreto en lugar de ingresar la contraseña de forma manual. Cuando seleccionas esta opción, aparecen dos menús desplegables: - Secreto: Puedes seleccionar un secreto de la lista (si está disponible), ingresarlo de forma manual o crear uno nuevo: Para ingresar un secreto de forma manual, sigue estos pasos:
- Haz clic en Ingresar un secreto manualmente. Aparecerá el cuadro de diálogo Agregar un Secret por ID de recurso.
- Copia y pega el identificador de recurso del Secret desde Secret Manager. El ID del recurso del Secret puede tener el siguiente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(versión más reciente)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versión específica)- Haz clic en el botón Agregar secreto.
- Haz clic en Crear un secreto nuevo. Se abrirá el panel lateral Detalles del Secret.
- En Nombre, ingresa un nombre para el secreto (por ejemplo,
my-secret). Un nombre de secreto puede contener letras mayúsculas y minúsculas, números, guiones y guiones bajos. La longitud máxima permitida para un nombre es de 255 caracteres. El nombre que crees se agregará como parte del identificador del recurso del Secret. - Opcional: Para agregar también una versión del secreto cuando creas el secreto inicial, ingresa un valor en el campo Valor del secreto (por ejemplo,
abcd1234). El valor del secreto puede tener cualquier formato, pero no debe superar los 64 KiB. También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. - Haz clic en el botón Crear secreto.
- Versión del secreto: Ingresa la versión del secreto que deseas usar:
- Cuando proporcionas el identificador de recursos del secreto, aparece la casilla de verificación Usar la versión más reciente. Puedes seleccionarla para usar la versión más actualizada de tu recurso de secreto.
- Como alternativa, puedes expandir el menú desplegable Versión del Secret y seleccionar la versión de la lista, si está disponible.
- Si quieres usar una versión diferente del secreto, sigue estos pasos:
- Haz clic en Agregar versión nueva.
- En el campo Valor del Secret, ingresa un valor para el Secret. Como alternativa, puedes subir un archivo que contenga el valor del secreto.
- Haz clic en el botón Agregar versión nueva.
Ingresar contraseña manualmente Como alternativa, puedes ingresar la contraseña de la cuenta de la base de datos de origen de forma manual.
Identificador del sistema (SID) Ingresa el servicio que garantiza que la base de datos de Oracle de origen esté protegida y supervisada. Para las bases de datos de Oracle, el servicio de base de datos suele ser ORCL. Para las bases de datos conectables, el SID es el nombre de la base de datos conectable. Habilita el acceso de ASM para el lector binario Selecciona esta casilla de verificación si almacenas tus registros de Oracle en la Administración automática de almacenamiento (ASM). Esta casilla de verificación solo se aplica al método de CDC del lector de registros binarios (versión preliminar). Si la seleccionas, debes completar los detalles de conexión de tu instancia de ASM, incluido el nombre del servicio de ASM. La cuenta de usuario para la conexión de ASM debe tener el privilegio SYSASM. Para obtener más información sobre los métodos de CDC disponibles, consulta Trabaja con archivos de registro de rehacer de la base de datos de Oracle.De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
En la sección Define los parámetros de configuración de conexión, haz clic en CONTINUAR. La página Protege la conexión a la fuente está activa.
En el menú Tipo de encriptación, selecciona una de las siguientes opciones:
Tipo de encriptación Descripción Ninguna Datastream se conecta a la base de datos de origen sin encriptación. Solo el servidor Cuando Datastream se conecta a la base de datos de origen, autentica la fuente y se asegura de que se conecte al host correcto de forma segura. Esto evita los ataques de intermediario.
En la autenticación solo del servidor, la fuente no autentica Datastream. Para usar la autenticación solo del servidor, debes proporcionar el certificado codificado con PEM x509 de la autoridad certificadora (CA) que firmó el certificado de la fuente. Asegúrate de usar un solo certificado, ya que Datastream no admite cadenas de certificados.
En la sección Protege la conexión a la fuente, haz clic en CONTINUAR. Se activará la sección Define el método de conectividad de la página Crea un perfil de Oracle.
En el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo Datastream se conecta a la base de datos de origen. Entre los métodos actuales de conectividad de red, se incluyen los siguientes:
- Lista de IPs permitidas: Este método funciona configurando el servidor de la base de datos de origen para que acepte conexiones de Datastream. Si seleccionas este método de conectividad de red, configura la base de datos de origen a fin de permitir conexiones entrantes desde las direcciones IP públicas de Datastream de la región que especificaste para el perfil de conexión.
- Túnel SSH de reenvío: Este método establece una conectividad segura y encriptada entre Datastream y la base de datos de origen, con un túnel SSH a un servidor de túnel o al servidor de la base de datos. Si seleccionas este método de conectividad de red, ocurrirá lo siguiente:
- Ingresa el nombre de host o la dirección IP y el puerto del servidor de host del túnel.
- Ingresa el nombre de usuario de la cuenta del servidor de host del túnel.
- Selecciona el método de autenticación para el túnel SSH. Si seleccionas Contraseña como método, ingresa la contraseña de la cuenta para la VM de host de bastión. Si seleccionas Par de claves públicas y privadas como método, proporciona una clave privada.
- Configura el host del túnel para permitir conexiones entrantes desde las direcciones IP públicas de Datastream para la región que especificaste en el perfil de conexión.
Conectividad privada: Este método te permite establecer una conectividad segura entre Datastream y la base de datos de origen, de forma interna en Google Cloud, o con fuentes externas conectadas a través de una VPN o Interconnect. Esta comunicación se realiza a través de una interfaz de Private Service Connect o una conexión de intercambio de tráfico entre VPC.
Si seleccionas este método de conectividad de red y creaste una configuración de conectividad privada, selecciónala de la lista de configuraciones. Este tipo de configuración contiene información que Datastream usa para comunicarse con la base de datos de origen a través de una red privada.
Si no creó una configuración de conectividad privada, cree una haciendo clic en CREATE PRIVATE CONNECTIVITY CONFIGURATION, en la parte inferior de la lista desplegable y, luego, realice los mismos pasos que aparecen en Cómo crear una configuración privada configuración de conectividad.
En la sección Definir método de conectividad, haz clic en CONTINUAR. La sección Probar perfil de conexión de la página Crear perfil de Oracle está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Se pueden realizar los cambios necesarios y, luego, volver a probarlos en la página Crear perfil de Oracle.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para la base de datos de MySQL
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crea un perfil de conexión, haz clic en el tipo de perfil MySQL.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de la conexión de la página Crear perfil de MySQL:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de MySQL de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. IP o nombre de host Ingresa un nombre de host o una dirección IP que Datastream pueda usar para conectarse a la base de datos de MySQL de origen.
Si usas la conectividad privada para comunicarte con la base de datos de origen, especifica la dirección IP privada (interna) de la base de datos de origen.
Para otros métodos de conectividad, como la lista de IP permitidas o SSH de reenvío, proporciona la dirección IP pública.
Puerto Ingresa el número de puerto reservado para la base de datos de origen (el puerto predeterminado suele ser 3306). Username Ingresa el nombre de usuario de la cuenta de la base de datos de origen (por ejemplo,
root). Este es el usuario de Datastream que creaste para la base de datos.Para obtener más información sobre cómo crear este usuario, consulta Configura una base de datos de MySQL de origen.
Selecciona la contraseña de Secret Manager Selecciona esta opción si quieres autenticarte con un secreto en lugar de ingresar la contraseña de forma manual. Cuando seleccionas esta opción, aparecen dos menús desplegables: - Secreto: Puedes seleccionar un secreto de la lista (si está disponible), ingresarlo de forma manual o crear uno nuevo: Para ingresar un secreto de forma manual, sigue estos pasos:
- Haz clic en Ingresar un secreto manualmente. Aparecerá el cuadro de diálogo Agregar un Secret por ID de recurso.
- Copia y pega el identificador de recurso del Secret desde Secret Manager. El ID del recurso del Secret puede tener el siguiente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(versión más reciente)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versión específica)- Haz clic en Agregar Secret.
- Haz clic en Crear un secreto nuevo. Se abrirá el panel lateral Detalles del Secret.
- En Nombre, ingresa un nombre para el secreto (por ejemplo,
my-secret). Un nombre de secreto puede contener letras mayúsculas y minúsculas, números, guiones y guiones bajos. La longitud máxima permitida para un nombre es de 255 caracteres. El nombre que crees se agregará como parte del identificador del recurso del Secret. - Opcional: Para agregar también una versión del secreto cuando creas el secreto inicial, ingresa un valor en el campo Valor del secreto (por ejemplo,
abcd1234). El valor del secreto puede tener cualquier formato, pero no debe superar los 64 KiB. También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. - Haz clic en el botón Crear secreto.
- Versión del secreto: Ingresa la versión del secreto que deseas usar:
- Cuando proporcionas el identificador de recursos del secreto, aparece la casilla de verificación Usar la versión más reciente. Puedes seleccionarla para usar la versión más actualizada de tu recurso de secreto.
- Como alternativa, puedes expandir el menú desplegable Versión del Secret y seleccionar la versión de la lista, si está disponible.
- Si quieres usar una versión diferente del secreto, sigue estos pasos:
- Haz clic en Agregar versión nueva.
- En el campo Valor del Secret, ingresa un valor para el Secret. Como alternativa, puedes subir un archivo que contenga el valor del secreto.
- Haz clic en el botón Agregar versión nueva.
Ingresar contraseña manualmente Como alternativa, puedes ingresar la contraseña de la cuenta de la base de datos de origen de forma manual.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
En la sección Define los parámetros de configuración de conexión, haz clic en CONTINUAR. La página Protege la conexión a la fuente está activa.
En el menú Tipo de encriptación, selecciona una de las siguientes opciones:
Tipo de encriptación Descripción Ninguna Datastream se conecta a la base de datos de origen sin encriptación. Solo el servidor Cuando Datastream se conecta a la base de datos de origen, autentica la fuente y se asegura de que se conecte al host correcto de forma segura. Esto evita los ataques de intermediario.
En la autenticación solo del servidor, la fuente no autentica Datastream. Para usar la autenticación solo del servidor, debes proporcionar el certificado codificado con PEM x509 de la autoridad certificadora (CA) que firmó el certificado de la fuente. Asegúrate de usar un solo certificado, ya que Datastream no admite cadenas de certificados.
Cliente del servidor Cuando Datastream se conecta a la fuente, Datastream autentica la fuente y la fuente autentica Datastream.
La autenticación servidor-cliente proporciona la mayor seguridad. Sin embargo, si no quieres darle un certificado de cliente y una clave privada al cliente cuando creas el perfil de conexión, puedes utilizar la autenticación solo del servidor.
Para usar la autenticación servidor-cliente, debes otorgar los siguientes elementos durante la creación del perfil de conexión de origen:
- El certificado de la AC que firmó el certificado del servidor de la base de datos de origen (el certificado de la AC)
- Es el certificado que usa la instancia para autenticarse en el servidor de la base de datos de origen (el certificado de cliente).
- La clave privada asociada con el certificado de cliente (la clave de cliente).
En la sección Protege la conexión a la fuente, haz clic en CONTINUAR. Se activará la sección Define el método de conectividad de la página Crea un perfil de MySQL.
En el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo Datastream se conecta a la base de datos de origen. Entre los métodos actuales de conectividad de red, se incluyen los siguientes:
- Lista de IPs permitidas: Este método funciona configurando el servidor de la base de datos de origen para que acepte conexiones de Datastream. Si seleccionas este método de conectividad de red, configura la base de datos de origen a fin de permitir conexiones entrantes desde las direcciones IP públicas de Datastream de la región que especificaste para el perfil de conexión.
- Túnel SSH de reenvío: Este método establece una conectividad segura y encriptada entre Datastream y la base de datos de origen, con un túnel SSH a un servidor de túnel o al servidor de la base de datos. Si seleccionas este método de conectividad de red, ocurrirá lo siguiente:
- Ingresa el nombre de host o la dirección IP y el puerto del servidor de host del túnel.
- Ingresa el nombre de usuario de la cuenta del servidor de host del túnel.
- Selecciona el método de autenticación para el túnel SSH. Si seleccionas Contraseña como método, ingresa la contraseña de la cuenta para la VM de host de bastión. Si seleccionas Par de claves públicas y privadas como método, proporciona una clave privada.
- Configura el host del túnel para permitir conexiones entrantes desde las direcciones IP públicas de Datastream para la región que especificaste en el perfil de conexión.
Conectividad privada: Este método te permite establecer una conectividad segura entre Datastream y la base de datos de origen, de forma interna en Google Cloud, o con fuentes externas conectadas a través de una VPN o Interconnect. Esta comunicación se realiza a través de una interfaz de Private Service Connect o una conexión de intercambio de tráfico entre VPC.
Si seleccionas este método de conectividad de red y creaste una configuración de conectividad privada, selecciónala de la lista de configuraciones. Este tipo de configuración contiene información que Datastream usa para comunicarse con la base de datos de origen a través de una red privada.
Si no creó una configuración de conectividad privada, cree una haciendo clic en CREATE PRIVATE CONNECTIVITY CONFIGURATION, en la parte inferior de la lista desplegable y, luego, realice los mismos pasos que aparecen en Cómo crear una configuración privada configuración de conectividad.
En la sección Definir método de conectividad, haz clic en CONTINUAR. La sección Probar perfil de conexión de la página Crear perfil de MySQL está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para la base de datos de PostgreSQL
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crea un perfil de conexión, haz clic en el tipo de perfil PostgreSQL.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de conexión de la página Crea un perfil de PostgreSQL:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de PostgreSQL de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. IP o nombre de host Ingresa un nombre de host o una dirección IP que Datastream pueda usar para conectarse a la base de datos de PostgreSQL de origen.
Si usas la conectividad privada para comunicarte con la base de datos de origen, especifica la dirección IP privada (interna) de la base de datos de origen.
Para otros métodos de conectividad, como la lista de IP permitidas o SSH de reenvío, proporciona la dirección IP pública.
Puerto Ingresa el número de puerto reservado para la base de datos de origen (el puerto predeterminado para PostgreSQL suele ser 5432). Nombre de usuario Ingresa el nombre de usuario de la cuenta de la base de datos de origen (por ejemplo,
root). Este es el usuario de Datastream que creaste para la base de datos.Para obtener más información sobre cómo crear este usuario, consulta Configura tu base de datos de PostgreSQL de origen.
Selecciona la contraseña de Secret Manager Selecciona esta opción si quieres autenticarte con un secreto en lugar de ingresar la contraseña de forma manual. Cuando seleccionas esta opción, aparecen dos menús desplegables: - Secreto: Puedes seleccionar un secreto de la lista (si está disponible), ingresarlo de forma manual o crear uno nuevo: Para ingresar un secreto de forma manual, sigue estos pasos:
- Haz clic en Ingresar un secreto manualmente. Aparecerá el cuadro de diálogo Agregar un Secret por ID de recurso.
- Copia y pega el identificador de recurso del Secret desde Secret Manager. El ID del recurso del Secret puede tener el siguiente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(versión más reciente)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versión específica)- Haz clic en el botón Agregar secreto.
- Haz clic en Crear un secreto nuevo. Se abrirá el panel lateral Detalles del Secret.
- En Nombre, ingresa un nombre para el secreto (por ejemplo,
my-secret). Un nombre de secreto puede contener letras mayúsculas y minúsculas, números, guiones y guiones bajos. La longitud máxima permitida para un nombre es de 255 caracteres. El nombre que crees se agregará como parte del identificador del recurso del Secret. - Opcional: Para agregar también una versión del secreto cuando creas el secreto inicial, ingresa un valor en el campo Valor del secreto (por ejemplo,
abcd1234). El valor del secreto puede tener cualquier formato, pero no debe superar los 64 KiB. También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. - Haz clic en el botón Crear secreto.
- Versión del secreto: Ingresa la versión del secreto que deseas usar:
- Cuando proporcionas el identificador de recursos del secreto, aparece la casilla de verificación Usar la versión más reciente. Puedes seleccionarla para usar la versión más actualizada de tu recurso de secreto.
- Como alternativa, puedes expandir el menú desplegable Versión del Secret y seleccionar la versión de la lista, si está disponible.
- Si quieres usar una versión diferente del secreto, sigue estos pasos:
- Haz clic en Agregar versión nueva.
- En el campo Valor del Secret, ingresa un valor para el Secret. Como alternativa, puedes subir un archivo que contenga el valor del secreto.
- Haz clic en el botón Agregar versión nueva.
Ingresar contraseña manualmente Como alternativa, puedes ingresar la contraseña de la cuenta de la base de datos de origen de forma manual.
Base de datos Ingresa el nombre que identifica la instancia de la base de datos. En el caso de las bases de datos de PostgreSQL, suele ser
postgres.De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CONTINUAR. La página Protege la conexión a la fuente está activa.
En el menú Tipo de encriptación, selecciona una de las siguientes opciones:
Tipo de encriptación Descripción Ninguna Datastream se conecta a la base de datos de origen sin encriptación. Solo el servidor Cuando Datastream se conecta a la base de datos de origen, autentica la fuente y se asegura de que se conecte al host correcto de forma segura. Esto evita los ataques de intermediario.
En la autenticación solo del servidor, la fuente no autentica Datastream. Para usar la autenticación solo del servidor, debes proporcionar el certificado codificado con PEM x509 de la autoridad certificadora (CA) que firmó el certificado de la fuente. Asegúrate de usar un solo certificado, ya que Datastream no admite cadenas de certificados.
Cliente del servidor Cuando Datastream se conecta a la fuente, Datastream autentica la fuente y la fuente autentica Datastream.
La autenticación servidor-cliente proporciona la mayor seguridad. Sin embargo, si no quieres darle un certificado de cliente y una clave privada al cliente cuando creas el perfil de conexión, puedes utilizar la autenticación solo del servidor.
Para usar la autenticación servidor-cliente, debes otorgar los siguientes elementos durante la creación del perfil de conexión de origen:
- El certificado de la AC que firmó el certificado del servidor de la base de datos de origen (el certificado de la AC)
- Es el certificado que usa la instancia para autenticarse en el servidor de la base de datos de origen (el certificado de cliente).
- La clave privada asociada con el certificado de cliente (la clave de cliente).
Haz clic en CONTINUAR. La sección Define el método de conectividad de la página Crea un perfil de PostgreSQL está activa.
En el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo Datastream se conecta a la base de datos de origen. Entre los métodos actuales de conectividad de red, se incluyen los siguientes:
- Lista de IPs permitidas: Este método funciona configurando el servidor de la base de datos de origen para que acepte conexiones de Datastream. Si seleccionas este método de conectividad de red, configura la base de datos de origen a fin de permitir conexiones entrantes desde las direcciones IP públicas de Datastream de la región que especificaste para el perfil de conexión.
- Túnel SSH de reenvío: Este método establece una conectividad segura y encriptada entre Datastream y la base de datos de origen, con un túnel SSH a un servidor de túnel o al servidor de la base de datos. Si seleccionas este método de conectividad de red, ocurrirá lo siguiente:
- Ingresa el nombre de host o la dirección IP y el puerto del servidor de host del túnel.
- Ingresa el nombre de usuario de la cuenta del servidor de host del túnel.
- Selecciona el método de autenticación para el túnel SSH. Si seleccionas Contraseña como método, ingresa la contraseña de la cuenta para la VM de host de bastión. Si seleccionas Par de claves públicas y privadas como método, proporciona una clave privada.
- Configura el host del túnel para permitir conexiones entrantes desde las direcciones IP públicas de Datastream para la región que especificaste en el perfil de conexión.
Conectividad privada: Este método te permite establecer una conectividad segura entre Datastream y la base de datos de origen, de forma interna en Google Cloud, o con fuentes externas conectadas a través de una VPN o Interconnect. Esta comunicación se realiza a través de una interfaz de Private Service Connect o una conexión de intercambio de tráfico entre VPC.
Si seleccionas este método de conectividad de red y creaste una configuración de conectividad privada, selecciónala de la lista de configuraciones. Este tipo de configuración contiene información que Datastream usa para comunicarse con la base de datos de origen a través de una red privada.
Si no creó una configuración de conectividad privada, cree una haciendo clic en CREATE PRIVATE CONNECTIVITY CONFIGURATION, en la parte inferior de la lista desplegable y, luego, realice los mismos pasos que aparecen en Cómo crear una configuración privada configuración de conectividad.
En la sección Definir método de conectividad, haz clic en CONTINUAR. La sección Prueba el perfil de conexión de la página Crea un perfil de PostgreSQL está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para la base de datos de SQL Server
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil SQL Server.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de conexión de la página Crea un perfil de SQL Server:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de SQL Server de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. IP o nombre de host Ingresa un nombre de host o una dirección IP que Datastream pueda usar para conectarse a la base de datos de SQL Server de origen.
Si usas la conectividad privada para comunicarte con la base de datos de origen, especifica la dirección IP privada (interna) de la base de datos de origen.
Para la lista de IPs permitidas, proporciona la dirección IP pública.
Puerto Ingresa el número de puerto reservado para la base de datos de origen (por lo general, el puerto predeterminado es 1433). Nombre de usuario Ingresa el nombre de usuario de la cuenta de la base de datos de origen (por ejemplo,
root). Este es el usuario de Datastream que creaste para la base de datos.Para obtener más información sobre cómo crear este usuario, consulta Configura tu base de datos de SQL Server de origen.
Selecciona la contraseña de Secret Manager Selecciona esta opción si quieres autenticarte con un secreto en lugar de ingresar la contraseña de forma manual. Cuando seleccionas esta opción, aparecen dos menús desplegables: - Secreto: Puedes seleccionar un secreto de la lista (si está disponible), ingresarlo de forma manual o crear uno nuevo: Para ingresar un secreto de forma manual, sigue estos pasos:
- Haz clic en Ingresar un secreto manualmente. Aparecerá el cuadro de diálogo Agregar un Secret por ID de recurso.
- Copia y pega el identificador de recurso del Secret desde Secret Manager. El ID del recurso del Secret puede tener el siguiente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(versión más reciente)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versión específica)- Haz clic en el botón Agregar secreto.
- Haz clic en Crear un secreto nuevo. Se abrirá el panel lateral Detalles del Secret.
- En Nombre, ingresa un nombre para el secreto (por ejemplo,
my-secret). Un nombre de secreto puede contener letras mayúsculas y minúsculas, números, guiones y guiones bajos. La longitud máxima permitida para un nombre es de 255 caracteres. El nombre que crees se agregará como parte del identificador del recurso del Secret. - Opcional: Para agregar también una versión del secreto cuando creas el secreto inicial, ingresa un valor en el campo Valor del secreto (por ejemplo,
abcd1234). El valor del secreto puede tener cualquier formato, pero no debe superar los 64 KiB. También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. - Haz clic en el botón Crear secreto.
- Versión del secreto: Ingresa la versión del secreto que deseas usar:
- Cuando proporcionas el identificador de recursos del secreto, aparece la casilla de verificación Usar la versión más reciente. Puedes seleccionarla para usar la versión más actualizada de tu recurso de secreto.
- Como alternativa, puedes expandir el menú desplegable Versión del Secret y seleccionar la versión de la lista, si está disponible.
- Si quieres usar una versión diferente del secreto, sigue estos pasos:
- Haz clic en Agregar versión nueva.
- En el campo Valor del Secret, ingresa un valor para el Secret. Como alternativa, puedes subir un archivo que contenga el valor del secreto.
- Haz clic en el botón Agregar versión nueva.
Ingresar contraseña manualmente Como alternativa, puedes ingresar la contraseña de la cuenta de la base de datos de origen de forma manual.
Base de datos Ingresa el nombre que identifica la instancia de la base de datos.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en Continuar.
En la sección Define el método de conectividad, en el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo Datastream se conecta a la base de datos de origen. Entre los métodos de conectividad de red, se incluyen los siguientes:
- Lista de IPs permitidas: Este método funciona configurando el servidor de la base de datos de origen para que acepte conexiones de Datastream. Si seleccionas este método de conectividad de red, configura la base de datos de origen a fin de permitir conexiones entrantes desde las direcciones IP públicas de Datastream de la región que especificaste para el perfil de conexión.
- Túnel SSH de reenvío: Este método crea una conexión segura y encriptada entre la base de datos de origen y Datastream. Para configurar este método de conectividad, necesitas un servidor SSH que tenga acceso a la base de datos de origen. Si seleccionas este método de conectividad de red, ocurrirá lo siguiente:
- Ingresa el nombre de host o la dirección IP, y el puerto del servidor de host del túnel.
- Ingresa el nombre de usuario de la cuenta del servidor de host del túnel.
- Selecciona el método de autenticación para el túnel SSH. Si seleccionas Par de claves públicas y privadas como método, proporciona una clave privada. Si seleccionas Contraseña como método, ingresa la contraseña de la cuenta para la VM de host de bastión.
- También es posible que debas incluir en la lista de entidades permitidas las direcciones IP externas de Datastream en el servidor del túnel SSH.
Conectividad privada: Este método te permite establecer una conectividad segura entre Datastream y la base de datos de origen, de forma interna en Google Cloud, o con fuentes externas conectadas a través de una VPN o Interconnect. Esta comunicación se realiza a través de una interfaz de Private Service Connect o una conexión de intercambio de tráfico entre VPC.
Si seleccionas este método de conectividad de red y creaste una configuración de conectividad privada, selecciónala de la lista de configuraciones. Este tipo de configuración contiene información que Datastream usa para comunicarse con la base de datos de origen a través de una red privada.
Si no creó una configuración de conectividad privada, cree una haciendo clic en CREATE PRIVATE CONNECTIVITY CONFIGURATION, en la parte inferior de la lista desplegable y, luego, realice los mismos pasos que aparecen en Cómo crear una configuración privada configuración de conectividad.
Haz clic en CONTINUAR. La sección Prueba el perfil de conexión de la página Crea un perfil de SQL Server está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para una organización de Salesforce
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Salesforce.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de la conexión de la página Crea un perfil de Salesforce:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la organización de Salesforce de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. En la sección Detalles de la conexión, ingresa la dirección URL de tu dominio de Salesforce. Para encontrar la URL de tu dominio, ve a Salesforce y haz clic en Configuración > Configuración de la empresa > Mi dominio. La URL se encuentra en Detalles de mi dominio. Por lo general, tiene el siguiente formato:
domain-name.my.salesforce.com.En Método de autenticación, selecciona tu método de autenticación:
Autenticación de credenciales de cliente de OAuth 2.0: Si seleccionas esta opción, debes indicar el identificador y el secreto del cliente. Para el secreto del cliente, puedes proporcionar el ID del recurso del secreto y la versión de Secret Manager, por ejemplo,
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, o ingresar el valor sin procesar del secreto.Para obtener más información sobre cómo obtener el ID de cliente y el secreto del cliente, consulta Configura una organización de Salesforce de origen.
Autenticación con nombre de usuario y contraseña: Si seleccionas esta opción, debes ingresar el nombre de usuario y la contraseña de tu cuenta de Salesforce.
- En el nombre de usuario, ingresa el nombre que usas para acceder a Salesforce. Si ya accediste a tu organización de Salesforce, puedes encontrar tu nombre de usuario abriendo la página de configuración de tu cuenta y haciendo clic en Información personal. El nombre se encuentra en Nombre de usuario.
Para la contraseña, puedes proporcionar el ID del recurso del Secret y la versión de Secret Manager, por ejemplo,
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, o proporcionar el valor sin procesar de tu contraseña.En la sección Token de seguridad, proporciona el ID y la versión del recurso del Secret del token de Secret Manager, por ejemplo,
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, o ingresa el valor sin procesar del token de seguridad, por ejemplo,C08120F510542FFB1C3640F57AF19E2D5D700556A25F7D665C3B428407709D8C.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en Continuar.
En la sección Revisa el método de conectividad, revisa las direcciones IP regionales de Datastream que se indican y asegúrate de haber configurado tu organización de Salesforce para que acepte conexiones entrantes de estas direcciones. Para obtener más información sobre cómo configurar tu instancia de Salesforce, consulta Configura una organización de Salesforce.
Haz clic en CONTINUAR. La sección Prueba el perfil de conexión de la página Crea un perfil de Salesforce está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para un entorno de Dataverse
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haga clic en Crear perfil.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Dataverse.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de conexión de la página Crear perfil de Dataverse:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la instancia de Dataverse de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. URL del entorno Ingresa la URL de tu entorno de Dataverse, por ejemplo, myorg.crm4.dynamics.com.ID de usuario Ingresa el identificador de usuario de Azure Active Directory asociado a tu entorno de Dataverse. Esto identifica la instancia de Azure AD que se usa para la autenticación. ID de cliente Ingresa el identificador de cliente de la aplicación de Azure AD registrada para conectarse a Dataverse. Esta aplicación se debe configurar con los permisos de API necesarios. Secreto del cliente Ingresa la clave o el valor secretos generados para la aplicación de Azure AD. Este secreto se usa, junto con el ID de cliente, para autenticar la aplicación y establecer la conexión. En la sección Define el método de conectividad, haz clic en Continuar. La sección Prueba el perfil de conexión de la página Crea un perfil de Dataverse está activa.
Haz clic en Ejecutar prueba para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Se pueden realizar los cambios necesarios y, luego, volver a probarlos en la página Crear perfil de Dataverse.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para una instancia de Salesforce Marketing Cloud
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haga clic en Crear perfil.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Salesforce Marketing Cloud.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de la conexión de la página Crea un perfil de Salesforce Marketing Cloud:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la instancia de origen de Salesforce Marketing Cloud. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. Subdominio Ingresa el subdominio de tu instancia de Salesforce Marketing Cloud. Para obtener más información sobre cómo obtener el nombre del subdominio, consulta Configura una instancia de Salesforce Marketing Cloud. ID de cliente Ingresa el ID de cliente de tu instancia de Salesforce Marketing Cloud. Para obtener más información sobre cómo obtener el identificador de cliente, consulta Configura una instancia de Salesforce Marketing Cloud. Secreto del cliente Proporciona el ID y la versión del recurso del secreto de Secret Manager, o ingresa el valor sin procesar del secreto del cliente de tu instancia de Salesforce Marketing Cloud. De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CONTINUAR. La sección Probar perfil de conexión de la página Crear perfil de Salesforce Marketing Cloud está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para una instancia de ServiceNow
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil ServiceNow.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de conexión de la página Crear perfil de ServiceNow:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la instancia de ServiceNow de origen. Datastream usa este nombre en la lista de perfiles de conexión y cuando seleccionas un perfil de conexión existente mientras creas una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que deseas almacenar el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que residan en la misma región que la transmisión. Instancia Ingresa la dirección URL de tu instancia de ServiceNow. Por lo general, tiene el siguiente formato: company.service-now.com.Método de acceso Selecciona un método de autenticación: - Credenciales de la app conectada: Si seleccionas esta opción, debes completar el campo ID de cliente y la sección Secreto del cliente. Para el secreto del cliente, puedes proporcionar el ID y la versión del recurso del secreto de Secret Manager, o bien ingresar el valor sin procesar del secreto.
- Credenciales de usuario: Si seleccionas esta opción, debes ingresar el nombre de usuario y la contraseña de tu cuenta de ServiceNow. Para la contraseña, puedes proporcionar el ID del recurso del Secret y la versión de Secret Manager, o bien el valor sin procesar de la contraseña que creaste cuando configuraste tu usuario de integración en ServiceNow. Para obtener más información, consulta Configura un usuario de integración.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CONTINUAR.
En la sección Revisa el método de conectividad, revisa las direcciones IP regionales de Datastream que se indican y asegúrate de haber configurado tu instancia de ServiceNow para que acepte conexiones entrantes de estas direcciones. Para obtener más información sobre cómo configurar tu instancia de ServiceNow, consulta Configura una instancia de ServiceNow.
Haz clic en CONTINUAR. La sección Prueba el perfil de conexión de la página Crea un perfil de ServiceNow está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Haz clic en CREAR.
Crea un perfil de conexión para una base de datos de MongoDB
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crea un perfil de conexión, haz clic en el tipo de perfil MongoDB.
En la sección Define la configuración de la conexión, especifica la siguiente información:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de MongoDB de origen. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Puedes conservar el ID que se genera automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. Formato de la cadena de conexión Especifica el formato que deseas usar para conectarte a tu fuente de MongoDB:
- Formato de conexión SRV: Es una cadena de conexión con un nombre de host que corresponde a un registro SRV del servicio de nombres de dominio (DNS). Para obtener más información, consulta la documentación de MongoDB.
- Formato de cadena de conexión estándar: Es el formato estándar del URI de conexión de MongoDB que se usa para conectarse a una implementación independiente, un conjunto de réplicas o un clúster fragmentado de MongoDB autoalojado. Para obtener más información, consulta la documentación de MongoDB. Cuando seleccionas esta opción, debes elegir una de las topologías de MongoDB compatibles:
- Clúster fragmentado: Un clúster fragmentado de MongoDB consta de fragmentos, mongos y servidores de configuración. MongoDB fragmenta los datos a nivel de la colección y distribuye los datos de la colección entre los fragmentos del clúster.
- Conjunto de réplicas: Un conjunto de réplicas en MongoDB es un grupo de procesos de
mongodque mantienen el mismo conjunto de datos. Los conjuntos de réplicas proporcionan redundancia y alta disponibilidad, y son la base de todas las implementaciones de producción. Cuando seleccionas esta opción, debes proporcionar un nombre para el conjunto de réplicas.
Nombre de host Ingresa un nombre de host que Datastream pueda usar para conectarse a la base de datos de MongoDB de origen. Si usas el formato de cadena de conexión estándar, puedes agregar nombres de host de todas las máquinas del conjunto de réplicas.
Si usas la conectividad privada para comunicarte con la base de datos de origen, especifica la dirección IP privada (interna) de la base de datos de origen.
Para otros métodos de conectividad, como la lista de IP permitidas, proporciona la dirección IP pública.
Puerto Solo para el formato de cadena de conexión estándar. Ingresa el número de puerto reservado para la base de datos de origen (el puerto predeterminado para MongoDB suele ser 27017). Puedes agregar puertos de todas las máquinas del conjunto de réplicas cuando uses el formato de conexión estándar. Nombre de usuario Ingresa el nombre de usuario de la cuenta de la base de datos de origen (por ejemplo, ROOT). Este es el usuario de Datastream que creaste para la base de datos.Para obtener más información sobre cómo crear este usuario, consulta Configura tu base de datos de MongoDB de origen.
Selecciona la contraseña de Secret Manager Selecciona esta opción si quieres autenticarte con un secreto en lugar de ingresar la contraseña de forma manual. Cuando seleccionas esta opción, aparecen dos menús desplegables: - Secreto: Puedes seleccionar un secreto de la lista (si está disponible), ingresarlo de forma manual o crear uno nuevo: Para ingresar un secreto de forma manual, sigue estos pasos:
- Haz clic en Ingresar un secreto manualmente. Aparecerá el cuadro de diálogo Agregar un Secret por ID de recurso.
- Copia y pega el identificador de recurso del Secret desde Secret Manager. El ID del recurso del Secret puede tener el siguiente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(versión más reciente)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versión específica)- Haz clic en el botón Agregar secreto.
- Haz clic en Crear un secreto nuevo. Se abrirá el panel lateral Detalles del Secret.
- En Nombre, ingresa un nombre para el secreto (por ejemplo,
my-secret). Un nombre de secreto puede contener letras mayúsculas y minúsculas, números, guiones y guiones bajos. La longitud máxima permitida para un nombre es de 255 caracteres. El nombre que crees se agregará como parte del identificador del recurso del Secret. - Opcional: Para agregar también una versión del secreto cuando creas el secreto inicial, ingresa un valor en el campo Valor del secreto (por ejemplo,
abcd1234). El valor del secreto puede tener cualquier formato, pero no debe superar los 64 KiB. También puedes subir un archivo de texto que contenga el valor del secreto con la opción Subir archivo. - Haz clic en el botón Crear secreto.
- Versión del secreto: Ingresa la versión del secreto que deseas usar:
- Cuando proporcionas el identificador de recursos del secreto, aparece la casilla de verificación Usar la versión más reciente. Puedes seleccionarla para usar la versión más actualizada de tu recurso de secreto.
- Como alternativa, puedes expandir el menú desplegable Versión del Secret y seleccionar la versión de la lista, si está disponible.
- Si quieres usar una versión diferente del secreto, sigue estos pasos:
- Haz clic en Agregar versión nueva.
- En el campo Valor del Secret, ingresa un valor para el Secret. Como alternativa, puedes subir un archivo que contenga el valor del secreto.
- Haz clic en el botón Agregar versión nueva.
Ingresar contraseña manualmente Como alternativa, puedes ingresar la contraseña de la cuenta de la base de datos de origen de forma manual.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en Continuar.
En el menú Tipo de encriptación, selecciona una de las siguientes opciones:
La autenticación servidor-cliente proporciona la mayor seguridad. Sin embargo, si no quieres darle un certificado de cliente y una clave privada al cliente cuando creas el perfil de conexión, puedes utilizar la autenticación solo del servidor.
Para usar la autenticación servidor-cliente, debes otorgar los siguientes elementos durante la creación del perfil de conexión de origen:
- El certificado de la AC que firmó el certificado del servidor de la base de datos de origen (el certificado de la AC)
- Es el certificado que usa la instancia para autenticarse en el servidor de la base de datos de origen (el certificado de cliente).
- La clave privada asociada con el certificado de cliente (la clave de cliente).
Tipo de encriptación Descripción Ninguna Datastream se conecta a la base de datos de origen sin encriptación. Solo el servidor Cuando Datastream se conecta a la base de datos de origen, autentica la fuente y se asegura de que se conecte al host correcto de forma segura. Esto evita los ataques de intermediario.
En la autenticación solo del servidor, la fuente no autentica Datastream. Para usar la autenticación solo del servidor, debes proporcionar el certificado codificado con PEM x509 de la autoridad certificadora (CA) que firmó el certificado de la fuente. Asegúrate de usar un solo certificado, ya que Datastream no admite cadenas de certificados.
Cliente del servidor Cuando Datastream se conecta a la fuente, Datastream autentica la fuente y la fuente autentica Datastream.
En la sección Define el método de conectividad, en el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo Datastream se conecta a la base de datos de origen. Entre los métodos de conectividad de red, se incluyen los siguientes:
- Lista de IPs permitidas: Este método funciona configurando el servidor de la base de datos de origen para que acepte conexiones de Datastream. Si seleccionas este método de conectividad de red, configura la base de datos de origen a fin de permitir conexiones entrantes desde las direcciones IP públicas de Datastream de la región que especificaste para el perfil de conexión.
- Túnel SSH de reenvío: Este método crea una conexión segura y encriptada entre la base de datos de origen y Datastream. Para configurar este método de conectividad, necesitas un servidor SSH que tenga acceso a la base de datos de origen. Si seleccionas este método de conectividad de red, ocurrirá lo siguiente:
- Ingresa el nombre de host o la dirección IP del servidor SSH, y el puerto del servidor de host de túnel.
- Ingresa el nombre de usuario de la cuenta del servidor de host del túnel.
- Selecciona el método de autenticación para el túnel SSH. Si seleccionas Par de claves públicas y privadas como método, proporciona una clave privada. Si seleccionas Contraseña como método, ingresa la contraseña de la cuenta para la VM de host de bastión.
- También es posible que debas agregar las direcciones IP externas de Datastream a la lista de entidades permitidas en el servidor del túnel SSH.
Conectividad privada: Este método te permite establecer una conectividad segura entre Datastream y la base de datos de origen, de forma interna en Google Cloud, o con fuentes externas conectadas a través de una VPN o Interconnect. Esta comunicación se realiza a través de una interfaz de Private Service Connect o una conexión de intercambio de tráfico entre VPC.
Si seleccionas este método de conectividad de red y creaste una configuración de conectividad privada, selecciónala de la lista de configuraciones. Este tipo de configuración contiene información que Datastream usa para comunicarse con la base de datos de origen a través de una red privada.
Si no creó una configuración de conectividad privada, cree una haciendo clic en CREATE PRIVATE CONNECTIVITY CONFIGURATION, en la parte inferior de la lista desplegable y, luego, realice los mismos pasos que aparecen en Cómo crear una configuración privada configuración de conectividad.
Haz clic en CONTINUAR. La sección Prueba el perfil de conexión de la página Crea un perfil de MongoDB está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, se indica qué parte del proceso tuvo un problema. Consulta la página Diagnostica problemas para conocer los pasos para solucionar problemas. Puedes realizar los cambios necesarios y, luego, volver a probar el perfil de conexión.
Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.
Haz clic en CREAR.
Crea un perfil de conexión para una base de datos de Spanner
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Spanner.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de la conexión de la página Crear perfil de Spanner:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la base de datos de Spanner de origen. ID del perfil de conexión Datastream completa este campo automáticamente según el nombre del perfil de conexión que ingreses. Región Selecciona la región en la que se almacena el perfil de conexión. Base de datos Ingresa la ruta de acceso completa de la base de datos, incluida la información del proyecto, la instancia y la base de datos. Debe tener el siguiente formato: projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID.De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CONTINUAR. Se activará la sección Prueba el perfil de conexión de la página Crea un perfil de Spanner.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la fuente.
Si la prueba falla, revisa el error y realiza los cambios necesarios antes de volver a probar.
Haz clic en CREAR.
Crea un perfil de conexión para una instancia de Workday
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Workday.
Usa la siguiente tabla para completar los campos de la sección Define la configuración de la conexión:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a la instancia de Workday de origen. ID del perfil de conexión Datastream propaga este campo automáticamente según el nombre que ingreses. Puedes conservar el ID generado automáticamente o cambiarlo. Región Selecciona la región en la que se almacena el perfil de conexión. Una transmisión solo puede usar perfiles de conexión almacenados en la misma región. Host Ingresa el nombre de host de tu instancia de Workday, por ejemplo, wd5-impl.workday.com. Por lo general, el nombre de host se deriva de la URL de acceso de tu instancia. Para obtener más información, consulta Configura una instancia de Workday para la replicación de datos.Usuario Ingresa el nombre corto o el alias de tu usuario de Workday, por ejemplo, google. Este valor identifica tu entorno específico dentro del host de Workday. Para obtener más información, consulta Configura una instancia de Workday para la replicación de datos.ID de cliente Ingresa el ID de cliente que recuperaste durante el registro del cliente de API en Workday. Para obtener más información, consulta Configura una instancia de Workday para la replicación de datos. Secreto del cliente Ingresa el secreto del cliente asociado a tu cliente de API. Puedes ingresar el valor sin procesar o seleccionar un secreto de Secret Manager. Token de actualización Ingresa el token de actualización generado para tu usuario del sistema de integración. Para mejorar la seguridad, te recomendamos que almacenes este valor en Secret Manager. Para obtener más información, consulta Configura una instancia de Workday para la replicación de datos. De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CONTINUAR.
En la sección Revisa el método de conectividad, revisa las direcciones IP regionales de Datastream que se indican. Asegúrate de que tu organización de Workday esté configurada para aceptar conexiones entrantes de estas direcciones.
Haz clic en CONTINUAR. La sección Prueba el perfil de conexión está activa.
Haz clic en EJECUTAR PRUEBA para verificar que Datastream pueda comunicarse con la instancia de Workday de origen.
Haz clic en CREAR.
Crea un perfil de conexión para BigQuery
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crea un perfil de conexión, haz clic en el tipo de perfil BigQuery.
Usa la siguiente tabla para completar los campos de la página Crear perfil de BigQuery:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión a los conjuntos de datos de destino en BigQuery. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Conserva el valor generado de forma automática que se propaga en este campo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. Aunque la región que selecciones para tu perfil de conexión es independiente del tipo de ubicación que seleccionaste para tu conjunto de datos de destino de BigQuery, te recomendamos que mantengas todos los recursos de la transmisión en la misma región que tus datos de origen para optimizar los costos y el rendimiento. De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haz clic en CREAR.
Crea un perfil de conexión para Cloud Storage
Ve a la página Perfiles de conexión en la consola de Google Cloud .
Haz clic en CREAR PERFIL.
En la página Crear un perfil de conexión, haz clic en el tipo de perfil Cloud Storage.
Usa la siguiente tabla para completar los campos de la página Crear perfil de Cloud Storage:
Campo Descripción Nombre del perfil de conexión Ingresa el nombre visible del perfil de conexión al bucket de destino en Cloud Storage. Se usa en la lista de perfiles de conexión y cuando se selecciona un perfil de conexión existente en la creación de una transmisión. ID del perfil de conexión Conserva el valor generado de forma automática que se propaga en este campo. Región Selecciona la región en la que se almacena el perfil de conexión. Los perfiles de conexión, como todos los recursos, se guardan en una región, y una transmisión solo puede usar perfiles de conexión que se almacenen en la misma región que la transmisión. La selección de la región no afecta si Datastream puede conectarse a la fuente o al destino, pero puede afectar la disponibilidad si la región experimenta un tiempo de inactividad. Nombre del bucket Haz clic en EXPLORAR para crear o seleccionar el bucket de destino en Cloud Storage al que Datastream transferirá los datos desde la base de datos de origen.
Si seleccionas un bucket existente, completa los siguientes pasos:
- Haz clic en el ícono de búsqueda (que aparece como una lupa).
- En el campo Buscar por nombre, ingresa los primeros caracteres del nombre del bucket que deseas seleccionar. Datastream filtra la lista de buckets para reflejar lo que ingresas en el campo.
- Selecciona el bucket que quieres usar como destino.
- Haz clic en SELECCIONAR. Tu bucket aparece en el campo Nombre del bucket.
También puedes hacer clic en el ícono Crear bucket nuevo (que aparece como un maletín) para crear un bucket.
De manera opcional, en el campo Prefijo de la ruta del perfil de conexión, puedes proporcionar un prefijo para la ruta que se agregará al nombre del bucket cuando Datastream transfiera los datos al destino.
De manera opcional, usa etiquetas para organizar tus recursos de Datastream.
- Para crear una etiqueta, haz clic en AGREGAR ETIQUETA y, luego, ingresa el par clave-valor de la etiqueta.
- Para quitar la etiqueta, haz clic en el ícono de papelera a la derecha de la fila que contiene la etiqueta.
Haga clic en CREAR.
Después de crear perfiles de conexión, puedes ver información general y detallada sobre ellos.
¿Qué sigue?
- Obtén más información para modificar los perfiles de conexión.
- Obtén más información para ver perfiles de conexión.
- Obtén información para borrar perfiles de conexión.
- Obtén más información sobre cómo funciona Datastream con las fuentes de Dataverse.