import { css } from '@emotion/css';
import { GrafanaTheme2 } from '@grafana/data';
import { useStyles2 } from '@grafana/ui';
export function CheatSheet() {
const styles = useStyles2(getStyles);
return (
PostgreSQL cheat sheet
Time series:
-
return column named time (UTC in seconds or timestamp)
- return column(s) with numeric datatype as values
Optional:
-
return column named metric to represent the series name.
- If multiple value columns are returned the metric column is used as prefix.
- If no column named metric is found the column name of the value column is used as series name
Resultsets of time series queries need to be sorted by time.
Table:
- return any set of columns
Macros:
- $__time(column) -> column as "time"
- $__timeEpoch -> extract(epoch from column) as "time"
-
$__timeFilter(column) -> column BETWEEN '2017-04-21T05:01:17Z' AND
'2017-04-21T05:01:17Z'
- $__unixEpochFilter(column) -> column >= 1492750877 AND column <= 1492750877
-
$__unixEpochNanoFilter(column) -> column >= 1494410783152415214 AND column <= 1494497183142514872
-
$__timeGroup(column,'5m'[, fillvalue]) -> (extract(epoch from column)/300)::bigint*300 by setting
fillvalue grafana will fill in missing values according to the interval fillvalue can be either a literal
value, NULL or previous; previous will fill in the previous seen value or NULL if none has been seen yet
-
$__timeGroupAlias(column,'5m') -> (extract(epoch from column)/300)::bigint*300 AS
"time"
- $__unixEpochGroup(column,'5m') -> floor(column/300)*300
- $__unixEpochGroupAlias(column,'5m') -> floor(column/300)*300 AS "time"
Example of group by and order by with $__timeGroup:
SELECT $__timeGroup(date_time_col, '1h'), sum(value) as value
FROM yourtable
GROUP BY time
ORDER BY time
Or build your own conditionals using these macros which just return the values:
- $__timeFrom() -> '2017-04-21T05:01:17Z'
- $__timeTo() -> '2017-04-21T05:01:17Z'
- $__unixEpochFrom() -> 1492750877
- $__unixEpochTo() -> 1492750877
- $__unixEpochNanoFrom() -> 1494410783152415214
- $__unixEpochNanoTo() -> 1494497183142514872
);
}
function getStyles(theme: GrafanaTheme2) {
return {
ulPadding: css({
margin: theme.spacing(1, 0),
paddingLeft: theme.spacing(5),
}),
};
}