Het rapportagegegevensschema begrijpen – Azumuta

Beta. De rapportagedatabase is momenteel in bèta; het schema en de conventies die hier worden beschreven, kunnen nog veranderen.

Waar uw gegevens zich bevinden

Alle gegevens van uw werkruimte bevinden zich in één schema met de naam company_<your-workspace-id>. Elke tabel erin verwijst naar een concept dat u al kent van 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 werkhandleidingen en hun gepubliceerde versies.
`instruction_step`	De afzonderlijke stappen binnen een werkhandleidingversie.
`instruction_visit`, `instruction_total_visit`	Elke keer dat een operator een stap uitvoert, plus totalen per stap.
`recording`, `recording_status`	Uitvoeringssessies (een operator die een handleiding uitvoert) en hun statusgeschiedenis.
`issue`	Verbeteringskwesties / tickets met handige vooraf berekende aantallen.
`issue_task`, `issue_comment`, `issue_attachment`, `issue_signature`, `issue_checklist`	De items die aan een kwestie zijn gekoppeld.
`issue_transition`	De geschiedenis van een kwestie die 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 werkruimte.

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 id van de record 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-timestamp. Om alleen met huidige gegevens te werken, voegt u where deleted_at is null toe aan uw query's.
Timestamps. Elke tabel bevat created_at en modified_at (en deleted_at). Alle timestamps worden opgeslagen in UTC.
Durations 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 handleiding 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.

Het 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 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 Queries.