Documentation Oracle Cloud Infrastructure

Récapitulatif des sous-programmes émetteurs 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
Procédure ADD_TO_SHARE Ajoutez une table ou une vue à un partage.
Procédure ASSERT_SHAREABLE_OBJECT Retour sans erreur, si l'objet existe et peut être partagé.
Procédure ASSERT_SHARING_ID 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.
Procédure CLEAR_RECIPIENT_EVENTS Effacez les événements du journal des événements du destinataire du partage.
Procédure CLEAR_SHARE_EVENTS Effacez les événements du journal des événements de partage.
Procédure CREATE_BEARER_TOKEN_CREDENTIAL Créez des informations d'identification adaptées à l'utilisation avec les fournisseurs de partage delta.
Procédure CREATE_CLOUD_STORAGE_LINK Créez un lien d'URI de stockage cloud nommé.
Procédure CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Créez ou remplacez un URI de stockage cloud nommé.
Procédure CREATE_OR_REPLACE_SHARE_RECIPIENT Créez ou remplacez un destinataire de partage.
Procédure CREATE_SHARE Créez un objet partagé nommé.
Procédure CREATE_SHARE_RECIPIENT Créez un nouveau destinataire de partage.
Procédure DROP_CLOUD_STORAGE_LINK Supprimez un lien de stockage cloud.
Procédure DROP_RECIPIENT Supprimer un destinataire.
Procédure DROP_SHARE Déposez un partage et tout son contenu.
Procédure DROP_SHARE_LINK_VIEW Supprimez une vue créée par la procédure CREATE_SHARE_LINK_VIEW.
Procédure DROP_SHARE_VERSION Supprimez une seule version de partage.
Procédure DROP_SHARE_VERSIONS Supprimez une plage de versions de partage.
Procédure DROP_UNUSED_SHARE_VERSIONS Supprimez toute version de partage qui n'est pas actuellement utilisée.
Procédure ENABLE_SCHEMA Activez ou désactivez un schéma pour le partage.
Fonction GET_ACTIVATION_LINK Générez le lien qui est placé dans les courriels au destinataire autorisé.
Fonction GET_PUBLISHED_IDENTITY Obtenez des données sur l'utilisateur en cours défini par SET_PUBLISHED_IDENTITY.
Fonction GET_RECIPIENT_PROPERTY Renvoie la valeur d'une propriété pour un destinataire.
Fonction GET_SHARE_PROPERTY Obtenir 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.
Procédure GRANT_TO_RECIPIENT Accorder l'accès à un partage à un destinataire spécifique.
Procédure POPULATE_SHARE_PROFILE Générer un profil delta pour un destinataire.
Procédure PUBLISH_SHARE Publiez un partage et revenez immédiatement.
Procédure PUBLISH_SHARE_WAIT Publiez un partage et attendez que le travail en arrière-plan soit terminé.
Procédure PURGE_DETACHED_FILES Supprimer ou oublier les fichiers de parquet qui ont été détachés de leurs partages.
Procédure REMOVE_FROM_SHARE Supprimez une table ou une vue d'un partage.
Procédure RENAME_RECIPIENT Renommez un destinataire.
Procédure RENAME_SHARE Renommez un partage.
Procédure RENAME_SHARE_LINK Renommez un lien de partage enregistré.
Procédure RENAME_SHARE_SCHEMA Renommez un schéma partagé.
Procédure RENAME_SHARE_TABLE Renommez une table de partage.
Procédure REVOKE_FROM_RECIPIENT Révoquer l'accès d'un destinataire spécifique à un partage.
Procédure SET_CURRENT_SHARE_VERSION Modifier la version actuelle d'un partage.
Procédure SET_PUBLISHED_IDENTITY Définir les données relatives à l'utilisateur en cours qui seront fournies aux destinataires des partages ORACLE publiés.
Procédure SET_RECIPIENT_LOG_LEVEL Modifiez le niveau de journalisation d'un destinataire de partage existant.
Procédure SET_SHARE_LOG_LEVEL Modifiez le niveau de journalisation d'un partage existant.
Procédure SET_STORAGE_CREDENTIAL Définissez le nom des informations d'identification d'accès pour le stockage indiqué.
Procédure STOP_JOB Arrêtez un travail de partage en cours d'exécution.
Procédure UNPUBLISH_SHARE Annuler la publication d'un partage.
Procédure UPDATE_DEFAULT_RECIPIENT_PROPERTY Mettez à jour les valeurs de propriété de destinataire par défaut.
Procédure UPDATE_DEFAULT_SHARE_PROPERTY Mettez à jour les valeurs de propriété de partage par défaut.
Procédure UPDATE_RECIPIENT_PROPERTY Mettre à jour la propriété d'un destinataire existant.
Procédure UPDATE_SHARE_JOB_PROPERTY Modifiez les propriétés d'un travail de partage en cours d'exécution.
Procédure UPDATE_SHARE_PROPERTY Mettez à jour une propriété d'un partage existant.
Procédure UPDATE_SHARE_TABLE_PROPERTY 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 au format canonique en premier, si nécessaire.
Procédure VALIDATE_SHARE_STORAGE Vérifiez si le stockage donné convient aux partages avec numéro de version.
Procédure WAIT_FOR_JOB Cette procédure attend que le travail de partage spécifié soit terminé.

