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

StarRocks 中文参考:FILE

· 52CE 我爱测

FILE 是一种标量类型,用于描述一个文件或文件内部的一段字节。FILE 值包含一组固定字段,可通过 函数提取。

FILE

FILE 是一种标量类型,用于描述一个文件或文件内部的一段字节。FILE 值包含一组固定字段,可通过 FL_GET_* 函数提取。

目前 FILE 类型不支持持久化。FILE 值可以从 External Catalog 获取,也可以通过 TO_FILE 或 TRY_TO_FILE 构造。函数语法和示例参见 FILE 函数。

结构

每个 FILE 值都按以下顺序包含相同的字段,每个字段都可以为 NULL。

字段 类型 说明
uri VARCHAR 文件位置,例如对象存储或 HDFS 路径。
offset BIGINT 被引用内容在文件内的起始字节位置。
size BIGINT 被引用内容的字节数,从 offset 开始计算。
content_type VARCHAR 内容的媒体类型,例如 image/png。
checksum VARCHAR 被引用内容的校验值。
inline VARBINARY 直接存放在值中的内容本身,而不是通过 uri 引用。

一个 FILE 值属于以下两种形式之一:

  • 引用:uri 有值,通常同时带有 offset 和 size,inline 为 NULL。
  • 内联内容:inline 保存内容字节,uri、offset 和 size 必须均为 NULL。

输出格式

FILE 值以类 JSON 的对象形式输出,列出全部字段:

{"uri":"s3://bucket/images/a.png","offset":4,"size":8,"content_type":null,"checksum":null,"inline":null}
{"uri":null,"offset":null,"size":null,"content_type":null,"checksum":null,"inline":"89504e470d0a1a0a"}

inline 字节的编码方式由会话变量 binary_encoding_format 控制。

使用限制

  • FILE 不能作为 CREATE TABLE、CREATE TABLE AS SELECT 或物化视图中的列类型。
  • FILE 值不能比较、排序、分组、作为 JOIN 条件、与 DISTINCT 一起使用、与其他类型互相转换,也不能作为窗口函数的参数。
  • 支持 IS NULL 和 IS NOT NULL。

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

资料来源与适用范围

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

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

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