Azure Data Manager for Agriculture

解決していた課題

Azure Data Manager for Agriculture は、衛星画像、気象、土壌センサー、農機など形式の異なる農業データを、圃場や作付けを中心とした共通モデルへ集約するプレビューサービスでした。Microsoft はこのサービスを 2025年9月1日に廃止しており、現在は新規システムの構成要素として採用できません。

• 圃場・季節・作物を同じ識別子で関連付ける
• 外部プロバイダーのデータをコネクターで取り込む
• 正規化済みデータをアプリや分析処理へ API で渡す

本記事はサービスの旧構造を理解し、エクスポート済みデータや周辺アプリを別基盤へ移すための資料です。

主要概念と用語

• パーティ: 農家や組織など、データを所有する主体
• ファーム / フィールド: 農場と圃場区画。位置と形状のジオメトリを持つ
• 季節 / シーズンフィールド: 作付けサイクルと、特定期間の圃場状態
• 作物 / 作付け: 作物の種類や品種を表すマスター情報
• コネクター: 衛星画像や気象などの外部データを取得する旧連携機能
• 農業データモデル: ソースごとの差異を吸収した旧サービスの共通スキーマ

仕様・制限・クォータ

• サービスはプレビューのまま廃止され、インスタンスの新規作成や継続利用はできない
• 廃止前は REST API を中心にデータの登録・検索・取得を行った
• 旧コネクター、レート制限、対応リージョンは移行先で継承されない
• 旧リソース ID や API 仕様に依存するアプリは、移行先の契約へ置き換える必要がある

内部の仕組み

横にスクロール

旧サービスは、外部ソースをつなぐコネクター、農業ドメインの共通モデル、アプリ向け API の三層で動作していました。

• コネクターが衛星・気象・センサーなどを取得し、圃場識別子と時刻を対応付けた
• 共通モデルがパーティ、ファーム、フィールド、季節、作物の関係を保持した
• API が登録・検索・取得を受け付け、分析パイプラインや業務アプリへ渡した
• 現在はこの経路が停止しているため、旧 API を再試行する実装では復旧できない

移行設計 / ベストプラクティス

• 保有データを棚卸しする: 廃止前に出力したファイル、下流レイク、元プロバイダーの原本を確認する
• 契約を先に作る: パーティ、圃場、季節、作付け、観測値の ID と関係を明文化する
• 生データを保持する: 元形式を ADLS Gen2 などへ保存し、再変換できるようにする
• 取り込みを疎結合にする: Data Factory、Functions、Logic Apps などを使い、外部プロバイダーごとの失敗を隔離する
• API を自社境界に置く: Azure API Management とアプリ用 API で、認証・版管理・レート制御を行う
• ジオメトリ品質を検証する: 座標系、境界の自己交差、重複圃場を検査してから時系列データを結合する

運用・監視

• 旧サービスの稼働監視ではなく、移行先の取り込み成功率、遅延、重複、欠損を監視する
• 外部プロバイダーの認証期限と API 変更を個別に追跡する
• データ契約の版を記録し、変換不能なレコードを隔離して再処理する
• 旧エンドポイントへの呼び出しが残っていないか、コード、シークレット、監視設定を検索する

コスト

移行後の費用は、外部データの購入、取り込み実行、保存容量、変換計算、API 配信に分解します。旧サービスの料金モデルをそのまま当てはめず、各構成要素の利用量から見積もります。

• 衛星画像や気象データは取得範囲・頻度を用途に合わせる
• 生データと正規化済みデータの保持期間を分ける
• 増分取り込みと列指向形式で転送量・計算量を抑える

セキュリティ

• 圃場の位置、収量、作業履歴を機微な事業データとして分類する
• マネージド ID と Microsoft Entra ID を使い、共有キーをコードへ埋め込まない
• ADLS Gen2 の RBAC と ACL、プライベートエンドポイントで保存境界を守る
• 外部プロバイダーの資格情報を Key Vault に保管し、期限と利用主体を監査する
• 旧サービス用のアプリ登録、シークレット、ロール割り当ては依存関係を確認して廃止する

関連サービス・比較

単一の直接後継ではなく、必要な責務を複数の Azure サービスへ分割します。

移行確認例

# 旧リソースを新規作成するコマンドではありません。
# 手元へエクスポート済みのファイルを新しいレイクへ配置します。
az storage fs file upload \
  --account-name <storage-account> \
  --file-system agriculture \
  --path raw/export/fields.json \
  --source ./fields.json \
  --auth-mode login

# 移行コードに旧リソースプロバイダーへの参照が残っていないか確認します。
rg "Microsoft.AgFoodPlatform|agfood|farmbeats" .