Questa pagina è stata tradotta dall'API Cloud Translation.

Crea un'istanza di un archivio online

Per configurare la pubblicazione online, devi prima creare un'istanza del negozio online per Distribuzione online tramite Bigtable o pubblicazione online ottimizzata. Per comprendere le differenze tra la distribuzione online tramite Bigtable e la distribuzione online ottimizzata, consulta Tipi di distribuzione online.

Tieni presente che non puoi modificare il tipo di pubblicazione online dopo aver scelto Distribuzione online tramite Bigtable o pubblicazione online ottimizzata durante la creazione nel tuo negozio online. Tuttavia, puoi modificare la configurazione dell'endpoint di pubblicazione 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 tuo negozio online specificando una chiave di crittografia gestita dal cliente (CMEK) durante la creazione dell'istanza. Solo la distribuzione online di Bigtable supporta la crittografia tramite CMEK. Per scoprire di più sui vantaggi dell'utilizzo di un CMEK e per capire se un CMEK è utile per il tuo negozio online, consulta Vantaggi di CMEK.

L'utilizzo di una CMEK può comportare costi di utilizzo aggiuntivi, a seconda del di chiave utilizzata. Per ulteriori informazioni sui prezzi, consulta la pagina relativa ai prezzi di Cloud Key Management Service.

Prima di iniziare

Autentica per Vertex AI, a meno che tu non l'abbia 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 l'interfaccia alla gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
If you're using a local shell, then create local authentication credentials for your user account:
```
gcloud auth application-default login
```
You don't need to do this if you're using Cloud Shell.

Per ulteriori informazioni, consulta Set up authentication for a local development environment.

REST

Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Creare un negozio online per la distribuzione online tramite Bigtable

Quando utilizzi la distribuzione online di Bigtable, hai la possibilità di criptare il negozio online utilizzando un CMEK.

Crea un archivio online per la distribuzione online tramite Bigtable senza CMEK

Per creare un'istanza del negozio online per la pubblicazione online di Bigtable con il ridimensionamento automatico, senza specificare un 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.

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 Numero minimo di nodi, Numero massimo di nodi e Target di utilizzo della CPU, in base alle esigenze.
Fai clic su Crea.

Python

Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, consulta Installare l'SDK Vertex AI per Python. Per saperne di più, consulta la documentazione di riferimento dell'API Python.


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_bigtable_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_bigtable_store(
        feature_online_store_id
    )
    return fos

project: l'ID del tuo progetto.
location: regione in cui si trova il negozio online, ad esempio us-central1.
feature_online_store_id: il nome della nuova istanza FeatureOnlineStore.

REST

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

Prima di utilizzare i dati della richiesta, apporta 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 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

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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 del negozio online per Distribuzione online tramite Bigtable, criptata con una CMEK.

L'utilizzo di una crittografia CMEK può comportare costi di utilizzo aggiuntivi, a seconda del tipo di chiave utilizzata. Per ulteriori informazioni sui prezzi, consulta la pagina relativa ai prezzi di Cloud Key Management Service.

Utilizza Cloud Key Management Service per configurare una crittografia gestita dal cliente chiave.
Per creare una risorsa FeatureOnlineStore , invia la seguente richiesta POST utilizzando il metodo featureOnlineStores.create e specificando la CMEK.

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 supporti la gestione dell'inserimento, 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

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
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

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$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"
    }
  }
}
```

Creare un negozio online per la distribuzione online ottimizzata

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

Creare un negozio online per la distribuzione 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.

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 saperne di più, consulta la documentazione di riferimento dell'API Python.


from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_public_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        feature_online_store_id
    )
    return fos

project: l'ID del tuo progetto.
location: regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
feature_online_store_id: il nome della nuova istanza FeatureOnlineStore.

REST

Per creare un'istanza di 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 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, quindi esegui il comando seguente:

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, quindi esegui il comando seguente:

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

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

Utilizza i seguenti esempi 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 saperne di più, consulta la documentazione di riferimento dell'API Python.


from typing import List

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_private_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
    project_allowlist: List[str],
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        name=feature_online_store_id,
        enable_private_service_connect=True,
        project_allowlist=project_allowlist,
    )
    return fos

project: l'ID del tuo progetto.
location: regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
feature_online_store_id: il nome della nuova istanza FeatureOnlineStore.
project_allowlist: l'elenco di nomi di progetto da inserire nella lista consentita per Private Service Connect (PSC).

REST

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

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

LOCATION_ID: regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
PROJECT_ID: l'ID progetto.
FEATUREONLINESTORE_NAME: il nome della nuova istanza FeatureOnlineStore.
PROJECT_NAMES: l'elenco dei nomi dei progetti 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

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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 elemento.
Scopri come aggiornare un negozio online.