DBMS_SHARE Costanti

File scollegati

Costanti utilizzate dalla procedura PURGE_DETACHED_FILES.

Nome	Tipo	Value	Descrizione
`PURGE_DROP`	`PLS_INTEGER`	`1`	Tentativo di eliminare i file utilizzando la credenziale specificata. Se il file non può essere eliminato, il file continua a essere elencato nelle viste `*_SHARE_DETACHED_FILES`.
`PURGE_DROP_FORCE`	`PLS_INTEGER`	`2`	Tentativo di eliminare i file utilizzando la credenziale specificata. Il file viene rimosso dalle viste `*_SHARE_DETACHED_FILES`, anche se il tentativo di eliminare nuovamente il file non riesce.
`PURGE_FORGET`	`PLS_INTEGER`	`3`	Rimuovere le viste `*_SHARE_DETACHED_FILES` dei file senza tentare di eliminarle.

Livello di log

Costanti utilizzate per impostare il livello di informazioni raccolte nel log. Questi livelli controllano il numero di eventi che vengono registrati in ALL_SHARE_EVENTS e ALL_SHARE_RECIPIENTS.

Vedere SET_SHARE_LOG_LEVEL Procedura e SET_RECIPIENT_LOG_LEVEL Procedura.

Nome	Tipo	Value	Descrizione
`LOG_LEVEL_ERRORS_ONLY`	`PLS_INTEGER`	`0`	Solo errori di log.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Errori di log e informazioni di base.
`LOG_LEVEL_DETAIL`	`PLS_INTEGER`	`2`	Errori di log e dettagli aggiuntivi.
`LOG_LEVEL_DEBUG`	`PLS_INTEGER`	`3`	Registra il livello di informazioni di debug.

Condividi proprietà job

Proprietà utilizzate nella procedura UPDATE_SHARE_JOB_PROPERTY.

Nome	Tipo	Value	Descrizione
`PROP_SHARE_JOB_DOP`	`VARCHAR2(7)`	`'JOB_DOP'`	La proprietà `JOB_DOP` determina il numero di job `DBMS_SCHEDULER` utilizzati per pubblicare la condivisione. Deve essere un numero compreso tra 1 e 5.
`PROP_SHARE_JOB_CLASS`	`VARCHAR2(9)`	`'JOB_CLASS'`	La proprietà `JOB_CLASS` determina la classe di job dello scheduler utilizzata per pubblicare la condivisione. Per un elenco di valori validi, vedere `ALL_SCHEDULER_JOB_CLASSES`. Il valore predefinito è `DEFAULT_JOB_CLASS`.
`PROP_SHARE_JOB_PRIORITY`	`VARCHAR2(12)`	`'JOB_PRIORITY'`	La proprietà `JOB_PRIORITY` determina la priorità relativa quando vengono pubblicate contemporaneamente due o più condivisioni dello stesso utente. Il valore deve essere un numero, con 0 come valore predefinito. Le azioni con priorità più alta verranno elaborate prima delle azioni con priorità più bassa. Le azioni con la stessa priorità vengono elaborate in base al primo arrivato e al primo servizio. Valori standard per la priorità della mansione: `SHARE_PRIORITY_LOW CONSTANT NUMBER := 1; SHARE_PRIORITY_DEFAULT CONSTANT NUMBER := 2; SHARE_PRIORITY_HIGH CONSTANT NUMBER := 3;`

Proprietà condivisione

Costanti utilizzate per indicare le proprietà di una condivisione.

Vedere UPDATE_SHARE_PROPERTY Procedure, UPDATE_DEFAULT_SHARE_PROPERTY Procedure e GET_SHARE_PROPERTY Function.

