report_card


Columns

Column Type Size Nulls Auto Default Children Parents Comments
id int4 10 √ null
action.model_id fk_action_model_id C
card_bookmark.card_id fk_card_bookmark_dashboard_id C
card_label.card_id fk_card_label_ref_card_id C
dashboardcard_series.card_id fk_dashboardcard_series_ref_card_id C
metabot_prompt.card_id fk_metabot_prompt_card_id C
model_index.model_id fk_model_index_model_id C
notification_card.card_id fk_notification_card_card_id C
parameter_card.card_id fk_parameter_card_ref_card_id C
persisted_info.card_id fk_persisted_info_card_id N
pulse_card.card_id fk_pulse_card_ref_card_id C
query_field.card_id fk_query_field_card_id C
query_table.card_id fk_query_table_card_id C
report_card.source_card_id fk_report_card_source_card_id_ref_report_card_id N
report_cardfavorite.card_id fk_cardfavorite_ref_card_id C
report_dashboardcard.card_id fk_dashboardcard_ref_card_id C
sandboxes.card_id fk_gtap_card_id C

{“what”:“Unique integer identifier for the card.”,“why”:“Needed to reference cards from other tables (e.g., dashboard cards, permissions).”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.265215919+00:00”}

created_at timestamptz 35,6 null

{“what”:“Timestamp when the card was created.”,“why”:“Enables audit trails and ordering by creation time.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.292687869+00:00”}

updated_at timestamptz 35,6 null

{“what”:“Timestamp of the last modification to the card.”,“why”:“Tracks staleness and supports optimistic concurrency checks.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.343151787+00:00”}

name varchar 254 null

{“what”:“Human-readable name for the card, e.g., ‘Monthly Revenue’.”,“why”:“Identifies the card in lists and navigation; without it, cards are indistinguishable.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.399378276+00:00”}

description text 2147483647 √ null

{“what”:“Free-text description of the card’s purpose or content.”,“why”:“Provides context for other users; without it, intent may be unclear.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.461866244+00:00”}

display varchar 254 null

{“what”:“Display mode for results, e.g., ‘table’, ‘bar’, ‘line’.”,“why”:“Determines how the query results are rendered; missing it would break visualization.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.629046925+00:00”}

dataset_query text 2147483647 null

{“what”:“Serialized query definition (JSON) including database, query type, and filters.”,“why”:“Core of the card; without it, there is no query to execute.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.710034996+00:00”}

visualization_settings text 2147483647 null

{“what”:“Serialized JSON settings for the chosen display, e.g., column formatting.”,“why”:“Controls how the visualization looks; without it, charts lose custom formatting.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.875596692+00:00”}

creator_id int4 10 null
core_user.id fk_card_ref_user_id C

{“what”:“User ID of the card’s creator.”,“why”:“Enables ownership and permission checks; missing it breaks audit.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:01.939080252+00:00”}

database_id int4 10 null
metabase_database.id fk_report_card_ref_database_id C

{“what”:“ID of the database the query runs against.”,“why”:“Required to execute the query; without it, the card has no data source.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.025264520+00:00”}

table_id int4 10 √ null
metabase_table.id fk_report_card_ref_table_id C

{“what”:“ID of the base table if the query is a simple table query.”,“why”:“Used for metadata and quick query building; may be null for custom queries.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.050184316+00:00”}

query_type varchar 16 √ null

{“what”:“Query type, e.g., ‘query’, ‘native’, ‘mbql’.”,“why”:“Helps parse and validate the query; missing it may break query execution.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.094466996+00:00”}

archived bool 1 false

{“what”:“Flag indicating the card is archived (hidden) but not deleted.”,“why”:“Allows soft deletion without losing data; without it, cards cannot be hidden.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.127658267+00:00”}

collection_id int4 10 √ null
collection.id fk_card_collection_id N

{“what”:“ID of the collection (folder) containing the card.”,“why”:“Organizes cards and controls permissions; missing it leaves card ungrouped.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.157762061+00:00”}

public_uuid varchar 254 √ null

{“what”:“UUID for public sharing link.”,“why”:“Enables unauthenticated access via a secret URL; without it, public sharing is impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.186574944+00:00”}

made_public_by_id int4 10 √ null
core_user.id fk_card_made_public_by_id C

{“what”:“User ID who enabled public sharing.”,“why”:“Audit trail for public links; missing it loses accountability.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.201263293+00:00”}

enable_embedding bool 1 false

{“what”:“Flag indicating the card can be embedded in other apps.”,“why”:“Controls embedding security; without it, embedding would be unrestricted or impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.294630389+00:00”}

embedding_params text 2147483647 √ null

{“what”:“Serialized JSON of allowed embedding parameters (e.g., filters).”,“why”:“Defines which parameters can be passed via embedded URL; missing it breaks embedded interactivity.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.310186362+00:00”}

cache_ttl int4 10 √ null

{“what”:“Time-to-live in seconds for cached query results.”,“why”:“Controls caching behavior; without it, caching falls back to default.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.342919483+00:00”}

result_metadata text 2147483647 √ null

{“what”:“Serialized JSON describing result columns (names, types, formatting).”,“why”:“Used for column-level features like formatting and drill-through; missing it degrades UI.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.373731104+00:00”}

collection_position int2 5 √ null

