Redigera SQLCMD-skript med Frågeredigeraren

Använd frågeredigeraren i SQL Server Management Studio (SSMS) för att skriva och redigera frågor som SQLCMD-skript. Du kan använda SQLCMD-skript för att bearbeta Windows-systemkommandon och Transact-SQL-instruktioner i samma skript.

Aktivera SQLCMD-läge

Om du vill använda frågeredigeraren för att skriva eller redigera SQLCMD-skript måste du aktivera SQLCMD-skriptläget. SQLCMD-läget är inte aktiverat som standard. Du kan aktivera skriptläge genom att välja ikonen SQLCMD-läge i verktygsfältet eller genom att välja SQLCMD-läge på frågemenyn .

SQLCMD-skript i frågeredigeraren kan använda samma funktioner som alla Transact-SQL skript använder. Dessa funktioner omfattar bland annat:

• Färgkodning
• Körning av skript
• Källkontroll
• Bearbeta skript
• Visningsplan

Aktivera SQLCMD-skript i Frågeredigeraren

Om du vill aktivera SQLCMD-skript för ett aktivt frågeredigerarefönster använder du följande procedur.

Växla ett frågeredigerarefönster till SQLCMD-läge

1. Högerklicka på servern i Object Explorer och välj sedan Ny fråga för att öppna ett nytt frågeredigerarefönster.

2. På menyn Query väljer du SQLCMD-läge.

   SQLCMD-uttryck körs i kontexten för frågeredigeraren.

3. I verktygsfältet SQL Editor väljer du i listan AdventureWorks2025 .

4. I frågeredigerarens fönster skriver du följande Transact-SQL-instruktioner och SQLCMD-instruktionen !!DIR :

   SELECT DISTINCT Type FROM Sales.SpecialOffer;
   GO
   !!DIR
   GO
   SELECT ProductCategoryID, Name FROM Production.ProductCategory;
   GO
   

5. Tryck på F5 för att köra avsnittet med blandade Transact-SQL- och MS-DOS-instruktioner.

   Observera de två SQL-resultatrutorna från den första och tredje instruktionen.

6. I fönstret Resultat väljer du fliken Meddelanden för att se meddelandena från alla tre uttrycken:

   • (6 row(s) affected)
   • <The directory information>
   • (4 row(s) affected)

Aktivera SQLCMD-skript som standard

Om du vill aktivera SQLCMD-skript som standard går du till menyn Verktyg, väljer Alternativ, expanderar Frågekörningoch SQL Serverväljer du sidan Allmänt och markerar sedan kryssrutan Öppna nya frågor i SQLCMD-läge som standard.

Skriva och redigera SQLCMD-skript

När du har aktiverat skriptläge kan du skriva både SQLCMD-kommandon och Transact-SQL-instruktioner. Följande regler gäller:

• SQLCMD-kommandon måste vara den första instruktionen på en rad.

• Endast ett SQLCMD-kommando tillåts på varje rad.

• Du kan använda kommentarer och tomt utrymme framför SQLCMD-kommandon.

• SQLCMD-kommandon inom kommentarstecken körs inte.

• Kommentarstecken med en rad är två bindestreck (--) och måste visas i början av en rad.

• Prefixoperativsystemkommandon med två utropstecken (!!). Kommandot dubbla utropstecken gör att instruktionen som följer utropspunkterna körs med hjälp av cmd.exe-kommandoprocessorn. Texten efter !! skickas som en parameter till cmd.exe, så den sista kommandoraden körs som: "%SystemRoot%\system32\cmd.exe /c <text after !!>".

• För att göra en tydlig skillnad mellan SQLCMD-kommandon och Transact-SQL, prefix alla SQLCMD-kommandon med ett kolon (:).

• Kommandot GO kan användas utan förord eller föregås av !!:.

• Frågeredigeraren stöder miljövariabler och variabler som du definierar som en del av ett SQLCMD-skript, men det stöder inte inbyggda SQLCMD- eller osql-variabler . SSMS bearbetar SQLCMD-variabler som skiftlägeskänsliga. Till exempel PRINT '$(COMPUTERNAME)' ger rätt resultat, men PRINT '$(ComputerName)' returnerar ett fel.

SQLCMD-syntax som stöds

Frågeredigeraren stöder följande nyckelord för SQLCMD-skript:

• [!!:]GO[count]
• !! <command>
• :exit(statement)
• :Quit
• :r <filename>
• :setvar <var> <value>
• :connect server[\instance] [-l login_timeout] [-U user [-P password]] ¹
• :on error [ignore|exit]
• :error <filename>|stderr|stdout ²
• :out <filename>|stderr|stdout ²

¹ Mer information om :connect kommandot finns i Kommandon i sqlcmd-verktyget.

² Frågeredigeraren skickar utdata till fliken Meddelanden för stderr och stdout.

Frågeredigeraren stöder inte SQLCMD-kommandon som inte ingår i föregående lista. När du kör ett skript som innehåller SQLCMD-nyckelord som inte stöds ignorerar frågeredigeraren kommandot. För varje nyckelord som inte stöds skickar frågeredigeraren följande meddelande till målet:

Ignoring command <ignored_command>

Färgkodning i SQLCMD-skript

När du aktiverar SQLCMD-skript är skripten färgkodade. Färgkodningen för Transact-SQL nyckelord förblir densamma. SQLCMD-kommandon visas med en skuggad bakgrund.

Examples

I följande exempel används en SQLCMD-instruktion för att skapa en utdatafil med namnet testoutput.txt. Den kör två Transact-SQL-instruktioner SELECT och ett operativsystemkommando som skriver ut den aktuella katalogen. Den resulterande filen innehåller meddelandeutdata från -instruktionen DIR och resultatet från Transact-SQL-uttrycken.

:out C:\testoutput.txt
SELECT @@VERSION As 'Server Version';
!!DIR
!!:GO
SELECT @@SERVERNAME AS 'Server Name';
GO

Relaterat innehåll

• sqlcmd-verktyg