將工業資料流對映至資產屬性 - AWS IoT SiteWise
設定屬性別名 (主控台)設定屬性別名 (AWS CLI)

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

將工業資料流對映至資產屬性

您可以在資產性質上定義性質別名。這可協助您在擷取或擷取資產資料時識別資產屬性。如果您的資產具有度量屬性，您可以定義屬性別名，以將資料串流對映至這些測量屬性。

此程序需要您知道屬性別名。

  • 如果您使用 SiteWise Edge 閘道中的 OPC UA 資料來源從 OPC UA 伺服器擷取資料，則屬性別名是「物件」節點下變數的路徑，從開始/。

    範例

    如果變量的路徑是company/windfarm/3/turbine/7/temperature，那麼您的屬性別名是/company/windfarm/3/turbine/7/temperature。

    如需 OPC UA 資訊架構的詳細資訊，請參閱 OPCUA Online 參考資料中的資訊模型和位址間距對映。

    備註

    • 如果您為 OPC UA 來源設定資料串流首碼，則必須在該來源的所有資料串流的屬性別名中包含該首碼。

      範例

      如果/RentonWA是前綴，則上一個別名為/RentonWA/company/windfarm/3/turbine/7/temperature。

    • 內容別名最多可包含 1,000 個位元組。OPCUA 變數路徑最多可包含 4,096 個位元組。目前， AWS IoT SiteWise 不支援從具有長路徑的 OPC UA 變數擷取資料。

  • 如果您使用 SiteWise Edge 閘道中的 Modbus 資料來源從 Modbus 伺服器擷取TCP資料，您的屬性別名為：

    register set tag name

    使用此值從此寄存器設置數據發送到資產屬性。

  • 如果您從其他來源 (例如使用AWS IoT 規則或) 內嵌資料 API，則必須定義屬性別名。您可以定義適用於裝置組態的屬性別名命名系統。例如，如果您是從 AWS IoT 實物擷取資料，您可以將該實物名稱包含在屬性別名中，以便唯一地識別資料串流。如需有關此範例的詳細資訊，請參閱從 AWS IoT 物件擷取資料教學課程。

屬性別名在區域和 AWS 帳戶中必須是唯一的。 AWS IoT SiteWise 如果您將屬性別名設定為另一個資產屬性上已存在的屬性別名，則會傳回錯誤。

如果您有多個具有相同資料串流路徑的 OPC UA 來源，請為每個來源的路徑新增前置詞，以形成唯一的別名。如需詳細資訊，請參閱OPCUA 資料來源。

注意

本節說明如何設定測量屬性的性質別名。如需如何為外部警示狀態內容設定屬性別名的詳細資訊，請參閱對應外部警示狀態串流。

設定屬性別名 (主控台)

您可以使用 AWS IoT SiteWise 主控台來設定資產屬性的別名。

設定屬性別名 (主控台)

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在導覽窗格中，選擇 Assets (資產)。

  3. 選擇您要為其設定屬性別名的資產。

    提示

    您可以選擇箭頭圖示來展開資產階層，以尋找您的資產。

  4. 選擇編輯。

  5. 尋找您要設定別名的屬性，然後輸入屬性別名。

    AWS IoT SiteWise 「編輯資產」頁面截圖，並突出顯示屬性別名。

  6. 選擇 Save (儲存)。

設定屬性別名 (AWS CLI)

使用 AWS Command Line Interface (AWS CLI) 設定資產屬性的別名。

您必須知道資產的 assetId 和財產的 propertyId，才能完成此程序。您也可以使用外部 ID。如果您已建立資產但不知道資產assetId，請使ListAssetsAPI用列出特定模型的所有資產。使用此DescribeAsset作業可檢視資產的屬性，包括屬性IDs。

使用此UpdateAssetProperty作業，將資料串流對應至資產的屬性。指定下列參數：

  • assetId— 資產的 ID 或外部 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部參考物件 IDs。

  • propertyId— 資產屬性的 ID 或外部 ID。

  • propertyAlias— 資料串流屬性別名的路徑。

  • propertyNotificationState— 屬性值通知狀態：ENABLED或DISABLED。當您更新屬性別名時，指定屬性的現有通知狀態。您可以透過DescribeAssetProperty作業擷取現有的通知狀態。

    如果您省略此參數，則新的通知狀態會是 DISABLED。如需屬性通知的詳細資訊，請參閱與其他 AWS 服務互動。

設定屬性別名 (AWS CLI)

  1. 執行下列命令來擷取屬性目前通知的狀態。Replace (取代) asset-id 以及 property-id 與資產屬性的IDs。

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    此操作會以下列格式傳回包含資產屬性詳細資料的回應。屬性通知狀態位assetProperty.notification.state於JSON物件中。

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. 執行下列命令來設定資產屬性的別名。Replace (取代) property-alias 與屬性別名和 notification-state 使用通知狀態，或忽略--property-notification-state以禁用通知。您可以選擇使用新的資產單位來更新資產的單位 unit 和--property-unit。

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit

  3. 若要確認已設定別名，請執行下列命令以擷取屬性的詳細資訊。Replace (取代) asset-id 以及 property-id 與資產屬性的IDs。

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    此操作會以下列格式傳回包含資產屬性詳細資料的回應。屬性別名位於JSON物件assetProperty.alias中，並在此範例myAlias中設定為。

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}