SQL 頁面

SQL 頁面可讓您輸入和執行 SQL 與 PL/SQL 陳述式，以及建立資料庫物件。

若要瀏覽至 SQL 頁面，請執行下列其中一項作業：

  • 在「啟動畫面」頁面中，選取開發頁籤，然後按一下 SQL 。

  • 按一下選取器 選取器圖示，即可顯示導覽功能表。在「開發 (Development)」下，選取 SQL 。

您可以使用工作表中的 SQL 和 PL/SQL 敘述句來建立表格、插入資料、建立及編輯觸發程式、從表格選取資料，以及將該資料儲存至檔案。某些其他功能則是語法亮顯和錯誤偵測。

SQL 頁面由導覽工作表和物件的左窗格、執行 SQL 敘述句的編輯器，以及檢視結果的輸出窗格所組成。以下各節說明這些窗格：

  • 物件導覽器與檔案
    左窗格中的「導覽器」頁籤會顯示所選綱要的已儲存物件。「檔案」頁籤可讓您檢視並開啟儲存在瀏覽器或本機系統中的檔案。
  • 在程式碼編輯器中執行 SQL 敘述句
    SQL 頁面中的程式碼編輯器可讓您執行 SQL 敘述句、PL/SQL 命令檔以及 JavaScript 程式碼。主要功能包括相關資訊環境中程式碼完成、語法強調以及錯誤除錯。
  • 檢視 SQL 輸出
    SQL 的右下方窗格會顯示在 SQL 編輯器中執行的作業輸出。
  • 載入資料
    在 SQL 頁面中，您可以從一或多個本機檔案將資料載入一或多個表格。

父項主題：SQL 與 Data Modeler 頁面

物件導覽器和檔案

左窗格中的「導覽器」頁籤會顯示所選綱要的已儲存物件。「檔案」頁籤可讓您檢視並開啟儲存在瀏覽器或本機系統中的檔案。

下圖顯示左窗格中的各種元素。

圖 3-1 SQL 中的左窗格

workflow_left_pane.jpg 的描述如下
workflow_left_pane.jpg 圖解描述

瀏覽器頁標

顯示所選綱要的已儲存物件。

  • 綱要和物件類型選取器：使用下拉式清單來選取綱要，並依物件類型篩選結果。

  • 搜尋：搜尋已儲存工作表的內容，或依名稱搜尋「導覽器」頁籤中的物件。搜尋功能不區分大小寫，會擷取所有相符的項目，且不需要使用萬用字元。

  • 相關資訊環境功能表：相關資訊環境功能表中的選項包括：

    • 開啟：瀏覽與物件類型 (表格和視觀表) 相關的特性和資料。

      「資料」窗格會顯示表格、視觀表或具體化視觀表的資料。

      若要編輯項目，請按兩下儲存格以進行編輯。您也可以按一下 檢視 value_icon，然後輸入值。當您進行編輯時，該列中裝訂邊框儲存格的框線會變更為藍色。

      「資料」窗格中可用的圖示如下：

      • 建立資料列：將新資料列插入資料庫表格。當您使用建立資料列圖示插入資料列時，就會將該資料列確認至資料庫。

      • 刪除選取的項目：將選取的資料列標示為刪除。當您標示要刪除的資料列時，資料列的框線會變更為紅色。

      • 確認：確認對資料庫所做的所有變更。

      • 全部還原：回復標示為要確認的所有變更。

      使用右上角的篩選圖示來篩選資料欄資料。您也可以在儲存格上按一下滑鼠右鍵，以存取內容功能表來計算列數、檢視單一記錄、匯出或將儲存格文字複製到剪貼簿。

      若要檢視「二進位大型物件」資料類型 (BLOB)，請按一下 BLOB 資料類型的鉛筆圖示。在「檢視值」對話方塊中：
      • 如果載入的 BLOB 類型是影像，影像頁籤就會顯示載入的影像。
      • 如果載入的 BLOB 類型為文字，文字頁籤就會顯示文字檔。
      • 資訊頁籤會顯示詳細資訊，並可讓您執行下列動作：
        • 下載：下載 BLOB 資料類型的影像 / 文字檔。
        • 載入：插入 BLOB 資料類型的影像 / 文字。
        • 設為空值：刪除物件並將值設為 NULL。
      blob-edit-options.png 的描述如下
      blob-edit-options.png 圖解描述

    • 編輯：編輯現有物件的特性。

    • 新增會根據選取的物件類型建立物件。

    • 作為樣板：使用現有物件的特性作為樣板來建立物件。

    • REST

    • 資料載入會將資料從本機檔案載入表格。

    • 快速 DDL 會產生物件的「資料定義語言」敘述句。

  • 重新整理 Refresh icon：重新整理左窗格中所列的物件或工作表。

  • 物件子功能表 物件子功能表圖示：開啟「建立物件」對話方塊，根據下拉式清單中選取的類型來建立新物件。

  • 說明 說明圖示：提供相關內容說明文件。

檔案頁籤

可讓您從瀏覽器或本機裝置開啟檔案。

附註：

只有在安全相關資訊環境 (HTTPS) 中使用以 Chromium 為基礎的瀏覽器時，才會顯示左窗格中的 DEVICE 類別。
file_navigator.png 的描述如下
file_navigator.png 圖解描述

所有檔案：使用下拉式清單，依瀏覽器或裝置篩選檔案。

檔案的相關內容功能表選項為開啟和刪除。在「裝置」中，刪除檔案的對應選項是忘記。在此情況下，不會刪除檔案，而是會移除對檔案的參照。

