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

# 特徴量ストアで特徴量グループを検索する
<a name="feature-store-search-feature-group-metadata"></a>

Amazon SageMaker 特徴量ストアでは、コンソールまたは [Search](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html) オペレーションを使用して特徴量グループを検索できます。検索機能を使用して、作成中のモデルに関連する特徴量や特徴量グループを検索できます。検索機能を使用すると、ユースケースに関連する特徴量グループをすばやく見つけることができます。

**注記**  
検索する特徴量グループは、 AWS リージョン および AWS アカウント内にあるか、 と共有して検出可能にする必要があります AWS アカウント。特徴量グループカタログを共有して検出可能にする方法の詳細については、「[特徴量グループカタログの共有](feature-store-cross-account-discoverability-share-feature-group-catalog.md)」を参照してください。

次の表は、検索可能なフィールドと、特定のフィールドについての検索をコンソールで実行できるかどうかの一覧です。

Amazon SageMaker Studio Classic または SageMaker API の [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html) オペレーションを使用して特徴量を検索できます。次の表は、検索可能なすべてのメタデータと、コンソールで検索できるかどうかの一覧です。タグは独自の特徴量グループでは検索できますが、検索可能になった特徴量グループでは検索できません。


****  

| 検索可能なメタデータ | API フィールド名 | コンソールで検索可能か | クロスアカウントでの検索可能性 | 
| --- | --- | --- | --- | 
| すべてのタグ | AllTags | はい | いいえ | 
| 作成失敗の理由 | FailureReason | いいえ | いいえ | 
| 作成ステータス | [FeatureGroupStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | はい  | はい | 
| 作成時刻 | CreationTime | はい  | はい | 
| 説明 | [Description] (説明) | はい  | はい | 
| イベントタイム特徴量名 | EventTimeFeatureName | いいえ | いいえ | 
| 特徴量の定義 | [FeatureDefinitions](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureDefinition.html) | いいえ | いいえ | 
| 特徴量グループ ARN | [FeatureGroupARN](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | いいえ | いいえ | 
| 特徴量グループ名 | [FeatureGroupName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Yes | はい | 
| オフラインストア設定 | [OfflineStoreConfig](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreConfig.html) | いいえ | いいえ | 
| オフラインストアステータス | [OfflineStoreStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreStatus.html) | はい  | はい | 
| 最終更新状況 | [LastUpdateStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_LastUpdateStatus.html) | いいえ | いいえ | 
| レコード識別子特徴量名 | RecordIdentifierFeatureName | はい  | はい | 
| タグ | Tags.key | はい | いいえ | 

## 特徴量グループを検索する方法
<a name="feature-store-search-feature-group-metadata-how-to"></a>

コンソールまたは Amazon SageMaker 特徴量ストア API を使用して、特徴量グループを検索できます。コンソールから特徴量ストアを使用する手順は、デフォルトのエクスペリエンスとして有効にしたのが、[Amazon SageMaker Studio](studio-updated.md) か [Amazon SageMaker Studio Classic](studio.md) かによって異なります。

### Studio がデフォルトのエクスペリエンスである場合に特徴量グループを検索するには (コンソール)
<a name="feature-store-search-feature-group-metadata-how-to-using-studio-updated"></a>

1. 「[Amazon SageMaker Studio を起動する](studio-updated-launch.md)」の手順に従って、Studio コンソールを開きます。

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

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

1. (オプション) 特徴量グループを表示するには、**[アカウント]** をクリックします。共有特徴量グループを表示するには、**[クロスアカウント]** をクリックします。

1. **[特徴量グループカタログ]** タブで **[アカウント]** をクリックすると、特徴量グループが表示されます。

1. **[特徴量グループカタログ]** タブで **[クロスアカウント]** を選択すると、他のユーザーにより検索可能になった特徴量グループが表示されます。**[作成者]** では、リソース所有者のアカウント ID を確認できます。

1. **[検索]** ドロップダウンリストでは、以下のとおり特徴量グループを検索できます。
   + (オプション) 検索を絞り込むには、**[検索]** ドロップダウンリストの横にあるフィルターアイコンをクリックします。フィルターを使用して、検索結果のパラメータまたは日付範囲を指定できます。パラメータを検索する場合は、パラメータのキーと値の両方を指定します。特徴量グループを検索するには、時間範囲を指定したり、検索対象外の列を選択解除したり、検索対象のストアを選択したり、ステータスで検索したりできます。
   + 共有リソースについては、リソース所有者アカウントが適切なアクセス許可を付与した場合にのみ、特徴量グループのメタデータまたは特徴量定義を編集できます。検出可能性アクセス許可のみの場合、メタデータや特徴量定義を編集できません。アクセス許可の付与の詳細については、「[クロスアカウントアクセスを有効にする](feature-store-cross-account-access.md)」を参照してください。

### SDK for Python (Boto3) を使用して特徴量グループを検索するには
<a name="feature-store-search-feature-group-metadata-how-to-with-sdk"></a>

このセクションのコードでは、 の [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)オペレーション AWS SDK for Python (Boto3) を使用して検索クエリを実行して特徴量グループを検索します。クエリを送信する他の言語については、Amazon SageMaker API リファレンスの 「[See Also](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso)」を参照してください。**

追加の特徴量ストアの例とリソースについては、「[Amazon SageMaker Feature Store リソース](feature-store-resources.md)」を参照してください。

次のコードは、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'
            }
        ]
    }
)
```

API の Python SDK AWS RAM APIs を使用してリソース共有を作成することもできます。API 署名を以下に示します。 AWS RAM API の python SDK を使用するには、フルアクセス管理ポリシーを実行ロールにアタッチ 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',
    ]
)
```