20240923 ropc

Author: WilliamDAssafMSFT

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-connect-overview.md

@@ -1,10 +1,10 @@
 ---
 title: Connect to a SQL pool in Azure Synapse
 description: Learn how to connect to an SQL pool in Azure Synapse.
-author: joannapea
-ms.author: joanpo
-ms.reviewer: wiassaf
-ms.date: 06/13/2022
+author: WilliamDAssafMSFT
+ms.author: wiassaf
+ms.reviewer: joanpo
+ms.date: 09/23/2024
 ms.service: azure-synapse-analytics
 ms.subservice: sql-dw
 ms.topic: conceptual
@@ -18,6 +18,9 @@ ms.custom:
 
 Get connected to a SQL pool in Azure Synapse.
 
+> [!IMPORTANT]
+> Use Microsoft Entra authentication when possible. For more information, see [Use Microsoft Entra authentication for authentication with Synapse SQL](active-directory-authentication.md). 
+
 ## Find your server name
 
 The server name in the following example is `sqlpoolservername.database.windows.net`. To find the fully qualified server name:
@@ -42,24 +45,32 @@ Here are examples of connection strings for popular drivers:
 
 ### ADO.NET connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ADO.NET is more secure and recommended](/sql/connect/ado-net/sql/azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true). 
