瀏覽完整參考
搜尋和主題導覽需要 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 認證資訊或移除雙因素身分驗證。如需這些變更,請聯絡相應管理員。
身分驗證器代碼、實體金鑰與復原碼
在網頁端開啟帳號安全
使用導覽中的帳號安全或頂部帳號圖示。更改設定前,請按要求驗證目前應用程式密碼和現有驗證因素。已驗證的安全設定視窗僅臨時有效。
身分驗證器應用程式
選擇設定身分驗證器應用程式,使用所選身分驗證器掃描QR 碼,並輸入其目前六位代碼。確認設定成功後再依賴該方式。
實體安全金鑰
註冊實體安全金鑰會請求外部 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、完成、重新整理頁面或再次登入均不會使其重複。如果無法儲存帳號偏好,應用程式不會顯示未記錄狀態的導覽或打斷登入。
重新開啟
在帳號側邊欄選擇入門導覽,可手動重播。這不會還原自動顯示。下載連結獨立開啟,因此已登入帳號頁面仍可用。