开始数据同步

如果您的特征视图配置为使用定期数据同步,您可以选择手动启动数据同步,从而跳过等待下一次定期同步操作的时间。

如果您的特征视图配置为使用连续数据同步,则无法手动触发数据同步。如需详细了解 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"
}

后续步骤