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

WHERE句

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

WHERE句は複数のテーブルからのサブクエリをサポートしていません。複数のSnowflakeテーブルからデータをインポートするには、Snowflakeでビューを作成し、データソース構成でビューを選択します。詳細については、Snowflake: ビューの概要を参照してください。