特徴量ストアで特徴量グループを検索する - Amazon SageMaker
特徴量グループを検索する方法

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

特徴量ストアで特徴量グループを検索する

Amazon SageMaker Feature Store では、コンソールまたは検索オペレーションを使用して機能グループを検索できます。検索機能を使用して、作成中のモデルに関連する特徴量や特徴量グループを検索できます。検索機能を使用すると、ユースケースに関連する特徴量グループをすばやく見つけることができます。

注記

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

次の表は、検索可能なフィールドと、コンソールを使用して特定のフィールドを検索できるかどうかを示しています。

Amazon SageMaker Studio Classic または の Searchオペレーションを使用して機能を検索できます SageMaker API。次の表に、検索可能なメタデータと、コンソールで検索できるかどうかを示します。タグは独自の特徴量グループでは検索できますが、検索可能になった特徴量グループでは検索できません。

検索可能なメタデータ API フィールド名 コンソールで検索できますか？ クロスアカウントでの検索可能性
すべてのタグ AllTags 可能 不可
作成失敗の理由 FailureReason 不可 なし
作成ステータス FeatureGroupStatus あり 可能
作成時刻 CreationTime あり 可能
説明 [Description] (説明) あり 可能
イベントタイム特徴量名 EventTimeFeatureName 不可 なし
特徴量の定義 FeatureDefinitions 不可 なし
特徴量グループ ARN FeatureGroupARN 不可 なし
特徴量グループ名 FeatureGroupName あり 可能
オフラインストア設定 OfflineStoreConfig 不可 なし
オフラインストアステータス OfflineStoreStatus あり 可能
最終更新状況 LastUpdateStatus 不可 なし
レコード識別子特徴量名 RecordIdentifierFeatureName あり 可能
タグ Tags.key 可能 不可

特徴量グループを検索する方法

コンソールまたは Amazon SageMaker Feature Store を使用してAPI、特徴量グループを検索できます。コンソールで Feature Store を使用する手順は、 または をデフォルトのエクスペリエンスAmazon SageMaker StudioAmazon SageMaker Studio Classicとして有効にしているかどうかによって異なります。

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

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

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

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

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

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

  7. 検索ドロップダウンリストで特徴量グループを検索できます。

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

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

このセクションのコードは、 の Searchオペレーションを使用して検索クエリ AWS SDK for Python (Boto3) を実行して特徴量グループを検索します。クエリを送信するための他の言語の詳細については、Amazon SageMaker API リファレンスの「 も参照してください」を参照してください。

Feature Store の例とリソースの詳細については、「」を参照してくださいAmazon SageMaker Feature Store リソース。

次のコードは、 を使用したさまざまな検索クエリの例を示しています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'
            }
        ]
    }
)

Python AWS RAM APIs を使用してリソース共有SDKを作成することもできます。API 署名を以下に示します。SDK の Python を使用するには AWS RAM API、フルアクセス管理ポリシーを実行ロールにアタッチ AWS RAM する必要があります。

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