ClickHouse/doc/index.html

517 lines
20 KiB
HTML
Raw Normal View History

2016-05-22 21:42:44 +00:00
<!DOCTYPE html>
<html lang="en">
2016-05-22 21:42:44 +00:00
<head>
<meta charset="utf-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge"/>
<title>ClickHouse — open-source distributed column-oriented DBMS</title>
2016-06-03 04:56:41 +00:00
<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."/>
<meta property="og:type" content="website"/>
<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. Сreated by Yandex ClickHouse manages extremely large volumes of data in a stable and sustainable manner."/>
<meta name="keywords" content="ClickHouse, DBMS, OLAP, relational, analytics, analytical, big data, open-source, SQL, web-analytics"/>
<style type="text/css">
@font-face {
font-family: 'Yandex Sans Text Web';
src: url(https://yastatic.net/adv-www/_/yy5JveR58JFkc97waf-xp0i6_jM.eot);
src: url(https://yastatic.net/adv-www/_/yy5JveR58JFkc97waf-xp0i6_jM.eot?#iefix) format('embedded-opentype'),
url(https://yastatic.net/adv-www/_/CYblzLEXzCqQIvrYs7QKQe2omRk.woff2) format('woff2'),
url(https://yastatic.net/adv-www/_/pUcnOdRwl83MvPPzrNomhyletnA.woff) format('woff'),
url(https://yastatic.net/adv-www/_/vNFEmXOcGYKJ4AAidUprHWoXrLU.ttf) format('truetype'),
url(https://yastatic.net/adv-www/_/0w7OcWZM_QLP8x-LQUXFOgXO6dE.svg#YandexSansTextWeb-Bold) format('svg');
font-weight: 700;
font-style: normal;
font-stretch: normal
}
@font-face {
font-family: 'Yandex Sans Text Web';
src: url(https://yastatic.net/adv-www/_/LI6l3L2RqcgxBe2pXmuUha37czQ.eot);
src: url(https://yastatic.net/adv-www/_/LI6l3L2RqcgxBe2pXmuUha37czQ.eot?#iefix) format('embedded-opentype'),
url(https://yastatic.net/adv-www/_/z3MYElcut0R2MF_Iw1RDNrstgYs.woff2) format('woff2'),
url(https://yastatic.net/adv-www/_/1jvKJ_-hCXl3s7gmFl-y_-UHTaI.woff) format('woff'),
url(https://yastatic.net/adv-www/_/9nzjfpCR2QHvK1EzHpDEIoVFGuY.ttf) format('truetype'),
url(https://yastatic.net/adv-www/_/gwyBTpxSwkFCF1looxqs6JokKls.svg#YandexSansTextWeb-Regular) format('svg');
font-weight: 400;
font-style: normal;
font-stretch: normal
}
@font-face {
font-family: 'Yandex Sans Text Web';
src: url(https://yastatic.net/adv-www/_/ayAFYoY8swgBLhq_I56tKj2JftU.eot);
src: url(https://yastatic.net/adv-www/_/ayAFYoY8swgBLhq_I56tKj2JftU.eot?#iefix) format('embedded-opentype'),
url(https://yastatic.net/adv-www/_/lGQcYklLVV0hyvz1HFmFsUTj8_0.woff2) format('woff2'),
url(https://yastatic.net/adv-www/_/f0AAJ9GJ4iiwEmhG-7PWMHk6vUY.woff) format('woff'),
url(https://yastatic.net/adv-www/_/4UDe4nlVvgEJ-VmLWNVq3SxCsA.ttf) format('truetype'),
url(https://yastatic.net/adv-www/_/EKLr1STNokPqxLAQa_RyN82pL98.svg#YandexSansTextWeb-Light) format('svg');
font-weight: 300;
font-style: normal;
font-stretch: normal
}
@font-face {
font-family: 'Yandex Sans Display Web';
src: url(https://yastatic.net/adv-www/_/H63jN0veW07XQUIA2317lr9UIm8.eot);
src: url(https://yastatic.net/adv-www/_/H63jN0veW07XQUIA2317lr9UIm8.eot?#iefix) format('embedded-opentype'),
url(https://yastatic.net/adv-www/_/sUYVCPUAQE7ExrvMS7FoISoO83s.woff2) format('woff2'),
url(https://yastatic.net/adv-www/_/v2Sve_obH3rKm6rKrtSQpf-eB7U.woff) format('woff'),
url(https://yastatic.net/adv-www/_/PzD8hWLMunow5i3RfJ6WQJAL7aI.ttf) format('truetype'),
url(https://yastatic.net/adv-www/_/lF_KG5g4tpQNlYIgA0e77fBSZ5s.svg#YandexSansDisplayWeb-Regular) format('svg');
font-weight: 400;
font-style: normal;
font-stretch: normal
}
@font-face {
font-family: 'Yandex Sans Display Web';
src: url(https://yastatic.net/adv-www/_/g8_MyyKVquSZ3xEL6tarK__V9Vw.eot);
src: url(https://yastatic.net/adv-www/_/g8_MyyKVquSZ3xEL6tarK__V9Vw.eot?#iefix) format('embedded-opentype'),
url(https://yastatic.net/adv-www/_/LGiRvlfqQHlWR9YKLhsw5e7KGNA.woff2) format('woff2'),
url(https://yastatic.net/adv-www/_/40vXwNl4eYYMgteIVgLP49dwmfc.woff) format('woff'),
url(https://yastatic.net/adv-www/_/X6zG5x_wO8-AtwJ-vDLJcKC5228.ttf) format('truetype'),
url(https://yastatic.net/adv-www/_/ZKhaR0m08c8CRRL77GtFKoHcLYA.svg#YandexSansDisplayWeb-Light) format('svg');
font-weight: 300;
font-style: normal;
font-stretch: normal
}
body {
background: #fff;
font: 300 12pt/200% 'Yandex Sans Text Web', Arial, sans-serif;
}
.page {
width: 800px;
margin: auto;
}
h1 {
font: 400 100pt 'Yandex Sans Display Web', Arial, sans-serif;
2016-05-26 13:51:42 +00:00
margin: 100px 0 30px;
}
h2 {
margin: 47px 0 23px;
font: 400 24pt 'Yandex Sans Display Web', Arial, sans-serif;
}
a:link, a:visited {
color: #08f;
text-decoration: none;
}
a:hover, a:active {
color: #f00;
text-decoration: underline;
}
.menu {
margin: 0 0 50px;
font-weight: 400;
}
.menu_item:link,
.menu_item:active,
.menu_item:visited {
margin: 0 8px 0 0;
padding: 5px;
background: #ffdb4d;
color: #000;
}
.menu_item:hover {
background: #f80;
color: #fff;
text-decoration: none;
}
.short_description,
.call_to_action {
font: 300 18pt/150% 'Yandex Sans Display Web', Arial, sans-serif;
margin: 6px 0 24px;
}
.call_to_action {
color: #07f;
font-weight: 400;
}
.download_div {
2016-05-26 13:51:42 +00:00
margin: 80px;
text-align: center;
}
.download:link,
.download:active,
.download:visited {
background: #ffdb4d;
2016-05-26 13:51:42 +00:00
font: 300 18pt 'Yandex Sans Display Web', Arial, sans-serif;
padding: 15px 22px;
margin: auto;
color: #000;
text-decoration: none;
2016-05-26 13:51:42 +00:00
border-radius: 3px;
}
.download:hover {
color: #f00;
text-decoration: none;
}
.footer {
text-align: right;
padding: 10px 0 0;
color: #888;
font-size: 10pt;
}
.feedback_form {
position: absolute;
}
.feedback_form, .download_instructions {
display: none;
background: #fff;
padding: 20px;
box-shadow: 10px 10px 300px 350px #fff;
}
code {
font: 13px/18px monospace, "Courier New";
display: block;
border-left: 5px solid #ffdb4d;
padding: 5px 10px;
background: #000;
color: #ccc;
}
ul {
margin: 0;
padding-left: 0;
}
ul.dashed {
list-style-type: none;
}
ul.dashed > li {
text-indent: 5px;
}
ul.dashed > li:before {
content: '— ';
text-indent: 5px;
}
.warranty {
font-size: 10pt;
color: #888;
line-height: 150%;
}
.nomarkerlist {
2016-06-13 18:41:33 +00:00
list-style-type: none;
}
.distributive_selected {
color: #000;
font-weight: bold;
}
.distributive_not_selected {
color: #08f;
cursor: pointer;
border-bottom: 1px dashed #08f;
}
</style>
2016-05-22 21:42:44 +00:00
</head>
<body>
<div class="page">
<h1>ClickHouse</h1>
2016-05-22 21:42:44 +00:00
<div class="feedback_form">
<h2>Feedback</h2>
<p>Ask any questions on <a href="https://stackoverflow.com/">Stackoverflow</a>.</p>
<p>Use <a href="https://groups.google.com/group/clickhouse">Google Group</a> for discussion.</p>
<p>Or send private message to developers: <a href="mailto:clickhouse-feedback@yandex-team.com">clickhouse-feedback@yandex-team.com</a>.</p>
<p class="warranty">Software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,<br /> either express or implied.</p>
</div>
<p class="short_description">ClickHouse is an open-source column-oriented database management system that allows generating analytical data reports in real time.</p>
<div class="menu">
<a class="menu_item" href="reference_en.html">Documentation</a>
<a class="menu_item" href="tutorial.html">Quick start</a>
2016-06-03 02:03:40 +00:00
<a class="menu_item" href="#download" id="download_menu_item">Download</a>
<a class="menu_item" href="https://github.com/yandex/ClickHouse">Source</a>
<a class="menu_item" href="benchmark.html">Benchmark</a>
2016-06-03 02:03:40 +00:00
<a class="menu_item" href="#feedback" id="feedback">Feedback</a>
</div>
2016-05-22 21:42:44 +00:00
<p>ClickHouse manages extremely large volumes of data in a stable and sustainable manner. It&nbsp;currently powers <a href="https://metrica.yandex.com/">Yandex.Metrica</a>, worlds <a href="http://w3techs.com/technologies/overview/traffic_analysis/all">second largest</a> web analytics platform, with over 13 trillion database records and over 20 billion events a day, generating customized reports on-the-fly, directly from non-aggregated data. This system was successfully implemented at <a href="https://www.yandex.com/company/press_center/press_releases/2012/2012-04-10/">CERNs LHCb experiment</a> to store and process metadata on 10bn events with over 1000 attributes per event registered in 2011.</p>
2016-05-22 21:42:44 +00:00
<h2>ClickHouse. Just makes you think faster.</h2>
2016-05-22 21:42:44 +00:00
<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>
2016-05-22 21:42:44 +00:00
<h2>Linearly scalable</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse allows companies to add servers to their clusters when necessary without investing time or money into additional DBMS modification. The system has been successfully serving <a href="https://metrica.yandex.com/">Yandex.Metrica</a>, while the servers just in its main cluster, located in six geographically distributed datacenters, have grown from 60 to 394 in two years.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse scales well both vertically and horizontally. ClickHouse is easily adaptable to perform both on hundreds of node clusters, and on a single server or even virtual machine. It&nbsp;currently has installations with more than two trillion rows per single node, as well as installations with 100 TB of storage per single node.</p>
2016-05-22 21:42:44 +00:00
<h2>Hardware-efficient</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse processes typical analytical queries two to three orders of magnitude faster than traditional row-oriented systems with the same available IO throughput. The systems columnar format allows fitting more hot data in the servers RAM, which leads to a shorter response time.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse allows to minimize number of seeks for range queries, which increases efficiency of using rotational drives, as it&nbsp;maintains locality of reference for stored data continually.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse is CPU efficient because of its vectorized query execution and runtime code generation.</p>
2016-05-22 21:42:44 +00:00
<p>By minimizing data transfers for most types of queries, ClickHouse enables companies to manage their data and create reports without using a network that supports high-performance computing.</p>
2016-05-22 21:42:44 +00:00
<h2>Fast</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouses performance <a href="benchmark.html">exceeds</a> comparable column-oriented DBMS currently available on the market. It&nbsp;processes hundreds of millions to more than a billion rows and tens of gigabytes of data per single server per second.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse uses all available hardware to its full potential to process each query as fast as possible. The peak processing performance for a single query (after decompression, only used columns) stands at more than 2&nbsp;terabytes per second.</p>
2016-05-22 21:42:44 +00:00
<h2>Fault-tolerant</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse supports multi-master asynchronous replication and can be deployed across multiple datacenters. Downtime of a single node or the whole datacenter wont affect the systems availability for reads and writes. Distributed reads are automatically balanced to live replicas without increasing latency. Replicated data are synchronized automatically or semi-automatically after the downtime.</p>
2016-05-22 21:42:44 +00:00
<h2>Feature-rich</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse features a number of built-in user-friendly web analytics capabilities, including probabilistic data structures for fast and memory-efficient calculation of cardinalities and quantiles, or functions for addressing URLs and IPs (both IPv4 and IPv6) as well as identifying dates, times and time zones.</p>
2016-05-22 21:42:44 +00:00
<p>Data management methods available in ClickHouse, such as arrays, array joins and nested data structures, are extremely efficient for managing denormalized data.</p>
2016-05-22 21:42:44 +00:00
<p>Using ClickHouse allows joining both distributed data and co-located data, as the system supports local joins and distributed joins. It&nbsp;also offers an opportunity to use external dictionaries, dimension tables loaded from an external source, for seamless joins.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse supports approximate query processing you can get results as fast as you want, which is indispensable when dealing with terabytes and petabytes of data.</p>
2016-05-22 21:42:44 +00:00
<p>The systems conditional aggregate functions, calculation of totals and extremes, allow getting results with a single query without having to run a number of them.</p>
2016-05-22 21:42:44 +00:00
<h2>Simple and handy</h2>
2016-05-22 21:42:44 +00:00
<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>
2016-05-22 21:42:44 +00:00
<h2>Highly reliable</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse has been managing petabytes of data serving a number of high-load mass-audience services of Russias leading search provider and one of Europes largest IT companies, <a href="https://www.yandex.com/company/">Yandex</a>. Since 2012, ClickHouse has been providing robust database management for the companys <a href="https://metrica.yandex.com/">web analytics service</a>, comparison shopping platform, email service, online advertising platform, business intelligence and infrastructure monitoring.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse is purely distributed system located on independent nodes, which has no single point of failure.</p>
2016-05-22 21:42:44 +00:00
<p>Software or hardware failures or misconfigurations do not result in loss of data. Instead of deleting "broken" data, Clickhouse saves it&nbsp;or asks you what to do before a startup. All data are checksummed before every read or write to disk or network. It&nbsp;is virtually impossible to delete data by accident.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse offers flexible limits on query complexity and resource usage, which can be fine-tuned using settings. It&nbsp;is possible to simultaneously serve both a number of high priority low-latency requests and some long-running queries with lowered priority.</p>
2016-05-22 21:42:44 +00:00
<h2>Opens new possibilities</h2>
2016-05-22 21:42:44 +00:00
<p>ClickHouse streamlines all your data processing. Its easy to use: ingest all your structured data into the system, and it&nbsp;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&nbsp;down.</p>
2016-05-22 21:42:44 +00:00
<p>ClickHouse works <a href="benchmark.html">100-1,000x faster</a> than traditional approaches. In contrast to data management methods, where vast amounts of raw data in its native format are available as a data lake for any given query, ClickHouse, in most cases, offers instant results: the data is processed faster than it&nbsp;takes to make a query.</p>
2016-05-22 21:42:44 +00:00
<table width="100%">
<tr>
<td valign="top">
<h2>Key Features</h2>
2016-05-22 21:42:44 +00:00
<ul class="dashed">
<li>True column-oriented</li>
<li>Vectorized query execution</li>
<li>Data compression</li>
<li>Parallel and distributed query execution</li>
<li>Real-time data ingestion</li>
<li>On-disk locality of reference</li>
<li>Real-time query processing</li>
<li>Cross-datacenter replication</li>
<li>High availability</li>
<li>SQL support</li>
<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>
</td>
<td valign="top">
<h2>Applications</h2>
2016-05-22 21:42:44 +00:00
<ul class="dashed">
<li>Web and App analytics</li>
<li>Advertising networks and RTB</li>
<li>Telecommunications</li>
<li>E-commerce</li>
<li>Information security</li>
<li>Monitoring and telemetry</li>
<li>Business intelligence</li>
<li>Online games</li>
<li>Internet of Things</li>
</ul>
</td>
</tr>
</table>
2016-05-22 21:42:44 +00:00
<div class="download_div">
<a class="download" href="#" id="download_big_button">Download</a>
</div>
2016-05-22 21:42:44 +00:00
<div class="download_instructions">
<h2>Download</h2>
2016-05-22 21:42:44 +00:00
2016-06-10 12:49:27 +00:00
<p>System requirements: Linux, x86_64 with SSE 4.2.</p>
2016-05-22 21:42:44 +00:00
2016-06-13 18:41:33 +00:00
<p>Install packages for
<span class="distributive_not_selected" id="ubuntu_xenial">Ubuntu 16.04 (Xenial)</span> or <span class="distributive_selected" id="ubuntu_trusty">Ubuntu 14.04 (Trusty)</span> or <span class="distributive_not_selected" id="ubuntu_precise">Ubuntu 12.04 (Precise)</span>:
2016-06-13 18:41:33 +00:00
</p>
2016-05-22 21:42:44 +00:00
<code>
<pre>
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv E0C56BD4 # optional
sudo mkdir -p /etc/apt/sources.list.d
echo "deb http://repo.yandex.ru/clickhouse/<span id="distributive">trusty</span> stable main" |
&nbsp;&nbsp;&nbsp;&nbsp;sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update
2016-05-22 21:42:44 +00:00
sudo apt-get install clickhouse-server-common clickhouse-client
2016-05-22 21:42:44 +00:00
sudo service clickhouse-server start
2016-05-22 21:42:44 +00:00
clickhouse-client
</pre>
</code>
2016-05-22 21:42:44 +00:00
<p>Read the <a href="reference_en.html">documentation</a>.</p>
2016-05-22 21:42:44 +00:00
<p>Or build ClickHouse from <a href="https://github.com/yandex/ClickHouse">sources</a> according to the <a href="https://github.com/yandex/ClickHouse/blob/master/doc/build.md">instruction</a>.</p>
</div>
2016-05-22 21:42:44 +00:00
<p class="footer">&copy; 2016 YANDEX LLC</p>
<script type="text/javascript">
var block_visible = [];
function showBlock(class_name) {
var element = document.getElementsByClassName(class_name)[0];
element.style.display = 'block';
document.body.style.backgroundColor = '#888';
block_visible[class_name] = true;
2016-05-22 21:42:44 +00:00
}
function hideBlock(class_name) {
var element = document.getElementsByClassName(class_name)[0];
element.style.display = 'none';
document.body.style.backgroundColor = 'white';
block_visible[class_name] = false;
}
document.getElementById('feedback').addEventListener('click', function(e) {
2016-06-03 02:03:40 +00:00
var class_name = 'feedback_form';
block_visible[class_name] ? hideBlock(class_name) : showBlock(class_name);
e.stopPropagation();
});
var show_download_block = function(e) {
2016-06-03 02:03:40 +00:00
var class_name = 'download_instructions';
block_visible[class_name] ? hideBlock(class_name) : showBlock(class_name);
document.getElementById('download_big_button').style.display = 'none';
2016-06-03 02:03:40 +00:00
if (e) {
e.stopPropagation();
e.preventDefault();
}
window.scrollTo(0, document.getElementsByClassName(class_name)[0].offsetTop);
};
document.getElementById('download_menu_item').addEventListener('click', show_download_block);
document.getElementById('download_big_button').addEventListener('click', show_download_block);
document.body.addEventListener('click', function(e) {
var element = e.target;
while (element !== document.body) {
if (element.className == 'feedback_form' || element.className == 'download_instructions') {
return;
}
element = element.parentNode;
}
hideBlock('feedback_form');
hideBlock('download_instructions');
document.getElementById('download_big_button').style.display = 'inline';
});
2016-06-03 02:03:40 +00:00
if (location.hash == "#download") {
show_download_block();
}
if (location.hash == "#feedback") {
var class_name = 'feedback_form';
block_visible[class_name] ? hideBlock(class_name) : showBlock(class_name);
}
var available_distributives = ['xenial', 'trusty', 'precise'];
2016-06-13 18:41:33 +00:00
function selectDistributive(name) {
console.log(name);
document.getElementById('distributive').innerHTML = name;
available_distributives.forEach(function(distr) {
document.getElementById('ubuntu_' + distr).className = (name == distr) ? 'distributive_selected' : 'distributive_not_selected';
});
2016-06-13 18:41:33 +00:00
}
available_distributives.forEach(function(distr) {
document.getElementById('ubuntu_' + distr).addEventListener('click', function(e) { selectDistributive(distr); });
});
2016-06-13 18:41:33 +00:00
</script>
<!-- Yandex.Metrika counter -->
<script src="https://mc.yandex.ru/metrika/watch.js" type="text/javascript"></script>
<script type="text/javascript">
try { var yaCounter18343495 = new Ya.Metrika({id:18343495,
webvisor:true,
clickmap:true,
trackLinks:true,
accurateTrackBounce:true,
trackHash:true});
} catch(e) { }
</script>
<noscript><div><img src="https://mc.yandex.ru/watch/18343495" style="position:absolute; left:-9999px;" alt="" /></div></noscript>
<!-- /Yandex.Metrika counter -->
2016-05-22 23:01:00 +00:00
2016-05-22 21:42:44 +00:00
</div>
</body>
</html>