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

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

注記

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

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

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

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

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

機能を検索する方法

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

Studio がデフォルトのエクスペリエンスである場合に機能を検索する (コンソール）

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

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

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

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

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

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

7. 検索ドロップダウンリストで機能を検索できます。

   • （オプション) 検索をフィルタリングするには、検索ドロップダウンリストの横にあるフィルターアイコンを選択します。フィルターを使用して、検索結果のパラメータまたは日付範囲を指定できます。パラメータを検索する場合は、そのキーと値の両方を指定します。特徴量を検索するには、時間範囲を指定するか、クエリしない列をクリア (選択解除) します。

   • 共有リソースでは、リソース所有者アカウントから適切なアクセス許可が付与されている場合にのみ、特徴量グループのメタデータまたは特徴量定義を編集できます。検出権限だけでは、メタデータや機能定義を編集することはできません。アクセス許可の付与の詳細については、「」を参照してくださいクロスアカウントアクセスを有効にする。

SDK for Python (Boto3) を使用して機能を検索する

このセクションのコードは、 の 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"
    }
)