Oracle stellt eine umfangreiche Gruppe von JSON-Bestelldokumenten in der Nur-Text-Datei POList.json als JSON-Array von Objekten bereit, bei denen jedes derartige Objekt 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 in Autonomous Database mit der OAuth-Authentifizierung auf SODA for REST zugreifen. Der Zugriff auf SODA for REST mit OAuth-Authentifizierung kann je nach Anwendung die Performance und Sicherheit verbessern.

1. Rufen Sie als ADMIN-Benutzer Database Actions auf, und erstellen Sie einen Benutzer mit den erforderlichen Berechtigungen.
   1. Als ADMIN auf Database Actions zugreifen
      Weitere Informationen finden Sie unter Als ADMIN auf Database Actions zugreifen.
   2. Klicken Sie unter "Datenbankaktionen" auf , um die verfügbaren Aktionen anzuzeigen.
   3. Wählen Sie in den Datenbankaktionen unter Administration die Option Datenbankbenutzer aus.
   4. Klicken Sie auf Benutzer erstellen.
   5. Geben Sie im Bereich Benutzer erstellen auf der Registerkarte Benutzer einen 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 die Berechtigung DWROLE.
   8. Klicken Sie auf Benutzer erstellen.

   Weitere Informationen finden Sie unter Benutzer und Benutzerrollen in Autonomous Database verwalten - Verbindung mit Database Actions herstellen.

2. Verwenden Sie ein SQL-Arbeitsblatt in Database Actions, um Benutzerberechtigungen zum Laden von Daten zu erteilen.
   1. Als ADMIN auf Database Actions zugreifen
      Weitere Informationen finden Sie unter Als ADMIN auf Database Actions zugreifen.
   2. Klicken Sie unter "Datenbankaktionen" 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 dem Benutzer ab Schritt 1 die erforderlichen Benutzerberechtigungen zum Laden von Daten.

      GRANT UNLIMITED TABLESPACE TO user_name;

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

3. Melden Sie sich als ADMIN-Benutzer ab.
4. Melden Sie sich bei Database Actions als der Benutzer an, für den die Verwendung der OAuth-Authentifizierung eingerichtet ist.
5. Verwenden Sie in Database Actions ein SQL-Arbeitsblatt, um den OAuth-Client zu registrieren.
   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-Paketreferenz.

   Dadurch wird ein Client mit dem Namen my_client registriert, um mit den OAuth-Clientzugangsdaten auf die Berechtigung my_priv zugreifen zu können.

6. Rufen Sie die client_id und das client_secret ab, die zum Generieren des Zugriffstokens erforderlich sind.
   Beispiel: Führen Sie im SQL-Arbeitsblatt den folgenden Befehl aus:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

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

   database_ORDS_url ist über Datenbankaktionen unter Zugehörige Services in der Karte RESTful Services und Soda verfügbar. Weitere Informationen finden Sie unter Auf RESTful Services und SODA for REST zugreifen.

   Verwenden Sie das client_id und das client_secret, die Sie in Schritt 6 abgerufen haben.

   Im folgenden Beispiel wird das Befehlstool cURL (http://curl.haxx.se/) verwendet, um REST-Anforderungen an Autonomous Database zu übermitteln. Andere REST-Clients und -Bibliotheken von 3rd Party sollten jedoch ebenfalls funktionieren.

   Sie können das Befehlszeilentool cURL verwenden, um die REST GET-Anforderung zu übermitteln. Beispiele:

   > 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 zum Trennen von client_id und client_secret ein. Wenn Sie nur den Benutzernamen client_id, angeben, fragt curl nach einem Kennwort, 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 abgerufene Token wird im Autorisierungsheader übergeben. Beispiele:

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