Présente les étapes de génération d'un lien hypertexte de table que vous pouvez utiliser pour partager l'accès à un objet de schéma (table ou vue).

1. Identifiez la table ou la vue à partager.

   Si des restrictions s'appliquent aux données que vous souhaitez rendre disponibles, utilisez le paramètre application_user_id lorsque vous générez le lien hypertexte de table et créez une stratégie VPD pour restreindre les données que vous affichez. Pour plus d'informations, reportez-vous à Définition d'une stratégie de base de données privée virtuelle pour sécuriser les données de lien hypertexte de table.

2. Exécutez DBMS_DATA_ACCESS.CREATE_URL pour générer le lien hypertexte de table.

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

   Le paramètre expiration_minutes indique que le lien hypertexte de table expire et est invalidé au bout de 360 minutes.

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

3. Vérifiez le résultat.

   Dans cet exemple, status contient le résultat qui inclut des informations sur le lien hypertexte de table.

   {
   "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
   }

Présente les étapes de génération d'un lien hypertexte de table qui permet d'accéder aux données à l'aide d'une instruction de requête SQL.

1. Identifiez la table ou la vue contenant les informations à partager, ainsi que l'instruction SELECT sur la table ou la vue à utiliser.

   Si des restrictions s'appliquent aux données que vous souhaitez rendre disponibles, utilisez le paramètre application_user_id lorsque vous générez le lien hypertexte de table et créez une stratégie VPD pour restreindre les données que vous affichez. Pour plus d'informations, reportez-vous à Définition d'une stratégie de base de données privée virtuelle pour sécuriser les données de lien hypertexte de table.

2. Exécutez DBMS_DATA_ACCESS.CREATE_URL pour générer le lien hypertexte de table.

   Vous disposez de deux options, selon que vous souhaitez inclure des valeurs de variable attachée (bind variables) par défaut (si vous incluez des variables attachées dans l'instruction SELECT).

   1. Fournissez une instruction SELECT et n'utilisez pas le paramètre facultatif default_bind_values.

      Exemples :

      DECLARE
         status CLOB;
         BEGIN
            DBMS_DATA_ACCESS.CREATE_URL(
                sql_statement        => 'SELECT species, height FROM TREE_DATA',
                expiration_minutes   => 360,
                result               => status);
             dbms_output.put_line(status);
          END;
      /

      La valeur sql_statement doit être une instruction SELECT. L'instruction SELECT prend en charge les variables attachées. Si des variables attachées sont incluses dans l'instruction SELECT, les valeurs des variables attachées doivent être ajoutées au lien hypertexte de table généré en tant que paramètre de requête lors de l'accès aux données.
   2. Fournissez une instruction SELECT et incluez le paramètre default_bind_values.

      Exemples :

      DECLARE
         status CLOB;
         BEGIN
            DBMS_DATA_ACCESS.CREATE_URL(
                sql_statement => 'select * FROM TREE_DATA WHERE COUNTY = :countyNAME',
                default_bind_values  => '{"countyNAME" : "First"}',
                expiration_minutes   => 360,
                result               => status);
             dbms_output.put_line(status);
          END;
      /

      Le paramètre sql_statement doit être une instruction SELECT. L'instruction SELECT prend en charge les variables attachées.

      Le paramètre default_bind_values indique des valeurs pour une ou plusieurs variables attachées dans sql_statement. Lorsque default_bind_values est inclus dans DBMS_DATA_ACCESS.CREATE_URL, procédez comme suit :

      • Pour les variables attachées indiquées dans default_bind_values, vous pouvez omettre les valeurs des variables attachées lorsque vous accédez aux données. La valeur par défaut est utilisée pour une variable attachée spécifiée si aucun remplacement n'est fourni dans l'URL du lien hypertexte de table en tant que paramètre de requête lorsque vous accédez aux données.

      • Vous pouvez remplacer une valeur de variable attachée par défaut indiquée dans default_bind_values si vous ajoutez la valeur de variable attachée dans l'URL de lien hypertexte de table en tant que paramètre de requête lorsque vous accédez aux données.

      • Si une variable attachée est incluse dans l'instruction SELECT et qu'aucune valeur par défaut n'est indiquée pour la variable attachée dans le paramètre default_bind_values, vous devez ajouter une valeur de variable attachée à l'URL de lien hypertexte de table générée en tant que paramètre de requête lorsque vous accédez aux données.

   La prise en charge des variables attachées est disponible pour les types de colonne NUMBER et VARCHAR2.

   Dans ces exemples, le paramètre expiration_minutes indique que le lien hypertexte de table expire et est invalidé après 360 minutes.

3. Vérifiez le résultat.

   Dans cet exemple, status contient le résultat qui inclut le lien hypertexte de table.

   {
   "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"}
   }

