大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:to_file

· 52CE 我爱测

# to_file 根据 STRUCT 表达式构造临时 FILE 值,支持 和 STRUCT 列。本函数不访问存储,也不推断元信息。 ## 语法 ## 参数 :描述文件的 STRUCT 表达式。可以使用以下字段: | 字段 | 接受的输入类型 | FILE 字段类型 | |---|---|---| | , , | CHAR, VARCHAR | VARCHAR | | , | TINYINT, SMALLINT, INT, BIGINT

to_file

根据 STRUCT 表达式构造临时 FILE 值,支持 named_struct(...) 和 STRUCT 列。本函数不访问存储,也不推断元信息。

语法

FILE to_file(STRUCT struct_expr)

参数

struct_expr:描述文件的 STRUCT 表达式。可以使用以下字段:

字段 接受的输入类型 FILE 字段类型
uri, content_type, checksum CHAR, VARCHAR VARCHAR
offset, size TINYINT, SMALLINT, INT, BIGINT BIGINT
inline VARBINARY VARBINARY

返回值

返回 FILE 值。struct_expr 为 NULL 时返回 NULL。

使用说明

  • 字段名称大小写不敏感,顺序不限。未知或重复字段名在分析阶段报错。
  • 缺失字段和显式 NULL 均填为 NULL,不补默认值,包括 offset 和 size。
  • 对于每个非 NULL STRUCT,uri 和 inline 必须恰好一个非 NULL;字段缺失等同于 NULL。
  • 整数输入扩宽为 BIGINT。每个字段都接受未定型 NULL。其他输入类型需要显式 CAST。
  • URI 引用的 offset、size 可以为 NULL;非 NULL 值必须大于等于 0。内联内容的 offset、size 必须均为 NULL。任意一行违反此规则或 uri/inline 二选一规则,查询都会失败。如需对这类行返回 NULL,请使用 try_to_file。
  • 不校验 URI 格式、MIME 类型、校验和,以及引用的字节范围。
  • inline 保存原始字节。空字符串和零长度二进制值仍算非 NULL,并会被保留。

示例

示例 1:构造文件引用

SELECT to_file(named_struct('uri', 'https://example.com/a.jpg', 'content_type', 'image/jpeg')) AS f;
+-------------------------------------------------------------------------------------------------------------------------+
| f                                                                                                                       |
+-------------------------------------------------------------------------------------------------------------------------+
| {"uri":"https://example.com/a.jpg","offset":null,"size":null,"content_type":"image/jpeg","checksum":null,"inline":null} |
+-------------------------------------------------------------------------------------------------------------------------+

示例 2:构造内联内容

SELECT to_file(named_struct('inline', to_binary('610062', 'hex'))) AS f;
+----------------------------------------------------------------------------------------------+
| f                                                                                            |
+----------------------------------------------------------------------------------------------+
| {"uri":null,"offset":null,"size":null,"content_type":null,"checksum":null,"inline":"610062"} |
+----------------------------------------------------------------------------------------------+

示例 3:NULL 参数

SELECT to_file(NULL) AS f;
+------+
| f    |
+------+
| NULL |
+------+

keyword

TO_FILE, FILE

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。