org.apache.cassandra.schema.CompactionParams Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of cassandra-all Show documentation
Show all versions of cassandra-all Show documentation
The Apache Cassandra Project develops a highly scalable second-generation distributed database, bringing together Dynamo's fully distributed design and Bigtable's ColumnFamily-based data model.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.cassandra.schema;
import java.lang.reflect.InvocationTargetException;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import com.google.common.base.MoreObjects;
import com.google.common.collect.ImmutableMap;
import org.apache.commons.lang3.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.apache.cassandra.config.DatabaseDescriptor;
import org.apache.cassandra.config.ParameterizedClass;
import org.apache.cassandra.db.compaction.AbstractCompactionStrategy;
import org.apache.cassandra.db.compaction.LeveledCompactionStrategy;
import org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy;
import org.apache.cassandra.db.compaction.TimeWindowCompactionStrategy;
import org.apache.cassandra.db.compaction.UnifiedCompactionStrategy;
import org.apache.cassandra.exceptions.ConfigurationException;
import org.apache.cassandra.utils.FBUtilities;
import static java.lang.String.format;
import static org.apache.cassandra.config.CassandraRelevantProperties.DEFAULT_PROVIDE_OVERLAPPING_TOMBSTONES;
public final class CompactionParams
{
private static final Logger logger = LoggerFactory.getLogger(CompactionParams.class);
public enum Option
{
CLASS,
ENABLED,
MIN_THRESHOLD,
MAX_THRESHOLD,
PROVIDE_OVERLAPPING_TOMBSTONES;
@Override
public String toString()
{
return name().toLowerCase();
}
}
public enum TombstoneOption
{
NONE,
ROW,
CELL;
private static final TombstoneOption[] copyOfValues = values();
public static Optional forName(String name)
{
return Arrays.stream(copyOfValues).filter(x -> x.name().equals(name)).findFirst();
}
}
public static final int DEFAULT_MIN_THRESHOLD = 4;
public static final int DEFAULT_MAX_THRESHOLD = 32;
public static final boolean DEFAULT_ENABLED = true;
public static final TombstoneOption DEFAULT_PROVIDE_OVERLAPPING_TOMBSTONES_PROPERTY_VALUE =
DEFAULT_PROVIDE_OVERLAPPING_TOMBSTONES.getEnum(TombstoneOption.NONE);
public static final Map DEFAULT_THRESHOLDS =
ImmutableMap.of(Option.MIN_THRESHOLD.toString(), Integer.toString(DEFAULT_MIN_THRESHOLD),
Option.MAX_THRESHOLD.toString(), Integer.toString(DEFAULT_MAX_THRESHOLD));
public static final CompactionParams DEFAULT;
static
{
ParameterizedClass defaultCompaction = DatabaseDescriptor.getDefaultCompaction();
if (defaultCompaction == null)
{
DEFAULT = new CompactionParams(SizeTieredCompactionStrategy.class,
DEFAULT_THRESHOLDS,
DEFAULT_ENABLED,
DEFAULT_PROVIDE_OVERLAPPING_TOMBSTONES_PROPERTY_VALUE);
}
else
{
DEFAULT = create(classFromName(defaultCompaction.class_name),
defaultCompaction.parameters);
}
}
private final Class klass;
private final ImmutableMap options;
private final boolean isEnabled;
private final TombstoneOption tombstoneOption;
private CompactionParams(Class klass, Map options, boolean isEnabled, TombstoneOption tombstoneOption)
{
this.klass = klass;
this.options = ImmutableMap.copyOf(options);
this.isEnabled = isEnabled;
this.tombstoneOption = tombstoneOption;
}
public static CompactionParams create(Class klass, Map options)
{
boolean isEnabled = options.containsKey(Option.ENABLED.toString())
? Boolean.parseBoolean(options.get(Option.ENABLED.toString()))
: DEFAULT_ENABLED;
String overlappingTombstoneParm = options.getOrDefault(Option.PROVIDE_OVERLAPPING_TOMBSTONES.toString(),
DEFAULT_PROVIDE_OVERLAPPING_TOMBSTONES_PROPERTY_VALUE.toString()).toUpperCase();
Optional tombstoneOptional = TombstoneOption.forName(overlappingTombstoneParm);
if (!tombstoneOptional.isPresent())
{
throw new ConfigurationException(format("Invalid value %s for 'provide_overlapping_tombstones' compaction sub-option - must be one of the following [%s].",
overlappingTombstoneParm,
StringUtils.join(TombstoneOption.values(), ", ")));
}
TombstoneOption tombstoneOption = tombstoneOptional.get();
Map allOptions = new HashMap<>(options);
if (supportsThresholdParams(klass))
{
allOptions.putIfAbsent(Option.MIN_THRESHOLD.toString(), Integer.toString(DEFAULT_MIN_THRESHOLD));
allOptions.putIfAbsent(Option.MAX_THRESHOLD.toString(), Integer.toString(DEFAULT_MAX_THRESHOLD));
}
return new CompactionParams(klass, allOptions, isEnabled, tombstoneOption);
}
public static CompactionParams stcs(Map options)
{
return create(SizeTieredCompactionStrategy.class, options);
}
public static CompactionParams lcs(Map options)
{
return create(LeveledCompactionStrategy.class, options);
}
public static CompactionParams ucs(Map options)
{
return create(UnifiedCompactionStrategy.class, options);
}
public static CompactionParams twcs(Map options)
{
return create(TimeWindowCompactionStrategy.class, options);
}
public int minCompactionThreshold()
{
String threshold = options.get(Option.MIN_THRESHOLD.toString());
return threshold == null
? DEFAULT_MIN_THRESHOLD
: Integer.parseInt(threshold);
}
public int maxCompactionThreshold()
{
String threshold = options.get(Option.MAX_THRESHOLD.toString());
return threshold == null
? DEFAULT_MAX_THRESHOLD
: Integer.parseInt(threshold);
}
public TombstoneOption tombstoneOption()
{
return tombstoneOption;
}
public void validate()
{
try
{
Map unknownOptions = (Map) klass.getMethod("validateOptions", Map.class).invoke(null, options);
if (!unknownOptions.isEmpty())
{
throw new ConfigurationException(format("Properties specified %s are not understood by %s",
unknownOptions.keySet(),
klass.getSimpleName()));
}
}
catch (NoSuchMethodException e)
{
logger.warn("Compaction strategy {} does not have a static validateOptions method. Validation ignored",
klass.getName());
}
catch (InvocationTargetException e)
{
if (e.getTargetException() instanceof ConfigurationException)
throw (ConfigurationException) e.getTargetException();
Throwable cause = e.getCause() == null
? e
: e.getCause();
throw new ConfigurationException(format("%s.validateOptions() threw an error: %s %s",
klass.getName(),
cause.getClass().getName(),
cause.getMessage()),
e);
}
catch (IllegalAccessException e)
{
throw new ConfigurationException("Cannot access method validateOptions in " + klass.getName(), e);
}
String minThreshold = options.get(Option.MIN_THRESHOLD.toString());
if (minThreshold != null && !StringUtils.isNumeric(minThreshold))
{
throw new ConfigurationException(format("Invalid value %s for '%s' compaction sub-option - must be an integer",
minThreshold,
Option.MIN_THRESHOLD));
}
String maxThreshold = options.get(Option.MAX_THRESHOLD.toString());
if (maxThreshold != null && !StringUtils.isNumeric(maxThreshold))
{
throw new ConfigurationException(format("Invalid value %s for '%s' compaction sub-option - must be an integer",
maxThreshold,
Option.MAX_THRESHOLD));
}
if (minCompactionThreshold() <= 0 || maxCompactionThreshold() <= 0)
{
throw new ConfigurationException("Disabling compaction by setting compaction thresholds to 0 has been removed,"
+ " set the compaction option 'enabled' to false instead.");
}
if (minCompactionThreshold() <= 1)
{
throw new ConfigurationException(format("Min compaction threshold cannot be less than 2 (got %d)",
minCompactionThreshold()));
}
if (minCompactionThreshold() > maxCompactionThreshold())
{
throw new ConfigurationException(format("Min compaction threshold (got %d) cannot be greater than max compaction threshold (got %d)",
minCompactionThreshold(),
maxCompactionThreshold()));
}
}
double defaultBloomFilterFbChance()
{
return klass.equals(LeveledCompactionStrategy.class) ? 0.1 : 0.01;
}
public Class klass()
{
return klass;
}
/**
* All strategy options - excluding 'class'.
*/
public Map options()
{
return options;
}
public boolean isEnabled()
{
return isEnabled;
}
public static CompactionParams fromMap(Map map)
{
Map options = new HashMap<>(map);
String className = options.remove(Option.CLASS.toString());
if (className == null)
{
throw new ConfigurationException(format("Missing sub-option '%s' for the '%s' option",
Option.CLASS,
TableParams.Option.COMPACTION));
}
return create(classFromName(className), options);
}
public static Class classFromName(String name)
{
String className = name.contains(".")
? name
: "org.apache.cassandra.db.compaction." + name;
Class strategyClass = FBUtilities.classForName(className, "compaction strategy");
if (!AbstractCompactionStrategy.class.isAssignableFrom(strategyClass))
{
throw new ConfigurationException(format("Compaction strategy class %s is not derived from AbstractReplicationStrategy",
className));
}
return strategyClass;
}
/*
* LCS doesn't, STCS and DTCS do
*/
@SuppressWarnings("unchecked")
public static boolean supportsThresholdParams(Class klass)
{
try
{
Map unrecognizedOptions =
(Map) klass.getMethod("validateOptions", Map.class)
.invoke(null, DEFAULT_THRESHOLDS);
return unrecognizedOptions.isEmpty();
}
catch (Exception e)
{
throw new RuntimeException(e);
}
}
public Map asMap()
{
Map map = new HashMap<>(options());
map.put(Option.CLASS.toString(), klass.getName());
return map;
}
@Override
public String toString()
{
return MoreObjects.toStringHelper(this)
.add("class", klass.getName())
.add("options", options)
.toString();
}
@Override
public boolean equals(Object o)
{
if (this == o)
return true;
if (!(o instanceof CompactionParams))
return false;
CompactionParams cp = (CompactionParams) o;
return klass.equals(cp.klass) && options.equals(cp.options);
}
@Override
public int hashCode()
{
return Objects.hash(klass, options);
}
}