Búsqueda de grupos de características en el almacén de características

Con Amazon SageMaker Feature Store, puede buscar los grupos de características mediante la consola o la operación de búsqueda. Puede utilizar la funcionalidad de búsqueda para encontrar características y grupos de características que sean pertinentes para los modelos que está creando. Puede utilizar la funcionalidad de búsqueda para encontrar rápidamente los grupos de características que sean pertinentes para su caso de uso.

nota

Los grupos de funciones que estás buscando deben estar dentro de tu Región de AWS AWS cuenta o deben estar compartidos con ellos y ser visibles para ti. Cuenta de AWS Para obtener más información sobre cómo compartir el catálogo de grupos de funciones y conceder la visibilidad, consulte. Compartir el catálogo del grupo de características

En la siguiente tabla se muestran los campos en los que se pueden realizar búsquedas y si se puede utilizar la consola para buscar un campo específico.

Puede buscar funciones mediante Amazon SageMaker Studio Classic o la Searchoperación de la SageMaker API. La siguiente tabla muestra todos los metadatos que se pueden buscar y si puede buscarlos en la consola. Pueden hacerse búsquedas en las etiquetas de sus propios grupos de características, pero no en los grupos de características que usted pueda detectar.

Metadatos que se pueden buscar	Nombre del campo de API	¿Se pueden buscar en la consola?	¿Se pueden buscar entre cuentas?
Todas las etiquetas	AllTags	Sí	No
Motivo de error de creación	FailureReason	No	No
Estado de la creación	FeatureGroupStatus	Sí	Sí
Hora de creación	CreationTime	Sí	Sí
Descripción	Descripción	Sí	Sí
Nombre de la característica de hora del evento	EventTimeFeatureName	No	No
Definiciones de características	FeatureDefinitions	No	No
ARN del grupo de características	FeatureGroupARN	No	No
Nombre del grupo de características	FeatureGroupName	Sí	Sí
Configuración del almacenamiento sin conexión	OfflineStoreConfig	No	No
Estado del almacenamiento sin conexión	OfflineStoreStatus	Sí	Sí
Estado de la actualización más reciente	LastUpdateStatus	No	No
Nombre de la característica de identificador de registros	RecordIdentifierFeatureName	Sí	Sí
Etiquetas	Tags.`key`	Sí	No

¿Cómo encontrar grupos de funciones

Puedes usar la consola o la API de Amazon SageMaker Feature Store para encontrar tus grupos de características. Las instrucciones para usar Feature Store a través de la consola dependen de si la has activado Amazon SageMaker Studio o Amazon SageMaker Studio Clásico si es tu experiencia predeterminada.

Abre la consola de Studio siguiendo las instrucciones que aparecen enLanza Amazon SageMaker Studio.
Seleccione Datos en el panel de navegación izquierdo para ampliar la lista desplegable.
En la lista desplegable, elija Almacén de características.
(Opcional) Para ver tus grupos de funciones, selecciona Mi cuenta. Para ver los grupos de funciones compartidos, selecciona Cuenta cruzada.
En la pestaña Catálogo de grupos de características, seleccione Mi cuenta para ver sus grupos de características.
En la pestaña Catálogo de grupos de características, elija Varias cuentas para ver los grupos de características que otros usuarios han hecho visibles para usted. En Creado por, puede ver el ID de cuenta del propietario del recurso.
Puedes buscar tus grupos de características en la lista desplegable de búsqueda:
- (Opcional) Para filtrar la búsqueda, selecciona el icono de filtro situado junto a la lista desplegable de búsquedas. 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 encontrar sus grupos de entidades, puede especificar intervalos de tiempo, borrar (deseleccionar) las columnas que no desee consultar, elegir tiendas en las que buscar o buscar por estado.
- En el caso de los recursos compartidos, solo puede editar los metadatos de los grupos de entidades o las definiciones de entidades si cuenta con el permiso de acceso adecuado otorgado por la cuenta del propietario del recurso. El permiso de detección por sí solo no le permitirá editar los metadatos o las definiciones de funciones. Para obtener más información sobre la concesión de permisos de acceso, consulteHabilitar el acceso entre cuentas.

El código de esta sección utiliza la Searchoperación de AWS SDK for Python (Boto3) para ejecutar la consulta de búsqueda para encontrar grupos de entidades. 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 obtener más ejemplos y recursos de Feature Store, consulteRecursos de Amazon SageMaker Feature Store.

El siguiente código muestra diferentes ejemplos de consultas de búsqueda que utilizan la API:


# Return all feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
)  

# Search for feature groups that are shared with your account
sagemaker_session.search(
    resource="FeatureGroup",
    search_expression={
        "Filters": [
            {
                "Name": "FeatureGroupName",
                "Value": "MyFeatureGroup",
                "Operator": "Contains",
            }
        ],
        "Operator": "And",
    },
    sort_by="Name",
    sort_order="Ascending",
    next_token="token",
    max_results=50,
    CrossAccountFilterOption="SameAccount"
)

# Search for all feature groups with a name that contains the "ver" substring
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

# Search for all feature groups that have the EXACT name "airport"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Equals',
                'Value': 'airport'
            },
        ]
    }
)

# Search for all feature groups that contains the name "ver"
# AND have a record identifier feature name that contains "wha"
# AND have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR feature groups that have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR tags with the value 'Sage' for the 'org' key
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Tags.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)

# Search for all offline only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'NotEquals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

# Search for all online only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'NotExists'
            }
        ]
    }
)

# Search for all feature groups that are BOTH online and offline
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

También puedes usar el SDK de AWS RAM las API de Python para crear recursos compartidos. A continuación, se muestra la firma de API. Para utilizar el SDK o la AWS RAM API de Python, debe adjuntar una política gestionada de acceso AWS RAM completo con la función de ejecución.


response = client.create_resource_share(
    name='string',
    resourceArns=[
        'string',
    ],
    principals=[
        'string',
    ],
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    allowExternalPrincipals=True|False,
    clientToken='string',
    permissionArns=[
        'string',
    ]
)

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Búsqueda de características en los grupos de características

Adición de metadatos que permiten búsquedas a las características