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

  • Статья

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

Поддерживаемые средства для бессерверного пула SQL

Azure Data Studio полностью поддерживается, начиная с версии 1.18.0. SSMS частично поддерживается, начиная с версии 18.5, и используется только для подключения и выполнения запросов.

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

Имя сервера для выделенного пула SQL в приведенном ниже примере — showdemoweu.sql.azuresynapse.net. Имя сервера для бессерверного пула SQL в приведенном ниже примере — showdemoweu-ondemand.sql.azuresynapse.net.

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

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

Пул SQL

Full server name

Бессерверный пул SQL

Full server name serverless SQL pool

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

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

Примечание.

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

Пример строки подключения 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

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

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

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.