SFTP ファイルからのデータ抽出タスク

SFTP ファイルからのデータ抽出タスクについて

［SFTPファイルからデータを抽出］タスクを使用すると、SFTPサーバーからデータをインポートして、クアルトリクスで使用できます。このタスクを使用すると、一度に 1 つまたは複数のファイルのみを処理することができます。このタスクを［XM Directoryにデータを読み込み］タスクなどの他のタスクと組み合わせて、クアルトリクスの他の場所にデータをインポートできます。

SFTP の設定とトラブルシューティングの詳細については、「SFTP トラブルシューティング」を参照してください。

SFTP アカウントの接続

［SFTPファイルからデータを抽出］タスクを使用する前に、クアルトリクスのSFTPアカウントに接続してからデータを抽出する必要があります。アカウントは、ブランド内の他のユーザーが使用するためにブランド管理者が追加することも、個人的に使用するために個々のユーザーが追加することもできます。

以下の 3 つの異なる認証オプションがあります。

• パスワード: ユーザ名とパスワードで認証します。
• SSH キー: 指定したセキュアシェル (SSH) キー、または Qualtrics によって提供されるキーを使用して認証します。
• 暗号化された SSH キー: 暗号化された SSH キーを使用して認証します。

ブランド管理者としてのアカウントの追加

ブランド管理者の場合、このセクションのステップに従って、ライセンスの一部またはすべてのユーザーが使用する SFTPアカウントを追加します。

1. 左上のナビゲーションメニューを使用して、管理に移動します。
   
2. Extensions に移動します。
3. [SFTP ファイルからデータを抽出] 拡張子をクリックします。
4. ［アカウントを追加］をクリックします。
   
5. アカウントに名前を付けます。この名称は組織的な目的で使用され、顧客を識別するために使用されます。
   
6. 関連する SFTP サーバのホスト名を入力します。
   例: 通常、これらは sftp.example.com の形式です。
7. ポート番号を入力します。（通常はQ1です）
8. 認証方法を選択します。オプションは次のとおりです。
   • パスワード: 認証用のユーザ名とパスワードを指定します。
   • SSHキー：認証用のユーザー名とSSHキーを入力するか、クアルトリクスが生成したSSHキーを使用します。
   • 暗号化された SSH キー: 認証用のパスフレーズを含む独自の暗号化 SSH キーを指定します。
9. パスワードを選択した場合は、SFTP アカウントのユーザ名とパスワードを入力します。
   
10. SSH キーで認証する場合は、
    のいずれかを実行します。
    • クアルトリクスによって生成されたSSHキーを使用する場合は、［ユーザー名］を入力し、［SSHキーペアを生成］をクリックします。
      公開鍵 SSH キーのダウンロードをクリックして、公開鍵を .pem ファイルとしてコンピュータにダウンロードすることができます。関連する秘密鍵は Qualtrics によって保存されます。クリップボードにコピーをクリックして、キーのフィンガープリントをクリップボードにコピーします。これらの両方を安全な場所に保存し、必要に応じて参照できるようにします。
    • 独自の SSH キーを使用する場合は、秘密鍵を提供をクリックします。
      次に、ユーザ名および SSH キーを入力します。
      ヒント：このボックスには、パスワードで保護されていない秘密鍵を入力する必要があります。さらに、SFTP サーバで公開鍵を認証する必要があります。
      例:
      SSH キーは、通常 (RSA キー行の開始および終了を含む) のようになります:
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
11. 暗号化された SSH キーで認証する場合は、ユーザ名、暗号化された SSH キー、およびキーに関連付けられたパスフレーズを入力します。
12. 終了したら、［アカウントを接続］をクリックします。

個人ユーザとしてのアカウントの追加

このセクションの手順に従って、個人用の SFTP アカウントを追加します。接続したアカウントを使用できるのは自分だけです。

1. SFTP ファイルからのデータ抽出の設定タスクセクションのステップに従って、使用するアカウントを選択するステップに進みます。
2. [ユーザーアカウントの追加] をクリックします。
   
3. アカウントの接続に関する詳細については、上記の「ブランド管理者としてのアカウントの追加」サブセクションの指示に従ってください。アカウントを個別ユーザとして追加するときに、同じ認証オプションおよび設定を使用できます。

接続のテスト

アカウントを追加した後、SFTP ファイルからデータを抽出タスク内から接続をテストできます。タスクの下部で、[接続テスト] をクリックします。これにより、小さなテストファイルがサーバにアップロードされ、その内容が読み込まれ、ファイルが削除されます。 

公開 SSH キーのダウンロード

Qualtrics によって生成された SSH キーを使用している場合は、接続の公開鍵をダウンロードできます。使用する SFTP アカウントのリストを表示する場合は、アカウントの右側にある 3 つのドットのメニューをクリックし、公開 SSH キーのダウンロードを選択します。これにより、キーがコンピュータに .pem ファイルとしてダウンロードされます。

クアルトリクス生成SSHキーを更新しています

クアルトリクスによって生成されたSSHキーを使用している場合は、必要に応じてキーを再生成できます。これは、キーが改ざんされていると思われる場合や、会社が一定の時間後にキーを回転させる必要がある場合に役立ちます。

1. 使用する SFTP アカウントのリストを表示するときに、アカウントの右側にある 3 つのドットのメニューをクリックし、[アカウントの編集] をクリックします。
2. ハイパーリンクをクリックして、新しいキーペアを生成します。
   

SFTP ファイルからデータを抽出タスクの設定

1. ETL ワークフローを作成します。
2. データソース (ETL 抽出機能) を選択します。
   
3. SFTP ファイルからデータを抽出タスクを選択します。
   
