Commande EXTRACT

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 nom_affichage> <...n>|FIELDS ALL}  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. 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 nom_affichage optionnel	Utilisé uniquement dans le cas d'une extraction à l'aide de FIELDS nom_champ. Le nom d'affichage (titre de la colonne) pour le champ dans la vue dans la nouvelle table Analytics. Si vous souhaitez que le nom d'affichage soit identique au nom du champ ou à un nom d'affichage existant dans la table source, n'utilisez pas AS. Indiquez le nom_affichage 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 titre de la colonne. Remarque AS fonctionne uniquement dans le cas de l'extraction dans une nouvelle table. Si vous effectuez un ajout dans une table existante, les autres titres de colonne de la table existante ont la priorité.
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 :

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

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

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

Création de noms d'affichage pour des champs extraits

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

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

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 :

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

Remarques

Remarque

Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.

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.