Guía

Instalación y uso

Esta guía recorre la instalación de MultiOsSqlClient en Windows, Linux y macOS, la primera conexión al servidor y las funcionalidades principales de la aplicación: editor de consultas, explorador de objetos, visor de jobs, monitoreo, auditoría, snippets, historial y configuración.

1 Instalación por sistema operativo

MultiOsSqlClient se distribuye como ejecutable autocontenido: no requiere instalar .NET en el equipo. Elegí el paquete de tu sistema desde la sección Descargas.

Windows x64

  1. Descargá MultiOsSqlClient-2.0.17-win-x64.zip.
  2. Extraé el ZIP en una carpeta personal (por ejemplo %LOCALAPPDATA%\MultiOsSqlClient).
  3. Ejecutá MultiOsSqlClient.exe. Al primer arranque se crea un acceso directo en el menú Inicio.
  4. La configuración queda en %APPDATA%\EcsSqlClient.

Linux x64

  1. Descargá MultiOsSqlClient-2.0.17-linux-x64.tar.gz.
  2. Extraé: tar -xzf MultiOsSqlClient-2.0.17-linux-x64.tar.gz.
  3. Ejecutá ./install.sh para dejar la app en ~/.local/share/MultiOsSqlClient y un acceso en el menú.
  4. La configuración queda en ~/.config/EcsSqlClient.

macOS (Apple Silicon / Intel)

  1. Descargá MultiOsSqlClient-2.0.17-osx-arm64.zip (Apple Silicon) o …-osx-x64.zip (Intel).
  2. Extraé el ZIP y abrí una Terminal en la carpeta extraída.
  3. Ejecutá sh install.sh. La app queda en ~/Applications/MultiOsSqlClient.app.
  4. Si Gatekeeper la bloquea: xattr -dr com.apple.quarantine ~/Applications/MultiOsSqlClient.app.
Tip: los paquetes de macOS no están firmados con Apple Developer ID. El instalador aplica una firma ad-hoc con codesign cuando está disponible.

2 Primera conexión

Al abrir la app por primera vez se muestra el diálogo de conexión. Podés conectarte directamente a un servidor SQL o utilizar un túnel AWS SSM contra una instancia EC2.

Conexión directa

  1. Ingresá el nombre del servidor (ej. sql01.empresa.local,1433).
  2. Elegí autenticación: Windows integrada o SQL Server.
  3. Opcional: guardá las credenciales en el vault local cifrado.
  4. Pulsá Probar para validar y luego Conectar.
Diálogo de conexión
Diálogo de conexión con autenticación y vault.

Conexión por AWS SSM

  1. Elegí la pestaña AWS SSM del diálogo.
  2. Seleccioná el perfil AWS y la instancia EC2 destino (listado automático).
  3. Definí el puerto local y el puerto remoto del servidor SQL.
  4. La app levanta el túnel con AWS CLI + Session Manager y se cierra al desconectar.
Conexión por AWS SSM
Selección de instancia EC2 y túnel SSM.
Importante: la contraseña nunca se guarda en texto plano. En Windows se usa DPAPI, en Linux/macOS AES-GCM con archivos 0600.

3 Editor de consultas y resultados

Cada pestaña abre su propia conexión dedicada (keep-alive cada 4 min, reconexión automática) que preserva tablas temporales y opciones SET como SSMS.

Ejecutar y manejar lotes

  • Ejecutá todo el script con F5.
  • Si hay selección, se ejecuta solo la selección.
  • Los lotes separados por GO o GO n se corren en secuencia.
  • Un error de un lote no detiene los demás.
Editor con lotes GO y resultados
Editor con separación por GO y resultados múltiples.

Autocompletado

El editor sugiere tablas, vistas, SPs y columnas al escribir letras, al tipear . o con Ctrl+Espacio. El catálogo se cachea por servidor y base.

Lista de autocompletado
Autocompletado contra el catálogo de la base conectada.

