Skip to content

Remove deprecated cloud service client command #148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sdairs merged 9 commits into from
May 14, 2026
Merged

Remove deprecated cloud service client command #148

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f804cab
Remove deprecated `cloud service client` command
sdairs May 12, 2026
6728d80
Bump rpassword to 7.5.2 to fix macOS build
sdairs May 12, 2026
448759c
Clean up stale `cloud service client` references
sdairs May 12, 2026
f88ea9e
Add scaling-schedule API coverage and resolve OpenAPI spec drift
sdairs May 13, 2026
de31260
Expose Beta endpoint status through the typed client
sdairs May 13, 2026
2b6214e
Track Beta status drift in the daily OpenAPI checker
sdairs May 13, 2026
e11d3bd
Anchor `cloud postgres (Beta)` label to spec metadata
sdairs May 13, 2026
d4fefe9
Revert CLI-side anchor for Postgres `(beta)` label
sdairs May 13, 2026
b33c078
Merge pull request #150 from ClickHouse/issue-149-openapi-drift-scali…
sdairs May 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 1 addition & 11 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,16 +313,6 @@ clickhousectl cloud service create --name my-service \
clickhousectl cloud service start <service-id>
clickhousectl cloud service stop <service-id>

# Connect to a cloud service with clickhouse-client
clickhousectl cloud service client --name my-service --password secret
clickhousectl cloud service client --id <service-id> -q "SELECT 1" --password secret

# Use CLICKHOUSE_PASSWORD env var (recommended for scripts/agents)
CLICKHOUSE_PASSWORD=secret clickhousectl cloud service client --name my-service -q "SELECT count() FROM system.tables"

# Use a local client version instead of auto-downloading the matching one
clickhousectl cloud service client --name my-service --allow-mismatched-client-version

# Run SQL over HTTP via the Query API (no local clickhouse binary needed)
clickhousectl cloud service query --name my-service --query "SELECT 1"
clickhousectl cloud service query --id <service-id> --query "SELECT count() FROM system.tables" --format JSONEachRow
Expand Down Expand Up @@ -420,7 +410,7 @@ For existing services without a stored key, `cloud service query` provisions one

Per-service scoping is enforced at the query endpoint binding, which is created with role `sql_console_admin` (read + write inside the bound service only). The API key itself has no org-level roles, so the binding is the only thing that grants it any access. `cloud service delete` removes the stored key from `credentials.json`.

`cloud service query` is the canonical way to run SQL against a cloud service; `cloud service client` (which downloads a matching `clickhouse` binary and connects via the native protocol) is on a deprecation path.
`cloud service query` is the canonical way to run SQL against a cloud service.

Set `CLICKHOUSE_CLOUD_QUERY_HOST` to override the Query API host (defaults to `https://queries.clickhouse.cloud`).

Expand Down
Loading
Loading