Skip to content

Commit

Permalink
Document file: protocol
Browse files Browse the repository at this point in the history
  • Loading branch information
szarnyasg committed Jan 10, 2025
1 parent 8d8914d commit b45f15c
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 0 deletions.
4 changes: 4 additions & 0 deletions _data/menu_docs_dev.json
Original file line number Diff line number Diff line change
Expand Up @@ -1207,6 +1207,10 @@
{
"page": "Querying Parquet Files",
"url": "query_parquet"
},
{
"page": "File Access with the file: Protocol",
"url": "file_access"
}
]
},
Expand Down
17 changes: 17 additions & 0 deletions docs/guides/file_formats/file_access.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
layout: docu
title: "File Access with the file: Protocol"
---

DuckDB supports using the `file:` protocol. It currently supports the following formats:

* `file:/some/path` (host omitted completely)
* `file:///some/path` (empty host)
* `file://localhost/some/path` (`localhost` as host)

Note that the following formats are *not* supported because they are non-standard:

* `file:some/relative/path` (relative path)
* `file://some/path` (double-slash path)

Additionally, the `file:` protocol currently does not support remote (non-localhost) hosts.

0 comments on commit b45f15c

Please sign in to comment.