类别：

:doc:`/sql-reference/functions-file`（AI 函数）

FL_GET_SCOPED_FILE_URL

返回 FILE 的作用域 URL。

语法

使用下列之一：

FL_GET_SCOPED_FILE_URL( <file_expression> )

FL_GET_SCOPED_FILE_URL( <variant_expression> )

实参

file_expression

实参必须是 FILE 类型的表达式。

variant_expression

该实参必须是代表 FILE 的 OBJECT。

返回

作为 VARCHAR 文件的作用域 URL。

示例

使用输入 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;

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

使用输入 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;

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