com.aerospike.client.policy.ScanPolicy Maven / Gradle / Ivy
Show all versions of aerospike-client Show documentation
/*
* Copyright 2012-2020 Aerospike, Inc.
*
* Portions may be licensed to Aerospike, Inc. under one or more contributor
* license agreements WHICH ARE COMPATIBLE WITH THE APACHE LICENSE, VERSION 2.0.
*
* Licensed 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 com.aerospike.client.policy;
import com.aerospike.client.AerospikeException;
import com.aerospike.client.ResultCode;
/**
* Container object for optional parameters used in scan operations.
*/
public final class ScanPolicy extends Policy {
/**
* Approximate number of records to return to client. This number is divided by the
* number of nodes involved in the scan. The actual number of records returned
* may be less than maxRecords if node record counts are small and unbalanced across
* nodes.
*
* This field is supported on server versions >= 4.9.
*
* Default: 0 (do not limit record count)
*/
public long maxRecords;
/**
* Percent of data to scan. Valid integer range is 1 to 100.
*
* This field is supported on server versions < 4.9.
* Server versions >= 4.9 might allow scanPercent, but not in conjunction with
* {@link ScanPolicy#maxRecords}. scanPercent is eventually slated for removal.
*
* Default: 100
*/
public int scanPercent = 100;
/**
* Limit returned records per second (rps) rate for each server.
* Do not apply rps limit if recordsPerSecond is zero.
*
* Default: 0
*/
public int recordsPerSecond;
/**
* Maximum number of concurrent requests to server nodes at any point in time.
* If there are 16 nodes in the cluster and maxConcurrentNodes is 8, then scan requests
* will be made to 8 nodes in parallel. When a scan completes, a new scan request will
* be issued until all 16 nodes have been scanned.
*
* This field is only relevant when concurrentNodes is true.
*
* Default: 0 (issue requests to all server nodes in parallel)
*/
public int maxConcurrentNodes;
/**
* Should scan requests be issued in parallel.
*
* Default: true
*/
public boolean concurrentNodes = true;
/**
* Should bin data be retrieved. If false, only record digests (and user keys
* if stored on the server) are retrieved.
*
* Default: true
*/
public boolean includeBinData = true;
/**
* Terminate scan if cluster in migration state.
* Only used for server versions < 4.9.
*
* Default: false
*/
public boolean failOnClusterChange;
/**
* Copy scan policy from another scan policy.
*/
public ScanPolicy(ScanPolicy other) {
super(other);
this.maxRecords = other.maxRecords;
this.scanPercent = other.scanPercent;
this.recordsPerSecond = other.recordsPerSecond;
this.maxConcurrentNodes = other.maxConcurrentNodes;
this.concurrentNodes = other.concurrentNodes;
this.includeBinData = other.includeBinData;
this.failOnClusterChange = other.failOnClusterChange;
}
/**
* Copy scan policy from another policy.
*/
public ScanPolicy(Policy other) {
super(other);
}
/**
* Default constructor.
*
* Set maxRetries for scans on server versions >= 4.9. All other
* scans are not retried.
*
* The latest servers support retries on individual data partitions.
* This feature is useful when a cluster is migrating and partition(s)
* are missed or incomplete on the first scan attempt.
*
* If the first scan attempt misses 2 of 4096 partitions, then only
* those 2 partitions are retried in the next scan attempt from the
* last key digest received for each respective partition. A higher
* default maxRetries is used because it's wasteful to invalidate
* all scan results because a single partition was missed.
*/
public ScanPolicy() {
super.maxRetries = 5;
}
/**
* Verify policies fields are within range.
*/
public void validate() {
if (scanPercent <= 0 || scanPercent > 100) {
throw new AerospikeException(ResultCode.PARAMETER_ERROR, "Invalid scanPercent: " + scanPercent);
}
if (maxRecords < 0) {
throw new AerospikeException(ResultCode.PARAMETER_ERROR, "Invalid maxRecords: " + maxRecords);
}
if (scanPercent != 100 && maxRecords != 0) {
throw new AerospikeException(ResultCode.PARAMETER_ERROR, "scanPercent(" + scanPercent +
") and maxRecords(" + maxRecords + ") are mutually exclusive");
}
}
}