Merge pull request #287220 from WilliamDAssafMSFT/20240923-ropc

20240923 ropc

Author: v-ccolin

articles/storage/blobs/data-lake-storage-use-sql.md

@@ -3,13 +3,11 @@ title: 'Tutorial: Azure Data Lake Storage, Azure Synapse'
 titleSuffix: Azure Storage
 description: This tutorial shows how to run SQL queries on an Azure Synapse serverless SQL endpoint to access data in an Azure Data Lake Storage enabled storage account.
 author: jovanpop-msft
-
 ms.service: azure-data-lake-storage
 ms.topic: tutorial
 ms.date: 03/07/2022
 ms.author: normesta
 ms.custom: devx-track-sql
-#Customer intent: As an data engineer, I want to connect my data in Azure Storage so that I can easily run analytics on it.
 ---
 
 # Tutorial: Query Azure Data Lake Storage using SQL language in Synapse Analytics
@@ -43,18 +41,18 @@ This tutorial uses flight data from the Bureau of Transportation Statistics. You
 
 1. Download the [On_Time_Reporting_Carrier_On_Time_Performance_1987_present_2016_1.zip](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/tutorials/On_Time_Reporting_Carrier_On_Time_Performance_1987_present_2016_1.zip) file. This file contains the flight data.
 
-2. Unzip the contents of the zipped file and make a note of the file name and the path of the file. You need this information in a later step.
+1. Unzip the contents of the zipped file and make a note of the file name and the path of the file. You need this information in a later step.
 
 ### Copy source data into the storage account
 
 1. Navigate to your new storage account in the Azure portal.
 
-2. Select **Storage browser**->**Blob containers**->**Add container** and create a new container named **data**.
+1. Select **Storage browser**->**Blob containers**->**Add container** and create a new container named **data**.
 
    > [!div class="mx-imgBorder"]
    > ![Screenshot of creating a folder in storage browser](./media/data-lake-storage-events/data-container.png)
 
-6. In storage browser, upload the `On_Time_Reporting_Carrier_On_Time_Performance_1987_present_2016_1.csv` file to the **data** folder.
+1. In storage browser, upload the `On_Time_Reporting_Carrier_On_Time_Performance_1987_present_2016_1.csv` file to the **data** folder.
 
 ## Create an Azure Synapse workspace
 
@@ -78,8 +76,8 @@ To find the fully qualified server name:
 1. Select on the workspace you want to connect to.
 2. Go to overview.
 3. Locate the full server name.
-
-   ![Full server name serverless SQL pool](../../synapse-analytics/sql/media/connect-overview/server-connect-example-sqlod.png)
+   - For a dedicated SQL pool, use **SQL Endpoint**.
+   - For the serverless SQL pool, use **SQL on-demand endpoint**.
 
 In this tutorial, you use Synapse Studio to query data from the CSV file that you uploaded to the storage account.
 
@@ -106,7 +104,7 @@ In this tutorial, you use Synapse Studio to query data from the CSV file that yo
 
 When they're no longer needed, delete the resource group and all related resources. To do so, select the resource group for the storage account and workspace, and then and select **Delete**.
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Azure Data Lake Storage, Azure Databricks & Spark](data-lake-storage-use-databricks-spark.md)

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](../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.  
 
-To build your connection string using the Azure portal, navigate to your SQL pool blade, under *Essentials* click on *Show database connection strings*.
+> [!IMPORTANT]
+> Use Microsoft Entra authentication when possible. For more information, see [Use Microsoft Entra authentication for authentication with Synapse SQL](../sql/active-directory-authentication.md). 
+
+To build your connection string using the Azure portal, navigate to your SQL pool blade, under **Essentials** select **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).