Conexión a Synapse SQL
Conéctese a la funcionalidad de Synapse SQL en Azure Synapse Analytics.
Importante
Use la autenticación de Microsoft Entra siempre que sea posible. Para obtener más información, consulte Uso de la autenticación de Microsoft Entra para la autenticación con Synapse SQL.
Búsqueda del nombre de servidor
El nombre del servidor para el grupo de SQL dedicado en el siguiente ejemplo es: <server-name>.sql.azuresynapse.net.
El nombre del servidor para el grupo de SQL sin servidor en el siguiente ejemplo es: <server-name>-ondemand.sql.azuresynapse.net.
Para buscar el nombre del servidor completo:
- Vaya a Azure Portal.
- Seleccione Áreas de trabajo de Synapse.
- Seleccione el área de trabajo a la que desea conectarse.
- Vaya a la información general.
- Busque el nombre del servidor completo:
- Para un grupo de SQL dedicado, use punto de conexión de SQL.
- Para el grupo de SQL sin servidor, use punto de conexión a petición de SQL.
Herramientas admitidas
Use Azure Data Studio o SQL Server Management Studio (SSMS).
Para grupos de SQL sin servidor:
- Azure Data Studio es totalmente compatible a partir de la versión 1.18.0.
- SQL Server Management Studio es parcialmente compatible a partir de la versión 18.5, que solo se puede usar para establecer conexión y realizar consultas.
Cadenas de conexión y controladores admitidos
Synapse SQL admite ADO.NET, ODBC, PHPy JDBC. Para buscar la versión más reciente y su documentación, seleccione uno de los controladores anteriores. Para generar automáticamente la cadena de conexión del controlador que está usando en Azure Portal, seleccione el vínculo Mostrar las cadenas de conexión de la base de datos del ejemplo anterior. Los siguientes son también algunos ejemplos del aspecto de una cadena de conexión para cada controlador.
Nota:
Considere la posibilidad de establecer el tiempo de espera de conexión en 300 segundos para permitir que la conexión se conserve durante breves períodos de falta de disponibilidad.
Ejemplo de cadena de conexión de ADO.NET
En este ejemplo sencillo se usa la autenticación de SQL, pero la autenticación de Microsoft Entra con ADO.NET es más segura y recomendada.
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;
Ejemplo de cadena de conexión de ODBC
En este ejemplo sencillo se usa la autenticación de SQL, pero la autenticación de Microsoft Entra con ODBC es más segura y recomendada.
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;
Ejemplo de cadena de conexión de PHP
En este ejemplo sencillo se usa la autenticación de SQL, pero la autenticación de Microsoft Entra con PHP es más segura y recomendada.
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);
Ejemplo de cadena de conexión de JDBC
En este ejemplo sencillo se usa la autenticación de SQL, pero la autenticación de Microsoft Entra con JDBC es más segura y recomendada.
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;
Configuración de conexión
Synapse SQL normaliza algunos valores de configuración durante la conexión y la creación de objetos. Esta configuración no se puede invalidar e incluye:
| Configuración de base de datos | Value |
|---|---|
| ANSI_NULLS | ACTIVAR |
| QUOTED_IDENTIFIERS | ACTIVAR |
| DATEFORMAT | mdy |
| DATEFIRST | 7 |
Recomendaciones
Para ejecutar consultas del grupo de SQL sin servidor, se recomienda usar estas dos herramientas: Azure Data Studio y Azure Synapse Studio.
Contenido relacionado
Para conectarse y realizar consultas con Visual Studio, consulte Realización de consultas con Visual Studio. Para más información sobre las opciones de autenticación, consulte Autenticación en Synapse SQL.