Skip to main content

uqa_storage_sqlite/mvcc/native/
layout.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Column and primary-key mappings for the native catalog format. Owner references are retained in row payloads and excluded from object-scoped record identities.
8
9use super::{invalid, NativeRecordFamily};
10use rusqlite::types::ValueRef;
11use uqa_storage::mvcc::VersionResult;
12
13#[derive(Clone, Copy, Debug, PartialEq, Eq)]
14pub enum NativeColumnType {
15    Integer,
16    Real,
17    Text,
18    Blob,
19    /// Text values and binary catalog identities share a physically declared TEXT column.
20    TextOrBlob,
21}
22
23impl NativeColumnType {
24    pub(super) fn declaration(self) -> &'static str {
25        match self {
26            Self::Integer => "INTEGER",
27            Self::Real => "REAL",
28            Self::Text | Self::TextOrBlob => "TEXT",
29            Self::Blob => "BLOB",
30        }
31    }
32
33    pub(super) fn accepts(self, value: ValueRef<'_>) -> bool {
34        matches!(
35            (self, value),
36            (Self::Integer, ValueRef::Integer(_))
37                | (Self::Real, ValueRef::Real(_))
38                | (Self::Text | Self::TextOrBlob, ValueRef::Text(_))
39                | (Self::Blob | Self::TextOrBlob, ValueRef::Blob(_))
40        )
41    }
42}
43
44#[derive(Debug)]
45pub struct NativeRecordLayout {
46    pub family: NativeRecordFamily,
47    pub table: &'static str,
48    pub columns: &'static [&'static str],
49    pub column_types: &'static [NativeColumnType],
50    pub nullable: &'static [bool],
51    pub primary_key: &'static [usize],
52    pub identity_columns: &'static [usize],
53    pub object_owned: bool,
54}
55
56use NativeColumnType::{Blob, Integer, Real, Text, TextOrBlob};
57
58pub(super) const LAYOUTS: &[NativeRecordLayout] = &[
59    NativeRecordLayout {
60        family: NativeRecordFamily::Analyzers,
61        table: "_analyzers",
62        columns: &["name", "config_json", "descriptor_json"],
63        column_types: &[Text, Text, Text],
64        nullable: &[true, false, true],
65        primary_key: &[0],
66        identity_columns: &[0],
67        object_owned: false,
68    },
69    NativeRecordLayout {
70        family: NativeRecordFamily::BtreeIndexEntries,
71        table: "_btree_index_entries",
72        columns: &["table_name", "field", "doc_id", "value_json"],
73        column_types: &[Text, TextOrBlob, Integer, Text],
74        nullable: &[false, false, false, false],
75        primary_key: &[0, 1, 2],
76        identity_columns: &[1, 2],
77        object_owned: true,
78    },
79    NativeRecordLayout {
80        family: NativeRecordFamily::BtreeIndexRepairs,
81        table: "_btree_index_repairs",
82        columns: &["table_name", "field"],
83        column_types: &[Text, TextOrBlob],
84        nullable: &[false, false],
85        primary_key: &[0, 1],
86        identity_columns: &[1],
87        object_owned: true,
88    },
89    NativeRecordLayout {
90        family: NativeRecordFamily::BtreeIndexes,
91        table: "_btree_indexes",
92        columns: &["table_name", "field"],
93        column_types: &[Text, TextOrBlob],
94        nullable: &[false, false],
95        primary_key: &[0, 1],
96        identity_columns: &[1],
97        object_owned: true,
98    },
99    NativeRecordLayout {
100        family: NativeRecordFamily::CacheRevisions,
101        table: "_cache_revisions",
102        columns: &["kind", "name", "generation"],
103        column_types: &[Text, Text, Integer],
104        nullable: &[false, false, false],
105        primary_key: &[0, 1],
106        identity_columns: &[0, 1],
107        object_owned: false,
108    },
109    NativeRecordLayout {
110        family: NativeRecordFamily::CatalogIndexes,
111        table: "_catalog_indexes",
112        columns: &[
113            "schema_name",
114            "relation_name",
115            "kind",
116            "index_type",
117            "table_schema_name",
118            "table_relation_name",
119            "columns",
120            "parameters",
121            "definition",
122        ],
123        column_types: &[Text, Text, Text, Text, Text, Text, Text, Text, Text],
124        nullable: &[false, false, false, false, false, false, false, false, true],
125        primary_key: &[0, 1],
126        identity_columns: &[0, 1],
127        object_owned: false,
128    },
129    NativeRecordLayout {
130        family: NativeRecordFamily::ColumnStats,
131        table: "_column_stats",
132        columns: &[
133            "table_name",
134            "column_name",
135            "distinct_count",
136            "null_count",
137            "min_value",
138            "max_value",
139            "row_count",
140            "histogram",
141            "mcv_values",
142            "mcv_frequencies",
143        ],
144        column_types: &[
145            Text, Text, Integer, Integer, Text, Text, Integer, Text, Text, Text,
146        ],
147        nullable: &[
148            false, false, false, false, true, true, false, false, false, false,
149        ],
150        primary_key: &[0, 1],
151        identity_columns: &[1],
152        object_owned: true,
153    },
154    NativeRecordLayout {
155        family: NativeRecordFamily::DocLengths,
156        table: "_doc_lengths",
157        columns: &["table_name", "doc_id", "field", "length"],
158        column_types: &[Text, Integer, Text, Integer],
159        nullable: &[false, false, false, false],
160        primary_key: &[0, 1, 2],
161        identity_columns: &[1, 2],
162        object_owned: true,
163    },
164    NativeRecordLayout {
165        family: NativeRecordFamily::DocumentBlobs,
166        table: "_document_blobs",
167        columns: &["table_name", "doc_id", "field_name", "bytes"],
168        column_types: &[Text, Integer, Text, Blob],
169        nullable: &[false, false, false, false],
170        primary_key: &[0, 1, 2],
171        identity_columns: &[1, 2],
172        object_owned: true,
173    },
174    NativeRecordLayout {
175        family: NativeRecordFamily::Documents,
176        table: "_documents",
177        columns: &["table_name", "doc_id", "body", "tuple_xmin"],
178        column_types: &[Text, Integer, Text, Integer],
179        nullable: &[false, false, false, true],
180        primary_key: &[0, 1],
181        identity_columns: &[1],
182        object_owned: true,
183    },
184    NativeRecordLayout {
185        family: NativeRecordFamily::FieldStats,
186        table: "_field_stats",
187        columns: &["table_name", "field", "total_length"],
188        column_types: &[Text, Text, Integer],
189        nullable: &[false, false, false],
190        primary_key: &[0, 1],
191        identity_columns: &[1],
192        object_owned: true,
193    },
194    NativeRecordLayout {
195        family: NativeRecordFamily::ForeignServers,
196        table: "_foreign_servers",
197        columns: &["name", "fdw_type", "options"],
198        column_types: &[Text, Text, Text],
199        nullable: &[true, false, false],
200        primary_key: &[0],
201        identity_columns: &[0],
202        object_owned: false,
203    },
204    NativeRecordLayout {
205        family: NativeRecordFamily::ForeignTables,
206        table: "_foreign_tables",
207        columns: &[
208            "schema_name",
209            "relation_name",
210            "kind",
211            "server_name",
212            "columns_json",
213            "options",
214            "role_owner",
215            "acl_json",
216            "column_acls_json",
217        ],
218        column_types: &[Text, Text, Text, Text, Text, Text, TextOrBlob, Text, Text],
219        nullable: &[false, false, false, false, false, false, false, true, false],
220        primary_key: &[0, 1],
221        identity_columns: &[0, 1],
222        object_owned: false,
223    },
224    NativeRecordLayout {
225        family: NativeRecordFamily::GraphEdges,
226        table: "_graph_edges",
227        columns: &[
228            "edge_id",
229            "source_id",
230            "target_id",
231            "label",
232            "properties_json",
233        ],
234        column_types: &[Integer, Integer, Integer, Text, Text],
235        nullable: &[true, false, false, false, false],
236        primary_key: &[0],
237        identity_columns: &[0],
238        object_owned: false,
239    },
240    NativeRecordLayout {
241        family: NativeRecordFamily::GraphMembership,
242        table: "_graph_membership",
243        columns: &["entity_type", "entity_id", "graph_name"],
244        column_types: &[Text, Integer, Text],
245        nullable: &[false, false, false],
246        primary_key: &[0, 1, 2],
247        identity_columns: &[0, 1, 2],
248        object_owned: false,
249    },
250    NativeRecordLayout {
251        family: NativeRecordFamily::GraphPathIndexState,
252        table: "_graph_path_index_state",
253        columns: &["index_key", "graph_name", "definition_json", "valid"],
254        column_types: &[Text, Text, Text, Integer],
255        nullable: &[true, false, false, false],
256        primary_key: &[0],
257        identity_columns: &[0],
258        object_owned: false,
259    },
260    NativeRecordLayout {
261        family: NativeRecordFamily::GraphPathPairs,
262        table: "_graph_path_pairs",
263        columns: &["index_key", "sequence_key", "source_id", "target_id"],
264        column_types: &[Text, Text, Integer, Integer],
265        nullable: &[false, false, false, false],
266        primary_key: &[0, 1, 2, 3],
267        identity_columns: &[0, 1, 2, 3],
268        object_owned: false,
269    },
270    NativeRecordLayout {
271        family: NativeRecordFamily::GraphVertices,
272        table: "_graph_vertices",
273        columns: &["vertex_id", "label", "properties_json"],
274        column_types: &[Integer, Text, Text],
275        nullable: &[true, false, false],
276        primary_key: &[0],
277        identity_columns: &[0],
278        object_owned: false,
279    },
280    NativeRecordLayout {
281        family: NativeRecordFamily::HNSWEdges,
282        table: "_hnsw_edges",
283        columns: &[
284            "table_name",
285            "field",
286            "source_node_id",
287            "layer",
288            "target_node_id",
289        ],
290        column_types: &[Text, Text, Integer, Integer, Integer],
291        nullable: &[false, false, false, false, false],
292        primary_key: &[0, 1, 2, 3, 4],
293        identity_columns: &[1, 2, 3, 4],
294        object_owned: true,
295    },
296    NativeRecordLayout {
297        family: NativeRecordFamily::HNSWIndexes,
298        table: "_hnsw_indexes",
299        columns: &[
300            "table_name",
301            "field",
302            "dimensions",
303            "m",
304            "ef_construction",
305            "ef_search",
306            "rebuild_threshold",
307            "seed",
308            "entry_node_id",
309            "max_level",
310            "next_node_id",
311            "live_count",
312            "deleted_count",
313            "revision",
314            "format_version",
315        ],
316        column_types: &[
317            Text, Text, Integer, Integer, Integer, Integer, Integer, Text, Integer, Integer,
318            Integer, Integer, Integer, Integer, Integer,
319        ],
320        nullable: &[
321            false, false, false, false, false, false, false, false, true, false, false, false,
322            false, false, false,
323        ],
324        primary_key: &[0, 1],
325        identity_columns: &[1],
326        object_owned: true,
327    },
328    NativeRecordLayout {
329        family: NativeRecordFamily::HNSWNodes,
330        table: "_hnsw_nodes",
331        columns: &[
332            "table_name",
333            "field",
334            "node_id",
335            "doc_id",
336            "vector_ordinal",
337            "level",
338            "deleted",
339            "vector",
340        ],
341        column_types: &[
342            Text, Text, Integer, Integer, Integer, Integer, Integer, Blob,
343        ],
344        nullable: &[false, false, false, false, false, false, false, false],
345        primary_key: &[0, 1, 2],
346        identity_columns: &[1, 2],
347        object_owned: true,
348    },
349    NativeRecordLayout {
350        family: NativeRecordFamily::IVFAssignments,
351        table: "_ivf_assignments",
352        columns: &[
353            "table_name",
354            "field",
355            "doc_id",
356            "vector_ordinal",
357            "centroid_id",
358        ],
359        column_types: &[Text, Text, Integer, Integer, Integer],
360        nullable: &[false, false, false, false, false],
361        primary_key: &[0, 1, 2, 3],
362        identity_columns: &[1, 2, 3],
363        object_owned: true,
364    },
365    NativeRecordLayout {
366        family: NativeRecordFamily::IVFCentroids,
367        table: "_ivf_centroids",
368        columns: &["table_name", "field", "centroid_id", "vector"],
369        column_types: &[Text, Text, Integer, Blob],
370        nullable: &[false, false, false, false],
371        primary_key: &[0, 1, 2],
372        identity_columns: &[1, 2],
373        object_owned: true,
374    },
375    NativeRecordLayout {
376        family: NativeRecordFamily::IVFIndexes,
377        table: "_ivf_indexes",
378        columns: &[
379            "table_name",
380            "field",
381            "dimensions",
382            "nlist",
383            "nprobe",
384            "train_threshold",
385            "state",
386            "trained_size",
387            "deletes_since_train",
388            "vector_count",
389        ],
390        column_types: &[
391            Text, Text, Integer, Integer, Integer, Integer, Text, Integer, Integer, Integer,
392        ],
393        nullable: &[
394            false, false, false, false, false, false, false, false, false, false,
395        ],
396        primary_key: &[0, 1],
397        identity_columns: &[1],
398        object_owned: true,
399    },
400    NativeRecordLayout {
401        family: NativeRecordFamily::Metadata,
402        table: "_metadata",
403        columns: &["key", "value"],
404        column_types: &[Text, Text],
405        nullable: &[true, false],
406        primary_key: &[0],
407        identity_columns: &[0],
408        object_owned: false,
409    },
410    NativeRecordLayout {
411        family: NativeRecordFamily::Models,
412        table: "_models",
413        columns: &["name", "body"],
414        column_types: &[Text, Text],
415        nullable: &[true, false],
416        primary_key: &[0],
417        identity_columns: &[0],
418        object_owned: false,
419    },
420    NativeRecordLayout {
421        family: NativeRecordFamily::NamedGraphs,
422        table: "_named_graphs",
423        columns: &["name"],
424        column_types: &[Text],
425        nullable: &[true],
426        primary_key: &[0],
427        identity_columns: &[0],
428        object_owned: false,
429    },
430    NativeRecordLayout {
431        family: NativeRecordFamily::OccurrenceClusters,
432        table: "_occurrence_clusters",
433        columns: &[
434            "table_name",
435            "field",
436            "term",
437            "cluster_id",
438            "posting_count",
439            "score_blob",
440            "positions_blob",
441        ],
442        column_types: &[Text, Text, Blob, Integer, Integer, Blob, Blob],
443        nullable: &[false, false, false, false, false, false, false],
444        primary_key: &[0, 1, 2, 3],
445        identity_columns: &[1, 2, 3],
446        object_owned: true,
447    },
448    NativeRecordLayout {
449        family: NativeRecordFamily::OccurrenceDocuments,
450        table: "_occurrence_documents",
451        columns: &[
452            "table_name",
453            "doc_id",
454            "field",
455            "terms_blob",
456            "metadata_blob",
457        ],
458        column_types: &[Text, Integer, Text, Blob, Blob],
459        nullable: &[false, false, false, false, false],
460        primary_key: &[0, 1, 2],
461        identity_columns: &[1, 2],
462        object_owned: true,
463    },
464    NativeRecordLayout {
465        family: NativeRecordFamily::OccurrenceFields,
466        table: "_occurrence_fields",
467        columns: &[
468            "table_name",
469            "field",
470            "revision",
471            "doc_count",
472            "total_length",
473        ],
474        column_types: &[Text, Text, Blob, Integer, Integer],
475        nullable: &[false, false, false, false, false],
476        primary_key: &[0, 1],
477        identity_columns: &[1],
478        object_owned: true,
479    },
480    NativeRecordLayout {
481        family: NativeRecordFamily::OccurrenceFormats,
482        table: "_occurrence_formats",
483        columns: &["table_name", "format"],
484        column_types: &[Text, Text],
485        nullable: &[false, false],
486        primary_key: &[0],
487        identity_columns: &[],
488        object_owned: true,
489    },
490    NativeRecordLayout {
491        family: NativeRecordFamily::OccurrenceLengths,
492        table: "_occurrence_lengths",
493        columns: &["table_name", "doc_id", "field", "length"],
494        column_types: &[Text, Integer, Text, Integer],
495        nullable: &[false, false, false, false],
496        primary_key: &[0, 1, 2],
497        identity_columns: &[1, 2],
498        object_owned: true,
499    },
500    NativeRecordLayout {
501        family: NativeRecordFamily::PathIndexes,
502        table: "_path_indexes",
503        columns: &["graph_name", "label_sequences"],
504        column_types: &[Text, Text],
505        nullable: &[true, false],
506        primary_key: &[0],
507        identity_columns: &[0],
508        object_owned: false,
509    },
510    NativeRecordLayout {
511        family: NativeRecordFamily::PostingClusters,
512        table: "_posting_clusters",
513        columns: &[
514            "table_name",
515            "field",
516            "term",
517            "cluster_id",
518            "posting_count",
519            "score_blob",
520            "positions_blob",
521        ],
522        column_types: &[Text, Text, Text, Integer, Integer, Blob, Blob],
523        nullable: &[false, false, false, false, false, false, false],
524        primary_key: &[0, 1, 2, 3],
525        identity_columns: &[1, 2, 3],
526        object_owned: true,
527    },
528    NativeRecordLayout {
529        family: NativeRecordFamily::PostingDocuments,
530        table: "_posting_documents",
531        columns: &["table_name", "doc_id", "field", "terms_blob"],
532        column_types: &[Text, Integer, Text, Blob],
533        nullable: &[false, false, false, false],
534        primary_key: &[0, 1, 2],
535        identity_columns: &[1, 2],
536        object_owned: true,
537    },
538    NativeRecordLayout {
539        family: NativeRecordFamily::Relations,
540        table: "_relations",
541        columns: &["schema_name", "relation_name", "kind"],
542        column_types: &[Text, Text, Text],
543        nullable: &[false, false, false],
544        primary_key: &[0, 1],
545        identity_columns: &[0, 1],
546        object_owned: false,
547    },
548    NativeRecordLayout {
549        family: NativeRecordFamily::Schemas,
550        table: "_schemas",
551        columns: &["name", "role_owner", "acl_json"],
552        column_types: &[Text, TextOrBlob, Text],
553        nullable: &[true, false, true],
554        primary_key: &[0],
555        identity_columns: &[0],
556        object_owned: false,
557    },
558    NativeRecordLayout {
559        family: NativeRecordFamily::ScoringParams,
560        table: "_scoring_params",
561        columns: &["name", "params"],
562        column_types: &[Text, Text],
563        nullable: &[true, false],
564        primary_key: &[0],
565        identity_columns: &[0],
566        object_owned: false,
567    },
568    NativeRecordLayout {
569        family: NativeRecordFamily::Sequences,
570        table: "_sequences",
571        columns: &[
572            "schema_name",
573            "relation_name",
574            "kind",
575            "start",
576            "increment",
577            "current",
578            "called",
579            "persistence",
580            "object_id",
581            "data_type",
582            "min_value",
583            "max_value",
584            "cycle",
585            "cache_size",
586            "definition_generation",
587            "owner_table_object_id",
588            "owner_column_object_id",
589            "owner_dependency",
590            "role_owner",
591            "acl_json",
592            "log_count",
593        ],
594        column_types: &[
595            Text, Text, Text, Integer, Integer, Integer, Integer, Text, Blob, Text, Integer,
596            Integer, Integer, Integer, Blob, Blob, Blob, Text, TextOrBlob, Text, Integer,
597        ],
598        nullable: &[
599            false, false, false, false, false, false, false, false, false, false, false, false,
600            false, false, false, true, true, true, false, true, false,
601        ],
602        primary_key: &[0, 1],
603        identity_columns: &[],
604        object_owned: true,
605    },
606    NativeRecordLayout {
607        family: NativeRecordFamily::TableFieldAnalyzers,
608        table: "_table_field_analyzers",
609        columns: &[
610            "table_name",
611            "field",
612            "phase",
613            "analyzer_name",
614            "binding_json",
615        ],
616        column_types: &[Text, Text, Text, Text, Text],
617        nullable: &[false, false, false, false, true],
618        primary_key: &[0, 1, 2],
619        identity_columns: &[1, 2],
620        object_owned: true,
621    },
622    NativeRecordLayout {
623        family: NativeRecordFamily::Tables,
624        table: "_tables",
625        columns: &[
626            "schema_name",
627            "relation_name",
628            "kind",
629            "analyzer",
630            "fts_fields",
631            "vector_fields",
632            "columns",
633            "constraints",
634            "storage_generation",
635            "object_id",
636            "role_owner",
637            "acl_json",
638            "column_acls_json",
639        ],
640        column_types: &[
641            Text, Text, Text, Text, Text, Text, Text, Text, Blob, Blob, TextOrBlob, Text, Text,
642        ],
643        nullable: &[
644            false, false, false, false, false, false, true, false, false, false, false, true, true,
645        ],
646        primary_key: &[0, 1],
647        identity_columns: &[],
648        object_owned: true,
649    },
650    NativeRecordLayout {
651        family: NativeRecordFamily::Vectors,
652        table: "_vectors",
653        columns: &["table_name", "field", "doc_id", "vector_ordinal", "vector"],
654        column_types: &[Text, Text, Integer, Integer, Blob],
655        nullable: &[false, false, false, false, false],
656        primary_key: &[0, 1, 2, 3],
657        identity_columns: &[1, 2, 3],
658        object_owned: true,
659    },
660    NativeRecordLayout {
661        family: NativeRecordFamily::Views,
662        table: "_views",
663        columns: &[
664            "schema_name",
665            "relation_name",
666            "kind",
667            "definition_json",
668            "role_owner",
669            "acl_json",
670            "column_acls_json",
671        ],
672        column_types: &[Text, Text, Text, Text, TextOrBlob, Text, Text],
673        nullable: &[false, false, false, false, false, true, true],
674        primary_key: &[0, 1],
675        identity_columns: &[0, 1],
676        object_owned: false,
677    },
678    NativeRecordLayout {
679        family: NativeRecordFamily::TableOwners,
680        table: "_uqa_mvcc_native_owners",
681        columns: &["name", "object_id", "generation", "catalog_owned"],
682        column_types: &[Text, Blob, Blob, Integer],
683        nullable: &[false, false, false, false],
684        primary_key: &[0],
685        identity_columns: &[0],
686        object_owned: false,
687    },
688    NativeRecordLayout {
689        family: NativeRecordFamily::GraphLookups,
690        table: "_uqa_mvcc_native_graph_lookup",
691        columns: &[
692            "kind",
693            "text_key",
694            "integer_key",
695            "entity_type",
696            "entity_id",
697        ],
698        column_types: &[Text, Text, Integer, Text, Integer],
699        nullable: &[false, false, false, false, false],
700        primary_key: &[0, 1, 2, 3, 4],
701        identity_columns: &[0, 1, 2, 3, 4],
702        object_owned: false,
703    },
704    NativeRecordLayout {
705        family: NativeRecordFamily::OccurrenceSkips,
706        table: "_occurrence_skips",
707        columns: &["table_name", "field", "term", "skip_doc_id", "skip_offset"],
708        column_types: &[Text, Text, Blob, Integer, Integer],
709        nullable: &[false, false, false, false, false],
710        primary_key: &[0, 1, 2, 3],
711        identity_columns: &[1, 2, 3],
712        object_owned: true,
713    },
714    NativeRecordLayout {
715        family: NativeRecordFamily::OccurrenceBlockMax,
716        table: "_occurrence_block_max",
717        columns: &[
718            "table_name",
719            "field",
720            "term",
721            "block_idx",
722            "max_score",
723            "scorer_fingerprint",
724        ],
725        column_types: &[Text, Text, Blob, Integer, Real, Text],
726        nullable: &[false, false, false, false, false, false],
727        primary_key: &[0, 1, 2, 3],
728        identity_columns: &[1, 2, 3],
729        object_owned: true,
730    },
731    NativeRecordLayout {
732        family: NativeRecordFamily::OccurrenceGuards,
733        table: "_uqa_mvcc_native_occurrence_guards",
734        columns: &["table_name", "document_id"],
735        column_types: &[Text, Integer],
736        nullable: &[false, false],
737        primary_key: &[0, 1],
738        identity_columns: &[1],
739        object_owned: true,
740    },
741    NativeRecordLayout {
742        family: NativeRecordFamily::VectorGuards,
743        table: "_uqa_mvcc_native_ivf_guards",
744        columns: &["table_name", "field", "document_id"],
745        column_types: &[Text, Text, Integer],
746        nullable: &[false, false, false],
747        primary_key: &[0, 1, 2],
748        identity_columns: &[1, 2],
749        object_owned: true,
750    },
751];
752
753impl NativeRecordLayout {
754    pub fn validate_values(&self, values: &[ValueRef<'_>]) -> VersionResult<()> {
755        if values.len() != self.columns.len() {
756            return Err(invalid("native row column count does not match its layout"));
757        }
758        for ((value, expected), nullable) in values.iter().zip(self.column_types).zip(self.nullable)
759        {
760            let matches = match value {
761                ValueRef::Null => *nullable,
762                value => expected.accepts(*value),
763            };
764            if !matches {
765                return Err(invalid(
766                    "native row storage class does not match its layout",
767                ));
768            }
769        }
770        Ok(())
771    }
772}