本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在特征组中查找特征
<a name="feature-store-search-metadata"></a>

借助 Amazon F SageMaker eature Store，您可以搜索您在功能组中创建的功能。您可以搜索所有功能，而无需先选择特征组。搜索功能有助于找到与您的使用场景相关的功能。

**注意**  
您要搜索要素的要素组必须位于您的 AWS 区域 和中 AWS 账户。对于共享特征组，特征组必须能被您的 AWS 账户发现。有关如何共享特征组目录和授予可发现性的更多说明，请参阅 [共享特征组目录](feature-store-cross-account-discoverability-share-feature-group-catalog.md)。

如果您是团队成员，而队友们正在寻找可用于其模型的功能，他们可以在所有特征组中搜索功能。

您可以添加可搜索的参数和描述，让特征更容易被发现。有关更多信息，请参阅 [向特征添加可搜索的元数据](feature-store-add-metadata.md)。

您可以使用控制台或使用 SageMaker A [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)I 中的 API 操作来搜索功能。下表列出了所有可搜索的元数据，以及能否在管理控制台或使用 API 进行搜索。


****  

| 可搜索元数据 | API 字段名称 | 是否可以在管理控制台中搜索？ | 
| --- | --- | --- | 
| 所有参数 | AllParameters | 是 | 
| 创建时间 | CreationTime | 是 | 
| 说明 | Description | 是 | 
| 特征组名称 | FeatureGroupName | 否 | 
| 特征名称 | FeatureName | 是 | 
| 特征类型 | FeatureType | 否 | 
| 上次修改时间 | LastModifiedTime | 否 | 
| 参数 | 参数。 {{key}} | 是 | 

## 如何搜索您的功能
<a name="feature-store-search-metadata-how-to"></a>

通过管理控制台使用特征存放区的说明取决于您是否已启用 [亚马逊 SageMaker Studio](studio-updated.md) 或 [亚马逊 SageMaker Studio 经典版](studio.md) 作为默认体验。根据您的使用情况，选择以下说明之一。

### 如果 Studio 是您的默认体验（管理控制台），则搜索功能
<a name="feature-store-search-metadata-how-to-with-studio-updated"></a>

1. 按照 [启动亚马逊 SageMaker Studio](studio-updated-launch.md) 中的说明打开 Studio 管理控制台。

1. 在左侧导航窗格中选择**数据**，展开下拉列表。

1. 从下拉列表中，选择 **Feature Store**。

1. （可选）要查看您的功能，请选择**我的帐户**。要查看共享功能，请选择**跨账户**。

1. 在**功能目录**选项卡下，选择**我的账户**查看特征组。

1. 在**功能目录**选项卡下，选择**跨账户**，查看他人让您可以发现的特征组。在**创建者**下，可以查看资源所有者账户 ID。

1. 您可以在**搜索**下拉列表中搜索您的功能：
   + （可选）要筛选搜索，请选择**搜索**下拉列表旁边的筛选图标。可以使用筛选器在搜索结果中指定参数或日期范围。如果要搜索一个参数，请同时指定其键和值。要查找功能，可指定时间范围，或清除（取消选择）不想查询的列。
   + 对于共享资源，只有拥有资源所有者账户授予的适当访问权限，才能编辑特征组元数据或功能定义。仅有可发现性权限并不允许您编辑元数据或功能定义。有关授予访问权限的更多信息，请参阅 [启用跨账户访问](feature-store-cross-account-access.md)。

### 使用 Python SDK (Boto3) 搜索功能
<a name="feature-store-search-metadata-how-to-with-sdk"></a>

本节中的代码使用中的[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)操作 适用于 Python (Boto3) 的 AWS SDK 来运行搜索查询，以便在您的功能组中查找要素。有关提交查询的其他语言的信息，请参[阅 *Amazon SageMaker API 参考*中的另请参阅](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso)。

有关更多特征存放区示例和资源，请参阅 [Amazon SageMaker 功能商店资源](feature-store-resources.md)。

以下代码展示了使用 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"
    }
)
```