📣

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

Get Started

Overview

Quick Start

Guides

Connect
Manage Resources
Data Integration
Load Data
Unload Data
Multimodal Data Analytics
Performance Tuning
Security & Reliability
Management

Troubleshooting

Tutorials

Ingest & Stream Data
Migrate Data

Reference

SQL Reference
General Reference

Support Services

SHOW WORKERS

Note

Introduced in v1.3.0.

Lists workers in the current tenant.

Note

This command requires cloud control to be enabled.

Syntax

SHOW WORKERS

Output

SHOW WORKERS returns the following columns:

Column	Description
`name`	Worker name
`tags`	Worker tags in JSON format
`options`	Worker options in JSON format
`created_at`	Worker creation timestamp
`updated_at`	Worker update timestamp

Examples

SHOW WORKERS;

Sample output:

read_env,{},"{""auto_resume"":""true"",""auto_suspend"":""300"",""max_cluster_count"":""3"",""min_cluster_count"":""1"",""size"":""small""}",2026-04-23T11:40:27.942797+00:00,2026-04-23T11:40:27.942797+00:00

CREATE WORKER - Create a worker
ALTER WORKER - Modify worker tags, options, or state
DROP WORKER - Remove a worker

SHOW WORKERS

Syntax

Output

Examples

Related Topics

Was this page helpful?