English (New Zealand) keyword reference

Use keywords when asking a question to help define your search. This reference lists the various keywords.

< Back to English Keywords page

You can only use one set of keywords at a time. If you set your locale to English (New Zealand), you can only use English (New Zealand) keywords. You can’t also use English keywords, or any other language. ThoughtSpot doesn’t translate its branded terms, such as Liveboard, SpotIQ, and so on.

General

When using the top or bottom keywords without specifying a number (n), the number defaults to 10.
top n

Generates the top n items from a sorted result. If your search has more than 1 measure, ThoughtSpot generates the top n items from the first measure in the search.

If you enter multiple measures in your search, ThoughtSpot sorts by the first measure. For example, if you search for top 3 sales by product quantity purchased, ThoughtSpot sorts by sales. If you change the search to sort by a different column, such as top 3 sales by product sort by quantity purchased, ThoughtSpot sorts by quantity purchased but preserves the top three ranked by sales.

If you search for "top n by <column>", ThoughtSpot sorts by the column, then takes the top n results. If you specify an attribute column, ThoughtSpot selects the results by reverse alphabetical order. We recommend using measure columns with the "top n by" keyword.

Examples
top 10 sales rep revenue

top sales rep by count sales for average revenue > 10000

sales rep average revenue for each region top
English (NZ)

top n

top n …​ ranked by

Ranks the top n items by a specified measure. The ranked by keyword only works in conjunction with the top keyword. If your search has more than 1 measure, ThoughtSpot generates the top n items from the first measure in the search.

Examples
top 10 sales rep revenue sales ranked by sales

top customer revenue generated # of ads clicked ranked by # of ads clicked
English (NZ)

top n …​ ranked by

bottom n

Generates the bottom n items from a sorted result.

Examples
bottom 25 customer by revenue for each sales rep

bottom revenue average

bottom revenue by state

customer by revenue for each sales rep bottom
English (NZ)

bottom n

sort by

Sorts the result set by an attribute or measure.

Examples
revenue by state sort by average revenue descending

revenue by customer sort by region sort by state
English (NZ)

sort by

by measure

Treats the measure as an attribute and groups the result set by it.

Examples
cost by revenue

product by quantity purchased
English (NZ)

by

Date

The last keyword returns the last n full periods and does not include the current period. For example, last 6 hours returns the last 6 full hours and does not include the current hour. To include the current period, add this <period>. For example, last 6 hours this hour.
after
Example
order date after 10/31/2014
English (NZ)

after

April
Example
sales April
English (NZ)

April

August
Example
sales August
English (NZ)

August

before
Example
order date before 03/01/2014
English (NZ)

before

between ... and ...
Example
order date between 01/30/2012 and 01/30/2014
English (NZ)

between …​ and …​

daily
Example
shipments by region daily
English (NZ)

daily

daily year-over-year
Example
growth of revenue by order date daily year-over-year
English (NZ)

daily year-over-year

day
Example
revenue by day
English (NZ)

day

day of week
Example
revenue by day of week last 6 months
English (NZ)

day of week

day of week
Example
count shipments Monday
English (NZ)

day of week

December
Example
sales December
English (NZ)

December

February
Example
sales February
English (NZ)

February

Friday
Example
sales Friday
English (NZ)

Friday

growth of …​ by ...
Example
growth of sales by order date
English (NZ)

growth of…​ by …​

growth of …​ by …​ daily
Example
growth of sales by order date daily
English (NZ)

growth of … by … daily

growth of …​ by …​ monthly
Example
growth of sales by date shipped monthly sales > 24000
English (NZ)

growth of … by … monthly

growth of …​ by …​ quarterly
Example
growth of sales by date shipped quarterly
English (NZ)

growth of … by … quarterly

growth of …​ by …​ weekly
Example
growth of sales by receipt date weekly for pro-ski2000
English (NZ)

growth of … by … weekly

growth of …​ by …​ yearly
Example
growth of sales by date closed yearly
English (NZ)

growth of … by … yearly

January
Example
sales January
English (NZ)

January

July
Example
sales July
English (NZ)

July

June
Example
sales June
English (NZ)

June

last day by
Example
customers last day by referrer
English (NZ)

last day by

last month by
Example
customers last month by day
English (NZ)

last month by

last n days
Example
visitors last 7 days
English (NZ)

last n days

last n days for each month
Example
sales last 2 days for each month
English (NZ)

last n days for each month

last n days for each quarter
Example
revenue last 15 days for each quarter
English (NZ)

