org.apache.hadoop.hbase.regionserver.ColumnTracker Maven / Gradle / Ivy
Show all versions of hbase Show documentation
/**
* Copyright 2009 The Apache Software Foundation
*
* 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.hadoop.hbase.regionserver;
import java.io.IOException;
import org.apache.hadoop.hbase.regionserver.ScanQueryMatcher.MatchCode;
/**
* Implementing classes of this interface will be used for the tracking
* and enforcement of columns and numbers of versions and timeToLive during
* the course of a Get or Scan operation.
*
* Currently there are two different types of Store/Family-level queries.
*
- {@link ExplicitColumnTracker} is used when the query specifies
* one or more column qualifiers to return in the family.
*
* This class is utilized by {@link ScanQueryMatcher} through two methods:
*
- {@link #checkColumn} is called when a Put satisfies all other
* conditions of the query. This method returns a {@link org.apache.hadoop.hbase.regionserver.ScanQueryMatcher.MatchCode} to define
* what action should be taken.
*
- {@link #update} is called at the end of every StoreFile or memstore.
*
* This class is NOT thread-safe as queries are never multi-threaded
*/
public interface ColumnTracker {
/**
* Keeps track of the number of versions for the columns asked for
* @param bytes
* @param offset
* @param length
* @param ttl The timeToLive to enforce.
* @param type The type of the KeyValue
* @param ignoreCount indicates if the KV needs to be excluded while counting
* (used during compactions. We only count KV's that are older than all the
* scanners' read points.)
* @return The match code instance.
* @throws IOException in case there is an internal consistency problem
* caused by a data corruption.
*/
public ScanQueryMatcher.MatchCode checkColumn(byte[] bytes, int offset,
int length, long ttl, byte type, boolean ignoreCount)
throws IOException;
/**
* Updates internal variables in between files
*/
public void update();
/**
* Resets the Matcher
*/
public void reset();
/**
*
* @return true when done.
*/
public boolean done();
/**
* Used by matcher and scan/get to get a hint of the next column
* to seek to after checkColumn() returns SKIP. Returns the next interesting
* column we want, or NULL there is none (wildcard scanner).
*
* Implementations aren't required to return anything useful unless the most recent
* call was to checkColumn() and the return code was SKIP. This is pretty implementation
* detail-y, but optimizations are like that.
*
* @return null, or a ColumnCount that we should seek to
*/
public ColumnCount getColumnHint();
/**
* Retrieve the MatchCode for the next row or column
*/
public MatchCode getNextRowOrNextColumn(byte[] bytes, int offset,
int qualLength);
/**
* Give the tracker a chance to declare it's done based on only the timestamp
* to allow an early out.
*
* @param timestamp
* @return true to early out based on timestamp.
*/
public boolean isDone(long timestamp);
}