Help:Tipi di dato
This is an information page. It is not one of Wikidata's policies or guidelines, but rather intends to describe some aspect(s) of Wikidata's norms, customs, technicalities, or practices. It may reflect varying levels of consensus and vetting. |
I tipi di dato definiscono come si comportano le dichiarazioni e quale tipo di dato abbiano. Differenti tipi di dichiarazione utilizzano differenti tipi di proprietà e anche differenti tipi di dato. Durante la creazione delle proprietà, bisogna scegliere il tipo di dato che, una volta scelto, non può più essere cambiato. Questa scelta ha implicazioni su come le proprietà verranno usate; per questo si deve esaminare con attenzione il da farsi prima di definire una proprietà utile.
Proposte e coordinamento riguardo le proprietà sono discusse nella pagina Wikidata:Property proposal.
Data type | Number of properties |
---|---|
External identifier | 9 156 |
Item | 1 670 |
Quantity | 661 |
String | 335 |
URL | 109 |
Commons media file | 83 |
Point in time | 67 |
Monolingual text | 62 |
Property | 21 |
Geographic coordinates | 10 |
Tabular data | 6 |
Geographic shape | 3 |
Data type | Number of properties |
---|---|
Mathematical expression | 36 |
Sense | 19 |
Lexeme | 15 |
Form | 10 |
Musical Notation | 6 |
Proprietà per tipo
Un elenco completo delle proprietà, che tutti i dati richiedono indipendentemente dal tipo, si può anche trovare in:
- Speciale:Elenco delle proprietà
- Lista di tutte le proprietà
- Violazioni dei vincoli/Tutte le proprietà
- Categoria:Proprietà per tipo.
Datatypes to link entities
Wikidata has 6 types of entities (Item, Property, Lexeme, Sense, Form and ⧼datatypes-type-wikibase-EntitySchema⧽). For each entity type there exists a same-named data type that can be used to link entities of that type.
- Item
- Collegamento ad un elemento. (list of properties)
- Property
- Collegamento ad una proprietà. (list of properties)
- EntitySchema
- Link to an entity schema. (list of properties)
The following data types are primarily meant for statements on Lexemes, which make up the lexicographical data of Wikidata.
- Lexeme
- Collegamento ad un lessema. (list of properties)
- Form
- For statements on lexemes that reference forms on other lexemes in order to indicate their relation. (list of properties)
- Sense
- For statements on lexemes that reference senses on other lexemes. (list of properties)
String-based data types
String
- type: string (String)
- list of properties: Categoria:Proprietà con tipo di dato stringa -- Special:ListProperties/string
Sequenza di caratteri, numeri e simboli che non necessitano traduzioni in lingue o formati numerici differenti. Una stringa non viene usata per fare calcoli.
- Examples:
- B123
- 90928390-XLE
- u29238
La massima lunghezza è di 1500 caratteri su Wikidata, come definito da wmgWikibaseStringLimits
in InitialiseSettings.php.
Monolingual text
- type: monolingualtext (Monolingual text)
- list of properties: Categoria:Proprietà con tipo di dato testo monolingua -- Special:ListProperties/monolingualtext
Una stringa che non è tradotta in altre lingue. Questo tipo di stringa viene definito una volta sola e usata in tutte le lingue. Si usa di solito per indicare il nome di un entità geografica nella lingua locale, un identificatore di qualche tipo, una formula chimica o un nome scientifico espresso in Latino. Vedi Help:Monolingual text languages per conoscere i codici delle lingue disponibili e come chiedere aiuto per aggiungerne altri (Nota che il testo monolingua comporta anche un unico sistema di scrittura, che potrebbe rendere la stringa problematica).
La massima lunghezza è di 1500 caratteri su Wikidata, come definito da wmgWikibaseStringLimits
in InitialiseSettings.php.
External identifier
- type: external-id (External identifier)
- list of properties: Categoria:Proprietà con tipo di dato identificativo esterno -- Special:ListProperties/external-id
Stringa che rappresenta un identificativo usato su un sistema esterno. Essa verrà mostrata come un link esterno se formatter URL (P1630) è definito. Vedi anche: External identifiers.
La massima lunghezza è di 1500 caratteri su Wikidata, come definito da wmgWikibaseStringLimits
in InitialiseSettings.php.
URL
- type: url (URL)
- list of properties: Categoria:Proprietà con tipo di dato URL -- Special:ListProperties/url
Una "URL" generica che identifica alcuni tipi di risorse esterne, come un link ad un qualche tipo di sito esterno, o un identificatore usato per la ricerca in alcuni tipi di risorse specialistiche.
La massima lunghezza è di 1500 caratteri su Wikidata, come definito da wmgWikibaseStringLimits
in InitialiseSettings.php.
Data types to reference files on Commons
Commons media
- type: commonsMedia (Commons media file)
- list of properties: Categoria:Proprietà con tipo di dato commonsMedia -- Special:ListProperties/commonsMedia
Collegamenti a file su Wikimedia Commons. Durante l'inserimento del nome, il file corrispondente verrà cercato su Commons nel namespace "File". Questi file possono essere usati sia per mostrare concetti su Wikidata che come valori di proprietà per l'inserimento su Wikipedia (Nota che per ora il file non viene mostrato direttamente su Wikidata, ma soltanto il suo link).
- Examples:
- Wikidata-logo.svg
Geographic shape
- type: geo-shape (Geographic shape)
- list of properties: Categoria:Proprietà con tipo di dato forma geografica -- Special:ListProperties/geo-shape
Riferimento al file map data su Wikimedia Commons. Durante l'immissione nel campo di testo verranno cercate nello spazio dei nomi "Data" su Wikimedia Commons le voci corrispondenti.
Tabular data
- type: tabular-data (Tabular data)
- list of properties: Categoria:Proprietà con tipo di dato dati tabulari -- Special:ListProperties/tabular-data
Riferimento a tabular data su Wikimedia Commons. Durante l'immissione nel campo di testo verranno cercate nello spazio dei nomi "Data" su Commons le voci corrispondenti.
Tipi di dato per notazioni specifiche
Mathematical expression
- type: math (Mathematical expression)
- list of properties: Categoria:Proprietà con tipo di dato espressione matematica -- Special:ListProperties/math
Stringa con un formato particolare che mostra una formula.
Esempio:
\sqrt{1-e^2}
produce:
Vedi w:Help:Displaying a formula per come scrivere una formula.
Limitazione corrente: il testo inserito non può essere usato per le interrogazioni effettuate tramite il Query Service.
Musical Notation
- type: musical-notation (Musical Notation)
- list of properties: Categoria:Proprietà con tipo di dato notazione musicale -- Special:ListProperties/musical-notation
Immagine generata nel formato .png che mostra uno spartito musicale. I valori per questo tipo di dato sono stringhe che descrivono la musica secondo la sintassi LilyPond.
Esempio:
- La stringa
\relative c' { c d e f | g2 g | a4 a a a | g1 |}
, produce
Altri tipi di dati
Quantity
- type: quantity (Quantity)
- list of properties: Categoria:Proprietà con tipo di dato numero -- Special:ListProperties/quantity
Un dato di tipo numero rappresenta un numero decimale, insieme ad altre informazioni come il suo intervallo di errore e l'unità di misura. I suoi attributi sono:
- valore: il valore principale della quantità;
- limite inferiore: il limite inferiore della quantità (default 1);
- limite superiore: il limite superiore della quantità (default 1);
- unità: l'unità di misura (vuoto per valori senza dimensioni).
Internamente, il valore, i limiti inferiore e superiore sono stringhe; i numeri positivi sono salvati con un segno più, anche se questo non viene mostrato. La rappresentazione di una quantità non può essere più lunga di 127 caratteri; perciò il valore massimo di una quantità è 10^126-1.
La conversione fra diverse unità di misura è implementata secondo la conversion to SI unit (P2370) implementata. La maggior parte delle unità con la proprietà sono normalizzate nell'export RDF per il query service (Ottobre 2019).
La tabella di normalizzazione è leggibile nel formato di file JSON nel repository WMF Mediawiki.
- Examples:
- 762 (senza unità di misura)
- 2500 km (i limiti superiore e inferiore non sono impostati, con unità di misura).
- 1.03 ± 0.02 g (inserito come valore nominale +/- tolleranza, rappresentante un limite inferiore e superiore, con unità di misura). La tolleranza in alcuni casi non viene mostrata su Wikipedia, solo il valore nominale, per esempio nelle liste Wikidata prodotte dal bot listeria.
Time
- type: time (Point in time)
- list of properties: Categoria:Proprietà con tipo di dato data e ora -- Special:ListProperties/time
Questo tipo di dato permette di memorizzare una data sia del calendario Gregoriano che di quello Giuliano. Vedi la descrizione della struttura dettagliata per maggiori informazioni.
- Examples:
- 2012
- 1780-05 (= maggio 1780)
- 1833-11-01 (= 1 luglio 1833)
Vedere Help:Dates per ulteriori info.
Globe coordinate
- type: globe-coordinate (Geographic coordinates)
- list of properties: Categoria:Proprietà con tipo di dato coordinate geografiche -- Special:ListProperties/globe-coordinate
La posizione geografica è data da una coppia di numeri latitudine-longitudine (in formato sessagesimale o gradi decimali) riferita ad un dato "globo" (un qualunque corpo celeste). Il corpo celeste di default è "Terra" (globe: http://www.wikidata.org/entity/Q2
). Un parametro "precisione" permette di stabilire la risoluzione della fonte delle coordinate. Nota che il sistema di coordinate è stabilito essere "WGS84" (World Geodetic System 1984 (Q11902211)) che potrebbe non essere adatto per corpi celesti differenti dalla Terra, ma non è configurabile.
Currently, the Web UI of Wikidata doesn't expose all parameters of this data type. The value is visualized only as the coordinate, plus an embedded map if the globe is Earth (Q2). The precision can be modified in the edit mode. The globe is not visible, nor editable, in the item view. The full configuration is however visible in the history diff view (example).
When using the Web UI, the value saved will be an exact multiple of the precision chosen.
It is possible to edit the data in full via API. The CLI tool is one way to access the API. In this example Olympus Mons (Q520) is given a coordinate on Mars (Q111) using the globe parameter (used in coordinate location (P625)):
wd ac Q520 P625 '{ "latitude": 18.4, "longitude": 226, "precision": 0.016666666666667, "globe": "http://www.wikidata.org/entity/Q111" }'
The globe.js script adds a UI to set the globe parameter of coordinate location (P625).
Bots such as LocatorBot may detect when the globe parameter of coordinate location (P625) is not set according to located on astronomical body (P376). Adding located on astronomical body (P376) and waiting for a bot to update the coordinate globe is an accepted workaround.
Dettagli tecnici
In the Wikibase JSON format each value is represented by "datatype": <datatype>, "datavalue": {"type": <type>, "value": ...}
, where the representation of the value
depends on the type
.
In the RDF format data types are represented by the RDF name in the following table prefixed with http://wikiba.se/ontology# (or the wikibase:
prefix in case of the RDF dumps). Note that this prefix is also available in the Wikidata query service, so for example ?prop wikibase:propertyType wikibase:String will return all properties of data type String.
Name | JSON datatype | RDF name | JSON type | Implemented by | Links |
---|---|---|---|---|---|
Elemento | wikibase-item | WikibaseItem | wikibase-entityid | built-in | list, query |
Proprietà | wikibase-property | WikibaseProperty | wikibase-entityid | built-in | list, query |
Lessema | wikibase-lexeme | WikibaseLexeme | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
Senso | wikibase-sense | WikibaseSense | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
Forma | wikibase-form | WikibaseForm | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
EntitySchema | entity-schema | EntitySchema | wikibase-entityid | Wikidata Entity Schema (Q73505550) | list, query |
Testo monolingua | monolingualtext | Monolingualtext | monolingualtext | built-in | list, query |
Stringa | string | String | string | built-in | list, query |
Identificativo esterno | external-id | ExternalId | string | built-in | list, query |
URL | url | Url | string | built-in | list, query |
File multimediale su Commons | commonsMedia | CommonsMedia | string | built-in | list, query |
Forma geografica | geo-shape | GeoShape | string | built-in | list, query |
Dati tabulari | tabular-data | TabularData | string | built-in | list, query |
Espressione matematica | math | Math | string | Math (Q21677559) | list, query |
Notazione musicale | musical-notation | MusicalNotation | string | Score (Q21678392) | list, query |
Quantità | quantity | Quantity | quantity | built-in | list, query |
Punto nel tempo | time | Time | time | built-in | list, query |
Coordinate geografiche | globe-coordinate | Globecoordinate | globecoordinate | built-in | list, query |
Limitazioni
- Point in time doesn't support time of day. phab:T57755
- Quantity doesn't support infinity (Q205), e.g. you cannot state prime number (Q49008)quantity (P1114)infinitely many.
Tipi di dati in sospeso
Nessuna data di implementazione è ancora disponibile per i seguenti tipi di dato. Alcuni di quelli esistenti potrebbero fare le veci nel frattempo.
Vedi: Wikidata:Development plan (in Inglese).
Da fare
Durata
Ora nel formato HH:MM:SS
Da pianificare
Proprietà calcolata
Una proprietà il cui valore è calcolato direttamente da Wikibase e aggiunto direttamente agli elementi. Al momento non è nei piani di sviluppo.
Usi Possibili: numero di dichiarazioni in un elemento.
Coordinate celesti
Un formato di coordinate per gestire la posizione dei corpi celesti. Al momento non è nei piani di sviluppo.
Current work-around: see Wikidata:Property proposal/Astronomical coordinates
Tipo di dato numero intero
Un tipo di dato per numeri interi positivi. Questo è stato parzialmente implementato rimuovendo la precisione e creando integer constraint (Q52848401).
Elemento monostringa
Tipo di dato con descrizioni in qualsiasi lingua, ma un'unica etichetta. Al momento non è nei piani di sviluppo.
Aternative correnti: lessemi
Alternative in considerazione: le etichette multilingua che vanno a rimpiazzare le etichette ripetute
Testo multilingua
Una stringa che deve essere tradotta in altre lingue. Si potrebbe usare per indicare nomi in formati non locali di entità, che in questo modo possono essere tradotti nelle varie lingue e sistemi di scrittura supportati dal sistema (Nota che il testo multilingua necessita di molto lavoro manuale durante la traduzione). Scopo effettivo da determinare.
Testo multilinea
Una stringa che può contenere andate a capo.
Proprietà in remoto
È probabile che le proprietà i cui valori sono in archivi esterni a Wikidata siano identificati attraverso uno speciale campo su un'entità esistente, non attraverso un diverso tipo di dato.
Serie temporale
Una maniera semplificata per memorizzare una serie di valori a differenti istanti temporali. Al momento non è nei piani di sviluppo.
Chess
Display strings in FEN notation as in position in Forsyth-Edwards Notation (P6648) directly as chessboards.
Hiero
Strings for display with WikiHiero. Strings in WikiHiero syntax are embedded in <hiero></hiero>
to display. Samples on Talk:Q68101340 and Property_talk:P7383.
Phab request to do.
Combined human-readable and numeric id
Datatype to add numeric id and page title, e.g. of a MediaWiki page. Qualifier MediaWiki page ID (P9675) is sometimes added to property value with page titles. Some properties use the numeric value directly.
Wikibase statement
Datatype to reference a specific Wikidata statement.
Regular expressions
Datatype to store regular expressions (regex). These are currently stored as strings or monolingual text, e.g. format as a regular expression (P1793), format as language specific regular expression (P8770).
IP address ranges
Datatype to store address ranges and simplify querying them.
Tipi di dato che non verranno mai implementati
Booleano
Abbandonato. Alternativa suggerita: tipo di dato elemento.
Cambiare tipo di dato
A property in "string" datatype may be converted to "external identifier" datatype by a system administrator. To propose such a change, you may start a discussion at the talk page of the property or Project chat. After a consensus, a request may be made in Contact the development team. You should read previous discussion if you want to convert a property created before 2016.
Other changes of data type requires creating a new property and deleting the old one. You should use Properties for deletion for such requests.