Per configurare la distribuzione online, devi prima creare un'istanza del negozio online per la pubblicazione online di Bigtable o la pubblicazione online ottimizzata. Per comprendere le differenze tra la distribuzione online tramite Bigtable e la pubblicazione online ottimizzata, consulta Tipi di distribuzione online.
Tieni presente che non puoi modificare il tipo di distribuzione online dopo aver scelto Pubblicazione online di Bigtable o Distribuzione online ottimizzata durante la creazione del tuo 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 visualizzazioni delle caratteristiche e associarle alle origini dati delle caratteristiche in BigQuery.
Puoi criptare l'istanza del negozio online specificando una chiave di crittografia gestita dal cliente (CMEK) durante la creazione dell'istanza del negozio online. Solo la distribuzione online di Bigtable supporta la crittografia tramite CMEK. Per scoprire di più sui vantaggi dell'utilizzo di una CMEK e se quest'ultima è utile per il tuo negozio online, consulta Vantaggi di CMEK.
L'utilizzo di una CMEK può comportare costi di utilizzo aggiuntivi, a seconda del tipo di chiave utilizzato. Per ulteriori informazioni sui prezzi, consulta Prezzi di Cloud Key Management Service.
Prima di iniziare
Autentica in Vertex AI, se non l'hai già fatto.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
Python
Per utilizzare gli Python esempi in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
Per maggiori informazioni, consulta Set up authentication for a local development environment.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Crea un archivio online per la distribuzione online tramite Bigtable
Quando utilizzi la distribuzione online di Bigtable, hai la possibilità di criptare il datastore online utilizzando una CMEK.
Crea un archivio online per la distribuzione online tramite Bigtable senza CMEK
Per creare un'istanza di un archivio online per la distribuzione online di Bigtable con scalabilità automatica, senza specificare una CMEK, utilizza la console Google Cloud o l'API REST.
Console
Segui le istruzioni riportate di seguito per creare un archivio online per la pubblicazione online tramite Bigtable utilizzando la console Google Cloud.
Nella sezione Vertex AI della console Google Cloud, vai alla pagina Feature Store.
Fai clic su Negozio online per andare alla sezione Negozio online.
Fai clic su Crea per aprire la pagina Crea negozio online.
Specifica un nome per il negozio online.
(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.
Nel campo Scegli una soluzione di archiviazione per il tuo negozio online, fai clic su Bigtable.
Modifica i valori Numero minimo di nodi, Conteggio massimo di nodi e Target di utilizzo CPU, in base alle necessità.
Fai clic su Crea.
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, vedi Installare l'SDK Vertex AI per Python. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python.
project
: l'ID progetto.location
: regione in cui si trova il negozio online, ad esempious-central1
.feature_online_store_id
: il nome della nuova istanzaFeatureOnlineStore
.
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: regione in cui vuoi creare il negozio online, ad esempio
us-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome della nuova istanza del negozio online.
- BOOLEAN: (facoltativo) per creare un negozio online che supporti la gestione dell'incorporamento,
inserisci
true
. Il valore predefinito èfalse
.
Metodo HTTP e URL:
POST https://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 } } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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 \
"https://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 "https://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 che utilizza una CMEK
Segui questi passaggi per creare un'istanza di un archivio online per la pubblicazione online di Bigtable con crittografia CMEK.
L'utilizzo di una crittografia CMEK può comportare costi di utilizzo aggiuntivi, a seconda del tipo di chiave utilizzato. Per ulteriori informazioni sui prezzi, consulta Prezzi di Cloud Key Management Service.
Per creare una risorsa
FeatureOnlineStore
, invia la richiestaPOST
seguente utilizzando il metodo featureOnlineStores.create e specificando CMEK.Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION_ID: regione in cui vuoi creare il negozio online, ad esempio
us-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome della nuova istanza del negozio online.
- BOOLEAN: (facoltativo) per creare un negozio online che supporti la gestione dell'incorporamento,
inserisci
true
. Il valore predefinito èfalse
. - KEY_NAME: il nome della chiave di crittografia che vuoi utilizzare per l'archivio di metadati.
Metodo HTTP e URL:
POST https://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 } }, "encryption_spec": { "kms_key_name": "KEY_NAME" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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 \
"https://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 "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand ContentDovresti 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" } } }
- LOCATION_ID: regione in cui vuoi creare il negozio online, ad esempio
Crea un negozio online per la pubblicazione online ottimizzata
Quando utilizzi la pubblicazione online ottimizzata, puoi configurare il negozio online in modo che gestisca le caratteristiche da un endpoint pubblico o da un endpoint Private Service Connect dedicato. Utilizza un endpoint Private Service Connect se vuoi gestire le caratteristiche 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 riportati di seguito per creare un negozio online per la pubblicazione online ottimizzata con un endpoint pubblico.
Console
Segui le istruzioni riportate di seguito per creare un negozio online per la pubblicazione online ottimizzata utilizzando la console Google Cloud.
Nella sezione Vertex AI della console Google Cloud, vai alla pagina Feature Store.
Fai clic su Negozio online per andare alla sezione Negozio online.
Fai clic su Crea per aprire la pagina Crea negozio online.
Specifica un nome per il negozio online.
(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.
Nel campo Scegli una soluzione di archiviazione per il tuo negozio online, fai clic su Ottimizzata.
Fai clic su Crea.
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, vedi Installare l'SDK Vertex AI per Python. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python.
project
: l'ID progetto.location
: regione in cui vuoi creare l'istanzaFeatureOnlineStore
, ad esempious-central1
.feature_online_store_id
: il nome della nuova istanzaFeatureOnlineStore
.
REST
Per creare un'istanza di un 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 esempious-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome della nuova istanza
FeatureOnlineStore
.
Metodo HTTP e URL:
POST https://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:
curl
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 \
"https://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 "https://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 archivio online per la pubblicazione online ottimizzata con un endpoint Private Service Connect
Utilizza gli esempi riportati di seguito per creare un negozio online per la pubblicazione online ottimizzata con Private Service Connect.
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, vedi Installare l'SDK Vertex AI per Python. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python.
project
: l'ID progetto.location
: regione in cui vuoi creare l'istanzaFeatureOnlineStore
, ad esempious-central1
.feature_online_store_id
: il nome della nuova istanzaFeatureOnlineStore
.project_allowlist
: l'elenco di nomi di progetto da inserire nella lista consentita per Private Service Connect (PSC).
REST
Per creare un'istanza di un 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 esempious-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome della nuova istanza
FeatureOnlineStore
. - PROJECT_NAMES: l'elenco di nomi di progetto da inserire nella lista consentita per Private Service Connect (PSC).
Metodo HTTP e URL:
POST https://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_NAMES"] } } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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 \
"https://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 "https://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
Scopri come creare una visualizzazione delle caratteristiche.
Scopri come aggiornare un negozio online.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-07-12 UTC.