SchemaPath (Drill : 1.20.0 API)

java.lang.Object
- org.apache.drill.common.expression.LogicalExpressionBase
- - org.apache.drill.common.expression.SchemaPath

All Implemented Interfaces:

Iterable<LogicalExpression>, LogicalExpression

Direct Known Subclasses:

FieldReference
```
public class SchemaPath
extends LogicalExpressionBase
```
This is the path for the column in the table

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class SchemaPath.De
- Nested classes/interfaces inherited from interface org.apache.drill.common.expression.LogicalExpression
  LogicalExpression.Se

Nested Classes
Modifier and Type	Class and Description
`static class`	`SchemaPath.De`

Field Summary

Fields
Modifier and Type Field and Description

static String DYNAMIC_STAR

static SchemaPath STAR_COLUMN

Fields
Modifier and Type	Field and Description
`static String`	`DYNAMIC_STAR`
`static SchemaPath`	`STAR_COLUMN`

Constructor Summary

Constructors
Constructor and Description
`SchemaPath(PathSegment.NameSegment rootSegment)`
`SchemaPath(PathSegment.NameSegment rootSegment, ExpressionPosition pos)`
`SchemaPath(SchemaPath path)`
`SchemaPath(String simpleName, ExpressionPosition pos)` Deprecated. Use `#SchemaPath(NameSegment)` or `#SchemaPath(NameSegment, ExpressionPosition)` instead

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T,V,E extends Exception> T`	`accept(ExprVisitor<T,V,E> visitor, V value)`
`boolean`	`contains(SchemaPath path)`
`static SchemaPath`	`create(UserBitShared.NamePart namePart)`
`boolean`	`equals(Object obj)`
`UserBitShared.NamePart`	`getAsNamePart()`
`String`	`getAsUnescapedPath()`
`SchemaPath`	`getChild(int index)`
`SchemaPath`	`getChild(int index, Object originalValue, TypeProtos.MajorType valueType)`
`SchemaPath`	`getChild(String childPath)`
`SchemaPath`	`getChild(String childPath, Object originalValue, TypeProtos.MajorType valueType)`
`static SchemaPath`	`getCompoundPath(int n, String... path)` Constructs `SchemaPath` based on given `path` array up to nth element (inclusively).
`static SchemaPath`	`getCompoundPath(String... path)`
`PathSegment`	`getLastSegment()`
`TypeProtos.MajorType`	`getMajorType()`
`PathSegment.NameSegment`	`getRootSegment()`
`String`	`getRootSegmentPath()` Returns path string of `rootSegment`
`static SchemaPath`	`getSimplePath(String name)`
`SchemaPath`	`getUnIndexed()` Returns schema path with for arrays without index.
`int`	`hashCode()`
`boolean`	`isArray()` Return whether this name refers to an array.
`boolean`	`isDynamicStar()` Return if this column is the special wildcard ("**") column which means to project all table columns.
`boolean`	`isLeaf()` Determine if this is a one-part name.
`boolean`	`isSimplePath()` A simple is a path where there are no repeated elements outside the lowest level of the path.
`Iterator<LogicalExpression>`	`iterator()`
`boolean`	`nameEquals(String name)` Returns if this is a simple column and the name matches the given name (ignoring case.) This does not check if the name is an entire match, only the the first (or only) part of the name matches.
`static SchemaPath`	`parseFromString(String expr)` Parses input string using the same rules which are used for the field in the query.
`String`	`rootName()` Return the root name: either the entire name (if one part) or the first part (if multi-part.) a: returns a a.b: returns a a[10]: returns a
`String`	`toExpr()`
`String`	`toString()`

Methods inherited from class org.apache.drill.common.expression.LogicalExpressionBase
getCumulativeCost, getDescription, getPosition, getSelfCost, i

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Field Detail
  - DYNAMIC_STAR
```
public static final String DYNAMIC_STAR
```
    See Also:
    
    Constant Field Values
  - STAR_COLUMN
```
public static final SchemaPath STAR_COLUMN
```
- Constructor Detail
  - SchemaPath
```
public SchemaPath(SchemaPath path)
```
  - SchemaPath
```
public SchemaPath(PathSegment.NameSegment rootSegment)
```
  - SchemaPath
```
@Deprecated
public SchemaPath(String simpleName,
                              ExpressionPosition pos)
```
    Deprecated. Use #SchemaPath(NameSegment) or #SchemaPath(NameSegment, ExpressionPosition) instead
  - SchemaPath
```
public SchemaPath(PathSegment.NameSegment rootSegment,
                  ExpressionPosition pos)
```
- Method Detail
  - getSimplePath
```
public static SchemaPath getSimplePath(String name)
```
  - getCompoundPath
```
public static SchemaPath getCompoundPath(String... path)
```
  - getCompoundPath
```
public static SchemaPath getCompoundPath(int n,
                                         String... path)
