osql (Dienstprogramm)

Das Dienstprogramm osql ermöglicht es Ihnen, Transact-SQL-Anweisungen, Systemprozeduren und Skriptdateien einzugeben. Dieses Dienstprogramm verwendet ODBC, um Daten mit dem Server auszutauschen.

Wichtig:
Dieses Feature wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Vermeiden Sie die Verwendung dieses Features bei neuen Entwicklungsarbeiten, und planen Sie die Änderung von Anwendungen, die dieses Feature zurzeit verwenden. Verwenden Sie stattdessen sqlcmd. Weitere Informationen finden Sie unter sqlcmd (Dienstprogramm).

Syntax

osql
[-?] |
[-L] |
[
  {
     {-Ulogin_id [-Ppassword]} | –E }
     [-Sserver_name[\instance_name]] [-Hwksta_name] [-ddb_name]
     [-ltime_out] [-ttime_out] [-hheaders]
     [-scol_separator] [-wcolumn_width] [-apacket_size]
     [-e] [-I] [-D data_source_name]
     [-ccmd_end] [-q "query"] [-Q"query"]
     [-n] [-merror_level] [-r {0 | 1}]
     [-iinput_file] [-ooutput_file] [-p]
     [-b] [-u] [-R] [-O]
]

Argumente

• -?
  Zeigt eine Syntaxzusammenfassung der osql-Schalter an.

• -L
  Listet die lokal konfigurierten Server sowie die Namen der Server auf, die Nachrichten über das Netzwerk senden.

  Hinweis:
  Aufgrund der Eigenarten des Broadcastings in Netzwerken ist es möglich, dass sqlcmd nicht von allen Servern rechtzeitig eine Antwort empfängt. Aus diesem Grund kann die Liste der zurückgegebenen Server mit jedem Aufruf dieser Option variieren.

• -Ulogin_id
  Die Benutzeranmelde-ID. Bei Anmelde-IDs wird nach Groß- und Kleinschreibung unterschieden.

• -P password
  Ein vom Benutzer angegebenes Kennwort. Wenn die Option -P nicht verwendet wird, fordert osql zur Eingabe eines Kennwortes auf. Wenn die Option -P am Ende der Befehlszeile ohne Angabe eines Kennwortes verwendet wird, verwendet osql das Standardkennwort (NULL).

  Sicherheitshinweis:
  Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort. Weitere Informationen finden Sie unter Sichere Kennwörter.

  Bei Kennwörtern wird nach Groß- und Kleinschreibung unterschieden.

  Über die OSQLPASSWORD-Umgebungsvariable können Sie ein Standardkennwort für die aktuelle Sitzung festlegen. Dadurch müssen Sie keine Kennwörter in Batchdateien hartcodieren.

  Wenn Sie kein Kennwort mit der Option -P angeben, überprüft osql zuerst die OSQLPASSWORD-Variable. Wurde kein Wert festgelegt, verwendet osql das Standardkennwort (NULL). Im folgenden Beispiel wird die OSQLPASSWORD-Variable an der Eingabeaufforderung festgelegt und dann auf das Dienstprogramm osql zugegriffen:

  C:\>SET OSQLPASSWORD=abracadabra
  C:\>osql 
  

  Sicherheitshinweis:
  Zum Maskieren des Kennwortes sollten Sie die Option -P nicht in Verbindung mit der Option -U verwenden. Drücken Sie stattdessen nach der Angabe von osql mit der Option -U und anderen Schaltern (geben Sie -P nicht an) die EINGABETASTE. Sie werden daraufhin von osql zur Angabe eines Kennwortes aufgefordert. Durch diese Methode ist sichergestellt, dass das Kennwort bei der Eingabe maskiert wird.

• -E
  Verwendet eine vertrauenswürdige Verbindung, statt ein Kennwort anzufordern.

• -S server_name[ **\instance_name]
  Gibt die Microsoft SQL Server-Instanz an, mit der eine Verbindung hergestellt wird. Geben Sie server_name an, um eine Verbindung mit der Standardinstanz von SQL Server auf diesem Server herzustellen. Geben Sie server_name\**instance_name an, um eine Verbindung mit einer benannten Instanz von SQL Server auf diesem Server herzustellen. Wenn kein Server angegeben wird, stellt osql eine Verbindung mit der Standardinstanz von SQL Server auf dem lokalen Computer her. Diese Option ist erforderlich, wenn osql von einem Remotecomputer im Netzwerk ausgeführt wird.

