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 a CLI gcloud.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
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
Saiba como atualizar uma visualização de recurso.