Snowflakeクラウドデータソース

クラウドデータソースの構成に関する一般的な概要については、クラウドデータソースの管理を参照してください。

ユーザーロール

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

詳細については、Snowflake: カスタムロールおよびSnowflake: アクセス制御権限を参照してください。

データタイプ

Snowflakeデータソースは、すべてのSnowflakeデータタイプをサポートしています。データが正しくインポートされるように、以下のガイドラインに従ってSnowflakeデータタイプをマッピングしてください：

Snowflakeデータタイプの詳細については、Snowflake: データタイプの概要を参照してください。

接続の作成

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: アクセス制御権限を参照してください。

認証

RSAキーペアを使用してSnowflake接続を認証する方法は3つあります：

• 新しいキーペアを生成するTealium。
• プライベートキーファイルをアップロードするTealium以外で生成したもの。
• 既存のキーペアを再利用するTealiumで以前に生成またはアップロードしたもの。

いずれの場合も、指定されたテーブルまたはビューにアクセスが必要なSnowflakeユーザーアカウントに対応する公開キーを割り当てる必要があります。

セキュリティ要件に基づいて、次のキーアルゴリズムから選択します：RSA-2048、RSA-3072、またはRSA-4096。

認証を構成する手順

1. ユーザー名：必要なデータベース、スキーマ、ウェアハウス、およびテーブルまたはビューにアクセスするSnowflakeユーザーのユーザー名を入力します。

2. 認証：次のいずれかの資格情報オプションを選択します：

   • 新しいキーペアを生成：RSAアルゴリズムを選択します。Tealiumはプライベートキー（一度だけ表示）と公開キーを表示します。キーをダウンロードして安全に保管してください。
   • プライベートキーファイルをアップロード：既存のプライベートキーファイルをアップロードします。ファイルが暗号化されている場合は、それを解除するためのパスフレーズを入力します。
   • 既存のキーを再利用：既存の生成されたキーとアップロードされたキーからキーを選択します。関連する公開キーが正しいSnowflakeユーザーにすでに割り当てられていることを確認します。

3. ダウンロード：公開キーファイルをダウンロードします。キーは-----BEGIN PUBLIC KEY-----と-----END PUBLIC KEY-----の間のテキストのみです。

4. 割り当て：次のSQLコマンドでSnowflakeユーザーに公開キーを割り当てます：

   ALTER USER your_username
   SET RSA_PUBLIC_KEY='your_public_key';
   

   詳細については、Snowflake: Snowflakeユーザーに公開キーを割り当てるを参照してください。

5. （オプション）キーが正しく割り当てられたことを確認するために、キーのフィンガープリントをコピーします。Snowflake: ユーザーの公開キーフィンガープリントを確認するを参照してください。

Snowflakeに接続した後、テーブル選択リストからデータソーステーブルを選択します。

クエリ構成

一般的な概要については、クラウドデータソースについてを参照してください。

タイムスタンプ + インクリメントおよびタイムスタンプクエリモードの場合、選択されたタイムスタンプ列は次のいずれかのSnowflakeデータタイプでなければなりません：TIMESTAMP_LTZ、TIMESTAMP_TZ、またはTIMESTAMP_NTZ。

詳細については、Snowflake: 日付および時間データタイプを参照してください。

インクリメントクエリモードの場合、選択された数値列は、追加されるたびに値が増加する必要があります。自動インクリメント列の推奨定義は次のとおりです：

COL1 NUMBER AUTOINCREMENT START 1 INCREMENT 1