LOAD_FILE

描述

LOAD_FILE 函数基于外表接口，本地读取外部存储文件到数据库内。支持读取本地文件、HDFS、OSS、COS 和 S3 接口的文件。

使用前需先通过 CREATE LOCATION 创建 Location 对象，并在调用时指定 Location 名称与文件名。

语法

LOAD_FILE(location_name, file_name)

参数说明：

如果 location_name、file_name 参数中有一个为 NULL 时，则输出为 NULL。

返回值：

• BLOB 类型的数据，外部存储文件的内容。

注意事项

表达式类型与可见性

• 在 SELECT 列表等表达式上下文中调用时，与本文档中 LOAD_FILE(location_name, file_name) 的语义相同。
• 不可用于生成列。

错误与边界行为

配置项与场景约束

LOAD_FILE 需通过配置项约束和场景约束来确保安全性和稳定性。

使用 LOAD_FILE 表达式读取外部文件时，受以下两个配置项共同约束，以保证外部文件大小可控。实际允许读取的最大文件大小为两者中的较小值，即 有效最大文件大小 = min(max_allowed_packet, document_ai_file_max_size)

具体配置项信息如下：

示例

1. 读取本地文件（<= 16MB）

   -- 配置 Location 路径
   CREATE OR REPLACE LOCATION local_data
   URL = 'file:///home/';
   
   -- 读取本地文件
   SELECT load_file('local_data', 'test_16MB.pdf');
   

2. 读取本地文件（50MB）

   -- 配置 max_allowed_packet 大小为 100MB
   SET GLOBAL max_allowed_packet=104,857,600; 
   
   -- 读取本地文件
   select load_file('load_file', 'test_50MB.pdf');
   

3. 读取 OSS 文件

   CREATE LOCATION oss_t 
   URL = 'oss://dir' 
   CREDENTIAL = (
   ACCESSID = '123' 
   ACCESSKEY = '456' 
   HOST = '789'
   );
   -- 读取 OSS 文件
   SELECT load_file('oss_t', 'test_oss.pdf');
   

4. 读取 HDFS 文件

   CREATE LOCATION hdfs_user
   URL = 'hdfs://namenode:8020/'
   CREDENTIAL (
   USER = 'hdfs_user_name'
   );
   -- 读取 HDFS 文件
   SELECT load_file('hdfs_user', 'test_hdfs.pdf');
   

相关文档

• 创建与管理 Location 对象，参见 CREATE LOCATION、ALTER LOCATION、DROP LOCATION。
• document_ai_file_max_size。
• 与 AI 函数服务的配合使用，参见 AI 函数服务概述。