Commande IMPORT ODBC

Crée une table Analytics en définissant et en important des données à partir d'une source de données ODBC.

ODBC signifie « Open Database Connectivity », c'est une méthode standard d'accès aux bases de données.

Syntaxe

IMPORT ODBC SOURCE nom_source TABLE nom_table <QUALIFIER qualificatif_données> <OWNER nom_utilisateur> <USERID id_utilisateur> <PASSWORD num> <WHERE clause_where> <TO nom_table> <WIDTH longueur_champ_max> <MAXIMUM longueur_champ_max> <FIELDS champ <;...n>>

Paramètres

Nom Description
SOURCE nom_source

Nom de la source de données (DSN) ODBC à laquelle se connecter. Le DSN doit déjà exister et être configuré correctement.

Remarque

Vous êtes limité aux sources de données qui utilisent les pilotes ODBC Windows qui sont installés sur votre ordinateur. Les connecteurs de données Analytics natifs pouvant être utilisés avec la commande ACCESSDATA ne sont peut-être pas disponibles avec IMPORT ODBC.

TABLE nom_table

Nom de table de la source de données ODBC à partir de laquelle les données doivent être importées.

nom_table se rapporte généralement à une table de base de données dans les données sources, mais il peut renvoyer à tout élément importé en tant que table par Analytics. Par exemple, si vous utilisez Microsoft Text Driver, nom_table se rapporte au fichier texte à partir duquel vous souhaitez importer les données.

QUALIFIER qualificatif_données

optionnel

Caractère à utiliser en tant qu'identificateur de texte pour renvoyer à la ligne et identifier des valeurs de champs. Vous devez indiquer le caractère sous forme de chaîne entre guillemets.

Utilisez des guillemets simples pour spécifier le caractère guillemet double : '"'.

OWNER nom_utilisateur

optionnel

Nom du compte utilisateur de base de données propriétaire de la table à laquelle vous vous connectez.

USERID id_utilisateur

optionnel

Nom d'utilisateur permettant d'accéder à la source de données.

PASSWORD num

optionnel

Définition de mot de passe à utiliser.

Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD.

num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un outil d'analyse, PASSWORD 2 indique que le mot de passe n° 2 est utilisé.

Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques :

WHERE clause_where

optionnel

Instruction SQL WHERE limitant le nombre d'enregistrements renvoyé à partir d'un critère que vous spécifiez. Doit être une instruction SQL valide et doit être saisie sous forme de chaîne entre guillemets :

WHERE "SALARY > 50000".
TO nom_table

optionnel

Nom du fichier de données Analytics à créer.

Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple, TO "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 :

  • TO "C:\données\Factures.FIL"
  • TO "données\Factures.FIL".
WIDTH longueur_champ_max

optionnel

La longueur maximale en caractères d'un champ de la table Analytics qui provient d'une donnée de type caractère dans la source que vous importez.

Vous pouvez saisir une valeur comprise entre 1 et 254. La valeur par défaut est 50. Les données dépassant la longueur de champ maximale sont tronquées lors de l'importation dans Analytics.

MAXIMUM longueur_champ_max

optionnel

Longueur maximale en caractères des champs de texte, de commentaire ou mémo que vous importez.

Vous pouvez saisir une valeur comprise entre 1 et 1 100. La valeur par défaut est 100. Les données dépassant la longueur de champ maximale sont tronquées lors de l'importation dans Analytics.

FIELDS champ <;...n>

optionnel

Champs individuels dans les données source à importer. Indiquez le nom.

Si vous en indiquez plusieurs, chaque champ doit être séparé par une virgule. Si vous ignorez FIELDS, tous les champs sont importés.

Les noms de champ entre guillemets sont sensibles à la casse. Si vous utilisez des guillemets, la casse des noms de champ de FIELDS et de la source de données ODBC doit être identique. Si vous utilisez des guillemets et que la casse des noms est différente, les champs ne sont pas importés.

Remarque

FIELDS doit être placé en dernier dans les paramètres IMPORT ODBC. Si FIELDS n'est pas placé en dernier, la commande échoue.

Exemples

Importation de données à partir de SQL Server

Vous importez des données d'une base de données SQL Server vers une table Analytics appelée Trans_Déc11 :

IMPORT ODBC SOURCE "AuditServeurSQL" TABLE "Transactions" OWNER "audit" TO "C:\ACL DATA\Trans_Déc11.FIL" WIDTH 100 MAXIMUM 200 FIELDS "NUMCARTE","LIMCRED","NUMCLIENT","MONTECHU"

Remarques

Ancienne méthode de connexion aux sources de données ODBC

La commande IMPORT ODBC est l'ancienne méthode de connexion aux sources de données compatibles ODBC d'Analytics. La nouvelle méthode de connexion aux sources de données ODBC utilise la fenêtre Accès aux données et la commande ACCESSDATA.

Vous pouvez continuer à utiliser IMPORT ODBC dans Analytics. Toutefois, cette méthode de connexion est maintenant uniquement disponible dans les scripts et à partir de la ligne de commande Analytics. Vous ne pouvez plus accéder à cette méthode de connexion dans l'Assistant de définition de données.

Supprimer la partie correspondant à l'heure des valeurs DateHeure

Lorsque vous utilisez la commande IMPORT ODBC pour définir une table Analytics, vous pouvez supprimer la portion correspondant à l'heure des valeurs DateHeure en préfaçant la commande avec la commande SET SUPPRESSTIME ON.

Cette fonctionnalité permet de réintégrer des scripts Analytics écrits avant la version 10.0 d'Analytics, lorsque la partie correspondant à l'heure des valeurs DateHeure était tronquée automatiquement. Si SET SUPPRESSTIME ON n'est pas ajoutée à ces scripts, ils ne s'exécuteront pas dans la version avec DateHeure activée d'Analytics.

Pour plus d'informations, consultez la rubrique "SET SUPPRESSTIME" dans Commande SET.