DBMS_SHARE Constantes

Fichiers détachés

Constantes utilisées par la procédure PURGE_DETACHED_FILES.

Nom	Type	Valeur	Description
`PURGE_DROP`	`PLS_INTEGER`	`1`	Essayez de supprimer les fichiers à l'aide des informations d'identification indiquées. Si le fichier ne peut pas être supprimé, il continue d'être répertorié dans les vues `*_SHARE_DETACHED_FILES`.
`PURGE_DROP_FORCE`	`PLS_INTEGER`	`2`	Essayez de supprimer les fichiers à l'aide des informations d'identification indiquées. Le fichier est supprimé des vues `*_SHARE_DETACHED_FILES`, même si la tentative de suppression échoue à nouveau.
`PURGE_FORGET`	`PLS_INTEGER`	`3`	Enlevez les vues `*_SHARE_DETACHED_FILES` des fichiers sans essayer de les supprimer.

Niveau de journalisation

Constantes utilisées pour définir le niveau d'informations collectées dans le journal. Ces niveaux contrôlent le nombre d'événements qui sont connectés à ALL_SHARE_EVENTS et ALL_SHARE_RECIPIENTS.

Reportez-vous à Procédure SET_SHARE_LOG_LEVEL et à Procédure SET_RECIPIENT_LOG_LEVEL.

Nom	Type	Valeur	Description
`LOG_LEVEL_ERRORS_ONLY`	`PLS_INTEGER`	`0`	Permet de consigner uniquement les erreurs.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Consigner les erreurs et les informations de base.
`LOG_LEVEL_DETAIL`	`PLS_INTEGER`	`2`	Journaliser les erreurs et obtenir des détails supplémentaires.
`LOG_LEVEL_DEBUG`	`PLS_INTEGER`	`3`	Consigner le niveau de débogage des informations.

Propriétés du travail de partage

Propriétés utilisées dans la procédure UPDATE_SHARE_JOB_PROPERTY.

Nom	Type	Valeur	Description
`PROP_SHARE_JOB_DOP`	`VARCHAR2(7)`	`'JOB_DOP'`	La propriété `JOB_DOP` détermine le nombre de travaux `DBMS_SCHEDULER` utilisés pour publier le partage. Saisissez un numéro compris entre 1 et 5.
`PROP_SHARE_JOB_CLASS`	`VARCHAR2(9)`	`'JOB_CLASS'`	La propriété `JOB_CLASS` détermine la classe de travail du planificateur utilisée pour publier le partage. Pour obtenir la liste des valeurs valides, reportez-vous à `ALL_SCHEDULER_JOB_CLASSES`. La valeur par défaut est `DEFAULT_JOB_CLASS`.
`PROP_SHARE_JOB_PRIORITY`	`VARCHAR2(12)`	`'JOB_PRIORITY'`	La propriété `JOB_PRIORITY` détermine la priorité relative lorsque plusieurs partages du même utilisateur sont publiés en même temps. La valeur doit être un nombre, avec 0 comme valeur par défaut. Les actions avec une priorité plus élevée seront traitées avant les actions avec une priorité plus faible. Les actions ayant la même priorité sont traitées selon le principe du premier arrivé, premier servi. Valeurs standard de priorité d'emploi : `SHARE_PRIORITY_LOW CONSTANT NUMBER := 1; SHARE_PRIORITY_DEFAULT CONSTANT NUMBER := 2; SHARE_PRIORITY_HIGH CONSTANT NUMBER := 3;`

Propriétés de partage

Constantes utilisées pour indiquer les propriétés d'un partage.

Reportez-vous à Procédure UPDATE_SHARE_PROPERTY, Procédure UPDATE_DEFAULT_SHARE_PROPERTY et Fonction GET_SHARE_PROPERTY.

