查詢參數

查詢參數在運行時可以把值代入一個查詢。雙花括號之間的任何字符串{{}}被視為一個查詢參數。小部件出現上述結果窗格設置參數值。查詢參數比查詢過濾器、更靈活的情況下,應該隻用於查詢過濾器是不夠的。

添加一個查詢參數

  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}}”