diff --git a/docs/img/database-access/azure-data-studio-connection.png b/docs/img/database-access/azure-data-studio-connection.png new file mode 100644 index 0000000000000..df7e363f75630 Binary files /dev/null and b/docs/img/database-access/azure-data-studio-connection.png differ diff --git a/docs/img/database-access/msft-sql-server-management-studio-connection.png b/docs/img/database-access/msft-sql-server-management-studio-connection.png new file mode 100644 index 0000000000000..1606266edd9f9 Binary files /dev/null and b/docs/img/database-access/msft-sql-server-management-studio-connection.png differ diff --git a/docs/pages/connect-your-client/gui-clients.mdx b/docs/pages/connect-your-client/gui-clients.mdx index e1412aceb2ab2..cbc27f15c589d 100644 --- a/docs/pages/connect-your-client/gui-clients.mdx +++ b/docs/pages/connect-your-client/gui-clients.mdx @@ -166,6 +166,28 @@ your GUI client below. When entering the hostname, use `localhost` rather than +## SQL Server with Azure Data Studio + +In Azure Data Studio create a connection using your proxy's endpoint. This is +`localhost,62652` in the example above. On a Windows machine, using an address in + the format `127.0.0.1,62652` could be required instead of `localhost`. (See +[Get connection information](./gui-clients.mdx#get-connection-information) for +more information.) + +Create a connection with Microsoft SQL Server with these settings: + +|Connection Detail|Value| +|---|---| +|Server|`host`,`port` of proxy endpoint| +|Authentication Type|SQL Login| +|Password|empty| +|Encrypt|`False`| + +Example: +![Azure Data Studio connection options](../../img/database-access/azure-data-studio-connection.png) + +Click **Connect** to connect. + ## PostgreSQL pgAdmin 4 [pgAdmin 4](https://www.pgadmin.org/) is a popular graphical client for @@ -311,6 +333,29 @@ empty: Click "OK" to connect. +## Microsoft SQL Server Management Studio + +In Microsoft SQL Server Management Studio connect to a database engine using +your proxy's endpoint. This is `localhost,62652` in the example above. Using +the IP `127.0.0.1,62652` connection could be required on a Windows machine +instead of `localhost`. (See [Get connection information](./gui-clients.mdx#get-connection-information) for +more information.) + +Create a connection with Microsoft SQL Server with these settings: + +|Connection Detail|Value| +|---|---| +|Server type|Database Engine| +|Server name|`host`,`port` of proxy endpoint| +|Authentication|SQL Server Authentication| +|Password|empty| +|Encryption|do not enable| + +Example: +[Microsoft SQL Server Management Studio connection options](../../img/database-access/msft-sql-server-management-studio-connection.png) + +Click Connect to connect. + ## Redis Insight diff --git a/docs/pages/database-access/guides/sql-server-ad.mdx b/docs/pages/database-access/guides/sql-server-ad.mdx index 619ca4eab2e55..6a9dd0c3043d8 100644 --- a/docs/pages/database-access/guides/sql-server-ad.mdx +++ b/docs/pages/database-access/guides/sql-server-ad.mdx @@ -361,11 +361,18 @@ $ tsh db connect --db-user=teleport sqlserver ``` - The `mssql-cli` command-line client should be available in `PATH` of the machine - you're running `tsh db connect` from. - - `mssql-cli` is not required for SQL Server connections. Use `tsh proxy db --db-user=teleport --tunnel sqlserver` - to connect from other DB Clients such as Microsoft SQL Server Management Studio. +When you run the `tsh db connect` command above, `tsh` attempts to execute +the `mssql-cli` command-line client, which must be available in the user's +`PATH`. If you do not have `mssql-cli` available on your system, you can run the +following command to start a local proxy server that you can connect +to with your SQL Server client: + +```code +$ tsh proxy db --db-user=teleport --tunnel sqlserver +``` + +Read the [Database Access GUI Clients](../../connect-your-client/gui-clients.mdx#sql-server-with-azure-data-studio) +guide for how to connect your DB GUI client to the local proxy. To log out of the database and remove credentials: