Skip to content

Commit 7031ead

Browse files
anandgupta42claude
andcommitted
docs(warehouses): fix self-contradicting sentence in bare-scheme note (#1238 round-4 thread)
The note added to explain the bare-word:target-vs-local-filename tradeoff read as self-contradicting: it said a bare word:target is "treated as an ordinary local filename... including the exact word prefix a DuckDB storage extension uses," which the very next sentence then said IS treated as remote for md:/motherduck:/ducklake:. Reworded in the intended, unambiguous order: local-by-default, named exceptions (md:/motherduck:/ducklake:) are remote, scheme:// forces remote for anything else. docs/drivers.md's one-line pointer already used this order and doesn't have the same confusion — left unchanged. Gates: marker check --base origin/main --strict clean. This file is part of the same pre-existing-formatting-drift set established earlier in this PR (not reformatted, per established practice). Co-Authored-By: Claude Opus 4.8 <[email protected]> Claude-Session: https://claude.ai/code/session_01VqnuBDGkh1ZT65Ti7e6DHZ
1 parent 9ffa8b7 commit 7031ead

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

‎docs/docs/configure/warehouses.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -285,12 +285,12 @@ If you're already authenticated via `gcloud`, omit `credentials_path`:
285285

286286
!!! note "Bare `word:target` values are treated as local files"
287287
A `path` shaped like `word:target` with no `//` (for example
288-
`data:warehouse.duckdb`) is treated as an ordinary local filename, not a
289-
remote target — including the exact `word` prefix a DuckDB storage
290-
extension uses. Only a full `scheme://` URI (`s3://...`, `md://...`) or
291-
one of the specific bare schemes DuckDB extensions actually use —
292-
`md:`, `motherduck:`, `ducklake:` — is treated as remote. To target any
293-
other custom storage extension, use its `scheme://` form.
288+
`data:warehouse.duckdb`) is treated as an ordinary local filename by
289+
default. The only exceptions are `md:`, `motherduck:`, and `ducklake:` —
290+
these specific bare prefixes are recognized remote storage schemes and
291+
are always forwarded as remote targets. To force any other value to be
292+
treated as remote, use its full `scheme://` form (`s3://...`,
293+
`md://...`) instead of a bare prefix.
294294

295295
!!! note "Concurrent access"
296296
DuckDB does not support concurrent write access to the same file. If another process holds a write lock, Altimate Code automatically retries the connection in **read-only** mode so you can still query the data. A clear error message is shown if read-only access also fails.

0 commit comments

Comments
 (0)