Python pyflink TableEnvironment.use_database用法及代码示例

本文简要介绍 python 语言中 pyflink.table.TableEnvironment.use_database 的用法。

用法:

use_database(database_name: str)

设置当前默认数据库。它必须存在于当前目录中。在查找不合格的对象名称时，该路径将用作默认路径。

这在对象路径的解析期间使用。在引用表、视图等目录对象时，目录和数据库都是可选的。算法按以下顺序在以下路径中查找请求的对象：

• [current-catalog].[current-database].[requested-path]

• [current-catalog].[requested-path]

• [requested-path]

例子：

给定结构，默认目录设置为 default_catalog ，默认数据库设置为 default_database 。

root:
  |- default_catalog
      |- default_database
          |- tab1
      |- db1
          |- tab1
  |- cat1
      |- db1
          |- tab1

下表说明了解析的路径：

请求的路径	解决路径
tab1	default_catalog.default_database.tab1
db1.tab1	default_catalog.db1.tab1
cat1.db1.tab1	cat1.db1.tab1

抛出

CatalogException 如果无法将给定的目录和数据库设置为默认目录和数据库，则引发。

参数：

database_name - 要设置为当前数据库的数据库的名称。