Interfaccia della riga di comando di Azure Data Studio

2025-04-08

Importante

Azure Data Studio ritira il 28 febbraio 2026. È consigliabile usare Visual Studio Code. Per altre informazioni sulla migrazione a Visual Studio Code, vedere Che cosa accade in Azure Data Studio?

Azure Data Studio include un'interfaccia della riga di comando predefinita che consente di controllare come avviare l'applicazione. È possibile aprire file, installare estensioni, modificare la lingua di visualizzazione e la diagnostica di output tramite le opzioni della riga di comando (interruttori).

Screenshot dell'output della riga di comando per Azure Data Studio.

Per esempi di come eseguire gli strumenti da riga di comando in Azure Data Studio, vedere Terminale integrato.

Nota

Anche se Microsoft Entra ID è il nuovo nome per Azure Active Directory (Azure AD), per evitare l'interruzione degli ambienti esistenti, la denominazione Azure AD è tuttora mantenuta in alcuni elementi hardcoded, ad esempio campi dell'interfaccia utente, provider di connessioni, codici errore e cmdlet. All’interno di questo articolo i due nomi vengono utilizzati in modo intercambiabile.

Aiuto della riga di comando

Per visualizzare una panoramica dell'interfaccia della riga di comando di Azure Data Studio, aprire un terminale in Azure Data Studio (Visualizza > terminale) o un prompt dei comandi e digitare azuredatastudio --help. L'output contiene la versione, l'esempio di utilizzo e l'elenco delle opzioni della riga di comando, come illustrato nell'esempio troncato:

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

Lanciare dalla riga di comando

È possibile avviare Azure Data Studio dalla riga di comando per aprire rapidamente un file, una cartella o un progetto. In genere, si apre Azure Data Studio nel contesto di una cartella. Da un terminale aperto o dal prompt dei comandi, passare alla cartella di progetto e digitare azuredatastudio.

Avvia con Editor di query

In alcuni casi può essere necessario aprire uno script nell’Editor di query all'apertura di Azure Data Studio. È possibile avviare Azure Data Studio con uno script esistente specificando il percorso del file:

azuredatastudio .\samplescript.sql

Avviare con l'URI

È possibile avviare Azure Data Studio dal browser usando il formato URL per stabilire rapidamente la connessione all'avvio o aprire una finestra di dialogo di connessione, aprendo facoltativamente uno script nella Editor di query. Il formato supportato per l'avvio con URI è:

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

Comandi supportati

Quando si avvia Azure Data Studio da una riga di comando, sono supportati i comandi seguenti:

connect: Connessione al server di destinazione usando le opzioni fornite
openConnectionDialog: Apertura della finestra di dialogo di connessione usando le opzioni fornite

Opzioni supportate

Le seguenti opzioni possono essere fornite nell’URL:

Opzione	Descrizione
`provider`	Provider di connessione da usare, ad esempio MSSQL, PGSQL e così via.
`server`	Nome del server di destinazione o del nome host.
`database`	Nome del database.
`user`	Nome dell'utente.
`authenticationType`	Modalità di autenticazione da usare, valori accettati: `AzureMFA`, `SqlLogin`, `Integrated` e così via.
`applicationName`	Specificare un nome dell’applicazione usato nel profilo di connessione.
`connectionProperties`	Proprietà di connessione avanzate supportate da un provider. Il valore deve essere un oggetto JSON contenente coppie chiave-valore nel formato: `{"key1":"value1"}`.

Esempi

Prompt dei comandi: Autenticazione integrata

azuredatastudio --server localhost --authenticationType Integrated

Potrebbe essere visualizzato un avviso “Considera attendibile il certificato del server”.

Nota

Per gli utenti che si connettono a un'istanza locale di SQL Server o SQL Server in una macchina virtuale, il motore di database deve essere configurato per supportare le connessioni crittografate. Per le istruzioni complete, vedere Configurare il motore di database di SQL Server per la crittografia delle connessioni.

Riga di comando: Avvia Azure Data Studio con uno script salvato

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

Navigatore web

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

Condividi tramite