本頁面是指屬於維度、維度群組、指標、篩選器或參數的
required_access_grants參數。
required_access_grants也可以是「探索」的一部分,詳情請參閱required_access_grants(適用於「探索」) 參數說明文件頁面。
required_access_grants也可以是加入的一部分,詳情請參閱required_access_grants(適用於加入) 參數說明文件頁面。
required_access_grants也可以是檢視表的一部分,詳情請參閱required_access_grants(適用於檢視區塊) 參數說明文件頁面。
用量
view: view_name {
dimension: field_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 存取權,才能查看 salary 維度:
dimension: salary {
...
required_access_grants: [can_view_financial_data, view_payroll]
}
如果使用者沒有存取權,就無法存取該欄位。探索資料時,他們不會在欄位選擇器中看到該欄位。如果使用者查看包含受限欄位的 Look,系統會顯示警告訊息:「<view.field>已不存在於<view>,或您沒有存取權,因此系統會忽略這個欄位。」資訊主頁動態磚會隱藏警告訊息。
如要進一步瞭解如何定義存取權授予,請參閱 access_grant 說明文件頁面。
範例
只向有權存取 payroll access_grant 的使用者公開 salary 維度:
dimension: salary {
type: number
required_access_grants: [payroll]
}
其他事項
在已儲存的 Look 和資訊主頁中,查看含有計算欄位的受限檢視畫面
由於使用者無法存取受限欄位,因此如果儲存的 Look 或資訊主頁圖塊包含這類欄位,使用者看到的資料可能會有所不同。
舉例來說,如果查詢使用受限維度,就無法存取該維度中的資料,因此系統會排除該資料來匯總指標。因此,無法存取受限維度的使用者,在指標中看到的結果會與可存取受限維度的使用者不同。
如果使用者無法存取受限欄位,則表格計算會顯示錯誤,因為表格計算無法存取受限欄位。