データウェアハウスの連携

1. Snowflake インスタンスで、Braze と同期するテーブルまたはビューを設定します。
2. Braze ダッシュボードで新しい連携を作成します。
3. Braze ダッシュボードに表示された公開キーを取得し、認証用として Snowflake ユーザーに公開キーを追加します。
4. 連携のテストを行い、同期を開始します。

ステップ 1: テーブルの設定

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required  
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216),
     --If you include both email and phone, we will use the email as the primary identifier
     EMAIL VARCHAR(16777216),
     PHONE VARCHAR(16777216),
     PAYLOAD VARCHAR(16777216) NOT NULL
);

データベース、スキーマ、テーブルには任意の名前を付けることができますが、列名は先行する定義と一致する必要があります。

• UPDATED_AT - テーブルで、この行が更新された時刻、または追加された時刻。最後の同期以降に追加されたか、更新された行のみを同期します。
• ユーザー識別子の列。テーブルには、ユーザー識別子列が 1 列以上含まれている場合があります。各行は、識別子 (external_id 単独か、alias_name と alias_label または braze_id の組み合わせ) を 1 つのみ含まなければなりません。ソーステーブルには、1 つ、2 つ、または 3 つすべての識別子タイプの列が含まれる場合があります。
  • EXTERNAL_ID - 更新対象のユーザーを特定します。これは Braze で使用されている external_id 値と一致しなければなりません。
  • ALIAS_NAME および ALIAS_LABEL - この 2 列はユーザーエイリアスオブジェクトを作成します。alias_name は一意の識別子である必要があり、alias_label はエイリアスのタイプを指定します。ユーザーは、異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに alias_name を 1 つしか持つことができません。
  • BRAZE_ID - Braze のユーザー識別子。これは Braze SDK によって生成されます。クラウドデータ取り込み経由で Braze ID を使用して新規ユーザーを作成することはできません。新規ユーザーを作成するには、外部ユーザー ID またはユーザーエイリアスを指定します。
  • EMAIL - ユーザーのメールアドレス。同じメールアドレスを持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。メールと電話の両方が指定された場合は、メールをプライマリ識別子として使用します。
  • PHONE - ユーザーのメールアドレス。同じ電話番号を持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。
• PAYLOAD - Braze 内のユーザーと同期するフィールドの JSON 文字列。

ステップ 2: ロールとデータベース権限の設定

```json CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE; GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE; GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE; ```

必要に応じて名前を更新します。ただし、権限は前述の例と一致する必要があります。

ステップ 3: ウェアハウスの設定と、Braze ロールへのアクセス権の付与

```json CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE; ```

ステップ4: ユーザーの設定

```json CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER; ```

このステップの後、Braze と接続情報を共有し、ユーザーに追加する公開キーを受け取ります。

ステップ 5: Snowflake ネットワークポリシー内で Braze IP を許可 (任意)

Snowflake アカウントの設定によっては、Snowflake のネットワークポリシー内で以下の IP アドレスを許可する必要があります。これを有効にする方法の詳細については、ネットワークポリシーの変更に関する Snowflake の関連ドキュメントを参照してください。

[パートナー連携] > [テクノロジーパートナー] に移動します。Snowflake のページを見つけて、[新しいインポート同期を作成] をクリックします。

ステップ 1: Snowflake の接続情報とソーステーブルの追加

Snowflake データウェアハウスとソーステーブルの情報を入力して、次のステップに進みます。


ステップ 2: 同期の詳細の設定

次に、同期の名前を選択し、連絡先のメールアドレスを入力します。この連絡先情報は、テーブルへのアクセスが予期せず削除されたなど、連携エラーの通知に使用されます。

連絡先のメールアドレスは、テーブルや権限の欠落など、グローバルまたは同期レベルのエラーの通知のみを受け取ります。行レベルの問題を受け取ることはありません。グローバルエラーは、同期の実行を妨げる接続の重大な問題を示します。このような問題として、次のようなものがあります。

• 接続の問題
• リソース不足
• 権限の問題
• (カタログ同期のみ) カタログ層の容量不足


データ型と同期頻度も選択します。頻度の範囲は 15 分間隔から 1 か月に 1 回までです。Braze ダッシュボードで設定したタイムゾーンを使用して、定期的な同期がスケジュールされます。サポートされているデータ型は、カスタム属性、カスタムイベント、および購入イベントです。同期のデータ型は、作成後に変更できません。

Braze ユーザーへの公開キーの追加

この時点で、Snowflake に戻って設定を完了する必要があります。ダッシュボードに表示されている公開キーを、Snowflake に Braze を接続するために作成したユーザーに追加します。

その方法の詳細については、Snowflake のドキュメントを参照してください。任意の時点でのキーのローテーションを行う場合、新規のキーペアを生成して、新規の公開キーを提供できます。

1
ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='Braze12345...';

Braze ダッシュボードに戻って、[テスト接続] をクリックします。成功すると、データのプレビューが表示されます。何らかの理由で接続できない場合、問題のトラブルシューティングに役立つエラーメッセージが表示されます。


Braze との連携を複数設定することもできますが、各連携で異なるテーブルを同期するように設定する必要があります。追加の同期を作成するときに Snowflake アカウントに接続している場合は、既存の認証情報を再利用できます。


複数の連携にわたって同じユーザーとロールを再利用する場合、公開キーを追加するステップを再び行う必要はありません。

同期をアクティブにすると、設定時に指定したスケジュールで同期が実行されます。通常のテストスケジュール以外で同期を実行する場合や、最新データを取得する場合には、[今すぐ同期する] をクリックします。この実行は、定期的にスケジュールされている将来の同期には影響しません。