แชร์ผ่าน

เริ่มต้นใช้งานด่วน - เรียกใช้ตัวอย่างปริมาณงาน

  • บทความ

คู่มือเริ่มต้นใช้งานด่วนนี้แสดงวิธีการสร้างและเรียกใช้ปริมาณงาน Microsoft Fabric โดยใช้ปริมาณงานตัวอย่าง

ตัวอย่างนี้แสดงให้เห็นถึงการจัดเก็บและอ่านข้อมูลจากและไปยังเลคเฮ้าส์ ในการทําเช่นนั้น คุณต้องสร้างโทเค็นสําหรับบริการที่เก็บข้อมูล Azure ในโฟลว์ on-Behalf-Of (OBO)

ข้อกำหนดเบื้องต้น

  • สภาพแวดล้อม ตั้งค่า สําหรับการพัฒนาปริมาณงาน

  • ถ้าไม่ได้ติดตั้ง ที่เก็บข้อมูล Azure ในผู้เช่าของคุณ คุณต้องเป็น ผู้ดูแลระบบส่วนกลางของ ในผู้เช่า

  • ASP.NET Core Runtime 6.0 - ASP.NET Core ถูกใช้เพื่อสร้างปริมาณงานตัวอย่าง

  • รันไทม์ .NET 6.0 - .NET ถูกใช้เพื่อสร้างปริมาณงานตัวอย่าง

ขั้นตอนที่ 1: ตั้งค่าที่เก็บข้อมูล Azure

คุณต้องได้รับความยินยอมในการใช้ Azure Storage ในขั้นตอนนี้ คุณตรวจสอบว่า มีการติดตั้ง Azure Storage ในผู้เช่า และถ้าคุณไม่ได้ติดตั้ง

  1. เข้าสู่ระบบพอร์ทัล Azure

  2. ค้นหา แอปพลิเคชัน Enterprise และเลือกจากผลลัพธ์การค้นหา

  3. จากรายการดรอปดาวน์ ชนิดแอปพลิเคชัน เลือก แอปพลิเคชันทั้งหมด จากนั้นเลือก ใช้

  4. ในกล่องค้นหา ค้นหาตามชื่อแอปพลิเคชันหรือ ID ออบเจ็กต์ ให้ป้อน Azure Storage

  5. ถ้า Azure Storage ไม่ได้อยู่ในรายการ เปิด PowerShell ในฐานะผู้ดูแลระบบและเรียกใช้คําสั่งต่อไปนี้:

    Install-Module az
Import-Module az
Connect-AzureAD
New-AzureADServicePrincipal -AppId e406a681-f3d4-42a8-90b6-c2b029497af1

ขั้นตอนที่ 2: ดาวน์โหลดตัวอย่าง

ทําตามขั้นตอนเหล่านี้เพื่อเรียกใช้ปริมาณงานตัวอย่าง

  1. นําทางไปยังที่เก็บ Project Directory ของ ตัวอย่าง เลือก รหัส จากนั้นเลือก ดาวน์โหลดZIP

  2. แยกเนื้อหาของไฟล์ zip ไปยังไดเรกทอรีภายในเครื่องบนเครื่องของคุณ โฟลเดอร์ใหม่ที่ชื่อว่า Microsoft-Fabric-workload-development-sample- จะถูกสร้างขึ้น

ขั้นตอนที่ 3: รับ ID ผู้เช่าของคุณ

ทําตามขั้นตอนเหล่านี้เพื่อรับ ID ผู้เช่าของคุณ

  1. เข้าสู่ระบบ Fabric ด้วยผู้ใช้ที่คุณต้องการใช้เพื่อสร้างปริมาณงาน

  2. เลือก ความช่วยเหลือ & Support (เครื่องหมายคําถาม ?) จากนั้นเลือก เกี่ยวกับ

  3. จาก URL ผู้เช่า ให้คัดลอกสตริงของตัวเลขและตัวอักษรหลังจาก https://app.powerbi.com/home?ctid= นี่คือ ID ผู้เช่าของคุณ

    ตัวอย่างเช่น ถ้า URL ผู้เช่าของคุณ https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffffID ผู้เช่าของคุณ bbbbcccc-1111-dddd-2222-eeee3333ffff

ขั้นตอนที่ 4: สร้างแอปพลิเคชัน Microsoft Entra ID

