View a markdown version of this page

Data Catalog のビジネスコンテキストの使用開始 - AWS Glue
前提条件ステップ 1: 用語集を作成し、アセットにタグを付けるステップ 2: ビジネスコンテキストを使用してデータを検索するカタログでの AI エージェントの使用次のステップ

Data Catalog のビジネスコンテキストの使用開始

注記

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

このチュートリアルでは、用語集の作成、アセットのタグ付け、セマンティック検索によって意味によるデータを検出する方法について説明します。

前提条件

  • サポートされているリージョンで設定された AWS Glue Data Catalog を持つ AWS アカウント。

  • インストールおよび設定済みの AWS CLI。

  • Data Catalog に登録されている 1 つ以上のテーブル。

  • AWS Glue Data Catalog アクションのアクセス許可を持つ IAM ロールまたはユーザー。

必要な許可を付与するには、次の IAM ポリシーをアタッチします。

{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "glue:SearchAssets", "glue:PutAsset", "glue:GetAsset", "glue:DeleteAsset",
            "glue:PutAssetType", "glue:GetAssetType", "glue:DeleteAssetType", "glue:ListAssetTypes",
            "glue:CreateGlossary", "glue:UpdateGlossary", "glue:GetGlossary", "glue:ListGlossaries", "glue:DeleteGlossary",
            "glue:CreateGlossaryTerm", "glue:UpdateGlossaryTerm", "glue:GetGlossaryTerm", "glue:ListGlossaryTerms", "glue:DeleteGlossaryTerm",
            "glue:AssociateGlossaryTerms", "glue:DisassociateGlossaryTerms",
            "glue:PutFormType", "glue:GetFormType", "glue:DeleteFormType", "glue:ListFormTypes",
            "glue:PutAttachment", "glue:DeleteAttachment",
            "glue:ListIterableForms", "glue:BatchGetIterableForms"
        ],
        "Resource": "*"
    }]
}

ステップ 1: 用語集を作成し、アセットにタグを付ける

用語集を作成するには

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

aws glue create-glossary \
  --name "Enterprise Data Glossary" \
  --description "Standardized business definitions for enterprise data assets."

出力の例:

{
    "Id": "d7xm3np5rk2w9j",
    "Name": "Enterprise Data Glossary"
}
用語集の用語を作成するには

用語集の識別子を前述の出力の Id に置き換えます。

aws glue create-glossary-term \
  --glossary-identifier "d7xm3np5rk2w9j" \
  --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."

出力の例:

{
    "Id": "c2fymbu18rtsx5",
    "GlossaryId": "d7xm3np5rk2w9j",
    "Name": "Active User"
}
用語をアセットに関連付けるには

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

aws glue associate-glossary-terms \
  --asset-identifier "arn:aws:glue:us-east-1:123456789012:table/mydb/sales_transactions" \
  --glossary-term-identifiers "c2fymbu18rtsx5"

SearchAssets API を使用して、ビジネス上の意味でアセットを検索します。

aws glue search-assets \
  --search-text "active users"

出力の例:

{
    "Items": [
        {"Id": "c9vq7sh2fk4t2h", "AssetName": "Customer Sales Transactions", "AssetTypeId": "Table"}
    ]
}

アセットタイプで結果をフィルタリングするには

aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}}' \
  --max-results 10

AWS Glue テーブルのみにフィルタリングするには (他のソースシステムからのテーブルを除く):

aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"namespace","Operator":"equals","Value":{"StringValue":"amazon.glue"}}}]}' \
  --max-results 10

カタログでの AI エージェントの使用

MCP 互換 AI エージェントは、AWS エージェントツールキットのスキルを使用して、カタログアセットの検出、ビジネスコンテキストの取得、スキルコンテンツのロードを行うことができます。カタログスキルは、次の方法で取得できます。

  • プラグインにバンドル – aws-data-analytics プラグインをインストールします。プラグインには、インストール直後にエージェントが利用できる厳選されたカタログスキルのセットが含まれています。手順については、「AWS エージェントツールキットユーザーガイド」の「プラグインのインストール」を参照してください。

  • ローカルにインストール – GitHub の Agent Toolkit for AWS リポジトリから個々のスキルをダウンロードし、エージェントのスキルディレクトリに追加します。次のスキルはカタログワークフローをサポートします。

次のステップ

  • フォームをアタッチして、データレジデンシーや保持ポリシーなどのメタデータフィールドを標準化します。

  • AI エージェントにデータのドメインコンテキストを提供するスキルアセットを作成します。