Skip to content

コネクテッド・ソース

接続されたソースは、BrazeのCDI（Cloud Data Ingestion）機能を使ってデータを直接同期するゼロコピーの代替手段である。接続されたソースがあれば、データウェアハウスに直接クエリを発行して新しいセグメントを作成できる。

接続ソースをBrazeワークスペースに追加したら、Segment ExtensionsでCDIセグメントを作成できる。CDIセグメントを使用すると、（CDIコネクテッドソース経由で利用可能なデータを使用して）独自のデータウェアハウスに直接クエリを実行するSQLを記述し、Braze内でターゲットとなるユーザーグループを作成して管理できる。

このソースでセグメントを作成する詳細については、CDI Segmentsのドキュメントを参照のこと。

接続されたソースを統合する

ステップ 1:リソースをつなぐ

Cloud Data Ingestionの接続ソースは、Braze側とインスタンス側でいくつかのセットアップを必要とする。いくつかのステップはデータウェアハウスで行い、いくつかのステップはBrazeダッシュボードで行う。

データウェアハウス

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

ブレイズのダッシュボード

  1. Brazeダッシュボードで新しい接続ソースを作成する。
  2. 接続されているソースのシンク詳細を設定する。
  3. Brazeダッシュボードで提供された公開鍵を取得する。

データウェアハウス

  1. Brazeダッシュボードの公開鍵を認証用のSnowflakeユーザーに追加する。完了したら、接続されたソースを使用して1つ以上のCDIセグメントを作成できる。
  1. Redshift環境にソースデータと必要なリソースをセットアップする。
  2. Brazeダッシュボードで新しい接続ソースを作成する。
  3. 統合をテストする。
  4. 接続されたソースを使用して、1つ以上のCDIセグメントを作成する。
  1. BigQuery環境でソースデータと必要なリソースをセットアップする。
  2. サービスアカウントを作成し、同期するデータを含む BigQuery のプロジェクトとデータセットへのアクセスを許可します。
  3. Brazeダッシュボードで新しい接続ソースを作成する。
  4. 統合をテストする。
  5. 接続されたソースを使用して、1つ以上のCDIセグメントを作成する。
  1. Databricks 環境でソースデータと必要なリソースをセットアップする。
  2. サービスアカウントを作成し、同期するデータを含む Databricks のプロジェクトとデータセットへのアクセスを許可します。
  3. Brazeダッシュボードで新しい接続ソースを作成する。
  4. 統合をテストする。
  5. 接続されたソースを使用して、1つ以上のCDIセグメントを作成する。

ステップ2:データウェアハウスをセットアップする

まず、データウェアハウス環境にソースデータと必要なリソースをセットアップする。接続ソースは1つまたは複数のテーブルを参照する可能性があるため、Brazeユーザーが接続ソースで使用したいすべてのテーブルの権限を持っていることを確認する。

ステップ 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 の関連ドキュメントを参照してください。

インスタンスUS-01 、US-02 、US-03 、US-04 、US-05 、US-06 、US-07 、これらは関連するIPアドレスである：

  • 23.21.118.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

インスタンスEU-01 とEU-02 、これらは関連するIPアドレスである：

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

ステップ 2.1:ユーザーの作成と権限の付与

1
2
3
4

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

接続ソースが使用するユーザーを作成する。このユーザは、CDI セグメントで使用可能なテーブルのリストを作成したり、新しいセグメントを作成するためにソーステーブルをクエリしたりするために使用される。接続ソースが作成されると、Brazeはソーススキーマ内のユーザーが利用可能なすべてのテーブルの名前と説明を検出する。CDI 連携を複数作成する場合は、スキーマに権限を付与したり、グループを使用して権限を管理したりできます。

スキーマ内のすべてのテーブルにアクセス権を与えるか、特定のテーブルにのみ権限を与えるかを選択できる。Brazeロールがアクセスできるテーブルは、CDIセグメントでクエリーできる。新しいテーブルを作成する際には、必ずそのユーザーにアクセス権を与えるか、そのユーザーにデフォルトのアクセス権を設定する。

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

ステップ 2.2:Braze IP へのアクセスの許可

ファイアウォールや他のネットワークポリシーがある場合は、Redshift インスタンスに Braze ネットワークへのアクセスを許可する必要があります。Braze ダッシュボードの地域に対応する以下の IP からのアクセスを許可します。

また、BrazeがRedshiftのデータにアクセスできるように、セキュリティグループを変更する必要があるかもしれない。以下の IP と Redshift クラスターのクエリに使用するポート (デフォルトは 5439) のインバウンドトラフィックを明示的に許可してください。インバウンドルールが「すべて許可」に設定されている場合でも、このポートで Redshift TCP 接続を明示的に許可する必要があります。さらに、Braze がクラスターに接続するために、Redshift クラスターのエンドポイントがパブリックにアクセス可能であることが重要です。

Redshiftクラスターを一般公開したくない場合は、VPCとEC2インスタンスをセットアップし、sshトンネルを使用してRedshiftデータにアクセスすることができる。詳しくは、AWSを参照のこと：ローカルマシンからプライベートなAamazon Redshiftクラスタにアクセスするには？

インスタンスUS-01 、US-02 、US-03 、US-04 、US-05 、US-06 、US-07 、これらは関連するIPアドレスである：

  • 23.21.118.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

インスタンスEU-01 とEU-02 、これらは関連するIPアドレスである：

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

ステップ 2.1:サービスアカウントの作成と権限の付与

