Desenvolvendo Serviços RESTful no Autonomous Database

Você pode desenvolver e implantar Serviços RESTful com suporte nativo do Oracle REST Data Services (ORDS) em um Autonomous Database.

Sobre o Oracle REST Data Services no Autonomous Database

O Oracle REST Data Services (ORDS) facilita o desenvolvimento de interfaces REST para dados relacionais em um Autonomous Database. O ORDS é um aplicativo Java de camada intermediária que mapeia verbos HTTP(S), como GET, POST, PUT, DELETE e assim por diante, para transações do banco de dados e retorna quaisquer resultados como dados JSON.

Observação:

O aplicativo Oracle REST Data Services (ORDS) no Autonomous Database é pré-configurado e totalmente gerenciado. O ORDS conecta-se ao banco de dados usando o serviço de banco de dados predefinido low com um número máximo fixo de conexões (o número de conexões do ORDS não é alterado com base no número de CPUs). Não é possível alterar a configuração padrão do ORDS.

Consulte Oracle REST Data Services para obter informações sobre o uso do Oracle REST Data Services.

Consulte Nomes de Serviço de Banco de Dados Predefinidos para Autonomous Databases para obter informações sobre o serviço de banco de dados low.

Desenvolver com o Oracle REST Data Services no Autonomous Database

O Autonomous Database oferece suporte ao Oracle REST Data Services (ORDS).

O desenvolvimento de serviços RESTful é fácil com uma das seguintes interfaces de desenvolvimento:

  • SQL Developer (desktop): Com o SQL Developer em seu desktop, você pode conectar-se ao seu Autonomous Database e ativar o acesso dos serviços REST a tabelas e views ou desenvolver Serviços RESTful personalizados com base em seu código SQL e PL/SQL. Consulte Estabelecer Conexão com o Oracle SQL Developer Versão 18.2 ou Mais Recente para obter mais informações.

  • Oracle Application Express (APEX): Com o APEX, você pode usar as páginas de desenvolvimento dos Serviços RESTful para criar e manter seus serviços e objetos ativados para REST. Você pode usar o APEX SQL Workshop para acessar seus Oracle RESTful Services e objetos ativados para REST. Consulte Como Acessar os Serviços RESTful para obter mais informações.

A conta ADMIN do Autonomous Database é Ativada para REST. Isso permite que os Serviços REST sejam publicados nos esquemas ADMIN e permite que você acesse o Database Actions usando a conta de usuário do banco de dados ADMIN. A Oracle recomenda que você crie uma conta de esquema de aplicativo para seus Serviços RESTful e objetos ativados para REST. Os serviços são protegidos usando a Autenticação do Banco de Dados e seu esquema ativado para REST.

O usuário do banco de dados autenticado só terá acesso permitido se o esquema estiver ativado para REST e o mapeamento de URL da solicitação apontar para seu próprio esquema. Um usuário não é autenticado quando uma solicitação aponta para outro esquema de banco de dados. Por exemplo, a seguinte solicitação autenticada como o esquema HR ativado para REST está acessível: 

GET /ords/hr/module/service/

No entanto, quando autenticado como o esquema SCOTT ativado para REST, a mesma solicitação é: 

GET /ords/hr/module/service/

resulta em um erro:

401 HTTP Unauthorized response/error

Qualquer usuário do banco de dados cujas credenciais estão corretas e atendam a essas regras é autenticado e recebeu a atribuição ORDS, camada intermediária: SQL Developer. A atribuição SQL Developer permite que o usuário acesse qualquer ponto final que exija a atribuição SQL Developer.

Consulte Ativar uma Tabela de Banco de Dados para acesso REST no Guia de Início Rápido para obter informações sobre como ativar uma tabela para acesso REST.