Como usar referências para autorizar acesso a objetos¶

Objetos identificados pelo nome¶

Uma referência identifica um objeto pelo nome. Isso significa que se um objeto for renomeado após a criação de uma referência, a referência será inválida. Porém, se um novo objeto com o mesmo nome for criado, a referência pode ser válida. Por exemplo, uma função my_role cria uma referência my_ref1 para a tabela my_table1 com o privilégio SELECT. Após a criação da referência, a tabela my_table1 é descartada e uma nova tabela chamada my_table1 é criada. A referência my_ref1 identifica uma tabela com o nome my_table1. Neste caso, identifica a nova tabela my_table1.

Se a função usada para criar a referência e os privilégios concedidos em my_table1 ainda forem válidos, o acesso à my_table1 nova será autorizado ao usar a referência.

Se a função e o(s) privilégio(s) encapsulado(s) na referência não forem mais válidos, o acesso à tabela my_table1 não poderá ser autorizado e uma nova referência deverá ser criada para a nova tabela.

Privilégios verificados em tempo de execução¶

Os privilégios concedidos à função que criou a referência são verificados no momento em que a referência é utilizada. Por exemplo, uma função my_role cria uma referência a uma tabela t1 com o privilégio SELECT. Se my_role for descartado ou o privilégio SELECT na tabela t1 for revogado de my_role, os privilégios encapsulados na referência não serão mais válidos. Quando a referência é passada para um procedimento armazenado que exige o privilégio SELECT na tabela, o procedimento armazenado falha com um erro de permissão.

Tipos de referências e vida útil da referência¶

A vida útil de uma referência pode ser especificada no momento da criação.

• Uma referência transitória tem uma vida útil limitada, seja pela duração da chamada na qual a referência é passada ou pela duração da sessão.

• Uma referência persistente tem vida útil ilimitada. A referência permanece válida até que o objeto ao qual ela faz referência seja descartado, a referência seja desativada ou a referência se torne inválida.

  Para obter exemplos de cancelamento de referências, consulte Desativação de uma referência persistente para um aplicativo.

  Uma referência pode tornar-se inválida por qualquer um dos seguintes motivos:

  • O objeto ao qual ele faz referência é renomeado.

  • A função que criou a referência é descartada.

  • A função que criou a referência não possui mais privilégios no objeto.

  Para obter mais informações, consulte Objetos identificados pelo nome e Privilégios verificados em tempo de execução.

Referências para procedimentos armazenados de direitos do proprietário¶

Um procedimento armazenado com direitos do proprietário é executado com os privilégios do proprietário em vez dos privilégios do chamador que executa o procedimento armazenado. Para executar ações em uma tabela, exibição ou função que o chamador tenha privilégios de acesso, o chamador deve passar uma referência à tabela, exibição ou função. A referência permite que o procedimento armazenado execute ações no objeto que a referência identifica com os privilégios do criador da referência (nesse caso, o chamador).

Referências para aplicativos e classes¶

Por projeto, aplicativos e classes não têm acesso a objetos na conta onde o aplicativo está instalado ou onde uma instância de uma classe é criada. Os usuários podem autorizar o acesso a objetos para um aplicativo ou instância de classe criando uma referência.

Tipos de objetos e privilégios suportados para referências¶

A tabela a seguir lista os tipos de objeto que uma referência pode incluir, o tipo de referência que pode ser criado e os privilégios permitidos para cada objeto:

Referências de consulta¶

Uma referência de consulta é um tipo de referência transitória. Ela faz referência a uma instrução SELECT que pode ser usada na cláusula FROM de outra instrução SQL em um procedimento armazenado. Você pode criar uma referência de consulta usando a função SYSTEM$QUERY_REFERENCE.

Para obter mais informações, consulte Uso de referências de consulta.

Exemplos¶

Crie uma referência transitória com escopo de sessão para a tabela t1 com o privilégio SELECT:

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'SELECT');

Para criar uma referência à mesma tabela durante a existência do escopo no qual ela é referenciada (por exemplo, se você passá-la para um procedimento armazenado, seu tempo de vida seria o do bloco mais externo do procedimento armazenado), execute o seguinte instrução:

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'CALL', 'SELECT');

Crie uma referência persistente para uma tabela t1 com o privilégio INSERT para passar para um aplicativo:

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'PERSISTENT', 'INSERT');

Crie uma referência de consulta para passar para um procedimento armazenado. O tempo de vida dessa referência transitória é para o bloco mais externo do procedimento armazenado para o qual você passa a referência:

SELECT SYSTEM$QUERY_REFERENCE('SELECT id FROM my_table', FALSE);

Para mais exemplos:

• Exemplo de procedimento armazenado, consulte Um exemplo simples.

• Exemplo de aplicativo Native App Framework, consulte Associação da referência ao aplicativo.

• Exemplo de instância de classe, consulte Treinamento de um modelo de detecção de anomalias com dados rotulados.