PhpStorm 2019.3 Help

How to connect to MS SQL server

Prerequisites

Step 1. Configure the SQL Server Configuration Manager

To open SQL Server Configuration Manager, open the Search dialog on Windows and type SQLServerManager14.msc (for Microsoft SQL Server 2017). Double-click the found result. If you use other versions of Microsoft SQL Server, change the second digit before .msc:

  • SQLServerManager13.msc for SQL Server 2016

  • SQLServerManager12.msc for SQL Server 2014

  • SQLServerManager11.msc for SQL Server 2012

Run the SQL Server Browser

SQL Server Browser listens for incoming requests and provides information about Microsoft SQL Server instances on the computer. For more information about SQL Server Browser, see SQL Server Browser in the Microsoft documentation.

If the SQL Server Browser menu items are disabled, try to enable the SQL Server Agent service.

  1. In the SQL Server Configuration Manager, click SQL Server Services.

  2. In the right pane that lists server services, right-click SQL Server Browser and select Start.

Enable SQL Server Agent

SQL Server Agent is a Microsoft Windows service that executes scheduled administrative tasks. For more information about the service, see SQL Server Agent in the official Microsoft documentation. Ensure that SQL Server Agent is running and starts automatically. After the change, a restart might be required.

  1. Navigate to Control Panel | Administrative Tools | Services.

  2. In the Services window, right-click SQL Server Agent(<server_name>) and select Properties. For this tutorial, <server_name> is MSSQLSERVER.

  3. From the Startup type list, select Automatic and click Start.

Enable the TCP/IP connection

  1. In the SQL Server Configuration Manager, expand SQL Server Configuration and click Protocols for MSSQLSERVER, where MSSQLSERVER is a name of the Microsoft SQL Server instance.

  2. In the list of protocol names, right-click TCP/IP and select Properties.

  3. On the Protocol tab, from the Enabled list, select Yes.

  4. On the IP Addresses tab, find the interface that your workstation uses and see the connection port. By default, the port is 1433. Verify that other running applications do not use the same port.

Step 2. Configure SQL Server Management Studio (SSMS)

Create a user

  1. In the SQL Server Management Studio (SSMS), navigate to Security | Logins.

  2. Right-click the Logins root folder and select New Login.

  3. On the General page, specify a login name in the Login name field.

  4. Select authentication mode. You can select between the following authentication modes:

    • Windows authentication: to use your domain login and password.

    • SQL Server authentication: to use a custom login and password. If you select Enforce password security policy checkbox, the user must change the assigned password before connecting to Microsoft SQL Server with PhpStorm. Otherwise, clear the Enforce password security policy checkbox.

  5. Click OK.

Configure user roles

  1. Right-click the created user profile and select Properties.

  2. On the Server Roles page, select the appropriate user role (for example, sysadmin).

Step 3. Connect to Microsoft SQL Server with PhpStorm

The following section describes configuration of PhpStorm on Windows, macOS, and Linux. Note that the Use Windows domain authentication checkbox is available only on Windows. To configure Windows domain authentication on macOS and Linux, see Connect by using Windows domain authentication.

Windows

Connect by using SQL Server authentication

  1. Navigate to File | Data Sources Ctrl+Alt+S.

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Microsoft SQL Server.

  3. At the bottom of the data source settings area, click the Download missing driver files link. Alternatively, you can specify user drivers for the data source. For more information about user drivers, see Add a user driver to an existing connection.

  4. In Host, Instance, and Port fields, specify your connection details.

  5. Clear the Use Windows domain authentication checkbox.

  6. In User and Password fields, specify your credentials

  7. To ensure that the connection to the data source is successful, click Test Connection.

Connect by using Windows domain authentication

  1. Navigate to File | Data Sources Ctrl+Alt+S.

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Microsoft SQL Server.

  3. At the bottom of the data source settings area, click the Download missing driver files link. Alternatively, you can specify user drivers for the data source. For more information about user drivers, see Add a user driver to an existing connection.

  4. In Host, Instance, and Port fields, specify your connection details.

  5. Ensure that the Use Windows domain authentication checkbox is selected.

    Alternatively, you need to specify your domain in the domain option on the Advanced tab and your Windows domain credentials on the General tab.

  6. To ensure that the connection to the data source is successful, click Test Connection.

macOS and Linux

Connect by using SQL Server authentication

  1. Navigate to File | Data Sources Ctrl+Alt+S.

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Microsoft SQL Server.

  3. At the bottom of the data source settings area, click the Download missing driver files link. Alternatively, you can specify user drivers for the data source. For more information about user drivers, see Add a user driver to an existing connection.

  4. In Host, Instance, and Port fields, specify your connection details.

  5. In User and Password fields, specify your credentials.

  6. To ensure that the connection to the data source is successful, click Test Connection.

Connect by using Windows domain authentication

  1. Navigate to File | Data Sources Ctrl+Alt+S.

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Microsoft SQL Server.

  3. From the Driver list, select Microsoft SQL Server (jTds).

  4. At the bottom of the data source settings area, click the Download missing driver files link. Alternatively, you can specify user drivers for the data source. For more information about user drivers, see Add a user driver to an existing connection.

  5. In Host, Instance, and Port fields, specify your connection details.

  6. In User and Password fields, specify your domain credentials. In the User field, type your domain user without the domain prefix (for example, John.Smith instead of DOMAIN\John.Smith).

  7. Click the Advanced tab. In the table with options, search for the domain option and specify the name of your domain.

    Alternatively, on the General tab, in the URL string, you can add ;domain=your_domain.

    In this case, consider the following example of a full connection string:

    jdbc:jtds:sqlserver://UNIT-670:1433;domain=DEVELOPMENT;instance=MSSQLSERVER;databaseName=guest;
  8. To ensure that the connection to the data source is successful, click Test Connection.

Last modified: 20 February 2020