- 데이터 유형 -AssetFormEntry AssetTypeFormReference IterableFormEntry IterableFormItem IterableFormListItem SearchResultItem SearchSort SearchFilterClause SearchAttributeFilter SearchFilterValue ItemError GetAssetOutput SearchOutput - 작업 -GetAsset(get_asset)PutAsset(put_asset)DeleteAsset(delete_asset)PutAssetType(put_asset_type)GetAssetType(get_asset_type)DeleteAssetType(delete_asset_type)ListAssetTypes(list_asset_types)PutFormType(put_form_type)GetFormType(get_form_type)DeleteFormType(delete_form_type)ListFormTypes(list_form_types)PutAttachment(put_attachment)DeleteAttachment(delete_attachment)ListIterableForms(list_iterable_forms)BatchGetIterableForms(batch_get_iterable_forms)CreateGlossary(create_glossary)GetGlossary(get_glossary)UpdateGlossary(update_glossary)DeleteGlossary(delete_glossary)ListGlossaries(list_glossary)CreateGlossaryTerm(create_glossary_term)GetGlossaryTerm(get_glossary_term)UpdateGlossaryTerm(update_glossary_term)DeleteGlossaryTerm(delete_glossary_term)ListGlossaryTerms(list_glossary_terms)AssociateGlossaryTerms(associate_glossary_terms)DisassociateGlossaryTerms(disassociate_glossary_terms)Search(search)

비즈니스 컨텍스트 API

비즈니스 컨텍스트 API는 AWS Glue Data Catalog에서 자산, 자산 유형, 양식 유형, 용어집, 용어집 용어, 연결 및 검색을 관리하기 위한 데이터 유형과 작업을 설명합니다.

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 객체입니다.

항목의 양식이며 양식 이름으로 분류됩니다.
Attachments – 키-값 페어의 맵 배열입니다.

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

각 값은 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 객체의 배열이며 구조는 1~10개입니다.

모두 일치해야 하는 필터 절의 목록입니다(논리 AND).
OrAnyFilters – SearchFilterClause 객체의 배열이며 구조는 1~10개입니다.

하나 이상 일치해야 하는 필터 절의 목록입니다(논리 OR).
AttributeFilter – 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 객체입니다.

비교할 값입니다.

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 객체입니다.

자산의 양식이며 양식 이름으로 분류됩니다.
Attachments – 키-값 페어의 맵 배열입니다.

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

각 값은 AssetFormEntry 객체입니다.

추가 컨텍스트를 위한 자산의 추가 연결이며 연결 이름으로 분류됩니다.
IterableForms – 키-값 페어의 맵 배열입니다.

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

각 값은 IterableFormEntry 객체입니다.

자산에서 사용할 수 있는 반복 가능한 양식이며 양식 이름(예: columns)으로 분류됩니다. 양식 이름을 ListIterableForms 또는 BatchGetIterableForms와 함께 사용하여 양식의 항목을 검색할 수 있습니다.

SearchOutput 구조

Search 작업에 대한 응답 구조입니다.

필드

Items – SearchResultItem 객체의 배열입니다.

검색 기준과 일치하는 자산의 목록입니다.
TotalCount - 숫자(정수)입니다.

검색 기준과 일치하는 총 자산 수입니다.
NextToken – UTF-8 문자열입니다.

현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.
Aggregations – 객체의 배열입니다.

요청된 속성에 대한 집계 결과입니다.

운영

GetAsset 작업(Python: get_asset)
PutAsset 작업(Python: put_asset)
DeleteAsset 작업(Python: delete_asset)
PutAssetType 작업(Python: put_asset_type)
GetAssetType 작업(Python: get_asset_type)
DeleteAssetType 작업(Python: delete_asset_type)
ListAssetTypes 작업(Python: list_asset_types)
PutFormType 작업(Python: put_form_type)
GetAssetType 작업(Python: get_asset_type)
DeleteFormType 작업(Python: delete_form_type)
ListAssetTypes 작업(Python: list_asset_types)
PutAttachment 작업(Python: put_attachment)
DeleteAttachment 작업(Python: delete_attachment)
ListIterableForms 작업(Python: list_iterable_forms)
BatchGetIterableForms 작업(Python: batch_get_iterable_forms)
CreateGlossary 작업(Python: create_glossary)
GetGlossary 작업(Python: get_glossary)
UpdateGlossary 작업(Python: update_glossary)
DeleteGlossary 작업(Python: delete_glossary)
ListGlossaries 작업(Python: list_glossary)
CreateGlossaryTerm 작업(Python: create_glossary_term)
GetGlossaryTerm 작업(Python: get_glossary_term)
UpdateGlossaryTerm 작업(Python: update_glossary_term)
DeleteGlossaryTerm 작업(Python: delete_glossary_term)
ListGlossaryTerms 작업(Python: list_glossary_terms)
AssociateGlossaryTerms 작업(Python: associate_glossary_terms)
DisassociateGlossaryTerms 작업(Python: disassociate_glossary_terms)
Search 작업(Python: search)

GetAsset 작업(Python: get_asset)

