Katalog-SQL-Grammatik

Katalogobjekte unterstützen die aufgelistete SQL-Grammatik für DDL-Workloads.

Oracle AI Data Platform Workbench unterstützt alle standardmäßigen Spark SQL-Datentypen. Weitere Informationen finden Sie unter Apache Spark-Dokumentation - Unterstützte Datentypen.

Tabelle 22-1 Standard- und externe Katalog-SQL-Grammatik

Vorgang Grammatik
Katalog erstellen

Katalog

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

Externer Katalog

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

OPTIONS enthält Verbindungsdetails

Externer Katalog - Oracle Autonomous AI Lakehouse - Beispiel

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')"

Antwort

Catalog <<catalog_name>> created successfully

Fehler

<<SQL Command>> failed due to <<reason>>
Katalog ändern

Katalognamen ändern

ALTER CATALOG old_catalog_name RENAME new_catalog_name;

Katalogbeschreibung ändern 

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

Katalogoptionen ändern (conn) 

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

Antwort

Catalog <<catalog_name>> updated successfully

Fehler

<<SQL Command>> failed due to <<reason>>
Katalog löschen 
DROP CATALOG [ IF EXISTS ] catalog_name

Standardmäßig werden während des DROP-Katalogs alle untergeordneten Objekte ebenfalls gelöscht

Antwort

Catalog <<catalog_name>> dropped successfully

Fehler 

<<SQL Command>> failed due to <<reason>>
Listenkataloge 
SHOW CATALOGS [ [ LIKE ] [ regex_pattern ] [ TYPE = EXTERNAL CATALOG | CATALOG ]

regex_pattern: Ein reguläres Ausdrucksmuster, das zum Filtern der Ergebnisse der Anweisung verwendet wird.

Antwort:
Katalog Typ
<<Katalogname>> Katalog | Externer Katalog
<<Katalogname>> Katalog | Externer Katalog
<<Katalogname>> Katalog | Externer Katalog

Fehler 

<<SQL Command>> failed due to <<reason>>
Katalog beschreiben 
DESC CATALOG <<catalog_name>>
DESCRIBE CATALOG <<catalog_name>>
Antwort (Standardkatalog):
Attribut Datum
Name Standardkatalogname
Typ Standardkatalog
Beschreibung Standardkatalogbeschreibung
Erstellt von Principal, der den Standardkatalog erstellt hat
Erstellt am Erstellungsdatum und -zeit
Aktualisiert von Principal, der den Standardkatalog zuletzt aktualisiert hat
Aktualisiert am Datum und Uhrzeit der letzten Aktualisierung
Antwort (externer Katalog):
Attribut Datum
Name Externer Katalogname
Typ Externer Katalog
Quelltyp Quelle des externen Katalogs (z.B. Oracle Autonomous AI Lakehouse)
Beschreibung Externe Katalogbeschreibung
Erstellt von Principal, der den externen Katalog erstellt hat
Erstellt am Erstellungsdatum und -zeit
Aktualisiert von Principal, der den externen Katalog zuletzt aktualisiert hat
Aktualisiert am Datum und Uhrzeit der letzten Aktualisierung
Verbindungsdetails .json-Datei verbinden

Fehler: 

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