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.

Syntax

to_file(path)

Arguments

  • path: Výraz specifikující STRING cestu k souboru. Například cesta v svazku Unity Catalog.

Returns

Hodnota, která odkazuje FILE na soubor v bodě path.

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ý, Azure Databricks zobrazí chybu. Pro vrácení NULL použijte try_to_file funkci.

Běžné chybové podmínky

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • 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 to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Pokud cesta neexistuje nebo uživatel nemá oprávnění ke čtení, to_file zobrazí se chyba:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on