Elipse Knowledgebase

1) Introdução

O uso de bancos de dados relacionais normalmente envolve a instalação e administração desses bancos. Entretanto, nem sempre é possível ter esses recursos disponíveis no momento de testes ou da implantação de um determinado projeto. Dessa forma, esse artigo discute alguns pontos sobre a instalação básica e sobre o conjunto de ações a serem tomadas para que o Elipse E3 salve e consulte dados em um servidor MS SQL Server.

Cabe ressaltar que os serviços de um administrador de banco serão úteis desde a instalação até a operação do projeto, e que eventuais configurações do servidor devem ser feitas por um profissional especializado.

De qualquer forma, seguindo os passos descritos nesse artigo, tem-se uma idéia das vantagens de se utilizar um banco de dados que seja mais confiável do que um simples arquivo do MS Access.


Instalação Local

Requisitos

Para ilustrar a utilização do MS SQL Server como o banco de dados de projetos envolvendo o Elipse E3, foi utilizada uma instalação de avaliação do software na sua versão SQL Server 2000. Entretanto, os procedimentos aqui descritos são idênticos para qualquer cópia licenciada desse software. Para a instalação definitiva do MS SQL Server 2000, os requisitos de hardware e software devem ser consultados junto à Microsoft, assim como a política de licenciamento específica para esse produto.

Os requisitos de instalação do Elipse E3 não são modificados quando utilizam comunicação com esse banco de dados. Para tirar eventuais dúvidas, consultar documentação pertinente, ou o suporte técnico gratuito da Elipse Software.


Procedimentos

As figuras seguintes ilustram o procedimento-padrão para a instalação do software MS SQL Server 2000 para rodar em uma máquina stand-alone, ou seja, o servidor de banco de dados, assim como todos os clientes, serão executados no mesmo microcomputador.

Mesmo que a aplicação final vá utilizar acessos remotos a esse servidor de banco de dados, o primeiro passo para a criação desse sistema é a instalação do MS SQL Server 2000 em uma máquina que vai ser a responsável pelo armazenamento.

Seguir as instruções abaixo é suficiente para a configuração básica de um sistema SQL Server. Qualquer dificuldade encontrada deve ser analisada, e a solução deve ser buscada junto ao suporte técnico do software SQL Server, que é fornecido pela Microsoft.

A Figura 1 mostra o "Assistente de Instalação", que trará todos os procedimentos necessários à instalação do SQL Server. Para iniciar, deve-se acessar a opção ‘Install Database Server’.


Figura 1: Assistente de instalação


Selecionada a opção de instalação do servidor, segue a janela de criação de nova instância. Em uma instalação básica, opte pela opção mostrada na tela seguinte. Para as outras opções, o procedimento não foi testado. A Figura 2 é a tela que representa o segundo passo na instalação.


Figura 2: Criação de uma nova instância


Depois de criada a instância, é preciso definir o local da instalação. Como afirmado anteriormente, a instalação deve ser feita na máquina local. Verifique a identificação da máquina na rede, pois esse dado será importante na configuração do objeto "Servidor de Banco de Dados" no E3.

No caso em estudo, o SQL Server foi instalado em uma máquina chamada "PH", como ilustrado na Figura 3.


Figura 3: Definição da máquina onde será feita a instalação


O passo seguinte, ilustrado na tela da Figura 4, consiste em definir o nome da instância do servidor SQL Server. Não serão feitas modificações nesses parâmetros; basta clicar sobre o botão "Next" e seguir para o próximo passo.


Figura 4: Definição da "Instance Name"


Mais uma vez serão usadas as opções-padrão definidas para os parâmetros "Services Accounts". A tela presente na Figura 5 é correspondente à configuração dessas opções.


Figura 5: Service Accounts


O passo seguinte é a definição do modo de autenticação a ser utilizado no SQL Server, que pode seguir a autenticação de usuários definida pelo Windows ou pode usar um modelo misto (que agrega autenticação pelo Windows ou pelo próprio SQL Server). Para comunicação com o E3, é necessário usar o modelo misto. Para tanto, defina a senha do administrador (usuário "sa"). No exemplo usado para desenvolver esses procedimentos, foi utilizada a senha "sa", idêntica ao usuário "sa". Verificar a correta grafia das palavras para evitar erros por letras maiúsculas e minúsculas.

