Implementar Parâmetros para Origens de Dados

Para tornar as Origens de Dados mais flexíveis, você pode implementar parâmetros de tempo de execução, permitindo que o Essbase use variáveis na consulta. O uso de variáveis nas Origens de Dados ajuda a simplificar as operações, exigindo menos Origens de Dados para manutenção.

Podem ser variáveis de substituição definidas no Essbase, parâmetros de runtime definidos pelo contexto de grade quando os usuários do Smart View fazem drill through de dados externos ou funções definidas pelo usuário gravadas em um sistema de origem externo.

Sempre que você planejar usar variáveis nas Origens de Dados do Essbase, precisará primeiramente

1. Incluir a sintaxe de variável na consulta da Origem de Dados. Por exemplo, a consulta Origem de dados deve incluir ? em sua sintaxe, em que ? é um placeholder para alguma variável a ser definida no runtime.

2. Execute uma das seguintes etapas:

   • Defina um valor de parâmetro padrão fixo na Origem de dados para que o Essbase seja usado como fallback caso a variável tenha um contexto inválido no runtime

   • Defina uma variável de substituição a ser usada pela Origem de Dados

   • Especifique uma função externa definida pelo usuário (ou procedimento armazenado) como parâmetro

Para definir Origens de Dados e implementar parâmetros para elas, você deve ser um Gerente de Aplicativos ou superior.

A implementação de variáveis em Origens de Dados permite que você especifique um contexto de consulta de runtime que será aplicado sempre que um usuário acessar a Origem de Dados associada a um cubo do Essbase.

Por exemplo, suponha os seguintes casos de uso.

• Um Gerente de Banco de Dados supervisiona um cargo de carregamento de dados recorrente que carrega dados para o cubo mensalmente. O Database Manager agora pode usar uma variável de substituição para carregar dados do mês atual, em vez de manter uma regra para cada mês.

• Um Gerenciador de Aplicativos mantém o drill through das definições de relatório para diferentes casos de uso de negócios. O Gerenciador de Aplicativos implementa variáveis na Origem de Dados subjacente da qual os usuários doSmart View fazem drill-through em suas operações. Como resultado, o Gerenciador de Aplicativos tem menos definições do relatório de drill through para manter e depurar.

Definir um Parâmetro Padrão em uma Origem de Dados

Defina um parâmetro padrão em uma Origem de Dados se quiser permitir o uso de variáveis nas consultas que o Essbase gera quando ele trabalha com dados armazenados fora do cubo.

Para definir o parâmetro padrão,

1. Obtenha ou crie uma conexão com a origem externa de dados (por exemplo, crie uma conexão com o Oracle Database).

   Você poderá usar uma conexão global, se já existir alguma na página Origens da interface web do Essbase, ou pode criar uma conexão no nível do aplicativo.

2. Crie uma Origem de Dados sobre a conexão que você usará para acessar o Oracle Database.

   Será possível definir uma Origem de Dados globalmente, se for necessário que ela esteja disponível a todos os aplicativos, ou defini-la no nível do aplicativo.

   1. Para criar uma Origem de Dados global, você deve ser um administrador de serviços. Na Home page, clique em Origens, clique na guia Origens de Dados em seu nome de usuário e clique em Criar Origem de Dados.

      Ou, para criar uma Origem de Dados no nível do aplicativo, você deve ser um gerenciador de aplicativos ou um usuário avançado com permissão de gerenciamento de aplicativos para o aplicativo especificado. Na Home page, clique no nome de uma aplicação. Em seguida, clique em Origens, clique na guia Origens de Dados em seu nome de usuário e clique em Criar Origem de Dados.

   2. Na etapa Geral, para Conexão, selecione a conexão do Oracle Database que você criou.

   3. Para Nome, dê um nome à Origem de Dados.

   4. Para a Consulta, forneça uma consulta (esse exemplo usa SQL). Para torná-la uma consulta parametrizada, inclua uma condição de filtro (cláusula WHERE) que mapeie uma coluna relacional em sua origem para um placeholder. Indique a posição da variável usando um placeholder, ?, na sintaxe da consulta. O placeholder destina-se a um parâmetro que você especifica em uma etapa posterior.

      select * from SB_DT where DIMENSION_YEAR=?

      Por exemplo, suponha que o seu banco de dados relacional tenha a tabela a seguir, chamada SB_DT. A tabela tem a coluna DIMENSION_YEAR com os meses sendo os valores:
      
      

      Para usar uma variável para a seleção de valores de mês na coluna DIMENSION_YEAR, aplique a seguinte sintaxe do filtro na consulta: where DIMENSION_YEAR=?
      
      

   5. Clique em Próximo.

   6. Na etapa Colunas, aplique o tipo de dados apropriado que o Essbase deverá associar a cada coluna dos dados relacionais de origem.

      Por exemplo, defina as colunas numéricas como tipo Duplo e deixe as colunas alfanuméricas como tipo String.

      
      
      
      
      

   7. Clique em Próximo.

   8. Na etapa Parâmetros, foi criado Param1 – esse parâmetro existe porque você usou um sinal ? na consulta da etapa Geral.

      Deixe Usar Variáveis desmarcada, clique duas Vezes no campo de texto em Valor e digite um valor padrão para o parâmetro de runtime. A finalidade desse valor padrão é para que o Essbase use como fallback caso o parâmetro tenha um contexto inválido no runtime. Essa etapa será importante se você planejar usar parâmetros de runtime como parte das definições de relatório de drill through.

      Você também pode renomear Param1 para um nome que tenha significado para seu caso de uso. Por exemplo, você pode renomeá-lo para param_G_month para indicar que o parâmetro usa uma variável global para o mês atual ou pode renomeá-lo para param_<appName>_month para indicar que o parâmetro usa uma variável de nível de aplicativo para o mês atual. A personalização dos nomes de parâmetro pode ser útil ao depurar parâmetros usando os arquivos de log do servidor Essbase.

      
      
      
      
      

      Se você quiser personalizar o parâmetro para referenciar uma variável de substituição, não precisará especificar um valor padrão. Consulte Usar Variáveis de Substituição em uma Origem de Dados em vez deste tópico.

   9. Clique em Próximo.

   10. Em Visualizar, observe que o parâmetro padrão foi aplicado à consulta. Como resultado, a visualização só é preenchida com registros externos de origem em que o valor da coluna DIMENSION_YEAR é Jan.

       
       
       
       
       

       Embora a visualização só exiba valores com o parâmetro padrão aplicado, posteriormente, quando você implementar os parâmetros de runtime para definição de relatório de drill through, terá acesso a mais dados externos do que podia ver na visualização.

   11. Clique em Salvar para criar a Origem de Dados com base nesta consulta dos dados da origem externa. A Origem de Dados está ativada para implementação dos parâmetros de runtime.

