📣
TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

SHOW STREAMS



Lists the streams associated with a specific database.

Syntax

SHOW [ FULL ] STREAMS [ { FROM | IN } <database_name> ] [ LIKE '<pattern>' | WHERE <expr> ]
ParameterDescription
FULLLists the results with additional information. See Examples for more details.
FROM / INSpecifies a database. If omitted, the command returns the results from the current database.
LIKEFilters the stream names using case-sensitive pattern matching with the % wildcard.
WHEREFilters the stream names using an expression in the WHERE clause.

Examples

This example shows streams belonging to the current database:

SHOW STREAMS; ┌──────────────────────────────────────────────────────────┐ │ Streams_in_default │ table_on │ mode │ ├────────────────────┼───────────────────────┼─────────────┤ │ order_changes │ default.orders │ append_only │ │ s_append_only │ default.t_append_only │ append_only │ │ s_standard │ default.t_standard │ standard │ └──────────────────────────────────────────────────────────┘

This example shows detailed information about streams in the current database:

SHOW FULL STREAMS; ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ created_on │ name │ database │ catalog │ table_on │ owner │ comment │ mode │ invalid_reason │ ├────────────────────────────┼───────────────┼──────────┼─────────┼───────────────────────┼──────────────────┼─────────┼─────────────┼────────────────┤ │ 2024-05-12 14:28:33.886271 │ order_changes │ defaultdefault │ default.orders │ NULL │ │ append_only │ │ │ 2024-05-12 14:35:05.992050 │ s_append_only │ defaultdefault │ default.t_append_only │ NULL │ │ append_only │ │ │ 2024-05-12 14:35:05.981121 │ s_standard │ defaultdefault │ default.t_standard │ NULL │ │ standard │ │ └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Was this page helpful?