

支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。

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

# IoT Analytics 連接器
<a name="iot-analytics-connector"></a>

**警告**  <a name="connectors-extended-life-phase-warning"></a>
此連接器已進入*延長的生命週期階段*，並且 AWS IoT Greengrass 不會發行提供現有功能、增強功能、安全修補程式或錯誤修正的更新。如需詳細資訊，請參閱[AWS IoT Greengrass Version 1 維護政策](maintenance-policy.md)。

IoT Analytics 連接器會將本機裝置資料傳送至 AWS IoT Analytics。您可以使用此連接器做為中央中樞，從 Greengrass 核心裝置上的感應器和[連接的用戶端裝置](what-is-gg.md#greengrass-devices)收集資料。連接器會將資料傳送至目前 AWS 帳戶 和 區域中的 AWS IoT Analytics 頻道。它可以將資料傳送到預設目的地管道和動態指定的管道。

**注意**  
AWS IoT Analytics 是一種全受管服務，可讓您收集、存放、處理和查詢 IoT 資料。在 中 AWS IoT Analytics，可以進一步分析和處理資料。例如，您可以用於訓練機器學習模型來監控機器運作狀況，或測試新的建模策略。如需詳細資訊，請參閱[什麼是 AWS IoT Analytics？](https://docs.aws.amazon.com/iotanalytics/latest/userguide/welcome.html) *AWS IoT Analytics 《 使用者指南*》中的 。

連接器接受[輸入 MQTT 主題](#iot-analytics-connector-data-input)上的有格式和無格式資料。它支援兩種預先定義的主題，目的地管道為指定的內嵌。它也可以接收[在訂閱中配置的](connectors.md#connectors-inputs-outputs)客戶定義主題訊息。這可用於從發佈至固定主題的用戶端裝置路由訊息，或從資源受限的裝置處理非結構化或堆疊相依的資料。

此連接器使用 [https://docs.aws.amazon.com/iotanalytics/latest/userguide/api.html#cli-iotanalytics-batchputmessage](https://docs.aws.amazon.com/iotanalytics/latest/userguide/api.html#cli-iotanalytics-batchputmessage) API 將資料 （以 JSON 或 base64 編碼字串的形式） 傳送至目的地頻道。連接器可將原始資料處理為符合 API 要求的格式。連接器會依管道佇列緩衝輸入的訊息，並以非同步方式處理批次。它提供參數，讓您控制佇列和批次處理行為，以及限制記憶體用量。例如，您可以設定最大佇列大小、批次間隔、記憶體大小和作用中管道的數量。

此連接器具有下列版本。


| 版本 | ARN | 
| --- | --- | 
| 4 | `arn:aws:greengrass:region::/connectors/IoTAnalytics/versions/4` | 
| 3 | `arn:aws:greengrass:region::/connectors/IoTAnalytics/versions/3` | 
| 2 | `arn:aws:greengrass:region::/connectors/IoTAnalytics/versions/2` | 
| 1 | `arn:aws:greengrass:region::/connectors/IoTAnalytics/versions/1` | 

如需版本變更的詳細資訊，請參閱 [Changelog](#iot-analytics-connector-changelog)。

## 要求
<a name="iot-analytics-connector-req"></a>

此連接器有下列要求：

------
#### [ Version 3 - 4 ]
+ <a name="conn-req-ggc-v1.9.3"></a>AWS IoT Greengrass 核心軟體 v1.9.3 或更新版本。
+ <a name="conn-req-py-3.7-and-3.8"></a>安裝在核心裝置上並新增至 PATH 環境變數的 [Python](https://www.python.org/) 3.7 或 3.8 版。
**注意**  <a name="use-runtime-py3.8"></a>
若要使用 Python 3.8，請執行下列命令，以建立從預設 Python 3.7 安裝資料夾到已安裝 Python 3.8 二進位檔的符號連結。  

  ```
  sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7
  ```
這會設定您的裝置以符合 AWS IoT Greengrass的 Python 需求。
+ <a name="conn-iot-analytics-req-regions"></a>此連接器只能在同時[AWS IoT Analytics](https://docs.aws.amazon.com/general/latest/gr/iot-analytics.html)支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 的 Amazon Web Services 區域中使用。
+ <a name="conn-iot-analytics-req-ita-config"></a>建立並設定所有相關 AWS IoT Analytics 實體和工作流程。實體包含頻道、管道、資料存放區和資料集。如需詳細資訊，請參閱*AWS IoT Analytics 《 使用者指南*》中的 [AWS CLI](https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html)或 [主控台](https://docs.aws.amazon.com/iotanalytics/latest/userguide/quickstart.html)程序。
**注意**  
目的地 AWS IoT Analytics 頻道必須使用相同的 帳戶，且與此 AWS 區域 連接器位於相同的 中。
+ <a name="conn-iot-analytics-req-iam-policy"></a>設定為允許對目的地頻道`iotanalytics:BatchPutMessage`執行動作的 [Greengrass 群組角色](group-role.md)，如下列範例 IAM 政策所示。頻道必須位於目前的 AWS 帳戶 和 區域中。

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Sid": "Stmt1528133056761",
              "Action": [
                  "iotanalytics:BatchPutMessage"
              ],
              "Effect": "Allow",
              "Resource": [
              "arn:aws:iotanalytics:us-east-1:123456789012:channel/channel_1_name",
      "arn:aws:iotanalytics:us-east-1:123456789012:channel/channel_2_name"
              ]
          }
      ]
  }
  ```

------

  <a name="set-up-group-role"></a>針對群組角色要求，您必須設定角色以授與必要的許可，並確認已將角色新增至群組。如需詳細資訊，請參閱 [管理 Greengrass 群組角色 (主控台)](group-role.md#manage-group-role-console) 或 [管理 Greengrass 群組角色 (CLI)](group-role.md#manage-group-role-cli) 。

------
#### [ Versions 1 - 2 ]
+ <a name="conn-req-ggc-v1.7.0"></a>AWS IoT Greengrass 核心軟體 v1.7 或更新版本。
+ 安裝在核心裝置上並新增至 PATH 環境變數的 [Python](https://www.python.org/) 2.7 版。
+ <a name="conn-iot-analytics-req-regions"></a>此連接器只能在同時[AWS IoT Analytics](https://docs.aws.amazon.com/general/latest/gr/iot-analytics.html)支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 的 Amazon Web Services 區域中使用。
+ <a name="conn-iot-analytics-req-ita-config"></a>建立並設定所有相關 AWS IoT Analytics 實體和工作流程。實體包含頻道、管道、資料存放區和資料集。如需詳細資訊，請參閱*AWS IoT Analytics 《 使用者指南*》中的 [AWS CLI](https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html)或 [主控台](https://docs.aws.amazon.com/iotanalytics/latest/userguide/quickstart.html)程序。
**注意**  
目的地 AWS IoT Analytics 頻道必須使用相同的 帳戶，且與此 AWS 區域 連接器位於相同的 中。
+ <a name="conn-iot-analytics-req-iam-policy"></a>設定為允許對目的地頻道`iotanalytics:BatchPutMessage`執行動作的 [Greengrass 群組角色](group-role.md)，如下列範例 IAM 政策所示。頻道必須位於目前的 AWS 帳戶 和 區域中。

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Sid": "Stmt1528133056761",
              "Action": [
                  "iotanalytics:BatchPutMessage"
              ],
              "Effect": "Allow",
              "Resource": [
              "arn:aws:iotanalytics:us-east-1:123456789012:channel/channel_1_name",
      "arn:aws:iotanalytics:us-east-1:123456789012:channel/channel_2_name"
              ]
          }
      ]
  }
  ```

------

  <a name="set-up-group-role"></a>針對群組角色要求，您必須設定角色以授與必要的許可，並確認已將角色新增至群組。如需詳細資訊，請參閱 [管理 Greengrass 群組角色 (主控台)](group-role.md#manage-group-role-console) 或 [管理 Greengrass 群組角色 (CLI)](group-role.md#manage-group-role-cli) 。

------

## Parameters
<a name="iot-analytics-connector-param"></a>

`MemorySize`  
配置給此連接器的記憶體數量 (KB)。  
 AWS IoT 主控台中的顯示名稱：**記憶體大小**  
必要：`true`  
類型：`string`  
有效模式： `^[0-9]+$`

`PublishRegion`  
 AWS 區域 AWS IoT Analytics 頻道建立所在的 。使用與連接器相同的區域。  
這也必須與[群組角色](#iot-analytics-connector-req)中指定的管道所在區域相同。
 AWS IoT 主控台中的顯示名稱：**發布區域**  
必要：`false`  
類型：`string`  
有效模式： `^$|([a-z]{2}-[a-z]+-\\d{1})`

`PublishInterval`  
將一批接收資料發佈到其中的間隔 （以秒為單位） AWS IoT Analytics。  
 AWS IoT 主控台中的顯示名稱：**發佈間隔**  
必要：`false`  
類型：`string`  
預設值：`1`  
有效模式： `$|^[0-9]+$`

`IotAnalyticsMaxActiveChannels`  
連接器主動監看的 AWS IoT Analytics 頻道數量上限。此數值必須大於 0，且至少等於您希望連接器在特定時間發佈的目標頻道數。  
您可以使用此參數，透過限制連接器在特定時間可以管理的佇列總數，藉以限制記憶體用量。佇列中所有訊息皆傳送後，該佇列就會刪除。  
 AWS IoT 主控台中的顯示名稱：**作用中頻道的數量上限**  
必要：`false`  
類型：`string`  
預設值：`50`  
有效模式： `^$|^[1-9][0-9]*$`

`IotAnalyticsQueueDropBehavior`  
管道佇列已滿時，從佇列拋棄訊息的行為。  
 AWS IoT 主控台中的顯示名稱：**佇列捨棄行為**  
必要：`false`  
類型：`string`  
有效值：`DROP_NEWEST` 或 `DROP_OLDEST`  
預設值：`DROP_NEWEST`  
有效模式： `^DROP_NEWEST$|^DROP_OLDEST$`

`IotAnalyticsQueueSizePerChannel`  
訊息提交或拋棄前，在 (每個管道) 記憶體中保留的最大訊息數。此數值必須大於 0。  
在 AWS IoT 主控台中顯示名稱：**每個頻道的佇列大小上限**  
必要：`false`  
類型：`string`  
預設值：`2048`  
有效模式： `^$|^[1-9][0-9]*$`

`IotAnalyticsBatchSizePerChannel`  
一個批次請求中要傳送到 AWS IoT Analytics 頻道的訊息數量上限。此數值必須大於 0。  
在 AWS IoT 主控台中顯示名稱：**每個頻道要批次處理的訊息數量上限**  
必要：`false`  
類型：`string`  
預設值：`5`  
有效模式： `^$|^[1-9][0-9]*$`

`IotAnalyticsDefaultChannelName`  
此連接器用於傳送至客戶定義輸入主題之訊息的 AWS IoT Analytics 頻道名稱。  
 AWS IoT 主控台中的顯示名稱：**預設頻道名稱**  
必要：`false`  
類型：`string`  
有效模式： `^[a-zA-Z0-9_]$`

`IsolationMode`  <a name="IsolationMode"></a>
此連接器的[容器化](connectors.md#connector-containerization)模式。預設值為 `GreengrassContainer`，這表示連接器會在 AWS IoT Greengrass 容器內的隔離執行時間環境中執行。  
群組的預設容器化設定不會套用至連接器。
 AWS IoT 主控台中的顯示名稱：**容器隔離模式**  
必要：`false`  
類型：`string`  
有效值：`GreengrassContainer` 或 `NoContainer`  
有效模式： `^NoContainer$|^GreengrassContainer$`

### 建立範例連接器 (AWS CLI)
<a name="iot-analytics-connector-create"></a>

下列 CLI 命令`ConnectorDefinition`會使用包含 IoT Analytics 連接器的初始版本來建立 。

```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTAnalyticsApplication",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTAnalytics/versions/3",
            "Parameters": {
                "MemorySize": "65535",
                "PublishRegion": "us-west-1",
                "PublishInterval": "2",
                "IotAnalyticsMaxActiveChannels": "25",
                "IotAnalyticsQueueDropBehavior": "DROP_OLDEST",
                "IotAnalyticsQueueSizePerChannel": "1028",
                "IotAnalyticsBatchSizePerChannel": "5",
                "IotAnalyticsDefaultChannelName": "my_channel"
            }
        }
    ]
}'
```

**注意**  
此連接器中的 Lambda 函數具有[長期生命週期](lambda-functions.md#lambda-lifecycle)。

在 AWS IoT Greengrass 主控台中，您可以從群組的連接器頁面新增**連接器**。如需詳細資訊，請參閱[Greengrass 連接器入門 (主控台)](connectors-console.md)。

## 輸入資料
<a name="iot-analytics-connector-data-input"></a>

此連接器根據預先定義和客戶定義的 MQTT 主題接受資料。發佈者可以是用戶端裝置、Lambda 函數或其他連接器。

預先定義的主題  
連接器支援以下兩個結構化 MQTT 主題，讓發佈方內嵌指定頻道名稱。  
+ `iotanalytics/channels/+/messages/put` 主題的[格式化訊息](#iot-analytics-connector-data-input-json)。這些輸入訊息中的 IoT 資料，必須格式化為 JSON 或 base64 編碼字串。
+ 有關 `iotanalytics/channels/+/messages/binary/put` 主題的非格式化訊息。在此主題接收到的輸入訊息皆視為二元資料，可包含任何資料類型。

  若要發佈到預先定義的主題，請將 `+` 萬用字元改為管道名稱。例如：

  ```
  iotanalytics/channels/my_channel/messages/put
  ```

客戶定義的主題  
連接器支援 `#` 主題的語法，可接受您在訂閱中配置的任何 MQTT 主題中的輸入訊息。我們建議您指定主題路徑，而不是在訂閱中僅使用`#`萬用字元。這些訊息會傳送到您為連接器指定的預設頻道。  
客戶定義主題上的輸入訊息視為二元資料。此類資料可使用任何訊息格式，並包含任何資料類型。您可以使用客戶定義的主題，從發佈至固定主題的裝置路由訊息。您也可以使用它們來接受來自用戶端裝置的輸入資料，這些用戶端裝置無法將資料處理為格式化訊息，以傳送至連接器。  
如需更多關於訂閱和 MQTT 主題的資訊，請參閱 [輸入和輸出](connectors.md#connectors-inputs-outputs)。

群組角色必須允許所有目標管道上的 `iotanalytics:BatchPutMessage` 動作。如需詳細資訊，請參閱[要求](#iot-analytics-connector-req)。

**主題篩選條件：** `iotanalytics/channels/+/messages/put`  <a name="iot-analytics-connector-data-input-json"></a>
使用此主題將格式化訊息傳送至連接器，並動態指定目的地頻道。此主題也可讓您指定 ID，在回應輸出中傳回。連接器會驗證所傳送傳出`BatchPutMessage`請求中每個訊息IDs 是否唯一 AWS IoT Analytics。ID 重複的訊息會遭到拋棄。  
傳送到此主題的輸入資料必須使用下列訊息格式。    
**訊息屬性**    
`request`  
傳送至指定管道的資料。  
必要：`true`  
類型：`object`包含下列屬性：    
`message`  
JSON 或 base64 編碼字串的裝置或感應器資料。  
必要：`true`  
類型：`string`  
`id`  
請求的任意 ID。此屬性用於將輸入請求映射到輸出回應。當指定時，回應物件中的 `id` 屬性會設為這個值。如果省略此屬性，連接器會產生 ID。  
必要：`false`  
類型：`string`  
有效模式： `.*`  
**範例輸入**  

```
{
    "request": {
        "message" : "{\"temp\":23.33}"
    },
    "id" : "req123"
}
```

**主題篩選條件：** `iotanalytics/channels/+/messages/binary/put`  
使用此主題將無格式訊息傳送至連接器，並動態指定目的地頻道。  
連接器資料不剖析此主題接收到的輸入訊息。它會將其視為二元資料。在傳送訊息到 之前 AWS IoT Analytics，連接器會編碼並格式化它們以符合 `BatchPutMessage` API 要求：  
+ 連接器 base64 編碼原始資料，並將編碼的酬載加入傳出的 `BatchPutMessage` 請求。
+ 連接器會為每個輸入訊息產生和指派 ID。
**注意**  
連接器的回應輸出不包含這些輸入訊息的 ID 相關性。  
**訊息屬性**  
無。

**主題篩選條件：** `#`  
使用此主題將任何訊息格式傳送至預設管道。當您的用戶端裝置發佈至固定主題，或您想要將資料從無法以連接器[支援的訊息格式](#iot-analytics-connector-data-input-json)處理資料的用戶端裝置傳送到預設頻道時，這特別有用。  
您可以在您建立的訂閱中定義主題語法，以將此連接器連線至資料來源。我們建議您指定主題路徑，而不是在訂閱中僅使用`#`萬用字元。  
連接器資料不剖析發佈至此輸入主題的訊息。所有輸入訊息視為二元資料。在傳送訊息到 之前 AWS IoT Analytics，連接器會編碼並格式化它們以符合 `BatchPutMessage` API 要求：  
+ 連接器 base64 編碼原始資料，並將編碼的酬載加入傳出的 `BatchPutMessage` 請求。
+ 連接器會為每個輸入訊息產生和指派 ID。
**注意**  
連接器的回應輸出不包含這些輸入訊息的 ID 相關性。  
**訊息屬性**  
無。

## 輸出資料
<a name="iot-analytics-connector-data-output"></a>

這個連接器會將狀態資訊發佈為輸出資料，且主題為 MQTT。此資訊包含 AWS IoT Analytics 為其接收和傳送的每個輸入訊息傳回的回應 AWS IoT Analytics。

<a name="topic-filter"></a>**訂閱中的主題篩選條件**  
`iotanalytics/messages/put/status`

**範例輸出：成功**  

```
{
    "response" : {
        "status" : "success"
    },
    "id" : "req123"
}
```

**範例輸出：失敗**  

```
{
    "response" : {
        "status" : "fail",
        "error" : "ResourceNotFoundException",
        "error_message" : "A resource with the specified name could not be found."
    },
    "id" : "req123"
}
```
如果連接器偵測到可重試的錯誤 （例如連線錯誤），它會在下一個批次中重試發佈。指數退避由 AWS SDK 處理。因可重試錯誤而失敗的請求會加回管道佇列末端，依據 `IotAnalyticsQueueDropBehavior` 參數進一步發佈。

## 用量範例
<a name="iot-analytics-connector-usage"></a>

<a name="connectors-setup-intro"></a>使用下列高階步驟來設定範例 Python 3.7 Lambda 函數，您可以用來嘗試連接器。

**注意**  <a name="connectors-setup-get-started-topics"></a>
如果您使用其他 Python 執行期，則可以建立從 Python3.x 到 Python 3.7 的符號連結。
[連接器入門 (主控台)](connectors-console.md) 和 [連接器入門 (CLI)](connectors-cli.md) 主題包含詳細步驟，說明如何設定和部署範例 Twilio 通知連接器。

1. 確定您符合連接器的[要求](#iot-analytics-connector-req)。

   <a name="set-up-group-role"></a>針對群組角色要求，您必須設定角色以授與必要的許可，並確認已將角色新增至群組。如需詳細資訊，請參閱 [管理 Greengrass 群組角色 (主控台)](group-role.md#manage-group-role-console) 或 [管理 Greengrass 群組角色 (CLI)](group-role.md#manage-group-role-cli) 。

1. <a name="connectors-setup-function"></a>建立並發佈 Lambda 函數，將輸入資料傳送至連接器。

   將[範例程式碼](#iot-analytics-connector-usage-example)儲存為 PY 檔案。<a name="connectors-setup-function-sdk"></a>下載並解壓縮[AWS IoT Greengrass 適用於 Python 的 Core SDK](lambda-functions.md#lambda-sdks-core)。然後，建立在根層級包含 PY 檔案和 `greengrasssdk` 資料夾的 zip 套件。此 zip 套件是您上傳至 的部署套件 AWS Lambda。

   <a name="connectors-setup-function-publish"></a>建立 Python 3.7 Lambda 函數後，發佈函數版本並建立別名。

1. 設定 Greengrass 群組。

   1. <a name="connectors-setup-gg-function"></a>依別名新增 Lambda 函數 （建議）。將 Lambda 生命週期設定為長期 （或在 CLI `"Pinned": true`中）。

   1. 新增連接器並設定其[參數](#iot-analytics-connector-param)。

   1. 新增訂閱，允許連接器在支援主題篩選條件上接收[輸入資料](#iot-analytics-connector-data-input)並傳送[輸出資料](#iot-analytics-connector-data-output)。
      + <a name="connectors-setup-subscription-input-data"></a>將 Lambda 函數設定為來源，將連接器設定為目標，並使用支援的輸入主題篩選條件。
      + <a name="connectors-setup-subscription-output-data"></a>將連接器設為來源、將 AWS IoT Core 設為目標，並使用支援的輸出主題篩選條件。您可以使用此訂閱在 AWS IoT 主控台中檢視狀態訊息。

1. <a name="connectors-setup-deploy-group"></a>部署群組。

1. <a name="connectors-setup-test-sub"></a>在 AWS IoT 主控台**的測試**頁面上，訂閱輸出資料主題，以檢視連接器的狀態訊息。Lambda 函數範例為長期函數，並在部署群組後立即開始傳送訊息。

   完成測試後，您可以將 Lambda 生命週期設定為隨需 （或在 CLI `"Pinned": false`中） 並部署群組。這會讓函數停止傳送訊息。

### 範例
<a name="iot-analytics-connector-usage-example"></a>

下列範例 Lambda 函數會將輸入訊息傳送至連接器。

```
import greengrasssdk
import time
import json
 
iot_client = greengrasssdk.client('iot-data')
send_topic = 'iotanalytics/channels/my_channel/messages/put'
 
def create_request_with_all_fields():
    return  {
        "request": {
            "message" : "{\"temp\":23.33}"
        },
        "id" : "req_123"
    }
 
def publish_basic_message():
    messageToPublish = create_request_with_all_fields()
    print("Message To Publish: ", messageToPublish)
    iot_client.publish(topic=send_topic,
        payload=json.dumps(messageToPublish))
 
publish_basic_message()
 
def lambda_handler(event, context):
    return
```

## 限制
<a name="iot-analytics-connector-limits"></a>

此連接器受下列限制的約束。
+  適用於 Python (Boto3) 的 AWS SDK 為 AWS IoT Analytics [https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iotanalytics.html#IoTAnalytics.Client.batch_put_message](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iotanalytics.html#IoTAnalytics.Client.batch_put_message)動作施加的所有限制。
+  AWS IoT Analytics [ BatchPutMessage](https://docs.aws.amazon.com/iotanalytics/latest/userguide/api.html#cli-iotanalytics-batchputmessage) API 實施的所有配額。如需詳細資訊，請參閱《 AWS IoT Analytics 》中的適用於 的 [ Service Quotas](https://docs.aws.amazon.com/general/latest/gr/iot-analytics.html#limits_iot_analytics)*AWS 一般參考*。
  + 每個管道每秒 100,000 個訊息。
  + 每個批次 100 則訊息。
  + 每則訊息 128 KB。

  這個 API 使用管道名稱 (而非管道 ARN)，因此不支援跨區域或跨帳戶管道傳送資料。
+  AWS IoT Greengrass 核心強制實施的所有配額。如需詳細資訊，請參閱 中 AWS IoT Greengrass 核心的 [ Service Quotas](https://docs.aws.amazon.com/general/latest/gr/greengrass.html#limits_greengrass)*AWS 一般參考*。

  以下配額可能特別適用：
  + 裝置傳送的訊息大小上限為 128 KB。
  + Greengrass 核心路由器中的訊息佇列大小上限為 2.5 MB。
  + 主題字串的長度上限為 256 位元組的 UTF-8 編碼字元。

## 授權
<a name="iot-analytics-connector-license"></a>

IoT Analytics 連接器包含下列第三方軟體/授權：<a name="boto-3-licenses"></a>
+ [適用於 Python (Boto3) 的 AWS SDK](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD 授權、GNU 一般公有授權 (GPL)、Python 軟體基金會授權、公有網域
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

此連接器根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。

## 變更記錄
<a name="iot-analytics-connector-changelog"></a>

下表說明每個版本連接器的變更。


| 版本 | 變更 | 
| --- | --- | 
| 4 | 新增 `IsolationMode` 參數以設定連接器的容器化模式。 | 
| 3 | <a name="upgrade-runtime-py3.7"></a>將 Lambda 執行時間升級至 Python 3.7，這會變更執行時間需求。 | 
| 2 | 可減少過多記錄的修正。 | 
| 1 | 初始版本。  | 

<a name="one-conn-version"></a>Greengrass 群組一次只能包含一個版本的連接器。若要取得有關升級連接器版本的資訊，請參閱[升級連接器版本](connectors.md#upgrade-connector-versions)。

## 另請參閱
<a name="iot-analytics-connector-see-also"></a>
+ [使用 Greengrass 連接器來整合服務和通訊協定](connectors.md)
+ [Greengrass 連接器入門 (主控台)](connectors-console.md)
+ [Greengrass 連接器入門 (CLI)](connectors-cli.md)
+  [什麼是 AWS IoT Analytics？](https://docs.aws.amazon.com/iotanalytics/latest/userguide/welcome.html) *AWS IoT Analytics 《 使用者指南*》中的