Cette fonction permet d'extraire les données d'une ou plusieurs tables d'un dossier X3, en créant des fichiers contenant la description de la table et les données stockées, dans un sous-répertoire du dossier (SVG par défaut). Il s'agit d'une extraction physique (un peu comparable à un export oracle, à ceci près que le fichier a un format qui n'est pas lié à une base de données et peut être utilisé pour des transferts entre bases). Pour chaque table XXX de la base, quatre à six fichiers sont créés :

  • un fichier XXX.dat, qui contient les données sous la forme d'un fichier constitué d'enregistrements en longueur fixe.
  • un fichier XXX.srf, qui contient la description de la structure du fichier (sous forme ascii).
  • un fichier XXX.fde, qui contient la description de la structure du fichier (sous forme compilée utilisable directement par le moteur adonix : ce fichier existe également dans le répertoire FIL du dossier).
  • un fichier XXX.seq, qui contient le prochain numéro de séquence associé à la table. Cette information est importante dans la mesure où chaque table est associée à un numéro de séquence qui permet de créer des numéros uniques (cela correspond à la fonction adonix uniqid([abv]), où abv est l'abréviation de la table correspondante).
  • un fichier XXX.blb, qui contient les données liées aux « blobs » (images) ou aux « clobs »  (textes) stockés dans la table s'il y en a.
  • un fichier XXX.cfg, qui contient des informations de configuration de la table dans la base de données. Ce fichier est optionnel, sa présence dépendant en particulier des options d'extraction prises. Pour plus d'informations sur la structure des fichiers de configuration, il est conseillé de consulter l'annexe technique correspondant.

Avertissement légal

Ce type de fonction est une fonction de développement dont l'utilisation est interdite dans le cadre d'une exploitation normale.

Les conséquences légales de l'utilisation d'outils de développements sur des bases de données contenant des données dont la loi interdit l'altération sont de l'entière responsabilité du client. Pour plus d'informations, consultez l'annexe correspondante.

Gestion de l'écran

Ecran de saisie

A l'entrée dans la fonction, on arrive dans un écran de saisie où l'on définit les données à extraire et les paramètres de cette extraction.

Le fait de valider déclenche la fonction. Un fichier trace est créé et visualisé pour permettre de connaître le résultat (et les erreurs éventuelles à l'extraction).

Bloc numéro 1

Dossier (champ DOSSIER)

Indiquez le code du dossier de travail, tel que défini dans la table des dossiers.
Historisé (champ HISTO)

Si le dossier dont on extrait des tables possède un dossier d'historisation, on peut choisir d'extraire les données de la table historique (en cochant la case) ou de la table du dossier d'exploitation (en ne la cochant pas).
Tables à sauvegarder (champ FICHIER)

Définit le nom de la table à extraire, ou un modèle caractérisant le nom des tables à extraire.

Si on désire par exemple extraire toutes les tables présentes dans le répertoire SVG, il suffit de taper * dans ce champ.
Volume de sauvegarde (champ STOVOL)

Bloc numéro 2

Copie fichiers de configuration (champ CFG)

Lorsque cette case est cochée, le fichier d'extension cfg présent dans le répertoire FIL est copié dans le répertoire d'extraction. Ce fichier contient des directives de configuration telles que la taille des extents. Sa structure est décrite dans une annexe.
Taille réelle dans srf (champ SIZ)

Lorsque cette case est cochée, le fichier d'extension srf, qui contient des éléments de dimensionnement de la table, est créé en tenant compte de la taille courante de la table, et non pas de la taille prévue à terme pour la table (telle qu'elle est définie par les variables et les formules de dimensionnement en gestion de dossier).

Utilisation pratique

Limites techniques

Cette fonction est liée au moteur adonix et non aux bases de données standard. En conséquence, elle ne doit pas non plus être utilisée dans le cadre d'une procédure habituelle de sauvegarde, dont elle ne possède pas les garanties de sécurité ni de performance. Une sauvegarde avec les outils standard de la base est fortement recommandée avant toute utilisation de ce type de fonction.

Parmi les limitations de ce type de fonction, il convient de noter que, si elle est lancée sur plusieurs tables de la base, elle peut conduire à une image de la base qui n'est pas globalement cohérente si des mises à jour ont lieu durant l'export (contrairement aux outils standard associées aux bases de données). Si on désire se servir de cette fonction pour extraire une telle image cohérente, il faut donc s'assurer que personne d'autre n'est connecté sur le dossier durant l'extraction.

Cas pratiques d'utilisation

Si on désire extraire une table pour en faire une sauvegarde temporaire afin de pouvoir la réintégrer à l'identique en cas de problème (par exemple,  après une tentative malheureuse de maintenance avant laquelle une sauvegarde de précaution avait été réalisée), il faut impérativement cocher la case Copie fichiers de configuration, et décocher la case Taille réelle dans le srf. Il s'agit en l'occurrence de la valeur par défaut proposée.

Si on désire par contre extraire les données de toute une base afin de permettre de les remonter dans un autre environnement, par exemple à des fins d'analyse, il faut décocher la case Copie fichiers de configuration pour ne pas avoir de contraintes impossibles à respecter lors de la réintégration. Il peut être intéressant à ce moment-là de cocher la case Taille réelle dans le srf. Ceci a pour conséquences de créer un fichier d'extension srf dimensionné à la taille réelle du dossier. On peut ainsi recharger les tables d'un dossier en minimisant la place physique nécessaire dans la base. Cette option est fortement recommandée si on veut se servir d'une telle extraction pour remonter le dossier à des fins d'analyse ou tout simplement de récupération d'un dossier de développement.

Tâche batch

Cette fonction peut être lancée en batch. La tâche standard DOSSVG est prévue à cet effet.

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Dossier XXX
Erreur d'accès sur la table AUTILIS
Fichier inexistant

Ce message d'erreur signifie que le dossier choisi n'a pas été créé, ou n'existe plus (en tout état de cause, la table des utilisateurs n'a pas été trouvée dans ce dossier).

Autres messages d'erreur

Lors de l'extraction, un fichier trace est créé. Des erreurs peuvent survenir durant l'opération elle-même : elles se présentent sous la forme d'une ligne d'erreur (en rouge) dans la trace, suivie éventuellement d'informations complémentaires.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre