コンテンツにスキップ

Databricks OpenSharing

Databricks OpenSharing(旧称 Delta Sharing)を使用すると、Brazeのライブのエンゲージメントデータとキャンペーンデータをお客様のDatabricks環境に安全に共有できます。この記事では、データプロバイダーであるBrazeから受信者であるお客様のDatabricksアカウントへの共有の仕組みと、共有テーブルをクエリする方法について説明します。

Databricks OpenSharingはBraze Data Distributionの一部です。Data Distributionのオプションの概要については、Data Distributionを参照してください。

前提条件

要件 説明
Braze ワークスペースの権限 データ共有を表示するにはCurrents 連携の表示権限が必要です。Databricks 共有を作成、更新、削除するにはCurrents 連携の編集権限が必要です。

Databricks OpenSharingを設定する

Databricksでは、データ共有はデータプロバイダーとデータ受信者の間で行われます。Brazeアカウントは共有を作成して送信するためデータプロバイダーとなり、Databricksアカウントは共有を利用してクエリ可能なカタログを作成するためデータ受信者となります。詳細については、Databricksのドキュメントreading data shared using Databricks-to-Databricks OpenSharing (for recipients)を参照してください。

ステップ1: Brazeから共有を設定する

  1. Brazeでパートナー連携 > ダイレクトデータ共有に移動し、新規作成 > Databricks OpenSharingを選択します。
  2. Databricks共有識別子を入力します。
  3. 完了したら、データシェアを作成を選択します。BrazeがDatabricksアカウントに共有を送信します。

ステップ2: Databricksでカタログを作成する

  1. 数分後、Databricksアカウントで受信共有を受け取ります。
  2. 受信共有を使用してカタログを作成し、テーブルを表示してクエリを実行します。以下に例を示します。

     CREATE CATALOG [IF NOT EXISTS] <catalog-name> USING SHARE braze.<share-name>;
    
  3. 適切なユーザーとグループが新しいカタログにクエリを実行できるように、権限を付与します。

使用状況と可視化

Currentsと同様に、Databricks OpenSharingを使用して次のことができます。

  • 複雑なレポートの作成
  • アトリビューションモデリングの実行
  • 社内での安全な共有
  • 未加工のイベントデータやユーザーデータをCRM(Salesforceなど)にマッピング
  • その他多数

Databricksで利用可能なテーブルと列の完全なリストについては、Databricks の生テーブルスキーマをダウンロードしてください(テキストファイル形式)。このファイルはDatabricks OpenSharingのスキーマを反映しています(たとえば、取り込み時刻を表すDB_CREATED_AT)。このファイルは、Snowflakeの命名規則とフィールドを記載したSnowflake の生テーブルスキーマやSQL テーブルリファレンスとは互換性がありません。

ユーザー ID スキーマ

ユーザー IDに関するBrazeとDatabricksの命名規則には、次の違いがあります。

Braze スキーマ Databricks スキーマ 説明
braze_id USER_ID Brazeが自動的に割り当てる一意の識別子。
external_id EXTERNAL_USER_ID Brazeで設定するユーザープロファイルの一意の識別子。

制限事項と考慮事項

破壊的変更と非破壊的変更

非破壊的変更

非破壊的変更はいつでも発生する可能性があり、通常は追加の機能を提供します。非破壊的変更の例は次のとおりです。

  • 新しいテーブルまたはビューの追加
  • 既存のテーブルまたはビューへの列の追加

破壊的変更

可能な場合、破壊的変更の前には事前のお知らせと移行期間が設けられます。破壊的変更の例は次のとおりです。

  • テーブルまたはビューの削除
  • 既存のテーブルまたはビューからの列の削除
  • 既存の列の型または NULL 許容性の変更

保持ポリシー

対応する USERS_*_SHARED ビューでは、各イベントについて直近2年分のデータをクエリできます。

一般データ保護規則 (GDPR) への準拠

Braze に保管されているほぼすべてのイベントレコードには、ユーザーの個人を特定できる情報 (PII) を表すいくつかのフィールドが含まれています。一部のイベントには、メールアドレス、電話番号、デバイスID、言語、性別、および位置情報が含まれる場合があります。ユーザーの削除依頼がBrazeに送信された場合、これらのユーザーに属するイベントのPIIフィールドを無効化します。この方法では、イベントの履歴レコードは削除されませんが、イベントが特定の個人に結び付けられることは一切ありません。

共有データのクエリ:TIME とクエリのパフォーマンス

データ共有ビュー (USERS_BEHAVIORS_CUSTOMEVENT_SHARED など) のイベントデータは、TIME フィールドでクラスタリングされています。イベントの発生日時でフィルタリングする場合は、TIME をフィルターとして使用することをお勧めします。クラスタリングはイベント時刻に合わせて行われるため、TIME を使用して行を絞り込むクエリは、通常 DB_CREATED_AT でフィルタリングするクエリよりもパフォーマンスが高くなります。

フィールド 意味
TIME イベントが発生した時刻の Unix タイムスタンプ。発生時刻でフィルタリングする場合はこちらを優先して使用してください。
DB_CREATED_AT 行が Databricks に読み込まれた時刻 (取り込み時刻) のタイムスタンプ。

クエリの速度、パフォーマンス、コスト

データに対して実行するクエリの速度、パフォーマンス、コストは、使用する SQL ウェアハウスのサイズによって異なります。アクセスするデータ量によっては、クエリを正常に完了させるために、より大きなウェアハウスが必要になる場合があります。詳しくは、SQL ウェアハウスの作成と設定に関する Databricks のドキュメント (クラスターサイズとスケーリングを含む) を参照してください。

New Stuff!