La Advanced Klaviyo Data Platform no está incluida en la aplicación de marketing estándar de Klaviyo, y se requiere una subscripción para acceder a la funcionalidad correspondiente. Visita nuestra guía de facturación para saber cómo contratar este plan.

Configuración del entorno y conexión

Descripción general: Sigue estos pasos para preparar Databricks para Klaviyo. Crearás los esquemas necesarios (en un catálogo), configurarás una cuenta dedicada y un token de acceso para Klaviyo, asignarás los privilegios mínimos necesarios, verificarás la configuración y conectarás Databricks a Klaviyo.

Importante: La conexión Databricks actualmente solo admite la importación de datos a Klaviyo.

Ahora se puede importar el perfil.
La importación de eventos estará disponible próximamente.
La exportación a Databricks aún no está disponible. Hasta entonces, se recomienda exportar a S3.

Para obtener más información sobre cómo funciona Importación desde almacén de datos en Klaviyo, incluida la estructura del esquema, las tablas necesarias y las asignaciones de campos, consulta Cómo funciona Importación desde almacén de datos en Klaviyo .

1) Crea los esquemas necesarios.

En Databricks, los esquemas (a veces llamados bases de datos) se encuentran dentro de un catálogo. Puedes utilizar el catálogo principal predeterminado u otro catálogo si tu espacio de trabajo utiliza Unity Catalog.

USE CATALOG main;  -- o el catálogo designado por tu organización
CREATE SCHEMA IF NOT EXISTS KLAVIYO_IMPORT_FROM_DWH;
CREATE SCHEMA IF NOT EXISTS KLAVIYO_TMP;

KLAVIYO_IMPORT_FROM_DWH: Las tablas y vistas creadas en este esquema estarán disponibles para su selección al configurar una nueva sincronización.
KLAVIYO_TMP: datos temporales/de preparación utilizados durante la sincronización.

Nota: Si tu espacio de trabajo no utiliza Unity Catalog, Databricks trata «esquema» y «base de datos» como equivalentes. Puedes utilizar CREATE DATABASE en lugar de CREATE SCHEMA.

2) Crea la cuenta Klaviyo Service y el token de acceso.

Klaviyo se autentica en Databricks utilizando una cuenta dedicada con un token de acceso personal (PAT). Utiliza una cuenta no humana (de servicio) siempre que sea posible y guarda la PAT de forma segura (por ejemplo, en un administrador de contraseñas o un almacén secreto). Proporcionarás este token a Klaviyo durante la configuración inicial.

2.1 Crear la cuenta

Crea un usuario del espacio de trabajo de Databricks o un principal de servicio que Klaviyo utilizará exclusivamente para estas integraciones.

2.2 Generar el token de acceso personal

Cuenta de usuario del espacio de trabajo: genera el token a través de la interfaz de usuario web de Databricks (consulta la documentación de Databricks): Crear tokens de acceso personales para usuarios del espacio de trabajo.
Servicio principal: genera el token utilizando la CLI de Databricks (consulta la documentación de Databricks): Crea tokens de acceso personal a través de la CLI de Databricks.

Importante: Mantén la confidencialidad del PAT. Cualquier persona que tenga el token puede acceder a Databricks con los permisos de la cuenta asociada.

3) Asignar los permisos necesarios

Otorga a la cuenta de Klaviyo los siguientes privilegios sobre los esquemas creados en el paso 1. Reemplaza klaviyo_service_user por tu nombre de usuario real o nombre principal del servicio, y antepone a los esquemas el catálogo correcto (por ejemplo, main).

Esquema	Privilegios mínimos requeridos	Objetivo
`KLAVIYO_TMP`	`TODOS LOS PRIVILEGIOS` o la combinación de `USE SCHEMA`, `MODIFY`, `SELECT` y `CREATE TABLE`.	Permite a Klaviyo crear y administrar tablas temporales durante la sincronización.
`KLAVIYO_IMPORTAR_DESDE_DWH`	`USAR ESQUEMA`, `SELECCIONAR`	Permite a Klaviyo leer tus tablas y vistas.

-- Otorga permisos en el esquema temporal
GRANT ALL PRIVILEGES ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- O bien, otorga privilegios granulares:
GRANT USE SCHEMA, MODIFY, SELECT, CREATE TABLE ON SCHEMA main.KLAVIYO_TMP A `klaviyo_service_user`;

