Documentation Oracle Cloud Infrastructure

Récapitulatif des sous-programmes destinataires de partage

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

Sous-programmes Description
Procédure ASSERT_SHARING_ID Exécutez des vérifications de validation de base sur un ID de partage et renvoyez-en un sous forme canonique.
CREATE_CREDENTIALS Procédure et fonction Créez des informations d'identification contenant le jeton de support à partir d'un profil delta.
Procédure CREATE_OR_REPLACE_SHARE_LINK Abonnez-vous pour partager à partir d'un fournisseur de partage enregistré.
Procédure CREATE_OR_REPLACE_ORACLE_SHARE_PROVIDER Abonnez-vous à un fournisseur de partage Oracle, avec un nom local.
Procédure CREATE_ORACLE_SHARE_PROVIDER Abonnez-vous à un fournisseur de partage Oracle, avec un nom local.
Procédure CREATE_SHARE_LINK Abonnez-vous pour partager à partir d'un fournisseur de partage enregistré.
Procédure CREATE_SHARE_LINK_VIEW Créez ou remplacez une vue nommée qui donne accès à une table partagée distante.
Procédure CREATE_SHARE_PROVIDER S'abonner à un fournisseur de partage delta.
Fonction DISCOVER_AVAILABLE_SHARES Renvoyer un SHARE_AVAILABLE_SHARES_ROW pour chaque table disponible à partir des fournisseurs de partage abonnés.
Fonction DISCOVER_AVAILABLE_TABLES Renvoyez une valeur SHARE_AVAILABLE_TABLES_ROW pour chaque table disponible à partir des fournisseurs de partage abonnés ou d'une adresse delta explicite.
Procédure DROP_SHARE_LINK Supprimez un lien de partage créé par la procédure CREATE_SHARE_LINK.
Procédure DROP_SHARE_PROVIDER Déposez un abonnement à un fournisseur de partage.
Procédure ENABLE_DELTA_ENDPOINT Créez les listes de contrôle d'accès nécessaires qui permettent à l'utilisateur indiqué de se connecter à une adresse delta.
Procédure FLUSH_SHARE_LINK_CACHE Videz le cache des partages pour un lien de partage donné.
Procédure FLUSH_SHARE_PROVIDER_CACHE Videz le cache des partages pour un fournisseur de partage donné.
GENERATE_SHARE_LINK_SELECT Procédure et fonction Générer une instruction SELECT qui renvoie des données à partir d'une table partagée.
Fonction GET_ORACLE_SHARE_LINK_INFO Extrayez le nom et l'espace de noms du lien cloud pour un partage Oracle-Oracle.
Procédure GET_SHARE_LINK_INFO Obtenez les adresses, le type de partage et le nom de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un lien de partage.
Procédure GET_SHARE_PROVIDER_CREDENTIAL Obtenez le nom des informations d'identification à utiliser par l'utilisateur en cours lorsqu'il tente d'accéder au fournisseur de partage delta indiqué.
Procédure GET_SHARE_PROVIDER_INFO Obtenez les chaînes d'adresse et le type de partage, ainsi que toutes les métadonnées JSON supplémentaires pour un fournisseur de partage.
Fonction GET_SHARING_ID Renvoie un identificateur qui peut être utilisé en tant que sharing_id dans la procédure CREATE_SHARE_RECIPIENT.
Procédure OPEN_SHARE_LINK_CURSOR Ouvrez un curseur qui renvoie les données d'une table partagée.
Procédure REFRESH_BEARER_TOKEN_CREDENTIAL Mettez à jour les informations d'identification créées par CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS.
Procédure RENAME_CLOUD_STORAGE_LINK Renommez un lien de stockage cloud inscrit.
Procédure RENAME_SHARE_LINK Renommez un lien de partage enregistré.
Procédure RENAME_SHARE_PROVIDER Renommez un fournisseur de partage enregistré.
Procédure REMOVE_SHARE_SCHEMA Supprimez un schéma et tout son contenu d'un partage.
Procédure SET_SHARE_LINK_METADATA Définissez les métadonnées JSON supplémentaires pour le lien de partage.
Procédure SET_SHARE_PROVIDER_CREDENTIAL Définissez le nom des informations d'identification pour accéder au fournisseur de partage indiqué.
Procédure SET_SHARE_PROVIDER_METADATA Définissez des métadonnées JSON supplémentaires pour le fournisseur de partage.
Procédure UPDATE_BEARER_TOKEN_CREDENTIAL Modifiez un attribut d'informations d'identification créé par CREATE_CREDENTIALS ou CREATE_BEARER_TOKEN_CREDENTIAL.

Rubrique parent : Package DBMS_SHARE

