to_file Función

Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 18 LTS y versiones posteriores

Importante

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Devuelve un FILE valor que hace referencia al archivo en path.

Syntax

to_file(path)

Arguments

  • path: Una STRING expresión que especifica la ruta hacia un archivo. Por ejemplo, un camino en un volumen del Catálogo de Unity.

Devoluciones

Un FILE valor que hace referencia al archivo en path.

Para recopilar metadatos de archivos, Azure Databricks realiza una llamada remota a la ubicación de almacenamiento del archivo. Si el archivo no existe o es inaccesible, Azure Databricks genera un error. Para volver NULL en su lugar, usa try_to_file función.

Condiciones de error comunes

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

Para más información, consulta Condiciones de error en Azure Databricks.

Examples

Para crear una FILE referencia a partir de un camino en un volumen:

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

Si la ruta no existe o el usuario no tiene permiso de lectura, to_file genera un error:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on