Rubrique parent : Package DBMS_SHARE

Procédure ADD_TO_SHARE

Ajoutez une table ou une vue à un partage. L'objet devient visible par 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. Par défaut, il s'agit du schéma actuel.
share_table_name Nom de la table visible en externe. Par défaut, il s'agit de la valeur 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 la 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 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 de la part.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe jusqu'à ce que la validation ait lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel pour rendre la modification visible.

Procédure ASSERT_SHAREABLE_OBJECT

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

Procédure ASSERT_SHARING_ID

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 évidemment 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, le cas échéant. 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;

Procédure CLEAR_RECIPIENT_EVENTS

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 Dernière heure pour les événements qui doivent être effacés ou NULL.
recipient_owner Schéma propriétaire du destinataire.

Procédure CLEAR_SHARE_EVENTS

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 Dernière heure pour les événements qui doivent être effacés ou NULL.
share_owner Schéma propriétaire du partage.

Procédure CREATE_BEARER_TOKEN_CREDENTIAL

Créez des informations d'identification adaptées à l'utilisation avec les fournisseurs de partage delta.

Cela est similaire à l'appel CREATE_CREDENTIALS, mais il prend des valeurs explicites au lieu d'un profil de partage delta. Pour plus d'informations, reportez-vous à la section CREATE_CREDENTIALS Procedure and Function.

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 support fixe

Dans sa forme la plus simple, cette procédure équivaut à appeler DBMS_CREDENTIAL avec le nom utilisateur 'BEARER_TOKEN' et le jeton de 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 support renouvelable

Créez des informations d'identification qui contiennent un jeton de support à durée de vie courte 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..

Procédure CREATE_CLOUD_STORAGE_LINK

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

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 de la liaison 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 de la liaison de stockage. Conservez la valeur NULL pour l'utilisateur actuel.
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, la 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 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

Procédure CREATE_OR_REPLACE_CLOUD_STORAGE_LINK

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

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 de la liaison de stockage cloud. Le nom du lien doit respecter les conventions de dénomination Oracle standard. Reportez-vous à Noms et qualificatifs d'objet de base de donnée.
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 de la liaison de stockage. La valeur par défaut est le schéma actuel.
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.

Procédure CREATE_OR_REPLACE_SHARE_RECIPIENT

Créez ou remplacez un destinataire de partage. Vous devez fournir au moins une adresse électronique ou un ID de 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 propriétaire du destinataire.
email Courriel qui sera enregistré pour l'utilisateur OAUTH.
sharing_id ID de partage du destinataire, provenant de la fonction GET_SHARING_ID.

