CREATE EXTERNAL TABLE

생성한 후 외부 스키마 이름으로 정규화할 테이블의 이름입니다. 외부 테이블은 외부 스키마에 생성해야 합니다. 자세한 내용은 CREATE EXTERNAL SCHEMA 단원을 참조하십시오.

테이블 이름의 최대 길이는 127바이트이며, 이보다 긴 이름은 127바이트까지 표시되고 나머지는 잘립니다. 최대 4바이트까지 UTF-8 멀티바이트 문자를 사용할 수 있습니다. Amazon Redshift는 사용자 정의 임시 테이블과 쿼리 처리 또는 시스템 유지 관리 중에 Amazon Redshift에서 생성한 임시 테이블을 포함하여 클러스터당 테이블을 9,900개로 제한합니다. 선택적으로, 데이터베이스 이름으로 테이블 이름을 정규화할 수 있습니다. 다음 예에서는 데이터베이스 이름이 spectrum_db이고, 외부 스키마 이름은 spectrum_schema이며, 테이블 이름은 test입니다.

create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';

지정된 데이터베이스 또는 스키마가 존재하지 않는 경우 테이블이 생성되지 않으며, 이 명령문은 오류를 반환합니다. 시스템 데이터베이스 template0, template1, padb_harvest 또는 sys:internal에서 테이블 또는 뷰를 생성할 수 없습니다.

테이블 이름은 지정된 스키마에 대한 고유한 이름이어야 합니다.

유효한 이름에 대한 자세한 내용은 이름 및 식별자 섹션을 참조하세요.

생성되는 각 열의 이름과 데이터 형식입니다.

열 이름의 최대 길이는 127바이트이며, 이보다 긴 이름은 127바이트까지 표시되고 나머지는 잘립니다. 최대 4바이트까지 UTF-8 멀티바이트 문자를 사용할 수 있습니다. 열 이름 "$path" 또는 "$size"는 지정할 수 없습니다. 유효한 이름에 대한 자세한 내용은 이름 및 식별자 섹션을 참조하세요.

기본적으로 Amazon Redshift에서는 가상 열 $path 및 $size가 있는 외부 테이블을 생성합니다. spectrum_enable_pseudo_columns 구성 파라미터를 false로 설정하여 세션에 대해 가상 열 생성을 비활성화할 수 있습니다. 자세한 내용은 가상 열 단원을 참조하십시오.

가상 열이 활성화되어 있으면 단일 테이블에서 정의할 수 있는 최대 열 개수는 1,598개입니다. 가상 열이 활성화되어 있지 않으면 테이블 하나에서 정의할 수 있는 최대 열 개수는 1,600개입니다.

"넓은 테이블"을 생성할 경우에는 로드 및 쿼리 처리 중에 열의 목록이 중간 결과에 대한 행 너비 경계를 초과하지 않도록 주의하십시오. 자세한 내용은 사용 노트 단원을 참조하십시오.

CREATE EXTERNAL TABLE AS 명령의 경우 열이 쿼리에서 파생되기 때문에 열 목록이 필요하지 않습니다.

다음 모듈을 지원합니다.데이터 타입

DATE의 경우 다음과 같은 형식을 사용할 수 있습니다. 숫자를 사용하여 표시되는 월 값의 경우 다음 형식이 지원됩니다.

세 글자 약어를 사용하여 표시되는 월 값의 경우 다음 형식이 지원됩니다.

지속적으로 100보다 작은 연도 값의 경우 연도는 다음 방식으로 계산됩니다.

타임스탬프 값 yyyy-mm-dd HH:mm:ss.SSSSSS에서 볼 수 있듯이, 텍스트 파일의 타임스탬프 값은 2017-05-01 11:30:59.000000 형식이어야 합니다.

VARCHAR 열의 길이 단위는 문자 수가 아니라 바이트로 정의됩니다. 예를 들어 VARCHAR(12) 열에는 단일 바이트 문자 12개, 2바이트 문자 6개가 포함될 수 있습니다. 외부 테이블을 쿼리하는 경우 오류를 반환하지 않고 정의된 열 크기에 맞춰 결과가 잘립니다. 자세한 내용은 스토리지 및 범위 단원을 참조하십시오.

최상의 성능을 위해 데이터에 맞춰 가장 작은 열 크기를 지정하는 것이 좋습니다. 열의 값에 대한 최대 크기(바이트)를 찾으려면 OCTET_LENGTH 함수를 사용하십시오. 다음 예에서는 이메일 열 값의 최대 크기를 반환합니다.

select max(octet_length(email)) from users;

max
---
 62

하나 이상의 파티션 열로 분할된 테이블을 정의하는 절입니다. 지정된 각각의 조합에 별개의 데이터 디렉터리가 사용되어 상황에 따라 쿼리 성능을 개선할 수 있습니다. 분할된 열은 테이블 데이터 자체 내에는 존재하지 않습니다. 테이블 열과 동일한 col_name에 대한 값을 사용하는 경우 오류가 발생합니다.

