filtro_accesso

Utilizzo

Explore: Explore_name {
access_filter: {
field: full_Scope_field
user_attribute: user_attribute_name
}
}
Gerarchia
access_filter
Valore predefinito
Nessuna

Accetta
Un nome di campo LookML e l'attributo utente associato

Regole speciali
Puoi applicare più parametri access_filter alla stessa esplorazione

Definizione

access_filter consente di applicare restrizioni specifiche per i dati. Per funzionare correttamente, a differenza della maggior parte dei parametri LookML, deve essere utilizzato in combinazione con altre impostazioni di Looker. Un parametro access_filter è specifico per un singolo Explore, quindi devi assicurarti di applicare un parametro access_filter a ogni Explore che richiede una limitazione.

Non dimenticare di aggiungere access_filter a tutte le esplorazioni che ne hanno bisogno. Se dimentichi di aggiungere access_filter a un'esplorazione che dovrebbe averlo, i dati non saranno limitati e gli utenti potranno visualizzare tutti i dati al suo interno.

Il comportamento di access_filter sarebbe simile a quello di un utente con la necessità di applicare uno o più filtri nell'interfaccia utente di Esplora prima di eseguire qualsiasi query. Ad esempio, l'utente potrebbe trattare solo un sottoinsieme dei tuoi clienti, per cui gli richiederesti di applicare un filtro per nome del cliente.

Esistono diversi passaggi da seguire per implementare un filtro di accesso:

  1. Decidi quali campi devono essere limitati. Nell'esempio precedente, gli utenti potrebbero eseguire un'esplorazione del cliente con una dimensione denominata Nome. Il modo in cui viene fatto riferimento a questo campo è customer.name.
  2. Ogni utente che interagirà con l'Explore in questione deve assegnare un valore al filtro di accesso. Nel nostro esempio, ogni utente dovrà avere l'elenco dei nomi dei clienti che può visualizzare. Puoi applicare questi valori a ciascun utente o gruppo di utenti utilizzando la funzionalità degli attributi utente di Looker, disponibile nella pagina della documentazione User attributes (Attributi utente). Supponiamo di creare un attributo utente allowed_customers.
  3. Infine, collega l'attributo utente creato al campo in cui utilizzare il relativo valore come filtro. Nel nostro esempio, vogliamo collegare l'attributo utente allowed_customers al campo customer.name, nel seguente modo:
explore: customer {
  access_filter: {
    field: customer.name
    user_attribute: allowed_customers
  }
}

Esempi

Limita gli utenti a visualizzare le informazioni sull'area geografica di vendita:

explore: customer {
  access_filter: {
    field: sales.region
    user_attribute: sales_region
  }
}

Limitare gli utenti alla visualizzazione di informazioni su reparti specifici all'interno dei propri clienti:

explore: customer {
  access_filter: {
    field: customer.name
    user_attribute: allowed_customers
  }
  access_filter: {
    field: product.department
    user_attribute: allowed_departments
  }
}

Sfide comuni

access_filter richiede nomi di campo con ambito completo

Se scrivi un nome di campo senza nome visualizzazione, la maggior parte dei parametri in Looker presumerà un nome vista in base alla posizione in cui viene utilizzato il parametro. Tuttavia, access_filter non funziona in questo modo e richiede la scrittura sia del nome della visualizzazione che del nome del campo.

Ad esempio, potresti pensare che tutto questo funzioni e che name venga interpretato come il nome del cliente:

explore: customer {
  access_filter: {
    field: name
    user_attribute: allowed_customers
  }
}

Tuttavia, non è così e riceverai un errore. Devi scrivere:

explore: customer {
  access_filter: {
    field: customer.name
    user_attribute: allowed_customers
  }
}

Anche gli amministratori devono aver impostato i valori del filtro nell'interfaccia utente

Ogni utente che accede a un Explore che utilizza access_filter deve avere un valore nell'attributo utente di riferimento. Questo vale anche per chi ha il ruolo di amministratore, nonostante possa vedere tutti i dati. Gli utenti che non hanno impostato un valore per l'attributo utente riceveranno un errore quando tenteranno di visualizzare Esplora.

  • Per concedere a un amministratore o a un altro utente l'accesso a tutti i valori di un campo stringa, imposta il tipo di dati degli attributi utente su Filtro stringa (avanzato) e utilizza il valore %, NULL.

  • Per concedere a un amministratore o a un altro utente l'accesso a tutti i valori di un campo numerico, imposta il tipo di dati degli attributi utente su Filtro numero (avanzato) e utilizza un valore <0, >=0, NULL.