4. ファイルを抽出する SFTP アカウントを選択します。ブランド管理者が追加したすべてのアカウント、および自分が追加したアカウントがここに表示されます。
   
5. 新しい SFTP アカウントの認証情報を追加する場合は、ユーザーアカウントの追加をクリックし、SFTP アカウントの接続セクションの手順に従います。
6. [次へ] をクリックします。
7. ファイル名パターンを入力します。このパターンは、ファイルの接頭辞を確認することで、処理するファイルを識別するために使用されます。指定した接頭辞のファイルがすべて処理されます。該当する接頭辞をボックスに入力します。
   
   例：Qualtrics-DataImport.csv というファイルがあるとします。処理したいファイルがサーバーにあるかどうかに応じて［Q］または［Qualtrics］をプレフィックスとして入力できます
   Qtip:ファイル名パターンに正規表現を使用する場合は、正規表現を使用するチェックボックスをクリックしてください。
8. ピックアップディレクトリまたはディレクトリパスを入力して、サーバ上のファイルを検索します。相対パスまたは絶対パスのいずれかを入力することができます。
   ヒント：このディレクトリパスは大文字と小文字が区別され、既存のフォルダーを指す必要があります。指定しないとワークフローが失敗します。クアルトリクスは、ピックアップディレクトリで指定されたディレクトリよりも上位レベルのディレクトリにあるファイルにアクセスすることはできません。

   例: 入力するパスに応じて、ピックアップディレクトリは以下のようになります。

   • /home/username/myFolder (絶対パス)
   • myFolder (相対パス)
9. ファイルが圧縮されている場合は、Are you extracting from a zip fileオプションを有効にしてください。次に、zipファイルからインポートする正しいファイルを見つけるために使用されるzip内のファイルのプレフィックスを入力します。
   Qtip:.zip圧縮のみがサポートされています。.zipファイル内のファイルは暗号化できますが、.zipファイル自体は暗号化できません（例えば、filename.csv.pgp.zipはサポートされていますが、filename.csv.zip.pgpはサポートされていません）。
10. ファイルタイプを選択します。
    
    オプションは次のとおりです。
    • CSV
    • TSV
    • JSON

      ヒント：JSONファイルの内容は角かっこ（［］）で囲まれている必要があります。例：

      [
         {
             "fruts": "Apple",
             "size": "Large",
             "color": "Red"
         } 
       ]

    • Excel（.xslx または .xls）
11. CSVを処理する場合は、ファイルのデリミタを選択します。オプションには、カンマ、セミコロン、タブ、およびパイプがあります。
12. 必要に応じて、PGP を使用してインポートする前に Decrypt files を選択します。この追加の暗号化方法およびデータ保護の詳細については、PGP 暗号化を参照してください。
    ヒント：インポートするファイルをSFTPサーバーにアップロードする前に、インポートするファイルがクアルトリクスの公開鍵で暗号化されていることを確認してください。そのためには、IT チームに問い合わせる必要がある場合があります。
13. 処理できないファイルをスキップする場合は、Skip bad files を選択します。このオプションを選択しないと、不正なファイルを処理しようとしたときにワークフロー全体が失敗します。
    ヒント：ファイルを処理できない理由はいくつかあります。最も一般的なのは、データが大きすぎるか、データが何らかの方法で破損していることです。
14. ファイルが処理された後の処理を選択します。オプションは次のとおりです。
    • 処理済みのファイルを削除：ファイルの処理後、QualtricsはSFTPサーバーからファイルを削除します。このオプションはデフォルトで有効になっています。
    • 処理済みファイルを保持：ファイルの処理後、QualtricsはSFTPサーバーにファイルを残します。
15. 厳密なチェックを使用するかどうかを決定します。これにより、特定の書式設定の問題がある場合に、抽出されたファイルが自動的に却下されます。却下されるファイルの詳細については、タスクのメッセージを参照してください。
    
    Qtip:Skip malformed rowsを有効にしてファイルをアップロードし、書式に問題のある行を除外してください。
16. ［ファイルを選択］をクリックしてサンプルファイルをアップロードします。これにより、インポートするフィールドがクアルトリクスに通知され、このタスクで使用できる後続タスクが決定されます。アップロードするファイルには、このタスクの一部としてインポートする項目が含まれている必要があります。
    ヒント：タスクのサンプルファイルをダウンロードするか、使用ケースに基づいてデータを構成する方法のテンプレートの［サンプルファイル］セクションのファイルをダウンロードします。サポートされているファイルエンコーディング形式は UTF-8 のみです。一部のスプレッドシートソフトウェアでは、予期しないエラーが発生すると、UTF-8 とは異なる Unicode UTF-8 として保存されます。Unicode UTF-8 ではなく UTF-8 形式でエクスポートしていることを確認してください。
    
17. ファイルがデータを正しくインポートしていることを再確認します。設定を変更する必要がある場合は、タスクの上部にある前画面をクリックします。
    

    ヒント：すべてのデータが1つの列としてインポートされている場合、間違った区切り文字を使用しています。以下のスクリーンショットは、これがタスクウィンドウでどのように表示されるかを示しています。

    

18. データが正しい場合は、保存をクリックします。
19. ETL ワークフローの作成を終了します。ローダタスクを選択すると、抽出したデータの宛先が決定されます。オプションの一覧については、利用可能なローダタスクを参照してください。
    

サンプルファイル

以下は、インポートするデータのタイプに応じて、インポート用にデータを構造化する方法のサンプルファイルです。ファイル名をクリックして、サンプルファイルをダウンロードします。

• ユーザーデータ
• アンケート回答データ
• Salesforce連絡先データ
• Salesforceアカウントデータ
• Salesforceアカウントチームのメンバーデータ
• 従業員データ

FAQ