Featureansicht-Instanz erstellen

Sie können eine Funktionsansicht in einer vorhandenen Onlinespeicherinstanz erstellen. Beim Erstellen einer Featureansicht können Sie die Features so verknüpfen:

  • Featuregruppen und Features aus Feature Registry hinzufügen: Verknüpfen Sie vorhandene Featuregruppen und Features aus der Feature Registry. Eine Funktionsgruppe gibt den Speicherort der BigQuery-Datenquelle an. Ein Feature innerhalb der Featuregruppe verweist auf eine bestimmte Featurespalte innerhalb dieser Datenquelle. Sie können eine Featureansicht mit mehreren Featuregruppen verknüpfen.

  • Features aus einer BigQuery-Quelle hinzufügen: Ordnen Sie eine BigQuery-Datenquelle direkt zu, z. B. eine BigQuery-Tabelle oder -Ansicht, und geben Sie die Spalte für die Entitäts-ID an.

Nachdem Sie eine Featureansicht erstellt haben, synchronisiert der Vertex AI Feature Store die neuesten Featurewerte aus der BigQuery-Datenquelle. Wenn Sie den Abfrageparameter run_sync_immediately=true festlegen, synchronisiert Vertex AI Feature Store die Featurewerte beim Erstellen der Featureansicht. Andernfalls synchronisiert Vertex AI Feature Store die Featurewerte gemäß dem für die Featureansicht angegebenen Synchronisierungsplan.

Featuredaten in einer Featureansicht synchronisieren

Vertex AI Feature Store aktualisiert die im Onlinespeicher von BigQuery gespeicherten Featurewerte regelmäßig oder wird synchronisiert. Wenn Sie eine Featureansicht erstellen, können Sie den Zeitplan oder die Häufigkeit für die Datensynchronisierung mit dem Parameter FeatureView.sync_config angeben.

Sie können auch manuell eine Datensynchronisierung für eine Funktionsansicht auslösen. Weitere Informationen zum manuellen Synchronisieren von Daten für eine Featureansicht finden Sie unter Featuredaten mit dem Onlinespeicher synchronisieren.

Beachten Sie, dass für eine Featureansicht jeweils nur ein Datensynchronisierungsvorgang aktiv sein kann. Wenn für eine Featureansicht eine Datensynchronisierung ausgeführt wird, werden alle geplanten Datensynchronisierungen für diese Featureansicht übersprungen, bis die Synchronisierung abgeschlossen ist.

Kosten während der Synchronisierung optimieren

Ein Datensynchronisierungsvorgang kann Kosten für die BigQuery-Ressourcennutzung verursachen. Befolgen Sie diese Richtlinien, um diese Kosten zu optimieren und die Leistung während einer Datensynchronisierung zu verbessern:

  • Konfigurieren Sie den Synchronisierungsplan nicht so, dass er häufiger als die Häufigkeit ausgeführt wird, mit der sich die Daten in der BigQuery-Quelle ändern sollen.

  • Optimieren Sie die Größe der Feature-Datenquelle in BigQuery. Geben Sie beim Erstellen der Featureansicht nur die Daten an, die Sie für die Onlinebereitstellung benötigen.

  • Vermeiden Sie die Ausführung komplexer Aggregationen in BigQuery. Führen Sie für die Tabelle oder Ansicht eine SELECT *-Abfrage aus, um das Volumen und die Dauer der Datenverarbeitung zu schätzen.

  • Wenn Sie die Skalierungsoptionen für den Onlinespeicher festlegen, setzen Sie max_node_count auf einen Wert, der hoch genug ist, um hohe Lasten während einer Datensynchronisierung abzudecken.

  • Planen Sie die Synchronisierung für verschiedene Featureansichten zu verschiedenen Zeiten im selben Onlinespeicher.

  • Wenn Ihre BigQuery-Tabelle umfangreiche Verlaufsdaten enthält, sollten Sie die Tabelle mit Zeitstempeln partitionieren und einen Zeitraum für den Abruf der Featuredaten angeben. Dadurch wird das Abrufen veralteter Featuredaten während der Synchronisierung minimiert.

  • Die Bigtable-Auslastung steigt während der Datensynchronisierung. Für Featureansichten, die in Onlinespeichern für die Onlinebereitstellung von Bigtable erstellt wurden, planen Sie Synchronisierungsjobs außerhalb der Spitzenzeiten, um eine optimale Leistung zu erzielen.

