Documentation sur Oracle Cloud Infrastructure

Sommaire des sous-programmes de production de partages

Ce tableau répertorie les procédures et les fonctions d'ensemble 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 Retourner sans erreur si l'objet existe et peut être partagé.
ASSERT_SHARING_ID Procédure Exécutez les vérifications de validation de base par rapport à un ID de partage et renvoyez-en un sous forme canonique.
Fonction CAN_CREATE_SHARE Cette fonction vérifie si le schéma courant peut créer des destinataires de partage.
Fonction CAN_CREATE_SHARE_RECIPIENT Cette fonction vérifie si le schéma courant peut créer des destinataires de partage.
CLEAR_RECIPIENT_EVENTS Procédure Effacer les événements du journal des événements de destinataire de partage.
CLEAR_SHARE_EVENTS Procédure Effacer les événements du journal des événements de partage.
CREATE_BEARER_TOKEN_CREDENTIAL Procédure Créez des données d'identification adaptées aux fournisseurs de partage delta.
CREATE_CLOUD_STORAGE_LINK Procédure Créez un lien d'URI de stockage en nuage nommé.
CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Procédure Créez ou remplacez un URI de stockage en nuage nommé.
CREATE_OR_REPLACE_SHARE_RECIPIENT Procédure Sert à créer ou à remplacer un destinataire de partage.
CREATE_SHARE Procédure Créez un objet de partage nommé.
CREATE_SHARE_RECIPIENT Procédure Créez un nouveau destinataire de partage.
DROP_CLOUD_STORAGE_LINK Procédure Déposer un lien de stockage en nuage.
DROP_RECIPIENT Procédure Déposez un destinataire.
DROP_SHARE Procédure Déposez un partage et tout 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 Supprimez une seule version de partage.
DROP_SHARE_VERSIONS Procédure Supprimez un intervalle 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 sera envoyé par courriel au destinataire autorisé.
Fonction GET_PUBLISHED_IDENTITY Obtenez des données sur l'utilisateur courant qui a été défini par SET_PUBLISHED_IDENTITY.
Fonction GET_RECIPIENT_PROPERTY Retourne 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 Obtenir la valeur de propriété d'une table de partage existante.
GRANT_TO_RECIPIENT Procédure Accorder l'accès à un partage à un destinataire spécifique.
POPULATE_SHARE_PROFILE Procédure Sert à 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 la tâche en arrière-plan soit terminée.
PURGE_DETACHED_FILES Procédure Supprimez ou ou oubliez les fichiers de parquet qui ont été détachés de leurs partages.
REMOVE_FROM_SHARE Procédure Supprimer 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 à un partage d'un destinataire spécifique.
SET_CURRENT_SHARE_VERSION Procédure Modifier la version courante d'un partage.
SET_PUBLISHED_IDENTITY Procédure Définir les données sur l'utilisateur courant qui seront fournies aux destinataires des partages ORACLE publiés.
SET_RECIPIENT_LOG_LEVEL Procédure Modifiez le niveau de journal 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 données d'identification d'accès pour le stockage indiqué.
STOP_JOB Procédure Arrêter une tâche 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'une tâche 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 de données d'identification, en le convertissant au format canonique en premier, si nécessaire.
VALIDATE_SHARE_STORAGE Procédure Vérifiez si le stockage indiqué convient 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 : Ensemble 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 Responsable de l'entité à partager. La valeur par défaut est le schéma courant.
share_table_name Nom visible à l'externe de la table. Par défaut, il s'agit du table_name en majuscules.
share_schema_name Schéma visible à l'externe où la table sera placée. Par défaut, il s'agit du responsable 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 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 share_table_name existe déjà, une exception est générée indiquant que la table de partage est déjà utilisée.

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

ASSERT_SHAREABLE_OBJECT Procédure

Retourner 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 Responsable de l'objet. Valeur par défaut du schéma courant.

ASSERT_SHARING_ID Procédure

Exécutez les vérifications de validation de base par rapport à 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, s'il est valide. Par exemple, TENANCY ou DATABASE.

Fonction CAN_CREATE_SHARE

Cette fonction vérifie si le schéma courant peut créer des destinataires de partage. Si des partages peuvent être créés, un 1 est retourné et 0 autrement.

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 courant peut créer des destinataires de partage. Si des partages peuvent être créés, un 1 est retourné, et 0 autrement.

Syntaxe 

