Perusteelliset käytännön oppaat

Laadi käyttökelpoinen tietosanasto

Kuvaa rivin taso, sarakkeet, tyypit, yksiköt, puuttuvat arvot ja avaimet ennen laskentaa tai liitosta.

Päivitetty :

Kannettava näyttää havainnollistavan taulukon vierellään sarakkeita kuvaavia kortteja. Kuvitteellinen näkymä.

Voiko jokaisen arvon tarkistaa määritelmää vasten?

Sarakeotsikko ei riitä tiedoston ymmärtämiseen. Sanasto yhdistää kentät määritelmiin, arvojoukkoihin ja skeemaversioon. Erota aineisto sen jakeluista, kuten CSV ja API.

  1. Määritä rivi

    Määritä kohde, alue ja jakso: yritys-vuosi eroaa toimipaikka-kuukaudesta. Ilmoita odotettu yksilöivä avain ja taulujen suhteet.

  2. Kuvaa jokainen kenttä

    Kirjaa sarakkeen tarkka nimi, määritelmä, looginen tyyppi, muoto, yksikkö, koodisto, puuttuvuuden sallinta ja alkuperä. Säilytä alkunollaiset tunnukset tekstinä.

  3. Testaa ja versioi

    Testaa yksilöllisyys, arvojoukot ja pakolliset kentät oikeassa tiedostossa. Tyhjä merkkijono, ei sovellu ja nolla eroavat. Päivää määritelmä-, koodi- ja tyyppimuutokset.

Tietojen lukemisen työpaja

Asiakirjatietueen sopimus ilman hiljaista korjausta

DEMO-sopimus määrittelee yhden rivin asiaa kohti. Keksityt säännöt eivät kuvaa oikeaa rekisteriä.

Kuvitteellisia tietoja ja merkintöjä oppimista varten: tulokset eivät ole peräisin suorista palvelukyselyistä.

Säilytä saatu arvo ja hylkää poikkeama

Jakelu on JSON: record_id on neljän numeromerkin merkkijono, state on OPEN tai CLOSED ja amount on desimaaliluku tai null. record_id on yksilöllinen. Kirjainkoko ja tyypit kuuluvat sopimukseen.

Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.

Säilytä saatu arvo ja hylkää poikkeama
Kenttä tai sääntöTestiarvoSopimuksen tulkintaToimi
record_id: teksti"0042"; luku 42Merkkijono hyväksytään; luku rikkoo tyyppiäHylkää 42 keksimättä etunollia.
state: täsmällinen koodiOPEN; openOPEN hyväksytään; open ei kuulu alueeseenÄlä muuta kirjainkokoa ilman hyväksyttyä sääntöä.
amount: luku tai null12.5; "12.5"; null; ""Luku ja null hyväksytään; merkkijonot hylätäännull merkitsee tuntematonta; ei oletusnollaa.
Yksilöllinen record_idKaksi riviä arvolla "0042"Avain toistuu, vaikka summat eroavatÄlä hyväksy tulosta; pyydä oikea havaintotaso.

Voiko automaattimuunnos tehdä kaikista riveistä kelvollisia?

Avaa jokainen väite ja vertaa sen tulkintaa. Lisätarkistuksia voi silti tarvita.

Kyllä: muunnetaan numerot, kirjainkoko ja tyhjät

Ei. Se poistaa poikkeamat näkyvistä ja lisää sopimukseen kuulumattomia oletuksia.

Ei: säilytä raaka-arvot ja nimetyt rikkomukset

Kyllä. Erota tyyppivirheet, virheelliset koodit ja toistuva avain. Selvitä dokumentaatiosta tai tuottajalta.

null ja tyhjä merkkijono ovat aina sama asia

Ei. Tämä JSON-sopimus erottaa ne. CSV:llä voi olla toinen erikseen dokumentoitu sääntö.

Kuvitteellinen tarkistuskirjaus

Sopimus: DEMO, rivi asiaa kohti, JSON
record_id: neljän numeromerkin teksti, yksilöllinen avain
state: OPEN tai CLOSED, tarkka kirjainkoko
amount: desimaaliluku tai null; null=tuntematon
Rikkomukset: tyyppi, koodi, tyhjä merkkijono, toistuva avain
Päätös: raakadata säilytetty, tulosta ei hyväksytty

Merkintä tiivistää opetussopimuksen, ei kokonaista suoritettavaa skeemaa. Käyttäjän tiedostoa ei tarkisteta.

