Skip to content

Automatic translation — the Portuguese version is the reference. View in Portuguese

Updated on 2026-09-08

Essential concepts

The ingestia.io vocabulary — organization, workspace, dataset, source, pipeline, model, dashboard, and report — on one page.

On this page (7)

This page defines, once, the words that appear throughout the rest of the documentation. Read it before moving on to the journey — after that everything goes faster.

Structure and access#

  • Account (user): your login identity (Google, email/password, or corporate SSO, when enabled). One person can belong to several workspaces.
  • Organization: a purely administrative layer that groups N workspaces (useful for agencies, BPOs, and groups with multiple CNPJs). The organization does NOT grant access to data — whoever administers the org (org_admin) does not automatically see the data of any workspace.
  • Workspace: the real unit of isolation. Each workspace has its own datalake, its people, its plan, and its billing. Access to data always requires membership in the specific workspace.
  • Role (RBAC): what you can do — 5 workspace levels (owner ⊇ admin ⊇ member ⊇ viewer) + org_admin. Fail-closed: an unknown role becomes viewer. See Roles (RBAC).
  • Fine-grained permissions: boolean member flags (run pipeline, run queries, export, see PII…) that refine the role.

Data (Ingestia Data)#

  • Source: where data comes from — a file (CSV/Excel), a bucket, a database, or an external service (ERP, Ads, CRM).
  • Landing zone: the platform's file entry area, where the source drops raw data before it becomes a table.
  • Dataset: the workspace's set of tables in the datalake. Each workspace has its own prefix (e.g., aurora) and three medallion datasets: <prefixo>_bronze, <prefixo>_silver, <prefixo>_gold.
  • Medallion (Bronze/Silver/Gold): the three datalake layers — Bronze (raw, as it arrived), Silver (clean and standardized), Gold (datamart ready for BI).
  • Pipeline (source + transformations): the recipe that takes data from landing to Gold. Steps written in plain language are compiled into SQL in a deterministic, versioned way (with a parallel verification run and rollback).
  • Freshness: the age of the data — when it was last updated.
  • Cost guard: a per-query byte ceiling that prevents surprise bills.

Analysis (ingestia.bi)#

  • Semantic model: the central layer of relationships, measures, and formulas (in Portuguese, DAX-style) reused by every dashboard. Grounding AI here is what produces reliable answers.
  • Measure: a reusable calculation (e.g., "Revenue" = sum of valor).
  • Visual / widget: each chart, table, or KPI inside a dashboard.
  • Dashboard (painel): the visualization screen over Gold or the model. Its state is versioned (envelope with a version + N−1 decoder).
  • Snapshot: the materialized picture of the dashboard/report at a point in time. It's what the public page serves — cheap to read, with no processing cost for the owner.
  • Report: a document (dashboard + narrative) generated and sent, typically scheduled, with an immutable public version.
  • Certification: the "official number, already reviewed" badge that the owner places on a table, dashboard, or report. See Lineage.

Explanation and automation (Ingestia AI)#

  • Deterministic: pure calculations (anomaly, forecast, alert) running on our server. They don't send data to an LLM, zero cost, reproducible results.
  • With LLM (Anthropic): text-to-SQL, Q&A, insights, and narrative — they go through egress control and budget.
  • Provenance: the tables/columns/measures the AI used to answer — it's how you check a number.

Distribution#

  • Private link (/d/<slug>): an unguessable, noindex address — "public to whoever has the link".
  • Public dashboard (/painel/<slug>): open-web, indexable content — for those who WANT to publicize it.
  • Report snapshot (/r/<slug>): the immutable public version of the report (the number sent is the number on the page). See Public links and snapshots.

Billing and limits#

  • Usage credits: a balance in BRL that covers cloud consumption (processing + AI).
  • Monthly allowance: credits included in the plan, credited once per cycle.
  • Entitlements: limits per plan (scheduled reports, recipients, refresh modes). See Usage and quotas.
  • Access check ("the money rule"): even with the right role, an expensive action (refresh, export, AI, report) is blocked if the subscription is past due. See Suspension.

Related#


Last reviewed: 2026-09-08.

Related links