共用方式為


使用 Fabric CLI 建立 SQL 資料庫

適用於:✅Microsoft Fabric 中的 SQL 資料庫

您可以使用 Fabric 命令行介面 (CLI) 在 Fabric 中建立 SQL 資料庫。 Fabric CLI (fab) 是適用於 Microsoft Fabric 的快速檔案系統啟發命令行介面。

本文和範例腳本示範可用來部署 Fabric SQL 資料庫的基本 Fabric CLI 命令。

先決條件

在開始之前:

  • 您需要具備現有的 Fabric 容量。 如果您不這麼做, 請啟動 Fabric 試用版

  • 您可以使用現有的工作區或 建立新的 Fabric 工作區

  • 您必須是 工作區管理員或成員角色 的成員,才能建立 SQL 資料庫。

  • 請確定電腦上安裝 Python 3.10、3.11 或 3.12 版。 Python 應該可透過 PATH 環境變數從終端機存取。

  • 使用下列命令在您的電腦上安裝 Fabric CLI。 如果您在安裝程式的輸出中看到有關更新PATH的訊息,請在繼續之前修正它,否則後續步驟可能會失敗。

    pip install ms-fabric-cli
    

使用 Fabric CLI 建立新的 SQL 資料庫

  1. 登入 Microsoft Fabric。 開啟命令提示字元並執行下列命令:

    fab auth login 
    
  2. 請遵循提示,使用具有 Fabric 工作區存取權的 Microsoft 帳戶進行驗證。

  3. 執行下列命令以建立新的 SQL 資料庫:

    • <workspacename> 替換為您希望建立 SQL 資料庫的工作區名稱。
    • <databasename> 替換為您要用於新 SQL 資料庫的名稱。
    fab create <workspacename>.Workspace/<databasename>.SQLDatabase
    
  4. 使用下列命令確認工作區中的新 SQL 資料庫:

    • <workspacename> 替換為您希望建立 SQL 資料庫的工作區名稱。
    fab ls <workspacename>.Workspace 
    

    此命令 fab ls 會顯示工作區中所有項目的清單,包括新的 SQL 資料庫。

資料庫定序

預設情況下,資料庫是以大小寫不區分的彙整 SQL_Latin1_General_CP1_CI_AS建立的。

資料庫整合在建立後無法修改,但支援對單一欄位的整合。

當你用 Fabric CLI 建立資料庫時,你可以直接用 fab api 的 指令集呼叫 Fabric API。 在參數中指定所需的工作區、新的資料庫名稱與描述,以及想要的排序。

目前,建立非預設整合的資料庫時,必須使用此 fab cli 指令。 語法相似,例如:

fab api workspaces/<workspace unique ID>/sqldatabases -X post -H "Content-Type=application/json" -i "{\"displayName\": \"<new database name>\", \"description\": \"<new database description>\", \"creationPayload\":{\"collation\": \"Latin1_General_100_BIN2_UTF8\",\"creationMode\": \"new\"}}"

此範例在工作區建立一個新資料庫,擁有唯一 ID workspace unique ID,並包含名稱 <new database name>、描述 <new database description>及排序 Latin1_General_100_BIN2_UTF8