List the contents of a directory, or details of the file.
db_dbfs_list(
path,
host = db_host(),
token = db_token(),
perform_request = TRUE
)
data.frame
The path of the new file. The path should be the absolute DBFS
path (for example /mnt/my-file.txt
).
Databricks workspace URL, defaults to calling db_host()
.
Databricks workspace token, defaults to calling db_token()
.
If TRUE
(default) the request is performed, if
FALSE
the httr2 request is returned without being performed.
When calling list on a large directory, the list operation will time out after approximately 60 seconds.
We strongly recommend using list only on
directories containing less than 10K files and discourage using the DBFS REST
API for operations that list more than 10K files. Instead, we recommend that
you perform such operations in the context of a cluster, using the File
system utility (dbutils.fs
), which provides the same functionality without
timing out.
If the file or directory does not exist, this call throws an exception with
RESOURCE_DOES_NOT_EXIST.
Other DBFS API:
db_dbfs_add_block()
,
db_dbfs_close()
,
db_dbfs_create()
,
db_dbfs_delete()
,
db_dbfs_get_status()
,
db_dbfs_mkdirs()
,
db_dbfs_move()
,
db_dbfs_put()
,
db_dbfs_read()