Dela via

Ansluta till Synapse SQL

  • Artikel

Anslut till Synapse SQL-funktionen i Azure Synapse Analytics.

Viktigt!

Använd Microsoft Entra-autentisering när det är möjligt. Mer information finns i Använda Microsoft Entra-autentisering för autentisering med Synapse SQL.

Hitta servernamnet

Servernamnet för den dedikerade SQL-poolen i följande exempel är: <server-name>.sql.azuresynapse.net. Servernamnet för den serverlösa SQL-poolen i följande exempel är: <server-name>-ondemand.sql.azuresynapse.net.

För att hitta det fullständigt kvalificerade servernamnet:

  1. Gå till Azure-portalen.
  2. Välj på Synapse-arbetsytor.
  3. Välj på den arbetsyta som du vill ansluta till.
  4. Gå till översikt.
  5. Leta upp det fullständiga servernamnet.
    • Använd SQL-slutpunkt för en dedikerad SQL-pool.
    • För den serverlösa SQL-poolen använder du SQL-slutpunkten på begäran.

Verktyg som stöds

Använd Azure Data Studio eller SQL Server Management Studio (SSMS).

För serverlösa SQL-pooler:

Drivrutiner och anslutningssträngar som stöds

Synapse SQL stöder ADO.NET, ODBC, PHP och JDBC. Om du vill hitta den senaste versionen och dokumentationen väljer du någon av de föregående drivrutinerna. Om du vill generera anslutningssträng automatiskt för drivrutinen som du använder från Azure Portal väljer du Visa databas anslutningssträng i föregående exempel. Nedan visas några exempel på hur en anslutningssträng kan se ut för respektive drivrutin.

Kommentar

Det kan vara bra att ange en tidsgräns på 300 sekunder för anslutningen så att den inte bryts vid korta perioder av inaktivitet.

Exempel på ADO.NET-anslutningssträng

Det här enkla exemplet använder SQL-autentisering, men Microsoft Entra-autentisering med ADO.NET är säkrare och rekommenderas.

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;

Exempel på ODBC-anslutningssträng

Det här enkla exemplet använder SQL-autentisering, men Microsoft Entra-autentisering med ODBC är säkrare och rekommenderas.

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;

Exempel på PHP-anslutningssträng

Det här enkla exemplet använder SQL-autentisering, men Microsoft Entra-autentisering med PHP är säkrare och rekommenderas.

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

Exempel på JDBC-anslutningssträng

Det här enkla exemplet använder SQL-autentisering, men Microsoft Entra-autentisering med JDBC är säkrare och rekommenderas.

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;

Anslutningsinställningar

Synapse SQL standardiserar vissa inställningar när anslutning och objekt skapas. De här inställningarna kan inte åsidosättas och omfattar:

Databasinställning Värde
ANSI_NULLS ON
QUOTED_IDENTIFIERS ON
DATEFORMAT mdy
DATEFIRST 7

Rekommendationer

För att köra serverlösa SQL-poolfrågor är rekommenderade verktyg Azure Data Studio och Azure Synapse Studio.

Relaterat innehåll

Information om hur du ansluter och ställer frågor med Visual Studio finns i Fråga med Visual Studio. Mer information om autentiseringsalternativ finns i Autentisering till Synapse SQL.