You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/standard/data-resource.mdx
+40Lines changed: 40 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -148,6 +148,7 @@ If `path` property is not provided but there is a `url` property as was defined
148
148
A Data Resource descriptor `MAY` contain a property `type` that `MUST` be a string with the following possible values:
149
149
150
150
-`table`: indicates that the resource is tabular as per [Tabular Data](/standard/glossary/#tabular-data) definition. Please read more about [Tabular Resource](#tabular) properties.
151
+
-`json`: indicates that the resource is JSON as per [JSON Data](/standard/glossary/#json-data) definition. Please read more about [JSON Resource](#json) properties.
151
152
152
153
If property `type` is not provided, the resource is considered to be a non-specific file. An implementation `MAY` provide some additional interfaces, for example, tabular, to non-specific files if `type` can be detected from the data source or format.
153
154
@@ -211,6 +212,10 @@ List of licenses as for [Data Package](/standard/data-package/#licenses). If not
211
212
212
213
The properties below are applicable to any Tabular Data Resource.
213
214
215
+
#### `type`{#tabular-type}
216
+
217
+
A Tabular Data Resource descriptor `SHOULD` contain a property `type` that `MUST` be `table`.
218
+
214
219
#### `path` or `data`[required]{#tabular-path-or-data}
215
220
216
221
If the `path` property is used for providing data than it `MUST` contain [Tabular Data](/standard/glossary/#tabular-data).
@@ -275,3 +280,38 @@ An example of a resource with a schema:
275
280
}
276
281
}
277
282
```
283
+
284
+
### JSON
285
+
286
+
The properties below are applicable to any JSON Data Resource.
287
+
288
+
#### `type`{#json-type}
289
+
290
+
A JSON Data Resource descriptor `SHOULD` contain a property `type` that `MUST` be `json`.
291
+
292
+
#### `path` or `data`[required]{#json-path-or-data}
293
+
294
+
If the `path` property is used for providing data than it `MUST` contain [JSON Data](/standard/glossary/#json-data).
295
+
296
+
If the `data` property is used for providing data for a JSON Data Resource than it `MUST` be an inline instance of [JSON Data](/standard/glossary/#json-data).
297
+
298
+
#### `jsonSchema`
299
+
300
+
A JSON Data Resource `MAY` have a `jsonSchema` property to provide a JSONSchema of the resource data. If provided, the `jsonSchema` property `MUST` be a valid [JSON Schema](https://json-schema.org) descriptor in a form of an object or [URL-or-Path](/standard/glossary/#url-or-path).
Copy file name to clipboardExpand all lines: content/docs/standard/glossary.mdx
+17Lines changed: 17 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -134,6 +134,23 @@ In JSON, a table would be:
134
134
]
135
135
```
136
136
137
+
### JSON Data
138
+
139
+
JSON data is a valid [JSON](https://www.json.org) object. For example:
140
+
141
+
```json
142
+
{
143
+
"name": "John Doe",
144
+
"age": 30,
145
+
"address": {
146
+
"street": "123 Main St",
147
+
"city": "Anytown",
148
+
"state": "CA"
149
+
}
150
+
}
151
+
```
152
+
153
+
137
154
### Data Representation
138
155
139
156
In order to talk about the representation and processing of tabular data from text-based sources, it is useful to introduce the concepts of the _physical_ and the _logical_ representation of data.
0 commit comments