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

# Cloud 연결 정보 확인

> 외부 클라이언트, CLI, 애플리케이션에서 연결할 수 있도록 ClickHouse Cloud 서비스의 호스트명, 포트, 자격 증명을 확인하는 방법을 알아봅니다.

<a href="/ko/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">모든 빠른 시작</Badge></a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">실시간 분석</Badge>
  <Badge size="lg" color="blue">데이터 웨어하우징</Badge>
  <Badge size="lg" color="blue">관측성</Badge>
  <Badge size="lg" color="blue">AI/ML</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## 사전 요구 사항
</div>

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [Create your first Cloud service](/get-started/quickstarts/create-your-first-service-on-cloud) quickstart first.

또한 연결 정보를 가져오려면 기존 ClickHouse Cloud 서비스가 필요하므로, [첫 번째 Cloud 서비스 만들기](/ko/get-started/quickstarts/create-your-first-service-on-cloud) 빠른 시작도 완료해야 합니다.

<div id="what-youll-build">
  ## 만들 내용
</div>

이 빠른 시작에서는 외부 클라이언트, CLI 도구 또는 애플리케이션에서 연결하는 데 필요한 ClickHouse Cloud 서비스의 연결 정보, 즉 호스트명, 포트 번호, 사용자 이름, 비밀번호를 찾는 방법을 알아봅니다.
이 과정을 마치면 Cloud 콘솔에서 이러한 정보를 어디서 확인할 수 있는지와 간단한 `curl` 명령으로 연결을 검증하는 방법을 알게 되므로 `clickhouse-local`, `clickhouse-client` 또는 다른 ClickHouse 드라이버에서 연결할 준비를 마치게 됩니다.

