Snowflake データソースの管理 | スノーフレークデータソース

Tealium が選択した Snowflake テーブルまたはビューからのみデータをポーリングするようにするには、データベース、スキーマ、ウェアハウス、接続したいテーブルまたはビューに対する USAGE 権限を持つカスタム Snowflake ロールを作成します。詳細については、Snowflake: カスタムロールおよび Snowflake: アクセス制御権限を参照してください。

Snowflake データソースを作成するには、次の手順を完了します：

Tealium で、Sources > Data Sources に移動します。
+Add Data Source をクリックします。
Categories の下で、Data Warehouse をクリックし、Snowflake を選択します。
Name フィールドに、使用ケースに関連するデータソースの一意の名前を入力します。
Continue をクリックします。

ステップ 1: Snowflake 接続の確立

Snowflake データソースでは、他の Snowflake データソースで再利用できる Snowflake への接続を作成できます。

開始する前に、次の Snowflake アカウント情報を確認しておいてください：

アカウント識別子
アカウント識別子の形式を決定するには、Snowflake ワークスペースに移動し、一意のアカウント URL をコピーします。例えば、Snowflake アカウント URL が
xy12345.us-east-2.aws.snowflakecomputing.com/console#/internal/worksheet
の場合、xy12345.us-east-2.aws.snowflakecomputing.com 部分をアカウント識別子として使用します。詳細については、Snowflake: アカウント識別子を参照してください。
接続ウェアハウス
データベース名
データベーススキーマ
接続ロール
Snowflake ユーザー名とパスワード

Connection Configuration 画面で、データソースの名前を確認します。
ドロップダウンリストから既存の接続構成を選択するか、+ アイコンをクリックして新しい接続を作成します。
新しい接続を作成するには、New Snowflake Connection Configuration 画面で次のアカウント詳細を入力します。Snowflake アカウントの構成により、接続情報は大文字と小文字を区別する場合があります。
- Snowflake Connection Configuration Name: 再利用可能な接続構成の名前を提供します。
- Account Identifier: 次の形式で http:// プレフィックスなしの Snowflake アカウント識別子：
  - Snowflake アカウント名を使用する場合：ACCOUNT_NAME.snowflakecomputing.com。
  - リージョン内の Snowflake アカウントロケータを使用する場合：ACCOUNT_LOCATOR.CLOUD_REGION_ID.CLOUD.snowflakecomputing.com。
- Connection Warehouse: この接続に使用する Snowflake ウェアハウスの名前。
- Database Name: 接続する Snowflake データベースの名前。
- Database Schema: 接続する Snowflake データベーススキーマの名前。
- Connection Role: Snowflake でユーザーに割り当てられたロール。このロールは USAGE 権限を持つ必要があります。詳細については、Snowflake: カスタムロールおよび Snowflake: アクセス制御権限を参照してください。
- Username と Password: Snowflake データベース、スキーマ、ウェアハウス、テーブルまたはビューに接続するために使用するユーザー名とパスワード。
Save をクリックします。
Connection Configuration 画面で、Establish Connection をクリックします。
Snowflake に正常に接続した後、Table Selection ドロップダウンリストからデータソーステーブルを選択します。複数の Snowflake テーブルからデータをインポートするには、Snowflake でビューを作成し、ドロップダウンリストからそれを選択します。詳細については、Snowflake: ビューの概要を参照してください。
Continue をクリックします。

ステップ 2: 処理の有効化

プロファイルを保存して公開した直後から Snowflake データソースの処理を開始したい場合は、Enable Processing をオンにします。

完了したら、Continue をクリックします。

ステップ 3: クエリの構成

Query Mode and Configuration 画面で、Snowflake テーブルまたはビューに適したクエリモードを選択し、必要に応じて SQL WHERE 句を含めて、カスタム条件に一致するレコードのみを処理します。

クエリモードを選択します。
クエリモードは、Snowflake テーブルまたはビューのどの列を使用して新規および/または変更された行を検出するかを決定します。
- Timestamp + Incrementing（推奨）を選択すると、新規および変更された行を検出するために、タイムスタンプ列と厳密に増加する列の2つの列をリストする必要があります。
- Timestamp または Incrementing を選択すると、新規および変更された行または新規行のみを検出するために使用する1つの列の名前をリストする必要があります。
  詳細については、About Snowflake data source > Query modes を参照してください。
クエリを構成します。
1. Query > Select Columns セクションで、Tealium にインポートするテーブルまたはビューの列を選択します。Snowflake テーブルまたはビューを変更するには、Previous をクリックしてステップ 1: Snowflake 接続の確立に戻ります。
2. （オプション）カスタム条件を追加するか、追加のフィルターを含めるには、SQL WHERE 句を含めます。
  WHERE 句は、複数のテーブルからのサブクエリをサポートしていません。複数の Snowflake テーブルからデータをインポートするには、Snowflake でビューを作成し、データソース構成でビューを選択します。詳細については、Snowflake: ビューの概要を参照してください。
3. Test Query をクリックして、SQL クエリを検証し、結果をプレビューします。
Continue をクリックします。

ステップ 4: 列のマッピング

列マッピングテーブルを使用して、事前に構成された列ラベルをイベント属性にマッピングするか、マッピングのための列ラベルを手動で入力します。Snowflake からの各行はイベントとして処理されます。イベント属性にマッピングされていない列は無視されます。

各列ラベルに対して、ドロップダウンリストから対応するイベント属性を選択します。

完了したら、Continue をクリックします。

ステップ 5: 訪問 ID 属性のマッピング

AudienceStream で Snowflake データを使用するには、データを訪問 ID 属性にマッピングします。訪問 ID を表すマッピングされたイベント属性を選択し、それを対応する訪問 ID 属性にマッピングします。

AudienceStream の訪問 ID マッピング はデフォルトで有効になっています。訪問 ID マッピングを無効にすると、訪問のスティッチングでエラーが発生する可能性があります。詳細については、Tealium データソースを使用した訪問識別を参照してください。

完了したら、Continue をクリックします。

ステップ 6: サマリー

この最終ステップでは、サマリーを表示し、必要な修正を行い、プロファイルを保存して公開します。構成を編集するには、変更を加えたいステップに戻るために Previous をクリックします。

イベント属性と訪問 ID マッピングを表示します。
Finish をクリックしてデータソースを作成し、構成画面を終了します。新しいデータソースは、Data Sources ダッシュボードにリストされます。
Save/Publish をクリックして変更を保存し、公開します。

インポート活動のステータスを確認するには、Data Sources ダッシュボードに移動し、データソースを展開します。

Snowflake データソースの編集

Snowflake データソースを変更するには、Data Sources ダッシュボードに移動し、変更したい構成の横にある編集アイコンをクリックします。Edit Connection 画面から、Snowflake 接続、処理構成、クエリ、マッピング構成を編集できます。