Nom	Type	Valeur	Description
`PROP_SHARE_DESC`	`VARCHAR2(11)`	`'DESCRIPTION'`	Description du partage visible localement.
`PROP_SHARE_PUBLIC_DESC`	`VARCHAR2(18)`	`'PUBLIC_DESCRIPTION'`	Description du partage visible en externe.
`PROP_SHARE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	La propriété `SPLIT_SIZE` détermine la taille des fichiers de parquet générés. L'algorithme fonctionne comme suit : L'optimiseur SQL estime la taille en octets d'un segment donné (par exemple, une partition d'une table ou les résultats d'une vue). Le nombre d'octets est divisé par `SPLIT_SIZE` et arrondi à la valeur supérieure pour générer le "nombre de fractionnements". Les données du segment sont ensuite divisées en ce "nombre de fractionnements" à l'aide d'une méthode (par exemple, ROWID, colonnes d'index, colonnes spécifiées, etc.). Chaque bloc de données est ensuite converti en fichier parquet. Notez que le fichier de parquet est généralement plus petit que `SPLIT_SIZE` en raison de la compression. En particulier, `SPLIT_SIZE` détermine la quantité de données avant la compression.
`PROP_SHARE_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	La propriété `LOG_LEVEL` détermine la quantité d'informations à journaliser dans le journal `ALL_SHARE_EVENTS`.
`PROP_SHARE_VERSION_ACCESS`	`VARCHAR2(14)`	`'VERSION_ACCESS'`	Les versions d'un partage publié qu'un destinataire peut voir.

Partager le type de demande pré-authentifiée du destinataire

Ces constantes sont les valeurs valides pour la propriété PROP_RECIPIENT_PAR_TYPE dans UPDATE_RECIPIENT_PROPERTY Procedure et GET_RECIPIENT_PROPERTY.

Nom	Type	Valeur	Description
`PAR_TYPE_FOLDER`	`PLS_INTEGER`	`1`	Les demandes pré-authentifiées donnent accès à l'ensemble du dossier.
`PAR_TYPE_FILE`	`PLS_INTEGER`	`2`	Les demandes pré-authentifiées donnent accès à un fichier à la fois.

Propriétés du destinataire du partage

Ces constantes sont utilisées dans fonction GET_SHARE_PROPERTY, procédure UPDATE_DEFAULT_SHARE_PROPERTY et procédure UPDATE_SHARE_PROPERTY.

