Constantes DBMS

Fichiers détachés

Constantes utilisées par la procédure PURGE_DETACHED_FILES.

Le nom	Type	Valeur	Description
`PURGE_DROP`	`PLS_INTEGER`	`1`	Tentative de suppression des fichiers à l'aide des données d'identification spécifié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`	Tentative de suppression des fichiers à l'aide des données d'identification spécifié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 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.

Voir Procédure SET_SHARE_LOG_LEVEL et Procédure SET_RECIPIENT_LOG_LEVEL.

Le nom	Type	Valeur	Description
`LOG_LEVEL_ERRORS_ONLY`	`PLS_INTEGER`	`0`	Seules les erreurs de journal.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Sert à consigner les erreurs et les données de base.
`LOG_LEVEL_DETAIL`	`PLS_INTEGER`	`2`	Enregistrer les erreurs et les détails supplémentaires.
`LOG_LEVEL_DEBUG`	`PLS_INTEGER`	`3`	Enregistrer le niveau d'informations de débogage.

Partager les propriétés de la tâche

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

Le nom	Type	Valeur	Description
`PROP_SHARE_JOB_DOP`	`VARCHAR2(7)`	`'JOB_DOP'`	La propriété `JOB_DOP` détermine le nombre de tâches `DBMS_SCHEDULER` utilisées pour publier le partage. Il doit s'agir d'un nombre 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 programmateur utilisée pour publier le partage. Voir `ALL_SCHEDULER_JOB_CLASSES` pour une liste des valeurs valides. 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 deux partages ou plus 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 ayant une priorité plus élevée seront traitées avant les actions ayant une priorité plus faible. Les actions ayant la même priorité sont traitées sur la base 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;`

Partager les propriétés

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

Voir Procédure UPDATE_SHARE_PROPERTY, Procédure UPDATE_DEFAULT_SHARE_PROPERTY et Fonction GET_SHARE_PROPERTY.

