gora-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r912117 - in /websites/staging/gora/trunk/content: ./ current/gora-solr.html
Date Tue, 10 Jun 2014 14:42:00 GMT
Author: buildbot
Date: Tue Jun 10 14:41:59 2014
New Revision: 912117

Staging update by buildbot for gora

    websites/staging/gora/trunk/content/   (props changed)

Propchange: websites/staging/gora/trunk/content/
--- cms:source-revision (original)
+++ cms:source-revision Tue Jun 10 14:41:59 2014
@@ -1 +1 @@

Added: websites/staging/gora/trunk/content/current/gora-solr.html
--- websites/staging/gora/trunk/content/current/gora-solr.html (added)
+++ websites/staging/gora/trunk/content/current/gora-solr.html Tue Jun 10 14:41:59 2014
@@ -0,0 +1,257 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+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
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing,
+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. 
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta name="author" content="dev@gora.apache.org" />
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+  <META name="Description" content="Apache Gora -- Gora HBase Module" />
+  <META name="Keywords" content="Apache Gora NoSQL Framework" />
+  <META name="Owner" content="dev@gora.apache.org" />
+  <META name="Robots" content="index, follow" />
+  <META name="Security" content="Public" />
+  <META name="Source" content="wiki template" />
+  <META name="DC.Rights" content="Copyright 2010-2014, The Apache Software Foundation"
+  <!-- The styles -->
+  <link href="./../resources/css/bootstrap.css" rel="stylesheet">
+  <style type="text/css">
+    body {
+      padding-top: 60px;
+      padding-bottom: 40px;
+    }
+  </style>
+  <link href="./../resources/css/bootstrap-responsive.css" rel="stylesheet">
+  <link href="./../resources/css/gora.css" rel="stylesheet">
+  <style type="text/css">
+    .stpulldown-gradient
+    {
+      background: #E1E1E1;
+      background: -moz-linear-gradient(top, #E1E1E1 0%, #A7A7A7 100%); /* firefox */
+      background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#E1E1E1),
color-stop(100%,#A7A7A7)); /* webkit */
+      filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#E1E1E1', endColorstr='#A7A7A7',GradientType=0
); /* ie */
+      background: -o-linear-gradient(top, #E1E1E1 0%,#A7A7A7 100%); /* opera */
+      color: #636363;
+    }
+    #stpulldown .stpulldown-logo
+    {
+      height: 40px;
+      width: 300px;
+      margin-left: 20px;
+      margin-top: 5px;
+      background:url("http://gora.apache.org/resources/img/feather-small.png") no-repeat;
+    }
+  </style>
+  <!-- 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]-->
+  <!-- Fav and touch icons -->
+  <link rel="apple-touch-icon-precomposed" sizes="144x144" href="http://twitter.github.com/bootstrap/assets/ico/apple-touch-icon-144-precomposed.png">
+  <link rel="apple-touch-icon-precomposed" sizes="114x114" href="http://twitter.github.com/bootstrap/assets/ico/apple-touch-icon-114-precomposed.png">
+  <link rel="apple-touch-icon-precomposed" sizes="72x72" href="http://twitter.github.com/bootstrap/assets/ico/apple-touch-icon-72-precomposed.png">
+  <link rel="apple-touch-icon-precomposed" href="http://twitter.github.com/bootstrap/assets/ico/apple-touch-icon-57-precomposed.png">
+  <link rel="shortcut icon" href="./../resources/img/feather-small.png">
+  <!-- Share This -->
+  <script type="text/javascript">var switchTo5x=true;</script>
+  <script type="text/javascript" src="http://w.sharethis.com/button/buttons.js"></script>
+  <script type="text/javascript" src="http://s.sharethis.com/loader.js"></script>
+  <title>Apache Gora&trade;</title>
+  <div class="navbar navbar-inverse navbar-fixed-top">
+    <div class="navbar-inner">
+      <div class="container">
+        <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </a>
+        <a class="brand" href="./../index.html"><img src="./../resources/img/gora-logo.png"
alt="Apache Gora" title="Apache Gora" style="width: 50%; height: 50%;"/></a>
+        <div class="nav-collapse collapse">
+          <ul class="nav">
+            <li><a href="./../downloads.html">Downloads</a></li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Community
<b class="caret"></b></a>
+              <ul class="dropdown-menu pull-right">
+                <li><a href="https://whimsy.apache.org/board/minutes/Gora.html">Board
+                <li><a href="./../contribute.html">Contribute</a></li>
+                <li><a href="./../mailing_lists.html">Mailing Lists</a></li>
+                <li><a href="./../credits.html">People</a></li>
+                <li><a href="./../related.html">Related Projects</a></li>
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation
<b class="caret"></b></a>
+              <ul class="dropdown-menu pull-right">
+                <li><a href="./../about.html">About</a></li>
+                <li><a href="./../current/index.html">Current Documentation</a></li>
+                <li><a href="./../current/api/javadoc.html">JavaDoc Documentation</a></li>
+                <li><a href="./../current/tutorial.html">Gora Tutorial</a></li>
+                <li><a href="https://cwiki.apache.org/confluence/display/GORA/">Gora
+                <li><a href="http://en.wikipedia.org/wiki/Apache_Gora">Gora Wikipedia
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development
<b class="caret"></b></a>
+              <ul class="dropdown-menu pull-right">
+                <li><a href="https://issues.apache.org/jira/browse/GORA">Issue
+                <li><a href="./../mailing_lists.html">Mailing Lists</a></li>
+                <li><a href="https://builds.apache.org/view/All/job/gora-trunk/">Nightly
+                <li><a href="./../version_control.html">Version Control</a></li>
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+                <img src="./../resources/img/feather-small.png" alt="Apache" title="Apache"
+                <b class="caret"></b>
+              </a>
+              <ul class="dropdown-menu pull-right">
+                <li><a href="http://www.apache.org">Apache Home</a></li>
+                <li><a href="http://www.apache.org/licenses/">Apache License</a></li>
+                <li><a href="http://www.apache.org/security/">Security</a></li>
+                <li><a href="http://www.apache.org/foundation/sponsorship.html">Support</a></li>
+                <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+              </ul>
+            </li>
+          </ul>
+          <form id="search-form" class="navbar-search pull-right" action="http://www.google.com/cse"
+            <input value="gora.apache.org" name="sitesearch" type="hidden" />
+            <input class="search-query" name="q" id="query" type="text" />
+          </form>
+          <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script>
+        </div> <!--/.nav-collapse -->
+      </div> <!-- /container -->
+    </div> <!-- /navbar-inner -->
+  </div> <!-- /navbar -->
+  <hr>
+  <div class="container" id="Gora_Gora HBase Module">
+<h2 id="overview">Overview</h2>
+<p>This is the main documentation for the gora-hbase module. gora-hbase 
+module enables <a href="http://hbase.apache.org">Apache HBase</a> backend support
for Gora. </p>
+<h2 id="goraproperties">gora.properties</h2>
- Implementation of the storage class </li>
+<li><code>gora.datastore.autocreateschema=true</code> - Create the table
if doesn't exist</li>
+<li><code>gora.datastore.scanner.caching=1000</code> - HBase client cache
that improves the scan in HBase (default 0)</li>
+<li><code>hbase.client.autoflush.default=false</code> -  HBase autoflushing.
Enabling autoflush decreases write performance. Available since Gora 0.2. Defaults to disabled.</li>
+<h2 id="gora-hbase-mappings">Gora HBase mappings</h2>
+<p>Say we wished to map some Employee data and store it into the HBaseStore.</p>
+<div class="codehilite"><pre><span class="nt">&lt;gora-orm&gt;</span>
+  <span class="nt">&lt;table</span> <span class="na">name=</span><span
class="s">&quot;Employee&quot;</span><span class="nt">&gt;</span>
+    <span class="nt">&lt;family</span> <span class="na">name=</span><span
+            <span class="na">compression=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">blockCache=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">blockSize=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">bloomFilter=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">maxVersions=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">timeToLive=</span><span class="s">&quot;$$$&quot;</span>

+            <span class="na">inMemory=</span><span class="s">&quot;$$$&quot;</span>
<span class="nt">/&gt;</span>
+  <span class="nt">&lt;/table&gt;</span>
+  <span class="nt">&lt;class</span> <span class="na">name=</span><span
<span class="na">keyClass=</span><span class="s">&quot;java.lang.String&quot;</span>
<span class="na">table=</span><span class="s">&quot;Employee&quot;</span><span
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;name&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;nm&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;dateOfBirth&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;db&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;ssn&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;sn&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;salary&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;sl&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;boss&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;bs&quot;</span><span class="nt">/&gt;</span>
+    <span class="nt">&lt;field</span> <span class="na">name=</span><span
class="s">&quot;webpage&quot;</span> <span class="na">family=</span><span
class="s">&quot;info&quot;</span> <span class="na">qualifier=</span><span
class="s">&quot;wp&quot;</span><span class="nt">/&gt;</span>
+  <span class="nt">&lt;/class&gt;</span>
+<span class="nt">&lt;/gora-orm&gt;</span>
+<p>Here you can see that we require the definition of two child elements within the

+<code>gora-orm</code> mapping configuration, namely;</p>
+<p>The table element; where we specify: </p>
+<p>a parameter relating to the HBase table name (String) e.g. name=<b>"Employee"</b>,
+<p>a nested element containing the type and definition of families we wish to create
within HBase. In this case we create one family <b>info</b> which could have a
combination of any of the following parameters;</p>
+<p><b>name</b> (String): family name e.g. info</p>
+<p><b>compression</b> (String): the compression option to use in HBase.
Please see <a href="http://hbase.apache.org/book/compression.html">HBase documentation</a>.</p>
+<p><b>blockCache</b> (boolean):  an LRU cache that contains three levels
of block priority to allow for scan-resistance and in-memory ColumnFamilies. Please see <a
href="https://hbase.apache.org/book/regionserver.arch.html#block.cache">HBase documentation</a>.</p>
+<p><b>blockSize</b> (Integer): The blocksize can be configured for each
ColumnFamily in a table, and this defaults to 64k. Larger cell values require larger blocksizes.
There is an inverse relationship between blocksize and the resulting StoreFile indexes (i.e.,
if the blocksize is doubled then the resulting indexes should be roughly halved). Please see
<a href="http://hbase.apache.org/book/perf.schema.html#schema.cf.blocksize">HBase documentation</a>.
+<p><b>bloomFilter</b> (String): Bloom Filters can be enabled per-ColumnFamily.
We use <code>HColumnDescriptor.setBloomFilterType(NONE | ROW | ROWCOL)</code>
to enable blooms per Column Family. Default = NONE for no bloom filters. If ROW, the hash
of the row will be added to the bloom on each insert. If ROWCOL, the hash of the row + column
family name + column family qualifier will be added to the bloom on each key insert. Please
see <a href="http://hbase.apache.org/book/perf.schema.html#schema.bloom">HBase documentation</a>.</p>
+<p><b>maxVersions</b> (Integer): The maximum number of row versions to
store is configured per column family via <code>HColumnDescriptor</code>. The
default for max versions is <b>3</b>. This is an important parameter because HBase
does not overwrite row values, but rather stores different values per row by time (and qualifier).
Excess versions are removed during major compaction's. The number of max versions may need
to be increased or decreased depending on application needs. Please see <a href="http://hbase.apache.org/book/schema.versions.html">HBase
+<p><b>timeToLive</b> (Integer): ColumnFamilies can set a TTL length in
seconds, and HBase will automatically delete rows once the expiration time is reached. This
applies to all versions of a row - even the current one. The TTL time encoded in the HBase
for the row is specified in UTC. Please see <a href="https://hbase.apache.org/book/ttl.html">HBase
+<p><b>inMemory</b> (Boolean): ColumnFamilies can optionally be defined
as in-memory. Data is still persisted to disk, just like any other ColumnFamily. In-memory
blocks have the highest priority in the Block Cache, but it is not a guarantee that the entire
table will be in memory. Please see <a href="http://hbase.apache.org/book/perf.schema.html#cf.in.memory">HBase
+<p>The class element where we specify of persistent fields which values should map
to. This contains;</p>
+<p>a parameter containing the Persistent class name e.g. <b>org.apache.gora.examples.generated.Employee</b>,
+<p>a parameter containing the keyClass e.g. <b>java.lang.String</b> which
specifies the keys which map to the field values, </p>
+<p>a parameter containing the Table name e.g. <b>Employee</b> which matches
to the above Table definition,</p>
+<p>finally nested child element(s) mapping fields which are to be persisted into HBase.
These fields need to be configured such that they receive;</p>
+<p>a parameter containing the <b>name</b> e.g. (name, dateOfBirth, ssn
and salary respectively), </p>
+<p>a parameter containing the column <b>family</b> to which they belong
e.g. (all info in this case), </p>
+<p>an optional parameter <b>qualifier</b>, which enables more granular
control over the data to be persisted into HBase.</p>
+  </div> <!-- /container (main block) -->
+  <hr>
+  <div class="container">
+    <footer>
+      <p>Copyright © 2010-2014 The Apache Software Foundation. Licensed under <a
href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.
+      </p>
+      <p>Apache Gora, Gora, Apache, the Apache feather logo, and the Apache Gora project
logo are trademarks of The Apache Software Foundation.
+      </p>
+    </footer>
+  </div> <!-- /container -->
+  <!-- The javascript
+  ================================================== -->
+  <!-- Placed at the end of the document so the pages load faster -->
+  <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.1/jquery.min.js"; type="text/javascript"></script>
+  <script src="/resources/js/bootstrap.min.js"></script>
+  <script type="text/javascript">stLight.options({publisher: "4059fafd-3891-49f9-8c96-e4100290d8e6",
doNotHash: false, doNotCopy: false, hashAddressBar: false});</script>
+  <script>
+    var options={ "publisher": "4059fafd-3891-49f9-8c96-e4100290d8e6", "scrollpx": 50, "ad":
{ "visible": false}, "chicklets": { "items": ["sharethis", "facebook", "twitter", "linkedin",
"pinterest", "email", "googleplus"]}};
+    var st_pulldown_widget = new sharethis.widgets.pulldownbar(options);
+  </script>

View raw message