OneLake 的安全角色讓你能控制誰可以存取 Fabric 資料項目中的特定資料表和資料夾。 在 管理 OneLake 安全性 中,使用角色檢視來設定角色,使用成員檢視來管理成員,並使用資料檢視來查看資料如何受到保護與共用。 關於 OneLake 安全概念與權限的概述,請參閱 OneLake 中的資料安全。
建立 OneLake 安全角色以控制以下項目類型的資料存取:
| 布料項目 | 支援的權限 |
|---|---|
| Lakehouse | 讀取、讀寫 |
| Azure Databricks 鏡像目錄 | 參閱 |
| 鏡像資料庫 | 參閱 |
| 鏡像目錄 | 參閱 |
角色創建和成員分配會在你儲存角色後立即生效,所以在將某人新增至角色前,務必確定你願意授權存取權限。
先決條件
- Fabric 寫入或重分享權限(通常包含給管理員或成員工作區使用者)
管理角色
使用 「所有角色」 標籤來建立角色並管理每個角色的權限、資料和成員資格。
建立角色
使用下列步驟來建立 OneLake 安全角色。
打開你想要控制資料存取的 Fabric 項目。
從項目選單中選擇 「管理 OneLake 安全 」。
在 OneLake 的安全性面板上,於 所有 <項目類型> 角色 索引標籤上,選取 新增。
請提供以下新職務相關資訊:
參數 價值觀 角色名稱 請提供符合以下指引的名稱:
* 角色名稱僅包含字母數字。
* 角色名稱以字母開頭。
* 名稱不區分大小寫,必須是唯一的。
* 最大姓名長度為128個字元。角色類型 OneLake 安全性僅支援 Grant 角色類型。 選擇授權權限 選擇你想授予的權限。 Read 是最低權限,你可以為某些項目類型新增 ReadWrite 。 Note
你可以對只授予 讀取 權限的角色套用列層級安全(RLS)和欄位層級安全(CLS)。 授予 ReadWrite 權限的角色無法使用 RLS 與 CLS 選項。
選取 下一步。
為你的角色加入資料。 透過選擇包含的資料來定義角色範圍。
- 所有資料:此角色授權存取本項目中所有的資料表和檔案。 此選擇同時也提供未來新增資料夾的存取權限。
- 選取資料:此角色授予對特定資料表與資料夾的存取權限。 然後,使用下列步驟來定義此角色的核准資料。
如果你在前一步選擇 了「選取資料 」,請設定該選擇:
選取 下一步。
新增成員到你的角色中。 手動輸入你想納入角色的使用者姓名或電子郵件地址。 或者,選擇 進階設定 ,並依照 「指派虛擬成員」中的步驟操作。
Important
在你將使用者加入有限制存取權限的角色之前,先確認 DefaultReader 角色是否已經授權他們更廣泛的存取權限。 若要限制他們的存取,請將他們從 DefaultReader 角色中移除,或修改或移除 DefaultReader 角色。
選取 ,創建。
檢視並編輯角色
使用下列步驟來編輯現有的 OneLake 資訊安全角色。
開啟您要定義安全性的項目。
從項目選單中選擇 「管理 OneLake 安全 」。
在 OneLake 安全 面板的「 所有 <項目類型> 角色」 標籤中,選擇你想編輯的角色。
此動作會開啟角色詳情頁面。 角色詳情頁面頂端顯示角色名稱、權限和類型。 角色詳情頁面底部有兩個分頁: 角色中的資料 與 角色中的成員。
選擇編輯以更新角色名稱或編輯角色權限。
選擇「 角色中的資料 」標籤,以查看該角色成員可存取的所有資料。
Column 它顯示的內容 數據 角色授權存取的表格或資料夾。 展開與摺疊結構以查看下方項目,將滑鼠移至條目上以查看其完整路徑,或將滑鼠移至更多選項(...)以設定列級或欄級安全。 欲了解更多資訊,請參閱 OneLake 中的資料表、欄位及列級安全性。 Type 項目類型: Schema、 Table 或 Folder。 資料存取 項目是否有列級或欄級限制。 帶有橫線的鎖具圖示表示列級安全;帶有垂直線條的鎖具圖示代表欄位層級的安全。 對職務中的資料做出以下任一項變更:
- 新增或移除資料表與資料夾:選擇 編輯資料 以開啟資料表與資料夾選擇對話框。 勾選或取消勾選資料表或資料夾,以將其新增至角色或從角色中移除,然後選擇 新增資料 以確認所選項目。
- 新增或編輯列級安全性:欲了解更多資訊,請參閱 「對資料表套用列級安全」。
- 新增或編輯欄位層級安全性:欲了解更多資訊,請參閱 「對資料表套用欄位層級安全性」。
選擇「 角色中的成員 」標籤以查看該角色的成員。
Column 它顯示的內容 成員 成員的頭像和姓名。 Type 無論成員是使用者還是群組。 新增使用 使用者如何成為該角色的成員:直接透過電子郵件地址,或作為群組的一員。 欲了解更多透過權限群組新增使用者的資訊,請參閱 「指派虛擬成員」。 若要編輯角色的成員,請選取 新增成員。
若要手動新增成員,請在 [ 將成員新增至您的角色 ] 文字方塊中輸入名稱或電子郵件。 從建議的清單中選取正確的名稱。 然後,選取核取圖示以確認您的選擇,或選取 X 圖示以清除選取。
若要根據 Fabric 項目權限新增成員,請選擇「進階設定」並建立虛擬會員群組。 欲了解更多資訊,請參閱 「指派虛擬會員」。
若要從角色中移除使用者,請選取其名稱旁的更多選項 (...),然後選取 [從角色中移除]。
當你對角色成員身份做任何更改時,該角色會立即更新。 通知會顯示任何變更的成功或失敗。
對資料表套用列級安全性
將列級安全(RLS)規則定義為任何 OneLake 安全角色的一部分,該角色允許存取 Delta Parquet 格式的表格資料。 列只對表格資料相關,所以你無法為非表格資料夾或非結構化資料定義 RLS。 最佳做法是避免模糊或過於複雜的RLS表達式。 完整規則語法請參見 列級安全語法參考。
前往你的項目,選擇 管理 OneLake 安全。
選擇現有角色,或選擇 新角色 以建立新角色。
在角色詳細資料頁面上,選取您想要保護之資料表旁的更多選項(...),然後選取 資料列安全性。
在程式碼編輯器中,輸入定義使用者可看到哪些列的 SQL 語句。 語法指引請參見 列級安全語法參考。
選擇[儲存]以確認資料列安全性規則。
對資料表套用欄位層級安全性
在 OneLake 安全性角色中,為任何 Delta Parquet 資料表定義欄位層級安全性(CLS)。 預設情況下,使用者可存取所有欄位。 建立 CLS 規則,隱藏欄位以撤銷存取權限。
Important
如果另一個角色授與了對某個資料行的存取權,即使移除對該資料行的存取權,仍然不會阻止對該資料行的存取。
到你的資料項目,選擇 管理 OneLake 安全。
選擇現有角色,或選擇 新角色 以建立新角色。
在角色詳情頁面,選擇你想保護的資料表旁的更多選項(...),然後選擇 欄位安全。
要移除對欄位的存取權限,請設定欄位「 Permission to Hide」。 使用勾選框選取多個欄位並批量設定權限。 使用 篩選 依權限檢視欄位。 允許的資料行清單中必須保留至少一個資料行。
選取 [儲存]。
刪除角色
請依照以下步驟刪除 OneLake 的安全角色。
開啟您要定義安全性的項目。
從項目選單中選擇 「管理 OneLake 安全 」。
在 OneLake 安全 面板的「 所有 <項目類型> 角色」 標籤中,勾選你想刪除的角色旁邊的方框。
選取 [刪除] ,然後等待角色已成功刪除的通知。
管理成員資格
使用「角色中的所有成員」索引標籤,檢視並管理該項目中所有 OneLake 安全角色的使用者與群組。
指派成員或團體擔任角色
OneLake 安全角色支援新增個別使用者、Microsoft Entra 群組及安全主體。
你可以直接在」頁面的「>」欄位,將使用者或群組加入角色。 你也可以透過 進階設定 控制來建立帶有權限群組的虛擬會員。
當你直接將使用者加入角色時,你會讓他們成為該角色的明確成員。 這些使用者會以姓名和照片出現在 會員 名單中。
Important
當你將使用者加入 OneLake 的安全角色時,請將他們從 DefaultReader 角色中移除。 否則,他們會保留對資料的完整存取權限。
該角色的虛擬會員資格會根據使用者的 Fabric 項目權限動態調整。 當您選取進階設定和某項權限時,Fabric 工作區中任何擁有所有所選權限的使用者,都會被加入為該角色的隱含成員。 例如,如果您選擇 ReadAll, Write,則 Fabric 工作區中任何對該項目具有 ReadAll 和 Write 權限的使用者,都會成為該角色的成員。 要查看權限群組包含哪些使用者,請查看「角色中的成員」索引標籤中的 「新增方式」 欄位。你無法手動移除這些成員。 要移除你透過權限群組新增的成員,請從該角色中移除該權限群組。
指派虛擬成員
請使用以下權限來識別虛擬成員:
- 參閱
- 書寫
- 重新分享
- Execute
- 閱讀全部
要將使用者指派到權限群組,請使用以下步驟:
選取您要指派成員的角色名稱。
在角色詳細資料頁面上,選取角色中的成員標籤。
選取 [新增成員]。
選取 [進階設定]。
在 權限群組 框中,選擇每個你想包含使用者權限旁的勾選框。
每個權限群組顯示該群組中有多少使用者。
選取多個權限群組會包含具有所有所選必要權限的使用者。
選取 [ 新增 ] 以包含群組並儲存角色。
依會員檢視存取權限
查看哪些角色賦予成員存取權限,以及成員可以存取哪些資料。
打開你想查看存取權限的項目。
從項目選單中選擇 「管理 OneLake 安全 」。
選擇 「角色中的所有成員」 標籤。
該頁面列出屬於 OneLake 安全角色的每個使用者或群組,以及他們所屬的角色。
選擇使用者或群組以開啟其存取資訊。
選擇 角色 以瀏覽該使用者或群組所屬的角色。
選擇「授權資料」以瀏覽成員可存取的資料,並識別哪個角色授權存取每個資料表或資料夾。
要更改使用者或群組的存取權限,請選擇角色並編輯其資料或成員。
新增成員至多個角色
同時為多個 OneLake 安全角色新增多個使用者或群組。
在「角色中的所有成員」標籤中,選擇 新增成員。
使用 角色 下拉選單選擇你想指派的每個角色。
在 「成員」 文字框中,輸入你想新增的使用者或群組。 或者,選擇 進階設定 來 指派虛擬成員。
選取 ,然後新增。
將成員從所有角色中移除
當該使用者或群組不再有權限存取該項目中的資料時,請將該使用者或群組從所有 OneLake 安全角色中移除。
在角色中的所有成員索引標籤中,選擇你想要移除的使用者或群組。
選擇「從項目類型移除」(例如「從鏡像目錄移除」),即可撤銷該成員在所有 OneLake 安全角色中的資料存取權。
管理數據
使用 「角色中的所有資料」 標籤來檢視該項目中的所有資料,並了解哪些角色授權存取這些資料。
依資料檢視存取權限
打開你想查看存取權限的項目。
從項目選單中選擇 「管理 OneLake 安全 」。
選擇 「角色中的所有資料」 標籤。
該頁面列出項目中的表格、授權存取每個表格的角色,以及有權限的成員人數。
選擇一個表格以查看適用於該表格的角色與權限。
檢視能進入該表格的成員。