# 크롤러 및 분류자 API 크롤러 및 분류자 API는 AWS Glue 크롤러 및 분류자 데이터 유형에 대해 설명하며 크롤러 또는 분류자를 생성, 삭제, 업데이트 및 나열하기 위한 API를 포함합니다. **Topics** + [분류자 API](aws-glue-api-crawler-classifiers.md) + [크롤러 API](aws-glue-api-crawler-crawling.md) + [열 통계의 API](aws-glue-api-crawler-column-statistics.md) + [크롤러 스케줄러 API](aws-glue-api-crawler-scheduler.md) # 분류자 API 분류자 API는 AWS Glue 분류자 데이터 유형에 대해 설명하며 분류자를 생성, 삭제, 업데이트 및 나열하기 위한 API를 포함합니다. ## 데이터 타입 + [분류자 구조](#aws-glue-api-crawler-classifiers-Classifier) + [GrokClassifier 구조](#aws-glue-api-crawler-classifiers-GrokClassifier) + [XMLClassifier 구조](#aws-glue-api-crawler-classifiers-XMLClassifier) + [JsonClassifier 구조](#aws-glue-api-crawler-classifiers-JsonClassifier) + [CsvClassifier 구조](#aws-glue-api-crawler-classifiers-CsvClassifier) + [CreateGrokClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest) + [UpdateGrokClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest) + [CreateXMLClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest) + [UpdateXMLClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest) + [CreateJsonClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest) + [UpdateJsonClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest) + [CreateCsvClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest) + [UpdateCsvClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest) ## 분류자 구조 분류자는 크롤링 작업 중에 시작됩니다. 분류자는 지정된 파일이 처리할 수 있는 형식인지 여부를 확인합니다. 처리할 수 있는 형식인 경우, 분류자는 해당 데이터 형식과 일치하는 `StructType` 객체의 형태로 스키마를 생성합니다. AWS Glue가 제공하는 스탠더드 분류자를 사용하거나 자체 분류자를 작성하여 데이터 원본을 분류하고 분류자를 고려해 사용할 적절한 스키마를 지정합니다. 분류자는 `grok` 분류자이거나, `XML` 분류자이거나, `JSON` 분류자이거나, `Classifier` 객체의 필드 중 하나에 지정된 사용자 지정 `CSV` 분류자일 수 있습니다. **필드** + `GrokClassifier` – [GrokClassifier](#aws-glue-api-crawler-classifiers-GrokClassifier) 객체입니다. `grok`을 사용하는 분류자입니다. + `XMLClassifier` – [XMLClassifier](#aws-glue-api-crawler-classifiers-XMLClassifier) 객체입니다. XML 콘텐츠의 분류자입니다. + `JsonClassifier` – [JsonClassifier](#aws-glue-api-crawler-classifiers-JsonClassifier) 객체입니다. JSON 콘텐츠의 분류자입니다. + `CsvClassifier` – [CsvClassifier](#aws-glue-api-crawler-classifiers-CsvClassifier) 객체입니다. 쉼표로 구분된 값(CSV)의 분류자입니다. ## GrokClassifier 구조 `grok` 패턴을 사용하는 분류자입니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `Classification` – *필수(Required):* UTF-8 문자열입니다. Twitter, JSON, Omniture 로그, 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다. + `CreationTime` – 타임스탬프입니다. 이 분류자가 등록된 시간입니다. + `LastUpdated` – 타임스탬프입니다. 이 분류자가 마지막으로 업데이트된 시간입니다. + `Version` - 숫자(정수)입니다. 이 분류자 버전 + `GrokPattern` – *필수(Required):* [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다. 이 분류자에 의해 grok 패턴이 데이터 스토어로 적용됩니다. 자세한 내용은 [사용자 지정 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html)에서 기본 설정 패턴을 참조하십시오. + `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다. 이 분류자가 정의한 조건부 사용자 지정 grok 패턴입니다. 자세한 내용은 [사용자 지정 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html)에서 사용자 지정 패턴을 참조하십시오. ## XMLClassifier 구조 `XML` 내용의 분류자 **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `Classification` – *필수(Required):* UTF-8 문자열입니다. 분류자가 일치하는 데이터 양식의 분류자입니다. + `CreationTime` – 타임스탬프입니다. 이 분류자가 등록된 시간입니다. + `LastUpdated` – 타임스탬프입니다. 이 분류자가 마지막으로 업데이트된 시간입니다. + `Version` - 숫자(정수)입니다. 이 분류자 버전 + `RowTag` – UTF-8 문자열입니다. 각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, ``는 괜찮지만 ``는 괜찮지 않습니다). ## JsonClassifier 구조 `JSON` 내용의 분류자 **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `CreationTime` – 타임스탬프입니다. 이 분류자가 등록된 시간입니다. + `LastUpdated` – 타임스탬프입니다. 이 분류자가 마지막으로 업데이트된 시간입니다. + `Version` - 숫자(정수)입니다. 이 분류자 버전 + `JsonPath` – *필수(Required):* UTF-8 문자열입니다. 분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다. ## CsvClassifier 구조 사용자 지정 `CSV` 콘텐츠의 분류자입니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `CreationTime` – 타임스탬프입니다. 이 분류자가 등록된 시간입니다. + `LastUpdated` – 타임스탬프입니다. 이 분류자가 마지막으로 업데이트된 시간입니다. + `Version` - 숫자(정수)입니다. 이 분류자 버전 + `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다. + `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다. + `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`). CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다. + `Header` – UTF-8 문자열의 배열입니다. 열 이름을 나타내는 문자열 목록입니다. + `DisableValueTrimming` – 부울입니다. 열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 `true`입니다. + `AllowSingleColumn` – 부울입니다. 오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다. + `CustomDatatypeConfigured` – 부울입니다. 사용자 지정 데이터 유형을 구성할 수 있습니다. + `CustomDatatypes` – UTF-8 문자열의 배열입니다. 사용자 지정 데이터 유형 목록에는 “바이너리”, “부울”, “날짜”, “십진수”, “더블”, “플로트”, “INT”, “롱”, “쇼트”, “문자열”, “타임스탬프” 등이 포함됩니다. + `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`). 분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다. ## CreateGrokClassifierRequest 구조 생성할 `CreateClassifier`를 위해 `grok` 분류자를 지정합니다. **필드** + `Classification` – *필수(Required):* UTF-8 문자열입니다. Twitter, JSON, Omniture Logs, Amazon CloudWatch Logs 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 새로운 분류자의 이름입니다. + `GrokPattern` – *필수(Required):* [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다. 이 분류자가 사용하는 grok 패턴입니다. + `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다. 이 분류자가 사용하는 조건부 사용자 지정 grok 패턴입니다. ## UpdateGrokClassifierRequest 구조 `UpdateClassifier`로 전달되면 업데이트될 grok 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. `GrokClassifier`의 이름입니다. + `Classification` – UTF-8 문자열입니다. Twitter, JSON, Omniture Logs, Amazon CloudWatch Logs 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다. + `GrokPattern` – [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다. 이 분류자가 사용하는 grok 패턴입니다. + `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다. 이 분류자가 사용하는 조건부 사용자 지정 grok 패턴입니다. ## CreateXMLClassifierRequest 구조 생성할 `CreateClassifier`를 위해 XML 분류자를 지정합니다. **필드** + `Classification` – *필수(Required):* UTF-8 문자열입니다. 분류자가 일치하는 데이터 양식의 분류자입니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `RowTag` – UTF-8 문자열입니다. 각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, ``는 괜찮지만 ``는 괜찮지 않습니다). ## UpdateXMLClassifierRequest 구조 업데이트될 XML 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `Classification` – UTF-8 문자열입니다. 분류자가 일치하는 데이터 양식의 분류자입니다. + `RowTag` – UTF-8 문자열입니다. 각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, ``는 괜찮지만 ``는 괜찮지 않습니다). ## CreateJsonClassifierRequest 구조 생성할 `CreateClassifier`를 위해 JSON 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `JsonPath` – *필수(Required):* UTF-8 문자열입니다. 분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다. ## UpdateJsonClassifierRequest 구조 업데이트될 JSON 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `JsonPath` – UTF-8 문자열입니다. 분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다. ## CreateCsvClassifierRequest 구조 생성할 `CreateClassifier`를 위해 사용자 지정 CSV 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다. + `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다. + `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`). CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다. + `Header` – UTF-8 문자열의 배열입니다. 열 이름을 나타내는 문자열 목록입니다. + `DisableValueTrimming` – 부울입니다. 열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 true입니다. + `AllowSingleColumn` – 부울입니다. 오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다. + `CustomDatatypeConfigured` – 부울입니다. 사용자 지정 데이터 유형을 구성할 수 있습니다. + `CustomDatatypes` – UTF-8 문자열의 배열입니다. 지원되는 사용자 지정 데이터 유형 목록을 만듭니다. + `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`). 분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다. ## UpdateCsvClassifierRequest 구조 업데이트될 사용자 지정 CSV 분류자를 지정합니다. **필드** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 분류자의 이름입니다. + `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다. + `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다. 단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다. + `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`). CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다. + `Header` – UTF-8 문자열의 배열입니다. 열 이름을 나타내는 문자열 목록입니다. + `DisableValueTrimming` – 부울입니다. 열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 true입니다. + `AllowSingleColumn` – 부울입니다. 오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다. + `CustomDatatypeConfigured` – 부울입니다. 사용자 지정 데이터 유형의 구성을 지정합니다. + `CustomDatatypes` – UTF-8 문자열의 배열입니다. 지원되는 사용자 지정 데이터 유형 목록을 지정합니다. + `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`). 분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다. ## 운영 + [CreateClassifier 작업(Python: create\$1classifier)](#aws-glue-api-crawler-classifiers-CreateClassifier) + [DeleteClassifier 작업(Python: delete\$1classifier)](#aws-glue-api-crawler-classifiers-DeleteClassifier) + [GetClassifier 작업(Python: get\$1classifier)](#aws-glue-api-crawler-classifiers-GetClassifier) + [GetClassifiers 작업(Python: get\$1classifiers)](#aws-glue-api-crawler-classifiers-GetClassifiers) + [UpdateClassifier 작업(Python: update\$1classifier)](#aws-glue-api-crawler-classifiers-UpdateClassifier) ## CreateClassifier 작업(Python: create\$1classifier) 사용자 계정에 분류자를 만듭니다. 이 분류자는 어떤 요청 필드가 존재하는지에 따라 `GrokClassifier`, `XMLClassifier`, `JsonClassifier` 또는 `CsvClassifier`일 수 있습니다. **요청** + `GrokClassifier` – [CreateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest) 객체입니다. `GrokClassifier` 객체는 생성할 분류자를 지정합니다. + `XMLClassifier` – [CreateXMLClassifierRequest](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest) 객체입니다. `XMLClassifier` 객체는 생성할 분류자를 지정합니다. + `JsonClassifier` – [CreateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest) 객체입니다. `JsonClassifier` 객체는 생성할 분류자를 지정합니다. + `CsvClassifier` – [CreateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest) 객체입니다. `CsvClassifier` 객체는 생성할 분류자를 지정합니다. **응답** + *무응답 파라미터.* **오류** + `AlreadyExistsException` + `InvalidInputException` + `OperationTimeoutException` ## DeleteClassifier 작업(Python: delete\$1classifier) 데이터 카탈로그에서 분류자를 제거합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 제거할 분류자의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `OperationTimeoutException` ## GetClassifier 작업(Python: get\$1classifier) 이름에 따라 분류자를 검색합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 검색할 분류자의 이름입니다. **응답** + `Classifier` – [분류자](#aws-glue-api-crawler-classifiers-Classifier) 객체입니다. 요청된 분류자 **오류** + `EntityNotFoundException` + `OperationTimeoutException` ## GetClassifiers 작업(Python: get\$1classifiers) 데이터 카탈로그에서 분류자 객체를 열거합니다. **요청** + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 반환할 목록의 크기(선택 사항)입니다. + `NextToken` – UTF-8 문자열입니다. 연속 토큰(선택 사항). **응답** + `Classifiers` – [분류자](#aws-glue-api-crawler-classifiers-Classifier) 객체의 배열입니다. 분류자 객체의 요청한 목록입니다. + `NextToken` – UTF-8 문자열입니다. 연속 토큰 **오류** + `OperationTimeoutException` ## UpdateClassifier 작업(Python: update\$1classifier) 기존 분류자(어떤 필드가 존재하는지에 따라 `GrokClassifier`, `XMLClassifier`, `JsonClassifier` 또는 `CsvClassifier` 분류자)를 수정합니다. **요청** + `GrokClassifier` – [UpdateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest) 객체입니다. 업데이트도니 필드와 `GrokClassifier` 객체. + `XMLClassifier` – [UpdateXMLClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest) 객체입니다. 업데이트도니 필드와 `XMLClassifier` 객체. + `JsonClassifier` – [UpdateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest) 객체입니다. 업데이트도니 필드와 `JsonClassifier` 객체. + `CsvClassifier` – [UpdateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest) 객체입니다. 업데이트도니 필드와 `CsvClassifier` 객체. **응답** + *무응답 파라미터.* **오류** + `InvalidInputException` + `VersionMismatchException` + `EntityNotFoundException` + `OperationTimeoutException` # 크롤러 API 크롤러 API는 크롤러를 생성, 삭제, 업데이트 및 나열하기 위한 API와 함께 AWS Glue 크롤러 데이터 유형에 대해 설명합니다. ## 데이터 타입 + [크롤러 구조](#aws-glue-api-crawler-crawling-Crawler) + [일정 구조](#aws-glue-api-crawler-crawling-Schedule) + [CrawlerTargets 구조](#aws-glue-api-crawler-crawling-CrawlerTargets) + [S3Target 구조](#aws-glue-api-crawler-crawling-S3Target) + [S3DeltaCatalogTarget 구조](#aws-glue-api-crawler-crawling-S3DeltaCatalogTarget) + [S3DeltaDirectTarget 구조](#aws-glue-api-crawler-crawling-S3DeltaDirectTarget) + [JdbcTarget 구조](#aws-glue-api-crawler-crawling-JdbcTarget) + [MongoDBTarget 구조](#aws-glue-api-crawler-crawling-MongoDBTarget) + [DynamoDBTarget 구조](#aws-glue-api-crawler-crawling-DynamoDBTarget) + [DeltaTarget 구조](#aws-glue-api-crawler-crawling-DeltaTarget) + [IcebergTarget 구조](#aws-glue-api-crawler-crawling-IcebergTarget) + [HudiTarget 구조](#aws-glue-api-crawler-crawling-HudiTarget) + [CatalogTarget 구조](#aws-glue-api-crawler-crawling-CatalogTarget) + [CrawlerMetrics 구조](#aws-glue-api-crawler-crawling-CrawlerMetrics) + [CrawlerHistory 구조](#aws-glue-api-crawler-crawling-CrawlerHistory) + [CrawlsFilter 구조](#aws-glue-api-crawler-crawling-CrawlsFilter) + [SchemaChangePolicy 구조](#aws-glue-api-crawler-crawling-SchemaChangePolicy) + [LastCrawlInfo 구조](#aws-glue-api-crawler-crawling-LastCrawlInfo) + [RecrawlPolicy 구조](#aws-glue-api-crawler-crawling-RecrawlPolicy) + [LineageConfiguration 구조](#aws-glue-api-crawler-crawling-LineageConfiguration) + [LakeFormationConfiguration 구조](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) ## 크롤러 구조 데이터 원본을 검사하는 크롤러 프로그램을 지정하고 분류자를 사용하여 스키마를 결정합니다. 성공적이면 크롤러는 AWS Glue Data Catalog의 데이터 원본을 고려하여 메타데이터를 기록합니다. **Fields** + `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 크롤러의 이름입니다. + `Role` – UTF-8 문자열입니다. Amazon Simple Storage Service(Amazon S3) 데이터 등의 고객 리소스에 액세스하는 데 사용되는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. + `Targets` – [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다. 크롤할 대상 모음입니다. + `DatabaseName` – UTF-8 문자열입니다. 크롤러의 출력이 저장되는 데이터베이스의 이름입니다. + `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 크롤러에 대한 설명. + `Classifiers` – UTF-8 문자열의 배열입니다. 크롤러와 연결된 사용자 지정 분류자를 지정하는 UTF-8 문자열 목록입니다. + `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다. 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다. + `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다. 크롤러에 대한 업데이트 및 삭제 동작을 지정하는 정책입니다. + `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다. 크롤러에 대해 데이터 계보가 사용되는지 여부를 지정하는 구성입니다. + `State` – UTF-8 문자열입니다(유효 값: `READY` \$1 `RUNNING` \$1 `STOPPING`). 크롤러가 실행되거나 실행되지 않았는지 여부를 나타냅니다. + `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다. 생성된 테이블 이름에 추가된 접두사. + `Schedule` – [일정](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule) 객체입니다. 일정이 짜여진 크롤러를 위한 크롤러가 실행될 때의 일정. + `CrawlElapsedTime` - 숫자(정수)입니다. 크롤러가 실행되면 마지막 크롤이 시작된 후부터 총 경과 시간. + `CreationTime` – 타임스탬프입니다. 크롤러가 생성된 시간. + `LastUpdated` – 타임스탬프입니다. 크롤러가 마지막으로 업데이트된 시간. + `LastCrawl` – [LastCrawlInfo](#aws-glue-api-crawler-crawling-LastCrawlInfo) 객체입니다. 마지막 크롤 상태 및 오류가 발생한 잠재적 오류 정보. + `Version` - 숫자(정수)입니다. 크롤러 버전. + `Configuration` – UTF-8 문자열입니다. 크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요. + `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다. 이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다. + `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다. 크롤러가 IAM 역할 자격 증명 대신 AWS Lake Formation 자격 증명을 크롤러에 사용해야 하는지 지정합니다. ## 일정 구조 `cron`을 사용하여 객체의 일정을 정하여 이벤트의 일정을 정합니다. **Fields** + `ScheduleExpression` – UTF-8 문자열입니다. 일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다. + `State` – UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`). 일정 상태 ## CrawlerTargets 구조 크롤할 데이터 스토어 지정. **Fields** + `S3Targets` – [S3Target](#aws-glue-api-crawler-crawling-S3Target) 객체의 배열입니다. Amazon Simple Storage Service(Amazon S3) 대상을 지정합니다. + `JdbcTargets` – [JdbcTarget](#aws-glue-api-crawler-crawling-JdbcTarget) 객체의 배열입니다. JDBC 대상 지정 + `MongoDBTargets` – [MongoDBTarget](#aws-glue-api-crawler-crawling-MongoDBTarget) 객체의 배열입니다. Amazon DocumentDB 또는 MongoDB 대상을 지정합니다. + `DynamoDBTargets` – [DynamoDBTarget](#aws-glue-api-crawler-crawling-DynamoDBTarget) 객체의 배열입니다. Amazon DynamoDB 대상을 지정합니다. + `CatalogTargets` – [CatalogTarget](#aws-glue-api-crawler-crawling-CatalogTarget) 객체의 배열입니다. AWS Glue Data Catalog 대상을 지정합니다. + `DeltaTargets` – [DeltaTarget](#aws-glue-api-crawler-crawling-DeltaTarget) 객체의 배열입니다. 델타 데이터 스토어 대상을 지정합니다. + `IcebergTargets` – [IcebergTarget](#aws-glue-api-crawler-crawling-IcebergTarget) 객체의 배열입니다. Apache Iceberg 데이터 스토어 대상을 지정합니다. + `HudiTargets` – [HudiTarget](#aws-glue-api-crawler-crawling-HudiTarget) 객체의 배열입니다. Apache Hudi 데이터 스토어 대상을 지정합니다. ## S3Target 구조 Amazon Simple Storage Service(Amazon S3)의 데이터 스토어를 지정합니다. **Fields** + `Path` – UTF-8 문자열입니다. Amazon S3 대상에 대한 경로입니다. + `Exclusions` – UTF-8 문자열의 배열입니다. 크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오. + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). 작업 또는 크롤러가 Amazon Virtual Private Cloud 환경(Amazon VPC) 내에서 Amazon S3의 데이터에 액세스할 수 있도록 허용하는 연결 이름입니다. + `SampleSize` - 숫자(정수)입니다. 데이터 집합의 샘플 파일을 크롤링할 때 크롤링할 각 리프 폴더의 파일 수를 설정합니다. 설정하지 않으면 모든 파일이 크롤링됩니다. 유효한 값은 1\$1249의 정수입니다. + `EventQueueArn` – UTF-8 문자열입니다. 유효한 Amazon SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:sqs`입니다. + `DlqEventQueueArn` – UTF-8 문자열입니다. 유효한 Amazon 배달 못한 편지 SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:deadLetterQueue`입니다. ## S3DeltaCatalogTarget 구조 AWS Glue 데이터 카탈로그의 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다. **Fields** + `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다. 데이터 대상의 이름입니다. + `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다. 데이터 대상에 대한 입력인 노드입니다. + `PartitionKeys` – UTF-8 문자열의 배열입니다. 일련의 키를 사용하여 기본 분할을 지정합니다. + `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 쓰기를 수행할 데이터베이스 테이블의 이름입니다. + `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 쓰기를 수행할 데이터베이스의 이름입니다. + `AdditionalOptions` – 키-값 페어의 맵 배열입니다. 각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 커넥터에 대한 추가 연결 옵션을 지정합니다. + `SchemaChangePolicy` – [CatalogSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다. 크롤러에 대한 업데이트 동작을 지정하는 정책입니다. + `AutoDataQuality` – [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다. S3 Delta 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다. + `OutputSchemas` – [GlueSchema](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다. S3 Delta 카탈로그 대상의 데이터 스키마를 지정합니다. ## S3DeltaDirectTarget 구조 Amazon S3에서 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다. **Fields** + `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다. 데이터 대상의 이름입니다. + `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다. 데이터 대상에 대한 입력인 노드입니다. + `PartitionKeys` – UTF-8 문자열의 배열입니다. 일련의 키를 사용하여 기본 분할을 지정합니다. + `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 쓰기를 수행할 Delta Lake 데이터 소스의 Amazon S3 경로입니다. + `Compression` – *필수:* UTF-8 문자열입니다(유효한 값: `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`). 데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다). + `NumberTargetPartitions` – UTF-8 문자열입니다. Amazon S3 전체에 Delta Lake 데이터세트 파일을 배포할 대상 파티션 수를 지정합니다. + `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`). 대상에 대한 데이터 출력 포맷을 지정합니다. + `AdditionalOptions` – 키-값 페어의 맵 배열입니다. 각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다. 커넥터에 대한 추가 연결 옵션을 지정합니다. + `SchemaChangePolicy` – [DirectSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다. 크롤러에 대한 업데이트 동작을 지정하는 정책입니다. + `AutoDataQuality` – [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다. S3 Delta 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다. ## JdbcTarget 구조 크롤할 JDBC 데이터 스토어 지정. **Fields** + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). JDBC 대상에 연결할 연결 이름입니다. + `Path` – UTF-8 문자열입니다. JDBC 대상의 경로입니다. + `Exclusions` – UTF-8 문자열의 배열입니다. 크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오. + `EnableAdditionalMetadata` – UTF-8 문자열의 배열입니다. `RAWTYPES` 또는 `COMMENTS` 값을 지정하여 테이블 응답에서 추가 메타데이터를 활성화합니다. `RAWTYPES`는 기본 레벨 데이터 유형을 제공합니다. `COMMENTS`는 데이터베이스의 열 또는 테이블과 연결된 설명을 제공합니다. 추가 메타데이터가 필요하지 않은 경우 필드를 비워 두세요. ## MongoDBTarget 구조 크롤링할 Amazon DocumentDB 또는 MongoDB 데이터 스토어를 지정합니다. **Fields** + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). Amazon DocumentDB 또는 MongoDB 대상에 연결하는 데 사용할 연결 이름입니다. + `Path` – UTF-8 문자열입니다. Amazon DocumentDB 또는 MongoDB 대상(데이터베이스/컬렉션)의 경로입니다. + `ScanAll` – 부울입니다. 모든 레코드를 스캔할지 또는 테이블에서 행을 샘플링할지 여부를 나타냅니다. 테이블이 높은 처리량 테이블이 아닌 경우 모든 레코드를 스캔하는 데 시간이 오래 걸릴 수 있습니다. `true` 값은 모든 레코드를 스캔하는 것을 의미하고 `false` 값은 레코드를 샘플링하는 것을 의미합니다. 값을 지정하지 않으면 기본값은 `true`입니다. ## DynamoDBTarget 구조 크롤할 Amazon DynamoDB 테이블을 지정합니다. **Fields** + `Path` – UTF-8 문자열입니다. 크롤할 DynamoDB 테이블의 이름입니다. + `scanAll` – 부울입니다. 모든 레코드를 스캔할지 또는 테이블에서 행을 샘플링할지 여부를 나타냅니다. 테이블이 높은 처리량 테이블이 아닌 경우 모든 레코드를 스캔하는 데 시간이 오래 걸릴 수 있습니다. `true` 값은 모든 레코드를 스캔하는 것을 의미하고 `false` 값은 레코드를 샘플링하는 것을 의미합니다. 값을 지정하지 않으면 기본값은 `true`입니다. + `scanRate` - 숫자(double)입니다. AWS Glue 크롤러에서 사용할 구성된 읽기 용량 단위의 비율입니다. 읽기 용량 단위는 DynamoDB에서 정의한 용어이며, 초당 해당 테이블에서 수행할 수 있는 읽기 수에 대한 속도 제한기 역할을 하는 숫자 값입니다. 유효한 값은 null 또는 0.1\$11.5의 값입니다. null 값은 사용자가 값을 제공하지 않을 때 사용되며, 기본값은 구성된 읽기 용량 단위의 0.5(프로비저닝된 테이블의 경우) 또는 구성된 최대 읽기 용량 단위의 0.25(온디맨드 모드를 사용하는 테이블의 경우)입니다. ## DeltaTarget 구조 하나 이상의 델타 테이블을 크롤링할 델타 데이터 스토어를 지정합니다. **Fields** + `DeltaTables` – UTF-8 문자열의 배열입니다. 델타 테이블에 대한 Amazon S3 경로 목록입니다. + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). 델타 테이블 대상에 연결하는 데 사용할 연결 이름입니다. + `WriteManifest` – 부울입니다. 매니페스트 파일을 델타 테이블 경로에 쓸지 지정합니다. + `CreateNativeDeltaTable` – 부울입니다. 크롤러가 Delta 트랜잭션 로그의 쿼리를 직접 지원하는 쿼리 엔진과 통합할 수 있도록 기본 테이블을 생성할지 여부를 지정합니다. ## IcebergTarget 구조 Amazon S3에서 Iceberg 테이블이 저장되는 Apache Iceberg 데이터 소스를 지정합니다. **Fields** + `Paths` – UTF-8 문자열의 배열입니다. Iceberg 메타데이터 폴더를 `s3://bucket/prefix`로 포함하는 하나 이상의 Amazon S3 경로입니다. + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). Iceberg 대상에 연결하는 데 사용할 연결 이름입니다. + `Exclusions` – UTF-8 문자열의 배열입니다. 크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오. + `MaximumTraversalDepth` - 숫자(정수)입니다. 크롤러가 Amazon S3 경로에 있는 Iceberg 메타데이터 폴더를 검색하기 위해 탐색할 수 있는 Amazon S3 경로의 최대 깊이입니다. 크롤러 실행 시간을 제한하는 데 사용됩니다. ## HudiTarget 구조 Apache Hudi 데이터 소스를 지정합니다. **Fields** + `Paths` – UTF-8 문자열의 배열입니다. Hudi의 Amazon S3 위치 문자열 배열로, 각각 Hudi 테이블의 메타데이터 파일이 있는 루트 폴더를 나타냅니다. Hudi 폴더는 루트 폴더의 하위 폴더에 있을 수 있습니다. 크롤러는 경로 아래에 있는 모든 폴더에서 Hudi 폴더를 스캔합니다. + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). Hudi 대상에 연결하는 데 사용할 연결 이름입니다. VPC 인증이 필요한 버킷에 Hudi 파일이 저장된 경우 여기에서 연결 속성을 설정할 수 있습니다. + `Exclusions` – UTF-8 문자열의 배열입니다. 크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오. + `MaximumTraversalDepth` - 숫자(정수)입니다. 크롤러가 Amazon S3 경로에 있는 Hudi 메타데이터 폴더를 검색하기 위해 탐색할 수 있는 Amazon S3 경로의 최대 깊이입니다. 크롤러 실행 시간을 제한하는 데 사용됩니다. ## CatalogTarget 구조 AWS Glue Data Catalog 대상을 지정합니다. **Fields** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 동기화할 데이터베이스의 이름입니다. + `Tables` – *필수(Required):* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다. 동기화할 테이블의 목록입니다. + `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트). `NETWORK` 연결 유형에 페어링된 `Catalog` 연결 유형을 사용할 때 Amazon S3 기반 데이터 카탈로그 테이블이 크롤링의 대상이 되도록 하는 연결의 이름입니다. + `EventQueueArn` – UTF-8 문자열입니다. 유효한 Amazon SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:sqs`입니다. + `DlqEventQueueArn` – UTF-8 문자열입니다. 유효한 Amazon 배달 못한 편지 SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:deadLetterQueue`입니다. ## CrawlerMetrics 구조 지정한 크롤러에 대한 지표. **Fields** + `CrawlerName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 크롤러의 이름입니다. + `TimeLeftSeconds` – None 이하의 숫자(실수)입니다. 크롤을 완료할 때까지 남은 예상 시간. + `StillEstimating` – 부울입니다. 이 작업이 완료될 때까지 소요 시간을 여전히 추정하고 있다면 True입니다. + `LastRuntimeSeconds` – None 이하의 숫자(실수)입니다. 초 단위의 크롤러의 최근 작업 실행 지속 시간. + `MedianRuntimeSeconds` – None 이하의 숫자(실수)입니다. 초 단위의 크롤러의 평균 작업 실행 지속 시간. + `TablesCreated` – None 이하의 숫자(정수)입니다. 이 크롤러가 생성한 테이블 수. + `TablesUpdated` – None 이하의 숫자(정수)입니다. 이 크롤러가 업데이트한 테이블 수. + `TablesDeleted` – None 이하의 숫자(정수)입니다. 이 크롤러가 삭제한 테이블 수. ## CrawlerHistory 구조 크롤러 실행에 대한 정보가 포함되어 있습니다. **Fields** + `CrawlId` – UTF-8 문자열입니다. 각 크롤링에 대한 UUID 식별자입니다. + `State` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `COMPLETED` \$1 `FAILED` \$1 `STOPPED`). 크롤의 상태. + `StartTime` – 타임스탬프입니다. 크롤이 시작된 날짜와 시간입니다. + `EndTime` – 타임스탬프입니다. 크롤이 시작된 날짜와 시간. + `Summary` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) JSON의 특정 크롤에 대한 실행 요약. 추가, 업데이트 또는 삭제된 카탈로그 테이블 및 파티션을 포함합니다. + `ErrorMessage` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) (오류가 발생한 경우) 크롤과 연결된 오류 메시지. + `LogGroup` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id) 크롤과 연결된 로그 그룹입니다. + `LogStream` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id) 크롤과 연결된 로그 스트림입니다. + `MessagePrefix` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 이 크롤에 관한 CloudWatch 메시지 접두사. + `DPUHour` – None 이하의 숫자(실수)입니다. 크롤에 사용된 DPU(데이터 처리 단위)의 수(시간 단위). ## CrawlsFilter 구조 지정된 크롤러에 대한 크롤러 실행을 필터링하는 데 사용할 수 있는 필드, 비교기 및 값의 목록입니다. **Fields** + `FieldName` – UTF-8 문자열입니다(유효한 값: `CRAWL_ID` \$1 `STATE` \$1 `START_TIME` \$1 `END_TIME` \$1 `DPU_HOUR`). 지정된 크롤러에 대한 크롤러 실행 필터링에 사용되는 키. 각 필드 이름에 유효한 값은 다음과 같습니다. + `CRAWL_ID`: 크롤링의 UUID 식별자를 나타내는 문자열. + `STATE`: 크롤의 상태를 나타내는 문자열. + `START_TIME` 및 `END_TIME`: 밀리초 단위의 Epoch 타임스탬프. + `DPU_HOUR`: 크롤에 사용된 DPU(데이터 처리 단위)의 수(시간 단위). + `FilterOperator` – UTF-8 문자열입니다(유효 값: `GT` \$1 `GE` \$1 `LT` \$1 `LE` \$1 `EQ` \$1 `NE`). 값의 연산을 수행하는 정의된 비교기. 사용 가능한 연산자는 다음과 같습니다. + `GT`: 큼. + `GE`: 크거나 같음. + `LT`: 작음. + `LE`: 작거나 같음. + `EQ`: 같음. + `NE`: 같지 않음. + `FieldValue` – UTF-8 문자열입니다. 크롤 필드에서 비교하기 위해 제공된 값입니다. ## SchemaChangePolicy 구조 크롤러에 대한 업데이트 및 삭제 동작을 지정하는 정책입니다. **Fields** + `UpdateBehavior` – UTF-8 문자열입니다(유효 값: `LOG` \$1 `UPDATE_IN_DATABASE`). 크롤러가 변화된 객체를 찾을 때 업데이트 동작. + `DeleteBehavior` – UTF-8 문자열입니다(유효 값: `LOG` \$1 `DELETE_FROM_DATABASE` \$1 `DEPRECATE_IN_DATABASE`). 크롤러가 변화된 혹은 삭제된 객체를 찾을 때 삭제 동작. ## LastCrawlInfo 구조 최신 크롤의 상태 및 오류 정보. **Fields** + `Status` – UTF-8 문자열입니다(유효한 값: `SUCCEEDED` \$1 `CANCELLED` \$1 `FAILED`). 최종 크롤 상태 + `ErrorMessage` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 오류가 발생할 때 마지막 크롤에 대한 오류 정보. + `LogGroup` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id) 마지막 크롤의 로그 그룹. + `LogStream` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id) 마지막 크롤의 로그 스트림. + `MessagePrefix` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 이 크롤 메시지에 대한 접두사. + `StartTime` – 타임스탬프입니다. 크롤이 시작된 시간. ## RecrawlPolicy 구조 첫 번째 크롤링이 완료된 후 Amazon S3 데이터 원본을 크롤링할 때 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후에 추가된 폴더만 크롤링할지 지정합니다. 자세한 내용은 SageMaker 개발자 안내서의 [AWS Glue의 증분 크롤링](https://docs.aws.amazon.com/glue/latest/dg/incremental-crawls.html)을 참조하세요. **Fields** + `RecrawlBehavior` – UTF-8 문자열입니다(유효한 값: `CRAWL_EVERYTHING` \$1 `CRAWL_NEW_FOLDERS_ONLY` \$1 `CRAWL_EVENT_MODE`). 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정합니다. 값 `CRAWL_EVERYTHING`은 전체 데이터 집합을 다시 크롤링하도록 지정합니다. 값 `CRAWL_NEW_FOLDERS_ONLY`는 마지막 크롤러 실행 이후에 추가된 폴더만 크롤링하도록 지정합니다. 값 `CRAWL_EVENT_MODE`는 Amazon S3 이벤트에서 식별된 변경 사항만 크롤링하도록 지정합니다. ## LineageConfiguration 구조 크롤러에 대한 데이터 계보 구성 설정을 지정합니다. **Fields** + `CrawlerLineageSettings` – UTF-8 문자열입니다(유효 값: `ENABLE` \$1 `DISABLE`). 크롤러에 데이터 계보가 사용되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다. + [사용(ENABLE)]: 크롤러에 데이터 계보를 사용합니다. + [사용 중지(DISABLE)]: 크롤러에 데이터 계보 사용을 중지합니다. ## LakeFormationConfiguration 구조 크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다. **Fields** + `UseLakeFormationCredentials` – 부울입니다. IAM 역할 자격 증명 대신 AWS Lake Formation 자격 증명을 크롤러에 사용해야 하는지 지정합니다. + `AccountId` – UTF-8 문자열입니다(12바이트 이하). 교차 계정 크롤링에 필요합니다. 대상 데이터와 동일한 계정 크롤링의 경우 이 값을 null로 둘 수 있습니다. ## 작업 + [CreateCrawler 작업(Python: create\$1crawler)](#aws-glue-api-crawler-crawling-CreateCrawler) + [DeleteCrawler 작업(Python: delete\$1crawler)](#aws-glue-api-crawler-crawling-DeleteCrawler) + [GetCrawler 작업(Python: get\$1crawler)](#aws-glue-api-crawler-crawling-GetCrawler) + [GetCrawlers 작업(Python: get\$1crawler)](#aws-glue-api-crawler-crawling-GetCrawlers) + [GetCrawlerMetrics Action(Python: get\$1crawler\$1metrics)](#aws-glue-api-crawler-crawling-GetCrawlerMetrics) + [UpdateCrawler 작업(Python: update\$1crawler)](#aws-glue-api-crawler-crawling-UpdateCrawler) + [StartCrawler 작업(Python: start\$1crawler)](#aws-glue-api-crawler-crawling-StartCrawler) + [StopCrawler 작업(Python: stop\$1crawler)](#aws-glue-api-crawler-crawling-StopCrawler) + [BatchGetCrawlers 작업(Python: batch\$1get\$1crawlers)](#aws-glue-api-crawler-crawling-BatchGetCrawlers) + [ListCrawlers 작업(Python: list\$1crawlers)](#aws-glue-api-crawler-crawling-ListCrawlers) + [ListCrawls 작업(Python: list\$1crawls)](#aws-glue-api-crawler-crawling-ListCrawls) ## CreateCrawler 작업(Python: create\$1crawler) 지정된 대상, 역할, 구성 및 선택 일정을 통해 새로운 크롤러를 생성합니다. `s3Targets` 필드, `jdbcTargets` 필드 또는 `DynamoDBTargets` 필드에서 크롤 대상을 하나 이상 지정해야 합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 새로운 크롤러의 이름. + `Role` – *필수(Required):* UTF-8 문자열입니다. 새로운 크롤러를 사용하여 고객 리소스에 액세스하는 IAM 역할 또는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. + `DatabaseName` – UTF-8 문자열입니다. `arn:aws:daylight:us-east-1::database/sometable/*`와 같은 결과가 작성되는 AWS Glue 데이터베이스입니다. + `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 새로운 크롤러에 대한 설명. + `Targets` – *필수(Required):* [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다. 크롤할 대상 모음의 기록. + `Schedule` – UTF-8 문자열입니다. 일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다. + `Classifiers` – UTF-8 문자열의 배열입니다. 사용자가 등록한 사용자 지정 분류자 목록. 기본적으로 모든 기본 설정 분류자는 크롤러에 포함되지만 이 사용자 지정 분류자는 항상 주어진 분류에 대한 기본 분류자를 재정의합니다. + `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다. 생성된 카탈로그 테이블에 사용되는 테이블 접두사입니다. + `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다. 크롤러의 업데이트 및 삭제 동작 정책입니다. + `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다. 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다. + `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다. 크롤러에 대한 데이터 계보 구성 설정을 지정합니다. + `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다. 크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다. + `Configuration` – UTF-8 문자열입니다. 크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요. + `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다. 이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 이 크롤러 요청에서 사용할 태그입니다. 태그를 사용하여 크롤러에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요. **응답** + *무응답 파라미터.* **오류** + `InvalidInputException` + `AlreadyExistsException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` ## DeleteCrawler 작업(Python: delete\$1crawler) 크롤러 상태가 `RUNNING`이 아닌 한, AWS Glue Data Catalog에서 지정한 크롤러를 제거합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 제거할 크롤러의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `CrawlerRunningException` + `SchedulerTransitioningException` + `OperationTimeoutException` ## GetCrawler 작업(Python: get\$1crawler) 지정한 크롤러의 메타데이터 가져오기 **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 메타데이터를 검색할 크롤러 이름입니다. **응답** + `Crawler` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체입니다. 지정한 크롤러의 메타데이터 **오류** + `EntityNotFoundException` + `OperationTimeoutException` ## GetCrawlers 작업(Python: get\$1crawler) 사용자 계정에 정의된 모든 크롤러의 메타데이터를 가져옵니다. **요청** + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 각 호출에 따라 반환할 크롤러의 수입니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적인 요청이라면 지속적인 토큰입니다. **응답** + `Crawlers` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체의 배열입니다. 크롤러 메타데이터의 목록. + `NextToken` – UTF-8 문자열입니다. 이 사용자 계정에 정의된 것들의 끝에 반환된 목록이 도달하지 못한 경우, 지속적인 토큰입니다. **오류** + `OperationTimeoutException` ## GetCrawlerMetrics Action(Python: get\$1crawler\$1metrics) 지정한 크롤러의 지표 가져오기 **요청** + `CrawlerNameList` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 지표를 가져올 크롤러의 이름 목록. + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 반환할 목록의 최대 크기. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰입니다. **응답** + `CrawlerMetricsList` – [CrawlerMetrics](#aws-glue-api-crawler-crawling-CrawlerMetrics) 객체의 배열입니다. 지정한 크롤러에 대한 지표 목록. + `NextToken` – UTF-8 문자열입니다. 반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다. **오류** + `OperationTimeoutException` ## UpdateCrawler 작업(Python: update\$1crawler) 크롤러 업데이트. 크롤러가 실행 중이면 업데이트하기 전에는 `StopCrawler`를 사용하여 중지해야 합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 새로운 크롤러의 이름. + `Role` – UTF-8 문자열입니다. 새로운 크롤러를 사용하여 고객 리소스에 액세스하는 IAM 역할 또는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. + `DatabaseName` – UTF-8 문자열입니다. `arn:aws:daylight:us-east-1::database/sometable/*`와 같은 결과가 저장되는 AWS Glue 데이터베이스입니다. + `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 새로운 크롤러에 대한 설명. + `Targets` – [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다. 크롤할 대상 목록. + `Schedule` – UTF-8 문자열입니다. 일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다. + `Classifiers` – UTF-8 문자열의 배열입니다. 사용자가 등록한 사용자 지정 분류자 목록. 기본적으로 모든 기본 설정 분류자는 크롤러에 포함되지만 이 사용자 지정 분류자는 항상 주어진 분류에 대한 기본 분류자를 재정의합니다. + `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다. 생성된 카탈로그 테이블에 사용되는 테이블 접두사입니다. + `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다. 크롤러의 업데이트 및 삭제 동작 정책입니다. + `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다. 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다. + `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다. 크롤러에 대한 데이터 계보 구성 설정을 지정합니다. + `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다. 크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다. + `Configuration` – UTF-8 문자열입니다. 크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요. + `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다. 이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `InvalidInputException` + `VersionMismatchException` + `EntityNotFoundException` + `CrawlerRunningException` + `OperationTimeoutException` ## StartCrawler 작업(Python: start\$1crawler) 어떤 일정이든지 지정된 크롤러를 사용하여 크롤러를 시작합니다. 크롤러가 이미 실행 중이면 [CrawlerRunningException](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-exceptions.html#aws-glue-api-exceptions-CrawlerRunningException)을 반환합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 시작할 크롤러의 이름. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `CrawlerRunningException` + `OperationTimeoutException` ## StopCrawler 작업(Python: stop\$1crawler) 지정된 크롤러가 실행 중이면 크롤러를 중지합니다. **요청** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 중지할 크롤러의 이름. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `CrawlerNotRunningException` + `CrawlerStoppingException` + `OperationTimeoutException` ## BatchGetCrawlers 작업(Python: batch\$1get\$1crawlers) 주어진 크롤러 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. `ListCrawlers` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다. **요청** + `CrawlerNames` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 크롤러 이름(`ListCrawlers` 작업에서 반환된 이름일 수 있음)의 목록입니다. **응답** + `Crawlers` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체의 배열입니다. 크롤러 정의 목록. + `CrawlersNotFound` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 찾을 수 없는 크롤러의 이름 목록입니다. **오류** + `InvalidInputException` + `OperationTimeoutException` ## ListCrawlers 작업(Python: list\$1crawlers) 이 AWS 계정의 모든 크롤러 리소스의 이름 또는 지정된 태그를 가진 리소스를 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다. 이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 `Tags` 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다. **요청** + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 반환할 목록의 최대 크기. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적인 요청이라면 지속적인 토큰입니다. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 이렇게 태그가 지정된 리소스만 반환하도록 지정합니다. **응답** + `CrawlerNames` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 계정의 모든 크롤러 또는 지정된 태그를 가진 크롤러의 이름. + `NextToken` – UTF-8 문자열입니다. 반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다. **오류** + `OperationTimeoutException` ## ListCrawls 작업(Python: list\$1crawls) 지정된 크롤러에 대한 모든 크롤이 반환됩니다. 크롤러 기록 기능의 시작 날짜 이후 발생한 크롤만 반환되고 최대 12개월의 크롤만 유지됩니다. 이전의 크롤은 반환되지 않습니다. 이 API를 사용하여 다음을 수행할 수 있습니다. + 지정된 크롤러의 모든 크롤을 검색합니다. + 제한된 수 내에서 지정된 크롤러의 모든 크롤을 검색합니다. + 특정 시간 범위에서 지정된 크롤러의 모든 크롤을 검색합니다. + 특정 상태, 크롤 ID 또는 DPU 시간 값을 사용하여 지정된 크롤러의 모든 크롤을 검색합니다. **요청** + `CrawlerName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 실행을 검색할 크롤러의 이름입니다. + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 반환할 최대 결과 수입니다. 기본값은 20이고 최대값은 100입니다. + `Filters` – [CrawlsFilter](#aws-glue-api-crawler-crawling-CrawlsFilter) 객체의 배열입니다. `CrawlsFilter` 객체 목록에서 지정하는 기준에 따라 크롤을 필터링합니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰입니다. **응답** + `Crawls` – [CrawlerHistory](#aws-glue-api-crawler-crawling-CrawlerHistory) 객체의 배열입니다. 기준을 충족하는 크롤 실행을 나타내는 `CrawlerHistory` 객체의 목록입니다. + `NextToken` – UTF-8 문자열입니다. 목록의 현재 세그먼트가 마지막이 아니면 반환된 토큰 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다. **오류** + `EntityNotFoundException` + `OperationTimeoutException` + `InvalidInputException` # 열 통계의 API 열 통계 AWS Glue API는 테이블의 열에 대한 통계를 반환하기 위한 API를 설명합니다. ## 데이터 타입 + [ColumnStatisticsTaskRun 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun) + [ColumnStatisticsTaskSettings 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings) + [ExecutionAttempt 구조](#aws-glue-api-crawler-column-statistics-ExecutionAttempt) ## ColumnStatisticsTaskRun 구조 열 통계 실행의 세부 정보를 표시하는 객체입니다. **필드** + `CustomerId` – UTF-8 문자열입니다(12바이트 이하). AWS 계정 ID입니다. + `ColumnStatisticsTaskRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 특정 열 통계 작업 실행의 식별자입니다. + `DatabaseName` – UTF-8 문자열입니다. 테이블이 상주하는 데이터베이스. + `TableName` – UTF-8 문자열입니다. 열 통계가 생성되는 테이블의 이름입니다. + `ColumnNameList` – UTF-8 문자열의 배열입니다. 열 이름의 목록입니다. 제공되지 않은 경우 기본적으로 테이블의 모든 열 이름이 사용됩니다. + `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다. 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `Role` – UTF-8 문자열입니다. 서비스가 통계를 생성하기 위해 맡을 IAM 역할. + `SampleSize` – 100 이하의 숫자(실수)입니다. 통계 생성에 사용된 행의 비율. 제공되지 않은 경우 전체 테이블을 사용하여 통계를 생성합니다. + `SecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다. 열 통계 작업 실행의 CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다. + `NumberOfWorkers` – 1 이상의 숫자(정수)입니다. 열 통계를 생성하는 데 사용된 작업자 수입니다. 작업은 인스턴스 25개까지 자동 확장되도록 사전 구성되어 있습니다. + `WorkerType` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 통계 생성에 사용되는 작업자 유형. 기본값은 `g.1x`입니다. + `ComputationType` – UTF-8 문자열입니다(유효한 값: `FULL` \$1 `INCREMENTAL`). 열 통계 계산의 유형입니다. + `Status` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `STOPPED`). 실행된 작업의 상태입니다. + `CreationTime` – 타임스탬프입니다. 이 작업이 생성된 시각입니다. + `LastUpdated` – 타임스탬프입니다. 이 작업이 마지막으로 수정된 시점. + `StartTime` – 타임스탬프입니다. 이벤트의 시작 시각. + `EndTime` – 타임스탬프입니다. 작업의 종료 시각. + `ErrorMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다. 작업에 대한 오류 메시지입니다. + `DPUSeconds` – None 이하의 숫자(실수)입니다. 자동 크기 조정된 모든 작업자의 계산된 DPU 사용량(초 단위). ## ColumnStatisticsTaskSettings 구조 열 통계 작업의 설정입니다. **필드** + `DatabaseName` – UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – UTF-8 문자열입니다. 열 통계를 생성할 테이블의 이름입니다. + `Schedule` – [일정](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule) 객체입니다. CRON 구문에 지정된 열 통계 실행 일정입니다. + `ColumnNameList` – UTF-8 문자열의 배열입니다. 통계를 실행할 열 이름의 목록입니다. + `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다. 데이터베이스가 있는 데이터 카탈로그의 ID입니다. + `Role` – UTF-8 문자열입니다. 열 통계를 실행하는 데 사용되는 역할입니다. + `SampleSize` – 100 이하의 숫자(실수)입니다. 샘플링할 데이터의 백분율입니다. + `SecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다. CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다. + `ScheduleType` – UTF-8 문자열입니다(유효한 값: `CRON` \$1 `AUTO`). 열 통계 작업의 일정 유형입니다. 가능한 값은 `CRON` 또는 `AUTO`입니다. + `SettingSource` – UTF-8 문자열입니다(유효한 값: `CATALOG` \$1 `TABLE`). 열 통계 작업 설정의 소스입니다. 가능한 값은 `CATALOG` 또는 `TABLE`입니다. + `LastExecutionAttempt` – [ExecutionAttempt](#aws-glue-api-crawler-column-statistics-ExecutionAttempt) 객체입니다. 열 통계 작업 실행의 마지막 `ExecutionAttempt`입니다. ## ExecutionAttempt 구조 열 통계 작업 실행의 실행 시도입니다. **필드** + `Status` – UTF-8 문자열입니다(유효한 값: `FAILED` \$1 `STARTED`). 마지막 열 통계 작업 실행의 상태입니다. + `ColumnStatisticsTaskRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 마지막 열 통계 작업 실행의 작업 실행 ID입니다. + `ExecutionTimestamp` – 타임스탬프입니다. 마지막 열 통계 작업 실행이 발생한 타임스탬프입니다. + `ErrorMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다. 마지막 열 통계 작업 실행과 관련한 오류 메시지입니다. ## 운영 + [StartColumnStatisticsTaskRun 작업 (Python: start\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun) + [GetColumnStatisticsTaskRun 작업 (Python: get\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun) + [GetColumnStatisticsTaskRuns 작업 (Python: get\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns) + [ListColumnStatisticsTaskRuns 작업 (Python: list\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns) + [StopColumnStatisticsTaskRun 작업 (Python: stop\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun) + [CreateColumnStatisticsTaskSettings 작업(Python: create\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings) + [UpdateColumnStatisticsTaskSettings 작업(Python: update\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings) + [GetColumnStatisticsTaskSettings 작업(Python: get\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings) + [DeleteColumnStatisticsTaskSettings 작업(Python: delete\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings) + [StartColumnStatisticsTaskRunSchedule 작업(Python: start\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule) + [StopColumnStatisticsTaskRunSchedule 작업(Python: stop\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule) ## StartColumnStatisticsTaskRun 작업 (Python: start\$1column\$1statistics\$1task\$1run) 지정된 테이블 및 열에 대해 열 통계 작업 실행을 시작합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 통계를 생성할 테이블의 이름입니다. + `ColumnNameList` – UTF-8 문자열의 배열입니다. 통계를 생성할 열 이름의 목록입니다. 제공되지 않은 경우 기본적으로 테이블의 모든 열 이름이 사용됩니다. + `Role` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 서비스가 통계를 생성하기 위해 맡을 IAM 역할. + `SampleSize` – 100 이하의 숫자(실수)입니다. 통계 생성에 사용된 행의 비율. 제공되지 않은 경우 전체 테이블을 사용하여 통계를 생성합니다. + `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계 작업 실행의 CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다. **응답** + `ColumnStatisticsTaskRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계 작업 실행의 식별자입니다. **오류** + `AccessDeniedException` + `EntityNotFoundException` + `ColumnStatisticsTaskRunningException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InvalidInputException` ## GetColumnStatisticsTaskRun 작업 (Python: get\$1column\$1statistics\$1task\$1run) 작업 실행 ID가 주어지면 작업 실행과 관련된 메타데이터/정보를 가져옵니다. **요청** + `ColumnStatisticsTaskRunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 특정 열 통계 작업 실행의 식별자입니다. **응답** + `ColumnStatisticsTaskRun` – [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun) 객체입니다. 열 통계 실행의 세부 정보를 나타내는 `ColumnStatisticsTaskRun` 객체입니다. **오류** + `EntityNotFoundException` + `OperationTimeoutException` + `InvalidInputException` ## GetColumnStatisticsTaskRuns 작업 (Python: get\$1column\$1statistics\$1task\$1runs) 지정된 테이블과 관련된 모든 실행에 대한 정보를 검색합니다. **요청** + `DatabaseName` – *필수:* UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 응답의 최대 크기입니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰입니다. **응답** + `ColumnStatisticsTaskRuns` – [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun) 객체의 배열입니다. 실행된 작업의 열 통계 목록입니다. + `NextToken` – UTF-8 문자열입니다. 실행된 작업이 아직 모두 반환되지 않은 경우의 지속 토큰입니다. **오류** + `OperationTimeoutException` ## ListColumnStatisticsTaskRuns 작업 (Python: list\$1column\$1statistics\$1task\$1runs) 특정 계정에 대해 실행된 모든 작업을 나열합니다. **요청** + `MaxResults` – 1\$11,000의 숫자(정수)입니다. 응답의 최대 크기입니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰입니다. **응답** + `ColumnStatisticsTaskRunIds` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 열 통계 작업 실행 ID 목록. + `NextToken` – UTF-8 문자열입니다. 실행된 작업 ID가 아직 전부 반환되지 않은 경우의 지속 토큰입니다. **오류** + `OperationTimeoutException` ## StopColumnStatisticsTaskRun 작업 (Python: stop\$1column\$1statistics\$1task\$1run) 지정된 테이블에 대한 작업 실행을 중지합니다. **요청** + `DatabaseName` – *필수:* UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `ColumnStatisticsTaskNotRunningException` + `ColumnStatisticsTaskStoppingException` + `OperationTimeoutException` ## CreateColumnStatisticsTaskSettings 작업(Python: create\$1column\$1statistics\$1task\$1settings) 열 통계 작업에 대한 설정을 생성합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 생성할 테이블의 이름입니다. + `Role` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 실행하는 데 사용되는 역할입니다. + `Schedule` – UTF-8 문자열입니다. CRON 구문에 지정된 열 통계 실행 일정입니다. + `ColumnNameList` – UTF-8 문자열의 배열입니다. 통계를 실행할 열 이름의 목록입니다. + `SampleSize` – 100 이하의 숫자(실수)입니다. 샘플링할 데이터의 백분율입니다. + `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 데이터베이스가 있는 데이터 카탈로그의 ID입니다. + `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다. + `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 태그의 맵입니다. **응답** + *무응답 파라미터.* **오류** + `AlreadyExistsException` + `AccessDeniedException` + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `ColumnStatisticsTaskRunningException` ## UpdateColumnStatisticsTaskSettings 작업(Python: update\$1column\$1statistics\$1task\$1settings) 열 통계 작업의 설정을 업데이트합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 생성할 테이블의 이름입니다. + `Role` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 실행하는 데 사용되는 역할입니다. + `Schedule` – UTF-8 문자열입니다. CRON 구문에 지정된 열 통계 실행 일정입니다. + `ColumnNameList` – UTF-8 문자열의 배열입니다. 통계를 실행할 열 이름의 목록입니다. + `SampleSize` – 100 이하의 숫자(실수)입니다. 샘플링할 데이터의 백분율입니다. + `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 데이터베이스가 있는 데이터 카탈로그의 ID입니다. + `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `AccessDeniedException` + `EntityNotFoundException` + `InvalidInputException` + `VersionMismatchException` + `OperationTimeoutException` ## GetColumnStatisticsTaskSettings 작업(Python: get\$1column\$1statistics\$1task\$1settings) 열 통계 작업의 설정을 가져옵니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 검색할 테이블의 이름입니다. **응답** + `ColumnStatisticsTaskSettings` – [ColumnStatisticsTaskSettings](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings) 객체입니다. 열 통계 작업의 설정을 나타내는 `ColumnStatisticsTaskSettings` 객체입니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` ## DeleteColumnStatisticsTaskSettings 작업(Python: delete\$1column\$1statistics\$1task\$1settings) 열 통계 작업의 설정을 삭제합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계를 삭제할 테이블의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` ## StartColumnStatisticsTaskRunSchedule 작업(Python: start\$1column\$1statistics\$1task\$1run\$1schedule) 열 통계 작업 실행 일정을 시작합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계 작업 실행 일정을 시작할 테이블의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `AccessDeniedException` + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` ## StopColumnStatisticsTaskRunSchedule 작업(Python: stop\$1column\$1statistics\$1task\$1run\$1schedule) 열 통계 작업 실행 일정을 중지합니다. **요청** + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터베이스의 이름입니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 열 통계 작업 실행 일정을 중지할 테이블의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` ## 예외 + [ColumnStatisticsTaskRunningException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException) + [ColumnStatisticsTaskNotRunningException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException) + [ColumnStatisticsTaskStoppingException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException) + [ColumnStatisticsTaskAutoConcurrencyLimitException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException) + [InvalidCatalogSettingException 구조](#aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException) ## ColumnStatisticsTaskRunningException 구조 열 통계 생성 작업을 실행하는 동안 다른 작업을 시작하려고 하면 예외가 발생합니다. **필드** + `Message` – UTF-8 문자열입니다. 문제를 설명하는 메시지 ## ColumnStatisticsTaskNotRunningException 구조 실행 중인 작업이 없을 때 작업 실행을 중지하려고 하면 예외가 발생합니다. **필드** + `Message` – UTF-8 문자열입니다. 문제를 설명하는 메시지 ## ColumnStatisticsTaskStoppingException 구조 작업 실행을 중지하려고 할 때 발생하는 예외입니다. **필드** + `Message` – UTF-8 문자열입니다. 문제를 설명하는 메시지 ## ColumnStatisticsTaskAutoConcurrencyLimitException 구조 동시 자동 통계 작업의 한도에 이미 도달했을 때 발생하는 예외입니다. **필드** + `Message` – UTF-8 문자열입니다. 문제를 설명하는 메시지 ## InvalidCatalogSettingException 구조 카탈로그 설정에 문제가 있을 때 발생하는 예외입니다. **필드** + `Message` – UTF-8 문자열입니다. 문제를 설명하는 메시지 # 크롤러 스케줄러 API 크롤러 스케줄러 API는 크롤러를 생성, 삭제, 업데이트 및 나열하기 위한 API와 함께 AWS Glue 크롤러 데이터 유형에 대해 설명합니다. ## 데이터 타입 + [일정 구조](#aws-glue-api-crawler-scheduler-Schedule) ## 일정 구조 `cron`을 사용하여 객체의 일정을 정하여 이벤트의 일정을 정합니다. **필드** + `ScheduleExpression` – UTF-8 문자열입니다. 일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다. + `State` – UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`). 일정 상태 ## 운영 + [UpdateCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule) + [StartCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StartCrawlerSchedule) + [StopCrawlerSchedule 작업(Python: stop\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StopCrawlerSchedule) ## UpdateCrawlerSchedule 작업(Python: start\$1crawler\$1schedule) `cron` 표현식을 사용하여 크롤러의 일정을 업데이트합니다. **요청** + `CrawlerName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 업데이트할 일정이 있는 크롤러 이름입니다. + `Schedule` – UTF-8 문자열입니다. 일정을 지정하는 데 사용되는 업데이트된 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `VersionMismatchException` + `SchedulerTransitioningException` + `OperationTimeoutException` ## StartCrawlerSchedule 작업(Python: start\$1crawler\$1schedule) 크롤러가 실행 중이거나 일정 상태가 이미 `SCHEDULED`로 되어있지 않는 한 지정된 크롤러의 일정 상태를 `SCHEDULED`로 변경합니다. **요청** + `CrawlerName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 일정을 잡을 크롤러의 이름. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `SchedulerRunningException` + `SchedulerTransitioningException` + `NoScheduleException` + `OperationTimeoutException` ## StopCrawlerSchedule 작업(Python: stop\$1crawler\$1schedule) 지정된 크롤러의 일정 상태를 `NOT_SCHEDULED`로 설정하지만 크롤러가 실행되고 있으면 크롤러를 중지하지 않습니다. **요청** + `CrawlerName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다. 설정할 일정이 있는 크롤러 이름. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `SchedulerNotRunningException` + `SchedulerTransitioningException` + `OperationTimeoutException`