Passer au contenu

Synchroniser et supprimer des données de catalogue

Cette page explique comment synchroniser des données de catalogue avec l’ingestion de données cloud (CDI). Les synchronisations de catalogue sont prises en charge pour toutes les sources CDI, et le format de la table ou du fichier source propre à chacune est documenté sur la page de cette source.

Étape 1 : Créer un nouveau catalogue

Avant de créer une nouvelle intégration CDI pour les catalogues, vous devez créer un nouveau catalogue ou identifier un catalogue existant à utiliser pour l’intégration. Il existe plusieurs façons de créer un nouveau catalogue, et chacune d’elles convient à l’intégration CDI :

Toute modification du schéma du catalogue (par exemple, l’ajout de nouveaux champs ou la modification du type d’un champ) doit être effectuée dans le tableau de bord du catalogue avant que les données mises à jour ne soient synchronisées via CDI. Braze recommande d’effectuer ces mises à jour lorsque la synchronisation est en pause ou qu’aucune exécution n’est planifiée, afin d’éviter les conflits entre les données de votre entrepôt de données et le schéma dans Braze.

Étape 2 : Configurer la synchronisation du catalogue

La configuration d’une synchronisation de catalogue suit de près le processus de synchronisation des données utilisateur pour la même source. Ouvrez la page de votre source et sélectionnez l’onglet Articles du catalogue pour la table source ou le format de fichier, puis terminez la configuration sur cette page.

Source Configuration du catalogue
Snowflake Table source Snowflake
Amazon Redshift Table source Redshift
Google BigQuery Table source BigQuery
Databricks Table source Databricks
Microsoft Fabric Table source Microsoft Fabric
Amazon S3 Formats de fichiers Amazon S3
Google Cloud Storage Formats de fichiers Google Cloud Storage
Azure Blob Storage Formats de fichiers Azure Blob Storage

Quelle que soit la source utilisée, les règles suivantes s’appliquent :

  • Sélectionnez le type de synchronisation Catalogues lors de la création de la synchronisation.
  • Saisissez un Nom de synchronisation pour identifier la synchronisation.
  • Pour Catalogue à mettre à jour, sélectionnez Utiliser un catalogue existant, puis choisissez le catalogue, ou sélectionnez Créer un nouveau catalogue et saisissez le Nom du catalogue.
  • Si vous disposez déjà d’identifiants issus d’une synchronisation existante, vous pouvez les réutiliser, mais veillez à étendre l’accès à la table source du catalogue.

Colonnes requises

Colonne Requise ? Description
ID Oui L’ID de l’article du catalogue à créer ou à mettre à jour.
payload Oui Une chaîne de caractères JSON contenant les champs à synchroniser avec l’article du catalogue dans Braze.
DELETED Facultatif Lorsque la valeur est true, l’article correspondant est supprimé du catalogue.
UPDATED_AT Sources d’entrepôt de données uniquement L’heure à laquelle cette ligne a été mise à jour ou ajoutée. Les sources de stockage de fichiers ne prennent pas en charge les colonnes UPDATED_AT.

Fonctionnement de l’intégration

À chaque exécution de la synchronisation, Braze récupère toutes les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Les lignes situées exactement sur l’horodatage limite peuvent être synchronisées à nouveau si de nouvelles lignes partagent ce même horodatage.

Braze recommande de créer une vue dans votre entrepôt de données à partir des données de votre catalogue afin de configurer une table source entièrement actualisée à chaque exécution de la synchronisation. Grâce aux vues, vous n’avez pas besoin de réécrire la requête à chaque fois. Pour consulter un exemple concret dans le dialecte SQL de votre entrepôt, reportez-vous à l’onglet Articles du catalogue de la page de votre source.

Quelle que soit la source utilisée :

  • Les données récupérées depuis l’intégration servent à créer ou à mettre à jour des articles dans le catalogue cible en fonction de l’id fourni.
  • Si DELETED est défini sur true, l’article correspondant du catalogue est supprimé.
  • La synchronisation n’enregistre pas de points de données, mais toutes les données synchronisées sont prises en compte dans l’utilisation totale de votre catalogue. Cette utilisation est mesurée en fonction du volume total de données stockées : vous n’avez donc pas besoin de vous limiter à la synchronisation des données modifiées.
New Stuff!