このページでは、ディメンション、ディメンショングループ、メジャー、フィルタ、パラメータの一部である
required_access_grantsパラメータについて説明します。
required_access_grantsは Explore の一部にすることもできます。これについては、required_access_grants（Explore 用）パラメータのドキュメント ページをご覧ください。
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 では、salary ディメンションを表示するには、can_view_financial_data と view_payroll の両方のアクセス権が必要です。
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 やダッシュボード タイルで表示されるデータが変更される可能性があります。
たとえば、制限付きディメンションを使用するクエリは、制限付きディメンションのデータにアクセスできないため、そのデータなしで指標の集計が行われます。そのため、制限付きディメンションにアクセスできないユーザーには、制限付きディメンションにアクセスできるユーザーとは異なる結果がメジャーに表示されます。
制限付きフィールドに基づく表計算は、制限付きフィールドにアクセスできないユーザーに対してエラーを表示します。これは、表計算が制限付きフィールドにアクセスできないためです。