华为云用户手册

故障描述 客户端通过已有连接执行业务时，返回如下报错信息： 故障一 org.postgresql.util.PSQLException: An I/O error occurred while sending to the backend. 故障二 org.postgresql.util.PSQLException: The connection attempt failed ... Caused by: java.net.SocketException: Connection reset

安装Python 在开始在CodeArts IDE上使用Python前，请确保您已在计算机上安装了Python。 在Windows上，您需要手动下载并安装Python解释器。 在Linux上，您可以使用内置的Python 3安装，但为了安装其他Python包，您还需要通过get-pip.py安装 “pip” 包管理器。 接下来，运行以下命令验证Python安装： 在Windows上，请在命令提示符中运行： python --version 在Linux上，请在终端中运行： python3 --version 如果Python安装成功，输出将显示对应Python版本号显示。您也可以使用 “py -0” 命令来查看已安装的Python版本。默认解释器将由星号（*）标记。 父主题： 简介

运行测试 CodeArts IDE为运行和调试您的测试用例提供了多个选项： 在测试类的代码编辑器中，单击测试类声明旁的运行按钮（），运行该类中的所有测试。或者单击某个测试方法旁边的运行按钮来仅运行单个测试。要调试测试，请右键单击运行按钮（），并从上下文菜单中选择“调试测试”。 使用“测试”视图来管理和运行测试。 配置pytest和unittest专用的启动配置。 在命令面板（“Ctrl+Ctrl”/“Ctrl+Shift+P”）中，搜索“Test”并使用与测试相关的命令，例如“在当前文件中运行测试”或“在光标处运行测试”。 父主题： 测试

运行代码 您可以通过以下的任意方式来使用当前选定的解释器运行代码： 单击CodeArts IDE主工具栏上的“开始执行（不调试）”按钮 （），以启动内置的“当前文件”启动配置。 在代码编辑器的任意位置右键单击，并选择“在终端中运行 Python 文件”。如果您在选定的代码块上调用此命令，则可以仅运行该部分代码。 在资源管理器中右键单击Python文件，并从上下文菜单中选择“在终端中运行 Python 文件”。 父主题： 简介

搜索查询语法 搜索查询是一个字符串，用于在SmartSearch窗口（“Shift+Shift” / “Ctrl+Shift+A”）中查询对应条目，由“dataSource:stringToMatch”对组成，这些对可以通过空格或运算符连接。如果查询中省略了“dataSource”，则搜索将在所有可用的数据源中进行。使用“stringToMatch:dataSource”，即反向模式，也是可能的。 以下是可用的数据源列表： 数据源名称 数据源缩写 描述 “class”/“type” “c”/“t” 类实体 “member” - 成员实体，即类方法或类字段实体 “text” - 文本实体 “file” “fn” 文件和文件夹实体 “command” - 命令实体 父主题： 基本用法

调试代码 CodeArts的Python扩展提供了调试支持，让您能够设置断点、检查数据，在逐步执行程序时使用调试控制台。 对于快速开始项目，您可以在 “main.py” 文件的第 14 行设置一个断点。将光标悬置在 “print_hi” 调用上，然后按下 “F9” / “Ctrl+Shift+B” / “Ctrl+F8”（IDEA快捷键）。您也可以通过单击编辑器左侧的行号旁的空白区域来设置断点。 接下来需要初始化调试器，您可以按下 “F5” / “F11” / “Shift+F9”（IDEA快捷键），或者单击CodeArts IDE主工具栏上的“开始调试”按钮 （）。 CodeArts IDE将启动内置的“当前文件”启动配置，调试器将在包含断点的那一行暂停运行。此时您可以使用调试工具栏上的命令来控制程序执行，并查看“运行和调试”视图中的“变量”来检查变量。 要了解在CodeArts IDE中调试Python的更多详细信息，请参阅“Python 调试”文档。 父主题： 简介

