Teilen über

Herstellen einer Verbindung mit Synapse SQL

  • Artikel

Stellen Sie eine Verbindung mit der Synapse SQL-Funktion in Azure Synapse Analytics her.

Wichtig

Verwenden Sie nach Möglichkeit die Microsoft Entra-Authentifizierung. Für weitere Informationen, siehe Verwendung der Microsoft Entra-Authentifizierung für die Authentifizierung mit Synapse SQL.

Suchen des Servernamens

Der Servername für den dedizierten SQL-Pool im folgenden Beispiel lautet <server-name>.sql.azuresynapse.net. Der Servername für den serverlosen SQL-Pool im folgenden Beispiel lautet <server-name>-ondemand.sql.azuresynapse.net.

So ermitteln Sie den vollqualifizierten Servernamen

  1. Öffnen Sie das Azure-Portal.
  2. Wählen Sie Synapse workspaces (Synapse-Arbeitsbereiche) aus.
  3. Wählen Sie den Arbeitsbereich aus, mit dem Sie eine Verbindung herstellen möchten.
  4. Navigieren Sie zur Übersicht.
  5. Suchen Sie den vollständigen Servernamen.
    • Verwenden Sie für einen dedizierten SQL-Pool den SQL-Endpunkt.
    • Verwenden Sie für den serverlosen SQL-Pool den SQL On-Demand-Endpunkt.

Unterstützte Tools

Verwenden Sie Azure Data Studio oder SQL Server Management Studio (SSMS).

Für serverlose SQL-Pools:

  • Azure Data Studio wird ab Version 1.18.0 vollständig unterstützt.
  • SQL Server Management Studio wird ab Version 18.5 teilweise unterstützt, kann aber nur zum Herstellen einer Verbindung und für Abfragen verwendet werden.

Unterstützte Treiber und Verbindungszeichenfolgen

Synapse SQL unterstützt ADO.NET, ODBC, PHP und JDBC. Um zur neuesten Version und Dokumentation zu gelangen, wählen Sie einen der genannten Treiber aus. Zur automatischen Erstellung der Verbindungszeichenfolge für den verwendeten Treiber wählen Sie im Azure-Portal die Option Datenbank-Verbindungszeichenfolgen anzeigen aus, wie im vorherigen Beispiel zu sehen. Im Anschluss finden Sie auch einige Beispielverbindungszeichenfolgen für die einzelnen Treiber.

Hinweis

Es empfiehlt sich, das Verbindungstimeout auf 300 Sekunden festzulegen, damit die Verbindung bei kurzen Ausfällen bestehen bleibt.

Beispielverbindungszeichenfolge für ADO.NET

In diesem einfachen Beispiel wird die SQL-Authentifizierung verwendet, die Microsoft Entra-Authentifizierung mit ADO.NET ist jedoch sicherer und wird daher empfohlen.

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;

Beispielverbindungszeichenfolge für ODBC

In diesem einfachen Beispiel wird die SQL-Authentifizierung verwendet, die Microsoft Entra-Authentifizierung mit ODBC ist jedoch sicherer und wird daher empfohlen.

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;

Beispielverbindungszeichenfolge für PHP

In diesem einfachen Beispiel wird die SQL-Authentifizierung verwendet, die Microsoft Entra-Authentifizierung mit PHP ist jedoch sicherer und wird daher empfohlen.

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

Beispielverbindungszeichenfolge für JDBC

In diesem einfachen Beispiel wird die SQL-Authentifizierung verwendet, die Microsoft Entra-Authentifizierung mit JDBC ist jedoch sicherer und wird daher empfohlen.

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;

Verbindungseinstellungen

Bei der Verbindungs- und Objekterstellung werden von Synapse SQL einige Einstellungen standardisiert. Diese Einstellungen können nicht überschrieben werden, und zu ihnen gehören:

Datenbankeinstellung Wert
ANSI_NULLS EIN
QUOTED_IDENTIFIERS EIN
DATEFORMAT dmy
DATEFIRST 7

Empfehlungen

Für die Ausführung von Abfragen einesserverlosen SQL-Pools werden Azure Data Studio und Azure Synapse Studio empfohlen.

Zugehöriger Inhalt

Informationen zum Herstellen einer Verbindung und zum Durchführen von Abfragen mit Visual Studio finden Sie unter Abfragen von Azure SQL Data Warehouse (Visual Studio). Weitere Informationen zu Authentifizierungsoptionen finden Sie unter Authentifizieren bei Azure Synapse Analytics.