metabase_table


Columns

Column Type Size Nulls Auto Default Children Parents Comments
id int4 10 √ null
data_permissions.table_id fk_data_permissions_ref_table_id C
measure.table_id fk_measure_ref_table_id C
metabase_field.table_id fk_field_ref_table_id C
metric.table_id fk_metric_ref_table_id C
query_table.table_id fk_query_table_table_id C
report_card.table_id fk_report_card_ref_table_id C
sandboxes.table_id fk_gtap_table_id C
segment.table_id fk_segment_ref_table_id C
table_privileges.table_id fk_table_privileges_table_id C
workspace_input.table_id fk_workspace_input_table_id N

{“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
metabase_database.id fk_table_ref_database_id C

{“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”}

data_authority 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
collection.id fk_metabase_table_collection_id R

{“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
transform.id fk_metabase_table_transform_id N

{“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

Relationships