Nome	Tipo	Value	Descrizione
`PROP_SHARE_DESC`	`VARCHAR2(11)`	`'DESCRIPTION'`	Una descrizione visibile localmente della condivisione.
`PROP_SHARE_PUBLIC_DESC`	`VARCHAR2(18)`	`'PUBLIC_DESCRIPTION'`	Una descrizione esterna visibile della condivisione.
`PROP_SHARE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	La proprietà `SPLIT_SIZE` determina la dimensione dei file parquet generati. L'algoritmo funziona come segue: SQL Optimizer stima la dimensione in byte di un determinato segmento (ad esempio, una partizione di una tabella o i risultati di una vista). Il numero di byte è diviso per `SPLIT_SIZE` e arrotondato per eccesso per produrre il "numero di frazionamenti". I dati nel segmento vengono quindi inseriti in questo "numero di frazionamenti" utilizzando un metodo (ad esempio ROWID, colonne di indice, colonne specificate, ecc.). Ogni pezzo di dati viene poi convertito in un file di parquet. Si noti che il file parquet sarà generalmente più piccolo di `SPLIT_SIZE` a causa della compressione. In particolare, `SPLIT_SIZE` determina la quantità di dati prima della compressione.
`PROP_SHARE_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	La proprietà `LOG_LEVEL` determina la quantità di informazioni che verranno registrate nel log `ALL_SHARE_EVENTS`.
`PROP_SHARE_VERSION_ACCESS`	`VARCHAR2(14)`	`'VERSION_ACCESS'`	Le versioni di una condivisione pubblicata che un destinatario può visualizzare.

Condividi tipo PAR destinatario

Queste costanti sono i valori validi per la proprietà PROP_RECIPIENT_PAR_TYPE in UPDATE_RECIPIENT_PROPERTY Procedure e GET_RECIPIENT_PROPERTY.

Nome	Tipo	Value	Descrizione
`PAR_TYPE_FOLDER`	`PLS_INTEGER`	`1`	Le richieste PAR consentono di accedere all'intera cartella.
`PAR_TYPE_FILE`	`PLS_INTEGER`	`2`	Le richieste PAR consentono di accedere a un file alla volta.

Proprietà destinatario condivisione

Queste costanti vengono utilizzate in GET_SHARE_PROPERTY Function, UPDATE_DEFAULT_SHARE_PROPERTY Procedure e UPDATE_SHARE_PROPERTY Procedure.

