De Reporting Database Schema begrijpen – Azumuta

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

Waar uw Data zich bevindt

Alle data van uw Workspace bevindt zich in een enkel schema genaamd company_<your-workspace-id>. Elke tabel daarin verwijst naar een concept dat u al kent uit Azumuta.

De hoofdtabellen

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 individuele 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`	Uitvoeringssessies (een operator die een instructie uitvoert) en hun statusgeschiedenis.
`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 bordkolommen beweegt.
`product_order`, `product_order_item`, `product_order_item_spot`	Productieorders 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 tekstprimaire 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 tijdstempel. Om alleen met huidige data 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. Data die in vorm varieert (zoals parameters of een instructie answer) wordt opgeslagen als jsonb, die u kunt bevragen 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.

De ingebouwde gegevenswoordenboek

Elke tabel en elke kolom heeft een voor mensen leesbare beschrijving eraan gekoppeld. De meeste SQL-clients en BI-tools 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.