建立並管理 OneLake 安全角色

OneLake 的安全角色讓你能控制誰可以存取 Fabric 資料項目中的特定資料表和資料夾。 在 管理 OneLake 安全性 中,使用角色檢視來設定角色,使用成員檢視來管理成員,並使用資料檢視來查看資料如何受到保護與共用。 關於 OneLake 安全概念與權限的概述,請參閱 OneLake 中的資料安全。

建立 OneLake 安全角色以控制以下項目類型的資料存取:

布料項目 支援的權限
Lakehouse 讀取、讀寫
Azure Databricks 鏡像目錄 參閱
鏡像資料庫 參閱
鏡像目錄 參閱

角色創建和成員分配會在你儲存角色後立即生效,所以在將某人新增至角色前,務必確定你願意授權存取權限。

先決條件

  • Fabric 寫入或重分享權限(通常包含給管理員或成員工作區使用者)

管理角色

使用 「所有角色」 標籤來建立角色並管理每個角色的權限、資料和成員資格。

建立角色

使用下列步驟來建立 OneLake 安全角色。

  1. 打開你想要控制資料存取的 Fabric 項目。

  2. 從項目選單中選擇 「管理 OneLake 安全 」。

  3. 在 OneLake 的安全性面板上,於 所有 <項目類型> 角色 索引標籤上,選取 新增。

  4. 請提供以下新職務相關資訊:

    參數 價值觀
    角色名稱 請提供符合以下指引的名稱:

    * 角色名稱僅包含字母數字。
    * 角色名稱以字母開頭。
    * 名稱不區分大小寫,必須是唯一的。
    * 最大姓名長度為128個字元。
    角色類型 OneLake 安全性僅支援 Grant 角色類型。
    選擇授權權限 選擇你想授予的權限。 Read 是最低權限,你可以為某些項目類型新增 ReadWrite 。

    Note

    你可以對只授予 讀取 權限的角色套用列層級安全(RLS)和欄位層級安全(CLS)。 授予 ReadWrite 權限的角色無法使用 RLS 與 CLS 選項。

  5. 選取 下一步。

  6. 為你的角色加入資料。 透過選擇包含的資料來定義角色範圍。

    • 所有資料:此角色授權存取本項目中所有的資料表和檔案。 此選擇同時也提供未來新增資料夾的存取權限。
    • 選取資料:此角色授予對特定資料表與資料夾的存取權限。 然後,使用下列步驟來定義此角色的核准資料。
  7. 如果你在前一步選擇 了「選取資料 」,請設定該選擇:

    1. 請選取 ,再編輯。

      突顯「編輯」按鈕以選取資料的截圖。

    2. 展開表格與檔案目錄以查看您項目中的資料。

    3. 請核取角色要套用到的表格和檔案旁的方塊。

    4. 若要對資料表套用列級或欄級安全性,請選擇資料表名稱。 接著,選擇 資料存取,並選擇相應的選項。 欲了解更多資訊,請參閱 應用列層級安全 與 應用欄位層級安全。

      截圖中標示了資料表的資料存取選項。

    5. 選取 [ 新增資料 ] 以將選取的專案新增至您的角色。

  8. 選取 下一步。

  9. 新增成員到你的角色中。 手動輸入你想納入角色的使用者姓名或電子郵件地址。 或者,選擇 進階設定 ,並依照 「指派虛擬成員」中的步驟操作。

    Important

    在你將使用者加入有限制存取權限的角色之前,先確認 DefaultReader 角色是否已經授權他們更廣泛的存取權限。 若要限制他們的存取,請將他們從 DefaultReader 角色中移除,或修改或移除 DefaultReader 角色。

  10. 選取 ,創建。

檢視並編輯角色

