使用限制

• 僅實時計算引擎VVR 6.0.2及以上版本支持配置AnalyticDB for MySQL Catalog。

• 不支持修改Catalog。

• 僅支持查詢數據表，不支持創建、修改和刪除數據庫和表。

• 僅支持作為維表和結果表，不支持作為源表。

創建AnalyticDB for MySQL Catalog

1. 在查詢腳本文本編輯區域，輸入配置AnalyticDB for MySQL Catalog的命令。

   CREATE CATALOG <catalogName> WITH (
     'type' = 'adb3.0',
     'hostName' = '<hostname>',
     'port' = '<port>',
     'userName' = '<username>',
     'password' = '<password>',
     'defaultDatabase' = '<dbname>'
   );

   參數	類型	說明	是否必填
   catalogName	String	AnalyticDB for MySQL Catalog名稱。	是
   type	String	Catalog類型，固定值為adb3.0。	是
   hostName	String	AnalyticDB for MySQL數據庫的IP地址或者Hostname。	是
   port	Integer	AnalyticDB for MySQL數據庫服務的端口號，默認值為3306。	否
   userName	String	AnalyticDB for MySQL數據庫服務的用戶名。	是
   password	String	AnalyticDB for MySQL數據庫服務的密碼。	是
   defaultDatabase	String	默認的AnalyticDB for MySQL數據庫名稱。	是

2. 選中創建Catalog的代碼后，單擊左側代碼行數上的運行。

   

查看AnalyticDB for MySQL Catalog

AnalyticDB for MySQL Catalog配置成功后，您可以通過以下步驟查看AnalyticDB for MySQL元數據。

1. 進入元數據管理頁面。

   1. 登錄實時計算控制臺。

   2. 單擊目標工作空間操作列下的控制臺。

   3. 單擊元數據管理。

2. 在Catalog列表頁面，查看Catalog名稱和類型。

   說明

   如果您需要查看目標Catalog下的數據庫和表，請單擊查看。

使用AnalyticDB for MySQL Catalog

• AnalyticDB for MySQL Catalog提供的表作為維表使用

  INSERT INTO ${other_sink_table}
  SELECT ...
  FROM ${other_source_table} AS e
  JOIN `${adb_mysql_catalog}`.`${db_name}`.`${table_name}` FOR SYSTEM_TIME AS OF e.proctime AS w
  ON e.id = w.id;

• AnalyticDB for MySQL Catalog提供的表作為結果表使用

  INSERT INTO `${adb_mysql_catalog}`.`${db_name}`.`${table_name}`
  SELECT ...
  FROM ${other_source_table}

  如果AnalyticDB for MySQL Catalog的表使用時需要指定其他WITH參數，則建議使用SQL Hints方式來添加其他參數。其他參數的詳情請參見WITH參數。以AnalyticDB for MySQL 3.0結果表中添加replaceMode參數為例，代碼示例如下。

  INSERT INTO `${adb_mysql_catalog}`.`${db_name}`.`${table_name}` /*+ OPTIONS('replaceMode'='true') */
  SELECT ...
  FROM ${other_source_table}

刪除AnalyticDB for MySQL Catalog

支持UI與SQL命令兩種方式刪除AnalyticDB for MySQL Catalog，推薦通過UI方式刪除AnalyticDB for MySQL Catalog。

UI方式

1. 進入元數據管理頁面。

   1. 登錄實時計算控制臺。

   2. 單擊目標工作空間操作列下的控制臺。

   3. 單擊元數據管理。

2. 在Catalog列表頁面，單擊目標Catalog名稱對應操作列下的刪除。

3. 在彈出的提示頁面中，單擊刪除。

4. 在左側元數據區域下，查看目標Catalog是否已被刪除。

SQL命令方式

1. 在查詢腳本文本編輯區域，輸入以下命令。

   DROP CATALOG <catalogName>;

   其中，catalogName為您要刪除的目標AnalyticDB for MySQL Catalog名稱。

2. 選中刪除Catalog的命令，鼠標右鍵選擇運行。

3. 在左側元數據區域，查看目標Catalog是否已刪除。