Création et exécution de blocs-notes

Vous pouvez utiliser des blocs-notes pour organiser, annoter et partager plusieurs requêtes SQL dans un même document. Vous pouvez ajouter plusieurs cellules Markdown et de requête SQL à un bloc-notes. Les blocs-notes permettent de regrouper des requêtes et des explications associées à une analyse de données dans un seul document à l’aide de plusieurs cellules de requête et Markdown. Vous pouvez ajouter du texte et mettre en forme l’apparence à l’aide de la syntaxe Markdown pour fournir du contexte et des informations supplémentaires pour vos tâches d’analyse de données. Vous pouvez partager vos blocs-notes avec les membres de l’équipe.

Pour utiliser des blocs-notes, vous devez ajouter une autorisation pour les blocs-notes à votre principal IAM (utilisateur IAM ou rôle IAM). Il est recommandé d’associer des politiques d’autorisation à un rôle IAM, puis de l’attribuer à des utilisateurs et à des groupes, le cas échéant. Pour plus d’informations, consultez Identity and Access Management dans Amazon Redshift. Vous pouvez ajouter l’autorisation à l’une des politiques gérées par l’éditeur de requêtes v2. Pour plus d'informations, consultez Accès à l’éditeur de requête v2.

Vous pouvez Run all (Exécuter toutes) les cellules d’un bloc-notes de manière séquentielle. La cellule de requête SQL d’un bloc-notes possède la plupart des mêmes fonctionnalités qu’un onglet d’éditeur de requêtes. Pour plus d'informations, consultez Création et exécution de requêtes. Voici les différences entre un onglet d’éditeur de requêtes et une cellule SQL dans un bloc-notes.

• Il n’existe aucun contrôle pour exécuter Explain sur une instruction SQL dans un bloc-notes.

• Vous ne pouvez créer qu’un seul graphique par cellule SQL dans un bloc-notes.

Vous pouvez exporter et importer des bloc-notes dans des fichiers créés avec l’éditeur de requête v2. L’extension de fichier est .ipynb et la taille du fichier peut atteindre 5 Mo au maximum. Les cellules SQL et Markdown sont stockées dans le fichier. Aucun cluster ou groupe de travail ni base de données ne sont stockés dans le bloc-notes exporté. Lorsque vous ouvrez un bloc-notes importé, vous choisissez le cluster ou le groupe de travail et la base de données dans laquelle l’exécuter. Après avoir exécuté des cellules SQL, vous pouvez choisir d’afficher ou non la page actuelle des résultats sous forme de graphique dans l’onglet des résultats. Le jeu de résultats d’une requête n’est pas stocké dans le bloc-notes.

Lorsque vous exécutez un bloc-notes, avec Tout exécuter ou Exécuter, un panneau Statut d’exécution devient disponible. Choisissez l’icône pour ouvrir le panneau. Ce panneau contient un résumé du statut des dernières opérations Tout exécuter ou Exécuter des cellules SQL de votre bloc-notes. Si vous exécutez plusieurs cellules SQL, vous pouvez voir en un coup d’œil le statut, le temps écoulé et certains détails relatifs à l’exécution. Vous pouvez filtrer les cellules affichées en fonction du statut : All, Succeeded, Error, In progress ou Canceled. Vous pouvez également utiliser ce panneau pour accéder à une cellule SQL dans l’éditeur.

Pour créer un bloc-notes

1. Dans le menu du navigateur, choisissez Editor (Éditeur).

2. Choisissez , puis Notebook (Bloc-notes).

   Par défaut, une cellule de requête SQL apparaît dans le bloc-notes.

3. Dans la cellule de requête SQL, effectuez l’une des actions suivantes :

   • Saisissez une requête.

   • Collez une requête que vous avez copiée.

4. (Facultatif) Choisissez l’icône , puis Markdown pour ajouter une cellule Markdown dans laquelle vous pouvez fournir du texte descriptif ou explicatif à l’aide de la syntaxe Markdown standard.

5. (Facultatif) Choisissez l’icône , puis SQL pour insérer une cellule SQL.

Vous pouvez renommer des blocs-notes à l’aide de l’icône (crayon).

Dans le menu (plus), vous pouvez également effectuer les opérations suivantes sur un bloc-notes :

• Share with my team (Partager avec mon équipe) : pour partager le bloc-notes avec votre équipe, tel que défini par des balises. Pour plus d’informations, consultez Partage d’une requête.

• Export (Exporter) : pour exporter le bloc-notes vers un fichier local portant l’extension .ipynb.

• Save version (Enregistrer la version) : pour créer une version du bloc-notes. Pour voir les versions d’un bloc-notes, accédez à vos blocs-notes enregistrés et ouvrez Version history (Historique des versions).

• Duplicate (Dupliquer) : pour créer une copie du bloc-notes et l’ouvrir dans un nouvel onglet de bloc-notes.

• Shortcuts (Raccourcis) : pour afficher les raccourcis disponibles lors de la création d’un bloc-notes.

Pour ouvrir un bloc-notes enregistré

1. Dans le menu du navigateur, choisissez Notebooks (Blocs-notes). Vos blocs-notes et dossiers de blocs-notes enregistrés s’affichent.

2. Choisissez le bloc-notes que vous souhaitez ouvrir et double-cliquez dessus.

Vous pouvez afficher My notebooks (Mes blocs-notes), les blocs-notes Shared by me (Partagé par moi) et les blocs-notes Shared to my team (Partagé avec mon équipe) dans l’onglet Notebooks (Blocs-notes).

Pour importer un bloc-notes depuis un fichier local vers My notebooks (Mes blocs-notes), choisissez Import (Importer), puis accédez au fichier .ipynb qui contient votre bloc-notes. Le bloc-notes est importé dans le dossier du bloc-notes actuellement ouvert. Vous pouvez ensuite ouvrir le bloc-notes dans l’éditeur de bloc-notes.

Dans le menu contextuel (clic droit) d’un bloc-notes, vous pouvez effectuer les opérations suivantes :

• Open notebook (Ouvrir le bloc-notes) : pour ouvrir le bloc-notes dans l’éditeur.

• Save version (Enregistrer la version) : pour enregistrer une version du bloc-notes.

• Version history (Historique des versions) : pour afficher les versions d’un bloc-notes. Dans la fenêtre Version history (Historique des versions), vous pouvez supprimer et annuler des versions. Vous pouvez également créer un bloc-notes à partir de la version actuellement sélectionnée.

• Edit tags (Modifier les balises) : pour créer et modifier des balises sur un bloc-notes.

• Share with my team (Partager avec mon équipe) : pour partager un bloc-notes avec votre équipe.

  Pour partager un bloc-notes avec votre équipe, assurez-vous que la balise principale sqlworkbench-team est définie sur la même valeur que les autres membres de votre équipe dans votre compte. Par exemple, un administrateur peut définir la valeur sur accounting-team pour tous les membres du service comptable. Pour obtenir un exemple, consultez Autorisations requises pour utiliser l’éditeur de requête v2 .

• Export (Exporter) : pour exporter un bloc-notes vers un fichier local.

• Rename (Renommer) : pour renommer un bloc-notes.

• Duplicate (Dupliquer) : pour créer une copie d’un bloc-notes.

• Delete (Supprimer) : pour supprimer un bloc-notes.

Pour une démonstration de carnets de notes, regardez la vidéo suivante.