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 S3
https://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 S3
https://<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"
    }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

別のアカウントの S3 ファイルの使用

Apache Spark

Amazon S3 のマニフェストファイルでサポートされている形式

Amazon のマニフェストファイル形式 QuickSight

重要

Amazon のマニフェストファイルの例 QuickSight