dbext: The Last SQL Client You'll Ever Need

As the first part of my Masters of Vim series, I'd like to introduce dbext, a Vim plugin that's potentially life-changing after fighting through the somewhat daunting initial configuration and usage.

This short article is no substitute for the extensive documentation that comes bundle with the plugin. Additional information and answers to any lingering questions can usually be found there.


Install the plugin by downloading the archive from Vim.org, or clone the Git mirror.

Additionally, the script itself relies on the command line clients of the various DBMSes that it supports. For dbext to work, refer to the table below and make sure that the binary appropriate for the system you'd like to work with is available. Often these clients are bundled with the DBMS itself, but otherwise should be available through your favorite package manager.

Required command line client binaries for each DBMS supported by dbext
DBMS Client Bin
ASA dbisql
ASE (Sybase) isql
DB2 db2batch or db2cmd
Ingres sql
MySql isql
Oracle sqlplus
PostgreSQL psql
Microsoft SQL Server osql
SQLite sqlite


dbext needs the connection information of the database to operate on. It provides an interactive prompt to enter it, but I'd strongly recommend configuring your .vimrc instead.

Any number of profiles (connections) can be configured using this basic format:

let g:dbext_default_profile_<profile_name> = '<connection string>'

For example:

let g:dbext_default_profile_mysql_local = 'type=MYSQL:user=root:passwd=whatever:dbname=mysql'

" SQLite
let g:dbext_default_profile_sqlite_for_rails = 'type=SQLITE:dbname=/path/to/my/sqlite.db'

" Microsoft SQL Server
let g:dbext_default_profile_microsoft_production = 'type=SQLSRV:user=sa:passwd=whatever:host=localhost'

These profile names will be used later to select a database on which to run query, so it's recommended that you make them somewhat logical.


Open Vim pointing to a *.sql file. The SQL extension is not necessary to use dbext, but it's useful to get syntax highlighting. Write in a simple query relevant to your database:

select * from user limit 100

Move your cursor to anywhere on the line you entered and type <leader>sel for s SQL, e execute, l line (from here on out I'm going to assume that leader is \). dbext will prompt you for a connection:

0. None
1. mysql_local
2. sqlite_for_rails
3. microsoft_production
[Optional] Enter profile #: 0

Enter the number corresponding to the connection for which your query will run with the results appearing in a split below (C-w = to even out the heights of each split).

| userID | username |
|      1 | bob      |
|      2 | joe      |
|      3 | jen      |

The \se (s SQL, e execute) command is useful for multiline queries. It searches backwards for the beginning of a query by looking for certain SQL command keywords (e.g. SELECT) and searches forwards for the end of a query by looking for your connection's command terminator (e.g. ;). For example, the following SQL should execute with \se no matter where your cursor is on it:

select *
from user 
limit 100;

\st selects everything from the table whose name is under your cursor (e.g. user in the previous example).

\sT selects from the table under your cursor, but prompts for the number of rows to select. This is a much safer alternative to \st when working with a lot of data.

\stw selects from the table under your cursor, but prompts for a where clause (don't include the keyword WHERE).

\sta prompts for table name, then selects from that table.


\sdt describes the table whose name is under your cursor:

| Field    | Type                  |
| userID   | mediumint(8) unsigned |
| username | varchar(30)           |

\sdp is very similar, but instead describes the stored procedure under your cursor.

The three command directives :DBListTable, :DBListProcedure, and :DBListView list the database's tables, stored procedures, and views respectively. I find it useful to map the table list to its own key:

map <leader>l :DBListTable<CR>

\slc copies each of the column names in the table under your cursor to the unnamed register in a format like userID, username. This is useful for constructing select queries on tables.

The Results Buffer

There are a few useful shortcuts specific to when your cursor is in the results buffer.

  • R will re-run the command which populated the current results.
  • q will quickly close the results.


Recall that this article was written to be a very minimal introduction to dbext to highlight what are (in my opinion) some of its most useful features. Refer to dbext's excellent documentation to discover its full potential.

Posted on May 3, 2011 from Calgary

Newest Articles