Tchater maintenant avec le support
Tchattez avec un ingénieur du support

Toad Edge 2.9 - User Guide

Text Search and Search View

Text Search

Not to be confused with Object Search, Text Search allows you to find specific strings in database scripts of certain object types such as (platform dependent):

  • Aggregates
  • Procedures
  • Functions
  • Events
  • Packages
  • Triggers
  • User types
  • Views and materialized views

To search for specific text in object scripts

  1. Select Database Menu | Text Search or by pressing CTRL + H
  2. Enter the text you want to look for into the Containing text field
  3. The other field, Object name patterns, allows you to search only in objects that match the given pattern
    • For example, "*energy*" will cause the application to only search for text in objects whose names contain "energy"
  4. Select the Databases that you want to search in as well as the Object types
  5. Once finished, click Search. The results will be shown in Text Search

NOTE: You can use standard wildcard characters in both fields mentioned above. Use question mark (?) to match one character, asterisk (*) to match multiple characters and back slash (/) to escape literal characters.

You can also use multiple search patterns in the Object name patterns field as long as you separate them with commas.

Text Search

The results of Text Search are displayed in this window. By double-clicking any match, you can open the respective object in Object Detail and highlight the match.

Button Option Description
Show Next Match Jumps to the next match, automatically displaying it in Object Detail
Show Previous Match Jumps to the previous match, automatically displaying it in Object Detail
Remove Selected Matches Removes the selected matches from the view
Remove All Matches Removes all matches from the view
Expand All Expands all objects and their matches
Collapse All Collapses all matches to their respective objects
Refresh the Current Search Again Performs the current search again
Cancel Current Search Cancels the currently undergoing search
Show Previous Searches Contains a history of past searches that you can perform again

Worksheet and Result

Worksheet

Worksheet is one of the most basic tools in Toad Edge. It is used to interact with a database using SQL scripts and queries. Coupled with additional features such as Content Assist and Outline View, you can create and modify queries in a fast and efficient manner.

NOTE: If you do not specify a database, the scripts and queries will be performed on the Default database (MySQL/MariaDB)

To open a Worksheet

  • Click the Worksheet button on main toolbar to open a blank Worksheet
Worksheet toolbar
Button Option Description
Run All Statements Runs all statements in the query
Run From Current Position Runs all statements from the current cursor position in the query
Run to Current Position Runs all statements up to the current cursor position in the query
Run SQL Statement Runs the statement where the cursor is currently placed. Can be used to run multiple selected statements at once
Run Explain All Runs explain plan cost of all queries
Run Explain From Runs explain plan cost of all queries from the current one up to the end
Run Explain To Runs explain plan cost of all queries from the beginning up to the current one
Run Current Runs explain plan cost of the current SQL query
Cancel Query Stops the query that is currently being run
Commit Transaction Commits the changes included in the current transaction. See AutoCommit for more information
Rollback Transaction Cancels the changes included in the current transaction. See AutoCommit for more information
Select Connection Allows you to select a connection using which the query should be run
Show Result Set Displays Result Set either in Vertical Layout or Horizontal Layout
Rename SQL tab Opens a dialog where you can enter the new name of the worksheet. This option is disabled for worksheets opened from files.
Worksheet context menu options
Option Description
Revert Restores the last saved state of the Worksheet
Open Opens the selected object in Object Detail. Note that this option only works when you place the cursor in or select a highlighted object name, i.e. an object that already exists in the database
Make Code Statement Generates Java code which recreates the selected query as a StringBuilder object. The code is copied to clipboard
Strip Code Statement When selecting Java code which contains a SQL query, this option will strip away the Java code and keep the SQL code. The code is copied to clipboard
Formatting Provides options to switch the selected text to uppercase/lowercase or to enclose it in text/object quotes
Quick Outline Displays the basic structure of a Worksheet if it contains multiple queries
Toggle Comment Comments out the selected lines
Hint Window

When you hover over a database object name, Hint Window is displayed to provide you with quick information about the object. Hover over the bottom bar of the window to see additional options.

Button Option Description
Open Declaration Opens the object in Object Detail
Show Script Displays the object SQL code in a new Worksheet

Result

When you run a SELECT statement in Worksheet, the result is displayed in the Result. The rows and cell values here can be conveniently exported to multiple formats and you can even edit the cell values in-place.

NOTE: Currently, the Result is only displayed if you run a SELECT statement alone and not as a part of a query.

To switch Result to editable mode

  • Select the Result is Editable option in the drop down menu in the bottom-left corner of the Result

