Con la funzionalità Esplorazioni self-service, gli utenti di Looker possono caricare file CSV, XLS e XLSX in Looker, quindi eseguire query e visualizzare i dati in un'esplorazione di Looker senza dover configurare un modello LookML o impostare il controllo della versione Git.
Gli amministratori di Looker possono selezionare l'opzione Esplorazioni self-service dal menu Admin (Amministrazione) di Looker per configurare la funzionalità Esplorazioni self-service e visualizzare i caricamenti di dati sull'istanza.
Prima di iniziare
Per utilizzare le esplorazioni self-service, l'istanza di Looker deve soddisfare i seguenti requisiti:
- Eseguire Looker 25.18 o versioni successive.
- Disporre di una connessione a un database BigQuery (per informazioni sulla configurazione di una connessione BigQuery nell'istanza di Looker, consulta la pagina Google BigQuery della documentazione). La connessione deve essere configurata nei seguenti modi:
- La connessione deve essere configurata con l'ambito Tutti i progetti. Per verificare l'ambito della connessione, consulta la colonna Ambito nella scheda Database della pagina Connessioni nel menu di amministrazione di Looker. Il valore Ambito progetto della connessione non può essere modificato dopo la creazione della connessione.
- La connessione deve essere abilitata per le tabelle derivate permanenti (PDT). Per verificare che le PDT siano abilitate nella connessione BigQuery, apri la pagina Connessioni di Looker, fai clic sul pulsante Modifica per la connessione BigQuery, fai clic per aprire la scheda Impostazioni facoltative e poi verifica che l'opzione Abilita PDT sia attivata.
- Per qualsiasi utente che creerà esplorazioni self-service, l'account utente Looker deve disporre dell'autorizzazione
upload_data, che consente a un utente di caricare file CSV nell'istanza.
Abilitare le esplorazioni self-service
Prima che gli utenti possano creare esplorazioni self-service, un amministratore di Looker deve configurare la funzionalità eseguendo i seguenti passaggi:
- Nella sezione Generale del menu Admin (Amministrazione) di Looker, seleziona la pagina di amministrazione Esplorazioni self-service.
- Nella pagina di amministrazione Esplorazioni self-service, dal menu a discesa Connessione BigQuery predefinita, seleziona la connessione BigQuery da utilizzare per archiviare i dati per le esplorazioni self-service. Looker salverà i dati in questo database BigQuery per le esplorazioni self-service nell'istanza.
- Fai clic sul pulsante Testa connessione per verificare che la connessione BigQuery sia valida e che le PDT siano abilitate in modo che possa supportare i caricamenti di dati. (Per informazioni sui requisiti per le connessioni per supportare i caricamenti di dati, consulta la sezione Prima di iniziare.) Se il test non va a buon fine, non potrai abilitare i caricamenti di dati. Puoi andare alla pagina di amministrazione**Connessioni** per visualizzare maggiori dettagli sulla connessione e per testarla ulteriormente per vedere dove non funziona.
- Fai clic sul pulsante Abilita caricamenti di dati.
- Se vuoi che l'istanza di Looker supporti il caricamento dei dati da Fogli Google, devi anche utilizzare la Google Cloud console per abilitare le API richieste. Consulta la sezione Abilitare le API per supportare i caricamenti di Fogli Google in questa pagina.
Abilitare le API per supportare i caricamenti di Fogli Google
Per supportare il caricamento dei dati da Fogli Google, un utente IAM con l'autorizzazione IAM roles/serviceusage.serviceUsageAdmin deve abilitare le seguenti API nella Google Cloud console:
Questa API deve essere abilitata nel Google Cloud progetto che ospita la connessione BigQuery specificata nel menu a discesa Connessione BigQuery predefinita della pagina di amministrazione Esplorazioni self-service:
- API BigQuery: obbligatoria per tutte le operazioni BigQuery
Queste API devono essere abilitate nel Google Cloud progetto associato al account di servizio utilizzato per caricare i dati (il account di servizio utilizzato per i processi PDT nella connessione BigQuery, che può essere o meno lo stesso del Google Cloud progetto specificato nel menu a discesa Connessione BigQuery predefinita della pagina di amministrazione Esplorazioni self-service):
- API BigQuery: obbligatoria per tutte le operazioni BigQuery
- API Google Sheets: obbligatoria per recuperare i nomi di ogni foglio in un documento di Fogli Google
- API Google Drive: obbligatoria per BigQuery per leggere i file da Drive
Per abilitare le API:
Dalla Google Cloud console, seleziona il progetto che ospita la connessione BigQuery specificata nel menu a discesa Connessione BigQuery predefinita della pagina di amministrazione Esplorazioni self-service.
Nel menu di navigazione della Google Cloud console, vai ad API e servizi > Libreria e apri l'API BigQuery.
Nella pagina dell'API BigQuery, se l'API non è già abilitata, fai clic su Abilita.
Sempre nella pagina dell'API BigQuery, dal Google Cloud console Apri selezione progetto, seleziona il Google Cloud progetto associato al account di servizio utilizzato per caricare i dati (il account di servizio utilizzato per i processi PDT nella connessione BigQuery).
Nella pagina dell'API BigQuery, se l'API non è già abilitata, fai clic su Abilita.
Nel menu di navigazione della Google Cloud console, vai ad API e servizi > Libreria e apri l'API Google Sheets.
Nella pagina dell'API Google Sheets, se l'API non è già abilitata, fai clic su Abilita.
Nel menu di navigazione della Google Cloud console, vai ad API e servizi > Libreria e apri l'API Google Drive.
Nella pagina dell'API Google Drive, se l'API non è già abilitata, fai clic su Abilita.
Abilitare OAuth per i caricamenti di Fogli Google
Dopo aver abilitato le esplorazioni self-service e abilitato le API per supportare i caricamenti di Fogli Google, puoi anche consentire agli utenti di utilizzare la navigazione di Google Drive per selezionare i documenti di Fogli Google per i caricamenti di dati.
Per abilitare la navigazione di Google Drive nell'istanza di Looker, un utente IAM con i ruoli richiesti deve creare un client OAuth nella Google Cloud console, quindi inserire le credenziali OAuth nella pagina di amministrazione Esplorazioni self-service nell'istanza di Looker, come descritto nella procedura in questa sezione.
Per creare il client OAuth e inserire le credenziali nell'istanza di Looker:
Nella Google Cloud console, utilizza il Google Cloud selettore di progetti per selezionare il Google Cloud progetto associato al account di servizio utilizzato per caricare i dati (il account di servizio utilizzato per iprocessi PDT nella connessione BigQuery).
Utilizza il Google Cloud menu principale della console per andare ad API e servizi > Credenziali.
Nella pagina Credenziali, fai clic sul menu a discesa Crea credenziali, quindi seleziona ID client OAuth.
Nel menu a discesa Tipo di applicazione, seleziona Applicazione web.
Nel campo Nome, inserisci un nome per il client OAuth, ad esempio
Looker upload data from Sheets.Nella sezione Origini JavaScript autorizzate, fai clic sul pulsante Aggiungi URI. Inserisci l'URL dell'istanza di Looker:
https://LOOKER_INSTANCE_URLFai clic su Crea.
Dopo aver fatto clic su Crea, viene visualizzata una finestra Client OAuth creato. Questa finestra mostra l'ID client e il client secret creati dalla Google Cloud console per il client OAuth. Copia e annota questi valori.
Nell'istanza di Looker, seleziona Esplorazioni self-service dalla sezione Generale del riquadro Admin (Amministrazione).
Nella pagina Esplorazioni self-service, nei campi ID client e Client secret, incolla i valori che hai copiato dalla Google Cloud console quando hai creato il client OAuth nella Google Cloud console.
Fai clic su Salva.
Ora, quando gli utenti caricano i dati utilizzando l'opzione Importa dal cloud, Looker visualizza la navigazione di Google Drive per la selezione dei documenti di Fogli Google.
Visualizzare i caricamenti di dati nell'istanza di Looker
Se le esplorazioni self-service sono abilitate nell'istanza, un amministratore di Looker può utilizzare la tabella Caricamenti di dati nella pagina di amministrazione Esplorazioni self-service per visualizzare i dati caricati dagli utenti nell'istanza.
La tabella Caricamenti di dati mostra le seguenti informazioni sui caricamenti di dati nell'istanza:
- Il nome dell'esplorazione self-service, che è anche un collegamento ipertestuale che apre l'esplorazione self-service
- Il proprietario del caricamento dei dati
- La data di caricamento dei dati
- Un pulsante Elimina che consente agli amministratori di Looker di eliminare il caricamento del file e l'esplorazione self-service associata
Gli amministratori di Looker possono aprire qualsiasi esplorazione self-service nell'istanza utilizzando i link nella tabella Caricamenti di dati. Tuttavia, la sezione Esplorazioni self-service del menu Esplora di Looker elenca solo le esplorazioni self-service di tua proprietà o che il proprietario ha condiviso specificamente con te. Il menu Esplora non elenca tutte le esplorazioni self-service nell'istanza per gli amministratori di Looker, in quanto potrebbe rendere il menu Esplora ingombrante.
Rimuovere un caricamento di dati
Il proprietario di un caricamento di dati può rimuovere il caricamento dalla pagina Modifica esplorazione self-service. Inoltre, un amministratore di Looker può rimuovere un caricamento di dati dalla pagina di amministrazione Esplorazioni self-service seguendo questi passaggi:
- Nella sezione Generale del menu Admin (Amministrazione) di Looker, seleziona la pagina di amministrazione Esplorazioni self-service.
- Nella tabella Caricamenti di dati, fai clic sul pulsante Elimina per il caricamento di dati che vuoi rimuovere.
- Fai clic su Elimina nella finestra di dialogo di conferma.