浏览完整参考
搜索和主题导航需要 JavaScript。完整文本如下。
开始使用 SQL Hop
所需条件
- 已批准组织中的已激活 SQL Hop 账户,并拥有符合条件的有效试用或付费订阅。
- 适用于您电脑的 SQL Hop Desktop,以及首次激活所需的互联网连接。
- 客户管理员配置的组织实例,以及您自己的授权 Oracle 凭据。
账户网站与查询应用
普通网页账户不显示 SQL 工作区、已保存查询/历史记录菜单或查询工具。组织管理员仍可在网站上配置实例和成员。网页编辑器保留供将来明确启用;目前并非客户可用的查询方式。
首次成功查询
- 创建并激活账户,然后等待所需的组织或邀请批准。
- 打开下载页面,选择 Windows、Mac Intel 或 Mac Apple Silicon。安装 SQL Hop Desktop。
- 使用您的 SQL Hop 账户在线登录。这会为您的用户/席位注册一台电脑。
- 选择组织的实例,并使用您的 Oracle 凭据连接。
- 运行以下无害 SQL。成功的结果包含 CONNECTION_OK = 1。
SQLSELECT 1 AS CONNECTION_OK
FROM dual
继续工作
浏览编辑、设计器、结果和导出指南。桌面版保存的查询保留在该电脑上;网站不是此本地数据库的同步副本。
网页版、桌面版与访问规则
已获批准且符合条件的组织可获得一次性 30 天试用,从批准时开始,最多支持 10 位用户,包括管理员和待处理邀请。试用查询在 SQL Hop Desktop 中运行。
付费用户也在桌面版中查询。网站提供账户安全、订阅/账单及支持功能。客户管理员在网站上配置组织成员、实例和允许的 AI 访问权限。客户网站隐藏 SQL 编辑、执行、已保存查询/历史记录和 AI 查询工具。超级管理员保留具有特殊权限的网页执行功能。
桌面版将 SQL 直接发送到配置的 Oracle 报表服务。结果、本地查询、设计器状态、历史记录和导出任务保留在电脑上。可选 AI 将经您审核的 SQL 和指令发送到其配置的服务,绝不发送结果行。账户/设备/订阅检查会联系 SQL Hop。
首次激活需要在线登录。已注册桌面版的授权在启动时及保持打开期间每 24 小时检查一次。如果无法访问账户服务器,现有的已签名授权可允许本地工作,期限最多为自上次成功验证起 48 小时,且不得超过已知的试用或订阅结束时间。明确的阻止/过期/撤销响应会停止新的查询和导出。重新启动不会重置期限。
桌面版工作不会自动同步到网页或其他电脑。现有网页草稿和已保存查询会保留,不会因访问方式变更而迁移或删除。在可用的工作区中使用 SQL 文件导入/下载。运营方可在未来部署中明确重新启用网页执行。
创建组织并激活账户
创建账户
- 在公开网站上选择创建账户。
- 输入所需的组织、联系人和账户信息。使用您能控制的邮箱。
- 打开激活邮件,按照链接设置密码。
- 等待平台所有者批准组织。
批准与试用开始
激活仅证明您有权访问该邮箱,并不代表组织获批。在超级管理员批准前,工作区访问仍被阻止。30 天试用从批准时开始,而非注册或邮件激活时。
现有或已停用账户
使用现有凭据或重置密码,不要另建账户。如果账户被禁用,请联系组织管理员。使用相同企业域名或 Oracle 实例的新组织可以独立订阅;系统仍会检查每位用户之前的试用使用情况。
未收到邮件
检查垃圾邮件并核实地址。已过期或已取消的链接需要重新生成。在沙盒邮件推出期间,邮件服务商可能要求验证收件人;请咨询平台所有者,不要反复重试。
一次性试用与资格
试用权益
组织试用从批准起持续 30 天,最多包含 10 个席位。管理员和待处理邀请计入该限额。试用查询在 SQL Hop Desktop 中运行。
每位参与用户均计入
试用使用情况按用户跟踪,而不仅是创始管理员。成为管理员、创建新组织、取消或重新注册均不会获得第二次试用。不能通过邀请已试用过的用户来重复获取免费访问。只有超级管理员可以批准例外。
独立团队
仅共享邮件域名或 Oracle 服务器本身不会阻止不同团队独立订阅。试用身份检查仍适用于各团队的个人用户。
试用到期时
查询访问停止;账户和已保存 SQL 会保留。账户与账单访问仍在网页端提供,以便组织订阅。试用结束后,桌面查询需要有效付费方案。
桌面设备与验证
每位实名用户拥有一台已注册电脑。在 SQL Hop Desktop 中在线激活。验证在启动时及保持打开期间每 24 小时运行一次。如果账户服务器不可用,现有已签名授权允许本地工作,最多持续至上次成功验证后的 48 小时,且不超过已知试用或订阅结束时间。明确的阻止、撤销或过期响应会停止新查询和导出。现有 SQL 和结果会保留。重新启动绝不会延长授权。
更换电脑
在网站上打开账户安全,使用密码和现有验证因素验证身份,然后选择转移到其他电脑。在新电脑上登录。旧电脑只能继续使用到下次验证或现有签名授权的截止时间。
登录、退出与会话替换
登录
使用您的 SQL Hop 邮箱和密码,而非 Oracle 凭据。完成已配置的 MFA 步骤。桌面版提供账户已注册的验证方式:身份验证器代码、恢复代码或安全密钥/通行密钥。安全密钥验证会为已注册的 SQL Hop 主机名打开临时安全窗口。
网页与桌面会话
网页和桌面会话相互独立。仅在网站登录本身不会终止桌面授权。同一客户端类型的新登录可能替换先前会话;密码、验证因素或账户变更可能使访问失效。每位用户/席位允许注册一台电脑。
网页引导导览
符合条件的新账户可在首次网页登录时获得三步导览。回访账户、桌面登录和超级管理员不会自动触发导览。显示导览前系统会先记录账户偏好,因此关闭、完成或刷新都不会使其重复出现。侧边栏中的入门导览可手动重新打开,但不会恢复自动显示。
退出
使用顶部栏中的门与箭头图标。网页退出后返回首页。桌面退出会移除有效 Cookie 和缓存授权,但保留您选择保存的加密应用凭据。使用“通过已保存的应用凭据登录”进行新的在线登录;“忘记已保存的登录”会移除这些凭据。
闲置时间
所有网页账户(包括超级管理员)在闲置十分钟后退出,并须在八小时后重新登录。后台会话检查不会延长这些时限。超级管理员在桌面应用中仍不受闲置退出限制。普通桌面账户在闲置到期前收到 30 秒警告;延长操作会增加五分钟,后续延长亦然。忽略警告会结束会话。明确退出、撤销及账户限制仍然适用。闲置规则独立于 24 小时设备检查,且不会延长离线授权。
激活或重置应用密码
重置密码
- 在网页登录页面选择忘记密码。
- 输入账户邮箱并提交请求。
- 打开最新的重置邮件并使用其中的链接。
- 输入并确认符合表单要求的密码。
- 返回登录页面并使用新密码。
链接错误
重置和激活链接会过期,且只能使用一次。提交新请求后,旧链接可能失效。不要转发链接或将其粘贴到支持消息中。如有需要,请申请新链接。
待批准组织
组织获批前也可以重置密码。这不会绕过批准要求,也不会开始新的试用。成功的重置事件会记录在审计日志中。
两种独立身份
重置应用密码不会重置 Oracle 凭据或移除双因素身份验证。如需这些变更,请联系相应管理员。
身份验证器代码、实体密钥与恢复代码
在网页端打开账户安全
使用导航中的账户安全或顶部账户图标。更改设置前,请按要求验证当前应用密码和现有验证因素。已验证的安全设置窗口仅临时有效。
身份验证器应用
选择设置身份验证器应用,使用所选身份验证器扫描二维码,并输入其当前六位代码。确认设置成功后再依赖该方式。
实体安全密钥
注册实体安全密钥会请求外部 USB/NFC 密钥。在浏览器提示中选择实体密钥,然后完成 PIN 或触碰请求。存储在电脑上的平台通行密钥不同于实体密钥。浏览器支持和设备策略可能影响提示内容。
恢复代码
生成代码,并在应用之外安全保存。每个代码只能使用一次。生成另一组代码会使上一组失效。绝不要将恢复代码发送给支持人员。
桌面版与主机名
桌面版显示账户可用的已注册验证方式。选择安全密钥 / 通行密钥以打开临时 HTTPS 验证窗口;完成浏览器密钥提示,让应用完成登录。WebAuthn 密钥归属于其注册时的主机名。数字形式的局域网 IP 不适合当前实体密钥配置;请使用账户安全页面显示的获准主机名。不要绕过证书警告。
无法访问
授权组织管理员或超级管理员可在核实请求及自身身份后,在允许的账户范围内重置已注册因素。用户必须重新注册;重置验证因素不会更改 Oracle 身份验证。
记住应用与 Oracle 凭据
记住应用账户
在桌面登录时选择记住应用登录并在此电脑上保持登录。账户服务器、用户名、密码和已保存会话使用操作系统保护加密。重启时,记住登录功能会先尝试在线验证,然后可使用已签名设备授权恢复先前注册的账户。如果账户服务器不可用,则仅适用剩余的授权宽限期。否则,请使用“通过已保存的应用凭据登录”,并按要求重新完成 MFA。明确退出会移除缓存授权;这不会创建离线登录。
单独记住 Oracle
在 Oracle 连接表单中,于成功连接前选中在此电脑上记住 Oracle 凭据。下次使用已保存凭据连接。密码字段可能有意保持空白;这不表示加密记录缺失。复选框反映已有保存记录。
移除与隔离
忘记已保存的登录会移除应用凭据。明确退出桌面版会结束会话并移除已保存的会话 Cookie,但保留您选择保存的加密用户名和密码,以供重新登录。闲置到期会结束会话,但不删除加密应用凭据。Oracle 断开连接会清除有效连接;Oracle 忘记已保存凭据会移除其保存记录。如果受保护的操作系统加密不可用,则无法保存。
范围
Oracle 记录按应用账户、账户服务器地址、实例和报表设置隔离。不同应用账户或变更后的实例配置不会复用另一条记录。通过 localhost 或局域网 URL 登录可能选择不同的本地账户范围。
故障排查
使用同一个打包应用和账户服务器 URL。更新后,请自行重新打开重建的应用。如果以前版本移除了保存记录,请重新输入一次并选择记住。操作系统加密存储并不保证控制您已登录电脑的人永远无法访问秘密信息。
打开与更新 SQL Hop Desktop
下载与激活
- 打开网站的下载页面。操作系统检测会推荐 Windows 或 Mac;如果无法检测架构,请在 Mac 上选择 Intel 或 Apple Silicon。
- 查看版本、发行说明、文件大小和 SHA-256 校验和。只提供已发布的安装程序。
- 安装并打开 SQL Hop Desktop。应用会自动连接 https://sqlhop.com。无需输入账户服务器 URL。Oracle 实例由组织管理员单独配置。
- 使用拥有已批准有效试用或付费资格的 SQL Hop 账户登录,并完成支持的 MFA。首次在线激活会将此电脑注册到您的席位。
- 选择管理员配置的 Oracle 实例,并使用您自己的 Oracle 凭据连接。
更新
帮助 → 检查更新…
安装适合平台的已发布版本,并自行重新打开。网站更新不会更新正在运行的桌面二进制程序。请保留应用数据目录,其中存放本地工作和加密凭据。启动画面显示版本;关于 SQL Hop 还显示构建日期。
本地工作与授权
已保存查询、设计器状态、草稿、结果快照、历史记录、导出及下载的元数据均为本地数据。已签名设备授权支持有时限的账户服务器中断,并非无限离线使用。Oracle 本身和 AI 仍需要各自的网络服务。
管理
账户安全、设备转移、组织管理和账单均在网站管理。桌面版没有管理控制台。
HTTPS、本地测试与账户服务器地址
正式桌面登录
SQL Hop Desktop 会自动连接 https://sqlhop.com。登录界面不会要求服务器 URL。Oracle 实例地址是由管理员管理的独立组织设置。
本地网页开发
在服务器电脑上
localhost 和 127.0.0.1 指向该电脑本身。另一台 Windows 或 Mac 设备不能使用这些地址访问您的服务器。
通过家庭网络
使用运营方提供的 HTTPS 地址,包括端口。开发示例为 https://192.168.86.20:8443。地址可能随网络变化。请遵循该设备的证书设置说明;如果尚未配置信任,请询问运营方。
区分故障
- 无法访问网站:检查服务器状态、地址、端口、网络和防火墙。
- 证书警告:信任/主机名设置不完整。不要通过不受信任的连接发送凭据。
- Oracle 远程登录限制:使用配置的 HTTPS 网关,而非 HTTP 开发端口。
- 密钥注册时域名无效:实体密钥/WebAuthn 来源设置要求受支持的主机名;这与普通密码登录不同。
稳定的桌面账户范围
同一本地配置文件应保持使用相同的 HTTPS 账户服务器 URL。切换服务器来源会创建独立账户范围,可能使本地保存工作或 Oracle 凭据看似消失。
连接与断开 Oracle
连接
- 在工作区中选择已配置的实例。
- 选择连接。如果在断开状态下按运行,SQL Hop 会打开表单并记住该执行请求。
- 输入 Oracle 用户名和密码,然后选择连接或验证并连接。
- 等待单行 QueryRunner 检查。请求进行期间输入控件不可用。
- 绿色连接指示器表示连接有效。只有相关标签页、SQL 和选区均未变化时,待处理的运行请求才会在成功连接后继续。
凭据处理
仅对于超级管理员网页执行,Oracle 凭据会临时保存在已登录的后端会话中,最长 30 分钟,不会保存到我们的数据库、文件或浏览器存储中。桌面凭据保留在电脑上,并可选择使用操作系统加密保存。绝不要在 Oracle 表单中输入应用凭据。
断开连接
使用断开/连接状态的插头按钮。断开连接或退出应用会清除有效连接。桌面连接不受账户服务器重启影响。本地 Oracle 连接过期或断开后需要重新连接;超级管理员网页连接在后端重启后需要重新连接。连接状态属于您的会话;其他用户的连接不会为您验证身份。
边界
试用和付费账户在 SQL Hop Desktop 中连接。不会复用现有 Oracle 浏览器 SSO Cookie。Oracle 检查失败不得视为连接成功。
自动设置 SQL Hop Oracle 对象
前提条件
使用具有目录编写、数据模型和报表执行权限的 Oracle 管理员或授权报表开发人员账户。SQL Hop 无法授予 Oracle 权限或修复 Oracle 身份策略。设置前请配置正确的 HTTPS 实例和 Oracle 数据源。
自动设置
- 在网站上打开环境,并选择实例的设置操作。组织管理员也可在桌面 Oracle 连接表单中,为缺失的 SQL Hop 对象选择自动设置。
- 检查显示的数据模型和报表路径。品牌默认路径为 /Custom/SQLHop.com/SQLHop_DM.xdm 和 /Custom/SQLHop.com/SQLHop_Report.xdo。现有旧配置可能仍使用 /Custom/QueryTool/QueryRunner.xdo;不要无意切换路径。
- 确认 Oracle 数据源,通常为 ApplicationDB_FSCM,并为此次操作提供授权 Oracle 用户名和密码。
- 运行设置,等待 SQL Hop 创建缺失对象,并以 CONNECTION_OK = 1 验证报表。仅在 Oracle 目录中看到对象并不等于执行检查成功。
- 验证后关闭成功对话框,并在运行查询前连接实例。设置验证成功本身不会建立有效查询连接。
待完成设置与修复
如果 Oracle 可能仍在处理创建请求,请使用检查设置状态,不要提交重复请求。修复仅更改匹配的 SQL Hop 生成模型,并先备份;不会替换无关的现有模型。如果 SQL Hop 发现输出映射问题,请使用显示的修复操作。
手动备用方案
仅在自动设置不可用或 Oracle 管理员要求时使用手动设置指南。安装完整的当前 SQLHop_DM 定义,包含 xdo_cursor、p_sql_base64、正确输出映射及其匹配报表。将 SQL 粘贴到数据模型的数据集中,而非报表布局或数据库包。源代码 ZIP 并不自动成为 Oracle 目录导入存档。
版本兼容性与权限
旧模型定义可能将结果限制为 200 行、限制注释或拒绝较长 SQL。后台导出还需要报表分块下载权限。报表仅在 Oracle 编辑器中正常运行,并不能证明服务登录能够执行和下载它。设置凭据仅用于该操作;可选加密桌面连接凭据单独管理。
应用与 Oracle 对象
在 SQL Hop 中移除实例仅移除应用配置,不会删除 Oracle 报表或已保存查询。切换到已验证的品牌目录位置时会保留现有对象。在使用其他环境前,先在 DEV 上测试设置。
管理 organization instances
As a client admin, open Environments on the website. Use the instance表 and its add/edit controls. Supply a useful name, HTTPS Oracle origin and report path. An origin is the server address without a page path; a report path begins with /.
Edit and delete
Edit a表 row to change its settings. Delete removes access to that configuration in the app; it does not delete anything in Oracle or erase saved queries. Removed entries can be restored where the screen offers Restore. Reconnect after endpoint or report settings change.
Organization scope
Client admins manage only their own organization’s instances and members. The same Oracle server can be configured by independent teams. Each user still needs their own authorized Oracle credentials. The built-in DEV entry is manageable by the platform owner.
Desktop synchronization
Desktop receives allowed instance profiles at sign-in and successful scheduled validation. Changes may take until the next startup or 24-hour check to reach an already-open app. It cannot edit them locally. Changing a profile can invalidate its active connection and select a different encrypted credential entry.
Oracle SSO 与支持的身份验证
当前支持的流程
试用和付费用户在桌面版中使用现有 Oracle 用户名/密码连接;超级管理员也可使用保留的网页连接器。SQL Hop 应用登录和双因素设置保护应用账户;它们并不实现 Oracle SSO。
浏览器 SSO 相互独立
Oracle 登录按钮可能重定向至 Microsoft,但浏览器会话或身份令牌不会自动授权 BI Publisher 服务。SQL Hop 不会复制浏览器的 Oracle Cookie。
尚未提供的功能
用于查询执行的通用 Oracle SSO 仍暂缓提供。当原生计划服务需要时,执行计划有自己的桌面 Oracle 登录窗口;这不会验证 QueryRunner 连接,也不会复制 Safari Cookie。真实租户 SSO 仍需要实际登录检查。用于 SQL Hop 应用登录的 Microsoft SSO 也未作为当前密码登录的替代方式启用。除非 Oracle 管理员明确支持该流程,否则不要期望 Office 365 凭据可用于 Oracle 直接连接。
直接身份验证失败时
询问 Oracle 管理员,哪些服务身份和身份验证策略可以执行配置的报表。不要通过禁用 MFA 或复用浏览器 Cookie 来绕过问题。
编写 SQL 与整理工作区
布局
SQL 编辑器和结果使用窗口剩余高度。拖动水平分隔线可调整比例。聚焦分隔线后可用方向键调整大小;双击可重置。展开任一面板以获得更多空间,然后还原或按 Escape。
工具栏图标提供运行、运行全部、执行计划、停止、撤销、重做、选区转大写/小写、字号、查找和替换、格式化 SQL、设计器、列、描述、保存、SQL 导入/下载、保存全部、另存为及获准的 AI 功能。悬停或聚焦图标可查看其标签。
现有结果
更改编辑器文本、格式化或应用/撤销 AI 提案时,会保留当前结果,直到另一次执行替换它们。因此可见结果可能属于较早的 SQL。导出在可用时使用已执行 SQL 快照。
响应式导航
窗口较窄时使用导航菜单按钮。打开后可访问账户和工作区页面;通过 Escape、背景遮罩或导航链接关闭。桌面版使用相同工作区外观,并遵循操作系统原生快捷键惯例。
查询标签页与工作区恢复
添加与重命名
使用加号按钮新建标签页。名称在工作区内唯一。双击标签页名称或使用重命名标签页来更改。已保存查询显示的查询编号按用户从 1 开始;内部数据库 ID 与其不同。
最多 100 个标签页
工作区支持最多 100 个已打开标签页,包括保存全部和恢复的工作区。需要时滚动标签栏;加号控件始终可用。关闭不再需要的标签页。存在未保存 SQL 或设计器变更时会显示放弃确认。
恢复
网页草稿保存到已登录账户;桌面草稿保存到其按账户隔离的本地工作区。重新打开时可恢复标签页 SQL 和设计器数据。临时结果快照和参数值并非永久工作区备份。使用保存来保留命名查询,并导出需要保留的结果。
独立结果
各标签页保留自己的查询/结果状态。运行全部会在当前查询标签页内部添加结果集标签页。不要将其与顶层查询标签页混淆。
保存、另存为与保存全部
保存
保存图标与 Ctrl+S / Cmd+S 执行相同操作。如果标签页链接到已保存查询,保存会直接更新它。对于新查询,会打开预填标签页名称的对话框。保存会记录 SQL 占位符和设计器状态;不会保存参数值。
另存为
使用另存为或 Ctrl+Shift+S / Cmd+Shift+S 创建另一个命名查询。当前标签页链接到新副本。原查询保持不变,其设计器状态相互独立。
保存全部
保存全部会按名称保存所有非空标签页,更新已链接查询,并在需要时创建新查询。即使尚未生成新 SQL,也包含仅在设计器中的变更。Windows/Linux 使用 Ctrl+Alt+S,Mac 使用 Cmd+Option+S。
重新打开
从已保存查询中打开查询。其设计器可恢复供编辑。如果链接的已保存查询已被移除或不可用,请保留编辑器 SQL 并保存新副本,不要放弃工作。桌面保存内容保留在本地;网页保存内容属于网页账户。
已保存查询的文件夹
- 打开“已保存的查询”即可创建文件夹或重命名文件夹。点击文件夹标题可展开或折叠文件夹。搜索会检查所有文件夹中的查询编号、名称和 SQL,包括已折叠的文件夹。
- 使用查询旁的“移动到”选择一个文件夹或“未分类”。现有查询和首次保存的查询最初都位于“未分类”中;更新已保存的查询不会改变它所在的文件夹。文件夹仅供您本人使用。桌面应用中的文件夹和已保存的 SQL 保留在您的计算机上,与在网页端保存的查询相互独立。
- 删除文件夹会将其中的查询移至“未分类”,并保留它们的 SQL 和查询编号。
打开与下载 SQL 文件
导入
使用打开 SQL 文件并选择 .sql 文件。文件内容会在编辑器标签页中打开,不会执行。运行前请检查文本及任何本地语法消息。可能需要浏览器文件选择器或操作系统权限。
下载
使用下载 SQL 文件,将编辑器内容保存为 .sql。导出的是 SQL,不是结果行或已保存参数值。文本文件不包含完整可编辑的可视化设计器状态。
从源工作区下载 SQL,然后在目标工作区打开。网页保存查询和桌面本地保存查询相互独立。导入文件不会授予 Oracle 访问权或为您登录。
选择器未打开时
检查是否已有其他文件选择器或模态框打开。在桌面版中,使用重建的打包应用及其原生打开文件操作。不要将凭据粘贴到 SQL 文件中来绕过连接问题。
格式化、大小写、字号与撤销
使用运行时自动格式化旁的格式化 SQL。手动格式化仅更改编辑器文本;启用自动格式化会在运行过程中应用格式化。子句对齐遵循 SQL Hop 风格。ORDER BY 是对齐例外。
选择文本以启用大写和小写工具。使用 Ctrl/Cmd+Shift+U 或 Ctrl/Cmd+Shift+L。大小写转换影响所选文本,包括选中的字面量;运行前请检查。
使用 A− 和 A+ 调整编辑器文字大小。SQL 编辑器使用等宽字体,使列和缩进对齐。浏览器缩放也会影响整个界面。
撤销可还原编辑器变更,包括全部替换和已应用的 AI SQL。重做可重新应用。它们不会执行 SQL 或清除现有结果集。标准操作系统快捷键列在键盘快捷键中。
打开格式化 SQL 旁的滑块图标,可自定义关键字、表/视图、别名、函数和数据类型的大小写;子句对齐;缩进大小或制表符;表达式换行;AND/OR 换行;语句间距;运算符间距及分号位置。保存前预览变更。偏好按此设备上的账户记住,适用于手动格式化及运行时自动格式化。保存偏好不会更改或执行编辑器 SQL。恢复默认值将预览重置为 SQL Hop 风格;选择保存偏好以保留重置。默认使用大写 SQL 关键字和函数名,以及小写不带引号的表/视图名称和别名。带引号标识符、列名、字面量和参数名保留大小写。格式化后使用撤销可还原原始 SQL。
查找和替换 SQL
打开合并面板
使用单一查找和替换图标。Ctrl+F / Cmd+F 打开查找;Ctrl+H 或 Cmd+Option+F 打开替换。输入要查找的文本,并在需要时输入替换内容。
浏览匹配
使用下一处和上一处控件、支持情况下的 F3/Shift+F3,或 Ctrl/Cmd+G 及其 Shift 组合。在搜索字段中,Enter 和 Shift+Enter 可在匹配间移动。替换前检查可用匹配选项。
替换
搜索面板字段聚焦时,Ctrl/Cmd+Enter 替换下一处匹配。Windows/Linux 上 Ctrl+Alt+Enter 或 Mac 上 Cmd+Option+Enter 替换全部。这些快捷键不会从搜索面板运行 SQL。撤销可恢复全部替换变更。
关闭
按 Escape 关闭面板,并将焦点返回编辑器。现有查询结果保持可见。
实时 SQL 检查与自动补全
本地语法反馈
编辑器在输入时检查 Oracle 风格 SQL,包括连接、子查询和 CTE。修正 SQL 后,下一次检查会清除诊断。本地检查不会执行查询、联系 Oracle 或清除结果。
Oracle 仍是最终依据
本地语法检查仅供参考,不会阻止运行。有效的特定版本 Oracle 语法可能超出本地语法范围。对象是否存在、权限、类型规则、绑定语义和执行计划仍需 Oracle 验证。本地绿色状态不保证执行成功。
建议
使用 Ctrl+Space 请求建议。表建议使用可用元数据。在 FROM/JOIN 中声明表别名后,输入 alias. 可请求该表的列,包括在 SELECT 列表中。不会自动将所有列插入或加载到 SQL 中。
缺少建议
检查表名拼写、别名声明和选定的元数据发布版本。桌面版需要下载并启用可选自动补全包。描述和列依赖导入的元数据,并不承诺实时架构内省。
运行查询、获取行与停止等待
运行
编辑器有选区时,运行会执行选中的 SQL;否则执行编辑器中的单条语句。快捷键为 Ctrl+Enter / Cmd+Enter。多条语句会提示使用运行全部,而非将整个脚本作为单个查询发送。
获取行数
获取行数是本次执行收集的最大行数,目前交互使用提供最多 10,000 行。它不同于每页行数,后者仅更改一次显示多少已获取的行。系统会记住上次获取设置。
运行期间
加载指示器和计时会持续经过 Oracle 执行、获取和首次显示阶段。数据显示后计时停止。参数输入时间不计入。Oracle 查询在 SQL Hop Desktop 本地运行。
停止
使用运行旁的停止,在应用中取消等待。排队请求可在联系 Oracle 前移除。已提交的请求可能仍在 Oracle 数据库中执行;停止不保证终止数据库执行。
失败时
阅读错误详情。SQL 保留在编辑器中。失败的执行不会将旧结果行显示得像新结果一样。
生成 Oracle 执行计划
生成计划
- 连接目标 Oracle 环境。
- 选择一个 SELECT 或 WITH 查询,或让编辑器仅包含单条语句。
- 在 SQL 工具栏选择执行计划。
- 输入请求的类型化参数值。
- 如果出现 Oracle 登录窗口,请使用目标 Oracle 账户登录。登录后计划会自动打开。
无需复制粘贴或导入下载文件。执行计划不会运行所选查询来获取结果行。现有结果和编辑器 SQL 仍然可用。
阅读计划
展开或折叠操作,查看树、估算行数、成本、对象、谓词和 Oracle 注释。成本是优化器估计值,不是经过的秒数;父节点成本已包含子节点工作。这些是估算计划,并非实测执行统计。
比较与下载
选择用作比较基准,在同一查看器中比较另一计划。比较相同 SQL 和参数值;仅估算成本更低并不能证明查询更快。下载计划会保存原始 Oracle 计划文本。
Oracle 访问与登录
SQL Hop 使用 Oracle 原生 Generate Explain Plan 服务及配置报表的数据源。不会创建独立执行计划报表。桌面登录会话与 Safari 独立,并在 Oracle 断开、重新连接、退出账户或连接过期时清除。出现提示时请再次完成登录。此登录流程用于执行计划;普通查询执行仍使用现有 Oracle 连接。
可用性与故障排查
不接受多条语句和 PL/SQL 块。原生服务和身份验证策略取决于 Oracle 实例。已验证登录后的原生请求和无害 SELECT 1 FROM DUAL 计划;租户的真实桌面 SSO 流程仍需实际登录检查。如果取消登录,请重试执行计划。对于访问或 SQL 错误,请在 BI Publisher 检查相同 SQL 和数据源,并向管理员提供脱敏错误代码。不要禁用 Oracle 安全检查。网页执行仍限于获准账户;网页原生计划还要求 Oracle 接受现有连接凭据。
与 AI 解释不同
AI 解释使用配置的 AI 服务描述 SQL。执行计划获取 Oracle 优化器计划,不使用 AI。
运行全部与独立结果集
准备编辑器
用分号分隔只读查询。使用运行全部或 Ctrl/Cmd+Shift+Enter。SQL Hop 顺序运行语句,而非作为单个 Oracle 脚本。
参数
每条带参数语句都会请求其值。值仅用于本次执行。取消参数对话框可避免运行该待处理请求。继续前请检查混合的词法参数。
结果
切换结果集标签页以查看各语句输出。每个结果集保留自己的筛选、排序和所选行。其导出使用该结果集的控件和已执行 SQL 快照。
错误与取消
运行全部在错误后停止;其余语句不再运行。停止会取消应用请求,但受 Oracle 执行限制约束。批次的耗时显示代表整体执行,并不能证明语句并行运行。
命名 :NAME 参数
编写占位符
SQLSELECT :P_NAME AS NAME
FROM dual
在普通值位置使用 :NAME 占位符,例如 WHERE item_number = :X。运行会打开对话框,提供文本、数字、日期或 NULL 类型。将撇号作为普通文本输入,例如 O'Brien;不要自行添加外围 SQL 引号。
运行或取消
Enter 仅提交对话框一次。取消、Escape 或点击外部会关闭对话框,不运行查询或添加查询历史记录。最后确认的值和类型会预填同一查询标签页与 Oracle 环境的后续运行,包括查询失败之后。运行全部的各语句保留独立条目。取消不会替换最后确认的值。关闭标签页、退出、刷新页面或关闭应用会清除保留值。
会话内存与隐私
保留值仅存在于应用内存中。不会包含在恢复标签页、数据库记录、浏览器存储或已保存查询文件中。不同标签页或环境分别开始。
已保存查询、SQL 文件下载及 Excel 结果导出中可选的 SQL 工作表均保留占位符。参数值不保存在查询历史或应用日志中;失败的参数化历史使用脱敏错误。值仍可能影响或出现在您主动导出的结果行中。
实现限制
当前 :NAME 支持会在报表请求前进行类型化、转义替换。它不是 Oracle 原生 DBMS_SQL 绑定。原生 Oracle 绑定暂缓提供。值请保留使用占位符;词法参数仅用于有意提供的 SQL 片段。
词法 &NAME 与 &&NAME 参数
词法与值的区别
:NAME 参数表示类型化值。词法 &NAME 或 &&NAME 插入 SQL 片段,例如列列表或条件。SQL 片段不会自动作为值加引号。
SQLSELECT &COLUMNS
FROM egp_system_items_b esib
WHERE esib.item_number = :ITEM_NUMBER
执行前审核
运行会请求词法片段和其他值。选择审核 SQL,检查展开的 SQL,然后运行已审核版本。如果片段引入更多 :NAME 占位符,请填写额外字段并再次审核。更改值会使先前审核失效。
仅限会话内复用
两种词法形式均可预填此标签页和环境最后确认的片段,但每次运行均需审核 SQL。两种形式都不会永久保存值。关闭标签页、退出或关闭应用会清除保留片段。取消或 Escape 不会执行查询。
有意使用
词法片段可改变查询结构。不要将不受信任的片段视为无害标量值。原始编辑器占位符保持不变,值不会随已保存 SQL 存储。
Privileged web query queue and concurrency
Who uses the server queue
Customer trial and paid queries execute locally in Desktop and do not enter the web query queue. Super-admin web execution remains available. The retained queue also applies if the operator explicitly enables eligible customer web querying in a future deployment.
Default limits
While waiting
Queued status shows the position before Oracle dispatch. Cancelling removes a queued operation. Authentication, entitlement, seat limits and maintenance are checked again when a slot opens.
Scope and capacity
This queue is process-local, not a distributed scheduler or a capacity promise. A full queue or timeout is a reason to reduce duplicate submissions. Oracle may continue work already submitted after application cancellation.
可视化构建查询
打开设计器
从编辑器工具栏选择查询设计器。搜索可用元数据以添加表。分配不同别名,使列引用和连接清晰。
选择列
选择所需输出列及别名。元数据必须包含表和列,选择器才能显示它们。选择表不会授予数据库访问权限。
添加连接
选择参与的表别名、连接类型和匹配列。检查条件是否代表预期关系;设计器无法推断业务含义,也不保证连接能避免重复行。
生成与审核
准备就绪后将 SQL 生成到编辑器。审核完整语句并明确运行。筛选、排序和聚合有各自的设计器指南。生成不会自动执行 Oracle SQL。
手写 SQL
设计器为查询保留已保存的设计模型。不要假设任意编辑器变更都会反向解析为该模型。替换手动编辑的 SQL 前,请审核生成的 SQL。
设计器 WHERE 条件与 ORDER BY
WHERE 条件
使用选定表别名和列添加条件。选择可用比较方式,并提供预期值或参数。检查 NULL 处理,以及文本与数值的区别。使用提供的控件组合条件;在生成 SQL 中检查最终分组。
ORDER BY
将列添加到排序列表,选择升序或降序。排序字段的顺序决定优先级。稳定的 SQL ORDER BY 不同于对已收集结果表格排序。
审核
生成 SQL,在编辑器中验证 WHERE 和 ORDER BY 子句。对于变化的值请使用 :NAME 参数,而非每次编辑字面量。Oracle 在执行时验证对象名、类型和权限。
结果筛选相互独立
结果列筛选仅缩小已收集快照的显示范围。它不会添加 WHERE 子句或重新运行 Oracle。使用设计器条件减少实际查询输出。
GROUP BY、HAVING 与聚合函数
选择聚合
在设计器中为输出列选择聚合,例如 COUNT、SUM 或 AVG。算术聚合请使用合适的数值列。COUNT(*) 计算行数;COUNT(column) 排除 NULL 值。
分组
为非聚合输出字段添加分组列。明细列与聚合混用时通常需要 GROUP BY。请检查生成的 SQL,不要假设只选择函数就会得到预期汇总。
HAVING
使用 HAVING 筛选分组/聚合结果。WHERE 在分组前筛选源行。使用设计器可用控件选择聚合表达式和比较方式。
审核结果
检查生成语句中的别名、GROUP BY、HAVING 和 ORDER BY。Oracle 可能拒绝无效组合或不兼容数据类型。设计器不会根据源报表验证业务合计。
保存与恢复可编辑设计
记住的内容
查询的设计器状态包括所选表、别名、列、连接、条件、排序、分组和聚合设置。在该查询上重新打开设计器可继续工作,无需重新开始。
不生成 SQL 也可保存
即使尚未生成新的编辑器 SQL,也可保存仅在设计器中的变更。保存和保存全部会随该查询持久保存设计。保存全部分别处理每个查询。
另存为
另存为创建独立可编辑设计副本。编辑副本不得更改原始设计。从已保存查询重新打开原查询,可检查其自己的模型。
退出与转移
登录后,已保存网页设计会恢复到同一授权账户。桌面设计属于本地账户工作区。.sql 文件包含 SQL 文本,而非完整可视化设计。不要将 SQL 文件转移视为完整设计备份。
从表与别名中选择列
在 SQL 中声明表及别名,打开列,选择识别出的表/别名,然后选择所需列。确认插入,并检查编辑后的 SELECT 列表。复选框用于选择字段,不会执行查询。
别名建议
声明别名后,在编辑器中输入 alias. 可请求该表的列,包括在 SELECT 中。Ctrl+Space 可重新打开建议。多个表和连接应使用不同别名。
缺少表时
检查拼写和 FROM/JOIN 语法,然后确认该表存在于已发布元数据中。复杂 SQL 作用域无法解析别名时,可能需要手动编辑。元数据是共享描述目录,并非实时 Oracle 权限检查。
缺少列时
请平台所有者验证列批次已导入并发布。在桌面版中,下载并启用自动补全数据。发布或下载后刷新目录,而非自动插入所有列。
查看列类型、大小与注释
描述表
从工具栏使用描述表并指定表。如果上传数据包含相关字段,可查看列名、类型、长度或精度/小数位数、是否可空及注释。
详情来源
描述使用导入的元数据。它不保证当前 Oracle 实例具有完全相同的架构。已发布目录可能比实例旧。
注释为空可能表示 Oracle 未提供注释,或提取未包含注释字段。导入器无法编造业务描述。请平台所有者检查原始工作簿及其识别出的列标题。
大小为空或缺少列
确认相关列文件包含这些字段并已发布。使用桌面版时请下载当前桌面元数据包。表的查询权限与目录描述的可用性是两项独立检查。
共享元数据与发布
平台所有者集中上传 Oracle 对象/表和列描述。发布的数据可供跨组织用户使用。这不是业务结果行上传,也不授予 Oracle 查询权限。
表/对象文件和列文件可分别上传。工作表识别使用已知列标题,而不要求特定工作表名称。大型字母分批数据会合并,而非替换所有先前列数据。
导入数据在发布前暂存。用户使用已发布目录,而非未完成的暂存内容。发布后,请根据情况刷新或下载更新目录。
只有提取中包含的表和列才会出现在元数据工具中。注释和大小是可选源数据。没有自动 Oracle 表更新或元数据计划功能来保持此目录最新。
公开 Oracle 文档可丰富匹配的表/列描述及功能领域。页面不可用与缺少注释是不同情况;缺失文档仍为空白。桌面包必须单独重建/发布,然后重新下载。不要假设旧本地快照已收到新注释。
在桌面版下载自动补全数据
下载
- 使用已批准的有效试用或付费权限登录桌面版。
- 打开导航中的自动补全数据。
- 下载可用元数据包并启用。
- 等待验证和安装完成,然后返回编辑器。
启用的功能
本地目录支持表建议、别名列建议、列、描述以及设计器表/列选择器。缺少元数据时,SQL 执行仍可使用手写名称。
存储与更新
元数据包下载到本地应用数据目录,不会打包进每个安装程序。平台所有者更新后,请下载较新的已发布包。可通过页面控件禁用该包。独立导入操作接受兼容元数据包,而非任意 XLSX 业务数据。
故障排查
下载需要有效账户权益、网络访问、可用磁盘空间和有效包。不要为刷新自动补全而删除本地工作区数据库。元数据包不包含凭据或查询结果。
下载交付
账户服务器检查权限,并提供短期有效的私有 Cloudflare R2 下载链接。元数据字节直接从存储下载,安装前进行校验和验证。这是已发布快照:文档补充或服务器更新不会静默刷新现有桌面下载。
阅读结果与查看记录
表格控件
滚动表格时列标题保持可见。拖动标题分隔线调整单列宽度,双击分隔线适应内容,或使用自动调整列宽适配整组。工作区支持时会按查询记住宽度。
展开记录
选择行号旁的查看记录,打开左侧列名、右侧值的记录视图。这对宽表很有用。它是所选结果行的视图,不是数据库编辑表单。
右键点击结果表格,或在表格聚焦时按 Shift+F10,查看可用结果操作。仅使用针对当前单元格、行或选区提供的操作。
完整面板
展开结果以获得更多空间,按 Escape 或恢复结果大小返回。筛选、排序和选择仍附属于结果集。更改编辑器 SQL 不会静默替换表格。
每页行数与总行数
选择每页行数,一次显示 10、25、50、100 或 200 行。系统按用户/工作区记住上次设置。按可用情况使用首页、上一页、下一页和末页控件。
总数与匹配数
总数描述已收集结果快照中的行数,不一定是 Oracle 源表的全部行。筛选可减少匹配数。获取上限可能意味着源行多于已收集行。
每页行数仅更改可见页面。获取行数控制新执行收集的最大数量。页面大小设为 25,并不意味着全部结果导出只应包含 25 行。
排序、筛选和选择作用于整个已收集快照。延迟加载快照按需请求页面,而非一次将每行放入浏览器。
按列筛选结果
列筛选
选择列标题中的漏斗图标,设置支持的筛选条件。应用后会缩小整个已收集结果集中的匹配行,而非仅当前可见页。使用清除列筛选移除筛选。
文本搜索
使用结果搜索字段进行更广泛的文本筛选。搜索与列条件可共同使用。匹配数为零并不能证明 Oracle 在已获取快照之外没有此类行。
选择
应用或清除筛选后,已选行仍保持选择。被新筛选隐藏的行仍可能在选区中。如果不应导出这些行,请明确清除选择。
查询与结果筛选
结果筛选作用于已获取数据。要更改 Oracle 返回的内容或减少昂贵提取,请在 SQL 或设计器中添加 WHERE 条件并重新运行。
跨页面与导出排序
应用排序
选择标题中的升序或降序图标。当前排序会高亮显示。支持时再次点击当前排序可清除。排序作用于整个结果快照,包括筛选行,而非仅当前页。
稳定选择
在升序和降序间切换不会改变所选的底层行。行的显示位置可能变化;其选择应保持附属于该行。
导出
CSV 和 Excel 导出遵循当前结果排序。筛选导出使用筛选后的顺序;所选行导出按跨页面的当前结果顺序保留所选行。
SQL ORDER BY
表格排序不会重新运行 Oracle 或更改编辑器 SQL。如果要求 Oracle 在收集前生成指定顺序,请使用 SQL ORDER BY。运行全部的各结果集分别保留排序。
跨页面与筛选选择行
单行与页面选择
使用行复选框选择该行。标题复选框选择可见页上的行。切换页面不会丢失这些已选行。
选择所有匹配行
使用选择所有匹配行,选择已收集结果所有页面中满足当前筛选的行。它不会选择快照之外的源表行,也不代表所有未筛选行。
筛选与排序
更改筛选、清除筛选或切换排序方向会保留所选行。已选行可能被筛选隐藏。因此所选计数可能大于可见匹配行数。
导出
在导出对话框选择所选行选项,包含所有页面的选择,包括当前被筛选隐藏的已选行。使用清除选择主动重置。运行全部的每个结果标签页都有自己的选择。
导出 CSV 或 Excel 结果
导出数据
- 为当前结果集打开导出数据。
- 选择 CSV 或 Excel,并检查导出的是所有适用的已获取行、筛选行还是所选行。
- 检查包括扩展名的文件名,然后下载或选择原生保存位置。
范围与顺序
导出不限于可见页。它遵循结果排序和选定导出范围。所选行导出包含其他页面的选择。表格筛选可以隐藏已选行,而不会取消选择。
文件名
默认名称使用查询标签页名称,后接日期和时间戳,并带正确的 .csv 或 .xlsx 扩展名。无效文件名字符会被规范化。
CSV 分隔符
选择对话框提供的分隔符,例如逗号、分号或制表符。包含分隔符、引号或换行的文本会适当加引号。O'Brien 等撇号保留为普通数据。请使电子表格导入设置与所选分隔符匹配。
带 SQL 的 Excel
选择将 SQL 作为第二工作表包含的选项。在可用时使用已执行 SQL 快照,并保留参数占位符;参数值不保存到 SQL 工作表。如果查询返回了这些值,结果行仍可能包含它们。
大型结果与延迟加载
交互快照
选择较大的获取行数,最大为提供的交互选项,然后运行。大型结果使用临时快照及页面请求,而非在表格中渲染每一行。筛选、排序、选择和导出作用于已收集快照。
获取仍需资源
延迟显示不意味着无限 Oracle 查询没有成本。Oracle 报表执行、传输、磁盘/内存限制和网络时间仍然重要。很宽的 SELECT * 可能远大于相同行数的窄行。
结果过大时
选择更少列、使用更严格的 WHERE 子句、降低获取行数或使用桌面后台导出。请阅读实际大小/单元格限制错误,不要假设部分行就是完整结果。
临时就是临时
快照按会话隔离,可能在退出、清理或重启后过期或消失。如果快照不可用,请重新运行查询。下载需要保留的结果。延迟加载并非永远保持打开的数据库游标。
桌面后台导出
创建任务
- 在桌面版连接 Oracle。
- 使用查询工具栏中的后台导出。
- 选择 CSV 或 XLSX、最大行数及可用导出选项;检查所有参数。
- 打开后台导出监控本地任务,按需取消或下载已完成文件。
工作原理
支持的连接器执行一次 BI Publisher 报表,并分块下载输出。无需唯一排序列或排序确认复选框。当前任务最多 100,000 行,受报表/输出限制约束;完成任务达到上限可能表示还存在更多源行。
文件位置
任务和临时下载位于笔记本电脑,而非账户服务器。完成的临时文件在完成后 24 小时过期;任务中显示到期时间。请下载/保存副本以长期保留。保存到自己文件夹的文件独立于会过期的临时任务。
保持桌面版运行
任务在本地运行,并非持久服务器调度器。关闭应用、退出、断开 Oracle、休眠/断网或许可过期可能中断任务。不要期望电脑关闭后仍能完成。
问题
如果只收到 200 行,请检查实际导出上限及当前 QueryRunner 上限。如果分块下载被拒绝,请验证服务和报表权限。大型交互结果与后台导出是不同流程。
AI 权限与个人密钥
三种访问模式
谁来决定
客户管理员仅可为自己组织中的用户授予模式。超级管理员控制共享服务配置和平台设置。用户不能更改他人的访问权限,也不能通过输入自己的密钥绕过禁止模式。
变更生效
共享 AI 请求由后端授权。桌面权限在启动及每日成功验证时刷新;个人密钥限制可能到该检查时才收到。账户服务器中断期间,现有签名权限可持续到固定截止时间。已存个人密钥不能覆盖新验证的禁止模式。权限在退出/登录后仍保留。
个人设置
获准时,在桌面版打开我的 OpenAI 密钥,使用可用密钥/模型控件。密钥是秘密信息,不会完整回显。请检查状态,不要期望空白秘密字段显示现有值。
起草、解释与修复 SQL
打开助手
管理员授予访问后,选择 AI 图标。选择起草以描述查询、解释以理解 SQL,或修复以请求更正。审核将提交的编辑器 SQL 和指令。
数据边界
AI 请求不包含查询结果行。SQL 本身可能包含名称、字面量或敏感条件;请移除不想发送的内容。虽然 Oracle 执行在本地,桌面 AI 仍是网络服务。
运行前审核
AI 输出是提案,不是已验证的 Oracle SQL。检查表名、列名、连接、筛选及 Oracle 版本语法。满意后才应用,然后明确执行。应用不会自动运行建议的 SQL。
错误
AI 可用性取决于权限、配置的密钥/模型、提供商可用性及限制。提供商错误不是 Oracle 错误。AI 成功响应也不证明业务结果正确。
细化、审核、应用或放弃 AI 变更
提议与细化
描述所需变更。审核提案及其与原始 SQL 的比较。请求细化以产生更新提案;新版本仍需在应用前审核。
应用
应用仅更改编辑器。不会执行 SQL、清除当前结果表格、移除结果筛选或改变所选行。这些结果可能仍属于先前执行的 SQL,直到再次运行。
撤销与重做
应用细化提案后,撤销会恢复先前 SQL。重做会恢复提案。两者均不执行查询或清除现有结果。
放弃
未应用时取消、关闭、Escape 或点击遮罩关闭,均使编辑器 SQL、结果、筛选和选择保持不变。不要将关闭提案视为接受。
方案、席位与订阅日期
打开订阅
试用和付费用户均可访问网页订阅页面。页面显示状态、席位使用、相关试用结束时间及当前付费周期日期。只有组织管理员可发起结账或管理账单。单席位组织的账户持有人可担任管理员;管理员使用该席位。
当前公开方案
单用户促销价格为每月 USD 14.99 或每年 USD 149.90(免费两个月),另加配置适用税费。当前网站和 Stripe 确认信息为准。团队总价在订阅页面按实名用户数私下计算。网站不公开阶梯批量费率。持续订阅期间保留促销条款;取消后终止保留旧价。也可私下安排定制报价。
有效订阅
已有有效订阅时,新结账按钮不可用。使用管理账单 / 发票更新现有方案、付款方式或取消。在桌面版中,客户管理员可使用在网页管理账单 / 发票;管理仍在网站进行。
日期与提醒
自动续订方案显示付费周期结束/下次续订日期,并非声明账户届时到期。计划取消显示订阅到期。桌面提醒在月度到期/续订前三天、年度到期/续订前十五天开始。
测试模式
Stripe 测试模式不是真实支付。仅从 Checkout 返回并不能确认访问;服务器使用签名支付事件及订阅状态。
升级、降级或切换月付与年付
打开现有订阅
使用管理账单 / 发票,不要创建第二个订阅。选择提供的方案或周期,并审核 Stripe 确认信息。
升级
升级按比例计算并立即收费。检查未用预付时间抵扣额、新费用、税费和应付金额。如果升级付款失败,现有方案和席位限制保持不变;账户和已保存查询会保留。
降级
降级在续订时生效。当前方案在此之前仍可用。切换到更短计费周期会安排在续订时生效。请检查生效日期及 SQL Hop 中显示的计划变更。
月付/年付切换
确认前阅读预览:未用抵扣额、税费和应付金额取决于周期、生效时间及现有发票状态。在确认页面打开查看详情,查看明细。贷方余额抵扣未来发票,并不自动退还现金。
席位与保留旧价
较低席位限制生效前,请减少超额成员或待处理邀请。已停售方案可继续供现有订阅者使用,但切换后可能无法再使用该旧价格。
取消或续订订阅
取消
在网页打开订阅并选择管理账单 / 发票。使用 Stripe 提供的取消选项,检查生效日期并在那里确认。返回 SQL Hop 刷新账单状态。
周期结束时
计划取消后,付费周期结束日期显示为订阅到期日。权益不再有效时,付费查询访问结束。账户和已保存查询会保留;取消不会删除组织或授予再次试用。
改变主意
使用管理账单,检查能否撤回计划取消或续订。付款确认及签名订阅状态必须恢复权益;仅从页面返回并不足够。
退款
取消不承诺自动现金退款。请审核确认信息及公布条款。方案变更的抵扣额通常减少未来发票。如有账单问题请联系支持,但不要发送银行卡详情。
付款失败、到期与账单冻结
付款失败或订阅过期
对于逾期、未付款、未完成、暂停、取消或过期权益,查询可能被拒绝。账户和已保存查询仍保留。当验证明确返回限制或现有授权到期时,桌面版拒绝新查询和导出;缓存结果保留。组织管理员仍可使用网页账单检查付款和续订。
升级失败
立即升级失败不应替换现有付费方案或席位限制。重试前检查门户付款状态,避免创建第二个订阅。
通知
付款失败邮件以 SQL Hop 账户邮件格式发送给组织管理员,包含管理账单操作及重复保护。邮件交付不能替代检查订阅状态。
争议
拒付可能触发账单冻结和黑名单策略。整个域名的操作排除公共邮箱提供商,并需超级管理员批准。赢得争议不会自动移除永久邮箱黑名单;请联系平台所有者复核。
安全
绝不要向支持发送密码、完整卡号、重置链接或 API 密钥。请提供脱敏错误、大致时间和订阅状态。
席位限制与成员计数
计入哪些内容
席位限制包含组织管理员和待处理邀请,并非仅执行过 SQL 的用户。因此单用户方案可包含一个管理员账户,不另提供免费管理员席位。
添加或重新激活用户
邀请或启用账户前,检查当前已用/允许数量。创建、邀请和重新激活均不得绕过席位限制。试用组织包含十位用户;付费/定制方案使用配置的席位数。
降级
如果计划更小的方案,请在新限制生效前减少有效成员并取消不需要的邀请。超出权益可能暂停查询;不会删除账户或已保存 SQL。
独立组织
独立团队可在相同企业域名或 Oracle 实例下订阅。用户仍需自己的授权账户及试用资格。席位共享并不允许多人共用一个登录。
Who can manage what
Regular user
Uses the permitted workspace and configured instances, personal account security and permitted AI. Trial and paid querying use SQL Hop Desktop; web querying is reserved for future enablement. Organization billing information remains accessible, but a regular user cannot start or change billing.
客户管理员
Manages members, invitations, their organization’s instance configurations and assigned AI access. Can manage the organization subscription. A client admin cannot manage another organization or open platform-only Revenue & Stripe, shared AI configuration or email-domain protection.
超级管理员
The platform owner manages organization approval, trial exceptions, platform settings, shared metadata, billing plans, revenue reports, disputes, maintenance, backups and domain controls. Super-admin web/desktop query exceptions are not representative of ordinary customer access.
桌面版
Administration is excluded. A client admin’s billing identity is preserved separately so they can open web billing without enabling the desktop admin console.
Invite, confirm, approve and manage members
Create an invitation
Open Members & access. Enter the person’s full name and email, then choose User (the default) or Organization admin. Organization admins can manage users, Oracle connections, billing and organization settings. Review the selected role and full recipient address in the confirmation before sending. Super-admin access cannot be assigned here. The name is used in account emails rather than greeting users by their email address.
Activation then approval
The invitee opens the activation link and sets their app password, proving inbox access. For either invited role, an existing organization admin then approves the activated account before it can use the workspace. Email confirmation is not automatic workspace approval.
Resend or cancel
Use the row actions to resend an invitation or cancel it. A cancelled or superseded activation link should no longer be used. Pending invitations consume seats, so cancel unneeded ones before adding others.
Edit and disable
Edit a member’s name or email using the offered row control. Changing the login email invalidates sessions and links and can require fresh confirmation. Disable an account to remove access without deleting saved queries. Only manage members within your own organization.
Reset a member’s authenticator or security keys
Before resetting
Verify the member’s identity through your established process. An email claiming a lost key is not itself proof of ownership. Never ask them to send you a password or recovery code.
Use member security controls
Open Members & access, choose the member’s security action and review the factor-removal confirmation. Remove the authenticator configuration or registered security keys as needed. The user must enroll new factors afterward.
Effects
Removing the final factor can disable two-step sign-in and invalidate recovery codes. Factor changes can invalidate other app sessions. This does not reset Oracle authentication or delete the account’s SQL.
Scope
Client admins can act only on authorized members in their organization. Super-admin and other protected admin changes require the appropriate platform-owner flow. If no removal control appears, confirm your role and which member you selected.
Configure shared AI and user permissions
Shared OpenAI configuration
Super admin opens AI settings, configures the secret API key and chooses an available model. The model list can be refreshed from the provider; unavailable or retired models must not be assumed to remain valid. Use configured/status checks rather than expecting the secret to be displayed.
Client-admin assignment
Client admins use Members & access to set Shared AI, Personal key or Blocked for their own users. The backend enforces shared-service requests. Desktop receives permission changes at startup or successful daily validation; an offline device can retain existing signed permissions only until its fixed deadline. Newly validated Blocked access cannot be bypassed with an old personal key.
Secrets and payloads
Keys stay protected server-side or in the applicable local encrypted store. Result rows are excluded from AI requests. SQL and user instructions can contain sensitive information and are intentionally sent when assistance is requested.
Review policy
AI proposals require review and Apply before replacing editor SQL. They are never executed automatically. Do not grant additional permissions merely to hide a provider or billing error.
Organization approval and trial exceptions
Review organizations
Open Organization approvals and inspect the applicant and organization details. Approve or reject using the screen’s controls. Activation can be completed while pending, but workspace access is still blocked.
Trial start
Approval starts the eligible 30-day organization trial, with ten seats. Approval and email activation are distinct events. Do not backdate or restart a trial merely because an applicant resets a password.
Exceptions
Prior trial use is tracked across all participating users, including users who later become admins. Only super admin can grant an explicit exception. Same-domain and same-Oracle-instance teams can subscribe independently; do not block them solely for sharing infrastructure.
Domain protection
Email-domain controls belong to super admin. Temporary overrides, such as approved test inboxes, must remain deliberate exceptions rather than opening domain protection to client admins.
Email-domain protection
Purpose
Domain protection checks account email domains against the configured downloaded list and platform rules. It is separate from Oracle authentication and separate from a team’s right to use an already shared Oracle instance.
管理 centrally
Only super admin can update protection settings or grant exceptions. Client admins cannot change the global policy. Review list updates and matching behavior on the screen before using a broad exception.
Independent teams
A shared company domain is not a reason by itself to block separate organizations or paid teams. Repeat-trial rules follow user identities. Chargeback domain escalation is a different workflow, excludes public email providers and requires approval for domain-wide actions.
Test inboxes
If a public-domain account is approved for a deliberate test, record the exception and scope. Do not assume that all accounts from that public provider are now allowed.
Upload object and列 metadata
Use the expected Oracle object/table fields, including OWNER, OBJECT_NAME and OBJECT_TYPE for object lists. Column extracts need identifiers including OWNER, TABLE_NAME and COLUMN_NAME, plus the size/type/comment fields recognized by the upload screen. Follow its exact current header list; do not guess unsupported comment-field names.
Upload table/object data and列 data separately. The importer identifies sheets by recognized column headers rather than relying on a sheet name. Put the recognized headers in the actual header row expected by the screen. A file containing columns should not require an unrelated object sheet.
Split large列 extracts by table-name initial or another non-overlapping range. Upload each batch in merge mode; previous batches are retained. Table/column identity uniqueness prevents duplicate entries. Restrict extracts to the intended object set to avoid unnecessary volume.
Inspect staged row counts and sample types, sizes and comments. Publish metadata when the assembled catalog is ready for users. Publication is the step that makes staged data available; an upload alone is not proof that autocomplete has changed. Desktop users download the new package.
Check the original workbook for empty comments before blaming import. Wrong or unrecognized headers, missing owners and source NULLs can explain absent details. Never upload client result data as schema metadata.
Custom plan maker and retired plans
Create plans
Use Plans & seats to define the plan, CAD or supported currency, monthly/yearly amounts and user capacity. Custom pricing is organization-specific and not shown on public plan cards. Public plan publication drives the website’s displayed offers.
Publish and test
Review the Stripe mode, price interval, exclusive-tax treatment and seat count before publishing. Test Checkout and signed events in sandbox. A plan label does not by itself grant seats; the active mapped subscription controls entitlement.
End-date plans
End-date a plan to close it to new customers while existing subscribers can remain on their current price as grandfathered. New customers receive available new plans. Switching away can make the old price unavailable.
Changes and limits
Immediate upgrades require successful prorated payment; downgrades take effect at renewal. Seat checks include admins and pending invitations. Never solve a failed payment by deleting an account or saved SQL.
Revenue, taxes and date-range reporting
Open Revenue & Stripe
Choose the date range and refresh the reporting screen. Review the displayed mode so sandbox totals are not mistaken for live revenue.
Gross customer payments, taxes, Stripe processing fees, refunds/credits, net balance transactions and payouts describe different amounts. Tax collected is not the same as revenue retained. A payout can include transactions from different invoice dates.
Tax
Prices use plus-applicable-tax treatment where configured. Stripe Tax needs the business address and valid registrations for the intended mode/jurisdictions. Invoice tax IDs and tax registration settings are separate. Do not assume live tax collection is enabled because sandbox tests passed.
Data and reconciliation
Invoice and credit-note access is required for actual tax/credit reporting. Reporting uses read-only credentials where configured. Compare date definitions and currencies when reconciling reports; fees are provider charges, not the subscription price itself.
Monthly collections
The report opens on the current calendar month. Use This month, Last month, or choose any Month (UTC) and select Show month. Custom From/To dates and the 7/30/90-day ranges are also available. Total money received is actual charges/payments including tax, not subscription list prices or forecast revenue. Net collections subtract fees and refunds and include dispute adjustments. Invoice tax and credit notes use their separately described basis. Each currency is reported separately. Export report CSV keeps the selected date range. Sandbox figures represent test transactions, not real income.
Chargebacks, blacklists and billing holds
On a chargeback
The configured dispute handler can place a billing hold and permanently blacklist the associated email, with super-admin override. Accounts and saved queries remain intact. Notifications and audit records explain the restriction.
Event handling
Duplicate and out-of-order events must not repeat destructive actions or blindly undo newer state. Won/lost outcomes update dispute handling; winning does not automatically remove the permanent email blacklist.
Domain escalation
A second qualifying chargeback from the same business domain can trigger a domain-level review. Public providers such as Gmail and Outlook are excluded. Domain-wide cancellation and unused-time prorated refund actions require super-admin approval before execution.
Review before approval
Inspect affected organizations, subscriptions and proposed amounts. Confirm the Stripe mode and current state. A client admin cannot approve a platform-wide refund or blacklist override. Never make domain-wide decisions from a forwarded email alone.
Read audit history and old/new values
Access
Audit log is restricted to administrators within their permitted organization scope. It records actor, action, target, time and descriptive change details rather than expecting users to interpret raw IDs.
What changed
For supported account and instance edits, review old/new values such as display name, login email, instance name, URL or report path. Security secrets and parameter values are not an audit-value display feature.
Account lifecycle
Activation, completed password reset, invitation changes and administrative actions can produce separate events. A pending organization may reset passwords without becoming approved.
Retention
Audit records older than 90 days are automatically removed by the retention process. Audit history is not permanent recovery storage. Query history is a separate feature with its own retention rule.
查询历史与保留期限
历史内容
查询历史记录已执行 SQL 及执行结果。打开历史项可审核或再次运行;参数化 SQL 应保留占位符并请求新的值。
自动保留
自动查询历史保留最近一个月的活动,若更早则至少保留最近十个查询。清理安排在周末,而非每小时进行。桌面历史位于本地账户工作区。
与已保存查询不同
按名称保存希望保留的查询。历史不是永久备份。清除历史是明确操作,不表示删除了 Oracle 数据。
取消参数输入
取消、Escape 或点击参数对话框外部不会执行 SQL 或创建执行历史项。失败的参数化查询保留脱敏历史错误,不保存参数值。
维护通知与服务状态
通知
计划维护消息可显示开始时间、预计结束时间、时区及运营方说明。维护进行时,公开登录动画可能替换为维护视图。
访问限制
维护限制生效时,非超级管理员网页用户会退出,普通访问受限。运营方保留执行维护所需的特权访问。计划开始由后端判断,而不仅是页面视觉计时器。
现有工作
请在通知的维护窗口前保存工作。已保存 SQL 和账户应保持完整。后端重启可能丢失超级管理员网页 Oracle 连接及临时服务器快照。本地桌面结果和 Oracle 连接不托管在该服务器上。保持桌面版运行,并保存重要导出。
停机期间的桌面授权
账户服务器不可用时,已授权的注册电脑可在签名期限内继续本地工作。期限为自上次成功验证起 48 小时,且不超过试用/订阅到期。首次激活和网页账户/账单需要服务器;Oracle 和 AI 仍需各自服务。明确的服务器拒绝不会获得中断延期。
服务中断
从登录页面或网站页脚使用服务状态。由同一应用提供的状态页面在服务器完全中断时可能也不可用;它不保证独立监控。
Schedule, start and end maintenance
Plan a window
Open Maintenance and enter the title, user-facing message, start, expected end and timezone. Review the schedule before enabling it. A clear message should explain what users need to save and when to retry.
Enforcement
At the active stage, non-super-admin web sessions are logged out and access is restricted. Super admin remains able to work. Query dispatch rechecks maintenance after queue waiting, so queued work does not bypass the window.
End maintenance
Use End to clear the active restriction and publish the updated status. Clients poll for status changes; verify a normal user can reach the intended page afterward. Ending maintenance is distinct from restarting a stopped server.
Operational work
Back up first, use the deployment process and avoid replacing the live database or private settings. After an upgrade, verify application health, sign-in, billing events and Oracle reconnect behavior.
Backups, S3 retention and recovery
备份与恢复
Use Create local recovery set or Back up to S3 from the web admin screen. The configured process can package application recovery files and a database backup excluding bulky Oracle table/column metadata contents. Review each job’s status and included/excluded items.
Daily scheduling
The configured daily backup runs only where the application/server schedule is actually installed and running. A prepared development schedule is not proof that a future VPS is configured. Confirm server timezone and last successful upload.
Retention
The private S3 recovery/ prefix has a 30-day lifecycle policy when enabled. AWS processes expiration asynchronously; noncurrent versions follow the configured additional cleanup. Saved downloads outside this prefix or local copies have separate retention.
Encryption keys
S3 storage encryption does not stop an authorized downloader from opening a ZIP. Application fields inside a database backup can still be encrypted with application keys. Those keys and private settings are excluded and need a separate secure recovery copy; losing them can make restored data unreadable.
Recovery testing
Keep backups private, test restore to a separate environment, verify accounts and saved SQL, and do not overwrite a working production database as a test. Desktop-local query files and exports are not covered by the server backup.
Downloads and signing key
R2 installers and metadata are separate from S3 recovery sets. Database recovery alone does not recreate those files. Preserve the desktop signing key in its persistent server volume and make a separate protected copy alongside other secrets. Replacing the key requires a fresh online sign-in on registered desktops; existing signed files cannot be verified with a different key.
Deploy updates without replacing data
Before deployment
Confirm the target server, SSH access, runtime, database, HTTPS and private environment settings. A production VPS/domain deployment is a separate step from local development and packaging.
Safe update process
Use the repository’s prepared deployment and recovery instructions. Keep database data, private credentials, application encryption keys, uploads and runtime files outside replaceable application releases. Back up and review migrations before applying an update.
Web and desktop synchronization
Run the complete build process for a finished change batch. It must build web assets, desktop assets and the packaged desktop application and verify their consistency. Updating shared sources alone does not refresh a running desktop app.
After deployment
Check health endpoints, public pages, login, billing/webhook processing and authorized Oracle connections. Use maintenance for planned downtime and retain a rollback path. Do not assume a rollback can undo a destructive schema change without a backup.
Persistent device authorization and downloads
Preserve the device_license volume/signing key when replacing app containers. Use the optional R2 downloads configuration and restricted credential mount for installers/metadata; keep backup credentials separate. Migrate and verify current published objects before enabling R2. Keep WEB_QUERY_ENABLED disabled for the current customer desktop-only policy. Local backend restarts are not desktop binary updates.
Account email delivery and templates
Transactional email
Account invitations/activation, password resets and payment-failure notifications use the configured HTML account-email format with a plain-text alternative. Full names support a personal greeting. These are operational messages, not marketing-list subscriptions.
Delivery configuration
The platform owner configures the email provider and sender identity. SES sandbox mode can require recipient verification; production access is separate from domain verification. Do not assume every recipient is enabled just because one inbox received a test.
Invitation lifecycle
Resend/cancel and post-activation admin approval are distinct from sending mail. An email accepted by the provider does not prove delivery, activation or workspace approval. Check the account status and audit event.
Secrets
Email links are sensitive, expire and can be single-use. Keep SMTP/API credentials server-only. Do not include passwords, reset tokens, parameter values or card details in a support response or audit description.
联系咨询与确认
发送咨询
使用联系页面咨询销售、定制团队价格或支持。输入您控制的邮箱及消息详情。网站发送一封确认邮件;您按照链接确认发送前,咨询不会转发给所有者。
重复提交
未确认时重复提交不应重复发送确认邮件。网站会提示您确认现有请求。请检查原始收件箱和垃圾邮件,不要重新提交。
确认之后
只有已确认咨询才会转发供回复。打开链接不一定是最后一步;请在确认页面使用确认并发送。咨询消息不使用账户邮件的团队签名。
隐私与所有者审核
平台所有者可在网站咨询中查看消息、时间戳、来源 IP 和确认/交付状态。IP 记录有助于调查滥用,但并不证明个人身份。所有者回复已交付邮件,而非将每个未确认提交都当作对话。
Cloudflare Turnstile 在服务器记录咨询或发送确认邮件前验证访客。失败、过期、重复使用或缺少的令牌会被拒绝。对于正式挑战,服务器还验证主机名和操作。提供商中断会阻止提交,而非跳过验证。速率限制、隐藏垃圾信息字段及单封确认邮件规则仍然有效。本地开发使用明确标记的官方测试密钥;生产环境需要真实组件及仅服务器持有的秘密密钥。CAPTCHA 不替代邮件确认,也不保证消息合法。
哪些数据被存储、发送或保留在本地
应用账户
我们的数据库保存账户、组织、已保存网页 SQL、账单状态及获准审计数据。账户邮箱和姓名使用应用加密及查找保护;密码经过哈希处理,而非可恢复明文。加密并不意味着运行中的应用被入侵后无害。
Oracle
对于超级管理员网页执行,Oracle 凭据是临时服务器内存值,不是持久数据库记录。客户网页账户没有查询工作区。桌面 Oracle 请求和结果位于本地;可选保存凭据使用操作系统保护加密。您的授权查询仍会将 SQL 发送至 Oracle。
参数与导出
参数值不随已保存 SQL、历史或可选 SQL 导出工作表存储。返回结果行可能包含敏感值,导出文件则是主动创建的副本。分享前请审核导出。
AI
仅请求的 SQL 和指令会发送以获得 AI 帮助,绝不发送查询结果行。SQL 字面量本身可能包含敏感信息。
恢复
服务器备份不包含密钥和桌面本地工作。请保护单独存放的应用密钥、本地工作区数据和下载导出。故障排查时避免分享令牌、原始日志或凭据。
设备授权与下载
服务器存储注册设备 ID、电脑名称、公钥及注册/验证时间。私钥和签名授权保留在电脑的操作系统保护存储中。签名封装包含账户身份、权限和实例配置,不包含 Oracle 密码、SQL 或结果。安装程序及元数据文件通过短期链接从私有 R2 存储交付;恢复备份使用独立私有 S3 存储。
隐私、数据处理与支持安全
从网站页脚阅读数据处理和使用信息,了解当前公布的信息。这些帮助文章解释产品行为,不能替代公布条款或隐私协议。
安全的支持详情
请包含平台(网页/桌面)、可用的应用版本、大致时间、执行操作及准确的脱敏错误。无害复现查询优于业务数据。截图应排除密码、令牌、私有 SQL 字面量及您无权分享的结果行。
绝不分享
不要发送 Oracle/应用密码、API 密钥、MFA 代码、恢复代码、重置/激活链接或完整银行卡信息。管理员调查访问策略不需要您的密码。
范围
独立的 Oracle 权限、邮件提供商交付和网络/设备策略可能影响 SQL Hop 之外的行为。请询问相关管理员,不要削弱账户保护。
排查 Oracle 查询与连接错误
从详情开始
查询执行失败标识执行结果,后面在可用时提供脱敏 Oracle/服务详情。编辑器 SQL 会保留。不要假设通用服务错误意味着密码错误。
常见情况
连接失败
使用正确配置的 HTTPS 主机和报表路径。Oracle 浏览器登录成功并不为 BI Publisher 连接器验证身份。不要反复重试被拒绝的凭据,以免锁定账户。
安全升级处理
分享错误代码、时间、平台及无害复现。绝不要在日志或支持消息中包含参数值或凭据。
排查账户与账单访问问题
识别限制
- 等待批准:激活已完成,但组织/成员尚未获批。
- 试用已结束或已使用:订阅,或请求超级管理员审核例外。
- 网页上的试用或付费账户:SQL 工作区隐藏。请下载桌面版;账户、账单及获准组织设置仍可用。
- 桌面试用账户:检查批准、试用资格及注册电脑。
- 席位限制:管理员必须减少用户/邀请或更改方案。
- 付款/争议冻结:与组织管理员检查网页账单。
- 已在其他位置登录:同一客户端类型的较新登录可能替换该会话。网页和桌面会话相互独立。
单席位管理员
唯一账户持有人可以是客户管理员,并占用一个席位。桌面版保留该账单角色,但隐藏管理功能。使用在网页管理账单 / 发票。有效订阅禁用新 Checkout,因为变更应在现有订阅门户中进行。
已保存密码但登录失败
检查准确的 URL 和端口、账户服务器来源、账户状态及 MFA 步骤。保存密码并不排除会话过期、登录被替换或服务器错误。不要仅因页面无法访问就重置密码。
设备与中断错误
另一台电脑已注册意味着该席位需要在网页账户安全中完成身份验证后转移。授权过期意味着需要重新连接 SQL Hop 并验证;重新安装或重新打开不会延长时间。时钟倒退警告需要在验证前修正时钟。明确的账户拒绝不是中断宽限延期。这些限制不会删除已保存 SQL 和现有结果。
检查服务可用性
状态页面
使用登录界面或网站页脚的服务状态。可用时显示应用当前维护状态及计划窗口消息。
页面无法加载时
先检查地址、端口、网络和证书。相同后端提供的状态页面在中断时也可能失败,因此页面无法访问并不证明一切运行正常。
它不能证明什么
应用可用不代表每个 Oracle 客户实例、OpenAI 响应或邮件交付均正常。Oracle 连接/查询错误需要单独检查。
维护恢复
后端重启后,登录可能仍存在,但临时 Oracle 凭据或快照可能已丢失。恢复工作前请重新连接并运行无害 SQL。
提供正确的信息以获取帮助
首先检查
在帮助中心搜索操作或准确错误代码。使用平台和角色标签,避免普通用户误用超级管理员流程。检查服务状态了解维护情况。
发送支持消息
登录后打开侧边栏中的支持,输入问题并选择发送消息。返回支持阅读回复;对话会保存。支持在网页和桌面版均可用。仅自己的对话可见。回复由平台所有者审核并发送,并非自动回复。对于组织特定访问,请先询问组织管理员。
注册前问题或定制团队方案请使用网站联系表单。请先确认邮箱,再等待转发给所有者。
包含内容
- 网页或桌面版及操作系统。
- 页面或工具栏操作及大致时间戳/时区。
- 移除秘密和私有数据后的准确错误。
- 无害 SELECT 1 FROM dual 是否成功。
- 对于账单,提供测试/正式模式及可见状态,不提供付款详情。
不要包含
密码、API 密钥、MFA/恢复代码、重置链接、客户结果文件和私有查询字面量。不要为制作支持复现而绕过证书警告或禁用安全功能。
提交咨询前完成 Cloudflare Turnstile。如果无法加载,使用重试验证,并在浏览器中允许 challenges.cloudflare.com。过期验证会刷新;服务器验证失败时不会发送确认邮件。咨询到达平台所有者前,仍需独立邮件确认步骤。
对话状态
支持对话可以是打开、等待用户或已解决。支持回复会将其变为等待用户。已解决消息仍保存。发送新消息会自动重新打开对话,以便支持继续帮助。
键盘快捷键参考
焦点很重要
快捷键适用于当前聚焦的编辑器、搜索字段、查询标签页或分隔线。桌面版遵循操作系统原生惯例。搜索面板的替换快捷键不得执行 SQL。在工作区打开问号帮助或按 F1 可查看相同参考。
查询工作区
SQL 编辑器
导航和结果
对话框和帮助
Publish desktop downloads
Prepare a release
- Open Desktop releases in the super-admin menu.
- Select the target platform. Enter a version such as 1.2.3 and release notes.
- Choose a .dmg, .pkg or .zip for Mac, or .exe, .msi or .zip for Windows. A Mac .app folder must be packaged as an installer or ZIP first. The maximum file size is 2 GiB.
- Select Upload release and wait for verification to finish. Uploading does not publish it.
- Review the entry and select Publish. It becomes the current download for that platform.
管理 versions
Publishing a replacement retires the previous public link without deleting the stored installer. Edit notes changes the displayed notes. Withdraw removes the public download. Client admins and users cannot manage releases.
Visitor experience
Downloads detects Windows or Mac and shows the matching page. Visitors can switch platforms manually. If Mac processor architecture cannot be detected, both Intel and Apple Silicon options are shown. Version, notes, size and a SHA-256 checksum accompany each published file.
Storage
Published installers are uploaded to a private Cloudflare R2 bucket and checked before the release becomes current. Uploads stage on the server and retain local originals for recovery; customer download bodies come from R2. The website issues a 15-minute signed link after checking that the release is current. Withdrawal blocks new links; an already-issued link can work until expiry. Installer files saved by customers do not expire after 15 minutes. The database backup alone does not include installer files. Metadata downloads use a separate prefix in the downloads bucket; S3 backups use separate storage and credentials.
下载正确的桌面安装程序
打开网站下载页面,或登录后使用下载 SQL Hop Desktop。尽可能检测 Windows 和 Mac;需要时手动切换平台。在 Mac 上,关于本机中的芯片表示 Apple Silicon,处理器:Intel 表示 Intel 硬件。自动操作系统检测可能无法识别处理器。
检查发行版本
每个已发布平台列出版本、发行说明、大小及 SHA-256。尚未发布的平台没有下载。请选择匹配系统的文件;不同处理器安装程序并非自动升级途径。
下载链接
私有 R2 签名链接有效期为 15 分钟。链接过期后,请返回下载页面获取新链接。已保存到电脑的文件可继续保留;此到期与临时后台导出文件不同。
安装与登录
使用已批准试用或付费 SQL Hop 账户在线激活,然后单独连接 Oracle。升级应用不会自动在电脑间同步本地已保存 SQL。
注册或更换桌面电脑
每位用户一台电脑
首次成功在线桌面登录会注册加密设备公钥。一个账户/席位有一个注册。在释放当前注册前,注册另一台电脑会被拒绝。SQL Hop 不使用 MAC 地址或磁盘序列号进行此注册。
转移到新电脑
- 登录网站并打开账户安全。
- 使用应用密码及已启用的现有验证因素验证身份。
- 找到已注册桌面电脑,选择转移到其他电脑。
- 确认释放注册,然后在新电脑的桌面版中在线登录。
旧电脑
旧设备在下次验证时被拒绝。如果离线,仅可使用已有签名授权,自上次成功起最多 48 小时,且不得超过已知订阅/试用到期。转移不承诺立即撤销离线授权。
保护本地工作
本地 SQL、结果和 Oracle 凭据不会自动迁移。更换电脑前,请导出 SQL 文件或保护获准本地备份。不要将删除应用数据文件夹作为转移捷径。
每日验证与账户服务器中断
首次激活与常规检查
首次激活需要在线登录。已注册电脑在启动及应用保持打开期间每 24 小时尝试验证。重复本地操作不会每隔几秒发送许可请求。共享 AI、支持、元数据下载和其他在线功能可发出各自请求。
账户服务器不可用
传输失败或临时服务器故障仅允许使用剩余签名授权。失败检查后的计划重试为 24 小时;启动时也尝试验证。访问最迟在上次成功后 48 小时或已知试用/订阅结束时停止,以较早者为准。重新打开、重新安装或失败请求不增加时间。自动恢复现有授权账户需要记住登录;明确退出会移除缓存授权。
明确拒绝
阻止、撤销或过期响应会停止新查询、新连接和导出。现有 SQL、结果、筛选和选择仍可用。需要成功在线验证或新的授权登录才能恢复;网络失败不会清除先前明确拒绝。
其他服务
Oracle 查询仍需连接 Oracle 的网络访问。组织 AI 需要账户服务和 AI 提供商;个人 AI 需要其提供商及现有获准授权。离线授权不会让这些服务无需网络即可运行。
时钟与权限
保持电脑时钟正确。向后跳变可能阻止授权,直到修正。设备访问、实例配置及个人 AI 权限变更可能到下次检查才传达给运行中的设备。中断窗口是有时限授权,并非运行时间保证。
入门导览与桌面下载提醒
何时显示
符合条件的非超级管理员账户可在首次网页登录时看到三步导览,且仅限从未登录的账户。回访账户和桌面登录不会自动启动。导览解释下载、独立的 SQL Hop 与 Oracle 登录,以及网页账户/账单管理。
仅显示一次
SQL Hop 在打开导览前记录账户偏好。关闭、Escape、完成、刷新页面或再次登录均不会使其重复。如果无法保存账户偏好,应用不会显示未记录状态的导览或打断登录。
重新打开
在账户侧边栏选择入门导览,可手动重播。这不会恢复自动显示。下载链接独立打开,因此已登录账户页面仍可用。