Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/content/dfo-docs/corpus/hub/build/share.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,15 +73,15 @@ An embed follows the mode of its link. The embed of a live link redraws its card

### Turn a live link into a snapshot

Under a live link, **Make this link a snapshot** stops the updates. The dialog says: "Everyone who has the link then sees the numbers as they were when you made it. This cannot be undone." The link keeps its address and loses the "Live data" line. To share live data again, make a new link.
Under a live link, **Make this link a snapshot** stops the updates. The dialog says: "To stop live updates, make this link a snapshot. Everyone who has the link then sees the numbers it shows now, and they stay that way. This cannot be undone." The link keeps its address and loses the "Live data" line. To share live data again, make a new link.

## Check the link

Open the link in a private or incognito window:

- A search link opens `/data` with the same query sentence and table.
- A snapshot link shows the same values as when you created it.
- A Studio link opens the canvas or card in read-only mode, and a live canvas shows a "Live data" line. Anyone viewing it can resize the cards for their own screen; that changes nothing in the link.
- A Studio link opens the canvas or card in read-only mode, and a live canvas shows a "Live data" line.

## Troubleshooting

Expand Down
5 changes: 2 additions & 3 deletions src/content/dfo-docs/corpus/hub/get-started/use-studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,8 @@ DFO Studio adds a line chart to the canvas. The chat answer names the source and
Results vary a little each time. The plan, chart title and wording may differ, but the data is the same.

- Hover over the line to see the value for each year.
- Drag or resize the card to rearrange the canvas. A bar or line chart takes the proportion you drag it to, and keeps it when you widen the card, reopen the conversation, or share it. A ranking of horizontal bars and a table are as tall as their rows, so their corner changes the width alone.
- Click the download icon in the card's corner to download the data or an image of the chart.
- Open the **⋮** menu next to it to share the chart, ask a follow-up, add a note, or remove the card.
- Drag or resize the card to rearrange the canvas.
- Open the **⋮** menu in the card's corner to download the data, share the chart, ask a follow-up, add a note, or remove the card.

## Step 4: Pin the card

Expand Down
6 changes: 4 additions & 2 deletions src/content/dfo-docs/corpus/oda_reader/bulk-downloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -384,7 +384,7 @@ duckdb.sql(
)
```

`scan()` returns a frozen `ScannedTable` with five fields: `path`, `release`, `label_release`, `downloaded` (UTC) and `columns`. Read the file in place and leave it unmodified.
`scan()` returns a frozen `ScannedTable` with six fields: `path`, `release`, `label_release`, `downloaded` (UTC), `columns` and `published`. Read the file in place and leave it unmodified.

The returned path is named for its release, so its bytes stay the same after a later `scan()` downloads or converts a newer release. A DuckDB view built on it keeps reading the release it was built on. The files of the current and the previous release are kept until the cache is cleared, also after OECD moves a dataset to a new URL, and older ones are deleted.

Expand Down Expand Up @@ -423,6 +423,8 @@ Multisystem's CamelCase headers follow the CRS names: `Year` becomes `year`, `Do

CRS also carries the readable id OECD appends to its dataflow annotation, such as `"v20260803"`. It is `ScannedTable.label_release`, kept apart from the token because OECD can rewrite the file without changing the label. It is `None` for DAC1, DAC2A, DAC2B and Multisystem, and for a CRS file whose host token could not be read.

`ScannedTable.published` is the UTC date of the `Last-Modified` header on the response that delivered the cached bytes, for every dataset. It can differ from the date in CRS's `label_release`. It is `None` for a file registered with `register_bulk_file`, a file cached by an earlier version, and a response without the header.

Online, `release()` reads the token of the file OECD publishes now and downloads nothing. With `offline=True` it returns the cached copy's token.

### Options
Expand All @@ -433,7 +435,7 @@ Online, `release()` reads the token of the file OECD publishes now and downloads
- `refresh=True` downloads the bulk file again and bypasses the cached dataflow annotations. It cannot be combined with `offline=True`.
- `cache_dir=` reads and writes the bulk file and its conversion under another cache root for this call only, leaving the process-wide root unchanged. The dataflow annotations are still looked up through the process-wide HTTP cache.

`oda_reader.cache_info()` lists the cached bulk files as `BulkFileInfo` records: `dataset`, `release`, `label_release`, `downloaded`, `size_bytes`, `derived_bytes`, `stale` and `path`. `derived_bytes` is the disk space of the Parquet files `scan()` made from the bulk file; a CRS hard link counts as 0.
`oda_reader.cache_info()` lists the cached bulk files as `BulkFileInfo` records: `dataset`, `release`, `label_release`, `downloaded`, `size_bytes`, `derived_bytes`, `stale`, `path` and `published`. `derived_bytes` is the disk space of the Parquet files `scan()` made from the bulk file; a CRS hard link counts as 0.

## Bulk files use the .Stat schema

Expand Down
Loading
Loading