Saiba como criar, listar, descrever, atualizar e eliminar featurestores. Um Feature Store é um contentor de nível superior para tipos de entidades, funcionalidades e valores de funcionalidades.
Armazenamento online e offline
O Vertex AI Feature Store (antigo) usa dois métodos de armazenamento classificados como armazenamento online e armazenamento offline, que têm preços diferentes. Todas as featurestores têm armazenamento offline e, opcionalmente, armazenamento online.
O armazenamento online retém os valores de data/hora mais recentes das suas funcionalidades para
processar pedidos de publicação online de forma eficiente. Quando executa uma tarefa de importação através da API, pode controlar a tarefa se os dados forem escritos na loja online. Ignorar a loja online impede qualquer carregamento nos nós de publicação online. Por exemplo, quando executa tarefas de preenchimento, pode desativar as gravações na loja online e gravar apenas na loja offline. Para mais informações, consulte a flag disableOnlineServing
na referência
da API.
O Vertex AI Feature Store (antigo) usa o armazenamento offline para armazenar dados até que estes atinjam o limite de retenção ou até que os elimine. Pode armazenar dados ilimitados no armazenamento offline. Pode controlar os custos de armazenamento offline gerindo a quantidade de dados que mantém. Também pode substituir o limite de retenção de dados da loja online predefinido para a featurestore e o limite de retenção de dados offline para um tipo de entidade. Saiba mais sobre as quotas e os limites do Vertex AI Feature Store (antigo).
Use a Google Cloud consola para ver a quantidade de armazenamento online e offline que está a usar. Veja as métricas de monitorização do armazenamento online total e do armazenamento offline total do featurestore para determinar a sua utilização.
Nós de publicação online
Os nós de publicação online fornecem os recursos de computação usados para armazenar e publicar valores de caraterísticas para publicação online de baixa latência. Estes nós estão sempre em execução, mesmo quando não estão a fornecer dados. É-lhe cobrado o valor de cada hora de nó.
O limite de armazenamento para nós de publicação online é de 5 TB por nó. Saiba mais sobre as quotas e os limites do Vertex AI Feature Store (antigo).
O número de nós de publicação online de que precisa é diretamente proporcional aos dois fatores seguintes:
- O número de pedidos de publicação online (consultas por segundo) que o Feature Store recebe.
- O número de tarefas de importação que escrevem no armazenamento online.
Ambos os fatores contribuem para a utilização da CPU e o desempenho dos nós. Na Google Cloud consola, veja as métricas do seguinte:
- Consultas por segundo: número de consultas por segundo para o seu Feature Store.
- Número de nós: número de nós de publicação online.
- Utilização da CPU: utilização da CPU dos seus nós.
Se a utilização da CPU for consistentemente elevada, considere aumentar o número de nós de publicação online para o seu Feature Store.
Teste o desempenho dos nós de publicação online
Pode testar o desempenho dos nós de publicação online para a publicação de funcionalidades em tempo real. Isto permite-lhe garantir que o Feature Store tem recursos da máquina suficientes para funcionar dentro dos limites de QPS ou latência predeterminados. Pode realizar estes testes com base em vários parâmetros de testes de referência, como QPS, latência e API. Para ver diretrizes e práticas recomendadas para testar o desempenho dos nós de publicação online, consulte o artigo Teste o desempenho dos nós de publicação online para publicação em tempo real em Práticas recomendadas para o Vertex AI Feature Store (antigo).
Além disso, pode usar a ferramenta de código aberto Vertex AI Benchmarker para testar a carga do desempenho dos recursos da loja de funcionalidades. A ferramenta de código aberto Vertex AI Benchmarker consiste numa ferramenta de linha de comandos Python e num worker Java.
Opções de dimensionamento
Pode alternar entre as seguintes opções para configurar o número de nós de publicação online:
Ajuste de escala automático
Se escolher o dimensionamento automático, o Feature Store altera automaticamente o número de nós com base na utilização da CPU. A escala automática revê os padrões de tráfego para manter o desempenho e otimizar o custo adicionando nós quando o tráfego aumenta e removendo nós quando o tráfego diminui.
O dimensionamento automático tem um bom desempenho para padrões de tráfego que registam um crescimento e um declínio graduais. Se usar extensivamente o Vertex AI Feature Store (antigo) para padrões de tráfego que encontram flutuações de carga frequentes, use o dimensionamento automático para melhorar a eficiência de custos.
Atribuir uma quantidade fixa de nós
Se atribuir uma quantidade fixa de nós, o Vertex AI Feature Store (antigo) mantém um número consistente de nós, independentemente dos padrões de tráfego. A quantidade fixa de nós mantém os custos previsíveis, e os nós devem ter um bom desempenho quando existem nós suficientes para processar o tráfego. Pode alterar manualmente a contagem de nós fixos para processar alterações nos padrões de tráfego.
Considerações adicionais para o dimensionamento automático
Se escolher o dimensionamento automático, existem quatro pontos adicionais a considerar, incluindo:
Depois de adicionar nós de publicação online, a loja online precisa de tempo para reequilibrar os dados. Pode demorar até 20 minutos sob carga antes de ver uma melhoria significativa no desempenho. Como resultado, o dimensionamento do número de nós pode não ajudar em picos curtos de tráfego. Esta limitação aplica-se ao ajuste de escala manual e automático.
Se enviar pedidos de publicação online para o Feature Store sem nós de publicação online, a operação devolve um erro.
Desative a publicação online na Feature Store
Se não precisar da publicação online e quiser evitar incorrer em alterações para nós de publicação online, defina o número de nós de publicação online como zero. Para desativar a publicação online no seu Feature Store, defina a seguinte configuração:
Se estiver a usar o dimensionamento automático, remova o parâmetro
scaling
.Defina o número fixo de nós de publicação online como
0
.
Para mais informações sobre como criar uma featurestore, consulte o artigo Crie uma featurestore. Para mais informações sobre como modificar a configuração de um featurestore existente, consulte o artigo Atualize um featurestore.
Se definir o número de nós de publicação online como 0
, toda a loja online, incluindo os respetivos dados, é eliminada. Se quiser desativar temporariamente a sua loja online e, em seguida, restaurá-la, tem de reimportar os dados eliminados.
Por exemplo, se definir a contagem de nós de publicação online para 0
e, em seguida, aprovisionar nós de publicação online definindo a contagem de nós para 1
ou superior, o Vertex AI Feature Store (antigo) não migra os dados de caraterísticas eliminados para a loja online. Para voltar a preencher a sua loja online, tem de reimportar os dados. Uma forma de voltar a importar os dados é exportar os dados do histórico antes de desativar os nós de publicação online e, em seguida, importar os dados exportados depois de aprovisionar os nós.
Quando aprovisiona nós de publicação online, tem de aguardar a conclusão da operação antes de importar novos dados. As tarefas de importação em curso só são retomadas após o aprovisionamento do nó de publicação online estar concluído.
Se enviar um pedido de publicação online para o Feature Store sem nós de publicação online, o pedido devolve um erro.
Crie um Feature Store
Crie um recurso featurestore para conter tipos de entidades e funcionalidades. A localização do Feature Store tem de estar na mesma localização que os dados de origem.
Por exemplo, se o seu Feature Store estiver em us-central,
, pode importar dados de ficheiros em contentores do Cloud Storage que estejam em us-central1
ou na localização multirregião dos EUA, embora os dados de origem de contentores de dupla região não sejam suportados. Da mesma forma, para o BigQuery, pode importar dados de tabelas que se encontram na localização us-central1
ou na localização multirregião dos EUA. Para mais informações, consulte os requisitos de dados de origem.
A disponibilidade do Vertex AI Feature Store (antigo) pode variar consoante a localização. Para mais informações, consulte o artigo Disponibilidade de funcionalidades.
IU da Web
Pode criar um Feature Store através da Google Cloud consola se ainda não tiver sido criado um Feature Store no projeto Google Cloud para a região selecionada. Se já existir um Feature Store para o projeto e a região, use outro método.
Para criar um Feature Store através da Google Cloud consola:
- Na secção Vertex AI da Google Cloud consola, aceda à página Funcionalidades.
- Clique em Criar Feature Store
- Especifique um nome para o Feature Store.
- Se quiser ativar a publicação online para o Feature Store,
clique no botão Ativar publicação online e defina as opções de escalabilidade.
Para mais informações sobre as opções de publicação e escalabilidade online, consulte Nós de publicação online - Clique em Criar.
Terraform
O exemplo seguinte usa o recurso do Terraform google_vertex_ai_featurestore
para criar um Feature Store com uma contagem de nós fixa. O nome do Feature Store é featurestore_yyyyyyyy
, onde yyyyyyyy
é um identificador alfanumérico gerado aleatoriamente.
Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.
REST
Para criar um Feature Store, envie um pedido POST através do método featurestores.create.
O exemplo seguinte cria um Feature Store com uma contagem de nós fixa de 1
. A contagem de nós especifica o número de nós de publicação online, o que afeta o número de pedidos de publicação online que o Feature Store pode processar. A latência pode aumentar se o número de nós não suportar o número de pedidos recebidos.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store é criado. Por exemplo,
us-central1
. - PROJECT_ID: o seu ID do projeto.
- FEATURESTORE_ID: ID da Feature Store.
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 do pedido:
{ "online_serving_config": { "fixed_node_count": 1 }, "labels": { "environment": "testing" } }
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?featurestoreId=FEATURESTORE_ID"
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?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Deverá ver uma saída semelhante à seguinte. Pode usar o elemento OPERATION_ID na resposta para obter o estado 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 ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a Python documentação de referência da API.
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Crie um Feature Store que use uma CMEK
Antes de começar, se não tiver uma CMEK (chave de encriptação gerida pelo cliente), use o Cloud Key Management Service para configurar uma chave de encriptação gerida pelo cliente e configurar autorizações. O exemplo seguinte cria um Feature Store que usa uma chave CMEK.
Se a Vertex AI perder a autorização para a chave CMEK associada, todos os recursos e valores nas featurestores que foram encriptados por essa chave tornam-se inacessíveis até que a Vertex AI possa usar essa chave novamente.
Após 30 dias, se o Vertex AI ainda não tiver acesso à chave CMEK, o Vertex AI elimina todas as featurestores encriptadas com essa chave. Quando cria novos featurestores, não pode reutilizar os nomes desses featurestores.
IU da Web
Use outro método. Não pode criar um Feature Store a partir da Google Cloud consola.
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store é criado. Por exemplo,
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID da Feature Store.
- CMEK_PROJECT: o ID ou o número do projeto que contém a sua CMEK.
- KEY_RING: o nome do conjunto de chaves do Cloud Key Management Service em que a sua chave de encriptação se encontra.
- KEY_NAME: o nome da chave de encriptação a usar.
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 do pedido:
{ "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 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?featurestoreId=FEATURESTORE_ID"
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?featurestoreId=FEATURESTORE_ID" | Select-Object -Expand Content
Deverá ver uma saída semelhante à seguinte. Pode usar o elemento OPERATION_ID na resposta para obter o estado 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
Apresenta todas as featurestores num projeto.
IU da Web
- Na secção Vertex AI da Google Cloud consola, aceda à página Funcionalidades.
- Selecione uma região na lista pendente Região.
- Na tabela de funcionalidades, veja a coluna Feature Store para ver os Feature Stores no seu projeto para a região selecionada.
REST
Para listar featurestores de uma região específica no seu projeto, envie um pedido GET através do método featurestores.list.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store está localizado, como
us-central1
. - PROJECT_ID: .
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores
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/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
Deve receber uma resposta JSON semelhante à seguinte:
{ "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 experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Idiomas adicionais
Para saber como instalar e usar o SDK Vertex AI para Python, consulte o artigo Use o SDK Vertex AI para Python. Para mais informações, consulte a documentação de referência da API do SDK Vertex AI para Python.
Veja os detalhes da Feature Store
Obtenha detalhes sobre um Feature Store, como o nome e a configuração de publicação online. Se usar a Google Cloud consola, também pode ver as métricas do Cloud Monitoring para featurestores.
IU da Web
- Na secção Vertex AI da Google Cloud consola, aceda à página Funcionalidades.
- Selecione uma região na lista pendente Região.
- Na tabela de funcionalidades, veja a coluna Feature Store e encontre o Feature Store para o qual quer ver informações.
- Clique no nome do Feature Store para ver as respetivas métricas de monitorização.
- Clique no separador Propriedades para ver a configuração de publicação online do Feature Store.
REST
Para obter detalhes sobre uma única Feature Store, envie um pedido GET através do método featurestores.get.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store está localizado, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID da Feature Store.
Método HTTP e URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
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/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
Deve receber uma resposta JSON semelhante à seguinte:
{ "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 experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Idiomas adicionais
Para saber como instalar e usar o SDK Vertex AI para Python, consulte o artigo Use o SDK Vertex AI para Python. Para mais informações, consulte a documentação de referência da API do SDK Vertex AI para Python.
Atualize um Feature Store
Atualize um Feature Store, por exemplo, para alterar o número de nós de publicação online ou atualizar etiquetas num Feature Store.
IU da Web
Só pode atualizar o número de nós de publicação online. Para atualizar etiquetas, use a API.
- Na secção Vertex AI da Google Cloud consola, aceda à página Funcionalidades.
- Selecione uma região na lista pendente Região.
- Na tabela de funcionalidades, veja a coluna Featurestore e clique no nome do Featurestore a atualizar.
- Clique em Editar configuração para abrir o painel Editar configuração do Feature Store.
- Edite a configuração do Feature Store.
- Clique em Atualizar para aplicar as alterações.
REST
Para atualizar um Feature Store, envie um pedido PATCH através do método featurestores.patch.
O exemplo seguinte atualiza o número de nós de publicação online para 2
para o Feature Store. Todas as outras definições permanecem inalteradas.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store está localizado, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID da Feature Store.
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID
Corpo JSON do pedido:
{ "online_serving_config": { "fixed_node_count": 2 } }
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 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
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 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
Deverá ver uma saída semelhante à seguinte. Pode usar o elemento OPERATION_ID na resposta para obter o estado 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 experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Idiomas adicionais
Para saber como instalar e usar o SDK Vertex AI para Python, consulte o artigo Use o SDK Vertex AI para Python. Para mais informações, consulte a documentação de referência da API do SDK Vertex AI para Python.
Elimine um Feature Store
Elimine um Feature Store. Se o Feature Store incluir tipos de entidades e funcionalidades existentes, ative o parâmetro de consulta force
para eliminar o Feature Store e todo o respetivo conteúdo.
IU da Web
Use outro método. Não pode eliminar um Feature Store a partir da Google Cloud consola.
REST
Para eliminar um Feature Store e todo o respetivo conteúdo, envie um pedido DELETE através do método featurestores.delete.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION_ID: região onde o Feature Store está localizado, como
us-central1
. - PROJECT_ID: .
- FEATURESTORE_ID: ID da Feature Store.
- BOOLEAN: se deve eliminar o Feature Store, mesmo que contenha
tipos de entidades e funcionalidades. O parâmetro de consulta
force
é opcional e estáfalse
por predefiniçã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 o seu pedido, 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
Deve receber uma resposta JSON semelhante à seguinte:
{ "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 ou atualizar o SDK Vertex AI para Python, consulte o artigo Instale o SDK Vertex AI para Python. Para mais informações, consulte a Python documentação de referência da API.
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Vertex AI com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Vertex AI.
Para se autenticar no Vertex AI, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
O que se segue?
- Saiba como gerir tipos de entidades e funcionalidades.
- Resolva problemas comuns do Vertex AI Feature Store (antigo).