Oracle数据库 ORA-00168 错误分析和解决

好的，我们来详细解析 ORA-00168 错误。这是一个与数据库参数配置直接相关的错误。

ORA-00168: 指定的 LOB 索引参数值无效

1. 错误信息结构组成说明

一个典型的 ORA-00168 错误信息格式如下：

ORA-00168: invalid specification for lob storage parameter string

• 错误代码 (Error Code): ORA-00168
• 错误消息 (Error Message): invalid specification for lob storage parameter string
• 参数 (Parameters): 消息中包含一个 string 占位符，在实际错误中会被具体的、无效的LOB存储参数名称所替代。例如：
  ORA-00168: invalid specification for lob storage parameter INITIAL

这个结构清晰地指明了问题的核心：在定义或修改包含LOB（大对象）列的表时，为某个LOB存储参数指定的值是非法的、不被Oracle接受的。

2. 官方正式说明

原因 (Cause)

根据Oracle官方文档，此错误的发生是由于：

在 CREATE TABLE 或 ALTER TABLE 语句的 LOB_storage_clause 中，为某个LOB存储参数（如 INITIAL, NEXT, PCTINCREASE, MINEXTENTS, MAXEXTENTS 等）指定的值超出了其允许的范围，或者与其它参数值存在逻辑冲突。

LOB（Large Object，大对象）数据类型（如 BLOB, CLOB, NCLOB）的存储方式与普通表数据不同，它们通常被存储在独立的段（Segment）中。为了管理这些段的空间分配，可以为其指定一系列存储参数。这些参数都有其有效的取值范围和规则。如果提供的值违反了这些规则，Oracle就会拒绝执行DDL语句并抛出ORA-00168错误。

场景 (Scenarios)

1. 创建包含LOB列的表： 在 CREATE TABLE 语句的 LOB (...) STORE AS ... 子句中，为存储参数提供了无效值。
2. 修改表以添加LOB列： 在 ALTER TABLE ... ADD (...) 语句中，为新加的LOB列指定存储参数时出错。
3. 修改现有的LOB存储属性： 使用 ALTER TABLE ... MODIFY LOB (...) 语句更改现有LOB列的存储参数时，提供了无效值。
4. 参数值超出范围： 例如，将 INITIAL 或 NEXT 设置为小于数据库块大小、或小于允许的最小值（通常为一个块）；将 PCTINCREASE 设置为负数或非常大的数；为 MINEXTENTS 或 MAXEXTENTS 设置不合逻辑的值（如 MINEXTENTS > MAXEXTENTS）。
5. 与自动段空间管理（ASSM）不兼容： 在使用自动段空间管理（由 SEGMENT SPACE MANAGEMENT AUTO 指定）的表空间中，指定了传统的 PCTUSED, FREELISTS, FREELIST GROUPS 等参数，这些参数与ASSM不兼容。

相关原理 (Related Principles)

• LOB存储： LOB数据通常与基表分开存储，每个LOB列（或每个分区中的LOB列）都有自己的物理段结构。这允许DBA单独优化LOB数据的存储。
• 存储参数： 这些参数控制着段如何从表空间中获取空间扩展（Extent）。INITIAL 定义第一个扩展区大小，NEXT 定义下一个扩展区大小，PCTINCREASE 定义后续扩展区的增长百分比，MINEXTENTS 定义段创建时分配的扩展区数量，MAXEXTENTS 定义段可以拥有的最大扩展区数量（或为unlimited）。
• 自动与手动段空间管理： 在现代Oracle版本中，推荐使用自动段空间管理（ASSM）。在ASSM表空间中，诸如 PCTUSED, FREELISTS 等参数会被忽略，如果显式指定它们，可能会在某些上下文中引发错误或警告。

相关联的其他ORA-错误

• ORA-00997: 非法使用LONG数据类型。与错误的对象类型使用有关。
• ORA-02213: 必须指定 INITIAL 存储选项的值。
• ORA-01539: 未安装指定类型的表空间。尝试在不存在或未加载的表空间中存储LOB。
• ORA-25126: 在使用自动段空间管理的表空间上不允许使用 PCTUSED / FREELIST / FREELIST GROUPS 等参数。
• ORA-30027: 未实施撤销 LOB 段。与LOB段的特定操作相关。

3. 定位原因与分析过程

1. 审查出错的SQL语句： 这是最关键的一步。找到触发错误的 CREATE TABLE 或 ALTER TABLE 语句。
2. 检查LOB存储子句： 仔细检查语句中的 LOB (...) STORE AS ... 部分。
3. 验证参数值： 逐个核对指定的存储参数值是否符合规则：
   • INITIAL, NEXT: 必须至少为一个数据库块的大小，且通常是 DB_BLOCK_SIZE 的整数倍。
   • PCTINCREASE: 通常设置为 0（表示后续扩展区大小固定为 NEXT）或一个非负整数。非常大的值可能不被允许。
   • MINEXTENTS, MAXEXTENTS: 必须是正整数，且 MINEXTENTS <= MAXEXTENTS。MAXEXTENTS 可以是具体数值或 UNLIMITED。
   • 确保没有在ASSM表空间中指定 PCTUSED, FREELISTS, FREELIST GROUPS。
