SQL 文件访问

任何指定服务器端文件路径的 SQL 语句,只有当 sys 租户账号在会话中激活 moadmin 角色执行时才能打开该路径。表上的 SELECT、INSERT 等表级权限不会授予对 MatrixOne 主机服务器上文件的访问,也不存在任何宽松的回退模式。

受限的文件路径

受限路径指由 MatrixOne 服务在服务器主机或服务器端存储中打开的任何路径,包括:

  • 未带服务名的本地文件路径,相对于 MatrixOne 主机文件系统解析。

  • 由 CREATE STAGE 创建的 stage 引用。

  • 经由指定对象存储服务解析的路径,或由对象存储支持的动态 provider。

以下语句会读取或写入这类路径,受准入检查约束:

  • 服务器端路径上的 LOAD DATA ... INFILE。

  • SELECT ... INTO OUTFILE 及其他服务器端导出路径。

  • load_file() 与 save_file()。

  • 面向文件的表函数,如 parse_jsonl_file()。

  • 外部读取,包括 external 表、Hive 格式读取器,以及其他由服务器端文件或对象存储支持的读取器。

  • 表 dump/load 操作。

  • 指定服务器端位置的 CREATE SNAPSHOT 等 backup SQL。

  • 间接解析服务器端路径的 Datalink 使用方。

以下路径不受限,因为文件在客户端读取或写入,不会打开服务器资源:

  • LOAD DATA LOCAL INFILE,其文件由客户端读取后推送到服务端。

  • INLINE 数据与内联表函数,如 parse_jsonl_data(),其数据内联在语句文本中。

准入要求

该检查逐条语句执行,针对语句的会话身份:

  • 会话必须以 sys 租户账号认证,且语句执行时会话中激活的角色为 moadmin。

  • 身份在每条语句上都重新判定,不做缓存。执行 set role public 后,先前成功或已 prepare 的语句会被拒绝;执行 set role moadmin 后,同一语句重新获得准入。

  • 表上的对象权限(如 SELECT、INSERT)不能替代该检查。被授予全部表权限的用户仍不能读写服务器文件。

  • 不存在宽松的回退模式:激活身份不满足检查时,语句以 only the sys account moadmin role can access SQL file paths 报错。

语法

set role moadmin;
set role public;

参数

  • 该检查只针对当前语句评估会话的租户账号与激活角色,登录账号与激活角色都不跨语句缓存。

  • 目标表上的对象权限不能替代租户账号与角色要求。

  • 该检查不依赖 secure_file_priv,本边界不强制该变量。

示例

下面的示例展示激活角色不是 moadmin 的会话中该检查的形态。会话先创建一张小表,切换到 public 角色后,SELECT ... INTO OUTFILE 语句被拒绝,报错 only the sys account moadmin role can access SQL file paths。示例使用一个临时演示数据库和本地导出路径;实际部署中应将其替换为你要写入的服务器端路径或 stage。

DROP DATABASE IF EXISTS sql_file_access_demo_db;
CREATE DATABASE sql_file_access_demo_db;
USE sql_file_access_demo_db;
CREATE TABLE demo_src(id INT PRIMARY KEY, note VARCHAR(100));
INSERT INTO demo_src VALUES(1,'first'),(2,'second');
SET ROLE public;
-- Expected-Success: false
SELECT id, note FROM demo_src INTO OUTFILE '/tmp/demo_src.csv';
SET ROLE moadmin;
DROP DATABASE sql_file_access_demo_db;

在 public 角色激活期间,SELECT ... INTO OUTFILE 被身份检查拒绝。执行 SET ROLE moadmin 后再运行同一语句即可通过检查,因为身份在每条语句上重新判定,不做缓存。注意,使用 set role moadmin 或 set role public 切换激活角色后,下一条语句的结果立即改变,包括在切换前已经 prepare 的语句。

动态 provider 与凭证

对 SQL 语句使用的动态对象存储 provider,除身份检查外还会校验 provider 描述:

  • 动态 provider 不得依赖服务器本地辅助文件:cert-files、kerberos-keytab-path 等证书与 keytab 参数会被拒绝,报错为 SQL dynamic providers cannot use server-local auxiliary files。

  • shared-config-profile 等服务器凭证发现机制会被拒绝,报错为 SQL dynamic providers cannot use server credential discovery。

  • 必须显式提供凭证:无可用凭证的 provider 报错 SQL dynamic object storage requires explicit credentials。

  • MO_NO_DEFAULT_CREDENTIALS 环境变量与 NoDefaultCredentialsForETL 设置不影响 SQL 凭证行为;动态 provider 的凭证必须在 provider 描述中显式给出。

  • 显式声明的场景下,simple 认证的 HDFS、带 BearerToken 的 Aliyun OSS、以及显式匿名凭证的 MinIO 仍然可用。

部署注意事项

  • 只有当集群内所有提供 SQL 服务的 CN 都完成升级后,该边界才完整生效。仍运行旧版本的 CN 可能准许升级后版本拒绝的语句,因此应先完成升级再依赖该限制。

  • 本地文件支持的异步索引 Datalink 源在该边界下成为仅限远程。迁移方式:将既有本地文件源改指向远程服务并重建索引,或在升级前使用前台 load_text 加载,将本地内容物化到 TEXT 列。

  • v4.2.7 之前生成的既有归档不携带物理恢复所需的 table-ID 历史对象,因此改进后的 table-ID 历史检查无法回溯修补这些归档;使用该历史的恢复行为参见备份与恢复概述。