# 데이터 품질 API
<a name="aws-glue-api-data-quality-api"></a>

데이터 품질 API는 데이터 품질 데이터 유형에 대해 설명하며 데이터 품질 규칙 세트, 실행 및 평가를 생성, 삭제 또는 업데이트하기 위한 API를 포함합니다.

## 데이터 타입
<a name="aws-glue-api-data-quality-api-objects"></a>
+ [DataSource 구조](#aws-glue-api-data-quality-api-DataSource)
+ [DataQualityRulesetListDetails 구조](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails)
+ [DataQualityTargetTable 구조](#aws-glue-api-data-quality-api-DataQualityTargetTable)
+ [DataQualityRulesetEvaluationRunDescription 구조](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription)
+ [DataQualityRulesetEvaluationRunFilter 구조](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter)
+ [DataQualityEvaluationRunAdditionalRunOptions 구조](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions)
+ [DataQualityRuleRecommendationRunDescription 구조](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription)
+ [DataQualityRuleRecommendationRunFilter 구조](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter)
+ [DataQualityResult 구조](#aws-glue-api-data-quality-api-DataQualityResult)
+ [DataQualityAnalyzerResult 구조](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult)
+ [DataQualityObservation 구조](#aws-glue-api-data-quality-api-DataQualityObservation)
+ [MetricBasedObservation 구조](#aws-glue-api-data-quality-api-MetricBasedObservation)
+ [DataQualityMetricValues 구조](#aws-glue-api-data-quality-api-DataQualityMetricValues)
+ [DataQualityRuleResult 구조](#aws-glue-api-data-quality-api-DataQualityRuleResult)
+ [DataQualityResultDescription 구조](#aws-glue-api-data-quality-api-DataQualityResultDescription)
+ [DataQualityResultFilterCriteria 구조](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria)
+ [DataQualityRulesetFilterCriteria 구조](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria)
+ [DataQualityAggregatedMetrics 구조](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics)
+ [StatisticAnnotation 구조](#aws-glue-api-data-quality-api-StatisticAnnotation)
+ [TimestampedInclusionAnnotation 구조](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation)
+ [AnnotationError 구조](#aws-glue-api-data-quality-api-AnnotationError)
+ [DatapointInclusionAnnotation 구조](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation)
+ [StatisticSummaryList 목록](#aws-glue-api-data-quality-api-StatisticSummaryList)
+ [StatisticSummary 구조](#aws-glue-api-data-quality-api-StatisticSummary)
+ [RunIdentifier 구조](#aws-glue-api-data-quality-api-RunIdentifier)
+ [StatisticModelResult 구조](#aws-glue-api-data-quality-api-StatisticModelResult)
+ [DataQualityGlueTable 구조](#aws-glue-api-data-quality-api-DataQualityGlueTable)

## DataSource 구조
<a name="aws-glue-api-data-quality-api-DataSource"></a>

데이터 품질 결과를 얻으려는 데이터 소스(AWS Glue 테이블)입니다.

**필드**
+ `GlueTable` – [GlueTable](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GlueTable) 객체입니다.

  AWS Glue 테이블
+ `DataQualityGlueTable` – [DataQualityGlueTable](#aws-glue-api-data-quality-api-DataQualityGlueTable) 객체입니다.

  Data Quality 작업에 대한 AWS Glue 테이블.

## DataQualityRulesetListDetails 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetListDetails"></a>

`GetDataQualityRuleset`에서 반환되는 데이터 품질 규칙 세트를 설명합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `CreatedOn` – 타임스탬프입니다.

  데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  데이터 품질 규칙 세트가 마지막으로 수정된 날짜와 시간입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  AWS Glue 테이블을 나타내는 객체입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `RuleCount` - 숫자(정수)입니다.

  규칙 세트의 규칙 수입니다.

## DataQualityTargetTable 구조
<a name="aws-glue-api-data-quality-api-DataQualityTargetTable"></a>

AWS Glue 테이블을 나타내는 객체입니다.

**필드**
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 테이블의 이름.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 테이블이 속한 데이터베이스의 이름입니다.
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 테이블이 있는 카탈로그 ID입니다.

## DataQualityRulesetEvaluationRunDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription"></a>

데이터 품질 규칙 세트 평가 실행 결과를 설명합니다.

**필드**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `StartedOn` – 타임스탬프입니다.

  실행이 시작된 날짜와 시간입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.

## DataQualityRulesetEvaluationRunFilter 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter"></a>

필터 기준입니다.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  실행과 연결된 데이터 소스(AWS Glue 테이블)를 기반으로 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  이 시간 이전에 시작된 실행을 기준으로 결과를 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  이 시간 이후에 시작된 실행을 기준으로 결과를 필터링합니다.

## DataQualityEvaluationRunAdditionalRunOptions 구조
<a name="aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions"></a>

평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.

**필드**
+ `CloudWatchMetricsEnabled` – 부울입니다.

  CloudWatch 지표를 활성화할지 여부입니다.
+ `ResultsS3Prefix` – UTF-8 문자열입니다.

  결과를 저장할 Amazon S3의 접두사입니다.
+ `CompositeRuleEvaluationMethod` – UTF-8 문자열입니다(유효한 값: `COLUMN` \$1 `ROW`).

  규칙 세트의 복합 규칙 평가 방법을 ROW/COLUMN으로 설정합니다.

## DataQualityRuleRecommendationRunDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription"></a>

데이터 품질 규칙 권장 실행 결과를 설명합니다.

**필드**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  권장 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.

## DataQualityRuleRecommendationRunFilter 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter"></a>

데이터 품질 권장 실행을 나열하기 위한 필터입니다.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  지정된 데이터 원본(AWS Glue 테이블)을 기반으로 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  제공된 시간 이전에 시작된 결과에 대한 시간을 기준으로 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  제공된 시간 이후에 시작된 결과에 대한 시간을 기준으로 필터링합니다.

## DataQualityResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityResult"></a>

데이터 품질 결과를 설명합니다.

**필드**
+ `ResultId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 데이터 품질 결과에 대한 규칙 세트 평가의 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

## DataQualityAnalyzerResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityAnalyzerResult"></a>

데이터 품질 분석기의 평가 결과를 설명합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 분석기의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  데이터 품질 분석기에 대한 설명입니다.
+ `EvaluationMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가 메시지입니다.
+ `EvaluatedMetrics` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 숫자(double)입니다.

  분석기 평가와 관련된 지표의 맵입니다.

## DataQualityObservation 구조
<a name="aws-glue-api-data-quality-api-DataQualityObservation"></a>

규칙과 분석기를 평가한 후 생성된 관찰을 설명합니다.

**필드**
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  데이터 품질 관찰에 대한 설명입니다.
+ `MetricBasedObservation` – [MetricBasedObservation](#aws-glue-api-data-quality-api-MetricBasedObservation) 객체입니다.

  평가된 데이터 품질 지표를 기반으로 하는 관찰을 나타내는 `MetricBasedObservation` 유형의 객체입니다.

## MetricBasedObservation 구조
<a name="aws-glue-api-data-quality-api-MetricBasedObservation"></a>

평가된 데이터 품질 지표를 기반으로 생성된 지표 기반 관찰을 설명합니다.

**필드**
+ `MetricName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  관찰을 생성하는 데 사용된 데이터 품질 지표의 이름입니다.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `MetricValues` – [DataQualityMetricValues](#aws-glue-api-data-quality-api-DataQualityMetricValues) 객체입니다.

  데이터 품질 지표 값의 분석을 나타내는 유형 `DataQualityMetricValues`의 객체입니다.
+ `NewRules` – UTF-8 문자열의 배열입니다.

  데이터 품질 지표 값을 기반으로 관찰의 일부로 생성된 새 데이터 품질 규칙의 목록입니다.

## DataQualityMetricValues 구조
<a name="aws-glue-api-data-quality-api-DataQualityMetricValues"></a>

과거 데이터 분석에 따른 데이터 품질 지표 값을 설명합니다.

**필드**
+ `ActualValue` - 숫자(double)입니다.

  데이터 품질 지표의 실제 값입니다.
+ `ExpectedValue` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표의 예상 값입니다.
+ `LowerLimit` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표 값의 하한입니다.
+ `UpperLimit` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표 값의 상한입니다.

## DataQualityRuleResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleResult"></a>

데이터 품질 규칙 평가 결과를 설명합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙에 대한 설명입니다.
+ `EvaluationMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가 메시지입니다.
+ `Result` – UTF-8 문자열입니다(유효한 값: `PASS` \$1 `FAIL` \$1 `ERROR`).

  규칙의 통과 또는 실패 상태입니다.
+ `EvaluatedMetrics` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 숫자(double)입니다.

  규칙 평가와 관련된 지표 맵입니다.
+ `EvaluatedRule` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가된 규칙입니다.
+ `RuleMetrics` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 숫자(double)입니다.

  행 수준 결과를 기반으로 규칙 평가와 연결된 지표가 포함된 맵입니다.

## DataQualityResultDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityResultDescription"></a>

데이터 품질 결과를 설명합니다.

**필드**
+ `ResultId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 데이터 품질 결과의 고유한 결과 ID입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블 이름입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 시간입니다.

## DataQualityResultFilterCriteria 구조
<a name="aws-glue-api-data-quality-api-DataQualityResultFilterCriteria"></a>

데이터 품질 결과를 반환하는 데 사용되는 기준입니다.

**필드**
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  지정된 데이터 소스별로 결과를 필터링합니다. 예를 들어 AWS Glue 테이블의 모든 결과를 검색합니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  지정된 작업 이름을 기준으로 결과를 필터링합니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  지정된 작업 실행 ID를 기준으로 결과를 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  이 시간 이후에 시작된 실행을 기준으로 결과를 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  이 시간 이전에 시작된 실행을 기준으로 결과를 필터링합니다.

## DataQualityRulesetFilterCriteria 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria"></a>

데이터 품질 규칙 세트를 필터링하는 데 사용되는 기준입니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트 필터 기준의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  규칙 세트 필터 기준에 대한 설명입니다.
+ `CreatedBefore` – 타임스탬프입니다.

  이 날짜 이전에 생성된 규칙 세트에서 필터링합니다.
+ `CreatedAfter` – 타임스탬프입니다.

  이 날짜 이후에 생성된 규칙 세트에서 필터링합니다.
+ `LastModifiedBefore` – 타임스탬프입니다.

  이 날짜 이전에 마지막으로 수정된 규칙 세트에서 필터링합니다.
+ `LastModifiedAfter` – 타임스탬프입니다.

  이 날짜 이후에 마지막으로 수정된 규칙 세트에서 필터링합니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.

## DataQualityAggregatedMetrics 구조
<a name="aws-glue-api-data-quality-api-DataQualityAggregatedMetrics"></a>

행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 지표 요약입니다.

**필드**
+ `TotalRowsProcessed` - 숫자(double)입니다.

  데이터 품질 평가 중에 처리된 행의 총 개수입니다.
+ `TotalRowsPassed` - 숫자(double)입니다.

  해당하는 모든 데이터 품질 규칙을 통과한 행의 총 개수입니다.
+ `TotalRowsFailed` - 숫자(double)입니다.

  하나 이상의 데이터 품질 규칙에서 실패한 행의 총 개수입니다.
+ `TotalRulesProcessed` - 숫자(double)입니다.

  평가된 데이터 품질 규칙의 총 개수입니다.
+ `TotalRulesPassed` - 숫자(double)입니다.

  평가 기준을 통과한 데이터 품질 규칙의 총 개수입니다.
+ `TotalRulesFailed` - 숫자(double)입니다.

  평가 기준을 충족하지 못한 데이터 품질 규칙의 총 개수입니다.

## StatisticAnnotation 구조
<a name="aws-glue-api-data-quality-api-StatisticAnnotation"></a>

통계 주석.

**필드**
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `StatisticRecordedOn` – 타임스탬프입니다.

  주석이 달린 통계가 기록된 시점의 타임스탬프.
+ `InclusionAnnotation` – [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation) 객체입니다.

  통계에 적용된 포함 주석.

## TimestampedInclusionAnnotation 구조
<a name="aws-glue-api-data-quality-api-TimestampedInclusionAnnotation"></a>

타임스탬프가 지정된 포함 주석.

**필드**
+ `Value` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  포함 주석 값.
+ `LastModifiedOn` – 타임스탬프입니다.

  포함 주석이 마지막으로 수정된 시점의 타임스탬프.

## AnnotationError 구조
<a name="aws-glue-api-data-quality-api-AnnotationError"></a>

실패한 주석.

**필드**
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실패한 주석의 프로필 ID.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실패한 주석의 통계 ID.
+ `FailureReason` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  주석이 실패한 이유.

## DatapointInclusionAnnotation 구조
<a name="aws-glue-api-data-quality-api-DatapointInclusionAnnotation"></a>

포함 주석.

**필드**
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계가 속한 데이터 품질 프로필의 ID.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `InclusionAnnotation` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  통계에 적용할 포함 주석 값.

## StatisticSummaryList 목록
<a name="aws-glue-api-data-quality-api-StatisticSummaryList"></a>

`StatisticSummary` 목록.

[StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary) 객체 어레이.

`StatisticSummary` 목록.

## StatisticSummary 구조
<a name="aws-glue-api-data-quality-api-StatisticSummary"></a>

통계에 대한 요약 정보.

**필드**
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.
+ `RunIdentifier` – [RunIdentifier](#aws-glue-api-data-quality-api-RunIdentifier) 객체입니다.

  실행 식별자
+ `StatisticName` – [Custom string pattern #16](aws-glue-api-common.md#regex_16)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 이름.
+ `DoubleValue` - 숫자(double)입니다.

  통계 값.
+ `EvaluationLevel` – UTF-8 문자열입니다(유효한 값: `Dataset="DATASET"` \$1 `Column="COLUMN"` \$1 `Multicolumn="MULTICOLUMN"`).

  통계의 평가 수준. 가능한 값: `Dataset`, `Column`, `Multicolumn`.
+ `ColumnsReferenced` – UTF-8 문자열의 배열입니다.

  통계에서 참조하는 열 목록.
+ `ReferencedDatasets` – UTF-8 문자열의 배열입니다.

  통계에서 참조하는 데이터세트 목록.
+ `StatisticProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 설명 문자열(2,048바이트 이하)입니다.

  `NameString` 및 `DescriptionString`이 포함된 `StatisticPropertiesMap`
+ `RecordedOn` – 타임스탬프입니다.

  통계가 기록된 시점의 타임스탬프.
+ `InclusionAnnotation` – [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation) 객체입니다.

  통계의 포함 주석.

## RunIdentifier 구조
<a name="aws-glue-api-data-quality-api-RunIdentifier"></a>

실행 식별자.

**필드**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행 ID.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행 ID.

## StatisticModelResult 구조
<a name="aws-glue-api-data-quality-api-StatisticModelResult"></a>

통계 모델 결과.

**필드**
+ `LowerBound` - 숫자(double)입니다.

  하한.
+ `UpperBound` - 숫자(double)입니다.

  상한.
+ `PredictedValue` - 숫자(double)입니다.

  예측된 값.
+ `ActualValue` - 숫자(double)입니다.

  실제 값.
+ `Date` – 타임스탬프입니다.

  날짜.
+ `InclusionAnnotation` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  포함 주석.

## DataQualityGlueTable 구조
<a name="aws-glue-api-data-quality-api-DataQualityGlueTable"></a>

Data Quality 작업에 대한 입력 또는 출력 데이터에 사용되는 AWS Glue Data Catalog의 데이터베이스 및 테이블.

**필드**
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog의 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog의 테이블 이름입니다.
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog의 고유 식별자입니다.
+ `ConnectionName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog에 대한 연결 이름입니다.
+ `AdditionalOptions` – 1\$110개 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 설명 문자열(2,048바이트 이하)입니다.

  테이블에 대한 추가 옵션입니다. 현재 지원되는 키는 두 가지입니다.
  + `pushDownPredicate`: 데이터 세트 내 모든 파일을 나열하거나 읽지 않아도 파티션에 필터링합니다.
  + `catalogPartitionPredicate`: AWS Glue Data Catalog에서 파티션 인덱스를 사용하여 서버측 파티션 프루닝을 사용합니다.
+ `PreProcessingQuery` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 51,200바이트 이하 길이의 UTF-8 문자열.

  Data Quality 작업을 실행하기 전에 AWS Glue Data Catalog에서 테이블의 데이터를 사전 처리하는 데 사용할 수 있는 SparkSQL 형식의 SQL 쿼리.

## 운영
<a name="aws-glue-api-data-quality-api-actions"></a>
+ [StartDataQualityRulesetEvaluationRun 작업(Python: start\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun)
+ [CancelDataQualityRulesetEvaluationRun 작업(Python: cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun)
+ [GetDataQualityRulesetEvaluationRun 작업(Python: get\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun)
+ [ListDataQualityRulesetEvaluationRuns 작업(Python: list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns)
+ [StartDataQualityRuleRecommendationRun 작업(Python: start\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun)
+ [CancelDataQualityRuleRecommendationRun 작업(Python: cancel\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun)
+ [GetDataQualityRuleRecommendationRun 작업(Python: get\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun)
+ [ListDataQualityRuleRecommendationRuns 작업(Python: list\$1data\$1quality\$1rule\$1recommendation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns)
+ [GetDataQualityResult 작업(Python: get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-GetDataQualityResult)
+ [BatchGetDataQualityResult 작업(Python: batch\$1get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-BatchGetDataQualityResult)
+ [ListDataQualityResults 작업(Python: list\$1data\$1quality\$1results)](#aws-glue-api-data-quality-api-ListDataQualityResults)
+ [CreateDataQualityRuleset 작업(Python: create\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-CreateDataQualityRuleset)
+ [DeleteDataQualityRuleset 작업(Python: delete\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-DeleteDataQualityRuleset)
+ [GetDataQualityRuleset 작업(Python: get\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-GetDataQualityRuleset)
+ [ListDataQualityRulesets 작업(Python: list\$1data\$1quality\$1rulesets)](#aws-glue-api-data-quality-api-ListDataQualityRulesets)
+ [UpdateDataQualityRuleset 작업(Python: update\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-UpdateDataQualityRuleset)
+ [ListDataQualityStatistics 작업(Python: list\$1data\$1quality\$1statistics)](#aws-glue-api-data-quality-api-ListDataQualityStatistics)
+ [TimestampFilter 구조](#aws-glue-api-data-quality-api-TimestampFilter)
+ [CreateDataQualityRulesetRequest 구조](#aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest)
+ [GetDataQualityRulesetResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityRulesetResponse)
+ [GetDataQualityResultResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityResultResponse)
+ [StartDataQualityRuleRecommendationRunRequest 구조](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest)
+ [GetDataQualityRuleRecommendationRunResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse)
+ [BatchPutDataQualityStatisticAnnotation 작업(Python: batch\$1put\$1data\$1quality\$1statistic\$1annotation)](#aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation)
+ [GetDataQualityModel 작업(Python: get\$1data\$1quality\$1model)](#aws-glue-api-data-quality-api-GetDataQualityModel)
+ [GetDataQualityModelResult 작업(Python: get\$1data\$1quality\$1model\$1result)](#aws-glue-api-data-quality-api-GetDataQualityModelResult)
+ [ListDataQualityStatisticAnnotations 작업(Python: list\$1data\$1quality\$1statistic\$1annotations)](#aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations)
+ [PutDataQualityProfileAnnotation 작업(Python: put\$1data\$1quality\$1profile\$1annotation)](#aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation)

## StartDataQualityRulesetEvaluationRun 작업(Python: start\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun"></a>

규칙 세트 정의(권장 또는 사용자 고유)가 있는 경우 이 작업을 호출하여 데이터 소스(AWS Glue 테이블)를 기준으로 규칙 세트를 평가합니다. 평가 시 `GetDataQualityResult` API로 검색할 수 있는 결과가 계산됩니다.

**요청**
+ `DataSource` – **필수(Required): [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.
+ `AdditionalRunOptions` – [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.
+ `RulesetNames` – *필수:* 1\$110개 문자열의 UTF-8 문자열 배열입니다.

  규칙 세트 이름의 목록입니다.
+ `AdditionalDataSources` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 데이터 소스에 대한 참조 문자열의 맵입니다.

**응답**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConflictException`

## CancelDataQualityRulesetEvaluationRun 작업(Python: cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun"></a>

데이터 소스에 대해 규칙 세트를 평가 중인 실행을 취소합니다.

**요청**
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRulesetEvaluationRun 작업(Python: get\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun"></a>

데이터 소스에 대해 규칙 세트를 평가하는 특정 실행을 검색합니다.

**요청**
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 평가 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `AdditionalRunOptions` – [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RulesetNames` – UTF-8 문자열의 배열입니다(1\$110개 문자열).

  실행에 대한 규칙 세트 이름 목록입니다. 현재 이 파라미터는 하나의 규칙 집합 이름만 사용합니다.
+ `ResultIds` – UTF-8 문자열의 배열입니다(1\$110개 문자열).

  실행의 데이터 품질 결과에 대한 결과 ID 목록입니다.
+ `AdditionalDataSources` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 데이터 소스에 대한 참조 문자열의 맵입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRulesetEvaluationRuns 작업(Python: list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns"></a>

규칙 세트가 데이터 소스에 대해 평가되는 필터 조건을 충족하는 모든 실행을 나열합니다.

**요청**
+ `Filter` – [DataQualityRulesetEvaluationRunFilter](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Runs` – [DataQualityRulesetEvaluationRunDescription](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription) 객체의 배열입니다.

  데이터 품질 규칙 세트 실행을 나타내는 `DataQualityRulesetEvaluationRunDescription` 객체 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartDataQualityRuleRecommendationRun 작업(Python: start\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun"></a>

어떤 규칙을 작성해야 할지 모를 때 규칙을 생성하는 데 사용되는 권장 실행을 시작합니다. AWS Glue 데이터 품질은 데이터를 분석하고 잠재적 규칙 세트에 대한 권장 사항을 제시합니다. 그런 다음 규칙 세트를 분류하고 생성된 규칙 세트를 원하는 대로 수정할 수 있습니다.

권장 사항 실행은 90일 후에 자동으로 삭제됩니다.

**요청**

데이터 품질 규칙 권장 사항 요청.
+ `DataSource` – **필수(Required): [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

**응답**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConflictException`

## CancelDataQualityRuleRecommendationRun 작업(Python: cancel\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun"></a>

규칙을 생성하는 데 사용된 지정된 권장 실행을 취소합니다.

**요청**
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRuleRecommendationRun 작업(Python: get\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun"></a>

규칙을 생성하는 데 사용된 지정된 권장 실행을 가져옵니다.

**요청**
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.

**응답**

데이터 품질 규칙 권장 사항 실행에 대한 응답.
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RecommendedRuleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  시작 규칙 권장 실행이 완료되면 권장 규칙 세트(규칙 세트)가 생성됩니다. 이 멤버는 DQDL(데이터 품질 정의 언어) 형식 규칙을 포함합니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행에서 생성된 규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRuleRecommendationRuns 작업(Python: list\$1data\$1quality\$1rule\$1recommendation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns"></a>

필터 기준에 맞는 권장 실행을 나열합니다.

**요청**
+ `Filter` – [DataQualityRuleRecommendationRunFilter](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Runs` – [DataQualityRuleRecommendationRunDescription](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription) 객체의 배열입니다.

  `DataQualityRuleRecommendationRunDescription` 객체의 목록.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityResult 작업(Python: get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityResult"></a>

데이터 품질 규칙 평가 결과를 검색합니다.

**요청**
+ `ResultId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 고유한 결과 ID입니다.

**응답**

데이터 품질 결과에 대한 응답.
+ `ResultId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트 평가와 연결된 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `EntityNotFoundException`

## BatchGetDataQualityResult 작업(Python: batch\$1get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-BatchGetDataQualityResult"></a>

지정된 결과 ID에 대한 데이터 품질 결과 목록을 검색합니다.

**요청**
+ `ResultIds` – **필수: 1\$1100개 문자열의 UTF-8 문자열 배열입니다.

  데이터 품질 결과에 대한 고유한 결과 ID 목록입니다.

**응답**
+ `Results` – **필수(Required): [DataQualityResult](#aws-glue-api-data-quality-api-DataQualityResult) 객체의 배열입니다.

  데이터 품질 결과를 나타내는 `DataQualityResult` 객체 목록입니다.
+ `ResultsNotFound` – UTF-8 문자열의 배열입니다(1\$1100개 문자열).

  결과를 찾을 수 없는 결과 ID 목록입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityResults 작업(Python: list\$1data\$1quality\$1results)
<a name="aws-glue-api-data-quality-api-ListDataQualityResults"></a>

계정의 모든 데이터 품질 실행 결과를 반환합니다.

**요청**
+ `Filter` – [DataQualityResultFilterCriteria](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Results` – **필수(Required): [DataQualityResultDescription](#aws-glue-api-data-quality-api-DataQualityResultDescription) 객체의 배열입니다.

  `DataQualityResultDescription` 객체의 목록.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## CreateDataQualityRuleset 작업(Python: create\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-CreateDataQualityRuleset"></a>

지정된 AWS Glue 테이블에 적용된 DQDL 규칙을 사용하여 데이터 품질 규칙 세트를 생성합니다.

DQDL(데이터 품질 정의 언어)을 사용하여 규칙 세트를 생성합니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

**요청**

데이터 품질 규칙 세트를 생성하려는 요청.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 고유한 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `Ruleset` – **필수: 2\$165536바이트 길이의 UTF-8 문자열입니다.

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  데이터 품질 규칙 세트에 적용된 태그 목록입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  데이터 품질 규칙 세트와 연결된 대상 테이블입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행의 고유한 실행 ID입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 고유한 이름입니다.

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## DeleteDataQualityRuleset 작업(Python: delete\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-DeleteDataQualityRuleset"></a>

데이터 품질 규칙 세트를 삭제합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 이름입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRuleset 작업(Python: get\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleset"></a>

식별자 또는 이름을 기준으로 기존 규칙 세트를 반환합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트의 이름입니다.

**응답**

데이터 품질 규칙 세트 응답을 반환합니다.
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.
+ `CreatedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 수정된 마지막 시점입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRulesets 작업(Python: list\$1data\$1quality\$1rulesets)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesets"></a>

지정된 AWS Glue 테이블 목록에 대한 페이지 매김 규칙 세트 목록을 반환합니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `Filter` – [DataQualityRulesetFilterCriteria](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria) 객체입니다.

  필터 기준입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  키-값 페어 태그의 목록입니다.

**응답**
+ `Rulesets` – [DataQualityRulesetListDetails](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails) 객체의 배열입니다.

  지정된 AWS Glue 테이블 목록에 대한 페이지 매김 규칙 세트 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## UpdateDataQualityRuleset 작업(Python: update\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-UpdateDataQualityRuleset"></a>

지정된 데이터 품질 규칙 세트를 업데이트합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

**오류**
+ `EntityNotFoundException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## ListDataQualityStatistics 작업(Python: list\$1data\$1quality\$1statistics)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatistics"></a>

데이터 품질 통계 목록을 검색합니다.

**요청**
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.
+ `TimestampFilter` – [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter) 객체입니다.

  타임스탬프 필터.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  이 요청에서 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과의 다음 페이지를 요청하기 위한 페이지 매김 토큰.

**응답**
+ `Statistics` – [StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary) 객체의 배열입니다.

  `StatisticSummaryList`.
+ `NextToken` – UTF-8 문자열입니다.

  결과의 다음 페이지를 요청하기 위한 페이지 매김 토큰.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`

## TimestampFilter 구조
<a name="aws-glue-api-data-quality-api-TimestampFilter"></a>

타임스탬프 필터.

**필드**
+ `RecordedBefore` – 타임스탬프입니다.

  특정 시간 이전의 통계를 결과에 포함해야 하는 경우 해당 타임스탬프.
+ `RecordedAfter` – 타임스탬프입니다.

  특정 시간 이후의 통계를 결과에 포함해야 하는 경우 해당 타임스탬프.

## CreateDataQualityRulesetRequest 구조
<a name="aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest"></a>

데이터 품질 규칙 세트를 생성하려는 요청.

**필드**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 고유한 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `Ruleset` – **필수: 2\$165536바이트 길이의 UTF-8 문자열입니다.

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  데이터 품질 규칙 세트에 적용된 태그 목록입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  데이터 품질 규칙 세트와 연결된 대상 테이블입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행의 고유한 실행 ID입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

## GetDataQualityRulesetResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetResponse"></a>

데이터 품질 규칙 세트 응답을 반환합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.
+ `CreatedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 수정된 마지막 시점입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

## GetDataQualityResultResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityResultResponse"></a>

데이터 품질 결과에 대한 응답.

**필드**
+ `ResultId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트 평가와 연결된 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

## StartDataQualityRuleRecommendationRunRequest 구조
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest"></a>

데이터 품질 규칙 권장 사항 요청.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

## GetDataQualityRuleRecommendationRunResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse"></a>

데이터 품질 규칙 권장 사항 실행에 대한 응답.

**필드**
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RecommendedRuleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  시작 규칙 권장 실행이 완료되면 권장 규칙 세트(규칙 세트)가 생성됩니다. 이 멤버는 DQDL(데이터 품질 정의 언어) 형식 규칙을 포함합니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행에서 생성된 규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

## BatchPutDataQualityStatisticAnnotation 작업(Python: batch\$1put\$1data\$1quality\$1statistic\$1annotation)
<a name="aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation"></a>

특정 데이터 품질 통계에 대해 시간 경과에 따른 데이터 포인트에 주석을 지정합니다. API에는 InclusionAnnotation 입력의 일부로 profileID 및 statisticID가 모두 필요합니다. API는 여러 프로파일에 걸쳐 단일 statisticId에 대해서만 작동합니다.

**요청**
+ `InclusionAnnotations` – **필수(Required): [DatapointInclusionAnnotation](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation) 객체의 배열입니다.

  `DatapointInclusionAnnotation`의 목록. InclusionAnnotation에는 profileId 및 statisticId가 포함되어야 합니다. InclusionAnnotation이 여러 개인 경우 목록은 여러 profileId에 걸쳐 단일 statisticId를 참조해야 합니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  클라이언트 토큰.

**응답**
+ `FailedInclusionAnnotations` – [AnnotationError](#aws-glue-api-data-quality-api-AnnotationError) 객체의 배열입니다.

  `AnnotationError`의 목록.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## GetDataQualityModel 작업(Python: get\$1data\$1quality\$1model)
<a name="aws-glue-api-data-quality-api-GetDataQualityModel"></a>

자세한 정보(CompletedOn, StartedOn, FailureReason)와 함께 모델의 훈련 상태를 검색합니다.

**요청**
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `ProfileId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.

**응답**
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED`).

  데이터 품질 모델의 훈련 상태.
+ `StartedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 시작된 시점의 타임스탬프.
+ `CompletedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 완료된 시점의 타임스탬프.
+ `FailureReason` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  훈련 실패 이유.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityModelResult 작업(Python: get\$1data\$1quality\$1model\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityModelResult"></a>

지정된 프로필 ID에 대한 통계의 예측을 검색합니다.

**요청**
+ `StatisticId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `ProfileId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.

**응답**
+ `CompletedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 완료된 시점의 타임스탬프.
+ `Model` – [StatisticModelResult](#aws-glue-api-data-quality-api-StatisticModelResult) 객체의 배열입니다.

  `StatisticModelResult` 목록

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityStatisticAnnotations 작업(Python: list\$1data\$1quality\$1statistic\$1annotations)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations"></a>

데이터 품질 통계에 대한 주석을 검색합니다.

**요청**
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  프로필 ID.
+ `TimestampFilter` – [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter) 객체입니다.

  타임스탬프 필터.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  이 요청에서 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  다음 결과 세트를 검색하기 위한 페이지 매김 토큰.

**응답**
+ `Annotations` – [StatisticAnnotation](#aws-glue-api-data-quality-api-StatisticAnnotation) 객체의 배열입니다.

  통계에 적용된 `StatisticAnnotation`의 목록
+ `NextToken` – UTF-8 문자열입니다.

  다음 결과 세트를 검색하기 위한 페이지 매김 토큰.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`

## PutDataQualityProfileAnnotation 작업(Python: put\$1data\$1quality\$1profile\$1annotation)
<a name="aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation"></a>

프로필의 모든 데이터 포인트에 주석을 작성합니다.

**요청**
+ `ProfileId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  주석을 달 데이터 품질 모니터링 프로필의 ID.
+ `InclusionAnnotation` – *필수:* UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  프로필에 적용할 포함 주석 값.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`