Uso del SODA para REST con Autonomous AI Database

Oracle proporciona un conjunto sustancial de documentos de pedido de compra JSON, en el archivo de texto sin formato 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 la base de datos de IA autónoma 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 mostrar las acciones disponibles.
   3. En Database Actions, en Administración, seleccione Usuarios de base de datos.
   4. Haga clic en Crear usuario.
   5. En el área Crear usuario, en el separador Usuario, introduzca Nombre de 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 AI Database - Conexión con Database Actions para obtener más información.

2. Utilice una hoja de trabajo 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 mostrar las acciones disponibles.
   3. En Database Actions, en Desarrollo, haga clic en SQL para abrir una hoja de trabajo SQL.
   4. Otorgue los privilegios de usuario necesarios para cargar datos al usuario desde el paso 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

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

3. Desconéctese como usuario ADMIN.
4. Conéctese a Database Actions como usuario que está configurando para utilizar la autenticación OAuth.
5. En Database Actions, utilice una hoja de trabajo 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 debe 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 PL/SQL de OAUTH 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 SQL ejecute el siguiente comando:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Obtenga el símbolo 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 refrescos. Consulte Acceso a servicios RESTful y SODA para REST para obtener más información.

   En el siguiente comando, utilice client_id y client_secret que obtuvo en el paso 6.

   En el siguiente ejemplo se utiliza la herramienta de línea de comandos cURL (http://curl.haxx.se/) para enviar solicitudes REST a la base de datos de IA autónoma. Sin embargo, otros clientes y bibliotecas REST de 3ª 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 client_id y 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 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}