먼저 ClickHouse 서버에서 Looker 사용자를 구성합니다. ClickHouse 데이터베이스 사용자는 CREATE USER 명령어로 생성되지 않습니다. ClickHouse 액세스 권한 문서에 따라 users.xml 파일에서 users 섹션을 구성합니다. 다음은 기본 예시입니다.
연결 세부정보를 작성합니다. 대다수의 설정은 대부분의 데이터베이스 언어에 공통적으로 적용됩니다. 자세한 내용은 데이터베이스에 Looker 연결 문서 페이지를 참조하세요. 다음은 일부 설정에 대한 설명입니다.
언어: ClickHouse
호스트: 연결 가능한 호스트 이름
포트: HTTP(S)를 통해 ClickHouse 서비스를 연결할 수 있는 포트
기본적으로 HTTP 연결은 8123을 사용하고 HTTPS는 8443을 사용합니다.
포트 9000 및 9440은 기본적으로 ClickHouse 명령줄 클라이언트에서 사용되지만 Looker에서 이러한 포트를 사용하여 ClickHouse에 연결할 수 없습니다.
ClickHouse 관리자가 ClickHouse 구성에서 http_port/https_port 설정으로 대체 포트를 선택했을 수 있습니다. ClickHouse 관리자에게 로컬 구성에 적합한 설정을 요청하세요.
데이터베이스: 데이터베이스 이름(users.xml 파일에서 허용되는 데이터베이스 중 하나여야 함)
사용자 이름: 데이터베이스 사용자 이름
비밀번호: 데이터베이스 비밀번호
추가 JDBC 매개변수: (선택사항)추가적인 JDBC 매개변수입니다.
유지보수 일정: ClickHouse는 PDT를 지원하지 않으므로 이 설정은 무시해도 됩니다.
SSL: SSL을 통해 ClickHouse에 연결하려면 선택합니다.
SSL 인증: (선택사항) ClickHouse 서버에 엄격한 호스트 이름 인증을 시행하려면 선택합니다. 일반적으로 신뢰할 수 있는 인증 기관에서 서명한 SSL 인증서를 사용하는 경우에만 이 옵션을 선택하세요. 자체 서명 SSL 인증서를 사용하는 경우 선택 해제된 상태로 둡니다.
제대로 연결되었는지 확인하려면 테스트를 클릭합니다. 문제 해결 정보는 데이터베이스 연결 테스트 문서 페이지를 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# ClickHouse\n\n| **Note:** Looker supports ClickHouse version 0.2 and higher.\n\nEncrypting network traffic\n--------------------------\n\nIt is a best practice to encrypt network traffic between the Looker application and your database. Consider one of the options described on the [Enabling secure database access](/looker/docs/enabling-secure-db-access) documentation page.\n\nTo enable SSL encryption on the server side, see the [ClickHouse Global Server Settings documentation](https://ClickHouse.yandex/docs/en/operations/server_settings/settings/#server_settings-openssl).\n\nUsers and security\n------------------\n\nFirst, configure your Looker user on the ClickHouse server. ClickHouse database users are not created with the `CREATE USER` command. Follow the [ClickHouse access rights documentation](https://clickhouse.yandex/docs/en/operations/access_rights/) to configure the `users` section in the `users.xml` file. Here is a basic example: \n\n \u003c!-- Users and ACL. --\u003e\n \u003cusers\u003e\n \u003clooker\u003e\n \u003cpassword\u003eCHANGEIT\u003c/password\u003e\n \u003cnetworks incl=\"networks\" /\u003e\n \u003cprofile\u003edefault\u003c/profile\u003e\n \u003cquota\u003edefault\u003c/quota\u003e\n \u003c/looker\u003e\n\n \u003cweb\u003e\n \u003cpassword\u003e\u003c/password\u003e\n \u003cnetworks incl=\"networks\" /\u003e\n \u003cprofile\u003eweb\u003c/profile\u003e\n \u003cquota\u003edefault\u003c/quota\u003e\n \u003callow_databases\u003e\n \u003cdatabase\u003etest\u003c/database\u003e\n \u003c/allow_databases\u003e\n \u003callow_dictionaries\u003e\n \u003cdictionary\u003etest\u003c/dictionary\u003e\n \u003c/allow_dictionaries\u003e\n \u003c/web\u003e\n \u003c/users\u003e\n\nAlso within this file, configure the appropriate database access. \n\n \u003callow_databases\u003e\n \u003cdatabase\u003edatabase_1\u003c/database\u003e\n \u003cdatabase\u003edatabase_2\u003c/database\u003e\n \u003cdatabase\u003edatabase_3\u003c/database\u003e\n \u003c/allow_databases\u003e\n\nCreating the Looker connection to your database\n-----------------------------------------------\n\nIn the **Admin** section of Looker, select **Connections** , and then click **Add Connection**.\n\nFill out the connection details. The majority of the settings are common to most database dialects. See the [Connecting Looker to your database](/looker/docs/connecting-to-your-db) documentation page for information. Some of the settings are described next:\n\n- **Dialect**: ClickHouse.\n- **Host**: Reachable hostname.\n- **Port** : Port on which the ClickHouse service is reachable over HTTP(S).\n - By default, HTTP connections will use 8123, and HTTPS will use 8443.\n - Port 9000 and 9440 are by default used by the ClickHouse command line client, but these ports cannot be used by Looker to connect to ClickHouse.\n - Your ClickHouse administrator may have chosen alternate ports with the [`http_port/https_port`](https://ClickHouse.yandex/docs/en/operations/server_settings/settings/#http-port-https-port) settings in the ClickHouse configuration. Ask your ClickHouse admin for the settings appropriate to your local configuration.\n- **Database** : Database name (must be one of the databases allowed in the `users.xml` file).\n- **Username**: Database username.\n- **Password**: Database password.\n- **Additional JDBC parameters**: (Optional) Additional JDBC string parameters.\n- **Maintenance Schedule**: ClickHouse does not support PDTs, so this setting can be ignored.\n- **SSL**: Check to connect to ClickHouse over SSL.\n- **Verify SSL**: (Optional) Check to enforce strict hostname verification on the ClickHouse server. Check this only if you are using an SSL certificate that is signed by a generally trusted Certificate Authority. If you are using a self-signed SSL certificate, leave it unchecked.\n\nTo verify that the connection is successful, click **Test** . See the [Testing database connectivity](/looker/docs/testing-db-connectivity) documentation page for troubleshooting information.\n\nTo save these settings, click **Connect**.\n\nFeature support\n---------------\n\nFor Looker to support some features, your database dialect must also support them.\n\nClickHouse supports the following features as of Looker 25.14:"]]