Resultados paginados y exportación

  • Los resultados se cargan paginados (configurable en Preferencias).
  • Botón derecho sobre la grilla para Exportar a Excel (.xlsx nativo) o TXT separado por tabulaciones.
  • Hard ceiling por ejecución: 100k filas por result set y ~64 MiB — avisa en pantalla cuando se trunca.
Resultados con menú de exportación
Exportar resultados a Excel o TXT.

4 Explorador de objetos

El explorador multiservidor permite tener varias conexiones abiertas en paralelo. Cada raíz es un servidor; dentro, las bases y sus objetos.

  • Filtro por nombre arriba del árbol.
  • Click derecho sobre una base: Nueva consulta o Abrir visor de jobs.
  • Click derecho sobre un objeto: Ver script de creación (SP, vistas, funciones y tablas).
Explorador multiservidor
Explorador con varios servidores y menú contextual.

5 Visor de Jobs del Agent

Vista de solo lectura sobre msdb. Muestra la grilla de jobs, los pasos con su comando y los schedules decodificados a español. Nunca crea, modifica ni ejecuta jobs.

Visor de jobs
Jobs del Agent con pasos y schedules.

6 Monitoreo de sesiones

Vista en vivo de sesiones activas, bloqueos y procesos. Permite filtrar por base, exportar a Excel y matar procesos desde la vista de Bloqueos (requiere permisos).

Visor de monitoreo
Monitoreo con filtro por base y acción KILL.

7 Auditoría local

Cada ejecución queda registrada en un archivo JSONL mensual bajo la carpeta de configuración. Por defecto se guarda metadata (servidor, base, duración, hash del SQL); el SQL completo se activa de forma explícita en Preferencias.

  • Retención acotada automáticamente para evitar que el log crezca sin límite.
  • Visor paginado dentro de la app con búsqueda por servidor, base y fecha.
  • La auditoría nunca bloquea ni detiene la ejecución.
Visor de auditoría
Visor de auditoría local.

8 Snippets

Panel lateral con fragmentos de T-SQL reutilizables: inserts rápidos, consultas de metadata, patrones habituales. Cada snippet tiene nombre, descripción y cuerpo.

  • Doble click sobre un snippet para insertarlo en el editor activo.
  • Editable: podés crear los propios desde el panel.
  • Agrupables por categoría y buscables por nombre.
Panel de snippets
Panel de snippets con categorías.

9 Historial de ejecuciones

Las últimas consultas ejecutadas quedan accesibles para re-ejecutar o recuperar el texto. El historial se mantiene por conexión y se puede filtrar por fecha.

Historial de ejecuciones
Historial de ejecuciones recientes.

10 Atajos de teclado

AcciónAtajo
Ejecutar todo / selecciónF5
Cancelar ejecuciónAlt+Pausa
Nueva consultaCtrl+N
Abrir archivo .sqlCtrl+O
GuardarCtrl+S
AutocompletadoCtrl+Espacio
Resultado anterior / siguienteCtrl+Shift+R
Comentar / descomentarCtrl+K Ctrl+C / Ctrl+K Ctrl+U
Buscar / reemplazarCtrl+F / Ctrl+H
Resumen visual de atajos
Resumen visual de atajos dentro de la app.

11 Configuración

Desde el menú Menú → Configuración se ajustan:

  • Tema visual (Claro, Oscuro, Azul, Verde, ECS, SSMS) y color de acento.
  • Tamaño de letra del editor, de mensajes y de celdas de resultados.
  • Paginación de resultados (MaxRows).
  • Captura completa del SQL en la auditoría local (opt-in).
Ventana de configuración
Preferencias de tema, tipografía y paginación.
¿Dónde quedan los archivos?
  • Windows: %APPDATA%\EcsSqlClient
  • Linux: ~/.config/EcsSqlClient
  • macOS: ~/Library/Application Support/EcsSqlClient