Azure Data Studio-kommandoradsgränssnittet
Azure Data Studio innehåller ett inbyggt kommandoradsgränssnitt som gör att du kan styra hur du startar programmet. Du kan öppna filer, installera tillägg, ändra visningsspråket och mata ut diagnostik via kommandoradsalternativ (växlar).
Exempel på hur du kör kommandoradsverktyg i Azure Data Studio finns i Integrerad terminal.
Anteckning
Även om Microsoft Entra-ID är det nya namnet på Azure Active Directory (Azure AD), för att förhindra avbrott i befintliga miljöer, förblir Azure AD fortfarande i vissa hårdkodade element som gränssnittsfält, anslutningsproviders, felkoder och cmdletar. I den här artikeln är de två namnen utbytbara.
Om du vill visa en översikt över Azure Data Studio-kommandoradsgränssnittet öppnar du en terminal i Azure Data Studio (Visa > terminal) eller en kommandotolk och skriver azuredatastudio --help
. Utdata innehåller version, användningsexempel och lista över kommandoradsalternativ, som visas i det trunkerade exemplet:
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
Du kan starta Azure Data Studio från kommandoraden för att snabbt öppna en fil, mapp eller ett projekt. Vanligtvis öppnar du Azure Data Studio i kontexten för en mapp. Från en öppen terminal eller kommandotolk navigerar du till projektmappen och skriver azuredatastudio
.
Ibland kanske du vill öppna ett skript i Power Query-redigeraren när du öppnar Azure Data Studio. Du kan starta Azure Data Studio med ett befintligt skript genom att ange sökvägen till filen:
azuredatastudio .\samplescript.sql
Du kan starta Azure Data Studio från webbläsaren med hjälp av URL-format för att snabbt upprätta anslutning vid start eller öppna en anslutningsdialogruta, om du vill öppna ett skript i Power Query-redigeraren. Formatet som stöds för att starta med URI är:
azuredatastudio://{command}?{option1}={value1}&{option2}={value2}...
Följande kommandon stöds när du startar Azure Data Studio från en kommandorad:
connect
: Ansluter till målservern med hjälp av de angivna alternativenopenConnectionDialog
: Öppnar anslutningsdialogrutan med de angivna alternativen
Följande alternativ kan anges i URL:en.
Alternativ | Description |
---|---|
provider |
Anslutningsprovider som ska användas, till exempel MSSQL, PGSQL och så vidare. |
server |
Namn på målserver eller värdnamn. |
database |
Namnet på databasen. |
user |
Användarens namn. |
authenticationType |
Autentiseringsläge som ska användas, accepterade värden: AzureMFA , SqlLogin , Integrated och så vidare. |
applicationName |
Ange ett programnamn som används i anslutningsprofilen. |
connectionProperties |
Avancerade anslutningsegenskaper som en provider stöder. Värdet måste vara ett json-objekt som innehåller nyckel/värde-par i formatet {"key1":"value1"} . |
azuredatastudio --server localhost --authenticationType Integrated
Du kan uppmanas med en varning om "Betrodd servercertifikat".
Anteckning
För användare som ansluter till en lokal SQL Server eller SQL Server på en virtuell dator måste databasmotorn konfigureras för att stödja krypterade anslutningar. Fullständiga instruktioner finns i Konfigurera SQL Server Database Engine för kryptering av anslutningar.
azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql
azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}