Настройка правил брандмауэра перед запуском отладчика TSQLConfigure firewall rules before running the TSQL Debugger

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server даБаза данных SQL AzureдаХранилище данных SQL AzureдаParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Необходимо настроить правила брандмауэра Windows, включив отладку Transact-SQLTransact-SQL при подключении к экземпляру компонента Компонент Database EngineDatabase Engine, который работает на компьютере, отличном от того, на котором работает редактор запросов компонента Компонент Database EngineDatabase Engine.Windows Firewall rules must be configured to enable Transact-SQLTransact-SQL debugging when connected to an instance of the Компонент Database EngineDatabase Engine that is running on a different computer than the Компонент Database EngineDatabase Engine Query Editor.

Настройка отладчика Transact-SQLConfiguring the Transact-SQL Debugger

Отладчик Transact-SQLTransact-SQL имеет как серверные, так и клиентские компоненты.The Transact-SQLTransact-SQL debugger includes both server-side and client-side components. Серверные компоненты отладчика устанавливаются с каждым экземпляром ядра СУБД из SQL Server 2005SQL Server 2005 с пакетом обновления 2 (SP2) или более поздней версии.The server-side debugger components are installed with each instance of the Database Engine from SQL Server 2005SQL Server 2005 Service Pack 2 (SP2) or later. Клиентские компоненты отладчика устанавливаются в следующих случаях:The client-side debugger components are included:

  • При установке клиентских средств из SQL Server 2008SQL Server 2008 или более поздней версии.When you install the client-side tools from SQL Server 2008SQL Server 2008 or later.

  • При установке среды Microsoft Visual Studio 2010 или более поздней версии.When you install Microsoft Visual Studio 2010 or later.

  • При установке среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) из веб-загрузки.When you install SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) from the web download.

Нет требований по конфигурации для запуска отладчика Transact-SQLTransact-SQL , если среда Среда SQL Server Management StudioSQL Server Management Studio или SQL Server Data Tools (SSDT)SQL Server Data Tools работает на том же компьютере, что и экземпляр компонента Компонент SQL Server Database EngineSQL Server Database Engine.There are no configuration requirements to run the Transact-SQLTransact-SQL debugger when Среда SQL Server Management StudioSQL Server Management Studio or SQL Server Data Tools (SSDT)SQL Server Data Tools is running on the same computer as the instance of the Компонент SQL Server Database EngineSQL Server Database Engine. Однако для запуска отладчика Transact-SQLTransact-SQL при соединении с удаленным экземпляром компонента Компонент Database EngineDatabase Engineдля брандмауэра Windows на обоих компьютерах должны быть включены правила программы и порта.However, to run the Transact-SQLTransact-SQL debugger when connected to a remote instance of the Компонент Database EngineDatabase Engine, program and port rules in the Windows Firewall must be enabled on both computers. Эти правила можно создать в программе установки SQL ServerSQL Server .These rules may be created by SQL ServerSQL Server setup. Если при попытке открыть сеанс отладки на удаленном компьютере возникают ошибки, убедитесь, что на брандмауэре вашего компьютера определены следующие правила.If you get errors attempting to open a remote debugging session, ensure the following firewall rules are defined on your computer.

Правила можно задать с помощью приложения Брандмауэр Windows в режиме повышенной безопасности .Use the Windows Firewall with Advanced Security application to manage the firewall rules. В Windows 7Windows 7 и Windows Server 2008 R2Windows Server 2008 R2откройте Панель управленияи Брандмауэр Windowsи выберите Дополнительные параметры.In both Windows 7Windows 7 and Windows Server 2008 R2Windows Server 2008 R2, open Control Panel, open Windows Firewall, and select Advanced settings. В Windows Server 2008 R2Windows Server 2008 R2 можно также открыть Диспетчер служб, развернуть узел Конфигурация на панели слева и развернуть Брандмауэр Windows в режиме повышенной безопасности.In Windows Server 2008 R2Windows Server 2008 R2 you can also open Service Manager, expand Configuration in the left pane, and expand Windows Firewall with Advanced Security.

Внимание!

Добавление правил в брандмауэр Windows может подвергнуть компьютер угрозам безопасности, которые брандмауэр должен блокировать.Enabling rules in the Windows Firewall may expose your computer to security threats that the firewall is designed to block. Включение правил для удаленной отладки заключается в разблокировании портов и программ, перечисленных в данном разделе.Enabling rules for remote debugging unblocks the ports and programs listed in this topic.

Правила брандмауэра на сервереFirewall Rules on the Server

