カタログ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>)

カタログ・オプションの変更(conn)

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:文の結果をフィルタ処理するために使用される正規表現パターン。

応答:

カタログ	入力してください
<<カタログ名>>	カタログ\|外部カタログ
<<カタログ名>>	カタログ\|外部カタログ
<<カタログ名>>	カタログ\|外部カタログ

エラー

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

カタログの説明

DESC CATALOG <<catalog_name>>

DESCRIBE CATALOG <<catalog_name>>

レスポンス(標準カタログ):

属性	Value
名前	標準カタログ名
入力してください	標準カタログ
説明	標準カタログ摘要
作成者	標準カタログを作成したプリンシパル
作成日	作成日時
更新者	標準カタログを最後に更新したプリンシパル
更新日	最終更新日時

レスポンス(外部カタログ):

属性	Value
名前	外部カタログ名
入力してください	外部カタログ
ソース・タイプ	外部カタログのソース(Oracle Autonomous AI Lakehouseなど)
説明	外部カタログ摘要
作成者	外部カタログを作成したプリンシパル
作成日	作成日時
更新者	外部カタログを最後に更新したプリンシパル
更新日	最終更新日時
接続の詳細	接続.jsonファイル

エラー:

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