Columns
| Column | Type | Size | Nulls | Auto | Default | Children | Parents | Comments | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | int4 | 10 | √ | null |
|
|
{“what”:“Unique integer identifier for the database record.”,“why”:“Needed to reference the database from other tables (queries, permissions).”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.175641629+00:00”} |
|||||||||||||||||||||||||||||||
| created_at | timestamptz | 35,6 | now() |
|
|
{“what”:“Timestamp when the database record was created.”,“why”:“Needed for auditing and ordering by creation time.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.190835422+00:00”} |
||||||||||||||||||||||||||||||||
| updated_at | timestamptz | 35,6 | now() |
|
|
{“what”:“Timestamp of the last update to this record.”,“why”:“Needed to detect stale configurations and for change tracking.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.203077778+00:00”} |
||||||||||||||||||||||||||||||||
| name | varchar | 254 | null |
|
|
{“what”:“Human-readable name for the database, e.g., ‘Production DB’.”,“why”:“Needed to display and identify the database in UI and logs.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.213655563+00:00”} |
||||||||||||||||||||||||||||||||
| description | text | 2147483647 | √ | null |
|
|
{“what”:“Optional free-text description of the database.”,“why”:“Provides context for users; without it, purpose of the database may be unclear.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.226478205+00:00”} |
|||||||||||||||||||||||||||||||
| details | text | 2147483647 | null |
|
|
{“what”:“JSON string containing connection details (host, port, credentials).”,“why”:“Required to establish a connection; without it, cannot connect.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.258880252+00:00”} |
||||||||||||||||||||||||||||||||
| engine | varchar | 254 | null |
|
|
{“what”:“Database engine type, e.g., ‘postgres’, ‘mysql’.”,“why”:“Determines which driver and SQL dialect to use; without it, connection is impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.287309416+00:00”} |
||||||||||||||||||||||||||||||||
| is_sample | bool | 1 | false |
|
|
{“what”:“Flag indicating if this is Metabase’s sample database.”,“why”:“Distinguishes sample data from user-added databases; used to filter sample data from production.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.300877782+00:00”} |
||||||||||||||||||||||||||||||||
| is_full_sync | bool | 1 | true |
|
|
{“what”:“Flag indicating whether to perform full metadata sync.”,“why”:“Controls whether all tables/columns are synced; without it, sync behavior is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.316097271+00:00”} |
||||||||||||||||||||||||||||||||
| points_of_interest | text | 2147483647 | √ | null |
|
|
{“what”:“Free-text notes about interesting aspects of this database.”,“why”:“Provides context for users; without it, insights may be lost.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.328427079+00:00”} |
|||||||||||||||||||||||||||||||
| caveats | text | 2147483647 | √ | null |
|
|
{“what”:“Free-text warnings or limitations about this database.”,“why”:“Alerts users to known issues; without it, users may make incorrect assumptions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.345310583+00:00”} |
|||||||||||||||||||||||||||||||
| metadata_sync_schedule | varchar | 254 | '0 50 * * * ? *'::character varying |
|
|
{“what”:“Cron expression for when to sync metadata.”,“why”:“Determines how often schema changes are picked up; without it, sync timing is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.371050613+00:00”} |
||||||||||||||||||||||||||||||||
| cache_field_values_schedule | varchar | 254 | √ | NULL::character varying |
|
|
{“what”:“Cron expression for refreshing cached field values.”,“why”:“Controls when field value caches are updated; without it, cache freshness is unpredictable.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.385609225+00:00”} |
|||||||||||||||||||||||||||||||
| timezone | varchar | 254 | √ | null |
|
|
{“what”:“Timezone of the database server.”,“why”:“Needed to interpret timestamps correctly; without it, time-based queries may be off.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.409688014+00:00”} |
|||||||||||||||||||||||||||||||
| is_on_demand | bool | 1 | false |
|
|
{“what”:“Flag indicating if field values are fetched on demand.”,“why”:“Controls caching strategy; without it, performance characteristics are unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.423624496+00:00”} |
||||||||||||||||||||||||||||||||
| auto_run_queries | bool | 1 | true |
|
|
{“what”:“Flag indicating if queries can run automatically.”,“why”:“Controls whether users can run queries without manual approval; without it, behavior is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.443727396+00:00”} |
||||||||||||||||||||||||||||||||
| refingerprint | bool | 1 | √ | null |
|
|
{“what”:“Flag indicating if fingerprinting should be redone.”,“why”:“Used to trigger re-analysis of data; without it, stale fingerprints may persist.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.461099873+00:00”} |
|||||||||||||||||||||||||||||||
| cache_ttl | int4 | 10 | √ | null |
|
|
{“what”:“Time-to-live in seconds for cached query results.”,“why”:“Controls cache expiration; without it, cache behavior is undefined.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.480461402+00:00”} |
|||||||||||||||||||||||||||||||
| initial_sync_status | varchar | 32 | 'complete'::character varying |
|
|
{“what”:“Status of initial metadata sync, e.g., ‘complete’, ‘incomplete’.”,“why”:“Indicates whether the database is ready for querying; without it, readiness is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.496068386+00:00”} |
||||||||||||||||||||||||||||||||
| creator_id | int4 | 10 | √ | null |
|
|
{“what”:“ID of the user who created this database record.”,“why”:“Needed for ownership and audit trails.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.515388032+00:00”} |
|||||||||||||||||||||||||||||||
| settings | text | 2147483647 | √ | null |
|
|
{“what”:“JSON string of additional database-specific settings.”,“why”:“Stores extra configuration not covered by other columns; without it, settings are lost.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.532173206+00:00”} |
|||||||||||||||||||||||||||||||
| dbms_version | text | 2147483647 | √ | null |
|
|
{“what”:“Version string of the database server.”,“why”:“Needed to determine feature compatibility; without it, version-specific behavior is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.546834851+00:00”} |
|||||||||||||||||||||||||||||||
| is_audit | bool | 1 | false |
|
|
{“what”:“Flag indicating if this database is used for audit logging.”,“why”:“Distinguishes audit databases from regular ones; used for special handling.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.562640972+00:00”} |
||||||||||||||||||||||||||||||||
| uploads_enabled | bool | 1 | false |
|
|
{“what”:“Flag indicating if file uploads to this database are allowed.”,“why”:“Controls whether users can upload data; without it, upload capability is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.578609571+00:00”} |
||||||||||||||||||||||||||||||||
| uploads_schema_name | text | 2147483647 | √ | null |
|
|
{“what”:“Schema name where uploaded tables are stored.”,“why”:“Needed to locate uploaded data; without it, uploads cannot be organized.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.601685554+00:00”} |
|||||||||||||||||||||||||||||||
| uploads_table_prefix | text | 2147483647 | √ | null |
|
|
{“what”:“Prefix for table names created by uploads.”,“why”:“Helps identify uploaded tables; without it, naming is ambiguous.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.615175453+00:00”} |
|||||||||||||||||||||||||||||||
| is_attached_dwh | bool | 1 | false |
|
|
{“what”:“Flag indicating if this is an attached data warehouse.”,“why”:“Distinguishes attached DWH from regular databases; used for routing.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.625896312+00:00”} |
||||||||||||||||||||||||||||||||
| router_database_id | int4 | 10 | √ | null |
|
|
{“what”:“ID of the database used for routing queries.”,“why”:“Needed to route queries to the correct database; without it, routing is impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.644893679+00:00”} |
|||||||||||||||||||||||||||||||
| provider_name | varchar | 100 | √ | null |
|
|
{“what”:“Name of the cloud provider, e.g., ‘aws’.”,“why”:“Used for provider-specific features; without it, provider-specific behavior is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.661096138+00:00”} |
|||||||||||||||||||||||||||||||
| workspace_permissions_status | text | 2147483647 | √ | null |
|
|
{“what”:“Status of workspace permissions for this database.”,“why”:“Indicates if permissions are synced; without it, access control may be inconsistent.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.678179616+00:00”} |
|||||||||||||||||||||||||||||||
| write_data_details | text | 2147483647 | √ | null |
|
|
{“what”:“JSON string with write access details (e.g., credentials for writing).”,“why”:“Needed to enable write operations; without it, writes are impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:03:51.692208746+00:00”} |
Indexes
| Constraint Name | Type | Sort | Column(s) |
|---|---|---|---|
| metabase_database_pkey | Primary key | Asc | id |
| idx_metabase_database_creator_id | Performance | Asc | creator_id |
| idx_unique_metabase_database_router_database_id_name | Must be unique | Asc/Asc | router_database_id + name |