> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# s3_* 세션 설정
> s3_* 자동 생성 그룹의 ClickHouse 세션 설정입니다.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
유형
{type}
기본값
{default_value}
{changeable_without_restart &&
재시작 없이 변경 가능
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
이러한 설정은 [system.settings](/docs/ko/reference/system-tables/settings)에서 확인할 수 있으며, [소스](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)를 기반으로 자동 생성됩니다.
## s3\_check\_objects\_after\_upload
업로드 성공 여부를 확인하기 위해 S3에 업로드된 각 객체에 대해 HEAD 요청을 수행합니다
## s3\_connect\_timeout\_ms
S3 디스크의 호스트에 대한 연결 타임아웃입니다.
## s3\_create\_new\_file\_on\_insert
S3 엔진 테이블에서 각 삽입 시 새 파일을 생성할지 여부를 설정합니다. 활성화하면 각 삽입마다 key를 사용해 다음 패턴과 유사한 새 S3 객체가 생성됩니다.
initial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz` 등
가능한 값:
* 0 — `INSERT` 쿼리는 새 파일을 생성하며, 파일이 이미 존재하고 s3\_truncate\_on\_insert가 설정되지 않은 경우 실패합니다.
* 1 — `INSERT` 쿼리는 s3\_truncate\_on\_insert가 설정되지 않은 경우 각 삽입마다 suffix를 사용해(두 번째 파일부터) 새 파일을 생성합니다.
자세한 내용은 [여기](/docs/ko/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data)를 참조하십시오.
## s3\_disable\_checksum
파일을 S3로 전송할 때 체크섬을 계산하지 않습니다. 이렇게 하면 파일에 대해 불필요하게 많은 처리 패스를 거치지 않아 쓰기 속도가 빨라집니다. 일반적으로는 안전합니다. 어차피 MergeTree 테이블의 데이터는 ClickHouse가 체크섬으로 검증하며, HTTPS를 통해 S3에 접근하는 경우 네트워크 전송 중 무결성은 이미 TLS 계층에서 보장됩니다. 다만 S3에서 추가 체크섬을 사용하면 심층 방어 효과를 얻을 수 있습니다.
## s3\_ignore\_file\_doesnt\_exist
특정 키를 읽을 때 파일이 존재하지 않으면 해당 파일의 부재를 무시합니다.
가능한 값:
* 1 — `SELECT`는 빈 결과를 반환합니다.
* 0 — `SELECT`는 예외를 발생시킵니다.
## s3\_list\_object\_keys\_size
ListObject 요청으로 한 번에 반환할 수 있는 최대 파일 수
## s3\_min\_upload\_part\_size
S3에 멀티파트 업로드를 수행할 때 업로드할 파트의 최소 크기입니다.
## s3\_path\_filter\_limit
글롭 목록 조회 대신 파일 반복 처리에 사용하기 위해 쿼리 필터에서 추출할 수 있는 `_path` 값의 최대 개수입니다.
0은 비활성화를 의미합니다.
## s3\_request\_timeout\_ms
S3로 데이터를 송수신할 때의 유휴 상태 타임아웃입니다. 단일 TCP read 또는 write 호출이 이 시간 동안 블로킹되면 실패합니다.
## s3\_skip\_empty\_files
[S3](/docs/ko/reference/engines/table-engines/integrations/s3) 엔진 테이블에서 빈 파일을 건너뛸지 여부를 설정합니다.
가능한 값:
* 0 — 빈 파일이 요청한 포맷과 호환되지 않으면 `SELECT`가 예외를 발생시킵니다.
* 1 — 빈 파일에 대해 `SELECT`는 빈 결과를 반환합니다.
## s3\_slow\_all\_threads\_after\_network\_error
`true`로 설정하면 동일한 백업 엔드포인트로 S3 요청을 수행하는 스레드 중 하나에서
socket timeout과 같은 재시도 가능한 네트워크 오류가 발생한 후,
해당 엔드포인트로 S3 요청을 수행하는 모든 스레드의 처리가 느려집니다.
`false`로 설정하면 각 스레드는 다른 스레드와 관계없이 S3 요청의 백오프를 개별적으로 처리합니다.
## s3\_strict\_upload\_part\_size
S3에 멀티파트 업로드를 수행할 때 업로드할 파트의 정확한 크기입니다(일부 구현은 가변 크기의 파트를 지원하지 않습니다).
## s3\_throw\_on\_zero\_files\_match
ListObjects 요청으로 일치하는 파일을 하나도 찾지 못하면 오류를 발생시킵니다
## s3\_truncate\_on\_insert
S3 엔진 테이블에서 삽입 전에 truncate를 수행할지 설정합니다. 비활성화하면 S3 객체가 이미 존재할 경우 삽입을 시도할 때 예외가 발생합니다.
가능한 값:
* 0 — `INSERT` 쿼리는 새 파일을 생성하거나, 파일이 이미 존재하고 s3\_create\_new\_file\_on\_insert가 설정되어 있지 않으면 실패합니다.
* 1 — `INSERT` 쿼리는 파일의 기존 내용을 새 데이터로 대체합니다.
자세한 내용은 [여기](/docs/ko/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data)를 참조하십시오.
## s3\_uri\_style
S3 endpoint 스타일을 강제로 지정합니다. 가능한 값: auto, virtual\_hosted, path.
## s3\_use\_adaptive\_timeouts
`true`로 설정하면 모든 S3 요청에 대해 처음 두 번의 시도는 낮은 송신 및 수신 타임아웃으로 수행됩니다.
`false`로 설정하면 모든 시도가 동일한 타임아웃으로 수행됩니다.