Documentation Oracle Cloud Infrastructure

Récapitulatif des sous-programmes de fournisseur de partage

Ce tableau répertorie les procédures et fonctions de package DBMS_SHARE utilisées pour produire des partages pour les destinataires.

Sous-programme Description
ADD_TO_SHARE Procédure Ajoutez une table ou une vue à un partage.
ASSERT_SHAREABLE_OBJECT Procédure Retour sans erreur, si l'objet existe et peut être partagé.
ASSERT_SHARING_ID Procédure Exécutez des vérifications de validation de base sur un ID de partage et renvoyez-en un sous forme canonique.
Fonction CAN_CREATE_SHARE Cette fonction vérifie si le schéma en cours peut créer des destinataires de partage.
Fonction CAN_CREATE_SHARE_RECIPIENT Cette fonction vérifie si le schéma en cours peut créer des destinataires de partage.
CLEAR_RECIPIENT_EVENTS Procédure Effacez les événements du journal des événements du destinataire du partage.
CLEAR_SHARE_EVENTS Procédure Effacez les événements du journal des événements de partage.
CREATE_BEARER_TOKEN_CREDENTIAL Procédure Créez des informations d'identification utilisables avec les fournisseurs de partage delta.
CREATE_CLOUD_STORAGE_LINK Procédure Créez un lien d'URI de stockage cloud nommé.
CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Procédure Créez ou remplacez un URI de stockage cloud nommé.
CREATE_OR_REPLACE_SHARE_RECIPIENT Procédure Créez ou remplacez un destinataire de partage.
CREATE_SHARE Procédure Créez un objet de partage nommé.
CREATE_SHARE_RECIPIENT Procédure Créez un destinataire de partage.
DROP_CLOUD_STORAGE_LINK Procédure Supprimer un lien de stockage cloud.
DROP_RECIPIENT Procédure Supprimer un destinataire.
DROP_SHARE Procédure Supprimer un partage et son contenu.
DROP_SHARE_LINK_VIEW Procédure Supprimez une vue créée par la procédure CREATE_SHARE_LINK_VIEW.
DROP_SHARE_VERSION Procédure Supprimer une version de partage unique.
DROP_SHARE_VERSIONS Procédure Supprimez une plage de versions de partage.
DROP_UNUSED_SHARE_VERSIONS Procédure Supprimez toute version de partage qui n'est pas en cours d'utilisation.
ENABLE_SCHEMA Procédure Activer ou désactiver un schéma pour le partage.
Fonction GET_ACTIVATION_LINK Générez le lien qui est placé dans les e-mails au destinataire autorisé.
Fonction GET_PUBLISHED_IDENTITY Obtenez des données sur l'utilisateur en cours qui a été défini par SET_PUBLISHED_IDENTITY.
Fonction GET_RECIPIENT_PROPERTY Renvoie la valeur d'une propriété pour un destinataire.
Fonction GET_SHARE_PROPERTY Obtenez la valeur de propriété d'un partage existant.
Fonction GET_SHARE_TABLE_PROPERTY Obtient la valeur de propriété d'une table de partage existante.
GRANT_TO_RECIPIENT Procédure Accordez l'accès à un partage à un destinataire spécifique.
POPULATE_SHARE_PROFILE Procédure Générer un profil delta pour un destinataire.
PUBLISH_SHARE Procédure Publiez un partage et revenez immédiatement.
PUBLISH_SHARE_WAIT Procédure Publiez un partage et attendez que le travail en arrière-plan soit terminé.
PURGE_DETACHED_FILES Procédure Supprimez ou ou ou oubliez les fichiers de parquet qui se sont détachés de leurs partages.
REMOVE_FROM_SHARE Procédure Enlevez une table ou une vue d'un partage.
RENAME_RECIPIENT Procédure Renommez un destinataire.
RENAME_SHARE Procédure Renommez un partage.
RENAME_SHARE_LINK Procédure Renommez un lien de partage enregistré.
RENAME_SHARE_SCHEMA Procédure Renommez un schéma de partage.
RENAME_SHARE_TABLE Procédure Renommez une table de partage.
REVOKE_FROM_RECIPIENT Procédure Révoquer l'accès d'un partage à un destinataire spécifique.
SET_CURRENT_SHARE_VERSION Procédure Modifier la version actuelle d'un partage.
SET_PUBLISHED_IDENTITY Procédure Définissez les données relatives à l'utilisateur actuel qui seront fournies aux destinataires des partages ORACLE publiés.
SET_RECIPIENT_LOG_LEVEL Procédure Modifiez le niveau de journalisation d'un destinataire de partage existant.
SET_SHARE_LOG_LEVEL Procédure Modifiez le niveau de journalisation d'un partage existant.
SET_STORAGE_CREDENTIAL Procédure Définissez le nom des informations d'identification d'accès pour le stockage donné.
STOP_JOB Procédure Arrêter un travail de partage en cours d'exécution.
UNPUBLISH_SHARE Procédure Annuler la publication d'un partage.
UPDATE_DEFAULT_RECIPIENT_PROPERTY Procédure Mettez à jour les valeurs de propriété de destinataire par défaut.
UPDATE_DEFAULT_SHARE_PROPERTY Procédure Mettez à jour les valeurs de propriété de partage par défaut.
UPDATE_RECIPIENT_PROPERTY Procédure Mettre à jour une propriété d'un destinataire existant.
UPDATE_SHARE_JOB_PROPERTY Procédure Modifier les propriétés d'un travail de partage en cours d'exécution.
UPDATE_SHARE_PROPERTY Procédure Mettre à jour une propriété d'un partage existant.
UPDATE_SHARE_TABLE_PROPERTY Procédure Mettez à jour la valeur de propriété d'une table de partage existante.
Fonction VALIDATE_CREDENTIAL Validez un nom d'informations d'identification et convertissez-le en formulaire préétabli si nécessaire.
VALIDATE_SHARE_STORAGE Procédure Vérifiez si le stockage donné est adapté aux partages avec numéro de version.
WAIT_FOR_JOB Procédure Cette procédure attend que le travail de partage spécifié soit terminé.

Rubrique parent : Package DBMS_SHARE

ADD_TO_SHARE Procédure

Ajoutez une table ou une vue à un partage. L'objet devient visible pour tout utilisateur externe auquel l'accès au partage a été accordé.

Syntaxe

