目录 SQL 语法

目录对象支持列出的 DDL 工作负载 SQL 语法。

Oracle AI Data Platform Workbench 支持所有标准 Spark SQL 数据类型。有关更多信息，请参见Apache Spark Documentation - Supported Data Types 。

表 22-1 标准和外部目录 SQL 语法

操作语法

创建目录

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 } [ , ... ] )

选项将具有连接详细信息

外部目录 - 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：用于过滤语句结果的正则表达式模式。

响应:

目录	类型
<<catalog_name>>	目录 \| 外部目录
<<catalog_name>>	目录 \| 外部目录
<<catalog_name>>	目录 \| 外部目录

错误

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

描述目录

DESC CATALOG <<catalog_name>>

DESCRIBE CATALOG <<catalog_name>>

响应（标准目录）：

属性	值
名称	标准目录名称
类型	标准目录
说明	标准目录说明
创建者	创建标准目录的主用户
创建时间	创建的日期和时间
更新者	上次更新标准目录的主用户
更新时间	上次更新的日期和时间

响应（外部目录）：

属性	值
名称	外部目录名称
类型	外部目录
源类型	外部目录的来源（例如 Oracle Autonomous AI Lakehouse）
说明	外部目录说明
创建者	创建外部目录的主用户
创建时间	创建的日期和时间
更新者	上次更新外部目录的主用户
更新时间	上次更新的日期和时间
连接详细资料	连接 .json 文件

错误：

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