Sääntöjen dokumentaatio erillään kuvitteellisista esimerkeistä

Vertaa muita tilanteita ja harjoituksia

Koodi muutettu luvuksi

Säilytä tarkka koodi ja testaa alkunollien säilyminen latauksessa.

Summa ilman yksikköä

Tunnista valuutta, mittakaava ja ajanjakso ennen summia; älä päättele yksikköä suuruudesta.

Katkelman ohjattu tarkastelu

Kolme riviä ja neljä tarkistettavaa sääntöä

Tässä kuvitteellisessa esimerkissä rivi kuvaa toimipaikkaa yhden vuoden ajalta. Alla oleva sanasto määrittää lukusäännöt; aineistossa on tarkoituksellinen virhe.

Kuvitteellinen harjoitus: tunnisteet, arvot ja päivämäärät havainnollistavat tarkistusta. Katkelma ei ole reaaliaikaisesti kerätty vastaus.

  1. Lue avain

    Parin site_id ja year on oltava yksilöllinen. Sama toimipaikka voi esiintyä useana vuonna.

  2. Lue arvot

    site_id on kolminumeroinen tekstitunnus. amount_kEUR on vuosisumma tuhansina euroina; tyhjä solu tarkoittaa ilmoittamatonta arvoa.

  3. Tarkista ennen laskentaa

    Vertaa avainpareja, säilytä etunollat ja erota nollasumma tuntemattomasta summasta ennen yhdistämistä.

Ote ja yksinkertaistettu sanasto

site_id,year,amount_kEUR
007,2024,
007,2025,0
007,2025,12.5

site_id     : string; pattern = ^[0-9]{3}$; required
year        : integer; required
amount_kEUR : decimal; unit = 1000 EUR; empty = unknown
key         : (site_id, year); unique

Mitä tutkitaan

Yhdistelmäavain
Kahdella viimeisellä rivillä on sama pari 007 ja 2025: yksilöllisyys ei toteudu. Älä valitse säilytettävää riviä mielivaltaisesti.
Yksikkö
12.5 tarkoittaa tässä esimerkissä 12 500 EUR ilman valuuttamuunnosta.
Puuttuva arvo
Ensimmäisen rivin tyhjä summa on tuntematon; toisen rivin 0 on ilmoitettu nollasumma.
Voiko summasarakkeen laskea suoraan yhteen?

Perustelu

Ei. Selvitä ensin avaimen kaksoiskappale tuottajan kanssa ja määritä puuttuvien arvojen käsittely. Vain tunnettujen arvojen summa peittäisi tuntemattoman rivin ja voisi laskea saman toimipaikan vuoden kahdesti. Säilytä alkuperäiset rivit ja dokumentoi päätös.

Viralliset lähteet : W3C — Model for Tabular Data and Metadata on the Web

Harjoitus ja ratkaisu

Sanastosta puuttuvat yksikkö ja tarkkuus

Kuvitteellinen esimerkki: arvot ja asiakirjat opettavat menetelmää eivätkä kuvaa todellista organisaatiota.

Tuottajan mukaan amount on tuhansina euroina, yhden desimaalin tarkkuuteen pyöristettynä. Sisäinen sanasto sanoo vain ”numero”; raakasummia ei anneta.

Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.

Lähtötiedot
Riviamount
A1.2
B2.5

Tarkistettavat asiat

  1. Lisää yksikkö, kerroin ja pyöristyssääntö.
  2. Erota tietotyyppi sarakkeen merkityksestä.
  3. Tarkista aiemmat kentän laskelmat.
Lue ratkaisu

Ratkaisu ja päätös

Julkaistu summa on 3.7 tuhatta euroa eli 3 700 euroa. Kirjoitus 3.70 ei lisää tarkkuutta. Määrittele yksikkö ja kerro summan perustuvan pyöristettyihin arvoihin, ei tunnettuihin tarkkoihin summiin.

Jos tilanne muuttuu

Jos pyöristämättömiä määriä saadaan, laske ne erikseen ja tunnista versio. Lisää kuvitteelliseen aineistoon puuttuvan arvon tapaus: amount=0 tarkoittaa tunnettua nollasummaa, mutta tuntematon solu ei anna summaa. Kuvaa puuttuvan arvon koodi ja varmista, ettei tuonti muuta sitä hiljaisesti nollaksi ennen koostamista.

Säilytettävä jälki

Säilytä määritelmä, yksikkö, mittakaava, tarkkuus, puuttumiskoodit ja kelvollinen esimerkki.

Dokumentaatioviite : W3C — CSV on the Web: A Primer · Luettu

DOKUMENTOIDUT TIEDOT

JSON Pointer: erota puuttuva, nolla ja null

RFC 6901 osoittaa JSON-arvon, ei ole JSONPath tai muokkaus. Lukija käyttää keksittyä opetusesimerkkiä, ei havaintoja, erottaen arvon, puuttuvan polun ja virheellisen syntaksin.

items0count/items/0/count → 0
JSON Pointer: erota puuttuva, nolla ja null
ViiteArvo tai muotoMitä se yksilöi
""Root valueTyhjä merkkijono valitsee koko dokumentin, ei puuttuvaa tulosta.
/Empty member namePelkkä vinoviiva valitsee tyhjännimen ominaisuuden, jos se on olemassa, ei juurta.
~1/ inside member nameNimen sisäinen vinoviiva koodataan ~1. Avain a/b eroaa a:n sisältämästä b:stä.
~0~ inside member nameTilde koodataan ~0. Pura ~1 ennen ~0: ~01 tarkoittaa kirjaimellista ~1:tä, ei vinoviivaa.
/items/0Zero-based array indexTaulukon ensimmäinen indeksi on nolla; ei-negatiivinen kokonaisluku ilman ylimääräisiä alkunollia.
/items/01Invalid array index01 ei ole taulukkoindeksi mutta voi olla tarkka objektin avain.
/items/-No existing array memberViiva osoittaa viimeisen jälkeiseen olemattomaan kohtaan; luku ei automaattisesti lisää.
#/a~1bURI-fragment formURI-fragmentti alkaa #:llä ja käyttää URI-purkua. Koodaa prosentti siinä; älä URI-pura tavallista tekstimuotoa.

Lue JSON Pointer opetusesimerkistä

Keksitty harjoitusdokumentti: luvut eivät ole havaintoja. Luku on paikallinen ilman pyyntöjä tai muutoksia.

Opetusdokumentti

{
    "items": [
        {
            "id": "A",
            "count": 0,
            "note": null
        },
        {
            "id": "B",
            "count": 3,
            "note": ""
        }
    ],
    "a/b": {
        "m~n": true
    },
    "": false,
    "01": "code",
    "é": "accent",
    "~1": "literal",
    "c%d": "percent"
}

Alkuesimerkki: /items/0/count antaa 0; /items/0/note nullin; /items/1/note tyhjän merkkijonon; / antaa false.

Arvo löytyi · luku

Valittu arvo

0

Nimet ovat tarkkoja: välejä ei poisteta eikä aksentteja normalisoida. Lukija ei lisää mitään eikä käsittele JSONPathia.

Huomioitavaa aineistossa

Vertaa nimiä tarkasti korjaamatta aksentteja, kirjainkokoa tai välejä. Säilytä null, false, nolla ja tyhjä merkkijono. Oikea syntaksi voi olla ratkaisematta arvoa; älä luo nollaa. Avaimet eivät käänny.

Miksi /items/0/note löytää nullin, mutta toinen polku epäonnistuu?

Ominaisuus on olemassa ja sisältää nullin. Puuttuva ominaisuus ei tuota arvoa; liitoksissa ja taulukoissa ero on olennainen.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

DOKUMENTOIDUT TIEDOT

JSON: kelvollinen teksti voi menettää tunnisteen

RFC 8259 määrittää syntaksin, ei rajatonta tarkkuutta. Pitkä numero voi muuttua lukiessa. Esimerkit eivät ole myönnettyjä tunnisteita.

JSON: kelvollinen teksti voi menettää tunnisteen
ViiteArvo tai muotoMitä se yksilöi
Integer interoperability−9007199254740991 … 9007199254740991Binary64:n yhteensopiva kokonaislukuväli, ei JSON-syntaksin raja.
Beyond 2^53 − 1binary64 · 2^53 + 1Sen ulkopuolella osa kokonaisluvuista on tarkkoja, kaikki peräkkäiset eivät erotu.
"00123" / 123"00123" ≠ 123Merkkijono "00123" säilyttää nollat, numero 123 ei; koodi ei ole välttämättä määrä.
NaN / InfinityJSON: ✗NaN ja Infinity eivät ole JSON-numeroliteraaleja.
Duplicate object namesSHOULDNimien SHOULD olla yksilöllisiä: lukija säilyttää viimeisen, hylkää tai näyttää kaikki.
Network exchangeUTF-8 · RFC 8259 §8.1Avoin järjestelmien välinen vaihto vaatii UTF-8:n; se ei estä pyöristystä.

