# Vitess v23.0.0

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

セキュリティ 11 · 破壊的変更 27 · 非推奨 15 · 重大な修正 49 · 機能・改善 47 · 依存関係の更新 17 · その他の変更 110

## アップグレード前の確認事項

### 前提条件

- **`vitess-operator` の `8.0.x` から `8.4.x` への手動アップグレード手順**: YAML の extra cnf に `innodb_fast_shutdown=0` を追加して適用し、すべての Pod が正常な状態になるまで待ってから、イメージを `vitess/lite:v23.0.0` に変更します。その後、この設定を削除して再度適用します。この手順が必要なのは `8.0.x` から `8.4.x` への移行時のみで、`8.4.x` バージョン間のアップグレードやダウングレードでは不要です。
  > >  ⚠️ Upgrading to this release with vitess-operator:
  > >
  > > If you are using the `vitess-operator`, considering that we are bumping the MySQL version from `8.0.40` to `8.4.6`, you will have to manually upgrade:
  > >
  > > 1. Add `innodb_fast_shutdown=0` to your extra cnf in your YAML file.
  > > 2. Apply this file.
  > > 3. Wait for all the pods to be healthy.
  > > 4. Then change your YAML file to use the new Docker Images (`vitess/lite:v23.0.0`).
  > > 5. Remove `innodb_fast_shutdown=0` from your extra cnf in your YAML file.
  > > 6. Apply this file.
  > >
  > > This is only needed once when going from the latest `8.0.x` to `8.4.x`. Once you're on `8.4.x`, it is possible to upgrade and downgrade between `8.4.x` versions without needing to run `innodb_fast_shutdown=0`.

### 既知の問題

