重要
このページには、プレビュー段階にある Kubernetes デプロイ マニフェストを使用して Azure IoT Operations コンポーネントを管理する手順が含まれます。 この機能はいくつかの制限を設けて提供されており、運用環境のワークロードには使用しないでください。
ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。
Azure IoT Operations でローカル ストレージにデータを送信するには、データ フロー エンドポイントを構成できます。 この構成では、エンドポイント、認証、テーブル、その他の設定を指定できます。
前提条件
ローカル ストレージ データ フロー エンドポイントを作成する
ローカル ストレージ オプションを使用して、ローカルで使用可能な永続ボリュームにデータを送信します。これにより、Azure Arc エッジ ボリュームで有効になっている Azure コンテナー ストレージ経由でデータをアップロードできます。
操作エクスペリエンスで、[データ フロー エンドポイント] タブを選択します。
[新しいデータ フロー エンドポイントの作成] で、[ローカル ストレージ]>[新規] を選びます。
エンドポイントに関する次の設定を入力します。
設定 |
内容 |
名前 |
データ フロー エンドポイントの名前。 |
永続ボリューム要求名 |
ローカル ストレージに使用する PersistentVolumeClaim (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
パラメーターは、ローカル ストレージに使用する PersistentVolumeClaim (PVC) の名前です。 PVC は、データ フロー エンドポイントと同じ名前空間に存在する必要があります。
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 データフロー エンドポイント apply コマンドを使用して、ローカル ストレージ データ フロー エンドポイントを作成または変更します。
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 .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
パラメーターと一致する必要があります。
次のステップ
データ フローの詳細については、データ フローの作成に関するページを参照してください。