FUNCTION CAN_CREATE_SHARE_RECIPIENT
RETURN NUMBER;

CLEAR_RECIPIENT_EVENTS Procédure

Effacer les événements du journal des événements de destinataire de 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 contenant le destinataire.

CLEAR_SHARE_EVENTS Procédure

Effacer 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 contenant le partage.

CREATE_BEARER_TOKEN_CREDENTIAL Procédure

Créez des données d'identification adaptées aux 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, voir CREATE_CREDENTIALS Procédure et fonction.

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 données d'identification.
bearer_token Le jeton du porteur, s'il est connu.
token_endpoint Point d'extrémité à appeler pour obtenir un nouveau jeton.
client_id Nom d'utilisateur à envoyer à token_endpoint.
client_secret Mot de passe à envoyer à token_endpoint.
token_refresh_rate Temps d'actualisation facultatif, en secondes.

Exemple : Données d'identification avec un jeton de porteur fixe

Dans sa forme la plus simple, cette procédure équivaut à appeler DBMS_CREDENTIAL avec un nom d'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 : Données d'identification avec un jeton au porteur renouvelable

Créez des données d'identification qui contiennent un jeton de porteur de courte durée obtenu à partir d'un point d'extrémité de jeton. Le jeton du porteur sera actualisé une fois par heure à l'aide d'une deuxième donnée d'identification, qui est alimenté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 en nuage nommé. Un lien de stockage en nuage est une association nommée entre un URI de seau OCI et un nom de données d'identification local.

Note

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des données 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 en nuage. Le nom du lien doit respecter les conventions de dénomination standard d'Oracle.
uri URI du seau de stockage. L'URI doit être du format https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Responsable du lien de stockage. Laissez la valeur NULL pour l'utilisateur courant.
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 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 en nuage 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 en nuage nommé. Un lien de stockage en nuage est une association nommée entre un URI de seau OCI et un nom de données d'identification local.

Note

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des données 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 en nuage. Le nom du lien doit respecter les conventions de dénomination standard d'Oracle. Voir Noms et attributs d'objet de base de données
uri URI du seau de stockage. L'URI doit être du format https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Responsable du lien de stockage. Valeur par défaut du schéma courant.
metadata Document de métadonnées JSON facultatif contenant des informations supplémentaires.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées après la création du lien. La valeur par défaut est TRUE.

CREATE_OR_REPLACE_SHARE_RECIPIENT Procédure

Sert à créer ou à remplacer un destinataire de partage. Vous devez fournir au moins une adresse de courriel 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 contenant le destinataire.
email Courriel qui sera enregistré pour l'utilisateur OAUTH.
sharing_id ID partage du destinataire, à partir 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 actions delta ne sont pas sensibles à la casse. Le nom respecte 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 mis en majuscule même s'il est doublement cité.
share_type Type de partage. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir les descriptions pour Types de partage dans DBMS_SHARE Constantes.
storage_link_name Nom du lien de stockage en nuage où les objets sont créés. L'utilisateur doit disposer d'un accès en lecture/écriture à ce stockage et pouvoir créer des demandes préauthentifiées sur celui-ci. Le paramètre est obligatoire pour les partages avec numéro de version et facultatif pour les partages courants.
storage_link_owner Responsable du lien de stockage en nuage où 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 Réglez force_create à TRUE pour redéfinir le partage s'il existe.
share_owner Propriétaire de l'action.
auto_commit Si TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles à l'externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit COMMIT après avoir exécuté cet appel afin de rendre la modification visible.
log_level Niveau d'enregistrement de l'événement. Cela contrôle le nombre de détails enregistrés dans la vue ALL_SHARE_EVENTS. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir les descriptions pour Niveau de journal dans DBMS_SHARE Constantes.
run_storage_tests Si ce paramètre est VRAI, DBMS_SHARE exécute des tests pour vérifier que le lien de stockage partagé spécifié dispose des privilèges appropriés.

Si ce paramètre est FALSE, la procédure n'exécute aucune vérification lors 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 de spécifier TRUE pour ce paramètre.

CREATE_SHARE_RECIPIENT Procédure

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

DROP_CLOUD_STORAGE_LINK Procédure

Déposer un lien de stockage en nuage.

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 en nuage à supprimer.
owner Responsable du lien de stockage en nuage. Laissez la valeur NULL pour l'utilisateur courant.
auto_commit Si TRUE, le code est automatiquement validé après la suppression du lien. La valeur par défaut est TRUE.