-- Otorga acceso de solo lectura para importar el esquema
GRANT USE SCHEMA, SELECT ON SCHEMA main.KLAVIYO_IMPORT_FROM_DWH TO `klaviyo_service_user`;

Mejor práctica: aplica el principio del privilegio mínimo: concede solo lo que sea necesario.

4) Verifica tu configuración (opcional)

4.1 Confirmar que los esquemas existen

Ejecuta en un cuaderno o editor de SQL de Databricks:

MUESTRA ESQUEMAS EN main;  -- reemplaza «main» por tu catálogo si es diferente

Deberías ver:

klaviyo_import_from_dwh
klaviyo_tmp

4.2 Prueba de autenticación (utilizando tu PAT)

Utiliza la CLI de Databricks con el mismo token que piensas proporcionar a Klaviyo:

Configura tu token y host (ejemplo para AWS)
export<your-workspace> DATABRICKS_HOST="https://.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" 

 # Ejecuta una llamada simple a la interfaz de programación de aplicaciones (API)
databricks usuario-actual tú

Resultado esperado: salida JSON que muestra los detalles del usuario o del principal de servicio (por ejemplo, nombre para mostrar, ID de usuario). Si recibes un error HTTP 403 o de autenticación, verifica el token y la URL del host.

4.3 Verificar los permisos en cada esquema

MOSTRAR SUBVENCIONES EN ESQUEMA main.klaviyo_tmp;
MOSTRAR SUBVENCIONES EN ESQUEMA main.klaviyo_import_from_dwh;

Confirma que tu cuenta de Klaviyo aparece con los privilegios esperados (por ejemplo, USE SCHEMA, SELECT, MODIFY, CREATE TABLE).

4.4 Validar operaciones de creación/lectura

-- Prueba de creación/eliminación en KLAVIYO_TMP
USE SCHEMA main.klaviyo_tmp;
CREATE TABLE IF NOT EXISTS test_permissions (id INT);
DROP TABLE test_permissions;

-- Prueba select en KLAVIYO_IMPORT_FROM_DWH
USE SCHEMA main.klaviyo_import_from_dwh;
MOSTRAR TABLAS;

Consejos:

Sigue estos pasos de verificación utilizando la misma identidad y PAT que compartirás con Klaviyo.
Conserva las declaraciones de concesión SQL y los resultados de la verificación para fines de auditoría o resolución de problemas.
Rota el PAT con una cadencia regular y después de los cambios de personal.

5) Conecta Klaviyo a Databricks

Una vez configurado Databricks, completa la conexión en Klaviyo.

En Klaviyo, abre la barra lateral izquierda y ve a Avanzado > Sincronización.
Haz clic en Crear sincronización.
Selecciona Importar datos desde tu almacén de datos.
Elige Databricks como tu almacén de datos.
Haz clic en Conectar a Databricks.

Cuando se te solicite, proporciona los siguientes datos de conexión:

Campo	Descripción	Dónde encontrarlo
Nombre de host	El host indicado en la URL de tu espacio de trabajo de Databricks.	Se encuentra en la barra de direcciones de tu navegador cuando inicias sesión en Databricks: `https://.cloud.databricks.com<your-workspace>` Ejemplo: `abc-12345678.cloud.databricks.com`
Ruta HTTP	La ruta HTTP del almacén SQL que se utilizará para las consultas.	En la interfaz de usuario de Databricks: Ve a Almacenes SQL. Selecciona el almacén que deseas utilizar. Copia la ruta HTTP que aparece en los detalles de conexión. Ejemplo: `/sql/1.0/almacenes/1234abcd5678efgh`
Catálogo	El catálogo que contiene tus esquemas de Klaviyo (por ejemplo, `principal`).	Verifica utilizando: CATÁLOGOS DE EXPOSICIONES;
Token de acceso	El token de acceso personal (PAT) que creaste en el paso 2.	Guarda y pega el token de forma segura durante la configuración.

Después de conectarte: Klaviyo comprobará la conexión y confirmará el acceso a tu entorno Databricks. Una vez verificado, puedes configurar sincronizaciones para importar datos desde los esquemas que preparaste anteriormente.

Siguiente paso: una vez establecida la conexión, procede a crear tu primera sincronización en Klaviyo y comienza a importar datos desde Databricks.

Conectando Klaviyo y Databricks