Conectar-se ao Synapse SQL
Conecte-se ao recurso Synapse SQL no Azure Synapse Analytics.
Importante
Use a autenticação do Microsoft Entra quando possível. Para obter mais informações, veja Utilizar a autenticação do Microsoft Entra com o Synapse SQL.
Encontrar o nome do servidor
O nome do servidor para o pool SQL dedicado no exemplo a seguir é: <server-name>.sql.azuresynapse.net
.
O nome do servidor para o pool SQL sem servidor no exemplo a seguir é: <server-name>-ondemand.sql.azuresynapse.net
.
Descubra o nome de servidor completamente qualificado:
- Aceda ao portal do Azure.
- Selecione em Espaços de trabalho Sinapse.
- Selecione no espaço de trabalho ao qual você deseja se conectar.
- Vá para a visão geral.
- Localize o nome do servidor completo.
- Para um pool SQL dedicado, use o SQL Endpoint.
- Para o pool SQL sem servidor, use o ponto de extremidade SQL sob demanda.
Ferramentas suportadas
Use o Azure Data Studio ou o SQL Server Management Studio (SSMS).
Para pools SQL sem servidor:
- O Azure Data Studio é totalmente suportado a partir da versão 1.18.0.
- O SQL Server Management Studio é parcialmente suportado a partir da versão 18.5, você pode usá-lo apenas para conectar e consultar.
Controladores e cadeias de ligação suportados
Synapse SQL suporta ADO.NET, ODBC, PHP e JDBC. Para encontrar a versão e a documentação mais recentes, selecione um dos drivers anteriores. Para gerar automaticamente a cadeia de conexão para o driver que você está usando no portal do Azure, selecione Mostrar cadeias de conexão de banco de dados no exemplo anterior. Seguem-se também alguns exemplos do aspeto de uma cadeia de ligação para cada controlador.
Nota
Considere definir o tempo limite da ligação como 300 segundos, para permitir que a ligação sobreviva a curtos períodos de indisponibilidade.
Exemplo de cadeia de ligação de ADO.NET
Este exemplo simples usa autenticação SQL, mas a autenticação do Microsoft Entra com ADO.NET é mais segura e 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;
Exemplo de cadeia de ligação de ODBC
Este exemplo simples usa autenticação SQL, mas a autenticação do Microsoft Entra com ODBC é mais segura e 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;
Exemplo de cadeia de ligação de PHP
Este exemplo simples usa autenticação SQL, mas a autenticação do Microsoft Entra com PHP é mais segura e 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);
Exemplo de cadeia de ligação de JDBC
Este exemplo simples usa autenticação SQL, mas a autenticação do Microsoft Entra com JDBC é mais segura e 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;
Definições de ligação
O Synapse SQL padroniza algumas configurações durante a conexão e a criação de objetos. Essas configurações não podem ser substituídas e incluem:
Definição de base de dados | Value |
---|---|
ANSI_NULLS | ON |
QUOTED_IDENTIFIERS | ON |
DATEFORMAT | mdy |
DATEFIRST | 7 |
Recomendações
Para executar consultas de pool SQL sem servidor, as ferramentas recomendadas são o Azure Data Studio e o Azure Synapse Studio.
Conteúdos relacionados
Para ligar e consultar com o Visual Studio, veja Query with Visual Studio (Consulta com o Visual Studio). Para saber mais sobre as opções de autenticação, consulte Autenticação para Synapse SQL.