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