表ハイパーリンク・グループにアクセスすると、表ハイパーリンク・グループを作成するデータベース・ユーザーに付与された権限が使用されます。表ハイパーリンク・グループを作成するユーザーには、データへのアクセスを提供するために必要な最小限の権限が必要です。セキュリティを維持するために、Oracleでは、ADMINユーザーとしてDBMS_DATA_ACCESS.CREATE_URLを実行しないことをお薦めします。

表のハイパーリンク・グループを作成するには、次の手順を実行します。

表ハイパーリンク・グループの作成に関するノート:

• resultには、表ハイパーリンク・グループへのアクセスに使用するURLであるpreauth_url値が含まれます。詳細は、「表ハイパーリンク・グループを使用したデータへのアクセス」を参照してください。

• プライベート・エンドポイントを含むAutonomous Databaseインスタンスで表ハイパーリンク・グループを生成すると、結果には"https://private-endpoint/adb/p/parurl-token/data"という形式の値を持つprivate_preauth_urlという名前が含まれます。

  プライベート・エンドポイントを含むAutonomous Databaseインスタンスで表ハイパーリンク・グループを生成し、プライベート・エンドポイントが「パブリック・アクセスの許可」を有効にして構成されている場合、結果にはパブリック・エンドポイントのpreauth_urlとprivate_preauth_urlの両方が含まれます。

  詳細は、プライベート・エンドポイントの構成およびパブリック・アクセスを許可したプライベート・エンドポイントの使用を参照してください。

• DBMS_DATA_ACCESS.EXTEND_URLを使用して、表ハイパーリンク・グループの存続期間を延長します。表ハイパーリンク・グループ用のidを使用してDBMS_DATA_ACCESS.EXTEND_URLを実行すると、DBMS_DATA_ACCESS.CREATE_URLを使用してグループを作成したときに追加されたメンバーの有効期限のみが延長されます(これには、DBMS_DATA_ACCESS.ADD_MEMBERで追加された表ハイパーリンクは含まれません)。DBMS_DATA_ACCESS.ADD_MEMBERで追加された表ハイパーリンクも、表ハイパーリンク・グループのコンテキストの外部で独立して存在し、それらの表ハイパーリンクでDBMS_DATA_ACCESS.EXTEND_URLを独立して実行できます。

  詳細は、EXTEND_URLプロシージャを参照してください。

• DBMS_DATA_ACCESS.CREATE_URLのオプション・パラメータの詳細は、「表ハイパーリンクを作成するためのノート」を参照してください。

DBMS_DATA_ACCESS.ADD_MEMBERを使用して、既存の表ハイパーリンクをグループに追加します。たとえば:

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

パラメータは次のとおりです。

• id: 表のハイパーリンク・グループIDを指定します。これは、表ハイパーリンク・グループの作成時に結果に表示されるid値です。詳細は、「表ハイパーリンク・グループの作成」を参照してください。

• member_id: グループに追加する既存の表ハイパーリンクIDを指定します。member_id値は表ハイパーリンク・グループIDにできません(is_group_urlはfalseである必要があります)。詳細は、表ハイパーリンクおよび表ハイパーリンク・グループのリストを参照してください。

• result: 操作の結果を示すJSONを提供します。

詳細は、ADD_MEMBERプロシージャを参照してください。

DBMS_DATA_ACCESS.REMOVE_MEMBERを使用して、表ハイパーリンク・グループからメンバーを削除します。たとえば:

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

パラメータは次のとおりです。

• id: 表のハイパーリンク・グループIDを指定します。これは、表ハイパーリンク・グループの作成時に結果に表示されるid値です。詳細は、「表ハイパーリンク・グループの作成」を参照してください。

• member_id: 表ハイパーリンク・グループから削除するメンバーIDを指定します。

• result: 操作の結果を示すJSONを提供します。

メンバーを削除するためのノート:

• member_id値は表ハイパーリンク・グループIDにできません(is_group_urlはfalseである必要があります)。詳細は、「表ハイパーリンクおよび表ハイパーリンク・グループのリストに関するノート」を参照してください。

• DBMS_DATA_ACCESS.LIST_MEMBERSを使用して、表ハイパーリンク・グループのメンバーをリストできます。詳細は、「表ハイパーリンクおよび表ハイパーリンク・グループのリストに関するノート」を参照してください。

• 削除されたメンバーが、DBMS_DATA_ACCESS.ADD_MEMBERを使用してグループに追加された既存の表ハイパーリンクである場合、そのメンバーはグループから削除されますが、表ハイパーリンクは明示的に無効化されるか期限切れになるまで直接アクセスできます。

• 表ハイパーリンク・グループに1つのメンバーのみが含まれ、そのメンバーが削除された場合、グループは無効化されます。

詳細は、REMOVE_MEMBERプロシージャを参照してください。

DBMS_DATA_ACCESS.INVALIDATE_URLを使用して、表ハイパーリンク・グループを無効化します。たとえば:

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

パラメータは次のとおりです。

• id: 表のハイパーリンク・グループIDを指定します。これは、表ハイパーリンク・グループの作成時に結果に表示されるid値です。詳細は、「表ハイパーリンク・グループの作成」を参照してください。

• result: 操作の結果を示すJSONを提供します。

詳細は、INVALIDATE_URLプロシージャを参照してください。