Vertex AI Feature Store를 사용하면 다음 유형의 리소스에 라벨을 추가하거나 업데이트할 수 있습니다.
- 특성 그룹(
FeatureGroup
) - 특성(
Feature
) - 온라인 스토어 인스턴스(
FeatureOnlineStore
) - 특성 뷰 인스턴스(
FeatureView
)
리소스 생성 중에 라벨을 추가하거나 기존 리소스에 라벨을 추가할 수 있습니다. 이러한 리소스에 라벨을 추가하는 것은 선택사항입니다.
특성 그룹의 라벨 업데이트
다음 샘플을 사용하여 기존 특성 그룹의 라벨을 업데이트합니다.
REST
기존 FeatureGroup
리소스의 라벨을 업데이트하려면 featureGroups.patch 메서드를 사용하여 PATCH
요청을 보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION_ID: 특성 그룹이 있는 리전(예:
us-central1
) - PROJECT_ID: 프로젝트 ID입니다.
- FEATUREGROUP_NAME: 업데이트하려는 특성 그룹의 이름입니다.
- LABELS_JSON: JSON 형식의 키-값 쌍으로 특성 그룹에 연결할 라벨입니다.
예를 들면
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
입니다.
HTTP 메서드 및 URL:
PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME
JSON 요청 본문:
{ "labels": LABELS_JSON }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T03:00:13.060636Z", "updateTime": "2023-09-18T03:00:13.060636Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureGroup", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME" } }
특성 라벨 업데이트
다음 샘플을 사용하여 기존 특성의 라벨을 업데이트합니다.
REST
기존 Feature
리소스의 라벨을 업데이트하려면 features.patch 메서드를 사용하여 PATCH
요청을 전송합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION_ID: 특성이 포함된 특성 그룹이 있는 리전입니다(예:
us-central1
). - PROJECT_ID: 프로젝트 ID입니다.
- FEATUREGROUP_NAME: 특성이 포함된 특성 그룹의 이름입니다.
- FEATURE_NAME: 업데이트하려는 특성의 이름입니다.
- LABELS_JSON: JSON 형식의 키-값 쌍으로 특성에 연결할 라벨입니다.
예를 들면
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
입니다.
HTTP 메서드 및 URL:
PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
JSON 요청 본문:
{ "labels": LABELS_JSON }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.Feature", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME" } }
온라인 스토어의 라벨 업데이트
다음 샘플을 사용하여 기존 온라인 스토어 인스턴스의 라벨을 업데이트합니다.
REST
기존 FeatureOnlineStore
리소스의 라벨을 업데이트하려면 featureOnlineStores.patch 메서드를 사용하여 PATCH
요청을 보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- REGION_ID: 온라인 저장소가 있는 리전(예:
us-central1
) - PROJECT_ID: 프로젝트 ID입니다.
- FEATUREONLINESTORE_NAME: 업데이트하려는 온라인 스토어의 이름입니다.
- LABELS_JSON: JSON 형식의 키-값 쌍으로 온라인 스토어에 연결할 라벨입니다.
예를 들면
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
입니다.
HTTP 메서드 및 URL:
PATCH http://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME
JSON 요청 본문:
{ "labels": LABELS_JSON }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T17:49:23.847496Z", "updateTime": "2023-09-18T17:49:23.847496Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME" } }
특성 뷰의 라벨 업데이트
다음 샘플을 사용하여 기존 특성 뷰의 라벨을 업데이트합니다.
REST
기존 FeatureView
리소스의 라벨을 업데이트하려면 featureViews.patch 메서드를 사용하여 PATCH
요청을 보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION_ID: 온라인 저장소가 있는 리전(예:
us-central1
) - PROJECT_ID: 프로젝트 ID
- FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
- FEATUREVIEW_NAME: 업데이트하려는 특성 뷰의 이름입니다.
- LABELS_JSON: JSON 형식의 키-값 쌍으로 특성 뷰에 연결할 라벨입니다.
예를 들면
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
입니다.
HTTP 메서드 및 URL:
PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME
JSON 요청 본문:
{ "labels": LABELS_JSON }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata", "genericMetadata": { "createTime": "2023-09-15T04:53:34.832192Z", "updateTime": "2023-09-15T04:53:34.832192Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" } }
다음 단계
특성 그룹 업데이트 방법 알아보기
특성 업데이트 방법 알아보기
온라인 스토어 인스턴스 업데이트 방법 알아보기
특성 뷰 업데이트 방법 알아보기