文档 插件 Oracle 数据源 Oracle 模板和变量

Oracle 模板和变量

您可以使用变量，而无需在指标查询中硬编码服务器、应用程序和传感器名称等详细信息。Grafana 在仪表盘顶部的下拉选择框中列出这些变量，帮助您更改仪表盘中显示的数据。Grafana 将此类变量称为 template 变量。

有关如何创建变量的说明，请参阅变量和添加查询变量。使用 Oracle 作为数据源。

在以下文档中阅读更多关于模板和变量的信息

• 模板
• 添加和管理变量
• 变量语法

变量示例

Oracle 查询返回结果，例如度量名称、键名称或键值，这些结果会作为选项显示在下拉选择框中。

示例

您可以创建一个变量，其中包含 host 表中 hostname 列的所有值。

sql 复制

SELECT hostname FROM host

一个查询可以返回多列，Grafana 会自动从这些列中创建一个列表。例如，以下查询检索包含 hostname 和 hostname2 值的列表。

sql 复制

SELECT host.hostname, other_host.hostname2 
FROM host 
JOIN other_host ON host.city = other_host.city

要在查询中使用依赖于时间范围的宏，例如 $__timeFilter(column)，请将模板变量的刷新模式设置为 On Time Range Change（时间范围更改时）。

sql 复制

SELECT event_name 
FROM event_log 
sWHERE $__timeFilter(time_column)

您可以编写一个查询来创建键/值变量。该查询返回两列，一列名为 __text，另一列名为 __value。__text 列的值应该是唯一的。如果 __text 中存在重复项，则只使用第一个值。下拉选项将 __text 显示为名称，将 __value 显示为 ID。下面的查询将主机名设置为 text，将 id 设置为 value

sql 复制

SELECT hostname AS __text, id AS __value 
FROM host

您还可以创建嵌套变量。您可以创建一个名为 region 的变量，并使用以下查询让 hosts 变量只显示当前选定区域的主机

sql 复制

SELECT hostname 
FROM host 
WHERE region = '$region'

如果 region 是一个多值变量，则使用 IN 比较运算符而不是 = 来匹配多个值。

创建变量后，您可以按照变量语法在 Oracle 查询中使用它。

环境变量

最大响应大小

您可以在环境变量中设置 GF_PLUGINS_ORACLE_DATASOURCE_MAX_RESPONSE_SIZE 来更改查询响应数据大小。默认值为 16，最大值为 512。

复制

export GF_PLUGINS_ORACLE_DATASOURCE_MAX_RESPONSE_SIZE=<number>

连接池大小

您可以在环境变量中设置 GF_PLUGINS_ORACLE_DATASOURCE_POOLSIZE 来更改连接池大小。默认值为 50

复制

export GF_PLUGINS_ORACLE_DATASOURCE_POOLSIZE=<number>