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

# Amazon S3 매니페스트 파일에 지원되는 형식
<a name="supported-manifest-file-format"></a>

JSON 매니페스트 파일을 사용하여 Amazon S3에서 Quick Sight로 가져올 파일을 지정합니다. 이러한 JSON 매니페스트 파일은 다음에 설명된 Quick Sight 형식 또는 Amazon Redshift 데이터베이스 개발자 안내서의 매[니페스트를 사용하여 데이터 파일 지정](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html)에 설명된 Amazon Redshift 형식을 사용할 수 있습니다. ** Amazon Redshift 매니페스트 파일 형식을 사용하기 위해 Amazon Redshift를 사용할 필요는 없습니다.

Quick Sight 매니페스트 파일을 사용하는 경우와 같은 .json 확장자가 있어야 합니다`my_manifest.json`. Amazon Redshift 매니페스트 파일을 사용하는 경우 이 파일의 확장자는 어떤 것이든 상관없습니다.

Amazon Redshift 매니페스트 파일을 사용하는 경우 Quick Sight는 Amazon Redshift와 마찬가지로 옵션 `mandatory` 옵션을 처리합니다. 연결된 파일을 찾을 수 없는 경우 Quick Sight는 가져오기 프로세스를 종료하고 오류를 반환합니다.

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

지정한 파일이 Quick Sight 액세스 권한을 부여한 Amazon S3 버킷에 있는지 확인합니다. AWS 리소스에 대한 Quick Sight 액세스 권한 부여에 대한 자세한 내용은 섹션을 참조하세요[AWS 데이터 소스에 대한 Amazon Quick Sight 액세스 구성](access-to-aws-resources.md).

## Quick Sight의 매니페스트 파일 형식
<a name="quicksight-manifest-file-format"></a>

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

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

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

매니페스트 파일 요소에 대한 설명은 다음과 같습니다.
+ **fileLocations** –이 요소는 가져올 파일을 지정하는 데 사용합니다. `URIs` 및 `URIPrefixes` 어레이를 둘 다 혹은 둘 중 하나만 사용하여 지정할 수 있습니다. 적어도 둘 중 하나에는 값을 지정해야 합니다.
  + **URIs** - 이 배열은 가져올 특정 파일의 URI를 나열하는 데 사용합니다.

    Quick Sight는 모든에 있는 Amazon S3 파일에 액세스할 수 있습니다 AWS 리전. 그러나 빠른 계정에서 사용하는 리전과 다른 경우 Amazon S3 버킷의 AWS 리전을 식별하는 URI 형식을 사용해야 합니다.

    다음 형식의 URI가 지원됩니다.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/quick/latest/userguide/supported-manifest-file-format.html)
  + **URIPrefixes** - 이 배열은 S3 버킷 및 폴더의 URI 접두사를 나열하는 데 사용합니다. 지정된 버킷 또는 폴더의 모든 파일을 가져옵니다. Quick Sight는 하위 폴더에서 파일을 재귀적으로 검색합니다.

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

    다음 형식의 URI 접두사가 지원됩니다.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/quick/latest/userguide/supported-manifest-file-format.html)
+ **globalUploadSettings** - (선택 사항) 이 요소는 Amazon S3 파일의 가져오기 설정(예: 필드 구분 기호)을 지정하는 데 사용합니다. 이 요소를 지정하지 않으면 Quick Sight는이 섹션의 필드에 기본값을 사용합니다.
**중요**  
로그(.clf) 및 확장 로그(.elf) 파일의 경우 이 섹션의 [**format**] 필드만 해당되므로 다른 필드는 건너뛰어도 됩니다. 다른 필드를 포함하도록 선택하면 해당 필드의 값은 무시됩니다.
  + **형식** - (선택 사항) 가져올 파일의 형식을 지정합니다. 유효한 값은 **CSV**, **TSV**, **CLF**, **ELF**, **JSON**입니다. 기본값은 **CSV**입니다.
  + **delimiter** - (선택 사항) 파일 필드 구분 기호를 지정합니다. `format` 필드에 지정된 파일 형식으로 매핑해야 합니다. 유효한 형식은 .csv 파일의 경우 쉼표(**,**)이고 .tsv 파일의 경우 탭(**\$1t**)입니다. 기본값은 쉼표(**,**)입니다.
  + **textqualifier** - (선택 사항) 파일 텍스트 한정자를 지정합니다. 유효한 형식은 작은 따옴표(**'**), 큰 따옴표(**\$1"**)입니다. JSON에서 큰따옴표를 사용하는 경우 큰따옴표 앞에 오는 백슬래시는 필수 이스케이프 문자입니다. 기본값은 큰따옴표입니다(**\$1"**). 텍스트에 텍스트 한정어가 필요하지 않은 경우 이 속성을 포함하지 마십시오.
  + **containsHeader** - (선택 사항) 파일에 머리글 행을 포함할지 여부를 지정합니다. 유효한 값은 **true** 또는 **false**입니다. 기본값은 **true**입니다.

### Quick Sight의 매니페스트 파일 예제
<a name="quicksight-manifest-file-examples"></a>

다음은 완료된 Quick Sight 매니페스트 파일의 몇 가지 예입니다.

다음 예는 가져올 특정한 .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/amzn-s3-demo-bucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}
```

다음 예에서는 가져올 .clf 파일을 포함하는 버킷 2개를 식별합니다. 하나는 빠른 계정 AWS 리전 과 동일한에 있고 다른에 있습니다 AWS 리전. 로그 파일에 해당하지 않으므로 `delimiter`, `textqualifier` 및 `containsHeader` 필드는 건너뜁니다.

```
{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://amzn-s3-demo-bucket1.your-s3-url.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}
```

다음 예에서는 Amazon Redshift 형식을 사용하여 가져올 .csv 파일을 식별합니다.

```
{
    "entries": [
        {
            "url": "https://amzn-s3-demo-bucket.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"
    }
}
```