Concept Architecture
Anything in TypeDB (other than Rule), whether a concept type or a data instance, is a Concept. The diagram below, illustrates how the Concept superclass is inherited by its direct and indirect descendants.
Type refers to a Concept Type as defined in the schema.
Thing refers to an instance of data that is an instantiation of a Concept Type.
Local and Remote Concept API
The Concept API architecture is implemented in 2 ways in each client: local and remote. The concepts share the same overall structure, but only a small set of methods are available on the local concepts.
The difference is that local concept methods do not require a call to the server, while calls to methods on the remote concept API must make at least one full round-trip to the server to fetch a result. The execution time will include at least the network latency between your client and the TypeDB server.
Queries always return local concepts. Local concepts must be converted to remote concepts before remote methods are available.
Local Concept API
Local Concept methods do not perform network operations. Local concepts are not bound to a transaction, so they can be safely used even after the transaction, session or client has been closed; however, the information contained may go out of date if another transaction modifies the Concepts on the server.
In the Concept API documentation, the (Local) tag indicates that a method is available on both local and remote concepts. All other methods are only available on remote concepts.
Remote Concept API
The remote concept API allows a user to make simple requests to the TypeDB server to discover information connected to a specific concept, or modify a concept. All remote concept operations require a network call to the TypeDB server.
Remote concepts must be linked to a Transaction in order to make calls. When remote concepts are returned by a Transaction method or a Remote Concept API method, they will inherit the same Transaction as the transaction/concept the method was called on. *When the Transaction is closed, the remote concept methods can no longer be used.
Some remote concept methods are update, insert or delete operations, and will therefore fail if used on a concept that is linked to a read transaction.
Converting Local Concepts to Remote Concepts
All local concepts have the method asRemote(tx)
, where the tx
parameter is a Transaction to use for the remote concept version of this local concept, and the returned value is the remote concept. See the asRemote
method documentation for more details.
In the sections that follow, we learn about the methods available on Concept, Type, ThingType, EntityType, AttributeType, RelationType, RoleType, Thing, Attribute, Relation and Rule.