查询参数

查询参数在运行时可以把值代入一个查询。双花括号之间的任何字符串{{}}被视为一个查询参数。小部件出现上述结果窗格设置参数值。查询参数比查询过滤器、更灵活的情况下,应该只用于查询过滤器是不够的。

添加一个查询参数

  1. 类型Cmd+。参数是在文本插入符号和插入添加参数对话框出现了。

    • 关键字表示参数:关键字查询。

    • 标题:出现在小部件的标题。默认情况下,标题与关键字相同。

    • 类型:支持类型是文本、数字、日期、日期和时间,日期和时间(秒),下拉列表,和基于查询的下拉列表。默认是文本。

  2. 输入关键字,选择覆盖标题和选择的参数类型。

  3. 点击添加参数

  4. 在参数小部件,设置参数值。

  5. 点击申请更改

  6. 点击保存

另外,类型双花括号{{}},点击齿轮图标附近小部件的参数编辑设置。

重新运行查询使用不同的参数值,输入小部件中的值并单击申请更改

编辑查询参数

要编辑一个参数,点击齿轮图标旁边的小部件的参数。为了防止用户没有查询更改参数,点击显示结果。的<关键词>参数对话框。

改变参数的顺序

改变参数的顺序显示,您可以单击并拖动每个参数所需的位置。

查询参数类型

文本

接受一个字符串作为输入。反斜杠,单引号和双引号都逃脱了,和砖加引号的这个参数。例如,一个字符串先生的李的是改变了‘先生’s李\“年代”使用这个可以的一个例子

选择*用户在哪里的名字={{text_param}}

数量

数字作为输入。使用这个可以的一个例子

选择*用户在哪里年龄={{number_param}}

基于查询的下拉列表中

需要一个查询的结果作为输入。它作为下拉列表参数具有相同的行为。你必须保存数据砖SQL查询下拉列表中为使用它作为输入另一个查询。

  1. 点击基于查询的下拉列表中类型在设置面板。

  2. 单击查询字段和选择一个查询。如果你的目标查询返回大量的记录性能将会降低。

如果你的目标查询返回多个列,砖SQL使用了第一个一个。如果你的目标查询返回的名字价值列,砖SQL填充的参数选择小部件的名字但执行查询相关的列价值

例如,假设以下查询返回表中的数据。

选择user_uuid作为“价值”,用户名作为“名字”用户

价值

的名字

1001年

约翰。史密斯

1002年

简母鹿

1003年

鲍比表

砖运行查询时,传递给数据库的值是1001,1002,或1003。

日期和时间

砖提供了许多选项来参数化的日期和时间戳值,包括简化参数选择的时间范围。选择不同精度的三个选项:

选项

精度

类型

日期

一天

日期

日期和时间

一分钟

时间戳

日期和时间(秒)

第二个

时间戳

当你选择范围指定的参数选项,您将创建两个参数.start.end后缀。所有选项将参数传递给您的查询字符串;砖要求您的包装日期和时间值在单引号()。例如:

——日期参数选择*usage_logs在哪里日期=“{{date_param}}”——日期和时间参数范围选择*usage_logs在哪里modified_time>{{date_range。开始}}modified_time<{{date_range。结束}}’

使用日历日期参数选择界面,默认为当前日期和时间。

请注意

日期范围参数列只返回正确的结果日期类型。为时间戳列,使用一个日期和时间范围的选择。

动态日期和日期范围值

当你添加一个日期或日期范围参数查询,选择小部件显示一个蓝色的闪电图标。单击它以显示动态值今天,昨天,,去年,去年,或去年一年。这些值动态更新。

重要的

动态日期和日期范围不兼容计划查询。

在仪表板中使用查询参数

可选地,可以利用查询参数或静态值。当一个可视化基于参数化查询添加到仪表板,可视化可以配置为使用:

  • 小部件参数

    部件参数特定于一个可视化在仪表板,出现在可视化面板,仅适用于指定的参数值查询的可视化。

  • 指示板参数

    仪表板参数可以适用于多个可视化。当你添加一个可视化仪表板基于参数化查询,默认参数将作为一个仪表板添加参数。仪表板参数配置为一个或多个可视化在仪表板和仪表板的顶部出现。仪表板参数指定的参数值应用到可视化重用这个指示板参数。仪表板仪表盘可以有多个参数,每一个都可以申请一些可视化和其他可视化。

  • 静态值

    使用静态值代替一个参数响应变化。静态值允许你硬编码值的一个参数,将参数“消失”从仪表板或小部件之前出现。

当你添加一个包含参数化的可视化查询时,您可以选择标题和源参数的可视化查询通过单击适当的铅笔图标。你也可以选择关键字和一个默认值。看到参数属性

添加一个可视化仪表板后,访问参数映射界面通过点击右上角的垂直省略一个仪表板部件然后点击修改小部件设置

参数属性

  • 标题:显示名称显示在仪表板的值选择器旁边。它默认参数关键字。编辑,点击铅笔图标铅笔图标。标题不显示静态仪表板参数,因为值选择器是隐藏的。如果您选择静态值作为你的价值来源然后标题字段是灰色的。

  • 关键字:这个参数的字符串在底层查询。这是用于调试如果仪表板不返回预期的结果。

  • 默认值:如果没有指定其他值使用的价值。改变这个从查询屏幕,执行查询与你想要的参数值并单击保存按钮。

  • 价值来源:参数值的来源。点击铅笔图标铅笔图标选择一个源。

    • 新的仪表板参数:创建一个新的dashboard-level参数。这允许您设置一个参数值在一个地方在仪表板上并将其映射到多个可视化。

    • 现有的仪表板参数:参数映射到现有仪表板参数。你必须指定预先存在的仪表板参数。

    • 小部件参数:显示一个值选择器内部仪表板小部件。这是一次性的有用参数之间不共享小部件。

    • 静态值:选择一个小部件的静态值,无论在其他小部件使用的值。静态映射参数值不显示一个值选择器更紧凑的仪表盘上的任何地方。这使您能够利用的灵活性无需提供查询参数的用户界面仪表盘经常当某些参数不会改变。

    改变参数映射

常见问题(FAQ)

我可以多次重用相同的参数在一个查询?

是的。在花括号中使用相同的标识符。下面的例子使用了{{org_id}}参数两次。

选择{{org_id}},(0)查询在哪里org_id={{org_id}}

我可以在一个查询中使用多个参数?

是的。使用一个唯一的名称为每个参数。这个示例使用两个参数:{{org_id}}{{start_date}}

选择(0)查询在哪里org_id={{org_id}}created_at>“{{start_date}}”