Procédure CREATE_SHARE

Créez un objet partagé 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 tiennent pas compte de la casse. Ce nom est conforme aux conventions Oracle standard. Il doit contenir 128 caractères au maximum 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 cité deux fois.
share_type Type de partage. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous à la description des types de partage dans DBMS_SHARE Constantes.
storage_link_name Nom du lien de stockage cloud dans lequel 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 la façon dont les objets sont créés.
force_create Définissez force_create sur TRUE pour redéfinir le partage s'il existe.
share_owner Propriétaire de la part.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe jusqu'à ce que la validation ait lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel pour rendre la modification visible.
log_level Niveau de journalisation d'événement. Cela contrôle la quantité de détails enregistrés dans la vue ALL_SHARE_EVENTS. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de Niveau de journalisation dans DBMS_SHARE Constantes.
run_storage_tests Si ce paramètre a la valeur 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 la part.

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

Procédure CREATE_SHARE_RECIPIENT

Créez un nouveau 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 propriétaire du destinataire.
email Courriel qui sera enregistré pour l'utilisateur OAUTH. Vous devez fournir au moins un courriel ou un ID de partage.
sharing_id ID de partage du destinataire de la fonction GET_SHARING_ID. Vous devez fournir au moins un courriel ou un ID de partage.

Procédure DROP_CLOUD_STORAGE_LINK

Supprimez 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 de la liaison de stockage cloud. Conservez la valeur NULL pour l'utilisateur actuel.
auto_commit Si la valeur est TRUE, le code est validé automatiquement après la suppression du lien. La valeur par défaut est TRUE.

Procédure DROP_RECIPIENT

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.

Procédure DROP_SHARE

Déposez un partage et tout son contenu. L'accès futur à la part des consommateurs 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 à supprimer.
destroy_objects Si la valeur est TRUE, supprimez tous les objets créés pour le partage. La valeur par défaut est TRUE.

Procédure DROP_SHARE_LINK_VIEW

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. Par défaut, il s'agit du schéma actuel.

Procédure DROP_SHARE_VERSION

Supprimez une seule version de partage. Notez que vous ne pouvez pas supprimer la version actuelle.

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 actuelle.
destroy_objects Détruisez tout objet associé dans le stockage cloud, le cas échéant.
force_drop Supprimez la version du partage même si la version contient un fichier PAR en attente.
share_owner Propriétaire de la part.

Procédure DROP_SHARE_VERSIONS

Supprimez une plage de versions de partage. Notez que vous ne pouvez pas supprimer la version actuelle à 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 du partage même si la version contient un fichier PAR en attente.
share_owner Propriétaire de la part.

Procédure DROP_UNUSED_SHARE_VERSIONS

Supprimez toute version de partage qui n'est pas actuellement utilisée.

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 de la part.

Procédure ENABLE_SCHEMA

Activez ou désactivez 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 valeur TRUE = activer, valeur FALSE = désactiver.
privileges L'argument de privilèges comporte des valeurs bitmap. Si vous laissez l'argument NULL, il est défini par défaut sur PRIV_CREATE_SHARE + PRIV_CREATE_RECIPIENT + PRIV_CONSUME_ORACLE_SHARE.

Les valeurs de bitmap sont les suivantes :
  • PRIV_CREATE_SHARE
    Autoriser les utilisateurs à 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 de consommer des partages en direct d'Oracle à Oracle.

    PRIV_CONSUME_ORACLE_SHARE CONSTANT PLS_INTEGER := 4;
  • PRIV_ORDS_ACL

    Accordez une liste de contrôle d'accès à l'utilisateur sur l'adresse ORDS locale. Cela est nécessaire pour que l'utilisateur génère des jetons de support 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 courriels 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 propriétaire du destinataire.
