同期オペレーションを一覧表示する

特定の特徴ビューに対して実行されたデータ同期オペレーションを一覧表示できます。これは、BigQuery データソースからのデータ同期が正常に同期されているかどうか、特徴ビューのデータ同期が現在進行中であるかどうかを確認する場合に有効です。

始める前に

まだ行っていない場合は、Vertex AI に対する認証を行います。

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

特徴ビューで同期オペレーションを一覧表示する

特徴グループに対して実行されたすべての同期オペレーションのリストを表示するには、次のサンプルを使用します。

REST

FeatureView インスタンス内のデータ同期オペレーションの一覧を表示するには、featureViewSyncs.list メソッドを使用して GET リクエストを送信します。

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

  • LOCATION_ID: オンライン ストアがあるリージョン（us-central1 など）。
  • PROJECT_ID: プロジェクト ID。
  • FEATUREONLINESTORE_NAME: 特徴ビューを含むオンライン ストアの名前。
  • FEATUREVIEW_NAME: この名前の特徴ビューについて、データ同期オペレーションの一覧を表示します。

HTTP メソッドと URL:

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

リクエストを送信するには、次のいずれかのオプションを選択します。

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/featureViews/FEATUREVIEW_NAME/featureViewSyncs"

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/featureViews/FEATUREVIEW_NAME/featureViewSyncs" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "featureViewSyncs": [
    {
      "name": "PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID_1",
      "createTime": "2023-09-11T15:33:24.906716Z",
      "dataTransfer": {
        "endTime": "2023-09-11T15:33:43.615598Z"
      },
      "finalStatus": {
        "code": 13
      },
      "runTime": {
        "endTime": "2023-09-11T15:33:43.615598Z"
      }
    },
    {
      "name": "PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID_2",
      "createTime": "2023-09-06T23:48:00.670844Z",
      "dataTransfer": {
        "endTime": "2023-09-06T23:48:19.086848Z"
      },
      "finalStatus": {
        "code": 13
      },
      "runTime": {
        "endTime": "2023-09-06T23:48:19.086848Z"
      }
    }
  ]
}

次のステップ