Crea un'istanza di negozio online

Per configurare l'erogazione online, devi prima creare un'istanza di negozio online per l'erogazione online di Bigtable o l'erogazione online ottimizzata (ritirata).

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

Dopo aver creato il negozio online, puoi aggiungere viste 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) quando crei l'istanza del tuo negozio online. Solo l'erogazione online Bigtable supporta la crittografia utilizzando una CMEK. Per scoprire di più sui vantaggi dell'utilizzo di una CMEK e per capire se una CMEK è utile per il tuo negozio online, consulta Vantaggi della CMEK.

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

Prima di iniziare

Autenticati in Gemini Enterprise Agent Platform, a meno che tu non l'abbia già fatto.

Seleziona la scheda relativa a come prevedi di utilizzare i campioni in questa pagina:

Console

Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud e alle API, non devi configurare l'autenticazione.

Python

Per utilizzare gli esempi di Python in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Installa Google Cloud CLI.

  2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

    gcloud auth application-default login

    Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

    Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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.

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Crea un negozio online per l'erogazione online tramite Bigtable

Quando utilizzi l'erogazione online di Bigtable, hai la possibilità di criptare lo store online utilizzando una CMEK.

Crea un negozio online per l'erogazione online di Bigtable senza CMEK

Per creare un'istanza di negozio online per l'erogazione online di Bigtable con scalabilità automatica, senza specificare una chiave CMEK, utilizza la console Google Cloud o l'API REST.

Console

Segui queste istruzioni per creare un negozio online per l'erogazione online di Bigtable utilizzando la console Google Cloud .

  1. Nella sezione Piattaforma dell'agente 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 Conteggio minimo di nodi, Conteggio massimo di nodi e Target di utilizzo della CPU in base alle esigenze.

  8. 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: il tuo ID progetto.
  • location: la 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 sostituzioni seguenti:

  • LOCATION_ID: la regione in cui vuoi creare il negozio online, ad esempio us-central1.
  • PROJECT_ID: il tuo 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 di queste 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"
    }
  }
}

Crea un negozio online che utilizzi una chiave CMEK

Segui questi passaggi per creare un'istanza di negozio online per Bigtable online serving criptato 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 Prezzi di Cloud Key Management Service.

  1. Utilizza Cloud Key Management Service per configurare una chiave di crittografia gestita dal cliente.

  2. Per creare una risorsa FeatureOnlineStore, invia la seguente richiesta POST utilizzando il metodo featureOnlineStores.create e specificando CMEK.

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

    • LOCATION_ID: la regione in cui vuoi creare il negozio online, ad esempio us-central1.
    • PROJECT_ID: il tuo 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 questo archivio 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 di queste 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"
    }
  }
}

Crea un negozio online per l'erogazione online ottimizzata

Quando utilizzi l'erogazione online ottimizzata, puoi configurare l'archivio online in modo che eroghi le funzionalità da un endpoint pubblico o da un endpoint Private Service Connect dedicato.

Crea un negozio online per l'erogazione online ottimizzata con un endpoint pubblico

Utilizza i seguenti esempi per creare un negozio online per l'erogazione online ottimizzata con un endpoint pubblico.

Console

Segui queste istruzioni per creare un negozio online per l'erogazione online ottimizzata utilizzando la console Google Cloud .

  1. Nella sezione Piattaforma dell'agente 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.

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_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: il tuo ID progetto.
  • location: la 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, apporta le sostituzioni seguenti:

  • LOCATION_ID: la regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
  • PROJECT_ID: il tuo 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 di queste 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"
    }
  }
}

Crea un negozio online per l'erogazione online ottimizzata con un endpoint Private Service Connect

Utilizza gli esempi seguenti per creare un negozio online per l'erogazione online ottimizzata con Private Service Connect.

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 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: il tuo ID progetto.
  • location: la 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 dei nomi dei progetti 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 sostituzioni seguenti:

  • LOCATION_ID: la regione in cui vuoi creare l'istanza FeatureOnlineStore, ad esempio us-central1.
  • PROJECT_ID: il tuo 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 di queste 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"
    }
  }
}

Passaggi successivi