Konfigurace koncových bodů toku dat pro místní úložiště

Důležité

Tato stránka obsahuje pokyny ke správě komponent operací Azure IoT pomocí manifestů nasazení Kubernetes, které jsou ve verzi Preview. Tato funkce je poskytována s několika omezeními a neměla by se používat pro produkční úlohy.

Další podmínky použití pro Microsoft Azure Preview najdete v právních podmínkách, které se vztahují na funkce Azure, které jsou v beta verzi, preview nebo jinak dosud nebyly vydány v obecné dostupnosti.

Pokud chcete odesílat data do místního úložiště v operacích Azure IoT, můžete nakonfigurovat koncový bod toku dat. Tato konfigurace umožňuje zadat koncový bod, ověřování, tabulku a další nastavení.

Požadavky

• Instance Azure IoT Operations
• A PersistentVolumeClaim (PVC)

Vytvoření koncového bodu toku dat místního úložiště

Pomocí možnosti místního úložiště můžete odesílat data do místně dostupného trvalého svazku, prostřednictvím kterého můžete odesílat data prostřednictvím služby Azure Container Storage s povolenými hraničními svazky Azure Arc.

Zkušenosti z provozu

1. V provozním prostředí vyberte kartu Koncové body toku dat .

2. V části Vytvořit nový koncový bod toku dat vyberte Místní úložiště>Nové.

   

3. Zadejte následující nastavení pro koncový bod:

   Nastavení	Popis
   Název	Název koncového bodu toku dat.
   Název deklarace identity trvalého svazku	Název PersistentVolumeClaim (PVC) pro místní úložiště.

4. Vyberte Použít pro konfiguraci koncového bodu.

Azure CLI

Vytvoření nebo nahrazení

Pomocí příkazu az iot ops dataflow endpoint create fabric-onelake vytvořte nebo nahraďte koncový bod toku dat místního úložiště.

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

Parametr --pvc-ref je název PersistentVolumeClaim (PVC), který se má použít pro místní úložiště. PVC musí být ve stejném jmenném prostoru jako koncový bod toku dat.

Tady je ukázkový příkaz pro vytvoření nebo nahrazení koncového bodu toku dat místního úložiště s názvem local-storage-endpoint:

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

Vytvoření nebo změna

K vytvoření nebo změně koncového bodu toku dat místního úložiště použijte příkaz az iot ops dataflow endpoint apply.

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

Parametr --config-file je cesta a název souboru JSON, který obsahuje vlastnosti prostředku.

V tomto příkladu předpokládejme konfigurační soubor s následujícím local-storage-endpoint.json obsahem uloženým v domovském adresáři uživatele:

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

Tady je ukázkový příkaz pro vytvoření nového koncového bodu toku dat místního úložiště s názvem 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

Vytvořte soubor Bicep .bicep s následujícím obsahem.

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

Pak nasaďte pomocí Azure CLI.

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

Kubernetes (Preview)

Vytvořte soubor manifestu .yaml Kubernetes s následujícím obsahem.

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

Pak použijte soubor manifestu na cluster Kubernetes.

kubectl apply -f <FILE>.yaml

PersistentVolumeClaim (PVC) musí být ve stejném oboru názvů jako DataflowEndpoint.

Podporované formáty serializace

Jediným podporovaným formátem serializace je Parquet.

Použití služby Azure Container Storage povolené službou Azure Arc (ACSA)

Pomocí koncového bodu toku dat místního úložiště můžete společně se službou Azure Container Storage povolenou službou Azure Arc ukládat data místně nebo odesílat data do cloudového cíle.

Místní sdílený svazek

Pokud chcete zapisovat na místní sdílený svazek, nejprve vytvořte PersistentVolumeClaim (PVC) podle pokynů uvedených v Local Shared Edge Volumes.

Pak při konfiguraci koncového bodu toku dat místního úložiště zadejte název PVC pod persistentVolumeClaimRef.

Ingestování cloudu

Pokud chcete zapisovat data do cloudu, postupujte podle pokynů v konfiguraci svazků Cloud Ingest Edge a vytvořte PVC a připojte podvolume pro váš požadovaný cíl v cloudu.

Důležité

Nezapomeňte vytvořit podvolume po vytvoření PVC, jinak se tok dat nespustí a v protokolech se zobrazí chyba systému souborů jen pro čtení.

Pak při konfiguraci koncového bodu toku dat místního úložiště zadejte název PVC pod persistentVolumeClaimRef.

Nakonec při vytváření toku dat musí parametr cíle dat odpovídat spec.path parametru, který jste vytvořili pro podvolume během konfigurace.

Další kroky

Další informace o tocích dat najdete v tématu Vytvoření toku dat.