required_access_grants (für Felder)

Auf dieser Seite wird auf den Parameter required_access_grants verwiesen, der Teil einer Dimension, Dimensionsgruppe, Messwert, Filter oder Parameter ist.

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

required_access_grants kann auch Teil eines Joins sein. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter required_access_grants (für Joins).

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

Nutzung

view: view_name {
  dimension: field_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}
Hierarchie
view
Feldtyp
required_access_grants
Mögliche Feldtypen
Dimension, Dimensionsgruppe, Messwert, Filter, Parameter

Akzeptiert
Eckige Klammern mit einer durch Kommas getrennten Liste von Namen für Zugriffsberechtigungen

Definition

required_access_grants wird mit dem Parameter access_grant auf Modellebene kombiniert, um den Zugriff auf ein Feld auf Nutzer mit einem bestimmten Benutzerattribut-Wert zu beschränken.

So funktioniert required_access_grants:

  1. Sie definieren eine Zugriffsberechtigung mit dem Parameter access_grant. Im Rahmen der Definition verknüpfen Sie die Zugriffsgewährung mit einem Nutzerattribut. Sie geben auch an, mit welchen Benutzerattributwerten Zugriff auf das Zugriffsrecht gewährt wird.
  2. Als Nächstes verwenden Sie required_access_grants, um das Feld auf die Nutzer zu beschränken, die Zugriff auf alle aufgeführten Zugriffsrechte haben.

Für die folgende LookML ist beispielsweise erforderlich, dass Nutzer Zugriff auf die Zugriffsgewährungen can_view_financial_data und view_payroll haben, um die Dimension salary zu sehen:

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

Nutzer, die nicht auf alle dem Feld zugewiesenen Zugriffsberechtigungen zugreifen können, haben keinen Zugriff auf das Feld. Sie sehen das Feld bei der explorativen Datenanalyse nicht in der Feldauswahl. Wenn Nutzer einen Look aufrufen, der das eingeschränkte Feld enthält, wird eine Warnmeldung angezeigt: „<view.field> no longer exists on <view>, or you don't have access to it, and it will be ignored.“ (<view.field> ist nicht mehr in <view> vorhanden oder Sie haben keinen Zugriff darauf. Das Feld wird ignoriert.) Die Warnmeldung wird auf Dashboard-Kacheln unterdrückt.

Weitere Informationen zum Definieren einer Zugriffsgewährung finden Sie auf der Dokumentationsseite access_grant.

Beispiel

Die Dimension salary ist nur für Nutzer verfügbar, die Zugriff auf das payroll-Zugriffsrecht haben:

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

Weitere Überlegungen

Eingeschränkte Ansichten mit berechneten Feldern in gespeicherten Looks und Dashboards ansehen

Da Nutzer ohne Zugriff auf ein eingeschränktes Feld nicht darauf zugreifen können, kann dies zu Änderungen bei den angezeigten Daten in einem gespeicherten Look oder einer Dashboardkachel führen.

Bei einer Abfrage, in der eine eingeschränkte Dimension verwendet wird, kann beispielsweise nicht auf die Daten in der eingeschränkten Dimension zugegriffen werden. Die Messwertaggregation erfolgt also ohne diese Daten. Nutzer, die keinen Zugriff auf die eingeschränkte Dimension haben, sehen daher andere Ergebnisse für den Messwert als Nutzer, die Zugriff auf die eingeschränkte Dimension haben.

Tabellenkalkulationen, die auf einem eingeschränkten Feld basieren, zeigen einen Fehler für Nutzer an, die keinen Zugriff auf das eingeschränkte Feld haben, da die Tabellenkalkulation nicht auf das eingeschränkte Feld zugreifen kann.