양식, 추가 연결 및 관련 용어집 용어를 포함하여 AWS Glue Data Catalog의 자산에 대한 메타데이터를 검색합니다.

예

다음 예제에서는 식별자를 기준으로 자산을 검색합니다.


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 객체입니다.

오류

AccessDeniedException
EntityNotFoundException
InternalServiceException
ThrottlingException
InvalidInputException

PutAsset 작업(Python: put_asset)

AWS Glue Data Catalog에서 자산을 생성하거나 업데이트합니다. 자산이 이미 있으면 자산이 업데이트되고, 그렇지 않으면 새 자산이 생성됩니다.

예

다음 예제에서는 양식이 있는 자산을 생성합니다.


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 객체입니다.

자산에 설정할 양식이며 양식 이름으로 분류됩니다. 각 항목은 양식 유형과 해당 JSON 콘텐츠를 지정합니다.
ClientToken – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.

응답

Id – 필수: String과 일치하는 1~1,087바이트 길이의 UTF-8 문자열입니다.

자산의 고유 식별자입니다.
Name – 필수: UTF-8 문자열입니다.

자산 이름.
Description – UTF-8 문자열입니다.

자산에 대한 설명입니다.
CreatedAt – 타임스탬프입니다.

자산이 생성된 타임스탬프입니다.
Forms – 키-값 페어의 맵 배열입니다.

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

각 값은 AssetFormEntry 객체입니다.

자산에 연결된 양식이며 양식 이름으로 분류됩니다.

오류

AccessDeniedException
ConcurrentModificationException
EntityNotFoundException
InternalServiceException
InvalidInputException
ThrottlingException

DeleteAsset 작업(Python: delete_asset)

AWS Glue Data Catalog에서 자산을 삭제합니다.

예

다음 예제에서는 식별자를 기준으로 자산을 삭제합니다.


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에서 자산 유형을 생성하거나 업데이트합니다. 자산 유형은 자산에 포함되는 양식을 지정하여 자산의 구조를 정의합니다. 지정된 이름의 자산 유형이 이미 있으면 자산이 업데이트됩니다.

예

다음 예제에서는 양식 유형을 참조하는 자산 유형을 생성합니다.


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 객체입니다.

자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다. 각 항목은 양식의 스키마를 정의하는 양식 유형을 참조합니다.
ClientToken – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자입니다.

응답

Id – UTF-8 문자열입니다(1~256바이트 이하)

자산 유형의 식별자입니다.
Name – String과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

자산 유형의 이름입니다.
Forms – 1~100개 페어로 구성된 키-값 페어의 맵 배열입니다.

각 키는 String과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

각 값은 AssetTypeFormReference 객체입니다.

자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다.

오류

AccessDeniedException
InternalServiceException
InvalidInputException
ConcurrentModificationException
ThrottlingException

GetAssetType 작업(Python: get_asset_type)

AWS Glue Data Catalog에서 식별자를 기준으로 자산 유형을 검색합니다.

예

다음 예제에서는 식별자를 기준으로 자산 유형을 검색합니다.


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 객체입니다.

자산 유형을 구성하는 양식이며 양식 이름으로 분류됩니다.

오류

AccessDeniedException
EntityNotFoundException
InternalServiceException
InvalidInputException
ThrottlingException

DeleteAssetType 작업(Python: delete_asset_type)

AWS Glue Data Catalog에서 자산 유형을 삭제합니다.

예

다음 예제에서는 식별자를 기준으로 자산 유형을 삭제합니다.


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에서 정의된 자산 유형을 나열합니다.

예

다음 예제에서는 계정의 자산 유형을 나열합니다.


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에서 양식 유형을 생성하거나 업데이트합니다. 양식 유형은 자산에 연결할 수 있는 정형 메타데이터의 스키마를 정의합니다.

예

다음 예제에서는 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과(와) 일치하는 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에서 식별자를 기준으로 양식 유형을 검색합니다.

예

다음 예제에서는 식별자를 기준으로 양식 유형을 검색합니다.


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에서 양식 유형을 삭제합니다. 양식 유형이 자산 유형에서 여전히 참조되는 경우 삭제할 수 없습니다.

예

다음 예제에서는 식별자를 기준으로 양식 유형을 삭제합니다.


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에서 정의된 양식 유형을 나열합니다.

예

다음 예제에서는 계정의 양식 유형을 나열합니다.


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에서 자산 또는 반복 가능한 양식 항목에 양식을 연결합니다. 동일한 이름의 연결이 이미 존재하는 경우 해당 연결을 덮어씁니다.

예

다음 예제에서는 자산에 양식을 연결합니다.


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과(와) 일치하는 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에서 자산으로부터 양식 연결을 삭제합니다.

예

다음 예제에서는 자산으로부터 연결을 삭제합니다.


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에서 자산의 반복 가능한 양식의 항목을 나열합니다. 예를 들어, 테이블 자산의 열을 나열합니다.

예

다음 예제에서는 자산의 열을 나열합니다.


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 객체의 배열입니다.

반복 가능한 양식 항목의 목록입니다.
NextToken – UTF-8 문자열입니다.

