DBMS_SHARE Costanti

File scollegati

Costanti utilizzate dalla procedura PURGE_DETACHED_FILES.

Nome	Digita	Valore	descrizione;
`PURGE_DROP`	`PLS_INTEGER`	`1`	Tentativo di eliminare i file utilizzando la credenziale specificata. Se non è possibile eliminare il file, 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 eliminazione del file non riesce di nuovo.
`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 Procedura SET_RECIPIENT_LOG_LEVEL.

Nome	Digita	Valore	descrizione;
`LOG_LEVEL_ERRORS_ONLY`	`PLS_INTEGER`	`0`	Solo errori.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Registra errori 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 debug delle informazioni.

Condividi proprietà mansione

Proprietà utilizzate nella procedura UPDATE_SHARE_JOB_PROPERTY.

Nome	Digita	Valore	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. Questo dovrebbe 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, 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;`

Condividi proprietà

Costanti utilizzate per indicare le proprietà di una condivisione.

Vedere UPDATE_SHARE_PROPERTY Procedura, UPDATE_DEFAULT_SHARE_PROPERTY Procedura e GET_SHARE_PROPERTY Funzione.

Nome	Digita	Valore	descrizione;
`PROP_SHARE_DESC`	`VARCHAR2(11)`	`'DESCRIPTION'`	Una descrizione della condivisione visibile in locale.
`PROP_SHARE_PUBLIC_DESC`	`VARCHAR2(18)`	`'PUBLIC_DESCRIPTION'`	Una descrizione visibile esternamente della condivisione.
`PROP_SHARE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	La proprietà `SPLIT_SIZE` determina la dimensione dei file di parquet generati. L'algoritmo viene descritto di seguito. L'ottimizzatore SQL 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 viene diviso per il valore `SPLIT_SIZE` e arrotondato per eccesso per produrre il "numero di divisioni". I dati nel segmento vengono quindi suddivisi in chunk in questo "numero di divisioni" utilizzando un metodo (ad esempio ROWID, colonne di indice, colonne specificate e così via). Ogni pezzo di dati viene quindi convertito in un file di parquet. Si noti che il file del 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 possono essere visualizzate da un destinatario.

Condividi tipo PAR destinatario

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

Nome	Digita	Valore	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 Funzione GET_SHARE_PROPERTY, Procedura UPDATE_DEFAULT_SHARE_PROPERTY e Procedura UPDATE_SHARE_PROPERTY.

Nome	Digita	Valore	descrizione;
`PROP_RECIPIENT_PAR_LIFETIME`	`VARCHAR2(12)`	`'PAR_LIFETIME'`	Durata degli URL di richiesta preautenticati inviati al destinatario tramite l'API di condivisione delta. Il valore predefinito è 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 per lo stesso file di parquet, viene riutilizzata solo se la durata rimanente supera questo valore minimo. L'impostazione predefinita è 2 1/2 ore: '00 02:30:00'
`PROP_RECIPIENT_MAX_PAR_LIFETIME`	`VARCHAR2(16)`	`'MAX_PAR_LIFETIME'`	Impostazione dell'amministratore che definisce la durata massima consentita del parametro 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 al 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 del portatore per qualsiasi destinatario. Il valore predefinito è 90 giorni: '90 00:00:00'
`PROP_RECIPIENT_EMAIL`	`VARCHAR2(5)`	`'EMAIL'`	E-mail del destinatario. Questa opzione è obbligatoria solo per i destinatari della condivisione delta.
`PROP_RECIPIENT_DESCRIPTION`	`VARCHAR2(11)`	`'DESCRIPTION'`	Descrizione di testo del destinatario.
`PROP_RECIPIENT_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	Il livello di log per il destinatario. Controlla gli elementi che vengono registrati 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 opzione è obbligatoria solo per i destinatari di Autonomous Database.
`PROP_RECIPIENT_PAR_TYPE`	`VARCHAR2(8)`	`'PAR_TYPE'`	Tipo di richiesta preautenticata da creare. Deve essere una delle opzioni `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 condivisione

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

Nome	Digita	Valore	descrizione;
`PROP_SHARE_TABLE_SPLIT_METHOD`	`VARCHAR2(12)`	`'SPLIT_METHOD'`	Specifica la modalità di suddivisione di 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'`	Suddividere 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'`	Suddividere i segmenti in base a `ROWID`.
`SPLIT_METHOD_HASH`	`VARCHAR2(4)`	`'HASH'`	Suddividere 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 quali colonne vengono utilizzate per ordinare quando si raccoglie il 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'`	Sostituisce il 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à le statistiche, il valore di `'GATHER_STATS'` è `'YES'.` In caso contrario, 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 viene diviso per il valore `SPLIT_ROWS` e arrotondato per eccesso per produrre il "numero di divisioni". I dati nel segmento vengono quindi suddivisi in chunk in questo numero di divisioni utilizzando un metodo (ad esempio, ROWID, colonne di indice, colonne specificate e così via). Ogni pezzo di dati viene quindi convertito in un file di parquet. Si consiglia di utilizzare la proprietà `SPLIT_SIZE` per controllare il numero di frazionamenti, in quanto 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 sola 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 di FLASHBACK per garantire la coerenza di lettura tra i diversi file di esportazione. Il valore deve essere `YES`, `NO` o `AUTO`. L'impostazione `AUTO` utilizzerà il flashback, se disponibile. L'impostazione `YES` causerà l'errore della pubblicazione se non è possibile eseguire il flashback sulla tabella o sulla vista. L'impostazione `NO` non utilizzerà il flashback, il che significa che i file di parquet potrebbero rappresentare istantanee diverse dei dati.

Tipi di condivisione

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

Vedere CREATE_SHARE Procedura.

Nome	Digita	Valore	descrizione;
`SHARE_TYPE_VERSIONED`	`DBMS_ID`	`'VERSIONED'`	La condivisione viene utilizzata per la condivisione dei dati con versione.
`SHARE_TYPE_LIVE`	`DBMS_ID`	`'LIVE'`	La condivisione viene utilizzata per la condivisione dei dati in tempo reale.

Tipo ID condivisione

Utilizzato in ASSERT_SHARING_ID e GET_SHARING_ID.

Nome	Digita	Valore	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 di 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 alla versione

Valori possibili per la proprietà di condivisione VERSION_ACCESS. Questo è usato per implementare delta "viaggi 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 CORRENTE. È 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	Digita	Valore	descrizione;
`VERSION_ACCESS_CURRENT`	`PLS_INTEGER`	`1`	Un destinatario può visualizzare solo la versione CORRENTE. Questo è il valore predefinito.
`VERSION_ACCESS_ANY`	`PLS_INTEGER`	`2`	Un destinatario può scegliere qualsiasi versione CORRENTE o RETIRATA.

Documentazione di Oracle Cloud Infrastructure

DBMS_SHARE Costanti