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.