ใช้สคริปต์ที่ให้มาเพื่อสร้างแอปพลิเคชัน Azure Entra ID

  1. เปิดPowerShell

  2. นําทางไปยัง Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication folder

  3. เรียกใช้คําสั่งในขั้นตอนนี้ เมื่อต้องการรับรองความถูกต้อง ให้ใช้ข้อมูลประจําตัวของผู้ใช้ที่คุณกําลังใช้เพื่อสร้างปริมาณงาน

    .\CreateDevAADApp.ps1 -applicationName "myWorkloadApp" -workloadName "Org.WorkloadSample" -tenantId "<your-tenant-id>"

  4. คัดลอกรายละเอียดต่อไปนี้จากผลลัพธ์ของสคริปต์:

    • ApplicationIdUri / Audience - ตัวอย่างเช่น api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • RedirectURI ของ
    • รหัสแอปพลิเคชัน - ตัวอย่างเช่น 00001111-aaaa-2222-bbbb-3333cccc4444
    • ลับ - ตัวอย่างเช่น

ขั้นตอนที่ 5: อัปเดตไฟล์ .env.dev

  1. นําทางไปยังโฟลเดอร์ Microsoft-Fabric-workload-development-sample-main และนําทางไปยังโฟลเดอร์ Frontend

  2. เปิดไฟล์ .env.dev ด้วยตัวแก้ไขข้อความ

  3. ป้อนรายละเอียดต่อไปนี้:

    • DEV_AAD_CONFIG_AUDIENCE= - ผู้ชมจากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • DEV_AAD_CONFIG_APPID= - ID แอปพลิเคชันจากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444

  4. บันทึกไฟล์ .env.dev

ขั้นตอนที่ 6: เรียกใช้ frontend

เปิด PowerShell และทําดังต่อไปนี้:

  1. นําทางไปยังโฟลเดอร์ Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend

  2. เมื่อต้องการติดตั้งการขึ้นต่อกัน ให้เรียกใช้คําสั่ง npm install โฟลเดอร์ใหม่ที่เรียกว่า node_modules ถูกสร้างขึ้น

  3. เมื่อต้องการเริ่มต้น frontend ให้เรียกใช้คําสั่ง npm start

    เมื่อ frontend ทํางานได้สําเร็จ คุณจะเห็นข้อความที่รวม ได้สําเร็จ ใน PowerShell และเว็บเบราว์เซอร์ของคุณจะเปิดด้วย URL http://localhost:60006/ เมื่อต้องการตรวจสอบว่า frontend ทํางานได้สําเร็จหรือไม่ ในเบราว์เซอร์ของคุณ ให้นําทางไปยัง http://localhost:60006/manifests

ขั้นตอนที่ 7: เปิด Visual Studio 2022

ส่วนที่เหลือของขั้นตอนในการเริ่มต้นใช้งานด่วนนี้จะดําเนินการใน Visual Studio 2022 ใช้ขั้นตอนนี้เพื่อเปิดโซลูชันของคุณใน Visual Studio 2022 เมื่อโซลูชันของคุณเปิดอยู่ คุณสามารถเปิด Visual Studio ต่อไปในขณะที่คุณทําตามขั้นตอนที่เหลือ

  1. นําทางไปยังโฟลเดอร์ Microsoft-Fabric-workload-development-sample-main และนําทางไปยังโฟลเดอร์ Backend

  2. ใน Visual Studio 2022ให้เปิดไฟล์ Fabric_Extension_BE_Boilerplate.sln

ขั้นตอนที่ 8: อัปเดตไฟล์ backend

  1. ในSolution Explorer ขยาย Fabric_Extension_BE_Boilerplate และเปิดไฟล์ appsettings.json และกรอกข้อมูลในเขตข้อมูลต่อไปนี้:

    • PublisherTenantId - ID ผู้เช่าของคุณ ตัวอย่างเช่น PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff"
    • ClientId - id แอปพลิเคชัน จากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444"
    • ClientSecret - ลับ จากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2"
    • Audience - applicationIdUri / Audience จากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR"

  2. บันทึกไฟล์ appsettings.json

  3. ในSolution Explorer ให้ขยายโฟลเดอร์ Packages แสดงรายการและเปิดไฟล์ WorkloadManifest.xml และกรอกข้อมูลในเขตข้อมูลต่อไปนี้:

    • AppID - ID แอปของคุณ ตัวอย่างเช่น <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>
    • RedirectUri - URI เปลี่ยนเส้นทางของคุณ <RedirectUri>http://localhost:60006/close</RedirectUri>
    • ResourceId - applicationIdUri / Audience จากผลลัพธ์ของสคริปต์ ตัวอย่างเช่น <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>

  4. บันทึกไฟล์ WorkloadManifest.xml

