ScyllaDB Explorer
VS Code extension for connecting to ScyllaDB, browsing keyspaces and tables, and filtering row data.
Features
- Connect to ScyllaDB with a connection dialog (host, port, credentials, SSL)
- Browse keyspaces and tables from the sidebar
- View table schema and paginated row data
- Filter rows by column values
- Collapsible schema and data sections
- Infinite scroll / load more for large tables
Requirements
- VS Code 1.85 or newer
- A running ScyllaDB (or Cassandra-compatible) cluster reachable from your machine
Installation
From VSIX (local build)
git clone https://github.com/jancimertel/scylla-vscode.git
cd scylla-vscode
npm install
npm run compile
npx @vscode/vsce@2.24.0 package --allow-missing-repository
code --install-extension scylla-vscode-0.3.1.vsix --force
Reload VS Code after installation.
From source (development)
git clone https://github.com/jancimertel/scylla-vscode.git
cd scylla-vscode
npm install
npm run compile
Open the folder in VS Code and press F5 to launch an Extension Development Host.
Usage
- Open the ScyllaDB panel in the activity bar (left sidebar).
- Click Connect and fill in your connection details:
- Hosts — comma-separated contact points (e.g.
127.0.0.1)
- Port — default
9042
- Local datacenter — e.g.
datacenter1
- Username / password — optional
- SSL — enable if required
- Expand a keyspace, then click a table to open it.
- Use Filters to query by column values, then click Apply filters.
- Scroll the rows table or click Load more to fetch additional pages.
| Action |
Description |
| Connect |
Open connection dialog and connect |
| Disconnect |
Close the database connection |
| Refresh |
Reload the keyspace/table tree |
| Configure Connection |
Edit saved connection settings |
Configuration
Settings can be set globally or per workspace in .vscode/settings.json:
{
"scylla.contactPoints": ["127.0.0.1"],
"scylla.port": 9042,
"scylla.localDataCenter": "datacenter1",
"scylla.keyspace": "",
"scylla.username": "",
"scylla.password": "",
"scylla.useSsl": false,
"scylla.pageSize": 50
}
| Setting |
Default |
Description |
scylla.contactPoints |
["127.0.0.1"] |
Cluster contact points |
scylla.port |
9042 |
Native protocol port |
scylla.localDataCenter |
datacenter1 |
Local datacenter name |
scylla.keyspace |
"" |
Optional default keyspace |
scylla.username |
"" |
Username for authentication |
scylla.password |
"" |
Password for authentication |
scylla.useSsl |
false |
Enable SSL |
scylla.pageSize |
50 |
Rows fetched per page |
Troubleshooting
- Connection fails — verify host, port, datacenter name, and credentials. Check that ScyllaDB is running and reachable.
- Empty tables — confirm the table contains data (e.g. via
cqlsh).
- Slow filters — filtering on non-partition-key columns uses
ALLOW FILTERING. Prefer partition key filters when possible.
- Debug output — open View → Output → ScyllaDB for extension logs.
License
MIT — see LICENSE.
