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.
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.
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
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.
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
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}...
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 bereitopenConnectionDialog
: Öffnet das Verbindungsdialogfeld mithilfe der bereitgestellten 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. |
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.
azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql
azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}