Pode eliminar valores de caraterísticas de um tipo de entidade das seguintes formas:
Elimine valores de funcionalidades de entidades especificadas
Elimine valores de funcionalidades de funcionalidades especificadas num intervalo de tempo
Elimine valores de caraterísticas de entidades especificadas
Pode eliminar valores de funcionalidades de várias entidades num tipo de entidade. Para especificar as entidades das quais quer eliminar os valores das funcionalidades, tem de listar os IDs das entidades num ficheiro CSV.
REST
Para eliminar valores de caraterísticas, envie um pedido POST através do método featurestores.entityTypes.deleteFeatureValues.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região ou localização onde o Feature Store é criado. Por exemplo,
us-central1
. - PROJECT_ID: o seu ID do projeto.
- FEATURESTORE_ID: ID da Feature Store.
- ENTITY_TYPE: ID do tipo de entidade do qual quer eliminar os valores das caraterísticas.
- CSV_FILE_URI: especifique o URI do Google Cloud Storage do ficheiro CSV que contém os IDs das entidades para as quais quer eliminar valores de atributos. A primeira linha deste ficheiro deve ser uma das seguintes:
- Se especificar o parâmetro
entity_id_field
, a primeira linha do ficheiro CSV tem de ser igual a ENTITY_ID_FIELD. - Se não especificar o parâmetro
entity_id_field
, a primeira linha do ficheiro CSV tem de ser "entity_id".
- Se especificar o parâmetro
- ENTITY_ID_FIELD: (Opcional) Introduza a string especificada na primeira linha do ficheiro 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 do pedido:
{ "selectEntity": { "entityIdSelector": { "csv_source": { "gcs_source": { "uris": [ "CSV_FILE_URI" ] }, "entity_id_field": "ENTITY_ID_FIELD" } } } }
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte:
{ "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" ] } } }
Veja o estado do pedido
Para verificar o estado do pedido POST, envie o seguinte pedido GET.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região ou localização onde o Feature Store é criado. Por exemplo,
us-central1
. - OPERATION_NAME: o valor do campo "name" na resposta JSON recebida do pedido POST para eliminar valores de atributos.
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
Para enviar o seu pedido, 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
Deve receber um código de estado de êxito (2xx) e uma resposta vazia.
Elimine valores de funcionalidades de funcionalidades especificadas num intervalo de tempo
Pode eliminar valores de funcionalidades de um tipo de entidade especificando os IDs das funcionalidades e um intervalo de tempo.
REST
Para eliminar valores de funcionalidades de um tipo de entidade, envie um pedido POST através do método featurestores.entityTypes.deleteFeatureValues.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região ou localização onde o Feature Store é criado. Por exemplo,
us-central1
. - PROJECT_ID: o seu ID do projeto.
- FEATURESTORE_ID: ID da Feature Store.
- ENTITY_TYPE: ID do tipo de entidade do qual quer eliminar os valores das caraterísticas.
- START_TIME: especifique a hora de início do intervalo de tempo.
- END_TIME: (opcional) especifique a hora de fim do intervalo de tempo.
- SKIP_ONLINE_STORAGE_DELETE: (Opcional) Para eliminar valores de atributos do
armazenamento online, bem como do armazenamento offline, introduza
false
. Caso contrário, para eliminar os valores das funcionalidades apenas do armazenamento offline, introduzatrue
.
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 do pedido:
{ "selectTimeRangeAndFeature": { "timeRange": { "startTime": "START_TIME", "endTime": "END_TIME" }, "featureSelector": { "idMatcher": { "ids": [ "FEATURE_ID", ...] } }, "skipOnlineStorageDelete": SKIP_ONLINE_STORAGE_DELETE } }
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte:
{ "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" ] } } }
Veja o estado do pedido
Para verificar o estado do pedido POST, envie o seguinte pedido GET.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região ou localização onde o Feature Store é criado. Por exemplo,
us-central1
. - OPERATION_NAME: o valor do campo "name" na resposta JSON recebida do pedido POST para eliminar valores de atributos.
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
Para enviar o seu pedido, 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
Deve receber um código de estado de êxito (2xx) e uma resposta vazia.
O que se segue?
Veja as cotas e os limites do Vertex AI Feature Store.