Conexión a Synapse SQL

Conéctese a la funcionalidad de Synapse SQL en Azure Synapse Analytics.

Herramientas admitidas en el grupo de SQL sin servidor

Azure Data Studio es totalmente compatible a partir de la versión 1.18.0. SSMS es parcialmente compatible a partir de la versión 18.5, que solo se puede usar para establecer conexión y realizar consultas.

Búsqueda del nombre de servidor

El nombre de servidor del grupo de SQL dedicado en el siguiente ejemplo es showdemoweu.sql.azuresynapse.net. El nombre de servidor del grupo de SQL sin servidor en el siguiente ejemplo es showdemoweu.sql.azuresynapse.net.

Para buscar el nombre del servidor completo:

  1. Vaya a Azure Portal.
  2. Seleccione Áreas de trabajo de Synapse.
  3. Seleccione el área de trabajo a la que desea conectarse.
  4. Vaya a la información general.
  5. Busque el nombre del servidor completo:

Grupo de SQL

Full server name

Grupo de SQL sin servidor

Full server name serverless SQL pool

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

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

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

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

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.

Pasos siguientes

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.