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.

# Búsqueda de características en los grupos de características
<a name="feature-store-search-metadata"></a>

Con Amazon SageMaker Feature Store, puedes buscar las funciones que has creado en tus grupos de características. Puede buscar entre todas las características sin necesidad de seleccionar primero un grupo de características. La funcionalidad de búsqueda ayuda a encontrar rápidamente las características que sean pertinentes para su caso de uso.

**nota**  
Los grupos de funciones en los que buscas funciones deben estar dentro de tu Región de AWS y Cuenta de AWS. En el caso de los grupos de características compartidos, los grupos de características deben poder ser detectados por su Cuenta de AWS. Para obtener más instrucciones sobre cómo compartir el catálogo del grupo de características y garantizar la detección, consulte [Compartir el catálogo del grupo de características](feature-store-cross-account-discoverability-share-feature-group-catalog.md).

Si forma parte de un equipo, y los compañeros de equipo buscan características para utilizarlas en sus modelos, podrán buscarlas entre todas las características de todos los grupos de características.

Puede añadir parámetros y descripciones que permitan búsquedas para que sea más fácil detectar las características. Para obtener más información, consulte [Adición de metadatos que permiten búsquedas a las características](feature-store-add-metadata.md).

Puedes buscar funciones mediante la consola o mediante la operación de la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)API en la SageMaker IA. En la tabla siguiente se muestran todos los metadatos que se pueden buscar y se indica si puede buscarlos en la consola o con la API.


****  

| Metadatos que se pueden buscar | Nombre del campo de API | ¿Se pueden buscar en la consola? | 
| --- | --- | --- | 
| Todos los parámetros | AllParameters | Sí | 
| Hora de creación | CreationTime | Sí | 
| Description (Descripción) | Description (Descripción) | Sí | 
| Nombre del grupo de características | FeatureGroupName | No | 
| Nombre de la característica  | FeatureName | Sí | 
| Tipo de característica | FeatureType | No | 
| Last modified time (Hora de la última modificación) | LastModifiedTime | No | 
| Parameters | Parámetros. key | Sí | 

## Métodos para buscar características
<a name="feature-store-search-metadata-how-to"></a>

Las instrucciones para usar el Almacén de características a través de la consola dependen de si ha habilitado [Amazon SageMaker Studio](studio-updated.md) o [Amazon SageMaker Studio Clásico](studio.md) como experiencia predeterminada. Elija una de las siguientes instrucciones en función de su caso de uso.

### Búsqueda de características si Studio es su experiencia predeterminada (consola)
<a name="feature-store-search-metadata-how-to-with-studio-updated"></a>

1. Abra la consola de Studio siguiendo las instrucciones de [Inicie Amazon SageMaker Studio](studio-updated-launch.md).

1. Seleccione **Datos** en el panel de navegación izquierdo para expandir la lista desplegable.

1. En la lista desplegable, elija **Almacén de características**.

1. (Opcional) Para ver sus características, seleccione **Mi cuenta**. Para ver las características compartidas, seleccione **Entre cuentas**.

1. En la pestaña **Catálogo de características**, elija **Mi cuenta** para ver sus grupos de características.

1. 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 del propietario del recurso.

1. 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, especifique intervalos de tiempo o borre (anule la selección) 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. El permiso de detección por sí solo no le permitirá editar metadatos ni definiciones de características. Para obtener más información acerca de cómo conceder permisos de acceso, consulte [Habilitar el acceso entre cuentas](feature-store-cross-account-access.md).

### Búsqueda de características mediante el SDK para Python (Boto3)
<a name="feature-store-search-metadata-how-to-with-sdk"></a>

El código de esta sección utiliza la [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)operación de AWS SDK para Python (Boto3) para ejecutar la consulta de búsqueda para encontrar características en sus grupos de características. Para obtener información sobre los otros idiomas para enviar una consulta, consulta [Consulte también](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso) 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](feature-store-resources.md).

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

```
# Return all features in your feature groups
sagemaker_client.search(
    Resource="FeatureMetadata",
)  

# Search for all features that belong to a feature group that contain the "ver" substring
sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

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

# Search for all features that belong to a feature group that contains the name "ver"
AND have a name that contains "wha"
AND have a parameter (key or value) that contains "hea"

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllParameters', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all features that belong to a feature group with substring "ver" in its name
OR features that have a name that contain "wha"
OR features that have a parameter (key or value) that contains "hea"

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllParameters', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all features that belong to a feature group with substring "ver" in its name
OR features that have a name that contain "wha"
OR parameters with the value 'Sage' for the 'org' key

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Parameters.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)
```