使用下列步驟來編輯現有的 OneLake 資訊安全角色。

  1. 開啟您要定義安全性的項目。

  2. 從項目選單中選擇 「管理 OneLake 安全 」。

  3. 在 OneLake 安全 面板的「 所有 <項目類型> 角色」 標籤中,選擇你想編輯的角色。

    此動作會開啟角色詳情頁面。 角色詳情頁面頂端顯示角色名稱、權限和類型。 角色詳情頁面底部有兩個分頁: 角色中的資料 與 角色中的成員。

  4. 選擇編輯以更新角色名稱或編輯角色權限。

    Fabric 入口網站的截圖,顯示開啟編輯選單以更新角色名稱或權限。

  5. 選擇「 角色中的資料 」標籤,以查看該角色成員可存取的所有資料。

    截圖顯示在「角色資料」分頁中可見的細節。

    Column 它顯示的內容
    數據 角色授權存取的表格或資料夾。 展開與摺疊結構以查看下方項目,將滑鼠移至條目上以查看其完整路徑,或將滑鼠移至更多選項(...)以設定列級或欄級安全。 欲了解更多資訊,請參閱 OneLake 中的資料表、欄位及列級安全性。
    Type 項目類型: Schema、 Table 或 Folder。
    資料存取 項目是否有列級或欄級限制。 帶有橫線的鎖具圖示表示列級安全;帶有垂直線條的鎖具圖示代表欄位層級的安全。
  6. 對職務中的資料做出以下任一項變更:

    • 新增或移除資料表與資料夾:選擇 編輯資料 以開啟資料表與資料夾選擇對話框。 勾選或取消勾選資料表或資料夾,以將其新增至角色或從角色中移除,然後選擇 新增資料 以確認所選項目。
    • 新增或編輯列級安全性:欲了解更多資訊,請參閱 「對資料表套用列級安全」。
    • 新增或編輯欄位層級安全性:欲了解更多資訊,請參閱 「對資料表套用欄位層級安全性」。
  7. 選擇「 角色中的成員 」標籤以查看該角色的成員。

    顯示「角色中的成員」分頁中可見詳細資料的螢幕擷取畫面。

    Column 它顯示的內容
    成員 成員的頭像和姓名。
    Type 無論成員是使用者還是群組。
    新增使用 使用者如何成為該角色的成員:直接透過電子郵件地址,或作為群組的一員。 欲了解更多透過權限群組新增使用者的資訊,請參閱 「指派虛擬成員」。
  8. 若要編輯角色的成員,請選取 新增成員。

    • 若要手動新增成員,請在 [ 將成員新增至您的角色 ] 文字方塊中輸入名稱或電子郵件。 從建議的清單中選取正確的名稱。 然後,選取核取圖示以確認您的選擇,或選取 X 圖示以清除選取。

    • 若要根據 Fabric 項目權限新增成員,請選擇「進階設定」並建立虛擬會員群組。 欲了解更多資訊,請參閱 「指派虛擬會員」。

  9. 若要從角色中移除使用者,請選取其名稱旁的更多選項 (...),然後選取 [從角色中移除]。

當你對角色成員身份做任何更改時,該角色會立即更新。 通知會顯示任何變更的成功或失敗。

對資料表套用列級安全性

將列級安全(RLS)規則定義為任何 OneLake 安全角色的一部分,該角色允許存取 Delta Parquet 格式的表格資料。 列只對表格資料相關,所以你無法為非表格資料夾或非結構化資料定義 RLS。 最佳做法是避免模糊或過於複雜的RLS表達式。 完整規則語法請參見 列級安全語法參考。

  1. 前往你的項目,選擇 管理 OneLake 安全。

  2. 選擇現有角色,或選擇 新角色 以建立新角色。

  3. 在角色詳細資料頁面上,選取您想要保護之資料表旁的更多選項(...),然後選取 資料列安全性。

    顯示選取資料列安全性以編輯資料表權限的螢幕擷取畫面。

  4. 在程式碼編輯器中,輸入定義使用者可看到哪些列的 SQL 語句。 語法指引請參見 列級安全語法參考。

  5. 選擇[儲存]以確認資料列安全性規則。

對資料表套用欄位層級安全性

在 OneLake 安全性角色中,為任何 Delta Parquet 資料表定義欄位層級安全性(CLS)。 預設情況下,使用者可存取所有欄位。 建立 CLS 規則,隱藏欄位以撤銷存取權限。

Important

如果另一個角色授與了對某個資料行的存取權,即使移除對該資料行的存取權,仍然不會阻止對該資料行的存取。

  1. 到你的資料項目,選擇 管理 OneLake 安全。

  2. 選擇現有角色,或選擇 新角色 以建立新角色。

  3. 在角色詳情頁面,選擇你想保護的資料表旁的更多選項(...),然後選擇 欄位安全。

    截圖顯示你選取資料行安全性,以編輯資料表上的權限。

  4. 要移除對欄位的存取權限,請設定欄位「 Permission to Hide」。 使用勾選框選取多個欄位並批量設定權限。 使用 篩選 依權限檢視欄位。 允許的資料行清單中必須保留至少一個資料行。

  5. 選取 [儲存]。

刪除角色

