Поделиться через

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

  • Статья

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

Внимание

По возможности используйте проверку подлинности Microsoft Entra. Дополнительные сведения см. в статье Использование Microsoft Entra для проверки подлинности в Synapse SQL.

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

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

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

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

Примечание.

Рекомендуем задать время ожидания подключения, равное 300 секундам, чтобы подключение могло выдерживать короткие периоды недоступности.

Пример строки подключения 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 стандартизирует некоторые параметры при установке подключения и создании объектов. Такие параметры нельзя переопределить. К ним относятся следующие:

Параметр базы данных Значение
ANSI_NULLS DNS
QUOTED_IDENTIFIERS DNS
DATEFORMAT mdy
DATEFIRST 7

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

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

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

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