to_file функция

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

Important

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

Возвращает FILE значение, ссылающееся на файл в path.

Syntax

to_file(path)

Arguments

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

Returns

ЗначениеFILE, ссылающееся на файл в .path

Для сбора метаданных файла Azure Databricks совершает удалённый вызов в адрес хранения файла. Если файл отсутствует или недоступен, Azure Databricks выдает ошибку. Чтобы вернуть NULL , используйте try_to_file функцию.

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

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

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

Examples

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

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

Если путь отсутствует или у пользователя нет права на чтение, to_file возникает ошибка:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on