# 비즈니스 컨텍스트 API
비즈니스 컨텍스트 API는 AWS Glue Data Catalog에서 자산, 자산 유형, 양식 유형, 용어집, 용어집 용어, 연결 및 검색을 관리하기 위한 데이터 유형과 작업을 설명합니다.
## 데이터 타입
+ [AssetFormEntry 구조](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)
+ [AssetTypeFormReference 구조](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference)
+ [IterableFormEntry 구조](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry)
+ [IterableFormItem 구조](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem)
+ [IterableFormListItem 구조](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem)
+ [SearchResultItem 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem)
+ [SearchSort 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort)
+ [SearchFilterClause 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause)
+ [SearchAttributeFilter 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter)
+ [SearchFilterValue 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue)
+ [ItemError 구조](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError)
+ [GetAssetOutput 구조](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput)
+ [SearchOutput 구조](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput)
## AssetFormEntry 구조
자산의 양식이며 양식 유형 식별자와 해당 JSON 콘텐츠로 구성됩니다.
**필드**
+ `FormTypeId` – UTF-8 문자열입니다(1\~256바이트 이하)
이 양식의 스키마를 정의하는 양식 유형의 식별자입니다.
+ `Content` – UTF-8 문자열입니다.
지정된 양식 유형의 스키마를 준수하는 양식의 JSON 콘텐츠입니다.
## AssetTypeFormReference 구조
자산 유형에 포함된 양식 유형에 대한 참조입니다.
**필드**
+ `FormTypeIdentifier` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
참조된 양식 유형의 식별자입니다.
## IterableFormEntry 구조
자산에 사용할 수 있는 반복 가능한 양식이며 양식 유형으로 식별됩니다.
**필드**
+ `FormTypeId` – UTF-8 문자열입니다(1\~256바이트 이하)
`ListIterableForms` 또는 `BatchGetIterableForms`를 통해 항목을 검색하는 데 사용되는 반복 가능한 양식의 양식 유형 식별자(예: `columns`)입니다.
## IterableFormItem 구조
해당 양식이 포함된 전체 반복 가능한 양식 항목입니다.
**필드**
+ `ItemId` – UTF-8 문자열입니다.
항목의 고유 식별자입니다.
+ `ItemName` – UTF-8 문자열입니다.
항목의 이름입니다.
+ `GlossaryTerms` – UTF-8 문자열의 배열입니다(1\~10개 문자열).
항목과 연결된 용어집 용어의 식별자입니다.
+ `Forms` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
항목의 양식이며 양식 이름으로 분류됩니다.
+ `Attachments` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
추가 컨텍스트를 위한 항목의 추가 연결이며 연결 이름으로 분류됩니다.
## IterableFormListItem 구조
반복 가능한 양식의 항목에 대한 요약입니다.
**필드**
+ `ItemId` – UTF-8 문자열입니다.
항목의 고유 식별자입니다.
+ `ItemName` – UTF-8 문자열입니다.
항목의 이름입니다.
+ `Description` – UTF-8 문자열입니다.
항목에 대한 설명입니다.
+ `GlossaryTerms` – UTF-8 문자열의 배열입니다(1\~10개 문자열).
항목과 연결된 용어집 용어의 식별자입니다.
## SearchResultItem 구조
일치하는 자산을 나타내는 단일 검색 결과 항목입니다.
**필드**
+ `Id` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
일치하는 자산의 고유 식별자입니다.
+ `AssetName` – UTF-8 문자열입니다.
일치하는 자산의 이름입니다.
+ `AssetDescription` – UTF-8 문자열입니다.
일치하는 자산에 대한 설명입니다.
+ `UpdatedAt` – 타임스탬프입니다.
일치하는 자산이 마지막으로 업데이트된 타임스탬프입니다.
+ `AssetTypeId` – UTF-8 문자열입니다(1\~256바이트 이하)
일치하는 자산에 대한 자산 유형의 식별자입니다.
## SearchSort 구조
검색 결과의 정렬 기준입니다.
**필드**
+ `Attribute` – **필수: 1\~128바이트 길이의 UTF-8 문자열입니다.
정렬 기준으로 사용할 속성입니다.
+ `Order` – UTF-8 문자열입니다(유효한 값: `ASCENDING` \| `DESCENDING`).
정렬 순서입니다. 유효 값은 `ASCENDING` 및 `DESCENDING`입니다.
## SearchFilterClause 구조
중첩된 부울 로직을 지원하는 필터 절입니다. `andAllFilters`, `orAnyFilters`, `attributeFilter` 또는 `mapFilter` 중 정확히 하나를 지정해야 합니다.
**필드**
+ `AndAllFilters` – [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 객체의 배열이며 구조는 1\~10개입니다.
모두 일치해야 하는 필터 절의 목록입니다(논리 AND).
+ `OrAnyFilters` – [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 객체의 배열이며 구조는 1\~10개입니다.
하나 이상 일치해야 하는 필터 절의 목록입니다(논리 OR).
+ `AttributeFilter` – [SearchAttributeFilter](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter) 객체입니다.
단일 속성 값에 대한 필터입니다.
+ `MapFilter` – .
맵 속성의 키-값 페어에 대한 필터입니다.
## SearchAttributeFilter 구조
연산자를 사용하여 속성 값을 비교하는 필터입니다.
**필드**
+ `Attribute` – **필수: 1\~128바이트 길이의 UTF-8 문자열입니다.
필터링할 속성 이름입니다.
+ `Operator` – *필수:* UTF-8 문자열입니다(유효한 값: `equals` \| `greaterThan` \| `greaterThanOrEquals` \| `lessThan` \| `lessThanOrEquals` \| `notExists`).
비교 연산자. 유효한 값은 `equals`, `greaterThan`, `greaterThanOrEquals`, `lessThan`, `lessThanOrEquals` 및 `notExists`입니다.
+ `Value` – [SearchFilterValue](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue) 객체입니다.
비교할 값입니다.
## SearchFilterValue 구조
필터 값입니다. `stringValue` 또는 `longValue` 중 정확히 하나를 지정해야 합니다.
**필드**
+ `StringValue` – 256바이트 이하 길이의 UTF-8 문자열입니다.
문자열 필터 값입니다.
+ `LongValue` - 숫자(정수)입니다.
정수(long) 필터 값입니다.
## ItemError 구조
반복 가능한 양식 항목을 검색할 때 발생한 오류입니다.
**필드**
+ `ItemIdentifier` – UTF-8 문자열입니다(1\~1087바이트 이하)
오류를 발생시킨 항목의 식별자입니다.
+ `Code` – UTF-8 문자열입니다.
오류 코드입니다.
+ `Message` – UTF-8 문자열입니다.
오류 메시지입니다.
## GetAssetOutput 구조
`GetAsset` 작업에 대한 응답 구조입니다.
**필드**
+ `Id` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다.
자산 이름.
+ `Description` – UTF-8 문자열입니다.
자산에 대한 설명입니다.
+ `CreatedAt` – 타임스탬프입니다.
자산이 생성된 타임스탬프입니다.
+ `UpdatedAt` – 타임스탬프입니다.
자산이 마지막으로 업데이트된 타임스탬프입니다.
+ `CreatedBy` – .
자산을 생성한 위탁자의 ID입니다.
+ `UpdatedBy` – .
자산을 마지막으로 업데이트한 위탁자의 ID입니다.
+ `AssetTypeId` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
이 자산에 대한 자산 유형의 식별자입니다.
+ `GlossaryTerms` – UTF-8 문자열의 배열입니다(1\~10개 문자열).
항목과 연결된 용어집 용어의 식별자입니다.
+ `Forms` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
자산의 양식이며 양식 이름으로 분류됩니다.
+ `Attachments` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
추가 컨텍스트를 위한 자산의 추가 연결이며 연결 이름으로 분류됩니다.
+ `IterableForms` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [IterableFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry) 객체입니다.
자산에서 사용할 수 있는 반복 가능한 양식이며 양식 이름(예: `columns`)으로 분류됩니다. 양식 이름을 `ListIterableForms` 또는 `BatchGetIterableForms`와 함께 사용하여 양식의 항목을 검색할 수 있습니다.
## SearchOutput 구조
`Search` 작업에 대한 응답 구조입니다.
**필드**
+ `Items` – [SearchResultItem](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem) 객체의 배열입니다.
검색 기준과 일치하는 자산의 목록입니다.
+ `TotalCount` - 숫자(정수)입니다.
검색 기준과 일치하는 총 자산 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
+ `Aggregations` – 객체의 배열입니다.
요청된 속성에 대한 집계 결과입니다.
## 운영
+ [GetAsset 작업(Python: get\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAsset)
+ [PutAsset 작업(Python: put\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAsset)
+ [DeleteAsset 작업(Python: delete\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAsset)
+ [PutAssetType 작업(Python: put\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAssetType)
+ [GetAssetType 작업(Python: get\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetType)
+ [DeleteAssetType 작업(Python: delete\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAssetType)
+ [ListAssetTypes 작업(Python: list\_asset\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListAssetTypes)
+ [PutFormType 작업(Python: put\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutFormType)
+ [GetAssetType 작업(Python: get\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetFormType)
+ [DeleteFormType 작업(Python: delete\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteFormType)
+ [ListAssetTypes 작업(Python: list\_asset\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListFormTypes)
+ [PutAttachment 작업(Python: put\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAttachment)
+ [DeleteAttachment 작업(Python: delete\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAttachment)
+ [ListIterableForms 작업(Python: list\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListIterableForms)
+ [BatchGetIterableForms 작업(Python: batch\_get\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-BatchGetIterableForms)
+ [CreateGlossary 작업(Python: create\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossary)
+ [GetGlossary 작업(Python: get\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossary)
+ [UpdateGlossary 작업(Python: update\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossary)
+ [DeleteGlossary 작업(Python: delete\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossary)
+ [ListGlossaries 작업(Python: list\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaries)
+ [CreateGlossaryTerm 작업(Python: create\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossaryTerm)
+ [GetGlossaryTerm 작업(Python: get\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossaryTerm)
+ [UpdateGlossaryTerm 작업(Python: update\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossaryTerm)
+ [DeleteGlossaryTerm 작업(Python: delete\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossaryTerm)
+ [ListGlossaryTerms 작업(Python: list\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaryTerms)
+ [AssociateGlossaryTerms 작업(Python: associate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-AssociateGlossaryTerms)
+ [DisassociateGlossaryTerms 작업(Python: disassociate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-DisassociateGlossaryTerms)
+ [Search 작업(Python: search)](#aws-glue-api-catalog-aws-glue-api-semantics-Search)
## GetAsset 작업(Python: get\_asset)
양식, 추가 연결 및 관련 용어집 용어를 포함하여 AWS Glue Data Catalog의 자산에 대한 메타데이터를 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 자산을 검색합니다.
```
aws glue get-asset --identifier quarterly-sales-2026q1
{
"Id": "quarterly-sales-2026q1",
"Name": "Quarterly Sales 2026 Q1",
"Description": "Aggregated quarterly sales metrics",
"CreatedAt": "2026-06-16T06:42:00.442Z",
"AssetTypeId": "DataSet",
"GlossaryTerms": [],
"Forms": {
"DataClassification": {
"FormTypeId": "DataClassification",
"Content": "{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}"
}
},
"Attachments": {},
"IterableForms": {}
}
```
**요청**
+ `Identifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
검색할 자산의 고유 식별자입니다.
**응답**
`GetAsset` 작업에 대한 응답 구조입니다.
+ `GetAssetOutput` – [GetAssetOutput](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput) 객체입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `InvalidInputException`
## PutAsset 작업(Python: put\_asset)
AWS Glue Data Catalog에서 자산을 생성하거나 업데이트합니다. 자산이 이미 있으면 자산이 업데이트되고, 그렇지 않으면 새 자산이 생성됩니다.
**Example**
다음 예제에서는 양식이 있는 자산을 생성합니다.
```
aws glue put-asset \
--asset-type-id DataSet \
--identifier quarterly-sales-2026q1 \
--name "Quarterly Sales 2026 Q1" \
--description "Aggregated quarterly sales metrics" \
--forms '{"DataClassification":{"FormTypeId":"DataClassification","Content":"{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}"}}'
{
"Id": "quarterly-sales-2026q1",
"Name": "Quarterly Sales 2026 Q1",
"Description": "Aggregated quarterly sales metrics",
"CreatedAt": "2026-06-16T06:42:00.442Z",
"Forms": {
"DataClassification": {
"FormTypeId": "DataClassification",
"Content": "{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}"
}
}
}
```
**요청**
+ `AssetTypeId` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
자산에 대한 자산 유형의 식별자입니다.
+ `Identifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다. 이 식별자의 자산이 이미 있으면 자산이 업데이트됩니다.
+ `Name` – *필수:* UTF-8 문자열입니다.
자산 이름.
+ `Description` – UTF-8 문자열입니다.
자산에 대한 설명입니다.
+ `Forms` – *필수(Required):* 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
자산에 설정할 양식이며 양식 이름으로 분류됩니다. 각 항목은 양식 유형과 해당 JSON 콘텐츠를 지정합니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `Name` – *필수:* UTF-8 문자열입니다.
자산 이름.
+ `Description` – UTF-8 문자열입니다.
자산에 대한 설명입니다.
+ `CreatedAt` – 타임스탬프입니다.
자산이 생성된 타임스탬프입니다.
+ `Forms` – 키-값 페어의 맵 배열입니다.
각 키는 UTF-8 문자열입니다.
각 값은 [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 객체입니다.
자산에 연결된 양식이며 양식 이름으로 분류됩니다.
**오류**
+ `AccessDeniedException`
+ `ConcurrentModificationException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteAsset 작업(Python: delete\_asset)
AWS Glue Data Catalog에서 자산을 삭제합니다.
**Example**
다음 예제에서는 식별자를 기준으로 자산을 삭제합니다.
```
aws glue delete-asset --identifier quarterly-sales-2026q1
```
**요청**
+ `Identifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
삭제할 자산의 고유 식별자입니다.
**응답**
+ *무응답 파라미터.*
**오류**
+ `AccessDeniedException`
+ `ConcurrentModificationException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutAssetType 작업(Python: put\_asset\_type)
AWS Glue Data Catalog에서 자산 유형을 생성하거나 업데이트합니다. 자산 유형은 자산에 포함되는 양식을 지정하여 자산의 구조를 정의합니다. 지정된 이름의 자산 유형이 이미 있으면 자산이 업데이트됩니다.
**Example**
다음 예제에서는 양식 유형을 참조하는 자산 유형을 생성합니다.
```
aws glue put-asset-type \
--name DataSet \
--forms '{"DataClassification":{"FormTypeIdentifier":"DataClassification"}}'
{
"Id": "DataSet",
"Name": "DataSet",
"Forms": {
"DataClassification": {
"FormTypeIdentifier": "DataClassification"
}
}
}
```
**요청**
+ `Name` – *필수(Required):* `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
자산 유형의 이름입니다.
+ `Forms` – *필수:* 1\~100개의 키-값 페어로 구성된 맵 배열입니다.
각 키는 `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
각 값은 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 객체입니다.
자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다. 각 항목은 양식의 스키마를 정의하는 양식 유형을 참조합니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다(1\~256바이트 이하)
자산 유형의 식별자입니다.
+ `Name` – `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
자산 유형의 이름입니다.
+ `Forms` – 1\~100개 페어로 구성된 키-값 페어의 맵 배열입니다.
각 키는 `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
각 값은 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 객체입니다.
자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## GetAssetType 작업(Python: get\_asset\_type)
AWS Glue Data Catalog에서 식별자를 기준으로 자산 유형을 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 자산 유형을 검색합니다.
```
aws glue get-asset-type --identifier DataSet
{
"Id": "DataSet",
"Name": "DataSet",
"Forms": {
"DataClassification": {
"FormTypeIdentifier": "DataClassification"
}
}
}
```
**요청**
+ `Identifier` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
검색할 자산 유형의 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다(1\~256바이트 이하)
자산 유형의 식별자입니다.
+ `Name` – `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
자산 유형의 이름입니다.
+ `Forms` – 1\~100개 페어로 구성된 키-값 페어의 맵 배열입니다.
각 키는 `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
각 값은 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 객체입니다.
자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteAssetType 작업(Python: delete\_asset\_type)
AWS Glue Data Catalog에서 자산 유형을 삭제합니다.
**Example**
다음 예제에서는 식별자를 기준으로 자산 유형을 삭제합니다.
```
aws glue delete-asset-type --identifier DataSet
```
**요청**
+ `Identifier` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
삭제할 자산 유형의 식별자입니다.
**응답**
+ *무응답 파라미터.*
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListAssetTypes 작업(Python: list\_asset\_types)
AWS Glue Data Catalog에서 정의된 자산 유형을 나열합니다.
**Example**
다음 예제에서는 계정의 자산 유형을 나열합니다.
```
aws glue list-asset-types --max-results 20
{
"Items": [
{
"Id": "DataSet",
"Name": "DataSet"
}
]
}
```
**요청**
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
**응답**
+ `Items` – 객체의 배열입니다.
자산 유형 항목의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutFormType 작업(Python: put\_form\_type)
AWS Glue Data Catalog에서 양식 유형을 생성하거나 업데이트합니다. 양식 유형은 자산에 연결할 수 있는 정형 메타데이터의 스키마를 정의합니다.
**Example**
다음 예제에서는 Smithy 스키마를 사용하여 양식 유형을 생성합니다.
```
aws glue put-form-type \
--name DataClassification \
--schema 'structure DataClassification {
classification: String
owner: String
}'
{
"Id": "DataClassification",
"Name": "DataClassification",
"Schema": "structure DataClassification {\n classification: String\n owner: String\n}"
}
```
**요청**
+ `Name` – *필수(Required):* `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
양식 유형의 이름입니다. 대문자로 시작해야 합니다.
+ `Schema` – *필수:* 1\~100,000바이트 길이의 UTF-8 문자열입니다.
양식 유형에 대한 Smithy IDL 스키마 정의입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다(1\~256바이트 이하)
양식 유형의 식별자입니다.
+ `Name` – `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
양식 유형의 이름입니다.
+ `Schema` – UTF-8 문자열입니다(1\~100,000바이트).
양식 유형의 Smithy IDL 스키마입니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## GetAssetType 작업(Python: get\_asset\_type)
AWS Glue Data Catalog에서 식별자를 기준으로 양식 유형을 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 양식 유형을 검색합니다.
```
aws glue get-form-type --identifier DataClassification
{
"Id": "DataClassification",
"Name": "DataClassification",
"Schema": "structure DataClassification {\n classification: String\n owner: String\n}"
}
```
**요청**
+ `Identifier` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
검색할 양식 유형의 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다(1\~256바이트 이하)
양식 유형의 식별자입니다.
+ `Name` – `String`과(와) 일치하는 1\~128바이트 길이의 UTF-8 문자열입니다.
양식 유형의 이름입니다.
+ `Schema` – UTF-8 문자열입니다(1\~100,000바이트).
양식 유형의 Smithy IDL 스키마입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteFormType 작업(Python: delete\_form\_type)
AWS Glue Data Catalog에서 양식 유형을 삭제합니다. 양식 유형이 자산 유형에서 여전히 참조되는 경우 삭제할 수 없습니다.
**Example**
다음 예제에서는 식별자를 기준으로 양식 유형을 삭제합니다.
```
aws glue delete-form-type --identifier DataClassification
```
**요청**
+ `Identifier` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
삭제할 양식 유형의 식별자입니다.
**응답**
+ *무응답 파라미터.*
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ConflictException`
+ `ThrottlingException`
## ListAssetTypes 작업(Python: list\_asset\_types)
AWS Glue Data Catalog에서 정의된 양식 유형을 나열합니다.
**Example**
다음 예제에서는 계정의 양식 유형을 나열합니다.
```
aws glue list-form-types --max-results 20
{
"Items": [
{
"Id": "DataClassification",
"Name": "DataClassification"
}
]
}
```
**요청**
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
**응답**
+ `Items` – *필수:* 객체의 배열입니다.
양식 유형 항목의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutAttachment 작업(Python: put\_attachment)
AWS Glue Data Catalog에서 자산 또는 반복 가능한 양식 항목에 양식을 연결합니다. 동일한 이름의 연결이 이미 존재하는 경우 해당 연결을 덮어씁니다.
**Example**
다음 예제에서는 자산에 양식을 연결합니다.
```
aws glue put-attachment \
--asset-identifier quarterly-sales-2026q1 \
--attachment-name reviewNote \
--form-type-id DataClassification \
--content '{"classification":"internal","owner":"analytics-team"}'
{
"AssetId": "quarterly-sales-2026q1",
"AttachmentName": "reviewNote",
"FormTypeId": "DataClassification"
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
양식을 연결할 자산의 고유 식별자입니다.
+ `IterableFormName` – `String`과(와) 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
반복 가능한 양식의 이름입니다. `itemIdentifier`와 함께 지정 시 연결은 자산 자체가 아닌 반복 가능한 양식 내 항목 중 하나를 대상으로 합니다.
+ `ItemIdentifier` – UTF-8 문자열입니다(1\~1087바이트 이하)
반복 가능한 양식 내 항목의 식별자입니다. `iterableFormName`를 지정한 경우 필수입니다.
+ `AttachmentName` – *필수:* `String`과 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
연결의 이름입니다.
+ `Content` – *필수:* UTF-8 문자열입니다.
지정된 양식 유형의 스키마를 준수하는 양식의 JSON 콘텐츠입니다.
+ `FormTypeId` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
이 연결에 대한 양식 유형의 식별자입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `AssetId` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `IterableFormName` – `String`과(와) 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
연결이 항목을 대상으로 하는 경우 반복 가능한 양식의 이름입니다.
+ `ItemIdentifier` – UTF-8 문자열입니다(1\~1087바이트 이하)
해당되는 경우 반복 가능한 양식 내 항목의 식별자입니다.
+ `AttachmentName` – `String`과(와) 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
연결의 이름입니다.
+ `FormTypeId` – UTF-8 문자열입니다(1\~256바이트 이하)
이 연결에 대한 양식 유형의 식별자입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## DeleteAttachment 작업(Python: delete\_attachment)
AWS Glue Data Catalog에서 자산으로부터 양식 연결을 삭제합니다.
**Example**
다음 예제에서는 자산으로부터 연결을 삭제합니다.
```
aws glue delete-attachment \
--identifier quarterly-sales-2026q1 \
--attachment-name reviewNote
{
"Identifier": "quarterly-sales-2026q1"
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
연결을 삭제할 자산의 고유 식별자입니다.
+ `AttachmentName` – *필수:* `String`과 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
삭제할 연결의 이름입니다.
**응답**
+ `Identifier` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListIterableForms 작업(Python: list\_iterable\_forms)
AWS Glue Data Catalog에서 자산의 반복 가능한 양식의 항목을 나열합니다. 예를 들어, 테이블 자산의 열을 나열합니다.
**Example**
다음 예제에서는 자산의 열을 나열합니다.
```
aws glue list-iterable-forms \
--asset-identifier quarterly-sales-2026q1 \
--iterable-form-name columns \
--max-results 20
{
"AssetId": "quarterly-sales-2026q1",
"IterableFormName": "columns",
"Items": [
{
"ItemId": "quarterly-sales-2026q1#region",
"ItemName": "region",
"Description": "AWS region of the sales record",
"GlossaryTerms": []
},
{
"ItemId": "quarterly-sales-2026q1#amount",
"ItemName": "amount",
"Description": "Sales amount in USD",
"GlossaryTerms": []
}
]
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `IterableFormName` – *필수:* `String`과 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
항목을 나열할 반복 가능한 양식의 이름입니다.
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
**응답**
+ `AssetId` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `IterableFormName` – `String`과(와) 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
반복 가능한 양식의 이름입니다.
+ `Items` – [IterableFormListItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem) 객체의 배열입니다.
반복 가능한 양식 항목의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `InvalidInputException`
## BatchGetIterableForms 작업(Python: batch\_get\_iterable\_forms)
단일 요청으로 AWS Glue Data Catalog에서 자산의 반복 가능한 양식의 여러 항목을 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 특정 열을 검색합니다.
```
aws glue batch-get-iterable-forms \
--asset-identifier quarterly-sales-2026q1 \
--iterable-form-name columns \
--item-identifiers region amount
{
"Items": [
{
"ItemId": "quarterly-sales-2026q1#region",
"ItemName": "region",
"GlossaryTerms": [],
"Forms": {
"columns": {
"FormTypeId": "amazon.glue::Column",
"Content": "{\"type\":\"string\"}"
}
},
"Attachments": {}
},
{
"ItemId": "quarterly-sales-2026q1#amount",
"ItemName": "amount",
"GlossaryTerms": [],
"Forms": {
"columns": {
"FormTypeId": "amazon.glue::Column",
"Content": "{\"type\":\"double\"}"
}
},
"Attachments": {}
}
],
"Errors": []
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `IterableFormName` – *필수:* `String`과 일치하는 1\~256바이트 길이의 UTF-8 문자열입니다.
항목을 검색할 반복 가능한 양식의 이름입니다.
+ `ItemIdentifiers` – **필수: 1\~100개 문자열의 UTF-8 문자열 배열입니다.
검색할 항목 식별자의 목록입니다. 각 식별자는 항목 ID 또는 항목 이름일 수 있습니다.
**응답**
+ `Items` – [IterableFormItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem) 객체의 배열입니다.
검색된 반복 가능한 양식 항목의 목록입니다.
+ `Errors` – [ItemError](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError) 객체의 배열입니다.
검색할 수 없는 항목에 대한 오류 목록입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## CreateGlossary 작업(Python: create\_glossary)
AWS Glue Data Catalog에서 비즈니스 용어집을 생성합니다. 용어집은 비즈니스 개념을 정의하는 용어집 용어의 컨테이너입니다.
**Example**
다음 예제에서는 비즈니스 용어집을 생성합니다.
```
aws glue create-glossary \
--name "Sales Terms" \
--description "Glossary of sales-domain business terms"
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales-domain business terms"
}
```
**요청**
+ `Name` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
용어집의 이름입니다.
+ `Description` – UTF-8 문자열입니다(1\~2,048바이트).
용어집에 대한 설명입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집의 이름입니다.
+ `Description` – UTF-8 문자열입니다(1\~2,048바이트).
용어집에 대한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## GetGlossary 작업(Python: get\_glossary)
AWS Glue Data Catalog에서 식별자를 기준으로 비즈니스 용어집을 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 용어집을 검색합니다.
```
aws glue get-glossary --identifier 6n5f21s641nbjb
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales-domain business terms"
}
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
검색할 용어집의 고유 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집의 이름입니다.
+ `Description` – UTF-8 문자열입니다(1\~2,048바이트).
용어집에 대한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
## UpdateGlossary 작업(Python: update\_glossary)
AWS Glue Data Catalog에서 비즈니스 용어집을 업데이트합니다.
**Example**
다음 예제에서는 용어집의 설명을 업데이트합니다.
```
aws glue update-glossary \
--identifier 6n5f21s641nbjb \
--name "Sales Terms" \
--description "Glossary of sales and revenue business terms"
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales and revenue business terms"
}
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
업데이트할 용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집의 업데이트된 이름입니다.
+ `Description` – UTF-8 문자열입니다(1\~2,048바이트).
용어집에 대한 업데이트된 설명입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집의 이름입니다.
+ `Description` – UTF-8 문자열입니다(1\~2,048바이트).
용어집에 대한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## DeleteGlossary 작업(Python: delete\_glossary)
AWS Glue Data Catalog에서 비즈니스 용어집을 삭제합니다. 용어집에 용어집 용어가 여전히 있는 경우 용어집을 삭제할 수 없습니다.
**Example**
다음 예제에서는 식별자를 기준으로 용어집을 삭제합니다.
```
aws glue delete-glossary --identifier 6n5f21s641nbjb
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
삭제할 용어집의 고유 식별자입니다.
**응답**
+ *무응답 파라미터.*
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConflictException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListGlossaries 작업(Python: list\_glossary)
AWS Glue Data Catalog에서 비즈니스 용어집을 나열합니다.
**Example**
다음 예제에서는 계정의 용어집을 나열합니다.
```
aws glue list-glossaries --max-results 20
{
"Items": [
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales and revenue business terms"
}
]
}
```
**요청**
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
**응답**
+ `Items` – 객체의 배열입니다.
용어집 항목의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## CreateGlossaryTerm 작업(Python: create\_glossary\_term)
AWS Glue Data Catalog에서 비즈니스 용어집 내의 용어집 용어를 생성합니다.
**Example**
다음 예제에서는 용어집 용어를 생성합니다.
```
aws glue create-glossary-term \
--glossary-identifier 6n5f21s641nbjb \
--name "Net Revenue" \
--short-description "Revenue after returns, allowances, and discounts." \
--long-description "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period."
{
"Id": "avugvxvsul6izr",
"GlossaryId": "6n5f21s641nbjb",
"Name": "Net Revenue",
"ShortDescription": "Revenue after returns, allowances, and discounts.",
"LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period."
}
```
**요청**
+ `GlossaryIdentifier` – *필수:* UTF-8 문자열입니다.
용어를 생성할 용어집의 고유 식별자입니다.
+ `Name` – *필수:* 1\~256바이트 길이의 UTF-8 문자열입니다.
용어집 용어의 이름입니다.
+ `ShortDescription` – UTF-8 문자열입니다(1\~1024바이트 이하)
용어집 용어에 대한 간단한 설명입니다.
+ `LongDescription` – UTF-8 문자열입니다(1\~4096바이트 이하)
용어집 용어에 대한 자세한 설명입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집 용어의 고유 식별자입니다.
+ `GlossaryId` – UTF-8 문자열입니다.
이 용어가 들어 있는 용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집 용어의 이름입니다.
+ `ShortDescription` – UTF-8 문자열입니다(1\~1024바이트 이하)
용어집 용어에 대한 간단한 설명입니다.
+ `LongDescription` – UTF-8 문자열입니다(1\~4096바이트 이하)
용어집 용어에 대한 자세한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## GetGlossaryTerm 작업(Python: get\_glossary\_term)
AWS Glue Data Catalog에서 식별자를 기준으로 용어집 용어를 검색합니다.
**Example**
다음 예제에서는 식별자를 기준으로 용어집 용어를 검색합니다.
```
aws glue get-glossary-term --identifier avugvxvsul6izr
{
"Id": "avugvxvsul6izr",
"GlossaryId": "6n5f21s641nbjb",
"Name": "Net Revenue",
"ShortDescription": "Revenue after returns, allowances, and discounts.",
"LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period."
}
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
검색할 용어집 용어의 고유 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집 용어의 고유 식별자입니다.
+ `GlossaryId` – UTF-8 문자열입니다.
이 용어가 들어 있는 용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집 용어의 이름입니다.
+ `ShortDescription` – UTF-8 문자열입니다(1\~1024바이트 이하)
용어집 용어에 대한 간단한 설명입니다.
+ `LongDescription` – UTF-8 문자열입니다(1\~4096바이트 이하)
용어집 용어에 대한 자세한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
## UpdateGlossaryTerm 작업(Python: update\_glossary\_term)
AWS Glue Data Catalog에서 용어집 용어를 업데이트합니다.
**Example**
다음 예제에서는 용어집 용어에 대한 간단한 설명을 업데이트합니다.
```
aws glue update-glossary-term \
--identifier avugvxvsul6izr \
--name "Net Revenue" \
--short-description "Gross revenue minus returns, allowances, and discounts." \
--long-description "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period."
{
"Id": "avugvxvsul6izr",
"GlossaryId": "6n5f21s641nbjb",
"Name": "Net Revenue",
"ShortDescription": "Gross revenue minus returns, allowances, and discounts.",
"LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period."
}
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
업데이트할 용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집 용어의 업데이트된 이름입니다.
+ `ShortDescription` – UTF-8 문자열입니다(1\~1024바이트 이하)
용어집 용어에 대한 업데이트된 간단한 설명입니다.
+ `LongDescription` – UTF-8 문자열입니다(1\~4096바이트 이하)
용어집 용어에 대한 업데이트된 자세한 설명입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Id` – UTF-8 문자열입니다.
용어집 용어의 고유 식별자입니다.
+ `GlossaryId` – UTF-8 문자열입니다.
이 용어가 들어 있는 용어집의 고유 식별자입니다.
+ `Name` – UTF-8 문자열입니다(1\~256바이트 이하)
용어집 용어의 이름입니다.
+ `ShortDescription` – UTF-8 문자열입니다(1\~1024바이트 이하)
용어집 용어에 대한 간단한 설명입니다.
+ `LongDescription` – UTF-8 문자열입니다(1\~4096바이트 이하)
용어집 용어에 대한 자세한 설명입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## DeleteGlossaryTerm 작업(Python: delete\_glossary\_term)
AWS Glue Data Catalog에서 용어집 용어를 삭제합니다.
**Example**
다음 예제에서는 식별자를 기준으로 용어집 용어를 삭제합니다.
```
aws glue delete-glossary-term --identifier avugvxvsul6izr
```
**요청**
+ `Identifier` – *필수:* UTF-8 문자열입니다.
삭제할 용어집 용어의 고유 식별자입니다.
**응답**
+ *무응답 파라미터.*
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListGlossaryTerms 작업(Python: list\_glossary\_terms)
AWS Glue Data Catalog에서 비즈니스 용어집 내의 용어집 용어를 나열합니다.
**Example**
다음 예제에서는 용어집의 용어를 나열합니다.
```
aws glue list-glossary-terms \
--glossary-identifier 6n5f21s641nbjb \
--max-results 20
{
"Items": [
{
"Id": "avugvxvsul6izr",
"Name": "Net Revenue",
"ShortDescription": "Gross revenue minus returns, allowances, and discounts."
}
]
}
```
**요청**
+ `GlossaryIdentifier` – *필수:* UTF-8 문자열입니다.
용어를 나열할 용어집의 고유 식별자입니다.
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
**응답**
+ `GlossaryId` – UTF-8 문자열입니다.
용어집의 고유 식별자입니다.
+ `Items` – 객체의 배열입니다.
용어집 용어 항목의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.
현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## AssociateGlossaryTerms 작업(Python: associate\_glossary\_terms)
AWS Glue Data Catalog에서 하나 이상의 용어집 용어를 자산과 연결합니다.
**Example**
다음 예제에서는 용어집 용어를 자산과 연결합니다.
```
aws glue associate-glossary-terms \
--identifier quarterly-sales-2026q1 \
--glossary-term-identifiers avugvxvsul6izr
{
"Identifier": "quarterly-sales-2026q1",
"GlossaryTerms": [
"avugvxvsul6izr"
]
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
용어집 용어를 연결할 자산의 고유 식별자입니다.
+ `GlossaryTermIdentifiers` – *필수:* 1\~10개 문자열의 UTF-8 문자열 배열입니다.
자산과 연결할 용어집 용어 식별자의 목록입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Identifier` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `GlossaryTerms` – UTF-8 문자열의 배열입니다(1\~10개 문자열).
지금 자산과 연결된 용어집 용어입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## DisassociateGlossaryTerms 작업(Python: disassociate\_glossary\_terms)
AWS Glue Data Catalog에서 자산으로부터 하나 이상의 용어집 용어의 연결을 제거합니다.
**Example**
다음 예제에서는 자산에서 용어집 용어를 제거합니다.
```
aws glue disassociate-glossary-terms \
--identifier quarterly-sales-2026q1 \
--glossary-term-identifiers avugvxvsul6izr
{
"Identifier": "quarterly-sales-2026q1",
"GlossaryTerms": []
}
```
**요청**
+ `AssetIdentifier` – *필수:* `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
용어집 용어를 연결 해제할 자산의 고유 식별자입니다.
+ `GlossaryTermIdentifiers` – *필수:* 1\~10개 문자열의 UTF-8 문자열 배열입니다.
자산에서 연결을 해제할 용어집 용어 식별자의 목록입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.
요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.
**응답**
+ `Identifier` – `String`과 일치하는 1\~1,087바이트 길이의 UTF-8 문자열입니다.
자산의 고유 식별자입니다.
+ `GlossaryTerms` – UTF-8 문자열의 배열입니다(1\~10개 문자열).
자산과 연결된 나머지 용어집 용어입니다.
**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## Search 작업(Python: search)
전체 텍스트 검색, 필터, 정렬 및 집계를 사용하여 AWS Glue Data Catalog에서 자산을 검색합니다. 관련성 순위가 매겨진 결과와 일치하는 자산을 반환합니다.
**Example**
다음 예제에서는 자산에 대한 전체 텍스트 검색을 실행합니다.
```
aws glue search --search-text "sales" --max-results 10
{
"Items": [
{
"Id": "quarterly-sales-2026q1",
"AssetName": "Quarterly Sales 2026 Q1",
"AssetDescription": "Aggregated quarterly sales metrics",
"UpdatedAt": "2026-06-16T06:42:00.442Z",
"AssetTypeId": "DataSet"
}
]
}
```
**Example**
다음 예제에서는 필터 절과 정렬 순서로 검색합니다.
```
aws glue search \
--search-text "sales" \
--max-results 10 \
--filter-clause '{"AttributeFilter":{"Attribute":"AssetTypeId","Operator":"equals","Value":{"StringValue":"DataSet"}}}' \
--sort '{"Attribute":"name","Order":"ASCENDING"}'
{
"Items": [
{
"Id": "quarterly-sales-2026q1",
"AssetName": "Quarterly Sales 2026 Q1",
"AssetDescription": "Aggregated quarterly sales metrics",
"UpdatedAt": "2026-06-16T06:42:00.442Z",
"AssetTypeId": "DataSet"
}
]
}
```
**Example**
다음 예제에서는 양식에서 정의한 필드에 필터를 사용합니다. 양식 필드는 양식의 자산 유형 식별자와 필드 이름을 점으로 연결한 형태로 참조됩니다. 여기서는 `amazon.glue::GlueTable` 양식의 `databaseName` 필드입니다. 내장 유형에 대한 자산 유형 식별자는 각 결과의 `AssetTypeId`에 표시된 `::` 접두사를 포함합니다.
```
aws glue search \
--filter-clause '{"AttributeFilter":{"Attribute":"amazon.glue::GlueTable.databaseName","Operator":"equals","Value":{"StringValue":"sales"}}}' \
--max-results 10
{
"Items": [
{
"Id": "arn:aws:glue:us-east-1:123456789012:table/sales/transactions",
"AssetName": "transactions",
"AssetDescription": "Raw sales transactions",
"UpdatedAt": "2026-06-16T06:42:00.442Z",
"AssetTypeId": "amazon.glue::GlueTable"
}
]
}
```
**Example**
다음 예제에서는 공통 자산 필드와 양식 필드를 논리 AND로 결합합니다. `name`, `type`, `region`, `catalogId` 등의 공통 자산 필드는 직접 참조되고, 양식에서 정의한 필드는 `assetTypeId.fieldName` 표기법을 사용합니다.
```
aws glue search \
--filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"amazon.glue::GlueTable.databaseName","Operator":"equals","Value":{"StringValue":"sales"}}}]}' \
--max-results 10
{
"Items": [
{
"Id": "arn:aws:glue:us-east-1:123456789012:table/sales/transactions",
"AssetName": "transactions",
"AssetDescription": "Raw sales transactions",
"UpdatedAt": "2026-06-16T06:42:00.442Z",
"AssetTypeId": "amazon.glue::GlueTable"
}
]
}
```
**요청**
+ `SearchText` – UTF-8 문자열입니다(1\~1000바이트 이하)
검색할 텍스트입니다. `searchText` 또는 `filterClause` 중 적어도 하나를 제공해야 합니다.
+ `MaxResults` – 1\~100의 숫자(정수)입니다.
응답으로 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.
이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `Sort` – [SearchSort](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort) 객체입니다.
검색 결과의 정렬 기준입니다.
+ `FilterClause` – [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 객체입니다.
검색에 적용할 필터 절입니다. 속성 수준 및 맵 수준 필터를 사용하여 중첩된 AND/OR 로직을 지원합니다.
**응답**
`Search` 작업에 대한 응답 구조입니다.
+ `SearchOutput` – [SearchOutput](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput) 객체입니다.
**오류**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `ThrottlingException`