Concourse is a distributed database warehouse for transactions search and analytics across time. Developers prefer Concourse because it simplifies building misssion-critical systems with on-demand data intelligence. Furthermore, Concourse makes end-to-end data management trivial by requiring no extra infrastructure, no prior configuration and no continuous tuning–all of which greatly reduce costs, and allow developers to focus on core business problems.
This is version 0.12.0 of Concourse.
Using Concourse via Docker is the quickest way to get started.
docker run -p 1717:1717 --name concourse cinchapi/concourseNOTE: This will run Concourse in the foreground. To run in the background, add a -d flag to the docker run command.
docker run -p 1717:1717 -v </path/to/local/data>:/data --name concourse cinchapi/concoursedocker run -p 1717:1717 -e CONCOURSE_HEAP_SIZE=<HEAP_SIZE> --name concourse cinchapi/concoursedocker run -it --rm --link concourse:concourse cinchapi/concourse shell --host concourse --password admindocker-compose run concourse shell --host concourseUse the concourse import to perform an interactive import that reads input from the command line
docker run -it --rm --link concourse:concourse cinchapi/concourse import --host concourse --password adminxargs -I % docker run -i --rm --link concourse:concourse --mount type=bind,source=%,target=/data/% cinchapi/concourse import --host concourse --password admin -d /data/% <<< /absolute/path/to/filedocker exec -it concourse concourse <command> <args>For example, you can call the concourse users sessions command
docker exec -it concourse concourse users sessions --password adminFor more information, visit https://docs.cinchapi.com/concourse/quickstart.
Let's assume we have the an array of JSON objects corresponding to NBA players. NOTE: These examples assume you're using Concourse Shell, but are easily adaptable to any of the Concourse client drivers or REST API.
data = '[
{
"name": "Lebron James",
"age": 30,
"team": "Cleveland Cavaliers"
},
{
"name": "Kevin Durant",
"age": 26,
"team": "OKC Thunder"
},
{
"name": "Kobe Bryant",
"age": 36,
"team": "LA Lakers"
}
]'You can use Concourse to quickly insert the data and do some quick analysis. Notice that we don't have to declare a schema, create any structure or configure any indexes.
ids = insert(data) // each object is added to a distinct record
lebron = ids[0]
durant = ids[1]
kobe = ids[2]get(key="age", record=kobe)
add(key="name", value="KD", record=durant)
remove(key="jersey_number", value=23, record=lebron)You can easily find records that match a criteria and select the desired since everything is automatically indexed.
select(criteria="team = Chicago Bulls")
select(keys=["name", "team"], criteria="age bw 22 29")// Return data from 04/2009 from records that match now
get(key="age", record=durant, time=time("04/2009"))
// Return records that matched in 2011
find("team = Chicago Bulls at 2011")
// Return data from two years ago from records that match now
select(criteria="age > 25 and team != Chicago Bulls", time=time("two years ago")) // Analyze how data has changed over time and revert to previous states
audit(key="team", record=lebron)
revert(key="jersey_number", record=kobe, time=time("two years ago"))stage
set(key="current_team", value="OKC Thunder", record=lebron)
set(key="current_team", value="Cleveland Cavs", record=durant)
commit...or using shorthand syntax
stage({
set(key="current_team", value="OKC Thunder", record=lebron);
set(key="current_team", value="Cleveland Cavs", record=durant);
})You can find more examples in the examples directory. More information is also available in the Concourse Guide.
Whether you use SQL or NoSQL, it's hard to get real-time insight into your mission critical data because most systems are only optimized for either transactions or analytics, not both. As a result, end-to-end data management requires complex data pipelining, which slows down development, complicates infrastructure and increases costs.
Concourse is an integrated and self-managing transactional database that enables real time ad-hoc analytics without any configuration.
You no longer need to plan queries in advance because Concourse automatically indexes all of your data while guaranteeing constant time writes that are super fast. Concourse fully supports ad-hoc range and predicate queries and automatically caches frequently requested data for optimal performance.
Concourse automatically tracks changes to your data, just like Git does for source code. Of course this means that you can easily audit changes and revert to previous states without downtime; but it also means that you have the power to query data from the past. Version control in Concourse makes it possible to build applications that know what was known when and can analyze real-time changes over time.
Concourse supports truly distributed ACID transactions without restriction. And we use dynamic resource management with just-in-time locking to ensure that they deliver both the highest performance and strongest consistency. So no need to guess when your data will eventually become consistent. When distributed Concourse responds to a query, you can trust the results immediately.
Concourse's document-graph structure is lightweight and flexible–it supports any kind of data and very large scales. Data about each person, place or thing is stored in a record, which is simply a collection of key/value pairs. And you can create links among records to easily model all the relationships within your data.
Since Concourse makes very few assumptions about data, it integrates with your application seamlessly and never needs a translator (goodbye object-relational impedance mismatch)! You never have to declare structure up front–no schema, tables, or indexes–or specify value types because Concourse is smart enough to figure it out. Concourse dynamically adapts to your application so that you can focus on building value without having to drag the database along.
Concourse supports rich full text search right out the box, so you don't need to deploy an external search server. Data is automatically indexed and searchable in real-time without ever diminishing write performance. In Concourse, you can always perform as-you-type searches that match full or partial terms.
- At least 256 MB of available memory
- Linux or OS X
- Java 1.8+
Concourse will be maintained under the Semantic Versioning
guidelines such that release versions will be formatted as <major>.<minor>.<patch>
where
- breaking backward compatibility bumps the major,
- new additions while maintaining backward compatibility bumps the minor, and
- bug fixes or miscellaneous changes bumps the patch.
Read the contributing guidelines to learn how to get involved in the community. We value and welcome constructive contributions from anyone, regardless of skill level :)
Copyright © 2013-2023 Cinchapi Inc.
Concourse is released under the Apache License, Version 2.0. For more information see LICENSE, which is included with this package.