Con la funzionalità Esplorazioni self-service, gli utenti di Looker possono caricare file CSV, XLS e XLSX in Looker e 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 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.
- Dispone di una connessione a un database BigQuery (per informazioni sulla configurazione di una connessione BigQuery nell'istanza di Looker, consulta la pagina della documentazione Google BigQuery) e 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 di Ambito del 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 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.
Attivare 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 Amministrazione di Looker, seleziona la pagina di amministrazione Self-service Explores.
- Nella pagina di amministrazione Esplorazioni self-service, seleziona la connessione BigQuery da utilizzare per archiviare i dati per le esplorazioni self-service dal menu a discesa Connessione BigQuery predefinita. Looker salverà i dati in questo database BigQuery per le esplorazioni self-service nella tua istanza.
- Fai clic sul pulsante Verifica connessione per verificare che la connessione BigQuery sia valida e che abbia abilitato le tabelle derivate permanenti in modo da 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 attivare i caricamenti di dati. Puoi andare alla pagina di amministrazione Connessioni per visualizzare maggiori dettagli sulla connessione e per testarla ulteriormente e capire dove si verifica l'errore.
- Fai clic sul pulsante Abilita caricamenti di dati.
- Se vuoi che la tua istanza di Looker supporti il caricamento dei dati da Fogli Google, devi anche utilizzare la console Google Cloud per abilitare le API richieste. Consulta la sezione Abilitare le API per supportare i caricamenti di Fogli Google in questa pagina.
Abilitazione delle API per supportare i caricamenti di Fogli Google
Per supportare il caricamento dei dati da Fogli Google, le seguenti API devono essere abilitate nella console Google Cloud da un utente IAM con l'autorizzazione IAM roles/serviceusage.serviceUsageAdmin:
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: necessaria 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 potrebbe non essere lo stesso del Google Cloud progetto specificato nel menu a discesa Connessione BigQuery predefinita della pagina di amministrazione Esplorazioni self-service):
- API BigQuery: necessaria per tutte le operazioni BigQuery
- API Google Sheets: necessaria per recuperare i nomi di ogni foglio in un documento Google Sheets
- API Google Drive: necessaria per consentire a BigQuery di leggere i file da Drive
Per abilitare le API, segui questi passaggi:
Nella console Google Cloud Apri selettore progetti, 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 console Google Cloud , 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, dalla console Google Cloud , seleziona il Google Cloud progetto associato all'account di servizio utilizzato per caricare i dati (l'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 console, Google Cloud 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 console, Google Cloud 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 su Fogli Google
Dopo aver attivato 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 Google Sheets per i caricamenti di dati.
Per attivare la navigazione di Google Drive nell'istanza di Looker, un utente IAM con i ruoli richiesti deve creare un client OAuth nella console Google Cloud e poi inserire le credenziali OAuth nella pagina di amministrazione Self-service Explores dell'istanza di Looker, come descritto nella procedura in questa sezione.
Per creare il client OAuth e inserire le credenziali nell'istanza di Looker:
Nella console Google Cloud , utilizza lo strumento di selezione del progetto della console Google Cloud per selezionare il progetto Google Cloud associato al account di servizio utilizzato per caricare i dati (il account di servizio utilizzato per i processi PDT nella connessione BigQuery).
Utilizza il menu principale della console Google Cloud per andare a API e servizi > Credenziali.
Nella pagina Credenziali, fai clic sul menu a discesa Crea credenziali e 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 la finestra Client OAuth creato. Questa finestra mostra l'ID client e il client secret che la console Google Cloud ha creato per il tuo client OAuth. Copia e annota questi valori.
Nella tua istanza di Looker, seleziona Self-service Explores nella sezione Generale del pannello Amministrazione.
Nella pagina Esplorazioni self-service, nei campi ID client e Client secret, incolla i valori che hai copiato dalla console Google Cloud quando hai creato il client OAuth nella console Google Cloud .
Fai clic su Salva.
Ora, quando gli utenti caricano dati utilizzando l'opzione Importa dal cloud, Looker mostra la navigazione di Google Drive per selezionare i documenti Fogli Google.
Visualizzare i caricamenti di dati nell'istanza di Looker
Se le esplorazioni self-service sono attivate 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 nella tua 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 ciò potrebbe rendere il menu Esplora macchinoso.
Rimozione di un caricamento di dati
Il proprietario di un caricamento di dati può rimuoverlo dalla pagina Modifica esplorazione self-service. Inoltre, un amministratore di Looker può rimuovere un caricamento di dati dalla pagina di amministrazione Self-service Explores seguendo questi passaggi:
- Nella sezione Generale del menu Amministrazione di Looker, seleziona la pagina di amministrazione Self-service Explores.
- 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.