---
title: "Klaviyo-data exporteren naar Databricks"
description: "Stel Databricks in als bestemming voor outbound synchronisatie, zodat Klaviyo je profiel-, event- en meetwaardedata continu naar Delta-tabellen in je Databricks-workspace schrijft."
canonical_url: "https://help.klaviyo.com/hc/nl-nl/articles/56749052645019"
markdown_url: "https://help.klaviyo.com/hc/nl-nl/articles/56749052645019.md"
locale: "nl-nl"
category: "Advanced Klaviyo Data Platform en Marketing Analytics"
section: "Synchroniseren"
updated: "2026-10-26"
---

# Klaviyo-data exporteren naar Databricks

**📝 Note:** **[Advanced Klaviyo Data Platform](https://help.klaviyo.com/hc/nl-nl/articles/17655007276059.md)** is niet inbegrepen in Klaviyo's standaard marketingtoepassing en je hebt een abonnement nodig om toegang te krijgen tot de bijbehorende functionaliteit. Ga naar onze [factureringsgids](https://help.klaviyo.com/hc/nl-nl/articles/115000976672.md) om te lezen hoe je dit abonnement kunt aanschaffen.

## Wat je leert

Ontdek hoe je Databricks instelt als outbound sync-bestemming, zodat Klaviyo continu je profiel-, event- en meetwaardedata naar Delta-tabellen in je eigen Databricks-workspace schrijft. Zodra alles is gekoppeld, kan je datateam Klaviyo-data samenvoegen met de rest van je lakehouse voor analyse, modellering en rapportage.

Wil je in plaats daarvan data *naar* Klaviyo halen vanuit Databricks? Bekijk [Klaviyo en Databricks verbinden](https://help.klaviyo.com/hc/nl-nl/articles/42790208080283.md).

## Voordat je van start gaat

Zorg dat je het volgende hebt:

- **Een Databricks-workspace met Unity Catalog ingeschakeld.** Workspaces die alleen Hive-metastore gebruiken, worden niet ondersteund. Als je Hive-metastore gebruikt, overweeg dan [federatie voor Hive-metastore](https://docs.databricks.com/aws/en/query-federation/hms-federation-concepts).

- **Een SQL-warehouse** dat `VARIANT` kolommen en tijdelijke tabellen met sessiebereik ondersteunt, zodat Klaviyo data kan schrijven. Serverless SQL-warehouses worden aanbevolen; Classic- en Pro-warehouses kunnen er enkele minuten over doen om te starten, wat synchronisaties kan vertragen.

- **Toestemming om schema's, tabellen en machtigingen te maken** in de catalogus die je gaat gebruiken (of hulp van een Databricks-beheerder).

- Toestemming om integraties te beheren in Klaviyo.

- **Klaviyo's uitgaande IP-adressen toegestaan**, als je workspace inkomend verkeer beperkt met IP-toegangslijsten:

  - `184.72.183.187/32`

  - `52.206.71.52/32`

  - `3.227.146.32/32`

  - `44.198.39.11/32`

  - `35.172.58.121/32`

  - `3.228.37.244/32`

  - `54.88.219.8/32`

  - `3.214.211.176/32`



**📝 Note:** Je kunt per Klaviyo-account maar 1 exportbestemming voor datawarehouses hebben. Als je al exporteert naar een ander datawarehouse (bijvoorbeeld Snowflake of S3), moet je die bestemming verwijderen voordat je Databricks toevoegt.

## Stap 1: maak een schema voor Klaviyo-gegevens

In Databricks bevinden schema's zich in een catalogus. Maak een apart schema om de tabellen in op te slaan waar Klaviyo naartoe schrijft. De SQL-voorbeelden in dit artikel gebruiken `main` als de catalogus en `KLAVIYO_EXPORT` als het schema. Als je andere namen gebruikt, vervang ze dan in alle SQL-voorbeelden en vul tijdens stap 5 in Klaviyo dezelfde namen in.

```sql
USE CATALOG main;  -- or your organization's designated catalog
CREATE SCHEMA IF NOT EXISTS KLAVIYO_EXPORT;
```

## Stap 2: maak de doeltabellen

Voer het volgende script uit in het schema dat je in stap 1 hebt gemaakt. Klaviyo schrijft naar 3 tabellen:

- `**klaviyo_profile**`**:** Eén rij per profiel, inclusief standaardvelden, locatie en aangepaste eigenschappen.

- `**klaviyo_event**`**:** Eén rij per event (bijvoorbeeld *Placed Order* of *Opened Email*), gekoppeld aan een profiel en meetwaarde.

- `**klaviyo_metric**`**:** Één rij per meetwaarde, gebruikt om de meetwaardenaam en bronintegratie voor elke gebeurtenis op te zoeken.



Aangepaste profieleigenschappen en eventeigenschappen worden opgeslagen in `VARIANT` -kolommen, zodat je geneste JSON rechtstreeks kunt opvragen zonder honderden afzonderlijke kolommen te beheren.

```sql
USE SCHEMA main.KLAVIYO_EXPORT;

CREATE TABLE klaviyo_profile (
  id                 STRING NOT NULL,
  external_id        STRING,
  email              STRING,
  phone_number       STRING,
  first_name         STRING,
  last_name          STRING,
  title              STRING,
  organization       STRING,
  properties         VARIANT,
  image              STRING,
  created            TIMESTAMP,
  updated            TIMESTAMP,
  location_address1  STRING,
  location_address2  STRING,
  location_city      STRING,
  location_country   STRING,
  location_latitude  STRING,
  location_longitude STRING,
  location_region    STRING,
  location_zip       STRING,
  PRIMARY KEY (id)
)
TBLPROPERTIES ('delta.feature.variantType-preview' = 'supported');

CREATE TABLE klaviyo_event (
  id               STRING NOT NULL,
  metric_id        STRING NOT NULL,
  profile_id       STRING,
  event_properties VARIANT,
  datetime         TIMESTAMP,
  uuid             STRING,
  PRIMARY KEY (id)
)
TBLPROPERTIES ('delta.feature.variantType-preview' = 'supported');

CREATE TABLE klaviyo_metric (
  id                   STRING NOT NULL,
  name                 STRING NOT NULL,
  integration_id       STRING,
  integration_name     STRING,
  integration_category STRING,
  created              TIMESTAMP,
  updated              TIMESTAMP,
  PRIMARY KEY (id)
);
```

**⚠️ Warning:** Tabelnamen moeten exact overeenkomen. Klaviyo zoekt naar `klaviyo_profile`, `klaviyo_event` en `klaviyo_metric` in het schema dat je tijdens de configuratie opgeeft.

## Stap 3: Maak een service principal en toegangstoken aan

Klaviyo verifieert bij Databricks met een personal access token (PAT). We raden aan om een toegewezen serviceprincipal te maken die alleen voor deze integratie wordt gebruikt, in plaats van een persoonlijk account.

1. Maak een [service principal](https://docs.databricks.com/aws/en/admin/users-groups/service-principals) (of een workspace-gebruiker) aan voor Klaviyo.

2. Genereer een persoonlijk toegangstoken:

   - **Service principal:** Vraag een workspacebeheerder om [het eerste token te maken met de Databricks CLI](https://docs.databricks.com/aws/en/dev-tools/auth/pat#create-personal-access-tokens-for-service-principals).

   - **Workspacegebruiker:** [Maak een token aan in de Databricks-UI](https://docs.databricks.com/aws/en/dev-tools/auth/pat#create-personal-access-tokens-for-workspace-users).

3. Sla het token ergens veilig op. Je plakt het in Stap 5 in Klaviyo.



**⚠️ Warning:** Behandel het toegangstoken als een wachtwoord. Iedereen met het token kan Databricks openen met de rechten van het gekoppelde account. Roteer het regelmatig en na personeelswisselingen.

Als je al een serviceprincipal hebt gemaakt voor [importeren vanuit Databricks](https://help.klaviyo.com/hc/nl-nl/articles/42790208080283.md), kun je die opnieuw gebruiken. Voeg dan alleen de exportmachtigingen toe in stap 4.

## Stap 4: machtigingen verlenen

Geef de Klaviyo-serviceprincipal toegang tot de catalogus, het schema en het SQL-warehouse. Vervang `klaviyo_service_user` door de toepassings-ID of gebruikersnaam van je serviceprincipal.

```sql
GRANT USE CATALOG ON CATALOG main TO `klaviyo_service_user`;
GRANT USE SCHEMA, SELECT, MODIFY ON SCHEMA main.KLAVIYO_EXPORT TO `klaviyo_service_user`;
```

| Machtiging | Doel |
| --- | --- |
| `USE CATALOG` | Hiermee kan Klaviyo toegang krijgen tot de catalogus die je exportschema bevat. |
| `USE SCHEMA` | Hiermee krijgt Klaviyo toegang tot het exportschema. |
| `SELECT` | Hiermee kan Klaviyo bestaande rijen lezen, zodat het records kan updaten in plaats van ze te dupliceren. |
| `MODIFY` | Hiermee kan Klaviyo rijen invoegen, bijwerken en verwijderen in de doeltabellen. |

Geef de service principal ook de machtiging **Can use** op het SQL-warehouse dat je wilt gebruiken. Ga in Databricks naar **SQL Warehouses**, selecteer je warehouse, klik op **Permissions** en voeg de service principal toe.

### Controleer je configuratie (optioneel)

Bevestig met dezelfde identiteit en hetzelfde token die je aan Klaviyo geeft de tabellen en rechten:

```sql
SHOW TABLES IN main.KLAVIYO_EXPORT;
SHOW GRANTS ON SCHEMA main.KLAVIYO_EXPORT;
```

Je zou alle 3 tabellen moeten zien en de serviceprincipal moet worden vermeld met `USE SCHEMA`, `SELECT` en `MODIFY`.

## Stap 5: Koppel Databricks in Klaviyo

1. Navigeer in Klaviyo naar **Geavanceerd > Gegevensbeheer > Synchroniseren**.

2. Als je al een sync hebt, klik je op **Sync maken**.

3. Selecteer **Gegevens exporteren naar je datawarehouse**.

4. Kies **Databricks** en klik vervolgens op **Verbinden met Databricks**.

5. Voer je verbindingsgegevens in:



| Veld | Beschrijving | Waar je het vindt |
| --- | --- | --- |
| **Naam** | Een naam waaraan je deze verbinding herkent | Voer een beschrijvende naam in, zoals Klaviyo-export. |
| **Hostnaam van server** | De host van je Databricks-workspace. | De adresbalk van je browser wanneer je bent ingelogd bij Databricks. Voorbeeld: `abc-12345678.cloud.databricks.com` |
| **HTTP-pad** | Het HTTP-pad van het SQL-warehouse dat Klaviyo zal gebruiken. | **SQL Warehouses** > selecteer je warehouse > **Verbindingsinformatie**. Voorbeeld: `/sql/1.0/warehouses/1234abcd5678efgh` |
| **Catalogus** | De catalogus die je exportschema bevat. | De catalogus die je hebt gebruikt in stap 1 (bijvoorbeeld `main`). |
| **Schema** | Het schema dat de 3 Klaviyo-tabellen bevat. | Het schema dat je in stap 1 hebt gemaakt (bijvoorbeeld `KLAVIYO_EXPORT`). |
| **Toegangstoken** | Het persoonlijke toegangstoken voor de service principal of werkruimtegebruiker die je hebt gemaakt. | Het token dat je in stap 3 hebt gegenereerd. |

Klik op **Volgende** om je synchronisatie te configureren.

Je kunt Databricks ook vinden in de marktplaats voor apps van Klaviyo door naar **Integraties > Apps verkennen** te gaan en te zoeken naar *Databricks*.

## Stap 6: configureer je gegevenssynchronisatie

Kies wat Klaviyo naar Databricks stuurt en wanneer het synchroniseert.

### Gegevensobjecten

Kies of je profielen, gebeurtenissen of beide wilt synchroniseren. Meetwaardedata wordt samen met gebeurtenissen gesynchroniseerd, zodat je voor elke gebeurtenis de naam en bron van de meetwaarde kunt opzoeken.

**📝 Note:** Als je alle gegevens uit Klaviyo synchroniseert, kunnen je Databricks-compute- en opslagkosten stijgen.

### Uit te sluiten integraties

Selecteer alle integraties waarvan je de gebeurtenissen niet naar Databricks wilt laten verzenden. Dit geldt alleen voor gebeurtenisgegevens; het sluit profielen niet uit.

### Selectieve synchronisatie

Selecteer de meetwaarden waarvan je de events wilt synchroniseren, zoals Placed Order. Laat **Selective sync** leeg om alle events te synchroniseren uit integraties die je niet hebt uitgesloten. Dit veld verschijnt alleen als je het **Events** -dataobject selecteert.

### Synchronisatiefrequentie

Onder **Elke** kies je hoe vaak je nieuwe en bijgewerkte gegevens wilt synchroniseren: elke 1, 2, 4, 6, 12 of 24 uur. De standaardinstelling is 1 uur. Stel **startdatum**, **starttijd** en **tijdzone** in voor het schema.

### Historische gegevens

Kies hoeveel historische gegevens je tijdens de eerste synchronisatie wilt verzenden:

- 30 dagen

- 90 dagen

- 1 jaar

- Sinds het begin



**📝 Note:** Grote historische synchronisaties kunnen even duren en kunnen je Databricks-kosten verhogen. Overweeg om te beginnen met een kortere periode als je alleen recente gegevens nodig hebt.

## Stap 7: Controleer, verbind en houd je synchronisatie in de gaten

1. Klik op **Volgende** om **Controleren** te openen. Controleer je verbindingsgegevens, gedeelde gegevens, uitgesloten integraties, geselecteerde meetwaarden en het bereik voor de eerste gegevenssynchronisatie.

2. Klik op **Verbinden**. Klaviyo test de verbinding en maakt de export aan als de test slaagt.



Als de installatie is gelukt, toont Klaviyo een bevestigingsbericht en ga je terug naar **Synchroniseren**. Je export is ingeschakeld en je kunt daar de synchronisatiestatus volgen.

Als de verbindingstest mislukt, bekijk je de foutdetails. Klik op **Inloggegevens bewerken** om je verbindingsgegevens te corrigeren. Klik daarna in de gegevensinstellingen op **Volgende** om terug te gaan naar **Controleren** en klik opnieuw op **Verbinden**.

Ga naar **Geavanceerd > Databeheer > Synchroniseren** om je synchronisatie te monitoren en klik op **Databricks** in de rij met de markering **Exporteren**. Gebruik deze tabbladen:

- **Historisch:** De status van je eerste backfill.

- **Periodiek:** De status van synchronisaties op je geselecteerde cadans, inclusief *gegevensactualiteit* (hoe ver je Databricks-tabellen achterlopen op Klaviyo).

- **Instellingen**: Bekijk en bewerk je verbindingsgegevens, dataselectie, synchronisatiefrequentie en historisch bereik. Klik op **Gegevens bijwerken** in de sectie die je wijzigt om op te slaan.



Zie [Datawarehouse-synchronisatie in Klaviyo begrijpen](https://help.klaviyo.com/hc/nl-nl/articles/17759932376475.md) voor meer informatie over synchronisatiestatussen, het pauzeren en hervatten van synchronisaties en het bekijken van foutenlogboeken.

## Je Klaviyo-data opvragen in Databricks

Hier zijn een paar voorbeelden om mee te beginnen.

**Tel events op meetwaardenaam in de afgelopen 7 dagen:**

```sql
SELECT m.name AS metric, COUNT(*) AS events
FROM main.KLAVIYO_EXPORT.klaviyo_event e
JOIN main.KLAVIYO_EXPORT.klaviyo_metric m ON e.metric_id = m.id
WHERE e.datetime >= current_timestamp() - INTERVAL 7 DAYS
GROUP BY m.name
ORDER BY events DESC;
```

**Lees een aangepaste profieleigenschap uit de** `**properties**` **variatie-kolom:**

```sql
SELECT id, email, properties:loyalty_tier::STRING AS loyalty_tier
FROM main.KLAVIYO_EXPORT.klaviyo_profile
WHERE properties:loyalty_tier IS NOT NULL;
```

**Haal de bestelwaarde op uit Placed Order-gebeurtenissen:**

```sql
SELECT e.profile_id, e.datetime, e.event_properties:`$value`::DOUBLE AS order_value
FROM main.KLAVIYO_EXPORT.klaviyo_event e
JOIN main.KLAVIYO_EXPORT.klaviyo_metric m ON e.metric_id = m.id
WHERE m.name = 'Placed Order';
```

## Probleemoplossing

| Probleem | Wat je moet controleren |
| --- | --- |
| Verbindingstest mislukt met een verificatiefout | Controleer of de hostnaam geen `https://` -prefix of afsluitende slash heeft en of het toegangstoken geldig is en niet is verlopen. |
| Verbindingstest mislukt met een machtigingsfout | Bevestig de verleningen in stap 4, waaronder `USE CATALOG` en **Kan gebruiken** op het SQL-warehouse. |
| Klaviyo kan de doeltabellen niet vinden | Controleer of de catalogus en het schema in Klaviyo overeenkomen met waar je het script van stap 2 hebt uitgevoerd, en dat de tabelnamen exact `klaviyo_profile`, `klaviyo_event` en `klaviyo_metric` zijn. |
| Fouten over het type `VARIANT` | Controleer of je SQL-warehouse een Databricks SQL-versie draait die `VARIANT` ondersteunt en of de tabellen zijn gemaakt met de `TBLPROPERTIES` die in stap 2 wordt getoond. |
| Synchronisaties starten langzaam | Classic- en Pro-SQL-warehouses kunnen een paar minuten nodig hebben om te starten. Gebruik een serverless SQL-warehouse of verleng de automatische stop-tijd van het warehouse. |
| Verzoeken zijn geblokkeerd | Als je workspace IP-toegangslijsten gebruikt, zet je de Klaviyo IP-adressen uit *Voordat je begint* op de positieve lijst. |

## Een Databricks-export verwijderen

Als je de export verwijdert, worden toekomstige synchronisaties stopgezet. Gegevens die al naar je Databricks-tabellen zijn geschreven, worden niet verwijderd.

1. Ga naar **integraties** in Klaviyo.

2. Open het menu naast de Databricks-exportintegratie en selecteer **Integratie verwijderen**.

3. Klik in het bevestigingsvenster op **Integratie verwijderen**.



## Extra hulpbronnen

- [Klaviyo en Databricks koppelen](https://help.klaviyo.com/hc/nl-nl/articles/42790208080283.md) (importeren)

- [Gegevenssynchronisatie met datawarehouses begrijpen in Klaviyo](https://help.klaviyo.com/hc/nl-nl/articles/17759932376475.md)

- [Aan de slag met Advanced KDP](https://help.klaviyo.com/hc/nl-nl/articles/17655007276059.md)
