Microsoft Fabric의 데이터 웨어하우징에 대한 연결
적용 대상:✅ Microsoft Fabric의 SQL 분석 엔드포인트 및 Warehouse
Microsoft Fabric에서, 레이크하우스 SQL 분석 엔드포인트 또는 웨어하우스는 SQL Server TDS(Tabular Data Stream) 엔드포인트와 상호 작용하는 모든 최신 웹 애플리케이션에 익숙한 TDS 엔드포인트를 통해 액세스할 수 있습니다. 이를 Microsoft Fabric 사용자 인터페이스 내의 SQL 연결 문자열이라고 합니다.
이 문서에서는 SQL 분석 엔드포인트 또는 웨어하우스에 연결하는 방법을 설명합니다.
시작하려면 먼저 다음 필수 조건을 완료해야 합니다.
- 기여자 이상의 권한이 있는 프리미엄 용량 작업 영역 내에서 SQL 분석 엔드포인트 또는 웨어하우스에 액세스해야 합니다.
Fabric의 웨어하우스에 대한 인증
Microsoft Fabric에서는 두 가지 유형의 인증된 사용자가 SQL 연결 문자열을 통해 지원됩니다.
- Microsoft Entra ID(이전 Azure Active Directory) 사용자 주체 또는 사용자 ID
- Microsoft Entra ID(이전 Azure Active Directory) 서비스 주체
자세한 내용은 Microsoft Fabric의 SQL 인증의 대안으로서 Microsoft Entra 인증을 참조하세요.
SQL 연결 문자열을 사용하려면 TCP 포트 1433이 열려 있어야 합니다. TCP 1433은 표준 SQL Server 포트 번호입니다. 또한 SQL 연결 문자열은 데이터 액세스를 위한 웨어하우스 또는 레이크하우스 SQL 분석 엔드포인트 보안 모델을 준수합니다. 사용자가 액세스할 수 있는 모든 개체에 대한 데이터를 가져올 수 있습니다.
방화벽을 통한 Power BI 서비스 태그 허용
적절한 액세스를 보장하려면 방화벽 액세스에 대한 Power BI 서비스 태그를 허용해야 합니다. 자세한 내용은 Power BI 서비스 태그를 참조하세요. TDS 엔드포인트의 FQDN(정규화된 도메인 이름)은 단독으로 사용할 수 없습니다. 방화벽을 통해 연결하려면 Power BI 서비스 태그를 허용해야 합니다.
SQL 연결 문자열 검색
연결 문자열을 검색하려면 다음 단계를 수행합니다.
- 작업 영역으로 이동하여 웨어하우스를 선택합니다.
- SQL 연결 문자열 상자에서 복사 단추를 선택하여 연결 문자열 클립보드에 복사합니다.
또는 OneLake 데이터 허브에서 다음을 수행합니다.
- 웨어하우스를 선택하고 추가 옵션에
...대한 줄임표를 선택합니다. - SQL 연결 문자열 복사를 선택하여 연결 문자열을 클립보드에 복사합니다.
SSMS(SQL Server Management Studio) 시작
다음 단계에서는 Microsoft Fabric 작업 영역에서 시작하여 웨어하우스를 SSMS(SQL Server Management Studio)에 연결하는 방법을 자세히 설명합니다.
SSMS를 열면 서버에 연결 창이 나타납니다. 이미 열려 있는 경우 개체 탐색기>연결>데이터베이스 엔진을 선택하여 수동으로 연결할 수 있습니다.
서버에 연결 창이 열리면 이 문서의 이전 섹션에서 복사한 연결 문자열을 서버 이름 상자에 붙여넣습니다. 연결을 선택하고 인증에 적절한 자격 증명을 계속 진행합니다. Microsoft Entra MFA(Microsoft Entra 다단계 인증) 옵션을 통한 Microsoft Entra MFA만 지원됩니다.
연결이 설정되면 개체 탐색기는 작업 영역에서 연결된 웨어하우스와 해당 테이블 및 보기를 표시하며, 이러한 모든 항목은 쿼리할 준비가 되었습니다.
SSMS(또는 ADS)를 통해 연결하면 SQL 분석 엔드포인트와 웨어하우스가 모두 웨어하우스로 나열되며, 두 항목 유형과 해당 기능을 구분하기가 어렵습니다. 이러한 이유로 Microsoft Fabric 포털 환경 외부의 도구에서 작업하는 경우 두 항목 유형을 쉽게 구분할 수 있는 명명 규칙을 채택하는 것을 적극 권장합니다. SSMS 19 이상만 지원됩니다.
Power BI를 사용하여 연결
웨어하우스 또는 레이크하우스 SQL 분석 엔드포인트는 Power BI 내에서 완벽하게 지원되는 네이티브 데이터 원본이며, SQL 연결 문자열을 사용할 필요가 없습니다. 데이터 창에는 직접 액세스할 수 있는 모든 웨어하우스가 노출됩니다. 이를 통해 작업 영역별로 웨어하우스를 쉽게 찾을 수 있습니다.
- 웨어하우스를 선택합니다.
- 엔터티를 선택합니다.
- 데이터 로드 - 데이터 연결 모드(가져오기 또는 DirectQuery)를 선택합니다.
자세한 내용은 Microsoft Fabric에서 보고서 만들기를 참조 하세요.
OLE DB를 사용하여 연결
OLE DB를 사용하여 웨어하우스 또는 SQL 분석 엔드포인트에 대한 연결을 지원합니다. 최신 Microsoft OLE DB Driver for SQL Server를 실행하고 있는지 확인하세요.
ODBC를 사용하여 연결
Microsoft Fabric은 ODBC를 사용하여 웨어하우스 또는 SQL 분석 엔드포인트에 대한 연결을 지원합니다. 최신 ODBC Driver for SQL Server를 실행하고 있는지 확인하세요. Microsoft Entra ID(이전의 Azure Active Directory) 인증을 사용합니다. ODBC 18 이상 버전만 지원됩니다.
JDBC를 사용하여 연결
Microsoft Fabric은 JDBC(Java 데이터베이스 연결) 드라이버를 사용하여 웨어하우스 또는 SQL 분석 엔드포인트에 대한 연결도 지원합니다.
JDBC를 통해 연결을 설정할 때 다음 종속성을 확인합니다.
아티팩트를 추가합니다. 아티팩트 추가를 선택하고 다음 네 가지 종속성을 추가한 다음, 다운로드/업데이트를 선택하여 모든 종속성을 로드합니다. 예시:
연결 테스트, 마침을 선택합니다.
<dependency> <groupId>com.microsoft.azure</groupId> <artifactId>msal4j</artifactId> <version>1.13.3</version> </dependency> <dependency> <groupId>com.microsoft.sqlserver</groupId> <artifactId>mssql-jdbc_auth</artifactId> <version>11.2.1.x86</version> </dependency> <dependency> <groupId>com.microsoft.sqlserver</groupId> <artifactId>mssql-jdbc</artifactId> <version>12.1.0.jre11-preview</version> </dependency> <dependency> <groupId>com.microsoft.aad</groupId> <artifactId>adal</artifactId> <version>4.2.2</version> </dependency>
dbt를 사용하여 연결
dbt 어댑터는 SQL을 사용하여 테스트 및 버전 제어와 같은 소프트웨어 엔지니어링 모범 사례를 사용하여 코드를 줄이고, 종속성 관리를 자동화하고, 보다 안정적인 데이터를 제공하는 데이터 변환 프레임워크입니다.
dbt 데이터 플랫폼별 어댑터 플러그 인을 사용하면 사용자가 선택한 데이터 저장소에 연결할 수 있습니다. 사용 dbt-fabric 어댑터에서 Microsoft Fabric의 Synapse Data Warehouse에 dbt 연결하려면 마찬가지로 Azure Synapse Analytics 전용 SQL 풀 데이터 원본에는 자체 어댑터인 dbt-synapse가 있습니다.
두 어댑터 모두 Microsoft Entra ID(이전의 Azure Active Directory) 인증을 지원하며 개발자가 az cli authentication을 사용할 수 있도록 허용합니다. 그러나 dbt-fabric에 대해서는 SQL 인증 지원되지 않습니다.
DBT Fabric DW 어댑터는 pyodbc 라이브러리를 사용하여 웨어하우스와의 연결을 설정합니다. pyodbc 라이브러리는 Python 데이터베이스 API 사양 v2.0을 사용하는 Python 언어로 된 ODBC 구현입니다. pyodbc 라이브러리는 TDS(Tabular Data Streaming) 프록시 서비스를 사용하여 Microsoft Fabric에 대한 msodbc 연결 구조의 SQLDriverConnect를 통해 연결 문자열을 데이터베이스 드라이버에 직접 전달합니다.
자세한 내용은 Microsoft Fabric Synapse Data Warehouse dbt 어댑터 설정 및 Microsoft Fabric Synapse Data Warehouse dbt 어댑터 구성을 참조하세요.
다른 수단을 통해 연결
Microsoft가 아닌 도구는 ODBC 또는 OLE DB 드라이버를 통해 SQL 연결 문자열 사용하여 Microsoft Entra ID(이전의 Azure Active Directory) 인증을 사용하여 Microsoft Fabric Warehouse 또는 SQL 분석 엔드포인트에 연결할 수도 있습니다. 자세한 내용 및 샘플 연결 문자열은 SQL 인증의 대안으로서 Microsoft Entra 인증을 참조하세요.
사용자 지정 애플리케이션
Microsoft Fabric에서 웨어하우스 및 레이크하우스 SQL 분석 엔드포인트는 SQL 연결 문자열 제공합니다. Microsoft Entra ID(이전의 Azure Active Directory)를 사용하여 인증할 수 있는 경우 방대한 SQL 도구 에코시스템에서 데이터에 액세스할 수 있습니다. 자세한 내용은 Microsoft SQL Database용 연결 라이브러리를 참조하세요. 자세한 내용 및 샘플 연결 문자열은 SQL 인증의 대안으로서 Microsoft Entra 인증을 참조하세요.
모범 사례
복원력을 구축하기 위해 애플리케이션/ETL 작업에 재시도 기능을 추가하는 것이 좋습니다. 자세한 내용은 다음 문서를 참조하세요.
- 재시도 패턴 - Azure 아키텍처 센터
- 일시적인 오류 관련 작업 - Azure SQL 데이터베이스
- 4단계: ADO.NET을 통해 탄력적으로 SQL에 연결 - ADO.NET Provider for SQL Server
- 4단계: PHP를 통해 탄력적으로 SQL에 연결 - PHP drivers for SQL Server
고려 사항 및 제한 사항
- SQL 인증은 지원되지 않습니다.
- Microsoft Fabric 웨어하우스에서는 MARS(Multiple Active Result Set)가 지원되지 않습니다. MARS는 기본적으로 사용하지 않도록 설정되어 있지만 연결 문자열에
MultipleActiveResultSets가 포함된 경우 제거하거나 false로 설정해야 합니다. - "시스템 제한에 도달하여 작업을 완료할 수 없습니다." 오류가 표시되면 시스템 토큰 크기가 제한에 도달했기 때문입니다. 이 문제는 작업 영역에 너무 많은 웨어하우스/SQL 분석 엔드포인트가 있거나, 사용자가 너무 많은 Microsoft Entra 그룹의 일부이거나, 둘의 조합인 경우 발생할 수 있습니다. 이 오류를 방지하려면 작업 영역당 웨어하우스 및 SQL 분석 엔드포인트를 40개 이하로 유지하는 것이 좋습니다. 문제가 지속되면 고객 지원 팀에 문의하세요.
- "시스템 업데이트로 인해 작업을 완료할 수 없습니다. 이 연결을 종료하고 다시 로그인한 후 작업을 다시 시도하세요."라는 메시지와 함께 오류 코드 6005가 표시되거나 "SHUTDOWN이 진행 중입니다. SQL Server에 대한 실행이 실패합니다. 추가 지원이 필요한 경우 SQL Server 팀에 문의하세요."라는 메시지와 함께 오류 코드 6005가 표시되는 경우, 시스템 배포 또는 재구성으로 인한 일시적인 연결 손실이 원인일 수 있습니다. 이 문제를 해결하려면 다시 로그인하고 다시 시도해야 합니다. 애플리케이션에서 복원력을 구축하고 다시 시도하는 방법을 알아보려면 모범 사례를 참조하세요.
- 오류 코드 18456: "SQL Server에 대한 실행이 실패했습니다. 추가 지원이 필요한 경우 SQL Server 팀에 문의하세요."가 표시되는 경우 알려진 문제 - Data Warehouse 연결 또는 쿼리 실행 실패를 참조하세요.
- SQL Server의 연결된 서버 연결은 지원되지 않습니다.