특성 값 제공

Vertex AI Feature Store를 사용하면 온라인 스토어 내 특성 뷰에서 특성 값을 온라인으로 서빙할 수 있습니다. 예를 들어 온라인 예측을 위해 특성 뷰에서 특성 값을 서빙할 수 있습니다. 해당 특성의 특성을 온라인으로 제공하려면 먼저 특성 뷰를 최소 한 번 이상 동기화해야 합니다.

특성 뷰가 특성 그룹 및 특성을 기반으로 정의된 경우 Vertex AI Feature Store가 특정 엔티티 ID에 해당하는 최신 특성 값을 가져옵니다. ID 열에 값이 동일한 레코드가 여러 개 있으면 Vertex AI Feature Store가 feature_timestamp 열을 기반으로 null이 아닌 최신 특성 값을 가져옵니다.

특성 그룹과 특성을 연결하지 않고 특성 뷰가 BigQuery 데이터 소스와 직접 연결된 경우에는 Vertex AI Feature Store가 데이터 소스에서 모든 특성 값을 가져옵니다. 이 경우 데이터 소스의 모든 행이 고유한 ID를 포함해야 합니다.

요청당 하나의 ID에서만 특성 값을 제공할 수 있습니다.

온라인 스토어에 구성된 온라인 서빙 유형에 따라 다음 방법 중 하나로 특성 값을 서빙할 수 있습니다.

Bigtable 온라인 서빙을 사용하여 특성 값 가져오기: 온라인 스토어가 Bigtable 온라인 서빙을 위해 구성된 경우에만 이 옵션을 선택합니다.
공개 엔드포인트로 최적화된 온라인 서빙을 사용하여 특성 값 가져오기: 온라인 스토어가 공개 엔드포인트에서 최적화된 온라인 서빙을 위해 구성된 경우에만 이 옵션을 선택합니다.
Private Service Connect 엔드포인트로 최적화된 온라인 서빙을 사용하여 특성 값 가져오기: 온라인 스토어가 Private Service Connect를 통해 전용 서빙 엔드포인트에서 최적화된 온라인 서빙을 위해 구성된 경우에만 이 옵션을 선택합니다.

Bigtable 온라인 서빙을 사용하여 특성 값 가져오기

다음 샘플을 사용하면 Bigtable 온라인 서빙을 사용해서 특정 엔티티 ID를 기반으로 특성 값을 가져올 수 있습니다.

REST

FeatureView 인스턴스에서 특정 엔티티 ID에 대해 모든 최신 특성 값을 가져오려면 featureViews.fetchFeatureValues 메서드를 사용해서 POST 요청을 전송합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
FEATUREVIEW_NAME: 특성 값을 제공하려는 특성 뷰의 이름입니다.
ENTITY_ID: 최신 특성 값을 제공하려는 특성 레코드의 ID 열 값입니다.
FORMAT: 선택사항: 특성 값을 가져오려는 형식입니다. 지원되는 형식에는 JSON 키-값 쌍 및 proto Struct 형식이 포함됩니다.

HTTP 메서드 및 URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues

JSON 요청 본문:

