К основному содержанию
скилл CX Codex

clickhouse-cloud-management — скилл для Claude Code: установка

Скилл clickhouse-cloud-management помогает управлять пользователями и правами доступа в ClickHouse Cloud через SQL-запросы по HTTPS.

MIT 126 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a claude-code
Открыть на GitHub

Что делает clickhouse-cloud-management

Скилл выполняет задачи администрирования ClickHouse Cloud без обращения к веб-консоли. Через HTTP-интерфейс и вызовы curl агент создаёт учётные записи, раздаёт права GRANT на конкретные базы данных и удаляет неактивных пользователей.

Публичный доступ в ClickHouse Cloud открыт только по HTTPS на 443 порту, поэтому нативный протокол без AWS PrivateLink не сработает. Пароли обязаны содержать от 12 символов, включая заглавную букву и спецсимвол, иначе сервис отклонит создание пользователя.

Какие задачи решает

  • создать пользователя базы данных с правами только на чтение
  • настроить доступ GRANT к нужным таблицам через SQL по HTTP
  • проверить подключение к облачному инстансу тестовым запросом SELECT 1
  • удалить учётную запись пользователя из ClickHouse Cloud

Примеры запросов агенту

  • Создай в ClickHouse Cloud пользователя только для чтения таблицы deribit.*
  • Проверь доступность облачной базы ClickHouse через запрос SELECT 1
  • Выдай права SELECT и INSERT для сервисного пользователя app_user

Как установить clickhouse-cloud-management

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/clickhouse-cloud-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/clickhouse-cloud-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о clickhouse-cloud-management

Как установить clickhouse-cloud-management в Claude Code?

Выполните команду npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a claude-code.

Что делает скилл clickhouse-cloud-management?

Он автоматизирует создание пользователей, настройку разрешений и проверку соединения с инстансами ClickHouse Cloud через HTTPS-запросы к порту 443.

Почему подключение выполняется через curl, а не через нативный протокол ClickHouse?

Публичные инстансы ClickHouse Cloud открывают только HTTPS-порт 443. Нативный бинарный протокол на порту 9440 доступен исключительно при корпоративной настройке через AWS PrivateLink.

Исходный текст

SKILL.md · MIT
---
name: clickhouse-cloud-management
description: ClickHouse Cloud user and permission management. TRIGGERS - create ClickHouse user, ClickHouse permissions, ClickHouse Cloud credentials.
allowed-tools: Read, Bash
---

# ClickHouse Cloud Management

ADR: 2025-12-08-clickhouse-cloud-management-skill

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Overview

ClickHouse Cloud user and permission management via SQL commands over HTTP interface. This skill covers database user creation, permission grants, and credential management for ClickHouse Cloud instances.

**Schema documentation principle**: All ClickHouse table/column COMMENTs are the single source of truth (SSoT). When creating tables or columns, always include COMMENT clauses. See `quality-tools:clickhouse-architect` for the full COMMENT SSoT policy.

## When to Use This Skill

Invoke this skill when:

- Creating database users for ClickHouse Cloud
- Managing user permissions (GRANT/REVOKE)
- Testing ClickHouse Cloud connectivity
- Troubleshooting authentication issues
- Understanding API key vs database user distinction

## Key Concepts

### Management Options

ClickHouse Cloud provides two management interfaces with different capabilities:

| Task                 | Via SQL (CLI/HTTP) | Via Cloud Console |
| -------------------- | ------------------ | ----------------- |
| Create database user | CREATE USER        | Supported         |
| Grant permissions    | GRANT              | Supported         |
| Delete user          | DROP USER          | Supported         |
| Create API key       | Not possible       | Only here         |

**Key distinction**: Database users (created via SQL) authenticate to ClickHouse itself. API keys (created via console) authenticate to the ClickHouse Cloud management API.

### Connection Details

ClickHouse Cloud exposes only HTTP interface publicly:

- **Port**: 443 (HTTPS)
- **Protocol**: HTTP (not native ClickHouse protocol)
- **Native protocol**: Requires AWS PrivateLink (not available without enterprise setup)

### Password Requirements

ClickHouse Cloud enforces strong password policy:

- Minimum 12 characters
- At least 1 uppercase letter
- At least 1 special character

Example compliant password: `StrongPass@2025!`

## Quick Reference

### Create Read-Only User

```bash
curl -s "https://default:PASSWORD@HOST:443/" --data-binary \
  "CREATE USER my_reader IDENTIFIED BY 'StrongPass@2025!' SETTINGS readonly = 1"
```

### Grant Database Access

```bash
curl -s "https://default:PASSWORD@HOST:443/" --data-binary \
  "GRANT SELECT ON deribit.* TO my_reader"
```

### Delete User

```bash
curl -s "https://default:PASSWORD@HOST:443/" --data-binary \
  "DROP USER my_reader"
```

For comprehensive SQL patterns and advanced permission scenarios, see [SQL Patterns Reference](./references/sql-patterns.md).

## Credential Sources

### 1Password Items (Engineering Vault)

| Item                                             | Purpose                                   |
| ------------------------------------------------ | ----------------------------------------- |
| ClickHouse Cloud - API Key (Admin)               | Cloud management API (console operations) |
| ClickHouse Cloud - API Key (Developer Read-only) | Cloud management API (read-only)          |
| gapless-deribit-clickhouse                       | Database `default` user credentials       |

### Retrieving Credentials

```bash
# Database credentials (for SQL commands)
op item get "gapless-deribit-clickhouse" --vault Engineering --reveal

# API key (for cloud management API)
op item get "ClickHouse Cloud - API Key (Admin)" --vault Engineering --reveal
```

