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

スイート

Customer Experience Employee Experience Strategy & Research

製品

Qualtrics

このページの内容

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

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

注意: クアルトリクスはSNOWFLAKEからエンコードされたファイルを取り込むことはできません。

例: 例えば、Snowflakeにカスタマーデータが保存されている場合、そのデータをクアルトリクスにインポートしてダッシュボードで表示したり、アンケートに回答する際の回答者のエクスペリエンスにデータを使用したりすることができます。

Qtip:ETLワークフローに適用される一般的な制限については、ワークフローの制限を参照してください。タスク固有の制限については、このページの情報を参照のこと。

Snowflakeとの統合

このタスクを使用するには、Snowflakeで新しいインテグレーションを作成し、クアルトリクスに接続する必要があります。

スノーフレークでのセットアップ

Snowflakeにログインする。

ワークシート・タブでプラス記号(+)をクリックし、SQLワークシートを選択します。

以下のコードをワークシートに貼り付ける：


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

太字のQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 行を統合の名前に置き換えます。統合名にはアルファベット、数字、アンダースコアのみを使用してください。

Qtip:統合名をコピーしてください。後でセットアップを完了する際に必要になります。Snowflakeは、統合名のすべての文字を自動的に大文字にします。例えば、統合に “Qualtrics_Integration “という名前を付けると、Snowflakeでは “QUALTRICS_INTEGRATION “として保存されます。これは後のために取っておくべき名前だ。

太字のpublicapist 3をブランドに関する情報に置き換える。この情報は、ワークフロー自体で個別の接続を設定するか、管理タブでアカウント全体の接続を設定するかによって異なります。

個別の接続を作成する場合は、これをあなたのブランドIDに置き換えてください。
例: 私のブランドIDが “dsx “である場合、私の更新値はhttps://dsx.qualtrics.com/oauth-client-service/redirect’である。
アカウント全体の接続を作成する場合は、これをデータセンターIDに置き換えてください。
例：datacenterIDが “iad1 “の場合、更新された値はhttps://iad1.qualtrics.com/oauth-client-service/redirect’です。

実行をクリックする。

Integration ‘Name of Integration’ successfully created」というメッセージが表示されます。

Qtip:“insufficient privileges “エラーが表示された場合は、Snowflakeのパーミッションを更新する必要があります。必要なパーミッションの詳細については、このSnowflakeのサポートページを参照してください。

同じワークシートに以下のコードを入力する： セキュリティの統合について説明するname_of_security_integration

太字のINTEGRATION NAME_OF_SECURITY_INTEGRATIONを、ステップ4の大文字の統合名に置き換えます。

実行をクリックする。

統合に関するさまざまな情報が表示されます。以下のフィールドの値をコピーする：

oauth_authorization_endpoint
oauth_token_endpoint
oauth_client_id

同じワークシートに以下のコードを入力する： select system$show_oauth_client_secrets('name_of_security_integration')

太字のNAME_OF_SECURITY_INTEGRATIONを 、ステップ4の大文字の統合名に置き換えます。

実行をクリックする。

クライアントシークレットの値の1つをコピーします。

クアルトリクスでの設定

ブランド全体の接続（つまり、クアルトリクスライセンスの全ユーザーが利用可能なSnowflakeアカウント）を作成する場合は、次のページに移動します。 拡張機能 セクションの管理タブを開き、Extract data from Snowflakeintegrationを検索します。

個別の接続（つまり、自分だけが利用できるスノーフレークアカウント）を作成する場合は、次の場所に移動します。 ワークフロー を作成し、新しいETLワークフローを作成します。抽出タスクを選択する際、Extract data from Snowflakeタスクを選択します。

管理者］タブの場合は［アカウントの追加 ］を、ワークフロータスクの場合は［ユーザーアカウントの追加］をクリックします。残りのステップは、どこでアカウント設定を行うかにかかわらず同じです。

アカウントに名前を付けておくと、後で識別できます。

補助金タイプで認証コードを選択します。

認証情報を入力してください：

クライアントID：Snowflakeのセットアップのステップ10でコピーしたOAUTH_CLIENT_ID。
クライアントシークレット：SnowflakeのSetupのステップ14でコピーしたCLIENT_SECRET。
トークンのエンドポイント：Snowflakeのセットアップのステップ10でコピーしたOAUTH_TOKEN_ENDPOINT 。URLにアンダースコア（_）がある場合は、ハイフン（–）に置き換えてください。
認証エンドポイント：SnowflakeのSetupのステップ10でコピーしたOAUTH_AUTHORIZATION_ENDPOINT 。URLにアンダースコア（_）がある場合は、ハイフン（ –）に置き換えてください。
スコープ （オプション）：スコープを使用して、アクセスレベルを制限することができます。ほとんどの場合、この項目は空白のままでよい。

［アカウントを接続］をクリックします。

Snowflakeにログインするためのウィンドウが開きます。スノーフレークのユーザー名とパスワードを入力してください。

サインインをクリックしてください。

SNOWFLAKE コネクションのリフレッシュ

ワークフローエラーでSNOWFLAKE認証情報の有効期限が切れていると表示された場合は、以下の手順でクアルトリクスで認証情報を更新することができます：

拡張機能のアカウントを編集します。個人のSNOWFLAKEアカウントであれば、ワークフローエディターでSnowflakeタスクをクリックして行います。ブランド全体のアカウントであれば、管理者タブでこれを行います。残りの手順は同じである。

資格情報ウィンドウの下部にある「保存」をクリックします。

Snowflakeにログインするためのタブが開きます。スノーフレークのユーザー名とパスワードを入力してください。ログイン後、接続が更新されます。

Qtip:デフォルトでは、SNOWFLAKE接続は90日後に失効します。SNOWFLAKEサポートに連絡して、この値を上げるようにリクエストすることができます。

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

リンク先の手順に従って、新しいETLワークフローを作成します。

ワークフロータスクには、Snowflakeタスクからデータを抽出を選択します。

先ほど接続したSnowflakeアカウントを選択します。

次へをクリックします。

Snowflakeからインポートしたいデータについて、以下の情報を入力します：

ファイル名パターン：インポートするファイルを識別するためのテキスト文字列。
Qtip:インポートするファイルの先頭に「クアルトリクス」と記載することをお勧めします。このフィールドに「クアルトリクス」と入力すると、関連するすべてのファイルをインポートできます。
ピックアップディレクトリ：ファイルを含むSnowflakeディレクトリ。
Qtip:ファイルがベースステージにある場合、このフィールドは空白のままにしておくことができます。
アカウント識別子：インポートするファイルを含むデータベースの Snowflakeアカウント識別子。
データベース識別子：インポートするファイルを含むデータベースのSnowflakeデータベース識別子。
スキーマ識別子：インポートするファイルを含むスキーマの Snowflakeスキーマ識別子。
ステージ名：インポートするファイルを含むSnowflakeステージの名前。