FL_GET_SCOPED_FILE_URL

Returns the scoped URL of a FILE.

Syntax

Use one of the following:

FL_GET_SCOPED_FILE_URL( <stage_name>, <relative_path> )

FL_GET_SCOPED_FILE_URL( <file_url> )

FL_GET_SCOPED_FILE_URL( <metadata> )

Arguments

stage_name

The name of the stage where the file is located, as a string, in the form '@stage_name'.

relative_path

The path to the file on the stage specified by stage_name as a string.

file_url

A valid stage or scoped file URL as a string.

metadata

An OBJECT containing all the required FILE metadata. A FILE must have CONTENT_TYPE, SIZE, ETAG, and LAST_MODIFIED fields, plus the file’s location (that is, STAGE plus RELATIVE_PATH, STAGE_FILE_URL, or SCOPED_FILE_URL).

Returns

The scoped URL 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_SCOPED_FILE_URL('@mystage', 'image.png'));

SELECT FL_GET_SCOPED_FILE_URL(f) FROM file_table;
Copy
+--------------------------------------------------------------------------------------------------------------------+
| FL_GET_SCOPED_FILE_URL(F)                                                                                          |
|--------------------------------------------------------------------------------------------------------------------|
| https://snowflake.account.snowflakecomputing.cn/api/files/01ba4df2-0100-0001-0000-00040002e2b6/299017/Y6JShH6KjV  |
+--------------------------------------------------------------------------------------------------------------------+

Example using an input OBJECT:

CREATE TABLE file_table(f OBJECT);
INSERT INTO file_table SELECT OBJECT_CONSTRUCT('SCOPED_FILE_URL', 'https://snowflake.account.snowflakecomputing.cn/api/files/01ba4df2-0100-0001-0000-00040002e2b6/299017/Y6JShH6KjV',
  'ETAG', '<ETAG value>', 'LAST_MODIFIED', 'Wed, 11 Dec 2024 20:24:00 GMT', 'SIZE', 105859, 'CONTENT_TYPE', 'image/jpg');

SELECT FL_GET_SCOPED_FILE_URL(f) FROM file_table;
Copy
+--------------------------------------------------------------------------------------------------------------------+
| FL_GET_SCOPED_FILE_URL(F)                                                                                          |
|--------------------------------------------------------------------------------------------------------------------|
| https://snowflake.account.snowflakecomputing.cn/api/files/01ba4df2-0100-0001-0000-00040002e2b6/299017/Y6JShH6KjV  |
+--------------------------------------------------------------------------------------------------------------------+
Language: English