Gegevensstroomeindpunten configureren voor lokale opslag

Belangrijk

Deze pagina bevat instructies voor het beheren van Azure IoT Operations-onderdelen met behulp van Kubernetes-implementatiemanifesten, die in preview zijn. Deze functie is voorzien van verschillende beperkingen en mag niet worden gebruikt voor productieworkloads.

Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

Als u gegevens wilt verzenden naar lokale opslag in Azure IoT Operations, kunt u een gegevensstroomeindpunt configureren. Met deze configuratie kunt u het eindpunt, de verificatie, de tabel en andere instellingen opgeven.

Vereisten

• Een exemplaar van Azure IoT-bewerkingen
• Een PersistentVolumeClaim (PVC)

Een eindpunt voor een lokale opslaggegevensstroom maken

Gebruik de optie voor lokale opslag om gegevens te verzenden naar een lokaal beschikbaar permanent volume, waarmee u gegevens kunt uploaden via Azure Container Storage die is ingeschakeld door Azure Arc-edge-volumes.

Bewerkingservaring

1. Selecteer in de bewerkingservaring het tabblad Eindpunten van gegevensstroom.

2. Selecteer onder Nieuw eindpunt voor gegevensstroom maken de optie Nieuwe lokale opslag>.

   

3. Voer de volgende instellingen in voor het eindpunt:

   Instelling	Omschrijving
   Naam	De naam van het eindpunt van de gegevensstroom.
   Naam van permanente volumeclaim	De naam van de PersistentVolumeClaim (PVC) die moet worden gebruikt voor lokale opslag.

4. Selecteer Toepassen om het eindpunt in te richten.

Azure-CLI

Maken of vervangen

Gebruik de opdracht az iot ops dataflow endpoint create fabric-onelake om een eindpunt voor een lokale opslaggegevensstroom te maken of te vervangen.

az iot ops dataflow endpoint create local-storage --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --pvc-ref <PersistentVolumeClaimName>

De --pvc-ref parameter is de naam van de PersistentVolumeClaim (PVC) die moet worden gebruikt voor lokale opslag. Het PVC moet zich in dezelfde naamruimte bevinden als het eindpunt van de gegevensstroom.

Hier volgt een voorbeeldopdracht voor het maken of vervangen van een lokaal eindpunt voor de opslaggegevensstroom met de naam local-storage-endpoint:

az iot ops dataflow endpoint create local-storage --resource-group myResourceGroup --instance myAioInstance --name local-storage-endpoint --pvc-ref mypvc

Maken of wijzigen

Gebruik de opdracht az iot ops dataflow endpoint apply om een eindpunt voor een lokale opslaggegevensstroom te creëren of te wijzigen.

az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>

De --config-file parameter is het pad en de bestandsnaam van een JSON-configuratiebestand met de resource-eigenschappen.

In dit voorbeeld wordt ervan uitgegaan dat een configuratiebestand met de naam local-storage-endpoint.json de volgende inhoud bevat die is opgeslagen in de basismap van de gebruiker:

{
    "endpointType": "LocalStorage",
    "localStorageSettings": {
        "persistentVolumeClaimRef": "<PersistentVolumeClaimName>"
    }
}

Hier volgt een voorbeeldopdracht voor het maken van een nieuw eindpunt voor de lokale opslaggegevensstroom met de naam local-storage-endpoint:

az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name local-storage-endpoint --config-file ~/local-storage-endpoint.json

Biceps

Maak een Bicep-bestand .bicep met de volgende inhoud.

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

Implementeer vervolgens via Azure CLI.

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

Kubernetes (preview)

Maak een Kubernetes-manifestbestand .yaml met de volgende inhoud.

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

Pas vervolgens het manifestbestand toe op het Kubernetes-cluster.

kubectl apply -f <FILE>.yaml

De PersistentVolumeClaim (PVC) moet zich in dezelfde naamruimte bevinden als het DataflowEndpoint.

Ondersteunde serialisatie-indelingen

De enige ondersteunde serialisatie-indeling is Parquet.

Azure Container Storage gebruiken die is ingeschakeld door Azure Arc (ACSA)

U kunt het eindpunt voor de lokale opslaggegevensstroom gebruiken samen met Azure Container Storage ingeschakeld door Azure Arc om gegevens lokaal op te slaan of gegevens naar een cloudbestemming te verzenden.

Lokaal gedeeld volume

Als u naar een lokaal gedeeld volume wilt schrijven, maakt u eerst een PersistentVolumeClaim (PVC) op basis van de instructies van lokale gedeelde edge-volumes.

Wanneer u vervolgens uw eindpunt voor de lokale opslaggegevensstroom configureert, voert u de PVC-naam in onder persistentVolumeClaimRef.

Cloudopname

Als u uw gegevens naar de cloud wilt schrijven, volgt u de instructies in de configuratie van Cloud Ingest Edge Volumes om een PVC te maken en een subvolume toe te voegen voor uw gewenste cloudbestemming.

Belangrijk

Vergeet niet om het subvolume te maken nadat u het PVC hebt gemaakt of anders kan de gegevensstroom niet worden gestart en de logboeken geven de foutmelding Alleen-lezenbestandssysteem weer.

Wanneer u vervolgens uw eindpunt voor de lokale opslaggegevensstroom configureert, voert u de PVC-naam in onder persistentVolumeClaimRef.

Wanneer u de gegevensstroom maakt, moet de parameter voor de gegevensbestemming overeenkomen met de parameter die u tijdens de spec.path configuratie voor uw subvolume hebt gemaakt.

Volgende stappen

Zie Een gegevensstroom maken voor meer informatie over gegevensstromen.