vdsql 0.1.1

VisiData plugin for deferred execution with SQL databases via Ibis

vdsql: VisiData plugin for SQL Databases

A VisiData interface for relational and columnar databases

Powered by Ibis.

Features

• query data in VisiData from any supported backend
• output resulting query in SQL, Substrait, or Python

Confirmed supported backends

• SQLite
• DuckDB

Other backends supported by Ibis (read)

These backends are supported by Ibis and should work, but haven't been tested. If you have have problems connecting, please file an issue.

• PostgreSQL
• MySQL
• ClickHouse
• Apache Impala
• Datafusion
• Dask
• PySpark
• HeavyAI
• Google BigQuery

Install latest release

This will install both:

• the usual vd with the vdsql plugin available (use -f ibis to use Ibis instead of builtin loaders),

• the vdsql script that acts identically to vd but will use Ibis instead of the builtin loader.

  pip install vdsql

  echo "import vdsql" >> ~/.visidatarc

Install manually as a VisiData plugin (development)

pip install git+https://github.com/visidata/vdsql.git

echo "import vdsql" >> ~/.visidatarc

Usage

deferred execution with Ibis

vd -f ibis <file_or_url>

where file_or_url is any connection string supported by ibis.connect().

IbisSheet

Only these commands are implemented to use Ibis expressions; others will use the internal VisiData implementation (and will only use the currently loaded rowset, limited to 10000 rows).

• Shift+F frequency table
  • on the Frequency Sheet, Enter to filter source rows by that value
• - to hide column
• zM unfurl-col
• ~/@/#/$/% to set column types
• ^ to rename col
• + to aggregate (name must be function on Ibis column expr; e.g. use mean, avg is not available)
• z+ to calculate aggregation immediately
• [ and ] family to sort
• , to select rows
• gt to toggle selection
• " to filter selection
• & to join

new commands for IbisSheet

• v to cycle the sidebar between the generated SQL, the Ibis expression, the Substrait, and no sidebar

Notes

• the SQL/sidebar expression shows what would be executed during reload, not necessarily what the current view is.
  • For example, opening a table through Ibis only loads the first 10,000 rows. Sorting the table adds an ORDER BY clause to the SQL, but only sorts those first 10,000 rows within VisiData. To re-run the query including the new ORDER BY clause, use Ctrl+R to reload the sheet.