[Ultimate]{class="badge positive"}
Fuente de Snowflake
- El origen Snowflake está disponible en el catálogo de orígenes para los usuarios que han adquirido Real-Time Customer Data Platform Ultimate.
- De manera predeterminada, el origen Snowflake interpreta
nullcomo una cadena vacía. Póngase en contacto con su representante de Adobe para asegurarse de que los valores denullse escriban correctamente comonullen Adobe Experience Platform. - Para que Experience Platform pueda introducir datos, las zonas horarias de todos los orígenes de lotes basados en tablas deben configurarse en UTC. La única marca de tiempo compatible con el origen Snowflake es TIMESTAMP_NTZ con la hora UTC.
Snowflake es una plataforma de almacén de datos basada en la nube diseñada para permitir a las organizaciones almacenar, procesar y analizar grandes volúmenes de datos de forma eficaz. Creado para aprovechar la escalabilidad y flexibilidad de la nube, Snowflake admite la integración de datos, análisis avanzados y uso compartido fluido entre equipos. Como servicio totalmente administrado, Snowflake elimina las complejidades de mantenimiento comunes a las bases de datos tradicionales, lo que le permite centrarse en obtener información y valor de sus datos.
Puede usar el origen Snowflake para conectarse y llevar los datos de Snowflake a Adobe Experience Platform. Lea la siguiente documentación para aprender a configurar el origen de Snowflake y conectarse a Experience Platform.
Requisitos previos prerequisites
En esta sección se describen las tareas de configuración que debe realizar para poder conectar el origen de Snowflake a Experience Platform.
LISTA DE PERMITIDOS de direcciones IP
Debe añadir direcciones IP específicas de la región a la lista de permitidos antes de conectar los orígenes a Experience Platform. Para obtener más información, lea la guía de inclusión en la lista de permitidos de direcciones IP para conectarse a Experience Platform.
Recopilar credenciales necesarias
Debe proporcionar valores para las siguientes propiedades de credenciales para autenticar el origen de Snowflake.
Proporcione valores para las siguientes credenciales para conectar Snowflake a Experience Platform en Azure mediante la autenticación de clave de cuenta.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Credencial | Descripción |
account |
Un nombre de cuenta identifica de forma exclusiva una cuenta de su organización. En este caso, debe identificar una cuenta de forma exclusiva en diferentes organizaciones de Snowflake. Para ello, debe anteponer el nombre de su organización al nombre de la cuenta. Por ejemplo: myorg-myaccount.snowflakecomputing.com. Lee la sección sobre cómo recuperar tu Snowflake identificador de cuenta para obtener más instrucciones. Para obtener más información, consulte la Snowflake documentación. |
warehouse |
El almacén Snowflake administra el proceso de ejecución de consultas para la aplicación. Cada almacén de Snowflake es independiente entre sí y se debe acceder a él de forma individual al llevar datos a Experience Platform. |
database |
La base de datos Snowflake contiene los datos que desea obtener de Experience Platform. |
username |
El nombre de usuario de la cuenta Snowflake. |
password |
Contraseña de la cuenta de usuario Snowflake. |
role |
La función de control de acceso predeterminada que se usará en la sesión Snowflake. La función debe ser una función existente que ya se haya asignado al usuario especificado. La función predeterminada es PUBLIC. |
connectionString |
Cadena de conexión utilizada para conectarse a la instancia Snowflake. El patrón de cadena de conexión de Snowflake es jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}. |
Para utilizar la autenticación de par clave, genere primero un par clave RSA de 2048 bits. A continuación, proporcione valores para las siguientes credenciales para conectarse a Experience Platform en Azure mediante la autenticación de par de claves.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Credencial | Descripción |
account |
Un nombre de cuenta identifica de forma exclusiva una cuenta de su organización. En este caso, debe identificar una cuenta de forma exclusiva en diferentes organizaciones de Snowflake. Para ello, debe anteponer el nombre de su organización al nombre de la cuenta. Por ejemplo: myorg-myaccount.snowflakecomputing.com. Lee la sección sobre cómo recuperar tu Snowflake identificador de cuenta para obtener más instrucciones. Para obtener más información, consulte la Snowflake documentación. |
username |
El nombre de usuario de su cuenta de Snowflake. |
privateKey |
La clave privada codificada Base64- de su cuenta de Snowflake. Puede generar claves privadas cifradas o no cifradas. Si utiliza una clave privada cifrada, también debe proporcionar una frase de contraseña de clave privada al autenticarse con Experience Platform. Lea la sección sobre recuperación de la clave privada para obtener más información. |
privateKeyPassphrase |
La frase de contraseña de clave privada es una capa adicional de seguridad que debe utilizar al autenticarse con una clave privada cifrada. No es necesario que proporcione la frase de contraseña si utiliza una clave privada no cifrada. |
port |
Número de puerto que usa Snowflake al conectarse a un servidor a través de Internet. |
database |
La base de datos Snowflake que contiene los datos que desea introducir en Experience Platform. |
warehouse |
El almacén Snowflake administra el proceso de ejecución de consultas para la aplicación. Cada almacén de Snowflake es independiente entre sí y se debe acceder a él de forma individual al llevar datos a Experience Platform. |
Para obtener más información sobre estos valores, consulte la Snowflake guía de autenticación de par clave.
Proporcione valores para las siguientes credenciales a fin de conectar Snowflake a Experience Platform en AWS mediante autenticación básica.
| note warning |
|---|
| WARNING |
| La autenticación básica (o autenticación de clave de cuenta) para el origen Snowflake quedará obsoleta en noviembre de 2025. Debe pasar a la autenticación basada en pares de claves para seguir utilizando el origen e introduciendo datos de la base de datos en Experience Platform. Para obtener más información sobre la obsolescencia, lea la Snowflake guía de prácticas recomendadas sobre cómo mitigar los riesgos de compromiso de credenciales. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Credencial | Descripción |
host |
La URL de host a la que se conecta su cuenta de Snowflake. |
port |
Número de puerto que usa Snowflake al conectarse a un servidor a través de Internet. |
username |
El nombre de usuario asociado con su cuenta de Snowflake. |
password |
La contraseña asociada a su cuenta de Snowflake. |
database |
Base de datos Snowflake de la que se extraerán los datos. |
schema |
Nombre del esquema asociado con la base de datos Snowflake. Debe asegurarse de que el usuario al que desea otorgar acceso a la base de datos también tenga acceso a este esquema. |
warehouse |
El almacén de Snowflake que está utilizando. |
Para utilizar la autenticación de par clave, genere primero un par clave RSA de 2048 bits. A continuación, proporcione valores para las siguientes credenciales para conectarse a Experience Platform en AWS mediante la autenticación de par de claves.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Credencial | Descripción |
account |
Un nombre de cuenta identifica de forma exclusiva una cuenta de su organización. En este caso, debe identificar una cuenta de forma exclusiva en diferentes organizaciones de Snowflake. Para ello, debe anteponer el nombre de su organización al nombre de la cuenta. Por ejemplo: http://myorg-myaccount.snowflakecomputing.com/. Lee la guía sobre cómo recuperar tu Snowflake identificador de cuenta para obtener instrucciones adicionales. Para obtener más información, consulte la Snowflake documentación. |
username |
El nombre de usuario de su cuenta de Snowflake. |
privateKey |
La clave privada del usuario Snowflake, codificada en Base64 como una sola línea sin encabezados ni saltos de línea. Para prepararlo, copie el contenido del archivo PEM, quite las BEGIN/END líneas y todos los saltos de línea y, a continuación, codifique el resultado en base64. Lea la sección sobre recuperación de la clave privada para obtener más información. Nota: Actualmente no se admiten claves privadas cifradas para una conexión de AWS. |
port |
Número de puerto que usa Snowflake al conectarse a un servidor a través de Internet. |
database |
La base de datos Snowflake que contiene los datos que desea introducir en Experience Platform. |
warehouse |
El almacén Snowflake administra el proceso de ejecución de consultas para la aplicación. Cada almacén de Snowflake es independiente entre sí y se debe acceder a él de forma individual al llevar datos a Experience Platform. |
Para obtener más información sobre estos valores, consulte la Snowflake guía de autenticación de par clave.
Recuperación del identificador de cuenta retrieve-your-account-identifier
Debe recuperar su identificador de cuenta del panel de interfaz de usuario de Snowflake, ya que lo utilizará para autenticar su instancia de Snowflake en Experience Platform.
Para recuperar el identificador de la cuenta:
- Use el Snowflake panel de interfaz de usuario de la aplicación para acceder a su cuenta.
- En el panel de navegación izquierdo, seleccione Accounts y, a continuación, seleccione Active Accounts en el encabezado.
- A continuación, seleccione el icono de información y, luego, seleccione y copie el nombre de dominio de la dirección URL actual.
Genere su par de claves RSA
Use OpenSSL en la interfaz de línea de comandos para generar un par de claves RSA de 2048 bits en formato PKCS#8. Se recomienda crear una clave privada cifrada para la seguridad, que requerirá una frase de contraseña.
Para generar su clave privada Snowflake cifrada, ejecute el siguiente comando en el terminal:
| code language-bash |
|---|
|
Para generar la clave privada Snowflake sin cifrar, ejecute el siguiente comando en el terminal:
| code language-bash |
|---|
|
Genere una clave pública a partir de su clave privada
A continuación, ejecute el siguiente comando en la interfaz de la línea de comandos para crear una clave pública basada en la clave privada.
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub# You will be prompted to enter the passphrase if the private key is encrypted.
Asignar la clave pública al usuario Snowflake
Debe usar un rol de administrador de Snowflake (como SECURITYADMIN) para asociar la clave pública generada con el usuario de servicio Snowflake que usará Experience Platform. Para recuperar el contenido de clave pública, abra el archivo rsa_key.pub y copie todo el contenido, excluyendo las -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- líneas. A continuación, ejecute el siguiente SQL en Snowflake:
ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';
Codifique la clave privada en Base64
Experience Platform requiere que la clave privada esté codificada en Base64 y se proporcione como una cadena durante la configuración de la conexión. Use una herramienta o script adecuado para codificar el contenido del archivo rsa_key.p8 en una sola cadena Base64.
(-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----), antes o después del proceso de codificación, ya que esto puede provocar errores de autenticación.Comprobar configuraciones
Antes de crear la conexión de origen de Snowflake en Experience Platform, debe asegurarse de que Default Role y Default Warehouse del usuario coincidan con los valores proporcionados en Experience Platform. Puede comprobar esta configuración en la interfaz de usuario de Snowflake mediante el comando SQL DESCRIBE USER {USERNAME}.
También puede seguir los pasos a continuación para comprobar la configuración:
- Seleccione Admin en el panel de navegación izquierdo y luego seleccione Users & Roles.
- Seleccione el usuario adecuado y, a continuación, seleccione los puntos suspensivos (
...) en la esquina superior derecha. - En la ventana Edit user que aparece, vaya a Default Role para ver la función asociada con el usuario determinado.
- En la misma ventana, vaya a Default Warehouse para ver el almacén asociado con el usuario determinado.
Próximos pasos
Una vez completada la instalación, ahora puede continuar conectando su cuenta de Snowflake a Experience Platform. Lea la siguiente documentación para obtener más información: