Het Reporting Database Schema begrijpen – Azumuta

Beta Feature. De Reporting database is momenteel in beta en kan nog steeds evolueren. Deze Feature is momenteel enkel beschikbaar via opt-in. Contacteer uw Azumuta contactpersoon om deel te nemen aan de beta en het uit te proberen.

Waar uw Data zich bevindt

Alle Data van uw Workspace 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 verbeteringsissues / 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 Keys. Elke Tabel heeft een Tekst Primaire Key (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 Data te werken, voegt u where deleted_at is null toe aan uw query's.
Tijden. Elke Tabel bevat created_at en modified_at (en deleted_at). Alle Tijden worden opgeslagen in UTC.
Duraties zijn in milliseconden. Velden zoals actual_duration of rework_time worden opgeslagen als hele milliseconden. Deel door 1000 voor seconden.
Flexibele velden gebruiken JSON. Data die in vorm varieert (zoals parameters of een Instructie answer) wordt 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 metreken — bijvoorbeeld issue.comment_count, issue.open_task_count, of recording.rework_time.

Het 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 met een query lezen:

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.