메인 콘텐츠로 건너뛰기
Deepnote는 팀이 인사이트를 발견하고 공유할 수 있도록 설계된 협업용 데이터 노트북입니다. Jupyter와 호환될 뿐만 아니라 클라우드에서 실행되며, 데이터 과학 프로젝트를 효율적으로 협업하고 진행할 수 있는 단일 작업 공간을 제공합니다. 이 가이드는 이미 Deepnote 계정이 있고 실행 중인 ClickHouse 인스턴스가 있다고 가정합니다.

대화형 예시

Deepnote 데이터 노트북에서 ClickHouse를 쿼리하는 대화형 예시를 확인하려면, 아래 버튼을 클릭하여 ClickHouse playground에 연결된 템플릿 프로젝트를 실행하세요. Deepnote에서 실행

ClickHouse에 연결하기

  1. Deepnote에서 “Integrations” 개요를 선택한 다음 ClickHouse 타일을 클릭합니다.
  1. ClickHouse 인스턴스의 연결 정보를 입력합니다.
HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.
매개변수설명
HOST and PORT일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.
DATABASE NAME기본적으로 default라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오.
USERNAME and PASSWORD기본 사용자 이름은 default입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.
ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오. HTTPS를 선택하십시오. 연결 정보가 예시 curl 명령으로 표시됩니다. 자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다. 참고: ClickHouse 연결이 IP 액세스 목록으로 보호되는 경우 Deepnote의 IP 주소를 허용해야 할 수 있습니다. 자세한 내용은 Deepnote 문서를 참조하십시오.
  1. 축하합니다! 이제 Deepnote에 ClickHouse가 통합되었습니다.

ClickHouse 통합 사용하기.

  1. 먼저 노트북 오른쪽에 있는 ClickHouse 통합에 연결하세요.
  2. 이제 새 ClickHouse 쿼리 블록을 만들고 데이터베이스에 쿼리를 실행하세요. 쿼리 결과는 DataFrame으로 저장되며, SQL 블록에서 지정한 변수에 할당됩니다.
  3. 기존 SQL 블록을 ClickHouse 블록으로 변환할 수도 있습니다.
마지막 수정일 2026년 6월 10일