cog:RemoteHttpAdapter
cog:RemoteHttpAdapter is the adapter kind for constellation graphs served by a separate process over HTTP. The declaration still names a stable sdg:endpoint IRI — a urn:cog:graph:* token that is also the named graph every mirrored quad carries — and the host resolves that IRI to a base URL from its own configuration. The URL never appears in the document, which keeps deployment-specific detail out of the corpus as the CoG design requires. A declaration whose endpoint IRI the host has not configured fails its handshake with cog:HandshakeFailedBuildError and never activates.
The service behind the URL exposes three read routes: GET /health (200 means cog:Online; any other status is cog:Unhealthy; a network error is cog:Offline), GET /revision (an opaque served-revision token), and GET /dataset (the whole served dataset as TriG). The runtime's revision poll turns a changed token into a wave; the adapter's evaluateWave then reloads the dataset into one stable in-memory store, so GRAPH <endpoint> { … } queries on the runtime's SPARQL surface see the new content.
Usage
- Used as the object of
sdg:adapterKindonsdg:ConstellationGraphdeclarations. - Sibling of
cog:InProcessAdapter.