sqlsurge is a Visual Studio Code extension for SQL language server using sqls. It works just NOT ONLY with SQL files, but also with RAW SQL QUERIES on other languages such as TypeScript and Rust.
See: https://github.com/sqls-server/sqls?tab=readme-ov-file#support-rdbms
This table shows the features available for each file extension.
Features | .sql |
.ts |
.rs |
---|---|---|---|
Completion | ✅ | ✅ | ✅ |
Formatting | ✅ | ✅ | ✅ |
Quick Info Symbol on Completion | ✅ | ✅ | ✅ |
Quick Info Symbol on Hover | ✅ | ❌ | ❌ |
Any Raw SQL Queries Support | ー | ✅ | ✅ |
These are the completion items sqlsurge provides:
- SQL keywords
- Tables and columns (Required to be configured by
sqls config
)
About raw SQL queries, VSCode's quick suggestion(auto completion) in strings is disabled by default. It can be enabled by adding the following setting to settings.json.
"editor.quickSuggestions": {
"strings": true
}
VSCode Commands
- SQL File:
Format Document
- Raw SQL query:
sqlsurge: Format SQL
Configurations for raw SQL queries
sqlsurge.formatOnSave
: Format SQL on save. Default istrue
.sqlsurge.formatSql.indent
: Format SQL with indent. Default isfalse
.sqlsurge.formatSql.tabSize
: Tab size for SQL formatting. Default is4
.
As a formatter, sqlsurge use sqls
for Vanilla SQL files, use SQL Formatter for raw SQL.
Quick info symbol for tables and columns can be shown by triggering completion with Ctrl
+ Space
or Cmd
+ Space
.
Note
This feature is experimental. Feedback is welcome!
sqlsurge supports Prisma in TypeScript and SQLx in Rust by default. But you can use sqlsurge with any raw SQL queries, such as TypeORM
or user-defined functions by setting.
This is an example of settings for custom raw SQL queries.
// TypeORM in TypeScript
const someQuery = await entityManager.query(
"SELECT * FROM todos WHERE id = $1;",
[1]
);
"sqlsurge.customRawSqlQuery": {
"language": "typescript",
"configs": [
{
"functionName": "query",
"sqlArgNo": 1,
"isTemplateLiteral": false
}
]
}
sqlsurge: Install sqls
: Install sqls.sqlsurge: Restart SQL Language Server
: Restart SQL Language Server.- This command is useful when you update sqls or change the configuration.
sqlsurge: Format SQL
: Format Raw SQL query.Format Document
: Format SQL file with sqls.
- Support for Prisma in TypeScript
- Support for SQLx in Rust
- Install guide for sqls
- Format SQL (Vanilla SQL: sqls, Raw SQL: SQL Formatter)
- Show quick info symbol
- Support to custom raw SQL queries, not just Prisma and SQLx
- Execute SQL query
- Show sqls config with tree view