На компьютере, где установлен экземпляр компонента Компонент Database EngineDatabase Engine, через пункт Брандмауэр Windows в режиме повышенной безопасности задайте следующие параметры.On the computer that is running the instance of the Компонент Database EngineDatabase Engine, use Windows Firewall with Advanced Security to specify the following information:

  • Добавьте правило входящего соединения для программы sqlservr.exe.Add an inbound program rule for sqlservr.exe. Необходимо иметь правила для каждого экземпляра, к которому должны поддерживаться сеансы удаленной отладки.You must have a rule for each instance that needs to support remote debugging sessions.

    1. На левой панели окна Брандмауэр Windows в режиме повышенной безопасностищелкните правой кнопкой мыши раздел Правила для входящих подключенийи выберите на панели действий пункт Создать правило .In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. В диалоговом окне Тип правила выберите Программаи нажмите кнопку Далее.In the Rule Type dialog, select Program, and then click Next.

    3. В диалоговом окне Программа выберите элемент Путь к этой программе и введите полный путь к файлу sqlservr.exe для данного экземпляра.In the Program dialog, select This program path: and enter the full path to sqlservr.exe for this instance. По умолчанию программа sqlservr.exe устанавливается в папку C:\Program Files\Microsoft SQL Server\MSSQL13.имя_экземпляра\MSSQL\Binn, где имя_экземпляра — это MSSQLSERVER для экземпляра по умолчанию и имя любого именованного экземпляра.By default, sqlservr.exe is installed in C:\Program Files\Microsoft SQL Server\MSSQL13.InstanceName\MSSQL\Binn, where InstanceName is MSSQLSERVER for the default instance, and the instance name for any named instance.

    4. В диалоговом окне Действие выберите Разрешить соединениеи нажмите кнопку Далее.In the Action dialog, select Allow the connection, and click Next.

    5. В диалоговом окне Профиль выберите профили, описывающие среду соединения для компьютера, с которым необходимо установить сеанс отладки для экземпляра, и нажмите кнопку Далее.In the Profile dialog, select any profiles that describe the computer connection environment when you want to open a debugging session with the instance, and click Next.

    6. В диалоговом окне Имя введите имя и описание для этого правила, затем нажмите кнопку Готово.In the Name dialog, type a name and description for this rule and click Finish.

    7. В списке Правила для входящих подключений щелкните правой кнопкой мыши созданное правило и выберите пункт Свойства на панели действий.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Откройте вкладку Протоколы и порты .Select the Protocols and Ports tab.

    9. В поле Тип протокола выберите TCP , в поле Локальный порт выберите Динамические порты RPC , нажмите кнопку Применить, а затем — кнопку ОК.Select TCP in the Protocol type: box, select RPC Dynamic Ports in the Local port: box, click Apply, and then click OK.

  • Добавьте правило входящего подключения для программы svchost.exe, чтобы обеспечить обмен данными DCOM из сеансов удаленного отладчика.Add an inbound program rule for svchost.exe to enable DCOM communications from remote debugger sessions.

    1. На левой панели окна Брандмауэр Windows в режиме повышенной безопасностищелкните правой кнопкой мыши раздел Правила для входящих подключенийи выберите на панели действий пункт Создать правило .In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. В диалоговом окне Тип правила выберите Программаи нажмите кнопку Далее.In the Rule Type dialog, select Program, and then click Next.

    3. В диалоговом окне Программа щелкните Путь к этой программе и введите полный путь к файлу svchost.exe.In the Program dialog, select This program path: and enter the full path to svchost.exe. По умолчанию в svchost.exe устанавливается по пути %systemroot%\System32\svchost.exe.By default, svchost.exe is installed in %systemroot%\System32\svchost.exe.

    4. В диалоговом окне Действие выберите Разрешить соединениеи нажмите кнопку Далее.In the Action dialog, select Allow the connection, and click Next.

    5. В диалоговом окне Профиль выберите профили, описывающие среду соединения для компьютера, с которым необходимо установить сеанс отладки для экземпляра, и нажмите кнопку Далее.In the Profile dialog, select any profiles that describe the computer connection environment when you want to open a debugging session with the instance, and click Next.

    6. В диалоговом окне Имя введите имя и описание для этого правила, затем нажмите кнопку Готово.In the Name dialog, type a name and description for this rule and click Finish.

    7. В списке Правила для входящих подключений щелкните правой кнопкой мыши созданное правило и выберите пункт Свойства на панели действий.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Откройте вкладку Протоколы и порты .Select the Protocols and Ports tab.

    9. В поле Тип протокола выберите TCP , в поле Локальный порт выберите Сопоставитель конечных точек RPC , нажмите кнопку Применить, а затем — кнопку ОК.Select TCP in the Protocol type: box, select RPC Endpoint Mapper in the Local port: box, click Apply, and then click OK.

  • Если согласно политике домена требуется, чтобы сетевые соединения осуществлялись через протокол IPsec, то необходимо также добавить правила входящих подключений для открытия портов 4500 и 500 по протоколу UDP.If the domain policy requires network communications to be done through IPsec, you must also add inbound rules opening UDP port 4500 and UDP port 500.

