HBASE-14732 Update HBase website skin and CSS (publish result)
Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/c30df8ca Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/c30df8ca Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/c30df8ca Branch: refs/heads/asf-site Commit: c30df8caa43211126b1aeafff77fd8e7507b1a13 Parents: a293c00 Author: Misty Stanley-Jones <mstanleyjo...@cloudera.com> Authored: Thu Nov 5 09:40:34 2015 +1000 Committer: Misty Stanley-Jones <mstanleyjo...@cloudera.com> Committed: Thu Nov 5 09:40:34 2015 +1000 ---------------------------------------------------------------------- .htaccess | 8 + _chapters/images/hbase_logo_with_orca_large.png | Bin 0 -> 21196 bytes acid-semantics.html | 981 +- apache_hbase_reference_guide.pdf | 486829 +++++++++++++++- apache_hbase_reference_guide.pdfmarks | 4 +- book.html | 300 +- bulk-loads.html | 526 +- checkstyle-aggregate.html | 29297 +- coc.html | 568 +- css/apache-maven-fluido-1.4.min.css | 9 + css/bootswatch.css | 70 - css/docs.css | 150 - css/lightbox.css | 210 - css/print.css | 95 +- css/reflow-skin.css | 99 - css/site.css | 196 +- cygwin.html | 1119 +- dependencies.html | 1064 +- dependency-convergence.html | 3981 +- dependency-info.html | 608 +- dependency-management.html | 1643 +- .../class-use/InterfaceStability.Unstable.html | 12 +- .../hbase/classification/package-tree.html | 4 +- .../hadoop/hbase/client/package-tree.html | 6 +- .../hadoop/hbase/filter/package-tree.html | 6 +- .../hadoop/hbase/io/hfile/package-tree.html | 2 +- .../hadoop/hbase/master/package-tree.html | 4 +- .../org/apache/hadoop/hbase/package-tree.html | 10 +- .../hadoop/hbase/quotas/package-tree.html | 2 +- .../hadoop/hbase/regionserver/package-tree.html | 16 +- .../hadoop/hbase/security/package-tree.html | 2 +- .../apache/hadoop/hbase/util/package-tree.html | 6 +- distribution-management.html | 556 +- export_control.html | 560 +- fonts/glyphicons-halflings-regular.eot | Bin 0 -> 35283 bytes fonts/glyphicons-halflings-regular.svg | 229 + fonts/glyphicons-halflings-regular.ttf | Bin 0 -> 55016 bytes fonts/glyphicons-halflings-regular.woff | Bin 0 -> 41793 bytes images/accessories-text-editor.png | Bin 0 -> 746 bytes images/add.gif | Bin 0 -> 397 bytes images/apache-maven-project-2.png | Bin 0 -> 43073 bytes images/application-certificate.png | Bin 0 -> 923 bytes images/contact-new.png | Bin 0 -> 736 bytes images/document-properties.png | Bin 0 -> 577 bytes images/drive-harddisk.png | Bin 0 -> 700 bytes images/fix.gif | Bin 0 -> 366 bytes images/hbase_logo_with_orca_large.png | Bin 0 -> 21196 bytes images/icon_error_sml.gif | Bin 0 -> 633 bytes images/icon_help_sml.gif | Bin 0 -> 1072 bytes images/icon_info_sml.gif | Bin 0 -> 638 bytes images/icon_success_sml.gif | Bin 0 -> 604 bytes images/icon_warning_sml.gif | Bin 0 -> 625 bytes images/image-x-generic.png | Bin 0 -> 662 bytes images/internet-web-browser.png | Bin 0 -> 1017 bytes images/logos/build-by-maven-black.png | Bin 0 -> 2294 bytes images/logos/build-by-maven-white.png | Bin 0 -> 2260 bytes images/logos/maven-feather.png | Bin 0 -> 3330 bytes images/network-server.png | Bin 0 -> 536 bytes images/package-x-generic.png | Bin 0 -> 717 bytes images/profiles/pre-release.png | Bin 0 -> 32607 bytes images/profiles/retired.png | Bin 0 -> 22003 bytes images/profiles/sandbox.png | Bin 0 -> 33010 bytes images/remove.gif | Bin 0 -> 607 bytes images/rss.png | Bin 360 -> 474 bytes images/update.gif | Bin 0 -> 1090 bytes images/window-new.png | Bin 0 -> 583 bytes index.html | 706 +- integration.html | 554 +- issue-tracking.html | 546 +- js/apache-maven-fluido-1.4.min.js | 25 + js/lightbox.min.js | 10 - js/reflow-scroll.js | 23 - js/reflow-skin.js | 26 - license.html | 568 +- mail-lists.html | 661 +- metrics.html | 736 +- modules.html | 717 +- old_news.html | 695 +- plugin-management.html | 854 +- plugins.html | 732 +- poweredbyhbase.html | 1292 +- project-info.html | 667 +- project-reports.html | 601 +- project-summary.html | 658 +- pseudo-distributed.html | 526 +- replication.html | 526 +- resources.html | 566 +- source-repository.html | 578 +- sponsors.html | 572 +- supportingprojects.html | 1001 +- team-list.html | 1455 +- testdevapidocs/allclasses-frame.html | 1 + testdevapidocs/allclasses-noframe.html | 1 + testdevapidocs/index-all.html | 14 + .../TestFavoredNodeAssignmentHelper.html | 4 +- .../balancer/TestRegionLocationFinder.html | 323 + .../master/balancer/TestServerAndLoad.html | 4 +- .../class-use/TestRegionLocationFinder.html | 115 + .../hbase/master/balancer/package-frame.html | 1 + .../hbase/master/balancer/package-summary.html | 4 + .../hbase/master/balancer/package-tree.html | 1 + testdevapidocs/overview-tree.html | 1 + .../balancer/TestRegionLocationFinder.html | 217 + xref-test/allclasses-frame.html | 3 + .../balancer/TestRegionLocationFinder.html | 159 + .../hbase/master/balancer/package-frame.html | 3 + .../hbase/master/balancer/package-summary.html | 5 + .../master/balancer/RegionLocationFinder.html | 80 +- .../hbase/tmpl/common/TaskMonitorTmpl.html | 60 +- .../hbase/tmpl/common/TaskMonitorTmplImpl.html | 16 +- .../hbase/tmpl/master/MasterStatusTmpl.html | 180 +- .../hbase/tmpl/master/MasterStatusTmplImpl.html | 52 +- .../hbase/tmpl/regionserver/RSStatusTmpl.html | 90 +- .../tmpl/regionserver/RSStatusTmplImpl.html | 28 +- 114 files changed, 514268 insertions(+), 31561 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/c30df8ca/.htaccess ---------------------------------------------------------------------- diff --git a/.htaccess b/.htaccess new file mode 100644 index 0000000..20bf651 --- /dev/null +++ b/.htaccess @@ -0,0 +1,8 @@ + +# Redirect replication URL to the right section of the book +# Rule added 2015-1-12 -- can be removed in 6 months +Redirect permanent /replication.html /book.html#_cluster_replication + +# Redirect old page-per-chapter book sections to new single file. +RedirectMatch permanent ^/book/(.*)\.html$ /book.html#$1 +RedirectMatch permanent ^/book/$ /book.html http://git-wip-us.apache.org/repos/asf/hbase/blob/c30df8ca/_chapters/images/hbase_logo_with_orca_large.png ---------------------------------------------------------------------- diff --git a/_chapters/images/hbase_logo_with_orca_large.png b/_chapters/images/hbase_logo_with_orca_large.png new file mode 100644 index 0000000..e91eb8d Binary files /dev/null and b/_chapters/images/hbase_logo_with_orca_large.png differ http://git-wip-us.apache.org/repos/asf/hbase/blob/c30df8ca/acid-semantics.html ---------------------------------------------------------------------- diff --git a/acid-semantics.html b/acid-semantics.html index fc3ee68..6915acb 100644 --- a/acid-semantics.html +++ b/acid-semantics.html @@ -1,165 +1,261 @@ - <!DOCTYPE html> <!-- - Generated by Apache Maven Doxia at 2015-11-05 - Rendered using Reflow Maven Skin 1.1.1 (http://andriusvelykis.github.io/reflow-maven-skin) + | Generated by Apache Maven Doxia + | Rendered using Apache Maven Fluido Skin 1.4 --> -<html xml:lang="en" lang="en"> - - <head> - <meta charset="UTF-8" /> - <title>Apache HBase – +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20151105" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache HBase – Apache HBase (TM) ACID Properties </title> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="description" content="" /> - <meta http-equiv="content-language" content="en" /> - - <link href="//netdna.bootstrapcdn.com/bootswatch/2.3.2/spacelab/bootstrap.min.css" rel="stylesheet" /> - <link href="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.1/css/bootstrap-responsive.min.css" rel="stylesheet" /> - <link href="./css/bootswatch.css" rel="stylesheet" /> - <link href="./css/reflow-skin.css" rel="stylesheet" /> - - - <link href="./css/lightbox.css" rel="stylesheet" /> - - <link href="./css/site.css" rel="stylesheet" /> - <link href="./css/print.css" rel="stylesheet" media="print" /> - - <!-- Le HTML5 shim, for IE6-8 support of HTML5 elements --> - <!--[if lt IE 9]> - <script src="http://html5shim.googlecode.com/svn/trunk/html5.js";></script> - <![endif]--> - - - - </head> - - <body class="page-acid-semantics project-hbase" data-spy="scroll" data-offset="60" data-target="#toc-scroll-target"> - - <div class="navbar navbar-fixed-top"> - <div class="navbar-inner"> - <div class="container"> - <a class="btn btn-navbar" data-toggle="collapse" data-target="#top-nav-collapse"> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </a> - <div class="nav-collapse collapse" id="top-nav-collapse"> - <ul class="nav pull-right"> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache HBase Project <b class="caret"></b></a> - <ul class="dropdown-menu"> - <li ><a href="index.html" title="Overview">Overview</a></li> - <li ><a href="license.html" title="License">License</a></li> - <li ><a href="http://www.apache.org/dyn/closer.cgi/hbase/"; title="Downloads" class="externalLink">Downloads</a></li> - <li ><a href="https://issues.apache.org/jira/browse/HBASE?report=com.atlassian.jira.plugin.system.project:changelog-panel#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel"; title="Release Notes" class="externalLink">Release Notes</a></li> - <li ><a href="coc.html" title="Code Of Conduct">Code Of Conduct</a></li> - <li ><a href="http://blogs.apache.org/hbase/"; title="Blog" class="externalLink">Blog</a></li> - <li ><a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> - <li ><a href="team-list.html" title="Team">Team</a></li> - <li ><a href="https://reviews.apache.org/"; title="ReviewBoard" class="externalLink">ReviewBoard</a></li> - <li ><a href="sponsors.html" title="Thanks">Thanks</a></li> - <li ><a href="poweredbyhbase.html" title="Powered by HBase">Powered by HBase</a></li> - <li ><a href="resources.html" title="Other resources">Other resources</a></li> - </ul> - </li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Information <b class="caret"></b></a> - <ul class="dropdown-menu"> - <li ><a href="index.html" title="About">About</a></li> - <li ><a href="project-summary.html" title="Project Summary">Project Summary</a></li> - <li ><a href="dependency-info.html" title="Dependency Information">Dependency Information</a></li> - <li ><a href="team-list.html" title="Team">Team</a></li> - <li ><a href="source-repository.html" title="Source Repository">Source Repository</a></li> - <li ><a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> - <li ><a href="license.html" title="License">License</a></li> - <li ><a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> - <li ><a href="dependency-management.html" title="Dependency Management">Dependency Management</a></li> - <li ><a href="dependencies.html" title="Dependencies">Dependencies</a></li> - <li ><a href="dependency-convergence.html" title="Dependency Convergence">Dependency Convergence</a></li> - <li ><a href="integration.html" title="Continuous Integration">Continuous Integration</a></li> - <li ><a href="plugin-management.html" title="Plugin Management">Plugin Management</a></li> - <li ><a href="plugins.html" title="Plugins">Plugins</a></li> - </ul> - </li> - <li class="dropdown active"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation and API <b class="caret"></b></a> - <ul class="dropdown-menu"> - <li ><a href="book.html" title="Reference Guide" target="_blank">Reference Guide</a></li> - <li ><a href="apache_hbase_reference_guide.pdf" title="Reference Guide (PDF)" target="_blank">Reference Guide (PDF)</a></li> - <li ><a href="book.html#quickstart" title="Getting Started" target="_blank">Getting Started</a></li> - <li ><a href="apidocs/index.html" title="User API" target="_blank">User API</a></li> - <li ><a href="testapidocs/index.html" title="User API (Test)" target="_blank">User API (Test)</a></li> - <li ><a href="devapidocs/index.html" title="Developer API" target="_blank">Developer API</a></li> - <li ><a href="testdevapidocs/index.html" title="Developer API (Test)" target="_blank">Developer API (Test)</a></li> - <li ><a href="xref/index.html" title="X-Ref">X-Ref</a></li> - <li ><a href="xref-test/index.html" title="X-Ref (Test)">X-Ref (Test)</a></li> - <li ><a href="http://abloz.com/hbase/book.html"; title="ä¸æåèæå(å页)" target="_blank" class="externalLink">ä¸æåèæå(å页)</a></li> - <li ><a href="book.html#faq" title="FAQ" target="_blank">FAQ</a></li> - <li ><a href="book.html#other.info" title="Videos/Presentations" target="_blank">Videos/Presentations</a></li> - <li ><a href="http://wiki.apache.org/hadoop/Hbase"; title="Wiki" target="_blank" class="externalLink">Wiki</a></li> - <li class="active"><a href="" title="ACID Semantics" target="_blank">ACID Semantics</a></li> - <li ><a href="book.html#arch.bulk.load" title="Bulk Loads" target="_blank">Bulk Loads</a></li> - <li ><a href="metrics.html" title="Metrics" target="_blank">Metrics</a></li> - <li ><a href="cygwin.html" title="HBase on Windows" target="_blank">HBase on Windows</a></li> - <li ><a href="replication.html" title="Cluster replication" target="_blank">Cluster replication</a></li> - </ul> - </li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown">0.94 Documentation <b class="caret"></b></a> - <ul class="dropdown-menu"> - <li ><a href="0.94/apidocs/index.html" title="API" target="_blank">API</a></li> - <li ><a href="0.94/xref/index.html" title="X-Ref" target="_blank">X-Ref</a></li> - <li ><a href="0.94/book.html" title="Ref Guide (single-page)" target="_blank">Ref Guide (single-page)</a></li> - </ul> - </li> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a> - <ul class="dropdown-menu"> - <li ><a href="http://www.apache.org/foundation/"; title="Apache Software Foundation" target="_blank" class="externalLink">Apache Software Foundation</a></li> - <li ><a href="http://www.apache.org/foundation/how-it-works.html"; title="How Apache Works" target="_blank" class="externalLink">How Apache Works</a></li> - <li ><a href="http://www.apache.org/foundation/sponsorship.html"; title="Sponsoring Apache" target="_blank" class="externalLink">Sponsoring Apache</a></li> - </ul> - </li> - </ul> - </div><!--/.nav-collapse --> - </div> - </div> - </div> - - <div class="container"> - - <!-- Masthead - ================================================== --> - - <header> - <div class="jumbotron subhead"> - <div class="row" id="banner"> - <div class="span12"> - <div class="pull-left"> - <a href="./" id="bannerLeft"><img src="images/hbase_logo.png" alt='"'Apache HBase'"' /></a> - </div> - <div class="pull-right"> - <a href="./" id="bannerRight"><img src="images/jumping-orca_rotated_25percent.png" alt='"'Apache HBase Orca'"' /></a> - </div> - </div> - </div> - </div> - <div> - <ul class="breadcrumb"> - <li class="projectVersion version-date">Version: 2.0.0-SNAPSHOT</li> - <li class="divider">|</li> - <li class="publishDate version-date">Last Published: 2015-11-05</li> - </ul> - </div> - </header> - - <div class="main-body"> - <div class="row"> - <div class="span12"> - <div class="body-content"> -<!-- Licensed to the Apache Software Foundation (ASF) under one + <link rel="stylesheet" href="./css/apache-maven-fluido-1.4.min.css" /> + <link rel="stylesheet" href="./css/site.css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + + <script type="text/javascript" src="./js/apache-maven-fluido-1.4.min.js"></script> + + + +<meta content="width=device-width, initial-scale=1.0" name="viewport"></meta> + + +<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/8.9.1/styles/github.min.css"/> + + +<link rel="stylesheet" href="css/site.css"/> + + +<script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/8.9.1/highlight.min.js"></script> + + </head> + <body class="topBarEnabled"> + + + + + + <div id="topbar" class="navbar navbar-fixed-top "> + <div class="navbar-inner"> + <div class="container" style="width: 98%;"><div class="nav-collapse"> + + + <ul class="nav"> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache HBase Project <b class="caret"></b></a> + <ul class="dropdown-menu"> + + <li> <a href="index.html" title="Overview">Overview</a> +</li> + + <li> <a href="license.html" title="License">License</a> +</li> + + <li> <a href="http://www.apache.org/dyn/closer.cgi/hbase/"; title="Downloads">Downloads</a> +</li> + + <li> <a href="https://issues.apache.org/jira/browse/HBASE?report=com.atlassian.jira.plugin.system.project:changelog-panel#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel"; title="Release Notes">Release Notes</a> +</li> + + <li> <a href="coc.html" title="Code Of Conduct">Code Of Conduct</a> +</li> + + <li> <a href="http://blogs.apache.org/hbase/"; title="Blog">Blog</a> +</li> + + <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a> +</li> + + <li> <a href="team-list.html" title="Team">Team</a> +</li> + + <li> <a href="https://reviews.apache.org/"; title="ReviewBoard">ReviewBoard</a> +</li> + + <li> <a href="sponsors.html" title="Thanks">Thanks</a> +</li> + + <li> <a href="poweredbyhbase.html" title="Powered by HBase">Powered by HBase</a> +</li> + + <li> <a href="resources.html" title="Other resources">Other resources</a> +</li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Information <b class="caret"></b></a> + <ul class="dropdown-menu"> + + <li> <a href="project-summary.html" title="Project Summary">Project Summary</a> +</li> + + <li> <a href="dependency-info.html" title="Dependency Information">Dependency Information</a> +</li> + + <li> <a href="team-list.html" title="Team">Team</a> +</li> + + <li> <a href="source-repository.html" title="Source Repository">Source Repository</a> +</li> + + <li> <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a> +</li> + + <li> <a href="dependency-management.html" title="Dependency Management">Dependency Management</a> +</li> + + <li> <a href="dependencies.html" title="Dependencies">Dependencies</a> +</li> + + <li> <a href="dependency-convergence.html" title="Dependency Convergence">Dependency Convergence</a> +</li> + + <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a> +</li> + + <li> <a href="plugin-management.html" title="Plugin Management">Plugin Management</a> +</li> + + <li> <a href="plugins.html" title="Plugins">Plugins</a> +</li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation and API <b class="caret"></b></a> + <ul class="dropdown-menu"> + + <li> <a href="book.html" target="_blank" title="Reference Guide">Reference Guide</a> +</li> + + <li> <a href="apache_hbase_reference_guide.pdf" target="_blank" title="Reference Guide (PDF)">Reference Guide (PDF)</a> +</li> + + <li> <a href="book.html#quickstart" target="_blank" title="Getting Started">Getting Started</a> +</li> + + <li> <a href="apidocs/index.html" target="_blank" title="User API">User API</a> +</li> + + <li> <a href="testapidocs/index.html" target="_blank" title="User API (Test)">User API (Test)</a> +</li> + + <li> <a href="devapidocs/index.html" target="_blank" title="Developer API">Developer API</a> +</li> + + <li> <a href="testdevapidocs/index.html" target="_blank" title="Developer API (Test)">Developer API (Test)</a> +</li> + + <li> <a href="xref/index.html" title="X-Ref">X-Ref</a> +</li> + + <li> <a href="xref-test/index.html" title="X-Ref (Test)">X-Ref (Test)</a> +</li> + + <li> <a href="http://abloz.com/hbase/book.html"; target="_blank" title="ä¸æåèæå(å页)">ä¸æåèæå(å页)</a> +</li> + + <li> <a href="book.html#faq" target="_blank" title="FAQ">FAQ</a> +</li> + + <li> <a href="book.html#other.info" target="_blank" title="Videos/Presentations">Videos/Presentations</a> +</li> + + <li> <a href="http://wiki.apache.org/hadoop/Hbase"; target="_blank" title="Wiki">Wiki</a> +</li> + + <li> <a href="acid-semantics.html" target="_blank" title="ACID Semantics">ACID Semantics</a> +</li> + + <li> <a href="book.html#arch.bulk.load" target="_blank" title="Bulk Loads">Bulk Loads</a> +</li> + + <li> <a href="metrics.html" target="_blank" title="Metrics">Metrics</a> +</li> + + <li> <a href="cygwin.html" target="_blank" title="HBase on Windows">HBase on Windows</a> +</li> + + <li> <a href="replication.html" target="_blank" title="Cluster replication">Cluster replication</a> +</li> + + <li class="dropdown-submenu"> + <a href="" title="0.94 Documentation">0.94 Documentation</a> + <ul class="dropdown-menu"> + <li> <a href="0.94/apidocs/index.html" target="_blank" title="API">API</a> +</li> + <li> <a href="0.94/xref/index.html" target="_blank" title="X-Ref">X-Ref</a> +</li> + <li> <a href="0.94/book.html" target="_blank" title="Ref Guide (single-page)">Ref Guide (single-page)</a> +</li> + </ul> + </li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a> + <ul class="dropdown-menu"> + + <li> <a href="http://www.apache.org/foundation/"; target="_blank" title="Apache Software Foundation">Apache Software Foundation</a> +</li> + + <li> <a href="http://www.apache.org/foundation/how-it-works.html"; target="_blank" title="How Apache Works">How Apache Works</a> +</li> + + <li> <a href="http://www.apache.org/foundation/sponsorship.html"; target="_blank" title="Sponsoring Apache">Sponsoring Apache</a> +</li> + </ul> + </li> + </ul> + + <form id="search-form" action="https://www.google.com/search"; method="get" class="navbar-search pull-right" > + + <input value="hbase.apache.org" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=search-form";></script> + + + + </div> + + </div> + </div> + </div> + + <div class="container"> + <div id="banner"> + <div class="pull-left"> + <div id="bannerLeft"> + <h2></h2> + </div> + </div> + <div class="pull-right"> <a href="./" id="bannerRight"> + <img src="images/hbase_logo_with_orca_large.png" alt="Apache HBase"/> + </a> + </div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + + + + + + + </ul> + </div> + + + + <div id="bodyColumn" > + + <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file @@ -175,260 +271,331 @@ software distributed under the License is distributed on an KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> + + <div class="section"> +<h2><a name="About_this_Document"></a>About this Document</h2> + +<p>Apache HBase (TM) is not an ACID compliant database. However, it does guarantee certain specific + properties.</p> + +<p>This specification enumerates the ACID properties of HBase.</p> + </div> + <div class="section"> - <div class="page-header"> - <h2 id="About_this_Document">About this Document</h2> - </div> - <p>Apache HBase (TM) is not an ACID compliant database. However, it does guarantee certain specific properties.</p> - <p>This specification enumerates the ACID properties of HBase.</p> -</div> +<h2><a name="Definitions"></a>Definitions</h2> + +<p>For the sake of common vocabulary, we define the following terms:</p> + +<dl> + +<dt>Atomicity</dt> + +<dd>an operation is atomic if it either completes entirely or not at all</dd> + + +<dt>Consistency</dt> + +<dd> + all actions cause the table to transition from one valid state directly to another + (eg a row will not disappear during an update, etc) + </dd> + + +<dt>Isolation</dt> + +<dd> + an operation is isolated if it appears to complete independently of any other concurrent transaction + </dd> + + +<dt>Durability</dt> + +<dd>any update that reports "successful" to the client will not be lost</dd> + + +<dt>Visibility</dt> + +<dd>an update is considered visible if any subsequent read will see the update as having been committed</dd> + </dl> + +<p> + The terms <i>must</i> and <i>may</i> are used as specified by RFC 2119. + In short, the word "must" implies that, if some case exists where the statement + is not true, it is a bug. The word "may" implies that, even if the guarantee + is provided in a current release, users should not rely on it. + </p> + </div> + +<div class="section"> +<h2><a name="APIs_to_consider"></a>APIs to consider</h2> + +<ul> + +<li>Read APIs + +<ul> + +<li>get</li> + +<li>scan</li> + </ul> + </li> + +<li>Write APIs</li> + +<ul> + +<li>put</li> + +<li>batch put</li> + +<li>delete</li> + </ul> + +<li>Combination (read-modify-write) APIs</li> + +<ul> + +<li>incrementColumnValue</li> + +<li>checkAndPut</li> + </ul> + </ul> + </div> + + +<div class="section"> +<h2><a name="Guarantees_Provided"></a>Guarantees Provided</h2> + + +<div class="section"> +<h2><a name="Atomicity"></a>Atomicity</h2> + + +<ol style="list-style-type: decimal"> + +<li>All mutations are atomic within a row. Any put will either wholely succeed or wholely fail.[3]</li> + +<ol style="list-style-type: decimal"> + +<li>An operation that returns a "success" code has completely succeeded.</li> + +<li>An operation that returns a "failure" code has completely failed.</li> + +<li>An operation that times out may have succeeded and may have failed. However, + it will not have partially succeeded or failed.</li> + </ol> + +<li> This is true even if the mutation crosses multiple column families within a row.</li> + +<li> APIs that mutate several rows will _not_ be atomic across the multiple rows. + For example, a multiput that operates on rows 'a','b', and 'c' may return having + mutated some but not all of the rows. In such cases, these APIs will return a list + of success codes, each of which may be succeeded, failed, or timed out as described above.</li> + +<li> The checkAndPut API happens atomically like the typical compareAndSet (CAS) operation + found in many hardware architectures.</li> + +<li> The order of mutations is seen to happen in a well-defined order for each row, with no + interleaving. For example, if one writer issues the mutation "a=1,b=1,c=1" and + another writer issues the mutation "a=2,b=2,c=2", the row must either + be "a=1,b=1,c=1" or "a=2,b=2,c=2" and must <i>not</i> be something + like "a=1,b=2,c=1".</li> + +<ol style="list-style-type: decimal"> + +<li>Please note that this is not true _across rows_ for multirow batch mutations.</li> + </ol> + </ol> + </div> + +<div class="section"> +<h2><a name="Consistency_and_Isolation"></a>Consistency and Isolation</h2> + +<ol style="list-style-type: decimal"> + +<li>All rows returned via any access API will consist of a complete row that existed at + some point in the table's history.</li> + +<li>This is true across column families - i.e a get of a full row that occurs concurrent + with some mutations 1,2,3,4,5 will return a complete row that existed at some point in time + between mutation i and i+1 for some i between 1 and 5.</li> + +<li>The state of a row will only move forward through the history of edits to it.</li> + </ol> + + <div class="section"> - <h2 id="Definitions">Definitions</h2> - <p>For the sake of common vocabulary, we define the following terms:</p> - <dl> - <dt> - Atomicity - </dt> - <dd> - an operation is atomic if it either completes entirely or not at all - </dd> - <dt> - Consistency - </dt> - <dd> - all actions cause the table to transition from one valid state directly to another (eg a row will not disappear during an update, etc) - </dd> - <dt> - Isolation - </dt> - <dd> - an operation is isolated if it appears to complete independently of any other concurrent transaction - </dd> - <dt> - Durability - </dt> - <dd> - any update that reports "successful" to the client will not be lost - </dd> - <dt> - Visibility - </dt> - <dd> - an update is considered visible if any subsequent read will see the update as having been committed - </dd> - </dl> - <p> The terms <i>must</i> and <i>may</i> are used as specified by RFC 2119. In short, the word "must" implies that, if some case exists where the statement is not true, it is a bug. The word "may" implies that, even if the guarantee is provided in a current release, users should not rely on it. </p> -</div> +<h2><a name="Consistency_of_Scans"></a>Consistency of Scans</h2> + +<p> + A scan is <b>not</b> a consistent view of a table. Scans do + <b>not</b> exhibit <i>snapshot isolation</i>. + </p> + +<p> + Rather, scans have the following properties: + </p> + + +<ol style="list-style-type: decimal"> + +<li> + Any row returned by the scan will be a consistent view (i.e. that version + of the complete row existed at some point in time) [1] + </li> + +<li> + A scan will always reflect a view of the data <i>at least as new as</i> + the beginning of the scan. This satisfies the visibility guarantees + enumerated below.</li> + +<ol style="list-style-type: decimal"> + +<li>For example, if client A writes data X and then communicates via a side + channel to client B, any scans started by client B will contain data at least + as new as X.</li> + +<li>A scan _must_ reflect all mutations committed prior to the construction + of the scanner, and _may_ reflect some mutations committed subsequent to the + construction of the scanner.</li> + +<li>Scans must include <i>all</i> data written prior to the scan (except in + the case where data is subsequently mutated, in which case it _may_ reflect + the mutation)</li> + </ol> + </ol> + +<p> + Those familiar with relational databases will recognize this isolation level as "read committed". + </p> + +<p> + Please note that the guarantees listed above regarding scanner consistency + are referring to "transaction commit time", not the "timestamp" + field of each cell. That is to say, a scanner started at time <i>t</i> may see edits + with a timestamp value greater than <i>t</i>, if those edits were committed with a + "forward dated" timestamp before the scanner was constructed. + </p> + </div> + </div> + <div class="section"> - <h2 id="APIs_to_consider">APIs to consider</h2> - <ul> - <li>Read APIs - <ul> - <li>get</li> - <li>scan</li> - </ul> </li> - <li>Write APIs</li> - <ul> - <li>put</li> - <li>batch put</li> - <li>delete</li> - </ul> - <li>Combination (read-modify-write) APIs</li> - <ul> - <li>incrementColumnValue</li> - <li>checkAndPut</li> - </ul> - </ul> -</div> +<h2><a name="Visibility"></a>Visibility</h2> + +<ol style="list-style-type: decimal"> + +<li> When a client receives a "success" response for any mutation, that + mutation is immediately visible to both that client and any client with whom it + later communicates through side channels. [3]</li> + +<li> A row must never exhibit so-called "time-travel" properties. That + is to say, if a series of mutations moves a row sequentially through a series of + states, any sequence of concurrent reads will return a subsequence of those states.</li> + +<ol style="list-style-type: decimal"> + +<li>For example, if a row's cells are mutated using the "incrementColumnValue" + API, a client must never see the value of any cell decrease.</li> + +<li>This is true regardless of which read API is used to read back the mutation.</li> + </ol> + +<li> Any version of a cell that has been returned to a read operation is guaranteed to + be durably stored.</li> + </ol> + + </div> + <div class="section"> - <h2 id="Guarantees_Provided">Guarantees Provided</h2> - <div class="section"> - <h2 id="Atomicity">Atomicity</h2> - <ol style="list-style-type: decimal"> - <li>All mutations are atomic within a row. Any put will either wholely succeed or wholely fail.[3]</li> - <ol style="list-style-type: decimal"> - <li>An operation that returns a "success" code has completely succeeded.</li> - <li>An operation that returns a "failure" code has completely failed.</li> - <li>An operation that times out may have succeeded and may have failed. However, it will not have partially succeeded or failed.</li> - </ol> - <li> This is true even if the mutation crosses multiple column families within a row.</li> - <li> APIs that mutate several rows will _not_ be atomic across the multiple rows. For example, a multiput that operates on rows 'a','b', and 'c' may return having mutated some but not all of the rows. In such cases, these APIs will return a list of success codes, each of which may be succeeded, failed, or timed out as described above.</li> - <li> The checkAndPut API happens atomically like the typical compareAndSet (CAS) operation found in many hardware architectures.</li> - <li> The order of mutations is seen to happen in a well-defined order for each row, with no interleaving. For example, if one writer issues the mutation "a=1,b=1,c=1" and another writer issues the mutation "a=2,b=2,c=2", the row must either be "a=1,b=1,c=1" or "a=2,b=2,c=2" and must <i>not</i> be something like "a=1,b=2,c=1".</li> - <ol style="list-style-type: decimal"> - <li>Please note that this is not true _across rows_ for multirow batch mutations.</li> - </ol> - </ol> - </div> - <div class="section"> - <h2 id="Consistency_and_Isolation">Consistency and Isolation</h2> - <ol style="list-style-type: decimal"> - <li>All rows returned via any access API will consist of a complete row that existed at some point in the table's history.</li> - <li>This is true across column families - i.e a get of a full row that occurs concurrent with some mutations 1,2,3,4,5 will return a complete row that existed at some point in time between mutation i and i+1 for some i between 1 and 5.</li> - <li>The state of a row will only move forward through the history of edits to it.</li> - </ol> - <div class="section"> - <h2 id="Consistency_of_Scans">Consistency of Scans</h2> - <p> A scan is <b>not</b> a consistent view of a table. Scans do <b>not</b> exhibit <i>snapshot isolation</i>. </p> - <p> Rather, scans have the following properties: </p> - <ol style="list-style-type: decimal"> - <li> Any row returned by the scan will be a consistent view (i.e. that version of the complete row existed at some point in time) [1] </li> - <li> A scan will always reflect a view of the data <i>at least as new as</i> the beginning of the scan. This satisfies the visibility guarantees enumerated below.</li> - <ol style="list-style-type: decimal"> - <li>For example, if client A writes data X and then communicates via a side channel to client B, any scans started by client B will contain data at least as new as X.</li> - <li>A scan _must_ reflect all mutations committed prior to the construction of the scanner, and _may_ reflect some mutations committed subsequent to the construction of the scanner.</li> - <li>Scans must include <i>all</i> data written prior to the scan (except in the case where data is subsequently mutated, in which case it _may_ reflect the mutation)</li> - </ol> - </ol> - <p> Those familiar with relational databases will recognize this isolation level as "read committed". </p> - <p> Please note that the guarantees listed above regarding scanner consistency are referring to "transaction commit time", not the "timestamp" field of each cell. That is to say, a scanner started at time <i>t</i> may see edits with a timestamp value greater than <i>t</i>, if those edits were committed with a "forward dated" timestamp before the scanner was constructed. </p> - </div> - </div> - <div class="section"> - <h2 id="Visibility">Visibility</h2> - <ol style="list-style-type: decimal"> - <li> When a client receives a "success" response for any mutation, that mutation is immediately visible to both that client and any client with whom it later communicates through side channels. [3]</li> - <li> A row must never exhibit so-called "time-travel" properties. That is to say, if a series of mutations moves a row sequentially through a series of states, any sequence of concurrent reads will return a subsequence of those states.</li> - <ol style="list-style-type: decimal"> - <li>For example, if a row's cells are mutated using the "incrementColumnValue" API, a client must never see the value of any cell decrease.</li> - <li>This is true regardless of which read API is used to read back the mutation.</li> - </ol> - <li> Any version of a cell that has been returned to a read operation is guaranteed to be durably stored.</li> - </ol> - </div> - <div class="section"> - <h2 id="Durability">Durability</h2> - <ol style="list-style-type: decimal"> - <li> All visible data is also durable data. That is to say, a read will never return data that has not been made durable on disk[2]</li> - <li> Any operation that returns a "success" code (eg does not throw an exception) will be made durable.[3]</li> - <li> Any operation that returns a "failure" code will not be made durable (subject to the Atomicity guarantees above)</li> - <li> All reasonable failure scenarios will not affect any of the guarantees of this document.</li> - </ol> - </div> - <div class="section"> - <h2 id="Tunability">Tunability</h2> - <p>All of the above guarantees must be possible within Apache HBase. For users who would like to trade off some guarantees for performance, HBase may offer several tuning options. For example:</p> - <ul> - <li>Visibility may be tuned on a per-read basis to allow stale reads or time travel.</li> - <li>Durability may be tuned to only flush data to disk on a periodic basis</li> - </ul> - </div> -</div> +<h2><a name="Durability"></a>Durability</h2> + +<ol style="list-style-type: decimal"> + +<li> All visible data is also durable data. That is to say, a read will never return + data that has not been made durable on disk[2]</li> + +<li> Any operation that returns a "success" code (eg does not throw an exception) + will be made durable.[3]</li> + +<li> Any operation that returns a "failure" code will not be made durable + (subject to the Atomicity guarantees above)</li> + +<li> All reasonable failure scenarios will not affect any of the guarantees of this document.</li> + + </ol> + </div> + <div class="section"> - <h2 id="More_Information">More Information</h2> - <p> For more information, see the <a href="book.html#client">client architecture</a> or <a href="book.html#datamodel">data model</a> sections in the Apache HBase Reference Guide. </p> -</div> +<h2><a name="Tunability"></a>Tunability</h2> + +<p>All of the above guarantees must be possible within Apache HBase. For users who would like to trade + off some guarantees for performance, HBase may offer several tuning options. For example:</p> + +<ul> + +<li>Visibility may be tuned on a per-read basis to allow stale reads or time travel.</li> + +<li>Durability may be tuned to only flush data to disk on a periodic basis</li> + </ul> + </div> + </div> + <div class="section"> - <h2 id="Footnotes">Footnotes</h2> - <p>[1] A consistent view is not guaranteed intra-row scanning -- i.e. fetching a portion of a row in one RPC then going back to fetch another portion of the row in a subsequent RPC. Intra-row scanning happens when you set a limit on how many values to return per Scan#next (See <a class="externalLink" href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/client/Scan.html#setBatch(int)">Scan#setBatch(int)</a>). </p> - <p>[2] In the context of Apache HBase, "durably on disk" implies an hflush() call on the transaction log. This does not actually imply an fsync() to magnetic media, but rather just that the data has been written to the OS cache on all replicas of the log. In the case of a full datacenter power loss, it is possible that the edits are not truly durable.</p> - <p>[3] Puts will either wholely succeed or wholely fail, provided that they are actually sent to the RegionServer. If the writebuffer is used, Puts will not be sent until the writebuffer is filled or it is explicitly flushed.</p> -</div> - </div> - </div> - </div> - </div> - - </div><!-- /container --> - - <!-- Footer - ================================================== --> - <footer class="well"> - <div class="container"> - <div class="row"> - <div class="span3 bottom-nav"> - <ul class="nav nav-list"> - <li class="nav-header">Apache HBase Project</li> - <li > - <a href="index.html" title="Overview">Overview</a> - </li> - <li > - <a href="license.html" title="License">License</a> - </li> - <li > - <a href="http://www.apache.org/dyn/closer.cgi/hbase/"; title="Downloads" class="externalLink">Downloads</a> - </li> - <li > - <a href="https://issues.apache.org/jira/browse/HBASE?report=com.atlassian.jira.plugin.system.project:changelog-panel#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel"; title="Release Notes" class="externalLink">Release Notes</a> - </li> - <li > - <a href="coc.html" title="Code Of Conduct">Code Of Conduct</a> - </li> - <li > - <a href="http://blogs.apache.org/hbase/"; title="Blog" class="externalLink">Blog</a> - </li> - <li > - <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a> - </li> - <li > - <a href="team-list.html" title="Team">Team</a> - </li> - <li > - <a href="https://reviews.apache.org/"; title="ReviewBoard" class="externalLink">ReviewBoard</a> - </li> - <li > - <a href="sponsors.html" title="Thanks">Thanks</a> - </li> - <li > - <a href="poweredbyhbase.html" title="Powered by HBase">Powered by HBase</a> - </li> - <li > - <a href="resources.html" title="Other resources">Other resources</a> - </li> - </ul> - </div> - <div class="span3 bottom-nav"> - <ul class="nav nav-list"> - </ul> - </div> - <div class="span3 bottom-nav"> - <ul class="nav nav-list"> - <li class="nav-header">0.94 Documentation</li> - <li > - <a href="0.94/apidocs/index.html" title="API" target="_blank">API</a> - </li> - <li > - <a href="0.94/xref/index.html" title="X-Ref" target="_blank">X-Ref</a> - </li> - <li > - <a href="0.94/book.html" title="Ref Guide (single-page)" target="_blank">Ref Guide (single-page)</a> - </li> - <li class="nav-header">ASF</li> - <li > - <a href="http://www.apache.org/foundation/"; title="Apache Software Foundation" target="_blank" class="externalLink">Apache Software Foundation</a> - </li> - <li > - <a href="http://www.apache.org/foundation/how-it-works.html"; title="How Apache Works" target="_blank" class="externalLink">How Apache Works</a> - </li> - <li > - <a href="http://www.apache.org/foundation/sponsorship.html"; title="Sponsoring Apache" target="_blank" class="externalLink">Sponsoring Apache</a> - </li> - </ul> - </div> - </div> - </div> - </footer> - - <div class="container subfooter"> - <div class="row"> - <div class="span12"> - <p class="pull-right"><a href="#">Back to top</a></p> - <p class="copyright">Copyright ©2007-2015 <a href="http://www.apache.org/";>The Apache Software Foundation</a>. All Rights Reserved.</p> - <p><a href="http://github.com/andriusvelykis/reflow-maven-skin"; title="Reflow Maven skin">Reflow Maven skin</a> by <a href="http://andrius.velykis.lt"; target="_blank" title="Andrius Velykis">Andrius Velykis</a>.</p> - </div> - </div> - </div> - - <!-- Le javascript - ================================================== --> - <!-- Placed at the end of the document so the pages load faster --> - <script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script> - - <script src="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/js/bootstrap.min.js"></script> - <script src="./js/lightbox.min.js"></script> - <script src="./js/reflow-scroll.js"></script> - - <script src="./js/reflow-skin.js"></script> - - </body> +<h2><a name="More_Information"></a>More Information</h2> + +<p> + For more information, see the <a href="book.html#client">client architecture</a> or <a href="book.html#datamodel">data model</a> sections in the Apache HBase Reference Guide. + </p> + </div> + + +<div class="section"> +<h2><a name="Footnotes"></a>Footnotes</h2> + +<p>[1] A consistent view is not guaranteed intra-row scanning -- i.e. fetching a portion of + a row in one RPC then going back to fetch another portion of the row in a subsequent RPC. + Intra-row scanning happens when you set a limit on how many values to return per Scan#next + (See <a class="externalLink" href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/client/Scan.html#setBatch(int)">Scan#setBatch(int)</a>). + </p> + + +<p>[2] In the context of Apache HBase, "durably on disk" implies an hflush() call on the transaction + log. This does not actually imply an fsync() to magnetic media, but rather just that the data has been + written to the OS cache on all replicas of the log. In the case of a full datacenter power loss, it is + possible that the edits are not truly durable.</p> + +<p>[3] Puts will either wholely succeed or wholely fail, provided that they are actually sent + to the RegionServer. If the writebuffer is used, Puts will not be sent until the writebuffer is filled + or it is explicitly flushed.</p> + + </div> + + + + </div> + </div> + + <hr/> + + <footer> + <div class="container"> + <div class="row"> + <p >Copyright © 2007–2015 + <a href="http://www.apache.org/";>The Apache Software Foundation</a>. + All rights reserved. + + <li id="publishDate" class="pull-right">Last Published: 2015-11-05</li> + </p> + </div> + + <p id="poweredBy" class="pull-right"> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> + </a> + </p> + + </div> + </footer> + </body> </html>