购买激活码 在CodeArts IDE客户端完成登录并且单击“购买或管理”激活码后，将会自动跳转到CodeArts IDE控制台页面。若此时您已有未绑定的有效激活码，可跳转至步骤1.2。在该页面右上角单击“购买激活码”即可开始申请流程。 进入到激活码购买页面后，您可选择是否自动续费，激活码数量（单次购买数量最多为10），以及是否绑定当前用户（默认勾选）。勾选“绑定当前用户”可以帮您省略购买后手动绑定激活码的过程。 如果您已提前购买并绑定激活码，可省略此流程直接在CodeArts IDE客户端内完成激活。 父主题： 激活CodeArts IDE客户端

环境变量定义文件 环境变量定义文件是一个以“environment_variable=value”为形式，键值对构成的纯文本文件，其中“#”用于注释。该文件不支持多行值，但值可以引用系统中或文件中先前已定义的其他任何环境变量。有关更多信息，请参阅变量替换。环境变量定义文件可用于调试和工具执行（包括linters、格式化器、代码补全和测试工具）等场景，但不应用于终端。 默认情况下，CodeArts IDE会在当前项目文件夹中查找并加载名为“.env”的文件，并应用这些定义。这是由用户设置中的默认条目“"python.envFile": "${workspaceFolder}/.env"”来决定的。你可以更改“python.envFile”设置来使用不同的定义文件。 例如，在开发Web应用程序时，你可以使用不同的定义文件来存储不同的URL和其他设置，而不是直接在代码中设置。这样您就可以轻松地在开发服务器和生产服务器之间切换，如： dev.env file # dev.env - development configuration # API endpoint MYPROJECT_APIENDPOINT=https://my.domain.com/api/dev/ # Variables for the database MYPROJECT_DBURL=https://my.domain.com/db/dev MYPROJECT_DBUSER=devadmin MYPROJECT_DBPASSWORD=!dfka**213= prod.env file # prod.env - production configuration # API endpoint MYPROJECT_APIENDPOINT=https://my.domain.com/api/ # Variables for the database MYPROJECT_DBURL=https://my.domain.com/db/ MYPROJECT_DBUSER=coreuser MYPROJECT_DBPASSWORD=kKKfa98*11@ 然后，您可以将 “python.envFile” 设置设置为 “${workspaceFolder}/prod.env”，然后将调试配置中的 “envFile” 属性设置为 “${workspaceFolder}/dev.env”。 当使用多种方法指定环境变量时，有以下的优先顺序。 “launch.json”中直接定义的“env” 变量会覆盖“launch.json”中 “envFile”设置中定义的变量，以及“python.envFile”设置指定的“.env”文件包含的环境变量。 “launch.json”的“envFile”设置中定义的环境变量会覆盖“python.envFile”设置指定的“.env”文件包含的环境变量。 父主题： 环境变量

类型层次结构 “类型层次结构”视图显示了继承关系，允许您查看选定类的父类和子类。要打开该视图，请在右侧的“活动栏”中单击“类型层次结构”。 右键单击一个类型，选择“显示类型层次结构”，或按下 “Ctrl+H”（IDEA快捷键）。 使用“类型层次结构”视图工具栏按钮，可以切换查看子类、父类或一起查看。 ：查看父类和子类。 ：仅查看父类。 ：仅查看子类。 /: 展开/折叠列表中的所有项。 ：按字母顺序对列表进行排序。 ：刷新列表内容。 在“类型层次结构”视图中，您可以右键单击一个类，并从上下文菜单中选择“基于此类型构建”，以基于选定的类重新构建层次结构。 父主题： 代码浏览

基本用法 通过按下 “Shift+Shift” / “Ctrl+Shift+A” 来启动SmartSearch。 输入搜索请求。要缩小搜索范围，例如仅搜索类成员或CodeArts IDE命令，可以在SmartSearch窗口中通过按下“Tab”/“Shift+Tab”来切换标签页，或者使用搜索查询语法。 使用光标在条目之间导航，并按下“Enter”键跳转到相应的位置或执行命令。另外，也可以双击所需的条目。要关闭SmartSearch窗口，请按下“Escape”键。 搜索查询语法 搜索运算符 父主题： 代码搜索

