OBIEE - Variáveis
No OBIEE, existem dois tipos de variáveis que são comumente usadas -
- Variáveis de repositório
- Variáveis de sessão
Além disso, você também pode definir variáveis de apresentação e solicitação.
Variáveis de Repositório
Uma variável de repositório tem um único valor em qualquer ponto do tempo. As variáveis do repositório são definidas usando a ferramenta Oracle BI Administration. As variáveis do repositório podem ser usadas no lugar das constantes no Assistente do Expression Builder.
Existem dois tipos de variáveis de repositório -
- Variáveis de repositório estáticas
- Variáveis de repositório dinâmico
As variáveis de repositório estáticas são definidas na caixa de diálogo de variáveis e seu valor existe até que sejam alteradas pelo administrador.
Variáveis de repositório estáticas contêm inicializadores padrão que são valores numéricos ou de caracteres. Além disso, você pode usar o Expression Builder para inserir uma constante como o inicializador padrão, como data, hora, etc. Você não pode usar qualquer outro valor ou expressão como o inicializador padrão para uma variável de repositório estática.
Em versões anteriores de BI, a ferramenta Administrator não limitava o valor das variáveis estáticas do repositório. Você pode receber um aviso na verificação de consistência se seu repositório foi atualizado de versões anteriores. Nesse caso, atualize as variáveis do repositório estático para que os inicializadores padrão tenham um valor constante.
As variáveis de repositório dinâmicas são iguais às variáveis estáticas, mas os valores são atualizados por dados retornados de consultas. Ao definir uma variável de repositório dinâmica, você cria um bloco de inicialização ou usa um preexistente que contém uma consulta SQL. Você também pode configurar uma programação que o Oracle BI Server seguirá para executar a consulta e atualizar o valor da variável periodicamente.
Quando o valor de uma variável de repositório dinâmico muda, todas as entradas de cache associadas a um modelo de negócios são excluídas automaticamente.
Cada consulta pode atualizar várias variáveis: uma variável para cada coluna da consulta. Você agenda essas consultas para serem executadas pelo servidor Oracle BI.
Variáveis de repositório dinâmico são úteis para definir o conteúdo de fontes de tabelas lógicas. Por exemplo, suponha que você tenha duas fontes de informações sobre pedidos. Uma fonte contém pedidos atuais e a outra contém dados históricos.
Criar Variáveis de Repositório
Na Ferramenta de Administração → Vá para Gerenciar → Selecionar Variáveis → Gerenciador de Variáveis → Vá para Ação → Novo → Repositório> Variável.
Na caixa de diálogo Variável, digite um nome para a variável (os nomes de todas as variáveis devem ser únicos) → Selecione o tipo de variável - Estática ou Dinâmica.
Se você selecionar uma variável dinâmica, use a lista de blocos de inicialização para selecionar um bloco de inicialização existente que será usado para atualizar o valor continuamente.
Para criar um novo bloco de inicialização → Clique em Novo. Para adicionar um valor de inicializador padrão, digite o valor na caixa do inicializador padrão ou clique no botão Expression Builder para usar o Expression Builder.
Para variáveis de repositório estático, o valor que você especifica na janela do inicializador padrão persiste. Não vai mudar a menos que você mude. Se você inicializar uma variável usando uma string de caracteres, coloque a string entre aspas simples. As variáveis de repositório estáticas devem ter inicializadores padrão que são valores constantes → Clique em OK para fechar a caixa de diálogo.
Variáveis de Sessão
As variáveis de sessão são semelhantes às variáveis de repositório dinâmico e obtêm seus valores de blocos de inicialização. Quando um usuário inicia uma sessão, o servidor Oracle BI cria novas instâncias de variáveis de sessão e as inicializa.
Existem tantas instâncias de uma variável de sessão quanto sessões ativas no servidor Oracle BI. Cada instância de uma variável de sessão pode ser inicializada com um valor diferente.
Existem dois tipos de variáveis de sessão -
- Variáveis de sessão do sistema
- Variáveis de sessão fora do sistema
As variáveis de sessão do sistema são usadas pelo Oracle BI e pelo servidor de apresentação para fins específicos. Eles têm nomes reservados predefinidos que não podem ser usados por outras variáveis.
USER |
Esta variável contém o valor que o usuário insere com o nome de login. Essa variável é normalmente preenchida a partir do perfil LDAP do usuário. |
USERGUID |
Esta variável contém o Global Unique Identifier (GUID) do usuário e é preenchida a partir do perfil LDAP do usuário. |
GROUP |
Ele contém os grupos aos quais o usuário pertence. Quando um usuário pertencer a vários grupos, inclua os nomes dos grupos na mesma coluna, separados por ponto e vírgula (Exemplo - GrupoA; GrupoB; GrupoC). Se um ponto-e-vírgula tiver que ser incluído como parte de um nome de grupo, preceda o ponto-e-vírgula com um caractere de barra invertida (\). |
ROLES |
Esta variável contém as funções do aplicativo às quais o usuário pertence. Quando um usuário pertence a várias funções, inclua os nomes das funções na mesma coluna, separados por ponto e vírgula (Exemplo - FunçãoA; FunçãoB; FunçãoC). Se um ponto-e-vírgula tiver que ser incluído como parte de um nome de função, preceda o ponto-e-vírgula com um caractere de barra invertida (\). |
ROLEGUIDS |
Ele contém os GUIDs para as funções do aplicativo às quais o usuário pertence. GUIDs para funções de aplicativo são iguais aos nomes de função de aplicativo. |
PERMISSIONS |
Ele contém as permissões do usuário. Exemplo - oracle.bi.server.manageRepositories. |
Variáveis de sessão fora do sistema são usadas para definir os filtros do usuário. Por exemplo, você poderia definir uma variável não pertencente ao sistema chamada Sale_Region que seria inicializada com o nome da sale_region do usuário.
Criar Variáveis de Sessão
Na Ferramenta de Administração → Vá para Gerenciar → Selecionar Variáveis.
Na caixa de diálogo Gerenciador de variáveis, clique em Ação → Novo → Sessão → Variável.
Na caixa de diálogo Variável de sessão, insira o nome da variável (os nomes de todas as variáveis devem ser exclusivos e os nomes das variáveis de sessão do sistema são reservados e não podem ser usados para outros tipos de variáveis).
Para variáveis de sessão, você pode selecionar as seguintes opções -
Enable any user to set the value- Esta opção é usada para definir variáveis de sessão após o bloco de inicialização preencher o valor. Exemplo - esta opção permite que os não administradores definam esta variável para amostragem.
Security sensitive - Isso é usado para identificar a variável como sensível à segurança ao usar uma estratégia de segurança de banco de dados em nível de linha, como um Virtual Private Database (VPD).
Você pode usar a opção de lista de bloqueio de inicialização para escolher um bloco de inicialização que será usado para atualizar o valor regularmente. Você também pode criar um novo bloco de inicialização.
Para adicionar um valor de inicializador padrão, insira o valor na caixa do inicializador padrão ou clique no botão Expression Builder para usar o Expression Builder. Clique em OK para fechar a caixa de diálogo.
O administrador pode criar variáveis de sessão fora do sistema usando a ferramenta Oracle BI Administration.
Variáveis de Apresentação
As variáveis de apresentação são criadas com a criação de prompts do painel. Existem dois tipos de prompts de painel que podem ser usados -
Prompt de coluna
A variável de apresentação criada com o prompt da coluna está associada a uma coluna e os valores que ela pode obter vêm dos valores da coluna.
Para criar uma variável de apresentação, vá para a caixa de diálogo Novo prompt ou caixa de diálogo Editar prompt → Selecione Variável de apresentação no campo Conjunto de uma variável → Insira o nome da variável.
Solicitação de Variável
A variável de apresentação criada como prompt de variável não está associada a nenhuma coluna e você precisa definir seus valores.
Para criar uma variável de apresentação como parte de um prompt de variável, na caixa de diálogo Novo prompt ou caixa de diálogo Editar prompt → Selecione Variável de apresentação no campo Solicitar para → Insira o nome da variável.
O valor de uma variável de apresentação é preenchido pela coluna ou prompt de variável com o qual foi criado. Cada vez que um usuário seleciona um valor na coluna ou prompt de variável, o valor da variável de apresentação é definido como o valor que o usuário selecionar.
Blocos de inicialização
Os blocos de inicialização são usados para inicializar variáveis OBIEE: variáveis do Repositório Dinâmico, variáveis de sessão do sistema e variáveis de sessão não pertencentes ao sistema.
Ele contém instruções SQL que são executadas para inicializar ou atualizar as variáveis associadas a esse bloco. A instrução SQL que é executada aponta para tabelas físicas que podem ser acessadas usando o pool de conexão. O pool de conexão é definido na caixa de diálogo do bloco de inicialização.
Se quiser que a consulta de um bloco de inicialização tenha SQL específico do banco de dados, você pode selecionar um tipo de banco de dados para essa consulta.
Inicializar Variáveis de Repositório Dinâmico usando Bloco de Inicialização
O campo de sequência de inicialização padrão do bloco de inicialização é usado para definir o valor das variáveis de repositório dinâmico. Você também define uma programação que é seguida pelo servidor Oracle BI para executar a consulta e atualizar o valor da variável. Se você definir o nível de registro como 2 ou superior, as informações de registro de todas as consultas SQL executadas para recuperar o valor da variável serão salvas no arquivo nqquery.log.
Localização deste arquivo no BI Server -
ORACLE_INSTANCE \ diagnostics \ logs \ OracleBIServerComponent \ coreapplication_obisn
Inicializar variáveis de sessão usando bloco de inicialização
As variáveis de sessão também obtêm seus valores do bloco de inicialização, mas seu valor nunca muda com os intervalos de tempo. Quando um usuário inicia uma nova sessão, o servidor Oracle BI cria uma nova instância de variáveis de sessão.
Todas as consultas SQL executadas para recuperar informações de variáveis de sessão pelo servidor BI se o nível de registro for definido como 2 ou superior no objeto Usuário do Identity Manager ou se a variável de sessão do sistema LOGLEVEL for definida como 2 ou superior no Gerenciador de variáveis for salva em nqquery.log Arquivo.
Localização deste arquivo no BI Server -
ORACLE_INSTANCE \ diagnostics \ logs \ OracleBIServerComponent \ coreapplication_obisn
Criar blocos de inicialização na ferramenta do administrador
Vá para Gerenciador → Variáveis → caixa de diálogo Gerenciador de variáveis é exibida. Vá para o menu Ação → Clique em Novo → Repositório → Bloco de inicialização → Insira o nome do bloco de inicialização.
Vá para a guia Programação → Selecione a data e hora de início e o intervalo de atualização.
Você pode escolher as seguintes opções para blocos de inicialização -
Disable- Se você selecionar esta opção, o bloco de inicialização será desabilitado. Para habilitar um bloco de inicialização, clique com o botão direito em um bloco de inicialização existente no Gerenciador de variáveis e escolha Habilitar. Esta opção permite que você altere esta propriedade sem abrir a caixa de diálogo do bloco de inicialização.
Allow deferred execution - Isso permite adiar a execução do bloco de inicialização até que uma variável de sessão associada seja acessada pela primeira vez durante a sessão.
Required for authentication - Se você selecionar isto, o bloco de inicialização deve ser executado para que os usuários façam login. Os usuários terão o acesso ao Oracle BI negado se o bloco de inicialização não for executado.