try_to_file függvény

A következőre vonatkozik:yes Databricks SQL check mark yes Databricks Runtime 18 LTS and above

Important

Ez a funkció bétaverzióban érhető el. A munkaterület rendszergazdái az Előnézetek lapon szabályozhatják a funkcióhoz való hozzáférést. Lásd: Az Azure Databricks előzetes verziójának kezelése.

Visszaad egy FILE értéket, amely a fájlra hivatkozik , vagy pathNULL ha a fájl nem létezik vagy elérhetetlen.

Szemantika

try_to_file(path)

Arguments

  • path: Egy STRING kifejezés, amely megadja a fájl útját, például egy út egy Unity Catalog kötetben.

Returns

Egy FILE érték, amely a fájlra hivatkozik , pathvagy NULL ha a fájl nem létezik vagy elérhetetlen.

Ez a függvény a hibatűrő to_file változata. A fájl metaadatok gyűjtéséhez az Azure Databricks távoli hívást indít a fájl tárolóhelyére. Ha a fájl nem létezik vagy elérhetetlen, ez a függvény visszatér NULL , nem hibát okozna.

Gyakori hibafeltételek

  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

További információért lásd: Hibafeltételek az Azure Databricks-ben.

Examples

Egy kötetben lévő útból referencia FILE létrehozása:

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

Ha az út nem létezik vagy elérhetetlen, try_to_file akkor a következő:NULL

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