编程语言的代码补全 智能代码补全是说各种代码编辑功能的总称，包括：代码补全、参数信息、快速信息和成员列表。代码补全功能有时被称为“内容辅助”或“代码提示”。 CodeArts IDE为JavaScript、TypeScript、JSON、HTML、 CSS 、S CS S和Less编程语言提供代码补全。CodeArts IDE支持任何编程语言的基于单词的补全，但也可以通过安装语言扩展来提供更丰富的代码补全。 父主题： 代码补全

从命令行新建虚拟环境 要使用“venv”手动创建虚拟环境，请使用以下命令。其中“.venv”是环境文件夹的名字。 Windows # You can also use py -3 -m venv .venv python -m venv .venv Linux # You may need to run sudo apt-get install python3-venv first python3 -m venv .venv 有关venv模块的更多详细信息，请参见Python.org上创建虚拟环境。 当您在项目文件夹内创建新的虚拟环境时，CodeArts IDE会提示您将其设置为项目解释器。 父主题： 使用Python环境

使用CamelHumps选择和导航代码 CodeArts IDE可以使用CamelHumps简化代码导航。如果editor.useCamelHumpsWords配置已启用，按下“Ctrl+Arrow”在单词之间导航会带您在CamelHump单词的各个部分之间进行导航，而不是在整个单词之间进行导航。 如果editor.honorCamelHumpsWords配置启用后，双击CamelHump单词只会选择其双击的部分，而不是整个单词。

并排编辑 您可以在垂直和水平方向打开编辑器。如果您已经打开了一个编辑器，您可以通过以下方式在现有编辑器的一侧打开另一个编辑器： 按住“Alt”或“Ctrl”键双击资源管理器中的一个文件。 按“Ctrl+\”将现有的编辑器一分为二。 资源管理器中右键单击文件，在上下文菜单中选择“在侧边打开”（“Ctrl+Enter”）。 单击编辑器右上角的。 可以将文件拖动到编辑器区域的任意一侧。 拆分编辑器时，将创建编辑器组，这些编辑器组可以容纳多个选项卡。 您可以通过“打开的编辑器”视图查看所有创建的编辑器组，您可以通过单击右侧活动栏中的打开该视图。 要快速聚焦编辑器组，请使用键盘快捷键“Ctrl+1”（聚焦第一组）、“Ctrl+2”（聚焦第二组）、“Ctrl+3”（聚焦第三组），以此类推。 新打开的文件将在当前聚焦组内打开选项卡。如有需要，您可以锁定组，以防止在其中打开新选项卡。要执行此操作，请单击组标题中的“更多操作”按钮（），然后从弹出菜单中选择“锁定组”。

代码片段 代码片段是模板，可以简化如循环或条件语句等重复代码模式的输入。CodeArts IDE为Python语言提供了多个内置的代码片段，这些片段和其他建议一起出现在代码补全（“Ctrl+I” / “Ctrl+Space”/“Ctrl+Shift+Space”）中。 代码片段通常放置在代码补全建议列表底部。要快速访问它们，请触发代码补全（“Ctrl+I”/“Ctrl+Space” /“Ctrl+Shift+Space”），然后按“Ctrl+Up”/“Up”。 常规片段 后缀片段 父主题： 代码编辑

将测试框架集成到项目中 在您的项目中启动测试框架集成： 单击CodeArts IDE底部的“测试“（）按钮来打开测试视图。 在测试视图中，单击“Configure Python Tests“按钮。 在弹出的窗口中选择测试框架来启动对应集成。 如果您选择“pytest“，Codearts会根据pytest的测试识别规范自动发现测试用例。 如果您选择“unittest“，您需要执行以下步骤来识别测试用例。 在打开的对话框中，选择包含测试源文件的项目文件夹。 在接着打开的对话框中，选择用于识别您的测试文件的文件通配符模式。 测试框架集成配置完成后，CodeArts IDE会在测试视图中展示发现的测试用例。 父主题： 测试

