funktion try_to_file

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 18 LTS och senare

Important

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

Returnerar ett FILE värde som refererar till filen vid path, eller NULL om filen inte existerar eller är otillgänglig.

Syntax

try_to_file(path)

Arguments

  • path: Ett STRING uttryck som specificerar vägen till en fil, till exempel en väg i en Unity Catalog-volym.

Returns

Ett värde som refererar FILE till filen vid path, eller NULL om filen inte existerar eller är otillgänglig.

Denna funktion är den feltoleranta versionen av to_file funktionen. För att samla in filmetadata gör Azure Databricks ett fjärranrop till filens lagringsplats. Om filen inte existerar eller är otillgänglig returnerar NULL denna funktion istället för att ge ett felmeddelande.

Vanliga felvillkor

  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

För mer information, se Felvillkor i Azure Databricks.

Examples

För att skapa en FILE referens från en väg i en volym:

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

Om sökvägen inte existerar eller är otillgänglig try_to_file , returnerar NULL:

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

NULL
  • Last updated on