Autorizzazione ed esecuzione di notebook

È possibile utilizzare i notebook per organizzare, annotare e condividere più query SQL in un singolo documento. È possibile aggiungere più query SQL e celle Markdown a un notebook. I notebook offrono un modo per raggruppare query e spiegazioni associate a un'analisi dei dati in un singolo documento utilizzando più query e celle Markdown. È possibile aggiungere testo e formattare l'aspetto utilizzando la sintassi Markdown per fornire contesto e informazioni aggiuntive per le attività di analisi dei dati. È possibile condividere i notebook con i membri del team.

Per utilizzare i notebook, è necessario aggiungere l'autorizzazione per i notebook al principale IAM (un utente IAM o un ruolo IAM). Come best practice, consigliamo di collegare le policy di autorizzazioni a un ruolo IAM, che quindi viene assegnato a utenti e gruppi secondo le necessità. Per ulteriori informazioni, consulta Identity and access management in Amazon Redshift. È possibile aggiungere l'autorizzazione a una delle policy gestite dell'editor di query v2. Per ulteriori informazioni, consulta Accesso all'editor di query v2.

È possibile selezionare l'opzione Run all (Esegui tutte) per eseguire tutte le celle di un notebook in sequenza. La cella di query SQL di un notebook include la maggior parte delle funzionalità di una scheda dell'editor di query. Per ulteriori informazioni, consulta Autorizzazione e esecuzione di query. Di seguito sono elencate le differenze tra una scheda dell'editor di query e una cella SQL in un notebook.

• In un notebook non esiste un controllo per eseguire Explain su un'istruzione SQL.

• È possibile creare un solo grafico per cella SQL in un notebook.

È possibile esportare e importare notebook in file creati con l'editor di query v2. L'estensione dei file è .ipynb e la dimensione massima dei file è 5 MB. Le celle SQL e Markdown vengono archiviate nei file. Un cluster o un gruppo di lavoro e un database non vengono archiviati nel notebook esportato. Quando si apre un notebook importato, occorre scegliere il cluster o il gruppo di lavoro e il database in cui eseguirlo. Dopo aver eseguito le celle SQL, è possibile scegliere nella scheda dei risultati se visualizzare la pagina corrente dei risultati come grafico. Il set di risultati di una query non è archiviato nel notebook.

Quando esegui un notebook con Esegui tutto o Esegui, diventa disponibile il pannello Stato dell'esecuzione. Scegli l'icona per aprire il pannello. Questo pannello contiene un riepilogo dello stato delle operazioni Esegui tutto o Esegui più recenti delle celle SQL del notebook. Se esegui più celle SQL, puoi vedere immediatamente lo stato, il tempo trascorso e alcuni dettagli sull'esecuzione. Puoi filtrare le celle visualizzate in base allo stato: All, Succeeded, Error, In progress o Canceled. Inoltre, puoi utilizzare questo pannello per accedere a una cella SQL nell'editor.

Creazione di un notebook

1. Dal menu del navigatore, scegli Editor.

2. Scegli e quindi scegli Notebook.

   Per impostazione predefinita, nel notebook viene visualizzata una cella di query SQL.

3. Nella cella della query SQL effettuare una delle seguenti operazioni:

   • Inserisci una query.

   • Incolla una query copiata.

4. (Facoltativo) Seleziona l'icona , quindi scegli Markdown per aggiungere una cella Markdown in cui includere testo descrittivo o esplicativo utilizzando la sintassi standard Markdown.

5. (Facoltativo) Seleziona l'icona , quindi scegli SQL per inserire una cella SQL.

È possibile rinominare i notebook utilizzando l'icona (matita).

Dal menu (altro), è inoltre possibile eseguire le seguenti operazioni su un notebook:

• Share with my team (Condividi con il mio team): consente di condividere il notebook con il team come definito dai tag. Per ulteriori informazioni, consultare Condivisione di una query

• Export (Esporta): consente di esportare il notebook in un file locale con estensione .ipynb.

• Save version (Salva versione): consente di creare una versione del notebook. Per visualizzare le versioni di un notebook, accedi ai notebook salvati e apri Version history (Cronologia delle versioni).

• Duplicate (Duplica): consente di creare una copia del notebook e aprirlo in una nuova scheda del notebook.

• Shortcuts (Scorciatoie): consente di visualizzare le scorciatoie disponibili durante la creazione di un notebook.

Come aprire un notebook salvato

1. Dal menu del navigatore, seleziona Notebook. Vengono visualizzati i notebook e le cartelle dei notebook salvati.

2. Scegli il notebook da aprire e fai doppio clic su di esso.

Nella scheda dei notebook puoi mostrare My notebooks (I miei notebook), i notebook Shared by me (Condivisi da me) e i notebook Shared to my team (Condivisi con il mio team).

Per importare un notebook da un file locale in My notebooks (I miei notebook), scegli Import (Importa), quindi vai al file .ipynb contenente il notebook. Il notebook viene importato nella cartella del notebook attualmente aperta. È possibile aprire il notebook nell'editor del notebook.

Dal menu contestuale (tasto destro del mouse) di un notebook è possibile eseguire queste operazioni:

• Open notebook (Apri notebook): consente di aprire il notebook nell'editor.

• Save version (Salva versione): consente di salvare una versione del notebook.

• Version history (Cronologia delle versioni): consente di visualizzare le versioni di un notebook. Dalla finestra Version history (Cronologia delle versioni) è possibile eliminare e ripristinare versioni. È anche possibile creare un notebook dalla versione attualmente selezionata.

• Edit tags (Modifica tag): consente di creare e modificare tag su un notebook.

• Share with my team (Condividi con il mio team): consente di condividere un notebook con il team.

  Per condividere una query con il team, assicurati di disporre del tag principale sqlworkbench-team impostato sullo stesso valore del resto dei membri del team nel tuo account. Ad esempio, un amministratore potrebbe impostare il valore su accounting-team per tutti nel reparto contabilità. Per vedere un esempio, consulta Autorizzazioni necessarie per utilizzare l'editor della query v2 .

• Export (Esporta): consente di esportare un notebook in un file locale.

• Rename (Rinomina): consente di rinominare un notebook.

• Duplicate (Duplica): consente di creare una copia di un notebook.

• Delete (Elimina): consente di eliminare un notebook.

Per una demo dei notebook, guardare il video seguente.