DROP_RECIPIENT Procédure

Déposez un destinataire. Tous les accès au destinataire seront révoqués.

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

Déposez un partage et tout son contenu. L'accès futur des consommateurs à l'action 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 à abandonner.
share_owner Responsable de l'action à abandonner.
destroy_objects Si TRUE, supprimez tous les objets créés pour le compte 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, voir ProcédureCREATE_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 Responsable de la vue. La valeur par défaut est le schéma courant.

DROP_SHARE_VERSION Procédure

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

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 déposer la version courante.
destroy_objects Détruire tout objet associé dans le stockage en nuage, le cas échéant.
force_drop Supprimez la version de partage même s'il existe un fichier de demande préauthentifiée en attente sur la version.
share_owner Propriétaire de l'action.

DROP_SHARE_VERSIONS Procédure

Supprimez un intervalle de versions de partage. Notez que vous ne pouvez pas supprimer la version courante à 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étruire tout objet associé dans le stockage en nuage, le cas échéant.
force_drop Supprimez la version de partage même s'il existe un fichier de demande préauthentifiée en attente sur la version.
share_owner Propriétaire de l'action.

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étruire tout objet associé dans le stockage en nuage, le cas échéant.
share_owner Propriétaire de l'action.

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 TRUE pour activer, FALSE pour désactiver.
privileges L'argument de privilèges contient des valeurs bitmap. Si vous laissez l'argument NULL, la valeur par défaut est PRIV_CREATE_SHARE + PRIV_CREATE_RECIPIENT + PRIV_CONSUME_ORACLE_SHARE.

Les valeurs 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 entre Oracle et Oracle.

    PRIV_CONSUME_ORACLE_SHARE CONSTANT PLS_INTEGER := 4;
  • PRIV_ORDS_ACL

    Accordez une liste de contrôle d'accès à l'utilisateur sur le point d'extrémité ORDS local. Ceci est requis pour que l'utilisateur génère des jetons de porteur sur des partages créés localement.

    PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Fonction GET_ACTIVATION_LINK

Générez le lien qui sera envoyé par courriel 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 contenant le destinataire.
expiration Nombre de secondes avant l'expiration du lien d'activation.
invalidate_previous Si TRUE, qui est la valeur par défaut, un lien d'activation généré précédemment n'est pas valide. Si FALSE, un lien d'activation généré précédemment 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 courant 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

Retourne 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, voir la description des propriétés de partage dans DBMS_SHARE Constantes.

recipient_owner Responsable du destinataire. Valeur par défaut de l'utilisateur courant.

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 Valeur de propriété à obtenir. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir la description des propriétés de partage dans DBMS_SHARE Constantes.
share_owner Propriétaire de l'action. Valeur par défaut de l'utilisateur courant.

Fonction GET_SHARE_TABLE_PROPERTY

Obtenir 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, voir les descriptions pour Partager les propriétés de table dans DBMS_SHARE Constantes.
share_schema_name Nom du schéma de partage. Valeur par défaut en majuscules de l'utilisateur courant.
share_owner Propriétaire de l'action.

GRANT_TO_RECIPIENT Procédure

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 est toujours validée.

POPULATE_SHARE_PROFILE Procédure

Sert à générer un profil delta pour un destinataire. Vous pouvez l'imprimer à l'écran ou le télécharger quelque part. Par exemple, vers un seau d'objets à 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 contenant le 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.."
}

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 de la tâche en interrogeant la vue USER_SHARE_JOBS. Pour plus d'informations, voir Vue USER_SHARE_JOBS.

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 Responsable du partage, qui doit être l'utilisateur courant ou NULL.
drop_prior_versions Réglez à TRUE si vous souhaitez supprimer toutes les versions précédentes du partage. Notez que les versions ne sont abandonnées que si aucune demande préauthentifiée n'est en attente.
share_job_dop Spécifiez le nombre maximal de tâches dbms_scheduler qui seront utilisées pour publier le partage. Laissez 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 partage par rapport aux autres. Si deux actions sont publiées en même temps, celle ayant la priorité la plus élevée est traitée en premier, même si elle a été lancée plus tard.
job_class Classe de travail du programmateur, à partir de all_scheduler_job_classes, utilisée pour publier le partage.
force_job_class Utilisez le paramètre spécifiéjob_class même si l'administrateur a défini une classe de tâche par défaut différente.

