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

[st...@apache.org]

Author: stack
Date: Fri May 20 17:09:28 2011
New Revision: 1125470

URL: http://svn.apache.org/viewvc?rev=1125470&view=rev
Log:
HBASE-3883 book.xml / added something in schema design and FAQ about not being able to change rowkeys

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=1125470&r1=1125469&r2=1125470&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/book.xml (original)
+++ hbase/trunk/src/docbkx/book.xml Fri May 20 17:09:28 2011
@@ -217,6 +217,15 @@ throws InterruptedException, IOException
       compactions.  The number of versions may need to be increased or decreased depending on application needs.
   </para>
   </section>
+  <section xml:id="changing.rowkeys">
+  <title>
+  Immutability of Rowkeys
+  </title>
+  <para>Rowkeys cannot be changed.  The only way they can be "changed" in a table is if the row is deleted and then re-inserted.
+  This is a fairly common question on the HBase dist-list so it pays to get the rowkeys right the first time (and/or before you've 
+  inserted a lot of data).
+  </para>
+  </section>
 
   </chapter>
 
@@ -1446,6 +1455,14 @@ hbase> describe 't1'</programlisting>
                 </para>
             </answer>
         </qandaentry>
+        <qandaentry xml:id="faq.changing.rowkeys">
+            <question><para>Can I change a table's rowkeys?</para></question>
+            <answer>
+                <para>
+                    No.  See <xref linkend="changing.rowkeys" />.
+                </para>
+            </answer>
+        </qandaentry>
         <qandaentry xml:id="brand.new.compressor">
             <question><para>Why are logs flooded with '2011-01-10 12:40:48,407 INFO org.apache.hadoop.io.compress.CodecPool: Got
             brand-new compressor' messages?</para></question>