Oracle Cloud Infrastructure-Dokumentation

Zusammenfassung von DBMS_CATALOG

In diesem Abschnitt werden die DBMS_CATALOG-Unterprogramme behandelt, die mit Oracle Autonomous AI Database bereitgestellt werden.

Die Unterprogramme werden in die folgenden Funktionsbereiche eingeteilt.

Laden und Entladen von Katalogen

Unterprogramm Beschreibung

Prozedur MOUNT_DATA_CATALOG

Bei diesem Verfahren wird ein Datenkatalog wie AWS GLUE oder OCI Data Catalog gemountet.

Prozedur MOUNT_DB_LINK

Bei dieser Prozedur wird ein Katalog basierend auf einem Datenbanklink gemountet.

MOUNT_ICEBERG-Prozedur

Bei diesem Verfahren wird ein Apache Iceberg-Katalog mit bestimmten Konfigurationen gemountet.

Prozedur MOUNT_SHARE

Bei diesem Verfahren wird ein einzelner Katalog basierend auf einem Share gemountet.

Prozedur MOUNT_SHARES

Bei diesem Verfahren werden mehrere Kataloge von einem Share-Provider gemountet, wobei Überlastungen verschiedene Eingabetypen unterstützen.

Prozedur MOUNT_VIRTUAL_CATALOG

Bei diesem Verfahren wird ein neuer virtueller Katalog erstellt und gemountet.

UNMOUNT-Verfahren

Bei diesem Verfahren wird ein vorhandener externer Katalog aufgehoben.

Katalogeigenschaftenverwaltung

Unterprogramm Beschreibung

Prozedur GET_CATALOG_PROPERTY

Prozedur GET_CATALOG_PROPERTY_CLOB

Diese Verfahren rufen Eigenschaftswerte für einen Katalog ab.

Prozedur UPDATE_CATALOG_PROPERTY

Prozedur UPDATE_CATALOG_PROPERTY_CLOB

Mit diesen Verfahren werden Eigenschaftswerte für einen Katalog aktualisiert.

GET_COLUMN_PROPERTY (Funktion)

Funktion GET_COLUMN_PROPERTY_CLOB

Diese Funktionen rufen Eigenschaftswerte für eine bestimmte Spalte im VARCHAR2- oder CLOB-Format ab.

Prozedur UPDATE_COLUMN_PROPERTY

Prozedur UPDATE_COLUMN_PROPERTY_CLOB

Diese Verfahren aktualisieren Eigenschaftswerte für eine bestimmte Spalte mit Optionen zum Übertragen von Aktualisierungen an die Quelle.

Prozedur GET_SCHEMA_PROPERTY

Prozedur GET_SCHEMA_PROPERTY_CLOB

Diese Prozeduren rufen Schemaeigenschaftswerte ab.

Prozedur UPDATE_SCHEMA_PROPERTY

Prozedur UPDATE_SCHEMA_PROPERTY_CLOB

Diese Prozeduren aktualisieren Schemaeigenschaftswerte.

Prozedur GET_TABLE_PROPERTY

Prozedur GET_TABLE_PROPERTY_CLOB

Diese Verfahren rufen Tabelleneigenschaftswerte ab.

Prozedur UPDATE_TABLE_PROPERTY

Prozedur UPDATE_TABLE_PROPERTY_CLOB

Mit diesen Verfahren werden Tabelleneigenschaftswerte aktualisiert.

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Diese Funktionen rufen Eigenschaftswerte für einen Cloud-Speicherlink im VARCHAR2- oder CLOB-Format ab.

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

In diesen Verfahren werden die Eigenschaftswerte für einen Cloud-Speicherlink aktualisiert.

Zugangsdatenverwaltung

Unterprogramm Beschreibung

Prozedur ADD_REQUIRED_CREDENTIAL

Diese Prozedur definiert die erforderlichen Zugangsdaten für einen Katalog.

Prozedur REMOVE_REQUIRED_CREDENTIAL

Mit dieser Prozedur werden erforderliche Zugangsdaten aus einem Katalog entfernt.

Prozedur RENAME_REQUIRED_CREDENTIAL

Bei dieser Prozedur werden erforderliche Zugangsdaten umbenannt.

Prozedur GET_REQUIRED_CREDENTIAL_PROPERTY

Diese Prozedur ruft eine Eigenschaft mit erforderlichen Zugangsdaten ab.

Prozedur UPDATE_REQUIRED_CREDENTIAL_PROPERTY

Mit dieser Prozedur wird eine Eigenschaft mit erforderlichen Zugangsdaten aktualisiert.

Prozedur GET_LOCAL_CREDENTIAL_MAP (überladen)

 In diesem Verfahren werden Zuordnungen zwischen erforderlichen Zugangsdaten und lokalen Zugangsdaten mit Überlastungen für verschiedene Ausgabeformate abgerufen.

Prozedur SET_LOCAL_CREDENTIAL

Diese Prozedur gibt lokale Zugangsdaten für die erforderlichen Zugangsdaten an.

Katalogentitätsverwaltung

Unterprogramm Beschreibung

Prozedur CREATE_CLOUD_STORAGE_LINK

DROP_CLOUD_STORAGE_LINK - Prozedur

Diese Verfahren verwalten Cloud-Speicherlinks in einem Katalog.

Funktion GET_CLOUD_STORAGE_LINKS

Diese Funktion ruft Metadaten für Cloud-Speicherlinks in einem Katalog mit optionalen Filtern ab.

Prozedur CREATE_EXTERNAL_TABLE

Mit dieser Prozedur wird eine externe Tabelle in einem Katalog erstellt.

Prozedur CREATE_SCHEMA

Mit dieser Prozedur wird ein neues Schema in einem Katalog erstellt. Außerdem wird das Apache Iceberg-Schema in Remotekatalogen erstellt.

GET_OBJECTS-Prozedur

Prozedur GET_SCHEMAS

Prozedur GET_TABLES

Diese Prozedur ruft Metadaten für Tabellen, Schemas und Objekte in einem Katalog mithilfe von Pipelined-Funktionen ab.

DROP_SCHEMA-Verfahren

DROP_TABLE - Prozedur

In diesem Verfahren werden Schemas und Tabellen aus einem Katalog gelöscht.

GET_COLUMNS-Funktion

Diese Funktion ruft Metadaten für Spalten in Tabellen oder Views in einem Katalog ab.

Prozedur GET_TABLE

GET_TABLE (Funktion)

Diese Prozedur und Funktion ruft detaillierte Informationen zu einer bestimmten Tabelle im Datensatz- oder JSON-Format ab.

Datenzugriff und Caching

Unterprogramm Beschreibung

Prozedur GENERATE_TABLE_SELECT (überladen)

Diese Prozedur erstellt eine SELECT-Anweisung für eine logische Tabelle mit Überlastungen für Prozedur und Funktion.

OPEN_TABLE_CURSOR - Prozedur

Diese Prozedur öffnet einen Cursor, um Daten aus einer logischen Tabelle zurückzugeben.

Prozedur FLUSH_CATALOG_CACHE

Prozedur PREFILL_CATALOG_CACHE

Diese Prozeduren verwalten das Caching von Katalogmetadaten.

Synchronisierung und Freigabe

Unterprogramm Beschreibung

Prozedur CREATE_SYNCHRONIZED_SCHEMAS

DROP_SYNCHRONIZED_SCHEMAS-Verfahren

Diese Prozeduren verwalten synchronisierte Schemas mit Remotekatalogdefinitionen.

Prozedur UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY

In diesem Verfahren werden die Eigenschaften synchronisierter Schemas aktualisiert.

Prozedur SYNCHRONIZE_SHARED_CATALOGS

Dieses Verfahren verwaltet die Kataloge, die nicht verfügbaren Shares entsprechen, mit Optionen zum Aushängen oder Deaktivieren.

Prozedur CREATE_SYNCHRONIZED_VIEWS

In diesem Verfahren werden Ansichten für Katalogtabellen erstellt, um Einschränkungen anzuwenden.

