Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
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
- Öffnen Sie das Azure-Portal.
- Wählen Sie Synapse-Arbeitsbereiche aus.
- Wählen Sie den Arbeitsbereich aus, mit dem Sie eine Verbindung herstellen möchten.
- Navigieren Sie zur Übersicht.
- Suchen Sie den vollständigen Servernamen.
- Für einen dedizierten SQL-Pool verwenden Sie SQL Endpunkt.
- Für den Serverless SQL-Pool verwenden Sie SQL on-demand Endpunkt.
Unterstützte Tools
Verwenden Sie SQL Server Management Studio (SSMS) oder die MSSQL-Erweiterung für Visual Studio Code.
Für serverlose SQL-Pools werden die folgenden Tools teilweise unterstützt (nur Verbinden und Abfragen):
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
Dieses einfache Beispiel verwendet die SQL-Authentifizierung, aber Microsoft Entra-Authentifizierung mit ADO.NET ist sicherer und wird 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, aber Microsoft Entra-Authentifizierung mit ODBC ist sicherer und wird 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, aber Microsoft Entra Authentifizierung mit PHP ist sicherer und wird 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, aber Microsoft Entra Authentifizierung mit JDBC ist sicherer und wird 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
Zum Ausführen serverloser SQL-Poolabfragen wird das empfohlene Tool Azure Synapse Studio verwendet.
Verwandte Inhalte
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 Synapse SQL.