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 如果無法將具有給定名稱的目錄設置為默認目錄，則引發。