Tsurugi 2025年追加機能 - ドキュメンテーションコメント

Tsurugi Advent Calendar 2025の9日目、2025年にTsurugiに追加された機能の紹介です。

Tsurugi 1.4.0で、create table文にドキュメンテーションコメントが書けるようになりました。

通常のコメント /* ～ */ はSQLを実行する際には無視されますが、
ドキュメンテーションコメント /** ～ */ はテーブル定義の一部として保存され、テーブルメタデータを取得すると（tgsqlなら \show table を実行すると）ドキュメンテーションコメントの内容を取得することが出来ます。

/**
 サンプルテーブル
 */
create table example (
  /** プライマリキー */
  pk int primary key,
  /** 値 */
  value varchar
);

他のRDBMSであればcomment文が用意されていたり、create tableの構文の一部としてコメントを登録したりするようになっています。
これに対してTsurugiがドキュメンテーションコメント形式なのは、（Tsurugi MCPサーバー経由で）LLM（いわゆるAI）に対してテーブルやカラムの説明文として渡すという目的が濃いからだと思います。