[2/3] incubator-kudu git commit: Document advice about max columns and record size

[da...@apache.org]

Document advice about max columns and record size

Change-Id: I70a82d59c431f69246128acc19227af3194fa15a
Reviewed-on: http://gerrit.cloudera.org:8080/2778
Tested-by: Kudu Jenkins
Reviewed-by: Dan Burkert <da...@cloudera.com>


Project: http://git-wip-us.apache.org/repos/asf/incubator-kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-kudu/commit/e5600027
Tree: http://git-wip-us.apache.org/repos/asf/incubator-kudu/tree/e5600027
Diff: http://git-wip-us.apache.org/repos/asf/incubator-kudu/diff/e5600027

Branch: refs/heads/master
Commit: e5600027ab0100fcb8d3d95bd4c5810f0c810d4e
Parents: 5805fb7
Author: Misty Stanley-Jones <mi...@apache.org>
Authored: Wed Apr 13 08:27:02 2016 -0700
Committer: Misty Stanley-Jones <mi...@apache.org>
Committed: Tue May 31 22:42:19 2016 +0000

----------------------------------------------------------------------
 docs/schema_design.adoc | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-kudu/blob/e5600027/docs/schema_design.adoc
----------------------------------------------------------------------
diff --git a/docs/schema_design.adoc b/docs/schema_design.adoc
index e6a7f44..0ba5734 100644
--- a/docs/schema_design.adoc
+++ b/docs/schema_design.adoc
@@ -275,7 +275,20 @@ You cannot modify the partition schema after table creation.
 [[known-limitations]]
 == Known Limitations
 
-Kudu currently has some known limitations that may factor into schema design:
+Kudu currently has some known limitations that may factor into schema design. When
+designing your schema, consider these limitations together, not in isolation. If you
+test these limitations and your findings are different from these, please share your
+test cases and results.
+
+Number of Columns:: Kudu has not been thoroughly tested with more than 200 columns
+and we recommend schemas with fewer than 50 columns per table.
+
+Size of Rows:: Kudu has not been thoroughly tested with rows larger than 10 kb. Most
+testing has been on rows at 1 kb.
+
+Size of Cells:: There is no hard limit imposed by Kudu, but large values (10s of
+  kilobytes and above) are likely to perform poorly and may cause stability issues
+  in current Kudu releases.
 
 Immutable Primary Keys:: Kudu does not allow you to update the primary key of a
   row after insertion.