Azure Synapse Analytics의 Synapse SQL 기능에 연결합니다.
중요
가능한 경우 Microsoft Entra 인증을 사용하십시오. 자세한 내용은 Synapse SQL을 통한 인증에 Microsoft Entra 인증 사용을 참조하세요.
서버 이름을 찾으십시오
다음 예시에서 전용 SQL 풀의 서버 이름은 다음과 같습니다: <server-name>.sql.azuresynapse.net.
다음 예제에서 서버리스 SQL 풀의 서버 이름은 <server-name>-ondemand.sql.azuresynapse.net입니다.
정규화된 서버 이름을 찾으려면:
- Azure Portal로 이동합니다.
- Synapse 작업 영역에서 선택하십시오.
- 연결하려는 워크스페이스 위에서 선택하십시오.
- 개요로 이동하십시오.
- 전체 서버 이름을 찾으십시오.
- 전용 SQL 풀의 경우에는 SQL 엔드포인트 를 사용하십시오.
- 서버리스 SQL 풀의 경우에는 SQL 주문형 엔드포인트를 사용하십시오.
지원되는 도구
SSMS(SQL Server Management Studio) 또는 VISUAL Studio Code용 MSSQL 확장을 사용합니다.
서버리스 SQL 풀의 경우 다음 도구가 부분적으로 지원됩니다(연결 및 쿼리만 해당).
지원되는 드라이버 및 연결 문자열
Synapse SQL은 ADO.NET, ODBC, PHP 및 JDBC를 지원합니다. 최신 버전과 설명 문서를 확인하려면 이전의 드라이버 중 하나를 선택하십시오. Azure Portal에서 사용 중인 드라이버에 대한 연결 문자열을 자동으로 생성하려면 앞의 예제에서 데이터베이스 연결 문자열 표시 를 선택합니다. 다음은 각 드라이버 마다 연결 문자열이 어떻게 생겼는지에 대한 몇 가지 예시를 보여줍니다.
참고
짧은 시간 동안의 사용 불가 상태에서 사용자의 연결이 계속 유지될 수 있도록 하려면 연결 제한 시간을 300초로 설정하는 것이 고려해보십시오.
ADO.NET 연결 문자열 예시
해당 간단한 예시에서는 SQL 인증을 사용하지만 ADO.NET을 사용하는 Microsoft Entra 인증이 더 안전하며 사용을 권장합니다.
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;
ODBC 연결 문자열 예시
해당 간단한 예시에서는 SQL 인증을 사용하지만 ODBC.NET을 사용하는 Microsoft Entra 인증이 더 안전하며 사용을 권장합니다.
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;
PHP 연결 문자열 예시
해당 간단한 예시에서는 SQL 인증을 사용하지만 PHP.NET을 사용하는 Microsoft Entra 인증이 더 안전하며 사용을 권장합니다.
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);
JDBC 연결 문자열 예시
해당 간단한 예시에서는 SQL 인증을 사용하지만 JDBC.NET을 사용하는 Microsoft Entra 인증이 더 안전하며 사용을 권장합니다.
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;
연결 설정
Synapse SQL은 연결 및 개체 생성 중에 몇 가지 설정을 표준화합니다. 이러한 다음 설정들은 재정의될 수 없으며 항목은 다음과 같습니다:
| 데이터베이스 세팅 | 값 |
|---|---|
| ANSI_NULLS | 켜기 |
| QUOTED_IDENTIFIERS | 켜기 |
| DATEFORMAT | mdy |
| DATEFIRST | 7 |
권장 사항
서버리스 SQL 풀 쿼리를 실행하기 위해 권장되는 도구인 Azure Synapse Studio입니다.
관련 콘텐츠
Visual Studio를 사용하여 연결하고 쿼리하기 위해서는 Visual Studio를 사용한 쿼리를 참조하십시오. 인증 옵션에 대한 더 자세한 세부사항은 Synapse SQL에 인증을 참조하세요.