Procédure ASSERT_SHARING_ID

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

Syntaxe

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

Paramètres

Paramètre Description
sharing_id ID à vérifier.
out_sharing_id_type Type de l'ID, le cas échéant. Par exemple, TENANCY ou DATABASE.

CREATE_CREDENTIALS Procédure et fonction

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

Syntaxe

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

Voici la version fonctionnelle de create_credentials qui renvoie le nom des nouvelles informations d'identification au format 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 informations d'identification à créer.
delta_profile Profil de partage delta, au format JSON, obtenu auprès du fournisseur de partage.
{
  "shareCredentialsVersion": 1,
  "endpoint": "https://<endpoint>",
  "bearerToken": "<token>",
  "expirationTime": "...",
}
Le profil peut également, éventuellement, 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, reportez-vous à Format de fichier de profil et Jeton Bearer.

out_credential_name Nom des informations d'identification de jeton de support nouvellement créées.

Procédure CREATE_OR_REPLACE_SHARE_LINK

Abonnez-vous pour partager à partir d'un fournisseur de partage 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 de partage enregistré.
share_name Nom du partage provenant du fournisseur de partage.
provider_owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.
link_owner Propriétaire du lien de partage. La valeur par défaut est le schéma actuel.
use_default_credential Si la valeur est TRUE, utilisez les mêmes informations d'identification que le fournisseur de partage.
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 en externe jusqu'à ce que la validation ait lieu. Si la valeur est FALSE, l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel pour que la modification soit visible.

Procédure CREATE_OR_REPLACE_ORACLE_SHARE_PROVIDER

Abonnez-vous à un fournisseur de partage Oracle, avec un nom local.

Elle apparaît ensuite dans la vue ALL_SHARE_PROVIDERS avec RECIPIENT_TYPE = 'ORACLE'.

Remarque

Utilisez la procédure SET_STORAGE_CREDENTIAL pour ajouter des informations d'identification au lien de stockage. Reportez-vous à Procédure SET_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 de la liaison de stockage cloud. Le nom du lien doit respecter les conventions de dénomination Oracle standard. Reportez-vous à Noms et qualificatifs d'objet de base de donnée.
uri URI du bucket de stockage. L'URI doit être au format https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Propriétaire de la liaison de stockage. La valeur par défaut est le schéma actuel.
metadata Document de métadonnées JSON facultatif contenant des informations supplémentaires.
auto_commit Si la valeur est TRUE, les modifications sont validées automatiquement après la création du lien. La valeur par défaut est TRUE.

Procédure CREATE_ORACLE_SHARE_PROVIDER

Abonnez-vous à un fournisseur de partage Oracle, avec un nom local.

Elle apparaît 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 de fournisseur obtenu à partir de la vue ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.

Reportez-vous à ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS View.

provider_name Nom local du fournisseur
owner Propriétaire du nouveau fournisseur de partage. Conservez la valeur NULL pour l'utilisateur actuel.
metadata Métadonnées JSON facultatives à associer au fournisseur.
auto_commit Si la valeur est TRUE, les modifications sont validées automatiquement après la création du lien. La valeur par défaut est TRUE.

Procédure CREATE_SHARE_LINK

Abonnez-vous pour partager à partir d'un fournisseur de partage 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. Elle doit respecter les conventions de dénomination Oracle standard et ne doit pas nécessairement être identique au paramètre share_name.
share_provider Nom du fournisseur de partage répertorié dans ALL_SHARE_PROVIDERS qui partageait 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 partage, comme indiqué dans ALL_SHARE_PROVIDER. Conservez la valeur NULL par défaut pour l'utilisateur en cours, ce qui est courant.
link_owner Propriétaire du nouveau lien de partage. Conservez la valeur NULL par défaut pour l'utilisateur en cours, ce qui est courant.
use_default_credential Définissez la valeur sur Vrai pour utiliser les mêmes informations d'identification pour le lien de partage et le fournisseur de partage.
metadata Métadonnées JSON facultatives associées au lien de partage.
auto_commit Si la valeur est TRUE, les modifications sont validées automatiquement après la création du lien. La valeur par défaut est TRUE.

Procédure CREATE_SHARE_LINK_VIEW

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 Propriétaire de la vue. La valeur par défaut est le schéma actuel.
share_link_owner Propriétaire du lien. La valeur par défaut est le schéma actuel.

Procédure CREATE_SHARE_PROVIDER

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 partage.
endpoint Adresse delta, du profil de partage delta.
token_endpoint Le paramètre est ignoré.
share_type Type de fournisseur de partage. Laissez-le comme DELTA.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.
metadata Métadonnées JSON facultatives à associer au fournisseur de partage.
auto_commit Si TRUE (valeur par défaut), cet appel de procédure valide les modifications qui ne sont pas visibles en externe jusqu'à ce que la validation ait lieu. Si la valeur est FALSE, l'utilisateur doit valider (COMMIT) après avoir exécuté cet appel pour que la modification soit visible.