Dienstkonto für eine Featureansicht konfigurieren

Jede Featureansicht verwendet ein Dienstkonto, um während der Synchronisierung auf die Quelldaten in BigQuery zuzugreifen. Vertex AI Feature Store weist diesem Dienstkonto die IAM-Rolle BigQuery-Datenbetrachter zu.

Standardmäßig verwendet eine Featureansicht das für Ihr Projekt konfigurierte Dienstkonto. Bei dieser Konfiguration kann jeder Nutzer mit der Berechtigung zum Erstellen einer Featureansicht in Ihrem Projekt auf die Featuredaten in BigQuery zugreifen.

Alternativ können Sie die Featureansicht so konfigurieren, dass ein eigenes Dienstkonto verwendet wird. Vertex AI Feature Store richtet dann ein dediziertes Dienstkonto für die Featureansicht ein. Mit dieser Konfiguration können Sie den Zugriff auf Featuredaten in BigQuery einschränken oder weiteren Nutzern Zugriff gewähren. Sie können die Dienstkontokonfiguration mit dem Parameter FeatureView.service_agent_type angeben.

Vektorabruf für eine Featureansicht konfigurieren

Sie können den Vektorabruf für eine Featureansicht konfigurieren, die basierend auf einer erstellt wurde, wenn die zugehörige Datenquelle die Spalte embedding enthält und der Onlinespeicher für die Einbettungsverwaltung konfiguriert ist. Sie können die Konfiguration des Vektorabrufs mit dem Parameter FeatureView.vector_search_config angeben.

Beachten Sie, dass Sie den Vektorabruf und die Verwaltung von Einbettungen nur konfigurieren können, wenn die Funktionsansicht durch Angabe eines BigQuery-Quell-URI und nicht aus Featuregruppen und Features aus Feature Registry erstellt wird.

Informationen zur Einrichtung der BigQuery-Datenquelle für die Unterstützung von Einbettungen mithilfe der Spalte embedding finden Sie unter Richtlinien für die Vorbereitung von Datenquellen.

Eine Featureansicht aus Featuregruppen erstellen

Sie können eine Featureansicht basierend auf Featuredaten erstellen, die mithilfe von Featuregruppen und Features registriert wurden. Sie können mehrere Featuregruppen angeben, um mehrere BigQuery-Datenquellen mit derselben Featureansicht zu verknüpfen.

Wenn Sie eine Featureansicht durch Angabe von Featuregruppen und Features erstellen, gilt Folgendes:

  • Die Datenquelle muss eine Spalte feature_timestamp enthalten und eventuell Verlaufsdaten enthalten.

  • Vertex AI Feature Store stellt nur die neuesten Featurewerte basierend auf dem Featurezeitstempel bereit.

  • Sie können die Einbettungsverwaltung für die Featureansicht nicht konfigurieren.

Eine Featureansicht mit der Standarddienstkontokonfiguration erstellen

Verwenden Sie das folgende Beispiel, um eine Featureansicht zu erstellen. Verknüpfen Sie dazu mehrere Featuregruppen, ohne eine Dienstkontokonfiguration anzugeben.

REST