Posteriormente, será mostrada uma alternativa para a configuração do modo de autenticação suportado pelo SQL Server, através da ferramenta "SQL Server Enterprise Manager", descrita com maiores detalhes mais adiante nesse documento.


Criação do Banco de Dados no Server

Estrutura do servidor SQL Server

A interação com o servidor de banco de dados se faz através da ferramenta "SQL Server Enterprise Manager". Depois de instalado o servidor, ao executar pela primeira vez a ferramenta Enterprise Manager, a estrutura encontrada será a descrita pela Figura 6. Nela, podem ser vistos os diversos recursos de sistema utilizados pelo servidor, inclusive com diferentes bancos de dados criados internamente para a operação e manutenção do sistema.

Para evitar problemas de funcionamento do servidor, não faremos modificações nesses bancos de dados. É recomendável que um banco de dados específico seja criado sempre que um novo projeto é iniciado sobre um servidor SQL Server. Isso traz otimizações sobre o desempenho do servidor, além de isolar diferentes projetos, tornando a estrutura do sistema modular, como se recomenda que faça em todos os projetos no E3.


Figura 6: Estrutura inicial do SQL Server


O uso do SQL Server para armazenamento de dados exige que sejam inseridos diferentes objetos "Database" no servidor. Dessa maneira, é possível separar diferentes sistemas que estejam usando o mesmo servidor. Por exemplo: cada "Database" tem o seu controle de usuários e tem as suas configurações de espaço disponível (conforme configurado na aba "Data Files" das propriedades do "Database", conforme Figura 9, mais adiante). Para solução de outras dúvidas, entre em contato com o suporte técnico da Microsoft.


Procedimentos para criação de databases no SQL Server

Para ilustrar a conexão entre o Elipse E3 e o SQL Server, vamos criar um "Database" chamado "TesteE3". As configurações necessárias são ilustradas nas Figuras 7 a 10.


Figura 7: Inserção de um novo banco de dados


A configuração de um novo "Database" no servidor SQL Server exige algumas parametrizações, além do nome do objeto que será criado.

Assim como no Access, os bancos de dados no MS SQL Server armazenam dados em arquivos separados, ou seja, cada banco de dados é um arquivo independente. A configuração de espaço alocada para cada database é configurada na própria definição do objeto. Outra característica é que a geração de logs de transação pode ser implementada por database. Eventualmente, as informações contidas no arquivo de logs de transação podem ajudar na solução de conflitos entre o funcionamento esperado no E3 e o comportamento real. Dessa maneira, aliado aos logs criados pelo E3, tem-se uma boa quantidade de informações para solução de eventuais problemas. As configurações desses arquivos seguem nas Figuras 9 e 10.


Figura 8: Configuração de Database – Aba "General"


Para maior detalhamento de cada passo na criação do banco de dados, verifique a documentação do MS SQL Server 2000. A documentação é instalada junto com o servidor, e a literatura disponível é vasta.


Figura 9: Configuração de Database – Aba "Data Files"


Figura 10: Configuração de Database – Aba "Transaction Log"


Criação de Usuários

O controle de usuários do SQL Server é feito através do uso de "Login". Esse login é que recebe as informações de permissão de acesso e é com ele que se consegue o acesso de um projeto E3 ao banco de dados. Nesse exemplo, será criado o login "Usuario", com a senha "E3". Essas informações, somadas ao nome do banco de dados ("TesteE3") e ao nome do servidor ("PH"), são o suficiente para que o E3 possa acessar o SQL Server 2000.


Figura 11: Criação de novo Login


As permissões de cada papel (Role) disponível no BD são inerentes ao modelo de permissões do servidor. Para mais informações, consulte a documentação do BD.


Figura 12: Propriedades do Login criado


O usuário a ser utilizado no E3 deve ser um usuário sem restrições, visto que a estrutura dos objetos de acesso ao banco (com históricos e fórmulas) necessita criar e/ou atualizar estruturas de tabelas.


Figura 13: Propriedades do Login – Aba "General"


Uma boa política de segurança é permitir o acesso do usuário usado no E3 apenas ao banco de dados a ser trabalhado pelo E3.


Figura 14: Propriedades do Login – Aba "Database Access"


