Query Builder

In Tenable Vulnerability Management, you can use Query Builders to build filter queries so that you can view specific data in a table. See Filtering and Simple Search. You can also save filter queries that you build. See Saved Queries.

Important: When you run a query using a query builder, it applies to all data on the page, including the quick filters on the left side of your data table (for example, By VPR > Critical). These quick filters, on the other hand, only affect the data within the table itself. Any filters applied on the left side of the page do not affect the results of queries within the query builder.

The Query Builder serves as the unified filtering engine across the Tenable Vulnerability Management platform. Depending on the feature within Tenable Vulnerability Management, query builders may have additional functionality.

  • Query Builder (Filters): The ability to construct logic using specific fields. See Filtering and Simple Search.

  • Simple Search (Quotes): The ability to perform a text-based search across multiple fields using double-quotes. See Filtering and Simple Search.

  • Saved Queries The ability to save the filter query for reuse. See Saved Queries

  • Saved Views: The ability to save the filter query as well as the table presentation (columns, sorting, grouping, etc.). See Saved Views.

Components of a Query

Queries consist of boolean conditions joined by boolean operators AND and OR. Query conditions have three components:

  • Filter — Filters available in the associated table (for example, Explore > Findings, Severity).

  • Operator — An operator to filter on (for example, is not equal to).

  • Value — The value to search (for example, a Severity of Critical).

Tip: You can nest queries with parentheses. For example, to search for high-severity findings where the VPR is greater than seven or the CVSSv3 Base Score is greater than six, use:

Severity is equal to Critical AND (VPR is greater than 7 OR CVSSv3 is greater than 6) .

Note: To ensure optimal performance while providing maximum flexibility, Tenable Vulnerability Management limits the number of filters for defining a dataset to 35 boolean filter conditions in a single query.