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/recipes/caching-of-resources.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,17 +11,17 @@ title: Caching of Resources
11
11
12
12
All Frictionless Data specifications allow for referencing resources via http or a local filesystem.
13
13
14
-
In the case of remote resources via http, there is always the possibility that the remote server will be unavailable, or, that the resource itself will be temporarily or permanently removed.
14
+
In the case of remote resources via http, there is always the possibility that the remote server will be unavailable, or, that the resource itself will be temporarily or permanently removed. If implementing systems are doing any processing or analysis with the file, they may wish to keep and reference a local copy while still pointing to the remote URL as the canonical data source.
15
15
16
-
Applications that are concerned with the persistent storage of data described in Frictionless Data specifications can use a `_cache` property that mirrors the functionality and usage of the `data`property, and refers to a storage location for the data that the application can fall back to if the canonical resource is unavailable.
16
+
Applications that are concerned with the persistent storage of data described in Frictionless Data specifications can use a `_cache` property that mirrors the functionality and usage of the `path` or `data`properties, and refers to a storage location for the data that the application can fall back to if the canonical resource is unavailable.
17
17
18
18
## Implementations
19
19
20
20
There are no known implementations of this pattern at present.
21
21
22
22
## Specification
23
23
24
-
Implementations `MAY` handle a `_cache` property on any descriptor that supports a `data` property. In the case that the data referenced in `data` is unavailable, `_cache` should be used as a fallback to access the data. The handling of the data stored at `_cache` is beyond the scope of the specification. Implementations might store a copy of the resources in `data` at ingestion time, update at regular intervals, or any other method to keep an up-to-date, persistent copy.
24
+
Implementations `MAY` handle a `_cache` property on any descriptor that supports either a `path` or `data` property. In the case that the data referenced in `path` or `data` is unavailable, `_cache` should be used as a fallback to access the data. The handling of the data stored at `_cache` is beyond the scope of the specification. Implementations might store a copy of the resources in`path` or`data` at ingestion time, update at regular intervals, or any other method to keep an up-to-date, persistent copy.
25
25
26
26
Some examples of the `_cache` property.
27
27
@@ -31,12 +31,12 @@ Some examples of the `_cache` property.
0 commit comments