A interface de linha de comando do Azure Data Studio
O Azure Data Studio inclui uma interface de linha de comando interna que permite controlar como você inicia o aplicativo. Você pode abrir arquivos, instalar extensões, alterar o idioma de exibição e enviar diagnósticos por meio de opções de linha de comando (opções).
Para obter exemplos de como executar ferramentas de linha de comando dentro do Azure Data Studio, consulte Terminal integrado.
Nota
Embora o Microsoft Entra ID seja o novo nome do Azure Ative Directory (Azure AD), para evitar a interrupção de ambientes existentes, o Azure AD ainda permanece em alguns elementos codificados, como campos de interface do usuário, provedores de conexão, códigos de erro e cmdlets. Neste artigo, os dois nomes são intercambiáveis.
Para exibir uma visão geral da interface de linha de comando do Azure Data Studio, abra um terminal no Azure Data Studio (Exibir > Terminal) ou um prompt de comando e digite azuredatastudio --help
. A saída contém a versão, o exemplo de uso e a lista de opções de linha de comando, conforme mostrado no exemplo truncado:
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
Você pode iniciar o Azure Data Studio a partir da linha de comando para abrir rapidamente um arquivo, pasta ou projeto. Normalmente, você abre o Azure Data Studio no contexto de uma pasta. Em um terminal aberto ou prompt de comando, navegue até a pasta do projeto e digite azuredatastudio
.
Às vezes, você pode querer abrir um script no Editor de Consultas ao abrir o Azure Data Studio. Você pode iniciar o Azure Data Studio com um script existente fornecendo o caminho do arquivo:
azuredatastudio .\samplescript.sql
Você pode iniciar o Azure Data Studio a partir do navegador usando o formato de URL para estabelecer rapidamente a conexão na inicialização ou abrir uma caixa de diálogo de conexão, abrindo opcionalmente um script no Editor de Consultas. O formato suportado para iniciar com URI é:
azuredatastudio://{command}?{option1}={value1}&{option2}={value2}...
Os seguintes comandos são suportados ao iniciar o Azure Data Studio a partir de uma linha de comando:
connect
: Conecta-se ao servidor de destino usando as opções fornecidasopenConnectionDialog
: Abre a caixa de diálogo de conexão usando as opções fornecidas
As seguintes opções podem ser fornecidas no URL.
Opção | Description |
---|---|
provider |
Provedor de conexão para usar, por exemplo, MSSQL, PGSQL e assim por diante. |
server |
Nome do servidor de destino ou nome do host. |
database |
Nome da base de dados. |
user |
Nome do usuário. |
authenticationType |
Modo de autenticação a ser usado, valores aceitos: AzureMFA , SqlLogin , Integrated , e assim por diante. |
applicationName |
Forneça um nome de aplicativo usado no perfil de conexão. |
connectionProperties |
Propriedades de conexão avançadas suportadas por um provedor. Value deve ser um objeto json contendo pares chave-valor no formato {"key1":"value1"} . |
azuredatastudio --server localhost --authenticationType Integrated
Você pode ser solicitado com um aviso "Certificado de servidor confiável".
Nota
Para usuários que se conectam a um SQL Server local ou SQL Server em uma máquina virtual, o Mecanismo de Banco de Dados deve ser configurado para dar suporte a conexões criptografadas. Para obter instruções completas, consulte Configurar o Mecanismo de Banco de Dados do SQL Server para criptografar conexões.
azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql
azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}