Crea un'istanza del negozio online

Per configurare la pubblicazione online, devi prima creare un'istanza del negozio online per la pubblicazione online di Bigtable o la pubblicazione online ottimizzata.

Tieni presente che non puoi modificare il tipo di pubblicazione online dopo aver scelto la pubblicazione online di Bigtable o la pubblicazione online ottimizzata durante la creazione del negozio online. Tuttavia, puoi modificare la configurazione dell'endpoint di gestione per un'istanza del negozio online creata per la pubblicazione online ottimizzata.

Dopo aver creato il negozio online, puoi aggiungere viste delle caratteristiche e associarle alle origini dati delle caratteristiche in BigQuery.

Configurare la gestione dell'incorporamento per un negozio online

Vertex AI Feature Store consente di eseguire ricerche di somiglianze vettoriali utilizzando gli incorporamenti in una visualizzazione caratteristiche in un negozio online. Per eseguire una ricerca di somiglianza vettoriale, devi configurare l'istanza del negozio online in modo da supportare la gestione dell'incorporamento utilizzando il parametro FeatureOnlineStore.embedding_management, quindi configurare il recupero del vettore per almeno una vista delle caratteristiche all'interno del negozio online.

Per ulteriori informazioni su come cercare i vicini più prossimi approssimati utilizzando gli incorporamenti in Vertex AI Feature Store, consulta Eseguire ricerche con gli incorporamenti.

Crea un negozio online per la pubblicazione online di Bigtable

Utilizza gli esempi seguenti per creare un'istanza del negozio online per la pubblicazione online di Bigtable con scalabilità automatica.

Console

Segui le istruzioni riportate di seguito per creare un negozio online per la pubblicazione online di Bigtable utilizzando la console Google Cloud.

  1. Nella sezione Vertex AI della console Google Cloud, vai alla pagina Feature Store.

    Vai alla pagina Feature Store

  2. Fai clic su Negozio online per andare alla sezione Negozio online.

  3. Fai clic su Crea per aprire la pagina Crea negozio online.

  4. Specifica un nome per il negozio online.

  5. (Facoltativo) Per aggiungere etichette, fai clic su Aggiungi etichetta e specifica il nome e il valore dell'etichetta. Puoi aggiungere più etichette a un negozio online.

  6. Nel campo Scegli una soluzione di archiviazione per il tuo negozio online, fai clic su Bigtable.

  7. Modifica i valori Numero minimo di nodi, Numero massimo di nodi e Target di utilizzo CPU, in base alle necessità.

  8. Fai clic su Crea.

REST

Per creare una risorsa FeatureOnlineStore, invia una richiesta POST utilizzando il metodo featureOnlineStores.create.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • LOCATION_ID: la regione in cui vuoi creare il negozio online, ad esempio us-central1.
  • PROJECT_ID: l'ID del tuo progetto.
  • FEATUREONLINESTORE_NAME: il nome della nuova istanza del negozio online.
  • BOOLEAN: (facoltativo) per creare un negozio online che supporta la gestione dell'incorporamento, inserisci true. Il valore predefinito è false.

Metodo HTTP e URL: 

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON della richiesta: 

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
  "embedding_management": {
    "enabled": BOOLEAN
  }
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

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

PowerShell

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

$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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Creare un negozio online per la pubblicazione online ottimizzata

Quando utilizzi la pubblicazione online ottimizzata, puoi configurare l'archivio online per gestire le funzionalità da un endpoint pubblico o da un endpoint Private Service Connect dedicato. Utilizza un endpoint Private Service Connect se vuoi gestire funzionalità all'interno di una rete VPC con latenze inferiori rispetto a un endpoint pubblico.

Crea un negozio online per la pubblicazione online ottimizzata con un endpoint pubblico

Utilizza gli esempi seguenti per creare un negozio online per la pubblicazione online ottimizzata con un endpoint pubblico.

UI web

Segui le istruzioni riportate di seguito per creare un negozio online per la pubblicazione online ottimizzata utilizzando la console Google Cloud.

  1. Nella sezione Vertex AI della console Google Cloud, vai alla pagina Feature Store.

    Vai alla pagina Feature Store

  2. Fai clic su Negozio online per andare alla sezione Negozio online.

  3. Fai clic su Crea per aprire la pagina Crea negozio online.

  4. Specifica un nome per il negozio online.

  5. (Facoltativo) Per aggiungere etichette, fai clic su Aggiungi etichetta e specifica il nome e il valore dell'etichetta. Puoi aggiungere più etichette a un negozio online.

  6. Nel campo Scegli una soluzione di archiviazione per il tuo negozio online, fai clic su Ottimizzata.

  7. Fai clic su Crea.

REST

Per creare un'istanza del negozio online, invia una richiesta POST utilizzando il metodo featureOnlineStores.create.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • LOCATION_ID: regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
  • PROJECT_ID: l'ID del tuo progetto.
  • FEATUREONLINESTORE_NAME: il nome della nuova istanza FeatureOnlineStore.

Metodo HTTP e URL: 

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON della richiesta: 

{
  "optimized": {}
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

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

PowerShell

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

$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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Crea un negozio online per la pubblicazione online ottimizzata con un endpoint Private Service Connect

Utilizza l'esempio seguente per creare un negozio online per la pubblicazione online ottimizzata con Private Service Connect.

REST

Per creare un'istanza del negozio online, invia una richiesta POST utilizzando il metodo featureOnlineStores.create.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • LOCATION_ID: regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
  • PROJECT_ID: l'ID del tuo progetto.
  • FEATUREONLINESTORE_NAME: il nome della nuova istanza FeatureOnlineStore.

Metodo HTTP e URL: 

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON della richiesta: 

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAME"]
    }
  }
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

arricciatura

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

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

PowerShell

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando: 

$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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Passaggi successivi