[Ultimate]{class="badge positive"}

Transmita datos desde su Snowflake de la base de datos al Experience Platform mediante la IU

Aprenda a utilizar la interfaz de usuario de para transmitir datos desde su Snowflake a Adobe Experience Platform siguiendo esta guía.

Introducción

Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Autenticación

Lea la guía de configuración de requisitos previos para Snowflake transmisión de datos para obtener información sobre los pasos que debe seguir antes de poder ingerir datos de flujo continuo desde Snowflake al Experience Platform.

Utilice el Snowflake Streaming origen a flujo Snowflake datos para el Experience Platform

En la IU de Platform, seleccione Fuentes desde la navegación izquierda para acceder a Fuentes workspace. Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.

En el Bases de datos categoría, seleccionar Snowflake Streaming, y luego seleccione Añadir datos.

TIP
Las fuentes que no tienen una cuenta autenticada en el catálogo de fuentes muestran el Configuración de opción. Una vez que existe una cuenta autenticada, esta opción cambia a Añadir datos.

El catálogo de fuentes en la interfaz de usuario de Experience Platform, con la tarjeta de fuente de flujo de Snowflake seleccionada.

El Conectar la cuenta de flujo de Snowflake página. En esta página, puede usar credenciales nuevas o existentes.

Crear una nueva cuenta

Para crear una nueva cuenta, seleccione Nueva cuenta y proporcione un nombre, una descripción opcional y sus credenciales.

Cuando termine, seleccione Conectar con el origen y, a continuación, espere un poco para que se establezca la nueva conexión.

La nueva interfaz de creación de cuentas del flujo de trabajo de orígenes.

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
Cuenta El nombre de su Snowflake cuenta.
Almacén El nombre de su Snowflake almacén. Los almacenes administran la ejecución de consultas en Snowflake. Cada Snowflake el almacén es independiente entre sí y se debe acceder a él individualmente para llevar los datos al Experience Platform.
Base de datos El nombre de su Snowflake base de datos. La base de datos contiene los datos que desea llevar al Experience Platform.
Esquema (Opcional) El esquema de base de datos asociado con su Snowflake cuenta.
Nombre de usuario El nombre de usuario de su Snowflake cuenta.
Una contraseña La contraseña de su Snowflake cuenta.
Función (Opcional) Una función personalizada que se puede proporcionar a un usuario para una conexión determinada. Si no se proporciona, el valor predeterminado es public.

Para obtener más información sobre la creación de cuentas, lea la sección sobre configurar opciones de rol en el Snowflake Streaming información general.

Usar una cuenta existente

Para usar una cuenta existente, seleccione Cuenta existente y, a continuación, seleccione la cuenta que desee en el catálogo de cuentas existente.

Seleccione Siguiente para continuar.

La página de selección de cuentas existente del catálogo de fuentes.

Seleccionar datos select-data

IMPORTANT
Debe existir una columna de marca de tiempo en la tabla de origen para poder crear un flujo de datos de flujo continuo. La marca de tiempo es necesaria para que el Experience Platform sepa cuándo se incorporarán los datos y cuándo se transmitirán los datos incrementales. Puede agregar de forma retroactiva una columna de marca de tiempo para una conexión existente y crear un nuevo flujo de datos.

El Seleccionar datos aparece el paso. En este paso, debe seleccionar los datos que desea importar en Experience Platform, configurar las marcas de tiempo y las zonas horarias, y proporcionar un archivo de datos de origen de muestra para la ingesta de datos sin procesar.

Utilice el directorio de base de datos de la izquierda de la pantalla y seleccione la tabla que desea importar al Experience Platform.

Interfaz de selección de datos con una tabla de base de datos seleccionada.

A continuación, seleccione el tipo de columna de marca de tiempo de la tabla. Puede seleccionar entre dos tipos de columnas de marca de tiempo: TIMESTAMP_NTZ o TIMESTAMP_LTZ. Si selecciona un tipo de columna de TIMESTAMP_NTZ, entonces también debe proporcionar una zona horaria. Las columnas no deben tener una restricción nula. Para obtener más información, lea la sección sobre [limitaciones y preguntas más frecuentes]

También puede configurar las opciones de relleno durante este paso. El relleno determina qué datos se incorporan inicialmente. Si el relleno está habilitado, todos los archivos actuales de la ruta especificada se introducirán durante la primera ingesta programada. Si no es así, solo se incorporarán los archivos que se carguen entre la primera ejecución de la ingesta y la hora de inicio. Los archivos cargados antes de la hora de inicio no se incorporarán.

Seleccione el Relleno para habilitar el relleno.

Los pasos de configuración marca de tiempo, zona horaria y relleno.

Finalmente, seleccione Elegir archivo para cargar datos de origen de ejemplo para crear el conjunto de asignaciones, que se utilizará en un paso posterior para asignar los datos originales al modelo de datos de experiencia (XDM).

Cuando termine, seleccione Siguiente para continuar.

Vista previa de los datos de ejemplo de origen.

Proporcionar detalles del conjunto de datos y flujo de datos provide-dataset-and-dataflow-details

A continuación, debe proporcionar información sobre el conjunto de datos y el flujo de datos.

Detalles del conjunto de datos dataset-details

Un conjunto de datos es una construcción de almacenamiento y administración para una colección de datos, normalmente una tabla, que contiene un esquema (columnas) y campos (filas). Los datos que se incorporan correctamente al Experience Platform se conservan dentro del lago de datos como conjuntos de datos. Durante este paso, puede crear un nuevo conjunto de datos o utilizar uno existente.

Usar un nuevo conjunto de datos