현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.

오류

AccessDeniedException
EntityNotFoundException
InternalServiceException
ThrottlingException
InvalidInputException

BatchGetIterableForms 작업(Python: batch_get_iterable_forms)

단일 요청으로 AWS Glue Data Catalog에서 자산의 반복 가능한 양식의 여러 항목을 검색합니다.

예

다음 예제에서는 식별자를 기준으로 특정 열을 검색합니다.


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 객체의 배열입니다.

검색된 반복 가능한 양식 항목의 목록입니다.
Errors – ItemError 객체의 배열입니다.

검색할 수 없는 항목에 대한 오류 목록입니다.

오류

AccessDeniedException
EntityNotFoundException
InternalServiceException
InvalidInputException
ThrottlingException

CreateGlossary 작업(Python: create_glossary)

AWS Glue Data Catalog에서 비즈니스 용어집을 생성합니다. 용어집은 비즈니스 개념을 정의하는 용어집 용어의 컨테이너입니다.

예

다음 예제에서는 비즈니스 용어집을 생성합니다.


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과(와) 일치하는 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에서 식별자를 기준으로 비즈니스 용어집을 검색합니다.

예

다음 예제에서는 식별자를 기준으로 용어집을 검색합니다.


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에서 비즈니스 용어집을 업데이트합니다.

예

다음 예제에서는 용어집의 설명을 업데이트합니다.


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과(와) 일치하는 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에서 비즈니스 용어집을 삭제합니다. 용어집에 용어집 용어가 여전히 있는 경우 용어집을 삭제할 수 없습니다.

예

다음 예제에서는 식별자를 기준으로 용어집을 삭제합니다.


aws glue delete-glossary --identifier 6n5f21s641nbjb

요청

Identifier – 필수: UTF-8 문자열입니다.

삭제할 용어집의 고유 식별자입니다.

응답

무응답 파라미터.

오류

AccessDeniedException
InternalServiceException
InvalidInputException
ConflictException
ConcurrentModificationException
ThrottlingException

ListGlossaries 작업(Python: list_glossary)

AWS Glue Data Catalog에서 비즈니스 용어집을 나열합니다.

예

다음 예제에서는 계정의 용어집을 나열합니다.


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에서 비즈니스 용어집 내의 용어집 용어를 생성합니다.

예

다음 예제에서는 용어집 용어를 생성합니다.


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과(와) 일치하는 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에서 식별자를 기준으로 용어집 용어를 검색합니다.

예

다음 예제에서는 식별자를 기준으로 용어집 용어를 검색합니다.


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에서 용어집 용어를 업데이트합니다.

예

다음 예제에서는 용어집 용어에 대한 간단한 설명을 업데이트합니다.


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과(와) 일치하는 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에서 용어집 용어를 삭제합니다.

예

다음 예제에서는 식별자를 기준으로 용어집 용어를 삭제합니다.


aws glue delete-glossary-term --identifier avugvxvsul6izr

요청

Identifier – 필수: UTF-8 문자열입니다.

삭제할 용어집 용어의 고유 식별자입니다.

응답

무응답 파라미터.

오류

AccessDeniedException
InternalServiceException
InvalidInputException
ConcurrentModificationException
ThrottlingException

ListGlossaryTerms 작업(Python: list_glossary_terms)

AWS Glue Data Catalog에서 비즈니스 용어집 내의 용어집 용어를 나열합니다.

예

다음 예제에서는 용어집의 용어를 나열합니다.


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에서 하나 이상의 용어집 용어를 자산과 연결합니다.

예

다음 예제에서는 용어집 용어를 자산과 연결합니다.


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과(와) 일치하는 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에서 자산으로부터 하나 이상의 용어집 용어의 연결을 제거합니다.

예

다음 예제에서는 자산에서 용어집 용어를 제거합니다.


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과(와) 일치하는 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에서 자산을 검색합니다. 관련성 순위가 매겨진 결과와 일치하는 자산을 반환합니다.

예

다음 예제에서는 자산에 대한 전체 텍스트 검색을 실행합니다.


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"
            }
        ]
    }

예

다음 예제에서는 필터 절과 정렬 순서로 검색합니다.


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"
            }
        ]
    }

예

다음 예제에서는 양식에서 정의한 필드에 필터를 사용합니다. 양식 필드는 양식의 자산 유형 식별자와 필드 이름을 점으로 연결한 형태로 참조됩니다. 여기서는 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"
            }
        ]
    }

예

다음 예제에서는 공통 자산 필드와 양식 필드를 논리 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 객체입니다.

검색 결과의 정렬 기준입니다.
FilterClause – SearchFilterClause 객체입니다.

검색에 적용할 필터 절입니다. 속성 수준 및 맵 수준 필터를 사용하여 중첩된 AND/OR 로직을 지원합니다.

응답

Search 작업에 대한 응답 구조입니다.

SearchOutput – SearchOutput 객체입니다.

오류

AccessDeniedException
InvalidInputException
InternalServiceException
ThrottlingException

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

카탈로그

데이터베이스 수