接続されたソース

データウェアハウスで次を行います。

1. ロールを作成し、スキーマ内のテーブルのクエリと作成の権限を付与する。
2. 倉庫を設定し、そのロールにアクセス権を与える。
3. そのロールのユーザーを作成する。
4. 設定によっては、Snowflake ネットワークポリシーで Braze IP を許可する必要があります。

Braze ダッシュボードで次を行います。

5. Braze ダッシュボードで接続されたソースを新規作成する。
6. 接続されたソースの同期の詳細を設定する。
7. Braze ダッシュボードで提供された公開鍵を取得する。

データウェアハウスで次を行います。

8. Braze ダッシュボードの公開鍵を認証用の Snowflake ユーザーに追加する。完了したら、接続されたソースを使用して1つ以上のCDIセグメントを作成できる。

ステップ 2.1:ロールを作成し、権限を付与する

接続ソースが使用するロールを作成する。このロールは、CDI セグメントで使用可能なテーブルのリストを生成したり、新しいセグメントを作成するためにソーステーブルをクエリしたりするために使用される。接続ソースが作成されると、Brazeはソーススキーマ内のユーザーが利用可能なすべてのテーブルの名前と説明を検出する。

スキーマ内のすべてのテーブルにアクセス権を与えるか、特定のテーブルにのみ権限を与えるかを選択できる。Braze ロールがアクセスできるテーブルは、CDI セグメントでクエリすることができます。

Braze でセグメントを更新する前に、Braze が CDI セグメントのクエリ結果を使用してテーブルを作成できるようにするには、create table 権限が必要です。Brazeはセグメントごとに一時テーブルを作成し、そのテーブルはBrazeがセグメントを更新している間だけ持続する。

1
2
3
4
5
6
7
8
9
10
11
12
13
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 CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

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

1
2
3
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

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

1
2
3
CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Brazeと接続情報を共有し、後のステップでユーザーに付加する公開鍵を受け取る。

ステップ 2.4:Snowflake ネットワークポリシー内で Braze IP を許可する (省略可)

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

• united states (us)
• european union (eu)

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

Brazeダッシュボードで接続ソースを作成する。[データ設定] > [クラウドデータ取り込み] > ［接続されたソース] の順に移動し、［新しいデータ同期を作成] > ［Snowflake のインポート] を選択します。

Snowflakeデータウェアハウスとソーススキーマの情報を入力し、次のステップに進む。

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

接続するソースの名前を選択する。この名前は、新しい CDI セグメントの作成時に使用可能なソースのリストで使用されます。

このソースの最大ランタイムを設定する。Brazeは、セグメントを作成または更新する際に、最大実行時間を超えるクエリは自動的に中止する。許容される最大実行時間は 60 分です。実行時間を短くすると、Snowflake アカウントに課金されるコストが削減されます。

ステップ3.3：公開鍵を書き留める

[テスト接続] ステップに表示されている RSA 公開鍵をメモします。Snowflakeでの統合を完了させるために必要だ。

最後の手順で書き留めた公開鍵を Snowflake のユーザーに追加します。これで Braze は、Snowflake に接続できるようになります。この方法の詳細については、Snowflake のドキュメントを参照してください。

任意の時点で鍵のローテーションを行う場合は、新しい公開鍵を作成できます。このためには、［クラウドデータ取り込み] の ［データアクセス管理] に移動し、該当するアカウントの ［新しいキーを生成] を選択します。

1
ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

Snowflake でユーザーに鍵を追加したら、Braze で [テスト接続] を選択し、[完了] を選択します。これで接続ソースが作成され、CDIセグメントで使用する準備が整った。

Brazeと複数の統合を設定することができるが、各統合は異なるスキーマを接続するように設定する必要がある。追加の接続を作成する際、同じ Snowflake アカウントに接続する場合は既存の認証情報を再利用できます。

同じユーザーとロールを統合間で再利用する場合、公開キーを再度追加する必要はありません。