Azure IoT Operationsのローカルストレージにデータを送信するには、データフローエンドポイントを構成します。 この構成では、エンドポイント、認証、テーブル、およびその他の設定を指定できます。
前提条件
開発用コンピューターにインストールされている Azure CLI バージョン 2.62.0 以降。
az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。 詳細については、「 Azure CLI のインストール」を参照してください。
Azure CLIのAzure IoT Operations拡張機能。 次のコマンドを使用して、拡張機能を追加するか、それを最新バージョンに更新します。
az extension add --upgrade --name azure-iot-ops
ローカルストレージデータフローのエンドポイントを作成する
ローカル ストレージ オプションを使用して、ローカルで使用可能な永続ボリュームにデータを送信します。 これを使用して、Azure Arcエッジ ボリュームで有効になっている Azure Container Storage 経由でデータをアップロードできます。
操作エクスペリエンスで、Data flow エンドポイント タブを選択します。
[新しいデータフローエンドポイントの作成で、[ローカルストレージ>"New" を選択します。
エンドポイントに関する次の設定を入力します。
| 設定 |
内容 |
| 名前 |
データフローエンドポイントの名前。 |
| 永続ボリューム要求名 |
ローカル ストレージに使用する PVC の名前。 |
[適用] を選択してエンドポイントをプロビジョニングします。
作成または置換
az iot ops データフロー エンドポイント create fabric-onelake コマンドを使用して、ローカルストレージのデータフローエンドポイントを置換または作成します。
az iot ops dataflow endpoint create local-storage --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --pvc-ref <PersistentVolumeClaimName>
--pvc-ref パラメーターは、ローカル ストレージに使用する PVC の名前です。 PVC は、data flow エンドポイントと同じ名前空間に存在する必要があります。
次のコマンド例では、 local-storage-endpointという名前のローカル ストレージ データ フロー エンドポイントを作成または置換します。
az iot ops dataflow endpoint create local-storage --resource-group myResourceGroup --instance myAioInstance --name local-storage-endpoint --pvc-ref mypvc
作成または変更
ローカルストレージデータフローエンドポイントを作成または変更するには、az iot ops データフローエンドポイントを適用 コマンドを使用します。
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
--config-file パラメーターは、リソース プロパティを含む JSON 構成ファイルのパスとファイル名です。
この例では、次の内容の local-storage-endpoint.json という名前の構成ファイルがユーザーのホーム ディレクトリに格納されているとします。
{
"endpointType": "LocalStorage",
"localStorageSettings": {
"persistentVolumeClaimRef": "<PersistentVolumeClaimName>"
}
}
次のコマンド例では、 local-storage-endpointという名前の新しいローカル ストレージ データ フロー エンドポイントを作成します。
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name local-storage-endpoint --config-file ~/local-storage-endpoint.json
次の内容を含む .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@2026-03-01' existing = {
name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
name: customLocationName
}
resource localStorageDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2026-03-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 配置マニフェストの使用は運用環境ではサポートされていないため、デバッグとテストにのみ使用する必要があります。
次の内容を含む 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
PVC は、 DataflowEndpointと同じ名前空間に存在する必要があります。
サポートされているシリアル化形式は Parquet のみです。
Azure Arc で有効化された Azure Container Storage を使用する
ローカルストレージデータフローのエンドポイントを、Azure Arc によって有効化された Azure コンテナー ストレージ と共に使用することで、データをローカルに保存することも、クラウドの宛先に送信することも可能です。
ローカル共有ボリューム
ローカル共有ボリュームに書き込むには、まずローカル 共有エッジ ボリュームの手順に従って PVC を作成します。
ローカル ストレージ データ フロー エンドポイントを構成するときは、 persistentVolumeClaimRefの下に PVC 名を入力します。
クラウド取り込み
クラウドにデータを書き込むには、 クラウド取り込みエッジ ボリューム構成 の手順に従って PVC を作成し、必要なクラウド宛先のサブボリュームをアタッチします。
クラウドの取り込みを構成するには、クラスターでセキュリティで保護された設定が有効になっている必要があります。 クラウド取り込み機能は、 ワークロード ID フェデレーションに依存します。
重要
PVC を作成した後は、必ずサブボリュームを作成してください。 それ以外の場合、データ フローの開始に失敗し、ログに "読み取り専用ファイル システム" エラーが表示されます。
ローカル ストレージ データ フロー エンドポイントを構成するときは、 persistentVolumeClaimRefの下に PVC 名を入力します。
最後に、データ フローを作成するときに、 データ変換先 パラメーターは、構成時にサブボリューム用に作成した spec.path パラメーターと一致する必要があります。
次のステップ