Permissões de usuários

No SQL Server 2000, as permissões de determinado usuário são feitas por "Database". Dessa maneira, para que o E3 possa interagir com o servidor, o usuário criando anteriormente tem que receber todas as permissões possíveis, devido ao modo como os objetos que utilizam bancos de dados no Elipse funcionam.

O acesso às configurações de usuário é feito nas propriedades do "Database", na aba "Permissions", como ilustra a Figura 15.


Figura 15: Permissões de usuário sobre o Banco de Dados


Estrutura de um Banco de Dados de usuários

Um banco de dados criado por usuário, como será sempre o caso dos objetos definidos para uso com o E3, tem sempre a estrutura inicial mostrada na Figura 16. Todos os objetos que estão relacionados a um "Database" são objetos suportados pelo padrão SQL. O uso correto de cada um dos objetos disponíveis, visando a melhoria de performance do conjunto E3-SQL Server, é altamente recomendável.

Entretanto, o trabalho de definição e implementação dos tipos necessários (como "Visões" e "Procedimentos Armazenados") é algo complexo, que envolve planejamento e tempo de desenvolvimento, e que cabe a um profissional especializado nesse assunto. Desse modo, não faremos nenhuma inclusão desses tipos nesse documento.


Figura 16: Estrutura de um Banco de Dados de usuário


Criação dos Acessos ao Banco de Dados no E3

Configuração do Projeto

Crie uma aplicação padrão no E3 Studio. Isso pode ser feito através do "Assistente de Criação de Projetos". Ao finalizar o assistente, o projeto terá a estrutura ilustrada na Figura 17.


Figura 17: Aplicação padrão no E3


Para ilustrar o acesso ao SQL Server 2000, faremos a criação de um histórico registrando dados por scan de um segundo. Deverá ser introduzido um tag do tipo Demo, cujas configurações não precisam ser alteradas. A configuração do ServidorDB do projeto-padrão a ser usado deve ser feita como a Figura 18 ilustra.


Figura 18: Configuração do ServidorDB para acesso ao SQL Server – Passo 1


Com um duplo clique, acesse a janela de configuração de acesso ao Servidor SQL definido na janela de propriedades (Figura 18). Os parâmetros deverão ser alterados para que se adequar aos disponíveis na instalação do SQL Server. Se todos os passos desse tutorial forem seguidos, a única modificação necessária será o nome do servidor ("PH"). Os outros parâmetros deverão ser os mesmos que os ilustrados na Figura 19.


Figura 19: Configuração do ServidorDB para acesso ao SQL Server – Passo 2


Feita a configuração do banco de dados, deve-se configurar o histórico que acessará esse banco. O primeiro passo (Figura 20), é a inserção do tag demo que será utilizado para envio de diferentes valores ao banco de dados.


Figura 20: Configuração do Histórico de exemplo – Passo 1


O passo seguinte para a construção do histórico é a configuração do banco de dados a ser utilizado, e também o nome da tabela a ser criada. Na Figura 21, podemos observar que o nome da tabela criada foi "TabelaSQLServer". Essa tabela servirá para ilustrar a busca de dados no Elipse e também para visualizarmos o uso da ferramenta "SQL Query Analyser", que é o cliente usado para consultas no SQL Server.


Figura 21: Criação do Histórico de exemplo – Passo 2


Finalizada a configuração do histórico, o passo final é a criação da estrutura de tabelas no ServidorDB. Para isso, utilize o botão "Gerar estrutura no BD", mostrado em destaque na Figura 22.


Figura 22: Criação da Estrutura do histórico no SQL Server


Se não ocorrerem problemas ou erros de configuração, o resultado será a mensagem mostrada na Figura 23.

Em caso de mensagens de erros, deve-se localizar o problema. Ao final desse tutorial, existe uma lista de ocorrências possíveis que foram testadas e cujos resultados foram listados. Recorra a essa base de dados, se necessário.


Figura 23: Resultado esperado para a criação da estrutura de tabelas


Para visualizar o histórico em ação (salvando dados no servidor SQL Server), crie na "TelaInicial" um objeto E3Browser, e configure a sua consulta para acessar o ServidorDB como configurado acima, fazendo consulta sobre a "TabelaSQLServer" configurada no histórico e configure o E3Browser para ser atualizado automaticamente a cada 10 segundos, por exemplo. A Figura 24 ilustra a consulta a ser criada no E3Browser.


