TRY_TO_FILE

Uma versão de TO_FILE que retorna NULL em vez de gerar um erro.

Sintaxe

Use uma das seguintes opções:

TRY_TO_FILE( <stage_name>, <relative_path> )

TRY_TO_FILE( <file_url> )

TRY_TO_FILE( <metadata> )

Argumentos

stage_name

O nome do estágio em que o arquivo está localizado, como uma cadeia de caracteres, no formato '@stage_name'.

relative_path

O caminho para o arquivo no estágio especificado por stage_name como uma cadeia de caracteres.

file_url

Um URL de arquivo com escopo ou estágio válido como uma cadeia de caracteres.

metadata

Um OBJECT contendo os metadados necessários do FILE. Um FILE deve ter os campos CONTENT_TYPE, SIZE, ETAG e LAST_MODIFIED. Ele também deve especificar o local do arquivo de uma das seguintes maneiras:

  • Tanto STAGE quanto RELATIVE_PATH

  • STAGE_FILE_URL

  • SCOPED_FILE_URL

Retornos

Um FILE ou NULL.

Notas de uso

Retorna NULL quando:

  • O URL fornecido não é válido.

  • O arquivo está em um estágio que o usuário não tem permissão para acessar.

  • Os metadados fornecidos não contêm os campos obrigatórios do FILE.

Exemplos

Consulte TO_FILE.