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

BrazeでのDatabricks OpenSharingは、USクラスターおよびEUクラスターでホストされている顧客が利用できます。USクラスターまたはEUクラスターでホストされていない場合は、カスタマーサクセスマネージャーにお問い合わせください。
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から共有を設定する
- Brazeでパートナー連携 > ダイレクトデータ共有に移動し、新規作成 > Databricks OpenSharingを選択します。
- Databricks共有識別子を入力します。
- 完了したら、データシェアを作成を選択します。BrazeがDatabricksアカウントに共有を送信します。
ステップ2: Databricksでカタログを作成する
- 数分後、Databricksアカウントで受信共有を受け取ります。
-
受信共有を使用してカタログを作成し、テーブルを表示してクエリを実行します。以下に例を示します。
CREATE CATALOG [IF NOT EXISTS] <catalog-name> USING SHARE braze.<share-name>;
- 適切なユーザーとグループが新しいカタログにクエリを実行できるように、権限を付与します。

共有データは、Databricksワークスペースでは読み取り専用です。他のデータと同様にクエリを実行できますが、共有を通じて共有テーブルの行を変更または削除することはできません。
使用状況と可視化
Currentsと同様に、Databricks OpenSharingを使用して次のことができます。
- 複雑なレポートの作成
- アトリビューションモデリングの実行
- 社内での安全な共有
- 未加工のイベントデータやユーザーデータをCRM(Salesforceなど)にマッピング
- その他多数
Databricksで利用可能なテーブルと列の完全なリストについては、Databricks の生テーブルスキーマをダウンロードしてください(テキストファイル形式)。このファイルはDatabricks OpenSharingのスキーマを反映しています(たとえば、取り込み時刻を表すDB_CREATED_AT)。このファイルは、Snowflakeの命名規則とフィールドを記載したSnowflake の生テーブルスキーマやSQL テーブルリファレンスとは互換性がありません。

列名と型はSnowflake Data Sharingと異なる場合があります(たとえば、SF_CREATED_ATではなくDB_CREATED_AT)。
ユーザー ID スキーマ
ユーザー IDに関するBrazeとDatabricksの命名規則には、次の違いがあります。
| Braze スキーマ | Databricks スキーマ | 説明 |
|---|---|---|
braze_id |
USER_ID |
Brazeが自動的に割り当てる一意の識別子。 |
external_id |
EXTERNAL_USER_ID |
Brazeで設定するユーザープロファイルの一意の識別子。 |
制限事項と考慮事項
破壊的変更と非破壊的変更
非破壊的変更
非破壊的変更はいつでも発生する可能性があり、通常は追加の機能を提供します。非破壊的変更の例は次のとおりです。
- 新しいテーブルまたはビューの追加
- 既存のテーブルまたはビューへの列の追加

新しい列の追加は非破壊的変更と見なされるため、Braze では SELECT * クエリを使用せず、各クエリで必要な列を明示的に指定することを強くお勧めします。または、列名を明示的に指定したビューを作成し、共有テーブルを直接クエリする代わりにそのビューをクエリしてください。
破壊的変更
可能な場合、破壊的変更の前には事前のお知らせと移行期間が設けられます。破壊的変更の例は次のとおりです。
- テーブルまたはビューの削除
- 既存のテーブルまたはビューからの列の削除
- 既存の列の型または 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 のドキュメント (クラスターサイズとスケーリングを含む) を参照してください。