本頁面是指 檢視區塊的
required_access_grants參數。
required_access_grants也可以是探索的一部分,詳情請參閱required_access_grants(適用於探索) 參數說明文件頁面。
required_access_grants也可以是加入的一部分,詳情請參閱required_access_grants(適用於加入) 參數說明文件頁面。
required_access_grants也可以是維度、維度群組、指標、篩選器或參數的一部分,詳情請參閱required_access_grants(適用於欄位) 參數說明文件頁面。
用量
view: view_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
|
階層
required_access_grants |
預設值
無
接受
方括號,內含以半形逗號分隔的存取授權名稱清單
|
定義
required_access_grants 會與模型層級的 access_grant 參數配對,限制只有獲派特定使用者屬性值的使用者,才能存取檢視畫面。
required_access_grants 的運作方式如下:
- 您可以使用
access_grant參數定義存取權授權。在定義過程中,您會將存取權授予與使用者屬性建立關聯。您也可以指定哪些使用者屬性值可授予存取權。 - 接著,您可以使用
required_access_grants,將檢視畫面限制為僅供有權存取所列所有存取授權的使用者存取。
舉例來說,下列 LookML 會要求使用者同時擁有 can_view_financial_data 和 view_payroll 存取權,才能查看 payroll 檢視畫面:
view: payroll {
...
required_access_grants: [can_view_financial_data, view_payroll]
}
如果使用者無法存取檢視畫面中所有存取權授權,就無法在受限檢視畫面中看到任何欄位。探索時,他們不會在欄位挑選器中看到這些欄位。如果使用者查看的 Look 包含受限檢視區塊的欄位,系統會顯示警告訊息:「<view.field> 已不存在於 <view>,或您沒有存取權,因此系統會忽略這個欄位。」資訊主頁動態磚會隱藏警告訊息。
如要進一步瞭解如何定義存取權授權,請參閱 access_grant 參數說明文件頁面。
範例
只向有權存取 accounting 存取權授權的使用者公開 payroll 維度:
view: payroll {
...
required_access_grants: [accounting]
}
其他事項
在已儲存的 Look 和資訊主頁中,查看含有計算欄位的受限檢視畫面
由於無法存取受限檢視畫面的使用者無法存取檢視畫面中的欄位,這可能會導致已儲存的 Look 或資訊主頁圖塊中顯示的資料發生變化。
舉例來說,如果指標使用的維度來自受限檢視區塊,則無法存取該檢視區塊的資料,因此指標匯總時不會納入該資料。因此,無法存取受限制檢視畫面的使用者,會看到與可存取受限制檢視畫面的使用者不同的結果。
如果表格計算是根據受限檢視畫面中的欄位進行,則沒有受限檢視畫面存取權的使用者會看到錯誤訊息,因為表格計算無法存取受限檢視畫面中的欄位。
限制存取基礎 LookML 結構
限制檢視畫面的存取權,不會限制基礎 LookML 結構的存取權。因此,如果其他檢視畫面不受限制,不受限制的欄位仍可供使用。在欄位層級使用 required_access_grants 參數,個別限制欄位。