Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.
# COPY JOB
이 명령 사용에 대한 자세한 내용은 [Amazon S3 버킷에서 자동으로 파일을 복사하기 위해 S3 이벤트 통합 만들기](loading-data-copy-job.md) 섹션을 참조하세요.
데이터를 테이블로 로드하는 COPY 명령을 관리합니다. COPY JOB 명령은 COPY 명령의 확장이며 Amazon S3 버킷에서 데이터 로드를 자동화합니다. COPY 작업을 생성하면 Amazon Redshift는 지정된 경로에 새 Amazon S3 파일이 생성되는 시기를 감지한 다음 사용자 개입 없이 자동으로 로드합니다. 원래 COPY 명령에 사용된 것과 동일한 파라미터가 데이터를 로드할 때 사용됩니다. Amazon Redshift는 파일 이름을 기반으로 로드된 파일을 추적하여 한 번만 로드되었는지 확인합니다.
**참고**
사용법, 파라미 및 권한을 비롯한 COPY 명령에 대한 자세한 내용은 [COPY](r_COPY.md) 섹션을 참조하세요.
## 필수 권한
COPY JOB 명령을 사용하려면 COPY를 사용하는 데 필요한 모든 권한 외에도 다음 권한 중 하나가 있어야 합니다.
+ 수퍼유저
+ 다음 모두:
+ COPY 대상 데이터베이스의 COPY JOBS에 대한 관련 CREATE, ALTER 또는 DROP 범위 지정 권한.
+ COPY 대상 스키마에 대한 USAGE 권한 또는 COPY 대상 데이터베이스의 스키마에 대한 USAGE 범위 지정 권한.
+ COPY 대상 테이블에 대한 INSERT 권한 또는 COPY 대상 스키마 또는 데이터베이스의 테이블에 대한 INSERT 범위 지정 권한.
COPY 명령으로 지정된 IAM 역할에는 로드할 데이터에 액세스할 수 있는 권한이 있어야 합니다. 자세한 내용은 [COPY, UNLOAD 및 CREATE LIBRARY 작업을 위한 IAM 권한](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions) 섹션을 참조하세요.
## 구문
COPY 작업을 생성합니다. COPY 명령의 파라미터는 COPY 작업과 함께 저장됩니다.
트랜잭션 블록의 범위 내에서 COPY JOB CREATE를 실행할 수 없습니다.
```
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을 실행할 수 없습니다.
```
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-parameters-authorization.md) 섹션을 참조하세요.
+ COPY JOB은 클러스터와 연결된 기본 IAM 역할을 지원하지 않습니다. COPY 명령에서 `IAM_ROLE`을 지정해야 합니다.
자세한 내용은 [Amazon S3에서 COPY](copy-parameters-data-source-s3.md) 섹션을 참조하세요.
*job-name*
COPY 작업을 참조하는 데 사용되는 작업의 이름입니다. *job-name*에는 하이픈(‐)을 사용할 수 없습니다.
[AUTO ON \$1 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\$1LOAD\$1COMMITS](r_STL_LOAD_COMMITS.md), [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md), [STL\$1LOADERROR\$1DETAIL](r_STL_LOADERROR_DETAIL.md) 섹션을 참조하세요. 자세한 내용은 [데이터가 올바로 로드되었는지 확인](verifying-that-data-loaded-correctly.md) 섹션을 참조하세요.
COPY JOBS는 읽기 전용 모드에서 작동하므로 제로 ETL 데이터베이스에서는 지원되지 않습니다.
## 예제
다음 예에서는 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;
```