Update QUERIES.md
Add note at the top about names of things. Update Destroy examples. Finish updates to the list series queries.pull/1200/merge
parent
8d57611dd7
commit
a4af65ae9d
24
QUERIES.md
24
QUERIES.md
|
@ -1,3 +1,5 @@
|
|||
The top level name is called a measurement. These names can contain any characters. Then there are field names, field values, tag keys and tag values, which can also contain any characters. Because of this, anywhere a measurement name, field name, field value, tag name, or tag value appears should be able to get wrapped in double quotes to deal with special characters.
|
||||
|
||||
# Select
|
||||
|
||||
```sql
|
||||
|
@ -16,7 +18,10 @@ SELECT top(10, value), distinct(host) FROM cpu WHERE time > now() - 1h
|
|||
|
||||
## Destroy
|
||||
|
||||
DROP SERIES <name>
|
||||
```sql
|
||||
DROP MEASUREMENT <name>
|
||||
DROP MEASUREMENT cpu WHERE region = 'uswest'
|
||||
```
|
||||
|
||||
## List
|
||||
|
||||
|
@ -33,23 +38,16 @@ LIST SERIES WHERE region = 'uswest'
|
|||
LIST KEYS
|
||||
|
||||
-- list all the tag keys for a given measurement
|
||||
LIST KEYS WHERE measurement = 'cpu'
|
||||
LIST KEYS WHERE measurement = 'temperature' or measurement = 'wind_speed'
|
||||
LIST KEYS FROM cpu
|
||||
LIST KEYS FROM temperature, wind_speed
|
||||
|
||||
-- list all the tag values. note that at least one WHERE key = '...' clause is required
|
||||
LIST VALUES WHERE key = 'region'
|
||||
LIST VALUES WHERE measurement = 'cpu' and region = 'uswest' and key = 'host'
|
||||
|
||||
-- or maybe like this?
|
||||
LIST VALUES("host") WHERE measurement = 'cpu'
|
||||
-- or?
|
||||
LIST host WHERE measurement = 'cpu'
|
||||
-- or just use the select syntax
|
||||
SELECT DISTINCT("host") from cpu
|
||||
-- but then it would be tricky to show all values of host across
|
||||
-- all measurements, which we need to be able to do
|
||||
LIST VALUES FROM cpu WHERE region = 'uswest' and key = 'host'
|
||||
```
|
||||
|
||||
Note that `FROM` and `WHERE` are optional clauses in all of the list series queries.
|
||||
|
||||
And the list series output looks like this:
|
||||
|
||||
```json
|
||||
|
|
Loading…
Reference in New Issue