<Steps titleSize="h3">
  <Step>
    ### Cloud 콘솔 열기

    [ClickHouse Cloud 콘솔](https://console.clickhouse.cloud/)로 이동한 다음 계정에 로그인하십시오.

    기본 대시보드에서 연결하려는 서비스를 찾으십시오. 서비스가 유휴(idled) 상태이면 해당 서비스를 클릭한 뒤 다시 활성화될 때까지 기다렸다가 진행하십시오. 이후 단계에서 연결을 확인하려면 서비스가 실행 중이어야 합니다.
  </Step>

  <Step>
    ### 연결 정보 찾기

    서비스를 클릭해 세부 정보 페이지를 연 다음, 왼쪽 사이드바에서 **Connect** 버튼을 클릭하십시오:

    <img className="block dark:hidden w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-home-button/k6dUBbEUOmZKxz3v/images/get-started/quickstarts/connect-light.png?fit=max&auto=format&n=k6dUBbEUOmZKxz3v&q=85&s=bcada08a48f2f63f445e8a20ef5a7d8f" alt="ClickHouse Cloud 콘솔의 Connect 버튼(라이트 모드)" width="1050" height="964" data-path="images/get-started/quickstarts/connect-light.png" />

    <img className="hidden dark:block w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-home-button/k6dUBbEUOmZKxz3v/images/get-started/quickstarts/connect-dark.png?fit=max&auto=format&n=k6dUBbEUOmZKxz3v&q=85&s=1e40b31290d69bb5a9ec5387353cbe2b" alt="ClickHouse Cloud 콘솔의 Connect 버튼(다크 모드)" width="1034" height="960" data-path="images/get-started/quickstarts/connect-dark.png" />

    이 버튼을 처음 클릭하면 자격 증명이 표시된 대화 상자가 나타납니다:

    | 세부 정보        | 설명                      |
    | ------------ | ----------------------- |
    | **Username** | 사용자 이름(일반적으로 `default`) |
    | **Password** | 서비스용으로 생성된 비밀번호         |

    또한 여러 프로토콜과 인터페이스(`clickhouse-client`, HTTPS, JDBC 등)에 맞게 미리 구성된 예시 연결 문자열이 포함된 드롭다운도 제공되며, 이를 바로 복사할 수 있습니다.

    <Warning>
      자격 증명 파일을 다운로드하거나 비밀번호를 복사해 안전한 위치에 보관하십시오. 이 대화 상자를 닫으면 비밀번호를 다시 확인할 수 없습니다.
    </Warning>

    서비스 세부 정보 페이지에서 서비스 **호스트명**도 확인할 수 있습니다(예: `abc123.us-east-1.aws.clickhouse.cloud`). 자격 증명과 함께 이 값도 복사하십시오. 남은 단계 전체와 이후 빠른 시작에서도 계속 필요합니다.

    <Note>
      비밀번호를 분실한 경우 Cloud 콘솔에서 서비스의 **설정** 탭으로 이동해 재설정할 수 있습니다.
    </Note>
  </Step>

  <Step>
    ### 연결 프로토콜 이해하기

    ClickHouse Cloud는 두 가지 주요 네트워크 프로토콜을 제공하며, 각각 별도의 포트를 사용합니다:

    * **네이티브 프로토콜(포트 9440)** - `clickhouse-client`, `clickhouse-local`, 그리고 대부분의 언어별 드라이버가 사용하는 바이너리 프로토콜입니다. 가장 빠른 옵션이며 ClickHouse의 모든 기능을 지원합니다. Cloud에서는 TLS가 필요합니다.
    * **HTTPS 프로토콜(포트 8443)** - REST 클라이언트, `curl`, 웹 기반 도구, HTTP를 선호하는 드라이버에 유용한 HTTP 기반 인터페이스입니다. Cloud에서는 이 역시 TLS가 필요합니다.

    ClickHouse Cloud에 연결할 때는 두 프로토콜 모두 TLS 암호화가 필요하므로 plaintext로는 연결할 수 없습니다. 대부분의 도구는 올바른 포트를 지정하면 이를 자동으로 처리하지만, 클라이언트에 따라 `--secure` 플래그를 전달하거나 `ssl=true`를 설정해야 할 수도 있습니다.

    이 시리즈의 대부분의 빠른 시작과 CLI 워크플로에서는 **포트 9440의 네이티브 프로토콜**을 사용합니다.
  </Step>

  <Step>
    ### 재사용할 수 있도록 연결 정보 저장하기

    이러한 연결 정보는 빠른 시작 전반에서 자주 사용됩니다. 매번 다시 입력하지 않으려면 터미널 세션에서 환경 변수로 내보낼 수 있습니다:

    ```bash theme={null}
    export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
    export CLICKHOUSE_USER=default
    export CLICKHOUSE_PASSWORD=YOUR_PASSWORD
    ```

    값을 실제 호스트명, 사용자 이름, 비밀번호로 바꾸십시오.
    `clickhouse-client` 또는 `clickhouse-local`로 Cloud 서비스에 연결하려면 "Connect with:" 옆의 드롭다운에서 'Native'를 선택해 호스트명을 확인하십시오.
    표시된 연결 예시에서 `--host` 뒤에 나오는 호스트명을 복사하십시오.

    <Warning>
      이러한 환경 변수는 현재 터미널 세션에서만 유지됩니다. 비밀번호를 셸 프로필 파일(`.bashrc`, `.zshrc`)에 저장하거나 버전 관리에 커밋하지 마십시오.
    </Warning>
  </Step>
</Steps>

## 다음 단계

이제 외부 도구에서 ClickHouse Cloud 서비스에 연결하는 데 필요한 모든 연결 정보를 갖추었습니다. 여기서 확인한 호스트명, 포트, 사용자 이름, 비밀번호는 이후 빠른 시작 시리즈 전반에서 사용됩니다.

다음 빠른 시작도 확인해 보십시오:

* [clickhouse-client를 사용하여 데이터 삽입](/ko/get-started/quickstarts/insert-data-using-clickhouse-client)
* [첫 번째 MergeTree 테이블 만들기](/ko/get-started/quickstarts/create-your-first-mergetree-table)

또는 참고 문서를 통해 더 자세히 살펴보십시오:

* [네이티브 인터페이스 (TCP)](/ko/concepts/features/interfaces/tcp)
* [HTTP 인터페이스](/ko/concepts/features/interfaces/http)

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99-home-button/iOJBcv5hu2da8lsi/images/academy.png?fit=max&auto=format&n=iOJBcv5hu2da8lsi&q=85&s=102d3dcf8c90c04e86d2494a4b35541f" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.png" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/ko/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">모든 빠른 시작</Badge></a>
</div>