Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

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:ListBucket “アクションでは、関連するリソースはバケット全体を指すべきです。バケット名の後にスラッシュやワイルドカードをつけることはできません。

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action" "Action": [
 "s3:ListBucket"
 ],


:
:Multi
buctname"

:s3bucketname"


:
"

 "Allow",



 "Action" "Action" [

例: 以下はトラストポリシーの例です。

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": "sts:Principal",
 "Principal": {
 "AWS": "604163242721"
},
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "60ebef7bdexternali dc38d36bc2a6b75cd14f02c73

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 IAM ロールを使用して設定する必要があります。

ブランド管理者としてのアカウントの接続

ブランド管理者は、AWSアカウントを追加して、ライセンス内の複数のユーザーと共有できます。共有 AWS アカウントを追加するには、Admin タブの Extensions セクションに移動し、アカウントを追加する AWS 拡張を検索します。

拡張を選択したら、上記の手順に従って AWS アカウントを追加します。また、アカウントにアクセスできるユーザを選択することもできます。

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

ヒント：1GBのファイルサイズ制限があります。

ETL ワークフローを作成します。
データソース (ETL 抽出機能) を選択します。
Amazon S3 からデータを抽出を選択します。
ファイルを抽出する Amazon Web Services (AWS) アカウントを選択します。ブランド管理者が追加したすべてのアカウント、および自分が追加したアカウントがここに表示されます。
新しい AWS アカウントの認証情報を追加する場合は、ユーザアカウントの追加をクリックし、AWS アカウントの接続セクションの手順に従います。
[次へ] をクリックします。
データのプル元となる S3 バケット名を入力します。

Qtip:バケットの命名ガイドラインについては、AWSのドキュメントを参照してください。
ファイル名の接頭辞を入力します。指定した接頭辞のファイルがすべて処理されます。s3 ロールによって特定の S3 バケット接頭辞へのアクセスのみが許可される場合、ここに接頭辞を含める必要があります。
処理するファイルタイプを選択してください。以下から選択できます。
- CSV（コンマ区切り）
- TSV（タブ区切り）
インポート後のファイル処理で、次の中から選択します。
- 処理済ファイルの削除 (デフォルト): 抽出後に AWS からファイルを削除します。
- 処理済ファイルの移動: 処理済ファイルを別のバケットに移動します。このオプションを選択すると、処理したファイルを保存する S3 バケットの名前を入力するように求められます。
- 処理されたファイルの名前を変更する: 処理後にファイルの名前を変更します。このオプションを選択すると、処理後にファイル名に追加する接頭辞を指定するよう求められます。
このオプションは、以下の場合に選択します。 PGPを使用してファイルを暗号化.
サンプルファイルのアップロードで、ワークフローが実行されるたびに処理されるファイルと同じヘッダを持つサンプルファイルを追加します。[ファイルの選択] をクリックして、コンピュータからファイルをアップロードします。
ヒント：必要に応じて、タスクのサンプルファイルをダウンロードするか、［サンプルファイル］セクションでファイルをダウンロードできます。サポートされているファイルエンコーディング形式は UTF-8 のみです。一部のスプレッドシートでは、予期しないエラーが発生する場合に、UTF-8 とは異なる Unicode UTF-8 としてファイルが保存されます。Unicode UTF-8 ではなく UTF-8 形式でエクスポートしていることを確認してください。トラブルシューティングの手順の詳細については、「CSV とアンプ、TSVのアップロードの問題」を参照してください。
ファイル内の項目を確認します。テーブルには、データの最初の 2 行の列ヘッダ (個々の項目を表します) とその値が表示されます。

ヒント：別のファイルをアップロードしたり、その他の変更を加えたりする場合は、［設定を編集］をクリックします。
終了したら、［保存］をクリックします。
ETL ワークフローの作成を終了します。ローダタスクを選択すると、抽出したデータの宛先が決定されます。オプションの一覧については、利用可能なローダタスクを参照してください。