特徴量グループ内の特徴量の検索 - Amazon SageMaker
機能を検索する方法

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

特徴量グループ内の特徴量の検索

Amazon SageMaker Feature Store では、特徴量グループで作成した特徴量を検索できます。最初に特徴量グループを選択することなく、すべての特徴量を検索できます。検索機能は、ユースケースに関連する機能を見つけるのに役立ちます。

注記

特徴量を検索する特徴量グループは、 AWS リージョン と 内にある必要があります AWS アカウント。共有特徴量グループの場合、特徴量グループを が検出できるようにする必要があります AWS アカウント。特徴量グループカタログを共有し、検出可能性を付与する方法の詳細については、「」を参照してください特徴量グループカタログの共有。

チームに参加していて、チームメイトがモデルで使用する機能を探している場合、すべての機能グループで機能を検索できます。

検索可能なパラメータと説明を追加して、特徴量を見つけやすくすることができます。詳細については、「検索可能なメタデータを特徴量に追加する」を参照してください。

コンソールまたは の SearchAPIオペレーションを使用して、機能を検索できます SageMaker。次の表に、検索可能なメタデータと、コンソールで検索できるか、 で検索できるかを示しますAPI。

検索可能なメタデータ API フィールド名 コンソールで検索できますか？
すべてのパラメータ AllParameters 可能
作成時刻 CreationTime 可能
説明 [Description] (説明) 可能
特徴量グループ名 FeatureGroupName 不可
特徴量名 FeatureName 可能
特徴量タイプ FeatureType 不可
最終更新日時 LastModifiedTime 不可
パラメータ パラメータ。key 可能

機能を検索する方法

コンソールで Feature Store を使用する手順は、 を有効にしたかAmazon SageMaker Studio、デフォルトのエクスペリエンスAmazon SageMaker Studio Classicとして有効にしたかによって異なります。ユースケースに基づいて、次のいずれかの手順を選択します。

  1. の指示に従って Studio コンソールを開きますAmazon SageMaker Studio を起動する。

  2. 左側のナビゲーションペインでデータを選択して、ドロップダウンリストを展開します。

  3. ドロップダウンリストから [Feature Store]を選択します。

  4. （オプション) 機能を表示するには、マイアカウント を選択します。共有機能を表示するには、クロスアカウント を選択します。

  5. Feature Catalog タブで、My アカウントを選択して特徴量グループを表示します。

  6. Feature Catalog タブで、クロスアカウントを選択して、他のユーザーが検出可能にした特徴量グループを表示します。によって作成された では、リソース所有者アカウント 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"
    }
)