Amazon S3 タスクからのデータ抽出
Amazon S3 からのデータ抽出について
Amazon Simple Storage Service (別名 Amazon S3) は、データを保存できるサービスです。ワークフローを使用すると、Qualtrics で使用するために Amazon S3 からのデータの抽出を簡単に自動化することができます。
例: Amazon S3 に保存されている従業員の連絡先情報のスプレッドシートを最新の状態に保っています。この社員データを定期的にクアルトリクスにアップロードして、Employee Experienceプログラムで使用します。
開始する前に
Amazon S3 からのデータの抽出を開始する前に、以下の考慮事項を考慮してください。
- データをどのように処理しますか? オプションの一覧については、利用可能なローダタスクを参照してください。
- ファイルは一貫した書式に適合していますか。たとえば、同じワークフローにインポートするファイルには、値が異なる場合でも、同じヘッダ/列/項目が必要です。
例:Amazon S3からXM Directoryに連絡先を定期的にアップロードするワークフローを設定します。すべてのファイルには、[Firstname]、[Lastname]、[Email]、[Phone]、[UniqueID]、および [Location] の列があります。
クアルトリクスをAWSに接続
IAM ユーザに必要な S3 権限
IAM ユーザが AWS アカウントに接続するには、以下の S3 権限が必要です。S3 アクセス管理の詳細については、AWS の文書を参照してください。
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
S3 IAM ユーザに必要なリソース
IAM ユーザが AWS アカウントに接続するには、以下の S3 リソースが必要です。S3 アクセス管理の詳細については、AWS の文書を参照してください。
- arn:aws:s3:::bucket-name/*
- arn:aws:s3:::bucket-name
AWS アカウントの追加
以下の手順では、個人用のクアルトリクスアカウントをアマゾンウェブサービス(AWS)アカウントに接続する方法について説明します。
ヒント:AWS のドキュメントで、AWS アクセスキー、秘密鍵、および IAM ポリシーの詳細を参照してください。
- Amazon S3 からのデータ抽出タスクを使用してワークフローを作成します。
- [ユーザーアカウントを追加] をクリックします。
- アカウントの表示名を追加します。この名前は、このアカウントを参照するために内部でのみ使用されます。
- 表示されたアカウント ID と外部 ID をコピーします。
- AWS では、アカウント ID および外部 ID を使用して IAM ロールを設定します。AWS での IAM ロールの詳細については、この AWS サポートページを参照してください。
- 作成した IAM ロールに関連付けられている Amazon リソース名を入力します。
- 地域を入力します。地域を見つけるためのヘルプが必要な場合は、この AWS サポートページを参照してください。
- [アカウントの接続] をクリックします。
ヒント:必要に応じて、代わりにアクセスキーと秘密鍵を使用してAWSに接続できます。これを行うには、ページ上部の [旧バージョンに切替] をクリックします。
次に、AWS アクセスキーおよび秘密鍵を入力します。また、アカウントに名前を付け、AWS 地域を入力する必要もあります。
Amazon では、この古い接続タイプを使用しないことを推奨しており、代わりに上記のステップバイステップ方法を使用することが推奨されていることに注意してください。この認証方法は、後日非推奨になります。
次に、AWS アクセスキーおよび秘密鍵を入力します。また、アカウントに名前を付け、AWS 地域を入力する必要もあります。
Amazon では、この古い接続タイプを使用しないことを推奨しており、代わりに上記のステップバイステップ方法を使用することが推奨されていることに注意してください。この認証方法は、後日非推奨になります。
ブランド管理者としてのアカウントの接続
ブランド管理者は、AWSアカウントを追加して、ライセンス内の複数のユーザーと共有できます。共有 AWS アカウントを追加するには、Admin タブの Extensions セクションに移動し、アカウントを追加する AWS 拡張を検索します。
拡張を選択したら、上記の手順に従って AWS アカウントを追加します。また、アカウントにアクセスできるユーザを選択することもできます。
Amazon S3 からのデータ抽出タスクの設定
ヒント:1GBのファイルサイズ制限があります。
- 左上のナビゲーションメニューをクリックします。
- ワークフローを選択します。
- [ワークフローを作成] をクリックします。
- ワークフローを スケジュール済 と イベントベース のどちらにするかを決定します。これらのオプションの比較については、「 スケジュールされたワークフローとイベントベースのワークフロー 」を参照してください。
ヒント:通常は、スケジュールされたワークフローとエクストラクタタスクを使用して自動化することをお勧めします。
- 必要に応じて、上部にあるワークフロー名をクリックしてワークフロー名を変更します。
- ワークフローを実行するタイミング (スケジュールされたワークフローの場合) またはワークフローをトリガするイベント (イベントベースワークフローの場合) を決定します。
- プラス記号 ( + ) をクリックし、 タスク を選択します。
- Amazon S3 からデータを抽出を選択します。
- ファイルを抽出する Amazon Web Services (AWS) アカウントを選択します。ブランド管理者が追加したすべてのアカウント、および自分が追加したアカウントがここに表示されます。
- 新しい AWS アカウントの認証情報を追加する場合は、新規アカウントの追加をクリックし、AWS アカウントの接続セクションの手順に従います。
- [次へ] をクリックします。
- データのプル元となる S3 バケット名を入力します。
- ファイル名の接頭辞を入力します。指定した接頭辞のファイルがすべて処理されます。
- 処理するファイルタイプを選択してください。以下から選択できます。
- CSV(コンマ区切り)
- TSV(タブ区切り)
- インポート後のファイル処理で、次の中から選択します。
- このオプションは、以下の場合に選択します。 PGPを使用してファイルを暗号化.
- サンプルファイルのアップロードで、ワークフローが実行されるたびに処理されるファイルと同じヘッダを持つサンプルファイルを追加します。[ファイルの選択] をクリックして、コンピュータからファイルをアップロードします。
ヒント:必要に応じて、タスクのサンプルファイルをダウンロードするか、[サンプルファイル]セクションでファイルをダウンロードできます。サポートされているファイルエンコーディング形式は UTF-8 のみです。一部のスプレッドシートでは、予期しないエラーが発生する場合に、UTF-8 とは異なる Unicode UTF-8 としてファイルが保存されます。Unicode UTF-8 ではなく UTF-8 形式でエクスポートしていることを確認してください。トラブルシューティングの手順の詳細については、「CSV とアンプ、TSVのアップロードの問題」を参照してください。
- ファイル内の項目を確認します。テーブルには、データの最初の 2 行の列ヘッダ (個々の項目を表します) とその値が表示されます。
ヒント:別のファイルをアップロードしたり、その他の変更を加えたりする場合は、[設定を編集]をクリックします。 - 終了したら、[保存]をクリックします。
- プラス記号( + )をクリックして[タスク]を選択し、データ抽出に続くタスクを設定します。これはデータローダタスクである必要があります。オプションの一覧については、利用可能なローダタスクを参照してください。
ヒント:次に発生する処理を制限するために、ローダタスクを追加する前にインポートしたファイルまたは行数に基づいて条件を作成することもできます。