Usar Variáveis de Substituição em uma Origem de Dados

O workflow a seguir ilustra como criar uma Origem de Dados do Essbase tendo como base uma consulta de dados de origem externos, usando uma variável de substituição definida no Essbase. A variável de substituição adiciona mais flexibilidade ao modo como você projeta uma consulta extraída dos dados de origem.

Neste exemplo, você usará uma variável de substituição no Essbase para declarar o mês atual. Em vez de atualizar as Origens de Dados mensalmente para extrair dados do mês atual, você pode isolar as Origens de Dados e atualizar apenas a variável de substituição que você definiu.

1. Crie uma variável de substituição no nível de aplicativo ou global.

   
   
   
   
   

2. Obtenha ou crie uma conexão com a origem externa de dados (por exemplo, crie uma conexão com o Oracle Database).

   Você poderá usar uma conexão global, se já existir alguma na página Origens da interface web do Essbase, ou pode criar uma conexão no nível do aplicativo.

3. Crie uma Origem de Dados sobre a conexão que você usará para acessar o Oracle Database.

   Será possível definir uma Origem de Dados globalmente, se for necessário que ela esteja disponível a todos os aplicativos, ou defini-la no nível do aplicativo.

   1. Na etapa Geral, para Conexão, selecione a conexão do Oracle Database que você criou.

   2. Para Nome, dê um nome à Origem de Dados.

   3. Para a Consulta, forneça uma consulta (esse exemplo usa SQL). Para torná-la uma consulta parametrizada, inclua uma condição de filtro (cláusula WHERE) que mapeie uma coluna relacional em sua origem para um placeholder. Você indica a posição da variável usando um placeholder, ?, na sintaxe da consulta. O placeholder destina-se a um parâmetro que você especifica em uma etapa posterior.

      select * from SB_DT where DIMENSION_YEAR=?

      Por exemplo, suponha que o seu banco de dados relacional tenha a tabela a seguir, chamada SB_DT. A tabela tem a coluna DIMENSION_YEAR com os meses sendo os valores:
      
      

      Para usar uma variável para a seleção de valores de mês na coluna DIMENSION_YEAR, aplique a seguinte sintaxe do filtro na consulta: where DIMENSION_YEAR=?
      
      

   4. Clique em Próximo.

   5. Na etapa Colunas, aplique o tipo de dados apropriado que o Essbase deverá associar a cada coluna dos dados relacionais de origem.

      Por exemplo, defina as colunas numéricas como tipo Duplo e deixe as colunas alfanuméricas como tipo String.

      
      
      
      
      

   6. Clique em Próximo.

   7. Na etapa Parâmetros, o Parâmetro1 foi criado – este parâmetro existe porque você usou um ? na consulta na etapa Geral. Para personalizar o Parâmetro1 para fazer referência a uma variável de substituição, clique em Usar Variáveis e selecione uma variável de substituição na lista drop-down Valor.

      Se você estiver criando uma Origem de Dados em um aplicativo, variáveis de substituição de nível global e do aplicativo estarão disponíveis para seleção. As variáveis no nível do aplicativo são prefixadas com o nome do aplicativo. Se você estiver criando uma Origem de Dados global, apenas variáveis de substituição globais estarão disponíveis para seleção.

      Você pode renomear Param1 com um nome significativo para seu caso de uso. Por exemplo, você pode renomeá-lo para param_G_month para indicar que o parâmetro usa uma variável global para o mês atual ou pode renomeá-lo para param_<appName>_month para indicar que o parâmetro usa uma variável de nível de aplicativo para o mês atual. A personalização dos nomes de parâmetro pode ser útil ao depurar parâmetros usando os arquivos de log do servidor Essbase.

      
      
      
      
      

   8. Clique em Próximo.

   9. Em Visualizar, observe que a variável de substituição é aplicada à consulta. Como resultado, a visualização só é preenchida com registros externos de origem em que o valor da coluna DIMENSION_YEAR é Aug.

      
      
      
      
      

   10. Clique em Salvar para criar uma Origem de Dados com base nesta consulta dos dados da origem externa.