Voir les catégories

Anvil.works Intégration DuckDB - Synchronisation automatique des données de la base de données Live

7 min de lecture

INTÉGRATION

DuckDB Enclume

DuckDB DuckDB
Flux de requêtes Flux de requêtes
Enclume Enclume
Code zéro
Configuration facile
Rapide

Query Streams permet une intégration transparente d'Anvil DuckDB, en synchronisant automatiquement les données DuckDB en temps réel avec vos feuilles Anvil. Inscrivez-vous gratuitement sur QueryStreams.com et commencez à automatiser vos pipelines de données DuckDB vers Anvil en quelques minutes.

Ce guide vous explique comment configurer la synchronisation automatisée des données entre DuckDB et Anvil à l'aide de Query Streams. Que vous ayez besoin de mettre à jour vos feuilles de gestion de projet avec les enregistrements de la base de données, de synchroniser les données d'inventaire avec les espaces de travail collaboratifs ou d'automatiser les workflows de reporting, Query Streams offre une solution sécurisée et sans code pour l'intégration de DuckDB à Anvil.works.

Automatisation planifiée

Synchronisation toutes les heures, tous les jours ou selon des horaires personnalisés

Sécurité par conception

Les informations d'identification restent sur votre réseau

Rapide comme l'éclair

Optimisation du flux de données

Synchronisation intelligente

Insérer, mettre à jour, supprimer automatiquement

Qu'est-ce que l'intégration Anvil DuckDB ?

L'intégration Anvil DuckDB connecte votre base de données DuckDB à Anvil, permettant ainsi une synchronisation automatique des données sans exportation ni importation manuelle. Query Streams agit comme un pont sécurisé entre votre base de données et Anvil, exécutant les requêtes SQL enregistrées selon un calendrier défini et transmettant les résultats directement à vos feuilles de calcul.