Nome	Tipo	Value	Descrizione
`PROP_RECIPIENT_PAR_LIFETIME`	`VARCHAR2(12)`	`'PAR_LIFETIME'`	Durata degli URL delle richieste preautenticate inviati al destinatario tramite l'API di condivisione delta. Il valore predefinito è di tre ore: '00 03:00:00'
`PROP_RECIPIENT_MIN_PAR_LIFETIME`	`VARCHAR2(16)`	`'MIN_PAR_LIFETIME'`	Durata minima garantita di un URL di richiesta preautenticata inviato al destinatario tramite l'API di condivisione delta. Se esiste una richiesta PAR esistente per lo stesso file parquet, viene riutilizzata solo se la durata rimanente supera questo valore minimo. Il valore predefinito è 2 ore 1/2: '00 02:30:00'
`PROP_RECIPIENT_MAX_PAR_LIFETIME`	`VARCHAR2(16)`	`'MAX_PAR_LIFETIME'`	Impostazione dell'amministratore che definisce la durata massima consentita per qualsiasi destinatario. Il valore predefinito è 1 giorno: '01 00:00:00'
`PROP_RECIPIENT_TOKEN_LIFETIME`	`VARCHAR2(14)`	`'TOKEN_LIFETIME'`	Una stringa, in formato INTERVAL DAY TO SECOND, che rappresenta la durata di un token portatore di condivisione delta. Il valore predefinito è un'ora: '01 00:00:00'.
`PROP_RECIPIENT_MAX_TOKEN_LIFETIME`	`VARCHAR2(18)`	`'MAX_TOKEN_LIFETIME'`	Impostazione dell'amministratore che definisce la durata massima consentita del token bearer per qualsiasi destinatario. L'impostazione predefinita è 90 giorni: '90 00:00:00'
`PROP_RECIPIENT_EMAIL`	`VARCHAR2(5)`	`'EMAIL'`	L'e-mail del destinatario. Obbligatorio solo per i destinatari della condivisione delta.
`PROP_RECIPIENT_DESCRIPTION`	`VARCHAR2(11)`	`'DESCRIPTION'`	Descrizione testuale del destinatario.
`PROP_RECIPIENT_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	Il livello di log per il destinatario. Controlla ciò che viene registrato in `USER_SHARE_RECIPIENT_EVENTS`. Il valore deve essere una delle costanti `LOG_LEVEL_*`.
`PROP_RECIPIENT_SHARING_ID`	`VARCHAR2(10)`	`'SHARING_ID'`	ID condivisione del destinatario. Questa operazione è necessaria solo per i destinatari di Autonomous Database.
`PROP_RECIPIENT_PAR_TYPE`	`VARCHAR2(8)`	`'PAR_TYPE'`	Il tipo di richiesta preautenticata da creare. Deve essere `PAR_TYPE_FOLDER` (impostazione predefinita) o `PAR_TYPE_FILE`.
`PROP_RECIPIENT_VERSION_ACCESS`	`VARCHAR2(14)`	`'VERSION_ACCESS'`	Specifica le versioni delle condivisioni pubblicate che un destinatario può visualizzare. Una delle opzioni `VERSION_ACCESS_CURRENT` o `VERSION_ACCESS_ANY`.

Proprietà tabella di condivisione

Costanti utilizzate per indicare le proprietà della tabella di condivisione. Questi vengono utilizzati dalla funzione GET_SHARE_TABLE_PROPERTY e dalla procedura UPDATE_SHARE_TABLE_PROPERTY.

Nome	Tipo	Value	Descrizione
`PROP_SHARE_TABLE_SPLIT_METHOD`	`VARCHAR2(12)`	`'SPLIT_METHOD'`	Specifica come suddividere un segmento in file diversi.
`SPLIT_METHOD_AUTO`	`VARCHAR2(4)`	`'AUTO'`	Autonomous Database determina il modo in cui i segmenti vengono suddivisi.
`SPLIT_METHOD_RANGE`	`VARCHAR2(5)`	`'RANGE'`	Dividere i segmenti in base agli intervalli di valori. Gli intervalli esatti sono determinati analizzando gli istogrammi dei dati. Questo metodo richiede la specifica di uno o più valori `split_columns`.
`SPLIT_METHOD_ROWID`	`VARCHAR2(5)`	`'ROWID'`	Dividere i segmenti in base a `ROWID`.
`SPLIT_METHOD_HASH`	`VARCHAR2(4)`	`'HASH'`	Dividere i segmenti in base ai valori HASH. Questo metodo richiede la specifica di uno o più valori `split_columns`.
`SPLIT_METHOD_VALUE`	`VARCHAR2(5)`	`'VALUE'`	Suddividere i segmenti in base a valori distinti. Questo metodo richiede la specifica di uno o più valori `split_columns`.
`PROP_SHARE_TABLE_SPLIT_COLUMNS`	`VARCHAR2(13)`	`'SPLIT_COLUMNS'`	Specifica le colonne utilizzate per il frazionamento. Questi sono necessari per i metodi RANGE, VALUE e HASH. Il valore deve essere un set delimitato da virgole di colonne condivise (ad esempio, 'STATE,CITY' o '"STATE","CITY").
`PROP_SHARE_TABLE_ORDER_COLUMNS`	`VARCHAR2(13)`	`'ORDER_COLUMNS'`	Specifica le colonne da utilizzare per l'ordinazione durante la raccolta del parquet. Il valore deve essere un set delimitato da virgole di colonne condivise (ad esempio, 'STATE,CITY' o '"STATE","CITY").
`PROP_SHARE_TABLE_SHARE_COLUMNS`	`VARCHAR2(13)`	`'SHARE_COLUMNS'`	Specifica le colonne condivise. Il valore è un set delimitato da virgole di colonne condivise. Ad esempio, 'STATE,CITY' o '"STATE","CITY"
`PROP_SHARE_TABLE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	Eseguire l'override del livello di condivisione `split_size` per una tabella specifica. Il valore è un numero.
`PROP_SHARE_TABLE_GATHER_STATS`	`VARCHAR2(12)`	`'GATHER_STATS'`	Se Autonomous Database raccoglierà statistiche, il valore di `'GATHER_STATS'` è `'YES'.` Altrimenti, il valore è `'NO'`.
`PROP_SHARE_TABLE_SPLIT_ROWS`	`VARCHAR2(10)`	`'SPLIT_ROWS'`	La proprietà `SPLIT_ROWS` è un modo alternativo per specificare la quantità di dati da memorizzare in ogni file di parquet. Autonomous Database calcola il numero di righe in un determinato segmento (ad esempio, una partizione di una tabella o i risultati di una vista). Il numero di righe è diviso per `SPLIT_ROWS` e arrotondato per eccesso per produrre il "numero di frazionamenti". I dati nel segmento vengono quindi suddivisi in questo numero di suddivisioni utilizzando un metodo (ad esempio, ROWID, colonne di indice, colonne specificate e così via). Ogni pezzo di dati viene poi convertito in un file di parquet. Si consiglia di utilizzare la proprietà `SPLIT_SIZE` per controllare il numero di frazionamenti poiché questo riflette la quantità di dati in ogni riga. Una riga con 900 colonne di `VARCHAR2(4000)`, ad esempio, è molto più grande di una riga con una singola colonna di tipo `NUMBER(1)`. Utilizzare `SPLIT_ROWS` solo se è stata contabilizzata la quantità media di dati in ogni riga.
`PROP_SHARE_TABLE_FLASHBACK`	`VARCHAR2(9)`	`'FLASHBACK'`	La proprietà FLASHBACK determina se la tabella verrà pubblicata utilizzando query FLASHBACK per garantire la coerenza della lettura tra i diversi file di esportazione. Il valore deve essere `YES`, `NO` o `AUTO`. Se disponibile, l'impostazione `AUTO` utilizzerà il flashback. Se non è possibile eseguire il flashback sulla tabella o sulla vista, l'impostazione `YES` non riuscirà nella pubblicazione. L'impostazione `NO` non utilizzerà il flashback, il che significa che i file parquet potrebbero rappresentare snapshot diversi dei dati.

