特徴ビューを一覧表示する

Google Cloud プロジェクトのオンライン ストア内に作成されたすべての特徴ビュー インスタンスのリストを取得できます。特徴ビューごとに、次のいずれかの特徴データソースを表示できます。

  • 1 つ以上の特徴グループとそれを構成する特徴。各特徴グループは、BigQuery のテーブルやビューなどの特徴データソースに関連付けられます。各特徴は BigQuery データソース内の列を表します。

  • 特徴ビューに直接関連付けられた BigQuery テーブルまたはビュー。

専用のサービス アカウントを使用するように特徴ビューが構成されている場合、その特徴ビューの詳細には、関連付けられたサービス アカウントのメールアドレスも含まれます。専用のサービス アカウント構成で特徴ビューを作成する方法については、特徴ビューのサービス アカウントを構成するをご覧ください。

始める前に

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

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

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

    Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。 

    gcloud init

    外部 ID プロバイダ（IdP）を使用している場合は、まずフェデレーション ID を使用して gcloud CLI にログインする必要があります。

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

オンライン ストアの特徴ビューのリストを取得する

次のサンプルを使用して、プロジェクトのオンライン ストアで特定のロケーション用に作成された特徴ビューのリストを取得します。

コンソール

Google Cloud コンソールを使用してオンライン ストアで特徴ビューのリストを表示するには、次の操作を行います。

  1. Google Cloud コンソールの [Vertex AI] セクションで、[Feature Store] ページに移動します。

    [Feature Store] ページに移動

  2. [オンライン ストア] をクリックします。

  3. オンライン ストアの名前をクリックして、[オンライン ストアの詳細] ページで詳細を表示します。

  4. [特徴ビュー] セクションに、選択したロケーションのすべてのオンライン ストアのリストを表示できます。

REST

プロジェクトの特定のオンライン ショップで作成されたすべての FeatureView インスタンスのリストを取得するには、featureViews.list メソッドを使用して 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/featureViews

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

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"

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" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。レスポンスにリストされている特徴ビューのいずれかに専用のサービス アカウント構成がある場合、その詳細にサービス アカウントのメールアドレスもリストされます。この例では、SERVICE_ACCOUNT_EMAIL は特徴ビュー FEATUREVIEW_NAME_1 に関連付けられたサービス アカウントのメールアドレスです。
{
  "featureViews": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_1",
      "createTime": "2023-09-06T23:46:49.936284Z",
      "updateTime": "2023-09-06T23:46:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_1",
              "FEATURE_ID_2",
            ]
          }
        ]
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_2",
      "createTime": "2024-02-05T23:48:49.936284Z",
      "updateTime": "2024-02-05T23:48:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_3",
              "FEATURE_ID_4",
            ]
          }
        ]
      }
    }
  ]
}

次のステップ