required_access_grants (für Datenansichten)

Diese Seite bezieht sich auf den required_access_grants Parameter, der Teil einer Ansicht ist.

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

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 Dimension, Dimensionsgruppe, eines Messwerts, Filters oder Parameters sein. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter required_access_grants (für Felder) .

Nutzung

view: view_name {
  required_access_grants: [access_grant_name, access_grant_name, ...]
}
Hierarchie
view
required_access_grants
Standardwert
Keine

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

Definition

required_access_grants wird mit dem Parameter access_grant auf Modellebene kombiniert, um den Zugriff auf eine Ansicht auf Nutzer zu beschränken, denen ein bestimmter Benutzerattributwert zugewiesen ist.

So funktioniert required_access_grants:

  1. Sie definieren ein Zugriffsrecht mit dem access_grant Parameter. Im Rahmen der Definition verknüpfen Sie das Zugriffsrecht mit einem Benutzerattribut. Sie geben auch an, welche Benutzerattributwerte Zugriff auf das Zugriffsrecht gewähren.
  2. Als Nächstes verwenden Sie required_access_grants, um eine Ansicht auf Nutzer zu beschränken, die Zugriff auf alle aufgeführten Zugriffsrechte haben.

Im folgenden LookML-Code müssen Nutzer beispielsweise Zugriff auf die Zugriffsrechte can_view_financial_data und view_payroll haben, um die Ansicht payroll zu sehen:

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

Nutzer, die keinen Zugriff auf alle Zugriffsrechte haben, die der Ansicht zugewiesen sind, sehen keine der Felder in der eingeschränkten Ansicht. Diese Felder werden im Field Picker nicht angezeigt, wenn sie Daten untersuchen. Wenn der Nutzer einen Look aufruft, der Felder aus der eingeschränkten Ansicht enthält, wird eine Warnmeldung angezeigt: "<view.field> ist in <view> nicht mehr vorhanden oder Sie haben keinen Zugriff darauf. Das Feld wird ignoriert." Die Warnmeldung wird auf Dashboard-Tiles unterdrückt.

Weitere Informationen zum Definieren eines Zugriffsrechts finden Sie auf der access_grant Dokumentationsseite.

Beispiel

Die Dimension payroll soll nur für Nutzer verfügbar sein, die Zugriff auf das Zugriffsrecht accounting haben:

view: payroll {
  ...
  required_access_grants: [accounting]
}

Weitere Überlegungen

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

Da Nutzer, die keinen Zugriff auf eine eingeschränkte Ansicht haben, nicht auf die Felder in der Ansicht zugreifen können, kann dies zu Änderungen bei den angezeigten Daten in einem gespeicherten Look oder Dashboard-Tile führen.

Ein Messwert, der eine Dimension aus einer eingeschränkten Ansicht verwendet, hat beispielsweise keinen Zugriff auf die Daten aus dieser Ansicht. Die Aggregation des Messwerts erfolgt daher ohne diese Daten. Nutzer, die keinen Zugriff auf die eingeschränkte Ansicht haben, sehen daher andere Ergebnisse als Nutzer, die Zugriff auf die eingeschränkte Ansicht haben.

Tabellenberechnungen, die auf einem Feld in einer eingeschränkten Ansicht basieren, wird für Nutzer, die keinen Zugriff auf die eingeschränkte Ansicht haben, ein Fehler angezeigt, da die Tabellenberechnung keinen Zugriff auf das Feld in der eingeschränkten Ansicht hat.

Zugriff auf zugrunde liegende LookML-Strukturen einschränken

Wenn Sie den Zugriff auf eine Ansicht einschränken, wird der Zugriff auf die zugrunde liegenden LookML-Strukturen nicht eingeschränkt. Ein uneingeschränktes Feld, das Teil anderer Ansichten ist, ist also weiterhin verfügbar, wenn diese Ansichten uneingeschränkt sind. Verwenden Sie den required_access_grants Parameter auf Feldebene, um Felder einzeln einzuschränken.