expiration Nombre de secondes avant l'expiration du lien d'activation.
invalidate_previous Si la valeur par défaut est TRUE, un lien d'activation précédemment généré n'est plus valide. Si FALSE, un lien d'activation précédemment généré reste valide.

Exemple : Imprimer le lien d'activation vers 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 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 La propriété à obtenir. Ces propriétés sont les suivantes :
  • 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

Obtenir 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 La 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 de la part. 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 à la description 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 la majuscule de l'utilisateur actuel.
share_owner Propriétaire de la part.

Procédure GRANT_TO_RECIPIENT

Accorder 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 à accorder.
recipient_name Nom du destinataire.
owner Propriétaire de l'action et du destinataire.
auto_commit Le paramètre auto_commit est ignoré. Cette procédure sera toujours validée.

Procédure POPULATE_SHARE_PROFILE

Générer un profil delta pour un destinataire. Vous pouvez l'imprimer à l'écran ou le télécharger quelque part. Par exemple, pour un bucket d'objet utilisant 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 propriétaire du destinataire.

Exemple : Imprimez 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.."
}

Procédure PUBLISH_SHARE

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 si aucune demande pré-authentifiée en attente n'existe.
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 Spécifiez une priorité relative de cette publication de partages par rapport aux autres. Si deux partages sont publiés en même temps, celui qui a la priorité 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 fichierjob_class indiqué même si l'administrateur a défini une classe de travail par défaut différente.

Procédure PUBLISH_SHARE_WAIT

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 si aucune demande pré-authentifiée en attente n'existe.
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 Spécifiez une priorité relative de cette publication de partages par rapport aux autres. Si deux partages sont publiés en même temps, celui qui a la priorité 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 fichierjob_class indiqué même si l'administrateur a défini une classe de travail par défaut différente.

Procédure PURGE_DETACHED_FILES

Supprimer ou oublier les fichiers de parquet qui ont été 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
    Essayez de supprimer les fichiers à l'aide des informations d'identification indiquées. Si le fichier ne peut pas être supprimé, il continuera à être répertorié dans les vues *_SHARE_DETACHED_FILES.
    PURGE_DROP             CONSTANT PLS_INTEGER := 1;
  • PURGE_DROP_FORCE
    Essayez 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 échoue à nouveau.
    PURGE_DROP_FORCE       CONSTANT PLS_INTEGER := 2;
  • PURGE_FORGET
    Enlevez les vues *_SHARE_DETACHED_FILES des fichiers sans essayer de les supprimer.
    PURGE_FORGET           CONSTANT PLS_INTEGER := 3;
owner_id ID propriétaire dont les fichiers doivent être purgés.

Procédure REMOVE_FROM_SHARE

Supprimez 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. Ce nom 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 la majuscule de l'utilisateur actuel.
share_owner Propriétaire de la part.
auto_commit Si la valeur est TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles en externe jusqu'à ce que la validation ait lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel pour rendre la modification visible.

Procédure RENAME_RECIPIENT

Renommez un destinataire. Cette procédure modifie uniquement le nom local du destinataire. La définition externe du destinataire, par exemple le nom de l'utilisateur OAUTH ou l'ID 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 Vrai, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas eu lieu. La valeur par défaut est TRUE.

Procédure RENAME_SHARE

Renommez un partage. Cette procédure doit être suivie avec précaution 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 Nom du partage.
share_owner Propriétaire de la part.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas eu lieu. La valeur par défaut est TRUE.

Procédure RENAME_SHARE_LINK

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

Procédure RENAME_SHARE_SCHEMA

Renommez un schéma partagé.

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 de la part. La valeur par défaut est le schéma actuel.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE.

Procédure RENAME_SHARE_TABLE

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 de la part.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE.

Procédure REVOKE_FROM_RECIPIENT

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

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 Vrai, les modifications sont automatiquement validées. Les modifications ne sont pas visibles en externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE.

Procédure SET_CURRENT_SHARE_VERSION

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 de la part. La valeur par défaut est le schéma actuel.

