import { css } from '@emotion/css';
import { GrafanaTheme2 } from '@grafana/data';
import { Trans } from '@grafana/i18n';
import { useStyles2 } from '@grafana/ui';
export function CheatSheet() {
const styles = useStyles2(getStyles);
return (
MSSQL cheat sheet
Time series:
-
return column named time (in UTC), as a unix time stamp or any sql native date data type. You can use the
macros below.
-
any other columns returned will be the time point values.
Optional:
-
return column named {'{{columnName}}'} to represent the series name.
-
If multiple value columns are returned the {'{{columnName}}'} column is used as prefix.
-
If no column named {'{{columnName}}'} 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:
{/* eslint-disable @grafana/i18n/no-untranslated-strings */}
- $__time(column) -> column AS time
- $__timeEpoch(column) -> DATEDIFF(second, '1970-01-01', 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]) -> CAST(ROUND(DATEDIFF(second, '1970-01-01',
column)/300.0, 0) as 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'[, fillvalue]) -> CAST(ROUND(DATEDIFF(second,
'1970-01-01', column)/300.0, 0) as bigint)*300 AS [time]
- $__unixEpochGroup(column,'5m') -> FLOOR(column/300)*300
- $__unixEpochGroupAlias(column,'5m') -> FLOOR(column/300)*300 AS [time]
{/* eslint-enable @grafana/i18n/no-untranslated-strings */}
Example of group by and order by with {'{{timeGroupMacro}}'}:
{/* eslint-disable @grafana/i18n/no-untranslated-strings */}
SELECT $__timeGroup(date_time_col, '1h') AS time, sum(value) as value
FROM yourtable
GROUP BY $__timeGroup(date_time_col, '1h')
ORDER BY 1
{/* eslint-enable @grafana/i18n/no-untranslated-strings */}
Or build your own conditionals using these macros which just return the values:
{/* eslint-disable @grafana/i18n/no-untranslated-strings */}
- $__timeFrom() -> '2017-04-21T05:01:17Z'
- $__timeTo() -> '2017-04-21T05:01:17Z'
- $__unixEpochFrom() -> 1492750877
- $__unixEpochTo() -> 1492750877
- $__unixEpochNanoFrom() -> 1494410783152415214
- $__unixEpochNanoTo() -> 1494497183142514872
{/* eslint-enable @grafana/i18n/no-untranslated-strings */}
);
}
function getStyles(theme: GrafanaTheme2) {
return {
ulPadding: css({
margin: theme.spacing(1, 0),
paddingLeft: theme.spacing(5),
}),
};
}