

 Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Carnets de notes dans Amazon Redshift
<a name="query-editor-v2-notebooks"></a>

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](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html). Vous pouvez ajouter l’autorisation à l’une des politiques gérées par l’éditeur de requêtes v2. Pour de plus amples informations, veuillez consulter [Accès à l’éditeur de requête v2](query-editor-v2-getting-started.md#query-editor-v2-configure).

Vous pouvez 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 de plus amples informations, veuillez consulter [Création de requêtes avec Amazon Redshift](query-editor-v2-query-run.md). 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.

# Création d'un bloc-notes
<a name="query-editor-v2-notebooks-create"></a>

Vous pouvez créer un bloc-notes pour organiser, annoter et partager plusieurs requêtes SQL dans un seul document. 

**Pour créer un bloc-notes**

1. Dans le menu du navigateur, choisissez l'icône de l'éditeur (![\[Horizontal lines representing redacted or censored text.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-align-left.png)).

1. Cliquez sur l'icône plus (![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/add-plus.png)), puis sur Carnet de **notes**.

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

1. 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.

1. (Facultatif) Choisissez l'icône plus (![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/add-plus.png)), puis choisissez **Markdown** pour ajouter une cellule Markdown dans laquelle vous pouvez fournir un texte descriptif ou explicatif en utilisant la syntaxe Markdown standard. 

1. (Facultatif) Choisissez l'icône plus (![\[Plus sign icon representing an addition or new item action.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/add-plus.png)), puis sélectionnez **SQL** pour insérer une cellule SQL. 

Vous pouvez renommer les blocs-notes à l'aide de l'icône en forme de crayon ()![\[Pencil icon representing an editing or writing function.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-edit.png).

À partir de l'icône du menu (![\[Three dots arranged horizontally, representing an ellipsis or "more" menu icon.\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-more.png)), vous pouvez également effectuer les opérations suivantes sur un bloc-notes :
+ ![\[Share\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-share.png) **Share with my team** (Partager avec mon équipe) : pour partager le bloc-notes avec votre équipe, tel que défini par des balises. 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](redshift-iam-access-control-identity-based.md#redshift-policy-resources.required-permissions.query-editor-v2).
+ ![\[Export\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-export.png) **Export** (Exporter) : pour exporter le bloc-notes vers un fichier local portant l’extension `.ipynb`.
+ ![\[Import query\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-import.png)**Importer une requête** : pour importer une requête d'un fichier local dans une cellule du bloc-notes. Vous pouvez importer des fichiers avec `.sql` des `.txt` extensions.
+  ![\[Save\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-floppy-disk.png) **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\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-duplicate.png) **Duplicate** (Dupliquer) : pour créer une copie du bloc-notes et l’ouvrir dans un nouvel onglet de bloc-notes. 
+  ![\[Shortcuts\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-key-command.png) **Shortcuts** (Raccourcis) : pour afficher les raccourcis disponibles lors de la création d’un bloc-notes. 

# Importation dans des blocs-notes
<a name="query-editor-v2-notebooks-import"></a>

Vous pouvez importer un bloc-notes complet ou des cellules SQL individuelles dans un bloc-notes de l'éditeur de requêtes v2.

Pour importer un bloc-notes complet à partir d'un fichier local dans **Mes blocs-notes**, choisissez ![\[Import\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-import.png) **Importer, puis Importer** un **bloc-notes**. Accédez au `.ipynb` fichier contenant 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.

Pour importer une requête d'un fichier local dans une cellule SQL d'un bloc-notes, choisissez ![\[Import\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/mgmt/images/qev2-import.png) **Importer**, puis **Importer une requête**. Dans la fenêtre **Importer une requête**, suivez les instructions affichées à l'écran pour choisir les fichiers et les dossiers qui peuvent être importés sous forme de requête dans un nouveau bloc-notes ou un bloc-notes existant. Les fichiers doivent porter l'extension `.sql` ou`.txt`. Chaque requête peut comporter jusqu'à 10 000 caractères. Lorsque vous ajoutez un bloc-notes à un bloc-notes existant, vous choisissez quel bloc-notes parmi tous les blocs-notes de votre liste de **blocs-notes enregistrés**. Les requêtes importées sont ajoutées sous forme de cellules SQL à la fin du bloc-notes. Lorsque vous choisissez un nouveau bloc-notes, vous choisissez le nom du bloc-notes et celui-ci est créé dans le dossier des blocs-notes enregistrés actuellement ouvert. 

**Note**  
Lorsque vous créez `.sql` des fichiers sur macOS à l'aide de l' TextEditapplication, il se peut qu'une extension masquée supplémentaire soit ajoutée au fichier. Par exemple, un fichier nommé `Test.sql` créé dans TextEdit peut finir par être enregistré sous`Test.sql.rtf`. L'éditeur de requêtes v2 ne prend pas en charge les fichiers portant l'`.rtf`extension. Toutefois, si vous créez un `.sql` fichier à l'aide TextEdit d'un fichier texte brut et que vous l'enregistrez sous forme de fichier texte brut, le fichier possède une `.txt` extension masquée supplémentaire. Par exemple, un fichier nommé `Text.sql` peut être enregistré sous`Text.sql.txt`. Contrairement à l'`.rtf`extension, l'éditeur de requêtes v2 prend en charge les fichiers portant cette `.txt` extension. `Text.sql.txt` Il est donc pris en charge lors de l'importation de requêtes dans des blocs-notes.

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

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/GNahyu7j98M/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/GNahyu7j98M)
