Erstellen und Ausführen von Notebooks

Mithilfe von Notebooks können Sie mehrere SQL-Abfragen in einem einzigen Dokument organisieren, kommentieren und freigeben. Einem Notebook lassen sich mehrere SQL-Abfrage- und Markdown-Zellen hinzufügen. Notebooks bieten die Möglichkeit, Abfragen und Erklärungen im Zusammenhang mit einer Datenanalyse unter Verwendung mehrerer Abfrage- und Markdown-Zellen in einem einzigen Dokument zu gruppieren. Sie können Text hinzufügen und das Erscheinungsbild mithilfe der Markdown-Syntax formatieren, um Kontext und zusätzliche Informationen für Ihre Datenanalyse bereitzustellen. Sie können Ihre Notebooks für Teammitglieder freigeben.

Für die Verwendung von Notebooks müssen Sie Ihrem IAM-Prinzipal (einem IAM-Benutzer oder einer IAM-Rolle) die Berechtigung für Notebooks hinzufügen. Als bewährte Methode empfehlen wir, einer IAM-Rolle Berechtigungsrichtlinien anzufügen und sie dann nach Bedarf Benutzern und Gruppen zuzuweisen. Weitere Informationen finden Sie unter Identity and Access Management in Amazon Redshift. Sie können die Berechtigung zu einer der von Abfrage-Editor v2 verwalteten Richtlinien hinzufügen. Weitere Informationen finden Sie unter Zugreifen auf den Abfrage-Editor v2.

Sie können die Zellen eines Notebooks sequenziell ausführen (Run all). Die SQL-Abfragezelle eines Notebooks verfügt über fast dieselben Funktionen wie eine Registerkarte im Abfrage-Editor. Weitere Informationen finden Sie unter Erstellen und Ausführen von Abfragen. Im Folgenden sind die Unterschiede zwischen einer Registerkarte im Abfrage-Editor und einer SQL-Zelle in einem Notebook aufgeführt.

• Es gibt kein Steuerelement zur Ausführung von Explain in einer SQL-Anweisung in einem Notebook.

• Sie können nur ein Diagramm pro SQL-Zelle in einem Notebook erstellen.

Sie können Notebooks in Dateien, die mit Abfrage-Editor v2 erstellt wurden, exportieren und importieren. Die Dateierweiterung lautet .ipynb und die Dateigröße kann maximal 5 MB betragen. Die SQL- und Markdown-Zellen werden in der Datei gespeichert. Ein Cluster oder eine Arbeitsgruppe und eine Datenbank werden nicht im exportierten Notebook gespeichert. Wenn Sie ein importiertes Notebook öffnen, wählen Sie den Cluster oder die Arbeitsgruppe und die Datenbank aus, in dem/denen es ausgeführt werden soll. Nach Ausführung von SQL-Zellen können Sie auf der Registerkarte „Results“ (Ergebnisse) auswählen, ob die aktuelle Ergebnisseite als Diagramm angezeigt werden soll. Die Ergebnismenge einer Abfrage wird nicht im Notebook gespeichert.

Bei Ausführung eines Notebooks über die Optionen Alle ausführen oder Ausführen wird ein Bereich Ausführungsstatus verfügbar. Wählen Sie das Symbol aus, um den Bereich zu öffnen. Dieser Bereich enthält eine Zusammenfassung des Status der letzten Ausführung der SQL-Zellen in Ihrem Notebook mit Alle ausführen oder Ausführen. Wenn Sie mehrere SQL-Zellen ausführen, können Sie auf einen Blick den Status, die verstrichene Zeit und einige Details zur Ausführung sehen. Sie können die angezeigten Zellen nach Status filtern: All, Succeeded, Error, In progress oder Canceled. Sie können diesen Bereich auch verwenden, um zu einer SQL-Zelle im Editor zu navigieren.

So erstellen Sie ein Notebook

1. Wählen Sie im Navigator-Menü Editor aus.

2. Wählen Sie und dann Notebook aus.

   Standardmäßig wird eine SQL-Abfragezelle im Notebook angezeigt.

3. Führen Sie in der SQL-Abfragezelle einen der folgenden Schritte aus:

   • Geben Sie eine Abfrage ein.

   • Fügen Sie eine Abfrage ein, die Sie kopiert haben.

