本頁面是指
join的required_access_grants參數。
required_access_grants也可以是「探索」的一部分，詳情請參閱required_access_grants(適用於「探索」) 參數說明文件頁面。
required_access_grants也可以是檢視表的一部分，詳情請參閱required_access_grants(適用於檢視區塊) 參數說明文件頁面。
required_access_grants也可以是維度、維度群組、指標、篩選器或參數的一部分，詳情請參閱required_access_grants參數說明文件頁面。
用量
explore: explore_name {
join: 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 聯結：
join: payroll {
...
required_access_grants: [can_view_financial_data, view_payroll]
}
如果使用者沒有加入的所有存取權，就無法查看透過受限加入項目新增至探索的任何欄位。探索時，他們不會在欄位挑選器中看到這些欄位。如果使用者查看的 Look 包含他們無法存取的欄位，系統會顯示警告訊息：「<view.field>已不存在於 <view>，或您沒有存取權，因此系統會忽略這個欄位。」資訊主頁動態磚會隱藏警告訊息。
如要進一步瞭解如何定義存取權授權，請參閱 access_grant 參數說明文件頁面。
範例
只向有權存取 pr_dept 存取權授權的使用者公開 payroll 聯播網：
explore: financial {
join: payroll {
...
required_access_grants: [pr_dept]
}
}
其他事項
在已儲存的 Look 和資訊主頁上，查看含有計算欄位的受限聯結
由於無法存取受限聯結的使用者無法查看聯結新增的欄位，這可能會改變他們在已儲存 Look 或資訊主頁動態磚中看到的資料。
舉例來說，如果評估指標使用的維度來自受限的聯結，該評估指標就無法存取該維度的資料，因此評估指標匯總時不會納入該資料。因此，無法存取受限聯播的使用者，與可存取受限聯播的使用者相比，看到的指標資料會有所不同。
如果表格計算是根據受限制的聯結中的欄位進行，則無法存取受限制聯結的使用者會看到錯誤訊息，因為表格計算無法存取受限制聯結中的欄位。
限制存取基礎 LookML 結構
限制聯結的存取權不會限制基礎 LookML 結構的存取權。如果其他聯結不受限制，不受限制的檢視畫面或欄位仍可使用。在檢視或欄位層級使用 required_access_grants 參數，個別限制這些項目。