sjwiesman commented on a change in pull request #10078:
[FLINK-14486][table-api, docs] Update documentation regarding Temporary Objects
URL: https://github.com/apache/flink/pull/10078#discussion_r342167407
##########
File path: docs/dev/table/common.md
##########
@@ -292,25 +292,39 @@ b_b_t_env =
BatchTableEnvironment.create(environment_settings=b_b_settings)
**Note:** If there is only one planner jar in `/lib` directory, you can use
`useAnyPlanner` (`use_any_planner` for python) to create specific
`EnvironmentSettings`.
-
{% top %}
-Register Tables in the Catalog
+Create Tables in the Catalog
-------------------------------
-A `TableEnvironment` maintains a catalog of tables which are registered by
name. There are two types of tables, *input tables* and *output tables*. Input
tables can be referenced in Table API and SQL queries and provide input data.
Output tables can be used to emit the result of a Table API or SQL query to an
external system.
+A `TableEnvironment` maintains a map of catalogs of tables which are created
with an identifier. Each
+identifier consists of 3 parts: catalog name, database name and object name.
If a catalog or database was not
+specified current default value will be used (see examples in the [Table
identifier expanding](#table-identifier-expanding) section).
Review comment:
```suggestion
specified, the current default value will be used (see examples in the
[Table identifier expanding](#table-identifier-expanding) section).
```
----------------------------------------------------------------
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]
With regards,
Apache Git Services
