Configuration et connexion de l’environnement

Vue d’ensemble : suivez ces étapes pour préparer Databricks pour Klaviyo. Vous allez créer les schémas requis (dans un catalogue), configurer un compte et un jeton d’accès dédiés pour Klaviyo, attribuer les privilèges minimum requis, vérifier la configuration et connecter Databricks à Klaviyo.

Important : La connexion Databricks prend actuellement en charge l’ importation de données dans Klaviyo uniquement.

• Les profils peuvent désormais être importés.
• L’ importation des événements est imminente.
• L’exportation vers Databricks n’ est pas encore disponible. En attendant, il est recommandé d’exporter vers S3.

Pour plus d’informations sur le fonctionnement des importations depuis un entrepôt de données dans Klaviyo, notamment la structure des schémas, les tableaux obligatoires et les mappages de champs, consultez Comment fonctionnent les Importations depuis un entrepôt de données dans Klaviyo.

1) Créer les schémas requis

Dans Databricks, les schémas (parfois appelés bases de données) vivent dans un catalogue. Vous pouvez utiliser le catalogue principal par défaut ou un autre catalogue si votre espace de travail utilise Unity Catalog.

UTILISEZ CATALOG main ; -- ou le catalogue désigné par votre organisation CREATE SCHEMA IF NOT EXISTS KLAVIYO_IMPORT_FROM_DWH ; CREATE SCHEMA IF NOT EXISTS KLAVIYO_TMP ;

• KLAVIYO_IMPORT_FROM_DWH: Les tableaux et les vues créés dans ce schéma pourront être sélectionnés lors de la configuration d’une nouvelle synchronisation.
• KLAVIYO_TMP: données temporaires/intermédiaires utilisées lors de la synchronisation.

Remarque : Si votre espace de travail n’utilise pas Unity Catalog, Databricks traite les termes « schéma » et « base de données » comme équivalents. Vous pouvez utiliser CREATE DATABASE au lieu de CREATE SCHEMA.

2) Créez le compte Klaviyo Service et le jeton d’accès

Klaviyo s’authentifie auprès de Databricks à l’aide d’un compte dédié avec un jeton d’accès personnel (PAT). Utilisez un compte (de service) non humain lorsque cela est possible et stockez le PAT de manière sécurisée (par exemple, un gestionnaire de mots de passe ou une boutique secrète). Vous fournirez ce jeton à Klaviyo lors de la configuration initiale.

2.1 Créer le compte

Créez un utilisateur de l’espace de travail Databricks ou un principal de service que Klaviyo utilisera exclusivement pour cette intégration.

2.2 Générer le jeton d’accès personnel

• Compte utilisateur de l’espace de travail : Générez le jeton via l’interface utilisateur web de Databricks (voir la documentation Databricks) : créez des jetons d’accès personnels pour les utilisateurs de l’espace de travail
• Principal du service : Générez le jeton à l’aide de la CLI Databricks (voir la documentation Databricks) : Créez des jetons d’accès personnels via la CLI Databricks

Important : traitez le PAT comme un secret. Toute personne disposant du jeton peut accéder à Databricks avec les autorisations du compte associé.

3) Attribuer Les Autorisations Requises

Accordez au compte Klaviyo les privilèges suivants sur les schémas créés à l’étape 1. Remplacez Klaviyo_service_user par votre nom d’utilisateur ou votre principal de service, et préfixez les schémas avec le catalogue correct (par exemple, principal).

-- Accordez des autorisations sur le schéma temporaire ACCORDEZ TOUS LES PRIVILÈGES SUR LE SCHÉMA main.KLAVIYO_TMP À `Klaviyo_service_user`; -- OU, accordez des privilèges granulaires : ACCORDEZ UTILISEZ LE SCHÉMA, MODIFIEZ, SÉLECTIONNEZ, CRÉEZ UN TABLEAU SUR LE SCHÉMA main.KLAVIYO_TMP À `Klaviyo_service_user`; -- Accordez un accès en lecture seule au schéma d'importation ACCORDEZ UTILISEZ LE SCHÉMA, SÉLECTIONNEZ SUR LE SCHÉMA main.KLAVIYO_IMPORT_FROM_DWH À `Klaviyo_service_user`;

Bonnes pratiques : appliquez le principe du moindre privilège : n’accordez que ce qui est requis.

4) Vérifier Votre Configuration (Facultatif)

4.1 Confirmez l’existence des schémas

Exécuter dans un bloc-notes ou un éditeur Databricks SQL :

AFFICHER LES SCHÉMAS DANS main ; -- remplacez « main » par votre catalogue si différent

Vous devriez voir :

Klaviyo_import_from_dwh Klaviyo_tmp

4.2 Tester l’authentification (en utilisant votre PAT)

Utilisez la CLI Databricks avec le même jeton que vous prévoyez de fournir à Klaviyo :

# Définissez votre jeton et votre hôte (par exemple pour AWS) export DATABRICKS_HOST=<your-workspace> »https://.cloud.databricks.com »
export DATABRICKS_TOKEN=«<your-PAT>» # Exécutez une simple base de données d’appel d’API current-user me

Résultat attendu : sortie JSON affichant les détails de l’utilisateur ou du principal du service (par exemple, le nom d’affichage, l’identifiant de l’utilisateur). Si vous obtenez une erreur HTTP 403 ou d’authentification, vérifiez le jeton et l’URL de l’hôte.

4.3 Vérifier les autorisations sur chaque schéma

AFFICHER LES SUBVENTIONS SUR SCHEMA main.Klaviyo_tmp ;
AFFICHER LES AUTORISATIONS SUR SCHEMA main.Klaviyo_import_from_dwh ;

Confirmez que votre compte Klaviyo apparaît avec les privilèges prévus (par exemple, UTILISER LE SCHÉMA, SÉLECTIONNER, MODIFIER, CRÉER UN TABLEAU).

4.4 Valider les opérations de création/lecture

-- Testez la création/le dépôt dans KLAVIYO_TMP USE SCHEMA main.Klaviyo_tmp ;
CREATE TABLE IF NOT EXISTS test_permissions (id INT); DROP TABLE test_permissions ; -- Sélectionner le test dans KLAVIYO_IMPORT_FROM_DWH UTILISER LE SCHÉMA main.Klaviyo_import_from_dwh ;
AFFICHER LES TABLEAUX ;

Conseils :

• Exécutez ces étapes de vérification en utilisant la même identité et le même PAT que vous partagerez avec Klaviyo.
• Conservez les instructions d’autorisation SQL et les résultats de vérification pour l’audit/le dépannage.
• Faites pivoter le PAT à intervalles réguliers et après les changements de personnel.

5) Connecter Klaviyo à Databricks

Une fois Databricks configuré, terminez la connexion dans Klaviyo.

1. Dans Klaviyo, ouvrez la barre latérale gauche et accédez à Advanced > Synchronisation.
2. Cliquez sur Créer une synchronisation.
3. Sélectionnez Importer des données depuis votre entrepôt de données.
4. Choisissez Databricks comme entrepôt de données.
5. Cliquez sur Connecter à Databricks.

Lorsque vous y êtes invité, fournissez les détails de connexion suivants :

AFFICHER LES CATALOGUES ;

Une fois la connexion établie : Klaviyo testera la connexion et confirmera l’accès à votre environnement Databricks. Une fois la vérification effectuée, vous pouvez configurer les synchronisations pour importer des données à partir des schémas que vous avez préparés précédemment.

Étape suivante : Une fois la connexion établie, créez votre première synchronisation dans Klaviyo et commencez à importer des données à partir de Databricks.