Funzione to_file

Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime 18 LTS e versioni successive

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Restituisce un FILE valore che fa riferimento al file in path.

Sintassi

to_file(path)

Arguments

  • path: Un'espressione STRING che specifica il percorso verso un file. Ad esempio, un percorso in un volume del Catalogo Unity.

Returns

Un FILE valore che fa riferimento al file in path.

Per raccogliere i metadati dei file, Azure Databricks effettua una chiamata remota alla posizione di archiviazione del file. Se il file non esiste o è inaccessibile, Azure Databricks genera un errore. Per tornare a indietro NULL , usa try_to_file la funzione.

Condizioni di errore comuni

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Per maggiori informazioni, vedi Condizioni di errore in Azure Databricks.

Examples

Per creare un FILE riferimento da un percorso in un volume:

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Se il percorso non esiste o l'utente non ha il permesso di lettura, to_file si genera un errore:

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on