분할된 테이블을 생성한 후 ALTER TABLE ... ADD PARTITION 문을 사용하여 테이블을 변경하여 새 파티션을 외부 카탈로그에 등록합니다. 파티션을 추가할 때 Amazon S3에서 파티션 데이터가 들어 있는 하위 폴더의 위치를 정의합니다.

예를 들어, 테이블 spectrum.lineitem_part가 PARTITIONED BY (l_shipdate date)로 정의되어 있는 경우 다음 ALTER TABLE 명령을 실행하여 파티션을 추가합니다.

ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';

CREATE EXTERNAL TABLE AS를 사용하는 경우 ALTER TABLE...ADD PARTITION을 실행할 필요가 없습니다. Amazon Redshift는 외부 카탈로그에 새 파티션을 자동으로 등록합니다. 또한 Amazon Redshift는 테이블에 정의된 파티션 키를 기반으로 Amazon S3의 파티션에 해당 데이터를 자동으로 씁니다.

파티션을 보려면 SVV_EXTERNAL_PARTITIONS 시스템 뷰를 쿼리하십시오.

기본 데이터의 형식을 지정하는 절입니다. rowformat에 가능한 값은 다음과 같습니다.

'delimiter'에 단일 ASCII 문자를 지정합니다. 8진수 문자를 사용해 인쇄되지 않는 ASCII 문자를 '\ddd' 형식으로 지정할 수 있습니다. 여기서 d는 최대 ‘\177’까지의 8진수(0~7)입니다. 다음은 8진수 문자를 사용하여 BEL(bell) 문자를 지정하는 예입니다.

ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'

ROW FORMAT이 생략된 경우 기본 형식은 '\A(제목 시작)'로 종료되는 구분된 필드와 '\n(줄 바꿈)'으로 종료되는 행입니다.

기본 데이터의 SERDE 형식을 지정하는 절입니다.

ROW FORMAT이 생략된 경우 기본 형식은 '\A(제목 시작)'로 종료되는 구분된 필드와 '\n(줄 바꿈)'으로 종료되는 행입니다.

데이터 파일의 파일 형식입니다.

유효한 형식은 다음과 같습니다.

CREATE EXTERNAL TABLE AS 명령은 두 가지 파일 형식, 즉 TEXTFILE 및 PARQUET를 지원합니다.

INPUTFORMAT과 OUTPUTFORMAT에 대해 다음 예에 나온 것처럼 클래스 이름을 지정합니다.

'org.apache.hadoop.mapred.TextInputFormat'

데이터 파일이 포함된 Amazon S3 버킷 또는 폴더, 혹은 Amazon S3 객체 경로 목록이 포함된 매니페스트 파일까지의 경로. 버킷은 Amazon Redshift 클러스터와 동일한 AWS 리전에 있어야 합니다. 지원되는 AWS 리전 목록은 Amazon Redshift Spectrum 제한 사항 섹션을 참조하세요.

경로가 버킷 또는 폴더를 지정하는 경우(예: 's3://amzn-s3-demo-bucket/custdata/') Redshift Spectrum은 지정된 버킷 또는 폴더와 모든 하위 폴더에서 파일을 스캔합니다. Redshift Spectrum은 마침표나 밑줄로 시작되는 숨겨진 파일과 파일을 무시합니다.

경로가 매니페스트 파일을 지정하는 경우 's3://bucket/manifest_file' 인수는 단일 파일을 명시적으로 참조해야 합니다(예: 's3://amzn-s3-demo-bucket/manifest.txt'). 키 접두사를 참조할 수는 없습니다.

매니페스트란 Amazon S3에서 로드할 개별 파일의 URL과 파일 크기(단위: 바이트)를 JSON 형식으로 나열한 텍스트 파일을 말합니다. URL에는 파일의 버킷 이름과 전체 객체 경로가 포함됩니다. 매니페스트에서 지정되는 파일이 서로 다른 버킷에 있을 수 있지만 모든 버킷은 Amazon Redshift 클러스터와 동일한 AWS 리전에 속해야 합니다. 파일이 두 번 나열되면 마찬가지로 두 번 로드됩니다. 다음은 3개의 파일을 로드하는 매니페스트의 JSON 형식을 나타낸 예입니다.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

특정 파일의 포함을 필수로 설정할 수 있습니다. 이렇게 하려면 매니페스트의 파일 수준에서 mandatory 옵션을 포함시킵니다. 누락된 필수 파일이 있는 외부 테이블을 쿼리하면 SELECT 문이 실패합니다. 외부 테이블 정의에 포함된 모든 파일이 있는지 확인합니다. 모든 파일이 없으면 찾을 수 없는 첫 번째 필수 파일을 표시하는 오류가 나타납니다. 다음은 mandatory 옵션이 true로 설정된 매니페스트의 JSON 형식을 나타낸 예입니다.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

UNLOAD를 사용하여 만든 파일을 참조하기 위해 MANIFEST 파라미터와 함께 UNLOAD를 사용하여 만든 매니페스트를 사용할 수 있습니다. 이 매니페스트 파일은 Amazon S3에서 COPY의 매니페스트 파일과 호환되지만 사용하는 키는 다릅니다. 사용되지 않는 키는 무시됩니다.

테이블 속성의 테이블 정의를 설정하는 절입니다.