Oracle19c调用CSV导入存储过程报错ORA-29913

问题描述 #

我编写了名为load_csv_into_employee的存储过程，用于将CSV数据导入Oracle的EMPLOYEE表，但每次执行都会触发错误：ORA-29913: error in executing ODCIEXTTABLEOPEN callout。

已完成的排查动作：

• 以sys as sysdba身份创建了目录对象csv_dir，路径设置为\\dir\path\your_file.csv
• 为用户MyUserName授予了该目录的READ、WRITE权限
• 通过日志确认错误发生在执行INSERT INTO EMPLOYEE SELECT * FROM csv_table步骤

存储过程代码：

CREATE OR REPLACE PROCEDURE load_csv_into_employee AS
   v_count NUMBER;
BEGIN
   DBMS_OUTPUT.PUT_LINE('Checking if the external table already exists...');

   -- Check if the external table already exists
   SELECT COUNT(*)
   INTO v_count
   FROM user_tables
   WHERE table_name = 'CSV_TABLE';

   -- If the external table doesn't exist, create it
   IF v_count = 0 THEN
      DBMS_OUTPUT.PUT_LINE('Creating the external table...');
      EXECUTE IMMEDIATE '
         CREATE TABLE csv_table (
            EMPLOYEE_ID VARCHAR2(50),
            FIRST_NAME VARCHAR2(100),
            LAST_NAME VARCHAR2(100),
            DEPARTMENT VARCHAR2(200)
         )
         ORGANIZATION EXTERNAL (
            TYPE ORACLE_LOADER
            DEFAULT DIRECTORY csv_dir
            ACCESS PARAMETERS (
               RECORDS DELIMITED BY NEWLINE
               FIELDS TERMINATED BY '',''
               MISSING FIELD VALUES ARE NULL
            )
            LOCATION (''mssql_data.csv'')
         )';
   END IF;

   -- Insert data into EMPLOYEE
   DBMS_OUTPUT.PUT_LINE('Inserting data into EMPLOYEE...');
   EXECUTE IMMEDIATE '
      INSERT INTO EMPLOYEE
      SELECT * FROM csv_table';

   -- Drop the external table
   DBMS_OUTPUT.PUT_LINE('Dropping the external table...');
   EXECUTE IMMEDIATE 'DROP TABLE csv_table';

   DBMS_OUTPUT.PUT_LINE('Committing changes...');
   COMMIT;
EXCEPTION
   WHEN OTHERS THEN
      DBMS_OUTPUT.PUT_LINE('Error: ' || SQLERRM);
END load_csv_into_employee;
/

解决步骤 #

1. 修正目录对象路径 #

你创建csv_dir时指定的是具体文件路径，但Oracle目录对象必须指向文件夹路径，而非单个文件。执行以下语句修正：

CREATE OR REPLACE DIRECTORY csv_dir AS '\\dir\path\';
GRANT READ, WRITE ON DIRECTORY csv_dir TO MyUserName;

2. 检查操作系统层面的文件权限 #

Oracle数据库的运行账户（Windows下为OracleService<SID>，Linux下为oracle用户）需要具备访问共享目录\\dir\path\的权限：

• Windows：在共享文件夹的权限设置中，给Oracle服务账户添加读取权限
• Linux：若为SMB共享，需先挂载目录，并确保oracle用户对挂载点有读取权限

3. 调整外部表的访问参数 #

• 如果CSV是Windows生成的，换行符为\r\n，需修改参数：

  RECORDS DELIMITED BY '\r\n'
  

• 若CSV字段包含逗号（用双引号包裹），需添加字段包裹配置：

  FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
  

4. 验证文件名与路径匹配 #

• Linux/Unix环境下文件名区分大小写，确保LOCATION中的'mssql_data.csv'与实际文件名完全一致
• 确认文件确实存在于csv_dir指向的文件夹中

5. 获取底层错误详情 #

ORA-29913是外层错误，可通过以下语句查看具体的底层错误：

SELECT * FROM dba_errors WHERE name = 'CSV_TABLE';

6. 优化存储过程逻辑 #

• 无需每次删除重建外部表，可保留表结构复用
• 避免使用SELECT *插入，显式指定字段防止顺序不匹配：

  INSERT INTO EMPLOYEE (EMPLOYEE_ID, FIRST_NAME, LAST_NAME, DEPARTMENT)
  SELECT EMPLOYEE_ID, FIRST_NAME, LAST_NAME, DEPARTMENT FROM csv_table
  

内容的提问来源于stack exchange，提问作者alhambra