required_access_grants (per i campi)

Questa pagina si riferisce al parametro required_access_grants, che fa parte di una dimensione, di un gruppo di dimensioni, di una misura, di un filtro o di un parametro.

required_access_grants può anche far parte di un'esplorazione, come descritto nella pagina della documentazione dedicata al parametro required_access_grants (per le esplorazioni).

required_access_grants può anche far parte di un'unione, come descritto nella pagina della documentazione relativa al parametro required_access_grants (per le unioni).

required_access_grants può anche far parte di una vista, come descritto nella pagina della documentazione dedicata al parametro required_access_grants (per le viste).

Utilizzo

view: view_name {
  dimension: field_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}

Gerarchia Visualizza file view Tipo di campo required_access_grants

Tipi di campi possibili Dimensione, gruppo di dimensioni, misura, filtro, parametro Accetta Parentesi quadre contenenti un elenco separato da virgole di nomi di concessioni di accesso

Definizione

required_access_grants si accoppia al parametro access_grant a livello di modello per limitare l'accesso a un campo solo agli utenti a cui è stato assegnato un valore specifico dell'attributo utente.

required_access_grants funziona così:

1. Definisci una concessione di accesso utilizzando il parametro access_grant. Nell'ambito della definizione, associ la concessione dell'accesso a un attributo utente. Specifichi anche quali valori degli attributi utente forniscono l'accesso alla concessione di accesso.
2. Successivamente, utilizzi required_access_grants per limitare il campo solo agli utenti che hanno accesso a ogni concessione di accesso elencata.

Ad esempio, il seguente codice LookML richiede che gli utenti dispongano dell'accesso sia a can_view_financial_data sia a view_payroll per visualizzare la dimensione salary:

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

Gli utenti che non hanno accesso a tutte le concessioni di accesso assegnate al campo non avranno accesso al campo. Non vedranno il campo nel selettore dei campi durante l'esplorazione. Se gli utenti visualizzano un Look che include il campo con limitazioni, vedranno un messaggio di avviso che dice: "<view.field> non esiste più su <view> o non hai accesso e verrà ignorato". Il messaggio di avviso viene eliminato dai riquadri della dashboard.

Per saperne di più su come definire una concessione di accesso, consulta la pagina della documentazione access_grant.

Esempio

Mostra la dimensione salary solo agli utenti che hanno accesso alla concessione di accesso payroll:

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

Ulteriori considerazioni

Visualizzazione di viste con restrizioni con campi calcolati in Look e dashboard salvati

Poiché gli utenti che non hanno accesso a un campo con limitazioni non possono accedere a quel campo, ciò può causare modifiche ai dati visualizzati in un Look salvato o in un riquadro della dashboard.

Ad esempio, una query che utilizza una dimensione con limitazioni non avrà accesso ai dati nella dimensione con limitazioni, quindi l'aggregazione della misura avviene senza questi dati. Di conseguenza, gli utenti che non hanno accesso alla dimensione con limitazioni vedranno risultati diversi nella metrica rispetto agli utenti che hanno accesso alla dimensione con limitazioni.

I calcoli tabellari basati su un campo con limitazioni mostrano un errore per gli utenti che non hanno accesso al campo con limitazioni, poiché il calcolo tabellare non ha accesso al campo con limitazioni.