[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.
Adobe Experience Platform permite la ingesta de datos desde fuentes externas, al tiempo que ofrece la posibilidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform. Puede introducir datos de una variedad de fuentes, como aplicaciones de Adobe, almacenamiento basado en la nube, bases de datos y muchas otras.
Experience Platform es compatible con la ingesta de datos desde una base de datos de terceros. Experience Platform puede conectarse a diferentes tipos de bases de datos, como relacionales, NoSQL o almacenes de datos. La compatibilidad con los proveedores de bases de datos incluye Snowflake.
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: orgname-account_name. 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: orgname-account_name. 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: orgname-account_name. 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 utilizará el identificador de cuenta para autenticar su instancia de Snowflake en Experience Platform.
Para recuperar el identificador de la cuenta:
- Vaya a su cuenta en Snowflake panel de interfaz de usuario de la aplicación.
- En el panel de navegación izquierdo, seleccione Accounts, seguido de 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.
Recuperación de la clave privada retrieve-your-private-key
Si está usando autenticación de par clave para su conexión Snowflake, también debe generar la clave privada antes de conectarse a Experience Platform.
Para generar su clave privada Snowflake cifrada, ejecute el siguiente comando en el terminal:
| code language-shell |
|---|
|
Si lo consigue, debería recibir su clave privada en formato PEM.
| code language-shell |
|---|
|
Para generar la clave privada Snowflake sin cifrar, ejecute el siguiente comando en el terminal:
| code language-shell |
|---|
|
Si lo consigue, debería recibir su clave privada en formato PEM.
| code language-shell |
|---|
|
A continuación, tome su clave privada y códiquela en Base64. Asegúrese de no realizar ninguna transformación ni conversión de formato en la clave privada Snowflake. Además, debe asegurarse de que no haya caracteres de línea nueva al final de la clave privada antes de codificarla en Base64.
Comprobar configuraciones
Para poder crear una conexión de origen para los datos de Snowflake, también debe asegurarse de que se cumplan las siguientes configuraciones:
- El almacén predeterminado asignado a un usuario determinado debe ser el mismo que el almacén introducido al autenticarse en Experience Platform.
- La función predeterminada asignada a un usuario determinado debe tener acceso a la misma base de datos que especificó al autenticarse en Experience Platform.
Para verificar su rol y almacé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.
Una vez codificada correctamente, puede utilizar esa clave privada codificada con Base64 en Experience Platform para autenticar su cuenta de Snowflake.
La siguiente documentación proporciona información sobre cómo conectar Snowflake a Experience Platform mediante API o la interfaz de usuario: