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

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

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

Tealium で、Sources > Data Sources に移動します。
+データソースを追加 をクリックします。
カテゴリ の下で Data Warehouse をクリックし、Snowflake を選択します。
名前フィールドに、使用ケースに関連するデータソースの一意の名前を入力します。
続行をクリックします。

ステップ 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 ユーザー名とパスワード

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ステップ 6: サマリー

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

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

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

Snowflake データソースの編集

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