try_to_file Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 18 LTS and above

Importante

Esse recurso está em Beta.

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

Sintaxe

try_to_file(path)

Arguments

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

Returns

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

Essa função é a versão tolerante a erros da to_file função. Para coletar metadados de arquivos, o Azure Databricks faz uma chamada remota para o local de armazenamento do arquivo. Se o arquivo não existir ou estiver inacessível, essa função retorna 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 em um 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 retorna NULL:

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

NULL
  • Última atualização em