Utilisation du SODA pour REST avec Autonomous AI Database

Oracle fournit un ensemble substantiel de documents de commande d'achat JSON, dans le fichier en texte brut POList.json, en tant que tableau JSON d'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 une base de données Autonomous AI à 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'utilisateur ADMIN.
      Pour plus d'informations, reportez-vous à Accès à Database Actions en tant qu'administrateur.
   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 Nom utilisateur et un mot de passe, puis confirmez le mot de passe.
   6. Sélectionnez Accès Web.
   7. Dans la zone Créer un utilisateur, sélectionnez l'onglet Rôles accordés et accordez 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 AI Database - Connexion à Database Actions.

2. Utilisez une feuille de calcul SQL dans Database Actions pour accorder les privilèges utilisateur requis pour charger les données.
   1. Accédez à Database Actions en tant qu'utilisateur ADMIN.
      Pour plus d'informations, reportez-vous à Accès à Database Actions en tant qu'administrateur.
   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 à l'utilisateur les privilèges requis pour charger des données à partir de l'étape 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Pour plus d'informations, reportez-vous à Gestion des privilèges utilisateur sur une base de données Autonomous AI - Connexion à un outil client.

3. Déconnectez-vous en tant qu'utilisateur ADMIN.
4. Connectez-vous à Database Actions en tant qu'utilisateur configuré pour 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, entrez les commandes suivantes dans la feuille de calcul SQL, où vous fournissez les valeurs appropriées pour votre utilisateur et votre 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 le script pour exécuter la commande.

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

   Un client nommé my_client est ainsi inscrit pour accéder au privilège my_priv à l'aide des informations d'identification du client OAuth.

6. Obtenez les valeurs client_id et client_secret requises pour générer le jeton d'accès.
   Par exemple, dans la feuille de calcul SQL, 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, vous envoyez une demande REST GET à database_ORDS_urluser_name/oauth/token.

   database_ORDS_url est disponible à partir de Database Actions, sous Services associés, sur la carte RESTful Services and Soda. Pour plus d'informations, reportez-vous à Accès aux services RESTful et au service 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 à la base de données Autonomous AI. Cependant, d'autres clients et bibliothèques REST 3e partie doivent é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 indiquer à la fois client_id et client_secret avec l'argument de boucle --user, entrez le signe deux-points pour séparer client_id et client_secret. Si vous indiquez uniquement le nom utilisateur client_id, la boucle 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}