org.apache.drill.exec.store

Class AbstractStoragePlugin

java.lang.Object

org.apache.drill.exec.store.AbstractStoragePlugin

All Implemented Interfaces:

AutoCloseable, SchemaFactory, StoragePlugin

Direct Known Subclasses:

FileSystemPlugin, InfoSchemaStoragePlugin, MockStorageEngine, SystemTablePlugin

public abstract class AbstractStoragePlugin
extends Object
implements StoragePlugin

Abstract class for StorePlugin implementations. See StoragePlugin for description of the interface intent and its methods.

Field Summary

Fields inherited from interface org.apache.drill.exec.store.SchemaFactory

logger

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractStoragePlugin()

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
Set<? extends org.apache.calcite.plan.RelOptRule>	getLogicalOptimizerRules(OptimizerRulesContext optimizerContext) Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)
Set<? extends org.apache.calcite.plan.RelOptRule>	getOptimizerRules(OptimizerRulesContext optimizerContext) Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)
Set<? extends org.apache.calcite.plan.RelOptRule>	getOptimizerRules(OptimizerRulesContext optimizerContext, PlannerPhase phase) Note: Move this method to StoragePlugin interface in next major version release.
Set<? extends org.apache.calcite.plan.RelOptRule>	getPhysicalOptimizerRules(OptimizerRulesContext optimizerRulesContext) Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection) Get the physical scan operator for the particular GroupScan (read) node.
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection, List<SchemaPath> columns) Get the physical scan operator for the particular GroupScan (read) node.
void	start() Initialize the storage plugin.
boolean	supportsRead() Indicates if Drill can read the table from this format.
boolean	supportsWrite() Indicates if Drill can write a table to this format (e.g.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.drill.exec.store.StoragePlugin

getConfig

Methods inherited from interface org.apache.drill.exec.store.SchemaFactory

registerSchemas

Constructor Detail

AbstractStoragePlugin

protected AbstractStoragePlugin()

Method Detail

supportsRead

public boolean supportsRead()

Description copied from interface: StoragePlugin

Indicates if Drill can read the table from this format.

Specified by:

supportsRead in interface StoragePlugin

supportsWrite

public boolean supportsWrite()

Description copied from interface: StoragePlugin

Indicates if Drill can write a table to this format (e.g. as JSON, csv, etc.).

Specified by:

supportsWrite in interface StoragePlugin

getOptimizerRules

@Deprecated
public Set<? extends org.apache.calcite.plan.RelOptRule> getOptimizerRules(OptimizerRulesContext optimizerContext)

Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)

Description copied from interface: StoragePlugin

An implementation of this method will return one or more specialized rules that Drill query optimizer can leverage in physical space. Otherwise, it should return an empty set.

Specified by:

getOptimizerRules in interface StoragePlugin

Returns:

an empty set or a set of plugin specific physical optimizer rules.

getLogicalOptimizerRules

@Deprecated
public Set<? extends org.apache.calcite.plan.RelOptRule> getLogicalOptimizerRules(OptimizerRulesContext optimizerContext)

Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)

getPhysicalOptimizerRules

@Deprecated
public Set<? extends org.apache.calcite.plan.RelOptRule> getPhysicalOptimizerRules(OptimizerRulesContext optimizerRulesContext)

Deprecated. Marking for deprecation in next major version release. Use #getPhysicalOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)

getOptimizerRules

public Set<? extends org.apache.calcite.plan.RelOptRule> getOptimizerRules(OptimizerRulesContext optimizerContext,
                                                                  PlannerPhase phase)

Note: Move this method to StoragePlugin interface in next major version release.

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                JSONOptions selection)
                                  throws IOException

Description copied from interface: StoragePlugin

Get the physical scan operator for the particular GroupScan (read) node.

Specified by:

getPhysicalScan in interface StoragePlugin

Parameters:

userName - User whom to impersonate when when reading the contents as part of Scan.

selection - The configured storage engine specific selection.

Returns:

Throws:

IOException

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                JSONOptions selection,
                                List<SchemaPath> columns)
                                  throws IOException

Description copied from interface: StoragePlugin

Get the physical scan operator for the particular GroupScan (read) node.

Specified by:

getPhysicalScan in interface StoragePlugin

Parameters:

userName - User whom to impersonate when when reading the contents as part of Scan.

selection - The configured storage engine specific selection.

columns - (optional) The list of column names to scan from the data source.

Returns:

Throws:

IOException

start

public void start()
           throws IOException

Description copied from interface: StoragePlugin

Initialize the storage plugin. The storage plugin will not be used until this method is called.

Specified by:

start in interface StoragePlugin

Throws:

IOException

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception