Koodi muutettu luvuksi
Säilytä tarkka koodi ja testaa alkunollien säilyminen latauksessa.
Perusteelliset käytännön oppaat
Kuvaa rivin taso, sarakkeet, tyypit, yksiköt, puuttuvat arvot ja avaimet ennen laskentaa tai liitosta.
Päivitetty :

Sarakeotsikko ei riitä tiedoston ymmärtämiseen. Sanasto yhdistää kentät määritelmiin, arvojoukkoihin ja skeemaversioon. Erota aineisto sen jakeluista, kuten CSV ja API.
Määritä kohde, alue ja jakso: yritys-vuosi eroaa toimipaikka-kuukaudesta. Ilmoita odotettu yksilöivä avain ja taulujen suhteet.
Kirjaa sarakkeen tarkka nimi, määritelmä, looginen tyyppi, muoto, yksikkö, koodisto, puuttuvuuden sallinta ja alkuperä. Säilytä alkunollaiset tunnukset tekstinä.
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
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ä.
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.
| Kenttä tai sääntö | Testiarvo | Sopimuksen tulkinta | Toimi |
|---|---|---|---|
| record_id: teksti | "0042"; luku 42 | Merkkijono hyväksytään; luku rikkoo tyyppiä | Hylkää 42 keksimättä etunollia. |
| state: täsmällinen koodi | OPEN; open | OPEN hyväksytään; open ei kuulu alueeseen | Älä muuta kirjainkokoa ilman hyväksyttyä sääntöä. |
| amount: luku tai null | 12.5; "12.5"; null; "" | Luku ja null hyväksytään; merkkijonot hylätään | null merkitsee tuntematonta; ei oletusnollaa. |
| Yksilöllinen record_id | Kaksi riviä arvolla "0042" | Avain toistuu, vaikka summat eroavat | Älä hyväksy tulosta; pyydä oikea havaintotaso. |
Avaa jokainen väite ja vertaa sen tulkintaa. Lisätarkistuksia voi silti tarvita.
Ei. Se poistaa poikkeamat näkyvistä ja lisää sopimukseen kuulumattomia oletuksia.
Kyllä. Erota tyyppivirheet, virheelliset koodit ja toistuva avain. Selvitä dokumentaatiosta tai tuottajalta.
Ei. Tämä JSON-sopimus erottaa ne. CSV:llä voi olla toinen erikseen dokumentoitu sääntö.
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äilytä tarkka koodi ja testaa alkunollien säilyminen latauksessa.
Tunnista valuutta, mittakaava ja ajanjakso ennen summia; älä päättele yksikköä suuruudesta.
Katkelman ohjattu tarkastelu
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.
Parin site_id ja year on oltava yksilöllinen. Sama toimipaikka voi esiintyä useana vuonna.
site_id on kolminumeroinen tekstitunnus. amount_kEUR on vuosisumma tuhansina euroina; tyhjä solu tarkoittaa ilmoittamatonta arvoa.
Vertaa avainpareja, säilytä etunollat ja erota nollasumma tuntemattomasta summasta ennen yhdistämistä.
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); uniqueEi. 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
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.
| Rivi | amount |
|---|---|
| A | 1.2 |
| B | 2.5 |
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 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äilytä määritelmä, yksikkö, mittakaava, tarkkuus, puuttumiskoodit ja kelvollinen esimerkki.
Dokumentaatioviite : W3C — CSV on the Web: A Primer · Luettu
DOKUMENTOIDUT TIEDOT
RFC 6901 osoittaa JSON-arvon, ei ole JSONPath tai muokkaus. Lukija käyttää keksittyä opetusesimerkkiä, ei havaintoja, erottaen arvon, puuttuvan polun ja virheellisen syntaksin.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| "" | Root value | Tyhjä merkkijono valitsee koko dokumentin, ei puuttuvaa tulosta. |
| / | Empty member name | Pelkkä vinoviiva valitsee tyhjännimen ominaisuuden, jos se on olemassa, ei juurta. |
| ~1 | / inside member name | Nimen sisäinen vinoviiva koodataan ~1. Avain a/b eroaa a:n sisältämästä b:stä. |
| ~0 | ~ inside member name | Tilde koodataan ~0. Pura ~1 ennen ~0: ~01 tarkoittaa kirjaimellista ~1:tä, ei vinoviivaa. |
| /items/0 | Zero-based array index | Taulukon ensimmäinen indeksi on nolla; ei-negatiivinen kokonaisluku ilman ylimääräisiä alkunollia. |
| /items/01 | Invalid array index | 01 ei ole taulukkoindeksi mutta voi olla tarkka objektin avain. |
| /items/- | No existing array member | Viiva osoittaa viimeisen jälkeiseen olemattomaan kohtaan; luku ei automaattisesti lisää. |
| #/a~1b | URI-fragment form | URI-fragmentti alkaa #:llä ja käyttää URI-purkua. Koodaa prosentti siinä; älä URI-pura tavallista tekstimuotoa. |
Keksitty harjoitusdokumentti: luvut eivät ole havaintoja. Luku on paikallinen ilman pyyntöjä tai muutoksia.
{
"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
0Nimet ovat tarkkoja: välejä ei poisteta eikä aksentteja normalisoida. Lukija ei lisää mitään eikä käsittele JSONPathia.
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.
Ominaisuus on olemassa ja sisältää nullin. Puuttuva ominaisuus ei tuota arvoa; liitoksissa ja taulukoissa ero on olennainen.
Dokumentaatio tarkistettu .
DOKUMENTOIDUT TIEDOT
RFC 8259 määrittää syntaksin, ei rajatonta tarkkuutta. Pitkä numero voi muuttua lukiessa. Esimerkit eivät ole myönnettyjä tunnisteita.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| Integer interoperability | −9007199254740991 … 9007199254740991 | Binary64:n yhteensopiva kokonaislukuväli, ei JSON-syntaksin raja. |
| Beyond 2^53 − 1 | binary64 · 2^53 + 1 | Sen ulkopuolella osa kokonaisluvuista on tarkkoja, kaikki peräkkäiset eivät erotu. |
| "00123" / 123 | "00123" ≠ 123 | Merkkijono "00123" säilyttää nollat, numero 123 ei; koodi ei ole välttämättä määrä. |
| NaN / Infinity | JSON: ✗ | NaN ja Infinity eivät ole JSON-numeroliteraaleja. |
| Duplicate object names | SHOULD | Nimien SHOULD olla yksilöllisiä: lukija säilyttää viimeisen, hylkää tai näyttää kaikki. |
| Network exchange | UTF-8 · RFC 8259 §8.1 | Avoin järjestelmien välinen vaihto vaatii UTF-8:n; se ei estä pyöristystä. |
Päätä tyypit ennen lukua. Pyöristetyn numeron tekstimuunnos ei palauta numeroita. Tunnista toistuvat nimet ennen ylikirjoitusta ja säilytä lähde.
Ei: luvut voivat pyöristyä ja avaimet korvautua. Tarkista myös lähdemuoto.
Dokumentaatio tarkistettu .
Ei: esimerkki näyttää yhden arvon; määritelmä rajaa kaikki sallitut.
Dokumentoi yhteinen skeema ja jakeluerot: nimet, muodot ja null-säännöt.
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
Testaa yksilöllisyys, arvojoukot ja pakolliset kentät oikeassa tiedostossa. Tyhjä merkkijono, ei sovellu ja nolla eroavat. Päivää määritelmä-, koodi- ja tyyppimuutokset.
DOKUMENTOIDUT TIEDOT
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.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| PRIMARY KEY (a) | Yksilöllinen ja ei-NULL | Yksinkertainen pääavain on yksilöllinen ja ei-NULL, ei tosimaailman oikeellisuustodistus. |
| UNIQUE (a) | NULLit erillisiä oletuksena | UNIQUE sallii oletuksena toistuvan NULLin; ei täydellisyyttä. |
| UNIQUE NULLS NOT DISTINCT (a) | Enintään yksi NULL sarakkeessa | NULLS NOT DISTINCT sallii a:ssa enintään yhden NULLin muttei kiellä puuttumista. |
| PRIMARY KEY (a, b) | Yksilöllinen pari · osat ei-NULL | Yhdistelmäavain tekee parin yksilölliseksi, ei kumpaakin osaa erikseen; molemmat ei-NULL. |
| FOREIGN KEY · MATCH SIMPLE | Mikä tahansa NULL voi vapauttaa viitteestä | MATCH SIMPLE voi vapauttaa viitteestä minkä tahansa osan NULLin takia. |
| FOREIGN KEY · MATCH FULL | Vain kaikki NULL vapauttavat | MATCH FULL vapauttaa vain kaikkien ollessa NULL; sekoitus hylätään. Pakollisuus tarvitsee NOT NULLin. |
| CHECK (x > 0) | Tosi tai tuntematon läpäisee | CHECK hyväksyy toden tai tuntemattoman; puuttuva x voi läpäistä x > 0:n. |
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.
| Avainjoukko | UNIQUE | UNIQUE NULLS NOT DISTINCT | PRIMARY KEY |
|---|---|---|---|
| [["001"],["002"]] | Yhteensopiva tämän säännön kanssa | Yhteensopiva tämän säännön kanssa | Yhteensopiva tämän säännön kanssa |
| [["001"],["001"]] | Yhteensopimaton tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa |
| [[null]] | Yhteensopiva tämän säännön kanssa | Yhteensopiva tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa |
| [[null],[null]] | Yhteensopiva tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa |
| [["FR",null],["FR",null]] | Yhteensopiva tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa | Yhteensopimaton tämän säännön kanssa |
| [["FR","001"],["FI","001"]] | Yhteensopiva tämän säännön kanssa | Yhteensopiva tämän säännön kanssa | Yhteensopiva tämän säännön kanssa |
{
"keys": [
[
null
],
[
null
]
]
}Viiteavain ei takaa yksi-yhteen-suhdetta: monta lasta voi viitata samaan emoon. Kirjaa sarakkeet ja NULL-käytäntö. CSV ei siirrä rajoitteita automaattisesti.
Ei: rivitaso, yhdistetyt vuosikerrat tai puuttuvat avainosat voivat erota. Tarkista ensin.
Dokumentaatio tarkistettu .
SYVENTÄVÄ LUKEMINEN / KÄYTÄNTÖ
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 .
Dokumentoi nimi, tyyppi, yksikkö, menetelmät, puuttuvat arvot ja esimerkit. Tunnistaa avaimet ja kentät, joiden merkki riippuu toisesta muuttujasta.
Digitaalinen tyyppi ei tarkoita, että arvoja voidaan lisätä. Koodi voi edustaa luokkaa, tunnistajaa tai puuttuvaa arvoa.
Sanakirja yhdistää alkuperäisen kentän, määritelmän, lukemisen sääntöjen ja dokumenttilähteen. Oletukset erotetaan vahvistetuista määritelmistä.