目錄 SQL 文法

目錄物件支援列出的 DDL 工作負載 SQL 文法。

Oracle AI Data Platform Workbench 支援所有標準 Spark SQL 資料類型。如需詳細資訊，請參閱 Apache Spark 文件 - 支援的資料類型。

表格 22-1 標準與外部目錄 SQL 文法

操作 Grammar - 文法

建立目錄

CREATE CATALOG [ IF NOT EXISTS ] <<catalog_name>> [ PROPERTIES (DESCRIPTION = description ) ] OPTIONS ( { option_name = option_value } [ , ... ] )

外部型錄

CREATE EXTERNAL CATALOG [ IF NOT EXISTS ] <<catalog_name>> [PROPERTIES ( DESCRIPTION description ) ]OPTIONS ( { option_name = option_value } [ , ... ] )

OPTIONS 將會有連線詳細資訊

外部目錄 - Oracle Autonomous AI Lakehouse 範例

wt = base64 encoded wallet contents
create_sql="create external catalog if not exists
catalog_adw options
 ('wallet.content' = '{wt}', 'type' = 'ORACLE_ADW',
'user.name' = 'ADMIN',
 'tns' = 'adw23ai_high', 'password' =
 'xxxxx','wallet.password' = 'xxxxx')"

回應

Catalog <<catalog_name>> created successfully

錯誤

<<SQL Command>> failed due to <<reason>>

更改目錄

更改目錄名稱

ALTER CATALOG old_catalog_name RENAME new_catalog_name;

更改目錄描述

ALTER CATALOG <catalog-name> set properties (DESCRIPTION=<property-value>)

變更型錄選項 (連接)

ALTER CATALOG <catalog-name> set options (option_name = option_value)

回應

Catalog <<catalog_name>> updated successfully

錯誤

<<SQL Command>> failed due to <<reason>>

刪除目錄

DROP CATALOG [ IF EXISTS ] catalog_name

依照預設，在 DROP 目錄期間，將會一併刪除所有子項物件

回應

Catalog <<catalog_name>> dropped successfully

錯誤

<<SQL Command>> failed due to <<reason>>

清單目錄

SHOW CATALOGS [ [ LIKE ] [ regex_pattern ] [ TYPE = EXTERNAL CATALOG | CATALOG ]

regex_pattern：用於篩選敘述句結果的正規表示式樣式。

回應：

目錄	Type
<<catalog_name>>	目錄 \| 外部目錄
<<catalog_name>>	目錄 \| 外部目錄
<<catalog_name>>	目錄 \| 外部目錄

錯誤

<<SQL Command>> failed due to <<reason>>

描述型錄

DESC CATALOG <<catalog_name>>

DESCRIBE CATALOG <<catalog_name>>

回應 (標準目錄)：

屬性	數值
名稱	標準型錄名稱
Type	標準型錄
描述	標準型錄描述
建立者	建立標準型錄的主要項目
建立日期	建立日期與時間
更新者	上次更新標準型錄的主要項目
更新日期	上次更新的日期和時間

回應 (外部目錄)：

屬性	數值
名稱	外部目錄名稱
Type	外部型錄
來源類型	外部目錄來源 (例如 Oracle Autonomous AI Lakehouse)
描述	外部目錄描述
建立者	建立外部型錄的主要項目
建立日期	建立日期與時間
更新者	上次更新外部目錄的主要項目
更新日期	上次更新的日期和時間
連線詳細資訊	連線 .json 檔案

錯誤：

<<SQL Command>> failed due to <<reason>>