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

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

用法:

use_catalog(catalog_name: str)

将当前目录设置为给定值。它还将默认数据库设置为目录的默认数据库。另请参阅use_database()。

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

• [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

参数：

catalog_name - 要设置为当前默认目录的目录名称。

抛出

CatalogException 如果无法将具有给定名称的目录设置为默认目录，则引发。