Documentation sur Oracle Cloud Infrastructure

Sommaire des sous-programmes de consommation de partages

Ce tableau répertorie les procédures et les fonctions d'ensemble DBMS_SHARE utilisées pour consommer des partages.

Sous-programmes Description
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.
CREATE_CREDENTIALS Procédure et fonction Créez des données d'identification contenant le jeton du porteur à partir d'un profil delta.
CREATE_OR_REPLACE_SHARE_LINK Procédure Abonnez-vous pour partager à partir d'un fournisseur de partages enregistré.
CREATE_OR_REPLACE_ORACLE_SHARE_PROVIDER Procédure S'abonner à un fournisseur de partages Oracle avec un nom local.
CREATE_ORACLE_SHARE_PROVIDER Procédure S'abonner à un fournisseur de partages Oracle avec un nom local.
CREATE_SHARE_LINK Procédure Abonnez-vous pour partager à partir d'un fournisseur de partages enregistré.
CREATE_SHARE_LINK_VIEW Procédure Créez ou remplacez une vue nommée qui donne accès à une table partagée distante.
CREATE_SHARE_PROVIDER Procédure S'abonner à un fournisseur de partage delta.
Fonction DISCOVER_AVAILABLE_SHARES Retournez une valeur SHARE_AVAILABLE_SHARES_ROW pour chaque table disponible des fournisseurs de partage abonnés.
Fonction DISCOVER_AVAILABLE_TABLES Retournez une valeur SHARE_AVAILABLE_TABLES_ROW pour chaque table disponible à partir des fournisseurs de partage abonnés ou d'un point d'extrémité delta explicite.
DROP_SHARE_LINK Procédure Supprimez un lien de partage créé par la procédure CREATE_SHARE_LINK.
DROP_SHARE_PROVIDER Procédure Déposer un abonnement à un fournisseur de partages.
ENABLE_DELTA_ENDPOINT Procédure Créez les listes de contrôle d'accès nécessaires qui permettent à l'utilisateur spécifié de se connecter à un point d'extrémité delta.
FLUSH_SHARE_LINK_CACHE Procédure Vider le cache des partages pour un lien de partage donné.
FLUSH_SHARE_PROVIDER_CACHE Procédure Vider le cache des partages pour un fournisseur de partages donné.
GENERATE_SHARE_LINK_SELECT Procédure et fonction Générez une instruction SELECT qui renvoie les données d'une table partagée.
Fonction GET_ORACLE_SHARE_LINK_INFO Extraire le nom et l'espace de noms du lien en nuage pour un partage entre Oracle et Oracle.
GET_SHARE_LINK_INFO Procédure Obtenez le(s) point(s) d'extrémité, le type de partage et le nom de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un lien de partage.
GET_SHARE_PROVIDER_CREDENTIAL Procédure Obtenez le nom des données d'identification à utiliser par l'utilisateur courant lorsqu'il tente d'accéder au fournisseur de partage delta indiqué.
GET_SHARE_PROVIDER_INFO Procédure Obtenez les chaînes de point d'extrémité et le type de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un fournisseur de partage.
Fonction GET_SHARING_ID Retourne un identificateur qui peut être utilisé en tant que sharing_id dans la procédure CREATE_SHARE_RECIPIENT.
OPEN_SHARE_LINK_CURSOR Procédure Ouvrez un curseur qui renvoie les données d'une table partagée.
REFRESH_BEARER_TOKEN_CREDENTIAL Procédure Mettez à jour une ou plusieurs données d'identification créées par CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS.
RENAME_CLOUD_STORAGE_LINK Procédure Renommez un lien de stockage en nuage enregistré.
RENAME_SHARE_LINK Procédure Renommez un lien de partage enregistré.
RENAME_SHARE_PROVIDER Procédure Renommez un fournisseur de partages enregistré.
REMOVE_SHARE_SCHEMA Procédure Supprimez un schéma et tout son contenu d'un partage.
SET_SHARE_LINK_METADATA Procédure Définissez les métadonnées JSON supplémentaires pour le lien de partage.
SET_SHARE_PROVIDER_CREDENTIAL Procédure Définissez le nom des données d'identification pour accéder au fournisseur de partages indiqué.
SET_SHARE_PROVIDER_METADATA Procédure Définir des métadonnées JSON supplémentaires pour le fournisseur de partages.
UPDATE_BEARER_TOKEN_CREDENTIAL Procédure Modifiez un attribut d'une donnée d'identification créée par CREATE_CREDENTIALS ou CREATE_BEARER_TOKEN_CREDENTIAL.

