Configurare le regole del firewall prima di eseguire il debugger TSQLConfigure firewall rules before running the TSQL Debugger

È necessario configurare regole di Windows Firewall per abilitare il debug di Transact-SQLTransact-SQL durante la connessione a un'istanza del Motore di databaseDatabase Engine eseguita in un computer diverso da Editor di query Motore di databaseDatabase Engine .Windows Firewall rules must be configured to enable Transact-SQLTransact-SQL debugging when connected to an instance of the Motore di databaseDatabase Engine that is running on a different computer than the Motore di databaseDatabase Engine Query Editor.

Configurazione del debugger Transact-SQLConfiguring the Transact-SQL Debugger

Il debugger Transact-SQLTransact-SQL include componenti sia sul lato server sia sul lato client.The Transact-SQLTransact-SQL debugger includes both server-side and client-side components. I componenti del debugger lato server vengono installati con ogni istanza del motore di database da SQL Server 2005SQL Server 2005 Service Pack 2 (SP2) o versione successiva.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. Sono inclusi i componenti del debugger lato client:The client-side debugger components are included:

  • In caso di installazione degli strumenti lato client da SQL Server 2008SQL Server 2008 o versione successiva.When you install the client-side tools from SQL Server 2008SQL Server 2008 or later.

  • In caso di installazione di Microsoft Visual Studio 2010 o versione successiva.When you install Microsoft Visual Studio 2010 or later.

  • In caso di installazione di SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) dal download Web.When you install SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) from the web download.

    Non esistono requisiti di configurazione per eseguire il debugger Transact-SQLTransact-SQL se SQL Server Management StudioSQL Server Management Studio o or SQL Server Data ToolsSQL Server Data Tools viene eseguito nello stesso computer dell'istanza del Motore di database di SQL ServerSQL 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 ToolsSQL Server Data Tools is running on the same computer as the instance of the Motore di database di SQL ServerSQL Server Database Engine. Per eseguire il debugger Transact-SQLTransact-SQL quando si è connessi a un'istanza remota del Motore di databaseDatabase Engine, è tuttavia necessario abilitare regole relative a programmi e porte in Windows Firewall in entrambi i computer.However, to run the Transact-SQLTransact-SQL debugger when connected to a remote instance of the Motore di databaseDatabase Engine, program and port rules in the Windows Firewall must be enabled on both computers. Tali regole possono essere create dall'installazione di SQL ServerSQL Server .These rules may be created by SQL ServerSQL Server setup. Se si verificano errori mentre si tenta di aprire una sessione di debug remoto, assicurarsi che nel computer siano definite le regole firewall indicate di seguito.If you get errors attempting to open a remote debugging session, ensure the following firewall rules are defined on your computer.

    Usare l'applicazione Windows Firewall con protezione avanzata per gestire le regole firewall.Use the Windows Firewall with Advanced Security application to manage the firewall rules. In Windows 7Windows 7 e Windows Server 2008 R2Windows Server 2008 R2aprire Pannello di controllo, fare clic su Windows Firewalle scegliere Impostazioni avanzate.In both Windows 7Windows 7 and Windows Server 2008 R2Windows Server 2008 R2, open Control Panel, open Windows Firewall, and select Advanced settings. In Windows Server 2008 R2Windows Server 2008 R2 è anche possibile aprire Service Manager, espandere Configurazione nel riquadro sinistro e quindi Windows Firewall con protezione avanzata.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.

Attenzione

È possibile che l'abilitazione di regole in Windows Firewall esponga il computer a rischi per la sicurezza, per bloccare i quali è progettato il firewall.Enabling rules in the Windows Firewall may expose your computer to security threats that the firewall is designed to block. L'abilitazione di regole per il debug remoto determina lo sblocco delle porte e dei programmi elencati in questo argomento.Enabling rules for remote debugging unblocks the ports and programs listed in this topic.

Regole firewall nel serverFirewall Rules on the Server

