Commande EXTRACT

Concept Information

Extraction des données

Extraire et ajouter des données

Extrait des données d'une table Analytics et les sort dans une nouvelle table Analytics, ou les ajoute à une table Analytics existante. Vous pouvez extraire des enregistrements entiers ou des champs sélectionnés.

Syntaxe

EXTRACT {RECORD|FIELDS nom_champ <AS nouveau_nom_champ> <...n>|FIELDS ALL} <nom_table_associée.ALL <...n>> <EXCLUDE nom_champ <...n>> TO nom_table <LOCAL> <IF test> <WHILE test> <FIRST plage|NEXT plage> <EOF> <APPEND> <OPEN>

Paramètres

Nom Description
RECORD | FIELDS nom_champ | FIELDS ALL

Les champs à inclure dans la sortie :

  • RECORD utilisez l'intégralité de l'enregistrement dans le fichier de données source : tous les champs de la table et toutes les parties indéfinies de l'enregistrement

    Les champs sont utilisés dans leur ordre d'apparition dans le format de table.

    Conserve les champs calculés.

  • FIELDS nom_champ utilisez les champs spécifiés

    Les champs sont utilisés dans l'ordre dans lequel vous les indiquez.

    Pour utiliser un champ d'une table associée, préciseznom_table_associée.nom_champ.

    Convertit les champs calculés en champs physiques du type de données approprié dans la table de destination : ASCII ou Unicode (selon l'édition d'Analytics), ACL (type de données numérique natif), DateHeure ou Logique. Remplit les champs physiques avec les valeurs calculées réelles.

  • FIELDS ALL utilisez tous les champs dans la table

    Les champs sont utilisés dans leur ordre d'apparition dans le format de table.

    Convertit les champs calculés en champs physiques du type de données approprié dans la table de destination : ASCII ou Unicode (selon l'édition d'Analytics), ACL (type de données numérique natif), DateHeure ou Logique. Remplit les champs physiques avec les valeurs calculées réelles.
AS nouveau_nom_champ

optionnel

Valide uniquement dans le cas d'une extraction à l'aide de FIELDS nom_champ.

Nouveau nom physique et nom d'affichage (autre titre de la colonne) pour le champ dans la table de sortie.

Les caractères spéciaux ou les espaces que vous indiquez sont conservés dans le nom d'affichage et automatiquement convertis en traits de soulignement (_) dans le nom de champ physique dans le format de table.

Indiquez nouveau_nom_champ sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le nom d'affichage.

Remarque

AS fonctionne uniquement dans le cas de l'extraction dans une nouvelle table. Si vous effectuez un ajout dans une table existante, les noms de champ physique et les noms d'affichage de la table existante ont la priorité.
nom_table_associée.ALL

optionnel

Utilisez tous les champs dans la table associée spécifiée.
EXCLUDE nom_champ

optionnel

Valide uniquement dans le cas d'une extraction à l'aide de FIELDS ALL ou de nom_table_associée.ALL.

Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser le mot-clé ALL, en excluant les champs spécifiés.

EXCLUDE doit suivre immédiatement FIELDS ALL, ou la dernière occurrence du mot-clé ALL si vous incluez des champs d'une ou de plusieurs tables associées. Par exemple :

FIELDS ALL EXCLUDE champ_1 champ_2
FIELDS ALL nom_table_associée.ALL EXCLUDE champ_1 champ_2
TO nom_table

Emplacement vers lequel envoyer les résultats de la commande :

  • nom_table enregistre les résultats dans une table Analytics

    Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple : TO "Sortie.FIL"

    Par défaut, le fichier de données de table (.FIL) est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :

    • TO "C:\Sortie.FIL"
    • TO "Résultats\Sortie.FIL"

    Remarque

    La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

LOCAL

optionnel

Enregistre le fichier de sortie au même emplacement que le projet Analytics.

Remarque

Applicable uniquement lorsque vous exécutez la commande sur une table de serveur avec un fichier de sortie qui est une table Analytics.

Le paramètre LOCAL doit suivre immédiatement le paramètre TO.

IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).

WHILE test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte.

Remarque

Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage | NEXT plage

optionnel

Le nombre d'enregistrements à traiter :

  • FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint
  • NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint

Utilisez plage pour indiquer le nombre d'enregistrements à traiter.

Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.

