Documentazione dell'infrastruttura Oracle Cloud

Riepilogo di DBMS_CATALOG

In questa sezione vengono descritti i programmi secondari DBMS_CATALOG forniti con Oracle Autonomous AI Database.

I sottoprogrammi sono classificati nelle seguenti aree funzionali.

Montaggio e disinstallazione del catalogo

Sottoprogramma Descrizione

Procedura MOUNT_DATA_CATALOG

Questa procedura esegue il MOUNT di un Data Catalog, ad esempio AWS GLUE o OCI Data Catalog.

Procedura MOUNT_DB_LINK

Questa procedura attiva un catalogo basato su un database link.

Procedura MOUNT_ICEBERG

Questa procedura attiva un catalogo Apache Iceberg con configurazioni specifiche.

Procedura MOUNT_SHARE

Questa procedura attiva un singolo catalogo basato su una condivisione.

Procedura MOUNT_SHARES

Questa procedura attiva più cataloghi di un provider di condivisione, con sovraccarichi per supportare tipi di input diversi.

Procedura MOUNT_VIRTUAL_CATALOG

Questa procedura crea e attiva un nuovo catalogo virtuale.

Procedura UNMOUNT

Questa procedura disattiva un catalogo esterno esistente.

Gestione proprietà catalogo

Sottoprogramma Descrizione

Procedura GET_CATALOG_PROPERTY

Procedura GET_CATALOG_PROPERTY_CLOB

Queste procedure recuperano i valori delle proprietà per un catalogo.

Procedura UPDATE_CATALOG_PROPERTY

Procedura UPDATE_CATALOG_PROPERTY_CLOB

Queste procedure aggiornano i valori delle proprietà per un catalogo.

Funzione GET_COLUMN_PROPERTY

Funzione GET_COLUMN_PROPERTY_CLOB

Queste funzioni recuperano i valori delle proprietà per una colonna specifica in formato VARCHAR2 o CLOB.

Procedura UPDATE_COLUMN_PROPERTY

Procedura UPDATE_COLUMN_PROPERTY_CLOB

Queste procedure aggiornano i valori delle proprietà per una colonna specifica con opzioni per eseguire il push degli aggiornamenti all'origine.

Procedura GET_SCHEMA_PROPERTY

Procedura GET_SCHEMA_PROPERTY_CLOB

Queste procedure recuperano i valori delle proprietà dello schema.

Procedura UPDATE_SCHEMA_PROPERTY

Procedura UPDATE_SCHEMA_PROPERTY_CLOB

Queste procedure aggiornano i valori delle proprietà dello schema.

Procedura GET_TABLE_PROPERTY

Procedura GET_TABLE_PROPERTY_CLOB

Queste procedure recuperano i valori delle proprietà della tabella.

Procedura UPDATE_TABLE_PROPERTY

Procedura UPDATE_TABLE_PROPERTY_CLOB

Queste procedure aggiornano i valori delle proprietà della tabella.

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Queste funzioni recuperano i valori delle proprietà per un collegamento di storage cloud in formato VARCHAR2 o CLOB.

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Queste procedure aggiornano i valori delle proprietà per un collegamento allo storage cloud.

Gestione credenziali

Sottoprogramma Descrizione

Procedura ADD_REQUIRED_CREDENTIAL

Questa procedura definisce una credenziale obbligatoria per un catalogo.

Procedura REMOVE_REQUIRED_CREDENTIAL

Questa procedura rimuove una credenziale richiesta da un catalogo.

Procedura RENAME_REQUIRED_CREDENTIAL

Questa procedura rinomina una credenziale richiesta.

Procedura GET_REQUIRED_CREDENTIAL_PROPERTY

Questa procedura recupera una proprietà di una credenziale richiesta.

Procedura UPDATE_REQUIRED_CREDENTIAL_PROPERTY

Questa procedura aggiorna una proprietà di una credenziale richiesta.

Procedura GET_LOCAL_CREDENTIAL_MAP (sovraccarico)

 Questa procedura recupera i mapping tra le credenziali richieste e le credenziali locali, con sovraccarichi per vari formati di output.

Procedura SET_LOCAL_CREDENTIAL

Questa procedura specifica una credenziale locale per una credenziale richiesta.

Gestione entità catalogo

Sottoprogramma Descrizione

Procedura CREATE_CLOUD_STORAGE_LINK

Procedura DROP_CLOUD_STORAGE_LINK

Queste procedure gestiscono i collegamenti allo storage cloud in un catalogo.

Funzione GET_CLOUD_STORAGE_LINKS

Questa funzione recupera i metadati per i collegamenti di storage cloud in un catalogo con filtri facoltativi.

Procedura CREATE_EXTERNAL_TABLE

Questa procedura crea una tabella esterna in un catalogo.

Procedura CREATE_SCHEMA

Questa procedura crea un nuovo schema in un catalogo e crea anche lo schema di Apache Iceberg nei cataloghi remoti.

Procedura GET_OBJECTS

Procedura GET_SCHEMAS

