Créer et gérer des groupes d'hyperliens de table

Lorsque vous accédez à un groupe d'hyperliens de table, il utilise les privilèges accordés à l'utilisateur de base de données qui crée le groupe d'hyperliens de table. L'utilisateur qui crée un groupe d'hyperliens de table doit disposer des privilèges minimum requis pour fournir l'accès aux données. Pour assurer la sécurité, Oracle recommande de ne pas exécuter DBMS_DATA_ACCESS.CREATE_URL en tant qu'utilisateur ADMIN.

Pour créer un groupe d'hyperliens de table :

Notes pour créer un groupe d'hyperliens de table :

• result inclut la valeur preauth_url : cette valeur est l'URL que vous utilisez pour accéder au groupe d'hyperliens de table. Pour plus d'informations, voir Utiliser un groupe d'hyperliens de table pour accéder aux données.

• Lorsque vous générez un groupe d'hyperliens de table sur une instance de base de données autonome avec un point d'extrémité privé, le résultat inclut un nom private_preauth_url avec la valeur du formulaire : "https://private-endpoint/adb/p/parurl-token/data".

  Lorsque vous générez un groupe d'hyperliens de table sur une instance de base de données de l'IA autonome avec un point d'extrémité privé et que le point d'extrémité privé est configuré avec l'option Autoriser l'accès public activée, le résultat inclut à la fois preauth_url pour le point d'extrémité public et private_preauth_url.

  Pour plus d'informations, voir Configurer des points d'extrémité privés et Utiliser un point d'extrémité privé avec accès public autorisé.

• Utilisez DBMS_DATA_ACCESS.EXTEND_URL pour prolonger la durée de vie d'un groupe d'hyperliens de table. Lorsque vous exécutez DBMS_DATA_ACCESS.EXTEND_URL avec une valeur id pour un groupe d'hyperliens de table, cela ne prolonge que l'expiration des membres ajoutés lorsque vous créez le groupe avec DBMS_DATA_ACCESS.CREATE_URL (cela n'inclut pas les hyperliens de table ajoutés avec DBMS_DATA_ACCESS.ADD_MEMBER). Les hyperliens de table ajoutés avec DBMS_DATA_ACCESS.ADD_MEMBER existent également indépendamment du contexte du groupe d'hyperliens de table et vous pouvez exécuter DBMS_DATA_ACCESS.EXTEND_URL indépendamment sur ces hyperliens de table.

  Pour plus d'informations, voir ProcédureEXTEND_URL.

• Utilisez le paramètre password pour créer un groupe d'hyperliens de table protégé par mot de passe. Si vous incluez le paramètre de mot de passe, vous pouvez également utiliser max_failed_access_attempts pour spécifier le nombre maximal d'échecs de tentatives de mot de passe séquentielles; si cette valeur est dépassée, le groupe d'hyperliens de table est invalidé.

  Pour plus d'informations, voir Hyperlien Créer une table protégée par mot de passe.

• Voir Notes pour créer un hyperlien de table ou un groupe d'hyperliens de table pour plus d'informations sur les paramètres facultatifs pour DBMS_DATA_ACCESS.CREATE_URL.

Utilisez DBMS_DATA_ACCESS.ADD_MEMBER pour ajouter un hyperlien de table existant à un groupe. Exemple :

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.ADD_MEMBER(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        member_id => 'Zdd1Px7QWASdqDbnndiuwTAyyEstv82PCHlS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Les paramètres sont les suivants :

• id : Spécifie l'ID groupe d'hyperliens de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe d'hyperliens de table. Pour plus d'informations, voir Créer un groupe d'hyperliens de table.

• member_id : Spécifie un ID hyperlien de table existant à ajouter au groupe. La valeur member_id ne peut pas être un ID groupe d'hyperliens de table (is_group_url doit être false). Pour plus d'informations, voir Lister les hyperliens de table et les groupes d'hyperliens de table.

• result : Fournit JSON qui indique le résultat de l'opération.

Pour plus d'informations, voir ProcédureADD_MEMBER.

Utilisez DBMS_DATA_ACCESS.REMOVE_MEMBER pour supprimer un membre d'un groupe d'hyperliens de table. Exemple :

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.REMOVE_MEMBER(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        member_id => 'Zdd1Px7QWASdqDbnndiuwTAyyEstv82PCHlS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Les paramètres sont les suivants :

• id : Spécifie l'ID groupe d'hyperliens de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe d'hyperliens de table. Pour plus d'informations, voir Créer un groupe d'hyperliens de table.

• member_id : Spécifie l'ID membre à supprimer du groupe d'hyperliens de table.

• result : Fournit JSON qui indique le résultat de l'opération.

Notes pour supprimer un membre :

• La valeur member_id ne peut pas être un ID groupe d'hyperliens de table (is_group_url doit être false). Pour plus d'informations, voir Notes relatives à la liste des hyperliens de table et des groupes d'hyperliens de table.

• Vous pouvez utiliser DBMS_DATA_ACCESS.LIST_MEMBERS pour lister les membres d'un groupe d'hyperliens de table. Pour plus d'informations, voir Notes relatives à la liste des hyperliens de table et des groupes d'hyperliens de table.

• Si le membre supprimé est un hyperlien de table existant qui a été ajouté au groupe à l'aide de DBMS_DATA_ACCESS.ADD_MEMBER, le membre est supprimé du groupe, mais il est possible d'accéder directement à l'hyperlien de table jusqu'à ce qu'il soit explicitement invalidé ou expire.

• Si un groupe d'hyperliens de table contient un seul membre et que ce membre est supprimé, le groupe est invalidé.

Pour plus d'informations, voir ProcédureREMOVE_MEMBER.

Utilisez DBMS_DATA_ACCESS.INVALIDATE_URL pour invalider un groupe d'hyperliens de table. Exemple :

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.INVALIDATE_URL(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Les paramètres sont les suivants :

• id : Spécifie l'ID groupe d'hyperliens de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe d'hyperliens de table. Pour plus d'informations, voir Créer un groupe d'hyperliens de table.

• result : Fournit JSON qui indique le résultat de l'opération.

Pour plus d'informations, voir ProcédureINVALIDATE_URL.