更新特征组

您可以更新特征组，以将 BigQuery 表或视图注册为该特征组的特征数据源。如果特征组已具有关联的数据源，则可以关联另一个 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

如需更新 FeatureGroup 资源，请使用 featureGroups.patch 方法发送 PATCH 请求。

在使用任何请求数据之前，请先进行以下替换：

  • LOCATION_ID：特征组所在的区域，例如 us-central1。
  • PROJECT_ID：您的项目 ID。
  • FEATURE_GROUP_NAME：您要更新的特征组的名称。
  • ENTITY_ID_COLUMNS：包含实体 ID 的列名称。您可以指定一列或多列。
    • 如需仅指定一个实体 ID 列，请按以下格式指定列名称：
      "entity_id_column_name"。
    • 如需指定多个实体 ID 列，请按以下格式指定列名称：
      ["entity_id_column_1_name", "entity_id_column_2_name", ...]。
  • BIGQUERY_SOURCE_URI：您要与特征组关联的 BigQuery 源表或视图的 URI。

HTTP 方法和网址： 

PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME

请求 JSON 正文： 

{
  "big_query": {
    "entity_id_columns": "ENTITY_ID_COLUMNS",
    "big_query_source": {
      "input_uri": "BIGQUERY_SOURCE_URI"
    }
  }
}

如需发送请求，请选择以下方式之一：

curl

将请求正文保存在名为 request.json 的文件中，然后执行以下命令： 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME"

PowerShell

将请求正文保存在名为 request.json 的文件中，然后执行以下命令： 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T03:00:13.060636Z",
      "updateTime": "2023-09-18T03:00:13.060636Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureGroup",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME"
  }
}

后续步骤