メインコンテンツへスキップ
このページの機能はプレビュー段階です。API は安定しておらず、これらの機能を宣言する拡張機能は、vsql_allow_preview_extensions = ON が設定されている場合にのみインストールできます。プレビュー層の有効化と機能の登録方法については、プレビュー機能を参照してください。 カラムストレージは、拡張機能が InnoDB に直接カスタム型のバイナリディスクレイアウトを登録できるようにします。これにより、VARBINARYペイロード経由で型のバイトをルーティングするのではなく、カスタム型のディスク形状を直接表現できます。例えば、専用ページに格納される必要のある圧縮浮動小数点配列など、VARBINARYが表現できないディスク形状が必要な場合に使用します。これは新しいストレージレイアウトを可能にする機能追加であり、既存のレイアウトのチューニングスイッチではありません。
カラムストレージはプレビューABIです — 開発中であり、リリース間で変更される可能性があります。現在、行レベルの永続化のみをカバーしています。カスタムストアードカラムはカスタムインデックスのみを受け付け、通常のインデックスは ERROR 3219 (HY000): InnoDB: Indexing for types with column storage is supported only with custom index. で拒否されます。

機能の宣言

2つのプレビュー機能が連携して動作します:
  • vsql::preview::storage — InnoDB ストレージインフラストラクチャ(ミニトランザクション、セグメント、ページ)へのアクセスを提供します。ファイルスコープで StorageCapability を宣言します。
  • vsql::preview::column_store — 型ごとのストレージ実装を、拡張機能のカスタム型の1つにバインドします。make_column_store<Ctx>(TYPE).…build() を使用してファイルスコープで ColumnStoreCapability を宣言します。
両方を make_extension() の .with() に渡す必要があります:
make_column_store<MyCtx>(MY_TYPE) は実装を同じ拡張機能で登録された1つのカスタム型に紐付けます。build() 時に7つのスロットが必要です。各スロットは InnoDB が通常動作中に到達するカラムライフサイクルの異なるポイントに対応します。

7つのストレージ関数

すべての関数は storage::Column::StorageCtx<MyCtx>* を受け取ります。user() アクセサは拡張機能のカラムごとの状態を返し、arena() は補助オブジェクトのサーバー管理割り当てを提供します。すべての関数は成功時に false を返し、エラー時に true を返し、error_msg(容量 error_msg_len)にメッセージを書き込みます。サーバーはそのメッセージをエラーログに書き込みます。create または insert が失敗すると、ステートメントは ERROR 3219 (HY000): InnoDB: Custom type operation failed. See server error log for details. で失敗します。
mark_delete と purge は区別されます。InnoDB MVCC では、削除された行は purge が実行されるまで古いスナップショットで読み取り可能でなければなりません。

カラムごとのコンテキストとアリーナ

C++ SDK は create または load を呼び出す前に MyCtx をデフォルト構築します — 関数が実行される時点で ctx->user() には既に値が設定されています。MyCtx はデフォルト構築可能でなければなりません。C++ SDK は引数なしで T() を呼び出します。 ctx->user() を直接使用して状態を初期化します。ctx->arena().construct<MyCtx>() を呼び出さないでください — これは不要なインスタンスを割り当てますが、ctx->user() はその領域を指していません。
load も同様のパターンです — ctx->user() には既に値が設定されており、storage_ref は create で ctx->set_ref() が格納したパックされた値を保持します:
ctx->arena() は MyCtx に直接埋め込むことができないほど大きいか動的な補助オブジェクトを割り当てる場合にのみ使用します。C++ SDK は、drop が成功したかどうかに関係なく、drop から戻った後にアリーナを自動的に破棄し(~MyCtx() を呼び出し)ます。

InnoDB アクセスユーティリティ

InnoDB プリミティブには <villagesql/preview/storage_api.h> を含めます。すべてのページ読み書きはミニトランザクション内で行われます:
ミニトランザクションのコミットはページラッチを解放し、変更を永続化する redo ログレコードを書き込みます。 セグメント は create 時に予約されます — セグメントのセットアップパターンについては、上記の「カラムごとのコンテキスト」の create および load 例を参照してください。DML操作中、ルートページからセグメント参照を取得して新しいページを割り当てます:
ページ は共有ラッチで読み取り、排他ラッチで書き込みます。InnoDB が変更をログに記録するため、mtr_ref を書き込み呼び出しに渡します:
ページレイアウト定数: ページアクセサは、ヘッダーまたはトレーラー領域内のオフセットを拒否します。リリースビルドは読み取りまたは書き込みをスキップし、NDEBUG なしのビルドは assert で失敗します。InnoDB はこれらのバイト範囲を自身の管理およびチェックサムに使用しています。