> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.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>
            Partner Integration
        </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는 JDBC를 사용해 ClickHouse에 연결합니다.

<Note>
  ClickHouse의 `Nullable` 컬럼 지원이 개선된 DBeaver 23.1.0 이상 버전을 사용하십시오.
</Note>

<div id="1-gather-your-clickhouse-details">
  ## 1. ClickHouse 연결 정보 수집
</div>

DBeaver는 HTTP(S) 기반 JDBC를 사용해 ClickHouse에 연결하므로 다음 정보가 필요합니다.

* endpoint
* 포트 번호
* 사용자 이름
* 비밀번호

<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** 메뉴 또는 **Database Navigator**의 **New Database Connection** 아이콘을 사용해 **Connect to a database** 대화 상자를 엽니다:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-add-database.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=bd3f45b1a41961a91a8253ce5f15242e" 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-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-host-port.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=59c59e348b8124981c6e8800f0d2a43e" size="md" border alt="호스트명, 포트, 사용자 이름, 비밀번호, 데이터베이스 이름 설정" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-host-port.png" />

* 기본적으로 **SSL > Use SSL** 속성은 설정되지 않습니다. ClickHouse Cloud 또는 HTTP 포트에서 SSL이 필요한 server에 연결하는 경우 **SSL > Use SSL**을 켭니다:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-use-ssl.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=b3f5d76c3bf280d4ac0f59cf970a918f" 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-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-test-connection.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=381f793440b6238e2a9304d0f033f828" 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-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-download-driver.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=66c8cf1d7e0375eee72e2b870b265bcb" size="md" border alt="ClickHouse 드라이버 다운로드" width="612" height="689" data-path="images/integrations/sql-clients/dbeaver-download-driver.png" />

* 드라이버를 다운로드한 후 연결을 다시 **Test**합니다:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-test-connection.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=381f793440b6238e2a9304d0f033f828" 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-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-sql-editor.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=dec493389745bf2ef76b23a1e23aa00b" size="md" border alt="SQL Editor 열기" width="636" height="162" data-path="images/integrations/sql-clients/dbeaver-sql-editor.png" />

* `system.query_log`에 대한 예시 쿼리:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/OHCdlXRrniGWimcZ/images/integrations/sql-clients/dbeaver-query-log-select.png?fit=max&auto=format&n=OHCdlXRrniGWimcZ&q=85&s=12e236175339e41679d0a029b1c76d30" 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 문서](/ko/)에서 확인하십시오.