ACCUMULO-3254 Expand upon consistency implications of changing table properties.
Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/fb464881 Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/fb464881 Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/fb464881 Branch: refs/heads/master Commit: fb4648810b306e6690cd251b54bfbd2c925de733 Parents: 401350f Author: Josh Elser <els...@apache.org> Authored: Wed Dec 30 21:08:45 2015 -0500 Committer: Josh Elser <els...@apache.org> Committed: Wed Dec 30 21:15:24 2015 -0500 ---------------------------------------------------------------------- .../accumulo/core/client/admin/TableOperations.java | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo/blob/fb464881/core/src/main/java/org/apache/accumulo/core/client/admin/TableOperations.java ---------------------------------------------------------------------- diff --git a/core/src/main/java/org/apache/accumulo/core/client/admin/TableOperations.java b/core/src/main/java/org/apache/accumulo/core/client/admin/TableOperations.java index f0a13f8..536d6e6 100644 --- a/core/src/main/java/org/apache/accumulo/core/client/admin/TableOperations.java +++ b/core/src/main/java/org/apache/accumulo/core/client/admin/TableOperations.java @@ -390,7 +390,9 @@ public interface TableOperations { void flush(String tableName, Text start, Text end, boolean wait) throws AccumuloException, AccumuloSecurityException, TableNotFoundException; /** - * Sets a property on a table. Note that it may take a short period of time (a second) to propagate the change everywhere. + * Sets a property on a table. This operation is asynchronous and eventually consistent. Not all tablets in a table will acknowledge this new value + * immediately nor at the same time. Within a few seconds without another change, all tablets in a table should see the updated value. The clone table feature + * can be used if consistency is required. * * @param tableName * the name of the table @@ -406,7 +408,9 @@ public interface TableOperations { void setProperty(String tableName, String property, String value) throws AccumuloException, AccumuloSecurityException; /** - * Removes a property from a table. Note that it may take a short period of time (a second) to propagate the change everywhere. + * Removes a property from a table. This operation is asynchronous and eventually consistent. Not all tablets in a table will acknowledge this altered value + * immediately nor at the same time. Within a few seconds without another change, all tablets in a table should see the altered value. The clone table feature + * can be used if consistency is required. * * @param tableName * the name of the table @@ -420,7 +424,9 @@ public interface TableOperations { void removeProperty(String tableName, String property) throws AccumuloException, AccumuloSecurityException; /** - * Gets properties of a table. Note that recently changed properties may not be available immediately. + * Gets properties of a table. This operation is asynchronous and eventually consistent. It is not guaranteed that all tablets in a table will return the same + * values. Within a few seconds without another change, all tablets in a table should be consistent. The clone table feature can be used if consistency is + * required. * * @param tableName * the name of the table
