Připojení k Synapse SQL
Připojte se k funkci Synapse SQL ve službě Azure Synapse Analytics.
Důležité
Pokud je to možné, použijte ověřování Microsoft Entra. Další informace najdete v tématu Ověřování v Synapse SQL s využitím ověřování Microsoft Entra.
Vyhledání názvu serveru
Název serveru pro vyhrazený fond SQL v následujícím příkladu je: <server-name>.sql.azuresynapse.net
.
Název serveru pro bezserverový fond SQL v následujícím příkladu je: <server-name>-ondemand.sql.azuresynapse.net
.
Plně kvalifikovaný název serveru zjistíte následujícím způsobem:
- Přejděte na Azure Portal.
- Vyberte pracovní prostory Synapse.
- Vyberte pracovní prostor, ke kterému se chcete připojit.
- Přejděte na přehled.
- Vyhledejte úplný název serveru.
- Pro vyhrazený fond SQL použijte koncový bod SQL.
- Pro bezserverový fond SQL použijte koncový bod SQL na vyžádání.
Podporované nástroje
Použijte Azure Data Studio nebo SQL Server Management Studio (SSMS).
Pro bezserverové fondy SQL:
- Azure Data Studio se plně podporuje od verze 1.18.0.
- SQL Server Management Studio je částečně podporován od verze 18.5, můžete ho použít pouze pro připojení a dotazování.
Podporované ovladače a připojovací řetězce
Synapse SQL podporuje ADO.NET, ODBC, PHP a JDBC. Pokud chcete najít nejnovější verzi a dokumentaci, vyberte jeden z předchozích ovladačů. Pokud chcete automaticky vygenerovat připojovací řetězec pro ovladač, který používáte na webu Azure Portal, vyberte Zobrazit připojovací řetězec databáze z předchozího příkladu. Následuje několik příkladů toho, jak připojovací řetězce vypadají pro jednotlivé ovladače.
Poznámka:
Zvažte nastavení časového limitu připojení na 300 sekund, pokud chcete, aby vaše připojení přestálo krátká období nedostupnosti.
Příklad připojovacího řetězce pro ADO.NET
Tento jednoduchý příklad používá ověřování SQL, ale ověřování Microsoft Entra s ADO.NET je bezpečnější a doporučeno.
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;
Příklad připojovacího řetězce pro ODBC
Tento jednoduchý příklad používá ověřování SQL, ale ověřování Microsoft Entra s rozhraním ODBC je bezpečnější a doporučeno.
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;
Příklad připojovacího řetězce pro PHP
Tento jednoduchý příklad používá ověřování SQL, ale ověřování Microsoft Entra s PHP je bezpečnější a doporučeno.
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);
Příklad připojovacího řetězce pro JDBC
Tento jednoduchý příklad používá ověřování SQL, ale ověřování Microsoft Entra s JDBC je bezpečnější a doporučeno.
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;
Nastavení připojení
Synapse SQL standardizuje některá nastavení při vytváření připojení a objektu. Tato nastavení se nedají přepsat a zahrnují:
Nastavení databáze | Hodnota |
---|---|
ANSI_NULLS | ON |
QUOTED_IDENTIFIERS | ON |
DATEFORMAT | mdy |
DATEFIRST | 7 |
Doporučení
Pro spouštění dotazů bezserverového fondu SQL jsou doporučené nástroje Azure Data Studio a Azure Synapse Studio.
Související obsah
Informace o připojení a dotazování pomocí sady Visual Studio najdete v oddílu Dotazování pomocí sady Visual Studio. Další informace omožnostch