• -H wksta_name
  Der Name einer Arbeitsstation. Dieser Name ist in sysprocesses.hostname gespeichert und wird mithilfe von sp_who angezeigt. Wenn diese Option nicht angegeben ist, wird der Name des aktuellen Computers angenommen.

• -d db_name
  Gibt die USE db_name-Anweisung aus, wenn osql gestartet wird.

• -ltime_out
  Gibt an, nach wie vielen Sekunden ein Timeout bei der osql-Anmeldung auftritt. Der Standardwert für das Timeout eines osql-Anmeldevorgangs ist acht Sekunden.

• -t time_out
  Gibt an, nach wie vielen Sekunden der Befehl wegen eines Timeout abgebrochen wird. Wenn time_out nicht angegeben wird, tritt für den Befehl kein Timeout auf.

• -h headers
  Gibt die Anzahl der Zeilen an, die zwischen den Spaltenüberschriften gedruckt werden. Standardmäßig werden die Überschriften für jedes Resultset der Abfrage einmal gedruckt. Mit -1 können Sie angeben, dass keine Überschriften gedruckt werden sollen. Wenn -1 verwendet wird, darf zwischen dem Parameter und der Einstellung kein Leerzeichen stehen (d. h. -h-1 und nicht -h -1).

• -s col_separator
  Gibt das Spaltentrennzeichen an. Standardmäßig wird ein Leerzeichen verwendet. Um Zeichen verwenden zu können, die für das Betriebssystem eine besondere Bedeutung haben (z. B. | ; & < >), müssen Sie das Zeichen in doppelte Anführungszeichen (") setzen.

• -w column_width
  Ermöglicht dem Benutzer, die Bildschirmbreite für die Ausgabe festzulegen. Die Standardeinstellung ist 80 Zeichen. Wenn eine Ausgabezeile die maximale Bildschirmbreite erreicht hat, wird die Zeile umbrochen.

• -apacket_size
  Ermöglicht es Ihnen, Pakete mit einer anderen Größe anzufordern. Die gültigen Werte für packet_size reichen von 512 bis 65535. Der Standardwert für osql ist der Standardwert des Servers. Ein höherer Wert für die Paketgröße kann das Leistungsverhalten beim Ausführen von größeren Skripts verbessern, die eine große Anzahl von SQL-Anweisungen zwischen GO-Befehlen aufweisen. Von Microsoft durchgeführte Tests zeigen an, dass 8192 in der Regel die schnellste Einstellung für Massenkopiervorgänge ist. Ein höherer Wert für die Paketgröße kann angefordert werden; osql verwendet jedoch standardmäßig den Standardwert des Servers, wenn der Anforderung nicht entsprochen werden kann.

• -e
  Bewirkt, dass die Eingabe auf dem Bildschirm angezeigt wird.

• -I
  Aktiviert die QUOTED_IDENTIFIER-Verbindungsoption.

• -Ddata_source_name
  Stellt eine Verbindung mit einer ODBC-Datenquelle her, die so definiert ist, dass sie den ODBC-Treiber für Microsoft SQL Server verwendet. Die osql-Verbindung verwendet die Optionen, die in der Datenquelle angegeben sind.

  Hinweis:
  Diese Option kann nicht mit Datenquellen verwendet werden, die für andere Treiber definiert sind.

• -c cmd_end
  Gibt das Befehlsabschlusszeichen an. Standardmäßig werden Befehle abgeschlossen und an SQL Server gesendet, indem Sie GO in eine eigene Zeile eingeben. Wenn Sie das Befehlsabschlusszeichen neu festlegen, dürfen Sie keine für Transact-SQL reservierten Wörter oder Zeichen verwenden, die eine spezielle Bedeutung für das Betriebssystem haben, unabhängig davon, ob vor einem Wort bzw. Zeichen ein umgekehrter Schrägstrich steht.

• -q "query"
  Führt eine Abfrage aus, wenn osql startet, beendet osql aber nicht, nachdem die Abfrage abgeschlossen ist. (Beachten Sie, dass die Abfrageanweisung keinen GO-Befehl enthalten darf.) Wenn Sie eine Abfrage aus einer Batchdatei ausgeben, können Sie Variablen (%Variable) oder Umgebungsvariablen (%Umgebungsvariable%) verwenden. Beispiel:

  SET table=sys.objects
  osql -E -q "select name, object_id from %table%"
  

  Schließen Sie die Abfrage in doppelte Anführungszeichen und alle Elemente, die in die Abfrage eingebettet sind, in einfache Anführungszeichen ein.

• -Q"query"
  Führt eine Abfrage aus und beendet osql sofort. Schließen Sie die Abfrage in doppelte Anführungszeichen und alle Elemente, die in die Abfrage eingebettet sind, in einfache Anführungszeichen ein.

• -n
  Entfernt die Nummerierung und das Symbol für die Eingabeaufforderung (>) aus den Eingabezeilen.

• -m error_level
  Passt die Anzeige der Fehlermeldungen an. Für jeden Fehler mit dem angegebenen oder einem höheren Schweregrad wird die Meldungsnummer, der Status und der Fehlergrad angezeigt. Für Fehler mit einem niedrigeren ist als dem angegebenen Schweregrad wird nichts angezeigt. Mit -1 können Sie angeben, dass alle Header mit Meldungen zurückgegeben werden. Dies gilt auch für Informationsmeldungen. Wenn Sie -1 verwenden, darf kein Leerzeichen zwischen dem Parameter und der Einstellung stehen (d. h. -m-1 und nicht -m -1).

• -r { 0| 1}
  Leitet die Meldungsausgabe auf den Bildschirm um (stderr). Wenn Sie keinen Parameter oder 0 angeben, werden nur Fehlermeldungen umgeleitet, deren Schweregrad 11 oder höher ist. Wenn Sie 1 angeben, werden alle Meldungsausgaben (einschließlich der Ausgabe von "print") umgeleitet.

• -i input_file
  Identifiziert die Datei, die einen Batch mit SQL-Anweisungen oder gespeicherten Prozeduren enthält. Anstelle von -i kann der Kleiner-als-Vergleichsoperator (<) verwendet werden.

• -o output_file
  Identifiziert die Datei, in die die Ausgabe von osql geschrieben wird. Anstelle von -o kann das Größer-als-Zeichen (>) verwendet werden.

  Wenn input_file nicht das Unicode-Format aufweist und -u nicht angegeben ist, wird output_file im OEM-Format gespeichert. Wenn input_file das Unicode-Format aufweist oder -u angegeben ist, wird output_file im Unicode-Format gespeichert.

• -p
  Druckt die Leistungsstatistik.

• -b
  Gibt an, dass osql beendet und ein DOS ERRORLEVEL-Wert zurückgegeben wird, wenn ein Fehler auftritt. Für die DOS ERRORLEVEL-Variable wird der Wert 1 zurückgegeben, wenn die SQL Server-Fehlermeldung einen Schweregrad von 11 oder höher hat. Andernfalls wird der Wert 0 zurückgegeben. Microsoft MS-DOS-Batchdateien können den Wert von DOS ERRORLEVEL testen und den Fehler entsprechend behandeln.

• -u
  Gibt an, dass output_file unabhängig vom Format von input_file im Unicode-Format gespeichert wird.

• -R
  Gibt an, dass der SQL Server-ODBC-Treiber Clienteinstellungen verwendet, wenn Währungs-, Datums- oder Zeitdaten in Zeichendaten konvertiert werden.

• -O
  Gibt an, dass bestimmte osql-Funktionen deaktiviert werden, damit osql mit dem Verhalten früherer isql-Versionen übereinstimmt. Die folgenden Funktionen werden deaktiviert:

  • EOF-Batchverarbeitung
  • Automatisches Skalieren der Konsolenbreite
  • Ausführliche Meldungen

  Außerdem wird der Standardwert von DOS ERRORLEVEL auf -1 festgelegt.

Hinweis:
Die Optionen -n, -O und -D werden von osql nicht mehr unterstützt.

Hinweise

Das Dienstprogramm osql wird direkt von der Betriebssystemebene aus mit den hier aufgelisteten Optionen gestartet, wobei für die Optionen zwischen Groß- und Kleinschreibung unterschieden wird. Nachdem osql gestartet wurde, akzeptiert das Dienstprogramm SQL-Anweisungen und sendet diese interaktiv an SQL Server. Die Ergebnisse werden formatiert und auf dem Bildschirm angezeigt (stdout). Verwenden Sie QUIT oder EXIT zum Beenden von osql.

Wenn Sie beim Starten von osql keinen Benutzernamen angeben, überprüft SQL Server die Umgebungsvariablen und verwendet die dort definierten Informationen, z. B. osqluser=(user) oder osqlserver=(server). Wenn keine Umgebungsvariablen festgelegt sind, wird der Benutzername der Arbeitsstation verwendet. Wenn Sie keinen Server angeben, wird der Name der Arbeitsstation verwendet.

Wenn weder die Option -U noch die Option -P verwendet wird, versucht SQL Server, die Verbindung mithilfe des Microsoft Windows-Authentifizierungsmodus herzustellen. Die Authentifizierung basiert auf dem Microsoft Windows-Konto des Benutzers, der das Dienstprogramm osql ausführt.

Das Dienstprogramm osql verwendet die ODBC-API. Das Dienstprogramm verwendet die Standardeinstellungen des SQL Server-ODBC-Treibers für die SQL-92-Verbindungsoptionen in SQL Server. Weitere Informationen finden Sie im Thema zu den Effekten der SQL-92-Optionen.

Hinweis:
Das Dienstprogramm osql bietet keine Unterstützung für benutzerdefinierte CLR-Datentypen. Zum Verarbeiten dieser Datentypen müssen Sie das Dienstprogramm sqlcmd verwenden. Weitere Informationen finden Sie unter sqlcmd (Dienstprogramm).

OSQL-Befehle

Zusätzlich zu den Transact-SQL-Anweisungen in osql sind auch die folgenden Befehle verfügbar:

Befehl	Beschreibung
GO	Führt alle Anweisungen aus, die nach dem letzten GO-Befehl eingegeben wurden.
RESET	Löscht alle Anweisungen, die Sie eingegeben haben.
QUIT oder EXIT( )	Beendet osql.
STRG+C	Beendet eine Abfrage, ohne osql zu beenden.

Hinweis:
Die Befehle !! und ED werden von osql nicht mehr unterstützt.

Die Befehlsabschlusszeichen GO (Standard), RESET, ED, !!, EXIT, QUIT und STRG+C werden nur erkannt, wenn sie am Anfang einer Zeile unmittelbar hinter der osql-Eingabeaufforderung verwendet werden.

GO signalisiert sowohl das Ende eines Batches als auch die Ausführung aller zwischengespeicherten Transact-SQL-Anweisungen. Sobald Sie am Ende einer Eingabezeile die EINGABETASTE drücken, werden die Anweisungen in dieser Zeile von osql zwischengespeichert. Wenn Sie nach dem Eingeben von GO die EINGABETASTE drücken, werden alle zurzeit zwischengespeicherten Anweisungen als Batch an SQL Server gesendet.

Die aktuelle Version von osql arbeitet so, als würde sich am Ende jedes ausgeführten Skripts ein impliziter GO-Befehl befinden. Daher werden alle Anweisungen im Skript ausgeführt.

Beenden Sie einen Befehl, indem Sie eine Zeile eingeben, die mit einem Befehlsabschlusszeichen beginnt. Durch das Eingeben einer ganzen Zahl hinter einem Befehlsabschlusszeichen können Sie angeben, wie oft der Befehl ausgeführt werden soll. Wenn Sie diesen Befehl z. B. 100 Mal ausführen möchten, geben Sie Folgendes ein:

SELECT x = 1
GO 100

Die Ergebnisse werden einmal am Ende der Ausführung ausgegeben. osql akzeptiert maximal 1.000 Zeichen pro Zeile. Umfangreiche Anweisungen sollten auf mehrere Zeilen verteilt werden.

Mithilfe der Befehlsrückruffunktionen von Windows können osql-Anweisungen zurückgerufen und geändert werden. Der vorhandene Abfragepuffer kann durch das Eingeben von RESET geleert werden.

Wenn gespeicherte Prozeduren ausgeführt werden, gibt osql eine Leerzeile zwischen den einzelnen Resultsets in einem Batch aus. Außerdem wird die Meldung "0 rows affected" nicht angezeigt, wenn sie für die ausgeführte Anweisung nicht gilt.

Interaktives Verwenden von osql

Wenn Sie osql interaktiv verwenden möchten, geben Sie an der Eingabeaufforderung den Befehl osql (und alle darüber hinaus gewünschten Optionen) ein.

Sie können eine Datei mit einer Abfrage (wie z. B. Stores.qry) einlesen, die von osql ausgeführt werden soll, indem Sie einen Befehl eingeben, der in etwa wie folgt aussieht:

osql -E -i stores.qry

Sie können eine Datei mit einer Abfrage (z. B. Titles.qry) einlesen und die Ergebnisse in eine andere Datei umleiten, indem Sie einen Befehl eingeben, der in etwa wie folgt aussieht:

osql -E -i titles.qry -o titles.res

Sicherheitshinweis:
Verwenden Sie, sofern möglich, die Option -E (vertrauenswürdige Verbindung).

Wenn Sie osql interaktiv verwenden, können Sie eine Betriebssystemdatei mithilfe von :rfile_name in den Befehlspuffer einlesen. Hierdurch wird das in file_name angegebene SQL-Skript direkt als ein einziger Batch an den Server gesendet.

Hinweis:
Wenn Sie osql verwenden, behandelt SQL Server das Batchtrennzeichen "GO" als Syntaxfehler, falls es in einer SQL-Skriptdatei verwendet wird.

Einfügen von Kommentaren

Sie können Kommentare in eine Transact-SQL-Anweisung einschließen, die von osql an SQL Server gesendet wird. Für Kommentare sind die beiden folgenden Formate zulässig: -- und /*...*/.

Weitere Informationen finden Sie unter "Verwenden von Kommentaren".

Verwenden von EXITzum Zurückgeben von Ergebnissen in "osql"

Sie können das Ergebnis einer SELECT-Anweisung als Rückgabewert von osql verwenden. Die erste Spalte der ersten Ergebniszeile wird in eine 4 Byte lange ganze Zahl (Long) konvertiert. MS-DOS übergibt das niedrige Byte an den übergeordneten Prozess oder an die Fehlerebene des Betriebssystems. Windows übergibt die gesamte 4 Byte lange ganze Zahl. Die Syntax ist:

EXIT ( < query > )

Beispiel:

EXIT(SELECT @@ROWCOUNT)

Sie können den EXIT-Parameter auch als Teil einer Batchdatei einschließen. Beispiel:

osql -E -Q "EXIT(SELECT COUNT(*) FROM '%1')"

Das Dienstprogramm osql übergibt alle zwischen den Klammern () stehenden Zeichen exakt so an den Server, wie sie eingegeben wurden. Wenn eine gespeicherte Systemprozedur eine Menge auswählt und einen Wert zurückgibt, wird nur die Auswahl zurückgegeben. Eine EXIT**(** )-Anweisung ohne Angabe zwischen den Klammern führt alle im Batch vorhergehenden Anweisungen aus und beendet das Dienstprogramm dann ohne Rückgabewert.

Es gibt vier EXIT-Formate:

• EXIT

Hinweis:
Führt den Batch nicht aus, beendet das Dienstprogramm sofort und gibt keinen Wert zurück.

• EXIT**(** )

Hinweis:
Führt den Batch aus, beendet dann das Dienstprogramm und gibt keinen Wert zurück.

• EXIT**(query)**

Hinweis:
Führt den Batch einschließlich der Abfrage aus und beendet dann das Dienstprogramm, nachdem die Ergebnisse der Abfrage zurückgegeben wurden.

• RAISERROR mit einem Status von 127

Hinweis:
Wird RAISERROR in einem osql-Skript verwendet und der Status 127 ausgelöst, wird osql beendet und die entsprechende Meldungs-ID an den Client zurückgegeben. Beispiel:

RAISERROR(50001, 10, 127)

Dieser Fehler bewirkt, dass das osql-Skript beendet und die Meldungs-ID 50001 an den Client zurückgegeben wird.

Die Rückgabewerte -1 bis -99 sind für SQL Server reserviert; osql definiert die folgenden Werte:

• -100
  Vor dem Auswählen des Rückgabewertes ist ein Fehler aufgetreten.
• -101
  Beim Auswählen eines Rückgabewertes wurden keine Zeilen gefunden.
• -102
  Beim Auswählen des Rückgabewertes ist ein Konvertierungsfehler aufgetreten.

Anzeigen der Datentypen money und smallmoney

osql zeigt einen Wert des Datentyps money oder smallmoney mit zwei Dezimalstellen an, obwohl SQL Server den Wert intern mit vier Dezimalstellen speichert. Beachten Sie folgendes Beispiel:

SELECT CAST(CAST(10.3496 AS money) AS decimal(6, 4))
GO

Diese Anweisung gibt als Ergebnis 10.3496 zurück. Dieses Ergebnis zeigt an, dass der Wert mit allen unveränderten Dezimalstellen gespeichert wird.

Siehe auch

Andere Ressourcen

/*...*/ (Kommentar) (MDX)
-- (Kommentar) (MDX)
CAST und CONVERT (Transact-SQL)
Sichern von Notification Services
RAISERROR (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005