Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Funktionen der SQL-Erweiterung im JupyterLab SQL-Editor Die SQL-Erweiterung bietet magische Befehle, die die Funktionen des SQL-Editors in Ihren JupyterLab Notebook-Zellen aktivieren. Wenn Sie die Version 1.6 des SageMaker Distributions-Images verwenden, müssen Sie die Magic Library der SQL-Erweiterung laden, indem Sie sie `%load_ext amazon_sagemaker_sql_magic` in einem JupyterLab Notizbuch ausführen. Dadurch werden Funktionen zur SQL-Bearbeitung aktiviert. Für Benutzer der SageMaker Distributions-Image-Versionen 1.7 und höher ist keine Aktion erforderlich, die SQL-Erweiterung wird automatisch geladen. Sobald die Erweiterung geladen ist, fügen Sie den `%%sm_sql` magischen Befehl am Anfang einer Zelle hinzu, um die folgenden Funktionen des SQL-Editors zu aktivieren. + **Dropdownmenü zur Verbindungsauswahl**: Wenn Sie einer Zelle einen `%%sm_sql` magischen Befehl hinzufügen, erscheint oben in der Zelle ein Dropdownmenü mit Ihren verfügbaren Datenquellenverbindungen. Wählen Sie eine Verbindung aus, um automatisch die Parameter einzugeben, die für die Abfrage dieser Datenquelle erforderlich sind. Im Folgenden finden Sie ein Beispiel für eine `%%sm_sql` magische Befehlszeichenfolge, die durch Auswahl der genannten Verbindung generiert wird`connection-name`. ``` %%sm_sql --metastore-type GLUE_CONNECTION --metastore-id connection-name ``` Verwenden Sie die folgenden Funktionen des SQL-Editors, um Ihre SQL-Abfragen zu erstellen, und führen Sie dann die Abfrage aus, indem Sie die Zelle ausführen. Weitere Hinweise zu den SQL-Ausführungsfunktionen finden Sie unter [Funktionen der SQL-Erweiterung zur JupyterLab SQL-Ausführung](sagemaker-sql-extension-features-sql-execution.md). + **Dropdownmenü mit Abfrageergebnissen**: Sie können angeben, wie Abfrageergebnisse gerendert werden sollen, indem Sie im Dropdownmenü neben Ihrem Dropdownmenü zur Verbindungsauswahl einen Ergebnistyp auswählen. Wählen Sie zwischen den folgenden zwei Alternativen: + **Zellenausgabe**: (Standard) Mit dieser Option wird das Ergebnis Ihrer Abfrage im Zellenausgabebereich des Notebooks angezeigt. + **Pandas Dataframe**: Diese Option füllt einen Pandas DataFrame mit den Abfrageergebnissen. In einem zusätzlichen Eingabefeld können Sie angeben, DataFrame wann Sie diese Option wählen. + **SQL-Syntaxhervorhebung**: Die Zelle unterscheidet SQL-Schlüsselwörter, -Klauseln, Operatoren und mehr automatisch visuell anhand von Farbe und Stil. Dadurch ist SQL-Code einfacher zu lesen und zu verstehen. Schlüsselwörter wie`SELECT`, `FROM``WHERE`, und integrierte Funktionen wie `SUM` und `COUNT` oder Klauseln wie `GROUP BY` und mehr werden in einer anderen Farbe und Fettschrift hervorgehoben. + **SQL-Formatierung**: Auf eine der folgenden Arten können Sie einheitliche Einzüge, Groß-/Kleinschreibung, Abstände und Zeilenumbrüche anwenden, um SQL-Anweisungen und -Klauseln zu gruppieren oder zu trennen. Dadurch ist SQL-Code einfacher zu lesen und zu verstehen. + Klicken Sie mit der rechten Maustaste auf die SQL-Zelle und wählen Sie **SQL formatieren**. + Wenn die SQL-Zelle im Fokus ist, verwenden Sie die Tastenkombination *ALT \$1 F* unter Windows oder *Option \$1 F* unter macOS. + **Automatische SQL-Vervollständigung**: Die Erweiterung bietet während der Eingabe automatische Vorschläge und Vervollständigung von SQL-Schlüsselwörtern, Funktionen, Tabellennamen, Spaltennamen und mehr. Wenn Sie mit der Eingabe eines SQL-Schlüsselworts wie `SELECT` oder beginnen`WHERE`, zeigt die Erweiterung ein Pop-up mit Vorschlägen zur automatischen Vervollständigung des restlichen Worts an. Wenn Sie beispielsweise Tabellen- oder Spaltennamen eingeben, werden passende Tabellen- und Spaltennamen vorgeschlagen, die im Datenbankschema definiert sind. **Wichtig** Um die automatische SQL-Vervollständigung in JupyterLab Notebooks zu aktivieren, müssen Benutzer der Image-Version 1.6 der SageMaker AI-Distribution den folgenden `npm install -g vscode-jsonrpc sql-language-server` Befehl in einem Terminal ausführen. Starten Sie den JupyterLab Server nach Abschluss der Installation neu, indem Sie Folgendes ausführen`restart-jupyter-server`. Für Benutzer der SageMaker Distributions-Image-Versionen 1.7 und höher ist keine Aktion erforderlich. Die Zelle bietet zwei Methoden zur automatischen Vervollständigung erkannter SQL-Schlüsselwörter: + Expliziter Aufruf (empfohlen): Wählen Sie die **Tabulatortaste**, um das kontextsensitive Vorschlagsmenü aufzurufen, und **drücken Sie dann die EINGABETASTE**, um das vorgeschlagene Element zu akzeptieren. + Kontinuierlicher Hinweis: Die Zelle schlägt während der Eingabe automatisch Vervollständigungen vor. **Anmerkung** Die automatische Vervollständigung wird nur ausgelöst, wenn die SQL-Schlüsselwörter in Großbuchstaben geschrieben sind. Beispielsweise wird bei der `SEL` Eingabe nach gefragt`SELECT`, bei der Eingabe `sel` jedoch nicht. Wenn Sie zum ersten Mal eine Verbindung zu einer Datenquelle herstellen, indexiert die automatische SQL-Vervollständigung die Metadaten der Datenquelle. Dieser Indizierungsvorgang kann je nach Größe Ihrer Datenbanken einige Zeit in Anspruch nehmen.