Questa pagina offre una panoramica delle modalità di distribuzione di visualizzazioni dati ed esplorazioni alle destinazioni native di Looker e a tutti i servizi integrati disponibili per la tua istanza di Looker. Per informazioni sulla pubblicazione delle dashboard precedenti, consulta la pagina della documentazione Pubblicazione delle dashboard precedenti. Per informazioni sulla pianificazione delle dashboard, consulta la pagina Documentazione di Pianificazione e invio delle dashboard.
Lo scheduler di Looker è il nome della finestra popup in cui puoi configurare le impostazioni per la distribuzione dei contenuti. Per le visualizzazioni dati, puoi utilizzare lo scheduler per inviare distribuzioni una tantum o ricorrenti. Le esplorazioni possono essere inviate solo come distribuzioni una tantum. Per pianificare una distribuzione ricorrente di contenuti delle esplorazioni, devi prima salvarli come visualizzazioni dati.
Se sei uno sviluppatore di Looker, devi disattivare la Development Mode (Modalità di sviluppo) per attivare queste opzioni di pianificazione.
Le opzioni di distribuzione a tua disposizione dipendono dalle autorizzazioni correlate a te assegnate dall'amministratore di Looker.
Aprire lo scheduler da una cartella
Per le esplorazioni, puoi aprire lo scheduler solo da Esplora, non da una cartella.
Per aprire lo scheduler da una cartella o sottocartella, trova la cartella o la sottocartella contenente la dashboard che vuoi distribuire. Quando passi a una cartella, tutte le visualizzazioni dati e le dashboard contenute al suo interno vengono elencati nella visualizzazione elenco o nella visualizzazione griglia.
Se l'amministratore ha abilitato la funzionalità di navigazione avanzata Labs, per accedere alle cartelle, espandi l'elenco delle cartelle nella sezione Cartelle del nuovo pannello di navigazione avanzata sulla sinistra.
L'icona del calendario indica che hai pianificato almeno una distribuzione ricorrente per quel contenuto (nella visualizzazione griglia, devi passare il mouse sopra la miniatura del contenuto per vedere l'icona del calendario, se presente):
Nella visualizzazione elenco, puoi aprire lo scheduler in uno dei seguenti modi:
- Fai clic sull'icona del calendario di un elemento, se presente
- Fai clic sul menu con tre puntini di un elemento e scegli Modifica pianificazione (se è già presente una pianificazione per l'elemento), Aggiungi pianificazione (se non esiste ancora una pianificazione per l'elemento) o Invia (per creare una consegna una tantum).
- Apri il contenuto, fai clic sul menu a forma di ingranaggio in alto a destra e scegli Programma (per le distribuzioni ricorrenti) o Invia (per le distribuzioni una tantum)
Nella visualizzazione griglia, puoi aprire lo scheduler in uno dei seguenti modi:
- Fai clic sull'icona del calendario di un elemento, se presente
- Apri il contenuto, fai clic sul menu a forma di ingranaggio in alto a destra e scegli Programma (per le distribuzioni ricorrenti) o Invia (per le distribuzioni una tantum)
Creazione di una pubblicazione
Poiché le esplorazioni possono essere inviate solo come distribuzioni una tantum, il menu a forma di ingranaggio di una esplorazione non contiene l'opzione Pianificazione.
Per creare una distribuzione dall'interno dei contenuti di Looker, apri lo scheduler legacy facendo clic sul menu a forma di ingranaggio nella parte superiore destra dei contenuti e scegliendo Schedule (Pianifica) per le distribuzioni ricorrenti o Send (Invia) per le distribuzioni una tantum.
Looker visualizza lo scheduler legacy, un popup con le tue scelte di pianificazione, simile a questo, che mostra l'invio pianificato di una dashboard legacy a un'email in formato PDF:
Lo scheduler legacy per la distribuzione di un Look potrebbe avere il seguente aspetto:
Per le distribuzioni ricorrenti, il riquadro a sinistra dello scheduler legacy mostra tutte le pianificazioni create per i contenuti ed evidenzia il titolo della pianificazione che stai creando o modificando. Il riquadro a sinistra elenca le pianificazioni in ordine cronologico inverso dall'ultimo aggiornamento. Per duplicare o eliminare le pianificazioni esistenti, puoi fare clic rispettivamente sull'icona Duplica o Elimina a destra della pianificazione.
Se si tratta della prima pianificazione che crei per questi contenuti, nel riquadro principale vengono visualizzate le opzioni di pianificazione impostate sui loro valori predefiniti. Puoi modificare questi valori in base alle tue esigenze. Se hai già creato una o più pianificazioni per questi contenuti, nel riquadro principale vengono visualizzate le impostazioni di pianificazione salvate per la pianificazione all'inizio dell'elenco. Quindi:
- Per modificare le opzioni di una programmazione esistente, seleziona la pianificazione e modificale come preferisci. Al termine, fai clic su Salva tutto.
- Per creare pianificazioni aggiuntive per gli stessi contenuti, fai clic su Nuovo + e inserisci le impostazioni per quella pianificazione aggiuntiva.
Al termine, fai clic su Salva tutto.
Le sezioni seguenti spiegano ciascuna impostazione di pianificazione.
Assegna un nome alla distribuzione
Assegna alla pianificazione un titolo univoco nel campo Assegna un nome alla pianificazione. Il titolo verrà visualizzato nel riquadro sulla sinistra dopo che avrai salvato la pianificazione, nell'elenco delle pianificazioni che hai creato e nelle pagine di gestione della pianificazione nel riquadro Amministrazione.
A seconda della destinazione della distribuzione, il titolo potrebbe comparire anche in altri posti:
- Per le distribuzioni via email, il titolo viene utilizzato nella riga dell'oggetto e, se selezioni un formato che utilizza un allegato, come parte del nome file.
- Per i webhook, il titolo viene incluso nel payload, sotto il campo Titolo.
- Per le distribuzioni a bucket Amazon S3, il titolo viene utilizzato nel nome del file della distribuzione e nelle eventuali email di errore inviate. Il nome file della pubblicazione segue il formato
TITLE_TIMESTAMP_HASH, doveHASHè un identificatore casuale di sei caratteri eTIMESTAMPsegue il patternYYYY-MM-DDTHHMM(ad esempio, la parte del timestamp sarà2019-05-31T0933per il 31 maggio 2019 alle 9:33). - Per le distribuzioni a servizi integrati che generano un file allegato, il titolo viene incluso nel nome del file della distribuzione.
Per le distribuzioni via SFTP, il titolo viene incluso nel nome del file della distribuzione. Il nome file della pubblicazione segue il formato
TITLE_TIMESTAMP_TOKEN, doveTOKENè un identificatore casuale di sei caratteri eTIMESTAMPsegue il patternYYYY-MM-DDTHHMM(ad esempio, la parte del timestamp sarà2019-05-31T0933per il 31 maggio 2019 alle 9:33).Per le distribuzioni via SFTP, nel nome del file sono supportati solo i caratteri alfanumerici, i trattini bassi (_) e i trattini (-). Looker elimina tutti i caratteri diversi da
A-Z,a-z,0-9,_o-da quello che hai inserito nel campo Assegna un nome alla pianificazione.
Scelta della destinazione di consegna
A seconda di come l'amministratore di Looker ha configurato le tue autorizzazioni, tutte le destinazioni potrebbero non essere visibili.
L'impostazione Where do this data go? (Dove devono essere inviati questi dati?) potrebbe visualizzare diverse destinazioni come opzioni di distribuzione dei dati. Ogni destinazione offre diverse opzioni di distribuzione.
Le destinazioni includono:
- Webhook
- Bucket Amazon S3
- SFTP
- Qualsiasi servizio integrato abilitato dall'amministratore di Looker per la tua istanza. Puoi visualizzare un elenco dei servizi disponibili per la distribuzione di Look ed esplorazioni nella sezione Opzioni di distribuzione per le integrazioni di terze parti di questa pagina.
Dopo aver selezionato una destinazione per i dati, viene visualizzato un nuovo campo delle impostazioni in cui puoi aggiungere dettagli specifici sulla destinazione, ad esempio un indirizzo email o l'URL di un webhook.
Opzioni di consegna per l'email
Scegli Email nella sezione Where do this data go? (Dove devono essere inviati questi dati?). I contenuti verranno distribuiti a un elenco di indirizzi email specificati da te.
Nella sezione A chi deve essere inviata l'email, inserisci gli indirizzi email dei destinatari. Inserisci un singolo indirizzo email o più indirizzi separati da virgole e fai clic su Add (Aggiungi).
A seconda delle impostazioni per l'istanza di Looker e delle autorizzazioni che ti sono state assegnate, potresti essere in grado di inviare email a indirizzi non associati ad alcun account utente nell'istanza di Looker. Queste email sono classificate come esterne. Per inviare contenuti a utenti esterni, è necessario che l'amministratore di Looker ti abbia concesso le autorizzazioni per inviare i contenuti a utenti esterni o che tu abbia aggiunto i domini email di tali destinatari alla richiesta di aggiunta del dominio email per i contenuti pianificati.
Se un destinatario è un altro utente Looker, vedrà l'opzione per collegare la dashboard all'email, a meno che l'amministratore di Looker non abbia impostato il criterio relativo ai dati email dell'istanza di Looker su Send Data Only (Invia solo dati) oppure l'opzione Include Links (Includi link) sia deselezionata.
Se tutti i destinatari annullano l'iscrizione a una distribuzione via email pianificata, la pianificazione viene eliminata da Looker e dalle pagine di gestione della pianificazione per utenti e amministratori. Se un destinatario annulla l'iscrizione per conto di un gruppo email, nessun membro di quel gruppo riceverà distribuzioni via email pianificate.
Per ulteriori informazioni sulle distribuzioni via email, consulta la sezione Applicare opzioni di recapito avanzate in questa pagina.
Seleziona Includi un messaggio personalizzato per aggiungere un messaggio personalizzato nel corpo dell'email. Looker limita il numero di caratteri a un messaggio personalizzato a 1500.
Le email inviate non possono superare i 20 MB (per i formati pubblicati nel corpo dell'email) e i 15 MB (per i formati inviati come allegato).
Opzioni di distribuzione per i webhook
I webhook sono un metodo sempre più utilizzato per attivare scambi tra servizi basati su Internet. Con un servizio web come Zapier, i webhook possono consentire la distribuzione dei dati di Looker a un'ampia gamma di applicazioni; ad esempio, puoi pianificare la distribuzione periodica di una visualizzazione dati o di una dashboard a un webhook. Quando configuri una distribuzione, Looker ti chiede di fornire l'indirizzo del webhook.
Nella sezione Where do this data go? (Dove devono essere inviati questi dati?), scegli Webhook. Nella sezione Webhook URL (URL webhook), inserisci l'URL a cui Looker deve inviare una richiesta HTTPS per la distribuzione. Puoi ottenere l'URL dal servizio web che usi per gestire il webhook. Per configurare un webhook, accedi al servizio web e segui questi passaggi:
- Ottieni un URL a cui Looker deve inviare una richiesta HTTPS.
- Specifica un'applicazione di destinazione per la distribuzione dei dati di Looker. L'applicazione di destinazione potrebbe richiedere una configurazione aggiuntiva per ricevere dati da Looker.
La procedura esatta varia a seconda del servizio web e dell'applicazione di destinazione che utilizzi per distribuire la dashboard. Per le linee guida sulla configurazione di un'altra applicazione per la ricezione dei dati del webhook da Looker, consulta questo post della community di Looker sulla pianificazione di Look e dashboard tramite webhook (versione 3.46 e successive).
Looker tenterà di consegnare a un webhook per un massimo di 30 minuti. Assicurati che la destinazione possa rispondere entro 30 minuti al tentativo di distribuzione del webhook.
Opzioni di distribuzione per i bucket Amazon S3
I bucket Amazon S3 vengono comunemente utilizzati per archiviare grandi quantità di dati. Tu o la tua azienda dovete creare un bucket S3 con Amazon prima che Looker possa utilizzarlo.
Se scegli l'opzione di destinazione Amazon S3, Looker ti chiede di configurare impostazioni aggiuntive sulla formattazione e sul bucket Amazon S3, come descritto in questa pagina. Per ulteriori dettagli sulla distribuzione dei dati utilizzando un bucket Amazon S3, consulta questo post della community di Looker sulla pianificazione dei risultati (illimitati) a S3.
Nella sezione Where do this data go? (Dove devono essere inviati questi dati?), scegli Amazon S3. Viene visualizzata la sezione S3 Details (Dettagli S3) e ti vengono richieste le informazioni sul bucket Amazon S3:
- Bucket: il nome del tuo bucket Amazon S3.
- Optional Path (Percorso facoltativo): la cartella in cui vuoi salvare i dati, se disponibile.
- Access Key (Chiave di accesso): l'ID della chiave di accesso del tuo bucket S3, fornita da Amazon.
- Chiave segreta: la chiave di accesso segreta al bucket S3, fornita da Amazon.
- Area geografica: l'area geografica dei servizi Amazon in cui è ospitato il bucket S3.
Opzioni di distribuzione per i server SFTP
Scegli SFTP nella sezione Where should this data go? (Dove devono essere inviati questi dati?) per inviare la tua dashboard a un server SFTP. Inviare i risultati a un server SFTP è una buona soluzione quando le dimensioni dei dati o della visualizzazione sono eccessive per l'invio via email. Se scegli questa opzione di distribuzione, Looker ti chiede l'indirizzo del server SFTP, il tuo nome utente e la password, come descritto di seguito.
Tieni presente quanto segue sulle consegne SFTP:
- Per ricevere pubblicazioni SFTP da Looker, assicurati che l'amministratore di rete abbia aggiunto indirizzi IP di Looker alla lista consentita IP o alle regole del traffico in entrata del tuo server SFTP.
- Quando esegui la distribuzione a un server SFTP, nel nome del file sono supportati solo i caratteri alfanumerici, i trattini bassi (_) e i trattini (-). Looker elimina tutti i caratteri diversi da
A-Z,a-z,0-9,_o-da quello che hai inserito nel campo Assegna un nome alla pianificazione.
Quando scegli SFTP, Looker ti chiede l'URL e le informazioni di accesso al server:
Indirizzo: l'URL o l'indirizzo IP del server SFTP a cui vuoi inviare i dati. Ad esempio:
sftp://files.looker.com/Marketing/In/
osftp://192.168.0.10/Marketing/In/Questo URL di esempio termina con il carattere
/. Ciò indica che il file verrà salvato in una cartella denominataIn. Se non aggiungi/, il file verrà salvato nella cartellaMarketinge verrà anteposto "In" al nome del file. Devi disporre dell'accesso in scrittura alla cartella in cui vuoi creare il file.Nome utente e Password: le credenziali di accesso al server SFTP.
Algoritmo di scambio di chiavi preferito: questo campo è facoltativo. Per configurarlo, scegli l'algoritmo di scambio di chiavi SSH preferito per stabilire la connessione. Le opzioni supportate sono le seguenti:
diffie-hellman-group-exchange-sha1diffie-hellman-group1-sha1diffie-hellman-group14-sha1diffie-hellman-group-exchange-sha256
Se la connessione non viene stabilita entro cinque minuti, scegli un algoritmo diverso. Alcuni algoritmi richiedono molto tempo per generare una chiave SSH. Questa opzione ti consente di utilizzare un algoritmo che potrebbe richiedere meno tempo. La scelta di uno degli algoritmi lo rende l'algoritmo preferito per stabilire la connessione SSH. Se l'algoritmo non è supportato dal server, tutti gli altri algoritmi vengono utilizzati nei tentativi successivi. Se questo campo viene impostato su Predefinito, viene utilizzato l'ordine originale degli algoritmi nella libreria di connessione.
Attualmente, le credenziali supportate per SFTP sono nome utente e password. Le credenziali della chiave privata SSH non sono supportate.
Gli algoritmi delle chiavi host supportati dalle distribuzioni SFTP di Looker sono:
ssh-rsassh-dssssh-rsa-cert-v01@openssh.comssh-rsa-cert-v00@openssh.com
Looker archivia le impronte SFTP del tuo server SFTP. Se riscontri errori nella distribuzione via SFTP, è possibile che le impronte SFTP non siano valide. In questo caso, contatta l'amministratore di Looker.
Se ricevi l'errore
Java::JavaLang::NullPointerExceptionsdurante la distribuzione dei dati a un server SFTP, la causa potrebbe essere un bug in JRuby che impedisce l'utilizzo di algoritmi di curva ellittica (EC) e/o chiavi host per le connessioni SSH da Looker a destinazioni SFTP. Per evitare problemi con l'invio dei dati alle destinazioni SFTP, non utilizzare algoritmi EC nei file~/.ssh/configo/etc/ssh_confige non archiviare le chiavi host EC in~/.sshsul tuo host Looker.
Looker carica il file sulla directory specificata sul tuo server SFTP, utilizzando la seguente convenzione per il nome del file:
<name>_<timestamp>_<token>.<file extension>
- Il nome fornito nel campo Assegna un nome alla pianificazione dopo che Looker ha rimosso tutti i caratteri diversi da
A-Z,a-z,0-9,_o- - Il timestamp inviato per la programmazione nel formato
%Y-%m-%dT%H%M - Un token composto da una stringa casuale di sei caratteri
- L'estensione del file
Ad esempio: Test_Schedule_2019-04-11T1130_HWkvys.csv
Opzioni di distribuzione per le integrazioni di terze parti
Lo scheduler mostra tutte le azioni che sono state attivate dall'amministratore di Looker. A seconda dal servizio, potrebbero essere presenti campi aggiuntivi specifici della destinazione. Questi campi forniscono al servizio integrato le informazioni aggiuntive necessarie per eseguire l'azione selezionata sui tuoi dati. Scopri di più sulla distribuzione dei dati da integrazioni nella sezione Invio della dashboard o dei dati delle query della pagina della documentazione Condivisione di dati tramite un hub azioni.
Per visualizzare una descrizione delle informazioni richieste da ogni servizio, trova la destinazione del servizio in uno degli elenchi riportati di seguito e vai all'URL mostrato nella colonna Come utilizzare questa destinazione.
Il seguente elenco mostra tutti i servizi integrati che ti consentono di fornire un look o i risultati di un'esplorazione:
Scegliere il formato dei dati
Per le consegne via email, l'opzione per selezionare il formato dei dati non è disponibile se l'amministratore di Looker ha impostato i criteri relativi ai dati email dell'istanza di Looker su Send Link Only (Invia solo link).
I Look e le esplorazioni presentano opzioni di formattazione diverse a seconda della destinazione della distribuzione. Per scegliere il formato per la distribuzione, seleziona l'icona appropriata nella sezione Formatta i dati come dello scheduler.
Consulta la tabella di seguito per una spiegazione di come ogni formato viene pubblicato in ciascuna destinazione.
| Formatta | Webhook | Amazon S3 | SFTP | |
|---|---|---|---|---|
| Tabella | La tabella di dati nel corpo dell'email in formato HTML | Non disponibile per questa destinazione | Non disponibile per questa destinazione | Non disponibile per questa destinazione |
| Visualizzazione | La visualizzazione nel corpo dell'email come immagine PNG. | Non disponibile per questa destinazione | Non disponibile per questa destinazione | Non disponibile per questa destinazione |
| CSV | La tabella di dati come file di testo separato da virgole | La tabella di dati come file di testo separato da virgole | La tabella di dati come file di testo separato da virgole | La tabella di dati come file di testo separato da virgole |
| XLSX | La tabella di dati come file Excel allegato | La tabella di dati come file Excel allegato | La tabella di dati come file Excel allegato | La tabella di dati come file Excel allegato |
| JSON: semplice | La tabella di dati come file JSON allegato. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | La tabella di dati come file JSON allegato. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | La tabella di dati come file JSON allegato. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | La tabella di dati come file JSON allegato. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. |
| JSON: etichetta | Non disponibile per questa destinazione | La tabella dati in formato JSON. In questo formato, Looker utilizza i campi labels come valore visualizzato nell'output JSON. | Non disponibile per questa destinazione | Non disponibile per questa destinazione |
| JSON: semplice, incorporato | Non disponibile per questa destinazione | La tabella di dati inviata direttamente in formato JSON. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | Non disponibile per questa destinazione | Non disponibile per questa destinazione |
| JSON: dettagliato, in linea | Non disponibile per questa destinazione | La tabella di dati inviata direttamente in formato JSON, con ulteriori dettagli come i metadati dei campi, le informazioni sulla cache, l'ora in cui è stata completata la query e il tempo necessario per l'esecuzione della query. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | La tabella di dati inviata direttamente in formato JSON, con ulteriori dettagli come i metadati dei campi, le informazioni sulla cache, l'ora in cui è stata completata la query e il tempo necessario per l'esecuzione della query. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. | La tabella di dati inviata direttamente in formato JSON, con ulteriori dettagli come i metadati dei campi, le informazioni sulla cache, l'ora in cui è stata completata la query e il tempo necessario per l'esecuzione della query. In questo formato, Looker utilizza il nome del campo di una dimensione o di una misura come valore visualizzato anziché l'etichetta del campo. |
| Testo | La tabella di dati come allegato file di testo delimitato da tabulazioni | La tabella di dati come allegato file di testo delimitato da tabulazioni | La tabella di dati come allegato file di testo delimitato da tabulazioni | La tabella di dati come allegato file di testo delimitato da tabulazioni |
| HTML | La tabella di dati come allegato file HTML | La tabella di dati come allegato file HTML | La tabella di dati come allegato file HTML | La tabella di dati come allegato file HTML |
Attivazione della pubblicazione
Questa opzione non viene visualizzata se invii un'esplorazione o una consegna una tantum di un Look.
Quando pianifichi le distribuzioni ricorrenti, hai due opzioni per attivarle:
- Intervallo di ripetizione: seleziona questa opzione per utilizzare la pianificazione di consegna impostata nella sezione Specificare la ricorrenza di pubblicazione di questa pagina.
- Aggiornamento del gruppo di dati: se lo sviluppatore LookML ha configurato i gruppi di dati, puoi pianificare la pubblicazione in modo che avvenga dopo l'attivazione di un gruppo di dati, la gestione della cache e la ricreazione delle PDT pertinenti.
Specificare il trigger del gruppo di dati
Questa opzione non viene visualizzata se invii un'esplorazione, una distribuzione una tantum di un Look o se hai specificato un attivatore a intervalli ricorrente per la tua distribuzione ricorrente.
Per utilizzare un attivatore di gruppo di dati, seleziona Aggiornamento gruppo di dati nella sezione Trigger dello scheduler. Scegli il gruppo di dati di origine dal menu a discesa Seleziona gruppo di dati:
Per pianificare i contenuti utilizzando un attivatore gruppo di dati, il file del modello su cui si basano i contenuti deve includere un gruppo di dati. Looker elenca tutti i gruppi di dati definiti nei modelli inclusi nel riquadro Look o dashboard specificato, anche se i gruppi di dati non vengono utilizzati per gestire la memorizzazione nella cache per query o PDT.
Le pianificazioni basate sui gruppi di dati vengono attivate solo una volta completato il processo di rigenerazione per tutte le PDT persistenti con tale gruppo di dati, in modo che la pubblicazione includa i dati più aggiornati.
Specificare la ricorrenza di pubblicazione
Questa opzione non viene visualizzata se invii un'esplorazione, una distribuzione una tantum di un Look o se hai specificato un attivatore di aggiornamento del gruppo di dati per la distribuzione ricorrente.
Per le distribuzioni che utilizzano un intervallo ricorrente, puoi personalizzare le tempistiche nella sezione Consegna questo programma. Seleziona Ripetizione intervallo nella sezione Trigger dello scheduler. Le opzioni relative alle tempistiche variano a seconda che tu scelga Ogni giorno, Ogni settimana, Ogni mese, Ogni ora o Al minuto. Puoi modificare il fuso orario per la pianificazione nella sezione Opzioni avanzate.
L'ora di fine per gli intervalli Orario e Al minuto non è inclusa. L'ultima consegna verrà inviata all'ultimo intervallo selezionato prima dell'ora di fine specificata. Ad esempio, se i contenuti sono programmati Ogni ora dalle 00:00 alle 23:00, verranno inviati all'ora, ogni ora, dalle 12:00 alle 22:00. Se i contenuti sono programmati Per minuto ogni 30 minuti tra le 00:00 e le 13:00 e le 13:00
Applicare filtri alla pubblicazione
Se invii un'esplorazione, questa opzione non verrà visualizzata.
Se stai creando un Look o una dashboard con filtri, puoi modificare le condizioni del filtro per filtrare ulteriormente i risultati restituiti.
Fai clic su Filtri per visualizzare e modificare i filtri associati a questo Look o dashboard per la pubblicazione. La modifica di queste opzioni di filtro nello scheduler non comporta la modifica dei filtri nel Look o nella dashboard. Se un filtro della dashboard richiede un valore di filtro e il filtro di pianificazione è vuoto, una pianificazione non mostrerà risultati al momento della pubblicazione.
Se modifichi i nomi dei campi che fungono da filtri nei Look o nelle dashboard, assicurati di rivedere la sezione Filtri dei Look e delle dashboard pianificati e aggiorna i filtri in base alle modifiche apportate. Se una pubblicazione di contenuti pianificata include filtri che non funzionano più (ad esempio, se il campo di riferimento è cambiato), la pubblicazione pianificata potrebbe esporre dati non filtrati.
Per personalizzare ulteriormente le distribuzioni, puoi utilizzare l'opzione di filtro corrisponde a un attributo utente (se gli amministratori di Looker hanno configurato valori specifici dell'utente chiamati attributi utente). Se imposti un filtro su uno di questi attributi, i risultati vengono personalizzati automaticamente per ogni utente. In questo modo puoi inviare risultati personalizzati a molti utenti anche se invii una consegna una tantum. Per ulteriori informazioni, consulta la pagina della documentazione relativa agli attributi utente.
Applicazione di opzioni di consegna avanzate
La sezione Opzioni avanzate offre una personalizzazione aggiuntiva per la pubblicazione. Fai clic sulla freccia accanto a Opzioni avanzate per espandere il menu. Le opzioni disponibili dipendono dalla destinazione e dal formato della distribuzione selezionata e dal fatto che tu stia eseguendo una dashboard, una visualizzazione dati o un'esplorazione. I link nella tabella seguente rimandano a una descrizione di ciascuna opzione disponibile per la distribuzione di Look o esplorazioni alle destinazioni native di Looker. Per le pubblicazioni di integrazioni di terze parti potrebbero essere disponibili opzioni avanzate univoche.
Invia questa programmazione se
Per le distribuzioni ricorrenti di Look, puoi personalizzare la programmazione per inviare i contenuti di Look solo se vengono soddisfatte determinate condizioni. Gli avvisi hanno una funzione simile per i riquadri delle dashboard.
Nel menu a discesa Invia questa pianificazione se, specifica se vuoi distribuire i contenuti Look solo se ci sono risultati, solo se non ci sono risultati oppure se ci sono risultati o nessun risultato. Ad esempio, puoi utilizzare i filtri utente per creare condizioni per le situazioni che vuoi monitorare, come elementi che sono al di sotto di una determinata quantità di inventario, spese che superano un certo valore, e così via, quindi pubblicare i contenuti solo se tale condizione è stata raggiunta.
Puoi anche specificare una pubblicazione solo se i risultati della query sono cambiati dall'ultimo invio dei dati selezionando la casella accanto a e i risultati sono cambiati dall'ultima esecuzione. Questa opzione non è disponibile se vuoi utilizzare l'opzione limitata Tutti i risultati.
Limite
Puoi limitare le dimensioni di consegna selezionando una delle seguenti opzioni per i tuoi dati:
- Risultati nella tabella: i dati vengono inviati come singola consegna.
- All Results (Tutti i risultati): i dati vengono trasmessi in streaming (per saperne di più, vedi Quali sono tutti i limiti per le righe in Looker?) Best practice). Questo metodo è utile per i set di dati di grandi dimensioni, poiché consente di aggirare le limitazioni relative a dimensioni dei file, browser e memoria.
Se scegli Results in Table (Risultati nella tabella), Looker seguirà i limiti di righe che hai impostato nel look o nell'esplorazione salvato. Se scegli All Results (Tutti i risultati), Looker restituirà tutte le righe della query, indipendentemente dalle impostazioni Look salvate e indipendentemente dal limite di 5000 righe di Looker. Questo può essere utile per recuperare set di dati molto grandi, ma fai attenzione per assicurarti che la query non sia troppo grande per il database.
Limitare le opzioni per l'email
Quando invii Look ed esplorazioni, puoi limitare le dimensioni delle email affinché rientrino nei limiti previsti per le dimensioni del messaggio del server email. Seleziona una delle seguenti opzioni relative al limite per i tuoi dati:
- Risultati nella tabella: i dati vengono inviati con un limite di 5000 righe. Questa è l'unica scelta disponibile per le email che utilizzano le opzioni di formato Tabella dati o Visualizzazione. Le email con più di 5000 righe non verranno inviate.
- Tutti i risultati: se utilizzi le opzioni di formato Testo, CSV, JSON - Semplice, XLSX o HTML, puoi inviare tutte le righe dei risultati di un look salvato. Questa opzione ignora gli eventuali limiti impostati per un Look salvato o per il tipico limite di 5000 righe di Looker. Tuttavia, esiste un limite dati totale di 15 MB affinché le applicazioni email possano accettare l'allegato. Le email che superano i 15 MB con un allegato non verranno inviate. Se specifichi un formato Tabella di dati o Visualizzazione e poi selezioni Tutti i risultati, Looker modifica automaticamente il formato in modo da utilizzare un allegato di testo per supportare l'invio di tutti i risultati.
Per verificare di non superare il limite di righe o dati per le email pianificate, puoi inserire il tuo indirizzo email come destinatario e fare clic su Invia test per inviarti immediatamente i dati. Se non ricevi l'email, è probabile che tu abbia raggiunto il limite di righe o dati per le email.
Opzioni email
Le consegne via email hanno opzioni di consegna aggiuntive come descritto di seguito.
Esegui pianificazione come destinatario
Questa opzione è disponibile solo per la destinazione email.
L'opzione Esegui la pianificazione come destinatario consente agli amministratori di specificare un elenco di utenti che riceveranno la distribuzione di contenuti come se eseguissero la query, in base alle autorizzazioni. Gli utenti non amministratori possono inoltre inserire il proprio indirizzo email per ricevere una consegna, come se avessero eseguito query sui contenuti in base alle loro autorizzazioni. Ciò significa che i filtri di accesso e gli attributi utente di ogni utente verranno applicati ai dati inclusi in ogni email.
Ad esempio, supponiamo che un amministratore di Looker debba pianificare il seguente report per una serie di utenti e che ogni utente abbia valori di filtro di accesso diversi:
L'utente A ha un filtro di accesso impostato su users.state = 'California'. Quando è selezionata l'opzione Esegui la pianificazione come destinatario, la query pianificata applicherà il filtro di accesso users.state = 'California' e invierà i seguenti risultati filtrati all'utente A:
Questa opzione prende in considerazione le autorizzazioni dell'utente che crea la pianificazione e i tipi di indirizzi email aggiunti nel campo di testo A chi deve essere inviata l'email?.
In alcuni casi, l'opzione Esegui la pianificazione come destinatario non è disponibile:
- Quando un utente non amministrativo aggiunge un indirizzo email diverso dal proprio
- Quando un amministratore di Looker aggiunge l'email di un utente disattivato
- Quando un amministratore di Looker aggiunge un indirizzo email che non appartiene a un utente (un account Looker è indicato da un'icona Looker accanto al destinatario):
- L'opzione è stata disattivata automaticamente se l'indirizzo email è stato aggiunto prima che fosse selezionata l'opzione Esegui la pianificazione come destinatario. Sarà nuovamente disponibile se questo indirizzo email viene eliminato dall'elenco dei destinatari.
- Se l'indirizzo email è stato aggiunto dopo la selezione dell'opzione Esegui la pianificazione come destinatario, l'aggiunta dell'indirizzo email genererà un errore e l'email verrà rimossa automaticamente dal campo A chi deve essere inviata l'email?. L'opzione Esegui la pianificazione come destinatario rimarrà attiva.
Nel caso speciale in cui un utente è indicato come destinatario in una pianificazione per cui è attiva l'opzione Esegui la pianificazione come destinatario e il suo account è disattivato, la pianificazione non verrà inviata all'utente disattivato a partire dalla successiva esecuzione. Se l'account di quell'utente viene eliminato, l'intera pianificazione non verrà consegnata a nessuno dei destinatari. Un amministratore o un utente Looker con l'autorizzazione see_schedules sarà in grado di diagnosticare questo errore nella pagina Cronologia dello scheduler nel riquadro Amministratore.
Includi link
Se l'amministratore di Looker ha impostato il criterio per i dati email dell'istanza di Looker su Send Links and Data (Invia link e dati), lo scheduler mostrerà un'opzione Include Links (Includi link). Quando questa opzione è selezionata, i recapiti dei dati email includono un link a Looker con la dicitura "View full report" (Visualizza report completo) per Look and Explore (esplorazione) e "View full dashboard" (Visualizza dashboard completa) per le pubblicazioni.
Questo link consente ai destinatari dell'email di esplorare ulteriormente i dati sulla tua istanza di Looker. I destinatari devono eseguire l'accesso a Looker e disporre delle autorizzazioni per accedere al modello su cui si basano i contenuti inviati per visualizzarli su Looker. Se vuoi rimuovere questo link dalle tue email di invio dei dati, deseleziona la casella di controllo Includi link.
Opzioni formato
Per le pubblicazioni che non utilizzano il formato di visualizzazione sono disponibili opzioni di pubblicazione aggiuntive, descritte di seguito.
Applica opzioni di visualizzazione
Questa opzione non è disponibile per le pubblicazioni Look o Explore nel formato di visualizzazione.
Seleziona Applica le opzioni di visualizzazione per fare in modo che la pubblicazione dei dati sia simile a quella di un grafico a tabella. Viene applicata una qualsiasi delle seguenti impostazioni dei menu Traccia, Serie e Formattazione:
- Mostra numeri di riga
- Nascondi totali
- Nascondi totali riga
- Limita le righe visualizzate a un massimo di 500 righe mostrate o nascoste
- Mostra nome campo completo
- Etichette personalizzate per ogni colonna (il formato JSON: dettagli, incorporato utilizza sempre nomi non elaborati dei campi e non il etichetta dei campi; consulta il post della scheda Modifica della formattazione JSON per ulteriori informazioni sul modo in cui Looker visualizza i campi in formato JSON)
- Formattazione condizionale per le pubblicazioni di visualizzazioni dei grafici tabulari in formato Excel
La formattazione condizionale viene visualizzata nelle pubblicazioni Excel di Look ed esplorazioni, con visualizzazioni dei grafici tabulari solo se viene applicata la regola Along a scale.
Deseleziona Applica le opzioni di visualizzazione per consentire a Looker di inviare i dati così come vengono visualizzati nella sezione Data (Dati) della finestra Look o Look della dashboard Esplora da qui di un riquadro della dashboard. JSON: etichetta utilizza il campo etichetta, anche se l'opzione Applica opzioni di visualizzazione non è selezionata.
Valori dei dati formattati
Questa opzione non è disponibile per le pubblicazioni Look o Explore nel formato di visualizzazione.
Puoi configurare la formattazione dei dati:
- Seleziona Valori dei dati formattati se vuoi che i dati appaiano più simili all'esperienza Esplora in Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i tipi di file.
- Deseleziona Valori dei dati formattati se non vuoi applicare alcuna formattazione speciale dei risultati della query, come l'arrotondamento dei numeri lunghi o l'aggiunta di caratteri speciali previsti per gli sviluppatori Looker. Questa è in genere l'opzione preferita per i dati che devono essere inviati a un altro strumento per l'elaborazione.
Risoluzione tabella
Quando invii contenuti via email in formato di visualizzazione, puoi personalizzare la larghezza della visualizzazione utilizzando il menu a discesa Risoluzione tabella. Le opzioni relative alla larghezza sono:
- Normale: 800 pixel
- Larghezza: 1680 pixel.
Se scegli Largo e la larghezza di visualizzazione supera il limite impostato dal tuo client di posta, i destinatari del recapito delle email potrebbero dover scorrere in orizzontale per vedere l'intera visualizzazione.
Fuso orario
Per impostazione predefinita, Looker utilizza il fuso orario associato al tuo account per determinare quando inviare la distribuzione dei dati. Se non hai un fuso orario associato al tuo account, Looker utilizza quello in Application time zone (Fuso orario dell'applicazione). Se vuoi specificare un fuso orario diverso, seleziona Utilizza fuso orario personalizzato. Il fuso orario selezionato non influisce sui dati presenti nel Look o nella dashboard, ma solo sui tempi di consegna.
Testare la pubblicazione
Fai clic sul pulsante Invia test per inviare un'unica esecuzione del test alla destinazione specificata.
Salvataggio della consegna
Il riepilogo delle impostazioni di consegna viene visualizzato nella parte inferiore dello scheduler.
Per le distribuzioni una tantum, una volta completata la configurazione delle opzioni di recapito, fai clic sul pulsante Invia per inviare subito i contenuti alla destinazione specificata.
Per le distribuzioni ricorrenti, dopo aver configurato le opzioni di consegna, fai clic sul pulsante Salva tutto per salvare la pianificazione e chiudere la finestra. I contenuti verranno pubblicati in base alle tue impostazioni di pubblicazione. Se riapri lo scheduler, la pianificazione salvata viene visualizzata nel riquadro a sinistra. Puoi duplicare o eliminare la pianificazione facendo clic rispettivamente sull'icona Duplica o Elimina.
La pianificazione salvata viene visualizzata anche nella pagina Pianificazioni che hai creato nel tuo profilo utente, nonché nelle pagine Pianificazioni e Cronologia delle pianificazioni nel riquadro Amministratore. Per ulteriori informazioni, consulta la sezione Visualizzazione delle consegne in questa pagina.
Visualizzare le consegne
Puoi visualizzare le pianificazioni che hai creato e, con le autorizzazioni appropriate, tutte le pianificazioni per l'istanza di Looker.
Visualizzare le pubblicazioni che hai creato
Puoi visualizzare un elenco di tutte le pianificazioni che hai creato nella pagina Pianificazioni create, a cui puoi accedere facendo clic sull'icona del tuo profilo utente e selezionando Pianificazioni. Per scoprire di più sulla visualizzazione e sulla gestione delle pianificazioni che hai creato, consulta la pagina Visualizzazione delle pianificazioni di pubblicazione dei dati pianificate.
Visualizzare le pubblicazioni create da altri utenti
Se l'amministratore di Looker ti ha concesso le autorizzazioni per visualizzare le Pianificazioni e Pianificazioni delle pagine di amministrazione, puoi vedere l'elenco di tutte le pianificazioni dell'intera istanza di Looker. ma non potrai modificarle o eliminarle.
Aspetti da tenere presenti
A volte, la consegna pianificata dell'email potrebbe non riuscire a raggiungere uno o più destinatari. Questo può verificarsi se il modello sottostante presenta un errore, se il destinatario non ha accesso ai dati o se sono presenti problemi di rendering o di pagina.
Possono sorgere altre sfide:
- Se la tua società ha configurato le proprie impostazioni email nella sezione Admin di Looker, gli amministratori di Looker dovranno verificare che le impostazioni siano corrette e che il tuo provider email funzioni correttamente.
- A seconda dell'impostazione Limite, la consegna dei dati sarà limitata a 5000 righe o a una dimensione massima di 15 MB per le email con allegati e 20 MB per le email con contenuti in linea. Le email con un numero di righe o dati superiore a questi limiti non verranno inviate.
- Se un'email non viene inviata al momento previsto, ma alla fine arriva, è probabile che tu stia competendo con altre attività di Looker. Queste attività possono includere altre email programmate, molte persone che esplorano i dati contemporaneamente o tabelle derivate permanenti in fase di creazione. In questo caso, rivolgiti agli amministratori di Looker per informazioni sulle attività concorrenti.
- Se un'email specifica scompare dal tuo elenco di distribuzione, è probabile che l'utente abbia annullato l'iscrizione alle email pianificate. Questo può costituire un problema particolare se utilizzi un alias email di gruppo per inviare messaggi a più persone, perché ogni singolo destinatario può annullare l'iscrizione a quell'intero alias email. Per comprendere come annullare l'iscrizione, leggi questo post della community di Looker su come monitorare gli eventi di annullamento dell'iscrizione allo scheduler.