本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 目的地和路徑篩選條件
<a name="gw-destinations"></a>

 AWS IoT SiteWise Edge 中的目的地提供靈活且有效率的方式來管理工業資料如何從邊緣裝置流向雲端。本節說明如何設定目的地、使用路徑篩選條件路由特定資料串流，以及為您的使用案例選擇正確的目的地類型。

您可以在啟用自我託管 MQTT 的 V3 閘道和與 上託管的 AWS IoT SiteWise Edge 應用程式搭配使用的閘道上使用目的地和路徑篩選條件Siemens Industrial Edge。目的地和路徑篩選條件不適用於 Classic Streams、V2 閘道。

**Topics**
+ [了解 AWS IoT SiteWise Edge 目的地](#source-destination)
+ [了解 AWS IoT SiteWise Edge 目的地的路徑篩選條件](#destinations-path-filters)
+ [新增 AWS IoT SiteWise Edge 即時目的地](destinations-real-time.md)
+ [使用 Amazon S3 新增 AWS IoT SiteWise 緩衝目的地](destinations-buffered.md)
+ [將路徑篩選條件新增至 AWS IoT SiteWise Edge 目的地](destinations-add-path-filters.md)
+ [管理 AWS IoT SiteWise Edge 目的地](destinations-manage.md)

## 了解 AWS IoT SiteWise Edge 目的地
<a name="source-destination"></a>

使用 AWS IoT SiteWise Edge 目的地來判斷傳送來源資料的位置。您可以根據所需的特定特性來選擇資料目的地，例如成本效益、低延遲或儲存需求。整合由 AWS IoT SiteWise、我們的合作夥伴或自訂應用程式擷取的裝置資料，以在邊緣發佈和訂閱路徑篩選條件 （主題）。然後，您可以將裝置資料建模、傳輸和存放在雲端。

**注意**  
若要完整使用自我託管閘道上的所有目的地功能，請升級至最新版本的 IoT SiteWise 發佈者和 IoT SiteWise OPC UA 收集器。在 Classic 串流、V2 閘道上繼續支援串流，以維持與現有設定的相容性。如需詳細資訊，請參閱[傳統串流、適用於 AWS IoT SiteWise Edge 的 V2 閘道](classic-streams-v2-gateway.md)

**Topics**
+ [SiteWise Edge 目的地如何增強資料管理](#how-destinations-work)
+ [目的地類型](#destination-types)
+ [比較閘道版本之間的目的地功能](#destinations-vs-publisher-component)
+ [目的地限制](#destinations-limitiations)
+ [SiteWise Edge 目的地的使用案例](#destinations-use-cases)

### SiteWise Edge 目的地如何增強資料管理
<a name="how-destinations-work"></a>

 AWS IoT SiteWise 即時將資料從邊緣匯出到 ，或使用 Amazon S3 分批匯出。

目的地可增強您 AWS IoT SiteWise 環境中的靈活性和可擴展性。目的地會實作集中式資料管理模型，其中來源會將資料發佈至中央系統。目的地會使用路徑篩選條件來判斷資料的傳送位置。目的地可以訂閱多個路徑篩選條件。

啟用 MQTT 的閘道，無論是自我託管還是在 上執行Siemens Industrial Edge，請使用 MQTT 進行本機通訊，並隨附預設即時目的地，其篩選條件設定為 `#`。這表示根據預設，所有主題上的所有訊息都會發佈到 AWS IoT SiteWise 即時目的地。如需詳細資訊，請參閱[了解 AWS IoT SiteWise Edge 目的地的路徑篩選條件了解路徑篩選條件](#destinations-path-filters)。您可以在每個閘道中新增一個即時目的地。

### 目的地類型
<a name="destination-types"></a>

為閘道設定目的地時，您有兩個主要選項：使用 的即時組態 AWS IoT SiteWise，以及使用 Amazon S3 的緩衝組態。每個目的地類型都有自己的一組設定和考量事項。

**AWS IoT SiteWise 即時設定**  
選擇此選項將資料直接傳送到 AWS IoT SiteWise 熱層儲存，以方便即時擷取和監控資料。即時設定會管理資料流程，特別是當閘道遇到與雲端的連線問題時。在連線中斷期間，資料會暫時存放在本機的閘道上。重新建立連線後，儲存的資料會自動傳送至雲端。  
您可以調整資料發佈程序的各個層面，例如要在本機存放的最大資料量、重新連線時將資料傳送至雲端的速率，以及在儲存達到其容量後何時刪除資料。  
如需 AWS IoT SiteWise 儲存層的詳細資訊，請參閱 [在 中管理資料儲存 AWS IoT SiteWise](manage-data-storage.md)。

**AWS IoT SiteWise 使用 Amazon S3 設定緩衝**  
此目的地類型可讓您在本機緩衝閘道上的資料，並定期將其分批傳送至 Amazon S3 儲存貯體。資料會以有效的 Parquet 格式儲存，並針對分析工作負載進行最佳化。資料在 Amazon S3 中後，您可以將其匯入至 AWS IoT SiteWise 以進行儲存、處理和分析。  
選擇此選項以批次擷取資料，並以經濟實惠的方式存放歷史資料。您可以設定偏好的 Amazon S3 儲存貯體位置，以及您希望將資料上傳至 Amazon S3 的頻率。您也可以選擇在擷取資料之後如何處理資料 AWS IoT SiteWise。您可以選擇在 SiteWise 和 Amazon S3 中同時提供資料，也可以選擇從 Amazon S3 自動刪除資料。

### 比較閘道版本之間的目的地功能
<a name="destinations-vs-publisher-component"></a>

啟用 MQTT 的閘道中的目的地功能可簡化資料流程管理。目的地透過將資料路由至各種端點的集中式組態來簡化資料管理。這種方法不需要複雜的個別串流設定，讓整體系統更具彈性且更容易管理。

相較之下，Classic 串流、V2 閘道、SiteWise Edge AWS IoT Greengrass 會透過串流將資料從資料來源傳輸到發佈者，為每個資料來源個別設定資料目的地。

使用 AWS IoT SiteWise 目的地功能時，發佈者路由組態會合併。目的地組態可讓您集中管理目的地和路徑篩選條件。您可以根據您的需求，輕鬆新增目的地、管理路徑篩選條件、刪除不必要的篩選條件或目的地。

此外，目的地功能使用 MQTT （訊息佇列遙測傳輸），這是一種產業標準通訊協定，廣泛用於工業 IoT 應用程式。這種採用 MQTT AWS IoT SiteWise 有助於簡化與各種裝置和系統的整合。

### 目的地限制
<a name="destinations-limitiations"></a>

SiteWise Edge 閘道上目的地的目前限制包括：
+ 啟用 MQTT 的閘道不支援資料處理套件。
+ 資料類型支援僅限於 AWS IoT SiteWise 資料類型。如需啟用資料類型轉換的資訊，請參閱 [轉換不支援的資料類型](string-conversion.md)。

### SiteWise Edge 目的地的使用案例
<a name="destinations-use-cases"></a>

SiteWise Edge 目的地用於各種應用程式。以下是一些關鍵範例：

**工業自動化***即時監控和預測性維護*  
在工業設定中，工廠現場的感應器和裝置可以將資料發佈到 SiteWise Edge。您可以設定目的地來篩選和路由相關資料，以便即時監控和分析機器效能。您可以使用路徑篩選條件訂閱相關 MQTT 主題、處理資料，然後發佈已處理的資料。透過這種方式，您可以選擇性地將處理的資料路由到 AWS 雲端分析服務或內部部署系統。然後，製造商可以實作預測性維護策略、最佳化生產程序，並減少停機時間。

**智慧建物***能源效率和佔用率最佳化*  
建置自動化系統會產生資料串流，以監控和控制建築物的各個層面，例如 HVAC 系統、照明和存取控制。使用 SiteWise Edge，這些資料串流可以擷取、處理和路由到不同的目的地。設施管理員可以設定目的地來篩選和轉送相關資料，啟用能源效率測量和佔用最佳化等進階功能，同時確保資料隱私和合規。

這些使用案例示範如何跨各種產業利用 SiteWise Edge 中的目的地功能，以有效率地擷取、處理和路由資料。這可啟用進階功能，例如即時監控、預測性維護、能源效率和遠端診斷，同時確保資料隱私權和合規性。

## 了解 AWS IoT SiteWise Edge 目的地的路徑篩選條件
<a name="destinations-path-filters"></a>

**Topics**
+ [路徑篩選條件需求](#path-filter-requirements)
+ [路徑篩選條件的最佳實務](#create-effective-path-filters)
+ [OPC UA 伺服器的路徑篩選條件](#path-filters-opcua)
+ [路徑篩選條件名稱中的特殊字元](#path-filters-special-characters)

每個目的地都設定為將資料路由到 AWS IoT SiteWise 或 Amazon S3。路徑篩選條件可讓您選取接收目的地的 MQTT 訊息時要篩選的特定資料。路徑篩選條件代表資料串流的邏輯名稱，做為所需 MQTT 主題的訂閱。

在 MQTT 中，資料會組織成主題，這些主題是以斜線 () 分隔的階層式字串`/`。例如，裝置可能會將溫度資料發佈至主題 `home/livingroom/sensor1/temperature`。在這裡， `home/livingroom/sensor1`代表感應器的路徑或邏輯名稱，而 `temperature`是要發佈的資料類型。

您可以使用路徑篩選條件，使用萬用字元 (`+` 和 ) 訂閱特定主題或一系列主題`#`。`+` 萬用字元符合主題階層中的單一層級。例如， `home/+/sensor1/temperature` 會比對 `home/livingroom/sensor1/temperature`和 `home/bedroom/sensor1/temperature`。萬`#`用字元在篩選條件結尾使用時，會符合多個層級。

您也可以使用路徑篩選條件名稱中 MQTT 規格中通常不允許的各種字元。在 name 中使用時，這些字元不會做為萬用字元運作。 會使用編碼 AWS IoT SiteWise 來轉換這些字元，以確保 MQTT 合規，同時保留原始命名結構。此功能對於容納來自其他系統的現有命名慣例特別有用。如需詳細資訊，請參閱[路徑篩選條件名稱中的特殊字元](#path-filters-special-characters)。

透過仔細選取適當的路徑篩選條件，您可以控制要傳送到特定目的地的資料。使用路徑篩選條件，根據 IoT 系統的需求量身打造資料流程。

### 路徑篩選條件需求
<a name="path-filter-requirements"></a>

使用 輸入路徑篩選條件時 AWS IoT SiteWise 主控台，請記住下列事項：
+ 路徑篩選條件以新行分隔，每行代表單獨的路徑篩選條件。
+ 個別路徑篩選條件可以有 1 到 65，535 個位元組。
+ 路徑篩選條件不能空白。
+ 不允許空值 (U\+0000)。
+ 您一次最多可輸入 100 個路徑篩選條件或 65，535 個字元，以先達到限制為準。
+ 閘道上所有目的地的總限制為 20，000 個路徑篩選條件。
+ 您可以在路徑篩選條件名稱中使用 `%`、`+`、 `#`和 `$` 字元，但 AWS IoT SiteWise 會自動將其轉換為 URI 編碼。

### 路徑篩選條件的最佳實務
<a name="create-effective-path-filters"></a>

為您的 AWS IoT SiteWise 目的地建立路徑篩選條件時，請考慮下列策略以有效管理您的資料。
+ 建構您的篩選條件以鏡射您的裝置階層。例如，在製造設定中， `factory/+/machine/#`會從不同生產線的所有機器擷取資料。
+ 針對裝置類型、位置或函數使用特定層級。例如 `factory/assembly-line/robot/temperature`。或者，在智慧農業中， `farm/+/crop/+/moisture`會監控不同欄位間各種作物的濕度等級。
+ 策略性地利用萬用字元：`+`用於單一層級的變化`#`，並擷取所有後續層級。例如， `building/+/+/energy-consumption`會追蹤建築物中不同區域和地板的能源使用量。這會假設第一個`+`擷取所有樓層，第二個`+`擷取所有區域。
+ 透過建立足以擷取相關資料的篩選條件，但足以適應未來變更的彈性，來平衡特異性和靈活性。例如， `site/+/equipment-type/+/measurement` 允許新增新的站點或設備類型，而不變更篩選條件結構。

徹底測試您的篩選條件，以確保它們擷取預期資料，並與 IoT 系統的架構和目標保持一致。

### OPC UA 伺服器的路徑篩選條件
<a name="path-filters-opcua"></a>

對於 OPC UA 伺服器，您的路徑篩選條件必須對應至 OPC UA 標籤名稱。路徑篩選條件的最終層級必須完全符合 OPC UA 標籤名稱。例如，如果您的 OPC UA 標籤為 `Device1.Temperature`，您的路徑篩選條件可能為 `factory/line1/Device1.Temperature`。您可以在上述關卡中使用萬用字元，例如`factory/+/Device1.Temperature`跨多個生產線擷取標籤。如果您的路徑篩選條件名稱中有特殊字元，請參閱 [路徑篩選條件名稱中的特殊字元](#path-filters-special-characters) 以取得詳細資訊。

### 路徑篩選條件名稱中的特殊字元
<a name="path-filters-special-characters"></a>

AWS IoT SiteWise 可容納 OPC UA 等工業通訊協定中常用的字元，通常在標準 MQTT 主題名稱中是不允許的。此功能有助於更順暢地整合工業系統與 MQTT 型架構。

**注意**  
雖然我們的特殊字元處理有助於整合和遷移，但建議盡可能符合新實作的標準 MQTT 命名慣例，以確保更廣泛的相容性。

從工業來源接收資料時， 會使用特殊字元的 URI 編碼 AWS IoT SiteWise 標準化主題名稱：
+ `%` 變成 `%25`（先編碼為逸出字元）
+ `#` 成為 `%23`
+ `+` 成為 `%2B`
+ `$` 變成 `%24`（僅在主題開始時）

此編碼可確保包含這些特殊 MQTT 字元的來源資料可安全地用作 MQTT 主題名稱，同時保留原始工業命名慣例。

**Example ：路徑篩選條件名稱中的特殊字元**  
以下是工業主題名稱如何在 AWS IoT SiteWise 路徑篩選條件中顯示的範例：  
+ `Factory1/Line#2/Sensor+3` 成為 `Factory1/Line%232/Sensor%2B3`
+ `Plant%A/Unit$1/Temp` 成為 `Plant%25A/Unit%241/Temp`
+ `Site1/#Section/+Node` 成為 `Site1/%23Section/%2BNode`

在 中建立訂閱或檢視主題名稱時 AWS IoT SiteWise，您會看到原始、未編碼的版本。系統會自動處理編碼，以確保 MQTT 合規。