Commande DEFINE TABLE DB

Définit une table de serveur Analytics en se connectant à une table de base de données à l'aide du Connecteur AX. Vous pouvez vous connecter à une base de données Microsoft SQL Server, Oracle ou DB2.

Syntaxe

DEFINE TABLE DB {SOURCE profil_base_données <PASSWORD num> <PASSWORD num> | SERVER profil_serveur <PASSWORD num>} <FORMAT nom_format> SCHEMA schéma <TITLED nom_table_acl> <PRIMARY|SECONDARY> DBTABLE nom_table_db FIELDS {noms_champs|ALL} <...n> <WHERE condition> <ORDER noms_champ>

Paramètres

SOURCE profil_base_données	Profil de base de données Analytics à utiliser pour accéder au moteur de base de données. Les profils de bases de données incluent les informations requises pour se connecter au moteur de base de données, par exemple : une référence au profil du serveur associé ; le type de base de données ; le nom de la base de données ; les informations du compte utilisateur. Remarque DEFINE TABLE DB prend en charge les connexions vers les bases de données suivantes uniquement : Microsoft SQL Server, Oracle ou DB2.
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 : Commande PASSWORD Commande SET Balise d'outil d'analyse PASSWORD Le mot de passe est uniquement requis si le profil de base de données ne contient aucun mot de passe enregistré. Utilisez PASSWORD deux fois après le mot-clé SOURCE. Le premier mot de passe vous connecte au serveur et le deuxième à la base de données.
SERVER profil_serveur	N'est plus utilisé. Avant la version 10.0 d'Analytics, était utilisé pour la connexion à ACL Édition Serveur pour z/OS. À compter de la version 10.0 d'Analytics, ACL Édition Serveur pour z/OS n'est plus inclus.
FORMAT nom_format optionnel	Le nom d'une table Analytics ou d'un fichier de format de table (.layout) avec le format de table que vous souhaitez utiliser.
SCHEMA schéma	Schéma auquel se connecter. Vous devez placer le nom de schéma entre guillemets.
TITLED nom_table_acl optionnel	Nom de la table Analytics à créer. nom_table_acl doit être une chaîne entre guillemets. Si vous ignorez TITLED, Analytics utilise le nom de table de la base de données. Lorsque vous accédez à plusieurs tables à la fois, Analytics utilise le nom de la première table.
PRIMARY \| SECONDARY optionnel	Utilisez la table en tant que table principale ou table secondaire dans les commandes multifichiers. Si aucune option n'est indiquée, la valeur par défaut PRIMARY est utilisée.
DBTABLE table_base_données	Table de base de données à laquelle vous souhaitez accéder. table_base_données doit être une chaîne entre guillemets.
FIELDS noms_champs \| ALL	Les champs à inclure dans la sortie : FIELDS noms_champ utilisez les champs spécifiés noms_champ doit être une chaîne entre guillemets. ALL utilisez tous les champs dans la table Pour utiliser les champs à partir de plusieurs tables : Saisissez le nom de la première table suivi par les champs de cette table. Saisissez le nom de la table suivante suivi par les champs de cette table. Pour chaque table supplémentaire, répétez l'étape b. DBTABLE "DSN1310" FIELDS "Champ_A Champ_B Champ_C" DBTABLE "DSN2516" FIELDS "Champ_L Champ_M Champ_N" Remarque Le Connecteur AX permet d'accéder à un nombre illimité de tables associées, mais nous recommandons de limiter ce nombre à cinq. La durée de traitement augmente lorsque vous accédez à plusieurs tables.
WHERE condition optionnel	Une instruction SQL WHERE qui limite les données aux enregistrements qui remplissent la condition indiquée. Vous devez utiliser une syntaxe SQL valide entrée en tant que chaîne entre guillemets. Lorsque vous joignez des tables, Analytics affiche la condition de jonction dans la clause WHERE : "Table_1.First_name = Table_2.First_name"
ORDER noms_champ optionnel	Les champs que le moteur de base de données utilise pour trier les enregistrements. noms_champ doit être une chaîne entre guillemets. L'exécution de la commande demande plus de temps lors du tri des enregistrements. Utilisez ORDER uniquement lorsque le tri est important.

Exemples

Exemple

Vous souhaitez accéder aux données à partir d'une base de données Microsoft SQL Server via le Connecteur AX. Pour ce faire, vous utilisez la commande DEFINE TABLE DB. Vous incluez le paramètre SOURCE pour vous connecter au Connecteur AX via un profil de base de données :

DEFINE TABLE DB SOURCE "Audit_ServeurSQL" SCHEMA "RH" TITLED "Paie" DBTABLE "RH.Employé" FIELDS "IDEmployé" DBTABLE "RH.HistoriquePaieEmployé" FIELDS "Taux FréquencePaie" WHERE "RH.Employé.IDEmployé=RH.HistoriquePaieEmployé.IDEmployé"

Remarques

Fonctionnement

La table de serveur Analytics est définie en tant que requête utilisant un profil de base de données pour se connecter à une table de base de données.

Supprimer la partie correspondant à l'heure des valeurs DateHeure

Préfacez la commande DEFINE TABLE DB avec la commande SET SUPPRESSTIME pour supprimer la portion correspondant à l'heure des valeurs DateHeure.

L'utilisation de SET SUPPRESSTIME ON est destinée aux scripts antérieurs à la version 10.0 d'Analytics qui supposent que la portion heure des valeurs DateHeure sera tronquée. Si SET SUPPRESSTIME ON n'est pas ajoutée à ces scripts, ils ne pourront pas s'exécuter dans la version avec DateHeure activée d'Analytics.

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