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

重要

このページには、プレビュー段階にある 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 (プレビュー)

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

次のステップ

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