使用資產屬性通知將資料匯出至 Amazon S3 - AWS IoT SiteWise

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

使用資產屬性通知將資料匯出至 Amazon S3

您可以將從AWS IoT SiteWise存放至您賬户中的 Amazon S3 儲存貯體。您可以使用可用來建立歷史報表或使用複雜方法分析資料的格式來備份資料。

注意

AWS IoT SiteWise還支持冷層存儲,允許您將數據保存在客户管理的 Amazon S3 存儲桶中。如需支援的儲存層的詳細資訊,請參管理資料儲存

AWS IoT SiteWise 將此功能做為 AWS CloudFormation 範本提供。當您從範本建立堆疊時,AWS CloudFormation 會建立所需的 AWS 資源,以將來自 AWS IoT SiteWise 的傳入資料串流至 S3 儲存貯體。

然後,S3 儲存貯體會接收來自 AWS IoT SiteWise 屬性值更新訊息傳送的所有資產屬性資料。S3 儲存貯體也會接收您的資產中繼資料,包括資產和屬性名稱及其他資訊。

如需如何啟用屬性值更新訊息以供資產屬性匯出至 Amazon S3 的詳細資訊,請參與其他 AWS 服務互動

此功能會將資產屬性資料和資產中繼資料儲存在Apache Parquet格 Amazon S3。Parquet 是單欄資料格式,相較於橫列導向格式 (如 JSON) 更可節省空間,並加快查詢速度。

注意

此功能會檢索資產中繼資料時,最多可支援 1,500 個資產。此限制僅適用於資產中繼資料。此限制不適用於功能匯出資產屬性資料時支援的資產數量。

每個資源名稱都包含可讓您在建立堆疊時自訂的前置詞。資源包括下列項目:

  • Amazon S3 儲存貯體

  • AWS Lambda 函式

  • AWS IoT Core 規則

  • AWS Identity and Access Management 角色

  • Amazon Kinesis Data Firehose 串流

  • AWS Glue 資料庫

如需完整清單,請參閱 從範本建立的資源

重要

您將為此 AWS CloudFormation 範本建立和使用的資源付費。這些費用包括多項 AWS 服務的資料儲存和資料傳輸。

建立 AWS CloudFormation 堆疊

您可以在AWS CloudFormation將資產資料匯出至 Amazon S3。

若要將資料匯出至 Amazon S3

  1. 開啟 AWS CloudFormation 範本 並登入 AWS Management Console。

  2. Create stack (建立堆疊) 頁面上,選擇頁面底部的 Next (下一步)

  3. 指定堆疊詳細資訊頁面上,輸入BucketName中繼資料,此範本建立用來接收資產資料之 S3 儲存貯體。此儲存貯體名稱必須是全球獨一無二的。如需詳細資訊,請參閱 Amazon Simple Storage Service 使用者指南中的儲存貯體命名規則

  4. (選用) 變更範本的任何其他參數:

    • GlobalResourcePrefix— 從此範本建立之全域資源名稱 (例如 IAM 角色) 的前置詞。

    • LocalResourcePrefix— 在目前區域中,從此範本建立的資源名稱前置詞。

    注意

    如果您建立此範本多次,則應變更儲存貯體名稱和資源前置詞參數,以避免資源名稱衝突。

  5. 選擇 Next (下一步)。

  6. Configure stack options (設定堆疊選項) 頁面,選擇 Next (下一步)。

  7. 在頁面底部,選取表示我承認AWS CloudFormation可能會創建 IAM 資源

  8. 選擇 Create Stack (建立堆疊)。

    堆疊需要幾分鐘的時間建立。如果堆疊無法建立,表示您的帳戶可能沒有足夠許可,或者您輸入的儲存貯體名稱可能已經存在。請使用下列步驟刪除堆疊後再試一次:

    1. 選擇右上角的 Delete (刪除)

      堆疊需要幾分鐘的時間刪除。

      注意

      AWS CloudFormation 不會刪除 S3 儲存貯體或 CloudWatch 日誌群組。您可以在這些服務的主控台中刪除這些資源。

    2. 如果堆疊無法刪除,請再次選擇 Delete (刪除)

    3. 如果堆疊再次無法刪除,請依照 AWS CloudFormation 主控台中的步驟略過無法刪除的資源,然後再試一次。

  9. 之後AWS CloudFormation成功建立堆疊,請遵循下一個程序來探索 Amazon S3 中的資產屬性資料。

重要

建立堆疊後,您即可在 AWS 帳戶中看到新的資源。如果您刪除或修改這些資源,此功能可能會停止正確運作。建議您不要修改這些資源,除非您想要停止將資料傳送至儲存貯體,或想要自訂此功能。

在 Amazon S3 中查看您的資料

建立功能後,您可以在 Amazon S3 中檢視資產屬性資料和資產中繼資料。

注意

資產中繼資料每六個小時更新一次。您可能需要等候 6 小時,才能看到資產中繼資料顯示在 S3 儲存貯體中。

此功能會將資產屬性資料存放在下列欄位中,其中每列都包含一個資料點:

  • 類型— 屬性通知的類型 (PropertyValueUpdate

  • 資產編號— 接收資料點的資產 ID。

  • 資產屬性 ID— 接收資產之資料點的屬性 ID。

  • 時間秒— 接收資料的時間 (以秒為單位),以 Unix 紀元時間表示。

  • in_nanos— 從timeInSeconds

  • 資產屬性質量— 資料點的質量:GOODUNCERTAIN, 或BAD

  • 資產屬性值— 資料點的值。

  • 資產屬性數據類型— 資產屬性的資料類型:booleandoubleinteger, 或string

此功能會將資產中繼資料存放在下列欄位中,其中每列都包含一個資產屬性:

  • 資產編號— 資產的 ID。

  • 資產名稱— 資產的名稱。

  • 資產模型編號— 資產模型的 ID。

  • 資產屬性 ID— 資產屬性的 ID。

  • 資產屬性名稱— 資產屬性的名稱。

  • 資產屬性數據類型— 資產屬性的資料類型:BOOLEANDOUBLEINTEGER, 或STRING

  • 資產屬性單位— 資產屬性的單位。

  • 資產屬性別名— 資產屬性的別名。

檢視您的AWS IoT SiteWiseAmazon S3 中的資料

  1. 導覽至 。Amazon S3 主控台

  2. 從儲存貯體清單中,選擇具有您在建立範本時所選名稱的儲存貯體。

  3. 在儲存貯體中,選擇下列其中一個檔案夾:

    • asset-property-updates— 此資料夾包含從AWS IoT SiteWise。

    • asset-metadata— 此資料夾包含從AWS IoT SiteWise。

  4. 選擇您要檢視的物件。

  5. 在物件的頁面上,執行下列動作:

    1. 選擇 Select from (選取來源) 標籤。

      在此面板中,您可以預覽來自 Parquet 檔案的記錄。

    2. 適用於檔案格式,選擇Parquet

    3. 若要以 JSON 格式顯示檔案的內容,請選擇顯示檔案預覽

注意

如果新資料未顯示在儲存貯體中,請檢查您是否已為資產屬性啟用屬性值更新通知。如需詳細資訊,請參閱 與其他 AWS 服務互動

如需如何分析儲存於 S3 儲存貯體中的資產資料,請參閱 使用 Amazon Athena 分析匯出的資料