Principales capacités :

  • Synchronisation automatique : Planifiez l'exécution des requêtes toutes les heures, tous les jours ou à des intervalles personnalisés.
  • Mode synchronisation complète : Insérer automatiquement de nouvelles lignes, mettre à jour les lignes existantes et supprimer les enregistrements supprimés.
  • Mode ajout : Ajouter de nouveaux enregistrements sans modifier les données existantes (idéal pour les journaux et l'historique)
  • Connexion sécurisée : Vos identifiants de base de données restent protégés au sein de votre réseau.
  • Aucun codage requis : Configurez tout via le portail Web Query Streams.

Conditions préalables

1

Installation de l'agent Query Streams

L'agent doit être exécuté sur votre réseau et avoir accès à votre base de données DuckDB.

Installation de l'agent Query Streams →
2

Source de données DuckDB configurée

Votre base de données DuckDB doit être ajoutée en tant que source de données dans l'agent.

Connecter DuckDB à Query Streams →
3

Compte Anvil

Un compte Anvil avec accès API (disponible dans les formules Business et Enterprise, ou via un essai gratuit).

4

Requête sauvegardée

Au moins une requête enregistrée dans Query Streams qui renvoie les données que vous souhaitez synchroniser.

Étape 1 : Créez votre requête DuckDB

1
2
3
4
5
6
7

Avant de configurer l'intégration, vous devez disposer d'une requête enregistrée qui renvoie les données que vous souhaitez synchroniser avec Anvil.

  1. Connectez-vous au portail Query Streams : Visite mon.querystreams.com et connectez-vous
  2. Ouvrez le générateur de requêtes : Accédez au générateur de requêtes à partir du tableau de bord.
  3. Sélectionnez votre source de données DuckDB : Dans la barre latérale Data Explorer à gauche, développez votre Data Realm, puis sélectionnez votre connecteur DuckDB et choisissez la base de données que vous souhaitez interroger.
  4. Écrivez votre requête SQL : Créez la requête qui renvoie les données que vous souhaitez synchroniser.
Exemple de requête DuckDB SQL
SELECT 
    order_id,
    customer_name,
    order_date,
    total_amount,
    status
FROM orders
WHERE order_date >= NOW() - INTERVAL '30 days'
ORDER BY order_date DESC
LIMIT 1000;
  1. Tester et enregistrer : Exécutez la requête pour vérifier les résultats, puis enregistrez-la sous un nom descriptif tel que « Commandes récentes pour Anvil ».
Conseil de pro : Si vous prévoyez d'utiliser le mode Full Sync, assurez-vous que votre requête inclut une colonne d'identifiant unique (comme numéro_de_commande) qu'Anvil peut utiliser pour faire correspondre les lignes.

Étape 2 : Créer l'intégration Anvil.works

2
3
4
5
6
7

Vous allez maintenant connecter votre requête enregistrée à Anvil via la fonctionnalité Automatisation.

  1. Accédez à Automatisation : Dans le portail Query Streams, cliquez sur Automatisation dans la barre latérale gauche
  2. Créer une nouvelle intégration : Cliquez sur Nouvelle intégration pour démarrer l'assistant d'installation
  3. Sélectionnez votre requête enregistrée : Choisissez la requête DuckDB que vous avez créée à l'étape 1.
  4. Choisissez Anvil comme destination : Sélectionner Enclume à partir de la liste des plateformes disponibles

Étape 3 : Connectez votre compte Anvil

3
4
5
6
7

L'intégration d'Anvil.works nécessite l'installation du composant Query Streams dans votre application Anvil.works et sa configuration à l'aide d'une clé de connexion sécurisée.

1

Ajouter une dépendance tierce

Dans votre application Anvil.works, allez dans Paramètres → Dépendances

Cliquez sur le bouton « Tiers » onglet et entrez ce code :

47C7VQG6QJTVY16B
2

Créer un module serveur

Dans votre application Anvil.works, créez un Module serveur et ajoutez ce code :

from querystreams import connector
connector.init_connector("YOUR_AUTH_KEY")
3

Générer une clé d'authentification sécurisée

Dans la configuration de l'automatisation des flux de requêtes :

  1. Cliquez sur Générer une clé sécurisée (ou entrez votre propre valeur)
  2. Copiez la clé d'authentification
  3. Remplacer VOTRE_CLÉ_D'AUTHENTIFICATION dans votre code Anvil.works avec cette clé
4

Entrez l'URL de l'application Anvil

Dans Query Streams, entrez l'URL de votre application Anvil.works publiée (domaine anvil.app ou votre domaine personnalisé).

Exemples : https://your-app.anvil.app ou https://yourdomain.com

5

Test de connexion

Cliquez sur Test de connexion pour vérifier que Query Streams peut communiquer avec votre application Anvil.works

Étape 4 : Sélectionnez votre feuille de destination

4
5
6
7

Choisissez où vos données DuckDB seront synchronisées dans Anvil.works.

  1. Parcourez vos feuilles : Query Streams affichera vos feuilles Anvil et vos espaces de travail disponibles.
  2. Sélectionnez une feuille : Choisissez une feuille existante pour synchroniser les données, ou sélectionnez Créer une nouvelle feuille
  3. Mappage des colonnes : Query Streams mappera automatiquement les colonnes de votre requête SQL aux colonnes Anvil. Vérifiez et ajustez si nécessaire.
Conseil : Si vous créez une nouvelle feuille, Query Streams créera automatiquement des colonnes en fonction des résultats de votre requête.

Étape 5 : Configurer le mode de synchronisation

5
6
7

Choisissez comment Query Streams doit gérer la synchronisation des données.

+

Mode Append

Idéal pour les journaux et l'historique
  • Ajoute de nouvelles lignes en bas
  • Ne modifie jamais les lignes existantes
  • Ne supprime jamais les données
  • Conserve les archives historiques
Idéal pour : Journaux d'audit, historique des transactions, suivi des événements, données chronologiques

Mode Full Sync

Populaire
Idéal pour les données en temps réel
  • Inserts nouveaux records
  • Mises à jour enregistrements modifiés
  • Supprime enregistrements supprimés
  • Nécessite une colonne clé
Idéal pour : Inventaire, données de référence, dossiers actifs, tableaux de bord

Sélection des colonnes clés : Si vous utilisez le mode Synchronisation complète, sélectionnez la colonne qui identifie de manière unique chaque ligne. Cette colonne doit exister à la fois dans les résultats de votre requête SQL et dans votre feuille Anvil.

Comportement de synchronisation des colonnes (SYNC vs PRESERVE)

Pour chaque colonne de votre mappage de champs, choisissez comment Query Streams doit la traiter pendant la synchronisation :

SYNC (Par défaut)

Valeur source remplace toujours cible

Utilisation pour : Colonnes de données qui doivent correspondre exactement à votre base de données (statut de la commande, totaux, dates)

PRÉSERVER

La valeur cible est jamais écrasé

Utilisation pour : Colonnes dans lesquelles vous ajoutez des notes manuelles, des affectations ou des mises à jour de statut dans Anvil.works.
Exemple : synchronisation des commandes avec les notes de l'équipe
Colonnes source (provenant de DuckDB)
  • numéro_de_commande – Champ clé
  • nom_client – SYNC
  • statut – SYNC
  • total – SYNC
Colonnes ajoutées par l'utilisateur (dans Anvil.works)
  • Attribué à – PRÉSERVER
  • Remarques – PRÉSERVER
  • Priorité – PRÉSERVER
Résultat : Chaque synchronisation met à jour les données de commande provenant de la base de données tout en conservant les notes et les affectations de votre équipe.

Étape 6 : Définissez votre calendrier de synchronisation

6
7

Configurez quand Query Streams doit synchroniser les données de DuckDB vers Anvil.

Manuel Exécuter les synchronisations uniquement à la demande
Toutes les 5 minutesSynchronisation haute fréquence pour les données en temps réel
Toutes les 10 minutesMises à jour en temps quasi réel
Toutes les 15 minutesSynchronisation fréquente pour les données actives
🕑
À l'heure Synchroniser toutes les heures
📅
QuotidienSynchronisation une fois par jour à une heure précise
Personnalisé Définissez des jours et des heures spécifiques

Étape 7 : Vérifier et activer

7
  1. Configuration de l'examen : Vérifiez tous les paramètres, y compris la requête, la destination, le mode de synchronisation et le calendrier.
  2. Nommez votre intégration : Donnez-lui un nom descriptif tel que « Commandes à Anvil Daily Sync ».
  3. Activer : Cliquez sur Créer une intégration pour enregistrer et activer
  4. Lancer la synchronisation initiale : Cliquez sur Exécuter maintenant effectuer la première synchronisation et vérifier que tout fonctionne

Félicitations !

Votre intégration DuckDB à Anvil.works est désormais opérationnelle. Les données seront synchronisées automatiquement selon votre calendrier.

Surveillance de votre intégration

Après l'activation, vous pouvez surveiller votre intégration Anvil DuckDB depuis le tableau de bord Automation :

🕑

Dernière synchronisation

Voir quand les données ont été synchronisées pour la dernière fois

📊

Lignes synchronisées

Afficher le nombre de lignes insérées, mises à jour et supprimées

🔔

Alertes d'erreur

Recevez une notification en cas d'échec de la synchronisation

📃

Historique de synchronisation

Consulter les opérations de synchronisation passées et leurs résultats

Cas d'utilisation courants pour l'intégration Anvil DuckDB

💼

Gestion de projet

Synchronisez les données de projet, les jalons et les allocations de ressources depuis votre base de données DuckDB vers Anvil pour faciliter la collaboration et la visibilité au sein de votre équipe.

💰

Pipeline des ventes

Tenez à jour Anvil de votre équipe commerciale avec les dernières opportunités, offres et informations clients issues de votre base de données CRM.

📦

Suivi des stocks

Mettez automatiquement à jour les niveaux de stock, les inventaires et les informations sur les produits dans Anvil.works pour les équipes chargées de l'entrepôt et des opérations.

📈

Rapports financiers

Synchronisez les données budgétaires, les notes de frais et les indicateurs financiers avec Anvil pour les tableaux de bord exécutifs et les rapports destinés aux parties prenantes.

👥

Ressources humaines et opérations

Synchronisez les répertoires des employés, les listes des membres des services et les données organisationnelles entre votre base de données HRIS et Anvil.

Questions fréquemment posées

À quelle fréquence puis-je synchroniser les données de DuckDB vers Anvil ? +

Query Streams prend en charge les calendriers de synchronisation allant d'une fréquence horaire à des intervalles personnalisés. Dans la plupart des cas, les synchronisations quotidiennes ou horaires offrent un bon équilibre entre la fraîcheur des données et les ressources système.

🔒 Mes données DuckDB sont-elles sécurisées pendant la synchronisation ? +

Oui. Vos identifiants de base de données restent protégés au sein de votre réseau grâce à l'agent Query Streams. Les données sont cryptées pendant leur transfert et votre jeton API Anvil est stocké en toute sécurité. Query Streams ne stocke jamais les données brutes de votre base de données.

Que se passe-t-il si la synchronisation échoue ? +

Query Streams réessaiera les synchronisations ayant échoué et vous informera des erreurs persistantes. Vous pouvez consulter les détails des erreurs dans l'historique de synchronisation et déclencher manuellement une nouvelle tentative une fois le problème résolu.

📂 Puis-je synchroniser plusieurs feuilles Anvil à partir de la même base de données DuckDB ? +

Oui. Créez des intégrations distinctes pour chaque feuille de destination. Chaque intégration peut utiliser une requête SQL, un mode de synchronisation et un calendrier différents.

Cela fonctionne-t-il avec les services cloud DuckDB ? +

Oui. Query Streams prend en charge toutes les variantes DuckDB, y compris Amazon RDS pour DuckDB, Azure Database pour DuckDB, Google Cloud SQL pour DuckDB, Heroku duckdb et les instances auto-hébergées.

Updated on 3 juin 2026

Powered by BetterDocs