View a markdown version of this page

在特征组中查找特征 - 亚马逊 SageMaker AI
如何搜索您的功能

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

在特征组中查找特征

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

注意

您要搜索要素的要素组必须位于您的 AWS 区域 和中 AWS 账户。对于共享特征组，特征组必须能被您的 AWS 账户发现。有关如何共享特征组目录和授予可发现性的更多说明，请参阅 共享特征组目录。

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

您可以添加可搜索的参数和描述，让特征更容易被发现。有关更多信息，请参阅 向特征添加可搜索的元数据。

您可以使用控制台或使用 SageMaker A SearchI 中的 API 操作来搜索功能。下表列出了所有可搜索的元数据，以及能否在管理控制台或使用 API 进行搜索。

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

如何搜索您的功能

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

  1. 按照 启动亚马逊 SageMaker Studio 中的说明打开 Studio 管理控制台。

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

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

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

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

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

  7. 您可以在搜索下拉列表中搜索您的功能：

    • （可选）要筛选搜索，请选择搜索下拉列表旁边的筛选图标。可以使用筛选器在搜索结果中指定参数或日期范围。如果要搜索一个参数，请同时指定其键和值。要查找功能，可指定时间范围，或清除（取消选择）不想查询的列。

    • 对于共享资源，只有拥有资源所有者账户授予的适当访问权限，才能编辑特征组元数据或功能定义。仅有可发现性权限并不允许您编辑元数据或功能定义。有关授予访问权限的更多信息，请参阅 启用跨账户访问。

本节中的代码使用中的Search操作 适用于 Python (Boto3) 的 AWS SDK 来运行搜索查询，以便在您的功能组中查找要素。有关提交查询的其他语言的信息，请参阅 Amazon SageMaker API 参考中的另请参阅。

有关更多特征存放区示例和资源，请参阅 Amazon SageMaker 功能商店资源。

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