## Common Workflows

### Workflow 1: Create Application User

1. Retrieve `default` user credentials from 1Password
2. Create new user with appropriate permissions:

```bash
HOST="your-instance.clickhouse.cloud"
PASSWORD="default-user-password"

# Create user
curl -s "https://default:$PASSWORD@$HOST:443/" --data-binary \
  "CREATE USER app_user IDENTIFIED BY 'AppPass@2025!'"

# Grant specific database access
curl -s "https://default:$PASSWORD@$HOST:443/" --data-binary \
  "GRANT SELECT, INSERT ON mydb.* TO app_user"
```

### Workflow 2: Verify User Exists

```bash
curl -s "https://default:$PASSWORD@$HOST:443/" --data-binary "SHOW USERS"
```

### Workflow 3: Test Connection

```bash
curl -s "https://user:password@HOST:443/" --data-binary "SELECT 1"
```

Expected output: `1` (single row with value 1)

## Troubleshooting

### Authentication Failed

- Verify password meets complexity requirements
- Check host URL includes port 443
- Ensure using HTTPS (not HTTP)

### Permission Denied

- Verify user has required GRANT statements
- Check database and table names are correct
- Confirm user was created with correct settings

### Connection Timeout

- ClickHouse Cloud only exposes port 443 publicly
- Native protocol (port 9440) requires PrivateLink
- Use HTTP interface with curl or clickhouse-client HTTP mode

## Next Steps After User Creation

<!-- ADR: 2025-12-10-clickhouse-skill-delegation -->

After creating a ClickHouse user, invoke **`devops-tools:clickhouse-pydantic-config`** to generate DBeaver configuration with the new credentials.

## Additional Resources

### Reference Files

For detailed patterns and advanced techniques, consult:

- **[references/sql-patterns.md](./references/sql-patterns.md)** - Complete SQL syntax reference with examples

## Python Driver Policy

For Python application code connecting to ClickHouse Cloud, use `clickhouse-connect` (official HTTP driver). See [`clickhouse-architect`](../../../quality-tools/skills/clickhouse-architect/SKILL.md#python-driver-policy) for recommended code patterns and why to avoid `clickhouse-driver` (community).

## Related Skills

- `quality-tools:clickhouse-architect` - Schema design, compression codecs, Python driver policy
- `devops-tools:clickhouse-pydantic-config` - DBeaver configuration generation
- `devops-tools:doppler-secret-validation` - For storing credentials in Doppler
- `devops-tools:doppler-workflows` - For credential rotation workflows


## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
clickhouse ClickHouse Подключает Claude к базам ClickHouse Cloud: просмотр схем, read-only SQL-запросы и правила по работе с ClickHouse. ★ 8звёзд репо huawei-cloud-mrs-clickhouse-sql-check huaweicloud Скилл huawei-cloud-mrs-clickhouse-sql-check проверяет ClickHouse SQL на синтаксические ошибки и нарушения спецификаций. Подходит для ревью запросов перед запуском на кластере. CX Codex +1 123установок clickhouse-best-practices ClickHouse Inc Скилл clickhouse-best-practices для Claude Code проверяет схемы таблиц, SQL-запросы, полнотекстовый поиск и вставку данных в ClickHouse по набору из 36 правил. CX Codex +1 23 400установок clickhouse-query civitai Скилл clickhouse-query гоняет ad-hoc запросы к ClickHouse прямо из чата с агентом: метрики, события, план выполнения. По умолчанию только чтение. CX Codex +1 ★ 7 327звёзд репо clickhouse-io affaan-m Скилл clickhouse-io для Claude Code помогает проектировать таблицы на движках MergeTree и ускорять медленные аналитические запросы. CX Codex +1 6 200установок hypequery ClickHouse hypequery MCP-сервер hypequery ClickHouse для Claude Code открывает агенту доступ к аналитике ClickHouse через размеченные датасеты и метрики. Прямой SQL блокируется, а реквизиты базы остаются скрытыми. CX Codex +1 ★ 106звёзд репо

Из того же набора79

Весь набор →
impl-standards Скилл impl-standards для Claude Code задаёт правила обработки ошибок, работы с константами, логирования прогресса и DI. Запускается при упоминании этих тем. CX Codex +1 126установок bootstrap-monorepo Скилл bootstrap-monorepo для развёртывания полиглот-монорепозитория на стеке moon, proto и Bun с типизированным слоем управления на TypeScript. CX Codex +1 126установок asciinema-converter Скилл asciinema-converter преобразует записи asciinema .cast в чистые .txt для чтения и поиска. Подходит для одиночных и пакетных конвертаций. CX Codex +1 126установок multi-agent-performance-profiling Скилл multi-agent-performance-profiling для параллельного профилирования многоуровневых систем. CX Codex +1 126установок booking-notify Скилл booking-notify отправляет уведомления о новых бронированиях, отменах и переносах через Telegram и Pushover. Синхронизация каждые 6 часов, вебхук для срочных событий. CX Codex +1 125установок implement-plan-preflight Скилл implement-plan-preflight запускает подготовительный этап ITP: создаёт ADR в формате MADR 4.0, спецификацию архитектуры и связывает их перекрёстными ссылками. CX Codex +1 125установок issues-workflow Скилл issues-workflow держит план, иерархию и статус в GitHub Issues: подзадачи под родителем, связка issue с веткой и PR, автозакрытие после мержа. CX Codex +1 124установок ml-failfast-validation Скилл ml-failfast-validation для Claude Code запускает быстрые проверки ML-экспериментов перед долгим обучением на GPU и выявляет ошибки данных и градиентов. CX Codex +1 124установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой