9.19. Funções de informação do sistema

A Tabela 9-41 mostra várias funções para extrair informações da sessão e do sistema.

A função session_user normalmente retorna o usuário que iniciou a conexão com o banco de dados corrente; mas os superusuários podem mudar esta definição através de SET SESSION AUTHORIZATION. A função current_user retorna o identificador do usuário utilizado na verificação de permissão. Normalmente é igual ao usuário da sessão, mas muda durante a execução das funções com o atributo SECURITY DEFINER. Na terminologia Unix o usuário da sessão é o "usuário real", enquanto o usuário corrente é o "usuário efetivo".

A função current_schema retorna o nome do esquema que está à frente do caminho de procura (ou o valor nulo, se o caminho de procura estiver vazio). Este é o esquema utilizado na criação de qualquer tabela, ou outro objeto nomeado, sem especificar o esquema a ser utilizado. A função current_schemas(boolean) retorna uma matriz contendo os nomes de todos os esquemas presentes no caminho de procura. A opção booleana determina se os esquemas do sistema incluídos implicitamente, tal como pg_catalog, serão incluídos no caminho de procura retornado.

A função inet_client_addr retorna o endereço de IP do cliente corrente, e a função inet_client_port retorna o número da porta. A função inet_server_addr retorna o endereço de IP do servidor de destino da conexão corrente, e a função inet_server_port retorna o número da porta. Todas estas funções retornam NULL se a conexão corrente for através de um soquete do domínio Unix.

A função version() retorna uma cadeia de caracteres descrevendo a versão do servidor PostgreSQL.

A Tabela 9-42 mostra as funções que permitem o usuário consultar os privilégios de acesso dos objetos através de programa. Consulte a Seção 5.7 para obter informações adicionais sobre privilégios.

A função has_table_privilege verifica se o usuário pode acessar a tabela de uma determinada maneira. O usuário pode ser especificado pelo nome ou pelo ID (pg_user.usesysid) ou, se o argumento for omitido, é assumido current_user. A tabela pode ser especificada pelo nome ou pelo OID. Portanto, na verdade existem seis variações de has_table_privilege, que podem ser distinguidas pelo número e tipo de seus argumentos. Quando se especifica pelo nome, o nome pode ser qualificado pelo esquema se for necessário. O tipo de privilégio de acesso desejado é especificado através de texto em uma cadeia de caracteres, que deve resultar em um dos seguintes valores: SELECT, INSERT, UPDATE, DELETE, RULE, REFERENCES ou TRIGGER (não faz diferença maiúscula ou minúsculas). Exemplo:

SELECT has_table_privilege('meu_esquema.minha_tabela', 'select');

A função has_database_privilege verifica se o usuário pode acessar o banco de dados de uma determinada maneira. As possibilidades para os argumentos são análogas às da função has_table_privilege. O tipo de privilégio de acesso desejado deve resultar em CREATE, TEMPORARY ou TEMP (que equivale a TEMPORARY).

A função has_function_privilege verifica se o usuário pode acessar a função de uma determinada maneira. As possibilidades para os argumentos são análogas às da função has_table_privilege. Ao se especificar a função através de um texto em uma cadeia de caracteres em vez de pelo OID, a entrada permitida é a mesma que para o tipo de dado regprocedure (consulte a Seção 8.12). O tipo de privilégio de acesso desejado deve resultar em EXECUTE. Exemplo:

SELECT has_function_privilege('joel', 'minha_função(int, text)', 'execute');

A função has_language_privilege verifica se o usuário pode acessar a linguagem procedural de uma determinada maneira. As possibilidades para os seus argumentos são análogas às da função has_table_privilege. O tipo de privilégio de acesso desejado deve resultar em USAGE.

A função has_schema_privilege verifica se o usuário pode acessar o esquema de uma determinada maneira. As possibilidades para os seus argumentos são análogas às da função has_table_privilege. O tipo de privilégio de acesso desejado deve resultar em CREATE or USAGE.

A função has_tablespace_privilege verifica se o usuário pode acessar o espaço de tabelas de uma determinada maneira. As possibilidades para os seus argumentos são análogas às da função has_table_privilege. O tipo de privilégio de acesso desejado deve resultar em CREATE.

Para verificar se o usuário possui a opção de concessão para um determinado privilégio, deve ser anexado WITH GRANT OPTION à palavra chave do privilégio; por exemplo 'UPDATE WITH GRANT OPTION'.

A Tabela 9-43 mostra as funções que determinam se um certo objeto é visível através do caminho de procura de esquema corrente. Uma tabela é dita visível se o esquema que a contém está no caminho de procura e nenhuma tabela com o mesmo nome aparece antes no caminho de procura. Equivale a declarar que a tabela pode ser referenciada pelo seu nome sem uma qualificação de esquema explícita. Por exemplo, para listar o nome de todas as tabelas visíveis:

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

A função pg_table_is_visible realiza a verificação para as tabelas (ou visões, ou qualquer outro tipo de entrada em pg_class). As funções pg_type_is_visible, pg_function_is_visible, pg_operator_is_visible, pg_opclass_is_visible e pg_conversion_is_visible realizam o mesmo tipo de verificação de visibilidade para os tipos (e domínios), funções, operadores, classes de operadores e conversões, respectivamente. Para as funções e os operadores, um objeto no caminho de procura é visível se não existir nenhum objeto com o mesmo nome e mesmos tipos de dado dos argumentos aparecendo antes no caminho. Para as classes de operadores, são considerados tanto o nome quanto o método de acesso de índice associado.

Todas estas funções requerem OIDs de objeto para identificar o objeto a ser verificado. Se for desejado verificar um objeto pelo seu nome, é conveniente utilizar os tipos aliás de OID (regclass, regtype, regprocedure ou regoperator). Exemplo:

SELECT pg_type_is_visible('meu_esquema.widget'::regtype);

Deve ser observado que não faz muito sentido testar um nome não qualificado desta maneira — se o nome puder ser reconhecido, então tem que ser visível.

A Tabela 9-44 mostra as funções que extraem informações dos catálogos do sistema.

A função format_type retorna o nome SQL do tipo de dado que é identificado pelo seu OID de tipo e, possivelmente, um modificador de tipo. Deve ser passado NULL para o modificador de tipo se não for conhecido nenhum modificador específico.

As funções pg_get_viewdef, pg_get_ruledef, pg_get_indexdef, pg_get_triggerdef e pg_get_constraintdef reconstroem, respectivamente, o comando de criação da visão, regra, índice, gatilho e restrição; deve ser observado que esta é uma reconstrução por descompilação, e não o texto original do comando. A função pg_get_expr descompila a forma interna de uma expressão individual, tal como o valor padrão para uma coluna. Pode ser útil ao examinar o conteúdo dos catálogos do sistema. A maioria destas funções estão presentes em duas formas, uma das quais pode, opcionalmente, gerar o resultado de forma "alinhada" (pretty-print). O formato alinhado é mais legível, mas o formato padrão tem mais probabilidade de ser interpretado da mesma maneira nas versões futuras do PostgreSQL; deve ser evitada a utilização do formato alinhado com a finalidade de geração de dumps. Passar false para o parâmetro de impressão alinhada produz o mesmo resultado da variante que não possui o parâmetro.

A função pg_get_userbyid extrai o nome do usuário a partir do número de identificação do usuário. A função pg_get_serial_sequence busca o nome da seqüência associada à coluna serial ou bigserial. O nome está adequadamente formatado para ser passado para as funções de seqüência (consulte a Seção 9.12). Retorna NULL se a coluna são possuir uma seqüência associada.

A função pg_tablespace_databases permite examinar a utilização de um espaço de tabelas. Retorna um conjunto de OIDs de bancos de dados que possuem objetos armazenados no espaço de tabelas. Se esta função retornar alguma linha, então o espaço de tabelas não está vazio e, portanto, não pode ser removido. Para mostrar os objetos presentes no espaço de tabelas, é necessário se conectar ao banco de dados identificado por pg_tablespace_databases e consultar seus catálogos pg_class.

As funções mostradas na Tabela 9-45 extraem os comentários previamente armazenados pelo comando COMMENT. Retorna o valor nulo se não puder ser encontrado um comentário corespondendo aos parâmetros especificados.

A forma da função obj_description() com dois parâmetros retorna o comentário para o objeto do banco de dados especificado pelo seu OID e pelo nome do catálogo do sistema que o contém. Por exemplo, obj_description(123456,'pg_class') retorna o comentário para a tabela com OID 123456. A forma de obj_description() com um parâmetro requer apenas o OID do objeto. Está obsoleta, porque não existe garantia dos OIDs serem únicos entre diferentes catálogos do sistema; portanto, pode ser retornado um comentário errado.

A função col_description() retorna o comentário para a coluna da tabela especificada pelo OID da tabela, e pelo número da coluna. A função obj_description() não pode ser utilizada para colunas de tabela, porque as colunas não possuem OIDs próprios.

=> SELECT current_database();

 current_database
------------------
 template1

=> SELECT current_schema();

 current_schema
----------------
 public

=> SELECT current_schemas(TRUE);

   current_schemas
---------------------
 {pg_catalog,public}

=> SELECT CURRENT_USER AS usuario;

 usuario
----------
 postgres

=> SELECT inet_client_addr();

 inet_client_addr
------------------
 192.168.75.1

=> template1=# SELECT inet_client_port();

 inet_client_port
------------------
            16522

=> SELECT inet_server_addr();

 inet_server_addr
------------------
 192.168.75.128

=> SELECT inet_server_port();

 inet_server_port
------------------
             5432

=> SELECT SESSION_USER as usuario;

 usuario
