4 de março de 2010
Sumário 1 Introdução 3 2 Objetivos 3 3 Visão Geral 3 3.1 Instalação............................. 3 3.2 Legenda.............................. 4 3.3 Configuração Inicial........................ 5 3.4 Guia de Navegação Inicial.................... 5 3.5 Dicas................................ 6 4 Utilização 7 4.1 Ativando as conexões do banco de dados............ 7 4.2 Importando Tabelas Físicas e Colunas............. 7 4.3 Criando um modelo de Negócios................. 8 4.4 Criando Tabelas e Colunas de Negócios............. 8 4.5 Removendo Colunas Indesejáveis ao Modelo de Negócios... 8 4.6 Relacionando Tabelas e Colunas................. 9 4.7 Criando uma Visão de Negócios................. 9 4.8 Agrupando Colunas em Categorias............... 9 4.9 Adicionando Segurança aos Objetos do Metadata Business.. 10 4.10 Modificando Segurança de Conteúdos.............. 11 4.11 Configurando o Pentaho BI Server para Segurança....... 12 Laboratório de Software Livre 1
4.12 Exportando Domínios...................... 12 4.13 Importando Domínios....................... 12 4.14 Configurando e Administrando Localidades (Internacionalização) 13 4.15 Testando o Meta-Modelo..................... 13 4.16 Backups e Recuperação de Domínio............... 14 4.17 Publicando um Domínio para o Pentaho BI Server....... 14 5 Créditos 16 Laboratório de Software Livre 2
1 Introdução O Mondrian Metadata Editor é uma interface que permite ao usuário criar e editar uma simulação de esquema para o Mondrian com finalidade de melhor visualização e entendimento da mesma. 2 Objetivos O uso da ferramenta Mondrian Metadata Editor é útil para facilitar a visualização gráfica de esquemas para o Mondrian e criar modelos para o mesmo. Sua interface permite, além de uma disposição dos dados em árvore hierárquica, uma visualização gráfica de relacionamentos entre tabelas ou colunas. É possível ainda a criação de modelo de negócio para melhor compreensão dos dados para o usuário, destacando as relações existentes e suas prioridades. O maior objetivo da ferramenta é disponibilizar o esquema de dados graficamente de forma que o usuário possa visualiza-lo e entendê-lo. 3 Visão Geral 3.1 Instalação Para instalar o Mondrian Metadata Editor faça o download no link http://mondrian.pentaho.org/index.php. Descompacte o arquivo pentahometadata-editor-2.0.0-rc1.tar.gz. 1 # tar xvf pentaho-metadata-editor-2.0.0-rc1.tar.gz 1 O nome do arquivo pode variar de acordo com a versão adotada Laboratório de Software Livre 3
3.2 Legenda 1. Tela de Navegação 2. Menu Principal 3. Abas Principais Laboratório de Software Livre 4
4. Árvore de Navegação 3.3 Configuração Inicial Inicialmente, deve ser criado um domínio para o armazenamento dos modelos a serem criados. Vá em File->New->Domain File... Se o usuário já tive um domínio previamente criado, então pressione as teclas Ctrl+o para abri-lo. 3.4 Guia de Navegação Inicial Todas as utilidades oferecidas pela ferramenta para a criação das relações entre tabelas e do modelo de negócios estão listadas abaixo: 1. Ativando as conexões do banco de dados: importa os dados do banco de dados especificado. 2. Importando tabelas físicas e colunas: importa as tabelas selecionadas pelo usuário que estão contidas na conexão previamente criada. Laboratório de Software Livre 5
3. Criando um modelo de negócios. 4. Criando tabelas e colunas de Negócios: importa as tabelas selecionadas pelo usuário para a complementação do modelo de negócios. 5. Removendo Colunas Indesejáveis ao modelo de negócios. 6. Criando relações entre tabelas e colunas: relaciona, no modelo de negócios, as tabelas e colunas que o usuário desejar. 7. Construindo uma visão de negócios (Business View): facilita a visualização do modelo de negócios, permitindo ao usuário a modelagem da mesma para torná-la o mais intuitivo possível. 8. Criando categorias: faz parte da construção da visão de negócios. É a seleção e agrupamento de tabelas e colunas em categorias, para facilitar o entendimento do esquema de dados. 9. Agrupando colunas em categorias. 10. Adicionando segurança aos objetos do Metadata Business: permite ao administrador selecionar as colunas ou tabelas que os usuários do Pentaho BI Server terão acesso. 11. Modificando segurança de conteúdos. 12. Configurando o Pentaho BI Server para segurança. 13. Exportando domínios. 14. Importando domínios. 15. Configurando e administrando localidades (internacionalização). 16. Backups e recuperação de domínios. 17. Publicando um domínio para o Pentaho BI Server. 3.5 Dicas Como a finalidade do Metadata Editor é a publicação final no Pentaho BI-Server, algumas dicas são de grande valia para facilitar a formulação de futuros relatórios. Laboratório de Software Livre 6
1. Como a estrutura do meta-modelo é a base principal para relatórios no BI-Server, é necessário que ela seja bem feita (ou seja, não economize em criar conexões desejadas ou em importar tabelas). 2. Os nomes de tabelas, linhas e colunas devem ser bem explicativos pois não poderão ser mudados no relatório (o nome que elas levarem no meta-modelo serão os mesmos exibidos em seu relatório). 4 Utilização Abaixo será explicado como utilizar as funções citadas na subseção Guia de Navegaç~ao Inicial. 4.1 Ativando as conexões do banco de dados 1. Clique com o botão direito no link Connections da árvore de navegação no lado esquerdo da tela. 2. Selecione New Connections... no menu a ser aberto. 3. O menu de conexões será aberto. Preencha os campos informando os dados requisitados. 4.2 Importando Tabelas Físicas e Colunas 1. Clique na seta à esquerda do link Connections para expandir a árvore de navegação. 2. Aberto o menu de conexões, clique na conexão criada com o botão direito e selecione Import Tables... do menu a ser aberto. 3. Será aberta outra janela com as opções de tabelas a serem importadas. Selecione as de seu interesse para que elas sejam importadas. Laboratório de Software Livre 7
4.3 Criando um modelo de Negócios 1. Clique com o botão direito no link Business Models da árvore de navegação a esquerda da tela de navegação. Selecione a opção New Business Model... no menu a ser aberto. 2. Será aberta uma janela de propriedades do novo Modelo de Negócios. 3. No topo da janela de propriedades estará um campo com o ID do Modelo de Negócios a ser criado. O próprio Metadata Editor sugere uma opção (é aconselhável aceitar a opção do programa, uma vez que o não pode haver dois Modelos de Negócios com o mesmo nome). 4. Para nomear o seu Modelo de Negócios, digite o nome desejado no campo Name da janela de propriedades. 4.4 Criando Tabelas e Colunas de Negócios 1. Expanda a árvore de navegação Business Models e, logo em seguida, expanda também o modelo de negócios de sua criação. 2. Clique com o botão direito no link Business Tables e selecione a opção New Business Tables... do menu a ser aberto. 3. Selecione as tabelas a serem importadas. 4.5 Removendo Colunas Indesejáveis ao Modelo de Negócios 1. Expanda a árvore de navegação até que sejam mostradas as tabelas abaixo do link Business Tables. 2. Clique com o botão direito no link da tabela que contém a coluna a ser removida e selecione edit do menu a ser aberto. 3. Será aberta uma janela de propriedades da tabela selecionada. 4. Selecione a coluna a ser retirada no canto esquerdo da janela de propriedades e em seguida clique no botão de remoção (x vermelho logo acima). 5. Confirme o ato de remoção. Laboratório de Software Livre 8
4.6 Relacionando Tabelas e Colunas 1. Expanda a árvore de navegação Business Models e clique com o botão direito no link Relationships abaixo de seu modelo de negócios. 2. Selecione a opção New Relationships... do menu a ser aberto. 3. Será aberta a janela de propriedades da relação a ser criada. 4. Selecione as tabelas que serão relacionadas nos campos origem From Table/Field e destino To Table/Field. É também necessário selecionar as colunas a serem relacionadas (campos à direita da seleção das tabelas). Caso os campos a serem relacionados tenham nomes parecidos, uma opção é pressionar o botão Guess Matching Fields e o programa irá sugerir uma relação. 5. Defina o tipo de relação a ser criada selecionando uma opção no campo Relatonship. 6. Se a relação requerer associações mais complexas, selecione a caixa Complex Join e coloque o código SQL no campo abaixo. 7. Clique OK para finalizar a criação da relação. 4.7 Criando uma Visão de Negócios 1. Expanda a árvore de navegação Business Models e clique com o botão direito no link Business View. 2. Selecione a opção New Category... no menu a ser aberto. 3. Será aberta uma janela de propriedades da nova categoria. 4. Nomeie a categoria preenchendo o campo ID no topo da janela. 5. Clique em OK para finalizar a criação da visão de negócios. 4.8 Agrupando Colunas em Categorias 1. Na árvore de navegação à esquerda da tela de navegação do programa, certifique-se que os links Business Tables e Business View do seu modelo de negócios estejam expandidos. Laboratório de Software Livre 9
2. No link Business Tables, expanda as tabelas que contêm as colunas desejadas. 3. Arraste as colunas desejadas até o link Business View. 4. Está criada a visão de negócios. 4.9 Adicionando Segurança aos Objetos do Metadata Business Para começar a configuração de segurança, é necessário saber se o seu usuário possui os seguintes dados: 1. A base URL para o Pentaho BI Server e o nome do serviço (a base URL default é http://localhost:8080/pentaho e o nome do serviço default é ServiceAction). 2. Uma lista de credenciais de administradores para o servidor. Ajustando as informações de segurança: 1. Clique em Tools no canto esquerdo superior da tela de navegação e selecione a opção Security Service. 2. Será aberta a janela de informações de segurança. 3. Selecione a aba Service. 4. Em Service URL, digite a combinação do nome da base URL e do nome do serviço (por exemplo, em default seria http://localhost: 8080/pentaho/ServiceAction). 5. Em seguida, selecione o nível de informação de segurança de seu desejo: All, Users ou Roles. 6. Preencha o campo Username com um login de acesso administrador para validar o servidor. 7. Preencha o campo Password com a senha do login especificado. Laboratório de Software Livre 10
8. Para testar a validade do servidor, clique no botão de Test. Caso o servidor seja válido, clique em OK para finalizar a operação. Caso haja necessidade de trabalhar offline, existe a possibilidade de salvar as opções de segurança em um arquivo e disponibilizá-lo para o servidor Pentaho BI Server: 1. Vá na janela de teste de servidor de segurança (último passo no ajuste de informações de segurança). 2. Copie todo o conteúdo XML entre as tags content e /content e elas inclusive. 3. Cole a informação em um arquivo qualquer de texto e salve-o com o nome metadata security.xml. 4. Troque para a aba File na janela de informações de segurança. 5. Selecione o arquivo que você acabou de criar. 6. Clique em OK para terminar o processo. 4.10 Modificando Segurança de Conteúdos Caso haja necessidade de maior ou menor segurança das tabelas, colunas, modelos de negócios, etc. Siga os passos: 1. Clique com o botão direito na folha da árvore de navegação que você deseja modificar a segurança e selecione a opção Edit... 2. Clique no botão para adição de propriedades e em seguida será aberta uma janela com as propriedades pré-definidas. 3. Selecione a propriedade desejada e clique em OK. 4. Selecione a opção adicionada e, à direita da tabela de propriedades, modifique as permissões de segurança para usuários a seu gosto. 5. Clique em OK para finalizar o processo. Laboratório de Software Livre 11
4.11 Configurando o Pentaho BI Server para Segurança Por default, o Pentaho BI Server não reconhece a opção de segurança. Para que ela seja reconhecida, é necessário modificar o arquivo pentaho-solutions/system/pentaho.xml. Substitua a linha: # <ICwmSchemaFactory scope= session >org.pentaho.pms.factory.cwmschemafactory</icwmschemafactory> Por: # <ICwmSchemaFactory scope= session >org.pentaho.repository.cwm.securityawarecwmschemafactory</icwmschemafactory> 4.12 Exportando Domínios Exportar domínios previamente feitos pode ser bastante importante na confecção de backups. 1. No canto esquerdo superior da tela de navegação, selecione a opção File e, no menu que será aberto, selecione a opção Export to XMI File. 2. Caso seu domínio ainda não tenha sido salvo, será aberta uma janela com a opção de salvar as alterações. Clique em OK para salvá-las. 3. Logo em seguida, será aberta outra janela com campos nome e local que o domínio sera exportado a serem preenchidos. Preencha-os e clique em OK para finalizar o processo. 4.13 Importando Domínios Da mesma forma que exportar domínios, importá-los pode ser bastante útil na recuperação de backups. Laboratório de Software Livre 12
1. No canto esquerdo superior da tela de navegação, selecione a opção File e, no menu que será aberto, selecione a opção Import from XMI File. 2. Caso haja algum domínio sendo utilizado que contenha alterações não salvas, será aberta uma janela com a opção para salvá-las. 3. Será aberta outra janela para a seleção do arquivo de domínio. Selecione a localização do mesmo e clique OK. Logo em seguida nomeie o domínio importado (note que se houver outro domínio com nome semelhante, ele será substituído). 4.14 Configurando e Administrando Localidades (Internacionalização) 1. Troque a planilha de navegação para Locales. 2. Para criar uma nova localidade, selecione a primeira linha em branco na planilha de localidades. 3. Na primeira coluna Code, coloque o código de localização Java que será utilizado. 4. Vá para a próxima coluna Description e digite uma descrição simples para ela. 5. Em seguida, na coluna Order, especifique em qual pedido a localidade será utilizada. 6. Na última coluna, coloque Y para ativar a localidade e N para desativála. 7. Clique em Apply Changes para salvar as alterações. 4.15 Testando o Meta-Modelo Após o término de seu meta-modelo, é possível realizar testes para simular a ligação entre as tabelas no mesmo. Para isso, siga os passos abaixo: 1. Abra o editor de query (Query Editor). Laboratório de Software Livre 13
2. Selecione alguns campos para teste. 3. Realize a consulta (note que um resultado correto mostra uma boa estrutura de meta-modelo). 4. Caso o resultado não seja o esperado, corrija as conexões e tabelas e realize novamente o teste. 4.16 Backups e Recuperação de Domínio A cada vez que um domínio é salvo no repositório, uma arquivo de recuperação desse domínio é salvo no sistema, abaixo do diretório pentahometa. Esse diretório é tipicamente localizado no home do usuário. Esse arquivo de recuperação irá conter o estado do último domínio salvo com sucesso. Esses arquivos são nomeados: recovery [studio:domainname].xmi. Para recuperar os dados desses arquivos, apenas importe-os. 4.17 Publicando um Domínio para o Pentaho BI Server O primeiro passo a ser dado a fim de publicar um domínio para o Pentaho BI Server é ter o domínio convertido em arquivo XML (ou XMI). Para isso, basta exportá-lo como tal. Tendo o domínio XML, então os requisitos necessários são os seguintes: 1. Ter uma senha para a publicação no Pentaho BI Server válida. Caso não tenha, entre em contato com o administrador do server para obtêla. 2. Ter um login e senha para o seu Pentaho BI Server com acesso de administrador. 3. Saber a base URL para o seu Pentaho BI Server (a base URL para o demo do Pentaho é http://localhost:8080/pentaho). 4. Adicionar à base URL o nome do serviço de publicação. O nome default é RepositoryFilePublisher. Laboratório de Software Livre 14
5. Saber o nome da solução que o domínio se aplicará. Publicando: 1. Clique em File no canto esquerdo superior da tela de navegação e, em seguida, selecione a opção Publish to Server. 2. Será aberta uma janela contendo os campos com os dados do domínio público. 3. Em Publish Location, digite o nome da sua solução. 4. Em Web Publish URL, digite o nome da sua base URL seguida do nome do serviço de publicação (default: RepositoryFilePublisher). 5. Em Publish Password, digite sua senha pública. 6. Em Username, digite seu login. 7. Em Password, digite sua senha pessoal. 8. Clique em OK para finalizar a publicação. Note que, se o arquivo.xmi já existir, então o antigo será substituído. Referências [1] Todos os conceitos citados acima são explicados na documentação do Mondrian, no link: http://wiki.pentaho.com/display/ ServerDoc1x/02.+Pentaho+Metadata+Editor+Getting+Started+ Guide. Laboratório de Software Livre 15
5 Créditos Documento Manual da Ferramenta Metadata Editor Direitos Autorais Reservados (c) Universidade Federal de Minas Gerais Departamento de Ciência da Computação Geraldo Ribeiro Franciscani Jnior Esta documentação é livre; você pode redistribuí-la e/ou modificá-la sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto na sua versão 2, como qualquer versão posterior (a seu critério). A distribuição desta documentação é feita na expectativa de que ela seja útil, porém, sem nenhuma garantia; nem mesmo a garantia implícita de comerciabilidade ou adequação a uma finalidade específica. Consulte a Licença Pública Geral do GNU para mais detalhes. http://creativecommons.org/licenses/gpl/2.0/ http://creativecommons.org/licenses/gpl/2.0/legalcode.pt Laboratório de Software Livre 16