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 历史检查无法回溯修补这些归档;使用该历史的恢复行为参见备份与恢复概述。