Tunnisteet muuttuvat avattaessa
Ohjelma tulkitsee sarakkeen numeroiksi ja pudottaa alkunollat. Palaa raakavientiin, aseta avain tekstiksi ja tarkista yhdistelyt. Muuttuneen arvon ulkoasun korjaus ei aina palauta alkuperäistä tunnistetta.
Perusteelliset käytännön oppaat
Yhdistä lähdetiedosto, päivämäärät, rakenne ja muunnokset, jotta aineisto voidaan löytää, vertailla ja käyttää uudelleen erottamalla päivitys, korjaus ja rajauksen muutos.
Päivitetty :

Tekoälyllä luotu kuvitus
Linkki muuttuvaan tietokantaan ei määritä käytettyjä tietoja. Korjaus voi muuttaa vanhoja sarjoja, vienti pudottaa alkunollat ja uusi sarake muuttaa summan merkitystä. Hyödyllinen versio selittää lähtöaineiston ja käsittelyn. Tavoite on kuvatun työn toistettavuus, ei yleinen takuu lähteen laadusta.
Nimeä tuottaja, aineisto, alue, väestö, ajanjakso ja suodattimet. Erota havainto-, julkaisu- ja latauspäivät. Tänään saatu tiedosto voi kuvata vanhaa jaksoa. Kirjaa kysymys ja tulkinnalle tärkeät poissulut.
Kirjaa osoite tai julkiset parametrit, hakupäivä ja saatu tiedosto ehtojen salliessa. Anna versiotunniste ja laske tiedoston tiiviste. Tiiviste erottaa tiedostoja, mutta ei osoita arvojen oikeellisuutta. Säilytä lisenssitiedot.
Dokumentoi kentät, tyypit, yksiköt, avaimet ja puuttuvat arvot. Tarkista CSV:n erotin, merkistö, lainausmerkit ja rivinvaihdot todellisesta viennistä. Säilytä alkunollia tarvitsevat tunnisteet tekstinä. Erota nolla, puuttuva ja soveltumaton arvo.
Kirjaa suodatus, normalisointi, yhdistely, konversiot ja kaksoiskappaleiden käsittely järjestyksessä. Erota raakasyöte valmistellusta tuloksesta. Säilytä yhdistelyavaimet ja ratkaisemattomat tapaukset. Samankaltainen nimi ei oikeuta yhdistämään toimijoita. Tee valinnat näkyviksi.
Mittaa lisätyt, poistetut ja muuttuneet rivit vakaalla avaimella, jos sellainen on. Tarkista myös rakenne, yksiköt ja määritelmät. Rivimäärän muutos ei osoita ilmiön muutosta: syynä voivat olla suodatus, kattavuus tai tuottajan tarkistus.
Yhdistä tulos lähdeversioon, vaiheisiin ja rajoihin. Tarkista linkit tuottajaan ja asiayhteyteen. Valmistele uusi keruu vertailukriteereineen. Säilytä aiempaa julkaistua johtopäätöstä tukeva vanha versio erikseen sen ehtoja ja tietoja kunnioittaen.
Tietojen lukemisen työpaja
DEMO-aineisto on kuvitteellinen. Sen versiot erottavat historiallisen analyysin korjattua dataa käyttävästä analyysistä.
Kuvitteellisia tietoja ja merkintöjä oppimista varten: tulokset eivät ole peräisin suorista palvelukyselyistä.
Tiedostoissa ovat sama avain ja ajanjakso. Kuvitteellinen tuottaja julkaisee korjausmerkinnän. Myöhempi luettelokuvauksen muutos ei muuta CSV:tä.
Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.
| Kuvitteellinen tila | Saatavilla oleva aineisto | Mikä muuttuu | Ilmoitettava käyttö |
|---|---|---|---|
| v1 saatavilla huhtikuussa | Arvo 80 tutkittavalle avaimelle | Julkaistu tila ennen korjausta | Huhtikuussa saatavilla ollutta kuvattaessa viittaa v1:een. |
| v2 julkaistu kesäkuussa | Korjattu arvo 82 ja tarkistusmerkintä | Menneen havainnon korjaus, ei uusi tapahtuma | Tarkistetussa analyysissä viittaa v2:een ja ilmoita korjaus. |
| Kuvaus muokattu v2:n jälkeen | Kuvaus selvennetty, CSV esimerkissä sama | Vain metatiedot | Älä päättele uutta arvoa kuvauksen päiväyksestä. |
| Molemmat analyysit säilytetty | Historiallinen tulos v1:llä; tarkistettu v2:lla | Ajallinen kysymys ja lähdeversio | Älä sekoita versioita ilmoittamatta. |
Avaa jokainen väite ja vertaa sen tulkintaa. Lisätarkistuksia voi silti tarvita.
Ei. Vanha versio voi selittää silloin julkaistun päätelmän.
Kyllä. Erota huhtikuussa tiedetty kesäkuussa tarkistetusta analyysistä; liitä tulokset syötteeseensä.
Ei. Se koskee vertailtuja tavuja, ei luvun oikeellisuutta tai edustavuutta.
Aineisto: DEMO; avain ja jakso ennallaan v1: saatavilla huhtikuussa; arvo=80 v2: julkaistu kesäkuussa; korjattu arvo=82 Syy: kuvitteellisen tuottajan dokumentoima korjaus Myöhempi kuvaus: vain teksti, CSV ennallaan Tulokset: historiallinen liittyy v1:een; tarkistettu v2:een
Kirjaus säilyttää molemmat analyysikysymykset. Tiivisteet tunnistavat käytetyt tiedostot tekemättä tallennetusta versiosta totta.
Ohjelma tulkitsee sarakkeen numeroiksi ja pudottaa alkunollat. Palaa raakavientiin, aseta avain tekstiksi ja tarkista yhdistelyt. Muuttuneen arvon ulkoasun korjaus ei aina palauta alkuperäistä tunnistetta.
Uusi tiedosto korvaa myös vanhoja arvoja. Vertaa jaksoittain ja avaimittain, säilytä versiot ja lue tuottajan huomautukset. Erota tarkistukset uusista havainnoista ennen trendin kuvaamista.
Kattavuuteen lisättiin alueita tai luokkia. Vertaa yhteistä rajausta ja esitä laajennus erikseen. Kirjaa kenttien muutokset ja puuttuvat tiedot olettamatta kaikkia rivejä vertailukelpoisiksi.
Kuvitteellinen esimerkki: A muuttuu arvosta 10 arvoon 11, B poistuu ja C lisätään. Avaimella id saadaan yksi lisätty avain, yksi poistettu avain ja yksi muuttunut yhteinen tietue. Uusi sarake luetellaan erikseen ilman keksittyä aiempaa arvoa. Pelkkä järjestyksen muutos ei muuta tulosta.
Harjoitus ja ratkaisu
Kuvitteellinen esimerkki: arvot ja asiakirjat opettavat menetelmää eivätkä kuvaa todellista organisaatiota.
Avaimet ovat yksilöllisiä, arvot summattavia ja sanasto ennallaan. Poistoja ei ole; puuttuminen tarkoittaa avaimen puuttumista versiosta.
Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.
| Avain | Versio V1 | Versio V2 |
|---|---|---|
| A | 10 | 10 |
| B | 20 | 25 |
| C | Puuttuu | 5 |
V1:n summa on 30 ja V2:n 40: +10. Yhteisillä avaimilla B:n tarkistus selittää +5; uusi C lisää +5. A on ennallaan. Kokonaissumman 33,33 %:n kasvua ei pidä selittää kokonaan aiempien kohteiden kasvulla.
Jos V2 muuttaa yksikköä tai määritelmää, keskeytä erittely kunnes vertailukelpoisuus tarkistetaan.
Säilytä viennit ja tiivisteet, sanastot, lisätyt/muuttuneet avaimet ja täsmäytyskaava.
Säilytä työlle ja julkaistuille päätelmille tarpeelliset versiot määritellyn säännön mukaan. Vältä tarkoituksettomia kopioita ja noudata säilytys- ja käyttöehtoja.
Ei. Se tunnistaa tiedoston sisältöä ja muutoksia, mutta ei vahvista alkuperää, tulkintaa tai arvoja.
Tarkista avaimet, asiayhteys ja samannimiset ensin. Säännön on käsiteltävä epäselvyydet ja kirjattava yhdistelyt.
Ilmoita versio ja korjaus erottaen tarkistettu tulos aiemmasta. Älä esitä tarkistusta uutena havaintona.
Sama tunniste kahdella rivillä tekee yhdistämisestä epäselvää. Tarkista tarkkuustaso, ajanjakso ja alkuperä; määritä tarvittaessa yhdistelmäavain. Älä poista riviä ennen kuin erotat kaksoiskappaleen erillisestä havainnosta.
Tiedosto, sen alkuperä, päivämäärä, jäljennös ja hyödyllinen asiakirja. Liittämällä jalostuksen säännöt ja viittaus tuotteiden tuloksiin helpottaa jälkeistä toistamista ja vertailua.
DOKUMENTOIDUT TIEDOT
W3C:n PROV-O kuvaa tiedon alkuperää. Nuolet seuraavat ominaisuuksia, eivät vasemmalta oikealle kulkevaa aikaa. E0, A ja E1 ovat opetusnimiä.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| prov:Entity | Tieto/dokumentti kuvatussa tilassa | Entity on kuvatussa tilassa oleva tieto; erota versiot muuttuvan URL:n sijaan. |
| prov:Activity | Ajallinen prosessi | Activity on ajallinen prosessi, ei sen tulos. |
| prov:Agent | Henkilö, organisaatio tai ohjelmistoagentti | Agent kantaa vastuuta. wasAttributedTo yhdistää entiteetin agenttiin, wasAssociatedWith toiminnan agenttiin; ei lisenssitodistus. |
| prov:used | Activity → Entity | used kulkee toiminnasta entiteettiin: A käyttää E0:aa. |
| prov:wasGeneratedBy | Entity → Activity | wasGeneratedBy kulkee tuloksesta toimintaan: A generoi E1:n. |
| prov:wasDerivedFrom | Entity → Entity | wasDerivedFrom kulkee tuloksesta lähteeseen ilman kaavaa, painoja tai oikeellisuustodistusta. |
| prov:wasRevisionOf | Entity → Entity | Revision säilyttää olennaista alkuperäissisältöä; viittaus ei aina ole revisio. |
| prov:wasQuotedFrom | Entity → Entity | Katkelma toistetaan laajemmasta lähteestä. Säilytä tarkka sanamuoto ja sijainti: pelkkä suhde ei paikanna sanoja. |
Neljä kuvitteellista tapausta osoittaa, miksi suhteen pitää kuvata todellista muunnosta. Tulos on suhteen subjekti, lähde tai toimija on oikealla.
quote → prov:wasQuotedFrom → source-v1
Katkelma toistetaan laajemmasta lähteestä. Säilytä tarkka sanamuoto ja sijainti: pelkkä suhde ei paikanna sanoja.
translation → prov:wasDerivedFrom → source-v1
Käännös on uusi johdettu entiteetti. Säilytä lähtö- ja kohdekieli, versio ja uskollisuuden tarkistus; erota käännös alkuperäisestä katkelmasta.
source-v2 → prov:wasRevisionOf → source-v1
Korjattu versio säilyttää olennaista sisältöä edeltäjästään. Säilytä molemmat tilat ja muutokset; suhde ei ratkaise, kumpi versio on oikea.
analysis → prov:wasAttributedTo → editor
Entiteetti liitetään toimijaan. Prosessin vastuuta kuvaa Activity → prov:wasAssociatedWith → Agent. Tekijän nimeäminen ei vahvista uudelleenkäyttöoikeuksia.
Alkuperätieto kuvaa ilmoitettua ketjua. Se ei tee käännöksestä riippumatonta näyttöä eikä tekijätiedosta sisällön tarkistusta.
Kuvaa tunnettu keksimättä puuttuvaa. Alkuperä ei automaattisesti vahvista laskua, oikeuksia tai aitoutta. Säilytä versiot ja lähteet.
Ei: tarvitaan versiot, suodattimet, kaava, parametrit ja puuttuvuussäännöt.
Dokumentaatio tarkistettu .
DOKUMENTOIDUT TIEDOT
Vastaanotettujen pituuksien summa voi peittää keskeneräisen siirron: päällekkäisyys laskee samat paikat useasti. Laske välien unioni ja vertaa sitä aiottuun esitykseen. Geometrinen tarkistus ei korvaa tavujen ja alkuperän tarkistamista.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| 0-399,300-599,700-999 | Σ = 1000; ∪ = 900 | Kun L = 1 000, osat 0–399, 300–599 ja 700–999 sisältävät yhteensä 1 000 ilmoitettua tavua. Unioni kattaa vain 900 paikkaa: 600–699 puuttuu ja 100 tavun vastaanottoa on ylimääräisiä. |
| 0-499,500-999 | ∪ = 1000 | Vierekkäiset välit yhdistyvät ilman aukkoa: 0–499 ja 500–999 kattavat 1 000 paikkaa. Saman tavun vastaanotto kolmesti lisää kaksi ylimääräistä vastaanottoa, ei kahta erillistä päällekkäistä paikkaa. |
| Content-Range | first ≤ last < L | Vastauksen Content-Range-kentän loppu ei saa olla alkua pienempi. Tunnetun kokonaispituuden on oltava loppua aidosti suurempi. Tähdellä * ilmoitettu tuntematon pituus ei osoita täyttä kattavuutta. |
| ETag | strong validator | Osien on kuuluttava samaan esitykseen. RFC 9111 edellyttää yhteistä vahvaa validaattoria ja HTTP:n yhdistämisehtoja, kun välimuisti yhdistää osittaisia vastauksia. Sama URL tai pituus ei korvaa tätä tarkistusta. |
| If-Range | strong comparison | If-Range käyttää vahvaa ETag-vertailua. Asiakas ei saa lähettää siinä heikkoa ETag-arvoa. Ehdon epäonnistuessa Range ohitetaan ja pyydetään koko siirto. Päiväys kelpaa vain HTTP:n vahvan validaattorin ehdoilla. |
Alkuperäisiä opetusesimerkkejä; ei todellisen palvelimen mittauksia.
L: kokonaisluku väliltä 1–1 000 000 000 000. Syötä 1–20 molemmat rajat sisältävää a-b-väliä, yksi riville, esityksen sisällä. Tyhjät rivit ohitetaan; ympäröivät välilyönnit ja sarkaimet sallitaan. Enintään 2 000 merkkiä; ei HTTP-otsaketta.
Laskenta tapahtuu selaimessa; syötettyjä tietoja ei lähetetä eikä tallenneta.
Laskenta päivitetty.
Vain aritmeettinen kattavuus: esityksen identiteetti ja tavujen eheys on tarkistettava erikseen.
| Rajansa sisältävä väli | Pituus |
|---|---|
| 0–599 | 600 |
| 700–999 | 300 |
| Rajansa sisältävä väli | Pituus |
|---|---|
| 600–699 | 100 |
sum = Σ(lastᵢ − firstᵢ + 1) unique = |∪ intervals| redundant = sum − unique missing = L − unique
| L | Ilmoitetut osat (a-b, yksi riville) | Ilmoitettujen pituuksien summa | Katetut erilliset paikat | Ylimääräiset tavujen vastaanotot | Puuttuvat paikat | Puuttuvat välit |
|---|---|---|---|---|---|---|
| 1000 | 0–399; 300–599; 700–999 | 1000 | 900 | 100 | 100 | 600–699 |
| 1000 | 0–499; 500–999 | 1000 | 1000 | 0 | 0 | Ei yhtään |
| 1000 | 0–999; 0–999 | 2000 | 1000 | 1000 | 0 | Ei yhtään |
| 10 | 0–0; 0–0; 0–0 | 3 | 1 | 2 | 9 | 1–9 |
| 10 | 9–9; 0–0 | 2 | 2 | 0 | 8 | 1–8 |
| 10 | 2–7; 3–4 | 8 | 6 | 2 | 4 | 0–1; 8–9 |
| 1 | 0–0 | 1 | 1 | 0 | 0 | Ei yhtään |
| 1000000000000 | 0–999999999998; 999999999999–999999999999 | 1000000000000 | 1000000000000 | 0 | 0 | Ei yhtään |
Kattavuus olettaa ilmoitetut paikat samasta esityksestä. Työkalu ei lue tiedostoja eikä tarkista ETag-arvoja, Content-Encoding-koodausta, välimuistia tai tiivistettä. Se ei osoita päällekkäisten tavujen yhtäläisyyttä. Täysi kattavuus ei ole eheystodistus.
Ei. ETag on HTTP-validaattori, ei välttämättä kryptografinen tiiviste tai tekijän allekirjoitus. Tarkista myös variantti, pituudet ja todella vastaanotetut tavut. Kirjaa alkuperä ja eheystarkistukset erikseen.
Dokumentaatio tarkistettu .
DOKUMENTOIDUT TIEDOT
JSON Patch -lista arvioidaan järjestyksessä. Kukin polku osoittaa edellisten operaatioiden tuottamaan dokumenttiin, ei alkuperäisen pysyvään tilannekuvaan. Yhdeksän alkuperäistä esimerkkiä näyttävät laskentatilat ja pysähtymisehdot.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| add | insert / replace | add lisää taulukon indeksiin ja siirtää myöhempiä alkioita; loppuviiva lisää viimeisen jälkeen. Oliossa add myös korvaa olemassa olevan jäsenen. Ylätason säiliön on oltava olemassa. |
| remove / replace | existing target | remove ja replace edellyttävät olemassa olevaa kohdetta. Taulukon alkion poistaminen siirtää suurempia indeksejä vasemmalle: sama polku voi myöhemmin valita eri alkion. |
| move | remove → add | move poistaa ensin from-arvon ja lisää sen sitten path-kohtaan muuttuneessa dokumentissa. Myöhempään paikkaan siirrettäessä käytetään uusia indeksejä. Siirto omaan varsinaiseen jälkeläiseen on kielletty. |
| copy / test | value / equality | copy lisää arvon sitomatta paikkoja toisiinsa. test vertaa JSON-säännöillä, ei kirjoita mitään ja pysäyttää arvioinnin epäonnistuessaan. Olion jäsenten järjestys ei vaikuta yhtäsuuruuteen. |
| HTTP PATCH | atomic | Virhe pysäyttää sarjan. HTTP PATCH edellyttää atomista toteutusta: epäonnistunut patch ei toteuta mitään muutosta. Lukijan välitilat selittävät laskentaa eivätkä ole vahvistettuja kirjoituksia. |
| Content-Type | patch format | Content-Type erottaa tyypit application/json-patch+json ja application/merge-patch+json. PATCH-tuki ei takaa molempia. HTTP-esiehto kuten If-Match voi estää vanhentuneeseen versioon kohdistuvan päivityksen; test ei automaattisesti korvaa sitä. |
Alkuperäisiä opetusesimerkkejä; oikeaa dokumenttia ei muuteta.
Valitse esimerkki ja vaihe. Kukin operaatio kohdistuu edelliseen tulokseen. Virheen jälkeen lukija näyttää alkukohteen HTTP:n atomisuuden havainnollistamiseksi; myöhempiä operaatioita ei suoriteta.
Valmiiden esimerkkien lukija; vapaata patchia ei suoriteta tässä.
Alkutila · 0 / 2
{
"items": [
"A",
"B",
"C"
]
}nullEi operaatiota tässä vaiheessa.
{
"items": [
"A",
"B",
"C"
]
}Alkutila
Ei operaatiota tässä vaiheessa.
{
"items": [
"A",
"B",
"C"
]
}Välitila, ei vahvistettu
{
"op": "remove",
"path": "/items/0"
}{
"items": [
"B",
"C"
]
}Sarja onnistui
{
"op": "replace",
"path": "/items/1",
"value": "X"
}{
"items": [
"B",
"X"
]
}Alkutila
Ei operaatiota tässä vaiheessa.
[
"A",
"C"
]Välitila, ei vahvistettu
{
"op": "add",
"path": "/1",
"value": "B"
}[
"A",
"B",
"C"
]Sarja onnistui
{
"op": "add",
"path": "/-",
"value": "D"
}[
"A",
"B",
"C",
"D"
]Alkutila
Ei operaatiota tässä vaiheessa.
{
"note": "old",
"keep": true
}Välitila, ei vahvistettu
{
"op": "replace",
"path": "/note",
"value": null
}{
"note": null,
"keep": true
}Sarja onnistui
{
"op": "remove",
"path": "/note"
}{
"keep": true
}Alkutila
Ei operaatiota tässä vaiheessa.
{
"source": {
"n": 1
}
}Välitila, ei vahvistettu
{
"op": "copy",
"from": "/source",
"path": "/backup"
}{
"source": {
"n": 1
},
"backup": {
"n": 1
}
}Sarja onnistui
{
"op": "replace",
"path": "/source/n",
"value": 2
}{
"source": {
"n": 2
},
"backup": {
"n": 1
}
}Alkutila
Ei operaatiota tässä vaiheessa.
[
"A",
"B",
"C",
"D"
]Sarja onnistui
{
"op": "move",
"from": "/1",
"path": "/3"
}[
"A",
"C",
"D",
"B"
]Alkutila
Ei operaatiota tässä vaiheessa.
{
"rev": 1,
"label": "A"
}Välitila, ei vahvistettu
{
"op": "replace",
"path": "/label",
"value": "B"
}{
"rev": 1,
"label": "B"
}Virhe: HTTP PATCH ei toteuta muutoksia
{
"op": "test",
"path": "/rev",
"value": 2
}{
"rev": 1,
"label": "A"
}Ei suoritettu virheen jälkeen
{
"op": "add",
"path": "/extra",
"value": true
}{
"rev": 1,
"label": "A"
}Alkutila
Ei operaatiota tässä vaiheessa.
{
"a": []
}Virhe: HTTP PATCH ei toteuta muutoksia
{
"op": "add",
"path": "/missing/x",
"value": 1
}{
"a": []
}Alkutila
Ei operaatiota tässä vaiheessa.
{
"a/b": {
"~key": 1
}
}Välitila, ei vahvistettu
{
"op": "test",
"path": "/a~1b/~0key",
"value": 1
}{
"a/b": {
"~key": 1
}
}Sarja onnistui
{
"op": "add",
"path": "",
"value": [
"root"
]
}[
"root"
]Alkutila
Ei operaatiota tässä vaiheessa.
{
"x": 1
}Sarja onnistui
{
"op": "add",
"path": "/x",
"value": 2
}{
"x": 2
}Lukija näyttää dokumentoituja esimerkkejä eikä ole yleinen JSON Patch -suoritin. Se ei ota yhteyttä palvelimeen eikä ennusta vastauskoodia. Esitetty atomisuus kuuluu HTTP PATCHiin; paikallisen kirjaston on kuvattava omat virhe- ja muutoskäytäntönsä.
Ei. Tarvitaan mediatyyppi ja resurssin sopimus. Accept-Patch voi ilmoittaa hyväksytyt muodot. Menetelmän nimi tai paikallinen esimerkki ei todista etärajapinnan tukea tai muutosoikeutta.
Dokumentaatio tarkistettu .
DOKUMENTOIDUT TIEDOT
SemVer 2.0.0 määrittelee syntaksin ja järjestyksen ohjelmistoversioille, joilla on ilmoitettu julkinen API. Tavallinen merkkijono- tai desimaalilukuvertailu antaa vääriä tuloksia. Aineiston päiväys tai tagin nimi ei automaattisesti noudata tätä sopimusta.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| MAJOR.MINOR.PATCH | 0 | [1-9][0-9]* | Ydin koostuu kolmesta ei-negatiivisesta kokonaisluvusta: MAJOR.MINOR.PATCH. Etunollat kielletään paitsi yksittäinen 0. Tagi v1.2.3 voi nimetä julkaisun, mutta koko merkkijono ei ole tiukka SemVer-versio. |
| 1.9.0 / 1.10.0 | numeric | Ydinluvut verrataan numeerisesti vasemmalta oikealle. Siksi 1.9.0 edeltää versiota 1.10.0. SemVer ei rajoita luvun pituutta: työkalu vertaa numeroita ilman liukulukumuunnosta. |
| -alpha.1 | pre-release | Ytimien ollessa samat esiversio edeltää tavallista versiota. Pisteillä erotetut tunnisteet eivät saa olla tyhjiä. Pelkkä numerotunniste ei salli etunollia; kirjaimen tai yhdysmerkin sisältävä tunniste on eri tapaus. |
| -2 / -alpha | numeric < non-numeric | Numerotunnisteita verrataan numeerisesti, muita ASCII-järjestyksessä. Numerotunniste edeltää muuta tunnistetta. Kun kaikki yhteiset tunnisteet ovat samoja, useampia tunnisteita sisältävä esiversio on järjestyksessä suurempi. |
| +001 | ignored in precedence | Plusmerkin jälkeinen koontimetadata ei koskaan vaikuta järjestykseen. Toisin kuin esiversion numerotunniste, se voi sisältää arvon 001. Eri merkkijonot voivat olla samanarvoisia järjestyksessä todistamatta tiedostojen yhtäläisyyttä tai artefaktien vaihdettavuutta. |
Alkuperäisiä opetusesimerkkejä; todellista julkaisua ei arvioida.
Kaksi tiukkaa SemVer 2.0.0 -versiota, enintään 256 ASCII-merkkiä kumpikin. Ei välilyöntejä, v-etuliitettä tai rajoiteoperaattoreita. Numerotunnisteet verrataan täsmällisesti ilman pyöristystä.
Paikallinen laskenta selaimessa; syötettä ei lähetetä eikä tallenneta.
A edeltää B:tä SemVer-järjestyksessä.
1.9.0 < 1.10.0
Ensimmäinen ratkaiseva kriteeri : MINOR
| Osa | Versio A | Versio B |
|---|---|---|
| MAJOR | 1 | 1 |
| MINOR | 9 | 10 |
| PATCH | 0 | 0 |
| Esiversio | Ei mitään | Ei mitään |
| Koontimetadata | Ei mitään | Ei mitään |
| Versio A | < / = / > | Versio B | Ensimmäinen ratkaiseva kriteeri |
|---|---|---|---|
| 1.9.0 | < | 1.10.0 | MINOR |
| 2.0.0 | > | 1.99.99 | MAJOR |
| 1.0.9 | < | 1.0.10 | PATCH |
| 1.2.3-rc.9 | < | 1.2.3 | Esiversio verrattuna tavalliseen |
| 1.2.3-alpha.2 | < | 1.2.3-alpha.11 | Esiversiotunniste |
| 1.2.3-9 | < | 1.2.3-alpha | Esiversiotunniste |
| 1.2.3-alpha | < | 1.2.3-alpha.0 | Esiversiotunnisteiden määrä |
| 1.2.3-Beta | < | 1.2.3-alpha | Esiversiotunniste |
| 1.2.3+linux.001 | = | 1.2.3+windows.002 | Metadata ei vaikuta järjestykseen |
| 9007199254740992.0.0 | < | 9007199254740993.0.0 | MAJOR |
| Syöte | Diagnoosi |
|---|---|
| 1.2.3 | Kelvollinen |
| 0.0.0-0 | Kelvollinen |
| 1.2.3+001 | Kelvollinen |
| 1.2.3-01a | Kelvollinen |
| 1.2.3-- | Kelvollinen |
| v1.2.3 | Virheellinen |
| 1.02.3 | Virheellinen |
| 1.2.3-01 | Virheellinen |
| 1.2.3-alpha..1 | Virheellinen |
| 1.2.3+ | Virheellinen |
Alkuperäinen tulkinta ja esimerkit perustuvat Tom Preston-Wernerin alun perin laatimaan SemVer 2.0.0:aan; viiteteksti lisenssillä CC BY 3.0. SemVer 2.0.0 · CC BY 3.0
Vertailija tarkistaa syntaksin ja järjestyksen, ei julkaisutietoja, sisältöä, turvallisuutta tai todellista yhteensopivuutta. Riippuvuusrajoja, npm-välejä tai Python- ja Debian-versioita ei käsitellä. 256 merkin raja kuuluu lomakkeelle, ei SemVerille.
Ei automaattisesti. Säilytä koko merkkijono ja artefaktiviite: 1.2.3+linux ja 1.2.3+windows ovat järjestyksessä samanarvoisia, mutta metadata voi erottaa koonnit. Tiiviste ja julkaisusopimus tarkistetaan erikseen.
Dokumentaatio tarkistettu .
SYVENTÄVÄ LUKEMINEN / KÄYTÄNTÖ
Julkinen tiedosto korvataan samassa paikassa. Versioinnin on voitava palata laskelmassa käytetyn tilan ja ymmärtää myöhemmät muutokset.
Päivitetty .
Säilytä tiedosto, päivämäärä, lähde, jäljennös ja kaava. Vertaile rivejä, sarakkeita, määritelmiä ja arvoja ennen eroja mitattu ilmiön kehitykseen.
Uusi latauspäivä ei välttämättä tarkoita uutta sisältöä. Rakenteen muutos voi tehdä raaka vertailun vaikeaksi tulkita.
Versiotiedote yhdistää tilan, jäljennös, muutos ja vaikutus analyyseihin. Laskelmat viittaavat nimenomaisesti käytettyyn versioon.