Documentazione dell'infrastruttura Oracle Cloud

Riepilogo di DBMS_CATALOG

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

Montaggio e disinstallazione del catalogo

Sottoprogramma Descrizione

mount_db_link

Questa procedura attiva un catalogo basato su un database link.

mount_shares

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

mount_share

Questa procedura attiva un singolo catalogo basato su una condivisione.

mount_virtual_catalog

Questa procedura crea e attiva un nuovo catalogo virtuale.

mount_data_catalog

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

mount_iceberg

Questa procedura monta un catalogo Iceberg con configurazioni specifiche.

disinstalla

Questa procedura disattiva un catalogo esterno esistente.

Gestione proprietà catalogo

Sottoprogramma Descrizione

get_catalog_property e get_catalog_property_clob

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

update_catalog_property e update_catalog_property_clob

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

get_schema_property e get_schema_property_clob

Queste procedure recuperano i valori delle proprietà dello schema.

update_schema_property e update_schema_property_clob

Queste procedure aggiornano i valori delle proprietà dello schema.

get_table_property e get_table_property_clob

Queste procedure recuperano i valori delle proprietà della tabella.

update_table_property e update_table_property_clob

Queste procedure aggiornano i valori delle proprietà della tabella.

Gestione credenziali

Sottoprogramma Descrizione

add_required_credential

Questa procedura definisce una credenziale obbligatoria per un catalogo.

remove_required_credential

Questa procedura rimuove una credenziale richiesta da un catalogo.

rename_required_credential

Questa procedura rinomina una credenziale richiesta.

update_required_credential_property

Questa procedura aggiorna una proprietà di una credenziale richiesta.

get_required_credential_property

Questa procedura recupera una proprietà di una credenziale richiesta.

set_local_credential

Questa procedura specifica una credenziale locale per una credenziale richiesta.
get_local_credential_map Questa procedura recupera i mapping tra le credenziali richieste e le credenziali locali, con sovraccarichi per vari formati di output.

Gestione entità catalogo

Sottoprogramma Descrizione

create_cloud_storage_link e drop_cloud_storage_link

Questa procedura gestisce i collegamenti allo storage cloud all'interno di un catalogo.

create_external_table

Questa procedura crea una tabella esterna in un catalogo.

drop_schema e drop_table

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

get_tables, get_schemas e get_objects

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

Accesso ai dati e inserimento nella cache

Sottoprogramma Descrizione

generate_table_select

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

open_table_cursor

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

flush_catalog_cache e prefill_catalog_cache

Questa procedura gestisce l'inserimento dei metadati del catalogo nella cache.

Sincronizzazione e condivisione

Sottoprogramma Descrizione

create_synchronized_schemas e drop_synchronized_schemas

Questa procedura gestisce gli schemi sincronizzati con le definizioni del catalogo remoto.

update_synchronized_schema_property

Questa procedura aggiorna le proprietà degli schemi sincronizzati.

grant_to_recipient e revoke_from_recipient

Questa procedura gestisce le autorizzazioni di accesso per i destinatari del catalogo.

Argomento padre: Gestisci cataloghi con 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_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_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_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 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_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 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

Procedura UPDATE_TABLE_PROPERTY_CLOB

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

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

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à in CLOB.

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 GET_TABLE_PROPERTY

Questa procedura 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

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

Il nome dello schema.
table_property

Proprietà da recuperare.
table_name

Nome della tabella.

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

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

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

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à in CLOB.

Argomento padre: Riepilogo di DBMS_CATALOG

Procedura ADD_REQUIRED_CREDENTIAL

Questa procedura 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

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

Il nome della credenziale richiesta.
local_credential

Si tratta di una credenziale locale opzionale da utilizzare. L'impostazione predefinita è NULL.

credential_type

Questo campo è 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 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_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 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

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

Procedura CREATE_EXTERNAL_TABLE

Questa procedura 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,
  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

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

Nome dello schema.
table_name

Nome della tabella.
storage_link_name

Nome del collegamento di memorizzazione.
file_uri_list

Elenco di file relativi come CLOB.
column_list

Lista di colonne facoltativa. Il valore predefinito è NULL.
field_list

Elenco di campi facoltativo. Il valore predefinito è NULL.
table_format

Informazioni sul formato opzionale. Il valore predefinito è NULL.
credential_name

La credenziale richiesta. Il valore predefinito è NULL.
replace_if_exists

Sostituire la tabella se esiste già. Il valore predefinito è FALSE.

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 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 CREATE_SCHEMA

Questa procedura crea un nuovo schema in un catalogo.

Sintassi

PROCEDURE create_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

Nome dello schema.

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_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_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 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 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