Nel computer in cui è in esecuzione l'istanza del Motore di databaseDatabase Engineusare Windows Firewall con protezione avanzata per specificare le seguenti informazioni:On the computer that is running the instance of the Motore di databaseDatabase Engine, use Windows Firewall with Advanced Security to specify the following information:

  • Aggiungere una regola di programma in entrata per sqlservr.exe.Add an inbound program rule for sqlservr.exe. È necessario disporre di una regola per ogni istanza che richiede il supporto di sessioni di debug remoto.You must have a rule for each instance that needs to support remote debugging sessions.

    1. Nel riquadro sinistro di Windows Firewall con protezione avanzatafare clic con il pulsante destro del mouse su Regole in entrata, quindi scegliere Nuova regola nel riquadro azioni.In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. Nella finestra di dialogo Tipo di regola selezionare Programma, quindi fare clic su Avanti.In the Rule Type dialog, select Program, and then click Next.

    3. Nella finestra di dialogo Programma selezionare Percorso programma e immettere il percorso completo di sqlservr.exe per questa istanza.In the Program dialog, select This program path: and enter the full path to sqlservr.exe for this instance. Per impostazione predefinita, il programma sqlservr.exe viene installato nel percorso C:\Programmi\Microsoft SQL Server\MSSQL13.NomeIstanza\MSSQL\Binn, dove NomeIstanza è MSSQLSERVER per l'istanza predefinita e il nome dell'istanza per qualsiasi istanza denominata.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. Nella finestra di dialogo Azione selezionare Consenti la connessione, quindi fare clic su Avanti.In the Action dialog, select Allow the connection, and click Next.

    5. Nella finestra di dialogo Profilo selezionare qualsiasi profilo che descrive l'ambiente di connessione del computer quando si vuole aprire una sessione di debug con l'istanza e scegliere Avanti.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. Nella finestra di dialogo Nome digitare un nome e una descrizione per questa regola, quindi fare clic su Fine.In the Name dialog, type a name and description for this rule and click Finish.

    7. Nell'elenco Regole in entrata fare clic con il pulsante destro del mouse sulla regola creata e quindi selezionare Proprietà nel riquadro azioni.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Selezionare la scheda Protocolli e porte .Select the Protocols and Ports tab.

    9. Selezionare TCP nel riquadro Tipo di protocollo , Porte dinamiche RPC nel riquadro Porta locale , quindi fare clic su Applicae OK.Select TCP in the Protocol type: box, select RPC Dynamic Ports in the Local port: box, click Apply, and then click OK.

  • Aggiungere una regola di programma in entrata per svchost.exe per abilitare le comunicazioni DCOM dalle sessioni di debug remoto.Add an inbound program rule for svchost.exe to enable DCOM communications from remote debugger sessions.

    1. Nel riquadro sinistro di Windows Firewall con protezione avanzatafare clic con il pulsante destro del mouse su Regole in entrata, quindi scegliere Nuova regola nel riquadro azioni.In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. Nella finestra di dialogo Tipo di regola selezionare Programma, quindi fare clic su Avanti.In the Rule Type dialog, select Program, and then click Next.

    3. Nella finestra di dialogo Programma selezionare Percorso programma e immettere il percorso completo di svchost.exe.In the Program dialog, select This program path: and enter the full path to svchost.exe. Per impostazione predefinita, svchost.exe è installato in %systemroot%\System32\svchost.exe.By default, svchost.exe is installed in %systemroot%\System32\svchost.exe.

    4. Nella finestra di dialogo Azione selezionare Consenti la connessione, quindi fare clic su Avanti.In the Action dialog, select Allow the connection, and click Next.

    5. Nella finestra di dialogo Profilo selezionare qualsiasi profilo che descrive l'ambiente di connessione del computer quando si vuole aprire una sessione di debug con l'istanza e scegliere Avanti.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. Nella finestra di dialogo Nome digitare un nome e una descrizione per questa regola, quindi fare clic su Fine.In the Name dialog, type a name and description for this rule and click Finish.

    7. Nell'elenco Regole in entrata fare clic con il pulsante destro del mouse sulla regola creata e quindi selezionare Proprietà nel riquadro azioni.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Selezionare la scheda Protocolli e porte .Select the Protocols and Ports tab.

    9. Selezionare TCP nel riquadro Tipo di protocollo , Agente mapping endpoint RPC nel riquadro Porta locale , quindi fare clic su Applicae OK.Select TCP in the Protocol type: box, select RPC Endpoint Mapper in the Local port: box, click Apply, and then click OK.

  • Se i criteri di dominio richiedono che le comunicazioni di rete vengano eseguite tramite IPSec, è necessario aggiungere anche regole in entrata per l'apertura delle porte UDP 4500 e UDP 500.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.