ขั้นตอนที่ 9: สร้างแพคเกจ NuGet

  1. จากเมนู Visual Studio ให้เลือก สร้าง > สร้างโซลูชัน บิลด์จะสร้างแพคเกจ NuGet ที่มีไฟล์ XML และ JSON frontend และ Backend

  2. จากหน้าต่าง Output ใช้เส้นทางที่แสดงอยู่ในแถวที่เริ่มต้นด้วย 1สร้างแพคเกจสําเร็จ

    ในตัวอย่างผลลัพธ์นี้ เส้นทางจะถูกเน้นด้วยตัวหนา 1>Successfully created package C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg

ขั้นตอนที่ 10: คัดลอกไปยังไดรฟ์ภายในเครื่องของคุณ

  1. ในSolution Explorer ให้เปิดไฟล์ workload-dev-mode.json

  2. กรอกข้อมูลในเขตข้อมูลต่อไปนี้:

    • WorkspaceGuid - ID พื้นที่ทํางาน Fabric ของคุณ

      คุณสามารถค้นหา ID พื้นที่ทํางานของคุณได้โดยการนําทางไปยังพื้นที่ทํางานที่คุณกําลังใช้ใน Fabric เมื่อคุณอยู่ในพื้นที่ทํางาน จาก URL ให้คัดลอกสตริงของตัวเลขและตัวอักษรหลังจาก https://app.powerbi.com/groups/ ID พื้นที่ทํางานลงท้ายด้วยเครื่องหมายทับ ตัวอย่างเช่น หาก URL พื้นที่ทํางานของคุณ https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-biID พื้นที่ทํางานของคุณ bbbbcccc-1111-dddd-2222-eeee3333ffff

    • ManifestPackageFilePath - เส้นทางของไฟล์แพคเกจรายชื่อแฟ้ม (ขั้นตอนที่ 9) ตัวอย่างเช่น "ManifestPackageFilePath": "C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg"

  3. บันทึกไฟล์ workload-dev-mode.json

  4. คัดลอกไฟล์ workload-dev-mode.json จาก src/Config ไปยัง C:\

ขั้นตอนที่ 11: เรียกใช้หม้อน้ํา

  1. ใน Visual Studio 2022 จากเมนู เลือกลูกศรถัดจาก IIS Express และจากเมนูดรอปดาวน์ เลือก ต้นแบบ

  2. เลือก หม้อน้ํา และอนุญาตคําขอของ Visual Studio พร้อมท์คําสั่งจะเปิดขึ้นพร้อมข้อมูลเกี่ยวกับโซลูชันการเรียกใช้

ขั้นตอนที่ 12: เรียกใช้ไฟล์ DevGateway

  1. เปิด PowerShell และนําทางไปยังโฟลเดอร์ DevGateway ของ

  2. ใน PowerShell ให้เรียกใช้คําสั่ง: .\Microsoft.Fabric.Workload.DevGateway.exe เมื่อเอาต์พุตแสดงข้อมูล : DevGateway เริ่มต้นใช้งาน ปริมาณงานกําลังทํางานเสร็จเรียบร้อยแล้ว

ขั้นตอนที่ 13: เปิดปริมาณงานตัวอย่างใน Fabric

ปลาย

หากต้องการเปิดปริมาณงานตัวอย่างใน Fabric คุณจําเป็นต้องเปิดและเรียกใช้หน้าต่าง PowerShell สามหน้าต่าง:

  • frontend - Powershell ที่มีคําสั่ง npm start ทํางานตามที่อธิบายไว้ใน ขั้นตอนที่ 6
  • หม้อน้ํา - Powershell ที่ใช้งานหม้อน้ําตามที่อธิบายไว้ใน ขั้นตอนที่ 11
  • DevGateway - A Powershell ที่ทํางาน DevGateway.exeตามที่อธิบายไว้ใน ขั้นตอนที่ 12

  1. เปิด Microsoft Fabric

  2. นําทางไปยังพื้นที่ทํางานที่คุณกําลังใช้สําหรับการพัฒนา

  3. เลือก รายการใหม่

  4. เปิด รายการตัวอย่าง (ตัวอย่าง)

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