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.