Categories:: Fonctions de fichiers (AI Functions)

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¶

Spécifiez le fichier en fournissant :

stage_name et relative_path
file_url
metadata

Une seule de ces méthodes peut être utilisée à la fois.

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 attributs FILE requis. 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 ne peut pas accéder.
Les métadonnées fournies ne contiennent pas les champs FILE requis.

Exemples¶

Contrairement à TO_FILE, qui signale une erreur sur des arguments non valides, TRY_TO_FILE renvoie NULL dans ce cas. Sinon, cela fonctionne exactement comme TO_FILE.

L’exemple ci-dessous illustre le comportement de TRY_TO_FILE lorsque le chemin du fichier n’est pas valide, en supposant que le fichier image.png existe sur la zone de préparation, mais pas les deux autres fichiers.

SELECT
    TRY_TO_FILE('@mystage/image.png'),
    TRY_TO_FILE('@mystage/incorrect_file1.jpg'),
    TRY_TO_FILE('@mystage', 'incorrect_file2.png');

Résultat :

+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+
| TRY_TO_FILE('@MYSTAGE/IMAGE.PNG')                   | TRY_TO_FILE('@MYSTAGE/INCORRECT_FILE1.JPG') | TRY_TO_FILE('@MYSTAGE', 'INCORRECT_FILE2.PNG') |
|-----------------------------------------------------|---------------------------------------------|------------------------------------------------|
| {                                                   | NULL                                        | NULL                                           |
|   "CONTENT_TYPE": "image/png",                      |                                             |                                                |
|   "ETAG": "2859efde6e26491810f619668280a2ce",       |                                             |                                                |
|   "LAST_MODIFIED": "Thu, 18 Sep 2025 09:02:00 GMT", |                                             |                                                |
|   "RELATIVE_PATH": "image.png",                     |                                             |                                                |
|   "SIZE": 23698,                                    |                                             |                                                |
|   "STAGE": "@MYDB.MYSCHEMA.MYSTAGE"                 |                                             |                                                |
| }                                                   |                                             |                                                |
+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+

Pour plus d’exemples de création d’objets FILE à partir d’entrées valides, consultez les exemples TO_FILE.