Tipi di condivisione

Costanti utilizzate durante la creazione della condivisione per identificare il tipo di condivisione.

Vedere CREATE_SHARE Procedura.

Nome	Tipo	Value	Descrizione
`SHARE_TYPE_VERSIONED`	`DBMS_ID`	`'VERSIONED'`	La condivisione viene utilizzata per la condivisione dei dati con controllo delle versioni.
`SHARE_TYPE_LIVE`	`DBMS_ID`	`'LIVE'`	La condivisione viene utilizzata per la condivisione di dati attivi.

Tipo ID condivisione

Utilizzato in ASSERT_SHARING_ID e GET_SHARING_ID.

Nome	Tipo	Value	Descrizione
`SHARING_ID_TYPE_TENANCY`	`VARCHAR2(7)`	`'TENANCY'`	L'ID di condivisione rappresenta una tenancy OCI.
`SHARING_ID_TYPE_COMPARTMENT`	`VARCHAR2(11)`	`'COMPARTMENT'`	L'ID condivisione rappresenta un compartimento OCI.
`SHARING_ID_TYPE_DATABASE`	`VARCHAR2(8)`	`'DATABASE'`	L'ID di condivisione rappresenta un Autonomous Database OCI.
`SHARING_ID_TYPE_REGION`	`VARCHAR2(6)`	`'REGION'`	L'ID condivisione rappresenta un'area OCI.

Accesso versione

Valori possibili per la proprietà di condivisione VERSION_ACCESS. Questo viene utilizzato per implementare il delta "viaggio nel tempo". Questi sono i valori validi associati a PROP_SHARE_VERSION_ACCESS e PROP_RECIPIENT_VERSION_ACCESS.

Questi possono essere utilizzati per abilitare la proprietà "version" nell'endpoint della query di condivisione delta, che consente ai destinatari di selezionare versioni specifiche dei dati invece di ricevere sempre la versione CURRENT. È necessario abilitare questa opzione sia per la condivisione che per il destinatario.

Ad esempio:

UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_SHARE_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);

UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_RECIPIENT_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);

Nome	Tipo	Value	Descrizione
`VERSION_ACCESS_CURRENT`	`PLS_INTEGER`	`1`	Un destinatario può visualizzare solo la versione corrente. (Predefinito)
`VERSION_ACCESS_ANY`	`PLS_INTEGER`	`2`	Un destinatario può scegliere qualsiasi versione CORRENTE o RETIRATA.

Documentazione dell'infrastruttura Oracle Cloud

DBMS_SHARE Costanti