Regole firewall nel clientFirewall Rules on the Client

Nel computer in cui è in esecuzione l'editor di query Motore di databaseDatabase Engine , con l'installazione di SQL Server o di SQL Server Data ToolsSQL Server Data Tools potrebbe essere stato configurato Windows Firewall per consentire il debug remoto.On the computer that is running the Motore di databaseDatabase Engine Query Editor, the SQL Server setup or SQL Server Data ToolsSQL Server Data Tools setup may have configured the Windows Firewall to allow remote debugging.

Se si verificano errori nel tentativo di aprire una sessione di debug remoto, è possibile configurare manualmente le eccezioni relative a programmi e porte usando Windows Firewall con protezione avanzata per configurare regole firewall: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:

  • Aggiungere una voce di programma per svchost:Add a program entry for svchost:

    1. Nel riquadro sinistro di Windows Firewall con protezione avanzatafare clic con il pulsante destro del mouse su Regole in entrata, quindi scegliere Nuova regola nel riquadro azioni.In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. Nella finestra di dialogo Tipo di regola selezionare Programma, quindi fare clic su Avanti.In the Rule Type dialog, select Program, and then click Next.

    3. Nella finestra di dialogo Programma selezionare Percorso programma e immettere il percorso completo di svchost.exe.In the Program dialog, select This program path: and enter the full path to svchost.exe. Per impostazione predefinita, svchost.exe è installato in %systemroot%\System32\svchost.exe.By default, svchost.exe is installed in %systemroot%\System32\svchost.exe.

    4. Nella finestra di dialogo Azione selezionare Consenti la connessione, quindi fare clic su Avanti.In the Action dialog, select Allow the connection, and click Next.

    5. Nella finestra di dialogo Profilo selezionare qualsiasi profilo che descrive l'ambiente di connessione del computer quando si vuole aprire una sessione di debug con l'istanza e scegliere Avanti.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. Nella finestra di dialogo Nome digitare un nome e una descrizione per questa regola, quindi fare clic su Fine.In the Name dialog, type a name and description for this rule and click Finish.

    7. Nell'elenco Regole in entrata fare clic con il pulsante destro del mouse sulla regola creata e quindi selezionare Proprietà nel riquadro azioni.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Selezionare la scheda Protocolli e porte .Select the Protocols and Ports tab.

    9. Selezionare TCP nel riquadro Tipo di protocollo , Agente mapping endpoint RPC nel riquadro Porta locale , quindi fare clic su Applicae OK.Select TCP in the Protocol type: box, select RPC Endpoint Mapper in the Local port: box, click Apply, and then click OK.

  • Aggiungere una voce di programma per l'applicazione che ospita l'editor di query Motore di databaseDatabase Engine .Add a program entry for the application hosting the Motore di databaseDatabase Engine Query Editor. Se è necessario aprire le sessioni di debug remoto da SQL Server Management StudioSQL Server Management Studio e SQL Server Data ToolsSQL Server Data Tools nello stesso computer, è necessario aggiungere una regola di programma per entrambi:If you need to open remote debugging sessions from both SQL Server Management StudioSQL Server Management Studio and SQL Server Data ToolsSQL Server Data Tools on the same computer, you must add a program rule for both:

    1. Nel riquadro sinistro di Windows Firewall con protezione avanzatafare clic con il pulsante destro del mouse su Regole in entrata, quindi scegliere Nuova regola nel riquadro azioni.In Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules, and then select New Rule in the action pane.

    2. Nella finestra di dialogo Tipo di regola selezionare Programma, quindi fare clic su Avanti.In the Rule Type dialog, select Program, and then click Next.

    3. Nella finestra di dialogo Programma selezionare Percorso programma e immettere uno di questi tre valori.In the Program dialog, select This program path: and enter one of these three values.

      • Per SQL Server Management StudioSQL Server Management Studioimmettere il percorso completo di ssms.exe.For SQL Server Management StudioSQL Server Management Studio, enter the full path to ssms.exe. Per impostazione predefinita, ssms.exe viene installato nel percorso C:\Programmi (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.

      • Per SQL Server Data ToolsSQL Server Data Tools immettere il percorso completo di devenv.exe:For SQL Server Data ToolsSQL Server Data Tools enter the full path to devenv.exe:

        1. Per impostazione predefinita, devenv.exe per Visual Studio 2010 si trova in C:\Programmi (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. Per impostazione predefinita, devenv.exe per Visual Studio 2012 si trova in C:\Programmi (x86)\Microsoft Visual Studio 11.0\Common7\IDEBy default, the devenv.exe for Visual Studio 2012 is in C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE

        3. È possibile trovare il percorso di ssms.exe dal collegamento utilizzato per avviare 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. È possibile trovare il percorso di devenv.exe dal collegamento utilizzato per avviare SQL Server Data ToolsSQL Server Data Tools.You can find the path to devenv.exe from the shortcut you use to launch SQL Server Data ToolsSQL Server Data Tools. Fare clic con il pulsante destro del mouse sul collegamento, quindi scegliere Proprietà.Right click the shortcut and select Properties. Il file eseguibile e il percorso vengono elencati nel riquadro Destinazione .The executable and path are listed in the Target box.

    4. Nella finestra di dialogo Azione selezionare Consenti la connessione, quindi fare clic su Avanti.In the Action dialog, select Allow the connection, and click Next.

    5. Nella finestra di dialogo Profilo selezionare qualsiasi profilo che descrive l'ambiente di connessione del computer quando si vuole aprire una sessione di debug con l'istanza e scegliere Avanti.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. Nella finestra di dialogo Nome digitare un nome e una descrizione per questa regola, quindi fare clic su Fine.In the Name dialog, type a name and description for this rule and click Finish.

    7. Nell'elenco Regole in entrata fare clic con il pulsante destro del mouse sulla regola creata e quindi selezionare Proprietà nel riquadro azioni.In the Inbound Rules list, right click the rule you created, and then select Properties in the action pane.

    8. Selezionare la scheda Protocolli e porte .Select the Protocols and Ports tab.

    9. Selezionare TCP nel riquadro Tipo di protocollo , Porte dinamiche RPC nel riquadro Porta locale , quindi fare clic su Applicae OK.Select TCP in the Protocol type: box, select RPC Dynamic Ports in the Local port: box, click Apply, and then click OK.

Requisiti per l'avvio del debuggerRequirements for Starting the Debugger

Qualsiasi tentativo di avviare il debugger Transact-SQLTransact-SQL deve soddisfare anche i requisiti seguenti:All attempts to start the Transact-SQLTransact-SQL debugger must also meet the following requirements:

  • SQL Server Management StudioSQL Server Management Studio o SQL Server Data ToolsSQL Server Data Tools deve essere eseguito con un account di Windows membro del ruolo predefinito del server sysadmin. must be running under a Windows account that is a member of the sysadmin fixed server roll.

  • La finestra dell'editor di query del Motore di databaseDatabase Engine deve essere connessa tramite un account di accesso con autenticazione di Windows o con autenticazione di SQL ServerSQL Server che sia membro del ruolo predefinito del server sysadmin.The Motore di databaseDatabase 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.

  • La finestra dell'editor di query del Motore di databaseDatabase Engine deve essere connessa a un'istanza del Motore di databaseDatabase Engine da SQL Server 2005SQL Server 2005 Service Pack 2 (SP2) o versione successiva.The Motore di databaseDatabase Engine Query Editor window must be connected to an instance of the Motore di databaseDatabase Engine from SQL Server 2005SQL Server 2005 Service Pack 2 (SP2) or later. Non è possibile eseguire il debugger quando la finestra dell'editor di query è connessa a un'istanza che è in modalità utente singolo.You cannot run the debugger when the Query Editor window is connected to an instance that is in single-user mode.

  • Il server deve ricomunicare con il client tramite RPC.The server needs to communicate back to the client via RPC. L'account su cui è in esecuzione il servizio SQL Server deve disporre delle autorizzazioni di autenticazione per il client.The account under which SQL Server service is running should have authenticate permissions to the client

Vedere ancheSee Also

Debugger Transact-SQL Transact-SQL Debugger
Esecuzione del debugger Transact-SQL Run the Transact-SQL Debugger
Esecuzione istruzione per istruzione del codice Transact-SQL Step Through Transact-SQL Code
Informazioni del debugger Transact-SQL Transact-SQL Debugger Information
Editor di query del Motore di database (SQL Server Management Studio) Database Engine Query Editor (SQL Server Management Studio)