浏览代码 CodeArts提供了丰富的代码导航功能。例如，您可以在代码编辑器中将鼠标悬停在符号上，以查看其快速信息。通过 “Ctrl+单击” 符号，或按下 “F3” / “Alt+F11”（IDEA快捷键） / “F4”（IDEA快捷键） / “Ctrl+Enter”（IDEA快捷键） / “Ctrl+B”（IDEA快捷键），快速导航到符号的声明位置。 您也可以通过按下 “Shift+Shift” / “Ctrl+Shift+A” 来启动CodeArts IDE SmartSearch功能，立即搜索并导航到任何项目位置，查找和执行任何CodeArts IDE命令。 父主题： 简介

为什么长时间没有EIP、ELB、EVS的资源优化建议？ 若您已开通优化顾问OA，但长时间没有EIP、ELB、EVS资源优化建议，可能是以下几种原因： 您没有闲置的EIP、ELB、EVS资源。 您未开启OA的自动检查功能，且没有执行手动检查。 您不符合OA提供成本检查的条件，详见OA相关说明：https://support.huaweicloud.com/productdesc-oa/oa_01_0008.html 父主题： 成本优化

有哪些途径可以使用 图像搜索 的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。 REST客户端 Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。 针对Firefox，请参见Firefox RESTClient。 针对Chrome，请参见Postman。 父主题： API使用类

错误码显示ModelArts.4603、ModelArts.4704怎么处理？ 如果在调用API时返回错误信息与错误码： 调用接口出错后，返回的消息体中具体的错误代码及错误信息为： { "error_code":"ModelArts.4603", "error_msg":"Obtaining the file from the URL failed." } 表示从URL获取图片数据失败。可通过以下几个方面进行排查： 请确保提供的URL支持HTTP/HTTPS请求协议，即格式为http/https url。 请检查存储图片的服务器是否稳定可靠，网络连接是否有异常，是否公网可访问。 请检查下载图片的content-type是否为标准类型，例如：image/gif、image/jpeg、image/png。建议：使用OBS的URL进行请求。 调用接口出错后，返回的消息体中具体的错误代码及错误信息为： { "error_code":"ModelArts.4704", "error_msg":"Obtaining the file from the OBS failed." } 表示从OBS获取图片数据失败，请确保存储图片的OBS路径存在且可访问，如果路径存在，请确保设置OBS桶策略为公共桶。建议：不要使用跨区域的OBS路径，如果OBS与调用服务部署区域不属于同一个区域，建议本地下载图片后使用image_base64的调用方式。 父主题： 错误码问题

请求示例 输入问题“桌面云无法登录”，返回最匹配的top5个知识点 POST https://{endpoint}/v1/1604d8170cd84440a81281e5a3a04f8b/qabots/303a0a00-c88a-43e3-aa2f-d5b8b9832b02/requests Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "user_id": "z00123456", "session_id": "xxxxxxxxxxxxxxxxxx", "operate_type":3, "question": "桌面云无法登录", "extends":{ "domains":["桌面云"], "top":5 }, "threshold_enable":false, "chat_enable":true }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 消息体的类型（格式），参数值为“application/json”。 表3 请求Body参数 参数 是否必选 参数类型 说明 session_id 是 String 会话ID，由任意字符串组成，由用户自定义产生，用来区分不同的会话。 具体获取方式请参见开启会话章节。 user_id 否 String 用户ID，用来区分唯一用户信息。 question 是 String 用户问题。 extends 否 Extends object 扩展参数项。 threshold_enable 否 Boolean true：启动内部阈值，返回经过阈值处理之后的答案。 false：不启用内部阈值，返回原答案。 chat_enable 否 Boolean 默认true true：使用内部闲聊语料进行兜底。 false：不使用闲聊兜底。 operate_type 否 Integer 调用接口时候传入，用以标记的问答的行为，默认为0，最终会展示在问答日志里。 0 用户输入 1 单击热点问题 3 单击推荐问题 4 单击问题提示 表4 Extends 参数 是否必选 参数类型 描述 domains 否 Array of strings 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。 top 否 Integer 返回答案数量，默认为5，取值范围1~10。

