Commande IMPORT DELIMITED
Crée une table Analytics en définissant et en important un fichier texte délimité.
Syntaxe
IMPORT DELIMITED TO table nom_fichier_importation FROM nom_fichier_source <SERVER nom_profil> encodage_car_source SEPARATOR {car|TAB|SPACE} QUALIFIER {car|NONE} CONSECUTIVE STARTLINE numéro_ligne <KEEPTITLE> <CRCLEAR> <LFCLEAR> <REPLACENULL> <ALLCHAR> {ALLFIELDS|[syntaxe_champ] <...n> <IGNORE num_champ> <...n>}
syntaxe_champ ::= FIELD nom type AT position_départ DEC valeur WID octets PIC format AS nom_affichage
Paramètres
| Nom | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| TO table |
Nom de la table Analytics dans laquelle les données doivent être importées. Remarque La longueur des noms des tables est limitée à 64 caractères alphanumériques. 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. |
|||||||||||||||
|
nom_fichier_importation |
Nom du fichier de données Analytics à créer. Indiquez nom_fichier_importation sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple, "Factures.FIL". Par défaut, le fichier de données (.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 :
|
|||||||||||||||
|
FROM nom_fichier_source |
Nom du fichier de données source. nom_fichier_source doit être une chaîne entre guillemets. Si le fichier de données source n'est pas enregistré dans le même répertoire que le projet Analytics, vous devez utiliser un chemin d'accès absolu ou un chemin d'accès relatif pour indiquer l'emplacement du fichier :
|
|||||||||||||||
| SERVER nom_profil optionnel |
Le nom de profil AX Serveur qui contient les données que vous souhaitez importer. | |||||||||||||||
| encodage_car_source |
Jeu de caractères et encodage des données source. Selon l'édition d'Analytics que vous utilisez et selon l'encodage des données source, indiquez le code approprié :
|
|||||||||||||||
| SEPARATOR car | TAB | SPACE |
Le caractère de séparation (délimiteur) utilisé entre les champs dans les données source. Vous devez indiquer le caractère sous forme de chaîne entre guillemets. Vous pouvez indiquer une tabulation ou une espace comme séparateur en saisissant le caractère entre guillemets doubles ou en utilisant un mot clé :
|
|||||||||||||||
| QUALIFIER car | NONE |
Caractère d'identificateur de texte utilisé dans les données source pour renvoyer à la ligne et identifier des valeurs de champs. Vous devez indiquer le caractère sous forme de chaîne entre guillemets. Pour définir le caractère guillemet double comme identificateur de texte, placez le caractère à l'intérieur de guillemets simples : QUALIFIER '"'. Vous pouvez spécifier qu'il n'y a pas de qualificatif de texte à l'aide de l'une de ces deux méthodes :
|
|||||||||||||||
|
CONSECUTIVE optionnel |
Les identificateurs de texte consécutifs sont traités en tant qu'identificateur unique. |
|||||||||||||||
| STARTLINE numéro_ligne |
Ligne à laquelle les données commencent. Par exemple, si les quatre premières lignes de données contiennent des informations d'en-tête que vous ne souhaitez pas inclure, indiquez 5 pour numéro_ligne. |
|||||||||||||||
| KEEPTITLE optionnel |
Traitez le numéro de ligne spécifié par STARTLINE comme noms de champs plutôt que comme données. Si vous ignorez KEEPTITLE, les noms des champs génériques sont utilisés. Si vous spécifiez individuellement la syntaxe FIELD, FIELD nom est prioritaire sur les valeurs de la première ligne dans le fichier délimité. Dans cette situation, KEEPTITLE empêche l'importation des valeurs de la première ligne. |
|||||||||||||||
| CRCLEAR optionnel |
Remplace les caractères de retour chariot qui se trouvent entre les identificateurs de texte par des caractères espace. Vous devez indiquer QUALIFIER avec une valeur char pour utiliser CRCLEAR. Si vous utilisez CRCLEAR et LFCLEAR, c'est CRCLEAR qui doit apparaître en premier. |
|||||||||||||||
| LFCLEAR optionnel |
Remplace les caractères de saut de ligne qui se trouvent entre les identificateurs de texte par des caractères espace. Vous devez indiquer QUALIFIER avec une valeur char pour utiliser LFCLEAR. Si vous utilisez CRCLEAR et LFCLEAR, c'est CRCLEAR qui doit apparaître en premier. |
|||||||||||||||
| REPLACENULL optionnel |
Remplace les caractères NUL qui se trouvent dans le fichier délimité par des espaces. Le nombre de caractères NUL remplacés est enregistré dans la trace. |
|||||||||||||||
| ALLCHAR optionnel |
Le type de données caractère est automatiquement attribué à tous les champs importés. Astuce Affecter le type de données caractère à tous les champs importés simplifie le processus d'importation des fichiers texte délimités. Une fois que les données sont dans Analytics, vous pouvez affecter différents types (Numérique ou DateHeure par exemple) de données aux champs et en spécifier les informations de format. ALLCHAR s'avère utile si vous importez une table dans laquelle le type de données Numérique est affecté automatiquement aux champs des identificateurs par Analytics alors qu'en réalité, ils devraient utiliser le type de données Caractère. |
|||||||||||||||
| ALLFIELDS |
Tous les champs du fichier de données source sont importés. Pour obtenir des informations sur l'affectation des types de données par Analytics lorsque vous utilisez ALLFIELDS, consultez la section Remarques. Remarque Si vous spécifiez ALLFIELDS, n'indiquez aucune syntaxe FIELD individuelle ni IGNORE. |
|||||||||||||||
| FIELD nom type |
Les champs individuels à importer à partir du fichier de données source, y compris le nom et le type de données du champ. Pour empêcher l'importation d'un champ, ne l'indiquez pas. Pour plus d'informations sur le type, consultez la rubrique Identificateurs des types de données de champ. Remarque type est ignoré si vous spécifiez ALLCHAR. |
|||||||||||||||
| AT position_départ |
La position d'octet de départ du champ dans le fichier de données Analytics. Remarque
Dans Analytics Unicode, normalement vous devez indiquer une position d'octet de départ avec un nombre impair. Indiquer une position de départ avec un chiffre pair peut entraîner l'affichage incorrect des caractères. |
|||||||||||||||
| DEC valeur |
Nombre de décimales contenues par les champs numériques Remarque DEC est ignoré si vous spécifiez ALLCHAR. |
|||||||||||||||
| WID octets |
La longueur du champ en octets dans le format de la table Analytics. Remarque
Dans Analytics Unicode, spécifiez uniquement un nombre d'octets pair. Indiquer un nombre d'octets impair peut entraîner l'affichage incorrect des caractères. |
|||||||||||||||
| PIC format |
Remarque S'applique aux champs numériques ou DateHeure.
Le format doit être placé entre guillemets. Remarque PIC est ignoré si vous spécifiez ALLCHAR. |
|||||||||||||||
| AS nom_affichage |
Le nom d'affichage (titre de la colonne) pour le champ dans la vue dans la nouvelle table Analytics. 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. AS est requis lors de la définition de FIELD. Pour que le nom d'affichage soit identique au champ nom, saisissez une valeur nom_affichage vide à l'aide de la syntaxe suivante : AS "". Vérifiez qu'il n'y a aucune espace entre les deux guillemets doubles. |
|||||||||||||||
| IGNORE num_champ <...n> optionnel |
Exclut le champ du format de table. num_champ indique la position du champ dans les données source. Par exemple, IGNORE 5 exclut le cinquième champ des données de la source du format de la table Analytics. Remarque Les données du champ sont toujours importées, mais ne sont pas définies et ne s'affichent pas dans la nouvelle table Analytics. Les données peuvent être définies ultérieurement, si nécessaire, et ajoutées à la table. Pour exclure complètement un champ de l'importation, ne le spécifiez pas lorsque vous indiquez les champs individuellement. |
Exemples
Importer tous les champs
Vous importez tous les champs à partir d'un fichier délimité composé de valeurs séparées par des virgules dans une table Analytics appelée Employés. Le fichier utilise des guillemets doubles comme identificateur de texte. Les types de données sont affectés automatiquement en fonction de l'ensemble des règles décrites dans Remarques :
IMPORT DELIMITED TO Employés "Employés.fil" FROM "Employés.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLFIELDS
Importer tous les champs, affecter automatiquement un type de données caractère
Vous importez tous les champs à partir d'un fichier délimité composé de valeurs séparées par des virgules dans une table Analytics appelée Employés. Le fichier utilise des guillemets doubles comme identificateur de texte. Le type de données caractère est automatiquement attribué à tous les champs importés :
IMPORT DELIMITED TO Employés "Employés.fil" FROM "Employés.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR ALLFIELDS
Importer les champs spécifiés, affecter automatiquement un type de données caractère
Vous importez les champs spécifiés à partir d'un fichier délimité par des tabulations dans une table Analytics appelée Employés. Le fichier utilise des guillemets doubles comme identificateur de texte. Le type de données caractère est automatiquement attribué à tous les champs importés :
IMPORT DELIMITED TO Employés "Employés.fil" FROM "Employés.csv" 0 SEPARATOR TAB QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR FIELD "Prénom" C AT 1 DEC 0 WID 25 PIC "" AS "Prénom" FIELD "Nom" C AT 26 DEC 0 WID 25 PIC "" AS "Nom" FIELD "NumCarte" C AT 51 DEC 0 WID 16 PIC "" AS "Num Carte" FIELD "NoEmp" C AT 67 DEC 0 WID 6 PIC "" AS "No Emp" FIELD "DateEmb" C AT 73 DEC 0 WID 10 PIC "" AS "Date Emb" FIELD "Salaire" C AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bonus_2016" C AT 88 DEC 0 WID 10 PIC "" AS "Bonus 2016"
Importer les champs spécifiés, affecter individuellement des types de données
Vous importez les champs spécifiés depuis un fichier délimité par des points-virgules vers une table Analytics nommée Employés. Le fichier n'utilise aucun identificateur de texte. Vous spécifiez le type de données de chaque champ importé :
IMPORT DELIMITED TO Employés "Employés.fil" FROM "Employés.csv" 0 SEPARATOR ";" QUALIFIER "" CONSECUTIVE STARTLINE 1 KEEPTITLE FIELD "Prénom" C AT 1 DEC 0 WID 25 PIC "" AS "Prénom" FIELD "Nom" C AT 26 DEC 0 WID 25 PIC "" AS "Nom" FIELD "NumCarte" C AT 51 DEC 0 WID 16 PIC "" AS "Num Carte" FIELD "NoEmp" C AT 67 DEC 0 WID 6 PIC "" AS "No Emp" FIELD "DateEmb" D AT 73 DEC 0 WID 10 PIC "MM/DD/YYYY" AS "Date Emb" FIELD "Salaire" N AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bonus_2016" N AT 88 DEC 2 WID 10 PIC "" AS "Bonus 2016"
Remarques
Remarque
Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.
Méthode d'affectation des types de données par Analytics lorsque vous utilisez ALLFIELDS
Lorsque vous utilisez le paramètre ALLFIELDS, plutôt que de définir les champs individuellement, Analytics examine un sous-ensemble d'enregistrements au début du fichier délimité et affecte les types de données en fonction de l'ensemble des règles décrites ci-dessous.
Une fois que les données sont dans Analytics, vous pouvez affecter différents types (Numérique ou DateHeure par exemple) de données aux champs et en spécifier les informations de format.
| Description des valeurs des champs dans le fichier délimité | Exemples | Type de données affecté |
|---|---|---|
| Valeurs entourées de qualificatifs de texte | "Fournisseurs ABC" "6990,75" |
Caractère |
| Les valeurs incluent un caractère non numérique n'importe où dans le champ, à l'exception des virgules et des points utilisés comme séparateurs numériques et du signe négatif (-) | $995 (995) |
Caractère |
| Les valeurs incluent uniquement les nombres, les séparateurs numériques ou le signe négatif | 6990,75 -6990,75 995 |
Numérique |
| Une ou plusieurs valeurs vides se trouvent dans un champ | Caractère | |
| Les valeurs DateHeure avec des séparateurs ou les mois en lettres |
2016/12/31 31 déc 2016 |
Caractère |
| Valeurs DateHeure qui sont toutes des chiffres | 20161231 | Numérique |
Identificateurs des types de données de champ
Le tableau ci-dessous répertorie les lettres que vous devez utiliser lorsque vous indiquez type pour FIELD. Chaque lettre correspond à un type de données Analytics.
Par exemple, si vous définissez un champ Nom, qui requiert un type de données caractère, vous devez indiquer « C » : FIELD "Nom" C.
Pour obtenir plus d'informations, consultez la section Types de données Analytics.
Remarque
Lorsque vous utilisez l'Assistant de définition de données pour définir une table qui comprend des champs EBCDIC, Unicode ou ASCII, ces derniers se voient automatiquement attribuer la lettre « C » (pour le type CHARACTER).
Lorsque vous saisissez manuellement une instruction IMPORT ou que vous modifiez une instruction IMPORT existante, vous pouvez remplacer les lettres « E » ou « U » par des champs EBCDIC ou Unicode.
|
Lettre |
Type de données Analytics |
|---|---|
|
A |
ACL |
|
B |
BINARY |
|
C |
CHARACTER |
|
D |
DATETIME |
|
E |
EBCDIC |
|
F |
FLOAT |
|
G |
ACCPAC |
|
I |
IBMFLOAT |
|
K |
UNSIGNED |
|
L |
LOGICAL |
|
N |
|
|
P |
PACKED |
|
Q |
BASIC |
|
R |
MICRO |
|
S |
CUSTOM |
|
T |
PCASCII |
|
U |
UNICODE |
|
V |
VAXFLOAT |
|
X |
NUMERIC |
|
Y |
UNISYS |
|
Z |
ZONED |
Guide de création de scripts ACL 14.1