COPY_TABLE_PROPERTIES - Prozedur

Diese Prozedur kopiert Eigenschaften von einer Tabelle in eine andere, einschließlich optionaler Spalteneigenschaften.

Prozedur GRANT_TO_RECIPIENT

REVOKE_FROM_RECIPIENT - Prozedur

In diesen Verfahren werden Zugriffsberechtigungen für Katalogempfänger verwaltet.

Ereignisprotokollierung

Unterprogramm Beschreibung

Prozedur CLEAR_CATALOG_EVENTS

Diese Prozedur löscht die Ereignisse aus dem Katalogereignislog innerhalb eines Zeitraums.

Iceberg-spezifisches Management

Unterprogramm Beschreibung

Prozedur CREATE_ICEBERG_TABLE

Mit dieser Prozedur wird eine neue Iceberg-Tabelle in einem angegebenen Schema in einem Katalog erstellt.

ADD_ICEBERG_SNAPSHOT-Prozedur

Diese Prozedur fügt einer Iceberg-Tabelle einen Snapshot hinzu, um Datenänderungen mit detaillierten Metadaten darzustellen.

Übergeordnetes Thema: Kataloge mit DBMS_CATALOG verwalten

Prozedur MOUNT_DATA_CATALOG

Bei diesem Verfahren wird ein Datenkatalog gemountet (z.B. AWS GLUE oder OCI Data Catalog).

Syntax