GCP で、Braze がテーブルに接続してデータを読み取るために使用するサービスアカウントを作成します。サービスアカウントには次の権限が必要です。

  • BigQuery 接続ユーザー:これでブレイズはコネクションを作ることができる。
  • BigQuery ユーザー:クエリの実行、データセットメタデータの読み取り、およびテーブルの一覧表示を行うためのアクセスを Braze に提供します。
  • BigQuery データビューアー:データセットとその内容を表示するためのアクセスを Braze に提供します。
  • BigQuery ジョブユーザー:これにより、ジョブを実行するためのBrazeへのアクセスが可能になる。
  • bigquery.tables.create これによりBrazeは、セグメント更新時に一時テーブルを作成するためのアクセスを提供する。

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

データセット内のすべてのテーブルにアクセス権を与えるか、特定のテーブルだけに権限を与えるかを選択できる。Brazeロールがアクセスできるテーブルは、CDIセグメントでクエリーできる。

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

サービスアカウントを作成して権限を付与したら、JSON キーを生成します。詳しくは、Google Cloudを参照のこと：サービス・アカウント・キーの作成と削除.これを後でBrazeのダッシュボードにアップロードする。

ステップ 2.2:Braze IP へのアクセスの許可

ネットワークポリシーを設定している場合は、Braze に Big Query インスタンスへのネットワークアクセスを許可する必要があります。Braze ダッシュボードの地域に対応する以下の IP からのアクセスを許可します。

インスタンスUS-01 、US-02 、US-03 、US-04 、US-05 、US-06 、US-07 、これらは関連するIPアドレスである：

  • 23.21.118.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

インスタンスEU-01 とEU-02 、これらは関連するIPアドレスである：

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

ステップ 2.1:アクセストークンの作成

Braze が Databricks にアクセスするには、パーソナルアクセストークンを作成する必要があります。

  1. Databricks ワークスペースで、上部バーにある Databricks ユーザー名をクリックし、ドロップダウンから [ユーザー設定] を選択します。
  2. サービス・アカウントが、接続されたソースに使用されているスキーマでCREATE TABLE 権限を持っていることを確認する。
  3. [アクセストークン] タブで、[新しいトークンの生成] をクリックします。
  4. 「Braze CDI」など、このトークンの識別に役立つコメントを入力し、[有効期間 (日)] ボックスを空 (空白) のままにして、トークンの有効期間を有効期間なしに変更します。
  5. [生成] をクリックします。
  6. 表示されたトークンをコピーして、[完了] をクリックします。

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

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

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

認証情報の作成ステップで Braze ダッシュボードへの入力が必要になるまで、トークンを安全な場所に保管してください。

ステップ 2.2:Braze IP へのアクセスの許可

ネットワークポリシーを設定している場合は、Brazeに Databricks インスタンスへのネットワークアクセスを許可する必要があります。Braze ダッシュボードの地域に対応する以下の IP からのアクセスを許可します。

インスタンスUS-01 、US-02 、US-03 、US-04 、US-05 、US-06 、US-07 、これらは関連するIPアドレスである：

  • 23.21.118.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

インスタンスEU-01 とEU-02 、これらは関連するIPアドレスである：

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

ステップ 3:Brazeダッシュボードで接続ソースを作成する。

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

次に、Brazeダッシュボードで接続ソースを作成する。Data Settings>Cloud Data Ingestionに進む。Connected Sources」タブに移動し、「Create data connection」をクリックする。

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

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

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

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

ステップ3.3：公開鍵に注意

Test connectionページで、RSA公開鍵が表示される。これをメモしておこう。Snowflakeで統合を完了させる必要がある。

ステップ 4:データウェアハウスの構成を確定する

最後のステップで記した公開鍵をSnowflakeのユーザーに追加する。これでBrazeはSnowflakeに接続できるようになる。この方法の詳細については、Snowflakeのドキュメントを参照のこと。

鍵をローテーションしたい場合は、Brazeが新しい鍵ペアを生成し、新しい公開鍵を提供する。

1

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

Snowflakeでユーザーにキーを追加したら、BrazeでTest Connectionを選択し、Doneを選択する。これで接続ソースが作成され、CDIセグメントで使用する準備が整った。

ステップ4.1：Redshift の接続情報とソーステーブルの追加

Data Settings>Cloud Data Ingestionに進む。Connected Sources」タブに移動し、「Create data connection」をクリックする。

Redshiftアカウントとソース・スキーマの情報を入力し、次のステップに進む。

ステップ4.2：同期の詳細の設定

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

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

ステップ4.3：テスト接続

BrazeのTest Connectionを選択し、ユーザーに見えるテーブルのリストが期待通りであることを確認し、Doneを選択する。これで接続ソースが作成され、CDIセグメントで使用する準備が整った。

ステップ4.1：BigQueryの接続情報とソースデータセットを追加する

JSONキーをアップロードし、サービスアカウント名を指定し、ソースデータセットの詳細を入力する。

ステップ4.2：同期の詳細の設定

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

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

ステップ4.3：テスト接続

BrazeのTest Connectionを選択し、ユーザーに見えるテーブルのリストが期待通りであることを確認し、Doneを選択する。これで接続ソースが作成され、CDIセグメントで使用する準備が整った。

ステップ4.1：Databricksの接続情報とソースデータセットを追加する

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

ステップ4.2：同期の詳細の設定

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

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

ステップ4.3：テスト接続

BrazeのTest Connectionを選択し、ユーザーに見えるテーブルのリストが期待通りであることを確認し、Doneを選択する。これで接続ソースが作成され、CDIセグメントで使用する準備が整った。

追加の統合またはユーザーを設定する（オプション）

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

同じユーザーとロールを統合間で再利用する場合、公開鍵を再度追加する必要はない。

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

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

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

接続されたソースを使用する

ソースが作成されると、それを使用して1つまたは複数のCDIセグメントを作成することができる。このソースでセグメントを作成する詳細については、CDI Segmentsのドキュメントを参照のこと。

  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!