Condividi tramite

Connettersi a Synapse SQL

  • Articolo

Connettersi alla funzionalità Synapse SQL in Azure Synapse Analytics.

Importante

Usare l'autenticazione di Microsoft Entra quando possibile. Per altre informazioni, vedere Usare l'autenticazione di ID Microsoft Entra per l'autenticazione con Synapse SQL.

Trovare il nome del server

Il nome del server per il pool SQL dedicato nell'esempio seguente è: <server-name>.sql.azuresynapse.net. Il nome del server per il pool SQL serverless nell'esempio seguente è: <server-name>-ondemand.sql.azuresynapse.net.

Per trovare il nome completo del server, procedere come segue:

  1. Vai al portale di Azure.
  2. Selezionare Aree di lavoro Synapse.
  3. Selezionare l'area di lavoro a cui connettersi.
  4. Passare a Panoramica.
  5. Individuare il nome completo del server.
    • Per un pool SQL dedicato, usare l'endpoint SQL.
    • Per il pool SQL serverless, usare l'endpoint SQL su richiesta.

Strumenti supportati

Usare Azure Data Studio o SQL Server Management Studio (SSMS).

Per i pool SQL serverless:

  • Azure Data Studio è completamente supportato a partire dalla versione 1.18.0.
  • SQL Server Management Studio è parzialmente supportato a partire dalla versione 18.5 ed è possibile usarlo solo per connettersi ed eseguire query.

Driver supportati e stringhe di connessione

Synapse SQL supporta ADO.NET, ODBC, PHP e JDBC. Per trovare la versione e la documentazione più recenti, selezionare uno dei driver precedenti. Per generare automaticamente la stringa di connessione per il driver in uso dal portale di Azure, selezionare Mostra stringhe di connessione del database nell'esempio precedente. Di seguito sono riportati alcuni esempi di come si presenta la stringa di connessione per ogni driver.

Nota

Per preservare la connessione in caso di brevi periodi di indisponibilità, può essere opportuno impostare il timeout di connessione su 300 secondi.

Esempio di stringa di connessione ADO.NET

Questo semplice esempio usa l'autenticazione SQL, ma l'autenticazione di Microsoft Entra con ADO.NET è più sicura e consigliata.

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;

Esempio di stringa di connessione ODBC

Questo semplice esempio usa l'autenticazione SQL, ma l'autenticazione di Microsoft Entra con ODBC è più sicura e consigliata.

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;

Esempio di stringa di connessione PHP

Questo semplice esempio usa l'autenticazione SQL, ma l'autenticazione di Microsoft Entra con PHP è più sicura e consigliata.

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

Esempio di stringa di connessione JDBC

Questo semplice esempio usa l'autenticazione SQL, ma l'autenticazione di Microsoft Entra con JDBC è più sicura e consigliata.

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;

Impostazioni di connessione

Synapse SQL standardizza alcune impostazioni durante la connessione e la creazione di oggetti. Queste impostazioni, di cui non è possibile eseguire l'override, includono:

Impostazione del database Valore
ANSI_NULLS In...
QUOTED_IDENTIFIERS In...
DATEFORMAT mdy
DATEFIRST 7

Consigli

Per eseguire le query del pool SQL serverless, gli strumenti consigliati sono Azure Data Studio e Azure Synapse Studio.

Contenuto correlato

Per connettersi ed eseguire query con Visual Studio, vedere Eseguire query con Visual Studio. Per altre informazioni sulle opzioni di autenticazione, vedere Autenticazione in Synapse SQL.