Criar uma instância de loja on-line

Para configurar a disponibilização on-line, primeiro é preciso criar uma instância de loja on-line para disponibilização on-line do Bigtable ou disponibilização on-line otimizada.

Não é possível alterar o tipo de disponibilização on-line depois de escolher a disponibilização on-line do Bigtable ou a disponibilização on-line otimizada durante a criação da loja on-line. No entanto, é possível alterar a configuração do endpoint de disponibilização para uma instância de loja on-line criada para a disponibilização on-line otimizada.

Depois de criar o armazenamento on-line, é possível adicionar visualizações de atributos e associar essas visualizações a fontes de dados de recursos no BigQuery.

Configurar o gerenciamento de incorporação para uma loja on-line

o Vertex AI Feature Store permite realizar pesquisas de similaridade vetorial usando embeddings em uma visualização de recursos de uma loja on-line. Para realizar uma pesquisa de similaridade vetorial, você precisa configurar a instância da loja on-line para oferecer suporte ao gerenciamento de incorporação. Para isso, use o parâmetro FeatureOnlineStore.embedding_management e depois configurar a recuperação de vetores para pelo menos uma visualização de recurso no armazenamento on-line.

Para mais informações sobre como pesquisar vizinhos mais próximos aproximados usando embeddings no Vertex AI Feature Store, consulte Pesquisar usando embeddings.

Criar uma loja on-line para exibição on-line do Bigtable

Use os exemplos a seguir para criar uma instância de loja on-line para veiculação on-line do Bigtable com escalonamento automático.

Console

Use as instruções a seguir para criar um loja on-line para veiculação on-line do Bigtable usando o console do Google Cloud.

Na seção Vertex AI do console do Google Cloud, acesse a página Feature Store.

Acessar a página do Feature Store
Clique em Loja on-line para acessar a seção Loja on-line.
Clique em Create para abrir a página Criar loja on-line.
Especifique um nome para a loja on-line.
Opcional: para adicionar rótulos, clique em Adicionar rótulo e especifique o nome e o valor do rótulo. É possível adicionar vários rótulos a uma loja on-line.
No campo Selecione uma solução de armazenamento para sua loja on-line, clique em Bigtable.
Modifique a Contagem mínima de nós, a Contagem máxima de nós e a Meta de utilização da CPU, conforme necessário.
Clique em Criar.

REST

Para criar um recurso FeatureOnlineStore, envie uma solicitação POST usando o método featureOnlineStores.create.

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

LOCATION_ID: região em que você quer criar a loja on-line, como us-central1.
PROJECT_ID: o ID do projeto.
FEATUREONLINESTORE_NAME: o nome da nova instância de loja on-line.
BOOLEAN (opcional): para criar uma loja on-line compatível com o gerenciamento de incorporação, insira true. O valor padrão é false.

Método HTTP e URL:

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON da solicitação:

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
  "embedding_management": {
    "enabled": BOOLEAN
  }
}

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 \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Criar um repositório on-line para veiculação on-line otimizada

Ao usar a disponibilização on-line otimizada, é possível configurar a loja on-line para disponibilizar recursos de um endpoint público ou dedicado do Private Service Connect. Use um endpoint do Private Service Connect se quiser disponibilizar recursos em uma rede VPC com latências menores do que um endpoint público.

Criar uma loja on-line para disponibilização on-line otimizada com um endpoint público

Use os exemplos a seguir para criar uma loja on-line para veiculação on-line otimizada com um endpoint público.

IU da Web

Use as instruções a seguir para criar um loja on-line para veiculação on-line otimizada usando o console do Google Cloud.

Na seção Vertex AI do console do Google Cloud, acesse a página Feature Store.

Acessar a página do Feature Store
Clique em Loja on-line para acessar a seção Loja on-line.
Clique em Create para abrir a página Criar loja on-line.
Especifique um nome para a loja on-line.
Opcional: para adicionar rótulos, clique em Adicionar rótulo e especifique o nome e o valor do rótulo. É possível adicionar vários rótulos a uma loja on-line.
No campo Selecione uma solução de armazenamento para sua loja on-line, clique em Otimizada.
Clique em Criar.

REST

Para criar uma instância de loja on-line, envie uma solicitação POST usando o método featureOnlineStores.create.

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

LOCATION_ID: região onde você quer criar a instância de FeatureOnlineStore, como us-central1.
PROJECT_ID: o ID do projeto.
FEATUREONLINESTORE_NAME: o nome da nova instância FeatureOnlineStore.

Método HTTP e URL:

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON da solicitação:

{
  "optimized": {}
}

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 \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Criar uma loja on-line para disponibilização on-line otimizada com um endpoint do Private Service Connect

Use o exemplo a seguir para criar uma loja on-line para disponibilização on-line otimizada com o Private Service Connect.

REST

Para criar uma instância de loja on-line, envie uma solicitação POST usando o método featureOnlineStores.create.

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

LOCATION_ID: região onde você quer criar a instância de FeatureOnlineStore, como us-central1.
PROJECT_ID: o ID do projeto.
FEATUREONLINESTORE_NAME: o nome da nova instância FeatureOnlineStore.

Método HTTP e URL:

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corpo JSON da solicitação:

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_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 \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

A seguir

Saiba como criar uma visualização de recursos.
Saiba como atualizar uma loja on-line.