RATATOSK
← 전체 릴리스

Vitessv23.0.0

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

Vitess 알림 받기

확인할 변경이 있을 때만 주 1회, critical 보안 공지는 즉시 발송

업그레이드 전 확인

전제 조건1
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`.
github.com/vitessio/vitess/releases/tag/v23.0.0
알려진 문제2
실험적 스로틀러의 지속적인 개발

개발이 계속 진행 중이며, 향후 릴리스에서 호환성을 깨는 변경이 발생할 수 있습니다.

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.
github.com/vitessio/vitess/releases/tag/v23.0.0
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.**
github.com/vitessio/vitess/releases/tag/v23.0.0

보안11보안 여부 불분명1

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
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)
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)
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)
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.
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) 
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) 
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)
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)
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) 
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) |
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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) 
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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.” 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) |
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.” vitessio/vitess/pull/18423 ↗
원문 보기
 * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)
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.” vitessio/vitess/pull/18626 ↗
원문 보기
 * `vtorc`: implement `restartDirectReplicas` as response to `UnreachablePrimary` [#18626](https://github.com/vitessio/vitess/pull/18626) 
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.” vitessio/vitess/pull/18149 ↗
원문 보기
 * Remove deprecated methods and metrics [#18149](https://github.com/vitessio/vitess/pull/18149) 
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) 
github.com/vitessio/vitess/releases/tag/v23.0.0

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” 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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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.
github.com/vitessio/vitess/releases/tag/v23.0.0

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.
---
github.com/vitessio/vitess/releases/tag/v23.0.0

대상 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)
github.com/vitessio/vitess/releases/tag/v23.0.0

적격 특수 작업 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.” 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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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

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

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

근거“func getCgroup1CpuUsage() (uint64, error) {” vitessio/vitess/pull/18801 ↗
원문 보기
#### Observability
 * [release-23.0] Improve cgroup metric management (#18791) [#18801](https://github.com/vitessio/vitess/pull/18801) 
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)
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"” 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) 
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.” vitessio/vitess/pull/17883 ↗
원문 보기
 * Fix `vttablet` not being marked as not serving when MySQL stalls [#17883](https://github.com/vitessio/vitess/pull/17883)
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) {” vitessio/vitess/pull/18508 ↗
원문 보기
 * Set up better dependency checks [#18508](https://github.com/vitessio/vitess/pull/18508)
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)
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.” vitessio/vitess/pull/18423 ↗
원문 보기
 * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)
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.” vitessio/vitess/pull/18423 ↗
원문 보기
 * Online DDL cutover enhancements [#18423](https://github.com/vitessio/vitess/pull/18423)
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” vitessio/vitess/pull/18339 ↗
원문 보기
 * `vtorc`: cleanup `database_instance` location fields [#18339](https://github.com/vitessio/vitess/pull/18339)
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” vitessio/vitess/pull/18339 ↗
원문 보기
 * `vtorc`: cleanup `database_instance` location fields [#18339](https://github.com/vitessio/vitess/pull/18339)
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`” 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.
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.
github.com/vitessio/vitess/releases/tag/v23.0.0

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)
github.com/vitessio/vitess/releases/tag/v23.0.0

