แชร์ผ่าน

วิธีการ: สร้างคลังสินค้าที่มีการจัดเรียงแบบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก (CI)

  • บทความ

นําไปใช้กับ:✅ Warehouse ใน Microsoft Fabric

คลังสินค้า Fabric ทั้งหมดตามค่าเริ่มต้นจะถูกกําหนดค่าด้วยการจัดเรียงแบบตรงตามตัวพิมพ์ใหญ่-เล็ก (CS) Latin1_General_100_BIN2_UTF8 คุณยังสามารถสร้างคลังสินค้าที่มีการจัดเรียงแบบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก (CI) - Latin1_General_100_CI_AS_KS_WS_SC_UTF8 ได้

ในปัจจุบัน วิธีการเดียวเท่านั้นที่พร้อมใช้งานสําหรับการสร้างคลังข้อมูลแบบไม่ไวต่ออักษรใหญ่เล็กคือผ่านทาง REST API บทความนี้ให้คําแนะนําทีละขั้นตอนเกี่ยวกับวิธีการสร้างคลังสินค้าที่มีการจัดเรียงแบบตรงตามตัวพิมพ์ใหญ่-เล็กผ่าน REST API นอกจากนี้ยังอธิบายวิธีการใช้ Visual Studio Code กับส่วนขยาย REST Client เพื่ออํานวยความสะดวกในกระบวนการ

สำคัญ

เมื่อสร้างคลังสินค้าแล้ว จะไม่สามารถเปลี่ยนแปลงการตั้งค่าการจัดเรียงได้ พิจารณาความต้องการของคุณอย่างรอบคอบก่อนที่จะเริ่มกระบวนการสร้าง

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

  • พื้นที่ทํางาน Fabric ที่มีความจุที่ใช้งานอยู่หรือความจุรุ่นทดลองใช้
  • ดาวน์โหลดและติดตั้ง Visual Studio Code เพื่อดาวน์โหลดและติดตั้งแอปพลิเคชัน
  • ติดตั้ง REST Client - Visual Studio Marketplace

จุดสิ้นสุด API

หากต้องการสร้างคลังสินค้าด้วย REST API ให้ใช้จุดสิ้นสุด API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

นี่คือตัวอย่างเนื้อความคําขอ JSON สําหรับการสร้างคลังสินค้า:

{ 
  "type": "Warehouse", 
  "displayName": "CaseInsensitiveAPIDemo", 
  "description": "New warehouse with case-insensitive collation", 
  "creationPayload": { 
    "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
  } 
}

ใช้รหัส Visual Studio เพื่อเรียกใช้ REST API

คุณสามารถสร้างคลังสินค้าใหม่ด้วยการจัดเรียงแบบไม่เทียบตรงตามตัวพิมพ์ใหญ่-เล็กได้อย่างง่ายดายโดยใช้ Visual Studio Code (VS Code) และส่วนขยาย REST Client ทำตามขั้นตอนเหล่านี้:

  1. สร้างไฟล์ข้อความใหม่ใน VS Code ด้วย .http ส่วนขยาย

  2. ป้อนรายละเอียดคําขอในเนื้อความไฟล์ โปรดทราบว่าควรมีช่องว่างระหว่างส่วนหัวและเนื้อความ วางไว้หลังจากบรรทัด "การอนุญาต"

      POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceID>/items HTTP/1.1
  Content-Type: application/json
  Authorization: Bearer <bearer token>

{ 
   "type": "Warehouse", 
   "displayName": "<Warehouse name here>", 
   "description": "<Warehouse description here>", 
   "creationPayload": { 
     "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
   } 
 }

  3. แทนที่ค่าตัวแทนข้อความ:

    • <workspaceID>: ค้นหาพื้นที่ทํางาน GUID ใน URL หลังจาก /groups/ ส่วน หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่

    • <bearer token>: ขอรับสิทธิ์นี้โดยทําตามขั้นตอนเหล่านี้:

      1. เปิดพื้นที่ทํางาน Microsoft Fabric ของคุณในเบราว์เซอร์ (Microsoft Edge หรือ Google Chrome)
      2. กด F12 เพื่อเปิด เครื่องมือสําหรับนักพัฒนา
      3. เลือก แท็บคอนโซล ถ้าจําเป็น เลือก ขยายมุมมอง ด่วนเพื่อแสดงพร้อมท์ >คอนโซล
      4. พิมพ์คําสั่งcopy(powerBIAccessToken)และกด Enter ในขณะที่คอนโซลตอบสนองที่ไม่ได้กําหนดโทเค็นแบบแบเรอร์จะถูกคัดลอกไปยังคลิปบอร์ดของคุณ
      5. วางแทนที่<bearer token>

      โน้ต

      ในบางสถานการณ์ copy(powerBIAccessToken) อาจล้มเหลวด้วยข้อผิดพลาด uncaught TypeError: copy is not a function ถ้ามีรหัสองค์ประกอบใด ๆ ที่มีชื่อว่า "คัดลอก" ในหน้า ในกรณีดังกล่าว ให้ลบรหัสองค์ประกอบด้วยตนเองโดยใช้คําสั่งต่อไปนี้ก่อนที่จะใช้ฟังก์ชัน "คัดลอก": document.querySelector('#copy').remove()

    • <Warehouse name here>: ป้อนชื่อคลังสินค้าที่ต้องการ

    • <Warehouse description here>: ป้อนคําอธิบายคลังสินค้าที่ต้องการ

  4. เลือก ลิงก์ส่งคําขอ ที่แสดงอยู่เหนือคําสั่ง POST ของคุณในตัวแก้ไข VS Code

  5. คุณควรได้รับการตอบกลับด้วยรหัส สถานะ 202 เป็นที่ยอมรับพร้อมกับรายละเอียดเพิ่มเติมเกี่ยวกับคําขอ POST ของคุณ

  6. ไปยังคลังสินค้าที่สร้างขึ้นใหม่ในพอร์ทัล Fabric

  7. ดําเนินการคําสั่ง T-SQL ต่อไปนี้ในตัวแก้ไขคิวรีเพื่อยืนยันว่าการจัดเรียงสําหรับคลังสินค้าของคุณสอดคล้องกับสิ่งที่คุณระบุใน JSON ด้านบน:

    SELECT name, collation_name FROM sys.databases;

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