Sincronizar dados de recursos com a loja on-line

A sincronização de dados é o processo de atualização ou sincronização dos dados em uma visualização de recursos dentro de um armazenamento on-line a partir da fonte de dados de recursos no BigQuery. 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 ocorre de duas formas em uma visualização de recursos:

  • Sincronização programada de dados: os dados do recurso são atualizados automaticamente com base na programação de sincronização configurada para a visualização do recurso usando o parâmetro FeatureView.sync_config.

  • Sincronização manual de dados: é possível pular a espera entre duas operações de sincronização de dados programadas iniciando manualmente a sincronização de uma visualização 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 nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

Para mais informações, consulte 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 vista de recursos. 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