Bagikan melalui

Mengedit Skrip SQLCMD dengan Editor Kueri

  • Artikel

Dengan menggunakan Editor Kueri Mesin Database di SQL Server Management Studio Anda dapat menulis dan mengedit kueri sebagai skrip SQLCMD. Anda menggunakan skrip SQLCMD ketika Anda harus memproses perintah Sistem Windows dan pernyataan Transact-SQL dalam skrip yang sama.

SQLCMD Mode

Untuk menggunakan mesin database Editor Kueri untuk menulis atau mengedit skrip SQLCMD, Anda harus mengaktifkan mode skrip SQLCMD. Secara default, mode SQLCMD tidak diaktifkan di Editor Kueri. Anda dapat mengaktifkan mode pembuatan skrip dengan mengklik ikon Mode SQLCMD di toolbar atau dengan memilih Mode SQLCMD dari menu Kueri .

Catatan

Mengaktifkan mode SQLCMD menonaktifkan IntelliSense dan debugger Transact-SQL di mesin database Editor Kueri.

Skrip SQLCMD dalam Editor Kueri dapat menggunakan fitur yang sama dengan yang digunakan semua skrip Transact-SQL. Fitur-fitur ini mencakup hal-hal berikut:

  • Pengkodian Warna

  • Menjalankan Skrip

  • Kontrol Sumber

  • Mengurai Skrip

  • Showplan

Aktifkan Pembuatan Skrip SQLCMD di Editor Kueri

Untuk mengaktifkan pembuatan skrip SQLCMD untuk jendela Editor Kueri Mesin Database aktif, gunakan prosedur berikut.

Untuk mengalihkan jendela Editor Kueri Mesin Database ke mode SQLCMD

  1. Di Object Explorer, klik kanan server, lalu klik Kueri Baru, untuk membuka jendela Editor Kueri Mesin Database baru.

  2. Pada menu Kueri , klik Mode SQLCMD.

    Editor Kueri menjalankan pernyataan sqlcmd dalam konteks Editor Kueri.

  3. Pada toolbar Editor SQL , di daftar Database yang Tersedia , pilih AdventureWorks2012.

  4. Di jendela Editor Kueri, ketik dua pernyataan Transact-SQL berikut dan !!DIR pernyataan sqlcmd:

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

  5. Tekan F5 untuk menjalankan seluruh bagian pernyataan Transact-SQL dan MS-DOS campuran.

    Perhatikan dua panel hasil SQL dari pernyataan pertama dan ketiga.

  6. Di panel Hasil , klik tab Pesan untuk melihat pesan dari ketiga pernyataan:

    • (6 baris terpengaruh)

    • <Informasi direktori>

    • (4 baris terpengaruh)

Penting

Ketika dijalankan dari baris perintah, utilitas sqlcmd mengizinkan interaksi penuh dengan sistem operasi. Saat Anda menggunakan Editor Kueri dalam Mode SQLCMD, Anda harus berhati-hati untuk tidak menjalankan pernyataan interaktif. Editor Kueri tidak dapat merespons permintaan sistem operasi.

Untuk informasi selengkapnya tentang cara menjalankan SQLCMD, lihat Utilitas sqlcmd, atau ikuti tutorial SQLCMD.

Aktifkan Pembuatan Skrip SQLCMD secara Default

Untuk mengaktifkan pembuatan skrip SQLCMD secara default, pada menu Alat pilih Opsi, perluas Eksekusi Kueri, dan SQL Server, klik halaman Umum, lalu centang kotak Secara default buka kueri baru dalam Mode SQLCMD.

Menulis dan Mengedit Skrip SQLCMD

