analyze()
分析集合和索引的数据,并收集统计信息。
Options 格式
属性名 描述 约束 格式 Mode 进行分析的模式,整数类型,(1-5):
1:进行抽样分析,生成统计信息
2:进行全量数据分析,生成统计信息
3:生成默认的统计信息
4:加载统计信息到缓存中
5:清除缓存的统计信息
默认值为 1Mode取 1 - 3 时,必须在主数据节点上执行
Mode取 4,5 时,可以在备数据节点上执行Mode:1 CollectionSpace 指定需要分析的集合空间名称,字符串类型。默认值为空。 不能与Collection同时使用 CollectionSpace:”foo” Collection 指定需要分析的集合名称,字符串类型。默认值为空。 不能与CollecitonSpace同时使用
必须是Collection的全名Collection:”foo.bar” Index 指定需要分析的索引名称,字符串类型。默认值为空。 如果指定该参数,需要指定Collection参数 Index:”index” SampleNum 指定抽样的数据个数,整数类型,范围为 100 - 10000 ,默认值为 200 不能与SamplePercent同时使用 SampleNum:1000 SamplePercent 指定抽样的比例,浮点数类型,范围为:0.0 - 100.0 不能与SampleNum同时使用
集合数据个数和比例的乘积为抽样的数据个数,自动调整在 100 - 10000 之间(小于 100 调整为 100,大于 10000 调整为 10000)
缺省则不使用 SamplePercent,而选取 SampleNum 的默认值 200SamplePercent:50 Location Elements 命令位置参数项,详细见 命令位置参数 GroupName:”db1”
无返回值,出错抛异常,并输出错误信息。可以通过 或 getLastErrMsg() 获取错误信息 或 通过 获取错误码。该操作主要的异常如下:
- SDB_DMS_CS_NOTEXIST(-34) 指定的集合空间不存在。
- SDB_DMS_NOTEXIST(-23) 指定的集合不存在。
- SDB_IXM_NOTEXIST(-47) 指定的索引不存在。
- SDB_INVALIDARG(-6) 指定的参数可能存在冲突,请参考**Options**的约束。
更多错误可以参考常见错误处理指南 。
2.9及以上版本
对指定集合空间”foo”进行统计信息分析和收集
对指定数据组”group1”进行统计信息分析和收集
对指定集合”foo.bar”进行统计信息收集,并且指定Sample的数量
对指定集合”foo.bar”生成清空统计信息缓存