Udostępnij za pośrednictwem


Nawiązywanie połączenia z usługą Synapse SQL

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

Ważne

Jeśli to możliwe, użyj uwierzytelniania Entra firmy Microsoft. Aby uzyskać więcej informacji, zobacz Używanie uwierzytelniania usługi Microsoft Entra ID do uwierzytelniania za pomocą usługi Synapse SQL.

Znajdowanie nazwy serwera

Nazwa serwera dedykowanej puli SQL w poniższym przykładzie to: <server-name>.sql.azuresynapse.net. Nazwa serwera dla bezserwerowej puli SQL w poniższym przykładzie to: <server-name>-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.
    • W przypadku dedykowanej puli SQL użyj punktu końcowego SQL.
    • W przypadku bezserwerowej puli SQL użyj punktu końcowego SQL na żądanie.

Obsługiwane narzędzia

Użyj programu Azure Data Studio lub PROGRAMU SQL Server Management Studio (SSMS).

W przypadku bezserwerowych pul SQL:

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

W tym prostym przykładzie użyto uwierzytelniania SQL, ale uwierzytelnianie firmy Microsoft entra z ADO.NET jest bezpieczniejsze i zalecane.

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

W tym prostym przykładzie użyto uwierzytelniania SQL, ale uwierzytelnianie firmy Microsoft entra z odBC jest bezpieczniejsze i zalecane.

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

W tym prostym przykładzie użyto uwierzytelniania SQL, ale uwierzytelnianie microsoft Entra w języku PHP jest bezpieczniejsze i zalecane.

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

W tym prostym przykładzie użyto uwierzytelniania SQL, ale uwierzytelnianie entra firmy Microsoft z protokołem JDBC jest bezpieczniejsze i zalecane.

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.

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).