{"id":13506024,"url":"https://github.com/ScorpioBroker/ScorpioBroker","last_synced_at":"2025-03-30T03:30:34.882Z","repository":{"id":37752357,"uuid":"207497806","full_name":"ScorpioBroker/ScorpioBroker","owner":"ScorpioBroker","description":"NGSI-LD compliant context broker named Scorpio. Developed by NEC Laboratories Europe and NEC Technologies India","archived":false,"fork":false,"pushed_at":"2025-03-24T00:10:49.000Z","size":18723,"stargazers_count":63,"open_issues_count":43,"forks_count":40,"subscribers_count":9,"default_branch":"development-quarkus","last_synced_at":"2025-03-24T00:28:27.938Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PLpgSQL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScorpioBroker.png","metadata":{"files":{"readme":"README.ja.md","changelog":"HistoryEntityManager/.gitignore","contributing":"CONTRIBUTING.ja.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.ja.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-10T07:53:23.000Z","updated_at":"2025-03-24T00:10:52.000Z","dependencies_parsed_at":"2023-09-24T13:05:19.430Z","dependency_job_id":"737a37a2-4294-44c4-ab28-e0f73b3d001b","html_url":"https://github.com/ScorpioBroker/ScorpioBroker","commit_stats":null,"previous_names":[],"tags_count":656,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScorpioBroker%2FScorpioBroker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScorpioBroker%2FScorpioBroker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScorpioBroker%2FScorpioBroker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScorpioBroker%2FScorpioBroker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScorpioBroker","download_url":"https://codeload.github.com/ScorpioBroker/ScorpioBroker/tar.gz/refs/heads/development-quarkus","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246273533,"owners_count":20750904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T01:00:33.114Z","updated_at":"2025-03-30T03:30:29.865Z","avatar_url":"https://github.com/ScorpioBroker.png","language":"PLpgSQL","funding_links":[],"categories":["FIWARE Catalogue","Interoperability and Digital Infrastructure"],"sub_categories":["Core Context Management"],"readme":"# \u003cimg src=\"./img/ScorpioLogo.svg\" width=\"140\" align=\"middle\"\u003e Scorpio NGSI-LD Broker\n\n[![FIWARE Core](https://nexus.lab.fiware.org/static/badges/chapters/core.svg)](https://www.fiware.org/developers/catalogue/)\n[![License: BSD-4-Clause](https://img.shields.io/badge/license-BSD%204%20Clause-blue.svg)](https://spdx.org/licenses/BSD-4-Clause.html)\n[![Docker](https://img.shields.io/docker/pulls/scorpiobroker/scorpio.svg)](https://hub.docker.com/r/scorpiobroker/scorpio/)\n[![fiware](https://nexus.lab.fiware.org/repository/raw/public/badges/stackoverflow/fiware.svg)](https://stackoverflow.com/questions/tagged/fiware)\n[![NGSI LD](https://img.shields.io/badge/NGSI-LD-red.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.02.02_60/gs_CIM009v010202p.pdf)\n\u003cbr\u003e\n[![Documentation badge](https://img.shields.io/readthedocs/scorpio.svg)](https://scorpio.readthedocs.io/en/latest/?badge=latest)\n![Status](https://nexus.lab.fiware.org/static/badges/statuses/full.svg)\n![Travis-CI](https://travis-ci.org/ScorpioBroker/ScorpioBroker.svg?branch=master)\n\nScorpio は、NEC Laboratories Europe と NEC Technologies India によって開発された NGSI-LD 準拠のコンテキストブローカー\nです。クロスカッティングコンテキスト情報管理 ([ETSI ISG CIM](https://www.etsi.org/committee/cim)) に関する ETSI Industry\nSpecification Group (ETSI ISG) によって指定された完全な\n[NGSI-LD API](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.02.02_60/gs_CIM009v010202p.pdf) を実装します。\n\nNGSI-LD API は、コンテキスト情報の管理、アクセス、およびディスカバリーを可能にします。コンテキスト情報は、エンティティ\n(建物など) とそのプロパティ (住所や地理的位置など) およびリレーションシップ (所有者など) で構成されます。したがって、\nScorpio を使用すると、アプリケーションとサービスはコンテキスト情報をリクエストできます。つまり、必要なもの、必要な時期、\n必要な方法などです。\n\nNGSI-LD API の機能は次のとおりです:\n\n-   コンテキスト情報を作成、更新、追加、および削除します。\n-   フィルタリング、地理的スコープ、ページングなどのコンテキスト情報をクエリします。\n-   コンテキスト情報の変更をサブスクライブし、非同期ノーティフィケーションを受信します。\n-   コンテキスト情報のソースをレジストレーションおよびディスカバリーします。これにより、\n    分散展開およびフェデレーション展開を構築できます。\n\nScorpio は FIWARE Generic Enabler です。したがって、\"Powered by FIWARE \" のプラットフォームの一部として統合できます。\nFIWARE は、オープンソースプラットフォームコンポーネントの精選されたフレームワークであり、他のサードパーティ\nプラットフォームコンポーネントと一緒に組み立てて、スマートソリューションの開発を加速することができます。この FIWARE GE\nのロードマップは[こちら](./docs/roadmap.ja.md)に記述されています。\n\n詳細については、[FIWARE developers](https://developers.fiware.org/) の Web サイトおよび [FIWARE](https://fiware.org/)\nWeb サイトを参照してください。FIWARE GEs および Incubated FIWARE GEs の完全なリストは、\n[FIWARE Catalogue](https://catalogue.fiware.org/) にあります。\n\n| :books: [ドキュメンテーション](https://scorpio.rtfd.io/) | :mortar_board: [アカデミー](https://fiware-academy.readthedocs.io/en/latest/core/scorpio) | :whale: [Docker Hub](https://hub.docker.com/r/scorpiobroker/scorpio/) | :dart: [ロードマップ](./docs/roadmap.ja.md) |\n| ------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |\n\n## コンテンツ\n\n-   [バックグラウンド](#background)\n-   [インストールと構築](#installation-and-building)\n-   [使用方法](#usage)\n-   [API ウォークスルー](#api-walkthrough)\n-   [テスト](#tests)\n-   [その他のリソース](#further-resources)\n-   [謝辞](#acknowledgements)\n-   [クレジット](#credit-where-credit-is-due)\n-   [行動規範](#code-of-conduct)\n-   [ライセンス](#license)\n\n\u003ca name=\"background\"\u003e\n\n## バックグラウンド\n\nScorpio は、コンテキスト情報の管理とリクエストを可能にする NGSI-LD broker です。次の機能をサポートします:\n\n-   コンテキストプロデューサーは、コンテキスト情報の作成、更新、追加、削除など、コンテキストを管理できます。\n-   コンテキストコンシューマーは、エンティティを識別するか、エンティティタイプを提供することで関連するエンティティを\n    検出し、GeoJSON 機能として提供されるプロパティ値、既存のリレーションシップ、地理的範囲に従ってフィルタリングする\n    ことで、必要なコンテキスト情報を要求できます。\n-   同期クエリ応答と非同期サブスクライブ/ノーティフィケーションの2つの対話スタイルがサポートされており、\n    ノーティフィケーションはプロパティやリレーションシップの変更、または固定時間間隔に基づくことができます。\n-   Scorpio は、指定された時間間隔内に測定されたプロパティ値などの履歴情報を要求するための NGSI-LD のオプションの\n    時間インターフェイス (Temporal interface) を実装します。\n-   Scorpio は、集中型、分散型、および統合型を含む複数の展開構成をサポートします。上記のコンテキストプロデューサーに\n    加えて、それ自体が NGSI-LD インターフェイスを実装するコンテキストソースが存在する可能性があります。これらの\n    コンテキストソースは、要求に応じて提供できる情報 (情報 (値) 自体ではない) に自分自身をレジストレーションできます。\n    分散設定の Scorpio Broker は、レジストレーションに基づいて要求に応答するための情報を持つ可能性のあるコンテキスト\n    ソースを検出し、さまざまなコンテキストソースからの情報を要求および集約して、要求しているコンテキストコンシューマーに\n    提供できます。\n-   フェデレーション設定では、コンテキストソース自体を NGSI-LD broker にすることができます。フェデレーションを使用して、\n    情報を (部分的に) 共有したい複数のプロバイダーからの情報を組み合わせることができます。重要な違いは、通常、\n    レジストレーションの粒度にあります。たとえば、\"建物 A に関する情報がある\" ではなく、\"地理的領域内の\n    エンティティタイプの建物のエンティティに関する情報がある\" などです。\n-   Scorpio は、前述のすべてのデプロイメント構成をサポートします。したがって、スケーラビリティと、進化的な方法で\n    シナリオを拡張する可能性を提供します。たとえば、2つの別々のデプロイメントを組み合わせたり、スケーラビリティの\n    理由から、異なるブローカーを使用したりできます。これは、単一のアクセスポイントを引き続き使用できるコンテキスト\n    コンシューマーに対して完全に透過的です。\n\n\u003ca name=\"installation-and-building\"\u003e\n\n## インストールと構築\n\nScorpio は、マイクロサービスフレームワークとして Spring Cloud を使用し、ビルドツールとして Apache Maven を使用して\nJava で開発されています。メッセージバスとして Apache Kafka が必要であり、データベースとして PostGIS 拡張機能を備えた\nPostgres が必要です。\n\nScorpio に必要なソフトウェアコンポーネントのインストール方法に関する情報は、\n[インストールガイド](./docs/ja/source/installationGuide.rst) に記載されています。Scorpio の構築と実行については、\n[Scorpio の構築と実行ガイド](./docs/ja/source/buildScorpio.rst)を参照してください。\n\n\u003ca name=\"usage\"\u003e\n\n## 使用方法\n\nデフォルトでは、ブローカーはポート 9090 で実行され、ブローカーとの対話のベース URL は http://localhost:9090/ngsi-ld/v1/\nになります。\n\n### 簡単な例\n\n一般的に、次のようなペイロードを使用して HTTP POST リクエストを http://localhost:9090/ngsi-ld/v1/entities/ に送信する\nことでエンティティを作成できます:\n\n```json\n{\n    \"id\": \"urn:ngsi-ld:testunit:123\",\n    \"type\": \"AirQualityObserved\",\n    \"dateObserved\": {\n        \"type\": \"Property\",\n        \"value\": {\n            \"@type\": \"DateTime\",\n            \"@value\": \"2018-08-07T12:00:00Z\"\n        }\n    },\n    \"NO2\": {\n        \"type\": \"Property\",\n        \"value\": 22,\n        \"unitCode\": \"GP\",\n        \"accuracy\": {\n            \"type\": \"Property\",\n            \"value\": 0.95\n        }\n    },\n    \"refPointOfInterest\": {\n        \"type\": \"Relationship\",\n        \"object\": \"urn:ngsi-ld:PointOfInterest:RZ:MainSquare\"\n    },\n    \"@context\": [\n        \"https://schema.lab.fiware.org/ld/context\",\n        \"https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld\"\n    ]\n}\n```\n\nこの例では、`@context` がペイロードにあるため、`Content-Type` ヘッダーを `application/ld+json` に設定する必要があります。\n\nエンティティを受信するには、次のような HTTP GET を送信します:\n\n`http://localhost:9090/ngsi-ld/v1/entities/\u003centityId\u003e`\n\nまたは、次のような GET を送信してクエリを実行します:\n\n```text\nhttp://localhost:9090/ngsi-ld/v1/entities/?type=Vehicle\u0026limit=2\nAccept: application/ld+json\nLink: \u003chttp://\u003cHOSTNAME_OF_WHERE_YOU_HAVE_AN_ATCONTEXT\u003e/aggregatedContext.jsonld\u003e; rel=\"http://www.w3.org/ns/json-ld#context\";type=\"application/ld+json\"\n```\n\n\u003ca name=\"api-walkthrough\"\u003e\n\n## API ウォークスルー\n\nScorpio が提供する NGSI-LD API を使用して実行できることの詳細な例は、\n[API ウォークスルー](./docs/ja/source/API_walkthrough.rst) にあります。\n\n\u003ca name=\"tests\"\u003e\n\n## テスト\n\nScorpio には2セットのテストがあります。ユニットテストには JUnit を使用し、システムテストには npm テストベースの\nFIWARE NGSI-LD テストスイートを使用します。テストの詳細については、[テストガイド](./docs/ja/source/testing.rst)を\nご覧ください。\n\n\u003ca name=\"further-resources\"\u003e\n\n## その他のリソース\n\nNGSI-L Dまたは JSON-LD の詳細については、次を参照ください:\n\n-  [ETSI NGSI-LD 仕様](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.02.02_60/gs_CIM009v010202p.pdf) \n-  [ETSI NGSI-LD 入門](https://www.etsi.org/deliver/etsi_gr/CIM/001_099/008/01.01.01_60/gr_CIM008v010101p.pdf)\n-  [JSON-LD ウェブサイト](https://json-ld.org/)\n-  [FIWARE Academy Scorpio](https://fiware-academy.readthedocs.io/en/latest/core/scorpio/index.html)\n  -  [FIWARE 601: Introduction to Linked Data](https://fiware-tutorials.readthedocs.io/en/latest/linked-data)\n  -  [FIWARE 602: Linked Data Relationships and Data Models](https://fiware-tutorials.readthedocs.io/en/latest/relationships-linked-data)\n\n-  [FIWARE global summit: The Scorpio NGSI-LD Broker. Features and supported architectures](https://www.slideshare.net/FI-WARE/fiware-global-summit-the-scorpio-ngsild-broker-features-and-supported-architectures)\n-  [FIWARE global summit: NGSI-LD. An evolution from NGSI V2](https://www.slideshare.net/FI-WARE/fiware-global-summit-ngsild-an-evolution-from-ngsiv2)\n\n一連のサンプル呼び出しは、Postman コレクションとして Examples フォルダーにあります。これらの例では2つの変数を使用して\nいます:\n\n-   gatewayServer は `\u003cbrokerIP\u003e:\u003cbrokerPort\u003e` である必要があります。ローカルでデフォルト設定を使用する場合は、\n    localhost:9090 になります。\n-   link, Link header を介して @context を提供する例です。例では、Example @context をホストします。\n    https://raw.githubusercontent.com/ScorpioBroker/ScorpioBroker/master/Examples/index.json へのリンクを設定します。\n\n\u003ca name=\"acknowledgements\"\u003e\n\n## 謝辞\n\n### EU Acknowledgetment\n\nこの活動は、助成金契約 No. 731993 (Autopilot), No. 814918 (Fed4IoT)、および No. 767498 (MIDIH, Open Call (MoLe))\nに基づく欧州連合の Horizon 2020 研究およびイノベーションプログラムから資金提供を受けています。\n\n\u003cimg src=\"https://raw.githubusercontent.com/ScorpioBroker/ScorpioBroker/master/img/flag_yellow_low.jpg\" width=\"160\"\u003e\n\n-   [AUTOPILOT project: Automated driving Progressed by Internet Of Things](https://autopilot-project.eu/) \u003cimg src=\"https://raw.githubusercontent.com/ScorpioBroker/ScorpioBroker/master/img/autopilot.png\" width=\"160\"\u003e\n-   [Fed4IoT project](https://fed4iot.org/)\n-   [MIDIH Project](https://midih.eu/), Open Call (MoLe)\n\n\u003ca name=\"credit-where-credit-is-due\"\u003e\n\n## クレジット\n\nScorpio に貢献してくれたすべての人に感謝します。これは、Scorpio 開発チーム全体とすべての外部貢献者に当てはまります。\n完全なリストについては、[CREDITS](./CREDITS) ファイルをご覧ください。\n\n\u003ca name=\"code-of-conduct\"\u003e\n\n## 行動規範\n\nFIWARE コミュニティの一部として、私たちは [FIWARE 行動規範](https://www.fiware.org/foundation/code-of-conduct/) を\n遵守するために最善を尽くし、貢献者にも同じことを期待しています。\n\nこれには、プルリクエスト、イシュー、コメント、コード、およびコード内コメントが含まれます。\n\nこのリポジトリの所有者として、ここでのコミュニケーションは純粋に Scorpio と NGSI-LD 関連のトピックに限定します。\n\n私たちは皆、異なる文化的背景から来た人間です。私たちは皆、さまざまな癖、習慣、マナーを持っています。そのため、誤解が\n生じる可能性があります。Scorpio と NGSI-LD を前進させるために、コミュニケーションが善意で行われていることに疑いの余地は\nありません。寄稿者にも同じことを期待しています。しかし、誰かが繰り返し挑発したり、攻撃したり、議論を変えたり、誰かを\n嘲笑したりしようとしている場合、私たちは自分の家を正しく利用し、これに終止符を打ちます。\n\n解決すべき論争がある場合、このリポジトリの所有者としての私たちが最後の言葉を持っています。\n\n\u003ca name=\"license\"\u003e\n\n## ライセンス\n\nScorpio は [BSD-4-Clause](https://spdx.org/licenses/BSD-4-Clause.html) の下でライセンスされています。貢献には、この\n[Contribution license](CONTRIBUTING.ja.md) が適用されます。\n\n© 2020 NEC Laboratories Europe, NEC Technologies India\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FScorpioBroker%2FScorpioBroker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FScorpioBroker%2FScorpioBroker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FScorpioBroker%2FScorpioBroker/lists"}