尋找特徵群組中的特徵 - Amazon SageMaker
如何搜尋您的功能

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

尋找特徵群組中的特徵

透過 Amazon SageMaker Feature Store，您可以搜尋您在功能群組中建立的功能。您可以搜尋所有功能，而無需先選取功能群組。搜尋功能有助於尋找與您使用案例相關的功能。

注意

您要搜尋功能的功能群組必須在 AWS 區域 和 內 AWS 帳戶。對於共用功能群組，必須讓功能群組可供您的 探索 AWS 帳戶。如需如何共用功能群組目錄和授予可探索性的詳細資訊，請參閱 共用您的特徵群組目錄。

如果您在團隊中，且團隊成員正在尋找要在模型中使用的功能，則可以搜尋所有功能群組中的功能。

您可以新增可搜尋的參數和說明，以使您的特徵更容易被發現。如需詳細資訊，請參閱新增可搜尋的中繼資料至特徵。

您可以使用主控台或使用 中的 SearchAPI操作來搜尋功能 SageMaker。下表列出所有可搜尋的中繼資料，以及您是否可以在主控台或使用 進行搜尋API。

可搜尋的中繼資料 API 欄位名稱 可在主控台中搜尋？
所有參數 AllParameters 是
建立時間 CreationTime 是
描述 描述 是
特徵群組名稱 FeatureGroupName 否
特徵名稱 FeatureName 是
特徵類型 FeatureType 否
上次修改時間 LastModifiedTime 否
參數 Parameters.key 是

如何搜尋您的功能

透過主控台使用 Feature Store 的指示取決於您是否已啟用 Amazon SageMaker Studio或 Amazon SageMaker Studio Classic作為預設體驗。根據您的使用案例選擇下列其中一項指示。

  1. 按照 中的指示開啟 Studio 主控台推出 Amazon SageMaker 工作。

  2. 在左側導覽窗格中選擇資料以展開下拉式清單。

  3. 從下拉式清單中，選擇 Feature Store。

  4. （選用） 若要檢視您的功能，請選擇我的帳戶 。若要檢視共用功能，請選擇跨帳戶 。

  5. 在特徵目錄索引標籤下，選擇我的帳戶以檢視您的特徵群組。

  6. 在特徵目錄索引標籤下，選擇跨帳戶以檢視其他人可發現的功能群組。在 建立下，您可以檢視資源擁有者帳戶 ID。

  7. 您可以在搜尋下拉式清單中搜尋功能：

    • （選用） 若要篩選您的搜尋，請選擇搜尋下拉式清單旁的篩選條件圖示。您可以使用篩選條件來指定搜尋結果中的參數或日期範圍。如果您搜尋參數，請同時指定其索引鍵和值。若要尋找您的功能，請指定時間範圍，或清除 （取消選取） 您不想查詢的資料欄。

    • 對於共用資源，只有在您擁有從資源擁有者帳戶授予的適當存取權限時，才能編輯功能群組中繼資料或功能定義。僅探索能力許可將不允許您編輯中繼資料或功能定義。如需授予存取權限的詳細資訊，請參閱 啟用跨帳戶存取權。

本節中的程式碼使用 中的 Search操作 AWS SDK for Python (Boto3) 來執行搜尋查詢，以尋找功能群組中的功能。如需提交查詢之其他語言的相關資訊，請參閱 Amazon 參考 中的 。 SageMaker API

如需 Feature Store 範例和資源的詳細資訊，請參閱 Amazon SageMaker Feature Store 資源。

下列程式碼顯示使用 的不同搜尋查詢範例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"
    }
)