Le nom	Type	Valeur	Description
`PROP_SHARE_DESC`	`VARCHAR2(11)`	`'DESCRIPTION'`	Description visible localement du partage.
`PROP_SHARE_PUBLIC_DESC`	`VARCHAR2(18)`	`'PUBLIC_DESCRIPTION'`	Description visible à l'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 à l'unité supérieure pour produire le "nombre de fractionnements". Les données du segment sont ensuite fragmentées dans ce "nombre de fractionnements" à l'aide d'une méthode (par exemple, ROWID, colonnes d'index, colonnes spécifiées, etc.). Chaque fragment de données est ensuite converti en fichier parquet. Notez que 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 la compression.
`PROP_SHARE_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	La propriété `LOG_LEVEL` détermine la quantité d'informations qui seront enregistré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.

Le nom	Type	Valeur	Description
`PAR_TYPE_FOLDER`	`PLS_INTEGER`	`1`	Les demandes préauthentifiées permettent d'accéder au dossier complet.
`PAR_TYPE_FILE`	`PLS_INTEGER`	`2`	Les demandes préauthentifiées permettent d'accéder à un fichier à la fois.

Propriétés du destinataire de partage

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

Le 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 au moyen de 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 des URL de demande préauthentifiée envoyées au destinataire au moyen de l'API de partage delta. S'il existe une demande préauthentifiée pour le même fichier de parquet, elle est réutilisée seulement 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 tout 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 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 du porteur 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 n'est requis que pour les destinataires de partage delta.
`PROP_RECIPIENT_DESCRIPTION`	`VARCHAR2(11)`	`'DESCRIPTION'`	Texte de description du destinataire.
`PROP_RECIPIENT_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	Niveau de journalisation pour le 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 partage du destinataire. Cela n'est requis que pour les destinataires de base de données IA autonome.
`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. Un de `VERSION_ACCESS_CURRENT` ou `VERSION_ACCESS_ANY`.

Partager les propriétés de table

Constantes utilisées pour indiquer les propriétés de partage de table. Ceux-ci sont utilisés par GET_SHARE_TABLE_PROPERTY Function et UPDATE_SHARE_TABLE_PROPERTY Procedure.

Le nom	Type	Valeur	Description
`PROP_SHARE_TABLE_SPLIT_METHOD`	`VARCHAR2(12)`	`'SPLIT_METHOD'`	Indique comment un segment doit être fractionné en différents fichiers.
`SPLIT_METHOD_AUTO`	`VARCHAR2(4)`	`'AUTO'`	La base de données autonome d'IA détermine la façon dont les segments sont fractionnés.
`SPLIT_METHOD_RANGE`	`VARCHAR2(5)`	`'RANGE'`	Fractionner les segments en fonction des intervalles de valeurs. Les plages exactes sont déterminées par l'analyse des histogrammes de données. Cette méthode nécessite qu'un ou plusieurs `split_columns` soient spécifiés.
`SPLIT_METHOD_ROWID`	`VARCHAR2(5)`	`'ROWID'`	Segments fractionnés en fonction de `ROWID`.
`SPLIT_METHOD_HASH`	`VARCHAR2(4)`	`'HASH'`	Fractionner les segments en fonction des valeurs HASH. Cette méthode nécessite qu'un ou plusieurs `split_columns` soient spécifiés.
`SPLIT_METHOD_VALUE`	`VARCHAR2(5)`	`'VALUE'`	Fractionner les segments en fonction de valeurs distinctes. Cette méthode nécessite qu'un ou plusieurs `split_columns` soient spécifiés.
`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 jeu de colonnes partagées délimitées par des virgules (par exemple, 'STATE,CITY' ou '"STATE","CITY"').
`PROP_SHARE_TABLE_ORDER_COLUMNS`	`VARCHAR2(13)`	`'ORDER_COLUMNS'`	Spécifie les colonnes à trier lors de la collecte du parquet. La valeur doit être un jeu de colonnes partagées délimitées par des virgules (par exemple, 'STATE,CITY' ou '"STATE","CITY"').
`PROP_SHARE_TABLE_SHARE_COLUMNS`	`VARCHAR2(13)`	`'SHARE_COLUMNS'`	Indique quelles colonnes sont partagées. La valeur est un jeu de colonnes partagées délimitées par des virgules. Par exemple, "État, ville" ou "État", "VILLE".
`PROP_SHARE_TABLE_SPLIT_SIZE`	`VARCHAR2(10)`	`'SPLIT_SIZE'`	Remplacer 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 AI 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 AI 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 rangées est divisé par `SPLIT_ROWS` et arrondi au nombre supérieur pour produire le "nombre de fractionnements". Les données du segment sont ensuite fragmentées en ce nombre de fractionnements à l'aide d'une méthode (par exemple, ROWID, colonnes d'index, colonnes spécifiées, etc.) Chaque fragment 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 rangée. Par exemple, une rangée avec 900 colonnes de `VARCHAR2(4000)` est beaucoup plus grande qu'une rangée avec une seule colonne de type `NUMBER(1)`. N'utilisez `SPLIT_ROWS` que si vous avez comptabilisé la quantité moyenne de données dans chaque rangée.
`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 garantir la cohérence en lecture entre les différents fichiers d'exportation. La valeur doit être `YES`, `NO` ou `AUTO`. Le paramètre `AUTO` utilisera Flashback s'il est disponible. Le paramètre `YES` entraînera l'échec de la publication si le flashback n'est pas possible sur la table ou la vue. Le paramètre `NO` n'utilisera 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.

Voir ProcédureCREATE_SHARE.

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

Utilisé dans ASSERT_SHARING_ID et GET_SHARING_ID.

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

Accès à la version

Valeurs possibles pour la propriété de partage VERSION_ACCESS. Ceci est utilisé pour mettre en œuvre le delta "voyage dans le temps". Il s'agit des valeurs valides associées à PROP_SHARE_VERSION_ACCESS et PROP_RECIPIENT_VERSION_ACCESS.

Ceux-ci peuvent être utilisés pour activer la propriété "version" dans le point d'extrémité d'interrogation 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 activer cette option à la fois pour le partage et pour 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);

Le 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 ABANDONNÉE.

Documentation sur Oracle Cloud Infrastructure

Constantes DBMS_SHARE