try_to_file функция

Область применения:check помечена да , проверка Databricks SQL помечено да Databricks Runtime 18 LTS и выше

Important

Эта функция доступна в бета-версии. Администраторы рабочей области могут управлять доступом к этой функции на странице "Предварительные версии ". См. статью "Управление предварительными версиями Azure Databricks".

Возвращает FILE значение, которое ссылается на файл по pathадресу , или NULL если файл не существует или недоступен.

Syntax

try_to_file(path)

Arguments

  • path: Выражение STRING , указывающее путь к файлу, например, путь в томе каталога Unity.

Returns

Значение FILE , которое ссылается на файл по pathадресу , или NULL если файл не существует или недоступен.

Эта функция является ошибочно-устойчивой версией функцииto_file. Для сбора метаданных файла Azure Databricks совершает удалённый вызов в адрес хранения файла. Если файл отсутствует или недоступен, эта функция возвращается NULL вместо того, чтобы выдавать ошибку.

Распространенные условия ошибки

  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Для получения дополнительной информации см. Ошибочные условия в Azure Databricks.

Examples

Чтобы создать ссылку FILE из пути в томе:

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

Если путь отсутствует или недоступен, try_to_file возвращает NULL:

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

NULL
  • Last updated on