請依照以下步驟刪除 OneLake 的安全角色。

  1. 開啟您要定義安全性的項目。

  2. 從項目選單中選擇 「管理 OneLake 安全 」。

  3. 在 OneLake 安全 面板的「 所有 <項目類型> 角色」 標籤中,勾選你想刪除的角色旁邊的方框。

  4. 選取 [刪除] ,然後等待角色已成功刪除的通知。

管理成員資格

使用「角色中的所有成員」索引標籤,檢視並管理該項目中所有 OneLake 安全角色的使用者與群組。

指派成員或團體擔任角色

OneLake 安全角色支援新增個別使用者、Microsoft Entra 群組及安全主體。

你可以直接在」頁面的「>」欄位,將使用者或群組加入角色。 你也可以透過 進階設定 控制來建立帶有權限群組的虛擬會員。

當你直接將使用者加入角色時,你會讓他們成為該角色的明確成員。 這些使用者會以姓名和照片出現在 會員 名單中。

Important

當你將使用者加入 OneLake 的安全角色時,請將他們從 DefaultReader 角色中移除。 否則,他們會保留對資料的完整存取權限。

該角色的虛擬會員資格會根據使用者的 Fabric 項目權限動態調整。 當您選取進階設定和某項權限時,Fabric 工作區中任何擁有所有所選權限的使用者,都會被加入為該角色的隱含成員。 例如,如果您選擇 ReadAll, Write,則 Fabric 工作區中任何對該項目具有 ReadAll 和 Write 權限的使用者,都會成為該角色的成員。 要查看權限群組包含哪些使用者,請查看「角色中的成員」索引標籤中的 「新增方式」 欄位。你無法手動移除這些成員。 要移除你透過權限群組新增的成員,請從該角色中移除該權限群組。

指派虛擬成員

請使用以下權限來識別虛擬成員:

  • 參閱
  • 書寫
  • 重新分享
  • Execute
  • 閱讀全部

要將使用者指派到權限群組,請使用以下步驟:

  1. 選取您要指派成員的角色名稱。

  2. 在角色詳細資料頁面上,選取角色中的成員標籤。

  3. 選取 [新增成員]。

  4. 選取 [進階設定]。

    截圖顯示透過權限群組選擇進階設定以新增成員。

  5. 在 權限群組 框中,選擇每個你想包含使用者權限旁的勾選框。

    每個權限群組顯示該群組中有多少使用者。

    選取多個權限群組會包含具有所有所選必要權限的使用者。

  6. 選取 [ 新增 ] 以包含群組並儲存角色。

依會員檢視存取權限

查看哪些角色賦予成員存取權限,以及成員可以存取哪些資料。

  1. 打開你想查看存取權限的項目。

  2. 從項目選單中選擇 「管理 OneLake 安全 」。

  3. 選擇 「角色中的所有成員」 標籤。

    該頁面列出屬於 OneLake 安全角色的每個使用者或群組,以及他們所屬的角色。

  4. 選擇使用者或群組以開啟其存取資訊。

  5. 選擇 角色 以瀏覽該使用者或群組所屬的角色。

  6. 選擇「授權資料」以瀏覽成員可存取的資料,並識別哪個角色授權存取每個資料表或資料夾。

  7. 要更改使用者或群組的存取權限,請選擇角色並編輯其資料或成員。

新增成員至多個角色

同時為多個 OneLake 安全角色新增多個使用者或群組。

  1. 在「角色中的所有成員」標籤中,選擇 新增成員。

  2. 使用 角色 下拉選單選擇你想指派的每個角色。

  3. 在 「成員」 文字框中,輸入你想新增的使用者或群組。 或者,選擇 進階設定 來 指派虛擬成員。

  4. 選取 ,然後新增。

將成員從所有角色中移除

當該使用者或群組不再有權限存取該項目中的資料時,請將該使用者或群組從所有 OneLake 安全角色中移除。

  1. 在角色中的所有成員索引標籤中,選擇你想要移除的使用者或群組。

  2. 選擇「從項目類型移除」(例如「從鏡像目錄移除」),即可撤銷該成員在所有 OneLake 安全角色中的資料存取權。

管理數據

使用 「角色中的所有資料」 標籤來檢視該項目中的所有資料,並了解哪些角色授權存取這些資料。

依資料檢視存取權限

  1. 打開你想查看存取權限的項目。

  2. 從項目選單中選擇 「管理 OneLake 安全 」。

  3. 選擇 「角色中的所有資料」 標籤。

    該頁面列出項目中的表格、授權存取每個表格的角色,以及有權限的成員人數。

  4. 選擇一個表格以查看適用於該表格的角色與權限。

  5. 檢視能進入該表格的成員。