시작 스크립트

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로 해석되며, 해당 쿼리는 실행되지 않습니다.