You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by va...@apache.org on 2017/03/08 01:59:09 UTC
[1/3] documentation commit: updated refs/heads/master to a05f028
Repository: couchdb-documentation
Updated Branches:
refs/heads/master fbbc40f3c -> a05f0289a
Fix Shard documentation: typos, minor clarification on ASCII codes
Project: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/commit/6edb6ea1
Tree: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/tree/6edb6ea1
Diff: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/diff/6edb6ea1
Branch: refs/heads/master
Commit: 6edb6ea19788ae929553c2220ca591af2c8fa2ce
Parents: fbbc40f
Author: Rob Porter <ro...@weeverapps.com>
Authored: Wed Feb 22 13:28:08 2017 -0500
Committer: Nick Vatamaniuc <va...@apache.org>
Committed: Tue Mar 7 20:44:02 2017 -0500
----------------------------------------------------------------------
src/cluster/sharding.rst | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/couchdb-documentation/blob/6edb6ea1/src/cluster/sharding.rst
----------------------------------------------------------------------
diff --git a/src/cluster/sharding.rst b/src/cluster/sharding.rst
index 568eb7e..7747617 100644
--- a/src/cluster/sharding.rst
+++ b/src/cluster/sharding.rst
@@ -106,10 +106,10 @@ small there. Let us look in it. Yes, you can get it with curl too:
* ``_id`` The name of the database.
* ``_rev`` The current revision of the metadata.
* ``shard_suffix`` The numbers after small and before .couch. The number of
- seconds after UNIX epoch that the database was created. Stored in ASCII.
+ seconds after UNIX epoch that the database was created. This is stored as an array of ASCII codes.
* ``changelog`` Self explaining. Only for admins to read.
* ``by_node`` Which shards each node have.
-* ``by_rage`` On which nodes each shard is.
+* ``by_range`` On which nodes each shard is.
Nothing here, nothing there, a shard in my sleeve
-------------------------------------------------
@@ -208,7 +208,7 @@ illusion of moving. If you try to uphold this illusion with a database that have
#. Delete the shard on the old node.
#. Lose all writes made between 1 and 2.
-As the realty "I added a new replica of the shard X on node Y and then I waited
+As the reality "I added a new replica of the shard X on node Y and then I waited
for them to sync, before I removed the replica of shard X from node Z." is a bit
tedious, people and this documentation tend to use the illusion of moving.
@@ -291,7 +291,7 @@ you need to create a new cluster and migrate over.
Creating more shards than you need and then move the shards around is called
presharding. The number of shards you need depends on how much data you are
-going to store. But creating to many shards increases the complexity without any
+going to store. But, creating to many shards increases the complexity without any
real gain. You might even get lower performance. As an example of this, we can
take the author's (15 year) old lab server. It gets noticeably slower with more
than one shard and high load, as the hard drive must seek more.
[3/3] documentation commit: updated refs/heads/master to a05f028
Posted by va...@apache.org.
Merge branch 'pr/102'
Close #102
Project: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/commit/a05f0289
Tree: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/tree/a05f0289
Diff: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/diff/a05f0289
Branch: refs/heads/master
Commit: a05f0289a8ab2aaa7a84338fbcf43ce9e6f36dfb
Parents: fbbc40f b9a6329
Author: Nick Vatamaniuc <va...@apache.org>
Authored: Tue Mar 7 20:57:31 2017 -0500
Committer: Nick Vatamaniuc <va...@apache.org>
Committed: Tue Mar 7 20:57:31 2017 -0500
----------------------------------------------------------------------
src/cluster/sharding.rst | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
[2/3] documentation commit: updated refs/heads/master to a05f028
Posted by va...@apache.org.
Fix wording & make ines < 80 chars long
Project: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/commit/b9a63295
Tree: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/tree/b9a63295
Diff: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/diff/b9a63295
Branch: refs/heads/master
Commit: b9a632951f8cc072e7ae4ed88dde85ddbdf7059d
Parents: 6edb6ea
Author: Nick Vatamaniuc <va...@apache.org>
Authored: Tue Mar 7 20:57:11 2017 -0500
Committer: Nick Vatamaniuc <va...@apache.org>
Committed: Tue Mar 7 20:57:11 2017 -0500
----------------------------------------------------------------------
src/cluster/sharding.rst | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/couchdb-documentation/blob/b9a63295/src/cluster/sharding.rst
----------------------------------------------------------------------
diff --git a/src/cluster/sharding.rst b/src/cluster/sharding.rst
index 7747617..57e0d2f 100644
--- a/src/cluster/sharding.rst
+++ b/src/cluster/sharding.rst
@@ -105,10 +105,10 @@ small there. Let us look in it. Yes, you can get it with curl too:
* ``_id`` The name of the database.
* ``_rev`` The current revision of the metadata.
-* ``shard_suffix`` The numbers after small and before .couch. The number of
- seconds after UNIX epoch that the database was created. This is stored as an array of ASCII codes.
-* ``changelog`` Self explaining. Only for admins to read.
-* ``by_node`` Which shards each node have.
+* ``shard_suffix`` The numbers after small and before .couch. This is seconds
+ after UNIX epoch when the database was created. Stored as ASCII characters.
+* ``changelog`` Self explaining. Mostly used for debugging.
+* ``by_node`` List of shards on each node.
* ``by_range`` On which nodes each shard is.
Nothing here, nothing there, a shard in my sleeve
@@ -291,10 +291,10 @@ you need to create a new cluster and migrate over.
Creating more shards than you need and then move the shards around is called
presharding. The number of shards you need depends on how much data you are
-going to store. But, creating to many shards increases the complexity without any
-real gain. You might even get lower performance. As an example of this, we can
-take the author's (15 year) old lab server. It gets noticeably slower with more
-than one shard and high load, as the hard drive must seek more.
+going to store. But, creating to many shards increases the complexity without
+any real gain. You might even get lower performance. As an example of this, we
+can take the author's (15 year) old lab server. It gets noticeably slower with
+more than one shard and high load, as the hard drive must seek more.
How many shards you should have depends, as always, on your use case and your
hardware. If you do not know what to do, use the default of 8 shards.