vsql_allow_preview_extensions = ON が設定されている場合にのみインストールできます。プレビュー層の有効化と機能の登録方法については、プレビュー機能を参照してください。
カラムストレージは、拡張機能が InnoDB に直接カスタム型のバイナリディスクレイアウトを登録できるようにします。これにより、VARBINARYペイロード経由で型のバイトをルーティングするのではなく、カスタム型のディスク形状を直接表現できます。例えば、専用ページに格納される必要のある圧縮浮動小数点配列など、VARBINARYが表現できないディスク形状が必要な場合に使用します。これは新しいストレージレイアウトを可能にする機能追加であり、既存のレイアウトのチューニングスイッチではありません。
機能の宣言
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> を含めます。すべてのページ読み書きはミニトランザクション内で行われます:
create 時に予約されます — セグメントのセットアップパターンについては、上記の「カラムごとのコンテキスト」の create および load 例を参照してください。DML操作中、ルートページからセグメント参照を取得して新しいページを割り当てます:
mtr_ref を書き込み呼び出しに渡します:
ページアクセサは、ヘッダーまたはトレーラー領域内のオフセットを拒否します。リリースビルドは読み取りまたは書き込みをスキップし、
NDEBUG なしのビルドは assert で失敗します。InnoDB はこれらのバイト範囲を自身の管理およびチェックサムに使用しています。