Sftpファイルからのデータ抽出タスク
このページの内容
Sftpファイルからのデータ抽出タスクについて
SFTPファイルからデータを抽出タスクでは、SFTPサーバーからデータをインポートしてクアルトリクスで使用することができます。このタスクを使って、一度に1つまたは複数のファイルだけを処理することができる。このタスクと他のタスク(Load data to XM DIRECTORYタスクなど)を組み合わせることで、クアルトリクス内の他の場所にデータをインポートすることができます。
Qtip:クアルトリクスでは、プロフェッショナルサービスチームを通じて、お客様向けに独自のSftpサーバーを提供しています。このサービスにはコストがかかりますが、これらのサーバーが自動化で動作することは保証されています。連絡先はプロフェッショナル・サービス・チームまで。
注意: このタスクを成功させるには、Sftpアカウントに読み取り、書き込み、および削除の権限が必要です。
SFTP アカウントの接続
SFTPファイルからデータを抽出タスクを使用する前に、クアルトリクスがデータを抽出するためのSFTPアカウントを接続する必要があります。アカウントは、ブランド管理者がブランドの他のユーザーに使用させるために追加することも、個人ユーザーが個人的に使用するために追加することもできます。
認証機能は3種類あります:
- パスワード:ユーザー名とパスワードで認証すること。
- SSHキー:自分が用意したSecure Shell(SSH)キー、またはクアルトリクスが用意したキーを使って認証機能を行います。
- 暗号化された SSH 鍵:暗号化された SSH 鍵を使用して認証機能。
Qtip:SFTP接続を設定する際には、ITチームがクアルトリクスIPレンジを許可することをお勧めします。
ブランド管理者としてのアカウントの追加
ブランド管理者の場合は、このセクションの手順に従って、ライセンス内の一部またはすべてのユーザーが使用する SFTP アカウントを追加してください。
個人ユーザーとしてのアカウントの追加
このセクションの手順に従って、個人用の SFTP アカウントを追加します。接続したアカウントは、あなただけが使用できます。
接続のテスト
アカウントを追加したら、Sftp ファイルからデータを抽出するタスクで接続をテストできます。タスクの下部で、Test connectionをクリックする。これは小さなテストファイルをサーバーにアップロードし、その内容を読み込んでからファイルを削除する。
公開SSH鍵のダウンロード
クアルトリクスが生成したSSHキーを使用している場合は、接続用の公開キーをダウンロードできます。使用する SFTP アカウントのリストを表示したら、アカウントの右側にある 3 つのドット メニューをクリックし、「Download public SSH key」を選択します。これで鍵が.pemファイルとしてあなたのコンピュータにダウンロードされます。
クアルトリクスが生成したSSHキーの更新
クアルトリクスが生成したSSHキーを使用している場合、必要に応じてキーを再生成することができます。これは、鍵が漏洩していると思われる場合や、会社で一定期間経過後に鍵のローテーションを義務付けられている場合に有効である。
注意: この操作は自動的にアカウントのSSHキーを更新し、元に戻すことはできません。このセクションの手順を実行する前に、キーを再生成することを確認してください。
Qtip:新しいSSHキーを保存するには、必ずDownload public SSH keyと Copy to clipboardを クリックしてください。
SFTPファイルからのデータ抽出」タスクのトラブルシューティング
このタスクでファイルを処理するためのベストプラクティス、制限、トラブルシューティングのアドバイスを紹介します:
- ファイルサイズの制限: SFTPファイルからのデータ抽出タスクには、1回の実行につき200ファイルの制限があり、各ファイルには5GBのファイルサイズ制限があり、すべてのファイルの合計ファイルサイズ制限は10GBです。ファイルがこれらの制限を超えた場合、タスクは失敗し、どのファイルも処理されない。
- ヘッダーが必要です:ファイルの処理には1行のヘッダーが必要です。ファイルにヘッダー行がない場合、そのファイルは無効とみなされる。
- タスク失敗の原因となるファイル 複数のファイルを抽出しようとして、そのうちの1つがタスクの失敗の原因となる場合、ワークフローがそのファイルを再度処理しようとして失敗するのを防ぐために、ファイルを変更する必要があります。たとえば、ファイルをSftpの別のディレクトリに移動したり、削除したり、ファイルの接頭辞を別のものに変更したりできます。
- エスケープされた引用符:CSVファイルのエスケープ引用符:CSVファイルのエスケープ引用符は、逆スラッシュ( ˶´⚰`˵ )は無効です。必ずストレートクォーテーション(“”)を使用してください。タイポグラフィ引用符 (” “) は使用しないでください。
- 改行:改行:キャリッジ・リターン(改行コード)のみの改行コードを持つファイルを使用している場合、改行コードに置き換えられます。
- UTF-8エンコードCSV:CSVを使用している場合、このタスクでサポートされているファイルエンコーディング形式はUTF-8のみです。表計算ソフトによっては、UTF-8とは異なるUnicode UTF-8として保存するものもあり、予期せぬエラーが発生する場合があります。UnicodeのUTF-8ではなく、UTF-8形式でエクスポートしていることを確認してください。
ヒント:ETLワークフローに適用される一般的な制限については、ワークフローの制限を参照してください。タスク固有の制限については、このページの情報を参照してください。
SFTP接続のトラブルシューティングについては、SFTPトラブルシューティングを参照してください。
Sftpファイルからのデータ抽出タスクの設定
ファイル例
以下は、インポートしたいデータの種類に応じた、インポートするためのデータ構造の例です。サンプルファイルをダウンロードするには、ファイル名をクリックしてください。
SFTPファイルから会話データを抽出する
注意:この機能は、新しい簡易価格プランおよびパッケージプランのユーザー、またはこの機能のプレビュープログラムに積極的に参加した顧客のみが利用できます。詳細については、「クアルトリクス公開プレビュー」を参照してください。クアルトリクスの価格やパッケージプランについてご不明な点がございましたら、アカウント サービスまでお問い合わせください。
会話データとは、チャットやEメールからのデータである。例えば、顧客やサポートとのやり取りの記録があれば、それは会話データとなる。このような情報には、充実した自由形式のフィードバックが含まれるだけでなく、顧客に最も適したサービスを提供する方法について、顧客担当者を指導する機会を提供することもできます。データがサーバーからクアルトリクスに移動された後は、オムニチャネルリスニング機能を使って、このような会話分析を行うことができます。
ご注意: インプリメンテーション・サービスを購入された場合のみ、会話データ設定の使用をお勧めします。この機能は、オムニチャネルリスニングマネージャーの一環として、チャットやEメールプロジェクトで使用するためのものです。詳細と許可についてはリンク先のページを参照のこと。
会話データのフォーマット
会話データは文書形式でなければならない。例えば、書き起こされたチャットのトランスクリプトは、会話分析に使用するためにクアルトリクスに移動することができます。しかし、オーディオファイルはそうはいかない。
ファイルはスプレッドシート形式であること(下記のサポートされるファイル形式を参照)。ファイルのすべての行は別々のレコードでなければならず、すべての列は同じレコード内の別のフィールド、または項目でなければならない。サンプル・ファイルにはヘッダーが必要です。
ご注意: 会話データをサーバーに保存する際は、サンプルファイルを使用することを強くお勧めします:
SFTPファイルから会話データを抽出する
以下では、クアルトリクスで分析できるように、SFTPから会話データを引き出す方法の概要を説明します:
FAQs
ワークフローのテンプレートで利用できるすべての拡張機能にアクセスできますか?
ワークフローのテンプレートで利用できるすべての拡張機能にアクセスできますか?
すべてのワークフローのイベントトリガー、コントロールフロー、およびタスクへのリンクはありますか?
すべてのワークフローのイベントトリガー、コントロールフロー、およびタスクへのリンクはありますか?
ワークフローテンプレートとは何ですか?
ワークフローテンプレートとは何ですか?
ワークフローとは何ですか?/ アクションはどこですか?
ワークフローとは何ですか?/ アクションはどこですか?
今回のアップデートでは、ワークフロー機能に変更はありません。
How do I add or remove an extension from my Qualtrics account?
How do I add or remove an extension from my Qualtrics account?
素晴らしい! フィードバックありがとうございます!
フィードバックありがとうございます!