非推奨の機能

廃止された機能は、Orion が引き続きサポートしている機能ですが、それ以上の延長や進化はありません。特に :

  • 廃止された機能に関連し、他の機能に影響を与えないバグや問題は扱いません。それらは github.com では見つかるとすぐにクローズされます
  • 廃止予定の機能に関するドキュメントは、リポジトリのドキュメントから削除されています。ドキュメントは、以前のバージョン (リポジトリのリリース・ブランチまたは FIWARE wiki の pre-0.23.0 のドキュメントのいずれか) に関連付けられたドキュメント・セットで引き続き利用できます
  • 廃止された機能は最終的には Orion から削除されます。したがって、廃止された機能に依存しないために、Orion を使用して実装を変更することを強くお勧めします

推奨されなくなった機能のリストと、廃止された機能のバージョンは次のとおりです :

  • Orion 3.12.0 での CLI パラメータ (および関連する環境変数): -dbhost-rplSet-dbTimeout-dbuser-dbAuthMech-dbAuthDb-dbSSL、および -dbDisableRetryWrites。MongoDB URI を構築するために必要な情報が必要な場合は、このセクション をチェックして、代わりに dbURI を使用してください (Orion 4.0.0 で削除されました)
  • Orion 3.10.0 での geo:point, geo:line, geo:box および geo:polygon 属性タイプ。代わりに geo:json を使用してください
  • Orion 3.8.0 での GET /v2 操作。この操作はかなり役に立たず、実際には使用されません。
  • Orion 3.1.0 のサブスクリプションでの初期通知 (skipInitialNotification オプションと共に)。(Orion 3.2.0 で削除)。初期通知の 対象となる結果は非常に大きくなる可能性があり、ここではページネーションを適用できません (GET/v2/entity を使用したエンティティの同期取得で行われるため)。実際、最初の20エンティティのみが返されるため、この機能は 非常に制限されます。代替手段として、サブスクリプション時にシステムのステータスを知る必要がある場合は、 適切なページネーションで GET /v2/entities を使用してください
  • Orion 2.1.0 の Rush サポート (関連するCLIパラメータ : -rush) (Orion 2.3.0 で削除)
  • Orion 2.0.0 での NGSIv1 (関連する CLI パラメータ : -strictNgsiv1Ids, -ngsiv1Autocast)。代わりに NGSIv2 API を使用してください
    • Orion 2.0.0 の NGSIv1 の一部としてのコンテキスト・アベイラビリティ・サブスクリプション (別名 NGSI9 サブスクリプション) (Orion 2.6.0 で削除)
    • 次の操作を除く、他のすべての NGSIv1 操作は Orion 3.10.0 で削除されました:
      • PUT /v1/contextEntities/{id}
      • DELETE /v1/contextEntities/{id}
      • GET /v1/contextEntities/{id}/attributes/{name}
      • POST /v1/updateContext
      • POST /NGSI10/updateContext
      • POST /v1/queryContext
      • POST /NGSI10/queryContext
    • サブスクリプション通知の NGSIv1 形式 (notification.atttrsFormatlegacy に設定) は Orion 4.0.0 で削除されました
    • 最後に、Orion 4.0.0 では、残りの NGSIv1 操作が削除されました。
  • POST /v2/op/queryattributes フィールドは、Orion 1.15.0 にあります。これらの属性を持つエンティティのみを返すためには、クエリに対するレスポンスにどの属性を含めるかを選択する attrs と、expression 内の q の単項属性フィルタ (unary attribute filter) の組み合わせです。それらを代わりに指定していください
  • Orion 1.14.0 では POST /v2/op/updateAPPEND, APPEND_STRICT, UPDATE, DELETE, REPLACE の使用は非推奨です。append, appendStrict, update, delete, replace を代わりに使ってください
  • Orion 1.13.0 ではメタデータ ID が推奨されていません (Orion 2.2.0 で削除されました)。一方、この機能は NGSIv2 と互換性がありません。JSON 表現形式の属性名は JSON オブジェクトのキーとして使用されるため、名前を複製することはできません。一方、IDs は、属性名にプレフィックス/サフィックスを使用して簡単に実装することができます。たとえば、temperature:ground および temperature:ceiling です。 この非推奨の結果、次のオペレーションも非推奨になりました :
    • GET /v1/contextEntities/{entityId}/attributes/{attrName}/{attrId}
    • GET /v1/contextEntities/type/{entityType}/id/{entityId}/attributes/{attrName}/{attrId}
    • POST /v1/contextEntities/type/{entityType}/id/{entityId}/attributes/{attrName}/{attrId}
    • PUT /v1/contextEntities/{entityId}/attributes/{attrName}/{attrId}
    • PUT /v1/contextEntities/type/{entityType}/id/{entityId}/attributes/{attrName}/{attrId}
    • DELETE /v1/contextEntities/{entityId}/attributes/{attrName}/{attrId}
    • DELETE /v1/contextEntities/type/{entityType}/id/{entityId}/attributes/{attrName}/{attrId}
  • Orion 1.5.0 では、NGSIv2 で dateCreated および/または dateModified 属性を含めるために optionsURL パラメータ使用することは推奨されていません。代わりに attrsURI パラメータを使用してください
  • パス・プレフィックスとして /ngsi10 そして /ngsi9URL は、orion 1.2.0 で廃止されました。代わりに /v1/v1/registry を使用してください
    • /ngsi9 URL パスは Orion 3.8.0 で削除されました
  • エンティティの場所を指定する location メタデータは、Orion 1.1.0 では非推奨です (Orion 3.11.0 で削除されました)。エンティティの場所を指定する新しい方法は、属性の geo:json 型を使用することです。Orion API の対応するセクションを参照してください)
  • Orion 0.26.1 のコマンドライン引数は廃止されました。Orion 1.0.0 で削除されました
    • --silent : エラー以外のすべてのログ出力を抑止します。代わりに -logLevel ERROR を使用してください
  • ONTIMEINTERVAL サブスクリプションは Orion 0.26.0 以降で廃止されました。Orion 1.0.0 では削除されました。ONTIMEINTERVAL サブスクリプションにはいくつかの問題があります。CB に状態 (state) を導入するため、水平スケーリングの設定をより困難にし、ページネーション/フィルタリングの導入を困難にします。実際には、ONTIMEINTERVAL 通知に基づくユース・ケースは、レセプタが queryContext を同じ頻度で実行する等価なユース・ケースに変換できるため、実際には必要ありません。ページ区切りやフィルタリングなどの queryContext の機能を利用してください
  • XML は Orion 0.23.0 以降で廃止されました。Orion 1.0.0 では削除されました
  • Orion 0.21.0 で以下のコマンドライン引数は廃止さました。0.25.0 で削除されました :
    • -ngsi9 : broker は NGSI9 のみを実行します。NGSI10 は使用しません
    • -fwdHost : broker が "ConfMan モード" で動作している場合、NGIS9 registerContext のホストを転送します
    • -fwdPort : broker が "ConfMan モード" で動作している場合の NGIS9 registerContext の転送ポートです
  • Configuration Manager のロールは、0.21.0 で非推奨になり、0.25.0 で削除されました
  • Associations は、0.21.0 で非推奨になり、0.25.0 で削除されました

