list_files functie met tabelwaarde

Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 18 LTS en hoger

Important

Deze functie bevindt zich in de bètaversie.

Geeft de lijst van bestanden terug op een pad, inclusief een FILE referentie voor elk bestand.

Syntax

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

Arguments

  • path: Een STRING pad naar lijst. Kan een volumepad zijn, een extern locatiepad, of een pad op een ander bestandsopslagsysteem zoals SFTP, SharePoint of Google Drive.
  • connection: Een optionele Unity Catalog-verbinding die wordt gebruikt om te authenticeren met systemen zoals SFTP, SharePoint of Google Drive.
  • recursive: Een optioneel BOOLEAN hulpmiddel dat bepaalt of de functie in submappen wordt overgelaten. Geaccepteerde waarden zijn:
    • true: Geeft een lijst van bestanden in het pad en alle subdirectories, en geeft geen directories terug. Dit is de standaardwaarde.
    • false: Geeft alleen de directe vermeldingen van het pad weer en geeft directories terug met een nullfile referentie en een size van 0.

De connection en recursive argumenten moeten via naam worden doorgegeven met behulp van => syntaxis, bijvoorbeeld connection => my_conn.

Returns

Een tabel met één rij per bestand, met de volgende kolommen:

Rubriek Type Description
path STRING Het pad naar het bestand.
size BIGINT De grootte van het bestand, in bytes.
modification_time TIMESTAMP De laatste wijzigingstijd van het bestand, in UTC.
file FILE Een verwijzing naar het dossier.

Algemene foutvoorwaarden

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

Voor meer informatie, zie Foutvoorwaarden in Azure Databricks.

Examples

Om de bestanden in een volumemap te vermelden:

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

De functie geeft één rij per bestand terug:

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

Om bestanden van een extern systeem te vermelden via een Unity Catalog-verbinding:

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

Om alleen de directe vermeldingen van een directory te vermelden, zet recursive je op false:

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

Directories verschijnen in de resultaten met een nullfile referentie en een size van 0:

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

Om de totale grootte van alle bestanden in een map te berekenen, tel je de size kolom op. Omdat recursive standaard op true, omvat dit bestanden in subdirectories:

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

De query geeft de gecombineerde grootte in bytes terug:

total_bytes
1234
  • Laatst bijgewerkt om