Borra valores de atributos

Puedes borrar los valores de atributos de un tipo de entidad de las siguientes maneras:

Borrar los valores de los atributos de las entidades especificadas
Borrar los valores de los atributos especificados en un intervalo de tiempo

Borra los valores de los atributos de entidades especificadas

Puedes borrar valores de atributos de varias entidades dentro de un tipo de entidad. Para especificar las entidades de las que deseas borrar valores de los atributos, debes enumerar los IDs de las entidades en un archivo CSV.

REST

Para borrar los valores de los atributos, envía una solicitud POST con el método featurestores.entityTypes.deleteFeatureValues.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: región o ubicación donde se crea el almacén de atributos. Por ejemplo, us-central1
PROJECT_ID: El ID del proyecto.
FEATURESTORE_ID: ID del featurestore.
ENTITY_TYPE: ID del tipo de entidad desde el que deseas borrar los valores de los atributos.
CSV_FILE_URI: Especifica el URI de Cloud Storage del archivo CSV que contiene los IDs de las entidades en los que deseas borrar los valores de atributos. La primera línea de este archivo debe ser una de las siguientes:
- Si especificas el parámetro entity_id_field, la primera línea del archivo CSV debe ser la misma que ENTITY_ID_FIELD.
- Si no especificas el parámetro entity_id_field, la primera línea del archivo CSV debe ser “entity_id”.
ENTITY_ID_FIELD: (Opcional) ingresa la string especificada en la primera línea del archivo CSV en CSV_FILE_URI.

Método HTTP y URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

Cuerpo JSON de la solicitud:

{
  "selectEntity": {
    "entityIdSelector": {
      "csv_source": {
        "gcs_source": {
          "uris": [
            "CSV_FILE_URI"
          ]
        },
        "entity_id_field": "ENTITY_ID_FIELD"
      }
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

PowerShell

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

Consulta el estado de la solicitud

Para verificar el estado de la solicitud POST, envía la siguiente solicitud GET.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: región o ubicación donde se crea el almacén de atributos. Por ejemplo, us-central1
OPERATION_NAME: el valor del campo “name” en la respuesta JSON que se recibe de la solicitud POST para borrar valores de atributos.

Método HTTP y URL:

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"

PowerShell

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Borrar los valores de los atributos especificados en un intervalo de tiempo

Puedes borrar los valores de atributos de un tipo de entidad si especificas los IDs de los atributos y un intervalo de tiempo.

REST

Para borrar los valores de atributos de un tipo de entidad, envía una solicitud POST mediante el método featurestores.entityTypes.deleteFeatureValues.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: región o ubicación donde se crea el almacén de atributos. Por ejemplo, us-central1
PROJECT_ID: El ID del proyecto.
FEATURESTORE_ID: ID del featurestore.
ENTITY_TYPE: ID del tipo de entidad desde el que deseas borrar los valores de los atributos.
START_TIME: especifica la hora de inicio del intervalo de tiempo.
END_TIME: (Opcional) especifica la hora de finalización del intervalo de tiempo.

Nota: Si especificas START_TIME sin especificar END_TIME, la solicitud borra los valores de atributo de los IDs de atributo especificados hasta la hora actual (cuando se envía la solicitud).
SKIP_ONLINE_STORAGE_DELETE: (Opcional) Para borrar los valores de atributos del almacenamiento en línea y del almacenamiento sin conexión, ingresa false. De lo contrario, para borrar los valores de atributos solo del almacenamiento sin conexión, ingresa true.

Método HTTP y URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

Cuerpo JSON de la solicitud:

{
  "selectTimeRangeAndFeature": {
    "timeRange": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    },
    "featureSelector": {
      "idMatcher": {
        "ids": [ "FEATURE_ID", ...]
      }
    },
    "skipOnlineStorageDelete": SKIP_ONLINE_STORAGE_DELETE
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

Consulta el estado de la solicitud

Para verificar el estado de la solicitud POST, envía la siguiente solicitud GET.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

LOCATION_ID: región o ubicación donde se crea el almacén de atributos. Por ejemplo, us-central1
OPERATION_NAME: el valor del campo “name” en la respuesta JSON que se recibe de la solicitud POST para borrar valores de atributos.

Método HTTP y URL:

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"

PowerShell

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

¿Qué sigue?

Consulta los límites y cuotas de Vertex AI Feature Store.