Procedura GET_TABLES

Questa procedura recupera i metadati per tabelle, schemi e oggetti all'interno di un catalogo utilizzando funzioni in pipeline.

Procedura DROP_SCHEMA

Procedura DROP_TABLE

Questa procedura elimina gli schemi e le tabelle da un catalogo.

Funzione GET_COLUMNS

Questa funzione recupera i metadati per le colonne nelle tabelle o nelle viste di un catalogo.

Procedura GET_TABLE

Funzione GET_TABLE

Questa procedura e funzione recupera informazioni dettagliate su una tabella specifica in formato record o JSON.

Accesso ai dati e inserimento nella cache

Sottoprogramma Descrizione

Procedura GENERATE_TABLE_SELECT (sovraccarico)

Questa procedura crea un'istruzione SELECT per una tabella logica, con sovraccarichi sia per la procedura che per la funzione.

Procedura OPEN_TABLE_CURSOR

Questa procedura consente di aprire un cursore per restituire i dati da una tabella logica.

Procedura FLUSH_CATALOG_CACHE

Procedura PREFILL_CATALOG_CACHE

Queste procedure gestiscono l'inserimento dei metadati del catalogo nella cache.

Sincronizzazione e condivisione

Sottoprogramma Descrizione

Procedura CREATE_SYNCHRONIZED_SCHEMAS

Procedura DROP_SYNCHRONIZED_SCHEMAS

Queste procedure gestiscono gli schemi sincronizzati con le definizioni del catalogo remoto.

Procedura UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY

Questa procedura aggiorna le proprietà degli schemi sincronizzati.

Procedura SYNCHRONIZE_SHARED_CATALOGS

Questa procedura gestisce i cataloghi corrispondenti alle condivisioni non disponibili con opzioni per il NO MOUNT o la disabilitazione.

Procedura CREATE_SYNCHRONIZED_VIEWS

Questa procedura crea viste sulle tabelle catalogo per applicare limitazioni.

Procedura COPY_TABLE_PROPERTIES

Questa procedura consente di copiare le proprietà da una tabella all'altra, incluse le proprietà facoltative delle colonne.

Procedura GRANT_TO_RECIPIENT

Procedura REVOKE_FROM_RECIPIENT

Queste procedure gestiscono le autorizzazioni di accesso per i destinatari del catalogo.

Registrazione eventi

Sottoprogramma Descrizione

Procedura CLEAR_CATALOG_EVENTS

Questa procedura cancella gli eventi dal log eventi del catalogo in un intervallo di tempo.

Gestione specifica dell'iceberg

Sottoprogramma Descrizione

Procedura CREATE_ICEBERG_TABLE

Questa procedura crea una nuova tabella Iceberg all'interno di uno schema specificato in un catalogo.

Procedura ADD_ICEBERG_SNAPSHOT

Questa procedura aggiunge uno snapshot a una tabella Iceberg per rappresentare le modifiche ai dati con metadati dettagliati.

Argomento padre: Gestisci cataloghi con DBMS_CATALOG

Procedura MOUNT_DATA_CATALOG

Questa procedura monta un Data Catalog (ad esempio, AWS GLUE o OCI Data Catalog).

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Il nome del nuovo catalogo. Questa operazione verrà convertita in maiuscolo.

data_catalog_type

Tipo di Data Catalog (ad esempio, OCI_DCAT o AWS_GLUE).

data_catalog_region

Area risorse cloud del Data Catalog.

data_catalog_credential

Credenziale locale utilizzata per accedere al Data Catalog.

data_catalog_id

Nome o identificativo del Data Catalog. Il valore predefinito è NULL.

data_storage_credential

Specifica la credenziale locale per l'accesso ai dati. Il valore predefinito è NULL. Questo campo è facoltativo.

enabled

Indica se il catalogo è abilitato per la ricerca. L'impostazione predefinita è TRUE.

Esempio