Setelah mengaktifkan mode skrip, Anda dapat menulis perintah SQLCMD dan pernyataan T-SQL. Aturan berikut ini akan berlaku:

  • Perintah SQLCMD harus menjadi pernyataan pertama pada baris.

  • Hanya satu perintah SQLCMD yang diizinkan pada setiap baris.

  • Perintah SQLCMD dapat didahului oleh komentar atau spasi kosong.

  • Perintah SQLCMD dalam karakter komentar tidak dijalankan.

  • Karakter komentar baris tunggal adalah dua tanda hubung (--) dan harus muncul di awal baris.

  • Perintah sistem operasi harus didahului oleh dua tanda seru (!!). Perintah titik seru ganda menyebabkan pernyataan yang mengikuti tanda seru dijalankan menggunakan cmd.exe prosesor perintah. Teks setelah !! diteruskan sebagai parameter ke cmd.exe, sehingga baris perintah akhir akan dijalankan sebagai: "%SystemRoot%\system32\cmd.exe /c <text after !!>".

  • Untuk membuat perbedaan yang jelas antara perintah SQLCMD dan Transact-SQL, semua perintah SQLCMD, perlu diawali dengan titik dua (:).

  • Perintah GO dapat digunakan tanpa awalan, atau didahului oleh !!:

  • Mesin Database Editor Kueri mendukung variabel dan variabel lingkungan yang didefinisikan sebagai bagian dari skrip SQLCMD, tetapi tidak mendukung variabel SQLCMD atau osql bawaan. Pemrosesan SQLCMD dengan SQL Server Management Studio peka huruf besar/kecil untuk variabel. Misalnya, PRINT '$(COMPUTERNAME)' menghasilkan hasil yang benar, tetapi PRINT '$(ComputerName)' mengembalikan kesalahan.

Perhatian

SQL Server Management Studio menggunakan Microsoft.NET FrameworkSqlClient untuk eksekusi dalam mode reguler dan SQLCMD. Saat dijalankan dari baris perintah, SQLCMD menggunakan penyedia OLE DB. Karena opsi default yang berbeda dapat berlaku, dimungkinkan untuk mendapatkan perilaku yang berbeda saat menjalankan kueri yang sama dalam mode SQLCMD SQL Server Management Studio, dan dalam utilitas SQLCMD.

Sintaks SQLCMD yang didukung

Mesin Database Editor Kueri mendukung kata kunci skrip SQLCMD berikut:

[!!:]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

Catatan

Untuk dan :error:out, stderr dan stdout kirim output ke tab pesan.

Perintah SQLCMD yang tidak tercantum di atas tidak didukung dalam Editor Kueri. Ketika skrip yang berisi kata kunci SQLCMD yang tidak didukung dijalankan, Editor Kueri akan mengirim pesan "Mengabaikan perintah<> yang diabaikan" ke tujuan untuk setiap kata kunci yang tidak didukung. Skrip akan berhasil dijalankan, tetapi perintah yang tidak didukung akan diabaikan.

Perhatian

Karena Anda tidak memulai SQLCMD dari baris perintah, ada beberapa batasan saat menjalankan Editor Kueri dalam Mode SQLCMD. Anda tidak dapat meneruskan parameter baris perintah seperti variabel, dan, karena Editor Kueri tidak memiliki kemampuan untuk merespons permintaan sistem operasi, Anda harus berhati-hati untuk tidak menjalankan pernyataan interaktif.

Pengkodian Warna dalam Skrip SQLCMD

Dengan mengaktifkan pembuatan skrip SQLCMD, skrip akan dikodekan warnanya. Pengkodian warna untuk kata kunci Transact-SQL akan tetap sama. Perintah SQLCMD disajikan dengan latar belakang bertaung.

Contoh

Contoh berikut menggunakan pernyataan sqlcmd untuk membuat file output yang disebut testoutput.txt, menjalankan dua pernyataan T-SQL SELECT bersama dengan satu perintah sistem operasi (untuk mencetak direktori saat ini). File yang dihasilkan berisi output pesan dari DIR pernyataan , diikuti oleh output hasil dari pernyataan Transact-SQL.

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

Lihat juga

Utilitas sqlcmd