Commandes de contrôle de scripts SQL (FireDAC)

De RAD Studio
Aller à : navigation, rechercher

Sommaire

Description

Commande Description
(@ | @@ | START | INput) <script> [<arguments>] Démarre l'exécution du script spécifié. '@@' exécute un script comportant un nom de fichier relatif au chemin du script parent. <arguments> est une liste de valeurs séparées par des virgules. S'il n'est pas spécifié, ce paramètre hérite des arguments du script parent.
ACCept (NUMber|CHAR|DATE) [FORmat <fmt>] [DEFault <déf>] [PROmpt '<invite>' | NOPRompt] [HIDE] Demande à l'utilisateur d'entrer une valeur de paramètre. NUMber|CHAR|DATE -- type de valeur facultative. FORmat <fmt> -- chaîne au format Delphi utilisée pour analyser les valeurs DATE. DEFault <déf> -- valeur par défaut, lorsqu'un utilisateur a entré une chaîne vide. PROmpt '<invite>' | NOPRompt -- invite de sortie vers la console.
CONnect <chaîne de connexion FireDAC> Etablit la connexion au SGBD spécifié - OpenConnection.
COPY FROM (FILE '<fichier>' | SQL '<sql>' [CONnect '<connexion>']) TO (FILE '<fichier>' | TABle '<nom table>' [CONnect '<connexion>']) [TRUNCate | CLEar | ALWAYSinsert | APPend | UPDate | APPENDUPDate | DELete] [LOG (OFF | (SPOol|OUTput) | ([APPend] <nom fichier journal>)] [USING (FILE 'fichier configuration' | PARAMS '<définition>')] Déplace des données entre des bases de données ou des fichiers texte. Dans ce cas :
  • FILE '<fichier>' -- nom d'un fichier contenant des données texte.
  • SQL '<sql>' -- commande SELECT ou nom de table de base de données.
  • TABle '<nom table>' -- nom d'une table de base de données.
  • CONnect '<connexion>' -- chaîne de connexion FireDAC.
  • TRUNcate -- tronque la table de base de données de destination avant le chargement des données.
  • CLEar -- efface la table de la base de données de destination avant le chargement des données.
  • ALWAYSinsert | APPend | UPDate | APPENDUPDate | DELete -- action à effectuer avec la table de base de données de destination.
  • USING PARAMS '<définition>' -- la définition est un composant TADDataMove sérialisé, car elle est stockée dans un DFM. Par exemple : "object TADDataMove TextFileName = 'Data.txt' LogFileName = 'Data.log' .... end".
  • USING FILE 'fichier de configuration' -- le fichier de configuration est un fichier externe, contenant un composant TADDataMove sérialisé.
DEFine [<nom> | <nom>=<valeur>] DEFINE sans nom -- imprime toutes les macros. DEFINE <nom> -- imprime la macro spécifiée. DEFINE <nom>=<valeur> -- définit la valeur de macro spécifiée.
DELIMiter <texte> Définit le séparateur de commande de script, ScriptOptions.CommandSeparator.
DISconnect Interrompt la connexion du SGBD en utilisant CloseConnection.
EXECute | CALL) <procédure> Exécute la procédure stockée spécifiée.
EXIT Interrompt l'exécution du script et valide les modifications.
QUIT Interrompt l'exécution du script et annule les modifications.
STOP Interrompt l'exécution du script.
HELP Affiche l'aide pour toutes les commandes recensées.
(HOst | !! | SHELL) <commande> Exécute la commande shell de l'hôte. Pour Windows, l'appel à ShellExecute('open', ACommand) est utilisé.
PAUse <invite> Imprime l'invite spécifiée et suspend l'exécution du script.
PROmpt <invite> Imprime le texte spécifié.
PRInt [..., <varN>] Imprime la valeur des paramètres spécifiés.
REMark <texte> Ajoute un commentaire au script.
SET ARRAY <valeur> Spécifie la taille de l'ensemble de lignes - FetchOptions.RowsetSize.
SET AUTOcommit OFF|ON|<valeur> Définit le mode Validation automatique sur Désactivé, Activé ou Valider toutes les N commandes - ScriptOptions.CommitEachNCommands.
SET AUTOPrint OFF|ON Affiche les valeurs de paramètres après l'exécution de la commande - ScriptOptions.AutoPrintParams.
SET BREAK OFF|ON Interrompt l'exécution du script en cas d'erreur - ScriptOptions.BreakOnError.
SET (CMDSeparator | TERMinator) <valeur> Spécifie les séparateurs des commandes - ScriptOptions.CommandSeparator. TERM est pour IB/FB uniquement.
SET (DEFine | SCAN) OFF|ON Contrôle le développement des macros - ScriptOptions.MacroExpand.
SET DROPnonexistent ON|OFF Permet de supprimer les objets non existants - ScriptOptions.DropNonexistObj.
SET ECHO OFF|(ON [SQL|ALL] [TRIM 50|<valeur>]) Envoie le texte des commandes avant de l'exécuter avec troncature facultative - ScriptOptions.EchoCommands, EchoCommandTrim.
SET ENCoding ANSI | UTF8 | UTF16 Définit le codage du script SQL et des fichiers journaux - ScriptOptions.FileEncoding.
SET (FEEDback|COUNT) 6|<valeur>|OFF|ON Envoie un commentaire après l'exécution de la commande - ScriptOptions.FeedbackCommands.
SET HEAding OFF|ON Envoie les noms des colonnes d'un ensemble de résultats - ScriptOptions.ColumnHeadings.
SET LINESize 0|<valeur> Définit la largeur de ligne - ScriptOptions.LineSize.
SET LONG 80|<valeur> Envoie le nombre maximal de caractères spécifiés pour une valeur caractère ou BLOB - ScriptOptions.MaxStringWidth.
SET PAGESize 24|<valeur> Définit la longueur de la page lors de l'impression d'un ensemble de résultats - ScriptOptions.PageSize.
SET PARAMARRAY 1|<valeur> Spécifie la taille du tableau de paramètres - ScriptOptions.ParamArraySize, Params.ArraySize.
SET SERVEROUTPUT OFF|(ON [SIZE <valeur>]) Affiche la sortie serveur après l'exécution de la commande - ResourceOptions.ServerOutput, ServerOutputSize.
SET (TERMout|CONsole) OFF|ON Active la sortie vers la console, notamment les ensembles de résultats des commandes, les valeurs des paramètres, les erreurs, etc - ScriptOptions.ConsoleOutput.
SET TIMing OFF|ON Envoie le délai d'exécution d'une commande - ScriptOptions.Timing.
SET TRIMout OFF|ON Supprime les espaces dans les chaînes lors de la sortie console - ScriptOptions.TrimConsole.
SET TRIMSpool ON|OFF Supprime les espaces dans les chaînes lors de la sortie de file d'attente - ScriptOptions.TrimSpool.
SET VERify OFF|ON Envoie la commande SQL avant l'exécution avec les macros remplacées - ScriptOptions.Verify.
(SPOol | OUTput) [OFF|[APPend] <nom file d'attente>] Sans arguments -- imprime le statut de la mise en file d'attente. OFF -- désactive la mise en file d'attente. <nom file d'attente> -- active la mise en file d'attente et la redirige vers le nom d'élément spécifié dans la collection SQLScripts ou vers un nom de fichier.
UNDEFine <var1> [..., <varN>] Annule la définition des macros spécifiées.
VARiable [<nom> (NUMber|CHAR|NCHAR [(<taille>)]] [TABle <taille>] [IN|OUT|INOUT] [=<valeur>] sans arguments -- imprime toutes les valeurs de paramètres. <nom> -- définit un paramètre avec le type de données, la taille et la direction spécifiés.

= <valeur> -- assigne une valeur au paramètre.

CREATE DATABASE <nom fichier bd> [PAGE_SIZE <n>] [DEFAULT CHARACTER SET '<jeu caractères>'] [USER '<utilisateur>'] [PASSWORD 'mot de passe'] Utilisé pour les connexions Firebird et InterBase afin de créer la base de données.
DROP DATABASE Utilisé pour les connexions Firebird et InterBase afin de supprimer la base de données.