PROCEDURE mount_data_catalog
(
  catalog_name 				IN VARCHAR2,
  data_catalog_type 		IN VARCHAR2,
  data_catalog_region 		IN VARCHAR2,
  data_catalog_credential 	IN VARCHAR2,
  data_catalog_id 			IN VARCHAR2 := NULL,
  data_storage_credential 	IN VARCHAR2 := NULL,
  enabled 					IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des neuen Katalogs. Dieser wird in Großbuchstaben konvertiert.

data_catalog_type

Typ des Datenkatalogs (z.B. OCI_DCAT oder AWS_GLUE).

data_catalog_region

Die Cloud-Ressourcenregion des Datenkatalogs.

data_catalog_credential

Die lokalen Zugangsdaten für den Zugriff auf den Datenkatalog.

data_catalog_id

Name oder ID des Datenkatalogs. Standardwert ist NULL.

data_storage_credential

Gibt die lokalen Zugangsdaten für den Datenzugriff an. Standardwert ist NULL. Dies ist ein fakultatives Feld.

enabled

Gibt an, ob der Katalog für die Suche aktiviert ist. Der Standardwert ist TRUE.

Beispiel

/****************** Glue Catalog ******************/
BEGIN
  -- Create a credential capable of accessing a glue catalog
  dbms_cloud.create_credential('GLUE_CATALOG_CREDENTIAL', ...); 

  -- Mount a glue catalog
  dbms_catalog.mount_data_catalog(
    catalog_name             => 'GLUE_CAT',
    data_catalog_type        => 'AWS_GLUE',
    data_catalog_region      => 'us-east-1', 
    data_catalog_credential  => 'GLUE_CATALOG_CREDENTIAL');
END;
/

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur MOUNT_DB_LINK

Bei dieser Prozedur wird ein externer Katalog basierend auf einem Datenbanklink gemountet.

Syntax

PROCEDURE mount_db_link
(
  catalog_name 	IN VARCHAR2,
  db_link 		IN VARCHAR2,
  enabled 		IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des neuen Katalogs. Dieser wird in Großbuchstaben konvertiert.

db_link

Der Datenbanklink für das Mounten des Katalogs.

enabled

Gibt an, ob der Katalog für die Suche aktiviert ist. Der Standardwert ist TRUE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur MOUNT_ICEBERG

Dieses Verfahren enthält einen Iceberg-Katalog.

Syntax

Weitere Informationen zum Iceberg Catalog finden Sie unter Iceberg-REST-Katalogspezifikation. 

PROCEDURE mount_iceberg
(
  catalog_name 				IN VARCHAR2,
  endpoint 					IN VARCHAR2,
  catalog_credential 		IN VARCHAR2,
  data_storage_credential 	IN VARCHAR2,
  configuration 			IN SYS.JSON_OBJECT_T := NULL,
  enabled 					IN BOOLEAN := TRUE,
  catalog_type 				IN VARCHAR2 := 'ICEBERG_GENERIC'
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des neuen Katalogs. Dieser wird in Großbuchstaben konvertiert.

endpoint

Die Iceberg-Basis-Server-URL.

catalog_credential

Die Zugangsdaten für den Zugriff auf den Iceberg-Katalog.
data_storage_credential

Die Zugangsdaten für den Zugriff auf die Daten.
configuration

Dadurch wird die Katalogkonfiguration als JSON-Objekt beschrieben.

Folgende Konfigurationen werden unterstützt:
  • namespacePath: Standard ist NULL.
  • namespaceSeparator: Standard ist Punkt (.) für Unity, %1F für andere Iceberg-Kataloge.
  • isCaseSensitive: Standard ist FALSE für Unity, TRUE für andere Iceberg-Kataloge)
  • isPublicCatalog: Standard ist FALSE.
  • bucketRegion: Standard ist NULL. Dies ist nur relevant, wenn der Katalog den S3-Speicher verwendet.
enabled

Gibt an, ob der Katalog für die Suche aktiviert ist. Der Standardwert ist TRUE.

catalog_type

Typ des Iceberg-Katalogs (z.B. ICEBERG_GENERIC, ICEBERG_POLARIS, ICEBERG_UNITY). Standard ist ICEBERG_GENERIC.

Beispiel

/****************** Iceberg Catalog - Unity ******************/
DECLARE
  config      JSON_OBJECT_T := JSON_OBJECT_T();
BEGIN
  -- Create a credential capable of accessing an external iceberg REST catalog
  dbms_share.create_bearer_token_credential(
    credential_name => 'ICEBERG_CATALOG_CREDENTIAL',
    token_endpoint => 'https://.../v1/tokens',
    client_id => ...,
    client_secret => ...,
    token_scope => 'all-apis');

  -- Create a credential capable of accessing the bucket where the 
  -- iceberg data files are stored.
  dbms_cloud.create_credential('ICEBERG_STORAGE_CRED', ...); 

  -- Mount a iceberg catalog
  config.put('namespacePath', 'sales_catalog');
  dbms_catalog.mount_iceberg(
    catalog_name             => 'ICEBERG_CAT',
    endpoint                 => 'https://...//api/2.1/unity-catalog/iceberg/v1',
    catalog_credential       => 'ICEBERG_CATALOG_CREDENTIAL',
    data_storage_credential  => 'ICEBERG_STORAGE_CRED',
    configuration            => config,
    catalog_type             => 'ICEBERG_UNITY');
END;
/

/****************** Iceberg Catalog - Polaris ******************/
DECLARE
  config      JSON_OBJECT_T := JSON_OBJECT_T();
BEGIN
  -- Create a credential capable of accessing an external iceberg REST catalog
  dbms_share.create_bearer_token_credential(
    credential_name => 'ICEBERG_CATALOG_CREDENTIAL',
    token_endpoint => 'https://.../v1/oauth/tokens',
    client_id => ...,
    client_secret => ...,
    token_scope => 'PRINCIPAL_ROLE:ALL');

  -- Create a credential capable of accessing the bucket where the 
  -- iceberg data files are stored.
  dbms_cloud.create_credential('ICEBERG_STORAGE_CRED', ...); 

  -- Mount a iceberg catalog
  config.put('namespacePath', 'sales_catalog');
  dbms_catalog.mount_iceberg(
    catalog_name             => 'ICEBERG_CAT',
    endpoint                 => 'https://.../polaris/api/catalog/v1',
    catalog_credential       => 'ICEBERG_CATALOG_CREDENTIAL',
    data_storage_credential  => 'ICEBERG_STORAGE_CRED',
    configuration            => config,
    catalog_type             => 'ICEBERG_POLARIS');
END;
/

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur MOUNT_SHARE

Bei diesem Verfahren wird ein Katalog basierend auf einer einzelnen Freigabe gemountet.

Syntax

PROCEDURE mount_share
(
  catalog_name 				IN VARCHAR2,
  share_provider 			IN VARCHAR2,
  share_name 				IN VARCHAR2,
  share_provider_owner 		IN VARCHAR2 := NULL,
  enabled 					IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des neuen Katalogs. Dieser wird in Großbuchstaben konvertiert.

share_provider

Der Name des Freigabeproviders.

share_name

Der Name des einzuhängenden Shares.

share_provider_owner

Der Eigentümer des Share Providers. Ist NULL, wird standardmäßig der aktuelle Katalog verwendet.
enabled

Gibt an, ob der Katalog für die Suche aktiviert ist. Der Standardwert ist TRUE.

Beispiel

/****************** Share Catalog ******************/
BEGIN
  -- Create a share provider
  dbms_share.create_or_replace_share_provider(
    provider_name        => 'MY_SHARE_PROVIDER',
    endpoint             => 'https://...');
  dbms_cloud.create_credential(
    credential_name      => 'SHARE_PROVIDER_CREDENTIAL', ...);
  dbms_share.set_share_provider_credential(
    provider_name        => 'MY_SHARE_PROVIDER',
    share_credential     => 'SHARE_PROVIDER_CREDENTIAL');

  -- Mount a share catalog
  dbms_catalog.mount_share(
    catalog_name         => 'SHARE_CAT',
    share_provider       => 'MY_SHARE_PROVIDER',
    share_name           => 'MY_SHARE_1');
END;
/

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur MOUNT_SHARES

Bei diesem Verfahren werden mehrere Kataloge basierend auf Shares von einem Share Provider gemountet.

Syntax

PROCEDURE mount_shares
(
  share_provider 		IN VARCHAR2,
  shares 				IN SYS.JSON_ARRAY_T,
  created_catalogs 		IN OUT NOCOPY SYS.JSON_ARRAY_T,
  share_provider_owner 	IN VARCHAR2 := NULL
);

Parameter

Parameter Beschreibung

share_provider:

Der Name des Freigabeproviders.

shares

Ein JSON-Array, das die Liste der einzuhängenden Shares definiert. Jedes Element gibt Eigenschaften wie shareName, required, shareNameRule, catalogName, skipExisting, placeholder und enabled an.

created_catalogs

Ein JSON-Array mit neu erstellten Katalogen, das als Ausgabe mit Eigenschaften wie shareName und catalogName zurückgegeben wird.

share_provider_owner

Der Eigentümer des Share Providers. Ist NULL, wird standardmäßig der aktuelle Katalog verwendet.

Syntax der zweiten Prozedur

PROCEDURE mount_shares
(
  share_provider 		IN VARCHAR2,
  shares 				IN SYS.JSON_ARRAY_T,
  share_provider_owner 	IN VARCHAR2 := NULL
);

Syntax der dritten Prozedur

PROCEDURE mount_shares
(
  share_provider 		IN VARCHAR2,
  shares 				IN CLOB := '[{shareName:"%"}]',
  share_provider_owner 	IN VARCHAR2 := NULL
);

Parameter der zweiten Prozedur

Parameter sind identisch mit Prozedur 1, außer ohne created_catalogs.

Parameter des dritten Verfahrens

Parameter sind identisch mit Signatur 1, außer Shares ist ein CLOB mit einem Standardwert, der alle Shares enthält.

Beispiel

/****************** Share Catalog ******************/
BEGIN
  -- Create a share provider
  dbms_share.create_or_replace_share_provider(
    provider_name        => 'MY_SHARE_PROVIDER',
    endpoint             => 'https://...');
  dbms_cloud.create_credential(
    credential_name      => 'SHARE_PROVIDER_CREDENTIAL', ...);
  dbms_share.set_share_provider_credential(
    provider_name        => 'MY_SHARE_PROVIDER',
    share_credential     => 'SHARE_PROVIDER_CREDENTIAL');

  -- Mount shares as catalogs
  dbms_catalog.mount_shares(
    share_provider       => 'MY_SHARE_PROVIDER');
END;
/

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur MOUNT_VIRTUAL_CATALOG

Bei diesem Verfahren wird ein neuer virtueller Katalog erstellt und gemountet.

Syntax

PROCEDURE mount_virtual_catalog
(
  catalog_name 	IN VARCHAR2,
  enabled 		IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des neuen Katalogs. Dieser wird in Großbuchstaben konvertiert.

enabled

Gibt an, ob der Katalog für die Suche aktiviert ist. Der Standardwert ist TRUE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

UNMOUNT-Verfahren

Bei diesem Verfahren wird ein externer Katalog ausgehängt.

Syntax

PROCEDURE unmount
(
  catalog_name IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name eines vorhandenen Katalogs, der ausgehängt werden soll. Dieser wird in Großbuchstaben konvertiert.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_CATALOG_PROPERTY

Diese Prozedur gibt den Wert einer Eigenschaft für einen Katalog zurück.

Syntax

FUNCTION get_catalog_property
(
  catalog_name 		IN VARCHAR2,
  catalog_property 	IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
catalog_property

Hier wird die Eigenschaft beschrieben, die abgerufen werden soll. (Beispiel: PROP_CACHE_DURATION, PROP_IS_ENABLED).

Der Wert kann eine der folgenden Konstanten sein:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DCAT_TYPE
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Weitere Informationen finden Sie unter Katalogtypen und Konstanten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_CATALOG_PROPERTY_CLOB

Diese Prozedur gibt den Wert einer Eigenschaft für einen Katalog im CLOB-Format zurück.

Syntax

FUNCTION get_catalog_property_clob
(
  catalog_name 		IN VARCHAR2,
  catalog_property 	IN VARCHAR2
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
catalog_property

Hier wird die Eigenschaft beschrieben, die abgerufen werden soll (Beispiel: PROP_CACHE_DURATION, PROP_IS_ENABLED).

Der Wert kann eine der folgenden Konstanten sein:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DCAT_TYPE
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Weitere Informationen finden Sie unter Katalogtypen und Konstanten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_CATALOG_PROPERTY

Mit dieser Prozedur wird der Wert einer Eigenschaft für einen Katalog aktualisiert.

Syntax

PROCEDURE update_catalog_property
(
  catalog_name 		IN VARCHAR2,
  catalog_property 	IN VARCHAR2,
  new_value 		IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
catalog_property

Hier wird die zu aktualisierende Eigenschaft beschrieben (z.B. PROP_CACHE_DURATION, PROP_IS_ENABLED).

Der Wert kann eine der folgenden Konstanten sein:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Weitere Informationen finden Sie unter Katalogtypen und Konstanten.

new_value

Der neue Eigenschaftswert.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_CATALOG_PROPERTY_CLOB

Mit dieser Prozedur wird der Wert einer Eigenschaft für einen Katalog in CLOB aktualisiert.

Syntax

PROCEDURE update_catalog_property_clob
(
  catalog_name 		IN VARCHAR2,
  catalog_property 	IN VARCHAR2,
  new_value 		IN CLOB
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
catalog_property

Hier wird die Eigenschaft beschrieben, die abgerufen werden soll (Beispiel: PROP_CACHE_DURATION, PROP_IS_ENABLED).

new_value

Der neue Eigenschaftswert in CLOB.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

GET_COLUMN_PROPERTY (Funktion)

Ruft einen bestimmten Eigenschaftswert ab, z.B. PROP_CUSTOM, PROP_METADATA, für eine Spalte in einer Katalogtabelle.

Syntax

FUNCTION GET_COLUMN_PROPERTY
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  column_name                    IN VARCHAR2,
  column_property                IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
column_name

Name der Spalte.
column_property

Gibt den Eigenschaftswert zurück. Beispiel: PROP_CUSTOM, PROP_METADATA.

Hinweis

Funktion GET_COLUMN_PROPERTY_CLOB

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Funktion GET_COLUMN_PROPERTY_CLOB

Ruft einen bestimmten Eigenschaftswert für eine Spalte als CLOB (Character Large Object) ab.

Syntax

FUNCTION GET_COLUMN_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  column_name                    IN VARCHAR2,
  column_property                IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
column_name

Name der Spalte.
column_property

Gibt den Eigenschaftswert zurück. Beispiel: PROP_CUSTOM, PROP_METADATA.

Hinweis

GET_COLUMN_PROPERTY (Funktion)

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_COLUMN_PROPERTY

Aktualisiert den Eigenschaftswert für eine bestimmte Spalte mit einer Option zum Übertragen der Aktualisierung an die Annotationen des Quellobjekts.

Syntax

PROCEDURE UPDATE_COLUMN_PROPERTY
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  column_name                    IN VARCHAR2,
  column_property                IN VARCHAR2,
  new_value                      IN VARCHAR2,
  push_to_source                 IN BOOLEAN := FALSE
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
column_name

Name der Spalte.
column_property

Aktualisiert den Eigenschaftswert. Beispiel: PROP_CUSTOM, PROP_METADATA
new_value

Weist einen neuen Wert für die Eigenschaft zu.
push_to_source

Gibt an, ob die Eigenschaftsaktualisierung in Quellobjektannotationen übertragen werden soll.

Der Standardwert ist FALSE.
Hinweis

Prozedur UPDATE_COLUMN_PROPERTY_CLOB

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_COLUMN_PROPERTY_CLOB

Aktualisiert den Eigenschaftswert für eine bestimmte Spalte als CLOB (Character Large Object) für große Daten mit einer Option zum Übertragen der Aktualisierung an die Annotationen des Quellobjekts.

Syntax

PROCEDURE UPDATE_COLUMN_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  column_name                    IN VARCHAR2,
  column_property                IN VARCHAR2,
  new_value                      IN CLOB,
  push_to_source                 IN BOOLEAN := FALSE
);

Parameter

Parameter Beschreibung
catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
column_name

Name der Spalte.
column_property

Aktualisiert den Eigenschaftswert. Beispiel: PROP_CUSTOM, PROP_METADATA
new_value

Weist einen neuen Wert im CLOB-Format zu.
push_to_source

Gibt an, ob die Eigenschaftsaktualisierung in Quellobjektannotationen übertragen werden soll.

Der Standardwert ist FALSE.
Hinweis

Prozedur UPDATE_COLUMN_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_SCHEMA_PROPERTY

Diese Prozedur gibt den Wert einer Eigenschaft für ein Schema zurück.

Syntax

FUNCTION get_schema_property
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  schema_property 	IN VARCHAR2
)

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
schema_property

Hier wird die abzurufende Eigenschaft beschrieben (Beispiel: PROP_CUSTOM, PROP_METADATA).

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_SCHEMA_PROPERTY_CLOB

Diese Prozedur gibt den Wert einer Eigenschaft für ein Schema im CLOB-Format zurück.

Syntax

FUNCTION get_schema_property_clob
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  schema_property 	IN VARCHAR2
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
schema_property

Hier wird die abzurufende Eigenschaft beschrieben (Beispiel: PROP_CUSTOM, PROP_METADATA).

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_SCHEMA_PROPERTY

Diese Prozedur gibt den Wert einer Eigenschaft für ein Schema zurück.

Syntax

PROCEDURE update_schema_property
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  schema_property 	IN VARCHAR2,
  new_value 		IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
schema_property

Hier wird die abzurufende Eigenschaft beschrieben (Beispiel: PROP_CUSTOM, PROP_METADATA).

new_value

Der neue Eigenschaftswert.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_SCHEMA_PROPERTY_CLOB

Aktualisiert den Eigenschaftswert für ein Schema als CLOB (Character Large Object) für große Daten.

Syntax

PROCEDURE UPDATE_SCHEMA_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  schema_property                IN VARCHAR2,
  new_value                      IN CLOB
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
schema_property

Aktualisiert den Eigenschaftswert. Beispiel: PROP_CUSTOM, PROP_METADATA
new_value

Weist einen neuen Wert für die Eigenschaft zu.
Hinweis

Prozedur UPDATE_SCHEMA_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_TABLE_PROPERTY

Gibt den Wert einer Eigenschaft für eine Tabelle zurück.

Syntax

FUNCTION GET_TABLE_PROPERTY
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  table_property                 IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
table_property

Die abzurufende Eigenschaft.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_TABLE_PROPERTY_CLOB

Diese Prozedur gibt den Wert einer Eigenschaft für eine Tabelle im CLOB-Format zurück.

Syntax

FUNCTION get_table_property_clob
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  table_name 		IN VARCHAR2,
  table_property 	IN VARCHAR2
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
table_name

Der Name der Tabelle.
table_property

Die zu aktualisierende Eigenschaft (z.B. PROP_CUSTOM).

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_TABLE_PROPERTY

Mit dieser Prozedur wird der Wert einer Eigenschaft für eine Tabelle aktualisiert.

Syntax

PROCEDURE update_table_property
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  table_name 		IN VARCHAR2,
  table_property 	IN VARCHAR2,
  new_value 		IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
table_name

Der Name der Tabelle.
table_property

Die zu aktualisierende Eigenschaft.
new_value

Der neue Eigenschaftswert.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_TABLE_PROPERTY_CLOB

Aktualisiert den Wert einer Tabelleneigenschaft mit einem CLOB-(Character Large Object-)Datentyp.

Syntax

PROCEDURE UPDATE_TABLE_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  table_property                 IN VARCHAR2,
  new_value                      IN CLOB,
  push_to_source                 IN BOOLEAN := FALSE
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
table_property

Die zu aktualisierende Tabelleneigenschaft.
new_value

Weist einen neuen Wert im CLOB-Format zu.
push_to_source

Gibt an, ob die Eigenschaftsaktualisierung in Quellobjektannotationen übertragen werden soll.

Der Standardwert ist FALSE.
Hinweis

Prozedur UPDATE_TABLE_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur ADD_REQUIRED_CREDENTIAL

Definiert Zugangsdaten, die für die Verwendung des Katalogs erforderlich sind.

Syntax

PROCEDURE ADD_REQUIRED_CREDENTIAL
(
  catalog_name                   IN VARCHAR2,
  required_credential            IN VARCHAR2,
  local_credential               IN VARCHAR2 := NULL,
  credential_type                IN VARCHAR2 := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
required_credential

Der Name der erforderlichen Zugangsdaten.
local_credential

Es handelt sich um optionale lokale Zugangsdaten.

Der Standardwert ist NULL.
credential_type

Optional

Dieser Parameter gibt den Typ des Authentifizierungsmechanismus an, der für den Zugriff auf externe Services wie Objektspeicher oder andere Datenbanken verwendet wird. Beispiel: oci, aws, azure oder a slack_credential.

Weitere Informationen finden Sie unter Katalogtypen und Konstanten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur REMOVE_REQUIRED_CREDENTIAL

Mit dieser Prozedur werden erforderliche Zugangsdaten aus einem Katalog entfernt.

Syntax

PROCEDURE remove_required_credential
(
  catalog_name 			IN VARCHAR2,
  required_credential 	IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
required_credential

Der Name der zu entfernenden Zugangsdaten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur RENAME_REQUIRED_CREDENTIAL

Bei dieser Prozedur werden erforderliche Zugangsdaten aus einem Katalog umbenannt.

Syntax

PROCEDURE rename_required_credential
(
  catalog_name 			IN VARCHAR2,
  old_credential_name 	IN VARCHAR2,
  new_credential_name 	IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
old_credential_name

Der alte Name der erforderlichen Zugangsdaten.
new_credential_name

Der neue Name der erforderlichen Zugangsdaten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_REQUIRED_CREDENTIAL_PROPERTY

Diese Prozedur ruft eine Eigenschaft mit benannten erforderlichen Zugangsdaten ab.

Syntax

FUNCTION get_required_credential_property
(
  catalog_name 			IN VARCHAR2,
  required_credential 	IN VARCHAR2,
  credential_property 	IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
required_credential

Der Name der erforderlichen Zugangsdaten.
credential_property

Der Eigenschaftsname (z.B. PROP_REQUIRED_CREDENTIAL_DESCRIPTION, PROP_REQUIRED_CREDENTIAL_VAULT_SECRET).

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_REQUIRED_CREDENTIAL_PROPERTY

Mit dieser Prozedur wird eine Eigenschaft mit benannten erforderlichen Zugangsdaten aktualisiert.

Syntax

PROCEDURE update_required_credential_property
(
  catalog_name 			IN VARCHAR2,
  required_credential 	IN VARCHAR2,
  credential_property 	IN VARCHAR2,
  new_value 			IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
required_credential

Der Name der erforderlichen Zugangsdaten.
credential_property

Der Eigenschaftsname (z.B. PROP_REQUIRED_CREDENTIAL_DESCRIPTION, PROP_REQUIRED_CREDENTIAL_VAULT_SECRET).

new_value

Der neue Wert für die Eigenschaft.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

GET_LOCAL_CREDENTIAL_MAP-(Overloaded-)Prozedur

Diese Prozedur ruft eine Zuordnung der erforderlichen Zugangsdaten zu lokalen Zugangsdaten ab.

Syntax 1

PROCEDURE get_local_credential_map
(
  catalog_name 		IN VARCHAR2,
  credential_map 	OUT NOCOPY credential_info_map
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
credential_map

Die aufgefüllte Zuordnung der Zugangsdaten.

Syntax 2

FUNCTION get_local_credential_map
(
  catalog_name 	IN VARCHAR2,
  show_errors 	IN NUMBER := 0,
  pretty_json 	IN NUMBER := 0
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs.
show_errors

Dadurch werden Fehlermeldungen für ungültige lokale Zugangsdaten angezeigt. Standard ist 0.

pretty_json

Formatieren Sie die JSON mit der Option PRETTY. Der Standardwert ist 0.

Syntax 3

PROCEDURE get_local_credential_map
(
  catalog_id 		IN NUMBER,
  credential_map 	OUT NOCOPY SYS.JSON_OBJECT_T
);

Parameter

Parameter Beschreibung

catalog_id

Die ID eines vorhandenen Katalogs aus der Spalte CATALOG_ID in ALL_MOUNTED_CATALOGS.

credential_map

Die aufgefüllte Zuordnung als JSON-Objekt.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur SET_LOCAL_CREDENTIAL

Diese Prozedur gibt lokale Zugangsdaten an, die beim Konsumieren eines Katalogs verwendet werden sollen.

Syntax

PROCEDURE set_local_credential
(
  catalog_name 			IN VARCHAR2,
  required_credential 	IN VARCHAR2,
  local_credential 		IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
required_credential

Der Name der erforderlichen Zugangsdaten.
local_credential

Die zu verwendenden Zugangsdaten.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY

Ruft einen bestimmten Eigenschaftswert ab, z.B. PROP_CUSTOM, PROP_METADATA, für einen Cloud-Speicherlink in einem Katalog.

Syntax

FUNCTION GET_CLOUD_STORAGE_LINK_PROPERTY
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  storage_link_name              IN VARCHAR2,
  storage_link_property          IN VARCHAR2
)
RETURN VARCHAR2;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
storage_link_name

Name des Cloud-Speicherlinks.
storage_link_property

Gibt den Eigenschaftswert zurück. Beispiel: PROP_CUSTOM, PROP_METADATA.

Hinweis

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Ruft einen bestimmten Eigenschaftswert für einen Cloud-Speicherlink als CLOB (Character Large Object) ab.

Syntax

FUNCTION GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  storage_link_name              IN VARCHAR2,
  storage_link_property          IN VARCHAR2
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
storage_link_name

Name des Cloud-Speicherlinks.
storage_link_property

Gibt den Eigenschaftswert zurück. Beispiel: PROP_CUSTOM, PROP_METADATA.

Hinweis

Funktion GET_CLOUD_STORAGE_LINK_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Aktualisiert einen bestimmten Eigenschaftswert für einen Cloud-Speicherlink in einem Katalog.

Syntax

PROCEDURE UPDATE_CLOUD_STORAGE_LINK_PROPERTY
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  storage_link_name              IN VARCHAR2,
  storage_link_property          IN VARCHAR2,
  new_value                      IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
storage_link_name

Name des Cloud-Speicherlinks.
storage_link_property

Aktualisiert den Eigenschaftswert. Beispiel: PROP_CUSTOM, PROP_METADATA
new_value

Weist einen neuen Wert für die Eigenschaft zu.
Hinweis

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Aktualisiert einen bestimmten Eigenschaftswert für einen Cloud-Speicherlink als CLOB (Character Large Object) für größere Daten.

Syntax

PROCEDURE UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  storage_link_name              IN VARCHAR2,
  storage_link_property          IN VARCHAR2,
  new_value                      IN CLOB
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
storage_link_name

Name des Cloud-Speicherlinks.
storage_link_property

Aktualisiert den Eigenschaftswert. Beispiel: PROP_CUSTOM, PROP_METADATA
new_value

Weist einen neuen Wert im CLOB-Format zu.
Hinweis

Prozedur UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_CLOUD_STORAGE_LINK

Mit dieser Prozedur wird ein Cloud-Speicherlink in einem Katalog erstellt.

Syntax

PROCEDURE create_cloud_storage_link
(
  catalog_name 			IN VARCHAR2,
  schema_name 			IN VARCHAR2,
  storage_link_name 	IN VARCHAR2,
  uri 					IN VARCHAR2,
  required_credential 	IN VARCHAR2 := NULL,
  enabled 				IN BOOLEAN := TRUE,
  replace_if_exists 	IN BOOLEAN := FALSE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name:

Der Schemaname.
storage_link_name

Der Name des Speicherlinks.
uri

Die Bucket URI.
required_credential

Die erforderlichen Zugangsdaten (oder NULL für öffentliche Buckets).

Standardwert ist NULL.
enabled

Gibt an, ob der Speicherlink für die Suche aktiviert ist. Der Standardwert ist TRUE.
replace_if_exists

Ersetzen Sie den Link, wenn er bereits vorhanden ist. Der Standardwert ist FALSE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur DROP_CLOUD_STORAGE_LINK

Bei diesem Verfahren wird ein Cloud-Speicherlink aus einem Katalog gelöscht.

Syntax

PROCEDURE drop_cloud_storage_link
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  storage_link_name IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name:

Der Schemaname.
storage_link_name

Der Name des Speicherlinks.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Funktion GET_CLOUD_STORAGE_LINKS

Ruft einen bestimmten oder alle Cloud-Speicherlinks für einen Katalog ab.

Syntax

FUNCTION GET_CLOUD_STORAGE_LINKS
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2 := NULL,
  storage_link_name              IN VARCHAR2 := NULL,
  conditions                     IN VARCHAR2 := NULL,
  flags                          IN NUMBER := 0,
  result_limit                   IN NUMBER := NULL,
  column_flags                   IN NUMBER := 0
)
RETURN CATALOG_STORAGE_LINKS PIPELINED;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

(Optional)

Name des Quellkatalogschemas.

Der Standardwert ist NULL.
storage_link_name

(Optional)

Name des Cloud-Speicherlinks.

Der Standardwert ist NULL.
conditions

(Optional)

Zusätzliche Filterausdrücke mit Herkunftssyntax.

Der Standardwert ist NULL.
flags

(Optional)

Flags für zusätzliche Kontrolle.

Der Standardwert ist 0 (null).
result_limit

(Optional)

Die maximale Anzahl der zurückzugebenden Zeilen.

Der Standardwert ist NULL.
column_flags

(Optional)

Spaltenflags, z.B. FETCH_PROPERTIES, FETCH_METADATA.

Hinweis

Prozedur CREATE_CLOUD_STORAGE_LINK

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

GET_COLUMNS-Funktion

Ruft alle Spalten aus einer Tabelle oder View in einem Katalog ab.

Syntax

FUNCTION GET_COLUMNS
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2 := NULL,
  parent_type                    IN VARCHAR2 := NULL,
  column_name                    IN VARCHAR2 := NULL,
  conditions                     IN VARCHAR2 := NULL,
  flags                          IN NUMBER := 0,
  result_limit                   IN NUMBER := NULL,
  column_flags                   IN NUMBER := 0,
  table_name                     IN VARCHAR2 := NULL
)
RETURN COLUMN_RECORDS PIPELINED;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

(Optional)

Name des Quellkatalogschemas.

Der Standardwert ist NULL.
parent_type

(Optional)

Der übergeordnete Objekttyp, d.h. Tabelle oder View.

Der Standardwert ist NULL.
column_name

(Optional)

Name der Spalte.

Der Standardwert ist NULL.
conditions

(Optional)

Zusätzliche Filterausdrücke mit Herkunftssyntax.

Der Standardwert ist NULL.
flags

(Optional)

Flags für zusätzliche Kontrolle.

Der Standardwert ist 0 (null).
result_limit

(Optional)

Die maximale Anzahl der zurückzugebenden Zeilen.

Der Standardwert ist NULL.
column_flags

(Optional)

Spaltenflags, z.B. FETCH_PROPERTIES, FETCH_METADATA.

Der Standardwert ist 0 (null).
table_name

(Optional)

Name der Quellkatalogtabelle.

Der Standardwert ist NULL.
Hinweis

Prozedur CREATE_CLOUD_STORAGE_LINK

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_EXTERNAL_TABLE

Erstellt eine externe Tabelle in einem Katalog.

Syntax

PROCEDURE CREATE_EXTERNAL_TABLE
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  storage_link_name              IN VARCHAR2 := NULL,
  file_uri_list                  IN CLOB,
  column_list                    IN CLOB := NULL,
  field_list                     IN CLOB := NULL,
  table_format                   IN CLOB := NULL,
  credential_name                IN VARCHAR2 := NULL,
  replace_if_exists              IN BOOLEAN := FALSE
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
storage_link_name

(Optional)

Name des Cloud-Speicherlinks.

Der Standardwert ist NULL.
file_uri_list

Die relative Dateiliste als CLOB.
column_list

(Optional)

Spaltenliste.

Der Standardwert ist NULL.
field_list

(Optional)

Feldliste.

Der Standardwert ist NULL.
table_format

(Optional)

Das Format oder die Optionen zum Lesen externer Dateien, z.B. CSV, Parquet oder Avro, Trennzeichen, Header, Schemaableitungseinstellungen usw.) Es wird als JSON-Schlüssel/Wert-Paare ausgedrückt.

Der Standardwert ist NULL.
credential_name

Name der Zugangsdaten.

Der Standardwert ist NULL.
replace_if_exists

Gibt an, ob ein Objekt ersetzt werden soll, wenn es bereits vorhanden ist.

Der Standardwert ist FALSE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_SCHEMA

Erstellt ein neues Schema in einem Katalog. Sie können auch ein Apache Iceberg-Schema in Remotekatalogen erstellen.

Syntax

PROCEDURE CREATE_SCHEMA
(
  catalog_name          IN VARCHAR2,
  schema_name           IN VARCHAR2,
  schema_definition     IN CLOB := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
schema_definition

(Optional)

Payload der Schemadefinition.

Der Standardwert ist NULL.
Hinweis

DROP_SCHEMA-Verfahren

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur DROP_SCHEMA

Bei dieser Prozedur wird ein Schema zusammen mit dem gesamten Inhalt aus einem Katalog gelöscht.

Syntax

PROCEDURE drop_schema
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name:

Der zu löschende Schemaname.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_OBJECTS

Bei dieser Prozedur werden alle Objekte für einen Katalog abgerufen.

Syntax

FUNCTION get_objects
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2 := NULL,
  object_name 	IN VARCHAR2 := NULL,
  conditions 	IN VARCHAR2 := NULL,
  flags 		IN NUMBER := 0,
  result_limit 	IN NUMBER := NULL
)
RETURN catalog_objects PIPELINED;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Optionaler Schemaname. Standard ist NULL.

object_name

Optionaler Objektname. Standard ist NULL.

conditions

Optionale zusätzliche Bedingungen mit Herkunftssyntax. Standard ist NULL.

result_limit

Optionales Ergebnislimit. Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_SCHEMAS

Bei dieser Prozedur werden alle Schemas für einen Katalog abgerufen.

Syntax

FUNCTION get_schemas
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2 := NULL,
  conditions 	IN VARCHAR2 := NULL,
  flags 		IN NUMBER := 0,
  result_limit 	IN NUMBER := NULL,
  column_flags 	IN NUMBER := 0
)
RETURN catalog_schemas PIPELINED;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Optionaler Schemaname. Standard ist NULL.

conditions

Optionale zusätzliche Bedingungen mit Herkunftssyntax. Standard ist NULL.

result_limit

Optionales Ergebnislimit. Standardwert ist NULL.
column_flags

Optionale Spaltenflags (z.B. FETCH_PROPERTIES, FETCH_METADATA). Standard ist 0.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_TABLES

Bei diesem Verfahren werden alle Tabellen für einen Katalog abgerufen.

Syntax

FUNCTION get_tables
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2 := NULL,
  table_name 		IN VARCHAR2 := NULL,
  conditions 		IN VARCHAR2 := NULL,
  flags 			IN NUMBER := 0,
  result_limit 		IN NUMBER := NULL,
  column_flags 		IN NUMBER := 0
)
RETURN catalog_tables PIPELINED;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Optionaler Schemaname. Standard ist NULL.

table_name

Optionaler Tabellenname. Standard ist NULL.

conditions

Optionale zusätzliche Bedingungen mit Herkunftssyntax. Standard ist NULL.

result_limit

Optionales Ergebnislimit. Standardwert ist NULL.
column_flags

Optionale Spaltenflags (z.B. FETCH_PROPERTIES, FETCH_METADATA). Standard ist 0.

Hinweis

  • RECORD-Typen beschreiben strukturierte Daten mit benannten Feldern in Datenbanken.

  • Sie müssen das Informationsschema der Datenbank, Systemkataloge oder Datenbankintrospektionstools abfragen, um die Struktur der RECORD-Typen anzuzeigen.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GET_TABLE

Ruft detaillierte Informationen für eine bestimmte Tabelle in einem Katalog als Datensatz mit Optionen zum Anpassen der Ausgabe- und Caching-Überlegungen ab.

Syntax

PROCEDURE GET_TABLE
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  table_info                     OUT NOCOPY catalog_table,
  options                        IN CLOB := NULL,
  flags                          IN NUMBER := 0,
  column_flags                   IN NUMBER := 0,
  prev_gen_sql                   IN CLOB := NULL,
  prev_ts                        IN TIMESTAMP WITH TIME ZONE := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
options

Generierungsoptionen als JSON-Objekt, z.B. eindeutig, rowLimit, select, orderBy und Direktive.

Der Standardwert ist NULL.
flags

(Optional)

Flags für zusätzliche Kontrolle.

Der Standardwert ist 0 (null).
column_flags

(Optional)

Spaltenflags, z.B. FETCH_PROPERTIES, FETCH_METADATA.

Der Standardwert ist 0 (null).
prev_gen_sql

Zuvor generierte SELECT-Anweisung für die inkrementelle Verarbeitung, sofern bekannt.

Der Standardwert ist NULL.
prev_ts

Zeitstempel der vorherigen Generation, sofern bekannt

Der Standardwert ist NULL.
Hinweis

GET_TABLE (Funktion)

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

GET_TABLE (Funktion)

Ruft detaillierte Informationen für eine bestimmte Tabelle im JSON-Format als Character Large Object (CLOB) ab.

Syntax

FUNCTION GET_TABLE
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  options                        IN CLOB := NULL,
  flags                          IN NUMBER := 0,
  column_flags                   IN NUMBER := 0,
  prev_gen_sql                   IN CLOB := NULL,
  prev_ts                        IN TIMESTAMP WITH TIME ZONE := NULL
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
options

Generierungsoptionen als JSON-Objekt, z.B. eindeutig, rowLimit, select, orderBy und Direktive.

Der Standardwert ist NULL.
flags

(Optional)

Flags für zusätzliche Kontrolle.

Der Standardwert ist 0 (null).
column_flags

(Optional)

Spaltenflags, z.B. FETCH_PROPERTIES, FETCH_METADATA.

Der Standardwert ist 0 (null).
prev_gen_sql

Zuvor generierte SELECT-Anweisung für die inkrementelle Verarbeitung, sofern bekannt.

Der Standardwert ist NULL.
prev_ts

Zeitstempel der vorherigen Generation, sofern bekannt

Der Standardwert ist NULL.
Hinweis

Prozedur GET_TABLE

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur DROP_TABLE

Bei diesem Verfahren wird eine Tabelle aus einem Katalog gelöscht.

Syntax

PROCEDURE drop_table
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2,
  table_name 	IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Schemaname.
table_name

Tabellenname.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

GENERATE_TABLE_SELECT-(Overloaded-)Prozedur

Diese Prozedur generiert eine SELECT-Anweisung für eine logische Tabelle.

Syntax

PROCEDURE generate_table_select
(
  catalog_name 		IN VARCHAR2,
  schema_name 		IN VARCHAR2,
  table_name 		IN VARCHAR2,
  stmt 				IN OUT NOCOPY CLOB,
  options 			IN CLOB := NULL,
  prev_gen_sql 		IN CLOB := NULL,
  prev_ts 			IN TIMESTAMP WITH TIME ZONE := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Schemaname.
table_name

Tabellenname.
stmt

Die generierte SELECT-Anweisung als Ausgabe.
options

Generierungsoptionen als JSON-Objekt (z.B. eindeutig, rowLimit, auswählen, orderBy). Standardwert ist NULL.
prev_gen_sql

Die zuvor generierte SELECT-Anweisung, falls bekannt. Standardwert ist NULL.
prev_ts

Der Zeitstempel der vorherigen Generation (falls bekannt). Standardwert ist NULL.

Syntax

FUNCTION generate_table_select
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2,
  table_name 	IN VARCHAR2,
  options 		IN CLOB := NULL,
  prev_gen_sql 	IN CLOB := NULL,
  prev_ts 		IN TIMESTAMP WITH TIME ZONE := NULL
)
RETURN CLOB;

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Schemaname.
table_name

Tabellenname.
stmt

Die generierte SELECT-Anweisung als Ausgabe.
options

Generierungsoptionen als JSON-Objekt (z.B. eindeutig, rowLimit, auswählen, orderBy). Standardwert ist NULL.
prev_gen_sql

Die zuvor generierte SELECT-Anweisung, falls bekannt. Standardwert ist NULL.
prev_ts

Der Zeitstempel der vorherigen Generation (falls bekannt). Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur OPEN_TABLE_CURSOR

Diese Prozedur öffnet einen Cursor, der Daten aus einer logischen Tabelle zurückgibt.

Syntax

PROCEDURE open_table_cursor
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2,
  table_name 	IN VARCHAR2,
  table_cursor 	IN OUT NOCOPY SYS_REFCURSOR,
  options 		IN CLOB := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Optionaler Schemaname. Standard ist NULL.

table_name

Optionaler Tabellenname. Standard ist NULL.

table_cursor

Der Cursor, der Daten zurückgibt.
options

Generiert Optionen als JSON-Objekt (z.B. rowLimit, select, orderBy). Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur FLUSH_CATALOG_CACHE

Mit dieser Prozedur wird der Metadatencache des Katalogs geleert.

Syntax

PROCEDURE flush_catalog_cache
(
  catalog_name 	IN VARCHAR2,
  auto_commit	IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
auto_commit

Gibt an, ob Änderungen automatisch festgeschrieben werden sollen. Der Standardwert ist TRUE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur PREFILL_CATALOG_CACHE

Diese Prozedur füllt den Cache für den angegebenen Katalog mit aktuellen Daten.

Syntax

PROCEDURE prefill_catalog_cache
(
  catalog_name 	IN VARCHAR2,
  schema_name 	IN VARCHAR2 := NULL,
  auto_commit 	IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Der Namen des Schemas.
auto_commit

Gibt an, ob Änderungen automatisch festgeschrieben werden sollen. Der Standardwert ist TRUE.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_SYNCHRONIZED_SCHEMAS

Mit dieser Prozedur werden lokale Datenbankschemas erstellt, die mit Remotekatalogdefinitionen synchronisiert sind.

Syntax

PROCEDURE create_synchronized_schemas
(
  catalog_name IN VARCHAR2,
  schema_names IN VARCHAR2 := NULL,
  restrictions IN CLOB := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Eine durch Komma getrennte Liste mit Schemanamen (mit Anführungszeichen oder ohne Anführungszeichen). Der Standardwert ist NULL, um alle Schemas zu synchronisieren.
restrictions

JSON-Dokument, das den Geltungsbereich von Katalogentitäten angibt. Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur DROP_SYNCHRONIZED_SCHEMAS

Bei diesem Verfahren werden mindestens ein synchronisiertes Schema gelöscht.

Syntax

PROCEDURE drop_synchronized_schemas
(
  catalog_name IN VARCHAR2,
  schema_names IN VARCHAR2 := NULL,
  restrictions IN CLOB := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
schema_name

Eine durch Komma getrennte Liste mit Schemanamen (mit Anführungszeichen oder ohne Anführungszeichen). Der Standardwert ist NULL, um alle Schemas zu synchronisieren.
restrictions

JSON-Dokument, das den Geltungsbereich von Katalogentitäten angibt. Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY

Mit dieser Prozedur wird eine Eigenschaft von synchronisierten Schemas aktualisiert.

Syntax

PROCEDURE update_synchronized_schema_property
(
  catalog_name 	IN VARCHAR2,
  property_name IN VARCHAR2,
  new_value 	IN CLOB
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
property_name

Der Eigenschaftenname, der aktualisiert werden soll.
new_value

Der neue Wert als CLOB.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur SYNCHRONIZE_SHARED_CATALOGS

Bearbeiten Sie Kataloge auf Basis von Shares, die nicht mehr verfügbar sind.

Syntax

PROCEDURE SYNCHRONIZE_SHARED_CATALOGS
(
  provider_id                    IN NUMBER := NULL,
  remove_unavailable             IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung
provider_id

(Optional)

Gibt den Geltungsbereich der Synchronisierung an. Änderungen sind auf die angegebene Freigabeprovider-ID beschränkt. Wenn NULL ist, werden alle registrierten Aktienanbieter einschließlich der abgelaufenen Aktien synchronisiert.

Der Standardwert ist NULL.
remove_unavailable

Bestimmt die Aktion für Kataloge basierend auf der Share-Verfügbarkeit.

  • TRUE: Hebt das Mounten der Objekte für Shares auf, die entweder gelöscht wurden oder nicht verfügbar sind.

  • FALSE: Deaktiviert die Objekte, wenn die Shares nicht verfügbar sind.

Der Standardwert ist TRUE.
Hinweis

Prozedur CREATE_SYNCHRONIZED_SCHEMAS

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_SYNCHRONIZED_VIEWS

Erstellt Views für Katalogtabellen, um Einschränkungen zu definieren.

Syntax

PROCEDURE CREATE_SYNCHRONIZED_VIEWS
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2 := NULL,
  target_schema                  IN VARCHAR2 := NULL,
  table_names                    IN VARCHAR2 := NULL,
  view_prefix                    IN VARCHAR2 := NULL,
  replace_existing               IN BOOLEAN := FALSE,
  ignore_errors                  IN BOOLEAN := TRUE
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.

Der Standardwert ist NULL.
target_schema

Name des Zielschemas.

Der Standardwert ist NULL.
table_names

Durch Komma getrennte Liste mit Tabellennamen, wenn bestimmte Tabellen als Ziel definiert sind.

Der Standardwert ist NULL.
view_prefix

Zeichenfolge, die jedem generierten Ansichtsnamen vorangestellt wird.

Der Standardwert ist NULL.
replace_existing

Gibt an, ob ein Objekt ersetzt werden soll, wenn es bereits vorhanden ist.

Der Standardwert ist FALSE.
ignore_errors

Gibt an, ob Fehler ignoriert und die Verarbeitung mit den verbleibenden Objekten fortgesetzt werden soll.

Der Standardwert ist TRUE.
Hinweis

Prozedur CREATE_SYNCHRONIZED_SCHEMAS

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

COPY_TABLE_PROPERTIES - Prozedur

Kopiert Tabelleneigenschaften und optional Spalteneigenschaften aus einer Quelltabelle in eine Zieltabelle über Kataloge und Schemas hinweg mit Optionen zum Auswählen einer Eigenschafteneinstellung und zum Angeben von Zuordnungen für Spaltenumbenennungen.

Syntax

PROCEDURE COPY_TABLE_PROPERTIES
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  target_catalog_name            IN VARCHAR2 := DEFAULT_CATALOG,
  target_schema_name             IN VARCHAR2 := NULL,
  target_table_name              IN VARCHAR2 := NULL,
  properties                     IN VARCHAR2 := PROP_CUSTOM,
  copy_column_props              IN BOOLEAN := TRUE,
  renamed_columns                IN CLOB := NULL
);

Parameter

Parameter Beschreibung
catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der Quellkatalogtabelle.
target_catalog_name

Name des Zielkatalogs.

Der Standardwert ist DEFAULT_CATALOG.

target_schema_name

Name des Zielschemas.

Der Standardwert ist NULL.
target_table_name

Name der Zielkatalogtabelle.

Der Standardwert ist NULL.
properties

Die zu kopierenden Eigenschaften, z.B. CUSTOM:prop_x. Der Standardwert ist PROP_CUSTOM.

copy_column_props

Gibt an, ob benutzerdefinierte Spalteneigenschaften kopiert werden sollen.

Der Standardwert ist TRUE.
renamed_columns

JSON-Zuordnung der umbenannten Zielspalten. Beispiel: {"source_col":"target_col"}.

Der Standardwert ist NULL.
Hinweis

Prozedur GET_TABLE_PROPERTY

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur GRANT_TO_RECIPIENT

Dieses Verfahren gewährt einem bestimmten Share-Empfänger Zugriff auf einen Katalog.

Syntax

PROCEDURE grant_to_recipient
(
  catalog_name 		IN VARCHAR2,
  recipient_name 	IN VARCHAR2
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
recipient_name

Der Name des Share-Empfängers (erstellt von DBMS_SHARE.CREATE_SHARE_RECIPIENT).

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur REVOKE_FROM_RECIPIENT

Diese Prozedur entzieht einem bestimmten Empfänger den Zugriff auf einen Katalog.

Syntax

PROCEDURE revoke_from_recipient
(
  catalog_name 		IN VARCHAR2,
  recipient_name 	IN VARCHAR2,
  owner 			IN VARCHAR2 := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Der Name des vorhandenen Katalogs. Dieser wird in Großbuchstaben konvertiert.
recipient_name

Der Name des Share-Empfängers (erstellt von DBMS_SHARE.CREATE_SHARE_RECIPIENT).

owner

Der Eigentümer von Katalog und Empfänger. Standard ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CLEAR_CATALOG_EVENTS

Ruft detaillierte Informationen für eine bestimmte Tabelle in einem Katalog als Datensatz mit Optionen zum Anpassen der Ausgabe- und Caching-Überlegungen ab.

Syntax

PROCEDURE CLEAR_CATALOG_EVENTS
(
  catalog_name                   IN VARCHAR2,
  from_time                      IN TIMESTAMP WITH TIME ZONE := NULL,
  to_time                        IN TIMESTAMP WITH TIME ZONE := NULL
);

Parameter

Parameter Beschreibung

catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
from_time

Optional

Die Startzeit für den zu löschenden Ereignisbereich.

Der Standardwert ist NULL.
to_time

Optional

Die Endzeit für den zu löschenden Ereignisbereich.

Der Standardwert ist NULL.

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

Prozedur CREATE_ICEBERG_TABLE

Erstellt eine neue Iceberg-Tabelle in einem angegebenen Schema in einem Katalog und gibt die resultierenden Metadaten zurück.

Syntax

PROCEDURE CREATE_ICEBERG_TABLE
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  table_definition               IN CLOB,
  out_metadata                   OUT NOCOPY CLOB
);

Parameter

Parameter Beschreibung
catalog_name

Name des Quellkatalogs. Der Wert ist in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der neuen Tabelle.
table_definition

Die Tabellendefinition als CLOB.
out_metadata

Die resultierenden Tabellenmetadaten nach der Ausgabe.
Hinweis

ADD_ICEBERG_SNAPSHOT-Prozedur

Übergeordnetes Thema: Übersicht über DBMS_CATALOG

ADD_ICEBERG_SNAPSHOT-Prozedur

Fügt einer Iceberg-Tabelle einen Snapshot hinzu, um Datenänderungen darzustellen, einschließlich detaillierter Metadaten und optionaler Parameter für die Verfolgung von Herkunft und Inhalt.

Syntax

PROCEDURE ADD_ICEBERG_SNAPSHOT
(
  catalog_name                   IN VARCHAR2,
  schema_name                    IN VARCHAR2,
  table_name                     IN VARCHAR2,
  new_snapshot_id                IN NUMBER,
  new_timestamp                  TIMESTAMP WITH TIME ZONE,
  new_manifest_list              IN VARCHAR2,
  new_summary                    IN CLOB := NULL,
  new_parent_snapshot_id         IN NUMBER := NULL,
  new_sequence_number            IN NUMBER := NULL,
  new_first_row_id               IN NUMBER := NULL,
  new_added_row_count            IN NUMBER := NULL,
  new_schema_id                  IN NUMBER := NULL,
  requirements                   IN CLOB := NULL,
  out_metadata                   OUT NOCOPY CLOB
);

Parameter

Parameter Beschreibung
catalog_name

Name des Quellkatalogs. Der Wert wird in Großbuchstaben angegeben.
schema_name

Name des Quellkatalogschemas.
table_name

Name der neuen Tabelle.
new_snapshot_id

Ein eindeutiger Bezeichner für den neuen Snapshot.
new_timestamp

Der Zeitstempel der Snapshot-Erstellung.
new_manifest_list

Speicherort, Pfad oder URI der Manifestlistendatei.
new_summary

Eine Metadatenübersicht des Snapshots, die mindestens ein Feld "Vorgang" enthält.
new_parent_snapshot_id

Die ID des übergeordneten Snapshots. Dies gilt nicht für Root-Snapshots.
new_sequence_number

Eine inkrementelle Nummer zur Verfolgung der Reihenfolge von Tabellenänderungen.
new_first_row_id

Die erste Zeilen-ID, die der ersten Zeile in der ersten Datendatei des Snapshots zugewiesen ist.
new_added_row_count

Die Anzahl der Zeilen, die dem Snapshot hinzugefügt wurden.
new_schema_id

Die ID des beim Erstellen des Snapshots aktiven Tabellenschemas.
requirements

Voraussetzungen für den Commit in JSON-Arrayform.
out_metadata

Die resultierenden Tabellenmetadaten nach der Ausgabe.
Hinweis

Prozedur CREATE_ICEBERG_TABLE

Übergeordnetes Thema: Übersicht über DBMS_CATALOG