Skip to main content
Las integraciones con data warehouses están disponibles como complemento premium para el módulo Web Experimentation y Feature Experimentation de Kameleoon. Para obtener más información, póngase en contacto con su Customer Success Manager.
Los pasos 1 a 3 se realizan en su cuenta de Databricks, y el paso 4 se realiza en Kameleoon. Kameleoon recomienda que su administrador de Databricks realice los pasos 1 a 3. Con la integración de Databricks, puede simplificar la recuperación de datos para campañas segmentadas y experiencias de usuario personalizadas. Ventajas clave:
  • Permite segmentar visitantes con audiencias creadas a partir de sus tablas de Databricks.
  • Permite usar las conversiones de Databricks como métricas de objetivo en los resultados de los experimentos.
Frecuencia de sincronización:
  • Databricks as a source: cada Data Ingestion Task se ejecuta con la Frequency que establece al crearla, por ejemplo, una vez al día. Kameleoon consulta cada hora los objetivos basados en consultas y combina las conversiones recopiladas con los resultados de los experimentos una vez al día. Consulte Data Ingestion Tasks.
  • Databricks as a destination: Kameleoon envía eventos de exposición a Databricks cada vez que uno de sus experimentos expone a un visitante. Consulte Utilizar Databricks como destino.

Requisitos previos

Para configurar esta integración, necesita la siguiente información:
  • Personal access token (PAT) de Databricks
  • Acceso adecuado para crear esquemas de Databricks y conceder acceso a ellos.

Configuración

1. Crear un personal access token (PAT)

Kameleoon se autenticará en su SQL warehouse de Databricks con un personal access token. Debe crear un service principal de Databricks y, a continuación, crear un PAT para esa cuenta de servicio. Una vez que haya creado un service principal, puede generar un PAT con la CLI de Databricks, utilizando el “Application Id” del service principal que encontrará en la página de gestión de service principals de la interfaz de usuario de Databricks.
Cree el token en su workspace de Databricks y, después, introdúzcalo en Kameleoon. Para ver el procedimiento completo, consulte la documentación de Databricks sobre personal access tokens.

2. Crear esquemas de Kameleoon y conceder acceso a Unity Catalog

Para el origen y el destino, conceda al service principal el permiso CAN USE sobre el SQL warehouse de Databricks en su configuración de Permissions. Para Unity Catalog, conceda acceso a cada catálogo que utilice Kameleoon:
Su administrador de Databricks crea los esquemas siguientes. El service principal de Kameleoon no necesita CREATE SCHEMA en el catálogo.
Cuando se utiliza Databricks como fuente
Para la ingesta de audiencias, cree un esquema dedicado en el catálogo que contiene los datos que Kameleoon consulta. Asígnele el nombre kameleoon_configuration. Kameleoon crea, lee y elimina en este esquema las tablas de instantáneas de audiencias. Conceda al service principal acceso solo a este esquema. No necesita permisos de escritura sobre sus tablas de origen.
When using Databricks as a destination: cree un esquema independiente para las tablas de eventos de Kameleoon. Kameleoon crea tablas e inserta eventos en ellas. MODIFY también requiere SELECT sobre las tablas.
El service principal es propietario de las tablas que crea, así que no necesita otros permisos sobre ellas. Si las tablas de eventos ya existen con otro propietario, conceda SELECT y MODIFY sobre esas tablas. Los siguientes permisos a nivel de esquema también cubren las tablas de eventos actuales y futuras de este esquema dedicado:
Sustituya {Service Principal Application Id} en estos comandos por el application ID de su service principal.
Puede omitir el prefijo my_catalog cuando ejecute consultas directamente en el catálogo necesario.

3. Conceder acceso de lectura a sus datos

Para Databricks como fuente, conceda acceso solo a las tablas o vistas que utilicen sus consultas de audiencias y de objetivos. Primero, conceda acceso al esquema:
Después, conceda SELECT sobre cada tabla o vista necesaria. Como alternativa, puede concederlo sobre el esquema si Kameleoon debe leer todas las tablas y vistas actuales y futuras de ese esquema:
Para una vista, utilice:
El destino no necesita SELECT ni MODIFY sobre el esquema de datos de sus clientes. Si utiliza objetivos sin ingesta de audiencias, Kameleoon solo lee los resultados de sus consultas y no crea instantáneas de audiencias.

4. Introducir sus credenciales en Kameleoon

En la configuración de la integración de Databricks de su proyecto en Kameleoon, complete los campos de Credentials:
  • Databricks Server Hostname: el nombre de host del servidor de su workspace de Databricks.
  • HTTP Path: la ruta a su SQL warehouse de Databricks.
  • Personal Access Token (PAT): el token que creó en el paso 1.
  • PAT expiry timestamp in milliseconds (optional): la hora de caducidad del token, expresada como marca de tiempo Unix en milisegundos. Este campo es opcional, y el valor lo introduce usted.
Formulario de edición de las credenciales de Databricks, con campos para el nombre de host del servidor, la ruta HTTP, el personal access token (vacío) y la marca de tiempo opcional de caducidad del PAT en milisegundos.
Para reemplazar un token, introduzca el nuevo token en el campo Personal Access Token (PAT) y haga clic en Confirm. Después de guardar, Kameleoon muestra las credenciales en una tarjeta de resumen. La tarjeta muestra el nombre de host, la ruta HTTP y la caducidad del PAT, pero no el token.
Tarjeta con las credenciales de Databricks guardadas, que muestra el nombre de host del servidor, la ruta HTTP y la marca de tiempo de caducidad del PAT, con iconos de edición y eliminación.
Después de guardar las credenciales, puede enviar eventos de exposición de experimentos a Databricks. Consulte Utilizar Databricks como destino.

Red y seguridad

Kameleoon se autentica en Databricks con un personal access token. Kameleoon admite listas de permitidos de IP. Si implementa listas de acceso de IP, póngase en contacto con su account manager de Kameleoon para que pueda proporcionarle la lista de IP de Kameleoon que debe autorizar.

Región de datos

Kameleoon almacena los datos de esta integración en la región de datos de su cuenta, que puede ser EE. UU. o la UE.