Skip to main content

説明

システムの各種コンポーネントに埋め込まれたドキュメントを、1 つのテーブルに集約します。各行は 1 つのエンティティ (関数、テーブルエンジン、データ型など) に対応し、そのエンティティのリファレンスドキュメントを Markdown として格納します。内容は、Web サイトで公開されているものや、種類ごとの system.* テーブルで提供されているものと同一です。 description は、埋め込みドキュメントの構造化された各部分 (descriptionsyntax、引数、例 など) から組み立てられるため、1 つのカラムにエンティティの完全なドキュメントが収まります。埋め込みドキュメントの description にリファレンスページ全体が含まれている場合 (その内容から Web サイトのページが自動生成されるコンポーネント、つまりテーブルエンジン、データベース エンジン、データ型、フォーマット、テーブル関数がこれに該当します)、そのページはそのまま公開され、構造化されたメタデータフィールドから組み立てたセクションは追記されません。ページ本文にすでにその内容が含まれているためです。別名は、正規のエンティティへの短い参照として表示されます。たとえば Alias of `trunc`. のようになります。 このテーブルは、ある意味で、種類ごとのドキュメントテーブル (system.functionssystem.table_enginessystem.data_type_families など) で利用できる情報を集約したものです。特に、client の対話型 help コマンドの基盤となることを想定していますが、それ単体でも有用です。 収集されるエンティティの種類は次のとおりです (括弧内は type カラムの値です) :
  • 関数 (Function)
  • 集約関数 (Aggregate Function)
  • テーブル関数 (Table Function)
  • テーブルエンジン (Table Engine)
  • データベース エンジン (Database Engine)
  • データ型 (Data Type)
  • Dictionary レイアウト (Dictionary Layout)
  • Dictionary ソース (Dictionary Source)
  • 集約関数コンビネータ (Aggregate Function Combinator)
  • データスキッピングインデックスの型 (Data Skipping Index)
  • ディスクタイプ (Disk Type)
  • 設定 (Setting)
  • MergeTree 設定 (MergeTree Setting)
  • サーバー設定 (Server Setting)
  • フォーマット (Format)
  • 圧縮コーデック (Compression Codec)
  • プロファイルイベント (Profile Event)
  • 現在のメトリクス (Current Metric)
  • 非同期メトリクス (Asynchronous Metric)
  • システムテーブル (System Table)
設定 (あらゆる種類) については、その設定の説明に加えて、型とデフォルト値もドキュメントとして格納されます。廃止された設定は公開されません。システムテーブルについては、テーブルコメントに加えて、そのカラムの一覧 (各カラムの名前、型、説明) がドキュメントとして格納されます。 source カラムには、エンティティのドキュメントが定義されているソースファイルのパスが、リポジトリルートからの相対パスで格納されます。ほとんどのエンティティでは、ドキュメントオブジェクトが構築される場所 (コンポーネントの登録箇所) で自動的に取得されます。種類ごとに単一のソースファイルでドキュメント化されているもの (設定、プロファイルイベント、現在のメトリクスなど) については、そのファイルが格納されます。

カラム

特定のエンティティに関するドキュメントを参照してください。
Query
同じ名前が複数の種類のエンティティを指すことがあります (たとえば、file table function と file Dictionary ソース の両方があります) 。そのため、あらゆる種類をまたいで名前を調べられると便利です。
Query
各種類ごとに、文書化されているエンティティの数を数えます:
Query

関連項目

Last modified on July 23, 2026