required_access_grants (조인용)

이 페이지에서는 join에 포함된 required_access_grants 매개변수를 참조합니다.

required_access_grants은 Explore의 일부일 수도 있습니다(required_access_grants(Explore용) 매개변수 문서 페이지 참고).

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, ...]
  }
}
계층 구조
explore
join
required_access_grants
기본값
없음

수락
액세스 권한 부여 이름의 쉼표로 구분된 목록이 포함된 대괄호

정의

required_access_grants는 모델 수준 access_grant 매개변수와 함께 특정 사용자 속성 값이 할당된 사용자로만 조인에 대한 액세스를 제한합니다.

required_access_grants는 다음과 같이 작동합니다.

  1. access_grant 파라미터를 사용하여 액세스 권한 부여를 정의합니다. 정의의 일부로 액세스 권한 부여를 사용자 속성과 연결합니다. 액세스 권한 부여에 대한 액세스 권한을 제공하는 사용자 속성 값도 지정합니다.
  2. 그런 다음 required_access_grants를 사용하여 나열된 모든 액세스 권한 부여에 액세스할 수 있는 사용자로만 조인을 제한합니다.

이 LookML에서는 사용자가 payroll 조인을 보려면 can_view_financial_data 및 view_payroll 액세스 권한을 모두 보유해야 합니다.

join: payroll {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

조인에 할당된 액세스 권한 부여를 모두 사용할 수 없는 사용자는 제한된 조인을 통해 Explore에 추가된 필드를 볼 수 없습니다. 탐색 중에 필드 선택 도구에 해당 필드가 표시되지 않습니다. 사용자가 액세스 권한이 없는 필드가 포함된 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 매개변수를 사용하여 이러한 항목을 개별적으로 제한합니다.