2017-04-10 14:24:53 +00:00
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" / >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" / >
2018-12-07 16:24:54 +00:00
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
2017-04-10 14:24:53 +00:00
< title > ClickHouse — open source distributed column-oriented DBMS< / title >
< link rel = "shortcut icon" href = "favicon.ico" / >
< meta property = "og:title" content = "ClickHouse DBMS" / >
< meta property = "og:description"
content="ClickHouse is an open source column-oriented database management system that allows generating analytical data reports in real time using SQL queries."/>
< meta property = "og:type" content = "website" / >
2020-01-30 10:42:11 +00:00
< meta property = "og:url" content = "https://clickhouse.tech" / >
< meta property = "og:image" content = "https://clickhouse.tech/images/logo.png" / >
2017-04-10 14:24:53 +00:00
< meta property = "twitter:title" content = "ClickHouse DBMS" / >
< meta name = "description"
content="ClickHouse is an open source distributed column-oriented database management system that allows generating analytical data reports in real time using SQL queries. С
< meta name = "keywords"
content="ClickHouse, DBMS, OLAP, relational, analytics, analytical, big data, open-source, SQL, web-analytics" />
2020-02-18 14:19:44 +00:00
< link href = "index.css?{{ rev_short }}" media = "all" rel = "stylesheet" / >
2017-04-10 14:24:53 +00:00
< / head >
< body >
< div id = "navbar" >
< div id = "navbar-inner" >
< div id = "top-menu" class = "desktop-only" >
< a class = "menu_item" href = "#quick-start" > Quick Start< / a >
< a class = "menu_item" href = "#performance" > Performance< / a >
2017-05-30 09:45:54 +00:00
< a class = "menu_item" href = "docs/en/" > Documentation< / a >
2020-01-28 19:49:48 +00:00
< a class = "menu_item" href = "https://clickhouse.yandex/blog/en/" > Blog< / a >
2017-04-10 14:24:53 +00:00
< a class = "menu_item" href = "#contacts" > Contacts< / a >
< / div >
< a id = "logo" href = "#" >
< h1 id = "main-title" >
< svg id = "title-logo" xmlns = "http://www.w3.org/2000/svg" width = "48" height = "44" viewBox = "0 0 9 8" >
< path class = "red" d = "M0,7 h1 v1 h-1 z" > < / path >
< path class = "orange" d = "M0,0 h1 v7 h-1 z" > < / path >
< path class = "orange" d = "M2,0 h1 v8 h-1 z" > < / path >
< path class = "orange" d = "M4,0 h1 v8 h-1 z" > < / path >
< path class = "orange" d = "M6,0 h1 v8 h-1 z" > < / path >
< path class = "orange" d = "M8,3.25 h1 v1.5 h-1 z" > < / path >
< / svg >
2020-02-18 14:19:44 +00:00
< img id = "logo-text" src = "images/clickhouse-black.svg?{{ rev_short }}" alt = "ClickHouse" / >
2017-04-10 14:24:53 +00:00
< / h1 >
< / a >
< / div >
< / div >
< div id = "hero" >
< div class = "page" >
< div class = "block-70" >
2020-02-21 21:00:27 +00:00
< p id = "short-description" > ClickHouse is an < a href = "https://github.com/ClickHouse/ClickHouse" rel = "external nofollow" target = "_blank" class = "orange" > open source< / span > column-oriented
2017-04-10 14:24:53 +00:00
database management system
capable of < span class = "orange" > real time< / span > generation of analytical data reports using < span
class="orange">SQL< / span > queries.< / p >
< a id = "call_to_action" href = "#quick-start" >
Quick Start
< / a >
< / div >
< div class = "block-30" >
< ul id = "index_ul" class = "dashed" >
< li >
< a class = "index_item" href = "#blazing-fast" > Blazing Fast< / a >
< / li >
< li >
< a class = "index_item" href = "#linearly-scalable" > Linearly Scalable< / a >
< / li >
< li >
< a class = "index_item" href = "#hardware-efficient" > Hardware Efficient< / a >
< / li >
< li >
< a class = "index_item" href = "#fault-tolerant" > Fault Tolerant< / a >
< / li >
< li >
2017-06-13 04:15:47 +00:00
< a class = "index_item" href = "#key-features" > Feature Rich< / a >
2017-04-10 14:24:53 +00:00
< / li >
< li >
2017-06-13 04:15:47 +00:00
< a class = "index_item" href = "#highly-reliable" > Highly Reliable< / a >
2017-04-10 14:24:53 +00:00
< / li >
< li >
2017-06-13 04:15:47 +00:00
< a class = "index_item" href = "#simple-and-handy" > Simple and Handy< / a >
2017-04-10 14:24:53 +00:00
< / li >
< / ul >
< / div >
< div class = "clear" > < / div >
2018-07-18 10:00:53 +00:00
< / div >
< / div >
2019-04-15 21:00:08 +00:00
< div id = "announcement" class = "colored-block" >
< div class = "page" >
< / div >
2019-04-17 20:58:53 +00:00
< / div >
2017-04-10 14:24:53 +00:00
< div class = "page" >
< h2 id = "slogan" > ClickHouse. Just makes you think faster.< / h2 >
< div class = "block-70" >
< ul class = "dashed" >
< li > Run more queries in the same amount of time< / li >
< li > Test more hypotheses< / li >
< li > Slice and dice your data in many more new ways< / li >
< li > Look at your data from new angles< / li >
< li > Discover new dimensions< / li >
< / ul >
< / div >
< div class = "block-30" >
< svg id = "placeholder" class = "desktop-only" viewBox = "0 0 76 76" xmlns = "http://www.w3.org/2000/svg" >
< defs >
< rect id = "path-1" x = "0" y = "16" width = "60" height = "60" rx = "1" > < / rect >
< mask id = "mask-2" maskContentUnits = "userSpaceOnUse" maskUnits = "objectBoundingBox" x = "0" y = "0" width = "60" height = "60" fill = "white" >
< use xlink:href = "#path-1" > < / use >
< / mask >
< rect id = "path-3" x = "16" y = "0" width = "60" height = "60" rx = "1" > < / rect >
< mask id = "mask-4" maskContentUnits = "userSpaceOnUse" maskUnits = "objectBoundingBox" x = "0" y = "0" width = "60" height = "60" fill = "white" >
< use xlink:href = "#path-3" > < / use >
< / mask >
< rect id = "path-5" x = "0" y = "8" width = "20" height = "20" rx = "1" > < / rect >
< mask id = "mask-6" maskContentUnits = "userSpaceOnUse" maskUnits = "objectBoundingBox" x = "0" y = "0" width = "20" height = "20" fill = "white" >
< use xlink:href = "#path-5" > < / use >
< / mask >
< rect id = "path-7" x = "8" y = "0" width = "20" height = "20" rx = "1" > < / rect >
< mask id = "mask-8" maskContentUnits = "userSpaceOnUse" maskUnits = "objectBoundingBox" x = "0" y = "0" width = "20" height = "20" fill = "white" >
< use xlink:href = "#path-7" > < / use >
< / mask >
< / defs >
< g id = "Page-1" stroke = "none" stroke-width = "1" fill = "none" fill-rule = "evenodd" stroke-linecap = "round" >
< g id = "Clickhouse_2" transform = "translate(-558.000000, -1293.000000)" >
< g id = "Group-11" transform = "translate(558.000000, 1293.000000)" >
2019-11-01 16:01:34 +00:00
< use stroke = "#FFCC00" mask = "url(#mask-2)" stroke-width = "4" xlink:href = "#path-1" > < / use >
< use stroke = "#FFCC00" mask = "url(#mask-4)" stroke-width = "4" xlink:href = "#path-3" > < / use >
< path d = "M0.989013672,17.017334 L16.8210449,1.16748047" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M59.0788574,74.9973145 L74.7983398,59.2650146" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M59.1091309,17.1687012 L74.9368896,1.10351562" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M1.07910156,17.2504883 L26.0395508,33.4033203" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M17.2602539,1.18457031 L34.0175781,25.1796875" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M51.2958984,25.4736328 L58.8277588,17" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M1.01904297,50.942627 L25.9216309,75.064209" stroke = "#FFCC00" stroke-width = "2" transform = "translate(13.470337, 63.003418) scale(-1, 1) translate(-13.470337, -63.003418) " > < / path >
< path d = "M44.1804199,51.300293 L58.9638672,75.010498" stroke = "#FFCC00" stroke-width = "2" > < / path >
< path d = "M52.0131836,43.1345215 L75.0227051,58.9299316" stroke = "#FFCC00" stroke-width = "2" > < / path >
2017-04-10 14:24:53 +00:00
< g id = "Group-3" transform = "translate(25.000000, 24.000000)" stroke = "#444444" >
2019-11-01 16:01:34 +00:00
< use mask = "url(#mask-6)" stroke-width = "4" xlink:href = "#path-5" > < / use >
< use mask = "url(#mask-8)" stroke-width = "4" xlink:href = "#path-7" > < / use >
< path d = "M19.2587891,1.08825684 L26.7729492,8.8046875" stroke-width = "2" transform = "translate(23.015869, 4.946472) scale(-1, 1) translate(-23.015869, -4.946472) " > < / path >
< path d = "M1.05773926,1.04125977 L8.82080078,8.9654541" stroke-width = "2" transform = "translate(4.939270, 5.003357) scale(-1, 1) translate(-4.939270, -5.003357) " > < / path >
< path d = "M1.12487793,18.887207 L9.26220703,26.8897705" stroke-width = "2" transform = "translate(5.193542, 22.888489) scale(-1, 1) translate(-5.193542, -22.888489) " > < / path >
< path d = "M19.038208,19.1968994 L26.9085693,26.9760742" stroke-width = "2" transform = "translate(22.973389, 23.086487) scale(-1, 1) translate(-22.973389, -23.086487) " > < / path >
2017-04-10 14:24:53 +00:00
< / g >
< / g >
< / g >
< / g >
< / svg >
< / div >
< div class = "clear" > < / div >
< h2 id = "blazing-fast" > Blazing Fast< / h2 >
< p > ClickHouse's performance < a href = "benchmark.html" > exceeds< / a > comparable column-oriented DBMS currently available
2018-02-01 15:20:52 +00:00
on the market. It processes hundreds of millions to more than a billion rows and tens of gigabytes of data
2017-04-10 14:24:53 +00:00
per single server per second.< / p >
2017-09-12 17:50:32 +00:00
< p > ClickHouse uses all available hardware to its full potential to process each query as fast as possible. The peak
2017-06-13 04:15:47 +00:00
processing performance for a single query < span class = "grey" > (after decompression, only used columns)< / span >
stands at more than 2 terabytes per second.< / p >
2017-04-10 14:24:53 +00:00
< / div >
< div id = "performance" class = "colored-block" >
< div class = "page" >
< h2 > ClickHouse works 100-1,000x faster than traditional approaches< / h2 >
2017-06-13 04:15:47 +00:00
< p > In contrast to common data management methods, where vast amounts of raw data in its native format are available as
a "data lake" for any given query,
ClickHouse offers instant results in most cases: the data is processed faster than it takes
to create a query. Follow the link below to see detailed benchmarks by Yandex of ClickHouse in comparison
with other database management systems. Also there are some links on third-party benchmarks in the following section.< / p >
2017-04-10 14:24:53 +00:00
< a id = "benchmark_learn_more" href = "benchmark.html" >
Learn more
< / a >
< div class = "clear" > < / div >
< / div >
< / div >
< div class = "page" >
2017-06-13 04:15:47 +00:00
< h2 id = "independent-benchmarks" > Independent Benchmarks< / h2 >
< ul class = "dashed" >
< li > < a href = "https://www.percona.com/blog/2017/02/13/clickhouse-new-opensource-columnar-database/"
rel="external nofollow" target="_blank">ClickHouse: New Open Source Columnar Database< / a > by Percona< / li >
< li > < a href = "https://www.percona.com/blog/2017/03/17/column-store-database-benchmarks-mariadb-columnstore-vs-clickhouse-vs-apache-spark/"
title="MariaDB ColumnStore vs. Clickhouse vs. Apache Spark"
rel="external nofollow" target="_blank">Column Store Database Benchmarks< / a > by Percona< / li >
< li > < a href = "http://tech.marksblogg.com/billion-nyc-taxi-clickhouse.html"
rel="external nofollow" target="_blank">1.1 Billion Taxi Rides on ClickHouse & an Intel Core i5< / a > by Mark Litwintschik< / li >
2019-01-16 09:11:53 +00:00
< li > < a href = "https://tech.marksblogg.com/billion-nyc-taxi-rides-clickhouse-cluster.html"
rel="external nofollow" target="_blank">1.1 Billion Taxi Rides: 108-core ClickHouse Cluster< / a > by Mark Litwintschik< / li >
2017-06-23 20:32:04 +00:00
< li > < a href = "https://www.altinity.com/blog/2017/6/20/clickhouse-vs-redshift"
rel="external nofollow" target="_blank">ClickHouse vs Amazon RedShift Benchmark< / a > by Altinity< / li >
2017-06-13 04:15:47 +00:00
< li > < a href = "https://carto.com/blog/inside/geospatial-processing-with-clickhouse"
rel="external nofollow" target="_blank">Geospatial processing with Clickhouse< / a > by Carto< / li >
2018-10-17 15:53:06 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=http%3A%2F%2Fwww.clickhouse.com.cn%2Ftopic%2F5a72e8ab9d28dfde2ddc5ea2F&lang=zh-en"
rel="external nofollow" target="_blank">ClickHouse and Vertica comparison< / a > by zhtsh < span class = "grey" > (machine translation from Chinese)< / span > < / li >
2017-11-08 07:32:00 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=http%3A%2F%2Fverynull.com%2F2016%2F08%2F22%2Finfinidb%E4%B8%8Eclickhouse%E5%AF%B9%E6%AF%94%2F&lang=zh-en"
2017-06-13 04:15:47 +00:00
rel="external nofollow" target="_blank">ClickHouse and InfiniDB comparison< / a > by RamboLau < span class = "grey" > (machine translation from Chinese)< / span > < / li >
< / ul >
2017-04-10 14:24:53 +00:00
< h2 id = "linearly-scalable" > Linearly Scalable< / h2 >
< p > ClickHouse allows companies to add servers to their clusters when necessary without investing time or money into
2017-06-13 04:15:47 +00:00
any additional DBMS modification. The system has been successfully serving
< a href = "https://metrica.yandex.com/" rel = "external nofollow" > Yandex.Metrica< / a > ,
while the count of servers in it's main production cluster have grown from 60 to 394 in two years,
which are by the way located in six geographically distributed datacenters.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > ClickHouse scales well both vertically and horizontally. ClickHouse is easily adaptable to perform either on
cluster with hundreds of nodes, or on a single server or even on a tiny virtual machine. Currently there are
installations with more than two trillion rows per single node,
as well as installations with 100Tb of storage per single node.< / p >
2017-04-10 14:24:53 +00:00
< h2 id = "hardware-efficient" > Hardware Efficient< / h2 >
2019-03-20 07:02:47 +00:00
< p > ClickHouse processes typical analytical queries two to three orders of magnitude faster than traditional
2017-06-13 04:15:47 +00:00
row-oriented systems with the same available I/O throughput. The system's columnar storage format allows fitting
more hot data in RAM, which leads to a shorter response times.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > ClickHouse allows to minimize the number of seeks for range queries, which increases efficiency of using rotational
disk drives, as it maintains locality of reference for continually stored data.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > ClickHouse is CPU efficient because of it's vectorized query execution involving relevant processor instructions
and runtime code generation.< / p >
2017-04-10 14:24:53 +00:00
< p > By minimizing data transfers for most types of queries, ClickHouse enables companies to manage their data and
2017-06-13 04:15:47 +00:00
create reports without using specialized networks that are aimed at high-performance computing.< / p >
< h2 id = "fault-tolerant" > Fault Tolerant< / h2 >
< p > ClickHouse supports multi-master asynchronous replication and can be deployed across multiple datacenters.
Downtime of a single node or the whole datacenter won't affect the system's availability for both reads and
writes.
Distributed reads are automatically balanced to live replicas to avoid increasing latency. Replicated data
are synchronized automatically or semi-automatically after server downtime.< / p >
< / div >
2017-04-10 14:24:53 +00:00
< / div >
2017-06-13 04:15:47 +00:00
2017-04-10 14:24:53 +00:00
< div id = "grey-block" class = "colored-block" >
< div class = "page" >
2017-06-13 04:15:47 +00:00
< h2 id = "key-features" > Key Features< / h2 >
< div class = "block-50" >
< ul class = "dashed" >
< li > True column-oriented storage< / li >
< li > Vectorized query execution< / li >
< li > Data compression< / li >
< li > Parallel and distributed query execution< / li >
< li > Real time query processing< / li >
< li > Real time data ingestion< / li >
< li > On-disk locality of reference< / li >
< li > Cross-datacenter replication< / li >
< li > High availability< / li >
< li > SQL support< / li >
< / ul >
< / div >
< div class = "block-50" >
< ul class = "dashed" >
< li > Local and distributed joins< / li >
< li > Pluggable external dimension tables< / li >
< li > Arrays and nested data types< / li >
< li > Approximate query processing< / li >
< li > Probabilistic data structures< / li >
< li > Full support of IPv6< / li >
< li > Features for web analytics< / li >
< li > State-of-the-art algorithms< / li >
< li > Detailed documentation< / li >
< li > Clean documented code< / li >
< / ul >
< / div >
< div class = "clear" > < / div >
2017-04-10 14:24:53 +00:00
< / div >
< / div >
< div class = "page" >
< h2 id = "feature-rich" > Feature Rich< / h2 >
2017-06-13 04:15:47 +00:00
< p > ClickHouse features a user-friendly SQL query dialect with a number of built-in analytics capabilities.
For example, it includes probabilistic data
structures for fast and memory-efficient calculation of cardinalities and quantiles. There are functions for
working dates, times and time zones, as well as some specialized ones like addressing URLs and IPs
(both IPv4 and IPv6) and many more.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > Data organizing options available in ClickHouse, such as arrays, array joins, tuples and nested data structures, are
2017-04-10 14:24:53 +00:00
extremely efficient for managing denormalized data.< / p >
< p > Using ClickHouse allows joining both distributed data and co-located data, as the system supports local joins and
distributed joins. It also offers an opportunity to use external dictionaries, dimension tables loaded from
2017-06-13 04:15:47 +00:00
an external source, for seamless joins with simple syntax.< / p >
2017-04-10 14:24:53 +00:00
< p > ClickHouse supports approximate query processing –
indispensable when dealing with terabytes and petabytes of data.< / p >
2017-06-13 04:15:47 +00:00
< p > The system's conditional aggregate functions, calculation of totals and extremes, allow getting results with a
2017-04-10 14:24:53 +00:00
single query without having to run a number of them.< / p >
2017-06-13 04:15:47 +00:00
< h2 id = "success-stories" > Success Stories< / h2 >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< ul class = "dashed" >
2018-10-17 15:53:06 +00:00
< li > < a href = "docs/en/introduction/ya_metrika_task/" > Yandex.Metrica< / a > < / li >
< li > < a href = "https://blog.cloudflare.com/http-analytics-for-6m-requests-per-second-using-clickhouse/"
rel="external nofollow" target="_blank">HTTP Analytics< / a > and < a href = "https://blog.cloudflare.com/how-cloudflare-analyzes-1m-dns-queries-per-second/"
rel="external nofollow" target="_blank">DNS Analytics< / a > at CloudFlare< / li >
< li > < a href = "https://www.slideshare.net/glebus/using-clickhouse-for-experimentation-104247173"
rel="external nofollow" target="_blank">ClickHouse for Experimentation< / a > at Spotify< / li >
2019-03-04 15:00:36 +00:00
< li > < a href = "https://blog.qrator.net/en/clickhouse-ddos-mitigation_37/"
2019-03-11 17:54:01 +00:00
rel="external nofollow" target="_blank">ClickHouse DB in DDoS mitigation< / a > at Qrator< / li >
2017-11-08 07:32:00 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=https%3A%2F%2Fhabrahabr.ru%2Fpost%2F322620%2F&lang=ru-en"
2017-06-13 04:15:47 +00:00
rel="external nofollow" target="_blank">Migrating to Yandex ClickHouse< / a > by LifeStreet < span class = "grey" > (machine translation from Russian)< / span > < / li >
2018-11-27 11:13:59 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=http%3A%2F%2Fsouslecapot.net%2F2018%2F11%2F21%2Fpatrick-chatain-vp-engineering-chez-contentsquare-penser-davantage-amelioration-continue-que-revolution-constante%2F&lang=fr-en"
rel="external nofollow" target="_blank">ClickHouse at ContentSquare< / a > < span class = "grey" > (machine translation from French)< / span > < / li >
2017-11-08 07:32:00 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=https%3A%2F%2Fhabrahabr.ru%2Fcompany%2Fsmi2%2Fblog%2F314558%2F&lang=ru-en"
2017-06-13 04:15:47 +00:00
rel="external nofollow" target="_blank">How to start ClickHouse up and win the jackpot< / a > by SMI2 < span class = "grey" > (machine translation from Russian)< / span > < / li >
2017-11-08 07:32:00 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=http%3A%2F%2Fwww.jianshu.com%2Fp%2F4c86a2478cca&lang=zh-en"
rel="external nofollow" target="_blank">First place at Analysys OLAP algorithm contest< / a > < span class = "grey" > (machine translation from Chinese)< / span > < / li >
2018-10-17 15:53:06 +00:00
< li > < a href = "https://translate.yandex.com/translate?url=https%3A%2F%2Ftech.geniee.co.jp%2Fentry%2F2017%2F07%2F20%2F160100"
rel="external nofollow" target="_blank">Speeding up Report API< / a > at Geniee < span class = "grey" > (machine translation from Japanese)< / span > < / li >
2017-06-13 04:15:47 +00:00
< li > < a href = "https://www.yandex.com/company/press_center/press_releases/2012/2012-04-10/"
rel="external nofollow" target="_blank">LHCb experiment< / a > by CERN< / li >
< / ul >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< h2 > When to use ClickHouse< / h2 >
< p > For analytics over stream of clean, well structured and immutable events or logs.
It is recommended to put each such stream into a single wide fact table with pre-joined dimensions.
< / p >
< p > Some examples of viable applications:< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< ul class = "dashed" >
< li > Web and App analytics< / li >
< li > Advertising networks and RTB< / li >
< li > Telecommunications< / li >
< li > E-commerce and finance< / li >
< li > Information security< / li >
< li > Monitoring and telemetry< / li >
2017-09-23 23:21:59 +00:00
< li > Time series< / li >
2017-06-13 04:15:47 +00:00
< li > Business intelligence< / li >
< li > Online games< / li >
< li > Internet of Things< / li >
< / ul >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< h2 > When < span class = "red" > NOT< / span > to use ClickHouse< / h2 >
< ul class = "dashed" >
< li > Transactional workloads (OLTP)< / li >
< li > Key-value access with high request rate< / li >
< li > Blob or document storage< / li >
< li > Over-normalized data< / li >
< / ul >
2017-04-10 14:24:53 +00:00
< h2 id = "highly-reliable" > Highly Reliable< / h2 >
2017-06-13 04:15:47 +00:00
< p > ClickHouse has been managing petabytes of data serving a number of highload mass audience services of
< a href = "https://www.yandex.com/company/"
rel="external nofollow">Yandex< / a > , Russia's
leading search provider and one of largest European IT companies.
Since 2012, ClickHouse has been providing robust database management for the company's < a
2017-04-10 14:24:53 +00:00
href="https://metrica.yandex.com/" rel="external nofollow">web analytics service< / a > , comparison
2017-06-13 04:15:47 +00:00
e-commerce platform, public email service, online advertising platform, business intelligence tools
and infrastructure monitoring.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > ClickHouse can be configured as purely distributed system located on independent nodes,
without any single points of failure.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > Software and hardware failures or misconfigurations do not result in loss of data. Instead of deleting "broken"
data, ClickHouse saves it or asks you what to do before a startup. All data is checksummed before every
read or write to disk or network. It is virtually impossible to delete data by accident as there are safeguards
even for human errors.< / p >
2017-04-10 14:24:53 +00:00
2017-06-13 04:15:47 +00:00
< p > ClickHouse offers flexible limits on query complexity and resource usage, which can be fine-tuned with settings.
2017-04-10 14:24:53 +00:00
It is possible to simultaneously serve both a number of high priority low-latency requests and some
2017-06-13 04:15:47 +00:00
long-running queries with background priority.< / p >
< h2 id = "simple-and-handy" > Simple and Handy< / h2 >
< p > ClickHouse streamlines all your data processing. It's easy to use: ingest all your structured data into the
system, and it is instantly available for reports. New columns for new properties or dimensions can be
easily added to the system at any time without slowing it down.< / p >
< p > ClickHouse is simple and works out-of-the-box. As well as performing on hundreds of node clusters, this system
can be easily installed on a single server or even a virtual machine. No development experience or code-writing
skills are required to install ClickHouse.< / p >
2017-04-10 14:24:53 +00:00
< h2 id = "quick-start" > Quick Start< / h2 >
< p > System requirements: Linux, x86_64 with SSE 4.2.< / p >
2020-01-29 19:45:37 +00:00
< p > Install packages for < span class = "distributive_selected" id = "repo_deb" > Ubuntu/Debian< / span > , < span class = "distributive_not_selected" id = "repo_rpm" > CentOS/RedHat< / span > or < span class = "distributive_not_selected" id = "repo_tgz" > other Linux< / span > :< / p >
2017-04-10 14:24:53 +00:00
2018-03-13 19:45:15 +00:00
< code id = "packages-install" >
2019-07-31 21:43:20 +00:00
< pre id = "instruction_deb" >
2019-05-13 11:02:17 +00:00
sudo apt-get install dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4
2017-04-10 14:24:53 +00:00
2018-07-30 15:59:03 +00:00
echo "deb http://repo.yandex.ru/clickhouse/deb/stable/ main/" | sudo tee /etc/apt/sources.list.d/clickhouse.list
2017-04-10 14:24:53 +00:00
sudo apt-get update
2018-04-17 20:57:02 +00:00
sudo apt-get install -y clickhouse-server clickhouse-client
2017-04-10 14:24:53 +00:00
sudo service clickhouse-server start
clickhouse-client
2019-07-31 21:43:20 +00:00
< / pre >
< pre id = "instruction_rpm" style = "display: none;" >
sudo yum install yum-utils
2019-08-03 02:53:34 +00:00
sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
2019-07-31 21:43:20 +00:00
sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
sudo yum install clickhouse-server clickhouse-client
sudo /etc/init.d/clickhouse-server start
clickhouse-client
2017-04-10 14:24:53 +00:00
< / pre >
2020-01-10 13:48:28 +00:00
< pre id = "instruction_tgz" style = "display: none;" >
export LATEST_VERSION=`curl https://api.github.com/repos/ClickHouse/ClickHouse/tags | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | head -n 1`
curl -O https://repo.yandex.ru/clickhouse/tgz/clickhouse-common-static-$LATEST_VERSION.tgz
curl -O https://repo.yandex.ru/clickhouse/tgz/clickhouse-common-static-dbg-$LATEST_VERSION.tgz
curl -O https://repo.yandex.ru/clickhouse/tgz/clickhouse-server-$LATEST_VERSION.tgz
curl -O https://repo.yandex.ru/clickhouse/tgz/clickhouse-client-$LATEST_VERSION.tgz
tar -xzvf clickhouse-common-static-$LATEST_VERSION.tgz
sudo clickhouse-common-static-$LATEST_VERSION/install/doinst.sh
tar -xzvf clickhouse-common-static-dbg-$LATEST_VERSION.tgz
sudo clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh
tar -xzvf clickhouse-server-$LATEST_VERSION.tgz
sudo clickhouse-server-$LATEST_VERSION/install/doinst.sh
sudo /etc/init.d/clickhouse-server start
tar -xzvf clickhouse-client-$LATEST_VERSION.tgz
sudo clickhouse-client-$LATEST_VERSION/install/doinst.sh
< / pre >
2017-04-10 14:24:53 +00:00
< / code >
< p > For other operating systems the easiest way to get started is using
< a href = "https://hub.docker.com/r/yandex/clickhouse-server/" rel = "external nofollow"
target="_blank">
2020-01-30 10:42:11 +00:00
official Docker images of ClickHouse< / a > , this is not the only < a href = "https://clickhouse.tech/docs/en/getting_started/" > option< / a > though.
2020-02-14 10:20:22 +00:00
Alternatively, you can easily get a running ClickHouse instance or cluster at
2019-09-30 08:47:01 +00:00
< a href = "https://cloud.yandex.com/services/managed-clickhouse?utm_source=referrals&utm_medium=clickhouseofficialsite&utm_campaign=link1" rel = "external nofollow" target = "_blank" >
Yandex Managed Service for ClickHouse< / a > .
< / p >
2020-01-29 20:20:14 +00:00
< p > After you got connected to your ClickHouse server, you can proceed to < strong > < a href = "/docs/en/getting_started/tutorial/" > tutorial< / a > < / strong > or < strong > < a href = "docs/en/" > full
2017-04-10 14:24:53 +00:00
documentation< / a > < / strong > .< / p >
< h2 id = "contacts" > Contacts< / h2 >
< ul class = "dashed" >
2018-05-31 14:04:39 +00:00
< li > Subscribe to the < a href = "https://clickhouse.yandex/blog/en" target = "_blank" > official ClickHouse blog< / a >
and its < a href = "https://clickhouse.yandex/blog/ru" target = "_blank" > counterpart in Russian< / a > .< / li >
2017-04-10 14:24:53 +00:00
< li > Ask any questions on < a href = "https://stackoverflow.com/questions/tagged/clickhouse"
2017-06-13 04:15:47 +00:00
rel="external nofollow" target="_blank">Stack Overflow< / a > or
< a href = "https://groups.google.com/group/clickhouse"
rel="external nofollow" target="_blank">Google Group< / a > .
2017-04-10 14:24:53 +00:00
< / li >
2017-06-13 04:15:47 +00:00
< li > Join Telegram chat to discuss with real users in < a
href="https://telegram.me/clickhouse_en"
rel="external nofollow" target="_blank">English< / a > or in
< a href = "https://telegram.me/clickhouse_ru"
rel="external nofollow" target="_blank">Russian< / a > .< / li >
2019-07-23 10:02:19 +00:00
< li > Watch video content on < a href = "https://www.youtube.com/c/ClickHouseDB"
2019-07-03 08:32:38 +00:00
rel="external nofollow" target="_blank">YouTube channel< / a > .< / li >
2018-10-17 15:53:06 +00:00
< li > Follow official < a
href="https://twitter.com/ClickHouseDB"
rel="external nofollow" target="_blank">Twitter account< / a > .< / li >
2019-09-23 16:18:19 +00:00
< li > Open < a href = "https://github.com/ClickHouse/ClickHouse/issues/new/choose"
2019-04-24 08:08:21 +00:00
rel="external nofollow" target="_blank">GitHub issue< / a > if you have a bug report or feature request.< / li >
2019-03-04 15:00:36 +00:00
< li > Or email Yandex ClickHouse team directly at
< a id = "feedback_email" href = "" > turn on JavaScript to see email address< / a > .
2018-11-27 11:13:59 +00:00
You can also < a href = "https://forms.yandex.com/surveys/meet-yandex-clickhouse-team/" target = "_blank" rel = "external nofollow" > fill this form< / a > to meet us in person.< / li >
2017-04-10 14:24:53 +00:00
< / ul >
2018-11-27 11:13:59 +00:00
< p > Friendly reminder: check out the documentation in < a href = "docs/en/" > English< / a > , < a href = "docs/ru/" > Russian< / a > , < a href = "docs/zh/" > Chinese< / a > or < a href = "docs/fa/" > Farsi< / a > first — maybe your question is already covered.
2017-06-13 04:15:47 +00:00
< / p >
2017-04-10 14:24:53 +00:00
< h2 > Like ClickHouse?< / h2 >
2020-01-30 10:42:11 +00:00
< p > Help to spread the word about it via < a rel = "external nofollow" target = "_blank" href = "https://www.facebook.com/sharer.php?u=https://clickhouse.tech" > Facebook< / a > ,
< a rel = "external nofollow" target = "_blank" href = "https://twitter.com/intent/tweet?url=https://clickhouse.tech" > Twitter< / a > and
< a rel = "external nofollow" target = "_blank" href = "https://www.linkedin.com/shareArticle?url=https://clickhouse.tech" > LinkedIn< / a > !< / p >
2017-04-10 14:24:53 +00:00
2019-03-04 15:00:36 +00:00
< p > Also hosting ClickHouse Meetups is very appreciated, < a href = "https://forms.yandex.com/surveys/meet-yandex-clickhouse-team/" target = "_blank" rel = "external nofollow" > fill this form< / a >
if you are interested and we'll get in touch.
2020-01-30 22:53:45 +00:00
Short reports about previous meetups are < a href = "https://clickhouse.yandex/blog/en?tag=meetup" target = "_blank" > published in official ClickHouse blog< / a > .< / p >
2017-04-10 14:24:53 +00:00
2019-09-23 16:18:19 +00:00
< p class = "warranty" > < a href = "https://github.com/ClickHouse/ClickHouse/blob/master/LICENSE"
2017-06-13 04:15:47 +00:00
rel="external nofollow" target="_blank">
ClickHouse source code is published under Apache 2.0 License.< / a > Software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
2017-04-10 14:24:53 +00:00
KIND, either express or implied.< / p >
2020-01-30 14:04:29 +00:00
< p id = "footer" > © 2016– < a href = "https://yandex.com/company/" rel = "external nofollow" > Yandex LLC< / a > < / p >
2017-04-10 14:24:53 +00:00
< / div >
2017-06-13 04:15:47 +00:00
< a id = "github_link"
2020-02-21 21:00:27 +00:00
href="https://cloud.yandex.com/services/managed-clickhouse?utm_source=referrals& utm_medium=clickhouseofficialsite& utm_campaign=link2"
2017-06-13 04:15:47 +00:00
rel="external nofollow"
target="_blank"
2020-02-21 21:00:27 +00:00
>< div id = "github" > Try on Yandex.Cloud< / div > < / a >
2017-06-13 04:15:47 +00:00
2019-07-31 21:43:20 +00:00
< script type = "text/javascript" src = "https://yastatic.net/jquery/3.1.1/jquery.min.js" > < / script >
2017-04-10 14:24:53 +00:00
< script type = "text/javascript" >
$(document).ready(function () {
2019-09-23 16:18:19 +00:00
$.get('https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/README.md', function(e) {
2019-08-16 13:22:26 +00:00
var skip = true;
var lines = e.split('\n');
var result = [];
$.each(lines, function(idx) {
var line = lines[idx];
if (skip) {
if (line.includes('Upcoming Events')) {
skip = false;
}
} else {
if (!line) { return; };
line = line.split('](');
var tail = line[1].split(') ');
result.push(
2020-02-14 10:20:22 +00:00
'< a class = "announcement-link" rel = "external nofollow" target = "_blank" href = "' +
tail[0] + '">' + line[0].replace('* [', '').replace('ClickHouse Meetup in ', '') +
2019-08-16 13:22:26 +00:00
'< / a > ' + tail[1].slice(0, -1)
);
}
});
if (result.length) {
if (result.length == 1) {
2020-02-14 10:20:22 +00:00
result = 'Upcoming Meetup: ' + result[0];
2019-08-16 13:22:26 +00:00
} else {
result = 'Upcoming Meetups: ' + result.join(', ');
var offset = result.lastIndexOf(', ');
result = result.slice(0, offset) + result.slice(offset).replace(', ', ' and ');
}
$('#announcement>.page').html(result);
}
});
2020-02-16 22:08:57 +00:00
var name = $('#logo-text').attr('alt').trim().toLowerCase();
2017-04-10 14:24:53 +00:00
var feedback_address = name + '-feedback' + '@yandex-team.com';
var feedback_email = $('#feedback_email');
feedback_email.attr('href', 'mailto:' + feedback_address);
feedback_email.html(feedback_address);
$("a[href^='#']").on('click', function (e) {
e.preventDefault();
var selector = $(e.target).attr('href');
var offset = 0;
if (selector) {
offset = $(selector).offset().top - $('#logo').height() * 1.5;
}
$('html, body').animate({
scrollTop: offset
}, 500);
2017-04-11 04:38:43 +00:00
window.history.replaceState('', document.title, window.location.href.replace(location.hash, '') + this.hash);
2017-04-10 14:24:53 +00:00
});
2017-06-07 17:39:08 +00:00
var hostParts = window.location.host.split('.');
2020-01-28 18:51:44 +00:00
if (hostParts.length > 2 & & hostParts[0] != 'test' & & hostParts[1] != 'github') {
2017-06-07 17:39:08 +00:00
window.location.host = hostParts[0] + '.' + hostParts[1];
}
2019-07-31 21:43:20 +00:00
2020-01-10 13:48:28 +00:00
var available_distributives = ['deb', 'rpm', 'tgz'];
2019-07-31 21:43:20 +00:00
var selected_distributive = 'deb';
function refresh_distributives() {
available_distributives.forEach(function (name) {
if (name == selected_distributive) {
$('#repo_' + name).attr("class", "distributive_selected");
$('#instruction_' + name).show();
} else {
$('#repo_' + name).attr("class", "distributive_not_selected");
$('#instruction_' + name).hide();
}
});
};
refresh_distributives();
available_distributives.forEach(function (name) {
$('#repo_' + name).on('click', function () {
selected_distributive = name;
refresh_distributives();
});
});
2017-04-10 14:24:53 +00:00
});
< / script >
<!-- Yandex.Metrika counter -->
< script type = "text/javascript" >
2017-05-16 07:51:05 +00:00
(function (d, w, c) {
(w[c] = w[c] || []).push(function() {
try {
w.yaCounter18343495 = new Ya.Metrika2({
id:18343495,
clickmap:true,
trackLinks:true,
accurateTrackBounce:true,
webvisor:true
});
} catch(e) { }
2017-04-10 14:24:53 +00:00
});
2017-05-16 07:51:05 +00:00
var n = d.getElementsByTagName("script")[0],
s = d.createElement("script"),
f = function () { n.parentNode.insertBefore(s, n); };
s.type = "text/javascript";
s.async = true;
s.src = "https://mc.yandex.ru/metrika/tag.js";
if (w.opera == "[object Opera]") {
d.addEventListener("DOMContentLoaded", f, false);
} else { f(); }
})(document, window, "yandex_metrika_callbacks2");
2017-04-10 14:24:53 +00:00
< / script >
< noscript >
< div > < img src = "https://mc.yandex.ru/watch/18343495" style = "position:absolute; left:-9999px;" alt = "" / > < / div >
< / noscript >
<!-- /Yandex.Metrika counter -->
< / body >
< / html >
