Inicie uma sincronização de dados

Se a sua vista de funcionalidades estiver configurada para usar a sincronização de dados agendada, pode optar por ignorar a espera até à próxima operação de sincronização agendada iniciando manualmente a sincronização de dados.

Não pode acionar manualmente uma sincronização de dados se a vista de funcionalidades estiver configurada para usar a sincronização de dados contínua. Para mais informações sobre os tipos de sincronização de dados que o Vertex AI Feature Store suporta e como configurar o tipo de sincronização para uma visualização de funcionalidades, consulte Sincronize dados de funcionalidades numa visualização de funcionalidades.

Tenha em atenção que, para sincronizar os dados de toda a loja online, tem de sincronizar os dados de todas as vistas de funcionalidades da mesma.

A sincronização de dados pode envolver custos de utilização de recursos do BigQuery. Para ver informações sobre como otimizar os custos ao definir a programação de sincronização de uma vista de funcionalidades, consulte o artigo Otimize os custos durante a sincronização.

Antes de começar

Autentique o Vertex AI, a menos que já o tenha feito.

Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

    Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

    gcloud init

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Inicie manualmente uma sincronização de dados

Use o exemplo seguinte para iniciar manualmente a sincronização de dados numa vista de recursos configurada para a sincronização de dados programada.

Tenha em atenção que apenas uma operação de sincronização de dados pode estar ativa em qualquer momento para uma visualização de funcionalidades. Se tentar iniciar manualmente a sincronização de dados enquanto outra sincronização está em curso, a nova operação de sincronização só é iniciada após a conclusão da operação de sincronização em curso.

REST

Para iniciar manualmente uma sincronização de dados num FeatureView>, envie um pedido POST através do método featureViews.sync.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • LOCATION_ID: região onde a loja online está localizada, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja online que contém a vista de funcionalidades.
  • FEATUREVIEW_NAME: o nome da vista de funcionalidades onde quer iniciar manualmente a sincronização de dados.

Método HTTP e URL: 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync

Para enviar o seu pedido, escolha uma destas opções:

curl

Execute o seguinte comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "featureViewSync": "projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID"
}

O que se segue?