古い CLI パラメータから MongoURI へのマッピング

次の CLI パラメータがあることを考慮します:

  • -dbhost HOST
  • -rplSet RPLSET
  • -dbTimeout TIMEOUT
  • -dbuser USER
  • -dbpass PASS
  • -dbAuthMech AUTHMECH
  • -dbAuthDb AUTHDB
  • -dbSSL
  • -dbDisableRetryWrites

結果の MongoURI (つまり、-dbURI の値) は次のようになります:

mongodb://[USER:PASS@]HOST/[AUTHDB][?replicaSet=RPLSET[&authMechanism=AUTHMECH][&tls=true&tlsAllowInvalidCertificates=true][&retryWrites=false][&connectTimeoutMS=TIMEOUT] Notes:

  • -dbSSL が使用される場合、&tls=true&tlsAllowInvalidCertificates=true トークンが追加されます
  • -dbDisableRetryWrites が使用される場合、&retryWrites=false トークンが追加されます
  • その他の [...] は、対応するパラメータが使用されているかどうかに応じて、オプションのトークンを意味します

非推奨の警告をログに記録

非推奨の機能の一部 (すべてではない) の使用状況は、WARN ログ・レベルで -logDeprecate CLI flag フラグ (またはログ管理 REST API の deprecate パラメータ) を使用してログに記録できます。

