Partage via

Se connecter à Synapse SQL

  • Article

Connectez-vous à la capacité Synapse SQL dans Azure Synapse Analytics.

Important

Utilisez l’authentification Microsoft Entra lorsque cela est possible. Pour plus d’informations, consultez Utiliser l’authentification Microsoft Entra pour l’authentification auprès de Synapse SQL.

Recherche du nom de serveur

Le nom du serveur du pool SQL dédié dans l’exemple suivant est : <server-name>.sql.azuresynapse.net. Le nom du serveur du pool de serveurs SQL serverless l’exemple suivant est le suivant : <server-name>-ondemand.sql.azuresynapse.net.

Pour rechercher le nom complet du serveur :

  1. Accédez au portail Azure.
  2. Sélectionnez Espaces de travail Synapse.
  3. Sélectionnez l’espace de travail auquel vous souhaitez vous connecter.
  4. Accédez à la vue d’ensemble.
  5. Recherchez le nom complet du serveur.
    • Pour un pool SQL dédié, utilisez un point de terminaison SQL.
    • Pour le pool SQL serverless, utilisez un point de terminaison SQL à la demande.

Outils pris en charge

Utilisez Azure Data Studio ou SQL Server Management Studio (SSMS).

Pour des pools SQL serverless :

  • Azure Data Studio est entièrement pris en charge à compter de la version 1.18.0.
  • SQL Server Management Studio est partiellement pris en charge à partir de la version 18.5 ; vous pouvez l’utiliser uniquement pour vous connecter et exécuter des requêtes.

Chaînes de connexion et pilotes pris en charge

Synapse SQL prend en charge ADO.NET, ODBC, PHP et JDBC. Pour rechercher la dernière version et accéder à la documentation connexe, sélectionnez l’un des pilotes ci-dessus. Pour générer automatiquement la chaîne de connexion pour le pilote que vous utilisez à partir du portail Azure,sélectionnez l’option Afficher les chaînes de connexion de la base de données dans l’exemple précédent. Voici également quelques exemples montrant à quoi ressemble une chaîne de connexion pour chaque pilote.

Notes

Vous pouvez définir le délai de connexion à 300 secondes pour permettre à votre connexion de résister à des courtes périodes d’indisponibilité.

Exemple de chaîne de connexion ADO.NET

Cet exemple simple utilise l’authentification SQL, mais l’authentification Microsoft Entra avec ADO.NET est plus sécurisée et est recommandée.

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;

Exemple de chaîne de connexion ODBC

Cet exemple simple utilise l’authentification SQL, mais l’authentification Microsoft Entra avec ODBC est plus sécurisée et est recommandée.

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;

Exemple de chaîne de connexion PHP

Cet exemple simple utilise l’authentification SQL, mais l’authentification Microsoft Entra avec PHP est plus sécurisée et est recommandée.

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

Exemple de chaîne de connexion JDBC

Cet exemple simple utilise l’authentification SQL, mais l’authentification Microsoft Entra avec JDBC est plus sécurisée et est recommandée.

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;

Paramètres de connexion

Synapse SQL standardise certains paramètres pendant la connexion et la création d’objets. Ces paramètres, qui ne peuvent pas être remplacés, comprennent notamment :

Paramètre de base de données Valeur
ANSI_NULLS ACTIVÉ
QUOTED_IDENTIFIERS ACTIVÉ
DATEFORMAT mja
DATEFIRST 7

Recommandations

Pour exécuter des requêtes de pool SQL serverless, les outils recommandés sont Azure Data Studio et Azure Synapse Studio.

Contenu connexe

Pour vous connecter et interroger avec Visual Studio, consultez la page Interroger Azure SQL Data Warehouse (sqlcmd) (Visual Studio). Pour en savoir plus sur les options d’authentification, consultez Authentification sur Synapse SQL.