列出特征视图

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

  • 一个或多个特征组及其组成特征。每个特征组都与特征数据源(例如 BigQuery 表或视图)相关联。每个特征在 BigQuery 数据源中指定一个列。

  • 与特征视图直接关联的 BigQuery 表或视图。

如果某个特征视图配置为使用专用服务账号,则该特征视图的详细信息中还会包含关联的服务账号邮箱。如需详细了解如何使用专用服务账号配置创建特征视图,请参阅为特征视图配置服务账号

准备工作

向 Gemini Enterprise Agent Platform 进行身份验证 ,除非您已完成此操作。

选择标签页以了解您打算如何使用本页面上的示例:

控制台

当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。

REST

如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的 凭据。

    安装 Google Cloud CLI,然后 使用联合身份登录 gcloud CLI

如需了解详情,请参阅 使用 REST 时进行身份验证 的 Google Cloud 身份验证文档。

列出网店中的特征视图

使用以下示例可检索在项目中为特定位置的在线存储区创建的特征视图列表。

控制台

请按照以下说明,使用 Google Cloud 控制台查看网店中的特征视图列表。

  1. 在 Google Cloud 控制台的 Agent Platform 部分中,前往 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",
            ]
          }
        ]
      }
    }
  ]
}

后续步骤