Usa SODA per REST con Autonomous Database

Oracle fornisce un set sostanziale di documenti di ordine di acquisto JSON, nel file di testo in chiaro POList.json, come array JSON di oggetti, in cui ogni oggetto di questo tipo rappresenta un documento.

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;

Puoi accedere a SODA per REST su Autonomous Database utilizzando l'autenticazione OAuth. A seconda dell'applicazione, l'accesso a SODA per REST con l'autenticazione OAuth può migliorare le prestazioni e la sicurezza.

1. Come utente ADMIN, accedere a Database Actions e creare un utente con i privilegi richiesti.
   1. Accedere alle azioni del database come ADMIN.
      Per ulteriori informazioni, vedere Accedere alle azioni del database come ADMIN.
   2. In Database Actions fare clic su per visualizzare le azioni disponibili.
   3. In Azioni database, in Amministrazione selezionare Utenti database.
   4. Fare clic su Crea utente.
   5. Nell'area Create User, nella scheda User immettere User Name e Password e confermare la password.
   6. Selezionare Accesso Web.
   7. Nell'area Crea utente, selezionare la scheda Ruoli concessi e concedere DWROLE all'utente.
   8. Fare clic su Crea utente.

   Per ulteriori informazioni, vedere Gestire utenti e ruoli utente in Autonomous Database - Connessione con Database Actions.

2. Utilizzare un foglio di lavoro SQL in Database Actions per concedere i privilegi utente necessari per caricare i dati.
   1. Accedere alle azioni del database come ADMIN.
      Per ulteriori informazioni, vedere Accedere alle azioni del database come ADMIN.
   2. In Database Actions fare clic su per visualizzare le azioni disponibili.
   3. In Azioni database, in Sviluppo fare clic su SQL per aprire un foglio di lavoro SQL.
   4. Concedere i privilegi utente necessari per caricare i dati nell'utente dal passo 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Per ulteriori informazioni, vedere Gestisci privilegi utente su Autonomous Database - Connessione con uno strumento client.

3. Disconnettersi come utente ADMIN.
4. Accedere a Database Actions come utente configurato per utilizzare l'autenticazione OAuth.
5. In Database Actions utilizzare un foglio di lavoro SQL per registrare il client OAuth.
   1. Registrare il client OAuth.
      Ad esempio, immettere i comandi seguenti nel foglio di lavoro SQL, in cui è possibile fornire i valori appropriati per l'utente e l'applicazione 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. Nel foglio di lavoro SQL fare clic su Esegui script per eseguire il comando.

   Per ulteriori informazioni, vedere Informazioni di riferimento sul package PL/SQL OAUTH.

   Registra un client denominato my_client per accedere al privilegio my_priv utilizzando le credenziali client OAuth.

6. Ottenere i valori client_id e client_secret necessari per generare il token di accesso.
   Ad esempio, nel foglio di lavoro SQL eseguire il comando seguente:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Ottenere il token d'accesso. Per ottenere un token di accesso, inviare una richiesta REST GET a database_ORDS_urluser_name/oauth/token.

   database_ORDS_url è disponibile da Database Actions, in Servizi correlati, sulla scheda RESTful Servizi e Soda. Per ulteriori informazioni, vedere Accedi ai servizi RESTful e SODA per REST.

   Nel comando seguente, utilizzare client_id e client_secret ottenuti al passo 6.

   Nell'esempio seguente viene utilizzato lo strumento della riga di comando cURL (http://curl.haxx.se/) per sottomettere richieste REST ad Autonomous Database. Tuttavia, dovrebbero funzionare anche altri client REST e librerie 3rd party.

   È possibile utilizzare lo strumento della riga di comando cURL per inviare la richiesta REST GET. Ad esempio:

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

   Per specificare sia client_id che client_secret con l'argomento curl --user, immettere i due punti per separare client_id e client_secret. Se si specifica solo il nome utente client_id, curl richiede una password ed è possibile immettere client_secret al prompt.

8. Utilizzare il token di accesso per accedere alla risorsa protetta.

   Il token ottenuto nel passo precedente viene passato nell'intestazione di autorizzazione. Ad esempio:

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