Conectar-se a um pool de SQL no Azure Synapse

Tip

Microsoft Fabric Data Warehouse é um armazém relacional de escala empresarial com base de data lake, arquitetura pronta para o futuro, IA integrada e novos recursos. Se você não estiver familiarizado com o data warehouse, comece com Fabric Data Warehouse. As cargas de trabalho existentes de pools de SQL dedicados podem ser atualizadas para Fabric para acessar novos recursos em ciência de dados, análise em tempo real e relatórios.

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 SQL do Synapse.

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:

  1. Vá para o Portal do Azure.

  2. Selecione o Azure Synapse Analytics.

  3. Clique no pool de SQL ao qual você deseja se conectar.

  4. Localize o nome completo do servidor.

    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

Esse exemplo simples usa a autenticação do 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 conexão do ODBC

Esse exemplo simples usa a autenticação do 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 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

Esse exemplo simples usa a autenticação do 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;

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. Elas incluem:

Configurações do pool de SQL Valor
ANSI_NULLS ON
QUOTED_IDENTIFIERS ON
DATEFORMAT mdy
DATEFIRST 7

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.