```
    Constructs SchemaPath based on given path array up to nth element (inclusively). Example: for case when n = 2 and path = {"a", "b", "c", "d", "e", ...} the method returns a.b
    
    Parameters:
    
    n - number of elements in path array to take when constructing SchemaPath
    
    path - column path used to construct schema path
    
    Returns:
    
    schema path containing n - 1 children
  - getLastSegment
```
public PathSegment getLastSegment()
```
  - getAsNamePart
```
public UserBitShared.NamePart getAsNamePart()
```
  - create
```
public static SchemaPath create(UserBitShared.NamePart namePart)
```
  - getUnIndexed
```
public SchemaPath getUnIndexed()
```
    Returns schema path with for arrays without index. Is used to find column statistics in parquet metadata. Example: a.b.c[0] -> a.b.c, a[0].b[1] -> a.b
    
    Returns:
    
    un-indexed schema path
  - parseFromString
```
public static SchemaPath parseFromString(String expr)
```
    Parses input string using the same rules which are used for the field in the query. If a string contains dot outside back-ticks, or there are no backticks in the string, will be created SchemaPath with the PathSegment.NameSegment which contains one else PathSegment.NameSegment, etc. If a string contains [] then PathSegment.ArraySegment will be created.
    
    Parameters:
    
    expr - input string to be parsed
    
    Returns:
    
    SchemaPath instance
  - isSimplePath
```
public boolean isSimplePath()
```
    A simple is a path where there are no repeated elements outside the lowest level of the path.
    
    Returns:
    
    Whether this path is a simple path.
  - isArray
```
public boolean isArray()
```
    Return whether this name refers to an array. The path must be an array if it ends with an array index; else it may or may not be an entire array.
    
    Returns:
    
    true if the path ends with an array index, false otherwise
  - isLeaf
```
public boolean isLeaf()
```
    Determine if this is a one-part name. In general, special columns work only if they are single-part names.
    
    Returns:
    
    true if this is a one-part name, false if this is a multi-part name (with either map member or array index parts.)
  - isDynamicStar
```
public boolean isDynamicStar()
```
    Return if this column is the special wildcard ("**") column which means to project all table columns.
    
    Returns:
    
    true if the column is "**"
  - nameEquals
```
public boolean nameEquals(String name)
```
    Returns if this is a simple column and the name matches the given name (ignoring case.) This does not check if the name is an entire match, only the the first (or only) part of the name matches. Also check isLeaf() to check for a single-part name.
    
    Parameters:
    
    name - name to match
    
    Returns:
    
    true if this is a single-part column with that name.
  - rootName
```
public String rootName()
```
    Return the root name: either the entire name (if one part) or the first part (if multi-part.)
    - a: returns a
    - a.b: returns a
    - a[10]: returns a
    Returns:
    
    the root (or only) name
  - accept
```
public <T,V,E extends Exception> T accept(ExprVisitor<T,V,E> visitor,
                                          V value)
                                   throws E extends Exception
```
    Throws:
    
    E extends Exception
  - getChild
```
public SchemaPath getChild(String childPath)
```
  - getChild
```
public SchemaPath getChild(String childPath,
                           Object originalValue,
                           TypeProtos.MajorType valueType)
```
  - getChild
```
public SchemaPath getChild(int index)
```
  - getChild
```
public SchemaPath getChild(int index,
                           Object originalValue,
                           TypeProtos.MajorType valueType)
```
  - getRootSegment
```
public PathSegment.NameSegment getRootSegment()
```
  - getAsUnescapedPath
```
public String getAsUnescapedPath()
```
  - getMajorType
```
public TypeProtos.MajorType getMajorType()
```
    Specified by:
    
    getMajorType in interface LogicalExpression
    
    Overrides:
    
    getMajorType in class LogicalExpressionBase
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - contains
```
public boolean contains(SchemaPath path)
```
  - iterator
```
public Iterator<LogicalExpression> iterator()
```
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toExpr
```
public String toExpr()
```
  - getRootSegmentPath
```
public String getRootSegmentPath()
```
    Returns path string of rootSegment
    
    Returns:
    
    path string of rootSegment

Class SchemaPath

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.drill.common.expression.LogicalExpression

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.apache.drill.common.expression.LogicalExpressionBase

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Field Detail

DYNAMIC_STAR

STAR_COLUMN

Constructor Detail

SchemaPath

SchemaPath

SchemaPath

SchemaPath

Method Detail

getSimplePath

getCompoundPath

getCompoundPath

getLastSegment

getAsNamePart

create

getUnIndexed

parseFromString

isSimplePath

isArray

isLeaf

isDynamicStar

nameEquals

rootName

accept

getChild

getChild

getChild

getChild

getRootSegment

getAsUnescapedPath

getMajorType

hashCode

equals

contains

iterator

toString

toExpr

getRootSegmentPath