詳細については、ドキュメントのこのセクションを参照してください。

古い Orion バージョンの使用

常に最新の Orion バージョンを使用することをお勧めしますが、古いバージョンを使用する場合は、次の情報を考慮してください :

  • Orion github repository には、旧リリースに対応するコード(Orion 0.8.1、オープンソースとして最初に提供されたもの)が用意されています。各リリース番号 (例 : 0.23.0) には、以下が関連付けられています :
    • tag : 例えば 0.23.0。ベース・バージョンを指しています
    • release branch : release/0.23.0。このブランチの HEAD は通常、前述のタグと一致します。ただし、一部の修正プログラムがベースバージョンで開発された場合、このブランチにはこのような修正プログラムが含まれています
  • 古いバージョンに対応するドキュメント :
  • Orion 0.24.0 以降に対応する Docker イメージは Docker Hub にあります

次の表は、現在削除されている機能をサポートする最新の Orion バージョンについての情報を提供します :

削除された機能 機能をサポートする Orion ラスト・バージョン バージョンのリリース日
POST /v2/entities オペレーションの attributes フィールド まだ定義されていません まだ定義されていません
APPEND, UPDATE, など。POST /v2/op/update でのアクション・タイプ まだ定義されていません まだ定義されていません
URI パラメータでの dateCreated および dateModified まだ定義されていません まだ定義されていません
エンティティのロケーションを指定する location メタデータ まだ定義されていません まだ定義されていません
GET /v2 操作 まだ定義されていません まだ定義されていません
geo:point, geo:line, geo:box および geo:polygon 属性タイプ まだ定義されていません まだ定義されていません
CLI -dbhost-rplSet-dbTimeout-dbuser-dbAuthMech-dbAuthDb-dbSSL、および -dbDisableRetryWrites (および関連する環境変数) 3.12.0 2024年2月29日
エンティティの場所を指定するための location メタデータ 3.10.1 2023年6月12日
NGSIv1 (関連する CLI パラメータ : -strictNgsiv1Ids, -ngsiv1Autocast) 3.9.0 (*) 2023年6月2日
/ngsi10 および /ngsi9 URL プレフィックス 3.7.0 (*) 2022年5月26日
サブスクリプションの作成または更新時の初期通知 3.1.0 2021年6月9日
NGSIv1 コンテキスト・アベイラビリティ・サブスクリプション (NGSI9 サブスクリプション) 2.5.2 2020年12月17日
Rush (関連する CLI パラメータ : -rush) 2.2.0 2019年2月21日
id メタデータとそれに関連する NGSIv1 オペレーション 2.1.0 2018年12月19日
XML API 0.28.0 2016年2月29日
ONTIMEINTERVAL subscription 0.28.0 2016年2月29日
CLI --silent 0.28.0 2016年2月29日
Configuration Manager のロール (-ngsi, -fwdHost および -fwdPort を含む) 0.24.0 2015年9月14日
Associations (アソシエーション) 0.24.0 2015年9月14日

(*) 削除は1つのバージョンで完全には行われませんでしたが、これは機能がまだ完全であった最後のバージョンです。