Huomioitavaa aineistossa

Päätä tyypit ennen lukua. Pyöristetyn numeron tekstimuunnos ei palauta numeroita. Tunnista toistuvat nimet ennen ylikirjoitusta ja säilytä lähde.

Varmistaako JSON.parse pitkät tunnisteet?

Ei: luvut voivat pyöristyä ja avaimet korvautua. Tarkista myös lähdemuoto.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

Säilytettävä näyttö

  • Rivin kohde ja odotettu avain.
  • Määritelmät, tyypit, yksiköt, koodit ja puuttuvuussäännöt.
  • Skeemaversio, tarkistettu tiedosto ja löydetyt poikkeamat.

Viralliset lähteet

Liittyvät lähdesivut

Aiheeseen liittyvät protokollat

Tarkistukset ennen johtopäätöstä

  • Onko odotettu avain yksilöllinen tarkistetussa tiedostossa?
  • Onko tyypit, yksiköt ja puuttuvat arvot määritelty ilman piilo-oletuksia?
  • Kirjataanko poikkeamat sanastosta ennen laskentaa?

Usein kysytyt kysymykset

Riittävätkö esimerkit?

Ei: esimerkki näyttää yhden arvon; määritelmä rajaa kaikki sallitut.

Tarvitaanko versio joka muodolle?

Dokumentoi yhteinen skeema ja jakeluerot: nimet, muodot ja null-säännöt.

Mitä tehdä, jos kentän määritelmä puuttuu?

Tutustu asiakirjoihin ja pidä epävarmuutta. Huomatut arvot voivat auttaa muodostamaan oletuksen, mutta ne eivät aina riitä vahvistamaan merkitystä tai asiaankuuluvia toimia.

TYÖKALUT / REKISTERIT

Kirjattavat tiedot

Testaa yksilöllisyys, arvojoukot ja pakolliset kentät oikeassa tiedostossa. Tyhjä merkkijono, ei sovellu ja nolla eroavat. Päivää määritelmä-, koodi- ja tyyppimuutokset.

  • Katselupäivä ja aikavyöhyke
  • Tarkka URL
  • Versio / tarkistus
  • Rivin kohde
  • Tarkka sarakenimi
  • Looginen tyyppi ja muoto
  • Menetelmä / määritelmä
  • Yksikkö / laskentaperusta
  • Arvojoukko ja koodisto
  • Puuttuvat arvot ja null-sallinta
  • Odotettu avain ja yksilöllisyys
  • Tuottaja / julkaisija
  • Päätös / seuraava toimi
  • Tarkistuksen vastuuhenkilö
  • Seuraava tarkistus

DOKUMENTOIDUT TIEDOT

Avaimet ja rajoitteet takaavat eri asioita

id-kenttä ei automaattisesti ole pääavain. Tarvitaan voimassa olevat rajoitteet. PostgreSQL 18:n säännöt; muut järjestelmät voivat käsitellä NULLia eri tavoin.

[[null], [null]]UNIQUE → ✓UNIQUE NULLS NOT DISTINCT → ✕ · PRIMARY KEY → ✕
Avaimet ja rajoitteet takaavat eri asioita
ViiteArvo tai muotoMitä se yksilöi
PRIMARY KEY (a)Yksilöllinen ja ei-NULLYksinkertainen pääavain on yksilöllinen ja ei-NULL, ei tosimaailman oikeellisuustodistus.
UNIQUE (a)NULLit erillisiä oletuksenaUNIQUE sallii oletuksena toistuvan NULLin; ei täydellisyyttä.
UNIQUE NULLS NOT DISTINCT (a)Enintään yksi NULL sarakkeessaNULLS NOT DISTINCT sallii a:ssa enintään yhden NULLin muttei kiellä puuttumista.
PRIMARY KEY (a, b)Yksilöllinen pari · osat ei-NULLYhdistelmäavain tekee parin yksilölliseksi, ei kumpaakin osaa erikseen; molemmat ei-NULL.
FOREIGN KEY · MATCH SIMPLEMikä tahansa NULL voi vapauttaa viitteestäMATCH SIMPLE voi vapauttaa viitteestä minkä tahansa osan NULLin takia.
FOREIGN KEY · MATCH FULLVain kaikki NULL vapauttavatMATCH FULL vapauttaa vain kaikkien ollessa NULL; sekoitus hylätään. Pakollisuus tarvitsee NOT NULLin.
CHECK (x > 0)Tosi tai tuntematon läpäiseeCHECK hyväksyy toden tai tuntemattoman; puuttuva x voi läpäistä x > 0:n.

