Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
Connectez-vous à la capacité Synapse SQL dans Azure Synapse Analytics.
Important
Utilisez l’authentification Microsoft Entra chaque fois que 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
Dans l’exemple suivant, le nom du serveur du pool SQL dédié 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 :
- Accédez au portail Azure.
- Sélectionnez Espaces de travail Synapse.
- Sélectionnez l’espace de travail auquel vous souhaitez vous connecter.
- Accédez à la vue d’ensemble.
- Recherchez le nom complet du serveur.
- Pour un pool SQL dédié, utilisez le point de terminaison SQL.
- Pour un pool SQL sans serveur, utilisez le point de terminaison SQL à la demande.
Outils pris en charge
Utilisez SQL Server Management Studio (SSMS) ou l’extension MSSQL pour Visual Studio Code.
Pour les pools SQL serverless, les outils suivants sont partiellement pris en charge (se connecter et interroger uniquement) :
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.
Remarque
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 repose sur l’authentification SQL, toutefois l’authentification Microsoft Entra avec ADO.NET offre un niveau de sécurité supérieur 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 repose sur l’authentification SQL, toutefois l’authentification Microsoft Entra avec ODBC offre un niveau de sécurité supérieur 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 repose sur l’authentification SQL, toutefois l’authentification Microsoft Entra avec PHP offre un niveau de sécurité supérieur 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 repose sur l’authentification SQL, toutefois l’authentification Microsoft Entra avec JDBC offre un niveau de sécurité supérieur 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, l’outil recommandé est 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.