Oracle proporciona un juego sustancial de documentos de orden de compra JSON, en el archivo de texto libre POList.json, como una matriz de objetos JSON, donde cada objeto representa 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;

Puede acceder a SODA para REST en Autonomous Database mediante la autenticación OAuth. Según la aplicación, el acceso a SODA para REST con autenticación OAuth puede mejorar el rendimiento y la seguridad.

1. Como usuario ADMIN, acceda a Database Actions y cree un usuario con los privilegios necesarios.
   1. Acceda a Database Actions como ADMIN.
      Consulte Acceso a Database Actions como ADMIN para obtener más información.
   2. En Database Actions, haga clic en para ver las acciones disponibles.
   3. En Database Actions, en Administración, seleccione Usuarios de la base de datos.
   4. Haga clic en Crear usuario.
   5. En el área Crear usuario, en el separador Usuario, introduzca Usuario y una contraseña y confirme la contraseña.
   6. Seleccione Acceso web.
   7. En el área Crear usuario, seleccione el separador roles otorgados y otorgue DWROLE al usuario.
   8. Haga clic en Crear usuario.

   Consulte Gestión de usuarios y roles de usuario en Autonomous Database: Conexión con Database Actions para obtener más información.

2. Utilice una hoja de trabajo de SQL en Database Actions para otorgar los privilegios de usuario necesarios para cargar datos.
   1. Acceda a Database Actions como ADMIN.
      Consulte Acceso a Database Actions como ADMIN para obtener más información.
   2. En Database Actions, haga clic en para ver las acciones disponibles.
   3. En Database Actions, en Desarrollo, haga clic en SQL para abrir una hoja de trabajo de SQL.
   4. Otorgue los privilegios de usuario necesarios para cargar datos al usuario del paso 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Consulte Gestión de privilegios de usuario en Autonomous Database: Conexión con una herramienta de cliente para obtener más información.

3. Cierre la sesión como usuario ADMIN.
4. Inicie sesión en Database Actions como usuario configurado para utilizar la autenticación OAuth.
5. En Database Actions, utilice una hoja de trabajo de SQL para registrar el cliente OAuth.
   1. Registre el cliente OAuth.
      Por ejemplo, introduzca los siguientes comandos en la hoja de trabajo de SQL, donde proporcionará los valores adecuados para el usuario y la aplicación cliente.

      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. En la hoja de trabajo de SQL, haga clic en Ejecutar script para ejecutar el comando.

   Consulte Referencia del paquete OAUTH PL/SQL para obtener más información.

   Esto registra un cliente denominado my_client para acceder al privilegio my_priv mediante las credenciales de cliente OAuth.

6. Obtenga los valores client_id y client_secret necesarios para generar el token de acceso.
   Por ejemplo, en la hoja de trabajo de SQL, ejecute el siguiente comando:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Obtenga el token de acceso. Para obtener un token de acceso, envíe una solicitud REST GET a database_ORDS_urluser_name/oauth/token.

   database_ORDS_url está disponible en Database Actions, en Servicios relacionados, en la tarjeta RESTful Servicios y soda. Para obtener más información, consulte Acceso a servicios RESTful y SODA para REST.

   Utilice client_id y client_secret en el paso 6 con el siguiente comando.

   En el siguiente ejemplo se utiliza la herramienta de línea de comandos cURL (http://curl.haxx.se/) para enviar solicitudes REST a Autonomous Database. Sin embargo, otros clientes y bibliotecas REST de 3a parte también deberían funcionar.

   Puede utilizar la herramienta de línea de comandos cURL para enviar la solicitud REST GET. Por ejemplo:

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

   Para especificar tanto client_id como client_secret con el argumento curl --user, introduzca dos puntos para separar client_id y client_secret. Si sólo especifica el nombre de usuario, client_id, curl solicita una contraseña y puede introducir client_secret en la petición de datos.

8. Utilice el token de acceso para acceder al recurso protegido.

   El token obtenido en el paso anterior se transfiere a la cabecera de autorización. Por ejemplo:

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