Bagikan melalui

Mengonfigurasi Transact-SQL Debugger

Aturan Windows Firewall harus dikonfigurasi untuk mengaktifkan debugging Transact-SQL saat terhubung ke instansi Mesin Database yang berjalan pada komputer yang berbeda dari Editor Kueri Mesin Database.

Mengonfigurasi Debugger Transact-SQL

Debugger Transact-SQL mencakup komponen sisi server dan sisi klien. Komponen debugger sisi server diinstal dengan setiap instans Mesin Database dari SQL Server 2005 Service Pack 2 (SP2) atau yang lebih baru. Komponen debugger sisi klien disertakan:

  • Saat Anda menginstal alat sisi klien dari SQL Server 2008 atau yang lebih baru.

  • Saat Anda menginstal Microsoft Visual Studio 2010 atau yang lebih baru.

  • Saat Anda menginstal SQL Server Data Tools (SSDT) dari unduhan web.

Tidak ada persyaratan konfigurasi untuk menjalankan debugger Transact-SQL saat SQL Server Management Studio atau SQL Server Data Tools berjalan di komputer yang sama dengan instans Mesin Database SQL Server. Namun, untuk menjalankan debugger Transact-SQL saat tersambung ke instans jarak jauh Mesin Database, aturan program dan port di Windows Firewall harus diaktifkan di kedua komputer. Aturan ini dapat dibuat oleh pemasangan SQL Server. Jika Anda mendapatkan kesalahan saat mencoba membuka sesi debug jarak jauh, pastikan aturan firewall berikut ditentukan di komputer Anda.

Gunakan Windows Firewall dengan aplikasi Advanced Security untuk mengelola aturan firewall. Di Windows 7 dan Windows Server 2008 R2, buka Panel Kontrol, buka Windows Firewall, dan pilih Pengaturan tingkat lanjut. Di Windows Server 2008 R2 Anda juga dapat membuka Manajer Layanan, memperluas Konfigurasi di panel kiri, dan memperluas Windows Firewall dengan Keamanan Tingkat Lanjut.

Perhatian

Mengaktifkan aturan di Windows Firewall dapat mengekspos komputer Anda terhadap ancaman keamanan yang dirancang untuk diblokir oleh firewall. Mengaktifkan aturan untuk debugging jarak jauh membuka blokir port dan program yang tercantum dalam topik ini.

Aturan Firewall di Server

Di komputer yang menjalankan instans Mesin Database, gunakan Windows Firewall dengan Keamanan Tingkat Lanjut untuk menentukan informasi berikut:

  • Tambahkan aturan program masuk untuk sqlservr.exe. Anda harus memiliki aturan untuk setiap instance yang perlu mendukung sesi debugging jarak jauh.

    1. Di Windows Firewall dengan Keamanan Tingkat Lanjut, di panel kiri, klik kanan Aturan Masuk, lalu pilih Aturan Baru di panel tindakan.

    2. Dalam dialog Tipe Aturan , pilih Program, lalu klik Berikutnya.

    3. Dalam dialog Program , pilih Jalur program ini: dan masukkan jalur lengkap ke sqlservr.exe untuk instans ini. Secara default, sqlservr.exe diinstal di C:\Program Files\Microsoft SQL Server\MSSQL12. InstanceName\MSSQL\Binn, di mana InstanceName adalah MSSQLSERVER untuk instans default, dan nama instans untuk instans bernama apa pun.

    4. Dalam dialog Tindakan , pilih Izinkan koneksi, dan klik Berikutnya.

    5. Dalam dialog Profil, pilih profil manapun yang menjelaskan lingkungan koneksi komputer saat Anda ingin membuka sesi debug dengan instance, dan klik Berikutnya.

    6. Dalam dialog Nama , ketik nama dan deskripsi untuk aturan ini dan klik Selesai.

    7. Di daftar Aturan Masuk, klik kanan aturan yang Anda buat, lalu pilih Properti di panel aksi.

    8. Pilih tab Protokol dan Port .

    9. Pilih TCP dalam kotak Jenis protokol: , pilih RPC Dynamic Ports di kotak Port lokal: klik Terapkan, lalu klik OK.

  • Tambahkan aturan program masuk untuk svchost.exe untuk mengaktifkan komunikasi DCOM dari sesi debugger jarak jauh.

    1. Di Windows Firewall dengan Keamanan Tingkat Lanjut, di panel kiri, klik kanan Aturan Masuk, lalu pilih Aturan Baru di panel tindakan.

    2. Dalam dialog Tipe Aturan , pilih Program, lalu klik Berikutnya.

    3. Dalam dialog Program , pilih Jalur program ini: dan masukkan jalur lengkap untuk svchost.exe. Secara default, svchost.exe diinstal di %systemroot%\System32\svchost.exe.

    4. Dalam dialog Tindakan , pilih Izinkan koneksi, dan klik Berikutnya.

    5. Dalam dialog Profil, pilih profil apa pun yang menggambarkan lingkungan koneksi komputer ketika Anda ingin membuka sesi penelusuran kesalahan dengan instance, lalu klik Berikutnya.

    6. Dalam dialog Nama , ketik nama dan deskripsi untuk aturan ini dan klik Selesai.

    7. Di dalam daftar Aturan Masuk, klik kanan pada aturan yang Anda buat, lalu pilih Properti di panel aksi.

    8. Pilih tab Protokol dan Port .

    9. Pilih TCP dalam kotak Jenis protokol: , pilih Pemeta Titik Akhir RPC di kotak Port lokal: klik Terapkan, lalu klik OK.

  • Jika kebijakan domain mengharuskan komunikasi jaringan dilakukan melalui IPsec, Anda juga harus menambahkan aturan masuk yang membuka port UDP 4500 dan port UDP 500.

