查詢參數
查詢參數在運行時可以把值代入一個查詢。雙花括號之間的任何字符串{{}}
被視為一個查詢參數。小部件出現上述結果窗格設置參數值。查詢參數比查詢過濾器、更靈活的情況下,應該隻用於查詢過濾器是不夠的。
添加一個查詢參數
類型
Cmd+我
。參數是在文本插入符號和插入添加參數對話框出現了。關鍵字表示參數:關鍵字查詢。
標題:出現在小部件的標題。默認情況下,標題與關鍵字相同。
類型:支持類型是文本、數字、日期、日期和時間,日期和時間(秒),下拉列表,和基於查詢的下拉列表。默認是文本。
輸入關鍵字,選擇覆蓋標題和選擇的參數類型。
點擊添加參數。
在參數小部件,設置參數值。
點擊申請更改。
點擊保存。
另外,類型雙花括號{{}}
,點擊齒輪圖標附近小部件的參數編輯設置。
重新運行查詢使用不同的參數值,輸入小部件中的值並單擊申請更改。
查詢參數類型
文本
接受一個字符串作為輸入。反斜杠,單引號和雙引號都逃脫了,和磚加引號的這個參數。例如,一個字符串先生的李的
是改變了‘先生’s李\“年代”
使用這個可以的一個例子
選擇*從用戶在哪裏的名字={{text_param}}
下拉列表中
限製的範圍可能的參數值在運行查詢時,使用下拉列表中參數類型。一個例子是選擇*從用戶在哪裏name = " {{dropdown_param}}’
。從參數設置麵板中選擇時,會出現一個文本框輸入允許的值,每個值由一個新行。下拉列表是文本參數。使用日期或日期和時間在你的下拉列表,輸入您的數據源需要的格式。字符串不逃。你可以選擇一個單值或多值下拉。
單值:單引號的參數是必需的。
多值:切換允許多個值選擇。報價下拉,選擇是否包裝參數引用或使用單引號或雙引號。如果你選擇報價,你不需要添加引號參數。
在你的查詢,改變你在哪裏
使用條款在
關鍵字。
選擇…從…在哪裏場在({{多選擇參數}})
多重選擇小部件的參數允許您將多個值傳遞給數據庫。如果您選擇了雙引號選擇報價查詢參數,反映了以下格式:在哪裏在(“value1”,“value2”,“value3”)
基於查詢的下拉列表中
需要一個查詢的結果作為輸入。它作為下拉列表參數具有相同的行為。你必須保存數據磚SQL查詢下拉列表中為使用它作為輸入另一個查詢。
點擊基於查詢的下拉列表中下類型在設置麵板。
單擊查詢字段和選擇一個查詢。如果你的目標查詢返回大量的記錄性能將會降低。
如果你的目標查詢返回多個列,磚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}}”