De Reporting Database Schema begrijpen – Azumuta

Beta feature. De Reporting database is momenteel in Beta en kan nog evolueren. Deze is enkel beschikbaar op opt-in basis. Om deel te nemen aan de Beta of vragen te stellen, neem contact op met support@azumuta.com.

Waar uw Data zich bevindt

Al uw Workspace-gegevens bevinden zich in een enkel schema met de naam company_<your-workspace-id>. Elke tabel erin verwijst naar een concept dat u al kent van Azumuta.

De belangrijkste Tabellen

De exacte set Tabellen hangt af van wat u hebt ingeschakeld. De meest voorkomende zijn:

Tabel	Wat het bevat
`workinstruction`, `workinstruction_version`	Uw werkinstructies en hun Gepubliceerde Versies.
`instruction_step`	De afzonderlijke Stappen binnen een werkinstructie versie.
`instruction_visit`, `instruction_total_visit`	Elke keer dat een Operator een Stap doorloopt, plus per-Stap Totalen.
`recording`, `recording_status`	Uitvoerings Sessies (een Operator die een Instructie uitvoert) en hun Status geschiedenis.
`issue`	Doorlopende verbeterings issues / tickets, met handige vooraf berekende Aantallen.
`issue_task`, `issue_comment`, `issue_attachment`, `issue_signature`, `issue_checklist`	De items die aan een issue zijn gekoppeld.
`issue_transition`	De geschiedenis van een issue dat tussen Bord Kolommen beweegt.
`product_order`, `product_order_item`, `product_order_item_spot`	Productie orders en hun items.
`users`, `user_group`, `user_group_member`	Personen en Groepen in uw Workspace.

Conventies die overal worden gebruikt

Zodra u deze paar Regels kent, wordt het hele schema voorspelbaar:

Primaire sleutels. Elke Tabel heeft een Tekst primaire sleutel (bijvoorbeeld recording_id, issue_id) die overeenkomt met de record-id in Azumuta. U kunt deze gebruiken om gerelateerde Tabellen samen te voegen.
Soft deletes. Rijen worden nooit stilzwijgend verwijderd. Wanneer iets in Azumuta wordt Verwijderd, krijgt de rij in plaats daarvan een deleted_at Tijd. Om alleen met huidige gegevens te werken, voegt u where deleted_at is null toe aan uw query's.
Tijdstempels. Elke Tabel bevat created_at en modified_at (en deleted_at). Alle Tijdstempels worden opgeslagen in UTC.
Duren zijn in milliseconden. Velden zoals actual_duration of rework_time worden opgeslagen als hele milliseconden. Deel door 1000 voor seconden.
Flexibele velden gebruiken JSON. Gegevens die in vorm variëren (zoals parameters of een Instructie answer) worden opgeslagen als jsonb, die u kunt opvragen met PostgreSQL's JSON-operators.
Vooraf berekende waarden. Om u extra joins te besparen, bevatten sommige Tabellen kant-en-klare Aantallen en metrische gegevens — bijvoorbeeld issue.comment_count, issue.open_task_count, of recording.rework_time.

De ingebouwde Data woordenboek

Elke Tabel en elke Kolom heeft een voor mensen leesbare beschrijving eraan gekoppeld. De meeste SQL-clients en BI-gereedschappen tonen deze automatisch. Bijvoorbeeld in psql:

\d+ "company_<your-workspace-id>".issue

U kunt ze ook Lezen met een query:

select column_name, col_description(
    ('company_<your-workspace-id>.issue')::regclass,
    ordinal_position
) as description
from information_schema.columns
where table_schema = 'company_<your-workspace-id>'
  and table_name = 'issue'
order by ordinal_position;

Dit betekent dat u zelden hoeft te raden wat een Kolom betekent — het schema documenteert zichzelf.

Klaar om query's uit te voeren? Zie Voorbeeld Analytics Query's.