Senden Sie zum Erstellen einer FeatureView-Ressource eine POST-Anfrage mit der Methode featureViews.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Region, in der Sie die Featureansicht erstellen möchten, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.
  • FEATUREONLINESTORE_NAME: Der Name der Online-Speicherinstanz, in der Sie die Featureansicht erstellen möchten.
  • FEATUREVIEW_NAME: Der Name der neuen Featureansichtsinstanz, die Sie erstellen möchten.
  • FEATUREGROUP_NAME_A und FEATUREGROUP_NAME_B: Die Namen der Featuregruppen, aus denen Sie der Featureansicht Features hinzufügen möchten.
  • FEATURE_ID_A1 und FEATURE_ID_A2: Feature-IDs aus der Featuregruppe FEATUREGROUP_NAME_A, die Sie der Featureansicht hinzufügen möchten.
  • FEATURE_ID_B1 und FEATURE_ID_B2: Feature-IDs aus der Featuregruppe FEATUREGROUP_NAME_B, die Sie der Featureansicht hinzufügen möchten.
  • CRON: Cron-Zeitplanausdruck, der die Häufigkeit für die Synchronisierung von Daten mit der Featureansicht darstellt. Weitere Informationen finden Sie unter Cron.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "feature_registry_source": {
    "feature_groups": [
      {
        "feature_group_id": "FEATUREGROUP_NAME_A",
        "feature_ids": [ "FEATURE_ID_A1", "FEATURE_ID_A2" ]
      },
      {
        "feature_group_id": "FEATUREGROUP_NAME_B",
        "feature_ids": [ "FEATURE_ID_B1", "FEATURE_ID_B2" ]
      }
    ]
  },
  "sync_config": {
    "cron": "CRON"
  }
}

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 POST \
     -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_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 POST `
    -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T02:11:29.458820Z",
      "updateTime": "2023-09-15T02:11:29.458820Z"
    }
  }
}

Eine Featureansicht durch Angabe einer Dienstkontokonfiguration erstellen

Im folgenden Beispiel wird eine Featureansicht aus Featuregruppen erstellt, indem eine Dienstkontokonfiguration angegeben wird.

REST

Senden Sie zum Erstellen einer FeatureView-Ressource eine POST-Anfrage mit der Methode featureViews.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Region, in der Sie die Featureansicht erstellen möchten, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.
  • FEATUREONLINESTORE_NAME: Der Name der Online-Speicherinstanz, in der Sie die Featureansicht erstellen möchten.
  • FEATUREVIEW_NAME: Der Name der neuen Featureansichtsinstanz, die Sie erstellen möchten.
  • FEATUREGROUP_NAME_A und FEATUREGROUP_NAME_B: Die Namen der Featuregruppen, aus denen Sie der Featureansicht Features hinzufügen möchten.
  • FEATURE_ID_A1 und FEATURE_ID_A2: Feature-IDs aus der Featuregruppe FEATUREGROUP_NAME_A, die Sie der Featureansicht hinzufügen möchten.
  • FEATURE_ID_B1 und FEATURE_ID_B2: Feature-IDs aus der Featuregruppe FEATUREGROUP_NAME_B, die Sie der Featureansicht hinzufügen möchten.
  • CRON: Cron-Zeitplanausdruck, der die Häufigkeit für die Synchronisierung von Daten mit der Featureansicht darstellt. Weitere Informationen finden Sie unter Cron.
  • SERVICE_AGENT_TYPE: (_Optional_) Dienstkontokonfiguration für die Featureansicht. Zu den unterstützten Dienst-Agent-Typen gehören folgende:
    • SERVICE_AGENT_TYPE_PROJECT: Verwenden Sie das Dienstkonto auf Projektebene für die Featureansicht. Dies ist die Standardkonfiguration.
    • SERVICE_AGENT_TYPE_FEATURE_VIEW: Richten Sie ein dediziertes Dienstkonto für die Featureansicht ein und verwenden Sie es.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "feature_registry_source": {
    "feature_groups": [
      {
        "feature_group_id": "FEATUREGROUP_NAME_A",
        "feature_ids": [ "FEATURE_ID_A1", "FEATURE_ID_A2" ]
      },
      {
        "feature_group_id": "FEATUREGROUP_NAME_B",
        "feature_ids": [ "FEATURE_ID_B1", "FEATURE_ID_B2" ]
      }
    ]
  },
  "sync_config": {
    "cron": "CRON"
  },
  "service_agent_type": "SERVICE_AGENT_TYPE"
}

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 POST \
     -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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.CreateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T02:11:29.458820Z",
      "updateTime": "2023-09-15T02:11:29.458820Z"
    }
  }
}

Eine Featureansicht aus einer BigQuery-Quelle erstellen

Wenn Sie Features online bereitstellen möchten, ohne Ihre BigQuery-Datenquelle mithilfe von Featuregruppen und Features zu registrieren, können Sie eine Featureansicht erstellen. Geben Sie dazu den URI der BigQuery-Datenquelle an.

Wenn Sie eine Featureansicht durch Angabe der Datenquelle erstellen:

  • Sie können keine feature_timestamp-Spalte in die BigQuery-Tabelle oder -Ansicht aufnehmen.

  • Sie können keine bisherigen Featurewerte in die Datenquelle aufnehmen. Jede Zeile muss eine eindeutige Entitäts-ID enthalten.

Eine Featureansicht mit der Standarddienstkontokonfiguration erstellen

Im folgenden Beispiel wird eine Featureansicht mit Einbettungsunterstützung erstellt. Dazu wird eine BigQuery-Datenquelle direkt verknüpft und keine Dienstkontokonfiguration angegeben.

REST

Senden Sie zum Erstellen einer FeatureView-Ressource eine POST-Anfrage mit der Methode featureViews.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Region, in der Sie die Featureansicht erstellen möchten, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.
  • FEATUREONLINESTORE_NAME: Der Name der Online-Speicherinstanz, in der Sie die Featureansicht erstellen möchten.
  • FEATUREVIEW_NAME: Der Name der neuen Featureansicht, die Sie erstellen möchten.
  • PROJECT_NAME: der Name Ihres Projekts
  • DATASET_NAME ist der Name Ihres BigQuery-Datasets.
  • TABLE_NAME: Der Name der Tabelle aus Ihrem BigQuery-Dataset.
  • ENTITY_ID_COLUMN: Der Name der Spalte, die die Entitäts-IDs enthält.
  • CRON: Cron-Zeitplanausdruck, der die Häufigkeit für die Synchronisierung von Daten mit der Featureansicht darstellt. Weitere Informationen finden Sie unter Cron.
  • EMBEDDING_COLUMN: Der Name der Spalte, die die Quelldaten enthält, um den Index für die Vektorsuche zu erstellen. Das ist nur erforderlich, wenn Sie Einbettungen mit der Funktionsansicht verwalten möchten.
  • FILTER_COLUMN_1 und FILTER_COLUMN_2: Optional: Die Namen der Spalten, nach denen die Vektorsuchergebnisse gefiltert werden.
  • CROWDING_COLUMN: Optional: Der Name der Spalte mit den Crowding-Attributen.
  • EMBEDDING_DIMENSION: Optional: Die Größe einer Einbettung, angegeben in der Anzahl der Dimensionen in der Einbettungsspalte.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "big_query_source": {
    "uri": "bq://PROJECT_NAME.DATASET_NAME.TABLE_NAME",
    "entity_id_columns": "ENTITY_ID_COLUMN"
  },
  "sync_config": {
    "cron": "CRON"
  },
  "vector_search_config": {
    "embedding_column": "EMBEDDING_COLUMN",
    "filter_columns": ["FILTER_COLUMN_1", "FILTER_COLUMN_2"],
    "crowding_column": "CROWDING_COLUMN",
    "embedding_dimension": EMBEDDING_DIMENSION
    "tree_ah_config": {}
  }
}

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 POST \
     -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_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 POST `
    -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T02:11:29.458820Z",
      "updateTime": "2023-09-15T02:11:29.458820Z"
    }
  }
}

