시작 스크립트

자동 스키마 생성 및 마이그레이션을 위해 ClickHouse의 SQL 시작 스크립트를 구성하고 사용하는 방법을 안내합니다

ClickHouse는 시작 시 서버 구성에서 임의의 SQL 쿼리를 실행할 수 있습니다. 이는 마이그레이션이나 자동 스키마 생성에 유용합니다.

<clickhouse>
    <startup_scripts>
        <throw_on_error>false</throw_on_error>
        <scripts>
            <query>CREATE ROLE OR REPLACE test_role</query>
        </scripts>
        <scripts>
            <query>CREATE TABLE TestTable (id UInt64) ENGINE=TinyLog</query>
            <condition>SELECT 1;</condition>
        </scripts>
        <scripts>
            <query>CREATE DICTIONARY test_dict (...) SOURCE(CLICKHOUSE(...))</query>
            <user>default</user>
        </scripts>
    </startup_scripts>
</clickhouse>

ClickHouse는 지정된 순서대로 startup_scripts의 모든 쿼리를 순차적으로 실행합니다. 쿼리 중 하나가 실패하더라도 이후 쿼리의 실행은 중단되지 않습니다. 그러나 throw_on_error가 true로 설정된 경우, 스크립트 실행 중 오류가 발생하면 서버가 시작되지 않습니다.

config에서 조건부 쿼리를 지정할 수 있습니다. 이 경우 해당 쿼리는 조건 쿼리가 값 1 또는 true를 반환할 때만 실행됩니다.

조건 쿼리가 1 또는 true 이외의 값을 반환하면 결과는 false로 해석되며, 해당 쿼리는 실행되지 않습니다.