响应消息 状态码： 200 表5 响应Body参数 参数 参数类型 描述 request_id String 请求ID。 调用失败时无此字段。 question String 问题。 调用失败时无此字段。 answers Array of Answers objects 最相似的问题集。调用失败时无此字段。 extends Extends object 扩展参数项。调用失败时无此字段。 表6 Answers 参数 参数类型 描述 qa_pair_id String 问答对ID。 st_question String 标准问题。 ex_questions Array of ExQuestions objects 扩展问。 answer String 答案。 score Float 相似度得分，精确到小数点后3位。 domain String 问题类别。 表7 ExQuestions 参数 参数类型 描述 content String 扩展问题。 表8 Extends 参数 是否必选 参数类型 描述 domains 否 Array of strings 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。 top 否 Integer 返回答案数量，默认为5，取值范围1~10。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

URI POST https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 qabot_id 是 String qabot编号，UUID格式，如：303a0a00-c88a-43e3-aa2f-d5b8b9832b02。 进入 问答机器人 的Console界面，在“机器人名称/ID”列显示对应的qabot_id。

调用API获取项目ID 项目ID还可以通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为 IAM 的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如， 对话机器人服务 部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 处理措施 401 CBS.0000 用户无公测权限。 请根据界面提示，申请公测权限。 401 CBS.0011 认证失败。 检查Token是否正确，使用正确的Token重新尝试。 401 CBS.0012 认证信息缺失。 补全正确的认证信息后重新尝试。 401 CBS.0013 认证信息获取失败。 检查Token是否正确，使用正确的Token重新尝试。 400 CBS.0021 请求参数异常。 检查请求参数字段名，修改正确后重新尝试。 400 CBS.0022 请求参数内容错误。 检查请求参数内容，修改正确后重新尝试。 500 CBS.9999 db error。 服务后台错误，请联系专业工程师。 500 CBS.9998 iam error。 服务后台错误，请联系专业工程师。 500 CBS.9997 lab内部有core异常。 服务后台错误，请联系专业工程师。 400 CBS.1114 服务未开通。 按根据界面提示开通或购买服务。 400 CBS.1124 服务开通失败。 检查是否符合服务开通条件，然后重新尝试。 500 CBS.1134 请求下发失败。 服务后台错误，请联系专业工程师。 500 CBS.0031 内部服务异常。 服务后台错误，请联系专业工程师。 500 CBS.0032 ES资源不存在。 服务后台错误，请联系专业工程师。 400 CBS.1214 查询的数据集资源不存在。 检查数据集id是否正确，使用正确的id重新尝试。 400 CBS.1611 OBS访问失败。 确认OBS认证信息是否正确，使用正确的认证信息重新尝试。 400 CBS.1612 OBS资源不存在。 确认OBS资源是否存在，然后重新尝试。 400 CBS.1613 文件格式异常。 确认文件格式符合要求后重新尝试。 400 CBS.2114 查询的qabot资源不存在。 检查qabot id是否正确，使用正确的id重新尝试。 400 CBS.2122 qabot创建参数错误。 检查qabot参数，使用正确的参数重新尝试。 400 CBS.2125 机器人个数超过限制。 检查已创建的机器人个数是否已超过3个，再重新尝试。 400 CBS.2145 lab相关的知识库、词典、模型等资源没有删除。 检查lab内的知识库、词典、模型等资源是否已被删除，再重新尝试。 400 CBS.2154 待重启的qabot资源不存在。 检查qabot id是否正确，使用正确的id重新尝试。 400 CBS.2202 知识库的导入参数错误。 检查知识库的导入参数，使用正确的参数重新尝试。 400 CBS.2203 待导入知识库的文件格式异常。 检查文件格式，修改正确后重新尝试。 400 CBS.2205 待导入知识库的qa对个数超过限制。 检查待导入的qa对个数是否已超过100万条，再重新尝试。 400 CBS.2611 OBS访问失败。 确认该账号有无访问OBS权限，再重新尝试。 400 CBS.2624 桶资源不存在。 确认桶资源是否存在，然后重新尝试。 400 CBS.2641 uri中的path参数异常。 检查uri参数中的path字段名，修改正确后重新尝试。 400 CBS.2312 body参数错误。 检查body中的参数，使用正确的参数重新尝试。 400 CBS.2322 问答请求参数错误。 检查body中的参数，使用正确的参数重新尝试。 400 CBS.2334 待评价的问答资源不存在。 检查请求id是否正确，使用正确的id重新尝试。 400 CBS.2344 待转成人工的问答资源不存在。 检查请求id是否正确，使用正确的id重新尝试。 400 CBS.2412 待检测文本序列参数错误。 检查body中的参数，使用正确的参数重新尝试。 400 CBS.2413 待检测文本序列格式异常。 检查文本序列的格式，修改正确后重新尝试。 400 CBS.0001 用户请求参数错误 请根据错误提示检查请求参数并修改。 401 CBS.0002 认证失败 检查token是否正确，使用正确token重新尝试。 400 CBS.0003 无法找到请求资源 请根据错误提示，检查请求的资源id是否填写正确。

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 用户是服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

