Iniciar uma sincronização de dados

Se a visualização de recursos estiver configurada para usar a sincronização de dados programada, 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 que o Feature Store da Vertex AI oferece suporte 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 Vertex AI, a menos que já tenha feito isso.

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

    Instale a Google Cloud CLI.

    Ao usar um provedor de identidade (IdP) externo, primeiro 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 recursos 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