Połączenie do usługi Synapse SQL

Połącz się z możliwością usługi Synapse SQL w usłudze Azure Synapse Analytics.

Obsługiwane narzędzia dla bezserwerowej puli SQL

Usługa Azure Data Studio jest w pełni obsługiwana od wersji 1.18.0. Program SSMS jest częściowo obsługiwany od wersji 18.5. Można go używać do nawiązywania połączenia i wykonywania tylko zapytań.

Znajdowanie nazwy serwera

Nazwa serwera dedykowanej puli SQL w poniższym przykładzie to: showdemoweu.sql.azuresynapse.net. Nazwa serwera dla bezserwerowej puli SQL w poniższym przykładzie to: showdemoweu-ondemand.sql.azuresynapse.net.

Aby znaleźć w pełni kwalifikowaną nazwę serwera:

  1. Przejdź do portalu Azure Portal.
  2. Wybierz pozycję W obszarach roboczych usługi Synapse.
  3. Wybierz obszar roboczy, z którym chcesz nawiązać połączenie.
  4. Przejdź do przeglądu.
  5. Znajdź pełną nazwę serwera.

Pula SQL

Full server name

bezserwerowa pula SQL

Full server name serverless SQL pool

Obsługiwane sterowniki i parametry połączenia

Usługa Synapse SQL obsługuje ADO.NET, ODBC, PHP i JDBC. Aby znaleźć najnowszą wersję i dokumentację, wybierz jeden z powyższych sterowników. Aby automatycznie wygenerować parametry połączenia dla sterownika używanego w witrynie Azure Portal, wybierz pozycję Pokaż parametry połączenia bazy danych z poprzedniego przykładu. Poniżej przedstawiono również przykłady parametrów połączenia dla każdego sterownika.

Uwaga

Rozważ ustawienie limitu czasu połączenia na wartość 300 sekund, aby połączenie nie zostało zakończone mimo krótkich okresów niedostępności.

Przykład parametrów połączenia sterownika 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;

Przykład parametrów połączenia sterownika 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;

Przykład parametrów połączenia sterownika 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);

Przykład parametrów połączenia sterownika 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;

Ustawienia połączenia

Usługa Synapse SQL standandaryzuje niektóre ustawienia podczas tworzenia połączenia i obiektu. Tych ustawień nie można zastąpić i uwzględnić:

Ustawienia bazy danych Wartość
ANSI_NULLS ON
QUOTED_IDENTIFIERS ON
DATEFORMAT mdy
DATEFIRST 7

Zalecenia

Do wykonywania bezserwerowych zapytań puli SQL zalecane narzędzia to Azure Data Studio i Azure Synapse Studio.

Następne kroki

Aby nawiązać połączenie i rozpocząć tworzenie zapytań przy użyciu programu Visual Studio, zobacz artykuł Query with Visual Studio (Wykonywanie zapytań przy użyciu programu Visual Studio). Aby dowiedzieć się więcej na temat opcji uwierzytelniania, zobacz Authentication to Synapse SQL (Uwierzytelnianie w usłudze Synapse SQL).