PROCEDURE ADD_TO_SHARE  
(
    share_name           IN VARCHAR2,
    table_name           IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    share_table_name     IN VARCHAR2 := NULL,
    share_schema_name    IN VARCHAR2 := NULL,
    object_metadata      IN SYS.JSON_OBJECT_T := NULL,
    replace_existing     IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom d'un partage existant auquel l'objet est accordé.
table_name Nom de l'entité à partager (par exemple, un nom de table ou de vue).
owner Propriétaire de l'entité à partager. La valeur par défaut est le schéma en cours.
share_table_name Nom visible en externe de la table. Par défaut, il s'agit de table_name en majuscules.
share_schema_name Schéma visible en externe dans lequel la table sera placée. Par défaut, il s'agit du propriétaire de table en majuscules. Le schéma est créé automatiquement s'il n'existe pas déjà.
object_metadata Métadonnées facultatives à associer à l'entité partagée.
replace_existing Si la valeur est TRUE et que cette valeur share_table_name existe déjà, la valeur table_name existante est supprimée du partage et remplacée par cette valeur table_name.

Si la valeur est FALSE et que cette valeur share_table_name existe déjà, une exception est générée pour indiquer que la table de partage est déjà utilisée.

share_owner Propriétaire du partage.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel afin de rendre la modification visible.

ASSERT_SHAREABLE_OBJECT Procédure

Retour sans erreur, si l'objet existe et peut être partagé.

Syntaxe

PROCEDURE ASSERT_SHAREABLE_OBJECT
(
  object_name          IN VARCHAR2,
  object_owner         IN VARCHAR2 := NULL
);

Paramètres

Paramètre Description
object_name Nom de l'objet.
object_owner Propriétaire de l'objet. La valeur par défaut est le schéma en cours.

ASSERT_SHARING_ID Procédure

Exécutez des vérifications de validation de base sur un ID de partage et renvoyez-en un sous forme canonique. Une exception est générée si l'ID n'est pas valide.

Syntaxe

PROCEDURE ASSERT_SHARING_ID  
(
    sharing_id              IN OUT NOCOPY VARCHAR2,
    out_sharing_id_type     IN OUT NOCOPY VARCHAR2  
);

Paramètres

Paramètre Description
sharing_id ID à vérifier.
out_sharing_id_type Type de l'ID, s'il est valide. Par exemple, TENANCY ou DATABASE.

Fonction CAN_CREATE_SHARE

Cette fonction vérifie si le schéma en cours peut créer des destinataires de partage. Si des partages peuvent être créés, 1 est renvoyé et 0 dans le cas contraire.

Syntaxe

FUNCTION CAN_CREATE_SHARE
RETURN NUMBER;

Exemple : avant et après l'activation du schéma d'administration

SQL> select dbms_share.can_create_share from dual;
 CAN_CREATE_SHARE
----------------
               0 
SQL> exec dbms_share.enable_schema('admin') 
PL/SQL procedure successfully completed. 
SQL> select dbms_share.can_create_share from dual; 
CAN_CREATE_SHARE
----------------
               1

Fonction CAN_CREATE_SHARE_RECIPIENT

Cette fonction vérifie si le schéma en cours peut créer des destinataires de partage. Si des partages peuvent être créés, 1 est renvoyé et 0 dans le cas contraire.

Syntaxe

FUNCTION CAN_CREATE_SHARE_RECIPIENT
RETURN NUMBER;

CLEAR_RECIPIENT_EVENTS Procédure

Effacez les événements du journal des événements du destinataire du partage.

Syntaxe

PROCEDURE CLEAR_RECIPIENT_EVENTS 
(
   recipient_name       IN VARCHAR2,
   from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
   to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
   recipient_owner      IN VARCHAR2 := NULL 
);

Paramètres

Paramètre Description
recipient_name Nom local du destinataire du partage.
from_time Heure au plus tôt pour les événements qui doivent être effacés ou NULL.
to_time Heure la plus récente pour les événements qui doivent être effacés ou NULL.
recipient_owner Schéma auquel le destinataire appartient.

CLEAR_SHARE_EVENTS Procédure

Effacez les événements du journal des événements de partage.

Syntaxe

PROCEDURE CLEAR_SHARE_EVENTS 
(
    share_name           IN VARCHAR2,
    from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
    to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
    share_owner          IN VARCHAR2 := NULL 
);

Paramètres

Paramètre Description
share_name Nom du partage.
from_time Heure au plus tôt pour les événements qui doivent être effacés ou NULL.
to_time Heure la plus récente pour les événements qui doivent être effacés ou NULL.
share_owner Schéma auquel le partage appartient.

CREATE_BEARER_TOKEN_CREDENTIAL Procédure

Créez des informations d'identification utilisables avec les fournisseurs de partage delta.

Cette opération est similaire à l'appel CREATE_CREDENTIALS, mais elle prend des valeurs explicites au lieu d'un profil de partage delta. Pour plus d'informations, reportez-vous à Procédure et fonction CREATE_CREDENTIALS.

Syntaxe

PROCEDURE CREATE_BEARER_TOKEN_CREDENTIAL 
(
   credential_name      IN VARCHAR2,
   bearer_token         IN VARCHAR2 := NULL,
   token_endpoint       IN VARCHAR2 := NULL,
   client_id            IN VARCHAR2 := NULL,
   client_secret        IN VARCHAR2 := NULL,
   token_refresh_rate   IN PLS_INTEGER := 3600 
);

Paramètres

Paramètre Description
credential_name Nom des nouvelles informations d'identification.
bearer_token Le jeton porteur, s'il est connu.
token_endpoint Adresse à appeler pour obtenir un nouveau jeton.
client_id Nom utilisateur à envoyer à token_endpoint.
client_secret Mot de passe à envoyer à token_endpoint.
token_refresh_rate Temps d'actualisation facultatif, en secondes.

Exemple : informations d'identification avec un jeton de porteur fixe

Dans sa forme la plus simple, cette procédure équivaut à appeler DBMS_CREDENTIAL avec le nom utilisateur 'BEARER_TOKEN' et le jeton porteur lui-même en tant que mot de passe. 

SQL> exec dbms_share.create_bearer_token_credential('MY_FIXED_CREDENTIAL', 'FF42322D27D4C2DEE05392644664351E')
PL/SQL procedure successfully completed. 
SQL> select username from user_credentials where credential_name = 'MY_FIXED_CREDENTIAL';
USERNAME
------------------------------------------------------------------------------------------------------------------------
BEARER_TOKEN

Exemple : informations d'identification avec un jeton de porteur renouvelable

Créez des informations d'identification contenant un jeton de porteur de courte durée obtenu à partir d'une adresse de jeton. Le jeton porteur sera actualisé une fois par heure à l'aide d'une seconde information d'identification, qui est renseignée à partir de l'ID client et de la clé secrète.

SQL> BEGIN
  2    dbms_share.create_bearer_token_credential(
  3      credential_name=>'MY_RENEWABLE_CREDENTIAL',
  4      token_endpoint=>'https://myserver/ords/share_provider/oauth/token',
  5      client_id=>'VXGQ_44s6qJ-K4WHUNM2yQ..',
  6      client_secret=>'y9ddppgwEmZl7adDHFQndw..');
  7  END;
  8  /
 PL/SQL procedure successfully completed.
 SQL> select credential_name, username from user_credentials where credential_name LIKE 'MY_RENEWABLE_CREDENTIAL%';
 CREDENTIAL_NAME                              USERNAME
------------------------------------------    -------------------------------------
MY_RENEWABLE_CREDENTIAL                       BEARER_TOKEN
MY_RENEWABLE_CREDENTIAL$TOKEN_REFRESH_CRED    VXGQ_44s6qJ-K4WHUNM2yQ..

CREATE_CLOUD_STORAGE_LINK Procédure

Créez un lien d'URI de stockage cloud nommé. Un lien de stockage cloud est une association nommée entre un URI de bucket OCI et un nom d'informations d'identification locales.

Remarque

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des informations d'identification au lien de stockage.

Syntaxe

PROCEDURE CREATE_CLOUD_STORAGE_LINK
(
  storage_link_name    IN VARCHAR2,
  uri                  IN VARCHAR2,
  owner                IN VARCHAR2 := NULL,
  metadata             IN SYS.JSON_OBJECT_T := NULL,
  auto_commit          IN BOOLEAN := TRUE
);

Paramètres

Paramètre Description
storage_link_name Nom du lien de stockage cloud. Le nom du lien doit respecter les conventions de dénomination Oracle standard.
uri URI du bucket de stockage. L'URI doit être au format https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Propriétaire du lien de stockage. Conservez la valeur NULL pour l'utilisateur en cours.
metadata (Facultatif) Document de métadonnées JSON contenant des informations supplémentaires.
auto_commit La valeur par défaut est TRUE. Si la valeur est TRUE, cette transaction est validée. Si la valeur est FALSE, l'utilisateur doit valider la transaction. Les modifications ne sont pas visibles tant que la validation n'a pas eu lieu.

Exemple

Dans cet exemple, un lien de stockage cloud nommé MY_SHARE_STORAGE est créé sur l'URL indiquée. 

SQL> BEGIN
  2    dbms_share.create_cloud_storage_link(
  3      'MY_SHARE_STORAGE',
  4      'https://objectstorage.../n/abcdef/b/my_bucket/o' );
  5  END;
  6  /

PL/SQL procedure successfully completed.

SQL> select storage_link_name from user_lineage_cloud_storage_links;

STORAGE_LINK_NAME
----------------------------------------------------------------------------------------
MY_SHARE_STORAGE

CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Procédure

Créez ou remplacez un URI de stockage cloud nommé. Un lien de stockage cloud est une association nommée entre un URI de bucket OCI et un nom d'informations d'identification locales.

Remarque

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des informations d'identification au lien de stockage.

Syntaxe

PROCEDURE CREATE_OR_REPLACE_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    uri                  IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    metadata             IN SYS.JSON_OBJECT_T := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
storage_link_name Nom du lien de stockage cloud. Le nom du lien doit respecter les conventions de dénomination Oracle standard. Reportez-vous à Nom et qualificatifs d'objet de base de données.
uri URI du bucket de stockage. L'URI doit être au format https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Propriétaire du lien de stockage. La valeur par défaut est le schéma en cours.
metadata Document de métadonnées JSON facultatif contenant des informations supplémentaires.
auto_commit Si la valeur est TRUE, les modifications sont validées automatiquement après la création du lien. La valeur par défaut est TRUE.

CREATE_OR_REPLACE_SHARE_RECIPIENT Procédure

Créez ou remplacez un destinataire de partage. Vous devez indiquer au moins une adresse électronique ou un ID partage.

Syntaxe

PROCEDURE CREATE_OR_REPLACE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
recipient_name Nom local du destinataire du partage. Certains noms ne sont pas autorisés (par exemple, MY_TENANCY).
description Description du destinataire.
recipient_owner Schéma auquel le destinataire appartient.
email Courriel qui sera enregistré pour l'utilisateur OAUTH.
sharing_id ID de partage du destinataire, provenant de la fonction GET_SHARING_ID.

CREATE_SHARE Procédure

Créez un objet de partage nommé.

Syntaxe

PROCEDURE CREATE_SHARE
(
  share_name           IN VARCHAR2,
  share_type           IN VARCHAR2 := SHARE_TYPE_VERSIONED,
  storage_link_name    IN VARCHAR2 := NULL,
  storage_link_owner   IN VARCHAR2 := NULL,
  description          IN VARCHAR2 := NULL,
  public_description   IN VARCHAR2 := NULL,
  configuration        IN SYS.JSON_OBJECT_T := NULL,
  force_create         IN BOOLEAN  := FALSE,
  share_owner          IN VARCHAR2 := NULL,
  auto_commit          IN BOOLEAN := FALSE,
  log_level            IN PLS_INTEGER := LOG_LEVEL_BASIC,
  run_storage_tests    IN BOOLEAN := TRUE
);

Paramètres

Paramètre Description
share_name Nom du partage. Ce nom est en majuscules car les partages delta ne sont pas sensibles à la casse. Le nom suit les conventions Oracle standard. Il doit donc comporter 128 caractères ou moins et doit être placé entre guillemets s'il ne s'agit pas d'un identificateur simple. La seule différence est qu'il sera en majuscules même s'il est entre guillemets doubles.
share_type Type de partage. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Types dans DBMS_SHARE Constants.
storage_link_name Nom du lien de stockage cloud où les objets sont créés. L'utilisateur doit disposer d'un accès en lecture/écriture à ce stockage et avoir la possibilité de créer des demandes pré-authentifiées sur le stockage. Ce paramètre est obligatoire pour les partages avec numéro de version et facultatif pour les partages actuels.
storage_link_owner Propriétaire du lien de stockage cloud dans lequel les objets sont créés.
description Description locale du partage.
public_description Description publique du partage.
configuration Document de configuration qui définit le mode de création des objets.
force_create Définissez force_create sur TRUE pour redéfinir le partage s'il existe.
share_owner Propriétaire du partage.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel afin de rendre la modification visible.
log_level Niveau de journalisation des événements. Cela contrôle la quantité de détails enregistrée dans la vue ALL_SHARE_EVENTS. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Log Level dans DBMS_SHARE Constants.
run_storage_tests Si ce paramètre est défini sur TRUE, DBMS_SHARE exécute des tests pour vérifier que le lien de stockage de partage indiqué dispose des privilèges appropriés.

Si ce paramètre est FALSE, la procédure n'exécute aucune vérification au moment de la création. Cela peut entraîner des erreurs plus tard, lors de la publication ou de la consommation de l'action.

Oracle recommande d'indiquer TRUE pour ce paramètre.

CREATE_SHARE_RECIPIENT Procédure

Créez un destinataire de partage.

Syntaxe

PROCEDURE CREATE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
recipient_name Nom local du destinataire du partage. Certains noms ne sont pas autorisés, par exemple : MY_TENANCY.
description Description du destinataire.
recipient_owner Schéma auquel le destinataire appartient.
email Courriel qui sera enregistré pour l'utilisateur OAUTH. Vous devez fournir au moins un ID courriel ou de partage.
sharing_id ID de partage du destinataire provenant de la fonction GET_SHARING_ID. Vous devez fournir au moins un ID courriel ou de partage.

DROP_CLOUD_STORAGE_LINK Procédure

Supprimer un lien de stockage cloud.

Syntaxe

PROCEDURE DROP_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
storage_link_name Nom du lien de stockage cloud à supprimer.
owner Propriétaire du lien de stockage cloud. Conservez la valeur NULL pour l'utilisateur en cours.
auto_commit Si la valeur est TRUE, le code est automatiquement validé après la suppression du lien. La valeur par défaut est TRUE.

DROP_RECIPIENT Procédure

Supprimer un destinataire. Tout accès au destinataire sera révoqué.

Syntaxe

PROCEDURE DROP_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
recipient_name Nom du destinataire du partage.
owner Schéma qui définit le destinataire.

DROP_SHARE Procédure

Supprimer un partage et son contenu. L'accès futur des consommateurs à cette part prendra fin.

Syntaxe

PROCEDURE DROP_SHARE
(
  share_name           IN VARCHAR2,
  share_owner          IN VARCHAR2 := NULL,
  destroy_objects      IN BOOLEAN := TRUE
);

Paramètres

Paramètre Description
share_name Nom du partage à supprimer.
share_owner Propriétaire du partage à abandonner.
destroy_objects Si la valeur est TRUE, supprimez tous les objets créés au nom du partage. La valeur par défaut est TRUE.

DROP_SHARE_LINK_VIEW Procédure

Supprimez une vue créée par la procédure CREATE_SHARE_LINK_VIEW.

Pour plus d'informations, reportez-vous à Procédure CREATE_SHARE_LINK_VIEW.

Syntaxe

PROCEDURE DROP_SHARE_LINK_VIEW  
(
    view_name            IN VARCHAR2,
    view_owner           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
view_name Nom de la nouvelle vue.
view_owner Propriétaire de la vue. La valeur par défaut est le schéma en cours.

DROP_SHARE_VERSION Procédure

Supprimer une version de partage unique. Notez que vous ne pouvez pas supprimer la version en cours.

Syntaxe

PROCEDURE DROP_SHARE_VERSION  
(
    share_name           IN VARCHAR2,
    share_version        IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_name Nom du partage.
share_version Version à supprimer. Vous ne pouvez pas supprimer la version en cours.
destroy_objects Détruisez tout objet associé dans le stockage cloud, le cas échéant.
force_drop Supprimez la version de partage même s'il existe un fichier PAR en attente sur la version.
share_owner Propriétaire du partage.

DROP_SHARE_VERSIONS Procédure

Supprimez une plage de versions de partage. Notez que vous ne pouvez pas supprimer la version en cours à l'aide de cette procédure.

Syntaxe

PROCEDURE DROP_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    from_share_version   IN NUMBER,
    to_share_version     IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_name Nom du partage.
from_share_version Version la plus basse à supprimer.
to_share_version Version la plus élevée à supprimer.
destroy_objects Détruisez tout objet associé dans le stockage cloud, le cas échéant.
force_drop Supprimez la version de partage même s'il existe un fichier PAR en attente sur la version.
share_owner Propriétaire du partage.

DROP_UNUSED_SHARE_VERSIONS Procédure

Supprimez toute version de partage qui n'est pas en cours d'utilisation.

Syntaxe

PROCEDURE DROP_UNUSED_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    destroy_objects      IN BOOLEAN := TRUE,
    share_owner          IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_name Nom du partage.
destroy_objects Détruisez tout objet associé dans le stockage cloud, le cas échéant.
share_owner Propriétaire du partage.

ENABLE_SCHEMA Procédure

Activer ou désactiver un schéma pour le partage. Cette procédure doit être exécutée par l'utilisateur ADMIN.

Syntaxe

Les utilisateurs peuvent consommer des partages delta sans être activés avec cette procédure, mais ils ne peuvent pas créer ou publier des partages. Le partage est désactivé par défaut pour tous les schémas, y compris ADMIN.

PROCEDURE ENABLE_SCHEMA  
(
    schema_name          IN VARCHAR2,
    enabled              IN BOOLEAN := TRUE,
    privileges           IN PLS_INTEGER := NULL
);

Paramètres

Paramètre Description
schema_name Schéma à activer ou à désactiver.
enable Vrai pour activer, Faux pour désactiver.
privileges L'argument de privilèges comporte des valeurs bitmap. Si vous laissez l'argument NULL, il prend par défaut la valeur PRIV_CREATE_SHARE + PRIV_CREATE_RECIPIENT + PRIV_CONSUME_ORACLE_SHARE.

Les valeurs bitmap sont les suivantes :
  • PRIV_CREATE_SHARE
    Permet aux utilisateurs de créer des partages de publication dans leur propre schéma.
    PRIV_CREATE_SHARE         CONSTANT PLS_INTEGER := 1;
  • PRIV_CREATE_RECIPIENT

    Autoriser les utilisateurs à créer des destinataires de partage dans leur propre schéma.

    PRIV_CREATE_RECIPIENT     CONSTANT PLS_INTEGER := 2;
  • PRIV_CONSUME_ORACLE_SHARE

    Permettre aux utilisateurs d'utiliser des partages en direct entre Oracle et Oracle.

    PRIV_CONSUME_ORACLE_SHARE CONSTANT PLS_INTEGER := 4;
  • PRIV_ORDS_ACL

    Accordez une ACL à l'utilisateur sur l'adresse ORDS locale. Cette opération est requise pour que l'utilisateur génère des jetons au porteur sur les partages créés localement.

    PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Fonction GET_ACTIVATION_LINK

Générez le lien qui est placé dans les e-mails au destinataire autorisé. Ce lien d'activation mène à la page de téléchargement, où le destinataire clique sur un bouton pour obtenir le profil delta.

Syntaxe

FUNCTION GET_ACTIVATION_LINK
(
  recipient_name       IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL,
  expiration           IN PLS_INTEGER := 259200,
  invalidate_previous  IN BOOLEAN := TRUE
)
RETURN VARCHAR2;

Paramètres

Paramètre Description
recipient_name Nom local du destinataire.
recipient_owner Schéma auquel le destinataire appartient.
expiration Nombre de secondes avant l'expiration du lien d'activation.
invalidate_previous Si TRUE est la valeur par défaut, un lien d'activation généré précédemment n'est plus valide. Si la valeur est FALSE, un lien d'activation généré précédemment reste valide.

Exemple : Imprimer le lien d'activation à l'écran

SQL> exec dbms_share.create_share_recipient('new_recipient', email=>'anyone@example.com')

PL/SQL procedure successfully completed.

SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /
PL/SQL procedure successfully completed.

SQL> exec dbms_output.put_line(dbms_share.get_activation_link('NEW_RECIPIENT'))
http://.../ords/_adpshr/delta-sharing/download?key=43BA....YXJlX3Rlc3Q= 

PL/SQL procedure successfully completed.

Fonction GET_PUBLISHED_IDENTITY

Obtenez des données sur l'utilisateur en cours qui a été défini par SET_PUBLISHED_IDENTITY.

Syntaxe

FUNCTION GET_PUBLISHED_IDENTITY
  RETURN CLOB;

Exemple

SQL> declare
  2    id_json json_object_t := json_object_t();
  3  begin
  4    id_json.put('name', 'Demo Publisher');
  5    id_json.put('description', 'Documentation Share Provider');
  6    id_json.put('contact', 'null@example.com');
  7    dbms_share.set_published_identity(id_json);
  8  end;
  9  /

PL/SQL procedure successfully completed.

SQL> select json_query(dbms_share.get_published_identity, '$' pretty) "Published Identity"
  2  from dual;

Published Identity-
-------------------------------------------------------------------------------
{
  "name" : "Demo Publisher",
  "description" : "Documentation Share Provider",
  "contact" : "null@example.com"
}

Fonction GET_RECIPIENT_PROPERTY

Renvoie la valeur d'une propriété pour un destinataire.

Syntaxe

FUNCTION GET_RECIPIENT_PROPERTY
(
  recipient_name       IN VARCHAR2,
  recipient_property   IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL
)RETURN VARCHAR2;

Paramètres

Paramètre Description
recipient_name Nom du destinataire.
recipient_property Propriété à obtenir. Ces propriétés comprennent :
  • PROP_SHARE_DESC
  • PROP_SHARE_PUBLIC_DESC
  • PROP_SHARE_VERSION_ACCESS
  • PROP_SHARE_JOB_NAME
  • PROP_SHARE_SPLIT_SIZE
  • PROP_SHARE_LOG_LEVEL
  • PROP_SHARE_JOB_DOP
  • PROP_SHARE_JOB_CLASS
  • PROP_SHARE_JOB_PRIORITY
  • PROP_SHARE_VERSION_ACCESS

Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Properties dans DBMS_SHARE Constants.

recipient_owner Propriétaire du destinataire. La valeur par défaut est l'utilisateur actuel.

Fonction GET_SHARE_PROPERTY

Obtenez la valeur de propriété d'un partage existant.

Syntaxe

FUNCTION GET_SHARE_PROPERTY
(
  share_name       IN VARCHAR2,
  share_property   IN VARCHAR2,
  share_owner      IN VARCHAR2 := NULL
)
RETURN VARCHAR2

Paramètres

Paramètre Description
share_name Nom du partage.
share_property Valeur de propriété à obtenir. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Properties dans DBMS_SHARE Constants.
share_owner Propriétaire du partage. La valeur par défaut est l'utilisateur actuel.

Fonction GET_SHARE_TABLE_PROPERTY

Obtient la valeur de propriété d'une table de partage existante.

Syntaxe

FUNCTION GET_SHARE_TABLE_PROPERTY
(
  share_name           IN VARCHAR2,
  share_table_name     IN VARCHAR2,
  share_table_property IN VARCHAR2,
  share_schema_name    IN VARCHAR2 := NULL,
  share_owner          IN VARCHAR2 := NULL
)RETURN VARCHAR2;

Paramètres

Paramètre Description
share_name Nom du partage.
share_table_name Nom de la table de partage.
share_table_property Propriété de table de partage à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Table Properties dans DBMS_SHARE Constants.
share_schema_name Nom du schéma de partage. La valeur par défaut est une majuscule de l'utilisateur actuel.
share_owner Propriétaire du partage.

GRANT_TO_RECIPIENT Procédure

Accordez l'accès à un partage à un destinataire spécifique. Le partage et le destinataire doivent tous deux appartenir au même schéma.

Syntaxe

PROCEDURE GRANT_TO_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage à octroyer.
recipient_name Nom du destinataire.
owner Propriétaire du partage et du destinataire.
auto_commit Le paramètre auto_commit est ignoré. Cette procédure sera toujours validée.

POPULATE_SHARE_PROFILE Procédure

Générer un profil delta pour un destinataire. Vous pouvez l'imprimer à l'écran ou l'envoyer quelque part. Par exemple, vers un bucket d'objet à l'aide de DBMS_CLOUD.EXPORT_DATA.

Syntaxe

PROCEDURE POPULATE_SHARE_PROFILE  
(
    recipient_name       IN VARCHAR2,
    share_profile        IN OUT NOCOPY SYS.JSON_OBJECT_T,
    recipient_owner      IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
recipient_name Nom local du destinataire.
share_profile Profil de partage, sans jeton de porteur.
recipient_owner Schéma auquel le destinataire appartient.

Exemple : imprimer le profil à l'écran.

SQL> EXEC DBMS_SHARE.CREATE_SHARE_RECIPIENT('new_recipient', email=>'anyone@example.com')
 
PL/SQL procedure successfully completed. 
SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /

PL/SQL procedure successfully completed. 

SQL> select json_query(:sprof, '$' pretty) "PROFILE" from dual;
PROFILE------------------------------------------------------------------------------------------------------------------------
{
  "shareCredentialsVersion" : 1,
  "endpoint" : "https://.../ords/share_test/_delta_sharing/",
  "bearerToken" : "mc7puvhqCpU6xjTOjRdl_w",
  "tokenEndpoint" : "https://.../ords/share_test/oauth/token",
  "clientID" : "VXGQ_44s6qJ-K4WHUNM2yQ..",
  "clientSecret" : "y9ddppgwEmZl7adDHFQndw.."
}

PUBLISH_SHARE Procédure

Publiez un partage et revenez immédiatement.

La publication se poursuivra en arrière-plan. Vous pouvez vérifier le statut du travail en interrogeant la vue USER_SHARE_JOBS. Pour plus d'informations, reportez-vous à USER_SHARE_JOBS View.

Syntaxe

PROCEDURE PUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    drop_prior_versions  IN BOOLEAN := FALSE,
    share_job_dop        IN NUMBER := NULL,
    share_job_priority   IN NUMBER := NULL,
    job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
    force_job_class      IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage à publier.
share_owner Propriétaire du partage, qui doit être l'utilisateur en cours ou NULL.
drop_prior_versions Définissez la valeur sur Vrai si vous souhaitez supprimer toutes les versions précédentes du partage. Notez que les versions ne sont supprimées que s'il n'y a pas de demandes pré-authentifiées en attente.
share_job_dop Indiquez le nombre maximal de travaux dbms_scheduler qui seront utilisés pour publier le partage. Conservez la valeur NULL pour utiliser le numéro par défaut du système.
share_job_priority Indiquez une priorité relative de cette publication de partage par rapport aux autres. Si deux partages sont publiés en même temps, celui dont la priorité est la plus élevée est traité en premier, même s'il a été démarré ultérieurement.
job_class Classe de travail du planificateur, à partir de all_scheduler_job_classes, utilisée pour publier le partage.
force_job_class Utilisez le paramètre job_class indiqué même si l'administrateur a défini une autre classe de travail par défaut.

PUBLISH_SHARE_WAIT Procédure

Publiez un partage et attendez que le travail en arrière-plan soit terminé. La publication se poursuit même si l'appel est interrompu.

Syntaxe

PROCEDURE PUBLISH_SHARE_WAIT  
(
       share_name           IN VARCHAR2,
       share_owner          IN VARCHAR2 := NULL,
       drop_prior_versions  IN BOOLEAN := FALSE,
       share_job_dop        IN NUMBER := NULL,
       share_job_priority   IN NUMBER := NULL,
       job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
       force_job_class      IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage à publier.
share_owner Propriétaire du partage, qui doit être l'utilisateur en cours ou NULL.
drop_prior_versions Définissez la valeur sur Vrai si vous souhaitez supprimer toutes les versions précédentes du partage. Notez que les versions ne sont supprimées que s'il n'y a pas de demandes pré-authentifiées en attente.
share_job_dop Indiquez le nombre maximal de travaux dbms_scheduler qui seront utilisés pour publier le partage. Conservez la valeur NULL pour utiliser le numéro par défaut du système.
share_job_priority Indiquez une priorité relative de cette publication de partage par rapport aux autres. Si deux partages sont publiés en même temps, celui dont la priorité est la plus élevée est traité en premier, même s'il a été démarré ultérieurement.
job_class Classe de travail du planificateur, à partir de all_scheduler_job_classes, utilisée pour publier le partage.
force_job_class Utilisez le paramètre job_class indiqué même si l'administrateur a défini une autre classe de travail par défaut.

PURGE_DETACHED_FILES Procédure

Supprimez ou ou ou oubliez les fichiers de parquet qui se sont détachés de leurs partages.

Syntaxe

PROCEDURE PURGE_DETACHED_FILES  
(
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

Version de PURGE_DETACHED_FILES qui renvoie l'ID du travail de purge, le cas échéant. 

PROCEDURE PURGE_DETACHED_FILES  
(
    purge_job_id         IN OUT NOCOPY NUMBER,
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

Paramètres

Paramètre Description
purge_job_id ID du travail de purge.
file_pattern Modèle LIKE facultatif pour les fichiers à purger.
credential_name Informations d'identification facultatives à utiliser pour supprimer les fichiers.
purge_mode Indique comment les fichiers sont purgés. Les valeurs du mode de purge sont les suivantes :
  • PURGE_DROP
    Tentez de supprimer les fichiers à l'aide des informations d'identification indiquées. Si le fichier ne peut pas être supprimé, il reste répertorié dans les vues *_SHARE_DETACHED_FILES.
    PURGE_DROP             CONSTANT PLS_INTEGER := 1;
  • PURGE_DROP_FORCE
    Tentez de supprimer les fichiers à l'aide des informations d'identification indiquées. Le fichier sera supprimé des vues *_SHARE_DETACHED_FILES même si la tentative de suppression du fichier échoue à nouveau.
    PURGE_DROP_FORCE       CONSTANT PLS_INTEGER := 2;
  • PURGE_FORGET
    Supprimez les vues *_SHARE_DETACHED_FILES des fichiers sans tenter de les supprimer.
    PURGE_FORGET           CONSTANT PLS_INTEGER := 3;
owner_id ID propriétaire dont les fichiers doivent être purgés.

REMOVE_FROM_SHARE Procédure

Enlevez une table ou une vue d'un partage.

Syntaxe

PROCEDURE REMOVE_FROM_SHARE  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom d'un partage existant auquel l'objet est révoqué.
share_table_name Nom de la table de partage à révoquer. Cela doit correspondre au nom visible en externe, de sorte que l'entrée sera en majuscules.
share_schema_name Nom du schéma de partage. La valeur par défaut est une majuscule de l'utilisateur actuel.
share_owner Propriétaire du partage.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel afin de rendre la modification visible.

RENAME_RECIPIENT Procédure

Renommez un destinataire. Cette procédure ne modifie que le nom local du destinataire. La définition externe du destinataire, par exemple le nom de l'utilisateur OAUTH ou l'ID de partage, n'est pas modifiée.

Syntaxe

PROCEDURE RENAME_RECIPIENT  
(
    old_recipient_name   IN VARCHAR2,
    new_recipient_name   IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
old_recipient_name Nom actuel du destinataire du partage.
new_recipient_name Nouveau nom du destinataire du partage.
owner Schéma qui définit le destinataire.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est TRUE.

RENAME_SHARE Procédure

Renommez un partage. Il convient de prendre soin de cette procédure car la modification affecte tous les consommateurs existants dont l'accès est basé sur le nom précédent. Les consommateurs ne sont pas informés directement ou mis à jour.

Syntaxe

PROCEDURE RENAME_SHARE  
(
    old_share_name       IN VARCHAR2,
    new_share_name       IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
old_share_name Nom actuel du partage.
new_share_name Nouveau nom du partage.
share_owner Propriétaire du partage.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est TRUE.

RENAME_SHARE_LINK Procédure

Renommez un lien de partage enregistré.

Syntaxe

PROCEDURE RENAME_SHARE_LINK  
(
    old_name             IN VARCHAR2,
    new_name             IN VARCHAR2,
    link_owner           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
old_name Nom actuel du lien de partage.
new_name Nouveau nom du lien.
link_owner Propriétaire du lien de partage. La valeur par défaut est le schéma en cours.

RENAME_SHARE_SCHEMA Procédure

Renommez un schéma de partage.

Syntaxe

PROCEDURE RENAME_SHARE_SCHEMA  
(
    share_name           IN VARCHAR2,
    old_schema_name      IN VARCHAR2,
    new_schema_name      IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
old_schema_name Ancien nom du schéma.
new_schema_name Nouveau nom du schéma.
share_owner Propriétaire du partage. La valeur par défaut est le schéma en cours.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE.

RENAME_SHARE_TABLE Procédure

Renommez une table de partage.

Syntaxe

PROCEDURE RENAME_SHARE_TABLE  
(
    share_name           IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    old_share_table_name IN VARCHAR2,
    new_share_table_name IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
share_schema_name Nom du schéma de partage.
old_share_table_name Ancien nom de la table de partage.
new_share_table_name Nouveau nom de la table de partage.
share_owner Propriétaire du partage.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE.

REVOKE_FROM_RECIPIENT Procédure

Révoquer l'accès d'un partage à un destinataire spécifique.

Syntaxe

PROCEDURE REVOKE_FROM_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage à révoquer.
recipient_name Nom du destinataire.
owner Propriétaire de l'action et destinataire.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas lieu. La valeur par défaut est FALSE.

SET_CURRENT_SHARE_VERSION Procédure

Modifier la version actuelle d'un partage.

Syntaxe

PROCEDURE SET_CURRENT_SHARE_VERSION  
(
    share_name         IN VARCHAR2,
    share_version      IN NUMBER,
    share_owner        IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_name Nom du partage.
share_version La nouvelle version ou NULL. La version doit exister et être valide. Si share_version a la valeur NULL, aucune version ne sera marquée comme ACTUELLE et le partage sera "non publié".
share_owner Propriétaire du partage. La valeur par défaut est le schéma en cours.

SET_PUBLISHED_IDENTITY Procédure

Définissez les données relatives à l'utilisateur actuel qui seront fournies aux destinataires des partages ORACLE publiés.

Syntaxe

PROCEDURE SET_PUBLISHED_IDENTITY  
(
    metadata             IN SYS.JSON_OBJECT_T := NULL  
);

Paramètres

Paramètre Description
metadata Si l'identité du fournisseur a déjà été définie, seuls les éléments que l'appelant souhaite mettre à jour doivent être inclus dans le fichier JSON. Si vous indiquez une valeur NULL pour un élément, celui-ci est enlevé de l'identité stockée. Cependant, "nom", "description" et "contact" ne peuvent pas être supprimés de cette manière.

Si l'argument de métadonnées est NULL, l'identité de fournisseur existante est supprimée. Cela ne peut se produire que si l'utilisateur actuel n'a pas de partages publiés.

Si l'identité du fournisseur n'a pas encore été définie, le JSON doit contenir au moins les éléments suivants :
  • name (<=128 octets)
  • description (<=4000 octets)
  • valeurs de contact (<=4000 octets)

Des éléments supplémentaires peuvent être inclus à la discrétion de l'appelant.

Exemple : inclure des éléments supplémentaires dans les métadonnées JSON

En plus du "nom", de la "description" et du "contact" requis, cet exemple inclut l'élément supplémentaire "planification".
{
  "name" : "A sample share provider",
  "description" : "Test of share provider metadata",
  "contact" : "provider1@example.com".
  "schedule" : "New data provided on alternate rainy Fridays"
}

Exemple : mettez à jour "description" et supprimez "schedule".

Pour mettre à jour la description et enlever la programmation, vous pouvez utiliser le JSON suivant :
{
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

SET_RECIPIENT_LOG_LEVEL Procédure

Modifiez le niveau de journalisation d'un destinataire de partage existant.

Syntaxe

PROCEDURE SET_RECIPIENT_LOG_LEVEL
(
  recipient_name       IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  recipient_owner      IN VARCHAR2 := NULL
);

Paramètres

Paramètre Description
recipient_name Nom local du destinataire du partage.
log_level Niveau de journalisation des événements. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Log Level dans DBMS_SHARE Constants.
recipient_owner Schéma auquel le destinataire appartient.

SET_SHARE_LOG_LEVEL Procédure

Modifiez le niveau de journalisation d'un partage existant.

Syntaxe

PROCEDURE SET_SHARE_LOG_LEVEL
(
  share_name           IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  share_owner          IN VARCHAR2 := NULL
);

Paramètres

Paramètre Description
share_name Nom du partage.
log_level Niveau de journalisation des événements. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Log Level dans DBMS_SHARE Constants.
share_owner Propriétaire du partage.

SET_STORAGE_CREDENTIAL Procédure

Définissez le nom des informations d'identification utilisé par l'utilisateur en cours lorsqu'il tente d'accéder au stockage donné.

Syntaxe

PROCEDURE SET_STORAGE_CREDENTIAL  
(
    storage_link_name    IN VARCHAR2,
    credential_name      IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    check_if_exists      IN BOOLEAN := TRUE,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
storage_link_name Nom d'un lien de stockage cloud précédemment créé à l'aide de la procédure CREATE_CLOUD_STORAGE_LINK.
credential_name Nom des informations d'identification locales qui donnent accès au stockage.

Les informations d'identification utilisées pour le stockage de partage doivent pouvoir lire, écrire, supprimer et gérer les demandes pré-authentifiées. Reportez-vous à Utilisation de demandes pré-authentifiées
owner Propriétaire du lien de stockage cloud. Conservez la valeur NULL pour l'utilisateur en cours.
check_if_exists Si check_if_exists a la valeur TRUE, la fonction confirmera également que les informations d'identification existent pour l'utilisateur en cours.
auto_commit La valeur par défaut est TRUE. Si la valeur est TRUE, cette transaction est validée. Si la valeur est FALSE, l'utilisateur doit valider la transaction. Les modifications ne sont pas visibles tant que la validation n'a pas eu lieu.

STOP_JOB Procédure

Tentative d'arrêt d'un travail de partage en cours d'exécution. La procédure doit revenir rapidement, mais l'arrêt du travail associé peut prendre un certain temps.

Syntaxe

PROCEDURE STOP_JOB
(
  share_job_id         IN NUMBER,
  share_job_owner      IN VARCHAR2 := NULL
);

Paramètres

Paramètre Description
share_job_id ID du travail de partage.
share_job_owner Propriétaire du travail. La valeur par défaut est le schéma en cours.

UNPUBLISH_SHARE Procédure

Annuler la publication d'un partage.

Syntaxe

PROCEDURE UNPUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    out_share_job_id     IN OUT NOCOPY NUMBER,
    share_owner          IN VARCHAR2 := NULL,
    drop_all_versions    IN BOOLEAN := FALSE,
    restart_versions     IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
out_share_job_id ID de tout travail de partage à exécuter pour traiter cette commande.
share_owner Propriétaire du partage. La valeur par défaut est le schéma en cours.
drop_all_versions Si la valeur est définie sur TRUE, toutes les versions existantes et tout le stockage associé sont supprimés.

Si drop_all_versions a la valeur FALSE, toutes les versions existantes continuent d'exister, mais le partage n'est pas visible par les destinataires. Un appel ultérieur à PUBLISH_SHARE ou SET_CURRENT_SHARE_VERSION les rend à nouveau visibles.

restart_versions Redémarrez la numérotation des versions. Si FALSE, le numéro de version publié suivant sera le même que si aucune version n'avait été supprimée.

Si la valeur est Vrai, la prochaine version publiée sera définie sur une version supérieure à la version existante la plus élevée. Lorsqu'il est utilisé conjointement avec drop_all_versions, cela a pour effet de rétablir l'état d'origine du partage. Notez que cela peut confondre tous les clients delta existants, il doit donc être utilisé avec précaution.

UPDATE_DEFAULT_RECIPIENT_PROPERTY Procédure

Mettez à jour les valeurs de propriété de destinataire par défaut. Cette procédure nécessite que l'utilisateur dispose de privilèges d'administration.

Syntaxe

PROCEDURE UPDATE_DEFAULT_RECIPIENT_PROPERTY
(
  recipient_property   IN VARCHAR2,
  new_value_vc         IN VARCHAR2
);

Paramètres

Paramètre Description
recipient_property Propriété à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Recipient Properties in DBMS_SHARE Constants.
new_value_vc Nouvelle valeur de la propriété.

UPDATE_DEFAULT_SHARE_PROPERTY Procédure

Mettez à jour les valeurs de propriété de partage par défaut.

Syntaxe

PROCEDURE UPDATE_DEFAULT_SHARE_PROPERTY  
(
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2  
);

Paramètres

Paramètre Description
share_property Propriété à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Properties dans DBMS_SHARE Constants.

Ces propriétés peuvent être lues à l'aide de la vue ALL_SHARE_DEFAULT_SETTINGS.

new_value Nouvelle valeur de la propriété.

UPDATE_RECIPIENT_PROPERTY Procédure

Mettre à jour une propriété d'un destinataire existant.

Syntaxe

PROCEDURE UPDATE_RECIPIENT_PROPERTY  
(
    recipient_name       IN VARCHAR2,
    recipient_property   IN VARCHAR2,
    new_value            IN VARCHAR2,
    recipient_owner      IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
recipient_name Nom du destinataire.
recipient_property Propriété à mettre à jour. Ces propriétés comprennent :
  • PROP_RECIPIENT_EMAIL
  • PROP_RECIPIENT_DESCRIPTION
  • PROP_RECIPIENT_LOG_LEVEL
  • PROP_RECIPIENT_SHARING_ID
  • PROP_RECIPIENT_PROFILE_URL
  • PROP_RECIPIENT_PAR_TYPE
  • PROP_RECIPIENT_MIN_PAR_LIFETIME
  • PROP_RECIPIENT_PAR_LIFETIME
  • PROP_RECIPIENT_TOKEN_LIFETIME
Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Recipient Recipient Properties in DBMS_SHARE Constants.
new_value Nouvelle valeur de la propriété.
recipient_owner Propriétaire du destinataire. La valeur par défaut est le schéma en cours.

UPDATE_SHARE_JOB_PROPERTY Procédure

Modifier les propriétés d'un travail de partage en cours d'exécution. La procédure doit revenir rapidement, mais les modifications peuvent prendre un certain temps.

Syntaxe

PROCEDURE UPDATE_SHARE_JOB_PROPERTY  
(
    share_job_id         IN NUMBER,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_job_owner      IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_job_id ID du travail de partage.
share_property Propriété à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Job Properties dans DBMS_SHARE Constants.
new_value Nouvelle valeur de la propriété.
share_job_owner Propriétaire du travail. La valeur par défaut est le schéma en cours.

UPDATE_SHARE_PROPERTY Procédure

Mettre à jour une propriété d'un partage existant.

Syntaxe

PROCEDURE UPDATE_SHARE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
share_property Propriété à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de la section Share Properties dans DBMS_SHARE Constants.
new_value Nouvelle valeur de la propriété.
share_owner Propriétaire du partage. La valeur par défaut est le schéma en cours.
Auto_commit Si la valeur est TRUE (valeur par défaut), les modifications sont automatiquement validées. Si la valeur est FALSE, l'utilisateur doit valider les modifications. Les modifications sont visibles de l'extérieur après la validation.

UPDATE_SHARE_TABLE_PROPERTY Procédure

Mettez à jour la valeur de propriété d'une table de partage existante.

Syntaxe

PROCEDURE UPDATE_SHARE_TABLE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_table_property IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
share_table_name Nom de la table de partage.
share_table_property Propriété à mettre à jour. Ces propriétés comprennent :
  • PROP_SHARE_TABLE_SPLIT_METHOD
  • PROP_SHARE_TABLE_SPLIT_COLUMNS
  • PROP_SHARE_TABLE_ORDER_COLUMNS
  • PROP_SHARE_TABLE_SHARE_COLUMNS
  • PROP_SHARE_TABLE_SPLIT_SIZE
  • PROP_SHARE_TABLE_GATHER_STATS
  • PROP_SHARE_TABLE_SPLIT_ROWS
  • PROP_SHARE_TABLE_FLASHBACK
new_value Nouvelle valeur de la propriété.
share_schema_name Nom du schéma de partage (par défaut, en majuscules de l'utilisateur en cours).
share_owner Propriétaire du partage. La valeur par défaut est le schéma en cours.
Auto_commit Si la valeur est TRUE (valeur par défaut), les modifications sont automatiquement validées. Si la valeur est FALSE, l'utilisateur doit valider les modifications. Les modifications sont visibles de l'extérieur après la validation.

Fonction VALIDATE_CREDENTIAL

Validez un nom d'informations d'identification et convertissez-le en formulaire préétabli si nécessaire.

La procédure génère une exception si le nom n'est pas un identificateur Oracle valide. La valeur credential_name est renvoyée sans guillemets doubles, comme elle apparaîtrait dans la colonne CREDENTIAL_NAME de la vue USER_CREDENTIALS.

Syntaxe

FUNCTION VALIDATE_CREDENTIAL  
(
        credential_name      IN VARCHAR2,
        check_if_exists      IN BOOLEAN := TRUE  
)  
RETURN VARCHAR2;

Paramètres

Paramètre Description
credential_name Nom des informations d'identification à valider sous forme de base de données standard, avec des guillemets si le nom n'est pas un identificateur simple.
check_if_exists Si la valeur est TRUE, la fonction confirme également que les informations d'identification existent pour l'utilisateur en cours.

VALIDATE_SHARE_STORAGE Procédure

Vérifiez si le stockage donné est adapté aux partages avec numéro de version.

Syntaxe

Syntaxe de la procédure, y compris le paramètre de sortie validation_results. 

 PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    validation_results   IN OUT NOCOPY VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

La syntaxe de la procédure n'inclut pas le paramètre de sortie validation_results. 

PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
storage_link_name Nom du lien de stockage cloud.
validation_results (Entrée et sortie facultatives) Détails du résultat de validation renvoyés au format JSON.

validation_results inclut les résultats de chaque test distinct.

run_storage_tests Exécutez des tests pour valider le stockage. Si la valeur est TRUE (valeur par défaut), la procédure teste READ, WRITE, DELETE et PREAUTHENTICATED REQUESTS.
storage_link_owner Propriétaire du lien de stockage cloud.

Exemple : résultats de validation

{
  "READ":"PASSSED",
  "WRITE":"PASSSED",
  "CREATE_PAR":"PASSSED",
  "DELETE_PAR":"PASSSED",
  "DELETE":"PASSSED"
}

WAIT_FOR_JOB Procédure

Cette procédure attend que le travail de partage spécifié soit terminé.

Syntaxe

PROCEDURE WAIT_FOR_JOB  
(
    share_job_id         IN NUMBER,
    completed            IN OUT NOCOPY BOOLEAN,
    maximum_wait         IN NUMBER := NULL  
);

Paramètres

Paramètre Description
share_job_id ID du travail de partage.
completed Indicateur de fin d'emploi.
maximum_wait Période d'attente maximale, en secondes. Une valeur NULL n'implique aucune limite.