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

# 특성 그룹에서 특성 찾기
<a name="feature-store-search-metadata"></a>

Amazon SageMaker Feature Store를 사용하면 특성 그룹에서 만든 특성을 검색할 수 있습니다. 특성 그룹을 먼저 선택할 필요 없이 모든 특성을 검색할 수 있습니다. 검색 기능은 사용 사례와 관련된 특성을 빠르게 찾는 데 유용합니다.

**참고**  
특성을 검색하는 특성 그룹은 AWS 리전 및 내에 있어야 합니다 AWS 계정. 공유 특성 그룹의 경우 특성 그룹을 AWS 계정에서 검색할 수 있도록 해야 합니다. 특성 그룹 카탈로그를 공유하고 검색 가능성을 부여하는 방법에 대한 자세한 지침은 [특성 그룹 카탈로그를 공유합니다.](feature-store-cross-account-discoverability-share-feature-group-catalog.md) 섹션을 참조하세요.

팀에 속해 있고 팀원이 자신의 모델에 사용할 특성을 찾고 있다면 팀원은 모든 특성 그룹의 모든 특성을 검색할 수 있습니다.

검색 가능한 파라미터와 설명을 추가하여 특성을 더 쉽게 찾을 수 있습니다. 자세한 내용은 [특성에 검색 가능한 메타데이터 추가](feature-store-add-metadata.md) 단원을 참조하십시오.

콘솔 또는 SageMaker AI에서 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html) 작업을 사용하여 특성을 검색할 수 있습니다. 다음 테이블 목록에는 검색 가능한 모든 메타데이터와 콘솔 또는 API를 사용하여 해당 메타데이터를 검색할 수 있는지가 나와 있습니다.


****  

| 검색 가능한 메타데이터 | API 필드 이름 | 콘솔에서 검색 가능 여부 | 
| --- | --- | --- | 
| 모든 파라미터 | AllParameters | 예 | 
| 생성 시간 | CreationTime | 예 | 
| Description | Description | 예 | 
| 특성 그룹 이름 | FeatureGroupName | 아니요 | 
| 특성 이름 | FeatureName | 예 | 
| 특성 유형 | FeatureType | 아니요 | 
| 최근 수정 시간 | LastModifiedTime | 아니요 | 
| 파라미터 | Parameters.{{key}} | 예 | 

## 특성을 검색하는 방법
<a name="feature-store-search-metadata-how-to"></a>

콘솔을 통한 Feature Store 사용에 대한 지침은 기본 환경으로 [Amazon SageMaker Studio](studio-updated.md)를 활성화했는지 아니면 [Amazon SageMaker Studio Classic](studio.md)을 활성화했는지에 따라 달라집니다. 사용 사례에 따라 다음 지침 중 하나를 선택합니다.

### Studio가 기본 환경인 경우 특성 검색(콘솔)
<a name="feature-store-search-metadata-how-to-with-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-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 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"
    }
)
```