將物件與檔案拖放至工作表

您可以從左側窗格拖放物件至右側窗格的工作表編輯器。

  • 如果您拖放表格或檢視，系統會提示您選取下列其中一個 SQL 敘述句：「插入」、「更新」、「選取」或「刪除」。例如，如果您選擇「選取」，就會使用表格或視觀表中的所有資料欄來建構 Select 敘述句。接著，您可以編輯陳述式，例如，修改欄清單或新增 WHERE 子句。

    圖 3-2 插入選取查詢

    圖 3-2 的描述如下
    「圖 3-2 插入選取查詢」的描述

    如果您選擇「物件名稱」，則會在工作表中新增前面加上綱要名稱的物件名稱。

  • 如果您拖放函數或程序，可以選擇在工作表中插入函數或程序的名稱或 PL/SQL 程式碼。如果您選取 PL/SQL 程式碼，則可以在將程式碼插入工作表之前先輸入參數。

父項主題：SQL 頁面

在程式碼編輯器中執行 SQL 敘述句

SQL 頁面中的程式碼編輯器可讓您執行 SQL 敘述句、PL/SQL 命令檔以及 JavaScript 程式碼。主要功能包括相關資訊環境中程式碼完成、語法強調以及錯誤除錯。

您可以輸入 SQL 和 PL/SQL 敘述句來指定動作，例如建立表格、插入資料、選取資料或從表格刪除資料。SQL 關鍵字會自動醒目標示。對於多個陳述式，您必須終止：

  • 每個新行中含有分號 (；) 或斜線 (/) 的非 PL/SQL 敘述句
  • 每一個在新行有斜線 (/) 的 PL/SQL 敘述句

開啟下列物件類型時，會觸發 PL/SQL 編輯器：函數、程序、套裝程式以及類型。此編輯器可協助您在編譯期間偵測 PL/SQL 程式碼中的錯誤。輸出包括詳細資訊，例如偵測到錯誤的特定行和欄，以及可移至程式碼區塊中相關位置的連結。

JavaScript 工作表模式支援 Oracle Database 版本 21c 中的 Multilingual Engine 語法。如需詳細資訊，請參閱支援 Multilingual Engine 。

如需工作表中支援的 SQL*Plus 和 SQLcl 敘述句，請參閱 SQL 工作表中支援的 SQL*Plus 和 SQLcl 命令。

使用「用戶群組 (Consumer Group)」下拉式清單選取用戶群組以執行您的 SQL 或 PL/SQL 程式碼。下拉式清單中的值與連線至資料庫時可用的資料庫服務相符。您必須具備 CS_SESSION 套裝程式的 EXECUTE 權限，才能使用此功能。

consumer_group_selector.png 的描述如下
consumer_group_selector.png 圖解描述

如果您按 Ctrl+Space ，編輯器會提供插入點可能完成的清單，供您自動完成正在編輯的程式碼。此清單以插入點的代碼環境定義為基礎。

autocomplete_code.png 的描述如下
autocomplete_code.png 圖解描述

此編輯器提供可透過「命令選盤」使用的完整命令清單。若要開啟 [Command Palette] (指令調色盤)，請按 Ctrl+Shift+P 。如需鍵盤捷徑鍵的清單，請參閱 Keyboard Shortcuts 。

程式碼中的錯誤是由左邊裝訂邊中的紅點與特定文字下方的方塊線來表示。當您將游標停留在它上方時，會看到一個即現式視窗，其中顯示解決錯誤的可能修正。

error_sql_worksheet.png 的描述如下
error_sql_worksheet.png 圖解描述

您可以使用右上角使用者下拉式清單中提供的偏好設定選項來設定程式碼編輯器偏好設定。您可以自訂的部分程式碼編輯器選項包括主題 (淺色、深色和高對比深色)、字型大小和族群、Tab 大小、Word 包裝、尺規、行號等等。

