ReferenceGlossary

Glossary

Short definitions of the terms used across the Credible docs, from caller and connection to secure given and workspace, each with a link to the page that covers it

Annotation

An annotation is a line in a Malloy model that starts with # and sits directly above the source, field or file it applies to. Credible reads annotations for descriptions, search, access rules and materialization. See Annotations.

Caller

A caller is whoever sends a query: a person in the Credible App, an agent connected over MCP, or a program using an API key. Credible works out who the caller is from how they signed in, or from the group an API key belongs to, and checks every access rule against that identity. See Row and Column Access.

Concept Index

The concept index is the search index Credible builds when a package is published, from its exported sources and fields, their #(doc) descriptions, and the values of dimensions tagged #(index). Agents search it by meaning to find the fields a question needs. See Analyze and Share.

Connection

A connection is a managed link to a database, a warehouse or cloud storage. It belongs to an environment, an environment admin enters its credentials, and every package in the environment can use it without anyone else seeing them. See Connect Data.

Data Model

A data model is the set of Malloy files that says what your data means and how it fits together: sources, joins, dimensions, measures, views and their annotations. Credible is the engine that runs it. See The Data Model.

Dimension

A dimension is a value you group or filter by: a column, or an expression over columns, such as a region or an order month. See The Data Model.

Draft

A draft is a working copy of a package. Nothing in it is served to anyone until it is published, and publishing it creates a new version. See Environments and Packages.

Environment

An environment is where data models are built and published. It holds connections, the packages built on them, and the roles that decide who can use, build in and administer it. See Environments and Packages.

Git-Backed Environment

A git-backed environment stores every package in a GitHub repository, and each publish opens a pull request, so every change is reviewed and versioned in Git. See Git-Backed Environments.

Materialized Table

A materialized table is a source Credible builds as a table because the model marks it with #@ persist. Queries it covers are answered from the table instead of from your database, and its rows are as fresh as its last build. See Materialization and Performance.

Measure

A measure is an aggregate calculation, such as a sum, a count or a ratio, defined on a source. Every query that uses it gets the same definition. See The Data Model.

Package

A package is the unit you build, version and publish together: a data model and everything built on it, such as dashboards, notebooks and data apps. A package lives in one environment. See Environments and Packages.

Report

A report is a dashboard or a notebook, saved as a Malloy file in a package or in a workspace. See Reports.

Secure Given

A secure given is a value Credible fills in from the caller's identity, such as $GROUPS for the caller's groups, ignoring any value the caller sends. Access rules read secure givens. See Secure Givens.

Source

A source is a table, a SQL query or another source, extended with what the model knows about it: its primary key, joins, dimensions, measures and views. See The Data Model.

Version and Latest

Each publish creates a new version of a package, which never changes after it is published. One version is the latest, which everyone gets unless they ask for a specific version. See Publishing and Versions.

View

A view is a named query on a source, for an analysis people run often. See The Data Model.

Workspace

A workspace is where people use published packages in the Credible App. It holds a set of packages, the chats about them, and the reports saved from those chats. Each person has a personal workspace, and teams can share one. See Workspaces.

Next Steps

On this page