Eliminar valores de características

Para obtener más información, ejecuta el cuaderno "Example Feature Store workflow with sample data" (Flujo de trabajo de Feature Store de ejemplo con datos de muestra) en uno de los siguientes entornos:

Abrir en Colab | Abrir en Colab Enterprise | Abrir en Vertex AI Workbench | Ver en GitHub

Puedes eliminar los valores de las funciones de un tipo de entidad de las siguientes formas:

• Eliminar valores de características de entidades especificadas

• Eliminar valores de características de las características especificadas en un intervalo de tiempo

Eliminar valores de características de entidades especificadas

Puede eliminar valores de características de varias entidades de un tipo de entidad. Para especificar las entidades de las que quieres eliminar los valores de la función, debes enumerar los IDs de entidad en un archivo CSV.

REST

Para eliminar valores de características, envía una solicitud POST mediante el método featurestores.entityTypes.deleteFeatureValues.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION_ID: región o ubicación en la que se crea el almacén de características. Por ejemplo, us-central1.
• PROJECT_ID: tu ID de proyecto.
• FEATURESTORE_ID: ID del almacén de características.
• ENTITY_TYPE: ID del tipo de entidad del que quieres eliminar los valores de la función.
• CSV_FILE_URI: especifica el URI de Cloud Storage del archivo CSV que contiene los IDs de las entidades de las que quieres eliminar los valores de las características. La primera línea de este archivo debe ser una de las siguientes:
  • Si especifica 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) Introduce la cadena 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: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:

{
  "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"
      ]
    }
  }
}

Ver el estado de la solicitud

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION_ID: región o ubicación en la que se crea el almacén de características. Por ejemplo, us-central1.
• OPERATION_NAME: valor del campo `name` de la respuesta JSON recibida de la solicitud POST para eliminar valores de características.

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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.

Eliminar valores de características de las características especificadas en un intervalo de tiempo

Puedes eliminar valores de características de un tipo de entidad especificando los IDs de las características y un intervalo de tiempo.

Nota: Si usa esta opción, los valores de la función se eliminarán permanentemente de los IDs de función especificados en el intervalo de tiempo indicado. Esto puede incluir datos del almacenamiento online. Si quieres conservar el historial de datos eliminados en el almacenamiento online, debes volver a ingerirlos.

REST

Para eliminar valores de características de un tipo de entidad, envía una solicitud POST mediante el método featurestores.entityTypes.deleteFeatureValues.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION_ID: región o ubicación en la que se crea el almacén de características. Por ejemplo, us-central1.
• PROJECT_ID: tu ID de proyecto.
• FEATURESTORE_ID: ID del almacén de características.
• ENTITY_TYPE: ID del tipo de entidad del que quieres eliminar los valores de la función.
• START_TIME: especifica la hora de inicio del periodo.
• END_TIME: (Opcional) Especifica la hora de finalización del periodo.
  
  Nota: Si especifica el START_TIME sin especificar un END_TIME, la solicitud eliminará los valores de la función de los IDs de función especificados hasta la hora actual (cuando se envíe la solicitud).
• SKIP_ONLINE_STORAGE_DELETE: (Opcional) Para eliminar los valores de las funciones del almacenamiento online y del almacenamiento sin conexión, introduce false. De lo contrario, para eliminar los valores de las funciones del almacenamiento sin conexión, introduce 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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:

{
  "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"
      ]
    }
  }
}

Ver el estado de la solicitud

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION_ID: región o ubicación en la que se crea el almacén de características. Por ejemplo, us-central1.
• OPERATION_NAME: valor del campo `name` de la respuesta JSON recibida de la solicitud POST para eliminar valores de características.

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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.

Siguientes pasos

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