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).

-- 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.

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

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

CATÁLOGOS DE EXPOSICIONES;

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.