Modificación de la configuración del usuario y el área de trabajo

Azure Data Studio se puede configurar fácilmente para adaptarse a sus preferencias y requisitos cambiando su configuración. Casi todas las partes del editor, la interfaz de usuario y el comportamiento funcional de Azure Data Studio tienen opciones que se pueden modificar.

Azure Data Studio tiene dos ámbitos distintos para la configuración:

  • Usuario: Estas configuraciones se aplican globalmente a cualquier instancia de Azure Data Studio que abra.
  • Área de trabajo: Estas configuraciones son específicas de una carpeta del equipo y solo está disponible cuando la carpeta está abierta en la barra lateral del explorador. La configuración que se define en este ámbito invalida el ámbito de usuario.

Editor de configuración

El comando de menú Archivo>Preferencias>Configuración (Código>Preferencias>Configuración en macOS) proporciona un punto de entrada para configurar las configuraciones de usuario en el editor.

También puede abrir el Editor de configuraciones desde la paletade comandos (Ctrl/Cmd + Shift + P) con Preferencias: Abrir configuración (UI) o puede usar el método abreviado de teclado (Ctrl/Cmd + ,) para el acceso directo.

Captura de pantalla del editor de configuración en Azure Data Studio.

La configuración también se puede ver de forma selectiva desde Paletade comandos (Ctrl/Cmd + Shift + P) con Preferencias: Abrir Configuración de usuario para abrir la configuración del usuario o Preferencias: Abrir Configuración de área de trabajo para abrir la configuración del área de trabajo.

El comando y el menú Áreade trabajo solo se muestran si ha guardado un área de trabajo (por ejemplo, MyScripts en la captura de pantalla).

Después de abrir el Editor de configuraciones, expanda los grupos del árbol para ver las distintas configuraciones, que se organizan en secciones. También puede usar el cuadro Buscar para buscar una opción de configuración específica. Dentro de la barra de búsqueda, se muestran todas las configuraciones que coincidan con el texto mostrado.

Las extensiones instaladas con Azure Data Studio también pueden tener su propia configuración, que se puede encontrar en lasección Extensiones del Editor de configuraciones.

Cambiar una configuración

La configuración se puede editar mediante una casilla de verificación, una entrada o una listadesplegable. Habilite o deshabilite la casilla, edite el texto o seleccione la opción deseada para cambiar la configuración.

Los cambios en la configuración se aplican en Azure Data Studio a medida que los realiza. La configuración modificada se indica con una línea azul a la izquierda de la información de configuración.

Captura de pantalla de la configuración modificada en el editor de configuración de Azure Data Studio.

Para determinar qué configuración ha cambiado, hay un filtro @modified en la barra de búsqueda. Una configuración se muestra bajo este filtro si su valor difiere del valor predeterminado o si su valor se establece explícitamente en el archivo JSON de configuración. Este filtro puede ser útil si ha olvidado si modificó una configuración. También es útil si el editor no se comporta según lo esperado porque ha cambiado accidentalmente una configuración.

Para restablecer cualquier configuración a su valor predeterminado, seleccione el icono de engranaje que aparece al mantener el puntero sobre el nombre de la configuración y seleccione Restablecer configuración.

Archivo de configuración

El Editor de configuraciones proporciona una UI que permite revisar y modificar la configuración, que se almacenan en un archivo settings.json. Para revisar y editar este archivo directamente, ábralo en el editor mediante el comando Preferencias: Abrir Configuración del perfil actual (JSON) desde la paleta de comandos (Ctrl/Cmd + Shift + P). La configuración se escribe como JSON especificando el Id. y el valor de configuración.

Captura de pantalla de la configuración json abierta en la ventana del editor de archivos en Azure Data Studio.

El archivo settings.json tiene IntelliSense completo con terminaciones inteligentes para la configuración y los valores y la descripción cuando se mantiene el puntero. También se resaltan los errores debidos a nombres de configuración incorrectos o formato JSON.

Algunas opciones de configuración solo se pueden editar en settings.json, como Workbench: Personalizaciones de color y tienen el vínculo Editar en settings.json en el Editor de configuraciones.

Aunque puede restablecer la configuración individualmente a través de la opción del Editor de configuraciones Restablecer configuración, puede restablecer todas las opciones modificadas abriendo settings.json y eliminando las entradas entre las llaves {}. No hay ninguna manera de recuperar los valores de configuración anteriores con este enfoque, por lo que debe tener cuidado con este método.

Ubicaciones del archivo de configuración

En función de la plataforma, el archivo de configuración del usuario se encuentra aquí:

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

Migrar la configuración del usuario

Si actualiza Azure Data Studio y quiere mantener la configuración, los métodos abreviados de teclado o los fragmentos de código, siga estos pasos:

  1. En el panel izquierdo, seleccione Administrar (icono de engranaje) y, después, Configuración.

    Captura de pantalla del icono

  2. En la parte superior, haga clic con el botón derecho en la pestaña Configuración del usuario y después seleccione Mostrar en el Explorador.

    Captura de pantalla del comando

  3. Copie todos los archivos de esta carpeta y guárdelos en una ubicación a la que pueda acceder fácilmente desde la unidad local, como la carpeta Documentos.

    Captura de pantalla del archivo settings.json en la estructura de carpetas del Explorador de Windows

  4. En la versión actualizada de Azure Data Studio, siga los pasos 1 y 2, después, para el paso 3, pegue el contenido que haya guardado en la carpeta. También puede copiar de forma manual la configuración, los enlaces de teclado o los fragmentos de código en las ubicaciones correspondientes.

  5. Si va a reemplazar la instalación actual, antes de hacerlo, elimine el directorio de instalación anterior para evitar errores al conectarse a la cuenta de Azure para el Explorador de recursos.