> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# format_avro_* 포맷 설정

> format_avro_* 생성 그룹에 속한 ClickHouse 포맷 설정입니다.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["버전", "기본값", "설명"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        버전 이력
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이러한 설정은 [소스](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h)에서 자동 생성됩니다.

## format\_avro\_schema\_registry\_connection\_timeout

<SettingsInfoBlock type="NonZeroUInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "1"},{"label": "AvroConfluent 포맷에서 사용하는 Confluent 스키마 레지스트리 HTTP 클라이언트의 연결 타임아웃(초)을 제어하는 새로운 설정입니다."}]}]} />

AvroConfluent 포맷에서 사용하는 Confluent 스키마 레지스트리 HTTP 클라이언트의 연결 타임아웃을 초 단위로 지정합니다. 스키마 가져오기와 스키마 등록 모두에 사용됩니다. 값은 0보다 커야 하며, 600(10분) 이상의 값은 599로 축소됩니다.

## format\_avro\_schema\_registry\_max\_retries

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "5"},{"label": "Confluent 스키마 레지스트리와 통신할 때 발생하는 일시적 실패(전송 timeout, 연결 거부, DNS 오류, HTTP 5xx\/408\/429)에 대한 최대 재시도 횟수를 제어하는 새로운 설정입니다. 재시도를 비활성화하려면 0으로 설정하십시오. 이전 동작(재시도 없음)은 `compatibility = '26.5'`로 유지됩니다."}]}]} />

AvroConfluent 포맷용: Confluent 스키마 레지스트리와 통신할 때 발생하는 일시적 실패(전송 timeout, 연결 거부, DNS 오류, HTTP 5xx/408/429)에 대한 최대 재시도 횟수입니다. 재시도를 비활성화하려면 0으로 설정하십시오. 20을 초과하는 값은 20으로 축소됩니다. 스키마 유효성 검사 오류(HTTP 409, 잘못된 Avro JSON)는 재시도하지 않습니다.

## format\_avro\_schema\_registry\_receive\_timeout

<SettingsInfoBlock type="NonZeroUInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "1"},{"label": "AvroConfluent 포맷에서 사용하는 Confluent 스키마 레지스트리 HTTP 클라이언트의 수신 타임아웃(초)을 제어하는 새로운 설정입니다."}]}]} />

AvroConfluent 포맷용 Confluent 스키마 레지스트리 HTTP 클라이언트의 수신 타임아웃(초)입니다. 스키마 가져오기와 스키마 등록에 모두 사용됩니다. 값은 0보다 커야 하며, 600(10분) 이상의 값은 599로 축소됩니다.

## format\_avro\_schema\_registry\_retry\_initial\_backoff\_ms

<SettingsInfoBlock type="NonZeroUInt64" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "100"},{"label": "실패한 Confluent 스키마 레지스트리 요청을 재시도하기 전에 적용되는 초기 백오프(밀리초)를 제어하는 새로운 설정입니다. 백오프는 재시도할 때마다 2배로 증가하며 최대 10초로 제한됩니다. `format_avro_schema_registry_max_retries = 0`이면 효과가 없습니다(`compatibility = '26.5'`로 복원되는 26.6 이전 동작)."}]}]} />

AvroConfluent 포맷에서 실패한 Confluent 스키마 레지스트리 요청을 재시도하기 전에 적용되는 초기 백오프 시간(밀리초)입니다. 백오프는 이후 재시도할 때마다 2배로 증가하며 최대 10초로 제한됩니다. 값은 0보다 커야 하며, 60000을 초과하는 값은 60000으로 조정됩니다.

## format\_avro\_schema\_registry\_send\_timeout

<SettingsInfoBlock type="NonZeroUInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "1"},{"label": "AvroConfluent 포맷에서 사용하는 Confluent 스키마 레지스트리 HTTP 클라이언트의 전송 시간 제한(초)을 제어하는 새로운 설정입니다."}]}]} />

AvroConfluent 포맷용 Confluent 스키마 레지스트리 HTTP 클라이언트의 전송 시간 제한(초)입니다. 스키마 가져오기와 스키마 등록 모두에 사용됩니다. 값은 0보다 커야 하며, 600(10분) 이상의 값은 599로 축소됩니다.

## format\_avro\_schema\_registry\_url

AvroConfluent 포맷용 Confluent 스키마 레지스트리 URL입니다.