TRY_TO_FILE¶
Une version de TO_FILE qui renvoie NULL au lieu de provoquer une erreur.
Syntaxe¶
Utilisez l’une des méthodes suivantes :
TRY_TO_FILE( <stage_name>, <relative_path> ) TRY_TO_FILE( <file_url> ) TRY_TO_FILE( <metadata> )
Arguments¶
stage_name
Le nom de la zone de préparation où se trouve le fichier, sous forme de chaîne, au format
‘@stage_name'
.relative_path
Le chemin d’accès au fichier de la zone de préparation spécifiée par
stage_name
sous forme de chaîne.file_url
Une zone de préparation ou une URL de fichier limitée valide sous la forme d’une chaîne.
metadata
Un OBJECT contenant les métadonnées FILE requises. Un FILE doit comporter les champs CONTENT_TYPE, SIZE, ETAG et LAST_MODIFIED. Il doit également spécifier l’emplacement du fichier de l’une des manières suivantes :
Les deux valeurs STAGE et RELATIVE_PATH
STAGE_FILE_URL
SCOPED_FILE_URL
Renvoie¶
Un FILE ou NULL.
Notes sur l’utilisation¶
Renvoie NULL lorsque :
L’URL fournie n’est pas valide.
Le fichier se trouve sur une zone de préparation à laquelle l’utilisateur n’a pas l’autorisation d’accéder.
Les métadonnées fournies ne contiennent pas les champs FILE requis.
Exemples¶
Voir TO_FILE.