背景信息
在 ODC SQL 窗口中編輯和執行 SQL 語句后,用戶可以在結果頁簽中查看、編輯和導出執行結果。
本文檔以編輯 OceanBase MySQL 類型的表為例,介紹如何在結果集頁簽中將數據插入到表 employee 中。
文中所使用的均為示例數據,您可根據實際情況對數據進行替換。
編輯結果集
在 SQL 窗口中,編輯和執行 SQL 語句以查詢表
employee
的數據。SELECT `emp_no`, `birthday`, `name` FROM `odc_test`.`employee`;
如上圖所示,在結果頁簽中,單擊開啟編輯圖標編輯結果集。
同時,結果頁簽的導航欄中提供以下工具:
工具
說明
編輯
單擊 編輯 按鈕開啟對當前展示的結果集的編輯狀態,編輯態中提供 添加一行、刪除、復制當前行、取消、確認修改(當自動提交設置為開時,單擊該按鈕事務被自動提交) 和 修改并提交(自動提交設置為關時顯示該按鈕) 等編輯操作。同時可在編輯態下雙擊目標數據直接進行修改,或是通過上述操作按鈕進行快捷操作。 在編輯態中右鍵單元格,彈出的菜單中提供 復制 和 設置為 Null 兩個操作鍵。
說明通過結果集是否支持編輯預判斷功能,在 SQL 執行時獲取到 ResultMetaData 信息,可在 SQL 執行結果出來時同步判斷結果集是否可編輯:
如當前結果集不支持編輯,編輯按鈕隱藏,且提示當前結果集不可編輯。
如當前結果集支持編輯,編輯按鈕呈可點擊態,可點擊進入結果集編輯頁面(支持編輯場景:單表/單視圖查詢)。
目前不支持包含 SET 類型和 ENUM 類型的結果集編輯。
計劃
查看當前 SQL 語句執行后的實際資源消耗及執行計劃,可快速判斷 SQL 語句的優劣。
全鏈路 Trace
查看執行當前 SQL 語句的全鏈路 Trace 詳情。通過全鏈路診斷可快速定位 SQL/事務在各個節點的執行耗時,方便定位異常。
說明僅 OceanBase V4.1.0 及之后的版本支持查看全鏈路 Trace。
回到開始
跳轉至第 1 頁。
上一頁
向上翻頁。
下一頁
向下翻頁。
跳至底部
跳轉至最后一頁。
搜索
在搜索框中輸入關鍵字查詢所需結果。
下載數據
導出查詢結果。
列管理
篩選在頁面中展示的列。
列模式
以表格的形式展示一行選中的數據。在 列模式 頁面可以進行上一行、下一行的切換展示,對于列數量比較多場景,列模式 比較方便行數據的查看。參考步驟如下:
選中需查看的數據后,單擊 列模式 按鈕;
在彈出的 列模式 頁面中,可單擊左右按鈕查看上下行列值;
鼠標移動至某值字段,單擊放大按鈕,可查看該列字段詳情;
在 列模式 列表中,可通過 備注 查看表中對應的列注釋信息。修改備注信息步驟如下:
在左側導航欄的表列表中,右鍵單擊目標表,選擇 查看表結構,進入表屬性管理頁簽;
在屬性頁簽的左導航欄中單擊 列 標簽;
選擇字段名,單擊編輯圖標,彈出 編輯字段 彈窗;
在 字段注釋 中,填寫字段注釋后,單擊 確定;
在 SQL 確認 彈窗,單擊 執行,完成修改備注信息;
在 列模式 中即會顯示修改的備注信息。
重要編輯結果集時,不支持對包含 SET、ENUM 字段類型的查詢結果集進行編輯。
單擊 + 添加一行并編輯數據。
單擊 修改并提交。
說明當前連接采用共享 Session,提交操作會對所有窗口生效。
在 SQL 確認彈窗中,單擊 執行 確認 SQL 語句。
編輯的數據添加到在結果頁簽中。
結果頁簽中顯示的結果集支持進行以下交互操作以方便日常開發工作:
操作
說明
鼠標選中目標范圍
返回的結果集支持通過鼠標選中目標范圍后直接通過快捷鍵復制至外部文件,可單擊字段名稱或行號直接選中整行或整列。 亦可通過工具欄中的 導出 工具將結果集中的數據導出到本地文件。
選擇多行/多列
按 Shift 鍵,可選擇連續多行/多列;
按 Ctrl/Command 鍵,可選擇不連續的多行/多列。
右鍵單擊單元格
提供 復制/輸出到剪切板 功能鍵以直接將數據復制到外部文件中。
右鍵單擊行序號
提供 復制行/凍結此行/解除全部凍結行/輸出到剪切板 功能。
復制行:復制選中的行;
凍結此行:將選中行置頂并凍結,凍結行和表頭固定下方內容可垂直滾動;支持凍結多行;
解除全部凍結行:將所有凍結行恢復。
輸出到剪切板:將整行數據以 SQL/CSV 格式輸出到剪切板。
放大圖標
當單元格中的數據過長導致無法全部顯示時,可通過放大圖標查看單元格中的全部數據:
1. 將鼠標箭頭放置在目標單元格上;
2. 單擊單元格右側出現的放大圖標,在彈出的大字段展示彈窗中可查看單元格中的全部數據。
說明如為大字段,默認按文本展示大字段內容,可切換至十六進制查看同時支持下載打字段內容至本地。
BLOB 大對象
結果頁簽中:
Oracle 模式下,CLOB,BLOB,RAW 支持直接編輯文本內容、編輯十六進制數據和上傳文件(大小限制:文本 2 MB 內、十六進制 200 KB 內和圖片 20 MB 內)。
MySQL 模式下,BLOB,MEDIUMBLOB,TINYBLOB 等 XLOB 支持直接編輯文本內容、編輯十六進制數據和上傳文件。
右鍵單擊結果頁簽的標簽名(如 結果1)
在彈出的列表中單擊 固定 可使當前結果頁簽保持展示狀態,當執行一條新的查詢時當前結果不會被覆蓋而是生成一個新的結果展示頁簽,以方便對比不同的查詢結果。 單擊 解除固定 以取消目標結果頁簽的固定狀態。
篩選、排序和搜索按鈕
結果集中每個字段名稱后提供篩選、排序和搜索按鈕,可對單列的數據直接進行篩選、排序和搜索。
拖動列名
支持在結果集中直接拖動列名以調整各字段的順序。
調整列寬
支持拖動調整列寬。
狀態欄顯示字段類型和備注信息
結果集中單擊某個字段,底部狀態欄中支持顯示該字段的類型和備注等具體信息。
導出結果集
示例:以 Excel 文件格式導出表 employee 到本地磁盤中。
在結果集中,單擊。
在 下載數據 頁面,指定導出信息后單擊 新建。
信息項
說明
查詢 SQL
編輯查詢 SQL 語句,選中導出的數據。
查詢結果條數限制
導出數據條數不再受查詢窗口的條數限制,可自定義導出條數。
文件名稱
導出的文件名稱。
文件格式
將查詢結果導出為 CSV、SQL 或 Excel 文件:
導出 SQL 文件:編輯 查詢 SQL 語句,選擇導出的 查詢結果條數限制、文件名稱、文件格式(SQL)、文件編碼、數據脫敏和SQL 文件設置(表名)。
導出 CSV 文件:編輯 查詢 SQL 語句,選擇導出的 查詢結果條數限制、文件名稱、文件格式、文件編碼、數據脫敏 和 CSV 設置(包含列頭、空字符串轉為空值、字段分隔符、文本識別符 和 換行符號)。導出 CSV 格式時,默認導出的是 CSV 文件可以直接用 Excel 軟件打開。
導出 Excel 文件:編輯 查詢 SQL 語句,選擇導出的 查詢結果條數限制、文件名稱、文件格式、文件編碼、數據脫敏和Excel 文件設置(包含列頭 和 導出 SQL 到另一個 Sheet)。導出 Excel 格式時可自定義是否包含列頭,可選擇是否導出查詢的 SQL 語句。
文件編碼
選擇文件編碼。
Excel 文件設置
確認導出的數據中是否包含列頭、導出 SQL 到另一個 Sheet。
在彈出的 工單-導出結果集 頁簽中,單擊操作項下的 查看。
在任務詳情頁面中,單擊下載。
在本地磁盤中查看導出的表 employee_excel。