Compartir vía


Solución de problemas de Azure Data Studio

Azure Data Studio realiza un seguimiento de los problemas y las solicitudes de características mediante un rastreador de problemas de repositorios de GitHub para el repositorio azuredatastudio.

Informe de algún problema que haya experimentado

Informe de los problemas en el rastreador de problemas de GitHub y comuníquenos los detalles que nos permitirán reproducir el error. Incluya cualquier información de registro del archivo de registro.

Redacte buenos informes de errores y solicitudes de características

Presente una sola incidencia por problema y solicitud de características.

  • No enumere varios errores o solicitudes de características en la misma incidencia.
  • No agregue la incidencia como comentario a una incidencia existente, a menos que se trate de una entrada idéntica. Muchos problemas son similares, pero tienen diferentes causas.

Cuanta más información pueda proporcionar, más probable será que alguien reproduzca correctamente el problema y encuentre una solución.

Incluya la siguiente información con cada incidencia:

  • Versión de Azure Data Studio
  • Pasos reproducibles (1... 2... 3...) y lo que esperaba ver en comparación con lo que apareció realmente.
  • Imágenes, animaciones o un vínculo a un vídeo. Las imágenes y las animaciones ilustrarán los pasos de reproducción, pero no los reemplazarán.
  • Un fragmento de código que demuestre el problema o un vínculo a un repositorio de código que podamos descargar fácilmente en nuestro equipo para recrear el problema.

Nota:

Dado que es necesario copiar y pegar el fragmento de código, la inclusión de un fragmento como archivo multimedia (es decir, .gif) no es suficiente.

  • Errores en la consola de herramientas de desarrollo (Ayuda > Alternar herramientas de desarrollo)

No olvide seguir estos pasos:

  • Consulte el repositorio de problemas para ver si ya existe el mismo problema.
  • Simplifique el código relacionado con la incidencia, de modo que podamos aislarla mejor.

¡No se sienta mal si no podemos reproducir el problema y solicite más información!

Establecimiento del nivel de registro

Azure Data Studio

En la paleta de comandos (Ctrl/Cmd + Shift + P), ejecute el comando Desarrollador: Configurar el nivel de registro... para seleccionar el nivel de registro de la sesión actual. Este valor no se conserva en varias sesiones. Si reinicia Azure Data Studio, vuelve al nivel predeterminado Info.

Si desea habilitar el registro de depuración durante el inicio, establezca el nivel de registro en Debug y ejecute el comando Desarrollador: Recargar ventana.

MSSQL (extensión integrada)

Si el parámetro de usuario Mssql: Log Debug Info está establecido en true, la información de registro de depuración se envía al canal de salida MSSQL.

El parámetro de usuario Mssql: Tracing Level se utiliza para controlar el nivel de detalle del registro.

Registros y ubicación de Azure Data Studio

En la paleta de comandos (Ctrl/Cmd + Shift + P), ejecute elcomando Desarrollador: Abrir carpeta de registros para abrir la ruta de acceso a los registros. Hay muchos tipos diferentes de archivos de registro que se escriben allí. Algunos de los más usados son:

  1. renderer#.log (por ejemplo, renderer1.log): este archivo es el archivo de registro del proceso principal.
  2. telemetry.log: cuando el nivel de registro se establece en Trace, este archivo contiene los eventos de telemetría enviados por Azure Data Studio
  3. exthost#/exthost.log: archivo de registro para el proceso de host de extensiones (solo es el propio proceso, no las extensiones que se ejecutan en él)
  4. exthost#/Microsoft.mssql: registros de la extensión MSSQL, que contiene gran parte de la lógica principal de las características relacionadas con MSSQL
    • sqltools.log es el registro del servicio de herramientas de SQL
  5. exthost#/output_logging_#######: estas carpetas contienen los mensajes mostrados en el panel Output de Azure Data Studio. Cada archivo se denomina #-<Channel Name>. Por ejemplo, el canal de salida Notebooks puede generar un nombre de archivo 3-Notebooks.log.

Si se le pide que proporcione registros, comprima toda la carpeta para asegurarse de que se incluyen los registros correctos.

Recuperación de archivos del editor después de un bloqueo

Si Azure Data Studio se bloquea inesperadamente, reiniciar Azure Data Studio también debe volver a abrir los archivos del editor no guardados. Si no lo hacen, es posible que haya habido un error al intentar volver a abrirlos. En ese caso, siga estos pasos para ir a la carpeta que contiene las copias de seguridad, donde puede abrirlas manualmente para recuperar su contenido.

  1. En la paleta de comandos (Ctrl/Cmd + Shift + P), ejecute el comando Desarrollador: Abrir carpeta de datos de usario.
  2. Desde la carpeta abierta, vaya a la carpeta Backups.

Contiene carpetas con nombres generados aleatoriamente. Dentro de estas carpetas hay archivos que contienen las copias de seguridad del editor (que incluyen algunos metadatos adicionales junto con su contenido de texto).

Pasos siguientes