Vertaa kolmea sääntöä samoihin avaimiin

JSON-taulukko, jossa on 0–50 riviä; kullakin rivillä 1–3 komponenttia, aina sama määrä. Komponentti on enintään 64 koodipisteen merkkijono tai null. Liitettävien taulujen leveyksien on oltava samat. Enintään 20 000 JSON-merkkiä kentässä. Tyhjä merkkijono on arvo, joka eroaa null-arvosta.

Opetusesimerkkejä ja paikallinen laskenta ilman tietokantakyselyä tai syötteiden lähettämistä. Kirjainkoon huomioiva vertailu ilman välilyöntien poistoa, Unicode-normalisointia tai tyyppimuunnosta. Tulokset kuvaavat vain syötettyjä rivejä eivätkä varmista todellisen tietokannan rajoitteita.

Opetusesimerkki laskettu; muokkaa syötteitä ja tutki ne.

Syötetyt rivit
2
Rivit, joissa vähintään yksi NULL
2
UNIQUE
Yhteensopiva tämän säännön kanssa
UNIQUE NULLS NOT DISTINCT
Yhteensopimaton tämän säännön kanssa
PRIMARY KEY
Yhteensopimaton tämän säännön kanssa
Kuusi opetusjoukkoa: yhteensopivuus säännöittäin
AvainjoukkoUNIQUEUNIQUE NULLS NOT DISTINCTPRIMARY KEY
[["001"],["002"]]Yhteensopiva tämän säännön kanssaYhteensopiva tämän säännön kanssaYhteensopiva tämän säännön kanssa
[["001"],["001"]]Yhteensopimaton tämän säännön kanssaYhteensopimaton tämän säännön kanssaYhteensopimaton tämän säännön kanssa
[[null]]Yhteensopiva tämän säännön kanssaYhteensopiva tämän säännön kanssaYhteensopimaton tämän säännön kanssa
[[null],[null]]Yhteensopiva tämän säännön kanssaYhteensopimaton tämän säännön kanssaYhteensopimaton tämän säännön kanssa
[["FR",null],["FR",null]]Yhteensopiva tämän säännön kanssaYhteensopimaton tämän säännön kanssaYhteensopimaton tämän säännön kanssa
[["FR","001"],["FI","001"]]Yhteensopiva tämän säännön kanssaYhteensopiva tämän säännön kanssaYhteensopiva tämän säännön kanssa
Alkuperäisen opetusesimerkin tiedot
{
    "keys": [
        [
            null
        ],
        [
            null
        ]
    ]
}

Huomioitavaa aineistossa

Viiteavain ei takaa yksi-yhteen-suhdetta: monta lasta voi viitata samaan emoon. Kirjaa sarakkeet ja NULL-käytäntö. CSV ei siirrä rajoitteita automaattisesti.

Oikeuttaako UNIQUE poistamaan viennin toistot?

Ei: rivitaso, yhdistetyt vuosikerrat tai puuttuvat avainosat voivat erota. Tarkista ensin.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

SYVENTÄVÄ LUKEMINEN / KÄYTÄNTÖ

Kuvaile kentät ennen niiden muuntamista

Taulukossa on lyhyitä sarakkeita ja koodeja, joita on vaikea tulkita. Sanakirjan on annettava käyttökelpoinen määritelmä ja säilytettävä epäselvyys ratkaisematta.

Päivitetty .

Ensisijaiset tarkistukset

Dokumentoi nimi, tyyppi, yksikkö, menetelmät, puuttuvat arvot ja esimerkit. Tunnistaa avaimet ja kentät, joiden merkki riippuu toisesta muuttujasta.

Tulkinnan sudenkuopat

Digitaalinen tyyppi ei tarkoita, että arvoja voidaan lisätä. Koodi voi edustaa luokkaa, tunnistajaa tai puuttuvaa arvoa.

Säilytettävä työasiakirja

Sanakirja yhdistää alkuperäisen kentän, määritelmän, lukemisen sääntöjen ja dokumenttilähteen. Oletukset erotetaan vahvistetuista määritelmistä.