Cos'è l'API dei File?

L'API Files è una API HTTP standard che permette di leggere, scrivere, elencare e cancellare file e directory facendo riferimento al loro URI. L'API rende più facile ed efficiente lavorare con il contenuto dei file come byte grezzi.

L'API supporta Unity Catalog volumi, dove si specificano file e directory su cui operare usando il loro percorso URI di volume, che segue il formato /Volumes/<catalog_name>/<schema_name>/<volume_name>/<path_to_file>. Il percorso è sempre assoluto.

L'API Files ha due endpoint distinti: uno per lavorare con file (/fs/files) e un altro per gestire directory (/fs/directories). Entrambi i punti finali utilizzano i metodi HTTP standard GET, GET, HEAD, PUT, DELETE e POST per gestire file e directory specificati dal loro percorso URI. Per ogni operazione e i suoi parametri, vedi il riferimento Files API 3.0.

L'uso dell'API Files può comportare costi per il trasferimento dati di Azure Databricks.

Capabilities

Con l'API Files, puoi:

• Carica un file fino a 5000 MiB in una singola richiesta, oppure carica un file più grande in parti con upload multipartito.
• Scarica un intero file in una singola richiesta, oppure scaricane una parte con l'header Range. Vedi Scaricare file di grandi dimensioni con richieste di intervallo.
• Fai dipendere una lettura, scrittura o cancellazione dalla data e ora di accesso ETag o di modifica Last-Modified correnti di un file con richieste condizionate.

Requirements

• Invia richieste al nome host regionale del tuo workspace. Vedi Usa la Files API con il nome host regionale.
• Connettività di rete con Azure Databricks e con il tuo storage. Vedi connettività di rete per l'API Files.

Versions

L'API File ha due versioni. Per capire cosa è cambiato tra di essi, consulta Versioni dell'API dei file.