Procédure SET_PUBLISHED_IDENTITY

Définir les données relatives à l'utilisateur en cours 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 supprimé de l'identité stockée. Cependant, "nom", "description" et "contact" ne peuvent pas être supprimés de cette façon.

Si l'argument de métadonnées est NULL, l'identité du fournisseur existant 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 fichier JSON doit contenir au moins :
  • nom (<=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 un é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 : Mettre à jour "description" et supprimer "schedule"

Pour mettre à jour "description" et enlever "schedule", le fichier JSON suivant peut être utilisé :
{
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

Procédure SET_RECIPIENT_LOG_LEVEL

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 d'événement. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de Niveau de journalisation dans DBMS_SHARE Constantes.
recipient_owner Schéma propriétaire du destinataire.

Procédure SET_SHARE_LOG_LEVEL

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 d'événement. Pour plus d'informations sur les constantes utilisées pour ce paramètre, reportez-vous aux descriptions de Niveau de journalisation dans DBMS_SHARE Constantes.
share_owner Propriétaire de la part.

Procédure SET_STORAGE_CREDENTIAL

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

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 de la liaison de stockage cloud. Conservez la valeur NULL pour l'utilisateur actuel.
check_if_exists Si check_if_exists a la valeur TRUE, la fonction vérifie é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, la 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 lieu.

Procédure STOP_JOB

Tentez d'arrêter un travail de partage en cours d'exécution. La procédure doit revenir rapidement, mais l'arrêt de la tâche associée 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 actuel.

Procédure UNPUBLISH_SHARE

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 qui doit être exécuté pour traiter cette commande.
share_owner Propriétaire de la part. La valeur par défaut est le schéma actuel.
drop_all_versions Si la valeur est définie sur Vrai, toutes les versions existantes ainsi que l'ensemble du stockage associé sont supprimées.

Si drop_all_versions a la valeur FALSE, toutes les versions existantes continuent d'exister, mais le partage n'est pas visible pour 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 TRUE, 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 soin.

Procédure UPDATE_DEFAULT_RECIPIENT_PROPERTY

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 à la description de la section Share Recipient Properties in DBMS_SHARE Constants.
new_value_vc Nouvelle valeur de propriété.

Procédure UPDATE_DEFAULT_SHARE_PROPERTY

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 propriété.

Procédure UPDATE_RECIPIENT_PROPERTY

Mettre à jour la 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 sont les suivantes :
  • 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 à la description de la section Share Recipient Recipient Properties in DBMS_SHARE Constants.
new_value Nouvelle valeur de propriété.
recipient_owner Propriétaire du destinataire. La valeur par défaut est le schéma actuel.

Procédure UPDATE_SHARE_JOB_PROPERTY

Modifiez 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 propriété.
share_job_owner Propriétaire du travail. La valeur par défaut est le schéma actuel.

Procédure UPDATE_SHARE_PROPERTY

Mettez à 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 propriété.
share_owner Propriétaire de la part. La valeur par défaut est le schéma actuel.
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 en externe après la validation.

Procédure UPDATE_SHARE_TABLE_PROPERTY

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 sont les suivantes :
  • 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 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 de la part. La valeur par défaut est le schéma actuel.
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 en externe après la validation.

Fonction VALIDATE_CREDENTIAL

Validez un nom d'informations d'identification et convertissez-le au format canonique en premier, 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, entre 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.

Procédure VALIDATE_SHARE_STORAGE

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

Syntaxe

Syntaxe de la procédure incluant 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 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.

Le fichier 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 les demandes READ, WRITE, DELETE et PREAUTHENTICATED.
storage_link_owner Propriétaire du lien de stockage cloud.

Exemple : résultats de la validation

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

Procédure WAIT_FOR_JOB

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 de travail.
maximum_wait Durée d'attente maximale, en secondes. Une valeur NULL n'implique aucune limite.