메인 콘텐츠로 건너뛰기
이 페이지의 기능은 미리보기 단계입니다. 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.로 거부됩니다.

기능 선언

두 개의 미리보기 기능이 함께 작동합니다:
  • vsql::preview::storage — InnoDB 저장소 인프라구조(미니 트랜잭션, 세그먼트, 페이지)에 접근합니다. 파일 범위에서 StorageCapability을 선언합니다.
  • vsql::preview::column_store — 확장 프로그램의 커스텀 유형 중 하나에 대한 저장 구현을 바인딩합니다. make_column_store<Ctx>(TYPE).…build()를 사용하여 파일 범위에서 ColumnStoreCapability을 선언합니다.
둘 다 make_extension()의 .with()에 전달되어야 합니다:
make_column_store<MyCtx>(MY_TYPE)은 구현을 동일한 확장 프로그램에서 등록된 하나의 커스텀 유형과 연결합니다. 모든 7개의 슬롯은 build() 시점에 필수적입니다. 각 슬롯은 InnoDB가 정상 운영 중에 도달하는 고유한 컬럼 라이프사이클 단계를 나타내기 때문입니다.

일곱 개의 저장 함수

모든 함수는 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가 퍼지가 실행될 때까지 삭제된 행을 오래된 스냅샷에서 읽을 수 있도록 유지해야 하기 때문에 구분됩니다.

컬럼별 컨텍스트 및 아레나

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이 반환된 후 자동으로 아레나를 파괴하고 ~MyCtx()를 호출합니다(성공 여부와 무관).

InnoDB 접근 유틸리티

InnoDB 원시 기능을 위해 <villagesql/preview/storage_api.h>를 포함합니다. 모든 페이지 읽기 및 쓰기는 미니 트랜잭션 내에서 발생해야 합니다:
미니 트랜잭션 커밋은 페이지 래치를 해제하고 변경 사항을 영구화하는 redo 로그 기록을 작성합니다. 세그먼트는 create 시 예약됩니다 — 완전한 설정 패턴은 위 컬럼별 컨텍스트의 create 및 load 예제를 참조하세요. DML 작업 중에는 루트 페이지에서 세그먼트 참조를 얻어 새 페이지를 할당합니다:
페이지는 공유 래치로 읽고 배타 래치로 씁니다. InnoDB가 변경 사항을 로깅하도록 mtr_ref를 쓰기 호출에 전달합니다:
페이지 레이아웃 상수: 페이지 접근자는 헤더 또는 트레일러 영역 내부의 오프셋을 거부합니다: 릴리스 빌드는 읽기 또는 쓰기를 건너뛰고, NDEBUG가 없는 빌드는 assert에 실패합니다. InnoDB는 해당 바이트 범위를 자체적인 관리 및 체크섬에 사용합니다.