last n days for each quarter

last n days for each week
Example
total sold last 2 days for each week
English (NZ)

last n days for each week

last n days for each year
Example
revenue last 300 days for each year
English (NZ)

last n days for each year

last n hours for each day
Example
sales last 2 hours for each day
English (NZ)

last n hours for each day

last n months for each quarter
Example
cost last 2 months for each quarter
English (NZ)

last n months for each quarter

last n months for each year
Example
last 8 months for each year
English (NZ)

last n months for each year

last n quarters
Example
visitors last 2 quarters by month by campaign
English (NZ)

last n quarters

last n quarters for each year
Example
last 2 quarters for each year
English (NZ)

last n quarters for each year

last n weeks
Example
visitors last 10 weeks by day
English (NZ)

last n weeks

last n weeks for each month
Example
sales last 3 weeks for each month
English (NZ)

last n weeks for each month

last n weeks for each quarter
Example
last 2 weeks for each quarter
English (NZ)

last n weeks for each quarter

last n weeks for each year
Example
last 3 weeks for each year
English (NZ)

last n weeks for each year

last n years
Example
visitors last 5 years by revenue for sum revenue > 5000
English (NZ)

last n years

last quarter
Example
customers last quarter sale > 300
English (NZ)

last quarter

last week
Example
customers last week by store
English (NZ)

last week

last year
Example
top 10 customers last year by sale by store for region west
English (NZ)

last year

March
Example
sales March
English (NZ)

March

May
Example
sales May
English (NZ)

May

Monday
Example
sales Monday
English (NZ)

Monday

month
Example
revenue by month last year
English (NZ)

month

month
Example
commission January
English (NZ)

month

month to date
Example
sales by product month to date sales > 2400
English (NZ)

month to date

month year
Example
commission by sales rep February 2014
English (NZ)

month year

monthly
Example
commission monthly
English (NZ)

monthly

monthly year-over-year
Example
growth of revenue
  by receipt date
  monthly year-over-year
English (NZ)

monthly year-over-year

n days ago
Example
sales 2 days ago
English (NZ)

n days ago

n months
Example
visitors last 6 months for homepage visits > 30 by month
English (NZ)

n months

n months ago
Example
sales 2 months ago by region
English (NZ)

n months ago

n quarters ago
Example
sales 4 quarters ago by product name contains deluxe
English (NZ)

n quarters ago

n weeks ago
Example
sales 4 weeks ago by store
English (NZ)

n weeks ago

n years
Example
opportunities next 5 years by revenue
English (NZ)

n years

n years ago
Example
sales 5 years ago by store for region west
English (NZ)

n years ago

next day
Example
shipments next day by order
English (NZ)

next day

next month
Example
appointments next month by day
English (NZ)

next month

next n days
Example
shipments next 7 days
English (NZ)

next n days

next n months
Example
openings next 6 months location
English (NZ)

next n months

next n quarters
Example
opportunities next 2 quarters by campaign
English (NZ)

next n quarters

next n weeks
Example
shipments next 10 weeks by day
English (NZ)

next n weeks

next quarter
Example
opportunities next quarter amount > 30000
English (NZ)

next quarter

next week
Example
shipments next week by store
English (NZ)

next week

next year
Example
opportunities next year by sales rep
English (NZ)

next year

November
Example
sales November
English (NZ)

November

October
Example
sales October
English (NZ)

October

on or after
Example
order date on or after 10/31/2014
English (NZ)

on or after

on or before
Example
order date on or before 03/01/2014
English (NZ)

on or before

quarter to date
Example
sales by product quarter to date
  for top 10 products by sales
English (NZ)

quarter to date

quarterly
Example
sales quarterly for each product
English (NZ)

quarterly

quarterly year-over-year
Example
growth of revenue by date shipped
quarterly year-over-year
English (NZ)

quarterly year-over-year

Saturday
Example
sales Saturday
English (NZ)

Saturday

September
Example
sales September
English (NZ)

September

Sunday
Example
sales Sunday
English (NZ)

Sunday

this day
Example
shipments this day by order
English (NZ)

this day

this month
Example
appointments this month by day
English (NZ)

this month

this quarter
Example
opportunities this quarter amount > 30000
English (NZ)

this quarter

this week
Example
shipments this week by store
English (NZ)

this week

this year
Example
opportunities this year by sales rep
English (NZ)

this year

Thursday
Example
sales Thursday
English (NZ)

Thursday

today
Example
sales today by store
English (NZ)

today

