ClickHouse를 Deepnote에 연결하기
Deepnote는 팀이 인사이트를 발굴하고 공유할 수 있도록 설계된 협업 데이터 노트북입니다. Jupyter와 호환될 뿐만 아니라 클라우드 환경에서 동작하며, 데이터 사이언스 프로젝트를 효율적으로 공동 작업할 수 있는 중앙 집중형 협업 공간을 제공합니다.
이 가이드는 Deepnote 계정과 실행 중인 ClickHouse 인스턴스를 이미 보유하고 있다고 가정합니다.
대화형 예제
Deepnote 데이터 노트북에서 ClickHouse에 쿼리하는 대화형 예제를 살펴보고 싶다면, 아래 버튼을 클릭하여 ClickHouse playground와 연결된 템플릿 프로젝트를 실행하십시오.
ClickHouse에 연결하기
- Deepnote에서 "Integrations" 개요 페이지를 선택한 다음 ClickHouse 타일을 클릭합니다.
- ClickHouse 인스턴스에 대한 연결 정보를 입력합니다:
HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다:
| Parameter(s) | Description |
|---|---|
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 Access List로 보호되어 있는 경우 Deepnote의 IP 주소를 허용해야 할 수 있습니다. 자세한 내용은 Deepnote 문서를 참조하십시오.
- 축하합니다! 이제 Deepnote에 ClickHouse 통합이 완료되었습니다.
ClickHouse 통합 사용하기.
-
먼저 노트북 오른쪽에 있는 ClickHouse 통합에 연결합니다.
-
이제 새 ClickHouse 쿼리 블록을 만들어 데이터베이스를 쿼리합니다. 쿼리 결과는 DataFrame으로 저장되고, SQL 블록에서 지정한 변수에 할당됩니다.
-
기존 SQL 블록을 ClickHouse 블록으로 변환할 수도 있습니다.
