View a markdown version of this page

Introducción al contexto empresarial en el Catálogo de datos - AWS Glue
Requisitos previosPaso 1: Crear un glosario y etiquetar un activoPaso 2: Buscar datos utilizando el contexto empresarialUso de los agentes de IA con el catálogoSiguientes pasos

Introducción al contexto empresarial en el Catálogo de datos

nota

El contexto empresarial y la búsqueda semántica se encuentran en una versión preliminar para AWS Glue, y están sujetos a cambios.

En este tutorial se explica cómo crear un glosario, etiquetar activos y utilizar la búsqueda semántica para detectar datos por su significado.

Requisitos previos

  • Una cuenta de AWS con el Catálogo de datos de AWS Glue configurado en una región compatible.

  • La AWS CLI debe estar instalada y configurada.

  • Debe haber como mínimo una tabla registrada en el Catálogo de datos.

  • Un rol o usuario de IAM con permisos para las acciones del Catálogo de datos de AWS Glue.

Asocie la siguiente política de IAM para conceder los permisos necesarios:

{
    "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": "*"
    }]
}

Paso 1: Crear un glosario y etiquetar un activo

Cómo crear un glosario

Use el siguiente comando:

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

Ejemplo de código de salida:

{
    "Id": "d7xm3np5rk2w9j",
    "Name": "Enterprise Data Glossary"
}
Cómo crear un término del glosario

Sustituya el identificador del glosario por el Id del resultado anterior.

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."

Ejemplo de código de salida:

{
    "Id": "c2fymbu18rtsx5",
    "GlossaryId": "d7xm3np5rk2w9j",
    "Name": "Active User"
}
Cómo asociar el término a un activo

Use el siguiente comando:

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

Utilice la API SearchAssets para buscar activos por significado empresarial.

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

Ejemplo de código de salida:

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

Cómo filtrar los resultados por tipo de activo:

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

Cómo filtrar solo las tablas de AWS Glue (excluyendo las tablas de otros sistemas de origen):

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

Uso de los agentes de IA con el catálogo

Los agentes de IA compatibles con MCP pueden detectar los activos del catálogo, recuperar el contexto empresarial y cargar el contenido relacionado con las habilidades del kit de herramientas de agentes para AWS. Puede obtener habilidades del catálogo de las siguientes formas:

  • Agrupada con un complemento: instale el complemento aws-data-analytics, que incluye un conjunto seleccionado de habilidades de catálogo disponibles para el agente inmediatamente después de la instalación. Para obtener instrucciones, consulte Installing plugins en la Guía del usuario del Kit de herramientas de agentes para AWS.

  • Instalada localmente: descargue las habilidades individuales del Kit de herramientas de agentes para el repositorio de AWS en GitHub y agréguelas al directorio de habilidades de su agente. Las siguientes habilidades son compatibles con los flujos de trabajo del catálogo:

Siguientes pasos

  • Adjunte formularios para estandarizar los campos de metadatos, como la residencia de datos o la política de retención.

  • Cree recursos de habilidades que proporcionen a los agentes de IA un contexto de dominio para sus datos.