Fonction DISCOVER_AVAILABLE_SHARES

Renvoyer un SHARE_AVAILABLE_SHARES_ROW pour chaque table disponible à partir 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 partage.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.

Exemple : découverte d'une liste de partages 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

Renvoyer un SHARE_AVAILABLE_TABLES_ROW pour chaque table disponible à partir 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 partage abonnés.
share_name Nom de partage facultatif. Si NULL, recherchez tous les partages repérés.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.
endpoint Adresse delta facultative.
credential_name Informations d'identification de jeton de support facultatives permettant d'accéder à l'adresse.

Exemple : liste des partages disponibles à partir 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 : répertorier les tables disponibles à partir d'une adresse désabonnée

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.

Procédure DROP_SHARE_LINK

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

Pour plus d'informations, reportez-vous à Procédure CREATE_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 Propriétaire du lien de partage à supprimer. Conservez la valeur NULL pour le schéma en cours.

Procédure DROP_SHARE_PROVIDER

Déposez un abonnement à un fournisseur de partage.

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 partage à supprimer.
owner Propriétaire du fournisseur de partage à supprimer. La valeur par défaut est le schéma actuel.
drop_credentials Si la valeur est Vrai, toutes les informations d'identification associées au fournisseur sont supprimées. Si la valeur est FALSE, les informations d'identification ne sont pas supprimées.

Procédure ENABLE_DELTA_ENDPOINT

Créez les listes de contrôle d'accès nécessaires qui permettent à l'utilisateur indiqué de se connecter à une adresse 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 Le profil delta. Seules l'adresse et tokenEndpoint sont requises.
enabled Vrai pour activer et Faux pour désactiver.

Procédure FLUSH_SHARE_LINK_CACHE

Videz le cache des partages pour un lien de partage donné. La liste des partages pour les adresses distantes est extraite au lieu de s'appuyer sur les 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 Propriétaire du lien de partage. La valeur par défaut est le schéma actuel.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

Procédure FLUSH_SHARE_PROVIDER_CACHE

Videz le cache des partages pour un fournisseur de partage donné. La liste des partages pour les adresses distantes est extraite au lieu de s'appuyer sur les 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 partage.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

GENERATE_SHARE_LINK_SELECT Procédure et fonction

Générer une instruction SELECT qui renvoie des données à partir 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 la fonction 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 Instruction SELECT générée.
share_link_owner Propriétaire du lien. La valeur par défaut est le schéma actuel.

Fonction GET_ORACLE_SHARE_LINK_INFO

Extrayez le nom et l'espace de noms du lien cloud pour un partage Oracle-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 L'ID de Fournisseur Oracle à partir de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.
share_name Nom d'un partage provenant 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 Nom d'une table à partir de ALL_AVAILABLE_ORACLE_SHARE_PROVIDERS.SHARES.

Retour

La valeur renvoyée est un objet JSON contenant trois propriétés : schéma, table et lien de table. L'appelant peut utiliser ces trois propriétés pour extraire des données à l'aide d'une requête de la forme suivante :

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

Procédure GET_SHARE_LINK_INFO

Obtenez les adresses, 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 (précédemment créé par CREATE_SHARE_LINK).
endpoint OUT : adresse, le cas échéant, associée 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 Propriétaire du lien de partage. La valeur par défaut est le schéma actuel.

Procédure GET_SHARE_PROVIDER_CREDENTIAL

Obtenez le nom des informations d'identification à utiliser par l'utilisateur en cours 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 partage.
share_credential OUT : nom des informations d'identification associées au fournisseur. Le nom des informations d'identification est renvoyé sans guillemets doubles, car il apparaît dans la colonne CREDENTIAL_NAME de la vue USER_CREDENTIALS.

Reportez-vous à ALL_CREDENTIALS View.

get_token_credential Ce paramètre n'est pas utilisé.
owner Le propriétaire est le nom du schéma dans lequel le fournisseur de partage a été inscrit, et non le propriétaire des informations d'identification. La valeur par défaut est le schéma actuel.

Procédure GET_SHARE_PROVIDER_INFO

Obtenez les chaînes d'adresse 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 de fournisseur Oracle est renvoyé dans l'argument d'adresse.

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 partage.
endpoint Adresse 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 partage.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.

Fonction GET_SHARING_ID

Renvoie 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 "destinataire", dans différentes bases de données.

Pour plus d'informations, reportez-vous à Procédure CREATE_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 d'ID de partage.