Figura 24: Consulta do E3Browser


Uso do projeto em Runtime

Depois de configurado o projeto, com o intuito de visualizar o processo, execute o domínio e verifique o comportamento do conjunto. Uma boa política é tentar efetuar nos clientes do servidor as mesmas consultas implementadas, por exemplo, nos E3Browser que acessam os dados históricos salvos pelo projeto, e verificar o seu comportamento.

Depois de algum tempo executando o projeto, o E3Browser passará a exibir os dados que estão sendo enviados ao servidor. É possível consolidar os dados que são mostrados no Elipse e os que estão salvos no servidor utilizando o objeto E3Query do E3Browser (Figura 24) e o software "SQL Query Analyser". Para isso, crie diferentes consultas ao banco e edite-as no E3Query e também no Query Analyser. Os resultados deverão ser os mesmos, se o domínio estiver parado, ou semelhantes, se o domínio estiver rodando. Essa diferença deve-se à atualização constante do banco quando o domínio está sendo executado.

Para a edição de consultas no E3Query, habilite a opção "Habilita edição direta do SQL".


Instalação remota na opção Clientes

Os passos iniciais para a instalação do SQL Server em todas as opções são os mesmos, até a definição dos recursos que serão instalados. A Figura 25 mostra a tela onde é definido o tipo de instalação a ser feita:


Figura 25: Opção de instalação de clientes


Na Figura 26, temos as opções de ferramentas a instalar. A não ser que se tenha conhecimento de todas as ferramentas, é recomendável não alterar essas opções. Depois desse passo, a instalação será iniciada e, depois de completada, deverá ser finalizada pelo usuário.


Figura 26: Opções de ferramentas a instalar


Configurações dos clientes

Depois de instalados os softwares clientes do SQL Server, é necessário configurá-los para que acessem o banco de dados remoto de interesse. Na mesma rede, podem existir diferentes servidores, e o mesmo cliente pode acessar todos os disponíveis simultaneamente. Entretanto, a configuração aqui mostrada serve para nosso intuito de mostrar a menor estrutura necessária para o acesso remoto do E3 a um servidor SQL Server, seja ele local (na mesma máquina que o E3) ou remoto (em computadores diferentes, na mesma rede).

Para iniciar a configuração do acesso ao SQL Server de interesse, inicie o SQL Enterprise Manager. A figura 27 mostra o estado inicial do software Enterprise Manager sem nenhum servidor registrado. Para registrar o servidor ao qual se deverá conectar, clique sob o item "SQL Server Group", e selecione "New SQL Server Registration", como mostrado na Figura 28.


Figura 27: Enterprise Manager sem registro de servidores


Uma vez iniciado o processo, a seqüência de configurações segue da Figura 29 até a Figura 35, onde o Enterprise Manager está acessando o SQL Server remoto.

Só para salientar, os passos definidos aqui têm como finalidade ilustrar o uso de acesso remoto a um banco de dados SQL Server, sendo que eventuais falhas nos procedimentos ou modificações na estrutura utilizada, são de responsabilidade do usuário do banco de dados instalado. Para solucionar eventuais dúvidas sobre o funcionamento do acesso remoto, que não esteja coberto por esse documento, consulte a documentação do MS SQL Server 2000, ou entre em contato com o suporte técnico da Microsoft.


Figura 28: Início do processo de registro de servidores SQL Server remotos


O segundo passo, depois de iniciado o registro dos servidores disponíveis, é selecionar qual (ou quais) bancos de dados serão acessados via rede. No momento da instalação dos clientes em uma máquina remota, para a produção desse tutorial, estavam instalados dois servidores SQL Server na rede. Um deles foi selecionado, como poderemos observar nos passos seguintes.


Figura 29: Servidores disponíveis na rede


Assim como na instalação completa, mostrada no início desse documento, na instalação remota também deve ser feita a opção pelo modo de autenticação. Esse passo pode ser feito posteriormente, conforme a seqüência dos passos nos mostrará. A Figura 30 ilustra esse passo, que deverá ser ignorado.


Figura 30: Definição do modo de autenticação


Outra tela que deverá ser passada sem alteração é a que é mostrada na Figura 31.


