共用方式為

如何：建立不區分大小寫的倉儲（CI） 定序

  • 發行項

適用於✅：Microsoft 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 用戶端延伸模組來加速程式。

重要

建立倉儲之後，就無法變更定序設定。 在起始建立程式之前，請仔細考慮您的需求。

必要條件

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 Code 叫用 REST API

您可以使用 Visual Studio Code （VS Code） 和 REST 用戶端擴充功能，輕鬆地建立不區分大小寫定序的新倉儲。 執行下列步驟:

  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>：在區段之後 /groups/ 或在現有倉儲中執行 SELECT @@SERVERNAME ，在URL中尋找工作區 GUID。

    • <bearer token>：依照下列步驟取得此專案：

      1. 在瀏覽器中開啟您的 Microsoft Fabric 工作區（Microsoft Edge 或 Google Chrome）。
      2. 按 F12 開啟開發人員工具。
      3. 選取 [主控台] 索引標籤。如有必要，請選擇 [展開快速檢視] 以顯示主控台提示 >。
      4. 輸入 命令 copy(powerBIAccessToken) ，然後按 Enter 鍵。 當主控台回應未定義時，持有人令牌將會複製到剪貼簿。
      5. 將它貼到 取代 <bearer token>。

      注意

      在某些情況下，如果頁面中有任何項目識別碼名為「copy」，則 copy(powerBIAccessToken) 可能會失敗，並報告錯誤 uncaught TypeError: copy is not a function。 在這種情況下，請先使用下列命令手動移除元素識別碼，再使用 「copy」 函式：document.querySelector('#copy').remove()。

    • <Warehouse name here>：輸入所需的倉儲名稱。

    • <Warehouse description here>：輸入所需的倉儲描述。

  4. 選取 VS Code 編輯器中透過 POST 命令顯示的 [傳送要求 ] 連結。

  5. 您應該會收到狀態代碼 為 202 已接受的回應，以及 POST 要求的其他詳細數據。

  6. 移至網狀架構入口網站中新建立的倉儲。

  7. 在查詢編輯器中執行下列 T-SQL 語句，以確認倉儲的定序與您上述 JSON 中指定的定序一致：

    SELECT name, collation_name FROM sys.databases;

相關內容