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.20 o versioni successive per le connessioni BigQuery oppure Looker 26.8 o versioni successive per le connessioni Snowflake.
- Disporre di una connessione a un database BigQuery o Snowflake 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 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, apri la pagina Connessioni di Looker, fai clic sul pulsante Modifica per la connessione, fai clic per aprire la scheda Impostazioni facoltative e poi verifica che l'opzione Abilita PDT sia attiva.
- Per le connessioni Snowflake, un amministratore del database deve concedere
CREATE STAGEal ruolo Looker. Per maggiori dettagli, consulta la pagina di documentazione per la creazione di una connessione Looker a Snowflake.
- 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 nella tua istanza.
Tieni presenti le seguenti limitazioni per il caricamento dei dati da Fogli Google:
- Le istanze di Looker (Google Cloud core) che utilizzano Private Service Connect non supportano il flusso OAuth per i caricamenti di Fogli Google. Queste istanze devono utilizzare il flusso URL manuale per caricare i dati da Fogli Google.
- Le istanze di Looker (Google Cloud core) che utilizzano Controlli di servizio VPC non supportano i caricamenti di Fogli Google.
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 predefinita, seleziona la connessione BigQuery o Snowflake da utilizzare per archiviare i dati per le esplorazioni self-service. Looker salverà i dati in questo database per le esplorazioni self-service nella tua istanza.
- Fai clic sul pulsante Test accanto all'opzione Caricamenti di dati per verificare che la connessione predefinita sia valida e che sia abilitata per le tabelle derivate permanenti (PDT) (consulta la sezione Prima di iniziare per i requisiti di connessione). Se il test non va a buon fine, non puoi abilitare i caricamenti di dati. Vai alla pagina di amministrazione Connessioni per risolvere i problemi relativi alla connessione.
- Se il test va a buon fine, attiva l'opzione Caricamenti di dati per abilitare la funzionalità Esplorazioni self-service.
- Se vuoi che la tua istanza di Looker supporti il caricamento dei dati da Fogli Google:
- Verifica di aver configurato una connessione BigQuery per le esplorazioni self-service (i caricamenti di Fogli Google sono supportati solo nelle connessioni BigQuery).
- Utilizza la Google Cloud console per abilitare le API richieste per supportare i caricamenti di Fogli Google.
- Facoltativamente, abilita OAuth per i caricamenti di Fogli Google se vuoi consentire agli utenti di utilizzare la navigazione di Google Drive per selezionare un file di Fogli Google per il caricamento dei dati.
- Fai clic sul pulsante Test accanto all'opzione Importazione dati di Fogli Google per eseguire un test specifico per i caricamenti di Fogli Google.
- Attiva l'opzione Importazione dati di Fogli Google. (Per caricare i dati da Fogli Google, devono essere attivate sia l'opzione Caricamenti di dati sia l'opzione Importazione dati di Fogli Google.)
Abilitare le API per supportare i caricamenti di Fogli Google
Per consentire a Looker di supportare il caricamento dei dati da Fogli Google per le connessioni BigQuery, 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 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 potrebbe essere lo stesso o meno del Google Cloud progetto specificato nel menu a discesa Connessione 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 consentire a BigQuery di 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 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 la console Apri selettore di progetti, 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.
Configurazione per le istanze Private Service Connect
Se la tua istanza di Looker (Google Cloud core) utilizza Private Service Connect (PSC), devi eseguire un passaggio aggiuntivo per supportare i caricamenti di Fogli Google.
Per consentire a Looker di raggiungere l'API Google Sheets, devi pubblicare Fogli Google come servizio utilizzando Private Service Connect e poi aggiungere Fogli Google all'impostazione FQDN locale nella configurazione di Looker (Google Cloud core). Quando configuri l'FQDN locale, utilizza sheets.googleapis.com nel campo FQDN locale e l'URI del collegamento al servizio del servizio pubblicato nel campo URI del collegamento al servizio di destinazione. Per istruzioni, consulta la documentazione Connettersi ai servizi pubblicati utilizzando l'FQDN locale.
Abilitare OAuth per i caricamenti di Fogli Google
Dopo aver abilitato le esplorazioni self-service, abilitato le API per supportare i caricamenti di Fogli Google e abilitato l'opzione Importazione dati 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 nella tua istanza di Looker, un utente IAM con i ruoli richiesti deve creare un client OAuth nellaconsole e poi inserire le credenziali OAuth nella pagina di amministrazione Esplorazioni self-service nella tua istanza di Looker, come descritto nella procedura in questa sezione. Google Cloud
Per creare il client OAuth e inserire le credenziali nella tua istanza di Looker:
Nellaconsole, utilizza ilselettore di progetto per selezionare ilprogetto associato al account di servizio utilizzato per caricare i dati (il account di servizio utilizzato per i processi PDT nella connessione BigQuery). Google Cloud Google Cloud Google Cloud
Utilizza il menu principale dellaconsole per andare ad API e servizi > Credenziali. Google Cloud
Nella pagina Credenziali , fai clic sul menu a discesa Crea credenziali e poi 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 che la Google Cloud console ha creato per il client OAuth. Copia e annota questi valori.
Nella tua 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.
Fai clic sul pulsante Test accanto all'opzione Importazione dati di Fogli Google per testare la configurazione OAuth oltre alla configurazione di caricamento di Fogli Google. Puoi anche fare clic sul pulsante Test accanto all'opzione Caricamenti di dati per verificare la connessione oltre alla configurazione di Fogli Google.
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.