スキーマ・オブジェクト(表またはビュー)のアクセスを共有するために使用できるPAR URLを生成するステップを示します。

1. 共有する表またはビューを特定します。

   使用可能にするデータに制限がある場合は、PAR URLの生成時にapplication_user_idパラメータを使用し、公開するデータを制限するVPDポリシーを作成します。詳細は、PAR URLデータを保護するための仮想プライベート・データベース・ポリシーの定義を参照してください。

2. DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URLを実行してPAR URLを生成します。

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URL(
             schema_name => 'ADMIN',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             service_name         => 'HIGH',
             result                => status);
          dbms_output.put_line(status);
       END;
   /

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

3. 結果を確認します。

   この例では、statusにPAR URLに関する情報を含む結果が含まれています。

   {
   "status":"SUCCESS","id":"wPY0uxyx-gioxOndiKVlqVF585xqJs14CIp9M1qH",
   "preauth_url":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/-pPLdrbUTcLUrZLExyzxyzabc_1w/data",
   "expiration_ts":"2024-10-22T22:37:18.805Z",
   "expiration_count":null
   }

   また、次のこともできます:

   • PAR URLを表示するには、DBMS_DATA_ACCESS.LIST_ACTIVE_URLSを使用します。詳細は、PAR URLのリストを参照してください。
   • PAR URLの存続期間を延長するには、DBMS_DATA_ACCESS.EXTEND_URLを使用します。詳細は、EXTEND_URLプロシージャを参照してください。
   • 異なるサービス・レベルの保証とリソースでサービスされるPAR URLを生成します。たとえば、オブジェクトまたはSQL文へのアクセスはサービスHIGHまたはMEDIUMにマップできますが、別のオブジェクトまたはSQL文へのアクセスはLOWサービスにマップできます。詳細は、GET_PREAUTHENTICATED_URLプロシージャを参照してください。

SQL問合せ文を使用してデータへのアクセスを提供するPAR URLを生成するステップを示します。

1. 共有する情報を含む表またはビュー、および使用する表またはビューのSELECT文を特定します。

   使用可能にするデータに制限がある場合は、PAR URLの生成時にapplication_user_idパラメータを使用し、公開するデータを制限するVPDポリシーを作成します。詳細は、PAR URLデータを保護するための仮想プライベート・データベース・ポリシーの定義を参照してください。

2. DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URLを実行してPAR URLを生成します。

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URL(
             sql_statement        => 'SELECT species, height FROM TREE_DATA',
             expiration_count     => 10,
             service_name         => 'HIGH',
             result               => status);
          dbms_output.put_line(status);
       END;
   /

   sql_statementパラメータ値は、SELECT文である必要があります。SELECT文では、バインド変数がサポートされています。バインド変数が選択文に含まれている場合、データにアクセスするときに、生成されたPAR URLにバインド変数値を問合せパラメータとして追加する必要があります。バインド変数のサポートは、NUMBERおよびVARCHAR2列タイプで使用できます。

   このサンプルのexpiration_countパラメータは、PAR URLが期限切れになり、10回の使用後に無効になるように指定します。expiration_timeを指定しない場合、有効期限はデフォルト値90日に設定されます。

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

3. 結果を確認します。

   この例では、statusにPAR URLを含む結果が含まれています。

   {
   "status":"SUCCESS","id":"LCvtpALqZgcHGL4Lxyzabcxyza-QVEFngwh1UGhg8jjuFAHOQJLGFi",
   "preauth_url":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/RIabc_xyz7Kw8ZLyZ2JzCXZQXpc/data",
   "expiration_ts":"2025-01-20T16:42:49.527Z",
   "expiration_count":10}
   }

   また、次のこともできます:

   • PAR URLを表示するには、DBMS_DATA_ACCESS.LIST_ACTIVE_URLSを使用します。詳細は、PAR URLのリストを参照してください。
   • PAR URLの存続期間を延長するには、DBMS_DATA_ACCESS.EXTEND_URLを使用します。詳細は、EXTEND_URLプロシージャを参照してください。
   • 異なるサービス・レベルの保証とリソースでサービスされるPAR URLを生成します。たとえば、オブジェクトまたはSQL文へのアクセスはサービスHIGHまたはMEDIUMにマップできますが、別のオブジェクトまたはSQL文へのアクセスはLOWサービスにマップできます。詳細は、GET_PREAUTHENTICATED_URLプロシージャを参照してください。

PAR URLを生成するときに、column_listsパラメータを使用して、指定した列のUI機能を指定できます。

1. 共有する表またはビューまたはSELECT文を指定します。

   この例では、column_listsパラメータを表とともに使用してPAR URLを生成します。このパラメータは、SELECT文を使用してPAR URLを生成する場合にも使用できます。

   詳細は、表またはビューのPAR URLの生成およびSELECT文を使用したPAR URLの生成を参照してください。

2. DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URLを実行してPAR URLを生成し、ブラウザで表示するための列別グループ・オプションを指定します:

   たとえば、列によるグループ化を指定するには:

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URL(
             schema_name => 'ADMIN',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             service_name          => 'HIGH',
             column_lists          => '{ "group_by_columns": ["COUNTY", "SPECIES"] }',
             result                => status);
   
          dbms_output.put_line(status);
       END;
   /

   column_listsパラメータは、PAR-URL機能を定義する列のJSON配列のリストを含むJSONです。このパラメータを使用して、1つ以上のオプション(order_by_columns、filter_columns、default_color_columnsまたはgroup_by_columns)の列を指定します。

   たとえば:

   column_lists => '{ 
           "group_by_columns":["COUNTY", "SPECIES"], 
           "order_by_columns":["COUNTY"] }'

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

3. 結果を確認します。

   この例では、statusにPAR URLに関する情報を含む結果が含まれています。

   {
   "status":"SUCCESS",
   "id":"LLUZjJ5Yy8d0txydMiuxCVL_j4abc_xyzV1989GmgRInaBYTw",
   "preauth_url":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/Rt_yRfTxbcabc_xyzWlANP5RmM9Y/data",
   "expiration_ts":"2024-10-25T02:30:39.810Z",
   "expiration_count":null
   }

   列別グループの使用例については、「表形式のグループ化オプションを使用したデータへのアクセスにPAR URLを使用」を参照してください。

4. DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URLを実行してPAR URLを生成し、UIフォーマット・オプションを指定します。

   たとえば、ソート可能な列を設定するには、column_lists order_by_columnsオプションを使用します。

   DECLARE
      status CLOB;
      column_lists CLOB;
      BEGIN
         DBMS_DATA_ACCESS.GET_PREAUTHENTICATED_URL(
             schema_name => 'ADMIN',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             service_name          => 'HIGH',
             column_lists          => '{ "order_by_columns": ["COUNTY", "SPECIES"] }',
             result                => status);
          dbms_output.put_line(status);
       END;
   /

   column_listsパラメータは、PAR-URL機能を定義する列のJSON配列のリストを含むJSONです。このパラメータを使用して、1つ以上のオプション(order_by_columns、filter_columns、default_color_columnsまたはgroup_by_columns)の列を指定します。

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

5. 結果を確認します。

   この例では、statusにPAR URLに関する情報を含む結果が含まれています。

   {
   "status":"SUCCESS",
   "id":"LLUZjJ5Yy8d0txydMiuxCVL_j4abc_xyzV1989GmgRInaBYTw",
   "preauth_url":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/Rt_yRfTxbcabc_xyzk3EmM9Y/data",
   "expiration_ts":"2024-10-25T02:30:39.810Z",
   "expiration_count":null
   }

   列の順序の使用例については、列ソートでの表形式でのPAR URLの使用を参照してください。

Autonomous Databaseインスタンスで生成したアクティブなPAR URLをリストでき、ADMINユーザーはすべてのアクティブなPAR URLをリストできます。

DECLARE    
    result CLOB;
    BEGIN
       result := DBMS_DATA_ACCESS.LIST_ACTIVE_URLS;           
       dbms_output.put_line(result);
    END;
/

[{
"id":"lsB5yJzrG2E-o_Diwf7O86p1TphhHs3abcdefgoPuK",
"schema_name":"ADMIN",
"schema_object_name":"TREE_DATA",
"created_by":"ADMIN",
"service_name":"HIGH",
"expiration_time":"2024-10-31T03:02:31.996Z",
"access_count":0,
"created":"2024-10-30T21:02:32.041Z",
"column_lists":{"group_by_columns":["COUNTY","SPECIES"]}
}]

適切な権限を持つユーザーは、いつでもPAR URLを無効にできます。

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

1. PAR URLの生成時に指定したapplication_user_id値を取得します。
2. PAR URLを生成したデータベースでVPDポリシーを作成します。

   CREATE OR REPLACE FUNCTION limit_sal (v_schema IN VARCHAR2, v_objname IN VARCHAR2)
     RETURN VARCHAR2 authid current_user AS
   BEGIN
        RETURN 'employee_id = SYS_CONTEXT(''DATA_ACCESS_CONTEXT$'', ''USER_IDENTITY'')';
   END;
   

   詳細は、DBMS_RLSを参照してください。

3. VPDポリシーを登録します。

   BEGIN
      DBMS_RLS.ADD_POLICY( 
           object_schema        => 'HR',
           object_name          => 'EMPLOYEE',
           policy_name          => 'POL',
           policy_function      => 'LIMIT_SAL');
   END;
   /

   詳細は、DBMS_RLSを参照してください。

Autonomous Databaseには、PAR URLの使用状況をモニターできるビューが用意されています。