Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Adición de metadatos que permiten búsquedas a las características
En Amazon SageMaker Feature Store, puedes buscar entre todas tus funciones. Para que las características sean más fáciles de detectar, puede agregarles metadatos. Puede agregar los siguientes tipos de metadatos:
-
Descripción: una descripción que permite búsquedas de la característica.
-
Parámetros: pares clave-valor que permiten búsquedas.
La descripción puede tener hasta 255 caracteres. En cuanto a los parámetros, debe especificar un par clave-valor en la búsqueda. Puede agregar hasta 25 parámetros.
Para actualizar los metadatos de una característica, puede utilizar la consola o la operación UpdateFeatureMetadata
.
Adición de metadatos que permiten búsquedas a las características
Puedes usar la consola o la API de Amazon SageMaker Feature Store para añadir a tus funciones metadatos con capacidad de búsqueda. Las instrucciones para usar el Almacén de características a través de la consola dependen de si ha habilitado Amazon SageMaker Studio o Amazon SageMaker Studio Clásico como experiencia predeterminada.
-
Abra la consola de Studio siguiendo las instrucciones de Lanza Amazon SageMaker Studio.
-
Seleccione Datos en el panel de navegación izquierdo para expandir la lista desplegable.
-
En la lista desplegable, elija Almacén de características.
-
(Opcional) Para ver sus características, seleccione Mi cuenta. Para ver las características compartidas, seleccione Entre cuentas.
-
Para ver sus grupos de características, en la pestaña Catálogo de características, elija Mi cuenta.
-
En la pestaña Catálogo de características, elija Entre cuentas para ver los grupos de características que otras personas le han permitido detectar. En Creado por, puede ver el ID de la cuenta propietaria del recurso del grupo de características.
-
Puede buscar su característica en la lista desplegable Buscar.
-
(Opcional) Para filtrar la búsqueda, elija el icono de filtro situado junto a la lista desplegable Buscar. Puede utilizar filtros para especificar parámetros o intervalos de fechas en los resultados de la búsqueda. Si busca un parámetro, especifique su clave y su valor. Para buscar sus características con más facilidad, puede especificar intervalos de tiempo o quitar la selección de las columnas que no desee consultar.
-
En el caso de los recursos compartidos, solo puede editar los metadatos de los grupos de características o las definiciones de características si cuenta con el permiso de acceso correspondiente concedido por la cuenta propietaria del recurso. Si solo cuenta con permiso de detección no podrá editar los metadatos ni las definiciones de características. Para obtener más información acerca de cómo conceder permisos de acceso, consulte Habilitar el acceso entre cuentas.
-
-
Elija la característica.
-
Elija Editar metadatos.
-
En el campo Descripción, agregue o actualice la descripción.
-
En el campo Parámetros, en Parámetros, especifique un par clave-valor para el parámetro.
-
De forma opcional, elija Agregar nuevo parámetro para agregar otro parámetro.
-
Seleccione Save changes (Guardar cambios).
-
Elija Confirmar.
En el código de esta sección, se utiliza la operación UpdateFeatureMetadata
de AWS SDK para Python (Boto3) para añadir metadatos con capacidad de búsqueda a sus características en distintos escenarios. Para obtener información sobre los otros idiomas para enviar una consulta, consulta Consulte también en la referencia de las SageMaker API de Amazon.
Para ver más ejemplos y recursos del Almacén de características, consulte Recursos de Amazon SageMaker Feature Store.
Código de ejemplo
Tras actualizar los metadatos de una característica, puede utilizar la operación DescribeFeatureMetadata
para ver las actualizaciones que ha realizado.
El siguiente código muestra un ejemplo de flujo de trabajo mediante el AWS SDK para Python (Boto3). Este ejemplo de código hace lo siguiente:
-
Configura tu entorno de SageMaker IA.
-
Crea un grupo de características.
-
Agrega características al grupo.
-
Agrega metadatos a las características.
Para ver más ejemplos y recursos del Almacén de características, consulte Recursos de Amazon SageMaker Feature Store.
Paso 1: Configurar
Para empezar a usar Feature Store, crea sesiones de SageMaker AI, boto3 y Feature Store. Además, configure el bucket de S3 que desea utilizar para sus características. Este es su almacenamiento sin conexión. El siguiente código usa el bucket predeterminado de SageMaker AI y le agrega un prefijo personalizado.
nota
El rol que utilice debe tener asociadas las siguientes políticas administradas: AmazonS3FullAccess
y AmazonSageMakerFeatureStoreAccess
.
# SageMaker Python SDK version 2.x is required %pip install 'sagemaker>=2.0.0' import sagemaker import sys
import boto3 import pandas as pd import numpy as np import io from sagemaker.session import Session from sagemaker import get_execution_role from botocore.exceptions import ClientError prefix = 'sagemaker-featurestore-introduction' role = get_execution_role() sagemaker_session = sagemaker.Session() region = sagemaker_session.boto_region_name s3_bucket_name = sagemaker_session.default_bucket() sagemaker_client = boto_session.client(service_name='sagemaker', region_name=region)
Paso 2: Crear un grupo de características y agregar características
El siguiente código es un ejemplo de creación de un grupo de características con definiciones de características.
feature_group_name = "test-for-feature-metadata" feature_definitions = [ {"FeatureName": "feature-1", "FeatureType": "String"}, {"FeatureName": "feature-2", "FeatureType": "String"}, {"FeatureName": "feature-3", "FeatureType": "String"}, {"FeatureName": "feature-4", "FeatureType": "String"}, {"FeatureName": "feature-5", "FeatureType": "String"} ] try: sagemaker_client.create_feature_group( FeatureGroupName=feature_group_name, RecordIdentifierFeatureName="feature-1", EventTimeFeatureName="feature-2", FeatureDefinitions=feature_definitions, OnlineStoreConfig={"EnableOnlineStore": True} ) except ClientError as e: if e.response["Error"]["Code"] == "ResourceInUse": pass else: raise e
Paso 3: Agregar metadatos
Antes de agregar metadatos, utilice la operación DescribeFeatureGroup
para asegurarse de que el estado del grupo de características sea Created
.
sagemaker_client.describe_feature_group( FeatureGroupName=feature_group_name )
Agregue una descripción a la característica.
sagemaker_client.update_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1", Description="new description" )
Puede utilizar la operación DescribeFeatureMetadata
para comprobar si ha actualizado correctamente la descripción del grupo de características.
sagemaker_client.describe_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1" )
También puede utilizarla para agregar parámetros al grupo de características.
sagemaker_client.update_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1", ParameterAdditions=[ {"Key": "team", "Value": "featurestore"}, {"Key": "org", "Value": "sagemaker"}, ] )
Puede volver a usar la operación DescribeFeatureMetadata
para comprobar si ha agregado los parámetros correctamente.
sagemaker_client.describe_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1" )