在 Feature Store 中查找特征组

通过 Amazon F SageMaker eature Store，您可以使用控制台或搜索操作来搜索功能组。您可以使用搜索功能来查找与您要创建的模型相关的特征和特征组。您可以使用搜索功能快速查找与您的使用案例相关的特征组。

注意

您要搜索的功能组必须位于您的 Amazon Web Services 区域和 Amazon 帐户中，或者与您共享并允许您 Amazon Web Services 账户发现。有关如何共享特征组目录和授予可发现性的更多信息，请参阅共享特征组目录。

下表显示了可搜索字段以及是否可以使用管理控制台搜索特定字段。

您可以使用 Amazon SageMaker Studio Classic 或 SageMaker API 中的Search操作来搜索功能。下表列出了所有可搜索的元数据，以及是否可以在管理控制台中搜索。对于您自己的特征组，标签可以搜索；但对于您可以发现的特征组，则不可搜索。

可搜索元数据	API 字段名称	是否可以在管理控制台中搜索？	是否可以跨账户搜索？
所有标签	AllTags	是	否
创建失败原因	FailureReason	否	否
创建状态	FeatureGroupStatus	支持	是
创建时间	CreationTime	支持	是
说明	Description	支持	是
事件时间特征名称	EventTimeFeatureName	否	否
特征定义	FeatureDefinitions	否	否
特征组 ARN	FeatureGroupARN	否	否
特征组名称	FeatureGroupName	支持	是
离线存储配置	OfflineStoreConfig	否	否
离线存储状态	OfflineStoreStatus	支持	是
上次更新状态	LastUpdateStatus	否	否
记录标识符特征名称	RecordIdentifierFeatureName	支持	是
标签	Tags.`key`	是	否

如何查找特征组

您可以使用控制台或 Amazon F SageMaker eature Store API 来查找您的功能组。通过管理控制台使用特征存放区的说明取决于您是否已启用亚马逊 SageMaker Studio 或亚马逊 SageMaker Studio 经典版作为默认体验。

按照启动亚马逊 SageMaker Studio 中的说明打开 Studio 管理控制台。
在左侧导航窗格中选择数据，展开下拉列表。
从下拉列表中，选择 Feature Store。
（可选）要查看特征组，请选择我的账户。要查看共享特征组，请选择跨账户。
在特征组目录选项卡下，选择我的账户查看特征组。
在特征组目录选项卡下，选择跨账户，查看他人让您可以发现的特征组。在创建者下，可以查看资源所有者账户 ID。
您可以在搜索下拉列表中搜索您的特征组：
- （可选）要筛选搜索，请选择搜索下拉列表旁边的筛选图标。可以使用筛选器在搜索结果中指定参数或日期范围。如果要搜索一个参数，请同时指定其键和值。要查找特征组，可以指定时间范围、清除（取消选择）不想查询的列、选择要搜索的存储或按状态搜索。
- 对于共享资源，只有拥有资源所有者账户授予的适当访问权限，才能编辑特征组元数据或功能定义。仅有可发现性权限并不允许您编辑元数据或功能定义。有关授予访问权限的更多信息，请参阅启用跨账户访问。

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

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

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

你也可以使用 Amazon RAM API 的 python SDK 来创建资源共享。API 签名如下所示。要使用 Amazon RAM API 的 python SDK，你需要附加带有执行角色的 Amazon RAM 完全访问托管策略。


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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

在特征组中查找特征

向特征添加可搜索的元数据