Para utilizar un nuevo conjunto de datos, seleccione Nuevo conjunto de datos A continuación, proporcione un nombre y una descripción opcional para el conjunto de datos. También debe seleccionar un esquema del Modelo de datos de experiencia (XDM) al que se adhiera el conjunto de datos.

La nueva interfaz de selección de conjuntos de datos.

table 0-row-2 1-row-2 2-row-2 3-row-2
Nuevos detalles del conjunto de datos Descripción
Nombre del conjunto de datos de salida Nombre del nuevo conjunto de datos.
Descripción (Opcional) Una breve descripción general del nuevo conjunto de datos.
Esquema Una lista desplegable de esquemas que existen en su organización. También puede crear su propio esquema antes del proceso de configuración de origen. Para obtener más información, lea la guía de creación de un esquema XDM en la IU.
Usar un conjunto de datos existente

Si ya tiene un conjunto de datos, seleccione Conjunto de datos existente y, a continuación, utilice el Búsqueda avanzada para ver una ventana de todos los conjuntos de datos de su organización, incluidos sus respectivos detalles, como si están habilitados para su inserción en el Perfil del cliente en tiempo real.

Interfaz de selección de conjuntos de datos existente.

Seleccione esta opción para habilitar la Ingesta de perfiles, los diagnósticos de error y la ingesta parcial.

Si el conjunto de datos está habilitado para Perfil del cliente en tiempo real, durante este paso, puede alternar Conjunto de datos de perfil para habilitar los datos para la ingesta de perfiles. También puede utilizar este paso para habilitar Diagnósticos de error y Ingesta parcial.

  • Diagnósticos de error: Seleccionar Diagnósticos de error para indicar a la fuente que produzca diagnósticos de error a los que pueda hacer referencia posteriormente al monitorizar la actividad del conjunto de datos y el estado del flujo de datos.
  • Ingesta parcial: la ingesta parcial por lotes es la capacidad de ingerir datos que contengan errores, hasta un determinado umbral configurable. Esta función le permite introducir correctamente todos los datos precisos en Experience Platform, mientras que todos los datos incorrectos se agrupan por separado con información sobre los motivos por los que no son válidos.

Detalles del flujo de datos dataflow-details

Una vez configurado el conjunto de datos, debe proporcionar detalles sobre el flujo de datos, incluido un nombre, una descripción opcional y configuraciones de alerta.

El paso de configuración de detalles del flujo de datos.

Configuraciones de flujo de datos
Descripción
Nombre de flujo de datos
Nombre del flujo de datos. De forma predeterminada, se utiliza el nombre del archivo que se está importando.
Descripción
(Opcional) Una breve descripción del flujo de datos.
Alertas

El Experience Platform puede generar alertas basadas en eventos a las que los usuarios pueden suscribirse. Estas opciones requieren un flujo de datos en ejecución para almacenarlas en déclencheur. Para obtener más información, lea la información general sobre alertas

  • Inicio de ejecución de flujo de datos: seleccione esta alerta para recibir una notificación cuando comience la ejecución del flujo de datos.
  • Ejecución correcta del flujo de datos de orígenes: seleccione esta alerta para recibir una notificación si el flujo de datos termina sin errores.
  • Error al ejecutar flujo de datos de fuentes: seleccione esta alerta para recibir una notificación si la ejecución del flujo de datos termina con errores.

Cuando termine, seleccione Siguiente para continuar.

Asignación de campos a un esquema XDM mapping

El Asignación aparece el paso. Utilice la interfaz de asignación para asignar los datos de origen a los campos de esquema adecuados antes de introducir esos datos en Experience Platform y, a continuación, seleccione Siguiente. Para obtener una guía detallada sobre cómo utilizar la interfaz de asignación, lea la Guía de IU de preparación de datos para obtener más información.

Interfaz de asignación del flujo de trabajo de orígenes.

Revisión del flujo de datos review

El paso final del proceso de creación del flujo de datos es revisar el flujo de datos antes de ejecutarlo. Utilice el Revisar paso para revisar los detalles del nuevo flujo de datos antes de que se ejecute. Los detalles se agrupan en las siguientes categorías:

  • Conexión: Muestra el tipo de origen, la ruta relevante del archivo de origen elegido y el número de columnas dentro de ese archivo de origen.
  • Asignar campos de conjunto de datos y asignación: Muestra en qué conjunto de datos se están ingiriendo los datos de origen, incluido el esquema al que se adhiere el conjunto de datos.

Una vez revisado el flujo de datos, seleccione Finalizar y deje pasar un tiempo para crear el flujo de datos.

El paso Revisar del flujo de trabajo de orígenes.

Pasos siguientes

Al seguir este tutorial, ha creado correctamente un flujo de datos de flujo continuo para Snowflake datos. Para obtener recursos adicionales, lea la documentación siguiente.

Monitorización del flujo de datos

Una vez creado el flujo de datos, puede monitorizar los datos que se están ingiriendo a través de él para ver información sobre las tasas de ingesta, el éxito y los errores. Para obtener más información sobre cómo monitorizar los flujos de datos de flujo continuo, visite el tutorial sobre monitorización de flujos de datos de streaming en la IU.

Actualizar el flujo de datos

Para actualizar las configuraciones de la programación, la asignación y la información general de los flujos de datos, visite el tutorial sobre actualización de flujos de datos de origen en la IU.

Eliminar el flujo de datos

Puede eliminar los flujos de datos que ya no son necesarios o que se crearon incorrectamente utilizando Eliminar función disponible en el Flujos de datos workspace. Para obtener más información sobre cómo eliminar flujos de datos, visite el tutorial sobre eliminación de flujos de datos en la IU.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089