4. 检查数据库块大小：

   SELECT VALUE FROM V$PARAMETER WHERE NAME = 'db_block_size';
   

   确保 INITIAL 和 NEXT 的值 >= 这个值。

4. 解决方案与相关SQL

解决方案

解决方案是修正DDL语句中无效的LOB存储参数值。

1. 修正参数值： 根据上述检查规则，将参数值调整到有效范围内。例如，如果 DB_BLOCK_SIZE 是8192字节，那么 INITIAL 至少应为8192，通常设置为比如 1048576 (1MB) 或更大。
2. 移除不兼容的参数： 如果表空间使用的是ASSM，请从 LOB_storage_clause 中删除 PCTUSED, FREELISTS, FREELIST GROUPS 等参数。
3. 使用默认值： 最简单的方法是完全省略这些存储参数，让Oracle使用表空间的默认设置，这通常是很好的选择。

相关SQL语句

• 错误的CREATE TABLE示例：

  CREATE TABLE my_images (
    id NUMBER PRIMARY KEY,
    image BLOB
  )
  LOB(image) STORE AS my_image_lob (
    -- INITIAL 小于块大小会导致 ORA-00168
    INITIAL 4K
    NEXT 1M
    PCTINCREASE 50
  );
  

• 修正后的CREATE TABLE示例：

  CREATE TABLE my_images (
    id NUMBER PRIMARY KEY,
    image BLOB
  )
  LOB(image) STORE AS my_image_lob (
    -- 使用合理的大小，至少为一个块
    INITIAL 1M
    NEXT 1M
    PCTINCREASE 0 -- 通常设置为0，使扩展区大小固定
    -- 省略 MAXEXTENTS 则默认为 UNLIMITED
  );
  

  或者，更简单地，依赖表空间默认值：

  CREATE TABLE my_images (
    id NUMBER PRIMARY KEY,
    image BLOB
  );
  -- Oracle 会自动管理LOB存储
  

• 修改现有LOB存储的示例：

  -- 假设需要修改存储参数
  ALTER TABLE my_images MODIFY LOB (image) (
    STORAGE (
      NEXT 2M
      MAXEXTENTS UNLIMITED
    )
  );
  

5. 通俗易懂的语言讲解

让我们用一个规划仓库储物区的比喻来理解 ORA-00168：

想象你要为公司建立一个仓库来存放产品（基表）和产品的高清宣传视频（LOB数据）。

• 仓库区域： 主仓库区放产品（表数据段），旁边专门划出一块多媒体档案区来放视频硬盘（LOB段）。
• 存储参数： 你需要为这个多媒体区制定一个空间规划书（LOB存储子句）。
  • INITIAL： 初始分配面积。比如先划出10平方米。
  • NEXT： 下次扩建面积。如果10平米用完了，下次再增加5平方米。
  • PCTINCREASE: 扩建增长率。每次扩建面积比上次增加百分之多少。
  • MAXEXTENTS: 最多能扩建几次。

ORA-00168错误就像是：
你把规划书交给仓库管理员（Oracle数据库），上面写着：“初始面积（INITIAL）给我划出0.1平方米”。管理员一看就怒了，说：“无效的规划！(ORA-00168) 初始面积怎么能比一个最小货架单元（一块砖/一个数据库块）还小呢？这根本没法用！”

为什么会填错？

1. 没看最小单位： 不知道仓库最小的规划单位是1平方米（数据库块大小），填了个比1还小的数。
2. 逻辑错误： 规划书写着“最少扩建3次”（MINEXTENTS=3），但又写着“最多只能扩建2次”（MAXEXTENTS=2），自相矛盾。

怎么解决？

• 修改规划书（修正SQL语句）： 回去把“初始面积”改成至少1平方米（至少 DB_BLOCK_SIZE），比如改成10平方米。确保“最少扩建次数”不大于“最多扩建次数”。
• 交给专家处理（使用默认设置）： 最简单的方法是告诉管理员：“您看着办吧，按标准来！”（不指定LOB存储参数）。管理员会按照仓库（表空间）的默认标准来规划，通常是最优的。

所以，ORA-00168就是一个“规划书填写错误”的错误。 它告诉你：你为LOB存储空间所指定的管理规则（参数值）不符合数据库的基本规定。解决方法就是检查并修改你的CREATE TABLE或ALTER TABLE语句中的LOB存储参数，确保它们都是有效且合理的值。最简单可靠的方法往往是不指定这些参数，使用数据库的默认管理策略。

欢迎关注我的公众号《IT小Chen》