Правила брандмауэра на клиентеFirewall Rules on the Client

На компьютере, где запущен редактор запросов компонента Компонент Database EngineDatabase Engine , программа установки SQL Server или среды SQL Server Data Tools (SSDT)SQL Server Data Tools могла уже настроить брандмауэр Windows, разрешив удаленную отладку.On the computer that is running the Компонент Database EngineDatabase Engine Query Editor, the SQL Server setup or SQL Server Data Tools (SSDT)SQL Server Data Tools setup may have configured the Windows Firewall to allow remote debugging.

Если возникают ошибки при попытке открытия сеанса удаленной отладки, то вы можете вручную настроить исключения для программ и портов, настроив правила брандмауэра в окне Брандмауэр Windows в режиме повышенной безопасности .If you get errors attempting to open a remote debugging session, you can manually configure the program and port exceptions by using Windows Firewall with Advanced Security to configure firewall rules:

  • Добавление записи для программы svchostAdd a program entry for svchost:

    1. На левой панели окна Брандмауэр Windows в режиме повышенной безопасностищелкните правой кнопкой мыши раздел Правила для входящих подключенийи выберите на панели действий пункт Создать правило .In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. В диалоговом окне Тип правила выберите Программаи нажмите кнопку Далее.In the Rule Type dialog, select Program, and then click Next.

    3. В диалоговом окне Программа щелкните Путь к этой программе и введите полный путь к файлу svchost.exe.In the Program dialog, select This program path: and enter the full path to svchost.exe. По умолчанию в svchost.exe устанавливается по пути %systemroot%\System32\svchost.exe.By default, svchost.exe is installed in %systemroot%\System32\svchost.exe.

    4. В диалоговом окне Действие выберите Разрешить соединениеи нажмите кнопку Далее.In the Action dialog, select Allow the connection, and click Next.

    5. В диалоговом окне Профиль выберите профили, описывающие среду соединения для компьютера, с которым необходимо установить сеанс отладки для экземпляра, и нажмите кнопку Далее.In the Profile dialog, select any profiles that describe the computer connection environment when you want to open a debugging session with the instance, and click Next.

    6. В диалоговом окне Имя введите имя и описание для этого правила, затем нажмите кнопку Готово.In the Name dialog, type a name and description for this rule and click Finish.

    7. В списке Правила для входящих подключений щелкните правой кнопкой мыши созданное правило и выберите пункт Свойства на панели действий.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Откройте вкладку Протоколы и порты .Select the Protocols and Ports tab.

    9. В поле Тип протокола выберите TCP , в поле Локальный порт выберите Сопоставитель конечных точек RPC , нажмите кнопку Применить, а затем — кнопку ОК.Select TCP in the Protocol type: box, select RPC Endpoint Mapper in the Local port: box, click Apply, and then click OK.

  • Добавление записи для размещения приложения, в котором размещается редактор запросов Компонент Database EngineDatabase Engine .Add a program entry for the application hosting the Компонент Database EngineDatabase Engine Query Editor. Если необходимо открывать сеансы удаленной отладки как из среды Среда SQL Server Management StudioSQL Server Management Studio , так и из среды SQL Server Data Tools (SSDT)SQL Server Data Tools на том же компьютере, то необходимо добавить оба правила.If you need to open remote debugging sessions from both Среда SQL Server Management StudioSQL Server Management Studio and SQL Server Data Tools (SSDT)SQL Server Data Tools on the same computer, you must add a program rule for both:

    1. На левой панели окна Брандмауэр Windows в режиме повышенной безопасностищелкните правой кнопкой мыши раздел Правила для входящих подключенийи выберите на панели действий пункт Создать правило .In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. В диалоговом окне Тип правила выберите Программаи нажмите кнопку Далее.In the Rule Type dialog, select Program, and then click Next.

    3. В диалоговом окне Программа щелкните Путь к этой программе и введите одно из следующих трех значений.In the Program dialog, select This program path: and enter one of these three values.

      • Для среды Среда SQL Server Management StudioSQL Server Management Studioвведите полный путь к ssms.exe.For Среда SQL Server Management StudioSQL Server Management Studio, enter the full path to ssms.exe. По умолчанию программа ssms.exe устанавливается в папку C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn\Management Studio.By default, ssms.exe is installed in C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn\Management Studio.

      • Для среды SQL Server Data Tools (SSDT)SQL Server Data Tools введите полный путь к devenv.exe.For SQL Server Data Tools (SSDT)SQL Server Data Tools enter the full path to devenv.exe:

        1. По умолчанию devenv.exe для Visual Studio 2010 устанавливается в папку «C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE».By default, the devenv.exe for Visual Studio 2010 is in C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

        2. По умолчанию devenv.exe для Visual Studio 2012 устанавливается в папку «C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE».By default, the devenv.exe for Visual Studio 2012 is in C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE

        3. Путь к ssms.exe вы можете получить из ярлыка, который используется для запуска среды Среда SQL Server Management StudioSQL Server Management Studio.You can find the path to ssms.exe from the shortcut you use to launch Среда SQL Server Management StudioSQL Server Management Studio. Путь к devenv.exe вы можете получить из ярлыка, который используется для запуска среды SQL Server Data Tools (SSDT)SQL Server Data Tools.You can find the path to devenv.exe from the shortcut you use to launch SQL Server Data Tools (SSDT)SQL Server Data Tools. Щелкните ярлык правой кнопкой мыши и выберите пункт Свойства.Right click the shortcut and select Properties. Исполняемый файл и пути указаны в поле Цель .The executable and path are listed in the Target box.

    4. В диалоговом окне Действие выберите Разрешить соединениеи нажмите кнопку Далее.In the Action dialog, select Allow the connection, and click Next.

    5. В диалоговом окне Профиль выберите профили, описывающие среду соединения для компьютера, с которым необходимо установить сеанс отладки для экземпляра, и нажмите кнопку Далее.In the Profile dialog, select any profiles that describe the computer connection environment when you want to open a debugging session with the instance, and click Next.

    6. В диалоговом окне Имя введите имя и описание для этого правила, затем нажмите кнопку Готово.In the Name dialog, type a name and description for this rule and click Finish.

    7. В списке Правила для входящих подключений щелкните правой кнопкой мыши созданное правило и выберите пункт Свойства на панели действий.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Откройте вкладку Протоколы и порты .Select the Protocols and Ports tab.

    9. В поле Тип протокола выберите TCP , в поле Локальный порт выберите Динамические порты RPC , нажмите кнопку Применить, а затем — кнопку ОК.Select TCP in the Protocol type: box, select RPC Dynamic Ports in the Local port: box, click Apply, and then click OK.