/****************** 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;
/

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura MOUNT_DB_LINK

Questa procedura attiva un catalogo esterno basato su un database link.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del nuovo catalogo. Questa operazione verrà convertita in maiuscolo.

db_link

Il database link da utilizzare per il MOUNT del catalogo.

enabled

Indica se il catalogo è abilitato per la ricerca. L'impostazione predefinita è TRUE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura MOUNT_ICEBERG

Questa procedura monta un catalogo Iceberg.

Sintassi

Per ulteriori informazioni sul catalogo Iceberg, vedere Specifica del catalogo REST Iceberg. 

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

Parametri

Parametro Descrizione

catalog_name

Il nome del nuovo catalogo. Questa operazione verrà convertita in maiuscolo.

endpoint

URL del server di base Iceberg.

catalog_credential

Credenziale utilizzata per accedere al catalogo Iceberg.
data_storage_credential

Credenziale utilizzata per accedere ai dati.
configuration

Viene descritta la configurazione del catalogo come oggetto JSON.

Di seguito sono riportate le configurazioni supportate.
  • namespacePath: l'impostazione predefinita è NULL.
  • namespaceSeparator: l'impostazione predefinita è punto (.) per Unity, %1F per altri cataloghi Iceberg.
  • isCaseSensitive: l'impostazione predefinita è FALSE per Unity, TRUE per altri cataloghi Iceberg)
  • isPublicCatalog: il valore predefinito è FALSE.
  • bucketRegion: l'impostazione predefinita è NULL. È rilevante solo se il catalogo utilizza lo storage S3.
enabled

Indica se il catalogo è abilitato per la ricerca. L'impostazione predefinita è TRUE.

catalog_type

Tipo di catalogo Iceberg (ad esempio, ICEBERG_GENERIC, ICEBERG_POLARIS, ICEBERG_UNITY). L'impostazione predefinita è ICEBERG_GENERIC.

Esempio

/****************** 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;
/

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura MOUNT_SHARE

Questa procedura attiva un catalogo basato su una singola condivisione.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Il nome del nuovo catalogo. Questa operazione verrà convertita in maiuscolo.

share_provider

Il nome del provider condivisione.

share_name

Il nome della condivisione da attivare.

share_provider_owner

Il proprietario del provider azioni. Il valore predefinito è il catalogo corrente se NULL.
enabled

Indica se il catalogo è abilitato per la ricerca. Il valore predefinito è TRUE.

Esempio

/****************** 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;
/

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura MOUNT_SHARES

Questa procedura attiva più cataloghi in base alle condivisioni di un provider di condivisione.

Sintassi

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
);

Parametri

Parametro Descrizione

share_provider:

Il nome del provider condivisione.

shares

Array JSON che definisce la lista di condivisioni da installare. Ogni elemento specifica proprietà quali shareName, required, shareNameRule, catalogName, skipExisting, placeholder e enabled.

created_catalogs

Un array JSON di cataloghi appena creati, restituito come output con proprietà quali shareName e catalogName.

share_provider_owner

Il proprietario del provider azioni. Il valore predefinito è il catalogo corrente se NULL.

Sintassi della seconda procedura

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

Sintassi della terza procedura

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

Parametri della seconda procedura

I parametri sono identici alla procedura 1, tranne che senza created_catalogs.

Parametri della terza procedura

I parametri sono identici alla firma 1, ad eccezione delle condivisioni è un valore CLOB con un valore predefinito che include tutte le condivisioni.

Esempio

/****************** 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;
/

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura MOUNT_VIRTUAL_CATALOG

Questa procedura crea e attiva un nuovo catalogo virtuale.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del nuovo catalogo. Questa operazione verrà convertita in maiuscolo.

enabled

Indica se il catalogo è abilitato per la ricerca. Il valore predefinito è TRUE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UNMOUNT

In questa procedura viene annullato l'attivazione di un catalogo esterno.

Sintassi

PROCEDURE unmount
(
  catalog_name IN VARCHAR2
);

Parametri

Parametro Descrizione

catalog_name

Nome di un catalogo esistente da disattivare. Questa operazione verrà convertita in maiuscolo.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_CATALOG_PROPERTY

Questa procedura restituisce il valore di una proprietà per un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
catalog_property

Viene descritta la proprietà da recuperare. Ad esempio, PROP_CACHE_DURATION, PROP_IS_ENABLED.

Il valore può essere una qualsiasi delle costanti seguenti:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DCAT_TYPE
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Per ulteriori informazioni, vedere Tipi di catalogo e costanti.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_CATALOG_PROPERTY_CLOB

Questa procedura restituisce il valore di una proprietà per un catalogo in formato CLOB.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
catalog_property

Viene descritta la proprietà da recuperare (ad esempio, PROP_CACHE_DURATION, PROP_IS_ENABLED).

Il valore può essere una qualsiasi delle costanti seguenti:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DCAT_TYPE
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Per ulteriori informazioni, vedere Tipi di catalogo e costanti.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_CATALOG_PROPERTY

Questa procedura aggiorna il valore di una proprietà per un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
catalog_property

Viene descritta la proprietà da aggiornare (ad esempio, PROP_CACHE_DURATION, PROP_IS_ENABLED).

Il valore può essere una qualsiasi delle costanti seguenti:
  • PROP_CACHE_ASYNC
  • PROP_CACHE_DURATION
  • PROP_CACHE_ENABLED
  • PROP_CONFIGURATION
  • PROP_CUSTOM
  • PROP_DEFAULT_SCHEMA
  • PROP_IS_ENABLED
  • PROP_METADATA

Per ulteriori informazioni, vedere Tipi di catalogo e costanti.

new_value

Il nuovo valore di proprietà.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_CATALOG_PROPERTY_CLOB

Questa procedura aggiorna il valore di una proprietà per un catalogo in CLOB.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
catalog_property

Viene descritta la proprietà da recuperare (ad esempio, PROP_CACHE_DURATION, PROP_IS_ENABLED).

new_value

Il nuovo valore di proprietà in CLOB.

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_COLUMN_PROPERTY

Recupera un valore di proprietà specifico, ad esempio PROP_CUSTOM, PROP_METADATA, per una colonna in una tabella catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
column_name

Nome della colonna.
column_property

Restituisce il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA.

Nota

Funzione GET_COLUMN_PROPERTY_CLOB

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_COLUMN_PROPERTY_CLOB

Recupera un valore di proprietà specifico per una colonna come CLOB (Character Large Object).

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
column_name

Nome della colonna.
column_property

Restituisce il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA.

Nota

Funzione GET_COLUMN_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_COLUMN_PROPERTY

Aggiorna il valore della proprietà per una colonna specifica, con un'opzione per eseguire il push dell'aggiornamento alle annotazioni dell'oggetto di origine.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
column_name

Nome della colonna.
column_property

Aggiorna il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA
new_value

Assegna un nuovo valore per la proprietà.
push_to_source

Indica se inviare l'aggiornamento della proprietà alle annotazioni dell'oggetto di origine.

L'impostazione predefinita è FALSE.
Nota

Procedura UPDATE_COLUMN_PROPERTY_CLOB

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_COLUMN_PROPERTY_CLOB

Aggiorna il valore della proprietà per una colonna specifica come CLOB (Character Large Object) per i dati di grandi dimensioni, con un'opzione per eseguire il push dell'aggiornamento alle annotazioni dell'oggetto di origine.

Sintassi

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
);

Parametri

Parametro Descrizione
catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
column_name

Nome della colonna.
column_property

Aggiorna il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA
new_value

Assegna un nuovo valore in formato CLOB.
push_to_source

Indica se inviare l'aggiornamento della proprietà alle annotazioni dell'oggetto di origine.

L'impostazione predefinita è FALSE.
Nota

Procedura UPDATE_COLUMN_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_SCHEMA_PROPERTY

Questa procedura restituisce il valore di una proprietà per uno schema.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
schema_property

Viene descritta la proprietà da recuperare (ad esempio, PROP_CUSTOM, PROP_METADATA).

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_SCHEMA_PROPERTY_CLOB

Questa procedura restituisce il valore di una proprietà per uno schema in formato CLOB.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
schema_property

Viene descritta la proprietà da recuperare (ad esempio, PROP_CUSTOM, PROP_METADATA).

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_SCHEMA_PROPERTY

Questa procedura restituisce il valore di una proprietà per uno schema.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
schema_property

Viene descritta la proprietà da recuperare (ad esempio, PROP_CUSTOM, PROP_METADATA).

new_value

Il nuovo valore di proprietà.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_SCHEMA_PROPERTY_CLOB

Aggiorna il valore della proprietà per uno schema come CLOB (Character Large Object) per i dati di grandi dimensioni.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
schema_property

Aggiorna il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA
new_value

Assegna un nuovo valore per la proprietà.
Nota

Procedura UPDATE_SCHEMA_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_TABLE_PROPERTY

Restituisce il valore di una proprietà per una tabella.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
table_property

Proprietà da recuperare.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_TABLE_PROPERTY_CLOB

Questa procedura restituisce il valore di una proprietà per una tabella in formato CLOB.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
table_name

Nome della tabella.
table_property

La proprietà da aggiornare (ad esempio, PROP_CUSTOM).

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_TABLE_PROPERTY

Questa procedura aggiorna il valore di una proprietà per una tabella.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
table_name

Nome della tabella.
table_property

Proprietà da aggiornare.
new_value

Il nuovo valore di proprietà.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_TABLE_PROPERTY_CLOB

Aggiorna il valore di una proprietà tabella utilizzando un tipo di dati CLOB (Character Large Object).

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
table_property

Proprietà della tabella da aggiornare.
new_value

Assegna un nuovo valore in formato CLOB.
push_to_source

Indica se inviare l'aggiornamento della proprietà alle annotazioni dell'oggetto di origine.

L'impostazione predefinita è FALSE.
Nota

Procedura UPDATE_TABLE_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura ADD_REQUIRED_CREDENTIAL

Definisce una credenziale necessaria per l'utilizzo del catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
required_credential

Il nome della credenziale richiesta.
local_credential

Si tratta di una credenziale locale opzionale da utilizzare.

Il valore predefinito è NULL.
credential_type

Facoltativo

Questo parametro specifica il tipo di meccanismo di autenticazione utilizzato per accedere ai servizi esterni, ad esempio lo storage degli oggetti o altri database. Ad esempio, oci, aws, azure o slack_credential.

Per ulteriori informazioni, vedere Tipi di catalogo e costanti.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura REMOVE_REQUIRED_CREDENTIAL

Questa procedura rimuove una credenziale richiesta da un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
required_credential

Il nome della credenziale richiesta da rimuovere.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura RENAME_REQUIRED_CREDENTIAL

Questa procedura rinomina una credenziale richiesta da un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
old_credential_name

Il vecchio nome della credenziale richiesta.
new_credential_name

Il nuovo nome della credenziale richiesta.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_REQUIRED_CREDENTIAL_PROPERTY

Questa procedura recupera una proprietà di una credenziale richiesta denominata.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
required_credential

Il nome della credenziale richiesta.
credential_property

Il nome della proprietà (ad esempio, PROP_REQUIRED_CREDENTIAL_DESCRIPTION, PROP_REQUIRED_CREDENTIAL_VAULT_SECRET).

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_REQUIRED_CREDENTIAL_PROPERTY

Questa procedura aggiorna una proprietà di una credenziale richiesta denominata.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
required_credential

Il nome della credenziale richiesta.
credential_property

Il nome della proprietà (ad esempio, PROP_REQUIRED_CREDENTIAL_DESCRIPTION, PROP_REQUIRED_CREDENTIAL_VAULT_SECRET).

new_value

Il nuovo valore per la proprietà.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_LOCAL_CREDENTIAL_MAP (sovraccarico)

Questa procedura recupera una mappa delle credenziali richieste alle credenziali locali.

Sintassi 1

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
credential_map

Mappa popolata delle credenziali.

Sintassi 2

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente.
show_errors

Vengono visualizzati messaggi di errore relativi a credenziali locali non valide. L'impostazione predefinita è 0.

pretty_json

Formattare il file JSON con l'opzione PRETTY. L'impostazione predefinita è 0.

Sintassi 3

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

Parametri

Parametro Descrizione

catalog_id

L'ID di un catalogo esistente dalla colonna CATALOG_ID in ALL_MOUNTED_CATALOGS.

credential_map

Mappa popolata come oggetto JSON.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura SET_LOCAL_CREDENTIAL

Questa procedura specifica una credenziale locale da utilizzare quando si utilizza un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
required_credential

Il nome della credenziale richiesta.
local_credential

Credenziale da utilizzare.

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY

Recupera un valore di proprietà specifico, ad esempio PROP_CUSTOM, PROP_METADATA, per un collegamento allo storage cloud in un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
storage_link_name

Nome del collegamento allo storage cloud.
storage_link_property

Restituisce il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA.

Nota

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Recupera un valore di proprietà specifico per un collegamento allo storage cloud come CLOB (Character Large Object).

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
storage_link_name

Nome del collegamento allo storage cloud.
storage_link_property

Restituisce il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA.

Nota

Funzione GET_CLOUD_STORAGE_LINK_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Aggiorna un valore di proprietà specifico per un collegamento allo storage cloud in un catalogo.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
storage_link_name

Nome del collegamento allo storage cloud.
storage_link_property

Aggiorna il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA
new_value

Assegna un nuovo valore per la proprietà.
Nota

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY_CLOB

Aggiorna un valore di proprietà specifico per un collegamento allo storage cloud come CLOB (Character Large Object) per i dati più grandi.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
storage_link_name

Nome del collegamento allo storage cloud.
storage_link_property

Aggiorna il valore della proprietà, ad esempio PROP_CUSTOM, PROP_METADATA
new_value

Assegna un nuovo valore in formato CLOB.
Nota

Procedura UPDATE_CLOUD_STORAGE_LINK_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_CLOUD_STORAGE_LINK

Questa procedura crea un collegamento allo storage cloud in un catalogo.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name:

Nome dello schema.
storage_link_name

Nome del collegamento di memorizzazione.
uri

URI bucket.
required_credential

Credenziale obbligatoria (o NULL per i bucket pubblici).

Il valore predefinito è NULL.
enabled

Indica se il collegamento di memorizzazione è abilitato per la ricerca. Il valore predefinito è TRUE.
replace_if_exists

Sostituire il collegamento se esiste già. Il valore predefinito è FALSE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura DROP_CLOUD_STORAGE_LINK

Questa procedura elimina un collegamento allo storage cloud da un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name:

Nome dello schema.
storage_link_name

Nome del collegamento di memorizzazione.

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_CLOUD_STORAGE_LINKS

Recupera uno specifico o tutti i collegamenti di storage cloud per un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

(Facoltativo)

Nome dello schema del catalogo di origine.

Il valore predefinito è NULL.
storage_link_name

(Facoltativo)

Nome del collegamento allo storage cloud.

Il valore predefinito è NULL.
conditions

(Facoltativo)

Espressioni di filtro aggiuntive che utilizzano la sintassi della derivazione.

Il valore predefinito è NULL.
flags

(Facoltativo)

Flag per un controllo aggiuntivo.

L'impostazione predefinita è 0 (zero).
result_limit

(Facoltativo)

Il numero massimo di righe da restituire.

Il valore predefinito è NULL.
column_flags

(Facoltativo)

Flag di colonna, ad esempio FETCH_PROPERTIES, FETCH_METADATA.

Nota

Procedura CREATE_CLOUD_STORAGE_LINK

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_COLUMNS

Recupera tutte le colonne da una tabella o vista in un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

(Facoltativo)

Nome dello schema del catalogo di origine.

Il valore predefinito è NULL.
parent_type

(Facoltativo)

Il tipo di oggetto padre, ovvero tabella o vista.

Il valore predefinito è NULL.
column_name

(Facoltativo)

Nome della colonna.

Il valore predefinito è NULL.
conditions

(Facoltativo)

Espressioni di filtro aggiuntive che utilizzano la sintassi della derivazione.

Il valore predefinito è NULL.
flags

(Facoltativo)

Flag per un controllo aggiuntivo.

L'impostazione predefinita è 0 (zero).
result_limit

(Facoltativo)

Il numero massimo di righe da restituire.

Il valore predefinito è NULL.
column_flags

(Facoltativo)

Flag di colonna, ad esempio FETCH_PROPERTIES, FETCH_METADATA.

L'impostazione predefinita è 0 (zero).
table_name

(Facoltativo)

Nome della tabella del catalogo di origine.

Il valore predefinito è NULL.
Nota

Procedura CREATE_CLOUD_STORAGE_LINK

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_EXTERNAL_TABLE

Crea una tabella esterna in un catalogo.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
storage_link_name

(Facoltativo)

Nome del collegamento allo storage cloud.

Il valore predefinito è NULL.
file_uri_list

Elenco di file relativi come CLOB.
column_list

(Facoltativo)

Elenco di colonne.

Il valore predefinito è NULL.
field_list

(Facoltativo)

Lista di campi.

Il valore predefinito è NULL.
table_format

(Facoltativo)

Il formato o le opzioni per la lettura di file esterni, ad esempio CSV, Parquet o Avro, delimitatori, intestazioni, impostazioni di derivazione dello schema e così via). È espresso come coppie chiave-valore JSON.

Il valore predefinito è NULL.
credential_name

Nome della credenziale.

Il valore predefinito è NULL.
replace_if_exists

Indica se sostituire un oggetto se esiste già.

L'impostazione predefinita è FALSE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_SCHEMA

Crea un nuovo schema in un catalogo. È inoltre possibile creare lo schema di Apache Iceberg nei cataloghi remoti.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
schema_definition

(Facoltativo)

Payload definizione schema.

Il valore predefinito è NULL.
Nota

Procedura DROP_SCHEMA

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura DROP_SCHEMA

Questa procedura elimina uno schema da un catalogo insieme a tutti i relativi contenuti.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name:

Il nome schema da eliminare.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_OBJECTS

Questa procedura recupera tutti gli oggetti per un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome schema facoltativo. L'impostazione predefinita è NULL.

object_name

Nome oggetto facoltativo. L'impostazione predefinita è NULL.

conditions

Condizioni aggiuntive facoltative utilizzando la sintassi della derivazione. L'impostazione predefinita è NULL.

result_limit

Limite di risultato facoltativo. Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_SCHEMAS

Questa procedura recupera tutti gli schemi per un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome schema facoltativo. L'impostazione predefinita è NULL.

conditions

Condizioni aggiuntive facoltative utilizzando la sintassi della derivazione. L'impostazione predefinita è NULL.

result_limit

Limite di risultato facoltativo. Il valore predefinito è NULL.
column_flags

Flag colonna facoltativi (ad esempio, FETCH_PROPERTIES, FETCH_METADATA). L'impostazione predefinita è 0.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_TABLES

Questa procedura recupera tutte le tabelle per un catalogo.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome schema facoltativo. L'impostazione predefinita è NULL.

table_name

Nome tabella facoltativo. L'impostazione predefinita è NULL.

conditions

Condizioni aggiuntive facoltative utilizzando la sintassi della derivazione. L'impostazione predefinita è NULL.

result_limit

Limite di risultato facoltativo. Il valore predefinito è NULL.
column_flags

Flag colonna facoltativi (ad esempio, FETCH_PROPERTIES, FETCH_METADATA). L'impostazione predefinita è 0.

Nota

  • I tipi RECORD descrivono i dati strutturati con campi denominati nei database.

  • È necessario eseguire una query sullo schema delle informazioni del database, sui cataloghi di sistema o utilizzare gli strumenti di introspezione del database per visualizzare la struttura dei tipi RECORD.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GET_TABLE

Recupera informazioni dettagliate per una tabella specifica in un catalogo come record, con opzioni per la personalizzazione delle considerazioni relative all'output e all'inserimento nella cache.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
options

Opzioni di generazione come oggetto JSON, ad esempio distinto, rowLimit, select, orderBy e direttiva.

Il valore predefinito è NULL.
flags

(Facoltativo)

Flag per un controllo aggiuntivo.

L'impostazione predefinita è 0 (zero).
column_flags

(Facoltativo)

Flag di colonna, ad esempio FETCH_PROPERTIES, FETCH_METADATA.

L'impostazione predefinita è 0 (zero).
prev_gen_sql

Istruzione SELECT generata in precedenza per l'elaborazione incrementale, se nota.

Il valore predefinito è NULL.
prev_ts

Indicatore orario generazione precedente, se noto.

Il valore predefinito è NULL.
Nota

Funzione GET_TABLE

Argomento padre: Riepilogo di DBMS_CATALOG

Funzione GET_TABLE

Recupera informazioni dettagliate per una tabella specifica in formato JSON come CLOB (Character Large Object).

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
options

Opzioni di generazione come oggetto JSON, ad esempio distinto, rowLimit, select, orderBy e direttiva.

Il valore predefinito è NULL.
flags

(Facoltativo)

Flag per un controllo aggiuntivo.

L'impostazione predefinita è 0 (zero).
column_flags

(Facoltativo)

Flag di colonna, ad esempio FETCH_PROPERTIES, FETCH_METADATA.

L'impostazione predefinita è 0 (zero).
prev_gen_sql

Istruzione SELECT generata in precedenza per l'elaborazione incrementale, se nota.

Il valore predefinito è NULL.
prev_ts

Indicatore orario generazione precedente, se noto.

Il valore predefinito è NULL.
Nota

Procedura GET_TABLE

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura DROP_TABLE

In questa procedura viene eliminata una tabella da un catalogo.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome dello schema.
table_name

Nome della tabella.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GENERATE_TABLE_SELECT (sovraccarico)

Questa procedura genera un'istruzione SELECT per una tabella logica.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome dello schema.
table_name

Nome della tabella.
stmt

L'istruzione SELECT generata come output.
options

Opzioni di generazione come oggetto JSON (ad esempio, distinto, rowLimit, select, orderBy). Il valore predefinito è NULL.
prev_gen_sql

L'istruzione SELECT generata in precedenza, se nota. Il valore predefinito è NULL.
prev_ts

Indicatore orario generazione precedente, se noto. Il valore predefinito è NULL.

Sintassi

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;

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome dello schema.
table_name

Nome della tabella.
stmt

L'istruzione SELECT generata come output.
options

Opzioni di generazione come oggetto JSON (ad esempio, distinto, rowLimit, select, orderBy). Il valore predefinito è NULL.
prev_gen_sql

L'istruzione SELECT generata in precedenza, se nota. Il valore predefinito è NULL.
prev_ts

Indicatore orario generazione precedente, se noto. Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura OPEN_TABLE_CURSOR

Questa procedura apre un cursore che restituisce i dati di una tabella logica.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Nome schema facoltativo. L'impostazione predefinita è NULL.

table_name

Nome tabella facoltativo. L'impostazione predefinita è NULL.

table_cursor

Il cursore per restituire i dati.
options

Genera le opzioni come oggetto JSON (ad esempio, rowLimit, select, orderBy). Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura FLUSH_CATALOG_CACHE

Questa procedura cancella la cache dei metadati del catalogo,

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
auto_commit

Indica se il commit delle modifiche deve essere eseguito automaticamente. Il valore predefinito è TRUE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura PREFILL_CATALOG_CACHE

Questa procedura riempie la cache del catalogo specificato con i dati correnti.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Il nome dello schema.
auto_commit

Indica se il commit delle modifiche deve essere eseguito automaticamente. Il valore predefinito è TRUE.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_SYNCHRONIZED_SCHEMAS

Questa procedura crea gli schemi di database locali sincronizzati con le definizioni del catalogo remoto.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Lista delimitata da virgole di nomi di schema (tra virgolette o senza virgolette). Il valore predefinito è NULL per sincronizzare tutti gli schemi.
restrictions

Documento JSON che specifica l'ambito delle entità catalogo. Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura DROP_SYNCHRONIZED_SCHEMAS

Questa procedura elimina uno o più schemi sincronizzati.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
schema_name

Lista delimitata da virgole di nomi di schema (tra virgolette o senza virgolette). Il valore predefinito è NULL per sincronizzare tutti gli schemi.
restrictions

Documento JSON che specifica l'ambito delle entità catalogo. Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY

Questa procedura aggiorna una proprietà degli schemi sincronizzati.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
property_name

Nome della proprietà da aggiornare.
new_value

Il nuovo valore come CLOB.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura SYNCHRONIZE_SHARED_CATALOGS

Gestire i cataloghi in base alle condivisioni non più disponibili.

Sintassi

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

Parametri

Parametro Descrizione
provider_id

(Facoltativo)

Identifica l'ambito della sincronizzazione. Le modifiche sono limitate all'ID provider condivisione specificato. Se NULL, sincronizza tutti i provider di azioni registrate, incluse le azioni scadute.

Il valore predefinito è NULL.
remove_unavailable

Determina l'azione sui cataloghi in base alla disponibilità della condivisione.

  • TRUE: consente di annullare l'installazione degli oggetti per le condivisioni eliminate o non disponibili.

  • FALSE: disabilita gli oggetti se le condivisioni non sono disponibili.

Il valore predefinito è TRUE.
Nota

Procedura CREATE_SYNCHRONIZED_SCHEMAS

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_SYNCHRONIZED_VIEWS

Crea viste nelle tabelle catalogo per la definizione delle limitazioni.

Sintassi

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
);

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.

Il valore predefinito è NULL.
target_schema

Nome dello schema di destinazione.

Il valore predefinito è NULL.
table_names

Lista separata da virgole di nomi di tabella se sono previste tabelle specifiche.

Il valore predefinito è NULL.
view_prefix

Stringa da anteporre a ogni nome vista generato.

Il valore predefinito è NULL.
replace_existing

Indica se sostituire un oggetto se esiste già.

L'impostazione predefinita è FALSE.
ignore_errors

Indica se ignorare eventuali errori e continuare l'elaborazione con gli oggetti rimanenti.

Il valore predefinito è TRUE.
Nota

Procedura CREATE_SYNCHRONIZED_SCHEMAS

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura COPY_TABLE_PROPERTIES

Copia le proprietà della tabella e, facoltativamente, le proprietà delle colonne da una tabella di origine a una tabella di destinazione in cataloghi e schemi, con le opzioni per selezionare un set di proprietà e specificare i mapping di ridenominazione delle colonne.

Sintassi

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
);

Parametri

Parametro Descrizione
catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della tabella del catalogo di origine.
target_catalog_name

Nome del catalogo di destinazione.

L'impostazione predefinita è DEFAULT_CATALOG.

target_schema_name

Nome dello schema di destinazione.

Il valore predefinito è NULL.
target_table_name

Nome della tabella catalogo di destinazione.

Il valore predefinito è NULL.
properties

Le proprietà da copiare, ad esempio CUSTOM:prop_x. L'impostazione predefinita è PROP_CUSTOM.

copy_column_props

Indica se copiare le proprietà personalizzate delle colonne.

Il valore predefinito è TRUE.
renamed_columns

Mapping JSON delle colonne di destinazione rinominate, ad esempio {"source_col":"target_col"}.

Il valore predefinito è NULL.
Nota

Procedura GET_TABLE_PROPERTY

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura GRANT_TO_RECIPIENT

Questa procedura concede l'accesso su un catalogo a un destinatario di condivisione specifico.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
recipient_name

Il nome del destinatario della condivisione (creato da DBMS_SHARE.CREATE_SHARE_RECIPIENT).

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura REVOKE_FROM_RECIPIENT

Questa procedura revoca l'accesso a un catalogo da un destinatario specifico.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Il nome del catalogo esistente. Questa operazione verrà convertita in maiuscolo.
recipient_name

Il nome del destinatario della condivisione (creato da DBMS_SHARE.CREATE_SHARE_RECIPIENT).

owner

Il proprietario del catalogo e del destinatario. L'impostazione predefinita è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CLEAR_CATALOG_EVENTS

Recupera informazioni dettagliate per una tabella specifica in un catalogo come record, con opzioni per la personalizzazione delle considerazioni relative all'output e all'inserimento nella cache.

Sintassi

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

Parametri

Parametro Descrizione

catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
from_time

Facoltativo

Ora di inizio per l'intervallo di eventi da cancellare.

Il valore predefinito è NULL.
to_time

Facoltativo

Ora di fine per la cancellazione dell'intervallo di eventi.

Il valore predefinito è NULL.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura CREATE_ICEBERG_TABLE

Crea una nuova tabella Iceberg all'interno di uno schema specificato in un catalogo, restituendo i metadati risultanti.

Sintassi

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
);

Parametri

Parametro Descrizione
catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della nuova tabella.
table_definition

La definizione della tabella come CLOB.
out_metadata

Metadati della tabella risultanti dopo l'output.
Nota

Procedura ADD_ICEBERG_SNAPSHOT

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura ADD_ICEBERG_SNAPSHOT

Aggiunge uno snapshot a una tabella Iceberg per rappresentare le modifiche ai dati, inclusi metadati dettagliati e parametri facoltativi per il tracciamento della derivazione e del contenuto.

Sintassi

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
);

Parametri

Parametro Descrizione
catalog_name

Nome del catalogo di origine. Il valore è in maiuscolo.
schema_name

Nome dello schema del catalogo di origine.
table_name

Nome della nuova tabella.
new_snapshot_id

Un identificativo univoco per il nuovo snapshot.
new_timestamp

Indicatore orario durante la creazione dell'istantanea.
new_manifest_list

La posizione, il percorso o l'URI del file di elenco dei file manifesti.
new_summary

Riepilogo dei metadati dello snapshot che include almeno un campo "operazione".
new_parent_snapshot_id

L'ID dell'elemento padre di questo snapshot. Non applicabile per le istantanee root.
new_sequence_number

Numero incrementale per la registrazione dell'ordine di modifica della tabella.
new_first_row_id

L'ID riga iniziale assegnato per la prima riga nel primo file di dati dello snapshot.
new_added_row_count

Numero di righe aggiunte nello snapshot.
new_schema_id

ID dello schema di tabella attivo al momento della creazione dello snapshot.
requirements

Precondizioni per il commit, in formato array JSON.
out_metadata

Metadati della tabella risultanti dopo l'output.
Nota

Procedura CREATE_ICEBERG_TABLE

Argomento padre: Riepilogo di DBMS_CATALOG