Amazon S3 매니페스트 파일에 지원되는 형식

JSON 매니페스트 파일을 사용하여 Amazon S3에 있는 파일을 지정하여 Amazon으로 가져올 수 있습니다. QuickSight 이러한 JSON 매니페스트 파일은 아래에 설명된 Amazon QuickSight 형식 또는 Amazon Redshift 데이터베이스 개발자 안내서의 매니페스트를 사용하여 데이터 파일을 지정하는 방법에 설명된 Amazon Redshift 형식을 사용할 수 있습니다. Amazon Redshift 매니페스트 파일 형식을 사용하기 위해 Amazon Redshift를 사용할 필요는 없습니다.

예를 들어 Amazon QuickSight 매니페스트 파일을 사용하는 경우 확장명은.json이어야 합니다. my_manifest.json Amazon Redshift 매니페스트 파일을 사용하는 경우 이 파일의 확장자는 어떤 것이든 상관없습니다.

Amazon Redshift 매니페스트 파일을 사용하는 경우 Amazon은 Amazon Redshift와 마찬가지로 선택적 mandatory 옵션을 QuickSight 처리합니다. 관련 파일을 찾을 수 없는 경우 Amazon은 가져오기 프로세스를 QuickSight 종료하고 오류를 반환합니다.

가져올 파일은 구분된 텍스트(예: .csv 또는 .tsv), 로그(.clf), 확장된 로그(.elf), 또는 JSON(.json) 형식이어야 합니다. 매니페스트 파일 하나에서 식별되는 모든 파일은 형식이 동일해야 합니다. 또한 열 수와 유형이 같아야 합니다. QuickSight 아마존은 UTF-8 파일 인코딩을 지원하지만 UTF-8 (ap-south-1 사용) 은 지원하지 않습니다. JSON 파일을 가져오려는 경우 globalUploadSettings에는 delimiter, textqualifier 또는 containsHeader이(가) 아니라 format을(를) 지정해야 합니다.

지정하는 모든 파일이 Amazon QuickSight 액세스 권한을 부여한 Amazon S3 버킷에 있는지 확인하십시오. Amazon에 AWS 리소스 QuickSight 액세스 권한을 부여하는 방법에 대한 자세한 내용은 을 참조하십시오데이터 소스에 액세스.

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 어레이를 둘 다 혹은 둘 중 하나만 사용하여 지정할 수 있습니다. 적어도 둘 중 하나에는 값을 지정해야 합니다.

  • URIs - 이 배열은 가져올 특정 파일의 URI를 나열하는 데 사용합니다.

    Amazon은 어느 위치에나 있는 Amazon S3 파일에 액세스할 QuickSight 수 AWS 리전있습니다. 하지만 Amazon QuickSight 계정에서 사용하는 것과 다를 경우 Amazon S3 버킷의 AWS 지역을 식별하는 URI 형식을 사용해야 합니다.

    다음 형식의 URI가 지원됩니다.

    URI 형식	예	설명
    https://s3.amazonaws.com/<버킷 이름>/<파일 이름>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<버킷 이름>/<파일 이름>	s3://awsexamplebucket/data.csv
    https://<버킷 이름>.s3.amazonaws.com/<파일 이름>	https://awsexamplebucket.s3.amazonaws.com/data.csv
    https://s3-<리전 이름>.amazonaws.com/<버킷 이름>/<파일 이름>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	이 URI 유형은 Amazon S3 버킷의 AWS 리전 을(를) 식별합니다.
    https://<버킷 이름>.s3-<리전 이름>.amazonaws.com/<파일 이름>	https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv	이 URI 유형은 Amazon S3 버킷을 식별합니다. AWS 리전

  • URIPrefixes - 이 배열은 S3 버킷 및 폴더의 URI 접두사를 나열하는 데 사용합니다. 지정된 버킷 또는 폴더의 모든 파일을 가져옵니다. Amazon은 하위 폴더에서 QuickSight 반복적으로 파일을 검색합니다.

    QuickSight 모든 AWS 리전위치에 있는 Amazon S3 버킷 또는 폴더에 액세스할 수 있습니다. 계정에서 사용하는 것과 다른 AWS 리전 경우 S3 버킷을 식별하는 URI 접두사 형식을 사용해야 합니다. QuickSight

    다음 형식의 URI 접두사가 지원됩니다.

    URI 접두사 형식	예	설명
    https://s3.amazonaws.com/<버킷 이름>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<버킷 이름>/<폴더 이름1>/(<폴더 이름2>/기타)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<버킷 이름>	s3://awsexamplebucket/
    s3://<버킷 이름>/<폴더 이름1>/(<폴더 이름2>/기타)	s3://awsexamplebucket/folder1/
    https://<bucket name>.s3.amazonaws.com	https://awsexamplebucket.s3.amazonaws.com
    https://s3-<리전 이름>.amazonaws.com/<버킷 이름>/	https://s3 - -us-east-2your-region-for-example. amazonaws.com/ awsexamplebucket/	이 URIPrefix 유형은 Amazon S3 버킷을 식별합니다. AWS 리전
    https://s3-<리전 이름>.amazonaws.com/<버킷 이름>/<폴더 이름1>/(<폴더 이름2>/기타)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	이 URIPrefix 유형은 Amazon S3 버킷을 식별합니다. AWS 리전
    https://<버킷 이름>.s3-<리전 이름>.amazonaws.com	https://awsexamplebucket.s3-us-east-1.amazonaws.com	이 URIPrefix 유형은 Amazon S3 버킷을 식별합니다. AWS 리전

