設定資料流程設定檔

2025-06-22

重要事項

此頁面包含使用 Kubernetes 部署資訊清單 (其處於預覽) 來管理 Azure IoT 操作元件的指示。此功能的提供具有數項限制，因此不應用於生產工作負載。

請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

資料流程設定檔可用來將資料流程群組在一起，以便共用相同的設定。您可以建立多個資料流程設定檔來管理不同資料流程設定的集合。

最重要的設定是實例計數。針對指定的數據流，實例計數會決定在叢集上執行的複本數目。例如，您可能會有一個資料流程設定檔具有單一執行個體用於開發和測試，以及另一個設定檔具有多個執行個體用於生產環境。或者，您可以將具有低執行個體計數的資料流程設定檔用於低輸送量資料流程，以及將具有高執行個體計數的設定檔用於高輸送量資料流程。同樣地，您可以建立具有不同診斷設定的資料流程設定檔以進行偵錯。

預設資料流程設定檔

部署 Azure IoT 作業時，會建立名為 default 的數據流配置檔。您可以使用此資料流程設定檔來開始使用 Azure IoT 操作。

若要檢視預設數據流配置檔，請移至 Azure 入口網站中的 IoT 作業實例。
在 [ 元件] 下方的左窗格中，選取 [數據流配置檔]。
選取預設數據流配置檔。

使用 az iot operations dataflow profile show 命令來檢視默認數據流配置檔：

az iot operations dataflow profile show --resource-group <ResourceGroupName> --instance <AioInstanceName> --name default

以下是範例命令，可檢視預設數據流配置檔：

az iot operations dataflow profile show --resource-group myResourceGroup --instance myAioInstance --name default

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

// Pointer to the Azure IoT Operations instance
resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}

// Pointer to your custom location where AIO is deployed
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}

// Pointer to the default data flow profile
resource defaultDataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: default
  namespace: azure-iot-operations
spec:
  instanceCount: 1

除非您需要額外的輸送量或備援，否則可以對您的資料流程使用預設資料流程設定檔。如果您需要調整執行個體計數或其他設定，您可以建立新的資料流程設定檔。

建立新的資料流程設定檔

若要建立新的資料流程設定檔，請指定設定檔的名稱和執行個體計數。

重要事項

數據配置檔名稱長度必須介於 1 到 39 個字元之間。

在 Azure 入口網站中，移至您的 IoT 操作執行個體。
在 [ 元件] 下方的左窗格中，選取 [數據流配置檔]。
選取 [+ 資料流設定檔 ] 以建立新的資料流設定檔。
在 [ 建立數據流配置檔 ] 窗格中，輸入數據流配置檔的名稱，並設定實例計數。您也可以設定其他設定，例如診斷設定。

使用 az iot operations dataflow profile create 命令來建立新的數據流配置檔：

az iot operations dataflow profile create --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName>

以下是建立名為 myDataFlowProfile的新資料流設定檔的範例命令：

az iot operations dataflow profile create --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: <COUNT>
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: <COUNT>

調整大小

您可以調整資料流程設定檔的大小，以調整執行資料流程的執行個體數目。針對指定的數據流，實例計數是叢集上執行的複本數目。增加執行個體計數可以藉由建立多個用戶端來處理資料，來改善資料流程的輸送量。使用的資料流程中的雲端服務具有每個用戶端的速率限制時，增加執行個體計數可協助您保持在速率限制內。

調整也可以藉由在失敗時提供備援來改善資料流程的復原能力。

若要手動調整資料流程設定檔，請指定您想要執行的執行個體數目。例如，若要將執行個體計數設定為 3：

在 Azure 入口網站中，移至您的 IoT 操作執行個體。
在 [ 元件] 下方的左窗格中，選取 [數據流配置檔]。
選取您想要設定的數據流配置檔。
使用滑桿來設定實例計數。

使用 az iot operations dataflow profile update 命令來更新數據流配置檔的實例計數：

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --profile-instance <InstanceCount>

以下是將資料流設定檔 myDataFlowProfile的實例計數設定為三個的範例命令：

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --profile-instances 3

properties: {
  instanceCount: 3
}

spec:
  instanceCount: 3

診斷設定

您可以設定資料流程設定檔的其他診斷設定，例如記錄層級。

多數情況下使用預設設定即可。不過，您可以覆寫記錄層級或其他設定以進行偵錯。

若要了解如何設定這些診斷設定，請參閱 ProfileDiagnostics。

在 Azure 入口網站中，移至您的 IoT 操作執行個體。
在 [元件] 底下，選取 [數據流配置檔]。
選取您想要設定的數據流配置檔。

使用 az iot operations dataflow profile update 命令來更新數據流配置檔的診斷設定：

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --log-level <level>

以下是一個範例命令，用於將資料流設定檔debug的記錄層級設定為myDataFlowProfile：

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --log-level debug

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: 1
    diagnostics: {
      {
        logs: {
          level: 'debug'
        }
      }
    }
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: 1
  diagnostics:
    logs:
      level: debug

後續步驟

若要深入了解資料流程，請參閱建立資料流程。