UnresolvedTable Leaf Logical Operator

Author: jaceklaskowski

docs/logical-operators/UnresolvedTable.md

@@ -4,29 +4,24 @@ title: UnresolvedTable
 
 # UnresolvedTable Leaf Logical Operator
 
-`UnresolvedTable` is a [leaf logical operator](LeafNode.md).
+`UnresolvedTable` is an unresolved [leaf logical operator](LeafNode.md) (`UnresolvedLeafNode`) that represents a table that has yet to be looked up in a catalog.
 
 ## Creating Instance
 
 `UnresolvedTable` takes the following to be created:
 
 * <span id="multipartIdentifier"> Multi-Part Identifier
 * <span id="commandName"> Command Name
+* <span id="relationTypeMismatchHint"> Optional `relationTypeMismatchHint`
 
 `UnresolvedTable` is created when:
 
-* `AstBuilder` is requested to [visitLoadData](../sql/AstBuilder.md#visitLoadData), [visitTruncateTable](../sql/AstBuilder.md#visitTruncateTable), [visitShowPartitions](../sql/AstBuilder.md#visitShowPartitions), [visitAddTablePartition](../sql/AstBuilder.md#visitAddTablePartition), [visitDropTablePartitions](../sql/AstBuilder.md#visitDropTablePartitions), [visitCommentTable](../sql/AstBuilder.md#visitCommentTable)
-
-## <span id="resolved"> resolved
-
-```scala
-resolved: Boolean
-```
-
-`resolved` is part of the [LogicalPlan](LogicalPlan.md#resolved) abstraction.
-
-`resolved` is `false`.
+* `AstBuilder` is requested to [create an UnresolvedTable](../sql/AstBuilder.md#createUnresolvedTable)
+* `CatalogImpl` is requested to [recover partitions](../CatalogImpl.md#recoverPartitions)
 
 ## Logical Analysis
 
-`UnresolvedTable` is resolved to a [ResolvedTable](ResolvedTable.md) by `ResolveTables` logical resolution rule.
+`UnresolvedTable` is resolved by [ResolveRelations](../logical-analysis-rules/ResolveRelations.md) logical resolution rule.
+
+??? note "CheckAnalysis and AnalysisException"
+    [CheckAnalysis](../CheckAnalysis.md#checkAnalysis0) reports an `AnalysisException` (`TABLE_OR_VIEW_NOT_FOUND`) when there are any `UnresolvedTable`s left in a logical query plan after logical analysis.

docs/sql/AstBuilder.md

@@ -1132,3 +1132,40 @@ With no `namedArgumentExpression` used, `extractNamedArgument` creates an [Expre
 `extractNamedArgument` is used when:
 
 * `AstBuilder` is requested to [visitFunctionCall](#visitFunctionCall) and [visitTableValuedFunction](#visitTableValuedFunction)
+
+## Create UnresolvedTable Logical Operator { #createUnresolvedTable }
+
+```scala
+createUnresolvedTable(
+  ctx: IdentifierReferenceContext,
+  commandName: String,
+  relationTypeMismatchHint: Option[String] = None): LogicalPlan
+```
+
+`createUnresolvedTable` creates an [UnresolvedTable](../logical-operators/UnresolvedTable.md) logical operator.
+
+---
+
+`createUnresolvedTable` is used when `AstBuilder` is requested for the following:
+
+* [visitAddTableColumns](#visitAddTableColumns)
+* [visitAddTablePartition](#visitAddTablePartition)
+* [visitAlterTableAlterColumn](#visitAlterTableAlterColumn)
+* [visitCommentTable](#visitCommentTable)
+* [visitCreateIndex](#visitCreateIndex)
+* [visitDropIndex](#visitDropIndex)
+* [visitDropTableColumns](#visitDropTableColumns)
+* [visitDropTablePartitions](#visitDropTablePartitions)
+* [visitHiveChangeColumn](#visitHiveChangeColumn)
+* [visitHiveReplaceColumns](#visitHiveReplaceColumns)
+* [visitLoadData](#visitLoadData)
+* [visitRecoverPartitions](#visitRecoverPartitions)
+* [visitRenameTableColumn](#visitRenameTableColumn)
+* [visitRenameTablePartition](#visitRenameTablePartition)
+* [visitRepairTable](#visitRepairTable)
+* [visitSetTableLocation](#visitSetTableLocation)
+* [visitSetTableProperties](#visitSetTableProperties)
+* [visitSetTableSerDe](#visitSetTableSerDe)
+* [visitShowPartitions](#visitShowPartitions)
+* [visitTruncateTable](#visitTruncateTable)
+* [visitUnsetTableProperties](#visitUnsetTableProperties)