# Vitess v23.0.0

2025-11-04 · [릴리스 노트 원문](https://github.com/vitessio/vitess/releases/tag/v23.0.0) · [전체 정리](https://ratatosk.io/ko/releases/vitess/v23.0.0)

보안 11 · 호환성 변경 27 · 폐기 예정 15 · 중요 수정 49 · 기능·개선 47 · 의존성 갱신 17 · 기타 110

## 업그레이드 전 확인

### 전제 조건

- **`vitess-operator`를 `8.0.x`에서 `8.4.x`로 업그레이드하는 수동 절차**: YAML extra cnf에 `innodb_fast_shutdown=0`을 추가해 적용하고, 모든 Pod가 정상 상태가 될 때까지 기다린 다음 이미지를 `vitess/lite:v23.0.0`으로 변경합니다. 그런 다음 설정을 제거하고 다시 적용합니다. 이 절차는 `8.4.x`로 이동할 때만 필요하며, `8.4.x` 버전 간 업그레이드나 다운그레이드에는 필요하지 않습니다.
  > >  ⚠️ Upgrading to this release with vitess-operator:
  > >
  > > If you are using the `vitess-operator`, considering that we are bumping the MySQL version from `8.0.40` to `8.4.6`, you will have to manually upgrade:
  > >
  > > 1. Add `innodb_fast_shutdown=0` to your extra cnf in your YAML file.
  > > 2. Apply this file.
  > > 3. Wait for all the pods to be healthy.
  > > 4. Then change your YAML file to use the new Docker Images (`vitess/lite:v23.0.0`).
  > > 5. Remove `innodb_fast_shutdown=0` from your extra cnf in your YAML file.
  > > 6. Apply this file.
  > >
  > > This is only needed once when going from the latest `8.0.x` to `8.4.x`. Once you're on `8.4.x`, it is possible to upgrade and downgrade between `8.4.x` versions without needing to run `innodb_fast_shutdown=0`.

### 알려진 문제

- **실험적 스로틀러의 지속적인 개발**: 개발이 계속 진행 중이며, 향후 릴리스에서 호환성을 깨는 변경이 발생할 수 있습니다.
  > Vitess v23.0.0 introduces a new, experimental Query Throttler framework for rate-limiting incoming queries ([RFC issue #18412](https://github.com/vitessio/vitess/issues/18412), [PR #18449](https://github.com/vitessio/vitess/pull/18449), [PR #18657](https://github.com/vitessio/vitess/pull/18657)). Work on this new throttler is ongoing with the potential for breaking changes in the future.
- **`EmergencyReparentShard` 기반 복구 비활성화에 따른 가용성 위험**: 이 제어 기능에 자주 의존한다면 안티패턴일 수 있습니다.
  > **Note: disabling `EmergencyReparentShard`-based recoveries introduces availability risks; please use with extreme caution! If you rely on this functionality often, for example in automation, this may be signs of an anti-pattern. If so, please open an issue to discuss supporting your use case natively in VTOrc.**

## 보안 (11)

### Consul 정적 파일 인증에 로드된 자격 증명 필요

- 영향 대상: `--consul-auth-static-file`을 사용하는 설정
- 추가 조치: JSON 파일에서 자격 증명이 하나 이상 로드될 수 있어야 합니다.

이전에는 `{}`를 포함해 비어 있거나 유효하지 않은 JSON 파일을 사용해도 인증 없이 시작이 계속될 수 있었습니다. 이제 이런 파일을 사용하면 시작이 실패합니다.

> ### <a id="minor-changes-topo"/>Topology</a>
> #### <a id="consul-auth-static-file-check-creds"/>`--consul-auth-static-file` requires 1 or more credentials</a>
> The `--consul-auth-static-file` flag used in several components now requires that 1 or more credentials can be loaded from the provided json file ([PR #18152](https://github.com/vitessio/vitess/pull/18152)).
> **Impact**: Configurations with empty or invalid credential files will now fail at startup rather than silently continuing with no authentication.
>  * Check `consultopo` loaded `>=1` credentials w/`-consul_auth_static_file` [#18152](https://github.com/vitessio/vitess/pull/18152)

### `GetSchema`가 `EnableViews` 설정을 따름

- 영향 대상: `EnableViews`를 비활성화한 태블릿 서버
- 추가 조치: `EnableViews` 비활성화

이전에는 설정과 관계없이 클라이언트가 `GetSchema`를 통해 뷰 정의를 가져올 수 있었습니다. 이제 `SchemaTableType_VIEWS`는 빈 결과를 반환하고, `SchemaTableType_ALL`은 테이블 정의만 반환합니다.

>  * Fix GetSchema RPC to prevent returning view definitions when EnableViews is disabled [#18513](https://github.com/vitessio/vitess/pull/18513)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 비밀번호 체크섬을 비우는 `vtctldclient GetPermissions`

- 영향 대상: `vtctldclient GetPermissions`를 사용하는 환경

JSON 출력에서 값이 설정되지 않은 필드는 생략됩니다.

>  * [release-23.0] Potential fix for code scanning alert no. 2992: Clear-text logging of sensitive information (#18754) [#18760](https://github.com/vitessio/vitess/pull/18760)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `vtctldclient GetPermissions` 응답에서 `authentication_string` 누락

- 영향 대상: `vtctldclient GetPermissions`를 사용하는 구성

또한 패치에서는 v23 이상에서 이 필드가 서버 측에서 마스킹된다고 설명합니다.

>  * [release-23.0] `vtctldclient GetPermissions`: hide `authentication_string` from response (#18771) [#18799](https://github.com/vitessio/vitess/pull/18799)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 외부 태블릿 VReplication 권한 확인에서 `mysql.user` 조회 제거

- 영향 대상: 역방향 복제가 활성화된 외부 태블릿
- 추가 조치: 역방향 복제가 활성화된 상태에서 쓰기 트래픽을 전환할 때 실행되는 권한 확인

이전에는 권한 확인 과정에서 `mysql.user`를 조회했기 때문에 해당 테이블에 대한 접근 권한이 필요했고, 와일드카드 권한 부여, 역할 기반 인증, 데이터베이스 버전별로 검사를 안정적으로 테스트하기 어려웠습니다. 이제 쓰기 트래픽을 전환할 때 트랜잭션에서 더미 DML을 실행해 권한을 확인하므로 `mysql.user`에 접근할 필요가 없습니다.

>  * VReplication: permission check logic on external tablets -- switch to a more practical solution [#18580](https://github.com/vitessio/vitess/pull/18580)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### [보안 여부 불분명] VTAdmin의 vtctld gRPC 연결 TLS 지원

- 영향 대상: vtctld gRPC 연결에 TLS를 사용하는 VTAdmin 설정
- 추가 조치: vtctld gRPC TLS를 위한 `--vtctld-grpc-ca`, `--vtctld-grpc-cert`, `--vtctld-grpc-key`, `--vtctld-grpc-server-name`, `--vtctld-grpc-crl` 설정

이전에는 TLS 연결만 허용하는 vtctld에 연결할 수 없어, 프록시가 안전하지 않은 gRPC 자격 증명을 사용하던 VTAdmin이 시작되지 않았습니다. 보안 다이얼 설정을 사용할 수 있게 되어 VTAdmin이 TLS로 vtctld에 연결할 수 있습니다.

>  * Add vtctldclient TLS support to vtadmin GRPC [#18556](https://github.com/vitessio/vitess/pull/18556)
> Five new TLS-related flags were added for secure vtctld connections ([PR #18556](https://github.com/vitessio/vitess/pull/18556)):
> | Flag | Description |
> |:-----|:------------|
> | `--vtctld-grpc-ca` | CA certificate file for vtctld gRPC TLS |
> | `--vtctld-grpc-cert` | Client certificate file for vtctld gRPC TLS |
> | `--vtctld-grpc-key` | Client key file for vtctld gRPC TLS |
> | `--vtctld-grpc-server-name` | Server name for vtctld gRPC TLS validation |
> | `--vtctld-grpc-crl` | Certificate revocation list for vtctld gRPC TLS |
> These flags enable mTLS (mutual TLS) authentication between VTAdmin and vtctld for enhanced security.

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 파일 백업 경로 순회 검사 추가

- 영향 대상: 파일 백업 스토리지를 사용하는 설치 환경 (추정)

결합한 경로가 설정된 스토리지 루트 밖으로 벗어나면 해당 경로를 사용하는 대신 오류를 반환합니다. 이 검사는 파일 백업의 읽기, 목록 조회, 시작, 제거 작업에 적용됩니다.

> ### Security 
> #### Backup and Restore
>  * [release-23.0] Address dir traversal in file backup storage `GetBackups` RPC (#18814) [#18818](https://github.com/vitessio/vitess/pull/18818) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `commons-lang` 교체로 Java JDBC 드라이버 취약점 수정

- 영향 대상: Vitess Java JDBC 드라이버를 사용하는 설정 (추정)

드라이버는 이전에 `commons-lang` 2.6을 사용하고 `org.apache.commons.lang.StringUtils`를 가져왔습니다. 업그레이드 후에는 `commons-lang3` 3.19.0을 사용하고 `org.apache.commons.lang3.StringUtils`를 가져옵니다.

> #### Java
>  * [release-23.0] Resolve `commons-lang` vulnerability in Java driver (#18768) [#18797](https://github.com/vitessio/vitess/pull/18797) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTAdmin JavaScript 의존성 업데이트

- 영향 대상: VTAdmin을 사용하는 환경

이번 업데이트는 VTAdmin의 JavaScript 의존성에서 Dependabot이 보고한 취약점을 해결하기 위한 것입니다.

> #### VTAdmin
>  * [release-23.0] Address `Moderate` dependabot vulns in VTAdmin (#18744) [#18750](https://github.com/vitessio/vitess/pull/18750)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Dependabot 경고 해결을 위한 VTAdmin 의존성 업데이트

- 영향 대상: VTAdmin을 사용하는 환경 (추정)

VTAdmin의 의존성으로 인해 Dependabot 경고가 발생했습니다. 패키지 잠금 파일에는 해당 경고를 해결하기 위한 업데이트와 다른 패키지의 업데이트도 포함되었습니다.

>  * [release-23.0] Address `Moderate` dependabot vulns in VTAdmin (#18744) [#18750](https://github.com/vitessio/vitess/pull/18750)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTAdmin Vite 의존성 보안 업데이트

- 영향 대상: VTAdmin을 사용하는 환경 (추정)

이전 의존성 범위에서 Dependabot 보안 알림이 발생했습니다. 이제 매니페스트와 lockfile에서 `vite` `^7.1.12`, `@vitejs/plugin-react` `^5.1.0`, `vite-plugin-svgr` `^4.5.0`, `vitest` `^4.0.3`을 사용합니다.

>  * [release-23.0] vtadmin: upgrade vite to the latest (#18803) [#18812](https://github.com/vitessio/vitess/pull/18812) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

## 호환성 변경 (27)

### VTGate 메트릭 4개 제거

- 영향 대상: 제거된 메트릭 4개 중 하나라도 사용하는 VTGate 모니터링 대시보드 또는 알림 시스템

이 메트릭 4개는 v22.0.0에서 지원 중단 예정으로 지정됐으며, 이제 제공되지 않습니다. `QueryExecutions`가 `QueriesProcessed`를 대체하고, `QueryRoutes`가 `QueriesRouted`를 대체하며, `QueryExecutionsByTable`이 테이블별 메트릭 두 개를 모두 대체합니다.

> Four deprecated VTGate metrics have been completely removed in v23.0.0. These metrics were deprecated in v22.0.0:
> | Metric Name               | Component | Deprecated In |
> |---------------------------|-----------|---------------|
> | `QueriesProcessed`        | vtgate    | v22.0.0       |
> | `QueriesRouted`           | vtgate    | v22.0.0       |
> | `QueriesProcessedByTable` | vtgate    | v22.0.0       |
> | `QueriesRoutedByTable`    | vtgate    | v22.0.0       |
> **Impact**: Any monitoring dashboards or alerting systems using these metrics must be updated to use the replacement metrics introduced in v22.0.0:
> - Use `QueryExecutions` instead of `QueriesProcessed`
> - Use `QueryRoutes` instead of `QueriesRouted`
> - Use `QueryExecutionsByTable` instead of `QueriesProcessedByTable` and `QueriesRoutedByTable`
> See the [v22.0.0 release notes](https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.0/release_notes.md#new-vtgate-metrics) for details on the new metrics.
> | Component |        Metric Name        | Was Deprecated In |                     Deprecation PR                      |
> |:---------:|:-------------------------:|:-----------------:|:-------------------------------------------------------:|
> | `vtgate`  |    `QueriesProcessed`     |     `v22.0.0`     | [#17727](https://github.com/vitessio/vitess/pull/17727) |
> | `vtgate`  |      `QueriesRouted`      |     `v22.0.0`     | [#17727](https://github.com/vitessio/vitess/pull/17727) |
> | `vtgate`  | `QueriesProcessedByTable` |     `v22.0.0`     | [#17727](https://github.com/vitessio/vitess/pull/17727) |
> | `vtgate`  |  `QueriesRoutedByTable`   |     `v22.0.0`     | [#17727](https://github.com/vitessio/vitess/pull/17727) |

### `vitess/lite:latest`의 기본 MySQL 버전 변경: `8.4.6`

- 영향 대상: `vitess/lite:latest` 이미지
- 필요 조치: `vitess-operator`의 경우, `8.0.x`에서 `8.4.x`로 한 번만 진행하는 순서: YAML extra cnf에 `innodb_fast_shutdown=0`을 추가하고 적용; 모든 pod가 정상 상태가 될 때까지 대기; 새 Docker 이미지를 사용하도록 YAML 변경; 설정을 제거하고 YAML 다시 적용

이 태그는 이전에는 MySQL `8.0.40`을 선택했으며, 업그레이드 후에는 태그를 바꾸지 않아도 `8.4.6`을 선택합니다.

> The default major MySQL version used by our `vitess/lite:latest` image is going from `8.0.40` to `8.4.6`.
> This change was merged in [#18569](https://github.com/vitessio/vitess/pull/18569).
>  * Update MySQL 8.4 to be the default [#18569](https://github.com/vitessio/vitess/pull/18569)
> #### Online DDL
>  * Online DDL: support `alter vitess_migration ... postpone complete` syntax [#18118](https://github.com/vitessio/vitess/pull/18118)

### VTGate가 기본으로 광고하는 MySQL 버전 `8.4.6`

- 영향 대상: VTGate 배포
- 필요 조치: 광고할 MySQL 버전으로 `8.4.6`이 아닌 버전을 원할 경우 `mysql_server_version` 플래그를 해당 버전으로 설정

이전에는 VTGate가 MySQL 버전 `8.0.40`을 광고했습니다. 새 기본값은 실행 중인 MySQL 버전과 다를 수 있습니다.

> VTGate also advertises MySQL version `8.4.6` by default instead of `8.0.40`. If that is not what you are running, you can set the `mysql_server_version` flag to advertise the desired version.
>  * Update MySQL 8.4 to be the default [#18569](https://github.com/vitessio/vitess/pull/18569)

### VTGate `QueryExecutionsByTable`, 성공한 쿼리만 집계

- 영향 대상: VTGate `QueryExecutionsByTable` 메트릭을 수집하거나 사용하는 구성 (추정)

이전에는 실패한 쿼리 시도도 포함되어 성공한 쿼리량이 실제보다 높게 집계될 수 있었습니다. 이제 실패한 쿼리는 오류 메트릭으로 별도 추적하며, 실패가 상당히 많은 워크로드에서는 값이 낮아질 수 있습니다.

> #### VTGate QueryExecutionsByTable Behavior Change
> The `QueryExecutionsByTable` metric now only counts successful query executions ([PR #18584](https://github.com/vitessio/vitess/pull/18584)). Previously, it counted all query attempts regardless of success/failure.
> **Impact**:
> - Metric values may decrease if your workload had significant query failures
> - More accurate representation of successful query volume
> - Failed queries are tracked separately via error metrics
>  * fix: emit QueryExecutionsByTable for success cases only [#18584](https://github.com/vitessio/vitess/pull/18584) 

### VTTablet `--skip-user-metrics` 플래그

- 영향 대상: 사용자 기반 메트릭을 내보내는 VTTablet 구성

고유 사용자가 많은 환경에서는 사용자별 username 레이블로 메트릭 카디널리티가 폭증할 수 있습니다. `--skip-user-metrics`를 활성화하면 username 레이블이 `UserLabelDisabled`로 대체됩니다.

> - `--skip-user-metrics` flag if enabled, replaces the username label with "UserLabelDisabled" to prevent metric explosion in environments with many unique users ([PR #18085](https://github.com/vitessio/vitess/pull/18085)).
> | `--skip-user-metrics` | vttablet | If enabled, replaces the username label in user-based metrics with "UserLabelDisabled" to prevent metric cardinality explosion in environments with many unique users. | [#18085](https://github.com/vitessio/vitess/pull/18085) |
>  * [vttablet] Emit Constant “userLabelDisabled” When skip-user-metrics is Enabled [#18085](https://github.com/vitessio/vitess/pull/18085)

### Vitess Bullseye Docker 이미지 빌드 및 게시 중단

- 영향 대상: `debian:bullseye`를 기반으로 하는 Vitess Docker 이미지

Debian Bookworm 이미지 빌드는 계속되며 Debian Trixie 이미지도 추가됩니다. 기본 Debian 태그는 변경되지 않습니다.

> [Bullseye went EOL 1 year ago](https://www.debian.org/releases/), so starting from v23, we will no longer build or publish images based on debian:bullseye ([PR #18609](https://github.com/vitessio/vitess/pull/18609)).
> Builds will continue for Debian Bookworm, and add the recently released Debian Trixie. v23 explicitly does not change the default Debian tag to Trixie.
>  * docker: add trixie and rm bullseye from build matrix [#18609](https://github.com/vitessio/vitess/pull/18609)

### Datadog 트레이서 디버그 모드 기본값 비활성화

- 영향 대상: Datadog 트레이싱 플러그인을 사용하는 설치 환경 (추정)

이전에는 플러그인이 항상 디버그 모드를 켜서, 트래픽에 따라 로그가 수백만 건에 이를 정도로 매우 많은 로그를 생성했습니다. `--datadog-trace-debug-mode` 옵션을 사용하면 디버그 모드를 켤 수 있습니다.

근거: “Previously debug mode was hardcoded to true for the tracer in the datadog plugin, which made logging extremely verbose. This can easily add up to millions of logs depending on the amount of traffic your application receives, which can be very costly.” https://github.com/vitessio/vitess/pull/18347

>  * Configure datadog trace debug mode [#18347](https://github.com/vitessio/vitess/pull/18347)
> | `--datadog-trace-debug-mode` | All components | Makes Datadog trace debug mode configurable instead of always-on. Default: false. | [#18347](https://github.com/vitessio/vitess/pull/18347) |

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 양수인 `--force-cut-over-after` 값이 `<= 1ms`일 때 Online DDL 즉시 cut-over

- 영향 대상: 양수인 `--force-cut-over-after` 값이 `<= 1ms`인 Online DDL

이전에는 강제 cut-over가 sinceReadyToComplete 값이 설정값을 초과할 때까지 기다렸습니다. 이제 측정된 경과 시간이 설정값보다 짧아도 cut-over가 발생할 수 있습니다.

근거: “- When `--force-cut-over-after` value is `<= 1ms` we consider it as "immediate" even if we somehow measure the time-since-ready to be less than that.” https://github.com/vitessio/vitess/pull/18423

>  * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 프라이머리에 연결할 수 없을 때 VTOrc가 직접 레플리카의 복제를 재시작

- 영향 대상: VTOrc가 관리하는 복제

`UnreachablePrimary` 상태에서는 VTOrc가 임의의 직접 레플리카 한 대에서 복제를 중지한 뒤 다시 시작합니다. 일부 레플리카에서만 복제에 실패하면 상태를 `UnreachablePrimaryWithBrokenReplicas`로 분류하고 모든 직접 레플리카의 복제를 재시작합니다. 태블릿마다 재시작은 분당 한 번으로 제한됩니다.

근거: “However, if there is a non-empty subset of replicas that are failing to replicate (and these are **not** all of the replicas) then we analyze as a new `UnreachablePrimaryWithBrokenReplicas`. This scenario is very highly suspicious of really being an early stage for a `DeadPrimary` scenario, and we want to find out sooner rather than later. Here, we restart all replicas.” https://github.com/vitessio/vitess/pull/18626

>  * `vtorc`: implement `restartDirectReplicas` as response to `UnreachablePrimary` [#18626](https://github.com/vitessio/vitess/pull/18626) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 지원 중단 예정이었던 VTGate 메트릭 및 엔진 프리미티브 메서드 제거

- 영향 대상: 지원 중단 예정인 VTGate 메트릭 또는 엔진 프리미티브 메서드를 사용하는 설정 (추정)

제거된 VTGate 메트릭에는 `QueriesProcessed`가 포함됩니다.

근거: “This PR removed the deprecated metrics on VTGate and removed deprecated methods on engine primitive.” https://github.com/vitessio/vitess/pull/18149

>  * Remove deprecated methods and metrics [#18149](https://github.com/vitessio/vitess/pull/18149) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 여러 문으로 구성된 `ExecuteFetchAsDba` 요청 거부

- 영향 대상: 세미콜론으로 구분된 여러 SQL 문을 `ExecuteFetchAsDba`로 제출하는 코드 또는 자동화
- 필요 조치: 각 문을 별도의 RPC 호출로 보내야 합니다.

이전에는 모든 문이 `CREATE TABLE` 또는 `CREATE VIEW`인 경우 요청을 받아들였지만, 이제는 이 예외가 적용되지 않습니다.

> #### <a id="executefetchasdba-multistatement"/>ExecuteFetchAsDba No Longer Accepts Multi-Statement SQL</a>
> The `ExecuteFetchAsDba` RPC method in TabletManager now explicitly rejects SQL queries containing multiple statements (as of [PR #18183](https://github.com/vitessio/vitess/pull/18183)).
> **Impact**: Code or automation that previously passed multiple semicolon-separated SQL statements to `ExecuteFetchAsDba` will now receive an error. Each SQL statement must be sent in a separate RPC call.
> **Migration**: Split multi-statement SQL into individual RPC calls:
> ```go
> // Before (no longer works):
> ExecuteFetchAsDba("CREATE TABLE t1 (id INT); CREATE TABLE t2 (id INT);")
> // After (required in v23+):
> ExecuteFetchAsDba("CREATE TABLE t1 (id INT);")
> ExecuteFetchAsDba("CREATE TABLE t2 (id INT);")
> ```
>  * tablet manager's `ExecuteFetchAsDba` does not allow multiple queries [#18183](https://github.com/vitessio/vitess/pull/18183) 

### `vttablet` `tabletmanager` 클라이언트 오류 코드 수정

- 영향 대상: `vttablet` gRPC `tabletmanager` 클라이언트를 사용하는 구성
- 필요 조치: google-gRPC 오류 코드에 의존하는 외부 자동화의 업데이트: `vterrors.Code(err)`로 코드를 확인하고 `vtrpcpb.Code_NOT_FOUND` 같은 `vtrpcpb.Code` 값을 사용해야 합니다.

`tabletmanager` RPC 실행에 실패하면, 예를 들어 `mysqld`가 중단된 경우 클라이언트가 `Unknown`을 반환할 수 있었습니다. 이제 이런 경우에는 `Unavailable`을 반환하며, 오류 메시지는 바뀌지 않습니다.

근거: “Now tablets with downed-`mysqld` will return the gRPC `Unavailable` code with the error message unchanged, for example” https://github.com/vitessio/vitess/pull/18565

> #### <a id="grpc-error-codes"/>gRPC TabletManager Error Code Changes</a>
> The `vttablet` gRPC `tabletmanager` client now returns errors wrapped by the internal `go/vt/vterrors` package ([PR #18565](https://github.com/vitessio/vitess/pull/18565)).
> **Impact**: External automation relying on google-gRPC error codes must be updated to use `vterrors.Code(err)` to inspect error codes, which returns `vtrpcpb.Code`s defined in [proto/vtrpc.proto](https://github.com/vitessio/vitess/blob/main/proto/vtrpc.proto#L60).
> **Migration**:
> ```go
> // Before:
> if status.Code(err) == codes.NotFound { ... }
> // After:
> if vterrors.Code(err) == vtrpcpb.Code_NOT_FOUND { ... }
> ```
> #### <a id="grpctmclient-err-changes"/>gRPC `tabletmanager` client error changes</a>
> The `vttablet` gRPC `tabletmanager` client now returns errors wrapped by the internal `go/vt/vterrors` package ([PR #18565](https://github.com/vitessio/vitess/pull/18565)). External automation relying on google-gRPC error codes should now use `vterrors.Code(err)` to inspect the code of an error, which returns `vtrpcpb.Code`s defined in [the `proto/vtrpc.proto` protobuf](https://github.com/vitessio/vitess/blob/main/proto/vtrpc.proto#L60).
> See [Breaking Changes](#grpc-error-codes) for migration guidance.
>  * `tabletmanager`/`grpctmclient`: use `vtrpcpb`/gRPC error codes [#18565](https://github.com/vitessio/vitess/pull/18565)

### GTID 파싱 메서드에 커밋 및 시퀀스 값 추가

- 영향 대상: GTID 파싱 API를 직접 호출하는 코드
- 필요 조치: 변경된 메서드 시그니처에 맞춘 GTID 파싱 API 직접 호출부 업데이트

이전에는 `BinlogEvent.GTID()`가 GTID, `hasBegin`, 오류만 반환했지만, 이제 시그니처에 `lastCommitted`와 `sequenceNumber`도 포함됩니다.

> Several GTID-related API signatures changed in [PR #18196](https://github.com/vitessio/vitess/pull/18196) as part of GTID performance optimizations:
> **Changed**: `BinlogEvent.GTID()` method signature
> **Impact**: Code directly using the GTID parsing APIs may need updates. Most users are unaffected as these are internal APIs.

### `key.GenerateShardRanges()`의 16진수 자릿수 매개변수 지원

- 영향 대상: `key.GenerateShardRanges()`를 직접 호출하는 코드
- 필요 조치: 직접 호출하는 코드는 새 매개변수를 전달하도록 호출을 수정해야 함

이전에는 호출자가 샤드 개수만 전달했습니다. 새 값인 `hexChars`가 생성되는 샤드 이름의 16진수 자릿수를 지정합니다.

> #### <a id="generateshardranges-api"/>GenerateShardRanges API Signature Change</a>
> The `key.GenerateShardRanges()` function signature changed in [PR #18633](https://github.com/vitessio/vitess/pull/18633) to add a new `hexChars int` parameter controlling the hex width of generated shard names.
> **Impact**: Code calling `GenerateShardRanges()` directly must be updated to pass the new parameter.
> ---

### 대상 DDL 변경 중 Vitess 쿼리 버퍼링

- 영향 대상: 조건에 맞는 `INSTANT` DDL 마이그레이션 및 범위 파티션 로테이션 변경
- 필요 조치: `--prefer-instant-ddl`을 지정한 즉시 실행 가능한 마이그레이션 또는 범위 파티션 로테이션 변경

스키마 변경이 진행되는 동안 쿼리 실패를 줄이며, 애플리케이션에는 투명하게 처리됩니다.

> Query buffering has been implemented for `INSTANT` DDL operations ([PR #17945](https://github.com/vitessio/vitess/pull/17945)), reducing query failures during schema changes.
> - Automatic buffering of queries during INSTANT DDL execution
> - Transparent to applications
> **Impact**: Applications experience fewer query errors during schema changes, improving availability during DDL operations.
>  * Query buffering, terminating blocking transactions for `INSTANT` DDL and other "special plans" [#17945](https://github.com/vitessio/vitess/pull/17945)

### 적격 특수 작업 DDL 전 락 보유 쿼리와 트랜잭션 종료

- 영향 대상: 0이 아닌 `--force-cut-over-after`를 사용하는 적격 instant DDL 및 range partition rotation 작업

이전에는 이러한 작업에서 DDL을 바로 실행했습니다. 이제 마이그레이션 대상 테이블에 락이나 메타데이터 락을 보유한 쿼리와 트랜잭션을 `ALTER TABLE` 실행 전에 종료합니다. 이 동작은 플래그 값에 따라 달라지지 않으며, 해당 테이블에 대해 대기 중인 원자적 트랜잭션이 있으면 종료를 건너뜁니다.

근거: “In addition, if `--force-cut-over-duration` flag is nonzero, and irrespective of its value, we also issue a one time termination for queries and transactions holding locks or metadata locks on the migrated table, just before issuing the `ALTER TABLE` statement.” https://github.com/vitessio/vitess/pull/17945

> - Forced termination of blocking transactions
>  * Query buffering, terminating blocking transactions for `INSTANT` DDL and other "special plans" [#17945](https://github.com/vitessio/vitess/pull/17945)

### cgroup CPU·메모리 메트릭에 필요한 cgroup v2

- 영향 대상: cgroup v1을 사용하는 Linux 설치 환경

이전에는 Vitess가 cgroup v1과 v2 모두에서 CPU 및 메모리 메트릭을 수집했습니다. 이제 cgroup v1을 사용하거나 cgroup 메트릭 설정에 실패하면 경고를 출력하고 호스트 메트릭을 사용합니다. cgroup v2에서는 계속 cgroup 메트릭을 사용합니다.

근거: “func getCgroup1CpuUsage() (uint64, error) {” https://github.com/vitessio/vitess/pull/18801

> #### Observability
>  * [release-23.0] Improve cgroup metric management (#18791) [#18801](https://github.com/vitessio/vitess/pull/18801) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VStream 진단 로그 변경

- 영향 대상: VStream을 사용하는 클러스터 (추정)

추가된 로그는 클러스터에서 자주 발생하는 EOF 오류의 위치를 파악하는 데 도움이 되도록 작성되었습니다. VStream 오류 로그 한 건의 수준이 `Errorf`에서 `Infof`로 바뀝니다.

>  * VStream API: add additional log lines for debugging frequent eof errors during catchup [#18124](https://github.com/vitessio/vitess/pull/18124)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VReplication의 MySQL 오류 1419 무한 재시도 중단

- 영향 대상: VReplication 워크플로

워크플로에서 `DEFINER` 트리거를 생성할 때 이 오류가 발생할 수 있습니다. 이전에는 VReplication이 이 오류를 처리하지 못해 워크플로를 무한정 재시도할 수 있었습니다.

근거: “name: "SQL error with ERBinlogCreateRoutineNeedSuper"” https://github.com/vitessio/vitess/pull/18820

>  * [release-23.0] VReplication: Treat ER_BINLOG_CREATE_ROUTINE_NEED_SUPER as unrecoverable (#18784) [#18820](https://github.com/vitessio/vitess/pull/18820) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTTablet의 오래된 리플리카 하트비트 오류 보고

- 영향 대상: 하트비트 리더를 사용하는 리플리카 태블릿 (추정)

MySQL의 응답이 멈추고 설정된 하트비트 간격의 두 배가 넘도록 하트비트를 성공적으로 읽지 못하면, `vttablet`은 MySQL이 정상이라고 계속 보고할 수 있었습니다. 이제 하트비트 상태가 오류를 반환하고 VTGate에 해당 태블릿이 비정상임을 알립니다.

근거: “The workaround I'm proposing is to change `*heartbeatReader.Status` func to just disregard any previously read heartbeat data if the last time the heartbeat was successfully read is older than two times the configured interval. It feels a bit hacky, but works reliably in identifying that MySQL is unhealthy and very quickly signals to `vtgate` that the tablet is unhealthy.” https://github.com/vitessio/vitess/pull/17883

>  * Fix `vttablet` not being marked as not serving when MySQL stalls [#17883](https://github.com/vitessio/vitess/pull/17883)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `InitAuthServerClientCert`의 명시적 CA 값 인자

- 영향 대상: `go/mysql`의 공개 `InitAuthServerClientCert` 함수를 호출하는 Go 코드(VTGate 플러그인 초기화 함수 포함) (추정)

이전에는 함수가 `mysql-server-ssl-ca`를 조회하고, 첫 번째 플래그 값이 비어 있으면 `mysql_server_ssl_ca`를 사용했습니다. 이제 함수는 두 번째 인자로 CA 값을 받으며, VTGate 플러그인 초기화 함수가 `vtgate.GetMysqlServerSSLCA()`를 통해 이 값을 전달합니다.

근거: “func InitAuthServerClientCert(clientcertAuthMethod string, caValue string) {” https://github.com/vitessio/vitess/pull/18508

>  * Set up better dependency checks [#18508](https://github.com/vitessio/vitess/pull/18508)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `lite:mysql80` Docker 이미지 빌드 추가

- 영향 대상: `lite:mysql80` 이미지를 선택하는 빌드 (추정)

이전에는 lite 이미지 빌드 매트릭스에 `latest`, `mysql84`, `percona80`이 포함됐지만 `mysql80`은 포함되지 않았습니다.

>  * build `lite:mysql80` docker image [#18692](https://github.com/vitessio/vitess/pull/18692)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 강제 cut-over에서 `RENAME` 중 테이블 잠금 보유 연결 종료

- 영향 대상: 강제 cut-over를 사용하는 Online DDL 마이그레이션

이전에는 cut-over 전 종료 작업이 끝난 뒤 `RENAME`이 실행되기 전까지 장기 실행 쿼리가 시작될 수 있었습니다. 이 쿼리는 마이그레이션 대상 테이블의 잠금을 보유한 채 남을 수 있었습니다. 추가 종료 단계에서는 lock 연결과 rename 연결을 제외합니다.

근거: “With forced cut-over, we now kill queries and transactions holding onto locks on migrated table, not only _before_ the cut-over, but also while the `RENAME` is being applied. Without this, there's a race condition where a long running query could start running just after queries are killed and right before the `RENAME` starts running.” https://github.com/vitessio/vitess/pull/18423

>  * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Online DDL 컷오버 잠금 대기 타임아웃 단축

- 영향 대상: Online DDL 컷오버 마이그레이션 (추정)

잠금 연결의 타임아웃은 `onlineDDL.CutOverThreshold`의 5배에서 임계값의 3배로 변경됩니다. 이름 변경 연결의 타임아웃은 임계값의 5배에 4를 곱한 값에서 임계값의 2배로 변경됩니다.

근거: “- Sanitized and reduced query and lock timeouts during the cut-over. There were some excessive timeouts, notably an overlooked `5*onlineDDL.CutOverThreshold*4` value which evaluates to `5min` on a `15s` timeout.” https://github.com/vitessio/vitess/pull/18423

>  * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTOrc `database_instance` 위치 필드를 정보 제공용 `cell`로 대체

- 영향 대상: VTOrc에서 `database_instance` 테이블을 사용하는 설치 환경 (추정)

제거된 필드는 로직에서 사용되지 않았습니다. `physical_environment`와 `region`은 항상 undefined이거나 비어 있었고, `data_center`는 태블릿의 cell과 일치했습니다. 새 `cell` 필드도 아직 로직에서 사용되지 않습니다.

근거: “The 3 x fields are replaced by the new `cell` field. It isn't used in any logic yet - for now it is informational” https://github.com/vitessio/vitess/pull/18339

>  * `vtorc`: cleanup `database_instance` location fields [#18339](https://github.com/vitessio/vitess/pull/18339)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTOrc `database_instance` 스키마의 위치 필드를 `cell`로 대체

- 영향 대상: `database_instance` 테이블을 사용하는 VTOrc 설치 (추정)

이전에는 테이블에 `data_center`, `physical_environment`, `region` 필드가 있었으며, PR에 따르면 이 필드들은 로직에서 사용되지 않았습니다. 이를 대체하는 `cell` 필드는 정보 제공용이며, 아직 로직에서 사용되지 않습니다.

근거: “The 3 x fields are replaced by the new `cell` field. It isn't used in any logic yet - for now it is informational” https://github.com/vitessio/vitess/pull/18339

>  * `vtorc`: cleanup `database_instance` location fields [#18339](https://github.com/vitessio/vitess/pull/18339)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTOrc의 집계 디스커버리 메트릭 API 제거

- 영향 대상: VTOrc의 `/api/aggregated-discovery-metrics` 엔드포인트를 사용하는 연동 (추정)

이 엔드포인트는 이전에 120초 동안의 집계된 디스커버리 샘플을 JSON으로 반환했습니다.

근거: “This PR drops the undocumented VTOrc API endpoint `/api/aggregated-discovery-metrics`” https://github.com/vitessio/vitess/pull/18672

>  * `vtorc`: remove aggregated discovery metrics HTTP API, cleanup code [#18672](https://github.com/vitessio/vitess/pull/18672)
> #### <a id="aggregated-discovery-metrics-api-removed"/>Aggregated Discovery Metrics HTTP API removed</a>
> VTOrc's undocumented `/api/aggregated-discovery-metrics` HTTP API endpoint was removed ([PR #18672](https://github.com/vitessio/vitess/pull/18672)). The list of documented VTOrc APIs can be found [here](https://vitess.io/docs/current/reference/vtorc/ui_api_metrics/#apis).
> We recommend using the standard VTOrc metrics to gather the same metrics. If you find that a metric is missing in standard metrics, please open an issue or PR to address this.

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

## 폐기 예정 (15)

### 밑줄 형식 CLI 플래그 지원 중단 예정

- 영향 대상: 마이그레이션된 CLI 플래그 989개의 밑줄 형식 이름
- 제거 시점: v25.0.0

이전에는 Viper에 바인딩된 형식과 다른 표기의 플래그를 사용하면 오류가 발생하거나 아무 동작도 하지 않을 수 있었습니다. v23.0.0과 v24.0.0에서는 두 형식을 모두 허용하고 대시 형식 이름으로 정규화합니다. 밑줄 형식은 도움말에 표시되지 않으며 지원 중단 예정 메시지가 표시됩니다.

> ### <a id="flag-naming-convention-migration"/>Flag Naming Convention Migration</a>
> Vitess v23.0.0 includes a major standardization of CLI flag naming conventions across all binaries. **989 flags** have been migrated from underscore notation (`flag_name`) to dash notation (`flag-name`) in [PR #18280](https://github.com/vitessio/vitess/pull/18280) and related PRs.
> #### Backward Compatibility
> - **v23.0.0 and v24.0.0**: Both underscore and dash formats are supported. Underscore format is **deprecated** but functional.
> - **v25.0.0**: Underscore format will be **removed**. Only dash format will be accepted.
> #### Automatic Normalization
> Flag normalization happens automatically at the `pflag` level ([PR #18642](https://github.com/vitessio/vitess/pull/18642)), so both formats are accepted without requiring code changes in v23/v24.
> #### Example Flag Renames
> Common flags affected (full list of 989 flags available in PR #18280):
> **Backup flags**:
> - `--azblob_backup_account_name` → `--azblob-backup-account-name`
> - `--s3_backup_storage_bucket` → `--s3-backup-storage-bucket`
> - `--xtrabackup_root_path` → `--xtrabackup-root-path`
> **Replication flags**:
> - `--heartbeat_enable` → `--heartbeat-enable`
> - `--replication_connect_retry` → `--replication-connect-retry`
> **gRPC flags** ([PR #18009](https://github.com/vitessio/vitess/pull/18009)):
> - All gRPC-related flags standardized (30+ flags)
> #### Action Required
> Users should update configuration files, scripts, and automation to use dash-based flag names before upgrading to v25.0.0. The migration is backward compatible in v23 and v24, allowing gradual updates.

### VTOrc의 `DiscoveryInstanceTimings` 메트릭 추가

- 영향 대상: 인스턴스 디스커버리 타이밍 메트릭을 사용하는 VTOrc 배포 (추정)
- 제거 시점: v24+

이번 릴리스에서는 두 메트릭 모두 인스턴스 디스커버리 작업의 타이밍을 제공합니다. 기존 `DiscoverInstanceTimings` 메트릭은 v24에서 지원 중단 예정이며 v24+에서 제거될 예정입니다.

> | `vtorc`   | `DiscoverInstanceTimings` | Replaced by `DiscoveryInstanceTimings` | [#18406](https://github.com/vitessio/vitess/pull/18406) |
>  * `vtorc`: update metrics in e2e test `TestAPIEndpoints` [#18406](https://github.com/vitessio/vitess/pull/18406)

### `/api/replication-analysis` 지원 중단 예정 및 `/api/detection-analysis`로 대체

- 영향 대상: 두 분석 엔드포인트 중 하나를 사용하는 VTOrc API 클라이언트
- 제거 시점: v24+

이번 릴리스에서는 두 엔드포인트가 같은 핸들러를 사용하고 응답 형식도 같습니다. 기존 엔드포인트는 v24 이상에서 제거될 예정이며, 그때까지 계속 사용할 수 있습니다.

> #### <a id="replication-analysis-api-deprecation"/>`/api/replication-analysis` HTTP API deprecation</a>
> The `/api/replication-analysis` HTTP API endpoint is now deprecated and is replaced with `/api/detection-analysis` ([PR #18615](https://github.com/vitessio/vitess/pull/18615)), which currently returns the same response format.
> **Timeline**: The `/api/replication-analysis` endpoint will be removed in a future version. Users should migrate to `/api/detection-analysis`.

### 관리형 MySQL 인증 기본값으로 `caching_sha2_password` 사용

- 영향 대상: MySQL 8.0.26 이상을 사용하는 관리형 MySQL 인스턴스
- 제거 시점: 미상

이전 기본값은 `mysql_native_password`였으며, 이전 버전과의 호환성을 위해 계속 활성화되어 있습니다. 릴리스 노트는 v23으로 업그레이드한 뒤 명시적 비밀번호를 설정한 복제 사용자에게 `caching_sha2_password`를 권장합니다.

> #### <a id="mysql-caching-sha2-password"/>Managed MySQL configuration defaults to caching-sha2-password</a>
> The default authentication plugin for MySQL 8.0.26 and later is now `caching_sha2_password` instead of `mysql_native_password` ([PR #18010](https://github.com/vitessio/vitess/pull/18010)). This change is made because `mysql_native_password` is deprecated and removed in future MySQL versions. `mysql_native_password` is still enabled for backwards compatibility.
> This change specifically affects the replication user. If you have a user configured with an explicit password, it is recommended to make sure to upgrade this user after upgrading to v23 with a statement like the following:
> ```sql
> ALTER USER 'vt_repl'@'%' IDENTIFIED WITH caching_sha2_password BY 'your-existing-password';
> ```
> In future Vitess versions, the `mysql_native_password` authentication plugin will be disabled for managed MySQL instances.
>  * Switch to using the default caching sha2 password [#18010](https://github.com/vitessio/vitess/pull/18010)

### gRPC 플래그 이름의 대시 표기 전환

- 영향 대상: 예를 들어 `--grpc-auth-mode`와 `--grpc-bind-address` 같은 gRPC 플래그를 사용하는 설정
- 제거 시점: v25

이 플래그들은 이전에 언더스코어를 사용했지만, 이제 대시를 사용한 이름도 사용할 수 있습니다. 언더스코어 표기도 계속 지원되지만, 지원 중단 예정이며 숨김 처리됩니다.

>  * Refactor grpc flags for standardized naming  [#18009](https://github.com/vitessio/vitess/pull/18009)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 밑줄 플래그 이름 지원 중단 예정

- 영향 대상: 마이그레이션된 로깅, 데이터베이스, tablet-manager gRPC 또는 통계 플래그를 사용하는 설정
- 제거 시점: v25

리팩터링 전에는 이 플래그 이름에 밑줄을 사용했습니다. 이제 하이픈 표기 이름을 사용할 수 있습니다. 밑줄 표기 이름도 계속 동작하지만, 지원 중단 예정이며 숨겨져 있습니다.

>  * Refactor flags - Part 3 [#18064](https://github.com/vitessio/vitess/pull/18064)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 자주 쓰이는 Vitess 플래그의 대시 표기 전환

- 영향 대상: 마이그레이션된 백업 스토리지, MySQL, 토폴로지 또는 태블릿 플래그를 사용하는 설정
- 제거 시점: v25

이 플래그들은 이전에 밑줄 표기를 사용했습니다. 이제 대시 표기도 사용할 수 있으며, 밑줄 표기 변형도 계속 지원되지만 지원 중단 예정 상태로 숨겨집니다.

>  * Refactor flags - Part 4 [#18095](https://github.com/vitessio/vitess/pull/18095)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 언더스코어 CLI 플래그 형식 지원 중단 예정

- 영향 대상: 플래그 리팩터링으로 변경된 CLI 플래그
- 제거 시점: v25

v23에서는 하이픈 형식과 언더스코어 형식을 모두 사용할 수 있습니다.

>  * Merge flags-refactor branch to main [#18280](https://github.com/vitessio/vitess/pull/18280)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `vtctld` 플래그에 대시 형식 이름 추가

- 영향 대상: `vtctld` 플래그를 사용하는 설정(예: `--disable-active-reparents` 및 `--opentsdb-uri`)
- 제거 시점: 미상

이전에는 플래그 이름에 언더스코어를 사용했습니다. 이제 대시 형식도 사용할 수 있습니다. 언더스코어 형식은 계속 지원되지만 지원 중단 예정이며 숨김 처리됩니다.

>  * Refactor `vtctld` flags to follow standard naming convention [#18294](https://github.com/vitessio/vitess/pull/18294)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess 플래그 이름의 대시 구분 형식 전환

- 영향 대상: 마이그레이션된 DBA 풀, VTGate/Vtctld gRPC, 클라이언트 프로토콜, 쿼리 로깅, 외부 토폴로지 또는 Ceph 백업 스토리지 플래그를 사용하는 설정
- 제거 시점: 미상

밑줄(_)이 들어간 이름의 플래그도 계속 지원하지만, 이제 지원 중단 예정이며 숨김 처리됩니다.

>  * Flags Refactor - Part 5 [#18296](https://github.com/vitessio/vitess/pull/18296)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 마이그레이션된 `vtcombo` 플래그의 대시 표기 이름

- 영향 대상: `vtcombo` 바이너리에서 마이그레이션된 플래그를 사용하는 설정
- 제거 시점: 미상

밑줄 표기 이름도 계속 지원되지만, 지원 중단 예정 상태로 숨겨집니다.

>  * Refactor `vtcombo` flags - Part 2 [#18297](https://github.com/vitessio/vitess/pull/18297)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `vtcombo` 플래그의 대시 표기 이름 전환

- 영향 대상: `vtcombo` 바이너리에서 마이그레이션된 플래그
- 제거 시점: 미상

리팩터링 전에는 이 플래그에 밑줄 표기를 사용했습니다. 이제 대시 표기 이름을 사용할 수 있으며, 밑줄 표기 이름도 계속 지원되지만 지원 중단 예정이고 숨겨져 있습니다.

>  * Refactor `vtcombo` flags - Part 3 [#18298](https://github.com/vitessio/vitess/pull/18298)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 영향받는 명령줄 플래그의 대시 표기 통일

- 영향 대상: 영향을 받는 플래그를 사용해 `mysqlctld`, `mysqlctl` 또는 `vtbackup` 명령을 실행하는 Vitess 배포 환경
- 제거 시점: v25

해당 플래그는 이전에는 `init_db_sql_file`, `socket_file`, `wait_time`처럼 밑줄 표기를 사용했습니다.

>  * Refactor `mysqlctld` flags to follow standardized naming [#18432](https://github.com/vitessio/vitess/pull/18432)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 대시 표기로 변경된 `vtcombo` 플래그 47개

- 영향 대상: `vtcombo` 구성에서 이름이 변경된 플래그를 사용하는 경우
- 제거 시점: v25

영향을 받는 플래그는 이전에 밑줄을 사용했습니다. PR에는 대시 표기의 예로 `--relay-log-max-items`와 `--restore-from-backup`이 나와 있습니다.

>  * Refactor `vtcombo` flags - Part 4 [#18422](https://github.com/vitessio/vitess/pull/18422) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `/api/replication-analysis` 지원 중단 예정 및 `/api/detection-analysis`로 대체

- 영향 대상: `/api/replication-analysis`를 사용하는 VTOrc 클라이언트 (추정)
- 제거 시점: 미상

대체 엔드포인트는 같은 응답 형식을 반환합니다.

>  * `vtorc`: rename `ReplicationAnalysis` -> `DetectionAnalysis` [#18615](https://github.com/vitessio/vitess/pull/18615)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

## 중요 수정 (49)

### mysqlctl 환경 변수의 mysqld 전파

- 영향 대상: 비 UTC `TZ` 설정과 같은 환경 변수를 사용하는 mysqlctl 배포 환경

mysqlctl에 설정한 `TZ`는 이전에는 mysqld에서 무시되어, 환경에 지정한 시간대가 `DATETIME` 해석에 영향을 주지 않았습니다. 이제 mysqld가 이러한 환경 변수를 상속하므로, 이전 동작에 의존하는 배포 환경에서는 `DATETIME` 값이 다르게 해석될 수 있습니다.

> Fixed a bug where environment variables like `TZ` were not propagated from mysqlctl to the mysqld process ([PR #18561](https://github.com/vitessio/vitess/pull/18561)).
> As a result, timezone settings from the environment were previously ignored. Now mysqld correctly inherits environment variables.
> ⚠️ **Deployment Impact**: Deployments that relied on the old behavior and explicitly set a non-UTC timezone may see changes in how DATETIME values are interpreted. To preserve compatibility, set `TZ=UTC` explicitly in MySQL pods.
>  * Pass envs to mysqld process [#18561](https://github.com/vitessio/vitess/pull/18561) 

### 밑줄 표기 CLI 플래그 처리 수정

- 영향 대상: 밑줄로 표기한 CLI 플래그, 특히 Viper에 바인딩된 플래그

밑줄이 포함된 플래그를 전달하면 다른 플래그 객체에 바인딩되어 있어 Viper가 값을 읽지 못할 수 있었고, 설정이 오류를 일으키거나 적용되지 않을 수 있었습니다. 이제 파싱 중 밑줄 표기 이름을 대시 표기 이름으로 정규화하므로 Viper가 전달된 값을 받습니다. 해당 플래그에는 계속 지원 중단 예정 메시지가 표시됩니다.

>  * Normalize flag names at the `pflag` level. [#18642](https://github.com/vitessio/vitess/pull/18642) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Evalengine 튜플 단순화에서 여러 컬럼 결과 보존

- 영향 대상: 여러 컬럼 결과를 다루는 evalengine 튜플 단순화 사용자. 조인 조건의 CASE 표현식 포함 (추정)

수정 전에는 단순화기가 여러 컬럼 결과를 하나의 `Literal`로 감쌌습니다. 조인 조건의 CASE 표현식이 확인된 사례입니다.

>  * fix: Preserve multi-column TupleExpr in tuple simplifier [#18216](https://github.com/vitessio/vitess/pull/18216)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### evalengine 비교 중 발생하던 크래시 수정

- 영향 대상: evalengine에서 NULL 또는 JSON, ENUM, SET, 지오메트리 값을 포함하는 비교 (추정)

NULL이 포함된 비교나 evalengine이 제대로 처리하지 못했던 타입(JSON, ENUM, SET 등)을 비교하면 패닉이 발생할 수 있었습니다. 영향을 받는 NULL 검사와 타입 처리 사례를 수정해, 설명된 예상치 못한 타입으로 인한 크래시가 더는 발생하지 않습니다.

>  * Fix evalengine crashes on unexpected types [#18254](https://github.com/vitessio/vitess/pull/18254) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### vindex가 무시한 행의 vtgate 기본 테이블 삽입 수정

- 영향 대상: vindex를 사용하는 `INSERT IGNORE` 문

이전에는 `INSERT IGNORE` 중 vindex가 행을 무시한다고 보고하면, vindex 열의 NULL 값 때문에 해당 행이 룩업 테이블에 들어가지 않아 기본 테이블 삽입도 건너뛸 수 있었습니다. 이제 vtgate는 vindex가 행을 무시한다고 보고해도 기본 테이블에 행을 삽입할 수 있습니다.

>  * bugfix: INSERT IGNORE not inserting rows [#18151](https://github.com/vitessio/vitess/pull/18151)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### UNION 쿼리 병합 시 LIMIT/OFFSET 보존

- 영향 대상: Vitess가 병합하는 쿼리 가운데 LIMIT 또는 OFFSET을 사용하는 UNION 쿼리 (추정)

이 수정 전에는 병합된 UNION 쿼리에서 LIMIT/OFFSET이 누락될 수 있었습니다.

>  * fix: keep LIMIT/OFFSET even when merging UNION queries [#18361](https://github.com/vitessio/vitess/pull/18361)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 빈 입력에서 스칼라 집계의 리터럴 결과 수정

- 영향 대상: 리터럴 값으로 스칼라 집계를 사용하는 쿼리 (추정)

입력이 비어 있으면(예를 들어 하위 쿼리의 `WHERE` 조건에서 행이 반환되지 않아) 리터럴을 컬럼 참조처럼 처리해 예시에서 (`1`, `0`) 대신 (`NULL`, `0`)을 반환했습니다. 이제 리터럴을 평가하므로 MySQL과 호환되는 결과인 (`1`, `0`)을 반환합니다.

>  * Fix scalar aggregation with literals in empty result sets [#18477](https://github.com/vitessio/vitess/pull/18477)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 단순 프로젝션의 prepared statement 필드 목록 수정

- 영향 대상: 이름만 가져오는 최적화를 사용하는 단순 프로젝션 prepared statement (추정)

단순 프로젝션을 사용하는 prepared statement에서 `GetFields`가 `buildFields`를 직접 호출할 때, 이름만 가져오는 경우 필드 목록이 비어 있었습니다.

>  * Fix for simple projection showing no fields [#18489](https://github.com/vitessio/vitess/pull/18489)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess 플래너의 파생 테이블 `GROUP BY` 계획 컬럼 수 수정

- 영향 대상: 파생 테이블에만 `GROUP BY`를 적용하는 쿼리

이런 쿼리에서는 플래너가 프로젝션 폭을 잘못 계산해 결과에 불필요한 컬럼이 포함될 수 있었습니다.

>  * bugfix: Plan group by only on top of derived tables correctly [#18505](https://github.com/vitessio/vitess/pull/18505)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### [드러나지 않던 결함] Throttler 메트릭 집계의 gRPC 다이얼 오류 인식

- 영향 대상: throttler 메트릭 집계를 사용하는 구성

메트릭 프로브의 gRPC 연결이 `Unavailable` 또는 `DeadlineExceeded` 오류로 실패하면, 집계 과정에서 이를 비정상 상태로 처리해 `VReplication` 같은 throttler 사용자가 스로틀링됐습니다.

>  * Properly handle grpc dial errors in the throttler metric aggregation [#18073](https://github.com/vitessio/vitess/pull/18073)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 오류 뒤에도 `SrvKeyspace` watch를 유지하는 Tablet throttler

- 영향 대상: 태블릿 throttler의 `SrvKeyspace` watch를 사용하는 설정

watch 콜백에서 오류를 받으면 리스너가 제거되어, throttler는 다시 `Open()`을 호출할 때까지 `SevKeyspace` 변경 사항을 읽지 못했습니다. 보통 태블릿 타입이 바뀔 때 `Open()`이 다시 호출됐습니다. 이제 오류가 발생해도 watch가 계속 활성 상태를 유지합니다.

>  * Throttler: keep watching topo even on error [#18223](https://github.com/vitessio/vitess/pull/18223) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Atomic Copy의 post-copy 액션 실행 수정

- 영향 대상: 복사된 테이블에 post-copy 액션을 사용하는 Atomic Copy 워크플로

`copyAll()`이 테이블의 post-copy 액션 실행을 놓칠 수 있었습니다. 이제 실행된 액션 레코드와 해당 `_vt.copy_state` 레코드가 `_vt.post_copy_action`에서 함께 제거됩니다.

>  * Perform post copy actions in atomic copy [#18411](https://github.com/vitessio/vitess/pull/18411)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Replication tracker의 primary tablet replication lag 메트릭 초기화

- 영향 대상: replication tracker를 사용하는 VTTablet 구성 (추정)

primary로 승격된 뒤, 또는 tracker가 primary 상태이거나 `Disable` 모드일 때 `Status()`가 실행되면 이전 lag 값이 남아 있을 수 있었습니다. 이제 이 경우 메트릭이 0으로 초기화됩니다.

>  * [release-23.0] repltracker: reset replica lag when we are primary (#18800) [#18807](https://github.com/vitessio/vitess/pull/18807)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### [드러나지 않던 결함] 쿼리 통합기 대기자 상한 초과 시 폴백 수정

- 영향 대상: 쿼리 통합을 사용하는 쿼리 서빙 구성 (추정)

대기자 상한을 초과하면 통합기가 오류 없이 빈 결과를 반환할 수 있었습니다. 이제 해당 쿼리는 독립적으로 실행되고 결과를 반환합니다.

>  * [release-23.0] Fix bug where query consolidator returns empty result without error when the waiter cap exceeded (#18782) [#18833](https://github.com/vitessio/vitess/pull/18833) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### [드러나지 않던 결함] `GenerateShardRanges`의 불완전한 범위 커버리지 수정

- 영향 대상: `GenerateShardRanges`를 사용한 샤드 이름 생성 (추정)

일부 샤드 개수(예: 49)에서는 생성된 샤드 이름이 전체 범위를 포괄하지 못했습니다. 이제 전체 키스페이스를 포괄합니다.

>  * fix: Fix `GenerateShardRanges` returning shard names that don't cover the full range [#18641](https://github.com/vitessio/vitess/pull/18641) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `ready_to_complete`에서 Online DDL 진행률을 100%로 수정

- 영향 대상: `ready_to_complete`에 도달하는 Online DDL 마이그레이션

`ready_to_complete`에서는 테이블 행 추정 때문에 보고된 진행률이 87% 또는 100%와 크게 다른 값으로 남을 수 있었습니다.

>  * Online DDL: set migration's progress to 100% once it's `ready_to_complete` [#18544](https://github.com/vitessio/vitess/pull/18544)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `UNION` 쿼리의 불가능 쿼리 포맷팅 수정

- 영향 대상: `UNION` 문에 대한 불가능 쿼리 컬럼 메타데이터 조회

불가능 쿼리가 데이터를 가져오지 않고 `UNION`의 컬럼 이름과 타입을 조회할 때, 포매터가 결과 행이 없도록 하는 조건을 항상 추가하지는 않았습니다. 이제 포맷된 쿼리에 `where 1 != 1`을 포함하며, 각 `UNION` 분기에도 적용합니다.

>  * bugfix: Fix impossible query for UNION [#18463](https://github.com/vitessio/vitess/pull/18463)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 필터와 일치하는 비샤딩 업데이트에서 양쪽 이미지를 전송하는 VStreamer 필터

- 영향 대상: 행 컬럼 필터를 사용하는, `MoveTables` 및 `Reshard`를 제외한 비샤딩 VStreamer 워크플로

업데이트로 필터가 사용하는 컬럼이 변경되고 `Before` 또는 `After` 이미지 중 하나가 필터와 일치하면, 조건을 통과한 이미지만 전송되어 다운스트림 컨슈머가 업데이트를 삽입이나 삭제로 해석할 수 있었습니다.

>  * VStreamer: change in filter logic [#18319](https://github.com/vitessio/vitess/pull/18319)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTOrc `SkippedRecoveries` 메트릭에 사유 차원 추가

- 영향 대상: `SkippedRecoveries` 메트릭을 내보내거나 소비하는 VTOrc 설치

VTOrc가 복구를 건너뛰면 메트릭에서 `ERSDisabled`, `ReplicationLagHigh`, `NotEnoughReplicas` 같은 사유를 식별하고, 이전에 누락됐던 복구 건너뛰기 사례도 추적합니다.

> |          Name                         |   Dimensions                                  |                   Description                        |                           PR                            |
> |:-------------------------------------:|:---------------------------------------------:|:----------------------------------------------------:|:-------------------------------------------------------:|
> | `SkippedRecoveries`                   | `RecoveryName`, `Keyspace`, `Shard`, `Reason` | Count of skipped recoveries with reason tracking.    | [#18644](https://github.com/vitessio/vitess/pull/18644) |
> **`SkippedRecoveries` Reasons**: The `Reason` dimension tracks why recoveries were skipped (e.g., "ERSDisabled", "ReplicationLagHigh", "NotEnoughReplicas"), providing actionable insights for operational troubleshooting.
>  * `vtorc`: add `Reason` and missing cases to `SkippedRecoveries` metric [#18644](https://github.com/vitessio/vitess/pull/18644)

### `CREATE PROCEDURE` 본문 `SET` 문 정규화 수정

- 영향 대상: `SET` 문이 포함된 저장 프로시저 (추정)

플래너 정규화 과정에서 프로시저 본문의 `SET y = 4`가 `SET @@y = 4`로 바뀌었습니다. 이제 Vitess는 `CREATE PROCEDURE` 문에 이 정규화를 적용하지 않아 본문의 `SET` 문을 변경하지 않습니다.

> - Support for `SET` statements within procedure bodies
>  * Fix `SET` and `START TRANSACTION` in create procedure statements [#18279](https://github.com/vitessio/vitess/pull/18279)

### Vitess의 `AND` 결합 시 `MEMBER OF` 우선순위 수정

- 영향 대상: `MEMBER OF`를 사용하는 JSON 쿼리

쿼리에서 `MEMBER OF`를 `AND` 또는 다른 불리언 로직과 함께 사용하면 우선순위가 잘못 적용되어 Vitess가 백엔드 MySQL 인스턴스에 잘못된 쿼리를 보낼 수 있었습니다. 이제 수정된 우선순위에 따라 평가됩니다.

> - Fixed `MEMBER OF` operator precedence with `AND` ([PR #18237](https://github.com/vitessio/vitess/pull/18237))
> - Ensures correct query evaluation when combining JSON operations with boolean logic
>  * make sure to give MEMBER OF the correct precedence [#18237](https://github.com/vitessio/vitess/pull/18237)

### 삭제된 키스페이스에 남은 고아 서빙 레코드 정리

- 영향 대상: `RebuildKeyspace`를 사용한 키스페이스 재빌드 (추정)

이전에는 키스페이스를 삭제한 뒤에도 남은 서빙 레코드 때문에 `RebuildKeyspace`가 삭제된 키스페이스를 만나면 `vtgate`가 비정상 종료됐습니다. 이제는 해당 레코드를 대신 정리합니다.

>  * Add code to clear orphaned files for a deleted keyspace [#18098](https://github.com/vitessio/vitess/pull/18098) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Online DDL 테이블 이름 변경 실패 시 vreplication 재시작

- 영향 대상: 테이블 이름 변경 전에 vreplication을 중지하는 Online DDL 컷오버 (추정)

vreplication을 중지한 뒤 남은 `RENAME`이 실패하면, 해당 워크플로의 vreplication을 다시 시작하려고 시도합니다.

> #### Online DDL
>  * Online DDL: resume vreplication after cut-over/RENAME failure [#18428](https://github.com/vitessio/vitess/pull/18428) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 태블릿 유형을 구분하는 vtgate 플랜 키

- 영향 대상: primary와 replica 등 서로 다른 태블릿 유형별로 쿼리 플랜을 생성하고 캐시하는 vtgate 워크로드 (추정)

vtgate가 태블릿 유형을 구분하지 않는 키를 가진 플랜을 재사용하면 잘못된 플랜을 사용할 수 있었습니다.

>  * Fix: Add tablet type to the plan key [#18155](https://github.com/vitessio/vitess/pull/18155)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 복원력 있는 토폴로지 워처의 반복 알림 수정

- 영향 대상: 복원력 있는 토폴로지 워처를 사용하는 구성 (추정)

토폴로지 장애 중 캐시된 데이터를 사용할 수 있으면, 워처는 캐시 데이터를 제공하는 동안에도 매번 새로 고칠 때마다 리스너에 알림을 보냈습니다. 이제 리스너에 알림을 보내지 않으며, `Get` 작업은 계속 캐시에서 데이터를 가져옵니다.

>  * Fix watcher storm during topo outages [#18434](https://github.com/vitessio/vitess/pull/18434)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `dual` 테이블 트래픽 미러링 지원

- 영향 대상: `dual` 테이블이 포함된 쿼리에 트래픽 미러링을 사용하는 설정 (추정)

이전에는 미러 규칙 항목이 없는 `dual` 테이블이 포함된 쿼리를 미러링할 때 panic이 발생할 수 있었습니다. 이제 쿼리는 `dual` 테이블을 미러링하지 않고 처리됩니다.

>  * go/vt/vtgate: handle dual tables in traffic mirroring [#18458](https://github.com/vitessio/vitess/pull/18458)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess의 `UNION` 플래닝 중 컬럼 별칭 처리 수정

- 영향 대상: `UNION`에서 컬럼 별칭을 사용하는 쿼리 (추정)

Vitess는 `UNION`을 플래닝할 때 컬럼 별칭을 처리하는 데 어려움이 있었습니다. 예시에서는 `UNION ALL`의 두 분기 모두에 별칭을 사용합니다.

>  * fix: handle aliases in UNIONs better [#18484](https://github.com/vitessio/vitess/pull/18484)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess 라우팅 테이블 외래 키 처리 수정

- 영향 대상: 외래 키 관계와 라우팅 테이블이 있는 구성

MoveTables에서 SwitchWrites를 실행한 뒤 소스 키스페이스의 자식 테이블이 대상 키스페이스의 라우팅된 부모 테이블을 찾을 수 있었습니다. 그 결과 부모 테이블에 소스 키스페이스의 자식 테이블이 포함되어 외래 키 참조가 깨졌습니다. 이제 외래 키 관계는 대상 키스페이스의 라우팅된 테이블에만 추가하고, 소스 키스페이스의 테이블에는 추가하지 않습니다.

>  *  Fix foreign key relation with routed tables [#18537](https://github.com/vitessio/vitess/pull/18537)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 유효하지 않은 `srvtopo` 캐시 항목 갱신

- 영향 대상: `srvtopo` 조회

캐시 유효 기간 중에는 캐시된 오류를 반환해 소스를 다시 조회하지 않을 수 있었고, 이 때문에 `show vitess_shards` 같은 호출이 컨텍스트 취소나 시간 초과로 실패할 수 있었습니다. 이제 유효하지 않은 캐시 항목이나 캐시된 오류가 있으면 캐시를 갱신하고 새 결과를 기다립니다. 아직 유효한 캐시 값은 추가 조회 없이 반환합니다.

>  * `srvtopo/query.go`: Do not query errors, fall back and refresh [#18589](https://github.com/vitessio/vitess/pull/18589)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess 자기 참조 외래 키 검증 쿼리에 별칭 추가

- 영향 대상: `RESTRICT` 동작을 사용하는 자기 참조 외래 키

Vitess가 이러한 외래 키의 검증 쿼리를 계획할 때 테이블을 자기 조인하면서 조인되는 테이블에 별칭을 지정하지 않아 MySQL에서 쿼리 실행이 실패했습니다. 이제 조인되는 테이블에 별칭을 지정해 실행 실패를 방지합니다.

>  * Introduce aliases for foreign keys verify operations [#18601](https://github.com/vitessio/vitess/pull/18601)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 연결 풀 종료 중 요청 대기 멈춤 수정

- 영향 대상: 연결 풀을 사용하는 구성 (추정)

연결 풀이 닫히는 중에 연결을 요청하면 대기가 멈춰 PRS/ERS 같은 정상 작업이 성공하지 못할 수 있었습니다.

>  * CONNPOOL: Fix race condition when waiting for connection [#18713](https://github.com/vitessio/vitess/pull/18713)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VDiff 추가 행 조정 중 패닉 수정

- 영향 대상: 추가 행을 조정하는 VDiff 실행

추가 소스 행이나 대상 행이 `--max-extra-rows-to-compare`를 초과하거나 소스와 대상에서 반환된 행 수가 다르면 VDiff에서 패닉이 발생할 수 있었습니다. 이제 추가 행 차이 슬라이스의 길이를 사용해 이 경우들에서 범위를 벗어난 접근을 방지합니다.

> #### VDiff
>  * Fix a panic in VDiff when reconciling extra rows. [#18585](https://github.com/vitessio/vitess/pull/18585) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VStream 캐치업 조기 EOF 수정

- 영향 대상: VStream API 캐치업

테이블이 여러 개인 경우, copy 단계에서 이미 복사한 테이블이나 행의 업데이트 또는 삭제를 처리하기 전에 캐치업이 `EOF`를 반환할 수 있었습니다. fastforward-set의 `stopPos`를 재설정하면 조기 종료를 막아 캐치업이 해당 트랜잭션을 처리할 수 있습니다.

>  * VStream API: Reset stopPos in catchup [#18119](https://github.com/vitessio/vitess/pull/18119)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `vcopier`의 닫힌 채널 패닉으로 인한 태블릿 크래시 방지

- 영향 대상: `vcopier` 복사 작업을 사용하는 태블릿 워크로드

`copyAll` 콜백이 `resultCh`가 닫힌 뒤 결과를 보내면, 예를 들어 컨텍스트가 데드라인을 초과한 경우 패닉이 발생해 태블릿이 크래시할 수 있었습니다. 이제 해당 패닉을 복구하고 로그에 기록합니다.

>  * Recover panic in vcopier due to closed channel [#18228](https://github.com/vitessio/vitess/pull/18228)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Atomic Copy 테이블 스트리밍 오류 전파

- 영향 대상: 테이블을 스트리밍하면서 Atomic Copy를 사용하는 워크플로

연결 타임아웃과 같은 스트림 오류를 무시하면 워크플로가 다시 시작되어 복사 단계에 재진입하고 중복 키 오류가 발생할 수 있었습니다. 이제 오류가 전파되며, 로그에 실패한 테이블과 설정된 네트워크 읽기 및 쓰기 타임아웃이 표시됩니다.

>  * Atomic Copy: Handle error that was ignored while streaming tables and log it [#18313](https://github.com/vitessio/vitess/pull/18313)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 복제 오류로 종료되지 않는 Atomic Copy 워크플로

- 영향 대상: Atomic Copy 서브모드에서 복사 단계를 완료하고 `running` 상태에 진입한 VReplication 워크플로

복사 단계가 끝난 뒤 복제 단계에서 오류가 발생하면 워크플로가 종료될 수 있었습니다. 이제 이러한 오류를 정상적으로 처리합니다.

>  * Avoid terminating atomic copy workflows on error if they are out of copy phase [#18475](https://github.com/vitessio/vitess/pull/18475)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### MariaDB의 역방향 워크플로 VReplication 읽기 거부 문제 수정

- 영향 대상: 역방향 워크플로를 사용하는 MariaDB발 VReplication 임포트

더 엄격한 SQL 그룹화 규칙 때문에 MariaDB가 쿼리를 거부해 이러한 임포트에서 VReplication 워크플로를 읽지 못할 수 있었습니다. 쿼리에서 거부를 유발한 `GROUP BY` 절을 제거했습니다.

>  * VReplication: Fix bug while reading _vt.vreplication record [#18478](https://github.com/vitessio/vitess/pull/18478)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VStreamer 동시 맵 접근 크래시 수정

- 영향 대상: `vttablet`의 VStreamer 이벤트 파싱 (추정)

GTID를 제자리에서 계산하는 동안 맵에 동시에 접근하면 `vttablet`에서 `fatal error: concurrent map read and map write` 오류가 발생해 크래시가 날 수 있었습니다. 이제 VStreamer는 제자리 연산 대신 `replication.AppendGTID`를 사용합니다.

>  * Vstreamer: idempotent gtid set (bugfix) [#18611](https://github.com/vitessio/vitess/pull/18611)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### purge된 바이너리 로그 오류 후 VStream 재시도

- 영향 대상: VStream 요청

소스에서 필요한 바이너리 로그를 purge해 태블릿에 요청한 GTID가 없을 때, 이전에는 VStream이 해당 태블릿을 제외하지 않아 그 이유로 다른 태블릿을 시도하지 않았습니다. 이제 다른 태블릿으로 재시도하며, 해당 태블릿에는 요청한 바이너리 로그 이력이 남아 있을 수 있습니다.

>  * VStream: Try new tablet on purged binlog error [#18710](https://github.com/vitessio/vitess/pull/18710)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VReplication의 하이픈 포함 식별자 처리 수정

- 영향 대상: 키스페이스, 데이터베이스, 테이블 또는 시퀀스 이름에 하이픈이 포함된 VReplication 관련 작업

이제 이러한 작업은 테이블 키스페이스, 테이블 이름, 데이터베이스, 시퀀스 등의 식별자를 SQL에서 사용하기 전에 이스케이프합니다.

>  * [release-23.0] VReplication: Ensure proper handling of keyspace/database names with dashes (#18762) [#18773](https://github.com/vitessio/vitess/pull/18773)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### etcd2topo 종료 중 패닉 수정

- 영향 대상: etcd2topo 서버 구현을 사용하는 설정

VTGate 종료 중 `Close()`가 `s.cli`를 `nil`로 설정한 뒤에도 동시 실행 중인 고루틴이 `s.cli`에 접근할 수 있어 nil 포인터 역참조 패닉이 발생했습니다. 이제 이런 작업은 패닉을 일으키는 대신 종료 신호인 `context.Canceled`를 반환하며, 이 신호는 `topo.Interrupted`로 변환됩니다.

>  * Make sure to check if the server is closed in etcd2topo [#18352](https://github.com/vitessio/vitess/pull/18352)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 세미싱크 모니터 타이머 종료 데드락 수정

- 영향 대상: VTTablet 세미싱크 모니터를 실행하는 구성 (추정)

`mu`를 보유한 상태에서 타이머를 닫으면 `checkAndFixSemiSyncBlocked`도 `mu`를 획득할 때 데드락이 발생할 수 있었습니다. 이제 모니터는 별도의 타이머 mutex로 타이머의 `Open`과 `Close`를 직렬화하고, `mu`를 획득하기 전에 타이머 틱을 닫습니다.

>  * Fix deadlock in semi-sync monitor [#18276](https://github.com/vitessio/vitess/pull/18276)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VTTablet 세미싱크 모니터 데드락 수정

- 영향 대상: VTTablet 세미싱크 모니터를 실행하는 설정 (추정)

세미싱크가 차단된 상태에서 하트비트 쓰기가 시작된 뒤 `setIsBlocked`가 모니터 상태를 변경하기 전에 모니터가 닫히면, `appPool` 종료 과정에서 데드락이 발생할 수 있었습니다. 종료 과정은 쓰기에 사용된 연결이 풀에 반환되기를 기다렸고, 쓰기 스레드는 뮤텍스를 기다리고 있었습니다. 이제 모니터는 뮤텍스를 기다리기 전에 연결을 풀에 반환하므로, 종료 과정이 차단된 쓰기가 점유한 연결을 기다리지 않습니다.

>  * Fix: Deadlock in `Close` and `write` in semi-sync monitor. [#18359](https://github.com/vitessio/vitess/pull/18359)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 복사 단계 중 `VStreamRows` 하트비트 반복 전송

- 영향 대상: 장시간 실행되는 `VStreamRows` 작업

이전에는 장시간 실행되는 테이블 복사 중 하트비트를 한 번 보낸 뒤 하트비트 메커니즘이 종료됐습니다. 여기에는 OnlineDDL의 복사 단계와 MoveTables/Reshard 중 테이블 복사가 포함됩니다.

>  * [Bugfix] Broken Heartbeat system in Row Streamer [#18390](https://github.com/vitessio/vitess/pull/18390)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### `ValidateKeyspace` 데드락 수정

- 영향 대상: `vtctldclient`를 통해 `ValidateKeyspace`를 사용하는 구성 (추정)

reader가 활성화되기 전에 쓰기를 시작하면 결과 writer가 무기한 대기할 수 있었습니다. 이제 쓰기를 시작하기 전에 결과를 처리하고 소비하므로 writer에 활성 reader가 있습니다.

> #### vtctldclient
>  * Fix deadlock in `ValidateKeyspace` [#18114](https://github.com/vitessio/vitess/pull/18114)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### vttablet의 외부 MySQL 연결 확인에 SSL 설정 전달

- 영향 대상: 보안 연결이 필요한 외부 MySQL 인스턴스에 연결하는 vttablet

vttablet가 보안 연결이 필요한 외부 MySQL 인스턴스의 연결 상태를 확인할 때 SSL 설정을 전달하지 않아 확인에 실패했고, MySQL 오류로 vttablet가 시작되지 않았습니다. 이제 연결 로직에 SSL 설정을 전달하므로 이 시작 오류를 방지합니다.

>  * Pass SSL config when checking connection to external mysql instance [#18481](https://github.com/vitessio/vitess/pull/18481) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### 2차 완화 조치보다 프라이머리 복구를 우선하는 VTOrc

- 영향 대상: 클러스터 전체에 영향을 미치지 않는 복구 분석을 처리하는 VTOrc 구성

`ReplicationStopped` 같은 클러스터 전체에 영향을 미치지 않는 문제가 다운된 프라이머리 때문에 발생한 경우, VTOrc는 프라이머리 장애를 인식하기 전에 2차 문제를 완화하려고 샤드에 잠금을 걸 수 있었고, 이로 인해 프라이머리 복구가 지연됐습니다. 이제 VTOrc는 처리를 계속하기 전에 프라이머리 정보를 새로 고치며, 프라이머리 문제의 완화가 필요하면 오래된 분석을 중단합니다.

>  * Vtorc: Recheck primary health before attempting a failure mitigation [#18234](https://github.com/vitessio/vitess/pull/18234)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### Vitess Java JDBC 드라이버의 격리 변수 조회 수정

- 영향 대상: MySQL 8.0 또는 MySQL 5.7.20 이상을 사용하는 Vitess Java JDBC 드라이버

MySQL 8.0에서 초기화 과정은 지원 중단 예정이거나 제거된 `tx_isolation`을 조회했습니다. 대체 변수인 `transaction_isolation`은 MySQL 5.7.20 이상과 하위 호환됩니다.

>  * Use transaction_isolation vs tx_isolation [#17845](https://github.com/vitessio/vitess/pull/17845)

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

### VDiff 사이드카 스키마 업데이트로 쿼리 성능 개선

- 영향 대상: 내부 사이드카 데이터베이스를 사용해 VDiff를 실행하는 구성 (추정)

VDiff를 실행할 때 내부 사이드카 데이터베이스에 성능이 좋지 않은 쿼리를 보내면 프라이머리 vttablet이 크래시하는 등 심각한 문제가 발생할 수 있었습니다. 스키마에서 `vdiff_log.id`, `vdiff_log.vdiff_id`, `vdiff_table.vdiff_id`의 타입을 `bigint(20)`으로 변경하고, 일부 VDiff 쿼리의 성능을 개선하기 위해 `vdiff_id_idx` 인덱스를 추가했습니다.

>  * Fix: Improve VDiff internal query performance [#18579](https://github.com/vitessio/vitess/pull/18579) 

https://github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

## 기능·개선 (47)

- VTGate용 `ExecuteMulti` 및 `StreamExecuteMulti` API (사용 조건: 이 기능을 사용하려면 VTGate에서 `--mysql-server-multi-query-protocol`을 활성화해야 합니다.)
- 세션별 트랜잭션 타임아웃 제어
- 실험적 인커밍 쿼리 스로틀링 프레임워크
- 하나의 `vtctldclient` 워크플로에서 여러 lookup vindex 사용 (사용 조건: lookup vindex 매개변수가 담긴 JSON 파일을 지정하는 `--params-file` 사용; `--type`, `--table-owner`, `--table-owner-columns`와 동시 지정 불가)
- 기존 materialize 워크플로에 참조 테이블 추가 (사용 조건: `Materialize ... update`에서 `--add-reference-tables`와 대상 keyspace 지정)
- Vitess의 재귀 CTE 지원
- Vitess의 `CREATE TABLE ... SELECT` SQL 파서 지원
- VTGate 샤드 및 유형별 트랜잭션 카운터 추가
- VTGate에 지연 최적화 쿼리 카운터 추가
- Online DDL에 오래된 마이그레이션 경과 시간 게이지 추가
- VTOrc의 `EmergencyReparentShardDisabled` 게이지 추가
- vtgate, vttablet, vtcombo의 조건별 쿼리 로깅 (사용 조건: `--querylog-emit-on-any-condition-met` 활성화(기본값은 false))
- VTOrc 시작 시 복구 제어 (사용 조건: `--allow-recovery=false`)
- `GenerateShardRanges` 샤드 라벨의 16진수 너비 설정 (사용 조건: `--chars` 플래그)
- `ALTER VITESS_MIGRATION ... POSTPONE COMPLETE` 명령 지원
- `INSERT` 및 `REPLACE`의 단수형 `VALUE` 파서 지원
- VTOrc 긴급 reparenting의 keyspace·shard별 제어 (사용 조건: `--keyspace`와 선택적 `--shard`, 그리고 `--enabled=true` 또는 `--enabled=false`를 사용하는 `vtctldclient SetVtorcEmergencyReparent` 명령)
- `IN` 필터의 튜플 바인드 변수 지원
- Resharding journal의 `val` 컬럼을 `longblob`으로 확장
- 비관리 태블릿에서 빈 비밀번호 자격 증명 허용
- `xtrabackup` 백업 엔진의 태블릿 드레이닝 설정 (사용 조건: `--xtrabackup-should-drain`을 `true`로 설정)
- 파싱한 MySQL 연결 속성의 서버 사용을 위한 보존
- 핸드셰이크 중 연결 속성을 전송하는 MySQL 클라이언트 지원 (사용 조건: `ConnectionAttributes` 맵과 함께 `ConnectWithAttributes` 사용)
- 디스커버리용 커스텀 로거 지원 (사용 조건: `WithLogger` 옵션)
- VTTablet의 primary-serving 경로에서 binlog watcher 종료 로그
- gRPC 서버의 ORCA 백엔드 메트릭 보고 (사용 조건: `--grpc-enable-orca-metrics` 활성화(기본값: false))
- 쿼리 로깅에 실행 시간 임계값 추가 (사용 조건: `--querylog-time-threshold`에 `time.ParseDuration` 형식의 duration 설정; 스트리밍 쿼리에는 유용하지 않음)
- Online DDL 준비 상태 변경 로그
- 예제 Vitess Operator CRD 스키마에 `fetchCredentials` 추가
- 쿼리 플래너의 최적화 실패 사유 디버그 로그 (사용 조건: `DebugOperatorTree = true`)
- `SET NAMES binary` SQL 파서 지원
- 태블릿 수신 쿼리 쓰로틀링 (사용 조건: `/config/throttler-config.json`의 Throttler 활성화 플래그)
- Query Throttler 드라이런 모드
- 새 TMC RPC를 통한 `switchwrites` 시퀀스 일괄 처리
- 키스페이스를 제외한 VStream 테이블 이름 (사용 조건: `ExcludeKeyspaceFromTableName` VStream 플래그 설정)
- 호환 가능한 DDL 변경에서 스키마를 사용하는 VStreamer
- `vtgateconn` gRPC 인터페이스의 세션 종료 메서드 제공
- vtgate 연결의 gRPC fail-fast 설정 (사용 조건: gRPC fail-fast 활성화 조건: `vtgate-grpc-fail-fast`를 `true`로 설정, 기본값 `false`)
- vtgateconn gRPC 플래그 등록 함수 외부 공개
- 한 번의 호출로 MySQL 복제 재시작 (사용 조건: 추가된 `RestartReplication` 메서드를 호출하는 클라이언트)
- `SchemaDiff`에 외래 키 영향 목록 추가
- Online DDL 마이그레이션의 샤드별 완료
- VStream 선택적 테이블 복사 (사용 조건: `VStreamOptions` 또는 `VStreamFlag`에서 `TablesToCopy` 설정)
- `vstreamer`의 `PREVIOUS_GTIDS` VEvent 출력
- vstreamer 이벤트에 GTID 메타데이터 추가
- `operator.yaml`의 `mysqldExporter.extraFlags` 스키마 지원 (사용 조건: `operator.yaml`의 `mysqldExporter.extraFlags`를 추가 속성의 값이 문자열인 객체로 정의)
- `mysqldExporter`에 `resources` 설정 불필요

## 의존성 갱신 (17)

그 외 17건 · 보안 언급 없음

- `* Build mysql80 Dockerfile with go1.25.1 [#18694](https://github.com/vitessio/vitess/pull/18694)`
- `` * [main] Upgrade the Golang version to `go1.24.2` [#18093](https://github.com/vitessio/vitess/pull/18093) ``
- `` * [main] Upgrade the Golang version to `go1.24.3` [#18241](https://github.com/vitessio/vitess/pull/18241) ``
- `` * [main] Upgrade the Golang version to `go1.24.4` [#18327](https://github.com/vitessio/vitess/pull/18327) ``
- `` * [main] Upgrade the Golang version to `go1.25.0` [#18573](https://github.com/vitessio/vitess/pull/18573) ``
- `` * [main] Upgrade the Golang version to `go1.25.1` [#18622](https://github.com/vitessio/vitess/pull/18622) ``
- `* Bump subset of Go dependencies [#18577](https://github.com/vitessio/vitess/pull/18577)`
- `* Upgrade the Golang Dependencies [#18082](https://github.com/vitessio/vitess/pull/18082)`
- `* Bump golang.org/x/net from 0.37.0 to 0.38.0 [#18177](https://github.com/vitessio/vitess/pull/18177)`
- `* Upgrade the Golang Dependencies [#18266](https://github.com/vitessio/vitess/pull/18266)`
- `* Bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 [#18404](https://github.com/vitessio/vitess/pull/18404)`
- `* Main: Bump Go Dependencies [#18686](https://github.com/vitessio/vitess/pull/18686)`
- `* Upgrade the Golang Dependencies [#18711](https://github.com/vitessio/vitess/pull/18711)`
- `* Bump @babel/runtime from 7.26.0 to 7.27.6 in /web/vtadmin [#18467](https://github.com/vitessio/vitess/pull/18467)`
- `* Bump form-data from 4.0.1 to 4.0.4 in /web/vtadmin [#18473](https://github.com/vitessio/vitess/pull/18473)`
- `* Bump vite from 4.5.9 to 4.5.14 in /web/vtadmin [#18485](https://github.com/vitessio/vitess/pull/18485)`
- `` * Deprecate `github.com/mitchellh/mapstructure` library [#18687](https://github.com/vitessio/vitess/pull/18687) ``

## 기타 (110)

- VTTablet 상태 메트릭에 `type`, `keyspace`, `shard` 레이블 추가
- SQL 문 분리기의 `CREATE PROCEDURE` `DEFINER` 절 처리
- `DEFINER` 절이 있는 `CREATE PROCEDURE` 문 분리 개선
- 저장 프로시저 파싱 시 `START TRANSACTION`을 더 이상 `BEGIN`으로 변환하지 않음
- 윈도우 함수의 대상 샤드 푸시다운
- UNION 쿼리 병합 강화
- UNION 쿼리의 불필요한 파생 테이블 래핑 방지
- `SINGLE` 모드의 읽기 전용 멀티샤드 트랜잭션
- 런타임에 따라 달라지는 쿼리 플랜을 지원하는 prepared statement
- 복구 통계에 keyspace와 샤드 레이블 포함
- 풀 리퀘스트 템플릿에 AI 사용 공개 항목 추가
- MySQL Shell 복원 기능 지원 확인 수정
- CI 빌드의 초안 상태 판단에 이벤트 페이로드 사용
- 로컬 예제 테스트에서 Docker에 `TOPO` 전달 및 Consul 제외
- golang-ci lint 스크립트, `v` 접두사 유무와 관계없이 버전 허용
- 취소된 vreplication 마이그레이션 항목 유지
- 플래너에서 서브쿼리 병합 복원
- `CREATE PROCEDURE` 본문에서 `START TRANSACTION` 유지
- 태블릿 쿼리에서 데이터베이스 한정자 제거
- zk2와 Consul에서 NamedLock 테스트 추가 및 통과
- SwitchWrites 진행 상황 및 오류 로깅 확대
- VTCombo 테스트 헬퍼의 버전에 맞는 `--vschema-ddl-authorized-users` 변형 선택
- `*vstreamManager.VStream` 반환 후 콜백 실행 방지
- 콜백 오류 발생 시 `*vstreamManager.VStream`의 즉시 반환
- 트래픽 전환 시 시퀀스 카운터 초기화
- Go 버전 업그레이드 워크플로에 `release-22.0` 브랜치 포함
- CI 워크플로의 CNCF Oracle VM 러너 전환
- 라이브러리 패키지에 대한 `depguard` 제한
- Go 의존성 및 Go 버전 워크플로에서 `peter-evans/create-pull-request`를 v7로 업데이트
- CI 워크플로의 기본 MySQL 버전을 8.4로 변경
- Protobuf 무작위성 해킹 제거 및 골든 테스트 구조 비교
- CI 워크플로 업데이트: `mysql-apt-config_0.8.35-1_all.deb`
- Vitess Java 패키지 게시를 Central로 이전
- 불안정한 vdiff2 엔드투엔드 테스트의 별도 워크플로 이동
- CI에서 `TestMigrateSharded` 테스트 건너뜀
- v22.0.0 릴리스 노트 문구 교정
- `MAINTAINERS.md` 연락 이메일 주소 업데이트
- 릴리스 사이클 풀 리퀘스트 분석 도구 추가
- vmg를 전 메인테이너 목록으로 이동
- `@deepthi` 명예 메인테이너로 전환
- Manan Gupta 메인테이너 이메일 업데이트
- Manan Gupta를 이전 메인테이너로 분류
- Vitess 메인테이너 목록 업데이트
- `CODEOWNERS` 소유자 항목 업데이트
- 비샤드 키스페이스에서 vtgate를 통한 `CREATE PROCEDURE` 지원 요약
- `go-upgrade`에서 Go 패치 버전 업데이트 감지
- CI 워크플로 필터를 이벤트 설정으로 이동
- 쿼리 로그 출력에 `EmitReason` 컬럼 추가
- 명령줄 플래그 이름의 대시 구분 방식 전환
- VTTablet ACL 재로드 성공 로그 포맷 수정
- Online DDL 컷오버 로그에 마이그레이션 UUID 추가
- 더 많은 `UNION` 쿼리의 병합과 튜플 바인드 변수 중복 제거
- 병합된 서브쿼리에서 파싱된 주석 유지
- Vitess의 MySQL 9.x용 MySQL 8.2 플레이버 매핑
- 외부 태블릿 `SwitchTraffic` 권한 검사에 와일드카드 데이터베이스 이름 검사 추가
- 외부 태블릿 권한 확인 로그 수정
- VReplication 복사 단계 히스토리 목록 기본 한도 10MB로 상향
- 대시 표기로 마이그레이션된 `vtcombo` 플래그 51개
- `heartbeatWriter` 오류에 컨텍스트 추가
- 스마트 커넥션 풀 세마포어를 채널 기반으로 전환
- `EmergencyReparentShard` 후보 선택 시 SQL 스레드 진행 상황 반영
- MySQL Shell 백업 복원 시 REDO_LOG 재활성화 로그 수정
- CI 워크플로에서 `always()`를 `!cancelled()`로 대체
- CI 워크플로의 `actions/setup-go` v5.5.0 업그레이드
- GitHub Actions 의존성 설치에서 `man-db` 업데이트 건너뛰기
- `vttablet-up.sh`의 잘못된 주석 줄 제거
- Code Coverage 워크플로의 푸시 이벤트 실행 필터링
- 단위 테스트 러너의 패키지 병렬 실행
- `NewHealthCheck` 필터 문서 명확화
- 로컬 예제에서 하이픈 표기 플래그 사용
- asthelpergen 설계 문서
- VTOrc `isClusterWideRecovery`를 `isShardWideRecovery`로 이름 변경
- VTOrc 복제 분석에서 `ClusterDetails` 제거
- VTOrc 샤드 프라이머리 타임스탬프 처리 업데이트
- VTOrc 키스페이스 및 샤드 리프레시에 errgroup 파생 컨텍스트 사용
- VTOrc의 tablet type 필드 읽기에 `GetInt32` 사용
- GTID 세트 업데이트 및 `vstreamer` 포맷팅 최적화
- GTID 그룹별 `vstreamer` `CurrentTime` 생성
- VTorc의 GTID 세트 처리를 `replication.Mysql56GTIDSet`로 전환
- 멀티 쿼리 프로토콜 플래그 처리 수정
- `None` opcode로 계획된 DML 쿼리의 오류 없는 처리
- v23 업그레이드 노트의 `vitess/lite:v23.0.0` 참조
- 메인 변경 로그에 v22.0.0-RC1 릴리스 노트 추가
- 메인 변경 로그에 추가된 v21.0.4 릴리스 노트
- 메인 변경 로그에 `v20.0.7` 릴리스 노트 추가
- v22.0.0-RC2 릴리스 노트를 메인 변경 로그에 추가
- 메인 변경 로그에 추가된 `v22.0.0-RC3` 릴리스 노트
- v22.0.0 릴리스 노트를 메인 변경 로그에 추가
- 메인 변경 로그에 `v22.0.1` 릴리스 노트 추가
- 메인 변경 로그에 v21.0.5 릴리스 노트 추가
- 메인 변경 로그에 v20.0.8 릴리스 노트 추가
- `v23.0.0-RC1` 코드 프리즈 기록
- Vitess `v23.0.0-RC1` 릴리스
- Vitess v23.0.0-RC2 릴리스 기록
- v23.0.0-RC2 이후 v23.0.0-SNAPSHOT으로 버전 업데이트
- 릴리스 노트 업데이트
- `TestTrackerNoLock` 타임아웃 연장 및 `TestCreateLookupVindexMultipleCreate` 기본 검사
- `TestVStreamsMetricsErrors`의 경쟁 상태에 따라 달라지는 결과 처리
- 엔드투엔드 테스트의 MySQL 디렉터리 충돌 수정
- vtgate v23 이상에서만 `_binary` 접두사를 설정하는 VExplain 테스트
- `TestQueryTimeoutWithShardTargeting`에서 다양한 오류 메시지 허용
- 빈 JSON 배열 삽입 테스트
- `TestOverallQueryTimeout` 오류 매칭 유연성 확대
- 외래 키 엔드투엔드 테스트에서 MySQL 8.0 지원
- 예상 오류 메시지를 정확히 검증하는 `FileBasedConfigLoader` 테스트
- VStream 메트릭 테스트 불안정성 수정
- `TestStreamRowsHeartbeat`의 원자적 heartbeat 카운터
- VDiff를 중지하기 전에 시작 또는 완료를 기다리는 VDiff2 종단 간 테스트
- 세미싱크 모니터 테스트 경합 수정
- 스마트 커넥션 풀 테스트 타임아웃 증가

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
