list_files táblaértékű függvény

A következőre vonatkozik:yes Databricks SQL check mark yes Databricks Runtime 18 LTS and above

Important

Ez a funkció bétaverzióban érhető el. A munkaterület rendszergazdái az Előnézetek lapon szabályozhatják a funkcióhoz való hozzáférést. Lásd: Az Azure Databricks előzetes verziójának kezelése.

Visszaadja a fájlok listáját egy útvonalon, beleértve az egyes fájlokhoz vonatkozó hivatkozást FILE .

Szemantika

list_files(path [, connection => connection ] [, recursive => recursive ])

Arguments

  • path: Egy STRING listázási útvonal. Lehet egy kötetútvonal, külső helymeghatározási útvonal, vagy egy másik fájltároló rendszer, például SFTP, SharePoint vagy Google Drive útvonala.
  • connection: Egy opcionális Unity Catalog kapcsolat, amelyet olyan rendszerekkel való hitelesítésre használnak, mint az SFTP, a SharePoint vagy a Google Drive.
  • recursive: Egy opcionális BOOLEAN , amely szabályozza, hogy a függvény alkönyvtárakba süllyed-e. Az elfogadott értékek a következők:
    • true: Felsorolja a fájlokat az úton és az összes alkönyvtárat, és nem adja vissza a könyvtárakat. Ez az alapértelmezett érték.
    • false: Csak az út közvetlen bejegyzéseit sorolja fel, és visszaadja a könyvtárakat egy nullfile hivatkozással és size egy .0

Az connection és recursive érveket név szerint kell átadni szintaxissal => , például connection => my_conn.

Returns

Egy táblázat, amelynek fájlonként egy sor, a következő oszlopokkal:

oszlop Típus Description
path STRING A fájl elérési útja.
size BIGINT A fájl mérete bájtban.
modification_time TIMESTAMP A fájl utolsó módosítási ideje, UTC-ben.
file FILE Hivatkozás a fájlra.

Gyakori hibafeltételek

  • LIST_FILES_AUTHORIZATION_ERROR.ON_PATH
  • LIST_FILES_AUTHORIZATION_ERROR.ON_CONNECTION
  • LIST_FILES_ERROR.PATH_NOT_EXISTS
  • LIST_FILES_ERROR.CONNECTION_NOT_EXISTS

További információért lásd: Hibafeltételek az Azure Databricks-ben.

Examples

A fájlok felsorolása egy kötetkönyvtárban:

SELECT * FROM list_files('/Volumes/my_catalog/my_schema/my_volume/');

A függvény fájlonként egy sort ad vissza:

path                                                 size   modification_time         file
/Volumes/my_catalog/my_schema/my_volume/file1.json   1234   2026-04-11 00:00:00.000   <file>

Külső rendszerű fájlok listázásához Unity Catalog kapcsolattal:

SELECT path, size FROM list_files('https://drive.google.com/drive/folders/my-folder-id', connection => my_gdrive_connection);

Csak a könyvtár közvetlen bejegyzéseinek felsorolásához recursive állítsuk be:false

SELECT * FROM list_files('/Volumes/my_catalog/my_schema/my_volume/', recursive => false);

Az eredményekben a könyvtárak egy nullfile hivatkozással és a size következőkkel 0jelennek meg:

path                                                 size   modification_time         file
/Volumes/my_catalog/my_schema/my_volume/file1.json   1234   2026-04-11 00:00:00.000   <file>
/Volumes/my_catalog/my_schema/my_volume/subdir/      0      2026-04-11 00:00:00.000   NULL

A könyvtár összes fájljának összesített méretének kiszámításához összesítjük az size oszlopot. Mivel recursive alapértelmezettként , trueez tartalmazza a fájlokat az alkönyvtárakban:

SELECT sum(size) AS total_bytes FROM list_files('/Volumes/my_catalog/my_schema/my_volume/');

A lekérdezés a bájtokban összesített méretet adja vissza:

total_bytes
1234
  • Last updated on