적용 대상:✅ Microsoft Fabric의 SQL 분석 엔드포인트 및 Warehouse
Microsoft Fabric에서 사용자는 TDS(테이블 형식 데이터 스트림) 엔드포인트를 통해 SQL 분석 엔드포인트 또는 웨어하우스에 액세스합니다. 이 엔드포인트는 SQL Server TDS 엔드포인트와 상호 작용하는 모든 최신 웹 애플리케이션에 익숙합니다. Microsoft Fabric 설정 내에서 이 엔드포인트는 SQL 연결 문자열로 레이블이 지정됩니다.
팁 (조언)
일반적인 도구로 연결하는 자습서는 패브릭 데이터 웨어하우스에 연결을 참조하세요.
Fabric의 창고에 대한 인증
Microsoft Fabric에서 SQL 연결 문자열은 인증된 두 가지 유형의 사용자를 지원합니다.
- Microsoft Entra ID 사용자 보안 주체 또는 사용자 ID
- Microsoft Entra ID 서비스 주체
자세한 내용은 Microsoft Fabric의 SQL 인증의 대안으로서 Microsoft Entra 인증을 참조하세요.
SQL 연결 문자열을 사용하려면 TCP 포트 1433이 열려 있어야 합니다. TCP 1433은 표준 SQL Server 포트 번호입니다. 또한 SQL 연결 문자열은 데이터 액세스를 위한 웨어하우스 또는 레이크하우스 SQL 분석 엔드포인트 보안 모델을 준수합니다. 사용자는 권한이 있는 모든 개체의 데이터에 액세스할 수 있습니다.
SQL 분석 엔드포인트의 보안에 대한 자세한 내용은 SQL 분석 엔드포인트용 OneLake 보안을 참조하세요.
모범 사례
애플리케이션 및 ETL 작업에 재시도를 추가하여 복원력을 높입니다. 자세한 내용은 다음 설명서를 참조하세요.
- 재시도 패턴 - Azure 아키텍처 센터
- 일시적인 오류 관련 작업 - Azure SQL 데이터베이스
- 4단계: ADO.NET을 통해 탄력적으로 SQL에 연결 - ADO.NET Provider for SQL Server
- 4단계: PHP를 통해 탄력적으로 SQL에 연결 - PHP drivers for SQL Server
- 다음 섹션에 설명된 대로 방화벽 정리에 서비스 태그를 사용합니다.
- 패브릭 데이터 웨어하우스에 연결할 때 항상 초기 카탈로그 또는 데이터베이스 속성을 지정합니다. 자세한 내용은 필요한 초기 카탈로그를 참조하세요.
방화벽을 통해 Azure 서비스 태그 허용
방화벽을 통해 연결을 사용하도록 설정하려면 Power BI 서비스 태그 및 SQL 서비스 태그를 허용해야 합니다. 자세한 내용은 Power BI 서비스 태그 및서비스 태그를 참조하세요.
TDS 엔드포인트의 FQDN(정규화된 도메인 이름)은 단독으로 사용할 수 없습니다.
고려 사항 및 제한 사항
- SQL 인증은 지원되지 않습니다.
- MARS(다중 활성 결과 집합)는 Microsoft Fabric Warehouse에서 지원되지 않습니다. MARS는 기본적으로 사용하지 않도록 설정됩니다. 연결 문자열에 포함된 경우
MultipleActiveResultSets연결 문자열을 제거하거나 false로 설정합니다. - "시스템 제한에 도달하여 작업을 완료할 수 없습니다." 오류가 표시되면 시스템 토큰 크기가 제한에 도달했기 때문입니다. 이 오류는 작업 영역에 너무 많은 웨어하우스 또는 SQL 분석 엔드포인트가 있거나, 사용자가 너무 많은 Microsoft Entra 그룹에 속하거나, 이러한 두 가지 요소를 조합한 경우에 발생할 수 있습니다. 이 오류를 방지하려면 작업 영역당 웨어하우스 및 SQL 분석 엔드포인트 수를 40개 이하로 제한합니다. 오류가 지속되면 지원에 문의하세요.
- "오류 코드 24804를 받았을 경우, '시스템 업데이트로 인해 작업을 완료할 수 없습니다.'" 이 연결을 종료하고 다시 로그인한 후 작업을 다시 시도하세요."라는 메시지와 함께 오류 코드 6005가 표시되거나 "SHUTDOWN이 진행 중입니다. SQL Server에 대한 실행이 실패합니다. 추가 지원이 필요한 경우 SQL Server 팀에 문의하세요."라는 메시지와 함께 오류 코드 6005가 표시되는 경우, 시스템 배포 또는 재구성으로 인한 일시적인 연결 손실이 원인일 수 있습니다. 이 문제를 해결하려면 다시 로그인하고 다시 시도해야 합니다. 애플리케이션에서 복원력을 구축하고 다시 시도하는 방법을 알아보려면 모범 사례를 참조하세요.
- SQL Server의 연결된 서버 연결은 지원되지 않습니다.
초기 카탈로그 필요
클라이언트 도구(예: SSMS, Visual Studio Code, Visual Studio, JDBC/ODBC/SqlClient 클라이언트 또는 사용자 지정 애플리케이션)를 사용하여 Fabric Data Warehouse에 연결하는 경우 연결 문자열의 초기 카탈로그 또는 데이터베이스 속성에 유효한 웨어하우스 이름을 제공해야 합니다.
지정된 웨어하우스 이름이 올바르지 않으면 인증에 성공하더라도 연결 시도가 실패합니다. 사용자에게 다음 오류가 표시됩니다. "사용자 '토큰 식별 보안 주체<'>에 대한 로그인이 실패했습니다. 이유: 인증에 성공했지만 데이터베이스를 찾을 수 없거나 데이터베이스에 연결할 수 있는 권한이 부족합니다."
유효한 웨어하우스 이름에는 <unique identifier>.datawarehouse.fabric.microsoft.com이(가) 서버 이름에 필요하지 않습니다. 웨어하우스 이름이 NYC Taxi이면 초기 카탈로그는 NYC Taxi입니다.
다음 스크린샷은 잘못된 웨어하우스 이름이 초기 카탈로그로 제공될 때 SSMS에 표시되는 오류를 보여 줍니다.
