Installation och anslutning av miljö

Översikt: Följ dessa steg för att förbereda Databricks för Klaviyo. Du kommer att skapa nödvändiga scheman (i en katalog), konfigurera ett dedikerat Konto och en access token för Klaviyo, tilldela de minimiprivilegier som krävs, verifiera konfigurationen och ansluta Databricks till Klaviyo.

Viktigt: Databricks-anslutningen stöder för närvarande endast import av data till Klaviyo.

• profil kan importeras nu.
• Import av evenemang kommer inom kort.
• Export till Databricks är ännu inte tillgänglig. Fram till dess rekommenderas export till S3.

För detaljer om hur import av datalager fungerar i Klaviyo- inklusive schemastruktur, obligatoriska tabeller och fältmappningar - se Hur import av datalager fungerar i Klaviyo .

1) Skapa nödvändiga scheman

I Databricks finns scheman (ibland kallade databaser) i en katalog. Du kan använda standardhuvudkatalogen eller en annan katalog om din arbetsyta använder Unity Catalog.

USE CATALOG main; -- eller din organisations angivna katalog
CREATE SCHEMA IF NOT EXISTS KLAVIYO_IMPORT_FROM_DWH;
CREATE SCHEMA IF NOT EXISTS KLAVIYO_TMP;

• KLAVIYO_IMPORT_FROM_DWH: Tabeller och vyer som skapats i detta schema kommer att vara tillgängliga för val när en ny synkronisering konfigureras.
• KLAVIYO_TMP: tillfälliga/staging-data som används under synkroniseringen.

Obs: Om din arbetsyta inte använder Unity Catalog behandlar Databricks "schema" och "databas" som likvärdiga. Du kan använda CREATE DATABASE i stället för CREATE SCHEMA.

2) Skapa Klaviyo Service Konto och Access Token

Klaviyo autentiserar sig till Databricks med hjälp av ett särskilt Konto med en personlig åtkomsttoken (PAT). Använd ett icke-mänskligt (tjänste-)konto när det är möjligt och förvara PAT på ett säkert sätt (t.ex. i en lösenordshanterare eller hemlig förvaring). Du kommer att tillhandahålla denna token till Klaviyo under den första installationen.

2.1 Skapa ett konto

Skapa en Databricks workspace user eller en service principal som Klaviyo kommer att använda exklusivt för denna integrationer.

2.2 Generera den personliga åtkomsttoken

• Konto för arbetsytans användare: Generera token via Databricks webbgränssnitt (se Databricks dokument): Skapa personliga access-tokens för workspace-användare
• Service principal: Generera token med hjälp av Databricks CLI (se Databricks-dokument): Skapa personliga access-tokens via Databricks CLI

Viktigt: Behandla PAT som en hemlighet. Alla som har token kan komma åt Databricks med det associerade Kontots behörigheter.

3) Tilldela nödvändiga behörigheter

Ge Klaviyo Konto följande behörigheter för de scheman som skapades i steg 1. Ersätt klaviyo_service_user med ditt faktiska användarnamn eller tjänstens huvudnamn och prefixera scheman med rätt katalog (t.ex. main).

-- Ge behörighet till tillfälligt schema
GRANT ALL PRIVILEGES ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- ELLER, ge granulär behörighet:
GRANT USE SCHEMA, MODIFY, SELECT, CREATE TABLE ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- Ge skrivskyddad åtkomst till importschemat
GRANT USE SCHEMA, SELECT ON SCHEMA main.KLAVIYO_IMPORT_FROM_DWH TO `klaviyo_service_user`;

Bästa praxis: Tillämpa principen om minsta möjliga privilegium - bevilja endast det som krävs.

4) Verifiera din installation (valfritt)

4.1 Bekräfta att schemana finns

Kör i en Databricks SQL-anteckningsbok eller -redigerare:

SHOW SCHEMAS IN main; -- ersätt "main" med din katalog om den är annorlunda

Du borde se:

klaviyo_import_från_dwh
klaviyo_tmp

4.2 Testa autentiseringen (med hjälp av din PAT)

Använd Databricks CLI med samma token som du planerar att ge till Klaviyo:

# Ange din token och värd (exempel för AWS)
export DATABRICKS_HOST="https://<your-workspace>.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" 

 # Kör ett enkelt API-anrop
databricks current-user me

Förväntat resultat: JSON-utdata med information om användaren eller tjänstens huvudman (t.ex. visningsnamn, användar-ID). Om du får ett HTTP 403- eller autentiseringsfel ska du verifiera token och värd-URL:en.

4.3 Kontrollera behörigheter för varje schema

VISA GRANSKNINGAR PÅ SCHEMA main.klaviyo_tmp;
VISA BIDRAG PÅ SCHEMA main.klaviyo_import_from_dwh;

Kontrollera att ditt Klaviyo Konto visas med de förväntade behörigheterna (t.ex. USE SCHEMA, SELECT, MODIFY, CREATE TABLE).

4.4 Validera skapa/läsa-operationer

-- Testa att skapa/droppa i KLAVIYO_TMP
USE SCHEMA main.klaviyo_tmp;
CREATE TABLE IF NOT EXISTS test_permissions (id INT);
DROP TABLE test_permissions;

-- Testval i KLAVIYO_IMPORT_FROM_DWH
USE SCHEMA main.klaviyo_import_from_dwh;
VISA TABELLER;

Tips:

• Kör dessa verifieringssteg med samma identitet och PAT som du delar med Klaviyo.
• Behåll SQL grant statements och verifieringsutdata för granskning och felsökning.
• Byt ut PAT regelbundet och efter personalförändringar.

5) Anslut Klaviyo till Databricks

När Databricks har konfigurerats slutför du anslutningen i Klaviyo.

1. I Klaviyo öppnar du det vänstra sidofältet och navigerar till Avancerad > Synkronisering.
2. Klicka på Skapa synkronisering.
3. Välj Importera data från ditt datalager.
4. Välj Databricks som ditt datalager.
5. Klicka på Connect to Databricks.

Ange följande anslutningsuppgifter när du blir ombedd att göra det:

VISA KATALOGER;

Efter att du har anslutit: Klaviyo kommer att testa anslutningen och bekräfta åtkomst till din Databricks-miljö. När du har verifierat kan du konfigurera synkroniseringar för att importera data från de scheman som du förberedde tidigare.

Nästa steg: När du har anslutit framgångsrikt kan du fortsätta att skapa din första synkronisering i Klaviyo och börja importera data från Databricks.