Nom	Type	Valeur	Description
`PROP_RECIPIENT_PAR_LIFETIME`	`VARCHAR2(12)`	`'PAR_LIFETIME'`	Durée de vie des URL de demande pré-authentifiée envoyées au destinataire via l'API de partage delta. La valeur par défaut est de trois heures : '00 03:00:00'
`PROP_RECIPIENT_MIN_PAR_LIFETIME`	`VARCHAR2(16)`	`'MIN_PAR_LIFETIME'`	Durée de vie minimale garantie d'une URL de demande pré-authentifiée envoyée au destinataire via l'API de partage delta. Si une demande pré-authentifiée existe pour le même fichier de parquet, elle n'est réutilisée que si la durée de vie restante dépasse cette valeur minimale. La valeur par défaut est 2 1/2 heures : '00 02:30:00'
`PROP_RECIPIENT_MAX_PAR_LIFETIME`	`VARCHAR2(16)`	`'MAX_PAR_LIFETIME'`	Paramètre d'administrateur qui définit la durée de vie maximale autorisée pour un destinataire. La valeur par défaut est 1 jour : '01 00:00:00'
`PROP_RECIPIENT_TOKEN_LIFETIME`	`VARCHAR2(14)`	`'TOKEN_LIFETIME'`	Chaîne, au format INTERVAL DAY TO SECOND, représentant la durée de vie d'un jeton porteur de partage delta. La valeur par défaut est d'une heure : '01 00:00:00'.
`PROP_RECIPIENT_MAX_TOKEN_LIFETIME`	`VARCHAR2(18)`	`'MAX_TOKEN_LIFETIME'`	Paramètre d'administrateur qui définit la durée de vie maximale autorisée du jeton de support pour tout destinataire. La valeur par défaut est 90 jours : '90 00:00:00'
`PROP_RECIPIENT_EMAIL`	`VARCHAR2(5)`	`'EMAIL'`	Courriel du destinataire. Ceci est uniquement requis pour les destinataires de partage delta.
`PROP_RECIPIENT_DESCRIPTION`	`VARCHAR2(11)`	`'DESCRIPTION'`	Description textuelle du destinataire.
`PROP_RECIPIENT_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	Niveau de journalisation du destinataire. Cela contrôle ce qui est journalisé dans `USER_SHARE_RECIPIENT_EVENTS`. La valeur doit être l'une des constantes `LOG_LEVEL_*`.
`PROP_RECIPIENT_SHARING_ID`	`VARCHAR2(10)`	`'SHARING_ID'`	ID de partage du destinataire. Cette opération est uniquement requise pour les destinataires Autonomous Database.
`PROP_RECIPIENT_PAR_TYPE`	`VARCHAR2(8)`	`'PAR_TYPE'`	Type de demande pré-authentifiée à créer. Il doit s'agir de `PAR_TYPE_FOLDER` (valeur par défaut) ou `PAR_TYPE_FILE`.
`PROP_RECIPIENT_VERSION_ACCESS`	`VARCHAR2(14)`	`'VERSION_ACCESS'`	Indique les versions des partages publiés qu'un destinataire peut voir. L'une des valeurs suivantes : `VERSION_ACCESS_CURRENT` ou `VERSION_ACCESS_ANY`.

Propriétés de la table de partage

Constantes utilisées pour indiquer les propriétés de la table de partage. Ils sont utilisés par la fonction GET_SHARE_TABLE_PROPERTY et la procédure UPDATE_SHARE_TABLE_PROPERTY.

Nom	Type	Valeur	Description
`PROP_SHARE_TABLE_SPLIT_METHOD`	`VARCHAR2(12)`	`'SPLIT_METHOD'`	Indique comment un segment doit être divisé en différents fichiers.
`SPLIT_METHOD_AUTO`	`VARCHAR2(4)`	`'AUTO'`	Autonomous Database détermine la manière dont les segments sont fractionnés.
`SPLIT_METHOD_RANGE`	`VARCHAR2(5)`	`'RANGE'`	Fractionner les segments en fonction des fourchettes de valeurs. Les plages exactes sont déterminées en analysant les histogrammes de données. Cette méthode requiert la spécification d'un ou de plusieurs éléments `split_columns`.
`SPLIT_METHOD_ROWID`	`VARCHAR2(5)`	`'ROWID'`	Fractionnez les segments en fonction de `ROWID`.
`SPLIT_METHOD_HASH`	`VARCHAR2(4)`	`'HASH'`	Fractionner les segments en fonction des valeurs HASH. Cette méthode requiert la spécification d'un ou de plusieurs éléments `split_columns`.
`SPLIT_METHOD_VALUE`	`VARCHAR2(5)`	`'VALUE'`	Fractionner les segments en fonction de valeurs distinctes. Cette méthode requiert la spécification d'un ou de plusieurs éléments `split_columns`.
`PROP_SHARE_TABLE_SPLIT_COLUMNS`	`VARCHAR2(13)`	`'SPLIT_COLUMNS'`	Indique les colonnes utilisées pour le fractionnement. Ils sont requis pour les méthodes RANGE, VALUE et HASH. La valeur doit être un ensemble de colonnes partagées séparées par des virgules (par exemple, 'STATE,CITY' ou '"STATE","CITY"").
`PROP_SHARE_TABLE_ORDER_COLUMNS`	`VARCHAR2(13)`	`'ORDER_COLUMNS'`	Indique les colonnes utilisées pour le tri lors de la collecte du parquet. La valeur doit être un ensemble de colonnes partagées séparées par des virgules (par exemple, 'STATE,CITY' ou '"STATE","CITY"").
`PROP_SHARE_TABLE_SHARE_COLUMNS`	`VARCHAR2(13)`	`'SHARE_COLUMNS'`	Indique les colonnes partagées. La valeur est un ensemble de colonnes partagées séparées par des virgules. Par exemple, 'STATE,CITY' ou '"STATE","CITY".
`PROP_SHARE_TABLE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	Remplacez le niveau de partage `split_size` pour une table spécifique. La valeur est un nombre.
`PROP_SHARE_TABLE_GATHER_STATS`	`VARCHAR2(12)`	`'GATHER_STATS'`	Si Autonomous Database collecte des statistiques, la valeur de `'GATHER_STATS'` est `'YES'.`. Sinon, la valeur est `'NO'`.
`PROP_SHARE_TABLE_SPLIT_ROWS`	`VARCHAR2(10)`	`'SPLIT_ROWS'`	La propriété `SPLIT_ROWS` permet de spécifier la quantité de données à stocker dans chaque fichier de parquet. Autonomous Database calcule le nombre de lignes dans un segment donné (par exemple, une partition d'une table ou les résultats d'une vue). Le nombre de lignes est divisé par `SPLIT_ROWS` et arrondi à la valeur supérieure pour générer le "nombre de fractionnements". Les données du segment sont ensuite divisées en ce nombre de fractionnements à l'aide d'une méthode (par exemple, ROWID, colonnes d'index, colonnes spécifiées, etc.) Chaque bloc de données est ensuite converti en fichier parquet. Il est recommandé d'utiliser la propriété `SPLIT_SIZE` pour contrôler le nombre de fractionnements car cela reflète la quantité de données dans chaque ligne. Une ligne contenant 900 colonnes de `VARCHAR2(4000)`, par exemple, est beaucoup plus grande qu'une ligne contenant une seule colonne de type `NUMBER(1)`. Utilisez `SPLIT_ROWS` uniquement si vous avez pris en compte la quantité moyenne de données dans chaque ligne.
`PROP_SHARE_TABLE_FLASHBACK`	`VARCHAR2(9)`	`'FLASHBACK'`	La propriété FLASHBACK détermine si la table sera publiée à l'aide d'interrogations FLASHBACK afin de garantir la cohérence en lecture entre les différents fichiers d'export. La valeur doit être `YES`, `NO` ou `AUTO`. Le paramètre `AUTO` utilise le flashback s'il est disponible. Le paramètre `YES` entraîne l'échec de la publication si le flashback n'est pas possible sur la table ou la vue. Le paramètre `NO` n'utilise pas Flashback, ce qui signifie que les fichiers parquet peuvent représenter différents instantanés des données.

Types de partage

Constantes utilisées lors de la création du partage pour identifier le type de partage.

Reportez-vous à Procédure CREATE_SHARE.

Nom	Type	Valeur	Description
`SHARE_TYPE_VERSIONED`	`DBMS_ID`	`'VERSIONED'`	Le partage est utilisé pour partager des données avec numéro de version.
`SHARE_TYPE_LIVE`	`DBMS_ID`	`'LIVE'`	Le partage est utilisé pour partager des données en direct.

Type d'ID de partage

Utilisé dans ASSERT_SHARING_ID et GET_SHARING_ID.

Nom	Type	Valeur	Description
`SHARING_ID_TYPE_TENANCY`	`VARCHAR2(7)`	`'TENANCY'`	L'ID de partage représente une location OCI.
`SHARING_ID_TYPE_COMPARTMENT`	`VARCHAR2(11)`	`'COMPARTMENT'`	L'ID de partage représente un compartiment OCI.
`SHARING_ID_TYPE_DATABASE`	`VARCHAR2(8)`	`'DATABASE'`	L'ID de partage représente une instance OCI Autonomous Database.
`SHARING_ID_TYPE_REGION`	`VARCHAR2(6)`	`'REGION'`	L'ID de partage représente une région OCI.

Accès aux versions

Valeurs possibles pour la propriété de partage VERSION_ACCESS. Ceci est utilisé pour implémenter le delta "voyage dans le temps". Valeurs valides associées à PROP_SHARE_VERSION_ACCESS et PROP_RECIPIENT_VERSION_ACCESS.

Ils peuvent être utilisés pour activer la propriété "version" dans l'adresse de requête de partage delta, ce qui permet aux destinataires de sélectionner des versions spécifiques des données au lieu de toujours recevoir la version ACTUELLE. Vous devez l'activer à la fois sur le partage et le destinataire.

Par exemple :

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

Nom	Type	Valeur	Description
`VERSION_ACCESS_CURRENT`	`PLS_INTEGER`	`1`	Un destinataire ne peut voir que la version actuelle. (Valeur par défaut)
`VERSION_ACCESS_ANY`	`PLS_INTEGER`	`2`	Un destinataire peut choisir n'importe quelle version ACTUELLE ou RETIRED.

Documentation Oracle Cloud Infrastructure

DBMS_SHARE Constantes