你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

为本地存储配置数据流终结点

项目
11/20/2024

重要

本页包含使用 Kubernetes 部署清单（目前为预览版）管理 Azure IoT 操作组件的说明。此功能存在若干限制，不应该用于生产工作负载。

有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款，请参阅 Microsoft Azure 预览版的补充使用条款。

若要将数据发送到 Azure IoT 操作中的本地存储，可以配置数据流终结点。此配置让你可以指定终结点、身份验证、表和其他设置。

先决条件

Azure IoT 操作的实例
一个 PersistentVolumeClaim (PVC)

创建一个本地存储数据流终结点

使用本地存储选项将数据发送到本地可用的永久性卷，借助此卷，你可以通过 Azure Arc 边缘卷启用的 Azure 容器存储上传数据。

在操作体验中，选择“数据流终结点”选项卡。
在“创建新的数据流终结点”下，选择“本地存储”>“新建”。
输入以下用于终结点的设置：

设置说明

Name 数据流终结点的名称。

永久性卷声明名称要用于本地存储的 PersistentVolumeClaim (PVC) 的名称。
选择“应用”来预配终结点。

设置	说明
Name	数据流终结点的名称。
永久性卷声明名称	要用于本地存储的 PersistentVolumeClaim (PVC) 的名称。

创建包含以下内容的 Bicep .bicep 文件。

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param persistentVCName string = '<PERSISTENT_VC_NAME>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource localStorageDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'LocalStorage'
    localStorageSettings: {
      persistentVolumeClaimRef: persistentVCName
    }
  }
}

然后，通过 Azure CLI 进行部署。

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

创建具有以下内容的 Kubernetes 清单 .yaml 文件。

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: LocalStorage
  localStorageSettings:
    persistentVolumeClaimRef: <PVC_NAME>

然后，将清单文件应用到 Kubernetes 群集。

kubectl apply -f <FILE>.yaml

PersistentVolumeClaim (PVC) 必须与 DataflowEndpoint 位于同一命名空间中。

支持的序列化格式

唯一支持的序列化格式是 Parquet。

使用 Azure Arc 启用的 Azure 容器存储 (ACSA)

可以将本地存储数据流终结点与 Azure Arc 启用的 Azure 容器存储结合使用，以在本地存储数据或将数据发送到云目标。

本地共享卷

若要写入本地共享卷，请先根据本地共享边缘卷中的说明创建 PersistentVolumeClaim (PVC)。

然后，在配置本地存储数据流终结点时，在 persistentVolumeClaimRef 下输入 PVC 名称。

云引入

若要将数据写入云，请按照云引入边缘卷配置中的说明为所需的云目标创建 PVC 并附加子卷。

重要

创建 PVC 后不要忘记创建子卷，否则数据流无法启动，日志会显示“只读文件系统”错误。

然后，在配置本地存储数据流终结点时，在 persistentVolumeClaimRef 下输入 PVC 名称。

最后，创建数据流时，数据目标参数必须与在配置期间为子卷创建的 spec.path 参数匹配。

后续步骤

要了解有关数据流的详细信息，请参阅创建数据流。

通过