Läs på engelska

Dela via


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).

Skärmbild av kommandoradsutdata för Azure Data Studio.

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.

Hjälp om kommandorad

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

Starta från kommandoraden

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.

Starta med Power Query-redigeraren

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

Starta med hjälp av URI

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}...

Kommandon som stöds

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 alternativen
  • openConnectionDialog: Öppnar anslutningsdialogrutan med de angivna alternativen

Alternativ som stöds

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, Integratedoch 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"}.

Exempel

Kommandotolk: Integrerad autentisering

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.

Kommandotolk: Starta Azure Data Studio med ett sparat skript

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

Webbläsare

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

Nästa steg