Alimenter une base depuis une base externe

Une base Filarr peut se nourrir d'une base externe (la table des commandes de votre boutique, une feuille Google, une base Notion), la nourrir, ou les deux. La clé de la base externe reste chez vous. Depuis l'application de bureau ou votre boîte noire, la clé et les lignes vont directement de la source à vous, sans passer par les serveurs de Filarr. Depuis le web, elles passent par le relais de Filarr, qui ne garde rien : ce trajet-là n'est pas chiffré de bout en bout.

Sur la base, cliquez sur ··· puis Alimenter depuis une base externe…. Une fois la synchro réglée, la même entrée devient Modifier la synchro avec la base externe…. Elle n'existe pas pour une base adossée à un dossier, ni dans une note en lecture seule.

Les paliers

L'import ponctuel depuis l'application de bureau est offert à tous les paliers.
La synchro planifiée (miroir, publication, deux sens) est offerte à partir de Solo.
Sur le web, tout passe par le relais de Filarr, qui ne garde rien : l'entrée n'apparaît qu'à partir de Solo, import ponctuel compris.

Une synchro planifiée demande un compte Filarr connecté sur ce profil : la base passe alors au stockage des grandes bases de Filarr, où vit la définition de la synchro. L'appli mobile actuelle n'ouvre pas encore une base rangée à ce stockage : elle affiche à sa place un avis de version plus récente. Modifiez-la depuis le bureau ou le web.

Les quatre sens

sens	ce qui se passe
Une fois	les lignes entrent une fois ; la base reste ensuite à vous, sans lien avec la source
Miroir entrant	la source fait foi : chaque passage apporte ses changements ; les colonnes qu'elle remplit sont verrouillées dans Filarr
Publier vers la source	Filarr fait foi : vos changements partent vers la source. Il faut une clé en écriture
Dans les deux sens	chaque côté peut changer une cellule ; un conflit suit la règle que vous choisissez (Synchroniser une base dans les deux sens)

Une source lue par une requête SQL ne sert qu'à Une fois et Miroir entrant. Un CSV ou un JSON publié aussi.

Les trois étapes

1. Connecteur et clé

Donnez un Nom de la synchro, choisissez d'où viennent les lignes, remplissez les champs du connecteur et sa clé (voir Connecteurs de bases externes pour créer une clé limitée). La clé rejoint le trousseau chiffré de ce profil (Paramètres → Intégrations → Trousseau), liée à l'hôte de la source : elle n'est jamais posée sur une autre adresse.

Tester la connexion liste les tables que la clé peut lire. Depuis le bureau, le test part de votre appareil ; depuis le web, il passe par le relais de Filarr. Si la source ne se lit pas d'ici, Décrire les colonnes à la main permet de continuer : l'exécutant les vérifie à son premier passage.

2. Colonnes

Clé de ligne : la colonne qui identifie une ligne, comme id. Elle retrouve la même ligne d'un passage à l'autre ; deux appareils qui importent la même source ne font pas de doublons. Sans clé de ligne, seul l'import ponctuel est possible.
Repère de changement : une colonne mise à jour à chaque modification, comme maj_le (une date, ou un nombre croissant). Il permet de ne relire que ce qui a changé. Sans repère, chaque passage relit tout.
Chaque colonne de la source va vers une Propriété dans Filarr, existante ou nouvelle, ou reste ignorée : une colonne ignorée n'est même pas demandée à la source. Les propriétés de Filarr que vous n'associez pas restent à vous : jamais écrasées, jamais envoyées.

Une colonne de relation de la source (Notion, enregistrements liés d'Airtable) ne s'importe pas encore : laissez-la ignorée.

3. Sens et fréquence

Dans quel sens ? : un des quatre sens ci-dessus.
Qui fait le travail ? :
- Cet appareil : seulement quand Filarr y est ouvert ; un passage manqué est rattrapé à l'ouverture.
- Ma boîte noire « … » : toujours, même la nuit. Elle joint aussi une base de votre réseau local, ce que Filarr ne peut pas. Il faut d'abord ouvrir cette base à une API en Lecture et écriture, puis donner la clé de la source à la boîte noire, chez vous.
- Le choix Une boîte hébergée par Filarr est affiché, mais pas encore disponible : la boîte hébergée est ouverte, mais elle ne fait pas encore tourner les synchros de bases externes.
Quand ? : toutes les 15 min, chaque heure, chaque jour, ou à la demande.
Une ligne disparaît de la source : La marquer « disparue » (barrée, vos colonnes gardées), La supprimer dans Filarr, ou La garder telle quelle. Quand la synchro suit un repère, une suppression dans la source ne se voit qu'à la relecture complète, faite environ une fois par jour (au premier passage après 24 heures, ou tous les 96 passages).
Une colonne apparaît dans la source : Me la proposer, ou L'ajouter, tenue par la source.
Pour la publication et les deux sens, Une ligne supprimée dans Filarr : La laisser dans la source, ou La supprimer aussi dans la source.

Cliquez sur Importer maintenant (une fois) ou Lancer la première synchro.

La définition de la synchro vit dans la base, chiffrée comme elle, et ne contient jamais de clé. Elle est signée par votre compte : si un autre membre la modifie, elle ne s'exécute plus tant que vous n'avez pas cliqué sur Approuver la modification.

Ce que vous voyez dans la base

En tête : Alimentée par le connecteur, par l'exécutant, puis l'état : « il y a 5 min · prochain passage à 14:30 », ou ce qui bloque. Lancer maintenant demande un passage tout de suite.
Une colonne remplie par la source porte un cadenas : « « Statut » vient de D1 : modifiez-le dans D1, ou faites-en une colonne à vous. » Pour la reprendre, modifiez la synchro et laissez sa colonne source ignorée.
Une base en miroir dit « Les lignes viennent de D1 » à la place de Nouvelle ligne.
Une ligne disparue de la source est barrée, avec « Disparue de D1 ».
Dans les deux sens, les conflits « Me demander » attendent : « 3 conflits à trancher. Ces cellules gardent leur valeur dans Filarr jusqu'à votre décision ; le reste se synchronise. »

Tous les membres de la base voient l'état, mais jamais la clé. Paramètres → Accès API → Synchronisations liste toutes vos bases alimentées : la source, le sens, la fréquence, qui l'exécute, le dernier passage et l'état.

Les garde-fous

Si plus de 20 % des lignes disparaissent d'un coup, ou si la source rend soudain zéro ligne, le passage s'arrête avant d'écrire quoi que ce soit : « Garde-fou : 1 102 lignes sur 1 284 ont disparu de D1 d'un coup. La synchro est arrêtée. Rien n'a été marqué ni supprimé dans Filarr. » Vérifiez la source : une fois ses lignes revenues, le passage suivant reprend normalement.
Trop de conflits d'un coup arrêtent aussi le passage : vérifiez le sens choisi et la clé de ligne.
Les écritures d'une boîte noire dans Filarr comptent dans la limite d'écritures de votre palier ; quand elle est épuisée, les changements attendent minuit UTC, rien n'est perdu.

Détacher

Détacher la base… arrête la synchro : les valeurs déjà dans Filarr restent et les colonnes redeviennent les vôtres. La clé reste au trousseau.

Pour aller plus loin

Synchroniser une base dans les deux sens
Connecteurs de bases externes
Les tutoriels D1 et PostgreSQL de la boîte noire : github.com/filarr-work/filarr-gate.