SQL 工具列包含下列作業的圖示：

  • 工作表下拉式清單

    • 開啟：從瀏覽器或裝置開啟檔案。
    • 最近開啟的檔案：顯示最近存取的檔案。如果最近的清單中有超過 5 個檔案，則會顯示 More 連結來檢視附加檔案。
    • 另存新檔：將檔案儲存至瀏覽器或裝置。
  • 新建檔案
    • 選取工作表以建立工作表。
    • 選取 PL/SQL 以建立 PL/SQL 物件類型。編輯器會切換為 PL/SQL 模式。
    • 選取 JavaScript 以建立 JavaScript 檔案。編輯器會切換為 JavaScript 模式，並將 (JS) 新增至檔案名稱。
  • 開啟：從您的瀏覽器或裝置開啟檔案。若要從您的裝置開啟檔案，請在 [Open File] (開啟檔案) 滑動軸中，按一下開啟檔案並瀏覽以選取檔案，或將檔案拖放至滑動軸。

  • 執行敘述句

    • 執行敘述句會在工作表編輯器中的滑鼠指標執行選取的敘述句或敘述句。SQL 敘述句可以包含 VARCHAR2 類型的連結變數和替代變數 (雖然在大多數情況下，VARCHAR2 會視需要在內部自動轉換成 NUMBER)。此時會顯示一個對話方塊，供您輸入變數值。

    • 不使用分頁執行敘述句會執行選取的敘述句，而不會將它包裝在 ROW_NUMBER()OVER 分析函數中以實行分頁。這表示查詢的執行方式與工作表中的執行方式相同，而且只會擷取前 256 個資料列。

  • 執行命令檔

    • 以 SQL 命令檔執行會使用「命令檔執行器」在工作表編輯器中執行所有敘述句。SQL 敘述句可以包含 VARCHAR2 類型的連結變數 (但不包括替代變數) (雖然在大多數情況下，VARCHAR2 會視需要在內部自動轉換成 NUMBER)。此時會顯示一個對話方塊，供您輸入連結變數值。

    • 以 JavaScript 身分執行 會以 JavaScript 檔案的方式執行程式碼。此選項僅用於 JavaScript 程式碼。如果 JavaScript 程式碼已新增至 PL/SQL 區塊，請選取「以 SQL 命令檔執行」來執行命令檔。

  • 編譯 (針對 PL/SQL 工具列) 會執行子程式的 PL/SQL 編譯。
  • 建立圖表會為在編輯器中輸入的對應 SQL 敘述句建立一個圖表。相反地，您可以部分標示子查詢並建立圖表。此時會顯示滑動軸視窗，供您輸入圖表參數。如需欄位的說明，請參閱建立或編輯圖表。

    如果 SQL 陳述式語法不正確或不完整，則會顯示錯誤 / 警告通知。

  • 說明計畫會產生敘述句的執行計畫 (內部執行 EXPLAIN PLAN 敘述句)。執行計劃會自動顯示在工作表輸出窗格的「說明計劃」頁籤中。請參閱檢視 SQL 輸出

  • Autotrace 會執行敘述句並收集程式實際執行統計資料和實際執行計畫。自動追蹤輸出會顯示在工作表輸出窗格的「自動追蹤」頁籤中。目前沒有可用的偏好設定。

  • 下載編輯器內容會將工作表的內容下載為 SQL 檔案至本機系統。

  • 格式化會在編輯器中格式化 SQL 陳述式，例如將陳述式、子句、關鍵字的名稱大寫，以及新增分行符號和縮排。

  • 未選取：從編輯器移除敘述句。

  • 導覽提供工作表的導覽，其中強調顯示稱謂功能，並提供新介面時有用的資訊。

  • 說明提供相關資訊環境相關說明，並提供說明文件的連結。

  • 以全螢幕模式開啟會以全螢幕模式開啟編輯器。

父項主題：SQL 頁面

關於資料庫動作中的階段作業狀態

在「資料庫動作」中，資料庫的連線是無狀態的。

在無狀態環境中，從屬端的每個 HTTPS 要求都會對應到新的資料庫階段作業。因此，一個階段作業會從每個 SQL 敘述句或命令檔執行開始與結束。

由於未維護階段作業狀態，因此不會保存階段作業屬性，且不會套用 ROLLBACK 和 COMMIT 等命令。如果 SQL 敘述句或命令檔成功執行，則會執行隱含的確認。如果它以錯誤執行，則會執行隱含倒回。

因此，在需要時，請在傳送給資料庫以進行階段作業的 PL/SQL 程式碼區塊中包含 ROLLBACK 與 COMMIT 命令或階段作業屬性。

「資料庫動作」階段作業期間唯一保存的組態命令是：

  • SET DEF[INE] <ON|OFF|prefix_character>
  • SET ESC[APE] <ON|OFF|escape_character>
  • SET TIMI[NG] <ON|OFF>

父項主題：在程式碼編輯器中執行 SQL 敘述句

鍵盤快速鍵

本節列出 SQL 頁面中各種命令的鍵盤快速鍵。

表格 3-1 鍵盤快速鍵

視窗 MacOS 描述

Ctrl + Enter

控制 + 輸入

以查詢方式執行代碼。

替代 + 頁標

選項 + 頁籤

對焦下一個元素 。

Ctrl+ 向上鍵 / 向上鍵

Cmd+Esc/Escape

從編輯器移除焦點。

Ctrl + 向下箭頭

指令 + 向下鍵

從歷史記錄移到下一個 SQL 程式碼。

Ctrl + 向上箭頭

Cmd + 向上鍵

從歷史記錄移到上一個 SQL 程式碼。

Ctrl + S

Cmd + S

儲存目前的工作表。

Ctrl + O

控制 + O

開啟工作表瀏覽器對話方塊。

Ctrl + I

Cmd + I

下載編輯器的內容。
F1 Fn + F1 開啟說明主題。

班次 + 上調

班次 + 上調

對焦上一個元素。

F5

Fn + F5

以命令檔執行程式碼。

F6

Fn + F6

顯示自動追蹤。

F10

Fn + F10

顯示說明計畫。

F11

Fn + F11

建立圖表。

Ctrl + B

控制 + B

開啟「轉換大小寫」下拉式清單。

Ctrl + F7

控制 + Fn + F7

在編輯器中格式化程式碼。

Ctrl + 空格

Ctrl + 空格

自動完成程式碼 (顯示提示)。

下表列出 [ 指令選用區 ] 中指令的鍵盤捷徑。

表格 3-2 命令選用區鍵盤快速鍵

