기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon SageMaker Feature Store에서는 콘솔 또는 검색 작업을 사용하여 특성 그룹을 검색할 수 있습니다. 검색 기능을 사용하여 생성 중인 모델과 관련된 특성 및 특성 그룹을 찾을 수 있습니다. 검색 기능을 사용하여 사용 사례와 관련된 특성 그룹을 빠르게 찾을 수 있습니다.
참고
검색하려는 특성 그룹은 AWS 리전 및 AWS 계정 내에 있거나와 공유되고 검색 가능해야 합니다 AWS 계정. 특성 그룹 카탈로그를 공유하고 검색 가능성을 부여하는 방법에 대한 자세한 내용은 특성 그룹 카탈로그를 공유합니다. 섹션을 참조하세요.
다음 테이블에는 검색 가능한 필드와 콘솔을 사용하여 특정 필드를 검색할 수 있는지가 나와 있습니다.
Amazon SageMaker Studio Classic 또는 SageMaker API의 Search 작업을 사용하여 특성을 검색할 수 있습니다. 다음 테이블 목록에는 검색 가능한 모든 메타데이터와 콘솔을 사용하여 해당 메타데이터를 검색할 수 있는지가 나와 있습니다. 태그는 자체 특성 그룹에 대한 검색이 가능하지만 검색 가능한 특성 그룹에 대해서는 검색할 수 없습니다.
| 검색 가능한 메타데이터 | API 필드 이름 | 콘솔에서 검색 가능 여부 | 교차 계정으로 검색 가능? |
|---|---|---|---|
| 모든 태그 | AllTags | 예 | No |
| 생성 실패 사유 | FailureReason | No | No |
| 생성 상태 | FeatureGroupStatus | 예 | 예 |
| 생성 시간 | CreationTime | 예 | 예 |
| Description | Description | 예 | 예 |
| 이벤트 시간 특성 이름 | EventTimeFeatureName | No | No |
| 특성 정의 | FeatureDefinitions | No | No |
| 특성 그룹 ARN | FeatureGroupARN | No | No |
| 특성 그룹 이름 | FeatureGroupName | 예 | 예 |
| 오프라인 저장소 구성 | OfflineStoreConfig | No | No |
| 오프라인 저장소 상태 | OfflineStoreStatus | 예 | 예 |
| 마지막 업데이트 상태 | LastUpdateStatus | No | No |
| 레코드 식별자 특성 이름 | RecordIdentifierFeatureName | 예 | 예 |
| Tags | Tags.key |
예 | No |
특성 그룹을 찾는 방법
콘솔 또는 Amazon SageMaker Feature Store API를 사용하여 특성 그룹을 찾을 수 있습니다. 콘솔을 통한 Feature Store 사용에 대한 지침은 기본 환경으로 Amazon SageMaker Studio를 활성화했는지 아니면 Amazon SageMaker Studio Classic을 활성화했는지에 따라 달라집니다.
-
Amazon SageMaker Studio 출시의 지침에 따라 Studio 콘솔을 엽니다.
-
왼쪽 탐색 창에서 데이터를 선택하여 드롭다운 목록을 확장합니다.
-
드롭다운 목록에서 Feature Store(특성 저장소)를 선택합니다.
-
(선택 사항) 특성 그룹을 보려면 내 계정을 선택합니다. 공유 특성 그룹을 보려면 교차 계정을 선택합니다.
-
특성 그룹 카탈로그 탭에서 내 계정을 선택하여 특성 그룹을 확인합니다.
-
특성 그룹 카탈로그 탭에서 교차 계정을 선택하여 다른 사람이 내가 검색할 수 있게 설정해둔 특성 그룹을 확인합니다. 만든 사람에서 리소스 소유자 계정 ID를 볼 수 있습니다.
-
검색 드롭다운 목록에서 특성 그룹을 검색할 수 있습니다.
-
(선택 사항) 검색을 필터링하려면 검색 드롭다운 목록 옆에 있는 필터 아이콘을 선택합니다. 필터를 사용하여 검색 결과에서 파라미터나 날짜 범위를 지정할 수 있습니다. 파라미터를 검색하는 경우 해당 키와 값을 모두 지정하세요. 특성 그룹을 찾으려면 시간 범위를 지정하거나, 쿼리하지 않을 열을 지우거나(선택 취소), 검색할 저장소를 선택하거나, 상태별로 검색하면 됩니다.
-
공유 리소스의 경우 리소스 소유자 계정에서 적절한 액세스 권한을 부여받은 경우에만 특성 그룹 메타데이터 또는 특성 정의를 편집할 수 있습니다. 검색 가능 권한만으로는, 메타데이터나 특성 정의를 편집할 수 없습니다. 이러한 액세스 권한 부여에 대한 자세한 내용은 계정 간 액세스 활성화 섹션을 참조하세요.
-
이 섹션의 코드는의 Search 작업을 사용하여 검색 쿼리를 실행 AWS SDK for Python (Boto3) 하여 특성 그룹을 찾습니다. 쿼리를 제출하기 위한 다른 언어에 대한 자세한 내용은 Amazon SageMaker API 참조의 참고 항목을 참조하세요.
추가 Feature Store 예시 및 리소스는 Amazon SageMaker 특성 저장소 리소스 섹션을 참조하세요.
다음 코드는 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',
]
)