Cómo iniciar una sincronización de datos

Si tu vista de atributos está configurada para usar la sincronización de datos programada, puedes omitir la espera hasta la próxima operación de sincronización programada de forma opcional si inicias manualmente la sincronización de datos.

No puedes activar manualmente una sincronización de datos si tu vista de atributos está configurada para usar la sincronización de datos continua. Para obtener más información sobre los tipos de sincronización de datos que admite Vertex AI Feature Store y cómo configurar el tipo de sincronización para una vista de atributos, consulta Cómo sincronizar datos de atributos en una vista de atributos.

Ten en cuenta que, para sincronizar los datos de toda la tienda en línea, debes sincronizar los datos de todas sus vistas 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.

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

    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 el siguiente ejemplo para iniciar manualmente la sincronización de datos en una vista de atributos configurada para la sincronización de datos programada.

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?