翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon S3 のマニフェストファイルでサポートされている形式
JSON マニフェストファイルを使用して、Amazon S3 内のファイルを指定し、Amazon にインポートします QuickSight。これらの JSON マニフェストファイルは、Amazon Redshift データベースデベロッパーガイドの「マニフェストを使用してデータファイルを指定する」で説明されている Amazon QuickSight 形式または Amazon Redshift 形式のいずれかを使用できます。 Amazon Redshift マニフェストファイル形式を使用する際に、Amazon Redshift を使用している必要はありません。
Amazon QuickSight マニフェストファイルを使用する場合は、 などの .json 拡張子が必要ですmy_manifest.json
。Amazon Redshift 形式のマニフェストファイルを使用する場合は、任意の拡張子を付けることができます。
Amazon Redshift マニフェストファイルを使用する場合、Amazon はオプションの mandatory
オプションを Amazon Redshift と同じように QuickSight 処理します。関連付けられたファイルが見つからない場合、Amazon はインポートプロセス QuickSight を終了し、エラーを返します。
インポート用に選択するファイルは、文字区切り形式 (.csv や .tsv など) 、ログ (.clf)、拡張ログ (.elf) 形式、または JSON (.json) である必要があります。1 つのマニフェストファイルで識別されるすべてのファイルでは、同じファイル形式を使用する必要があります。さらに、列の数とタイプが同じである必要があります。Amazon QuickSight は UTF-8 ファイルエンコーディングをサポートしていますが、UTF-8 (ap-south-1 を使用) はサポートしていません。JSON ファイルをインポートする場合は、globalUploadSettings
に format
を指定する必要がありますが、delimiter
、textqualifier
、containsHeader
を指定する必要がありません。
指定したファイルが、Amazon にアクセス権を付与した Amazon S3 バケットにあることを確認します。 QuickSight リソース QuickSight へのアクセス権を Amazon に AWS 付与する方法については、「」を参照してくださいデータソースへのアクセス。
Amazon のマニフェストファイル形式 QuickSight
Amazon QuickSight マニフェストファイルでは、次の JSON 形式を使用します。
{ "fileLocations": [ { "URIs": [ "uri1", "uri2", "uri3" ] }, { "URIPrefixes": [ "prefix1", "prefix2", "prefix3" ] } ], "globalUploadSettings": { "format": "JSON", "delimiter": ",", "textqualifier": "'", "containsHeader": "true" } }
fileLocations
要素内のフィールドではインポートするファイルを指定し、globalUploadSettings
要素内のフィールドではそれらのファイルのインポート設定 (フィールド区切り文字など) を指定します。
マニフェストファイルの要素について以下に説明します。
-
fileLocations - インポートするファイルを指定するときはこの要素を使用します。
URIs
配列とURIPrefixes
配列のいずれかまたは両方を使用してファイルを指定できます。そのいずれかで、値を 1 つ以上指定する必要があります。-
URI - インポートする特定のファイルの URI をリスト化するときは、この配列を使用します。
Amazon QuickSight は、任意の にある Amazon S3 ファイルにアクセスできます AWS リージョン。ただし、Amazon アカウントで使用されているリージョンと異なる場合は、Amazon S3 バケットのリージョンを識別する AWS URI 形式を使用する必要があります。 QuickSight
以下の形式の URI がサポートされています。
URI 形式 例 コメント https://s3.amazonaws.com/<bucket name>/<file name> https://s3.amazonaws.com/awsexamplebucket/data.csv s3://<bucket name>/<file name> s3://awsexamplebucket/data.csv https://<bucket name>.s3.amazonaws.com/<file name> https:// awsexamplebucket
.s3.amazonaws.com/data.csv
https://s3-<region name>.amazonaws.com/<bucket name>/<file name> https:// s3-us-east-1.amazonaws.com
/awsexamplebucket
/data.csv
この URI タイプにより、Amazon S3 バケット用の AWS リージョン が特定されます。
https://<bucket name>.s3-<region name>.amazonaws.com/<file name>
https:// awsexamplebucket
.s3-us-east-1
.amazonaws
.com
/data.csv
この URI タイプは、Amazon S3 バケット AWS リージョン の を識別します。 Amazon S3 -
URIPrefixes - S3 バケットおよびフォルダの URI プレフィックスをリスト化するときは、この配列を使用します。指定したバケットまたはフォルダ内のすべてのファイルがインポートされます。Amazon は子フォルダからファイル QuickSight を再帰的に取得します。
QuickSight は、任意の にある Amazon S3 バケットまたはフォルダにアクセスできます AWS リージョン。 QuickSight アカウントで使用されているバケットと異なる AWS リージョン 場合は、S3 バケットの を識別する URI プレフィックス形式を使用してください。
以下の形式の URI プレフィックスがサポートされています。
URI プレフィックス形式 例 コメント https://s3.amazonaws.com/<bucket name>/
https://s3.amazonaws.com/awsexamplebucket/ https://s3.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.) https://s3.amazonaws.com/awsexamplebucket/folder1/ s3://<bucket name> s3://awsexamplebucket/ s3://<bucket name>/<folder name1>/(<folder name2>/etc.) s3://awsexamplebucket/folder1/ https://<
bucket name
>.s3
.amazonaws.com
https:// awsexamplebucket
.s3
.amazonaws.com
https://s3-<region name>.amazonaws.com/<bucket name>/ https://s3- your-region-for-example-us-east-2
.amazonaws.com
/awsexamplebucket
/この URIPrefix
タイプは、Amazon S3 バケット AWS リージョン の を識別します。 Amazon S3https://s3-<region name>.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.) https:// s3-us-east-1.amazonaws.com
/awsexamplebucket
/folder1
/この URIPrefix
タイプは、Amazon S3 バケット AWS リージョン の を識別します。 Amazon S3https://<bucket name>.s3-<region name>.amazonaws.com https://
awsexamplebucket
.s3-us-east-1.amazonaws
.com
この URIPrefix
タイプは、Amazon S3 バケット AWS リージョン の を識別します。 Amazon S3
-
-
globalUploadSettings — (オプション) この要素を使用して、フィールド区切り文字などの Amazon S3 ファイルのインポート設定を指定します。この要素が指定されていない場合、Amazon はこのセクションのフィールドのデフォルト値 QuickSight を使用します。
重要
ログ形式 (.clf) と拡張ログ形式 (.elf) のファイルでは、このセクションの format フィールドのみが適用されるため、その他のフィールドは省略できます。他のフィールドを含めている場合、それらの値は無視されます。
-
format - (オプション) インポートするファイルの形式を指定します。有効な形式は、
CSV
、TSV
、CLF
、ELF
、およびJSON
です。デフォルト値は、CSV
です。 -
delimiter - (オプション) ファイルのフィールド区切り文字を指定します。この値は、
format
フィールドで指定しているファイルタイプに対応している必要があります。有効な値は、.csv ファイルではカンマ (,
)、.tsv ファイルではタブ (\t
) です。デフォルト値はカンマ (,
) です。 -
textqualifier (オプション) ファイルのテキスト修飾子を指定します。有効な形式は、一重引用符 (
'
)、二重引用符 (\"
) です。先頭のバックスラッシュは、JSON で二重引用符に必須のエスケープ文字です。デフォルト値は二重引用符 (\"
) です。テキストにテキスト修飾子が必要ない場合は、このプロパティを含めないでください。 -
containsHeader - (オプション) ファイルにヘッダー行を入れるかどうかを指定します。有効な形式は、
true
またはfalse
です。デフォルト値は、true
です。
-
Amazon のマニフェストファイルの例 QuickSight
以下に、完成した Amazon QuickSight マニフェストファイルの例をいくつか示します。
次の例では、インポートする 2 つ .csv ファイルを特定するマニフェストファイルを示しています。これらのファイルでは、テキスト修飾子として二重引用符を使用しています。format
、delimiter
、および containsHeader
フィールドは、デフォルト値のままで問題ないため、省略しています。
{ "fileLocations": [ { "URIs": [ "https://
yourBucket
.s3
.amazonaws.com
/data-file.csv
", "https://yourBucket
.s3
.amazonaws.com
/data-file-2.csv
" ] } ], "globalUploadSettings": { "textqualifier": "\"" } }
次の例では、インポートする 1 つの .tsv ファイルを特定するマニフェストファイルを示しています。このファイルには、インポート用の追加の .tsv ファイルが含まれる別の AWS
リージョンのバケットも含まれます。textqualifier
および containsHeader
フィールドは、デフォルト値のままで問題ないため、省略しています。
{ "fileLocations": [ { "URIs": [ "https://
s3
.amazonaws.com/
awsexamplebucket
/data.tsv
" ] }, { "URIPrefixes": [ "https://s3-us-east-1.amazonaws.com
/awsexamplebucket
/" ] } ], "globalUploadSettings": { "format": "TSV", "delimiter": "\t" } }
次の例では、インポートする .clf ファイルを含む 2 つのバケットを識別します。1 つは Amazon QuickSight アカウント AWS リージョン と同じ にあり、もう 1 つは別の にあります AWS リージョン。delimiter
、textqualifier
、および containsHeader
フィールドは、ログ形式のファイルには適用されないため、省略しています。
{ "fileLocations": [ { "URIPrefixes": [ "https://
awsexamplebucket
.your-s3-url
.com", "s3://awsexamplebucket2/" ] } ], "globalUploadSettings": { "format": "CLF" } }
次の例では、Amazon Redshift 形式を使用して、インポートする .csv ファイルを特定しています。
{ "entries": [ { "url": "https://
awsexamplebucket
.your-s3-url
.com/myalias-test/file-to-import.csv", "mandatory": true } ] }
次の例では、Amazon Redshift 形式を使用して、インポートする 2 つの JSON ファイルを特定しています。
{ "fileLocations": [ { "URIs": [ "https://
yourBucket
.s3
.amazonaws.com
/data-file.json
", "https://yourBucket
.s3
.amazonaws.com
/data-file-2.json
" ] } ], "globalUploadSettings": { "format": "JSON" } }