Konfiguracja środowiska i połączenie

Przegląd: Wykonaj poniższe kroki, aby przygotować Databricks dla Klaviyo. Utworzysz wymagane schematy (w katalogu), skonfigurujesz dedykowane konto i token dostępu dla Klaviyo, przypiszesz minimalne wymagane uprawnienia, zweryfikujesz konfigurację i połączysz Databricks z Klaviyo.

Ważne: Połączenie Databricks obsługuje obecnie tylko importowanie danych do Klaviyo.

• profil może być teraz importowany.
• Import wydarzeń już wkrótce.
• Eksport do Databricks nie jest jeszcze dostępny. Do tego czasu zalecane jest eksportowanie do S3.

Aby uzyskać szczegółowe informacje na temat działania importu z hurtowni danych w Klaviyo- w tym struktury schematu, wymaganych tabel i mapowania pól - zobacz Jak działa import z hurtowni danych Klaviyo w.

1) Utwórz wymagane schematy

W Databricks schematy (czasami nazywane bazami danych) znajdują się wewnątrz katalogu. Możesz użyć domyślnego katalogu głównego lub innego katalogu, jeśli Twój obszar roboczy korzysta z Unity Catalog.

USE CATALOG main; -- lub wyznaczony katalog Twojej organizacji
CREATE SCHEMA IF NOT EXISTS KLAVIYO_IMPORT_FROM_DWH;
CREATE SCHEMA IF NOT EXISTS KLAVIYO_TMP;

• KLAVIYO_IMPORT_FROM_DWH: Tabele i widoki utworzone w tym schemacie będą dostępne do wyboru podczas konfigurowania nowej synchronizacji.
• KLAVIYO_TMP: dane tymczasowe używane podczas synchronizacji.

Uwaga: Jeśli Twój obszar roboczy nie korzysta z Unity Catalog, Databricks traktuje "schemat" i "bazę danych" jako równoważne. Możesz użyć CREATE DATABASE zamiast CREATE SCHEMA.

2) Utwórz konto Klaviyo Service i token dostępu

Klaviyo uwierzytelnia się w Databricks za pomocą dedykowanego konta z osobistym tokenem dostępu (PAT). Jeśli to możliwe, korzystaj z konta innego niż ludzkie (usługowe) i przechowuj PAT w bezpieczny sposób (np. w menedżerze haseł lub tajnym magazynie). Dostarczysz ten token do Klaviyo podczas początkowej konfiguracji.

2.1 Utwórz konto

Utwórz użytkownika obszaru roboczego Databricks lub jednostkę usługi, której Klaviyo będzie używać wyłącznie do tej integracji.

2.2 Wygeneruj osobisty token dostępu

• Konto użytkownika obszaru roboczego: Wygeneruj token za pośrednictwem interfejsu internetowego Databricks (patrz dokumentacja Databricks): Utwórz osobiste tokeny dostępu dla użytkowników przestrzeni roboczej
• Zleceniodawca usługi: wygeneruj token za pomocą interfejsu CLI Databricks (zobacz dokumentację Databricks): Utwórz osobiste tokeny dostępu za pomocą Databricks CLI

Ważne: Traktuj PAT jako tajemnicę. Każda osoba posiadająca token może uzyskać dostęp do Databricks z uprawnieniami powiązanego konta.

3) Przypisz wymagane uprawnienia

Przyznaj kontu Klaviyo następujące uprawnienia do schematów utworzonych w kroku 1. Zastąp klaviyo_service_user swoją rzeczywistą nazwą użytkownika lub nazwą główną usługi i poprzedzaj schematy poprawnym katalogiem (np. main).

-- Nadaj uprawnienia do schematu tymczasowego
GRANT ALL PRIVILEGES ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- LUB, nadaj uprawnienia granularne:
GRANT USE SCHEMA, MODIFY, SELECT, CREATE TABLE ON SCHEMA main.KLAVIYO_TMP TO `klaviyo_service_user`;

-- Przyznaj dostęp tylko do odczytu do schematu importu
GRANT USE SCHEMA, SELECT ON SCHEMA main.KLAVIYO_IMPORT_FROM_DWH TO `klaviyo_service_user`;

Najlepsza praktyka: Stosuj zasadę najmniejszego przywileju - przyznawaj tylko to, co jest wymagane.

4) Zweryfikuj konfigurację (opcjonalnie)

4.1 Potwierdź istnienie schematów

Uruchom w Databricks SQL notebook lub edytorze:

SHOW SCHEMAS IN main; -- zastąp "main" swoim katalogiem, jeśli jest inny

Powinieneś zobaczyć:

klaviyo_import_from_dwh
klaviyo_tmp

4.2 Przetestuj uwierzytelnianie (używając PAT)

Użyj interfejsu CLI Databricks z tym samym tokenem, który planujesz dostarczyć do Klaviyo:

# Ustaw swój token i host (przykład dla AWS)
export DATABRICKS_HOST="https://<your-workspace>.cloud.databricks.com"
export DATABRICKS_TOKEN="<your-PAT>" 

 # Uruchom proste wywołanie API
databricks current-user me

Oczekiwany wynik: Dane wyjściowe JSON pokazujące szczegóły użytkownika lub podmiotu usługi (np. nazwa wyświetlana, identyfikator użytkownika). Jeśli otrzymasz HTTP 403 lub błąd uwierzytelniania, zweryfikuj token i adres URL hosta.

4.3 Sprawdź uprawnienia dla każdego schematu

SHOW GRANTS ON SCHEMA main.klaviyo_tmp;
SHOW GRANTS ON SCHEMA main.klaviyo_import_from_dwh;

Upewnij się, że Twoje konto Klaviyo jest wyświetlane z oczekiwanymi uprawnieniami (np. USE SCHEMA, SELECT, MODIFY, CREATE TABLE).

4.4 Sprawdzanie poprawności operacji tworzenia/odczytu

-- Przetestuj tworzenie/upuszczanie w KLAVIYO_TMP
USE SCHEMA main.klaviyo_tmp;
CREATE TABLE IF NOT EXISTS test_permissions (id INT);
DROP TABLE test_permissions;

-- Test select in KLAVIYO_IMPORT_FROM_DWH
USE SCHEMA main.klaviyo_import_from_dwh;
POKAŻ TABELE;

Wskazówki:

• Uruchom te kroki weryfikacji przy użyciu tej samej tożsamości i PAT, które udostępnisz Klaviyo.
• Zachowaj instrukcje grantu SQL i dane wyjściowe weryfikacji do celów audytu/rozwiązywania problemów.
• Rotuj PAT regularnie i po zmianach personelu.

5) Połącz Klaviyo z Databricks

Po skonfigurowaniu Databricks dokończ połączenie w Klaviyo.

1. W Klaviyo otwórz lewy pasek boczny i przejdź do Zaawansowane > Synchronizacja.
2. Kliknij przycisk Utwórz synchronizację.
3. Wybierz opcję Importuj dane z hurtowni danych.
4. Wybierz Databricks jako swoją hurtownię danych.
5. Kliknij przycisk Connect to Databricks.

Po wyświetleniu monitu podaj następujące szczegóły połączenia:

KATALOGI POKAZÓW;

Po nawiązaniu połączenia: Klaviyo przetestuje połączenie i potwierdzi dostęp do Twojego środowiska Databricks. Po weryfikacji możesz skonfigurować synchronizacje, aby importować dane z przygotowanych wcześniej schematów.

Następny krok: Po pomyślnym połączeniu przejdź do tworzenia pierwszej synchronizacji w Klaviyo i rozpocznij importowanie danych z Databricks.