Skip to main content
データウェアハウス連携は、Kameleoonの Web Experimentation および Feature Experimentation モジュールのプレミアムアドオンとしてご利用いただけます。詳細については、カスタマーサクセスマネージャーまでお問い合わせください。
手順 1 から 3 は Databricks アカウントで行い、手順 4 は Kameleoonで行います。Kameleoonは、手順 1 から 3 を Databricks 管理者が実施することを推奨します。 Databricks 連携により、ターゲットキャンペーンとパーソナライズされたユーザー体験のためのデータ取得を簡素化できます。 主なメリット：
  • Databricksのテーブルから作成したオーディエンスを使用して、訪問者をターゲティングできます。
  • Databricksのコンバージョンを、実験結果のゴールメトリクスとして使用できます。
同期頻度：
  • Databricks as a source： 各データインジェスチョンタスクは、作成時に設定した Frequency（例：毎日）で実行されます。Kameleoonは、ゴールのクエリを 1 時間ごとにポーリングし、収集したコンバージョンを 1 日に 1 回実験結果にマージします。データインジェスチョンタスクを参照。
  • Databricks as a destination： Kameleoonは、いずれかの実験が訪問者を表示するたびに、露出イベントを Databricksに送信します。Databricksをデスティネーションとして使用するを参照してください。

​
前提条件

この連携を設定するには、次の情報が必要です。
  • Databricksのパーソナルアクセストークン（PAT）
  • Databricks スキーマを作成し、アクセス権を付与するための適切なアクセス権。

​
セットアップ

​
1. パーソナルアクセストークン（PAT）を作成する

Kameleoonは、パーソナルアクセストークンを使用して Databricks SQL ウェアハウスに認証します。Databricksの service principal を作成し、その service principal 用の PATを作成する必要があります。 service principalを作成したら、Databricks UIの Service Principal 管理ページで確認できる service principalの「Application Id」を使用して、Databricks CLIで PATを生成できます。
トークンは Databricks ワークスペースで作成し、その後 Kameleoonに入力します。完全な手順については、Databricks ドキュメントの パーソナルアクセストークン を参照してください。

​
2. Kameleoon 用のスキーマを作成し、Unity Catalogへのアクセス権を付与する

ソースとデスティネーションの両方について、Databricks SQL ウェアハウスの Permissions 設定で service principalに CAN USEを付与します。Unity Catalogでは、Kameleoonが使用する各カタログへのアクセス権を付与します。
以下のスキーマは Databricks 管理者が作成します。Kameleoonの service principalには、カタログに対する CREATE SCHEMAは必要ありません。
Databricksをソースとして使用する場合
オーディエンスの取り込みには、Kameleoonがポーリングするデータを含むカタログに専用のスキーマを作成します。スキーマ名は kameleoon_configurationにします。Kameleoonは、このスキーマでオーディエンスのスナップショットテーブルを作成、読み取り、削除します。service principalには、このスキーマへのアクセス権のみを付与します。service principalは、ソーステーブルへの書き込みアクセス権を必要としません。
When using Databricks as a destination： Kameleoonのイベントテーブル用に、別のスキーマを作成します。Kameleoonはそこにテーブルを作成し、イベントを挿入します。MODIFYには、テーブルに対する SELECTも必要です。
service principalは、自身が作成したテーブルの所有者となるため、それらのテーブルに追加の権限を付与する必要はありません。イベントテーブルがすでに別の所有者のもとに存在する場合は、それらのテーブルに SELECTと MODIFYを付与してください。以下のスキーマ単位の権限付与は、この専用スキーマ内の現在および将来のイベントテーブルも対象になります。
これらのコマンドの {Service Principal Application Id}は、お使いの service principalのアプリケーション IDに置き換えてください。
必要なカタログで直接クエリを実行する場合は、my_catalog プレフィックスを省略できます。

​
3. データへの読み取りアクセス権を付与する

Databricksをソースとして使用する場合は、オーディエンスとゴールのクエリで使用する顧客のテーブルまたはビューにのみアクセス権を付与します。まず、そのスキーマへのアクセス権を付与します。
次に、必要な各テーブルまたはビューに SELECTを付与します。Kameleoonがスキーマ内の現在および将来のすべてのテーブルとビューを読み取る必要がある場合は、代わりにスキーマに対して付与することもできます。
ビューの場合は、次を使用します。
デスティネーションには、顧客データのスキーマに対する SELECT または MODIFYは必要ありません。オーディエンスの取り込みを行わずにゴールのみを使用する場合、Kameleoonはクエリ結果を読み取るだけで、オーディエンスのスナップショットは作成しません。

​
4. Kameleoonに認証情報を入力する

Kameleoonのプロジェクトの Databricks 連携設定で、Credentials フィールドに入力します。
  • Databricks Server Hostname：Databricks ワークスペースのサーバーホスト名です。
  • HTTP Path：Databricks SQL ウェアハウスへのパスです。
  • Personal Access Token (PAT)：手順 1 で作成したトークンです。
  • PAT expiry timestamp in milliseconds (optional)：トークンの有効期限を、ミリ秒単位の Unix タイムスタンプで指定します。このフィールドは任意で、値はご自身で入力します。
Databricksの認証情報の編集フォーム。サーバーホスト名、HTTP パス、空のパーソナルアクセストークン、任意の PAT 有効期限（ミリ秒単位）のフィールドがあります。
トークンを置き換えるには、Personal Access Token (PAT) フィールドに新しいトークンを入力し、Confirmをクリックします。 保存すると、Kameleoonは認証情報をサマリーカードに表示します。カードには、ホスト名、HTTP パス、PATの有効期限が表示されますが、トークンは表示されません。
保存された Databricks 認証情報のカード。サーバーホスト名、HTTP パス、PAT 有効期限のタイムスタンプを表示し、編集と削除のアイコンがあります。
認証情報を保存したら、実験の露出イベントを Databricksに送信できます。Databricksをデスティネーションとして使用するを参照してください。

​
ネットワークとセキュリティ

Kameleoonは、パーソナルアクセストークンを使用して Databricksに認証します。Kameleoonは IPの許可リストに対応しています。IP アクセスリストを実装する場合は、Kameleoonのアカウントマネージャーにお問い合わせください。承認が必要な Kameleoonの IP リストを提供してもらえます。

​
データリージョン

Kameleoonは、この連携のデータを、お客様アカウントの Kameleoon データリージョン（米国または EU）に保存します。