Configuração e conexão do ambiente

Visão geral: Siga estas etapas para preparar o Databricks para o Klaviyo. Você criará os esquemas necessários (em um catálogo), configurará uma conta dedicada e um token de acesso para o Klaviyo, atribuirá os privilégios mínimos necessários, verificará a configuração e conectará o Databricks ao Klaviyo.

Importante: no momento, a conexão com a Databricks suporta apenas a importação de dados para o Klaviyo.

• O perfil pode ser importado agora.
• A importação de eventos será feita em breve.
• A exportação para o Databricks ainda não está disponível. Até lá, recomenda-se que você exporte para o S3.

Para obter detalhes sobre como a importação do Data Warehouse funciona em Klaviyo- incluindo a estrutura do esquema, as tabelas necessárias e os mapeamentos de campo -, consulte Como funciona a importação do Data Warehouse em Klaviyo .

1) Criar esquemas necessários

No Databricks, os esquemas (às vezes chamados de bancos de dados) ficam dentro de um catálogo. Você pode usar o catálogo principal padrão ou outro catálogo se seu espaço de trabalho usar o Unity Catalog.

USE CATALOG main; -- ou o catálogo designado pela sua organização
CREATE SCHEMA IF NOT EXISTS KLAVIYO_IMPORT_FROM_DWH;
CREATE SCHEMA IF NOT EXISTS KLAVIYO_TMP;

• KLAVIYO_IMPORT_FROM_DWH: as tabelas e exibições criadas nesse esquema estarão disponíveis para seleção quando você configurar uma nova sincronização.
• KLAVIYO_TMP: dados temporários/de preparação usados durante a sincronização.

Observação: se o seu espaço de trabalho não usar o Unity Catalog, o Databricks tratará "schema" e "database" como equivalentes. Você pode usar CREATE DATABASE em vez de CREATE SCHEMA.

2) Crie a conta Klaviyo Service e o token de acesso

O Klaviyo faz a autenticação na Databricks usando uma conta dedicada com um token de acesso pessoal (PAT). Use uma conta não humana (de serviço) sempre que possível e armazene a PAT de forma segura (por exemplo, um gerenciador de senhas ou um armazenamento secreto). Você fornecerá esse token ao Klaviyo durante a configuração inicial.

2.1 Criar a conta

Crie um usuário do espaço de trabalho do Databricks ou uma entidade de serviço que o Klaviyo usará exclusivamente para essas integrações.

2.2 Gerar o token de acesso pessoal

• Conta de usuário do Workspace: Gerar o token por meio da interface do usuário da Web do Databricks (consulte os documentos do Databricks): Criar tokens de acesso pessoal para usuários do espaço de trabalho
• Principal de serviço: gere o token usando a CLI da Databricks (consulte os documentos da Databricks): Criar tokens de acesso pessoal por meio da CLI da Databricks

Importante: Trate o PAT como um segredo. Qualquer pessoa com o token pode acessar o Databricks com as permissões da conta associada.

3) Atribua as permissões necessárias

Conceda à conta do Klaviyo os seguintes privilégios nos esquemas criados na Etapa 1. Substitua klaviyo_service_user pelo seu nome de usuário real ou nome principal do serviço e prefixe os esquemas com o catálogo correto (por exemplo, main).

-- Conceder permissões no esquema temporário
GRANT ALL PRIVILEGES ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- OU, conceder privilégios granulares:
GRANT USE SCHEMA, MODIFY, SELECT, CREATE TABLE ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- Concede acesso somente leitura ao esquema de importação
GRANT USE SCHEMA, SELECT ON SCHEMA main.KLAVIYO_IMPORT_FROM_DWH TO `klaviyo_service_user`;

Prática recomendada: Aplique o princípio do menor privilégio - conceda apenas o que for necessário.

4) Verifique sua configuração (opcional)

4.1 Confirmar a existência dos esquemas

Execute em um notebook ou editor SQL da Databricks:

SHOW SCHEMAS IN main; -- substitua 'main' pelo seu catálogo, se for diferente

Você deveria ver:

klaviyo_import_from_dwh
klaviyo_tmp

4.2 Teste a autenticação (usando seu PAT)

Use a CLI da Databricks com o mesmo token que você planeja fornecer à Klaviyo:

# Defina seu token e host (exemplo para AWS)
export DATABRICKS_HOST="https://<your-workspace>.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" 

 # Execute uma chamada de API simples
databricks current-user me

Resultado esperado: Saída JSON mostrando os detalhes do usuário ou da entidade de serviço (por exemplo, nome de exibição, ID do usuário). Se você receber um erro HTTP 403 ou de autenticação, verifique o token e o URL do host.

4.3 Verificar as permissões em cada esquema

Mostrar concessões no esquema main.klaviyo_tmp;
MOSTRAR SUBSÍDIOS NO ESQUEMA main.klaviyo_import_from_dwh;

Confirme se sua conta do Klaviyo aparece com os privilégios esperados (por exemplo, USE SCHEMA, SELECT, MODIFY, CREATE TABLE).

4.4 Validar operações de criação/leitura

-- Teste a criação/colocação no KLAVIYO_TMP
USE SCHEMA main.klaviyo_tmp;
CREATE TABLE IF NOT EXISTS test_permissions (id INT);
DROP TABLE test_permissions;

-- Seleção de teste em KLAVIYO_IMPORT_FROM_DWH
USE SCHEMA main.klaviyo_import_from_dwh;
MOSTRAR TABELAS;

Dicas:

• Execute essas etapas de verificação usando a mesma identidade e PAT que você compartilhará com a Klaviyo.
• Guarde os comandos de concessão SQL e a saída de verificação para auditoria/solução de problemas.
• Faça a rotação do PAT em uma cadência regular e após as mudanças de equipe.

5) Conectar o Klaviyo ao Databricks

Depois que o Databricks estiver configurado, conclua a conexão no Klaviyo.

1. No Klaviyo, abra a barra lateral esquerda e navegue até Advanced > Syncing.
2. Clique em Criar sincronização.
3. Selecione Importar dados do seu data warehouse.
4. Escolha a Databricks como seu data warehouse.
5. Clique em Conectar ao Databricks.

Quando solicitado, forneça os seguintes detalhes de conexão:

MOSTRAR CATÁLOGOS;

Depois que você se conectar: A Klaviyo testará a conexão e confirmará o acesso ao seu ambiente Databricks. Após a verificação, você pode configurar as sincronizações para importar dados dos esquemas que preparou anteriormente.

Próxima etapa: Depois de se conectar com sucesso, crie sua primeira sincronização no Klaviyo e comece a importar dados do Databricks.