简介《HANA Studio 操作手册》面向刚接触 SAP HANA 平台的初学者与开发人员帮助其快速上手 HANA Studio 这一核心开发与管理工具减少自学过程中的摸索成本。手册围绕 HDBStudio 组件展开涵盖系统与仓库视图查看、账户申请、SQL 控制台使用以及 Schema、Package、Procedure、Decision Table、Table、Virtual Table、Scalar Function、Table Function、Calculation View、Synonym、Trigger、View 等对象的创建方法并讲解对象激活与语法一致性检查还涉及 DEV 到 TST 环境的程序传输、CR Release 顺序及常见问题解答。资源包共 1 个 doc 文件约 4.77MB目录结构清晰便于按章节检索学习。目前已有 3155 人学习下载适合希望系统掌握 HANA 数据库管理、建模与开发流程的读者参考。1. HANA Studio 操作手册从连不上到跑得动中间隔着多少坑HANA Studio 这个工具第一次上手的人十有八九会卡在连接那一步。不是密码错就是端口不通要么就是客户端版本和服务器对不上。我见过太多同事装完客户端对着登录界面折腾一下午最后发现是 SAP 主机名解析没配。这本操作手册要解决的不是“HANA 是什么”这种教科书问题而是你拿到一套 HANA 环境之后怎么用 Studio 连上去、建 schema、写 SQL、看执行计划、导数据、排查性能问题。适合两类人一是刚接触 SAP HANA 的开发和运维二是从其他数据库转过来、需要快速上手 HANA Studio 的老手。下面按实际干活顺序拆开讲每一步都落到具体操作和参数上。2. 装完客户端先别急着连HANA Studio 的环境准备与连接配置2.1 客户端版本怎么选才不翻车HANA Studio 本质上是 Eclipse 插件集合SAP 官方现在主推的是基于 Eclipse 的 SAP HANA Tools。选版本的核心原则只有一条客户端版本不能低于服务器版本。比如服务器是 HANA 2.0 SPS05你装个 SPS03 的客户端连上去大概率报“incompatible version”。常见做法是去 SAP Support Portal 下载对应 SPS 的 HANA Studio或者直接用 Eclipse 的 Install New Software 功能把 HANA Tools 的更新站点填进去在线装。我一般会先确认服务器版本命令在 HANA 服务器上跑HDB info # 输出里找 version 字段比如 2.00.050.00.1592305219拿到版本号之后客户端选相同 SPS 或更高一档。注意不要跨大版本比如 1.0 的客户端连 2.0 的服务器即使能连上很多新特性也用不了。2.2 连接配置里三个必调参数装好客户端后在 HANA Studio 里右键 Add System填主机名、实例号、用户名密码。这里有三个参数最容易出问题参数说明常见错误Host Name服务器主机名或 IP用 IP 时证书校验失败Instance Number两位数字如 00填成 0 或 000Mode默认 Multiple Containers单容器环境选错导致连不上如果服务器开了 SSLHost Name 必须和证书里的 CN 一致用 IP 会报证书不匹配。解决办法是在客户端 JVM 参数里加-Djavax.net.ssl.trustStore指向信任库或者让管理员把 IP 加进证书 SAN 里。连接时如果报“Connection refused”先在服务器上确认端口# 实例号 00 对应的 SQL 端口是 30015 netstat -tlnp | grep 30015 # 如果没监听检查 HDB 是否启动 su - hdbadm HDB start2.3 用 hdbsql 做连接前的快速验证在打开 Studio 之前我习惯先用 hdbsql 命令行工具验证网络和认证是否通。这个工具在客户端安装目录的hdbclient下# 进入 hdbclient 目录 cd /usr/sap/hdbclient # 连接测试-n 指定主机:端口-u 用户名 ./hdbsql -n 192.168.1.100:30015 -u SYSTEM -p YourPassword -i 00 # 连上后执行简单查询 SELECT * FROM DUMMY;如果 hdbsql 能连上而 Studio 连不上问题基本出在客户端 JVM 或 Eclipse 配置上跟服务器无关。反过来 hdbsql 也连不上那就先查网络和服务器状态别在 Studio 里浪费时间。3. 连上之后干什么Schema、用户与权限的落地操作3.1 建 Schema 和用户的标准流程HANA 里 Schema 是对象的容器用户是登录身份两者通过权限关联。新建 Schema 一般用 SQL 执行-- 创建 schema注意 schema 名通常大写 CREATE SCHEMA MY_SCHEMA OWNER SYSTEM; -- 创建用户并设置初始密码 CREATE USER MY_USER PASSWORD Init1234 NO FORCE_FIRST_PASSWORD_CHANGE; -- 把 schema 的权限授予用户 GRANT SELECT, INSERT, UPDATE, DELETE ON SCHEMA MY_SCHEMA TO MY_USER; -- 如果需要建表权限 GRANT CREATE ANY ON SCHEMA MY_SCHEMA TO MY_USER;参数说明NO FORCE_FIRST_PASSWORD_CHANGE在自动化脚本里常用避免首次登录被强制改密。生产环境建议去掉这个选项强制用户首次登录改密码。GRANT的权限粒度可以细到单表但开发阶段一般先给 schema 级权限后面再收紧。3.2 用 Studio 图形界面建表的注意事项在 Studio 里右键 Schema → New Table填列名、类型、主键。这里有个血泪经验HANA 的列存表COLUMN TABLE和行存表ROW TABLE性能差异巨大。默认建的是列存表适合分析型查询如果业务是高频单行更新比如配置表要手动改成行存。建表时注意 VARCHAR 长度HANA 限制是 5000超过要用 NCLOB。主键列会自动建索引但不要建太多索引HANA 的列存本身对全表扫描很快索引反而占内存。3.3 权限排查为什么用户看不到表经常遇到用户说“我连上了但看不到表”。排查顺序确认用户对 schema 有 SELECT 权限SELECT * FROM SYS.GRANTED_PRIVILEGES WHERE GRANTEE MY_USER;确认表在正确的 schema 下SELECT * FROM SYS.TABLES WHERE SCHEMA_NAME MY_SCHEMA;如果表是其他用户建的需要额外授权GRANT SELECT ON MY_SCHEMA.MY_TABLE TO MY_USER;Studio 里可以在用户上右键 → Open SQL Console直接以该用户身份执行查询快速定位是权限问题还是数据问题。4. SQL 编辑器与执行计划把查询写对还要跑快4.1 SQL 编辑器的实用快捷键与技巧HANA Studio 的 SQL 编辑器支持多语句执行选中一段按 CtrlEnter 只跑选中的部分。格式化快捷键是 CtrlShiftF但默认格式不太符合国人习惯可以在 Preferences → SQL Editor → Formatter 里调缩进和换行。写查询时善用EXPLAIN PLAN看执行计划EXPLAIN PLAN FOR SELECT * FROM MY_SCHEMA.ORDERS WHERE ORDER_DATE 2024-01-01; -- 执行后查看计划表 SELECT * FROM EXPLAIN_PLAN_TABLE;计划表里重点看 OPERATOR_NAME 和 TABLE_NAME如果出现TABLE SCAN且表很大考虑加索引或改查询条件。HANA 的列存表对范围查询友好但LIKE %xxx%这种前后模糊匹配会全表扫能避免就避免。4.2 参数化查询与 SQL 注入防护在 Studio 里写应用 SQL 时不要用字符串拼接。HANA 支持参数化查询在 SQL 编辑器里用?占位SELECT * FROM MY_SCHEMA.USERS WHERE USER_NAME ? AND STATUS ?;执行时 Studio 会弹出参数输入框。应用代码里对应 JDBC 的 PreparedStatement。这样既能防注入又能让 HANA 复用执行计划减少硬解析开销。4.3 执行计划里的三个关键指标看执行计划时我重点关注三个指标CPU Time如果某一步骤 CPU 时间远高于其他说明计算密集考虑改逻辑。Memory Size列存表扫描会占内存如果超过单节点内存限制会报错。Output Row Count如果中间步骤输出行数远大于最终结果说明过滤太晚尽量把 WHERE 条件下推。在 Studio 的 Plan Viz 里可以图形化看这些指标比纯文本直观。右键执行计划 → Visualize Plan 即可。5. 数据导入导出与日常运维别等出事才找后悔药5.1 用 Studio 导入 CSV 的完整步骤导入 CSV 是日常高频操作。在 Studio 里右键表 → Import Data选 CSV 文件然后映射列。注意几个坑文件编码必须是 UTF-8带 BOM 的会报错。日期格式默认是YYYY-MM-DD如果 CSV 里是DD/MM/YYYY要在导入向导里改格式。大文件导入建议用IMPORT FROM CSV FILE语句比图形界面稳定IMPORT FROM CSV FILE /tmp/data.csv INTO MY_SCHEMA.MY_TABLE WITH RECORD DELIMITED BY \n FIELD DELIMITED BY , SKIP FIRST 1 ROW;参数说明SKIP FIRST 1 ROW跳过表头FIELD DELIMITED BY指定分隔符。如果字段里有逗号要用引号包裹并在语句里加OPTIONALLY ENCLOSED BY 。5.2 导出数据的两种方式小数据量用 Studio 右键 Export选 CSV 或 SQL。大数据量用EXPORT TO CSV FILEEXPORT TO CSV FILE /tmp/export.csv FROM MY_SCHEMA.MY_TABLE WITH FIELD DELIMITED BY ,;导出路径必须是 HANA 服务器上有权限的目录不是客户端本地。如果要在客户端拿文件导出后再用 scp 或 Studio 的下载功能。5.3 日常巡检要看哪些视图每天花五分钟看几个关键视图能提前发现大部分问题-- 当前活动会话 SELECT * FROM M_ACTIVE_STATEMENTS; -- 内存使用 SELECT * FROM M_HEAP_MEMORY; -- 长时间运行的语句 SELECT * FROM M_SQL_PLAN_CACHE WHERE DURATION 1000000;M_ACTIVE_STATEMENTS里如果看到某条语句跑了很久可以用ALTER SYSTEM CANCEL SESSION杀掉。内存视图里如果USED_MEMORY接近LIMIT要考虑加内存或优化查询。6. 避坑与排查HANA Studio 操作中最容易翻车的五个场景6.1 连接超时但 hdbsql 正常现象Studio 连不上报 Connection timed out但 hdbsql 能连。原因Studio 默认走 JDBC可能被客户端防火墙或代理拦了。解决检查 Eclipse 的 Network Connections 设置把 Active Provider 改成 Direct。或者在hdbstudio.ini里加-Dhttp.proxyHost清空代理。6.2 导入 CSV 报“invalid number”现象CSV 里数字列导入时报类型转换错误。原因CSV 里数字带了千分位逗号或者有空格。解决导入前用脚本清洗或者在导入语句里把该列定义为 VARCHAR 再后续转换。6.3 执行计划突然变差现象同一条 SQL 昨天跑 1 秒今天跑 30 秒。原因统计信息过期或者数据分布变化导致优化器选错计划。解决执行UPDATE STATISTICS ON MY_SCHEMA.MY_TABLE更新统计信息然后重新看计划。6.4 用户被锁现象登录报“user is locked”。原因多次密码错误触发锁定策略。解决用管理员执行ALTER USER MY_USER ACTIVATE USER解锁。如果忘了密码ALTER USER MY_USER PASSWORD NewPass123重置。6.5 Studio 卡死无响应现象打开大表或执行复杂查询时 Studio 界面卡住。原因Eclipse 的 JVM 内存不够。解决改hdbstudio.ini里的-Xmx参数比如从 1024m 调到 4096m重启 Studio。7. 进阶技巧用 Studio 的 SQLScript 调试器定位逻辑错误SQLScript 是 HANA 的存储过程语言写复杂业务逻辑时难免有 bug。Studio 自带调试器但很多人不知道在哪开。在 SQL 编辑器里存储过程右键 → Debug As → SQLScript Procedure然后设置断点。调试时能看变量值、单步执行、查看调用栈。一个具体技巧在调试器里修改变量值再继续执行不用改代码重新部署。比如某个中间结果不对直接在 Variables 视图里改掉看后续逻辑是否正常。这招在排查边界条件时特别省时间。调试完记得把断点清掉否则生产环境调用会挂起。我一般会在部署前用SELECT * FROM SYS.PROCEDURES WHERE PROCEDURE_NAME MY_PROC确认没有调试标记。另外SQLScript 里尽量用CE_COLUMN_TABLE这类计算引擎函数比直接 SELECT 快。但调试器对计算引擎的支持不如标准 SQL复杂逻辑建议先用标准 SQL 调通再改写成计算引擎版本。最后说个习惯每次改完存储过程先在 Studio 里用CALL MY_PROC(?)跑一遍边界值再部署到生产。这个习惯帮我省过好几次回滚。希望帮到你。本文还有配套的精品资源点击获取