clickhouse-cloud-management — скилл для Claude Code: установка
Скилл clickhouse-cloud-management помогает управлять пользователями и правами доступа в ClickHouse Cloud через SQL-запросы по HTTPS.
MIT 126 установок ★ 3 обновлён 2026-10-25
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/clickhouse-cloud-management/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/clickhouse-cloud-management/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a codex2Вручную: положить файлы
.agents/skills/clickhouse-cloud-management/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a cursor2Вручную: положить файлы
.cursor/skills/clickhouse-cloud-management/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/devops-tools/skills/clickhouse-cloud-management2Вручную: положить файлы
.github/skills/clickhouse-cloud-management/SKILL.md1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a gemini-cli2Командой платформы
gemini skills install https://github.com/terrylica/cc-skills --path plugins/devops-tools/skills/clickhouse-cloud-managementВручную: положить файлы
.devin/skills/clickhouse-cloud-management/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill clickhouse-cloud-management -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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