Auf Englisch lesen

Freigeben über


Die Azure Data Studio-Befehlszeilenschnittstelle

Azure Data Studio enthält eine integrierte Befehlszeilenschnittstelle, mit der Sie steuern können, wie Sie die Anwendung starten. Sie können Dateien öffnen, Erweiterungen installieren, die Anzeigesprache ändern und die Ausgabediagnose über Befehlszeilenoptionen (Schalter) ausführen.

Screenshot der Befehlszeilenausgabe in Azure Data Studio

Beispiele für das Ausführen von Befehlszeilentools in Azure Data Studio finden Sie unter Integriertes Terminal.

Hinweis

Während Microsoft Entra-ID der neue Name für Azure Active Directory (Azure AD) ist, bleibt Azure AD in einigen fest kodierten Elementen wie Benutzeroberfläche-Feldern, Verbindungsanbietern, Fehlercodes und Cmdlets erhalten, um Störungen in bestehenden Umgebungen zu vermeiden. In diesem Artikel sind die beiden Namen austauschbar.

Befehlszeilenhilfe

Um eine Übersicht über die Befehlszeilenschnittstelle von Azure Data Studio anzuzeigen, öffnen Sie ein Terminal in Azure Data Studio (Anzeigen > Terminal) oder eine Eingabeaufforderung und geben Sie azuredatastudio --help ein. Die Ausgabe enthält die Version, das Verwendungsbeispiel und die Liste der Befehlszeilenoptionen, wie im abgeschnittenen Beispiel gezeigt:

Azure Data Studio 1.48.1

Usage: azuredatastudio.exe [options][paths...]

To read output from another program, append '-' (e.g. 'echo Hello World | azuredatastudio.exe -')

Options

  <vscode options>

  -h --help                                  Print usage.
  --aad                                      Use Azure Active Directory authentication, this option is
                                             deprecated - use 'authenticationType' instead.
  -A --applicationName                       Supports providing applicationName
                                             that will be used for connection profile app name.
  -T --authenticationType                    Provide authentication mode to be
                                             used. Accepted values: AzureMFA, SqlLogin, Integrated, etc.
  -c --command <command-name>                Name of command to run, accepted
                                             values: connect, openConnectionDialog
  -Z --connectionProperties                  Supports providing advanced connection properties that
                                             providers support. Value must be a json object containing
                                             key-value pairs in format: '{"key1":"value1"}'
  -D --database <database>                   Name of database
  -E --integrated                            Use Integrated authentication,
                                             this option is deprecated - use 'authenticationType' instead.
  -P --provider                              Connection provider to use, e.g. MSSQL, PGSQL, etc.
  -S --server <server>                       Name of target server or host name.
  --showDashboard                            Whether or not to show dashboard on connection, false by default.
  -U --user <user-name>                      User name/email address

Starten von der Befehlszeile aus

Sie können Azure Data Studio über die Befehlszeile starten, um schnell eine Datei, einen Ordner oder ein Projekt zu öffnen. In der Regel öffnen Sie Azure Data Studio im Kontext eines Ordners. Navigieren Sie in einem geöffneten Terminal oder einer Eingabeaufforderung zu Ihrem Projektordner und geben Sie azuredatastudio ein.

Starten mit dem Abfrage-Editor

Manchmal möchten Sie beim Öffnen von Azure Data Studio vielleicht ein Skript im Abfrage-Editor öffnen. Sie können Azure Data Studio mit einem vorhandenen Skript starten, indem Sie den Pfad der Datei angeben:

azuredatastudio .\samplescript.sql

Starten mit URI

Sie können Azure Data Studio vom Browser aus über das URL-Format starten, um beim Start schnell eine Verbindung herzustellen, oder ein Verbindungsdialogfeld öffnen und optional ein Skript im Abfrage-Editor öffnen. Das unterstützte Format für den Start mit URI lautet:

azuredatastudio://{command}?{option1}={value1}&{option2}={value2}...

Unterstützte Befehle

Die folgenden Befehle werden beim Starten von Azure Data Studio über eine Befehlszeile unterstützt:

  • connect: Stellt mithilfe der bereitgestellten Optionen eine Verbindung mit dem Zielserver bereit
  • openConnectionDialog: Öffnet das Verbindungsdialogfeld mithilfe der bereitgestellten Optionen

Unterstützte Optionen

Die folgenden Optionen können in der URL angegeben werden:

Option Beschreibung
provider Verbindungsanbieter, der verwendet werden soll, z. B. MSSQL, PGSQL usw.
server Name des Zielservers oder Hostname
database Name der Datenbank
user Name des Benutzers
authenticationType Der zu verwendende Authentifizierungsmodus, akzeptierte Werte: AzureMFA, SqlLogin, Integrated usw.
applicationName Geben Sie einen Anwendungsnamen an, der im Verbindungsprofil verwendet wird
connectionProperties Erweiterte Verbindungseigenschaften, die ein Anbieter unterstützt. Der Wert muss ein JSON-Objekt sein, das Schlüssel-Wert-Paare im Format {"key1":"value1"} enthält.

Beispiele

Eingabeaufforderung: Integrierte Authentifizierung

azuredatastudio --server localhost --authenticationType Integrated

Möglicherweise erhalten Sie die Warnung „Serverzertifikat vertrauen“.

Hinweis

Für Benutzer, die eine Verbindung mit einem lokalen SQL Server oder SQL Server auf einem virtuellen Computer herstellen, muss die Datenbank-Engine so konfiguriert werden, dass sie verschlüsselte Verbindungen unterstützt. Eine vollständige Anleitung finden Sie unter Konfigurieren der SQL Server-Datenbank-Engine zum Verschlüsseln von Verbindungen.

Eingabeaufforderung: Azure Data Studio mit einem gespeicherten Skript starten

azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql

Browser

azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}

Nächste Schritte