Aturan Firewall pada Klien

Di komputer yang menjalankan Editor Kueri Mesin Database, pemasangan SQL Server atau SQL Server Data Tools mungkin telah mengonfigurasi Windows Firewall untuk mengizinkan debugging jarak jauh.

Jika Anda mendapatkan kesalahan saat mencoba membuka sesi pemecahan masalah jarak jauh, Anda dapat mengonfigurasi program dan pengecualian port secara manual dengan memanfaatkan Windows Firewall dengan Keamanan Tingkat Lanjut untuk mengonfigurasi aturan firewall:

  • Tambahkan entri program untuk svchost:

    1. Di Windows Firewall dengan Keamanan Tingkat Lanjut, di panel kiri, klik kanan Aturan Masuk, lalu pilih Aturan Baru di panel tindakan.

    2. Dalam dialog Tipe Aturan , pilih Program, lalu klik Berikutnya.

    3. Dalam dialog Program , pilih Jalur program ini: dan masukkan jalur lengkap untuk svchost.exe. Secara default, svchost.exe diinstal di %systemroot%\System32\svchost.exe.

    4. Dalam dialog Tindakan , pilih Izinkan koneksi, dan klik Berikutnya.

    5. Dalam dialog Profil, pilih profil manapun yang menggambarkan lingkungan koneksi komputer saat ingin membuka sesi debugging dengan instans, dan klik Berikutnya.

    6. Dalam dialog Nama , ketik nama dan deskripsi untuk aturan ini dan klik Selesai.

    7. Di daftar Aturan Masuk, klik kanan pada aturan yang telah Anda buat, lalu pilih Properti di panel tindakan.

    8. Pilih tab Protokol dan Port .

    9. Pilih TCP dalam kotak Jenis protokol: , pilih Pemeta Titik Akhir RPC di kotak Port lokal: klik Terapkan, lalu klik OK.

  • Tambahkan entri program untuk aplikasi yang menghosting Editor Kueri Mesin Database. Jika Anda perlu membuka sesi penelusuran kesalahan jarak jauh dari SQL Server Management Studio dan SQL Server Data Tools di komputer yang sama, Anda harus menambahkan aturan program untuk keduanya:

    1. Di Windows Firewall dengan Keamanan Tingkat Lanjut, di panel kiri, klik kanan Aturan Masuk, lalu pilih Aturan Baru di panel tindakan.

    2. Dalam dialog Tipe Aturan , pilih Program, lalu klik Berikutnya.

    3. Dalam dialog Program , pilih Jalur program ini: dan masukkan salah satu dari tiga nilai ini.

      • Untuk SQL Server Management Studio, masukkan jalur lengkap ke ssms.exe. Secara default, ssms.exe diinstal di C:\Program Files (x86)\Microsoft SQL Server\120\Tools\Binn\Management Studio.

      • Untuk SQL Server Data Tools masukkan jalur lengkap ke devenv.exe:

        1. Secara default, devenv.exe untuk Visual Studio 2010 ada di C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

        2. Secara default, devenv.exe untuk Visual Studio 2012 ada di C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE

        3. Anda dapat menemukan jalur ke ssms.exe dari pintasan yang Anda gunakan untuk meluncurkan SQL Server Management Studio. Anda dapat menemukan jalur ke devenv.exe dari pintasan yang Anda gunakan untuk meluncurkan SQL Server Data Tools. Klik kanan pintasan dan pilih Properti. Executable dan jalur tercantum dalam bidang Target.

    4. Dalam dialog Tindakan , pilih Izinkan koneksi, dan klik Berikutnya.

    5. Dalam kotak dialog Profil, pilih profil mana pun yang menggambarkan pengaturan koneksi komputer saat Anda ingin membuka sesi debug dengan instance, dan klik Berikutnya.

    6. Dalam dialog Nama , ketik nama dan deskripsi untuk aturan ini dan klik Selesai.

    7. Di daftar Aturan Masuk, klik kanan aturan yang Anda buat, lalu pilih Properti pada panel tindakan.

    8. Pilih tab Protokol dan Port .

    9. Pilih TCP dalam kotak Jenis protokol: , pilih RPC Dynamic Ports di kotak Port lokal: klik Terapkan, lalu klik OK.

Persyaratan untuk Memulai Debugger

Semua upaya untuk memulai debugger Transact-SQL juga harus memenuhi persyaratan berikut:

  • SQL Server Management Studio atau SQL Server Data Tools harus berjalan di bawah akun Windows yang merupakan anggota roll server tetap sysadmin.

  • Jendela Editor Kueri Mesin Database harus tersambung dengan menggunakan login Autentikasi Windows atau Autentikasi SQL Server yang merupakan anggota peran server tetap sysadmin.

  • Jendela Editor Kueri Mesin Database harus tersambung ke instans Mesin Database dari SQL Server 2005 Service Pack 2 (SP2) atau yang lebih baru. Anda tidak dapat menjalankan debugger saat jendela Editor Kueri tersambung ke instans yang berada dalam mode pengguna tunggal.

  • Server perlu berkomunikasi kembali ke klien melalui RPC. Akun tempat layanan SQL Server berjalan harus memiliki izin autentikasi ke klien.

Lihat Juga

Transact-SQL Debugger
Menjalankan Transact-SQL Debugger
Langkah Melalui Transact-SQL Kode
Transact-SQL Informasi Debugger
Editor Kueri Mesin Database (SQL Server Management Studio)

  • Last updated on