PUBLISH_SHARE_WAIT Procédure

Publiez un partage et attendez que la tâche en arrière-plan soit terminée. 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 Responsable du partage, qui doit être l'utilisateur courant ou NULL.
drop_prior_versions Réglez à TRUE si vous souhaitez supprimer toutes les versions précédentes du partage. Notez que les versions ne sont abandonnées que si aucune demande préauthentifiée n'est en attente.
share_job_dop Spécifiez le nombre maximal de tâches dbms_scheduler qui seront utilisées pour publier le partage. Laissez 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 partage par rapport aux autres. Si deux actions sont publiées en même temps, celle ayant la priorité la plus élevée est traitée en premier, même si elle a été lancée plus tard.
job_class Classe de travail du programmateur, à partir de all_scheduler_job_classes, utilisée pour publier le partage.
force_job_class Utilisez le paramètre spécifiéjob_class même si l'administrateur a défini une classe de tâche par défaut différente.

PURGE_DETACHED_FILES Procédure

Supprimez ou ou oubliez 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 retourne l'ID de la tâche d'épuration, 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 tâche d'épuration.
file_pattern Modèle LIKE facultatif pour les fichiers à épurer.
credential_name Données d'identification facultatives à utiliser pour supprimer les fichiers.
purge_mode Indique comment les fichiers sont épurés. Les valeurs du mode d'épuration sont les suivantes :
  • PURGE_DROP
    Tentative de suppression des fichiers à l'aide des données d'identification spécifiées. Si le fichier ne peut pas être supprimé, il continuera d'être répertorié dans les vues *_SHARE_DETACHED_FILES.
    PURGE_DROP             CONSTANT PLS_INTEGER := 1;
  • PURGE_DROP_FORCE
    Tentative de suppression des fichiers à l'aide des données d'identification spécifié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 responsable dont les fichiers doivent être épurés.

REMOVE_FROM_SHARE Procédure

Supprimer 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 à l'externe, de sorte que l'entrée sera mise en majuscules.
share_schema_name Nom du schéma de partage. Valeur par défaut en majuscules de l'utilisateur courant.
share_owner Propriétaire de l'action.
auto_commit Si TRUE, cet appel de procédure valide les modifications qui ne sont pas visibles à l'externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE, ce qui signifie que l'utilisateur doit COMMIT après avoir exécuté cet appel afin de rendre la modification visible.

RENAME_RECIPIENT Procédure

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 courant 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 à l'externe tant que la validation n'a pas eu 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 le changement 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 courant du partage.
new_share_name Nouveau nom du partage.
share_owner Propriétaire de l'action.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles à l'externe tant que la validation n'a pas eu 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 courant du lien de partage.
new_name Nouveau nom du lien.
link_owner Responsable du lien de partage. Valeur par défaut du schéma courant.

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 de l'action. Valeur par défaut du schéma courant.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles à l'externe tant que la validation n'a pas eu 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 de l'action.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. Les modifications ne sont pas visibles à l'externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE.

REVOKE_FROM_RECIPIENT Procédure

Révoquer l'accès à un partage d'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 à l'externe tant que la validation n'a pas eu lieu. La valeur par défaut est FALSE.

SET_CURRENT_SHARE_VERSION Procédure

Modifier la version courante 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 est NULL, aucune version ne sera marquée comme ACTUELLE et le partage sera "non publié".
share_owner Propriétaire de l'action. Valeur par défaut du schéma courant.

SET_PUBLISHED_IDENTITY Procédure