Windows MacOS 描述
Ctrl + Alt + 向上 控制 + 選項 + 上移 在上方新增游標
Ctrl + Alt + 向下 控制 + 選項 + 向下 在下方新增游標
Shift + Alt + I 班次 + 選項 + I 將游標加到行末
Ctrl + K Ctrl + C 控制 + K 控制 + C 新增行註解
Ctrl + D 控制 + D 將選擇項目加到下一個找到的相符項目
Shift + Alt + 向下 班次 + 選項 + 向下 向下複製行
Shift + Alt + 向上 班次 + 選項 + 向上 向上複製行
Ctrl + U 控制 + 單位 游標還原
- Cmd + Backspace 刪除左側所有內容
- 控制 + K 刪除右側所有內容
Ctrl + Shift + K Shift + Cmd + K 刪除明細行
Shift + Alt + 向右 Shift + Ctrl + Cmd + Right 擴大選擇範圍
Ctrl + F 控制 + F 尋找
Enter 鍵 Enter 鍵 尋找下一個
Ctrl + F3 控制 + FN + F3 尋找下一個選擇項目
Shift + Enter Shift + Enter 尋找上一個
Ctrl + Shift + F3 班次 + 自訂 + Fn + F3 尋找上一個選擇項目
- 控制 + E 以選擇範圍尋找
Ctrl + Shift + [ 選項 + Cmd + [ 折疊
Ctrl + K Ctrl + 0 控制 + K 控制 + 0 全部折疊
Ctrl + K Ctrl + / 控制 + K 控制 + / 折疊所有區塊註解
Ctrl + K Ctrl + 8 控制 + K 控制 + 8 折疊所有區域
Ctrl + K Ctrl + 1 控制 + K 控制 + 1 折疊層級 1
Ctrl + K Ctrl + 2 控制 + K 控制 + 2 折疊層級 2
Ctrl + K Ctrl + 3 控制 + K 控制 + 3 折疊層級 3
Ctrl + K Ctrl + 4 控制 + K 控制 + 4 折疊層級 4
Ctrl + K Ctrl + 5 控制 + K 控制 + 5 折疊層級 5
Ctrl + K Ctrl + 6 控制 + K 控制 + 6 折疊層級 6
Ctrl + K Ctrl + 7 控制 + K 控制 + 7 折疊層級 7
Ctrl + K Ctrl + [ 控制項 + K 控制項 + [ 遞迴折疊
Ctrl + Shift + \ 班次 + 指令 + \ 前往括號
Ctrl + G Ctrl + G 前往行...
Alt + F8 選項 + FN + F8 前往下一個問題 (錯誤、警告、資訊)
F8 Fn + F8 前往檔案中的下一個問題 (錯誤、警告、資訊)
F7 Fn + F7 前往下一個符號標示
Shift + Alt + F8 班次 + 選項 + Fn + F8 前往上一個問題 (錯誤、警告、資訊)
Shift + F8 班次 + Fn + F8 前往檔案中的上一個問題 (錯誤、警告、資訊)
Shift + F7 班次 + Fn + F7 前往上一個符號標示
[Ctrl] + [] 指令 + ] 縮排行
Ctrl + Shift + Enter 班次 + 代碼 + 輸入 在上方插入行
- Ctrl + J 結合 Line
Ctrl + K Ctrl + D 控制 + K 控制 + D 將最後的選擇項目移至下一個找到的相符項目
Alt + 向下 選項 + 向下 將行下移
Alt + 向上 選項 + 向上 將明細行上移

F1 (所有瀏覽器)

Ctrl + Shift + P (僅限 Google Chrome)

 Fn + F1 開啟命令選用區
[Ctrl] + [ 控制項 + [ 凸排行
Ctrl + K Ctrl + U 控制 + K 控制 + U 移除行註解
Ctrl + H 選項 + 控制 + F 取代
Ctrl + Shift + 。 Shift + Cmd + 。 取代為下一個值
Ctrl + Shift + , Shift + Cmd + , 取代為上一個值
Ctrl + Shift + L 班次 + 代碼 + 上限 選取所有找到的相符項目
替代 + F1 選項 + FN + F1 顯示輔助功能說明
Shift + F10 班次 + Fn + F10 顯示編輯器的彈出式功能表
Ctrl + K Ctrl + I 控制 + K 控制 + I 顯示懸浮訊息
Shift + Alt + 向左 Shift + Ctrl + Cmd + Left 縮小選擇範圍
Shift + Alt + A 班次 + 選項 + A 切換區塊註解
Ctrl + K Ctrl + L 控制 + K 控制 + L 切換折疊
Ctrl + / 控制項 +/ 切換行註解
Ctrl + M Shift + Ctrl + M 切換 Tab 鍵以移動焦點
- Shift + Ctrl + T 調換英文字母
Ctrl + 空格 Ctrl + 空格 觸發建議
Ctrl + K Ctrl + X 控制 + K 控制 + X 移除尾端空格
Ctrl + Shift + ] 選項 + Cmd + ] 展開
Ctrl + K Ctrl + J 控制 + K 控制 + J 全部展開
Ctrl + K Ctrl + 9 控制 + K 控制 + 9 展開所有地區
Ctrl + K Ctrl + ] 控制 + K 控制 + ] 以遞迴方式展開

父項主題：在程式碼編輯器中執行 SQL 敘述句

支援 Multilingual Engine

「資料庫動作」可讓您在工作表中執行 JavaScript 程式碼，以支援 Multilingual Engine (MLE)。

必備條件

若要在 Database Actions 中使用 MLE 功能，您需要：

  • Oracle Database 版本 21c 和更新版本中的 DBMS_MLE 套裝程式。如需詳細資訊，請參閱 Oracle AI Database PL/SQL Packages and Types Reference 中的 DBMS_MLE 。

  • 指派給您的 EXECUTE DYNAMIC MLE 和 EXECUTE ON JAVASCRIPT 權限。

您可以使用下列方式在工作表中使用 JavaScript 程式碼：

  • 建立 JavaScript 工作表
  • 在標準工作表中執行 JavaScript 程式碼
  • 以 PL/SQL 區塊的形式執行 JavaScript 程式碼

建立 JavaScript 工作表

您可以用 JavaScript 模式開啟工作表。您也會看到工具列圖示與輸出分頁的變更，以反映 JavaScript 模式。

若要建立並儲存 JavaScript 工作表：

  1. 在工具列中，展開新建檔案圖示，然後選取 JavaScript 。
  2. 當您在工作表中輸入程式碼時，JavaScript 程式碼會自動反白顯示。
  3. 使用執行命令檔在工作表中執行 JavaScript 程式碼。

  4. 按一下儲存。

    在「檔案 (Files)」窗格中， (JS) 會新增至 JavaScript 檔案名稱。這可讓您快速識別 JavaScript 檔案。

jscript_worksheet.png 的描述如下
jscript_worksheet.png 圖解描述

在標準工作表中執行 JavaScript 程式碼

在標準工作表中 (當工作表不是處於 JavaScript 模式時)：

  1. 選取要執行的 JavaScript 程式碼。
  2. 在工作表工具列中，展開執行命令檔圖示，然後選取以 JavaScript 身分執行。

    附註：

    選取執行為 SQL 命令檔會導致錯誤。
jscript_execute.png 的描述如下
jscript_execute.png 圖解描述

以 PL/SQL 區塊的形式執行 JavaScript 程式碼

您可以使用 PL/SQL 程式碼區塊來執行 JavaScript 程式碼。

從工作表工具列中，展開執行命令檔圖示，然後選取執行為 SQL 命令檔 (F5) 。

javascript_plsql_execute.png 的描述如下
javascript_plsql_execute.png 圖解描述

父項主題：在程式碼編輯器中執行 SQL 敘述句

檢視 SQL 輸出

SQL 的右下方窗格會顯示在 SQL 編輯器中執行的作業輸出。

下圖顯示 SQL 頁面中的輸出窗格。

圖 3-3 輸出窗格

圖 3-3 的描述如下
圖 3-3 輸出窗格描述

輸出窗格包含下列頁籤：

  • 查詢結果：在顯示表格中顯示最近執行敘述句作業的結果。

  • 命令檔輸出：顯示使用命令檔引擎以命令檔執行之敘述句的文字輸出。

  • DBMS 輸出：顯示 DBMS_OUTPUT 套裝程式敘述句的輸出。

  • 說明計畫：使用「說明計畫」命令顯示查詢的計畫。預設檢視為圖表檢視。如需詳細資訊，請參閱使用說明計劃圖表。

  • 自動追蹤：使用「自動追蹤」功能執行 SQL 敘述句時，顯示 v$sql_plan 的階段作業統計資料和執行計畫。按一下「自動追蹤」圖示時會顯示輸出。

  • SQL 歷史記錄：顯示您已執行的 SQL 敘述句和命令檔。若要在工作表中重新輸入先前執行的查詢，請按兩下歷史記錄清單中的查詢。您可以按一下「搜尋」圖示來搜尋特定陳述式。「搜尋」功能有大小寫之分，會擷取所有包含搜尋文字的項目，且不需要萬用字元。

    附註：

    執行的敘述句會儲存在資料庫中，因此可以在所有裝置上使用。對於唯讀資料庫，SQL 陳述式會儲存在瀏覽器中。

  • 資料載入：顯示針對所有可見表格 (包括來自其他綱要的表格) 載入和失敗之資料列總數的報表。

此窗格中的圖示如下：

  • 清除輸出：清除輸出。

  • 顯示資訊：顯示要顯示輸出的 SQL 敘述句。

  • 在新頁籤中開啟：在新視窗中開啟查詢結果或說明計畫。

  • 共用查詢結果：這僅適用於「查詢結果」，且只有在已順利執行查詢時才能使用，以產生結果資料。如果沒有可用的結果資料，則會停用此選項以供使用。

    它可讓您使用可共用的 URL 與其他使用者共用查詢結果。按一下「共用」按鈕時，會產生 URL。只要將它複製到您的剪貼簿，您就可以輕鬆地與非認證的使用者共用結果。因此，您提供此 URL 的任何人都可以不經認證 (例如使用者名稱 / 密碼) 存取該 URL，以及使用到期日定義的時間限制。若未指定到期日與時間，則預設的到期日會作為目前日期，且預設的最短到期時間為 1 小時。雖然已設定預設最短到期持續時間，但對於可以設定到期持續時間的時間沒有上限。這表示您可以根據特定業務需求來設定到期期間。

    附註：

    您使用此選項所共用的查詢結果，是根據在特定時間點執行的特定查詢。如果稍後修改查詢中所參照的基礎物件或視觀表，查詢結果資料可能會變更或變更。

  • 下載：這僅適用於「查詢結果」。可讓您將查詢結果下載至 CSV、JSON、XML 或 TEXT (.tsv) 格式的本機電腦。

在「查詢結果」頁標的顯示表格中，資料列表頭的內容功能表 (按一下滑鼠右鍵) 包含下列項目：

  • 資料欄可讓您選取要隱藏的資料欄。

  • 排序會顯示一個對話方塊，供您選取要作為排序依據的資料欄。對於每個資料欄，您可以指定遞增或遞減順序，也可以指定先顯示空值。

圖 3-4 資料列標頭的相關資訊環境功能表

圖 3-4 的描述如下
「圖 3-4 資料列標頭的相關資訊環境功能表」描述

顯示表格其餘部分的關聯式功能表包含下列命令：

  • 計算資料列數會顯示查詢結果集中的資料列數。

  • 單一記錄檢視可讓您檢視表格或檢視的資料，一次一筆記錄。

  • 匯出會根據選取的格式產生要下載的檔案，可以是 XML、CSV (以逗號區隔的值，包括資料欄 ID 的標頭資料列)、插入、分隔、固定、HTML、JSON 或 TEXT。

    • 格式：從下拉式清單中選取要匯出的格式。

    • 行終止字元：識別每一行的終止字元。匯出的資料中不包含行結束字元。如果預覽頁面以單一列顯示資料，則不會指定正確的終止字元。

    • 標頭：控制第一列是標頭列還是第一列資料。

    • 左側與右側機櫃：機櫃用於字元資料且為選擇性。匯出的資料中不包括附件。

    附註：

    如果已啟用彈出式視窗封鎖程式，將會阻止檔案下載。

  • 複製：從儲存格、列或列範圍複製資料。

圖 3-5 彈出式功能表

圖 3-5 的描述如下
「圖 3-5 相關資訊環境功能表」的描述

父項主題：SQL 頁面

使用說明計劃圖

「說明純文字」圖表檢視是以圖形表示的 PLAN_TABLE 內容，這是 EXPLAIN PLAN 敘述句結果的預設表格。執行計畫中步驟的階層性質描述於圖表中。

依照預設，圖表中會顯示三個層級的步驟。您可以使用每個步驟底部的 +/- 符號 (步驟有子項時即可使用) 來展開或收合。若要檢視圖表中的所有步驟，請使用工具列中的 expand_all_icon 全部展開。

圖表也提供下列詳細資訊：

  • 基數 (箭號上到父項步驟的數字)，這是處理的資料列數目
  • 該步驟中套用的作業和選項
  • 執行順序 (依執行順序排列的循序數字)
  • 存取述詞 CPU 成本百分比 (橘色長條圖)
  • 步驟的 CPU 成本總計 (藍色圓圈)
  • 預估 I/O 成本、已處理位元組數及成本度量

當您將游標暫留在步驟中的任何統計資料上時，即可看到簡短描述快顯視窗。

described_plan_diagram.jpg 描述如下
expl_plan_diagram.jpg 圖解描述

工具列中的圖示如下：

  • 進階檢視 / 圖表檢視：在「進階」和「圖表」檢視之間切換。「進階檢視」會在混合的表格式 / 樹狀結構檢視中顯示來自 PLAN_TABLE 的資料。「圖表檢視」會以流程圖格式顯示資料。

  • 列印圖表：列印圖表。

  • 儲存至 SVG ：以 SVG 格式儲存圖表至檔案。

  • 放大、縮小：如果在圖表中選取某個步驟，按一下「放大」圖示可確保該步驟保持在畫面的中央。

  • 配合畫面：適合可見區域中的整個圖表。

  • 實際大小：將縮放係數設為 1。

  • 全部展開：顯示圖表中的所有步驟。

  • 重設圖表：將圖表重設為初始狀態，亦即只會顯示三個層級的步驟。

  • 顯示資訊：顯示「說明計畫」功能所使用的 SELECT 敘述句。

  • 在新頁籤中開啟：在新頁籤中開啟圖表檢視，以獲得更好的檢視和導覽效果。圖表僅限於初始的 SELECT 陳述式。

  • 最低可見的總 CPU 成本 (%) ：定義臨界值以篩選總 CPU 成本小於所提供值的步驟。

    請輸入介於 0 到 100 之間的值。沒有 0 的篩選。

  • 計劃備註：顯示「說明計劃」備註。

described_plan_tooltip.jpg 描述如下
expl_plan_tooltip.jpg 圖解描述

特性

按兩下或按選定步驟上的 Enter 鍵以開啟「特性」滑動軸，其中提供有關該步驟的詳細資訊。如需每個特性的描述，請參閱 Oracle Database Reference 中的 PLAN_TABLE 。

Properties slider 會顯示：

  • 該步驟的所有資訊都是以列表化格式從 PLAN_TABLE 擷取。排除空值。

    您可以選取 JSON 以檢視 JSON 格式的特性。

  • 來自 PLAN_TABLE 之 OTHER_XML 資料欄的資訊。

    資訊會以 JSON 格式顯示。

導覽

  • 按 Tab 鍵可移動執行順序中的步驟。選取的步驟周圍有藍色框線。

    若要反向移動，請按 Shift + Tab 鍵。

    如果未選取任何步驟，按 Tab 鍵會選取執行編號為 1 的步驟。

  • 視縮放比例而定，使用水平與垂直捲軸來檢視圖表的不同部分。

    按一下滑鼠左鍵並按住該按鈕，即可在圖表上下移動。

    使用右下方的 捲軸圖示 圖示，捲動至圖表的頂端。

  • 「圖表導覽器」位於右上角，代表灰色背景上較小的圖表複本。矩形框線允許放大和縮小作業，並移動以顯示圖表的不同部分。

    described_plan_navigator.jpg 描述如下
    expl_plan_navigator.jpg 圖解描述

    圖表導覽器會以遞減順序顯示具有超過 1% CPU 成本的步驟清單。按一下清單中的某個步驟，即可瀏覽圖表中的相同步驟，讓您可以在其他步驟的相關資訊環境中看到該步驟。

父項主題：檢視 SQL 輸出

載入資料

在 SQL 頁面中，您可以從一或多個本端檔案載入資料至一或多個表格。

您可以載入的檔案格式包括 CSV、XLS、XLSX、TSV、TXT、XML、JSON 和換行分隔的 JSON (NDJSON)。

父項主題：SQL 頁面

從本機檔案載入資料至新表格

將資料從本機檔案載入新表格：

  1. 您可以從下列其中一種方式開始：

    • 在「導覽器」頁籤的左窗格中，按一下物件子功能表 物件子功能表圖示，選取資料載入，然後選取將資料上傳至新表格。

      圖 3-6 將資料上傳至新表格選項

      圖 3-6 的描述如下
      「圖 3-6 上傳資料至新表格選項」的描述

    • 在「導覽器」頁籤中，將本機檔案拖放至左窗格。將檔案拖曳至窗格時，會顯示下列訊息：將檔案置於此處以啟動。

    會顯示「上傳資料至新表格」。資料預覽會以方格格式顯示。

  2. 按一下顯示 / 隱藏選項 顯示 / 隱藏選項圖示，即可顯示您可以修改以進行資料預覽的選項：

    • 資料欄名稱：選取從檔案取得，即可在第一列中顯示資料欄標頭。

    • 編碼：載入的檔案為純文字格式 (CSV、TSV 或 TXT) 時，會顯示用來選取編碼類型的選項。預設編碼類型為 UTF-8。

    • 文字外殼與欄位分隔符號：只有在選取的檔案為純文字格式 (CSV、TSV 或 TXT) 時，才會顯示這些選項。選取或輸入來源檔案中用於文字外殼與欄位分隔符號的字元。

    • 要略過的資料列：輸入或使用向上和向下箭號來選取要略過的資料列數目。

    • 預覽大小：輸入或使用向上和向下箭號來選取要預覽的資料列數目。

    • 限制要上傳的資料列：如果選取此選項，就必須指定要載入的資料列。使用向上與向下箭頭來選取要載入的列數。

    若要移除選取的選項和資料預覽，請按一下清除。

    選取必要的選項之後，請按一下套用，然後按一下下一步。

  3. 在「表格定義」中，執行下列作業：

    • 在表格名稱欄位中，輸入目標表格的名稱。

    • 選取列開頭的核取方塊，以新增欄至目標表格。

    • 選取或輸入資料欄屬性的值，例如資料欄名稱、資料欄類型、小數位數、小數位數、預設值、主索引鍵以及空值。

    • 「格式遮罩」資料欄會針對日期、時間戳記以及數值類型的資料顯示。對於日期與時間戳記類型，您必須從下拉式清單中選取值，或在「格式遮罩」欄位中輸入值。對於數值類型，格式遮罩是選擇性的。

      對於日期和時戳資料欄，您必須提供相容的格式遮罩來描述正在上傳的資料。例如，如果日期資料看起來像 12-FEB-2021 12.21.30，您必須提供 DD-MON-YYYY HH.MI.SS 的日期遮罩。格式遮罩會根據檔案中的資料自動決定。您需要複查建議的格式遮罩，並視需要直接在目標儲存格中輸入格式來修改格式。

    圖 3-7 上傳資料至新表格中的表格定義步驟

    圖 3-7 的描述如下
    「圖 3-7 上傳資料至新表格中的表格定義步驟」描述

    按一下下一步。

  4. 根據在先前畫面中所做的選擇，複查產生的 DDL 程式碼。也會顯示來源與目標資料欄的對應。

    按一下完成。順利載入資料之後，新表格就會顯示在「瀏覽」頁籤中。

  5. 如需已載入與失敗之資料列總計的詳細報表，請執行下列其中一項作業：

    • 在「導覽器」頁籤的表格上按一下滑鼠右鍵，選取資料載入，然後選取歷史記錄。這會顯示特定表格的報表。

    • 在「導覽器」頁籤中，選取「物件」子功能表 物件子功能表，選取資料載入，然後選取歷史記錄。這會顯示「導覽器」頁籤中選取之綱要中所有表格的報表。

    • 在工作表輸出窗格中，選取資料載入頁籤。這會顯示所有可見表格 (包括其他綱要的表格) 的報表。

    載入的資料摘要會顯示在「歷史記錄」對話方塊中。如果有任何資料無法載入，您可以在「失敗的資料列」資料欄中檢視失敗的資料列數目。按一下失敗的資料列資料欄即可開啟顯示失敗資料列的對話方塊。

    在 [History] (歷史記錄) 對話方塊中，您也可以搜尋依綱要名稱、表格名稱或檔案名稱載入的檔案。若要移除載入的檔案，請按一下「移除所有歷史記錄 移除所有歷史記錄」。

    您也可以使用從多個本機檔案載入資料至多個表格中的步驟，將資料從檔案載入至新表格。

父項主題：載入資料

從本機檔案載入資料至現有表格

若要從本機檔案載入資料至現有表格，請執行下列動作：

  1. 在「導覽器」頁籤的左窗格中，在您要將資料載入的表格上按一下滑鼠右鍵，選取資料載入，然後選取上傳資料。

    圖 3-8 現有表格的上傳資料選項

    圖 3-8 的描述如下
    「圖 3-8 現有表格的上傳資料選項」描述

    就會顯示「匯入資料」對話方塊。

  2. 將檔案從系統拖放至對話方塊中，或按一下選取檔案以瀏覽檔案並開啟檔案。

    資料預覽會以方格格式顯示。

  3. 按一下顯示 / 隱藏選項 顯示 / 隱藏選項圖示 以顯示您可以修改以進行資料預覽的選項：
    • 資料欄名稱：選取從檔案取得，即可在第一列中顯示資料欄標頭。
    • 編碼：載入的檔案為純文字格式 (CSV、TSV 或 TXT) 時，會顯示用來選取編碼類型的選項。預設編碼類型為 UTF-8。
    • 文字外殼與欄位分隔符號：只有在選取的檔案為純文字格式 (CSV、TSV 或 TXT) 時，才會顯示這些選項。選取或輸入來源檔案中用於文字外殼與欄位分隔符號的字元。
    • 要略過的資料列：輸入或使用向上和向下箭號來選取要略過的資料列數目。
    • 要載入的資料列：輸入或使用向上和向下箭號來選取要載入的資料列數目。
    • 預覽大小：輸入或使用向上和向下箭號來選取要預覽的資料列數目。

    若要移除選取的選項和資料預覽，請按一下清除。

    選取必要的選項之後，請按一下套用，然後按一下下一步。

  4. 在「資料」對應中，將檔案中的資料與目標表格中的適當資料欄進行比對。依照預設，會使用資料欄名稱來進行比對。

    圖 3-9 資料對應

    圖 3-9 的描述如下
    「圖 3-9 資料對應」的描述

    若要修改，請按一下顯示 / 隱藏選項 顯示 / 隱藏選項圖示。在比對資料欄的方式：

    • 選取名稱，根據目標表格中的資料欄名稱來比對資料欄。
    • 如果要根據目標表格中資料欄的位置來比對資料欄，請選取位置。
    • 選取無可移除目前的選擇項目，並從下拉式清單中選取每個來源資料欄的目標資料欄。

    附註：

    系統會根據檔案中的資料，嘗試自動擷取以日期為基礎之資料欄的正確格式遮罩。如果不正確，您可以直接在目標儲存格中輸入建議的格式來變更。

    如果有任何需要解決的問題，您會在對話方塊右上方看到如 圖示 的通知。

    按一下下一步。

  5. 系統會顯示上一個畫面的摘要。按一下完成。

    資料將會開始上傳至目標表格。完成之後，便會在日誌中新增一個含有作業狀態的項目。若要檢視日誌，請按一下頁面底端的時戳通知。如果作業成功，則會顯示資料匯入完成通知。

  6. 如需上傳處理的詳細摘要，請在「導覽器」頁籤的表格上按一下滑鼠右鍵，選取資料載入，然後選取歷史記錄。載入的資料摘要會顯示在「資料載入歷史記錄」對話方塊中。

    如果無法載入任何資料，您可以在「失敗的資料列」資料欄中檢視資料列數目。按一下資料欄即可開啟顯示失敗資料列的對話方塊。

    在「資料載入歷史記錄」對話方塊中，您也可以搜尋依綱要名稱、表格名稱或檔案名稱載入的檔案。若要移除載入的檔案，請按一下「移除所有歷史記錄 移除所有歷史記錄」。

    您也可以使用從多個本機檔案載入資料至多個表格中的步驟，將資料從檔案載入至現有表格。

父項主題：載入資料

將多個本機檔案的資料載入多個表格

若要從多個檔案將資料載入多個表格，請執行下列動作：
  1. 在 SQL 頁面的右上角，按一下資料載入。

    即會出現「資料載入」滑桿。

  2. 按一下新增檔案，瀏覽一或多個檔案並同時新增。或者，您可以將檔案拖放至「資料載入」滑動軸。

    新增的檔案會顯示為卡片。

  3. 若要開啟檔案，請按一下檔案的名稱，或按一下卡片右上角的 actions icon - 動作圖示，然後選取詳細資訊。
    在「詳細資訊」頁面中，會顯示檔案的預覽。按一下下一步。若要移至上一頁，請按一下所有檔案。

    附註：

    第一次載入檔案時，會顯示整個檔案的預覽。接著，如果對設定進行任何變更，預覽最多會設為 10 個資料列。如需設定值的描述，請參閱將資料從本機檔案載入至新表格中的步驟 2。
  4. 在「目標詳細資訊」頁面中，動作欄位包含下列兩個選項：
    • 建立新表格以建立表格。依預設，會選取此選項，並預先填入表格名稱欄位。
    • 附加至現有表格：將檔案新增至現有表格。資料載入器會嘗試比對檔案名稱與現有的表格名稱。展開表格資料列預覽以預覽現有表格。

    如需對應選項的描述，請參閱將資料從本機檔案載入至新表格中的步驟 3，以及將資料從本機檔案載入至現有表格中的步驟 4。

    按一下所有檔案，即可返回起始的「資料載入」頁面。

  5. 若要將資料載入表格中，請按一下卡片右上角的 「動作」圖示，然後選取執行。

    若要同時將資料載入多個表格，請按一下 「全部執行」圖示 全部執行。

    已順利上傳的檔案會顯示綠色圖示、勾選標記以及狀態已上傳。

    其他可能的狀態包括：

    • 以黃色使用警告上傳。
    • 未因錯誤而被上傳為紅色。
    • UPLOADED WITH ERRORS ，您可以在其中查看失敗的資料列數目。
    • 包含警告表示設定中有錯誤。除非解決警告，否則不會載入此檔案。
    upload_file_status.png 的描述如下
    upload_file_status.png 圖解描述
  6. 載入檔案之後，請移至「詳細資訊」滑桿，查看名稱為 Results 的第三個步驟。

    「結果」步驟會顯示載入的資料列總數，以及失敗的資料列數目。

    若要檢視所有先前已載入的檔案及其載入狀態，請按一下開啟歷史記錄。您可以依綱要與表格名稱進行篩選。

父項主題：載入資料