Saiba como criar, listar, descrever, atualizar e excluir featurestores. Um featurestore é um contêiner de nível superior para tipos de entidades, recursos e valores de recursos.
Armazenamento on-line e off-line
O Feature Store da Vertex AI usa dois métodos, chamados armazenamento on-line e armazenamento off-line, com preços diferentes. Todos os featurestores têm armazenamento off-line e, opcionalmente, on-line.
O armazenamento on-line mantém os valores de carimbo de data/hora mais recentes dos recursos
para processar com eficiência as solicitações de veiculação on-line. Ao executar um job de importação
usando a API, é possível controlar o job quando os dados são gravados no armazenamento on-line. Pular
o armazenamento on-line impede qualquer carga nos nós de disponibilização on-line. Por exemplo,
ao executar jobs de preenchimento, você pode desativar as gravações no armazenamento on-line e gravar apenas
no armazenamento off-line. Para mais informações, consulte a
sinalização disableOnlineServing
na referência da
API.
O Feature Store da Vertex AI usa armazenamento off-line para armazenar os dados até que eles atinjam o limite de retenção ou até que você os exclua. Você pode armazenar dados ilimitados na loja off-line. É possível controlar os custos de armazenamento off-line gerenciando a quantidade de dados armazenada. Você também pode substituir o limite de retenção de dados do armazenamento on-line padrão do featurestore e o limite de retenção de dados off-line de um tipo de entidade. Saiba mais sobre as cotas e limites do Feature Store da Vertex AI.
Use o console do Cloud para acessar a quantidade de armazenamento on-line e off-line que você está usando no momento. Acesse as métricas de monitoramento do Armazenamento on-line total e do Armazenamento off-line total do featurestore para determinar o uso.
Nós de veiculação on-line
Os nós de exibição on-line fornecem os recursos de computação usados para armazenar e exibir valores de recursos para exibição on-line de baixa latência. Esses nós estão sempre em execução, mesmo quando não estão exibindo dados. Há cobrança por cada hora de uso do nó.
O limite de armazenamento para nós de exibição on-line é de 5 TB por nó. Saiba mais sobre as cotas e limites do Feature Store do Vertex AI.
O número de nós de exibição on-line necessários é diretamente proporcional aos dois fatores a seguir:
- O número de solicitações de veiculação on-line (consultas por segundo) que o featurestore recebe
- O número de jobs de importação que são gravados no armazenamento on-line.
Ambos os fatores contribuem para o uso da CPU e o desempenho dos nós. No Console do Cloud, veja as métricas das seguintes opções:
- Consultas por segundo: número de consultas por segundo na sua featurestore.
- Contagem de nós: número de nós de exibição on-line.
- Uso da CPU: uso da CPU pelos nós.
Se o uso da CPU for consistentemente alto, aumente o número de nós de exibição on-line para o featurestore.
Testar o desempenho dos nós de exibição on-line
É possível testar o desempenho dos nós de exibição on-line para a exibição de recursos em tempo real. Isso garante que o featurestore tenha recursos de máquina suficientes para executar dentro de QPS ou limites de latência predeterminados. É possível executar esses testes com base em vários parâmetros de comparativo de mercado, como QPS, latência e API. Veja as diretrizes e práticas recomendadas para testar o desempenho dos nós de exibição on-line em Testar o desempenho dos nós de exibição on-line para exibição em tempo real em Práticas recomendadas para o Feature Store da Vertex AI.
Além disso, você pode usar a ferramenta de código aberto Vertex AI Benchmarker (em inglês) para testar a performance dos recursos do armazenamento de recursos. A ferramenta de código aberto Vertex AI Benchmarker é composta por uma ferramenta de linha de comando Python e um worker Java.
Opções de escalonamento
É possível alternar entre as opções a seguir para configurar o número de nós de exibição on-line:
Escalonamento automático
Se você escolher o escalonamento automático, o featurestore alterará automaticamente o número de nós com base no uso da CPU. O escalonamento automático analisa os padrões de tráfego para manter o desempenho e otimiza o custo, adicionando nós quando o tráfego aumenta e removendo nós quando o tráfego diminui.
O escalonamento automático tem um bom desempenho em padrões de tráfego que apresentam crescimento e queda graduais. Se você usar o Feature Store da Vertex AI extensivamente para padrões de tráfego que encontram flutuações de carga frequentes, use o escalonamento automático para melhorar a eficiência de custos.
Alocação de uma contagem fixa de nós
Se você alocar uma contagem fixa de nós, o Feature Store da Vertex AI vai manter um número consistente de nós, independentemente dos padrões de tráfego. A contagem fixa de nós mantém os custos previsíveis, e os nós costumam ter bom desempenho quando há um número suficiente para processar o tráfego. É possível alterar manualmente a contagem fixa de nós para lidar com alterações nos padrões de tráfego.
Outras considerações para o escalonamento automático
Se você escolher o escalonamento automático, há mais quatro pontos a considerar:
Depois de adicionar nós de exibição on-line, o armazenamento on-line precisa de tempo para reequilibrar os dados. Pode levar até 20 minutos sob carga para que você perceba uma melhoria significativa no desempenho. Como resultado, escalonar o número de nós pode não ajudar em curtos bursts de tráfego. Essa limitação se aplica a escalonamentos manuais e automáticos.
Se você enviar solicitações de exibição on-line para o featurestore sem nós de exibição on-line, a operação retornará um erro.
Desativar a exibição on-line na sua featurestore
Se você não precisar de exibição on-line e quiser evitar alterações nos nós de exibição on-line, defina o número de nós de exibição on-line como zero. Para desativar a exibição on-line no featurestore, defina a seguinte configuração:
Se você estiver usando o escalonamento automático, remova o parâmetro
scaling
.Defina o número fixo de nós de exibição on-line como
0
.
Para mais informações sobre como criar um featurestore, consulte Criar um featurestore. Para mais informações sobre como modificar a configuração de um featurestore existente, consulte Atualizar um featurestore.
Se você definir o número de nós de veiculação on-line como 0
, toda a loja on-line, inclusive os dados dela, será excluída. Se você quiser desativar seu armazenamento on-line temporariamente e restaurá-lo depois, importe novamente os dados excluídos.
Por exemplo, se você definir a contagem de nós de veiculação on-line do featurestore como 0
e, em seguida, provisionar os nós de veiculação on-line definindo a contagem de nós como 1
ou mais, a Feature Store da Vertex AI não migrará os dados de recursos excluídos. à loja on-line. Para preencher seu armazenamento on-line novamente, você precisa importar seus dados de novo. Uma forma de fazer isso é exportar os dados históricos antes de desativar os nós de disponibilização on-line e importar os dados exportados depois de provisionar esses nós.
Ao provisionar nós de disponibilização on-line, é necessário aguardar a conclusão da operação para importar novos dados. Os jobs de importação em andamento serão retomados somente após a conclusão do provisionamento do nó de disponibilização on-line.
Se você enviar uma solicitação de veiculação on-line para o featurestore sem nós de veiculação on-line, a solicitação retornará um erro.
Criar um featurestore
Crie um recurso featurestore para conter tipos e recursos de entidade. O
local da featurestore precisa estar no mesmo local que os dados de origem.
Por exemplo, se o featurestore estiver em us-central,
, será possível importar dados de
arquivos em buckets do Cloud Storage que estão em us-central1
ou no local
multirregional dos EUA, embora não haja suporte para os dados de origem de
buckets birregionais. Da mesma forma, para o BigQuery, é possível importar dados de
tabelas que estão em us-central1
ou no local multirregional dos EUA. Para mais informações, consulte Requisitos de dados de origem.
A disponibilidade do Vertex AI Feature Store pode variar de acordo com o local. Para mais informações, consulte Disponibilidade de recursos.
Interface da Web
É possível criar um featurestore usando o console do Google Cloud se um featurestore ainda não tiver sido criado no projeto do Google Cloud para a região selecionada. Se já houver um featurestore para o projeto e a região, use outro método.
Para criar um featurestore usando o console do Google Cloud:
- Na seção "Vertex AI" do console do Google Cloud, acesse a página Recursos.
- Clique em Criar featurestore
- Especifique um nome para o featurestore.
- Se você quiser ativar a exibição on-line do featurestore,
clique no botão Ativar a exibição on-line e defina as opções de escalonamento.
Para mais informações sobre as opções de dimensionamento e disponibilização on-line, consulte Nós de disponibilização on-line - Clique em Criar.
Terraform
O exemplo a seguir usa o recurso google_vertex_ai_featurestore
do Terraform para criar um featurestore com uma contagem fixa de nós. O nome do featurestore é featurestore_xxxxxxxx
, em que xxxxxxxx
é um identificador alfanumérico gerado aleatoriamente.
Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.
REST
Para criar um featurestore, envie uma solicitação POST usando o método featurestores.create.
O exemplo a seguir cria um featurestore com uma contagem de nós fixa de
1
. A contagem de nós especifica o número de nós de exibição on-line,
o que afeta o número de solicitações de exibição on-line que a featurestore pode
processar. A latência pode aumentar se o número de nós não for compatível com o
número de solicitações recebidas.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região onde a featurestore é criada. Por exemplo,
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURESTORE_ID: código do featurestore.
Método HTTP e URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores?featurestoreId=FEATURESTORE_ID
Corpo JSON da solicitação:
{ "online_serving_config": { "fixed_node_count": 1 }, "labels": { "environment": "testing" } }
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?featurestoreId=FEATURESTORE_ID"
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?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Será exibido um código semelhante a este. Use OPERATION_ID na resposta para ver o status da operação.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-02-26T00:44:40.722474Z", "updateTime": "2021-02-26T00:44:40.722474Z" } } }
Python
Para saber como instalar o SDK da Vertex AI para Python, consulte Instalar o SDK da Vertex AI para Python. Para mais informações, consulte a documentação de referência da API Python.
Python
A biblioteca de cliente da Vertex AI está incluída quando você instala o SDK da Vertex AI para Python. Para saber como instalar o SDK da Vertex AI para Python, consulte Instalar o SDK da Vertex AI para Python. Saiba mais na documentação de referência da API SDK da Vertex AI para Python.
Java
Antes de testar essa amostra, siga as instruções de configuração para Java Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Java.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Node.js.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Criar um featurestore que usa uma CMEK
Antes de começar, se você não tiver uma Chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês), use o Cloud Key Management Service para configurar uma chave de criptografia gerenciada pelo cliente e definir permissões. No exemplo a seguir, criamos um store de recursos que usa uma CMEK.
Se a Vertex AI perder a permissão para a chave CMEK associada, todos os recursos e valores nos featurestores que foram criptografados por essa chave ficarão inacessíveis até que a Vertex AI possa usar essa chave novamente.
Após 30 dias, se a Vertex AI ainda não tiver acesso à chave CMEK, a Vertex AI excluirá todos os armazenamentos de recursos que foram criptografados com essa chave. Ao criar novos featurestores, não é possível reutilizar os nomes.
IU da Web
Use outro método. Não é possível criar um featurestore pelo Console do Cloud.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região onde a featurestore é criada. Por exemplo,
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURESTORE_ID: código do featurestore.
- CMEK_PROJECT: o ID do projeto ou o número do projeto que contém sua CMEK.
- KEY_RING: o nome do keyring do Cloud Key Management Service em que a chave de criptografia está ativada.
- KEY_NAME: o nome da chave de criptografia a ser usada.
Método HTTP e URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores?featurestoreId=FEATURESTORE_ID
Corpo JSON da solicitação:
{ "online_serving_config": { "fixed_node_count": 1 }, "encryption_spec":{ "kms_key_name": "projects/CMEK_PROJECT/locations/LOCATION_ID/keyRings/KEY_RING/cryptoKeys/KEY_NAME" } }
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?featurestoreId=FEATURESTORE_ID"
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?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Será exibido um código semelhante a este. Use OPERATION_ID na resposta para ver o status da operação.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-02-26T00:44:40.722474Z", "updateTime": "2021-02-26T00:44:40.722474Z" } } }
Listar featurestores
Lista todas as featurestores de um projeto.
IU da Web
- Na seção "Vertex AI" do Console do Google Cloud, acesse a página Recursos.
- Selecione uma região na lista suspensa Região.
- Na tabela de recursos, visualize a coluna Featurestore para ver os featurestores no projeto da região selecionada.
REST
Para listar os featurestores de uma região específica do projeto, envie uma solicitação GET usando o método featurestores.list.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que featurestore está localizada, como
us-central1
. - PROJECT_ID: o ID do projeto.
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores
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/projects/PROJECT_ID/locations/LOCATION_ID/featurestores"
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/projects/PROJECT_ID/locations/LOCATION_ID/featurestores" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "featurestores": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/test", "createTime": "2021-02-26T00:44:44.216805Z", "updateTime": "2021-02-26T00:44:44.364916Z", "etag": "AMEw9yNL0s7qZh8lZVZ5T3BEuhoEgFR7JmjbbCSAkRZjeKDXkkIYnxxA4POe5BWT8cCn", "labels": { "environment": "testing" }, "onlineServingConfig": { "fixedNodeCount": 2 }, "state": "STABLE" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/featurestore_demo", "createTime": "2021-02-25T00:39:40.598781Z", "updateTime": "2021-02-25T00:39:40.744038Z", "etag": "AMEw9yO_e0vm-9W_yeCz4rJm-XnnEMYQ-vQesevxya_sz-FckuysnDwo3cEXHdWWSeda", "labels": { "environment": "testing" }, "onlineServingConfig": { "fixedNodeCount": 3 }, "state": "STABLE" } ] }
Java
Antes de testar esse exemplo, siga as instruções de configuração para Java no Guia de início rápido da Vertex AI sobre como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Java.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Node.js.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
Confira a instalação e o uso do SDK da Vertex AI para Python em Usar o SDK da Vertex AI para Python. Saiba mais na documentação de referência da API SDK da Vertex AI para Python.
Ver detalhes do featurestore
Veja detalhes sobre uma featurestore, como nome e configuração de exibição on-line. Se você usa o Console do Cloud, pode visualizar as métricas do Cloud Monitoring para featurestores.
IU da Web
- Na seção "Vertex AI" do Console do Google Cloud, acesse a página Recursos.
- Selecione uma região na lista suspensa Região.
- Na tabela de recursos, visualize a coluna Featurestore e encontre o featurestore com as informações que você quer ver.
- Clique no nome da featurestore para visualizar as métricas do Monitoring.
- Clique na guia Propriedades para visualizar a configuração de exibição on-line do featurestore.
REST
Para ver detalhes sobre um único featurestore, envie uma solicitação GET usando o método featurestores.get.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que featurestore está localizada, como
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURESTORE_ID: ID do featurestore.
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
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/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID"
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/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID", "createTime": "2021-02-25T00:39:40.598781Z", "updateTime": "2021-02-25T00:39:40.744038Z", "etag": "AMEw9yNy_b4IaMIvw1803ZT38cpUtjfwlyLkR709oBCY6pQrm6dHophLcqhrvsNqkQQZ", "onlineServingConfig": { "fixedNodeCount": 3 }, "state": "STABLE" }
Java
Antes de testar esse exemplo, siga as instruções de configuração para Java no Guia de início rápido da Vertex AI sobre como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Java.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Node.js.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
Confira a instalação e o uso do SDK da Vertex AI para Python em Usar o SDK da Vertex AI para Python. Saiba mais na documentação de referência da API SDK da Vertex AI para Python.
Atualizar um featurestore
Atualizar um featurestore, por exemplo, para alterar o número de nós de exibição on-line ou atualizar rótulos em um featurestore.
IU da Web
É possível atualizar apenas o número de nós de exibição on-line. Para atualizar rótulos, use a API.
- Na seção "Vertex AI" do Console do Google Cloud, acesse a página Recursos.
- Selecione uma região na lista suspensa Região.
- Na tabela de recursos, visualize a coluna Featurestore e clique no nome do featurestore para atualizar.
- Clique em Edit configuration para abrir o painel Edit featurestore configuration.
- Edite a configuração do featurestore.
- Clique em Atualizar para aplicar as mudanças.
REST
Para atualizar um featurestore, envie uma solicitação PATCH usando o método featurestores.patch.
O exemplo a seguir atualiza o número de nós de exibição on-line para
2
para o featurestore. Todas as outras configurações permanecem as mesmas.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que featurestore está localizada, como
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURESTORE_ID: ID do featurestore.
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
Corpo JSON da solicitação:
{ "online_serving_config": { "fixed_node_count": 2 } }
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 PATCH \
-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"
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 PATCH `
-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" | Select-Object -Expand Content
Será exibido um código semelhante a este. Use OPERATION_ID na resposta para ver o status da operação.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeaturestoreOperationMetadata", "genericMetadata": { "createTime": "2021-03-18T21:12:08.373664Z", "updateTime": "2021-03-18T21:12:08.373664Z" } } }
Java
Antes de testar esse exemplo, siga as instruções de configuração para Java no Guia de início rápido da Vertex AI sobre como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Java.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Node.js.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
Confira a instalação e o uso do SDK da Vertex AI para Python em Usar o SDK da Vertex AI para Python. Saiba mais na documentação de referência da API SDK da Vertex AI para Python.
Excluir um featurestore
Exclua um featurestore. Se o featurestore incluir tipos e recursos
de entidade existentes, ative o parâmetro de consulta force
para excluir o featurestore e todo
o conteúdo dele.
IU da Web
Use outro método. Não é possível excluir um featurestore pelo Console do Cloud.
REST
Para excluir um featurestore e todo o conteúdo dele, envie uma solicitação DELETE usando o método featurestores.delete.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que featurestore está localizada, como
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURESTORE_ID: ID do featurestore.
- BOOLEAN: se o featurestore será excluído, mesmo que contenha
tipos e recursos de entidade. O parâmetro de consulta
force
é opcional e éfalse
por padrão.
Método HTTP e URL:
DELETE https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN"
PowerShell
execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID?force=BOOLEAN" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATIONS_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata", "genericMetadata": { "createTime": "2021-05-03T17:50:21.813112Z", "updateTime": "2021-05-03T17:50:21.813112Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.protobuf.Empty" } }
Python
Para saber como instalar o SDK da Vertex AI para Python, consulte Instalar o SDK da Vertex AI para Python. Para mais informações, consulte a documentação de referência da API Python.
Python
A biblioteca de cliente da Vertex AI está incluída quando você instala o SDK da Vertex AI para Python. Para saber como instalar o SDK da Vertex AI para Python, consulte Instalar o SDK da Vertex AI para Python. Saiba mais na documentação de referência da API SDK da Vertex AI para Python.
Java
Antes de testar essa amostra, siga as instruções de configuração para Java Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Java.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar essa amostra, siga as instruções de configuração para Node.js Guia de início rápido da Vertex AI: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Vertex AI para Node.js.
Para autenticar na Vertex AI, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
A seguir
- Saiba como gerenciar tipos de entidade e recursos.
- Resolva problemas comuns da Feature Store da Vertex AI (legada).