{“what”:“Numeric position for ordering within the collection.”,“why”:“Controls manual ordering; without it, order is arbitrary.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.402509774+00:00”}

entity_id bpchar 21 √ null

{“what”:“Stable unique identifier (UUID) for the card across environments.”,“why”:“Used for syncing and referencing; missing it breaks external references.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.446615862+00:00”}

parameters text 2147483647 √ null

{“what”:“Serialized JSON of parameters (e.g., field filters) defined for the card.”,“why”:“Enables interactive filters; without them, dashboards lose parameterization.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.486035880+00:00”}

parameter_mappings text 2147483647 √ null

{“what”:“Serialized JSON mapping dashboard parameters to card query parameters.”,“why”:“Connects dashboard filters to card queries; missing it breaks dashboard interactivity.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.524210592+00:00”}

collection_preview bool 1 true

{“what”:“Flag indicating whether the card shows a preview in collection.”,“why”:“Controls performance and UI; without it, previews may be heavy.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.550807599+00:00”}

metabase_version varchar 100 √ null

{“what”:“Metabase version that last saved the card.”,“why”:“Tracks schema/feature compatibility; missing it may cause migration issues.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.567276742+00:00”}

type varchar 16 'question'::character varying

{“what”:“Type of card: ‘question’ or ‘model’ (or others).”,“why”:“Distinguishes saved questions from data models; missing it breaks routing and permissions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.705049265+00:00”}

initially_published_at timestamptz 35,6 √ null

{“what”:“Timestamp when the card was first published (made public).”,“why”:“Audit trail for public sharing; missing it loses history.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.869464306+00:00”}

cache_invalidated_at timestamptz 35,6 √ null

{“what”:“Timestamp when the cache was last invalidated.”,“why”:“Helps manage cache freshness; missing it may serve stale data.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.881541260+00:00”}

last_used_at timestamptz 35,6 CURRENT_TIMESTAMP

{“what”:“Timestamp of the last time the card was viewed or executed.”,“why”:“Used for usage analytics and deprecation decisions.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.903859584+00:00”}

view_count int4 10 0

{“what”:“Number of times the card has been viewed.”,“why”:“Measures popularity; missing it loses usage metrics.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:02.936879414+00:00”}

archived_directly bool 1 false

{“what”:“Flag indicating the card was archived directly, not via a parent.”,“why”:“Distinguishes direct archive from cascade; helps restore logic.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.003475519+00:00”}

dataset_query_metrics_v2_migration_backup text 2147483647 √ null

{“what”:“Backup of dataset_query before migration to metrics v2.”,“why”:“Preserves old query for rollback; missing it risks data loss during migration.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.046579838+00:00”}

source_card_id int4 10 √ null
report_card.id fk_report_card_source_card_id_ref_report_card_id N

{“what”:“ID of the card this card is based on (e.g., for models).”,“why”:“Tracks lineage; missing it breaks dependency analysis.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.067398204+00:00”}

dashboard_id int4 10 √ null
report_dashboard.id fk_report_card_ref_dashboard_id C

{“what”:“ID of the dashboard this card belongs to (if it’s a dashboard card).”,“why”:“Links card to dashboard; missing it breaks dashboard membership.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.097315517+00:00”}

card_schema int4 10 20

{“what”:“Schema version of the card definition.”,“why”:“Enables migrations; missing it breaks versioning.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.210997888+00:00”}

document_id int4 10 √ null
document.id fk_report_card_document_id C

{“what”:“ID of an associated document (e.g., in a knowledge base).”,“why”:“Links card to documentation; missing it loses context.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.250685920+00:00”}

dependency_analysis_version int2 5 0

{“what”:“Version of dependency analysis performed on the card.”,“why”:“Tracks analysis state; missing it may cause stale dependencies.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.287637593+00:00”}

legacy_query text 2147483647 √ null

{“what”:“Serialized legacy query format before migration.”,“why”:“Preserves old query for rollback; missing it risks breaking old cards.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.417012079+00:00”}

embedding_type varchar 50 √ null

{“what”:“Type of embedding, e.g., ‘signed’ or ‘token’.”,“why”:“Determines embedding authentication; missing it breaks embedded access.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.457792266+00:00”}

public_uuid_prefix varchar 36 √ null

{“what”:“Prefix for public UUID, used for short links.”,“why”:“Enables short URLs; missing it may break existing public links.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T04:13:03.479834679+00:00”}

Indexes

Constraint Name Type Sort Column(s)
report_card_pkey Primary key Asc id
idx_card_collection_id Performance Asc collection_id
idx_card_creator_id Performance Asc creator_id
idx_card_public_uuid Performance Asc public_uuid
idx_repord_card_document_id Performance Asc document_id
idx_report_card_card_schema Performance Asc card_schema
idx_report_card_dashboard_id Performance Asc dashboard_id
idx_report_card_database_id Performance Asc database_id
idx_report_card_dependency_analysis_version Performance Asc dependency_analysis_version
idx_report_card_made_public_by_id Performance Asc made_public_by_id
idx_report_card_public_uuid_prefix Performance Asc public_uuid_prefix
idx_report_card_source_card_id Performance Asc source_card_id
idx_report_card_table_id Performance Asc table_id
idx_report_card_type Performance Asc type
report_card_entity_id_key Must be unique Asc entity_id
report_card_public_uuid_key Must be unique Asc public_uuid

Relationships