Tsurugi 1.12.0 - Release Notes (ja)

[akirakw]

1.12.0 リリースノート

概要

Tsurugi 1.12.0 では、SQL関連の機能追加としてテーブルに含まれるすべての行を削除する TRUNCATE TABLE 文に対応しました。

TRUNCATE TABLE は大量のデータを持つテーブルでも高速にテーブルの全行を削除することが可能であり、一時的な大量データを扱う作業テーブルを空にする、検証用のデータセットを入れ替えて試行を繰り返す、といった用途に適しています。
条件を指定しない DELETE 文でも同様の処理が行われますがデータ量に応じた処理時間がかかるため、用途に応じて TRUNCATE TABLE と使い分けるとよいでしょう。

TRUNCATE TABLE ではテーブル定義やインデックスはそのまま維持されるため、DROP TABLE と CREATE TABLE を組み合わせてテーブルを初期化する場合には必要となるインデックスの再作成が不要です。

また、Tsurugi 1.12.0 では 日時系の型から特定のフィールドを抽出する EXTRACT 関数に対応しました。

EXTRACT 関数は、DATE型, TIME型, TIMESTAMP型, TIMESTAMP WITH TIME ZONE型 の値から年、月、日、時、分、秒といったフィールドを取り出す関数です。SQL標準の記法に加えて、YEAR TO HOUR のように取り出す範囲を指定する拡張記法にも対応しました。

これらを利用することで、日ごとや時間帯ごとの件数を数える、月ごとに売上を集計する、特定の年月のデータだけを絞り込む、といった時系列データの取り扱いが容易になります。

その他、本バージョンではいくつかの重要な不具合修正や安定性の向上を行っています。
前バージョンを利用するすべてのユーザーは本バージョンへのアップグレードを強く推奨します。

機能追加と改善

機能追加と改善 - SQL

• TRUNCATE TABLE 文に対応
  • TRUNCATE TABLE は、対象テーブルのすべての行を削除する文です。条件を指定しない DELETE 文と比べて、データ量が多いテーブルでも高速に処理できます。テーブル定義やインデックスは維持されます。
  • 構文は以下のとおりです。自動採番カラム (GENERATED ... AS IDENTITY) を含むテーブルに対しては、RESTART IDENTITY / CONTINUE IDENTITY によってシーケンスの扱いを指定できます。

    -- テーブルの全行を削除
    TRUNCATE TABLE t;
    
    -- テーブルに関連付けられたシーケンスを初期値に戻す
    TRUNCATE TABLE t RESTART IDENTITY;
    
    -- シーケンスの現在値を維持する (省略時のデフォルト)
    TRUNCATE TABLE t CONTINUE IDENTITY;

Important

TRUNCATE TABLE は CREATE TABLE や DROP TABLE と同様にDDL文として扱われます。
このため、ロールバック操作によって TRUNCATE TABLE の実行を取り消すことはできません。削除したテーブルデータを復元する手段はないため、十分に確認したうえで実行してください。

Important

本バージョンでは自動採番カラムを持つテーブルに対して TRUNCATE TABLE ... RESTART IDENTITY が一部条件で利用できない制約があります。詳しくは以下のドキュメントを参照してください。

• Tsurugi 1.12.0 - Known Issues (ja) - TSURUGI-IS-812

• 日時系の型からフィールドを抽出する EXTRACT 関数に対応

  • EXTRACT 関数は、DATE型, TIME型, TIMESTAMP型, TIMESTAMP WITH TIME ZONE型 の値から特定のフィールドを取り出す関数です。

  • SQL標準の記法では、YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, TIMEZONE_HOUR, TIMEZONE_MINUTE を指定できます。戻り値の型は SECOND のみ DECIMAL、その他は INTEGER となります。

    SELECT EXTRACT(YEAR FROM TIMESTAMP '2026-07-01 12:34:56.789');      --> 2026
    SELECT EXTRACT(MONTH FROM TIMESTAMP '2026-07-01 12:34:56.789');     --> 7
    SELECT EXTRACT(SECOND FROM TIMESTAMP '2026-07-01 12:34:56.789');    --> 56.789000000
    SELECT EXTRACT(SECOND(1) FROM TIMESTAMP '2026-07-01 12:34:56.789'); --> 56.7 (小数部1桁)

  • 拡張記法として、取り出す範囲を指定する記法にも対応しました。DATE, YEAR TO MONTH, YEAR TO DAY, YEAR TO HOUR, YEAR TO MINUTE, YEAR TO SECOND を指定でき、指定した範囲より下位のフィールドを切り捨てた値が返ります。YEAR TO HOUR 以下のオペランドには TIMESTAMP 系の型のみを指定できます。

    SELECT EXTRACT(DATE FROM TIMESTAMP '2026-07-01 12:34:56.789');          --> 2026-07-01
    SELECT EXTRACT(YEAR TO MONTH FROM TIMESTAMP '2026-03-21 12:34:56.789'); --> 2026-03-01
    SELECT EXTRACT(YEAR TO HOUR FROM TIMESTAMP '2026-07-01 12:34:56.789');  --> 2026-07-01 12:00:00
    SELECT EXTRACT(YEAR TO MONTH FROM DATE '2026-03-21');                   --> 2026-03-01

  • WHERE 句の条件に EXTRACT 関数を利用することで、特定の年や月のデータを絞り込めます。

    SELECT id FROM events WHERE EXTRACT(YEAR FROM ts) = 2026 AND EXTRACT(MONTH FROM ts) = 8;

  • EXTRACT 関数の結果でグループ化するには、WITH 句やサブクエリーで EXTRACT 関数の結果を列として取得し、それを GROUP BY 句で利用します。

    WITH s AS (SELECT EXTRACT(YEAR TO MONTH FROM ts) AS ym, amount FROM sales)
    SELECT ym, SUM(amount) FROM s GROUP BY ym ORDER BY ym;

