使用參數化 URL 共用自訂檢視
注意
「時間序列深入解析」服務將於 2024 年 7 月 7 日淘汰。 請考慮盡快將現有的環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請造訪我們的文件。
若要在 Azure 時間序列深入解析總管中共用自訂檢視，您可以程式設計方式建立自訂檢視的參數化 URL。
Azure 時間序列深入解析總管支援 URL 查詢參數，以便直接從 URL 指定檢視。 例如，僅使用 URL，您就可以指定目標環境、搜尋述詞，以及所需的時間範圍。 當使用者選取自訂的 URL 時，介面會在 Azure 時間序列深入解析入口網站中提供該資產的直接連結。 適用資料存取原則。
提示
- 閱讀隨附的 Azure 時間序列深入解析總管文件。
環境識別碼
environmentId=<guid> 參數可指定目標環境識別碼。 其是資料存取 FQDN 的元件，而您可以在 Azure 入口網站中環境概觀的右上角找到此元件。 其是在 env.timeseries.azure.com 之前的所有內容。
範例環境識別碼參數為 ?environmentId=10000000-0000-0000-0000-100000000108。
Time
您可以使用參數化 URL 來指定絕對或相對時間值。
絕對時間值
對於絕對時間值，使用 from=<integer> 和 to=<integer> 參數。
from=<integer>是搜尋範圍的開始時間值 (以 JavaScript 毫秒為單位)。to=<integer>是搜尋範圍的結束時間值 (以 JavaScript 毫秒為單位)。
提示
若要輕鬆地將日期轉譯成 JavaScript 毫秒，請嘗試 Epoch 和 Unix 時間戳記轉換器。
相對時間值
對於相對時間值，使用 relativeMillis=<value>，其中 value 是以 JavaScript 毫秒表示，此毫秒來自從 API 收到的最新時間戳記。
例如，&relativeMillis=3600000 可顯示最近 60 分鐘的資料。
接受的值會對應至 Azure 時間序列深入解析總管 [快速時間] 功能表，並且包含：
1800000(過去 30 分鐘)3600000(過去 60 分鐘)10800000(過去 3 小時)21600000(過去 6 小時)43200000(過去 12 小時)86400000(過去 24 小時)604800000(過去 7 天)2592000000(過去 30 小時)
選擇性參數
timeSeriesDefinitions=<collection of term objects> 參數會指定將出現在 Azure 時間序列深入解析檢視中的述詞字詞：
| 參數 | URL 項目 | 描述 |
|---|---|---|
| name | \<string> |
term 的名稱。 |
| splitBy | \<string> |
split by 的資料行名稱。 |
| measureName | \<string> |
measure 的資料行名稱。 |
| predicate | \<string> |
用於伺服器端篩選的 where 子句。 |
| useSum | true |
使用總和作為量值來指定的選擇性參數。 |
注意
如果 Events 是選取的 useSum 量值，則預設會選取 [計數]。
如果未選取 Events，則預設會選取 [平均值]。 |
multiChartStack=<true/false>機碼值組會啟用圖表中的堆疊。multiChartSameScale=<true/false>機碼值組可在選擇性參數內跨字詞啟用相同的 Y 軸刻度。timeBucketUnit=<Unit>&timeBucketSize=<integer>可讓您調整間隔滑桿，以提供更精細或更平滑、更整體的圖表檢視。timezoneOffset=<integer>參數可讓您針對要以 UTC 位移檢視的圖表設定時區。
| 配對 | 描述 |
|---|---|
multiChartStack=false |
預設會啟用 true，因此將 false 傳遞至堆疊。 |
multiChartStack=false&multiChartSameScale=true |
必須啟用堆疊，才能在不同時段使用相同的 Y 軸刻度。 其預設為 false，因此傳遞 true 可啟用此功能。 |
timeBucketUnit=<Unit>&timeBucketSize=<integer> |
單位 = dayshoursminutessecondsmilliseconds。 單位一律大寫。 針對 timeBucketSize 傳遞所需的整數，以定義單位數。 |
timezoneOffset=-<integer> |
整數一律以毫秒為單位。 |
注意
timeBucketUnit 值最多可以平滑 7 天。 timezoneOffset 值既不是 UTC 也不是當地時間。
範例
若要將時間序列定義新增至 Azure 時間序列深入解析環境，做為 URL 參數，請附加：
&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},
{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]
將範例時間序列定義用於：
- 環境識別碼
- 過去 60 分鐘的資料
- 構成選擇性參數的字詞 (F1PressureID、F2TempStation 和 F3VibrationPL)
您可以為檢視建構下列參數化 URL：
https://insights.timeseries.azure.com/classic/samples?environmentId=10000000-0000-0000-0000-100000000108&relativeMillis=3600000&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]
上述 URL 描述並顯示參數化 Azure 時間序列深入解析總管檢視。
參數化述詞。
共用的完整圖表檢視。
下一步
了解如何使用 C# 查詢資料。
了解 Azure 時間序列深入解析總管。