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:

BasePluginRegistryTest.StoragePluginFixture, EnumMockPlugin, 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

Modifier and Type	Field and Description
protected DrillbitContext	context

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

DEFAULT_WS_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractStoragePlugin(DrillbitContext inContext, String inName)

Method Summary

Modifier and Type	Method and Description
void	close()
DrillbitContext	getContext()
FormatPlugin	getFormatPlugin(FormatPluginConfig config) Allows to get the format plugin for current storage plugin based on appropriate format plugin config usage.
Set<? extends org.apache.calcite.plan.RelOptRule>	getLogicalOptimizerRules(OptimizerRulesContext optimizerContext) Deprecated. Marking for deprecation in next major version release. Use getOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)
String	getName()
Set<? extends org.apache.calcite.plan.RelOptRule>	getOptimizerRules(OptimizerRulesContext optimizerContext) Deprecated. Marking for deprecation in next major version release. Use getOptimizerRules(org.apache.drill.exec.ops.OptimizerRulesContext, org.apache.drill.exec.planner.PlannerPhase)
Set<? extends org.apache.calcite.plan.RelOptRule>	getOptimizerRules(OptimizerRulesContext optimizerContext, PlannerPhase phase) TODO: 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 getOptimizerRules(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.
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection, List<SchemaPath> columns, SessionOptionManager options) Get the physical scan operator for the particular GroupScan (read) node.
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection, List<SchemaPath> columns, SessionOptionManager options, MetadataProviderManager metadataProviderManager) Get the physical scan operator for the particular GroupScan (read) node.
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection, SessionOptionManager options) Get the physical scan operator for the particular GroupScan (read) node.
AbstractGroupScan	getPhysicalScan(String userName, JSONOptions selection, SessionOptionManager options, MetadataProviderManager metadataProviderManager) 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

Field Detail

context

protected final DrillbitContext context

Constructor Detail

AbstractStoragePlugin

protected AbstractStoragePlugin(DrillbitContext inContext,
                                String inName)

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 getOptimizerRules(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 getOptimizerRules(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 getOptimizerRules(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)

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

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                         JSONOptions selection,
                                         SessionOptionManager options)
                                  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.

options - (optional) session options

Returns:

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

Throws:

IOException

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                         JSONOptions selection,
                                         SessionOptionManager options,
                                         MetadataProviderManager metadataProviderManager)
                                  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.

options - (optional) session options

metadataProviderManager - manager for handling metadata providers

Returns:

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

Throws:

IOException

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:

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

Throws:

IOException

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                         JSONOptions selection,
                                         List<SchemaPath> columns,
                                         SessionOptionManager options)
                                  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.

options - (optional) session options

Returns:

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

Throws:

IOException

getPhysicalScan

public AbstractGroupScan getPhysicalScan(String userName,
                                         JSONOptions selection,
                                         List<SchemaPath> columns,
                                         SessionOptionManager options,
                                         MetadataProviderManager metadataProviderManager)
                                  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.

options - (optional) session options

metadataProviderManager - manager for handling metadata providers

Returns:

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

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:

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

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

getFormatPlugin

public FormatPlugin getFormatPlugin(FormatPluginConfig config)

Description copied from interface: StoragePlugin

Allows to get the format plugin for current storage plugin based on appropriate format plugin config usage.

Specified by:

getFormatPlugin in interface StoragePlugin

Parameters:

config - format plugin config

Returns:

format plugin instance

getName

public String getName()

Specified by:

getName in interface StoragePlugin

getContext

public DrillbitContext getContext()