华为云用户手册

  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应消息 data Array of JobInfo objects 批量任务列表信息 表4 JobInfo 参数 参数类型 描述 taskId String 任务标识 taskName String 任务名称 userId String 任务创建者的用户ID taskType Integer 任务类型 actionType Integer 操作类型 status Integer 任务状态 taskResultCode Integer 任务处理结果 resultCode Integer 任务处理结果码 progress Integer 任务进度。在异步任务中会返回,如打包下载任务 downloadUrl String 下载链接。只有当任务类型为打包下载时才会用到 contentNum Integer 请求文件数量 containerId String 目标空间ID,跨空间场景时取目标空间ID tenantId String 租户标识 beginTime String 任务开始时间 endTime String 任务结束时间 createTime String 任务创建时间 状态码: 400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 任务跟踪的请求ID号 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:8 最大长度:36 error_msg String 错误描述 最小长度:2 最大长度:512
  • 基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用它进行日常管理工作。 用户 由租户管理员(也称为系统管理员),登录到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" }
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 格式“Bearer {app_access_token}”,需传入应用级token,用于应用服务端调用,通过创建应用时获得的clientid及clientSecret调用接口获取 x-trace-id 否 String 业务跟踪id language 否 String 国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语 X-Csrf-Token 是 String CS RF Token 表2 请求Body参数 参数 是否必选 参数类型 描述 fileId 是 String 上传完成的文件id
  • 响应示例 状态码: 200 会话响应信息 { "accessToken": Bearer+013b4daf12f4099a6eb74e2708000cb7a418409192f3e149, "csrfToken": 28dddea91914c8f6ae3287ab21ce42337c996505c3faf1db, "userId": 369528171409614001, "userName": 租户管理员, "code": 0, "msg": "success" }
  • 响应示例 状态码: 200 返回查询到的任务详情 { "data" : { "jobInfo" : { "taskId" : "1309243162258308352", "userId" : "40086000004871666-369528171409614001", "taskType" : 1, "actionType" : 101, "status" : 2, "progress" : 100, "taskResultCode" : 1, "contentNum" : 1, "containerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4", "tenantId" : "40086000004871666", "beginTime" : "20231212095227", "endTime" : "20231212095227", "createTime" : "20231212095227" }, "taskInfos" : [ { "fileId" : "FuZmQ66CF0DdpKRG1Y29Iwajbq04Nhwu3", "status" : "1", "newFileId" : "FtEXHCpfqHueAHFbEmWZNkqUH_K866MVn", "srcContainerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4" } ] }, "code" : 0, "msg" : "成功" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 格式“Bearer {app_access_token}”,需传入应用级token,用于应用服务端调用,通过创建应用时获得的clientid及clientSecret调用接口获取 x-trace-id 否 String 消息日志跟踪标识 X-Csrf-Token 是 String CSRF Token language 否 String 国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应消息 data data object 任务详情 表4 data 参数 参数类型 描述 jobInfo JobInfo object 任务信息 taskInfos Array of TaskInfo objects Task详情列表 表5 JobInfo 参数 参数类型 描述 taskId String 任务标识 taskName String 任务名称 userId String 任务创建者的用户ID taskType Integer 任务类型 actionType Integer 操作类型 status Integer 任务状态 taskResultCode Integer 任务处理结果 resultCode Integer 任务处理结果码 progress Integer 任务进度。在异步任务中会返回,如打包下载任务 downloadUrl String 下载链接。只有当任务类型为打包下载时才会用到 contentNum Integer 请求文件数量 containerId String 目标空间ID,跨空间场景时取目标空间ID tenantId String 租户标识 beginTime String 任务开始时间 endTime String 任务结束时间 createTime String 任务创建时间 表6 TaskInfo 参数 参数类型 描述 id String Task标识 fileId String 文件/目录ID filePath String 文件/目录的全路径,包含fileId status String task处理状态,枚举值: 0:待处理 1:成功 2:失败 newFileId String 操作后的新ID newFilePath String 操作变更后的新路径 srcContainerId String 源容器ID(file_id对应的源空间ID),仅批量复制任务跨空间时需要填写 resultCode String 文件操作结果码 resultDesc String 文件操作结果描述 tenantId String 租户标识 createTime String Task创建时间 状态码: 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 任务跟踪的请求ID号 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:8 最大长度:36 error_msg String 错误描述 最小长度:2 最大长度:512
  • 修订记录 发布日期 修订记录 2023-12-28 第二次正式发布。 本次变更说明如下: 新增批量上传时是否有数量限制或大小限制? 新增什么情况下分享状态显示“文件已删除”? 新增什么情况下分享状态显示“已失效”? 新增是否支持分享文件(夹)给自己? 新增“分享给我”的页签下显示哪些文件(夹)? 新增一次最多可以分享多少个文件或文件夹? 新增批量取消或退出分享有数量限制吗? 新增收藏列表为什么有置灰的收藏记录? 新增最多可批量收藏多少个文件(夹)? 新增传输气泡是否会自动消失? 新增如果刷新网页,上传任务是否会取消? 新增是否支持将自己作为成员加入用户组? 新增一个用户最多可以添加多少个用户组? 新增同一用户组最多可以添加多少个成员? 新增同一用户组最多可以添加多少个成员? 2023-10-20 第一次正式发布。
  • 支持审计的关键操作列表 表1 云审计 服务支持的Koodrive服务关键操作 操作名称 资源类型 事件名称 cbc订阅 cbc subscribeOrder cbc服务上锁 cbc lockCBC cbc服务解锁 cbc unlockCBC cbc服务更新 cbc updateCBC 更新云盘配置 config updateConfig 用户订阅 order updateOrderSubscription 按需订购 order updateOrderSubscription 取消订单 order cancelOrder 生成订单号 order updateOrderId 查询订单价格 order updateOrder 创建OrgId OrgId createOrgId 查询userId order updateOrderInfo 退订 order unsubscribeOnDemand
  • 收藏 用户在个人空间和团队空间收藏的文件(夹)可以在收藏列表中查看。 图6 收藏页面 收藏页面主要由文件(夹)辅助操作和收藏文件列表/卡片视图两部分组成。 文件(夹)辅助操作 操作按钮:提供取消收藏操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前团队空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示当前团队空间文件(夹)。 :单击后以卡片视图展示当前团队空间文件(夹)。 收藏文件列表/卡片视图 列表视图中展示收藏的文件(夹)名称、文件大小、格式、所在空间以及收藏时间,默认按照收藏时间倒序排列展示,支持按照文件格式进行过滤,单击文件(夹)所在空间即可跳转至文件(夹)所在目录。 卡片视图中展示收藏的文件(夹)名称以及收藏时间,根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片都提供收藏与取消收藏操作。
  • 回收站 KooDrive将回收站分为个人回收站和团队回收站,个人空间和团队空间无需留存的文件被删除后进入到回收站,管理员可以操作拥有管辖权的所有团队回收站里的文件(夹)。普通用户只能操作自己个人回收站的文件夹。 回收站页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图5 回收站页面 文件(夹)辅助操作 操作按钮:提供清空、恢复、彻底删除操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前个人回收站或部门回收站的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示个人回收站或部门回收站文件(夹)。 :单击后以卡片视图展示个人回收站或部门回收站文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示回收站里文件(夹)名、归属者、大小、原始目录、删除时间。支持按照文件(夹)名、大小、删除时间升序或降序排列。 卡片视图中展示文件(夹)名、删除时间,根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片视图都提供回收站文件(夹)管理操作,包括: 清空、恢复、彻底删除团队回收站文件(夹) 清空、恢复、彻底删除个人回收站文件(夹)
  • 个人空间 个人空间是用户存放个人文件的空间,仅用户自己可见。创建用户时若分配了个人空间且空间为启用状态则用户个人空间页面可见。 个人空间页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图2 个人空间列表页 文件(夹)辅助操作 操作按钮:提供上传、新建、下载、移动、复制、删除等操作。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索个人空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 :单击后以列表视图展示个人空间文件(夹)。 :单击后以卡片视图展示个人空间文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则文件名中展示图片缩略图,单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间,根据文件(夹)格式展示对应图标。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则卡片中展示图片缩略图,单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作,包括: 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 转发个人文件至本部门团队空间 查看文件(夹)详细信息
  • 团队空间 团队空间是部门团队共享文件的空间,团队内的成员都可查看。各部门团队空间相互隔离,仅团队成员用户可见。创建部门时若分配了团队空间且团队空间为启用状态则团队空间首页可见。 图3 团队空间页首页 团队空间首页以卡片视图展示企业内部门空间,系统管理员可以看到企业内所有的部门空间,普通用户和部门管理员只能看到自己所属部门的团队空间,默认展示10个团队空间,鼠标滚动可加载下一页展示的团队空间。 团队空间卡片中展示团队名称、团队总空间大小、已使用空间大小、团队空间总人数,管理员及普通用户可以查看团队空间的详细信息。 图4 团队空间页 团队空间页主要由文件(夹)辅助操作和团队空间文件列表/卡片视图两部分组成。 文件(夹)辅助操作 目录信息:左上角展示当前团队空间路径信息。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前团队空间下的文件(夹),支持从左到右全字符匹配搜索。 :通过“全部类型”下拉框选择列表中展示的文件(夹)类型。 :单击后以列表视图展示当前团队空间文件(夹)。 :单击后以卡片视图展示当前团队空间文件(夹)。 团队空间文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件(夹)归属者、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则文件名中展示图片缩略图,单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间,根据文件(夹)格式展示对应图标。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则卡片中展示图片缩略图,单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作,包括: 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 管理员转发团队空间文件至个人空间 普通用户转发团队空间文件至个人空间 查看文件(夹)详细信息
  • 操作步骤 企业租户登录KooDrive服务控制台。 在控制台总览页勾选“我已阅读并同意《KooDrive服务使用声明》”,单击“立即开通”。 参考表1完成购买参数配置。 表1 参数说明 参数 参数说明 计费模式 目前只支持一种计费模式:按需计费。公测期间可免费使用KooDrive产品。 区域 不同区域的云服务产品之间内网互不相通。建议您选择最靠近您业务的区域,这样可以减少网络时延、提高访问速度。 KooDrive服务公测期间仅支持“华北-北京四”。 存储服务 云盘存储空间,最小配置为1TB,最小增量步长为1TB(例如,配置存储服务容量为1TB、2TB、3TB、...),最大可配置100TB。 用户服务 使用云盘服务的用户数,最小配置为5人,最小增量步长为5人(例如,配置用户服务人数为5、10、15、...),最大可配置1000用户数。 购买参数配置完成后勾选“我已阅读并同意《KooDrive服务使用声明》”,单击“开通”,弹出确认开通云空间的提示框,若确认开通,单击“确认”。 KooDrive服务公测期间不收费,费用统一为0元。 开通成功后,界面展示开通详情,包括:计费模式、开通区域、存储服务容量和用户服务的人数。单击“立即使用”进入KooDrive控制台创建组织并配置企业云盘信息。 开通KooDrive服务后,KooDrive会将企业租户的账号作为一个系统管理员账号,用该账号登录KooDrive业务应用后,可以进行组织(部门和用户)和空间管理。
  • 操作步骤 创建企业组织。 企业租户登录KooDrive服务控制台。 单击“云盘配置”,在云盘配置页面单击“创建组织”。 如果该租户下已存在创建的企业组织,则页面展示该组织下的云盘信息。 如果该租户下不存在企业组织,则页面展示创建组织操作入口。 输入组织名称,名称由 1-60 个中文、英文、数字及合法字符组成。 单击“下一步”,设置组织的域名。 域名是指网址中“www.”之后的内容,如: www.example.com中的example.com即为域名;或电子邮件地址中“@”符号之后的内容,如username@example.com中的example.com即为域名。 没有域名,输入组织简称,可使用2-30位字母、数字或它们的组合,如abc,后缀名为固定的.huaweiapaas.com,如图1所示。单击“下一步”。 图1 设置组织域名 已有域名,单击“使用自有域名”,输入自有域名,例如example.com,如图2所示。单击“下一步”。 图2 使用自有域名 域名设置后管理员为组织添加用户时用户的管理式华为账号默认带有域名后缀,如设置的组织域名为abc.huaweiapaas.com,添加的成员账号为xxx@abc.huaweiapaas.com,设置的组织域名为example.com,添加的成员账号为xxx@example.com。域名设置后不可修改。 阅读“管理式华为账号”相关声明,单击“同意”。 等待几秒钟自动进入云盘配置页面。 组织创建完成后,KooDrive自动以该组织名称创建企业的一级部门,后续创建的部门都属于一级部门的子部门。 配置云盘公共信息。 组织创建成功后才会展示“基础信息”和“公共配置”。 参考表1完成云盘公共信息配置。 表1 云盘公共信息 参数 说明 云盘名称 企业云盘名称,默认名称为“云盘1”,必填项。 单击可修改默认名称,名称长度不超过64个字符,修改完成后单击。 是否默认开通个人空间 配置是否在创建用户时默认开启开通个人空间按钮。 个人空间默认大小 配置开通个人空间时空间的默认值。系统管理员可自行设置个人空间容量缺省值,例如100GB,设置后,创建用户时默认自动为用户分配100GB的个人空间,系统管理员也可以在创建时修改该默认值。 单击可修改个人空间默认大小,修改完成后单击。 个人空间取值范围为1 - 已购买存储服务容量之间的正整数。 是否默认开通团队空间 配置是否在创建部门时默认开启开通团队空间按钮。 团队空间默认大小 配置开通团队空间时空间的默认值,缺省值为购买的存储服务容量。当管理员在创建部门时云盘默认自动为部门分配已购买存储服务容量大小的团队空间。 单击可修改团队空间默认大小,修改完成后单击。 团队空间取值范围为1 - 已购买存储服务容量之间的正整数。 已使用容量/存储容量上限 首次开通时,“已使用容量”为 0GB,“存储容量上限”为开通云盘服务时订购的存储服务容量。 已创建用户数/用户数上限 首次开通时,“已创建用户数”为0,“用户数上限”为开通云盘服务时订购的用户服务数。 云盘业务连接 云盘业务地址链接,单击“登录”即可进入KooDrive业务页面。 配置完成后,可单击“业务链接”后的“登录”按钮进入KooDrive业务页面。在KooDrive业务页面用户可以完善企业组织架构,使用企业及个人空间。
  • 下载文件 登录KooDrive服务业务面。 目前仅支持使用华为账号登录KooDrive服务业务面。 进入个人或团队空间文件列表页。 进入个人空间文件列表页: 在左侧导航栏单击“个人空间”,页面展示个人空间文件列表。 进入团队具体部门空间列表页: 在左侧导航栏单击“团队空间”,页面以卡片形式展示团队,选择团队单击进入团队空间文件列表页。 下载文件。 下载单个文件。 单击待下载文件行的“下载”,在浏览器“下载内容”中查看下载的文件。 批量下载文件(夹)。 勾选待下载文件(夹)前的复选框,可勾选多个,单击列表上方“下载”。界面显示“正在批量下载”字样。 打包完成后,界面显示“批量文件打包完成,正在下载,您可以通过浏览器下载内容页面查看进度”字样,在浏览器“下载内容”中查看打包下载的文件(夹)。 除下载单个文件外,批量下载皆为打包下载。 批量最多能下载700个文件(夹),文件(夹)大小不超过4GB。 不支持批量下载名称长度超过80个字符的文件(夹)。
  • 使用流程 企业租户使用云盘的流程如图1所示。 图1 使用流程 开通KooDrive服务 企业租户管理员进入KooDrive产品页,单击“立即开通”,在KooDrive订购页配置购买规格,单击“开通”。KooDrive服务公测期间不收费,为免费使用产品。 创建组织并配置企业云盘 企业租户管理员进入KooDrive控制台云盘配置页,创建企业组织名称,完成企业云盘初始化信息配置。 创建部门和用户 企业租户管理员进入KooDrive业务页面,创建企业部门,为其分配部门空间;创建部门用户,为其分配个人空间。 使用云盘 管理员和普通用户在KooDrive业务用户中心页面中进行上传下载、文件管理等操作。
  • 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
  • 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不会生效。
共100000条