구성

구성 (Configuration)

DuckDB에는 시스템의 동작을 바꾸는 데 사용할 수 있는 많은 구성 옵션이 있어요. SET 문이나 PRAGMA 문으로 설정하고, RESET 문으로 원래 값으로 되돌릴 수 있답니다. 함께 살펴볼까요?

출처: 문서

본문

DuckDB에는 시스템의 동작을 바꾸는 데 사용할 수 있는 많은 구성 옵션이 있어요.

구성 옵션은 [SET 문]({% link docs/current/sql/statements/set.md %})이나 [PRAGMA 문]({% link docs/current/configuration/pragmas.md %})으로 설정할 수 있어요. [RESET 문]({% link docs/current/sql/statements/set.md %}#reset)으로 원래 값으로 되돌릴 수 있어요.

구성 옵션의 값은 [current_setting() 스칼라 함수]({% link docs/current/sql/functions/utility.md %})나 [duckdb_settings() 테이블 함수]({% link docs/current/sql/meta/duckdb_table_functions.md %}#duckdb_settings)로 조회할 수 있어요. 예를 들어:

SELECT current_setting('memory_limit') AS memlimit;

또는:

SELECT value AS memlimit
FROM duckdb_settings()
WHERE name = 'memory_limit';

예시 (Examples)

시스템의 메모리 한도를 10 GB로 설정해요.

SET memory_limit = '10GB';

시스템이 1개 스레드를 사용하도록 구성해요.

SET threads TO 1;

로깅을 켜고 로깅 레벨을 debug로 설정해요. 로깅 레벨에 대한 추가 세부 사항은 [Log Level]({% link docs/current/operations_manual/logging/overview.md %}#log-level)을 참고하세요.

SET enable_logging = true;
SET logging_level = 'debug';

debug 레벨과 connection 범위로 단일 로그 메시지를 써요:

SELECT write_log('A new client has connected.', level := 'debug', scope := 'connection');

debug 레벨, connection 범위, 커스텀 log_type으로 단일 로그 메시지를 써요:

SELECT write_log(
        'A new duck has connected to the lake.', 
        level := 'debug', 
        scope := 'connection', 
        log_type := 'duckdb.docs.example.quack'
    );

DEBUG 로그 레벨로 로그를 확인해요:

SELECT * FROM duckdb_logs WHERE log_level = 'DEBUG';

QueryLog 타입으로 로그를 확인해요:

SELECT * FROM duckdb_logs WHERE type = 'QueryLog';

현재 로깅 설정을 확인해요:

SELECT * FROM duckdb_settings() WHERE name LIKE '%logging%';

오래 걸리는 쿼리 동안 진행률 막대 출력을 활성화해요:

SET enable_progress_bar = true;

기본 NULL 순서를 NULLS LAST로 설정해요:

SET default_null_order = 'nulls_last';

특정 설정의 현재 값을 반환해요:

SELECT current_setting('threads') AS threads;

특정 설정을 조회해요:

SELECT *
FROM duckdb_settings()
WHERE name = 'threads';

사용 가능한 모든 설정의 목록을 보여줘요:

SELECT *
FROM duckdb_settings();

시스템의 메모리 한도를 기본값으로 리셋해요:

RESET memory_limit;

Secrets 매니저 (Secrets Manager)

DuckDB에는 [Secrets 매니저]({% link docs/current/sql/statements/create_secret.md %})가 있는데, secrets를 사용하는 모든 백엔드(예: AWS S3)에서 통일된 사용자 인터페이스를 제공해요.

구성 참조 (Configuration Reference)

구성 옵션은 서로 다른 기본 [스코프]({% link docs/current/sql/statements/set.md %}#scopes)를 가져요: GLOBAL과 LOCAL. 아래는 스코프별 사용 가능한 모든 구성 옵션 목록이에요.

전역 구성 옵션 (Global Configuration Options)

로컬 구성 옵션 (Local Configuration Options)

더 알아보기 (Learn more)