Columns
| Column | Type | Size | Nulls | Auto | Default | Children | Parents | Comments | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | int4 | 10 | √ | null |
|
|
{“what”:“Unique numeric identifier for this field record.”,“why”:“Primary key for stable references and joins.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:34.891585442+00:00”} |
|||||||||||||||||||||||||
| created_at | timestamptz | 35,6 | null |
|
|
{“what”:“Timestamp when this field record was created.”,“why”:“Audit trail and ordering of field additions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:34.990097462+00:00”} |
||||||||||||||||||||||||||
| updated_at | timestamptz | 35,6 | null |
|
|
{“what”:“Timestamp of last modification to this field record.”,“why”:“Tracks changes for sync and cache invalidation.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.090900697+00:00”} |
||||||||||||||||||||||||||
| name | varchar | 254 | null |
|
|
{“what”:“Original column name from the database, e.g. ‘user_id’.”,“why”:“Matches physical schema; used for queries and sync.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.217142083+00:00”} |
||||||||||||||||||||||||||
| base_type | varchar | 255 | null |
|
|
{“what”:“Metabase’s generic data type (e.g. type/Integer, type/Text).”,“why”:“Determines default behavior for filtering, aggregation, and display.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.246448821+00:00”} |
||||||||||||||||||||||||||
| semantic_type | varchar | 255 | √ | null |
|
|
{“what”:“Semantic meaning like type/PK, type/FK, type/Category.”,“why”:“Enables smart features like foreign key linking and human-readable labels.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.277963874+00:00”} |
|||||||||||||||||||||||||
| active | bool | 1 | true |
|
|
{“what”:“Whether this field is currently visible and usable in queries.”,“why”:“Hides deprecated or hidden fields without deleting them.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.307988996+00:00”} |
||||||||||||||||||||||||||
| description | text | 2147483647 | √ | null |
|
|
{“what”:“Free-text explanation of the field’s meaning or usage.”,“why”:“Provides context for analysts; shown in UI and docs.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.325356282+00:00”} |
|||||||||||||||||||||||||
| preview_display | bool | 1 | true |
|
|
{“what”:“Whether to show this field in previews and auto-generated charts.”,“why”:“Controls noise in exploratory views; avoids cluttering with irrelevant fields.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.402017869+00:00”} |
||||||||||||||||||||||||||
| position | int4 | 10 | 0 |
|
|
{“what”:“Display order of the field within its table.”,“why”:“Determines column ordering in UI and exports.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.422830949+00:00”} |
||||||||||||||||||||||||||
| table_id | int4 | 10 | null |
|
|
{“what”:“Foreign key to the metabase_table that contains this field.”,“why”:“Associates field with its parent table; essential for schema navigation.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.475027932+00:00”} |
||||||||||||||||||||||||||
| parent_id | int4 | 10 | √ | null |
|
|
{“what”:“Foreign key to a parent field, for nested or structured fields.”,“why”:“Supports hierarchical fields like JSON or nested objects.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.491896009+00:00”} |
|||||||||||||||||||||||||
| display_name | varchar | 254 | √ | null |
|
|
{“what”:“Human-friendly label shown in UI, overrides name if set.”,“why”:“Allows renaming without changing physical column name.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.557813936+00:00”} |
|||||||||||||||||||||||||
| visibility_type | varchar | 32 | 'normal'::character varying |
|
|
{“what”:“Visibility mode: normal, sensitive, hidden, etc.”,“why”:“Controls field exposure in queries and dashboards; enforces data privacy.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.660941760+00:00”} |
||||||||||||||||||||||||||
| fk_target_field_id | int4 | 10 | √ | null |
|
|
{“what”:“Foreign key to the field that this field references (if FK).”,“why”:“Enables automatic joins and semantic understanding of relationships.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.749639622+00:00”} |
|||||||||||||||||||||||||
| last_analyzed | timestamptz | 35,6 | √ | null |
|
|
{“what”:“Timestamp of last metadata analysis (e.g., fingerprinting).”,“why”:“Indicates freshness of field statistics; triggers re-analysis when stale.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.972444960+00:00”} |
|||||||||||||||||||||||||
| points_of_interest | text | 2147483647 | √ | null |
|
|
{“what”:“Notes about interesting aspects of the field’s data.”,“why”:“Captures analyst insights for future users.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:35.999545989+00:00”} |
|||||||||||||||||||||||||
| caveats | text | 2147483647 | √ | null |
|
|
{“what”:“Warnings or limitations about the field’s data quality.”,“why”:“Prevents misinterpretation; alerts users to known issues.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.048957848+00:00”} |
|||||||||||||||||||||||||
| fingerprint | text | 2147483647 | √ | null |
|
|
{“what”:“Serialized summary of field’s data distribution (e.g., min, max, top values).”,“why”:“Powers auto-binning, smart defaults, and data profiling.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.070089107+00:00”} |
|||||||||||||||||||||||||
| fingerprint_version | int4 | 10 | 0 |
|
|
{“what”:“Version number of the fingerprint format.”,“why”:“Ensures compatibility when fingerprint algorithm changes.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.104500141+00:00”} |
||||||||||||||||||||||||||
| database_type | text | 2147483647 | null |
|
|
{“what”:“Native database type as reported by the DB, e.g. ‘varchar’.”,“why”:“Preserves original type for accurate query generation and sync.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.118227825+00:00”} |
||||||||||||||||||||||||||
| has_field_values | text | 2147483647 | √ | null |
|
|
{“what”:“Indicates if field has a list of known values: ‘list’, ‘search’, ‘none’.”,“why”:“Drives filter UI: dropdown vs. search vs. free text.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.150374602+00:00”} |
|||||||||||||||||||||||||
| settings | text | 2147483647 | √ | null |
|
|
{“what”:“JSON-encoded per-field settings (e.g., formatting, currency).”,“why”:“Stores user preferences without schema changes.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.198846835+00:00”} |
|||||||||||||||||||||||||
| database_position | int4 | 10 | 0 |
|
|
{“what”:“Original column position in the database table.”,“why”:“Preserves physical order for sync and diffing.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.214189698+00:00”} |
||||||||||||||||||||||||||
| custom_position | int4 | 10 | 0 |
|
|
{“what”:“User-defined ordering override for display.”,“why”:“Allows custom ordering independent of database order.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.281548981+00:00”} |
||||||||||||||||||||||||||
| effective_type | varchar | 255 | √ | null |
|
|
{“what”:“Computed type after coercion, e.g. type/DateTime from string.”,“why”:“Determines actual behavior when base_type is overridden.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.298734616+00:00”} |
|||||||||||||||||||||||||
| coercion_strategy | varchar | 255 | √ | null |
|
|
{“what”:“Strategy to convert raw data to effective_type (e.g., ‘ConvertToUTC’).”,“why”:“Defines how to parse and transform values for consistency.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.482268138+00:00”} |
|||||||||||||||||||||||||
| nfc_path | varchar | 254 | √ | null |
|
|
{“what”:“Path to nested field in a JSON structure, e.g. ‘$.user.name’.”,“why”:“Identifies subfields for JSON unfolding.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.528248055+00:00”} |
|||||||||||||||||||||||||
| database_required | bool | 1 | false |
|
|
{“what”:“Whether the database marks this column as NOT NULL.”,“why”:“Informs validation and query planning; affects required filters.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.548803434+00:00”} |
||||||||||||||||||||||||||
| json_unfolding | bool | 1 | false |
|
|
{“what”:“Whether to unfold JSON content into separate fields.”,“why”:“Enables querying nested JSON as individual columns.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.636720026+00:00”} |
||||||||||||||||||||||||||
| database_is_auto_increment | bool | 1 | false |
|
|
{“what”:“Whether the database column is auto-incrementing.”,“why”:“Helps identify surrogate keys and default values.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.782062355+00:00”} |
||||||||||||||||||||||||||
| database_indexed | bool | 1 | √ | null |
|
|
{“what”:“Whether the database has an index on this column.”,“why”:“Optimizes query performance; informs index recommendations.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.826828345+00:00”} |
|||||||||||||||||||||||||
| database_partitioned | bool | 1 | √ | null |
|
|
{“what”:“Whether the column is part of a partition key.”,“why”:“Indicates partitioning strategy for query optimization.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.859667682+00:00”} |
|||||||||||||||||||||||||
| is_defective_duplicate | bool | 1 | false |
|
|
{“what”:“Flag for fields that are duplicates or defective from sync.”,“why”:“Allows hiding broken fields while preserving data.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.877952198+00:00”} |
||||||||||||||||||||||||||
| unique_field_helper | int4 | 10 | √ | CASE WHEN (is_defective_duplicate = true) THEN NULL::integer ELSE CASE WHEN (parent_id IS NULL) THEN 0 ELSE parent_id END END |
|
|
{“what”:“Internal helper for unique field detection.”,“why”:“Supports deduplication and uniqueness checks.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.920352015+00:00”} |
|||||||||||||||||||||||||
| database_is_pk | bool | 1 | √ | null |
|
|
{“what”:“Whether the column is a primary key in the database.”,“why”:“Identifies key fields for joins and row identity.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:36.977387362+00:00”} |
|||||||||||||||||||||||||
| database_is_nullable | bool | 1 | √ | null |
|
|
{“what”:“Whether the column allows NULL values in the database.”,“why”:“Informs required filters and data quality checks.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:37.024925016+00:00”} |
|||||||||||||||||||||||||
| database_is_generated | bool | 1 | √ | null |
|
|
{“what”:“Whether the column is generated (computed) by the database.”,“why”:“Prevents writes; indicates read-only nature.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:37.127547946+00:00”} |
|||||||||||||||||||||||||
| database_default | text | 2147483647 | √ | null |
|
|
{“what”:“Default value expression from the database schema.”,“why”:“Shows expected value when not provided; aids data understanding.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:08:37.169874358+00:00”} |
Indexes
| Constraint Name | Type | Sort | Column(s) |
|---|---|---|---|
| metabase_field_pkey | Primary key | Asc | id |
| idx_field_entity_qualified_id | Performance | ||
| idx_field_name_lower | Performance | ||
| idx_field_parent_id | Performance | Asc | parent_id |
| idx_field_table_id | Performance | Asc | table_id |
| idx_unique_field | Must be unique | Asc/Asc/Asc | name + table_id + unique_field_helper |