Funzione try_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, oppure NULL se il file non esiste o è inaccessibile.

Sintassi

try_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 a path, oppure NULL se il file non esiste o è inaccessibile.

Questa funzione è la versione tollerante all'errore della to_file funzione. 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, questa funzione restituisce NULL invece di generare un errore.

Condizioni di errore comuni

  • 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 try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Se il percorso non esiste o è inaccessibile, try_to_file restituisce NULL:

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

NULL
  • Last updated on