Snowflakeデータソースの管理 | 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画面で、データソースの名前を確認し、ドロップダウンリストから既存の接続を選択するか、**+**アイコンをクリックして新しい接続を作成します。

新しい接続を構成するには、次の接続詳細を入力します。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: アクセス制御権限を参照してください。
Key-Pair Authentication:
1. Snowflakeデータベース、スキーマ、ウェアハウス、テーブルまたはビューにアクセスするユーザーのユーザー名を入力します。
2. 次の暗号化アルゴリズムのいずれかを使用してキーペアを生成します：RSA-2048, RSA-3072, RSA-4096。
3. 公開キーファイルをダウンロードします。キーは-----BEGIN PUBLIC KEY-----と-----END PUBLIC KEY-----の行の間のテキストのみです。
4. 次のコマンドを使用して、ユーザーに公開キーを割り当てます：
```
ALTER USER your_username
SET RSA_PUBLIC_KEY='your_public_key';
```
  詳細については、Snowflake: Snowflakeユーザーに公開キーを割り当てるを参照してください。
5. キーがユーザーに正しく割り当てられたことを確認するために、キーフィンガープリントをコピーします。手順については、Snowflake: ユーザーの公開キーフィンガープリントを確認するを参照してください。

SaveをクリックしてConnection Configuration画面に戻り、Establish Connectionをクリックします。

Snowflakeに正常に接続した後、Table Selectionドロップダウンリストからデータソーステーブルを選択します。複数のSnowflakeテーブルからデータをインポートする場合は、Snowflakeでビューを作成し、ドロップダウンリストから選択します。詳細については、Snowflake: ビューの概要を参照してください。

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

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

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

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

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

クエリモードは、新しい行、変更された行、またはその両方を検出するために使用されるSnowflakeテーブルまたはビューの列を決定します。

Timestamp + Incrementing（推奨）を選択した場合、新しい行と変更された行を検出するために、タイムスタンプ列と厳密に増加する列の2つの列を選択する必要があります。
TimestampまたはIncrementingを選択した場合、新しい行のみ、または新しい行と変更された行のいずれかを検出するために、列を選択する必要があります。

クエリモードで使用される列の要件についての詳細は、Snowflakeクエリモードについてを参照してください。

クエリを構成します：

Query > Select Columnsセクションで、Tealiumにインポートするテーブルまたはビューの列を選択します。Snowflakeテーブルまたはビューを変更するには、Previousをクリックしてステップ1: Snowflake接続の確立に戻ります。
(オプション)カスタム条件または追加のフィルターを追加するには、SQL WHERE句を含めます。
WHERE句は複数のテーブルからのサブクエリをサポートしていません。複数のSnowflakeテーブルからデータをインポートするには、Snowflakeでビューを作成し、データソース構成でビューを選択します。詳細については、Snowflake: ビューの概要を参照してください。
Test QueryをクリックしてSQLクエリを検証し、結果をプレビューします。
Continueをクリックします。

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

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

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

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

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

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

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

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

ステップ6: まとめ

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

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

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