{
  data_key: "ENTITY_ID",
  data_format: "FORMAT"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

key_values {
  features {
    value {
      int64_value: 258348
    }
    name: "feature_0"
  }
  features {
    value {
      double_value: 0.96300036744534068
    }
    name: "feature_1"
  }
  features {
    value {
      double_value: 0.42787383695351083
    }
    name: "feature_2"
  }
  features {
    value {
      double_value: 0.12219888824743128
    }
    name: "feature_3"
  }
  features {
    value {
      double_value: 0.037523154697944622
    }
    name: "feature_4"
  }
  features {
    value {
      double_value: 0.1766952509448767
    }
    name: "feature_5"
  }
}

Python

다음 샘플을 사용하면 Bigtable 온라인 서빙을 사용하여 특정 엔티티 ID를 기반으로 특성 값을 가져올 수 있습니다.

from google.cloud.aiplatform_v1 import FeatureOnlineStoreServiceClient
from google.cloud.aiplatform_v1.types import feature_online_store_service as feature_online_store_service_pb2

data_client = FeatureOnlineStoreServiceClient(
  client_options={"api_endpoint": f"LOCATION_ID-aiplatform.googleapis.com"}
)
data_client.fetch_feature_values(
  request=feature_online_store_service_pb2.FetchFeatureValuesRequest(
    feature_view=f"projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME",
    data_key=feature_online_store_service_pb2.FeatureViewDataKey(key="ENTITY_ID"),
    data_format=feature_online_store_service_pb2.FeatureViewDataFormat.FORMAT,
  )
)

다음을 바꿉니다.

LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
FEATUREVIEW_NAME: 특성 값을 제공하려는 특성 뷰의 이름입니다.
ENTITY_ID: 최신 특성 값을 제공하려는 특성 레코드의 ID 열 값입니다.
FORMAT: 선택사항: 특성 값을 가져오려는 형식입니다. 지원되는 형식에는 JSON KEY_VALUE 쌍과 proto PROTO_STRUCT 형식이 포함됩니다.

공개 엔드포인트에서 최적화된 온라인 서빙을 사용하여 특성 값 가져오기

공개 엔드포인트에서 최적화된 온라인 서빙을 사용하여 특성 값을 서빙하도록 온라인 스토어 인스턴스를 구성한 경우 다음 단계를 수행하여 온라인 스토어 내의 특성 뷰에서 특성 값을 가져와야 합니다.

FeatureOnlineStore 인스턴스의 공개 엔드포인트 도메인 이름을 검색합니다.
공개 엔드포인트 도메인 이름을 사용하여 엔티티 ID에서 특성 값을 가져옵니다.

온라인 스토어의 공개 엔드포인트 도메인 이름 검색

공개 엔드포인트로 최적화된 온라인 서빙을 위해 온라인 스토어 인스턴스를 만들고 구성하면 Vertex AI Feature Store는 온라인 스토어의 공개 엔드포인트 도메인 이름을 생성합니다. 온라인 스토어의 특성 뷰에서 특성 값을 서빙하려면 먼저 온라인 스토어 세부정보에서 공개 엔드포인트 도메인 이름을 검색해야 합니다.

다음 샘플을 사용하여 온라인 스토어 인스턴스의 세부정보를 검색합니다.

REST

프로젝트의 FeatureOnlineStore 리소스 세부정보를 검색하려면 featureOnlineStores.get 메서드를 사용하여 GET 요청을 전송합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 온라인 스토어 인스턴스의 이름입니다.

HTTP 메서드 및 URL:

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME_1",
  "createTime": "2023-09-06T23:25:04.256314Z",
  "updateTime": "2023-09-06T23:25:04.256314Z",
  "etag": "AMEw9yMgoV0bAsYuKwVxz4Y7lOmxV7riNVHg217KaQAKORqvdqGCrQ1DIt8yHgoGXf8=",
  "state": "STABLE",
  "dedicatedServingEndpoint": {
    "publicEndpointDomainName": "PUBLIC_ENDPOINT_DOMAIN_NAME"
  },
  "optimized": {}
}

다음 단계에서 특성 값을 가져오려면 응답의 PUBLIC_ENDPOINT_DOMAIN_NAME이 필요합니다.

엔티티 ID에서 특성 값 가져오기

온라인 스토어 인스턴스의 공개 엔드포인트 도메인 이름을 검색한 후 다음 샘플을 사용하여 최적화된 온라인 서빙을 통해 특정 엔티티 ID의 특성 값을 가져옵니다.

REST

FeatureView 인스턴스에서 특정 엔티티 ID에 대해 모든 최신 특성 값을 가져오려면 featureViews.fetchFeatureValues 메서드를 사용해서 POST 요청을 전송합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PUBLIC_ENDPOINT_DOMAIN_NAME: featureOnlineStores.get 메서드를 사용하여 검색한 온라인 스토어 인스턴스의 공개 엔드포인트 도메인 이름입니다.
LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
FEATUREVIEW_NAME: 특성 값을 제공하려는 특성 뷰의 이름입니다.
ENTITY_ID: 최신 특성 값을 제공하려는 특성 레코드의 ID 열 값입니다.
FORMAT: 선택사항: 특성 값을 가져오려는 형식입니다. 지원되는 형식에는 JSON 키-값 쌍 및 proto Struct 형식이 포함됩니다.

