try_to_file Função

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

Devolve um FILE valor que faz referência ao ficheiro em path, ou NULL se o ficheiro não existir ou for inacessível.

Syntax

try_to_file(path)

Arguments

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

Devoluções

Um FILE valor que faz referência ao ficheiro em path, ou NULL se o ficheiro não existir ou for inacessível.

Esta função é a versão tolerante a erros da to_file função. 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, esta função devolve NULL em vez de gerar um erro.

Condições de erro comuns

• 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 try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Se o caminho não existir ou for inacessível, try_to_file devolve NULL:

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

NULL

Funções relacionadas

• to_file Função
• create_file Função
• copy_file Função
• try_copy_file Função
• list_files função com valor de tabela
• read_files função com valor de tabela
• FILE tipo