# Vitess v22.0.2

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

보안 4 · 호환성 변경 5 · 중요 수정 17 · 기능·개선 3 · 의존성 갱신 6 · 기타 26

## 보안 (4)

### `GetPermissions`에서 비밀번호 체크섬을 0으로 설정

- 영향 대상: `vtctldclient GetPermissions`를 사용하는 설정 (추정)

이전에는 권한 응답을 마샬링하기 전에 `PasswordChecksum`을 0으로 설정하지 않았습니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### `vtctldclient GetPermissions`의 `authentication_string` 가림 처리

- 영향 대상: `vtctldclient GetPermissions`를 사용하는 설정

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 파일 백업 경로 순회 차단

- 영향 대상: 파일 백업 스토리지

이전에는 `ListBackups()`가 전달된 `dir`을 사용하면서 스토리지 루트 바깥으로 경로가 순회되는 것을 막지 않았으며, vtctld 서버의 `GetBackups` RPC를 통한 경우도 마찬가지였습니다. 이제 루트 바깥으로 해석되는 경로로 백업을 나열하거나 읽거나 시작하거나 제거하면 오류가 반환됩니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### Vitess Java 드라이버 의존성 취약점 수정

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

드라이버는 이전에 취약한 `commons-lang` 2.6을 사용했지만, 이제 `org.apache.commons:commons-lang3` 3.19.0을 사용합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

## 호환성 변경 (5)

### 하트비트 리더의 오래된 하트비트 오류 보고

- 영향 대상: 복제 추적에 하트비트 리더를 사용하는 VTTablet 인스턴스 (추정)

MySQL이 멈춰 하트비트 업데이트가 중단됐을 때도 vttablet는 서비스 불가 상태로 표시되지 않았습니다. 이제 하트비트가 하트비트 간격의 두 배가 넘도록 도착하지 않으면 `Status`가 오류를 반환합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### `EnableViews` 비활성화 시 `GetSchema`에서 뷰 정의 제외

- 영향 대상: VTTablet/Schema Tracker에서 `EnableViews`를 비활성화한 구성 (추정)

이전에는 `EnableViews`를 비활성화해도 `GetSchema`가 뷰 정의를 반환할 수 있었습니다. 이제 뷰를 요청하면 정의를 반환하지 않으며, 모든 스키마 정의를 요청하면 테이블 정의만 반환합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### BuiltinBackupEngine의 파일 닫기 재시도와 실패 횟수 제한

- 영향 대상: 백업 또는 복원에 BuiltinBackupEngine을 사용하는 설정 (추정)

이전에는 백업 및 복원 코드가 `Close`를 직접 호출했고, 백업 파일 작업이 실패하면 기존 파일별 처리 로직에 따라 재시도할 수 있었습니다. 이제 닫기 실패 시 백오프를 적용해 최대 20회 재시도합니다. 실패가 계속되면 작업은 `FAILED_PRECONDITION`을 반환하고, 호출자는 해당 파일 작업을 재시도하지 않습니다.

