Solução de problemas do Azure Data Studio

  • Artigo

O Azure Data Studio rastreia problemas e solicitações de recursos usando um rastreador de problemas do repositório do GitHub para o repositório azuredatastudio.

Comunicar um problema que você teve

Comunique problemas no GitHub Issue Tracker e informe-nos sobre quaisquer detalhes que ajudem a reproduzir o erro. Inclua qualquer informação de log do arquivo de log.

Escrever bons relatórios de bugs e solicitações de recursos

Faça um único registro por problema e solicitação de recurso.

  • Não enumere vários bugs ou solicitações de recursos no mesmo problema.
  • Não adicione seu problema como um comentário a um problema existente, a menos que seja para uma entrada idêntica. Muitos problemas parecem semelhantes, mas têm causas diferentes.

Quanto mais informações você fornecer, maior será a probabilidade de alguém conseguir reproduzir o problema e encontrar uma correção.

Inclua as seguintes informações com cada problema:

  • Versão do Azure Data Studio
  • Etapas reproduzíveis (1... 2... 3...) e o que você esperava versus o que realmente ocorreu.
  • Imagens, animações ou um link para um vídeo. Imagens e animações ilustram as etapas de reprodução, mas não as substituem.
  • Um snippet de código que demonstre o problema ou um link para um repositório de código que possamos obter facilmente em nosso computador para recriar o problema.

Observação

Como precisamos copiar e colar o trecho de código, não é suficiente incluir um trecho de código como um arquivo de mídia (ou seja, .gif).

  • Erros no console de ferramentas de desenvolvimento(Ajuda > Alternar Ferramentas de Desenvolvimento)

Lembre-se de seguir estas etapas:

  • Pesquise o repositório de problemas para ver se o mesmo problema já existe.
  • Simplifique seu código em relação ao problema para que possamos isolá-lo de uma forma melhor.

Não se preocupe se não conseguirmos reproduzir o problema e solicitarmos mais informações.

Como definir o nível de registros em log

Azure Data Studio

Na paleta de comandos (Ctrl/Cmd + Shift + P), execute o comando Desenvolvedor: Definir nível de log... para selecionar o nível de log da sessão atual. Esse valor não é mantido em várias sessões. Se você reiniciar o Azure Data Studio, ele voltará ao nível padrão Info.

Se quiser ativar o registro de depuração para a inicialização, defina o nível de registro como Debug e execute o comando Desenvolver: Recarregar Janela.

MSSQL (extensão interna)

Se a configuração de usuário Mssql: Log Debug Info for definida como verdadeira, as informações de registro de depuração serão enviadas para o canal de saída MSSQL.

A configuração de usuário Mssql: Tracing Level é usada para controlar o detalhamento do registro em log.

Logs e localização do Azure Data Studio

Na paleta de comandos (Ctrl/Cmd + Shift + P), execute o comando Desenvolvedor: Abrir Pasta de Logs para abrir o caminho para os logs. Há muitos tipos diferentes de arquivos de log que são gravados lá. Alguns dos mais comumente usados são:

  1. renderer#.log (por exemplo, renderer1.log): esse arquivo é o arquivo de log do processo principal.
  2. telemetry.log quando o nível de log é definido como Trace, esse arquivo contém os eventos de telemetria enviados pelo Azure Data Studio
  3. exthost#/exthost.log arquivo de log do processo do host da extensão (esse é apenas o processo em si, não as extensões executadas dentro dele)
  4. exthost#/Microsoft.mssql logs da extensão mssql, que contém grande parte da lógica central dos recursos relacionados ao MSSQL
    • sqltools.log é o log do serviço SQL Tools
  5. exthost#/output_logging_#######: essas pastas contêm as mensagens exibidas no painel Output no Azure Data Studio. Cada arquivo é denominado #-<Channel Name>. Por exemplo, o canal de saída Notebooks pode ser enviado para um arquivo denominado 3-Notebooks.log.

Se for solicitado que você forneça logs, compacte toda a pasta para garantir que os logs corretos sejam incluídos.

Recuperar arquivos do editor após uma falha

Se o Azure Data Studio falhar inesperadamente, reiniciar o Azure Data Studio também deverá reabrir todos os arquivos do editor não salvos. Se não for o caso, pode ter ocorrido um erro ao tentar reabri-los. Nesse caso, siga estas etapas para navegar até a pasta que contém os backups, onde você pode abri-los manualmente para recuperar seu conteúdo.

  1. Na paleta de comandos (Ctrl/Cmd + Shift + P), execute o comando Desenvolvedor: Abrir Pasta de Dados do Usuário.
  2. Na pasta que é aberta, navegue até a pasta Backups.

Ela contém pastas com nomes gerados aleatoriamente. Dentro dessas pastas, há arquivos que contêm os backups do editor (que incluem alguns metadados adicionais junto com o conteúdo do texto).

Próximas etapas