Constantes DBMS

Fichiers détachés

Constantes utilisées par la procédure PURGE_DETACHED_FILES.

Nom	Type	Valeur	Description
`PURGE_DROP`	`PLS_INTEGER`	`1`	Tentez 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`	Tentez 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 du fichier échoue à nouveau.
`PURGE_FORGET`	`PLS_INTEGER`	`3`	Supprimez les vues `*_SHARE_DETACHED_FILES` des fichiers sans tenter de les supprimer.

Niveau du journal

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`	Consigner uniquement les erreurs.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Journaliser les erreurs et les informations de base.
`LOG_LEVEL_DETAIL`	`PLS_INTEGER`	`2`	Journaliser les erreurs et les détails supplémentaires.
`LOG_LEVEL_DEBUG`	`PLS_INTEGER`	`3`	Niveau d'informations de débogage du journal.

Partager les propriétés de l'emploi

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 d'un 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 pour la 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 externe du partage.
`PROP_SHARE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	La propriété `SPLIT_SIZE` détermine la taille des fichiers 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 produire le "nombre de fractionnements". Les données du segment sont ensuite découpées en "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. Le fichier 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 compression.
`PROP_SHARE_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	La propriété `LOG_LEVEL` détermine la quantité d'informations qui seront journalisées 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 Procédure UPDATE_RECIPIENT_PROPERTY 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.

Partager les propriétés du destinataire

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ées envoyées au destinataire via l'API de partage delta. La valeur par défaut est 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. S'il existe une demande pré-authentifiée pour le même fichier parquet, elle est réutilisée uniquement 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 nominale 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 d'un jeton porteur pour un destinataire. La valeur par défaut est 90 jours : '90 00:00:00'
`PROP_RECIPIENT_EMAIL`	`VARCHAR2(5)`	`'EMAIL'`	Le courriel du destinataire. Ceci n'est requis que 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 connecté à `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 de `PAR_TYPE_FILE`.
`PROP_RECIPIENT_VERSION_ACCESS`	`VARCHAR2(14)`	`'VERSION_ACCESS'`	Spécifie les versions des partages publiés qu'un destinataire peut voir. `VERSION_ACCESS_CURRENT` ou `VERSION_ACCESS_ANY`.

Propriétés des tables de partage

Constantes utilisées pour indiquer les propriétés de la table de partage. Elles sont utilisées 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'au moins `split_columns`.
`SPLIT_METHOD_ROWID`	`VARCHAR2(5)`	`'ROWID'`	Fractionner 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'au moins `split_columns`.
`SPLIT_METHOD_VALUE`	`VARCHAR2(5)`	`'VALUE'`	Fractionner les segments en fonction de valeurs distinctes. Cette méthode requiert la spécification d'au moins `split_columns`.
`PROP_SHARE_TABLE_SPLIT_COLUMNS`	`VARCHAR2(13)`	`'SPLIT_COLUMNS'`	Indique les colonnes utilisées pour le fractionnement. Elles sont requises 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'`	Spécifie 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 à partager. 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` est une autre façon de spécifier la quantité de données à stocker dans chaque fichier 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 produire le "nombre de fractionnements". Les données du segment sont ensuite découpées dans 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 avec 900 colonnes de `VARCHAR2(4000)`, par exemple, est beaucoup plus grande qu'une ligne avec 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 pour assurer la cohérence en lecture entre les différents fichiers d'export. La valeur doit être `YES`, `NO` ou `AUTO`. Le paramètre `AUTO` utilisera 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 le flashback, ce qui signifie que les fichiers parquet peuvent représenter différents instantanés des données.

Partager les types

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 des versions.
`SHARE_TYPE_LIVE`	`DBMS_ID`	`'LIVE'`	Le partage est utilisé pour partager des données réelles.

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". Il s'agit des 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 sur le destinataire.

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

Documentation Oracle Cloud Infrastructure

Constantes DBMS_SHARE