使用事件中樞將事件傳送至 Azure 時間序列深入解析 Gen 1 環境

發行項
06/01/2023

注意

2025 年 3 月之後，時間序列深入解析 (TSI) 服務將不再受到支援。請考慮盡快將現有 TSI 環境移轉至替代解決方案。如需淘汰和移轉的詳細資訊，請參閱我們的文件。

警告

這是 Gen1 文章。

本文說明如何在 Azure 事件中樞建立和設定事件中樞，以及如何執行應用程式範例，藉此將事件從事件中樞推送至 Azure 時間序列深入解析。如果您現有的事件中樞內含 JSON 格式的事件，請跳過本教學課程，並在 Azure 時間序列深入解析 (機器翻譯) 中檢視您的環境。

設定事件中樞

若要了解如何建立事件中樞，請參閱事件中樞文件。
在搜尋方塊中搜尋事件中樞。在傳回的清單中選取 [事件中樞]。
選取事件中樞。
建立事件中樞其實就是建立事件中樞命名空間。如果您尚未在命名空間內建立事件中樞，請在功能表中的 [實體] 下方建立事件中樞。
建立事件中樞之後，在事件中樞清單中選取它。
在功能表中的 [實體] 下方選取 [事件中樞]。
選取事件中樞的名稱來對它進行設定。
在 [概觀] 下方選取 [取用者群組]，然後再次選取 [取用者群組]。
確定您建立的是專供 Azure 時間序列深入解析事件來源使用的取用者群組。

重要

確定任何其他服務 (例如 Azure 串流分析作業或其他 Azure 時間序列深入解析環境) 均未使用此取用者群組。如果有其他服務使用此取用者群組，讀取作業對此環境和其他服務都會造成負面影響。如果使用 $Default 做為取用者群組，有可能會導致其他讀取者重複使用您的取用者群組。
在功能表中的 [設定] 下方選取 [共用存取原則]，然後選取 [新增]。
在 [新增共用存取原則] 窗格中，建立名為 MySendPolicy 的共用存取。您在本文章稍後的 C# 範例中，會使用此共用存取原則傳送事件。
在 [宣告] 下方選取 [傳送] 核取方塊。

新增 Azure 時間序列深入解析執行個體

在 Azure 時間序列深入解析 Gen2 中，您可以使用時間序列模型 (TSM) 將內容相關資料新增至傳入遙測資料。在 TSM 中，您的標記或訊號稱為「執行個體」，且您可以將內容相關資料儲存在「執行個體欄位」中。在查詢時間使用時間序列識別碼即可聯結資料。在本文中，我們稍後要在風車專案範例內使用的時間序列識別碼 為 id。若要深入了解如何將資料儲存在執行個體欄位中，請參閱時間序列模型 (機器翻譯) 概觀。

建立 Azure 時間序列深入解析事件來源

如果您尚未建立事件來源，請完成這些步驟以建立事件來源。
設定 timeSeriesId 的值。若要深入了解時間序列識別碼，請參閱時間序列模型 (機器翻譯)。

將事件推送至風車範例

在搜尋列中搜尋事件中樞。在傳回的清單中選取 [事件中樞]。
選取事件中樞執行個體。
依序前往 [共用存取原則] >[MySendPolicy]。複製 [連接字串 - 主索引鍵] 的值。
前往 TSI Sample Wind Farm Pusher (英文)，在這個網站上可以建立並執行模擬風車裝置。
在網頁的 [事件中樞連接字串] 方塊中，貼上您在 [風車輸入欄位] 中複製的連接字串。
選取 [按一下即可啟動]。

提示

此風車模擬器也會建立 JSON 作為承載，供您搭配 Azure 時間序列深入解析 GA 查詢 API (機器翻譯) 使用。

注意

瀏覽器索引標籤關閉以前，模擬器會持續傳送資料。
回到 Azure 入口網站中的事件中樞。 [概觀] 頁面會顯示事件中樞接收的新事件。

支援的 JSON 樣貌

範例一

輸入：簡單的 JSON 物件。

{
    "id":"device1",
    "timestamp":"2016-01-08T01:08:00Z"
}

輸出：一個事件。

id timestamp

device1 2016-01-08T01:08:00Z

id	timestamp
device1	2016-01-08T01:08:00Z

範例二

輸入：具有兩個 JSON 物件的 JSON 陣列。每個 JSON 物件都會轉換成事件。

[
    {
        "id":"device1",
        "timestamp":"2016-01-08T01:08:00Z"
    },
    {
        "id":"device2",
        "timestamp":"2016-01-17T01:17:00Z"
    }
]

輸出：兩個事件。

id timestamp

device1 2016-01-08T01:08:00Z

device2 2016-01-08T01:17:00Z

id	timestamp
device1	2016-01-08T01:08:00Z
device2	2016-01-08T01:17:00Z

範例三

輸入：具有巢狀 JSON 陣列的 JSON 物件，此陣列中包含兩個 JSON 物件。

{
    "location":"WestUs",
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z"
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z"
        }
    ]
}

輸出：兩個事件。系統會將屬性位置複製到每個事件。

location events.id events.timestamp

WestUs device1 2016-01-08T01:08:00Z

WestUs device2 2016-01-08T01:17:00Z

location	events.id	events.timestamp
WestUs	device1	2016-01-08T01:08:00Z
WestUs	device2	2016-01-08T01:17:00Z

範例四

輸入：具有巢狀 JSON 陣列的 JSON 物件，此陣列中包含兩個 JSON 物件。此輸入示範可由複雜 JSON 物件表示的全域屬性。

{
    "location":"WestUs",
    "manufacturer":{
        "name":"manufacturer1",
        "location":"EastUs"
    },
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z",
            "data":{
                "type":"pressure",
                "units":"psi",
                "value":108.09
            }
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z",
            "data":{
                "type":"vibration",
                "units":"abs G",
                "value":217.09
            }
        }
    ]
}

輸出：兩個事件。

location	manufacturer.name	manufacturer.location	events.id	events.timestamp	events.data.type	events.data.units	events.data.value
WestUs	manufacturer1	EastUs	device1	2016-01-08T01:08:00Z	壓力	psi	108.09
WestUs	manufacturer1	EastUs	device2	2016-01-08T01:17:00Z	vibration	abs G	217.09

下一步

在 Azure 時間序列深入解析總管中檢視您的環境。
深入了解 IoT 中樞裝置訊息 (機器翻譯)