This page describes Calíope 1.7, the version I am building right now. 1.6 is on the App Store for the Mac, iPad, iPhone, Apple Watch, Apple TV and Apple Vision Pro. The changelog says which version each feature landed in.
Adds an “Open in Calíope” button to every topic. It only works with the app installed.
Version, host, data directory, character set, connection limit, and your own connection.
Where it is: Workspace › Tools › Server Information
Open Server Information from the tool sidebar. The Information tab gathers what identifies the server and your connection: version, host, port, data directory, character set and collation, maximum connections, and your connection id and user. The next four tabs list every variable and status counter, global and for your session, and HDD Usage shows how much each table takes on disk.
SQL Server
With SQL Server there is no server character set or socket, so those lines don't appear; the collation is the server's default one.
PostgreSQL
With PostgreSQL the character set is the server encoding, the collation is the connected database's, and there is no socket line.
ClickHouse
With ClickHouse there is no character set, collation, socket or connection id, so those lines don't appear, and there are four tabs instead of six: Session variables and Session status don't exist, because the HTTP interface has no session.
Oracle
With Oracle there is no data directory, socket or server collation, so those lines do not appear, and the version comment is the instance name. The connection limit is the sessions parameter, which can only be read with permission on V$PARAMETER: without it, the line is left out.
Keywords: server info, version, uptime, replication, variables
The Global variables, Global status, Session variables and Session status tabs list every server variable and status counter with its current value. Type in the filter field in the toolbar to narrow the list: it matches the name or the value.
SQL Server
With SQL Server, Global variables are sys.configurations —what sp_configure changes, with the value in use— and the server properties, prefixed SERVERPROPERTY.; Global status holds the performance counters and sys.dm_os_sys_info; Session variables are your connection's SET options, and Session status is your session's row in sys.dm_exec_sessions.
PostgreSQL
With PostgreSQL, Global variables are all of pg_settings, with the unit next to the value; Global status adds up pg_stat_database across databases and counts connections from pg_stat_activity; Session variables lists only what your connection has changed, so it is usually empty, and Session status is your connection's row in pg_stat_activity.
ClickHouse
With ClickHouse, Global status gathers system.metrics —what is happening now, with the prefix metrics.—, system.events —accumulated since startup, events.— and system.asynchronous_metrics —sampled every second, asynchronous_metrics.—; Global variables gathers system.settings (settings.) and system.server_settings (server_settings.).
Oracle
With Oracle, Global variables is V$PARAMETER; Global status is the V$SYSSTAT counters, accumulated since startup; Session variables are NLS_SESSION_PARAMETERS and the SYS_CONTEXT('USERENV', …) values, prefixed USERENV., and Session status is the V$SESSTAT counters of the connection doing the read. The V$ views require SELECT_CATALOG_ROLE: without it, the three tabs that use them say why they are empty, with the server's text, and only Session variables fills in.
Keywords: SHOW VARIABLES, SHOW STATUS, variables, status, filter
Size in MB of each database and table on the server.
Where it is: Server Information › HDD Usage Tab
The HDD Usage tab shows a table with the schema, the table, its size in MB and its rows, and the total below. Use the minimum MB filter in the toolbar to show only large tables.
MySQLMariaDBAurora
A last column gives each table's storage engine. The figures come from information_schema, so they need permissions on it, and the rows of an InnoDB table are an estimate.
SQL Server
With SQL Server it lists every database your login can open, with its schema (demo.dbo), and the size counts data and indexes. There is no storage engine column.
PostgreSQL
With PostgreSQL it lists the tables of the connected database in every schema, pg_catalog included; the size counts indexes and TOAST, and the rows are the planner's estimate: a table that has never been analyzed shows —. There is no storage engine column.
ClickHouse
With ClickHouse the figures add up the active parts in system.parts, so the rows are exact and not an estimate, and the Compression column says how many times larger the uncompressed table is than what it takes on disk. The Engine column names each table's engine (MergeTree, ReplicatedMergeTree…).
Oracle
With Oracle the size adds up the segments of the table, its LOBs and its indexes. With permission to read DBA_SEGMENTS every schema is listed; without it, only the tables in your own schema, and other schemas don't appear. Rows are the last gathered statistics, so the column is called Rows (estimated) and Statistics from sits next to it with its date; a table that has never been analyzed shows —. There is no storage engine column.
Keywords: HDD, disk, size, MB, information_schema, storage, space
Automatically refresh data and export information to a file.
Where it is: Server Information › Auto-Refresh / Export
The Server Info toolbar includes:
- Auto-refresh toggle — enable it to reread the visible tab every few seconds; the counter next to it shows how long is left, and its arrows change the interval between 5 and 300 seconds, in steps of 5.
- Refresh — rereads the visible tab right away.
- Export — shares the visible tab as tab-separated text (TSV), filtered and sorted as you see it; HDD Usage goes out with a header row naming its columns.
Keywords: auto-refresh, export, refresh, save variables, update
Which counters show in amber with a triangle in Global status, and why with some engines none is flagged.
Where it is: Workspace › Tools › Server Information
In Global status, and also in Global variables, a counter that signals a problem shows in amber with a triangle as soon as its value is above zero. Which counters count as a problem is declared by each engine; with an engine that declares none, nothing is flagged.
MySQLMariaDBAurora
With MySQL, MariaDB and Aurora the flagged counters are the aborted connections, the table lock waits, the connection errors and the InnoDB deadlocks.
Keywords: counters, amber, warning, aborted connections, deadlocks, server information
How to sort each list and how to copy a value or a whole row.
Where it is: Workspace › Tools › Server Information
On the Mac, click a column header to sort the list by that column, and use a row’s context menu to copy its value or the whole row, separated by tabs; in HDD Usage, only the row.
Outside the Mac, the Sort by menu chooses the column, and choosing it again reverses the order. Tapping a row copies its value and shows a green mark, and touching and holding it offers both copies.
Keywords: sort, order, copy, row, value, server information