> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> DBeaver — это кроссплатформенный инструмент для работы с базами данных.

# Подключите DBeaver к ClickHouse

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Партнерская интеграция
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

DBeaver доступен в нескольких редакциях. В этом руководстве используется [DBeaver Community](https://dbeaver.io/). С другими редакциями и их возможностями можно ознакомиться [здесь](https://dbeaver.com/edition/). DBeaver подключается к ClickHouse через JDBC.

<Note>
  Используйте DBeaver версии 23.1.0 или выше для улучшенной поддержки столбцов `Nullable` в ClickHouse.
</Note>

<div id="1-gather-your-clickhouse-details">
  ## 1. Подготовьте параметры подключения к ClickHouse
</div>

DBeaver использует JDBC через HTTP(S) для подключения к ClickHouse; вам понадобятся:

* конечная точка
* номер порта
* имя пользователя
* пароль

<div id="2-download-dbeaver">
  ## 2. Скачайте DBeaver
</div>

DBeaver можно скачать по адресу [https://dbeaver.io/download/](https://dbeaver.io/download/)

<div id="3-add-a-database">
  ## 3. Добавьте базу данных
</div>

* Используйте либо меню **Database > New Database Connection**, либо значок **New Database Connection** в **Database Navigator**, чтобы открыть диалоговое окно **Connect to a database**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-add-database.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=1aaa6d5f4f9344e2d996221376f86e82" size="md" border alt="Добавить новую базу данных" width="642" height="385" data-path="images/integrations/sql-clients/dbeaver-add-database.png" />

* Выберите **Analytical**, затем **ClickHouse**:

* Сформируйте JDBC URL. На вкладке **Main** укажите Host, Port, Username, Password и Database:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-host-port.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=2880ca38e699745a52c1cc5c875f3150" size="md" border alt="Указать имя хоста, порт, пользователя, пароль и имя базы данных" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-host-port.png" />

* По умолчанию свойство **SSL > Use SSL** отключено. Если вы подключаетесь к ClickHouse Cloud или серверу, для которого требуется SSL на HTTP-порту, включите **SSL > Use SSL**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-use-ssl.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=2ff3657152304f63ed59388d36da8332" size="md" border alt="Включить SSL при необходимости" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-use-ssl.png" />

* Проверьте подключение:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-test-connection.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=8d9a58768ccdb28866e52e67251c8766" size="md" border alt="Проверить подключение" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.png" />

Если DBeaver обнаружит, что у вас не установлен драйвер ClickHouse, он предложит загрузить его:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-download-driver.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=2ed194ee304fbf20c54c19a20dd156f8" size="md" border alt="Загрузить драйвер ClickHouse" width="612" height="689" data-path="images/integrations/sql-clients/dbeaver-download-driver.png" />

* После загрузки драйвера снова **проверьте** подключение:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-test-connection.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=8d9a58768ccdb28866e52e67251c8766" size="md" border alt="Проверить подключение" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.png" />

<div id="4-query-clickhouse">
  ## 4. Выполните запрос к ClickHouse
</div>

Откройте редактор запросов и выполните запрос.

* Щёлкните правой кнопкой мыши по вашему подключению и выберите **SQL Editor > Open SQL Script**, чтобы открыть редактор запросов:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-sql-editor.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=51f64d5ed1d4ffb0b5dc40735ddf870e" size="md" border alt="Открытие редактора SQL" width="636" height="162" data-path="images/integrations/sql-clients/dbeaver-sql-editor.png" />

* Пример запроса к `system.query_log`:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/dbeaver-query-log-select.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=b8f625368caba59e1e8ad7fb4a046756" size="md" border alt="Пример запроса" width="712" height="316" data-path="images/integrations/sql-clients/dbeaver-query-log-select.png" />

<div id="next-steps">
  ## Следующие шаги
</div>

О возможностях DBeaver см. в [вики DBeaver](https://github.com/dbeaver/dbeaver/wiki), а о возможностях ClickHouse — в [документации ClickHouse](/ru/).