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. |