ORA-31660报错咋整，元数据过滤名不能默认，远程帮你修复故障

关于ORA-31660错误的处理，以下是直接整理自相关技术资料的内容，供您参考：

错误解释 ORA-31660错误通常在Oracle数据泵（Data Pump）工具中使用FULL模式进行导出操作时出现，其完整错误信息通常为“ORA-31660: 在FULL模式下请求了FULL数据库导出作业，但未指定METADATA_FILTER”，根据Oracle官方文档（Oracle Database Utilities文档）的解释，这个错误的核心原因是：当您指定了FULL=Y模式进行全库导出时，如果同时在命令中使用了排除（EXCLUDE）或包含（INCLUDE）这类元数据过滤器来限定某些对象（例如排除某个用户），则必须额外指定一个METADATA_FILTER参数来明确这个过滤操作是针对整个数据库范围的，简单说，系统需要你明确告诉它“这个排除动作是在全库背景下执行的”，而不能默认推断。

问题根源 这个错误的设计初衷与数据泵的工作机制有关，在FULL模式下，数据泵预期操作的是整个数据库，当你添加了EXCLUDE=SCHEMA:"='HR'"这样的子句时，你实际上是在全库操作的基础上附加了一个条件，为了避免歧义，数据泵要求你必须显式地通过METADATA_FILTER参数来声明这个过滤条件适用于“整个数据库上下文”，如果不提供这个声明，工具就无法确认过滤器的应用范围，从而抛出ORA-31660错误，这并非一个真正的故障，而更像是一个严格的语法检查规则。

解决方法 解决此错误的方法是：在您的数据泵导出（expdp）命令中，添加一个METADATA_FILTER参数，该参数的值需要与你的排除或包含操作所针对的对象类型相对应。

具体操作步骤（以排除用户为例） 假设您原本的导出命令类似于：

expdp directory=DATA_PUMP_DIR dumpfile=full_excl.dmp full=Y exclude=schema:"='HR'"

这个命令会触发ORA-31660错误。

修改后的正确命令应加入METADATA_FILTER：

expdp directory=DATA_PUMP_DIR dumpfile=full_excl.dmp full=Y \
exclude=schema:"='HR'" \
metadata_filter="SCHEMA_EXPR: 'IN (SELECT USERNAME FROM DBA_USERS WHERE USERNAME NOT IN (''HR''))'"

关键点说明

1. 参数格式：METADATA_FILTER参数的值是一个字符串，其基本格式为“OBJECT_TYPE_COLUMN: '子查询或表达式'”，其中OBJECT_TYPE_COLUMN取决于你要过滤的对象类型，对于模式（用户）过滤，常用的是SCHEMA_EXPR；对于表过滤，则可能是TABLE_EXPR，具体的列名需要参考Oracle官方文档（Oracle Database Utilities中关于Data Pump API的部分）。
2. ：参数的值通常是一个SQL表达式或子查询，用于动态确定要包含或排除的对象列表，在上面的例子中，子查询(SELECT USERNAME FROM DBA_USERS WHERE USERNAME NOT IN ('HR'))定义了导出范围包括除HR之外的所有用户。
3. 引号处理：在命令行或参数文件中，引号的使用需要谨慎，在Unix/Linux shell中，通常需要多层转义，上述示例中，两个单引号用于在子查询字符串字面量中表示一个单引号，在实际操作中，强烈建议将命令参数写入一个参数文件（PARFILE）来避免复杂的引号转义问题。
4. 使用参数文件（推荐）： 创建一个文本文件（如parfile.txt如下：

   directory=DATA_PUMP_DIR
   dumpfile=full_excl.dmp
   full=Y
   exclude=schema:"='HR'"
   metadata_filter="SCHEMA_EXPR: 'IN (SELECT USERNAME FROM DBA_USERS WHERE USERNAME NOT IN (''HR''))'"

   然后执行命令：

   expdp parfile=parfile.txt

   这可以极大地简化命令的编写和调试。

其他注意事项

• 权限：执行全库导出的用户通常需要具有DATAPUMP_EXP_FULL_DATABASE角色或同等的高权限。
• 版本差异：METADATA_FILTER参数在较新的Oracle数据库版本（如11gR2及以后）中更常见，如果您在旧版本中遇到类似问题，解决方式可能有所不同，需查阅对应版本的文档。
• 与INCLUDE/EXCLUDE的协同：METADATA_FILTER定义了作业的“基础范围”，而INCLUDE和EXCLUDE则在这个范围内进行进一步的精细筛选，两者需要逻辑一致。
• 远程修复考量：所谓的“远程帮你修复故障”，在实际操作中意味着需要具备对目标数据库服务器的安全访问权限（如SSH）和数据库的认证凭据，修复动作主要包括分析错误的导出命令、编写正确的参数文件、并在测试环境验证后，在生产环境执行正确的数据泵命令。重要提示：任何生产环境操作都应先在测试环境验证，并制定完整的备份和回滚方案。

ORA-31660错误的解决直接而明确：在FULL=Y模式下使用对象过滤器时，必须配套使用METADATA_FILTER参数来阐明过滤范围，最稳妥的方法是使用参数文件来组织复杂的命令参数，如果对此参数的具体用法不确定，应详细查阅对应版本的Oracle官方文档中关于Data Pump元数据过滤器的章节。

（注：以上解决方案基于Oracle数据泵工具的通用设计原则，具体实施时，请务必根据您的实际环境、数据库版本和需求进行调整，并参考Oracle官方文档作为最终标准。）