Configurazione e connessione dell'ambiente

Panoramica: segui questi passaggi per preparare Databricks per Klaviyo. Potrai creare gli schemi richiesti (in un catalogo), impostare un account dedicato e un token di accesso per Klaviyo, assegnare i privilegi minimi richiesti, verificare la configurazione e connettere Databricks a Klaviyo.

Importante: la connessione Databricks attualmente supporta solo l'importazione di dati in Klaviyo.

• I profili possono essere importati ora.
• L'importazione degli eventi sarà presto disponibile.
• L'esportazione in Databricks non è ancora disponibile. Nel frattempo, si consiglia di esportare in S3.

Per i dettagli sul funzionamento delle importazioni del magazzino dati in Klaviyo, tra cui la struttura dello schema, le tabelle obbligatorie e le mappature dei campi, consulta Come funzionano le Importazioni del magazzino dati in Klaviyo.

1) Crea Gli Schemi Obbligatori

In Databricks, gli schemi (talvolta chiamati database) si trovano all'interno di un catalogo. Puoi utilizzare il catalogo principale predefinito o un altro catalogo se la tua area di lavoro utilizza Unity Catalog.

UTILIZZA CATALOG main; -- o il catalogo designato dalla tua organizzazione CREA SCHEMA SE NON ESISTE KLAVIYO_IMPORT_FROM_DWH; CREA SCHEMA SE NON ESISTE KLAVIYO_TMP;

• KLAVIYO_IMPORT_FROM_DWH: le tabelle e le viste create in questo schema saranno disponibili per la selezione durante la configurazione di una nuova sincronizzazione.
• KLAVIYO_TMP: dati temporanei/di staging utilizzati durante la sincronizzazione.

Nota: se il tuo workspace non utilizza Unity Catalog, Databricks considera "schema" e "database" come equivalenti. Puoi utilizzare CREATE DATABASE invece di CREATE SCHEMA.

2) Crea l'account Klaviyo Service e il token di accesso

Klaviyo si autentica a Databricks utilizzando un account dedicato con un token di accesso personale (PAT). Quando possibile, utilizza un account (di servizio) non umano e archivia il PAT in modo sicuro (ad esempio, un gestore di password o un negozio segreto). Fornirai questo token a Klaviyo durante la configurazione iniziale.

2.1 Crea l'account

Crea un utente dell'area di lavoro Databricks o un'entità di servizio che Klaviyo utilizzerà esclusivamente per questa integrazione.

2.2 Genera il token di accesso personale

• Account utente dell'area di lavoro: Genera il token tramite l'interfaccia utente web Databricks (consulta i documenti Databricks): crea token di accesso personali per gli utenti dell'area di lavoro
• Entità di servizio: generare il token utilizzando l'interfaccia CLI Databricks (vedere i documenti Databricks): creare token di accesso personali tramite l'interfaccia CLI Databricks

Importante: tratta il PAT come un segreto. Chiunque abbia il token può accedere a Databricks con le autorizzazioni dell'account associato.

3) Assegna Le Autorizzazioni Richieste

Concedi all'account Klaviyo i seguenti privilegi sugli schemi creati nel Passaggio 1. Sostituisci klaviyo_service_user con il tuo nome utente effettivo o il nome dell'entità di servizio e prefissa gli schemi con il catalogo corretto (ad esempio, principale).

-- Concedere autorizzazioni sullo schema temporaneo CONCEDERE TUTTI I PRIVILEGI SULLO SCHEMA main.KLAVIYO_TMP A `klaviyo_service_user`; -- OR, concedere privilegi granulari: CONCEDERE L'UTILIZZO DELLO SCHEMA, MODIFICARE, SELEZIONARE, CREARE TABELLA SULLO SCHEMA main.KLAVIYO_TMP A `klaviyo_service_user`; -- Concedere l'accesso in sola lettura all'importazione dello schema GRANT USE SCHEMA, SELECT ON SCHEMA main.KLAVIYO_IMPORT_FROM_DWH A `klaviyo_service_user`;

Procedure consigliate: applica il principio del minimo privilegio: concedi solo ciò che è necessario.

4) Verifica La Tua Configurazione (Facoltativo)

4.1 Conferma l'esistenza degli schemi

Eseguire in un blocco appunti o editor SQL Databricks:

MOSTRA GLI SCHEMI IN main; -- sostituisci "main" con il tuo catalogo, se diverso

Dovresti vedere:

Klaviyo_import_from_dwh Klaviyo_tmp

4.2 Testa l'autenticazione (utilizzando il tuo PAT)

Usa l'interfaccia CLI di Databricks con lo stesso token che intendi fornire a Klaviyo:

# Impostare il tuo token e host (esempio per AWS) export DATABRICKS_HOST="https://<your-workspace>.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" # Esegui una semplice chiamata API databricks current-user me

Risultato previsto: output JSON che mostra i dettagli dell'utente o dell'entità di servizio (ad esempio, nome visualizzato, ID utente). Se ricevi un HTTP 403 o un errore di autenticazione, verifica il token e l'URL dell'host.

4.3 Controlla le autorizzazioni per ogni schema

MOSTRA LE SOVVENZIONI SULLO SCHEMA main.klaviyo_tmp;
MOSTRA CONCESSIONI SULLO SCHEMA main.klaviyo_import_from_dwh;

Verifica che il tuo account Klaviyo venga visualizzato con i privilegi previsti (ad esempio, USA SCHEMA, SELEZIONA, MODIFICA, CREA TABELLA).

4.4 Convalida delle operazioni di creazione/lettura

-- Test create/drop in KLAVIYO_TMP USE SCHEMA main.klaviyo_tmp;
CREA TABELLA SE NON ESISTE test_permissions (id INT); RILASCIA TABELLA test_permissions; -- Seleziona test in KLAVIYO_IMPORT_FROM_DWH USA SCHEMA main.klaviyo_import_from_dwh;
MOSTRA LE TABELLE;

Suggerimenti:

• Esegui questi passaggi di verifica utilizzando la stessa identità e lo stesso PAT che condividerai con Klaviyo.
• Conserva le istruzioni di sovvenzione SQL e l'output di verifica per l'audit/la risoluzione dei problemi.
• Ruotare il PAT con cadenza regolare e dopo i cambi di personale.

5) Collega Klaviyo a Databricks

Una volta configurato Databricks, completa la connessione in Klaviyo.

1. In Klaviyo, apri la barra laterale sinistra e vai su Avanzate > Sincronizzazione.
2. Fai clic su Crea sincronizzazione.
3. Seleziona Importa dati dal tuo magazzino dati.
4. Scegli Databricks come magazzino dati.
5. Fai clic su Connetti a Databricks.

Quando richiesto, fornisci i seguenti dettagli di connessione:

MOSTRA I CATALOGHI;

Dopo la connessione: Klaviyo testerà la connessione e confermerà l'accesso al tuo ambiente Databricks. Una volta verificata, puoi configurare le sincronizzazioni per importare i dati dagli schemi che hai preparato in precedenza.

Passaggio successivo: dopo aver effettuato con successo la connessione, procedi con la creazione della tua prima sincronizzazione in Klaviyo e inizia a importare i dati da Databricks.