- **実験的スロットラーの開発継続**: 開発は継続中で、今後のリリースで互換性を損なう変更が行われる可能性があります。
  > Vitess v23.0.0 introduces a new, experimental Query Throttler framework for rate-limiting incoming queries ([RFC issue #18412](https://github.com/vitessio/vitess/issues/18412), [PR #18449](https://github.com/vitessio/vitess/pull/18449), [PR #18657](https://github.com/vitessio/vitess/pull/18657)). Work on this new throttler is ongoing with the potential for breaking changes in the future.
- **`EmergencyReparentShard` ベースの復旧を無効にすることによる可用性リスク**: この制御に頻繁に依存している場合、アンチパターンである可能性があります。
  > **Note: disabling `EmergencyReparentShard`-based recoveries introduces availability risks; please use with extreme caution! If you rely on this functionality often, for example in automation, this may be signs of an anti-pattern. If so, please open an issue to discuss supporting your use case natively in VTOrc.**

## セキュリティ (11)

### Consul の静的ファイル認証に必要な認証情報の読み込み

- 影響対象: `--consul-auth-static-file` を使用する構成
- 追加の対応: JSONファイルから少なくとも1つの認証情報を読み込めること

以前は、空のJSONファイルや不正なJSONファイル（`{}` を含む）でも、認証なしで起動を続行できる場合がありました。現在は、そのようなファイルがあると起動に失敗します。

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

### GetSchema の `EnableViews` 設定への対応

- 影響対象: `EnableViews` が無効なタブレットサーバー
- 追加の対応: `EnableViews` の無効化

従来は、設定が無効でも、クライアントは `GetSchema` を通じてビュー定義を取得できました。現在は、`SchemaTableType_VIEWS` は空の結果を返し、`SchemaTableType_ALL` はテーブル定義のみを返します。

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

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

### `vtctldclient GetPermissions` によるパスワードチェックサムの消去

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

JSON 出力では、値が設定されていないフィールドは省略されます。

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

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

### `vtctldclient GetPermissions` の応答から `authentication_string` が欠落

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

このパッチでは、v23 以降、サーバー側でこのフィールドが伏せられることも記されています。

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

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

### 外部タブレットの VReplication 権限チェックでの `mysql.user` 照会の廃止

- 影響対象: 逆レプリケーションが有効な外部タブレット
- 追加の対応: 逆レプリケーションが有効な場合、書き込みトラフィックの切り替え時に実行される権限チェック

従来、権限チェックでは `mysql.user` を照会していたため、このテーブルへのアクセスが必要であり、ワイルドカード権限、ロールベース認証、データベースのバージョンによって、チェックを安定してテストすることが困難でした。書き込みトラフィックの切り替え時には、トランザクション内でダミーの DML を実行して権限を確認するようになり、`mysql.user` へのアクセスは不要です。

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

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

### [セキュリティかどうか不明] vtctld gRPC 接続における VTAdmin の TLS 対応

- 影響対象: vtctld gRPC 接続に TLS を使用する VTAdmin 構成
- 追加の対応: vtctld gRPC TLS 用の `--vtctld-grpc-ca`、`--vtctld-grpc-cert`、`--vtctld-grpc-key`、`--vtctld-grpc-server-name`、`--vtctld-grpc-crl` の設定

以前は、vtctld への TLS 専用接続で、プロキシが安全でない gRPC 認証情報を使用していたため、VTAdmin を起動できませんでした。安全なダイヤル設定が利用可能になり、VTAdmin は TLS 経由で vtctld に接続できます。

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

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

### ファイルバックアップのパストラバーサル検査の追加

- 影響対象: ファイルバックアップストレージを使用するインストール環境 (推定)

結合されたパスが設定済みのストレージルート外を指す場合、使用せずにエラーを返すようになりました。このチェックは、ファイルバックアップの読み取り、一覧表示、開始、削除の各操作に適用されます。

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

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

### `commons-lang` の置き換えによる Java JDBC ドライバーの脆弱性修正

- 影響対象: Vitess Java JDBC ドライバーを使用する構成 (推定)

ドライバーは以前、`commons-lang` 2.6 を使用し、`org.apache.commons.lang.StringUtils` をインポートしていました。アップグレード後は `commons-lang3` 3.19.0 を使用し、`org.apache.commons.lang3.StringUtils` をインポートします。

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

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

### VTAdmin の JavaScript 依存関係の更新

- 影響対象: VTAdmin を使用する環境

VTAdmin の JavaScript 依存関係に関する Dependabot の脆弱性への対処を目的とした更新です。

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

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

### VTAdmin の依存関係更新による Dependabot アラートへの対処

- 影響対象: VTAdmin を使用するセットアップ (推定)

VTAdmin の依存関係が Dependabot アラートの対象になっていました。パッケージロックファイルには、これらのアラートの解消を目的とした更新と、ほかのパッケージの更新が含まれるようになりました。

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

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

### VTAdmin の Vite 依存関係をセキュリティ対応で更新

- 影響対象: VTAdmin を使用する環境 (推定)

以前の依存関係のバージョン範囲に対して、Dependabot のセキュリティアラートが出ていました。マニフェストとロックファイルで、`vite` は `^7.1.12`、`@vitejs/plugin-react` は `^5.1.0`、`vite-plugin-svgr` は `^4.5.0`、`vitest` は `^4.0.3` を使用するようになりました。

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

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

## 破壊的変更 (27)

### 非推奨だった4つのVTGateメトリクスの削除

- 影響対象: 削除された4つのメトリクスを使用しているVTGateの監視ダッシュボードまたはアラートシステム

これらのメトリクスはv22.0.0で非推奨となり、現在は提供されません。`QueryExecutions` が `QueriesProcessed` に、`QueryRoutes` が `QueriesRouted` に、`QueryExecutionsByTable` がテーブル別の2つのメトリクスに置き換わります。

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

### `vitess/lite:latest` のデフォルト MySQL バージョンを `8.4.6` に変更

- 影響対象: `vitess/lite:latest` イメージ
- 必要な対応: `vitess-operator` では、YAML の extra cnf に `innodb_fast_shutdown=0` を追加して適用し、すべての Pod が正常な状態になるまで待ってから、YAML を新しい Docker イメージに変更し、最後にこの設定を削除して YAML を再適用する、`8.0.x` から `8.4.x` への一回限りの手順

このタグでは従来 MySQL `8.0.40` が選択されていましたが、アップグレード後はタグを変更せずに `8.4.6` が選択されます。

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

### VTGate がデフォルトで通知する MySQL バージョンを `8.4.6` に変更

- 影響対象: VTGate のデプロイ
- 必要な対応: 希望する通知対象の MySQL バージョンが `8.4.6` 以外の場合の、`mysql_server_version` フラグによるバージョンの指定

以前、VTGate が通知していた MySQL バージョンは `8.0.40` でした。新しいデフォルト値は、実際に実行している MySQL のバージョンと異なる場合があります。

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

### VTGate `QueryExecutionsByTable` の成功クエリのみのカウント

- 影響対象: VTGate の `QueryExecutionsByTable` メトリクスを収集または利用する構成 (推定)

以前は失敗したクエリの試行も含まれていたため、成功したクエリの件数が実際より多く見える可能性がありました。失敗したクエリはエラーメトリクスで別途追跡されるようになり、失敗が多いワークロードでは値が減少する場合があります。

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

### VTTablet `--skip-user-metrics` フラグ

- 影響対象: ユーザーベースのメトリクスを出力する VTTablet 環境

異なるユーザーが多数いる環境では、ユーザーごとのユーザー名ラベルによってメトリクスのカーディナリティが爆発的に増加することがあります。`--skip-user-metrics` を有効にすると、ユーザー名ラベルは `UserLabelDisabled` に置き換えられます。

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

### Vitess Bullseye Docker イメージのビルド・公開終了

- 影響対象: `debian:bullseye` をベースとする Vitess Docker イメージ

Debian Bookworm 向けのビルドは継続し、Debian Trixie 向けのビルドも追加されます。デフォルトの Debian タグに変更はありません。

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

### Datadog トレーサーのデバッグモードの既定値をオフに変更

- 影響対象: Datadog トレーシングプラグインを使用するインストール環境 (推定)

従来、プラグインではデバッグモードが常に有効になっており、トラフィックによっては非常に大量のログが出力され、数百万件に達することもありました。`--datadog-trace-debug-mode` オプションでデバッグモードを有効にできます。

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

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

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

### 正の `--force-cut-over-after` 値が `1ms` 以下の場合の Online DDL 即時カットオーバー

- 影響対象: 正の `--force-cut-over-after` 値が `1ms` 以下の Online DDL

以前は、強制カットオーバーは `sinceReadyToComplete` が設定値を超えるまで待機していました。現在は、実測経過時間が設定値を下回っていてもカットオーバーが発生することがあります。

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

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

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

### 到達不能なプライマリに対するVTOrcの直接レプリカ再起動

- 影響対象: VTOrcが管理するレプリケーション

`UnreachablePrimary` の場合、VTOrcは任意の直接レプリカ1台でレプリケーションを停止して再開します。一部のレプリカでレプリケーションに失敗している場合は、状態を `UnreachablePrimaryWithBrokenReplicas` と判定し、すべての直接レプリカで再起動します。再起動はタブレットごとに1分あたり1回までです。

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

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

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

### 非推奨の VTGate メトリクスとエンジンプリミティブメソッドの削除

- 影響対象: 非推奨の VTGate メトリクスまたはエンジンプリミティブメソッドを使用するセットアップ (推定)

削除された VTGate メトリクスには `QueriesProcessed` が含まれます。

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

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

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

### 複数文の `ExecuteFetchAsDba` リクエストの拒否

- 影響対象: セミコロン区切りの複数の SQL 文を `ExecuteFetchAsDba` に送信するコードまたは自動化
- 必要な対応: 各文を個別の RPC 呼び出しで送信する必要があります

以前は、すべての文が `CREATE TABLE` または `CREATE VIEW` であればリクエストが受け入れられていましたが、この例外は適用されなくなりました。

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

### `vttablet` `tabletmanager` クライアントのエラーコード修正

- 影響対象: `vttablet` の gRPC `tabletmanager` クライアントを使用する構成
- 必要な対応: google-gRPC エラーコードに依存する外部自動化の更新（`vterrors.Code(err)` でコードを確認し、`vtrpcpb.Code_NOT_FOUND` などの `vtrpcpb.Code` 値を使用）

`mysqld` の停止などで `tabletmanager` RPC の実行に失敗した場合、クライアントが `Unknown` を報告することがありました。この場合、エラーメッセージは変わらず、`Unavailable` を報告するようになりました。

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

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

### GTID 解析メソッドへのコミット値とシーケンス値の追加

- 影響対象: GTID 解析 API を直接呼び出すコード
- 必要な対応: 変更されたメソッドシグネチャに対応するための、GTID 解析 API の直接呼び出し元の更新

以前の `BinlogEvent.GTID()` の戻り値は GTID、`hasBegin`、エラーのみでしたが、シグネチャに `lastCommitted` と `sequenceNumber` も追加されました。

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

### `key.GenerateShardRanges()` が16進数の桁数パラメーターを受け付けるように変更

- 影響対象: `key.GenerateShardRanges()` を直接呼び出すコード
- 必要な対応: 直接呼び出すコードでの新しいパラメーターを渡す呼び出しへの更新

以前はシャード数だけを指定していました。新しい `hexChars` の値で、生成されるシャード名の16進数の桁数を指定します。

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

### 対象となるDDL変更中のVitessクエリバッファリング

- 影響対象: 対象となる`INSTANT` DDLマイグレーションと範囲パーティションのローテーション変更
- 必要な対応: `--prefer-instant-ddl`を指定した即時実行可能なマイグレーション、または範囲パーティションのローテーション変更

スキーマ変更の実行中に発生するクエリの失敗を減らし、アプリケーションからは透過的に動作します。

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

### 対象となる特殊操作のDDL前におけるロック保持者の終了

- 影響対象: 値がゼロでない `--force-cut-over-after` を指定した、対象となる instant DDL およびレンジパーティションのローテーション操作

以前は、これらの操作では DDL を直接実行していました。現在は、移行対象のテーブルでロックまたはメタデータロックを保持しているクエリとトランザクションを `ALTER TABLE` の前に終了します。この処理が行われるかどうかは、フラグの値によって変わりません。ただし、そのテーブルに対するアトミックトランザクションが保留中の場合、終了処理は行われません。

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

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

### cgroup CPU・メモリ指標の収集に cgroup v2 が必要に

- 影響対象: cgroup v1 を使用する Linux 環境

従来、Vitess は cgroup v1 と v2 の両方から CPU とメモリの指標を収集していました。cgroup v1 の場合、または cgroup 指標のセットアップに失敗した場合は、警告を出してホストの指標を使用します。cgroup v2 では引き続き cgroup の指標を使用します。

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

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

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

### VStream の診断ログの変更

- 影響対象: VStream を使用するクラスター (推定)

追加された行は、クラスター内で頻発する EOF エラーの発生箇所を特定しやすくすることを目的としています。VStream のエラーログのうち 1 つが `Errorf` から `Infof` に変更されます。

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

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

### VReplication による MySQL エラー 1419 の無期限再試行の停止

- 影響対象: VReplication ワークフロー

ワークフローが `DEFINER` トリガーを作成すると、このエラーが発生することがあります。この変更前は、VReplication はこのエラーを処理できず、ワークフローを無期限に再試行する可能性がありました。

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

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

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

### VTTablet による古いレプリカハートビートのエラー報告

- 影響対象: ハートビートリーダーを使用するレプリカタブレット (推定)

MySQL が停止し、設定されたハートビート間隔の2倍を超えてハートビートを正常に読み取れない場合でも、`vttablet` は MySQL を正常と報告し続けることがありました。ハートビートの状態がエラーを返し、タブレットが異常であることを VTGate に通知するようになりました。

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

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

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

### `InitAuthServerClientCert` が明示的なCA値を受け取る変更

- 影響対象: `go/mysql` の公開関数 `InitAuthServerClientCert` を呼び出すGoコード（VTGateプラグインの初期化処理を含む） (推定)

以前は、この関数は `mysql-server-ssl-ca` を参照し、そのフラグが空の場合は `mysql_server_ssl_ca` にフォールバックしていました。現在は2番目の引数としてCA値を受け取り、VTGateプラグインの初期化処理が `vtgate.GetMysqlServerSSLCA()` を通じて値を渡します。

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

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

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

### `lite:mysql80` Docker イメージビルドの追加

- 影響対象: `lite:mysql80` イメージを選択するビルド (推定)

従来、lite イメージのビルドマトリクスには `latest`、`mysql84`、`percona80` が含まれていましたが、`mysql80` は含まれていませんでした。

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

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

### `RENAME` 中にテーブルロック保持接続を強制終了

- 影響対象: 強制カットオーバーを使用するオンラインDDL移行

これまでは、カットオーバー前の終了処理と `RENAME` の間に長時間実行クエリが開始し、移行対象テーブルのロックを保持することがありました。追加の終了処理では、ロック接続と `RENAME` 接続を対象外にします。

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

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

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

### Online DDL のカットオーバー時のロック待機タイムアウト短縮

- 影響対象: Online DDL のカットオーバー移行 (推定)

ロック接続のタイムアウトは、`onlineDDL.CutOverThreshold` の5倍から3倍に変更されます。リネーム接続のタイムアウトは、しきい値の5倍の4倍から、しきい値の2倍に変更されます。

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

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

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

### VTOrc の `database_instance` のロケーションフィールドを情報提供用の `cell` に置き換え

- 影響対象: `database_instance` テーブルを使用する VTOrc のインストール環境 (推定)

削除されたフィールドはロジックでは使用されていませんでした。`physical_environment` と `region` は常に未定義または空で、`data_center` はタブレットの cell と一致していました。新しい `cell` フィールドは、まだロジックでは使用されていません。

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

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

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

### VTOrc の `database_instance` スキーマでロケーションフィールドを `cell` に置き換え

- 影響対象: `database_instance` テーブルを使用する VTOrc インストール環境 (推定)

以前のテーブルには `data_center`、`physical_environment`、`region` フィールドがありましたが、プルリクエストによると、これらはロジックでは使用されていませんでした。置き換え後の `cell` フィールドは情報提供用で、現時点ではロジックに使用されていません。

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

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

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

### VTOrc の集約ディスカバリーメトリクス API の削除

- 影響対象: VTOrc の `/api/aggregated-discovery-metrics` エンドポイントを使用するインテグレーション (推定)

このエンドポイントは以前、120秒間にわたる集約ディスカバリーサンプルの JSON を返していました。

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

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

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

## 非推奨 (15)

### アンダースコア形式のCLIフラグの非推奨化

- 影響対象: 移行対象の989個のCLIフラグのアンダースコア形式の名前
- 削除予定: v25.0.0

従来は、Viperにバインドされた形式と異なる表記のフラグを使うと、処理が失敗したり何も起きなかったりすることがありました。v23.0.0とv24.0.0では、どちらの形式も受け付けられ、ハイフン区切りの名前に正規化されます。アンダースコア形式はヘルプに表示されず、非推奨を知らせるメッセージが表示されます。

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

### VTOrc による `DiscoveryInstanceTimings` メトリクスの追加

- 影響対象: インスタンス検出のタイミングメトリクスを利用する VTOrc デプロイメント (推定)
- 削除予定: v24+

このリリースでは、両方のメトリクスにインスタンス検出アクションの所要時間が記録されます。旧メトリクスの `DiscoverInstanceTimings` は v24 で非推奨化され、v24 以降に削除される予定です。

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

### `/api/replication-analysis` の非推奨化と `/api/detection-analysis` への移行

- 影響対象: いずれかの分析エンドポイントを使用する VTOrc API クライアント
- 削除予定: v24+

このリリースでは両方のエンドポイントが同じハンドラーを使用し、同じ形式のレスポンスを返します。旧エンドポイントは、予定されている v24 以降での削除まで引き続き利用できます。

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

### マネージド MySQL のデフォルト認証方式を `caching_sha2_password` に変更

- 影響対象: MySQL 8.0.26 以降のマネージド MySQL インスタンス
- 削除予定: 不明

以前のデフォルトは `mysql_native_password` でしたが、後方互換性のため引き続き有効です。v23 へのアップグレード後、明示的なパスワードを設定したレプリケーションユーザーには `caching_sha2_password` が推奨されています。

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

### gRPC フラグのハイフン区切り名への移行

- 影響対象: `--grpc-auth-mode` や `--grpc-bind-address` などの gRPC フラグを使用する構成
- 削除予定: v25

これらのフラグでは従来アンダースコアを使用していましたが、現在はハイフン区切りの名前を利用できます。アンダースコア形式も引き続き利用できますが、非推奨であり、非表示になっています。

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

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

### アンダースコア形式のフラグ名の非推奨化

- 影響対象: 移行対象となったロギング、データベース、タブレットマネージャー gRPC、または統計フラグを使用する構成
- 削除予定: v25

リファクタリング前は、これらのフラグ名にはアンダースコアが使われていました。現在はハイフン形式の名前を使用できます。アンダースコア形式も引き続き動作しますが、非推奨となり、非表示になっています。

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

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

### よく使われる Vitess フラグのハイフン形式への移行

- 影響対象: 移行対象のバックアップストレージ、MySQL、トポロジー、またはタブレットのフラグを使用する環境
- 削除予定: v25

これらのフラグでは、従来アンダースコア形式の名前が使われていました。現在はハイフン形式の名前を使用できます。アンダースコア形式の名前も引き続きサポートされますが、非推奨となり、非表示になっています。

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

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

### アンダースコア形式のCLIフラグの非推奨化

- 影響対象: フラグのリファクタリングで変更されたCLIフラグ
- 削除予定: v25

v23では、ハイフン形式とアンダースコア形式の両方が受け入れられます。

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

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

### `vtctld` フラグにハイフン区切りの名前を追加

- 影響対象: `vtctld` フラグ（`--disable-active-reparents` や `--opentsdb-uri` など）を使用する環境
- 削除予定: 不明

フラグには以前、アンダースコア形式の名前が使われていました。ハイフン区切りの形式が利用できるようになりました。アンダースコア形式も引き続きサポートされますが、非推奨となり、非表示になっています。

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

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

### Vitess フラグのダッシュ区切り名への移行

- 影響対象: 移行対象となった DBA プール、VTGate/Vtctld gRPC、クライアントプロトコル、クエリログ、外部トポロジー、または Ceph バックアップストレージのフラグを使用する構成
- 削除予定: 不明

アンダースコア形式の名前も引き続き使用できますが、現在は非推奨となり、非表示になっています。

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

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

### 移行後の `vtcombo` フラグ名をハイフン区切りに変更

- 影響対象: `vtcombo` バイナリで、ハイフン区切り名に移行したフラグを使用する構成
- 削除予定: 不明

アンダースコア形式の名前も引き続き使用できますが、非推奨となり、非表示になっています。

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

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

### `vtcombo` フラグ名のハイフン区切りへの移行

- 影響対象: `vtcombo` バイナリで移行対象となるフラグ
- 削除予定: 不明

リファクタリング前は、これらのフラグ名にアンダースコアが使われていました。現在はハイフン区切りの名前を使用できます。アンダースコアを使った名前も引き続き利用できますが、非推奨であり、非表示になっています。

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

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

### 影響を受けるコマンドラインフラグのハイフン区切り名への統一

- 影響対象: 影響を受けるフラグを指定して `mysqlctld`、`mysqlctl`、または `vtbackup` コマンドを実行する Vitess デプロイメント
- 削除予定: v25

該当するフラグは以前、アンダースコアを使った表記でした。例として、`init_db_sql_file`、`socket_file`、`wait_time` があります。

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

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

### `vtcombo` の47個のフラグ名をハイフン区切りに変更

- 影響対象: 移行されたフラグを使用する `vtcombo` の設定
- 削除予定: v25

対象のフラグでは以前、アンダースコアを使用していました。PR では、ハイフン区切りの表記として `--relay-log-max-items` と `--restore-from-backup` が挙げられています。

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

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

### `/api/replication-analysis` の非推奨化と `/api/detection-analysis` への移行

- 影響対象: `/api/replication-analysis` を使用する VTOrc クライアント (推定)
- 削除予定: 不明

後継エンドポイントは同じレスポンス形式を返します。

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

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

## 重大な修正 (49)

### mysqlctl の環境変数を mysqld に引き継ぎ

- 影響対象: UTC 以外の `TZ` 設定などの環境変数を使用する mysqlctl デプロイメント

以前は、mysqlctl に設定された `TZ` が mysqld に反映されず、環境変数によるタイムゾーン設定は `DATETIME` の解釈に影響しませんでした。現在は mysqld がこれらの変数を引き継ぐため、以前の動作を前提としているデプロイメントでは、`DATETIME` の値が異なる方法で解釈されることがあります。

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

### アンダースコア付きCLIフラグの処理修正

- 影響対象: Viperにバインドされたものを中心とする、名前にアンダースコアを含むCLIフラグ

アンダースコア付きのフラグを渡すと、別のフラグオブジェクトにバインドされていたためにViperが値を取得できず、設定が壊れたり反映されなかったりすることがありました。解析時にアンダースコア付きの名前をハイフン付きの名前に正規化するようになり、渡した値がViperに届きます。ただし、引き続き非推奨を知らせるメッセージが表示されます。

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

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

### Evalengine のタプル簡約化による複数列結果の保持

- 影響対象: evalengine の複数列結果に対するタプル簡約化（結合条件内の CASE 式を含む） (推定)

この修正前は、簡約化処理が複数列の結果を単一の `Literal` にまとめていました。結合条件内の CASE 式が、具体例として示されています。

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

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

### evalengineの比較処理で発生するクラッシュの修正

- 影響対象: NULL、JSON、ENUM、SET、またはジオメトリ値を含むevalengineの比較 (推定)

NULLを含む比較や、evalengineが適切に扱えなかった型（JSON、ENUM、SETなど）との比較で、panicが発生することがありました。該当するNULLチェックと型処理が修正され、ここで説明されている予期しない型によるクラッシュは発生しなくなりました。

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

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

### 無視対象の vindex 行に対する vtgate のベーステーブル挿入修正

- 影響対象: vindex を使用する `INSERT IGNORE` 文

以前は、`INSERT IGNORE` の実行時に vindex が行を無視対象として報告すると、vindex 列が NULL の場合にその行がルックアップテーブルに登録されず、ベーステーブルへの挿入もスキップされることがありました。現在は、vindex が行を無視対象として報告した場合でも、vtgate がベーステーブルにその行を挿入できます。

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

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

### UNION クエリのマージ時における LIMIT/OFFSET の維持

- 影響対象: Vitess がマージする、LIMIT または OFFSET を使用する UNION クエリ (推定)

この修正以前は、マージされた UNION クエリで LIMIT/OFFSET が反映されないことがありました。

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

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

### 空の入力に対するスカラー集約のリテラル結果を修正

- 影響対象: リテラル値を使うスカラー集約を含むクエリ (推定)

入力が空の場合（たとえば、サブクエリの `WHERE` 条件に一致する行がない場合）、リテラルが列参照として扱われ、例では `(NULL, 0)` が返されていました。現在はリテラルが評価され、MySQL と互換性のある結果 `(1, 0)` が返されます。

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

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

### 単純な射影におけるプリペアドステートメントのフィールド一覧修正

- 影響対象: 名前のみの最適化を使用する、単純な射影を含むプリペアドステートメント (推定)

単純な射影を含むプリペアドステートメントで、`GetFields` が `buildFields` を直接呼び出した場合、名前のみのケースではフィールド一覧が空になっていました。

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

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

### 派生テーブルの `GROUP BY` プランにおける列数の修正

- 影響対象: 派生テーブルの外側で `GROUP BY` のみを行うクエリ

これらのクエリでは、プランナーが投影列数を誤って報告し、余分な列が結果に混入する可能性がありました。

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

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

### [表面化しなかった不具合] Throttler のメトリクス集約での gRPC 接続エラー認識

- 影響対象: throttler のメトリクス集約を使用する構成

メトリクスプローブの gRPC 接続が `Unavailable` または `DeadlineExceeded` で失敗すると、集約処理はこれを異常状態として扱い、`VReplication` などの throttler 利用者がスロットリングされていました。

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

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

### タブレットスロットラーの `SrvKeyspace` ウォッチをエラー後も維持

- 影響対象: タブレットスロットラーの `SrvKeyspace` ウォッチを使用する構成

ウォッチのコールバックがエラーを受け取るとリスナーが削除され、通常はタブレットのタイプ変更時に再度 `Open()` が呼び出されるまで、スロットラーは `SevKeyspace` の変更を読み取れなくなっていました。エラー発生後もウォッチが維持されるようになりました。

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

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

### Atomic Copy のコピー後アクション実行の修正

- 影響対象: コピー対象テーブルに対するコピー後アクションを使う Atomic Copy ワークフロー

`copyAll()` がテーブルのコピー後アクションを実行し損ねることがありました。実行済みアクションのレコードは、対応する `_vt.copy_state` レコードとともに `_vt.post_copy_action` から削除されるようになりました。

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

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

### プライマリタブレットのレプリケーション遅延メトリクスをリセット

- 影響対象: レプリケーショントラッカーを使用する VTTablet 構成 (推定)

プライマリへの昇格後や、トラッカーがプライマリまたは `Disable` モードのときに `Status()` が実行された場合、以前の遅延値が残ることがありました。該当する場合、メトリクスはゼロにリセットされるようになりました。

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

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

### [表面化しなかった不具合] クエリコンソリデーターの待機数上限超過時のフォールバック修正

- 影響対象: クエリ統合を使用するクエリサービング構成 (推定)

待機数上限を超えると、クエリコンソリデーターがエラーなしで空の結果を返すことがありました。現在はクエリを個別に実行し、その結果を返します。

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

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

### [表面化しなかった不具合] `GenerateShardRanges` における範囲カバレッジ不足の修正

- 影響対象: `GenerateShardRanges` によるシャード名の生成 (推定)

49 など、一部のシャード数では、生成されたシャード名が全範囲をカバーしていませんでした。現在はキースペース全体をカバーします。

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

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

### `ready_to_complete` での Online DDL 進捗を 100% に修正

- 影響対象: `ready_to_complete` に到達する Online DDL マイグレーション

`ready_to_complete` の時点で、テーブル行数の推定により、報告される進捗が 87% や 100% から大きく離れた値になることがありました。

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

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

### 結果が存在しないクエリの `UNION` 整形を修正

- 影響対象: `UNION` 文に対する、結果が存在しないクエリの列メタデータ取得

結果を取得せずに `UNION` の列名と型を取得する際、フォーマッターが行なし条件を確実に追加できていませんでした。現在は、`UNION` の各分岐を含め、整形後のクエリに `where 1 != 1` が含まれます。

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

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

### 条件に一致する非シャーディング更新での VStreamer フィルターによる両イメージの送信

- 影響対象: 行カラムにフィルターを設定した、`MoveTables` と `Reshard` 以外の非シャーディング VStreamer ワークフロー

フィルターで使われるカラムが更新され、`Before` または `After` のイメージが一致した場合、一致したイメージだけが送信されていました。そのため、後続のコンシューマーが更新を挿入または削除として解釈する可能性がありました。

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

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

### VTOrc の `SkippedRecoveries` メトリクスへの理由ディメンション追加

- 影響対象: `SkippedRecoveries` メトリクスを出力または利用する VTOrc のインストール環境

VTOrc がリカバリーをスキップした際、メトリクスに `ERSDisabled`、`ReplicationLagHigh`、`NotEnoughReplicas` などの理由が示されるようになり、これまで計測されていなかったスキップされたリカバリーのケースも追跡されます。

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

### `CREATE PROCEDURE` 内の本体 `SET` 文の正規化修正

- 影響対象: `SET` 文を含むストアドプロシージャ (推定)

プランナーによる正規化の際、プロシージャ本体の `SET y = 4` が `SET @@y = 4` に変更されていました。Vitess は `CREATE PROCEDURE` 文に対するこの正規化をスキップするようになり、本体の `SET` 文は変更されずに残ります。

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

### Vitessにおける `MEMBER OF` と `AND` の優先順位修正

- 影響対象: `MEMBER OF` を使う JSON クエリ

`MEMBER OF` を `AND` などの論理演算子と組み合わせたクエリでは、演算子の優先順位が誤っていたため、Vitess が基盤の MySQL インスタンスに誤ったクエリを送信する可能性がありました。現在は修正された優先順位で評価されます。

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

### 削除済みキースペースの孤立したサービングレコードの消去

- 影響対象: `RebuildKeyspace` によるキースペースの再構築 (推定)

キースペースの削除後に残ったサービングレコードがあると、`RebuildKeyspace` が削除済みのキースペースに遭遇した際に `vtgate` がクラッシュしていました。現在は、それらのレコードを消去します。

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

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

### Online DDL のテーブル名変更失敗時における Vreplication の再起動

- 影響対象: テーブル名変更前に vreplication を停止する Online DDL のカットオーバー (推定)

vreplication の停止後に残りの `RENAME` が失敗した場合、カットオーバーではそのワークフローの vreplication の再起動を試みます。

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

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

### vtgate のプランキーでタブレットタイプを区別

- 影響対象: primary や replica など、異なるタブレットタイプ向けにクエリをプランニングしてキャッシュする vtgate ワークロード (推定)

プランキーでタブレットタイプを区別せずに vtgate がプランを再利用すると、誤ったプランが再利用される可能性がありました。

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

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

### 回避可能なトポロジーウォッチャーによる通知の繰り返しを修正

- 影響対象: 回避可能なトポロジーウォッチャーを使用する構成 (推定)

トポロジーの停止中にキャッシュデータを利用できる場合、ウォッチャーはキャッシュデータを返している間も、リフレッシュのたびにリスナーへ通知していました。現在はリスナーへの通知は行われず、`Get` 操作は引き続きキャッシュからデータを取得できます。

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

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

### `dual` テーブルのトラフィックミラーリング対応

- 影響対象: `dual` テーブルを含むクエリでトラフィックミラーリングを使用する構成 (推定)

以前は、ミラールールのエントリーがない `dual` テーブルを含むクエリをミラーリングすると、パニックが発生することがありました。現在は `dual` テーブルをミラーリングせずにクエリを処理します。

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

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

### Vitess による `UNION` プランニング時の列エイリアス処理の修正

- 影響対象: `UNION` で列エイリアスを使用するクエリ (推定)

`UNION` のプランニングで、Vitess は列エイリアスの処理に問題がありました。例では、`UNION ALL` の両方の分岐でエイリアスを使用しています。

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

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

### Vitess のルーティング対象テーブルにおける外部キー処理の修正

- 影響対象: 外部キー関係とルーティング対象テーブルがある構成

`MoveTables` の `SwitchWrites` 後、ソースのキースペースにある子テーブルがターゲットのキースペースにあるルーティング先の親テーブルを検出し、親テーブルにソースのキースペースの子テーブルが含まれることで、外部キー参照が壊れることがありました。今後は、外部キー関係が追加されるのはターゲットのキースペースにあるルーティング対象テーブルのみで、ソースのキースペースにあるテーブルには追加されません。

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

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

### 無効な `srvtopo` キャッシュエントリーの更新

- 影響対象: `srvtopo` の参照

キャッシュ期間内に、キャッシュされたエラーがソースへ再問い合わせせずに即座に返されることがあり、`show vitess_shards` などの呼び出しがコンテキストのキャンセルやタイムアウトで失敗していました。無効なキャッシュエントリーまたはキャッシュされたエラーがある場合は、キャッシュを更新して新しい結果を待つようになりました。有効なキャッシュ値は、再問い合わせせずに返されます。

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

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

### Vitess、自己参照外部キーの検証クエリにエイリアスを追加

- 影響対象: `RESTRICT` アクションを使用する自己参照外部キー

Vitess がこれらの外部キーの検証クエリを計画する際、結合先のテーブルにエイリアスを付けずに自己結合していたため、MySQL でクエリが失敗していました。現在は結合先のテーブルにエイリアスが付与され、この実行時の失敗が回避されます。

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

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

### 終了中の接続プールで待機がハングする問題の修正

- 影響対象: 接続プールを使用する構成 (推定)

接続プールの終了中に接続が要求されると、待機がハングし、PRS/ERS などの通常の処理が成功しなくなることがありました。

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

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

### VDiff の余分な行の照合時に発生するパニックの修正

- 影響対象: 余分な行を照合する VDiff の実行

余分なソース行またはターゲット行が `--max-extra-rows-to-compare` を超えた場合や、ソースとターゲットで返される行数が異なる場合に、VDiff がパニックすることがありました。照合処理では余分な行の差分スライスの長さを使うようになり、これらのケースでの範囲外アクセスを回避します。

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

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

### VStream キャッチアップでの早期 EOF の修正

- 影響対象: VStream API のキャッチアップ

複数のテーブルがある場合、コピー処理ですでにコピーされたテーブルや行に対する更新または削除を処理する前に、キャッチアップが `EOF` を返すことがありました。fastforward セットの `stopPos` をリセットすると、この早期終了が防がれ、キャッチアップでそれらのトランザクションを処理できるようになります。

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

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

### `vcopier` のクローズ済みチャネルへの送信による tablet のクラッシュ防止

- 影響対象: `vcopier` のコピータスクを使用する tablet ワークロード

`copyAll` コールバックが、`resultCh` のクローズ後に結果を送信すると、panic が発生して tablet がクラッシュする可能性がありました。これは、context の期限を超過した場合などに起こり得ます。panic は回復され、ログに記録されるようになりました。

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

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

### テーブルストリーミング時の Atomic Copy エラー伝播

- 影響対象: テーブルのストリーミング中に Atomic Copy を使用するワークフロー

接続タイムアウトなどのストリームエラーが無視されると、ワークフローが再起動してコピー段階に戻り、重複キーエラーが発生することがありました。現在はエラーが伝播され、ログには失敗したテーブルと、設定されたネットワークの読み取りタイムアウトおよび書き込みタイムアウトが記録されます。

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

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

### Atomic Copy ワークフローのレプリケーションエラーによる終了を防止

- 影響対象: Atomic Copy サブモードで、コピー段階を完了して `running` 状態に移行した VReplication ワークフロー

コピー段階の後、レプリケーション段階でエラーが発生すると、ワークフローが終了することがありました。現在は、そのようなエラーも通常どおり処理されます。

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

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

### 逆方向ワークフローの VReplication 読み取りを MariaDB が拒否する問題の修正

- 影響対象: 逆方向ワークフローを使った MariaDB からの VReplication インポート

これらのインポートで VReplication ワークフローを読み取る際、SQL の厳格なグループ化ルールによりクエリが MariaDB に拒否され、失敗することがありました。拒否の原因となった `GROUP BY` 句はクエリから削除されました。

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

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

### VStreamer の並行マップアクセスによるクラッシュの修正

- 影響対象: `vttablet` の VStreamer イベント解析 (推定)

インプレースでの GTID 計算中にマップへ並行アクセスすると、`vttablet` が `fatal error: concurrent map read and map write` でクラッシュする可能性がありました。VStreamer はインプレース処理の代わりに `replication.AppendGTID` を使用するようになりました。

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

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

### 削除済みバイナリログのエラー後に VStream が再試行

- 影響対象: VStream リクエスト

ソースで必要なバイナリログが削除され、タブレットに要求された GTID がない場合、以前の VStream はそのタブレットを除外しなかったため、この理由では別のタブレットを試しませんでした。現在は、要求されたバイナリログの履歴が残っている可能性のある別のタブレットで再試行します。

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

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

### VReplication におけるハイフン付き識別子の処理を修正

- 影響対象: ハイフンを含む keyspace、データベース、テーブル、またはシーケンス名を使用する VReplication 関連の操作

これらの操作では、SQLで使用する前に、テーブルの keyspace、テーブル名、データベース、シーケンスなどの識別子をエスケープするようになりました。

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

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

### etcd2topo のシャットダウン時のパニック修正

- 影響対象: etcd2topo サーバー実装を使用する構成

VTGate のシャットダウン中に、並行して動作するコルーチンが `Close()` によって `nil` に設定された後の `s.cli` にアクセスし、nil ポインター参照のパニックが発生することがありました。現在はパニックではなく、シャットダウン通知（`context.Canceled`。`topo.Interrupted` に変換）を返します。

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

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

### 準同期モニターのタイマー終了時のデッドロック修正

- 影響対象: VTTablet の準同期モニターを実行している構成 (推定)

`mu` を保持したままタイマーを閉じると、`checkAndFixSemiSyncBlocked` も `mu` を取得しようとした場合にデッドロックする可能性がありました。モニターは専用のタイマーミューテックスでタイマーの `Open` と `Close` を直列化し、`mu` を取得する前にタイマーの tick を閉じるようになりました。

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

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

### VTTablet のセミ同期モニターにおけるデッドロックの修正

- 影響対象: VTTablet のセミ同期モニターを実行している構成 (推定)

セミ同期がブロックされ、ハートビートの書き込み開始後、`setIsBlocked` によるモニター状態の変更前にモニターが終了すると、`appPool` の終了処理でデッドロックが発生する可能性がありました。終了処理は書き込みに使われた接続のプールへの返却を待つ一方、書き込みスレッドはミューテックスを待っていたためです。モニターはミューテックスを待つ前に接続をプールへ返却するようになり、終了処理がブロック中の書き込みに保持された接続を待つことはなくなりました。

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

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

### コピー段階での`VStreamRows`ハートビートの定期送信

- 影響対象: 長時間実行される`VStreamRows`操作

従来、長時間にわたるテーブルコピー中は、ハートビートを1回送信した後に機構が終了していました。これには OnlineDDL のコピー段階や、MoveTables/Reshard 中のテーブルコピーが含まれます。

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

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

### `ValidateKeyspace` のデッドロック修正

- 影響対象: `vtctldclient` 経由で `ValidateKeyspace` を使用する構成 (推定)

読み取り側が動作を開始する前に書き込みが始まると、結果の書き込み処理が無期限にブロックされる可能性がありました。現在は書き込みを開始する前に結果を処理して消費するため、書き込み時には読み取り側が動作しています。

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

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

### vttablet の外部 MySQL 接続確認で SSL 設定を渡す

- 影響対象: 安全な接続を必須とする外部 MySQL インスタンスへの vttablet 接続

vttablet が安全な接続を必須とする外部 MySQL インスタンスへの接続を確認する際、SSL 設定が渡されず、MySQL のエラーによって vttablet が起動できませんでした。接続処理に SSL 設定を渡すようになり、この起動時エラーを回避できます。

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

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

### VTOrc による二次的な対処よりプライマリ復旧の優先

- 影響対象: クラスター全体に及ばないリカバリー分析を処理する VTOrc 環境

`ReplicationStopped` などのクラスター全体に及ばない問題がプライマリの停止によって発生した場合、VTOrc はプライマリ障害を認識する前に、二次的な問題への対処としてシャードをロックすることがあり、プライマリの復旧が遅れる可能性がありました。VTOrc は処理を進める前にプライマリの情報を更新し、プライマリへの対処が必要な場合は古くなった分析を中止するようになりました。

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

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

### Vitess Java JDBC ドライバーの分離レベル変数参照を修正

- 影響対象: MySQL 8.0 または MySQL 5.7.20 以降を使用する Vitess Java JDBC ドライバー

MySQL 8.0 では、初期化時に非推奨または削除された `tx_isolation` を照会していました。置き換え先の `transaction_isolation` は、MySQL 5.7.20 以降との後方互換性があります。

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

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

### VDiff サイドカースキーマの更新によるクエリ性能の改善

- 影響対象: 内部サイドカーデータベースを使って VDiff を実行する環境 (推定)

VDiff の実行時、内部サイドカーデータベースに対する性能の低いクエリが、プライマリ vttablet のクラッシュを含む重大な問題を引き起こすことがありました。スキーマでは `vdiff_log.id`、`vdiff_log.vdiff_id`、`vdiff_table.vdiff_id` に `bigint(20)` を使用するようになり、一部の VDiff クエリの性能向上のために `vdiff_id_idx` インデックスが追加されました。

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

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

## 機能・改善 (47)

- VTGate 向け `ExecuteMulti` と `StreamExecuteMulti` API (利用条件: この機能の利用には、VTGate で `--mysql-server-multi-query-protocol` を有効化)
- セッションごとのトランザクションタイムアウト制御
- 実験的な受信クエリスロットリングの仕組み
- 1つの `vtctldclient` ワークフローでの複数の lookup vindex (利用条件: lookup vindex のパラメーターを含む JSON ファイルを指定した `--params-file` の使用（`--type`、`--table-owner`、`--table-owner-columns` との併用不可）)
- 既存のマテリアライズワークフローへの参照テーブル追加 (利用条件: `Materialize ... update` に `--add-reference-tables` とターゲット keyspace を指定)
- Vitess での再帰 CTE のサポート
- Vitess SQL パーサーの `CREATE TABLE ... SELECT` 対応
- VTGate によるシャード別・種類別トランザクションカウンターの追加
- VTGate による遅延最適化クエリーカウンターの追加
- Online DDL の古いマイグレーション経過時間ゲージの追加
- VTOrc に `EmergencyReparentShardDisabled` ゲージを追加
- vtgate、vttablet、vtcombo のいずれかの条件によるクエリログ記録 (利用条件: `--querylog-emit-on-any-condition-met` を有効化（デフォルトは false）)
- VTOrc の起動時リカバリー制御 (利用条件: `--allow-recovery=false`)
- `GenerateShardRanges` のシャードラベルの16進数幅を指定可能に (利用条件: `--chars` フラグ)
- `ALTER VITESS_MIGRATION ... POSTPONE COMPLETE` コマンドのサポート
- `INSERT`／`REPLACE` 文での単数形 `VALUE` のパーサー対応
- VTOrc の緊急再親化に対するキースペース単位・シャード単位の制御 (利用条件: `vtctldclient SetVtorcEmergencyReparent` コマンドと `--keyspace`、任意の `--shard`、および `--enabled=true` または `--enabled=false`)
- VTGate の `IN` フィルターにおけるタプルバインド変数のサポート
- リシャーディングジャーナルの `val` 列を `longblob` に拡張
- 管理対象外タブレットでの空パスワード認証情報の受け入れ
- `xtrabackup` バックアップエンジンの tablet ドレイン設定 (利用条件: `--xtrabackup-should-drain` を `true` に設定)
- 解析済み MySQL 接続属性のサーバー側での保持
- ハンドシェイク時の接続属性に対応した MySQL クライアント (利用条件: `ConnectionAttributes` マップを指定した `ConnectWithAttributes` の使用)
- discovery 向けカスタムロガーのサポート (利用条件: `WithLogger` オプション)
- VTTablet のプライマリ提供時における binlog watcher の終了ログ
- gRPC サーバーによる ORCA バックエンドメトリクスの報告 (利用条件: `--grpc-enable-orca-metrics` を有効化（デフォルト: false）)
- クエリログに実行時間のしきい値を追加 (利用条件: `--querylog-time-threshold` に指定する `time.ParseDuration` 形式の期間。ストリーミングクエリでは有用ではありません)
- Online DDL の準備状態変更ログ
- `fetchCredentials` を追加したサンプル Vitess Operator CRD スキーマ
- クエリプランナーの最適化理由を示すデバッグログ (利用条件: `DebugOperatorTree = true`)
- `SET NAMES binary` の SQL パーサー対応
- tablet の受信クエリスロットリング (利用条件: `/config/throttler-config.json` の Throttler 有効化フラグ)
- Query Throttler のドライランモード
- `switchwrites` のシーケンス処理をバッチ化する新しい TMC RPC
- キースペースを含まない VStream テーブル名 (利用条件: `ExcludeKeyspaceFromTableName` VStream フラグの設定)
- 互換性のある DDL 変更での VStreamer によるスキーマ利用
- vtgateconn gRPC 経由でのセッション終了
- vtgate 接続の gRPC fail-fast の設定可能化 (利用条件: `vtgate-grpc-fail-fast` を `true` に設定して gRPC fail-fast を有効化（デフォルトは `false`）)
- vtgateconn gRPC フラグ登録関数の外部公開
- MySQL レプリケーションを1回の呼び出しで再起動 (利用条件: 追加された `RestartReplication` メソッドを呼び出すクライアント)
- `SchemaDiff` に外部キーの影響一覧を追加
- Online DDL マイグレーションのシャード単位での完了
- VStream のコピー処理でのテーブル選択 (利用条件: `VStreamOptions` または `VStreamFlag` での `TablesToCopy` の設定)
- `vstreamer` による `PREVIOUS_GTIDS` VEvent の出力
- `vstreamer` イベントへの GTID メタデータの追加
- `mysqldExporter.extraFlags` の `operator.yaml` スキーマ対応 (利用条件: `operator.yaml` の `mysqldExporter.extraFlags`。文字列値の追加プロパティを持つオブジェクトとして定義)
- `mysqldExporter` で `resources` が不要に

## 依存関係の更新 (17)

ほか17件（いずれもセキュリティへの言及なし）

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

## その他の変更 (110)

- VTTablet の状態メトリクスに `type`、`keyspace`、`shard` ラベルを追加
- `CREATE PROCEDURE` の `DEFINER` 句に対応した SQL 文分割
- `DEFINER` 句を含む `CREATE PROCEDURE` 文の分割処理の改善
- ストアドプロシージャの解析で `START TRANSACTION` を `BEGIN` に変換しなくなった変更
- ウィンドウ関数のターゲットシャードへのプッシュダウン
- UNION クエリのより積極的な統合
- UNION クエリで不要な派生テーブルのラップを回避
- `SINGLE` モードでの読み取り専用マルチシャードトランザクション
- プリペアドステートメントで実行時依存のクエリプランをサポート
- リカバリー統計にキースペースとシャードのラベルを追加
- プルリクエストテンプレートへの AI 利用申告の追加
- MySQL Shell のリストア機能チェックの修正
- CI ビルドにおけるドラフト状態の判定にイベントペイロードを使用
- ローカル例テストでのTOPOのDockerへの受け渡しとConsulの省略
- golang-ci lint スクリプトのバージョン表記における `v` 接頭辞の有無への対応
- キャンセルされた vreplication 移行エントリの保持
- プランナーでのサブクエリ統合の復元
- `CREATE PROCEDURE` の本体内での `START TRANSACTION` の保持
- タブレット向けクエリからデータベース修飾子を削除
- zk2 と Consul の NamedLock テスト追加・成功
- SwitchWrites の進捗とエラーのログを拡充
- バージョンに応じた `--vschema-ddl-authorized-users` の形式を選ぶ VTCombo テストヘルパー
- `*vstreamManager.VStream` の戻り後にコールバックを実行しない
- コールバックエラー時の`*vstreamManager.VStream`の即時リターン
- トラフィック切り替え時のシーケンスカウンターのリセット
- Go バージョンアップグレードワークフローの対象に `release-22.0` ブランチを追加
- CI ワークフローの CNCF Oracle VM ランナーへの切り替え
- ライブラリパッケージ向けの `depguard` 制限
- Go の依存関係・Go バージョンのワークフローで `peter-evans/create-pull-request` を v7 に更新
- CI ワークフローで MySQL 8.4 をデフォルト使用
- Protobuf のランダム性対策を削除し、ゴールデンテストを構造比較に変更
- CI ワークフローの `mysql-apt-config_0.8.35-1_all.deb` への更新
- Vitess Java パッケージの公開先を Central に変更
- 不安定な vdiff2 エンドツーエンドテストの専用ワークフローへの移行
- `TestMigrateSharded` の CI でのスキップ
- v22.0.0 リリースノートの文面校正
- `MAINTAINERS.md` の連絡先メールアドレスを更新
- リリースサイクルのプルリクエスト分析ツールの追加
- vmg の過去のメンテナー一覧への移動
- `@deepthi` の名誉メンテナーへの移行
- Manan Gupta のメンテナー用メールアドレスの更新
- Manan Gupta の過去のメンテナー欄への移動
- Vitess メンテナー一覧の更新
- `CODEOWNERS` の所有者エントリーの更新
- `CREATE PROCEDURE` の vtgate 経由での非シャーディングキースペース対応に関する概要
- `go-upgrade` による Go パッチバージョン更新の検出
- CI ワークフローのフィルターのイベント設定への移動
- Querylog 出力に `EmitReason` 列を追加
- コマンドラインフラグのハイフン区切り名への移行
- VTTablet の ACL 再読み込み成功ログの書式修正
- Online DDL のカットオーバーログへのマイグレーション UUID の追加
- より多くの `UNION` クエリの統合とタプルバインド変数の重複排除
- マージされたサブクエリでの解析済みコメントの保持
- Vitess における MySQL 9.x の MySQL 8.2 flavor へのマッピング
- 外部タブレットの `SwitchTraffic` 権限チェックにおけるワイルドカードのデータベース名チェック追加
- 外部 tablet の権限チェックログの修正
- VReplication コピー段階の履歴リスト上限のデフォルトを `10MB` に引き上げ
- 51 個の `vtcombo` フラグのハイフン区切り名への移行
- `heartbeatWriter` のエラーにコンテキストを追加
- スマート接続プールのセマフォをチャネル方式に変更
- `EmergencyReparentShard` の候補選択における SQL スレッド進捗の考慮
- `REDO_LOG` 再有効化時の MySQL Shell バックアップ復元ログの修正
- CI ワークフローで `always()` の代わりに `!cancelled()` を使用
- CI ワークフローにおける `actions/setup-go` の v5.5.0 へのアップグレード
- GitHub Actions の依存関係インストール時における `man-db` 更新のスキップ
- `vttablet-up.sh` から無効なコメント行を削除
- Code Coverage ワークフローの push イベント実行のフィルタリング
- ユニットテストランナーによるパッケージの並列実行
- `NewHealthCheck` のフィルターに関するドキュメントの明確化
- ローカルの例でハイフン区切りのフラグを使用
- asthelpergen の設計ドキュメント
- VTOrc の `isClusterWideRecovery` から `isShardWideRecovery` への名称変更
- VTOrc のレプリケーション分析における `ClusterDetails` の削除
- VTOrc のシャードプライマリのタイムスタンプ処理の更新
- VTOrc のキースペースおよびシャードの更新で errgroup 由来のコンテキストを使用
- VTOrcによるタブレットタイプフィールドの`GetInt32`読み取り
- GTID セット更新と `vstreamer` のフォーマット処理の最適化
- `vstreamer` の GTID グループごとの `CurrentTime` 生成
- VTorc の GTID セット処理を `replication.Mysql56GTIDSet` に切り替え
- 複数クエリプロトコルのフラグ処理の修正
- `None` オペコードで計画された DML クエリのエラーなし処理
- v23 アップグレードノートの参照先 `vitess/lite:v23.0.0`
- v22.0.0-RC1 のリリースノートをメイン変更履歴に追加
- メインの変更履歴に v21.0.4 のリリースノートを追加
- メインの変更履歴への `v20.0.7` リリースノートの追加
- v22.0.0-RC2 リリースノートのメイン変更履歴への追加
- メインの変更履歴への `v22.0.0-RC3` リリースノートの追加
- v22.0.0 リリースノートのメイン変更履歴への追加
- `v22.0.1` のリリースノートをメインの変更履歴に追加
- メインの変更履歴に v21.0.5 のリリースノートを追加
- v20.0.8 リリースノートのメイン変更履歴への追加
- `v23.0.0-RC1` のコードフリーズ記録
- Vitess `v23.0.0-RC1` リリース
- Vitess v23.0.0-RC2 リリースの記録
- v23.0.0-RC2 後にバージョンを v23.0.0-SNAPSHOT へ更新
- リリースノートの更新
- `TestTrackerNoLock` のタイムアウト延長と `TestCreateLookupVindexMultipleCreate` の基本チェック
- `TestVStreamsMetricsErrors` の競合状態によって異なる結果への対応
- E2E テストでの MySQL ディレクトリ衝突の修正
- vtgate v23 以降でのみ `_binary` プレフィックスを設定する VExplain テスト
- `TestQueryTimeoutWithShardTargeting` がさまざまなエラーメッセージを受け入れる変更
- 空の JSON 配列の挿入テスト
- `TestOverallQueryTimeout` のエラー照合の柔軟化
- 外部キーのエンドツーエンドテスト向け MySQL 8.0 サポート
- `FileBasedConfigLoader` のテストで期待するエラーメッセージとの完全一致を確認
- VStream メトリクステストの不安定さを修正
- `TestStreamRowsHeartbeat` のアトミックなハートビートカウンター
- 停止前に VDiff の開始または完了を待つ VDiff2 エンドツーエンドテスト
- Semi-sync モニターのテストで発生する競合の修正
- スマート接続プールのテストタイムアウト延長

---

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