Rubrique parent : Ensemble DBMS_SHARE

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.

CREATE_CREDENTIALS Procédure et fonction

Créez des données d'identification contenant le jeton porteur à partir d'un profil de partage delta. Le type standard, version 1, spécifie un point d'extrémité et un seul jeton porteur à long terme.

Syntaxe 

PROCEDURE CREATE_CREDENTIALS  
(
    credential_base_name IN VARCHAR2,
    delta_profile        IN CLOB,
    out_credential_name  IN OUT NOCOPY VARCHAR2  
);

Ci-dessous se trouve la version fonctionnelle de create_credentials qui retourne le nom des nouvelles données d'identification dans le formulaire JSON. 

FUNCTION CREATE_CREDENTIALS 
(
   credential_base_name IN VARCHAR2,
   delta_profile        IN CLOB 
)
RETURN CLOB;

Paramètres

Paramètre Description
credential_base_name Nom de base des données d'identification à créer.
delta_profile Profil de partage delta, au format JSON, obtenu auprès du fournisseur de partages.
{
  "shareCredentialsVersion": 1,
  "endpoint": "https://<endpoint>",
  "bearerToken": "<token>",
  "expirationTime": "...",
}
Le profil peut également, facultativement, inclure une propriété tokenEndpoint ainsi qu'une propriété clientID et clientSecret.
{
  "shareCredentialsVersion": 1,
  "endpoint": "https://<endpoint>",
  "bearerToken": "<token>",
  "expirationTime": "...",
  "tokenEndpoint": "https://<token endpoint>",
  "clientID": "<client id>",
  "clientSecret": "<client secret>"
}

Pour plus d'informations, voir Format de fichier de profil et Jeton du porteur.

out_credential_name Nom des données d'identification du jeton du porteur nouvellement créées.

CREATE_OR_REPLACE_SHARE_LINK Procédure

Abonnez-vous pour partager à partir d'un fournisseur de partages enregistré.

Syntaxe 