Tuesday
Example
sales Tuesday
English (NZ)

Tuesday

Wednesday
Example
sales Wednesday
English (NZ)

Wednesday

week
Example
revenue by week last quarter
English (NZ)

week

week to date
Example
sales by order date week to date for pro-ski200
English (NZ)

week to date

weekly
Example
revenue weekly
English (NZ)

weekly

weekly year-over-year
Example
growth of revenue by date shipped
  weekly year-over-year
English (NZ)

weekly year-over-year

year
Example
revenue by product 2014 product name contains snowboard
English (NZ)

year

year to date
Example
sales by product year to date
English (NZ)

year to date

yearly
Example
shipments by product yearly
English (NZ)

yearly

yesterday
Example
sales yesterday for pro-ski200 by store
English (NZ)

yesterday

Time

The last keyword returns the last n full periods and does not include the current period. For example, last 6 hours returns the last 6 full hours and does not include the current hour. To include the current period, add this <period>. For example, last 6 hours this hour.
detailed
Example
ship time detailed
English (NZ)

detailed

hourly
Example
visitors by page name hourly
English (NZ)

hourly

hour of day
Example
visitors by page name hour of day
English (NZ)

hour of day

last hour
Example
count unique visits last hour
English (NZ)

last hour

last minute
Example
count homepage views last minute
English (NZ)

last minute

last n hours
Example
sales last 2 hours
English (NZ)

last n hours

last n minutes
Example
count homepage views last 30 minutes
English (NZ)

last n minutes

last n seconds
Example
count homepage views last 30 seconds
English (NZ)

last n seconds

last second
Example
count homepage views last second
English (NZ)

last second

n hours
Example
count visitors [ last | next ] 12 hours
English (NZ)

n hours

n hours ago
Example
sum inventory by product by store 2 hours ago
English (NZ)

n hours ago

n minutes
Example
count visitors [ last | next ] 30 minutes
English (NZ)

n minutes

n minutes ago
Example
sum inventory by product 10 minutes ago
English (NZ)

n minutes ago

n seconds
Example
count visitors [ last | next ] 30 seconds
English (NZ)

n seconds

n seconds ago
Example
sum inventory by product 10 seconds ago
English (NZ)

n seconds ago

next hour
Example
count projected visitors next hour
English (NZ)

next hour

next minute
Example
count projected visitors next minute
English (NZ)

next minute

next n hours
Example
count projected visitors next 2 hours
English (NZ)

next n hours

next n minutes
Example
count projected visitors next 30 minutes
English (NZ)

next n minutes

next n seconds
Example
count projected visitors next 30 seconds
English (NZ)

next n seconds

next second
Example
count projected visitors next second
English (NZ)

next second

this hour
Example
count visitors this hour
English (NZ)

this hour

this minute
Example
count visitors this minute
English (NZ)

this minute

this second
Example
count visitors this second
English (NZ)

this second

Text

begins with
Examples
product name begins with 'pro'

The preceding phrase returns all products that start with 'pro'. For example, this phrase might return pro sport set, but it wouldn’t return beginner sport set.

product name begins with 'pro' or 'sport'
OR
product name begins with 'pro' product name begins with 'sport'

The preceding phrases both return all products that start with 'pro' or 'sport'. For example, either of these phrases might return pro sport set or sport set, but they wouldn’t return beginner sport set.

product name begins with 'pro'
color begins with 'bl'

The preceding phrase returns all products that start with 'pro', if the product color also starts with 'bl'. For example, this phrase might return a blue pro sport set.

begins with phrases can’t be combined with and.

English (NZ)

begins with

contains
Examples
country name contains 'a' or 'b'
OR
country name contains 'a' country name contains 'b'

The preceding phrases both return country names that contain the letter a and country names that contain the letter b. For example, either of these phrases might return North America.

If your query includes two or more contains phrases that modify the same column, ThoughtSpot combines the phrases using or logic. Prior to ThoughtSpot version 9.2.0.cl, ThoughtSpot combined these phrases using and logic. If you have existing Answers or visualizations using this and logic, ThoughtSpot will automatically update your queries after you upgrade to 9.2.0.cl, to ensure they return the same information. 
country name contains 'a' and 'b'

The preceding phrase returns only country names that contain both the letter a and the letter b. For example, this phrase might return Azerbaijan, but it wouldn’t return North America.

English (NZ)

contains

ends with
Examples
product name ends with 'deluxe'

The preceding phrase returns product names that end with 'deluxe'. For example, this phrase might return bath towels deluxe, but it wouldn’t return deluxe bath towels.

