mirror of https://github.com/citusdata/citus.git
135 lines
4.7 KiB
Markdown
135 lines
4.7 KiB
Markdown
|
||
|
||
[](https://travis-ci.com/citusdata/citus)
|
||
[](https://webchat.freenode.net/?channels=citus)
|
||
[](https://www.citusdata.com/docs/citus/current)
|
||
|
||
### What is Citus?
|
||
|
||
* **Open-source** PostgreSQL extension (not a fork)
|
||
* **Scalable** across multiple hosts through sharding and replication
|
||
* **Distributed** engine for query parallelization
|
||
* **Highly available** in the face of host failures
|
||
|
||
Citus horizontally scales PostgreSQL across commodity servers using
|
||
sharding and replication. Its query engine parallelizes incoming
|
||
SQL queries across these servers to enable real-time responses on
|
||
large datasets.
|
||
|
||
Citus extends the underlying database rather than forking it, which
|
||
gives developers and enterprises the power and familiarity of a
|
||
traditional relational database. As an extension, Citus supports
|
||
new PostgreSQL releases, allowing users to benefit from new features
|
||
while maintaining compatibility with existing PostgreSQL tools.
|
||
Note that Citus supports many (but not all) SQL commands; see the
|
||
[FAQ](https://www.citusdata.com/frequently-asked-questions) for
|
||
more details.
|
||
|
||
Common Use-Cases:
|
||
* Powering real-time analytic dashboards
|
||
* Exploratory queries on events as they happen
|
||
* Large dataset archival and reporting
|
||
* Session analytics (funnels, segmentation, and cohorts)
|
||
|
||
To learn more, visit [citusdata.com](https://www.citusdata.com).
|
||
|
||
### Quickstart
|
||
|
||
#### Local Citus Cluster
|
||
|
||
* Install docker-compose: [Mac](https://www.docker.com/products/docker-toolbox) | [Linux](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-ubuntu-14-04)
|
||
* (Mac only) connect to Docker VM
|
||
```bash
|
||
eval $(docker-machine env default)
|
||
```
|
||
|
||
* Pull and start the docker images
|
||
```bash
|
||
wget https://raw.githubusercontent.com/citusdata/docker/master/docker-compose.yml
|
||
docker-compose -p citus up -d
|
||
```
|
||
|
||
* Connect to the master database
|
||
```bash
|
||
docker exec -it citus_master psql -U postgres -d postgres
|
||
```
|
||
|
||
* Follow the [first tutorial](https://www.citusdata.com/docs/citus/current/tutorials/tut-real-time.html) instructions
|
||
* To shut the cluster down, run
|
||
|
||
```bash
|
||
docker-compose -p citus down
|
||
```
|
||
|
||
### Learn More
|
||
|
||
The project [documentation](https://www.citusdata.com/docs/citus/current) and
|
||
[tutorials](https://www.citusdata.com/docs/citus/current/tutorials/tut-real-time.html) are good places to start.
|
||
We’re responsive on Github, so you can use the [issue
|
||
tracker](https://github.com/citusdata/citus/issues) to check for or
|
||
submit bug reports and feature requests. For more immediate help
|
||
or general discussion we’re on IRC at `#citus` on Freenode and
|
||
[@citusdata](https://twitter.com/citusdata) on Twitter.
|
||
|
||
We also offer training and dedicated support options. More information
|
||
is available on our [support
|
||
page](https://www.citusdata.com/citus-products/citus-data-pricing).
|
||
|
||
### Contributing
|
||
|
||
Citus is built on and of open source. We welcome your contributions,
|
||
and have added a
|
||
[helpwanted](https://github.com/citusdata/citus/labels/helpwanted) label
|
||
to issues which are accessible to new contributors. The
|
||
[CONTRIBUTING.md](CONTRIBUTING.md) file explains how to get started
|
||
developing the Citus extension itself and our code quality guidelines.
|
||
|
||
### Who is Using Citus?
|
||
|
||
<dl>
|
||
|
||
<dt>CloudFlare</dt>
|
||
<dd>
|
||
CloudFlare uses Citus to provide real-time analytics on 100 TBs of
|
||
data from over 4 million customer websites <a
|
||
href="https://blog.cloudflare.com/scaling-out-postgresql-for-cloudflare-analytics-using-citusdb/">Read
|
||
more ></a>
|
||
</dd>
|
||
|
||
<dt>Agari</dt>
|
||
<dd>
|
||
Agari uses Citus to secure more than 85 percent of U.S. consumer
|
||
emails on two 6-8 TB clusters <a
|
||
href="https://www.citusdata.com/solutions/case-studies/agari-case-study">Read
|
||
more ></a>
|
||
</dd>
|
||
|
||
|
||
<dt>MixRank</dt>
|
||
<dd>
|
||
Citus enables MixRank to efficiently collect and analyze vast amounts
|
||
of data to allow inside B2B sales teams to find new customers <a
|
||
href="https://www.citusdata.com/solutions/case-studies/mixrank-case-study">Read
|
||
more ></a>
|
||
</dd>
|
||
|
||
<dt>Neustar</dt>
|
||
<dd>
|
||
Neustar builds and maintains scalable ad-tech infrastructure that counts billions of events per day using Citus and HyperLogLog.
|
||
</dd>
|
||
|
||
<dt>Heap</dt>
|
||
<dd>
|
||
Heap uses Citus for conversion funnels with filtering and grouping,
|
||
retention analysis, and behavioral cohorting across billions of
|
||
users and tens of billions of events. <a
|
||
href="https://www.citusdata.com/community/pgconf-silicon-valley-postgresql-conference/powering-heap-postgresql-and-citusdb">Watch
|
||
video ></a>
|
||
</dd>
|
||
|
||
</dl>
|
||
|
||
___
|
||
|
||
Copyright 2012-2016 Citus Data
|