Fichiers (SFTP ou S3)

Vous exportez des fichiers et les livrez selon un planning vers SFTP ou S3. Athia fournit la destination, la spécification du format et la validation.

• À qui appartient-il de votre côté : votre équipe de données. Ils exportent à partir des systèmes d'enregistrement et planifient la livraison.
• Ce qu'Athia vous apporte : la destination SFTP ou S3 et les informations d'identification, la spécification du champ (voir Dictionnaire de données Athia), et un rapport de validation sur chaque livraison répertoriant les lignes rejetées, les champs obligatoires manquants et les incohérences de type, vérifié par rapport au mappage convenu pour votre compte plutôt que par rapport aux noms de colonnes fixes, afin que vous puissiez corriger l'exportation avant la prochaine exécution.
• Cadence : quotidien est typique de l’alimentation récurrente. Faites-le correspondre à la fréquence de fermeture de vos systèmes sources.
• Formats : Le parquet Apache est préférable. Gzip CSV, JSON Lines ou l'accès direct aux tables et aux vues fonctionnent également.
• Granularité des fichiers : un fichier par source et par mois, environ un gigaoctet par fichier, divisé s'il est plus volumineux.
• Un effort ponctuel : l'export historique se fait une seule fois. Une fois la connexion en direct établie, aucune mise à jour manuelle continue n'est nécessaire.

Le remplissage et l'alimentation récurrente utilisent le même chemin et la même spécification.

Livraison via SFTP#

SFTP est le bon choix pour l’historique en masse et pour les flux qui n’ont pas besoin d’arriver en quelques secondes.

Obtenir l'accès

Demandez à votre équipe Athia d'ouvrir un compte SFTP. Vous échangez des clés publiques, et elles renvoient l'hôte, le nom d'utilisateur et les répertoires de téléchargement et de réception de votre compte. Il n'y a pas de mot de passe.

Nommer vos fichiers

Commencez chaque nom de fichier par le type de données qu'il contient. Athia route sur ce préfixe, donc un fichier mal nommé est un fichier mal acheminé.

• transactions_2026-05-18_01.parquet
• costs_2026-05-18_01.parquet
• subscriptions_2026-05-18_01.parquet

Tout ce qui se trouve après le préfixe vous appartient : un horodatage, un système source, un numéro de pièce.

Téléchargement et lecture du reçu

1. Connectez-vous avec l'hôte et le nom d'utilisateur qui vous ont été attribués.
2. Déposez vos fichiers dans le répertoire de téléchargement.
3. Lisez le reçu dans le répertoire des reçus sur le même serveur.

Athia rédige un reçu pour chaque fichier traité, nommant les lignes rejetées, les champs obligatoires manquants et les incohérences de type. Corrigez l'exportation plutôt que le fichier, sinon la prochaine exécution planifiée répétera le problème.