# Vitess v22.0.2

2025-11-05 · [元のリリースノート](https://github.com/vitessio/vitess/releases/tag/v22.0.2) · [全体のまとめ](https://ratatosk.io/ja/releases/vitess/v22.0.2)

セキュリティ 4 · 破壊的変更 5 · 重大な修正 17 · 機能・改善 3 · 依存関係の更新 6 · その他の変更 26

## セキュリティ (4)

### `GetPermissions` によるパスワードチェックサムのゼロ化

- 影響対象: `vtctldclient GetPermissions` を使用する構成 (推定)

従来、`GetPermissions` は権限レスポンスをマーシャリングする前に `PasswordChecksum` をゼロ化していませんでした。

>  * [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 はサービス提供不可としてマークされませんでした。現在は、ハートビート間隔の 2 倍を超えてハートビートを受信しない場合、`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` がビュー定義を返さない

- 影響対象: `EnableViews` が無効な VTTablet/Schema Tracker 構成 (推定)

以前は、`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` の名前のみフィールドの復元

- 影響対象: 名前のみモードで `SimpleProjection` を使用する VTGate クエリ（プリペアドクエリのフィールド取得を含む） (推定)

名前のみモードでは、シンプルな投影でフィールドが表示されないことがありました。現在は入力フィールドを返し、空でない投影列名を適用します。プリペアドクエリのフィールド取得では、期待どおりのフィールド名と型が返されます。

>  * [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

### Replication tracker による `replicationLagSeconds` のリセット

- 影響対象: プライマリタブレット上の VTTablet レプリケーショントラッカー、またはレプリケーショントラッキング無効時の VTTablet レプリケーショントラッカー

タブレットがプライマリになると、また `Status` がプライマリモードまたは無効モードで実行されると、メトリクスはゼロにリセットされます。

>  * [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 行のサブクエリに対する count が 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

### 接続プールのクローズ時に待機を解除

- 影響対象: smart connection pool を使用する構成 (推定)

以前は、接続を待っている間にプールがクローズすると、待機中の goroutine が停止したままになることがありました。現在は待機が `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 ストリーム (推定)

最初のハートビートを送信した後、送信側は以降のハートビートタイカーイベントに応答しなくなっていました。修正後は、ストリームのコンテキストがキャンセルされるまで、タイカーイベントごとにハートビート応答を送信し続けます。

>  * [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 のシーケンス用バッキングテーブル (推定)

トラフィック切り替え後もキャッシュされたシーケンス値が残り、値の重複や重複キーエラーが発生することがありました。シーケンス値の更新が成功すると、次の挿入 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` におけるキースペース名とテーブル名のエスケープ

## 依存関係の更新 (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 のマルチクエリプロトコルフラグ設定における回帰修正
- Release 22.0 ブランチの開発モードへの復帰
- v22.0.2 向けの `release-22.0` ブランチ凍結
- Consul トポロジーテストの不安定さを修正
- `TestStreamRowsHeartbeat` におけるハートビートカウントのアトミック処理
- VDiff2 のエンドツーエンドテストにおける VDiff の開始または完了待ち
- スマート接続プールのテストタイムアウト延長

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
