Featuregruppe aktualisieren

Sie können eine Featuregruppe aktualisieren, um eine BigQuery-Tabelle oder ‐Ansicht als Datenquelle für diese Featuregruppe zu registrieren. Wenn der Featuregruppe bereits eine Datenquelle zugeordnet ist, können Sie eine andere BigQuery-Tabelle oder -Ansicht als Feature-Datenquelle verknüpfen.

Beim Erstellen oder Aktualisieren einer Featuregruppe haben Sie die Möglichkeit, benutzerdefinierte Metadaten in Form von Labels in die Featuregruppe einzufügen. Weitere Informationen zum Aktualisieren benutzerdefinierter Labels für eine Featuregruppe finden Sie unter Labels für eine Featuregruppe aktualisieren.

Verwenden Sie das folgende Beispiel, um eine Featuregruppe zu aktualisieren.

REST

Senden Sie zum Aktualisieren einer FeatureGroup-Ressource die Anfrage PATCH mit der Methode featureGroups.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Die Region, in der sich die Featuregruppe befindet, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.
  • FEATURE_GROUP_NAME: der Name der Featuregruppe, die Sie aktualisieren möchten.
  • ENTITY_ID_COLUMNS: Die Namen der Spalten mit den Entitäts-IDs. Sie können entweder eine oder mehrere Spalten angeben.
    • Wenn Sie nur eine Entitäts-ID-Spalte angeben möchten, geben Sie den Spaltennamen im folgenden Format an:
      "entity_id_column_name"
    • Wenn Sie mehrere Entitäts-ID-Spalten angeben möchten, geben Sie die Spaltennamen im folgenden Format an:
      ["entity_id_column_1_name", "entity_id_column_2_name", ...]
  • BIGQUERY_SOURCE_URI: URI der BigQuery-Quelltabelle oder -ansicht, die Sie mit der Featuregruppe verknüpfen möchten.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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"
  }
}

Nächste Schritte