required_access_grants (für Joins)

Auf dieser Seite wird auf den Parameter required_access_grants verwiesen, der Teil eines join 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 einer Ansicht sein, wie auf der Dokumentationsseite zum Parameter required_access_grants (für Ansichten) beschrieben.

required_access_grants kann auch Teil einer Dimension, Dimensionsgruppe, eines Messwerts, Filters oder Parameters sein, wie auf der Dokumentationsseite zum Parameter required_access_grants beschrieben.

Nutzung

explore: explore_name {
  join: view_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}
Hierarchie
explore
join
required_access_grants
Standardwert
Keine

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 einen Join auf Nutzer zu beschränken, denen ein bestimmter Benutzerattributwert zugewiesen wurde.

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 einen Join auf Nutzer zu beschränken, die Zugriff auf alle aufgeführten Zugriffsrechte haben.

Für diesen LookML-Code müssen Nutzer Zugriff auf die Zugriffsgewährungen can_view_financial_data und view_payroll haben, um den Join payroll zu sehen:

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

Nutzer, die nicht auf alle Zugriffsrechte zugreifen können, die dem Join zugewiesen sind, sehen keine der Felder, die einem Explore über den eingeschränkten Join hinzugefügt wurden. Sie sehen diese Felder nicht im Field Picker, wenn sie Daten analysieren. Wenn Nutzer einen Look aufrufen, der Felder enthält, auf die sie keinen Zugriff haben, wird die Warnmeldung „<view.field> ist nicht mehr in <view> vorhanden oder Sie haben keinen Zugriff darauf. Das Feld wird ignoriert.“ angezeigt. Die Warnmeldung wird auf Dashboard-Kacheln unterdrückt.

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

Beispiel

Stellen Sie den payroll-Join nur für Nutzer bereit, die Zugriff auf das Zugriffsrecht pr_dept haben:

explore: financial {
  join: payroll {
    ...
    required_access_grants: [pr_dept]
  }
}

Weitere Überlegungen

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

Da Nutzer ohne Zugriff auf einen eingeschränkten Join die durch den Join hinzugefügten Felder nicht sehen können, können sich die Daten ändern, die sie in einem gespeicherten Look oder einer Dashboardkachel sehen.

Bei einem Messwert, für den eine Dimension aus einem eingeschränkten Join verwendet wird, kann beispielsweise nicht auf die Daten für diese Dimension zugegriffen werden. Die Messwertaggregation erfolgt also ohne diese Daten. Nutzer ohne Zugriff auf den eingeschränkten Join sehen daher andere Daten für die Messung als Nutzer mit Zugriff.

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

Zugriff auf zugrunde liegende LookML-Strukturen einschränken

Wenn Sie den Zugriff auf einen Join einschränken, wird der Zugriff auf die zugrunde liegenden LookML-Strukturen nicht eingeschränkt. Eine uneingeschränkte Ansicht oder ein uneingeschränktes Feld, das Teil anderer Joins ist, ist weiterhin verfügbar, wenn diese Joins uneingeschränkt sind. Verwenden Sie den Parameter required_access_grants auf Ansichts- oder Feldebene, um diese Elemente einzeln einzuschränken.