NOTE: The SELECT statement must satisfy several conditions in order for the Result to be editable. Specifically, the statement must not contain:

  • Aggregation functions (count, max, sum...)
  • Set operators (join, union...)
  • Nested SELECT statements

Additionally, the Result is not editable when selecting from a view or when the selection does not include at least one identification key column (e.g. primary key).

To navigate and manipulate results

Button Option Description
Go to Beginning Goes to the first page of the Result Set
Go to Previous Page Goes to the previous page of the Result Set
Selected Row Displays the number of the currently selected row
Go to Next Page Goes to the next page of the Result Set
Go to End Goes to the last page of the Result Set
Drop Selected Rows Deletes the selected rows
Apply Changes After editing a value, applies the changes
Restore Original Values After editing a value, cancels the changes
Result context menu options
Option Description
Define in Editor Edits the selected cell value in a type-specific editor
Set Null Sets the selected cell value to null
Export BLOB to file (BLOB columns only) Exports the binary object of the selected cell as a file
Import BLOB from file (BLOB columns only) Imports a file as a binary object and places it into the selected cell
Export Selection Exports the currently selected rows as SQL code or to a CSV/HTML/XML file
Export Query Result Exports the entire result as SQL code or comma separated values

Multiple Result Set

Toad Edge supports working with more than one result sets. Type your SELECT queries into Worksheet and click Run All Statements. Result sets from all queries will be displayed in a new Result view, where you can easily switch between results, display them side-by-side, edit and export them

To work with multiple results

  • Left-click a result to select it
  • Hold Shift/Ctrl + left-click multiple results to select them

  • Click SQL button to highlight a specific statement in Worksheet
  • Right-click a statement in Result and click copy to copy the statement and later paste it into Worksheet

  • Only a certain number of results will by fetched upon operation. Scroll down to reveal more results when one result is selected. Set the number of fetched rows in View | Preferences | Data | Use fetch limit
  • When more result sets are selected, click Fetch More Rows or Fetch All Rows to load more data

To export results

  • Click Export Selected Statements Data to CSV/SQL to export some of the result sets
  • Click Export All Statements Data to CSV/SQL to export all of the result sets

  • Configure destination and format options in the next step:
Feature Description
Export As

Select the desired option:

  • SQL - INSERT statements - exports the data as INSERT SQL statements into the selected destination
  • SQL - MERGE statements - exports the data as MERGE SQL statements into the selected destination
  • CSV - exports the data as comma separated values into the selected destination
Line Terminator

Select from:

  • Environment default
  • Mac/Unix
  • Windows
  • Mac OS Classic
Destination for exported data

Exported data are displayed in:

  • Worksheet - Toad Edge exports the data into a new instance of Worksheet
  • Clipboard - Exports data into system clipboard
  • Single file - Click browse button to select the name for the exported file and its location. All result sets will be saved in one file.
  • Separate files - Click browse button to select the name for the exported file and its location. Files will named automatically.
Compress file in ZIP format Available for exporting as files.
Open directory after finishing the export Opens the destination directory after a successful export.
Format exported queries Check to export data in an easier-to-read format with indentations and extra lines.

Multiple Result Viewers

Toad Edge supports having more than one result view to see query results. Type your SELECT queries into Worksheet and click Run SQL Statement or Run All Statements. If you run your queries multiple times, it will display the results in multiple tabs.

To work with multiple tabs

  • By default the number of tabs is 1. You can go to View | Preferences | SQL Editor| Maximum results in a worksheet and increase it.
  • You can at max have 5 unpinned tabs.

To pin a tab

When the maximum number of tabs have already been created, Toad Edge picks the oldest created tab and re-uses it effectively replacing its result. You can pin a tab if you want Toad Edge to retain that tab and the result shown.

  • Right click on a result tab and click on pin.
  • Similarly you can unpin a tab.

Locks View

The Locks View displays blocked queries and the blocking query. It will tell you the PID of the blocked and blocking query along with other details like blocked mode, locked item etc. The information is updated according to your preferred frequency. It also gives you the ability to stop the blocking lock.

To start monitoring sessions

  1. Select a PostgreSQL/EDB connection from the select connection dropdown menu.
  2. The refresh period can be configured in the View Menu dropdown menu.

To stop a lock

  1. Select a lock and then click the End Blocking Lock to stop the locks.

Button Option Description
Refresh Manual update of the status of all locks
Select Connection Select a PostgreSQL/EDB connection here in order to monitor its sessions
Resize Columns to Data Resizes columns so they fit the values they contain
End Blocking Lock Ends the Blocking lock
Copy Copy the selected lock
View Menu Allows you to change the monitoring refresh period
Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation