Eventhouse 및 KQL 데이터베이스 배포 파이프라인 및 git 통합(미리 보기)
Eventhouses 및 KQL 데이터베이스는 Microsoft Fabric의 수명 주기 관리 기능 과 통합되어 제품 수명 동안 모든 개발 팀 구성원 간에 표준화된 협업을 제공합니다. 이 기능은 git 통합 및 배포 파이프라인을 통해 제공됩니다.
이 문서에서는 Eventhouse 및 KQL 데이터베이스에 대한 Microsoft Fabric의 수명 주기 관리를 통해 사용할 수 있는 구성 옵션에 대해 알아봅니다.
Eventhouse 및 KQL 데이터베이스 git 통합
eventhouse 및 KQL 데이터베이스는 작업 영역의 여러 개체에서 참조되는 메타데이터와 데이터를 모두 포함하는 항목입니다. Eventhouse 및 KQL 데이터베이스에는 테이블, 함수 및 구체화된 뷰가 포함되어 있습니다. 개발 워크플로 관점에서 다음 종속 개체는 eventhouse 또는 KQL 데이터베이스를 참조할 수 있습니다.
- Spark 작업 정의
- Notebooks
- 의미 체계 모델 및 Power BI
git 통합은 Eventhouse 및 KQL 데이터베이스에 대한 플랫폼 및 데이터 수준에서 적용됩니다.
플랫폼 수준 통합
다음 eventhouse 및 KQL 데이터베이스 정보는 git 연결 작업 영역에서 직렬화되고 추적됩니다.
Eventhouse
- 속성
- 설명
- 논리적 GUID
KQL 데이터베이스
- 속성
- 설명
- 캐싱 정책
- 보존 정책
- 논리적 GUID
데이터 수준 통합
데이터 수준 통합은 KQL 스크립트를 사용하여 데이터베이스 개체 스키마, 속성 및 정책을 만들거나 수정하는 방법을 통해 이루어집니다. 그러나 KQL 스크립트에서 지원되는 모든 명령이 Microsoft Fabric ALM과 호환되는 것은 아닙니다.
KQL 데이터베이스
KQL 스크립트에서 지원되는 데이터베이스 개체는 다음과 같습니다.
- 테이블
- 함수
- 테이블 정책 업데이트
- 열 인코딩 정책
- 구체화된 뷰
- 테이블 수집 매핑
지원되는 명령에 대한 자세한 내용은 KQL 데이터베이스 파일 아래의 DatabaseSchema.kql 파일 설명을 참조하세요.
Git 통합 표현
git와 동기화된 각 Eventhouse 및 KQL 데이터베이스 항목은 다음 형식 <ItemName>을 사용하여 명명된 자체 폴더에 표시됩니다.<ItemType>항목의 이름이며 항목 <ItemType> 의 형식은 <ItemName>/>입니다. 예를 들어 ExampleDB라는 단일 KQL 데이터베이스가 있는 Example라는 Eventhouse의 경우 git 리포지토리에 다음 폴더가 표시됩니다.
- 예제입니다.Eventhouse
- ExampleDB.KQLDatabase
Eventhouse 파일
다음 파일은 eventhouse 폴더에 포함됩니다.
.platform
이 파일은 다음 스키마를 사용하여 eventhouse를 정의합니다.
{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json", "metadata": { "type": "Eventhouse", "displayName": "", "description": "" }, "config": { "version": "2.0", "logicalId": "" } }EventhouseProperties.json
이 파일을 사용하면 eventhouse 항목에 대한 플랫폼 수준 설정을 구성할 수 있습니다.
KQL 데이터베이스 파일
다음 파일은 KQL 데이터베이스 폴더에 포함되어 있습니다.
.platform
이 파일은 다음 스키마를 사용하여 KQL 데이터베이스를 정의합니다.
{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json", "metadata": { "type": "KQLDatabase", "displayName": "", "description": "" }, "config": { "version": "2.0", "logicalId": "" } }DatabaseProperties.json
이 파일은 다음 스키마를 사용하여 KQL 데이터베이스 항목에 대한 플랫폼 수준 설정을 구성합니다.
{ "databaseType": "ReadWrite", "parentEventhouseItemId": "", "oneLakeCachingPeriod": "P36500D", "oneLakeStandardStoragePeriod": "P36500D" }다음 표에서는 파일의 속성을
DatabaseProperties.json설명합니다.속성 설명 databaseType 유효한 값: ReadWrite parentEventhouseItemId 부모 이벤트 하우스의 논리적 ID입니다. 수정하면 안 됩니다. oneLakeCachingPeriod 캐싱 정책에 대한 데이터베이스 수준 설정입니다. oneLakeStandardStoragePeriod 보존 정책에 대한 데이터베이스 수준 설정입니다. DatabaseSchema.kql
파일은 KQL 데이터베이스에 대한 데이터 수준 설정을 구성하는 KQL 스크립트 입니다. KQL 데이터베이스가 git에 동기화되면 자동으로 생성됩니다. 파일은 패브릭 작업 영역과 동기화할 때 실행됩니다.
지원되는 다음 명령을 추가하거나 수정하여 이 스크립트를 변경할 수 있습니다.
데이터베이스 개체 지원되는 명령 테이블 만들기 또는 병합 함수 만들기 또는 변경 테이블 정책 업데이트 변경 열 인코딩 정책 변경 구체화된 뷰 만들기 또는 변경 테이블 수집 매핑 만들기 또는 변경 다음은 테이블 및 해당 수집 매핑을 만드는 kql 스크립트의 예입니다.
// KQL script // Use management commands in this script to configure your database items, such as tables, functions, materialized views, and more. .create-merge table SampleTable (UsageDate:datetime, PublisherType:string, ChargeType:string, ServiceName:string, ServiceTier:string, Meter:string, PartNumber:string, CostUSD:real, Cost:real, Currency:string) .create-or-alter table SampleTable ingestion csv mapping 'SampleTable_mapping' "[{'Properties':{'Ordinal':'0'},'column':'UsageDate','datatype':''},{'Properties':{'Ordinal':'1'},'column':'PublisherType','datatype':''}]"