Erstellen, Entwickeln und Verwalten von Synapse Studio-Notebooks (Vorschauversion) in Azure Synapse AnalyticsCreate, develop, and maintain Synapse Studio (preview) notebooks in Azure Synapse Analytics

Ein Synapse Studio-Notebook (Vorschauversion) ist eine Weboberfläche, mit der Sie Dateien erstellen können, die Livecode, Visualisierungen und beschreibenden Text enthalten.A Synapse Studio (preview) notebook is a web interface for you to create files that contain live code, visualizations, and narrative text. Notebooks sind ein guter Ausgangspunkt, um Ideen zu überprüfen und schnelle Experimente zu verwenden, um Erkenntnisse aus Ihren Daten zu gewinnen.Notebooks are a good place to validate ideas and use quick experiments to get insights from your data. Notebooks werden auch häufig bei der Datenvorbereitung, Datenvisualisierung, Machine Learning und andere Big Data-Szenarien verwendet.Notebooks are also widely used in data preparation, data visualization, machine learning, and other Big Data scenarios.

Mit einem Azure Synapse Studio-Notebook können Sie:With an Azure Synapse Studio notebook, you can:

  • Ohne Einrichtungsaufwand sofort loslegen.Get started with zero setup effort.
  • Daten mit integrierten Sicherheitsfeatures auf Unternehmensniveau schützen.Keep data secure with built-in enterprise security features.
  • Daten in Rohformaten (CSV, TXT, JSON usw.), verarbeiteten Dateiformaten (Parquet, Delta Lake, ORC usw.) und tabellarischen SQL-Datendateien gegen Spark und SQL analysieren.Analyze data across raw formats (CSV, txt, JSON, etc.), processed file formats (parquet, Delta Lake, ORC, etc.), and SQL tabular data files against Spark and SQL.
  • Produktiv sein mit erweiterten Funktionen zur Dokumenterstellung und integrierter Datenvisualisierung.Be productive with enhanced authoring capabilities and built-in data visualization.

In diesem Artikel wird beschrieben, wie Sie Notebooks in Azure Synapse Studio verwenden.This article describes how to use notebooks in Azure Synapse Studio.

Erstellen eines NotebooksCreate a notebook

Ein Notebook kann auf zwei Arten erstellt werden.There are two ways to create a notebook. Sie können ein neues Notebook erstellen oder ein vorhandenes Notebook aus dem Objekt-Explorer in einen Azure Synapse-Arbeitsbereich importieren.You can create a new notebook or import an existing notebook to an Azure Synapse workspace from the Object Explorer. Azure Synapse Studio-Notebooks können Jupyter Notebook IPYNB-Standarddateien erkennen.Azure Synapse Studio notebooks can recognize standard Jupyter Notebook IPYNB files.

Synapse-erstellen-importieren-Notebook

Entwickeln von NotebooksDevelop notebooks

Notebooks bestehen aus Zellen, bei denen es sich um einzelne Codeblöcke oder Text handelt, die unabhängig oder als Gruppe ausgeführt werden können.Notebooks consist of cells, which are individual blocks of code or text that can be ran independently or as a group.

Hinzufügen einer ZelleAdd a cell

Es gibt mehrere Möglichkeiten, um Ihrem Notebook eine neue Zelle hinzuzufügen.There are multiple ways to add a new cell to your notebook.

  1. Erweitern Sie die Schaltfläche oben links + Zelle, und wählen Sie Codezelle hinzufügen oder Textzelle hinzufügen aus.Expand the upper left + Cell button, and select Add code cell or Add text cell.

    Hinzufügen-Zelle-mit-Schaltfläche-Zelle

  2. Zeigen Sie mit dem Mauszeiger auf den Bereich zwischen zwei Zellen, und wählen Sie Code hinzufügen oder Text hinzufügen aus.Hover over the space between two cells and select Add code or Add text.

    Hinzufügen-Zelle-Zwischenraum

  3. Verwenden Sie Tastenkombinationen im Befehlsmodus.Use Shortcut keys under command mode. Drücken Sie A, um eine Zelle oberhalb der aktuellen Zelle einzufügen.Press A to insert a cell above the current cell. Drücken Sie B, um eine Zelle unterhalb der aktuellen Zelle einzufügen.Press B to insert a cell below the current cell.

Festlegen einer primären SpracheSet a primary language

