Snowflake データソースの管理
この記事では、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 データベーススキーマの名前。
- 接続ロール: Snowflake でユーザーに割り当てられたロール。このロールは
USAGE
権限を持つ必要があります。詳細については、Snowflake: カスタムロール および Snowflake: アクセス制御権限 を参照してください。 - ユーザー名 と パスワード: Snowflake データベース、スキーマ、ウェアハウス、テーブルまたはビューに接続するために使用するユーザー名とパスワード。
- 保存 をクリックします。
- 接続構成 画面で、Snowflake アカウントのパスワードを入力し、接続を確立 をクリックします。
- Snowflake に正常に接続した後、テーブル選択 ドロップダウンリストからデータソーステーブルを選択します。複数の Snowflake テーブルからデータをインポートするには、Snowflake でビューを作成し、ドロップダウンリストからそれを選択します。詳細については、Snowflake: ビューの概要 を参照してください。
- Snowflake データソースがすぐに処理を開始するようにするには、処理を有効にする をオンにします。
- 次へ をクリックします。
ステップ 2: クエリ構成の選択
クエリ構成 画面で、Snowflake テーブルまたはビューに適したクエリモードを選択します。
タイムスタンプ または 増分 を選択すると、新規および変更された行または新規行のみを検出するために使用する列の名前を1つリストにする必要があります。タイムスタンプ + 増分 を選択すると、新規および変更された行を検出するために、タイムスタンプ列と厳密に増分する列の2つの列をリストにする必要があります。
詳細については、Snowflake データソースについて > クエリ構成 を参照してください。
完了したら、次へ をクリックします。
ステップ 3: SQL クエリの構成
-
クエリ > 列の選択 セクションで、Tealium にインポートするテーブルまたはビューの列を選択します。Snowflake テーブルまたはビューを変更するには、戻る をクリックして ステップ 1: Snowflake 接続の確立 に戻ります。
-
(オプション) カスタム条件や追加のフィルターを追加するには、SQL
WHERE
句を含めます。WHERE
句は、複数のテーブルからのサブクエリをサポートしていません。複数の Snowflake テーブルからデータをインポートするには、Snowflake でビューを作成し、データソース構成でビューを選択します。詳細については、Snowflake: ビューの概要 を参照してください。 -
クエリをテスト をクリックして、SQL クエリを検証し、結果をプレビューします。
-
次へ をクリックします。
ステップ 4: 列のマッピング
列マッピングテーブルを使用して、事前に構成された列ラベルをイベント属性にマッピングするか、マッピングのための列ラベルを手動で入力します。Snowflake からの各行はイベントとして処理されます。イベント属性にマッピングされていない列は無視されます。
各列ラベルに対して、ドロップダウンリストから対応するイベント属性を選択します。
完了したら、続行 をクリックします。
ステップ 5: 訪問 ID 属性のマッピング
AudienceStream で Snowflake データを使用するには、データを訪問 ID 属性にマッピングします。訪問 ID を表すマッピングされたイベント属性を選択し、それを対応する訪問 ID 属性にマッピングします。
AudienceStream の訪問 ID マッピング はデフォルトで有効になっています。訪問 ID マッピングを無効にすると、訪問のスティッチングでエラーが発生する可能性があります。詳細については、Tealium データソースを使用した訪問識別 を参照してください。
完了したら、次へ をクリックします。
ステップ 6: サマリー
この最終ステップでは、サマリーを表示し、必要な修正を行い、プロファイルを保存して公開します。構成を編集するには、変更を加えたいステップに戻るために 戻る をクリックします。
- イベント属性と訪問 ID マッピングを表示します。
- 作成 をクリックしてデータソースを作成し、構成画面を終了します。新しいデータソースは、データソース ダッシュボードに表示されます。
- 保存/公開 をクリックして変更を保存し、公開します。
インポート活動の状況を確認するには、データソース ダッシュボードに移動し、データソースを展開します。
Snowflake データソースの編集
Snowflake データソースを変更するには、データソース ダッシュボードに移動し、変更したい構成の横にある編集アイコンをクリックします。接続の編集 画面から、Snowflake 接続、クエリ、マッピング構成を編集できます。
最終更新日 :: 2024年August月21日