列出特征视图

您可以检索 Google Cloud 项目中在线存储区内创建的所有特征视图实例的列表。对于每个特征视图，您还可以查看特征数据源，它可以是以下任何一种：

  • 一个或多个特征组及其组成特征。每个特征组都与特征数据源（例如 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

    如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 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 方法和网址： 

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

后续步骤