Help:Data type/ja
<languages /> Template:Information page データ型は、文の振る舞いや受け付けるデータの種類を定義するものです。違った種類の文には違った種類のプロパティを使用するように、データ型も違ったものを使用します。データ型の設定はプロパティの新規作成時に行われ、一度設定されるとプロパティはそのデータ型に固定されます。データ型はプロパティの使われ方に影響してくるので、有益なプロパティを定義するためにも、一定の計画性をもって決定されるべきです。
プロパティに関する調整は、Template:Llで行われています。
Template:Properties by datatype Template:Clear
データ型別のプロパティ
現在データ型を要求するプロパティの一覧はこちらを参照：
エンティティにリンクするデータ型
ウィキデータには6つのエンティティの型（Template:Entitytype、Template:Entitytype、Template:Entitytype、Template:Entitytype、Template:EntitytypeおよびTemplate:Entitytype）があります。各エンティティ型に対して、同名のデータ型が存在し、その型のエンティティにリンクするために使うことができます。
- ⧼datatypes-type-wikibase-item⧽ Template:Anchor
- Template:Llへのリンク。 ([[Special:ListProperties/wikibase-item|Template:Int list of properties]])
- ⧼datatypes-type-wikibase-property⧽ Template:Anchor
- Template:Llへのリンク。 ([[Special:ListProperties/wikibase-property|Template:Int list of properties]])
- ⧼datatypes-type-entity-schema⧽ Template:Anchor
- Template:Llへのリンク。 ([[Special:ListProperties/entity-schema|Template:Int list of properties]])
以下のデータ型はウィキデータのTemplate:Llを構成する語彙素に対して第一に適用されます。
- ⧼datatypes-type-wikibase-lexeme⧽ Template:Anchor
- Template:Llへのリンク。 ([[Special:ListProperties/wikibase-lexeme|Template:Int list of properties]])
- ⧼datatypes-type-wikibase-form⧽ Template:Anchor
- 関係を示すために他の語彙素でTemplate:Llを参照するための語彙素の文。 ([[Special:ListProperties/wikibase-form|Template:Int list of properties]])
- ⧼datatypes-type-wikibase-sense⧽ Template:Anchor
- 他の語彙素のTemplate:Llを参照するための語彙素の文。 ([[Special:ListProperties/wikibase-sense|Template:Int list of properties]])
文字列に基づくデータ型 Template:Anchor
⧼wikibase-listdatatypes-string-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:文字列-データ型を持つプロパティ -- Special:ListProperties/string
他言語や他の数フォーマットに翻訳する必要のない文字、数、記号の列。文字列は計算に計算には使用されない。
- Template:Int Examples⧼colon⧽
- B123
- 90928390-XLE
- u29238
ウィキデータにおける最大の長さは、InitialiseSettings.phpにおいてwmgWikibaseStringLimitsで定義されているように、1,500文字です。
⧼wikibase-listdatatypes-monolingualtext-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:単一言語テキスト-データ型を持つプロパティ -- Special:ListProperties/monolingualtext
他の言語に翻訳しない文字列です。この型の文字列は全言語で再利用されます。よくある使い方としては、地理的なエンティティの現地での表記名、何らかの識別子、化学式、科学分野のラテン語名などです。単一言語テキストで使用できる言語コード、および言語コードの追加は、Template:Llを参照してください。（注：単一言語テキストは、単一の表記体系としての使用も想定しています。）
ウィキデータにおける最大の長さは、InitialiseSettings.phpにおいてwmgWikibaseStringLimitsで定義されているように、1,500文字です。
⧼wikibase-listdatatypes-external-id-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:外部識別子-データ型を持つプロパティ -- Special:ListProperties/external-id
外部システムで使用される識別子を表す文字列。Template:Propertyが定義されている場合、外部リンクとして表示されます。外部識別子参照。
ウィキデータにおける最大の長さは、InitialiseSettings.phpにおいてwmgWikibaseStringLimitsで定義されているように、1,500文字です。
⧼wikibase-listdatatypes-url-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:URL-データ型を持つプロパティ -- Special:ListProperties/url
一般化した「URL」は、ある種の外部リソースを識別し、ある種の外部サイトへのリンクもしくはある種の特殊なリソースの検索に使用される識別子。
ウィキデータにおける最大の長さは、InitialiseSettings.phpにおいてwmgWikibaseStringLimitsで定義されているように、1,500文字です。
コモンズのファイルを参照するデータ型
⧼wikibase-listdatatypes-commonsmedia-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:コモンズメディア-データ型を持つプロパティ -- Special:ListProperties/commonsMedia
ウィキメディア・コモンズにあるファイルへの参照。テキストフィールドへの入力中、コモンズの「File」名前空間からマッチする項目を検索します。これらのファイルはウィキデータ上の概念を説明するためのものとしても、ウィキペディアに含めるための実際のプロパティの値としても使えます。
- Template:Int Examples⧼colon⧽
- Wikidata-logo.svg
⧼wikibase-listdatatypes-geo-shape-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:地理形状-データ型を持つプロパティ -- Special:ListProperties/geo-shape
ウィキメディア コモンズの地図データファイルを参照します。文字列欄への入力時にコモンズの「Data」名前空間を対象に、適合するエントリを検索します。
⧼wikibase-listdatatypes-tabular-data-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:表-データ-データ型を持つプロパティ -- Special:ListProperties/tabular-data
ウィキメディア コモンズの表データファイルを参照します。文字列欄への入力時にコモンズの「Data」名前空間を対象に、適合するエントリを検索します。
特定の記法に対するデータ型
Mathematical expression
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:数式-データ型を持つプロパティ -- Special:ListProperties/math
数式として表示されるフォーマット文字列
例:
\sqrt{1-e^2}は以下を生成します:
適用できる形式の詳細はHelp:数式の表示をご参照ください。
現状の制限：入力テキストはクエリサービスでクエリすることができません。
⧼wikibase-listdatatypes-musical-notation-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:楽譜-データ型を持つプロパティ -- Special:ListProperties/musical-notation
.png 形式で画像を生成すると楽譜が表示されます。そのデータ型の値は、LilyPond構文に従って音楽を表現する文字列です。
例:
- 値の文字列
\relative c' { c d e f | g2 g | a4 a a a | g1 |}から次を生成- <score>\relative c' { c d e f | g2 g | a4 a a a | g1 |}</score>
その他のデータ型
⧼wikibase-listdatatypes-quantity-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:数量-データ型を持つプロパティ -- Special:ListProperties/quantity
10進数で表される数量。この数の不確実性の範囲と測定単位についての情報を伴う。属性は以下の通り：
- amount: 数量の主たる値
- lowerBound: 数量の下限（任意）
- upperBound: 数量の上限（任意）
- unit: 項目の測量に用いた単位（空の場合は無次元量）
内部的には、数量、上限および下限は文字列です。正の数はプラス記号を伴って保存されていますが、これは表示されません。数量の表現は127文字より長くすることはできず、したがって数量の最大値は10^126-1です。
単位の変換はTemplate:Pに基づいて実装されています。このプロパティを持つほとんどの単位は、クエリサービスに対するRDFエクスポートで規格化されます（2019年10月現在）。
規格化の表はWMF Mediawiki repositoryでJSON形式で参照できます。
- Template:Int Examples⧼colon⧽
- 762 (無次元)
- 2500 km (上限・下限なし、単位あり)
- 1.03 ± 0.02 g (基準値+/-許容差として上限・下限を表し、単位あり)。例えばlisteria botによって作成されるウィキデータの一覧のように、ウィキデータでは許容差が表示されず、基準値のみが表示される場合があります。
⧼wikibase-listdatatypes-time-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:時間-データ型を持つプロパティ -- Special:ListProperties/time
グレゴリオ暦またはユリウス歴の日付。構造の詳細参照。
- Template:Int Examples⧼colon⧽
- 2012
- 1780-05 (=1780年5月)
- 1833-11-01 (=1833年11月1日)
より詳しくはTemplate:Llを参照してください。
⧼wikibase-listdatatypes-globe-coordinate-head⧽
- Template:Int type⧼colon⧽ Template:Datatype (Template:Datatype)
- Template:Int list of properties⧼colon⧽ カテゴリ:天体-位置座標-データ型を持つプロパティ -- Special:ListProperties/globe-coordinate
ある「globe」(あらゆる天体) における緯度と経度の組み合わせで得られる地理的位置（度分秒または10進度数で表現）。デフォルトの天体(globe)は「地球」(globe: http://www.wikidata.org/entity/Q2)です。「精度」(precision) パラメータは、座標のソースの解像度を示します。座標系は「WGS84」(Template:Q) と想定されることに留意してください。これは地球に似ていない天体には適さない可能性がありますが、変更できません。
Template:Phabricator
現在、ウィキデータのウェブ UI ではこのデータ型のすべてのパラメータは見えるようになりません。値は座標としてのみ表示され、もし天体(globe) がTemplate:Qであれば埋め込まれた地図も表示します。編集モードで精度を調整できます。天体(globe)は項目表示では見ることも編集することもできません。しかしながら、変更履歴表示では完全な設定を見ることができます（例）。
Template:Phabricator ウェブ UI を使用したとき、保存される値は選んだ精度の倍数になります。
APIを使うと全てのデータを編集することが可能です。CLI ツールを介するのも API を操作する方法のひとつです。この例ではTemplate:Qは（Template:Pで使用されている） 天体(globe)パラメータを用いてTemplate:Qにおける座標を与えられています:
wd ac Q520 P625 '{ "latitude": 18.4, "longitude": 226, "precision": 0.016666666666667, "globe": "http://www.wikidata.org/entity/Q111" }'
globe.js スクリプトは、Template:Pの天体(globe)パラメータを設定するためのUIを追加します。
Template:Pの天体(globe)パラメータがTemplate:Pに準拠して設定されていない場合、LocatorBotのようなボットが検出することができます。Template:Pを追加し、ボット作業による位置座標の天体(globe)の更新を待つ方法は受け入れられている次善策です。
技術的な詳細
Template:Ll型では各値は"datatype": <datatype>, "datavalue": {"type": <type>, "value": ...}で記述され、valueの記述はtypeに依存します。
Template:Ll形式ではデータ型は以下の表のhttp://wikiba.se/ontology#で始まるRDF nameによって記述されます。ダンプの場合はwikibase:です。Template:Llでもこの接頭辞を使えますので、Template:Quickqueryはデータ型の全てのプロパティを返します。
{{#invoke:datatypes|overviewTable}}
制限
- Template:Datatypeは時刻に対応していません。 phab:T57755
- Template:DatatypeはTemplate:Qに対応していませんので、Template:Stなどとは書けません。
保留中のデータ型
以下はいずれも実装予定日が未定です。実装されないうちは既存の datatype で対応を続けます。
実行予定
継続時間
Template:Tracked HH:MM:SS 形式で時間を記述。
計画中
計算済みプロパティ
Template:Tracked ウィキベースが算出した結果をそのまま項目に適用するプロパティ。具体的な開発計画なし。
使用例: 項目に対する文の件数。
天球座標
Template:Tracked 天体の位置を示す座標形式。具体的な開発計画なし。
現状の次善策：Wikidata:Property proposal/Astronomical coordinates参照
整数データ型
Template:Tracked 正の整数値の数量データ型。これは精度を部分的に落とし、Template:Qを作成することによって実装されました。
単一文字列項目
どの言語で説明するか制限がない代わりに、ラベルが1件しかないデータ型。具体的な開発計画なし。
現状の代替案：語彙素
評価中の代替案：複数のラベルを繰り返す代わりに多言語ラベルをひとつ使う Template:Anchor
多言語の文字列
Template:Tracked 多言語への翻訳を求められる文字列。非ローカル形式のエンティティ名に使用する可能性があり、さまざまな言語およびスクリプトシステムに翻訳されます。 (多言語テキストは翻訳中に多くの手作業が関わる点にもご留意ください)。実際の使用目的は要検討。
複数行テキスト
改行を含むことができる文字列。
リモートプロパティ
Template:Tracked リモートのリポジトリに置かれたプロパティで、固有のデータ型を持たず、既存のエンティティの特別なフィールドを介して識別される可能性があります。
連続する値
Template:Tracked さまざまな時点の異なる値の集合を保存する単純な方法。具体的な開発計画なし。
チェス
Template:Tracked Template:Pのように、直接、FEN表記で文字列をチェス盤状に表示。
ヒエログリフ
WikiHieroを使って文字列を表示。文字列をWikiHiero の文法に従い、<hiero></hiero>に埋め込んで表示。サンプルはTalk:Q68101340とProperty_talk:P7383をご参照ください。
Phabrilator のやることリスト。
人間に読める数字のIDの組み合わせ
Template:Tracked 数字のIDとMediaWikiのページ名を追加するためのデータタイプ。修飾子としてTemplate:Pが追加できます。数字のプロパティを直接使うプロパティもあります。
Wikibaseの文
Template:Tracked Wikidata中の特定の文を示すためのデータ型
正規表現
Template:Tracked 正規表現(regex)を格納するためのデータ型。今は文字列または単一言語テキストとして格納されています。例： Template:P, Template:P
IPアドレスの範囲
Template:Tracked アドレス範囲を格納しクエリを簡便にするためのデータ型。
提案のみで実装されなかったデータ型
真偽値
Template:Tracked 却下。代替案: item-datatype。
データ型の変更
「文字列」データ型のプロパティは管理者によって「外部識別子」データ型に変換できます。このような変更を提案するには、当該するプロパティの議論ページもしくはプロジェクトのチャットで新しい話題として提示します。合意が形成されたら、要求をWikidata:開発チームに連絡することができます。2016年以前に作成されたプロパティを変換したい場合は、過去の議論を読んでおくべきです。
その他のデータ型の変更は、新しいプロパティの作成と古いプロパティの削除を必要とします。このような要求にはWikidata:プロパティの削除依頼を利用すべきです。