Подключение к Synapse SQL

Установите подключение к функции Synapse SQL в Azure Synapse Analytics.

Поиск имени сервера

Имя сервера выделенного пула SQL в следующем примере: <server-name>.sql.azuresynapse.net Имя сервера для бессерверного пула SQL в приведенном ниже примере — <server-name>-ondemand.sql.azuresynapse.net.

Чтобы найти полное имя сервера, сделайте следующее.

1. Переход на портал Azure.
2. Выберите Рабочие области Synapse.
3. Выберите рабочую область, к которой нужно подключиться.
4. Перейдите на вкладку "Обзор".
5. Найдите полное имя сервера.
   • Для выделенного пула SQL используйте SQL Endpoint.
   • Для бессерверного пула SQL используйте конечную точку SQL по требованию.

Поддерживаемые инструменты

Используйте Azure Data Studio или SQL Server Management Studio (SSMS).

Для бессерверных пулов SQL:

• Azure Data Studio полностью поддерживается, начиная с версии 1.18.0.
• SQL Server Management Studio частично поддерживается начиная с версии 18.5, ее можно использовать только для подключения и запроса.

Поддерживаемые драйверы и строки подключения

Synapse SQL поддерживает ADO.NET, ODBC, PHP и JDBC. Выберите один из указанных типов драйверов для получения информации об обновлениях и документации. Чтобы автоматически создать строку подключения для используемого драйвера на портале Azure, щелкните Показать строки подключения к базам данных на странице из предыдущего примера. Ниже приведены примеры синтаксиса строк подключения для каждого драйвера.

Пример строки подключения ADO.NET

В этом простом примере используется проверка подлинности SQL, но проверка подлинности Microsoft Entra с ADO.NET более безопасна и рекомендуется.

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

В этом простом примере используется проверка подлинности SQL, но проверка подлинности Microsoft Entra с ODBC более безопасна и рекомендуется.

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

В этом простом примере используется проверка подлинности SQL, но проверка подлинности Microsoft Entra с помощью 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

В этом простом примере используется проверка подлинности SQL, но проверка подлинности Microsoft Entra с помощью JDBC более безопасна и рекомендуется.

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;

Параметры подключения

Synapse SQL стандартизирует некоторые параметры во время установления подключения и создания объектов. Такие параметры нельзя переопределить. К ним относятся следующие:

Рекомендации

Для выполнения запросов бессерверного пула SQL мы рекомендуем использовать Azure Data Studio и Azure Synapse Studio.

Связанный контент

Чтобы подключиться и отправлять запросы с помощью Visual Studio, см. Запросы с помощью Visual Studio. Подробные сведения о способах проверки подлинности см. в статье Проверка подлинности в Synapse SQL.