Datakontrakter

Datakontrakten skrives fra modellen.

En datakontrakt i Specly er tabellen slik dere har modellert og dokumentert den – kolonner, datatyper, beskrivelser og status – skrevet som en ODCS-fil som konsumentene kan lese og teste mot.

dim_kunde.odcs.yaml
apiVersion: v3.2.0
kind: DataContract
id: dim_kunde
name: dim_kunde
version: 1.0.0
status: active
schema:
- name: dim_kunde
  physicalType: table
  description: Én rad per kunde, samordnet på tvers av CRM og nettbutikk.
  customProperties:
  - property: eier
    value: Kundeteamet
  properties:
  - name: kunde_id
    description: Primærnøkkel, unik kunde-ID
    logicalType: string
    physicalType: uuid
    primaryKey: true
    primaryKeyPosition: 1
  - name: epost
    description: Primær e-postadresse
    logicalType: string
    physicalType: text
  - name: er_aktiv
    description: Sann hvis kunden har betalt for minst én ordre de siste tolv månedene
    logicalType: boolean
    physicalType: boolean
Slik henger det sammen

Fra modell til kontrakt i tre steg.

  1. 1

    Modeller og dokumenter

    Tabeller, kolonner, datatyper og beskrivelser lages i Specly, der teamet allerede arbeider med modellen. Kontrakten bygges fra det som står der.

  2. 2

    Bestem hva som blir hva

    Dere bestemmer selv hvilke felt i Specly som tilsvarer hvilke felt i ODCS. Verdier uten kobling blir med som egne egenskaper i kontrakten, så ingenting går tapt.

  3. 3

    Lever til Git

    Hver tabell skrives som én .odcs.yaml og hvert dataprodukt som én .odps.yaml, i samme branch som koden.

Standard, ikke eget format

Kontrakter andre verktøy kan lese.

Spørsmål og svar

Det mange lurer på.

Hva er en datakontrakt?
En datakontrakt beskriver hva en tabell inneholder, slik at de som bruker dataene kan stole på det: hvilke kolonner den har, hvilke datatyper de har og hva de betyr. I Specly skrives den fra modellen, så den beskriver det teamet faktisk har modellert.
Hva er ODCS?
Open Data Contract Standard (ODCS) er en åpen standard for datakontrakter, skrevet som YAML. Dataprodukter dekkes av en egen standard, Open Data Product Standard (ODPS).
Må vi bruke ODCS?
Nei. Formatet for Git-eksporten velges per prosjekt: Specly JSON, ODCS-kontrakter eller begge deler.
Hvilken versjon av ODCS bruker Specly?
Specly skriver ODCS 3.2. Hver kontrakt starter med apiVersion: v3.2.0 og kind: DataContract.

Se Specly i bruk.

Fortell oss hvordan dere jobber i dag, så viser vi hvordan Specly kan passe inn.

Book en demohei@specly.no