Excluir valores de atributo

É possível excluir valores de atributos de um tipo de entidade das seguintes maneiras:

Excluir valores de atributos de entidades especificadas
Excluir valores de atributos especificados dentro de um período

Excluir valores de atributos de entidades especificadas

Você pode excluir valores de atributos de várias entidades em um tipo de entidade. Para especificar as entidades de que você quer excluir os valores de atributos, é necessário listar os IDs das entidades em um arquivo CSV.

REST

Para excluir valores de atributos, envie uma solicitação POST usando o método featurestores.entityTypes.deleteFeatureValues.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

LOCATION_ID: região ou local em que a featurestore é criada. Por exemplo, us-central1.
PROJECT_ID: o ID do projeto.
FEATURESTORE_ID: ID do featurestore.
ENTITY_TYPE: ID do tipo de entidade de que você quer excluir os valores de atributo.
CSV_FILE_URI: especifique o URI do Cloud Storage do arquivo CSV que contém os IDs de entidade de que você quer excluir os valores de atributos. A primeira linha desse arquivo deve ser uma das seguintes:
- Se você especificar o parâmetro entity_id_field, a primeira linha do arquivo CSV precisa ser igual a ENTITY_ID_FIELD.
- Se você não especificar o parâmetro entity_id_field, a primeira linha do arquivo CSV precisa ser "entity_id".
ENTITY_ID_FIELD (opcional): insira a string especificada na primeira linha do arquivo CSV em CSV_FILE_URI.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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 status da solicitação

Para verificar o status da solicitação POST, envie a seguinte solicitação GET.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

LOCATION_ID: região ou local em que a featurestore é criada. Por exemplo, us-central1.
OPERATION_NAME: o valor do campo "name" na resposta JSON recebida da solicitação POST para excluir valores de atributos.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

execute o seguinte comando:

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

PowerShell

execute o seguinte 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

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.

Excluir valores de atributos especificados dentro de um período

Para excluir os valores de atributos de um tipo de entidade, especifique os IDs dos atributos e um período.

REST

Para excluir valores de atributos de um tipo de entidade, envie uma solicitação POST usando o método featurestores.entityTypes.deleteFeatureValues.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

LOCATION_ID: região ou local em que a featurestore é criada. Por exemplo, us-central1.
PROJECT_ID: o ID do projeto.
FEATURESTORE_ID: ID do featurestore.
ENTITY_TYPE: ID do tipo de entidade de que você quer excluir os valores de atributo.
START_TIME: especifique o horário de início do período.
END_TIME: (opcional) especifique o horário de término do período.

Observação: se você especificar START_TIME sem especificar um END_TIME, a solicitação exclui os valores de atributos da IDs de atributos especificados até o momento atual (quando a solicitação é enviada).
SKIP_ONLINE_STORAGE_DELETE: (opcional) para excluir valores de atributos do armazenamento on-line, bem como off-line, digite false. Caso contrário, para excluir os valores de atributos apenas do armazenamento off-line, digite true.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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 status da solicitação

Para verificar o status da solicitação POST, envie a seguinte solicitação GET.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

LOCATION_ID: região ou local em que a featurestore é criada. Por exemplo, us-central1.
OPERATION_NAME: o valor do campo "name" na resposta JSON recebida da solicitação POST para excluir valores de atributos.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

execute o seguinte comando:

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

PowerShell

execute o seguinte 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

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.

A seguir

Veja as cotas e limites do Feature Store do Vertex AI.