com.aerospike.client.policy.ScanPolicy Maven / Gradle / Ivy
/*
* Copyright 2012-2019 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;
/**
* Container object for optional parameters used in scan operations.
*/
public final class ScanPolicy extends Policy {
/**
* Percent of data to scan. Valid integer range is 1 to 100.
*
* 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.
*
* Default: false
*/
public boolean failOnClusterChange;
/**
* Copy scan policy from another scan policy.
*/
public ScanPolicy(ScanPolicy other) {
super(other);
this.scanPercent = other.scanPercent;
this.recordsPerSecond = other.recordsPerSecond;
this.maxConcurrentNodes = other.maxConcurrentNodes;
this.concurrentNodes = other.concurrentNodes;
this.includeBinData = other.includeBinData;
this.failOnClusterChange = other.failOnClusterChange;
}
/**
* Default constructor.
*/
public ScanPolicy() {
// Scans should not retry.
super.maxRetries = 0;
}
}