+
 ```csharp
 Server=tcp:{your_server}.database.windows.net,1433;Database={your_database};User ID={your_user_name};Password={your_password_here};Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;
 ```
 
 ### ODBC connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ODBC is more secure and recommended](/sql/connect/odbc/using-azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```csharp
 Driver={SQL Server Native Client 11.0};Server=tcp:{your_server}.database.windows.net,1433;Database={your_database};Uid={your_user_name};Pwd={your_password_here};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;
 ```
 
 ### PHP connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with PHP is more secure and recommended](/sql/connect/php/azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```PHP
 Server: {your_server}.database.windows.net,1433 \r\nSQL Database: {your_database}\r\nUser Name: {your_user_name}\r\n\r\nPHP Data Objects(PDO) Sample Code:\r\n\r\ntry {\r\n   $conn = new PDO ( \"sqlsrv:server = tcp:{your_server}.database.windows.net,1433; Database = {your_database}\", \"{your_user_name}\", \"{your_password_here}\");\r\n    $conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );\r\n}\r\ncatch ( PDOException $e ) {\r\n   print( \"Error connecting to SQL Server.\" );\r\n   die(print_r($e));\r\n}\r\n\rSQL Server Extension Sample Code:\r\n\r\n$connectionInfo = array(\"UID\" => \"{your_user_name}\", \"pwd\" => \"{your_password_here}\", \"Database\" => \"{your_database}\", \"LoginTimeout\" => 30, \"Encrypt\" => 1, \"TrustServerCertificate\" => 0);\r\n$serverName = \"tcp:{your_server}.database.windows.net,1433\";\r\n$conn = sqlsrv_connect($serverName, $connectionInfo);
 ```
 
 ### JDBC connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with JDBC is more secure and recommended](/sql/connect/jdbc/connecting-using-azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true).
+
 ```Java
 jdbc:sqlserver://yourserver.database.windows.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;
 ```
@@ -75,6 +86,6 @@ SQL pool standardizes certain settings during connection and object creation. Th
 | [DATEFORMAT](/sql/t-sql/statements/set-dateformat-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) |mdy |
 | [DATEFIRST](/sql/t-sql/statements/set-datefirst-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) |7 |
 
-## Next steps
+## Related content
 
 To connect and query with Visual Studio, see [Query with Visual Studio](sql-data-warehouse-query-visual-studio.md). To learn more about authentication options, see [Authentication to Azure Synapse Analytics](sql-data-warehouse-authentication.md).

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-connection-strings.md

@@ -1,10 +1,10 @@
 ---
 title: Connection strings
 description: Connection strings for Synapse SQL pool
-author: joannapea
-ms.author: joanpo
-ms.reviewer: wiassaf
-ms.date: 04/17/2018
+author: WilliamDAssafMSFT
+ms.author: wiassaf
+ms.reviewer: joanpo
+ms.date: 09/23/2024
 ms.service: azure-synapse-analytics
 ms.subservice: sql-dw
 ms.topic: conceptual
@@ -17,35 +17,46 @@ ms.custom:
 
 You can connect to a SQL pool in Azure Synapse with several different application protocols such as, [ADO.NET](/dotnet/framework/data/adonet?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json), [ODBC](/sql/connect/odbc/windows/microsoft-odbc-driver-for-sql-server-on-windows?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true), [PHP](/sql/connect/php/overview-of-the-php-sql-driver?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true), and [JDBC](/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true). Below are some examples of connections strings for each protocol.  You can also use the Azure portal to build your connection string.  
 
+> [!IMPORTANT]
+> Use Microsoft Entra authentication when possible. For more information, see [Use Microsoft Entra authentication for authentication with Synapse SQL](active-directory-authentication.md). 
+
 To build your connection string using the Azure portal, navigate to your SQL pool blade, under *Essentials* click on *Show database connection strings*.
 
 ## Sample ADO.NET connection string
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ADO.NET is more secure and recommended](/sql/connect/ado-net/sql/azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true). 
+
 ```csharp
 Server=tcp:{your_server}.database.windows.net,1433;Database={your_database};User ID={your_user_name};Password={your_password_here};Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;
 ```
 
 ## Sample ODBC connection string
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ODBC is more secure and recommended](/sql/connect/odbc/using-azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```csharp
 Driver={SQL Server Native Client 11.0};Server=tcp:{your_server}.database.windows.net,1433;Database={your_database};Uid={your_user_name};Pwd={your_password_here};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;
 ```
 
 ## Sample PHP connection string
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with PHP is more secure and recommended](/sql/connect/php/azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```PHP
 Server: {your_server}.database.windows.net,1433 \r\nSQL Database: {your_database}\r\nUser Name: {your_user_name}\r\n\r\nPHP Data Objects(PDO) Sample Code:\r\n\r\ntry {\r\n   $conn = new PDO ( \"sqlsrv:server = tcp:{your_server}.database.windows.net,1433; Database = {your_database}\", \"{your_user_name}\", \"{your_password_here}\");\r\n    $conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );\r\n}\r\ncatch ( PDOException $e ) {\r\n   print( \"Error connecting to SQL Server.\" );\r\n   die(print_r($e));\r\n}\r\n\rSQL Server Extension Sample Code:\r\n\r\n$connectionInfo = array(\"UID\" => \"{your_user_name}\", \"pwd\" => \"{your_password_here}\", \"Database\" => \"{your_database}\", \"LoginTimeout\" => 30, \"Encrypt\" => 1, \"TrustServerCertificate\" => 0);\r\n$serverName = \"tcp:{your_server}.database.windows.net,1433\";\r\n$conn = sqlsrv_connect($serverName, $connectionInfo);
 ```
 
 ## Sample JDBC connection string
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with JDBC is more secure and recommended](/sql/connect/jdbc/connecting-using-azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true).
+
 ```Java
 jdbc:sqlserver://yourserver.database.windows.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;
 ```
 
 > [!NOTE]
 > Consider setting the connection timeout to 300 seconds in order to allow the connection to survive short periods of unavailability.
 
-## Next steps
+## Related content
 
 To start querying your SQL pool with Visual Studio and other applications, see [Query with Visual Studio](sql-data-warehouse-query-visual-studio.md).

articles/synapse-analytics/sql/connect-overview.md

@@ -1,27 +1,26 @@
 ---
 title: Connect to Synapse SQL
 description: Get connected to Synapse SQL.
-author: azaricstefan 
+author: WilliamDAssafMSFT
+ms.author: wiassaf
 ms.service: azure-synapse-analytics
 ms.topic: overview 
 ms.subservice: sql
-ms.date: 04/15/2020 
-ms.author: stefanazaric 
-ms.reviewer: whhender
+ms.date: 09/23/2024
+ms.reviewer: whhender, stefanazaric
 ms.custom: devx-track-csharp
 ---
-
 # Connect to Synapse SQL
-Get connected to the Synapse SQL capability in Azure Synapse Analytics.
 
-## Supported tools for serverless SQL pool
+Get connected to the Synapse SQL capability in Azure Synapse Analytics.
 
-[Azure Data Studio](/azure-data-studio/download-azure-data-studio) is fully supported starting from version 1.18.0. SSMS is partially supported starting from version 18.5, you can use it to connect and query only.
+> [!IMPORTANT]
+> Use Microsoft Entra authentication when possible. For more information, see [Use Microsoft Entra authentication for authentication with Synapse SQL](active-directory-authentication.md). 
 
 ## Find your server name
 
-The server name for the dedicated SQL pool in the following example is: showdemoweu.sql.azuresynapse.net.
-The server name for the serverless SQL pool in the following example is: showdemoweu-ondemand.sql.azuresynapse.net.
+The server name for the dedicated SQL pool in the following example is: `<server-name>.sql.azuresynapse.net`.
+The server name for the serverless SQL pool in the following example is: `<server-name>-ondemand.sql.azuresynapse.net`.
 
 To find the fully qualified server name:
 
@@ -30,14 +29,16 @@ To find the fully qualified server name:
 3. Select on the workspace you want to connect to.
 4. Go to overview.
 5. Locate the full server name.
+    - For a dedicated SQL pool, use **SQL Endpoint**.
+    - For the serverless SQL pool, use **SQL on-demand endpoint**.
 
-## **SQL pool**
+## Supported tools
 
-![Full server name](./media/connect-overview/server-connect-example.png)
+Use [Azure Data Studio](/azure-data-studio/download-azure-data-studio) or [SQL Server Management Studio (SSMS)](https://aka.ms/ssms).
 
-## **serverless SQL pool**
-
-![Full server name serverless SQL pool](./media/connect-overview/server-connect-example-sqlod.png)
+For serverless SQL pools:
+- [Azure Data Studio](/azure-data-studio/download-azure-data-studio) is fully supported starting from version 1.18.0. 
+- [SQL Server Management Studio](https://aka.ms/ssms) is partially supported starting from version 18.5, you can use it to connect and query only.
 
 ## Supported drivers and connection strings
 Synapse SQL supports [ADO.NET](/dotnet/framework/data/adonet/), [ODBC](/sql/connect/odbc/windows/microsoft-odbc-driver-for-sql-server-on-windows), [PHP](/sql/connect/php/overview-of-the-php-sql-driver?f=255&MSPPError=-2147217396), and [JDBC](/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server). To find the latest version and documentation, select one of the preceding drivers. To automatically generate the connection string for the driver that you're using from the Azure portal, select **Show database connection strings** from the preceding example. Following are also some examples of what a connection string looks like for each driver.
@@ -47,24 +48,32 @@ Synapse SQL supports [ADO.NET](/dotnet/framework/data/adonet/), [ODBC](/sql/conn
 
 ### ADO.NET connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ADO.NET is more secure and recommended](/sql/connect/ado-net/sql/azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true). 
+
 ```csharp
 Server=tcp:{your_server}.sql.azuresynapse.net,1433;Database={your_database};User ID={your_user_name};Password={your_password_here};Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;
 ```
 
 ### ODBC connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with ODBC is more secure and recommended](/sql/connect/odbc/using-azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```csharp
 Driver={SQL Server Native Client 11.0};Server=tcp:{your_server}.sql.azuresynapse.net,1433;Database={your_database};Uid={your_user_name};Pwd={your_password_here};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;
 ```
 
 ### PHP connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with PHP is more secure and recommended](/sql/connect/php/azure-active-directory?view=azure-sqldw-latest&preserve-view=true).
+
 ```PHP
 Server: {your_server}.sql.azuresynapse.net,1433 \r\nSQL Database: {your_database}\r\nUser Name: {your_user_name}\r\n\r\nPHP Data Objects(PDO) Sample Code:\r\n\r\ntry {\r\n   $conn = new PDO ( \"sqlsrv:server = tcp:{your_server}.sql.azuresynapse.net,1433; Database = {your_database}\", \"{your_user_name}\", \"{your_password_here}\");\r\n    $conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );\r\n}\r\ncatch ( PDOException $e ) {\r\n   print( \"Error connecting to SQL Server.\" );\r\n   die(print_r($e));\r\n}\r\n\rSQL Server Extension Sample Code:\r\n\r\n$connectionInfo = array(\"UID\" => \"{your_user_name}\", \"pwd\" => \"{your_password_here}\", \"Database\" => \"{your_database}\", \"LoginTimeout\" => 30, \"Encrypt\" => 1, \"TrustServerCertificate\" => 0);\r\n$serverName = \"tcp:{your_server}.sql.azuresynapse.net,1433\";\r\n$conn = sqlsrv_connect($serverName, $connectionInfo);
 ```
 
 ### JDBC connection string example
 
+This simple example uses SQL authentication, but [Microsoft Entra authentication with JDBC is more secure and recommended](/sql/connect/jdbc/connecting-using-azure-active-directory-authentication?view=azure-sqldw-latest&preserve-view=true).
+
 ```Java
 jdbc:sqlserver://yourserver.sql.azuresynapse.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.net;loginTimeout=30;
 ```
@@ -83,5 +92,6 @@ Synapse SQL standardizes some settings during connection and object creation. Th
 
 For executing **serverless SQL pool** queries, recommended tools are [Azure Data Studio](get-started-azure-data-studio.md) and Azure Synapse Studio.
 
-## Next steps
+## Related content
+
 To connect and query with Visual Studio, see [Query with Visual Studio](../sql-data-warehouse/sql-data-warehouse-query-visual-studio.md?context=/azure/synapse-analytics/context/context). To learn more about authentication options, see [Authentication to Synapse SQL](sql-authentication.md?tabs=provisioned).