Utiliser SODA pour REST avec Autonomous AI Database

Oracle fournit un jeu substantiel de documents de commande d'achat JSON, dans le fichier de texte brut POList.json, en tant que tableau d'objets JSON, où chaque objet de ce type 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 AI Database à l'aide de l'authentification OAuth. Selon votre application, l'accès à SODA pour REST avec l'authentification OAuth peut améliorer la performance et la sécurité.

1. En tant qu'utilisateur ADMIN, accédez à Database Actions et créez un utilisateur doté des privilèges requis.
   1. Accédez à Database Actions en tant qu'ADMIN.
      Pour plus d'informations, voir Accéder à 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 d'utilisateur et un Mot de passe et 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 octroyés et accordez DWROLE à l'utilisateur.
   8. Cliquez sur Créer un utilisateur.

   Pour plus d'informations, voir Gérer les utilisateurs et les rôles d'utilisateur dans Autonomous AI Database - Connexion à Database Actions.

2. Utilisez une feuille de calcul SQL dans Database Actions pour accorder aux utilisateurs les privilèges requis pour charger des données.
   1. Accédez à Database Actions en tant qu'ADMIN.
      Pour plus d'informations, voir Accéder à Database Actions en tant qu'administrateur.
   2. Dans Database Actions, cliquez sur pour afficher les actions disponibles.
   3. Dans Database Actions, sous Development (Développement), cliquez sur SQL pour ouvrir une feuille de calcul SQL.
   4. Accordez à l'utilisateur les privilèges requis pour charger les données à partir de l'étape 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Pour plus d'informations, voir Gérer les privilèges d'utilisateur sur une base de données autonome avec intelligence artificielle - 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 enregistrer 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, voir Informations de référence sur l'ensemble PL/SQL OAUTH.

   Cela enregistre un client nommé my_client pour accéder au privilège my_priv à l'aide des données d'identification de 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 connexes, sur la carte RESTful Services and Soda. Pour plus d'informations, voir Accéder aux services RESTful et SODA pour REST.

   Dans la commande suivante, utilisez 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 à Autonomous AI Database. Cependant, d'autres clients et bibliothèques REST de 3e partie devraient également fonctionner.

   Vous pouvez utiliser l'outil de ligne de commande cURL pour soumettre la demande REST GET. 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 un deux-points pour séparer client_id et client_secret. Si vous spécifiez uniquement le nom d'utilisateur, client_id, curl invite à entrer un mot de passe et vous pouvez entrer 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 Autorisation. 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}