Snowflake タスクからデータを抽出

Snowflake からデータを抽出タスクについて

Snowflake は、データの保存、管理、共有に使用されるサードパーティのデータクラウドソフトウェアです。Snowflake からデータをインポートして、Qualtrics ワークフローで使用することができます。

Snowflake との統合

このタスクを使用するには、Snowflake で新しい統合を作成し、Qualtrics に接続する必要があります。

Snowflake での設定

1. Snowflake にログインします。
2. ワークシートタブで、プラス記号 (+) をクリックし、SQL ワークシートを選択します。
3. 以下のコードをワークシートに貼り付けます。
   

   
   CREATE SECURITY 
   
   INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect
   
    ENABLED = TRUE
   
    OAUTH_ISSUE_REFRESH_TOKENS = TRUE
   
    OAUTH_REFRESH_TOKEN_VALIDITY = 7776000

4. 太字の QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 行を統合の名称に置き換えます。統合名には文字、数字、およびアンダースコアのみを使用してください。
   
   ヒント：後で設定を完了するために必要なインテグレーション名をコピーします。Snowflake では、統合名内のすべての文字が自動的に大文字になります。たとえば、インテグレーションに「Qualtrics_Integration」という名前を付けると、Snowflake に「QUALTRICS_INTEGRATION」として保存されます。これは後で使用するために保存する必要がある名前です。
5. 太字の publicapist3 をブランドに関する情報に置き換えます。この情報は、ワークフロー自体内で個別の接続を設定するか、[管理] タブでアカウント全体の接続を設定するかによって異なります。
   • 個別の接続を作成する場合は、これを brandID に置き換えてください。
     例：ブランドIDが「dsx」の場合、更新された値は「https://dsx.qualtrics.com/oauth-client-service/redirect」です。
   • アカウント全体の接続を作成する場合は、自分のデータセンタ ID に置き換えてください。
     例：データセンターIDが「iad1」の場合、更新された値は https://iad1.qualtrics.com/oauth-client-service/redirect’
6. 実行をクリックします。
7. “Integration Name of Integration successfully created” というメッセージが表示されます。
   
   ヒント：「権限が不十分」というエラーが表示された場合は、Snowflake のパーミッションを更新する必要があります。必要な権限の詳細については、この Snowflake サポートページを参照してください。
8. 同じワークシートで、以下のコードを入力します。

   ​​​​DESCRIBE SECURITY INTEGRATION NAME_OF_SECURITY_INTEGRATION

9. 太字の INTEGRATION NAME_OF_SECURITY_INTEGRATION をステップ 4 の大文字の統合名に置き換えます。
10. 実行をクリックします。
11. 統合に関するさまざまな情報が表示されます。以下の項目の値をコピーします。
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. 同じワークシートで、以下のコードを入力します。

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('NAME_OF_SECURITY_INTEGRATION')

13. 太字の NAME_OF_SECURITY_INTEGRATION を、ステップ 4 で大文字化した統合名に置き換えます。
14. 実行をクリックします。
15. クライアントシークレットの値の 1 つをコピーします。

Qualtrics での設定

1. ブランド全体の接続（クアルトリクスライセンスのすべてのユーザーが利用できるSnowflakeアカウント）を作成する場合は、 拡張機能 のセクション 管理 タブを選択し、Extract data from Snowflake integration を検索します。
2. 個別の接続 (つまり、自分のみが使用できる Snowflake アカウント) を作成する場合は、に移動します。 ワークフロー 新しい ETL ワークフローを作成します抽出機能タスクを選択するときに、Snowflake からデータを抽出タスクを選択します。
3. 管理タブの場合はアカウント追加をクリックし、ワークフロータスクの場合はユーザアカウントを追加をクリックします。残りのステップは、アカウントの設定場所に関係なく同じです。
   
4. 後で識別できるように、アカウントに名前を付けます。
   
5. 補助金タイプの権限コードを選択します。
6. 権限の詳細を入力します。
   • クライアント ID: Snowflake の設定のステップ 10 でコピーした OAUTH_CLIENT_ID。
   • クライアントシークレット: Snowflake の設定のステップ 14 でコピーした CLIENT_SECRET。
   • トークンエンドポイント: Snowflake の設定のステップ 10 でコピーした OAUTH_TOKEN_ENDPOINT。
   • 権限エンドポイント: Snowflake の設定のステップ 10 でコピーした OAUTH_AUTHORIZATION_ENDPOINT。
   • スコープ (オプション): スコープを使用して、アクセスレベルを制限できます。ほとんどの使用ケースでは、これを空白のままにすることができます。
7. ［アカウントを接続］をクリックします。
8. Snowflake にログインするためのウィンドウが開きます。Snowflake のユーザ名とパスワードを入力します。
9. [サインイン] をクリックします。

Snowflake からのデータ抽出タスクの設定

1. リンクされた指示に従って、新しい ETL ワークフローを作成します。
2. ワークフロータスクで、Snowflake からデータを抽出タスクを選択します。
3. 前に接続した Snowflake アカウントを選択します。
   
4. [次へ] をクリックします。
5. Snowflake からインポートするデータに関する以下の情報を入力します。
   
   • ファイル名のパターン: インポートするファイルを識別するために使用されるテキスト文字列。
     ヒント：インポートするすべてのファイルの先頭に「Qualtrics」を含めることをお勧めします。その後、このフィールドに「Qualtrics」と入力すると、すべての関連ファイルをインポートできます。
   • ピックアップディレクトリ: ファイルを含む Snowflake ディレクトリ。
     ヒント：ファイルが基本段階にある場合は、このフィールドを空白のままにすることができます。
   • 勘定科目 ID: インポートするファイルを含むデータベースの Snowflake 勘定科目 ID。
   • データベース ID: インポートするファイルを含むデータベースの Snowflake データベース ID。
   • スキーマ ID: インポートするファイルを含むスキーマの Snowflake スキーマ ID。
   • ステージ名: インポートするファイルを含む Snowflake ステージの名前。
6. 必要に応じて、Skip bad files を有効にします。有効にすると、ヘッダーに一致しない破損したファイルおよびファイルが無視されます。
7. クアルトリクスにインポートするデータの一般的な形式を含むサンプルファイルをアップロードする必要があります。［ファイルを選択］をクリックし、コンピューター上のファイルを選択します。
   ヒント：必要に応じて、タスクウィンドウ内にリストされたサンプルファイルのいずれかをダウンロードできます。
8. アップロードをクリックします。
9. サンプルファイルをレビューして、すべてが正しいことを確認します。
   ヒント：ファイルを変更する必要がある場合は、左上隅の［戻る］をクリックします。
10. ［保存］をクリックします。
11. データが保存される場所を決定するローダータスクを選択します。使用可能なオプションの詳細については、利用可能なローダタスクを参照してください。