product name ends with 'deluxe' or 'luxury'
OR
product name ends with 'deluxe' product name ends with 'luxury'

The preceding phrases both return product names that end with 'deluxe' or 'luxury'. For example, either of these phrases might return bath towels deluxe or bath towels luxury, but they wouldn’t return deluxe bath towels.

ends with phrases can’t be combined with and.

English (NZ)

ends with

similar to
Examples
product name similar to 'jacket'

The preceding phrase returns all products that contain text similar to 'jacket'. For example, this phrase might return jean jacket men’s, but it wouldn’t return t-shirt.

product name similar to 'jacket' or 't-shirt'
OR
product name similar to 'jacket' product name similar to 't-shirt'

The preceding phrases both return all products that contain text similar to 'jacket' or 't-shirt'. For example, either of these phrases might return jean jacket men’s or white t-shirt, but they wouldn’t return green hat.

similar to phrases can’t be combined with and.

English (NZ)

similar to

not begins with
Examples
product name not begins with 'pro'

The preceding phrase returns all products that do not start with 'pro'. For example, this phrase might return beginner sport set, but it wouldn’t return pro sport set.

product name not begins with 'pro' or 'sport'
OR
product name not begins with 'pro' product name not begins with 'sport'

The preceding phrases both return all products that do not start with 'pro' and do not start with 'sport'. For example, either of these phrases might return beginner sport set, but they wouldn’t return pro sport set or sport set.

English (NZ)

not begins with

not contains
Examples
country name not contains 'a' country name not contains 'b'
OR
country name not contains 'a' or 'b'

The preceding phrases both return country names that do not contain the letter a or the letter b. For example, either of these phrases might return Yemen, but they wouldn’t return North America or Azerbaijan.

country name not contains 'a' and 'b'

The preceding phrase returns country names that contain neither the letter a nor the letter b. For example, this phrase would return North America, but not Azerbaijan.

English (NZ)

not contains

not ends with
Examples
product name not ends with 'luxury'

The preceding phrase returns all products that do not end with 'luxury'. For example, this phrase might return bath towels basic, but it wouldn’t return bath towels luxury.

product name not ends with 'luxury' or 'deluxe'
OR
product name not ends with 'luxury' product name not ends with 'deluxe'

The preceding phrases both return all products that do not end with 'luxury' and do not end with 'deluxe'. For example, either of these phrases might return bath towels basic, but they wouldn’t return bath towels luxury or bath towels deluxe.

English (NZ)

not ends with

not similar to
Example
product name not similar to 'jacket'

The preceding phrase returns all products that do not contain text that is similar to 'jacket'. For example, this phrase might return t-shirt, but it wouldn’t return jean jacket men’s.

product name not similar to 'jacket' or 't-shirt'
OR
product name not similar to 'jacket' product name not similar to 't-shirt'

The preceding phrases both return all products that do not contain text similar to 'jacket' and do not contain text similar to 't-shirt'. For example, either of these phrases might return green hat, but they wouldn’t return jean jacket men’s or t-shirt.

English (NZ)

not similar to

Number

average
Example
average revenue by store
English (NZ)

average

count
Example
count visitors by site
English (NZ)

count

max
Example
max sales by visitor by site
English (NZ)

max

min
Example
min revenue by store by campaign for cost > 5000
English (NZ)

min

standard deviation
Example
standard deviation revenue by product by month for date after
10/31/2010
English (NZ)

standard deviation

sum
Example
sum revenue
English (NZ)

sum

unique count
Example
unique count visitor by product page last week
English (NZ)

unique count

variance
Example
variance sale amount by visitor by product for last year
English (NZ)

variance

Comparative

all
Example
revenue asia vs all
The all keyword can only be used as part of a versus phrase.
English (NZ)

all

between... and...
Example
revenue between 0 and 1000
English (NZ)

between

= (equal)
Example
unique count visitor by store purchased products = 3 for last 5
days

You can use special constants for null and empty values with the = and != keywords: {null} and {empty}. For example: customer name = {empty} or department != {null}. NULL values are missing or invalid (for example, dividing by 0) values. ThoughtSpot also shows NULL if you have n/a in your data. Empty values are empty strings of text or strings containing only whitespace (spaces, tabs).

English (NZ)

=

everything
Example
revenue asia vs everything
The everything keyword can only be used as part of a versus phrase.
English (NZ)

everything

> (greater than)
Example
sum sale amount by visitor by product for last year sale amount > 2000
English (NZ)

