Ler em inglês

Partilhar via


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

Captura de ecrã da saída da linha de comandos para o Azure Data Studio.

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.

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 a partir da linha de comando

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.

Iniciar com o Editor de Consultas

À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

Iniciar usando URI

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

Comandos suportados

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 fornecidas
  • openConnectionDialog: Abre a caixa de diálogo de conexão usando as opções fornecidas

Opções suportadas

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

Exemplos

Prompt de comando: autenticação integrada

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.

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

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

Browser

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

Próximos passos