AWS Glue Data Catalog のビジネス用語集

ビジネス用語集は、組織内のビジネス概念を定義する、制御された語彙用語のコンテナです。用語集の用語を Data Catalog アセットに関連付けて、ビジネスの意味を充実させ、セマンティック検索による検出可能性を向上させます。

用語集の作成

CreateGlossary を使用してビジネス用語集を作成します。

aws glue create-glossary \
    --name "Finance Data Definitions" \
    --description "Standardized financial terms used across reporting and analytics"

出力の例:

{
    "Id": "gl-c9vq7sh2fk4t2h",
    "Name": "Finance Data Definitions"
}

用語集の用語の作成

CreateGlossaryTerm を使用して用語集に用語を追加します。

aws glue create-glossary-term \
    --glossary-identifier glossary-id \
    --name "Active User" \
    --short-description "A user with at least one login in the last 30 days" \
    --long-description "An account that has logged in at least once within the trailing 30-day window. Used as the standard engagement metric across all product teams."

出力の例:

{
    "Id": "gt-d7xm3np5rk2w9j",
    "GlossaryId": "gl-c9vq7sh2fk4t2h",
    "Name": "Active User"
}

用語集の用語とアセットの関連付け

AssociateGlossaryTerms を使用して、用語を Data Catalog アセットに関連付けます。

aws glue associate-glossary-terms \
    --identifier asset-id \
    --glossary-term-identifiers '["term-id-1", "term-id-2"]'

出力の例:

{
    "Identifier": "c2fymbu18rtsx5",
    "GlossaryTerms": [
        {"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
        {"Id": "gt-h4kp9wt6mq3v2n", "Name": "PII"}
    ]
}

用語集の用語の関連付けの削除

DisassociateGlossaryTerms を使用して、アセットから用語の関連付けを削除します。

aws glue disassociate-glossary-terms \
    --identifier asset-id \
    --glossary-term-identifiers '["term-id"]'

用語集と用語の更新

更新はすぐに有効になり、検索結果に反映されます。

用語集を更新するには

UpdateGlossary を使用します:

aws glue update-glossary \
    --identifier glossary-id \
    --name "Enterprise Finance Glossary" \
    --description "Updated standardized financial terms for enterprise reporting"

用語集の用語を更新するには

UpdateGlossaryTerm を使用します:

aws glue update-glossary-term \
    --identifier term-id \
    --name "Monthly Active User" \
    --short-description "A user with at least one login in the last 30 days"

用語集と用語の削除

用語集を削除する前に、用語集の用語をすべて削除する必要があります。

用語集の用語を削除するには

DeleteGlossaryTerm を使用します:

aws glue delete-glossary-term \
    --identifier term-id

用語集を削除するには

すべての用語を削除した後に DeleteGlossary を使用します:

aws glue delete-glossary \
    --identifier glossary-id

用語集と用語の一覧表示

ListGlossaries と ListGlossaryTerms はどちらも、MaxResults と NextToken を使用したページ分割をサポートしています。

すべての用語集を一覧表示するには

次のコマンドを実行します。

aws glue list-glossaries \
    --max-results 10

出力の例:

{
    "Items": [
        {"Id": "gl-c9vq7sh2fk4t2h", "Name": "Finance Data Definitions"},
        {"Id": "gl-f8yn2bx7jl5r4k", "Name": "Marketing Glossary"}
    ]
}

用語集の用語を一覧表示するには

次のコマンドを実行します。

aws glue list-glossary-terms \
    --glossary-identifier glossary-id \
    --max-results 10

出力の例:

{
    "GlossaryId": "gl-c9vq7sh2fk4t2h",
    "Items": [
        {"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
        {"Id": "gt-j6rm4xv9np8w3t", "Name": "EBITDA"}
    ]
}

用語集と用語の詳細の取得

用語集を取得するには

次のコマンドを実行します。

aws glue get-glossary \
    --identifier glossary-id

用語集の用語を取得するには

次のコマンドを実行します。

aws glue get-glossary-term \
    --identifier term-id