Conectar-se a um pool SQL no Azure Synapse
Conecte-se a um pool SQL no Azure Synapse.
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 no exemplo a seguir é sqlpoolservername.database.windows.net. Descubra o nome de servidor completamente qualificado:
Aceda ao portal do Azure.
Selecione Azure Synapse Analytics.
Selecione o pool SQL ao qual você deseja se conectar.
Localize o nome do servidor completo.
Controladores e cadeias de ligação suportados
O pool SQL funciona com vários drivers. Selecione qualquer um dos seguintes drivers para obter a documentação mais recente e informações de versão: ADO.NET, ODBC, PHP e JDBC.
Você pode gerar automaticamente uma cadeia de conexão para seu driver. Selecione um driver na lista anterior e, em seguida, selecione Mostrar cadeias de conexão de banco de dados.
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.
Aqui estão exemplos de cadeias de conexão para drivers populares:
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}.database.windows.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}.database.windows.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}.database.windows.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}.database.windows.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}.database.windows.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.database.windows.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;
Definições de ligação
O pool SQL padroniza determinadas configurações durante a conexão e a criação de objetos. Essas configurações não podem ser substituídas. Estas incluem:
| Configuração do pool SQL | Value |
|---|---|
| ANSI_NULLS | ON |
| QUOTED_IDENTIFIERS | ON |
| DATEFORMAT | mdy |
| DATEFIRST | 7 |
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 no Azure Synapse Analytics.