Sincroniza datos de funciones en la tienda en línea

La sincronización de datos es el proceso de actualizar o sincronizar los datos de una vista de atributo en una tienda en línea desde la fuente de datos de atributos en BigQuery. Para sincronizar los datos de toda la tienda en línea, debes sincronizar los datos de todas de sus vistas de atributos.

Existen dos maneras en las que se produce la sincronización de datos para una vista de atributos:

  • Sincronización de datos programada: Los datos de atributos se actualizan automáticamente en función del programa de sincronización configurado para la vista de funciones con el parámetro FeatureView.sync_config.

  • Sincronización de datos manual: Puedes omitir la espera entre dos operaciones de sincronizaciones de datos programadas iniciando manualmente la sincronización de datos para una vista de atributos.

La sincronización de datos puede implicar costos por el uso de recursos de BigQuery. Para obtener información sobre cómo optimizar los costos mientras se establece el programa de sincronización de una vista de funciones, consulta Optimiza costos durante la sincronización.

Antes de comenzar

Autentícate en Vertex AI, a menos que ya lo hayas hecho.

Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

    Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

    gcloud init

Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Inicia una sincronización de datos de forma manual

Usa este ejemplo para iniciar manualmente la sincronización de datos en una vista de atributos. Ten en cuenta que solo una operación de sincronización de datos puede estar activa en cualquier momento para una vista de atributos. Si intentas iniciar la sincronización de datos de forma manual mientras otra sincronización está en curso, la nueva operación de sincronización comenzará solo después de finalice la actual.

REST

Para iniciar manualmente una sincronización de datos en un archivo FeatureView, envía una solicitud de POST a través del métodofeatureViews.sync.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • LOCATION_ID: región en donde se encuentra la tienda en línea, como us-central1.
  • PROJECT_ID: ID del proyecto
  • FEATUREONLINESTORE_NAME: Es el nombre de la tienda en línea que contiene la vista de atributos.
  • FEATUREVIEW_NAME: Es el nombre de la vista de atributos en la que quieres iniciar manualmente la sincronización de datos.

Método HTTP y URL: 

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

¿Qué sigue?