Eine Featureansicht mit Einbettungsverwaltung erstellen, indem Sie eine Dienstkontokonfiguration angeben

Im folgenden Beispiel wird eine Featureansicht mit Einbettungsunterstützung erstellt. Dazu wird eine BigQuery-Datenquelle direkt verknüpft und eine Dienstkontokonfiguration angegeben.

REST

Senden Sie zum Erstellen einer FeatureView-Ressource mit Unterstützung für Einbettungen eine POST-Anfrage mit der Methode featureViews.create und geben Sie die Vektorsuchkonfiguration an.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Region, in der Sie die Featureansicht erstellen möchten, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.
  • FEATUREONLINESTORE_NAME: Der Name der Online-Speicherinstanz, in der Sie die Featureansicht erstellen möchten.
  • FEATUREVIEW_NAME: Der Name der neuen Featureansicht, die Sie erstellen möchten.
  • PROJECT_NAME: der Name Ihres Projekts
  • DATASET_NAME ist der Name Ihres BigQuery-Datasets.
  • TABLE_NAME: Der Name der Tabelle aus Ihrem BigQuery-Dataset.
  • ENTITY_ID_COLUMNS: Die Namen der Spalten, die die Entitäts-IDs enthalten. Sie können eine oder mehrere Spalten angeben.
    • Wenn Sie nur eine Spalte für die Entitäts-ID 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", ...].
  • CRON: Cron-Zeitplanausdruck, der die Häufigkeit für die Synchronisierung von Daten mit der Featureansicht darstellt. Weitere Informationen finden Sie unter Cron.
  • SERVICE_AGENT_TYPE: Dienstkontokonfiguration für die Featureansicht. Zu den unterstützten Dienst-Agent-Typen gehören folgende:
    • SERVICE_AGENT_TYPE_PROJECT: Verwenden Sie das Dienstkonto auf Projektebene für die Featureansicht. Dies ist die Standardkonfiguration.
    • SERVICE_AGENT_TYPE_FEATURE_VIEW: Richten Sie ein dediziertes Dienstkonto für die Featureansicht ein und verwenden Sie es.
  • EMBEDDING_COLUMN: Der Name der Spalte, die die Quelldaten enthält, um den Index für die Vektorsuche zu erstellen. Das ist nur erforderlich, wenn Sie Einbettungen mit der Funktionsansicht verwalten möchten.
  • FILTER_COLUMN_1 und FILTER_COLUMN_2: Optional: Die Namen der Spalten, nach denen die Vektorsuchergebnisse gefiltert werden.
  • CROWDING_COLUMN: Optional: Der Name der Spalte mit den Crowding-Attributen.
  • EMBEDDING_DIMENSION: Optional: Die Größe einer Einbettung, angegeben in der Anzahl der Dimensionen in der Einbettungsspalte.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "big_query_source": {
    "uri": "bq://PROJECT_NAME.DATASET_NAME.TABLE_NAME",
    "entity_id_columns": "ENTITY_ID_COLUMNS"
  },
  "sync_config": {
    "cron": "CRON"
  },
  "service_agent_type": "SERVICE_AGENT_TYPE",
  "vector_search_config": {
    "embedding_column": "EMBEDDING_COLUMN",
    "filter_columns": ["FILTER_COLUMN_1", "FILTER_COLUMN_2"],
    "crowding_column": "CROWDING_COLUMN",
    "embedding_dimension": EMBEDDING_DIMENSION
    "tree_ah_config": {}
  }
}

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 POST \
     -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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews?feature_view_id=FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.CreateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T02:11:29.458820Z",
      "updateTime": "2023-09-15T02:11:29.458820Z"
    }
  }
}

Nächste Schritte