Lorsque vous accédez à un groupe de liens hypertexte de table, il utilise les privilèges accordés à l'utilisateur de base de données qui crée le groupe de liens hypertexte de table. L'utilisateur qui crée un groupe de liens hypertexte de table doit disposer des privilèges minimum requis pour fournir l'accès aux données. Pour maintenir 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 de liens hypertexte de table :

Remarques concernant la création d'un groupe de liens hypertexte de table :

• result inclut la valeur preauth_url qui est l'URL que vous utilisez pour accéder au groupe de liens hypertexte de table. Pour plus d'informations, reportez-vous à Utilisation d'un groupe de liens hypertexte de table pour accéder aux données.

• Lorsque vous générez un groupe de liens hypertexte de table sur une instance Autonomous Database avec une adresse privée, le résultat inclut un nom private_preauth_url avec la valeur du format : "https://private-endpoint/adb/p/parurl-token/data".

  Lorsque vous générez un groupe de liens hypertexte de table sur une instance Autonomous Database avec une adresse privée et que l'adresse privée est configurée avec l'option Autoriser l'accès public activée, le résultat inclut à la fois l'adresse preauth_url pour l'adresse publique et private_preauth_url.

  Pour plus d'informations, reportez-vous à Configuration des adresses privées et à Utilisation d'une adresse privée avec accès public autorisé.

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

  Pour plus d'informations, reportez-vous à Procédure EXTEND_URL.

• Pour plus d'informations sur les paramètres facultatifs de DBMS_DATA_ACCESS.CREATE_URL, reportez-vous à Notes pour la création d'un lien hypertexte de table.

Utilisez DBMS_DATA_ACCESS.ADD_MEMBER pour ajouter un lien hypertexte de table existant à un groupe. Par 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 : indique l'ID de groupe de liens hypertexte de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe de liens hypertexte de table. Pour plus d'informations, reportez-vous à Création d'un groupe de liens hypertexte de table.

• member_id : indique un ID de lien hypertexte de table existant à ajouter au groupe. La valeur member_id ne peut pas être un ID de groupe de liens hypertexte de table (is_group_url doit être false). Pour plus d'informations, reportez-vous à Liste des liens hypertexte de table et groupes de liens hypertexte de table.

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

Pour plus d'informations, reportez-vous à Procédure ADD_MEMBER.

Utilisez DBMS_DATA_ACCESS.REMOVE_MEMBER pour enlever un membre d'un groupe de liens hypertexte de table. Par 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 : indique l'ID de groupe de liens hypertexte de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe de liens hypertexte de table. Pour plus d'informations, reportez-vous à Création d'un groupe de liens hypertexte de table.

• member_id : indique l'ID de membre à enlever du groupe de liens hypertexte de table.

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

Remarques concernant la suppression d'un membre :

• La valeur member_id ne peut pas être un ID de groupe de liens hypertexte de table (is_group_url doit être false). Pour plus d'informations, reportez-vous à Remarques sur la liste des liens hypertexte de table et des groupes de liens hypertexte de table.

• Vous pouvez utiliser DBMS_DATA_ACCESS.LIST_MEMBERS pour répertorier les membres d'un groupe de liens hypertexte de table. Pour plus d'informations, reportez-vous à Remarques sur la liste des liens hypertexte de table et des groupes de liens hypertexte de table.

• Si le membre enlevé est un lien hypertexte de table existant qui a été ajouté au groupe à l'aide de DBMS_DATA_ACCESS.ADD_MEMBER, le membre est enlevé du groupe, mais le lien hypertexte de table est accessible directement jusqu'à ce qu'il soit explicitement invalidé ou expire.

• Si un groupe de liens hypertexte de table ne contient qu'un seul membre et que ce membre est supprimé, le groupe est invalidé.

Pour plus d'informations, reportez-vous à Procédure REMOVE_MEMBER.

Utilisez DBMS_DATA_ACCESS.INVALIDATE_URL pour invalider un groupe de liens hypertexte de table. Par 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 : indique l'ID de groupe de liens hypertexte de table. Il s'agit de la valeur id affichée dans le résultat lorsque vous créez un groupe de liens hypertexte de table. Pour plus d'informations, reportez-vous à Création d'un groupe de liens hypertexte de table.

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

Pour plus d'informations, reportez-vous à Procédure INVALIDATE_URL.