Erforderliche Zugriffsrechte

Diese Seite bezieht sich auf den Parameter required_access_grants, der zu einer Dimension, Dimensionsgruppe, Messung, Filter oder Parameter gehört.

required_access_grants kann auch Teil eines explorativen Analysetools sein, der auf der Dokumentationsseite für den Parameter required_access_grants (für explorative Datenanalysen) beschrieben wird.

required_access_grants kann auch Teil eines Joins sein, wie auf der Dokumentationsseite zum Parameter required_access_grants (für Joins) beschrieben.

required_access_grants kann auch Teil einer Ansicht sein, die auf der Dokumentationsseite für den Parameter required_access_grants (für Ansichten) beschrieben wird.

Nutzung

view: view_name {
Dimension: Feldname {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}
Hierarchie
view
Feldtyp
required_access_grants
Mögliche Feldtypen
Dimension, Dimensionsgruppe, messen, filtern, Parameter

Akzeptiert
Eckige Klammern mit einer durch Kommas getrennten Liste von Zugriffsgewährungsnamen

Definition

required_access_grants kombiniert den Parameter access_grant auf Modellebene, um den Zugriff auf ein Feld auf Nutzer zu beschränken, denen ein bestimmter Nutzerattributwert zugewiesen ist.

required_access_grants funktioniert so:

  1. Mit dem Parameter access_grant definieren Sie eine Zugriffsberechtigung. Im Rahmen der Definition ordnen Sie die Zugriffsberechtigung einem Nutzerattribut zu. Außerdem geben Sie an, welche Nutzerattributwerte Zugriff auf die Zugriffsberechtigung gewähren.
  2. Verwenden Sie als Nächstes required_access_grants, um das Feld auf die Nutzer zu beschränken, die Zugriff auf alle aufgeführten Zugriffsrechte haben.

Für das folgende LookML müssen Nutzer beispielsweise sowohl Zugriff auf can_view_financial_data als auch auf view_payroll haben, um die Dimension salary sehen zu können:

dimension: salary {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Nutzer, die keinen Zugriff auf alle Zugriffsberechtigungen haben, die dem Feld zugewiesen sind, haben keinen Zugriff auf das Feld. Das Feld wird in der Feldauswahl nicht angezeigt. Wenn Nutzer einen Look aufrufen, der das eingeschränkte Feld enthält, wird die Warnmeldung „<view.field> ist auf <view> nicht mehr vorhanden oder Sie haben keinen Zugriff darauf“ angezeigt und sie wird ignoriert. Die Warnmeldung wird auf Dashboard-Kacheln unterdrückt.

Weitere Informationen zum Definieren einer Zugriffsberechtigung finden Sie auf der Dokumentationsseite zu access_grant.

Beispiel

Machen Sie die Dimension salary nur Nutzern zugänglich, die Zugriff auf payroll haben:

dimension: salary {
  type: number
  required_access_grants: [payroll]
}

Weitere Überlegungen

Eingeschränkte Ansichten mit berechneten Feldern für gespeicherte Looks und Dashboards ansehen

Da Nutzer ohne Zugriff auf ein eingeschränktes Feld nicht auf dieses Feld zugreifen können, kann es zu Änderungen bei den angezeigten Daten in einer gespeicherten Look- oder Dashboard-Kachel kommen.

Bei einer Messung mit einer eingeschränkten Dimension kann beispielsweise nicht auf die Daten der eingeschränkten Dimension zugegriffen werden. Die Aggregation der Messwerte erfolgt also ohne diese Daten. Daher sehen Nutzer, die keinen Zugriff auf die eingeschränkte Dimension haben, andere Ergebnisse im Messwert als Nutzer, die keinen Zugriff auf die eingeschränkte Dimension haben.

Tabellenberechnungen, die auf einem eingeschränkten Feld basieren, erhalten eine Fehlermeldung für Nutzer, die keinen Zugriff auf das eingeschränkte Feld haben, da die Tabellenberechnung keinen Zugriff auf das eingeschränkte Feld hat.