Note

本バージョンでは GROUP BY 句に EXTRACT 関数を直接指定することはできません。将来のバージョンでの対応を検討中です。

その他、SQL機能の詳細仕様や現時点での制約については、tsurugidbの以下のドキュメントを参照してください。

• Available SQL features in Tsurugi

機能追加と改善 - UDF

• UDFプラグインごとに複数の接続先を指定し、ラウンドロビン方式で接続する機能に対応
  • 複数の対向ノードにUDF処理の負荷を分散させることを目的として、UDFプラグイン設定ファイル (<plugin-name>.ini) の [udf] セクションの endpoint パラメータに、パイプ文字 | 区切りで複数の接続先を指定できるようになりました。複数指定した場合、UDFの呼び出しごとに接続先がラウンドロビン方式で選択されます。
    • 本バージョンでは、接続先のUDFサーバーが停止した場合には一度エラーを返します。その後は停止したサーバーを除外してラウンドロビン方式で接続先を選択します。
    • 停止したUDFサーバーを再起動すると、以降の呼び出しで自動的に振り分けが再開されます。再開までの間隔はUDFサーバーの停止時間に応じてバックオフ方式で決定されます。
  • udf-plugin-builder のオプション --grpc-endpoint, --grpc-server-endpoint にもパイプ文字 | 区切りで複数の接続先を指定できるようになりました。
  • 構成定義ファイル tsurugi.ini 上の対応するパラメータにも、パイプ文字 | 区切りで複数の接続先を指定できるようになりました。

Note

UDF機能の詳細仕様や現時点での制約については、 tsurugi-udfの以下のドキュメントを参照してください。

• tsurugi-udf - udf-plugin

また、 tsurugi.ini の詳細については、以下のドキュメントを参照してください。

• tsurugidb - Configuration file parameters

機能追加と改善 - Client

• Tsurugi MCPサーバー
  • 依存する MCP Java SDK のバージョンを 2.0.1 に更新

バグ修正

バグ修正 - SQL

• SQL内の数値リテラルとして扱わない一部の箇所で 2^64 (18446744073709551616) 以上の数値を指定した際に、その数値が 0 として扱われてしまう
• SQL構文エラー発生時に表示される候補リスト表示を改善
• CAST(NULL AS BIT(...)) などの未サポート型を式中で指定すると特定条件下でデータベースが異常終了する
• 主キーを構成する列を DESC でセカンダリインデックスに含めると、そのテーブルへの INSERT が失敗する
• 大量レコードに対する SELECT COUNT(DISTINCT ...) の実行がエラー、またはデータベースが不安定になる
  • Tsurugi 1.11.0 - Known Issues (ja) - TSURUGI-IS-945 に記載する問題に対応しました。

バグ修正 - Authentication & Authorization

• tgctl credentials で生成した認証ファイルの有効期間がデフォルトの90日より短くなり、--expiration オプションも反映されない

バグ修正 - UDF

• tsurugi.ini の [grpc_server] セクションの enabled が false の場合に、UDFのBLOBクライアントからBLOB中継サービスへ接続するとデータベースが異常終了する
• 依存する scikit-build-core のバージョン 1.0.0 へのアップデートに伴い、udf-plugin のインストールが失敗する

アップグレードについて

クライアント互換性リスト

Tsurugi 1.12.0 では 以下のクライアントに対応しています。
Tsurugi のアップグレードに併せて、必要に応じて各クライアントをアップグレードしてください。

Important

Tsurugi UDF については、udf-plugin-builder を用いてUDFプラグインを再生成してデプロイする必要があります。

Client	Version
Tsubakuro/Java	1.16.0+
Iceaxe	1.16.0+
Tanzawa	1.16.0+
Tsubakuro/Rust	0.10.0+
Tsurugi Python DB-API	0.10.0+
Tsurugi MCP Server	0.8.0+
Tsurugi JDBC	0.5.0+
Tsurugi UDF	0.5.0+

アップグレード手順

旧バージョンからのアップグレード手順については、以下のドキュメントを参照してください。

• Tsurugi Upgrade Guide

その他

本バージョンにおける変更内容の一覧は、以下のChangelogを参照してください。

• Tsurugi 1.12.0 - Changelog

本バージョンに対する既知の問題、および本バージョンにて修正された問題の補足情報については、以下のリンクを参照してください。

• Tsurugi 1.12.0 - Known Issues(ja)