HTTP 메서드 및 URL:

POST https://PUBLIC_ENDPOINT_DOMAIN_NAME/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues

JSON 요청 본문:

{
  data_key: "ENTITY_ID",
  data_format: "FORMAT"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://PUBLIC_ENDPOINT_DOMAIN_NAME/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://PUBLIC_ENDPOINT_DOMAIN_NAME/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:fetchFeatureValues" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

key_values {
  features {
    value {
      int64_value: 258348
    }
    name: "feature_0"
  }
  features {
    value {
      double_value: 0.96300036744534068
    }
    name: "feature_1"
  }
  features {
    value {
      double_value: 0.42787383695351083
    }
    name: "feature_2"
  }
  features {
    value {
      double_value: 0.12219888824743128
    }
    name: "feature_3"
  }
  features {
    value {
      double_value: 0.037523154697944622
    }
    name: "feature_4"
  }
  features {
    value {
      double_value: 0.1766952509448767
    }
    name: "feature_5"
  }
}

Python

다음 샘플을 사용하면 최적화된 온라인 서빙을 사용해서 특정 엔티티 ID를 기반으로 특성 값을 가져올 수 있습니다.

from google.cloud.aiplatform_v1 import FeatureOnlineStoreServiceClient
from google.cloud.aiplatform_v1.types import feature_online_store_service as feature_online_store_service_pb2

data_client = FeatureOnlineStoreServiceClient(
  client_options={"api_endpoint": f"PUBLIC_ENDPOINT_DOMAIN_NAME"}
)
data_client.fetch_feature_values(
  request=feature_online_store_service_pb2.FetchFeatureValuesRequest(
    feature_view=f"projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME",
    id=f"ENTITY_ID",
    format=feature_online_store_service_pb2.FetchFeatureValuesRequest.Format.FORMAT,
  )
)

다음을 바꿉니다.

PUBLIC_ENDPOINT_DOMAIN_NAME: featureOnlineStores.get 메서드를 사용하여 검색한 온라인 스토어 인스턴스의 공개 엔드포인트 도메인 이름입니다.
LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
FEATUREVIEW_NAME: 특성 값을 제공하려는 특성 뷰의 이름입니다.
ENTITY_ID: 최신 특성 값을 제공하려는 특성 레코드의 ID 열 값입니다.
FORMAT: 선택사항: 특성 값을 가져오려는 형식입니다. 지원되는 형식에는 JSON KEY_VALUE 쌍과 proto PROTO_STRUCT 형식이 포함됩니다.

Private Service Connect 엔드포인트에서 최적화된 온라인 서빙을 사용하여 특성 값 가져오기

Private Service Connect 엔드포인트에서 최적화된 온라인 서빙을 사용하여 특성 값을 서빙하도록 온라인 스토어 인스턴스를 구성한 경우 다음 단계를 수행하여 온라인 스토어 내의 특성 뷰에서 특성 값을 가져와야 합니다.

FeatureOnlineStore 인스턴스의 Private Service Connect 구성을 검색합니다.
네트워크 구성에 Private Service Connect의 엔드포인트를 추가합니다.
gRPC를 통해 Private Service Connect 엔드포인트에 연결합니다.
엔티티 ID에서 특성 값을 가져옵니다.

온라인 스토어의 서비스 연결 문자열 검색

Private Service Connect 엔드포인트로 최적화된 온라인 서빙을 위해 온라인 스토어 인스턴스를 만들고 구성할 때 Vertex AI Feature Store는 Private Service Connect 엔드포인트를 설정하는 데 사용할 수 있는 서비스 연결 문자열을 생성합니다. 온라인 스토어 세부정보에서 서비스 연결 문자열을 검색할 수 있습니다.

다음 샘플을 사용하여 온라인 스토어 인스턴스의 세부정보를 검색합니다.

REST

프로젝트의 FeatureOnlineStore 리소스 세부정보를 검색하려면 featureOnlineStores.get 메서드를 사용하여 GET 요청을 전송합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 온라인 스토어 인스턴스의 이름입니다.

HTTP 메서드 및 URL:

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME_1",
  "createTime": "2023-09-06T23:25:04.256314Z",
  "updateTime": "2023-09-06T23:25:04.256314Z",
  "etag": "AMEw9yMgoV0bAsYuKwVxz4Y7lOmxV7riNVHg217KaQAKORqvdqGCrQ1DIt8yHgoGXf8=",
  "state": "STABLE",
  "dedicatedServingEndpoint": {
    "privateServiceConnectConfig": {
      "enablePrivateServiceConnect": "true",
      "projectAllowlist": [
        "PROJECT_NAME"
      ]
    },
    serviceAttachment: "SERVICE_ATTACHMENT_STRING"
  },
  "optimized": {}
}

