使用英语阅读

通过

Synapse SQL 的连接字符串

  • 项目
  • 2025/04/24

可以使用几种不同的应用程序库（例如 ADO.NET、ODBC、PHP 和 JDBC）连接到 Synapse SQL。 下面是每个库的连接字符串的一些示例。

重要

尽可能使用 Microsoft Entra 身份验证。 更多信息请参阅 使用 Microsoft Entra 进行 Synapse SQL 身份验证。

可以使用 Azure 门户来生成连接字符串。 若要使用 Azure 门户生成连接字符串，请导航到数据库边栏选项卡，在“概要”下选择“显示数据库连接字符串”。

示例 ADO.NET 连接字符串

此简单示例使用了 SQL 身份验证，但建议通过 ADO.NET 进行更加安全的 Microsoft Entra 身份验证。

Server=tcp:{your_server}.sql.azuresynapse.azure.cn,1433;Database={your_database};User ID={your_user_name};Password={your_password_here};Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

示例 ODBC 连接字符串

此简单示例使用了 SQL 身份验证，但建议通过 ODBC 进行更加安全的 Microsoft Entra 身份验证。

Driver={ODBC Driver 18 for SQL Server};Server=tcp:{your_server}.sql.azuresynapse.azure.cn,1433;Database={your_database};Uid={your_user_name};Pwd={your_password_here};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;

示例 PHP 连接字符串

此简单示例使用了 SQL 身份验证，但建议通过 PHP 进行更加安全的 Microsoft Entra 身份验证。

Server: {your_server}.sql.azuresynapse.azure.cn,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.azure.cn,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.azure.cn,1433\";\r\n$conn = sqlsrv_connect($serverName, $connectionInfo);

示例 JDBC 连接字符串

此简单示例使用了 SQL 身份验证，但建议通过 JDBC 进行更加安全的 Microsoft Entra 身份验证。

jdbc:sqlserver://yourserver.sql.azuresynapse.azure.cn:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.azure.cn;loginTimeout=30;

备注

请考虑将连接超时设置为 300 秒，以便连接能够在短暂不可用的情况下继续保持有效，并为暂停的实例提供足够的时间来恢复。

建议

若要执行无服务器 SQL 池查询，建议使用 Azure Data Studio 和 Azure Synapse Studio 这两个工具。

相关内容

若要开始使用 Visual Studio 和其他应用程序来查询分析，请参阅使用 Visual Studio 进行查询。