----------
 postgres

=> SELECT USER as usuario;

 usuario
----------
 postgres

=> SELECT version() AS versao;

                                         versao
-----------------------------------------------------------------------------------------
 PostgreSQL 8.0.0 on i686-pc-mingw32, compiled by GCC gcc.exe (GCC) 3.4.2 (mingw-special)

SELECT db_name() AS current_database

current_database
----------------
pubs

SELECT CURRENT_USER AS usuario;

usuario
-------
dbo

SELECT SESSION_USER as usuario

usuario
-------
dbo

SELECT SYSTEM_USER as usuario

usuario
---------------------
CMRJ_BD\Administrator

SELECT host_name() AS maquina_cliente

maquina_cliente
---------------
CMRJ_BD


SELECT @@SERVERNAME AS maquina_servidora

maquina_servidora
-----------------
CMRJ_BD

SELECT @@SERVICENAME AS nome_servico

nome_servico
--------------------------------------------------------------------------------------------------------------------------------
MSSQLSERVER

SELECT @@LANGUAGE AS idioma

idioma
------------------
Português (Brasil)

SELECT @@VERSION AS versao

versao
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Microsoft SQL Server  2000 - 8.00.2039 (Intel X86)
    May  3 2005 23:18:38
    Copyright (c) 1988-2003 Microsoft Corporation
    Personal Edition on Windows NT 5.0 (Build 2195: Service Pack 4)

SQL> SELECT sys_context ('USERENV', 'DB_NAME') FROM sys.dual;

SYS_CONTEXT('USERENV','DB_NAME')
--------------------------------
XE

SQL> SELECT sys_context ('USERENV', 'CURRENT_SCHEMA') FROM sys.dual;

SYS_CONTEXT('USERENV','CURRENT_SCHEMA')
---------------------------------------
SCOTT

SQL> SELECT sys_context ('USERENV', 'CURRENT_USER') FROM sys.dual;

SYS_CONTEXT('USERENV','CURRENT_USER')
-------------------------------------
SCOTT

SQL> SELECT sys_context ('USERENV', 'HOST') FROM sys.dual;

SYS_CONTEXT('USERENV','HOST')
-----------------------------
halleypo

SQL> SELECT sys_context ('USERENV', 'IP_ADDRESS') FROM sys.dual;

SYS_CONTEXT('USERENV','IP_ADDRESS')
-----------------------------------
200.165.203.130

SQL> SELECT sys_context ('USERENV', 'LANGUAGE') FROM sys.dual;

SYS_CONTEXT('USERENV','LANGUAGE')
------------------------------------
BRAZILIAN PORTUGUESE_BRAZIL.AL32UTF8

SQL> SELECT sys_context ('USERENV', 'NETWORK_PROTOCOL') FROM sys.dual;

SYS_CONTEXT('USERENV','NETWORK_PROTOCOL')
-----------------------------------------
tcp

SQL> SELECT sys_context ('USERENV', 'NLS_DATE_FORMAT') FROM sys.dual;

SYS_CONTEXT('USERENV','NLS_DATE_FORMAT')
----------------------------------------
DD/MM/RR

SQL> SELECT sys_context ('USERENV', 'OS_USER') FROM sys.dual;

SYS_CONTEXT('USERENV','OS_USER')
--------------------------------
oracle

SQL> SELECT sys_context ('USERENV', 'SESSION_USER') FROM sys.dual;

SYS_CONTEXT('USERENV','SESSION_USER')
-------------------------------------
SCOTT

SQL> SELECT banner FROM v$version;

BANNER
-------------------------------------------------------------------
Oracle Database 10g Express Edition Release 10.2.0.1.0 - Production
PL/SQL Release 10.2.0.1.0 - Production
CORE    10.2.0.1.0      Production
TNS for Linux: Version 10.2.0.1.0 - Production
NLSRTL Version 10.2.0.1.0 - Production

db2 => VALUES(CURRENT_SERVER);

1
------
SAMPLE

db2 => VALUES(CURRENT_SCHEMA);

1
--------
DB2INST1

db2 => VALUES(CURRENT_PATH);

1
--------------------------------------------------
"SYSIBM","SYSFUN","SYSPROC","SYSIBMADM","DB2INST1"

db2 => VALUES(SYSTEM_USER);

1
--------
DB2INST1

db2 => VALUES(SESSION_USER);

1
--------
DB2INST1

db2 => VALUES(CURRENT_USER);

1
--------
DB2INST1

db2 => VALUES(USER);

1
--------
DB2INST1

-- Linha de comando

$ db2level

DB21085I  Instance "db2inst1" uses "64" bits and DB2 code release "SQL09010"
with level identifier "02010107".
Informational tokens are "DB2 v9.1.0.0", "s060629", "LINUXAMD64", and Fix Pack "0".
Product is installed at "/opt/ibm/db2/V9.1".