Cadeias de conexão do SQL do Synapse

Você pode se conectar ao SQL do Synapse com várias bibliotecas de aplicativo diferentes, como ADO.NET, ODBC, PHP e JDBC. Veja abaixo alguns exemplos de cadeias de conexão para cada biblioteca.

Importante

Use a autenticação Microsoft Entra quando possível. Para obter mais informações, consulte Usar a autenticação do Microsoft Entra para autenticação com o SQL do Synapse.

Você também pode usar o Portal do Azure para compilar sua cadeia de conexão. Para compilar a cadeia de conexão usando o portal do Azure, navegue até a folha do banco de dados, em Essentials, selecione Mostrar cadeias de conexão de banco de dados.

Exemplo de cadeia de conexão 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}.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 conexão ODBC

Esse exemplo simples usa a autenticação do SQL, mas a autenticação do Microsoft Entra com ODBC é mais segura e recomendada.

Driver={ODBC Driver 18 for SQL Server};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 conexão PHP

Esse exemplo simples usa a autenticação do 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 conexão 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.sql.azuresynapse.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.net;loginTimeout=30;

Observação

Considere a possibilidade de definir o tempo limite de conexão como 300 segundos para permitir que a conexão sobreviva a curtos períodos de indisponibilidade e forneça tempo suficiente para que as instâncias em pausa sejam retomadas.

Recomendações

Para executar consultas de pool de SQL sem servidor , a ferramenta recomendada é o Azure Synapse Studio.

Conteúdo relacionado

Para começar a consultar a análise com o Visual Studio e outros aplicativos, confira Consulta com o Visual Studio.