Azure Synapse Studio-Notebooks unterstützen vier Apache Spark-Sprachen:Azure Synapse Studio notebooks support four Apache Spark languages:

  • PySpark (Python)pySpark (Python)
  • Spark (Scala)Spark (Scala)
  • SparkSQLSparkSQL
  • .NET für Apache Spark (C#).NET for Apache Spark (C#)

Sie können die primäre Sprache für neu hinzugefügte Zellen in der Dropdownliste in der oberen Befehlsleiste festlegen.You can set the primary language for new added cells from the dropdown list in the top command bar.

Standard-Synapse-Sprache

Verwenden mehrerer SprachenUse multiple languages

Sie können in einem Notebook mehrere Sprachen verwenden, indem Sie den richtigen Magic-Befehl für die Sprache am Anfang einer Zelle angeben.You can use multiple languages in one notebook by specifying the correct language magic command at the beginning of a cell. In der folgenden Tabelle werden die Magic-Befehle zum Wechseln von Zellensprachen aufgelistet.The following table lists the magic commands to switch cell languages.

Magic-BefehlMagic command SpracheLanguage BESCHREIBUNGDescription
%%pyspark%%pyspark PythonPython Eine Python-Abfrage im Spark-Kontext ausführen.Execute a Python query against Spark Context.
%%spark%%spark ScalaScala Eine Scala-Abfrage im Spark-Kontext ausführen.Execute a Scala query against Spark Context.
%%sql%%sql SparkSQLSparkSQL Eine SparkSQL-Abfrage im Spark-Kontext ausführen.Execute a SparkSQL query against Spark Context.
%%csharp%%csharp .NET für Spark (C#).NET for Spark C# Führen Sie eine Abfrage vom Typ .NET für Spark (C#) für Spark-Kontext aus.Execute a .NET for Spark C# query against Spark Context.

Die folgende Abbildung zeigt ein Beispiel dafür, wie Sie eine PySpark-Abfrage mit dem Magic-Befehl %%pyspark schreiben können oder eine SparkSQL-Abfrage mit dem Magic-Befehl %%sql in einem Spark (Scala) -Notebook.The following image is an example of how you can write a PySpark query using the %%pyspark magic command or a SparkSQL query with the %%sql magic command in a Spark(Scala) notebook. Beachten Sie, dass die primäre Sprache für das Notebook auf PySpark festgelegt ist.Notice that the primary language for the notebook is set to pySpark.

Synapse-Spark-Magic-Befehle

Verwenden von temporären Tabellen zum Verweisen auf Daten in verschiedenen SprachenUse temp tables to reference data across languages

Sie können nicht direkt auf Daten oder Variablen in verschiedenen Sprachen einem Synapse Studio-Notebook verweisen.You cannot reference data or variables directly across different languages in a Synapse Studio notebook. In Spark kann auf eine temporäre Tabelle in verschiedenen Sprachen verwiesen werden.In Spark, a temporary table can be referenced across languages. Im Folgenden finden Sie ein Beispiel, wie Sie einen Scala-Datenrahmen in PySpark und SparkSQL mittels einer temporären Spark-Tabelle als Problemumgehung lesen können.Here is an example of how to read a Scala DataFrame in PySpark and SparkSQL using a Spark temp table as a workaround.

  1. In Zelle 1 lesen Sie einen Datenrahmen aus dem SQL-Poolconnector mithilfe von Scala, und erstellen Sie eine temporäre Tabelle.In Cell 1, read a DataFrame from SQL pool connector using Scala and create a temporary table.

    %%scala
    val scalaDataFrame = spark.read.option("format", "DW connector predefined type")
    scalaDataFrame.registerTempTable( "mydataframetable" )
    
  2. In Zelle 2 fragen Sie die Daten mithilfe von Spark SQL ab.In Cell 2, query the data using Spark SQL.

    %%sql
    SELECT * FROM mydataframetable
    
  3. In Zelle 3 verwenden Sie die Daten in PySpark.In Cell 3, use the data in PySpark.

    %%pyspark
    myNewPythonDataFrame = spark.sql("SELECT * FROM mydataframetable")
    

IDE-artiges IntelliSenseIDE-style IntelliSense

Azure Synapse Studio-Notebooks sind in den Monaco-Editor integriert, um den Zellen-Editor mit IDE-artigem IntelliSense auszustatten.Azure Synapse Studio notebooks are integrated with the Monaco editor to bring IDE-style IntelliSense to the cell editor. Syntaxhervorhebung, Fehlermarkierungen und automatische Codevervollständigungen helfen Ihnen dabei, Code zu schreiben und Probleme schneller zu erkennen.Syntax highlight, error marker, and automatic code completions help you to write code and identify issues quicker.

Die IntelliSense-Funktionen befinden sich in unterschiedlichen Stadien der Entwicklung für verschiedene Sprachen.The IntelliSense features are at different levels of maturity for different languages. In der folgenden Tabelle können Sie sehen, was unterstützt wird.Use the table below to see what's supported.

LanguagesLanguages SyntaxhervorhebungSyntax Highlight SyntaxfehlermarkierungenSyntax Error Marker Codevervollständigung für SyntaxSyntax Code Completion Codevervollständigung für VariablenVariable Code Completion Codevervollständigung für SystemfunktionenSystem Function Code Completion Codevervollständigung für BenutzerfunktionenUser Function Code Completion Intelligenter EinzugSmart Indent CodefaltungCode Folding
PySpark (Python)PySpark (Python) JaYes JaYes JaYes JaYes JaYes JaYes JaYes JaYes
Spark (Scala)Spark (Scala) JaYes JaYes JaYes JaYes - - - JaYes
SparkSQLSparkSQL JaYes JaYes - - - - - -
.NET für Spark (C#).NET for Spark (C#) JaYes - - - - - - -

Textzelle mit Symbolleisten-Schaltflächen formatierenFormat text cell with toolbar buttons

Sie können die Formatschaltflächen auf der Textzellen-Symbolleiste verwenden, um allgemeine Markdown-Aktionen durchzuführen.You can use the format buttons in the text cells toolbar to do common markdown actions. Dies umfasst das Formatieren von Text als fett oder kursiv, das Einfügen von Codeausschnitten, das Einfügen einer unsortierten Liste, das Einfügen einer sortierten Liste sowie das Einfügen von Bildern aus URLs.It includes bolding text, italicizing text, inserting code snippets, inserting unordered list, inserting ordered list and inserting image from URL.

Synapse-Text-Zelle-Symbolleiste

Rückgängigmachen von ZellenvorgängenUndo cell operations

Klicken Sie auf die Schaltfläche Rückgängig, oder drücken Sie STRG + Z, um den letzten Zellenvorgang aufzuheben.Click the undo button or press Ctrl+Z to revoke the most recent cell operation. Sie können jetzt die bis zu letzten 20 zurückliegenden Zellenaktionen rückgängig machen.Now you can undo up to the latest 20 historical cell actions.

Synapse-Rückgängig-Zellen

Verschieben einer ZelleMove a cell

Wählen Sie die Auslassungspunkte (...) aus, um ganz rechts auf das Menü mit zusätzlichen Zellenaktionen zuzugreifen.Select the ellipses (...) to access the additional cell actions menu at the far right. Wählen Sie dann Zelle nach oben verschieben oder Zelle nach unten verschieben aus, um die aktuelle Zelle zu verschieben.Then select Move cell up or Move cell down to move the current cell.

Sie können auch Tastenkombinationen im Befehlsmodus verwenden.You can also use shortcut keys under command mode. Drücken Sie STRG+ALT+↑, um die aktuelle Zelle nach oben zu verschieben.Press Ctrl+Alt+↑ to move up the current cell. Drücken Sie STRG+ALT+↓, um die aktuelle Zelle nach unten zu verschieben.Press Ctrl+Alt+↓ to move the current cell down.

eine-Zelle-verschieben

Löschen einer ZelleDelete a cell

Um eine Zelle zu löschen, wählen Sie die Auslassungspunkte (...) aus, um ganz rechts auf das Menü mit zusätzlichen Zellenaktionen zuzugreifen, und wählen Sie dann Zelle löschen aus.To delete a cell, select the ellipses (...) to access the additional cell actions menu at the far right then select Delete cell.

Sie können auch Tastenkombinationen im Befehlsmodus verwenden.You can also use shortcut keys under command mode. Drücken Sie D,D, um die aktuelle Zelle zu löschen.Press D,D to delete the current cell.

eine-Zelle-löschen

Reduzieren einer ZelleneingabeCollapse a cell input

Klicken Sie am unteren Rand der aktuellen Zelle auf die Pfeilschaltfläche, um sie zu reduzieren.Click the arrow button at the bottom of the current cell to collapse it. Um sie zu erweitern, klicken Sie auf die Pfeilschaltfläche, während die Zelle reduziert ist.To expand it, click the arrow button while the cell is collapsed.

Zelleneingabe-reduzieren

Reduzieren einer ZellenausgabeCollapse a cell output

Klicken Sie links oben in der aktuellen Zellenausgabe auf die Schaltfläche Ausgabe reduzieren, um sie zu reduzieren.Click the collapse output button at the upper left of the current cell output to collapse it. Um sie zu erweitern, klicken Sie auf Zellenausgabe anzeigen, während die Zellenausgabe reduziert ist.To expand it, click the Show cell output while the cell output is collapsed.

Zellenausgabe-reduzieren

Ausführen von NotebooksRun notebooks

Sie können die Codezellen in Ihrem Notebook einzeln oder alle gleichzeitig ausführen.You can run the code cells in your notebook individually or all at once. Status und Fortschritt jeder Zelle werden im Notebook dargestellt.The status and progress of each cell is represented in the notebook.

Ausführen einer ZelleRun a cell

Es gibt mehrere Methoden, um den Code in einer Zelle auszuführen.There are several ways to run the code in a cell.

  1. Zeigen Sie mit dem Mauszeiger auf die Zelle, die Sie ausführen möchten, und wählen Sie die Schaltfläche Zelle ausführen aus, oder drücken Sie STRG+EINGABE.Hover on the cell you want to run and select the Run Cell button or press Ctrl+Enter.

    Zelle-1-ausführen

  2. Um ganz rechts auf das Menü mit zusätzlichen Zellenaktionen zuzugreifen, wählen Sie die Auslassungspunkte ( ... ) aus. Wählen Sie anschließend Zelle ausführen aus.To Access the additional cell actions menu at the far right, select the ellipses (...). Then, select Run cell.

    Zelle-2-ausführen

  3. Verwenden Sie Tastenkombinationen im Befehlsmodus.Use Shortcut keys under command mode. Drücken Sie UMSCHALT+EINGABE, um die aktuelle Zelle auszuführen und die Zelle darunter auszuwählen.Press Shift+Enter to run the current cell and select the cell below. Drücken Sie ALT+EINGABE, um die aktuelle Zelle auszuführen und darunter eine neue Zelle einzufügen.Press Alt+Enter to run the current cell and insert a new cell below.

Ausführen aller ZellenRun all cells

Klicken Sie auf die Schaltfläche Alle ausführen, um alle Zellen im aktuellen Notebook nacheinander auszuführen.Click the Run All button to run all the cells in current notebook in sequence.

alle-Zellen-ausführen

Ausführen aller darüber- oder darunterliegenden ZellenRun all cells above or below

Um ganz rechts auf das Menü mit zusätzlichen Zellenaktionen zuzugreifen, wählen Sie die Auslassungspunkte ( ... ) aus. Wählen Sie dann Zellen oberhalb ausführen aus, um alle Zellen oberhalb der aktuellen nacheinander auszuführen.To Access the additional cell actions menu at the far right, select the ellipses (...). Then, select Run cells above to run all the cells above the current in sequence. Wählen Sie Zellen unterhalb ausführen aus, um alle Zellen unterhalb der aktuellen nacheinander auszuführen.Select Run cells below to run all the cells below the current in sequence.

Zellen-oberhalb-oder-unterhalb-ausführen

Abbrechen aller ausgeführten ZellenCancel all running cells

Klicken Sie auf die Schaltfläche Alle abbrechen, um die ausgeführten oder in der Warteschlange wartenden Zellen abzubrechen.Click the Cancel All button to cancel the running cells or cells waiting in the queue. cancel-all-cellscancel-all-cells

ZellenstatusindikatorCell status indicator

Unterhalb der Zelle wird ein schrittweiser Zellenausführungsstatus angezeigt, damit Sie den aktuellen Fortschritt verfolgen können.A step-by-step cell execution status is displayed beneath the cell to help you see its current progress. Nachdem die Ausführung der Zelle abgeschlossen wurde, wird eine Ausführungszusammenfassung mit Gesamtdauer und Endzeit angezeigt, die zur späteren Bezugnahme dort auch aufbewahrt wird.Once the cell run is complete, an execution summary with the total duration and end time are shown and kept there for future reference.

Zellenstatus

Spark-StatusanzeigeSpark progress indicator

Ein Azure Synapse Studio-Notebook ist vollständig Spark-basiert.Azure Synapse Studio notebook is purely Spark based. Codezellen werden remote im Spark-Pool ausgeführt.Code cells are executed on the Spark pool remotely. Eine Spark-Auftragsstatusanzeige wird mit einem Statusbalken in Echtzeit angezeigt, um Ihnen den Status der Auftragsausführung zu verdeutlichen.A Spark job progress indicator is provided with a real-time progress bar appears to help you understand the job execution status. Anhand der Anzahl der Aufgaben pro Auftrag oder Phase können Sie die parallele Ebene Ihres Spark-Auftrags identifizieren.The number of tasks per each job or stage help you to identify the parallel level of your spark job. Sie können außerdem die Spark-Benutzeroberfläche eines spezifischen Auftrags (oder einer Phase) erweitern, indem Sie auf den Link im Auftragsnamen (oder Phasennamen) klicken.You can also drill deeper to the Spark UI of a specific job (or stage) via clicking the link on the job (or stage) name.

Spark-Statusanzeige

Spark-SitzungskonfigurationSpark session config

Sie können in Sitzung konfigurieren die Timeoutdauer sowie die Anzahl und Größe der Executors angeben, die für die aktuelle Spark-Sitzung gelten sollen.You can specify the timeout duration, the number, and the size of executors to give to the current Spark session in Configure session. Sie müssen die Spark-Sitzung neu starten, damit die Konfigurationsänderungen wirksam werden.Restart the Spark session is for configuration changes to take effect. Alle zwischengespeicherten Notebook-Variablen werden gelöscht.All cached notebook variables are cleared.

session-managementsession-management

Im Spark-Sitzungskonfigurationsbereich ist nun eine Spark-Sitzungsempfehlung verfügbar.A spark session recommender now available on spark session config panel. Sie können einen Spark-Pool direkt aus dem Sitzungskonfigurationsbereich auswählen und einsehen, wie viele Knoten verwendet werden und wie viele verbleibende Executors verfügbar sind.You can select a spark pool directly from the session configuration panel and see how many nodes are using and how many remaining executors are available. Diese Informationen können Sie beim richtigen Festlegen der Sitzungsgröße unterstützen, sodass Sie diese nicht immer wieder neu anpassen müssen.These info can help you to set session size appropriately rather than modifying it back and forth.

session-recommend

Einfügen von Daten in ein NotebookBring data to a notebook

Sie können Daten aus Azure Blob Storage, Azure Data Lake Store Gen 2 und dem SQL-Pool laden, wie in den folgenden Codebeispielen gezeigt.You can load data from Azure Blob Storage, Azure Data Lake Store Gen 2, and SQL pool as shown in the code samples below.

Lesen einer CSV-Datei aus Azure Data Lake Store Gen2 als Spark-DatenrahmenRead a CSV from Azure Data Lake Store Gen2 as a Spark DataFrame

from pyspark.sql import SparkSession
from pyspark.sql.types import *
account_name = "Your account name"
container_name = "Your container name"
relative_path = "Your path"
adls_path = 'abfss://%s@%s.dfs.core.windows.net/%s' % (blob_container_name, blob_account_name,  blob_relative_path)

spark.conf.set("fs.azure.account.auth.type.%s.dfs.core.windows.net" %account_name, "SharedKey")
spark.conf.set("fs.azure.account.key.%s.dfs.core.windows.net" %account_name ,"Your ADLSg2 Primary Key")

df1 = spark.read.option('header', 'true') \
                .option('delimiter', ',') \
                .csv(adls_path + '/Testfile.csv')

Lesen einer CSV-Datei aus Azure Blob Storage als Spark-DatenrahmenRead a CSV from Azure Blob Storage as a Spark DataFrame


from pyspark.sql import SparkSession
from pyspark.sql.types import *

blob_account_name = "Your blob account name"
blob_container_name = "Your blob container name"
blob_relative_path = "Your blob relative path"
blob_sas_token = "Your blob sas token"

wasbs_path = 'wasbs://%s@%s.blob.core.windows.net/%s' % (blob_container_name, blob_account_name, blob_relative_path)
spark.conf.set('fs.azure.sas.%s.%s.blob.core.windows.net' % (blob_container_name, blob_account_name), blob_sas_token)

df = spark.read.option("header", "true") \
            .option("delimiter","|") \
            .schema(schema) \
            .csv(wasbs_path)

Lesen von Daten aus einem primären SpeicherkontoRead data from the primary storage account

Sie können auf Daten im primären Speicherkonto direkt zugreifen.You can access data in the primary storage account directly. Es besteht keine Notwendigkeit, die geheimen Schlüssel bereitzustellen.There's no need to provide the secret keys. Klicken Sie im Daten-Explorer mit der rechten Maustaste auf eine Datei, und wählen Sie Neues Notebook aus, um ein neues Notebook mit einem automatisch generierten Datenextraktor anzuzeigen.In Data Explorer, right-click on a file and select New notebook to see a new notebook with data extractor autogenerated.

Daten-in-Zelle

Visualisieren von Daten in einem NotebookVisualize data in a notebook

Erzeugen einer gerenderten TabellenansichtProduce rendered table view

Eine tabellarische Ergebnisansicht wird zusammen mit der Möglichkeit zum Erstellen eines Balkendiagramms, eines Liniendiagramms, eines Kreisdiagramms, eines Punktdiagramms und eines Flächendiagramms bereitgestellt.A tabular results view is provided with the option to create a bar chart, line chart, pie chart, scatter chart, and area chart. Sie können Ihre Daten visualisieren, ohne Code schreiben zu müssen.You can visualize your data without having to write code. Die Diagramme lassen sich in den Diagrammoptionen anpassen.The charts can be customized in the Chart Options.

Die Ausgabe der %%sql-Magic-Befehle wird standardmäßig in der gerenderten Tabellenansicht angezeigt.The output of %%sql magic commands appear in the rendered table view by default. Sie können display(df) für Spark-Datenrahmen aufrufen oder die Funktion „Resilient Distributed Datasets“ (RDD) verwenden, um die gerenderte Tabellenansicht zu erzeugen.You can call display(df) on Spark DataFrames or Resilient Distributed Datasets (RDD) function to produce the rendered table view.

integrierte-Diagrammebuiltin-charts

Visualisieren von integrierten Diagrammen aus umfangreichen DatasetsVisualize built-in charts from large-scale dataset

Die display(df)-Funktion erfasst standardmäßig nur die ersten 1.000 Zeilen der Daten zum Rendern der Diagramme.By default the display(df) function will only take the first 1000 rows of the data to render the charts. Überprüfen Sie die Gesamtergebnisse der Aggregation, und klicken Sie auf Anwenden, um die Diagrammgenerierung auf das gesamte Dataset anzuwenden.Check the Aggregation over all results and click Apply button, you will apply the chart generation from the whole dataset. Ein Spark-Auftrag wird ausgelöst, wenn die Diagrammeinstellung geändert wird. Es dauert eine Weile, bis die Berechnung abgeschlossen und das Diagramm gerendert wird.A spark job will be triggered when the chart setting changes, it takes a while to complete the calculation and render the chart. builtin-charts-aggregation-allbuiltin-charts-aggregation-all

Visualisieren von statistischen DateninformationenVisualize data statistic information

Sie können display(df, summary = true) verwenden, um die statistische Zusammenfassung eines jeweiligen Spark-Datenrahmens zu überprüfen, dazu gehören Spaltennamen, Spaltentypen, eindeutige Werte und fehlende Werte für jede Spalte.You can use display(df, summary = true) to check the statistics summary of a given spark DataFrame that include the column name, column type, unique values, and missing values for each column. Sie können auch eine spezifische Spalte auswählen, um ihren Mindestwert, Höchstwert, Durchschnittswert und die Standardabweichung anzuzeigen.You can also select on specific column to see its Minimal value, Maximal value, Mean value and Standard Deviation. builtin-charts-summary builtin-charts-summary

Rendern von HTML oder interaktiven BibliothekenRender HTML or interactive libraries

Sie können HTML-oder interaktive Bibliotheken wie bokeh mithilfe von displayHTML() rendern.You can render HTML or interactive libraries, like bokeh, using the displayHTML().

Das folgende Bild ist ein Beispiel für das Zeichnen von Glyphen auf einer Karte mithilfe von bokeh.The following image is an example of plotting glyphs over a map using bokeh.

bokeh-Beispiel

Führen Sie den folgenden Beispielcode aus, um das obige Bild zu zeichnen.Run the following sample code to draw the image above.

from bokeh.plotting import figure, output_file
from bokeh.tile_providers import get_provider, Vendors
from bokeh.embed import file_html
from bokeh.resources import CDN
from bokeh.models import ColumnDataSource

tile_provider = get_provider(Vendors.CARTODBPOSITRON)

# range bounds supplied in web mercator coordinates
p = figure(x_range=(-9000000,-8000000), y_range=(4000000,5000000),
           x_axis_type="mercator", y_axis_type="mercator")
p.add_tile(tile_provider)

# plot datapoints on the map
source = ColumnDataSource(
    data=dict(x=[ -8800000, -8500000 , -8800000],
              y=[4200000, 4500000, 4900000])
)

p.circle(x="x", y="y", size=15, fill_color="blue", fill_alpha=0.8, source=source)

# create an html document that embeds the Bokeh plot
html = file_html(p, CDN, "my plot1")

# display this html
displayHTML(html)

Speichern von NotebooksSave notebooks

Sie können ein einzelnes Notebook oder alle Notebooks in Ihrem Arbeitsbereich speichern.You can save a single notebook or all notebooks in your workspace.

  1. Um an einem einzelnen Notebook vorgenommene Änderungen zu speichern, wählen Sie auf der Notebook-Befehlsleiste die SchaltflächeVeröffentlichen aus.To save changes you made to a single notebook, select the Publish button on the notebook command bar.

    Notebook-veröffentlichen

  2. Um alle Notebooks in Ihrem Arbeitsbereich zu speichern, wählen Sie die Schaltfläche Alle veröffentlichen auf der Befehlsleiste des Arbeitsbereichs aus.To save all notebooks in your workspace, select the Publish all button on the workspace command bar.

    alle-veröffentlichen

In den Notebook-Eigenschaften können Sie konfigurieren, ob die Zellenausgabe beim Speichern eingeschlossen werden soll.In the notebook properties, you can configure whether to include the cell output when saving.

Notebook-Eigenschaften

Magic-BefehleMagic commands

Sie können Ihre vertrauten Jupyter-Magic-Befehle in Azure Synapse Studio-Notebooks verwenden.You can use your familiar Jupyter magic commands in Azure Synapse Studio notebooks. Überprüfen Sie die nachstehende Liste mit den aktuellen verfügbaren Magic-Befehlen.Check the list below as the current available magic commands. Teilen Sie uns Ihre Anwendungsfälle auf GitHub mit, damit wir weitere Magic-Befehle erstellen können, um Ihre Anforderungen zu erfüllen.Tell us your use cases on GitHub so that we can continue to build out more magic commands to meet your needs.

Verfügbare Magic-Befehle für Zeilen: %lsmagic, %time, %time itAvailable line magics: %lsmagic, %time, %time it

Verfügbare Zellen-Magics: %%time, %%timeit, %%capture, %%writefile, %%sql, %%pyspark, %%spark, %%csharpAvailable cell magics: %%time, %%timeit, %%capture, %%writefile, %%sql, %%pyspark, %%spark, %%csharp

Orchestrieren von NotebooksOrchestrate notebook

Hinzufügen eines Notebooks zu einer PipelineAdd a notebook to a pipeline

Klicken Sie in der oberen rechten Ecke auf Zur Pipeline hinzufügen, um ein Notebook zu einer vorhandenen Pipeline hinzuzufügen oder eine neue Pipeline zu erstellen.Click the Add to pipeline button on the upper right corner to add a notebook to an existing pipeline or create a new pipeline.

add-to-pipeline

Festlegen einer ParameterzelleDesignate a parameters cell

Klicken Sie zum Parametrisieren Ihres Notebooks auf die Auslassungspunkte (...), um auf Menü für zusätzliche Zellenaktionen ganz rechts zuzugreifen.To parameterize your notebook select the ellipses (...) to access the additional cell actions menu at the far right. Klicken Sie dann auf Parameterzelle umschalten, um die Zelle als Parameterzelle festzulegen.Then select Toggle parameter cell to designate the cell as the parameters cell.

toggle-parameter

Azure Data Factory sucht nach der Parameterzelle und behandelt diese Zelle als Standard für die Parameter, die zur Ausführungszeit übermittelt werden.Azure Data Factory looks for the parameters cell and treats this cell as defaults for the parameters passed in at execution time. Die Ausführungs-Engine fügt eine neue Zelle mit Eingabeparametern unter der Parameterzelle hinzu, um die Standardwerte zu überschreiben.Execution engine will add a new cell beneath the parameters cell with input parameters in order to overwrite the default values. Wenn keine Parameterzelle festgelegt wird, wird die Zelle ganz oben im Notebook eingefügt.When there is no parameters cell is designated the injected cell will be inserted at the top of the notebook.

Zuweisen von Parameterwerten über eine PipelineAssign parameters values from a pipeline

Sobald Sie ein Notebook mit Parametern erstellt haben, können Sie dieses über eine Pipeline mit der Azure Synapse Analytics-Aktivität ausführen.Once you've created a notebook with parameters, you can execute it from a pipeline with the Azure Synapse Notebook activity. Nachdem Sie die Aktivität zu Ihrem Pipelinecanvas hinzugefügt haben, können Sie die Parameterwerte auf der Registerkarte Einstellungen im Abschnitt Basisparameter festlegen.After you add the activity to your pipeline canvas, you will be able to set the parameters values under Base parameters section on the Settings tab.

assign-parameter

Beim Zuweisen von Parameterwerten können Sie die Pipelineausdruckssprache oder Systemvariablen verwenden.When assigning parameter values, you can use the pipeline expression language or system variables.

TastenkombinationenShortcut keys

Ähnlich wie Jupyter-Notebooks verfügen Azure Synapse Studio-Notebooks über eine modale Benutzeroberfläche.Similar to Jupyter Notebooks, Azure Synapse Studio notebooks have a modal user interface. Mit der Tastatur werden unterschiedliche Aktionen ausgeführt, je nachdem, in welchem Modus sich die Notebook-Zelle befindet.The keyboard does different things depending on which mode the notebook cell is in. Synapse Studio-Notebooks unterstützen die folgenden zwei Modi für eine bestimmte Codezelle: Befehlsmodus und Bearbeitungsmodus.Synapse Studio notebooks support the following two modes for a given code cell: command mode and edit mode.

  1. Eine Zelle befindet sich im Befehlsmodus, wenn Sie kein Textcursor zur Eingabe auffordert.A cell is in command mode when there is no text cursor prompting you to type. Wenn sich eine Zelle im Befehlsmodus befindet, können Sie das Notebook als Ganzes bearbeiten, aber keine Eingaben in einzelne Zellen vornehmen.When a cell is in Command mode, you can edit the notebook as a whole but not type into individual cells. Sie wechseln in den Befehlsmodus, indem Sie ESC drücken oder mit der Maus außerhalb des Editor-Bereichs einer Zelle klicken.Enter command mode by pressing ESC or using the mouse to click outside of a cell's editor area.

    Befehlsmodus

  2. Der Bearbeitungsmodus wird durch einen Textcursor angezeigt, der Sie zur Eingabe im Editor-Bereich auffordert.Edit mode is indicated by a text cursor prompting you to type in the editor area. Wenn sich eine Zelle im Bearbeitungsmodus befindet, können Sie etwas in die Zelle eingeben.When a cell is in edit mode, you can type into the cell. Sie wechseln in den Bearbeitungsmodus, indem Sie Enter drücken oder mit der Maus auf den Editor-Bereich einer Zelle klicken.Enter edit mode by pressing Enter or using the mouse to click on a cell's editor area.

    Bearbeitungsmodus

Tastenkombinationen im BefehlsmodusShortcut keys under command mode

Mithilfe der folgenden Tastenkombinationen können Sie in Azure Synapse-Notebooks leichter navigieren und Code ausführen.Using the following keystroke shortcuts, you can more easily navigate and run code in Azure Synapse notebooks.

AktionAction Tastenkombinationen für Synapse Studio-NotebooksSynapse Studio notebook Shortcuts
Aktuelle Zelle ausführen und die darunter auswählenRun the current cell and select below UMSCHALT+EINGABEShift+Enter
Aktuelle Zelle ausführen und darunter einfügenRun the current cell and insert below ALT+EINGABEAlt+Enter
Zelle darüber auswählenSelect cell above Nach obenUp
Zelle darunter auswählenSelect cell below Nach untenDown
Zelle oberhalb einfügenInsert cell above EinA
Zelle unterhalb einfügenInsert cell below BB
Ausgewählte Zellen nach oben erweiternExtend selected cells above UMSCHALT+NACH-OBENShift+Up
Ausgewählte Zellen nach unten erweiternExtend selected cells below UMSCHALT+NACH-UNTENShift+Down
Zelle nach oben verschiebenMove cell up STRG+ALT+↑Ctrl+Alt+↑
Zelle nach unten verschiebenMove cell down STRG+ALT+↓Ctrl+Alt+↓
Ausgewählte Zellen löschenDelete selected cells D, DD, D
In den Bearbeitungsmodus wechselnSwitch to edit mode EINGABETASTEEnter

Tastenkombinationen im BearbeitungsmodusShortcut keys under edit mode

Mithilfe der folgenden Tastenkombinationen können Sie in Azure Synapse-Notebooks leichter navigieren und Code ausführen, während sie sich im Bearbeitungsmodus befinden.Using the following keystroke shortcuts, you can more easily navigate and run code in Azure Synapse notebooks when in Edit mode.

AktionAction Tastenkombinationen für Synapse Studio-NotebooksSynapse Studio notebook shortcuts
Cursor nach oben verschiebenMove cursor up Nach obenUp
Cursor nach unten verschiebenMove cursor down Nach untenDown
RückgängigUndo STRG+ZCtrl + Z
WiederholenRedo STRG+YCtrl + Y
Auskommentieren/Auskommentierung aufhebenComment/Uncomment STRG+/Ctrl + /
Wort davor löschenDelete word before STRG+RÜCKTASTECtrl + Backspace
Wort danach löschenDelete word after STRG+DELETECtrl + Delete
Zum Anfang der Zelle wechselnGo to cell start STRG+POS1Ctrl + Home
Zum Ende der Zelle wechselnGo to cell end STRG+ENDECtrl + End
Ein Wort nach links wechselnGo one word left STRG+NACH-LINKSCtrl + Left
Ein Wort nach rechts wechselnGo one word right STRG+NACH-RECHTSCtrl + Right
Alle auswählenSelect all STRG+ACtrl + A
EinziehenIndent STRG+]Ctrl + ]
Einzug entfernenDedent STRG+[Ctrl + [
In den Befehlsmodus wechselnSwitch to command mode EscEsc

Nächste SchritteNext steps