Gestione dei tipi di entità

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Scopri come creare, elencare ed eliminare tipi di entità.

Crea un tipo di entità

Crea un tipo di entità in modo da poter creare le sue funzionalità correlate.

UI web

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Dalla barra delle azioni, fai clic su Crea tipo di entità per aprire il riquadro Crea tipo di entità.
  3. Seleziona una regione dall'elenco a discesa Area geografica che include l'archivio di caratteristiche in cui vuoi creare un tipo di entità.
  4. Seleziona un archivio di caratteristiche.
  5. Specifica un nome per il tipo di entità.
  6. Se vuoi includere una descrizione per il tipo di entità, inserisci una descrizione.
  7. Per abilitare il monitoraggio del valore delle funzionalità (Anteprima), imposta il monitoraggio su Abilitato e specifica l'intervallo di snapshot in giorni. Questa configurazione di monitoraggio si applica a tutte le funzionalità in questo tipo di entità. Per maggiori informazioni, consulta la pagina Monitoraggio dei valori delle funzionalità.
  8. Fai clic su Create (Crea).

REST

Per creare un tipo di entità, invia una richiesta POST utilizzando il metodo featurestores.entityTypes.create.

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

  • LOCATION: regione in cui si trova l'archivio di caratteristiche, ad esempio us-central1.
  • PROJECT: ID del progetto.
  • FEATURESTORE_ID: ID dell'archivio di caratteristiche.
  • ENTITY_TYPE_ID: ID del tipo di entità.
  • DESCRIPTION: descrizione del tipo di entità.

Metodo HTTP e URL: 

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID

Corpo JSON richiesta: 

{
  "description": "DESCRIPTION"
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

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-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID"

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-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes?entityTypeId=ENTITY_TYPE_ID" | Select-Object -Expand Content

Dovresti visualizzare un output simile al seguente. Puoi utilizzare OPERATION_ID nella risposta per ottenere lo stato dell'operazione.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/bikes/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateEntityTypeOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-03-02T00:04:13.039166Z",
      "updateTime": "2021-03-02T00:04:13.039166Z"
    }
  }
}

Python

Per scoprire come installare e utilizzare la libreria client per Vertex AI, consulta la pagina relativa alle librerie client di Vertex AI. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python Vertex AI. 

from google.cloud import aiplatform

def create_entity_type_sample(
    project: str,
    location: str,
    entity_type_id: str,
    featurestore_name: str,
):

    aiplatform.init(project=project, location=location)

    my_entity_type = aiplatform.EntityType.create(
        entity_type_id=entity_type_id, featurestore_name=featurestore_name
    )

    my_entity_type.wait()

    return my_entity_type

Linguaggi aggiuntivi

Puoi installare e utilizzare le seguenti librerie client di Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.

Elenco tipi di entità

Elencare tutti i tipi di entità in un featurestore.

UI web

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Seleziona un'area geografica dall'elenco a discesa Area geografica.
  3. Nella tabella delle funzionalità, visualizza la colonna Tipo di entità per vedere i tipi di entità nel tuo progetto per la regione selezionata.

REST

Per elencare i tipi di entità, invia una richiesta GET utilizzando il metodo featurestores.entityTypes.list.

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

  • LOCATION: regione in cui si trova l'archivio di caratteristiche, ad esempio us-central1.
  • PROJECT: ID del progetto.
  • FEATURESTORE_ID: ID dell'archivio di caratteristiche.

Metodo HTTP e URL: 

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

Esegui questo comando: 

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes"

PowerShell

Esegui questo comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "entityTypes": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID_1",
      "description": "ENTITY_TYPE_DESCRIPTION",
      "createTime": "2021-02-25T01:20:43.082628Z",
      "updateTime": "2021-02-25T01:20:43.082628Z",
      "etag": "AMEw9yOBqKIdbBGZcxdKLrlZJAf9eTO2DEzcE81YDKA2LymDMFB8ucRbmKwKo2KnvOg="
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID_2",
      "description": "ENTITY_TYPE_DESCRIPTION",
      "createTime": "2021-02-25T01:34:26.198628Z",
      "updateTime": "2021-02-25T01:34:26.198628Z",
      "etag": "AMEw9yNuv-ILYG8VLLm1lgIKc7asGIAVFErjvH2Cyc_wIQm7d6DL4ZGv59cwZmxTumU="
    }
  ]
}

Linguaggi aggiuntivi

Puoi installare e utilizzare le seguenti librerie client di Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.

Elimina un tipo di entità

Elimina un tipo di entità. Se utilizzi la console Google Cloud, Vertex AI Feature Store elimina il tipo di entità e tutti i suoi contenuti. Se utilizzi l'API, abilita il parametro di ricerca force per eliminare il tipo di entità e tutti i suoi contenuti.

UI web

  1. Nella sezione Vertex AI di Google Cloud Console, vai alla pagina Funzionalità.

    Vai alla pagina Funzionalità

  2. Seleziona un'area geografica dall'elenco a discesa Area geografica.
  3. Nella tabella delle funzionalità, visualizza la colonna Tipo di entità e individua il tipo di entità da eliminare.
  4. Fai clic sul nome del tipo di entità.
  5. Dalla barra delle azioni, fai clic su Elimina.
  6. Fai clic su Conferma per eliminare il tipo di entità.

REST

Per eliminare un tipo di entità, invia una richiesta DELETE utilizzando il metodo featurestores.entityTypes.delete.

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

  • LOCATION: regione in cui si trova l'archivio di caratteristiche, ad esempio us-central1.
  • PROJECT: ID del progetto.
  • FEATURESTORE_ID: ID dell'archivio di caratteristiche.
  • ENTITY_TYPE_ID: ID del tipo di entità.
  • BOOLEAN: indica se eliminare il tipo di entità anche se contiene funzionalità. Il parametro di ricerca force è facoltativo ed è false per impostazione predefinita.

Metodo HTTP e URL: 

DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

Esegui questo comando: 

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN"

PowerShell

Esegui questo comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID?force=BOOLEAN" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-02-26T17:32:56.008325Z",
      "updateTime": "2021-02-26T17:32:56.008325Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Linguaggi aggiuntivi

Puoi installare e utilizzare le seguenti librerie client di Vertex AI per chiamare l'API Vertex AI. Le librerie client di Cloud offrono un'esperienza di sviluppo ottimizzata utilizzando le convenzioni e gli stili naturali di ogni linguaggio supportato.

Passaggi successivi