Condividi tramite


Connettersi a Synapse SQL

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 SQL Server Management Studio (SSMS) o l'estensione MSSQL per Visual Studio Code.

Per i pool SQL serverless, gli strumenti seguenti sono parzialmente supportati (solo connessione ed esecuzione di 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 l'esecuzione di query del pool SQL serverless, lo strumento consigliato è Azure Synapse Studio.

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.