EOF

optionnel

Réexécutez la commande une fois la fin du fichier atteinte.

Cela garantit que le dernier enregistrement de la table est traité quand il se trouve à l'intérieur d'une commande GROUP. Utilisez le paramètre de traitement de fin de fichier uniquement si tous les champs sont calculés en se référant à des enregistrements antérieurs.

APPEND

optionnel

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

OPEN

optionnel

Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie.

Exemples

Extraction de tous les enregistrements d'une table dans une nouvelle table

Vous créez un doublon exact de la table C_Client par l'extraction de tous les enregistrements dans une nouvelle table Analytics. Les champs calculés sont conservés comme champs calculés :

OPEN C_Client
EXTRACT RECORD TO "C_Client_2"

Extraction de tous les champs d'une table vers une nouvelle table

Vous extrayez tous les champs définis de la table C_Client vers une nouvelle table Analytics. Les champs calculés sont convertis en champs physiques et ils sont renseignés avec les valeurs calculées réelles :

OPEN C_Client
EXTRACT FIELDS ALL TO "C_Client_2"

Extraction de tous les enregistrements d'une table et concaténation de ces derniers dans une table existante

Vous extrayez tous les enregistrements dans la table C_Client et vous les concaténez comme un groupe à la fin de la table C_Client_Principal  :

OPEN C_Client
EXTRACT RECORD TO "C_Client_Principal" APPEND

Extraction de tous les enregistrements d'une table et concaténation de ces derniers dans une table existante d'un dossier différent

Vous extrayez tous les enregistrements dans la table C_Client et vous les concaténez comme un groupe à la fin de la table C_Client_Principal, qui est un dossier différent du dossier du projet Analytics :Analytics

OPEN C_Client
EXTRACT RECORD TO "C:\Utilisateurs\Données client\C_Client_Principal" APPEND

Extraction d'un sous-ensemble des champs d'une table vers une nouvelle table

Deux options s'offrent à vous lorsque vous extrayez un sous-ensemble de champs d'un tableau :

  • indiquer les champs individuels à extraire
  • indiquer FIELDS ALL et indiquer les champs à exclure de l'extraction

Astuce

Utilisez la méthode qui demande le moins de main-d’œuvre.

Les exemples ci-dessous renvoient à la table C_Client qui comporte 7 champs :

  • numéro de référence
  • numéro client
  • nom du client
  • type de transaction
  • date de facture
  • date d'échéance
  • montant de la facture

Indiquer les champs à extraire

Vous extrayez trois champs de la table C_Client vers une nouvelle table Analytics :Analytics

OPEN C_Client
EXTRAIRE FIELDS Date Échéance Nom TO "C_Dates_Client.fil"

Indiquer FIELDS ALL et indiquer les champs à exclure

Vous extrayez tous les champs sauf le champ Num_référence, de la table C_Client vers une nouvelle table Analytics :Analytics

OPEN C_Client
EXTRACT FIELDS ALL EXCLUDE Num_référence TO "C_Dates_Client.fil"

Créer des noms pour des champs extraits

Vous extrayez trois champs de la table C_Client et créez des noms physiques et des noms d'affichage pour les champs dans la nouvelle table Analytics :Analytics

OPEN C_Client
EXTRACT FIELDS Nom AS "Client;Nom" Due AS "Échéance;Date" Date AS "Facture;Date" TO "C_Dates_Client.fil"

Les points-virgules (;) entre les mots créent un saut de ligne dans les noms d'affichage. Les points-virgules sont automatiquement convertis en traits de soulignement (_) dans les noms de champ physiques.

Extraction de champs à partir d'une condition

Vous extrayez trois champs de la table C_Client vers une nouvelle table Analytics si la date dans la colonne Échéance est antérieure au 1er juillet 2014 :Analytics

OPEN C_Client
EXTRACT FIELDS Date Échéance Nom IF Échéance < `20140701` TO "Impayé.fil"

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez Extraction des données ou Extraction et ajout de données.

EXTRACT et copie d'une table

EXTRACT crée un nouveau fichier de données source (.fil) ainsi qu'un nouveau format de table.

Copier une table à l'aide du Navigateur (Modifier > Copier) crée un nouveau format de table restant associé avec le fichier de données source d'origine. Cela ne crée pas de nouveau fichier de données.