全部產品
Search
文件中心

ApsaraDB for OceanBase:結果編輯與匯出

更新時間:Aug 08, 2024

背景資訊

在 ODC SQL 視窗中編輯和執行 SQL 陳述式後,使用者可以在結果頁簽中查看、編輯和匯出執行結果。

本文檔以編輯 OceanBase MySQL 類型的表為例,介紹如何在結果集頁簽中將資料插入到表 employee 中。

說明

文中所使用的均為樣本資料,您可根據實際情況對資料進行替換。

編輯結果集

  1. 在 SQL 視窗中,編輯和執行 SQL 陳述式以查詢表employee的資料。

    image.png

    SELECT `emp_no`, `birthday`, `name` FROM `odc_test`.`employee`;
    
  2. 如上圖所示,在結果頁簽中,單擊開啟編輯表徵圖編輯結果集。

    同時,結果頁簽的導覽列中提供以下工具:

    工具

    說明

    編輯

    單擊 編輯 按鈕開啟對當前展示的結果集的編輯狀態,編輯態中提供 添加一行刪除複製當前行取消確認修改(當自動認可設定為開時,單擊該按鈕事務被自動認可) 和 修改並提交(自動認可設定為關時顯示該按鈕) 等編輯操作。同時可在編輯態下雙擊目標資料直接進行修改,或是通過上述操作按鈕進行快捷操作。 在編輯態中右鍵儲存格,彈出的菜單中提供 複製 設定為 Null 兩個操作鍵。

    說明

    通過結果集是否支援編輯預判斷功能,在 SQL 執行時擷取到 ResultMetaData 資訊,可在 SQL 執行結果出來時同步判斷結果集是否可編輯:

    • 如當前結果集不支援編輯,編輯按鈕隱藏,且提示當前結果集不可編輯。

    • 如當前結果集支援編輯,編輯按鈕呈可點擊態,可點擊進入結果集編輯頁面(支援編輯情境:單表/單視圖查詢)。

    • 目前不支援包含 SET 類型和 ENUM 類型的結果集編輯。

    計劃

    查看當前 SQL 陳述式執行後的實際資源消耗及執行計畫,可快速判斷 SQL 陳述式的優劣。

    全鏈路 Trace

    查看執行當前 SQL 陳述式的全鏈路 Trace 詳情。通過全鏈路診斷可快速定位 SQL/事務在各個節點的執行耗時,方便定位異常。

    說明

    僅 OceanBase V4.1.0 及之後的版本支援查看全鏈路 Trace。

    回到開始

    跳轉至第 1 頁。

    上一頁

    向上翻頁。

    下一頁

    向下翻頁。

    跳至底部

    跳轉至最後一頁。

    搜尋

    在搜尋方塊中輸入關鍵字查詢所需結果。

    下載資料

    匯出查詢結果。

    列管理

    篩選在頁面中展示的列。

    列模式

    以表格的形式展示一行選中的資料。在 列模式 頁面可以進行上一行、下一行的切換展示,對於列數量比較多情境,列模式 比較方便行資料的查看。參考步驟如下:

    1. 選中需查看的資料後,單擊 列模式image.png 按鈕;

    2. 在彈出的 列模式 頁面中,可單擊左右按鈕查看上下行列值;

    3. 滑鼠移動至某值欄位,單擊放大按鈕image.png,可查看該欄欄位詳情;

    4. 列模式 列表中,可通過 備忘 查看錶中對應的列注釋資訊。修改備忘資訊步驟如下:

      1. 在左側導覽列的表列表中,按右鍵目標表,選擇 查看錶結構,進入表屬性管理頁簽;

      2. 在屬性頁面簽的左導覽列中單擊 標籤;

      3. 選擇欄位名,單擊編輯表徵圖,彈出 編輯欄位 彈窗;

      4. 欄位注釋 中,填寫欄位注釋後,單擊 確定

      5. SQL 確認 彈窗,單擊 執行,完成修改備忘資訊;

      6. 列模式 中即會顯示修改的備忘資訊。

    重要

    編輯結果集時,不支援對包含 SET、ENUM 欄位類型的查詢結果集進行編輯。

  3. 單擊 + 添加一行並編輯資料。

    image.png

  4. 單擊 修改並提交

    說明

    當前串連採用共用 Session,提交操作會對所有視窗生效。

  5. 在 SQL 確認彈窗中,單擊 執行 確認 SQL 陳述式。

    image.png

  6. 編輯的資料添加到在結果頁簽中。

    image.png

    結果頁簽中顯示的結果集支援進行以下互動操作以方便日常開發工作:

    操作

    說明

    滑鼠選中目標範圍

    返回的結果集支援通過滑鼠選中目標範圍後直接通過快速鍵複製至外部檔案,可單擊欄位名稱或行號直接選中整行或整列。 亦可通過工具列中的 匯出 工具將結果集中的資料匯出到本地檔案。

    選擇多行/多列

    • 按 Shift 鍵,可選擇連續多行/多列;

    • 按 Ctrl/Command 鍵,可選擇不連續的多行/多列。

    按右鍵儲存格

    提供 複製/輸出到剪下板 功能鍵以直接將資料複製到外部檔案中。

    按右鍵行序號

    提供 複製行/凍結此行/解除全部凍結行/輸出到剪下板 功能。

    • 複製行:複製選中的行;

    • 凍結此行:將選中行置頂並凍結,凍結行和表頭固定下方內容可垂直滾動;支援凍結多行;

    • 解除全部凍結行:將所有凍結行恢複。

    • 輸出到剪下板:將整行資料以 SQL/CSV 格式輸出到剪下板。

    放大表徵圖

    當儲存格中的資料過長導致無法全部顯示時,可通過放大表徵圖查看儲存格中的全部資料:

    1. 將滑鼠箭頭放置在目標儲存格上;

    2. 單擊儲存格右側出現的放大表徵圖image.png,在彈出的大欄位展示彈窗中可查看儲存格中的全部資料。

    說明

    如為大欄位,預設按文本展示大欄位內容,可切換至十六進位查看同時支援下載打欄位內容至本地。

    BLOB 大對象

    結果頁簽中:

    • Oracle 模式下,CLOB,BLOB,RAW 支援直接編輯常值內容、編輯十六進位資料和上傳檔案(大小限制:文本 2 MB 內、十六進位 200 KB 內和圖片 20 MB 內)。

    • MySQL 模式下,BLOB,MEDIUMBLOB,TINYBLOB 等 XLOB 支援直接編輯常值內容、編輯十六進位資料和上傳檔案。

    按右鍵結果頁簽的標籤名(如 結果1

    在彈出的列表中單擊 固定 可使當前結果頁簽保持展示狀態,當執行一條新的查詢時當前結果不會被覆蓋而是產生一個新的結果展示頁簽,以方便對比不同的查詢結果。 單擊 解除固定 以取消目標結果頁簽的固定狀態。

    篩選、排序和搜尋按鈕

    結果集中每個欄位名稱後提供篩選、排序和搜尋按鈕,可對單列的資料直接進行篩選、排序和搜尋。

    拖動列名

    支援在結果集中直接拖動列名以調整各欄位的順序。

    調整列寬

    支援拖動調整列寬。

    狀態列顯示欄位類型和備忘資訊

    結果集中單擊某個欄位,底部狀態列中支援顯示該欄位的類型和備忘等具體資訊。

匯出結果集

樣本:以 Excel 檔案格式匯出表 employee 到本地磁碟中。

  1. 在結果集中,單擊image.png

    image.png

  2. 下載資料 頁面,指定匯出資訊後單擊 建立

    image.png

    資訊項

    說明

    查詢 SQL

    編輯查詢 SQL 陳述式,選中匯出的資料。

    查詢結果條數限制

    匯出資料條數不再受查詢時段的條數限制,可自訂匯出條數。

    檔案名稱

    匯出的檔案名稱。

    檔案格式

    將查詢結果匯出為 CSV、SQL 或 Excel 檔案:

    • 匯出 SQL 檔案:編輯 查詢 SQL 語句,選擇匯出的 查詢結果條數限制檔案名稱、檔案格式(SQL)、檔案編碼資料脫敏SQL 檔案設定表名)。

    • 匯出 CSV 檔案:編輯 查詢 SQL 語句,選擇匯出的 查詢結果條數限制檔案名稱、檔案格式、檔案編碼資料脫敏 CSV 設定包含列頭Null 字元串轉為空白值欄位分隔符號文本識別符 分行符號號)。匯出 CSV 格式時,預設匯出的是 CSV 檔案可以直接用 Excel 軟體開啟。

    • 匯出 Excel 檔案:編輯 查詢 SQL 語句,選擇匯出的 查詢結果條數限制檔案名稱、檔案格式、檔案編碼資料脫敏Excel 檔案設定包含列頭 匯出 SQL 到另一個 Sheet)。匯出 Excel 格式時可自訂是否包含列頭,可選擇是否匯出查詢的 SQL 陳述式。

    檔案編碼

    選擇檔案編碼。

    Excel 檔案設定

    確認匯出的資料中是否包含列頭、匯出 SQL 到另一個 Sheet。

  3. 在彈出的 工單-匯出結果集 頁簽中,單擊操作項下的 查看

    image.png

  4. 在任務詳情頁面中,單擊下載

    image.png

  5. 在本地磁碟中查看匯出的表 employee_excel。

    image.png

相關文檔