>  * [release-22.0] BuiltinBackupEngine: Retry file close and fail backup when we cannot (#18848) [#18861](https://github.com/vitessio/vitess/pull/18861) 

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### VReplication에서 `ER_BINLOG_CREATE_ROUTINE_NEED_SUPER` 복구 불가 처리

- 영향 대상: 바이너리 로깅이 활성화된 VReplication 워크플로

바이너리 로깅이 활성화된 상태에서 `SUPER` 권한이 없어 실패하는 `CREATE TRIGGER` 작업도 여기에 포함됩니다.

근거: “err: sqlerror.NewSQLError(sqlerror.ERBinlogCreateRoutineNeedSuper, "unknown", "error applying event: You do not have the SUPER privilege and binary logging is enabled (you *might* want to use the less safe log_bin_trust_function_creators variable) (errno 1419) (sqlstate HY000) during query: CREATE DEFINER=`root`@`localhost` TRIGGER upd_customer BEFORE UPDATE ON customer FOR EACH ROW SET @email = NEW.email + \" (updated)\""),” https://github.com/vitessio/vitess/pull/18819

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### VDiff 쿼리 속도 개선을 위한 사이드카 스키마 업데이트

- 영향 대상: 내부 사이드카 데이터베이스를 사용하는 VDiff

내부 사이드카 데이터베이스를 대상으로 하는 일부 VDiff 쿼리의 성능이 좋지 않았으며, VDiff 실행으로 프라이머리 VTTablet이 충돌할 수 있었습니다.

근거: “This pull request intends to improve the performance of some of the queries executed by VDiff against the internal sidecar database.” https://github.com/vitessio/vitess/pull/18579

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

## 중요 수정 (17)

### 빈 결과의 스칼라 집계 수정

- 영향 대상: 리터럴 또는 파라미터 표현식을 사용하는 VTGate 스칼라 집계 (추정)

입력 결과 집합이 비어 있으면 집계 과정에서 리터럴 및 파라미터 표현식을 이제 evalengine을 통해 평가합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### `SimpleProjection`의 names-only 필드 복원

- 영향 대상: names-only 모드에서 `SimpleProjection`을 사용하는 VTGate 쿼리 및 준비된 쿼리의 필드 조회 (추정)

names-only 모드에서 단순 프로젝션은 필드를 하나도 표시하지 않을 수 있었습니다. 이제 입력 필드를 반환하고, 비어 있지 않은 프로젝션 열 이름을 적용합니다. 준비된 쿼리의 필드 조회에서도 예상한 필드 이름과 타입을 반환합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 테이블 라우팅에 따르는 VSchema 외래 키 메타데이터

- 영향 대상: 다른 키스페이스나 테이블로 라우팅되는 외래 키가 있는 테이블

테이블 라우팅으로 테이블이 다른 곳으로 전달되면, VSchema를 구성할 때 소스 키스페이스의 해당 테이블에 외래 키 관계를 추가하지 않습니다. 대상 키스페이스에는 스키마에 정의된 관계가 그대로 유지됩니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 리플리케이션 트래커의 `replicationLagSeconds` 초기화

- 영향 대상: 프라이머리 태블릿 또는 리플리케이션 트래킹이 비활성화된 VTTablet 리플리케이션 트래커

태블릿이 프라이머리가 되거나 `Status`가 프라이머리 모드 또는 비활성화 모드에서 실행되면 메트릭이 0으로 초기화됩니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### [드러나지 않던 결함] 대기자 한도 초과 후 VTTablet의 개별 쿼리 실행

- 영향 대상: VTTablet 쿼리 통합 (추정)

이 수정 전에는 영향을 받은 쿼리가 오류 없이 빈 결과를 반환할 수 있었습니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### `GenerateShardRanges`의 전체 키 범위 커버리지 수정

- 영향 대상: `GenerateShardRanges`를 사용하는 설정 (추정)

이 수정 전에는 전체 범위를 모두 포함하지 않는 샤드 이름을 반환할 수 있었습니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### [드러나지 않던 결함] VTGate 서브쿼리 LIMIT 처리 수정

- 영향 대상: 양수 `sqlSelectLimit`이 적용된 VTGate 쿼리 (추정)

세션 변수나 JDBC의 `.setMaxRows`로 SQL SELECT LIMIT을 설정하면 그 제한이 서브쿼리에도 적용되어 잘못된 결과가 나왔습니다. 예를 들어 `sql_select_limit = 1`일 때 3행을 반환하는 서브쿼리의 행 수를 세면 3이 아니라 1이 반환됐습니다.

>  * [release-22.0] fix sqlSelectLimit propagating to subqueries (#18716) [#18872](https://github.com/vitessio/vitess/pull/18872)

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 실행 불가능 쿼리의 `UNION` 문 포맷 수정

- 영향 대상: `UNION`을 포함하는 실행 불가능 쿼리와 CTE 포함 쿼리 (추정)

생성되는 SQL은 이제 CTE가 포함된 쿼리를 비롯해 모든 `SELECT` 분기에 `where 1 != 1`을 추가합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 컷오버 실패 후 Online DDL VReplication 재시작

- 영향 대상: VReplication을 사용하는 Online DDL 마이그레이션

컷오버 중 이름 변경에 실패하면 실행기가 마이그레이션의 VReplication 워크플로를 재시작하려고 시도합니다. 재시작에도 실패하면 해당 실패를 로그에 기록합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 불필요한 `srvtopo` 워처 알림 수정

- 영향 대상: `srvtopo` 워처를 사용하는 구성 (추정)

토폴로지 장애 중에는 캐시된 데이터를 사용할 수 있어도 업데이트가 리스너에 반복해서 알림을 보낼 수 있었습니다. 이제 캐시된 데이터가 있는 상태에서 오류가 발생하면 리스너에 알림을 보내지 않습니다. 업데이트가 성공하거나 캐시된 데이터 없이 오류가 발생하면 계속 알림을 보냅니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 파생 테이블에서 `GROUP BY`만 사용하는 집계의 VTGate 실행 계획 컬럼 수 수정

- 영향 대상: 파생 테이블에서 `GROUP BY`만 사용하는 집계가 포함된 VTGate 쿼리

이번 릴리스 전에는 이러한 쿼리에서 컬럼 수가 잘못 나올 수 있었습니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 풀이 닫힐 때 커넥션 대기 해제

- 영향 대상: 스마트 커넥션 풀을 사용하는 설정 (추정)

이전에는 커넥션을 기다리는 고루틴이 대기 중에 풀이 닫히면 멈춘 채로 끝나지 않을 수 있었습니다. 이제 대기가 `ErrConnPoolClosed`를 반환합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

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

- 영향 대상: VDiff 추가 행 조정 (추정)

`ExtraRowsSource` 또는 `ExtraRowsTarget`가 각각 대응하는 extra-diff 슬라이스보다 커지면 VDiff에서 패닉이 발생할 수 있었습니다. 이제 조정 과정에서 사용 가능한 row-diff 슬라이스를 기준으로 매칭 작업의 크기를 정합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 복사 후 일반 재시도 처리를 적용하는 `AtomicCopy` 워크플로

- 영향 대상: 하위 유형이 `AtomicCopy`인 VReplication 워크플로

이전에는 `AtomicCopy`로 시작한 워크플로에서 어떤 오류가 발생하든 `Copying` 단계를 벗어난 뒤에도 워크플로가 종료될 수 있었습니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### MoveTables 시퀀스 초기화에서 이름 이스케이프 처리

- 영향 대상: 이름을 이스케이프해야 하는 상황에서 `MoveTables --initialize-target-sequences`를 실행하는 경우

트래픽 전환 중 생성된 쿼리에서 대시가 포함된 이름을 사용하면 시퀀스 초기화가 SQL 구문 오류로 실패할 수 있었습니다. 이제 이 경로에서 생성 쿼리가 데이터베이스 이름과 시퀀스 이름을 이스케이프합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### Row Streamer의 반복 하트비트 전송 수정

- 영향 대상: `VStreamRowsResponse` 하트비트를 보내는 VTTablet Row Streamer 스트림 (추정)

첫 하트비트를 보낸 뒤 송신 측은 이후 하트비트 ticker 이벤트에 응답하지 않았습니다. 이제 스트림 컨텍스트가 취소될 때까지 ticker 이벤트가 발생할 때마다 하트비트 응답을 계속 전송합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

### 업데이트 성공 후 VTTablet 시퀀스 카운터 초기화

- 영향 대상: VTTablet 시퀀스 백킹 테이블 (추정)

트래픽 전환 후 캐시된 시퀀스 값이 남아 중복 값과 중복 키 오류가 발생할 수 있었습니다. 시퀀스 값 업데이트가 성공하면 다음 INSERT ID는 오래된 메모리 내 카운터 대신 시퀀스 테이블에서 가져옵니다.

>  * [release-22.0] Reset in-memory sequence info on vttablet on UpdateSequenceTables request (#18415) [#18445](https://github.com/vitessio/vitess/pull/18445)

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

## 기능·개선 (3)

- VTGate `IN` 필터의 오른쪽 항에 튜플 바인드 변수 지원
- `zk2`의 재귀적 잠금 경로 생성으로 명명된 잠금 지원
- `LookupVindex create`의 keyspace 및 table 이름 이스케이프 처리

## 의존성 갱신 (6)

### VTAdmin의 Vite 및 관련 프런트엔드 도구 업그레이드

- [CVE-2024-52011](https://www.cve.org/CVERecord?id=CVE-2024-52011), [CVE-2025-58751](https://www.cve.org/CVERecord?id=CVE-2025-58751), [CVE-2025-58752](https://www.cve.org/CVERecord?id=CVE-2025-58752), [CVE-2025-62522](https://www.cve.org/CVERecord?id=CVE-2025-62522), [GHSA-93m4-6634-74q7](https://github.com/advisories/GHSA-93m4-6634-74q7), [GHSA-c27g-q93r-2cwf](https://github.com/advisories/GHSA-c27g-q93r-2cwf), [GHSA-g4jq-h2w9-997c](https://github.com/advisories/GHSA-g4jq-h2w9-997c), [GHSA-jqfw-vq24-v9c3](https://github.com/advisories/GHSA-jqfw-vq24-v9c3)

VTAdmin은 `vite`를 `^4.5.14`에서 `^7.1.12`로, `@vitejs/plugin-react`를 `^3.1.0`에서 `^5.1.0`으로, `vite-plugin-svgr`를 `^2.4.0`에서 `^4.5.0`으로, `vitest`를 `^0.29.8`에서 `^4.0.3`으로 업그레이드합니다.

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

https://github.com/vitessio/vitess/blob/main/changelog/22.0/22.0.2/changelog.md

그 외 5건 · 보안 언급 없음

- `` * [release-22.0] Upgrade the Golang version to `go1.24.7` [#18621](https://github.com/vitessio/vitess/pull/18621) ``
- `` * [release-22.0] Upgrade the Golang version to `go1.24.9` [#18737](https://github.com/vitessio/vitess/pull/18737) ``
- `* [release-22.0] Bump vite from 4.5.9 to 4.5.14 in /web/vtadmin (#18485) [#18500](https://github.com/vitessio/vitess/pull/18500)`
- `* [release-22.0] Bump @babel/runtime from 7.26.0 to 7.27.6 in /web/vtadmin (#18467) [#18502](https://github.com/vitessio/vitess/pull/18502)`
- `* [release-22.0] Bump form-data from 4.0.1 to 4.0.4 in /web/vtadmin (#18473) [#18504](https://github.com/vitessio/vitess/pull/18504)`

## 기타 (26)

- 초안 상태 판별에 이벤트 페이로드를 사용하는 CI 워크플로
- VReplication `copy_state`의 `lastpk`를 `mediumblob`으로 변경
- VTGate 푸시다운 SQL에서 일반 데이터베이스 한정자 제거
- 외래 키 검증 SQL의 부모·자식 테이블 별칭
- `consul` 및 `zk2` 네임드 락 테스트 커버리지 추가
- VReplication 워크플로 쿼리에서 불필요한 `GROUP BY` 제거
- VTGate `VStream` 콜백이 반환 후 더 이상 실행되지 않음
- Go 업데이트 워크플로에서 이제 `peter-evans/create-pull-request@v7` 사용
- CI 워크플로의 MySQL APT 설정 패키지 업데이트
- CI OS 튜닝을 재사용 가능한 액션으로 분리
- GitHub Actions용 재사용 가능한 MySQL 설정 액션
- Java Maven 배포의 Sonatype Central 이전
- `release-22.0`의 코드 오너와 메인테이너 업데이트
- `.github/CODEOWNERS`의 코드 소유자 지정 업데이트
- 저장소 CI 워크플로 파일 간소화
- CI 워크플로 조건에서 `always()` 대신 `!cancelled()` 사용
- CI 워크플로의 자동 `man-db` 업데이트 비활성화
- CI 워크플로의 `actions/setup-go`를 v5.5.0으로 업데이트
- 코드 커버리지 CI 워크플로 트리거 변경
- VTGate 멀티 쿼리 프로토콜 플래그 설정 회귀 수정
- 22.0 릴리스 브랜치의 개발 모드 복귀
- v22.0.2용 `release-22.0` 브랜치 동결
- 불안정한 Consul 토폴로지 테스트 수정
- `TestStreamRowsHeartbeat`의 heartbeat 카운트 원자적 처리
- VDiff2 종단 간 테스트의 VDiff 시작 또는 완료 대기
- Smart connection pool 테스트 타임아웃 증가

---

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