try_to_file Funkce

Platí pro:check marked yes Databricks SQL check marked yes Databricks Runtime 18 LTS and above

Important

Tato funkce je v beta verzi. Správci pracovního prostoru můžou řídit přístup k této funkci ze stránky Previews . Viz Manage Azure Databricks preview.

Vrátí hodnotu FILE , která odkazuje na soubor v bodě path, nebo NULL pokud soubor neexistuje nebo je nepřístupný.

Syntax

try_to_file(path)

Arguments

  • path: Výraz specifikující STRING cestu k souboru, například cestě v svazku Unity Catalog.

Returns

Hodnota, která odkazuje FILE na soubor v bodě path, nebo NULL pokud soubor neexistuje nebo je nepřístupný.

Tato funkce je chybově tolerantní verzí to_file funkce. Pro získání metadat souboru Azure Databricks provede vzdálené volání na místo uložení souboru. Pokud soubor neexistuje nebo je nepřístupný, tato funkce se vrátí NULL místo toho, aby vyvolala chybu.

Běžné chybové podmínky

  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Pro více informací viz Chybové podmínky v Azure Databricks.

Examples

Pro vytvoření FILE reference z cesty v objemu:

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

Pokud cesta neexistuje nebo je nepřístupná, try_to_file vrací NULL:

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

NULL
  • Last updated on