Columns
| Column | Type | Size | Nulls | Auto | Default | Children | Parents | Comments | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | int4 | 10 | √ | null |
|
|
{“what”:“Unique integer identifier for this table record.”,“why”:“Needed as primary key for referencing from other tables and for updates.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.779679181+00:00”} |
|||||||||||||||||||||||||||||||
| created_at | timestamptz | 35,6 | null |
|
|
{“what”:“Timestamp with time zone when this record was created.”,“why”:“Needed for auditing and ordering by creation time.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.791490859+00:00”} |
||||||||||||||||||||||||||||||||
| updated_at | timestamptz | 35,6 | null |
|
|
{“what”:“Timestamp with time zone of the last update to this record.”,“why”:“Needed for change tracking and optimistic locking.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.806912026+00:00”} |
||||||||||||||||||||||||||||||||
| name | varchar | 256 | null |
|
|
{“what”:“Name of the table as it appears in the source database.”,“why”:“Needed to identify the table in queries and UI.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.820744703+00:00”} |
||||||||||||||||||||||||||||||||
| description | text | 2147483647 | √ | null |
|
|
{“what”:“Free-form text describing the table’s purpose.”,“why”:“Provides context for users; without it, table purpose is unclear.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.833771888+00:00”} |
|||||||||||||||||||||||||||||||
| entity_type | varchar | 254 | √ | null |
|
|
{“what”:“Classification of the table, e.g., ‘table’, ‘view’, ‘question’.”,“why”:“Needed to distinguish table types for UI and permission logic.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.852225176+00:00”} |
|||||||||||||||||||||||||||||||
| active | bool | 1 | null |
|
|
{“what”:“Boolean indicating whether the table is currently active and usable.”,“why”:“Inactive tables are hidden or excluded; without it, stale tables appear.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.867694045+00:00”} |
||||||||||||||||||||||||||||||||
| db_id | int4 | 10 | null |
|
|
{“what”:“Foreign key to the database (Metabase database) this table belongs to.”,“why”:“Needed to associate table with its source database.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.882929520+00:00”} |
||||||||||||||||||||||||||||||||
| display_name | varchar | 256 | √ | null |
|
|
{“what”:“Human-friendly name shown in UI, may differ from ‘name’.”,“why”:“Needed for user-facing labels; without it, raw name may be cryptic.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.902646333+00:00”} |
|||||||||||||||||||||||||||||||
| visibility_type | varchar | 254 | √ | null |
|
|
{“what”:“Controls visibility of table, e.g., ‘normal’, ‘hidden’, ‘technical’.”,“why”:“Needed to filter tables from user views.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.917630727+00:00”} |
|||||||||||||||||||||||||||||||
| schema | varchar | 254 | √ | null |
|
|
{“what”:“Database schema (namespace) containing the table.”,“why”:“Needed to fully qualify table name and avoid ambiguity.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.931250420+00:00”} |
|||||||||||||||||||||||||||||||
| points_of_interest | text | 2147483647 | √ | null |
|
|
{“what”:“Notes about interesting aspects of the table.”,“why”:“Provides guidance to users; without it, insights are lost.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.942780418+00:00”} |
|||||||||||||||||||||||||||||||
| caveats | text | 2147483647 | √ | null |
|
|
{“what”:“Warnings or limitations about the table’s data.”,“why”:“Alerts users to potential issues; without it, data may be misinterpreted.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.961009834+00:00”} |
|||||||||||||||||||||||||||||||
| show_in_getting_started | bool | 1 | false |
|
|
{“what”:“Boolean indicating whether to display this table in the ‘Getting Started’ guide.”,“why”:“Controls onboarding content; without it, new users miss sample tables.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:24.989405298+00:00”} |
||||||||||||||||||||||||||||||||
| field_order | varchar | 254 | 'database'::character varying |
|
|
{“what”:“Ordering scheme for fields, e.g., ‘database’, ‘alphabetical’.”,“why”:“Determines field display order; without it, order is unpredictable.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.006623425+00:00”} |
||||||||||||||||||||||||||||||||
| initial_sync_status | varchar | 32 | 'complete'::character varying |
|
|
{“what”:“Status of initial metadata sync, e.g., ‘incomplete’, ‘complete’.”,“why”:“Needed to know if table metadata is fully loaded.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.023173651+00:00”} |
||||||||||||||||||||||||||||||||
| is_upload | bool | 1 | false |
|
|
{“what”:“Boolean indicating whether this table was created via CSV upload.”,“why”:“Distinguishes user-uploaded tables from database tables.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.036073827+00:00”} |
||||||||||||||||||||||||||||||||
| database_require_filter | bool | 1 | √ | null |
|
|
{“what”:“Boolean indicating whether queries on this table require a filter.”,“why”:“Needed to enforce query safety; without it, expensive queries may run.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.047442232+00:00”} |
|||||||||||||||||||||||||||||||
| estimated_row_count | int8 | 19 | √ | null |
|
|
{“what”:“Approximate number of rows in the table.”,“why”:“Used for query planning and UI display; without it, size unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.066815638+00:00”} |
|||||||||||||||||||||||||||||||
| view_count | int4 | 10 | 0 |
|
|
{“what”:“Number of times this table has been viewed.”,“why”:“Tracks popularity; used for sorting or recommendations.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.083497412+00:00”} |
||||||||||||||||||||||||||||||||
| is_defective_duplicate | bool | 1 | false |
|
|
{“what”:“Boolean indicating whether this table is a defective duplicate of another.”,“why”:“Needed to hide or flag duplicates; without it, confusion arises.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.101641588+00:00”} |
||||||||||||||||||||||||||||||||
| unique_table_helper | varchar | 254 | √ | CASE WHEN (is_defective_duplicate = true) THEN NULL::character varying ELSE COALESCE(schema, ''::character varying) END |
|
|
{“what”:“Helper string to ensure uniqueness of table names across databases.”,“why”:“Needed to avoid name collisions; without it, ambiguous references.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.119140751+00:00”} |
|||||||||||||||||||||||||||||||
| deactivated_at | timestamptz | 35,6 | √ | null |
|
|
{“what”:“Timestamp when table was deactivated.”,“why”:“Needed to know when table became inactive.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.130633851+00:00”} |
|||||||||||||||||||||||||||||||
| archived_at | timestamptz | 35,6 | √ | null |
|
|
{“what”:“Timestamp when table was archived.”,“why”:“Needed to know when table was archived for cleanup.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.143731002+00:00”} |
|||||||||||||||||||||||||||||||
| is_writable | bool | 1 | √ | null |
|
|
{“what”:“Boolean indicating whether the table allows write operations.”,“why”:“Needed to control data modification permissions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.156572376+00:00”} |
|||||||||||||||||||||||||||||||
| varchar | 20 | 'unconfigured'::character varying |
|
|
{“what”:“Authority level for data, e.g., ‘unconfigured’, ‘official’.”,“why”:“Needed to indicate data trustworthiness.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.190145505+00:00”} |
|||||||||||||||||||||||||||||||||
| data_source | varchar | 254 | √ | null |
|
|
{“what”:“Source of the data, e.g., ‘system’, ‘user’.”,“why”:“Needed to understand data origin.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.202618962+00:00”} |
|||||||||||||||||||||||||||||||
| data_layer | varchar | 254 | √ | null |
|
|
{“what”:“Layer in data architecture, e.g., ‘raw’, ‘staging’.”,“why”:“Needed to classify data processing stage.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.223120897+00:00”} |
|||||||||||||||||||||||||||||||
| owner_email | text | 2147483647 | √ | null |
|
|
{“what”:“Email of the user who owns this table.”,“why”:“Needed for ownership and contact.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.238301210+00:00”} |
|||||||||||||||||||||||||||||||
| owner_user_id | int4 | 10 | √ | null |
|
|
{“what”:“Foreign key to the user who owns this table.”,“why”:“Needed to link to user account.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.261869708+00:00”} |
|||||||||||||||||||||||||||||||
| collection_id | int4 | 10 | √ | null |
|
|
{“what”:“Foreign key to the collection this table belongs to.”,“why”:“Needed for organization and permissions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.271093433+00:00”} |
|||||||||||||||||||||||||||||||
| is_published | bool | 1 | false |
|
|
{“what”:“Boolean indicating whether this table is published to a wider audience.”,“why”:“Controls visibility; without it, unpublished tables may be exposed.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.287240966+00:00”} |
||||||||||||||||||||||||||||||||
| transform_id | int4 | 10 | √ | null |
|
|
{“what”:“Foreign key to a transformation definition applied to this table.”,“why”:“Needed to track data transformations.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:25.307241141+00:00”} |
Indexes
| Constraint Name | Type | Sort | Column(s) |
|---|---|---|---|
| metabase_table_pkey | Primary key | Asc | id |
| idx_metabase_table_collection_id | Performance | Asc | collection_id |
| idx_metabase_table_db_deactivated | Performance | Asc/Asc | db_id + deactivated_at |
| idx_metabase_table_db_id_schema | Performance | Asc/Asc | db_id + schema |
| idx_metabase_table_show_in_getting_started | Performance | Asc | show_in_getting_started |
| idx_metabase_table_transform_id | Performance | Asc | transform_id |
| idx_table_db_id | Performance | Asc | db_id |
| idx_uniq_table_db_id_schema_name | Must be unique | Asc/Asc/Asc | db_id + schema + name |
| idx_uniq_table_db_id_schema_name_2col | Must be unique | Asc/Asc | db_id + name |
| idx_unique_table | Must be unique | Asc/Asc/Asc | db_id + name + unique_table_helper |