>

>= (greater than or equal)
Example
count calls by employee lastname >= 'm'
English (NZ)

>=

< (less than)
Example
unique count visitor by product by store for sale amount < 20
English (NZ)

<

<= (less than or equal)
Example
count shipments by city latitude <= 0
English (NZ)

<=

!= (not equal)
Example
sum sale amount region != canada date != last 5 days

You can use special constants for null and empty values with the = and != keywords: {null} and {empty}. For example: customer name = {empty} or department != {null}. NULL values are missing or invalid (for example, dividing by 0) values. ThoughtSpot also shows NULL if you have n/a in your data. Empty values are empty strings of text or strings containing only whitespace (spaces, tabs).

English (NZ)

!=

vs, versus
Example
revenue east vs west
state name begins_with 'a' state name begins_with 'c' vs state name begins_with 'd'
ThoughtSpot supports use of multiple contains, begins_with, and ends_with phrases in vs queries. For example, you can now have a versus query such as [state name begins_with 'a'] [state name begins_with 'c'] [vs] [state name begins_with 'd']. For multiple begins_with or ends_with phrases on the same side of the versus query, ThoughtSpot will combine them using OR. For multiple contains phrases on the same side of the versus query, ThoughtSpot will combine them using OR or AND, depending on the behavior set in your environment.
ThoughtSpot doesn’t support the use of group_* formula measures with the vs keyword. ThoughtSpot doesn’t support the use of the vs keyword within an in or not in subquery.
English (NZ)

versus, vs

You can use special constants for null and empty values with the = and != keywords: {null} and {empty}. For example: customer name = {empty} or department != {null}. NULL values are missing or invalid (for example, dividing by 0) values. ThoughtSpot also shows NULL if you have n/a in your data. Empty values are empty strings of text or strings containing only whitespace (spaces, tabs).

Location

Location keywords only work for searches where the data source includes latitude/longitude data.
farther than n miles|km|meters from …​
Example
average hours worked branch farther than 80 km from scarborough
English (NZ)

further than n miles|km|meters from

near
Example
revenue store name county near san francisco
English (NZ)

near

near …​ within n miles|km|meters
Example
revenue store name county near alameda within 50 miles
English (NZ)

near …​ within n miles|km|meters

Period

day
Example
orders by day
English (NZ)

day (date)

day of month
Example
sales day of month by month
English (NZ)

day of month (date)

day of quarter
Example
deals day of quarter by year
English (NZ)

day of quarter (date)

day of week
Example
customers by week day of week
English (NZ)

day of week (date)

day of year
Example
ad clicks day of year by year
English (NZ)

day of year (date)

hour
Example
visitors by hour weekly
English (NZ)

hour (datetime)

month of quarter
Example
purchases month of quarter by year
English (NZ)

month of quarter (date)

quarter
Example
purchases by quarter
English (NZ)

quarter (date)

quarter of year
Example
opportunities quarter of year last 4 years yearly
English (NZ)

quarter of year (date)

week of month
Example
product shipments week of month yearly
ThoughtSpot uses ISO week format for the week of [month | quarter | year] keywords, which means that the last few days of a quarter may sometimes show as the first few days of the next quarter, based on the ISO week date system.  
English (NZ)

week of month (date)

week of quarter
Example
revenue week of quarter
ThoughtSpot uses ISO week format for the week of [month | quarter | year] keywords, which means that the last few days of a quarter may sometimes show as the first few days of the next quarter, based on the ISO week date system.
English (NZ)

week of quarter (date)

week of year
Example
new products week of year last 3 years yearly
ThoughtSpot uses ISO week format for the week of [month | quarter | year] keywords, which means that the last few days of a quarter may sometimes show as the first few days of the next quarter, based on the ISO week date system.
English (NZ)

week of year (date)

In / Not in

in

Query in query search (intersection of two sets). Must match last attribute before keyword with first attribute inside subsearch. Doesn’t support use of the vs keyword.

Syntax
attribute in (attribute subsearch)
Examples
store name in (top 10 store name by sales footwear)

product name 2014 product name in (product name 2013) sales
English (NZ)

in

not in

Relative complement of two sets. Must match last attribute before keyword with first attribute inside subsearch. Doesn’t support use of the vs keyword.

Syntax
attribute not in (attribute subsearch)
Example
product name 2014 product name not in (product name 2013) sales

Find sales for all products ordered in 2014 that were not ordered in 2013

English (NZ)

not in

Was this page helpful?
×