แชร์ผ่าน

ไปป์ไลน์การปรับใช้ฐานข้อมูล Eventhouse และ KQL และการรวม git (ตัวอย่าง)

  • บทความ

ฐานข้อมูลเหตุการณ์และ KQL ผสานรวมกับ ความสามารถในการ จัดการวงจรชีวิตใน Microsoft Fabric ซึ่งให้การทํางานร่วมกันที่ได้มาตรฐานระหว่างสมาชิกทีมพัฒนาทั้งหมดตลอดชีวิตของผลิตภัณฑ์ ฟังก์ชันนี้จะถูกส่งผ่าน การรวม git และ ไปป์ไลน์การปรับใช้

ในบทความนี้ คุณจะได้เรียนรู้เกี่ยวกับตัวเลือกการกําหนดค่าที่พร้อมใช้งานผ่านการจัดการวงจรชีวิตของ Microsoft Fabric สําหรับเหตุการณ์และฐานข้อมูล KQL

การรวม Git ฐานข้อมูล Eventhouse และ KQL

ฐานข้อมูล eventhouse และ KQL เป็นรายการที่มีทั้งเมตาดาต้าและข้อมูลที่มีการอ้างอิงในหลายวัตถุในพื้นที่ทํางาน ฐานข้อมูล Eventhouse และ KQL ประกอบด้วยตาราง ฟังก์ชัน และมุมมองที่เป็นภาพ จากมุมมองเวิร์กโฟลว์การพัฒนา วัตถุที่ขึ้นต่อกันต่อไปนี้อาจอ้างอิงฐานข้อมูลเหตุการณ์หรือ KQL:

การรวม git ใช้ที่แพลตฟอร์มและระดับข้อมูลสําหรับเหตุการณ์และฐานข้อมูล KQL

การรวมระดับแพลตฟอร์ม

ข้อมูลฐานข้อมูล eventhouse และ KQL ต่อไปนี้จะถูกซีเรียลไลซ์และติดตามในพื้นที่ทํางานที่เชื่อมต่อ git:

  • อีเวนต์เฮ้าส์

    • ชื่อ
    • รายละเอียด
    • guid แบบลอจิคัล

  • ฐานข้อมูล KQL

    • ชื่อ
    • รายละเอียด
    • นโยบายการแคช
    • นโยบายการเก็บข้อมูล
    • guid แบบลอจิคัล

การรวมระดับข้อมูล

การรวมระดับข้อมูลทําได้ผ่านการใช้สคริปต์ KQL เพื่อสร้างหรือปรับเปลี่ยน schema ของวัตถุฐานข้อมูล คุณสมบัติ และนโยบาย อย่างไรก็ตาม สิ่งสําคัญคือต้องทราบว่าไม่ใช่ทุกคําสั่งที่ได้รับการสนับสนุนในสคริปต์ KQL ที่สามารถเข้ากันได้กับ Microsoft Fabric ALM

  • ฐานข้อมูล KQL

    วัตถุฐานข้อมูลต่อไปนี้ได้รับการสนับสนุนในสคริปต์ KQL:

    • Table
    • Function
    • การอัปเดตนโยบายตาราง
    • นโยบายการเข้ารหัสคอลัมน์
    • มุมมองที่เป็นเอกสาร
    • การแมปการนําเข้าตาราง

    สําหรับข้อมูลเกี่ยวกับคําสั่งที่ได้รับการสนับสนุน ให้ดูคําอธิบายไฟล์ DatabaseSchema.kql ภายใต้ ไฟล์ฐานข้อมูล KQL

การแสดงการรวม Git

รายการเหตุการณ์และฐานข้อมูล KQL แต่ละรายการที่ซิงค์กับ git จะปรากฏในโฟลเดอร์ของตนเองที่ชื่อโดยใช้รูปแบบต่อไปนี้: <ItemName><ItemType> ที่ <ItemName> ซึ่ง คือชื่อของหน่วยข้อมูล และ <ItemType> เป็นชนิดของสินค้า ตัวอย่างเช่น สําหรับเหตุการณ์มีชื่อ ตัวอย่าง ที่มีฐานข้อมูล KQL เดียวที่ ชื่อว่า ExampleDB โฟลเดอร์ต่อไปนี้จะปรากฏในที่เก็บ git:

  • ตัวอย่างอีเวนต์เฮ้าส์
  • ExampleDB.KQLDatabase

ไฟล์อีเวนต์เฮ้าส์

ไฟล์ต่างๆ ต่อไปนี้มีอยู่ในโฟลเดอร์ eventhouse:

  • แท่น

    ไฟล์ใช้ schema ต่อไปนี้เพื่อกําหนด 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:

  • แท่น

    ไฟล์นี้ใช้สคีมาต่อไปนี้เพื่อกําหนดฐานข้อมูล 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

    ไฟล์นี้ใช้ Schema ต่อไปนี้เพื่อกําหนดค่าการตั้งค่าระดับแพลตฟอร์มสําหรับรายการฐานข้อมูล KQL:

    {
  "databaseType": "ReadWrite",
  "parentEventhouseItemId": "",
  "oneLakeCachingPeriod": "P36500D",
  "oneLakeStandardStoragePeriod": "P36500D"
}

    ตารางต่อไปนี้อธิบายเกี่ยวกับคุณสมบัติใน DatabaseProperties.json ไฟล์:

    คุณสมบัติ รายละเอียด
    databaseType ค่าที่ถูกต้อง: ReadWrite
    parentEventhouseItemId ID ตรรกะของ eventhouse หลัก ซึ่งไม่ควรถูกปรับเปลี่ยน
    oneLakeCachingPeriod การตั้งค่าระดับฐานข้อมูลสําหรับ นโยบายการแคช
    oneLakeStandardStoragePeriod การตั้งค่าระดับฐานข้อมูลสําหรับนโยบายการเก็บข้อมูล

  • DatabaseSchema.kql

    ไฟล์เป็น สคริปต์ KQL ที่กําหนดค่าการตั้งค่าระดับข้อมูลสําหรับฐานข้อมูล KQL ซึ่งถูกสร้างขึ้นโดยอัตโนมัติเมื่อฐานข้อมูล KQL ถูกซิงค์กับ git ไฟล์จะถูกดําเนินการเมื่อซิงค์กับพื้นที่ทํางาน Fabric ของคุณ

    คุณสามารถเปลี่ยนแปลงสคริปต์นี้ได้โดยการเพิ่มหรือปรับเปลี่ยนคําสั่งที่ได้รับการสนับสนุนต่อไปนี้:

    วัตถุฐานข้อมูล คําสั่งที่ได้รับการสนับสนุน
    Table สร้างหรือผสาน
    Function สร้างหรือเปลี่ยนแปลง
    การอัปเดตนโยบายตาราง เปลี่ยน
    นโยบายการเข้ารหัสคอลัมน์ เปลี่ยน
    มุมมองที่เป็นเอกสาร สร้างหรือเปลี่ยนแปลง
    การแมปการนําเข้าตาราง สร้างหรือเปลี่ยนแปลง

    ต่อไปนี้คือตัวอย่างของสคริปต์ 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':''}]"

เนื้อหาที่เกี่ยวข้อง