Configurar puntos de conexión de flujo de datos para el almacenamiento local

Artículo
11/21/2024

Importante

En esta página, se incluyen instrucciones para administrar los componentes de Operaciones de IoT de Azure mediante manifiestos de implementación de Kubernetes, que se encuentra en versión preliminar. Esta característica se proporciona con varias limitaciones y no se debe usar para cargas de trabajo de producción.

Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

Para enviar datos al almacenamiento local en Azure IoT Operations, puede configurar un punto de conexión de flujo de datos. Esta configuración permite especificar el punto de conexión, la autenticación, la tabla y otras opciones.

Requisitos previos

Una instancia de Operaciones de IoT de Azure
Un PersistentVolumeClaim (PVC)

Crear un punto de conexión de flujo de datos de almacenamiento local

Use la opción de almacenamiento local para enviar datos a un volumen persistente disponible localmente, a través del cual puede cargar datos a través de Azure Container Storage habilitado por volúmenes perimetrales de Azure Arc.

En la experiencia de operaciones, seleccione la pestaña Puntos de conexión de flujo de datos.
En Crear nuevo punto de conexión de flujo de datos, seleccione Almacenamiento local>Nuevo.

Escriba la siguiente configuración para el punto de conexión:

Configuración	Descripción
Nombre	Nombre del punto de conexión de flujo de datos.
Nombre de notificación de volumen persistente	Nombre de PersistentVolumeClaim (PVC) que se va a usar para el almacenamiento local.

Seleccione Aplicar para aprovisionar el punto de conexión.

Cree un archivo .bicep de Bicep con el siguiente contenido.

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
    }
  }
}

A continuación, realice la implementación mediante la CLI de Azure.

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

Cree un archivo .yaml de manifiesto de Kubernetes con el siguiente contenido.

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

A continuación, aplique el archivo de manifiesto al clúster de Kubernetes.

kubectl apply -f <FILE>.yaml

PersistentVolumeClaim (PVC) debe estar en el mismo espacio de nombres que el DataflowEndpoint.

Formatos de serialización admitidos

El único formato de serialización admitido es Parquet.

Uso del Almacenamiento de contenedores de Azure habilitado por Azure Arc (ACSA)

Puede usar el punto de conexión de flujo de datos de almacenamiento local junto con el Almacenamiento de contenedores de Azure habilitado por Azure Arc para almacenar datos localmente o enviar datos a un destino en la nube.

Volumen local de recursos compartidos

Para escribir en un volumen compartido local, cree primero PersistentVolumeClaim (PVC) según las instrucciones de volúmenes perimetrales compartidos locales.

A continuación, al configurar el punto de conexión de flujo de datos de almacenamiento local, escriba el nombre de PVC en persistentVolumeClaimRef.

Ingesta en la nube

Para escribir los datos en la nube, siga las instrucciones de configuración de volúmenes perimetrales de ingesta en la nube para crear una PVC y adjuntar un subvolumen para el destino de nube deseado.

Importante

No olvide crear el subvolumen después de crear la PVC o, de lo contrario, el flujo de datos no se puede iniciar y los registros muestran un error de "sistema de archivos de solo lectura".

A continuación, al configurar el punto de conexión de flujo de datos de almacenamiento local, escriba el nombre de PVC en persistentVolumeClaimRef.

Por último, al crear el flujo de datos, el parámetro de destino de datos debe coincidir con el parámetro spec.path que creó para el subvolumen durante la configuración.

Pasos siguientes

Para obtener más información sobre los flujos de datos, consulte Creación de un flujo de datos.

Compartir vía