文档中心

访问计划的搜索过程

使用 SdbQuery.explain() 可以查看访问计划的搜索过程的信息。

当 SdbQuery.explain() 的 Search 选项为 true 时,将展示以下信息(Evaluate 选项为 true 时显示 Constants 和 Input 字段):

字段名 类型 描述
Constants BSON 对象 生成访问计划使用的常量
Evaluate 选项为 true 时显示
Constants.RandomReadIOCostUnit 整型 随机读取 IO 的代价,默认值为 10
Constants.SeqReadIOCostUnit 整型 顺序读取 IO 的代价,默认值为 1
Constants.SeqWrtIOCostUnit 整型 顺序写入 IO 的代价,默认值为 2
Constants.PageUnit 整型 数据页的单位,默认值为 4096 (单位:字节)
Constants.RecExtractCPUCost 整型 从数据页中提取数据的 CPU 代价,默认值为 4
Constants.IXExtractCPUCost 整型 从索引页中提取索引项的 CPU 代价,默认值为 2
Constants.OptrCPUCost 整型 操作符的 CPU 代价单位,默认值为 1
Constants.IOCPURate 整型 IO 代价与 CPU 代价的比例,默认值为 2000
Constants.TBScanStartCost 整型 全表扫描的启动代价,默认值为 0
Constants.IXScanStartCost 整型 索引扫描的启动代价,默认值为 0
Options BSON 生成访问计划使用的配置项,即 SequoiaDB 的配置
Options.optcostthreshold 整型 SequoiaDB 的 --optcostthreshold 选项,查询优化器忽略 IO 影响的最小的页数
数据页数大于阈值时,估算访问计划代价时需要计算 IO 的代价
默认值为 20,0 表示一直需要计算 IO 代价,-1 表示从不计算代价
Options.sortbuf 整型 SequoiaDB 的 --sortbuf 选项
排序缓存大小(单位:MB),默认值为 256 ,最小值为 128
Input BSON 对象 生成访问计划使用的输入项,集合的统计信息
Evaluate 选项为 true 时显示
Input.Pages 整型 集合的数据页个数
Input.Records 长整型 集合的数据个数
Input.RecordSize 整型 集合的数据平均长度
Input.NeedEvalIO 布尔型 根据 Input.Pages 和 Options.optcostthreshold 判断是否需要计算 IO 代价
Input.CLEstFromStat 布尔型 是否使用集合的统计信息进行估算
Input.CLStatTime 时间戳 使用的集合的统计信息的生成时间
SearchPaths 数组 每个搜索过的访问计划的估算过程

Note:

  • Constants 字段下的值为常量不可进行设置
  • Options 字段下的值可以通过 SequoiaDB 的配置来设置

SearchPaths 数组的每项表示一个搜索过的访问计划,将展示以下信息:

字段名 类型 描述
ScanType 字符串 访问计划的扫描方式
1. "tbscan" 表示全表扫描
2. "ixscan" 表示索引扫描
IndexName 字符串 访问计划使用的索引的名称
全表扫描时为 ""
UseExtSort 布尔型 访问计划是否使用非索引排序
Direction 整型 访问计划使用索引时的扫描方向
1 表示正向扫描索引
-1 表示反向扫描索引
Query BSON 对象 访问计划解析后的用户查询条件
IXBound BSON 对象 访问计划使用索引的查找范围表扫描为 null
NeedMatch 布尔型 访问计划获取记录时是否需要根据匹配符进行过滤
NeedMatch 为 false 的情况有:
1. 没有查询条件
2. 查询条件可以被索引覆盖
IXEstFromStat 布尔型 是否使用索引的统计信息进行估算(索引扫描时显示)
IXStatTime 时间戳 使用的索引的统计信息的生成时间(索引扫描时显示)
Score 浮点型 评分:
1. 索引扫描为索引的选择率(< 0.1时为候选计划)
2. 全表扫描为匹配符的选择率
IsCandidate 布尔型 是否候选访问计划,不是候选计划不进行估算
1. 索引扫描选择率 < 0.1
2. 索引扫描完全匹配排序字段
3. 全表扫描
IsUsed 布尔型 是否最终选择的访问计划
TotalCost 浮点型 估算的代价(内部表示 单位约为 1/2000000 秒)
该代价不包括选择符、skip() 和 limit() 的影响
ScanNode BSON 对象 TBSCAN 的推演公式IXSCAN 推演公式
Evaluate 选项为 true 时显示
SortNode BSON 对象 SORT 的推演公式
Evaluate 选项为 true 且需要进行排序时显示

Evaluate 选项为 true 时将展示查询优化器的推演公式,每个需要计算的变量将以数组形式展示:

变量: [
  公式,
  代入数据的计算公式,
  计算结果
]

Note:

推演公式中的代价均为内部表示,单位约为 1/2000000 秒

示例

{
  ...,
  "Search": {
    "Options": {
      "sortbuf": 256,
      "optcostthreshold": 20
    },
    "Constants": {
      "RandomReadIOCostUnit": 10,
      "SeqReadIOCostUnit": 1,
      "SeqWrtIOCostUnit": 2,
      "PageUnit": 4096,
      "RecExtractCPUCost": 4,
      "IXExtractCPUCost": 2,
      "OptrCPUCost": 1,
      "IOCPURate": 2000,
      "TBScanStartCost": 0,
      "IXScanStartCost": 0
    },
    "Input": {
      "Pages": 1,
      "Records": 10,
      "NeedEvalIO": false,
      "CLEstFromStat": false
    },
    "SearchPaths": [
      {
        "IsUsed": false,
        "IsCandidate": false,
        "Score": 1,
        "ScanType": "ixscan",
        "IndexName": "$id",
        "UseExtSort": false,
        "Direction": 1,
        "IXBound": {
          "_id": [
            [
              {
                "$minElement": 1
              },
              {
                "$maxElement": 1
              }
            ]
          ]
        },
        "NeedMatch": false,
        "IXEstFromStat": false
      },
      ...
    ]
  }
}
回到顶部