기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 특성 저장소에서 특성 그룹을 찾아보세요.
<a name="feature-store-search-feature-group-metadata"></a>

Amazon SageMaker Feature Store에서는 콘솔 또는 [검색](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 | 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) | 예 | 예 | 
| 오프라인 저장소 구성 | [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 | Tags.key | 예 | 아니요 | 

## 특성 그룹을 찾는 방법
<a name="feature-store-search-feature-group-metadata-how-to"></a>

콘솔 또는 Amazon SageMaker Feature Store API를 사용하여 특성 그룹을 찾을 수 있습니다. 콘솔을 통한 Feature Store 사용에 대한 지침은 기본 환경으로 [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 참조의 [참고 항목](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso)을 참조하세요.**

추가 Feature Store 예시 및 리소스는 [Amazon SageMaker 특성 저장소 리소스](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'
            }
        ]
    }
)
```

 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',
    ]
)
```