트리거 - AWS Glue
 -  데이터 유형  -트리거TriggerUpdate조건자Condition작업EventBatchingCondition -  작업  -CreateTrigger(create_trigger).StartTrigger(start_trigger)GetTrigger(get_trigger)GetTrigger(get_triggers)UpdateTrigger(update_trigger)StopTrigger(stop_trigger)DeleteTrigger(delete_trigger)ListTriggers(list_triggers)BatchGetTriggers(batch_get_triggers)

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

트리거

트리거 API는 AWS Glue에서의 작업 트리거 생성, 업데이트 또는 삭제 및 시작/중지와 관련된 API 및 데이터 유형에 대해 설명합니다.

데이터 타입

트리거 구조

특정 트리거에 대한 정보

필드

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거의 이름입니다.

  • WorkflowName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거와 연결된 워크플로의 이름입니다.

  • Id – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    추후 사용 예약.

  • Type – UTF-8 문자열입니다(유효 값: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

    트리거 유형입니다.

  • State – UTF-8 문자열입니다(유효 값: CREATING | CREATED | ACTIVATING | ACTIVATED | DEACTIVATING | DEACTIVATED | DELETING | UPDATING).

    트리거 현재 테이블 상태

  • Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    이 트리거에 대한 설명입니다.

  • Schedule – UTF-8 문자열입니다.

    일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.

  • Actions – 작업 객체의 배열입니다.

    이 트리거에 의해 시작되는 작업

  • Predicate – 조건자 객체입니다.

    트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.

  • EventBatchingCondition – EventBatchingCondition 객체입니다.

    EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

TriggerUpdate 구조

트리거를 업데이트하기 위해 정보를 제공하는 데 사용되는 구조입니다. 이 객체는 이전 트리거 정의를 완전히 덮어써서 업데이트합니다.

필드

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    추후 사용 예약.

  • Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    이 트리거에 대한 설명입니다.

  • Schedule – UTF-8 문자열입니다.

    일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.

  • Actions – 작업 객체의 배열입니다.

    이 트리거에 의해 시작되는 작업

  • Predicate – 조건자 객체입니다.

    트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.

  • EventBatchingCondition – EventBatchingCondition 객체입니다.

    EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

조건자 구조

트리거가 실행되는 시기를 결정하는 트리거의 조건자를 정의합니다.

필드

  • Logical – UTF-8 문자열입니다(유효한 값: AND | ANY).

    오직 하나의 조건이 기록되어 있다면 조건부 필드입니다. 다수의 조건이 있을 때 이 필드가 필요합니다.

  • Conditions – Condition 객체의 배열입니다.

    트리거가 언제 발생하는지 확인하는 조건 목록입니다.

조건 구조

어떤 트리거가 시작되는지에 대한 조건을 결정합니다.

필드

  • LogicalOperator – UTF-8 문자열입니다(유효한 값: EQUALS).

    논리 연산자

  • JobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    JobRuns에 조건이 적용되고 트리거가 대기하는 작업의 이름입니다.

  • State – UTF-8 문자열입니다(유효한 값: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT | ERROR | WAITING | EXPIRED).

    조건 상태입니다. 현재 트리거가 수신할 수 있는 유일한 작업은 SUCCEEDED, STOPPED, FAILED 및 TIMEOUT입니다. 트리거가 수신할 수 있는 유일한 Crawler는 SUCCEEDED, FAILED 및 CANCELLED입니다.

  • CrawlerName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    이 조건이 적용되는 크롤러의 이름입니다.

  • CrawlState – UTF-8 문자열입니다(유효 값: RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

    이 조건이 적용되는 크롤러의 상태입니다.

작업 구조

트리거에 의해 시작한 작업을 결정합니다.

필드

  • JobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    실행할 작업의 이름입니다.

  • Arguments – 키-값 페어의 맵 배열입니다.

    각 키는 UTF-8 문자열입니다.

    각 값은 UTF-8 문자열입니다.

    이 트리거가 작동할 때 사용되는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

    AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

    자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 Python에서 AWS Glue Glue API 호출을 참조하세요.

    AWS Glue가 작업을 설정하는 데 사용하는 키 값 페어에 대한 자세한 내용은 개발자 가이드의 AWS Glue가 사용하는 특정 파라미터를 참조하세요.

  • Timeout – 1 이상의 숫자(정수)입니다.

    JobRun 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 TIMEOUT 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다. 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  • SecurityConfiguration – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    이 작업에 사용할 SecurityConfiguration 구조의 이름입니다.

  • NotificationProperty – NotificationProperty 객체입니다.

    작업 실행 알림의 구성 속성을 지정합니다.

  • CrawlerName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    이 작업에 사용할 크롤러의 이름입니다.

EventBatchingCondition 구조

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

필드

  • BatchSize – 필수(Required): 1~100의 숫자(정수)입니다.

    EventBridge 이벤트 트리거가 실행되기 전에 Amazon EventBridge에서 수신해야 하는 이벤트 수입니다.

  • BatchWindow – 1~900의 숫자(정수)입니다.

    EventBridge 이벤트 트리거가 실행된 후의 기간(초)입니다. 첫 번째 이벤트가 수신되면 기간이 시작됩니다.

운영

CreateTrigger 작업(Python: create_trigger)

새로운 트리거를 만듭니다.

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거의 이름입니다.

  • WorkflowName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거와 연결된 워크플로의 이름입니다.

  • Type – 필수(Required): UTF-8 문자열입니다(유효 값: SCHEDULED | CONDITIONAL | ON_DEMAND | EVENT).

    새로운 트리거의 유형입니다.

  • Schedule – UTF-8 문자열입니다.

    일정을 지정하는 데 사용되는 cron 표현식입니다(작업 및 크롤러의 시간 기반 일정 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 cron(15 12 * * ? *)을 지정합니다.

    트리거 유형이 SCHEDULED(예정)되면 필드가 필요합니다.

  • Predicate – 조건자 객체입니다.

    새로운 트리거가 시작할 시기를 지정하는 조건자입니다.

    트리거 유형이 CONDITIONAL이면 이 필드는 필수입니다.

  • Actions – 필수(Required): 작업 객체의 배열입니다.

    트리거가 발생하면 이 트리거가 시작되는 작업입니다.

  • Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    새로운 트리거에 대한 설명.

  • StartOnCreation – 부울입니다.

    생성 시 SCHEDULED 및 CONDITIONAL 트리거를 시작하려면 true로 설정합니다. ON_DEMAND 트리거에는 True가 지원되지 않습니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    이 트리거에서 사용할 태그입니다. 태그를 사용하여 트리거에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 AWS Glue의 AWS 태그를 참조하세요.

  • EventBatchingCondition – EventBatchingCondition 객체입니다.

    EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

응답

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거의 이름입니다.

Errors

  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • IdempotentParameterMismatchException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

StartTrigger 작업(Python: start_trigger)

기존 트리거 시작. 다른 유형의 트리거가 시작하는 방법에 대한 자세한 내용은 작업 트리거를 참조하십시오.

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    시작할 트리거의 이름입니다.

응답

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    시작된 트리거의 이름입니다.

Errors

  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

GetTrigger 작업(Python: get_trigger)

트리거의 정의를 검색합니다.

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    가져올 트리거의 이름입니다.

응답

  • Trigger – 트리거 객체입니다.

    요청한 트리거 정의입니다.

Errors

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetTrigger 작업(Python: get_triggers)

이 작업과 연결된 모든 트리거를 얻습니다.

요청

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

  • DependentJobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거를 가져올 작업 이름입니다. 이 작업을 시작할 수 있는 트리거가 반환되고, 이런 트리거가 없으면 모든 트리거가 반환됩니다.

  • MaxResults - 1 이상 200 이하의 숫자(정수)입니다.

    응답의 최대 크기입니다.

응답

  • Triggers – 트리거 객체의 배열입니다.

    지정된 작업에 대한 트리거 목록.

  • NextToken – UTF-8 문자열입니다.

    모든 요청된 트리거가 반환하지 않은 경우의 지속 토큰입니다.

Errors

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

UpdateTrigger 작업(Python: update_trigger)

트리거 정의 업데이트

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    업데이트할 트리거의 이름입니다.

  • TriggerUpdate – 필수(Required): TriggerUpdate 객체입니다.

    트리거를 업데이트하여 얻은 새로운 값입니다.

응답

  • Trigger – 트리거 객체입니다.

    결과 트리거 정의입니다.

Errors

  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

StopTrigger 작업(Python: stop_trigger)

지정된 트리거를 중지합니다.

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    중지할 트리거의 이름입니다.

응답

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    중지된 트리거의 이름입니다.

Errors

  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

DeleteTrigger 작업(Python: delete_trigger)

지정된 트리거를 삭제합니다. 트리거를 못 찾으면 어떤 예외도 없습니다.

요청

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    삭제할 트리거의 이름입니다.

응답

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    삭제된 트리거의 이름입니다.

Errors

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

ListTriggers 작업(Python: list_triggers)

AWS 계정의 모든 트리거 리소스 또는 지정된 태그를 가진 리소스의 이름을 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 Tags 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

요청

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적인 요청이라면 지속적인 토큰입니다.

  • DependentJobName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    트리거를 가져올 작업 이름 이 작업을 시작할 수 있는 트리거가 반환됩니다. 그런 트리거가 없으면 모든 트리거가 반환됩니다.

  • MaxResults - 1 이상 200 이하의 숫자(정수)입니다.

    반환할 목록의 최대 크기.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

응답

  • TriggerNames – UTF-8 문자열의 배열입니다.

    계정의 모든 트리거 또는 지정된 태그를 가진 트리거의 이름입니다.

  • NextToken – UTF-8 문자열입니다.

    반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

Errors

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetTriggers 작업(Python: batch_get_triggers)

주어진 트리거 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. ListTriggers 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

요청

  • TriggerNames – 필수(Required): UTF-8 문자열의 배열입니다.

    트리거 이름(ListTriggers 작업에서 반환된 이름일 수 있음)의 목록입니다.

응답

  • Triggers – 트리거 객체의 배열입니다.

    트리거 정의 목록입니다.

  • TriggersNotFound – UTF-8 문자열의 배열입니다.

    찾을 수 없는 트리거의 이름 목록입니다.

Errors

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException