sdbcli

A fast, scriptable CLI for the SelectDB Cloud control plane. It manages warehouses, clusters, networking, billing, and audit logs over the SelectDB Cloud Management API v1 and returns structured JSON. It does not run SQL — data-plane work (queries, loads, tablet/profile inspection) is handed off to its sibling doriscli.

Install

npm install -g @selectdb/sdbcli
sdbcli --version

This package ships a prebuilt native binary. On install, npm automatically pulls only the platform package that matches your OS + CPU (via optionalDependencies

• os/cpu constraints), so there is no compile step and no Rust toolchain needed.

Supported platforms: macOS (arm64), Linux (x64, arm64). On any other platform, build from source.

Quick start

# Register an environment with your Cloud Management API key. auth add probes the
# API and, if your org has exactly one warehouse and cluster, picks them as the
# current context automatically.
sdbcli auth add prod --api-key sk-xxxxxxxx --api-host api.selectdb.com

# Confirm the key works and see what context was picked.
sdbcli auth status
sdbcli cloud ctx

# Explore the control plane.
sdbcli cloud warehouse ls
sdbcli cloud cluster ls

See the full documentation for warehouses, clusters, endpoints, public-access, privatelink, billing, and audit.

License

Proprietary software, distributed under npm's UNLICENSED (all rights reserved); not open source.