Oracle fournit un ensemble important de documents de commande JSON, dans le fichier de texte brut POList.json, sous la forme d'un tableau JSON des objets, où chaque objet représente un document.

curl -X GET "https://raw.githubusercontent.com/oracle/db-sample-schemas/master/order_entry/POList.json" -o POList.json

curl -X PUT -u 'ADMIN:password' \
"https://example-db.adb.us-phoenix-1.oraclecloudapps.com/ords/admin/soda/latest/purchaseorder"

curl -X POST -H -u 'ADMIN:password' 'Content-type: application/json' -d @POList.json \
"https://example-db.adb.us-phoenix-1.oraclecloudapps.com/ords/admin/soda/latest/purchaseorder?action=insert"

SELECT id, t.*
  FROM purchaseorder
    NESTED json_document COLUMNS(PONumber, Reference, Requestor) t;

Vous pouvez accéder à SODA pour REST sur Autonomous Database à l'aide de l'authentification OAuth. Selon votre application, l'accès à SODA pour REST avec l'authentification OAuth peut améliorer les performances et la sécurité.

1. En tant qu'utilisateur ADMIN, accédez à Database Actions et créez un utilisateur disposant des privilèges requis.
   1. Accédez à Database Actions en tant qu'ADMIN.
      Pour plus d'informations, reportez-vous à Accès à Database Actions en tant qu'ADMIN.
   2. Dans Database Actions, cliquez sur pour afficher les actions disponibles.
   3. Dans Database Actions, sous Administration, sélectionnez Utilisateurs de base de données.
   4. Cliquez sur Créer un utilisateur.
   5. Dans la zone Créer un utilisateur, dans l'onglet Utilisateur, entrez le nom utilisateur et le mot de passe, puis confirmez le mot de passe.
   6. Sélectionnez Accès au Web.
   7. Dans la zone Créer un utilisateur, sélectionnez l'onglet Rôles attribués et octroyez DWROLE à l'utilisateur.
   8. Cliquez sur Créer un utilisateur.

   Pour plus d'informations, reportez-vous à Gestion des utilisateurs et des rôles utilisateur sur Autonomous Database - Connexion avec Database Actions.

2. Utilisez une feuille de calcul SQL dans Database Actions afin d'accorder les privilèges utilisateur requis pour charger des données.
   1. Accédez à Database Actions en tant qu'ADMIN.
      Pour plus d'informations, reportez-vous à Accès à Database Actions en tant qu'ADMIN.
   2. Dans Database Actions, cliquez sur pour afficher les actions disponibles.
   3. Dans Database Actions, sous Développement, cliquez sur SQL pour ouvrir une feuille de calcul SQL.
   4. Accordez les privilèges utilisateur requis pour charger des données à l'utilisateur de l'étape 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Pour plus d'informations, reportez-vous à Gestion des privilèges utilisateur sur Autonomous Database - Connexion avec un outil client.

3. Déconnectez-vous en tant qu'utilisateur ADMIN.
4. Connectez-vous à Database Actions en tant qu'utilisateur configuré de sorte à utiliser l'authentification OAuth.
5. Dans Database Actions, utilisez une feuille de calcul SQL pour inscrire le client OAuth.
   1. Enregistrez le client OAuth.
      Par exemple, saisissez les commandes suivantes dans la feuille de calcul SQL, dans lesquelles vous indiquez les valeurs appropriées pour l'utilisateur et l'application client.

      BEGIN
        OAUTH.create_client(
          p_name            => 'my_client',
          p_grant_type      => 'client_credentials',
          p_owner           => 'Example Company',
          p_description     => 'A client for my SODA REST resources',
          p_support_email   => 'user_name@example.com',
          p_privilege_names => 'my_priv'
        );
       
        OAUTH.grant_client_role(
          p_client_name => 'my_client',
          p_role_name   => 'SQL Developer'
        );
       
        OAUTH.grant_client_role(
          p_client_name => 'my_client',
          p_role_name   => 'SODA Developer'
        );
        COMMIT;
      END;
      /

   2. Dans la feuille de calcul SQL, cliquez sur Exécuter un script pour exécuter la commande.

   Pour plus d'informations, reportez-vous à Référence de package PL/SQL OAUTH.

   Cette commande inscrit un client nommé my_client afin d'accéder au privilège my_priv à l'aide des informations d'identification client OAuth.

6. Obtenez les éléments client_id et client_secret requis pour générer le jeton d'accès.
   Par exemple, dans SQL Worksheet, exécutez la commande suivante :

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Obtenez le jeton d'accès. Pour obtenir un jeton d'accès, envoyez une demande REST GET à database_ORDS_urluser_name/oauth/token.

   L'élément database_ORDS_url est disponible à partir de Database Actions, sous Services associés, sur la carte Services et soda RESTful. Pour plus d'informations sur l'accès aux services RESTful et à SODA pour REST.

   Dans la commande suivante, utilisez les éléments client_id et client_secret obtenus à l'étape 6.

   L'exemple suivant utilise l'outil de ligne de commande cURL (http://curl.haxx.se/) pour soumettre des demandes REST vers Autonomous Database. Cependant, d'autres clients et bibliothèques REST 3ème partie devraient également fonctionner.

   Vous pouvez utiliser l'outil de ligne de commande cURL pour soumettre la demande REST GET. Par exemple :

   > curl -i -k --user SBA-iO9Xe12cdZHYfryBGQ..:vvUQ1AagTqAqdA2oN7afSg.. --data "grant_type=client_credentials"https://mqssyowmqvgac1y-doc.adb.region.oraclecloudapps.com/ords/user_name/oauth/token
   HTTP/1.1 200 OK
   Date: Mon, 22 Jun 2020 15:17:11 GMT
   Content-Type: application/jsonTransfer-Encoding: chunked
   Connection: keep-alive
   X-Frame-Options: SAMEORIGIN  
   
   {"access_token":"JbOKtAuDgEh2DXx0QhvPGg","token_type":"bearer","expires_in":3600}

   Pour spécifier à la fois client_id et client_secret avec l'argument curl --user, entrez deux-points pour séparer client_id et client_secret. Si vous indiquez uniquement le nom utilisateur client_id, curl vous invite à saisir un mot de passe et vous pouvez saisir client_secret à l'invite.

8. Utilisez le jeton d'accès pour accéder à la ressource protégée.

   Le jeton obtenu à l'étape précédente est transmis dans l'en-tête d'autorisation. Par exemple :

   > curl -i -H "Authorization: Bearer JbOKtAuDgEh2DXx0QhvPGg" -X GET https://database_id.adb.region.oraclecloudapps.com/ords/user_name/soda/latest
   HTTP/1.1 200 OK
   Date: Mon, 22 Jun 2020 15:20:58 GMT
   Content-Type: application/json
   Content-Length: 28
   Connection: keep-alive
   X-Frame-Options: SAMEORIGIN
   Cache-Control: private,must-revalidate,max-age=0
   
   
   {"items":[],"hasMore":false}