查看策略及详情 在 DataArts Studio 控制台首页，选择实例，单击“进入控制台”，选择对应工作空间的“数据安全”模块，进入数据安全页面。 图1 选择数据安全 单击左侧导航树中的“成员管理”，进入成员管理页面。 图2 进入成员管理 单击操作栏中的“编辑”，在弹窗中可以为成员添加或删除所在的角色/权限集，管理其权限。 图3 编辑角色/权限集 单击操作栏中的“查看权限”，可以查看当前成员的基本信息，以及拥有的权限以及权限来源。

操作步骤 写数据服务端调优 参数入口： 进入HBase服务参数“全部配置”界面，具体操作请参考修改集群服务配置参数章节。 表1 影响实时写数据配置项 配置参数 描述 默认值 hbase.wal.hsync 控制HLog文件在写入到HDFS时的同步程度。如果为true，HDFS在把数据写入到硬盘后才返回；如果为false，HDFS在把数据写入OS的缓存后就返回。 把该值设置为false比true在写入性能上会更优。 true hbase.hfile.hsync 控制HFile文件在写入到HDFS时的同步程度。如果为true，HDFS在把数据写入到硬盘后才返回；如果为false，HDFS在把数据写入OS的缓存后就返回。 把该值设置为false比true在写入性能上会更优。 true GC_OPTS HBase利用内存完成读写操作。提高HBase内存可以有效提高HBase性能。GC_OPTS主要需要调整HeapSize的大小和NewSize的大小。调整HeapSize大小的时候，建议将Xms和Xmx设置成相同的值，这样可以避免JVM动态调整HeapSize大小的时候影响性能。调整NewSize大小的时候，建议把其设置为HeapSize大小的1/8。 HMaster：当HBase集群规模越大、Region数量越多时，可以适当调大HMaster的GC_OPTS参数。 RegionServer：RegionServer需要的内存一般比HMaster要大。在内存充足的情况下，HeapSize可以相对设置大一些。 说明： 主HMaster的HeapSize为4G的时候，HBase集群可以支持100000 region数的规模。根据经验值，集群每增加35000个region，HeapSize增加2G，主HMaster的HeapSize不建议超过32GB。 HMaster -server -Xms4G -Xmx4G -XX:NewSize=512M -XX:MaxNewSize=512M -XX:MetaspaceSize=128M -XX:MaxMetaspaceSize=512M -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:CMSInitiatingOccupancyFraction=65 -XX:+PrintGCDetails -Dsun.rmi.dgc.client.gcInterval=0x7FFFFFFFFFFFFFE -Dsun.rmi.dgc.server.gcInterval=0x7FFFFFFFFFFFFFE -XX:-OmitStackTraceInFastThrow -XX:+PrintGCTimeStamps -XX:+PrintGCDateStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=1M Region Server -server -Xms6G -Xmx6G -XX:NewSize=1024M -XX:MaxNewSize=1024M -XX:MetaspaceSize=128M -XX:MaxMetaspaceSize=512M -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:CMSInitiatingOccupancyFraction=65 -XX:+PrintGCDetails -Dsun.rmi.dgc.client.gcInterval=0x7FFFFFFFFFFFFFE -Dsun.rmi.dgc.server.gcInterval=0x7FFFFFFFFFFFFFE -XX:-OmitStackTraceInFastThrow -XX:+PrintGCTimeStamps -XX:+PrintGCDateStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=1M hbase.regionserver.handler.count 表示在RegionServer上启动的RPC侦听器实例数。如果设置过高会导致激烈线程竞争，如果设置过小，请求将会在RegionServer长时间等待，降低处理能力。根据资源情况，适当增加处理线程数。 建议根据CPU的使用情况，可以选择设置为100至300之间的值。 200 hbase.hregion.max.filesize HStoreFile的最大大小（单位：Byte）。如果任何一个列族HStoreFile超过此参数值，则托管Hregion将会一分为二。 10737418240 hbase.hregion.memstore.flush.size 在RegionServer中，当写操作内存中存在超过memstore.flush.size大小的memstore，则MemStoreFlusher就启动flush操作将该memstore以hfile的形式写入对应的store中。 如果RegionServer的内存充足，而且活跃Region数量也不是很多的时候，可以适当增大该值，可以减少compaction的次数，有助于提升系统性能。 同时，这种flush产生的时候，并不是紧急的flush，flush操作可能会有一定延迟，在延迟期间，写操作还可以进行，Memstore还会继续增大，最大值为“memstore.flush.size” * “hbase.hregion.memstore.block.multiplier”。当超过最大值时，将会阻塞操作。适当增大“hbase.hregion.memstore.block.multiplier”可以减少阻塞，减少性能波动。单位：字节。 134217728 hbase.regionserver.global.memstore.size 更新被锁定以及强制冲洗发生之前一个RegionServer上支持的所有MemStore的大小。RegionServer中，负责flush操作的是MemStoreFlusher线程。该线程定期检查写操作内存，当写操作占用内存总量达到阈值，MemStoreFlusher将启动flush操作，按照从大到小的顺序，flush部分相对较大的memstore，直到所占用内存小于阈值。 阈值 = “hbase.regionserver.global.memstore.size” * “hbase.regionserver.global.memstore.size.lower.limit” * “HBase_HEAPSIZE” 说明： 该配置与“hfile.block.cache.size”的和不能超过0.8，也就是写和读操作的内存不能超过HeapSize的80%，这样可以保证除读和写外其它操作的正常运行。 0.4 hbase.hstore.blockingStoreFiles 在region flush前首先判断file文件个数，是否大于hbase.hstore.blockingStoreFiles。 如果大于需要先compaction并且让flush延时90s（这个值可以通过hbase.hstore.blockingWaitTime进行配置），在延时过程中，将会继续写从而使得Memstore还会继续增大超过最大值 “memstore.flush.size” * “hbase.hregion.memstore.block.multiplier”，导致写操作阻塞。当完成compaction后，可能就会产生大量写入。这样就导致性能激烈震荡。 增加hbase.hstore.blockingStoreFiles，可以减低BLOCK几率。 15 hbase.regionserver.thread.compaction.throttle 大于此参数值的压缩将被大线程池执行，单位：Byte。控制一次Minor Compaction时，进行compaction的文件总大小的阈值。Compaction时的文件总大小会影响这一次compaction的执行时间，如果太大，可能会阻塞其它的compaction或flush操作。 1610612736 hbase.hstore.compaction.min 每次执行minor compaction的HStoreFile的最小数量。当一个Store文件超过该值时，会进行compact，适当增大该值，可以减少文件被重复执行compaction。但是如果过大，会导致Store文件数过多而影响读取的性能。 6 hbase.hstore.compaction.max 每次执行minor compaction的HStoreFile的最大数量。与“hbase.hstore.compaction.max.size”的作用基本相同，主要是控制一次compaction操作的时间不要太长。 10 hbase.hstore.compaction.max.size 如果一个HFile文件的大小大于该值，那么在Minor Compaction操作中不会选择这个文件进行compaction操作，除非进行Major Compaction操作。 这个值可以防止较大的HFile参与compaction操作。在禁止Major Compaction后，一个Store中可能存在几个HFile，而不会合并成为一个HFile，这样不会对数据读取造成太大的性能影响。单位：字节。 9223372036854775807 hbase.hregion.majorcompaction 单个区域内所有HStoreFile文件主压缩的时间间隔，单位：毫秒。由于执行Major Compaction会占用较多的系统资源，如果正在处于系统繁忙时期，会影响系统的性能。 如果业务没有较多的更新、删除、回收过期数据空间时，可以把该值设置为0，以禁止Major Compaction。 如果必须要执行Major Compaction，以回收更多的空间，可以适当增加该值，同时配置参数“hbase.offpeak.end.hour”和“hbase.offpeak.start.hour”以控制Major Compaction发生在业务空闲的时期。单位：毫秒。 604800000 hbase.regionserver.maxlogs hbase.regionserver.hlog.blocksize 表示一个RegionServer上未进行Flush的Hlog的文件数量的阈值，如果大于该值，RegionServer会强制进行flush操作。 表示每个HLog文件的最大大小。如果HLog文件大小大于该值，就会滚动出一个新的HLog文件，旧的将被禁用并归档。 这两个参数共同决定了RegionServer中可以存在的未进行Flush的hlog数量。当这个数据量小于MemStore的总大小的时候，会出现由于HLog文件过多而触发的强制flush操作。这个时候可以适当调整这两个参数的大小，以避免出现这种强制flush的情况。单位：字节。 32 134217728 写数据客户端调优 写数据时，在场景允许的情况下，更适合使用Put List的方式，可以极大的提升写性能。每一次Put的List的长度，需要结合单条Put的大小，以及实际环境的一些参数进行设定。建议在选定之前先做一些基础的测试。 写数据表设计调优 表2 影响实时写数据相关参数 配置参数 描述 默认值 COMPRESSION 配置数据的压缩算法，这里的压缩是HFile中block级别的压缩。对于可以压缩的数据，配置压缩算法可以有效减少磁盘的IO，从而达到提高性能的目的。 说明： 并非所有数据都可以进行有效压缩。例如一张图片的数据，因为图片一般已经是压缩后的数据，所以压缩效果有限。常用的压缩算法是SNAPPY，因为它有较好的Encoding/Decoding速度和可以接受的压缩率。 NONE BLOCKSIZE 配置HFile中block块的大小，不同的block块大小，可以影响HBase读写数据的效率。越大的block块，配合压缩算法，压缩的效率就越好；但是由于HBase的读取数据是以block块为单位的，所以越大的block块，对于随机读的情况，性能可能会比较差。 如果要提升写入的性能，一般扩大到128KB或者256KB，可以提升写数据的效率，也不会影响太大的随机读性能。单位：字节 65536 IN_MEMORY 配置这个表的数据优先缓存在内存中，这样可以有效提升读取的性能。对于一些小表，而且需要频繁进行读取操作的，可以设置此配置项。 false

操作场景 此功能适用于Hive，Spark2x/Spark。 开启此功能后，在创建Hive内部表时，不能指定location。即表创建成功之后，表的location路径会被创建在当前默认warehouse目录下，不能被指定到其他目录。如果创建内部表时指定location，则创建失败。 开启本功能之后，创建Hive内部表不能执行location。因为对建表语句做了限制，如果数据库中已存在建表时指向非当前默认warehouse目录的表，在执行建库、表脚本迁移、重建元数据操作时需要特别注意，防止错误。