Ler em inglês

Compartilhar via


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 gerar diagnósticos por meio de opções de linha de comando (parâmetros).

Captura de tela da saída da linha de comando para o Azure Data Studio.

Para obter exemplos de como executar ferramentas de linha de comando no Azure Data Studio, consulte Terminal integrado.

Observação

Embora o Microsoft Entra ID seja o novo nome do Azure Active Directory (Azure AD), para evitar a interrupção de ambientes existentes, o Azure AD ainda permanecerá 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.

Ajuda da linha de comando

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

Iniciar por meio da linha de comando

Você pode iniciar o Azure Data Studio por meio da linha de comando para abrir rapidamente um arquivo, uma pasta ou um projeto. Normalmente, você abre o Azure Data Studio no contexto de uma pasta. Em um terminal ou prompt de comando aberto, navegue até a pasta do projeto e digite azuredatastudio.

Iniciar com o Editor de Consultas

Às vezes, convém 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

Iniciar usando URI

Você pode iniciar o Azure Data Studio por meio do navegador usando o formato de URL para estabelecer uma conexão rapidamente na inicialização ou abrir uma caixa de diálogo de conexão, opcionalmente abrindo um script no Editor de Consultas. O formato com suporte para iniciar com URI é:

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

Comandos com suporte:

Os seguintes comandos têm suporte ao iniciar o Azure Data Studio por meio de uma linha de comando:

  • connect: conecta-se ao servidor de destino usando as opções fornecidas
  • openConnectionDialog: abre a caixa de diálogo de conexão usando as opções fornecidas

Opções com suporte

As seguintes opções podem ser fornecidas na URL.

Opção Descrição
provider Provedor de conexão a ser usado, por exemplo, MSSQL, PGSQL e assim por diante.
server Nome do servidor de destino ou nome do host.
database Nome do banco 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 do aplicativo que é usado no perfil de conexão.
connectionProperties Propriedades de conexão avançadas às quais um provedor dá suporte. O valor deve ser um objeto json que contém pares chave-valor no formato {"key1":"value1"}.

Exemplos

Prompt de comando: autenticação integrada

azuredatastudio --server localhost --authenticationType Integrated

Você pode receber o aviso "Certificado do servidor confiável".

Observação

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 oferecer suporte a conexões criptografadas. Para obter instruções completas, confira Configurar o Mecanismo de Banco de Dados do SQL Server para criptografia de conexões.

Prompt de comando: Iniciar o Azure Data Studio com um script salvo

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

Navegador

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

Próximas etapas