Требования к запуску отладчикаRequirements for Starting the Debugger

Все попытки запустить отладчик Transact-SQLTransact-SQL должны также отвечать следующим требованиям.All attempts to start the Transact-SQLTransact-SQL debugger must also meet the following requirements:

  • Среда SQL Server Management StudioSQL Server Management Studio или SQL Server Data Tools (SSDT)SQL Server Data Tools должна быть запущена под учетной записью, которая является членом предопределенной роли сервера sysadmin.or SQL Server Data Tools (SSDT)SQL Server Data Tools must be running under a Windows account that is a member of the sysadmin fixed server roll.

  • Окно редактора запросов компонента Компонент Database EngineDatabase Engine должно быть подключено с помощью имени входа для проверки подлинности Windows или SQL ServerSQL Server , которое является членом предопределенной роли сервера sysadmin.The Компонент Database EngineDatabase Engine Query Editor window must be connected by using either a Windows Authentication or SQL ServerSQL Server Authentication login that is a member of the sysadmin fixed server role.

  • Окно редактора запросов компонента Компонент Database EngineDatabase Engine должно быть подключено к экземпляру компонента Компонент Database EngineDatabase Engine из SQL Server 2005SQL Server 2005 с пакетом обновления 2 (SP2) или более поздней версии.The Компонент Database EngineDatabase Engine Query Editor window must be connected to an instance of the Компонент Database EngineDatabase Engine from SQL Server 2005SQL Server 2005 Service Pack 2 (SP2) or later. Когда окно редактора запросов подключено к экземпляру, работающему в однопользовательском режиме, отладчик запустить невозможно.You cannot run the debugger when the Query Editor window is connected to an instance that is in single-user mode.

  • Сервер должен обмениваться данными с клиентом через RPC.The server needs to communicate back to the client via RPC. Учетная запись, под которой запущена служба SQL Server должен иметь разрешения на проверку подлинности для клиента.The account under which SQL Server service is running should have authenticate permissions to the client

См. также:See Also