특성 그룹에서 특성 찾기

Amazon SageMaker Feature Store를 사용하면 특성 그룹에서 생성한 기능을 검색할 수 있습니다. 기능 그룹을 먼저 선택하지 않고도 모든 기능을 검색할 수 있습니다. 검색 기능은 사용 사례와 관련된 기능을 찾는 데 도움이 됩니다.

참고

기능을 검색하는 기능 그룹은 AWS 리전 및 내에 있어야 합니다 AWS 계정. 공유 특성 그룹의 경우 특성 그룹을 에서 검색할 수 있도록 만들어야 합니다 AWS 계정. 기능 그룹 카탈로그를 공유하고 검색 가능성을 부여하는 방법에 대한 자세한 내용은 섹션을 참조하세요특성 그룹 카탈로그를 공유합니다..

팀에 속해 있고 팀원이 모델에 사용할 기능을 찾고 있는 경우 모든 기능 그룹의 기능을 검색할 수 있습니다.

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

콘솔 또는 의 Search API 작업을 사용하여 기능을 검색할 수 있습니다 SageMaker. 다음 표에는 검색 가능한 메타데이터가 모두 나열되어 있으며 콘솔에서 검색할 수 있는지 또는 를 사용하여 검색할 수 있는지 여부가 나와 있습니다API.

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

기능을 검색하는 방법

콘솔을 통해 특성 저장소를 사용하는 지침은 Amazon SageMaker Studio 활성화했는지 여부에 따라 달라집니다Amazon SageMaker Studio Classic. 사용 사례에 따라 다음 지침 중 하나를 선택합니다.

Studio가 기본 환경인 경우 기능 검색(콘솔)

1. 의 지침에 따라 Studio 콘솔을 엽니다아마존 SageMaker 스튜디오 시작.

2. 왼쪽 탐색 창에서 데이터를 선택하여 드롭다운 목록을 확장합니다.

3. 드롭다운 목록에서 Feature Store(특성 저장소)를 선택합니다.

4. (선택 사항) 기능을 보려면 내 계정 을 선택합니다. 공유 기능을 보려면 교차 계정 을 선택합니다.

5. 특성 카탈로그 탭에서 내 계정을 선택하여 특성 그룹을 봅니다.

6. 기능 카탈로그 탭에서 교차 계정을 선택하여 다른 사용자가 검색 가능하게 만든 기능 그룹을 봅니다. 생성자 에서 리소스 소유자 계정 ID를 볼 수 있습니다.

7. 검색 드롭다운 목록에서 기능을 검색할 수 있습니다.

   • (선택 사항) 검색을 필터링하려면 검색 드롭다운 목록 옆에 있는 필터 아이콘을 선택합니다. 필터를 사용하여 검색 결과에서 파라미터나 날짜 범위를 지정할 수 있습니다. 파라미터를 검색하는 경우 키와 값을 모두 지정합니다. 기능을 찾으려면 시간 범위를 지정하거나 쿼리하지 않을 열을 선택 취소(선택 취소)합니다.

   • 공유 리소스의 경우 리소스 소유자 계정에서 적절한 액세스 권한이 부여된 경우에만 기능 그룹 메타데이터 또는 기능 정의를 편집할 수 있습니다. 검색 가능성 권한만으로는 메타데이터 또는 기능 정의를 편집할 수 없습니다. 액세스 권한 부여에 대한 자세한 내용은 섹션을 참조하세요계정 간 액세스 활성화.

Python(Boto3)SDK을 사용하여 기능 검색

이 섹션의 코드는 의 Search 작업을 사용하여 검색 쿼리를 실행 AWS SDK for Python (Boto3) 하여 기능 그룹에서 기능을 찾습니다. 쿼리를 제출할 다른 언어에 대한 자세한 내용은 Amazon SageMaker API 참조의 또한 섹션을 참조하세요.

자세한 특성 저장소 예제 및 리소스는 섹션을 참조하세요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"
    }
)