Iniciar uma sincronização de dados

Se a visualização de recurso estiver configurada para usar a sincronização programada de dados, você poderá pular a espera até a próxima operação de sincronização programada iniciando manualmente a sincronização de dados.

Não é possível acionar manualmente uma sincronização de dados se a visualização de recursos estiver configurada para usar a sincronização contínua de dados. Para mais informações sobre os tipos de sincronização de dados compatíveis com o Vertex AI Feature Store e como configurar o tipo de sincronização para uma visualização de recursos, consulte Sincronizar dados de recursos em uma visualização de recursos.

Para sincronizar os dados de toda a loja on-line, é necessário sincronizar os dados de todas as visualizações de recursos.

A sincronização de dados pode envolver custos de uso de recursos do BigQuery. Para informações sobre como otimizar custos ao definir a programação de sincronização para uma visualização de recursos, consulte Otimizar custos durante a sincronização.

Antes de começar

Faça a autenticação na Gemini Enterprise Agent Platform, a menos que já tenha feito isso.

Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

    Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Iniciar manualmente uma sincronização de dados

Use o exemplo a seguir para iniciar manualmente a sincronização de dados em uma visualização de recurso configurada para sincronização de dados programada.

Apenas uma operação de sincronização de dados pode estar ativa a qualquer momento para uma visualização de recursos. Se você tentar iniciar manualmente a sincronização de dados enquanto outra sincronização estiver em andamento, a nova operação de sincronização será iniciada somente após o término da operação de sincronização em andamento.

REST

Para iniciar manualmente uma sincronização de dados em um FeatureView , envie umaPOST solicitação usando o métodofeatureViews.sync.

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

  • LOCATION_ID: região em que a loja on-line está localizada, como us-central1.
  • PROJECT_ID: o ID do projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja on-line que contém a visualização do recurso.
  • FEATUREVIEW_NAME: o nome da vista do elemento em que você 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 a solicitação, 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

Você receberá uma resposta JSON semelhante a esta:

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

A seguir