to_file Função

Aplica-se a:assinalado Databricks SQL assinalado sim Databricks Runtime 18 LTS e superiores

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Devolve um FILE valor que faz referência ao ficheiro em path.

Syntax

to_file(path)

Arguments

  • path: Uma STRING expressão que especifica o caminho para um ficheiro. Por exemplo, um caminho num volume do Unity Catalog.

Devoluções

Um FILE valor que faz referência ao ficheiro em path.

Para recolher metadados dos ficheiros, o Azure Databricks faz uma chamada remota para a localização de armazenamento do ficheiro. Se o ficheiro não existir ou for inacessível, o Azure Databricks gera um erro. Para voltar NULL em vez disso, use try_to_file função.

Condições de erro comuns

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

Para mais informações, veja Condições de erro no Azure Databricks.

Examples

Para criar uma FILE referência a partir de um caminho num volume:

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

Se o caminho não existir ou o utilizador não tiver permissão de leitura, to_file gera um erro:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on