COPY JOB(미리 보기) - Amazon Redshift
필수 권한구문파라미터사용 노트예시

COPY JOB(미리 보기)

이 사전 릴리스 설명서는 미리 보기 릴리스에 있는 자동 복사(SQL COPY JOB)에 대한 것입니다. 설명서 및 기능은 모두 변경될 수 있습니다. 프로덕션 환경이 아닌 테스트 환경에서만 이 기능을 사용하는 것이 좋습니다. 공개 미리 보기는 2024년 10월 31일에 종료됩니다. 미리 보기 클러스터는 미리 보기 종료 후 2주 후에 자동으로 제거됩니다. 미리 보기 이용 약관은 AWS 서비스 약관의 베타 및 미리 보기를 참조하세요.

미리 보기에서 이 명령을 사용하는 방법에 대한 자세한 내용은 Amazon S3에서 지속적으로 파일을 수집하여 테이블 로드(미리 보기)(Amazon S3에서 지속적인 파일 수집(미리 보기))를 참조하세요.

데이터를 테이블로 로드하는 COPY 명령을 관리합니다. COPY JOB 명령은 COPY 명령의 확장이며 Amazon S3 버킷에서 데이터 로드를 자동화합니다. COPY 작업을 생성하면 Amazon Redshift는 지정된 경로에 새 Amazon S3 파일이 생성되는 시기를 감지한 다음 사용자 개입 없이 자동으로 로드합니다. 원래 COPY 명령에 사용된 것과 동일한 파라미터가 데이터를 로드할 때 사용됩니다. Amazon Redshift는 로드된 파일을 추적하여 한 번만 로드되었는지 확인합니다.

참고

사용법, 파라미 및 권한을 비롯한 COPY 명령에 대한 자세한 내용은 COPY 단원을 참조하세요.

필수 권한

COPY JOB의 COPY 명령을 실행하려면 로드 중인 테이블의 INSERT 권한이 있어야 합니다.

COPY 명령으로 지정된 IAM 역할에는 로드할 데이터에 액세스할 수 있는 권한이 있어야 합니다. 자세한 내용은 COPY, UNLOAD 및 CREATE LIBRARY 작업을 위한 IAM 권한 단원을 참조하십시오.

구문

COPY 작업을 생성합니다. COPY 명령의 파라미터는 COPY 작업과 함께 저장됩니다.

COPY copy-command JOB CREATE job-name
[AUTO ON | OFF]

COPY 작업의 구성을 변경합니다.

COPY JOB ALTER job-name
[AUTO ON | OFF]

COPY 작업을 실행합니다. 저장된 COPY 명령 파라미터가 사용됩니다.

COPY JOB RUN job-name

모든 COPY 작업을 나열합니다.

COPY JOB LIST

COPY 작업의 세부 정보를 표시합니다.

COPY JOB SHOW job-name

COPY 작업을 삭제합니다.

COPY JOB DROP job-name

파라미터

copy-command

Amazon S3에서 Amazon Redshift로 데이터를 로드하는 COPY 명령입니다. 이 절에는 데이터를 로드할 때 사용되는 Amazon S3 버킷, 대상 테이블, IAM 역할 및 기타 파라미터를 정의하는 COPY 파라미터가 포함되어 있습니다. Amazon S3 데이터 로드에 대한 모든 COPY 명령 파라미터는 다음을 제외하고 지원됩니다.

  • COPY JOB은 COPY 명령이 가리키는 폴더에 있는 기존 파일을 수집하지 않습니다. COPY JOB 생성 타임스탬프 이후에 생성된 파일만 수집합니다.

  • MAXERROR 또는 IGNOREALLERRORS 옵션과 함께 COPY 명령을 지정할 수 없습니다.

  • 매니페스트 파일을 지정할 수 없습니다. COPY JOB에는 새로 생성된 파일을 모니터링하기 위해 지정된 Amazon S3 위치가 필요합니다.

  • 액세스 및 비밀 키와 같은 인증 유형으로 COPY 명령을 지정할 수 없습니다. 권한 부여에 IAM_ROLE 파라미터를 사용하는 COPY 명령만 지원됩니다. 자세한 내용은 권한 부여 파라미터 단원을 참조하십시오.

  • COPY JOB은 클러스터와 연결된 기본 IAM 역할을 지원하지 않습니다. COPY 명령에서 IAM_ROLE을 지정해야 합니다.

자세한 내용은 Amazon S3에서 COPY 단원을 참조하십시오.

job-name

COPY 작업을 참조하는 데 사용되는 작업의 이름입니다.

[AUTO ON | OFF]

Amazon S3 데이터가 Amazon Redshift 테이블에 자동으로 로드되는지 여부를 나타내는 절입니다.

  • ON일 때 Amazon Redshift는 새로 생성된 파일의 소스 Amazon S3 경로를 모니터링하고, 파일이 발견되면 작업 정의의 COPY 파라미터와 함께 COPY 명령이 실행됩니다. 이 값이 기본값입니다.

  • OFF일 때 Amazon Redshift는 COPY JOB을 자동으로 실행하지 않습니다.

사용 노트

COPY 명령의 옵션은 런타임까지 유효성이 검사되지 않습니다. 예를 들어 잘못된 IAM_ROLE 또는 Amazon S3 데이터 소스로 인해 COPY JOB이 시작될 때 런타임 오류가 발생합니다.

클러스터가 일시 중지된 경우 COPY JOBS는 실행되지 않습니다.

로드된 COPY 명령 파일을 쿼리하고 오류를 로드하려면 STL_LOAD_COMMITS, STL_LOAD_ERRORS, STL_LOADERROR_DETAIL 단원을 참조하세요. 자세한 내용은 데이터가 올바로 로드되었는지 확인 단원을 참조하십시오.

예시

다음 예에서는 Amazon S3 버킷에서 데이터를 로드하기 위해 COPY 작업을 생성하는 방법을 보여줍니다.

COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName' 
JOB CREATE my_copy_job_name
AUTO ON;