Oracle stellt ein umfangreiches Set von JSON-Bestelldokumenten in der Nur-Text-Datei POList.json als JSON-Array von Objekten bereit, wobei jedes dieser Objekte ein Dokument darstellt.

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;

Sie können mit der OAuth-Authentifizierung auf SODA for REST in Autonomous Database zugreifen. Je nach Anwendung kann der Zugriff auf SODA for REST mit der OAuth-Authentifizierung die Performance und Sicherheit verbessern.

1. Greifen Sie als ADMIN-Benutzer auf Database Actions zu, und erstellen Sie einen Benutzer mit den erforderlichen Berechtigungen.
   1. Greifen Sie als ADMIN auf Database Actions zu.
      Weitere Informationen finden Sie unter Auf Database Actions als ADMIN zugreifen.
   2. Klicken Sie in Database Actions auf , um die verfügbaren Aktionen anzuzeigen.
   3. Wählen Sie unter Administration in Database Actions die Option Database Users aus.
   4. Klicken Sie auf Benutzer erstellen.
   5. Geben Sie im Bereich Benutzer erstellen auf der Registerkarte Benutzer den Benutzernamen und ein Kennwort ein, und bestätigen Sie das Kennwort.
   6. Wählen Sie Webzugriff aus.
   7. Wählen Sie im Bereich Benutzer erstellen die Registerkarte Erteilte Rollen aus, und erteilen Sie dem Benutzer DWROLE.
   8. Klicken Sie auf Benutzer erstellen.

   Weitere Informationen finden Sie unter Benutzer und Benutzerrollen in Autonomous Database verwalten - Mit Database Actions verbinden.

2. Verwenden Sie ein SQL-Arbeitsblatt in Database Actions, um Benutzerberechtigungen zu erteilen, die zum Laden von Daten erforderlich sind.
   1. Greifen Sie als ADMIN auf Database Actions zu.
      Weitere Informationen finden Sie unter Auf Database Actions als ADMIN zugreifen.
   2. Klicken Sie in Database Actions auf , um die verfügbaren Aktionen anzuzeigen.
   3. Klicken Sie in Database Actions unter Entwicklung auf SQL, um ein SQL-Arbeitsblatt zu öffnen.
   4. Erteilen Sie die erforderlichen Benutzerberechtigungen, um Daten aus Schritt 1 an den Benutzer zu laden.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Weitere Informationen finden Sie unter Benutzerberechtigungen in Autonomous Database verwalten - Verbindung mit einem Clienttool herstellen.

3. Melden Sie sich als ADMIN-Benutzer ab.
4. Melden Sie sich bei Database Actions als Benutzer an, der die OAuth-Authentifizierung verwendet.
5. Registrieren Sie in Database Actions den OAuth-Client mit einem SQL-Arbeitsblatt.
   1. Registrieren Sie den OAuth-Client.
      Beispiel: Geben Sie die folgenden Befehle in das SQL-Arbeitsblatt ein, in dem Sie die entsprechenden Werte für den Benutzer und die Clientanwendung angeben.

      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. Klicken Sie im SQL-Arbeitsblatt auf Skript ausführen, um den Befehl auszuführen.

   Weitere Informationen finden Sie unter OAUTH PL/SQL Package Reference.

   Dadurch wird ein Client mit dem Namen my_client registriert, um mit den OAuth-Clientzugangsdaten auf die Berechtigung my_priv zuzugreifen.

6. Rufen Sie die erforderlichen Werte für client_id und client_secret ab, um das Zugriffstoken zu generieren.
   Beispiel: Führen Sie im SQL Worksheet den folgenden Befehl aus:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Rufen Sie das Zugriffstoken auf. Um ein Zugriffstoken abzurufen, senden Sie eine REST GET-Anforderung an database_ORDS_urluser_name/oauth/token.

   Die database_ORDS_url ist über Database Actions unter Zugehörige Services auf der Karte RESTful Services und Soda verfügbar. Weitere Informationen finden Sie unter Auf RESTful-Services und SODA for REST zugreifen.

   Verwenden Sie im folgenden Befehl client_id und client_secret, die Sie in Schritt 6 abgerufen haben.

   Im folgenden Beispiel wird das Befehlszeilentool cURL (http://curl.haxx.se/) verwendet, um REST-Anforderungen an Autonomous Database weiterzuleiten. Andere REST-Clients und -Bibliotheken der 3. Partei sollten jedoch ebenfalls funktionieren.

   Mit dem Befehlszeilentool cURL können Sie die Anforderung REST GET weiterleiten. Beispiel:

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

   Um sowohl client_id als auch client_secret mit dem Argument curl --user anzugeben, geben Sie einen Doppelpunkt ein, um client_id und client_secret zu trennen. Wenn Sie nur den Benutzernamen client_id angeben, fordert curl zur Eingabe eines Kennworts auf, und Sie können client_secret an der Eingabeaufforderung eingeben.

8. Mit dem Zugriffstoken können Sie auf die geschützte Ressource zugreifen.

   Das im vorherigen Schritt erhaltene Token wird im Autorisierungsheader übergeben. Beispiel:

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