Utilisation

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, transmettant l'identificateur en tant que sharing_id.
  4. Le fournisseur appelle DBMS_SHARE.GRANT_TO_RECIPIENT pour autoriser le destinataire à accéder aux données partagées.

Le paramètre sharing_id_type permet d'indiquer 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 tous les administrateurs de la base de données dans laquelle GET_SHARING_ID a été appelé.
  • Le partage sera visible par tous les administrateurs de n'importe quelle base de données du même compartiment où GET_SHARING_ID a été appelé.
  • TENANCE Le partage sera visible par tous les administrateurs de n'importe quelle base de données de la même location où GET_SHARING_ID a été appelé.
  • REGION Le partage sera visible par tous les administrateurs de n'importe quelle base de données de la région dans laquelle GET_SHARING_ID a été appelé.

Procédure OPEN_SHARE_LINK_CURSOR

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 Propriétaire du lien. La valeur par défaut est le schéma actuel.

Procédure REFRESH_BEARER_TOKEN_CREDENTIAL

Mettez à jour les informations d'identification créées par CREATE_BEARER_TOKEN_CREDENTIAL ou CREATE_CREDENTIALS en appelant les adresses de jeton inscrites et en extrayant de nouveaux jetons de support. Cette procédure est appelée automatiquement par un travail de planificateur, ADP$BEARER_REFRESH_JOB, qui s'exécute toutes les 50 minutes.

Pour plus d'informations, reportez-vous à Procédure CREATE_BEARER_TOKEN_CREDENTIAL ou Procédure et fonction CREATE_CREDENTIALS.

Syntaxe

PROCEDURE REFRESH_BEARER_TOKEN_CREDENTIAL  
(
    credential_name           IN VARCHAR2 := NULL  
);

Paramètres

Paramètre Description
credential_name Nom des informations d'identification à actualiser.

Procédure RENAME_CLOUD_STORAGE_LINK

Renommez un lien de stockage cloud inscrit.

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 en cours de la liaison de stockage cloud.
new_name Nouveau nom de la liaison de stockage cloud.
owner Propriétaire de la liaison de stockage cloud. La valeur par défaut est le schéma actuel.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. La valeur par défaut est TRUE.

Procédure RENAME_SHARE_PROVIDER

Renommez un fournisseur de partage 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 actuel du fournisseur de partage.
new_name Nouveau nom du fournisseur de partage.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.

Procédure REMOVE_SHARE_SCHEMA

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 à enlever.
share_owner Propriétaire de la part.
auto_commit Si la valeur est Vrai, les modifications sont automatiquement validées. La valeur par défaut est FALSE.

Procédure SET_SHARE_LINK_METADATA

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 la valeur est TRUE, toutes les métadonnées existantes sont remplacées par la nouvelle version. Si la valeur est FALSE, la nouvelle valeur est fusionnée avec les métadonnées existantes.
link_owner Propriétaire du lien de partage. La valeur par défaut est le schéma actuel.

Procédure SET_SHARE_PROVIDER_CREDENTIAL

Définissez le nom des informations d'identification à utiliser par l'utilisateur en cours 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 partage.
share_credential Informations d'identification de jeton du porteur.
get_token_credential Cet argument est ignoré.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.
check_if_exists Si la valeur est TRUE (valeur par défaut), vérifiez que les informations d'identification existent.

Procédure SET_SHARE_PROVIDER_METADATA

Définissez des métadonnées JSON supplémentaires pour le fournisseur de partage.

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 partage.
metadata Les nouvelles métadonnées.
replace_existing Si la valeur est TRUE, toutes les métadonnées existantes sont remplacées par la nouvelle version. Si la valeur est FALSE, la nouvelle valeur est fusionnée avec les métadonnées existantes.
owner Propriétaire du fournisseur de partage. La valeur par défaut est le schéma actuel.

Procédure UPDATE_BEARER_TOKEN_CREDENTIAL

Modifiez un attribut d'informations d'identification créé par CREATE_CREDENTIALS ou CREATE_BEARER_TOKEN_CREDENTIAL.

Pour plus d'informations, reportez-vous à Procédure CREATE_BEARER_TOKEN_CREDENTIAL ou Procédure et fonction CREATE_CREDENTIALS.

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 informations d'identification à mettre à jour.
attribute Attribut à mettre à jour. L'une des options suivantes : 'BEARER_TOKEN', 'CLIENT_ID', 'CLIENT_SECRET', 'TOKEN_REFRESH_RATE'. L'adresse de jeton ne peut pas être modifiée.
new_value Nouvelle valeur.

Exemple : mettre à jour l'adresse CLIENT_ID d'informations 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