表SQL文法

表オブジェクトは、DDLワークロードに対してリストされたSQL文法をサポートしています。

Oracle AI Data Platform Workbenchでは、すべての標準Spark SQLデータ型がサポートされます。詳細は、Apache Spark Documentation - Supported Data Typesを参照してください。

操作 グラマー
表の作成 
CREATE [EXTERNAL] TABLE [IF NOT EXISTS] <catalog_name>.<schema-name>.<table-name>
[ ( <column1-name><column1-type> [comment <column1-comment>], ... ) ]
USING [HIVE|DELTA, CSV, TXT, ORC, JDBC, PARQUET, etc.]
[ options ( <key1>=<val1>[, ...]) ]
[ PARTITIONED BY (<par-column-name>[, ...]) ]
[ CLUSTERED BY ( <clus-column-name>[, ...])
    [ SORTED BY ( <sort-column-name> [ asc | desc ][, ...]) ]
    INTO <num_buckets> buckets]
[ LOCATION '<path>']
[TBLPROPERTIES ( DESCRIPTION = 'some-description', '<property-name>'='<property-value>'[, ...]) ]

応答: 

<<SQL Command>> was successfully executed

エラー: 

Error: <<SQL Command>> failed due to <<reason>>
管理対象表の作成
管理対象表の作成
CREATE TABLE <catalog>.<schema>.<table-name> [ ( <column1-name><column1-type> [comment <column1-comment>], ... ) ] USING <format>;

応答: 

<<SQL Command>> was successfully executed
エラー: 
Error: <<SQL Command>> failed due to <<reason>>
データを含む管理対象表の作成 
create datatable <<catalog_name>>.<<schema_name>>.<<table_name>> [ ( <column1-name><column1-type> [comment <column1-comment>], ... ) ] tblproperties ('lakehouse_storage_format'='PARQUET') using parquet with select ( <column1-name>], ... ) from parquet.'oci://bucket@namespace/folder/'

応答: 

<<SQL Command>> was successfully executed
エラー: 
Error: <<SQL Command>> failed due to <<reason>>
共通サポートを使用した表の作成 
CREATE [EXTERNAL] TABLE [IF NOT EXISTS] <catalog_name>.<schema-name>.<table-name>
[ ( <column1-name> <column1-type> [comment <column1-comment>], ... ) ]
[TBLPROPERTIES ('delta.universalFormat.enabledFormats' = 'iceberg') ]
表の変更 
ALTER TABLE table_old_name RENAME TO table_new_name
ALTER TABLE table_name ADD COLUMNS ( col_spec [ , ... ])
ALTER TABLE table_name DROP { COLUMN | COLUMNS } [ ( ] col_name [ , ... ] [ ) ]
ALTER TABLE table_name RENAME COLUMN col_name TO col_name
ALTER TABLE table_name ADD [IF NOT EXISTS] ( partition_spec [partition_spec ... ] )
ALTER TABLE table_name DROP [ IF EXISTS ] partition_spec [PURGE]
ALTER TABLE table_name set tblproperties (description ='some-description')
表の削除 
DROP TABLE [ IF EXISTS ] table_name [ PURGE ]

レスポンス: 

<<SQL Command>> was successfully executed

エラー: 

Error: <<SQL Command>> failed due to <<reason>>
スキーマ内の表のリスト 
SHOW TABLES in catalog_name.schema_name [ LIKE <regex_pattern> ]

regex_pattern:文の結果をフィルタ処理するために使用される正規表現パターン。

応答:
<<namesake>>,tableName,isTemporary

エラー: 

<<SQL Command>> failed due to <<reason>>
表の説明 
DESCRIBE TABLE [ FORMAT ] catalog_name.schema_name.table_name [ PARTITION (<partition_col_name> = <partition_col_val>, ...) ] [ catalog_name.schema_name.table_name.column_name ]

フォーマット:フォーマットとしてEXTENDEDが指定されている場合は、追加のメタデータ情報(親データベース、所有者、アクセス時間など)が返されます。

DESCRIBE TABLE catalog.schema.tableレスポンス:

col_name,data_type,comment
DESCRIBE TABLE catalog.schema.table columnレスポンス:
info_name,info_value