4. (Optional) Wählen Sie das -Symbol und dann Markdown aus, um eine Markdown-Zelle hinzuzufügen, in der Sie beschreibenden oder erklärenden Text mithilfe der Standard-Markdown-Syntax schreiben können.

5. (Optional) Wählen Sie das -Symbol und dann SQL aus, um eine SQL-Zelle einzufügen.

Mit dem Symbol (Stiftsymbol) können Sie Notebooks umbenennen.

Über das Menü (Mehr) können Sie auch die folgenden Operationen in einem Notebook ausführen:

• Share with my team (Für mein Team freigeben) – Zum Freigeben des Notebooks für Ihr Team gemäß den Tags. Weitere Informationen finden Sie unter Teilen einer Abfrage.

• Export (Exportieren) – Zum Exportieren des Notebooks in eine lokale Datei mit der Erweiterung .ipynb.

• Save version (Version speichern) – Zum Erstellen einer Version des Notebooks. Wenn Sie verschiedene Versionen eines Notebooks anzeigen möchten, navigieren Sie zu Ihren gespeicherten Notebooks und öffnen Sie Version history (Versionsverlauf).

• Duplicate (Duplizieren) – Zum Erstellen einer Kopie des Notebooks und Öffnen dieser Kopie in einer neuen Notebook-Registerkarte.

• Shortcuts (Tastenkombinationen) – Zum Anzeigen der verfügbaren Tastenkombinationen beim Erstellen eines Notebooks.

So öffnen Sie ein gespeichertes Notebook

1. Wählen Sie im Navigator-Menü Notebooks aus. Ihre gespeicherten Notebooks und Notebook-Ordner werden angezeigt.

2. Wählen Sie das zu öffnende Notebook aus und doppelklicken Sie darauf.

Auf der Notebook-Registerkarte können Sie eigene Notebooks (Option My notebooks), Notebooks, die von Ihnen freigegeben wurden (Option Shared by me), und Notebooks, die für Ihr Team freigegeben wurden (Option Shared to my team), anzeigen.

Um ein Notebook aus einer lokalen Datei in My notebooks (Eigene Notebooks) zu importieren, wählen Sie Import (Importieren) aus und navigieren Sie dann zu der.ipynb-Datei, die Ihr Notebook enthält. Das Notebook wird in den aktuell geöffneten Notebook-Ordner importiert. Sie können das Notebook anschließend im Notebook-Editor öffnen.

Im Kontextmenü (rechte Maustaste) eines Notebooks können Sie folgende Aktionen ausführen:

• Open notebook (Notebook öffnen) – Zum Öffnen des Notebooks im Editor.

• Save version (Version speichern) – Zum Speichern einer Version des Notebooks.

• Version history (Versionsverlauf) – Zum Anzeigen der Versionen eines Notebooks. Im Fenster Version history (Versionsverlauf) können Sie Versionen löschen und zurücksetzen. Sie können auch ein Notebook aus der aktuell ausgewählten Version erstellen.

• Edit tags (Tags bearbeiten) – Zum Erstellen und Bearbeiten von Tags in einem Notebook.

• Share with my team (Für mein Team freigeben) – Zum Freigeben eines Notebooks für Ihr Team.

  Um ein Notebook für Ihr Team freizugeben, müssen Sie sicherstellen, dass das Prinzipal-Tag sqlworkbench-team auf denselben Wert wie bei den übrigen Teammitgliedern in Ihrem Konto eingestellt ist. Beispielsweise könnte ein Administrator den Wert für jeden in der Buchhaltungsabteilung auf accounting-team einstellen. Ein Beispiel finden Sie unter Für die Verwendung des Abfrage-Editors v2 erforderliche Berechtigungen .

• Export (Exportieren) – Zum Exportieren eines Notebooks in eine lokale Datei.

• Rename (Umbenennen) – Zum Umbenennen eines Notebooks.

• Duplicate (Duplizieren) – Zum Erstellen einer Kopie eines Notebooks.

• Delete (Löschen) – Zum Löschen eines Notebooks.

Eine Demo zu Notebooks finden Sie im folgenden Video.