/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`.
github.com/vitessio/vitess/releases/tag/v23.0.0

관리형 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)
github.com/vitessio/vitess/releases/tag/v23.0.0

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

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

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

원문 보기
 * Refactor grpc flags for standardized naming  [#18009](https://github.com/vitessio/vitess/pull/18009)
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)
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)
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)
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)
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)
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)
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)
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)
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) 
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)
github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

중요 수정49드러나지 않던 결함3

  • 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) 
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 밑줄 표기 CLI 플래그 처리 수정
    영향 대상밑줄로 표기한 CLI 플래그, 특히 Viper에 바인딩된 플래그

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

     * Normalize flag names at the `pflag` level. [#18642](https://github.com/vitessio/vitess/pull/18642) 
    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)
    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) 
    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)
    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)
    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)
    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)
    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)
    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)
    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) 
    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)
    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)
    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) 
    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) 
    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)
    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)
    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)
    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)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 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)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 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)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 삭제된 키스페이스에 남은 고아 서빙 레코드 정리
    영향 대상RebuildKeyspace를 사용한 키스페이스 재빌드(추정)

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

     * Add code to clear orphaned files for a deleted keyspace [#18098](https://github.com/vitessio/vitess/pull/18098) 
    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) 
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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) 
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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)
    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) 
    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)
    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)
    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) 
    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을 활성화해야 합니다.

    Vitess v23.0.0 introduces native support for executing multiple queries in a single RPC call through new `ExecuteMulti` and `StreamExecuteMulti` APIs ([PR #18059](https://github.com/vitessio/vitess/pull/18059)).
    This feature provides more efficient batch query execution without requiring manual query splitting or multiple round trips.
    **Usage Example**:
    ```go
    queries := []string{
        "SELECT * FROM users WHERE id = 1",
        "SELECT * FROM orders WHERE user_id = 1",
        "SELECT * FROM payments WHERE user_id = 1",
    }
    results, err := vtgateConn.ExecuteMulti(ctx, queries)
    ```
    **Configuration**: Enable with the `--mysql-server-multi-query-protocol` flag on VTGate.
     * Add a new implementation for handling multiple queries without needing to split them [#18059](https://github.com/vitessio/vitess/pull/18059)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 세션별 트랜잭션 타임아웃 제어
    #### <a id="transaction-timeout-session-variable"/>Transaction Timeout Session Variable</a>
    A new `transaction_timeout` session variable has been added ([PR #18560](https://github.com/vitessio/vitess/pull/18560)), allowing per-session control over transaction timeout duration.
    **Usage**:
    ```sql
    -- Set transaction timeout to 30 seconds for this session
    SET transaction_timeout = 30;
    -- Begin a transaction that will automatically rollback if not committed within 30s
    BEGIN;
    -- ... perform operations ...
    COMMIT;
    ```
    This provides more granular timeout control compared to global server settings, useful for:
    - Long-running batch operations that need extended timeouts
    - Interactive sessions that should fail fast
    - Different timeout requirements per application workload
     * Add `transaction_timeout` session variable [#18560](https://github.com/vitessio/vitess/pull/18560) 
    github.com/vitessio/vitess/releases/tag/v23.0.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.
    - File-based configuration for throttling rules
    - Dynamic rule reloading
    - `--query-throttler-config-refresh-interval` - How often to reload throttler configuration
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 하나의 vtctldclient 워크플로에서 여러 lookup vindex 사용

    사용 조건 lookup vindex 매개변수가 담긴 JSON 파일을 지정하는 --params-file 사용; --type, --table-owner, --table-owner-columns와 동시 지정 불가

    #### <a id="multiple-lookup-vindexes-support"/>Multiple Lookup Vindexes Support</a>
    Creating multiple lookup vindexes in a single workflow is now supported through the `--params-file` flag ([PR #17566](https://github.com/vitessio/vitess/pull/17566)).
    **Usage**:
    ```bash
    # Create multiple lookup vindexes from JSON configuration
    vtctldclient LookupVindexCreate \
      --workflow my_lookup_workflow \
      --params-file /path/to/params.json \
      commerce
    **params.json example**:
    ```json
    {
      "vindexes": [
        {
          "name": "user_email_lookup",
          "type": "consistent_lookup_unique",
          "table_owner": "users",
          "table_owner_columns": ["email"]
        },
        {
          "name": "user_name_lookup",
          "type": "consistent_lookup",
          "table_owner": "users",
          "table_owner_columns": ["name"]
        }
      ]
    }
    ```
    This significantly improves workflow efficiency when setting up multiple vindexes, reducing the number of separate operations required.
    ```
    | `--params-file` | vtctldclient | JSON file containing lookup vindex parameters for creating multiple lookup vindexes in a single workflow. Mutually exclusive with `--type`, `--table-owner`, and `--table-owner-columns`. | [#17566](https://github.com/vitessio/vitess/pull/17566) |
     * LookupVindex: Multiple lookup tables support for `LookupVindexCreate` [#17566](https://github.com/vitessio/vitess/pull/17566)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • 기존 materialize 워크플로에 참조 테이블 추가

    사용 조건 Materialize ... update에서 --add-reference-tables와 대상 keyspace 지정

    #### <a id="reference-tables-in-materialize-workflows"/>Reference Tables in Materialize Workflows</a>
    Reference tables can now be added to existing materialize workflows using the new `Materialize ... update` sub-command ([PR #17804](https://github.com/vitessio/vitess/pull/17804)).
    **Usage**:
    ```bash
    # Add reference tables to an existing workflow
    vtctldclient Materialize --workflow my_workflow update \
      --add-reference-tables ref_table1,ref_table2 \
      --target-keyspace my_keyspace
    **Use Case**: Incrementally add reference tables to running materialize workflows without recreating the entire workflow, improving operational flexibility.
    ```
    | `--add-reference-tables` | vtctldclient | Comma-separated list of reference tables to add to an existing materialize workflow using the `update` sub-command. | [#17804](https://github.com/vitessio/vitess/pull/17804) |
     * VReplication: Add reference-tables to existing materialize workflow [#17804](https://github.com/vitessio/vitess/pull/17804)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • Vitess의 재귀 CTE 지원
    Vitess now supports `WITH RECURSIVE` common table expressions ([PR #18590](https://github.com/vitessio/vitess/pull/18590)), enabling recursive queries for hierarchical data.
    **Example**:
    ```sql
    -- Find all employees in a management hierarchy
    WITH RECURSIVE employee_hierarchy AS (
        SELECT id, name, manager_id, 1 as level
        FROM employees
        WHERE manager_id IS NULL
        UNION ALL
        SELECT e.id, e.name, e.manager_id, eh.level + 1
        FROM employees e
        INNER JOIN employee_hierarchy eh ON e.manager_id = eh.id
    )
    SELECT * FROM employee_hierarchy ORDER BY level, name;
    ```
    This is a major SQL compatibility enhancement for applications with hierarchical or graph-like data structures.
    | `WITH RECURSIVE` | Recursive common table expressions for hierarchical queries | [#18590](https://github.com/vitessio/vitess/pull/18590) |
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • Vitess의 CREATE TABLE ... SELECT SQL 파서 지원
    #### <a id="create-table-select-support"/>CREATE TABLE ... SELECT Support</a>
    The SQL parser now supports `CREATE TABLE ... SELECT` statements ([PR #18443](https://github.com/vitessio/vitess/pull/18443)), improving MySQL compatibility.
    **Example**:
    ```sql
    -- Create a table from a query result
    CREATE TABLE recent_orders
    SELECT * FROM orders
    WHERE order_date > DATE_SUB(NOW(), INTERVAL 30 DAY);
    ---
    ```
    | `CREATE TABLE ... SELECT` | Full support for creating tables from SELECT query results | [#18443](https://github.com/vitessio/vitess/pull/18443) |
     * Parser: Support CREATE TABLE ... SELECT Statement (#17983) [#18443](https://github.com/vitessio/vitess/pull/18443)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • VTGate 샤드 및 유형별 트랜잭션 카운터 추가
    | `TransactionsProcessed`          | `Shard`, `Type` | Counts transactions processed at VTGate by shard distribution and transaction type. | [#18171](https://github.com/vitessio/vitess/pull/18171) |
    **Transaction Types in `TransactionsProcessed`**:
    - `Single` - Single-shard transactions
    - `Multi` - Multi-shard transactions
    - `TwoPC` - Two-phase commit transactions
    **Use Case**: The `TransactionsProcessed` metric helps identify transaction patterns and shard distribution, useful for:
    - Monitoring transaction types across your deployment
    - Identifying queries that could be optimized to single-shard
    - Tracking two-phase commit usage and potential bottlenecks
     * Add TransactionsProcessed metric to track transactions at VTGate [#18171](https://github.com/vitessio/vitess/pull/18171)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • VTGate에 지연 최적화 쿼리 카운터 추가
    | `OptimizedQueryExecutions`       | N/A             | Counter tracking queries that used deferred optimization execution path.            | [#18067](https://github.com/vitessio/vitess/pull/18067) |
     * Add Deferred Optimization Execution Metric [#18067](https://github.com/vitessio/vitess/pull/18067)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • Online DDL에 오래된 마이그레이션 경과 시간 게이지 추가
    | `OnlineDDLStaleMigrationMinutes` | N/A                                | Minutes since the oldest pending/ready migration was submitted.                      | [#18417](https://github.com/vitessio/vitess/pull/18417) |
    **Use Case for `OnlineDDLStaleMigrationMinutes`**: Alert on stalled Online DDL migrations that haven't progressed for an extended period, helping identify migrations that may need intervention.
     * Online DDL metrics: `OnlineDDLStaleMigrationMinutes` [#18417](https://github.com/vitessio/vitess/pull/18417)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • VTOrc의 EmergencyReparentShardDisabled 게이지 추가
    | `EmergencyReparentShardDisabled`      | `Keyspace`, `Shard`                           | Gauge indicating if ERS is disabled per keyspace/shard. | [#17985](https://github.com/vitessio/vitess/pull/17985) |
    **Use Case for `EmergencyReparentShardDisabled`**: Create alerts to ensure EmergencyReparentShard-based recoveries are not disabled for an undesired period, maintaining high availability posture.
    To provide observability of keyspaces/shards with EmergencyReparentShard-based VTOrc recoveries disabled, the `EmergencyReparentShardDisabled` metric was added. This metric label can be used to create alerting to ensure EmergencyReparentShard-based recoveries are not disabled for an undesired period of time.
     * `vtorc`: add support for dynamic enable/disable of ERS by keyspace/shard [#17985](https://github.com/vitessio/vitess/pull/17985)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • vtgate, vttablet, vtcombo의 조건별 쿼리 로깅

    사용 조건 --querylog-emit-on-any-condition-met 활성화(기본값은 false)

    | `--querylog-emit-on-any-condition-met` | vtgate, vttablet, vtcombo | Changes query log emission to emit when ANY logging condition is met (row-threshold, time-threshold, filter-tag, or error) rather than requiring ALL conditions. Default: false. | [#18546](https://github.com/vitessio/vitess/pull/18546) |
     * Add support for querylog-emit-on-any-condition-met flag [#18546](https://github.com/vitessio/vitess/pull/18546)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • VTOrc 시작 시 복구 제어

    사용 조건 --allow-recovery=false

    | `--allow-recovery` | vtorc | Boolean flag to disable all VTOrc recovery operations from startup. When false, VTOrc runs in monitoring-only mode. Default: true. | [#18005](https://github.com/vitessio/vitess/pull/18005) |
    **Use Case**: The `--allow-recovery=false` flag is useful for:
    - Testing VTOrc capacity/discovery performance ahead of a rollout, for example: migrating to VTOrc from another solution.
    - Maintenance windows where automatic failovers should be prevented
    - Debugging VTOrc behavior without triggering recoveries
    - Running VTOrc in observation-only mode
     * `vtorc`: allow recoveries to be disabled from startup [#18005](https://github.com/vitessio/vitess/pull/18005)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • GenerateShardRanges 샤드 라벨의 16진수 너비 설정

    사용 조건 --chars 플래그

    | `--chars` | vtctldclient | Specifies the hex width (number of hex characters) to use when generating shard ranges with `GenerateShardRanges` command. Allows fine-grained control over shard naming. | [#18633](https://github.com/vitessio/vitess/pull/18633) |
    **Example**:
    ```bash
    # Generate shard ranges with 4 hex characters
    vtctldclient GenerateShardRanges --shards 16 --chars 4
    # Output: -1000,1000-2000,2000-3000,...,f000-
    The corresponding vtctldclient command gained a new `--chars` flag to control this behavior.
     * feat: Allow specifying the hex width to use when generating shard ranges. [#18633](https://github.com/vitessio/vitess/pull/18633) 
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • ALTER VITESS_MIGRATION ... POSTPONE COMPLETE 명령 지원
    | `ALTER VITESS_MIGRATION ... POSTPONE COMPLETE` | Syntax for postponing Online DDL migration completion | [#18118](https://github.com/vitessio/vitess/pull/18118) |
     * Online DDL: support `alter vitess_migration ... postpone complete` syntax [#18118](https://github.com/vitessio/vitess/pull/18118)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • INSERT 및 REPLACE의 단수형 VALUE 파서 지원
    | `VALUE` keyword in INSERT/REPLACE | Support for `VALUE` (singular) in addition to `VALUES` | [#18116](https://github.com/vitessio/vitess/pull/18116) |
     * Fix parsing to allow `VALUE` in insert and replace statements [#18116](https://github.com/vitessio/vitess/pull/18116)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • VTOrc 긴급 reparenting의 keyspace·shard별 제어

    사용 조건 --keyspace와 선택적 --shard, 그리고 --enabled=true 또는 --enabled=false를 사용하는 vtctldclient SetVtorcEmergencyReparent 명령

    #### <a id="vtorc-dynamic-ers-disabled"/>Dynamic control of `EmergencyReparentShard`-based recoveries</a>
    **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.**
    The new `vtctldclient` RPC `SetVtorcEmergencyReparent` was introduced ([PR #17985](https://github.com/vitessio/vitess/pull/17985)) to allow VTOrc recoveries involving `EmergencyReparentShard` actions to be disabled on a per-keyspace and/or per-shard basis. Previous to this version, disabling EmergencyReparentShard-based recoveries was only possible globally/per-VTOrc-instance. VTOrc will now consider this keyspace/shard-level setting that is refreshed from the topo on each recovery. The disabled state is determined by first checking if the keyspace, and then the shard state. Removing a keyspace-level override does not remove per-shard overrides.
    **Example**:
    ```bash
    # Disable ERS recoveries for a keyspace
    vtctldclient SetVtorcEmergencyReparent --keyspace commerce --enabled=false
    # Disable ERS recoveries for a specific shard
    vtctldclient SetVtorcEmergencyReparent --keyspace commerce --shard 80- --enabled=false
    # Re-enable ERS recoveries
    vtctldclient SetVtorcEmergencyReparent --keyspace commerce --enabled=true
    ```
     * `vtorc`: add support for dynamic enable/disable of ERS by keyspace/shard [#17985](https://github.com/vitessio/vitess/pull/17985)
    github.com/vitessio/vitess/releases/tag/v23.0.0
  • IN 필터의 튜플 바인드 변수 지원
     * [release-23.0] Fix handling of tuple bind variables in filtering operations. (#18736) [#18747](https://github.com/vitessio/vitess/pull/18747) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • Resharding journal의 val 컬럼을 longblob으로 확장
     * VReplication: Fix some switch writes related issues and logging [#18608](https://github.com/vitessio/vitess/pull/18608)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 비관리 태블릿에서 빈 비밀번호 자격 증명 허용
     * Allow empty passwords for unmanaged tablet configuration [#18448](https://github.com/vitessio/vitess/pull/18448)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • xtrabackup 백업 엔진의 태블릿 드레이닝 설정

    사용 조건 --xtrabackup-should-drain을 true로 설정

     * make xtrabackup ShouldDrainForBackup configurable [#18431](https://github.com/vitessio/vitess/pull/18431) 
    | `--xtrabackup-should-drain` | vttablet | Makes the ShouldDrainForBackup behavior configurable for xtrabackup engine. When true, tablet drains traffic before backup. Default: true. | [#18431](https://github.com/vitessio/vitess/pull/18431) |
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 파싱한 MySQL 연결 속성의 서버 사용을 위한 보존
     * support mysql protocol connection attributes [#18548](https://github.com/vitessio/vitess/pull/18548)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 핸드셰이크 중 연결 속성을 전송하는 MySQL 클라이언트 지원

    사용 조건 ConnectionAttributes 맵과 함께 ConnectWithAttributes 사용

     * support mysql protocol connection attributes [#18548](https://github.com/vitessio/vitess/pull/18548)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 디스커버리용 커스텀 로거 지원

    사용 조건 WithLogger 옵션

     * go/vt/discovery: configurable logger [#17846](https://github.com/vitessio/vitess/pull/17846)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • VTTablet의 primary-serving 경로에서 binlog watcher 종료 로그
     * Add logging to binlog watcher actions [#18264](https://github.com/vitessio/vitess/pull/18264)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • gRPC 서버의 ORCA 백엔드 메트릭 보고

    사용 조건 --grpc-enable-orca-metrics 활성화(기본값: false)

     * Add support for sending grpc server backend metrics via ORCA [#18282](https://github.com/vitessio/vitess/pull/18282)
    | `--grpc-enable-orca-metrics` | vtgate, vttablet | Enable ORCA (Open Request Cost Aggregation) backend metrics reporting via gRPC for load balancing decisions. Default: false. | [#18282](https://github.com/vitessio/vitess/pull/18282) |
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 쿼리 로깅에 실행 시간 임계값 추가

    사용 조건 --querylog-time-threshold에 time.ParseDuration 형식의 duration 설정; 스트리밍 쿼리에는 유용하지 않음

     * Add support for querylog-time-threshold duration flag for query logging [#18520](https://github.com/vitessio/vitess/pull/18520)
    | `--querylog-time-threshold` | vtgate, vttablet | Duration threshold for query logging. Queries exceeding this duration will be logged. Works with `--querylog-emit-on-any-condition-met`. | [#18520](https://github.com/vitessio/vitess/pull/18520) |
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • Online DDL 준비 상태 변경 로그
     * OnlineDDL: log changes to `ready_to_complete` [#18557](https://github.com/vitessio/vitess/pull/18557) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 예제 Vitess Operator CRD 스키마에 fetchCredentials 추가
     * Add fetchCredentials to operator.yaml [#18460](https://github.com/vitessio/vitess/pull/18460) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 쿼리 플래너의 최적화 실패 사유 디버그 로그

    사용 조건 DebugOperatorTree = true

     * Planner: Add comprehensive debug logging for query planner NoRewrite cases [#18476](https://github.com/vitessio/vitess/pull/18476)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • SET NAMES binary SQL 파서 지원
     * Fix sqlparser cannot parse 'set names binary' [#18582](https://github.com/vitessio/vitess/pull/18582) 
    | `SET NAMES binary` | Support for binary character set specification | [#18582](https://github.com/vitessio/vitess/pull/18582) |
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 태블릿 수신 쿼리 쓰로틀링

    사용 조건 /config/throttler-config.json의 Throttler 활성화 플래그

     * [QueryThrottler] Implement Query Throttler [#18449](https://github.com/vitessio/vitess/pull/18449)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • Query Throttler 드라이런 모드
     * [Query Throttler] Add dry-run mode [#18657](https://github.com/vitessio/vitess/pull/18657) 
    - Dry-run mode for testing throttling without enforcement
    **Dry-run Mode**: Test throttling rules without actually blocking queries, useful for validating configuration before enforcement.
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 새 TMC RPC를 통한 switchwrites 시퀀스 일괄 처리
     * Add TMC RPCs for updating sequences for `switchwrites` [#18172](https://github.com/vitessio/vitess/pull/18172)
    - **Added** `GetMaxValueForSequences` and `UpdateSequenceTables` gRPC RPCs ([PR #18172](https://github.com/vitessio/vitess/pull/18172)) for VReplication sequence management during `SwitchWrites` operations.
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 키스페이스를 제외한 VStream 테이블 이름

    사용 조건 ExcludeKeyspaceFromTableName VStream 플래그 설정

     * Add a flag to vstream to exclude keyspace from table name [#18274](https://github.com/vitessio/vitess/pull/18274)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 호환 가능한 DDL 변경에서 스키마를 사용하는 VStreamer
     * [release-23.0] VReplication: Handle compatible DDL changes (#18739) [#18749](https://github.com/vitessio/vitess/pull/18749) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • vtgateconn gRPC 인터페이스의 세션 종료 메서드 제공
    #### VTGate
     * vtgateconn minor enhancements [#18551](https://github.com/vitessio/vitess/pull/18551) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • vtgate 연결의 gRPC fail-fast 설정

    사용 조건 gRPC fail-fast 활성화 조건: vtgate-grpc-fail-fast를 true로 설정, 기본값 false

    #### VTGate
     * vtgateconn minor enhancements [#18551](https://github.com/vitessio/vitess/pull/18551) 
    | `--vtgate-grpc-fail-fast` | vtgate | Enable gRPC fail-fast mode for faster error responses when backends are unavailable. Default: false. | [#18551](https://github.com/vitessio/vitess/pull/18551) |
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • vtgateconn gRPC 플래그 등록 함수 외부 공개
    #### VTGate
     * vtgateconn minor enhancements [#18551](https://github.com/vitessio/vitess/pull/18551) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • 한 번의 호출로 MySQL 복제 재시작

    사용 조건 추가된 RestartReplication 메서드를 호출하는 클라이언트

     * `RestartReplication` RPC [#18628](https://github.com/vitessio/vitess/pull/18628)
    - **Added** `RestartReplication` method to `TabletManagerClient` interface ([PR #18628](https://github.com/vitessio/vitess/pull/18628)). This new RPC allows stopping and restarting MySQL replication with semi-sync configuration in a single call, providing a convenient alternative to separate `StopReplication` and `StartReplication` calls.
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • SchemaDiff에 외래 키 영향 목록 추가
     * `schemadiff`: `RelatedForeignKeyTables()` [#18195](https://github.com/vitessio/vitess/pull/18195) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • Online DDL 마이그레이션의 샤드별 완료
    #### Online DDL
     * Feature(onlineddl): Add shard-specific completion to online ddl [#18331](https://github.com/vitessio/vitess/pull/18331) 
    #### <a id="online-ddl-shard-specific-completion"/>Online DDL Shard-Specific Completion</a>
    Online DDL migrations can now be completed on a per-shard basis using the new `COMPLETE VITESS_SHARDS` syntax ([PR #18331](https://github.com/vitessio/vitess/pull/18331)).
    **Usage**:
    ```sql
    -- Complete migration on specific shards only
    ALTER VITESS_MIGRATION '9e8a9249_3976_11ed_9442_0a43f95f28a3'
      COMPLETE VITESS_SHARDS '-80,80-';
    
    -- Complete migration on all remaining shards
    ALTER VITESS_MIGRATION '9e8a9249_3976_11ed_9442_0a43f95f28a3'
      COMPLETE;
    **Benefits**:
    - Gradual rollout of schema changes across shards
    - Ability to validate changes on subset of shards before full rollout
    - Better control over migration timing and impact
    ```
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • VStream 선택적 테이블 복사

    사용 조건 VStreamOptions 또는 VStreamFlag에서 TablesToCopy 설정

     * VStream: Add flag to support copying only specific tables [#18184](https://github.com/vitessio/vitess/pull/18184)
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • vstreamer의 PREVIOUS_GTIDS VEvent 출력
     * GTID and other `go/mysql` and `vstreamer` optimizations [#18196](https://github.com/vitessio/vitess/pull/18196) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • vstreamer 이벤트에 GTID 메타데이터 추가
     * GTID and other `go/mysql` and `vstreamer` optimizations [#18196](https://github.com/vitessio/vitess/pull/18196) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • operator.yaml의 mysqldExporter.extraFlags 스키마 지원

    사용 조건 operator.yaml의 mysqldExporter.extraFlags를 추가 속성의 값이 문자열인 객체로 정의

     * Update `operator.yaml` [#18364](https://github.com/vitessio/vitess/pull/18364) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md
  • mysqldExporter에 resources 설정 불필요
     * Update `operator.yaml` [#18364](https://github.com/vitessio/vitess/pull/18364) 
    github.com/vitessio/vitess/blob/main/changelog/23.0/23.0.0/changelog.md

의존성 갱신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

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