Partilhar via

Solução de problemas do Azure Data Studio

  • Artigo

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

Comunicar um problema que tenha tido

Reporte problemas ao GitHub Issue Tracker e informe-nos de todos os detalhes que ajudem a reproduzir o erro. Inclua todas as informações de log do arquivo de log.

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

Registre um único problema 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 a entrada idêntica. Muitos problemas são semelhantes, mas têm causas diferentes.

Quanto mais informações você puder fornecer, maior a probabilidade de alguém ser bem-sucedido ao reproduzir o problema e encontrar uma correção.

Inclua as seguintes informações em cada edição:

  • Versão do Azure Data Studio
  • Passos reprodutíveis (1... 2... 3...) e o que você esperava versus o que você realmente viu.
  • Imagens, animações ou um link para um vídeo. Imagens e animações ilustram etapas de reprodução, mas não as substituem.
  • Um trecho de código que demonstra o problema ou um link para um repositório de código que podemos facilmente puxar para baixo em nossa máquina para recriar o problema.

Nota

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

  • Erros no console de ferramentas de desenvolvimento (Ajuda > a alternar ferramentas de desenvolvedor)

Lembre-se de seguir os seguintes passos:

  • Pesquise no repositório de problemas para ver se o mesmo problema já existe.
  • Simplifique seu código em torno do problema para que possamos isolá-lo melhor.

Não se sinta mal se não conseguirmos reproduzir o problema e pedir mais informações!

Como definir o nível de log

Azure Data Studio

Na Paleta de comandos (Ctrl/Cmd + Shift + P), execute o comando Developer: set Log Level... para selecionar o nível de log para a sessão atual. Esse valor não é persistido em várias sessões. Se você reiniciar o Azure Data Studio, ele será revertido para o nível padrão Info .

Se você quiser habilitar o log de depuração para inicialização, defina o nível de log e Debug execute o comando Developer: Reload Window .

MSSQL (extensão incorporada)

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

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

Logs e localização do Azure Data Studio

Na Paleta de Comandos (Ctrl/Cmd + Shift + P), execute o comando Developer: Open Logs Folder para abrir o caminho para os logs. Há muitos tipos diferentes de arquivos de log que gravam lá. Alguns dos mais utilizados são:

  1. renderer#.log (por exemplo, renderer1.log): este arquivo é o arquivo de log para o 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 para o processo de host de extensão (este é apenas o processo em si, não as extensões em execução dentro dele)
  4. exthost#/Microsoft.mssql: Logs para a extensão mssql, que contém grande parte da lógica principal para recursos relacionados ao MSSQL
    • sqltools.log é o log para o serviço Ferramentas SQL
  5. exthost#/output_logging_#######: essas pastas contêm as Output mensagens exibidas no painel no Azure Data Studio. Cada arquivo tem o nome #-<Channel Name>de . Por exemplo, o Notebooks canal de saída pode sair para um arquivo chamado 3-Notebooks.log.

Se você for solicitado a fornecer 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 de editor não salvos. Se não o fizerem, pode ter havido 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 Developer: Open User Data Folder.
  2. Na pasta que se abre, navegue até a Backups pasta.

Isso contém pastas com nomes gerados aleatoriamente. Dentro dessas pastas estão arquivos que contêm os backups do editor (que incluem alguns metadados adicionais juntamente com seu conteúdo de texto).

Próximos passos