Anweisungen zur Steuerung von SQL-Skripten (FireDAC)
Inhaltsverzeichnis
Beschreibung
Anweisung | Beschreibung |
---|---|
(@ | @@ | START | INput) <Skript> [<Argument>] | Startet die Ausführung des angegebenen Skripts. "@@" führt ein Skript mit einem Dateinamen relativ zum übergeordneten Skriptpfad aus. <Argumente> ist eine durch Komma getrennte Liste mit Werten. Wenn nicht angegeben, werden die übergeordneten Argumente geerbt. |
ACCept (NUMber|CHAR|DATE) [FORmat <Fmt>] [DEFault <Def>] [PROmpt '<Aufford>' | NOPRompt] [HIDE] | Fordert den Benutzer zur Eingabe eines Parameterwertes auf. NUMber|CHAR|DATE – optionaler Werttyp. FORmat <Fmt> – Delphi-Format-String für die Analyse der DATE-Werte. DEFault <Def> – Vorgabewert, wenn der Benutzer einen leeren String eingibt. PROmpt '<Aufford>' | NOPRompt – Eingabeaufforderung auf der Konsole. |
CONnect <FireDAC-Verbindungsstring> | Stellt die Verbindung mit dem angegebenen DBMS her – OpenConnection. |
COPY FROM (FILE '<Datei>' | SQL '<Sql>' [CONnect '<Verbindung>']) TO (FILE '<Datei>' | TABle '<Tabellenname>' [CONnect '<Verbindung>']) [TRUNCate | CLEar | ALWAYSinsert | APPend | UPDate | APPENDUPDate | DELete] [LOG (OFF | (SPOol|OUTput) | ([APPend] <Protokolldateiname>)] [USING (FILE 'Konfig-Datei' | PARAMS '<Definition>')] | Verschiebt Daten zwischen Datenbanken oder Textdateien. Die Parameter haben folgende Bedeutung:
|
DEFine [<Name> | <Name>=<Wert>] | DEFINE ohne Name – gibt alle Makros aus. DEFINE <Name> – gibt das angegebene Makro aus. DEFINE <Name>=<Wert> – legt den angegebenen Makrowert fest. |
DELIMiter <Text> | Legt das Skript-Anweisungstrennzeichen fest – ScriptOptions.CommandSeparator. |
DISconnect | Hebt die Verbindung zum DBMS mit CloseConnection auf. |
EXECute | CALL) <Prozedur> | Führt die angegebene gespeicherte Prozedur aus. |
EXIT | Hält die Skriptausführung an und übergibt die Änderungen. |
QUIT | Hält die Skriptausführung an und setzt die Änderungen zurück. |
STOP | Hält die Skriptausführung an. |
HELP | Zeigt die Hilfe für alle registrierten Anweisungen an. |
(HOst | !! | SHELL) <Anweisung> | Führt die Host-Shell-Anweisung aus. Für Windows wird der Aufruf ShellExecute('open', ACommand) verwendet. |
PAUse <Aufford> | Gibt die angegebene Aufforderung aus und unterbricht die Skriptausführung. |
PROmpt <Aufford> | Gibt den angegebenen Text aus. |
PRInt <Var1> [..., <VarN>] | Gibt den Wert des angegebenen Parameters aus. |
REMark <Text> | Fügt dem Skript einen Kommentar hinzu. |
SET ARRAY <Wert> | Legt die Größe des Rowsets fest – FetchOptions.RowsetSize. |
SET AUTOcommit OFF|ON|<Wert> | Setzt den Modus von "Autocommit" auf OFF, ON oder auf einen Wert zur Übergabe von Anweisungen – ScriptOptions.CommitEachNCommands. |
SET AUTOPrint OFF|ON | Zeigt nach der Anweisungsausführung die Parameterwerte an – ScriptOptions.AutoPrintParams. |
SET BREAK OFF|ON | Hält die Skriptausführung bei einem Fehler an – ScriptOptions.BreakOnError. |
SET (CMDSeparator | TERMinator) <Wert> | Legt die Anweisungstrennzeichen fest – ScriptOptions.CommandSeparator. TERM ist nur für IB/FB zulässig. |
SET (DEFine | SCAN) OFF|ON | Steuert die Makroerweiterung – ScriptOptions.MacroExpand. |
SET DROPnonexistent ON|OFF | Ermöglicht das Entfernen von nicht vorhandenen Objekten – ScriptOptions.DropNonexistObj. |
SET ECHO OFF|(ON [SQL|ALL] [TRIM 50|<Wert>]) | Gibt den Anweisungstext vor dessen Ausführung mit optionalen Anpassungen (Entfernen von Leerzeichen) aus – ScriptOptions.EchoCommands, EchoCommandTrim. |
SET ENCoding ANSI | UTF8 | UTF16 | Legt die Codierung für das SQL-Skript und die Protokolldateien fest – ScriptOptions.FileEncoding. |
SET (FEEDback|COUNT) 6|<Wert>|OFF|ON | Gibt die Rückmeldung nach der Anweisungsausführung aus – ScriptOptions.FeedbackCommands. |
SET HEAding OFF|ON | Gibt die Spaltennamen für eine Ergebnismenge aus – ScriptOptions.ColumnHeadings. |
SET LINESize 0|<Wert> | Legt die Zeilenbreite fest – ScriptOptions.LineSize. |
SET LONG 80|<Wert> | Gibt bis zur angegebenen Anzahl Zeichen für einen Zeichen- oder BLOB-Wert aus – ScriptOptions.MaxStringWidth. |
SET PAGESize 24|<Wert> | Legt beim Drucken einer Ergebnismenge die Seitenlänge fest – ScriptOptions.PageSize. |
SET PARAMARRAY 1|<Wert> | Legt die Größe eines Parameter-Arrays fest – ScriptOptions.ParamArraySize, Params.ArraySize. |
SET SERVEROUTPUT OFF|(ON [SIZE <Wert>]) | Zeigt die Serverausgabe nach einer Anweisungsausführung an – ResourceOptions.ServerOutput, ServerOutputSize. |
SET (TERMout|CONsole) OFF|ON | Aktiviert die Ausgabe auf der Konsole, einschließlich von Ergebnismengen, Parameterwerten, Status, Fehler usw. – ScriptOptions.ConsoleOutput. |
SET TIMing OFF|ON | Gibt die Zeit für eine Anweisungsausführung aus – ScriptOptions.Timing. |
SET TRIMout OFF|ON | Entfernt für die Konsolenausgabe Leerzeichen aus Strings – ScriptOptions.TrimConsole. |
SET TRIMSpool ON|OFF | Entfernt für die Spool-Ausgabe Leerzeichen aus Strings – ScriptOptions.TrimSpool. |
SET VERify OFF|ON | Gibt die SQL-Anweisung vor der Ausführung mit eingesetzten Makros aus – ScriptOptions.Verify. |
(SPOol | OUTput) [OFF|[APPend] <Spool-Name>] | Ohne Argumente – druckt den Spooling-Status. OFF – deaktiviert das Spooling. <Spool-Name> – aktiviert das Spooling und leitet es an den angegebenen Elementnamen in der SQLScripts-Sammlung oder an einen Dateinamen weiter. |
UNDEFine <Var1> [..., <VarN>] | Hebt die Definition von angegebenen Makros auf. |
VARiable [<Name> (NUMber|CHAR|NCHAR [(<Größe>)]] [TABle <Größe>] [IN|OUT|INOUT] [=<Wert>] | Ohne Argumente – gibt alle Parameterwerte aus. <Name> – definiert einen Parameter mit dem angegebenen Datentyp, der Größe und Richtung.
= <Wert> – weist einem Parameter einen Wert zu. |
CREATE DATABASE <DB-Dateiname> [PAGE_SIZE <n>] [DEFAULT CHARACTER SET '<Zeichensatz>'] [USER '<Benutzer>'] [PASSWORD 'Pwt'] | Wird für Firebird- und InterBase-Verbindungen zum Erstellen einer Datenbank verwendet. |
DROP DATABASE | Wird für Firebird- und InterBase-Verbindungen zum Entfernen einer Datenbank verwendet. |