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. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

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
  • Last updated on