

# AWS Glue Data Catalog のビジネス用語集
<a name="catalog-business-glossaries"></a>

**注記**  
ビジネスコンテキストとセマンティック検索は AWS Glue のプレビューであり、変更される可能性があります。

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

## 用語集の作成
<a name="catalog-business-glossaries-create"></a>

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

## 用語集の用語の作成
<a name="catalog-business-glossaries-create-term"></a>

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

## 用語集の用語とアセットの関連付け
<a name="catalog-business-glossaries-associate"></a>

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

**注記**  
プレビュー中に、アセットごとに最大 10 個の用語集の用語を関連付けることができます。

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

## 用語集の用語の関連付けの削除
<a name="catalog-business-glossaries-disassociate"></a>

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

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

## 用語集と用語の更新
<a name="catalog-business-glossaries-update"></a>

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

**用語集を更新するには**  
`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"
```

## 用語集と用語の削除
<a name="catalog-business-glossaries-delete"></a>

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

**用語集の用語を削除するには**  
`DeleteGlossaryTerm` を使用します:

```
aws glue delete-glossary-term \
    --identifier {{term-id}}
```

**用語集を削除するには**  
すべての用語を削除した後に `DeleteGlossary` を使用します:

```
aws glue delete-glossary \
    --identifier {{glossary-id}}
```

## 用語集と用語の一覧表示
<a name="catalog-business-glossaries-list"></a>

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

## 用語集と用語の詳細の取得
<a name="catalog-business-glossaries-get"></a>

**用語集を取得するには**  
次のコマンドを実行します。

```
aws glue get-glossary \
    --identifier {{glossary-id}}
```

**用語集の用語を取得するには**  
次のコマンドを実行します。

```
aws glue get-glossary-term \
    --identifier {{term-id}}
```