• globalUploadSettings— (선택 사항) 이 요소를 사용하여 Amazon S3 파일의 가져오기 설정 (예: 필드 구분자) 을 지정합니다. 이 요소가 지정되지 않은 경우 QuickSight Amazon은 이 섹션의 필드에 기본값을 사용합니다.

  중요

  로그(.clf) 및 확장 로그(.elf) 파일의 경우 이 섹션의 [format] 필드만 해당되므로 다른 필드는 건너뛰어도 됩니다. 다른 필드를 포함하도록 선택하면 해당 필드의 값은 무시됩니다.

  • 형식 - (선택 사항) 가져올 파일의 형식을 지정합니다. 유효한 값은 CSV, TSV, CLF, ELF, JSON입니다. 기본 값은 CSV입니다.

  • delimiter - (선택 사항) 파일 필드 구분 기호를 지정합니다. format 필드에 지정된 파일 형식으로 매핑해야 합니다. 유효한 형식은 .csv 파일의 경우 쉼표(,)이고 .tsv 파일의 경우 탭(\t)입니다. 기본값은 쉼표(,)입니다.

  • textqualifier - (선택 사항) 파일 텍스트 한정자를 지정합니다. 유효한 형식은 작은 따옴표('), 큰 따옴표(\")입니다. JSON에서 큰따옴표를 사용하는 경우 큰따옴표 앞에 오는 백슬래시는 필수 이스케이프 문자입니다. 기본값은 큰따옴표입니다(\"). 텍스트에 텍스트 한정어가 필요하지 않은 경우 이 속성을 포함하지 마십시오.

  • containsHeader - (선택 사항) 파일에 머리글 행을 포함할지 여부를 지정합니다. 유효한 값은 true 또는 false입니다. 기본 값은 true입니다.

Amazon용 매니페스트 파일 예제 QuickSight

다음은 완성된 Amazon QuickSight 매니페스트 파일의 몇 가지 예입니다.

다음 예는 가져올 특정한 .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": "\""
    }
}

다음 예는 가져올 특정한 .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개를 식별합니다. 하나는 Amazon QuickSight 계정과 AWS 리전 동일하고 다른 하나는 다른 계정에 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 형식을 사용하여 가져올 두 가지 JSON 파일을 식별합니다.

{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.json",
                "https://yourBucket.s3.amazonaws.com/data-file-2.json"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}