다음 단계에서 특성 값을 가져오려면 응답의 SERVICE_ATTACHMENT_STRING이 필요합니다.

Private Service Connect의 엔드포인트 추가

최적화된 온라인 서빙을 위한 Private Service Connect 엔드포인트를 네트워크 구성에 추가하려면 다음 단계를 수행합니다.

Google Cloud 콘솔에서 온라인 스토어 인스턴스가 포함된 프로젝트를 선택합니다.
SERVICE_ATTACHMENT_STRING을 대상 서비스로 지정하여 Private Service Connect의 엔드포인트를 만듭니다. Private Service Connect의 엔드포인트를 만드는 방법에 대한 자세한 내용은 엔드포인트 만들기를 참조하세요.

엔드포인트를 만들면 Private Service Connect 페이지의 연결된 엔드포인트 탭에 표시됩니다. 엔드포인트의 IP 주소가 IP 주소 열에 표시됩니다.

연결된 엔드포인트 탭으로 이동

다음 단계에서 gRPC를 통해 온라인 서비스 인스턴스의 엔드포인트를 Private Service Connect 엔드포인트에 연결하려면 이 IP 주소를 사용해야 합니다.

gRPC를 통해 Private Service Connect 엔드포인트에 연결

다음 코드 샘플을 사용하여 gRPC를 통해 온라인 스토어용으로 생성된 Private Service Connect 엔드포인트에 연결합니다.

Python

from google.cloud.aiplatform_v1 import FeatureOnlineStoreServiceClient
from google.cloud.aiplatform_v1.services.feature_online_store_service.transports.grpc import FeatureOnlineStoreServiceGrpcTransport
import grpc

data_client = FeatureOnlineStoreServiceClient(
  transport = FeatureOnlineStoreServiceGrpcTransport(
    # Add the IP address of the Endpoint you just created.
    channel = grpc.insecure_channel("ENDPOINT_IP:10002")
  )
)

다음을 바꿉니다.

ENDPOINT_IP: Private Service Connect 페이지의 IP 주소 열에 있는 엔드포인트의 IP 주소입니다.

엔티티 ID에서 특성 값 가져오기

gRPC를 통해 Private Service Connect 엔드포인트에 연결한 후 다음 샘플을 사용하여 최적화된 온라인 서빙을 통해 특정 엔티티 ID의 특성 값을 가져옵니다.

Python

data_client.fetch_feature_values(
  request=feature_online_store_service_pb2.FetchFeatureValuesRequest(
  feature_view=f"projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME",
  data_key=feature_online_store_service_pb2.FeatureViewDataKey(ENTITY_ID),
  data_format=feature_online_store_service_pb2.FeatureViewDataFormat.PROTO_STRUCT,
  )
)

다음을 바꿉니다.

LOCATION_ID: 온라인 저장소가 있는 리전입니다(예: us-central1).
PROJECT_ID: 프로젝트 ID입니다.
FEATUREONLINESTORE_NAME: 특성 뷰가 포함된 온라인 스토어의 이름입니다.
FEATUREVIEW_NAME: 특성 값을 제공하려는 특성 뷰의 이름입니다.
ENTITY_ID: 최신 특성 값을 제공하려는 특성 레코드의 ID 열 값입니다.
FORMAT: 선택사항: 특성 값을 가져오려는 형식입니다. 지원되는 형식에는 JSON 키-값 쌍 및 proto Struct 형식이 포함됩니다.

다음 단계

특성 뷰의 데이터 동기화 방법 알아보기
온라인 스토어 업데이트 방법 알아보기