MaxGekk commented on a change in pull request #31524:
URL: https://github.com/apache/spark/pull/31524#discussion_r572069471



##########
File path: docs/sql-ref-syntax-ddl-alter-table.md
##########
@@ -27,6 +27,9 @@ license: |
 
 `ALTER TABLE RENAME TO` statement changes the table name of an existing table 
in the database.
 
+If the table is cached, the commands clear cached data of the table and all 
its dependents that refer to it. The cache will be lazily filled when the next 
time the table or the dependents are accessed.
+The partition rename command keeps table dependents as cached but the table 
rename does not. In this way dependents should be re-cached explicitly after 
table renaming.

Review comment:
       We cannot just replace the code above by `CatalogImpl.refreshTable()` or 
by `recacheByPlan` because the plan after renaming is different. I guess it 
includes `CatalogTable` which has different `identifier` after renaming.




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to