Usar SODA para REST com Autonomous Database

A Oracle fornece um conjunto substancial de documentos de ordem de compra JSON, no arquivo de texto sem formatação POList.json, como um array JSON de objetos, em que cada objeto representa um 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;

Você pode acessar o SODA para REST no Autonomous Database usando a autenticação OAuth. Dependendo do seu aplicativo, o acesso ao SODA para REST com autenticação OAuth pode melhorar o desempenho e a segurança.

1. Como usuário ADMIN, acesse o Database Actions e crie um usuário com os privilégios necessários.
   1. Acesse o Database Actions como ADMIN.
      Consulte Acessar o Database Actions como ADMIN para obter mais informações.
   2. No Database Actions, clique em para mostrar as ações disponíveis.
   3. No Database Actions, em Administration, selecione Database Users.
   4. Clique em Criar Usuário.
   5. Na área Criar Usuário, na guia Usuário, digite Nome do Usuário e uma Senha e confirme a senha.
   6. Selecione Acesso à Web.
   7. Na área Criar Usuário, selecione a guia Atribuições Concedidas e conceda DWROLE ao usuário.
   8. Clique em Criar Usuário.

   Consulte Gerenciar Usuários e Atribuições de Usuário no Autonomous Database - Estabelecendo Conexão com o Database Actions para obter mais informações.

2. Use uma planilha SQL no Database Actions para conceder privilégios de usuário necessários para carregar dados.
   1. Acesse o Database Actions como ADMIN.
      Consulte Acessar o Database Actions como ADMIN para obter mais informações.
   2. No Database Actions, clique em para mostrar as ações disponíveis.
   3. No Database Actions, em Development, clique em SQL para abrir uma planilha SQL.
   4. Conceda privilégios de usuário necessários para carregar dados para o usuário na Etapa 1.

      GRANT UNLIMITED TABLESPACE TO user_name;

   Consulte Gerenciar Privilégios do Usuário no Autonomous Database - Estabelecendo Conexão com uma Ferramenta Cliente para obter mais informações.

3. Saia como usuário ADMIN.
4. Acesse o Database Actions como o usuário que está configurando para usar a autenticação OAuth.
5. No Database Actions, use uma planilha SQL para registrar o cliente OAuth.
   1. Registre o cliente OAuth.
      Por exemplo, informe os comandos a seguir na planilha SQL, na qual você fornece os valores apropriados para seu usuário e seu aplicativo 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. Na planilha SQL, clique em Executar Script para executar o comando.

   Consulte Referência do Pacote PL/SQL OAUTH para obter mais informações.

   Isso registra um cliente chamado my_client para acessar o privilégio my_priv usando credenciais do cliente OAuth.

6. Obtenha os valores client_id e client_secret necessários para gerar o token de acesso.
   Por exemplo, na planilha SQL, execute o seguinte comando:

   SELECT id, name, client_id, client_secret FROM user_ords_clients;

7. Obtenha o token do acesso. Para obter um token de acesso, envie uma solicitação REST GET para database_ORDS_urluser_name/oauth/token.

   O database_ORDS_url está disponível no Database Actions, em Related Services, no cartão RESTful Services and Soda. Consulte Acessar Serviços RESTful e SODA para REST para obter mais informações.

   No comando a seguir, use o client_id e o client_secret obtido na Etapa 6.

   O exemplo a seguir usa a ferramenta de linha de comando cURL (http://curl.haxx.se/) para submeter solicitações REST ao Autonomous Database. No entanto, outros clientes REST e bibliotecas 3rd party também devem funcionar.

   Você pode usar a ferramenta de linha de comando cURL para submeter a solicitação REST GET. Por exemplo:

   > 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 e client_secret com o argumento --user curl, digite dois-pontos para separar client_id e client_secret. Se você especificar apenas o nome de usuário client_id, o curl solicitará uma senha e poderá informar o client_secret no prompt.

8. Use o token de acesso para acessar o recurso protegido.

   O token obtido na etapa anterior é passado no cabeçalho Autorização. Por exemplo:

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