Conectar-se a um pool de SQL no Azure Synapse
Conectar-se a um pool de SQL no Azure Synapse.
Importante
Use a autenticação do Microsoft Entra sempre que possível. Para obter mais informações, consulte Usar a autenticação do Microsoft Entra para autenticação com o Synapse SQL.
Localizar o nome do servidor
O nome do servidor no exemplo a seguir é sqlpoolservername.database.windows.net. Para localizar o nome de servidor totalmente qualificado:
Vá para o Portal do Azure.
Selecione o Azure Synapse Analytics.
Clique no pool de SQL ao qual você deseja se conectar.
Localize o nome completo do servidor.
Drivers suportados e cadeias de conexão
O pool de SQL funciona com vários drivers. Selecione qualquer um dos seguintes drivers para obter as informações de documentação e de versão mais recentes: ADO.NET, ODBC, PHP e JDBC.
É possível gerar automaticamente uma cadeia de conexão para o driver. Selecione um driver na lista anterior e selecione Mostrar cadeias de conexão de banco de dados.
Observação
Considere definir o tempo limite de conexão para 300 segundos a fim de permitir que a conexão perdure em curtos períodos de indisponibilidade.
Veja os seguintes exemplos de cadeias de conexão para drivers populares:
Exemplo de cadeia de conexão do ADO.NET
Este exemplo simples usa a autenticação do SQL. No entanto, a autenticação do Microsoft Entra com o 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 conexão do ODBC
Este exemplo simples usa a autenticação do SQL. No entanto, a autenticação do Microsoft Entra com o 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 conexão do PHP
Este exemplo simples usa a autenticação do SQL. No entanto, a autenticação do Microsoft Entra com o 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 conexão do JDBC
Este exemplo simples usa a autenticação do SQL. No entanto, a autenticação do Microsoft Entra com o 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;
Configurações de conexão
O pool de SQL padroniza algumas configurações durante a conexão e a criação do objeto. Essas configurações não podem ser substituídas. Eles incluem:
| Configurações do pool de SQL | Valor |
|---|---|
| ANSI_NULLS | ATIVADO |
| QUOTED_IDENTIFIERS | ATIVADO |
| DATEFORMAT | mda |
| DATEFIRST | 7 |
Conteúdo relacionado
Para se conectar e consultar com o Visual Studio, veja Consultar com o Visual Studio. Para saber mais sobre as opções de autenticação, confira Autenticação no Azure Synapse Analytics.