Redis and Valkey

Redis and Valkey work the same way in DBCatz. They have no tables, so a connection tab shows Keys · Command · Logs instead of Data and Structure, and the sidebar says so: use the key pattern.

Databases db0 to dbN

The database picker (mod+P) lists db0 … dbN with the number of keys in each. How many there are comes from the server’s databases setting — 16 by default. In a URL, /2 or ?db=2 opens db2 directly.

The Keys view

• Match — a pattern such as user:* or laravel_cache:*.
• Scan — runs SCAN with the pattern. Up to 1000 keys are shown; when there are more, it says N of M (narrow the pattern to see the rest).
• + Key (mod+shift+I) — create a key.
• Delete N (mod+backspace) — delete the selected keys. ⌘-clickCtrl-click selects several.

The value drawer

Click a key to open it in the drawer:

• the type badge;
• Rename — give the key a new name;
• TTL … — set the expiry in seconds; leave it empty for none;
• Delete;
• Formatted / Raw tabs for JSON and PHP serialize() values;
• Revert and Save, with an unsaved badge while you have changes.

Which types can be edited

Large values are cut: the drawer says Showing N of M elements, and such a value cannot be saved from the drawer; work on those with commands in the Command tab.

JSON values

A string holding JSON is shown pretty in Formatted, edited pretty, and saved compact again.

PHP serialize() values

Laravel’s jobs, cache and sessions are stored with PHP’s serialize(). Switch on PHP in the drawer and DBCatz shows them as readable objects, with the class names. Raw shows the stored string.

Create a key

+ Key (mod+shift+I — Table → Insert Row becomes new key here) asks for:

• the key’s name;
• its type — string, hash, list, set or zset;
• TTL s — seconds, or empty for none;
• the value.

Press Create key.

Flush keys

Database → Flush Keys… empties the current database. You type the database’s name to confirm — see Dropping and emptying.

The Command tab

Command (mod+T) is the query editor speaking redis-cli: one command per line, # for a comment, each line its own result.

• Autocomplete suggests commands with their argument syntax, key names from a live SCAN, and options. Ctrl+Space opens it with nothing typed.
• Click a reply row to open it in a drawer — Formatted / Raw, ↑ ↓ between rows, Copy, and the whole reply as JSON (HGETALL and CONFIG GET pairs as an object).
• Commands that can hurt — FLUSHALL, FLUSHDB, CONFIG, SHUTDOWN and the others — ask first, and are refused on a Read-only connection. The full list is on Production safety.

Export and backup

Redis and Valkey export as a Redis script — SET / RPUSH … lines for redis-cli — for the keys matching a pattern, and back up as part of a .tar.gz. Both import again. See Export, import and backup.

Links into a key

When DialCatz or a dbcatz:// link points at a “table” on Redis, it is a key, matched exactly. Ask DBCatz can set the key pattern for you (open keys).

Last updated 2026-11-01