文档 插件 CSV 数据源 查询编辑器

本页解释了查询编辑器的每个部分的作用以及如何配置它。

CSV 数据源的查询编辑器由多个选项卡组成。每个选项卡配置查询的一部分。

字段

字段选项卡用于配置如何解析数据源配置中 URL 返回的数据。

• 分隔符 定义了文件中列的分隔方式。
• 小数点分隔符 定义了用于分隔数字整数部分和小数部分的字符。
• 跳过开头行 允许您忽略数据开头的一些行。如果您的数据在实际数据之前包含注释、文档或其他信息，这会很有用。
• 头部 告诉 Grafana 第一行是否包含每列的名称。
• 忽略未知字段 切换是否显示模式中未定义的列。如果您只对少数几列感兴趣，这会很有用。

默认情况下，CSV 数据中的所有列都视为文本。如果您想将某列解析为特定类型（例如时间或数字），您需要定义一个模式。

• 字段 引用了 CSV 数据中的一列。如果不存在头部，您可以通过其顺序引用列，例如“字段 1”。
• 类型 定义了列的类型。如果类型不是字符串，数据源会尝试将数据解析为指定的类型。任何无法解析的值都将被忽略。

路径

此选项卡的内容取决于数据源是设置为 HTTP 模式还是本地模式。在这两种情况下，路径都是相对于数据源 URL 的。

HTTP

左侧的下拉框允许您配置发送到 URL 的请求的 HTTP 方法，可以设置为 GET 和 POST。

文本框允许您在数据源配置中的 URL 后附加一个路径。这可以用于通过变量动态更改请求 URL。

例如，通过将路径设置为 /movies/${movie}/summary，您可以查询任何电影的摘要，而无需更改查询本身。

本地

相对路径 允许您在数据源配置中的路径后附加一个相对路径。例如，通过将数据源配置中的路径设置为一个目录，然后使用相对路径加载该目录内的文件，您可以使用同一个数据源加载多个文件。

参数

仅在 HTTP 模式下可用。

添加您希望作为查询字符串一部分发送的任何参数。例如，截图中显示的参数会被编码为 ?category=movies。

键和值字段都支持变量。

:::caution 管理员在数据源配置中设置的任何查询参数具有更高的优先级，并会覆盖查询设置的参数。::

头部

仅在 HTTP 模式下可用。

添加您希望作为 HTTP 头部发送的任何参数。

键和值字段都支持变量。

请求体

仅在 HTTP 模式下可用。

设置作为请求体发送的文本。

• 语法高亮设置编辑器当前使用的语法。这仅用于视觉效果，不会改变实际请求。

:::info 由于现代浏览器的限制，如果 HTTP 方法设置为 GET，Grafana 将忽略请求体。::

实验性

试用当前正在开发中的功能。每个功能的工具提示中都有一个链接，可将您带到 GitHub 上的功能请求页面，您可以在那里分享您的反馈。

:::danger 实验性功能可能不稳定，并且可能在不通知的情况下被移除。::

• 启用正则表达式允许您在模式中使用正则表达式作为字段名称。这允许您为任何匹配表达式的字段设置类型。