> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Как получить сведения о подключении к Cloud

> Узнайте, как найти имя хоста, порт и учетные данные для вашего сервиса ClickHouse Cloud, чтобы подключаться к нему из внешних клиентов, CLI и приложений.

[All quickstarts](https://clickhouse.com/docs/get-started/quickstarts/home.md)

Real-time аналитикаХранилище данныхОбсервабилитиAI/MLCloud

На этой странице описано, как получить сведения о подключении к существующему сервису ClickHouse Cloud — имя хоста, номера портов, имя пользователя и пароль — из командной строки с помощью [ClickHouse CLI](https://clickhouse.com/docs/ru/concepts/features/interfaces/cli.md) (`clickhousectl`). Все команды, кроме входа в систему, выполняются в неинтерактивном режиме. `clickhousectl` выводит результат в формате JSON при указании флага `--json`, а также автоматически, если его запускает агент для программирования.

## Предварительные требования

Установите ClickHouse CLI:

```bash theme={null}
curl -fsSL https://clickhouse.com/cli | sh
```

Скрипт устанавливает `~/.local/bin/clickhousectl` и псевдоним `chctl`. Убедитесь, что каталог `~/.local/bin` добавлен в переменную `PATH`.

Также потребуется `jq`.

Для шагов, требующих доступа только для чтения (`service list`, `service get`), достаточно входа через браузер. При этом открывается окно браузера, поэтому завершить вход должен человек:

```bash theme={null}
clickhousectl cloud auth login
```

Вход через браузер даёт доступ только для чтения. Для описанных ниже шагов, изменяющих данные, нужен [ключ API](https://clickhouse.com/docs/ru/products/cloud/features/admin-features/api/openapi.md): `cloud service start` или `cloud service wake` (только если ваш сервис находится в состоянии `stopped` или `idle`) и `reset-password`. Чтобы войти с помощью ключа, выполните `clickhousectl cloud auth login --interactive`: команда запросит ключ и секрет, при этом секрет не попадёт в историю командной оболочки. Также можно передать параметры `--api-key` и `--api-secret` или задать переменные окружения `CLICKHOUSE_CLOUD_API_KEY` и `CLICKHOUSE_CLOUD_API_SECRET`. Агенту для программирования или скрипту следует использовать переменные окружения.

При входе проверяются учётные данные и выводится идентичность пользователя; её можно проверить в любой момент командой `clickhousectl cloud auth whoami`. Если вы состоите в нескольких организациях, добавляйте `--org-id <org-id>` (или `--org-name <name>`) к каждой команде `cloud service` в этом руководстве.

Кроме того, вам понадобится существующий сервис ClickHouse Cloud, из которого можно получить сведения о подключении, например созданный по руководству [Быстрый старт с Cloud](https://clickhouse.com/docs/ru/get-started/setup/cloud.md).

## Найдите свой сервис

Выведите список сервисов в вашей организации и запомните ID того, к которому хотите подключиться:

```bash theme={null}
clickhousectl cloud service list --json | jq -r '.[] | [.id, .name, .state] | @tsv'
```

```text theme={null}
9c2d4e61-7a35-49c8-8f0e-2b5a1d7c3e90	my-first-service	running
```

Сохраните ID сервиса — все остальные команды в этом руководстве принимают его в качестве аргумента. Чтобы найти его по имени:

```bash theme={null}
CH_ID=$(clickhousectl cloud service get --name my-first-service --json | jq -r .id)
```

Сервис должен быть запущен, чтобы на одном из следующих шагов проверить подключение. Если он находится в состоянии `stopped`, запустите его и опрашивайте состояние, пока оно не станет `running`:

```bash theme={null}
clickhousectl cloud service start "$CH_ID"
while [ "$(clickhousectl cloud service get "$CH_ID" --json | jq -r .state)" != "running" ]; do
  sleep 15
done
```

Сервис в состоянии `idle` из-за масштабирования при простое пробуждается автоматически при первом подключении, поэтому здесь никаких действий не требуется. Чтобы пробудить его заранее, выполните `clickhousectl cloud service wake "$CH_ID"` и опрашивайте состояние тем же способом.

## Получение сведений о подключении

`clickhousectl cloud service get` возвращает полные сведения о сервисе, включая по одной конечной точке для каждого открытого протокола. Сохраните ответ и извлеките из него нужные данные:

```bash theme={null}
clickhousectl cloud service get "$CH_ID" --json > service.json
jq '.endpoints' service.json
```

```json theme={null}
[
  {
    "host": "abc123.us-east-1.aws.clickhouse.cloud",
    "port": 9440,
    "protocol": "nativesecure"
  },
  {
    "host": "abc123.us-east-1.aws.clickhouse.cloud",
    "port": 8443,
    "protocol": "https"
  }
]
```

Это два основных сетевых протокола ClickHouse Cloud, каждый на своём порту:

* **Собственный протокол (`nativesecure`, порт 9440)** — бинарный протокол, используемый `clickhouse-client`, `clickhouse-local` и большинством драйверов для конкретных языков. Это самый быстрый вариант, поддерживающий все возможности ClickHouse. В Cloud требуется TLS.
* **Протокол HTTPS (`https`, порт 8443)** — интерфейс на основе HTTP, удобный для REST-клиентов, `curl`, веб-инструментов и драйверов, предпочитающих HTTP. В Cloud также требует TLS.

Оба протокола требуют шифрования TLS при подключении к ClickHouse Cloud — подключиться в открытом виде нельзя. Большинство инструментов делает это автоматически, если указан правильный порт, но в зависимости от клиента может потребоваться передать флаг `--secure` или задать `ssl=true`. В большинстве руководств по быстрому старту и сценариев работы с CLI в этой серии используется **собственный протокол на порту 9440**.

Извлеките имя хоста и порты:

```bash theme={null}
CH_HOST=$(jq -r '.endpoints[] | select(.protocol == "nativesecure") | .host' service.json)
CH_NATIVE_PORT=$(jq -r '.endpoints[] | select(.protocol == "nativesecure") | .port' service.json)
CH_HTTPS_PORT=$(jq -r '.endpoints[] | select(.protocol == "https") | .port' service.json)
```

Имя пользователя — `default`, если вы не создавали дополнительных пользователей базы данных.

## Получение пароля

Пароль пользователя `default` возвращается ровно один раз — командой `clickhousectl cloud service create`; впоследствии его нельзя получить ни через API, ни через CLI. Если вы сохранили пароль при создании сервиса, присвойте его переменной, которая используется в последующих шагах, и пропустите сброс:

```bash theme={null}
CH_PASSWORD='<your saved password>'
```

Если он утерян, сгенерируйте новый:

```bash theme={null}
CH_PASSWORD=$(clickhousectl cloud service reset-password "$CH_ID" --json | jq -r .password)
```

> [!WARNING]
>
> `reset-password` заменяет пароль пользователя `default`. Изменение вступает в силу через несколько секунд: до этого момента новый пароль отклоняется, а старый продолжает работать, поэтому при первом соединении какое-то время повторяйте попытки. После этого любой клиент, всё ещё настроенный на старый пароль, не сможет пройти аутентификацию. Если сервис входит в [хранилище](https://clickhouse.com/docs/ru/products/cloud/features/infrastructure/warehouses.md), пользователи базы данных являются общими для всех сервисов этого хранилища, поэтому сброс меняет пароль и во всех остальных сервисах хранилища. Как и исходный, новый пароль отображается только один раз, поэтому сохраните его в надёжном месте.

## Сохраните сведения о подключении для повторного использования

Эти сведения о подключении вам часто понадобятся в руководствах по быстрому старту. Чтобы не вводить их каждый раз заново, экспортируйте их как переменные окружения в текущем сеансе терминала:

```bash theme={null}
export CLICKHOUSE_HOST=$CH_HOST
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=$CH_PASSWORD
```

> [!WARNING]
>
> Эти переменные окружения действуют только в рамках текущего сеанса терминала. Не храните пароли в файлах профиля shell (`.bashrc`, `.zshrc`) и не коммитьте их в систему контроля версий.

## Проверка подключения

Проверьте HTTPS-интерфейс (порт 8443) с помощью `curl`:

```bash theme={null}
curl --user "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" \
  "https://$CLICKHOUSE_HOST:8443/?query=SELECT%201"
```

```text theme={null}
1
```

Проверьте собственный протокол (порт 9440) с помощью [**клиента ClickHouse**](https://clickhouse.com/docs/ru/concepts/features/interfaces/client.md). ClickHouse CLI сам управляет бинарным файлом `clickhouse`, поэтому, если его у вас ещё нет, команда `clickhousectl local use latest` установит последнюю версию ClickHouse и создаст символическую ссылку `~/.local/bin/clickhouse`. Затем:

```bash theme={null}
clickhouse client --host "$CLICKHOUSE_HOST" --secure --port 9440 \
  --user "$CLICKHOUSE_USER" --password "$CLICKHOUSE_PASSWORD" \
  --query "SELECT concat('Connected to ClickHouse ', version(), ' as ', currentUser())"
```

```text theme={null}
Connected to ClickHouse 26.2.1.558 as default
```

## Очистка

В этом руководстве только считываются метаданные сервиса и (при необходимости) сбрасывается пароль — новые облачные ресурсы не создаются, поэтому удалять нечего.

Единственное исключение: если ваш сервис находился в состоянии `stopped`, а вы запустили его только для проверки подключения, то теперь он продолжает работать, и за вычислительные ресурсы начисляется плата. Остановите его снова, если он вам пока не нужен:

```bash theme={null}
clickhousectl cloud service stop "$CH_ID"
```

## Дальнейшие шаги

Теперь у вас есть все сведения о подключении, необходимые для подключения к сервису ClickHouse Cloud из любого внешнего инструмента. Найденные здесь имя хоста, порт, username и password используются далее во всей серии быстрых стартов.

Далее ознакомьтесь со следующими быстрыми стартами:

* [Вставка данных с помощью клиента ClickHouse](https://clickhouse.com/docs/ru/get-started/quickstarts/insert-data-using-clickhouse-client.md)
* [Создание первой таблицы семейства MergeTree](https://clickhouse.com/docs/ru/get-started/quickstarts/create-your-first-mergetree-table.md)

Либо углубитесь в справочную документацию:

* [Нативный интерфейс (TCP)](https://clickhouse.com/docs/ru/concepts/features/interfaces/tcp.md)
* [HTTP-интерфейс](https://clickhouse.com/docs/ru/concepts/features/interfaces/http.md)
