ローカル ストレージ用のデータフロー エンドポイントを構成する

重要

このページでは、Kubernetes デプロイ マニフェストを使用した Azure IoT Operations コンポーネント管理の手順について記述しています (これはプレビュー段階です)。 この機能は いくつかの制限を設けて提供されており、運用環境のワークロードに使用すべきものではありません。

ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

Azure IoT Operations でローカル ストレージにデータを送信するには、データフロー エンドポイントを構成できます。 この構成では、エンドポイント、認証、テーブル、その他の設定を指定できます。

前提条件

• Azure IoT Operations のインスタンス
• PersistentVolumeClaim (PVC)

ローカル ストレージ データフロー エンドポイントを作成する

ローカル ストレージ オプションを使用して、ローカルで使用可能な永続ボリュームにデータを送信します。これにより、Azure Arc エッジ ボリュームで有効になっている Azure コンテナー ストレージ経由でデータをアップロードできます。

ポータル

1. 操作エクスペリエンスで、[データフロー エンドポイント] タブを選択します。

2. [新しいデータフロー エンドポイントの作成] で、[ローカル ストレージ]>[新規] を選びます。

   

3. エンドポイントに関する次の設定を入力します。

   設定	内容
   Name	データフロー エンドポイントの名前。
   永続ボリューム要求名	ローカル ストレージに使用する PersistentVolumeClaim (PVC) の名前。

4. [適用] を選択してエンドポイントをプロビジョニングします。

Bicep

次の内容を含む 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 パラメーターと一致する必要があります。

次のステップ

データフローの詳細については、データフローの作成に関するページを参照してください。