如果您的特征视图配置为使用定期数据同步,您可以选择手动启动数据同步,从而跳过等待下一次定期同步操作的时间。
如果您的特征视图配置为使用连续数据同步,则无法手动触发数据同步。如需详细了解 Vertex AI Feature Store 支持的数据同步类型以及如何为特征视图配置同步类型,请参阅在特征视图中同步特征数据。
请注意,如需同步整个在线存储区的数据,您需要同步其所有特征视图的数据。
数据同步可能会产生 BigQuery 资源使用费。如需了解在为特征视图设置同步时间表时如何优化费用,请参阅在同步期间优化费用。
准备工作
向 Vertex AI 进行身份验证,除非您已完成此操作。
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭据。
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。
手动启动数据同步
使用以下示例可在已配置为定期同步数据的特征视图中手动启动数据同步。
请注意,对于一个特征视图,一次只能执行一项数据同步操作。如果正在进行另一个同步期间尝试手动启动数据同步,则新的同步操作只会在正在进行的同步操作结束后才开始。
REST
如需在 FeatureView
中手动启动数据同步,请使用 featureViews.sync 方法发送 POST
请求。
在使用任何请求数据之前,请先进行以下替换:
- LOCATION_ID:在线存储区所在的区域,例如
us-central1
。 - PROJECT_ID:您的项目 ID。
- FEATUREONLINESTORE_NAME:包含特征视图的在线存储区的名称。
- FEATUREVIEW_NAME:您要在其中手动启动数据同步的特征视图的名称。
HTTP 方法和网址:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync"
PowerShell
执行以下命令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync" | Select-Object -Expand Content
您应该收到类似以下内容的 JSON 响应:
{ "featureViewSync": "projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID" }
后续步骤
了解如何更新特征视图