Définir les données sur l'utilisateur courant 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 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 courant 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 les éléments suivants :
  • 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 des "nom", "description" et "contact" requis, cet exemple inclut l'élément supplémentaire "planifier".
{
  "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 supprimer "schedule", le JSON suivant peut être utilisé :
{
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

SET_RECIPIENT_LOG_LEVEL Procédure

Modifiez le niveau de journal 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 d'enregistrement de l'événement. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir les descriptions pour Niveau de journal dans DBMS_SHARE Constantes.
recipient_owner Schéma contenant le destinataire.

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 d'enregistrement de l'événement. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir les descriptions pour Niveau de journal dans DBMS_SHARE Constantes.
share_owner Propriétaire de l'action.

SET_STORAGE_CREDENTIAL Procédure

Définissez le nom des données d'identification utilisé par l'utilisateur courant 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 en nuage créé précédemment à l'aide de la procédure CREATE_CLOUD_STORAGE_LINK.
credential_name Nom d'une donnée d'identification locale qui donne accès au stockage.

Les données d'identification utilisées pour le stockage de partage doivent pouvoir lire, écrire, supprimer et gérer les demandes préauthentifiées. Voir Utilisation de demandes préauthentifiées
owner Responsable du lien de stockage en nuage. Laissez la valeur NULL pour l'utilisateur courant.
check_if_exists Si check_if_exists est VRAI, la fonction confirmera également que les données d'identification existent pour l'utilisateur courant.
auto_commit La valeur par défaut est TRUE. Si la valeur est TRUE, cette transaction est validée. Si 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'une tâche 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 de la tâche de partage.
share_job_owner Responsable de l'emploi. Valeur par défaut du schéma courant.

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 toute tâche de partage devant être exécutée pour traiter cette commande.
share_owner Propriétaire de l'action. Valeur par défaut du schéma courant.
drop_all_versions Si la valeur est TRUE, toutes les versions existantes ainsi que tout le stockage associé sont abandonnées.

Si drop_all_versions est 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 de 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 TRUE, la prochaine version publiée sera réglée à une version de plus que la version existante la plus élevée. Lorsqu'il est utilisé en conjonction avec drop_all_versions, cela a pour effet de réinitialiser le partage à son état initial. Notez que cela peut confondre tous les clients delta existants, il doit donc être utilisé avec soin.

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'administrateur.

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, voir les descriptions pour Partager les propriétés du destinataire dans DBMS_SHARE Constantes.
new_value_vc Nouvelle valeur de 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, voir la description des propriétés de partage dans DBMS_SHARE Constantes.

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

new_value Nouvelle valeur de 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 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, voir les descriptions pour Partager les propriétés du destinataire dans DBMS_SHARE Constantes.
new_value Nouvelle valeur de propriété.
recipient_owner Responsable du destinataire. Valeur par défaut du schéma courant.

UPDATE_SHARE_JOB_PROPERTY Procédure

Modifier les propriétés d'une tâche de partage en cours d'exécution. La procédure doit revenir rapidement, mais cela peut prendre un certain temps pour que les modifications prennent effet.

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 de la tâche de partage.
share_property Propriété à mettre à jour. Pour plus d'informations sur les constantes utilisées pour ce paramètre, voir les descriptions pour Partager les propriétés de la tâche dans DBMS_SHARE Constantes.
new_value Nouvelle valeur de propriété.
share_job_owner Responsable de l'emploi. Valeur par défaut du schéma courant.

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, voir la description des propriétés de partage dans DBMS_SHARE Constantes.
new_value Nouvelle valeur de propriété.
share_owner Propriétaire de l'action. Valeur par défaut du schéma courant.
Auto_commit Si TRUE (valeur par défaut), les modifications sont automatiquement validées. Si FALSE, l'utilisateur doit valider les modifications. Les modifications sont visibles à l'extérieur une fois la validation effectuée.

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 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 (valeur par défaut en majuscules de l'utilisateur courant).
share_owner Propriétaire de l'action. Valeur par défaut du schéma courant.
Auto_commit Si TRUE (valeur par défaut), les modifications sont automatiquement validées. Si FALSE, l'utilisateur doit valider les modifications. Les modifications sont visibles à l'extérieur une fois la validation effectuée.

Fonction VALIDATE_CREDENTIAL

Validez un nom de données d'identification, en le convertissant 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. credential_name est retourné sans guillemets doubles, comme il 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 données d'identification à valider dans le formulaire de base de données standard, avec guillemets si le nom n'est pas un identificateur simple.
check_if_exists Si TRUE, la fonction confirme également que les données d'identification existent pour l'utilisateur courant.

VALIDATE_SHARE_STORAGE Procédure

Vérifiez si le stockage indiqué convient 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 ne comprend 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 en nuage.
validation_results (Entrée et sortie facultatives) Détails des résultats de validation retournés dans le formulaire JSON.

Les validation_results incluent les résultats de chaque test distinct.

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

Exemple : Résultats de la 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 de la tâche de partage.
completed Indicateur d'achèvement de la commande de production.
maximum_wait Période d'attente maximale, en secondes. Une valeur NULL n'implique aucune limite.