Documentation
Practical setup and module usage guide for SQL Performance Intelligence.
Before You Begin
- Add at least one SQL Server connection in Settings > Database.
- Activate the connection with Connect.
- From the Info Bar, select active Server, Database, and (if needed) AI Model.
Overview
- Analyzes SQL Server objects, plans, and query signals.
- Generates evidence-backed, audit-ready reports.
- Runs offline by default with Local LLM support.
- No automatic schema changes or auto-apply actions.
- No background agents or persistent collectors.
- No table/row data extraction as a collection step.
Installation
Use the standard Windows installer for desktop environments. Offline installer is available for controlled networks.
# Example silent install msiexec /i "SQL Performance Intelligence.msi" /quiet /norestart
Database User Permissions
The application operates in read-only mode. Minimum required permissions may vary by environment; these are recommended for initial setup.
- CONNECT (connection to target database)
- VIEW SERVER STATE (instance-level performance metrics)
- VIEW DATABASE STATE (database-level performance metrics)
- VIEW DEFINITION (procedure/view/function definitions)
- SELECT on system catalog views (system metadata access)
Quickstart
- Open the target module (Dashboard, Object Explorer, Query Statistics, or another module).
- Set filters and scope (time range, object type, search, or severity).
- Run analysis or refresh data.
- Review findings and supporting evidence.
- Export report/script output when needed.
Modules
Each module is designed for a specific operational question. Start with the module that matches your immediate need.
Monitor server health, memory, IO, TempDB, and workload trends in real time.
Analyze high-impact queries with trend, risk, and plan stability indicators.
Prioritize index actions, generate maintenance scripts, and export reports.
Visualize blocking chains, identify head blockers, and export audit snapshots.
Categorize waits, set baselines, compare snapshots, and export findings.
Run read-only security checks and export HTML audit outputs.
Track SQL Agent job health, failures, and runtime behavior.
Browse procedures/views/functions, inspect source, and run AI Tune per object.
Manage DB/AI/license settings and switch active server, database, and model quickly.
Standard Analysis Workflow
- Connect and verify active context from the Info Bar.
- Run module-specific analysis (query, index, blocking, waits, or security).
- Validate evidence and confidence before applying changes.
- Export report/script outputs for review and audit traceability.