FL_GET_STAGE¶

Returns the stage name of a FILE.

Syntax¶

Use one of the following:

FL_GET_STAGE( <scoped_url> )

FL_GET_STAGE( <metadata> )

Arguments¶

scoped_url: A valid scoped file URL.
metadata: An OBJECT containing all the required FILE metadata.

Returns¶

The stage of the file as a VARCHAR.

Examples¶

Example using an input FILE:

CREATE TABLE file_table(f FILE);
INSERT INTO file_table select TO_FILE(BUILD_STAGE_FILE_URL('@mystage', 'image.png'));

SELECT FL_GET_STAGE(f) FROM file_table;

Copy

+------------------------+
| FL_GET_STAGE(F)        |
|------------------------|
| MYSTAGE                |
+------------------------+

Example using an input OBJECT:

CREATE TABLE file_table(f OBJECT);
INSERT INTO file_table SELECT OBJECT_CONSTRUCT('STAGE', 'MYSTAGE', 'RELATIVE_PATH', 'image.jpg', 'ETAG', '<ETAG value>',
  'LAST_MODIFIED', 'Wed, 11 Dec 2024 20:24:00 GMT', 'SIZE', 105859, 'CONTENT_TYPE', 'image/jpg');

SELECT FL_GET_STAGE(f) FROM file_table;

Copy

+------------------------+
| FL_GET_STAGE(F)        |
|------------------------|
| MYSTAGE                |
+------------------------+