华为云用户手册

  • 响应示例 状态码: 200 部门信息 { "id" : "1319678187126486144", "orgId" : "9190086000001210958", "deptId" : "a4fd0d798f5344ccac2c695646ef66d3", "parentId" : "1245640257345455489", "name" : "test16", "tenantId" : "40086000004871666", "code" : 0, "msg" : "success" }
  • 响应示例 状态码: 200 空间详情。 { "data" : { "tenantId" : "40086000004871666", "creator" : "369528171409614001", "createTime" : "2023-11-14T20:39:06.000Z", "modifier" : "369528171409614001", "updateTime" : "2023-12-27T03:41:49.000Z", "ownerId" : "1289173668999530369", "type" : 0, "status" : 0, "capacity" : 1, "spaceUsed" : 654777, "containerId" : "IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b", "rootFileId" : "HFaETMi24qYqOM5KQmpNY2ATjKJeAunIK", "bizRootFileId" : "DEUI7pa0C24ArootIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b", "bizSboxFileId" : "DEUI7pa0C24AsboxIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b" }, "code" : 0, "msg" : "成功" }
  • 响应示例 状态码: 200 部门空间列表信息。 { "total" : 364, "departments" : [ { "tenantId" : "40086000004871666", "creator" : "369528171409614001", "createTime" : "2023-11-14T20:39:06.000Z", "modifier" : "369528171409614001", "updateTime" : "2023-12-26T11:40:08.000Z", "ownerId" : "1289173668999530369", "status" : 0, "capacity" : 1, "spaceUsed" : 654777, "containerId" : "IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b", "bizRootFileId" : "DEUI7pa0C24ArootIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b", "bizSboxFileId" : "DEUI7pa0C24AsboxIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b", "id" : "1289173668999530369", "parentId" : "1289171275545118721", "name" : "部门1699953477584", "userNum" : 1 }, { "tenantId" : "40086000004871666", "id" : "1289173650183882753", "parentId" : "1289171275545118721", "name" : "部门1699953475619" }, { "tenantId" : "40086000004871666", "id" : "1289173631275960193", "parentId" : "1289171275545118721", "name" : "部门1699953473454" }, { "tenantId" : "40086000004871666", "id" : "1289173612200265729", "parentId" : "1289171275545118721", "name" : "部门1699953470101" }, { "tenantId" : "40086000004871666", "id" : "1289173593258788737", "parentId" : "1289171275545118721", "name" : "部门169995346896" }, { "tenantId" : "40086000004871666", "id" : "1289173574392809473", "parentId" : "1289171275545118721", "name" : "部门1699953466973" }, { "tenantId" : "40086000004871666", "id" : "1289173555140953985", "parentId" : "1289171275545118721", "name" : "部门1699953463567" }, { "tenantId" : "40086000004871666", "id" : "1289173535931041664", "parentId" : "1289171275545118721", "name" : "部门1699953461741" }, { "tenantId" : "40086000004871666", "id" : "1289173517174114305", "parentId" : "1289171275545118721", "name" : "部门1699953459399" }, { "tenantId" : "40086000004871666", "id" : "1289173498115196929", "parentId" : "1289171275545118721", "name" : "部门1699953457405" } ], "code" : 0, "msg" : "成功" }
  • 响应示例 状态码: 200 返回查询到的任务列表 { "data" : [ { "taskId" : "1320279189273965056", "taskType" : 2, "actionType" : 201, "status" : 2, "taskResultCode" : 1, "contentNum" : 1, "containerId" : "IAADfsBFCO6WtAtuA9add2fea594e4e75b8feb8474ef236", "beginTime" : "20231227151904", "endTime" : "20231227151904", "createTime" : "20231227151904" }, { "taskId" : "1320279092268104960", "taskType" : 2, "actionType" : 201, "status" : 2, "taskResultCode" : 1, "contentNum" : 4, "containerId" : "IAADfsBFCO6WtAtuA9add2fea594e4e75b8feb8474ef236", "beginTime" : "20231227151852", "endTime" : "20231227151852", "createTime" : "20231227151852" } ], "code" : 0, "msg" : "成功" }
  • 基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用它进行日常管理工作。 用户 由租户管理员(也称为系统管理员),登录到KooDrive的业务面的控制中心,创建好KooDrive的用户。KooDrive用户登录业务系统后,会生成Access-Token(AT),后续的接口调用都是基于该AT进行认证和鉴权。 区域(Region) 从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区(AZ,Availability Zone) 一个AZ是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。 父主题: 使用前必读
  • 请求示例 当文件的二进制数据上传完毕后,调用该接口做分片合并以及完整性校验操作,文件上传完成。 POST /koodrive/ose/v1/files/complete Authorization:Bearer+10f88d07fa3b86e520ab75eef417574840f15a544791e9ff X-Csrf-Token:fc41ff2190ff0d6a6a08ed12718274d8f0d9330a8ce439a5 { "fileId": "FiqNTAYdzXtKhenh29A9EXJvhaKQqcYVS" }
  • 响应示例 状态码: 200 会话响应信息 { "accessToken": Bearer+013b4daf12f4099a6eb74e2708000cb7a418409192f3e149, "csrfToken": 28dddea91914c8f6ae3287ab21ce42337c996505c3faf1db, "userId": 369528171409614001, "userName": 租户管理员, "code": 0, "msg": "success" }
  • 修订记录 发布日期 修订记录 2023-12-28 第二次正式发布。 本次变更说明如下: 新增批量上传时是否有数量限制或大小限制? 新增什么情况下分享状态显示“文件已删除”? 新增什么情况下分享状态显示“已失效”? 新增是否支持分享文件(夹)给自己? 新增“分享给我”的页签下显示哪些文件(夹)? 新增一次最多可以分享多少个文件或文件夹? 新增批量取消或退出分享有数量限制吗? 新增收藏列表为什么有置灰的收藏记录? 新增最多可批量收藏多少个文件(夹)? 新增传输气泡是否会自动消失? 新增如果刷新网页,上传任务是否会取消? 新增是否支持将自己作为成员加入用户组? 新增一个用户最多可以添加多少个用户组? 新增同一用户组最多可以添加多少个成员? 新增同一用户组最多可以添加多少个成员? 2023-10-20 第一次正式发布。
  • 收藏 用户在个人空间和团队空间收藏的文件(夹)可以在收藏列表中查看。 图6 收藏页面 收藏页面主要由文件(夹)辅助操作和收藏文件列表/卡片视图两部分组成。 文件(夹)辅助操作 操作按钮:提供取消收藏操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前团队空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示当前团队空间文件(夹)。 :单击后以卡片视图展示当前团队空间文件(夹)。 收藏文件列表/卡片视图 列表视图中展示收藏的文件(夹)名称、文件大小、格式、所在空间以及收藏时间,默认按照收藏时间倒序排列展示,支持按照文件格式进行过滤,单击文件(夹)所在空间即可跳转至文件(夹)所在目录。 卡片视图中展示收藏的文件(夹)名称以及收藏时间,根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片都提供收藏与取消收藏操作。
  • 回收站 KooDrive将回收站分为个人回收站和团队回收站,个人空间和团队空间无需留存的文件被删除后进入到回收站,管理员可以操作拥有管辖权的所有团队回收站里的文件(夹)。普通用户只能操作自己个人回收站的文件夹。 回收站页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图5 回收站页面 文件(夹)辅助操作 操作按钮:提供清空、恢复、彻底删除操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前个人回收站或部门回收站的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示个人回收站或部门回收站文件(夹)。 :单击后以卡片视图展示个人回收站或部门回收站文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示回收站里文件(夹)名、归属者、大小、原始目录、删除时间。支持按照文件(夹)名、大小、删除时间升序或降序排列。 卡片视图中展示文件(夹)名、删除时间,根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片视图都提供回收站文件(夹)管理操作,包括: 清空、恢复、彻底删除团队回收站文件(夹) 清空、恢复、彻底删除个人回收站文件(夹)
  • 个人空间 个人空间是用户存放个人文件的空间,仅用户自己可见。创建用户时若分配了个人空间且空间为启用状态则用户个人空间页面可见。 个人空间页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图2 个人空间列表页 文件(夹)辅助操作 操作按钮:提供上传、新建、下载、移动、复制、删除等操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索个人空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示个人空间文件(夹)。 :单击后以卡片视图展示个人空间文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则文件名中展示图片缩略图,单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间,根据文件(夹)格式展示对应图标。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则卡片中展示图片缩略图,单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作,包括: 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 转发个人文件至本部门团队空间 查看文件(夹)详细信息
  • 团队空间 团队空间是部门团队共享文件的空间,团队内的成员都可查看。各部门团队空间相互隔离,仅团队成员用户可见。创建部门时若分配了团队空间且团队空间为启用状态则团队空间首页可见。 图3 团队空间页首页 团队空间首页以卡片视图展示企业内部门空间,系统管理员可以看到企业内所有的部门空间,普通用户和部门管理员只能看到自己所属部门的团队空间,默认展示10个团队空间,鼠标滚动可加载下一页展示的团队空间。 团队空间卡片中展示团队名称、团队总空间大小、已使用空间大小、团队空间总人数,管理员及普通用户可以查看团队空间的详细信息。 图4 团队空间页 团队空间页主要由文件(夹)辅助操作和团队空间文件列表/卡片视图两部分组成。 文件(夹)辅助操作 目录信息:左上角展示当前团队空间路径信息。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前团队空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表中展示的文件(夹)类型。 :单击后以列表视图展示当前团队空间文件(夹)。 :单击后以卡片视图展示当前团队空间文件(夹)。 团队空间文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件(夹)归属者、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则文件名中展示图片缩略图,单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间,根据文件(夹)格式展示对应图标。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则卡片中展示图片缩略图,单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作,包括: 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 管理员转发团队空间文件至个人空间 普通用户转发团队空间文件至个人空间 查看文件(夹)详细信息
  • GS_WLM_INSTANCE_HISTORY GS_WLM_INSTANCE_HISTORY系统表存储与实例(CN或DN)相关的资源使用相关信息。该系统表里每条记录都是对应时间点某实例资源使用情况,包括:内存、CPU核数、磁盘IO、进程物理IO和进程逻辑IO信息。查询该系统表需要sysadmin权限,且仅在数据库postgres下面查询时有数据。当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。 当查询视图无数据显示时,请联系华为工程师提供技术支撑。 表1 GS_WLM_INSTANCE_HISTORY字段 名称 类型 描述 instancename text 实例名称。 timestamp timestamp with time zone 时间戳。 used_cpu integer 实例使用CPU所占用的百分比。 free_mem integer 实例未使用的内存大小,单位MB。 used_mem integer 实例已使用的内存大小,单位MB。 io_await real 实例所使用磁盘的io_wait值(10秒均值)。 io_util real 实例所使用磁盘的io_util值(10秒均值)。 disk_read real 实例所使用磁盘的读速率(10秒均值),单位KB/s。 disk_write real 实例所使用磁盘的写速率(10秒均值),单位KB/s。 process_read bigint 实例对应进程从磁盘读数据的读速率(不包括从磁盘pagecache中读取的字节数,10秒均值),单位KB/s。 process_write bigint 实例对应进程向磁盘写数据的写速率(不包括向磁盘pagecache中写入的字节数,10秒均值),单位KB/s。 logical_read bigint CN实例:不统计。 DN实例:该实例在本次统计间隙(10秒)内逻辑读字节速率,单位KB/s。 logical_write bigint CN实例:不统计。 DN实例:该实例在本次统计间隙(10秒)内逻辑写字节速率,单位KB/s。 read_counts bigint CN实例:不统计。 DN实例:该实例在本次统计间隙(10秒)内逻辑读操作次数之和,单位次。 write_counts bigint CN实例:不统计。 DN实例:该实例在本次统计间隙(10秒)内逻辑写操作次数之和,单位次。 父主题: 系统表
  • 账本数据库的函数(实验室特性) 当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。 get_dn_hist_relhash(text, text) 描述:返回指定防篡改用户表的表级数据hash值。该函数仅供分布式节点间调用,所有用户调用均提示权限不足。 参数类型:text 返回值类型:hash16 ledger_hist_check(text, text) 描述:校验指定防篡改用户表的表级数据hash值与其对应历史表hash一致性。 参数类型:text 返回值类型:Boolean ledger_hist_repair(text, text) 描述:修复指定防篡改用户表对应的历史表hash值,使之与用户表hash一致,返回hash差值。 参数类型:text 返回值类型:hash16 ledger_hist_archive(text, text) 描述:归档指定防篡改用户表对应的历史表至审计日志目录中hist_back文件夹下。 参数类型:text 返回值类型:Boolean ledger_gchain_check(text, text) 描述:校验指定防篡改用户表对应的历史表hash与全局历史表对应的relhash一致性。 参数类型:text 返回值类型:Boolean ledger_gchain_repair(text, text) 描述:修复验指定防篡改用户表在全局历史表中的relhash,使之与其历史表hash一致,返回指定表hash总和。 参数类型:text 返回值类型:hash16 ledger_gchain_archive(void) 描述:归档全局历史表至审计日志目录中hist_back文件夹下。 参数类型:void 返回值类型:Boolean hash16in(cstring) 描述:将输入16进制字符串转化成内部hash16形式。 参数类型:cstring 返回值类型:hash16 hash16out(uint64) 描述:将内部hash16类型的数据转码转化为16进制cstring类型。 参数类型:hash16 返回值类型:cstring hash32in(cstring) 描述:将输入的16进制字符串(32个字符)转化成内部类型hash32形式。 参数类型:cstring 返回值类型:hash32 hash32out(hash32) 描述:将内部hash32类型的数据转码转化为16进制cstring类型。 参数类型:cstring 返回值类型:hash32 父主题: 函数和操作符
  • GS_WLM_USER_RESOURCE_HISTORY GS_WLM_USER_RESOURCE_HISTORY系统表存储与用户使用资源相关的信息,仅在CN上有效。该系统表的每条记录都是对应时间点某用户的资源使用情况,包括:内存、CPU核数、存储空间、临时空间、算子落盘空间、逻辑IO流量、逻辑IO次数和逻辑IO速率信息。其中,内存、CPU、IO相关监控项仅记录用户复杂作业的资源使用情况。对于IO相关监控项,当参数enable_logical_io_statistics为on时才有效;当参数enable_user_metric_persistent为on时,才会开启用户监控数据保存功能。GS_WLM_USER_RESOURCE_HISTORY系统表的数据来源于PG_TOTAL_USER_RESOURCE_INFO视图。查询该系统表需要sysadmin权限,且仅在数据库postgres下面查询时有数据。 当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。 当查询视图无数据显示时,请联系华为工程师提供技术支撑。 表1 GS_WLM_USER_RESOURCE_HISTORY 名称 类型 描述 username text 用户名 timestamp timestamp with time zone 时间戳 used_memory integer 正在使用的内存大小,单位MB。 total_memory integer 可以使用的内存大小,单位为MB。值为0表示未限制最大可用内存,其限制取决于数据库最大可用内存。 used_cpu real 正在使用的CPU核数。 total_cpu integer 该机器节点上,用户关联控制组的CPU核数总和。 used_space bigint 已使用的存储空间大小,单位KB。 total_space bigint 可使用的存储空间大小,单位KB,值为-1表示未限制最大存储空间。 used_temp_space bigint 已使用的临时存储空间大小,单位KB。 total_temp_space bigint 可使用的临存储空间大小,单位KB,值为-1表示未限制最大临时存储空间。 used_spill_space bigint 已使用的算子落盘存储空间大小,单位KB。 total_spill_space bigint 可使用的算子落盘存储空间大小,单位KB,值为-1表示未限制最大算子落盘存储空间。 read_kbytes bigint 监控周期内,读操作的字节流量,单位KB。 write_kbytes bigint 监控周期内,写操作的字节流量,单位KB。 read_counts bigint 监控周期内,读操作的次数,单位次。 write_counts bigint 监控周期内,写操作的次数,单位次。 read_speed real 监控周期内,读操作的字节速率,单位KB/s。 write_speed real 监控周期内,写操作的字节速率,单位KB/s。 父主题: 系统表
  • GS_WLM_CGROUP_INFO GS_WLM_CGROUP_INFO视图显示当前执行作业的控制组的信息(当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。)。 当查询视图无数据显示时,请联系华为工程师提供技术支撑。 表1 GS_WLM_CGROUP_INFO字段 名称 类型 描述 cgroup_name text 控制组的名称。 priority integer 作业的优先级。 usage_percent integer 控制组占用的百分比。 shares bigint 控制组分配的CPU资源配额。 cpuacct bigint CPU配额分配。 cpuset text CPU限额分配。 relpath text 控制组的相对路径。 valid text 该控制组是否有效。 node_group text 逻辑集群(当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。)名称。 父主题: 系统视图
  • session_sequence_cache 参数说明:在当前会话下,一次性交互申请的sequence数值,会话结束会自动丢弃未用完的值。用户在使用sequence大批量导入数据的时候可以通过调大该参数,提高插入速度,增加高并发性能;用户在高并发单条插入数据的时候,将该参数设置为1,减少了sequence的跳变。如对连续性有强要求,需要在创建sequence的时候指定需要的cache,该参数如果大于cache指定的值会自动失效。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整型,1 ~ 2147483647。 默认值:10 默认值为10是高并发场景下,兼顾单条插入和批量插入的性能会有比较好的表现。
  • auto_explain_log_min_duration 参数说明:控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整形,0~2147483647,单位为毫秒。 设置为0,所有执行过的执行计划都会输出。 设置为3000,单次语句执行耗时超过3000毫秒后所有执行的执行计划会输出。 默认值:0
  • cursor_tuple_fraction 参数说明:优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:浮点型,0.0~1.0。 比默认值小的值与使用 “fast start” 为游标规划的值相偏离,从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处,像正常的查询一样规划游标,只考虑总的估计时间和传送第一行的时间。 默认值:0.1
  • codegen_strategy 参数说明:标识在列存表达式codegen化过程中所使用的代码生成优化策略,该参数对行存表达式无效,且行存表达式总是pure策略。当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:枚举类型 partial表示当所计算表达式中即使包含部分未被codegen化的函数时,仍可借助表达式全codegen框架调用LLVM动态编译优化策略。 pure表示当所计算表达式整体可被codegen化时,才考虑调用LLVM动态编译优化策略。 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure,其他场景下建议不改变此参数的默认值partial。 默认值:partial
  • codegen_cost_threshold 参数说明:由于LLVM编译生成最终的可执行机器码需要一定时间,因此只有当实际执行的代价大于编译生成机器码所需要的代码和优化后的执行代价之和时,利用代码生成才有收益。codegen_cost_threshold标识代价的阈值,当执行估算代价大于该代价时,使用LLVM优化。codegen使用执行算子的plan_rows作为代价与codegen_cost_threshold进行比较,plan_rows的值可以通过explain命令查看。当前特性是实验室特性,使用时请联系华为技术工程师提供技术支持。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整型,0 ~ 2147483647。 默认值:100000
  • enable_extrapolation_stats 参数说明:标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性,但也存在错误推理导致估算过大的可能性,需要对于日期类型数据定期插入的场景开启此开关。该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:布尔型 on表示允许基于历史统计信息使用推理估算的逻辑。 off表示不允许基于历史统计信息使用推理估算的逻辑。 默认值:off
  • autoanalyze 参数说明:标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。对于外表和临时表,不支持autoanalyze,如果需要收集统计信息,用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常,当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作,以同步统计信息数据。该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:布尔型 on表示允许自动进行统计信息收集。 off表示不允许自动进行统计信息收集。 默认值:off
  • join_collapse_limit 参数说明:根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整型,1~2147483647‬。 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序,高级用户可以选择暂时把这个变量设置为1,然后指定它们需要的连接顺序。 比默认值小的数值减少规划时间但也降低了执行计划的质量。 默认值:8
  • router 参数说明:用于控制router功能的详细属性,仅在打开enable_router和enable_light_proxy后生效。该参数会根据表的hash分布列,计算给定的分布列在哪个DN上,设置router后将支持的sql下推到该DN上执行。如果设置错了router,可能导致数据存入错误的dn,导致不可预测的问题,需谨慎使用。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:字符串 该参数分为两部分,'schema_name.table_name,"distribute_keys"',其具体含义如下: schema_name.table_name:表示schema名和表名,如不显示设置schema_name,则默认为current_schema。 distribute_keys:分布表的所有分布列值,用逗号间隔开,且分布列值的顺序必须和表中分布列顺序一致。 默认值:空
  • query_dop 参数说明:用户自定义的查询并行度。该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整型,-64-64 [1,64]:打开固定SMP功能,系统会使用固定并行度。 0:打开SMP自适应功能,系统会根据资源情况和计划特征动态选取最优并行度。 [-64,-1]:打开SMP自适应功能,并限制自适应选取的最大并行度。 在开启并行查询后,请保证系统CPU、内存、网络、I/O等资源充足,以达到最佳效果。 为了避免用户设置不合理的过大值造成性能劣化,系统会计算出该DN可用最大CPU核数,并以此来作为query_dop的上限。如果用户设置query_dop超过4并且同时超过该上限,那么系统会重置query_dop为该上限值。 默认值:1
  • enable_sonic_optspill 参数说明:标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时,在Hash Join算子下盘文件较多的时候,下盘文件数不会显著增加。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:布尔型 on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。 默认值:on
  • plan_cache_mode 参数说明:标识在prepare语句中,选择生成执行计划的策略。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:枚举类型 auto表示按照默认的方式选择custom plan或者generic plan。 force_generic_plan表示强制走generic plan(软解析)。generic plan是指对于prepare语句生成计划,该计划策略会在执行execute语句的时候把参数bind到plan中,然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销;缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的,部分bind参数场景下执行性能较差。 force_custom_plan表示强制走custom plan(硬解析)。custom plan是指对于prepare语句,在执行execute的时候,把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划,这种方案的优点是每次都按照具体的参数生成优选计划,执行性能比较好;缺点是每次执行前都需要重新生成计划,存在大量的重复的优化器开销。 此参数只对prepare语句生效,一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 默认值:auto
  • plan_mode_seed 参数说明:该参数为调测参数,目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中:OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan,参数值设置为0;RANDOM_PLAN表示随机生成的plan;如果设置为-1,表示用户不指定随机数的种子标识符seed值,由优化器随机生成[1, 2147483647]范围整型值的随机数,并根据随机数生成随机的执行计划;如果用户指定guc参数值为[1, 2147483647]范围的整型值,表示指定的生成随机数的种子标识符seed,优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:整型,-1~ 2147483647 默认值:0 当该参数设置为随机执行计划模式时,优化器会生成不同的随机执行计划,该执行计划可能不是最优计划。因此在随机计划模式下,会对查询性能产生影响,所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 当该参数不为0时,查询指定的plan hint不会生效。
  • explain_perf_mode 参数说明:此参数用来指定explain的显示格式。 该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 取值范围:normal、pretty、summary、run normal:代表使用默认的打印格式。 pretty:代表使用GaussDB改进后的新显示格式。新的格式层次清晰,计划包含了plan node id,性能分析简单直接。 summary:是在pretty的基础上增加了对打印信息的分析。 run:在summary的基础上,将统计的信息输出到csv格式的文件中,以便于进一步分析。 默认值:pretty pretty模式当前只支持包含stream算子的计划,不支持下发语句到DN节点的计划。因此显示格式会受enable_stream_operator参数影响,当enable_stream_operator设置为off时无法生成包含stream算子的计划。
共100000条