svn commit: r1126607 - /hbase/trunk/src/docbkx/book.xml

[st...@apache.org]

Author: stack
Date: Mon May 23 17:23:40 2011
New Revision: 1126607

URL: http://svn.apache.org/viewvc?rev=1126607&view=rev
Log:
HBASE-3911 book.xml - schema design, added comment about supported datatypes

Modified:
    hbase/trunk/src/docbkx/book.xml

Modified: hbase/trunk/src/docbkx/book.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/book.xml?rev=1126607&r1=1126606&r2=1126607&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/book.xml (original)
+++ hbase/trunk/src/docbkx/book.xml Mon May 23 17:23:40 2011
@@ -226,6 +226,19 @@ throws InterruptedException, IOException
   inserted a lot of data).
   </para>
   </section>
+  <section xml:id="supported.datatypes">
+  <title>
+  Supported Datatypes
+  </title>
+  <para>HBase supports a "bytes-in/bytes-out" interface via <link xlink:href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/client/Put.html">Put</link> and
+  <link xlink:href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/client/Result.html">Result</link>, so anything that can be
+  converted to an array of bytes can be stored as a value.  Input could be strings, numbers, complex objects, or even images as long as they can rendered as bytes.  
+  </para>
+  <para>There are practical limits to the size of values (e.g., storing 10-50MB objects in HBase would probably be too much to ask);
+  search the mailling list for conversations on this topic. All rows in HBase conform to the <xref linkend="datamodel">datamodel</xref>, and 
+  that includes versioning.  Take that into consideration when making your design, as well as block size for the ColumnFamily.  
+  </para>
+  </section>
 
   </chapter>
 
@@ -1551,6 +1564,16 @@ When I build, why do I always get <code>
                 </para>
             </answer>
         </qandaentry>
+        <qandaentry>
+            <question><para>
+                    Store (fill in the blank) in HBase?
+            </para></question>
+            <answer>
+                <para>
+                See <xref linkend="supported.datatypes" />.
+                </para>
+            </answer>
+        </qandaentry>
     </qandadiv>
     </qandaset>
   </appendix>