Histórico da Página
Informações | ||
---|---|---|
| ||
Esta página é destina para atualizações 1.6 e superiores do TOTVS Fluig Plataforma. Caso possua uma atualização anterior acesse: Como configurar o banco de dados MySQL na release 1.5.13 ou inferior? |
Índice
Índice | ||||||||
---|---|---|---|---|---|---|---|---|
|
Versões homologadas do MySQL
...
Para verificar as versões homologadas do MySQL acesse a Matriz de Portabilidade.
...
Passo a passo para configuração do MySQL
...
As configurações apresentadas abaixo devem ser realizadas antes da criação do banco de dados da plataforma.
Aviso | ||
---|---|---|
| ||
A atualização para versão MySQL 8.0, ou seja, quando já existe um banco criado em versões anteriores, é um processo complexo que envolve diversas configurações e requer muita atenção. Recomendamos consultar um especialista em banco de dados para executar esses procedimentos devido a complexidade das configurações. Contudo, listamos alguns materiais de apoio que indicamos a leitura antes de prosseguir com a atualização: https://dev.mysql.com/doc/refman/8.0/en/upgrading.html https://dev.mysql.com/blog-archive/inplace-upgrade-from-mysql-5-7-to-mysql-8-0/ |
Nota | ||
---|---|---|
| ||
Por questões de segurança é altamente recomendável efetuar a encriptação da senha conforme o procedimento informado na documentação encriptação de senha do banco de dados. |
Criação do usuário e concessão de privilégios
Para a criação de um novo usuário em banco de dados MySQL usamos a instrução CREATE USER, conforme sintaxe abaixo:
Bloco de código | ||
---|---|---|
| ||
CREATE USER 'sha2user'@'localhost'
IDENTIFIED WITH caching_sha2_password BY 'password'; |
Onde:
- sha2user: Nome do usuário que será criado;
- localhost: Host que irá acessar;
- password: Senha do usuário que será criado;
Após criado o usuário é necessário conceder os privilégios de sistema necessários para ele, conforme sintaxe abaixo:
Bloco de código | ||
---|---|---|
| ||
GRANT all ON fluig.* TO 'sha2user'@'localhost'; |
...
Onde:
- sha2user: Nome do usuário criado anteriormente;
- localhost: Host do usuário criado anteriormente;
Parâmetro de conexão
...
Nessa etapa, é realizada uma configuração específica para a versão do MySQL 8.0. Para as demais versões do MySQL permanece o que foi configurado por padrão.
Caso a configuração seja para a versão MySQL 8.0, é necessário alterar o parâmetro de conexão do arquivo domain.xml. Para isso, acesse o diretório \appserver\domain\configuration e localize as tags <connection-url>. O parâmetro dessa tag deve ser alterado de: ?useSSL=false para ?allowPublicKeyRetrieval=true&useSSL=false
Case sensitive
...
Por padrão, aliases de tabelas são case sensitive no Unix, mas não são no Windows. Para evitar problemas causados por esta característica, no MySQL é necessário adicionar a variável de sistema lower_case_table_names no names no arquivo de configuração do MySQL.
Veja o parâmetro a seguir:
Painel | ||
---|---|---|
| ||
Se você utiliza o banco de dados MySQL em versões anteriores a 8.0, basta incluir essa variável no arquivo my.ini (Windows) ou my.cnf (Linux).
|
Âncora | ||||
---|---|---|---|---|
|
Painel | ||
---|---|---|
| ||
Bloco de código | ||
| ||
Se você utiliza o banco de dados MySQL na versão 8.0, no Windows você não precisa efetuar nenhuma configuração. A variável lower_case_table_namesjá vem configurada por padrão com o valor 1.
| ||
lower_case_table_names =1 |
para o valor 1. Por se tratar de uma variável de sistema, que não pode ser alterada posteriormente, é muito importante configurá-la corretamente na instalação. Para mais informações sobre o uso e configuração do case sensitive na versão 8.0, consulte aqui. |
Engines
...
Card | |
---|---|
|
| |||||
Além disso é necessário confirmar que as tabelas serão criadas corretamente no banco de dados. Para isso, no Command Line Client do MySQL verifique a engine utilizada informando o comando:
|
...
Localize a engine InnoDB, conforme a imagem abaixo: |
O comando acima apresenta as engines do MySQL. A engine InnoDB deve estar na lista
...
Se a engine InnoDB não for apresentada como Default, o parâmetro default_storage_engine também deve ser adicionado ao arquivo, conforme segue:
|
Memória
...
Também é possível definir a quantidade de memória a ser usada pelo MySQL. Em um servidor dedicado, a boa prática é alocar de 75% a 80% da memória disponível para o banco de dados:
Bloco de código | ||
---|---|---|
| ||
innodb_buffer_pool_size=<valor em bytes> |
- Por exemplo, para alocar 128 MB de memória
...
- teríamos: innodb_buffer_pool_size=134217728.
Criação de tabelas
...
Caso sejam criados formulários com muitos campos, sendo a maioria deles do tipo TEXT, o MySQL pode restringir a criação de tabelas em que o tamanho somado dos campos ultrapasse o limite permitido. Recomendamos
Recomendamos efetuar as seguintes configurações no banco de dados para solucionar essa restrição:
Bloco de código | ||
---|---|---|
| ||
innodb_log_file_size=512M #Somente para MySQL em versões anteriores a 8.0
innodb_log_buffer_size=800M
innodb_strict_mode=0 |
Confirmar alterações
...
...
Após realizar as configurações expostas nos passos anteriores, é necessário reiniciar o MySQL e confirmar a aplicação das alterações.
Para verificar se a configuração case sensitive foi efetuada com sucesso, execute o seguinte comando SQL :abaixo. Se no resultado a coluna value possuir o valor 1 a configuração está correta.
Bloco de código | ||
---|---|---|
| ||
SHOWSHOW GLOBAL VARIABLES LIKE 'lower_case_table_names'; |
Se no resultado a coluna value possuir o valor 1 a configuração está correta.
Confirme também a alteração do Engine para InnoDB, caso tenha adicionado o parâmetro default_storage_engine ao arquivo:
...
Se a engine InnoDB aparecer como Default a configuração foi aplicada com sucesso. .
Nota | ||
---|---|---|
| ||
|
Criação do banco de dados com codificação UTF-8
...
O fluig A plataforma necessita de uma base de dados com codificação charset UTF-8, para . Para criar o banco com esta característica utilize o seguinte comando SQL, substituindo "nome_do_banco" pelo nome do banco a ser criado:
Painel | |||||
---|---|---|---|---|---|
| |||||
|
Onde nome_do_banco é o nome do banco a ser criado.
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Informações |
---|
Não há um padrão para "nome_do_banco", cada cliente pode colocar o nome que desejar, por exemplo: fluig, fluig-homologacao ou minhaempresa. |
...
Download do Driver
...
Para utilização do banco de dados MySQL, é necessário fazer o download do driver MySQL separadamente.
Por isso, antes de iniciar a instalação do Fluig/atualização da plataforma, siga os passos a seguir:
Faça o download do
Driver em diretamente no site do MySQL: http://dev.mysql.com/downloads/connector/j/;driver diretamente no site do MySQL;
Informações title Fique atento! O driver do MySQL deve estar na mesma versão do banco MySQL que você tem instalado. Para saber quais são as versões homologadas acesse a Matriz de Portabilidade.
- No campo Select Platform acione a opção Platform Independent;
- Clique no botão Download ao lado da versão em arquivo ZIP;
- Clique em No thanks, just start my download e será iniciado o download de um arquivo chamado mysql-connector-java-xx.y.zzXX.Y.ZZ.zip ou mysql-connector-j-XX.Y.ZZ.zip, onde xxonde XX.yY.zz é ZZ é a versão corrente atual do Driver driver;
- Descompacte o arquivo baixado, será . Será criada uma pasta chamada mysql-connector-java-xx.y.zz-XX.Y.ZZ ou mysql-connector-j-XX.Y.ZZ.zip;
- Nesta pasta há um arquivo chamado mysql mysql-connector-java-xxXX.yY.zzZZ-bin.jar ou mysql-connector-j-XX.Y.ZZ.jar. Esse arquivo é o Driver.o driver.
Durante a instalação da plataforma, será necessário indicar o caminho onde o driver do MySQL foi armazenado.
Nota | ||
---|---|---|
| ||
A atualização do Fluig não permite atualizar o driver pelo instalador. Esse procedimento deve ser executado manualmente, seguindo os passos abaixo:
|
Otimizando a performance do banco de dados MySQL
...
Aviso | ||
---|---|---|
| ||
O limite default do banco MySQL para campos tipo text é de 195. Dentro deste padrão são realizados todos os testes com formulários no Fluig. Não recomendamos a alteração do parâmetro innodb_log_file_size para exportação de campos, pois pode comprometer o desempenho da aplicação. |
Quando trabalhamos com um volume elevado de dados e usuários, o banco de dados pode apresentar problemas de baixo desempenho. Um investimento em capacidade física dos servidores é sempre bom. Porém , porém há momentos que o tuning irá representar ganhos expressivos de performance.
...
title | Dica |
---|
Para
...
Para mais informações sobre tunning e otimização de performance do MySQL consulte a documentação oficial disponível em MySQL Optimization.