データの同期を開始する

スケジュールされたデータ同期を使用するように特徴ビューが構成されている場合は、データ同期を手動で開始して、次に予定されている同期オペレーションまでの待機をスキップできます。

継続的なデータ同期を使用するように特徴ビューが構成されている場合は、データ同期を手動でトリガーすることはできません。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 を使用して認証するをご覧ください。

データの同期を手動で開始する

次のサンプルでは、スケジュールされたデータ同期用に構成された特徴ビューでデータ同期を手動で開始します。

ただし、特徴ビューに対して有効にできるデータ同期オペレーションは一度に 1 つのみです。別の同期の進行中にデータ同期を手動で開始しようとすると、新しい同期オペレーションは、進行中の同期オペレーションが終了した後に開始されます。

REST

FeatureView でデータ同期を手動で開始するには、featureViews.sync メソッドを使用して POST リクエストを送信します。

リクエストのデータを使用する前に、次のように置き換えます。

  • LOCATION_ID: オンライン ストアがあるリージョン(us-central1 など)。
  • PROJECT_ID: プロジェクト ID。
  • FEATUREONLINESTORE_NAME: 特徴ビューを含むオンライン ショップの名前。
  • FEATUREVIEW_NAME: データ同期を手動で開始する特徴ビューの名前。

HTTP メソッドと URL:

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"
}

次のステップ