Configuración y conexión del entorno

Resumen: sigue estos pasos para preparar los bloques de datos 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: Actualmente, la conexión de Databricks solo permite importar datos a Klaviyo.

• Los perfiles ya se pueden importar.
• La importación de eventos estará disponible pronto.
• 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 funcionan las Importaciones de almacén de datos en Klaviyo, incluida la estructura del esquema, las tablas obligatorias y las asignaciones de campos, consulta Cómo funcionan las Importaciones de almacén de datos en Klaviyo.

1) Crear esquemas obligatorios

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

UTILIZA CATALOG main; -- o el catálogo designado de tu empresa CREAR ESQUEMA SI NO EXISTE KLAVIYO_IMPORT_FROM_DWH; CREAR ESQUEMA SI NO EXISTE 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 almacenamiento provisional utilizados durante la sincronización.

Nota: Si tu espacio de trabajo no usa Unity Catalog, Databricks trata "schema" y "database" como equivalentes. Puedes usar CREATE DATABASE en lugar de CREATE SCHEMA.

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

Klaviyo se autentica en Databricks mediante una cuenta dedicada con un token de acceso personal (PAT). Usa una cuenta no humana (de servicio) cuando sea posible y almacena la PAT de forma segura (por ejemplo, un gestor de contraseñas o una tienda secreta). Proporcionarás este token a Klaviyo durante la configuración inicial.

2.1 Crea la cuenta

Crea un usuario del espacio de trabajo de Databricks o una entidad de servicio que Klaviyo utilizará exclusivamente para esta integración.

2.2 Genera el token de acceso personal

• Cuenta de usuario del espacio de trabajo: Genera el token a través de la interfaz web de Databricks (consulta los documentos de Databricks): Crea tokens de acceso personal para los usuarios del espacio de trabajo
• Responsable de servicio: genera el token con la CLI de Databricks (consulta los documentos de Databricks): crea tokens de acceso personal a través de la CLI de Databricks

Importante: Trátalo como un secreto. Cualquier persona que tenga el token puede acceder a los bloques de datos con los permisos de la cuenta asociada.

3) Asigna los permisos requeridos

Concede a la cuenta de Klaviyo los siguientes privilegios en los esquemas creados en el paso 1. Sustituye klaviyo_service_user por tu nombre de usuario o principal de servicio reales, y prefija los esquemas por el catálogo correcto (por ejemplo, el principal).

-- Conceder permisos en el esquema temporal CONCEDER TODOS LOS PRIVILEGIOS EN EL ESQUEMA principal.KLAVIYO_TMP A "klaviyo_service_user"; -- O, conceder privilegios detallados: CONCEDER USO DEL ESQUEMA, MODIFICAR, SELECCIONAR, CREAR TABLA EN EL ESQUEMA principal.KLAVIYO_TMP A "klaviyo_service_user"; -- Conceder acceso de solo lectura para importar el esquema CONCEDER USO DEL ESQUEMA, SELECCIONAR EN EL ESQUEMA principal.KLAVIYO_IMPORT_FROM_DWH A "klaviyo_service_user";

Práctica recomendada: aplicar el principio de mínimo privilegio: conceder solo lo que se requiera.

4) Verifica Tu Configuración (Opcional)

4.1 Confirma que los esquemas existan

Ejecutar en un cuaderno o editor de SQL Databricks:

MOSTRAR ESQUEMAS EN main; -- sustituye "main" por tu catálogo si es diferente

Deberías ver:

Klaviyo Import DWH desde Klaviyo TMP

4.2 Prueba la autenticación (usando tus PAT)

Usa la CLI de Databricks con el mismo token que tienes previsto proporcionar a Klaviyo:

# Configura tu token y el host (ejemplo para AWS) export DATABRICKS_HOST="https://<your-workspace>.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" # Ejecuta una simple llamada a API databricks current-user-me

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

4.3 Comprueba los permisos de cada esquema

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

Confirma que tu cuenta de Klaviyo aparezca con los privilegios esperados (por ejemplo, USAR ESQUEMA, SELECCIONAR, MODIFICAR, CREAR TABLA).

4.4 Validar operaciones de creación/lectura

-- Prueba create/drop en KLAVIYO_TMP USE SCHEMA main.klaviyo_tmp;
CREAR TABLA SI NO EXISTE test_permissions (id INT); ELIMINAR TABLA test_permissions; -- Seleccionar prueba en KLAVIYO_IMPORT_FROM_DWH USAR ESQUEMA main.klaviyo_import_from_dwh;
MOSTRAR TABLAS;

Consejos:

• Sigue estos pasos de verificación con la misma identidad y PAT que compartirás con Klaviyo.
• Conserva las declaraciones de concesión de SQL y el resultado de la verificación para la auditoría/solución de problemas.
• Gira el PAT con una cadencia regular y después de los cambios de personal.

5) Conecta Klaviyo a Databricks

Una vez configurados los bloques de datos, completa la conexión en Klaviyo.

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

Cuando se te pida, proporciona los siguientes detalles de conexión:

MOSTRAR CATÁLOGOS;

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

Siguiente paso: después de conectarte correctamente, crea tu primera sincronización en Klaviyo y empieza a importar datos de Databricks.