기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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)여야 합니다. 매니페스트 파일 하나에서 식별되는 모든 파일은 형식이 동일해야 합니다. 또한 열 수와 유형이 같아야 합니다. Amazon은 UTF-8 파일 인코딩을 QuickSight 지원하지만 바이트 순서 표시()가 있는 UTF-8은 지원하지 않습니다BOM. JSON 파일을 가져오는 경우 에 textqualifier를 globalUploadSettings 지정format하되 delimiter, 또는 는 지정하지 않습니다containsHeader.

지정한 모든 파일이 Amazon S3 버킷에 있고 Amazon에 QuickSight 액세스 권한을 부여했는지 확인합니다. 리소스에 대한 Amazon QuickSight 액세스 권한 부여에 AWS 대한 자세한 내용은 섹션을 참조하세요데이터 소스에 액세스.

Amazon의 매니페스트 파일 형식 QuickSight

Amazon QuickSight 매니페스트 파일은 다음 JSON 형식을 사용합니다.

{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
                            

fileLocations 요소의 필드에 가져올 파일을 지정하고, globalUploadSettings 요소의 필드에는 가져올 파일의 가져오기 설정(예: 필드 구분 기호)을 지정합니다.

매니페스트 파일 요소에 대한 설명은 다음과 같습니다.

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"
    }
}