Compartilhar via


Modificar configurações de usuários e espaços de trabalho

O Azure Data Studio pode ser facilmente configurado para atender às suas preferências e requisitos, alterando suas configurações. Quase todas as partes do editor, da interface do usuário e do comportamento funcional do Azure Data Studio têm opções que podem ser modificadas.

O Azure Data Studio tem dois escopos diferentes para as configurações:

  • Usuário: essas configurações se aplicam globalmente a qualquer instância do Azure Data Studio que você abrir.
  • Espaço de trabalho: essas configurações são específicas de uma pasta em seu computador e só estão disponíveis quando a pasta está aberta na barra lateral do Explorer. As configurações definidas nesse escopo substituem o escopo do usuário.

Editor de configurações

O comando de menu Arquivo>Preferências>Configurações (Código>Preferências>Configurações no macOS) fornece um ponto de entrada para definir as configurações do usuário no editor.

Também é possível abrir o editor de configurações na Paleta de comandos(Ctrl/Cmd + Shift + P) com Preferências: Abrir configurações (UI) ou usar o atalho de teclado (Ctrl/Cmd + ,) para acesso direto.

Captura de tela do editor de configurações no Azure Data Studio.

As configurações também podem ser visualizadas seletivamente na Paleta de comandos(Ctrl/Cmd + Shift + P) com Preferências: Abrir configurações do usuário para abrir as configurações do usuário ou Preferências: Abrir configurações do espaço de trabalho para abrir as configurações do espaço de trabalho.

O comando e o menu Espaço de trabalho apenas serão exibidos se você tiver salvo um espaço de trabalho (por exemplo, MyScripts na captura de tela).

Depois de abrir o editor de configurações, expanda os grupos na árvore para ver as várias configurações, que estão organizadas em seções. Você também pode usar a barra de pesquisa para localizar uma configuração. Na barra de pesquisa, são exibidas todas as configurações que correspondem ao texto inserido.

As extensões instaladas com o Azure Data Studio também podem ter suas próprias configurações, que podem ser encontradas na seção Extensões do editor de Configurações.

Alterar uma configuração

As configurações podem ser editadas por uma caixa de seleção, uma entrada ou uma lista suspensa. Habilite ou desabilite a caixa de seleção, edite o texto ou selecione a opção desejada para alterar a configuração.

As alterações nas configurações são aplicadas no Azure Data Studio à medida que você as faz. As configurações modificadas são indicadas com uma linha azul à esquerda das informações de configuração.

Captura de tela das configurações alteradas no editor de configurações no Azure Data Studio.

Para determinar quais configurações você alterou, há um filtro @modified na barra de pesquisa. Uma configuração aparecerá nesse filtro se seu valor for diferente do valor padrão ou se seu valor for explicitamente definido no arquivo JSON de configurações. Esse filtro pode ser útil caso você tenha esquecido se alterou uma configuração. Também é útil se o editor não estiver se comportando como esperado porque você alterou acidentalmente uma configuração.

Para redefinir qualquer configuração para o padrão, selecione o ícone de engrenagem que aparece ao passar o mouse sobre o nome da configuração e selecione Redefinir configuração.

Arquivo de configurações

O editor de configurações oferece uma interface de usuário que permite revisar e modificar as configurações, que são armazenadas em um arquivo settings.json. Você pode revisar e editar esse arquivo diretamente abrindo-o no editor usando o comando Preferências: Abrir configurações atuais do perfil (JSON) na paleta de comandos (Ctrl/Cmd + Shift + P). As configurações são gravadas como JSON, especificando o ID e o valor da configuração.

Captura de tela das configurações json abertas na janela do editor de arquivos no Azure Data Studio.

O arquivo settings.json tem IntelliSense completo, com conclusões inteligentes para configurações e valores e descrição de focalizações. Erros devido a nomes de configuração incorretos ou formatação JSON também são realçados.

Algumas configurações só podem ser editadas em settings.json, como Workbench: Personalizações de cores, e têm o link Editar em settings.json no editor de configurações.

Embora você possa redefinir as configurações individualmente por meio da opção Redefinir configuração do editor de configurações, é possível redefinir todas as configurações alteradas abrindo settings.json e excluindo as entradas entre colchetes {}. Não há como recuperar seus valores de configuração anteriores com essa abordagem. Portanto, tenha cuidado ao usar esse método.

Locais de arquivos de configurações

Dependendo de sua plataforma, o arquivo de configurações do usuário fica localizado aqui:

  • Windows %APPDATA%\azuredatastudio\User\settings.json
  • Mac $HOME/Library/Application Support/azuredatastudio/User/settings.json
  • Linux $HOME/.config/azuredatastudio/User/settings.json

Mover as configurações de usuário

Se você estiver fazendo a atualização do Azure Data Studio e quiser manter as configurações, os atalhos de teclado ou os snippets de código, faça o seguinte:

  1. No painel esquerdo, selecione Gerenciar (ícone de engrenagem) e Configurações.

    Captura de tela do ícone Gerenciar do Azure Data Studio e do comando Configurações.

  2. Na parte superior, clique com o botão direito do mouse na guia Configurações de Usuário e selecione Revelar no Explorer.

    Captura de tela do comando Revelar no Explorer na guia Configurações de Usuário.

  3. Copie todos os arquivos dessa pasta e salve em um lugar fácil de encontrar na unidade local, como a pasta Documentos.

    Captura de tela do arquivo settings.json na estrutura de pastas do Windows Explorer.

  4. Na versão atualizada do Azure Data Studio, siga as etapas 1 e 2 e, na etapa 3, cole o conteúdo salvo na pasta. Você também pode copiar manualmente as configurações, as associações de teclas ou os snippets de código nas respectivas localizações.

  5. Se você estiver substituindo a instalação atual, antes de iniciar a substituição, exclua o diretório de instalação antigo para evitar erros de conexão com sua conta do Azure no gerenciador de recursos.