PROCEDURE CREATE_OR_REPLACE_SHARE_LINK  
(
    share_link_name        IN VARCHAR2,
    share_provider         IN VARCHAR2,
    share_name             IN VARCHAR2,
    provider_owner         IN VARCHAR2 := NULL,
    link_owner             IN VARCHAR2 := NULL,
    use_default_credential IN BOOLEAN := TRUE,
    metadata               IN SYS.JSON_OBJECT_T := NULL,
    auto_commit            IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
share_link_name Nom du lien de partage qui sera créé. Les noms de partage disponibles peuvent être trouvés en appelant la fonction DISCOVER_AVAILABLE_SHARES.
share_provider Nom du fournisseur d'actions inscrit.
share_name Nom du partage provenant du fournisseur de partages.
provider_owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.
link_owner Responsable du lien de partage. Valeur par défaut du schéma courant.
use_default_credential Si TRUE, utilisez les mêmes informations d'identification que le fournisseur de partages.
metadata Métadonnées facultatives à associer au lien de partage.
auto_commit Si TRUE (valeur par défaut), cet appel de procédure valide les modifications qui ne sont pas visibles à l'externe tant que la validation n'a pas eu lieu. Si FALSE, l'utilisateur doit COMMIT après avoir exécuté cet appel afin de rendre la modification visible.

CREATE_OR_REPLACE_ORACLE_SHARE_PROVIDER Procédure

S'abonner à un fournisseur de partages Oracle avec un nom local.

Il apparaîtra ensuite dans la vue ALL_SHARE_PROVIDERS avec RECIPIENT_TYPE = 'ORACLE'.

Note

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des données d'identification au lien de stockage. Voir ProcédureSET_STORAGE_CREDENTIAL.

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_ORACLE_SHARE_PROVIDER Procédure

S'abonner à un fournisseur de partages Oracle avec un nom local.

Il apparaîtra ensuite dans la vue ALL_SHARE_PROVIDERS avec RECIPIENT_TYPE = 'ORACLE'.

Syntaxe 

PROCEDURE CREATE_ORACLE_SHARE_PROVIDER  
(
    oracle_provider_id   IN VARCHAR2,
    provider_name        IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    metadata             IN SYS.JSON_OBJECT_T := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
oracle_provider_id ID fournisseur obtenu à partir de la vue ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.

Voir Vue ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.

provider_name Nom local du fournisseur
owner Responsable du nouveau fournisseur d'actions. Laissez la valeur NULL pour l'utilisateur courant.
metadata Métadonnées JSON facultatives à associer au fournisseur.
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_SHARE_LINK Procédure

Abonnez-vous pour partager à partir d'un fournisseur de partages enregistré. Les noms de partage disponibles peuvent être trouvés en appelant DISCOVER_AVAILABLE_SHARES.

Syntaxe 

PROCEDURE CREATE_SHARE_LINK  
(
    share_link_name      IN VARCHAR2,
    share_provider       IN VARCHAR2,
    share_name           IN VARCHAR2,
    provider_owner       IN VARCHAR2 := NULL,
    link_owner           IN VARCHAR2 := NULL,
    use_default_credential IN BOOLEAN := TRUE,
    metadata             IN SYS.JSON_OBJECT_T := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
share_link_name Nom du lien de partage à créer. Cela doit respecter les conventions standard d'attribution de nom Oracle et ne doit pas nécessairement être identique au paramètre share_name.
share_provider Nom du fournisseur de partages, indiqué dans ALL_SHARE_PROVIDERS, qui a partagé les données.
share_name Nom du partage, tel que défini par le fournisseur de partage.
provider_owner Schéma abonné au fournisseur de partages, comme indiqué dans ALL_SHARE_PROVIDER. Laissez la valeur NULL comme valeur par défaut pour l'utilisateur courant, ce qui est typique.
link_owner Responsable du nouveau lien de partage. Laissez la valeur NULL comme valeur par défaut pour l'utilisateur courant, ce qui est typique.
use_default_credential Réglez à TRUE pour utiliser les mêmes données d'identification pour le lien de partage et le fournisseur de partage.
metadata Métadonnées JSON facultatives à associer au lien de partage.
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_SHARE_LINK_VIEW Procédure

Créez ou remplacez une vue nommée qui donne accès à une table partagée distante.

Syntaxe 

PROCEDURE CREATE_SHARE_LINK_VIEW  
(
    view_name            IN VARCHAR2,
    share_link_name      IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    view_owner           IN VARCHAR2 := NULL,
    share_link_owner     IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
view_name Nom de la nouvelle vue.
share_link_name Nom du lien de partage.
share_schema_name Nom du schéma partagé.
share_table_name Nom de la table partagée.
view_owner Responsable de la vue. Valeur par défaut du schéma courant.
share_link_owner Responsable du lien. Valeur par défaut du schéma courant.

CREATE_SHARE_PROVIDER Procédure

S'abonner à un fournisseur de partage delta.

Syntaxe 

PROCEDURE CREATE_SHARE_PROVIDER
(
  provider_name        IN VARCHAR2,
  endpoint             IN VARCHAR2,
  token_endpoint       IN VARCHAR2 := NULL,
  share_type           IN VARCHAR2 := 'DELTA',
  owner                IN VARCHAR2 := NULL,
  metadata             IN SYS.JSON_OBJECT_T := NULL,
  auto_commit          IN BOOLEAN := TRUE
);

Paramètres

Paramètre Description
provider_name Nom local de ce fournisseur de partages.
endpoint Point d'extrémité delta, à partir du profil de partage delta.
token_endpoint Ce paramètre est ignoré.
share_type Type de fournisseur d'actions. Laissez cela comme DELTA.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.
metadata Métadonnées JSON facultatives à associer au fournisseur de partages.
auto_commit Si TRUE (valeur par défaut), cet appel de procédure valide les modifications qui ne sont pas visibles à l'externe tant que la validation n'a pas eu lieu. Si FALSE, l'utilisateur doit COMMIT après avoir exécuté cet appel afin de rendre la modification visible.

Fonction DISCOVER_AVAILABLE_SHARES

Retournez une valeur SHARE_AVAILABLE_SHARES_ROW pour chaque table disponible des fournisseurs de partage abonnés.

Syntaxe 

FUNCTION DISCOVER_AVAILABLE_SHARES  
(
    share_provider       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL  
) RETURN share_available_shares_tbl PIPELINED;

Paramètres

Paramètre Description
share_provider Nom du fournisseur de partages.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.

Exemple : Découvrez une liste d'actions disponibles auprès d'un fournisseur donné

SQL> select available_share_name
  2    from dbms_share.discover_available_shares('share_prov')
  3   order by available_share_name;

AVAILABLE_SHARE_NAME
--------------------------------------------------------------------------------
BURLINGTON_EXPEDITION_2022 

EGYPT_EXPEDITION_2022

Fonction DISCOVER_AVAILABLE_TABLES

Retournez une valeur SHARE_AVAILABLE_TABLES_ROW pour chaque table disponible des fournisseurs de partage abonnés.

Syntaxe 

FUNCTION DISCOVER_AVAILABLE_TABLES
(
  share_provider       IN VARCHAR2 := NULL,
  share_name           IN VARCHAR2 := NULL,
  owner                IN VARCHAR2 := NULL,
  endpoint             IN VARCHAR2 := NULL,
  credential_name      IN VARCHAR2 := NULL
) RETURN share_available_tables_tbl PIPELINED;

Paramètres

Paramètre Description
share_provider Nom de fournisseur de partage facultatif. Si NULL, recherchez tous les fournisseurs de partages abonnés.
share_name Nom de partage facultatif. Si la valeur est NULL, recherchez tous les partages découverts.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.
endpoint Point d'extrémité delta facultatif.
credential_name Données d'identification facultatives du jeton du porteur pour accéder au point d'extrémité.

Exemple : Liste des partages disponibles de tous les fournisseurs de partages abonnés

SQL> select * from dbms_share.discover_available_tables()
  2  order by share_name, schema_name, table_name;

 PROVIDER_NAME             PROVIDER_OWNER  SHARE_NAME
------------------------- --------------- ------------------------------
SCHEMA_NAME               TABLE_NAME
------------------------- -------------------------
My Test Oracle Provider   ADP_SHARE_TEST  BURLINGTON_EXPEDITION_2022
SH                        COUNTRIES 

My Test Oracle Provider   ADP_SHARE_TEST  BURLINGTON_EXPEDITION_2022
SH                        SH_COUNTRIES 

My Test Oracle Provider   ADP_SHARE_TEST  EGYPT_EXPEDITION_2022
SHARED_SCHEMA             SHARED_VIEW_1 

My Test Oracle Provider   ADP_SHARE_TEST  EGYPT_EXPEDITION_2022
SHARED_SCHEMA             SHARED_VIEW_2

Exemple : Lister les tables disponibles à partir d'un point d'extrémité désabonné

SQL> exec dbms_cloud.create_credential('MY_CRED', 'BEARER_TOKEN', '123456') 
PL/SQL procedure successfully completed. 
SQL> column share_name format a13
SQL> column table_name format a20
SQL> column schema_name format a10 
SQL> select share_name, schema_name, table_name 
2   from dbms_share.discover_available_tables( 
3     endpoint=>'https://my_endpoint', 
4     credential_name=>'MY_CRED') 
5   order by 1, 2, 3; 

SHARE_NAME SCHEMA_NAM TABLE_NAME
------------- ---------- --------------------
DELTA_SHARING DEFAULT BOSTON-HOUSING
DELTA_SHARING DEFAULT COVID_19_NYT
DELTA_SHARING DEFAULT FLIGHT-ASA_2008
DELTA_SHARING DEFAULT LENDING_CLUB
DELTA_SHARING DEFAULT NYCTAXI_2019
DELTA_SHARING DEFAULT NYCTAXI_2019_PART
DELTA_SHARING DEFAULT OWID-COVID-DATA 

7 rows selected.

DROP_SHARE_LINK Procédure

Supprimez un lien de partage créé par la procédure CREATE_SHARE_LINK.

Pour plus d'informations, voir ProcédureCREATE_SHARE_LINK.

Syntaxe 

PROCEDURE DROP_SHARE_LINK  
(
    link_name            IN VARCHAR2,
    link_owner           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
link_name Nom du lien de partage à supprimer.
link_owner Responsable du lien de partage à abandonner. Laissez vide pour le schéma courant.

DROP_SHARE_PROVIDER Procédure

Déposer un abonnement à un fournisseur de partages.

Syntaxe 

PROCEDURE DROP_SHARE_PROVIDER  
(
    provider_name        IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    drop_credentials     IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages à supprimer.
owner Responsable du fournisseur d'actions à abandonner. Valeur par défaut du schéma courant.
drop_credentials Si la valeur est TRUE, toutes les informations d'identification et de connexion associées au fournisseur sont supprimées. Si FALSE, les données d'identification ne sont pas supprimées.

ENABLE_DELTA_ENDPOINT Procédure

Créez les listes de contrôle d'accès nécessaires qui permettent à l'utilisateur spécifié de se connecter à un point d'extrémité delta. Des privilèges d'administration sont requis pour cette procédure.

Syntaxe 

PROCEDURE ENABLE_DELTA_ENDPOINT  
(
    schema_name          IN VARCHAR2,
    delta_profile        IN CLOB,
    enabled              IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
schema_name Schéma à activer ou à désactiver.
delta_profile Profil delta. Seuls le point d'extrémité et tokenEndpoint sont requis.
enabled TRUE pour activer et FALSE pour désactiver.

FLUSH_SHARE_LINK_CACHE Procédure

Vider le cache des partages pour un lien de partage donné. La liste des partages pour les points d'extrémité distants est extraite au lieu de s'appuyer sur des valeurs mises en cache.

Syntaxe 

PROCEDURE FLUSH_SHARE_LINK_CACHE  
(
    link_name            IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
link_name Nom du lien de partage.
owner Responsable du lien de partage. Valeur par défaut du schéma courant.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

FLUSH_SHARE_PROVIDER_CACHE Procédure

Vider le cache des partages pour un fournisseur de partages donné. La liste des partages pour les points d'extrémité distants est extraite au lieu de s'appuyer sur des valeurs mises en cache.

Syntaxe 

PROCEDURE FLUSH_SHARE_PROVIDER_CACHE
(
  provider_name        IN VARCHAR2,
  owner                IN VARCHAR2 := NULL,
  auto_commit          IN BOOLEAN := TRUE
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

GENERATE_SHARE_LINK_SELECT Procédure et fonction

Générez une instruction SELECT qui renvoie les données d'une table partagée.

Syntaxe

Version de procédure de GENERATE_SHARE_LINK_SELECT. 

PROCEDURE GENERATE_SHARE_LINK_SELECT  
(
    share_link_name      IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    stmt                 IN OUT NOCOPY CLOB,
    share_link_owner     IN VARCHAR2 := NULL  
);
Version de fonction de GENERATE_SHARE_LINK_SELECT.
 FUNCTION GENERATE_SHARE_LINK_SELECT  
(
    share_link_name      IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_link_owner     IN VARCHAR2 := NULL  
)  
RETURN CLOB;

Paramètres

Paramètre Description
share_link_name Nom du lien de partage.
share_schema_name Nom du schéma partagé.
share_table_name Nom de la table partagée.
stmt Énoncé de sélection généré.
share_link_owner Responsable du lien. Valeur par défaut du schéma courant.

Fonction GET_ORACLE_SHARE_LINK_INFO

Extraire le nom et l'espace de noms du lien en nuage pour un partage entre Oracle et Oracle.

Syntaxe 

FUNCTION GET_ORACLE_SHARE_LINK_INFO
(
  oracle_provider_id   IN VARCHAR2,
  share_name           IN VARCHAR2,
  share_schema_name    IN VARCHAR2,
  share_table_name     IN VARCHAR2
) 
RETURN CLOB;

Paramètres

Paramètre Description
oracle_provider_id ID fournisseur Oracle de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.
share_name Nom d'un partage à partir de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.SHARES.
share_schema_name Nom d'un schéma de partage à partir de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.SHARES.
share_table_name Le nom d'une table de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.SHARES.

Retour

La valeur retournée est un objet JSON contenant trois propriétés : schéma, table et dblink. L'appelant peut utiliser ces trois propriétés pour extraire des données à l'aide d'une interrogation du formulaire suivant :

SELECT *
FROM <schema>.<table>@<dblink>

GET_SHARE_LINK_INFO Procédure

Obtenez le(s) point(s) d'extrémité, le type de partage et le nom de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un lien de partage.

Syntaxe 

PROCEDURE GET_SHARE_LINK_INFO  
(
    link_name            IN VARCHAR2,
    endpoint             IN OUT NOCOPY VARCHAR2,
    share_type           IN OUT NOCOPY VARCHAR2,
    share_name           IN OUT NOCOPY VARCHAR2,
    token_endpoint       IN OUT NOCOPY VARCHAR2,
    metadata             IN OUT NOCOPY BLOB,
    link_owner           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
link_name Nom d'un lien de partage (anciennement créé par CREATE_SHARE_LINK).
endpoint OUT : Point d'extrémité, le cas échéant, associé au lien de partage.
share_type OUT : Type de lien de partage (par exemple, DELTA).
share_name OUT : nom du partage lié.
token_endpoint Ce paramètre n'est plus utilisé.
metadata OUT : Métadonnées facultatives associées au lien de partage.
link_owner Responsable du lien de partage. Valeur par défaut du schéma courant.

GET_SHARE_PROVIDER_CREDENTIAL Procédure

Obtenez le nom des données d'identification à utiliser par l'utilisateur courant lorsqu'il tente d'accéder au fournisseur de partage delta indiqué.

Syntaxe 

PROCEDURE GET_SHARE_PROVIDER_CREDENTIAL  
(
    provider_name        IN VARCHAR2,
    share_credential     IN OUT NOCOPY VARCHAR2,
    get_token_credential IN OUT NOCOPY VARCHAR2,
    owner                IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages.
share_credential OUT : Nom des données d'identification associées au fournisseur. Le nom des données d'identification est retourné sans guillemets doubles, comme il apparaîtrait dans la colonne CREDENTIAL_NAME de la vue USER_CREDENTIALS.

Voir Vue ALL_CREDENTIALS.

get_token_credential Ce paramètre n'est pas utilisé.
owner Le responsable est le nom du schéma où le fournisseur de partages a été enregistré, et non le responsable des données d'identification. Valeur par défaut du schéma courant.

GET_SHARE_PROVIDER_INFO Procédure

Obtenez les chaînes de point d'extrémité et le type de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un fournisseur de partage. Pour les fournisseurs de partage ORACLE, l'ID fournisseur Oracle est retourné dans l'argument de point d'extrémité.

Syntaxe 

PROCEDURE GET_SHARE_PROVIDER_INFO  
(
    provider_name        IN VARCHAR2,
    endpoint             IN OUT NOCOPY VARCHAR2,
    share_type           IN OUT NOCOPY VARCHAR2,
    token_endpoint       IN OUT NOCOPY VARCHAR2,
    metadata             IN OUT NOCOPY BLOB,
    owner                IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages.
endpoint Point d'extrémité delta.
share_type Type de partage : DELTA ou ORACLE.
token_endpoint Ce paramètre n'est pas utilisé.
metadata Métadonnées facultatives associées au fournisseur de partages.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.

Fonction GET_SHARING_ID

Retourne un identificateur qui peut être utilisé en tant que sharing_id dans la procédure CREATE_SHARE_RECIPIENT. Cette fonction peut être utilisée pour partager des données entre deux utilisateurs, le "fournisseur" et le "bénéficiaire", dans différentes bases de données.

Pour plus d'informations, voir ProcédureCREATE_SHARE_RECIPIENT.

Syntaxe 

FUNCTION GET_SHARING_ID  
(
    sharing_id_type      IN VARCHAR2 := SHARING_ID_TYPE_DATABASE  
)
  RETURN VARCHAR2;

Paramètres

Paramètre Description
sharing_id_type Type de code de partage.

Syntaxe

Le flux est le suivant :

  1. Le destinataire appelle DBMS_SHARE.GET_SHARING_ID pour obtenir un identificateur unique.
  2. Le destinataire envoie cet identifiant (par exemple par e-mail) au fournisseur.
  3. Le fournisseur appelle DBMS_SHARE.CREATE_SHARE_RECIPIENT, en transmettant l'identificateur en tant que sharing_id.
  4. Le fournisseur appelle DBMS_SHARE.GRANT_TO_RECIPIENT pour donner au destinataire l'accès aux données partagées.

Le paramètre sharing_id_type est utilisé pour spécifier les utilisateurs de base de données qui peuvent accéder au partage en suivant la séquence ci-dessus.

  • DATABASE Le partage sera visible par tout administrateur de la base de données où GET_SHARING_ID a été appelé.
  • COMPARTMENT Le partage sera visible par tout administrateur de n'importe quelle base de données du même compartiment où GET_SHARING_ID a été appelé.
  • Le partage sera visible par tout administrateur de n'importe quelle base de données de la même location où GET_SHARING_ID a été appelé.
  • RÉGION Le partage sera visible par tout administrateur de n'importe quelle base de données de la même région où GET_SHARING_ID a été appelé.

OPEN_SHARE_LINK_CURSOR Procédure

Ouvrez un curseur qui renvoie les données d'une table partagée.

Syntaxe 

PROCEDURE OPEN_SHARE_LINK_CURSOR  
(
    share_link_name      IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    table_cursor         IN OUT NOCOPY SYS_REFCURSOR,
    share_link_owner     IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
share_link_name Nom du lien de partage.
share_schema_name Nom du schéma partagé.
share_table_name Nom de la table partagée.
table_cursor Le curseur.
share_link_owner Responsable du lien. Valeur par défaut du schéma courant.

REFRESH_BEARER_TOKEN_CREDENTIAL Procédure

Mettez à jour une ou plusieurs données d'identification créées par CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS en appelant les points d'extrémité de jeton enregistrés et en extrayant de nouveaux jetons de porteur. Notez que cette procédure est appelée automatiquement par un travail du programmateur, ADP$BEARER_REFRESH_JOB, qui s'exécute toutes les 50 minutes.

Pour plus d'informations, voir Procédure CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS Procédure et fonction.

Syntaxe 

PROCEDURE REFRESH_BEARER_TOKEN_CREDENTIAL  
(
    credential_name           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
credential_name Nom des données d'identification à actualiser.

RENAME_CLOUD_STORAGE_LINK Procédure

Renommez un lien de stockage en nuage enregistré.

Syntaxe 

PROCEDURE RENAME_CLOUD_STORAGE_LINK  
( 
    old_name             IN VARCHAR2,
    new_name             IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
old_name Nom courant du lien de stockage en nuage.
new_name Nouveau nom du lien de stockage en nuage.
owner Responsable du lien de stockage en nuage. Valeur par défaut du schéma courant.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

RENAME_SHARE_PROVIDER Procédure

Renommez un fournisseur de partages enregistré.

Syntaxe 

PROCEDURE RENAME_SHARE_PROVIDER
(
  old_name             IN VARCHAR2,
  new_name             IN VARCHAR2,
  owner                IN VARCHAR2 := NULL
);

Paramètres

Paramètre Description
old_name Nom courant du fournisseur de partages.
new_name Nouveau nom du fournisseur de partages.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.

REMOVE_SHARE_SCHEMA Procédure

Supprimez un schéma et tout son contenu d'un partage.

Syntaxe 

PROCEDURE REMOVE_SHARE_SCHEMA  
(
    share_name           IN VARCHAR2,
    schema_name          IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Paramètres

Paramètre Description
share_name Nom du partage.
schema_name Nom du schéma à supprimer.
share_owner Propriétaire de l'action.
auto_commit Si la valeur est TRUE, les modifications sont automatiquement validées. La valeur par défaut est FALSE.

SET_SHARE_LINK_METADATA Procédure

Définissez les métadonnées JSON supplémentaires pour le lien de partage.

Syntaxe 

PROCEDURE SET_SHARE_LINK_METADATA  
(
    link_name            IN VARCHAR2,
    metadata             IN SYS.JSON_OBJECT_T,
    replace_existing     IN BOOLEAN := FALSE,
    link_owner           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
link_name Nom du lien de partage.
metadata Les nouvelles métadonnées.
replace_existing Si TRUE, toutes les métadonnées existantes sont remplacées par la nouvelle version. Si FALSE, la nouvelle valeur est fusionnée avec les métadonnées existantes.
link_owner Responsable du lien de partage. Valeur par défaut du schéma courant.

SET_SHARE_PROVIDER_CREDENTIAL Procédure

Définissez le nom des données d'identification à utiliser par l'utilisateur courant lorsqu'il tente d'accéder au fournisseur de partage indiqué.

Syntaxe 

PROCEDURE SET_SHARE_PROVIDER_CREDENTIAL  
(
    provider_name        IN VARCHAR2,
    share_credential     IN VARCHAR2,
    get_token_credential IN VARCHAR2 := NULL,
    owner                IN VARCHAR2 := NULL,
    check_if_exists      IN BOOLEAN := TRUE  
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages.
share_credential Données d'identification du jeton du porteur.
get_token_credential Cet argument est ignoré.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.
check_if_exists Si TRUE (par défaut), vérifiez que les données d'identification existent.

SET_SHARE_PROVIDER_METADATA Procédure

Définir des métadonnées JSON supplémentaires pour le fournisseur de partages.

Syntaxe 

PROCEDURE SET_SHARE_PROVIDER_METADATA  
(
    provider_name        IN VARCHAR2,
    metadata             IN SYS.JSON_OBJECT_T,
    replace_existing     IN BOOLEAN := FALSE,
    owner                IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
provider_name Nom du fournisseur de partages.
metadata Les nouvelles métadonnées.
replace_existing Si TRUE, toutes les métadonnées existantes sont remplacées par la nouvelle version. Si FALSE, la nouvelle valeur est fusionnée avec les métadonnées existantes.
owner Propriétaire du fournisseur d'actions. Valeur par défaut du schéma courant.

UPDATE_BEARER_TOKEN_CREDENTIAL Procédure

Modifiez un attribut d'une donnée d'identification créée par CREATE_CREDENTIALS ou CREATE_BEARER_TOKEN_CREDENTIAL.

Pour plus d'informations, voir Procédure CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS Procédure et fonction.

Syntaxe 

PROCEDURE UPDATE_BEARER_TOKEN_CREDENTIAL  
(
     credential_name           IN VARCHAR2,
     attribute                 IN VARCHAR2,
     new_value                 IN VARCHAR2  
);

Paramètres

Paramètre Description
credential_name Nom des données d'identification à mettre à jour.
attribute Attribut à mettre à jour. L'une des valeurs suivantes : 'BEARER_TOKEN', 'CLIENT_ID', 'CLIENT_SECRET', 'TOKEN_REFRESH_RATE'. Le point d'extrémité du jeton ne peut pas être modifié.
new_value La nouvelle valeur.

Exemple : Mettre à jour CLIENT_ID d'une donnée d'identification 

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
ABCDEF