Figura 31: Seleção de SQL Server Group


Após esse passo, chega-se a Figura 32, que mostra o servidor (ou servidores) registrado no Enterprise Manager. Para concluir o processo de registro e fazer a primeira conexão ao servidor remoto configurado, clique em "Finish".


Figura 32: Fim da Etapa de Registro


O processo de registro estará finalizado. Ao pressionar "Finish", o Enterprise Manager se conectará ao servidor SQL registrado, e o resultado será negativo devido à autenticação de usuários não ter sido corretamente configurada. Para isso, será exibida a tela mostrada na Figura 33. Os parâmetros a serem digitados referem-se ao servidor remoto, e o tipo da autenticação deve ser "Use SQL Server authentication", com o nome e a senha do administrador do sistema. No nosso caso, o login é "sa" e a senha é "sa".


Figura 33: Primeira conexão ao SQL Server remoto


Como resultado definitivo, depois da correta autenticação do servidor, o Enterprise Manager se comportará de maneira idêntica ao mostrado na operação local do servidor de banco de dados. As Figuras 34 e 35 mostram como é finalizado o processo de registro de servidores e o resultado no Enterprise Manager depois do registro.


Figura 34: Primeira conexão registrada ao servidor remoto


Para o uso de mais de um servidor remoto, é possível repetir o procedimento para registro. É importante lembrar que a operação dos servidores se manterá de maneira independente: eles estarão em máquinas diferentes, armazenando dados diferentes, sem ligação lógica ou física entre eles.


Figura 35: Servidor remoto registrado


Ferramentas

Enterprise Manager

É a ferramenta utilizada para administração do MS SQL Server. Os recursos disponíveis que são necessários à comunicação do E3 com o SQL Server (local ou remotamente) foram ilustrados no corpo desse documento. Qualquer informação adicional pode ser conseguida na documentação da ferramenta ou junto ao suporte técnico da Microsoft.


Service Manager

A maneira correta de configurar a operação do servidor MS SQL Server é através da ferramenta "SQL Server Service Manager". Ele indica os servidores disponíveis na rede e os serviços disponíveis para cada servidor. Nesse documento, utilizamos apenas o serviço "SQL Server", mas existem outros cuja finalidade é desconhecida e irrelevante para o propósito desse documento.

Em resumo, para iniciar ou parar a execução do MS SQL Server, utilize o Service Manager.


Figura 36: Interface do Service Manager


SQL Query Analyzer

A ferramenta SQL Query Analyzer é a ferramenta disponível para consultas aos bancos de dados. Através dele, todas as consultas necessárias nos objetos de um projeto E3 podem ser testadas.

O conjunto de funções disponíveis na linguagem padrão SQL, e as extensões específicas de cada servidor são bastante abrangentes. Dessa maneira, em caso de alguma consulta mais elaborada, envolvendo cálculos ou uniões de dados de diferentes tabelas (joins), é interessante testar a consulta nesse cliente SQL.

Além disso, essa ferramenta serve para que se verifique o correto envio de dados do E3 para o servidor. Dessa maneira, é possível localizar problemas quando o sistema E3-SQL Server não funciona adequadamente.

A Figura 37 mostra a interface padrão para o SQL Query Analyzer.


Figura 37: Interface do SQL Query Analyzer


Todos os recursos do SQL Query Analyzer estão limitados às permissões definidas para o usuário conectado ao sistema. Entretanto, para verificar as possibilidades de atuação sobre o banco de dados, como busca de dados, cálculos sobre os valores e funções de administração via SQL, todas as opções são mostradas nessa ferramenta, com o usuário a ser usado no E3.


Uso de ADODB para acesso via Scripts

Para acesso ao SQL Server através de scripts, usa-se uma conexão ADODB. A string de conexão a esse tipo de banco de dados segue o modelo definido a seguir:
            DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;

O uso desse tipo de acesso deve ser restrito a casos onde não existe outra solução. O E3 disponibiliza recursos que visam minimizar o uso desses acessos via script. Entretanto, eventualmente o uso desse recurso pode ser necessário.


Descrição de Erros

Procedimento para localização de erros

Nessa seção, alguns dos erros possíveis serão listados. Em caso de problemas, o procedimento correto para descobrir o erro é: