funktion 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.

Syntax

to_file(path)

Arguments

  • path: Ett uttryck som STRING specificerar sökvägen till en fil. Till exempel en väg i en Unity-katalogvolym.

Returns

Ett värde som refererar FILE till filen vid path.

För att samla in filmetadata gör Azure Databricks ett fjärranrop till filens lagringsplats. Om filen inte finns eller är otillgänglig ger Azure Databricks ett felmeddelande. För att återvända NULL istället, använd try_to_file funktion.

Vanliga felvillkor

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

Om sökvägen inte finns eller användaren saknar läsbehörighet, to_file ger det ett fel:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on