Transmitir datos de su base de datos Snowflake a Experience Platform mediante la interfaz de usuario
Lea esta guía para obtener información sobre cómo transmitir datos desde la base de datos de Snowflake a Experience Platform mediante el área de trabajo de orígenes en la interfaz de usuario.
Introducción
Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:
-
Experience Data Model (XDM) Sistema: El marco de trabajo estandarizado mediante el cual Experience Platform organiza los datos de la experiencia del cliente.
- Aspectos básicos de la composición de esquemas: obtenga información sobre los componentes básicos de los esquemas XDM, incluidos los principios clave y las prácticas recomendadas en la composición de esquemas.
- Tutorial del editor de esquemas: Aprenda a crear esquemas personalizados mediante la interfaz de usuario del editor de esquemas.
-
Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
Autenticación
Lea la guía sobre la configuración de requisitos previos para Snowflake datos de streaming para obtener información sobre los pasos que debe completar antes de poder ingerir datos de streaming de Snowflake a Experience Platform.
Usar el origen Snowflake Streaming para transmitir datos de Snowflake a Experience Platform
En la interfaz de usuario de Experience Platform, seleccione Fuentes en el panel de navegación izquierdo para acceder al área de trabajo Fuentes. 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 la categoría Bases de datos, seleccione Snowflake Streaming y, a continuación, seleccione Configurar.
Aparecerá la página Conectar cuenta de streaming de Snowflake. En esta página, puede usar credenciales nuevas o existentes.
Crear una nueva cuenta
Para crear una cuenta nueva, selecciona Cuenta nueva y proporciona un nombre y una descripción opcional para tu cuenta.
Para usar Autenticación básica, seleccione Autenticación básica para Snowflake y proporcione las credenciales de su cuenta de Snowflake. Cuando termine, seleccione Conectarse al origen y espere unos momentos para que se establezca la conexión.
Lea la información general de Snowflake Streaming para obtener más información sobre recopilar las credenciales necesarias.
Para usar la autenticación KeyPair, selecciona Autenticación KeyPair para Snowflake y proporciona las credenciales de tu cuenta de Snowflake. Cuando termine, seleccione Conectarse al origen y espere unos momentos para que se establezca la conexión.
Lea la información general de Snowflake Streaming para obtener más información sobre recopilar las credenciales necesarias.
Para usar una cuenta existente, elige Cuenta existente, selecciona tu cuenta de la lista y selecciona Siguiente.
Seleccionar datos select-data
-
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 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.
-
Asegúrese de que las mayúsculas y minúsculas de los campos de datos del archivo de datos de origen de ejemplo cumplan las directrices de Snowflake sobre la resolución de mayúsculas y minúsculas para los identificadores. Lea el Snowflake documento sobre el uso de mayúsculas y minúsculas en el identificador para obtener más información.
Aparecerá el paso Seleccionar datos. 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 que encontrará a la izquierda de la pantalla y seleccione la tabla que desea importar a Experience Platform.
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
, 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 la opción Relleno para habilitar el relleno.
Finalmente, seleccione Elegir archivo para cargar un origen de datos de ejemplo para ayudar a 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.
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 a 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.
Si tiene un conjunto de datos existente, seleccione Conjunto de datos existente y, a continuación, utilice la opción Búsqueda avanzada para ver una ventana de todos los conjuntos de datos de su organización, incluidos sus detalles respectivos, como si están habilitados para la ingesta en el Perfil del cliente en tiempo real.
Para usar un nuevo conjunto de datos, seleccione Nuevo conjunto de datos y, a continuación, proporcione un nombre y una descripción opcional para su conjunto de datos. También debe seleccionar un esquema del Modelo de datos de experiencia (XDM) al que se adhiera el conjunto de datos.
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.
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 descripción general de las alertas
- Inicio de ejecución del flujo de datos de origen: 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 origen: seleccione esta alerta para recibir una notificación si el flujo de datos termina sin errores.
- Error al ejecutar el flujo de datos de origen: 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
Aparecerá el paso Mapping. Use la interfaz de asignación para asignar los datos de origen a los campos de esquema adecuados antes de ingerir esos datos en Experience Platform y, a continuación, seleccione Siguiente. Para obtener una guía detallada sobre cómo usar la interfaz de asignación, lee la guía de la interfaz de usuario de la preparación de datos para obtener más información.
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. Use el paso Revisar 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 de acceso 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 que haya revisado el flujo de datos, seleccione Finalizar y espere un poco para que se cree el flujo de datos.
Próximos pasos
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 supervisar los flujos de datos de flujo continuo, visite el tutorial sobre supervisión de flujos de datos de flujo continuo en la interfaz de usuario.
Actualizar el flujo de datos
Para actualizar configuraciones para la programación, asignación e información general de los flujos de datos, visite el tutorial sobre actualización de flujos de datos de origen en la interfaz de usuario.
Eliminar el flujo de datos
Puede eliminar flujos de datos que ya no sean necesarios o que se hayan creado incorrectamente mediante la función Delete disponible en el área de trabajo Flujos de datos. Para obtener más información sobre cómo eliminar flujos de datos, visite el tutorial sobre eliminar flujos de datos en la interfaz de usuario.