Lorsque vous générez un lien hypertexte de table, vous pouvez utiliser le paramètre column_lists pour indiquer les fonctionnalités d'interface utilisateur pour les colonnes indiquées.

1. Identifiez la table ou la vue ou sélectionnez l'instruction à partager.

   Cet exemple génère un lien hypertexte de table à l'aide du paramètre column_lists avec une table. Vous pouvez également utiliser ce paramètre lorsque vous générez un lien hypertexte de table avec une instruction SELECT.

   Pour plus d'informations, reportez-vous à Générer un lien hypertexte de table pour une table ou une vue et à Générer un lien hypertexte de table avec une instruction Select.

2. Exécutez DBMS_DATA_ACCESS.CREATE_URL pour générer le lien hypertexte de table et indiquez l'option Grouper par colonnes à afficher avec un navigateur :

   Par exemple, pour indiquer des colonnes de regroupement :

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

   Le paramètre column_lists est un fichier JSON qui contient la liste des tableaux JSON de colonnes définissant la fonctionnalité de lien hypertexte de table. Utilisez ce paramètre pour indiquer les colonnes pour une ou plusieurs des options : order_by_columns, filter_columns, default_color_columns ou group_by_columns.

   Par exemple :

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

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

3. Vérifiez le résultat.

   Dans cet exemple, status contient le résultat qui inclut des informations sur le lien hypertexte de table.

   {
   "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
   }

   Reportez-vous à Utilisation des liens hypertexte de table pour accéder aux données avec l'option Grouper par dans le format de table pour obtenir un exemple montrant l'utilisation des colonnes de regroupement.

4. Exécutez DBMS_DATA_ACCESS.CREATE_URL pour générer le lien hypertexte de table et indiquez une option de format d'interface utilisateur.

   Par exemple, pour définir les colonnes pouvant être triées, utilisez l'option column_lists order_by_columns :

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

   Le paramètre column_lists est un fichier JSON qui contient la liste des tableaux JSON de colonnes définissant la fonctionnalité de lien hypertexte de table. Utilisez ce paramètre pour indiquer les colonnes pour une ou plusieurs des options : order_by_columns, filter_columns, default_color_columns ou group_by_columns.

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

5. Vérifiez le résultat.

   Dans cet exemple, status contient le résultat qui inclut des informations sur le lien hypertexte de table.

   {
   "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
   }

   Reportez-vous à la section Use Table Hyperlinks in Table Format with Column Sorting pour obtenir un exemple illustrant l'utilisation de l'ordre par colonne.

A tout moment, un utilisateur disposant des privilèges appropriés peut invalider un lien hypertexte de table.

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

1. Obtenez la valeur application_user_id que vous avez indiquée lorsque vous avez généré le lien hypertexte de table.
2. Créez une stratégie VPD sur la base de données dans laquelle vous avez généré le lien hypertexte de table.

   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;
   

   Pour plus d'informations, reportez-vous à DBMS_RLS.

3. Enregistrez la stratégie VPD.

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

   Pour plus d'informations, reportez-vous à DBMS_RLS.

Autonomous Database fournit des vues qui vous permettent de surveiller l'utilisation des liens hypertexte de table.

Remarques concernant la génération d'un lien hypertexte de table avec DBMS_DATA_ACCESS.CREATE_URL :

• Vous pouvez utiliser le paramètre facultatif service_name pour indiquer que le lien hypertexte de table généré est traité avec une garantie et des ressources de niveau de service spécifiques. Par exemple, utilisez le paramètre service_name pour indiquer que l'accès à l'instruction SQL est mis en correspondance avec le service HIGH.

• Vous pouvez utiliser le paramètre facultatif inherit_acl pour limiter l'accès aux données de lien hypertexte de table. Définissez ce paramètre sur TRUE pour hériter des listes de contrôle d'accès. Lorsque la valeur de ce paramètre est TRUE, l'adresse IP d'un destinataire de lien hypertexte de table entrant est validée avec les listes de contrôle d'accès de la base de données du producteur avant d'autoriser l'accès aux données. Si aucune liste de contrôle d'accès n'est configurée pour la base de données du fournisseur, la valeur inherit_acl est ignorée et l'accès aux données est autorisé sans aucune vérification d'ACL.

  Pour plus d'informations, reportez-vous à Configuration de l'accès réseau avec des règles de contrôle d'accès (ACL).

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

  Lorsque vous générez un lien 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 preauth_url pour l'adresse publique et private_preauth_url.

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

• Utilisez DBMS_DATA_ACCESS.LIST_ACTIVE_URLS pour afficher les liens hypertexte de table. Pour plus de détails, reportez-vous à Liste des liens hypertexte de table et des groupes de liens hypertexte de table.

• Utilisez DBMS_DATA_ACCESS.EXTEND_URL pour prolonger la durée de vie d'un lien hypertexte de table. Pour plus d'informations, reportez-vous à Procédure EXTEND_URL.