azure_* 세션 설정

이 설정들은 ClickHouse가 Azure Blob Storage와 연동할 때의 업로드, 타임아웃, 오류 처리 동작을 제어해요. ClickHouse 소스 코드에서 자동으로 생성된 세션 설정 문서예요.

출처: 문서

본문

이 설정들은 system.settings에서 사용할 수 있으며 소스 코드에서 자동으로 생성돼요.

azure_allow_parallel_part_upload

Azure 멀티파트 업로드에 여러 스레드를 사용해요.

azure_check_objects_after_upload

Azure blob storage에 업로드된 각 객체를 확인해 업로드가 성공했는지 검증해요.

azure_connect_timeout_ms

azure 디스크의 호스트에 대한 연결 타임아웃이에요.

azure_create_new_file_on_insert

azure 엔진 테이블에서 각 삽입 시 새 파일을 만들지 여부를 활성화하거나 비활성화해요.

azure_ignore_file_doesnt_exist

특정 키를 읽을 때 파일이 없으면 부재를 무시해요.

가능한 값:

1 — SELECT가 빈 결과를 반환.
0 — SELECT가 예외를 발생.

azure_list_object_keys_size

ListObject 요청이 한 번에 반환할 수 있는 최대 파일 수예요.

azure_min_upload_part_size

Azure blob storage로의 멀티파트 업로드 중 업로드할 파트의 최소 크기예요.

azure_request_timeout_ms

azure와 데이터를 주고받을 때의 유휴(idleness) 타임아웃이에요. 단일 TCP 읽기 또는 쓰기 호출이 이 시간만큼 블로킹하면 실패로 간주해요.

azure_skip_empty_files

S3 엔진에서 빈 파일을 건너뛸지 여부를 활성화하거나 비활성화해요.

가능한 값:

0 — 빈 파일이 요청된 포맷과 호환되지 않으면 SELECT가 예외를 발생.
1 — 빈 파일에 대해 SELECT가 빈 결과를 반환.

azure_strict_upload_part_size

Azure blob storage로의 멀티파트 업로드 중 업로드할 파트의 정확한 크기예요.

azure_throw_on_zero_files_match

glob 확장 규칙에 따라 일치하는 파일이 0개이면 오류를 발생해요.

가능한 값:

1 — SELECT가 예외를 발생.
0 — SELECT가 빈 결과를 반환.

azure_truncate_on_insert

azure 엔진 테이블에서 삽입 전 잘라내기(truncate)를 활성화하거나 비활성화해요.

azure_use_adaptive_timeouts

true로 설정하면 모든 azure 요청에 대해 처음 두 번의 시도는 낮은 송신·수신 타임아웃으로 수행돼요. false로 설정하면 모든 시도가 동일한 타임아웃으로 수행돼요.

azure_* 세션 설정