MySQL Reference Manual

Copyright c 1997-2003 MySQL AB

Sumrio a
1 Informaes Gerais . . . . . . . . . . . . . . . . . . . . . . . . 1 co
1.1 1.2 Sobre Este Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1.1 Convenes Usadas Neste Manual . . . . . . . . . . . . . . . . 2 co Viso Geral do Sistema de Gerenciamento de Banco de Dados a MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2.1 Histria do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 o 1.2.2 As Principais Caracter isticas do MySQL . . . . . . . . . . 6 1.2.3 Estabilidade do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 8 1.2.4 Qual o Tamanho Que as Tabelas do MySQL Podem Ter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 1.2.5 Compatibilidade Com o Ano 2000 (Y2K) . . . . . . . . 11 Viso Geral da MySQL AB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 a 1.3.1 O Modelo de Negcio e Servios da MySQL AB . . 13 o c 1.3.1.1 Suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.3.1.2 Treinamento e Certicao. . . . . . . . . . . . . 14 ca 1.3.1.3 Consultoria . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 1.3.1.4 Licenas Comerciais . . . . . . . . . . . . . . . . . . . 15 c 1.3.1.5 Parcerias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 1.3.2 Informaes para Contato . . . . . . . . . . . . . . . . . . . . . . 15 co Suporte e Licenciamento do MySQL . . . . . . . . . . . . . . . . . . . . . 17 1.4.1 Suporte Oferecido pela MySQL AB . . . . . . . . . . . . . 17 1.4.2 Copyrights e Licenas Usadas pelo MySQL . . . . . . 17 c 1.4.3 Licenas do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 c 1.4.3.1 Usando o Programa MySQL Sob uma Licena Comercial . . . . . . . . . . . . . . . . . . . . . . . . 18 c 1.4.3.2 Usando o Programa MySQL Sem Custo Sob GPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 1.4.4 Logomarcas e Marcas Registradas da MySQL AB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 1.4.4.1 O Logo Original do MySQL. . . . . . . . . . . . 20 1.4.4.2 Logomarcas da MySQL que Podem Ser Usadas Sem Permisso de Alterao . . . . . . . . 20 a ca 1.4.4.3 Quando Voc Precisa de Permisso de e a Alterao para Usar as Logomarcas do MySQL? ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 1.4.4.4 Logomarcas dos Parceiros da MySQL AB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 1.4.4.5 Usando a Palavra MySQL em Texto Impresso ou Apresentao . . . . . . . . . . . . . . . . . . . . . . . . . . 21 ca 1.4.4.6 Usando a Palavra MySQL em Nomes de Companhias e Produtos . . . . . . . . . . . . . . . . . . . 21 Mapa de Desenvolvimento do MySQL. . . . . . . . . . . . . . . . . . . . 22 1.5.1 MySQL 4.0 in a Nutshell . . . . . . . . . . . . . . . . . . . . . . . 22

1.3

1.4

1.5

ii 1.5.1.1 Recursos Dispon iveis no MySQL 4.0 . . . . 22 1.5.1.2 Servidor Embutido MySQL . . . . . . . . . . . . 24 1.5.2 MySQL 4.1 in a Nutshell . . . . . . . . . . . . . . . . . . . . . . . 24 1.5.2.1 Recursos Dispon iveis no MySQL 4.1 . . . . 24 1.5.2.2 Stepwise Rollout . . . . . . . . . . . . . . . . . . . . . . 26 1.5.2.3 Pronto para Uso em Desenvolvimento Imediato . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 1.5.3 MySQL 5.0, A Prxima Distribuio de o ca Desenvolvimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 1.6 MySQL e o Futuro (o TODO). . . . . . . . . . . . . . . . . . . . . . . . . . . 26 1.6.1 Novos Recursos Planejados Para a Verso 4.1 . . . . 27 a 1.6.2 Novos Recursos Planejados Para a Verso 5.0 . . . . 27 a 1.6.3 Novos Recursos Planejados Para a Verso 5.1 . . . . 28 a 1.6.4 Novos Recursos Planejados Para a Verso em um a Futuro Prximo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 o 1.6.5 Novos Recursos Planejados Para a Verso em um a Futuro a Mdio Prazo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 e 1.6.6 Novos Recursos que No Planejamos Fazer . . . . . . 33 a 1.7 Fontes de Informaes do MySQL . . . . . . . . . . . . . . . . . . . . . . . 33 co 1.7.1 Listas de Discusso MySQL . . . . . . . . . . . . . . . . . . . . 33 a 1.7.1.1 As Listas de Discusso do MySQL . . . . . . 33 a 1.7.1.2 Fazendo perguntas ou relatando erros . . . 35 1.7.1.3 Como relatar erros ou problemas . . . . . . . 36 1.7.1.4 Guia para responder questes na lista de o discusso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 a 1.7.2 Suporte a Comunidade MySQL Atrvs do IRC e (Internet Relay Chat) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 1.8 Qual compatibilidade aos padres o MySQL oferece ? . . . . . 41 o 1.8.1 Qual Padro o MySQL Segue? . . . . . . . . . . . . . . . . . . 42 a 1.8.2 Executando o MySQL no modo ANSI . . . . . . . . . . . 42 1.8.3 Extenses do MySQL para o Padro SQL-92. . . . . 43 o a 1.8.4 Diferenas do MySQL em Comparao com o c ca SQL-92 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 1.8.4.1 Subqueries . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 1.8.4.2 SELECT INTO TABLE . . . . . . . . . . . . . . . . . . . 46 1.8.4.3 Transaes e Operaes Atmicas . . . . . . 46 co co o 1.8.4.4 Stored Procedures e Triggers . . . . . . . . . . . 49 1.8.4.5 Chaves Estrangeiras . . . . . . . . . . . . . . . . . . . 50 1.8.4.6 Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 1.8.4.7 -- como In de Comentrio . . . . . . . . 51 icio a 1.8.5 Como o MySQL Lida com Restries . . . . . . . . . . . . 52 co 1.8.5.1 Restries de PRIMARY KEY / UNIQUE co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 1.8.5.2 Restries de NOT NULL . . . . . . . . . . . . . . . . 53 co 1.8.5.3 Restries de ENUM e SET. . . . . . . . . . . . . . . 53 co 1.8.6 Erros Conhecidos e Decincias de Projetos no e MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

iii 1.8.6.1 Erros da Verso 3.23 Corrigidos em Verses a o Posteriores do MySQL . . . . . . . . . . . . . . . . . . . . 54 1.8.6.2 Open Bugs / Decincias de Projeto no e MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Instalao do MySQL . . . . . . . . . . . . . . . . . . . . . 60 ca
2.1 Instalao rpida padro do MySQL . . . . . . . . . . . . . . . . . . . . . 60 ca a a 2.1.1 Instalando o MySQL no Windows . . . . . . . . . . . . . . . 60 2.1.1.1 Exigncias do Sistema Windows . . . . . . . . 61 e 2.1.1.2 Instalando uma Distribuio Binria do ca a Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 2.1.1.3 Preparando o Ambiente MySQL do Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 2.1.1.4 Selecionando um Servidor Windows . . . . 63 2.1.1.5 Iniciando o Servidor pela Primeira Vez . . 64 2.1.1.6 Iniciando o MySQL no Windows 95, 98, ou Me . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 2.1.1.7 Iniciando o MySQL no Windows NT, 2000, ou XP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 2.1.1.8 Executando o MySQL no Windows . . . . . 68 2.1.2 Instalando o MySQL no Linux . . . . . . . . . . . . . . . . . . 69 2.1.3 Instalando o MySQL no Mac OS X . . . . . . . . . . . . . 71 2.1.4 Instalando o MySQL no NetWare . . . . . . . . . . . . . . . 74 2.1.4.1 Instalando o MySQL para Binrios do a NetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 2.2 Detalhes Gerais de Instalao . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 ca 2.2.1 Como obter o MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 75 2.2.2 Vericando a Integridade do Pacote Usando MD5 Checksums ou GnuPG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 2.2.3 Sistemas Operacionais suportados pelo MySQL . . 78 2.2.4 Qual verso do MySQL deve ser usada . . . . . . . . . . 80 a 2.2.5 Layouts de Instalao . . . . . . . . . . . . . . . . . . . . . . . . . . 83 ca 2.2.6 Como e quando as atualizaes so lanadas? . . . . 84 co a c 2.2.7 Filosoa das Distribuies - Nenhum Bug co Conhecidos nas Distribuies . . . . . . . . . . . . . . . . . . . . . 85 co 2.2.8 Binrios MySQL compilados pela MySQL AB . . . 86 a 2.2.9 Instalando uma Distribuio Binria do MySQL . . 91 ca a 2.3 Instalando uma distribuio com fontes do MySQL . . . . . . . 94 ca 2.3.1 Viso geral da instalao rpida . . . . . . . . . . . . . . . . 95 a ca a 2.3.2 Aplicando patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 2.3.3 Opes t co ipicas do configure . . . . . . . . . . . . . . . . . . . 97 2.3.4 Instalando pela rvore de fontes do desenvolvimento a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 2.3.5 Lidando com Problemas de Compilao . . . . . . . . 103 ca 2.3.6 Notas MIT-pthreads . . . . . . . . . . . . . . . . . . . . . . . . . . 106 2.3.7 Instalando o MySQL a partir do Fonte no Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 2.3.7.1 Construindo o MySQL Usando VC++ . . 108

iv 2.3.7.2 Criando um Pacote Fonte do Windows a partir da Ultima Fonte de Desenvolvimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 2.4 Conguraes e Testes Ps-instalao . . . . . . . . . . . . . . . . . . . 111 co o ca 2.4.1 Problemas Executando o mysql_install_db. . . . 115 2.4.2 Problemas Inicializando o Servidor MySQL . . . . . 116 2.4.3 Inicializando e parando o MySQL automaticamente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 2.5 Atualizando/Desatualizando o MySQL . . . . . . . . . . . . . . . . . . 120 2.5.1 Atualizando da Verso 4.0 para 4.1 . . . . . . . . . . . . 120 a 2.5.2 Atualizando da Verso 3.23 para 4.0 . . . . . . . . . . . 123 a 2.5.3 Atualizando da verso 3.22 para 3.23 . . . . . . . . . . . 127 a 2.5.4 Atualizando da verso 3.21 para 3.22 . . . . . . . . . . . 128 a 2.5.5 Atualizando da verso 3.20 para 3.21 . . . . . . . . . . . 129 a 2.5.6 Atualizando a Tabela de Permisses . . . . . . . . . . . . 130 o 2.5.7 Atualizando para outra arquitetura . . . . . . . . . . . . 131 2.5.8 Atualizando o MySQL no Windows . . . . . . . . . . . . 132 2.6 Notas espec icas para os Sistemas Operacionais . . . . . . . . . 133 2.6.1 Notas Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 2.6.1.1 Conectando em um MySQL Rematamente a Windows Utilizando SSH . . . . . . . . . . . . . . . 133 2.6.1.2 Compilando clientes MySQL no Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 2.6.1.3 MySQL para Windows Comparado com o MySQL para Unix . . . . . . . . . . . . . . . . . . . . . . . 134 2.6.2 Notas Linux (Todas as verses) . . . . . . . . . . . . . . . . 136 o 2.6.2.1 Notas Linux para distribuies binrias co a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 2.6.2.2 Notas Linux x86 . . . . . . . . . . . . . . . . . . . . . 142 2.6.2.3 Notas Linux SPARC . . . . . . . . . . . . . . . . . 143 2.6.2.4 Notas Linux Alpha . . . . . . . . . . . . . . . . . . . 143 2.6.2.5 Notas Linux PowerPC . . . . . . . . . . . . . . . . 144 2.6.2.6 Notas Linux MIPS . . . . . . . . . . . . . . . . . . . 144 2.6.2.7 Notas Linux IA-64 . . . . . . . . . . . . . . . . . . . 144 2.6.3 Notas Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 2.6.3.1 Notas Solaris 2.7/2.8 . . . . . . . . . . . . . . . . . 147 2.6.3.2 Notas Solaris x86 . . . . . . . . . . . . . . . . . . . . 148 2.6.4 Notas BSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 2.6.4.1 Notas FreeBSD . . . . . . . . . . . . . . . . . . . . . . 148 2.6.4.2 Notas NetBSD . . . . . . . . . . . . . . . . . . . . . . . 150 2.6.4.3 Notas OpenBSD . . . . . . . . . . . . . . . . . . . . . 150 2.6.4.4 Notas OpenBSD 2.8 . . . . . . . . . . . . . . . . . . 150 2.6.4.5 Notas BSDI Verso 2.x . . . . . . . . . . . . . . . 150 a 2.6.4.6 Notas BSD/OS Verso 3.x . . . . . . . . . . . . 151 a 2.6.4.7 Notas BSD/OS Verso 4.x . . . . . . . . . . . . 151 a 2.6.5 Notas Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 2.6.5.1 Mac OS X 10.x . . . . . . . . . . . . . . . . . . . . . . 152 2.6.5.2 Mac OS X Server 1.2 (Rhapsody) . . . . . 152

v 2.6.6 Notas de Outros Unix . . . . . . . . . . . . . . . . . . . . . . . . . 152 2.6.6.1 Notas HP-UX para distribuies binrias co a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 2.6.6.2 Notas HP-UX Verso 10.20 . . . . . . . . . . . 153 a 2.6.6.3 Notas HP-UX Verso 11.x . . . . . . . . . . . . 154 a 2.6.6.4 Notas IBM-AIX. . . . . . . . . . . . . . . . . . . . . . 155 2.6.6.5 Notas SunOS 4 . . . . . . . . . . . . . . . . . . . . . . 157 2.6.6.6 Notas Alpha-DEC-UNIX (Tru64) . . . . . 157 2.6.6.7 Notas Alpha-DEC-OSF1. . . . . . . . . . . . . . 158 2.6.6.8 Notas SGI Irix . . . . . . . . . . . . . . . . . . . . . . . 159 2.6.6.9 Notas SCO . . . . . . . . . . . . . . . . . . . . . . . . . . 160 2.6.6.10 Notas SCO Unixware Version 7.0. . . . . 163 2.6.7 Notas OS/2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 2.6.8 Notas Novell NetWare . . . . . . . . . . . . . . . . . . . . . . . . 164 2.6.9 Notas BeOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Comentrios de Instalao do Perl . . . . . . . . . . . . . . . . . . . . . . 164 a ca 2.7.1 Instalando Perl no Unix . . . . . . . . . . . . . . . . . . . . . . . 164 2.7.2 Instalaando ActiveState Perl no Windows . . . . . . 165 2.7.3 Problemas Usando a Interface Perl DBI/DBD . . . . 166

2.7

Tutorial de Introduo Do MySQL . . . . . . . 168 ca

3.1 Conectando e Desconectando do Servidor . . . . . . . . . . . . . . . 168 3.2 Fazendo Consultas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 3.3 Criao e Utilizao de um Banco de Dados . . . . . . . . . . . . . 172 ca ca 3.3.1 Criando e Selecionando um Banco de Dados . . . . 173 3.3.2 Criando uma Tabela . . . . . . . . . . . . . . . . . . . . . . . . . . 174 3.3.3 Carregando dados em uma tabela . . . . . . . . . . . . . . 175 3.3.4 Recuperando Informaes de uma Tabela . . . . . . . 177 co 3.3.4.1 Selecionando Todos os Dados . . . . . . . . . 177 3.3.4.2 Selecionando Registros Espec icos . . . . . 178 3.3.4.3 Selecionando Colunas Espec icas . . . . . . 179 3.3.4.4 Ordenando Registros . . . . . . . . . . . . . . . . . 180 3.3.4.5 Clculo de Datas. . . . . . . . . . . . . . . . . . . . . 182 a 3.3.4.6 Trabalhando com Valores Nulos (NULL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 3.3.4.7 Combinao de padres. . . . . . . . . . . . . . . 185 ca o 3.3.4.8 Contando Registros . . . . . . . . . . . . . . . . . . 188 3.3.4.9 Utilizando Mltiplas Tabelas . . . . . . . . . . 190 u 3.4 Obtendo Informaes Sobre Bancos de Dados e Tabelas . . 192 co 3.5 Utilizando mysql em Modo Batch . . . . . . . . . . . . . . . . . . . . . . 193 3.6 Exemplos de Consultas Comuns . . . . . . . . . . . . . . . . . . . . . . . . 195 3.6.1 O Valor Mximo para uma Coluna . . . . . . . . . . . . . 195 a 3.6.2 O Registro que Armazena o Valor Mximo para uma a Coluna Determinada . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 3.6.3 Mximo da Coluna por Grupo . . . . . . . . . . . . . . . . . 196 a 3.6.4 As Linhas Armazenando o Group-wise Mximo de a um Certo Campo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 3.6.5 Utilizando Variveis de Usurio . . . . . . . . . . . . . . . . 198 a a

vi 3.6.6 Utilizando Chaves Estrangeiras . . . . . . . . . . . . . . . . 198 3.6.7 Pesquisando em Duas Chaves . . . . . . . . . . . . . . . . . . 200 3.6.8 Calculando Visitas Dirias . . . . . . . . . . . . . . . . . . . . 200 a 3.6.9 Usando AUTO_INCREMENT . . . . . . . . . . . . . . . . . . . . . . 201 3.7 Consultas de Projetos Gmeos . . . . . . . . . . . . . . . . . . . . . . . . . 202 e 3.7.1 Encontrando Todos Gmeos No-distribu e a idos . . . 203 3.7.2 Mostrando uma Tabela sobre a Situao dos Pares ca Gmeos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 e 3.8 Utilizando MySQL com Apache . . . . . . . . . . . . . . . . . . . . . . . . 206

Administrao do Bancos de Dados MySQL ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

4.1 Congurando o MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 4.1.1 Opes de Linha de Comando do mysqld . . . . . . . 207 co 4.1.2 Arquivo de Opes my.cnf . . . . . . . . . . . . . . . . . . . 216 co 4.2 Executando Mltiplos MySQL Servers na Mesma Mquina u a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 4.2.1 Executando Mltiplos Servidores no Windows . . 220 u 4.2.1.1 Iniciando Mltiplos Servidores na Linha de u Comando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 4.2.1.2 Iniciando Mltiplos Servidores Como u Servios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 c 4.2.2 Executando Mltiplos Servidores no Unix . . . . . . 224 u 4.2.3 Usando Programas Clientes em um Ambiente Multi-Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 4.3 Detalhes Gerais de Segurana e o Sistema de Privilgio de c e Acesso do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 4.3.1 Segurana Geral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 c 4.3.2 Como Tornar o MySQL Seguro contra Crackers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 4.3.3 Opes de Inicializao para o mysqld em Relao a co ca ca Segurana. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 c 4.3.4 Detalhes de Segurana com LOAD DATA LOCAL . . . 231 c 4.3.5 O Que o Sistema de Privilgios Faz . . . . . . . . . . . . 232 e 4.3.6 Como o Sistema de Privilgios Funciona . . . . . . . . 232 e 4.3.7 Privilgios Fornecidos pelo MySQL . . . . . . . . . . . . 236 e 4.3.8 Conectando ao Servidor MySQL . . . . . . . . . . . . . . . 238 4.3.9 Controle de Acesso, Estgio 1: Vericao da a ca Conexo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 a 4.3.10 Controle de Acesso, Estgio 2: Vericao da a ca Requisio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 ca 4.3.11 Hashing de Senhas no MySQL 4.1 . . . . . . . . . . . . 245 4.3.12 Causas dos Erros de Accesso Negado . . . . . . . . . 249 4.4 Gerenciamento das Contas dos Usurios no MySQL . . . . . . 254 a 4.4.1 A Sintaxe de GRANT e REVOKE . . . . . . . . . . . . . . . . . . 254 4.4.2 Nomes de Usurios e Senhas do MySQL . . . . . . . . 259 a 4.4.3 Quando as Alteraes nos Privilgios tem Efeito co e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

vii Congurando os Privilgios Iniciais do MySQL . . 260 e Adicionando Novos Usurios ao MySQL . . . . . . . . 261 a Deletando Usurios do MySQL . . . . . . . . . . . . . . . . 264 a Limitando os Recursos dos Usurios. . . . . . . . . . . . 265 a Congurando Senhas . . . . . . . . . . . . . . . . . . . . . . . . . 266 Mantendo Sua Senha Segura . . . . . . . . . . . . . . . . . . 267 Usando Conexes Seguras . . . . . . . . . . . . . . . . . . . . 268 o 4.4.10.1 Conceitos Basicos . . . . . . . . . . . . . . . . . . . 268 4.4.10.2 Exigncias . . . . . . . . . . . . . . . . . . . . . . . . . . 268 e 4.4.10.3 Congurando Certicados SSL para o MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 4.4.10.4 Opes SSL do GRANT . . . . . . . . . . . . . . . 273 co 4.4.10.5 Opes SSL de Linha de Comando . . . 274 co 4.5 Preveno de Disastres e Recuperao . . . . . . . . . . . . . . . . . . 275 ca ca 4.5.1 Backups dos Bancos de Dados . . . . . . . . . . . . . . . . . 275 4.5.2 Sintaxe de BACKUP TABLE . . . . . . . . . . . . . . . . . . . . . . 277 4.5.3 Sintaxe de RESTORE TABLE . . . . . . . . . . . . . . . . . . . . . 277 4.5.4 Sintaxe de CHECK TABLE . . . . . . . . . . . . . . . . . . . . . . . 278 4.5.5 Sintaxe do REPAIR TABLE . . . . . . . . . . . . . . . . . . . . . . 279 4.5.6 Utilizando myisamchk para Manuteno de Tabelas e ca Recuperao em Caso de Falhas. . . . . . . . . . . . . . . . . . 280 ca 4.5.6.1 Sintaxe do myisamchk . . . . . . . . . . . . . . . . 281 4.5.6.2 Opes Gerais do myisamchk . . . . . . . . . . 282 co 4.5.6.3 Opes de Vericao do myisamchk . . . 283 co ca 4.5.6.4 Opes de Reparos do myisamchk . . . . . 284 co 4.5.6.5 Outras Opes do myisamchk . . . . . . . . . 286 co 4.5.6.6 Uso de Memria do myisamchk . . . . . . . . 286 o 4.5.6.7 Uso do myisamchk para Recuperao em ca Caso de Falhas . . . . . . . . . . . . . . . . . . . . . . . . . . 287 4.5.6.8 Como Vericar Erros em Tabelas . . . . . . 288 4.5.6.9 Como Reparar Tabelas . . . . . . . . . . . . . . . 289 4.5.6.10 Otimizao de Tabelas . . . . . . . . . . . . . . 291 ca 4.5.7 Congurando um Regime de Manuteno das ca Tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 4.5.8 Obtendo Informaes sobre as Tabelas . . . . . . . . . 292 co 4.6 Adiministrao do Banco de Dados e Referncia de Linguagem ca e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 4.6.1 Sintaxe de OPTIMIZE TABLE. . . . . . . . . . . . . . . . . . . . 298 4.6.2 Sintaxe de ANALYZE TABLE . . . . . . . . . . . . . . . . . . . . . 298 4.6.3 Sintaxe de CHECKSUM TABLE. . . . . . . . . . . . . . . . . . . . 299 4.6.4 Sintaxe de FLUSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 4.6.5 Sintaxe de RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 4.6.6 Sintaxe de PURGE MASTER LOGS . . . . . . . . . . . . . . . . . 301 4.6.7 Sintaxe de KILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 4.6.8 Sintaxe de SHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 4.6.8.1 Recuperando Informaes sobre Bancos de co Dados, Tabelas, Colunas e Indices . . . . . . . . . 303 4.6.8.2 SHOW TABLE STATUS . . . . . . . . . . . . . . . . . . 304 4.4.4 4.4.5 4.4.6 4.4.7 4.4.8 4.4.9 4.4.10

viii 4.6.8.3 SHOW STATUS . . . . . . . . . . . . . . . . . . . . . . . . . 305 4.6.8.4 SHOW VARIABLES . . . . . . . . . . . . . . . . . . . . . 308 4.6.8.5 SHOW [BDB] LOGS . . . . . . . . . . . . . . . . . . . . . 320 4.6.8.6 SHOW PROCESSLIST . . . . . . . . . . . . . . . . . . . 320 4.6.8.7 SHOW GRANTS . . . . . . . . . . . . . . . . . . . . . . . . . 322 4.6.8.8 SHOW CREATE TABLE . . . . . . . . . . . . . . . . . . 322 4.6.8.9 SHOW WARNINGS | ERRORS . . . . . . . . . . . . . 322 4.6.8.10 SHOW TABLE TYPES . . . . . . . . . . . . . . . . . . 324 4.6.8.11 SHOW PRIVILEGES . . . . . . . . . . . . . . . . . . . 325 4.7 Localizao do MySQL e Utilizao Internacional . . . . . . . . 325 ca ca 4.7.1 O Conjunto de Caracteres Utilizado para Dados e Ordenao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 ca 4.7.1.1 German character set . . . . . . . . . . . . . . . . 326 4.7.2 Mensagens de Erros em Outras L inguas . . . . . . . . 327 4.7.3 Adicionando um Novo Conjunto de Caracteres . . 327 4.7.4 Os Vetores de Denies de Caracteres . . . . . . . . . 329 co 4.7.5 Suporte ` Ordenao de Strings . . . . . . . . . . . . . . . 329 a ca 4.7.6 Suporte ` Caracteres Multi-byte . . . . . . . . . . . . . . . 330 a 4.7.7 Problemas com Conjuntos de Caracteres . . . . . . . 330 4.8 Utilitrios e Scripts do Lado do Servidor MySQL . . . . . . . . 330 a 4.8.1 Viso Geral dos Scripts e Utilitrios do Lado a a Servidor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 4.8.2 mysqld-safe, o wrapper do mysqld . . . . . . . . . . . . 331 4.8.3 mysqld_multi, programa para gerenciar mltiplos u servidores MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 4.8.4 myisampack, O Gerador de Tabelas Compactadas de Somente Leitura do MySQL . . . . . . . . . . . . . . . . . . . . . 336 4.8.5 mysqld-max, om servidor mysqld extendido . . . . . 343 4.9 Utilitrios e Scripts do Lado do Cliente MySQL . . . . . . . . . 345 a 4.9.1 Viso Geral dos Utilitrios e Scripts do Lado do a a Cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 4.9.2 mysql, A Ferramenta de Linha de Comando . . . . 346 4.9.3 mysqlcc, The MySQL Control Center . . . . . . . . . . 354 4.9.4 mysqladmin, Administrando um Servidor MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 4.9.5 mysqlbinlog, Executando as Consultas a Partir de um Log Binrio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 a 4.9.6 Usando mysqlcheck para Manuteno de Tabelas e ca Recuperao em Caso de Falhas. . . . . . . . . . . . . . . . . . 359 ca 4.9.7 mysqldump, Descarregando a Estrutura de Tabelas e Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 4.9.8 mysqlhotcopy, Copiando Bancos de Dados e Tabelas do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 4.9.9 mysqlimport, Importando Dados de Arquivos Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 4.9.10 mysqlshow, Exibindo Bancos de Dados, Tabelas e Colunas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

ix 4.9.11 mysql_config, Opes para compilao do cliente co ca MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 4.9.12 perror, Explicando Cdigos de Erros . . . . . . . . . 371 o 4.9.13 Como Executar Comandos SQL a Partir de um Arquivo Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Os Arquivos de Log do MySQL . . . . . . . . . . . . . . . . . . . . . . . 372 4.10.1 O Log de Erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 4.10.2 O Log de Consultas. . . . . . . . . . . . . . . . . . . . . . . . . . 373 4.10.3 O Log de Atualizaes . . . . . . . . . . . . . . . . . . . . . . . 373 co 4.10.4 O Log Binrio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 a 4.10.5 O Log para Consultas Lentas . . . . . . . . . . . . . . . . . 377 4.10.6 Manuteno do Log de Arquivo . . . . . . . . . . . . . . . 377 ca Replicao no MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 ca 4.11.1 Introduo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 ca 4.11.2 Viso Geral da Implementao da Replicao . . 379 a ca ca 4.11.3 Detalhes de Implementao da Replicao . . . . . 380 ca ca 4.11.4 Como Congurar a Replicao . . . . . . . . . . . . . . . . 385 ca 4.11.5 Recursos de Replicao e Problemas Conhecidos ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 4.11.6 Opes de Inicializao da Replicao . . . . . . . . . 392 co ca ca 4.11.7 Instrues SQL para Controle do Servidor Master co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 4.11.7.1 PURGE MASTER LOGS . . . . . . . . . . . . . . . . . 400 4.11.7.2 RESET MASTER . . . . . . . . . . . . . . . . . . . . . . 401 4.11.7.3 SET SQL_LOG_BIN . . . . . . . . . . . . . . . . . . . 401 4.11.7.4 SHOW BINLOG EVENTS . . . . . . . . . . . . . . . . 401 4.11.7.5 SHOW MASTER STATUS . . . . . . . . . . . . . . . . 401 4.11.7.6 SHOW MASTER LOGS . . . . . . . . . . . . . . . . . . 401 4.11.7.7 SHOW SLAVE HOSTS . . . . . . . . . . . . . . . . . . 401 4.11.8 Instrues SQL para Controle do Servidor Slave co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 4.11.8.1 CHANGE MASTER TO . . . . . . . . . . . . . . . . . . 402 4.11.8.2 LOAD DATA FROM MASTER . . . . . . . . . . . . . 404 4.11.8.3 LOAD TABLE tbl_name FROM MASTER. . . 405 4.11.8.4 MASTER_POS_WAIT() . . . . . . . . . . . . . . . . 405 4.11.8.5 RESET SLAVE. . . . . . . . . . . . . . . . . . . . . . . . 405 4.11.8.6 SET GLOBAL SQL_SLAVE_SKIP_COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 4.11.8.7 SHOW SLAVE STATUS . . . . . . . . . . . . . . . . . 406 4.11.8.8 START SLAVE. . . . . . . . . . . . . . . . . . . . . . . . 409 4.11.8.9 STOP SLAVE . . . . . . . . . . . . . . . . . . . . . . . . . 410 4.11.9 FAQ da Replicao . . . . . . . . . . . . . . . . . . . . . . . . . . 410 ca 4.11.10 Problemas com Replicao . . . . . . . . . . . . . . . . . . 416 ca 4.11.11 Relatando Problemas de Replicao . . . . . . . . . . 417 ca

4.10

4.11

Otimizao do MySQL . . . . . . . . . . . . . . . . . . . 418 ca

5.1 Viso Geral da Otimizao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 a ca 5.1.1 Limitaes do Projeto MySQL/Trocas . . . . . . . . . 418 co 5.1.2 Portabilidade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 5.1.3 Para que Utilizamos o MySQL?. . . . . . . . . . . . . . . . 420 5.1.4 O Pacote de Benchmark do MySQL . . . . . . . . . . . . 421 5.1.5 Utilizando seus Prprios Benchmarks . . . . . . . . . . 422 o Otimizando SELECTs e Outras Consultas . . . . . . . . . . . . . . . . 423 5.2.1 Sintaxe de EXPLAIN (Obter informaes sobre uma co SELECT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 5.2.2 Estimando o Desempenho de uma Consulta. . . . . 431 5.2.3 Velocidade das Consultas que Utilizam SELECT . . 431 5.2.4 Como o MySQL Otimiza Clusulas WHERE . . . . . . 432 a 5.2.5 Como o MySQL Otimiza IS NULL . . . . . . . . . . . . . . 433 5.2.6 Como o MySQL Otimiza Clusulas DISTINCT . . . 434 a 5.2.7 Como o MySQL Otimiza LEFT JOIN e RIGHT JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 5.2.8 Como o MySQL Otimiza Clusulas ORDER BY . . . 436 a 5.2.9 Como o MySQL Otimiza Clusulas LIMIT . . . . . . 437 a 5.2.10 Performance das Consultas que Utilizam INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 5.2.11 Performance das Consultas que Utilizam UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 5.2.12 Performance das Consultas que Utilizam DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 5.2.13 Mais Dicas sobre Otimizaes . . . . . . . . . . . . . . . . 440 co Detalhes sobre Locks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 5.3.1 Como o MySQL Trava as Tabelas . . . . . . . . . . . . . . 443 5.3.2 Detalhes sobre Lock de Tabelas . . . . . . . . . . . . . . . . 444 Otimizando a Estrutura de Banco de Dados . . . . . . . . . . . . . 446 5.4.1 Opes do Projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 co 5.4.2 Deixando os Dados com o Menor Tamanho Poss ivel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 5.4.3 Como o MySQL Utiliza Indices . . . . . . . . . . . . . . . . 447 5.4.4 Indices de Colunas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 5.4.5 Indices de Mltiplas Colunas . . . . . . . . . . . . . . . . . . 450 u 5.4.6 Como o MySQL Conta as Tabelas Abertas . . . . . 451 5.4.7 Como o MySQL Abre e Fecha as Tabelas . . . . . . . 451 5.4.8 Desvantagem em Criar um Nmero Grande de u Tabelas no Mesmo Banco de Dados . . . . . . . . . . . . . . 452 Otimizando o Servidor MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 453 5.5.1 Sintonia dos Parmetros em Tempo de a Sistema/Compilao e na Inicializao. . . . . . . . . . . . 453 ca ca 5.5.2 Parmetros de Sintonia do Servidor . . . . . . . . . . . . 453 a 5.5.3 Como a Compilao e a Ligao Afetam a ca ca Velocidade do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . 456 5.5.4 Como o MySQL Utiliza a Memria . . . . . . . . . . . . 457 o 5.5.5 Como o MySQL Utiliza o DNS . . . . . . . . . . . . . . . . 459

5.2

5.3

5.4

5.5

xi 5.6 5.5.6 Sintaxe de SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 Detalhes de Disco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 5.6.1 Utilizando Links Simblicos . . . . . . . . . . . . . . . . . . . 465 o 5.6.1.1 Utilizando Links Simblicos para Bancos de o Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 5.6.1.2 Utilizando Links Simblicos para Tabelas o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 5.6.1.3 Usando Links Simblicos para Bancos de o Dados no Windows . . . . . . . . . . . . . . . . . . . . . . 467

Referncia de Linguagem do MySQL . . . . . . 469 e

6.1 Estrutura da Linguagem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 6.1.1 Literais: Como Gravar Strings e Numerais . . . . . . 469 6.1.1.1 Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 6.1.1.2 Nmeros . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 u 6.1.1.3 Valores Hexadecimais . . . . . . . . . . . . . . . . 471 6.1.1.4 Valores NULL. . . . . . . . . . . . . . . . . . . . . . . . . 471 6.1.2 Nomes de Banco de dados, Tabela, Indice, Coluna e Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 6.1.3 Caso Sensitivo nos Nomes . . . . . . . . . . . . . . . . . . . . . 473 6.1.4 Variveis de Usurio . . . . . . . . . . . . . . . . . . . . . . . . . . 474 a a 6.1.5 Variveis de Sistema . . . . . . . . . . . . . . . . . . . . . . . . . . 475 a 6.1.6 Sintaxe de Comentrios . . . . . . . . . . . . . . . . . . . . . . . 478 a 6.1.7 Tratamento de Palavras Reservadas no MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 6.2 Tipos de Campos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 6.2.1 Tipos Numricos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487 e 6.2.2 Tipos de Data e Hora . . . . . . . . . . . . . . . . . . . . . . . . . 489 6.2.2.1 Assuntos referentes ao ano 2000 (Y2K) e Tipos de Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 6.2.2.2 Os Tipos DATETIME, DATE e TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 6.2.2.3 O Tipo TIME. . . . . . . . . . . . . . . . . . . . . . . . . 495 6.2.2.4 O Tipo YEAR. . . . . . . . . . . . . . . . . . . . . . . . . 496 6.2.3 Tipos String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 6.2.3.1 Os Tipos CHAR e VARCHAR . . . . . . . . . . . . . 497 6.2.3.2 Os Tipos BLOB e TEXT . . . . . . . . . . . . . . . . 497 6.2.3.3 O Tipo ENUM. . . . . . . . . . . . . . . . . . . . . . . . . 499 6.2.3.4 O Tipo SET . . . . . . . . . . . . . . . . . . . . . . . . . . 500 6.2.4 Escolhendo o Tipo Correto para uma Coluna . . . 501 6.2.5 Usando Tipos de Colunas de Outros Mecanismos de Banco de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 6.2.6 Exigncias de Armazenamento dos Tipos de Coluna e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 6.3 Funes para Uso em Clusulas SELECT e WHERE . . . . . . . . . 503 co a 6.3.1 Operadores e Funes de Tipos no Especicados co a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 6.3.1.1 Parenteses . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

xii 6.3.1.2 Operadores de Comparao . . . . . . . . . . . 504 ca 6.3.1.3 Operadores Logicos . . . . . . . . . . . . . . . . . . 508 6.3.1.4 Funes de Fluxo de Controle . . . . . . . . . 510 co 6.3.2 Funes String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511 co 6.3.2.1 Funes de Comparao de Strings . . . . 519 co ca 6.3.2.2 Caso Sensitivo . . . . . . . . . . . . . . . . . . . . . . . 521 6.3.3 Funes Numricas . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 co e 6.3.3.1 Operaes Aritimticas . . . . . . . . . . . . . . . 522 co e 6.3.3.2 Funes Matematicas. . . . . . . . . . . . . . . . . 523 co 6.3.4 Funes de Data e Hora . . . . . . . . . . . . . . . . . . . . . . . 529 co 6.3.5 Funes de Converso . . . . . . . . . . . . . . . . . . . . . . . . . 543 co a 6.3.6 Outras Funes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 co 6.3.6.1 Funes Binrias . . . . . . . . . . . . . . . . . . . . . 546 co a 6.3.6.2 Funes Diversas . . . . . . . . . . . . . . . . . . . . . 546 co 6.3.7 Funes e Modicadores para Usar com Clusulas co a GROUP BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555 6.3.7.1 Funes GROUP BY . . . . . . . . . . . . . . . . . . . . 555 co 6.3.7.2 Modicadores GROUP BY . . . . . . . . . . . . . . 558 6.3.7.3 GROUP BY com Campos Escondidos . . . . 561 6.4 Manipulao de Dados: SELECT, INSERT, UPDATE e DELETE ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 6.4.1 Sintaxe SELECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 6.4.1.1 Sintaxe JOIN . . . . . . . . . . . . . . . . . . . . . . . . 567 6.4.1.2 Sintaxe UNION . . . . . . . . . . . . . . . . . . . . . . . 569 6.4.2 Sintaxe de Subquery . . . . . . . . . . . . . . . . . . . . . . . . . . 569 6.4.2.1 A Subquery como um Operando Escalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 6.4.2.2 Comparaes Usando Subquery . . . . . . . 571 co 6.4.2.3 Subqueries with ANY, IN, and SOME . . . . 572 6.4.2.4 Subqueries with ALL. . . . . . . . . . . . . . . . . . 572 6.4.2.5 Correlated Subqueries . . . . . . . . . . . . . . . . 573 6.4.2.6 EXISTS and NOT EXISTS . . . . . . . . . . . . . . 573 6.4.2.7 Row Subqueries . . . . . . . . . . . . . . . . . . . . . . 574 6.4.2.8 Subqueries in the FROM clause . . . . . . . . . 574 6.4.2.9 Subquery Errors . . . . . . . . . . . . . . . . . . . . . 575 6.4.2.10 Optimizing Subqueries . . . . . . . . . . . . . . 576 6.4.2.11 Rewriting Subqueries for Earlier MySQL Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578 6.4.3 Sintaxe INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 6.4.3.1 Sintaxe INSERT ... SELECT . . . . . . . . . . . 581 6.4.3.2 Sintaxe INSERT DELAYED . . . . . . . . . . . . . . 582 6.4.4 Sintaxe UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584 6.4.5 Sintaxe DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 6.4.6 Sintaxe TRUNCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 6.4.7 Sintaxe REPLACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 6.4.8 Sintaxe LOAD DATA INFILE. . . . . . . . . . . . . . . . . . . . . 588 6.4.9 Sintaxe HANDLER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595 6.4.10 Sintaxe DO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

xiii 6.5 Denio de Dados: CREATE, DROP e ALTER . . . . . . . . . . . . . . 597 ca 6.5.1 Sintaxe CREATE DATABASE . . . . . . . . . . . . . . . . . . . . . 597 6.5.2 Sintaxe DROP DATABASE . . . . . . . . . . . . . . . . . . . . . . . 597 6.5.3 Sintaxe CREATE TABLE . . . . . . . . . . . . . . . . . . . . . . . . . 598 6.5.3.1 Alterao de Especicaes de Colunas ca co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 6.5.4 Sintaxe ALTER TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . 608 6.5.5 Sintaxe RENAME TABLE . . . . . . . . . . . . . . . . . . . . . . . . . 612 6.5.6 Sintaxe DROP TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 6.5.7 Sintaxe CREATE INDEX . . . . . . . . . . . . . . . . . . . . . . . . . 613 6.5.8 Sintaxe DROP INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 Comandos Utilitrios Bsicos do Usurio MySQL . . . . . . . . 614 a a a 6.6.1 Sintaxe USE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 6.6.2 Sintaxe DESCRIBE (Obtem Informaes Sobre co Colunas) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 Comandos Transacionais e de Lock do MySQL . . . . . . . . . . 615 6.7.1 Sintaxe de START TRANSACTION, COMMIT e ROLLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 6.7.2 Instrues que No Podem Ser Desfeitas . . . . . . . . 615 co a 6.7.3 Instrues que Fazem um Commit Implicito . . . . 616 co 6.7.4 Sintaxe de SAVEPOINT e ROLLBACK TO SAVEPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616 6.7.5 Sintaxe LOCK TABLES e UNLOCK TABLES . . . . . . . . . 617 6.7.6 Sintaxe SET TRANSACTION . . . . . . . . . . . . . . . . . . . . . 619 Pesquisa Full-text no MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . 619 6.8.1 Restries Full-text . . . . . . . . . . . . . . . . . . . . . . . . . . . 623 co 6.8.2 Ajuste Fino de Pesquisas Full-text no MySQL . . 624 6.8.3 TODO de Pesquisas Full-text . . . . . . . . . . . . . . . . . . 625 Cache de Consultas do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 625 6.9.1 Como a Cache de Consultas Opera. . . . . . . . . . . . . 626 6.9.2 Congurao da Cache de Consultas . . . . . . . . . . . 627 ca 6.9.3 Opes da Cache de Consultas na SELECT . . . . . . 628 co 6.9.4 Estado e Manuteno da Cache de Consultas . . . 628 ca

6.6

6.7

6.8

6.9

Tipos de Tabela do MySQL . . . . . . . . . . . . . . 630

7.1 Tabelas MyISAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630 7.1.1 Espao Necessrio para Chaves . . . . . . . . . . . . . . . . 633 c a 7.1.2 Formatos de Tabelas MyISAM . . . . . . . . . . . . . . . . . . 634 7.1.2.1 Caracter isticas de Tabelas Estticas a (Tamanho Fixo) . . . . . . . . . . . . . . . . . . . . . . . . . 634 7.1.2.2 Caracter isticas de Tabelas Dinmicas . . 634 a 7.1.2.3 Caracter isticas de Tabelas Compactadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635 7.1.3 Problemas com Tabelas MyISAM . . . . . . . . . . . . . . . . 636 7.1.3.1 Tabelas MyISAM Corrompidas . . . . . . . . . 636 7.1.3.2 O Cliente est usando a tabela ou no a a a fechou de forma apropriada . . . . . . . . . . . . . . . 637 Tabelas MERGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637

7.2

xiv 7.3 7.4 7.5 7.2.1 Tabelas Tabelas Tabelas 7.5.1 7.5.2 7.5.3 7.5.4 Problemas com Tabelas MERGE . . . . . . . . . . . . . . . . . 640 ISAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641 HEAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641 InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643 Viso Geral de Tabelas InnoDB. . . . . . . . . . . . . . . . 643 a InnoDB no MySQL Verso 3.23 . . . . . . . . . . . . . . . . 643 a Opes de Inicializao do InnoDB . . . . . . . . . . . . . 644 co ca Criando Tablespaces no InnoDB . . . . . . . . . . . . . . . 651 7.5.4.1 Se Alguma Coisa Der Errado Na Criao ca Do Banco de Dados . . . . . . . . . . . . . . . . . . . . . . 652 7.5.5 Criando Tabelas InnoDB . . . . . . . . . . . . . . . . . . . . . . 653 7.5.5.1 Convertendo Tabelas MyISAM para InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653 7.5.5.2 Restries FOREIGN KEY . . . . . . . . . . . . . . . 654 co 7.5.5.3 Multiplos tablespaces - colocando cada tabela em seu prprio arquivo .ibd . . . . . . . . 656 o 7.5.6 Adicionando e Removendo Arquivos de Dados e Log do InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 7.5.7 Fazendo Backup e Recuperando um Banco de Dados InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 7.5.7.1 Forando a recuperao . . . . . . . . . . . . . . 660 c ca 7.5.7.2 Ponto de Vericaao . . . . . . . . . . . . . . . . . 661 c 7.5.8 Movendo um Banco de Dados InnoDB para Outra Mquina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661 a 7.5.9 Modelo Transacional do InnoDB . . . . . . . . . . . . . . . 662 7.5.9.1 InnoDB e SET ... TRANSACTION ISOLATION LEVEL ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662 7.5.9.2 Leitura Consistente sem Lock . . . . . . . . . 663 7.5.9.3 Lock de Leitura SELECT ... FOR UPDATE e SELECT ... LOCK IN SHARE MODE . . . . . . . . . . 664 7.5.9.4 Lock da Chave Seguinte: Evitando Problemas com Fantasmas . . . . . . . . . . . . . . . . 665 7.5.9.5 Locks Denidos por Diferentes Instrues co SQL no InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . 665 7.5.9.6 Deteco de Deadlock e Rollback . . . . . . 666 ca 7.5.9.7 Um Exemplo de Como a Leitura Consistente Funciona no InnoDB . . . . . . . . . . 667 7.5.9.8 Como lidar com deadlocks? . . . . . . . . . . . 668 7.5.10 Dicas de Ajuste de Desempenho . . . . . . . . . . . . . . 669 7.5.10.1 SHOW INNODB STATUS e o Monitor InnoDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670 7.5.11 Implementao de Multi-versioning . . . . . . . . . . . 672 ca 7.5.12 Estrutura de Tabelas e Indices . . . . . . . . . . . . . . . . 673 7.5.12.1 Estrutura F isica do Indice . . . . . . . . . . . 674 7.5.12.2 Buer de Insero. . . . . . . . . . . . . . . . . . . 674 ca 7.5.12.3 Indices Hash Adaptativos . . . . . . . . . . . . 675 7.5.12.4 Estrutura dos Registros F isicos . . . . . . 675

xv 7.5.12.5 Como Funciona uma Coluna AUTO_INCREMENT no InnoDB . . . . . . . . . . . . . . 675 7.5.13 Gerenciamento do Espao de Arquivos e E/S de c Disco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676 7.5.13.1 E/S de Disco . . . . . . . . . . . . . . . . . . . . . . . 676 7.5.13.2 Gerenciamento do Espao de Arquivo c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677 7.5.13.3 Desfragmentando uma Tabela . . . . . . . . 678 7.5.14 Tratando Erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678 7.5.15 Restries em Tabelas InnoDB . . . . . . . . . . . . . . . 678 co 7.5.16 Histrico de Alteraes do InnoDB . . . . . . . . . . . . 680 o co 7.5.16.1 MySQL/InnoDB-4.1.1, December 4, 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 7.5.16.2 MySQL/InnoDB-4.0.16, October 22, 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 7.5.16.3 MySQL/InnoDB-3.23.58, September 15, 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 7.5.16.4 MySQL/InnoDB-4.0.15, September 10, 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 7.5.16.5 MySQL/InnoDB-4.0.14, Junho de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681 7.5.16.6 MySQL/InnoDB-3.23.57, June 20, 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682 7.5.16.7 MySQL/InnoDB-4.0.13, 20 de Maio de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682 7.5.16.8 MySQL/InnoDB-4.1.0, 03 de Abril de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683 7.5.16.9 MySQL/InnoDB-3.23.56, 17 de Maro de c 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683 7.5.16.10 MySQL/InnoDB-4.0.12, 18 Maro de c 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684 7.5.16.11 MySQL/InnoDB-4.0.11, 25 de Fevereiro de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684 7.5.16.12 MySQL/InnoDB-4.0.10, 04 de Fevereiro de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684 7.5.16.13 MySQL/InnoDB-3.23.55, 24 de Janeiro de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685 7.5.16.14 MySQL/InnoDB-4.0.9, 14 de Janeiro de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685 7.5.16.15 MySQL/InnoDB-4.0.8, 07 de Janeiro de 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686 7.5.16.16 MySQL/InnoDB-4.0.7, 26 de Dezembro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686 7.5.16.17 MySQL/InnoDB-4.0.6, 19 de Dezembro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686 7.5.16.18 MySQL/InnoDB-3.23.54, 12 de Dezembro de 2002 . . . . . . . . . . . . . . . . . . . . . . . 687

xvi 7.5.16.19 MySQL/InnoDB-4.0.5, 18 de Novembro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687 7.5.16.20 MySQL/InnoDB-3.23.53, 09 de Outubro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 7.5.16.21 MySQL/InnoDB-4.0.4, 02 de Outubro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689 7.5.16.22 MySQL/InnoDB-4.0.3, 28 de Agosto de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 7.5.16.23 MySQL/InnoDB-3.23.52, 16 de Agosto de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 7.5.16.24 MySQL/InnoDB-4.0.2, 10 de Julho de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692 7.5.16.25 MySQL/InnoDB-3.23.51, 12 de Junho de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692 7.5.16.26 MySQL/InnoDB-3.23.50, 23 de Abril de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692 7.5.16.27 MySQL/InnoDB-3.23.49, 17 de Fevereiro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 7.5.16.28 MySQL/InnoDB-3.23.48, 09 de Fevereiro de 2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 7.5.16.29 MySQL/InnoDB-3.23.47, 28 de Dezembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . 694 7.5.16.30 MySQL/InnoDB-4.0.1, 23 de Dezembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695 7.5.16.31 MySQL/InnoDB-3.23.46, 30 de Novembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . 695 7.5.16.32 MySQL/InnoDB-3.23.45, 23 de Novembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . 695 7.5.16.33 MySQL/InnoDB-3.23.44, 02 de Novembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . 696 7.5.16.34 MySQL/InnoDB-3.23.43, 04 de Outubro de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 7.5.16.35 MySQL/InnoDB-3.23.42, 09 de Setembro de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 7.5.16.36 MySQL/InnoDB-3.23.41, 13 de Agosto de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 7.5.16.37 MySQL/InnoDB-3.23.40, 16 de Julho de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 7.5.16.38 MySQL/InnoDB-3.23.39, 13 de Junho de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 7.5.16.39 MySQL/InnoDB-3.23.38, 12 de Maio de 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 7.5.17 Informaes de Contato do InnoDB . . . . . . . . . . . . 697 co Tabelas BDB ou BerkeleyDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 7.6.1 Viso Geral de Tabelas BDB. . . . . . . . . . . . . . . . . . . . 698 a 7.6.2 Instalando BDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 7.6.3 Opes de Inicializao do BDB . . . . . . . . . . . . . . . . . 699 co ca 7.6.4 Caracteristicas de Tabelas BDB: . . . . . . . . . . . . . . . . 700

7.6

xvii 7.6.5 Itens a serem corrigidos no BDB num futuro prximo: o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701 7.6.6 Sistemas operacionais suportados pelo BDB . . . . . . 701 7.6.7 Restries em Tabelas BDB . . . . . . . . . . . . . . . . . . . . 702 co 7.6.8 Erros Que Podem Ocorrer Usando Tabelas BDB . . 702

Introduo ao MaxDB . . . . . . . . . . . . . . . . . . . 704 ca

8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 Historia do MaxDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Licenciamento e Suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conceitos Bsicos do MaxDB . . . . . . . . . . . . . . . . . . . . . . . . . . a Diferenas de Recursos entre o MaxDB e o MySQL . . . . . . c Interoperability Features between MaxDB and MySQL . . . Links Relacionados ao MaxDB . . . . . . . . . . . . . . . . . . . . . . . . . Palavras Reservadas no MaxDB . . . . . . . . . . . . . . . . . . . . . . . . Funes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . co Tipos de Colunas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704 704 704 704 705 705 706 708 709

Conjunto de Caracteres Nacionais e Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

Conjuntos de Caracteres e Collations em Geral . . . . . . . . . . 710 Conjunto de Caracteres e Collations no MySQL . . . . . . . . . 711 Determinando o Conjunto de Caracteres e Collation Padres o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711 9.3.1 Conjunto de Caracteres e Collations do Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711 9.3.2 Conjunto de Caracteres e Collation de Banco de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712 9.3.3 O Conjunto de Caracteres e Collations de Tabela . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713 9.3.4 Conjunto de Caracteres e Collation de Colunas . . 713 9.3.5 Exemplos de Atribuies de Conjuntos de Caracteres co e Collation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714 9.3.6 Conjunto de Caracteres e Collation de Conexo a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715 9.3.7 Conjunto de Caracteres e Collation de Caracter de String Literal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716 9.3.8 Clusula COLLATE em Vrias Partes de uma Consulta a a SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717 9.3.9 Precedncia da Clusula COLLATE . . . . . . . . . . . . . . 717 e a 9.3.10 Operador BINARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718 9.3.11 Alguns Casos Especiais Onde a Determinao da ca Collation e Trabalhosa . . . . . . . . . . . . . . . . . . . . . . . . . . 718 9.3.12 Collations Devem Ser para o Conjunto de Caracteres Certo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 9.3.13 Um exemplo do Efeito da Collation . . . . . . . . . . . 719 9.4 Operaes Afetadas pelo Suporte a Conjunto de Caracteres co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 9.1 9.2 9.3

xviii 9.4.1 Strings de Resultados . . . . . . . . . . . . . . . . . . . . . . . . . 720 9.4.2 CONVERT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720 9.4.3 CAST() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720 9.4.4 SHOW CHARACTER SET . . . . . . . . . . . . . . . . . . . . . . . . . . 721 9.4.5 SHOW COLLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721 9.4.6 SHOW CREATE DATABASE . . . . . . . . . . . . . . . . . . . . . . . . 722 9.4.7 SHOW FULL COLUMNS . . . . . . . . . . . . . . . . . . . . . . . . . . . 722 9.5 Suporte Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722 9.6 UTF8 para Metdados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723 9.7 Compatibilidade com Outros SGBDs . . . . . . . . . . . . . . . . . . . 724 9.8 Novo Formato do Arquivo de Congurao do Conjunto de ca Caracteres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724 9.9 Conjunto de Caracteres Nacional . . . . . . . . . . . . . . . . . . . . . . . 724 9.10 Atualizando para o MySQL 4.0. . . . . . . . . . . . . . . . . . . . . . . . 725 9.10.1 Conjunto de Caracteres do MySQL e o Par/Conjunto de Caracter/Collation Correspondente do MySQL 4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726 9.11 Os conjuntos de Caracteres e Collations que o MySQL Suporta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726 9.11.1 O Conjunto de Caracteres Unicode. . . . . . . . . . . . 728 9.11.2 Conjunto de Caracteres para Plataformas Espec icas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728 9.11.3 Conjunto de Caracteres do Sul da Europa e Oriente Mdio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728 e 9.11.4 Os Conjuntos de Caracteres Asiticos . . . . . . . . . 728 a 9.11.5 Os Conjuntos de Caracteres Blticos . . . . . . . . . . 729 a 9.11.6 Os Conjuntos de Caracteres Cir ilicos . . . . . . . . . . 729 9.11.7 O Conjunto de Caracteres da Europa Central . . 730 9.11.8 Os Conjuntos de Caracteres da Europa Ocidental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

10

Extenses Espacias em MySQL . . . . . . . . . . 733 o

10.1 10.2 Introduo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ca O Modelo Geomtrico OpenGIS . . . . . . . . . . . . . . . . . . . . . . . a 10.2.1 A Hierarquia da Classe Geometry . . . . . . . . . . . . . 10.2.2 Classe Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.3 Classe Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.4 Classe Curve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.5 Classe LineString . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.6 Classe Surface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.7 Classe Polygon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.8 Classe GeometryCollection . . . . . . . . . . . . . . . . . 10.2.9 Classe MultiPoint . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.10 Classe MultiCurve . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.11 Classe MultiLineString (Multi Linhas) . . . . . 10.2.12 Classe MultiSurface (Multi Superf icies) . . . . . 10.2.13 Classe MultiPolygon (Multi Pol igonos) . . . . . . 10.3 Formatos de Dados Espaciais Suportados . . . . . . . . . . . . . . 733 733 734 735 736 736 737 737 737 738 738 738 739 739 739 740

xix 10.3.1 Formato Well-Known Text (WKT). . . . . . . . . . . . 740 10.3.2 Formato Well-Known Binary (WKB). . . . . . . . . . 741 10.4 Criando um Banco de Dados MySQL Habilitado Espacialmente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 10.4.1 Tipos de Dados Espaciais do MySQL . . . . . . . . . 742 10.4.2 Criando Valores Espaciais . . . . . . . . . . . . . . . . . . . . 742 10.4.2.1 Criando Valores Geometry Usando Funes WKT . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 co 10.4.2.2 Criando Valores Geometry Usando Funes WKB . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 co 10.4.2.3 Criando uma Valor de Geometira Usando Funes Espec co icas do MySQL . . . . . . . . . . . 744 10.4.3 Criando Colunas Espaciais . . . . . . . . . . . . . . . . . . . 745 10.4.4 Entrando com Dados em Colunas Espaciais . . . . 746 10.4.5 Buscando Dados Espaciais . . . . . . . . . . . . . . . . . . . 747 10.4.5.1 Buscando Dados Espaciais em um Formato Interno . . . . . . . . . . . . . . . . . . . . . . . . . 747 10.4.5.2 Buscando Dados Espaciais no Formato WKT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 10.4.5.3 Buscando Dados Espaciais no Formato WKB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 10.5 Analisando Informao Espacial . . . . . . . . . . . . . . . . . . . . . . . 747 ca 10.5.1 Funes Para Converter Geometrias Entre Formatos co Diferentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748 10.5.2 Funes de Anlise das Propriedades de Geometry co a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748 10.5.2.1 Funes de Anlise das Propriedades de co a Geometry em Geral . . . . . . . . . . . . . . . . . . . . . . 749 10.5.2.2 Funes de Anlise das Propriedades de co a Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 10.5.2.3 Funes de Anlise das Propriedades de co a LineString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 10.5.2.4 Funes de Anlise das Propriedades de co a MultiLineString . . . . . . . . . . . . . . . . . . . . . . . . 752 10.5.2.5 Funes de Anlise das Propriedades de co a Polygon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753 10.5.2.6 Funes de Anlise das Propriedades de co a MultiPolygon . . . . . . . . . . . . . . . . . . . . . . . . . . . 754 10.5.2.7 Funes de Anlise das Propriedades de co a GeometryCollection . . . . . . . . . . . . . . . . . . . . 754 10.5.3 Funes Que Criam Novas Geometrias de Outras co Existentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 10.5.3.1 Funes de Geometria Que Produzem co Novas Geometrias . . . . . . . . . . . . . . . . . . . . . . . . 755 10.5.3.2 Operadores Espaciais . . . . . . . . . . . . . . . . 755 10.5.4 Funes Para Testar Relaes Espaciais Entre co co Objetos Geomtricos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 e

xx 10.5.5 Relaes de Retngulo de Limite M co a inimo (Minimal Bounding Rectangles - MBR) em Geometrias . . . . . 756 10.5.6 Funes que Testam Relacionamentos Espaciais co Entre Geometrias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 Otimizando Anlises Espaciais . . . . . . . . . . . . . . . . . . . . . . . . 758 a 10.6.1 Criando Indices Espaciais . . . . . . . . . . . . . . . . . . . . 758 10.6.2 Usando Indice Espacial . . . . . . . . . . . . . . . . . . . . . . 759 Compatibilidade e Conformidade com o MySQL . . . . . . . . 761 10.7.1 Recursos GIS Que Ainda No Esto Implementados a a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761

10.6

10.7

11

Stored Procedures e Funes . . . . . . . . . . . . 763 co

11.1 Sintaxe de Stored Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . 763 11.1.1 Manuteno de Stored Procedures . . . . . . . . . . . . 764 ca 11.1.1.1 CREATE PROCEDURE e CREATE FUNCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764 11.1.1.2 ALTER PROCEDURE e ALTER FUNCTION . . 766 11.1.1.3 DROP PROCEDURE e DROP FUNCTION . . . . 766 11.1.1.4 SHOW CREATE PROCEDURE e SHOW CREATE FUNCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 11.1.2 SHOW PROCEDURE STATUS e SHOW FUNCTION STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 11.1.3 CALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 11.1.4 BEGIN ... END Compound Statement . . . . . . . . . 767 11.1.5 Instruo DECLARE . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 ca 11.1.6 Variables in Stored Procedures . . . . . . . . . . . . . . . 768 11.1.6.1 Varivel Local DECLARE . . . . . . . . . . . . . . 768 a 11.1.6.2 Instruo Varivel SET . . . . . . . . . . . . . . 768 ca a 11.1.6.3 Instruo SELECT ... INTO . . . . . . . . . . 768 ca 11.1.7 Condies e Handlers . . . . . . . . . . . . . . . . . . . . . . . . 768 co 11.1.7.1 DECLARE Conditions . . . . . . . . . . . . . . . . . 768 11.1.7.2 DECLARE Handlers . . . . . . . . . . . . . . . . . . . 769 11.1.8 Cursors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 11.1.8.1 Declaring Cursors . . . . . . . . . . . . . . . . . . . 771 11.1.8.2 Cursor OPEN Statement . . . . . . . . . . . . . . 771 11.1.8.3 Cursor FETCH Statement . . . . . . . . . . . . . 771 11.1.8.4 Cursor CLOSE Statement . . . . . . . . . . . . . 771 11.1.9 Flow Control Constructs . . . . . . . . . . . . . . . . . . . . . 771 11.1.9.1 IF Statement . . . . . . . . . . . . . . . . . . . . . . . 771 11.1.9.2 CASE Statement . . . . . . . . . . . . . . . . . . . . . 772 11.1.9.3 LOOP Statement . . . . . . . . . . . . . . . . . . . . . 772 11.1.9.4 LEAVE Statement . . . . . . . . . . . . . . . . . . . . 772 11.1.9.5 ITERATE Statement . . . . . . . . . . . . . . . . . 772 11.1.9.6 REPEAT Statement. . . . . . . . . . . . . . . . . . . 773 11.1.9.7 WHILE Statement . . . . . . . . . . . . . . . . . . . . 773

xxi

12

Ferramentas de Clientes e APIs do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775

12.1 API C do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.1.1 Tipos de Dados da API C . . . . . . . . . . . . . . . . . . . . 12.1.2 Viso Geral das Funo da API C . . . . . . . . . . . . a ca 12.1.3 Descrio das Funes da API C . . . . . . . . . . . . . . ca co 12.1.3.1 mysql_affected_rows() . . . . . . . . . . . . 12.1.3.2 mysql_change_user() . . . . . . . . . . . . . . 12.1.3.3 mysql_character_set_name(). . . . . . . 12.1.3.4 mysql_close() . . . . . . . . . . . . . . . . . . . . . 12.1.3.5 mysql_connect() . . . . . . . . . . . . . . . . . . . 12.1.3.6 mysql_create_db() . . . . . . . . . . . . . . . . 12.1.3.7 mysql_data_seek() . . . . . . . . . . . . . . . . 12.1.3.8 mysql_debug() . . . . . . . . . . . . . . . . . . . . . 12.1.3.9 mysql_drop_db() . . . . . . . . . . . . . . . . . . . 12.1.3.10 mysql_dump_debug_info() . . . . . . . . . 12.1.3.11 mysql_eof() . . . . . . . . . . . . . . . . . . . . . . 12.1.3.12 mysql_errno() . . . . . . . . . . . . . . . . . . . . 12.1.3.13 mysql_error() . . . . . . . . . . . . . . . . . . . . 12.1.3.14 mysql_escape_string() . . . . . . . . . . . 12.1.3.15 mysql_fetch_field() . . . . . . . . . . . . . 12.1.3.16 mysql_fetch_fields() . . . . . . . . . . . . 12.1.3.17 mysql_fetch_field_direct() . . . . . 12.1.3.18 mysql_fetch_lengths() . . . . . . . . . . . 12.1.3.19 mysql_fetch_row() . . . . . . . . . . . . . . . 12.1.3.20 mysql_field_count() . . . . . . . . . . . . . 12.1.3.21 mysql_field_seek() . . . . . . . . . . . . . . 12.1.3.22 mysql_field_tell() . . . . . . . . . . . . . . 12.1.3.23 mysql_free_result() . . . . . . . . . . . . . 12.1.3.24 mysql_get_client_info() . . . . . . . . . 12.1.3.25 mysql_get_client_version() . . . . . 12.1.3.26 mysql_get_host_info() . . . . . . . . . . . 12.1.3.27 mysql_get_proto_info() . . . . . . . . . . 12.1.3.28 mysql_get_server_info() . . . . . . . . . 12.1.3.29 mysql_get_server_version() . . . . . 12.1.3.30 mysql_info() . . . . . . . . . . . . . . . . . . . . . 12.1.3.31 mysql_init() . . . . . . . . . . . . . . . . . . . . . 12.1.3.32 mysql_insert_id() . . . . . . . . . . . . . . . 12.1.3.33 mysql_kill() . . . . . . . . . . . . . . . . . . . . . 12.1.3.34 mysql_list_dbs(). . . . . . . . . . . . . . . . . 12.1.3.35 mysql_list_fields() . . . . . . . . . . . . . 12.1.3.36 mysql_list_processes() . . . . . . . . . . 12.1.3.37 mysql_list_tables() . . . . . . . . . . . . . 12.1.3.38 mysql_num_fields() . . . . . . . . . . . . . . 12.1.3.39 mysql_num_rows(). . . . . . . . . . . . . . . . . 12.1.3.40 mysql_options() . . . . . . . . . . . . . . . . . . 12.1.3.41 mysql_ping() . . . . . . . . . . . . . . . . . . . . . 12.1.3.42 mysql_query() . . . . . . . . . . . . . . . . . . . . 775 775 778 783 783 784 785 786 786 787 787 788 788 789 790 791 792 792 793 793 794 795 796 797 798 799 799 799 800 800 801 801 801 802 803 803 804 804 805 806 806 807 808 809 811 812

xxii 12.1.3.43 mysql_real_connect() . . . . . . . . . . . . 812 12.1.3.44 mysql_real_escape_string() . . . . . 815 12.1.3.45 mysql_real_query() . . . . . . . . . . . . . . 816 12.1.3.46 mysql_reload() . . . . . . . . . . . . . . . . . . . 817 12.1.3.47 mysql_row_seek(). . . . . . . . . . . . . . . . . 818 12.1.3.48 mysql_row_tell(). . . . . . . . . . . . . . . . . 818 12.1.3.49 mysql_select_db() . . . . . . . . . . . . . . . 819 12.1.3.50 mysql_set_server_option(). . . . . . . 819 12.1.3.51 mysql_shutdown(). . . . . . . . . . . . . . . . . 820 12.1.3.52 mysql_sqlstate(). . . . . . . . . . . . . . . . . 820 12.1.3.53 mysql_ssl_set() . . . . . . . . . . . . . . . . . . 821 12.1.3.54 mysql_stat() . . . . . . . . . . . . . . . . . . . . . 821 12.1.3.55 mysql_store_result() . . . . . . . . . . . . 822 12.1.3.56 mysql_thread_id() . . . . . . . . . . . . . . . 823 12.1.3.57 mysql_use_result() . . . . . . . . . . . . . . 824 12.1.3.58 mysql_warning_count() . . . . . . . . . . . 825 12.1.3.59 mysql_commit() . . . . . . . . . . . . . . . . . . . 825 12.1.3.60 mysql_rollback(). . . . . . . . . . . . . . . . . 826 12.1.3.61 mysql_autocommit() . . . . . . . . . . . . . . 826 12.1.3.62 mysql_more_results() . . . . . . . . . . . . 826 12.1.3.63 mysql_next_result() . . . . . . . . . . . . . 827 12.1.4 Instrues Preparadas da API C . . . . . . . . . . . . . . 828 co 12.1.5 Tipos de Dados de Instruoes Preparadas da API C c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828 12.1.6 Viso Geral das Funes de Instrues Preparadas a co co da API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831 12.1.7 Descrio das Funes de Instruo Preparada da ca co ca API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833 12.1.7.1 mysql_prepare() . . . . . . . . . . . . . . . . . . . 833 12.1.7.2 mysql_param_count() . . . . . . . . . . . . . . 835 12.1.7.3 mysql_get_metadata() . . . . . . . . . . . . . 835 12.1.7.4 mysql_bind_param() . . . . . . . . . . . . . . . 836 12.1.7.5 mysql_execute() . . . . . . . . . . . . . . . . . . . 837 12.1.7.6 mysql_stmt_affected_rows(). . . . . . . 841 12.1.7.7 mysql_bind_result() . . . . . . . . . . . . . . 842 12.1.7.8 mysql_stmt_store_result() . . . . . . . . 843 12.1.7.9 mysql_stmt_data_seek() . . . . . . . . . . . 844 12.1.7.10 mysql_stmt_row_seek() . . . . . . . . . . . 844 12.1.7.11 mysql_stmt_row_tell() . . . . . . . . . . . 845 12.1.7.12 mysql_stmt_num_rows() . . . . . . . . . . . 845 12.1.7.13 mysql_fetch() . . . . . . . . . . . . . . . . . . . . 846 12.1.7.14 mysql_send_long_data() . . . . . . . . . . 851 12.1.7.15 mysql_stmt_close() . . . . . . . . . . . . . . 853 12.1.7.16 mysql_stmt_errno() . . . . . . . . . . . . . . 854 12.1.7.17 mysql_stmt_error() . . . . . . . . . . . . . . 854 12.1.7.18 mysql_stmt_sqlstate() . . . . . . . . . . . 855 12.1.8 Tratando a Execuo de Mltiplas Consultas na ca u API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

xxiii 12.1.9 Manipulando Valores de Data e Hora na API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856 12.1.10 Descrio das Funes de Threads da API C . . 858 ca co 12.1.10.1 my_init() . . . . . . . . . . . . . . . . . . . . . . . . 858 12.1.10.2 mysql_thread_init() . . . . . . . . . . . . . 858 12.1.10.3 mysql_thread_end() . . . . . . . . . . . . . . 858 12.1.10.4 mysql_thread_safe() . . . . . . . . . . . . . 859 12.1.11 Descrio das Funes do Servidor Embutido da ca co API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859 12.1.11.1 mysql_server_init() . . . . . . . . . . . . . 859 12.1.11.2 mysql_server_end() . . . . . . . . . . . . . . 860 12.1.12 Dvidas e problemas comuns ao utilzar a API C u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861 12.1.12.1 Porque Algumas Vezes mysql_store_result() Retorna NULL Aps o mysql_query() Returnar com Sucesso? . . . . 861 12.1.12.2 Que Resultados Posso Onbetr de uma Consulta? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861 12.1.12.3 Como Posso Obter a ID Unica para a Ultima Linha Inserida? . . . . . . . . . . . . . . . . . . . 861 12.1.12.4 Problemas com Ligao na API C . . . 862 ca 12.1.13 Construindo Programas Clientes . . . . . . . . . . . . . 862 12.1.14 Como Fazer um Cliente em Threads . . . . . . . . . 863 12.1.15 libmysqld, a Biblioteca do Servidor Embutido MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864 12.1.15.1 Viso Geral da Biblioteca do Servidor a MySQL Embutido . . . . . . . . . . . . . . . . . . . . . . . 864 12.1.15.2 Compilando Programas com libmysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865 12.1.15.3 Restries no Uso de um Servidor co MySQL Embutido . . . . . . . . . . . . . . . . . . . . . . . 865 12.1.15.4 Usando Arquivo de Opes com o co Servidor Embutido . . . . . . . . . . . . . . . . . . . . . . . 865 12.1.15.5 Itens a Fazer no Servidor Embutido (TODO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866 12.1.15.6 Um Exemplo Simples de Servidor Embutido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866 12.1.15.7 Licensiando o Servidor Embutido . . . 870 12.2 Suporte ODBC ao MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 12.2.1 Como Instalar o MyODBC . . . . . . . . . . . . . . . . . . . 870 12.2.2 Como Preencher os Vrios Campos no Programa de a Administrao do ODBC . . . . . . . . . . . . . . . . . . . . . . . . 871 ca 12.2.3 Parmetros de Conexo do MyODBC . . . . . . . . . 872 a a 12.2.4 Como Relatar Problemas com o MyODBC . . . . 873 12.2.5 Programas que Funcionam com MyODBC . . . . . 874 12.2.6 Como Obter o Valor de uma Coluna AUTO_INCREMENT no ODBC . . . . . . . . . . . . . . . . . . . . . . 878 12.2.7 Relatando Problemas com MyODBC . . . . . . . . . . 879

xxiv 12.3 Conectividade Java (JDBC) ao MySQL . . . . . . . . . . . . . . . . 12.4 API PHP do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.4.1 Problemas Comuns com MySQL e PHP . . . . . . . 12.5 API Perl do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.5.1 DBI com DBD::mysql . . . . . . . . . . . . . . . . . . . . . . . . 12.5.2 A interface DBI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.5.3 Mais Informaes DBI/DBD . . . . . . . . . . . . . . . . . . . co 12.6 API C++ do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.6.1 Borland C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.7 API Python do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.8 API Tcl do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.9 Eiel Wrapper do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 880 880 880 881 881 887 887 887 888 888 888

13 14

Tratamento de Erros no MySQL . . . . . . . . . 889

13.1 Erros Retornados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889

Estendendo o MySQL . . . . . . . . . . . . . . . . . . . 896

14.1 MySQL Internals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896 14.1.1 Threads MySQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896 14.1.2 Pacotes de Teste do MySQL . . . . . . . . . . . . . . . . . . 896 14.1.2.1 Executando o Pacote de Testes do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897 14.1.2.2 Extendendo o Pacote de Teste do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897 14.1.2.3 Relatando Bugs no Pacote de Teste do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898 14.2 Adicionando Novas Funes ao MySQL . . . . . . . . . . . . . . . . 899 co 14.2.1 Sintaxe CREATE FUNCTION/DROP FUNCTION . . . . . 900 14.2.2 Adicionando Novas Funes Denidas Por Usurio co a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900 14.2.2.1 Sequncia de Chamadas UDF para e Funes Simples . . . . . . . . . . . . . . . . . . . . . . . . . 902 co 14.2.2.2 Sequncia de Chamadas UDF para e Funes Agregadas . . . . . . . . . . . . . . . . . . . . . . . 903 co 14.2.2.3 Processando Argumentos . . . . . . . . . . . . 904 14.2.2.4 Valor de Retorno e Tartamento de Erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906 14.2.2.5 Compilando e Instalando Funes co Denidas Por Usurio . . . . . . . . . . . . . . . . . . . . 906 a 14.2.3 Adicionando uma Nova Funo Nativa . . . . . . . . 908 ca 14.3 Adicionado Novos Procedimentos ao MySQL . . . . . . . . . . . 909 14.3.1 Anlise de Procedimento . . . . . . . . . . . . . . . . . . . . . 909 a 14.3.2 Escrevendo um Procedimento. . . . . . . . . . . . . . . . . 910

xxv

Apndice A Problemas e Erros Comuns . . . . . 911 e

A.1 A.2 Como Determinar o Que Est Causando Problemas . . . . . 911 a Erros Comuns Usando o MySQL . . . . . . . . . . . . . . . . . . . . . . . 912 A.2.1 Erro: Access Denied . . . . . . . . . . . . . . . . . . . . . . . . . 912 A.2.2 Erro: MySQL server has gone away. . . . . . . . . . . . 912 A.2.3 Erro: Cant connect to [local] MySQL server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913 A.2.4 Erro: Client does not support authentication protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 915 A.2.5 Erro: Host ... is blocked . . . . . . . . . . . . . . . . . 916 A.2.6 Erro: Too many connections . . . . . . . . . . . . . . . . . 916 A.2.7 Erro: Some non-transactional changed tables couldnt be rolled back . . . . . . . . . . . . . . . . . . . . . . . 916 A.2.8 Erro: Out of memory . . . . . . . . . . . . . . . . . . . . . . . . . 917 A.2.9 Erro: Packet too large . . . . . . . . . . . . . . . . . . . . . . 917 A.2.10 Erros de Comunicao / Comunicao Abortada ca ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 918 A.2.11 Erro: The table is full . . . . . . . . . . . . . . . . . . . . 919 A.2.12 Erro: Cant create/write to file . . . . . . . . . . 919 A.2.13 Erro no Cliente: Commands out of sync . . . . . . . 920 A.2.14 Erro: Ignoring user . . . . . . . . . . . . . . . . . . . . . . . . 920 A.2.15 Erro: Table xxx doesnt exist . . . . . . . . . . . 920 A.2.16 Erro: Cant initialize character set xxx . . 921 A.2.17 Arquivo No Encontrado . . . . . . . . . . . . . . . . . . . . 921 a A.3 Assuntos Relacionados a Instalao . . . . . . . . . . . . . . . . . . . . 922 ca A.3.1 Problemas de Ligao com a Biblioteca do Cliente ca MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 A.3.2 Como Executar o MySQL Como Um Usurio a Normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923 A.3.3 Problemas com Permisses de Arquivos . . . . . . . . 924 o A.4 Assuntos Relacionados a Administrao . . . . . . . . . . . . . . . . 924 ca A.4.1 O Que Fazer Se o MySQL Continua Falhando . . 925 A.4.2 Como Recuperar uma Senha de Root Esquecida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927 A.4.3 Como o MySQL Trata de Discos Sem Espao . . 928 c A.4.4 Onde o MySQL Armazena Arquivos Temporrios a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928 A.4.5 Como Proteger ou AlterarHow to Protect or Change the MySQL Socket File /tmp/mysql.sock . . . . . . . 929 A.4.6 Problemas Com Fuso Horrio . . . . . . . . . . . . . . . . . 930 a A.5 Assuntos Relacionados a Consultas. . . . . . . . . . . . . . . . . . . . . 930 A.5.1 Caso-Sensitivito em Pesquisas . . . . . . . . . . . . . . . . . 930 A.5.2 Problemas Usando Colunas DATE . . . . . . . . . . . . . . 930 A.5.3 Problemas com Valores NULL . . . . . . . . . . . . . . . . . . 932 A.5.4 Problemas com alias . . . . . . . . . . . . . . . . . . . . . . . . 933 A.5.5 Deletando Linhas de Tabelas Relacionadas . . . . . 933 A.5.6 Resolvendo Problemas Com Registros No a Encontrados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934

xxvi A.5.7 Problemas com Comparao de Ponto Flutuante ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934 Assuntos Relacionados ao Otimizador . . . . . . . . . . . . . . . . . . 936 A.6.1 Camo evitar o varredura da tabela,,,. . . . . . . . . . . 937 Assuntos Relacionados a Denies de Tabelas . . . . . . . . . . 937 co A.7.1 Problemas com ALTER TABLE. . . . . . . . . . . . . . . . . . 937 A.7.2 Como Alterar a Ordem das Colunas em Uma Tabela . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938 A.7.3 Problemas com TEMPORARY TABLE . . . . . . . . 938

A.6 A.7

Apndice B Contribuio de Programas . . . . . 940 e ca

B.1 B.2 B.3 APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940 Conversores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 Utilitrios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944 a

Apndice C Colaboradores do MySQL . . . . . . 945 e

C.1 C.2 C.3 C.4 C.5 C.6 C.7 Desenvolvedores do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . Coolaboradores do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . Responsveis pela Documentao e Traduo . . . . . . . . . . . a ca ca Bibliotecas usadas e incluidas com o MySQL . . . . . . . . . . . . Pacotes que suportam o MySQL . . . . . . . . . . . . . . . . . . . . . . . Ferramentas que so usadas para criar o MySQL . . . . . . . . a Responsveis pelo Suporte do MySQL . . . . . . . . . . . . . . . . . . a 945 948 952 953 954 955 955

Apndice D Histrico de Alteraes do MySQL e o co . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957

D.1 Alteraes na distribuio 5.0.0 (Development). . . . . . . . . . 957 co ca D.2 Alteraes na distribuio 4.1.x (Alpha) . . . . . . . . . . . . . . . . 957 co ca D.2.1 Alteraes na distribuio 4.1.2 (not released yet) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958 D.2.2 Alteraes na distribuio 4.1.1 (01 de Dez de 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959 D.2.3 Alteraes na distribuio 4.1.0 (03 Apr 2003: co ca Alpha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963 D.3 Alteraes na distribuio 4.0.x (Production) . . . . . . . . . . . 965 co ca D.3.1 Alteraes na distribuio 4.0.17 (not released yet) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 966 D.3.2 Alteraes na distribuio 4.0.16 (17 Out 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 968 D.3.3 Alteraes na distribuio 4.0.15 (03 Sep 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970 D.3.4 Alteraes na distribuio 4.0.14 (18 Jul 2003) . . 974 co ca D.3.5 Alteraes na distribuio 4.0.13 (16 May 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978 D.3.6 Alteraes na distribuio 4.0.12 (15 Mar 2003: co ca Production) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 981

xxvii D.3.7 Alteraes na distribuio 4.0.11 (20 Feb 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983 D.3.8 Alteraes na distribuio 4.0.10 (29 Jan 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984 D.3.9 Alteraes na distribuio 4.0.9 (09 Jan 2003) . . 985 co ca D.3.10 Alteraes na distribuio 4.0.8 (07 Jan 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986 D.3.11 Alteraes na distribuio 4.0.7 (20 Dec 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986 D.3.12 Alteraes na distribuio 4.0.6 (14 Dec 2002: co ca Gamma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 987 D.3.13 Alteraes na distribuio 4.0.5 (13 Nov 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988 D.3.14 Alteraes na distribuio 4.0.4 (29 Sep 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 D.3.15 Alteraes na distribuio 4.0.3 (26 Aug 2002: co ca Beta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 992 D.3.16 Alteraes na distribuio 4.0.2 (01 Jul 2002) . . 994 co ca D.3.17 Alteraes na distribuio 4.0.1 (23 Dec 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 D.3.18 Alteraes na distribuio 4.0.0 (Oct 2001: Alpha) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998 D.4 Alteraes na distribuio 3.23.x (Recent; still supported) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000 D.4.1 Alteraes na distribuio 3.23.59 (not released yet) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000 D.4.2 Alteraes na distribuio 3.23.58 (11 Sep 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1001 D.4.3 Alteraes na distribuio 3.23.57 (06 Jun 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1001 D.4.4 Alteraes na distribuio 3.23.56 (13 Mar 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002 D.4.5 Alteraes na distribuio 3.23.55 (23 Jan 2003) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003 D.4.6 Alteraes na distribuio 3.23.54 (05 Dec 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 D.4.7 Alteraes na distribuio 3.23.53 (09 Oct 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1005 D.4.8 Alteraes na distribuio 3.23.52 (14 Aug 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 D.4.9 Alteraes na distribuio 3.23.51 (31 May 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 D.4.10 Alteraes na distribuio 3.23.50 (21 Apr 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1007 D.4.11 Alteraes na distribuio 3.23.49 . . . . . . . . . . . 1008 co ca D.4.12 Alteraes na distribuio 3.23.48 (07 Feb 2002) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008

xxviii D.4.13 Alteraes na distribuio 3.23.47 (27 Dec 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009 D.4.14 Alteraes na distribuio 3.23.46 (29 Nov 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009 D.4.15 Alteraes na distribuio 3.23.45 (22 Nov 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010 D.4.16 Alteraes na distribuio 3.23.44 (31 Oct 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010 D.4.17 Alteraes na distribuio 3.23.43 (04 Oct 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011 D.4.18 Alteraes na distribuio 3.23.42 (08 Sep 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012 D.4.19 Alteraes na distribuio 3.23.41 (11 Aug 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013 D.4.20 Alteraes na distribuio 3.23.40 . . . . . . . . . . . 1013 co ca D.4.21 Alteraes na distribuio 3.23.39 (12 Jun 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014 D.4.22 Alteraes na distribuio 3.23.38 (09 May 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014 D.4.23 Alteraes na distribuio 3.23.37 (17 Apr 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015 D.4.24 Alteraes na distribuio 3.23.36 (27 Mar 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1016 D.4.25 Alteraes na distribuio 3.23.35 (15 Mar 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1016 D.4.26 Alteraes na distribuio 3.23.34a . . . . . . . . . . 1017 co ca D.4.27 Alteraes na distribuio 3.23.34 (10 Mar 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017 D.4.28 Alteraes na distribuio 3.23.33 (09 Feb 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018 D.4.29 Alteraes na distribuio 3.23.32 (22 Jan 2001: co ca Production) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019 D.4.30 Alteraes na distribuio 3.23.31 (17 Jan 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019 D.4.31 Alteraes na distribuio 3.23.30 (04 Jan 2001) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1020 D.4.32 Alteraes na distribuio 3.23.29 (16 Dec 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1021 D.4.33 Alteraes na distribuio 3.23.28 (22 Nov 2000: co ca Gamma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1022 D.4.34 Alteraes na distribuio 3.23.27 (24 Oct 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024 D.4.35 Alteraes na distribuio 3.23.26 (18 Oct 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024 D.4.36 Alteraes na distribuio 3.23.25 (29 Sep 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1025 D.4.37 Alteraes na distribuio 3.23.24 (08 Sep 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026

xxix D.4.38 Alteraes na distribuio 3.23.23 (01 Sep 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 D.4.39 Alteraes na distribuio 3.23.22 (31 Jul 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028 D.4.40 Alteraes na distribuio 3.23.21 . . . . . . . . . . . 1028 co ca D.4.41 Alteraes na distribuio 3.23.20 . . . . . . . . . . . 1029 co ca D.4.42 Alteraes na distribuio 3.23.19 . . . . . . . . . . . 1029 co ca D.4.43 Alteraes na distribuio 3.23.18 . . . . . . . . . . . 1030 co ca D.4.44 Alteraes na distribuio 3.23.17 . . . . . . . . . . . 1030 co ca D.4.45 Alteraes na distribuio 3.23.16 . . . . . . . . . . . 1031 co ca D.4.46 Alteraes na distribuio 3.23.15 (May 2000: co ca Beta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031 D.4.47 Alteraes na distribuio 3.23.14 . . . . . . . . . . . 1032 co ca D.4.48 Alteraes na distribuio 3.23.13 . . . . . . . . . . . 1033 co ca D.4.49 Alteraes na distribuio 3.23.12 (07 Mar 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1033 D.4.50 Alteraes na distribuio 3.23.11 . . . . . . . . . . . 1034 co ca D.4.51 Alteraes na distribuio 3.23.10 . . . . . . . . . . . 1034 co ca D.4.52 Alteraes na distribuio 3.23.9 . . . . . . . . . . . . 1034 co ca D.4.53 Alteraes na distribuio 3.23.8 (02 Jan 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035 D.4.54 Alteraes na distribuio 3.23.7 (10 Dec 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036 D.4.55 Alteraes na distribuio 3.23.6 . . . . . . . . . . . . 1036 co ca D.4.56 Alteraes na distribuio 3.23.5 (20 Oct 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037 D.4.57 Alteraes na distribuio 3.23.4 (28 Sep 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038 D.4.58 Alteraes na distribuio 3.23.3 . . . . . . . . . . . . 1038 co ca D.4.59 Alteraes na distribuio 3.23.2 (09 Aug 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 D.4.60 Alteraes na distribuio 3.23.1 . . . . . . . . . . . . 1040 co ca D.4.61 Alteraes na distribuio 3.23.0 (05 Aug 1999: co ca Alpha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1040 D.5 Alteraes na distribuio 3.22.x (Old; discontinued) . . . 1042 co ca D.5.1 Alteraes na distribuio 3.22.35 . . . . . . . . . . . . 1042 co ca D.5.2 Alteraes na distribuio 3.22.34 . . . . . . . . . . . . 1042 co ca D.5.3 Alteraes na distribuio 3.22.33 . . . . . . . . . . . . 1042 co ca D.5.4 Alteraes na distribuio 3.22.32 (14 Feb 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042 D.5.5 Alteraes na distribuio 3.22.31 . . . . . . . . . . . . 1043 co ca D.5.6 Alteraes na distribuio 3.22.30 . . . . . . . . . . . . 1043 co ca D.5.7 Alteraes na distribuio 3.22.29 (02 Jan 2000) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043 D.5.8 Alteraes na distribuio 3.22.28 (20 Oct 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043 D.5.9 Alteraes na distribuio 3.22.27 . . . . . . . . . . . . 1043 co ca

xxx D.5.10 Alteraes na distribuio 3.22.26 (16 Sep 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044 D.5.11 Alteraes na distribuio 3.22.25 . . . . . . . . . . . 1044 co ca D.5.12 Alteraes na distribuio 3.22.24 (05 Jul 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044 D.5.13 Alteraes na distribuio 3.22.23 (08 Jun 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044 D.5.14 Alteraes na distribuio 3.22.22 (30 Apr 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045 D.5.15 Alteraes na distribuio 3.22.21 . . . . . . . . . . . 1045 co ca D.5.16 Alteraes na distribuio 3.22.20 (18 Mar 1999) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045 D.5.17 Alteraes na distribuio 3.22.19 (Mar 1999: co ca Production) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045 D.5.18 Alteraes na distribuio 3.22.18 . . . . . . . . . . . 1045 co ca D.5.19 Alteraes na distribuio 3.22.17 . . . . . . . . . . . 1046 co ca D.5.20 Alteraes na distribuio 3.22.16 (Feb 1999: co ca Gamma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1046 D.5.21 Alteraes na distribuio 3.22.15 . . . . . . . . . . . 1046 co ca D.5.22 Alteraes na distribuio 3.22.14 . . . . . . . . . . . 1047 co ca D.5.23 Alteraes na distribuio 3.22.13 . . . . . . . . . . . 1047 co ca D.5.24 Alteraes na distribuio 3.22.12 . . . . . . . . . . . 1047 co ca D.5.25 Alteraes na distribuio 3.22.11 . . . . . . . . . . . 1048 co ca D.5.26 Alteraes na distribuio 3.22.10 . . . . . . . . . . . 1048 co ca D.5.27 Alteraes na distribuio 3.22.9 . . . . . . . . . . . . 1049 co ca D.5.28 Alteraes na distribuio 3.22.8 . . . . . . . . . . . . 1049 co ca D.5.29 Alteraes na distribuio 3.22.7 (Sep 1998: Beta) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050 D.5.30 Alteraes na distribuio 3.22.6 . . . . . . . . . . . . 1050 co ca D.5.31 Alteraes na distribuio 3.22.5 . . . . . . . . . . . . 1051 co ca D.5.32 Alteraes na distribuio 3.22.4 . . . . . . . . . . . . 1052 co ca D.5.33 Alteraes na distribuio 3.22.3 . . . . . . . . . . . . 1053 co ca D.5.34 Alteraes na distribuio 3.22.2 . . . . . . . . . . . . 1053 co ca D.5.35 Alteraes na distribuio 3.22.1 (Jun 1998: Alpha) co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1054 D.5.36 Alteraes na distribuio 3.22.0 . . . . . . . . . . . . 1054 co ca D.6 Alteraes na distribuio 3.21.x . . . . . . . . . . . . . . . . . . . . . . 1056 co ca D.6.1 Alteraes na distribuio 3.21.33 . . . . . . . . . . . . 1056 co ca D.6.2 Alteraes na distribuio 3.21.32 . . . . . . . . . . . . 1056 co ca D.6.3 Alteraes na distribuio 3.21.31 . . . . . . . . . . . . 1056 co ca D.6.4 Alteraes na distribuio 3.21.30 . . . . . . . . . . . . 1057 co ca D.6.5 Alteraes na distribuio 3.21.29 . . . . . . . . . . . . 1057 co ca D.6.6 Alteraes na distribuio 3.21.28 . . . . . . . . . . . . 1057 co ca D.6.7 Alteraes na distribuio 3.21.27 . . . . . . . . . . . . 1058 co ca D.6.8 Alteraes na distribuio 3.21.26 . . . . . . . . . . . . 1058 co ca D.6.9 Alteraes na distribuio 3.21.25 . . . . . . . . . . . . 1058 co ca D.6.10 Alteraes na distribuio 3.21.24 . . . . . . . . . . . 1059 co ca D.6.11 Alteraes na distribuio 3.21.23 . . . . . . . . . . . 1059 co ca

xxxi D.6.12 Alteraes na distribuio 3.21.22 . . . . . . . . . . . co ca D.6.13 Alteraes na distribuio 3.21.21a . . . . . . . . . . co ca D.6.14 Alteraes na distribuio 3.21.21 . . . . . . . . . . . co ca D.6.15 Alteraes na distribuio 3.21.20 . . . . . . . . . . . co ca D.6.16 Alteraes na distribuio 3.21.19 . . . . . . . . . . . co ca D.6.17 Alteraes na distribuio 3.21.18 . . . . . . . . . . . co ca D.6.18 Alteraes na distribuio 3.21.17 . . . . . . . . . . . co ca D.6.19 Alteraes na distribuio 3.21.16 . . . . . . . . . . . co ca D.6.20 Alteraes na distribuio 3.21.15 . . . . . . . . . . . co ca D.6.21 Alteraes na distribuio 3.21.14b . . . . . . . . . . co ca D.6.22 Alteraes na distribuio 3.21.14a . . . . . . . . . . co ca D.6.23 Alteraes na distribuio 3.21.13 . . . . . . . . . . . co ca D.6.24 Alteraes na distribuio 3.21.12 . . . . . . . . . . . co ca D.6.25 Alteraes na distribuio 3.21.11 . . . . . . . . . . . co ca D.6.26 Alteraes na distribuio 3.21.10 . . . . . . . . . . . co ca D.6.27 Alteraes na distribuio 3.21.9 . . . . . . . . . . . . co ca D.6.28 Alteraes na distribuio 3.21.8 . . . . . . . . . . . . co ca D.6.29 Alteraes na distribuio 3.21.7 . . . . . . . . . . . . co ca D.6.30 Alteraes na distribuio 3.21.6 . . . . . . . . . . . . co ca D.6.31 Alteraes na distribuio 3.21.5 . . . . . . . . . . . . co ca D.6.32 Alteraes na distribuio 3.21.4 . . . . . . . . . . . . co ca D.6.33 Alteraes na distribuio 3.21.3 . . . . . . . . . . . . co ca D.6.34 Alteraes na distribuio 3.21.2 . . . . . . . . . . . . co ca D.6.35 Alteraes na distribuio 3.21.0 . . . . . . . . . . . . co ca D.7 Alteraes na distribuio 3.20.x . . . . . . . . . . . . . . . . . . . . . . co ca D.7.1 Alteraes na distribuio 3.20.18 . . . . . . . . . . . . co ca D.7.2 Alteraes na distribuio 3.20.17 . . . . . . . . . . . . co ca D.7.3 Alteraes na distribuio 3.20.16 . . . . . . . . . . . . co ca D.7.4 Alteraes na distribuio 3.20.15 . . . . . . . . . . . . co ca D.7.5 Alteraes na distribuio 3.20.14 . . . . . . . . . . . . co ca D.7.6 Alteraes na distribuio 3.20.13 . . . . . . . . . . . . co ca D.7.7 Alteraes na distribuio 3.20.11 . . . . . . . . . . . . co ca D.7.8 Alteraes na distribuio 3.20.10 . . . . . . . . . . . . co ca D.7.9 Alteraes na distribuio 3.20.9 . . . . . . . . . . . . . co ca D.7.10 Alteraes na distribuio 3.20.8 . . . . . . . . . . . . co ca D.7.11 Alteraes na distribuio 3.20.7 . . . . . . . . . . . . co ca D.7.12 Alteraes na distribuio 3.20.6 . . . . . . . . . . . . co ca D.7.13 Alteraes na distribuio 3.20.3 . . . . . . . . . . . . co ca D.7.14 Alteraes na distribuio 3.20.0 . . . . . . . . . . . . co ca D.8 Alteraes na distribuio 3.19.x . . . . . . . . . . . . . . . . . . . . . . co ca D.8.1 Alteraes na distribuio 3.19.5 . . . . . . . . . . . . . co ca D.8.2 Alteraes na distribuio 3.19.4 . . . . . . . . . . . . . co ca D.8.3 Alteraes na distribuio 3.19.3 . . . . . . . . . . . . . co ca 1059 1060 1060 1060 1061 1061 1061 1062 1062 1063 1063 1063 1064 1064 1065 1065 1065 1066 1066 1066 1067 1067 1068 1068 1069 1069 1070 1071 1071 1071 1072 1072 1073 1073 1073 1073 1074 1075 1076 1076 1076 1077 1077

xxxii

Apndice E Portando para Outros Sistemas e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1078

E.1 Depurando um Servidor MySQL . . . . . . . . . . . . . . . . . . . . . . 1079 E.1.1 Compilando o MYSQL para Depurao . . . . . . . 1079 ca E.1.2 Criando Arquivos Trace (Rastreamento) . . . . . . 1080 E.1.3 Depurando o mysqld no gdb . . . . . . . . . . . . . . . . . 1081 E.1.4 Usando Stack Trace . . . . . . . . . . . . . . . . . . . . . . . . . 1082 E.1.5 Usando Arquivos de Log para Encontrar a Causa dos Erros no mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083 E.1.6 Fazendo um Caso de Teste Se Ocorre um Corrompimento de Tabela . . . . . . . . . . . . . . . . . . . . . . 1084 Depurando um cliente MySQL. . . . . . . . . . . . . . . . . . . . . . . . 1085 O Pacote DBUG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085 Mtodos de Lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087 e Comentrios Sobre Threads RTS . . . . . . . . . . . . . . . . . . . . . . 1088 a Diferena en Entre Alguns Pacotes de Threads . . . . . . . . . 1090 c

E.2 E.3 E.4 E.5 E.6

Apndice F Variveis de Ambientes do MySQL e a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1092 Apndice G Sintaxe de Expresses Regulares do e o MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093 Apndice H GPL - Licena P blica Geral do e c u GNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1096 Indices dos Comandos, Tipos e Funoes SQL c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1102 Concept Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1111

Cap tulo 1: Informaes Gerais co

1 Informaes Gerais co
O programa MySQL R um servidor robusto de bancos de dados SQL (Structured Query e Language - Linguagem Estruturada para Pesquisas) muito rpido, multi-tarefa e multia usurio. O Servidor MySQL pode ser usado em sistemas de produo com alta carga e a ca misso critica bem como pode ser embutido em programa de uso em massa. MySQL uma a e marca registrada da MySQL AB. O programa MySQL de Licena Dupla. Os usurios podem escolher entre usar o proe c a grama MySQL como um produto Open Source/Free Software sob os termos da GNU General Public License (http://www.fsf.org/licenses/) ou podem comprar uma licena comc ercial padro da MySQL AB. Veja Seo 1.4 [Licensing and Support], Pgina 17. a ca a O site web do MySQL (http://www.mysql.com/) dispe das ultimas informaes sobre o o co programa MySQL. A seguinte lista descreve algumas sees de particular interesse neste manual: co Para informaes sobre a empresa por trs do Servidor do Banco de Dados MySQL, co a veja Seo 1.3 [What is MySQL AB], Pgina 12. ca a Para discusses das capacidades do Servidor do Banco de Dados MySQL, veja o Seo 1.2.2 [Features], Pgina 6. ca a Para instrues de instalao, veja Cap co ca ptexi tulo 2 [Installing], Pgina 60. a Para dicas sobre a portabilidade do Servidor do Banco de Dados MySQL para novas arquiteturas ou sistemas operacionais, veja Apndice E [Porting], Pgina 1078. e a Para informaes sobre a atualizao da verso 4.0, veja Seo 2.5.1 [Upgrading-fromco ca a ca 4.0], Pgina 121. a Para informaes sobre a atualizao da verso 3.23, veja Seo 2.5.2 [Upgrading-fromco ca a ca 3.23], Pgina 123. a Para informaes sobre a atualizao da verso 3.22, veja Seo 2.5.3 [Upgrading-fromco ca a ca 3.22], Pgina 127. a Para um tutorial de introduo ao Servidor do Banco de Dados MySQL, veja Capptexi ca tulo 3 [Tutorial], Pgina 168. a Para exemplos de SQL e informaes sobre benchmarks, veja o diretrio de benchmarks co o (sql-bench na distribuio). ca Para o histrico de novos recursos e correes de erros, veja Apndice D [News], o co e Pgina 957. a Para uma lista de erros atualmente conhecidos e mal-funcionamento, veja Seo 1.8.6 ca [Bugs], Pgina 54. a Para projetos futuros, veja Seo 1.6 [TODO], Pgina 27. ca a Para ver a lista de todos os colaboradores deste projeto, veja Apndice C [Credits], e Pgina 945. a Importante: Relatrios de erros (tambm chamados bugs), bem como dvidas e comentrios, devem ser o e u a enviados para a lista de email geral do MySQL. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a Veja Seo 1.7.1.3 [Bug reports], Pgina 36. ca a

MySQL Technical Reference for Version 5.0.0-alpha

O script mysqlbug deve ser usado para gerar comunicados de erros no Unix. (A distribuio ca do Windows contm um arquivo mysqlbug.txt no diretrio base que pode ser usado como e o um template para um relatrio de erro. o Em distribuies fonte, o script mysqlbug pode ser encontrado no diretrio scripts. Para co o distribuies binrias, o mysqlbug pode ser encontrado no diretrio bin (/usr/bin para co a o o pacote RMP do servidor MySQL. Se voc encontrou um erro de segurana no Servidor MySQL, voc deve enviar um email e c e para security@mysql.com.

1.1 Sobre Este Manual

Este o manual de referncia MySQL; ele documenta o MySQL at a verso 5.0.0-alpha. e e e a Mudanas funcionais so sempre indicadas com referncia a verso, assim este manual c a e a tambm pode ser utiliado caso voc esteja utilizando uma verso mais antiga do MySQL e e a (como 3.23 ou 4.0-produo). Tambm a referncias a verso 5.0 (desenvolvimento). ca e e a Sendo um manual de referncia, ele no fornece instrues gerais sobre SQL ou conceitos de e a co banco de dados relacionais. Como o Programa da Banco de Dados MySQL est sob constante desenvolvimento, o manual a tambm atualizado freqentemente. A verso mais recente deste manual est dispon e e u a a ivel em http://www.mysql.com/documentation/ em diferentes formatos, incluindo HTML, PDF, e verses HLP do Windows. o O documento original uma arquivo Texinfo. A verso HTML produzida automaticae a e mente usando uma verso modicada do texi2html. A verso texto e Info so produzidas a a a com makeinfo. A verso PostScript produzida usando texi2dvi e dvips. A verso PDF a e a produzida com pdftex. e Se voc tiver diculdades de encontrar informaes no manual, voc pode tentar nossa e co e verso com busca em http://www.mysql.com/doc/. a Se voc tiver qualquer sugesto a respeito de adies e correes neste manual, por favor e a co co envie-os para a equipe de documentao em docs@mysql.com. ca Este manual foi inicialmente escrito por David Axmark e Michael (Monty) Widenius. Atualmente mantido pela Equipe de Documentao da MySQL, que conta com Arjen e ca Lentz, Paul DuBois e Stefan Hinz. Para outros colaboradores, veja Apndice C [Credits], e Pgina 945. a A traduao deste manual foi feita por Daniel Coelho Teobaldo e Carlos Henrique Paulino c sob a superviso da EAC Software. a Os direitos autorais (2003) deste manual pertence a compania Sueca MySQL AB. Seo 1.4.2 [Direitos Autorais], Pgina 17. ca a Veja

1.1.1 Convenes Usadas Neste Manual co

Este manual utiliza algumas convenes tipogrcas: co a constant Fonte de largura xa usada para nomes de comandos e opes; instrues e co co SQL; nomes de bancos de dados, tabelas e colunas; cdigo C e Perl; e variveis o a

Cap tulo 1: Informaes Gerais co

de ambiente. Exemplo: Para ver como o mysqladmin funciona, execute-o com a opo --help. ca filename Fonte de largura xa com aspas usada para nomes e caminhos de arquivos. e Exemplo: A distribuio instalada sobre o diretrio /usr/local. ca e o c Fonte de largura constante com aspas tambm usada para indicar sequncias e e e de caracteres. Exemplo: Para especicar um meta caracter, use o caractere %. Fonte Itlica usada para dar nfase, como aqui. a e e Fonte em negrito usada em cabealhos de tabela e indicar nfase especial. e c e

italic boldface

Quando um comando deve ser executado por um programa, ele indicado por um prompt e antes do comando. Por exemplo, shell> indica um comando que executado do seu shell e atual e mysql> indica um comando que executado no programa cliente mysql; e shell> digite um comando shell aqui mysql> digite um comando mysql aqui A shell seu interpretador de comando. No Unix, ele normalmente um programa e e como sh ou csh. No Windows, o equivalente o command.com ou cmd.exe, normalmente e executado como um console do Windows. Comandos Shell so mostrados usando a sintaxe do Shell Bourne. Se voc usa um shell do a e estilo csh, pode ser necessrio alterar algum de seus comandos. Por exemplo, a sequncia a e para congurar uma varivel de ambiente e executar um comando se parece com o listado a abaixo na sintaxe Bourne Shell: shell> NOMEVAR=valor algum_comando Para csh ou tcsh, execute a sequncia desta forma: e shell> setenv NOMEVAR valor shell> algum_comando Frequentemente, nomes de bancos de dados, tabelas e colunas devem ser substitu idos nos comandos. Para indicar que as substituies so necessrias, este manual usa nome_db, co a a nome_tbl e nome_col. Por exemplo, voc pode encontrar uma expresso assim: e a mysql> SELECT nome_col FROM nome_bd.nome_tbl; Isso signica que se voc estiver trabalhando numa expresso similar, forneceria seu prprio e a o nome de banco de dados, tabela e colunas, talvez assim: mysql> SELECT nome_autor FROM biblio_bd.lista_autor; SQL keywords no caso sensitivas e podem ser escritas em maiscula ou minscula. Este a u u manual utiliza letras maisculas. u Em descries de sintaxe, colchetes ([ e ]) so usados para indicar palavras ou clusulas co a a opcionais. Por exemplo, na seguinte instruo, IF EXISTS opcional: ca e DROP TABLE [IF EXISTS] nome_tbl Quando elementos da sintaxe possuem mais de uma alternativa, elas so separados por a barras verticais (|). Quando um menbro de um conjunto de opes pode ser escolhido, as co alternativas so listadas em colchetes ([ e ]): a

MySQL Technical Reference for Version 5.0.0-alpha

TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str) Quando um membro de um conjunto de opes deve ser selecionado, as alternativas so co a listadas dentro de chaves ({ e }): {DESCRIBE | DESC} nome_tbl {nome_col | metacar}

1.2 Viso Geral do Sistema de Gerenciamento de Banco de a Dados MySQL

MySQL, o mais popular sistema de gerenciamento de banco de dados SQL Open Source, e desenvolvido, distribu e tem suporte da MySQL AB. A MySQL AB uma empresa comercial, ido e fundada pelos desenvolvedores do MySQL, cujos negcios fornecer servios relacionados o e c ao sistema de gerenciamento de banco de dados MySQL. Veja Seo 1.3 [What is MySQL ca AB], Pgina 12. a O web site do MySQL (http://www.mysql.com/) fornece informaes mais recentes sobre e co programa MySQL e a MySQL AB. O MySQL um sistema de gerenciamento de bancos de dados. e Um banco de dados uma coleo de dados estruturados. Ele pode ser quale ca quer coisa desde uma simples lista de compras a uma galeria de imagens ou a grande quantidade de informao da sua rede coorporativa. Para adicionar, ca acessar, e processar dados armazenados em um banco de dados de um computador, voc necessita de um sistema de gerenciamento de bancos de dados e como o Servidor MySQL. Como os computadores so muito bons em lidar com a grandes quantidades de dados, o gerenciamento de bancos de dados funciona como a engrenagem central na computao, seja como utilitrios independentes ca a ou como partes de outras aplicaes. co O MySQL um sistema de gerenciamento de bancos de dados relacional. e Um banco de dados relacional armazena dados em tabelas separadas em vez de colocar todos os dados um s local. Isso proporciona velocidade e exibilo idade. A parte SQL do MySQL atenda pela Structured Query Language Linguagem Estrutural de Consultas. SQL linguagem padro mais comum e a usada para acessar banco de dados e denida pelo Padro ANSI/ISO SQL. (O e a padro SQL est vem evoluindo desde 1986 e existem diversas verses. Neste a a o manual, SQL-92 se refere ao padro liberado em 1992, SQL-99 se refere ao a padro liberado em 1999, e SQL:2003 se refere a verso do que esperamos que a a seja liberado no meio de 2003. Ns usamos o termo o padr~o SQL indicando o a a verso atual do Padro SQL em qualquer momento). a a O MySQL um software Open Source. e Open Source signica que poss para qualquer um usar e modicar o proe ivel grama. Qualquer pessoa pode fazer download do MySQL pela Internet e us-lo a sem pagar nada. Se voc quiser, voc pode estudar o cdigo fonte e alter-lo e e o a para adequ-lo `s suas necessidades. O MySQL usa a GPL (GNU General Public a a License - Licena Pblica Geral GNU) c u http://www.fsf.org/licenses, para denir o que voc pode e no pode fazer com o software em diferentes e a situaes. Se voc sentir desconforto com a GPL ou precisar embutir o MySQL co e

Cap tulo 1: Informaes Gerais co

em uma aplicao comercial voc pode adquirir a verso comercial licenciada ca e a conosco. Veja Seo 1.4.3 [Licenas MySQL], Pgina 18. ca c a Por que usar o Banco de Dados MySQL? O servidor de banco de dados MySQL extremamente rpido, convel, e fcil e a a a de usar. Se isto o que voc est procurando, voc deveria experiment-lo. O e e a e a Servidor MySQL tambm tem um conjunto de recursos muito prticos desene a volvidos com a cooperao de nossos usurios. Voc pode encontrar comparaca a e tivos de performance do Servidor MySQL com outros gerenciadores de bancos de dados na nossa pgina de benchmark Veja Seo 5.1.4 [MySQL Benchmarks], a ca Pgina 421. a O Servidor MySQL foi desenvolvido originalmente para lidar com bancos de dados muito grandes de maneira muito mais rpida que as solues existentes a co e tem sido usado em ambientes de produo de alta demanda por diversos ca anos de maneira bem sucedida. Apesar de estar em constante desenvolvimento, o Servidor MySQL oferece hoje um rico e proveitoso conjunto de funes. A co conectividade, velocidade, e segurana fazem com que o MySQL seja altamente c adaptvel para acessar bancos de dados na Internet. a As caracter isticas tcnicas do MySQL e Para informaes tcnicas avanadas, veja Cap co e c ptexi tulo 6 [Reference], Pgina 469. a O Programa de Banco de Dados MySQL um sistema e cliente/servidor que consiste de um servidor SQL multi-tarefa que suporta acessos diferentes, diversos programas clientes e bibliotecas, ferramentas administrativas e diversas interfaces de programao (APIs). ca Tambm concedemos o Servidor MySQL como uma biblioteca multi-tarefa que e voc pode ligar ` sua aplicao para chegar a um produto mais rpido, menor e a ca a e mais fcilmente gerencivel. a a MySQL tem muitos softwares de colaboradores dispon ivel. E bem provvel que sua aplicao ou linguagem favorita j suporte o Servidor a ca a de Banco de Dados MySQL. A pronncia ocial do MySQL Mai Ess Que Ell (e no MAI-SEQUEL). Mas ns no u e a o a ligamos se voc pronunciar MAI-SEQUEL ou de outra forma qualquer. e

1.2.1 Histria do MySQL o

Quando comeamos, t c inhamos a inteno de usar o mSQL para conectar `s nossas tabelas ca a (ISAM). Entretanto, depois de alguns testes, utilizando nossas rpidas rotinas de baixo nivel a chegamos a concluso que o mSQL no era rpido e nem ex a a a ivel o suciente para nossas necessidades. Isto resultou em uma nova interface SQL para nosso banco de dados, mas com praticamente a mesma Interface API do mSQL. Esta API foi escolhida para facilitar a portabilidade para cdigos de terceiros que era escrito para uso com mSQL para ser portado o facilmente para uso com o MySQL. A derivao do nome MySQL no bem denida. Nosso diretrio base e um grande nmero ca a e o u de nossas bibliotecas e ferramentas sempre tiveram o prexo my por pelo menos 10 anos. A lha de Monty tambm ganhou o nome My. Qual das duas originou o nome do MySQL e continua sendo um mistrio, mesmo para ns. e o

MySQL Technical Reference for Version 5.0.0-alpha

O nome do golnho do MySQL (nosso logo) Sakila. Sakila foi escolhido pelos fune dadores da MySQL AB de uma enorme lista de nomes sugeridos pelos usurios em nosso a concurso "Name the Dolphin". O nome vencedor foi enviado por Ambrose Twebaze, um desenvolvedor de programas open source de Swaziland, Africa. De acordo com Ambrose, o nome Sakila tem as suas ra em SiSwati, a l izes ingua local de Swaziland. Sakila tambm o e e nome de uma cidade em Arusha, Tanzania, prxima ao pa de or o is igem de Ambrose, Uganda.

1.2.2 As Principais Caracter isticas do MySQL

A seguinte lista descreve algumas das caracter isticas mais importantes do Progrma de Banco de Dados MySQL. Veja Seo 1.5.1 [MySQL 4.0 Nutshell], Pgina 22. ca a Portabilidade e Escrito em C e C++. Testado com um amplo faixa de compiladores diferentes. Funciona em diversas plataformas. Veja Seo 2.2.3 [Quais SO], Pgina 78. ca a Utiliza o GNU Automake, Autoconf, e Libtool para portabilidade. APIs para C, C++, Eiel, Java, Perl, PHP, Python, Ruby e Tcl esto a dispon iveis. Veja Cap ptexi tulo 12 [Clients], Pgina 775. a Suporte total a multi-threads usando threads diretamente no kernel. Isto signica que se pode facilmente usar mltiplas CPUs, se dispon u ivel. Fornece mecanismos de armazenamento transacional e no transacional. a Tabelas em disco (MyISAM) baseadas em rvores-B extremamente rpidas a a com compresso de a indices. E relativamente fcil se adicionar outro mecanismo de armazenamento. a Isto util se voc quiser adicionar uma interface SQL a um banco de e e dados caseiro. Um sistema de alocao de memria muito rpido e baseado em proca o a cesso(thread). Joins muito rpidas usando uma multi-join de leitura unica otimizada. a Tabelas hash em memria que so usadas como tabelas temporrias. o a a Funes SQL so implementadas por meio de uma biblioteca de classes co a altamente otimizada e com o mximo de performance. Geralmente no h a a a nenhuma alocao de memria depois da inicializao da pesquisa. ca o ca O cdigo do MySQL foi testado com Purify (um detector comercial de o falhas de memria) e tambm com o Valgrind, uma ferramenta GPL o e (http://developer.kde.org/~sewardj/). Dispon como verso cliente/servidor ou embutida(ligada). ivel a

Tipos de Coluna Aceita diversos tipos de campos: tipos inteiros de 1, 2, 3, 4 e 8 bytes com e sem sinal, FLOAT, DOUBLE, CHAR, VARCHAR, TEXT, BLOB, DATE, TIME, DATETIME, TIMESTAMP, YEAR, SET e ENUM. Veja Seo 6.2 [Tipos de Coluna], ca Pgina 482. a Registros de tamanhos xos ou variveis. a

Cap tulo 1: Informaes Gerais co

Comandos e Funes co Completo suporte a operadores e funes nas partes SELECT e WHERE das co consultas. Por exemplo: mysql> SELECT CONCAT(first_name, " ", last_name) -> FROM nome_tbl -> WHERE income/dependents > 10000 AND age > 30; Suporte pleno `s clusulas SQL GROUP BY e ORDER BY. Suporte para funes a a co de agrupamento (COUNT(), COUNT(DISTINCT ...), AVG(), STD(), SUM(), MAX() e MIN()). Suporte para LEFT OUTER JOIN e RIGHT OUTER JOIN com as sintaxes SQL e ODBC. Alias em tabelas e colunas so dispon a iveis como denidos no padro SQL92. a DELETE, INSERT, REPLACE, e UPDATE retornam o nmero de linhas que u foram alteradas (afetadas). E poss ivel retornar o nmero de linhas com u padro coincidentes congurando um parmetro quando estiver conectando a a ao servidor. O comando espec ico do MySQL SHOW pode ser usado para devolver informaes sobre bancos de dados, tabelas e co indices. O comando EXPLAIN pode ser usado para determinar como o otimizador resolve a consulta. Nomes de funes no conitam com nomes de tabelas ou colunas. Por co a exemplo, ABS um nome de campo vlido. A unica restrio que para uma e a ca e chamada de funo, espaos no so permitidos entre o nome da funo e ca c a a ca o ( que o segue. Veja Seo 6.1.7 [Palavras reservadas], Pgina 479. ca a Voc pode misturar tabelas de bancos de dados diferentes na mesma e pesquisa (como na verso 3.22). a Segurana c Um sistema de privilgios e senhas que muito ex e e ivel, seguro e que permite vericao baseada em estaes/mquinas. Senhas so seguras porque ca co a a todo o trco de senhas criptografado quando voc se conecta ao servidor. a e e Escalabilidade e limites Lida com bancos de dados enormes. Usamos o Servidor MySQL com bancos de dados que contm 50.000.000 registros e sabemos de usurios que usam e a o Servidor MySQL com 60.000 tabelas e aproximadamente 5.000.000.000 de linhas. So permitidos at 32 a e indices por tabela. Cada indice pode ser composto de 1 a 16 colunas ou partes de colunas. O tamanho mximo do a indice e de 500 bytes (isto pode ser alterado na compilao do MySQL). Um ca indice pode usar o prexo de campo com um tipo CHAR ou VARCHAR. Conectividade Os clientes podem se conectar ao servidor MySQL usando sockets TCP/IP, em qualquer plataforma. No sistema Windows na fam NT (NT, 2000 ilia ou XP), os clientes podem se conectar usando named pipes. No sistema Unix, os clientes podem se conectar usando arquivos sockets.

MySQL Technical Reference for Version 5.0.0-alpha

A interface Connector/ODBC fornece ao MySQL suporte a progras clientes que usam conexo ODBC (Open-DataBase-Connectivity). Por exemplo, a voc pode usar o MS Access para conectar ao seu servidor MySQL. Os e clientes podem ser executados no Windows ou Unix. O fonte do Connector/ODBC est dispon a ivel. Todas as funes ODBC so suportadas, assim co a como muitas outras. Veja Seo 12.2 [ODBC], Pgina 870. ca a Localizao ca O servidor pode apresentar mensagem de erros aos clientes em vrias a l inguas. Veja Seo 4.7.2 [Languages], Pgina 327. ca a Suporte total para vrios conjuntos de caracteres, que incluem ISO-8859-1 a (Latin1), big5, ujis e mais. Por exemplo, os caracteres Escandinavos ^, a , so permitidos em nomes de tabelas e colunas. a o a Todos os dados so armazenados no conjunto de caracteres escolhido. Toa das as comparaes em colunas de seqncias caso-insensitivo. co ue A ordenao feita de acordo com o conjunto de caracteres escolhido (o ca e modo sueco por padro). E poss alterar isso quando o servidor MySQL a ivel iniciado. Para ver um exemplo de vrias ordenaes avanadas, procure e a co c pelo cdigo de ordenao Tcheca. O Servidor MySQL suporta diversos cono ca juntos de caracteres que podem ser especicados em tempo de compilao ca e execuo. ca Clientes e Ferramentas O servidor MySQL foi constru com suporte para instrues SQL que ido co vericam, otimizam e reparam tabelas. Estas instrues esto dispon co a iveis a partir da linha de comando por meio do cliente myisamcheck, O MySQL inclui tambm o myisamchk, um utilitrio muito rpido para realizar estas e a a operaes em tabelas MyISAM. Veja Cap co ptexi tulo 4 [MySQL Database Administration], Pgina 207. a Todos os programas MySQL podem ser chamados com as opes --help ou co -? para obter ajuda online.

1.2.3 Estabilidade do MySQL

Esta seo discute as questes Quo estvel o MySQL? e Posso depender do MySQL ca o a a e neste projeto?. Tentaremos deixar claro estes assuntos e responder algumas das questes o mais importantes que dizem respeito a muito de nossos usurios. A informao nesta seo a ca ca baseada em dados colhidos da lista de discusso, que muito ativa na identicao de e a e ca problemas e assim como nos relatos de tipos de uso. Originalmente, o cdigo vem do in dos anos 80, fornecendo um cdigo estvel e o formato o icio o a de tabelas ISAM permanece compat com verses anteriores. Na TcX, a predecessora da ivel o MySQLAB, o MySQL vem trabalhando sem problemas em nossos projetos desde o meio de 1996. Quando o Programa de Banco de Dados MySQL foi disponibilizado para um pblico maior, u nossos novos usurios rapidamente encontraram algumas partes de cdigo sem testes. a o Desde ento, cada distribuio nova teve menos problemas de portabilidade (mesmo com a ca os novos recursos implementados em cada uma destas verses) o

Cap tulo 1: Informaes Gerais co

Cada distribuio do Servidor MySQL foi sendo usado, e os problemas tem ocorrido somente ca quando os usurios comeam a usar o cdigo das reas cinzentas. Naturalmente, novos a c o a usurios no sabem o que so as reas cinzentas; esta seo tenta indicar aquelas que so a a a a ca a conhecidas atualmente. As descries lidam com a Verso 3.23 e 4.0 do Servidor MySQL. co a Todos os erros conhecidos e relatados so corrigidos na ultima verso, com a exceo dos a a ca bugs listados na seo de erros, os quais so relacionados ao desenho. Veja Seo 1.8.6 ca a ca [Bugs], Pgina 54. a O Servidor MySQL escrito em mltiplas camadas com mdulos independentes. Alguns e u o dos novos mdulos esto listados abaixo com indicaes de quo bem-testado foi cada um o a co a deles. Replicao Gamma ca Grandes grupos de servidores usando replicao esto em uso, com bom resulca a tados. O trabalho no aprimoramento dos recursos de replicao continua no ca MySQL 4.x. Tabelas InnoDB Estvel (na 3.23, 3.23.49) a O mecanismo de armazenamento transacional InnoDB foi declarado estvel na a a rvore do MySQL 3.23, a partir da verso 3.23.49. InnoDB tem sido usado em a sistema de produo grandes e com carga pesada. ca Tabelas BDB Gamma O cdigo do Berkeley DB muito estvel, mas ainda estamos melhorando a o e a interface do mecanismo de armazenamento transacional do BDB no Servidor MySQL, assim levar algum tempo at que ele esteja to bem testado quanto os a e a outro tipos de tabela. Pesquisas Full-text Beta Pesquisa full-text funcionam mas ainda no so largamente usadas. Melhoraa a mentos importantes forma implementados no MySQL 4.0. MyODBC 3.51 (usa ODBC SDK 3.51) Estvel a Em grande uso na produo. Alguns problemas apresentados parecem ser relaca cionados a aplicao e independente do driver ODBC ou do servidor de banco ca de dados. Recuperao automtica de tabelas MyISAM Gamma ca a Este status se aplica apenas ao novo cdigo que confere no mecanismo de aro mazenamento MyISAM que verica, na inicializao, se a tabela foi fechada corca retamente e executa uma conferncia/reparo automtico da tabela em caso e a negativo. Bulk-insert Alpha Novo recurso nas tabelas MyISAM no MySQL 4.0 para inseres mais rpidas de co a vrios registros. a Locking Gamma Esse mdulo muito dependente do sistema. Em alguns sistemas existem certos o e problemas por utilizar o locking padro do SO (fcntl(). Nestes casos, voc a e deve executar o mysqld com o parmetro --skip-external-locking. So a a conhecidos alguns problemas ocorridos em alguns sistemas Linux e no SunOS quando utiliza-se sistemas de arquivos montados em NFS.

10

MySQL Technical Reference for Version 5.0.0-alpha

Clientes que pagam recebem suporte direto e de alta qualidade da MySQL AB. A MySQL AB tambm fornece uma lista de discusso como um recurso da comunidade onde qualquer e a pessoa pode tirar suas dvidas. u Erros so normalmente corrigidos com um patch; para erros srios, normalmente lanada a e e c uma nova distribuio. ca

1.2.4 Qual o Tamanho Que as Tabelas do MySQL Podem Ter?

A Verso 3.22 do MySQL tem suporte para tabelas com limite de tamanho at 4G. Com a e o novo MyISAM no MySQL verso 3.23 o tamanho mximo foi expandido at 8 milhes de a a e o terabytes (2 ^ 63 bytes). Com este tamanho de tabela maior permitido, o tamanho mximo a efetivo das tabelas para o banco de dados MySQL normalmente limitado pelas restries e co do sistema operacional quanto ao tamanho dos arquivos, no mais por limites internos do a MySQL. A seguinte tabela lista alguns exemplos do limite do tamanho de arquivos do sistema operacional: Sistema Operacional Linux-Intel 32 bit Linux-Alpha Solaris 2.5.1 Solaris 2.6 Solaris 2.7 Intel Solaris 2.7 ULTRA-SPARC Limite do tamanho do arquivo 2G, muito mais usando LFS 8T (?) 2G (E poss 4GB com patch) ivel 4G (pode ser alterado com parmetro) a 4G 8T (?)

No Linux 2.2 voc pode ter tabelas maiores que 2 GB usando o patch LFS para o sistema e de arquivos ext2. No Linux 2.4 j existem patches para o sistema de arquivos ReiserFS para a ter suporte a arquivos maiores. A maioria das distribuies atuais so baseadas no kernel co a 2.4 e j incluem todos os patches Suporte a Arquivos Grandes (Large File Support - LFS) a exigidos. No entanto, o tamanho mximo dispon a ivel ainda depende de diversos fatores, sendo um deles o sistema de arquivos usado para armazenar as tabelas MySQL. Para um viso mais detalhada sobre LFS no Linux, d uma olha na pgina Andreas Jaegers a e a "Large File Support in Linux" em http://www.suse.de/~aj/linux_lfs.html. Por padro, o MySQL cria tabelas MyISAM com uma estrutura interna que permite um a tamanho mximo em torno de 4G. Voc pode vericar o tamanho mximo da tabela com a e a o comando SHOW TABLE STATUS ou com o myisamchk -dv nome_tabela Veja Seo 4.6.8 ca [SHOW], Pgina 302. a Se voc precisa de tabelas maiores que 4G (e seu sistema operacional suporta arquivos e grandes), a instruo CREATE TABLE permite as opes AVG_ROW_LENGHT e MAX_ROWS. Use ca co estas opes para criar uma tabela que possa ter mais de 4GB. Veja Seo 6.5.3 [CREATE co ca TABLE], Pgina 598. Voc pode tambm alterar isso mais tarde com ALTER TABLE. Veja a e e Seo 6.5.4 [ALTER TABLE], Pgina 608. ca a Outros modos se contornar o limite do tamanho do arquivo das tabelas MyISAM so os a seguintes: Se sua tabela grande ser somente leitura, voc poder usar o myisampack para unir a e a e comprimir vrias tabelas em uma. mysisampack normalmente comprime uma tabela a

Cap tulo 1: Informaes Gerais co

11

em pelo menos 50%, portanto voc pode obter, com isso, tabelas muito maiores. Veja e Seo 4.8.4 [myisampack], Pgina 336. ca a Outra opo para contornar o limite de tamanho de arquivos do sistema operacional ca para arquivos de dados MyISAM usando a opo RAID. Veja Seo 6.5.3 [CREATE TABLE], ca ca Pgina 598. a O MySQL inclu uma biblioteca MERGE que permite acessar uma coleo de tabelas i ca idnticas como se fosse apenas uma. Veja Seo 7.2 [MERGE], Pgina 638. e ca a

1.2.5 Compatibilidade Com o Ano 2000 (Y2K)

O Servidor MySQL no apresenta nenhum problema com o ano 2000 (Y2K compat a ivel) O Servidor MySQL usa funes de tempo Unix que tratam datas at o ano 2037 para co e valores TIMESTAMP; para valores DATE e DATETIME, datas at o ano 9999 so aceitas. e a Todas as funes de data do MySQL esto no arquivo sql/time.cc e codicadas com co a muito cuidado para ser compat com o ano 2000. ivel No MySQL verso 3.22 e posterior, o novo tipo de campo YEAR pode armazenar anos 0 e a 1901 at 2155 em 1 byte e mostr-lo usando 2 ou 4 d e a igitos. Todos os anos de 2 d igitos so considerados estar na faixa de 1970 at 2069; o que signica que se voc armazenar a e e 01 em uma coluna YEAR, O Servidor MySQL o tratar como 2001. a O seguinte demonstrao simples ilustra que o MySQL Server no tem nenhum problema ca a com datas at depois do ano 2030: e mysql> DROP TABLE IF EXISTS y2k; Query OK, 0 rows affected (0.01 sec) mysql> CREATE TABLE y2k (date DATE, -> date_time DATETIME, -> time_stamp TIMESTAMP); Query OK, 0 rows affected (0.00 sec) mysql> INSERT INTO y2k VALUES -> ("1998-12-31","1998-12-31 23:59:59",19981231235959), -> ("1999-01-01","1999-01-01 00:00:00",19990101000000), -> ("1999-09-09","1999-09-09 23:59:59",19990909235959), -> ("2000-01-01","2000-01-01 00:00:00",20000101000000), -> ("2000-02-28","2000-02-28 00:00:00",20000228000000), -> ("2000-02-29","2000-02-29 00:00:00",20000229000000), -> ("2000-03-01","2000-03-01 00:00:00",20000301000000), -> ("2000-12-31","2000-12-31 23:59:59",20001231235959), -> ("2001-01-01","2001-01-01 00:00:00",20010101000000), -> ("2004-12-31","2004-12-31 23:59:59",20041231235959), -> ("2005-01-01","2005-01-01 00:00:00",20050101000000), -> ("2030-01-01","2030-01-01 00:00:00",20300101000000), -> ("2050-01-01","2050-01-01 00:00:00",20500101000000); Query OK, 13 rows affected (0.01 sec) Records: 13 Duplicates: 0 Warnings: 0

12

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT * FROM y2k; +------------+---------------------+----------------+ | date | date_time | time_stamp | +------------+---------------------+----------------+ | 1998-12-31 | 1998-12-31 23:59:59 | 19981231235959 | | 1999-01-01 | 1999-01-01 00:00:00 | 19990101000000 | | 1999-09-09 | 1999-09-09 23:59:59 | 19990909235959 | | 2000-01-01 | 2000-01-01 00:00:00 | 20000101000000 | | 2000-02-28 | 2000-02-28 00:00:00 | 20000228000000 | | 2000-02-29 | 2000-02-29 00:00:00 | 20000229000000 | | 2000-03-01 | 2000-03-01 00:00:00 | 20000301000000 | | 2000-12-31 | 2000-12-31 23:59:59 | 20001231235959 | | 2001-01-01 | 2001-01-01 00:00:00 | 20010101000000 | | 2004-12-31 | 2004-12-31 23:59:59 | 20041231235959 | | 2005-01-01 | 2005-01-01 00:00:00 | 20050101000000 | | 2030-01-01 | 2030-01-01 00:00:00 | 20300101000000 | | 2050-01-01 | 2050-01-01 00:00:00 | 00000000000000 | +------------+---------------------+----------------+ 13 rows in set (0.00 sec) O valor da coluna TIMESTAMP nal zero porque o ano nal (2050) excede o TIMESTAMP e maximo. O tipo de dados TIMESTAMP, que usado para armazenar a hora atual, suporta e valores na faixa de 19700101000000 a 20300101000000 em mquinas 32 bits (valor com a sinal). Em mquinas de 64 bits, TIMESTAMP trata valores at 2106 (valores sem sinal). a e O exemplo mostra que os tipos DATE e DATETIME no tem problemas com as datas usadas. a Eles iro conseguir trabalhar com datas at o ano 9999. a e Embora o MySQL Server seja seguro em relao ao ano 2000, voc pode ter problemas se voc ca e e us-lo com aplicaes que no so seguras com o ano 2000. Por exemplo, muitas aplicaes a co a a co antigas armazenam ou manipulam anos usando valores de 2 digitos (que so amb a iguos) em vez de 4 d igitos. Este problema pode ser aumentado por aplicaes que usam valores como co 00 ou 99 como indicadores de valores perdidos. Infelizmente, estes problemas pode ser dif iceis de corrigir, cada um deles pode usar um conjunto diferente de convenes e funes co co de tratamento de datas. Assim, apesar do Servidor MySQL no ter problemas com o ano 2000, de responsabilidade a e de sua aplicao fornecer datas que no sejam amb ca a iguas. Veja Seo 6.2.2.1 [Y2K issues], ca Pgina 490 para as regras do Servidor MySQL para lidar com entrada de datas amb a iguas que contenham valores de ano com 2 d igitos.

1.3 Viso Geral da MySQL AB a

MySQL AB a companhia dos fundadores e principais desenvolvedores do MySQL. A MySQL e AB foi estabelecida originalmente na Sucia por David Axmark, Allan Larsson e Michael e Monty Widenius.

Cap tulo 1: Informaes Gerais co

13

Os desenvolvedores do servidor MySQL so todos empregados pela companhia. ny Ns somo a o uma organizao virtual com pessoas em uma dzia de pa ca u ises. Nos comunicamos extensivamente na internet todos os dias uns com os outros e com nossos usurios, agentes de a suporte e parceiros. Ns nos dedicamos a desenvolver o programa MySQL e propagar nosso banco de dados a o novos usurios.A MySQL AB detm os direitos autorais do cdigo fonte do MySQL, do logo e a e o da marca MySQL e deste manual. Veja Seo 1.2 [What-is], Pgina 4. ca a A ideologia do MySQL mostra nossa dedicao ao MySQL e ao Open Source. ca Ns desejamos que o Programa de Banco de Dados MySQL seja: o O melhor e o mais usado banco de dados no mundo. Acess e dispon para todos. ivel ivel Fcil de usar. a Melhorado continuamente, permanecendo rpido e seguro. a Divertido de se usar e aprimorar. Livre de erros (bugs). A MySQL AB e sua equipe: Promovem a losoa Open Source e suporte ` comunidade Open Source. a Tem como objetivo serem bons cidados. a Tem preferncia por parceiros que compartilhem nossos valores e idias. e e Respondem e-mails e do suporte. a So uma empresa virtual, conectada com outras. a Trabalha contra patentes de sistemas. O site do MySQL (http://www.mysql.com/) fornece as ultimas informaes sobre o MySQL co e a MySQL AB. A propsito, a parte AB do nome da companhia o acrnimo para a palavra suca o e o e aktiebolag, ou sociedade annima. Ela traduzida para MySQL, Inc. De fato, o e MySQL Inc. e MySQL GmbH so exemplos de subsidirias da MySQL AB. Elas esto a a a localizadas nos EUA e Alemanha, respectivamente.

1.3.1 O Modelo de Negcio e Servios da MySQL AB o c

Uma das dvidas mais comuns que encontramos : Como voc pode viver de algo que voc u e e e assim que fazemos. disponibiliza sem custo? E A MySQL AB ganha dinheiro com suporte, servios, licenas comerciais e royalties. Usc c amos estes rendimentos para patrocinar o desenvolvimento de produtos e para expandir os negcios da MySQL. o A compania tem sido luccrativa desde de sua criao. Em Outubro de 2001, aceitamos um ca nanciamento de risco de investidores Escandinavos e um pounhado de pessoas de negcio. o Este investimento usado para solidicarmos nosso modelo de negcio e construir um base e o para o crescimento sustentvel. a

14

MySQL Technical Reference for Version 5.0.0-alpha

1.3.1.1 Suporte
A MySQL AB gerenciada pelos fundadores e principais desenvolvedores do banco de dados e MySQL. Os desenvolvedores tem o compromisso de dar suporte aos clientes e outros usurios a com objetivo de manterem contato com as suas necessiades e problemas. Todo o nosso suporte dado por desenvolvedores qualicado. Dvidas mais complicadas so respondidas e u a por Michael Monty Widenius, principal autor do MySQL Server. Veja Seo 1.4.1 [Suporte], ca Pgina 17. a Para maiores informaes e pedido de suporte de diversos n co iveis, veja http://www.mysql.com/support/ ou contate nossos vendedores em sales@mysql.com.

1.3.1.2 Treinamento e Certicao ca

A MySQL AB distribui o MySQL e treinamentos relacionados mundialmente. Oferecemos tanto cursos abertos quanto fechados voltado para a necessidade espec ica da sua empresa. O Treinamento do MySQL tambm est dispon por meio de seus parceiros, os Centros de e a ivel Treinamento Autorizados do MySQL. Nosso material de treinamento usa os mesmos bancos de dados exemplos usados em nossa documentao e nossos exemplos de aplicativos. Ele est sempre atualizado de acordo com ca a a ultima verso do MySQL. Nossos instrutores so apoiados por nossa equipe de desenvolvi a a mento para garantir a qualidade do treinamento e o desenvolvimento cont inuo do material de nossos cursos. Isto tambm assegura que nenhuma questo surgida durante o curso que e a sem resposta. Fazendo nossos cursos de treinamento permitir que voc alcance os objetivos de seu aplicaa e tivo MySQL. voc tambm ir: e e a Economizar tempo. Melhorar o desempenho de seus aplicativos. Reduzir ou eliminar a necessidade de hardware adicional, baixando o custo. Melhorar a segurana. c Aumentar a satisfao dos clientes e colabloradores. ca Preparar-se para Certifica~o MySQL. ca Se voc estiver interessado em nosso treinamento como um participante em pore tencial ou como um parceiro de treinamento, viste a seo de treinamento em ca http://www.mysql.com/training/ ou contate nos em: training@mysql.com. Para detalhes sobre o Programa de Certifica~o MySQL, veja http://www.mysql.com/certification/. ca

1.3.1.3 Consultoria
A MySQL AB e seus Parceiros Autorizados oferecem servios de consultoria para usurios c a do Servidor MySQL e `queles que utilizam o Servisdor MySQL embutido em seus programas, a em qualquer parte do mundo. Nossos consultores podem ajud-lo projetando e ajustando o seu banco de dados, criar a consultas ecientes, ajustar sua plataforma para uma melhor performance, resolver questes o

Cap tulo 1: Informaes Gerais co

15

de migrao, congurar replicao, criar aplicaes transacionais robustas, e mais. Tambm ca ca co e ajudamos os nossos clientes com o Servidor MySQL embutido em seus produtos e aplicaes co para desenvolvimento em larga-escala. Nossos consultores trabalham em colaborao com a nossa equipe de desenvolvimento, o ca que assegura a qualidade tcnica de nossos servios prossionais. Os servios de consultoria e c c varia de sesses de 2 dias a projetos que gastam semanas e meses. Nosso peritos no apenas o a cobrem o Servidor MySQLeles tambm conhecem sobre linguagens de programao e scripts e ca tais como PHP, Perl e mais. Se estiver interessado em nossos servios de consultoria ou quiser se tornar nosso parceiro, c visite a seo sobre consultaria em nosso web site em http://www.mysql.com/consulting/ ca ou contate nossa equipe de consultoria em consulting@mysql.com.

1.3.1.4 Licenas Comerciais c

O banco de dados MySQL liberado sob a licena GNU General Public License (GPL). Isto e c signica que o programa MySQL pode ser usado sem custos sob a GPL. Se voc no deseja estar e a limitado pelos termos da GPL (tais como a exigncia de que a sua aplicao tambm deva ser e ca e GPL), voc pode comprar uma licena comercial para o mesmo produto da MySQL AB; veja e c http://www.mysql.com/products/pricing.html. Desde de que a MySQL AB dona dos e direitos do cdigo fonte do MySQL, estamos aptos a empregar o Licenciamento Dual, que o signica que o mesmo produto est dispon sob a GPL e sob uma licena comercial. Isto a ivel c no afeta o nosso comprometimento com o Open Source de forma alguma. Para detalhes a sobre quando uma licena comercial exigida, veja Seo 1.4.3 [MySQL licenses], Pgina 18. c e ca a

1.3.1.5 Parcerias
A MySQL AB tem um programa de parceria mundial que cobre cursos de treinamento, consultaria e suporte, publicaes, mais a revenda e distribiuio do MySQL e produtos co ca relacionados. Os Parceiros da MySQL AB ganham visibilidade no nosso web site (http://www.mysql.com/) e o direito de usarem verses especiais da marca MySQL para o identicar seus produtos e promoverem os seus negcios. o Se voc est interessado em se tornar um Parceiro da MySQL AB, envie-nos um email para e a partner@mysql.com. A palavra MySQL e o logomarca do golnho da MySQL so marcas registradas da MySQL AB. a Veja Seo 1.4.4 [MySQL AB Logos and Trademarks], Pgina 20. Estas marcas registradas ca a representam um valor signicante que os fundadores do MySQL construiram ao longo dos anos. O web site do MySQL (http://www.mysql.com/) popular entre desenvolvedores e usurios. e a Em Outubro de 2001, obtivemos mais de 10 milhes e views. Nossos visitantes representam o um grupo que tomam decises de compra e fazem recomendes de software e hardware. o co Vinte por cento de nossos vistantes autorizam decises de compra e apenas nove por cento o no esto envolvidos com a rea de compras. Mais de 65% zeram uma ou mais compras a a a online no ultimo semaster e 70% planejam fazer uma compra nos prximos meses. o

16

MySQL Technical Reference for Version 5.0.0-alpha

1.3.2 Informaes para Contato co

O web site do MySQL (http://www.mysql.com/) fornece as ultimas informaes sobre MySQL co e MySQL AB. Para servios de imprensa e questes no cobertas por nossas releases de nott c o a icias (http://www.mysql.com/news/), envie-nos um email para press@mysql.com. Se voc tiver um contrato de suporte vlido com a MySQL AB, voc receber em tempo, e a e a respostas precisas para as suas questes tcnicas sobre o programa MySQL. o e Para mais informaes, veja Seo 1.4.1 [Support], Pgina 17. Em nosso site na web, veja co ca a http://www.mysql.com/support/, ou envie um e-mail para sales@mysql.com. Para informaes sobre treinamento MySQL, visite a seo de treinamento em co ca http://www.mysql.com/training/. Se voc tiver acesso restrito ` Internet, conte a e a equipe de treinamento da MySQL AB via e-mail em training@mysql.com. Veja Seo 1.3.1.2 ca [Business Services Training], Pgina 14. a Para informaes sobre o Progrma de Certificao MySQL, veja http://www.mysql.com/certification/. co c Veja Seo 1.3.1.2 [Business Services Training], Pgina 14. ca a Se voc estiver interessado em consultoria, visite a seo de consultorias de nosso web e ca site em http://www.mysql.com/consulting/. Se voc tiver restries acesso a internet, e co contate a equipe de consultores da MySQL AB via e-mail em consulting@mysql.com. Veja Seo 1.3.1.3 [Business Services Consulting], Pgina 14. ca a Licenas comerciais podem ser compradas online em https://order.mysql.com/. c L voc tambm encontrar informaes de como enviar um fax da sua ordem de a e e a co compra para a MySQL AB. Mais informaes sobre licenas podem ser encontradas em co c http://www.mysql.com/products/pricing.html. Se voc tiver duvidas em relao a e ca licenciamento ou quiser cota para negociao de um alto volume de licenas, preencha o ca c formulrio de contato em nosso site web (http://www.mysql.com/) ou envie um email a para licensing@mysql.com (para questes sobre licenciamento) ou para sales@mysql.com o (para pedidos de compra). Veja Seo 1.4.3 [Licenas MySQL], Pgina 18. ca c a Se voc est interessado em fazer parceira com a MySQL AB, envie um e-mail para e a partner@mysql.com. Veja Seo 1.3.1.5 [Business Services Partnering], Pgina 15. ca a Para mais detalhes sobre a politica da marca MySQL, visite http://www.mysql.com/company/trademark.ht ou envie um e-mail para trademark@mysql.com. Veja Seo 1.4.4 [MySQL AB Logos and ca Trademarks], Pgina 20. a Se voc est interessado em qualquer um dos trabalhos da MySQL AB lista na seo de trae a ca balhos (http://www.mysql.com/company/jobs/), envie um e-mail para jobs@mysql.com. No nos envie o seu CV em anexo, mas como texto no nal de sua mensagem de email. a Para discusses gerais entre nosso muitos usurios, direcione a sua ateno para a lista de o a ca discusso apropriada. Veja Seo 1.7.1 [Dvidas], Pgina 33. a ca u a Relatrios de erros (geralmente chamados bugs), assim como questes e comentrios, deo o a vem ser enviados para a lista de email geral do MySQL. Veja Seo 1.7.1.1 [Mailing-list], ca Pgina 33. Caso voc encontre um bug de segurana importante no MySQL Server, envie-nos a e c um e-mail para security@mysql.com. Veja Seo 1.7.1.3 [Bug reports], Pgina 36. ca a Se voc tiver resultados de benchmarks que podemos publicar, contate-nos via e-mail em e benchmarks@mysql.com.

Cap tulo 1: Informaes Gerais co

17

Se voc tiver sugestes a respeito de adies ou conexes para este manual, envie-os para a e o co o equipe do manual via e-mail em docs@mysql.com.

Para questes ou comentrios sobre o funcionamento ou cotedo do web site da MySQL o a u (http://www.mysql.com/), envie um e-mail para webmaster@mysql.com. A MySQL AB tem uma pol itica de privacidade que pode ser lida em http://www.mysql.com/company/privac Para qualquer questes a respeito desta pol o itica, envie um e-mail para privacy@mysql.com. Para todos os outros assunto, envie um e-mail para info@mysql.com.

1.4 Suporte e Licenciamento do MySQL

Esta seo descreve os contratos de licenciamento e suporte do MySQL. ca

1.4.1 Suporte Oferecido pela MySQL AB

O suporte tcnico do MySQL AB signica respostas individualizadas as seus problemas pare ticulares diretamente dos engenheiros de software que codicaram o MySQL. Tentamos ter uma viso ampla e inclusiva de suporte tcnico. Qualquer problema envola e vendo o MySQL importante par ns se for importante para voc. Normalmente os clientes e o e procuram ajuda em como comandos e utilitrios diferentes funcionam, remover gargalos de a desempenhos, restaurar sistemas com falhas, entender impactos do sistema operacional e rede no MySQL, congurar melhor prticas de backup e restaurao, utiluizaar APIs, e assim a ca por diante. Nosso suporte cobre apenar o servidor MySQL e nossos prprios utilitrios, e o a no produtos de terceirosque acessam o servidor MySQL, embora tentamos ajudar com eles a quando podemos. Informaes detalhadas sobre nossas vrias opes de suporte dado em co a co e Suporte tcnico como seguro de vida. Voc pode viver felizsem ele durante anos, mas e e e quando sua hora chegar ele de grande importncia, mas j muito tarde para adquir e a ae ilo. Se voc utiliza o MySQL Server para aplicaes importantes e encontrar diculdades e co repentinas, voc pode gastar horas tentando resolver os problemas sozinho. Voc pode e e precisar de acesso imediato aos responsveis pela soluo de problemas do MySQL dsipon a ca iveis, contratados pela MySQL AB.

1.4.2 Copyrights e Licenas Usadas pelo MySQL c

MySQL AB possui os direitos sobre o cdigo fonte do MySQL, as logomarcas e marcas rego istradas do MySQL e este manual. Veja Seo 1.3 [What is MySQL AB], Pgina 12. Diversas ca a licenas so relevantes a distribuio do MySQL: c a ca 1. Todo o cdigo espec o ico do MySQL no servidor, a biblioteca mysqlclient e o cliente, assim como a biblioteca GNU readline coberta pela GNU General Public License. e Veja Apndice H [GPL license], Pgina 1096. O texto desta licena podee ser encone a c trado no arquivo COPYING na distribuio. ca 2. A biblioteca GNU getopt coberta pela GNU Lesser General Public License. Veja e http://www.fsf.org/licenses/.

18

MySQL Technical Reference for Version 5.0.0-alpha

3. Algumas partes da fonte (a biblioteca regexp) coberta por um copyright no estilo e Berkeley. 4. Verses mais antiga do MySQL (3.22 e anteriror) esto sujeitos a uma licena estrita o a c (http://www.mysql.com/products/mypl.html). Veja a documentao da verso esca a pec ica para mais informao. ca 5. O manual de referncia do MySQL atualmente no distribu sob uma licecna no e a e ido c estilo da GPL. O uso deste manual est sujeito aos seguintes termos: a A converso para outros formatos permitido, mas o contedo atual no pode ser a e u a alterado ou editado de modo algum. Voc pode criar uma cpia impressa para seu prprio uso pessoal. e o o Para todos os outros usos, como venda de cpias impressas ou uso (de partes) do o manual em outra publicao, necessrios um acordo com a MySQL AB previamente ca e a escrito. Envie-nos email para docs@mysql.com para maiores informaes ou se voc estiver co e interessado em fazer a traduo. ca Para informaes sobre como as licenas do MySQL funcionam na prtica, de uma olhada co c a em Seo 1.4.3 [MySQL licenses], Pgina 18. Veja tambm Seo 1.4.4 [MySQL AB Logos ca a e ca and Trademarks], Pgina 20. a

1.4.3 Licenas do MySQL c

O programa MySQL distribu e ido sob a GNU General Public License (GPL), que provavelmente a melhor licena Open Source conhecida. e c Os termos formais da licena GPL pode ser encontrado em http://www.fsf.org/licenses/. Veja tambm c e http://www.fsf.org/licenses/gpl-faq.html e http://www.gnu.org/philosophy/enforcing-gpl.htm Como o programa MySQL distribu sob a GPL, ele pode ser usa geralmente de graa, mas e ido c para certos usos voc pode querer ou precisar comprar lincenas comerciais da MySQL AB em e c https://order.mysql.com/. Veja http://www.mysql.com/products/licensing.html para mais informaes. co Verses mais antigas do MySQL (3.22 e anteriores) esto sujeitos a uma licena mais estrita o a c (http://www.mysql.com/products/mypl.html). Veja a documentao da verso espec ca a ica para mais informao. ca Note que o uso do programa MySQL sob uma licena comercial, GPL ou a antiga licena do c c MySQL no d automaticamente o direito de usar as marcas registradas da MySQL AB. Veja a a Seo 1.4.4 [MySQL AB Logos and Trademarks], Pgina 20. ca a

1.4.3.1 Usando o Programa MySQL Sob uma Licena Comercial c

A licena GPL contagiosa no sentido de que quando um programa ligado a um programa c e e GPL, todo o cdigo fonte para todas as partes do produto resultante tambm devem ser o e distribu idas sob a GPL. Se voc no seguir esta exigncia do GPL, voc quebra os termos da e a e e licena e perde o seu direito de usar o programa GPL inclu c ido. Voc tambm corre riscos. e e Voc precisar de uma licena comercial: e a c

Cap tulo 1: Informaes Gerais co

19

Quando voc liga um programa com qualquer cdigo GPL do programa MySQL e no que e o a que o produto resultante seja licenciado sob a GPL, talvez porque voc queira criar um e produto comercial ou manter fechado o cdigo no GPL adicionado por outras razes. o a o Ao comprar a lincena comercial, voc no est usando o programa MySQL sob GPL c e a a embora o cdigo seja o mesmo. o Quando voc distribui uma aplicao no GPL que s funciona com o programa MySQL e ca a o e a entrega com o programa MySQL. Este tipo de soluo considerada mesmo se feita ca e em uma rede. Quando voc distribui cpias do programa MySQL sem fornecer o cdigo fonte como e o o exigido sob a licena GPL. c Quando voc quiser dar suporte adional ao desenvolvimento do banco de dados do e MySQL mesmo se voc no precisar formalmente de uma licena comercial. Comprar e a c o suporte diretamente da MySQL AB outro bom modo de contribuir com o desene volvimento do programa MySQL, com vantagens imediatas para voc. Veja Seo 1.4.1 e ca [Support], Pgina 17. a Se voc requisita uma licecna, voc precisar de uma para cada instalao do programa e c e a ca MySQL. Ela cobre qualquer nmero de CPUs na mquina, e np h nenhum limite articial u a a a no nmero de clientes que conectam aom servidor de qualquer modo. u Para licenas comercias, ,visite o nosso site web em http://www.mysql.com/products/licensing.html. c Para contrato de suporte, veja http://www.mysql.com/support/. Se voc tiver necessie dades especiais ou tiver acesso restrito a Internet, contate a nossa quipe de vendas via email em sales@mysql.com.

1.4.3.2 Usando o Programa MySQL Sem Custo Sob GPL

Voc pode utilizar o programa MySQL sem custo sob a GPL se voc concordar as condies do e e co GPL. Para detalhes adicionais, incluindo respostas a duvidas comuns sobre a GPL, veja o FAQ gencio da Free Software Foundation em http://www.fsf.org/licenses/gpl-faq.html. Usos comuns da GPL incluem: Quando voc distribui sua prpria aplicao e o cdigo fonte da MySQL com o seu e o ca o produto. Quando voc distribui o cdigo fonte do MySQL junto com outros programas que no e o a so ligados ou dependentes do sistema do MySQL para suas funcionalidades mesmo se a voc vender a distribuio comercialmente. Isto chamado agregao na licena GPL. e ca e ca c Quando voc no est distribuindo qualquer parte do sistema do MySQL, voc pode e a a e us-lo de graa. a c Quando voc for um Provedos de Servios de Internet (Internet Service Provider - ISP), e c oferecendo hospedagem web com serviodres MySQL para seus clientes. Encorajamos as pessoas a usarem provedroes que possuem suporte ao MySQL, j que isto lhes dar a a a conana qie seus provedores tero, de fato, os recursos para resolver qualquer problema c a que eles possam experimentar com a instalaao do MySQL. Mesmo se um provedor no c a tiver uma licena comercial ara o MySQL Server, seus clientes devem ter acesso de c leitura ao fonte da instalao do MySQL para que seus clientes veriquem que ela est ca a correta.

20

MySQL Technical Reference for Version 5.0.0-alpha

Quando voc usa o banco de dados MySQL em conjunto com um servidor web, voc no e e a precisa de uma licena comercial (uma vez que este no um produto distribu por c a e ido voc). Isto verdade mesmo se voc executar um servidor web comercial que utilize e e e MySQL Server, pois voc no est distribuindo qualquer parte do sistema MySQL. No e a a entanto, neste caso ns gostariamos que voc adquirisse o suporte ao MySQL pois o o e MySQL est ajudandoa sua empresa. a Se o seu uso do banco de dados MySQL no exige uma licena comercial, lhe encorajamos a c a adquirir um suporte da MySQL AB de qualquer forma. Deste modo voc contribui com o e desenvolvimento do MySQL e tambm ganha vantegens imediatas. Veja Seo 1.4.1 [Support], e ca Pgina 17. a Se voc utiliza o bancdo de dados MySQL em um contexto comercial e obtem lucro com e o seu uso, pedimos que voc ajude no desenvolvimento do MySQL adquirindo algum n e ivel de suporte. Sentimos que se banco de dados MySQL ajudou os seus negcios, razovel o e a pedirmos que voc ajude a MySQL AB. (De outra forma, se voc nos pedir suporte, voc no e e e a s estar usando de graa algo em que colocamos muito trabalhom mas tambm pedindo o a c e que lhe forneamos suporte de graa tambm). c c e

1.4.4 Logomarcas e Marcas Registradas da MySQL AB

Muitos usurios do banco de dados MySQL deseja mostar o logo do golnho da MySQL AB a em seus web sites,livros ou produtos fechados. Isto bem vindo, mas deve haver anotaes e co indicando que a palavra MySQL e o logo do golnho da MySQL so marcas registradas da a MySQL AB e s podem ser usadas como indicado na nossa pol o itica de marcas registradas em http://www.mysql.com/company/trademark.html.

1.4.4.1 O Logo Original do MySQL

O logo do golnho do MySQL foi desenhado pela Finnish advertising agency Priority em 2001. O golnho foi escolhido como um s imbolo para o baco de dados MySQL j que ele a esperto, rpido e um animal gil, se esforndo em navegar pelos oceanos de dados. Ns e a a a o tambm gostamos de golnos. e O logo original MySQL s podem ser usados pr representates da MySQL AB e aqueles que o possuem um acordo escrito permitndo-os de faz-lo. e

1.4.4.2 Logomarcas da MySQL que Podem Ser Usadas Sem Permisso de Alterao a ca
Projetamos um conjunto de logos especiais de Uso Condicionale que podem se encontrados em nosso site web em http://www.mysql.com/press/logos.html e usado em sites web de terceiros sem permisses de escrita da MySQL AB. O uso destas logomarcas no o a so totalmente irrestritas mas, como o nome indica, sujeitos a nossa politica de marcas a registradasque tambm est dispon e a ivel em nosso site. Voc deve ler a pol e itica de marcas registradas se plabeja us-las. As exigncias so basicamente as apresentadas aqui: a e a Use a logomarca que voc preciisa como mostrado no site http://www.mysql.com/. e Voc pode mudar sua escala para servir as suas necessidades, mas no pode alterar e a cores ou o desenho, ou alterar os gracos de forma alguma.

Cap tulo 1: Informaes Gerais co

21

Deixe evidente que voc, e no a MySQL AB, o criado e proprietrio do site que mostra e a e a a logomarca do MySQL. No use a logomarca em detrimento ` MySQL AB ou ao valor das marcas registradas da a a MySQL AB. Nos reservamos o direito de revogar o diretiro de uso da marcas registradas da MySQL AB. Se voc utilizar as maracas em um site da web, faa com que ele contenha um link para e c http://www.mysql.com/. Se voc utilizar o banco de dados MySQL sob GPL em uma aplicao, sua aplicao deve e ca ca ser Open Source deve estar apta a conectar a um servidor MySQL. Contate-nos via e-mail em trademark@mysql.com para saber sobre os nosso acordos especiais que sirvam as suas necessidades.

1.4.4.3 Quando Voc Precisa de Permisso de Alterao para Usar e a ca as Logomarcas do MySQL?
Voc precisa de permisso escrita da MySQL AB antes de usar as logomarcas do MySQL nos e a seguintes casos: Quando exibir qualquer logomarca da MySQL AB em qualquer lugar diferente so seu site. Quando exibir qualquer logomarca da MySQL AB exceta as de Uso Condicional mencionadas anteiormente em sites ou outro lugar. Devido a razes comerciais e legais monitoramos o so das marcas registradas do MySQL o em proutos, livros e outros itens. Normalmente exigimos um valor para a exibio das ca logomarcas da MySQL AB em produtos comerciais, j que achamos razovel que parte dos a a rendimentos seja retornado para nanciar o desenvolvimento do banco de dados MySQL.

1.4.4.4 Logomarcas dos Parceiros da MySQL AB

As logomarcas de parceria do MySQL podem ser usados apenas por companhias e pessoas que possuem um acordo de parceria por escrito com a MySQL AB. Parceiras incluem certicao ca com treinador ou consultor do MySQL. Para mais informaes, Seo 1.3.1.5 [Partnering], co ca Pgina 15. a

1.4.4.5 Usando a Palavra MySQL em Texto Impresso ou Apresentao ca

A MySQL AB considera bem vindas as referncias ao banco de dados MySQL mas deve ser e indicado que a palavra MySQL uma marca registrada da MySQL AB. Por isto, voc deve e e adicionar o simbolo de marca registrada (TM) ao primeiro ou mais proeminente uso da palavra MySQL em um texto e, onde apropriadom indicar que MySQL uma marca rege istrada da MySQL AB. Para mais informaes, veja nossa pol co itica de marcas registradas em http://www.mysql.com/company/trademark.html.

22

MySQL Technical Reference for Version 5.0.0-alpha

1.4.4.6 Usando a Palavra MySQL em Nomes de Companhias e Produtos

O uso da palavra MySQL em nomes de produtos ou companias ou em dominios de Internet no permitida sem permisso escrita da MySQL AB. a e a

1.5 Mapa de Desenvolvimento do MySQL

Esta seo fornece uma amostra do mapa de desenvolvimento do MySQL, incluindo princa cipais recursos imlementados ou planejados para o MySQL 4.0, 4.1, 5.0 e 5.1. A seguinte seo fornece informao para cada distribuio. O planejamento para alguns dos recursos ca ca ca mais requisitados esto listada na tabela a seguir. a Feature Unions Subqueries R-trees Stored procedures Views Cursors Foreign keys Triggers Full outer join Constraints MySQL version 4.0 4.1 4.1 (para tabelas MyISAM) 5.0 5.0 ou 5.1 5.0 5.1 (3.23 com InnoDB) 5.1 5.1 5.1

1.5.1 MySQL 4.0 in a Nutshell

Muito aguardado por nossos usurios, o MySQL Server 4.0 agora est dispon a a ivel em sua verso de produo. a ca O MySQL 4.0 est dispon a ivel para download em http://www.mysql.com/ e nossos sites mirrors. O MySQL tem sido testado por um grande nmero de usurios e est em uso em u a a mutios sites. Os principais novos recursos do MySQL Server 4.0 so trabalhados em conjunto com os a usurios corporativos e da comunidade, melhorando o programa de banco de dados MySQL a como uma soluo para misses cr ca o iticas e sistemas de bancos de dados de alta carga. Outros novos recursos visam os usurios de bancos de dados embutidos. a O MySQL 4.0 foi declarado estvel para uso em produo a partir da verso 4.0.12 em a ca a Maro de 2003. Isto signica que, no futuro, apenas correo de erros sero feitas para a c ca a distribuio da srie 4.0 e apenas correo de erros cr ca e ca iticos sero feitas para a antiga srie a e 3.23. Veja Seo 2.5.2 [Upgrading-from-3.23], Pgina 123. ca a Novos recursos para o MySQL est sendo adicionado ao MySQL 4.1 que tambm est a e a (verso alfa). Veja Seo 1.5.2 [MySQL 4.1 Nutshell], Pgina 24. disponivel a ca a

Cap tulo 1: Informaes Gerais co

23

1.5.1.1 Recursos Dispon iveis no MySQL 4.0

Aumento da velocidade O MySQL 4.0 tem uma cache de consultas que pode dar uma grande aumento na velocidade de aplicaes com consutas repetitivas. Veja Seo 6.9 co ca [Query Cache], Pgina 625. a A verso 4.0 aumenta a velocidade do MySQL Server em um nmero e a u reas tais como INSERTs em bloco, buscas em a indices empacotados, criao ca de indices FULLTEXT, e COUNT(DISTINCT). Introduo ao Servidor MySQL Embutido ca A nova biblioteca do Servidor Ebutido pode ser facilmente usada em aplicaes standalone e embarcadas. O servidor embutido fornce uma co alternativa para o uso do MySQL em um ambiente cliente/servidor. Veja Seo 1.5.1.2 [Nutshell Embedded MySQL], Pgina 24. ca a Mecanismo de armazenamento InnoDB como padro a O mecanismo de armazenamento InnoDB oferecido como um recurso e padro do servidor MySQL. Isto signica suporte a transaes ACID, chaves a co estrangeiras com UPDATE/DELETE em cacata e lock de registro agora so recursos padres. Veja Seo 7.5 [InnoDB], Pgina 643. a o ca a Novas fncionalidades A melhora das propriedades de busca FULLTEXT do MySQL Server 4.0 habilita indexao FULLTEXT de grandes partes de texto com linguagem ca natural e binria de lgica de busca. Voc pode personalizar o tamanho a o e minimo de palavras e denir a sua prpria lista de palavras de parasa em o qualquer linguagem humana, habilitando um novo conjunto de aplicaes co a serem constru idas no MySQL Server. Veja Seo 6.8 [Fulltext Search], ca Pgina 619. a Compatibilidade com os padres, portabilidade e migrao o ca Recursos para simplicar a migrao de outros sistemas de banco de dados ca para o MySQL Server incluem TRUNCATE TABLE (como no Oracle) Muitos usurios tambm caro satisfeitos ao perceber que o MySQL a e a Server agora suporta a instruo UNION, um recurso padro SQL muito ca a esperado. O MySQL agora pode ser executado nativamente na plataforma Novell NetWare 6.0. Veja Seo 2.6.8 [Novell NetWare], Pgina 164. ca a Internacionalizao ca Nossos usurios alemes, austr a a iacos e suios notaro que o MySQL agora c a suporta um novo conjunto de caracteres, latin1_de, que assegura que a Ordena~o em alem~o classicar palavras com umlauts na mesma ordem ca a a das agendas telefnicas alems. o a Aprimoramento da Usabilidade No porcesso de construo de recursos para novos usurios, no esquecemos os ca a a pedidos de nossa leal comunidade de usurios. a

24

MySQL Technical Reference for Version 5.0.0-alpha

A maioria dos parmetros mysqld (opes de inicializao) agora podem a co ca ser denidas se nalizar o servidor. Isto um recurso conveniente para e Administradores de Bancos de Dados (DBAs). Veja Seo 5.5.6 [SET OPca TION], Pgina 460. a Instrues DELETE e UPDATE multi-tabelas foram adicionadas. co Foi adicionado suporte ao mecanismo de armazenamento MyISAM para link simblico no n de tabela (e no apenas a n de banco de dados como o ivel a ivel antes) e para habilitar o tratamento de links simblicos no Windows por o padro. a SQL_CALC_FOUND_ROWS e FOUND_ROWS() so novas funes que tornaram a co poss encontrar o nmeros de linhas que uma consulta SELECT que inclui ivel u uma clusula LIMIT teria retornado se a clusula no fosse utilizada. a a a A seo de novidades deste manual inclui uma lista mais aprofundada dos recursos. Veja ca Seo D.3 [News-4.0.x], Pgina 966. ca a

1.5.1.2 Servidor Embutido MySQL

libmysqld faz o MySQL Server adequado para uma grande rea de aplicaes. Usando a a co biblioteca do servidor MySQL embutido, pode embarcar o MySQL Server em vrios aplicaa tivos e dispositivos eletrnicos, onde o usurio nal no tm conhecimento de possuir um o a a e banco de dados bsico. O servidor MySQL embutido ideal para uso nos bastidores em a e aplicaes de Internet, quiosques pblicos, responsvel por unidades de combinao hardco u a ca ware/software, servidores Internet de alta performance, banco de dados de auto-conteno ca distribu idos em CDROM, e assim por diante Muitos usurios da libmysqld se benciaro da iLicena Dual do MySQL. Para aqueles a a c que no desejam ser limitar pela GPL, o software tambem est dispon sob uma licena a e a ivel c comercial. A biblioteca embutida do MySQL tambm usa a mesma interface que a biblioteca e do cliente normal, sendo ento conveniente e fcil de usar. Veja Seo 12.1.15 [libmysqld], a a ca Pgina 864. a

1.5.2 MySQL 4.1 in a Nutshell

MySQL Server 4.0 prepara a criao de novos recursos como subqueries e Unicode (impleca mentado na verso 4.1) e o funcionamento de stored procedures do SQL-99 est sendo feito a a para a verso 5.0. Estes recursos esto no topo da lista de recursos desejados de muitos de a a nossos clientes. Com estas adies, os cr co iticos do MySQL Database Server devem ser mais imaginativos que nunca para apontar as decincias do MySQL Database Management System. J conhecido e a por sua estabilidadem velocidade e facilidade de uso, o MySQL Server estar apto a atender a as necessidades de vrios compradores exigentes. a

1.5.2.1 Recursos Dispon iveis no MySQL 4.1

Os recursos listados nesta seo esto implementados no MySQL 4.1. Outros poucos recurca a sos esto planejados para o MySQL 4.1. Veja Seo 1.6.1 [TODO MySQL 4.1], Pgina 27. a ca a

Cap tulo 1: Informaes Gerais co

25

A maioria dos novos recursos em codicao, como stored procedures, estaro dispon ca a iveis no MySQL 5.0. Veja Seo 1.6.2 [TODO MySQL 5.0], Pgina 27. ca a Suporte a subqueries e tabelas derivadas Uma subquery uma instruo SELECT aninhada dentro de outras ine ca strues. Uma tabela dericada (unnamed view) uma subquery na clusula co e a FROM de outras instrues. Veja Seo 6.4.2 [Subqueries], Pgina 570. co ca a Aumento na velocidade Protocols binrios mais rpidos com instrues preparadas e parmetros a a co a de ligao. Veja Seo 12.1.4 [C API Prepared statements], Pgina 828. ca ca a Indexao BTREE agora suportado por tabelas HEAP, aumentando de forma ca e signicante o tempo de resposta para busca que no so exatas. a a Nova funcionalidade CREATE TABLE tabela1 LIKE tabela2 lhe permite criar uma nova tabela com a estrutura exatamente igual a de uma tabela existente, usando um unico comando. Suporte aos tipos espaciais OpenGIS (dados geogrcos). Veja Cap a ptexi tulo 10 [Spatial extensions in MySQL], Pgina 733. a A replicao pode ser feita sobre conexo SSL. ca a Compatibilidade aos padres, portabilidade e migrao o ca O novo protocolo cliente/servidor adiciona a possibilidade de se passar mltiplos avisos ao cliente, no lugar se um unico resultado. Isto faz com u que o trabalho como uma grande carga de dados seja muito mais fcil a de rastrear. SHOW WARNINGS exibe avisos para o ultimo comando. Veja Seo 4.6.8.9 [SHOW WARNINGS], Pgina 323. ca a Internacionalizao ca Para suportar nossa base de usurio sempre em expanso usando linguagens a a locais nas aplicaes, o programa MySQL agora oferece suporte Unicode co extensivo por meio dos conjunto de caracteres utf8 e ucs2. Os conjuntos de caracteres agora podem ser denidos por colunas, tabelas e banco de dados. Isto permite um alto grau de exibilidade no desenho das aplicaes, particularmente para sites-web multi-linguagens. co Para documentao sobre este suporte a conjunto de caracters aprimorados, ca veja Capptexi tulo 9 [Charset], Pgina 710. a Aprimoramento da usabilidade Em resposta a demanda popular, adicionamos um comando HELP com base no servidor que pode ser usado para conseguir ajuda para comandos MySQL. A vantagem de se ter esta informao no lado do servidor ca e que a informao sempre aplicvel para aquela verso do servidor em parca e a a ticular. Como esta informao est dispon executando uma instruo ca a ivel ca SQL, outros clientes tambm podero ser escritos para acess-la. Por exe a a emplo, o cliente mysql de linha de comando foi modicado para ter esta capacidade.

26

MySQL Technical Reference for Version 5.0.0-alpha

No novo protocolo cliente/servidor, vrias instrues podem ser feitas a co com uma unica chamada. Veja Seo 12.1.8 [C API multiple queries], ca Pgina 855. a O novo protocolo cliente/servidor tambm suporta retorno de vrios resule a tados. Isto pode ocorrer como resultado de enviar vrias instrues, por a co exemplo (Veja o item anterior). Uma nova sintaxe INSERT ... ON DUPLICATE KEY UPDATE ... tem sido implementada. Isto lhe permite executar um UPDATE em um registro existente se o um INSERT criasse uma chave ( indice) primria (PRIMARY) ou unica a (UNIQUE) (index) duplicada. Veja Seo 6.4.3 [INSERT], Pgina 579. ca a Projetamos uma nova funo de agrupamento GROUP_CONCAT(), adicioca nando a capacidade de concatenar colunas de registros agrupados em uma unica string de resultado, o que extremamente util. Veja Seo 6.3.7 e ca [Group by functions and modiers], Pgina 555. a A seo de novidades neste manual incluem uma lista mais completa de recursos. Veja ca Seo D.2 [Novidades na verso 4.1.x], Pgina 957. ca a a

1.5.2.2 Stepwise Rollout

Novos recursos esto sendo adicionados ao MySQL 4.1. A verso Alfa j st dispon para a a a a ivel download. Veja Seo 1.5.2.3 [Nutshell Ready for Immediate Use], Pgina 26. ca a O conjunto de recursos que esto sendo adicionados a verso 4.1 esto, na maioria, cora a a rigidos. Desenvolvimento adicional j est em andamento na verso 5.0. O MySQL 4.1 a a a passam pelos passos de Alfa (tempo no qual os novos recursos ainda podem ser adionados/alterados), Beta (quando j implementamos todos os recursos e apenas correes de a co erros so realizados0) e Gamma (indicando que ima distribuio de produo est quase a ca ca a pronta). No m deste processo, o MySQL 4.1 se tornar o nova distribuio de produo). a ca ca

1.5.2.3 Pronto para Uso em Desenvolvimento Imediato

O MySQL 4.1 est atualmente no estgio alfa e os binrios esto dispon a a a a iveis para download em http://www.mysql.com/downloads/mysql-4.1.html. Todas as distribuies binrias co a passaram por nossos extensivos teste sem nenhum erro na plataforma em que testamos. Veja Seo D.2 [Novidades na verso 4.1], Pgina 957. ca a a Para aqueles que desejam usar o fonte mais recente do desenvolvimento do MySQL 4.1, deixamos nosso repositrio do BitKeeper publicamente dispon o ivel. Veja Seo 2.3.4 [Installing ca source tree], Pgina 100. a

1.5.3 MySQL 5.0, A Prxima Distribuio de Desenvolvimento o ca

O novo desenvolvimento para o MySQL est focado na distribuio 5.0, comrecursos como a ca Stored Procedures entre outros. Veja Seo 1.6.2 [TODO MySQL 5.0], Pgina 27. ca a Para aqueles que desejam dar uma olhada no desenvolvimento do MySQL, deixamos o nosso repositrioo do BitKeeper para o MySQL verso 5.0 dispon publicamente. Veja o a ivel Seo 2.3.4 [Instalando a rvore fonte], Pgina 100. ca a a

Cap tulo 1: Informaes Gerais co

27

1.6 MySQL e o Futuro (o TODO)

Esta seo lista os recursos que planejamos impementar no MySQL Server. As listas so ca a apresentadas por verso, e os itens esto aproximadamente na ordem em que sero feitos. a a a Nota: Se voc um usurio corporativo com uma necessidade urgente de um recurso paree a ticular, por favor, contate sales@mysql.com para conversarmos sobre patroc inio. Financiamento feito por uma ou mais companhias nos permite alocar recursos adicionais para aquele propsito espec o ico. Um exemplo de um recurso patrocinado no passado a replicao. e ca

1.6.1 Novos Recursos Planejados Para a Verso 4.1 a

Os recursos abaixo ainda no esto implementados no MySQL 4.1, mass esto planejados a a a para implementao antes que o MySQL 4.1 v para a fase beta. Para uma lista do que j ca a a est feito no MySQL 4.1, veja Seo 1.5.2.1 [Nutshell 4.1 features], Pgina 24. a ca a Suporte OpenSSL estvel (o MySQL 4.0 tem suporte rudimentar ao OpenSSL, no a a testado 100%). Mais teste de instrues preparadas co Mais testes de mltiplos conjunto de caracteres para uma tabela. u

1.6.2 Novos Recursos Planejados Para a Verso 5.0 a

Os seguintes recursos esto planejados para incluso no MySQL 5.0. Note que como posa a suimos diversos desenvolvedores que esto trabalhando em diferentes projetos, havero a a tambm muitos recursos adicionais. H tambm um pequena chance qie alguns destes e a e recursos sejam adicionados ao MySQL 4.1. Para uma lista do que j est feito no MySQL a a 4.1, veja Seo 1.5.2.1 [Nutshell 4.1 features], Pgina 24. ca a Para aqueles que desejam dar uma olhada nas novidades do desenvolvimento do MySQL, deixamos nosso repositrio BitKeeper para o MySQL verso 5.0 publicamente dispon o a ivel. Veja Seo 2.3.4 [Instalando a rvore fonte], Pgina 100. ca a a Stored Procedures Stored procedures esto sendo implementadas atualmente. Este esforo a c e baseado no SQL-99, o que tem m sintaxe bsica similar (mas no idntica) a a a e do Oracle PL/SQL. Ns tambm implementaremos o framework do SQL-99 o e para enganchar em linguagens externas e (onde poss ivel) compatibilidade com p.ex. PL/SQL e T-SQL. Nova funcionalidade Suporte a cursores elementares. A habilidade de especicar explicitamente para tabelas MyISAM que um indice deve ser criado como um indice RTREE. Na verso 4.1, a indices RTREE so usados internamente para dados geomtricos (tipos de dados GIS), mas a e no podem ser criados no pedido. a Registros de tamanhos dinmicas para tabelas HEAP. a

28

MySQL Technical Reference for Version 5.0.0-alpha

Compatibilidade com o padro, portabilidade e migrao a ca Adiciona suporte real a VARCHAR (tamanho de colunas maiores que 255, e sem corte de espaos em branco extras). (J existe suporte para isto nos c a mecanismos de armazenamento do MyISAM, mas ainda no est dispon a a ivel de usurio). a nivel a Aumento na velocidade SHOW COLUMNS FROM nome_tabela (usado pelo cliente mysql para permitir expanses de nomes de colunas) no deve abrir a tabela, apenas o arquivo o a de denio. ISto exigir menos memria e ser muito mais rpido. ca a o a a Permite que o DELETE em tabelas MyISAM usem a cache de registros. Para fazer isto, precisamos atualizar a thread da cache de registro quando atualizarmos os arquivos .MYD. Melhores tabes em memria (HEAP): o Registro de tamanhos dinmoicos. a Tratamento de registro mais rpido (menos cpia). a o Internacionalizao ca Ap usar SET CHARACTER SET devemos traduzir toda a consulta de uma vez e no apenas as strings. Isto permitir que os usurios usem caracteres a a a traduzidos nos nomes de banco de dados, tabelas e colunas. Aprimoramento da usabilidade Resolver a questo de RENAME TABLE em uma tabela usada em uma tabela a MERGE ativa, o que possivelmente corrompe a tabela.

1.6.3 Novos Recursos Planejados Para a Verso 5.1 a

Novas funcionalidades Suporte FOREIGN KEY para todos os tipos de tabelas. Restries a n de colunas. co ivel Replicao seguro a falhas. ca Backup online com baixa queda de desempenho. O backup online tornar a mais fcil adicionar um novo slave de replicao sem desligar o master. a ca Aumento de velocidade Novo formato dos arquivos de denio e tabelas baseados em texto (arca quivos .frm) e uma cache de tabelas para a denio de tabelas. Isto nos ca permitir fazer consultas mais rpidas da estruturas de tabela e dar um a a suporte a chaves estrangeiras mais eciente. Otimizar o tipo BIT para gastar 1 bit (agora BIT gasta 1 byte; e tratado e como um sinnimo para TINYINT.) o Aprimoramento da usabilidade Adicionar opes ao protocolo cliente/servidor para obter notas de proco gresso para longos comandos em execuo. ca Implementar RENAME DATABASE. Para tornar isto seguro para todos os mecanismos de armazenamento, ele deve funcionar como a seguir:

Cap tulo 1: Informaes Gerais co

29

Cria um novo banco de dados. Para cada tabelas, renomeie-a para outro banco de dados, o qual fazemos com o comando RENAME. Apagar o banco de dados antigo. Nova alterao da interface de arquivo interno. Isto far todos os manipca a uladores de arquivos mais gerais e tornar mais fcil adicionar extenses a a o tipo RAID.

1.6.4 Novos Recursos Planejados Para a Verso em um Futuro a Prximo o

Novas funcionalidade Comando como do Oracle CONNECT BY PRIOR ... para estruturas de busca tipo rvore (hierrquica) a a Adicionar todos os tipos que faltam do SQL-92 e ODBC 3.0. Adicionar SUM(DISTINCT). INSERT SQL_CONCURRENT e mysqld --concurrent-insert para fazer uma insero concorrente no m do arquivo se o arquivo tiver lock de leitura. ca Permitir a atualizao de variveis nas instrues UPDATE. Por exemplo: ca a co UPDATE TABLE foo SET @a=a+b,a=@a, b=@a+c. Alterar quando as variveis de usurios so atualizadas e assim pode se usa a a a las com GROUP BY, como no exemplo a seguir: SELECT id, @a:=COUNT(*), SUM(sum_col)/@a FROM nome_tabela GROUP BY id. Adicionar a opo IMAGE a LOAD DATA INFILE para no atualizar campos ca a TIMESTAMP e AUTO_INCREMENT. Adicionar a sintaxe LOAD DATA INFILE ... UPDATE que funciona assim: Para tabelas com chaves primrias, se o registro de entrada contm um a e valor de chave primria, linhas existentes correspondendo `s chaves a a primrias so atualizadas para o restante das colunas de entrada. No a a entanto, colunas faltosas na insero dos registros de entradas no ca a so alteradas. a Para tabelas com chaves primrias, se um registro de entrada no a a contm um valor de chave primria ou estr faltando alguma parte da e a a chave, o registro tratado como um LOAD DATA INFILE ... REPLACE e INTO. Fazer com que LOAD DATA INFILE entenda a sintaxe do tipo: LOAD DATA INFILE file_name.txt INTO TABLE tbl_name TEXT_FIELDS (text_field1, text_field2, text_field3) SET table_field1=CONCAT(text_field1, text_field2), table_field3=23 IGNORE text_field3 Isto pode ser usado para saltar colunas extras no arquivo texto, ou atualizar colunas baseadas nas expresses dos dados lidos. o

30

MySQL Technical Reference for Version 5.0.0-alpha

Novas funes para tyrabalhar com tipos de colunas SET: co ADD_TO_SET(valor,conjunto) REMOVE_FROM_SET(valor,conjunto) Se voc abortar o mysql no meio de uma consulta, voc deve abrir outra e e conexo e matar a consulta antiga em execuo. Alternativamente, deve a ca ser feita um tentativa de deteco deste problema no servidor. ca Adicione um interface do mecanismo de armazenamento para informaes co da tabela assim que voc puder us-la como uma tabela de sistema. Isto see a ria um pouco mais lento se voc pedisse informaes sobre todas as tabelas, e co mas muito ex ivel. SHOW INFO FROM tbl_name para informaes bsicas co a das tabelas deve ser implementado. Permite SELECT a FROM crash_me LEFT JOIN crash_me2 USING (a); neste caso considerado que a vem da tabela crash_me. e Opes DELETE e REPLACE para a instruo UPDATE (isto deletar registros co ca a quando se tiver um erro de chave duplicada durante a atualizao). ca Altera o formato de DATETIME para armazenar fraes de segundo. co Possibilitar o uso da nova biblioteca regexp GNU em vez da atual (a biblioteca GNU deve ser muito mais rpida que a antiga). a Compatibilidade com os padres, portabilidade e migrao o ca No adicionar valores DEFAULT automticos as colunas. Enviar um erro ao a a usar um INSERT que no contenha uma coluna que no tenha um DEFAULT. a a Adicionar as funes de agrupamento ANY(), EVERY() e SOME(). No padro co a SQL isto s funciona em colunas booleanas, mas podemos extend-las para o e funcionar em qualquer coluna/expresso tratando valores 0 como FALSE a e valores diferentes de 0 como TRUE. Corrigir para que o tipo de MAX(coluna) seja o mesmo do tipo da coluna: mysql> mysql> mysql> mysql> CREATE TABLE t1 (a DATE); INSERT INTO t1 VALUES (NOW()); CREATE TABLE t2 SELECT MAX(a) FROM t1; SHOW COLUMNS FROM t2;

Aumento de velocidade No permitir mais que um nmero denido de threads faam a recuperao a u c ca do MyISAM ao mesmo tempo. Alterar INSERT ... SELECT opcionalmente. para usar inseres co concorrentes

Adicionar uma opo para descarregar paginas de chaves para tabelas com ca delayed keys se elas no forem usados por um tempo. a Permitir joins em partes de chaves (otimizao). ca Adicionar simulao de pread()/pwrite() no Windows para permitir ca inseres concorrentes. co Um analizador de arquivos de log que possam analizar informaes sobre co quais tabelas so usadas com mais frequncia, a frequncia com que joins a e e

Cap tulo 1: Informaes Gerais co

31

multi-tables so executados, etc. Isto deve ajudar os usurios a identia a car reas ou projetos de tabelas que podiam ser otimizados para executar a consultas muito mais ecientes. Internacionalizao ca Aprimoramentos de usabilidade Retorna os tipos dos campos originais ao se fazer SELECT MIN(coluna) ... GROUP BY. Possibilita especicar long_query_time com uma granularidade em microsegundos. Ligue o cdigo myisampack no servidor assim ele poder realizar operaes o a co PACK e COMPRESS. Adicionar uma cache de chaves temporria durante INSERT/DELETE/UPDATE a para podermos fazer um recuperao se o ca indice car cheio. Se voc realizar um ALTER TABLE em uma tabela que ligada simbolicae e mente a outro disco, crie tabelas tenporrias neste disco. a Implementar um tipo DATE/DATETIME que trate as informaes de fusos co horrios de forma apropriada e assim lidar com datas em diferentes fusos a horrios ser mais fcil. a a a Corrigir o congure para se poder compilar todas as bibliotecas (como no MyISAM) sem threads. Permitir variveis SQL em LIMIT, como em LIMIT @a,@b. a Sa automtica do mysql para um navegador web. ida a LOCK DATABASES (com diversas opes). co Muito mais variveis para SHOW STATUS. Leitura e atualizao de rega ca istros. Selects em 1 tabela e select com joins. Nmero de tabelas na select. u Nmero de consultas ORDER BY e GROUP BY. u mysqladmin copy database novo-banco_dados; exige que o comando COPY seja adicionado ao mysqld. Lista de processos deve mostar o nmero de consultas/threads. u SHOW HOSTS para xibir informaes sobre a cache de nome de mquina. co a Alterar o nome de tabelas de string vazias para NULL para colunas calculadas. No usar Item_copy_string em valores numricos para evitar a converso a e a number->string->number no casos de: SELECT COUNT(*)*(id+0) FROM nome_tabela GROUP BY id Alterar aqueles ALTER TABLE que no abortam clientes que executam a INSERT DELAYED. Colunas refernciadas em uma clusula UPDATE iro conter os valores antie a a gos antes da atualizao iniciar. ca Novos sistemas operacioais. Portar os clientes MySQL para LynxOS.

32

MySQL Technical Reference for Version 5.0.0-alpha

1.6.5 Novos Recursos Planejados Para a Verso em um Futuro a a Mdio Prazo e

Implementar funo: get_changed_tables(timeout,table1,table2,...) ca Alterar leitura atravs de tabelas para usar mapeamento de memria quando poss e o ivel. Atualmente somente tabelas compactadas usam mapeamento de memria. o Tornar o cdigo de timestamp automtico melhor. Adicionar timestamps para o log o a de atualizaes com SET TIMESTAMP=#; co Usar mutex de leitura/escrita em alguns lugares para obter maior velocidade. Views simples (inicialmente em uma tabela, depois em qualquer expresso). Veja a Seo 1.8.4.6 [ANSI di Views], Pgina 51. ca a Fechar algumas tabelas automaticamente se uma tabela, tabela temporria ou arquivos a temporrios obtiverem o erro 23 (no pode abrir arquivos sucientes). a a Melhor propagao de constantes. Quando uma ocorrncia de nome_col=n encontrada ca e e em uma expresso, para algumas constantes n, substitua outras ocorrncias de nome_ a e col dentro da expresso por n. Atualmente, isto feito somente para alguns casos a e simples. Alterar todas expresses const com expresses calculadas se poss o o ivel. Chave otimizadora = expresso. No momento somente a chave = campo ou a chave = a constante so otimizadas. a Melhorar o cdigo de algumas das funes de cpia o co o Alterar sql_yacc.yy para um analizador em linha para reduzir seu tamanho e obter melhores mensagems de erro (5 dias). Alterar o analisador para usar somente uma regra para diferentes nmeros de arguu mentos em uma funo. ca Utilizar nomes de clculo completos na parte de ordenao. (For ACCESS97) a ca MINUS, INTERSECT e FULL OUTER JOIN. (Atualmente UNION [na 4.0] e LEFT OUTER JOIN so suportados). a SQL_OPTION MAX_SELECT_TIME=# para colocar um limite de tempo em uma pesquisa. Fazer o log de atualizaes gravar em um banco de dados. co LIMIT negativo para recuperar dados do m. Alarmes em funes clientes de conexo, leitura e escrita. co a Por favor, perceba as alteraes ao mysqld_safe: de acordo com o FSSTND (que o co Debian tenta seguir) arquivos PID dever ir em /var/run/<progname>.pid e arquivos de log em /var/log. Seria timo se voc puder colocar o diretrio de dados na o e o primeira declarao de "pidle" e "log", para que a colocao destes arquivos possa ca ca ser alterada com uma simples instruo. ca Permitir um cliente requisitar log. Adicionar uso de zlib() a LOAD DATA INFILE, para permitir que as instrues leiam co arquivos compactados com gzip. Corrigir ordenao e agrupamento de colunas BLOB (parcialmente resolvida agora). ca Alterar para o uso de semforos quando contar threads. Devemos primeiro implementar a uma biblioteca de semforos para a MIT-pthreads. a

Cap tulo 1: Informaes Gerais co

33

Adicionar suporte pleno para JOIN com parnteses. e Como uma alternativa para uma thread / conexo gerencie uma la de threads para a manipular as pesquisas. Permitir obter mais de um bloqueio com GET_LOCK. Quando isto for feito, sero, a tambm, tratados os poss e iveis deadlocks que essa alterao ir acarretar. ca a O tempo fornecido de acordo com a quantidade de trabalho, e no tempo real. e a

1.6.6 Novos Recursos que No Planejamos Fazer a

Nada; Planejamos ser totalmente compat iveis com o ANSI 92 / ANSI 99.

1.7 Fontes de Informaes do MySQL co

1.7.1 Listas de Discusso MySQL a
Esta seo introduz a lista de deiscusso do MySQL e d algumas explicaes sobre como a ca a a co lista deve ser utilizada. Quando voc se inscreve na lista de discusso, voc receber, como e a e a mensagens de email, tudo o que enviado para a lista. Voc tambm poder enviar suas e e e a prprias dvidas e respostas para a lista. o u

1.7.1.1 As Listas de Discusso do MySQL a

Para se inscrever ou cancelar a inscrio de qualquer uma das listas de email descritas nesta ca seo, visite http://lists.mysql.com/. Por favor, no envie mensagem sobre inscrio ca a ca ou cancelamento para qualquer das listas de emasil, porque tais mensagens so distribu a idas automaticamente para milhares de outros usurios. a Seu site local pode ter muitas inscries para uma lista de email do MySQL. Se sim, o site co pode ter uma lista de email local, assim as mensagens enviadas para lists.mysql.com do seu site so propagadas para a lista local. Nestes casos, por favor, contate seu administrador a de sistema para adicionado ou excluido da lista local do MySQL. Se voc quiser que as mensagens da lista de discusso sejam enceminhadas para uma caixa e a de correio separada no seu programa de emails, congure um ltro com base nos cabealhos c das mensagens. Voc pode tambm usar os cabealhos List-ID: ou Entregar-Para: para e e c identicar suas mensagens. Existe tambm as seguintes listas de discusso sobre MySQL atualmente: e a announce Esta para anuncio de novas verses do MySQL e programas relacionados. e o Esta uma lista com baixo volume na qual todos usuarios do MySQL deveriam e se inscrever. A principal lista para discusses MySQL em geral. Note que alguns tpicos so o o a mais bem discutidos em listas mais especializadas. Se voc enviar para a lista e errada voc pode no obter resposta. e a

mysql

34

MySQL Technical Reference for Version 5.0.0-alpha

mysql-digest A lista mysql na forma resumida. Isto signica que voc ir receber todas e a mensagens individuais, enviadas na forma de uma grande mensagem uma unica vez ao dia. bugs Esta lista s ser do seu interesse se voc quiser car informado sobre assuntos o a e relatados desde a ultima distribuio do MySQL ou se voc quiser estar ativa ca e mente envolvido no processo de busca e correo de erros. Veja Seo 1.7.1.3 ca ca [Relatrio de erros], Pgina 36. o a

bugs-digest Uma verso resumida da lista bugs. a internals Uma lista para pessoas que trabalham no cdigo do MySQL. Nesta lista pode-se o discutir desenvolvimento do MySQL e pos-patches. internals Uma verso resumida da lista internals. a mysqldoc Esta lista para pessoas que trabalham na documentao do MySQL: pessoas e ca da MySQL AB, tradutores e outros membros da comunidade.

mysqldoc-digest Esta uma verso resumida da lista mysqldoc. e a benchmarks Esta lista para qualquer um interessado em assuntos de desempenho. Dise cusses concentradas em desempenho de banco de dados (no limitado ao o a MySQL) mas tambm inclue categorias ,com desempenho do kernel, sistema e de arquivos, sistema de disco e outros. benchmarks Esta uma verso resumida da lista benchmarks. e a packagers Esta lista para discusses sobre empacotamento e distribuio do MySQL. e o ca Este o frum usado pela pessoas que mantm a distribuio para troca de e o e ca idias de pacotes do MySQL e para assegurar que o MySQL esteja o mais e parecido poss em todas as plataformas e sistemas operacionais suportados. ivel packagers-digest Esta uma verso resumida da lista packagers. e a java Discusso sobre o servidor MySQL e Java. E mais usada para discusses sobre a o o driver JDBC, incluindo MySQL Connector/J. java-digest Uma verso resumida da lista java. a win32 Esta a lista para todos os tpicos relacionados ao MySQL em sistemas operae o cionais Microsoft, como o Win95, Win98, NT e Win2000.

win32-digest Uma verso resumida da lista win32. a

Cap tulo 1: Informaes Gerais co

35

myodbc

Lista para todos os tpicos relacionados a conectividade do MySQL com ODBC. o

myodbc-digest Uma verso resumida da lista myodbc. a mysqlcc Esta lista sobre todos os tpicos relativos ao cliente grco MySQL Control e o a Center.

mysqlcc-digest Esta lista uma verso resumida da lista mysqlcc. e a plusplus Lista sobre todos os tpicos relacionados ` programao da API C++ para o o a ca MySQL.

plusplus-digest Uma verso resumida da lista plusplus. a msql-mysql-modules Lista sobre o Suporte MySQL no Perl com o msql-mysql-modules que e chamado DBD-mysql. msql-mysql-modules-digest Lista resumida sobre a verso do msql-mysql-modules. a Se voc no obtiver uma resposta para suas questes na lista de mensagens do MySQL, uma e a o opo pagar pelo suporte da MySQL AB, que ir colocar voc em contato direto com ca e a e desenvolvedores MySQL. Veja Seo 1.4.1 [Suporte], Pgina 17. ca a A seguinte tabela mostra algumas listas de mensagens sobre o MySQL que utilizam linguas diferentes do Ingls. Perceba que elas no so operadas pela MySQL AB, portanto, no e a a a podemos garantir a qualidade destas. mysql-france-subscribe@yahoogroups.com Lista de mensagens na l ingua francesa. list@tinc.net Lista de mensagens coreana. Envie subscribe mysql your@email.address para esta lista. mysql-de-request@lists.4t2.com Lista de mensagens alem~. a Envie subscribe mysql-de your@email.address para esta lista. Voc pode encontrar informaes sobre esta lista de mensagens em e co http://www.4t2.com/mysql. mysql-br-request@listas.linkway.com.br Lista de mensagens em portugus Envie subscribe mysql-br your@email.address para esta lista. e mysql-alta@elistas.net Lista de mensagens espanhola. Envie subscribe mysql your@email.address para esta lista.

1.7.1.2 Fazendo perguntas ou relatando erros

Antes de enviar um relato de erro ou uma questo, por favor faa o seguinte: a c Comece pesquisando o manual MySQL online em: http://www.mysql.com/doc/

36

MySQL Technical Reference for Version 5.0.0-alpha

Ns tentaremos manter o manual atualizado, frequentemente atualizando-o com o solues para novos problemas encontrados! O apndice de histrico de mudanas co e o c (http://www.mysql.com/doc/en/News.html) pode ser util j que bem poss que a e ivel uma verso mais nova ja tenha a soluo para o seu problema. a ca Procure no banco de dados de bugs em http://bugs.mysql.com/ para ver se o erro j foi relatado/resolvido. a Pesquise os arquivos das listas de mensagens MySQL: http://lists.mysql.com/ Voc pode tambm usar a pgina http://www.mysql.com/search.html para e e a pesquisar todas as pginas Web (incluindo o manual) que esto localizados em a a http://www.mysql.com/. Se voc no puder encontrar uma resposta no manual ou nos arquivos, conra com seu e a expert em MySQL local. Se voc continua no encontrando uma resposta para sua questo, e a a v em frente e leia a prxima seo para saber como enviar email para lista de email do a o ca MySQL.

1.7.1.3 Como relatar erros ou problemas

Nosso banco de dados de bugs publico e pode ser pesquisado por qualquer um em e http://bugs.mysql.com/. Se voc logar no sistema, voc poder entrar novos relatrios. e e a o Escrever um bom relatrio de erro exige pacincia, e faz-lo de forma apropriada economiza o e e tempo para ns e para voc. Um bom relatrio de erros contendo um teste de caso para o o e o bug ir torn-lo muito mais fcil para corrig no prximo release. Esta seo ir ajud-lo a a a i-lo o ca a a a escrever seu relatrio corretamente para que voc no perca seu tempo fazendo coisas que o e a no iro ajudar-nos muito ou nada. a a Ns encorajamos todo mundo a usar o script mysqlbug para gerar um relato de erros (ou um o relato sobre qualquer problema), se poss ivel. mysqlbug pode ser encontrado no diretrio o scripts na distribuio fonte, ou, para uma distribuio binria, no diretrio bin no ca ca a o diretrio de instalao do MySQL. Se voc no puder utilizar o mysqlbug (por exemplo, o ca e a se voc o estiver executando no Windows), ainda de vital importncia que voc incluia e e a e todas as informaes necessrias listadas nesta seo (o mais importante uma descrio co a ca e ca do sistema operacional e a verso do MySQL). a O script mysqlbug lhe ajudar a gerar um relatrio determinando muitas das seguintes a o informaes automaticamente, mas se alguma coisa importante estiver faltando, por favor co fornea-o junto de sua mensagem! Por favor leita esta seo com cuidado e tenha certeza c ca que todas as informaes descritas aquie esto inclu co a idas no seu relatrio. o De preferncia, voc deve testar o problema usando a ultima verso de produo ou desene e a ca volvimento do Servidro MySQL antes do envio. Qualquer um deve estar apto a repetir o erro apenas usando mysql test < script no caso de teste incluido ou executando o script sheel ou Perl que inclu no relatrio de erros. e ido o Todos os erros enviados para o banco de dados dem bugs em http://bugs.mysql.com/ sero corrigidos ou documentados na prxma distribuio do MySQL. Se apenas pequenas a o ca mudanas de cdigo forem necessrias enviaremos um patch para corrigir o problema. c o a

Cap tulo 1: Informaes Gerais co

37

O lugar comum para relatar erros e problemas http://bugs.mysql.com. e Se voc encontrar um erro de segurana no MySQL, envie um email para e c security@mysql.com. Se voc tiver um relatrio de erro que possa ser repetido, relate-o no banco de dados de bugs e o em http://bugs.mysql.com. Note que mesmo neste caso bom executar o script mysqlbug e primeiro para ter informaes sobre o sistema. Qualquer erro que pudermos repetir tem co uma grande chance de ser corrigido na prxima distribuio do MySQL. o ca Para relatar outros problemas, voc pode usar a lista de email do MySQL. e Lembre-se que poss responder a uma mensagem contendo muita informao, mas no e ivel ca a a uma contendo muito pouca. Frequentemente pessoas omitem fatos porque acreditam que conhecem a causa do problema e assumem que alguns detalhes no importam. Um bom a principio : Se voc est em dvida sobre declarar alguma coisa, declare-a ! E milhares de e e a u vezes mais rpido e menos problemtico escrever um pouco de linhas a mais no seu relatrio a a o do que ser forado a perguntar de novo e esperar pela resposta porque voc no forneceu c e a informao suente da primeira vez. ca Os erros mais comuns acontecem porque as pessoas no indicam o nmero da verso da a u a distribuio do MySQL que esto usando, ou no indicam em qual plataforma elas tem ca a a o MySQL instalado (Incluindo o nmero da verso da plataforma). Essa informao u a ca e muito relevante, e em 99% dos casos o relato de erro intil sem ela! Frequentemente ns e u o recebemos questes como, Por que isto no funciona para mim? ento ns vemos que o a a o aquele recurso requisitado no estava implementado naquela verso do MySQL, ou que o a a erro descrito num relatrio foi resolvido em uma verso do MySQL mais nova. Algumas o a vezes o erro dependente da plataforma; nesses casos, quase imposs corrigir alguma e e ivel coisa sem conhecimento do sistema operacional e o nmero da verso da plataforma. u a Lembre-se tambm de fornecer informaes sobre seu compilador, se isto for relacionado e co ao problema. Frequentemente pessoas encontram erros em compiladores e acreditam que o problema relacionado ao MySQL. A maioria dos compiladores esto sobre desenvolvimento e a todo o tempo e tornam-se melhores a cada verso. Para determinar se o seu problema a depende ou no do compilador, ns precisamos saber qual compilador foi usado. Note que a o todo problema de compilao deve ser estimado como relato de erros e, consequentemente ca publicado. E de grande ajuda quando uma boa descrio do problema inclu no relato do erro. Isto ca e ida , um bom exemplo de todas as coisas que o levou ao problema e a correta descrio do e ca problema. Os melhores relatrios so aqueles que incluem um exemplo completo mostrando o a como reproduzir o erro ou o problema Veja Seo E.1.6 [Casos de teste reproduz ca iveis], Pgina 1084. a Se um programa produz uma mensagem de erro, muito importante incluir essas mensagens e no seu relatrio! Se ns tentarmos procurar por algo dos arquivos usando programas, o o e melhor que as mensagens de erro relatadas sejam exatamente iguais a que o programa produziu. (At o caso deve ser observado!) Voc nunca deve tentar lembrar qual foi a e e mensagem de erro; e sim, copiar e colar a mensagem inteira no seu relatrio! o Se voc tem um problema com o MyODBC, voc deve tentar gerar um arquivo para e e rastremento de erros (trace) do MyODBC. Veja Seo 12.2.7 [MyODBC bug report], ca Pgina 879. a

38

MySQL Technical Reference for Version 5.0.0-alpha

Por favor lembre-se que muitas das pessoas que lero seu relatrio podem usar um v a o ideo de 80 colunas. Quando estiver gerando relatrios ou exemplos usando a ferramenta de linha o de comando mysql, ento dever usar a opo --vertical (ou a instruo terminadora \G) a a ca ca para sa que ir exceder a largura dispon para este tipo de v ida a ivel ideo (por exemplo, com a instruo EXPLAIN SELECT; veja exemplo abaixo). ca Por favor inclua a seguinte informao no seu relatrio: ca o O nmero da verso da distribuio do MySQL que est em uso (por exemplo, MySQL u a ca a Version 3.22.22). Voc poder saber qual verso vocs est executando, usando o e a a e a comando mysqladmin version. mysqladmin pode ser encontrado no diretrio bin o sob sua instalao do MySQL. ca O fabricante e o modelo da mquina na qual voc est trabalhando. a e a O nome do sistema operacional e a verso. Para a maioria dos sistemas operacionais, a voc pode obter esta informao executando o comando Unix uname -a. Se voc trae ca e balho no Windows, voc pode normalmente conseguir o nome e o nmero da verso com e u a um duplo clique sobre o icone Meu Computador e em seguida no menu Ajuda/Sobre o Windows. Algumas vezes a quantidade de memria (real e virtual) relevante. Se estiver em o e dvida, inclua esses valores. u Se voc estiver usando uma distribuio fonte do MySQL, necessrio o nome e nmero e ca e a u da verso do compilador usado. Se voc estiver usando uma distribuio binria, a e ca a e necessrio o nome da distribuio. a ca Se o problema ocorre durante a compilao, inclua a(s) exata(s) mensagem(s) de erro(s) ca e tambm algumas linhas do contexto envolvendo o cdigo no arquivo onde o erro e o ocorreu. Se o mysqld nalizou, voc dever relatar tambm a consulta que travou o mysqld. e a e Normalmente voc pode encontrar isto executando mysqld com o log habilitado. Veja e Seo E.1.5 [Using log les], Pgina 1083. ca a Se alguma tabela do banco de dados estiver relacionado ao problema, inclua a sa de ida mysqldump --nodata nome_db nome_tbl1 nome_tbl2.... Isto muito fcil de fazer e a e um modo poderoso de obter informaes sobre qualquer tabela em um banco de e co dados que ir ajudar-nos a criar uma situao parecida da que voc tem. a ca e Para problemas relacionados ` velocidade ou problemas com instrues SELECT, voc a co e sempre deve incluir a sa de EXPLAIN SELECT ... e ao menos o nmero de linhas que ida u a instruo SELECT produz. Voc tambm deve incluir a sa de SHOW CREATE TABLE ca e e ida nome_tabela para cada tabela envolvida. Quanto mais informao voc fornecer sobre ca e a sua situao, mais fcil ser para algum ajudar-lo! A seguir um exemplo de um ca a a e relatrio de erros muito bom (ele deve ser postado com o script mysqlbug): o Exemplo de execuo usando a ferramenta de linha de comando mysql (perceba o uso ca do instruo terminadora \G para instrues cuja largura de sa deva ultrapassar 80 ca co ida colunas): mysql> SHOW VARIABLES; mysql> SHOW COLUMNS FROM ...\G <saida para SHOW COLUMNS> mysql> EXPLAIN SELECT ...\G

Cap tulo 1: Informaes Gerais co

39

<saida para EXPLAIN> mysql> FLUSH STATUS; mysql> SELECT ...; <Uma pequena vers~o da sada do SELECT, a i incluindo a hora em que a consulta foi executada> mysql> SHOW STATUS; <saida do SHOW STATUS> Se um erro ou problema ocorrer quando estiver executando o mysqld, tente fornecer um script de entrada que ir reproduzir a anomalia. Este script deve incluir qualquer ara quivo de fonte necessrio. Quanto mais prximo o script puder reproduzir sua situao, a o ca melhor. Se voc puder fazer uma srie de testes repetidos, voc poder post-lo para o e e e a a bugs@lists.mysql.com para um tratamento de alta prioridade! Se no puder fornecer o script, voc ao menos deve incluir a sa de mysqladmin a e ida variables extended-status processlist na sua mensagem para fornecer alguma informao da performance do seus sistema. ca Se voc no puder produzir um caso de teste em algumas linhas, ou se a tabela de e a testes for muito grande para ser enviada por email para a lista de mensagens (mais de 10 linhas), voc dever dar um dump de suas tabelas usando o mysqldump e criar um e a arquivo README que descreve seu problema. Crie um arquivo comprimido de seus arquivos usando tar e gzip ou zip, e use o ftp para transferir o arquivo para ftp://support.mysql.com/pub/mysql/secret/. E envie uma pequena descrio do problema para bugs@lists.mysql.com. ca Se voc achar que o MySQL produziu um resultado estranho para uma consulta, no e a inclua somente o resultado, mas tambm sua opinio de como o resultado deve ser, e e a uma conta descrevendo o base de sua opinio. a Quando fornecer um exemplo do problema, melhor usar os nomes de variveis, nomes e a de tabelas, etc. utilizados na sua situao atual do que enviar com novos nomes. O ca problema pode ser relacionado ao nome da varivel ou tabela! Esses casos so raros, a a mas melhor prevenir do que remediar. Alm disso, ser mais fcil para voc fornecer e e a a e um exemplo que use sua situao atual, que o que mais importa para ns. No caso ca e o de ter dados que no deseja mostrar para outros, voc pode usar o ftp para transferia e lo para ftp://support.mysql.com/pub/mysql/secret/. Se os dados so realmente a condenciais, e voc no deseja mostr-los nem mesmo para ns, ento v em frente e e a a o a a providencie um exemplo usando outros nome, mas, por favor considere isso como uma unica chance. Inclua, se poss ivel, todas as opes fornecidas aos programas relevantes. Por exemplo, co indique as opes que voc utiliza quando inicializa o daemon mysqld e aquelas que so co e a utilizadas para executar qualquer programa cliente MySQL. As opes para programas co como o mysqld e mysql, e para o script configure, so frequentemente chaves para a respostas e so muito relevantes! Nunca uma m idia inclu a e a e i-las de qualquer forma! Se voc usa algum mdulo, como Perl ou PHP por favor fornea o nmero da verso e o c u a deles tambm. e Se sua questo relacionada ao sistema de privilgios, por favor fornea a sa a e e c ida de mysqladmin reload, e todas as mensagens de erro que de mysqlaccess, a saida

40

MySQL Technical Reference for Version 5.0.0-alpha

voc obteve quando tentava conectar! Quando voc testar seus privilgios, voc deve e e e e primeiramente executar mysqlaccess. Depois, execute mysqladmin reload version e tente conectar com o programa que gerou o problema. mysqlaccess pode ser encontrado no diretrio bin sob seu diretrio de instalao do MySQL. o o ca Se voc tiver um patch para um erro, isso bom, mas no assuma que o patch e e a e tudo que precisamos, ou que iremos us-lo, se voc no fornecer algumas informaes a e a co necessrias, como os casos de testes mostrando o erro que seu patch corrige. Ns a o podemos encontrar problemas com seu patch ou ns podemos no entend-lo ao todo; o a e se for assim, no podemos us-lo. a a Se ns no vericarmos exatamente o que o patch quer dizer, ns no poderemos uso a o a a lo. Casos de testes iro ajudar-nos aqui. Mostre que o patch ir cuidar de todas as a a situaes que possam ocorrer. Se ns encontrarmos um caso (mesmo que raro) onde o co o patch no funcionaria, ele pode ser intil. a u Palpites sobre qual o erro, porque ocorre, ou do que ele depende, geralmente esto e a errados. Mesmo o time MySQL no pode adivinhar antecipadamente tais coisas sem a usar um debugger para determinar a causa real do erro. Indique na sua mensagem de e-mail que voc conferiu o manual de referncia e o arquivo e e de mensagens para que outros saibam que voc tentou solucionar o problema. e Se voc obter um parse error, por favor conra sua sintaxe com ateno! Se e ca voc no conseguiu encontrar nada errado com ela, extremamente provvel e a e a que que sua verso corrente do MySQL no suporte a consulta que voc a a e est utilizando. a Se voc estiver usando a verso recente e o manual em e a http://www.mysql.com/documentation/manual.php no cobrir a sintaxe que a voc estiver usando, o MySQL no suporta sua consulta. Neste caso, suas unicas e a opes so implementar voc mesmo a sintaxe ou enviar uma mensagem para co a e mysql-licensing@mysql.com e perguntar por uma oferta para implement-lo! a Se o manual cobrir a sintaxe que voc estiver usando, mas voc tiver uma verso mais e e a antiga do MySQL, voc dever conferir o histrico de alteraes do MySQL para ver e a o co quando a sintaxe foi implementada. Neste caso, voc tem a opo de atualizar para e ca uma nova verso do MySQL. Veja Apndice D [News], Pgina 957. a e a Se voc tiver um problema do tipo que seus dados aparecem corrompidos ou voc e e obtem erros quando voc acessa alguma tabela em particular, voc dever primeiro e e a checar depois tentar reparar suas tabelas com myisamchk ou CHECK TABLE e REPAIR TABLE. Veja Cap ptexi tulo 4 [MySQL Database Administration], Pgina 207. a Se voc frequentemente obtm tabelas corrompidas, e e voc deve tene tar encontrar quando e porque isto acontece! Neste caso, o arquivo mysql-data-directory/hostname.err deve conter algumas informaes co sobre o que aconteceu. Veja Seo 4.10.1 [Error log], Pgina 372. Por favor fornea ca a c qualquer informao relevante deste arquivo no seu relatrio de erro! Normalmente ca o o mysqld NUNCA dever danicar uma tabela se nada o nalizou no meio de uma a atualizao! Se voc puder encontrar a causa do m do mysqld, se torna muito mais ca e fcil para ns fornecemos a voc uma soluo para o problema! Veja Seo A.1 [What a o e ca ca is crashing], Pgina 911. a Se poss ivel, faa o download e instale a verso mais recente do MySQL para saber se c a ela resolve ou no o seu problema. Todas verses do MySQL so muito bem testadas a o a

Cap tulo 1: Informaes Gerais co

41

e devem funcionar sem problemas! Acreditamos em deixar tudo, o mais comptivel a poss ivel com as verses anteriores, e voc conseguir mudar de verses MySQL em o e a o minutos! Veja Seo 2.2.4 [Which version], Pgina 80. ca a Se voc um cliente de nosso suporte, por favor envio o seu relatrio de erros em e e o mysql-support@mysql.com para tratamento de alta prioritrio, bem como para a lista de a mensagens apropriada para ver se mais algum teve experincias com (e talvez resolveu) o e e problema. Para informaes sobre relatar erros no MyODBC, veja Seo 12.2.4 [ODBC Problems], co ca Pgina 873. a Para solues a alguns problemas comuns, veja Veja Apndice A [Problems], Pgina 911. co e a Quando respostas so enviadas para voc individualmente e no para a lista de mensagens, a e a e considerado boa etiqueta resumir as respostas e enviar o resumo para a lista de mensagens para que outras possam ter o benef icio das respostas que voc recebeu que ajudaram a e resolver seu problema!

1.7.1.4 Guia para responder questes na lista de discusso o a

Se voc considerar que sua respota possa ter um amplo interesse, voc pode querer post-la e e a para a lista de mensagens em vez de responder diretamente para a pessoa que perquntou. Tente deixar sua resposta da forma mais genrica poss e ivel para que outras pessoas alm e da que postou a pergunda possam se beneciar dela. Quando voc postar para a lista, por e favor tenha certeza que sua resposta no uma rplica de uma resposta anterior. a e e Tente resumir a parte essencial da questo na sua resposta, no se sinta obrigado a citar a a a mensagem original inteira. Por favor no poste mensagens a partir de seu browser com o modo HTML ligado! Muitos a usurios no leem e-mail com browser! a a

1.7.2 Suporte a Comunidade MySQL Atrvs do IRC (Internet e Relay Chat)

Em adio as diversas listas de email, voc pode pessoas experientes da comunidade no IRC ca e (Internet Relay Chat). Estes so os melhores canais atualmente conhecidos por ns: a o freenode (veja http://www.freenode.net/ para servidores) #mysql A princ so questes sobre o MySQL, mas dvidas sobre outros bancos ipio a o u de dados e SQL so bemvindas. a #mysqlphp Questes sobre MySQL+PHP, uma combinao popular. o ca #mysqlperl Questes sobre MySQL+Perl, outra combinao popular. o ca EFnet (veja http://www.efnet.org/ para servidores) #mysql Questes sobre MySQL. o Se voc est procurando por programas clientes de IRC para conectar a uma rede IRC, d e a e uma olhada no X-Chat (http://www.xchat.org/). X-Chat (licena GPL) est dispon c a ivel para as plataformas Unix e Windows.

42

MySQL Technical Reference for Version 5.0.0-alpha

1.8 Qual compatibilidade aos padres o MySQL oferece ? o

Esta seo descreve como o MySQL se relaciona aos padres ANSI/ISO SQL. O Servidor ca o MySQL tem muitas extenses aos padres SQL, e aqui voc descobrir quais so elas, e como o o e a a us-las. Voc ir tambm encontrar informao sobre falta de funcionalidade do Servidor a e a e ca MySQL, e como trabalhar com algumas diferenas. c Nosso objetivo no restringir, sem um boa razo, a usabilidade do MySQL Server para e a a qualquer uso. Mesmo se no tivermos os recursos para fazer o desenvolvimento para todos a os usos poss iveis, estamos sempre querendo ajudar e oferecer sugestes para pessoas que o esto tentando usar o MySQL Server em novos territrios. a o Um dos nossos principais objetivos com o produto continuar a trabalhar em acordo com e o padro SQL-99, mas sem sacricar velocidade e conana. No estamos receosos em a c a adicionar extenses ao SQL ou suporte para recursos no SQL se ele aumentar extremamente o a a usabilidade do MySQL Server para uma grande parte de nossos usurios. (A nova interface a HANDLER no MySQL Server 4.0 um exeemplo desta estratgia. Veja Seo 6.4.9 [HANDLER], e e ca Pgina 595.) a Continuaremos a suportar bancos de dados transacionais e no transacionais para satisfazer a tanto o uso pesado na web quanto o uso de misso cr a itica 24/7. O MySQL Server foi projetado inicialmente para trabalhar com bancos de dados de tamanho mdio (10-100 milhes de registros ou cerca de 100 MB por tabela) em sistemas computae o cionais pequenos. Continuaremos a extender o MySQL Server para funcionar ainda melhor com banco de dados na ordem de terabytes, assim como tornar poss compilar uma verso ivel a reduzida do MySQL mais apropriadas para handhels e uso embutido. O design compacto do servidor MySQL tornam ambas as direes poss co iveis sem qualquer conito na rvore a fonte. Atualmente no estamos buscando suporte em tempo real (mesmo se voc j puder fazer a e a muitas coisas com nossos servios de replicao). c ca Suporte a banco de dados em cluster est planejado para 2004 pela implementao de um a ca novo mecanismo de armazenamento. Estamos buscando melhoras no fornecimento de suporte a XML no servidor de banco de dados.

1.8.1 Qual Padro o MySQL Segue? a

Entry-level SQL-92. ODBC levels 0-3.51. We are aiming toward supporting the full SQL-99 standard, but without concessions to speed and quality of the code.

1.8.2 Executando o MySQL no modo ANSI

Se voc inicializa o mysqld com a opo --ansi ou --sql-mode=ANSI, o seguinte compore ca tamento alterado no MySQL: e || um oprador de concatenao de strings em vez de um sinnimo para OR. e ca o

Cap tulo 1: Informaes Gerais co

43

" tratado como um caracter identicados (com o caracter de aspasr do MySQL e Server)e no um caracter de string. Voc ainda pode usar para citar identicadores a e no modo ANSI. Uma implicao disto que voc no pode usar aspas duplas para citar ca e e a um string literal, porque ela ser intepretada como um identicador. a Voc pode ter qualquer nmero de espaos entre um nome de funo e o (. Isto e u c ca faz com que todos nomes de funes sejam tratadas como palavras reservadas. Como co resultado, se voc quiser acessar qualquer banco de dados, tabelas ou coluna que uma e e palavra reservada, voc deve coloc-lo entre aspas. Por exemplo, por haver a funo e a ca USER(), o nome da tabela user no banco de dados mysql e a coluna User nesta tabela se torna reservada, assim voc deve coloc-la entre aspas: e a SELECT "User" FROM mysql."user"; REAL um sinnimo para FLOAT no lugar de um sinnimo de DOUBLE. e o o O n de isolamento padro de um transao SERIALIZABLE. Veja Seo 6.7.6 [SET ivel a ca e ca TRANSACTION], Pgina 619. a Voc pode usar um campo/expresso em GROUP BY que no est na lista de campos. e a a a Executando o servidor em modo ANSI o mesmo que inici-lo com estas opes: e a co --sql-mode=REAL_AS_FLOAT,PIPES_AS_CONCAT,ANSI_QUOTES, IGNORE_SPACE,ONLY_FULL_GROUP_BY --transaction-isolation=serializable No MySQL 4.1, voc pode conseguir o mesmo efeito com estas duas instrues: e co SET GLOBAL TRANSACTION ISOLATION LEVEL SERIALIZABLE; SET GLOBAL sql_mode= "REAL_AS_FLOAT,PIPES_AS_CONCAT,ANSI_QUOTES,IGNORE_SPACE,ONLY_FULL_GROUP_BY"; No MySQL 4.1.1 a ultima opo sql_mode tambm pode ser dada com: ca e SET GLOBAL sql_mode="ansi"; No caso acima o sql_mode estar congurado com todas as opes que so relevantes para a co a o modo ANSI. Voc pode vericar o resultado fazendo: e

mysql> SET GLOBAL sql_mode="ansi"; mysql> SELECT @@GLOBAL.sql_mode; -> "REAL_AS_FLOAT,PIPES_AS_CONCAT,ANSI_QUOTES,IGNORE_SPACE,ONLY_FULL_GROUP_

1.8.3 Extenses do MySQL para o Padro SQL-92 o a

O MySQL fornece algumas extenses que voc provavelmente no ir encontrar em alguns o e a a bancos de dados SQL. Fique avisado que se voc us-las, seu cdigo pode no ser mais e a o a portvel para outros servidores SQL. Em alguns casos, voc pode escrever cdigo que inclui a e o extenses MySQL, mas continua portvel, usando comentrios da forma /*! ...*/. Neste o a a caso, o MySQL ir analisar e executar o cdigo com o comentrio como ir fazer com a o a a qualquer outra instruo MySQL, mas outros servidores SQL iro ignorar as extenses. ca a o Por exemplo: SELECT /*! STRAIGHT_JOIN */ nome_campo FROM table1,table2 WHERE ... Se voc adicionar um nmero de verso depois do !, a sintaxe s ser executada se a e u a o a verso do MySQL igual ou maior que o nmero de verso usado: a e u a

44

MySQL Technical Reference for Version 5.0.0-alpha

CREATE /*!32302 TEMPORARY */ TABLE t (a INT); O exemplo acima signica que se voc tiver uma verso do MySQL 3.23.02 ou mais nova, e a ento o MySQL ir usar a palavra-chave TEMPORARY a a Extenses MySQL so listadas abaixo: o a Os tipos de campo MEDIUMINT, SET, ENUM e os diferentes tipos BLOB e TEXT. Os atributos de campos AUTO_INCREMENT, BINARY, NULL, UNSIGNED e ZEROFILL. Todas comparaes de strings por padro so caso insensitivo, com classicao ordeco a a ca nada determinada pelo conjunto de caracteres corrente (ISO-8859-1 Latin1 por padro). a Se voc no gosta disso voc dever declarar suas colunas com o atributo BINARY ou e a e a usar o operador BINARY, que fazendo com que as comparaes sejam feitas de acordo co com a ordem ASCII usada na mquina servidora do MySQL. a O MySQL mapeia cada banco de dados em um diretrio sob o diretrio de dados do o o MySQL, e tabelas internamente num banco de dados para arquivos no diretrio do o banco de dados. Isto tem algumas implicaes: co Nomes de bancos de dados e tabelas so caso sensitivoo no MySQL em sistemas a operacionais que possuem o sistema de arquivos caso sensitivoo (como na maioria dos sistemas Unix). Veja Seo 6.1.3 [Name case sensitivity], Pgina 473. ca a Nomes de Bancos de dados, tabelas, indices, campos ou apelidos pode comear c com um digito (porm no podem consistir somente de digitos). e a Voc pode usar comandos padro do sistemas para fazer backups, renomear, apagar e a e copiar tabelas. Por exemplo, para renomear uma tabela, renomeie os arquivos .MYD, .MYI e .frm. para o nome da tabela correspondente. co e Em algumas instrues SQL, voc pode acessar tabelas de diferentes bancos de dados com a sintaxe nome_bd.nome_tbl. Alguns servidores SQL fornecem a mesma funcionalidade mas chamam isto de User space. O MySQL no suporta tablespaces como a em: create table ralph.my_table...IN minha_tablespace. LIKE permitido em campos numricos. e e O uso de INTO OUTFILE e STRAIGHT_JOIN em uma instruo SELECT. Veja Seo 6.4.1 ca ca [SELECT], Pgina 562. a A opo SQL_SMALL_RESULT em uma instruo SELECT. ca ca EXPLAIN SELECT para obter uma descrio de como as tabelas so ligadas. ca a A utilizao de nomes de indices, indices em um prexo de um campo, e uso de INDEX ca ou KEY em uma instruo CREATE TABLE. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca ca a O uso de TEMPORARY ou IF NOT EXISTS com CREATE TABLE. O uso de COUNT(DISTINCT lista) onde lista maior que um elemento. e O uso de CHANGE nome_campo, DROP nome_campo, ou DROP INDEX, IGNORE ou RENAME em uma instruo ALTER TABLE. Veja Seo 6.5.4 [ALTER TABLE], Pgina 608. ca ca a O uso de RENAME TABLE. Veja Seo 6.5.5 [RENAME TABLE], Pgina 612. ca a Utilizao de mltiplas clusulas ADD, ALTER, DROP, ou CHANGE em uma instruo ALTER ca u a ca TABLE. O uso de DROP TABLE com as palavras-chave IF EXISTS.

Cap tulo 1: Informaes Gerais co

45

Voc pode remover mltiplas tabelas com uma instruo unica DROP TABLE. e u ca As clusulas ORDER BY e LIMIT das instrues UPDATE e DELETE. a co Sintaxe INSERT INTO ... SET col_name = .... A clusula DELAYED das instrues INSERT e REPLACE. a co A clusula LOW_PRIORITY das instrues INSERT, REPLACE, DELETE e UPDATE. a co O uso de LOAD DATA INFILE. Em alguns casos essa sintaxe compat com o Oracle e ivel LOAD DATA INFILE. Veja Seo 6.4.8 [LOAD DATA], Pgina 588. ca a As intrues ANALYZE TABLE, CHECK TABLE, OPTIMIZE TABLE, e REPAIR TABLE. co A instruo SHOW. Veja Seo 4.6.8 [SHOW], Pgina 302. ca ca a Strings podem ser fechadas pelo " ou , no apenas pelo . a O uso do meta-caractere de escape \. A instruo SET OPTION. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca ca a Voc no precisa nomear todos os campos selecionados na parte GROUP BY. Isto fornece e a melhor performance para algumas consultas espec icas, mas muito comuns. Veja Seo 6.3.7 [Group by functions and modiers], Pgina 555. ca a Pode ser especicado ASC e DESC com o GROUP BY. Para tornar mais fcil para usurios que venham de outros ambientes SQL, o MySQL a a suporta apelidos (aliases) para vrias funes. Por exemplo, todas funes de string a co co suportam as sintaxes ANSI SQL e ODBC. O MySQL entende os operadores || e && como ou(OR) e e(AND) logicos, como na linguagem de programao C. No MySQL, || e OR so sinnimos, assim como && e ca a o AND. Devido a esta tima sintaxe, o MySQL no suporta o operador ANSI SQL para o a concatenao de strings ||; em vez disso, use o CONCAT(). Como CONCAT() aceita ca vrios argumentos, fcil converter o uso do operador || para MySQL. a e a CREATE DATABASE or DROP DATABASE. Veja Seo 6.5.1 [CREATE DATABASE], Pgina 597. ca a O operador % um sinnimo para MOD(). Isto , N % M equivalente a MOD(N,M). % e o e e e suportado para programadores C e para compatibilidade com o PostgreSQL. Os operadores =, <>, <= ,<, >=,>, <<, >>, <=>, AND, OR ou LIKE podem ser utilizados em comparaes de campos a esquerda do FROM nas instrues SELECT. Por exemplo: co co mysql> SELECT col1=1 AND col2=2 FROM nome_tabela; A funo LAST_INSERT_ID(). Veja Seo 12.1.3.32 [mysql_insert_id()], Pgina 803. ca ca a Os operadores extendidos REGEXP e NOT REGEXP utilizados em expresses regulares. o CONCAT() ou CHAR() com um ou mais de dois argumentos. (No MySQL, estas funes co receber qualquer nmero de argumentos.) u As funes BIT_COUNT(), CASE, ELT(), FROM_DAYS(), FORMAT(), IF(), PASSWORD(), co ENCRYPT(), MD5(), ENCODE(), DECODE(), PERIOD_ADD(), PERIOD_DIFF(), TO_DAYS() ou WEEKDAY(). Uso de TRIM() para cortar substrings. o SQL-99 s suporta remoo de caracteres o ca unicos. As funes do GROUP BY: STD(), BIT_OR(), BIT_AND() e BIT_XOR() e GROUP_CONCAT(). co Veja Seo 6.3.7 [Group by functions and modiers], Pgina 555. ca a

46

MySQL Technical Reference for Version 5.0.0-alpha

Uso de REPLACE no lugar de DELETE + INSERT. Veja Seo 6.4.7 [REPLACE], Pgina 587. ca a As instrues FLUSH, RESET e DO. co A possibilidade de congurar variveis em uma instruo com :=: a ca SELECT @a:=SUM(total),@b=COUNT(*),@a/@b AS media FROM tabela_teste; SELECT @t1:=(@t2:=1)+@t3:=4,@t1,@t2,@t3;

1.8.4 Diferenas do MySQL em Comparao com o SQL-92 c ca

Ns tentamos fazer com que o MySQL siguisse os padres ANSI SQL (SQL-92/SQL-99) e o o o ODBC SQL, mas em alguns casos, o MySQL realiza operaes de forma diferente: co Para campos VARCHAR, expaos extras so removidos quando o valor armazenado. c a e Veja Seo 1.8.6 [Bugs], Pgina 54. ca a Em alguns casos, campos CHAR so alterados sem perguntas para o tipo de campo a VARCHAR. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. ca a Privilgios para uma tabela no so negadas automaticamente quando voc apaga uma e a a e tabela. Voc deve usar explicitamente um REVOKE para negar privilgios para uma e e tabela. Veja Seo 4.4.1 [GRANT], Pgina 254. ca a Para uma lista priorizada indicando quando novas extenses sero adio a cionadas ao MySQL voc deve consultar lista TODO online do MySQL em e http://www.mysql.com/doc/en/TODO.html. Esta a ultima verso da lista TODO neste e a manual. Veja Seo 1.6 [TODO], Pgina 27. ca a

1.8.4.1 Subqueries
MySQL Version 4.1 supports subqueries and derived tables (unnamed views). Veja Seo 6.4.2 [Subqueries], Pgina 570. ca a For MySQL versions prior to 4.1, most subqueries can be successfully rewritten using joins and and other methods. Veja Seo 6.4.2.11 [Rewriting subqueries], Pgina 578. ca a

1.8.4.2 SELECT INTO TABLE

O MySQL ainda no suporta a extenso SQL do Sybase: SELECT ... INTO TABLE .... a a MySQL suporta a sintaxe ANSI SQL INSERT INTO ... SELECT ..., que basicamente a e mesma coisa. Veja Seo 6.4.3.1 [INSERT SELECT], Pgina 581. ca a INSERT INTO tblTemp2 (fldID) SELECT tblTemp1.fldOrder_ID FROM tblTemp1 WHERE tblTemp1.fldOrder_ID > 100; De maneira alternativa, voc pode usar SELECT INTO OUTFILE... ou CREATE TABLE ... e SELECT para resolver seu problema.

1.8.4.3 Transaoes e Operaes Atmicas c co o

O MySQL Server (verso 3.23-max e todas as verses 4.0 e acima) suportam transaes com a o co os mecanismos de armazenamento transacionais InnoDB e BDB. InnoDB fornece compatibilidade total com ACID. Veja Cap ptexi tulo 7 [Tipos de tabelas], Pgina 630. a

Cap tulo 1: Informaes Gerais co

47

Os outros tipos de tabelas no transacionais (tais como MyISAM) no MySQL Server seguem a um paradigma diferente para integridade de dados chamado Oper~es At^micas. Em co o termos de transao, tabelas MyISAM efetivamente sempre operam em modo AUTOCOMMIT=1. ca Operaes atmicas geralmente oferecem integridade comparvel com a mais alta perforco o a mance. Com o MySQL Server suportando ambos os paradigmas, o usurio pode decidir se precisa a da velocidade das operaes atmicas ou se precisa usar recursos transacionais em seu co o aplicativo. Esta escolha pode ser feita em uma base por tabela. Como notado, a comparao para tabelas transacionais vs. no transacionais As noted, ca a the trade o for transactional vs. non-transactional table se encontra em grande parte no desempenho. Tabelas transacionais tem uma exigncia de memria e espao em disco e o c signicantemente maior e maior sobrecarga da CPU. Tipos de tabelas transacionais como InnoDB oferecem muitos recursos unicos. O projeto modular do MySQL Server permite o uso concorrente de todas estes mecanismos de armazenamento para servir a diferentes exigncias e oferecer um timo desempenho em todas as situaes. e o co Mas como fazer uso dos recursos do MySQL Server para manter uma integridade rigorosa mesmo com tabelas MyISAM no transacionais e como este recurso se compara com os tipos a de tabelas transacionais? 1. No paradigma transacional, se as suas aplicaes so escritas de uma forma que co a e dependente na chamada de ROLLBACK em vez de COMMIT em situaes criticas, ento co a transaes so mais convenientes. Alm disso, transaes asseguram que atualizaes co a e co co inacabadas ou atividades corrompidas no sejam executadas no banco de dados; o a servidor oferece uma oportunidade para fazer um rollback automtico e seu banco de a dados mantido. e O MySQL Server, na maioria dos casos, permite a voc resolver potenciais problemas e incluindo simples conferncias antes das atualizaes e executando scripts simples que e co conferem inconsistncias no banco de dados e, automaticamente, repara ou avisa caso e isto ocorra. Perceba que apenas usando o log do MySQL ou mesmo adicionando um log extra, pode-se corrigir tabelas perfeitamente sem nenhuma perda de integridade. 2. Mais do que nunco, atualizaes transacionais fatais podem ser reescritas para serem co atmicas. De fato podemos dizer que todos problemas de integridade que transaes o co resolvem podem ser feitas com LOCK TABLES ou atualizaes atmicas, assegurando que co o voc nunca ir ter uma nalizao automtica da tabela, o que um problema comum e a ca a e em bancos de dados transacionais. 3. Nem mesmo transaes podem prevenir todas as falhas se o servidor cair. Nestes co casos mesmo um sistema transacional pode perder dados. A diferena entre sistemas c diferentes apenas em quo pequeno o lapso de tempo em que eles podem perder e a e dados. Nenhum sistema 100% seguro, somente seguro o suciente. Mesmo o e Oracle, com reputao de ser o mais seguro bancos de dados transacionais, tem relatos ca de algumas vezes perder dados nestas situaes. co Para estar seguro com o MySQL Server, voc apenas deve fazer backups e ter o log e de atualizaes ligado. Com isto voc pode se recuperar de qualquer situao poss co e ca ivel com bancos de dados transacionais. E sempre bom ter backups, independente de qual banco de dados voc usa. e

48

MySQL Technical Reference for Version 5.0.0-alpha

O paradigma transacional tem seus benef icios e suas desvantagens. Muitos usurios e a desenvolvedores de aplicaes dependem da facilidade com a qual eles podem codicar co contornando problemas onde abortar parece ser, ou necessrio. No entanto, se voc e a e novo no paradigma de operaes atmicas ou tem mais familiaridade ou conforto com e co o transaes, considere o benef co icio da velocidade que as tabelas no transacionais podem a oferece, na ordem de 3 a 5 vezes da velocidade que as tabelas transacionais mais rpidas e a otimizadas. Em situaes onde integridade de grande importncia, as atuais caracter co e a isticas do MySQL permitem niveis transacionais ou melhor conana e integridade. Se voc bloquear tabelas c e com LOCK TABLES todos as atualizaes iro ser adiadas at qualquer vericao de inteco a e ca gridade ser feita. Se voc s obter um bloqueio de leitura (oposto ao bloqueio de escrita), e o ento leituras e inseres podero ocorrer. Os novos registros inseridos no podero ser via co a a a sualizados por nenhum dos clientes que tiverem um bloqueio de LEITURA at eles liberarem e estes bloqueios. Com INSERT DELAYED voc pode enleirar inseres em uma la local, at e co e os bloqueios serem liberados, sem que o cliente precise esperar at a insero completar. a ca Veja Seo 6.4.3.2 [INSERT DELAYED], Pgina 582. ca a Atmico, no sentido em que ns mencionamos, no mgico. Signica apenas que voc o o a e a e pode estar certo que enquanto cada atualizao espec ca ica est sendo executada, nenhum a outro usurio pode interferir com ela, e nunca haver um rollback automtico (que pode a a a acontecer em sistemas baseados em transaes se voc no tiver muito cuidado). O MySQL co e a tambm assegura que nunca ocorrer uma leitura suja. e a A seguir esto algumas tcnicas para trabalhar com tabelas no transacionais: a e a Loops que precisam de transaes normalmente pode ser codicados com a ajuda de co LOCK TABLES, e voc no precisa de cursores para atualizar regitros imeditamente. e a Para evitar o uso do ROLLBACK, voc pode usar as seguintes estratgias: e e 1. Use LOCK TABLES ... para fazer um lock todas as tabelas que voc quer acessar. e 2. Condies de teste. co 3. Atualize se estiver tudo OK. 4. Use UNLOCK TABLES para liberar seus locks. Isto normalmente um mtodo muito mais rpido que usar transaes com poss e e a co iveis ROLLBACKs, mas nem sempre. A unica situao que esta soluo no pode tratar ca ca a e quando algum mata a threads no meio de uma atualizao. Neste caso, todas os locks e ca sero liberados mas algumas das atualizao podem no ter sido execuadas. a ca a Voc tambm pode usar funes para atualizar registros em uma unica operao. Voc e e co ca e pode conseguir uma aplicao muito eciente usando as seguintes tcnicas: ca e Modique campos em relao ao seus valores atuais. ca Atualize apenas aqueles campos que realmente tiveram alteraes. co Por exemplo, quando fazemos atualizaes em alguma informao de cliente, atualco ca izamoa apenas os dados do clientes que alteraram e testamos apenas aqueles com dados alterados ou dados que dependem dos dados alterados, mudaram em comparao com o ca registro original. O teste dos dados alterados feito com a clusula WHERE na instruo e a ca UPDATE. Se o registro no foi atualizado, mandamos ao cliente uma mensagem: Some a of the data you have changed has been changed by another user. Ento mostramos o a

Cap tulo 1: Informaes Gerais co

49

registro antigo versus o novo em uma janela, assim o usurio pode decidir qual verso a a do registro de cliente de ser usado. Isto nos d algo similar a lock de colunas mas que, na verdade, melhor porque apenas a e atualizamos algumas das colunas, usando valores relativos ao seu valor atual. Isto signica que instrues UPDATE comuns se parecem com estas: co UPDATE nometabela SET pay_back=pay_back+125; UPDATE customer SET customer_date=current_date, address=new address, phone=new phone, money_he_owes_us=money_he_owes_us-125 WHERE customer_id=id AND address=old address AND phone=old phone; Como voc pode ver, isto muito eciente e funciona mesmo se outro cliente alterar e e os valores nas colunas pay_back ou money_he_owes_us. Em muitos casos, usurios querem fazer ROLLBACK e/ou LOCK TABLES com o propsito a o de gerenciarem identicadores unicos para algumas tabelas. Isto pode ser tratado muito mais ecientemente usando uma coluna AUTO_INCREMENT e tambm uma funo SQL e ca LAST_INSERT_ID() ou a funo da API C mysql_insert_id(). Veja Seo 12.1.3.32 ca ca [mysql_insert_id()], Pgina 803. a Geralmente voc pode codicar evitando lock de registro. Algumas situaes realmente e co precisam disto, e tabelas InnoDB suportam lock de regitstro. Comoo MyISAM, voc e pode usar uma coluna de ag na tabela e fazer algo como a seguir: UPDATE nome_tbl SET row_flag=1 WHERE id=ID; O MySQL retorna 1 para o nmero de linhas afetadas se as linhas foram encontradas u e row_flag j no era 1 na linha original. a a Voc pode pensar nisto como se o MySQL Server tivesse alterado a consulta anterior e para: UPDATE nome_tbl SET row_flag=1 WHERE id=ID AND row_flag <> 1;

1.8.4.4 Stored Procedures e Triggers

Steored procedures esto sendo implementadas em nossa verso 5.0 na rvore de desenvolvia a a mento. Veja Seo 2.3.4 [Instalando da rvore de fontes], Pgina 100. ca a a Este esforo baseado no SQL-99, que tm uma sintaxe bsica similar (mas no idntica) ao c e e a a e Oracle PL/SQL. Em adio a isto, estamoas implementando o framework SQL-99 enganchar ca em linguagens externas. Uma Stored Procedure um conjunto de comandos SQL que podem ser compilados e e armazenados no servidor. Uma fez feito isso, os clientes no necessitam reescrever toda a a consulta mas podem fazer referncia ` stored procedure. Isto fornece melhor performance e a porque a query necessita ser analisada pelo servidor somente uma vez, e necessita menos informao para ser enviada entre o servidor e o cliente. Voc tambm pode elevar o ca e e

50

MySQL Technical Reference for Version 5.0.0-alpha

n ivel conceitual tendo bibliotecas de funes no servidor. No entanto, stored procedures co aumentam a carga no servidor de banco de dados, j que grande parte do trabalho feito a e do lado do servidor e menos do lado do cliente (aplicao). ca Triggers esto programados para serem implementados no MySQL verso 5.1. Um trigger a a um tipo de stored procedure que chamado quando um evento em particular ocorre. e e Por exemplo, voc poderia congurar uma stored procedure que disparada toda vez que e e um registro for apagado de uma tabela transacional que automaticamente apaga o cliente correspondente de uma tabela de clientes quando todas as transaes forem removidas. co

1.8.4.5 Chaves Estrangeiras

No MySQL Server 3.23.44 e posterior, tabelas InnoDB suportam vericao de restrio ca ca de chaves estrangeiras, incluindo CASCADE, ON DELETE, e ON UPDATE. Veja Seo 7.5.5.2 ca [Restries de chaves estrangeiras do InnoDB], Pgina 654. co a Para outros tipos de tabela, o MySQL Server atualmente apenas analisa a sintaxe de FOREIGN KEY no comando CREATE TABLE, mas no usa/armazena esta informao. Em a ca um futuro prximo esta implementao ser estendida para que assim a informao seja o ca a ca armazenada num arquivo de especicao de tabela e possa ser recuperado por mysqldump ca e ODBC. Em um estgio posterior, restries de chaves estrangeiras sero implementadas a co a para tabelas MyISAM. Note que as chaves estrangeiras no SQL no so usadas para ligar tabelas, mas so usadas a a a para vericar a integridade referencial. Se voc deseja obter resultados de mltiplas tabelas e u de uma instruo SELECT, voc pode fazer isto ligando tabelas: ca e SELECT * FROM table1,table2 WHERE table1.id = table2.id; Veja Seo 6.4.1.1 [JOIN], Pgina 567. Veja Seo 3.6.6 [Exemplos de chaves estrangeiras], ca a ca Pgina 198. a Quando usada como uma restrio, FOREIGN KEYs no precisa ser usado se a aplicao insere ca a ca duas linhas em tabelas MyISAM na ordem apropriada. Para tabelas MyISAM, voc pode contornar a falta de ON DELETE adicionando a instruo e ca DELETE apropriada a uma aplicao quando voc deletar registros de uma tabela que tem ca e uma chave estrangeira. Na prtica isto mais rpido e muito mais portvel que utilizar a e a a chaves estrangeiras. No MySQL Server 4.0 voc pode utilizar delees multi-tabela para apagar linha de muitas e co tabelas com um comando. Veja Seo 6.4.5 [DELETE], Pgina 585. ca a A sintaxe FOREIGN KEY sem ON DELETE ... usada geralmente por aplicaces ODBC para e o produzir clusulas WHERE automticas. a a Note que chaves estrangeiras so mal usadas com frequncia, o que pode causar graves a e problemas. Mesmo quando usado apropriadamente, o suporte a chaves estrangeiras no a e uma soluo mgica para o problema de integridade referncial, embora possa ajudar. ca a e Algumas vantagens das chaves estrangeiras: Assumindo o projeto apropriado das relaes, as restries de chaves estrangeiras co co tornaro mais dif para um programador introduzir uma inconsistncia no banco a icil e de dados. Usar atualizaes e delees em cascata pode simplicar o cdigo do cliente. co co o

Cap tulo 1: Informaes Gerais co

51

Regras de chaves estrangeiras projetados apropriadamente ajudam ao documentar a relao entre as tabelas. ca Desvantagens: Erros, que so facis de se ter ao projetar a relao das chaves, podem causar graves a e ca problemaspor exemplo, regras circulares ou a combinao errada de uma deleo em ca ca cascata. Vericao adicional no banco de dados afeta o desempenho, por esta razo algumas ca a das principais aplicaes comerciais codicam sua lgica no n da aplicao. co o ivel ca No incomum para um DBA fazer uma topologia complexa de relaes que torna a e co muito dif e em alguns casos imposs icl, ivel, fazer backup ou restaurar tabelas individuais.

1.8.4.6 Views
Views esto senda implementadas atualmente e aparecero na verso 5.0 e 5.1 do MySQL a a a Server. Historicamente o MySQL Server tem sido mais usado em aplicaes e sistemas web onde o co desenvolvedor da aplicao tem total controle sobre o uso do banco de dados. E claro que o ca uso aumentou em vrias vezes e ento descobrimos que um crescente nmeros de usurios a a u a consideram views como um importante aspecto. Unnamed views (derived tables, uma seubquery na clusula FROM de uma SELECT) j esto a a a implementadas na verso 4.1. a Views geralmente so muito uteis para permitir aos usurios acessar uma srie de relaes a a e co (tabelas) como uma tabela, e limitar o acesso a apenas estas relaes. Views tambm co e podem ser usadas para restringir o acesso aos registros (um subconjunto de uma tabela em particular). Mas views no so necessrias para restringir o acesso a registros j que a a a a o MySQL Server tem um sosticado sistema de privilgios. Veja Seo 4.3 [Sistema de e ca privilgios], Pgina 226. e a Muitos SGBD no permitem atualizar nenhum registro em uma view, mas voc tem que a e fazer as atualizaes em tabelas separadas. co Em nosso projeto de implemtao de views, ns buscamos (tanto quanto for poss dentro ca o ivel do SQL) compatibilidade com Codds Rule #6 para sistemas de banco de dados relacionais: todos os views que so teoricamente atualizveis, devem se atualizados tambm na a a e prtica. a

1.8.4.7 -- como In icio de Comentrio a

Outros bancos de dados SQL usam -- para iniciar comentrios. O MySQL usa # como a o caractere para in de comentrio, mesmo se a ferramenta de linha de comando mysql icio a remover todas linhas que comeam com --. Voc tambm pode usar o comentrio no c e e a estilo C /*isto um comentrio*/ com o MySQL Server. Veja Seo 6.1.6 [Comentrios], e a ca a Pgina 479. a O MySQL Server verso 3.23.3 e superior suporta o estilo de comentrio -- somente se o a a comentrio for seguido por um caractere de espao (ou por um caracter de controle como a c uma nova linha). Isto ocorre porque este estilo de comentrio causou muitos problemas a

52

MySQL Technical Reference for Version 5.0.0-alpha

com queries SQL geradas automaticamente que usavam algo como o cdigo seguinte, onde o automaticamente er inserido o valor do pagamento para !pagamento!: a UPDATE nome_tabela SET credito=credito-!pagamento! O que voc acha que ir acontecer quando o valor de pagamento for negativo? Como 1--1 e a legal no SQL, ns achamos terr que -- signique in de comentrio. e o ivel icio a Usando a nossa implementao deste mtodo de comentrio no MySQL Server Version ca e a 3.23.3 e posterior, 1-- Isto um comentrio atualmente seguro. e a e Outro recurso seguro que o cliente de linha de comando mysql remove todas as linhas que e iniciam com --. A seguinte discusso somente interessa se voc estiver executando uma verso do MySQL a e a inferior a verso 3.23: a Se voc tem um programa SQL em um arquivo texto que contm comentrios -- voc e e a e dever usar: a shell> replace " --" " #" < arquivo-texto-com-comentrio.sql \ a | mysql banco-de-dados No lugar de: shell> mysql banco-de-dados < arquivo-texto-com-comentario.sql Voc tambm pode editar o prprio arquivo de comandos alterando os comentrios -- e e o a para #: shell> replace " --" " #" -- arquivo-texto-com-comentario.sql Desfaa utilizando este comando: c shell> replace " #" " --" -- arquivo-texto-com-comentario.sql

1.8.5 Como o MySQL Lida com Restries co

Como o MySQL lhe permite trabalhar com tabelas transacionais e no transacionais (que a no permitem rollback), o tratamento de restries um pouco diferente no MySQL que a co e em outros bancos de dados. Temos que tratar o caso quando voc atualiza diversos registros com uma tabela no transae a cional que no pode fazer rollback em erros. a A losoa bsica tentar obter um erro para qualquer coisa que possamos detectar em temp a e de compilao mas tentar recuperar de qualquer erro que abtemos em tempo de execuo. ca ca Fazemos isto na maiorioa dos casos, mas no para todos ainda. Veja Seo 1.6.4 [TODO a ca future], Pgina 29. a A opo bsica que o MySQL tem parar a instruo no meio ou fazer o melhor para se ca a e ca recuperar do problema e continuar. A seguir mostramos o que acontece com diferentes tipos de restries. co

1.8.5.1 Restrioes de PRIMARY KEY / UNIQUE c

Normalmente voc receber um erro quando tentar fazer um INSERT / UPDATE de um registro e a que cause uma violao de uma chave primria, chave unica ou chave estrangeira. Se voc ca a e

Cap tulo 1: Informaes Gerais co

53

estiver usando um mecanismo de armazenamento transacional, como InnoDB, o MySQL automaticamente far um rollback da transao. Se voc estiver usando mecanismos de a ca e armazenemento no transacionais o MySQL ir para no registro errado e deiar o resto dos a a registros se processamento. Para tornar a vida mais fcil o MySQL adicionou suporte a diretiva IGNORE para a maioria a dos comandos que podem causar uma violao de chave (como INSERT IGNORE ...). Neste ca caso o MySQL ir ignorar qualquer violao de chave e continuar com o processamento do a ca a prximo registro. Voc pode obter informao sobre o que o MySQL fez com a funo da o e ca ca API mysql_info() API function e em verses posteriores do MySQL 4.1 com o comando o SHOW WARNINGS. Veja Seo 12.1.3.30 [mysql info], Pgina 802. Veja Seo 4.6.8.9 [SHOW ca a ca WARNINGS], Pgina 323. a Note que no momento apenas as tabelas InnoDB suportam chaves estrangeiras. Seo 7.5.5.2 [Restries de chaves estrangeiras no InnoDB], Pgina 654. ca co a Veja

O suporte a chaves estrangeiras nas tabelas MyISAM est programado para ser inclu na a ida arvor de fonte do MySQL 5.0. e

1.8.5.2 Restrioes de NOT NULL c

Para poder suportar um fcil tratamento de tabelas no transacionais todos os campos no a a MySQL tm valores padro. e a Se voc inserir um valor errado em uma coluna como um NULL em uma coluna NOT NULL e ou um valor numrico muito grande em um campo numrico, o MySQL ir atribuir a coluna e e a o melhor valor poss ivel em vez de dar uma mensagem de erro. Para strings este valor e que possa estar na coluna. uma string vazia ou a maior string possivel Isto signica que se voc tentar armazenar NULL em uma coluna que no aceita valores NULL, e a o MySQL Server armazenar 0 ou (strig vazia) nela. Este ultimo comportamento pode, a para uma simples insero de registro, ser alterado com a opo de compilao -DDONT_ ca ca ca USE_DEFAULT_FIELDS.) Veja Seo 2.3.3 [Opes de congurao], Pgina 98. Isto faz com ca co ca a que as instrues INSERT gerem um erro a menos que voc explicite valores espec co e icos para todas as colunas que exigem um valor diferente de NULL. A razo para as regras acima que no podemos vericar estas condies antes da consulta a e a co comear a executar. Se encontrarmos um problema depois de atualizar algumas linahs, no c a podemos fazer um rollback j que o tipo de tabela no suporta isto. A opo de parar no a a ca a to boa como no caso em que a atualizao esteja feita pela metade que provavelmente e a ca e o pior cenrio poss a ivel. Neste caso melhor fazer o poss e ivel e ento continuar como se a nada tivesse acontecido. No MySQL 5.0 plenejamos melhorar into forncendo avisos para converses automticas de campo, mais uma opo para deixar voc fazer um rollback o a ca e das instrues que usam apenas tabelas transacionais no caso de tal instruo zer uma co ca denio de campo no permitida. ca a O mostrado acima signica que no se deve usar o MySQL para vericar o contedo dos a u campos, mas deve se faz-lo por meio da aplicao. e ca

54

MySQL Technical Reference for Version 5.0.0-alpha

1.8.5.3 Restries de ENUM e SET co

No MySQL 4.x ENUM no uma restrio real, mas um modo mauis eciente de armazenar a e ca campos que possam apenas conter um conjunto de valores dados. Isto devido as mesmas e razes pelas quais NOT NULL no respeitado. Veja Seo 1.8.5.2 [restries NOT NULL], o a e ca co Pgina 53. a Se voc inserir um valor errado em um campo ENUM, ele ser congurado com uma string e a vazia em um contexto string. Veja Seo 6.2.3.3 [ENUM], Pgina 499. ca a Se voc inserir uma opo errada em um campo SET, o valor errado ser ignorado. Veja e ca a Seo 6.2.3.4 [SET], Pgina 500. ca a

1.8.6 Erros Conhecidos e Decincias de Projetos no MySQL e 1.8.6.1 Erros da Verso 3.23 Corrigidos em Verses Posteriores do a o MySQL
Os seguintes erros/bugs conhecidos no esto corrigidos no MySQL 3.23 porque corrig a a i-los involveria a mudana de muito cdigo, o que poderia introduzir outros erros, talvez piores. c o Os erros so tambm classicados como no fatal ou tolervel. a e a a Pode se obter um deadlock ao fazer LOCK TABLE em multiplas tabelas e ento na mesma a conexo zer um DROP TABLE em uma delas enquanto outra thread est tentando bloa a quear a tabela. Pode-se no entanto fazer um KILL em qualquer uma das threads envolvidas para resolver isto. Corrigido na verso 4.0.12 a SELECT MAX(campo_chave) FROM t1,t2,t3... onde uma das trs tabelas est vazia e a no retorna NULL, mas sim o valor mximo da coluna. Corrigido na verso 4.0.11. a a a DELETE FROM heap_table sem um WHERE no funcionam em tabelas HEAP com lock. a

1.8.6.2 Open Bugs / Decincias de Projeto no MySQL e

Os seguintes problemas so conhecidos e tem prioridade muito alta para serem corrigidos: a FLUSH TABLES WITH READ LOCK no bloqueia CREATE TABLE ou COMMIT, que pode criar a um problema com a posio do log binrio ao se fazer um backup completo de tabelas ca a e do log binrio. a ANALYZE TABLE em uma tabela BDB pode, em alguns, casos inutilizar a tabela at que e se reinicie o servidor mysqld. Quando isto acontecer voc ir ver o seguinte tipo de e a erro no arquivo de erros do MySQL. 001207 22:07:56 bdb: log_flush: LSN past current end-of-log O MySQL aceita parenteses na parte FROM, mas os ignora sem aviso. A razo pela qual a no so retornados erros que muitos clientes que geram consultas automaticamente a a e adicionam parentesis na parte FROM mesmo onde eles no so necessrios. a a a Concatenar muitos RIGHT JOINS ou combinar joins LEFT e RIGHT na mesma consulta podem dar uma resposta incorreta ja que o MySQL s gera registros NULL para tabelas o que precedem um join LEFT ou antes de um join RIGHT. Isto ser corrigido na verso a a 5.0 junto com o suporte a parentesis na parte FROM.

Cap tulo 1: Informaes Gerais co

55

No execute ALTER TABLE em uma tabela BDB em que voc estiver executando a e transaes multi-instrues no completadas. co co a (A transao provavelmente ser ca a ignorada). ANALYZE TABLE, OPTIMIZE TABLE e REPAIR TABLE podem causar problemas em tabelas para as quais voc estiver usando INSERT DELAYED. e Fazendo um LOCK TABLE .. e FLUSH TABLES .. no garante que no existem transaes a a co no terminadas em progresso na tabela. a Tabelas BDB so um pouco lentas para abrir. Se voc tiver vrias tabelas BDB em um a e a banco de dados, gastar muito tempo para usar o cliente mysql no banco de dados se a voc no estiver usando a opo -A ou se voc estiver usando rehash. Isto percebido e a ca e e principalmente quando voc tiver um cache de tabelas grandes. e A replicao utiliza o log a nivel de consulta: o master grava a consulta no log binrio. ca a Isto um rpido, compacto e eciente mtodo de registro o que funciona perfeitamente e a e na maioria dos casos. Embora nunca tenhamos ouvido sobre um caso ocorrido, h uma a chance terica que o dado no master e slave sejam diferente se uma consulta feita o e de tal modo que a modicao do dado no determin ca e a istica, isto , deixar ao desejo e do otimizador de consultas (o que geralmente no uma boa prtica, mesmo fora da a e a replicao!). Por exemplo: ca CREATE ... SELECT ou INSERT ... SELECT que preenchem com zeros ou NULL uma coluna auto_increment. DELETE se voc estiver apagando registros de uma tabela que tem chaves ese trangeiras com a propriedade ON DELETE CASCADE. REPLACE ... SELECT, INSERT IGNORE ... SELECT se voc tiver valores de chaves e duplicados nos dados inseridos. Se e somente se todos estas consultas NAO tiverem clusulas ORDER BY garantindo uma a ordem deterministica. Na verdade, por exemplo para INSERT ... SELECT sem ORDER BY, o SELECT pode retornar registros em uma ordem diferente (no qual resultar em um registro tendo a diferentes posies, obtendo um nmero diferente na coluna auto_increment), depenco u dendo da escolhe feita pelo otimizador no master e slave. Uma consulta ser otimizada a deiferentemente no master e slave apenas se: Os arquivos usados pelas duas consultas no so exatamente a mesma; por exemplo a a OPTIMIZE TABLE foi executado nas tabelas master e no nas nas tabelas slave (para a corrigir isto, desde o MySQL 4.1.1, OPTIMIZE, ANALYZE e REPAIR so escritos no a log binrio). a A tabela est armazenada em um mecanismo de armazenamento diferente no masa ter e no slave (pode se executar diferentes mecanismos de armazenamento no metre e no slave: por exemplo, InnoDB ne master e MyISAM no slave, se o slave possuir menos espao disppon em disco). c ivel The MySQL buers sizes (key_buffer_size etc) are dierent on the master and slave. O master e slave executam verses diferentes do MySQL, e o cdigo do toimizador o o diferente entre estas verses. e o

56

MySQL Technical Reference for Version 5.0.0-alpha

Este problema tambm pode afetar a restaurao de um banco de dados usando e ca mysqlbinlog|mysql. O modo mais fcil de evitar este problema em todos os casos adicionar uma clusula a e a ORDER BY para tal consulta no determin a istica assegure que os registros so sempre ara mazenados/modicados na mesma ordem. Nas verses futuras do MySQL adicionareo mos automaticamente uma clusula ORDER BY quando necessrio. a a Os seguintes problemas so conhecidos e sero corrigidos na hora certa: a a Ao usar funes RPAD, ou qualquer outra funo string que termina adicionando espaos co ca c em branco a direita, em uma consulta que preisa usar tabelas temporrias para ser a rsolvida, todas as strings resultantes sero cortadas a direita (como em RTRIM). Este a um exemplo de uma consulta: e SELECT RPAD(t1.field1, 50, ) AS f2, RPAD(t2.field2, 50, ) AS f1 FROM table1 as t1 LEFT JOIN table2 AS t2 ON t1.record=t2.joinID ORDER BY t2.record; O resultado nal deste erro que o usurio no conseguira espaos em branco do lado e a a c direito do campo resultante. O comportamento anterior existe em todas as verses do MySQL. o A razo disto devido ao fato de tabelas HEAP, que so usadas primeiro para tabelas a e a temporrias, no so capazes de tratar colunas VARCHAR. a a a Este comportamento ser corrigido em uma das distribuies da srie 4.1. a co e Devido ao modo como os arquvos de denies de tabelas so armazenados no se co a a pode usar 255 caracteres (CHAR(255)) em nomes de tabelas, nomes de colunas e enum. Isto est programado para ser corrigido na verso 5.1 quando temos novos arquivos de a a formatos de denio de tabelas. ca Quando estiver usando SET CHARACTER SET, no permitido usar caracteres especias a e no nome do banco de dados, tabelas ou campos. Pode-se usar _ ou % com ESCAPE em LIKE ... ESCAPE. se voc tiver uma coluna DECIMAL com um nmero armazenado em diferentes formatos e u (+01.00, 1.00, 01.00), GROUP BY pode considerar cada valor como um valor diferente. DELETE FROM merge_table usado sem WHERE ir apenas apagar o mapeamento para a a tabela, no apagando tudo nas tabelas mapeadas. a Voc no pode construir em outro diretrio quando estiver utilizando MIT-pthreads. e a o Como isto necessitaria de alteraes na MIT-pthreads, ns no estamos aptos a corrig co o a ila. BLOB valores no podem ser usados com conana em GROUP BY, ORDER BY ou a c DISTINCT. Somente os primeiros bytes (padro 1024) max_sort_length so usados a a quando estiver comparando BLOBs nestes casos. Isto pode ser alterado com a opo ca -0 max_sort_lenght para mysqld. Uma forma de contornar este problema para a maioria dos casos usar a substring: SELECT DISTINCT LEFT(blob,2048) FROM e nome_tabela. Clculos so feitos com BIGINT ou DOUBLE (normalmente, ambos tem o tamanho de 64 a a bits). Depende da preciso utilizada na funao. A regra geral que funes binrias a c e co a so feitas com preciso BIGINT, IF e ELT() com preciso BIGINT ou DOUBLE e o resto a a a

Cap tulo 1: Informaes Gerais co

57

com preciso DOUBLE. Devemos evitar o uso de valores sem sinal maiores que 63 bits a (9223372036854775807) para qualquer outra coisa alm de campos binrios! e a Todas os campos string, exceto campos do tipo BLOB e TEXTO tem, automaticamente, todos os espaos extras removidos quando recuperados. Para tipos CHAR, isto no tem c a problema, e pode ser considerado como um recurso de acordo com o ANSI SQL92. O problema que no MySQL, campos VARCHAR so tratados desta mesma forma. e a Voc s pode ter at 255 colunas ENUM e SET em uma tabela. e o e Em MIN(), MAX() e outras funes de agrupamente, o MySQL atualmente compara as co colunas ENUM e SET pelo valor de suas strings ao invs da posio relativa da string no e ca conjunto. mysqld_safe redireciona todas as mensagens de mysqld para o log mysqld. Um problema com isto que se voc executar o mysqladmin refresh para fechar e reabrir o e e log, a stdout e a stderr continuam redirecionadas para o log antigo. Se voc utiliza e --log extensivamente, dever editar o mysqld_safe para logar em hostname.err a em vez de hostname.log; assim voc pode facilmente utilizar o espao do log antigo e c apagando-o e executando mysqladmin refresh. Em instrues UPDATE, colunas so atualizadas da esquerda para a direita. Se voc co a e referenciar a uma coluna atualizada, voc ir obter o valor atualizado em vez do valor e a original, por exemplo: mysql> UPDATE nome_tabela SET KEY=KEY+1,KEY=KEY+1; Isto atualiza KEY com 2 no lugar de 1. Voc pode se referir a mltiplas tabelas em uma mesma consulta, mas voc no pode se e u e a referir a qualquer tabelas temporrias dada mais de uma vez. Por exemplo, a seguinte a instruo no funciona. ca a mysql> SELECT * FROM temporary_table, temporary_table AS t2; RENAME no funciona com tabelas temporrias (TEMPORARY) ou tabelas usadas em uma a a tabelas MERGE. O otimizador pode lidar com o DISTINCT de forma diferente se voc estiver usando cole unas escondidas em uma join ou no. Em uma join, colunas escondidas so contadas a a como parte do resultado (mesmo se elas no so mostradas) enquanto que em queries a a normais colunas escondidas no participam na comparao DISTINCT. Ns provavela ca o mente iremos alterar isto no futuro para nunca comparar as colunas escondidas quando executando DISTINCT. um exemplo disto : e SELECT DISTINCT mp3id FROM band_downloads WHERE userid = 9 ORDER BY id DESC; and SELECT DISTINCT band_downloads.mp3id FROM band_downloads,band_mp3 WHERE band_downloads.userid = 9 AND band_mp3.id = band_downloads.mp3id ORDER BY band_downloads.id DESC; No segundo caso, voc pode obter duas linhas idnticas no MySQL 3.23.x na srie do e e e resultado (porque o campo escondido id pode variar).

58

MySQL Technical Reference for Version 5.0.0-alpha

Perceba que isto somente acontece em consultas onde voc no tem colunas ORDER e a BY no resultado, algo no permitido no SQL-92. a Como o MySQL permite trabalhar com tipos de tabelas que no suportam transaes a co (e assim no pode fazer rollback em dados) algumas coisas funcionam um pouco a diferentes de outros servidores SQL em MySQL (Isto serve para garantir que o MySQL nunca necessitar de um rollback para um comando SQL). Porm isto pode ser um a e pouco estranho em casos que os valores dos campos devem ser vericados na aplicao, ca mas isto ira fornacer um timo ganho de velocidade assim como permite ao MySQL o fazer algumas otimizaes que de outro modo seriam muito dif co iceis para serem feitas. Se voc informar um valor incorreto em uma coluna, o MySQL, em vez de fazer um e rollback, aramzenar o melhor valor possvel no campo. a i Se tentar armazenar um valor fora da faixa em uma coluna numrico, o MySQL e no campo. ir armazenar o menor ou maior valor possivel a Se tentar armazenar uma string que no comece com um nmero em uma coluna a u numrica, o MySQL ir armazenar 0 na coluna. e a Se voc tentar armazenar NULL em uma coluna que no aceita valores e a nulos, MySQL ir armazenar 0 ou (string vazia) na coluna. a (Este comportamento pode, entretanto, ser alterado com a opo de compilao ca ca -DDONT USE DEFAULT FIELDS). O MySQL permite o armazenamento de alguns valores errados de data em campos do tipo DATE e DATETIME. (Como 2000-02-31 ou 2000-02-00). A idia que no e e a e servio do servidor SQL validar datas. Se o MySQL pode armazenar uma data e c recuperar extamente a mesma data, ento o MySQL armazenar a data. Se a data a a estiver totalmente errada, o MySQL ir armazenar a data 0000-00-00 no campo. a Se voc especicar um valor no suportado para um campo do tipo enum, ele ser e a a alterado para o valor de erro empty string, com valor numrico 0. e Se voc denir uma coluna SET com um valor no suportado, o valor ser ignorado. e a a Se voc executar uma PROCEDURE em uma pesquisa que retorna uma srie vazia, em e e alguns casos a instruo PROCEDURE no ir transformar as colunas. ca a a Criao da tabela do tipo MERGE no veriva se as tabelas envolvidas so de tipos ca a a compativeis. O MySQL ainda no pode lidar com valores NaN, -Inf e Inf em tipos double. Us-los a a causar problemas na exportao e importao de dados. Uma soluo intermediria a ca ca ca a alterar NaN para NULL (se for poss e ivel) e -Inf e Inf para o valor double m inimo ou mximo respectivo poss a ivel. Se voc usar ALTER TABLE para primeiro adicionar um e indice UNIQUE a uma tabela usada em uma tabela MERGE e ento usar ALTER TABLE para adicionar um a indice normal na tabela MERGE, a ordem das chaves ser diferente para as tabelas se existir uma chave a antiga no unica na tabela. Isto porque o ALTER TABLE coloca chaves UNIQUE antes a e de chaves normais para ser poss detectar chaves duplicadas o mais cedo o poss ivel ivel. Os seguintes erros so conhecidos em verses mais antigas do MySQL: a o Voc pode pendurar um processo se voc zer um DROP TABLE em uma tabela entre e e outras que esteja travada com LOCK TABLES.

Cap tulo 1: Informaes Gerais co

59

No caso seguinte voc pode obter um descarrego de memria para o arquivo core: e o Tratamento de inseres com atraso tem deixado inseres pendentes na tabela. co co LOCK table com WRITE FLUSH TABLES Antes da verso 3.23.2 do MySQL um UPDATE que atualizava uma chave com um WHERE a na mesma chave podia falhar porque a chave era usada para procurar por registros e a mesma linha poderia ter encontrado vrios itens: a UPDATE nome_tabela SET KEY=KEY+1 WHERE KEY > 100; Um modo de contornar este erro utilizar: e mysql> UPDATE nome_tabela SET KEY=KEY+1 WHERE KEY+0 > 100; Isto funcionar porque MySQL no utilizar indices em expresses com a clusula a a a o a WHERE. Antes da verso 3.23 do MySQL, todos os tipos numricos tratados como campos a e de pontos xos. Isto signica que voc tem que especicar quantas casas decimais um e campo de ponto utuante deve ter. Todos os resultados eram retornados com o nmero u correto de casas decimais. Para erros espec icos na plataforma, vejas as sees sobre compilao e portabilidade. Veja co ca Seo 2.3 [Installing source], Pgina 94. Veja Apndice E [Porting], Pgina 1078. ca a e a

60

MySQL Technical Reference for Version 5.0.0-alpha

2 Instalao do MySQL ca
Este cap itulo descreve como obter e instalar o MySQL: Para uma lista de sites no quais voc pode obter o MySQL, veja Seo 2.2.1 [Getting e ca MySQL], Pgina 75. a Para saber quais so as plataformas suportadas, veja em Seo 2.2.3 [Which OS], a ca Pgina 78. Por favor perceba que nem todas as plataformas suportadas so igualmente a a boas para executar o MySQL. Algumas so mais robustas e ecientes que outras - ver a Seo 2.2.3 [Which OS], Pgina 78 para detalhes. ca a Vrias verses do MySQL esto dispon a o a iveis em distribuies binrias e fonte. Ns co a o tambm fornecemos acesso pblico ` nossa rvore fonte atual para aqueles que desejam e u a a ver nossos desenvolvimentos mais recentes e nos ajudar a testar novos cdigos. Para o determinar que verso e tipo da distribuio voc deve usar, veja Seo 2.2.4 [Which a ca e ca version], Pgina 80. Se ainda restar dvidas, use uma a distribuio binria. a u ca a Instrues de instalao para distribuies binria e fonte so descritos em Seo 2.2.9 co ca co a a ca [Installing binary], Pgina 91 e Seo 2.3 [Installing source], Pgina 94. Cada conjunto a ca a de instrues inclui uma seo sobre problemas espec co ca icos de sistemas que voc pode e precisar. Para procedimentos ps-instalao, veja Seo 2.4 [Post-installation], Pgina 111. Estes o ca ca a procedimentos podem ser aplicados caso voc use uma distribuio binria ou fonte do e ca a MySQL.

2.1 Instalao rpida padro do MySQL ca a a

Este cap itulo cobre a instalao do MySQL em plataformas onde oferecemos pacotes usando ca oformato de empacotamento nativo da respectiva plataforma. No entanto, as distribuies co binrias do MySQL esto dispon a a iveis para muitas outras plataformas, veja Seo 2.2.9 ca [Installing binary], Pgina 91 para instrues gerais de instalao para estes pacotes que se a co ca aplicam a todas as plataformas. Veja Seo 2.2 [General Installation Issues], Pgina 75 para mais informaes sobre quais ca a co outras distribuies binrias esto dispon co a a iveis e como obt-las. e

2.1.1 Instalando o MySQL no Windows

O processo de instalao para o MySQL no Windows tem os seguintes passos: ca 1. Instale a distribuio. ca 2. Congure um arquivo de opo se necessrio. ca a 3. Selcione o servidor que voc quer usar. e 4. Inicie o servidor. O MySQL para Windows est dispon em dois formatos de distribuio: a ivel ca A distribuio binria contm um programa de instalao que instala que voc precisa ca a e ca e e assim possa iniciar o servidor imediatamente.

Cap tulo 2: Instalao do MySQL ca

61

A distribuio fonte contm todo o cdigo e os arquivos suportados para construir o ca e o executvel usando o compilador VC++ 6.0. Veja Seo 2.3.7 [Construo do fonte para a ca ca Windows], Pgina 107. a Geralmente, a melhor opo a distribuio binria. E mais simples e voc no precisa de ca e ca a e a nenhuma ferramenta adicional para ter o MySQL em execuo. ca

2.1.1.1 Exigncias do Sistema Windows e

Para executar o MySQL no Windows, voc precisar do seguinte: e a Um sistema operacional Windows de 32 bits como 9x, ME, NT, 2000 ou XP. A fam ilia NT (Windows NT, 2000 e XP) lhe permite executar o servidor MySQL como um servio. Veja Seo 2.1.1.7 [NT start], Pgina 66. c ca a Suporte ao protocolo TCP/IP. Um cpia da distribuio binria do MySQL para Windows, o qual pode ser feito o ca a download em http://www.mysql.com/downloads/. Nota: A distribuio de arquivos so fornecidas no formato zip e recomendamos o ca a uso de um cliente FTP com opo de resumo para evitar corrompimento de arquivos ca durante o processo de download. Um programa ZIP para descompactar os arquivos da distribuio. ca Espao suciente em disco para descompactar, instalar e criar o banco de dados de c acordo com suas exigncias. e Se voc planeja se conectar ao servidor MySQL via ODBC, voc tambm precisar do e e e a dirver MyODBC. Veja Seo 12.2 [ODBC], Pgina 870. ca a Se voc precisa de tabelas com tamanho maior que 4GB, instale o MySQL em um e sistema de arquivos NTFS ou mais novo. No se esquea de usar MAX_ROWS e AVG_ROW_ a c LENGTH quando criar tabelas. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a

2.1.1.2 Instalando uma Distribuio Binria do Windows ca a

Para instalar o MySQL no Windows usando uma distribuio binria, siga este procedica a mento: 1. Se voc estiver trabalhando em uma mquina Windows NT, 2000, ou XP, esteja certo e a de que voc est logado com um usurio com privileios de administrador. e a a 2. Se voc estiver fazendo uma atualizao de uma instalao MySQL mais nova, e ca ca e necessrio parar o servidor atual. Em mquinas com Windows NT, 200 ou XP, se a a voc estiver executando o servidor como um servio, pare-o com o comando: e c C:\> NET STOP MySQL Se voc planeja usar um servidor diferente depois da atualizao (por exemplo, se voc e ca e quiser executar o mysqld-max em vez do mysqld), remova o servio existente: c C:\mysql\bin> mysqld --remove 3. Voc pode reinstalar o servio com o servidor prprio depois de atualizar. e c o Se voc no estiver executando o servidor MySQL como um servio, pare desta forma: e a c

62

MySQL Technical Reference for Version 5.0.0-alpha

C:\mysql\bin> mysqladmin -u root shutdown 4. Finalize o programa WinMySQLAdmin se ele estiver em execuo. ca 5. Descompacte os arquivos de distribuio em um diretrio temporrio. ca o a 6. Execute o programa setup.exe para iniciar o processo de instalao. Se voc quiser ca e instalar em um diretrio diferente do padro (c:\mysql), use o boto Browse para o a a especicar seu diretrio preferido. Se voc no instalar o MySQL no local padro, voc o e a a e precisar epecicar o local onde voc inicia o servidor. O modo mais fcil de se fazer a e a isto usar um arquivo de opo, como descrito em Seo 2.1.1.3 [Windows prepare e ca ca environment], Pgina 62. a 7. Finalize o processo de instalao. ca

2.1.1.3 Preparando o Ambiente MySQL do Windows

Se voc precisar especicar opes de inicializao quando executar o servidor, voc pode e co ca e indentica-los na linha de comando ou coloc-los em um arquivo de opo. Par opes que a ca co so usadas sempre que o servidor iniciar, voc achar mais conveniente utilizar um arquivo a e a de opco para especicar a congurao do seu MySQL. Isto particularmente verdade sob a ca e as seguintes circunstncias: a A localizao do diretrio de instalao ou dados so diferentes dos locais padro ca o ca a a (c:\mysql e c:\mysql\data). Voc precisa ajustar as conguraes do servidor. Por exemplo, para usar as tabelas e co transacionais InnoDB no MySQL verso 3.23, voc deve criar manualmente dois novos a e diretrios para guardar os arquivos de dados e de log do InnoDB por exemplo, o c:\ibdata e c:\iblogs. Voc tambm poder adicionar algumas linhas extras ao e e a arquivo de opo, como descrito em Seo 7.5.3 [Iniciando o InnoDB], Pgina 644. (A ca ca a partir do MySQL 4.0, o InnoDB cria os seus arquivos de log e dados no diretrio de dao dos por padro. Isto signica que voc no precisa congurar o InnoDB explicitamente. a e a Voc ainda deve faz-lo se desejar, e um arquivo de opo ser util neste caso.) e e ca a No Windows, o instalador do MySQL coloca o diretrio de dados diretamente sob o diretrio o o onde voc instalou o MySQL. Se voc quisesse utilizar um diretrio de dados em um local e e o diferente, voc deve copiar todo o contedo do diretrios data para a nova localizao. Por e u o ca exemplo, por padro, o instalador coloca o MySQL em C:\mysql e o diretrio de dados a o em C:\mysql\data. Se voc quiser usar um diretrio de dados de E:\mydata, voc deve e o e fazer duas coisas: Mova o diretrio de dados de C:\mysql\data para E:\mydata. o Use uma opo --datadir para especicar a nova localizao do diretrio de dados ca ca o cada vez que voc iniciar o servidor. e Quando o servidor MySQL inicia no Windows, ele procura pelas opes em dois arquivos: co O arquivo my.ini no diretrio Windows e o arquivo chamado C:\my.cnf. O diretrio o o do Windows normalmente chamado C:\WINDOWS ou C:\WinNT. Voc pode determinar e e a sua localizao exata a partir do valor da varivel de ambiente WINDIR usando o seguinte ca a comando: C:\> echo %WINDIR%

Cap tulo 2: Instalao do MySQL ca

63

O MySQL procura pelas opes primeiro no arquivo my.ini, e ento pelo arquivo my.cnf. co a No entanto, para evitar confuso, melhor se voc usar apenas um destes arquivos. Se o a e e seu PC usa um boot loader onde o drive C: no o drive de boot, sua unica opo usar a e ca e o arquivo my.ini. Independente de qual arquivo usar, ele deve ser no formato texto. Um arquivo de opo pode ser criado e modicado com qualquer editor de texto como o ca programa Notepad. Por exemplo, se o MySQL est instalado em D:\mysql e o diretrio a o de dados est localizado em D:\mydata\data, voc pode criar o arquivo de opo e denir a e ca uma seo [mysqld] para especicar valores para os parmetros basedir e datadir: ca a [mysqld] # defina basedir com o seu caminho de instala~o ca basedir=D:/mysql # defina datadir com o local do diretrio de dados, o datadir=D:/mydata/data Note que os nome de caminho do Windows so espec a icados em arquivos de opo usando ca barras normais em ves de barra invertida. Se voc usar barras invertidas, voc deve us-las e e a em dobro. Outro modo de se gerenciar um arquivo de opo usar a ferramenta WinMySQLAdmin. Voc ca e e pode encontrar o WinMySQLAdmin no diretrio bin de sua instalao MySQL, assim como o ca um arquivo de ajuda contendo instrues para us-lo. O WinMySQLAdmin tem a capacidade co a de editar os seus arquivos de opo, mas note o seguinte: ca WinMySQLAdmin usa apenas o arquivo my.ini. Se o WinMySQLAdmin encontra o arquivo C:\my.cnf, ele o renomear para a C:\my_cnf.bak para disabilit-lo. a Agora voc est pronto para testar o servidor. e a

2.1.1.4 Selecionando um Servidor Windows

Iniciado com o MySQL 3.23.38, a distribuio Windows inclui ambos binrios, normal e o ca a MySQL-Max. Aqui est uma lista dos diferentes servidores MySQL dos quais voc pode a e escolher: Binario mysqld mysqld-opt mysqld-nt mysqld-max mysqld-max-nt Descrio ca Compilado com debugger integral e conferncia automtica de alocao e a ca de memria, links simblicos, BDB e tabelas InnoDB. o o Binrio otimizado. A partir da verso 4.0 o InnoDB est habilia a a tado. Antes desta verso, este servidor no tem suporte a tabelas a a transacionais. Binrio otimizado para NT/2000/XP com suporte para named pipes. a Binrio otimizado com suporte para links simblicos, tabelas BDB e a o InnoDB. Como o mysqld-max, porm compilado com suporte para named pipes. e

Todos os binrios acima so otimizados para processadores Intel modernos mas deve funa a cionar em qualquer processador Intel i386 ou melhor. Os servidores mysqld-nt e mysqld-max-nt suportam conexes named pipe. Se voc usar o e um destes servidores, o uso de named pipes est sujeito a estas condies: a co

64

MySQL Technical Reference for Version 5.0.0-alpha

Os servidores devem ser executados em uma verso do Windows que suporte named a pipes (NT, 2000, XP). A partir da verso 3.23.50, named pipes s estaro habilitados se voc iniciar estes a o a e servidores com a opo --enable-named-pipe. ca Os servidores podem ser executados no Windows 98 ou Me, mas o TCP/IP deve estar instalado, e as conexes named pipes no podem ser usadas. o a No Windows 95, estes servidores no podem ser usados. a

2.1.1.5 Iniciando o Servidor pela Primeira Vez

No Windows 95, 98, ou Me, cliente MySQL sempre se conecta ao servidor usando TCP/IP. Nos sistemas baseados no NT, como o Windows NT, 2000, ou XP, os clientes possuem duas opes. Eles podem usar TCP/IP, ou eles podem usar um named pipe se o servidor suportar co conexes named pipes. o Para informaes sobre qual servidor binrio executar, veja Seo 2.1.1.3 [Windows prepare co a ca environment], Pgina 62. a Esta seo lhe d um viso geral da inicializao de um servidor MySQL. A seguinte seo ca a a ca ca fornce informao mais espec ca ica para verses particulares do Windows. o Os exemplos nesta seo assumem que o MySQL est instalado sob a localizao padro, ca a ca a C:\mysql. Ajuste o caminho mostrado nos exemplos se voc tiver o MySQL instalado em e um local diferente. Fazer um teste a partir do prompt de comando do em uma janela de console (uma janela DOS) a melhor coisa a fazer porque o servidor mostra a mensagem de status que aparece e na janela do DOS. Se alguma coisa estiver errado com sua congurao, estas mensagens ca tornaro mais fcil para voc de identicar e corrigir qualquer problema. a a e Tenha certeza que voc est no diretrio onde o servidor localizado e ento entre este e a o e a comando: shell> mysqld --console Para servidores que incluem suporte InnoDB, voc deve ver as seguintes mensagens assim e que o servidor iniciar: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: InnoDB: The first specified datafile c:\ibdata\ibdata1 did not exist: a new database to be created! Setting file c:\ibdata\ibdata1 size to 209715200 Database physically writes the file full: wait... Log file c:\iblogs\ib_logfile0 did not exist: new to be created Setting log file c:\iblogs\ib_logfile0 size to 31457280 Log file c:\iblogs\ib_logfile1 did not exist: new to be created Setting log file c:\iblogs\ib_logfile1 size to 31457280 Log file c:\iblogs\ib_logfile2 did not exist: new to be created Setting log file c:\iblogs\ib_logfile2 size to 31457280 Doublewrite buffer not found: creating new Doublewrite buffer created creating foreign key constraint system tables foreign key constraint system tables created

Cap tulo 2: Instalao do MySQL ca

65

011024 10:58:25

InnoDB: Started

Quando o servidor naliza sua sequncia de inicializao, voc deve ver algo como abaixo, e ca e que indica que o servidor est pronto para o conexo com o cliente: a a port: 3306 O servidor continuar a gravar no console qualquer sa de diagnstico adicional que ele a ida o produza. Voc pode abrir uma nova janela de console na qual se executar os programas e a clientes. Se voc omitir a opo --console, o servidor grava a sa do diagnstico no log de erro e ca ida o no diretrio de dados. O log de erro o arquivo com a extenso .err. o e a mysqld: ready for connections Version: 4.0.14-log socket:

2.1.1.6 Iniciando o MySQL no Windows 95, 98, ou Me

No Windows 95, 98 ou Me, o MySQL usa TCP/IP para conectar um cliente a um servidor. (Isto permitir que qualquer mquina na sua rede se conecte a seu servidor MySQL.) Por a a isto, voc deve ter certeza de que o suporte TCP/IP est instalado na sua mquina antes e a a de iniciar o MySQL. Voc pode encontrar o TCP/IP no seu CD-ROM do Windows. e Note que se voc estiver usando uma verso antiga do Win95 (por exemplo, OSR2). E e a prefer que voc use um pacote antigo Winsock; para o MySQL necessrio o Winsock ivel e e a 2! Voc pode obter o Winsock mais novo em http://www.microsoft.com. O Windows 98 e tem a nova biblioteca Winsock 2, portanto no necessrio atualizar a biblioteca. a e a Para iniciar o servidor mysqld, voc deve iniciar uma janela do Prompt (Janela MS-DOS) e e digitar: shell> C:\mysql\bin\mysqld Isto ir iniciar o mysqld em segundo plano. Isto , depois do servidor iniciar, voc deve ver a e e outro prompt de comando. (Note que se voc iniciar o servidor deste modo no Windows e NT, 2000 ou XP, o servidor ir executar em segundo plano e nenhum prompt de comando a aparecer at que o servidor nalize. Por isto, voc deve abrir outro prompt de comando a e e para executar programas clientes enquanto o servidor estriver em execuo.) ca Voc pode nalizar o servidor MySQL executando: e shell> C:\mysql\bin\mysqladmin -u root shutdown Isto chama o utilitrio administrativo do MySQL mysqladmin para conectar ao servidor e a manda-lo nalizar. O comando conecta como root que a conta administrativa padro no e a sistema de permisses do MySQL. Por favor, note que o sistema de permisses do MySQL o o totalmente independente de qualquer login de usurio sob o Windows. e a Se o mysqld no iniciar, por favor, verique o log de erro para ver se o servidor escreveu a alguma mensagem que possa indicar a causa do problema. Voc pode tambm tentar iniciar e e o servidor com mysqld --console; neste caso, voc pode obter alguma informao util na e ca tela que pode ajudar a resolver o problema. A ultima opo iniciar o mysqld com --standalone --debug. Neste caso o mysqld ir ca e a escrever em um arquivo log C:\mysqld.trace que deve conter a razo pela qual o mysqld a no inicia. Veja Seo E.1.2 [Making trace les], Pgina 1080. a ca a Use mysqld --help para mostrar todas as opes que o mysqld entende! co

66

MySQL Technical Reference for Version 5.0.0-alpha

2.1.1.7 Iniciando o MySQL no Windows NT, 2000, ou XP

Na fam NT (Windows NT, 2000 ou XP) o modo recomendado de executar o MySQL ilia e instal-lo como um servio do Windows. O Windows ento inicia e para o servidor MySQL a c a automaticamente quando o Windows inicia e para. Um servidor instalado como um servio c tambm pode ser controlado a partir da linha de comando usando os comandos NET, ou e com o utilitrio grco Servios. a a c O utilitrio Servios (o Service Control Manager do Windows) pode ser encontrado no a c Painel de Controle do Windows (em Ferramentas Administrativas no Windows 2000). E recomendado que se feche o utilitrio Servios enquanto realiza a operaes de instalao a c co ca ou remoo do servidor a partir desta linha de comando. Isto evita alguns erros estranhos. ca Para ter o MySQL funcionando com TCP/IP no Windows NT 4, voc deve instalar o service e pack 3 (ou mais novo)! Antes de instalar o MySQL como um servio, voc deve primeiro parar o servidor atual em c e execuo usando o seguinte commando: ca shell> C:\mysql\bin\mysqladmin -u root shutdown Isto chama o utilitrio administrativo do MySQL mysqladmin para conectar ao servidor a e mand-lo parar. O comando conecta com root que a conta administrativa padro no a e a sistema de permisses do MySQL. Por favor, note que o sistema de permisses do MySQL o o totalmente independente de qualquer login de usurio sob o Windows. e a Agora instale o servidor como um servio: c shell> mysqld --install Se voc no denir um nome para o servio, ele instalado com o nome MySQL. Uma vez e a c e instalado, ele pode ser imediatamente iniciado a partir do utilitrio Servios, ou usando o a c comando NET START MySQL. (Este comando caso insensitivo). e Uma vez em execuo, o mysqld pode ser parado usando o utilitrio de Servios ou usando ca a c o comando NET STOP MySQL, ou o comando mysqladmin shutdown. Se voc tiver problemas instalando o mysqld como um servico usando apenas o nome do e servidor, tente instal-lo usando seu caminho compelto: a shell> C:\mysql\bin\mysqld --install A partir do MySQL 4.0.2, voc pode especicaro nome do servio depois da opo -e c ca install. A partir do MySQL 4.0.3, voc pode especicar uma opo --defaults-file e ca depois do nome do servio para indicar onde o servidor deve obter opes ao iniciar. A c co regras que determinam o nome do servio e os arquivos de opo que o servidor usa so as c ca a seguintes: Se voc no especicar um nome de servio, o servidor usa o nome padro do MySQL e e a c a o servidor l as opes do grupo [mysqld] no arquivo de opes padro. e co co a Se voc especicar um nome de servio depois da opo --install, o servidor ignora e c ca o grupo de opo [mysqld] em vez de ler opes do grupo que tem o mesmo nome que ca co o servio. O servidor le opes do arquivo de opes padro. c co co a Se voc especicar uma opo --defaults-file depois do nome de servio, o servidor e ca c ignora o arquivo de opes padro e l opes apenas a partir do grupo [mysqld] do co a e co arquivo indicado.

Cap tulo 2: Instalao do MySQL ca

67

Nota: Antes do MySQL 4.0.17, um servidor instalado como um servio do Windows tinha c problema na inicializao se o seu caminho ou nome do servio possuisse espaos. Por esta ca c c razo, evite instalar o MySQL em um diretrio como C:\Program Files ou usar um nome a o de servio contendo espao. c c No caso normal que voc instala o servidor com --install mas nenhum nome de servio, e c o servidor instalado com um nome de servio de MySQL. e c Como um exemplo mais complexo, considere o seguinte comando: shell> C:\mysql\bin\mysqld --install mysql --defaults-file=C:\my-opts.cnf Aqui, um nome de servio dado depois de opo --install. Se nenhuma opo -c e ca ca defaults-file for dada, este comando teria o efeito de fazer o servidor ler o grupo [mysql] a partir do arquivo de opes padro. (Isto seria uma m idia, porque aquele grupoo co a a e de opo para ser usado pelo programa cliente mysql.) No entanto, como a opo -ca e ca defaults-file est presente, o servidor l as opes apenas a partir do arquivo indicado, a e co e apenas do grupo de opo [mysqld]. ca Voc tambm pode especicar as opes como Par^metros de inicializa~o no e e co a ca utilitrio de Servios do Windows antes de voc iniciar o servio MySQL. a c e c Uma vez que o servidor MySQL instalado, o Windows ir iniciar o servio automaticamente e a c sempre que o Windows inicia. O servio tambm pode ser iniciado imediatamente a partir c e do utilitrio Servios ou usando o comando NET START MYSQL. O comando NET no caso a c a e sensitivo. Note que quando executado como um servio, o mysqld no tm acesso a um console e c a e ento nenhuma mensagem pode ser vista. Se o mysqld no iniciar, verique o log de erros a a par ver se o servidor gravou alguma mensagem l indicando a causa do problema. O log de a erro est localizado no diretrio c:\mysql\data. E o arquivo com um suxo .err. a o Quando o mysqld est executando como um servio, ele pode ser parado usando o utilitrios a c a Servios, o comando NET STOP MYSQL, ou o comando mysqladmin shutdown. Se o servip c c estiver em execuo quando o Windows desliga, o Windows ir parar o servidor automatica a camente. A partir do MySQL verso 3.23.44, voc pode escolher entre instalar o servidor como um a e servio Manual se voc no deseja que os servios sejam executados automaticamente duc e a c rante o processo de inicializao. Para fazer isto, use a opo --install-manual em vez ca ca da opo --install. ca shell> C:\mysql\bin\mysqld --install-manual Para remover um servio que est instalado como um servio, primeiro pare-o se ele estiver c a c em execuo. Ento use a opo --remove para remov-lo: ca a ca e shell> mysqld --remove Um problema com a nalizao automtica do servio MySQL que, para verses do ca a c e o MySQL anteriores a 3.23.49, o Windows esparava apenas por alguns segundos para o desligamento completo, e matava os processos do servidor de banco de dados se o tempo limite fosse excedido. Isto potencialmente causava problemas. (Por exemplo, o mecanimo de armazenamento InnoDB dever fazer uma recuperao de falhas na prxima inicializao). A a ca o ca partir do MySQL 3.23.49, o Windows ir esperar mais para que a nalizao do MySQL a ca Server esteja completa. Se voc notar que ainda no o suciente para a sua instalao, e a e ca

68

MySQL Technical Reference for Version 5.0.0-alpha

no seguro executar o MySQL Server como um servio. Em vez disso, execute-o a partir a e c do prompt de comando, e nalize-o com mysqladmin shutdown. A alterao para avisar para o Windows para esperar mais quando parar o servidor MySQL ca funciona apenas com o Windows 2000 e XP, mas no para o Windows NT. No NT, o a Windows espera apenas 20 segundos para que o servio seja nalizado, e depois desso ele c mata o processo do servio. Voc pode aumentar este padro abrindo o Editor de Registro c e a (\winnt\system32\regedt32.exe) e editar o valor de WaitToKillServiceTimeout em HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control na rvore do Registro. Esa pecique o novo valor mais largo em milisegundos (por exemplo 12000 para que o Windows NT espere at 120 segundos). e Se voc no quiser iniciar o mysqld como um servio, voc pode inici-lo a partir da linha e a c e a de comando do mesmo modo que em verses do Windows que no so baseados no NT. o a a Para instrues use Seo 2.1.1.6 [Win95 start], Pgina 65. co ca a

2.1.1.8 Executando o MySQL no Windows

O MySQL suporta TCP/IP em todas as plataformas Windows. Os servidores mysqld-nt e mysql-max-nt suportam named pipes no NT, 2000 e XP. No entanto, o padro usar a e TCP/IP, independente da plataforma: Named pipes atualmente mais lento que TCP/IP em muitas conguraes do Wine co dows. Alguns usurios encontraram problemas ao nalizar o servidor MySQL quando era a usado named pipes. A partir da verso 3.23.50, named pipes s est habilitado para o mysqld-nt e mysql-maxa o a nt se eles forem iniciados com a opo --enable-named-pipe. ca Voc pode forar que um cliente MySQL use named pipes especicando a opo --pipe ou e c ca especicando . como nome de mquina. Use a opo --socket para especicar o nome do a ca pipe. No MySQL 4.1, voc deve usar a opo --protocol=PIPE. e ca Voc pode testar se o MySQL est funcionando executando qualquer dos seguintes comane a dos: C:\> C:\> C:\> C:\> C:\mysql\bin\mysqlshow C:\mysql\bin\mysqlshow -u root mysql C:\mysql\bin\mysqladmin version status proc C:\mysql\bin\mysql test

Se o mysqld est lento para responder a suas conexes no Win95/Win98, provavelmente a o existe um problema com seu DNS. Neste caso, inicie o mysqld com a opo --skip-nameca resolve e use somente localhost e nmeros IP na coluna Host das tabelas de permisses u o do MySQL. Existem duas verses da ferramenta de linha de comando MySQL: o Binario mysql mysqlc Descrio ca Compilado em Windows nativo, oferecendo capacidades de edio de ca texto muito limitadas. Compilado com o compilador Cygnus GNU, que oferece edio ca readline.

Cap tulo 2: Instalao do MySQL ca

69

Se voc desejar usar o mysqlc, deve ter uma cpia da biblioteca cygwinb19.dll em ale o gum lugar que o mysqlc possa encontr-la. Se sua distribuio do MySQL no tiver esta a ca a biblioteca instalada no mesmo diretrio que o mysqlc (o diretrio bin sob o diretrio base o o o sa dua instalao do MySQL). Se sua distribuio no tem a biblioteca cygwinb19.dll no ca ca a diretrio bin, olhe no diretrio lib para encontr-lo e copi-lo para o seu diretrio de o o a a o sistema no Windows. (\Windows\system ou um lugar parecido). Os privilgios padres no Windows do a todos usurios locais privilgios totais para todos e o a a e os bancos de dados sem necessidade de especicar uma senha. Para deixar o MySQL mais seguro, voc deve congurar uma senha para todos os usurio e remover a linha na tabela e a mysql.user que tem Host=localhost e User=. Voc tambm deve adicionar uma senha para o usurio root. O exemplo seguinte exemplo e e a inicia removendo o usurio annimo que tem todos os privilgios, e ento congura uma a o e a senha para o usurio root: a C:\> C:\mysql\bin\mysql mysql mysql> DELETE FROM user WHERE Host=localhost AND User=; mysql> FLUSH PRIVILEGES; mysql> QUIT C:\> C:\mysql\bin\mysqladmin -u root password your_password Depois de congurar a senha, se voc desejar desligar o servidor mysqld, voc pode usar o e e seguinte comando: C:\> mysqladmin --user=root --password=sua_senha shutdown Se voc estiver usando o servidor de uma antiga verso shareware do MySQL verso 3.21m e a a o comando mysqladmin para congurar uma senha ir falhar com um erro: parse error a near SET password. A correo para este problema atualizar para uma verso mais ca e a nova do MySQL. Com as verses atuais do MySQL voc pode facilmente adicionar novos usurios e alterar o e a privilgios com os comandos GRANT e REVOKE. Veja Seo 4.4.1 [GRANT], Pgina 254. e ca a

2.1.2 Instalando o MySQL no Linux

O modo recomendado para instalar o MySQL no Linux usando um arquivo RPM. Os e RPMs do MySQL atualmente so construidos na verso 7.3 do sistema Suse Linux mas a a deve funcionar em outras verses de Linux que suportam rpm e usam glibc. o Se voc tiver problemas com um arquivo RPM (por exemplo, se voc receber o e e erro Sorry, the host xxxx could not be looked up), veja Seo 2.6.2.1 [Binary ca notes-Linux], Pgina 141. a Na maioria dos casos, voc s precisa instalar os pacotes servidor MySQL e o cliente e o MySQL para ter uma instalao funcional do MySQL. Os outros pacotes no so exigidos ca a a para uma instalao padro. Se voc quiser executar um servidor MySQL Max que tenha ca a e capacidades adicionais, voc deve instalar o RPM MySQL-Max depois de instalar o RPM e MySQL-server. Veja Seo 4.8.5 [mysqld-max], Pgina 343. ca a Se voc tiver um dependncia de falha ao tentar instalar os pacotes do MySQL 4.0 (ex.: e e error: removing these packages would break dependencies: libmysqlclient.so.10 is needed by ...), voc tambm deve instalar o pacote MySQL-shared-compat, e e

70

MySQL Technical Reference for Version 5.0.0-alpha

o qual inclui ambas as bibliotecas para compatibilidade com verses anteriores o (libmysqlclient.so.12 para MySQL 4.0 e libmysqlclient.so.10 para MySQL 3.23). Muitas distribuies Linux ainda vm com o MySQL 3.23 a elas normalmente ligam as co e aplicaes dinamicamente para economizar espao em disco. Se estas bibliotecas comparco c tilhadas esto em pacotes separados (ex.; MySQL-shared), suciente simplesmente deixar a e estes pacotes instalados e apenas atualizar os pacotes do servidor e cliente MySQL (que so a estaticamente ligados e no dependem de bibliotecas compartilhadas). Para distribuies a co que incluem as bibliotecas compartilhadas no mesmo pacote que o servidor MySQL (ex.: Red Hat Linux), voc tambm pode instalar nosso RPM MySQL-shares 3.23 ou usar o e e pacote compat com MySQL-shared. ivel Os seguintes pacotes RPM esto dispon a iveis: MySQL-server-VERSION.i386.rpm O servidor MySQL. Voc ira precisar dele a no ser que voc apenas queira se conectar a e a e um servidor MySQL executando em outra mquina. Note que este pacote era chamado a MySQL-VERSION.i386.rpm antes do MySQL 4.0.10. MySQL-Max-VERSION.i386.rpm O servidor MySQL Max. Este seridor tem capacidades adicionais que o servidor no ROM MySQL-server no tem. Voc deve instalar o RPM MySQL-server primeiro, a e porque o RPM MySQL-Max depende dele. MySQL-client-VERSION.i386.rpm Os programas clientes padres do MySQL. Provavelmente voc sempre instalar este o e a pacote. MySQL-bench-VERSION.i386.rpm Testes e comparativos de performances (benchmarks). Necessita do Perl e mdulos do o BDB-mysql. MySQL-devel-VERSION.i386.rpm As bibliotecas e arquivos include necessrios se voc precisa para compilar outros a e clientes MySQL, como nos mdulos Perl. o MySQL-shared-VERSION.i386.rpm Este pacote contm as bibliotecas compartilhadas (libmysqlclient.so*) que certas e linguagens e aplicaes nencessrias para carregar dinmicamente e usar o MySQL. co a a MySQL-shared-compat-VERSION.i386.rpm Este pacote inclui o biblioteca compartilhada para MySQL 3.23 e MySQL 4.0. Instale este pacote em vez do MySQL-shared, se voc tiver aplicaes instaladas que so e co a dinmicamente ligadas ao MySQL 3.23 mas voc quer atualizar para o MySQL 4.0 sem a e quebrar as dependncias da biblioteca. Este pacote esta dispon e ivel desde o MySQL 4.0.13. MySQL-embedded-VERSION.i386.rpm A biblioteca do servidor embutido MySQL (MySQL 4.0). MySQL-VERSION.src.rpm Este contm o cdigo fonte para todos os pacotes acima. Ele tambm pode ser usado e o e para tentar construir RPMs para outras arquiteturas (por exemplo, Alpha ou SPARC).

Cap tulo 2: Instalao do MySQL ca

71

Para ver todos os arquivo em um pacote RPM, (por exemplo, um RPM MySQL-server), execute: shell> rpm -qpl MySQL-server-VERSION.i386.rpm Para realizar uma instalao m ca inima padro, execute: a shell> rpm -i MySQL-server-VERSION.i386.rpm MySQL-client-VERSION.i386.rpm Para instalar somente o pacote cliente, execute: shell> rpm -i MySQL-client-VERSION.i386.rpm O RPM fornece um recurso para vericar a integridade e autenticidade dos pacotes antes de instal-los. Se voc quiser aprender mais sobre este recurso, veja Seo 2.2.2 [Verifying a e ca Package Integrity], Pgina 75. a O RPM coloca dados sob o /var/lib/mysql. O RPM tambm cria as entradas apropriadas e em /etc/rc.d/ para iniciar o servidor automaticamente na hora do boot. (Isto signica que se voc realizou uma instalao anterior e fez alteraes em seu script de inicializao, e ca co ca voc pode desejar criar uma cpia do script para que voc no perca ao instalar um RPM e o e a mais novo). Veja Seo 2.4.3 [Automatic start], Pgina 118 para mais informaes sobre ca a co como o MySQL pode ser iniciado automaticamente na inicializao do sistema. ca Se voc quiser instalar o RPM do MySQL em uma distribuio Linux mais antiga que no e ca a suporte scripts de inicializao no /etc/init.d (diretamente ou via link simblico), voc ca o e deve criar um link simblico que aponte para a localizao onde o seu script de instalao o ca ca est atualmente instalado. Por exemplo, se esta localizao for /etc/rc.d/init.d, use a ca estes comandos antes de intalar o RPM para criar /etc/init.d como um link simblico o que aponte l: a shell> cd /etc; ln -s rc.d/init.d . No entanto, todas as distribuies de Linux atuais j devem suportar este novo layout co a de diretrio que usa /etc/init.d j que ele exigido para compatibilidade LBS (Linux o a e Standard Base). Se o arquivo RPM que voc instalar inclui o MySQL-server, o daemon mysqld deve estar e pronto e em execuo aps a instalao. Agora voc j deve poder iniciar o MySQL. Veja ca o ca e a Seo 2.4 [Ps Instalao], Pgina 111. ca o ca a Se alguma coisa der errado, voc encontrar maiores informaes no cap e co itulo de instalao. ca Veja Seo 2.2.9 [Instalado o binrio], Pgina 91. ca a a

2.1.3 Instalando o MySQL no Mac OS X

A partir do MySQL 4.0.11, voc pode instalar o MySQL no Mac OS X 10.2 (Jaguar) e usando um pacote do binrio do Mac OS X PKG em vez da distribuio binrio em tarball. a ca a Note que verses mais antigas do Mac OS X (ex.: 10.1.x) no so suportadas por este o a a pacote. Este pacote est localizado dentro de um arquivo de imagem de disco (.dmg). que voc a e primeiro precisa montar com um duplo clique em sua icone no Finder. Ele deve ento a montar a imagem e exibir o seu contedo. u NOTA: Antes de proceder com a instalao, tenha certeza que voc nalizou todas as ca e instncias do MySQL em execuo usando o MySQL Manager Aplication (no Mac OS X a ca Server) ou via mysqladmin shutdown na linha de comando.

72

MySQL Technical Reference for Version 5.0.0-alpha

Para relamente instalar o MySQL PKG, de um duplo clique na icone do pacote. Isto inicia o Mac OS Package Installer, que ir guia-lo pela instalao do MySQL. a ca O Mac OS X PKG do MySQL ir se instalar em /usr/local/mysql-<version> a e tambm instalr um link simblico /usr/local/mysql, apontando para a nova e a o localizao. Se um diretrio chamado /usr/local/mysql j existe, ele ser renomeado ca o a a para /usr/local/mysql.bak em primeiro lugar. Adicionalmente, ele ir instalar a a tabela de permisses do banco de dados MySQL executando mysql_install_db depois da o instalao. ca O layout de instalao similar a aquele da distribuio binria, todos os binrios do MySQL ca e ca a a esto localizados no diretrio /usr/local/mysql/bin. O socket MySQL ser colocado em a o a /tmp/mysql.sock por padro. Veja Seo 2.2.5 [Installation layouts], Pgina 83. a ca a A instalao do MySQL exige uma conta de usurio do Mac OS X chamada mysql (uma ca a conta de usurio com este nome existe por padro no Mac OS X 10.2 e acima). a a Se voc estiver executando o MAC OS X Server, voc j ter uma verso do MySQL e e a a a instalado: Mac OS X Server 10.2-10.2.2 vem com o MySQL 3.23.51 instalado Mac OS X Server 10.2.3-10.2.6 vem com o MySQL 3.23.53 Mac OS X Server 10.3 vem com o MySQL 4.0.14 Esta seo do manual cobre a instalao apenas do MySQL Mac OS X PKG ocial. Leia o ca ca ajuda da Apple sobre a instalao do MySQL (Execute o aplicativo Help View, selecione ca a ajuda do Mac OS X Server e faa uma busca por MySQL e leia o item entitulado c Installing MySQL). Note especialmente, que a verso pr-instalada do MySQL no Mac OS X Server iniciado a e e com o comando safe_mysqld em vez de mysqld_safe. Se anteriormente voc usava pacotes do MySQL de Marc Liyanage para Mac OS X de e http://www.entropy.ch, voc pode simplesmente seguir as intrues de atualizao para e co ca pacotes usando o layout de instalao dos binrio como dados em suas pginas. ca a a Se voc est atualizado da verso 3.23.xx de Marc ou do verso Mac OS X Server do e a a a MySQL para o MySQL PKG ocial, voc tambm deve converter a tabela de privilgios do e e e MySQL existente para o formato atual, porque alguns novos privilgios de segurana foram e c adicionados. Veja Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. ca a Se voc preferisse iniciar automaticamente o MySQL durante o boot do sistema, voc e e tambn precisa instalar o MySQL Startup Item. A partir do MySQL 4.0.15, ele parte do e e disco de instalao do Mac OS X como um pacote de instalao separado. Simplesmente ca ca de um duplo clique no icone MySQLStartupItem.pkg e siga as instrues para instal-lo. co a Note que isto s precisa ser feito uma vez! No h necessidade de se instalar o Startup Item o a a toda vez que se atualizar o pacote do MySQL. Devido a um erro no instalador de pacotes do Mac OS X, algumas vezes voc pode ver a e mensagem de erro You cannot install this software on this disk. (null) no dilogo a de seleo do disco de destino. Se este erro ocorrer, simplesmente clique no boto Go ca a Back uma vez para retornar a tela anterior. Agora clique em Continue para avanar para a c seleo do disco de destino novamente - agora voc deve estar apto a escolher o disco destino ca e corretamente. Ns informamos este erro a Apple e eles esto investigando este problema. o a

Cap tulo 2: Instalao do MySQL ca

73

O Startup Item ser instalado em /Library/StartupItems/MySQL. Ele adiciona uma a varivel MYSQLCOM=-YES- ao arquivo de congurao do sistema (/etc/hostconfig). Se a ca voc desejasse diasbilitar a inicializao automtica do MySQL, simplesmente altere o valor e ca a desta varivel para MYSQLCOM=-NO-. a No Mac OS X Server, o script de instalao do Startup Item disabilitar automaticaca a mente a inicializao da instalao padro do MySQL alterando a varivel MYSQL em ca ca a a /etc/hostconfig para MYSQL=-NO-. Isto para evitar conitos na inicializao. No e ca entanto, ele no desliga um servidor MySQL aj em execuo. a a ca Depois da instalao, voc pode iniciar o MySQL executando os seguintes comandos em ca e um janela de terminal. Note qye voc preceisa ter privilgios de administrador para realizar e e esta tarefa. Se voc tiver instalado o Startup Item: e shell> sudo /Library/StartupItems/MySQL/MySQL start (Enter your password, if necessary) (Press Control-D or enter "exit" to exit the shell) Se voc no tiver instalado o Startup Item, digite a seguinte sequncia de comandos: e a e shell> shell> (Enter (Press shell> (Press cd /usr/local/mysql sudo ./bin/mysqld_safe your password, if necessary) Control-Z) bg Control-D or enter "exit" to exit the shell) executando

Agora voc deve conseguir se conectar ao servidor MySQL, ex.: e /usr/local/mysql/bin/mysql

Se voc instalar o MySQL pela primeira vez, lembre-se de consigurar uma senha para o e usurio root do MySQL! a Isto feito com os seguintes comandos: e /usr/local/mysql/bin/mysqladmin -u root password <password> /usr/local/mysql/bin/mysqladmin -u root -h hostname password <password> Por favor, tenha certeza que o comando hostname na segunda linha est entre crases (), a assim a shell pode substitu com a sa deste comando (o nome da mquina deste i-la ida a sistema)! Voc tambm pode querer adicionar aliases ao seu arquivo de resursos do sheel para acessar e e mysql e mysqladmin da linha de comando: alias mysql /usr/local/mysql/bin/mysql alias mysqladmin /usr/local/mysql/bin/mysqladmin De forma alternativa, voc pode simplesmente adicionar /usr/local/mysql/bin a sua e varivel de ambiente PATH, ex.: adicionando o seguinte ao arquivo $HOME/.tcshrc: a setenv PATH ${PATH}:/usr/local/mysql/bin Note que instalar um novo MySQL PKG no remove o diretrio de uma instalao mais a o ca antiga. Infelizmente o Mac OS X Installer ainda no oferece a funcionalidade exigida para a atualizar apropriadamente pacotes instalados anteriormente.

74

MySQL Technical Reference for Version 5.0.0-alpha

Depois de copiar os arquivos de banco de dados do MySQL sobre os da verso a anterior e inicializar o nova verso com sucesso, voc deve remover os arquivos da a e instalao antiga para economizar espao em disco. Adicionalmente voc tambm ca c e e deve remover verses mais antigas do diretrio do Package Receipt localizados em o o /Library/Receipts/mysql-<version>.pkg.

2.1.4 Instalando o MySQL no NetWare

A partir da verso 4.0.11, o MySQL est dispon a a ivel para a Novell NetWare na forma de pacote do binrio. Para servir o MySQL, o servidor NetWare deve suprir estas exigncias: a e NetWare verso 6.5, ou NetWare 6.0 com Support Pack 3 instalado (Voc pode obt-lo a e e em http://support.novell.com/filefinder/13659/index.html). O sistema deve obedecer as exigncias m e inimas da Naveel para executar a respectiva verso do Neta Ware. Os dados do MySQL, assim com os seus binrios, devem ser instalados em um volume a NSS; volumes tradicionais no so suportados. a a O pacote binrio para o NetWare pode ser obtido em http://www.mysql.com/downloads/. a Se voc estiver executando o MySL no NetWare 6.0, sugerimos que voc utilize a opo e e ca --skip-external-locking na linha de comando. Tambm ser necessrio utilizar CHECK e a a TABLE e REPAIR TABLE em vez de myisamchk, porque myisamchk faz uso de lock externo. Lock externo possui problemas com NetWare 6.0; o problema foi eliminado no NetWare 6.5.

2.1.4.1 Instalando o MySQL para Binrios do NetWare a

1. Se voc estiver atualizando de um instaao anterior, para o servidor MySQL. Isto e ca e feito a partir do console do servidor, usando: SERVER: mysqladmin -u root shutdown 2. Conecte-se no servidor alvo a partir de uma mquina cliente com acesso ao local onde a voc instalar o MySQL. e a 3. Extraia o pacote zip binrio em seu servidor. Tenha certeza de permitir que os caminhos a no arquivo zip sejam usados. E seguro simplesmente extrair os arquivos para SYS:\. Se voc estiver atualizando de uma instalando anterior, voc pode precisar copiar os e e diretrios de dados (ex.: SYS:MYSQL\DATA) agora, assim como my.cnf se voc o tiver o e costumizado. Voc pode ento deletar a cpia antiga do MySQL. e a o 4. Voc pode desejar renomear o diretrio para algo mais consistente e fcil de usar. e o a Recomendamos usar o SYS:MYSQL; exemplos no manual o usaro para se referir ao a diretrio de instalao em geral. o ca 5. No console do servidor, adicione um caminho de busca no diretrio contendo os NLMs o do MySQL. Por exemplo: SERVER: SEARCH ADD SYS:MYSQL\BIN 6. Instale o banco de dados inicial, se necessrio, digitando mysql_install_db no console a do servidor. 7. Inicie o servidor MySQL usando mysqld_safe no console do servidor.

Cap tulo 2: Instalao do MySQL ca

75

8. Para nalizar a instalao, voc tambm deve adicionar os seguintes comandos ao ca e e autoexec.ncf. Por exemplo, se sua instalao do MySQL est em SYS:MYSQL e voc ca a e quiser que o MySQL inicie automaticamente, voc pode adicionar estas linhas: e #Starts the MySQL 4.0.x database server SEARCH ADD SYS:MYSQL\BIN MYSQLD_SAFE Se voc estiver usando NetWare 6.0, voc deve adicionar o parmetro --skipe e a external-locking: #Starts the MySQL 4.0.x database server SEARCH ADD SYS:MYSQL\BIN MYSQLD_SAFE --skip-external-locking Se houver uma instalao existente do MySQL no servidor, verique a existencia de comanca dos de inicializao do MySQL em autoexec.ncf, e edite ou delete-os se necessrio. ca a

2.2 Detalhes Gerais de Instalao ca

2.2.1 Como obter o MySQL
Conra a homepage da MySQL homepage (http://www.mysql.com/) para informaes co sobre a verso atual e para instrues de download. a co Nosso principal espelho de download est localizado em: http://mirrors.sunsite.dk/mysql/. a Para uma lista atualizada completa dos mirrors de download da MySQL, veja http://www.mysql.com/downloads/mirrors.html. Voc tambm encontrar informao e e a ca sobre como se tornar um mirror do MySQL e como relatar um mirror ruim ou desatualizado.

2.2.2 Vericando a Integridade do Pacote Usando MD5 Checksums ou GnuPG

Depois de fazer o download do pacote MySQL que serve `s suas necessidades e antes de a tentar instal-lo, voc deve ter certeza de que ele esta intacto e no foi manipulado. a e a A MySQL AB oferece dois tipos de vericao de integridade: MD5 checksums e assinaturas ca criptografadas usando GnuPG, o GNU Privacy Guard.

Vericando o MD5 Checksum

Depois de fazer o download do pacote, voc deve vericar se o MD5 checksum corresponde e a aquele fornecido na pgina de download do MySQL. Cada pacote tem um checksum a individual, que voc pode vericar com o seguinte comando: e shell> md5sum <pacote> Note que nem todos os sistemas operacionais suportam o comando md5sum - em alguns ele simplesmente chamado md5, outros no o possuem. No Linux, ele parte do pacote e a e GNU Text Utilities, que est disponivel para uma grande faixa de plataformas. Voc a e

76

MySQL Technical Reference for Version 5.0.0-alpha

pode fazer o download do cdigo fonte em http://www.gnu.org/software/textutils/. o Se voc tiver o OpenSSL instalado, voc tambm pode usar o comando openssl md5 e e e <pacote>. Uma implementao do comando md5 para DOS/Windows est dispon em ca a ivel http://www.fourmilab.ch/md5/. Exemplo: shell> md5sum mysql-standard-4.0.10-gamma-pc-linux-i686.tar.gz 155836a7ed8c93aee6728a827a6aa153 mysql-standard-4.0.10-gamma-pc-linux-i686.tar.gz Voc deve vericar se o resultado do checksum corresponde a aquele impresso no pgina de e a download logo abaixo do respectivo pacote. A maioria do sites mirrors tambm oferecem um arquivo chamado MD5SUMS, que tambm e e inclui o MD5 checksums para todos os arquivos inclu idos no diretrio Downloads. Note no o entanto que muito fcil de modicar este arquivo e ele no um mtodo muito convel. e a a e e a Caso esteja em dvida, voc deve consultar diferentes sites mirroers e comparar os resultau e dos.

Vericao de Assinatura Usando GnuPG ca

Um mtodo de vericao de integridade de um pacote mais convel o uso de assie ca a e naturas criptografadas. A MySQL AB usa o GNU Privacy Guard (GnuPG), uma alternativa Open Source para o bem conhecido Pretty Good Privacy (PGP) de Phil Zimmermann. Veja http://www.gnupg.org/ and http://www.openpgp.org/ para mais informaes sobre co OpenPGP/GnuPG e como obter e instalar o GnuPG em seus sistema. A maioria das distribuies co de Linux j vm com o GnuPG instalado por padro. a e a A partir do MySQL 4.0.10 (Fevereiro de 2003), a MySQL AB comeou a assinar o seus c pacotes de download com GnuPG. Assinaturas criptografadas so um mtodo bem mais a e convel de vericao da integridade e autenticidade de um arquivo. a ca Para vericar a assinatura de um pacote espec ico, voc primeiro precisa obtter uma cpia e o da chave pblica GPG da MySQL AB (build@mysql.com). Voc tambm pode cort-la e u e e a col-la diretamente daqui ou obt-la em http://www.keyserver.net/. a e Key ID: pub 1024D/5072E1F5 2003-02-03 MySQL Package signing key (www.mysql.com) <build@mysql.com> Fingerprint: A4A9 4068 76FC BD3C 4567 70C8 8C71 8D3B 5072 E1F5 Public Key (ASCII-armored): -----BEGIN PGP PUBLIC KEY BLOCK----Version: GnuPG v1.0.6 (GNU/Linux) Comment: For info see http://www.gnupg.org mQGiBD4+owwRBAC14GIfUfCyEDSIePvEW3SAFUdJBtoQHH/nJKZyQT7h9bPlUWC3 RODjQReyCITRrdwyrKUGku2FmeVGwn2u2WmDMNABLnpprWPkBdCk96+OmSLN9brZ fw2vOUgCmYv2hW0hyDHuvYlQA/BThQoADgj8AW6/0Lo7V1W9/8VuHP0gQwCgvzV3 BqOxRznNCRCRxAuAuVztHRcEAJooQK1+iSiunZMYD1WufeXfshc57S/+yeJkegNW

Cap tulo 2: Instalao do MySQL ca

77

hxwR9pRWVArNYJdDRT+rf2RUe3vpquKNQU/hnEIUHJRQqYHo8gTxvxXNQc7fJYLV K2HtkrPbP72vwsEKMYhhr0eKCbtLGfls9krjJ6sBgACyP/Vb7hiPwxh6rDZ7ITnE kYpXBACmWpP8NJTkamEnPCia2ZoOHODANwpUkP43I7jsDmgtobZX9qnrAXw+uNDI QJEXM6FSbi0LLtZciNlYsafwAPEOMDKpMqAK6IyisNtPvaLd8lH0bPAnWqcyefep rv0sxxqUEMcM3o7wwgfN83POkDasDbs3pjwPhxvhz6//62zQJ7Q7TXlTUUwgUGFj a2FnZSBzaWduaW5nIGtleSAod3d3Lm15c3FsLmNvbSkgPGJ1aWxkQG15c3FsLmNv bT6IXQQTEQIAHQUCPj6jDAUJCWYBgAULBwoDBAMVAwIDFgIBAheAAAoJEIxxjTtQ cuH1cY4AnilUwTXn8MatQOiG0a/bPxrvK/gCAJ4oinSNZRYTnblChwFaazt7PF3q zIhMBBMRAgAMBQI+PqPRBYMJZgC7AAoJEElQ4SqycpHyJOEAn1mxHijft00bKXvu cSo/pECUmppiAJ41M9MRVj5VcdH/KN/KjRtW6tHFPYhMBBMRAgAMBQI+QoIDBYMJ YiKJAAoJELb1zU3GuiQ/lpEAoIhpp6BozKI8p6eaabzF5MlJH58pAKCu/ROofK8J Eg2aLos+5zEYrB/LsrkCDQQ+PqMdEAgA7+GJfxbMdY4wslPnjH9rF4N2qfWsEN/l xaZoJYc3a6M02WCnHl6ahT2/tBK2w1QI4YFteR47gCvtgb6O1JHffOo2HfLmRDRi Rjd1DTCHqeyX7CHhcghj/dNRlW2Z0l5QFEcmV9U0Vhp3aFfWC4Ujfs3LU+hkAWzE 7zaD5cH9J7yv/6xuZVw411x0h4UqsTcWMu0iM1BzELqX1DY7LwoPEb/O9Rkbf4fm Le11EzIaCa4PqARXQZc4dhSinMt6K3X4BrRsKTfozBu74F47D8Ilbf5vSYHbuE5p /1oIDznkg/p8kW+3FxuWrycciqFTcNz215yyX39LXFnlLzKUb/F5GwADBQf+Lwqq a8CGrRfsOAJxim63CHfty5mUc5rUSnTslGYEIOCR1BeQauyPZbPDsDD9MZ1ZaSaf anFvwFG6Llx9xkU7tzq+vKLoWkm4u5xf3vn55VjnSd1aQ9eQnUcXiL4cnBGoTbOW I39EcyzgslzBdC++MPjcQTcA7p6JUVsP6oAB3FQWg54tuUo0Ec8bsM8b3Ev42Lmu QT5NdKHGwHsXTPtl0klk4bQk4OajHsiy1BMahpT27jWjJlMiJc+IWJ0mghkKHt92 6s/ymfdf5HkdQ1cyvsz5tryVI3Fx78XeSYfQvuuwqp2H139pXGEkg0n6KdUOetdZ Whe70YGNPw1yjWJT1IhMBBgRAgAMBQI+PqMdBQkJZgGAAAoJEIxxjTtQcuH17p4A n3r1QpVC9yhnW2cSAjq+kr72GX0eAJ4295kl6NxYEuFApmr1+0uUq/SlsQ== =YJkx -----END PGP PUBLIC KEY BLOCK----Voc pode importar esta chave em seu pasta de chaves publicas GPG usando gpg --import. e Veja a documentao de GPG para mais informaes de como trabalhar com chaves pblicas. ca co u Depois de fazer o download e importar a chave publica criada, faa o download c do pacote MySQL desejado e da assinatura correspondente, que tambm est e a dispon ivel na pgina de download. A assinatura tem a extenso .asc. Por exemplo, a a a assinatura de mysql-standard-4.0.10-gamma-pc-linux-i686.tar.gz seria mysql-standard-4.0.10-gamma-pc-linux-i686.tar.gz.asc. Tenha certeza que ambos os arquivos esto armazenados no mesmo diretrio e ento execute o seguinte comando a o a para vericar a assinatura para este arquivo: shell> gpg --verify <package>.asc Exemplo: shell> gpg --verify gpg: Warning: using gpg: Signature made gpg: Good signature "MySQL Package mysql-standard-4.0.10-gamma-pc-linux-i686.tar.gz.asc insecure memory! Mon 03 Feb 2003 08:50:39 PM MET using DSA key ID 5072E1F5 from signing key (www.mysql.com) <build@mysql.com>"

A mensagem "Good signature" indica que est tudo certo. a

78

MySQL Technical Reference for Version 5.0.0-alpha

Vericando Assinatura Usando RPM

Para pacotes RPM, no h assinaturas separadas - pacotes RPM atualmente tm uma assia a e natura GPG inclu e MD5 checksum. Voc pode veric-los executando o seguinte comando: ida e a shell> rpm --checksig <package>.rpm Exemplo: shell> rpm --checksig MySQL-server-4.0.10-0.i386.rpm MySQL-server-4.0.10-0.i386.rpm: md5 gpg OK Nota: Se voc estiver usando RPM 4.1 e ele reclamar sobre (GPG) NOT OK (MISSING KEYS: e GPG#5072e1f5) (mesmo se voc a importou para detro de sua pasta de chaves publicas e GPG), voc precisa import-las para dentro de sua pasta de chaves RPM primeiro. RPM e a 4.1 no utiliza mais ias suas pastas de chaves GPG (e o prprio GPG), mas mantm sua a o e prpria pasta de chaves (porque ele um aplicativo do sistema e a pasta de chaves pblicas o e u do GPG um arquivo espec e ico do usurio). Para importar a chave pblica do MySQL em a u uma pasta de chaves RPM, use os seguintes comandos: shell> rpm --import <pubkey> Exemplo: shell> rpm --import mysql_pubkey.asc Caso voc note que as assinaturas MD5 checksum ou GPG no coincidem, tente primeiro fazer e a o download do pacote respectivo mais uma vez, talvez de outro site mirror. Se voc no e a obter sucesso na vericao da integridade do pacote repetidas vezes, notique-nos sobre ca tais incidentes incluindo o nome completo do pacote e o site que voc tem utilizado para e fazer o download pelos emails webmaster@mysql.com ou build@mysql.com.

2.2.3 Sistemas Operacionais suportados pelo MySQL

Ns ulitizamos o GNU Autoconf, para que seja poss o ivel portar o MySQL para todos sistemas operacionais modernos com threads Posix funcionando e um compilador C++. (Para compilar somente o cdigo cliente, um compilador C++ necessrio mas threads no.) Ns o e a a o mesmos usamos e desenvolvemos o software primeiramente no Linux (SuSE e red Hat), FreeBSD e Sun Solaris (Verses 8 e 9). o Perceba que para alguns sistemas operacionais, o suporte nativo a thread funciona somente nas ultimas verses. O MySQL compila com sucesso nas seguintes combinaes de sistema o co operacional/pacote de thread: AIX 4.x com threads nativas. Veja Seo 2.6.6.4 [IBM-AIX], Pgina 155. ca a Amiga. BSDI 2.x com o pacote inclu MIT-pthreads. Veja Seo 2.6.4.5 [BSDI], Pgina 151. ido ca a BSDI 3.0, 3.1 e 4.x com threads nativas. Veja Seo 2.6.4.5 [BSDI], Pgina 151. ca a SCO OpenServer with a recent port of the FSU Pthreads package. Veja Seo 2.6.6.9 ca [SCO], Pgina 161. a

Cap tulo 2: Instalao do MySQL ca

79

SCO UnixWare 7.0.1. Veja Seo 2.6.6.10 [SCO Unixware], Pgina 163. ca a DEC Unix 4.x com threads nativas. Veja Seo 2.6.6.6 [Alpha-DEC-UNIX], Pgina 157. ca a FreeBSD 2.x com o pacote inclu MIT-pthreads. Veja Seo 2.6.4.1 [FreeBSD], ido ca Pgina 148. a FreeBSD 3.x e 4.x com threads nativas. Veja Seo 2.6.4.1 [FreeBSD], Pgina 148. ca a FreeBSD 4.x com Linuxthreads. Veja Seo 2.6.4.1 [FreeBSD], Pgina 148. ca a MIT-pthreads ou DCE threads. Veja Seo 2.6.6.2 HP-UX 10.20 com o pacote incluido ca [HP-UX 10.20], Pgina 153. a HP-UX 11.x com as threads nativas. Veja Seo 2.6.6.3 [HP-UX 11.x], Pgina 154. ca a Linux 2.0+ com LinuxThreads 0.7.1+ ou glibc 2.0.7+. Veja Seo 2.6.2 [Linux], ca Pgina 137. a Mac OS X Server. Veja Seo 2.6.5 [Mac OS X], Pgina 152. ca a NetBSD 1.3/1.4 Intel e NetBSD 1.3 Alpha (Necessita GNU make). Veja Seo 2.6.4.2 ca [NetBSD], Pgina 150. a Novell NetWare 6.0. Veja Seo 2.6.8 [Novell NetWare], Pgina 164. ca a OpenBSD > 2.5 com threads nativas. OpenBSD < 2.5 com o pacote inclu MITido pthreads . Veja Seo 2.6.4.3 [OpenBSD], Pgina 150. ca a OS/2 Warp 3, FixPack 29 e OS/2 Warp 4, FixPack 4. Veja Seo 2.6.7 [OS/2], ca Pgina 163. a SGI Irix 6.x com threads nativas. Veja Seo 2.6.6.8 [SGI-Irix], Pgina 160. ca a Solaris 2.5 e superior com threads nativas nas plataformas SPARC e x86. Veja Seo 2.6.3 [Solaris], Pgina 144. ca a SunOS 4.x com o pacote inclu MIT-pthreads. Veja Seo 2.6.3 [Solaris], Pgina 144. ido ca a Tru64 Unix Windows 9x, Me, NT, 2000 e XP. Veja Seo 2.6.1 [Windows], Pgina 133. ca a Perceba que nem todas as plataformas so apropriadas para executar o MySQL. Os seguintes a fatores determinam se uma certa plataforma apropriada para uma misso cr e a itica pesada: Estabilidade geral da biblioteca thread. Uma plataforma pode ter excelente reputao, ca entretanto, se a biblioteca thread instvel no cdigo que usado pelo MySQL, mesmo e a o e se todo o resto for perfeito, o MySQL ir ser to estvel quanto a biblioteca thread. a a a A habilidade do kernel e/ou a biblioteca thread tirar vantagem do SMP em sistemas multi-processados. Em outras palavras, quando um proceesso cria uma thread, deve ser poss para aquela thread executar em uma CPU diferente que o processo original. ivel A habilidade do kernel e/ou a biblioteca thread executar vrias threads que a adiquire/libera um bloqueio mutex sobre uma pequena regio cr a itica frequentemente sem trocas de contexto excessivos. Em outras palavras, se a implementao de ca pthread_mutex_lock() requisitar a CPU muito rapidamente, isto ir afetar o MySQL a tremendamente. Se esse detalhe no estiver sendo cuidado, adicionar CPUs extras a podem deixar o MySQL mais lento. Estabilidade e performance geral do sistema de arquivos. Habilidade do sistema de arquivos em lidar com arquivos grandes de forma eciente, se suas tabelas forem grandes.

80

MySQL Technical Reference for Version 5.0.0-alpha

Nosso n de experincia aqui na MySQL AB com a plataforma. Se ns conhecemos ivel e o bem uma plataforma, introduzimos otimizaes/correoes espec co c icas para ela habilitadas na hora da compilao. Ns tambm podemos fornecer conselhos sobre como ca o e congurar seu sistema otimizadamente para o MySQL. O volume de testes feitos internamente de conguraes similares. co O nmero de usurios que tem executado o MySQL com sucesso naquela plataforma em u a conguraes similares. Se esse nmero for alto, as chances de se ter alguma surpresa co u espec ica da plataforma ca muito menor. Baseado nos critrios acima, as melhores plataformas para a execuo do MySQL at este e ca e ponto so o x86 com SuSe Linux 8.2, kernel 2.4 e ReiserFS (ou qualquer distribuio Linux a ca similar) e Sparc com Solaris (2.7-9). FreeBSD vem em terceiro, mas realmente temos esperanas que ele ir se unir ao clube dos tops uma vez que a biblioteca thread est c a a melhorando. Ns tambm acreditamos que em certo ponto iremos estar aptos para incluir o e todas as outras plataformas em que o MySQL compila e executa, mas no to bem e com a a o mesmo nivel de estabilidade e performance, na categoria superior. Isto necessitar de a algum esforo da nossa parte em cooperao com os desenvolvedores dos componentes do c ca Sistema Operacional/Biblioteca que o MySQL depende. Se voc tiver interesse em melhorar e algum de nossos componentes, est em uma posio para inuenciar seu desenvolvimento, a ca e precisa de instrues mais detalhadas sobre o que o MySQL necessita para uma melhor co execuo, envie um e-mail para lista de email insternals do MySQL. Veja Seo 1.7.1.1 ca ca [Mailing-list], Pgina 33. a Por favor, perceba que a comparao acima no para dizer que um SO melhor ou pior ca a e e que o outro em geral. Ns estamos falando sobre a escolha de um SO para um propsito o o dedicado: executar o MySQL, e comparamos as plataformas levando isto em considerao. ca Desta forma, o resultado desta comparao seria diferente se ns incluissemos mais detalhes. ca o E em alguns casos, a razo de um SO ser melhor que o outro pode ser simplesmente a porque colocamos mais esforo nos testes e otimizao para aquela plataforma em particular. c ca Estamos apenas colocando nossas observaes para ajud-lo na deciso de qual plataforma co a a usar o MySQL na sua congurao. ca

2.2.4 Qual verso do MySQL deve ser usada a

A primeira deciso a ser feita se voc deve usar a ultima verso de desenvolvimento ou a a e e a ultima verso estvel: a a Normalmente, se voc estiver usando o MySQL pela primeira vez ou tentando porte a lo para algum sistema em que no exista distribuio binria, recomendamos o uso a ca a da verso estvel (atualmente Verso 5.0.0-alpha). Repare que todos os lanamentos a a a c do MySQL so conferidos com os testes comparativos de performance e um conjunto a extenso de testes antes de cada lanamento. c Seno, caso voc esteja trabalhando com um antigo sistema e quiser atualiz-lo, mas no a e a a que correr o risco com uma atualizao sem correes, voc deve faze-lo do mesmo ramo ca co e que voc est usando (onde aenas o ultimo nmero da verso mais novo que o seu). e a u a e Ns temos tentado corrigir somente erros fatais e torn-los menores, com alteraes o a co relativamente seguras para aquela verso. a

Cap tulo 2: Instalao do MySQL ca

81

A segunda deciso a ser feita se voc deseja usar uma distribuio fonte ou binria. Na a e e ca a maioria dos casos provavelmente voc dever usar a distribuio binria, se alguma existir e a ca a para sua plataforma, ser normalmente muito mais fcil para instalar do que a distribuio a a ca em cdigo fonte. o Nos seguites casos voc provavelmente ser mais bem servido com uma instalao baseada e a ca em cdigo fonte: o Se voc desejar instalar o MySQL em algum lugar expec e ico. (O padro das disa tribuies binrias estarpronto para rodar em qualquer lugar, mas talvez voc co a e e deseje ainda mais exibilidade). Para estar apto e satisfazer diferentes requisies dos usurios, estaremos fornecendo co a duas verses binrias diferentes; Uma compilada com os manipuladores de tabelas no o a a transacionais (um binrio rpido e pequeno) e um congurado com as mais importantes a a opes extendidas como tabelas transacionais. Ambas verses so compiladas da mesma co o a distribuio fonte. Todos clientes MySQL nativos pode conectar com ambas verses do ca o MySQL. A distribuio binria extendida marcada com o suxo -max e congurada com as ca a e e mesmas opes de mysqld-max. Veja Seo 4.8.5 [mysqld-max], Pgina 343. co ca a Se voc deseja usar o RPM MySQL-Max, primeiramente voc deve instalar o RPM MySQLe e server padro. a Se voc deseja congurar mysqld com alguns recursos extras que NAO esto nas dise a tribuies binrias. Segue abaixo a lista das opes extras mais comuns que voc pode co a co e querer usar: --with-innodb --with-berkeley-db (padro para o MySQL 4.0 e seguintes) a --with-raid (no dispon para todas as plataformas) a ivel --with-libwrap --with-named-z-lib (Isto feito para alguns dos binrios) e a --with-debug[=full] A distribuio binria padro normalmente compilada com suporte para todos conca a a e juntos de caracteres e deve funcionar em uma variedade de processadores para a mesma fam do processador. ilia Se voc precisar de um servidor MySQL mais rpido voc pode querer recompil-lo com e a e a suporte para somente o conjunto de caracteres que voc precisa, usar um compilador e melhor (como pgcc) ou usar opes de compiladores para usar otimizaes para seu co co processador. Se voc encontrar um erro e relat-lo para o time de desenvolvimento do MySQL voc e a e provavelmente receber um patch que ser necessrio aplic-lo para a distribuio fonte a a a a ca para ter o bug corrigido. Se voc deseja ler (e/ou modicar) o cdigo C e C++ que o MySQL, voc pode obter e o e e uma distribuio fonte. O cdigo fonte sempre o manual nal. Distribuies fontes ca o e co tambm contem mais testes e exemplos que as distribuies binrias. e co a O esquema de nomes do MySQL usa nmeros de verses que consistem de tres nmeros e u o u um suxo. Por exemplo, um nome de lanamento como mysql-4.1.0-alpha interpretado c e da seguinte maneira:

82

MySQL Technical Reference for Version 5.0.0-alpha

O primeiro nmero (4) a verso principal e tambm descreve o formato dos arquivos. u e a e Todas releases da Verso 4 tem o mesmo formato de arquivo. a O segundo nmero (1) o n da distribuiao. u e ivel c O terceiro nmero (0 o nmero da verso do n de distribuio. Este incrementado u e u a ivel ca e para cada nova distribuio. Normalmente voc desejar a ultima verso para o n ca e a a ivel de publicao que tiver escolhido. ca O suxo (alpha) indica o n de estabilidade da verso. Os poss ivel a iveis suxo so: a alpha indica que a verso contm grandes sees de novos cdigos que no foram a e co o a 100% testados. Bugs conhecidos (normalmente no tem nenhum) devem estar doca umentados na seo News. Veja Apndice D [News], Pgina 957. Existem tambm ca e a e novos comandos e extenses na maioria das publicaes alpha. Desenvolvimento o co ativo que podem envolver maiores alteraes no cdigo pode ocorrer numa verso co o a alpha, mas tudo ser testado antes de fazer a publicao. No podem existir erros a ca a conhecidos em nenhuma publicao do MySQL. ca beta signica que todo o novo cdigo foi testado. No sero adicionados novos o a a recursos que podem causar algum tipo de corrompimento. No deve existir bugs a conhecidos. Uma alterao de verso de alpha para beta ocorre quando no existir ca a a nenhum relato de erro fatal com uma verso alpha por pelo menos um ms e no a e a planejarmos adicionar nenhum recurso que pode deixar algum antigo comando menos convel. a gamma o beta que j tem sido usado a algum tempo e parece funcionar bem. e a Apenas pequenas correes so adicionadas. Isto o que muitas empresas chamam co a e de release. Se no existir um suxo, signica que esta verso j est sendo executada h a a a a a algum tempo em diferentes locais sem relatos de erros alm dos espec e icos de certas plataformas. Somente correes de erros cr co iticos so adicionados ao release. a Isto o que chamamos de uma distribuio estvel. e ca a No processo de desenvolvimento do MySQL, vrias verses coexistem e esto em um estgio a o a a diferente. Naturalmente, correes de erros relevantes de uma srie anterior so propagados. co e a Para a antiga srie 3.23 estvel/de produo, novas verses s so liberadas para erros e a ca o o a criticos. A srie atual (4.0) de qualidade estvel/produo. Nenhum novo recurso que possa e e a ca inuenciar a estabilidade do cdigo adicionado. o e No ramo alpha 4.1 principal, novos recursos so adicionados. Fontes e binrios esto a a a dispon iveis para uso e teste em sistemas de desenvolvimento. O ramo de desenvolvimento 5.0 s est dispon para a rvore do BitKeeper. o a ivel a Todas as verses do MySQL funcionam sobre nossos testes padres e comparativos para o o garantir que eles so relativamente seguros para o uso. Como os testes padres so extena o a didos ao longo do tempo para conferir por todos os bugs antigos encontrados, o pacote de testes continua melhorando. Perceba que todas publicaes de verses foram testadas pelo menos com: co o Um pacote de testes interna Faz parte de um sistema de produo para um cliente. Ela tem diversas tabelas ca com centenas de megabytes de dados.

Cap tulo 2: Instalao do MySQL ca

83

O diretrio mysql-test contm um conjunto extensivo de casos de teste. Ns o e o executamos estes testes para cada servidor binrio. a O pacote de comparativos da MySQL Este executa uma srie de consultas comuns. E tambm um teste para ver se e e o ultimo conjunto de otimizaes fez o cdigo mais rpido. Veja Seo 5.1.4 co o a ca [MySQL Benchmarks], Pgina 421. a O teste crash-me Este tenta determinar quais recursos o banco de dados suporta e quais so suas a capacidades e limitaes. Veja Seo 5.1.4 [MySQL Benchmarks], Pgina 421. co ca a Outro teste que ns usamos a verso do MySQL mais nova em nosso ambiente de produo e o a ca interna, em pelo menos uma mquina. Ns temos mais de 100 gigabytes de dados com que a o trabalhar.

2.2.5 Layouts de Instalao ca

Esta seo descreve o layout padro dos diretrios criados pela instalo das distribuies ca a o ca co binria e fonte. a Uma distribuio binria instalada descompactando-a no local de instalao de sua escolha ca a e ca (tipicamente /usr/local/mysql) e cria os seguintes diretrios nesses locais: o Diretrio o Contedo do diretrio u o bin Programas clientes e o servidor mysqld data Arquivos Log, bancos de dados docs Documentao, Log de alteraes ca co include Arquivos de cabealho (headers) c lib Bibliotecas scripts mysql_install_db share/mysql Arquivos de mensagem de erro sql-bench Benchmarks - testes comparativos Uma distribuio baseada em cdigo fonte instalada depois de voc congur-la e compilca o e e a a la. Por padro, a instalao copia os arquivos em /usr/local, nos seguintes subdiretrios: a ca o Diretrio o Contedo do diretrio u o bin Programas clientes e scripts include/mysql rquivos de cabealho (headers) A c info Documentao no formato Info ca lib/mysql Bibliotecas libexec O servidor mysqld share/mysql Arquivos com mensagens de erros sql-bench Benchmarks e o teste crash-me var Bancos de dados e arquivos log Dentro de um diretrio de instalao, o layout de uma instalao baseada em fontes difero ca ca encia de uma instalao binria nas seguintes formas: ca a The mysqld server is installed in the libexec directory rather than in the bin directory. The data directory is var rather than data.

84

MySQL Technical Reference for Version 5.0.0-alpha

mysql_install_db is installed in the /usr/local/bin directory rather than in /usr/local/mysql/scripts. The header le and library directories are include/mysql and lib/mysql rather than include and lib. You can create your own binary installation from a compiled source distribution by executing the script scripts/make_binary_distribution.

2.2.6 Como e quando as atualizaes so lanadas? co a c

O MySQL est evoluindo muito rapidamente na MySQL AB e ns queremos compartilhar a o isto com outros usurios MySQL. Sempre que temos alguns recursos uteis que outros acham a necessio, tentamos fazer um release. a Tambm tentamos ajudar usurios que solicitam recursos que so de fcil implementao. e a a a ca Tomamos notas do que nossos usurios licenciados gostariam de ter,especialmente do que a nossos clientes com suporte extendido desejam e tentamos ajud-los. a No existe uma real necessidade para baixar uma nova release. A seo News ir dizer se a a ca a nova verso tem alguma coisa que voc precisa. Veja Apndice D [News], Pgina 957. a e e a Usamos a seguinte pol itica quando estamos atualizando o MySQL: Para cada pequena atualizao, o ultimo nmero na verso incrementado. Quando ca u a e tiver um maior nmero de novos recursos ou menor incompatibilidade com verses u o antigas, o segundo nmero na verso incrementado. Quando o formato de arquivo u a e altera, o primeiro nmero aumentado. u e Verses estveis testadas aparecem na mdia de uma a duas vezes por ano, mas se o a e pequenos bugs so encontrados, uma verso ser lanada apenas com as correes dos a a a c co erros. Releases funcionais aparecem na mdia a cada 4-8 semanas. e Distribuies binrias para algumas plataformas ser feita por ns somente para reco a a o leases mais importantes. Outras pessoas podem fazer distribuies binrias para outros co a sistemas mas provavelmente com menos frequencia. Ns normalmente disponibilizamos os patches logo que localizamos e corrigimos o pequenos bugs. Eles normalmente so imediatamente disponibilizados em nosso a repositrio publico do BitKeeper. Eles sero inclu o a idos na prxima distribuio. o ca Para bugs no criticos, mas irritantes, disponibilizamos patches se eles so enviados a a para ns. De qualquer forma, iremos combinar vrios deles em um patch maior. o a Se existitr, por algum motivo, um bug fatal numa verso criaremos uma nova release a o mais cedo poss ivel. Gostar iamos que outras empresas zessem isto tambm. e A verso estvel atual a 3.23; ns j mudamos o desenvolvimento em atividade para a a a e o a verso 4.0. Bugs contiuaro a ser corrigidos na verso estvel. No acreditamos em um a a a a a congelamento completo, pois isto abandona a correes de bugs e coisas que devem ser co feitas. Alguma coisa congelada signica que talvez possamos adicionar pequenas coisas que com certeza no afetar nada que j esteja funcionando. a a a O MySQL usa um esquema de nomes um pouco diferente da maioria dos outros produtos. Em geral relativamente seguro utilizar qualquer verso que tenha sido lanado a algumas e a c

Cap tulo 2: Instalao do MySQL ca

85

semanas e que no tenham sido sustitu por uma nova verso. Veja Seo 2.2.4 [Qual a ida a ca verso], Pgina 80. a a

2.2.7 Filosoa das Distribuioes - Nenhum Bug Conhecidos nas c Distribuioes c

Colocamos muito tempo e esforo em tornar nossas distribuies livres de erros. Pelo nosso c co conhecimento, no liberamos uma unica verso do MySSQL com qualquer erro conhecido a a fatal. Um erro fatal algo que faz o MySQL falhar com o uso normal, traz respostas erradas para e consultas normais ou tem um problema de segurana. c Ns temos documentados todos os problemas conhecidos, bugs e assuntos que so depeno a dentes das decises de projeto. Veja Seo 1.8.6 [Bugs], Pgina 54. o ca a Nosso objeto corrigir tudo que poss e e ivel, mas sem correr o risco de tornarmos uma verso menos estvel. Em certos casos, isto signica que podemos corrigir um problema a a na(s) verso(es) de desenvolvimento, mas no o corrigirmos na verso estvel (produo). a o a a a ca Naturalmente, documentamos tais problemas para que o usurios esteja ciente. a Aqui est um descrio de como nosso processo de contruo funciona: a ca ca Monitoramos erros de nossa lista de suporte ao cliente, a lista de email externa do MySQL e o banco de dados de bugs em http://bugs.mysql.com/. Todos os erros relatados em verses usadas so inseridos nio banco de dados de bugs. o a Quando corrigimos um erro, sempre tentamos fazer um caso de teste para ele e inclu i-lo em nosso sistema de teste para assegurar que o erro nunca retornar. (Cerca de 90% a de todos os erros corrigidos tm um caso de teste.) e Tambm criamos casos de teste para todos os novos recursos adicionados ao MySQL. e Antes de comearmos a fazer uma nova distribuio do MySQL, asseguramos que todos c ca os erros repetitiveis relatados para a verso do MySQL (3.23.x, 4.0.x, etc) esto cora a rigidos. Se algo for imposs de corrigir (devido a alguma deciso de projeto interno ivel a no MySQL), documentaremos isto no manual. Veja Seo 1.8.6 [Bugs], Pgina 54. ca a Ns fazemos uma construo para todas as plataformas para as quais suportamos o ca binrios (mais de 15 plataformas) e executamos nosso pacote de teste e benchmarks a para todas elas. No publicaremos um binrio para uma plataforma na qual os testes do pacote de a a benchmarks falharam. Se for um erro geral na fonte, o corrigimos e fazemos as contrues mais os teste em todos os sistemas novamente. co Se ns, durante a o porcesso de construo e teste (que leva de 2 a 3 dias) recebermos um o ca relatrio sobre um erro fatal (por exemplo, um que cause um core dump), o corrigiremos o e reiniciaremos o processo de construo). ca Depois de publicarmos os binrios em http://www.mysql.com/, enviamos um email a de anncio nas listas de email mysql e announce. Veja Seo 1.7.1.1 [Mailing-list], u ca Pgina 33. A mensagem de anncio contm uma lista de todas as alteraes da disa u e co tribuio e qualquer problema conhecido com ela. (A seo problemas conhecidos na ca ca notas das distribuies s tem sido necessria em algumas da distribuies.) co o a co

86

MySQL Technical Reference for Version 5.0.0-alpha

Para darmos acesso rapidamente aos nossos usurios dos ultimos recursos a do MySQL, fazemos uma nova distribuio do MySQL a cada 4-8 semanas. ca Instantneos do cdigo nte so contru a o a idos diariamente e esto dispon a iveios em http://downloads.mysql.com/snapshots.php. Se, depois da distribuio estar pronta, recebermos qualquer relatrio que houve (deca o pois de tudo) qualquer coisa criticamente errada com a construo em uma plataforma ca espec ica, corrigiremo-na imediatamente e liberaremos um nova distribuio a para ca aquela plataforma. Graas aos nosso grande base de usurios, problemas so encontrac a a dos rapidamente. Nosso registro para boas distribuies feitas muito boa. Nas ultimas 150 distribuies, co e co tivemos que fazer uma nova contruo para menos de 10 distribuies (em 3 destes ca co casos, o erro era uma biblioteca glibc com problema em uma de nossas mquinas que a levamos um longo tempo para encontrar.

2.2.8 Binrios MySQL compilados pela MySQL AB a

Como um servio, ns na MySQL AB fornecemos um conjunto de distribuies binrias do c o co a MySQL que so compiladas no nosso site ou em sites onde os clientes cordialmente nos do a a acesso as suas mquinas. a Em adio aos binrios forncedios em formatos de pacotes espec ca a icos da plataforma (veja Seo 2.1 [Quick Standard Installation], Pgina 60), oferecemos distribuies binrios para ca a co a outras plataformas atravs de arquivos tar compactados (.tar.gz). e Estas distribuies so geradas usando o script Build-tools/Do-compile que compila co a o cdigo fonte e cria o arquivo binrio em tar.gz usando scripts/make_binary_ o a distribution. Estes binrios so congurados e constru a a idos com os seguintes compiladores e opes. co Binrios constru a idos no sistema de desenvolvimento da MySQL AB: Linux 2.4.xx x86 com gcc 2.95.3 CFLAGS="-O2 -mcpu=pentiumpro" CXX=gcc CXXFLAGS="-O2 mcpu=pentiumpro -felide-constructors" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --disable-shared --withclient-ldflags=-all-static --with-mysqld-ldflags=-all-static Linux 2.4.xx Intel Itanium 2 com ecc (Intel C++ Itanium Compiler 7.0) CC=ecc CFLAGS="-O2 -tpp2 -ip -nolib_inline" CXX=ecc CXXFLAGS="-O2 -tpp2 -ip -nolib_inline" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile Linux 2.4.xx Intel Itanium com ecc (Intel C++ Itanium Compiler 7.0) CC=ecc CFLAGS=-tpp1 CXX=ecc CXXFLAGS=-tpp1 ./configure -prefix=/usr/local/mysql --with-extra-charsets=complex --enablethread-safe-client --enable-local-infile Linux 2.4.xx alpha com ccc (Compaq C V6.2-505 / Compaq C++ V6.3-006) CC=ccc CFLAGS="-fast -arch generic" CXX=cxx CXXFLAGS="fast -arch generic -noexceptions -nortti" ./configure -

Cap tulo 2: Instalao do MySQL ca

87

-prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --withmysqld-ldflags=-non_shared --with-client-ldflags=-non_shared --disable-shared Linux 2.4.xx s390 com gcc 2.95.3 CFLAGS="-O2" CXX=gcc CXXFLAGS="-O2 -felide-constructors" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared --with-client-ldflags=-all-static --with-mysqld-ldflags=-allstatic Linux 2.4.xx x86 64 (AMD64) com gcc 3.2.1 CXX=gcc ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared Sun Solaris 8 x86 com gcc 3.2.3 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="O3 -fno-omit-frame-pointer -felide-constructors -fnoexceptions -fno-rtti" ./configure --prefix=/usr/local/mysql -localstatedir=/usr/local/mysql/data --libexecdir=/usr/local/mysql/bin --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared --with-innodb Sun Solaris 8 sparc com gcc 3.2 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --with-named-z-libs=no --with-named-curseslibs=-lcurses --disable-shared Sun Solaris 8 sparc 64bit com gcc 3.2 CC=gcc CFLAGS="-O3 -m64 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -m64 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --with-named-z-libs=no --with-named-curses-libs=-lcurses --disable-shared Sun Solaris 9 sparc com gcc 2.95.3 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --with-named-curses-libs=-lcurses --disableshared

88

MySQL Technical Reference for Version 5.0.0-alpha

Sun Solaris 9 sparc com cc-5.0 (Sun Forte 5.0) CC=cc-5.0 CXX=CC ASFLAGS="-xarch=v9" CFLAGS="-Xa -xstrconst -mt -D_FORTEC_ -xarch=v9" CXXFLAGS="-noex -mt -D_FORTEC_ -xarch=v9" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --with-named-z-libs=no --enable-thread-safeclient --disable-shared IBM AIX 4.3.2 ppc com gcc 3.2.3 CFLAGS="-O2 -mcpu=powerpc -Wa,-many " CXX=gcc CXXFLAGS="-O2 -mcpu=powerpc -Wa,-many -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --with-named-z-libs=no --disable-shared IBM AIX 4.3.3 ppc com xlC_r (IBM Visual Age C/C++ 6.0) CC=xlc_r CFLAGS="-ma -O2 -qstrict -qoptimize=2 -qmaxmem=8192" CXX=xlC_r CXXFLAGS ="-ma -O2 -qstrict -qoptimize=2 -qmaxmem=8192" ./configure --prefix=/usr/local/mysql --localstatedir=/usr/local/mysql/data --libexecdir=/usr/local/mysql/bin --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --with-named-zlibs=no --disable-shared --with-innodb IBM AIX 5.1.0 ppc com gcc 3.3 CFLAGS="-O2 -mcpu=powerpc -Wa,-many" CXX=gcc CXXFLAGS="-O2 -mcpu=powerpc -Wa,-many -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --with-server-suffix="-pro" --enable-threadsafe-client --enable-local-infile --with-named-z-libs=no --disable-shared HP-UX 10.20 pa-risc1.1 com gcc 3.1 CFLAGS="-DHPUX -I/opt/dce/include -O3 -fPIC" CXX=gcc CXXFLAGS="DHPUX -I/opt/dce /include -felide-constructors -fno-exceptions -fno-rtti -O3 -fPIC" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client -enable-local-infile --with-pthread --with-named-thread-libs=-ldce --with-lib-ccflags=-fPIC --disable-shared HP-UX 11.11 pa-risc2.0 64 bit com aCC (HP ANSI C++ B3910B A.03.33) CC=cc CXX=aCC CFLAGS=+DD64 CXXFLAGS=+DD64 ./configure -prefix=/usr/local/mysql --with-extra-charsets=complex --enablethread-safe-client --enable-local-infile --disable-shared HP-UX 11.11 pa-risc2.0 32bit com aCC (HP ANSI C++ B3910B A.03.33) CC=cc CXX=aCC CFLAGS="+DAportable" CXXFLAGS="+DAportable" ./configure --prefix=/usr/local/mysql --localstatedir=/usr/local/mysql/data --libexecdir=/usr/local/mysql/bin --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared --with-innodb

Cap tulo 2: Instalao do MySQL ca

89

Apple Mac OS X 10.2 powerpc com gcc 3.1 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared FreeBSD 4.7 i386 com gcc 2.95.4 CFLAGS=-DHAVE_BROKEN_REALPATH ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --with-named-z-libs=notused --disable-shared QNX Neutrino 6.2.1 i386 with gcc 2.95.3qnx-nto 20010315 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared Os seguintes binrios so contru a a idos em sistemas de terceiros gentilmente cedidos para a MySQL AB pou outros usurios. Pou favor, note que eles s so fornecidos como cortesia. a o a Uma vez que a MySQL AB no tem total controle sobre estes sistemas, ns podemos fornecer a o apenas suporte limitado para os binrios constru a idos nestes sistemas. SCO Unix 3.2v5.0.6 i386 com gcc 2.95.3 CFLAGS="-O3 -mpentium" LDFLAGS=-static CXX=gcc CXXFLAGS="-O3 mpentium -felide-constructors" ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --with-named-z-libs=no --enable-thread-safeclient --disable-shared SCO OpenUnix 8.0.0 i386 com CC 3.2 CC=cc CFLAGS="-O" CXX=CC ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --with-named-z-libs=no --enable-thread-safeclient --disable-shared Compaq Tru64 OSF/1 V5.1 732 alpha com cc/cxx (Compaq C V6.3-029i / DIGITAL C++ V6.1-027) CC="cc -pthread" CFLAGS="-O4 -ansi_alias -ansi_args -fast inline speed -speculate all" CXX="cxx -pthread" CXXFLAGS="-O4 -ansi_alias -fast -inline speed -speculate all -noexceptions -nortti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --with-prefix=/usr/local/mysql --with-named-thread-libs="lpthread -lmach -lexc -lc" --disable-shared --with-mysqld-ldflags=all-static

90

MySQL Technical Reference for Version 5.0.0-alpha

SGI Irix 6.5 IP32 com gcc 3.0.1 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared FreeBSD 5.0 sparc64 com gcc 3.2.1 CFLAGS=-DHAVE_BROKEN_REALPATH ./configure --prefix=/usr/local/mysql --localstatedir=/usr/local/mysql/data --libexecdir=/usr/local/mysql/bin --with-extra-charsets=complex --enable-thread-safe-client --enable-local-infile --disable-shared --with-innodb As seguintes opes de compilao foram usadas nos pacotes binrios que a MySQL AB co ca a costumava fornecer no passado. Estes binrios no so mais atualizados, mas as opes de a a a co compilao so mantidas aqui com o propsito de referncia. ca a o e Linux 2.2.xx sparc com egcs 1.1.2 CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-extracharsets=complex --enable-thread-safe-client --enable-local-infile --enable-assembler --disable-shared Linux 2.2.x com x686 com gcc 2.95.2 CFLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 -mpentiumpro -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --enable-assembler --with-mysqldldflags=-all-static --disable-shared --with-extra-charsets=complex SunOS 4.1.4 2 sun4c com gcc 2.7.2.1 CC=gcc CXX=gcc CXXFLAGS="-O3 -felide-constructors" ./configure --prefix=/usr/local/mysql --disable-shared --with-extracharsets=complex --enable-assembler SunOS 5.5.1 (e acima) sun4u com egcs 1.0.3a ou 2.90.27 ou gcc 2.95.2 e mais novo CC=gcc CFLAGS="-O3" CXX=gcc CXXFLAGS="-O3 -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-low-memory --with-extra-charsets=complex --enable-assembler SunOS 5.6 i86pc com gcc 2.8.1 CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --with-low-memory --with-extra-charsets=complex BSDI BSD/OS 3.1 i386 com gcc 2.7.2.1 CC=gcc CXX=gcc CXXFLAGS=-O ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex BSDI BSD/OS 2.1 i386 com gcc 2.7.2 CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex

Cap tulo 2: Instalao do MySQL ca

91

AIX 2 4 com gcc 2.7.2.2 CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --with-extra-charsets=complex Qualquer que tenha mais opes otimizadas para qualquer das conguraes listadas acima co co pode sempre envi-los para a lista de email internals do MySQL. Veja Seo 1.7.1.1 a ca [Mailing-list], Pgina 33. a Distribuies RPM que anteceda o MySQL verso 3.22 so contribuies dos usurios. Os co a a co a RPMs gerados por ns da MySQL AB s comearam a ser fornecidos a partir da verso o o c a 3.22 do MySQL. Se voc deseja compilar uma verso para depurao do MySQL, voc deve adicionar --withe a ca e debug ou --with-debug=full para as linhas de congurao acima e remover qualquer ca opo -fomit-frame-pointer. ca Para distribuies do Windows, por favor, veja Seo 2.1.1 [Windows installation], co ca Pgina 60. a

2.2.9 Instalando uma Distribuio Binria do MySQL ca a

Este cap itulo cobre a instalao da distribuio binria do MySQL (.tar.gz Archives) para ca ca a vrias plataformas (veja MySQL binaries para uma lista detalhada). a Em adio a estes pacotes genricos, tambm oferecemos binrios em formatos de pacote ca e e a espec icos da plataforma para plataformas selecionadas. Veja Seo 2.1 [Quick Standard ca Installation], Pgina 60 para mais informaes sobre como\ intal-los. a co a As distribuies genricas do MySQL esto empacotados com arquivos GNU tar com comco e a pactao gzip (.tar.gz). Voc precisa das seguintes ferramentas para instalar um disca e tribuio binria do MySQL: ca a GNU gunzip para descompactar a distribuio. ca Um tar razovel para descompactar a distribuio. Sabemos que o GNU tar funciona. a ca Algumas implementaes tar que vm pr-instaladas como o sistema operacional (ex. co e e Sun tar) possuem problemas (com nome de arquivos grandes, por exemplo) Neste caso, voc deve instalar o GNU tar primeiro. e Se voc tiver problemas, sempre use mysqlbug ao enviar dvidas para a lista de email do e u MySQL. Mesmo se o problema no for um bug, mysqlbug colhe informaes do sistema que a co ajudaro os outros a solucionar o seu problema. Se no usar mysqlbug, voc ter diminu a a e a ida a probabilidade de conseguir a soluo do seu problema. Voc encontrar o mysqlbug no ca e a diretrio bin depois de descompactar a distribuio. Veja Seo 1.7.1.3 [Relato de erros], o ca ca Pgina 36. a Os comando bsicos que voc deve executar para instalar e usar uma distribuio binria a e ca a do MySQL so: a shell> groupadd mysql shell> useradd -g mysql mysql shell> cd /usr/local shell> gunzip < /path/to/mysql-VERSION-OS.tar.gz | tar xvf shell> ln -s full-path-to-mysql-VERSION-OS mysql shell> cd mysql

92

MySQL Technical Reference for Version 5.0.0-alpha

shell> scripts/mysql_install_db shell> chown -R root . shell> chown -R mysql data shell> chgrp -R mysql . shell> bin/mysqld_safe --user=mysql & Se a sua verso do MySQL mais antiga que a 4.0, substitua bin/safe_mysqld por a e bin/mysqld_safe no comando nal. Voc pode adicionar novos usurios usando o script bin/mysql_setpermission se voc e a e instalar os mdulos Perl DBI e DBD-mysql. o Uma descrio mais detalhada apresentada a seguir. ca e Para instalar uma distribuio binria, siga estes passos, ento proceda com a Seo 2.4 ca a a ca [Ps Instalao], Pgina 111, para a congurao da ps istalao e testes: o ca a ca o ca 1. Escolha o diretrio sob o qual voc deseja descompactar a distribuio e a mova para o e ca dentro dele. No exemplo a seguir, descompactamos a distribuio sob /usr/local e ca criamos um diretrio /usr/local/mysql dentro do qual o MySQL instalado. (As o e seguintes instrues, consequentemente, assumem que voc tem permisso para criar co e a arquivos em /usr/local. Se este diretrio protegido, voc precisar realizar a o e e a instalao como root.) ca 2. Obtenha um arquivo de distribuio de um dos sites listados em Seo 2.2.1 [Getting ca ca MySQL], Pgina 75. a As distribuies binrias do MySQL so fornecidas como arquivos tar compactados e co a a tem nomes como mysql-VERS~O-SO.tar.gz, onde VERS~O um nmero (por exemA A e u plo, 3.21.15) e SO indica o tipo de sistema operacional para o qual a distribuio ca e pretendida (por exemplo, pc-linux-gnu-i586). 3. Se voc ver uma distribuio binria marcada com o suxo -max, signica que o e ca a binrio tem suporte para tabelas transacionais e outros recursos. Veja Seo 4.8.5 a ca [mysqld-max], Pgina 343. Note que todos os binrios so contru a a a idos a partir da mesma distribuio fonte do MySQL. ca 4. Adicione um usurio e grupo para o mysqld ser executado: a shell> groupadd mysql shell> useradd -g mysql mysql Estes comandos adicionam o grupo mysql e o usurio mysql. A sintaxe para useradd a e groupadd podem diferir um pouco nas diversas verses de Unix. Eles tambmpodem o e ser chamado adduser e addgroup. Voc pode desejar criar o grupo e usurio com outro e a nome, diferente de mysql. 5. Chame o diretrio no qual se pretende fazer a instalao: o ca shell> cd /usr/local 6. Descompacte a distribuio, que criar o diretrio de instalao. Ento crie um link ca a o ca a simblico para aquele diretrio: o o shell> gunzip < /path/to/mysql-VERS~O-SO.tar.gz | tar xvf A shell> ln -s full-path-to-mysql-VERS~O-SO mysql A O primeiro comando cria um diretrio chamado mysql-VERS~O-SO. O segundo coo A mando cria um link simblico para o diretrio. Isto torna a referncia ao diretrio de o o e o instalao mais fcil, chamado como /usr/local/mysql. ca a

Cap tulo 2: Instalao do MySQL ca

93

7. Altere para p diretrio de instalao: o ca shell> cd mysql Voc encontrar diversos arquivos e subdiretrios no diretrio mysql. O mais impore a o o tante para propsitos de instalao so os subdiretrios bin e scripts. o ca a o bin Este diretrio contm o programa cliente e o servidor. Voc deve adicionar o e e o caminho completo deste diretrio a sua varivel de ambiente PATH e o a assim a sua shell encontrar o programa MySQL de forma apropriada. a Veja Apndice F [Variveis de ambiente], Pgina 1092. e a a

8.

9.

10.

11. 12.

Este diretrio contm o script mysql_install_db usado para inicializar o o e banco de dados mysql contendo a tabela de permisses que armazenam o o servidor de permisses de acesso. o Caso voc desejasse usar o mysqlaccess e a distribuio do MySQL est em um local e ca a diferente do padro, voc deve alterar a localizao para onde o mysqlaccess espera a e ca encontrar o cliente mysql. Edite o script bin/mysqlaccess aproximadamente na linha 18. Procure pela linha que se parece com a apresentada abaixo: $MYSQL = /usr/local/bin/mysql; # path to mysql executable Altere o caminho para o local onde o mysql atualmente est armazaenado em seu a sistema. Se voc no zer isto receber uma mensagem de erro Broken pipe quando e a a executar o mysqlaccess. Crie as tabelas de permisso do MySQL (necessrio apenas se voc no tiver instalado a a e a o MySQL anteriormente): shell> scripts/mysql_install_db Note que as verses mais antigas que a 3.22.10 iniciam o servidor MySQL quando voc o e executa o mysql_install_db. Isto no ocorre mais. a Altere o proprietrio dos binrios para o root e o proprietrio do diretrio de dados a a a o para o usurio com o quel voc executar o mysqld: a e a shell> chown -R root /usr/local/mysql/. shell> chown -R mysql /usr/local/mysql/data shell> chgrp -R mysql /usr/local/mysql/. O primeiro comando altera o atributo owner dos arquivos para o usurio root, o a segundo altera o atributo owner do diretrio de dados para o usurio mysql e o terceiro o a altera o atributo group para o grupo mysql. Se voc quiser instalar o suporte para a interface Perl DBI/DBD, veja Seo 2.7 [Perl e ca support], Pgina 164. a Se voc desejasse que o MySQL seja iniciado automaticamente quando voc iniciar a e e sua mquina, voc pode copiar support-files/mysql.server para o local onde o seu a e sistema tem os arquivos de inicializao. Mais informaes podem ser encontradas no ca co script support-files/mysql.server e em Seo 2.4.3 [Automatic start], Pgina 118. ca a

scripts

Depois de tudo estar descompactado e instalado, voc deve inicializar e testar a sua dise tribuio. ca Voc pode iniciar o servidor MySQL com o seguinte comando: e shell> bin/mysqld_safe --user=mysql &

94

MySQL Technical Reference for Version 5.0.0-alpha

Se a sua verso do MySQl for mais antiga do que a 4.0, substitua bin/safe_mysqld por a bin/mysqld_safe no comando. Agora prossiga com Seo 4.8.2 [mysqld_safe], Pgina 331 e Veja Seo 2.4 [Ps instalao], ca a ca o ca Pgina 111. a

2.3 Instalando uma distribuio com fontes do MySQL ca

Antes de voc continuar com as instalaes dos fontes, conra antes se nosso binrio est e co a a dispon para sua plataforma e se ela funcionar para voc. Ns colocamos muito esforo ivel a e o c para ter certeza que nossos binrios so contru a a idos com as melhores opes poss co iveis. Voc precisa das seguintes ferramentas para contruir e instalar o MySQL a partir do cdigo e o fonte: GNU gunzip para descompactar a distribuio. ca Um tar razovel para desempacotar a distribuio. Sabe-se que o GNU tar funciona. a ca Algumas implementaes tar que vm pr-instaladas como o sistema operacional (ex. co e e Sun tar) possuem problemas (com nome de arquivos grandes, por exemplo) Neste caso, voc deve instalar o GNU tar primeiro. e Um compilador ANSI C++ funcional. gcc >= 2.95.2, egcs >= 1.0.2 ou egcs 2.91.66, SGI C++, e SunPro C++ so alguns dos compiladores que sabemos que funcionam. a A libg++ no necessria quando o gcc for usado. gcc 2.7.x tem um bug que a e a torna imposs ivel compilar alguns arquivos C++ perfeitamente corretos, como o sql/sql_base.cc. Se voc possui somente o gcc 2.7.x voc deve atualiza-lo para e e conseguir compilar o MySQL. gcc 2.8.1 tambm conhecido por ter problemas em e e algumas plataformas portanto ele deve ser evitado se existir um novo compilador para a plataforma. gcc >= 2.95.2 recomendado quando compilar o MySQL Verso 3.23.x. e a Um bom programa make. GNU make sempre recomendado e algumas vezes e e necessrio. Se voc tiver problemas, recomendamos tentar o GNU make 3.75 ou mais a e novo. Se voc estiver usando uma verso recente de gcc, recente o bastante para entender a opo e a ca -fno-exceptions, MUITO IMPORTANTE que voc a use. De outra forma, voc pode e e e compilar um binrio que quebra randomicamente. Ns tambm recomendamos que voc use a o e e -felide-constructors e -fno-rtti juntas com -fno-exception. Se estiver com dvidas, u faa o seguinte: c CFLAGS="-O3" CXX=gcc CXXFLAGS="-O3 -felide-constructors -fno-exceptions \ -fno-rtti" ./configure --prefix=/usr/local/mysql --enable-assembler \ --with-mysqld-ldflags=-all-static Na maioria dos sistemas voc ir obter um binrio rpido e estvel com essas opes. e a a a a co Se voc tiver problemas, SEMPRE USE mysqlbug quando postar questes para a lista de e o email do MySQL Mesmo se o problema no for um bug, mysqlbug recolhe informaes a co do sistema que facilitar aos outros resolverem seu problema. Por no suar mysqlbug, a a voc perde a vantagem de ter seu problema resolvido! Voc ir encontrar mysqlbug no e e a

Cap tulo 2: Instalao do MySQL ca

95

diretrio scripts depois de desempacotar a distribuio. Veja Seo 1.7.1.3 [Bug reports], o ca ca Pgina 36. a

2.3.1 Viso geral da instalao rpida a ca a

Os comandos bsicos que voc deve executar para instalar o MysQL a partir da distribuio a e ca fonte so: a shell> shell> shell> shell> shell> shell> shell> shell> shell> shell> shell> shell> shell> groupadd mysql useradd -g mysql mysql gunzip < mysql-VERSION.tar.gz | tar -xvf cd mysql-VERSION ./configure --prefix=/usr/local/mysql make make install scripts/mysql_install_db chown -R root /usr/local/mysql chown -R mysql /usr/local/mysql/var chgrp -R mysql /usr/local/mysql cp support-files/my-medium.cnf /etc/my.cnf /usr/local/mysql/bin/mysqld_safe --user=mysql &

Se a sua verso do MySQL mais antiga que a 4.0, substitua bin/safe_mysqld por a e bin/mysqld_safe no comando nal. Se voc deseja ter suporte para tabelas InnoDB, voc deve editar o arquivo /etc/my.cnf e e e remover o caractere # antes dos parmetros que iniciam com innodb_.... Veja Seo 4.1.2 a ca [Option les], Pgina 216. Veja Seo 7.5.3 [InnoDB start], Pgina 644. a ca a Se voc iniciar de um RPM fonte, ento faa o seguinte: e a c shell> rpm --rebuild --clean MySQL-VERSION.src.rpm Isto ir criar um RPM binrio que voc pode instalar. a a e Voc pode adicionar novos usurios utilizando o script bin/mysql_setpermission se voc e a e instalar os mdulos Perl DBI e DBD-mysql. o Segue uma descrio mais detalhada. ca Para instalar uma distribuio fonte, siga os passos a seguir, ento prossiga para Seo 2.4 ca a ca [Post-installation], Pgina 111, para inicializao do ps-instalao e testes: a ca o ca 1. Escolha o diretrio sobre o qual voc deseja descompactar a distribuio e v para ele. o e ca a 2. Obtenha um arquivo de distribuio de algum dos sites listados em Seo 2.2.1 [Getting ca ca MySQL], Pgina 75. a 3. Se voc esta interessado em usar tabelas Berkeley DB com MySQL, voc precisar obter e e a uma verso com o patch do cdigo fonte do Berkeley DB. Por favor leia o capitulo sobre a o tabelas Berkeley DB antes de continuar. Veja Seo 7.6 [BDB], Pgina 698. ca a Distribuies fontes do MySQL so fornecidas como arquivos tar compactados e tem co a nomes como mysql-VERSION.tar.gz, onde VERSION um nmero como 5.0.0-alpha. e u 4. Adicione um usurio e grupo para o mysql executar assim: a

96

MySQL Technical Reference for Version 5.0.0-alpha

5.

6.

7.

8.

9.

10.

shell> groupadd mysql shell> useradd -g mysql mysql Estes comandos adicionam o grupo mysql e o usurio mysql. A sintaxe para useradd e a groupadd podem mudar um pouco em diferentes verses de Unix. Elas podem tambm o e ser chamadas adduser e addgroup. Voc pode escolher outros nomes para o usurio e e a grupo em vez de mysql. Descompacte a distribuio para o diretrio corrente: ca o shell> gunzip < /path/to/mysql-VERSION.tar.gz | tar xvf Este comando cria um diretrio com o nome mysql-VERSION. o Mude para o diretrio da distribuio descompactada: o ca shell> cd mysql-VERSION Note que agora voc deve congurar e construir o MySQL a partir deste diretrio raiz e o da distribuio. Voc no pode constru em um diretrio diferente. ca e a i-lo o Congure o release e compile tudo: shell> ./configure --prefix=/usr/local/mysql shell> make Quando voc executar configure, voc pode desejar especicar algumas opes. Exee e co cute ./configure --help para uma lista das opes. Seo 2.3.3 [configure options], co ca Pgina 98, discute algumas das opes mais usadas. a co Se o configure falhar, e voc for enviar uma mensagem para lista de email do MySQL e para pedir ajuda, por favor, inclua qualquer linhas de config.log que voc acha e que pode ajudar a resolver o problema. Tambm inclua as ultimas linhas da sa e ida de configure se o configure abortar. Envie o relatrio de erros usando o script o mysqlbug. Veja Seo 1.7.1.3 [Bug reports], Pgina 36. ca a Se a compilao falhar, veja Seo 2.3.5 [Compilation problems], Pgina 103, para uma ca ca a ajuda com um varios problemas comuns. Instalar tudo: shell> make install Voc deve executar este comando como root. e Crie as tabelas de permisses do MySQL (necessrias s se voc no tiver instalado o o a o e a MySQL anteriormente): shell> scripts/mysql_install_db Note que as verses do MySQL anteriores ` verso 3.22.10 iniciam o servidor MySQL o a a quando voc executa mysql_install_db. Isto no acontece mais! e a Altere o dono dos binrios para root e do diretrio dados para o usurio que ir a o a a executar o mysqld: shell> chown -R root /usr/local/mysql shell> chown -R mysql /usr/local/mysql/var shell> chgrp -R mysql /usr/local/mysql O primeiro comando altera o atributo de proriedade dos arquivos para o usurio root, a o segundo altera o atributo de propriedade do diretrio de dados para o usurio mysql, o a e o terceiro altera o atributo de grupo para o grupo mysql.

Cap tulo 2: Instalao do MySQL ca

97

11. Se voc deseja instalar suporte para a interface Perl DBI/DBD, veja Seo 2.7 [Perl e ca support], Pgina 164. a 12. Se voc deseja que o MySQL inicie automaticamente quando voc ligar sua mquina, e e a voc pode copiar support-files/mysql.server para o local onde seu sistema tem seus e arquivos de incializao. Mais informaes podem ser encontradas no prprio script ca co o support-files/mysql.server e em Seo 2.4.3 [Automatic start], Pgina 118. ca a Depois de tudo ter sido instalado, voc deve iniciar e testar sua distribuio usando este e ca comando: shell> /usr/local/mysql/bin/mysqld_safe --user=mysql & Se a sua verso do MySQL for mais antiga do que 4.0, substitua safe_mysqld por mysqld_ a safe no comando: Se o comando falhar imediatamente com mysqld daemon ended ento voc pode achar ala e guma informao no arquivo diretrio-dados-mysql/nome_maquina.err. A razo ca o a pode ser que voc j possua outro servidor mysqld sendo executado. Veja Seo 4.2 [Mule a ca tiple servers], Pgina 219. a Veja Seo 2.4 [Post-installation], Pgina 111. ca a

2.3.2 Aplicando patches

Algumas vezes patches aparecem na lista de mensagens ou so colocados na rea de patches a a do MySQL. (http://www.mysql.com/downloads/patches.html). Para aplicar um patch da lista de mensagens, salve a mensagem em que o patch aparece em um arquivo, mude para o diretrio raiz da sua distribuio fonte de seu MySQL e execute o ca estes comandos: shell> patch -p1 < patch-file-name shell> rm config.cache shell> make clean Patches do site FTP so distribu a idos como arquivos texto ou como arquivos compactados com gzip. Aplique um patch no formato texto como mostrado acima para patches da lista de mensagens. Para aplicar um patch compactado, mude para o diretrio raiz da rvore o a fonte do MySQL e execute estes comandos: shell> gunzip < patch-file-name.gz | patch -p1 shell> rm config.cache shell> make clean Depois de aplicar um patch siga as instrues para uma instalao normal a partir dos co ca fontes comeando com o passo ./configure. Depois de executar o passo make install, c reinicie seu servidor MySQL. Voc pode precisar derrubar algum servidor atualmente em execuo antes de executar make e ca install. (Use mysqladmin shutdown para fazer isto.) Alguns sistemas no lhe permitem a instalar uma nova verso do programa se ele substitui agum que estiver em execuo. a ca

98

MySQL Technical Reference for Version 5.0.0-alpha

2.3.3 Opes t co ipicas do configure

O script configure fornece uma grande gama de controle sobre como voc congura sua e distribuio MySQL. Normalmente voc faz isto usando opes na linha de comando do ca e co configure. Voc tambm pode alterar configure usando algumas variveis de ambiente. e e a Veja Apndice F [Environment variables], Pgina 1092. Para uma lista de opes suportadas e a co pelo configure, execute este comando: shell> ./configure --help Algumas das opes mais usadas normalmente com o configure esto descritas a seguir: co a Para compilar apenas as bibliotecas clientes do MySQL e programas clientes e no o a servidor, use a opo --without-server: ca shell> ./configure --without-server Se voc no possui um compilador C++, mysql no ir compilar (ele o programa e a a a e cliente que exige C++). Neste caso, voc pode remover o cdigo no configure que e o testa pelo compilador C++ e executar ./configure com a opo --without-server. ca O passo da compiao continuar tentaindo construir mysql, mas voc pode ignorar as ca a e advertncias sobre mysql.cc. (Se o make parar, tente make -k para continuar com o e resto da compilao mesmo se erros ocorrerem.) ca Se voc quiser uma biblioteca embutida do MySQL (libmysqld.a) voc deve usar a e e opo --with-embedded-server. ca Se voc no deseja que seus arquivos de logs e diretrios de bancos de dados quem e a o localizados sobre /usr/local/var, use o comando configure; algo parecido com um destes: shell> ./configure --prefix=/usr/local/mysql shell> ./configure --prefix=/usr/local \ --localstatedir=/usr/local/mysql/data O primeiro comando altera o diretrio instalao para que tudo seja instalado sobre o ca /usr/local/mysql em vez do padro /usr/local. O segundo comando preserva o a diretrio da instalao padro, mas altera a localizao padro para diretrios de bano ca a ca a o cos de dados (normalmente /usr/local/var) e altera para /usr/local/mysql/data. Depois de ter compilado o MySQL, voc pode alterar estas opoes com arquivos de e ca opes. Veja Seo 4.1.2 [Option les], Pgina 216. co ca a Se voc estiver usando Unix e deseja que o arquivo socket do MySQL que em um e diretrio diferente do padro (normalmente no diretrio /tmp ou /var/run) use o o a o comando configure da seguinte forma: shell> ./configure --with-unix-socket-path=/usr/local/mysql/tmp/mysql.sock Perceba que o arquivo fornecido deve ter um caminho absoluto ! Voc tambm pode, e e mais tarde, alterar a localizao de mysql.sock usando os arquivos de opes do ca co MySQL. Veja Seo A.4.5 [Problems with mysql.sock], Pgina 929. ca a Se voc deseja compilar programas linkeditados estaticamente (por exemplo, para criar e uma distribuio binria, obter mais velocidade, ou evitar problemas com algumas ca a distribuies Red Hat Linux), execute configure desta forma: co shell> ./configure --with-client-ldflags=-all-static \ --with-mysqld-ldflags=-all-static

Cap tulo 2: Instalao do MySQL ca

99

Se voc estiver usando gcc e no tem libg++ ou libstdc++ instalados voc pode dizer e a e ao configure para usar o gcc como seu compilador C++: shell> CC=gcc CXX=gcc ./configure Quando voc usar como seu compilador C++, ele no tentar ligar com o libg++ ou e a a libstdc++. Isto pode ser uma boa idia para se fazer se voc tiver as bibliotecas acimas e e instaladas, j que algumas verses destas bibliotecas tem causado problemas estranhos a o para usurios do MySQL no passado. a Segue algumas conguraes de variveis de ambiente comuns, dependendo do compico a lador que voc estiver usando: e Compiler Recommended options gcc 2.7.2.1 CC=gcc CXX=gcc CXXFLAGS="-O3 -felide-constructors" egcs 1.0.3a CC=gcc CXX=gcc CXXFLAGS="-O3 -felide-constructors -fnoexceptions -fno-rtti" gcc 2.95.2 CFLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 mpentiumpro \ -felide-constructors -fno-exceptions -fno-rtti" pgcc 2.90.29 or CFLAGS="-O3 -mpentiumpro -mstack-align-double" CXX=gcc newer \ CXXFLAGS="-O3 -mpentiumpro -mstack-align-double -felide-constructors \ -fno-exceptions -fno-rtti" Na maioria dos casos voc pode obter um binrio MySQL razoavelmente otimizado e a usando as opes acima e adicionar as seguintes opes para a linha de congurao: co co ca --prefix=/usr/local/mysql --enable-assembler \ --with-mysqld-ldflags=-all-static A linha completa de congurao dever ser, em outras palavras, algo como o seguinte ca a para todas as verses recentes do gcc: o CFLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 -mpentiumpro \ -felide-constructors -fno-exceptions -fno-rtti" ./configure \ --prefix=/usr/local/mysql --enable-assembler \ --with-mysqld-ldflags=-all-static Os binrios que fornecemos no site Web MySQL em http://www.mysql.com so toa a dos compilados com otimizao plena e deve ser perfeito para a maioria dos usurios. ca a Veja Seo 2.2.8 [Binrios do MySQL], Pgina 86. Existem algumas denies de ca a a co congurao que voc pode alterar para criar um binrio ainda mais rpido, mas ca e a a isto somente para usurios avanados. Veja Seo 5.5.3 [Compile and link options], e a c ca Pgina 456. a Se a construo falhar e produzir erros sobre seu compilador ou linkeditor no ca a estarem aptos para criarem a biblioteca compartilhada libmysqlclient.so.r# (r# um nmero de verso), voc pode evitar este problema fornecendo a opo e u a e ca --disable-share para o configure. Neste caso, configure no construir uma a a biblioteca libmysqlclient.so.* compartilhada. Voc pode congurar o MySQL para no usar valores de campos DEFAULT para campos e a no-NULL (isto , campos que no podem ser NULL). Veja Seo 1.8.5.2 [Restries NOT a e a ca co NULL], Pgina 53. a shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS ./configure Por padro, o MySQL usa o conjunto de caracteres ISO-8859-1 (Latin1). Para alterar a o conjunto padro, use a opo --with-charset: a ca

100

MySQL Technical Reference for Version 5.0.0-alpha

shell> ./configure --with-charset=CHARSET CHARSET pode ser um de big5, cp1251, cp1257, czech, danish, dec8, dos, euc_kr, gb2312, gbk, german1, hebrew, hp8, hungarian, koi8_ru, koi8_ukr, latin1, latin2, sjis, swe7, tis620, ujis, usa7, ou win1251ukr. Veja Seo 4.7.1 [Conjunto de carca acteres], Pgina 325. a Se voc desja converter os caracteres entre o servidor e o cliente, voc deve dar uma e e olhada no comando SET OPTION CHARACTER SET. Veja Seo 5.5.6 [SET OPTION], ca Pgina 460. a Cuidado: Se voc alterar o conjunto de caracteres depois de ter criado qualquer e tabela, voc deve executar myisamchk -r -q --set-character--set=charset em e cada tabela. Seus indices podem ser ordenados incorretamente. (Isto pode acontecer se voc instalar o MySQL, criar algumas tabelas, depois recongurar o MySQL para e usar um conjunto diferente de caracteres e reinstal-lo). a Com a opo --with-extra-charset=LISTA voc pode denir qual conjunto de carca e acteres adicionais deve ser compilado no servidor. Aqui LISTA uma lista de conjuntos de caracteres separados por espaos, complex e c para incluir todos caracteres que no podem ser carregados dinamicamente ou all a para incluir todos os conjuntos nos binrios. a Para congurar o MySQL com cdigo para depurao, use a opo --with-debug: o ca ca shell> ./configure --with-debug Isto inclui uma alocao segura de memria que pode encontrar alguns erros e ca o fornecer sa sobre o que est acontecendo. Veja Seo E.1 [Depurando o servidor], ida a ca Pgina 1079. a Se seus programas clientes usam threads, voc precisar tambm compilar uma verso e a e a thread-safe da biblioteca cliente do MySQL com as opes do congure --enableco thread-safe-client. Isto ir criar uma biblioteca libmysqlclient_r com o qual a voc dever ligar suas aplicaes que fazem uso de threads. Veja Seo 12.1.14 [Clientes e a co ca em threads], Pgina 863. a Opes que pertenam a sistemas particulares podem ser encontrados na seo com co c ca detalhes espec icos de sistemas neste manual. Veja Seo 2.6 [Notas espec ca icas do Sistema Operacional], Pgina 133. a

2.3.4 Instalando pela rvore de fontes do desenvolvimento a

CUIDADO: Voc deve ler esta seo somente se voc estiver interessado em nos ajudar a e ca e testar nossos novos cdigos. Se voc s deseja deixar o MySQL funcionando em seus sistema, o e o voc deve usar uma distribuio padro (pode ser uma distribuio binria ou fonte). e ca a ca a Para obter noss mais nova rvore de desenvolvimento, use estas instrues: a co 1. Faa download do BitKeeper em http://www.bitmover.com/cgi-bin/download.cgi. c Voc precisar do Bitkeeper 3.0 ou posterior para acessar nosso repositrio. e a o 2. Siga as instrues para instal-lo. co a 3. Depois que o BitKeeper estiver instalado, primeiro v ao diretrio no qual voc deseja a o e trabalhar e ento use um dos seguintes comandos para clonar o ramo da verso MySQL a a de sua escolha:

Cap tulo 2: Instalao do MySQL ca

101

Para clonar o ramo 3.23 (antigo), use este comando: shell> bk clone bk://mysql.bkbits.net/mysql-3.23 mysql-3.23 Para clonar o ramo 4.0 (estvel/produo), use este comando: a ca shell> bk clone bk://mysql.bkbits.net/mysql-4.0 mysql-4.0 Para clonar o ramo 4.1 alfa, use este comando: shell> bk clone bk://mysql.bkbits.net/mysql-4.1 mysql-4.1 Para clonar o ramo de desenvolvimento 5.0, use este comando: shell> bk clone bk://mysql.bkbits.net/mysql-5.0 mysql-5.0 Nos exemplos anteriores a rvore binria ser congurada no subdiretrio a a a o mysql-3.23/, mysql-4.0/, mysql-4.1/, ou mysql-5.0/ do diretrio atual. o Se voc est atrs de um rewall e s pode iniciar conexes HTTP, voc tambm pode e a a o o e e o BitKeeper via HTTP. Se vocE precisa usar um servidor proxy, simplesmente congure a varivel de ambiente a http_proxy para apontar para o seu proxy: shell> export http_proxy="http://seu.servidor.proxy:8080/" Agora, simplesmente substitua o bk:// com o http:// ao fazer um clone. Exemplo: shell> bk clone http://mysql.bkbits.net/mysql-4.1 mysql-4.1 O download inicial da rvore fonte pode demorar um pouco, dependendo da velocidade a de sua conexo; seja paciente. a 4. Voc precisar do GNU make, autoconf 2.53 (ou posterior), automake 1.5, e a libtool 1.4 e m4 para executar o prximo conjunto de comandos. Embora muitos o sistemas operacionais j venham com suas prprias implementaes do make, as a o co chances de que a sua compilao falhe com mensagens de erros estranhas so altas. ca a Consequentemente altamente recomendado usar o GNU make (algumas vezes e tambm chamado gmake). e Felizmente, um grande nmero de sistemas operacionais j vem com a ferramente GNU u a pr instalada ou so fornecidos pacotes de instalao da mesma. De qualquer forma, e a ca elas podem ser encontradas nos seguintes locais: http://www.gnu.org/software/autoconf/ http://www.gnu.org/software/automake/ http://www.gnu.org/software/libtool/ http://www.gnu.org/software/make/ Se voc estiver tentando congurar o MySQL 4.1 voc tambm precisar do bison e e e a 1.75. Verses mais antigas do bison podem exiobir este erro: sql_yacc.yy:#####: o fatal error: maximum table size (32767) exceeded. Nota: o tamanho mximo da a tabela no realmente excedido, o erro causado por um bug nas verses mais novas a e e o do bison. Verses do MySQL anteriores a 4.1 podem tambm compilar com outras impleo e mentaes yacc (e.g. BSD yacc 91.7.30). Para verses posteriores, GNU bison uma co o e exigncia. e O comando comum para fazer em uma shell : e

102

MySQL Technical Reference for Version 5.0.0-alpha

5.

6. 7.

8. 9.

10. 11.

cd mysql-4.0 bk -r edit aclocal; autoheader; autoconf; automake (cd innobase; aclocal; autoheader; autoconf; automake) # for InnoDB (cd bdb/dist; sh s_all ) # for Berkeley DB ./configure # Adicione suas op~es favoritas aqui co make Caso apaream alguns erros estranhos durantes este estgio, conra se voc realmente c a e tem a libtool instalada! Uma coleo de nossos scripts de congurao padres est localizada no subdiretrio ca ca o a o BUILD/. Se preferir, voc pode usar BUILD/compile-pentium-debug. Para compilar e em uma arquitetura diferente, modique o script removendo opes que so espec co a icas da arquitetura Pentium. Quando a construo estiver pronta, execute make install. Seja cuidadoso com isto ca em uma mquina de produo; o comando pode sobrescrever sua verso atual instaa ca a lada. Se voc tem outra instalao do MySQL, ns recomendamos que voc execute e ca o e ./configure com valores diferentes para as opes prefix, tcp-port e unix-socketco path que as usadas pelo seu servidor em produo. ca Seja rigido com sua nova instalao e tente fazer com que os novos recursos falhem. ca Inicie executando make test. Veja Seo 14.1.2 [MySQL test suite], Pgina 896. ca a Se voc chegar ao estgio make e a distribuio no compilar, por favor relate-o para e a ca a bugs@lists.mysql.com. Se voc instalou as ultimas verses das ferramentas GNU e o exigidas, e elas falharam tentando processar nossos arquivos de congurao, por faca vor informe isto tambm. Entretanto, se voc executar aclocal e obtm um erro de e e e command not found no o reporte.Tenha certeza que todas as ferramentas necessrias a a estejam instaladas e que sua varivel PATH esteja corretamente congurada para que a sua shell possa encontr-la. a Depois da operao inicial bk clone para obter a rvore fonte, voc deve executar bk ca a e pull periodicamente para obter as atualizaes. co Voc pode examinar o histrico de alteraes para a rvore com todos os dis usando bk e o co a sccstool. Se voc ver alguns dis estranhos ou cdigo sobre o qual voc tenha alguma e o e dvida, no hesite em enviar um e-mail para lista de email internals do MySQL. Veja u a Seo 1.7.1.1 [Mailing-list], Pgina 33. Alm disso, se voc acha que tem uma idia ca a e e e melhor em como fazer algo, envie um email para o mesmo endereo com um patch. bk c diffs ir produzir um patch para voc aps fazer as alteraes no cdigo fonte. Se a e o co o voc no tiver tempo para codicar sua idia, apenas envie uma descrio. e a e ca BitKeeper tem um timo utilitrio de ajudar que voc pode acessar via bk helptool. o a e Note que qualquer commit (bk ci ou bk citool) ir disparar o envio da mensagem com a as alteraes para nossa lista de email internos, bem como a submisso openlogging.org co a usual apenas com os comentrios da alterao. Geralmente voc no precisar usar a ca e a commit (j que o rvore pblica no permitir bk push), mas prefer usar o mtodo a a u a a e ivel e bk diffs descrito arteriormente.

Voc tambm pode procurar alteraes, comentrios e cdigo fonte online procurando por e e co a o ex. http://mysql.bkbits.net:8080/mysql-4.1 para MySQL 4.1. O manual est em uma rvore separad que pode ser clonada com: a a

Cap tulo 2: Instalao do MySQL ca

103

shell> bk clone bk://mysql.bkbits.net/mysqldoc mysqldoc Existe tambm um rvore pblica do BitKeeper para o MySQL Control Center e Connece a u tor/ODBC. Eles podem ser clonados da seguintes forma, respectivamente: Para clonar o MySQL Control center, use o seguinte comando: shell> bk clone http://mysql.bkbits.net/mysqlcc mysqlcc Para clonar o Connector/ODBC, use o seguinte comando: shell> bk clone http://mysql.bkbits.net/myodbc3 myodbc3

2.3.5 Lidando com Problemas de Compilao ca

Todos programas MySQL compilam de forma limpa sem alertas no solaris usando gcc. Em outros sistemas, alertas podem ocorrer devido a diferenas em arquivos include dos c sistemas. Veja Seo 2.3.6 [MIT-pthreads], Pgina 106 para avisos que podem ocorrer ca a usando MIT-pthreads. Para outros problemas, conra a lista abaixo. A soluo para vrios problemas envolve recongurao. Se voc precisa recongurar, faa ca a ca e c notas do seguinte: Se configure executado depois dele j ter sido chamado, ele pode usar informao e a ca que foi colhida durante a chamada anterior. Esta informao armazenada no arca e quivo config.cache. Quando configure inicia, ele procura por este arquivo, l seu e contedo, se ele existir, assumindo que aquela informao continua correta. Essa conu ca jetura invlida quando voc recongurar. e a e Cada vez que voc executa configure, voc deve executar make de novo para ree e compilar. Entretanto, voc pode desejar remover primeiro antigos arquivos objeto de e construes anteriores, porque eles foram compilados usando diferentes opes de conco co gurao. ca Para prevenir antigas informaes de conguraes ou arquivos objetos de serem usados, co co execute estes comandos antes de re-executar configure: shell> rm config.cache shell> make clean Uma alternativa, seria executar make distclean A lista abaixo descreve alguns dos problemas compilando o MySQL que tem sido encontrados com mais frequencia: Se voc obtm erros quando sql_yacc.cc como os mostrados abaixo, voc provavele e e mente tem de falta de memria ou espao de swap: o c Internal compiler error: program cc1plus got fatal signal 11 ou Out of virtual memory ou Virtual memory exhausted O problema que gcc necessita de grande quantidade de memria para compilar e o sql_yacc.cc com funes inline. Tente executando configure com a opo --withco ca low-memory:

104

MySQL Technical Reference for Version 5.0.0-alpha

shell> ./configure --with-low-memory Esta opo adiciona -fno-inline na a linha de compilao se voc estiver usando ca ca e gcc e -O0 se voc estiver usando outro programa. Voc deve tentar a opo --withe e ca low-memory mesmo se voc tiver muita memria e espao de swap que voc ache ser e o c e sucieente para no ocorrer erros. Este problema tem ocorrido mesmo em sistemas a com boas conguraes de hardware e a opo --with-low-memory geralmente corrige co ca isto. Por padro, configure escolhe c++ como o nome do compilador e GNU c++ liga com a lg++. Se voc estiver usando gcc, este comportamento pode causar problemas durante e a compilao, como o seguinte: ca configure: error: installation or configuration problem: C++ compiler cannot create executables. Voc podem tambm ter problemas durante a compilao relacionados ` g++, libg++ e e ca a ou libstdc++. Uma causa destes problemas que voc pode no ter g++ ou voc pode ter g++ mas no e e a e a ter o libg++ ou o libstdc++. De uma olhada no arquivo config.log. Ele deve conter a razo exata do porque seu compilador C++ no funciona! Para trabalhar evitando a a estes problemas, voc pode usar gcc como seu compilador C++. Tente congurar a e varivel de ambiente CXX para "gcc -O3". Por exemplo: a shell> CXX="gcc -O3" ./configure Isto funciona porque gcc compila cdigo fonte C++ to bem quanto g++ faz, mas no o a a ifaz a ligao em libg++ ou libstdc++ por padro. ca a Outra forma de corrigir estes problemas, com certeza, instalando g++, libg++ e e libstdc++. No entanto gostariamos de lhe recomendar a no usar libg++ ou a libstdc++ com o MySQL j que isto ir aumentar o tamanho do binrio do mysqld a a a sem lhe trazer nenhum benef icio. Algumas verses destas bibliotecas tambm tem o e causado problemas estranhos para os usurios MySQL no passado. a Usar gcc como compilador C++ tambm exigido, se voc quiser compilar o MySQL e e e com a funcionalidade RAID (veja Seo 6.5.3 [CREATE TABLE], Pgina 598 para ca a mais informaes sobre tipos de tabela RAID) e voc estiver usando o GNU gcc verso co e a 3 e acima. Se voc obter erros como estes abaixo durante o estgio de ligao quando e a ca voc congurar o MySQL para compilar com a opo --with-raid, tente usar o gcc e ca como o seu compilador C++ denindo a varivel de ambiente CXX mencionada acima: a gcc -O3 -DDBUG_OFF -rdynamic -o isamchk isamchk.o sort.o libnisam.a ../mysys/libmysys.a ../dbug/libdbug.a ../strings/libmystrings.a -lpthread -lz -lcrypt -lnsl -lm -lpthread ../mysys/libmysys.a(raid.o)(.text+0x79): In function my_raid_create: : undefined reference to operator new(unsigned) ../mysys/libmysys.a(raid.o)(.text+0xdd): In function my_raid_create: : undefined reference to operator delete(void*) ../mysys/libmysys.a(raid.o)(.text+0x129): In function my_raid_open: : undefined reference to operator new(unsigned) ../mysys/libmysys.a(raid.o)(.text+0x189): In function my_raid_open: : undefined reference to operator delete(void*) ../mysys/libmysys.a(raid.o)(.text+0x64b): In function my_raid_close:

Cap tulo 2: Instalao do MySQL ca

105

: undefined reference to operator delete(void*) collect2: ld returned 1 exit status ca e Se sua compilao falhar com erros, como um dos seguintes, voc deve atualizar sua verso de make para GNU make: a making all in mit-pthreads make: Fatal error in reader: Makefile, line 18: Badly formed macro assignment or make: file Makefile line 18: Must be a separator (: or pthread.h: No such file or directory O Solaris e o FreeBSD so conhecidos por terem alguns problemas com o make. a O GNU make verso 3.75 ir funcionar. a a Se voc deseja denir algumas opes que devem ser usadas pelo seu compilador C ou e co C++, adicione as opes para as variveis de ambiente CFLAGS e CXXFLAGS. Voc pode co a e tambm especicar os nomes do compilador a ser usado da mesma forma utilizando CC e e CXX. Exemplo: shell> shell> shell> shell> shell> CC=gcc CFLAGS=-O3 CXX=gcc CXXFLAGS=-O3 export CC CFLAGS CXX CXXFLAGS

Olhe em Seo 2.2.8 [MySQL binaries], Pgina 86 para uma lista de denio de opes ca a ca co que tenham sido uteis em vrios sistemas. a Se voc recebeu uma mensagem de erro como esta, necessrio atualizar o compilador e e a gcc: O gcc 2.8.1 funciona, mas recomendamos o uso do gcc 2.95.2 ou egcs 1.0.3a em seu lugar. Se voc obtem erros como estes vistos abaixo enquanto estiver compilando o mysqld, e o configure no detectou corretamente o tipo do ultimo argumento para accept(), a getsockname() ou getpeername(): cxx: Error: mysqld.cc, line 645: In this statement, the referenced type of the pointer value "&length" is "unsigned long", which is not compatible with "int". new_sock = accept(sock, (struct sockaddr *)&cAddr, &length); Para corrigir isto, edite o arquivo config.h (que gerado pelo configure). Procure e por estas linhas: /* Define as the base type of the last arg to accept */ #define SOCKET_SIZE_TYPE XXX Altere XXX para size_t ou int, dependendo de seu sistema operacional. (Perceba que voc dever fazer isto cada vez que voc executar configure, porque configure e a e regenera config.h.)

106

MySQL Technical Reference for Version 5.0.0-alpha

O arquivo sql_yacc.cc gerado pelo sql_yacc.yy. Normalmente o processo de e construo no necessita criar sql_yacc.cc, porque o MySQL j vem com uma cpia ca a a o pr-gerada. Entretanto, se voc necessita recri-lo voc pode encontrar este erro: e e a e "sql_yacc.yy", line xxx fatal: default action causes potential... Isto um ind de que sua verso do yacc deciente. Provavelmente voc precisar e icio a e e a instalar o bison (a verso GNU de yacc) e us-lo no lugar do yacc. a a Se voc necessita depurar mysqld ou um cliente MySQL, execute configure com a e opo --with-debug, ento recompile e ligue seus clientes com a nova biblioteca cliente. ca a Veja Seo E.2 [Debugging client], Pgina 1085. ca a Se voc tem um erro de compilao no Linux (ex. SuSE Linux 8.1 ou Red Hat Linux e ca 7.3) parecido com o seguinte: libmysql.c:1329: warning: passing arg 5 of gethostbyname_r from incompatible p libmysql.c:1329: too few arguments to function gethostbyname_r libmysql.c:1329: warning: assignment makes pointer from integer without a cast make[2]: *** [libmysql.lo] Error 1 Por padro, o script configure tenta determinar o nmero correto de argumentos a u usando o compilador GNU C++ g++. Ele testa os resultados errados permitidos, se o g++ no est instalado. Existem dois modos de contornar este problema: a a Certique-se de que o GNU C++ g++ est instalado. Em algumas distribuies a co Linux, o pacote exigido chamado gpp, em outro ele chamado gcc-c++. e e Use o gcc como o seu compilador C++ congurando a variavel de ambiente CXX a para gcc: export CXX="gcc" Note que voc precisa executar o configure novamente aps isto. e o

2.3.6 Notas MIT-pthreads

Esta seo descreve alguns dos detalhes envolvidos no uso de MIT-pthreads. ca Note que no Linux voc N~O deve usar MIT-pthreads mas instalar LinuxThreads! Veja e A Seo 2.6.2 [Linux], Pgina 137. ca a Se seu sistema no fornece suporte nativo a thread, voc precisar construir o MySQL a e a usando o pacote MIT-pthreads. Isto inclui antigos sistemas FreeBSD, SunOS 4.X, Solaris 2.4 e anteriores entre outros. Veja Seo 2.2.3 [Qual SO], Pgina 78. ca a Note que a partir do MySQL 4.0.2, MIT-pthreads no fazem mais parte da distribuio a ca fonte. Se voc precisar deste pacote, voc precisa fazer o download dele separadamente em e e http://www.mysql.com/Downloads/Contrib/pthreads-1_60_beta6-mysql.tar.gz Depois do download, extraia este arquivo fonte no n mais alto do diretrio de fontes do ivel o MySQL. Ele criar um novo subdiretrio mit-pthreads. a o Na maioria dos sitemas, voc pode forar o uso de MIT-pthreads executando o e c configure com a opo --with-mit-threads: ca shell> ./configure --with-mit-threads Construo em um diretrio no fonte no suportado com o uso de MIT-pthreads, ca o a a e porque ns queremos minimizar nossas alteraes para este cdigo. o co o

Cap tulo 2: Instalao do MySQL ca

107

As vericaes que determinam se MIT-pthreads ser usado ou no, ocorrer somente co a a a durante a parte do processo de congurao que trata com o cdigo do servidor. Se voc ca o e congurou a distribuio usando --without-server para construir somente o cdigo ca o cliente, clientes no iro saber se o MIT-pthreads est sendo usado e ir usar conexes a a a a o socket Unix por padro. Como os sockets Unix no funcionam sob MIT-pthreads, isto a a signica que voc precisar usar -h ou --host quando executar programas clientes. e a Quando o MySQL compilado usando MIT-pthreads, travas de sistema so desabile a itadas por padro por razes de performance. Voc pode dizer ao servidor para usar a o e travas de sistema com a opo --external-locking. Isto s necessrio se voc ca o e a e quiser executar dois servidores MySQL no mesmo diretrio de dados (no que no o a e recomendado) Algumas vezes o comando pthread bind() falha ao ligar a um socket sem nenhuma mensagem de erro (pelo menos no Solaris). O resultado que todas conexes ao servidor e o falham. Por exemplo: shell> mysqladmin version mysqladmin: connect to server at failed; error: Cant connect to mysql server on localhost (146) A soluo para isto matar o servidor mysqld e reinici-lo. Isto s aconteceu conosco ca e a o quando foramos uma queda do servidor e zemos uma reinicializao imediata. c ca Com MIT-pthreads, a chamada de sistema sleep() no interromp com SIGINT a e ivel (break). Isto s percebido quando voc executa mysqladmin --sleep. Voc deve esoe e e perar pela chamada sleep() para terminar, antes da interruo ser servida e o processo ca parar. Na ligao, voc pode receber mensagens de alerta como estes (pelo menos no Solaris); ca e elas podem ser ignoradas: ld: warning: symbol _iob has differing sizes: (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4; file /usr/lib/libc.so value=0x140); /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken ld: warning: symbol __iob has differing sizes: (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4; file /usr/lib/libc.so value=0x140); /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken Alguns outros alertas tambm podem ser ignorados: e implicit declaration of function int strtoll(...) implicit declaration of function int strtoul(...) No colocamos readline para funcionar com MIT-pthreads. (Isto no necessrio, a a e a mas pode ser interessante para alguns.)

2.3.7 Instalando o MySQL a partir do Fonte no Windows

Estas instrues descrevem como construir o binrio do MySQL a partir do fonte paras co a verses 4.1 e acima no Windows. As instrues so fornecidas para construir binrios a o co a a partir de uma distribuio fonte padro ou a partir da rvore do BitKeeper que contm o ca a a e fonte do desenvolvimento mais atuais.

108

MySQL Technical Reference for Version 5.0.0-alpha

Nota: As instrues neste documento esto restritas aos usurios que queiram testar o co a a MySQL no Windows a partir da ultima distribuio fonte ou da rvore do BitKeeper. ca a Para uso em produo, a MySQL AB no aconselha que voc utilize um servidor MySQL ca a e constru por voc mesmo a partir de um fonte. Normalmente melhor usar uma disido e e especicamente para desemtribuio binria precompilada do MySQL que construida ca a e penho otimizado no Windows pela MySQL AB. Instrues para instalar uma distribuio co ca binria est dispon em Seo 2.1.1 [Windows installation], Pgina 60. a a ivel ca a Para construir o MySQL no Windows a partir do fonte, voc precisa dos seguintes compie ladores e recursos dison iveis em seu sistema Windows: Compilador VC++ 6.0 (atualizado com o SP 4 ou 5 e pacote Pre-processador) O pacote Pre-processador necessrio para a macro assembler. Mais detalhes em: e a http://msdn.microsoft.com/vstudio/downloads/updates/sp/vs6/sp5/faq.aspx. Aproximadamente 45 MB de espao em disco. c 64 MB de RAM Voc tambm precisar de um distribuio fonte para o Windows. Existem dois modos de e e a ca conseguir uma distribuio fonte do MySQL verso 4.1 e acima: ca a 1. Obtenha um pacote de uma distribuio fonte pela MySQL AB para a verso do ca a MySQL que voc est particularmente interessado. Distribuies fontes empacotadas e a co esto dispon a iveis para verses distribu o idas do MySQ e podem ser obtidas em http://www.mysql.com/downloads/. 2. Voc pode empacotar um distribuio fonte voc mesmo a partir da ultima rvore fonte e ca e a de desenvolvimento do BitKeeper. Se voc planeja fazer isto, voc deve criar o pacote e e em um sistema Unix e ento transfr para seu sistema Windows. (A razo para isto a i-lo a e que alguns dos passos de congurao e construo exigem ferramentas que funcionam ca ca apenas no Unix.) A abordagem do BitKeeper, exige: Um sistema executando Unix ou um sistema tipo Unix, como o Linux BitKeeper 3.0 instalado neste sistema. Voc pode obter o BitKeeper em e http://www.bitkeeper.com/. Se voc estiver usando uma distribuio fonte do Windows, voc pode ir diretamente para e ca e Seo 2.3.7.1 [Windows VC++ Build], Pgina 108. Para contruir a partir da rvore do ca a a BitKeeper, v para Seo 2.3.7.2 [Windows BitKeeper Build], Pgina 110. a ca a Se voc encontrar alguma coisa que no est funcionando como esperado, ou tiver sugestes e a a o sobre o mode de melhorar o processo de construo atual no Windows, envie uma mensagem ca para a lista de email win32. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a

2.3.7.1 Construindo o MySQL Usando VC++

Nota: O MySQL 4.1 e arquivos do espeo de trabalho do VC++ so compat c a iveis com o Microsoft Visual Studio 6.0 e as edies acima (7.0/.NET) e testados pela equipe da MySQL co AB antes de cada distribuio. ca Siga este procedimento para construir o MySQL: 1. Crie um diretrio de trabalho (ex.: workdir). o 2. Descompacte a distribuio fonte no diretrio mencionado acima usando Winzip ou ca o outra ferramenta que possa ler arquivos .zip.

Cap tulo 2: Instalao do MySQL ca

109

3. Inicie o compilador VC++ 6.0. 4. No menu File, selecione Open Workspace. 5. Abra o workspace mysql.dsw que voc encontrar no diretrio de trabalho. e o 6. No menu Build, selcione o menu Set Active Configuration. 7. Clique sobre a tela selecionada mysqld - Win32 Debug e clique OK. 8. Pressione F7 para iniciar a construo da depurao do servidor, bibliotecas e alguns ca ca aplicativos clientes. 9. Compile as verses distribu o idas que voc desejar, do mesmo modo. e 10. Verses depuradas dos programas e bibliotecas so colocados nos diretrios o a o client_debug e lib_debug. Verses liberadas dos programas e bibliotecas so o a colocados nos diretrios client_release e lib_release. Note que se voc quiser o e construir tanto verses liberadas quanto depuradas voc pode selecionar a opo o e ca build all do menu Build. 11. Teste o servidor. O servidor constru usando as instrues anteriores ir esperar que ido co a o diretrio base e de dados do MySQL seja C:\mysql e C:\mysql\data por padro. o a Se voc quiser testar o seu servidor usando o diretrio raiz de uma rvore fonte e seu e o a diretrio de dados como o diretrio base e o diretrio de dados, voc precisar dizer ao o o o e a servidor os seus caminhos. Voc tambm pode fazer into na linha de comando com as e e opes --basedir e --datadir, ou colocar opes apropriadas no arquivo de opes (o co co co arquivo C:\my.cnf ou my.ini no diretrio do Windows). Se voc tiver um diretrio o e o de dados existente em qualquer lugar que voc queira usar, voc pode especic-lo no e e a se caminho. 12. Inicie o ser servidor a partir do diretrio client_release ou client_debug, depeno dendo de qual servidor voc queira usar. O instrues gerais de inicializao do servidor e co a esto em Seo 2.1.1 [Windows installation], Pgina 60. Voc precisar adaptar as a ca a e a instrues de forma apropriada se voc quiser usar um diretrio base ou diretrio de co e o o dados diferente. 13. Quando o servidor est em execuo de modo independente ou como um servio daseado a ca c em sua congurao, tente se conectar a ele pelo utilitrio interativo mysql de linha de ca a comando que existe em seu diretrio client_release ou client_debug. o Quando voc estiver certo de que os programas que voc construiu esto funcionando core e a retamente, pare o servidor. Ento instale o MySQL da seguinte forma: a 1. Crie o diretrio para instalar os arquivos do MySQL. Por exemplo, para instalar dentro o de C:\mysql), use estes comandos: C: mkdir mkdir mkdir mkdir mkdir \mysql \mysql\bin \mysql\data \mysql\share \mysql\scripts

Se voc quiser compilar outros clientes e lig-los ao MySQL, voc tambm deve criar e a e e diversos diretrios adicionais: o mkdir \mysql\include

110

MySQL Technical Reference for Version 5.0.0-alpha

mkdir \mysql\lib mkdir \mysql\lib\debug mkdir \mysql\lib\opt Se voc quiser fazer um benchamrk do MySQL, crie este diretrio: e o mkdir \mysql\sql-bench Benchmark exigem suporte Perl. 2. Copie do diretrio workdir para o diretrio c:\mysql os seguintes diretrios: o o o copy client_release\*.exe C:\mysql\bin copy client_debug\mysqld.exe C:\mysql\bin\mysqld-debug.exe xcopy scripts\*.* C:\mysql\scripts /E xcopy share\*.* C:\mysql\share /E Se voc quiser compilar outros clientes e lig-los ao MySQL, voc tambm deve fazer e a e e isto: copy copy copy copy copy copy copy copy lib_debug\mysqlclient.lib C:\mysql\lib\debug lib_debug\libmysql.* C:\mysql\lib\debug lib_debug\zlib.* C:\mysql\lib\debug lib_release\mysqlclient.lib C:\mysql\lib\opt lib_release\libmysql.* C:\mysql\lib\opt lib_release\zlib.* C:\mysql\lib\opt include\*.h C:\mysql\include libmysql\libmysql.def C:\mysql\include

Se voc quiser fazer um benchmark do MySQL, voc tambm deve fazer isto: e e e xcopy sql-bench\*.* C:\mysql\bench /E Congure e inicie o servidor da mesma forma que a distribuio binria do Windows. Veja ca a Seo 2.1.1.3 [Windows prepare environment], Pgina 62. ca a

2.3.7.2 Criando um Pacote Fonte do Windows a partir da Ultima Fonte de Desenvolvimento

Para construir o ultimo pacote fonte do Windows a partir da arvor fonte atual do Bit e Keeper, use as seguintes instrues. Por favor, note que este procedimento deve ser realco izado em um sistema executando um sistema opercional Unix ou similar. (Sabe-se que este procedimento funciona bem com o Linux, por exemplo.) 1. Clone a rvore fonte do BitKeeper para o MySQL (verso 4.1 ou acima, como desea a jado). Para mais informaes sobre como clonar a rvore fonte veja as instrues em co a co Seo 2.3.4 [Installing source tree], Pgina 100. ca a 2. Congure e construa as distribuies para que voc tenha um binrio do servidor para co e a trabalhar. Um modo de se fazer isto executar o seguinte comando no diretrio de e o mais alto n de sua rvore fonte: ivel a shell> ./BUILD/compile-pentium-max 3. Depois de se certicar que o processo de construo foi completado com sucesso, execute ca o seguinte script utilitrio a a partir do diretrio de n mais alto da sua arvore fonte: a o ivel

Cap tulo 2: Instalao do MySQL ca

111

shell> ./scripts/make_win_src_distribution Este script cria um pacote fonte Windows. para ser usado em seu sistema Windows. Voc pode fornecer diferentes opes para o script baseado em suas necessidades. Ele e co aceita as seguintes opes: co --debug --tmp --suffix --dirname --silent --tar --help Depura, sem criar o pacote Especifica a localiza~o temporria ca a Nome de sufixo para o pacote Nome do diretrio onde os arquivos s~o copiados (intermediario) o a N~o apresenta uma lista dos arquivos processados a Cria um pacote tar.gz em vez de .zip Mostra esta mensagem de ajuda

Por padro, make_win_src_distribution cria um arquivo zipado com o nome a mysql-VERSION-win-src.zip, onde VERSION representa a verso de sua rvore fonte a a do MySQL. 4. Faa uma copia ou upload para a sua mquina o pacote fonte Windows que voc tiver c a e criado. Para compil-lo use as instrues em Seo 2.3.7.1 [Windows VC++ Build], a co ca Pgina 108. a

2.4 Conguraes e Testes Ps-instalao co o ca

Uma vez instalado o MySQL (de uma distribuio binria ou fonte), voc deve inicializar ca a e as tabelas de concesses, iniciar o servidor e ter certeza que o servidor est funcionando o a bem. Voc pode tambm desejar que o servidor inicie e pare automaticamente quando seu e e sistema iniciar e desligar. Normalmente voc instala as tabelas de concesses e inicia o servidor assim para instalaes e o co baseadas em uma distribuio fonte: ca shell> ./scripts/mysql_install_db shell> cd diretorio_instala~o_mysql ca shell> ./bin/mysqld_safe --user=mysql & Para uma distribuio binria (sem ser pacotes RPM ou PKG), faa isto: ca a c shell> cd diretorio_instala~o_mysql ca shell> ./bin/mysql_install_db shell> ./bin/mysqld_safe --user=mysql & O script mysql_install_db cria o banco de dados mysql que ir armazenar todos privilgios a e do banco de dados, o banco de dados test que voc poder usar para testar o MySQL e e a tambm entradas de privilgio para o usurio que usa o mysql_install_db e o usurio e e a a root. As estrandas so criadas sem senhas. O script mysqld_safe inicia o servidor mysqld. a (Se sua verso for anterior a 4.0, use safe_mysqld em vez de mysqld_safe.) a mysql_install_db no ir sobrescrever nenhuma tabela de privilgios antiga, ento deve a a e a ser seguro execut-lo em quaisquer circunstncias. Se voc no deseja ter o banco de dados a a e a test voc pode remov-lo com mysqladmin -u root drop test depois de iniciar o servidor. e e Testes so geralmente facilmente feitos de um diretrio raiz da distribuio MySQL. a o ca Para uma distribuio binria, este seu diretrio de instalao (normalmente algo como ca a e o ca

112

MySQL Technical Reference for Version 5.0.0-alpha

/usr/local/mysql). Para uma distrubuio fonte, este o diretrio principal da sua ca e o rvore fonte do MySQL. a Nos comandos mostrados abaixo nesta seo e nas seguintes subsees, BINDIR o caminho ca co e para a localizao na qual os programas como mysqladmin e mysqld_safe esto instalados. ca a Para uma distribuio binria este o diretrio bin. Para uma distribuio fonte, BINDIR ca a e o ca provavelmente /usr/local/bin, a menos que voc especique um diretrio de instalao e e o ca diferente de /usr/local quando voc executa configure. EXECDIR a localizao na qual e e ca o servidor mysqld est instalado. Para uma distribuio binria, isto o mesmo que BINDIR. a ca a e Para uma distribuio fonte, EXECDIR provavelmente /usr/local/libexec. ca e Os testes so descritos em detalhes abaixo: a 1. Se necessrio, inicie o servidor mysqld e congure as tabelas de concesses iniciais a o contendo os privilgios que determinam como os usurios esto permitidos a conectar e a a ao servidor. Isto feito normalmente com o script mysql_install_db: e shell> scripts/mysql_install_db Normalmente, mysql_install_db precisa ser executado somente na primeira vez que voc instala o MySQL. Portanto, se voc estiver atualizando uma instalao existente, e e ca voc pode pular este passo. (entretanto, mysql_install_db realmente seguro de usar e e e no ir atualizar nenhuma tabela que j exista, ento se voc no tem certeza do que a a a a e a fazer, voc pode sempre executar mysql_install_db.) e mysql_install_db cria seis tabelas (user, db, host, tables_priv, columns_priv e func) no banco de dados mysql. Uma descrio dos privilgios iniciais fornecido ca e e em Seo 4.4.4 [Default privileges], Pgina 260. De forma resumidao, estes privilgios ca a e permitem que o usurio root faa qualquer coisa no MySQL, e permitem a qualquer a c um a criar ou usar bancos de dados com o nome de test ou iniciando com test_ . Se voc no congurar as tabelas de concesses, o seguinte erro ir aparecer no arquivo e a o a log quando voc no iniciar o servidor: e a mysqld: Cant find file: host.frm O erro acima pode tambm ocorrer com uma distribuio binria do MySQL se voc e ca a e no iniciar o MySQL executando o ./bin/mysqld_safe! Veja Seo 4.8.2 [mysqld_ a ca safe], Pgina 331. a Voc deve precisar executar mysql_install_db como root. Entretanto, se voc e e preferir, pode executar o servidor MySQL como um usurio (no-root) sem a a privilgios, desde que o usurio possa ler e escrever arquivos no diretrio de banco e a o de dados. Instrues para executar o MySQL como um usurio sem privilgios co a e e detalhado em Seo A.3.2 [Alterando usurios MySQL], Pgina 923 ca a a Se voc tiver problemas com o mysql_install_db, veja Seo 2.4.1 [mysql_install_ e ca db], Pgina 115. a Existem algumas alternativas para executar o script mysql_install_db como ele e fornecido na distribuio MySQL: ca Voc pode querer editar o mysql_install_db antes de execut-lo, para alterar os e a privilgios iniciais que so instalados nas tabelas de concesses. Isto util se voc e a o e e deseja instalar o MySQL em vrias mquinas com os mesmos privilgios. Neste a a e caso, provvel que voc s precise adicionar algumas instrues INSERT extras e a e o co para as tabelas mysql.user e mysql.db.

Cap tulo 2: Instalao do MySQL ca

113

Se voc deseja alterar o contedo da tabelas de concesses depois de instale u o a las, voc pode executar mysql_install_db, ento usar mysql -u root mysql para e a conectar `s tabelas de concesses como o usurio root e usar instrues SQL para a o a co modic-las diretamente. a E poss recriar as tabelas de permisses completamente depois delas j terem ivel o a sido criadas. Voc pode querer fazer isto se voc j instalou as tabelas mas deseja e e a recri-las depois das edies mysql_install_db. a co Para maiores informaes sobre estas alternativas, veja Seo 4.4.4 [Default privileges], co ca Pgina 260. a 2. Inicie o servidor MySQL assim: shell> cd diretorio_instalacao_mysql shell> bin/mysqld_safe & Se a sua verso do MySQL for mais antiga do que 4.0, substitua bin/safe_mysqld por a bin/mysqld_safe no comando: Se voc tiver problemas iniciando o servidor, veja Seo 2.4.2 [Starting server], e ca Pgina 116. a 3. Use mysqladmin para vericar se o servidor est em execuo. Os seguintes comana ca dos fornecem um teste simples para conferir se o servidor est em funcionamento e a respondendo `s conexes: a o shell> BINDIR/mysqladmin version shell> BINDIR/mysqladmin variables de mysqladmin version varia muito pouco dependendo de sua plataforma e A saida verso do MySQL, mas deve ser similar a esta mostrada abaixo: a shell> BINDIR/mysqladmin version mysqladmin Ver 8.14 Distrib 3.23.32, for linux on i586 Copyright (C) 2000 MySQL AB & MySQL Finland AB & TCX DataKonsult AB This software comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to modify and redistribute it under the GPL license. Server version Protocol version Connection TCP port UNIX socket Uptime: 3.23.32-debug 10 Localhost via Unix socket 3306 /tmp/mysql.sock 16 sec

Threads: 1 Questions: 9 Slow queries: 0 Opens: 7 Flush tables: 2 Open tables: 0 Queries per second avg: 0.000 Memory in use: 132K Max memory used: 16773K Para ter uma idia do que voc pode fazer com BINDIR/mysqladmin, invoque-o com a e e opo --help. ca 4. Verique se voc pode desligar o servidor: e shell> BINDIR/mysqladmin -u root shutdown

114

MySQL Technical Reference for Version 5.0.0-alpha

5. Verique que voc possa reiniciar o servidor. e chamado o mysqld diretamente. Por exemplo: shell> BINDIR/mysqld_safe --log &

Faa isto usando mysqld_safe ou c

Se o mysqld_safe falhar, tente execut-lo do diretrio de instalao do MySQL (se a o ca voc j no estiver l). Se no funcionar, veja Seo 2.4.2 [Starting server], Pgina 116. e a a a a ca a 6. Execute alguns testes bsicos para vericar se o servidor est funcionando. A sa a a ida deve ser similar ao mostrado abaixo: shell> BINDIR/mysqlshow +-----------+ | Databases | +-----------+ | mysql | +-----------+ shell> BINDIR/mysqlshow mysql Database: mysql +--------------+ | Tables | +--------------+ | columns_priv | | db | | func | | host | | tables_priv | | user | +--------------+ shell> BINDIR/mysql -e "SELECT host,db,user FROM db" mysql +------+--------+------+ | host | db | user | +------+--------+------+ | % | test | | | % | test_% | | +------+--------+------+ Tambm existe uma suite de benchmark no diretrio sql-bench (sob o diretrio de e o o instalao do MySQL) que voc pode usar para comparar como o MySQL se comporta ca e em diferentes plataformas. O diretrio sql-bench/Results contm os resultados de o e vrias execues em diferentes bancos de dados e plataformas. Os seguintes mdulos a co o Perl adicionais so necessrios para executar o pacote de benchamrk: a a DBI DBD-mysql Data-Dumper Data-ShowTable Estes mdulos podem ser obtidos em CPAN http://www.cpan.org/. Veja Seo 2.7.1 o ca [Instalao Perl], Pgina 164. ca a

Cap tulo 2: Instalao do MySQL ca

115

O diretrio sql-bench/Results contm os resultados de vrias execues em difero e a co entes bancos de dados e plataformas. Para executar todos testes, execute estes comandos: shell> cd sql-bench shell> run-all-tests Se voc no possui o diretrio sql-bench, voc provavelmente est usando uma dise a o e a tribuio binria RPM. (Distribuies fontes RPMs incluem o diretrio com os benchca a co o marks.) Neste caso, voc deve primeiramente instalar a suite de benchmark antes e de poder us-lo. A partir da verso 3.22 do MySQL, comearam a existir arquivos a a c RPMs de benchmark chamados mysql-bench-VERSION-i386.rpm que contm cdigo e o ie dados de benchmark. Se voc tem uma distribuio fonte, voc tambm pode executar os testes no subdie ca e e retrio tests. Por exemplo, para executar auto_increment.tst, faa isto: o c shell> BINDIR/mysql -vvf test < ./tests/auto_increment.tst Os resultados esperados so mostrados no arquivo ./tests/auto_imcrement.res. a

2.4.1 Problemas Executando o mysql_install_db

O propsito do script mysql_install_db gerar novas tabelas de privilgios. Ele no ir o e e a a afeter nenhum outro dado! Ele tambm no far nada se voc j tem a tabela de privilgio e a a e a e do MySQL instalada. Se voc deseja refazer suas tabelas de privilgios, voc deve desligar o servidor mysqld, se e e e ele j est executando, ento faa assim: a a a c mv diretorio-dados-mysql/mysql diretorio-dados-mysql/mysql-old mysql_install_db Esta seo relaciona alguns problemas que podem ser encontrados ao executar mysql_ ca install_db: mysql_install_db no instala as tabelas de permisses a o Voc pode descobrir que o mysql_install_db falha ao instalar as tabelas de e permisses e termina depois de mostrar as seguintes mensagens: o starting mysqld daemon with databases from XXXXXX mysql daemon ended Neste caso, voc deve examinar o arquivo de log com muito cuidado! O log deve e se encontrar no diretrio XXXXXX nomeado pela mensagem de erro, e deve o indicar porque mysqld no inicializa. Se voc no entende o que aconteceu, a e a inclua o log quando voc postar um relato de erro usando mysqlbug! Veja e Seo 1.7.1.3 [Bug reports], Pgina 36. ca a J existe um daemon mysqld sendo executado a Neste caso, provavelmente no ser necessrio executar o mysql_install_db. a a a Voc deve executar o mysql_install_db somente uma vez, quando voc instae e lar o MySQL da primeira vez. Instalair um segundo daemon mysqld no funciona quando um daemon a estiver em execuo. ca

116

MySQL Technical Reference for Version 5.0.0-alpha

Isto pode acontecer quando voc j tiver uma instalao do MySQL existente, e a ca mas deseja colocar uma nova instalao em um diferente lugar (por exemplo, ca para testes, ou talvez voc simplesmente deseja executar duas instalaes ao e co mesmo tempo). Geralmente o problema que ocorre quando voc tenta executar e o segundo servidor que ele tenta usar o mesmo socket e porta que o outro. e Neste caso voc ir obter a mensagem de erro: Cant start server: Bind e a on TCP/IP port: Address already in use ou Cant start server: Bind on unix socket.... Veja Seo 4.2 [Mltiplos servidores], Pgina 219. ca u a Voc no tem direito de escrita no diretrio /tmp e a o Se voc no tem direito de escrita para criar um arquivo socket no local padro e a a (em /tmp) ou permisso para criar arquivos temporris em /tmp, voc ir a a e a obter um erro quando executar mysql_install_db ou quando iniciar ou usar mysqld. Voc pode especicar socket e diretrio temporrio diferentes, como segue: e o a shell> TMPDIR=/algum_dir_tmp/ shell> MYSQL_UNIX_PORT=/algum_dir_tmp/mysqld.sock shell> export TMPDIR MYSQL_UNIX_PORT Veja Seo A.4.5 [Problems with mysql.sock], Pgina 929. ca a algum_dir_tmp deve ser o caminho para o mesmo diretrio no qual voc tem o e permisso de escrita. Veja Apndice F [Environment variables], Pgina 1092. a e a Depois disto voc deve estar apto para executar mysql_install_db e iniciar o e servidor com estes comandos: shell> scripts/mysql_install_db shell> BINDIR/mysqld_safe & mysqld falha imediatamente Se voc estiver executando RedHat Verso 5.0 com uma verso de glibc ane a a terior a 2.0.7-5 voc deve ter certeza que voc instalou todos os patches para e e a glibc! Existe muita informao sobre isto nos arquivos das listas de menca sagens do MySQL. Links para os arquivos de correio esto dispon a iveis online em http://lists.mysql.com/. Veja tambm Seo 2.6.2 [Linux], Pgina 137. e ca a Voc pode tambm iniciar o mysqld manualmente usando a opo --skipe e ca grant-tables e adicionar a informaao de privilgios usando o mysql: c e shell> BINDIR/mysqld_safe --skip-grant-tables & shell> BINDIR/mysql -u root mysql Do mysql, execute manualmente os comandos SQL em mysql_install_db. Tenha certeza de executar mysqladmin flush_privileges ou mysqladmin reload aps dizer ao servidor para recarregar as tabelas de permisses. o o

2.4.2 Problemas Inicializando o Servidor MySQL

Se voc for usar tabelas que suportem transaes (BDB, InnoDB), primeiro deve-se criar e co um arquivo my.cnf e congurar opes de inicializao para os tipos de tabelas que voc co ca e planeja usar. Veja Cap ptexi tulo 7 [Table types], Pgina 630. a Geralmente, voc inicia o servidor mysqld de uma das trs maneiras: e e

Cap tulo 2: Instalao do MySQL ca

117

Invocando mysql.server. Este script usado primariamente na inicializao e nale ca izao do sistema, e descrito de forma mais completa em Seo 2.4.3 [Automatic ca e ca start], Pgina 118. a Invocando mysqld_safe, que tenta determinar as opes apropriadas para mysqld e co ento execut-lo com estas opes. Veja Seo 4.8.2 [mysqld_safe], Pgina 331. a a co ca a Para o Windows NT/2000/XP, veja Seo 2.1.1.7 [NT start], Pgina 66. ca a Invocando o mysqld diretamente. Quando o daemon mysqld inicia, ele altera o diretrio para o diretrio de dados. E neste o o diretrio que ele espera gravar arquivos de log e o arquivo pid (com o ID do processo) e o onde ele espera encontrar os bancos de dados. A localizao do diretrio de dados especicada quando a distribuio compilada. Enca o e ca e tretanto, se o mysqld espera encontrar o diretrio de dados em lugar diferente de onde ele o realmente est no seu sistema, ele no funcionar corretamente. Se voc tiver problemas a a a e com caminhos incorretos voc pode encontrar quais opes o mysqld permite e quais so e co a as conguraes do caminho padro chamando o mysqld com a opo --help. Voc pode co a ca e sobrescrever os padres especicando os caminhos corretos como argumentos de linha de o comando ao mysqld. (Estas opes tambm podem ser usadas com o mysqld_safe). co e Normalmente voc precisaria indicar ao mysqld somente o diretrio base sob o qual o e o MySQL instalado. Voc pode fazer isso usando a opo --basedir. Voc pode tambm e e ca e e usar --help para conferir o efeito das opees para se alterar o caminho (perceba que co --help deve ser a opo nal do comando mysqld. Por exemplo: ca shell> EXECDIR/mysqld --basedir=/usr/local --help Uma vez que voc determina as conguraes de caminho que voc deseja, inicie o servidor e co e sem a opo --help. ca Qualquer que tenha sido o mtodo utilizado para iniciar o servidor, se houver falha e na inicializao, conra o arquivo de log para ver se voc pode entender o porqu. ca e e Arquivos log esto localizados no diretrio dados (normalmente /usr/local/mysql/data a o para uma distribuio binria, /usr/local/var para uma distribuio fonte, ca a ca \mysql\data\mysql.err no Windows.) Procure no diretrio de dados por arquivos com o nomes no formato nome_maquina.err e nome_maquina.log onde nome_maquina o e nome do servidor. Ento conra as ultimas linhas destes arquivos: a shell> tail nome_maquina.err shell> tail nome_maquina.log Se voc encontrar algo como o seguinte no arquivo log: e 000729 14:50:10 bdb: Recovery function for LSN 1 27595 failed 000729 14:50:10 bdb: warning: ./test/t1.db: No such file or directory 000729 14:50:10 Cant init databases Signica que voc no inicializou o mysqld com --bdb-no-recover e o Berkeley DB encone a trou algo errado com seus arquivos log quando ele tentou recuperar seus bancos de dados. Para poder continuar, voc deve mover o antigo arquivo log Berkeley DB do diretrio do e o banco de dados para outro lugar, onde poder examin-los posteriormente. Os arquivos log a a so nomeados log.0000000001, onde o nmero ir incrementar com o tempo. a u a Se voc estiver executando o mysqld com suporte a tabelas BDB e o mysqld falhar no e in icio, pode ser devido a alguns problemas com o arquivo de recuperao BDB. Neste caso ca

118

MySQL Technical Reference for Version 5.0.0-alpha

voc pode tentar iniciar o mysqld com --bdb-no-recover. Se isto ajudar, ento voc pode e a e remover todos os arquivos log.* do diretrio de dados e tentar iniciar o mysqld novamente. o Se voc obter o seguinte erro, signica que algum outro programa (ou outro servidor mysqld) e j est usando a porta TCP/IP ou socket mysqld est tentando usar: a a a Cant start server: Bind on TCP/IP port: Address already in use ou Cant start server: Bind on unix socket... Use ps para ter certeza que voc no tem outro servidor mysqld em execuo. Se voc e a ca e no consegue encontrar outro servidor, voc pode tentar executar o comando telnet sua_ a e maquina numero_porta_tcp-ip e apertar ENTER vrias vezes. Se voc no obter uma a e a mensagem como telnet: Unable to connect to remote host: Connection refused, algo est usando a mesma porta TCP/IP que o mysqld est tentando usar. Veja Seo 2.4.1 a a ca [mysql install db], Pgina 115 e Seo 4.2 [Multiple servers], Pgina 219. a ca a Se o mysqld est atualmente em execuo, voc pode vericar as conguraes que ele est a ca e co a usando executando este comando: shell> mysqladmin variables ou shell> mysqladmin -h your-host-name variables Se voc obter o Errcode 13, que signica Permission denied, ao iniciar o mysqld isto e signica que voc no pode ter o direito de leitura/criao de arquivos no diretrio do e a ca o banco de dados ou log. Neste caso voc tambm deve iniciar o mysqld como usurio root e e a ou alterar a permisso para os arquivos e diretrios envolvidos para uqe voc tenha o direito a o e de us-los. a Se o mysqld_safe inicia o servidor mas voc no consegue se conectar a ele, tenha certeza e a que voc tem uma entrada no arquivo /etc/hosts que parece com isto: e 127.0.0.1 localhost Este problema s ocorre em sistemas que no possuem uma biblioteca thread funcional e o a para o qual o MySQL deve estar congurado para usar MIT-pthreads. Se voc no consegue iniciar o mysqld voc pode tentar criar um arquivo para rastreae a e mento de erros (trace) para encontrar o problema. Veja Seo E.1.2 [Making trace les], ca Pgina 1080. a Se voc estiver utilizando tabelas InnoDB, procure pelas opes especicas de inicializao e co ca do InnoDB. Veja Seo 7.5.3 [InnoDB start], Pgina 644. ca a Se voc estiver usando tabelas BDB (Berkeley DB), voc deve se familiarizar com as difere e entes opes especicas de inicializao do BDB. Seo 7.6.3 [BDB start], Pgina 699. co ca ca a

2.4.3 Inicializando e parando o MySQL automaticamente.

Os scripts mysql.server e mysqld_safe podem ser usados para iniciar o servidor automaticamente na inicializao do sistema. mysql.server tambm pode ser usado para parar o ca e servidor. O script mysql.server pode ser usado para inicializar ou parar o servidor utilizando-o com os argumentos start ou stop:

Cap tulo 2: Instalao do MySQL ca

119

shell> mysql.server start shell> mysql.server stop mysql.server pode ser encontrado no diretrio share/mysql sob o diretrio de instalao o o ca do MySQL ou no diretrio support-files da rvore fonte do MySQL. o a Note que se voc usa o pacote RPM do Linux (MySQL-server-VERS~O.rpm), o script e A mysql.server j estar instalada como /etc/init.d/mysql - voc no precisa instala a e a a lo manualmente. Veja Seo 2.1.2 [Linux-RPM], Pgina 69 para mais informaes sobre ca a co pacotes RPM Linux. No Mac OS X, voc pode instalar um pacote do MySQL Startup Item separado para e habilitar a inicializao automtica do MySQL no boot so sistema. Veja Seo 2.1.3 [Mac ca a ca OS X installation], Pgina 71 para maiores detalhes. a Antes do mysql.server iniciar o servidor, ele vai para o diretrio de instalao do MySQL, o ca e ento chama o mysqld_safe. Voc pode precisar editar o mysql.server se tiver uma disa e tribuio binria instalada em um local no-padro. Modique-o para chamar o diretrio ca a a a o (cd) apropriado antes de executar o safe_mysql. Se voc deseja que o servidor seja exe ecutado com um usurio espec a ico, adicione uma linha user apropriada para o arquivo /etc/my.cnf, como ser visto posteriormente nesta seo. a ca mysql.server stop desliga o servidor MySQL enviando um sinal para ele. Voc pode e desligar o servidor manualmente executando mysqladmin shutdown. Voc precisa adicionar estes comandos start e stop nos lugares apropriados de seus arquivos e /etc/rc.* quando voc quiser iniciar o MySQL automaticamente no seu servidor. e On most current Linux distributions, it is sucient to copy the le mysql.server into the /etc/init.d directory (or /etc/rc.d/init.d on older Red Hat systems). Afterwards, run the following command to enable the startup of MySQL on system bootup: shell> chkconfig --add mysql.server No FreeBSD o script de inicializao normalmente deve ir no diretrio ca o /usr/local/etc/rc.d/. A pgina do manual rc(8) tambm diz que os scripts a e neste diretrio s so executados, se o seu nome de base corresponder padro global o o a a da sheel *.sh. Qualquer outro arquivo ou diretrio presente dentro do diretrio so o o a silenciosamente ignorados. Em outra palavras, no FreeBSD voc deve instalar o arquivo e mysql.server como /usr/local/etc/rc.d/mysql.server.sh para habilitar a inicializao automtica. ca a Como uma alternativa para o exposto acima, alguns sistemas operacionais tambm usam e /etc/rc.local ou /etc/init.d/boot.local para inicializar servios adicionais durante c o boot. Para iniciar o MySQL usando este mtodo, voc poderia poderia adicionar algo e e como o seguinte a ele: /bin/sh -c cd /usr/local/mysql; ./bin/mysqld_safe --user=mysql & Voc tambm pode adicionar opes para mysql.server em um arquivo global e e co /etc/my.cnf. Um tipico arquivo /etc/my.cnf pode parecer com isto: [mysqld] datadir=/usr/local/mysql/var socket=/var/tmp/mysql.sock port=3306 user=mysql

120

MySQL Technical Reference for Version 5.0.0-alpha

[mysql.server] basedir=/usr/local/mysql O script mysql.server entende as seguintes opes: datadir, basedir e pid-file. co A seguinte tabela mostra quais grupos de opes cada script de inicializao l dos arquivos co ca e de opes: co Script mysqld mysql.server mysqld_safe Grupos de opes co [mysqld], [server] e [mysqld-major-version] [mysql.server], [mysqld], e [server] [mysql.server], [mysqld], e [server]

Para compatibilidade com verses anteriores, o mysql.server tambm l o grupo [mysql_ o e e server] e mysqld_safe tambm l o grupo [safe_mysqld]. No entanto, voc deve atue e e alizar os seus arquivos de opes para usar os grupos [mysql.server] e [mysqld_safe]. co Veja Seo 4.1.2 [Arquivos de Opes], Pgina 216. ca co a

2.5 Atualizando/Desatualizando o MySQL

Antes de fazer uma atualizao, voc deve fazer o backup de seus bancos de dados antigos. ca e Voc sempre pode mover os arquivos de formato e de dados do MySQL entre diferentes e verses na mesma arquitetura enquanto voc tiver verso base do MySQL. A verso base o e a a atual 4. Se voc alterar o conjunto de caracteres quando executar o MySQL, voc deve e e e executar myisamchk -r -q --set-character--set=charset em todas tabelas. De outra forma seus indices podem no ser corretamente ordenados, porque alterar o conjunto de a caracteres tambm pode alterar a ordenao. e ca Se voc tem receio de novas verses, voc sempre pode renomear seu antigo mysqld para e o e algo como mysqld-nmero-da-verso-antiga. Se o seu novo mysqld comportar de maneira u a inesperada, voc simplesmente pode desliga-lo e reiniciar com seu antigo mysqld! e Se depois de uma atualizao, voc tiver problemas com programas clientes recompilados ca e como Commands out of sync ou core dumps inexperados, voc provavelmente usou um e arquivo de cabealho ou de biblioteca antigo na compilao de seus programas. Neste caso c ca voc deve conferir a data de seu arquivo mysql.h e da biblioteca libmysqlclient.a e para vericar que eles so da nova distribuio MySQL. Se no, por favor, recompile seus a ca a programas! Se voc tiver problemas, como na inicializao do novo servidor mysqld ou caso voc no e ca e a consiga conectar sem uma senha, conra se o seu arquvo my.cnf o mesmo da antiga e instalao! Voc pode conferir com isto: nome-programa --print-defaults. Se isto no ca e a produzir outra sa alm do nome do programa, voc tem um arquivo my.cnf ativo que ida e e est afetando a operacionalidade do servidor! a E uma boa idia reconstruir e reinstalar o mdulo Perl DBD-mysql sempre que instalar uma e o nova verso do MySQL. O mesmo se aplica para outras interfaces MySQL, como Python a MySQLdb.

Cap tulo 2: Instalao do MySQL ca

121

2.5.1 Atualizando da Verso 4.0 para 4.1 a

Varias comportamentos vis iveis foram alteradas entre o MySQL 4.0 e o MySQL 4.1 para corrigir erros cr iticos e tornar o MySQL mais compat com o padro ANSI SQL. Estas ivel a alteraes podem afetar ` sua aplicao. co a ca Alguns dos comportamentos do MySQL 4.1 no 4.0 podem ser testados antes de realizar uma atualizao completa para a verso 4.1, adicionamos `s ultimas distribuies do MySQL 4.0 ca a a co (a paritr da 4.0.12) a opo de inicializao --new para o mysqld. ca ca Esta opo lhe d o comportamento da verso 4.1 para as alteraes mais cr ca a a co iticas. Voc e tambm pode habilitar estes comportamentos para a conexo de uma determinado cliente e a com o comando SET @@new=1, ou desabilit-lo se ele for iniciado com SET @@new=0. a Se voc acredita que algumas das alteraes da verso 4.1 o afetaro, recomendamos que e co a a antes de atualizar para a verso 4.1, voc faa o download da ultima distribuio do MySQL a e c ca 4.0 e o execute com a opo --new adicionando o seguinte ao seu arquivo de congurao: ca ca [mysqld-4.0] new Deste modo voc pode testar o novo comportamento com seus aplicativos na verso 4.0 para e a certicar-se que eles funcionam. Isto o ajudar a ter uma transio suave quando realizar a ca uma atualizao completa do MySQL 4.1. Fazendo isto do modo acima ir assegurar que ca a voc no execute acidentalemte a verso 4.1 com a opo --new mais tarde. e a a ca A seguinte lista descreve alteraes que podem afetar aplicaes e que voc deve observar co co e ao atualizar para a verso 4.1: a TIMESTAMP agora retornado como uma string com o formato YYYY-MM-DD HH:MM:SS. e (A opo --new pode ser usada a partir da verso 4.0.12 para fazer um servidor 4.0 ca a se comportar como 4.1 a este respeito.) Se voc quiser t-lo com um nmero (como a e e u Verso 4.0 faz) deve-se adicionar +0 a coluna TIMESTAMP a eles: a mysql> SELECT ts_col + 0 FROM tbl_name; Tamanhos de display para TIMESTAMP no so mais suportados. Por exemplo, se voc a a e declarar um coluna como TIMESTAMP(10), o (10) ignorado. e Esta mudana era necessria para compatibilidade com os padres SQL. Em uma verso c a o a futura. Em uma verso futura, uma alterao adicional ser feita (compat a ca a ivel com verses anteriores com esta mudaa), permitindo que o tamanho do timestamp indique o c o nmero desejado de d u igitos de fraes de um segundo. co Valores binrios (0xFFDF) agora so assumidos como strings em vez de nmeros. Isto a a u corrige o problema com conjunto de caracteres onde conveniente colocar a string como e um valor binrio. Com esta alterao voc deve usar CAST() se voc quiser comparar a ca e e valores binrios numericamente como inteiros: a SELECT CAST(0XFEFF AS UNSIGNED INTEGER) < CAST(0XFF AS UNSIGNED INTEGER) Se voc no usa CAST(), uma comparao lexicogrca da string ser feita: e a ca a a mysql> SELECT 0xFEFF < 0xFF; -> 1 Usando itens binrios em um contexto numrico ou comparando-os usando o operador a e = deve funcionar como antes. (A opo --new pode ser usado para fazer o servidor 4.0 ca se comportar como 4.1 a partir da verso 4.0.13.) a

122

MySQL Technical Reference for Version 5.0.0-alpha

Para funes que produzem um valor DATE, DATETIME, ou TIME, o resultado retornado co para o cliente agora est corrigido para ter um tipo temporal. Por exemplo, no MySQL a 4.1, voc tem este resultado: e mysql> SELECT CAST("2001-1-1" as DATETIME); -> 2001-01-01 00:00:00 No MySQL 4.0, o resultado diferente: e mysql> SELECT CAST("2001-1-1" as DATETIME); -> 2001-01-01 Valores DEFAULT no podem mais ser especicado para colunas AUTO_INCREMENT (Na a verso 4.0, um valor DEFAULT ignorado sem aviso, na 4.1 ocorre um erro). a e LIMIT no aceita mais argumentos negativos. Use 18446744073709551615 em vez de a -1. SERIALIZE no mais uma opo vlida para sql_mode. a e ca a Deve-se usar SET TRANSACTION ISOLATION LEVEL SERIALIZABLE. SERIALIZE tambm no mais vlido e a e a para a opo --sql-mode do mysqld. Use --transaction-isolation=SERIALIZABLE ca Todas tabelas e colunas strings agora tm um conjunto de caracter. Veja Cap e ptexi tulo 9 [Charset], Pgina 710. A informao do conjunto de caracteres mostrada por a ca e SHOW CREATE TABLE e mysqldump. (O MySQL verso 4.0.6 e acima pode ler o novo a arquivo dump; verses mais antigas no podem.) o a O formato de denio de tabela usado nos arquivos .frm mudaram um pouco na ca verso 4.1. O MySQL 4.0.11 e adiante lem o novo formato .frm diretamente, mas a e verses mais antigas no podem. Se voc precisa mover tabelas da verso 4.1. para o a e a uma mais nova que a 4.0.11, voc de usar mysqldump. Veja Seo 4.9.7 [mysqldump], e ca Pgina 361. a Se voc estiver executando vrios servidores na mesma mquina Windows, voc deve e a a e usar uma opo --shared_memory_base_name diferentes para cada mquina ca a A interface para agrupar funes UDF alterou um pouco. Voc deve agora declarar co e uma funo xxx_clear() para cada funo de agrupamento. ca ca Em geral, atualizar para o MySQL 4.1 a partir de uma verso mais nova do MySQL envolve a os serguintes passos: Verique na seo de alteraes se houve alguma mudana que pode afetar a sua ca co c aplicao. ca Leia os novos itens da verso 4.1 para ver quais itens interessantes que voc pode usar a e na verso 4.1. Veja Seo D.2 [Novidades na verso 4.1.x], Pgina 957. a ca a a Se voc estiver executando o MySQL Server no Windows, veja tambm Seo 2.5.8 e e ca [Windows upgrading], Pgina 132. a Aps o upgrade, atualize a tabela de permisses para gerar uma nova coluna Password o o maior que necessria para tratamento seguro de senhas. O procedimento usa mysql_ e a fix_privilege_tables e est descrito em Seo 2.5.6 [Upgrading-grant-tables], a ca Pgina 130. Estratgias alternativas para tratamento de senhas depois de uma a e atualizao esto descritos posteriormente nesta seo. ca a ca O mecanismo de hashing da senha foi alterado na verso 4.1 para fornecer maior segurana, a c mas ele pode causar problemas de compatibilidade se voc ainda tiver clientes que usam a e

Cap tulo 2: Instalao do MySQL ca

123

biblioteca cliente 4.0 ou anterior. (E bastante indesejvel que voc tenha clientes 4.0 em a e situaes onde o cliente conecta de uma mquina remota que ainda no tenha sido atualizada co a a para a verso 4.1). A seguinte lista indica algumas estratgias poss a e iveis de atualizao. Elas ca representam o que se deve fazer para escolher se ter compatibilidade com clientes antigos e ter maior segurana. c No atualizar para a verso 4.1. Nenhum comportamento ser alterado, mas claro a a a e que voc no poder usar qualquer um dos novos recursos fornecido pelo protocolo e a a cliente/servidor da verso 4.1. (O MySQL 4.1 tem um protocolo cliente/servidor exa tendido que oferece tais recursos como instrues preparadas e conjuntos de mltiplos co u resultados.) Veja Seo 12.1.4 [C API Prepared statements], Pgina 828. ca a Atualizar para a verso 4.1 e executar o script mysql_fix_privilege_tables para a aumentar a coluna Password na tabela user e assim poder guardar hashes de senhas longos. Mas execute o servidor com a opo --old-passwords para fornecer compatica bilidade com verses anteriores que premitem que clientes pre-4.1 continuem a conectar o em suas contas de hash curto. Eventualmente, quando todos os seus clientes estiverem atualizados para a verso 4.1, voc pode parar de usar a opo do servidor --olda e ca passwords. Voc tambm pode alterar as senhas em sua conta MySQL para usar o e e novo formato que mais seguro. e Atualizar para verso 4.1 e executar o script mysql_fix_privilege_tables para aua mentar a coluna Password na tabela user. Se voc sabe que todos os clientes tambm e e foram atualizados para a verso 4.1, no execute o servidor com a opo --olda a ca passwords. Em vez disso, altere a senha em todas as contas existentes para que elas tenham o novo formato. Uma instalao pura da verso 4.1 o mais seguro. ca a e Informaes adicionais sobre hashing de senha em relao a autenticao no cliente e co ca ca operaes de alterao de senha podem ser encontrados em Seo 4.3.11 [Password hashing], co ca ca Pgina 245. a

2.5.2 Atualizando da Verso 3.23 para 4.0 a

Em geral, o que voc deve fazer atualizar para a verso 4.0 um verso mais nova do e e a a MySQL: Aps o upgrade, atualize a tabela de permisses para adicionar novos privilgios e o o e recursos. O procedimento usa o script mysql_fix_privilege_tables e est descrito a em Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. ca a Edite qualquer script de inicializao ou arquivo de congurao para no utilizar ca ca a nenhuma das opes obsoletas listadas posteriormente nesta seo. co ca Converta seua arquivos ISAM antigos para arquivos MyISAM com o comando: mysql_ convert_table_format database. (Este um script Perl; ele exige que o DBI esteja e instalado). Paa converter a tabela em um dado banco de dados, use este comando: shell> mysql_convert_table_format database db_name Note que ele deve ser usado apenas se voc usar se todas as tabelas em um dado banco e de dados so ISAM ou MyISAM. Para evitar a converso de tabelas de outros tipos para a a MyISAM, voc pode listar explicitamente o nome de suas tabelas ISAM depois do nome e do banco de dados na linha de comando. Voc tambm pode executar uma instruo e e ca

124

MySQL Technical Reference for Version 5.0.0-alpha

ALTER TABLE table_name TYPE=MyISAM para cada tabela ISAM para convert-la para e MyISAM. Para descobir o tipo de uma determinada tabela, use esta instruo: ca mysql> SHOW TABLE STATUS LIKE tbl_name; Certique-se de que voc no tem nenhum cliente MySQL que utiliza bibliotecas come a partilhadas (com o Perl DBD-mysql). Se voc tiver, voc deve recompil-las j que e e a a as estruturas usadas em libmysqlclient.so foram alteradas. O mesmo se aplica a outras interfaces MySQL, como Python MySQLdb. O MySQL 4.0 funcionar mesmo se voc no zer o acima, mas voc no poder usar os a e a e a a novos privilgios de segurana pois o MySQL 4.0 e voc podem encontrar problemas ao e c e atualizar o MySQL para a verso 4.1 ou mais nova. O formato do arquivo ISAM ainda a funciona no MySQL 4.0 mas est obsoleto e ser disabilitado (no compilado por padro) a a a a no MySQL 4.1. Em vez disso deve se usar tabelas MyISAM. Clientes antigos devem funcionar com um servidor verso 4.0 sem nenhum problema. a Mesmo se voc zer o indicado acima, voc ainda pode voltar para o MySQL 3.23.52 ou e e mais novo se voc encontrar problemas com o MySQL da srie 4.0. Neste caso voc deve e e e usar o mysqldump para fazer um dump de qualquer tabela que use um indice full-text e recarregar o arquivo de dump no servidor 3.23 (pois o 4.0 usa um novo formato para indices full-text). A seguir est uma lista mais completa com o que deve ser observado para atualizar para a a verso 4.0; a O MySQL 4.0 tem vrios novos privilgios na tabela mysql.user. Veja Seo 4.4.1 a e ca [GRANT], Pgina 254. a Para fazer estes novos privilgios funcionarem, deve se atualizar a tabela de permisses. e o O procedimento est descrito em Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. At a ca a e que este script esteja executando todos os usurios tm os privilgios SHOW DATABASES, a e e CREATE TEMPORARY TABLES e LOCK TABLES. Os privilgios SUPER e EXECUTE tiram o seu e valor de PROCESS. REPLICATION SLAVE e REPLICATION CLIENT tiram o seu valor de FILE. Se voc tiver qualquer script que crie novos usurios, voc pode querer alter-los para e a e a usar os novos privilgios. Se voc no est usando o comando GRANT nos scripts, este e e a a um bom momento para alterar os seus scripts e usar GRANT em vez de modicar a e tabela de permisses diretamente. o A partir da verso 4.0.2 a opo --safe-show-database est obsoleta (e no faz mais a ca a a nada). Veja Seo 4.3.3 [Opes de privilgio], Pgina 230. ca co e a Se voc receber um erro Access denied para novos usurios na verso 4.0.2, voc deve e a a e vericar se voc precisa de alguma das novas concesses que voc no precisava antes. e o e a Em particular, voc precisar REPLICATION SLAVE (em vez de FILE) para novos slaves. e a safe_mysqld renomeado para mysqld_safe. Para compatibilidade com verses e o anteriores, as distribuies binrias, iro, por algum tempo, incluir safe_mysqld como co a a um link simblico para mysqld_safe. o Suporte para InnoDB agora est inclu na distribuio binria. Se voc contruir o a ido ca a e MySQL a partir de um fonte, o InnoDB est congurado por padro, Se voc no usar a a e a o InnoDB e quiser economizar memria ao executar o servidor que possui suorte a o

Cap tulo 2: Instalao do MySQL ca

125

InnoDB habilitado, use a opo de inicializao do servidor. Para compilar o MySQL ca ca sem suporte ao InnoDB, execute configure com a opo --without-innodb. ca O parmetro de inicializao myisam_max_extra_sort_file_size e myisam_max_ a ca extra_sort_file_size so dados agora em bytes. (eram dados em megabytes antes a da verso 4.0.3). a O lock de sistema externo dos arquivos MyISAM/ISAM agora est desligado por a padro. Pode se lig-los fazendo --external-locking. (Para a maioria dos usurios a a a isto nunca necessrio). e a A seguintes variveis/opes de inicializaao foram renomeadas: a co c Nome Antigo myisam_bulk_insert_tree_size query_cache_startup_type record_buffer record_rnd_buffer sort_buffer warnings --err-log Novo Nome. bulk_insert_buffer_size query_cache_type read_buffer_size read_rnd_buffer_size sort_buffer_size log-warnings --log-error (para mysqld_safe)

As opes de inicializao record_buffer, sort_buffer e warnings ainda funcionaro co ca a no MySQL 4.0 mas estp obsoletas. a As seguintes veriveis SQL mudaram o nome. a Nome Antigo SQL_BIG_TABLES SQL_LOW_PRIORITY_UPDATES SQL_MAX_JOIN_SIZE SQL_QUERY_CACHE_TYPE Novo Nome. BIG_TABLES LOW_PRIORITY_UPDATES MAX_JOIN_SIZE QUERY_CACHE_TYPE

Os nomes antigos ainda funcionam no MySQL 4.0 mas esto obsoletos. a Voc deve usar SET GLOBAL SQL_SLAVE_SKIP_COUNTER=# em vez de SET SQL_SLAVE_ e SKIP_COUNTER=#. As opes de inicializao --skip-locking e --enable-locking foram renomeadas co ca para --skip-external-locking e --external-locking. SHOW MASTER STATUS agora retorna um conjunto vazio se o log binrio no estiver haa a bilitado. SHOW SLAVE STATUS agora retorna um conjunto vazio se o slave no est inicializado. a a O mysqld agora tem a opo --temp-pool habilitada por padro j que isto da melhor ca a a rendimento com alguns SO (Principalmente no Linux). Colunas DOUBLE e FLOAT agora respeitam o parmetro UNSIGNED no armazenamento a (antes, UNSIGNED era ignortado por estas colunas). ORDER BY coluna DESC ordena valores NULL por ultimo, como no MySQL 4.0.11. Na verso 3.23 e anteriores da verso 4.0, isto nem sempre era consistente. a a SHOW INDEX tem duas colunas a mais (Null e Index_type) que ele tinha nas verses o 3.23. CHECK, SIGNED, LOCALTIME e LOCALTIMESTAMP so agora palavras reservadas. a

126

MySQL Technical Reference for Version 5.0.0-alpha

O resultado de todos os operadores bitwise (|, &, <<, >> e ~) agora so unsigned. Isto a pode causar problemas se voc estiver usando-as em um contexto onde voc quer um e e resultado com sinal. Veja Seo 6.3.5 [Funes de Converso], Pgina 544. ca co a a Nota: quando voc usa subtrao entre valores inteiros onde um deles do tipo e ca e UNSIGNED, o resultado ser sem sinal. Em oyras palavras, antes de atualizar para o a MySQL 4.0, voc deve vericar sua aplicao para os casos onde voc est subtraindo e ca e a um valor de uma entidade sem sinal e quer um nmero negativo como resposta ou subu traindo um valor sem sinal de uma coluna do tipo inteiro. Voc pode disabilitar este e comportamento usando a opo --sql-mode=NO_UNSIGNED_SUBTRACTION ao iniciar o ca mysqld. Veja Seo 6.3.5 [Funes de converso], Pgina 544. ca co a a Para usar MATCH ... AGAINST (... IN BOOLEAN MODE) com suas tabelas, voc precisa e recontru i-las com REPAIR TABLE nome_tabela USE_FRM. LOCATE() e INSTR() so caso sensitivo se um dos argumentos uma string binria. De a e a outra forma elas so caso-insensitivo. a STRCMP() agora usa o conjunto de caracteres atual ao fazer comparaes, o que signica co que o comportamento padro das comparaes agora caso-insensitivo. a co e HEX(string) agora retorna os caracteres na string convertidos para hexadecimal. Se voc quiser converter um nmero para hexadecimal, voc deve se assugurar que voc e u e e chama HEX() com um argumento numrico. e Na verso 3.23, INSERT INTO ... SELECT sempre tem o IGNORE habilitado. Na verso a a 4.0.1, o MySQL ir parar (e poss a ivelmente fazer um roll back) por padro no caso de a mysqld_safe ser renomeado para mysqld_safe. Por algum tempo incluiremos em nossa distribuio binria o mysqld_safe como um link simblico para mysqld_safe. ca a o um erro se voc no especicar IGNORE. e a As funes antigas da API C mysql_drop_db(), mysql_create_db() e mysql_ co connect() no s mais suportadas a menos que voc compile o MySQL com a a e alterar o cliente para utilizar CFLAGS=-DUSE_OLD_FUNCTIONS. No entanto, preferivel e a nova API 4.0. Na estrutura MYSQL_FIELD, length e max_length foram alterados de unsigned int para unsigned long. Isto no deve causar problemas, exceto que eles podem gerar a mensagens de avisos quando quando usado como argumento em uma classe printf() de funes. co Voc deve usar TRUNCATE TABLE quando quiser deletar todos os registros de uma tabela e e voc no precisa obter uma contagen de quantas colunas forma deletadas. (DELETE e a FROM table_name retorna a contagem de linhas na verso 4.0, e TRUNCATE TABLE mais a e rpido.) a Voc receber um erro se tiver um LOCK TABLES ativo ou transaes ao tentar executar e a co TRUNCATE TABLE ou DROP DATABASE. Voc deve usar inteiros para armazenar valores em colunas BIGINT (em vez de usar e strings, como voc fez no MySQL 3.23). Usar strings ainda funicona, mas usar inteiros e mais eciente. e O formato de SHOW OPEN TABLE alterou. Clientes multi-thread devem usar mysql_thread_init() e mysql_thread_end(). Veja Seo 12.1.14 [Clientes em threads], Pgina 863. ca a

Cap tulo 2: Instalao do MySQL ca

127

Se voc quiser recompilar o mdulo Perl DBD::mysql, voc deve conseguir o DBD-mysql e o e verso 1.2218 ou mais novo porque os mdulos DBD mais antigos usam a chamada a o obsoleta mysql_drop_db(). A verso 2.1022 ou mais nova recomendada. a e Na verso RAND(seed) retorna uma srie de nmero randmicas diferente que na 3.23; a e u o isto foi feito para uma diferenciao maior de RAND(seed) e RAND(seed+1). ca O tipo padro retornado por IFNULL(A,B) agora est congurado para ser o mais geral a a string, REAL ou INTEGER). dos tipos de A e B. (A ordem geral-para-especifco e Se voc estiver executando o MySQL Server no Windows, veja Seo 2.5.8 [Atualizando o e ca Windows], Pgina 132. Se voc estiver usando replicao, veja Seo 4.11.2 [Replication a e ca ca Implementation], Pgina 379. a

2.5.3 Atualizando da verso 3.22 para 3.23 a

A Verso 3.23 do MySQL suporta tabelas do novo tipo MyISAM e do antigo tipo ISAM. Voc a e no necessita converter suas antigas tabelas para us-las com a verso 3.23. Por padro, a a a a todas novas tabelas sero criadas usando o tipo MyISAM (a menos que voc inicie o mysqld a e com a opo --default-table-type=isam). Voc pode converterr uma tabela ISAM para ca e uma formato MyISAM com ALTER TABLE nome_tabela TYPE=MyISAM ou com o script Perl mysql_convert_table_format. Os clientes verses 3.22 e 3.21 iro trabalhar sem quaisquer problemas com um servidor o a verso 3.23. a As seguintes listas dizem o que voc deve conferir quando atualizar para a verso 3.23: e a Todas tabelas que usam o conjunto de caracteres tis620 devem ser corrigidos com myisamchk -r ou REPAIR TABLE. Se voc zer um DROP DATABASE em um banco de dados ligado simbolicamente, a e ligao e o banco de dados original sero apagados. (Isto no acontece na 3.22 porque ca a a o configure no detecta a disponibilidade da chamada de sistema readlink). a OPTIMIZE TABLE agora funciona somente para tabelas MyISAM. Para outros tipos de tabelas, voc pode usar ALTER TABLE para otimizar a tabela. Durante o OPTIMIZE e TABLE a tabela , agora, bloqueada para prevenir que seja usada por outras threads. e O cliente MySQL mysql , agora, inicializado por padro com a opo --no-namede a ca commands (-g). Esta opo pode ser desabilitada com --enable-named-commands ca (-G). Isto pode causar problemas de imcompatibilidade em alguns casos, por exemplo, em scripts SQL que usam comandos sem ponto e v irgula! Comandos longos continuam funcionando. Funes de data que funcionam em partes de datas (como MONTH()) no retornar 0 co a a para datas 0000-00-00. (No MySQL 3.22 estas funes retornam NULL.) co Se voc estiver usando a ordem de classicaao de caracteres alem~ para tabelas ISAM, e c a voc deve reparar todas suas tabelas com isamchk -r, porque foram feitas alteraes e co na sua ordem de classicao! ca O tipo padro de retorno de IF() ir agora depender de ambos argumentos e no a a a apenas do primeiro argumento. Colunas AUTO_INCREMENT no devem ser usadas para armazenar nmeros negativos. A a u razo para isto que nmeros negativos causam problemas quando o -1 passa para 0. a e u

128

MySQL Technical Reference for Version 5.0.0-alpha

Voc no deve armazenar 0 em uma coluna AUTO_INCREMENT tambm; CHECK TABLE ir e a e a reclamar sobre valores 0 porque eles podem alterar se voc zer um dump e restaurar a e tabela. AUTO_INCREMENT , agora, tratado em um n mais baixo para tabelas MyISAM e ivel e muito mais rpido que antes. Para tabelas MyISAM nmeros antigos tambm no e a u e a so mais reusados, mesmo se voc apagar algumas linhas da tabela. a e CASE, DELAYED, ELSE, END, FULLTEXT, INNER, RIGHT, THEN e WHEN agora so palavras a reservadas. FLOAT(X) agora um tipo de ponto utuante verdadeiro e no um valor com um e a nmero xo de decimais. u Quando estiver declarando colunas usando o tipo DECIMAL(tamanho,dec, o argumento tamanho no inclui mais um lugar para o s a imbolo do ponto decimal. Uma string TIME agora deve estar em um dos seguintes formatos: [H]H:]MM:]SS[.fraction] ou [[[[[H]H]H]H]MM]SS[.fraction] [[[DAYS]

LIKE agora compara strings usando as mesmas regras de comparao de caracteres ca que o operador =. Se voc precisa do antigo compartamento, voc pdoe compilar o e e MySQL com a opo CXXFLGAS=-DLIKE_CMP_TOUPPER. ca REGEXP agora caso insensitivo se nenhuma das strings forem binrias. e a Quando for necessrio dar manuteno ou reparar tabelas MyISAM .MYI deve ser usado a ca a instruo CHECK TABLE ou o comando myisamchk. Para tabelas ISAM (.ISM), use o ca comando isamchk Se desejar que os arquivos mysqldump sejam compat iveis entre as verses 3.22 e 3.23 o do MySQL, no deve ser usados as opes --opt ou --full com o mysqldump. a co Conra todas suas chamadas ` DATE_FORMAT() para ter certeza que exista um % antes a de cada caractere formatador. (Verses mais antigas que o MySQL 3.22 aceitaivam esta o sintaxe.) mysql_fetch_fields_direct() agora uma funo (era uma macro) e ela retorna um e ca ponteiro para um MYSQL_FIELD no lugar de um MYSQL_FIELD. mysql_num_fields() no pode mais ser usada em um objeto MYSQL* (agora uma a e funo que obtem valores MYSQL_RES* como um argumento). Com um objeto MYSQL* ca agora voce deve usar mysql_field_count(). No MySQL Verso 3.22, a sa de SELECT DISTINCT ... era na maioria das vezes a ida ordenada. Na Verso 3.23, voc deve usar GROUP BY ou ORDER BY para obter a sa a e ida ordenada. SUM() agora retorna NULL, em vez de 0 se no existir registros coincidentes. Isto de a e acordo com o ANSI SQL. Um AND ou OR com valores NULL agora retornam NULL no lugar de 0. Isto afetar, em a grande parte, pesquisas que usam NOT em uma expresso AND/OR como NOT NULL = a NULL. LPAD() e RPAD() reduziro a string resultante se ela for maior que o tamanho do a argumento.

Cap tulo 2: Instalao do MySQL ca

129

2.5.4 Atualizando da verso 3.21 para 3.22 a

Nada que afetaria a compatibilidade foi alterada entre a verso 3.21 e 3.22. A unica dia culdade que novas tabelas que so criadas com colunas do tipo DATE usaro a nova forma e a a de armazenar a data. Voc no pode acessar esses novos campos com uma verso antiga de e a a mysqld. Depois de instalar o MySQL verso 3.22, voc deve iniciar o novo servidor e depois executar a e o script mysql_fix_privilege_tables. Isto adicionar os novos privilgios que voc prea e e cisar para usar o comando GRANT. Se voc se esquecer disto, sera retornado o erro Access a e denied quando voc tentar usar ALTER TABLE, CREATE INDEX ou DROP INDEX. O procedie mento para atualizar a tabela de permisses est descrito em Seo 2.5.6 [Upgrading-granto a ca tables], Pgina 130. a A interface API C para mysql_real_connect() foi alterada. Se voc tem um programa e cliente antigo que chama essa funo, voc deve colocar um 0 para o novo argumento db (ou ca e recodicar o cliente para enviar o elemento db para conexes mais rpidas). Voc tambm o a e e deve chamar mysql_init() antes de chamar mysql_real_connect()! Esta alterao foi ca feita para permitir ` nova funo mysql_options() salvar opes na estrutura do manipua ca co lador do MYSQL. A varivel key_buffer do mysqld foi renomeada para key_buffer_size, mas voc ainda a e pode usar o antigo nome nos seus arquivos de inicializao. ca

2.5.5 Atualizando da verso 3.20 para 3.21 a

Se voc estiver executando uma verso mais antiga que a Verso 3.20.28 e deseja mudar e a a para a verso 3.21 voc deve fazer o seguinte: a e Inicie o servidor mysqld verso 3.21 com a opo --old-protocol para us-lo com clientes a ca a de uma distribuio da verso 3.20 Neste caso, a nova funo cliente mysql_errno() no ca a ca a ir retornar erro do servidor, somente CR_UNKNOWN_ERROR (mas isto funciona para erros de a clientes) e o servidor usa a forma funo password() anterior a 3.21 para vericao, ao ca ca invs do novo mtodo. e e Se voc NAO estiver usando a opo --old-protocol para mysqld, voc precisar fazer as e ca e a seguir alteraes: co Todo o cdigo cliente deve ser recompilado. Se voc usa o ODBC, deve obter o novo o e driver MyODBC 2.x. O script scripts/add_long_password deve ser executado para converter o campo Password na tabela mysql.user para CHAR(16). Todas as senhas devem ser reatribuidas na tabela mysql.user (para obter 62-bits no lugar de senhas 31-bits). O formato das tabelas no foi alterado, ento no preciso converter nenhuma tabela. a a a e A verso do MySQL 3.20.28 e superiores podem manipular o novo formato da tabela de a usurios sem afetar os clientes. Se voc tem uma verso do MySQL mais nova que 3.20.28, a e a senhas no iro mais funcionar se voc converter a tabela de usuaios. Por segurana, voc a a e c e primeiro deve fazer uma atualizao para a verso 3.20.28, pelo menos, e ento atualizar ca a a para a verso 3.21. a

130

MySQL Technical Reference for Version 5.0.0-alpha

O novo cdigo cliente trabalha com um servidor mysqld 3.20.x, portanto se houver probleo mas com 3.21.x voc deve usar o antigo servidor 3.20.x sem a necessidade de recompilar os e clientes novamente. Se voc no est usando a opo --old-protocol para o mysqld, antigos clientes no e a a ca a podero se conectar e exibiro a seguinte mensagem de erro: a a ERROR: Protocol mismatch. Server Version = 10 Client Version = 9 A nova interface PERL DBI/DBD tambm suporta a antiga interface mysqlperl. A unica e alterao que deve ser feita se voc usa o mysqlperl alterar os argumentos para a funo ca e e ca connect(). Os novos argumentos so: host, database, user, password (note que os a argumentos user e password foram alterados de lugar). Veja Seo 12.5.2 [Perl DBI Class], ca Pgina 881. a As seguintes alteraes podem afetar consultas em antigas aplicaes: co co HAVING deve ser especicada antes de qualquer clusula ORDER BY. a Os parmetros para LOCATE() foram trocados. a Agora existem algumas palavras reservadasi novas. As mais notveis so DATE TIME e a a TIMESTAMP.

2.5.6 Atualizando a Tabela de Permisses o

Algumas distribuies introduzem alteraes a estrutura da tabelas de permisses (a tabela co co o no banco de dados mysql) para adicionar novos privilgios ou recursos. Para ter certeza e de que as suas tabelas de permisses esto corretas quando voc atualizar para uma nova o a e verso do MySQL, voc deve atualizar a sua tabela de permisso tambm. a e a e Em sistemas Unix ou semelhantes, atualize a tabela de permisses executando o script o mysql_fix_privilege_tables: shell> mysql_fix_privilege_tables Voc deve executar este script enquanto o servidor est em execuo. Ele tenta se conectar e a ca ao servidor na mquina local como root. Se sua conta root exige uma senha, indique a a senha na linha de comando. Para o MySQL 4.1 e acima, especique a senha assim: shell> mysql_fix_privilege_tables --password=senha_root Antes do MySQL 4.1, especique a senha desta forma: shell> mysql_fix_privilege_tables senha_root O script realiza mysql_fix_privilege_tables qualquer ao necessria para converter sua ca a tabela de permisses para o formato atual. Voc pode ver alguns avisos Duplicate column o e name, durante a execuo, eles podem ser ignorados. ca Depois de executar o script, pare o servidor e o reinicie. No Windows, no existe uma modo fcil de se atualizar a tabela de permisses at o MySQL a a o e 4.0.15. A partir desta verso, as distribuies do MySQL incluem um script SQL mysql_ a co fix_privilege_tables.sql que voc pode executar usando o cliente mysql. Se sua ine stalao do MySQL est localizada em C:\mysql, o comando se parecer com este: ca a a C:\mysql\bin> mysql -u root -p mysql mysql> SOURCE C:\mysql\scripts\mysql_fix_privilege_tables.sql

Cap tulo 2: Instalao do MySQL ca

131

Se sua instalao est localizada em algum outro diretrio, ajuste o caminha apropriadaca a o mente. O comando ir lhe pedir a senha do root; digite-a quando pedido. a Como no procedimento com o Unix, voc pode ver alguns avisos Duplicate column name e enquanto o mysql processa as instrues no script mysql_fix_privilege_tables.sql; eles co podem ser ignorados. Depois de executar o script, para o servidor e reinicie-o.

2.5.7 Atualizando para outra arquitetura

Se voc estiver usando o MySQL Verso 3.23, voc pode copiar os arquivos .frm, .MYI e a e e .MYD para tabelas MyISAM entre diferentes arquiteturas que suportem o mesmo formato de ponto utuante. (O MySQL cuida de cada detalhe de troca de bytes.) Veja Seo 7.1 ca [MyISAM Tables], Pgina 631. a Os arquivos ISAM de dados e indices (*.ISD e *.ISM respectivamente) so dependentes a da arquitetura e em alguns casos dependentees do Sistema Operacional. Se voc deseja e mover suas aplicaes para outra mquina que tem uma arquitetura ou SO diferentes da co a sua mquina atual, voc no deve tentar mover um banco de dados simplesmente copiando a e a os arquivos para a outra mquina. Use o mysqldump. a Por padro, o mysqldump ir criar um arquivo contendo declaraes SQL. Voc pode ento a a co e a transferir o arquivo para a outra mquina e aliment-la como uma entrada para o cliente a a mysql. Utilize mysqldump --help para ver quais opes esto dispon co a iveis. Se voc est movendo e a os dados para uma verso mais nova do MySQL, voc deve usar mysqldump --opt com a a e nova verso para obter uma descarga rpida e compacta. a a A mais fcil (mas no a mais rpida) forma para mover um banco de dados entre duas a a a mquinas executar os seguintes comandos na mquina em que o banco de dados se ena e a contra: shell> mysqladmin -h nome da outra maquina create nome_bd shell> mysqldump --opt nome_bd \ | mysql -h nome da outra maquina nome_bd Se voc deseja copiar um banco de dados de um mquina remota sobre uma rede lenta, e a pode ser usado: shell> mysqladmin create nome_bd shell> mysqldump -h nome de outra maquina --opt --compress nome_bd \ | mysql nome_bd O resultado pode tambm ser armazenado em um arquivo, depois transra o arquivo para a e mquina destino e carregue o arquivo no banco de dados. Por exemplo voc pode descarregar a e um banco de dados para um arquivo na mquina origem desta forma: a shell> mysqldump --quick nome_bd | gzip > nome_bd.contents.gz (O arquivo criado neste exemplo est compactado.) Transfria o arquivo contendo o contedo a u do banco de dados para a mquina destino e execute estes comandos: a

132

MySQL Technical Reference for Version 5.0.0-alpha

shell> mysqladmin create nome_bd shell> gunzip < nome_bd.contents.gz | mysql nome_bd Tambm pode ser usado mysqldump e mysqlimport para ajudar na transferncia do banco de e e dados. Para grandes tabelas, isto muito mais rpido do que usar simplesmente mysqldump. e a Nos comandos abaixo, DUMPDIR representa o caminho completo do diretrio que voc utiliza o e para armazenar a sa de mysqldump. ida Primeiro, crie o diretrio para os arquivos de sa e descarregue o banco de dados: o ida shell> mkdir DUMPDIR shell> mysqldump --tab=DUMPDIR nome_bd Depois transra os arquivo no diretrio DUMPDIR para algum diretrio correspondente na o o mquina destino e carregue os arquivos no MySQL assim: a shell> mysqladmin create nome_bd shell> cat DUMPDIR/*.sql | mysql nome_bd shell> mysqlimport nome_bd DUMPDIR/*.txt # cria o banco de dados # cria tabelas no banco de dados # carrega dados nas tabelas

No se esquea de copiar o banco de dados mysql tambm, porque nele que as tabelas a c e e de permisses (user, db e host) so armazenadas. Voc pode ter que executar comandos o a e como o usurio root do MySQL na nova mquina at que voc tenha o banco de dados a a e e mysql no lugar. Depois de importar o banco de dados mysql para a nova mquina, execute mysqladmin a flush-privileges para que o servidor recarregue as informaes das tabelas de permisses. co o

2.5.8 Atualizando o MySQL no Windows

Qaundo atualizar o MySQL no Windows, siga os passo abaixo: 1. Faa o download do ultima distribuio MySQL do Windows. c ca 2. Escolha uma hora do dia com pouco uso, onde a parada para manuteno aceitvel. ca e a 3. Alerte os usurios que ainda esto ativos para sua parada de manuteno. a a ca 4. Pare o Servidor MySQL em execuo (por exemplo, com NET STOP mysql ou com o ca utilitrio de Servios se voc estiver exeutando MySQL como um servio, ou com a c e c mysqladmin shutdown). 5. Finalize o programa WinMySQLAdmin se ele estiver em execuo. ca 6. Execute o script de instalao do arquivo de distribuio do Windows, clicando no ca ca boto "Install" no WinZip e seguindo os passos da instalao do script. a ca 7. Voc pode sobrescrever a sua instalao antiga do MySQL (normalmente em e ca C:\mysql), ou instal-la em um diretrio diferente, como C:\mysql4. Sobrescrever a a o instalao antiga o recomendado. ca e 8. Reinicie o servio MySQL Server (por exemplo, com NET START mysql se voc executar c e o MySQL como um servio, ou chamado o mysqld diretamente). c 9. Atualize a tabela de permisses. O procedimento est descrito em Seo 2.5.6 o a ca [Upgrading-grant-tables], Pgina 130. a Situaes de erros poss co iveis:

Cap tulo 2: Instalao do MySQL ca

133

A system error has occurred. System error 1067 has occurred. The process terminated unexpectedly. Este erro signica que seu arquivo my.cnf (por padro C:\my.cnf) contm uma opo a e ca que no pode ser reconhecido pela MySQL. Voc pode vericar que este o caso tentando a e e reiniciar o MySQL com o arquivo my.cnf renomeado, por exemplo, para my_cnf.old para prevenirt o servidor de us-lo. Uma vez vericado isto, voc precisa identicar qual a e parmetro o culpado. Crie um novo arquivo my.cnf e mova as partes do arquivo antigo a e para ele (reiniciando o servidor depois de mover cada parte) at que voc determine qual e e opo est fazendo a inicializao do servidor falhar. ca a ca

2.6 Notas espec icas para os Sistemas Operacionais

2.6.1 Notas Windows
Esta seo descreve assuntos espec ca icos para usar MySQL no Windows.

2.6.1.1 Conectando em um MySQL Rematamente a Windows Utilizando SSH

Aqui temos notas sobre como conectar a um servidor MySQL atravs de uma conexo e a remota e segura usando o SSH (por David Carlson dcarlson@mplcomm.com: 1. Instale um cliente SSH na sua mquina Windows. Como um usurio, o melhor opo a a ca paga que encontrei o SecureCRT da http://www.vandyke.com/. Outra opo o fe ca e secure da http://www.f-secure.com/. Voc tambm pode encontrar algumas verses e e o livres no Google em http://directory.google.com/Top/Computers/Security/Products_ and_Tools/Cryptography/SSH/Clients/Windows/. 2. Inicie seu cliente SSH Windows. Congure Host_Name = IP_ou_Nome_servidormysql. Congure userid=seu_userid para logar no seu servidor. Este valor userid no pode a ser o mesmo do nome do usurio se sua conta MySQL. a 3. Congure a porta de acesso. E tambm faa um acesso remoto (Congure local_ e c port: 3306, remote_host: ip_ou_nomeservidormysql, remote_port: 3306 ) ou um acesso local (congure port: 3306, host: localhost, remote port: 3306). 4. Salve tudo, seno voc ter que refazer tudo da prxima vez. a e a o 5. Logue ao seu servidor com a sesso SSH que acabou de ser criada. a 6. Na sua mquina Windows, inicie algumas aplicaes ODBC (como o Access). a co 7. Crie um novo arquivo no Windows e ligue ao MySQL usando o driver ODBC da mesma forma que voc normalmente faz, EXCETO pelo fato de digitar localhost para a e mquina servidora MySQL no nomeservidormysql. a a Voc agora deve ter uma conexo ODBC ao MySQL, criptografada com SSH. e a

134

MySQL Technical Reference for Version 5.0.0-alpha

2.6.1.2 Compilando clientes MySQL no Windows

Em seus arquivos fontes, voc deve incluir my_global.h antes de mysql.h: e #include <my_global.h> #include <mysql.h> my_global.h inclui qualquer outro arquivo necessrio para compatibilidade de Windows a (como o windows.h) se o arquivo compilado no Windows. e Voc tambm pode ligar seu cdigo coma biblioteca dinmica libmysq.lib, que apenas e e o a e um wrapper para carregar em libmysql.dll sobre demanda, ou ligar com a biblioteca esttica mysqlclient.lib. a Perceba que como as bibliotecas clientes do MySQL so compiladas como bibliotecas a threaded, voc tambm deve compilar seu cdigo para ser multi-threaded! e e o

2.6.1.3 MySQL para Windows Comparado com o MySQL para Unix

O MySQL para Windows tem provado ser muito estvel. Esta verso do MySQL tem os a a mesmos recursos que sua verso correspondente Unix com as seguintes excees: a co Win95 e threads O Win95 perde aproximadamente 200 bytes de memria principal para cada o thread criada. Cada conexo no MySQL cria uma nova thread, portanto voc a e no deve executar o mysqld por um longo tempo no Win95 se seu servidor lida a com vrias conexes! WinNT e Win98 no sofrem deste bug. a o a Leituras simultneas a O MySQL depende das chamadas pread() e pwrite() para estar apto a misturar INSERT e SELECT. Atualmente ns usamos mutexes para emular o pread()/pwrite(). Ns iremos, a longo prazo, trocar o n da interface de o ivel arquivos com uma interface virtual para que ns possamos usar a interface o readfile()/writefile() no NT/2000/XP para obter mais velocidade. A implementao atual limita o nmero de arquivos abertos que o MySQL ca u pode usar para 1024, o que signica que voc no conseguir executar tantas e a a threads simultneas no NT/2000/XP como no Unix. a Leitura de blocos O MySQL usa uma leitura de blocos para cada conexo, que tem as seguintes a implicaes: co Uma conexo no ir ser disconectada automaticamente depois de 8 horas, a a a como acontece com a verso Unix do MySQL. a Se uma conexo trava, imposs a naliza-la sem matar o MySQL. a e ivel mysqladmin kill no ir funcionar em uma conexo adormecida. a a a mysqladmin shutdown no pode abortar enquanto existirem conexes a o adormecidas. Planejamos corrigir este problema quando nossos desenvolvedores Windows tiverem conseguido um boa soluo. ca

Cap tulo 2: Instalao do MySQL ca

135

DROP DATABASE Voc no pode remover um banco de dados que est em uso por alguma thread. e a a Matando o MySQL do gerenciador de tarefas Voc no pode matar o MySQL do gerenciador de tarefas ou com o utilitrio e a a shutdown no Win95. Voc deve deslig-lo com mysqladmin shutdown. e a Nomes case-insensitivo Nomes de arquivos no so caso sensitivo no Windows, portanto, nomes de a a bancos de dados e tabelas do MySQL tambm no so caso sensitivo no Wine a a dows. A unica restrio que os nomes de bancos de dados e tabelas devem ca e usar o mesmo caso em uma sentena fornecida. Veja Seo 6.1.3 [Name case c ca sensitivity], Pgina 473. a O caracter de diretrio \ o Componentes de nomes de caminho no Win95 so separados pelo caracter \ o a qual tambm o caractere de escape no MySQL. Se voc estiver usando LOAD e e e DATA INFILE ou SELECT ... INTO OUTFILE, use nomes de arquivo no estilo Unix com caracteres /: mysql> LOAD DATA INFILE "C:/tmp/skr.txt" INTO TABLE skr; mysql> SELECT * INTO OUTFILE C:/tmp/skr.txt FROM skr; Uma alternativa dobrar o caracter /: e mysql> LOAD DATA INFILE "C:\\tmp\\skr.txt" INTO TABLE skr; mysql> SELECT * INTO OUTFILE C:\\tmp\\skr.txt FROM skr; Problems with pipes. Pipes no funcionam com conana na linha de comando do Windows. Se o a c pipe incluir o caracter ^Z / CHAR(24), o Windows achar que ele encontrou o a m de um arquivo e abortar o programa. a Isto um problma principalmente quando se tenta aplicar um log binrio como e a a seguir: mysqlbinlog binary-log-name | mysql --user=root Se voc obter um problema aplicando o log e suspeitar que seja devido a um e caracter ^Z/CHAR(24) voc pode usar a seguinte alternativa: e mysqlbinlog binary-log-file --result-file=/tmp/bin.sql mysql --user=root --eexecute "source /tmp/bin.sql" O ultimo comando pode tambm ser usado para leitura em qualquer arquivo e sql que contenha dados binrios. a erro: Cant open named pipe Se voc utiliza um servidor MySQL verso 3.22 no NT com o os programas e a clientes MySQL mais novos, ser apresentado o seguinte erro: a error 2017: cant open named pipe to host: . pipe... Isto ocorre porque a verso do MySQL usa named pipes no NT por padro. a a Voc pode evitar este erro usando a opo --host=localhost para os novos e ca clientes MySQL ou criar um arquivo de opes c:\my.cnf que contenha a co seguinte informao: ca

136

MySQL Technical Reference for Version 5.0.0-alpha

[client] host = localhost A partir da verso 3.23.50, named pipes so habilitados somente se o mysqld-nt a a ou mysqld-nt-max for iniciado com a opo --enable-name-pipe. ca Erro Access denied for user Se voc tenta executar um programa cliente MySQL para conectar a um servie dor em execuo na mesma mquina, nas obtem o erro Access denied for ca a user: some-user@unknown to database mysql quando acessar um servidor MySQL na mesma mquina, signifca que o MySQL no pode resolver seu a a nome de mquina corretamente. a Para corrigir isto, voc deve criar um arquivo \Windows\hosts com a seguinte e informao: ca 127.0.0.1 localhost ALTER TABLE Enquanto voc est executando uma instruo ALTER TABLE, a tabela est bloe a ca a queada para ser usado por outras threads. Isto ocorre devido ao fato de que no Windows, voc no pode deletar um aruivo que est em uso por outra threads. e a a No futuro, podemos encontrar algum modo de contornarmos este problema. DROP TABLE DROP TABLE em uma tabela que est em uso por uma tabela MERGE no funa a cionar no Windows porque o manipulador do MERGE faz o mapeamento da a tabela escondido da camada superior do MySQL. Como o Windows no pera mite que voc delete arquivos que esto abertos, voc primeiro deve descarregar e a e todas as tabelas MERGE (com FLUSH TABLES) ou apagar a tabela MERGE antes de deletar a tabela. Corrigiremos isto assim que introduzirmos views. DATA DIRECTORY e INDEX DIRECTORY As opes DATA DIRECTORY e INDEX DIRECTORY para CREATE TABLE so ignoco a radas no Windows, porque ele no suporta links simblicos. a o Aqui esto alguns assuntos em aberto para qualquer um que queira melhorar o MySQL no a Windows: Adicionar alguns icones agradveis para o start e shutdown na instalao do MySQL. a ca Seria muito interessante conseguir matar o mysqld do gerenciador de tarefas. Para o momento, deve ser usado o mysqladmin shutdown. Portar o readline para Windows para uso na ferramenta de linha de comando mysql. Verses GUI dos clientes MySQL padres (mysql, mysqlshow, mysqladmin e o o mysqldump) seria timo. o Seria muito bom se as funes de leitura e escrita no socket em net.c fosse interco romp iveis. Isto tornaria poss ivel matar threads abertas com mysqladmin kill no Windows. Adicionar macros para usar os mtodos mais rpidos de incremento/decremento de e a threads seguras fornecidos pelo Windows.

Cap tulo 2: Instalao do MySQL ca

137

2.6.2 Notas Linux (Todas as verses) o

As notas abaixo a respeito da glibc aplicam-se somente na situao quando o MySQL ca e construido por voc mesmo. Se voc est executando Linux em uma mquina x86, na e e a a maioria dos casos muito melhor para voc usar nosso binrio. Ns ligamos nossos binrios e e a o a com a melhor verso alterada da glibc, podemos escolher as melhores opes do compilador, a co em uma tentativa de torn-la funcional para um servidor muito exigido. Para um usurio a a comum, mesmo para conguraes com vrias conexes concorrentes e/ou tabelas excedendo co a o o limite de 2 GB, nosso binrio , na maioria das vezes, a melhor escolha. Portanto se voc a e e ler o texto abaixo, e est em dvida sobre o que deve fazer, tente usar o nosso binrio a u a primeiro para ver se ele preenche suas necessidades, e preocupe-se com uma construo ca prpria apenas se voc descobrir que nosso binrio no bom o suciente para voc. Neste o e a a e e caso, ir iamos apreciar se fosse feito uma observao sobre isto, para que possamos fazer ca uma melhor verso binris da prxima vez. a a o O MySQL usa LinuxThreads no Linux. Se voc usa uma verso do Linux que no tenha e a a a glibc2, voc deve instalar LinuxThreads antes de tentar compilar o MySQL. Voc pode e e obter o LinuxThreads em http://www.mysql.com/downloads/os-linux.html. NOTA: Temos visto alguns problemas estranhos com o Linux 2.2.14 e MySQL em sistemas SMP; Se voc tem um sistema SMP, recomendamos a atualizao para o Linux 2.4! Seu e ca sistema car mais rpido e mais estvel. a a a Perceba que as verses da glibc iguais ou anteriores ` Verso 2.1.1 tem um bug fatal no o a a tratamento do pthread_mutex_timedwait, que usado quando voc executar instrues e e co INSERT DELAYED. Recomendamos no usar INSERT DELAYED antes de atualizar a glibc. a Se voc planeja ter mais de 1000 conexes simultneas, ser necessrio fazer algumas e o a a a alteraes na LinuxThreads, recompile-a e religue o MySQL ao novo libpthread.a. co Aumente PTHREAD_THREADS_MAX em sysdeps/unix/sysv/linux/bits/local_lim.h para 4096 e abaixe o STACK_SIZE no linuxthreads/internals.h para 256KB. Os caminhos so relativos ` raiz da glibc. Note que o MySQL no ser estvel com cerca de a a a a a 600-1000 conexes se o valor de STACK_SIZE for o padro de 2MB. o a Se voc tiver um problema com o MySQL, no qual ele no consiga abrir vrios arquivos ou e a a conexes, pode ser que voc no tenha congurado o Linux para lidar com o nmero de o e a u arquivos suciente. No Linux 2.2 e posteriores, voc pode conferir o valor para a alocao dos arquivos fazendo: e ca cat /proc/sys/fs/file-max cat /proc/sys/fs/dquot-max cat /proc/sys/fs/super-max Se voc possui mais de 16M de memria, deve ser adicionado o seguinte no seu script de e o boot (ex. /etc/rc/boot.local no SuSE Linux): echo 65536 > /proc/sys/fs/file-max echo 8192 > /proc/sys/fs/dquot-max echo 1024 > /proc/sys/fs/super-max Voc tambm pode executar os comandos acima da linha de comando como root, mas e e neste caso, os antigos limites voltaro a ser usados na prxima vez que o computador for a o reiniciado.

138

MySQL Technical Reference for Version 5.0.0-alpha

De forma alternativa, voc pode congurar estes parmteros durante a inicializao usando a e a ca ferramenta sysctl, que usada por muitas distribuies Linux (No SuSE a partir da verso e co a 8.0). Apenas grave os seguintes valores em um arquivo chamado /etc/sysctl.conf: # Aumente alguns valores para o MySQL fs.file-max = 65536 fs.dquot-max = 8192 fs.super-max = 1024 You should also add the following to /etc/my.cnf: [mysqld_safe] open-files-limit=8192 Os parmetros acima permitem o MySQL criar at 8192 conexes + arquivos. a e o A constante STACK_SIZE na LinuxThreads controla o espaamento das pilhas threads no c espao de endereamento. Ela necessita ser grande o bastante para que tenha espao o c c c suciente para a pilha de cada thread, mas pequena o bastante para manter a pilha de alguma thread executando dos dados globais mysqld. Infelizmente, a implementao Linux de ca mmap(), como descobrimos em experincias, ir desmapear uma regio j mapeada se voc e a a a e solicitar o mapeamento de um endereo j em uso, zerando os dados de toda a pgina ao c a a invs de retoernar. um erro. Portanto a segurana do mysqld ou qualquer outra aplicao e c ca baseada em threads depende do comportamento gentil do cdigo que cria as threads. O o usurio deve tomar medidas para certircar-se que o nmero de threads em funcionamento a u em qualquer hora seja sucientemente baixo para que as pilhas das threads permaneam c longe do monte global. Com mysqld voc deve reforar este comportamento "gentil" cone c gurando um valor razovel para a varivel max_connections. a a Se voc mesmo construiu o MySQL e no deseja confuses corrigindo LinuxThreads, voc e a o e deve congurar max_connections para um valor mximo de 500. Ele ainda deve ser menor a se voc tiver uma chave grande para o buer, grandes tabelas heap, ou outras coisas que e fazem o mysqld alocar muita memria ou se voc estiver executando um kernel 2.2 com o o e patch de 2GB. Se voc estiver usando nosso binrio ou RPM verso 3.23.25 ou posterior, e a a voc pode seguramente congurar max_connections para 1500, assumindo que no h e a a uma grande chave de buer ou tabelas heap com grande quantidade de dados. Quanto mais voc reduz STACK_SIZE em LinuxThreads mais threads voc pode criar seguramente. e e Recomendamos os valores entre 128K e 256K. Se voc usa vrias conexes simultneas, voc pode sofrer com um "recurso" do kernel e a o a e 2.2 que penaliza um processo por bifurcar-se ou clonar um lho na tentativa de prevenir um ataque de separao. Isto faz com que o MySQL no consiga fazer uma bom ca a escalonamento, quando o nmero de clientes simultneos cresce. Em sistemas com CPU u a unica, temos visto isto se manifestar em uma criao muito lenta das threads, tornando ca a conexo ao MySQL muito lenta. Em sistemas de mltiplas CPUs, temos observado a u uma queda gradual na velocidade das consultas quando o nmero de clientes aumenta. u No processo de tentar encontrar uma soluo, recebemos um patch do kernel de um de ca nossos usurios, que alega fazer muita diferena para seu site. O patch est dispon a c a ivel aqui (http://www.mysql.com/Downloads/Patches/linux-fork.patch). Atualmente temos feito testes extensivos deste patch nos sistemas de desenvolvimento e produo. ca A performance do MySQL obtem uma melhora signicativa, sem causar problemas e atualmente o recomendamos para nossos usurios que continuando trabalhando com a

Cap tulo 2: Instalao do MySQL ca

139

servidores muito carregados em kernels 2.2. Este detalhe foi corrigido no kernel 2.4, portanto, se voc no est satisfeito com a performance atual do seu sistema, melhor do e a a que aplicar um patch ao seu kernel 2.2, pode ser mais fcil simplesmente atualizar para o a 2.4, que lhe dar tambm uma melhora em seu sistemas SMP em adio ` correo do bug a e ca a ca discutido aqui. Estamos testando o MySQL no kernel 2.4 em uma mquina com 2 processadores e descoa brimos que o MySQL escalona muito melhor - virtualmente, no h nenhuma perda de a a desempenho no throughput das consultas at cerca de 1000 clientes, e o fator da escala do e MySQL (computado com a razo do throughput mximo para o thoughput de cada cliente.) a a foi de 180%. Temos observado resultados similares em sistemas com 4 processadores - virtualmente no h perda de desempenho quando o nmero de clientes incrementado at a a u e e 1000 e o fator da escala foi de 300%. Portanto para um servidor SMP muito carregado ns o denitivamente recomendamos o kernel 2.4. Ns descobrimos que essencial executar o o e processo mysqld com a mais alta prioridade poss no kernel 2.4 para obter performance ivel mxima. Isto pode ser feito adicionando o comando renice -20 $$ ao mysqld_safe. Nos a nossos testes em uma mquina com 4 processadores, o aumento da prioridade nos deu 60% a de aumento no throughput com 400 clientes. Atualmente estamos tentando coletar mais informaes sobre como o MySQL atua no kernel co 2.4 em sistemas com 4 e 8 processadores. Se voc tem acesso a um sistema deste porte e tem e feito alguns benchmarks, por favor envie um email para docs@mysql.com com os resultados - iremos inclu i-los neste manual. Existe outro detalhe que afeta muito a performance do MySQL, especialmente em sistemas multi processados. A implementao de mutex em LinuxThreads na ca glibc-2.1 muito ruim para programas com vrias threads que travam o mutex e a por um tempo curto. Em um sistema SMP, ironicamente, se voc liga o MySQL e com LinuxThreads sem modicaes, removendo processadores da mquina, a co a performance do MySQL melhorada em alguns casos. Para corrigir este compore tamento, disponibilizamos um patch para glibc 2.1.3, em linuxthreads-2.1-patch ( http://www.mysql.com/Downloads/Linux/linuxthreads-2.1-patch) Com a glibc-2.2.2, o MySQL verso 3.23.36 ir usar o mutex adaptativo, que muito a a e melhor,mesmo que o patch na glibc-2.1.3. Avisamos, entretando, que sobre algumas condies, o cdigo mutex no glibc-2.2.2 overspins, que prejudica a performance do MySQL. co o A chance desta condio pode ser reduzida mudando a prioridade do processo mysqld para ca a prioridade mais alta. Ns tambm corrigimos o comportamento overspin com um patch, o e dispon ivel em http://www.mysql.com/Downloads/Linux/linuxthreads-2.2.2.patch. Ele combina a correo do overspin, nmero mximo de threads e espaamento das pilhas ca u a c em um unico patch. Voc precisar aplic-lo no diretrio linuxthreads com patch -p0 e a a o </tmp/linuxthreads-2.2.2.patch. Esperamos que seja inclu de alguma forma nos ido futuros lanamentos da glibc-2.2. De qualquer forma, se voc ligar com glibc-2.2.2, c e ainda ser necessrio corrigir STACK_SIZE e PTHREAD_THREADS_MAX. Temos esperanas que a a c os padres sero corrigidos para valores mais aceitveis para conguraes pesadasa do o a a co MySQL no futuro, ento sua construo poder ser reduzida a ./configure; make; make a ca a install. Recomendamos que voc use os patches acima para construir uma verso esttica especial e a a de libpthread.a e use-a somente para ligaes estticas com o MySQL. Sabemos que os co a patches so seguros para o MySQL e pode melhorar signicamente sua performance, mas no a a

140

MySQL Technical Reference for Version 5.0.0-alpha

podemos dizer nada sobre outras aplicaes. Se voc ligar outras aplicaes coma a verso co e co a modicada da biblioteca ou construir uma verso alterada compartilhada e instal-la no seu a a sistema, voc estar fazendo por sua conta e risco e tenha ateno com outras aplicaes e a ca co que dependem de LinuxThreads. Se voc passar por problemas estranhos durante a instalao do MySQL ou com travamentos e ca de alguns utilitrios comuns, muito provvel que eles so relacionados a problemas de a e a a bibliotecas ou compilador. Se for este o caso, o uso de nosso binrio ser a soluo. a a ca Um problema conhecido com a distribuio binria que com antigos sistemas Linux que ca a e usam libc (como o RedHat 4.x ou Slackware), voc obter alguns problemas no fatais e a a com resoluo de nomes. Veja Seo 2.6.2.1 [Binary notes-Linux], Pgina 141. ca ca a Quando estiver usando LinuxThreads voc ver um m e a inimo de trs processos em execuo. e ca Estes so de fato, threads. Existir uma thread para o gerenciador LinuxThreads, uma a a thread para lidar com conexes e uma thread para tartar de alarmes e sinais. o Perceba que o kernel Linux e a biblioteca LinuxThread pode por padro ter apenas 1024 a threads. Isto signica que voc pode ter at 1021 conexes ao MySQL em um sistema sem e e o correo. A pgina http://www.volano.com/linuxnotes.html contm informaes sobre ca a e co como contornar este limite. Se voc ver um processo mysqld daemon nalizado com ps, isto normalmente signica que e voc encontrou um bug no MySQL ou que tenha uma tabela corrompida. Veja Seo A.4.1 e ca [Crashing], Pgina 925. a Para obter um descarga do core no Linux se o mysqld nalizar com um sinal SIGSEGV, voc e pode iniciar o mysqld com a opo --core-file. Perceba que provavelmente voc tambm ca e e precisar aumentar o core file size adicionando ulimit -c 1000000 para mysqld_safe a ou iniciar mysqld_safe com --core-file-sizes=1000000, Veja Seo 4.8.2 [safe_mysqld], ca Pgina 331. a Se voc estiver ligando seu prprio cliente MySQL e obter o erro: e o ld.so.1: ./my: fatal: libmysqlclient.so.4: open failed: No such file or directory Quando execut-los, o problema pode ser evitado com um dos seguintes mtodos: a e Ligue o cliente com a seguinte opo (no lugar de -Lpath): -Wl,r/pathca libmysqlclient.so. Copie libmysqclient.so para /usr/lib. Adicione o caminho do diretrio onde libmysqlclient.so est localizado para a o a varivel de ambiente LD_RUN_PATH antes de executar seu cliente. a Se voc estiver usando o compilador Fujitsu (fcc / FCC) voc ter alguns problemas come e a pilando o MySQL porque os arquivos de cabealho Linux so muito orientados ao gcc. c a A seguinte linha configure deve funcionar com fcc/FCC: CC=fcc CFLAGS="-O -K fast -K lib -K omitfp -Kpreex -D_GNU_SOURCE \ -DCONST=const -DNO_STRTOLL_PROTO" CXX=FCC CXXFLAGS="-O -K fast -K lib \ -K omitfp -K preex --no_exceptions --no_rtti -D_GNU_SOURCE -DCONST=const \ -Dalloca=__builtin_alloca -DNO_STRTOLL_PROTO \ -D_EXTERN_INLINE=static __inline" ./configure --prefix=/usr/local/mysql \ --enable-assembler --with-mysqld-ldflags=-all-static --disable-shared \ --with-low-memory

Cap tulo 2: Instalao do MySQL ca

141

2.6.2.1 Notas Linux para distribuies binrias co a

O MySQL necessita pelo menos do Linux verso 2.0 a Aviso: Percebemos que alguns usurios do MySQL tiveram serios problemas de estabilidade a com o MySQL e o kernel 2.2.14 do Linux. Se voc estiver usando este kernel voc deve e e atualiz-lo para o 2.2.19 (ou posterior) ou para o kernel 2.4. Se voc tiver um gabinete a e multi-cpu, ento voc deve considerar seriamente o uso do kernel 2.4 uma vez que ele lhe a e trar uma melhora signicante na velocidade. a A verso binria ligada com -static, que signica que voc normalmente no precisa se a a e e a preocupar com qual verso das bibliotecas do sistema voc tem. Voc no precisa instaa e e a lar LinuxThreads. Um programa ligado com a opo -static um pouco maior que um ca e programa ligado dinamicamente e tambm um pouco mais rpido (3-5%). Um problema, e a entretanto, que voc no pode usar funes denidas pelo usurio (UDF) com um proe e a co a grama ligado estaticamente. Se voc for escrever ou usar funes UDF (isto algo para e co e programadores C ou C++), voc deve compilar o MySQL, usando ligaes dinamicas. e co Se voc estiver usando um sistema baseado em libc (em vez de um sistema glibc2), voc, e e provavelmente, ter alguns problemas com resoluo de nomes de mquinas e getpwnam() a ca a com a verso binria. (Isto porque o glibc infelizmente depende de algumas bibliotecas a a e externas para resolver nomes de mquinas e getpwent(), mesmo quando compilado com a -static). Neste caso, voc provavelmente obter a seguinte mensagem de erro quando e a executar mysql_install_db: Sorry, the host xxxx could not be looked up ou o seguinte erro quando voc tentar executar mysqld com a opo --user: e ca getpwnam: No such file or directory Voc pode resolver este problema usando de um dos modos seguintes: e Obtenha uma distribuio fonte do MySQL (uma distribuio RPM ou tar.gz) e a ca ca instale. Execute mysql_install_db --force; Isto no executar o teste resolveip no mysql_ a a install_db. O lado ruim que voc no poder usar nomes de mquinas nas tabelas e e a a a de permisses; voc deve usar nmeros IP no lugar (exceto para localhost). Se voc o e u e estiver usando uma release antiga do MySQL que no suporte --force, voc deve a e remover o teste resolveip no mysql_install com um editor. Inicie mysqld com su no lugar de usar --user. As distribuies binrias Linux-Intel e RPM do MySQL so conguradas para o mximo co a a a de desempenho poss ivel. Ns sempre tentamos usar o compilador mais rpido e estvel o a a dispon ivel. Suporte MySQL ao Perl exige Perl Verso 5.004 03 ou mais novo. a Em algumas verses 2.2 do kernel Linux,voc pode obter o erro Resource temporarily o e unavailable quando voc faz vrias novas conexes para um servidor mysqld sobre e a o TCP/IP. O problema que o Linux tem um atraso entre o momento em que voc fecha um socket e e TCP/IP at que ele seja realmente liberado pelo sistema. Como s existe espao para um e o c nmero nito de slots TCP/IP, voc ir obter o erro acima se voc tentar fazer muitas novas u e a e

142

MySQL Technical Reference for Version 5.0.0-alpha

conexes TCP/IP durante um pequeno tempo, como quando voc executa o benchmark do o e MySQL test-connect sobre TCP/IP. Ns enviamos emails sobre este problema vrias vezes para diferentes listas de discusso o a a Linux mas nunca conseguimos resolver este problema apropriadamente. A unica correo conhecida , para este problema usar conexes persistentes nos seus ca e o clientes ou usar sockets, se voc estiver executando o servidor de banco de dados e clientes e na mesma mquina. Ns experamos que o kernel Linux 2.4 corrija este problema no futuro. a o

2.6.2.2 Notas Linux x86

O MySQL exige a verso 5.4.12 ou mais nova da libc. Sabe-se que funciona com a libc a 5.4.46. A verso 2.0.6 e posterior da glibc tambm deve funcionar. Existem alguns proba e lemas com os RPMs glibc da RedHat, portanto se voc tiver problemas, conra se existe e alguma atualizao! Sabemos que os RPMs glibc 2.0.7-19 e 2.0.7-29 funcionam. ca Se voc estiver usando o Red Hat 8.0 ou uma nova biblioteca glibc 2.2.x, voc deve iniciar o e e mysqld com a opo --thread-stack=192K (Use -O thread_stack=192K antes do MySQL ca 4). Se voc no zer isto o mysqld nlizar em gethostbyaddr() porque a nova biblioteca e a a glibc exige mais de 128K de memria na pilha para esta chamada. Este tamanho de pilha o o padro agora no MySQL 4.0.10 e acima. e a Se voc est usando o gcc 3.0 e acima para compilar o MySQL, voc deve instalar a e a e biblioteca libstdc++v3 antes de compilar o MySQL; se voc no zer isto, voc obter um e a e a erro sobre um s imbolo __cxa_pure_virtual perdido durante a ligao. ca Em algumas distribuies Linux mais antigas, configure pode produzir um erro como este: co Syntax error in sched.h. Change _P to __P in the /usr/include/sched.h file. See the Installation chapter in the Reference Manual. Faa apenas o que a mensagem de erro diz e adicione um caractere sublinhado para a macro c _P que tem somente um caractere sublinhado e ento tente novamente. a Voc pode obter alguns aviso quando estiver compilando; os mostrados abaixo podem ser e ignorados: mysqld.cc -o objs-thread/mysqld.o mysqld.cc: In function void init_signals(): mysqld.cc:315: warning: assignment of negative value -1 to long unsigned int mysqld.cc: In function void * signal_hand(void *): mysqld.cc:346: warning: assignment of negative value -1 to long unsigned int O mysql.server pode ser encontrado no diretrio share/mysql sob o diretrio de ino o stalao MySQL ou no diretrio support-files da rvore fonte MySQL. ca o a Se o mysqld sempre descarregar um core na inicializao, o problema pode ser que voc ca e tenha um antigo /lib/libc.a. Tente renome-lo depois remova sql/mysqld e faa um a c novo make install e tente novamente. Este problema foi relatado em algumas instalaes co Slackware. Se voc obter o seguinte erro quando ligar o mysqld, signica que seu libg++.a no est e a a instalado corretamente:

Cap tulo 2: Instalao do MySQL ca

143

/usr/lib/libc.a(putc.o): In function _IO_putc: putc.o(.text+0x0): multiple definition of _IO_putc Voc pode evitar o uso de libg++.a executando configure desta forma: e shell> CXX=gcc ./configure

2.6.2.3 Notas Linux SPARC

Em algumas implementaes, readdir_r() est quebrada. O sintoma que SHOW co a e DATABASES sempre retorna um conjunto vazio. Isto pode ser corrigido removendo HAVE_READDIR_R do config.h depois de congurar e antes de compilar.

2.6.2.4 Notas Linux Alpha

O MySQL Verso 3.23.12 a primeira verso do MySQL que testada no Linux-Alpha. Se a e a e voc planeja usar o MySQL no Linux-Alpha, voc deve ter certeza que possui esta verso e e a ou mais nova. Temos testado o MySQL no Alpha com nossos pacotes de benchmarks e testes, e ele parece funcinar muito bem. Quando ns compilamos o binrios MySQL padres, ns estvamos usando SuSE 6.4, kernel o a o o a 2.2.13-SMP, Compilador C Compaq (V6.2-504) e compilador C++ Compaq (V6.3-005) em uma mquina Compaq DS20 com um processador Alpha EV6. a Voc pode encontrar os compiladores acima em http://www.support.compaq.com/alpha-tools. e Usando estes compiladores, em vez do gcc, obtemos 9-14 % de melhora na performance com MySQL. Note que a linha de congurao otimiza o binrio para a CPU atual; isto signica que ca a voc s pode utilizar nosso binrio se voc tiver um processador Alpha EV6. Ns tambm e o a e o e compilamos estaticamente para evitar problemas de bibliotecas. A partir das prximas distribuies adicionamos o parmetro -arch generic em nossas o co a opes de compilao, o qual assegura que o binrio execute em todos os processadores co ca a Alpha. Ns tambm compilamos estaticamente para evitar problemas de bibliotecas. o e CC=ccc CFLAGS="-fast -arch generic" CXX=cxx \ CXXFLAGS="-fast -arch generic -noexceptions -nortti" \ ./configure --prefix=/usr/local/mysql --disable-shared \ --with-extra-charsets=complex --enable-thread-safe-client \ --with-mysqld-ldflags=-non_shared --with-client-ldflags=-non_shared Se voc deseja usar egcs a seguinte linha de congurao funcionou para ns: e ca o CFLAGS="-O3 -fomit-frame-pointer" CXX=gcc \ CXXFLAGS="-O3 -fomit-frame-pointer -felide-constructors \ -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql \ --disable-shared Alguns problemas conhecidos quando executamos o MySQL no Linux-Alpha: Debugar aplicaes baseadas em threads como o MysQL no ir funcionar com gdb co a a 4.18. Voc deve fazer download e usar o gdb 5.0! e

144

MySQL Technical Reference for Version 5.0.0-alpha

Se voc tentar ligar o mysqld estaticamente quando usar o gcc, a imagem resultante ir e a descarregar um arquivo core no in icio. Em outras palavras, NAO use --with-mysqldldflags=-all-static com gcc.

2.6.2.5 Notas Linux PowerPC

O MySQL deve funcionar no MkLinux com o mais novo pacote glibc (testado com glibc 2.0.7).

2.6.2.6 Notas Linux MIPS

Para ter o MySQL funcionando no Qube2. (Linux Mips), voc precisar das bibliotecas e a glibc mais novas (Sabemos que glibc-2.0.7.29C2 funciona). Voc tambm deve usar o e e compilador egcs C++ (egcs-1.0.2-9, gcc 2.95.2 ou mais nova).

2.6.2.7 Notas Linux IA-64

Para conseguir compilar o MySQL no Linux Ia64, usamos a seguinte linha de compilao: ca Usando gcc-2.96: CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc \ CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors \ -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql \ "--with-comment=Official MySQL binary" --with-extra-charsets=complex No Ia64 os binrios do cliente MySQL esto usando bibliotecas compartilhadas. Isto a a signica se voc instalar nossa distribuio binrias em algum outro lugar diferente de e ca a /usr/local/mysql voc precisa modicar o /etc/ld.so.conf ou adicionar o caminho e da o diretrio onde est localizado o libmysqlclient.so na varivel de ambiente LD_ o a a LIBRARY_PATH. Veja Seo A.3.1 [Erros de ligao], Pgina 922. ca ca a

2.6.3 Notas Solaris

No Solaris, voc deve ter problemas mesmo antes de descompactar a distribuio MySQL! e ca O tar do Solaris no pode tratar grandes nomes de arquivos, portanto voc pode ver um a e erro deste tipo quando descompactar o MySQL: x mysql-3.22.12-beta/bench/Results/ATIS-mysql_odbc-NT_4.0-cmp-db2,informix,ms-sql,my tar: directory checksum error Neste caso, voc deve usar o GNU tar (gtar) para desempacotar a dise tribuio. ca Voc pode encontrar uma cpia pr-compilada para Solaris em e o e http://www.mysql.com/downloads/os-solaris.html. As threads nativas da Sun funcionam somente no Solaris 2.5 e superior. Para a verso 2.4 a e anteriores, o MySQL ir automaticamente usar MIT-pthreads. Veja Seo 2.3.6 [MITa ca pthreads], Pgina 106. a Se voc obter o seguinte erro de congure: e

Cap tulo 2: Instalao do MySQL ca

145

checking for restartable system calls... configure: error can not run test programs while cross compiling Isto signica que alguma coisa est errada com a instalao de seu compilador! Neste caso a ca voc deve atualizar seu compilador para uma verso mais nova. Voc tambm pode resolver e a e e este problema inserindo a seguinte linha no arquivo config.cache: ac_cv_sys_restartable_syscalls=${ac_cv_sys_restartable_syscalls=no} Se voc est usando Solaris em um SPARC, o compilador recomendado o gcc 2.95.2. Voc e a e e pode encontr-lo em http://gcc.gnu.org/. Perceba que egcs 1.1.1 e gcc 2.8.1 no so a a a estveis no SPARC! a A linha do configure recomendado quando usando gcc 2.95.2 : e CC=gcc CFLAGS="-O3" \ CXX=gcc CXXFLAGS="-O3 -felide-constructors -fno-exceptions -fno-rtti" \ ./configure --prefix=/usr/local/mysql --with-low-memory --enable-assembler Se voc possui um ultra sparc, voc pode obter 4% a mais de performance adicionando e e "-mcpu=v8 -Wa,-xarch=v8plusa" para a CFLAGS e CXXFLAGS. Se voc possui o compilador Sun Workshop (Fortre) 5.3 (ou mais novo), voc pode executar e e configure da seguinte forma: CC=cc CFLAGS="-Xa -fast -native -xstrconst -mt" \ CXX=CC CXXFLAGS="-noex -mt" \ ./configure --prefix=/usr/local/mysql --enable-assembler Voc pode criar um binrio de 64 bits usando o compilador Forte da Sun com os seguintes e a parmetros de compilao: a ca CC=cc CFLAGS="-Xa -fast -native -xstrconst -mt -xarch=v9" \ CXX=CC CXXFLAGS="-noex -mt -xarch=v9" ASFLAGS="-xarch=v9" \ ./configure --prefix=/usr/local/mysql --enable-assembler Para criar um binrio de 64 bits do Solaris usando gcc, e -m64 para CFLAGS e CXXFLAGS. a Note que isto s funciona com o MySQL 4.0 e acima - o MySQL 3.23 no inclui as modio a caes exigidas para suportar isto. co No benchmark do MySQL, conseguimos um aumento de velocidade de 4% em um UltraSPARC usando o Forte 5.0 no modo 32 bit em comparao com o uso do gcc 3.2 com o ca parametro -mcpu. Se voc criar um binrio de 64 bits, ele ser 4$ mais lento que o binrio de 32 bits, mas o e a a a mysqld poder tratar mais threads e memria. a o Se voc tiver um problema com fdatasync ou sched_yield, voc pode corrigir isto adicioe e nando LIBS=-lrt para a linha de congurao ca O seguinte paragrfo relevante somente para compiladores mais antigos que o WorkShop a e 5.3: Voc tambm pode ter que editar o script configure para alterar esta linha: e e #if !defined(__STDC__) || __STDC__ != 1 para isto: #if !defined(__STDC__)

146

MySQL Technical Reference for Version 5.0.0-alpha

Se voc ligar __STDC__ com a opo -Xc, o compilador Sun no pode compilar com o arquivo e ca a de cabealho pthread.h do Solaris. Isto um bug da Sun (compilador corrompido ou c e arquivo include corrompido). Se o mysqld emitir a mensagem de erro mostrada abaixo quando voc execut-lo, voc deve e a e tentar compilar o MySQL com o compilador Sun sem habilitar a opo multi-thread (-mt): ca libc internal error: _rmutex_unlock: rmutex not held Adicione -mt a CFLAGS e CXXFLAGS e tente novamente. Se voc estiver usando a verso SFW do gcc (que vem com o Solaris 8), voc deve adicionar e a e /opt/sfw/lib a varivel de ambiente LD_LIBRARY_PATH antes de executar a congurao. a ca Se voc estiver usando o gcc dispon em sunfreeware.com, voc pode ter muitos probe ivel e lemas. Voc deve recompilar o gcc e GNU binutils na mquina que voc o executar para e a e a evitar qualquer problema. Se voc obter o seguinte erro quando estiver compilando o MySQL com gcc, signica que e seu gcc no est congurado para sua verso de Solaris: a a a shell> gcc -O3 -g -O2 -DDBUG_OFF -o thr_alarm ... ./thr_alarm.c: In function signal_hand: ./thr_alarm.c:556: too many arguments to function sigwait A coisa apropriada para fazer neste caso obter a verso mais nova do gcc e compil-lo e a a com seu compilador gcc atual! Ao menos para o Solaris 2.5, a maioria das verses binrias o a de gcc tem arquivos inteis e antigos que iro quebrar todos programas que usam threads u a (e possivelmente outros programas)! O Solaris no fornece verses estticas de todas bibliotecas de sistema (libpthreads) e a o a libdl), portanto voc no pode compilar o MySQL com --static. Se voc tentar fazer e a e isto, receber o erro: a ld: fatal: library -ldl: not found ou undefined reference to dlopen ou cannot find -lrt Se vrios processos tentar conectar muito rapidamente ao mysqld, voc ver este erro no a e a log do MySQL: Error in accept: Protocol error Voc deve tentar iniciar o servidor com a opo --set-variable back_log=50 como uma e ca soluo para esta situao. Note que --set-variable=nome=valor e -O nome=valor est ca ca a obsoleto desde o MySQL 4.0. Use apenas --back_log=50. Veja Seo 4.1.1 [Opes da ca co linha de comando], Pgina 207. a Se voc est ligando seu prprio cliente MySQL, voc deve obter o seguinte erro quando e a o e tentar execut-lo: a ld.so.1: ./my: fatal: libmysqlclient.so.#:

Cap tulo 2: Instalao do MySQL ca

147

open failed: No such file or directory O problema pode ser evitado por um dos seguintes mtodos: e Ligue o cliente com a seguinte opo (em vez de -Lpath): -Wl,r/full-path-toca libmysqlclient.so. Copie o arquivo libmysqclient.so para /usr/lib. Adicione o caminho do diretrio onde libmysqlclient.so est localizado ` varivel o a a a de ambiente LD_RUN_PATH antes de executar seu cliente. Se voc tiver problemas com o congure tentando ligar com -lz e voc no tem a zlib e e a instalada, voc ter duas opes: e a co Se voc deseja usar o protocol de comunio de compactado voc precisar obter e e ca e a instalar a zlib from ftp.gnu.org. Congure com --with-named-z-libs=no. Se voc estiver usando o gcc e tiver problemas carregando funes UDF no MySQL, tente e co adicionar -lgcc para a linha de ligao para a funo UDF. ca ca Se voc deseja que o MySQL inicie automaticamente, e support-files/mysql.server para /etc/init.d e criar para ele, chamado /etc/rc.3.d/S99mysql.server. voc pode copiar e um link simblico o

Como o Solaris no suporta core les para aplicaes setuid(), voc no pode obter um a co e a core le do mysqld se voc estiver usando a opo --user. e ca

2.6.3.1 Notas Solaris 2.7/2.8

Voc pode utilizar normalmente um binrio Solaris 2.6 no Solaris 2.7 e 2.8. A maioria dos e a detalhes do Solaris 2.6 tambm se aplicam ao Solaris 2.7 e 2.8. e Note que o MySQL verso 3.23.4 e superiores devem estar aptos para autodetectar novas a verses do Solaris e habilitar solues para os problemas seguintes! o co Solaris 2.7 / 2.8 tem alguns bugs nos arquivos include. Voc pode ver o seguinte erro quando e voc usa o gcc: e /usr/include/widec.h:42: warning: getwc redefined /usr/include/wchar.h:326: warning: this is the location of the previous definition Se isto ocorrer, voc pode fazer o seguinte para corrigir o problema: e Copie /usr/include/widec.h para .../lib/gcc-lib/os/gcc-version/include e mude a linha 41 : #if para #if !defined(lint) && !defined(__lint) && !defined(getwc) !defined(lint) && !defined(__lint)

Uma alternativa editar o /usr/include/widec.h diretamente. Desta forma, depois de e fazer a correo, voc deve remover o config.cache e executar o configure novamente ! ca e

148

MySQL Technical Reference for Version 5.0.0-alpha

Se voc obter erros como estes quando voc executar o make, porque o configure e e e no encontrou o arquivo curses.h (provavelmente devido ao erro no arquivo a /usr/include/widec.h): In file included from mysql.cc:50: /usr/include/term.h:1060: syntax error before , /usr/include/term.h:1081: syntax error before ; A soluo para isto fazer uma das seguintes opoes: ca e c Congure com CFLAGS=-DHAVE_CURSES_H CXXFLAGS=-DHAVE_CURSES_H ./configure. Edite o /usr/include/widec.h como indicado acima e re-execute o congure. Remova a linha #define HAVE_TERM do arquivo config.h e execute make novamente. Se o seu ligador tiver problemas para encontrar o -lz quando ligar ao seu programa cliente, provavelmente o problema que seu arquivo libz.so est instalado em /usr/local/lib. e a Voc pode corrigir isto usando um dos seguintes mtodos: e e Adicione /usr/local/lib ao LD_LIBRARY_PATH. Adicione um link para libz.so a partir de /lib. Se voc estiver usando o Solaris 8, voc pode instalar a zlib opcional do CD de dise e tribuio do Solaris 8. ca Congure o MySQL com a opo --with-named-z-libs=no. ca

2.6.3.2 Notas Solaris x86

No Solaris 8 no x86, mysqld ir descarregar um core se voc executar um strip no mesmo. a e Se voc estiver usando gcc ou egcs no Solaris X86 e voc tiver problemas com descarregos e e de core, voc deve utilizar o seguinte comando configure: e CC=gcc CFLAGS="-O3 -fomit-frame-pointer -DHAVE_CURSES_H" \ CXX=gcc \ CXXFLAGS="-O3 -fomit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti -D ./configure --prefix=/usr/local/mysql Isto ir evitar problemas com a biblioteca libstdc++ e com excees C++. a co Se isto no ajudar, voc pode compilar uma verso com debug e execut-lo com um arquivo a e a a de ratreamento (trace) ou sob gdb. Veja Seo E.1.3 [Using gdb on mysqld], Pgina 1081. ca a

2.6.4 Notas BSD

Esta seo fornece informao para os vrios tipos de BSD, assim como a verso espec ca ca a a ica para eles.

2.6.4.1 Notas FreeBSD

FreeBSD 4.x ou mais novo recomendado para executao do MySQL uma vez que o pacote e ca thread muito mais integrado. e A mais fcil e portanto a forma preferida para instal-lo usar as portas mysql-server e a a e mysql-client dispon iveis em http://www.freebsd.org. Usando-as voc obtem: e

Cap tulo 2: Instalao do MySQL ca

149

Um MySQL funcional, com todas as otimizaes conhecidas para trabalhar na sua co verso habilitada do FreeBSD. a Congurao e construo automtica. ca ca a Scripts de inicializao instalados em /usr/local/etc/rc.d. ca Habilidade para ver quais arquivos esto instalados com pkg info -L. E para remover a e a a todos com pkg delete se voc no quiser mais o MySQL na mquina. E recomendado que voc utilize MIT-pthreads no FreeBSD 2.x e threads nativas nas Verses e o 3 e superiores. E poss executar com threads nativas em algumas verses antigas (2.2.x) ivel o mas voc pode encontrar problemas ao nalizar o mysqld. e Infelizmente algumas chamadas de funes no FreeBSD ainda no so totalmente seguras co a a com threads, principalmente a funo gethostbyname(), que usada pelo MySQL para ca e converter nomes de mquinas em endereos IPs. Sob certas circunstncias, o processo a c a mysqld ir criar repentinamente um carga de CPU de 100% e car sem resposta. Se voc a a e se deparar com isto, tente iniciar o MySQL usando a opo --skip-name-resolve. ca Alternativamente, voc pode ligar o MySQL no FreeBSD 4.x com a biblioteca Linuxe Threads, que evita uns poucos problemas que a implementao da thread nativa do FreeBSD ca tem. Para uma comparao muito boa do LinuxThreads vs. threads nativas d uma olca e hada no artigo "FreeBSD or Linux for your MySQL Server?" de Jeremy Zawodny em http://jeremy.zawodny.com/blog/archives/000697.html Os problemas conhecidos usando LinuxThreads na FreeBSD so: a wait_timeout no est funcionando (provavemente problema de manipulao do signal a a ca em FreeBSD/LinuxThreads). Isto deveria ter sido corrigido no FreeBSD 5.0. O sintome a que conexes persistentes podem se manter por um longo tempo sem serem fechadas. o O Makefile do MySQL necessita o GNU make (gmake) para funcionar. Se voc deseja e compilar o MySQL, antes voc precisar instalar o GNU make. e a Tenha certeza que sua congurao de resoluo de nomes esteja correta. De outra forma ca ca voc vai ter atrasos na resoluo ou falhas quando conectar ao mysqld. e ca Tenha certeza que a entrada localhost no arquivo /etc/hosts esteja correta (de outra forma voc ir ter problemas conectando ao banco de dados). O arquivo /etc/hosts deve e a iniciar com a linha: 127.0.0.1 localhost localhost.seu.dominio O modo recomendado de compilar e instalar o MySQL no FreeBSD com gcc (2.95.2 e acima) : e CC=gcc CFLAGS="-O2 -fno-strength-reduce" \ CXX=gcc CXXFLAGS="-O2 -fno-rtti -fno-exceptions -felide-constructors \ -fno-strength-reduce" \ ./configure --prefix=/usr/local/mysql --enable-assembler gmake gmake install ./scripts/mysql_install_db cd /usr/local/mysql ./bin/mysqld_safe &

150

MySQL Technical Reference for Version 5.0.0-alpha

Se voc percber que o configure usar MIT-pthreads, voc de ler as notas sobre MITe a e pthreads. Veja Seo 2.3.6 [MIT-pthreads], Pgina 106. ca a Se o make install no puder encontrar /usr/include/pthreads, porque o configure a e no detectou que voc precisava de MIT-pthreads. Isto corrigido executando estes comana e e dos: shell> rm config.cache shell> ./configure --with-mit-threads O FreeBSD tambm conhecido por ter um limite muito baixo para o manipulador de e e arquivos. Veja Seo A.2.17 [Not enough le handles], Pgina 921. Descomente a seo ca a ca ulimit -n no mysqld safe ou aumente os limites para o usurio mysqld no /etc/login.conf (e a e e reconstrua-o com cap mkdb /etc/login.conf). Tambm tenha certeza que voc congurou a classe apropriada para este usurio no arquivo de senhas (password) se voc no estiver a e a usando o padro (use: chpass nome usuario mysqld). Veja Seo 4.8.2 [mysqld_safe], a ca Pgina 331. a Se voc tiver muita memria voc deve considerar em reconstruir o Kernel para permitir o e o e MySQL de usar mais de 512M de RAM. D uma olhada na op~o MAXDSIZ na arquivo de e ca congurao LINT para maiores informaes. ca co Se voc tiver problemas com a data atual no MySQL, congurar a varivel TZ provavelmente e a ajudar. Veja Apndice F [Environment variables], Pgina 1092. a e a Para obter um sistema seguro e estvel voc deve usar somente kernels FreeBSD que estejam a e marcados com -STABLE.

2.6.4.2 Notas NetBSD

Para compilar no NetBSD voc precisa do GNU make. De outra forma o compilador quee braria quando o make tentasse executar lint em arquivos C++.

2.6.4.3 Notas OpenBSD

No OpenBSD Verso 2.5, voc pode compilar o MySQL com threads nativas com as a e seguintes opes: co CFLAGS=-pthread CXXFLAGS=-pthread ./configure --with-mit-threads=no

2.6.4.4 Notas OpenBSD 2.8

Nossos usurios relataram que o OpenBSD 2.8 tem um bug nas threads que causa problemas a com o MySQL. Os desenvolvedores do OpenBSD j corrigiram o problema, mas em 25 de a Janeiro de 2001 a correo foi dispon ca ivel apenas no ramo -current. Os sintomas deste bug nas threads so: resposta lenta, alta carga, alto uso de CPU e quedas do servidor. a Se voc obter um erro como Error in accept:: Bad file descriptor ou erro 9 ao tene tar abrir tabelas ou diretrios, o problema provavelmente que voc no alocou memria o e e a o suciente para os descritores de arquivo do MySQL. Neste caso tente iniciar o mysqld_safe como root com as seguintes opes: co shell> mysqld_safe --user=mysql --open-files-limit=2048 &

Cap tulo 2: Instalao do MySQL ca

151

2.6.4.5 Notas BSDI Verso 2.x a

Se voc obter o seguinte erro quando estiver compilando o MySQL, seu valor ulimit para e memria virtual muito baixo: o e item_func.h: In method Item_func_ge::Item_func_ge(const Item_func_ge &): item_func.h:28: virtual memory exhausted make[2]: *** [item_func.o] Error 1 Tente usar ulimit -v 80000 e executar o make novamente. Se isto no funcionar e voc esa e tiver usando o bash, tente trocar para csh ou sh; alguns usurios BSDI relataram problemas a com bash e ulimit. Se voc utiliza gcc, voc pode tambm ter de usar a opo --with-low-memory para o e e e ca configure estar apto a compilar o sql_yacc.cc. Se voc tiver problemas com a data atual no MySQL, congurar a varivel TZ provavelmente e a ajudar. Veja Apndice F [Environment variables], Pgina 1092. a e a

2.6.4.6 Notas BSD/OS Verso 3.x a

Atualize para BSD/OS Verso 3.1. Se isto no for poss a a ivel, instale BSDIpatch M300-038. Use o seguinte comando quando congurar o MySQL: shell> env CXX=shlicc++ CC=shlicc2 \ ./configure \ --prefix=/usr/local/mysql \ --localstatedir=/var/mysql \ --without-perl \ --with-unix-socket-path=/var/mysql/mysql.sock O comeando seguinte tambm funciona: e shell> env CC=gcc CXX=gcc CXXFLAGS=-O3 \ ./configure \ --prefix=/usr/local/mysql \ --with-unix-socket-path=/var/mysql/mysql.sock Voc pode alterar as localizaes dos diretrios se voc desejar, ou apenas usar os padres e co o e o no especicando nenhuma localizao. a ca Se voc tiver problemas com performance sob alta carga, tente usar a opo --skip-threade ca priority para mysqld! Isto ir executar todas as threads com a mesma prioridade; no BSDI a verso 3.1, isto fornece melhor performance (pelo menos at o BSDI corrigir seu organizador a e de threads). Se voc obter o erro virtual memory exhausted enquanto estiver compilando, deve tentar e usar ulimit -v 80000 e executar make novamente. Se isto no funcionar e voc estiver a e usando bash, tente trocar para csh ou sh; alguns usurios BSDI relataram problemas com a bash e ulimit.

152

MySQL Technical Reference for Version 5.0.0-alpha

2.6.4.7 Notas BSD/OS Verso 4.x a

O BSDI Verso 4.x tem alguns bugs relacionados `s threads. Se voc deseja usar o MySQL a a e nesta verso, voc deve instalar todas as correes relacionadas `s threads. Pelo menos a a e co a M400-23 deve estar instalada. Em alguns sistemas BSDI verso 4.x, voc pode ter problemas com bibliotecas compartila e hadas. O sintoma que voc no pode executar nenhum programa cliente, por exemplo, e e a mysqladmin. Neste caso voc precisa recongurar o MySQL, para ele no usar bibliotecas e a compartilhadas, com a opo --disable-shared. ca Alguns clientes tiveram problemas no BSDI 4.0.1 que o binrio do mysqld no conseguia a a abrir tabelas depois de um tempo em funcionamento. Isto porque alguns bugs relacionae dos a biblioteca/sistema fazem com que o mysqld altere o diretrio atual sem nenhuma o informao! ca A correo atualizar para a 3.23.34 ou depois de executar configure remova a linha ca e $define HAVE_REALPATH de config.h antes de executar o make. Perceba que com isso voc no pode fazer um link simblico de um diretrio de banco de e a o o dados para outro diretrio ou fazer um link simblico a uma tabela para outro banco de o o dados no BSDI! (Criar um link simblico para outro disco funciona). o

2.6.5 Notas Mac OS X 2.6.5.1 Mac OS X 10.x

O MySQL deve funcionar sem problemas no Mac OS X 10.x (Darwin). Voc no precisa e a dos patches pthread para este SO. Isto tambm se aplica ao Mac OS X 10.x Server. A compilao para a plataforma Server a e ca e mesma para a verso cliente do Mac OS X. No entanto note que o MySQL vem preinstalado a no Servidor ! Nosso binrio para Mac OS X compilado no Darwin 6.3 com a seguinte linha de cona e gurao: ca CC=gcc CFLAGS="-O3 -fno-omit-frame-pointer" CXX=gcc \ CXXFLAGS="-O3 -fno-omit-frame-pointer -felide-constructors \ -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql \ --with-extra-charsets=complex --enable-thread-safe-client \ --enable-local-infile --disable-shared Veja Seo 2.1.3 [Instalao do Mac OS X], Pgina 71. ca ca a

2.6.5.2 Mac OS X Server 1.2 (Rhapsody)

Antes de tentar congurar o MySQL no MAC OS X server 1.2 (aka Rhapsody), primeiro voc deve instalar o pacote pthread encontrado em: e http://www.prnet.de/RegEx/mysql.html. Veja Seo 2.1.3 [Instalao do Mac OS X], Pgina 71. ca ca a

Cap tulo 2: Instalao do MySQL ca

153

2.6.6 Notas de Outros Unix 2.6.6.1 Notas HP-UX para distribuies binrias co a
Alguma das distribuies binrias do MySQL para HP-UX distribuida como um arquivo co a e depot da HP e como um arquivo tar. Para usar o arquivo depot voc deve estar executando e pelo menos o HP-UX 10.x para ter acesso `s ferramentas de arquivos depot da HP. a A verso HP do MySQL foi compilada em um servidor HP 9000/8xx sob HP-UX 10.20, a usando MIT-pthreads. Sob esta congurao o MySQL funciona bem. O MySQL Verso ca a 3.22.26 e mais novas tambm podem ser construidas com o pacote thread nativo da HP. e Outras conguraes que podem funcionar: co HP 9000/7xx executando HP-UX 10.20+ HP 9000/8xx executando HP-UX 10.30 As seguintes conguraes denitivamente no funcionaro: co a a HP 9000/7xx ou 8xx executando HP-UX 10.x where x < 2 HP 9000/7xx ou 8xx executando HP-UX 9.x Para instalar a distribuio, utilze um dos comandos abaixo, onde /path/to/depot o ca e caminho completo do arquivo depot: Para instalar tudo, incluindo o servidor, cliente e ferramentas de desenvolvimento: shell> /usr/sbin/swinstall -s /path/to/depot mysql.full Para instalar somente o servidor: shell> /usr/sbin/swinstall -s /path/to/depot mysql.server Para instalar somente o pacote cliente: shell> /usr/sbin/swinstall -s /path/to/depot mysql.client Para instalar somente as ferramentas de desenvolvimento: shell> /usr/sbin/swinstall -s /path/to/depot mysql.developer O depot copia os binrios e bibliotecas em /opt/mysql e dados em /var/opt/mysql. O a depot tambm cria as entradas apropriadas em /etc/init.d e /etc/rc2.d para iniciar e o servidor automaticamente na hora do boot. Obviamente, para instalar o usurio deve ser a o root. Para instalar a distribuio HP-UX tar.gz, voc deve ter uma cpia do GNU tar. ca e o

2.6.6.2 Notas HP-UX Verso 10.20 a

Existem alguns pequenos problemas quando compilamos o MySQL no HP-UX. Ns reo comendamos que voc use o gcc no lugar do compilador nativo do HP-UX, porque o gcc e produz um cdigo melhor! o Ns recomendamos o uso do gcc 2.95 no HP-UX. No utilize opes de alta otimizao o a co ca (como -O6) ja que isto pode no ser seguro no HP-UX. a A seguine linha do configure deve funcionar com o gcc 2.95:

154

MySQL Technical Reference for Version 5.0.0-alpha

CFLAGS="-I/opt/dce/include -fpic" \ CXXFLAGS="-I/opt/dce/include -felide-constructors -fno-exceptions \ -fno-rtti" CXX=gcc ./configure --with-pthread \ --with-named-thread-libs=-ldce --prefix=/usr/local/mysql --disable-shared A seguinte linha do configure deve funcionar com o gcc 3.1: CFLAGS="-DHPUX -I/opt/dce/include -O3 -fPIC" CXX=gcc \ CXXFLAGS="-DHPUX -I/opt/dce/include -felide-constructors -fno-exceptions \ -fno-rtti -O3 -fPIC" ./configure --prefix=/usr/local/mysql \ --with-extra-charsets=complex --enable-thread-safe-client \ --enable-local-infile --with-pthread \ --with-named-thread-libs=-ldce --with-lib-ccflags=-fPIC --disable-shared

2.6.6.3 Notas HP-UX Verso 11.x a

Para HP-UX Verso 11.x ns recomendamos o MySQL Verso 3.23.15 ou posterior. a o a Por causa de alguns bugs criticos nas bibliotecas padro do HP-UX, voc deve instalar as a e seguintes correes antes de tentar executar o MySQL no HP-UX 11.0: co PHKL_22840 Streams cumulative PHNE_22397 ARPA cumulative Isto ir resolver um problema que tem como retorno EWOLDBLOCK de recv() e EBADF de a accept() em aplicaes threads. co Se voc estiver usando gcc 2.95.1 em um sistema HP-UX 11.x sem correes, voc obter e co e a o erro: In file included from /usr/include/unistd.h:11, from ../include/global.h:125, from mysql_priv.h:15, from item.cc:19: /usr/include/sys/unistd.h:184: declaration of C function ... /usr/include/sys/pthread.h:440: previous declaration ... In file included from item.h:306, from mysql_priv.h:158, from item.cc:19: O problema que o HP-UX no dene consistentemente a pthreads_ e a atfork(). Ela tem prottipos coitantes em /usr/include/sys/unistd.h:184 o e /usr/include/sys/pthread.h:440 (detalhes abaixo). Uma soluo copiar /usr/include/sys/unistd.h em mysql/include e editar ca e unistd.h alterando-o para coincidir com a denio em pthread.h. Aqui est o di: ca a 183,184c183,184 < extern int pthread_atfork(void (*prepare)(), void (*parent)(), < void (*child)()); --> extern int pthread_atfork(void (*prepare)(void), void (*parent)(void), > void (*child)(void)); Depois disto, a seguinte linha congure deve funcionar:

Cap tulo 2: Instalao do MySQL ca

155

CFLAGS="-fomit-frame-pointer -O3 -fpic" CXX=gcc \ CXXFLAGS="-felide-constructors -fno-exceptions -fno-rtti -O3" \ ./configure --prefix=/usr/local/mysql --disable-shared Segue algumas inforamaes que um usurio do HP-UX Verso 11.x nos enviou sobre comco a a pilao do MySQL com o compilador HP-UX: ca CC=cc CXX=aCC CFLAGS=+DD64 CXXFLAGS=+DD64 ./configure --with-extra-character-set=com Voc pode ignorar qualquer erro do tipo: e aCC: warning 901: unknown option: -3: use +help for online documentation Se voc obter o seguinte erro do configure e checking for cc option to accept ANSI C... no configure: error: MySQL requires a ANSI C compiler (and a C++ compiler). Try gcc. See the Installation chapter in the Reference Manual. Conra se voc no tem o caminho para o compilador K&R antes do caminho para o e a compilador C e C++ do HP-UX. Outra razo para no estar compilando voc no denir o parmetro +DD64 acima. a a e e a a Outra possibilidade para o HP-UX 11 usar o binrio MySQL para HP-UX 10.20. Recebee a mos relatos de alguns usurios de que esses binrios funcionam bem no HP-UX 11.00. Se a a voc encontrar problemas, verique o n do pacth de seu HP-UX. e ivel

2.6.6.4 Notas IBM-AIX

Deteco automtica de xlC est faltando no Autoconf, portando um comando configure ca a a deste tipo necessrio quando estiver compilando o MySQL (Este exemplo usa o compilador e a IBM): export CC="xlc_r -ma -O3 -qstrict -qoptimize=3 -qmaxmem=8192 " export CXX="xlC_r -ma -O3 -qstrict -qoptimize=3 -qmaxmem=8192" export CFLAGS="-I /usr/local/include" export LDFLAGS="-L /usr/local/lib" export CPPFLAGS=$CFLAGS export CXXFLAGS=$CFLAGS ./configure --prefix=/usr/local \ --localstatedir=/var/mysql \ --sysconfdir=/etc/mysql \ --sbindir=/usr/local/bin \ --libexecdir=/usr/local/bin \ --enable-thread-safe-client \ --enable-large-files Acima esto as opes usadas para compilar a distribuio MySQL que pode ser encontrada a co ca em http://www-frec.bull.com/. Se voc alterar o -O3 para -O2 na linha de congurao acima, voc tambm deve remover e ca e e a opo -qstrict (isto uma limitao no compilador C da IBM). ca e ca Se voc estiver usando gcc ou egcs para compilar o MySQL, voc DEVE usar a opo -fnoe e ca exceptions, j que o manipulador de excees no gcc/egcs no seguro para threads! (Isto a co a e

156

MySQL Technical Reference for Version 5.0.0-alpha

foi testado com egcs 1.1). Existem tambm alguns problemas conhecidos com o assembler e da IBM que pode gerar cdigo errado quando usado com gcc. o Ns recomendamos a seguinte linha do configure com egcs e gcc 2.95 no AIX: o CC="gcc -pipe -mcpu=power -Wa,-many" \ CXX="gcc -pipe -mcpu=power -Wa,-many" \ CXXFLAGS="-felide-constructors -fno-exceptions -fno-rtti" \ ./configure --prefix=/usr/local/mysql --with-low-memory O -Wa,-many necessrio para o compilador ser bem sucedido. IBM est ciente deste e a a problema mas no est com pressa de corrig devido ao fato do problema poder ser a a i-lo contornado. Ns no sabemos se o -fno-exceptions necessrio com gcc 2.9.5, mas o a e a como o MySQL no utiliza excees e a opo acima gera cdigo mais rpido, recomendamos a co ca o a que voc sempre use esta opo com o egcs/gcc. e ca Se voc tiver algum problema com cdigo assembler tente alterar o -mcpu=xxx para o seu e o processador. Normalmente power2, power ou powerpc podem ser usados, de uma maneira alternativa voc pode precisar usar 604 ou 604e. No tenho certeza mas acredito que usar e a "power" deve satisfazer a maioria dos casos, mesmo em uma mquina power2. a Se voc no sabe qual o seu processador, utilize o comando "uname -m", isto ir fornecer a e a e a voc uma string que parece com "000514676700", com um formato de xxyyyyyymmss onde e xx e ss so sempre 0s, yyyyyy o ID unico do sistema e mm o ID da CPU Planar. Uma a e e tabela destes valores podem ser encontrados em http://publib.boulder.ibm.com/doc_ link/en_US/a_doc_lib/cmds/aixcmds5/uname.htm. Isto ir lhe fornecer um tipo de a mquina e um modelo de mquina que voc pode usar para determinar que tipo de cpu a a e voc tem. e Se voc tiver problemas com sinais (MySQL naliza sem noticao sob alta carga) voc e ca e pode ter encontrado um bug de SO com threads e sinais. Neste caso voc pode dizer ao e MySQL para no usar sinais congurando-o com: a shell> CFLAGS=-DDONT_USE_THR_ALARM CXX=gcc \ CXXFLAGS="-felide-constructors -fno-exceptions -fno-rtti \ -DDONT_USE_THR_ALARM" \ ./configure --prefix=/usr/local/mysql --with-debug --with-low-memory Isto no afeta a performance do MySQL, mas tem o efeito colateral que voc no pode a e a matar clientes que esto dormindo em uma conexo com mysqladmin kill ou mysqladmin a a shutdown. Neste caso, o cliente morrer quando ele chegar no prximo comando. a o Em algumas verses do AIX, ligando com libbind.a faz o getservbyname descarregar core. o Isto erro no AIX e deve ser relatado para a IBM. e Para o AIX 4.2.1 e gcc voc tem que fazer as seguintes alteraes. e co Depois de congurar, edite o config.h e include/my_config.h e altere a linha que diz #define HAVE_SNPRINTF 1 para #undef HAVE_SNPRINTF E nalmente, no mysqld.cc voc precisa adicionar um prottipo para initgroups. e o #ifdef _AIX41 extern "C" int initgroups(const char *,int);

Cap tulo 2: Instalao do MySQL ca

157

#endif Se voc precisar se alocar muita memria para o processo mysqld, no suciente apenas e o a e denir ulimit -d unlimited. Voc tambm deve congurar no mysqld_safe algo do tipo: e e export LDR_CNTRL=MAXDATA=0x80000000 Voc pode encontrar mais sobre o uso de muita memria em: http://publib16.boulder.ibm.com/pseries e o US/aixprggd/genprogc/lrg_prg_support.htm.

2.6.6.5 Notas SunOS 4

No SunOS 4, necessrio a MIT-pthreads para compilar o MySQL, o que signica que voc e a e precisa do GNU make. Alguns sistemas SunOS 4 tem problemas com bibliotecas dinmicas e libtool. Voc pode a e usar a seguinte linha do configure para evitar este problema: shell> ./configure --disable-shared --with-mysqld-ldflags=-all-static Quando compilando readline, voc pode obter alguns avisos sobre denies duplicadas e co que podem ser ignoradas. Ao compilar o mysqld, vo existir alguns alertas sobre implicit declaration of function a que tambm podem ser ignoradas. e

2.6.6.6 Notas Alpha-DEC-UNIX (Tru64)

Se voc est usando o egcs 1.1.2 no Digital Unix, voc atualizar par o gcc 2.95.2, j que o e a e a egcs no DEC tem vrios erros graves ! a Quando compilando programas com threads no Digital Unix, a documentao recomenda ca usar a opo -pthread para cc e cxx e as bibliotecas -lmach -lexc (em adio para ca ca lpthread). Voc deve executar o configure parecido com isto: e CC="cc -pthread" CXX="cxx -pthread -O" \ ./configure --with-named-thread-libs="-lpthread -lmach -lexc -lc" Quando compilando o mysqld, voc deve ver alguns avisos como estes: e mysqld.cc: In function void handle_connections(): mysqld.cc:626: passing long unsigned int * as argument 3 of accept(int,sockadddr *, int *) Voc pode ignorar estes altertas com segurana. Eles ocorrem porque o configure s pode e c o detectar erros e no alertas. a Se voc inicia o servidor diretamente da linha de comando, voc pode ter problemas com e e a nalizao do servidor ao sair (log out). (Quando voc sai, seu processo superior recebe ca e um sinal SIGHUP.) Se isto acontecer, tente iniciar o servidor desta forma: shell> nohup mysqld [options] & nohup faz com que o comando que o segue ignore qualquer sinal SIGHUP enviado pelo terminal. De forma alternativa, inicie o servidor executando mysqld_safe, o qual invoca o mysqld usando nohup por voc. Veja Seo 4.8.2 [mysqld_safe], Pgina 331. e ca a Se voc tiver problemas quando compilar mysys/get opt.c, apenas remova a linha #dene e NO PROTO do inicio do arquivo!

158

MySQL Technical Reference for Version 5.0.0-alpha

Se voc estiver utilizando o compilador CC da Compac, a seguinte linha de congurao e ca dever funcionar: a CC="cc -pthread" CFLAGS="-O4 -ansi_alias -ansi_args -fast -inline speed all -arch host" CXX="cxx -pthread" CXXFLAGS="-O4 -ansi_alias -ansi_args -fast -inline speed all -arch host \ -noexceptions -nortti" export CC CFLAGS CXX CXXFLAGS ./configure \ --prefix=/usr/local/mysql \ --with-low-memory \ --enable-large-files \ --enable-shared=yes \ --with-named-thread-libs="-lpthread -lmach -lexc -lc" gnumake Se voc tiver problemas com a libtool, ao compilar com bibliotecas compartilhadas como e no exemplo acima, quando estiver ligando ao mysqld, voc deve conseguir contornar este e problema usando: cd mysql /bin/sh ../libtool --mode=link cxx -pthread -O3 -DDBUG_OFF \ -O4 -ansi_alias -ansi_args -fast -inline speed \ -speculate all \ -arch host -DUNDEF_HAVE_GETHOSTBYNAME_R \ -o mysql mysql.o readline.o sql_string.o completion_hash.o \ ../readline/libreadline.a -lcurses \ ../libmysql/.libs/libmysqlclient.so -lm cd .. gnumake gnumake install scripts/mysql_install_db

2.6.6.7 Notas Alpha-DEC-OSF1

Se voc tiver problemas com compilao e tem o DEC CC e o gcc instalados, tente executar e ca o configure desta forma: CC=cc CFLAGS=-O CXX=gcc CXXFLAGS=-O3 \ ./configure --prefix=/usr/local/mysql Se voc tiver problemas com o arquivo c_asm.h, voc pode criar e usar um arquivo e e c_asm.h burro com: touch include/c_asm.h CC=gcc CFLAGS=-I./include \ CXX=gcc CXXFLAGS=-O3 \ ./configure --prefix=/usr/local/mysql Perceba que os seguintes problemas com o programa ld pode ser corrigido fazendo o download do ultimo kit de atualizao da DEC (Compaq) de ca http://ftp.support.compaq.com/public/unix/.

Cap tulo 2: Instalao do MySQL ca

159

Com o OSF1 V4.0D e o compilador "DEC C V5.6-071 no Digital Unix V4.0 (Rev. 878)" o compilador tem alguns comportamentos estranhos (simbolos asm indenidos). /bin/ld tambm aparece estar quebrado (problemas com erros _exit undefined ocorrendo ao ligar e no mysqld). Neste sistema, temos compilado o MySQL com a seguinte linha configure, depois de substituir /bin/ld com a verso do OSF 4.0C: a CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql Com o compilador da Digital "C++ V6.1-029", o seguinte deve funcionar: CC=cc -pthread CFLAGS=-O4 -ansi_alias -ansi_args -fast -inline speed -speculate all \ -arch host CXX=cxx -pthread CXXFLAGS=-O4 -ansi_alias -ansi_args -fast -inline speed -speculate all \ -arch host -noexceptions -nortti export CC CFLAGS CXX CXXFLAGS ./configure --prefix=/usr/mysql/mysql --with-mysqld-ldflags=-all-static \ --disable-shared --with-named-thread-libs="-lmach -lexc -lc" Em algumas verses do OSF1, a funo alloca() est quebrada. Corrija isto removendo a o ca a linha no config.h que dene HAVE_ALLOCA. A funo alloca() pode tambm ter um prottipo incorreto em /usr/include/alloca.h. ca e o O alerta resultante deste erro pode ser ignorado. configure ir usar a seguinte biblioteca thread automaticamente: --with-named-threada libs="-lpthread -lmach -lexc -lc". Quando usar o gcc, voc tambm pode tentar executar configure desta forma: e e shell> CFLAGS=-D_PTHREAD_USE_D4 CXX=gcc CXXFLAGS=-O3 ./configure .... Se voc tiver problemas com sinais (MySQL nalzar inesperadamente sobre alta carga), e voc pode ter encontrado um erro com threads e sinais no SO. Neste caso voc pode dizer e e ao MySQL para no usar sinais congurando-o com: a shell> CFLAGS=-DDONT_USE_THR_ALARM \ CXXFLAGS=-DDONT_USE_THR_ALARM \ ./configure ... Isto no afeta a performance do MySQL, mas tem efeitos colaterais que no permitem a a nalizar clientes que esto dormindo em uma conexo com mysqladmin kill ou a a mysqladmin shutdown. Neste caso o cliente ir morrer quando ele receber o prximo a o comando. Com gcc 2.95.2, voc provavelmente encontrar o seguinte erro de compilao: e a ca sql_acl.cc:1456: Internal compiler error in scan_region, at except.c:2566 Please submit a full bug report. Para corrigir isto voc deve alterar para o diretrio sql e fazer um corta e cola da ultima e o linha gcc, mas altere -O3 para -O0 (ou adicione -O0 imediatamente depois de gcc se voc e no tiver algumas opo -O na sua linha de compilao.) Depois disto feito voc deve apenas a ca ca e voltar ao diretrio superior e executar make novamente. o

160

MySQL Technical Reference for Version 5.0.0-alpha

2.6.6.8 Notas SGI Irix

Se voc estiver usando Irix Verso 6.5.3 ou mais novo, o mysqld s ir conseguir criar threads e a o a se voc execut-lo como um usurio com privilgios de CAP_SCHED_MGT (como root) ou dar e a a e ao servidor mysqld este privilgio com o seguinte comando shell: e shell> chcap "CAP_SCHED_MGT+epi" /opt/mysql/libexec/mysqld Voc pode precisar indenir alguns simbolos em config.h depois de executar configure e e antes de compilar. Em algumas implementaes Irix, a funo alloca() est quebrada. Se o servidor mysqld co ca a morrer em alguma instruo SELECT, remova as linhas de config.h que denem HAVE_ ca ALLOC e HAVE_ALLOC_H. Se mysqladmin create no funciona, remova a linha do config.h a que dene HAVE_READDIR_R. Voc tambm deve precisar remover a linha HAVE_TERM_H. e e

A SGI recomenda que voc instale todos os patches desta pgina: http://support.sgi.com/surfzone/patches/ e a No m inimo, voc deve instalar o ultimo rollup do kernel, o ultimo rollup rld, e o ultimo e rollup libc. Denitivamente voc precisar de todos patches POSIX nesta pgina, para suporte e a a pthreads: http://support.sgi.com/surfzone/patches/patchset/6.2_posix.rps.html Se voc obter o seguinte erro quando estiver compilando o mysql.cc: e "/usr/include/curses.h", line 82: error(1084): invalid combination of type Digite o seguinte no diretrio topo da sua rvore fonte do MySQL: o a shell> extra/replace bool curses_bool < /usr/include/curses.h \ > include/curses.h shell> make Existem relatos de problemas com organizao de threads. Se somente uma thread estiver ca executando, o sistema ca lento. Pode se evitar isto iniciando outro cliente. Isto pode acarretar num crescimento de 2 para 10 vezes na velocidade de execuo para a outra ca thread. Isto um problema no compreendido com threads Irix; voc deve improvisar para e a e encontrar solues at que isto seja resolvido. co e Se voc estiver compilando com gcc, voc pode usar o seguinte comando configure: e e CC=gcc CXX=gcc CXXFLAGS=-O3 \ ./configure --prefix=/usr/local/mysql --enable-thread-safe-client \ --with-named-thread-libs=-lpthread No Irix 6.5.11 com Irix C nativo e compiladores C++ ver. 7.3.1.2, o seguinte ir funcionar a CC=cc CXX=CC CFLAGS=-O3 -n32 -TARG:platform=IP22 -I/usr/local/include \ -L/usr/local/lib CXXFLAGS=-O3 -n32 -TARG:platform=IP22 \ -I/usr/local/include -L/usr/local/lib ./configure \ --prefix=/usr/local/mysql --with-innodb --with-berkeley-db \ --with-libwrap=/usr/local \ --with-named-curses-libs=/usr/local/lib/libncurses.a

Cap tulo 2: Instalao do MySQL ca

161

2.6.6.9 Notas SCO

A verso atual foi testado somente nos sistemas sco3.2v5.0.4 e sco3.2v5.0.5. A versoo a a para o sco 3.2v4.2 tambm tem tido muito progresso. e At o momento o compilador recomendado no OpenServer o gcc 2.95.2. Com isto voc e e e deve estar apto a compilar o MySQL apenas com: CC=gcc CXX=gcc ./configure ... (op~es) co 1. Para o OpenServer 5.0.X voc precisa usar gcc-2.95.2p1 ou mais novo da Skunkware. e http://www.SCO.com/skunkware/ e ecolher o pacote OpenServer browser ou por ftp em ftp to ftp2.SCO.com no diretrio pub/skunkware/osr5/devtools/gcc. o 2. Voc precisa do GCC verso 2.5.x para este produto e do sistema de desenvolvimento. e a Eles so necessrios nesta verso do SCO Unix. Voc no pode usar apenas o sistema a a a e a GCC Dev. 3. Voc deve obter o pacote FSU Pthreads e instal-lo primeiro. Pode ser obtido em e a http://www.cs.wustl.edu/~schmidt/ACE_wrappers/FSU-threads.tar.gz. Voc e pode tambm obter um pacote precompilado de http://www.mysql.com/Downloads/SCO/FSU-threads e 4. FSU Pthreads pode ser compilado com SCO Unix 4.2 com tcpip, ou OpenServer 3.0 ou OpenDesktop 3.0 (OS 3.0 ODT 3.0), com o Sistema de Desenvolvimento da SCO instalado usando uma boa verso do GCC 2.5.x ODT ou OS 3.0, no qual voc necessia e tar de uma boa verso do GCC 2.5.x. Existem vrios problemas sem uma boa verso. a a a a Esta verso do produto necessita do sistema de Desenvolvimento SCO Unix. Sem ele, a voc estar perdendo as bibliotecas e o editor de ligao necessrio. e a ca a 5. Para construir a FSU Pthreads no seu sistema, faa o seguinte: c 1. Execute ./configure no diretrio threads/src e selecione a opo SCO o ca OpenServer. Este comando copia Makefile.SCO5 para Makefile. 2. Execute make. 3. Para instalar no diretrio padro /usr/include, use o usurio root, depois mude o a a para o diretrio thread/src e execute make install o 6. Lembre de usar o GNU make quando estiver construindo o MySQL. 7. Se voc no iniciou o mysqld_safe como root, voc provavelmente s ir obter, por e a e o a padro, os 110 arquivos abertos por processo. O mysqld ir gravar uma nota sobre isto a a no arquivo log. 8. Com o SCO 3.2V5.0.5, voc deve usar o FSU Pthreads verso 3.5c ou mais nova. Voc e a e deve tambm usar o gcc 2.95.2 ou mais novo. e O seguinte comando configure deve funcionar: shell> ./configure --prefix=/usr/local/mysql --disable-shared 9. Com SCO 3.2V4.2, voc deve usar FSU Pthreads verso 3.5c ou mais nova. O seguinte e a comando configure deve funcionar: shell> CFLAGS="-D_XOPEN_XPG4" CXX=gcc CXXFLAGS="-D_XOPEN_XPG4" \ ./configure \ --prefix=/usr/local/mysql \ --with-named-thread-libs="-lgthreads -lsocket -lgen -lgthreads" \ --with-named-curses-libs="-lcurses"

162

MySQL Technical Reference for Version 5.0.0-alpha

Voc pode ter alguns problemas com alguns arquivos de incluso. e a Neste caso, voc pode encontrar novos arquivos de incluso espec e a icos do SCO em http://www.mysql.com/Downloads/SCO/SCO-3.2v4.2-includes.tar.gz. Voc deve e descompactar este arquivo no diretrio include da sua rvore fonte do MySQL. o a

Notas de desenvolvimento SCO: O MySQL deve detectar automaticamente FSU Pthreads e ligar o mysqld com lgthreads -lsocket -lgthreads. As bibliotecas de desenvolvimento SCO so re-entrantes nas FSU Pthreads. A SCO a diz que suas bibliotecas de funes so re-entrantes, ento elas devem ser re-entrantes co a a com as FSU-Pthreads. FSU Pthreads no OpenServer tentam usar o esquema SCO para criar bibliotecas re-entrantes. FSU Pthreads (ao menos a verso em http://www.mysql.com) vem ligada com GNU a malloc. Se voc encontrar problemas com uso de memria, tenha certeza que o e o em libgthreads.a e libgthreads.so. gmalloc.o esteja incluido Na FSU Pthreads, as seguintes chamadas de sistema so compat a iveis com pthreads: read(), write(), getmsg(), connect(), accept(), select() e wait(). O CSSA-2001-SCO.35.2 (O patch listado de costume como patch de segurana e c erg711905-dscr remap ver 2.0.0) quebra FSU threads e deixa o mysqld instvel. Voc a e deve remove-lo se voc deseja executar o mysqld em uma mquina OpenServer 5.0.6. e a A SCO fornece Patches do Sistema Operacional em ftp://ftp.sco.com/pub/openserver5 para OpenServer 5.0.x A SCO fornece correes de segurana e libsocket.so.2 em ftp://ftp.sco.com/pub/security/OpenSer co c e ftp://ftp.sco.com/pub/security/sse para OpenServer 5.0.x Correes de segurana pre-OSR506. co c Tamb a correo do telnetd em e ca ftp://stage.caldera.com/pub/security/openserver/ ou ftp://stage.caldera.com/pub/securi com a libsocket.so.2 e libresolv.so.1 com instrues para instalar em sistemas preco OSR506. E provavelmente uma boa idia para instalar os patches acima tentando compilar/usar e o MySQL. Se voc deseja instalar o DBI no SCO, voc deve e e subdiretrio. o Note que o exemplo abaixo considera o gcc 2.95.2 OLD: CC = cc CCCDLFLAGS = -KPIC -W1,-Bexport CCDLFLAGS = -wl,-Bexport LD = ld LDDLFLAGS = -G -L/usr/local/lib LDFLAGS = -belf -L/usr/local/lib LD = ld OPTIMISE = -Od editar o Makefile em DBI-xxx e cada ou mais novo: NEW: CC = gcc CCCDLFLAGS = -fpic CCDLFLAGS = LD = gcc -G -fpic LDDLFLAGS = -L/usr/local/lib LDFLAGS = -L/usr/local/lib LD = gcc -G -fpic OPTIMISE = -O1

Cap tulo 2: Instalao do MySQL ca

163

OLD: CCCFLAGS = -belf -dy -w0 -U M_XENIX -DPERL_SCO5 -I/usr/local/include NEW: CCFLAGS = -U M_XENIX -DPERL_SCO5 -I/usr/local/include Isto porque o carregador dinmico Perl no ir carregar os mdulos DBI se elas foram e a a a o compiladas com icc ou cc. Perl trabalha melhor quando compilado com cc.

2.6.6.10 Notas SCO Unixware Version 7.0

Voc deve usar uma verso de MySQL pelo menos to recente quando a Verso 3.22.13 e a a a e UnixWare 7.1.0 porque esta verso corrige alguns problemas de portabilidade sob o a Unixware. Ns temos compilado o MySQL com o seguinte comando configure no UnixWare Verso o a 7.1.x: CC=cc CXX=CC ./configure --prefix=/usr/local/mysql Se voc deseja usar o gcc, dever ser usado o gcc 2.95.2 ou mais novo. e a CC=gcc CXX=g++ ./configure --prefix=/usr/local/mysql 1. A SCO fornece Patches do Sistema Operacional em ftp://ftp.sco.com/pub/unixware7 para UnixWare 7.1.1 e 7.1.3 ftp://ftp.sco.com/pub/openunix8 para OpenUNIX 8.0.0 2. A SCO fornece informao sobre Security Fixes em ftp://ftp.sco.com/pub/security/OpenUNIX ca para OpenUNIX ftp://ftp.sco.com/pub/security/UnixWare para UnixWare

2.6.7 Notas OS/2

O MySQL usa poucos arquivos aberto. Por isto, voc deve adicionar uma linha parecida e com a abaixo em seu arquivo CONFIG.SYS: SET EMXOPT=-c -n -h1024 Se voc no zer isto, provavelmente vai ter o seguinte erro: e a File xxxx not found (Errcode: 24) Quando usar o MysQL com OS/2 Warp 3, o FixPack 29 ou superior necessrio. Com OS/2 e a Warp 4, FixPack 4 ou acima necessrio. Isto uma exigncia da biblioteca Pthreads. O e a e e MySQL deve estar instalado em uma partio que suporta nomes longos de arquivos como ca no HPFS, FAT32, etc. O script INSTALL.CMD deve ser executado pelo prprio CMD.EXE do OS/2 e opde no o a funcionar com shells substitutas como o 4OS2.EXE. O script scripts/mysql-install-db foi renomeado. Agora ele chamado install.cmd e e um script REXX, que ir atualizar as conguraes padres de segurana do MySQL e e a co o c criar os icones na WorkPlace Shell para o MySQL. Suporte a mdulos dinmicos compilado mas no totalmente testado. Mdulos dinmicos o a e a o a devem ser compilados usando a biblioteca run-time Pthreads.

164

MySQL Technical Reference for Version 5.0.0-alpha

gcc -Zdll -Zmt -Zcrtdll=pthrdrtl -I../include -I../regex -I.. \ -o example udf_example.cc -L../lib -lmysqlclient udf_example.def mv example.dll example.udf Nota: Devido a limitaes no OS/2, o nome do mdulo UDF no deve esceder 8 caracteres. co o a Mdulos so armazenados no diretrio /mysql2/udf; o script safe-mysqld.cmd ir coloo a o a car este diretrio na varivel de ambiente BEGINLIBPATH. Quando usando mdulos UDF, o a o extenses espec o icas so ignoradas consuidera-se que seja .udf. Por exemplo, no Unix, a o mdulo compartilhado deve ser nomeado example.so e voc deve carregar uma funo o e ca dele desta forma: mysql> CREATE FUNCTION metaphon RETURNS STRING SONAME "example.so"; No OS/2, o mdulo deve ter o nome de example.udf, mas voc no deve especicar a o e a extenso do mdulo: a o mysql> CREATE FUNCTION metaphon RETURNS STRING SONAME "example";

2.6.8 Notas Novell NetWare

Portar o MySQL para NetWare foi um grande esforo da Novell. Os clientes da Novell estaro c a satisfeitos ao notarem que o NetWare 6.5 vir com os binrios do MySQL, completa com a a uma licena de uso comercial automatica para todos os servidores executando esta verso c a do NetWare. Veja Seo 2.1.4 [Instalao NetWare], Pgina 74. ca ca a MySQL para NetWare compilado usando um combinao do Metrowerks CodeWarrior e ca for NetWare e uma verso especial de compilaao cruzada do GNU autotools. Verique a c esta seo no futuro para mais informaes sobre construo e otimizao do MySQL para ca co ca ca NetWare.

2.6.9 Notas BeOS

Ns j falamos com alguns desenvolvedores BeOS que disseram que o MySQL est 80% o a a portado para o BeOS, mas ns no sabemos qual a situao no momento. o a ca

2.7 Comentrios de Instalao do Perl a ca

2.7.1 Instalando Perl no Unix
O suporte Perl para o MySQL fornecido pela interface cliente DBI/DBD. Veja Seo 12.5 e ca [Perl], Pgina 881. O cdigo do cliente Perl DBD/DBI exige Perl Verso 5.004 ou posterior. a o a A interface no funcionar se voc tiver uma verso mais do Perl. a a e a O suporte MySQL Perl tambm exige que voc tenha instalado o suporte a programao e e ca do cliente MySQL. Se voc instalou o MySQL a partir de arquivos RPM, os programas e cliente esto no cliente RPM, mas o suporte a programao do cliente est no RPM de a ca a desenvolvimento. Certique de se instalar este RPM posteriormente.

Cap tulo 2: Instalao do MySQL ca

165

Na Verso 3.22.8, o suporte Perl distribu separadamente do dsitribuio principal do a e ido ca MySQL. Se voc quiser instalar o suporte Perl, os arquivos que voc precisr pode ser e e a obtidos em http://www.mysql.com/downloads/api-dbi.html. As distribuies Perl so fornecidas como arquios tar compactados e so chamados co a a MODULE-VERSION.tar.gz, onde MODULE o nome do modulo e VERSION o nmero da e e u verso. Voc deve conseguir as distribuies Data-Dumper, DBI, e DBD-mysql e instal-las a e co a nesta ordem. O procedimento de instalao mostrado aqui. O exemplo mostrado para ca e e o mdulo Data-Dumper, mas o procedimento o mesmo para todas as distribuies: o e co 1. Descompacte as distribuies no diretrio atual: co o shell> gunzip < Data-Dumper-VERSION.tar.gz | tar xvf Este comando cria um diretrio chamado Data-Dumper-VERSION. o 2. Entre no diretrio principal da distribuio descompactada: o ca shell> cd Data-Dumper-VERSION 3. Contrua a dsitribuio e compile tudo: ca shell> perl Makefile.PL shell> make shell> make test shell> make install O comando make test importante porque verica que o mdulo est funcionando. Note e o a que ao executar este comando durante a instalaao do DBD-mysql para exercitar o cdigo c o da interface, o servidor MySQL deve estar em execuo ou teste ir falhar. ca a uma boa idia reconstruir e reinstalar a distribuio DBD-mysql mesmo se voc instalar E e ca e uma nova distribuio do MySQL, particularmente se voc notar simntomas como se todos ca e os seus scripts DBI realizarem dump core depois de voc atualizar o MySQL. e Se voc no tem o direito para instalar os mdulos Perl no diretrio de sistema ou se voc e a o o e quiser instalar mdulos Perl locais, a seguinte referncia pode ajud-lo: o e a http://servers.digitaldaze.com/extensions/perl/modules.html#modules Procure sob o t itulo Installing New Modules that Require Locally Installed Modules.

2.7.2 Instalaando ActiveState Perl no Windows

Para instalar o mdulo DBD do MySQL com ActiveState Perl no Windows, voc deve fazer o e o seguinte: Obter o ActiveState Perl em http://www.activestate.com/Products/ActivePerl/ e instal-lo. a Abrir um prompt do DOS. Se exigido, congurar a varivel HTTP_proxy. Por exemplo, voc pode tentar: a e set HTTP_proxy=my.proxy.com:3128 Inicie o progrma PPM: C:\> c:\perl\bin\ppm.pl Se voc j no o fez, instale o DBI: e a a

166

MySQL Technical Reference for Version 5.0.0-alpha

ppm> install DBI Se der tudo certo, execute o seguinte comando: install \ ftp://ftp.de.uu.net/pub/CPAN/authors/id/JWIED/DBD-mysql-1.2212.x86.ppd O acima deve funcionar pelo menos com o ActiveState Perl Verso 5.6. a Se voc no puder fazer o mostrado acima funcionar, voc deve instalar o driver MyODBC e e a e conectar ao servidor MySQL atravs do ODBC: e use DBI; $dbh= DBI->connect("DBI:ODBC:$dsn",$user,$password) || die "Got error $DBI::errstr when connecting to $dsn\n";

2.7.3 Problemas Usando a Interface Perl DBI/DBD

Se Perl informar que no pode encontrar o mdulo ../mysql/mysql.so, ento o a o a problema mais provvel que o Perl no pode localizar a biblioteca compartilhada a e a libmysqlclient.so. Voc pode corrigir isto por qualquer um dos seguintes mtodos: e e Compile a distribuio DBD-mysql com perl Makefile.PL -static -config em vez ca de perl Makefile.PL. Copie libmysqlclient.so para a diretrio onde sua bibliotecas compartilhadas esto o a localizadas (provavelmente /usr/lib ou /lib). No Linux voc pode adicionar o caminho do diretrio onde libmysqlclient.so est e o a localizado ao arquivo /etc/ld.so.conf. Adicione o caminho do diretrio onde libmysqlclient.so est localizada ` varivel o a a a de ambiente LD_RUN_PATH. Se voce receber os seguintes erros de DBD-mysql, voc provavelmente est usando gcc (ou e a usando um binrio antigo compilado com gcc): a /usr/bin/perl: cant resolve symbol __moddi3 /usr/bin/perl: cant resolve symbol __divdi3 Adicione -L/usr/lib/gcc-lib/... -lgcc ao comando de ligao quando a biblioteca ca mysql.so estiver constru (verique a sa de make para mysql.so quando voc ida ida e compilar o cliente Perl). A opo -L deve especicar o caminho do diretrio onde ca o libgcc.a est localizada no seu sistema. a Outra causa deste problema pode ser que Perl e o MySQL no so compilados com gcc. a a Neste caso, voc pode resolver o problema compilando ambos com gcc. e Se voc receber o seguinte erro de DBD-mysql quando executar o teste: e t/00base............install_driver(mysql) failed: Cant load ../blib/arch/auto/DBD/mysql/mysql.so for module DBD::mysql: ../blib/arch/auto/DBD/mysql/mysql.so: undefined symbol: uncompress at /usr/lib/perl5/5.00503/i586-linux/DynaLoader.pm line 169. signica que voc precisa adicionar a biblioteca compactada, -lz, a sua linha de ligao. e ca Isto pode ser feito com a seguinte alterao no arquivo lib/DBD/mysql/Install.pm: ca

Cap tulo 2: Instalao do MySQL ca

167

$sysliblist .= " -lm"; Altere esta linha para: $sysliblist .= " -lm -lz"; Depois disto, voc deve executar make realclean e proceder com o instalao desde o in e ca icio. Se voc quiser usar o mdulo Perl em um sistema que no suporta ligao dinmica (como e o a ca a SCO) voc pode gerar uma verso esttica do Perl que inclui DBI e DBD-mysql. O modo e a a que isto funciona que voc gera uma verso do Perl com o odigo DBI ligado e instalado e e a c no topo do seu Perl atual. Entao voc o utiliza para construir uma verso do Perl que e a adicionalmente tem o cdigo DBD ligado em si, e instale-o. o No SCO, voc deve ter as seguintes variveis de ambiente conguradas: e a shell> LD_LIBRARY_PATH=/lib:/usr/lib:/usr/local/lib:/usr/progressive/lib ou shell> LD_LIBRARY_PATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:\ /usr/progressive/lib:/usr/skunk/lib shell> LIBPATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:\ /usr/progressive/lib:/usr/skunk/lib shell> MANPATH=scohelp:/usr/man:/usr/local1/man:/usr/local/man:\ /usr/skunk/man: Primeiro crie um Perl que inclui um mdulo DBI ligado estaticamente executando estes o comandos no diretrio onde a sua distribuio DBI est localiada: o ca a shell> perl Makefile.PL -static -config shell> make shell> make install shell> make perl Ento voc deve intalar o novo Perl. A sa de make perl indicar o comando make a e ida a exato que voc precisar executar para realizar a instalao. No SCO, isto make -f e a ca e Makefile.aperl inst_perl MAP_TARGET=perl. A seguir use o Perl rcem criado para criar outro Perl que tambm inclui uma DBD::mysql e e estaticamente ligado rodando estes comandos no diretrio onde sua distribuio DBD-mysql o ca est localizada: a shell> perl Makefile.PL -static -config shell> make shell> make install shell> make perl Finalmente voc deve instalar este novo Perl. Novamente, a sa de make perl indica o e ida comando a usar.

168

MySQL Technical Reference for Version 5.0.0-alpha

3 Tutorial de Introduo Do MySQL ca

Este cap itulo fornece um tutorial de introduo ao MySQL demonstrando como usar o ca programa cliente mysql para criar e usar um banco de dados simples. mysql (algumas vezes apresentado como o terminal monitor ou apenas monitor) um programa interativo que e lhe permite conectar a um servidor MySQL, executar consultas e visualizar os resultados. mysql pode tambm ser executado em modo batch: voc coloca suas consultas em um e e arquivo, depois diz ao mysql para executar o contedo do arquivo. Cobrimos aqui ambas u as formas de utilizar o mysql. Para ver uma lista de opes conhecidas pelo mysql, chame-o com a opo --help: co ca shell> mysql --help Este cap itulo presume que o mysql est instalado na sua mquina e que um servidor MySQL a a est dispon a ivel para quem puder conectar. Se isto no for verdade, contate seu admina istrador MySQL. (Se voc o administrador, voc precisar consultar outras sees deste e e e a co manual.) Este cap itulo descreve todo o processo de congurao e uso de um banco de dados. Se ca voc estiver interessado em apenas acessar um banco de dados j existente, podera pular e a as sees que descrevem como criar o banco de dados e suas respectivas tabelas. co Como este cap itulo um tutorial, vrios detalhes so necessariamente omitidos. Consulte e a a as sees relevantes do manual para mais informaes sobre os tpicos cobertos aqui. co co o

3.1 Conectando e Desconectando do Servidor

Para conectar ao servidor, normalmente voc precisar fornecer um nome de usurio quando e a a o mysql for chamado e, na maioria dos casos, uma senha. Se o servidor executa em uma mquina diferente de onde voc est, voc tambm precisar especicar um nome a e a e e a de mquina. Contate seu administrador para saber quais parmetros de conexo voc deve a a a e usar para conectar (isto , qual mquina, usurio e senha usar). Uma vez que voc saiba e a a e quais os parmetros corretos, voc deve estar pronto para conectar da seguinte forma: a e shell> mysql -h servidor -u usuario -p Enter password: ******** Os asteriscos (********) representam sua senha; digite-a quando o mysql mostrar o prompt Enter password:. Se isto funcionar, voc deve ver algumas informaoes iniciais seguidas de um prompt mysql> e c shell> mysql -h host -u user -p Enter password: ******** Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 25338 to server version: 4.0.14-log Type help; or \h for help. Type \c to clear the buffer. mysql> O prompt lhe diz que o mysql est pronto para que voc digite os comandos. a e

Cap tulo 3: Tutorial de Introduo Do MySQL ca

169

Algumas instalaes MySQL permitem aos usurios de se conectarem como usurios co a a annimos ao servidor executando na mquina local. Se isto o caso na sua mquina, voc o a e a e deve conseguir conectar ao servidor chamando o mysql sem qualquer opo: ca shell> mysql Depois de voc conectar com sucesso, voc pode disconectar a qualquer hora digitando QUIT e e (ou \q) no prompt mysql>: mysql> QUIT Bye No Unix, voc tambm pode desconectar pressionando Control-D. e e A maioria dos exemplos nas sees seguintes assumem que voc j est conectado ao servidor. co e a a Isto indicado pelo prompt mysql>. e

3.2 Fazendo Consultas

Tenha certeza que voc est conectado ao servidor, como discutido na seo anterior. Isto e a ca feito, no ser selecionado nenhum banco de dados para trabalhar, mas no tem problemas. a a a Neste momento, mais importante saber um pouco sobre como fazer consultas do que j e a criar tabelas, carregar dados para elas, e recuperar dados delas. Esta seo descreve os ca princ ipios bsicos da entrada de comandos, usando diversas consultas voc pode tentar se a e familiarizar com o funcionamento do mysql. Aqui est um comando simples que solicita ao servidor seu nmero de verso e a data atual. a u a Digite-o como visto abaixo seguindo o prompt mysql> e digite a tecla RETURN: mysql> SELECT VERSION(), CURRENT_DATE; +--------------+--------------+ | version() | CURRENT_DATE | +--------------+--------------+ | 3.22.20a-log | 1999-03-19 | +--------------+--------------+ 1 row in set (0.01 sec) mysql> Esta consulta ilustra vrias coisas sobre o mysql: a Um comando normalmente consiste de uma instruo SQL seguida por um ponto e ca v irgula. (Existem algumas excees onde um ponto e v co irgula podem ser omitidos. QUIT mencionado anteriormente, um deles. Saberemos de outros mais tarde.) e Quando voc emite um comando, o mysql o envia para o servidor para execuo e e ca mostra os resultados, depois imprime outro prompt mysql> para indicar que est pronto a para outro comando. O mysql mostra a sa da consulta em forma tabular (linhas e colunas). A primeira ida linha contm rtulos para as colunas. As linhas seguintes so o resultado da consulta. e o a Normalmente, rtulos de colunas so os nomes das colunas que voc busca das tabelas o a e do banco de dados. Se voc est recuperando o valor de uma expresso no lugar de e a a uma coluna de tabela (como no exemplo j visto), o mysql rotula a coluna usando a a prpria expresso. o a

170

MySQL Technical Reference for Version 5.0.0-alpha

O mysql mostra quantas linhas foram retornadas e quanto tempo a consulta levou para executar, o que lhe d uma vaga idia da performance do servidor. Estes valores a e so impreciso porque eles representam tempo de relgio (No tempo de CPU ou de a o a mquina), e porque eles so afetados pelos fatores como a carga do servidor e latncia a a e de rede. (Para resumir, a linha rows in set no mostrada nos exemplos seguintes a e deste cap itulo.) Palavras Chave podem ser entradas em qualquer caso de letra. As seguintes consultas so a equivalentes: mysql> SELECT VERSION(), CURRENT_DATE; mysql> select version(), current_date; mysql> SeLeCt vErSiOn(), current_DATE; Aqui est outra consulta. Ela demonstra que voc pode usar o mysql como uma calculadora a e simples: mysql> SELECT SIN(PI()/4), (4+1)*5; +-------------+---------+ | SIN(PI()/4) | (4+1)*5 | +-------------+---------+ | 0.707107 | 25 | +-------------+---------+ As consultas mostradas at agora tm sido instrues relativamente pequenas, de uma linha. e e co Voc pode tambm entrar com mltiplas instrues em uma unica linha. Basta nalizar e e u co cada uma com um ponto e v irgula: mysql> SELECT VERSION(); SELECT NOW(); +--------------+ | VERSION() | +--------------+ | 3.22.20a-log | +--------------+ +---------------------+ | NOW() | +---------------------+ | 1999-03-19 00:15:33 | +---------------------+ Um comando no necessita estar todo em uma unica linha, ento comandos extensos que a a necessitam de vrias linhas no so um problema. O mysql determina onde sua instruo a a a ca termina atravs do ponto e v e irgula terminador, e no pelo nal da linha de entrada. (Em a outras palavras, o myqsl aceita entradas de livre formato: Ele coleta linhas de entrada mas no as executa at chegar o ponto e v a e irgula.) Aqui est uma instruo simples usando mltiplas linhas: a ca u mysql> SELECT -> USER() -> , -> CURRENT_DATE; +--------------------+--------------+

Cap tulo 3: Tutorial de Introduo Do MySQL ca

171

| USER() | CURRENT_DATE | +--------------------+--------------+ | joesmith@localhost | 1999-03-18 | +--------------------+--------------+ Neste exemplo, note como o prompt altera de mysql> para -> depois de voc entrar a e primeira linha de uma consulta com mltiplas linhas. Isto como o mysql indica que ainda u e no achou uma instruo completa e est esperando pelo resto. O prompt seu amigo, a ca a e porque ele fornece um retorno valioso. Se voc usa este retorno, voc sempre estar ciente e e a do que o mysql est esperando. a Se voc decidir que no deseja executar um comando que est no meio do processo de e a a entrada, cancele-o digitando \c: mysql> SELECT -> USER() -> \c mysql> Note o prompt aqui tambm. Ele troca para o mysql> depois de voc digitar \c, fornecendo e e retorno para indicar que o mysql est pronto para um novo comando. a A seguinte tabela mostra cada dos prompts que voc pode ver e resume o que ele signica e sobre o estado em que o mysql se encontra: Prompt Signicado mysql> Pronto para novo comando. -> Esperando pela prxima linha de comando com mltiplas linhas. o u > Esperando pela prxima linha, coletando uma string que comece com o uma aspas simples (). "> Esperando pela prxima linha, coletando uma string que comece com o aspas duplas ("). > Esperando pela prxima linha, coletando uma string que comece com o crase (). muito comum instrues multi-linhas ocorrerem por acidente quando voc pretende pubE co e licar um comando em uma unica linha, mas esquece o ponto e v irgula terminador. Neste caso,o mysql espera por mais entrada: mysql> SELECT USER() -> Se isto ocorrer com voc (acha que entrou uma instruo mas a unica resposta um prompt e ca e ->), o mais provvel que o mysql est esperando pelo ponto e v a e a irgula. Se voc no e a perceber o que o prompt est lhe dizendo, voc pode parar por um tempo antes de entender a e o que precisa fazer. Entre com um ponto e v irgula para completar a instruo, e o mysql ca ir execut-la: a a mysql> SELECT USER() -> ; +--------------------+ | USER() | +--------------------+ | joesmith@localhost | +--------------------+

172

MySQL Technical Reference for Version 5.0.0-alpha

O prompt > e "> ocorrem durante a coleta de strings. No MySQL, voc pode escrever e strings utilizando os caracteres ou " (por exemplo, hello ou "goodbye"), e o mysql permite a entrada de strings que consomem mltiplas linhas. Quando voc ver um prompt u e > ou ">, signica que voc digitou uma linha contendo uma string que comea com um e c caracter de aspas ou " mas ainda no entrou com a aspas que termina a string. Isto a bom se voc realmente est entrando com uma string com mltiplas linhas, mas qual e e a u e a probalidade disto acontecer ? No muita. Geralmente, os prompts > e "> indicam que a voc, por algum descuido, esqueceu algum caracter de aspas. Por exemplo: e mysql> SELECT * FROM minha_tabela WHERE nome = "Smith AND idade < 30; "> Se voc entrar esta sentena SELECT, apertar ENTER e esperar pelo resultado, nada ir e c a acontecer. Em vez de se perguntar o porqu desta query demorar tanto tempo, perceba a e pista fornecida pelo prompt ">. Ele lhe diz que o mysql espera pelo resto de uma string no terminada. (Voc ve o erro na declarao? Falta a segunda aspas na string "Smith.) a e ca O que fazer neste ponto ? A coisa mais simples cancelar o comando. Entretanto, voc e e no pode simplesmente digitar \c neste caso, porque o mysql o intrerpreta como parte da a string que est coletando! Digite o caracter de aspas para fechar (ento o mysql sabe que a a voc fechou a string), ento digite \c: e a mysql> SELECT * FROM minha_tabela WHERE nome = "Smith AND idade < 30; "> "\c mysql> O prompt volta para mysql>, indicando que o mysql est pronto para um novo comando. a O prompt > similar aos prompts > e ">, mas indica que voc comeou mas no completou e e c a um identicados citado com o sinal de crase. E importante saber o que os prompts >, "> e > signicam, porque se voc entrar sem e querer com uma string sem terminao, quaisquer linhas seguintes que forem digitadas ca sero ignoradas pelo mysql incluindo uma linha contendo QUIT! Isto pode ser um pouco a confuso, especialmente se voc no sabe que voc precisa fornecer as aspas nais antes poder e a e cancelar o comando atual.

3.3 Criao e Utilizao de um Banco de Dados ca ca

Agora que voc j sabe como entrar com os comandos, hora de acessar um banco de dados. e a e Suponha que voc tenha diversos animais de estimao em sua casa (menagerie) e voc e ca e gostaria de ter o registro de vrios tipos de informaes sobre eles. Voc pode fazer isto a co e criando tabelas para armazenar seus dados e carreg-los com a informao desejada. Depois a ca voc pode responder diferentes tipos de questes sobre seus animais recuperando dados das e o tabelas. Esta seo mostrar como: ca a Criar um banco de dados Criar uma tabela Carregar dados na tabela Recuperar dados de uma tabela de vrias maneiras a Usar mltiplas tabelas u

Cap tulo 3: Tutorial de Introduo Do MySQL ca

173

O banco de dados menagerie ser simples (deliberadamente), mas no dif a a e icil pensar em situaes na vida real em que um tipo similar de banco de dados pode co ser usado. Por exemplo, um banco de dados deste tipo pode ser usado por um fazendeiro para gerenciar seu estoque de animais, ou por um veterinrio para a gerenciar registros de seus pacientes. Uma distribuio do menagerie contendo ca algumas das consultas e dados de exemplos usados nas sees seguintes podem ser co obtidas do site Web do MySQL. Esto dispon a iveis tanto no formato tar comprimido (http://www.mysql.com/Downloads/Contrib/Examples/menagerie.tar.gz) como no formato Zip (http://www.mysql.com/Downloads/Contrib/Examples/menagerie.zip). Utilize a instruo SHOW para saber quais bancos de dados existem atualmente no servidor: ca mysql> SHOW DATABASES; +----------+ | Database | +----------+ | mysql | | test | | tmp | +----------+ A lista de bancos de dados provavelmente ser diferente na sua mquina, mas os bancos de a a dados mysql e test provavelmente estaro entre eles. O banco de dados mysql necessrio a e a porque ele descreve privilgios de acessos de usurios. O banco de dados test geralamente e a e fornecido como um espao para que os usurios possam fazer testes. c a Note que voc no pode ver todos os banco de dados se voc ni tiver o privilgio SHOW e a e a e DATABASES. Veja Seo 4.4.1 [GRANT], Pgina 254. ca a Se o banco de dados test existir, tente acess-lo: a mysql> USE test Database changed Perceba que o USE, como o QUIT, no necessitam de um ponto e v a irgula. (Voc pode e terminar tais declaraes com uma ponto e v co irgula se gostar; isto no importa) A instruo a ca USE especial em outra maneira, tambm: Ela deve ser usada em uma unica linha. e e Voc opde usar o banco de dados test (Se voc tiver acesso a ele) para os exemplos que e e seguem mas qualquer coisa que voc criar neste banco de dados pode ser removido por e qualquer um com acesso a ele. Por esta razo, voc provavelmente deve pedir permisso a e a ao seu administrador MySQL para usar um banco de dados prprio. Suponha que voc o o e chame de menagerie. O administrador precisar executar um comando como este: mysql> GRANT ALL ON menagerie.* TO your_mysql_name@your_client_host; onde seu_usurio_mysql o nome do usurio MySQL atribuido a voc e your_client_ a e a e host a mquina da qual voc se conecta ao servidor. e a e

3.3.1 Criando e Selecionando um Banco de Dados

Se o administrador criar seu banco de dados quando congurar as suas permisses, voc o e pode comear a us-lo. Seno, voc mesmo precisa cri-lo: c a a e a

174

MySQL Technical Reference for Version 5.0.0-alpha

mysql> CREATE DATABASE menagerie; No Unix, nomes de bancos de dados so caso sensitivo (ao contrrio das palavras chave a a SQL), portanto voc deve sempre fazer referncia ao seu banco de dados como menagerie e e e no Menagerie, MENAGERIE ou outra variao. Isto tambm verdade para nomes de a ca e e tabelas. (No Windows, esta restrio no se aplica, entiretanto voc deve referenciar os ca a e bancos de dados e tabelas usando o mesmo caso em toda a parte da consulta.) Criar um bancos de dados no o seleciona para o uso; voc deve fazer isso de forma expl a e icita. Para fazer o menagerie o banco de dados atual, use o comando: mysql> USE menagerie Database changed Seu banco de dados necessita ser criado somente uma unica vez, mas voc deve selecion-lo e a para o uso cada vez que voc iniciar uma seo mysql. Voc pode fazer isso usando a e ca e instruo USE como visto no exemplo. Uma forma alternativa selecionar o banco de dados ca e na linha de comando quando voc chamar o mysql. Apenas especique seu nome depois de e qualquer parmetro de conexo que voc pode precisar fornecer. Por exemplo: a a e shell> mysql -h servidor -u usuario -p menagerie Enter password: ******** Perceba que menagerie no sua senha no comando mostrado. Se voc precisar passar sua a e e senha na linha de comando depois da opo -p, voc deve faz-lo sem usar espaos (por ca e e c exemplo, -pminhasenha e no como em -p minhasenha). Entretando, colocando sua senha a na linha de comando no recomendado, porque isto expe sua senha permitindo que outro a e o usurio utilize a sua mquina. a a

3.3.2 Criando uma Tabela

Criar o banco de dados a parte fcil, mas neste ponto ele est vazio, como o SHOW TABLES e a a mostrar: a mysql> SHOW TABLES; Empty set (0.00 sec) A parte mais dif decidir qual a estrutura que seu banco de dados deve ter: quais tabelas icil e voc precisar e que colunas estaro em cada uma delas. e a a Voc ir precisar de uma tabela para guardar um registro para cada um de seus animais e a de estimao. Esta tabela pode ser chamada pet, e ela deve conter, pelo menos, o nome ca de cada animal. Como o nome por si s no muito interessante, a tabela dever conter o a e a outras informaes. Por exemplo, se mais de uma pessoa na sua fam tambm tem co ilia e animais, voc pode desejar listar cada dono. Voc pode tambm desejargravar algumas e e e informaes descritivas bsicas como espcie e sexo. co a e Que tal a idade? Pode ser do interesse, mas no uma boa coisa para se armazenar em um a e banco de dados. A idade muda ` medida em que o tempo passa, o que signica que voc a e sempre ter de atualizar seus registros. Em vez disso, melhor armazenar um valor xo a e como a data de nascimento. Ento, sempre que voc precisar da idade, basta voc calcul-la a e e a como a diferena entre a data atual e a data de aniversrio. O MySQL fornece funes para c a co fazer aritmtica de datas, ento isto no dif e a a e icil. Armazenando datas de aniversrio no a lugar da idade tambm oferece outras vantagens: e

Cap tulo 3: Tutorial de Introduo Do MySQL ca

175

Voc pode usar o banco de dados para tarefas como gerar lembretes para aniversrios e a que esto chegando. (Se voc pensa que este tipo de query algo bobo, perceba que a e e a mesma questo que voc perguntar no contexto de um banco de dados comercial e a e para identicar clientes para quais voc precisar enviar carto de aniversrio, para um e a a a toque pessoal assistido pelo computador.) Voc pode calcular a idade em relao a outras datas diferente da data atual. Por e ca exemplo, se voc armazenar a data da morte no banco de dados, voc poder facilmente e e a calcular qual a idade que o bicho tinha quando morreu. Voc provavelmente pode pensar em outros tipos de informaes que podero ser uteis e co a na tabela pet, mas as identicadas at o momento so sucientes por agora: nome(name), e a dono(owner), espcie(species), sexo(sex), data de nascimento(birth) e data da morte(death). e Utilize a sentea CREATE TABLE para especicar o layout de sua tabela: c mysql> CREATE TABLE pet (nome VARCHAR(20), owner VARCHAR(20), -> species VARCHAR(20), sex CHAR(1), birth DATE, death DATE); VARCHAR uma boa escolha para os campos name, owner, e species porque os valores da e coluna so de tamanho varivel. Os tamanhos destas colunas no precisam necessriamente a a a a de ser os mesmos e no precisam ser 20. Voc pode escolher qualquer tamanho de 1 a 255, a e o que voc achar melhor. (Se voc no zer uma boa escolha e depois precisar de um campo e e a maior, o MySQL fornece o comando ALTER TABLE.) O sexo dos animais podem ser representados em vrias formas, por exemplo, "m" e "f" ou a mesmo "macho" e "f^mea". E mais simples usar os caracteres "m" e "f". e O uso do tipo de dados DATE para as colunas birth e death so obviamente a melhor a escolha. Agora que voc criou uma tabela, a instruo SHOW TABLES deve produzir alguma sa e ca ida: mysql> SHOW TABLES; +---------------------+ | Tables in menagerie | +---------------------+ | pet | +---------------------+ Para vericar se sua tabela foi criada da forma que voc esperava, utilize a instruo e ca DESCRIBE: mysql> DESCRIBE pet; +---------+-------------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +---------+-------------+------+-----+---------+-------+ | name | varchar(20) | YES | | NULL | | | owner | varchar(20) | YES | | NULL | | | species | varchar(20) | YES | | NULL | | | sex | char(1) | YES | | NULL | | | birth | date | YES | | NULL | | | death | date | YES | | NULL | | +---------+-------------+------+-----+---------+-------+ Voc pode usar DESCRIBE a qualquer hora, por exemplo, se voc esquecer os nomes das e e colunas na sua tabela ou de que tipos elas tm. e

176

MySQL Technical Reference for Version 5.0.0-alpha

3.3.3 Carregando dados em uma tabela

Depois de criar sua tabela, voc precisar povo-la. As instrues LOAD DATA e INSERT so e a a co a uteis para isto. Suponha que seu registro de animais possa ser descrito como abaixo: (Observe que o e MySQL espera datas no formato AAAA-MM-DD; isto pode ser diferente do que voc est e a acostumado.) name Fluy Claws Buy Fang Bowser Chirpy Whistler Slim owner Harold Gwen Harold Benny Diane Gwen Gwen Benny species cat cat dog dog dog bird bird snake sex f m f m m f m birth 1993-02-04 1994-03-17 1989-05-13 1990-08-27 1979-08-31 1998-09-11 1997-12-09 1996-04-29 death

1995-07-29

Como voc est comeando com uma tabela vazia, uma forma simples de povo-la criar e a c a e um arquivo texto contendo uma linha para cada um de seus animais, e depois carregar o contedo do arquivo para a tabela com uma simples instruo. u ca Voc pode criar um arquivo texto pet.txt contendo um registro por linha, com valores e separado por tabulaes e na mesma ordem em que as colunas foram listadas na instruo co ca CREATE TABLE. Para valores em falta (como sexo desconhecido ou data da morte para animais que ainda esto vivos), voc pode usar valores NULL. Para represent-lo em seu a e a arquivo texto, use \N (barra invertidam N maiusculo). Por exemplo, o registro para Whistler the bird podem parecer com isto (onde o espao em branco entre os valores um simples c e caractere de tabulao): ca name owner Whistler Gwen species sex birth bird \N 1997-12-09 death \N

Para carregar o arquivo texto pet.txt na tabela pet, use este comando: mysql> LOAD DATA LOCAL INFILE "pet.txt" INTO TABLE pet; Voc pode especicar o valor do separador de colunas e o marcador de nal de linha explicie tamente na instruo LOAD DATA se voc desejar. Mas os valores omitidos so sucientes ca e a para a instruo ler o arquivo pet.txt corretamente. ca Se a instruo falhar, desejvel que a sua instalao do MySQL no tenha a capacidade ca e a ca a do arquivo local habilitada por padro. Veja Seo 4.3.4 [LOAD DATA LOCAL], Pgina 231 a ca a para informaes sobre como alterar isto. co Quando voc desejar adicionar novos registros um a um, a instruo INSERT usada. Na e ca e sua forma mais simples, voc fornece valores para cada coluna, na ordem em que as colunas e foram listadas na instruo CREATE TABLE. Suponha que Diane tenha um novo hamster ca chamado Puball. Voc pode adicionar um registro utilizando uma instruo INSERT desta e ca forma: mysql> INSERT INTO pet -> VALUES (Puffball,Diane,hamster,f,1999-03-30,NULL);

Cap tulo 3: Tutorial de Introduo Do MySQL ca

177

Perceba que os valores de string e datas so especicados aqui como strings com aspas. a Com o INSERT voc tambm pode inserir NULL diretamente para representar um valor em e e falta. No pode ser usado \N como voc fez com LOAD DATA. a e A partir deste exemplo, voc dever perceber que existem vrias outras formas envolvidas e a a para carregar seus registros inicialmente utilizando diversas instrues INSERT do que uma co simples instruo LOAD DATA. ca

3.3.4 Recuperando Informaoes de uma Tabela c

A instruo SELECT usada para recuperar informaes de uma tabela. A forma geral da ca e co instruo : ca e SELECT o_que_mostrar FROM de_qual_tabela WHERE condi~es_para_satisfazer; co o_que_mostrar indica o que voc deseja ver. Isto pode ser uma lista de colunas ou * para e indicar todas colunas. de_qual_tabela indica a tabela de onde voc deseja recuperar e os dados. A clusula WHERE opcional. Se estiver presente, condi~es_para_satisfazer a e co especicam as condies que os registros devem satisfazer para fazer parte do resultado. co

3.3.4.1 Selecionando Todos os Dados

A forma mais simples do SELECT recuperar tudo de uma tabela: mysql> SELECT * FROM pet; +----------+--------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +----------+--------+---------+------+------------+------------+ | Fluffy | Harold | cat | f | 1993-02-04 | NULL | | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | | Fang | Benny | dog | m | 1990-08-27 | NULL | | Bowser | Diane | dog | m | 1979-08-31 | 1995-07-29 | | Chirpy | Gwen | bird | f | 1998-09-11 | NULL | | Whistler | Gwen | bird | NULL | 1997-12-09 | NULL | | Slim | Benny | snake | m | 1996-04-29 | NULL | | Puffball | Diane | hamster | f | 1999-03-30 | NULL | +----------+--------+---------+------+------------+------------+ Esta forma do SELECT util se voc deseja ver sua tabela inteira como agora, depois de e e voc acabar de carreg-la com os dados iniciais. Por exempo, voc pode pensar que a data e a e de nascimento do Bowser no est correta. Consultando seus papis originais de pedigree, a a e descobriu que o ano correto do nascimento deve ser 1989, no 1979. a Existem pelo menos duas formas de corrigir isto: Edite o arquivo pet.txt para corrigir o erro, depois limpe a tabela e recarregue-o usando DELETE e LOAD DATA: mysql> DELETE FROM pet; mysql> LOAD DATA LOCAL INFILE "pet.txt" INTO TABLE pet;

178

MySQL Technical Reference for Version 5.0.0-alpha

Entretanto, se voc zer isto, voc tambm deve refazer a entrada para Puball. e e e Corrigir somente o registro errado com uma instruo UPDATE: ca mysql> UPDATE pet SET birth = "1989-08-31" WHERE name = "Bowser"; O UPDATE altera apenas o registro em questo e no exige que voc recarregue a tabela. a a e

3.3.4.2 Selecionando Registros Espec icos

Como foi mostrado na seo anterior, fcil recuperar uma tabela inteira. Apenas omita ca e a a clusula WHERE da instruo SELECT. Mas normalmente voc no quer ver toda a tabela, a ca e a particularmente quando a tabela car grande. Em vez disso, voc estar mais interessado em e a ter a resposta de uma questo em particular, no qual voc especica detalhes da informao a e ca que deseja. Vamos ver algumas consultas de seleo nos termos das questes sobre seus ca o animais. Voc pode selecionar apenas registros espec e icos da sua tabela. Por exemplo, se voc deseja e vericar a alterao que fez na data de nascimento do Bowser, selecione o registro desta ca forma: mysql> SELECT * FROM pet WHERE name = "Bowser"; +--------+-------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +--------+-------+---------+------+------------+------------+ | Bowser | Diane | dog | m | 1989-08-31 | 1995-07-29 | +--------+-------+---------+------+------------+------------+ A sa conrma que o ano foi gravado corretamente agora como 1989 e no 1979. ida a Comparaes de strings normalmente so caso insensitivo, ento voc pode especicar o co a a e nome como "bowser", "BOWSER", etc. O resultado da pesquisa ser o mesmo. a Voc pode especicar condies em qualquer coluna, no apenas no name. Por exemplo, e co a se voc deseja saber quais foram os animais que nasceram depois de 1998, teste o campo e birth: mysql> SELECT * FROM pet WHERE birth >= "1998-1-1"; +----------+-------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +----------+-------+---------+------+------------+-------+ | Chirpy | Gwen | bird | f | 1998-09-11 | NULL | | Puffball | Diane | hamster | f | 1999-03-30 | NULL | +----------+-------+---------+------+------------+-------+ Voc pode combinar condies, por exemplo, para encontrar cadelas (dog/f): e co mysql> SELECT * FROM pet WHERE species = "dog" AND sex = "f"; +-------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +-------+--------+---------+------+------------+-------+ | Buffy | Harold | dog | f | 1989-05-13 | NULL | +-------+--------+---------+------+------------+-------+ A consulta anterior utiliza o operador lgico AND (e). Existe tambm um operador OR (ou): o e

Cap tulo 3: Tutorial de Introduo Do MySQL ca

179

mysql> SELECT * FROM pet WHERE species = "snake" OR species = "bird"; +----------+-------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +----------+-------+---------+------+------------+-------+ | Chirpy | Gwen | bird | f | 1998-09-11 | NULL | | Whistler | Gwen | bird | NULL | 1997-12-09 | NULL | | Slim | Benny | snake | m | 1996-04-29 | NULL | +----------+-------+---------+------+------------+-------+ AND e OR podem ser misturados, embora AND tem maior precedncia que OR. Se voc usar e e ambos os operadores, uma tima idia usar parnteses para indicar explicitamente quais e o e e condies devem ser agrupadas: co mysql> SELECT * FROM pet WHERE (species = "cat" AND sex = "m") -> OR (species = "dog" AND sex = "f"); +-------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +-------+--------+---------+------+------------+-------+ | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +-------+--------+---------+------+------------+-------+

3.3.4.3 Selecionando Colunas Espec icas

Se voc no desejar ver todo o registro de sua tabela, especique as colunas em que voc e a e estiver interessado, separado por virgulas. Por exemplo, se voc deseja saber quando seus e animais nasceram, selecione as colunas name e birth: mysql> SELECT name, birth FROM pet; +----------+------------+ | name | birth | +----------+------------+ | Fluffy | 1993-02-04 | | Claws | 1994-03-17 | | Buffy | 1989-05-13 | | Fang | 1990-08-27 | | Bowser | 1989-08-31 | | Chirpy | 1998-09-11 | | Whistler | 1997-12-09 | | Slim | 1996-04-29 | | Puffball | 1999-03-30 | +----------+------------+ Para saber quem so os donos dos animais, use esta consulta: a mysql> SELECT owner FROM pet; +--------+ | owner | +--------+ | Harold |

180

MySQL Technical Reference for Version 5.0.0-alpha

| Gwen | | Harold | | Benny | | Diane | | Gwen | | Gwen | | Benny | | Diane | +--------+ Entretanto, perceba que a query simplesmente retornou o campo owner de cada registro, e alguns deles apareceram mais de uma vez. Para minimizar a sa ida, recupere cada registro apenas uma vez, adicionando a palavra chave DISTINCT: mysql> SELECT DISTINCT owner FROM pet; +--------+ | owner | +--------+ | Benny | | Diane | | Gwen | | Harold | +--------+ Voc pode usar uma clusula WHERE para combinar seleo de registros com seleo de e a ca ca colunas. Por exemplo, para obter a data de nascimento somente dos gatos e cachorros, utilize esta query: mysql> SELECT name, species, birth FROM pet -> WHERE species = "dog" OR species = "cat"; +--------+---------+------------+ | name | species | birth | +--------+---------+------------+ | Fluffy | cat | 1993-02-04 | | Claws | cat | 1994-03-17 | | Buffy | dog | 1989-05-13 | | Fang | dog | 1990-08-27 | | Bowser | dog | 1989-08-31 | +--------+---------+------------+

3.3.4.4 Ordenando Registros

Voc deve ter percebido nos exemplos anteriores que os registros retornados no so mostrae a a da consulta quando os dos de forma ordenada. Normalmente mais fcil examinar a saida e a registros so ordenados com algum sentido. Para ordenar o resultado, utilize uma clusula a a ORDER BY. Aqui est o dia de nascimento dos animais, ordenado por data: a mysql> SELECT name, birth FROM pet ORDER BY birth; +----------+------------+

Cap tulo 3: Tutorial de Introduo Do MySQL ca

181

| name | birth | +----------+------------+ | Buffy | 1989-05-13 | | Bowser | 1989-08-31 | | Fang | 1990-08-27 | | Fluffy | 1993-02-04 | | Claws | 1994-03-17 | | Slim | 1996-04-29 | | Whistler | 1997-12-09 | | Chirpy | 1998-09-11 | | Puffball | 1999-03-30 | +----------+------------+ Em colunas de tipo de caracter, ordenaio como qualquer outra operao de comparao ca ca ca normalmente realizada no modo caso insensitivo. Isto signica que a ordem ser ine a denida para colunas que so idnticas exceto quanto ao caso da letra. Voc pode forar a e e c uma ordenao em caso senitivo para uma coluna usando a coero BINARY: ORDER BY ca ca BINARY(campo). A ordenao padro crescente, com os valores menores em primeiro. Para ordenao na ca a e ca ordem reversa, adicione a palavra chave DESC (descendente) ao nome da coluna que deve ser ordenada: mysql> SELECT name, birth FROM pet ORDER BY birth DESC; +----------+------------+ | name | birth | +----------+------------+ | Puffball | 1999-03-30 | | Chirpy | 1998-09-11 | | Whistler | 1997-12-09 | | Slim | 1996-04-29 | | Claws | 1994-03-17 | | Fluffy | 1993-02-04 | | Fang | 1990-08-27 | | Bowser | 1989-08-31 | | Buffy | 1989-05-13 | +----------+------------+ Voc pode ordenar por mltiplas colunas e voc pode classicar colunas em direes difere u e co entes. Por exemplo, para ordenar o tipo de animal em ordem crescente, depois por dia de nascimento dentro do tipo de animal em ordem decrescente (com os mais novos primeiro), utilize a seguinte consulta: mysql> SELECT name, species, birth FROM pet ORDER BY species, birth DESC; +----------+---------+------------+ | name | species | birth | +----------+---------+------------+ | Chirpy | bird | 1998-09-11 | | Whistler | bird | 1997-12-09 | | Claws | cat | 1994-03-17 | | Fluffy | cat | 1993-02-04 |

182

MySQL Technical Reference for Version 5.0.0-alpha

| Fang | dog | 1990-08-27 | | Bowser | dog | 1989-08-31 | | Buffy | dog | 1989-05-13 | | Puffball | hamster | 1999-03-30 | | Slim | snake | 1996-04-29 | +----------+---------+------------+ Perceba que a palavra chave DESC aplica somente para o nome da coluna precedente (birth); ela no afeta a ordenao da coluna species. a ca

3.3.4.5 Clculo de Datas a

O MySQL fornece vrias funes que voc pode usar para realizar clculos em datas, por a co e a exemplo, para calcular idades ou extrair partes de datas. Para determinar quantos anos cada um do seus animais tem, compute a diferena do ano c da data atual e a data de nascimento (birth), depois subtraia se a o dia/ms da data atual e for anterior ao dia/ms da data de nascimento. A consulta seguinte, mostra, para cada e animal, a data de nascimento, a data atual e a idade em anos. mysql> SELECT name, birth, CURDATE(), -> (YEAR(CURDATE())-YEAR(birth)) -> - (RIGHT(CURDATE(),5)<RIGHT(birth,5)) -> AS age -> FROM pet; +----------+------------+------------+------+ | name | birth | CURDATE() | age | +----------+------------+------------+------+ | Fluffy | 1993-02-04 | 2003-08-19 | 10 | | Claws | 1994-03-17 | 2003-08-19 | 9 | | Buffy | 1989-05-13 | 2003-08-19 | 14 | | Fang | 1990-08-27 | 2003-08-19 | 12 | | Bowser | 1989-08-31 | 2003-08-19 | 13 | | Chirpy | 1998-09-11 | 2003-08-19 | 4 | | Whistler | 1997-12-09 | 2003-08-19 | 5 | | Slim | 1996-04-29 | 2003-08-19 | 7 | | Puffball | 1999-03-30 | 2003-08-19 | 4 | +----------+------------+------------+------+ Aqui, YEAR() separa a parte do ano de uma data e RIGHT() separa os cinco caracteres mais a direita que representam a parte da data MM-DD. A parte da expresso que compara os a valores MM-DD resulta em 1 ou 0, o qual ajusta a diferena do ano um ano abaixo se CURDATE c ocorrer mais cedo, no ano, que birth. A expresso completa um tanto deselegante, ento a e a um apelido (age) usado para obter uma sa mais signicativa. e ida A consulta funciona, mas o resultado pode ser mais compreens ivel se os registros forem apresentados em alguma ordem. Isto pode ser feito adicionando uma clusula ORDER BY a pelo nome: name para ordenar a saida mysql> SELECT name, birth, CURDATE(),

Cap tulo 3: Tutorial de Introduo Do MySQL ca

183

-> (YEAR(CURDATE())-YEAR(birth)) -> - (RIGHT(CURDATE(),5)<RIGHT(birth,5)) -> AS age -> FROM pet ORDER BY name; +----------+------------+------------+------+ | name | birth | CURDATE() | age | +----------+------------+------------+------+ | Bowser | 1989-08-31 | 2003-08-19 | 13 | | Buffy | 1989-05-13 | 2003-08-19 | 14 | | Chirpy | 1998-09-11 | 2003-08-19 | 4 | | Claws | 1994-03-17 | 2003-08-19 | 9 | | Fang | 1990-08-27 | 2003-08-19 | 12 | | Fluffy | 1993-02-04 | 2003-08-19 | 10 | | Puffball | 1999-03-30 | 2003-08-19 | 4 | | Slim | 1996-04-29 | 2003-08-19 | 7 | | Whistler | 1997-12-09 | 2003-08-19 | 5 | +----------+------------+------------+------+ Para ordenar a sa por age em vez de name, s utilizar uma clusua ORDER BY diferente: ida e o a mysql> SELECT name, birth, CURDATE(), -> (YEAR(CURDATE())-YEAR(birth)) -> - (RIGHT(CURDATE(),5)<RIGHT(birth,5)) -> AS age -> FROM pet ORDER BY age; +----------+------------+------------+------+ | name | birth | CURDATE() | age | +----------+------------+------------+------+ | Chirpy | 1998-09-11 | 2003-08-19 | 4 | | Puffball | 1999-03-30 | 2003-08-19 | 4 | | Whistler | 1997-12-09 | 2003-08-19 | 5 | | Slim | 1996-04-29 | 2003-08-19 | 7 | | Claws | 1994-03-17 | 2003-08-19 | 9 | | Fluffy | 1993-02-04 | 2003-08-19 | 10 | | Fang | 1990-08-27 | 2003-08-19 | 12 | | Bowser | 1989-08-31 | 2003-08-19 | 13 | | Buffy | 1989-05-13 | 2003-08-19 | 14 | +----------+------------+------------+------+ Uma consulta similar pode ser usada para determinar a idade na morte para animais que morreram. Para determinar quais so os animais, conra se o valor de death no NULL. a a e Depois para estes com valores no-NULL, compute a diferena entre os valores dos campos a c death e birth: mysql> SELECT name, birth, death, -> (YEAR(death)-YEAR(birth)) - (RIGHT(death,5)<RIGHT(birth,5)) -> AS age -> FROM pet WHERE death IS NOT NULL ORDER BY age; +--------+------------+------------+------+ | name | birth | death | age |

184

MySQL Technical Reference for Version 5.0.0-alpha

+--------+------------+------------+------+ | Bowser | 1989-08-31 | 1995-07-29 | 5 | +--------+------------+------------+------+ A consulta usa death IS NOT NULL em vez de death != NULL porque NULL um valor ese pecial que no pode ser comparada usando operadores comuns de comparao. Isto ser a ca a explicado depois. Veja Seo 3.3.4.6 [Working with NULL], Pgina 185. ca a E se voc desejar saber quais animais fazem aniversrio no prximo ms? Para este tipo e a o e de clculo, ano e dia so irrelevantes; voc simplesmente deseja extrair a parte do ms da a a e e coluna birth. O MySQL fornece diversas funes para extrair partes da data, como em co YEAR(), MONTH() e DAYOFMONTH(). MONTH a funo apropriada aqui. Para ver como ela e ca funciona, execute uma consulta simples que mostre o valor de birth e MONTH(birth): mysql> SELECT name, birth, MONTH(birth) FROM pet; +----------+------------+--------------+ | name | birth | MONTH(birth) | +----------+------------+--------------+ | Fluffy | 1993-02-04 | 2 | | Claws | 1994-03-17 | 3 | | Buffy | 1989-05-13 | 5 | | Fang | 1990-08-27 | 8 | | Bowser | 1989-08-31 | 8 | | Chirpy | 1998-09-11 | 9 | | Whistler | 1997-12-09 | 12 | | Slim | 1996-04-29 | 4 | | Puffball | 1999-03-30 | 3 | +----------+------------+--------------+ Encontrar animais com an iversrio no prximo ms tambm fcil. Suponha que o ms a o e e e a e atual abril. Ento o valor do ms 4 e voc procura por animais nascidos em Maio (ms e a e e e e 5) assim: mysql> SELECT name, birth FROM pet WHERE MONTH(birth) = 5; +-------+------------+ | name | birth | +-------+------------+ | Buffy | 1989-05-13 | +-------+------------+ Existe uma pequena complicao se o ms atual Dezembro, claro. Voc no pode apenas ca e e e e a adicionar um para o nmero do ms (12) e procurar por animais nascidos no ms 13, porque u e e no existe tal ms. O certo seria procurar por animais nascidos em Janeiro (ms 1). a e e Voc pode tambm escrever uma consulta para que funcione sem importar qual o ms e e e e atual. Assim voc no tm quee usar um nmero de ms em particular na consulta. DATE_ e a e u e ADD() permite adicionar um intervalo de tempo para uma data fornecida. Se voc adicionar e um ms para o valor de CURDATE, ento extrair a parte do ms com MONTH(), o resultado e a e e o ms no qual voc deseja procurar por aniversrios: e e a mysql> SELECT name, birth FROM pet -> WHERE MONTH(birth) = MONTH(DATE_ADD(CURDATE(), INTERVAL 1 MONTH));

Cap tulo 3: Tutorial de Introduo Do MySQL ca

185

Uma maneira diferente para realizar a mesma tarefa adicionar 1 para obter o ms seguinte e e ao atual (depois de usar a funo mdulo (MOD) para o valor do ms retornar 0 se ele for ca o e 12): mysql> SELECT name, birth FROM pet -> WHERE MONTH(birth) = MOD(MONTH(CURDATE()), 12) + 1; Perceba que MONTH retorna um nmero entre 1 e 12. E MOD(alguma_coisa,12) retorna um u nmero entre 0 e 11. Ento a adio tem que ser feita depois do MOD(), seno ir u a ca a iamos de Novembro (11) para Janeiro (1).

3.3.4.6 Trabalhando com Valores Nulos (NULL)

O valor NULL pode ser supreendente at voc us-lo. Conceitualmente, NULL signica valor e e a em falta ou valor desconhecido e tratado de uma forma diferente de outros valores. Para e testar o valor NULL, voc no pode usar os operadores de comparaes aritmticas como em e a co e =, <, ou !=. Para demonstrar para voc mesmo, tente executar a seguinte consulta: e mysql> SELECT 1 = NULL, 1 != NULL, 1 < NULL, 1 > NULL; +----------+-----------+----------+----------+ | 1 = NULL | 1 != NULL | 1 < NULL | 1 > NULL | +----------+-----------+----------+----------+ | NULL | NULL | NULL | NULL | +----------+-----------+----------+----------+ Claramente voc no obter resultados signicativos destas comparaes. Utilize os opere a a co adores IS NULL e IS NOT NULL no lugar: mysql> SELECT 1 IS NULL, 1 IS NOT NULL; +-----------+---------------+ | 1 IS NULL | 1 IS NOT NULL | +-----------+---------------+ | 0 | 1 | +-----------+---------------+ No MySQL, 0 ou NULL signica falso e o resto verdadeiro. O valor verdadeiro por o padro e a em uma operao booleana 1. ca e Este tratamento especial de NULL porque, na seo anterior, foi necessrio determinar e ca a quais animais no estavam mais vivos usando death IS NOT NULL no lugar de death <> a NULL. Dois valores NULL so considerados como iguais em um GROUP BY. a Ao fazer um ORDER BY, valores NULL so apresentados primeiro se voc zer ORDER BY ... a e ASC e por ultimo se voc zer ORDER BY ... DESC. e Note que o MySQL 4.0.2 a 4.0.10 sempre ordenam, incorretamente, valores NULL em primeiro independente da ordem escolhida.

3.3.4.7 Combinao de padres ca o

O MySQL fornece combinao de padres do SQL bem como na forma de combinao ca o ca de padres baseado nas expresses regulares extendidas similares `quelas usadas pelos o o a utilitrios Unix como o vi, grep e sed. a

186

MySQL Technical Reference for Version 5.0.0-alpha

A combinao de padres SQL lhe permite voc usar _ para coincidir qualquer caractere ca o e simples e % para coincidir um nmero arbitrrio de caracteres (incluindo zero caracter). u a No MySQL, padres SQL so caso insensitivo por padro. Alguns exemplos so vistos o a a a abaixo. Perceba que voc no usa = ou != quando usar padres SQL; use os operadores de e a o comparao LIKE ou NOT LIKE neste caso. ca Para encontrar nomes comeando com b: c mysql> SELECT * FROM pet WHERE name LIKE "b%"; +--------+--------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +--------+--------+---------+------+------------+------------+ | Buffy | Harold | dog | f | 1989-05-13 | NULL | | Bowser | Diane | dog | m | 1989-08-31 | 1995-07-29 | +--------+--------+---------+------+------------+------------+ Para encontrar nomes com o nal fy: mysql> SELECT * FROM pet WHERE name LIKE "%fy"; +--------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +--------+--------+---------+------+------------+-------+ | Fluffy | Harold | cat | f | 1993-02-04 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +--------+--------+---------+------+------------+-------+ Para encontrar nomes contendo um w: mysql> SELECT * FROM pet WHERE name LIKE "%w%"; +----------+-------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +----------+-------+---------+------+------------+------------+ | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Bowser | Diane | dog | m | 1989-08-31 | 1995-07-29 | | Whistler | Gwen | bird | NULL | 1997-12-09 | NULL | +----------+-------+---------+------+------------+------------+ Para encontrar nomes contendo exatamente cinco caracteres, use cinco instncias do caraca ter _: mysql> SELECT * FROM pet WHERE name LIKE "_____"; +-------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +-------+--------+---------+------+------------+-------+ | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +-------+--------+---------+------+------------+-------+ O outro tipo de combinao de padres fornecido pelo MySQL usa expresses regulares ca o o extendidas. Quando voc testa por uma combinao para este tipo de padro, utilize os e ca a operadores REGEXP e NOT REGEXP (ou RLIKE e NOT RLIKE, que so sinnimos). a o Algumas caracter isticas das expresses regulares extendidas so: o a . combina qualquer caractere unico

Cap tulo 3: Tutorial de Introduo Do MySQL ca

187

Uma classe de caracteres [...] combina qualquer caractere que consta dentro dos colchetes. Por exemplo, [abc] combina com a, b, ou c. Para nomear uma sequncia de caracteres utilize um trao. [a-z] combina com qualquer letra e [0-9] e c combina com qualquer d igito. * combina com nenhuma ou mais instncias de sua precedncia. Por exemplo, x* a e combina com qualquer nmero de caracteres x, [0-9]* combina com qualquer u nmero de d u igitos e .* combina com qualquer nmero de qualquer coisa. u Um padro REGEXP casa com sucesso se ele ocorre em algum lugar no valor sendo a testado. (Ele difere do padro LIKE, que s obtem suceeso se eles combinarem com a o todo o valor.) Para fazer com que um padro deva combinar com o comeo ou o m de um valor a c sendo testado, utilize ^ no comeo ou $ no nal do padro. c a Para demonstrar como expresses regulares extendidas funcionam, as consultas com LIKE o mostradas acima foram reescritas abaixo usando REGEXP. Para encontrar nomes comeando com b, utilize ^ para combinar com o comeo do nome: c c mysql> SELECT * FROM pet WHERE name REGEXP "^b"; +--------+--------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +--------+--------+---------+------+------------+------------+ | Buffy | Harold | dog | f | 1989-05-13 | NULL | | Bowser | Diane | dog | m | 1989-08-31 | 1995-07-29 | +--------+--------+---------+------+------------+------------+ Antes da verso 3.23.4 do MySQL, REGEXP era caso sensitivo, e a consulta anterior no iria a a retornar nenhum registro. Neste caso, para combinar letras b maisculas e minsculas, u u utilize esta consulta: mysql> SELECT * FROM pet WHERE name REGEXP "^[bB]"; A partir do MySQL 3.23.4, se voc realmente deseja forar uma comparao REGEXP com e c ca caso sensitivo, utilize a palavra-chave BINARY para tornar uma das strings em uma string binrias. Esta consulta ir combinar somente com bs minsculos no comeo de um nome: a a u c mysql> SELECT * FROM pet WHERE name REGEXP BINARY "^b"; Para encontrar nomes nalizados com fy, utilize $ para combinar com o nal do nome: mysql> SELECT * FROM pet WHERE name REGEXP "fy$"; +--------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +--------+--------+---------+------+------------+-------+ | Fluffy | Harold | cat | f | 1993-02-04 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +--------+--------+---------+------+------------+-------+ Para encontrar nomes contendo um w, utilize esta consulta: mysql> SELECT * FROM pet WHERE name REGEXP "w"; +----------+-------+---------+------+------------+------------+ | name | owner | species | sex | birth | death | +----------+-------+---------+------+------------+------------+

188

MySQL Technical Reference for Version 5.0.0-alpha

| Claws | Gwen | cat | m | 1994-03-17 | NULL | | Bowser | Diane | dog | m | 1989-08-31 | 1995-07-29 | | Whistler | Gwen | bird | NULL | 1997-12-09 | NULL | +----------+-------+---------+------+------------+------------+ Como uma expresso regular extendida encontra padres coincidentes se eles ocorrem em a o qualquer lugar no valor comparado, no necessrio utiliar, na consulta anterior, nenhum a e a metacaracter em nenhum dos lados do padro para faz-lo coincidir com todo o valor, como a e seria feito se fosse utilizado o padro SQL. a Para encontrar nomes contendo exatamente cinco caracteres, utilize ^ e $ para combinar com o comeo e m do nome e cinco instncias de . entre eles. c a mysql> SELECT * FROM pet WHERE name REGEXP "^.....$"; +-------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +-------+--------+---------+------+------------+-------+ | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +-------+--------+---------+------+------------+-------+ Voc pode tambm escrever a consulta anterior utilizando o operador {n} repete-n-vezes: e e mysql> SELECT * FROM pet WHERE name REGEXP "^.{5}$"; +-------+--------+---------+------+------------+-------+ | name | owner | species | sex | birth | death | +-------+--------+---------+------+------------+-------+ | Claws | Gwen | cat | m | 1994-03-17 | NULL | | Buffy | Harold | dog | f | 1989-05-13 | NULL | +-------+--------+---------+------+------------+-------+

3.3.4.8 Contando Registros

Bancos de dados normalmente so usados para responder a perguntas, Qual a frequncia a e que certo tipo de dados ocorre em uma tabela? Por exemplo, voc deve querer saber e quantos animais tem, ou quantos animais cada dono tem, ou voc pode querer fazer vrios e a outros tipos de operaes de censo com seus animais. co Contando o nmero total de animais que voc tem a mesma questo como em Quantos u e e a registros existem na tabela pet? porque existe um registro por animal. COUNT(*) conta o nmero de resultados no-NULL, portanto a pesquisa para contar seus animais parecer u a a com isto: mysql> SELECT COUNT(*) FROM pet; +----------+ | COUNT(*) | +----------+ | 9 | +----------+ Logo, voc recuperar os nomes das pessoas que possuam animais. Voc pode usar COUNT() e a e se voc desejar encontrar quantos animais cada dono possui: e

Cap tulo 3: Tutorial de Introduo Do MySQL ca

189

mysql> SELECT owner, COUNT(*) FROM pet GROUP BY owner; +--------+----------+ | owner | COUNT(*) | +--------+----------+ | Benny | 2 | | Diane | 2 | | Gwen | 3 | | Harold | 2 | +--------+----------+ Perceba o uso de GROUP BY para agrupar todos os registros para cada owner (dono). Sem ele, voc teria uma mensagem de erro: e mysql> SELECT owner, COUNT(*) FROM pet; ERROR 1140: Mixing of GROUP columns (MIN(),MAX(),COUNT()...) with no GROUP columns is illegal if there is no GROUP BY clause COUNT() e GROUP BY so uteis para personalizar seus dados de diversas maneiras. Os a seguintes exemplos mostram diferentes maneiras para realizar operaes de censo nos anico mais. Nmero de animais por espcie: u e mysql> SELECT species, COUNT(*) FROM pet GROUP BY species; +---------+----------+ | species | COUNT(*) | +---------+----------+ | bird | 2 | | cat | 2 | | dog | 3 | | hamster | 1 | | snake | 1 | +---------+----------+ Nmero de animais por sexo: u mysql> SELECT sex, COUNT(*) FROM pet GROUP BY sex; +------+----------+ | sex | COUNT(*) | +------+----------+ | NULL | 1 | | f | 4 | | m | 4 | +------+----------+ (Nesta sa ida, NULL indica que o sexo desconhecido.) e Nmero de animais combinando espcie e sexo: u e mysql> SELECT species, sex, COUNT(*) FROM pet GROUP BY species, sex; +---------+------+----------+ | species | sex | COUNT(*) | +---------+------+----------+ | bird | NULL | 1 | | bird | f | 1 |

190

MySQL Technical Reference for Version 5.0.0-alpha

| cat | f | 1 | | cat | m | 1 | | dog | f | 1 | | dog | m | 2 | | hamster | f | 1 | | snake | m | 1 | +---------+------+----------+ No necessrio selecionar uma tabela inteira quando estiver usando COUNT(). Por exemplo, a e a a consulta anterior, quando realizada apenas procurando por cachorros e gatos, se parece com isto: mysql> SELECT species, sex, COUNT(*) FROM pet -> WHERE species = "dog" OR species = "cat" -> GROUP BY species, sex; +---------+------+----------+ | species | sex | COUNT(*) | +---------+------+----------+ | cat | f | 1 | | cat | m | 1 | | dog | f | 1 | | dog | m | 2 | +---------+------+----------+ Ou se voc desejar saber o nmero de animais por sexo somente de animais com sexo e u conhecido: mysql> SELECT species, sex, COUNT(*) FROM pet -> WHERE sex IS NOT NULL -> GROUP BY species, sex; +---------+------+----------+ | species | sex | COUNT(*) | +---------+------+----------+ | bird | f | 1 | | cat | f | 1 | | cat | m | 1 | | dog | f | 1 | | dog | m | 2 | | hamster | f | 1 | | snake | m | 1 | +---------+------+----------+

3.3.4.9 Utilizando M ltiplas Tabelas u

A tabela pet mantm informaes de quais animais voc tem. Se voc deseja gravar outras e co e e informaes sobre eles como eventos em suas vidas, tais como visitas ao veterinrio ou sobre co a suas crias, voc necessitar de outra tabela. Como esta tabela deve se parecer ? Ela precisa: e a Conter o nome do animal para que voc saiba a qual animal pertence o evento. e Uma data para que voc saiba quando ocorreu o evento. e

Cap tulo 3: Tutorial de Introduo Do MySQL ca

191

Um campo para descrever o evento. Um campo com o tipo de evento, se voc desejar classic-los por categoria. e a Dadas estas consideraes, a instruo CREATE TABLE para a tabela event deve se parecer co ca com isto: mysql> CREATE TABLE event (name VARCHAR(20), date DATE, -> type VARCHAR(15), remark VARCHAR(255)); Como na tabela pet, mais fcil carregar os registros iniciais criando um arquivo texto e a delimitado por tabulaes contendo a informao: co ca name Fluy Buy Buy Chirpy Slim Bowser Fang Fang Claws Whistler date 1995-05-15 1993-06-23 1994-06-19 1999-03-21 1997-08-03 1991-10-12 1991-10-12 1998-08-28 1998-03-17 1998-12-09 type litter litter litter vet vet kennel kennel birthday birthday birthday remark 4 kittens, 3 female, 1 male 5 puppies, 2 female, 3 male 3 puppies, 3 female needed beak straightened broken rib

Gave him a new chew toy Gave him a new ea collar First birthday

Carregue os registros usando: mysql> LOAD DATA LOCAL INFILE "event.txt" INTO TABLE event; Baseado no que voc j aprendeu com as consultas realizadas na tabela pet, voc deve estar e a e apto para realizar pesquisas na tabela event; os princ ipios so o mesmo. Mas quando a a tabela event, sozinha, insuciente para responder `s suas questes? e a o Suppose you want to nd out the ages at which each pet had its litters. We saw earlier how to calculate ages from two dates. The litter date of the mother is in the event table, but to calculate her age on that date you need her birth date, which is stored in the pet table. This means the query requires both tables: Suponha que voc deseje descobrir as idades de cada animal quando eles tiveram cria. Ns e o vemos logo que poss calcular a idade a partir das duas datas. A idade dos lhotes est e ivel a na tabela event, mas para calcular a idade da me, voc precisar da data de nascimento a e a dela, que est armazenado na tabela pet. Isto signica que voc precisar das duas tabelas a e a para a consulta: mysql> SELECT pet.name, -> (YEAR(date)-YEAR(birth)) - (RIGHT(date,5)<RIGHT(birth,5)) AS age, -> remark -> FROM pet, event -> WHERE pet.name = event.name AND type = "litter"; +--------+------+-----------------------------+ | name | age | remark | +--------+------+-----------------------------+ | Fluffy | 2 | 4 kittens, 3 female, 1 male | | Buffy | 4 | 5 puppies, 2 female, 3 male | | Buffy | 5 | 3 puppies, 3 female |

192

MySQL Technical Reference for Version 5.0.0-alpha

+--------+------+-----------------------------+ Existem vrias coisas que devem ser percebidas sobre esta consulta: a A clusula FROM lista as duas tabelas porque a consulta precisa extrair informao de a ca ambas. Quando combinar (unir) informaes de mltiplas tabelas, voc precisa especicar como co u e registros em uma tabela podem ser coincididas com os registros na outra. Isto simples e porque ambas possuem uma coluna name. A consulta utiliza a clusula WHERE para a coincidir registros nas duas tabelas baseadas nos valores de name. Como a coluna name ocorre em ambas tabelas, voc deve especicar qual a tabela a que e voc est se referindo. Isto feito usando o nome da tabela antes do nome da coluna e a e separados por um ponto (.). Voc no precisa ter duas tabelas diferentes para realizar uma unio. Algumas vezes util e a a e unir uma tabela a ela mesma, se voc deseja comparar registros em uma tabela com outros e registros na mesma tabela. Por exemplo, para encontrar pares entre seus animais, voc e pode unir a tabela pet com ela mesma para produzir pares candidatos de machos e fmeas e de acordo com as espcies: e mysql> SELECT p1.name, p1.sex, p2.name, p2.sex, p1.species -> FROM pet AS p1, pet AS p2 -> WHERE p1.species = p2.species AND p1.sex = "f" AND p2.sex = "m"; +--------+------+--------+------+---------+ | name | sex | name | sex | species | +--------+------+--------+------+---------+ | Fluffy | f | Claws | m | cat | | Buffy | f | Fang | m | dog | | Buffy | f | Bowser | m | dog | +--------+------+--------+------+---------+ Nesta consulta, ns especicamos apelidos para os nomes das tabelas para conseguir refo erenciar `s colunas e manter com qual instncia da tabela cada coluna de referncia est a a e a associdada.

3.4 Obtendo Informaoes Sobre Bancos de Dados e Tabelas c

E se voc esquecer o nome de um banco de dados ou tabela, ou como a estrutura de e e uma certa tabela (por exemplo, como suas colunas so chamadas)? O MySQL resolve este a problema atravs de diversas instrues que fornecem informaes sobre os bancos de dados e co co e as tabelas que ele suporta. Voc j viu SHOW DATABASES, que lista os bancos de dados gerenciados pelo servidor. Para e a saber qual banco de dados est sendo usado atualmente, utilize a funo DATABASE(): a ca mysql> SELECT DATABASE(); +------------+ | DATABASE() | +------------+ | menagerie | +------------+

Cap tulo 3: Tutorial de Introduo Do MySQL ca

193

Se voc ainda no selecionou nenhum banco de dados ainda, o resultado NULL. (ou a e a e string vazia antes do MySQL 4.1.1). Para saber quais tabelas o banco de dados atual contm (por exemplo, quando voc no e e a tem certeza sobre o nome de uma tabela), utilize este comando: mysql> SHOW TABLES; +---------------------+ | Tables in menagerie | +---------------------+ | event | | pet | +---------------------+ Se voc deseja saber sobre a estrutura de uma tabela, o comando DESCRIBE util; ele mostra e e informaes sobre cada uma das colunas da tabela: co mysql> DESCRIBE pet; +---------+-------------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +---------+-------------+------+-----+---------+-------+ | name | varchar(20) | YES | | NULL | | | owner | varchar(20) | YES | | NULL | | | species | varchar(20) | YES | | NULL | | | sex | char(1) | YES | | NULL | | | birth | date | YES | | NULL | | | death | date | YES | | NULL | | +---------+-------------+------+-----+---------+-------+ A coluna Field (campo) indica o nome da coluna, Type o tipo de dados para a coluna, e Null indica se a coluna pode conter valores nulos (NULL), key indica se a coluna indexada e ou no e Default especica o valor padro da coluna. a a Se voc tem indices em uma tabela, SHOW INDEX FROM tbl_nome traz informaes sobre eles. e co

3.5 Utilizando mysql em Modo Batch

Nas sees anteriores, voc usou mysql interativamente para fazer consultas e ver os reco e sultados. Voc pode tambm executar mysql no modo batch. Para fazer isto, coloque os e e comando que voc deseja executar em um arquivo, e diga ao mysqld para ler sua entrada e do arquivo: shell> mysql < batch-file Se voc estiver executando o mysql no Windows e tiver algum caracter especial no arquivo e que provocou o problema, voc pode fazer: e dos> mysql -e "source batch-file" Se voc precisa especicar parmetros de conexo na linha de comando, o comando deve e a a parecer com isto: shell> mysql -h host -u user -p < batch-file Enter password: ********

194

MySQL Technical Reference for Version 5.0.0-alpha

Quando voc utilizar o mysql desta forma, voc estar criando um arquivo script, depois e e a executando o script. Se voc quiser que o script continue mesmo se hopuver erros, voc deve usar a opo de e e ca linha de comando --force. Por que usar um script? Existem vrias razes: a o Se voc executa uma query repetidamente (digamos, todos os dias ou todas as semanas), e transform-lo em um script permite que voc no o redigite toda vez que o executa. a e a Voc pode gerar novas consultas a partir das j existentes copiando e editando os e a arquivos de script. O modo batch pode tambm ser util quando voc estiver desenvolvendo uma consulta, e e particularmente para comandos de mltiplas linhas ou sequncias de comandos com u e vrias instrues. Se voc cometer um erro, no ser necessrio redigitar tudo. Apenas a co e a a a edite seu arquivo script e corrija o erro, depois diga ao mysql para execut-lo novamente. a Se voc tem uma query que produz muita saida, voc pode encaminhar a sa atravs e e ida e de um pginador. a shell> mysql < batch-file | more Voc pode capturar a sa em um arquivo para processamento posterior: e ida shell> mysql < batch-file > mysql.out Voc pode distribuir seu script para outras pessoas para que elas possam executar os e comandos tambm. e Algumas situaes no permitem uso interativo, por exemplo, quando voc executa co a e uma consulta atravs de um processo automtico (cron job). Neste caso, voc deve e a e usar o modo batch. A formato padro de sa diferente (mais conciso) quando voc executa o mysql no modo a ida e e batch do que quando voc o usa interativamente. Por exemplo, a sa de SELECT DISTINCT e ida species FROM pet se parece com isto quando voc o executa interativamente: e +---------+ | species | +---------+ | bird | | cat | | dog | | hamster | | snake | +---------+ Mas ca assim quando voc o executa no modo batch: e species bird cat dog hamster snake Se voc desejar obter o formato de sa interativa no modo batch, utilize mysql -t. Para e ida dos comandos que so executados, utilize mysql -vvv. mostrar a saida a

Cap tulo 3: Tutorial de Introduo Do MySQL ca

195

Voc tambm pode utilizar scripts no prompt de linha de comando mysql usando o comando e e source: mysql> source filename;

3.6 Exemplos de Consultas Comuns

Aqui esto os exemplos de como resolver problemas comuns com o MySQL. a Alguns dos exemplos usam a tabela shop para armazenar o preo de cada c item (article) para certas revendas (dealers). Supondo que cada revenda tenha um preo xo por artigo, c ento (article, dealer) uma chave primria para os registros. a e a Inicie a ferramenta de linha de comando mysql e selecione um banco de dados: shell> mysql o-nome-do-seu-banco-de-dados (Na maioria das instalaes do MySQL, voc pode usar o banco de dados test). co e Voc pode criar e popular a tabela exemplo assim: e mysql> CREATE TABLE shop ( -> article INT(4) UNSIGNED ZEROFILL DEFAULT 0000 NOT NULL, -> dealer CHAR(20) DEFAULT NOT NULL, -> price DOUBLE(16,2) DEFAULT 0.00 NOT NULL, -> PRIMARY KEY(article, dealer)); mysql> INSERT INTO shop VALUES -> (1,A,3.45),(1,B,3.99),(2,A,10.99),(3,B,1.45),(3,C,1.69), -> (3,D,1.25),(4,D,19.95); Depois de executar as instrues a tabela deve ter o seguinte contedo: co u mysql> SELECT * FROM shop; +---------+--------+-------+ | article | dealer | price | +---------+--------+-------+ | 0001 | A | 3.45 | | 0001 | B | 3.99 | | 0002 | A | 10.99 | | 0003 | B | 1.45 | | 0003 | C | 1.69 | | 0003 | D | 1.25 | | 0004 | D | 19.95 | +---------+--------+-------+

3.6.1 O Valor Mximo para uma Coluna a

Qual o maior nmero dos e u itens? SELECT MAX(article) AS article FROM shop; +---------+ | article |

196

MySQL Technical Reference for Version 5.0.0-alpha

+---------+ | 4 | +---------+

3.6.2 O Registro que Armazena o Valor Mximo para uma Coluna a Determinada
Encontre o nmero, fornecedor e preo do u c item mais caro. No SQL ANSI isto feito fcilmente com uma sub-consulta: e a SELECT article, dealer, price FROM shop WHERE price=(SELECT MAX(price) FROM shop); No MySQL (que ainda no suporta sub-selects), faa isto em dois passos: a c 1. Obtenha o valor do preo mximo da tabela com uma instruo SELECT. c a ca mysql> SELECT MAX(price) FROM shop; +------------+ | MAX(price) | +------------+ | 19.95 | +------------+ 2. Usando o valor 19.95 mostrado pela consulta anterior como o preo mximo do artigo, c a grave uma consulta para localizar e mostrar o registro correspondente: mysql> SELECT article, dealer, price -> FROM shop -> WHERE price=19.95; +---------+--------+-------+ | article | dealer | price | +---------+--------+-------+ | 0004 | D | 19.95 | +---------+--------+-------+ Outra soluo ordenar todos os registros por preo de forma descendente e obtenha soca e c mente o primeiro registro utilizando a clusula espec a ica do MySQL LIMIT: SELECT article, dealer, price FROM shop ORDER BY price DESC LIMIT 1; NOTA: Se existir diversos itens mais caros, cada um com um preo de 19.95, a soluo c ca LIMIT mostra somente um deles !

3.6.3 Mximo da Coluna por Grupo a

Qual o maior preo por e c item?

Cap tulo 3: Tutorial de Introduo Do MySQL ca

197

SELECT article, MAX(price) AS price FROM shop GROUP BY article +---------+-------+ | article | price | +---------+-------+ | 0001 | 3.99 | | 0002 | 10.99 | | 0003 | 1.69 | | 0004 | 19.95 | +---------+-------+

3.6.4 As Linhas Armazenando o Group-wise Mximo de um Certo a Campo

Para cada item, encontre o(s) fornecedor(s) com o maior preo. c No SQL-99 (e MySQL 4.1 ou superior), o problema pode ser solucionado com uma subconsulta como esta: SELECT article, dealer, price FROM shop s1 WHERE price=(SELECT MAX(s2.price) FROM shop s2 WHERE s1.article = s2.article); Em verses anteriores a do MySQL 4.1 melhor faz-lo em diversos passos: o e e 1. Obtenha a lista de pares (article,maxprice). 2. Para cada item, obtenha os registros correspondentes que tenham o maior preo. c Isto pode ser feito facilmente com uma tabela temporria e um join: a CREATE TEMPORARY TABLE tmp ( article INT(4) UNSIGNED ZEROFILL DEFAULT 0000 NOT NULL, price DOUBLE(16,2) DEFAULT 0.00 NOT NULL); LOCK TABLES shop READ; INSERT INTO tmp SELECT article, MAX(price) FROM shop GROUP BY article; SELECT shop.article, dealer, shop.price FROM shop, tmp WHERE shop.article=tmp.article AND shop.price=tmp.price; UNLOCK TABLES; DROP TABLE tmp; Se voc no usar uma tabela TEMPORRIA, voc deve bloquear tambm a tabela tmp. e a A e e Posso fazer isto com uma unica query? Sim, mas somente com um truque ineciente chamado truque MAX-CONCAT:

198

MySQL Technical Reference for Version 5.0.0-alpha

SELECT article, SUBSTRING( MAX( CONCAT(LPAD(price,6,0),dealer) ), 7) AS dealer, 0.00+LEFT( MAX( CONCAT(LPAD(price,6,0),dealer) ), 6) AS price FROM shop GROUP BY article; +---------+--------+-------+ | article | dealer | price | +---------+--------+-------+ | 0001 | B | 3.99 | | 0002 | A | 10.99 | | 0003 | C | 1.69 | | 0004 | D | 19.95 | +---------+--------+-------+ O ultimo exemplo pode, claro, ser feito de uma maneira mais eciente fazendo a separao e ca da coluna concatenada no cliente.

3.6.5 Utilizando Variveis de Usurio a a

Voc pode usar variveis de usurios no MySQL para lembrar de resultados sem a necessie a a dade de armazen-las em variveis no cliente. Veja Seo 6.1.4 [Variables], Pgina 474. a a ca a Por exemplo, para encontrar os itens com os preos mais altos e mais baixos voc pode fazer c e isto: select @min_price:=min(price),@max_price:=max(price) from shop; select * from shop where price=@min_price or price=@max_price; +---------+--------+-------+ | article | dealer | price | +---------+--------+-------+ | 0003 | D | 1.25 | | 0004 | D | 19.95 | +---------+--------+-------+

3.6.6 Utilizando Chaves Estrangeiras

No MySQL 3.23.44 e acima, tabelas InnoDB suportam vericao de restries de chaves ca co estrangerias. Veja Seo 7.5 [InnoDB], Pgina 643. Veja tambm Seo 1.8.4.5 [ANSI di ca a e ca Foreign Keys], Pgina 50. a Voc no precisa de chaves estrangeiras para unir 2 tabelas. Para outros tipos de tabela e a diferentes de InnoDB, As unicas coisas que o MySQL atualmente no faz so 1) CHECK, para a a ter certeza que as chaves que voc usa realmente existem na tabela ou tabelas referenciadas e e 2) apagar automaticamente registros da tabela com uma denio de chave estrangeira. ca Usando suas chaves para unir a tabela funcionar bem: a CREATE TABLE person ( id SMALLINT UNSIGNED NOT NULL AUTO_INCREMENT,

Cap tulo 3: Tutorial de Introduo Do MySQL ca

199

name CHAR(60) NOT NULL, PRIMARY KEY (id) ); CREATE TABLE shirt ( id SMALLINT UNSIGNED NOT NULL AUTO_INCREMENT, style ENUM(t-shirt, polo, dress) NOT NULL, colour ENUM(red, blue, orange, white, black) NOT NULL, owner SMALLINT UNSIGNED NOT NULL REFERENCES person(id), PRIMARY KEY (id) );

INSERT INTO person VALUES (NULL, Antonio Paz); INSERT (NULL, (NULL, (NULL, INTO shirt VALUES polo, blue, LAST_INSERT_ID()), dress, white, LAST_INSERT_ID()), t-shirt, blue, LAST_INSERT_ID());

INSERT INTO person VALUES (NULL, Lilliana Angelovska); INSERT (NULL, (NULL, (NULL, (NULL, INTO shirt VALUES dress, orange, LAST_INSERT_ID()), polo, red, LAST_INSERT_ID()), dress, blue, LAST_INSERT_ID()), t-shirt, white, LAST_INSERT_ID());

SELECT * FROM person; +----+---------------------+ | id | name | +----+---------------------+ | 1 | Antonio Paz | | 2 | Lilliana Angelovska | +----+---------------------+ SELECT * FROM shirt; +----+---------+--------+-------+ | id | style | colour | owner | +----+---------+--------+-------+ | 1 | polo | blue | 1 | | 2 | dress | white | 1 | | 3 | t-shirt | blue | 1 | | 4 | dress | orange | 2 | | 5 | polo | red | 2 |

200

MySQL Technical Reference for Version 5.0.0-alpha

| 6 | dress | blue | 2 | | 7 | t-shirt | white | 2 | +----+---------+--------+-------+

SELECT WHERE AND AND

s.* FROM person p, shirt s p.name LIKE Lilliana% s.owner = p.id s.colour <> white;

+----+-------+--------+-------+ | id | style | colour | owner | +----+-------+--------+-------+ | 4 | dress | orange | 2 | | 5 | polo | red | 2 | | 6 | dress | blue | 2 | +----+-------+--------+-------+

3.6.7 Pesquisando em Duas Chaves

O MySQL ainda no otimiza quando voc pesquisa em duas chaves diferentes combinadas a e com OR (Pesquisa em uma chave com diferentes partes OR muito bem otimizadas). e SELECT field1_index, field2_index FROM test_table WHERE field1_index = 1 OR field2_index = 1 A razo que ns ainda no tivemos tempos para fazer este tratamento de uma maneira a e o a eciente no caso geral. (A manipulao do AND , em comparao, completamente geral e ca e ca funciona muito bem). No MySQL 4.0 e acimo, voc pode solucionar este problema ecientemente usando um UNION e que combina a sa de duas instrues SELECT separadas. Veja Seo 6.4.1.2 [UNION], ida co ca Pgina 569. Cada SELECT busca apenas uma chave e pode ser otimizada. a SELECT field1_index, field2_index FROM test_table WHERE field1_index = 1 UNION SELECT field1_index, field2_index FROM test_table WHERE field2_index = 1; Em verses do MySQL anteirores a 4.0, voc pode conseguir o mesmo efeito usando uma o e tabela TEMPORARY e instrues SELECT separadas. Este tipo de otimizao tambm muito co ca e e boa se voc estiver utilizando consultas muito complicadas no qual o servidor SQL faz as e otimizaes na ordem errada. co CREATE TEMPORARY TABLE tmp SELECT field1_index, field2_index FROM test_table WHERE field1_index = 1; INSERT INTO tmp SELECT field1_index, field2_index FROM test_table WHERE field2_index = 1; SELECT * from tmp; DROP TABLE tmp; A maneira descrita acima para resolver esta consulta uma unio (UNION) de duas consultas. e a

Cap tulo 3: Tutorial de Introduo Do MySQL ca

201

3.6.8 Calculando Visitas Dirias a

O seguinte exemplo mostra como voc pode usar as funes binrias de agrupamento para e co a calcular o nmero de dias por ms que um usurio tem visitado uma pgina web. u e a a CREATE TABLE t1 (year YEAR(4), month INT(2) UNSIGNED ZEROFILL, day INT(2) UNSIGNED Z INSERT INTO t1 VALUES(2000,1,1),(2000,1,20),(2000,1,30),(2000,2,2),(2000,2,23),(2000 A tabela exemplo contm valores ano-ms-dia representando visitas feitas pelos usurios a e e a pgina. Para determinar quantos quantos dias diferentes em cada ms estas visitas ocorriam, a e use esta consulta: SELECT year,month,BIT_COUNT(BIT_OR(1<<day)) AS days FROM t1 GROUP BY year,month; que retornar: a +------+-------+------+ | year | month | days | +------+-------+------+ | 2000 | 01 | 3 | | 2000 | 02 | 2 | +------+-------+------+ O exemplo acima calcula quantos dias diferentes foram usados para uma combinao ca fornecida de ms/ano, com remoo automtica de entradas duplicadas. e ca a

3.6.9 Usando AUTO_INCREMENT

O atributo AUTO_INCREMENT pode ser usado para gerar uma identicao unica para um ca novo registro: CREATE TABLE animals ( id MEDIUMINT NOT NULL AUTO_INCREMENT, name CHAR(30) NOT NULL, PRIMARY KEY (id) ); INSERT INTO animals (name) VALUES ("dog"),("cat"),("penguin"), ("lax"),("whale"),("ostrich"); SELECT * FROM animals; Que retorna: +----+---------+ | id | name | +----+---------+ | 1 | dog | | 2 | cat | | 3 | penguin | | 4 | lax | | 5 | whale | | 6 | ostrich | +----+---------+ Voc pode recuperar o valor AUTO_INCREMENT mais recente com a funo SQL LAST_INSERT_ e ca ID() ou a funo da API C mysql_insert_id(). Nota: para uma insero de vrias ca ca a

202

MySQL Technical Reference for Version 5.0.0-alpha

linhas LAST_INSERT_ID()/mysql_insert_id() retornar atualmente a AUTO_INCREMENT a chave da primeira linha inserida. Isto permite que inseres multi-linhas sejam reproduzidas co corretamente em outros servidores em uma congrao de replicao. ca ca Para tabelas MyISAM e BDB voc pode especicar AUTO_INCREMENT em uma coluna secundria e a em um indice multi-coluna. Neste caso, o valor gerado para a coluna AUTO_INCREMENT e calculado como MAX(auto_increment_column)+1) WHERE prefix=given-prefix. Isto e util quando voc quer colocar dados em grupos ordenados. e CREATE TABLE animals ( grp ENUM(fish,mammal,bird) NOT NULL, id MEDIUMINT NOT NULL AUTO_INCREMENT, name CHAR(30) NOT NULL, PRIMARY KEY (grp,id) ); INSERT INTO animals (grp,name) VALUES("mammal","dog"),("mammal","cat"), ("bird","penguin"),("fish","lax"),("mammal","whale"), ("bird","ostrich"); SELECT * FROM animals ORDER BY grp,id; Que retorna: +--------+----+---------+ | grp | id | name | +--------+----+---------+ | fish | 1 | lax | | mammal | 1 | dog | | mammal | 2 | cat | | mammal | 3 | whale | | bird | 1 | penguin | | bird | 2 | ostrich | +--------+----+---------+ Note que neste caso (quando o valor AUTO_INCREMENT parte de um e indice multi-coluna), o valor de AUTO_INCREMENT ser reutilizado se voc deletar a linha com o maior valor AUTO_ a e INCREMENT em qualquer grupo. Isto caontece mesmo para tabelas MyISAM, para as quais os valores AUTO_INCREMENT normalmente no so reusados.) a a

3.7 Consultas de Projetos Gmeos e

Em Analytikerna e Lentus, ns estamos fazendo os sistemas e trabalho de campo para um o grande projeto de pesquisa. Este projeto uma colaborao entre o Institudo de Medicina e ca Ambiental em Karolinksa Institutet Stockholm e a Seo de Pesquisa Cl ca inica em Envelhecimento e Psicologia na University of Southern California. O projeto envolve uma parte de seleo onde todos os gmeos na Sucia mais velhos que 65 ca e e anos so entrevistados por telefone. Gmeos que preenchem certos critrios passam para a e e o prximo estgio. Neste estgio posterior, gmeos que desejam participar so visitados o a a e a por uma equipe de doutores/enfermeiros. Alguns dos consultas incluem exames f isicos e neuropsicolgico, testes de laboratrio, imagem neural, determinao do estado psicolgico o o ca o

Cap tulo 3: Tutorial de Introduo Do MySQL ca

203

e coletas de histrico familiar. Adicionalmente, dados so coletados em fatores de riscos o a mdicos e ambientais. e Mais informaes sobre o estudos dos gmeos pode ser encontrados em: co e http://www.mep.ki.se/twinreg/index_en.html A parte posterior do projeto administrada com uma interface Web escrita utilizando a e linguagem Perl e o MySQL. Cada noite todos dados das entrevistas so movidos para um banco de dados MySQL. a

3.7.1 Encontrando Todos Gmeos No-distribu e a idos

A seguinte consulta usada para determinar quem vai na segunda parte do projeto: e SELECT CONCAT(p1.id, p1.tvab) + 0 AS tvid, CONCAT(p1.christian_name, " ", p1.surname) AS Name, p1.postal_code AS Code, p1.city AS City, pg.abrev AS Area, IF(td.participation = "Aborted", "A", " ") AS A, p1.dead AS dead1, l.event AS event1, td.suspect AS tsuspect1, id.suspect AS isuspect1, td.severe AS tsevere1, id.severe AS isevere1, p2.dead AS dead2, l2.event AS event2, h2.nurse AS nurse2, h2.doctor AS doctor2, td2.suspect AS tsuspect2, id2.suspect AS isuspect2, td2.severe AS tsevere2, id2.severe AS isevere2, l.finish_date FROM twin_project AS tp /* For Twin 1 */ LEFT JOIN twin_data AS td ON tp.id = td.id AND tp.tvab = td.tvab LEFT JOIN informant_data AS id ON tp.id = id.id AND tp.tvab = id.tvab LEFT JOIN harmony AS h ON tp.id = h.id AND tp.tvab = h.tvab LEFT JOIN lentus AS l ON tp.id = l.id AND tp.tvab = l.tvab /* For Twin 2 */ LEFT JOIN twin_data AS td2 ON p2.id = td2.id

204

MySQL Technical Reference for Version 5.0.0-alpha

AND p2.tvab = td2.tvab LEFT JOIN informant_data AS id2 ON p2.id = id2.id AND p2.tvab = id2.tvab LEFT JOIN harmony AS h2 ON p2.id = h2.id AND p2.tvab = h2.tvab LEFT JOIN lentus AS l2 ON p2.id = l2.id AND p2.tvab = l2.tvab, person_data AS p1, person_data AS p2, postal_groups AS pg WHERE /* p1 gets main twin and p2 gets his/her twin. */ /* ptvab is a field inverted from tvab */ p1.id = tp.id AND p1.tvab = tp.tvab AND p2.id = p1.id AND p2.ptvab = p1.tvab AND /* Just the sceening survey */ tp.survey_no = 5 AND /* Skip if partner died before 65 but allow emigration (dead=9) */ (p2.dead = 0 OR p2.dead = 9 OR (p2.dead = 1 AND (p2.death_date = 0 OR (((TO_DAYS(p2.death_date) - TO_DAYS(p2.birthday)) / 365) >= 65)))) AND ( /* Twin is suspect */ (td.future_contact = Yes AND td.suspect = 2) OR /* Twin is suspect - Informant is Blessed */ (td.future_contact = Yes AND td.suspect = 1 AND id.suspect = 1) OR /* No twin - Informant is Blessed */ (ISNULL(td.suspect) AND id.suspect = 1 AND id.future_contact = Yes) OR /* Twin broken off - Informant is Blessed */ (td.participation = Aborted AND id.suspect = 1 AND id.future_contact = Yes) OR /* Twin broken off - No inform - Have partner */ (td.participation = Aborted AND ISNULL(id.suspect) AND p2.dead = 0)) AND l.event = Finished /* Get at area code */ AND SUBSTRING(p1.postal_code, 1, 2) = pg.code /* Not already distributed */ AND (h.nurse IS NULL OR h.nurse=00 OR h.doctor=00) /* Has not refused or been aborted */ AND NOT (h.status = Refused OR h.status = Aborted

Cap tulo 3: Tutorial de Introduo Do MySQL ca

205

OR h.status = Died OR h.status = Other) ORDER BY tvid; Algumas explicaes: co CONCAT(p1.id, p1.tvab) + 0 AS tvid N queremos ordenar o id e o tvab concatenados na ordem numrica. Adicioe nando 0 ao resultado faz o MySQL tratar o resultado como um nmero. u coluna id Esta identica um par de gmeos. Ela uma chave em todas as tabelas. e e column tvab Esta identica um gmeo em um par. Ela pode ter um valor de 1 ou 2. e column ptvab Esta o inverso de tvab. Quando tvab 1 este campo 2 e vice versa. Ela e e e existe para poupar digitao e tornar mais fcil para o MySQL otimizar a query. ca a Esta consulta demonstra, entre outras coisas, como fazer buscas em uma tabela a partir da mesma tabela com uma uniao (p1 e p2). No exemplo, isto usado para conferir se um par e de um gmeo morreu antes de 65 anos. Se for verdade, a linha no retornada. e a e Tudo acima existe em todas as tabelas com informaes relacionada aos gmeos. Ns temos co e o uma chave em ambos id,tvab (todas as tabelas) e id,ptvab (person_data) para tornar as consultas mais rpidas. a Na nossa mquina de produo (Um UltraSPARC 200MHz), esta consulta retorna entre a ca 150-200 linhas e gasta menos que um segundo. O nmero atual de registros nas tabelas usadas acima: u Tabela Registros person_data 71074 lentus 5291 twin_project 5286 twin_data 2012 informant_data 663 harmony 381 postal_groups 100

3.7.2 Mostrando uma Tabela sobre a Situao dos Pares Gmeos ca e

Cada entrevista termina com um cdigo da situao chamado event. A consulta mostrada o ca abaixa usada para mostrar uma tabela sobre todos pares gmeos combinados por evento. e e Ela indica em quantos pares ambos gmeos terminaram, em quantos pares um gmeo tere e minou e o outro foi recusado e assim por diante. SELECT t1.event, t2.event, COUNT(*) FROM lentus AS t1,

206

MySQL Technical Reference for Version 5.0.0-alpha

lentus AS t2, twin_project AS tp WHERE /* We are looking at one pair at a time */ t1.id = tp.id AND t1.tvab=tp.tvab AND t1.id = t2.id /* Just the sceening survey */ AND tp.survey_no = 5 /* This makes each pair only appear once */ AND t1.tvab=1 AND t2.tvab=2 GROUP BY t1.event, t2.event;

3.8 Utilizando MySQL com Apache

Existem programas que lhe permite autenticar seus usurios a partir de um banco de dados a MySQL e tambm permite gravar seus arquivos de log em uma tabela MySQL. e Voc pode alterar o formato de log do Apache para ser facilmente lido pelo MySQL coloe cando o seguinte no arquivo de congurao do Apache: ca LogFormat \ "\"%h\",%{%Y%m%d%H%M%S}t,%>s,\"%b\",\"%{Content-Type}o\", \ \"%U\",\"%{Referer}i\",\"%{User-Agent}i\"" Para carregar uma arquivo de log naquele formato dentro do MySQL, voc pode usar uma e instruo deste tipo: ca LOAD DATA INFILE /local/access_log INTO TABLE nome_tabela FIELDS TERMINATED BY , OPTIONALLY ENCLOSED BY " ESCAPED BY \\ A tabela chamada deve ser criada para ter colunas que correpondem a aquelas que a linha LogFormat gravam no arquivo de log.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

207

4 Administrao do Bancos de Dados MySQL ca

4.1 Congurando o MySQL
4.1.1 Opes de Linha de Comando do mysqld co
Na maioria dos casos voc deve gerenciar as opes do mysqld por meio dos arquivos de e co opes. Veja Seo 4.1.2 [Arquivos de opes], Pgina 216. co ca co a mysqld e mysqld.server lem opes dos grupos mysqld e server. mysqld_safe l as e co e opes dos grupos mysqld, server, mysqld_safe e mysqld_safe. Um servidor MySQL co embutido normalmente l opes do grupos server, embedded e xxxxx_SERVER, onde xxxxx e co o nome da aplicao. e ca mysqld aceita os seguintes opes de linha de comando. Aqui est uma lista das mais co a comuns. Para uma lista completa execute mysqld --help. As opes usadas para replicao co ca est`o listadas em uma seo separada, veja Seo 4.11.6 [Replication Options], Pgina 392. a ca ca a --ansi Utilizar a sintaxe ANSI SQL no lugar da sintaxe MySQL Veja Seo 1.8.2 [ANSI ca mode], Pgina 42. a

-b, --basedir=path Encaminho para o diretrio de instalao. Todos os caminhos normalmente so o ca a resolvidos em relao a este. ca --big-tables Permite grandes conjuntos de resultados salvando todos os conjuntos temporrios em um arquivo. Ele resolve a maioria dos erros table full, mas a tambm abaixa a velocidade das consultas nas quais as tabelas em memria e o seriam sucientes. Desde a Verso 3.23.2, o MySQL capaz de resolver isto aua e tomaticamente usando memria para pequenas tabelas temporrias e trocando o a para o disco as tabelas, quando for necessrio. a --bind-address=IP Endereo IP para ligar. c --console Grava a mensagem de erro no stderr/stdout mesmo se --log-error espee cado. No Windows o mysqld no fechar a tela de console se esta opo a a ca e usada. --character-sets-dir=path Diretrio onde esto os conjuntos de caracteres. Veja Seo 4.7.1 [Conjunto de o a ca caracteres], Pgina 325. a --chroot=path Coloca o daemon mysqld no diretorio chroot durante a inicializao. Medida ca de segurana recomendada desde o MySQL 4.0 (MySQL 3.23 no est apto a c a a fornecer um chroot 100% fechado. Limita os comandos LOAD DATA INFILE e SELECT ... INTO OUTFILE.

208

MySQL Technical Reference for Version 5.0.0-alpha

--core-file Grava um arquivo core se o mysqld morrer. Para alguns sistemas voc deve e tambm especicar --core-file-size para mysqld_safe. Veja Seo 4.8.2 e ca [mysqld_safe], Pgina 331. Note que em alguns sistemas, como Solaris, voc a e no consiguir um arquivo core se voc tambm estiver usando a opo --user. a a e e ca -h, --datadir=caminho Encaminha para o diretrio raiz dos bancos de dados. o --debug[...]= Se o MySQL est congurado com --with-debug, voc pode usar esta opo a e ca para obter um arquivo de rastreamento indicando o que o mysqld est fazendo. a Veja Seo E.1.2 [Criando arquivos trace], Pgina 1080. ca a --default-character-set=conjunto_caracter Congura o conjunto de caracteres padro. Veja Seo 4.7.1 [Conjunto de a ca caracteres], Pgina 325. a --default-table-type=tipo Congura o tipo de tabela padro. Veja Cap a ptexi tulo 7 [Tipos de tabelas], Pgina 630. a --delay-key-write[= OFF | ON | ALL] Como o DELAYED KEYS do MyISAM deve ser usado. [Parmetros do servidor], Pgina 454. a a Veja Seo 5.5.2 ca

--delay-key-write-for-all-tables; No MySQL 4.0.3 voc^ deve usar e --delay-key-write=ALL. No descarrega buers das chaves entre escritas em nenhuma tabela MyISAM. a Veja Seo 5.5.2 [Parmetros do servidor], Pgina 454. ca a a --des-key-file=filename Read the default keys used by DES_ENCRYPT() and DES_DECRYPT() from this le. --enable-external-locking (era --enable-locking) Habilita o bloqueio do sistema. Perceba que se usar esta opo em um sistema ca que no possui um lockd() completamente funcional (como no Linux) voc pode a e fazer com que o mysqld entre em deadlock. --enable-named-pipe Habilita suporte para named pipes (somente no NT/Win2000/XP). -T, --exit-info Esta uma mscara binria com diferntes parmetros que pode ser usada para e a a e a depurar o servidor mysqld; Esta opo no deve ser usada por algum que no ca a e a a conhea muito bem! c --flush Atualiza todas as alteraes no disco depois de cada comando SQL. Normalco mente o MySQL s faz a escrita de todas as alteraes no disco depois de cada o co comando SQL e deixa o sistema operacional lidar com a sincronizao com o ca disco. Veja Seo A.4.1 [Falhas], Pgina 925. ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

209

-?, --help Mostra uma pequena ajuda e sai. --init-file=arquivo L comandos SQL do arquivo especicado na inicializao. e ca -L, --language=... Mensagens de erro do cliente na l ingua especicada. Pode ser fornecido como um caminho completo. Veja Seo 4.7.2 [L ca inguas], Pgina 327. a -l, --log[=arquivo] Log de conexes e consultas ao arquivo. Veja Seo 4.10.2 [Log de consultas], o ca Pgina 373. a --log-bin=[arquivo] Registra todas as consultas que alteram dados em arquivo. Usado para backup e replicao. Veja Seo 4.10.4 [Binary log], Pgina 374. ca ca a --log-bin-index[=arquivo] Arquivo de indice para nomes de arquivos de log binario. Veja Seo 4.10.4 ca [Log binrio], Pgina 374. a a --log-error[=arquivo] Registra mensagens de erro e inicializao neste arquivo. Veja Seo 4.10.1 [Log ca ca de erro], Pgina 372. a --log-isam[=arquivo] Log de todas alteraes ISAM/MyISAM no arquivo (usado somente quando co estiver depurando bancos ISAM/MyISAM). --log-long-format Registra algumas informaes extras nos aruivos de log (log de atualizaes, co co log binrio de atualizaes e log de consultas lentas, independente de qual est a co a ativado). Por exemplo, nome do usurio e timestamp so registrados para a a a consulta. Se voc estiver usando --log-slow-queries e --log-long-format, e ento consultas que no esto usando a a a indices so registradas ao log de cona sultas lentas. Note que --log-long-format est obsoleto a partir do MySQL a verso 4.1, quando --log-short-format foi introduzido (--log-long-format a a congurao padro desde a verso 4.1). Note tambm que a partir do e ca a a e MySQL 4.1, a opo --log-queries-not-using-indexes est dispon para ca a ivel propsito de registro de consultas que no usam o a indices para o log de consultas lentas. --log-queries-not-using-indexes Se voc estiver usando --log-slow-queries, ento consultas que no esto e a a a usando indices esto registradas no log de consultas lentas. Esta opes a co est dispon a ivel a partir do MySQL 4.1. Veja Seo 4.10.5 [Slow query log], ca Pgina 377. a --log-short-format Registra menos informaes extras nos aruivos de log (log de atualizaes, log co co binrio de atualizaes e log de consultas lentas, independente de qual est a co a

210

MySQL Technical Reference for Version 5.0.0-alpha

ativado). Por exemplo, nome do usurio e timestamp so registrados para a a a consulta. Esta opo foi introduzida no MySQL 4.1. ca --log-slow-queries[=arquivo] Log de todas as consultas que levam mais de long_query_time segundos de execuo para um arquivo. Note que o padro para a quantidade de informao ca a ca registrada alterou no MySQL 4.1. Veja as opes --log-long-format e co -log-long-format para mais detalhes. Veja Seo 4.10.5 [Slow query log], ca Pgina 377. a --log-update[=arquivo] Log de atualizaes para file.# onde # um nmero unico se no for fornecido. co e u a Veja Seo 4.10.3 [Log de atualizao], Pgina 373. O log de atualizao ca ca a ca estobsoleto e ser removido no MySQL 5.0; voc deve usar o log binrio em a a e a seu lugar (--log-bin). Veja Seo 4.10.4 [Log binrio], Pgina 374. A partir ca a a da verso 5.0, usar --log-update apenar ligar o log binrio. a a a --low-priority-updates Operaes de alteraes das tabelas (INSERT/DELETE/UPDATE) iro ter priorico co a dade menor do que as selects. Isto tambm pode ser feito usando {INSERT | e REPLACE | UPDATE | DELETE} LOW_PRIORITY ... para baixar a prioridade de somente uma consulta, ou SET OPTION SQL_LOW_PRIORITY_UPDATES=1 para alterar a prioridade em uma unica thread. Veja Seo 5.3.2 [Bloqueio de tabelas], ca Pgina 444. a --memlock Bloqueia o processo mysqld na memria. Isto funciona somente se o seu sistema o suportar a chamada de sistema mklockall() (como no Solaris). Isto pode ajudar se voc tiver um problema no qual o sistema operacional faz com que e o mysqld faa a troca em disco. Note que o uso desta opo exige que voc c ca e execute o servidor como root, que normalmente no uma boa idia por razes a e e o de segurana. c --myisam-recover [=op~o[,op~o...]]] onde op~o qualquer combina~o ca ca ca e ca de DEFAULT, BACKUP, FORCE ou QUICK. Voc tambm pode congurar isto exe e plicitamente para "" se voc deseja desabilitar esta opo. Se esta opo for e ca ca usada, o mysqld ir conferir na abertura se a tabela est marcada como quea a brada ou se a tabela no foi fechada corretamente. (A ultima opo funciona a ca somente se voc estiver executando com --skip-locking). Se este for o caso e mysqld ir executar uma conferncia na tabela. Se a tabela estiver corrompida, a e o mysqld ir tentar repar-la. a a As seguintes opes afetam no funcionamento da reparao. co ca Opo ca Descrio ca DEFAULT O mesmo que no fornecer uma opo para --myisama ca recover. BACKUP Se os dados da tabela foram alterados durante a recuperao, ca salve um backup do arquivo de dados nome_tabela.MYD como nome_tabela_dia_hora.BAK. FORCE Execute a recuperao mesmo se perdermos mais de uma ca linha do arquivo .MYD.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

211

QUICK

No conra as linhas na tabela se no existir nenhum bloco a a apagado. Antes da tabela ser reparada automaticamente, o MySQL ir adicionar uma a nota no log de erros. Se voc desejar que a recuperao da maioria dos probe ca lemas no tenha a interveno de algum usurio, devem ser usadas as opes a ca a co BACKUP,FORCE. Isto ir forar um reparo de uma tabela mesmo se alguns rega c istros forem apagados, mas ele manter o arquivo de dados antigo como um a backup para que voc possa examinar posteriormente o que aconteceu. e --new A partir da verso 4.0.12, a opo --new pode ser usada para fazer o servidor a ca se comportar como 4.1 em certos aspectos, facilitando a atualizao da verso ca a 4.0 para 4.1: TIMESTAMP retornado com uma string com o formato YYYY-MM-DD e HH:MM:SSS. Veja Seo 6.2 [Tipos de colunas], Pgina 482. ca a

--pid-file=caminho Encaminha para o arquivo pid usado pelo mysqld_safe. -P, --port=... Nmero da porta para conexes TCP/IP. u o -o, --old-protocol Utilize o protocolo 3.20 para compatibilidade com alguns clientes muito antigos. Veja Seo 2.5.5 [Atualizando a verso 3.20], Pgina 129. ca a a --one-thread Usa somente uma thread (para depurao sobre Linux). Esta opo est ca ca a dispon ivel apenas se o servidor est constru com a depurao habilitada. a ido ca Veja Seo E.1 [Depurando o servidor], Pgina 1079. ca a --open-files-limit= Para alterar o nmero de descritores de arquivos dispon u iveis para o mysqld. Se isto no estiver congurado com 0, ento o mysqld usar este valor para reservar a a a descritores de arquivos para usar com setrlimit(). Se este valor 0 ento o e a mysqld reservar max_connections*5 ou max_connections + table_cache*2 a (que sempre maior) nmero de arquivos. Voc deve tentar aumentar isto se e e u e o mysqld lhe retornar o erro Too many open les. -O, --set-variable=name=value Fornece um valor para uma varivel. --help lista as variveis. Voc a a e pode encontrar uma descrio completa para todas as variveis na seo ca a ca SHOW VARIABLES deste manual. Veja Seo 4.6.8.4 [SHOW VARIABLES], ca Pgina 309. A seo de sintonia dos parmetros do servidor inclui informaes a ca a co sobre como otimiz-los. Por favor, note que --set-variable=name=value e a -O name=value esto obsoletos desde o MySQL 4.0, apenas use --var=op~o. a ca Veja Seo 5.5.2 [Server parameters], Pgina 454. ca a No MySQL 4.0.2 pode-se denir uma varivel diretamente com --variablea name=op~o e set-variable no mais preciso no arquivo de opes. ca a e co Se voc quiser restringir o valor mximo uma opo de inicializao pode ser e a ca ca denida com SET, voc pode den usando a opo de linha de comando e i-la ca --maximum-variable-name. Veja Seao 5.5.6 [SET OPTION], Pgina 460. c a

212

MySQL Technical Reference for Version 5.0.0-alpha

Note que quando um valor atribu a uma varivel, o MySQL pode carrig e ido a i-lo automaticamente para permanecer dentro de uma faixa dada e tambm ajusta e o valor um pouco para corrigir para o algoritmo usado. --safe-mode Salta alguns estgios de otimizao. a ca --safe-show-database Com esta opo, o comando SHOW DATABASES retorna apenas aqueles bancos de ca dados para os quais o usurio tem algum tipo de privilgio. Desde a verso 4.0.2 a e a esta opo esta obsoleta e no faz nada (a opo est habilitada por padro) ca a ca a a j que agora temos o privilgio SHOW DATABASES. Veja Seo 4.4.1 [GRANT], a e ca Pgina 254. a --safe-user-create Se isto estiver ativo, um usurio no pode criar novos usurios com o comando a a a GRANT, se o usurio no ter o privilgio de INSERT na tabela mysql.user ou a a e em alguma coluna desta tabela. --skip-bdb Disabilita o uso de tabelas BDB. Isto economizar memria e pode aumentar a o a velocidade de algumas operaes. co --skip-concurrent-insert Desliga a habilidade de selecionar e inserir ao mesmo tempo em tabelas MyISAM. (Isto s usado se voc achar que encontrou um erro neste recurso). oe e --skip-delay-key-write; No MySQL 4.0.3 voc deve usar delay-key-write=OFF. Ignore a opo DELAY_ e ca KEY_WRITE para todas as tabelas. Veja Seo 5.5.2 [Parmetros do servidor], ca a Pgina 454. a --skip-grant-tables Esta opo faz com que o servidor no use o sistema de privilgio. Isto d a ca a e a todos acesso pleno a todos os bancos de dados! (Voc pode dizer a um servidor e em execuo para iniciar a usar as tabelas de permisso novamente executando ca a mysqladmin flush-privileges ou mysqladmin reload.) --skip-host-cache Nunca utiliza cache para nomes de mquina para resolues de nomes mais a co rpidos, mas pesquisa o servidor DNS em todas conexes. Veja Seo 5.5.5 a o ca [DNS], Pgina 459. a --skip-innodb Disabilita o uso de tabelas Innodb. Isto ir economizar memria, espao em a o c disco e aumentar a velocidade de algumas operaes. co --skip-external-locking (era --skip-locking) No utilizar bloqueio de sistema. Para usar isamchk ou myisamchk voc deve a e desligar o servidor. Veja Seo 1.2.3 [Stability], Pgina 8. Perceba que na ca a Verso 3.23 do MySQL pode ser usado REPAIR e CHECK para reparar/conferir a tabelas MyISAM.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

213

--skip-name-resolve Nomes de mquinas no so resolvidos. Todos os valores da coluna Host nas a a a tabelas de permisses devem conter nmeros IP ou localhost. Veja Seo 5.5.5 o u ca [DNS], Pgina 459. a --skip-networking No escutair conexes TCP/IP. Toda interao com mysqld deve ser feito a o ca atravs de named pipes ou sockets Unix. Esta opo altamente recomene ca e dada para sistemas onde requisies locais so permitidas. Veja Seo 5.5.5 co a ca [DNS], Pgina 459. a --skip-new No utilizar rotinas novas, poss a ivelmente erradas.

--skip-symlink Opo obsoleta a partir da 4.0.13; use --skip-symbolic-links em seu lugar. ca --symbolic-links, --skip-symbolic-links Habilita ou desabilita suporte a link simblico. Esta opo tem efeitos diferentes o ca no Windows e Unix. No Windows, habilitar links simb ilicos lhe permite estabelecer um link simblico o a um diretrio de banco de dadosi criando um arquivo directory.sym que o contm o caminho para o diretrio real. Veja Seo 5.6.1.3 [Links simblicos no e o ca o Windows], Pgina 468. a No Unix, habilitar links simblicos, signica que voc pode ligar uma tabela o e MyISAM ou um arquivo de dados em outro dirtrio com as opes INDEX o co DIRECTORY ou DATA DIRECTORY da instruo CREATE TABLE. Se voc deletar ca e ou renomear a tabela, os arquivos para o qual o link simblico aponta tambm o e ser deletado/renomeado. a --skip-safemalloc Se o MySQL congurado com --with-debug=full, todos os programas vere icam a memria por erros para cada operao de alocao e liberao de o ca ca ca memria. Esta consistncia muito lenta, assim para o servidor voc pode o e e e evit-la, quando voc no precisar dela usando a opo --skip-safemalloc. a e a ca --skip-show-database No permite o comando SHOW DATABASE, a menos que o usurio tenha a a privilgio SHOW DATABASES. e --skip-stack-trace No gravar os rastreamentos de pilha. Esta opo util quando voc estiver a ca e e executando o mysqld sob um depurador. El alguns sistemas voc tambm deve e e usar esta opo para conseguir um arquivo core. Veja Seo E.1 [Depurando o ca ca servidor], Pgina 1079. a --skip-thread-priority Desabilita o uso de prioridade das threads para um tempo de resposta mais rpido. a

214

MySQL Technical Reference for Version 5.0.0-alpha

--socket=path No Unix, o arquivo socket para usar em conexes locais no lugar do padro o a /tmp/mysql.sock. No Windows, o nome do pipe para usar em conexes locais o que usam named pipe (padro MySQL). a

--sql-mode=value[,value[,value...]] Os valores de opo pode ser qualquer combinao de: REAL_AS_FLOAT, ca ca PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, ONLY_FULL_GROUP_BY, NO_UNSIGNED_SUBTRACTION, NO_AUTO_VALUE_ON_ZERO, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS, NO_KEY_OPTIONS, NO_DIR_IN_CREATE, MYSQL323, MYSQL40, DB2, MAXDB, MSSQL, ORACLE, POSTGRESQL, ou ANSI. O valor tambm e pode car vazio (--sql-mode="") se voc desejar limp-la. e a NO_AUTO_VALUE_ON_ZERO afeta o tratamento de colunas AUTO_INCREMENT. Normalmente, voc gera a prxima sequncia de nmeros da coluna inserindo NULL e o e u ou 0 nela. NO_AUTO_VALUE_ON_ZERO omite este comportamento para 0, assim apenas NULL gera a prxima sequncia de nmeros. Este modo pode ser util se 0 o e u foi armazenado em uma coluna AUTO_INCREMENT da tabela (isto no recomena e dado). Por exemplo, se voc zer um dumpo de uma tabela com mysqldump e e ento recarreg-la, normalmente o MySQL ira gerar uma nova sequncia de a a e nmeros quando encontrar valores 0, resultando em uma tabela com contedo u u diferente daquele do qual foi feito o dump. Habilitando NO_AUTO_VALUE_ON_ ZERO antes de recarregar o arquivo de dump soluciona este problema. (A partir do MySQL 4.1.1, quando este valor se tornar dispon ivel, o mysqldump inclui do dump para habilitar NO_AUTO_VALUE_ON_ZERO.) automaticamente a saida Diversos dos valores de opo so usados para compatibilidade com outros servica a dores. Se especicado, eles fazer o servidor omitir da sa de SHOW CREATE ida TABLE aquelas partes da instruo que no so entendidas pelas verses anterica a a o ores do MySQL ou outros servidores de banco de dados. Usar estes valores de opes resulta em instrues CREATE TABLE que so mais portveis para usar co co a a com outros servidores: Os valores NO_TABLE_OPTIONS, NO_FIELD_OPTIONS, NO_DIR_IN_CREATE, e NO_KEY_OPTIONS causam a omisso da tabela de opes, ou opes pertena co co centes a denio de colunas ou ca indices. Os valroes MYSQL323 e MYSQL40 so para compatibilidade com o MySQL a 3.23 e MySQL 4.0. O valor usado para compatibilidade com outros servidores so DB2, MAXDB, a MSSQL, ORACLE, e POSTGRESQL. Estas opes tambm afetam a sa do mysqldump, porque este programa usa co e ida SHOW CREATE TABLE para obter a instruo de criao da tabela a qual ele inclue ca ca em sua prpria sa o ida. Diversos valores de opes podem ter um efeito complexo porque eles so atalhos co a para um grupo ou conjunto de valores. Por exemplo, voc pode dizer ao servidor e para executar em modo ANSI usando a opo --sql-mode=ansi (ou --ansi), ca que equivalente a especicar ambas das seguintes opes de linhas de comando: e co --sql-mode=REAL_AS_FLOAT,PIPES_AS_CONCAT,ANSI_QUOTES,IGNORE_SPACE,ONLY_FUL --transaction-isolation=SERIALIZABLE

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

215

Note que especicar o modo ANSI desta forma tambm tem o efeito de conge urar o n de isolao da transao. ivel ca ca Para mais informaes sobre executar o servidor em modo ANSI, veja co Seo 1.8.2 [ANSI mode], Pgina 42. ca a Outros valores de grupos so DB2, MAXDB, MSSQL, ORACLE, e POSTGRESQL. a Esepcicar qualquer um dele ativa os valores PIPES_AS_CONCAT, ANSI_QUOTES, IGNORE_SPACE, NO_TABLE_OPTIONS, NO_FIELD_OPTIONS, e NO_KEY_OPTIONS. A opo --sql-mode foi adicionada no MySQL 3.23.41. O valor NO_UNSIGNED_ ca SUBTRACTION foi adicionado na verso 4.0.0. NO_DIR_IN_CREATE foi adicionado a na verso 4.0.15. NO_AUTO_VALUE_ON_ZERO, NO_TABLE_OPTIONS, NO_FIELD_ a OPTIONS, NO_KEY_OPTIONS, MYSQL323, MYSQL40, DB2, MAXDB, MSSQL, ORACLE, POSTGRESQL, e ANSI foram adicionados na verso 4.1.1. a --temp-pool Usar esta opo far com que a maioria dos arquivos temporrios criados pelo ca a a servidor para usarem um pequeno conjunto de nomes, em vez de um unico nome para cada novo arquivo. Isto para contornar um problema no kernel do Linux e ao tratar com a criao de muitos arquivos novos com nomes diferentes. Com ca o comportamento antigo, o Linux parece ter perda de memria, j que ela o a e alocada na cache de entrada do diretrio em vez da cache de disco. o --transaction-isolation={ READ-UNCOMMITTED | READ-COMMITTED | REPEATABLE-READ | SERIALIZABLE } Congura o n ivel de isolao da transao padro. Veja Seo 6.7.6 [SET ca ca a ca TRANSACTION], Pgina 619. a -t, --tmpdir=path Caminho do diretrio usado para criar os arquivos temporrios. Ele pode ser o a util se o seu diretrio padro /tmp est em uma partio muito pequena para o a a ca armazenar tabelas temporrias. A partir do MySQL 4.1, esta opo aceita a ca diversos caminhos usados do modo round-robin. Os caminhos devem ser separados por dois pontos (:) (ponto e v irgula (;) no Windows). Eles sero usados a de acordo com o mtodo round-robin. e -u, --user=[nome_usurio | id_usurio] a a Executar o servidor mysqld como o usurio nome_usurio ou id_usrio a a a (numrica). (User neste contexto se refere a conta de login do sistema, no e a um usurio MySQL listado na tabela de permisses.) a o Esta opo obrigatria quando o mysqld iniciado como usurio root. O ca e o e a servidor ir alterar o ID do usurio durante sua inicializao, fazendo com que a a ca ele seja executado como este usurio particular em vez de root. Veja Seo 4.3.2 a ca [Security], Pgina 229. a A partir do MySQL 3.23.56 e 4.0.12: Para evitar um poss furo na segurana ivel c onde um usurio adiciona uma opo --user=root a algum arquivo my.cnf a ca (fazendo o servidor executar como root, o mysqld usa apenas a primeira opo ca --user especicada e produz um aviso se houver mltiplas opes --user. u co As opes em /etc/my.cnf e datadir/my.cnf so processadas antes de uma co a opo de linha de comando, assim recomendado que voc coloque uma opo ca e e ca

216

MySQL Technical Reference for Version 5.0.0-alpha

--user em /etc/my.cnf e especique um outro valor diferente de root. A opo em /etc/my.cnf ser encontrada antes de qualques outra opo -ca a ca user, o que assegura que o servidor no execute como root, e que um aviso a seja exibido se qualquer outra opo --user for encontrada. ca -V, --version Mostra a informao da verso e sai. ca a -W, --log-warnings Imprime avisos como Aborted connection... no arquivo .err. E recomendvel habilitar esta opo, por exemplo, se voc estiver usando a ca e replicao (voc obter a mensagem sobre o que est acontecendo como falhas ca e a a de rede e reconexes). Veja Seo A.2.10 [Erros de comunicao], Pgina 918. o ca ca a Esta opo se chamava --warnings. ca Pode se alterar a maioria dos valores de um servidor em execuo com o comnado SET. Veja ca Seo 5.5.6 [SET OPTION], Pgina 460. ca a

4.1.2 Arquivo de Opes my.cnf co

O MySQL pode, desde a verso 3.22, ler as opes padres de inicializao para o servidor a co o ca e para clientes dos arquivos de opes. co No Windows, o MySQL l opes padres dos seguintes arquivos: e co o Nome do Arquivo Windows-directory\my.ini C:\my.cnf Propsito o Opes globais co Opes globais co

Windows-directory a localizao do seu diretrio Windows. e ca o No Unix, o MySQL l opes padres dos seguintes arquivos: e co o Nome do arquivo /etc/my.cnf DATADIR/my.cnf defaults-extra-file ~/.my.cnf Propsito o Opes globais co Opes espec co icas do servidor O arquivo especicado com --defaultsextra-file=# Opes espec co icas do usurio a

DATADIR o diretrio de dados do MySQL (normalmente /usr/local/mysql/data para e o instalaes binrias ou /usr/local/var para instalaes de cdigo fonte). Perceba que este co a co o o diretrio que foi especicado na hora da congurao, no o especicado com --datadir e o ca a quando o mysqld inicia! (--datadir no tem efeito sobre o local onde o servidor procura a por arquivos de opes, porque ele procura pelos arquivos antes de processar qualquer co argumento da linha de comando.) Note que no Windows, voc deve especicar todos os caminhos no arquivo de opo com / e ca no lugar de \. Se for utilizado o \, ser necessrio digit-lo duas vezes, pois o \ o caractere a a a e de escape no MySQL. O MySQL tenta ler os arquivos de opes na ordem listada acima. Se mltiplos arquivos de co u opes existirem, uma opo especicada em um arquivo lido depois recebe a precedncia co ca e sobre a mesma opo especicada em um arquivo lido anteriormente. Opes especicadas ca co

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

217

na linha de comando recebem a precedncia sobre opes especicadas em qualquer arquivo e co de opes. Algumas opes podem ser especicadas usando variveis de ambiente. Opes co co a co especicadas na linha de comando ou nos arquivos de opo tem precendencia sobre valores ca nas variveis de ambiente. Veja Apndice F [Variveis de ambiente], Pgina 1092. a e a a Os seguintes programas suportam arquivos de opes: mysql, mysqladmin, mysqld, mysqld_ co safe, mysql.server, mysqldump, mysqlimport, mysqlshow, mysqlcheck, myisamchk, e myisampack. Desde a verso 4.0.2, voc pode usar o prexo loose para opes de linha de comando a e co (ou opes no my.cnf). Se uma opo possui o prexo loose, o programa que a ler no co ca a nalizar com um erro se uma opo for desconhecida, mas apenas enviar um aviso: a ca a shell> mysql --loose-no-such-option Voc pode usar arquivos de opes para especicar qualquer opo extendida que o programa e co ca suporte! Execute o programa com --help para obter uma lista das opes dispon co iveis. Um arquivo de opes pode conter linhas na seguinte forma: co #comentario Linhas de comentrio iniciam com o caractere # ou ;. Comentrios podem a a iniciar no meio de uma linha tambm. Linhas vazias so ignoradas. e a [grupo] grupo o nome do programa ou grupo para o qual voc ir congurar as opes. e e a co Depois de uma linha de grupo, qualquer linha de op~o ou set-variable so ca a referentes ao grupo at o nal do arquivo de opes ou outra linha de in de e co icio grupo. Isto equivalente ` --op~o na linha de comando. e a ca

op~o ca

op~o=valor ca Isto equivalente ` --op~o=valor na linha de comando. Por favor, note que e a ca voc deve colocar um argumento entre aspas duplas, se o argumento de uma e opo conter um caracter de comentrio. ca a set-variable = nome=valor Isto equivalente ` --set-variable nome=valor na linha de comando. e a Por favor, notem que --set-variable est obsoleto desde o MySQL 4.0; a a partir desta verso os nomes das variveis de programa podem ser usados como a a nome de opes. Na linha de comando, use apenas --nome=valor. Em um co arquivo de opo, use nome=valor. ca O grupo [client] permite especicar opes para todos clientes MySQL (no o mysqld). co a Este o grupo perfeito de se usar para especar a senha que voc usa para conectar ao e e servidor. (Mas tenha certeza que o arquivo de opes s pode ser lido e gravado por voc) co o e Se voc quiser criar opes que devem ser lidas por uma verso especica do servidor mysqld e co a voc pode fazer isto com [mysqld-4.0], [mysqld-4.1] etc: e [mysqld-4.0] new A nova opo acima s ser usada com o verses 4.0.x do servidor MySQL. ca o a o Perceba que para opes e valores, todos espaos em branco so automaticamente apagados. co c a Voc pode usar a sequencia de escape \b, \t, \n, \r, \\ e \s no valor da string (\s e == espao). c

218

MySQL Technical Reference for Version 5.0.0-alpha

Aqui est um t a ipico arquivo de opes globais. co [client] port=3306 socket=/tmp/mysql.sock [mysqld] port=3306 socket=/tmp/mysql.sock set-variable = key_buffer_size=16M set-variable = max_allowed_packet=1M [mysqldump] quick Aqui est um t a ipico arquivo de opes do usurio co a [client] # A senha seguinte ser enviada para todos clientes MySQL a password="minha_senha" [mysql] no-auto-rehash set-variable = connect_timeout=2 [mysqlhotcopy] interactive-timeout Se voc tem uma distribuio fonte, voc encontrar arquivos de exemplo de congurao e ca e a ca chamados my-xxxx.cnf no diretrio support-files. Se voc tem uma distribuio o e ca binria olhe no diretrio de instalao DIR/support-file, onde DIR o caminho para a o ca e o diretrio de instalao (normalmente C:\mysql ou /usr/local/mysql). Atualmente o ca existem arquivos de congurao para sistemas pequenos, mdios, grandes e enormes. Voc ca e e pode copiar my-xxxx.cnf para seu diretrio home (renomeie a cpia para .my.cnf para o o experimentar. Todos os programas MySQL que suportam arquivos de opes aceitam opes: co co Opo ca Descrio ca --no-defaults No l nenhum arquivo de opes. a e co --print-defaults Imprima o nome do programa e todas opes. co --defaults-file=caminho-paraUtilize somente o arquivo de congurao esca arquivo-padr~o a pec icado. --defaults-extra-file=caminhoLeia este arquivo de congurao depois do arca para-arquivo-padr~o a quivo de congurao global mas antes do arca quivo de congurao do usurio. ca a Perceba que as opes acima devem vir primeiro na linha de comando para funcionar, com co exceo que --print-defaults deve ser usado logo depois dos comandos --defaults-file ca ou --defaults-extra-file. Notas para desenvolvedores: O tratamento de arquivos de opes implementado simplesco e mente processando todos as opes coincidentes (isto , opes no grupo apropriado) antes co e co

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

219

de qualquer argumento da linha de comando. Isto funciona bem para programas que usam a ultima instncia de uma opo que especicada diversas vezes. Se voc tem um pro a ca e e grama antigo que trata opes especicadas vrias vezes desta forma mas no l arquivos co a a e de opes, voc s precisa adicionar duas linhas para lhe dar esta capacidade. Verique o co e o cdigo fonte de qualquer um dos clientes MySQL padro para ver como fazer isto. o a Nos scripts shell voc pode usar o comando my_print_defaults para analisar os arquivos e de opo. O seguinte exemplo mostar a sa que my_print_defaults pode produzir ca ida quando quando pedido para mostrar as opes encontradas nos grupos [client] e [mysql]: co shell> my_print_defaults client mysql --port=3306 --socket=/tmp/mysql.sock --no-auto-rehash

4.2 Executando M ltiplos MySQL Servers na Mesma u Mquina a

Em alguns casos voc pode precisar de executar mltiplos servidores mysqld executando e u na mesma mquina. Voc pode desejar testar uma nova verso do MySQL enquanto a a e a deixa a sua instalao da verso de produo existente sem perturbao. Ou voc pode ca a ca ca e desejar dar acesso a diferentes usurios em diferentes servidores mysqld gerenciados por a eles mesmos. (Por exemplo, voc pode seu um provedor de servios de internet que quer e c fornecer instalaes independentes do MySQL para clientes diferentes). co Para executar mltiplos servidores em uma unica mquina, cada servidor deve ter valores u a unicos para diversos parmetros operacionais. Isto deve ser congurado na linha de co a mando ou em arquivos de opes. Veja Seo 4.1.1 [Command-line options], Pgina 207 e co ca a Seo 4.1.2 [Option les], Pgina 216. ca a Pelo menos as seguintes opes devem ser diferente para cada servidor: co --port=port_num --socket=path --shared-memory-base-name (apenas Windows; novo no MySQL 4.1) --pid-file=path (apenas Unix) --port controla o nmero da porta para conexes TCP/IP. --socket controla o caminho u o do arquivo de socket no Unix e o nome do named pipe no Windows. (E necessrio nomes de a pipes distintos no Windows apenas para aqueles servidores que suportam conexo named a pipes.) --shared-memory-base-name designa o nome da memria compartilhada por um servidor o Windows para permitir que o cliente se conecte via memria compartilhada. --pid-file o indice o nome do arquivo no qual o Unix gravar a ID do seu processo. Se voc usar as seguintes opes, elas deve ser diferentes para cada servidor: e co --log=path --log-bin=path --log-update=path

220

MySQL Technical Reference for Version 5.0.0-alpha

--log-error=path --log-isam=path --bdb-logdir=path Se voc quiser mais desempenho, voc tambm pode especicar as seguinte opes difere e e co entemente para cada servidor para distribuir a carga entre vrios discos f a isicos: --tmpdir=path --bdb-tmpdir=path Normalmente, cada servidor tambm deve usar um diretrio de dados diferentes, que e o e especicado usando a opo --datadir=path. ca AVISO: Normalmente voc nunca deve ter dois servidores que atualizam dados no mesmo e banco de dados! Isto pode levar a supresas inesperadas se seu o seu sistema operacionalno a suporta lock de sistema a prova de falhas, isto pode provocar surpresas indesejveis! Se a (apesar deste aviso) voc executar diversos servidores usando o mesmo diretrio de dados e o e eles tiverem com o log habilitado, voc usar as opes apropriadas para especicar os e co nomes dos arquivos de log que so unicos em cada servidor. Seno, o servidores podem a a tentar gravar no mesmo arquivo de log. Este aviso contra o compartilhamento de arquivos de dados entre servidores tambm se e aplica em um ambeinte NFS. Permitir vrios servidores MySQL acessarem um diretrio de a o dados comum sobre NFS, normalmente uma MA IDEIA! e O primeiro problema que o NFS se tornar um gargalo, tornando o sistema lento. Ele e a no se destina para este tipo de uso. a Outro risco com NFS que voc ter que conseguir um modo de se certicar que dois e e a ou mais servidores no esto interferindo uns com os outros. Normalmente o lock de a a arquivo tratado pelo daemon lockd, mas no momento no existe nenhuma plataforma e a que fara o locck 100% de segurana, em todas as situaes. c co Facilite a sua vida: esquea sobre compartilhar um diretrio de dados entre servidores sobre c o NFS. A soluo melhor ter um computador com um sistema operacional que manipule ca e threads de forma eciente threads e tenha diversas CPUs nele. Se voc tiver mltiplas instalaes do MySQL em diferentes locais, normalemente voc pode e u co e especicar o diretrio de instalao base de cada servidor com a opo --basedir=caminho o ca ca para fazer que cada servidor use diferentes diretrios de dados, arquivos de log e arquivos o PID. (O padro para todos estes valores so determinados em relao ao diretrio base.) a a ca o Neste caso, as unicas outras opes que voc precisa especicar so as opes --socket e - co e a co port. Por exempo, suponha que voc instalou a verso binria do MySQL (arquivos .tar) e a a em diferentes locais, assim voc pode iniciar o servidor usando o comando ./bin/mysqld_ e safe sob o diretrio base correspondente de cada instalao. mysqld_safe determinar a o ca a opo --basedir apropriada para passar para mysqld, e voc precisa especicar apenas as ca e opes --socket e --port para o mysqld_safe. co Como discutido nas sees a seguir, poss co e ivel iniciar servidores adicionais congurando variveis de ambiente ou especicando as opes de linha de comando apropriada. No a co entanto, se voc precisa executar mltiplos servidores em uma base mais permanente, ser e u a mais coonveniente usar os arquivos de opes para especicar, para cada servidor, aquelas co opes que devem ser unicas para ele. Veja Seo 4.1.2 [Option les], Pgina 216. co ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

221

4.2.1 Executando M ltiplos Servidores no Windows u

Voc pode executar mltiplos servidor no Windows iniciando-os manualmente a partir e u da linha de comando, cada um com o parmetro operacional apropriado. Em sistemas a baseados no Windows NT, voc tambm tem a opo de instalar vrios servidores como e e ca a servios Windows e execut-los deste modo. Instrues gerais sobre a execuco de servic a co a dores MySQL a partir da linha de comando ou como servios so dados em Seo 2.6.1 c a ca [Windows], Pgina 133. Esta seo descreve como se certicar de que voc inicioou cada a ca e servidor com valores diferentes para aquelas opes de inicializao que devem ser unicas co ca por servidor, como o diretrio de dados. (Estas opes so descritas em Seo 4.2 [Multiple o co a ca servers], Pgina 219.) a

4.2.1.1 Iniciando M ltiplos Servidores na Linha de Comando u

Para iniciar vrios servidores manualmente na linha de comando, voc pode especicar a a e mais conveniente colocar opo apropriada na linha de comando ou no arquivo de opes. E ca co as opes em um arquivo de opo. Para fazer isto, crie uma arquivo de opo para cada co ca ca servidor e mostre ao servidor o nome do arquivo com a opo --defaults-file quando ca voc execut-lo. e a Suponha que voc queira executar o mysqld na porta 3307 com um diretrio de dados de e o C:\mydata1, e mysqld-max na porta 3308 com um diretrio de dados de C:\mydata2. o Para conseguir isto, crie dois arquivos de opes. Por exemplo, crie um arquivo chamado co C:\my-opts1.cnf que se parea com isto: c [mysqld] datadir = C:/mydata1 port = 3307 Crie um segundo arquivo chamado C:\my-opts2.cnf que se parea com isto: c [mysqld] datadir = C:/mydata2 port = 3308 Ento inicie cada servidor com seus prprios arquivos de opo: a o ca shell> mysqld --defaults-file=C:\my-opts1.cnf shell> mysqld-max --defaults-file=C:\my-opts2.cnf (No NT, o servidor iniciar em segundo plano, assim voc precisar enviar estes dois coa e a mandos em janelas de console separadas.) Para desligar o servidor, voc deve conectar a porta apropriada: e shell> mysqladmin --port=3307 shutdown shell> mysqladmin --port=3308 shutdown Servidores congurados como descrito permitir que clientes se conectem por TCP/IP. a Se voc tambm quiser permitir conexes named pipe, use os servidores mysqld-nt ou e e o mysqld-max-nt e especique as opo que habilitem o named pipe e especique os seus ca nomes. (Cada servidor que suporta conexes named pipes deve ter um nome unico). Por o exemplo, o arquivo C:\my-opts1.cnf pode ser escrito da seguinte maneira:

222

MySQL Technical Reference for Version 5.0.0-alpha

[mysqld] datadir = C:/mydata1 port = 3307 enable-named-pipe socket = mypipe1 Esto inicie o servidor desta forma: a shell> mysqld-nt --defaults-file=C:\my-opts1.cnf C:\my-opts2.cnf seria modicado de forma parecida para uso com o segundo servidor.

4.2.1.2 Iniciando M ltiplos Servidores Como Servios u c

Em sistemas baseados no NT, um servidor MySQL pode ser executado como um servio c Windows. O procedimento para instalao, controle e remoo de um unico servio MySQL ca ca c est descrito em Seo 2.1.1.7 [NT start], Pgina 66. a ca a A partir do MySQL 4.0.2, voc pode instalar vrios servidores como servios. Neste caso, e a c voc deve ter certeza de que cada servidor usa um nome de servio diferente junto com e c todos os outros parmetros que devem ser unico por servidor. a Para as seguintes instrues, assuma que voc queira executar o servidor mysqld-nt a co e partir de duas verses diferentes do MySQL que est instalado em C:\mysql-4.0.8 e o a C:\mysql-4.0.17, respectivamente. (Este pode ser o caso se voc estiver executando a e verso 4.0.8 como seu servidor de produo, mas queira testar o 4.0.17 antes de atualiz-lo.) a ca a Os seguintes principios so relevantes ao instalr um servio MySQL com a opo --install: a c ca Se voc no especicar o nome do servio, o servidor usa o nome padro do servio e a c a c (MySQL) e o servidor l as opes do grupo [mysqld] no arquivo de opes padro. e co co a Se voc especicar um nome de servio depois da opo --install, o servidor ignora e c ca o grupo de opo [mysqld] e l as opes do grupo que tem o mesmo nome que o ca e co servio. O servidor l as opes do arquivo de opo padro. c e co ca a Se voc especicar uma opo --defaults-file depois do nome do servio, o servidor e ca c ignora o arquivo de opes padro e l as opes apenas do grupo [mysqld] do arquivo co a e co chamado. Este princ ipios tambm se aplicam se voc intalar um servidor usando a opo --installe e ca manual. Baseado na informao anterior, voc tem diversos de congurar vrios servios. As ca e a c seguintes instrues descrevem alguns exemplos. Antes de tentar qualquer uma delas co esteja certo de que voc desligou e removeu qualquer servio MySQL existente primeiro. e c Especique as opes para todos os servios em um dos arquivos de opes padro. co c co a Para fazer isto, use um nome de servio diferente para cada servidor. Suponha que voc c e queira executar o mysqld-nt 4.0.8 usando o nome de servio [mysqld1] e o mysqldc nt 4.0.17 usando o nome de servio mysqld2. Neste caso voc pode usar o grupo c e [mysqld1] para o 4.0.8 e o grupo [mysqld2] para o MySQL 4.0.14. Por exemplo, voc e pode congurar o C:\my.cnf desta forma: # op~es para o servio mysqld1 co c [mysqld1]

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

223

basedir = C:/mysql-4.0.8 port = 3307 enable-named-pipe socket = mypipe1 # op~es para o servio mysql2 co c [mysqld2] basedir = C:/mysql-4.0.17 port = 3308 enable-named-pipe socket = mypipe2 Instale os servios como a seguir, usando o caminho completo para o servidor para c assegurar que o Windows registra o programa executvel correto para cada servio: a c shell> C:\mysql-4.0.8\bin\mysqld-nt --install mysqld1 shell> C:\mysql-4.0.17\bin\mysqld-nt --install mysqld2 Para iniciar os servios, use o gerenciador de servios, ou use NET START com o nome c c de servio apropriado: c shell> NET START mysqld1 shell> NET START mysqld2 Para parar os servios, use o gerenciador de servios, ou use NET STOP com o mesmo c c nome de servio. c shell> NET STOP mysqld1 shell> NET STOP mysqld2 Nota: Antes do MySQL 4.0.17, apenas um servidor instalado usando o nome de servio c padro (MySQL) ou instalado com um nome de servio de mysqld ir ler o grupo a c a [mysqld] no arquivo de opes padro. A partir da verso 4.0.17, todos os servidores co a a lem o grupo [mysqld] se eles lem o arquivo de opes padro, mesmo de esles esto e e co a a instalados usando outro nome de servio. Isto permite que voc use o grupo [mysqld] c e para opes que devam ser usadas por todos os servios MySQL, e um grupo de opo co c ca com o nome de cada servio para o uso do servidor com aquele nome de servio. c c Especique as opes para cada servidor em arquivos separados e use --defaultsco file quando instalar os servios para dizer para cada servidor que arquivo usar. Neste c caso, cada arquivo deve listar as opes usando um grupo [mysqld]. co Com esta abordagem, para especicar as opes para o mysqld-nt 4.0.8, crie um arco quivo C:\my-opts1.cnf que se parea com: c [mysqld] basedir = C:/mysql-4.0.8 port = 3307 enable-named-pipe socket = mypipe1 Para o mysqld-nt 4.0.17, crie um arquivo C:\my-opts2.cnf que se parea com: c [mysqld] basedir = C:/mysql-4.0.17 port = 3308

224

MySQL Technical Reference for Version 5.0.0-alpha

enable-named-pipe socket = mypipe2 Instale o servio como indicado a seguir (digite cada comando em uma unica linha): c shell> C:\mysql-4.0.8\bin\mysqld-nt --install mysqld1 --defaults-file=C:\my-opts1.cnf shell> C:\mysql-4.0.17\bin\mysqld-nt --install mysqld2 --defaults-file=C:\my-opts2.cnf Para usar uma opo --defaults-file quando instalar um servidor MySQL como um ca servio, voc deve anteceder a opo com o nome do servio. c e ca c Depois de instalarm, inicie e para os servios do mesmo modo que no exemplo anterior. c Para remover vrios servios, use mysqld --remove para cada um, especicando um nome a c de servio depois da opo --remove se o servio a ser removido tiver um nome difertente c ca c do padro. a

4.2.2 Executando M ltiplos Servidores no Unix u

O modo mais fcil de executar diversos servidores no Unix compil-los com diferentes a e a portas TCP/IP e arquivos socket, assim cada um est escutando em diferentes interfaces de a rede. Tambm, compilando em diferentes diretrios bases para instalao, que automaticae o ca mente resulta em diferentes localizaes de diretrios de dados, arquivos log e arquivos PID co o para cada um dos seus servidores. Considere que um servidor existente est congurado para a porta e arquivo socket padres. a o Para congurar um novo servidor para ter parmetros operacionais diferentes, use um coa mando configure assim: shell> ./configure --with-tcp-port=port_number \ --with-unix-socket-path=nome_arquivo \ --prefix=/usr/local/mysql-4.0.17 Aqui nmero_porta e nome_arquivo deve ser diferente que o nmero da porta e o caminho u u do arquivo socket padres e o valor --prefix deve especicar um diretrio de instalao o o ca diferente daquele usado pelo servidor existente. Voc pode conferir o socket usado por qualquer servidor MySQL em execuo com este e ca comando: Se voc tem um servidor MySQL escutando em uma porta dada, voc pode usar o seguinte e e comando para descobrir quaie parmetros operacionais ele est usando para diversas a a variveis importantes congurveis, inclu a a indo o diretrio base e o nome do socket: o shell> mysqladmin --host=host_name --port=port_number variables Com a informao exibida por aquele comando, voc pode dizer quais valores de opo no ca e ca a usar ao congurar um servidor adicional. Note que se voc especicar localhost como o nome da mquina, mysqladmin ir por e a a padro usar uma conexo sockets Unix em vez de TCP/IP. No MySQL 4.1 voc tambm a a e e pode especicar o protocolo a ser usado com a opo --protocol={TCP | SOCKET | PIPE | ca MEMORY}.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

225

No necessrio compilar um novo servidor MySQL apenas para iniciar com uma arquivo a e a socket ou nmero de porta TCP/IP diferentes. Tambm poss especicar estes valores u e e ivel em tempo de execuo. Um modo de faz-lo usando as opes de linha de comando: ca e e co shell> /path/to/mysqld_safe --socket=file_name --port=port_number Para usar outro diretrio de banco de dados para o segundo servidor, passe uma opo o ca --datadir=caminho para o mysqld_safe. Um outro modo de conseguir este efeito usar as variveis de ambiente para congurar o e a nome do socket e o nmero da porta: u shell> shell> shell> shell> shell> MYSQL_UNIX_PORT=/tmp/mysqld-new.sock MYSQL_TCP_PORT=3307 export MYSQL_UNIX_PORT MYSQL_TCP_PORT scripts/mysql_install_db bin/mysqld_safe &

Este um modo rpido para iniciar um segundo servidor para teste. O bom deste mtodo e a e e que a congurao das variveis de ambiente se aplicaro a qualquer programa cliente que ca a a voc chame da shell acima. Assim, as conexes para estes clientes sero automaticamente e o a direcionadas para o segundo servidor! Apndice F [Variveis de ambiente], Pgina 1092 inclue uma lista de outras variveis de e a a a ambiente que voc pode usar e que afetam o mysqld. e Para a execuo automatica do servidor, seu script de inicializao que executado no ca ca e tempo de boot deve executar o seguinte comando uma vez para cada servidor com um caminmho apropriado do arquivo de opo para cada comando: ca mysqld_safe --defaults-file=path-to-option-file Cada arquivo de opo deve conter valores espec ca icos para um dados servidor. No Unix, o script mysqld_multi outro modo de de iniciar vrios servidores. e a Seo 4.8.3 [mysqld_multi], Pgina 333. ca a Veja

4.2.3 Usando Programas Clientes em um Ambiente MultiServidor

Quando voc quiser conectar com um programa cliente a um servidor MySQL que est e a escutando diferentes interfaces de rede em vez daquelas compiladas em seu programa cliente, voc pode conectar usando um dos seguintes mtodos: e e Inicie o cliente com --host=nome_mquina --port=nmero_porta para conectar com a u TCP/IP a uma mquina remota, ou com --host=localhost --socket=nome_arquivo a para conectar a mquina local via um socket Unix ou um named pipe do Windowes. a No MySQL 4.1, inicie o cliente com --protocol=tcp para conectar via TCP/IP, -protocol=socket para conectar via socket Unix ou --protocol=pipe para conectar via named pipe, ou --protocol=memory para conectar via memria compartilhada. o Para conexes TCP/IP, voc tambm pode precisar especicar as opes --host e o e e co --port. Para outros tipos de conexes, voc pode precisar especicar uma opo o e ca --socket para denir um nome de socket ou named pipe name, ou uma opo -ca shared-memory-base-name para especicar o nome da memria compartilhada. o

226

MySQL Technical Reference for Version 5.0.0-alpha

No Unix, congure as variveis de ambiente MYSQL_UNIX_PORT e MYSQL_TCP_PORT para a apontar para o socket Unix e porta TCP/IP antes de iniciar seus clientes. Se voc e normalmente utiliza uma porta ou socket espec ico, voc pode colocar os comandos e para congurar as variveis de ambiente no arquivo .login, assim eles sero aplia a cados sempre quer voc logar no sistema. Veja Apndice F [Environment variables], e e Pgina 1092. a Especique o socket e porta TCP/IP padres no grupo [clients] de um arquivo de o opes. Por exemplo, voc pode usar C:\my.cnf no WIndows ou o arquivo .my.cnf co e em seu diretrio home no Unix. Veja Seo 4.1.2 [Option les], Pgina 216. o ca a Em um programa C, voc pode especicar os argumentos de porta ou socket na e chamada de mysql_real_connect(). Voc tambm pode ter o programa lendo de um e e arquivo de opes chamando mysql_options(). Veja Seo 12.1.3 [C API functions], co ca Pgina 783. a Se voc estiver usando o mdulo Perl DBD::mysql voc pode ler as opes dos arquivos e o e co de opes do MySQL. Por exemplo: co $dsn = "DBI:mysql:test;mysql_read_default_group=client;" . "mysql_read_default_file=/usr/local/mysql/data/my.cnf"; $dbh = DBI->connect($dsn, $user, $password); Veja Seo 12.5.2 [Perl DBI Class], Pgina 881. ca a

4.3 Detalhes Gerais de Segurana e o Sistema de Privilgio c e de Acesso do MySQL

O MySQL tem um sistema de segurana/privilgios avanado mas no padro. A prxima c e c a a o seo descreve como ele funciona. ca

4.3.1 Segurana Geral c

Qualquer um usando o MySQL em um computador conectado ` internet deve ler esta seo a ca para evitar os erros de segurana mais comuns. c Discutindo segurana, ns enfatizamos a a necessidade de proteger completamente o servic o dor (no simplesmente o servidor MySQL) contra todos os tipos de ataques aplicveis: a a eavesdropping, altering, playback e denial of service. No cobriremos todos os aspectos de a disponibilidade e tolerncia a falhas aqui. a O MySQL utiliza a segurana baseado em Listas de Controle de Acesso (ACL) para todas c conexes, consultas e outras operaes que um usurio pode tentar realizar. Existe tambm o co a e algum suporte para conexes criptografadasSSL entre clientes MySQL e servidores. Vrios o a dos conceitos discutidos aqui no so espec a a icos do MySQL; as mesmas idias podem ser e aplicadas para a maioria das aplicaes. co Quando executando o MySQL, siga estes procedimentos sempre que poss ivel: nunca conceda a algum (exceto ao usurio root do mysql) acesso ` tabela user no e a a banco de dados mysql!. Isto perigoso. A senha criptografada a senha real no e e MySQL. Se voc conhece a senha listada na tabela user para um determinado usurio, e a voc pode facilmente logar como este usurio se tiver acesso ` mquina relacionada e a a a para aquela conta.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

227

Aprenda o sistema de controle de acessos do MySQL. Os comandos GRANT e REVOKE so usados para controlar o acesso ao MySQL. No conceda mais privilgios do que o a a e necessrio. Nunca conceda privilgios para todas as mquinas. a e a Checklist: Tente mysql -u root. Se voc conseguir conectar com sucesso ao servidor sem e a solicitao de uma senha, voc tem problemas. Qualquer um pode conectar ca e ao seu servidor MySQL como o usurio root com privilgios plenos! Revise as a e instrues de instalao do MySQL, prestando ateno particularmente ao item co ca ca sobre congurao da senha do usurio root. ca a Utilize o comando SHOW GRANTS e conra para ver quem tem acesso a o que. Remova aqueles privilgios que no so necessrios utilizando o comando REVOKE. e a a a No mantenha nenhuma senha de texto puro no seu banco de dados. Quando seu a computador ca comprometido, o intruso pode obter a lista completa de senhas e utiliz-las. Utilize a funo MD5(), SHA1() ou qualquer funo de embaralhamento de a ca ca via unica. No escolha senhas de dicionrios. Existem programas especiais para quebr-las. a a a Mesmo senhas como xsh98 no sao boas. Muito melhor seria duag98 que contm a e a mesma palavra sh mas digitada uma letra a esquerda em um teclado QWERTY convencional. Outro mtodo seria usar Mhall que obtido dos primeiros caracteres e e de cada palavra na frase Mary has a litle lamb. Isto fcil de lembrar e digitar, mas e a diculta que algum que no a conhea a advinhe. e a c Invista em um rewall. Ele protege voc de pelo menos 50% de todos os tipos de e exploits em qualquer software. Coloque o MySQL atrs do rewall ou em uma zona a desmilitarizada (DMZ). Checklist: Tente examinar suas portas da Internet utilizando alguma ferramenta como o nmap. O MySQL utiliza a porta 3306 por padro. Esta porta no deve ser acess a a ivel para mquinas no conveis. Outra maneira simples para conferir se sua porta a a a do MySQL est aberta ou no tentar o seguinte comando de alguma mquina a a e a remota, onde nome_mquina o nome da mquina ou o endereo IP de seu servidor a e a c MySQL: shell> telnet nome_mquina 3306 a Se voc obter uma conexo e alguns caracteres, a porta est aberta e deve ser e a a fechada no seu rewall ou roteador, a menos que voc realmente tenha uma boa e razo para mant-la aberta. Se o telnet apenas parar ou a conexo for recusada, a e a tudo est bem; a porta est bloqueada. a a No cone em nenhum dado inclu a idos pelos seus usurios. Eles podem tentar enganar a seu cdigo entrando com caracteres especiais ou sequencias de escape nos formulrios o a Web, URLS ou qualquer aplicao que voc construa. Tenha certeza que sua aplicao ca e ca continua segura se um usurio entrar com algo do tipo ; DROP DATABASE mysql;. a Este um exemplo extremo, mas grandes falhas de segurana ou perda de dados podem e c ocorrer como o resultado de hackers utilizando tcnicas similares, se voc no estiver e e a preparado para eles. Tambm lembre de conferir dados numricos. Um erro comum proteger somente as e e e strings. Em alguns casos as pessoas pensam que se um banco de dados contm somente e

228

MySQL Technical Reference for Version 5.0.0-alpha

dados dispon iveis publicamente, ele no precisa ser protegido. Isto no verdade. No a a e m inimo ataques do tipo denial-of-service podem ser feitos nestes bancos de dados. A maneira mais simples para proteger deste tipo de ataque usar apstrofos em torno e o das contantes numricas: SELECT * FROM tabela WHERE ID=234 em vez de SELECT * e FROM table WHERE ID=234. O MySQL automaticamente converte esta string para um nmero e corta todos os s u imbolos no-numricos dela. a e Checklist: Todas aplicaes Web: co Tente inserir e " em todos seus formulrios Web. Se voc obter qualquer a e tipo de erro do MySQL, investigue o problema imediatamente. Tente modicar qualquer URL dinmica adicionando %22 ("), %23 (#) e %27 a () na URL. Tente modicar os tipos de dados nas URLs dinmicas de numrico para a e caractere contendo caracteres dos exemplos anteriores. Sua aplicao deve ser ca segura contra estes ataques e similares. Tente inserir caracteres, espaos e s c imbolos especiais no lugar de nmero nos u campos numricos. Sua aplicao deve remov-los antes de pass-los para o e ca e a MySQL ou sua aplicao deve gerar um erro. Passar valores no vericados ca a ao MySQL extramente perigoso! e Conra o tamanho dos dados antes de pass-los ao MySQL. a Considere ter sua aplicao conectando ao banco de dados utilizando um ca usurio diferente doq ue o que utilizado com propsitos administrativos. a e o No fornea `s suas aplicaes mais privilgios de acesso do que elas necessia c a co e tam. Usurios do PHP: a Conra a funo addslashes(). No PHP 4.0.3, uma funo mysql_escape_ ca ca string() est dispon e baseada na funo com o mesmo nome da API a ivel e ca C do MySQL. Usurios do API C do MySQL: a Conra a chamada API mysql_escape_string(). Usurios do MySQL: a Conra os modicadores escape e quote para consultas streams. Usurios do Perl DBI: a e Conra o mtodo quote() ou utilize aspas simples ou duplas. Usurios do Java JDBC: a Utilize um objeto PreparedStatement e aspas simples ou duplas. No transmita dados sem criptograa na Internet. Estes dados so acess a a iveis para todos que tenham o tempo e habilidade para intercept-lo e us-lo para seu propsito a a o prprio. No lugar, utilize um protocolo de criptograa como o SSL ou SSH. O MySQL o suporta conexes SSL interno desde a verso 3.23.9. O repasse de portas do SSH pode o a ser usado para criar um tunel criptografado (e com compresso) para a comunicao. a ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

229

Aprenda a usar os utilitrios tcpdump e strings. Para a maioria dos casos voc a e pode conferir se o uxo de dados do MySQL est ou no criptografado utilizando um a a comando parecido com este: shell> tcpdump -l -i eth0 -w - src or dst port 3306 | strings (Isto funciona sobre Linux e deve funcionar com pequenas modicaes sob outros co sistemas.) Alerta: Se voc no ver dados no signica sempre que esteja criptografado. e a a Se voc necessita de alta segurana, voc deve consultar um especialista em segurana. e c e c

4.3.2 Como Tornar o MySQL Seguro contra Crackers

Quando voc conectar a um servidor MySQL, voc normalmente deve usar uma senha. A e e senha no transmitida em texto puro sobre a conexo, porm o algor a e a e itimo de criptograca no muito forte e com algum esforo um atacante engenhoso pode quebrar a senha se ele a e c conseguir capturar o trfego entre o cliente e o servidor. Se a conexo entre o cliente e o a a servidor passar por uma rede no convel, voc deve usar um tunnel SSH para criptografar a a e a comunicao. ca Todas outras informaes so transferidas como texto que podem ser lido por qualquer um co a que consiga ver a conexo. Se voc se preocupa com isto, voc pode usar o protocol de a e e compresso (No MySQL verso 3.22 e superiores) para tornar o trco muito mais dicil a a a de decifrar. Para deixar tudo ainda mais seguro voc deve usar ssh. Voc pode encontrar e e um cliente ssh open source em http://www.openssh.org, e um cliente ssh comercial em http://www.ssh.com. Com isto, voc pode obter uma conexo TCP/IP critografada entre e a um servidor MySQL e um cliente MySQL. Se voc estiver usando o MySQL 4.0, voc tambm pode usar o suporte interno OpenSSL e e e Veja Seo 4.4.10 [Conexes seguras], Pgina 268. ca o a Para deixar um sistema MySQL seguro, voc deve considerar as seguintes sugestes: e o Utilize senhas para todos os usurios MySQL. Lembre-se que qualquer um pode logar a como qualquer outra pessoa simplesmente com mysql -u outro_usurio nome_bd se a outro_usurio no tiver senha. Isto um procedimento comum com aplicaes a a e co cliente/servidor que o cliente pode especicar qualquer nome de usurio. Voc pode a e alterar a senha de todos seus usurios editando o script mysql_install_db antes de a execut-lo ou somente a senha para o usurio root do MySQL desta forma: a a shell> mysql -u root mysql mysql> UPDATE user SET Password=PASSWORD(nova_senha) -> WHERE user=root; mysql> FLUSH PRIVILEGES; No execute o daemon do MySQL como o usurio root do Unix. Isto muito perigoso, a a e porque qualquer usurio com privilgios FILE estar apto a criar arquivos como o root a e a (por exemplo, ~root/.bashrc). Para prevenir esta situao, mysqld ir recusar a ca a execuo como root a menos que ele seja especicado diretamente usando a opo ca ca --user=root. O mysqld pode ser executado como um usurio normal sem privilgios. Voc pode a e e tambm criar um novo usurio Unix mysql para tornar tudo mais seguro. Se voc e a e executar o mysqld como outro usurio Unix, voc no precisar alterar o usurio root a e a a a na tabela user, porque nomes de usurio do MySQL no tem nada a ver com nomes a a

230

MySQL Technical Reference for Version 5.0.0-alpha

de usurios Unix. Para iniciar o mysqld como outro usurio Unix, adicione uma linha a a user que especica o nome de usurio para o grupo [mysqld] do arquivo de opes a co /etc/my.cnf ou o arquivo de opes my.cnf no diretrio de dados do servidor. Por co o exemplo: [mysqld] user=mysql Estas opes conguram o servidor para iniciar como o usurio designado quando voc o co a e inicia manualmente ou usando mysqld_safe ou mysql.server. Para maiores detalhes, veja Seo A.3.2 [Changing MySQL user], Pgina 923. ca a No suportar links simblicos para tabelas (Isto pode ser desabilitado com a opo -a o ca skip-symlink. Isto muito importante caso voc execute o mysqld como root, assim e e qualquer um que tenha acesso ` escrita aos dados do diretrio do mysqld podem apagar a o qualquer arquivo no sistema! Veja Seo 5.6.1.2 [Symbolic links to tables], Pgina 466. ca a Verque se o usurio Unix que executa o mysqld o unico usurio com privilgios de a e a e leitura/escrita nos diretrios de bancos de dados. o No fornea o privilgio PROCESS para todos os usurios. A sa de mysqladmin a c e a ida processlits mostra as consultas atualmente em execuo, portanto qualquer usurio ca a que consiga executar este comando deve ser apto a ver se outro usurio entra com uma a consulta do tipo UPDATE user SET password=PASSWORD(n~o_seguro). a O mysqld reserva uma conexo extra para usurios que tenham o privilgio process, a a e portanto o usurio root do MySQL pode logar e vericar a atividade do servidor mesmo a se todas as conexes normais estiverem em uso. o No conceda o privilgio FILE a todos os usurios. Qualquer usurio que possua a e a a este privilgio pode gravar um arquivo em qualquer lugar no sistema de arquivos com e os privilgios do daemon mysqld! Para tornar isto um pouco mais seguro, todos os e arquivos gerados com SELECT ... INTO OUTFILE so lidos por todos, e no se pode a a sobrescrever arquivos existentes. O privilgio FILE pode tambm ser usado para ler qualquer arquivo acess para o e e ivel usurio Unix com o qual o servidor est sendo executado. Pode ocorrer abusos como, a a por exemplo, usar LOAD DATA para carregar o arquivo /etc/passwd em uma tabela, que pode ento ser lido com SELECT. a Se voc no cona em seu DNS, voc deve utilizar nmeros IP no lugar de nomes de e a e u mquinas nas tabelas de permisso. De qualquer forma, voc deve ter muito cuidado a a e ao criar entradas de concesso utilizando valores de nomes de mquinas que contenham a a metacaractes! Se voc deseja restrigir o nmero de conexes para um unico usurio, voc pode faze-lo e u o a e congurando a varivel max_user_connections no mysqld. a

4.3.3 Opes de Inicializao para o mysqld em Relao a co ca ca Segurana. c

As seguintes opes do mysqld afetam a segurana: co c --local-infile[=(0|1)] Se algum usa --local-infile=0 ento no de pode usar LOAD DATA LOCAL e a a INFILE.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

231

--safe-show-database Com esta opo, SHOW DATABASES retorna somente os bancos de dados nos quais ca o usurio tem algum tipo de privilgio. A partir da verso 4.0.2 esta opo est a e a ca a obsoleta e no faz nada (a opo est habilitada por padro) j que agora temos a ca a a a o privilgio SHOW DATABASES. Veja Seo 4.4.1 [GRANT], Pgina 254. e ca a --safe-user-create Se for habilitado, um usurio no consegue criar novos usurios com o comando a a a GRANT, se o usurio no tiver privilgio de INSERT na tabela mysql.user. Se a a e voc desejar fornecer a um usurio acesso para s criar novos usurios com e a o a privilgios que o usurio tenha direito a conceder, voc deve dar ao usurio o e a e a seguinte privilgio: e mysql> GRANT INSERT(user) ON mysql.user TO user@hostname; Isto ir assegurar que o usurio no poder alterar nenhuma coluna de a a a a privilgios diretamente, mas tem que usar o comando GRANT para conceder e direitos para outros usurios. a --skip-grant-tables Esta opo desabilita no servidor o uso do sistema de privilgios. Isto d a ca e a todos os usurios acesso total a todos os bancos de dados! (Voc pode dizer a a e um servidor em execuo para para uar as tabelas de permisses executando ca o mysqladmin flush-privileges ou mysqladmin reload.) --skip-name-resolve Nomes de mquinas no so resolvidos. Todos os valores da coluna Host nas a a a tabelas de permisses devem ser nmeros IP ou localhost. o u --skip-networking No permitir conexes TCP/IP sobre a rede. Todas as conexes para mysqld a o o em sistemas que devem ser feitas via Sockets Unix. Esta opo no possivel ca a e usam MIT-pthreads, porque o pacote MIT-pthreads no suporta sockets Unix. a --skip-show-database No permite o comando SHOW DATABASES, a menos que o usurio tenha o a a privilgio SHOW DATABASES. A partie da verso 4.0.2 voc no deve mais pree a e a cisar desta opo, j que o aceesso pode agora ser concedido especicamente ca a com o privilgio SHOW DATABASES. e

4.3.4 Detalhes de Segurana com LOAD DATA LOCAL c

No MySQL 3.23.49 e MySQL 4.0.2 (4.0.13 no Windows), adicionamos algumas novas opes co para lidar com possiveis detalhes de segurana junto ao LOAD DATA LOCAL. c Exstem dois problemas possiveis com o suporte a este comando: Como a leitura deste arquivo iniciada por um servidor, pode-se teoricamente criar um e servidor MySQL corrigido que poderia ler qualquer arquivo na mquina cliente na qual o a usurio atual tenha acesso, quando o cliente envia uma consulta a tabela. a Em um ambiente web onde os clientes esto conectados a um servidor web, um usurio a a poderia usar LOAD DATA LOCAL para ler qualquer arquivo no qual o processo do servidor web

232

MySQL Technical Reference for Version 5.0.0-alpha

tenha acesso de leitura (assumindo que um usurio poderia executar qualquer comando no a servidor SQL). Existem dois arquivos separados para isto: Se voc no congurar o MySQL com --enable-local-infile, ento LOAD DATA LOCAL e a a ser disabilitado por todos os clientes, a menos que se chame mysql_options(... MYSQL_ a OPT_LOCAL_INFILE, 0) no cliente. Veja Seo 12.1.3.40 [mysql_options()], Pgina 809. ca a Para o cliente de linha de comando mysql, LOAD DATA LOCAL pode ser habilitado especicado a opo --local-infile[=1], ou disabilitando com --local-infile=0. ca Por padro, todos os clientes e bibliotacas MySQL so compilados com --enable-locala a infile, para ser compat com o MySQL 3.23.48 e anterior. ivel Pode se desabilitar todos os comandos LOAD DATA LOCAL no servidor MySQL iniciando o mysqld com --local-infile=0. No caso em que LOAD DATA LOCAL INFILE est disabilitado no servidor ou no cliente, voc a e receber a seguinte mensagem de erro (1148): a The used command is not allowed with this MySQL version

4.3.5 O Que o Sistema de Privilgios Faz e

A funo primria do sistema de privilgios do MySQL autenticar um usurio a partir de ca a e e a uma determinada mquina e associar este usurio com privilgios a banco de dados como a a e como select, insert, update e delete. Funcionalidades adicionais incluem a habilidade de ter um usurio annimo e conceder a o privilgio para funes espec e co icas do MySQL como em LOAD DATA INFILE e operaes adco ministrativas.

4.3.6 Como o Sistema de Privilgios Funciona e

O sistema de privilgios do MySQL garante que todos usurios possam fazer exatamente as e a operaes que lhe permitido. Quando voc conecta a um servidor MySQL, sua identidade co e e e determinada pela maquina de onde voc conectou e o nome de usurio que voc especicou. e a e O sistema concede privilgios de acordo com sua identidade e com o que voc deseja fazer. e e O MySQL considera tanto os nomes de mquinas como os nomes de usurios porque existem a a poucas razes para assumir que um determinado nome de usurio pertence a mesma pessoa o a em todo lugar na Internet. Por exemplo, o usurio bill que conecta de whitehouse.gov no a a deve necessariamente ser a mesma pessoa que o usurio bill que conecta da microsoft.com a O MySQL lida com isto, permitindo a distino de usurios em diferentes mquinas que ca a a podem ter o mesmo nome: Voc pode conceder a bill um conjunto de privilgios para e e conexes de whitehouse.gov e um conjunto diferente de privilgios para conexes de o e o microsoft.com. O controle de acesso do MySQL composto de dois estgios: e a Estgio 1: O servidor confere se voc pode ter acesso ou no. a e a Estgio 2: Assumindo que voc pode conectar, o servidor verica cada requisio feita a e ca para saber se voc tem ou no privilgios sucientes para realizar a operao. Por e a e ca exemplo, se voc tentar selecionar linha de uma tabela em um banco de dados ou e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

233

apagar uma tabela do banco de dados, o servidor se certica que voc tem o privilgio e e select para a tabela ou o privilgio drop para o banco de dados. e Note que se os seus privilgios so alterados (tanto por voc quanto por outro) enquanto e a e voc est conectado, estas alteraes no iro necessariamente ter efeito com a sus prxima e a co a a o consulta ou consultas. Veja Seo 4.4.3 [Privilege changes], Pgina 260 para maiores detalca a hes. O servidor utiliza as tabelas user, db e host no banco de dados mysql em ambos estgios a do controle de acesso. Os campos nestas tabelas de permisso so detalhados abaixo: a a Nome da Tabela user db host Campos Escopo Campos Privilgio e de Host User Password Select_priv Insert_priv Update_priv Delete_priv Index_priv Alter_priv Create_priv Drop_priv Grant_priv References_ priv Reload_priv Shutdown_ priv Process_priv File_priv Show_db_priv Super_priv Create_tmp_ table_priv Lock_tables_ priv Execute_priv Repl_slave_ priv Repl_client_ priv ssl_type ssl_cypher x509_issuer x509_cubject max_ questions Host Db User Select_priv Insert_priv Update_priv Delete_priv Index_priv Alter_priv Create_priv Drop_priv Grant_priv References_ priv Host Db Select_priv Insert_priv Update_priv Delete_priv Index_priv Alter_priv Create_priv Drop_priv Grant_priv References_ priv

de

Create_tmp_ table_priv Lock_tables_ priv

Create_tmp_ table_priv Lock_tables_ priv

234

MySQL Technical Reference for Version 5.0.0-alpha

max_updates max_ connections No segundo estgio do controle de acesso (vericao da solicitao), o servidor pode, se a a ca ca solicitao involver tabelas, consultar adicionalmente as tabelas tables_priv e columns_ ca priv. Os campos nestas tabelas so mostrados abaixo: a Nome da tabela Campos escopop de tables_priv Host Db User Table_name de Table_priv Column_priv Timestamp Grantor columns_priv Host Db User Table_name Column_name Column_priv Timestamp

Campos privilgio e Outros campos

Cada tabela de permisses contm campos de escopo e campos de privilgios. o e e Campos de escopo determinam o escopo de cada entrada nas tabelas, isto , o contexto e no qual a entrada se aplica. Por exemplo, uma entrada na tabela user com valores Host e User de thomas.loc.gov e bob devem ser usados para autenticar conexes feitas o ao servidor por bob da mquina thomas.loc.gov. De maneira similar, uma entrada na a tabela db com campos Host, User e Db de thomas.loc.gov, bob e reports devem ser usados quando bob conecta da mquina thomas.loc.gov para acessar o banco de dados a reports. As tabelas tables_priv e columns_priv contem campos de escopo indicando as combinaes de tabelas ou tabela/coluna para o qual cada entrada se aplica. co Para propsitos de vericao de acessos, comparaes de valores Host so caso insensitivo, o ca co a valores User, Password, Db e Table_name so caso sensitivo. Valores Column_name so caso a a insensitivo no MySQL verso 3.22.12 ou posterior. a Campos de privilgios indicam os privilgios concedidos por uma entrada na tabela, isto , e e e quais operaes podem ser realizadas. O servidor combina as informaes de vrias tabelas co co a de concesso para formar uma descrio completa dos privilgios de um usurio. As regras a ca e a usadas para fazer isto so descritas em Seo 4.3.10 [Request access], Pgina 242. a ca a Campos de escopo so strings, declaradas como mostrado abaixo; os valores padro para a a cada a string vazia: e Nome do Campo Host User Password Db Table_name Column_name Tipo CHAR(60) CHAR(16) CHAR(16) CHAR(64) CHAR(60) CHAR(60)

(CHAR(60) para as tabelas tables_priv e columns_ priv)

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

235

Nas tabelas user, db e host, todos campos de privilgios so declarados como e a ENUM(N,Y) cada um pode ter um valor de N ou Y e o valor padro N. a e Nas tabelas tables_ e columns_priv, os campos de privilgios so declarados como campos e a SET: Nome de Nome do Poss iveis elementos do conjunto tabela campo tables_priv Table_ Select, Insert, Update, Delete, priv Create, Drop, Grant, References, Index, Alter tables_priv Column_ Select, Insert, Update, priv References columns_ Column_ Select, Insert, Update, priv priv References De maneira resumida, o servidor utiliza as tabelas de permisses desta forma: o Os campos de escopo da tabela user determinam quando permitir ou aceitar conexes. o Para conexes permitidas, qualquer privilgio concedido em uma tabela user indica o e o privilgio global (superusurio) do usurio. Estes privilgios se aplicam a todos os e a a e bancos de dados no servidor. As tabelas db e host so usadas juntas: a Os campos de escopo da tabela db determinam quais usurios podem acessar dea terminados bancos de dados de mquinas determinadas. Os campos de privilgios a e determinam quais operaes so permitidas. co a A tabela host usada como uma extenso da tabela db quando voc quer que e a e uma certa entrada na tabela db seja aplicada a diversas mquinas. Por exemplo, a se voc deseja que um usurio esteja apto a usar um banco de dados a partir de e a diversas mquinas em sua rede, deixe o campo Host vazio no registro da tabela a db, ento popule a tabela Host com uma entrada para cada uma das mquinas. a a Este mecanismo descrito com mais detalhes em Seo 4.3.10 [Request access], e ca Pgina 242. a As tabelas tables_priv e columns_priv so similares ` tabela db, porm so mais a a e a nas: Elas se aplicam ao nivel de tabelas e colunas em vez do nivel dos bancos de dados. Perceba que os privilgios administrativos (RELOAD, SHUTDOWN e etc) so especicados soe a mente na tabela user. Isto ocorre porque operaes administrativas so operaes no co a co prprio servidor e no so espec o a a icas e no espec a icas dos bancos de dados, portanto no a existe razo para listar tais privilgios nas outras tabelas de permisso. De fato, somente a e a a tabela user necessita ser consultada para determinar se voc pode ou no realizar uma e a operao administrativa. ca O privilgio FILE tambm s especicado na tabela user. Ele no um privilgio ade e oe a e e ministrativo, mas sua habilidade para ler ou escrever arquivo no servidor independtende e do banco de dados que voc est acessando. e a O servidor mysqld le o contedo das tabelas de permisses uma vez, quando iniciado. u o e Alteraes nas tabelas de permisses tem efeito como indicado em Seo 4.4.3 [Alterao de co o ca c privilgios], Pgina 260. e a

236

MySQL Technical Reference for Version 5.0.0-alpha

Quando voc modica o contedo das tabelas de permisses, uma boa idia ter certeza que e u o e e suas alteraes conguraram os privilgios da forma desejada. Para ajuda no diagnostico de co e problemas, veja Seo 4.3.12 [Access denied], Pgina 250. Para conselhos sobre asssuntos ca a de segurana, Veja Seo 4.3.2 [Security], Pgina 229. c ca a Uma ferramenta de diagnstico util o script mysqlaccess, que Yves Carlier fornece na o e distribuio MySQL. Chame mysqlaccess com a opo --help para descobrir como ele ca ca funciona. Perceba que o mysqlaccess confere o acesso usando somente as tabelas user, db e host. Ele no confere privilgios no n de tabelas ou colunas. a e ivel

4.3.7 Privilgios Fornecidos pelo MySQL e

Informaes sobre privilgios de usurios so armazenados nas tabelas user, db, host, co e a a tables_priv e columns_priv no banco de dados chamado mysql. O servidor MySQL l o e contedo destas tabelas quando ele inicia e sob as circunstncias indicadas em Seo 4.4.3 u a ca [Privilege changes], Pgina 260. a Os nomes usados neste manual que se referem-se aos privilgios fornecidos pelo MySQL e so vistos abaixo juntos com o nome da coluna associada com cada privilgio nas tabelas a e de permisso e o contexto em que o privilgio se aplica. Informaes adicionais sobre o a e co signicado de cada privilgio pode ser encontrado em Seo 4.4.1 [GRANT], Pgina 254. e ca a Privilgio e ALTER DELETE INDEX INSERT SELECT UPDATE CREATE DROP GRANT REFERENCES CREATE TEMPORARY TABLES EXECUTE FILE LOCK TABLES PROCESS RELOAD REPLICATION CLIENT REPLICATION SLAVE SHOW DATABASES Coluna Alter_priv Delete_priv Index_priv Insert_priv Select_priv Update_priv Create_priv Drop_priv Grant_priv References_ priv Create_tmp_ tabela_priv Execute_priv File_priv Lock_ tabelas_priv Process_priv Reload_priv Repl_client_ priv Repl_slave_ priv Show_db_priv Contexto tabelas tabelas tabelas tabelas tabelas tabelas banco de dados, tabelas, ou indices banco de dados ou tabelas banco de dados ou tabelas banco de dados ou tabelas administrao do servidor ca administrao do servidor ca acessa a arquivos no servidor administrao do servidor ca administrao do servidor ca administrao do servidor ca administrao do servidor ca administrao do servidor ca administrao do servidor ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

237

SHUTDOWN SUPER

Shutdown_ priv Super_priv

administrao do servidor ca administrao do servidor ca

Os privilegios SELECT, INSERT, UPDATE e DELETE permitem realizar operaes em registros a co nas tabelas existentes em um banco de dados. Instrues SELECT necessitam do privilgio select somente se ele precisar recuperar registros co e de uma tabela. Voc pode executar certas instrues SELECT mesmo sem permisso para e co a acessar algum dos bancos de dados no servidor. Por exemplo, voc pode usar o cliente e mysql como uma simples calculadora: mysql> SELECT 1+1; mysql> SELECT PI()*2; O privilgio INDEX permite a criao ou remoo de e ca ca indices. O privilgio ALTER permite utilizar ALTER TABLE. e Os privilgios CREATE e DROP permitem a criao de novos bancos de dados e tabelas, ou a e ca remoo de bancos de dados e tabelas existentes. ca Perceba que se for concedido o privilgio DROP no banco de dados mysql para algum usurio, e a este usurio pode remover o banco de dados no qual os privilgios de acesso do MySQL a e esto armazenados! a O privilgio GRANT permite a voc fornecer a outros usurios os privilgios que voc mesmo e e a e e possui. O privilgio FILE fornece permisso para ler e escrever arquivos no servidor usando ine a strues LOAD DATA INFILE e SELECT ... INTO OUTFILE. Qualquer usurio que tenha este co a privilgio pode ler ou gravar qualquer arquivo que o servidor MySQL possa ler ou escrever. e O usurio tambm pode ler qualquer arquivo no diretrio de banco de dados atual. O a e o usurio no pode, no entanto, alterar qualquer arquivo existente. a a Os privilgios restantes so usados para operaes administrativas, que so realizadas utie a co a lizando o programa mysqladmin. A tabela abaixo mostra quais comandos do mysqladmin cada privilgio administrativos permite a execuo: e ca Privilgio e RELOAD SHUTDOWN PROCESS SUPER Comandos permitidos reload, refresh, flush-privileges, flush-hosts, flushlogs, and flush-tables shutdown processlist kill

O comando reload diz ao servidor para recarregar as tabelas de permisses. O comando o refresh descarrega todas as tabelas e abre e fecha os arquivos de log. flush-privileges um sinnimo para reload. Os outros comandos flush-* realizam funes similares ao e o co refresh mas so mais limitados no escopo e podem ser prefer a iveis em alguns casos. Por exemplo, se voc deseja descarregar apenas os arquivos log, flush-logs uma melhor e e escolha do que refresh. O comando shutdown desliga o servidor. O comando processlist mostra informaes sobre as threads em execuo no servidor. co ca O comando kill mata threads no servidor. Voc sempre poder mostrar ou matar suas e a

238

MySQL Technical Reference for Version 5.0.0-alpha

prprias threads, mas voc precisa do privilgio PROCESS para mostrar e privilgio SUPER o e e e para matar threads iniciadas por outros usurios. Veja Seo 4.6.7 [KILL], Pgina 301. a ca a E uma boa idia em geral conceder privilgios somente para aqueles usurios que necessitem e e a deles, mas voc deve ter muito cuidado ao conceder certos privilgios: e e O privilgio grant permite aos usurios repassarem seus privilgios a outros usurios. e a e a Dois usurios com diferentes privilgios e com o privilgio grant conseguem combinar a e e seus privilgios. e O privilgio alter pode ser usado para subverter o sistema de privilgios renomeando e e as tabelas. O privilgio FILE pode ser usado com abuso para ler qualquer arquivo de leitura no e servidor em uma tabela de banco de dados, o contedo pode ser acessando utilizando u SELECT. Isto inclui o contedo de todos os bancos de dados hospedados pelo servidor! u O privilgio SHUTDOWN pode ser utilizado para negar inteiramente servios para oturos e c usurios, terminando o servidor. a O privilgio PROCESS pode ser usado para ver o texto das consultas atualmente em e execuo, incluindo as consultas que conguram ou alteram senhas. ca Privilgios no banco de dados mysql pode ser utilizado para alterar senhas e outras e informaes de privilgio de acesso. (Senhas so armazenadas criptografadas, portanto co e a um usurio malicioso no pode simplesmente l-las para saber as senhas em texto puro). a a e Se fosse poss acessar a coluna password do banco mysql.user, seria poss logar ivel ivel ao servidor MySQL como outro usurio. (Com privilgios sucientes, o mesmo usurio a e a pode trocar a senha por outra diferente.) Existema algumas coisas que voc no pode fazer com o sistem de privilgios do MySQL: e a e Voc no pode especicar explicitamente que um determinado usurio deve ter acesso e a a negado. Voc no pode explicitamente comparar um usurio e depois recusar sua e a a conexo. a Voc no pode especicar que um usurio tenha privilgios para criar ou remover e a a e tabelas em um banco de dados, mas no possa criar ou remover o banco de dados. a

4.3.8 Conectando ao Servidor MySQL

Programas clientes do MySQL geralmente necessitam de parmetros de conexo quando a a voc precisar acessar um servidor MySQL: a mquina na qual voc deseja se conectar, seu e a e nome de usurio e sua senha. Por exemplo, o cliente mysql pode ser iniciado desta forma a (argumentos opcionais so colocandos entre [ e ]): a shell> mysql [-h nome_mquina] [-u nome_usurio] [-psua_senha] a a Formas alternativas das opes -h, -u e -p so --host=nome_mquina, --user=nome_ co a a usurio e --password=sua_senha. Perceba que no existe espao entre -p ou --password= a a c e a senha que deve vir a seguir. NOTA: Especicar a senha na linha de comando no seguro! Qualquer usurio no seus a e a sistema pode saber sua senha digitando um comando do tipo: ps auxww. Veja Seo 4.1.2 ca [Option les], Pgina 216. a O mysql utiliza valores padro para parmetros de conexo que no so passados pela linha a a a a a de comando:

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

239

O nome padro da mquina (hostname) localhost. a a e O nome de usurio padro o mesmo nome do seu usurio no Unix. a a e a Nenhuma senha fornecida se faltar o parmetro -p. e a Ento, para um usurio Unix joe, os seguintes comandos so equivalentes: a a a shell> shell> shell> shell> mysql -h localhost -u joe mysql -h localhost mysql -u joe mysql

Outros clientes MySQL comportam-se de forma similar. Em sistemas Unix, voc pode especicar valores padres diferentes para serem usados e o quendo voc faz uma conexo, assim voc no precisa digit-los na linha de comando sempre e a e a a que chamar o programa cliente. Isto pode ser feito de vrias maneiras: a Podem ser especicados parmetros de conexo na seo [client] do arquivo de cona a ca gurao .my.cnf no seu diretrio home. A seo relevante do arquivo deve se parecer ca o ca com isto: [client] host=nome_mquina a user=nome_usurio a password=senha_usurio a Veja Seo 4.1.2 [Option les], Pgina 216. ca a Voc pode especicar parmetros de conexo utilizando variveis de ambiente. O nome e a a a de mquina pode ser especicado para o mysql utilizando a varivel MYSQL_HOST. O a a nome do usurio MySQL pode ser especicado utilizando USER (isto somente para a e Windows). A senha pode ser especicada utilizando MYSQL_PWD (mas isto no seguro; a e veja a prxima seo). Veja Apndice F [Variveis de ambiente], Pgina 1092. o ca e a a

4.3.9 Controle de Acesso, Estgio 1: Vericao da Conexo a ca a

Quando voc tenta se conectar a um servidor MySQL, o servidor aceita ou rejeita a conexo e a baseado na sua identidade e se pode ou no vericar sua identidade fornecendo a senha a correta. Seno, o servidor nega o acesso a voc completamente. De outra forma, o servidor a e aceita a conexo, entra no estgio 2 e espera por requisiies. a a co Sua identidade baseada em duas partes de informao: e ca A mquina de onde est conectando a a Seu nome de usurio no MySQL a A conferncia da identidade feita utilizando os tres campos de escopo da tabela user e e (Host, User e Password). O servidor aceita a conexo somente se uma entrada na tabela a user coincidir com a mquina, nome de usurio e a senha fornecidos. a a Valores dos campos escopo na tabela user podem ser especicados como segue: Um valor Host deve ser um nome de mquina ou um nmero IP ou localhost para a u indicar a mquina local. a Voc pode utilizar os metacaracteres % e _ no campo Host. e

240

MySQL Technical Reference for Version 5.0.0-alpha

Um valor Host de % coincide com qualquer nome de mquina. a Um valor Host em branco signica que o privilgio deve ser adicionado com a entrada e na tabela host que coincide com o nome de mquina fornecido. Voc pode encontrar a e mais informaes sobre isto no prximo cap co o itulo. Como no MySQL Verso 3.23, para valores Host especicados como nmeros IP, voc a u e pode especicar uma mscara de rede indicando quantos bits de endereo sero usados a c a para o nmero da rede. Por exemplo: u mysql> GRANT ALL PRIVILEGES ON db.* -> TO david@192.58.197.0/255.255.255.0; Isto permitir que todos a se conectarem a partir de determinado IP cuja condio a ca seguinte seja verdadeira: IP_usurio & mscara_rede = ip_maquina. a a No exemplo acima todos IPs no Intervalo 192.58.197.0 - 192.58.197.255 podem se conectar ao servidor MySQL. Metacaracteres no so permitidos no campo User, mas voc pode especicar um valor a a e em branco, que combina com qualquer nome. Se a entrada na tabela user que casa com uma nova conexo tem o nome do usurio em branco, o usurio considerado como a a a e um usurio annimo (o usurio sem nome), em vez do nome que o cliente especicou. a o a Isto signica que um nome de usurio em branco usado para todos as vericaes de a e co acessos durante a conexo. (Isto , durante o estgio 2). a e a O campo Password pode car em branco. O que no signica que qualquer senha possa a ser usada, signica que o usurio deve conectar sem especicar uma senha. a Valores de Password que no esto em branco so apresentados como senhas criptografadas. a a a O MySQL no armazena senhas na forma de texto puro para qualquer um ver. Em vez disso, a a senha fornecida por um usurio que est tentando se conectar criptografada (utilizando a a a e funo PASSWORD()). A senha criptografada ento usada quando o cliente/servidor estiver ca e a conferindo se a senha correta (Isto feito sem a senha criptografada sempre trafegando e e sobre a conexo.) Perceba que do ponto de vista do MySQL a senha criptografada a a e senha REAL, portanto voc no deve pass-la para ningum! Em particular, no fornea e a a e a c a usurios normais acesso de leitura para as tabelas no banco de dados mysql! A partir a da verso 4.1, o MySQL emprega um mecanismo de senha e login diferente que seguro a e mesmo se zerem um sni nos pacotes TCP/IP e/ou o banco de dados mysql capturado. e Os exemplos abaixo mostram vrias combinaes de valores de Host e User nos registros a co da tabela user aplicando a novas conexes: o Valor em host thomas.loc.gov % % %.loc.gov Valor user fred fred em Conexes casadas com o registro o Qualquer usurio, a conectando de thomas.loc.gov fred, conectando a partir de qualquer mquina a Qualquer usurio, conectando a partir de a qualquer mquina a fred, conectando de qualquer mquina do a dom inio loc.gov

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

241

fred, conectando de x.y.net, x.y.com,x.y.edu, etc. (Isto provavelmente no util) a e 144.155.166.177 fred fred, conectando da mquina com ena dereo IP 144.155.166.177 c 144.155.166.% fred fred, conectando de qualquer mquina na a subrede de classe C 144.155.166 144.155.166.0/255.255.255.0 fred o mesmo que no exemplo anterior Como voc pode usar valores coringas de IP no campo Host (por exemplo, 144.155.166.% e combina com todas mquinas em uma subrede), existe a possibilidade que algum possa a e tentar explorar esta capacidade nomeando a mquina como 144.155.166.algumlugar.com. a Para evitar tais tentativas, O MySQL desabilita a combinao com nomes de mquina ca a que iniciam com digitos e um ponto. Portanto se voc possui uma mquina nomeada e a como 1.2.foo.com, este nome nunca ir combinar com uma coluna Host das tabelas de a permisses. Somente um nmero IP pode combinar com um valor coringa de IP. o u Uma conexo de entrada pode coincidir com mais de uma entrada na tabela user. Por a exemplo, uma conexo a partir de thomas.loc.gov pelo usurio fred pode combinar com a a diversas das entradas vistas na tabela anterior. Como o servidor escolhe qual entrada usar se mais de uma coincide? O servidor resolve esta questo ordenando a tabela user no a tempo de inicializao, depois procura pelas entradas na ordem da classicao quando um ca ca usurio tenta se conectar. A primeira entrada que coincidir a que ser usada. a e a A ordenao da tabela user funciona da forma mostrada a seguir. Suponha que a tabela ca user se parea com isto: c +-----------+----------+| Host | User | ... +-----------+----------+| % | root | ... | % | jeffrey | ... | localhost | root | ... | localhost | | ... +-----------+----------+Quando o servidor l a tabela, ele ordena as entradas com os valores mais espec e icos de Host primeiro (% na coluna Host signica qualquer mquina e menos espec a e ico). Entradas com o mesmo valor Host so ordenadas com os valores mais espec a icos de User primeiro (um valor em branco na coluna User signica qualquer usurio e menos espec a e ico). O resultado da tabela user ordenada caria assim: +-----------+----------+| Host | User | ... +-----------+----------+| localhost | root | ... | localhost | | ... | % | jeffrey | ... | % | root | ... +-----------+----------+Quando uma conexo iniciada, o servidor procura entre as entradas ordenadas e utiliza a a e primeira entrada coincidente. Para uma conexo a partir de localhost feito por jeffrey, a

x.y.%

fred

242

MySQL Technical Reference for Version 5.0.0-alpha

as entradas com localhost na coluna Host coincide primeiro. Destas, a entrada com o nome do usurio em branco combina com o nome da mquina e o nome do usurio. (A a a a entrada %/jeffrey tambm casaria, mas ela no a primeira entrada coincidente na e a e tabela. Aqui est outro exemplo. Suponha que a tabela user fosse assim: a +----------------+----------+| Host | User | ... +----------------+----------+| % | jeffrey | ... | thomas.loc.gov | | ... +----------------+----------+A tabela ordenada pareceria com isto: +----------------+----------+| Host | User | ... +----------------+----------+| thomas.loc.gov | | ... | % | jeffrey | ... +----------------+----------+Uma conexo a partir de thomas.loc.gov feita por jeffrey coincide com a primeira ena trada, no entanto, uma conexo de whitehouse.gov fetia por jeffrey coincidiria com a a segunda entrada na tabela. Um erro comum pensar que para um determinado usurio, todas as entradas que citam e a explicitamente este usurio sero usadas primeiro quando o usurio tentar encontrar uma a a a combinao para a conexo. Simplesmente isto no verdade. O exemplo anterior ilustra ca a a e isto, onde uma conexo de thomas.loc.gov feita por jeffrey combina primeiro no com a a a entrada contendo jeffrey no valor do campo user, mas sim pela entrada sem o nome de usurio! a Se voc tiver problemas conectando ao servidor, imprima a tabela user e ordene-a na e manualmente para ver onde se deu o primeiro coincidncia de valores. Se a conexo obtiver e a sucesso mas os seus privilgios no so os esperados, voc pode usar a funo CURRENT_ e a a e ca USER() (nova na verso 4.0.6) para ver com qual combinao usurio/mquina a sua conexo a ca a a a coincide. Veja Seo 6.3.6.2 [CURRENT_USER()], Pgina 547. ca a

4.3.10 Controle de Acesso, Estgio 2: Vericao da Requisio a ca ca

Uma vez estabelecida uma conexo, o servidor entra no 2o estgio. Para cada requisio a a ca que vem na conexo, o servidor verica se voc tem privilgios sucientes para realiz-la, a e e a baseado nas operaes que voc deseja fazer. E aqui que os campos de concesses nas tabelas co e o de permisses entram em ao. Estes privilgios pode vir de qualquer uma das tabelas user, o ca e db, host, tables_priv ou columns_priv. As tabelas de permisses so manipuladas com o a os comandos GRANT e REVOKE. Veja Seo 4.4.1 [GRANT], Pgina 254. (Voc pode achar util ca a e fazer referencia a Seo 4.3.6 [Privileges], Pgina 232, que lista os campos presentes em ca a cada uma das tabelas de permisses.) o A tabela user concede privilgios que so especicados por voc em uma base global e que e a e se aplicam sem importar qual o banco de dados atual. Por exemplo, se a tabela user e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

243

concede a algum o privilgio delete, este usurio pode apagar linhas de qualquer banco e e a de dados no servidor! Em outras palavras, privilgios na tabela user so privilgios de e a e superusurio. O correto conceder privilgios na tabela user apenas para superusurios a e e a tais como os administradores de servidor ou de bancos de dados. Para outros usurios, a voc deve deixar os privilgios na tabela user congurados para N e conceder privilgios e e e somente em bancos de dados espec icos, utilizando as tabelas db e host. As tabelas db e host concedem privilgios para bancos de dados espec e icos. Valores nos campos de escopo podem ser especicados como a seguir: Os metacaracteres % e _ podem ser usados nos campos Host e Db de ambas tabelas. Se voc deseja usar um caracter _ como parte de um nome de banco de dados, especiquee o como \_ no comando GRANT. O valor % em Host na tabela db signica qualquer mquina. Um valor em branco a em Host na tabela db signica consulte a tabela host para informao adicional. ca O valor % ou em branco no campo Host na tabela host signica qualquer mquina. a O valor % ou em branco no campo Db de ambas as tabelas signica qualquer banco de dados. O valor em branco no campo User em ambas tabelas coincide com o usurio annimo. a o As tabelas db e host so lidas e ordenadas quando o servidor inicia (ao mesmo tempo que a ele l a tabela user). A tabela db ordenada nos campos de escopo Host, Db e User e a e e tabela host ordenada nos campos de escopo Host e Db. Assim como na tabela user, a e ordenao coloca os valores mais espec ca icos no in e os menos espec icio icos por ultimo, e quando o servidor procura por entradas coincidentes, ele usa a primeira combinao que ca encontrar. As tabelas tables_priv e columns_priv concedem privilgios espec e icos para tabelas e campos. Valores nos campos escopo podem ser especicados como a seguir: Os meta caracteres % e _ podem ser usados no campo Host de ambas tabelas. O valor % ou em branco no campo Host em ambas tabelas signicam qualquer mquina a Os campos Db, Table_name e Column_name no podem conter meta caracteres ou serem a brancos em ambas tabelas. As tabelas tables_priv e columns_priv so ordenadas nos campos Host, DB e User. Isto a parecido com a ordenao da tabela db, no entanto, a ordenao mais simples porque e ca ca e somente o campo Host pode conter meta caracteres. O processo de vericao da requisio descrito abaixo. (Se voc j est familiarizado ca ca e e a a com o cdigo de vericao de acesso, voc ir perceber que a descrio aqui um pouco o ca e a ca e diferente do algor itimo usado no cdigo. A descrio equivalente ao que o cdigo realmente o ca e o faz; ele s diferente para tornar a explicao mais simples.) oe ca Para requisies administrativas (SHUTDOWN, RELOAD, etc.), o servidor confere somente a co entrada da tabela user, porque ela a unica tabela que especica privilgios administrae e tivos. O acesso concedido se o registro permitir a operao requisitada ou negado caso e ca o contrrio. Por exemplo, se voc deseja executar mysqladmin shutdown mas a entrada a e em sua tabela user no lhe concede o privilgio SHUTDOWN, o acesso negado mesmo sem a e e consultar as tabelas db ou host. (elas no contm o campo Shutdown_priv, portanto no a e a existe esta necessidade.)

244

MySQL Technical Reference for Version 5.0.0-alpha

Para requisies relacionadas aos bancos de dados (insert, udpdate, etc.), o servidor co primeiro confere os privilgios globais do usurio consultando as entradas da tabela user. e a Se a entrada permitir a operao requisitada, o acesso concedido. Se os privilgios globais ca e e na tabela user so insucientes, o servidor determina os privilgios espec a e icos de banco de dados para o usurio consultando as tabelas db e host: a 1. O servidor consulta a tabela db por uma combinao nos campos Host, Db e User. Os ca campos Host e User so comparados com o nome da mquina e o nome do usurio que a a a faz a requisio. O campo Db comparado com o banco de dados que o usurio deseja ca e a acessar. Se no existir entradas coincidentes para o Host e User, o acesso negado. a e 2. Se existir uma combincao com a entrada da tabela db e seu campo Host no estiver ca a em branco, aquela entrada dene os privilgios especicos do banco de dados do usuario. e 3. Se o registro coincidente da tabela db tiver o campo Host em branco, signica que a tabela host enumera quais mquinas so permitidas acessar o banco de dados. Neste a a caso, uma consulta adicional feita na tabela host para encontrar uma valores coincie dentes nos campos Host e Db. Se nenhuma entrada na tabela host coincide, o acesso negado. Se existir uma coincidncia, os privilgios espec e e e icos de bancos de dados para o usurio so computados como a interseo (no a unio!) dos privilgios nas a a ca a a e entradas das tabelas db e host, isto , os privilgios que so Y em ambas entradas. e e a (Desta forma voc pode conceder privilgios gerais em entradas na tabela db e ento e e a restringi-los em uma base de mquina a mquina utilizando as entradas da tabela a a host.) Depois de determinar os privilgios espec e icos do banco de dados concedido pelas entradas nas tabelas db e host, o servidor os adiciona aos privilgios globais concedidos pela tabela e user. Se o resultado permitir a operao requisitada, o acesso ser concedido. De outra ca a forma, o servidor consulta os privilgios de tabelas e campos do usuario nas tabelas tables_ e priv e columns_priv e os adiciona aos privilgios do usurio. O acesso ser permitido ou e a a negado baseado no resultado. Expresso em termos booleanos, a descrio precedente de como os privilgios de um usurio ca e a so calculados podem ser resumido assim: a global privileges OR (database privileges AND host privileges) OR table privileges OR column privileges Ele pode no ser aparente porque, se os privilgios da entrada global de user so inicialmente a e a insucientes para a operao requisitada, o servidor adiciona estes privilgios mais tarde aos ca e privilgios espec e icos de banco de dados, tabelas e colunas. A razo que uma requisio a e ca pode exigir mais que um tipo de privilgio. Por exemplo, se voc executar uma instruo e e ca INSERT ... SELECT, voc precisa dos privilgios INSERT e SELECT. Seu privilgio pode ser e e e tal que a entrada da tabela user concede um privilgio e a entrada da tabela db concede e o outro. Neste caso, voc tem os privilgios necessrios para realizar a requisio, mas o e e a ca servidor no pode obt-los de ambas as tabelas por si prprio; os privilgios concedidos a e o e pelas entradas em ambas as tabelas de ser combinados. A tabela host pode ser usada para manter uma lista dos servidores seguros. Na Tcx, a tabela host contm uma lista de todas as mquina na rede local. A elas so e a a concedidos todos os privilgios. e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

245

Voc pode tambm usar a tabela host para indicar mquinas que no so seguras. Suponha e e a a a que voc tenha uma mquina public.your.domain que est localizada em uma rea pblica e a a a u que voc no considera segura. Voc pode permitir o acesso a todas as mquinas de sua e a e a rede exceto a esta mquina usando entradas na tabela host desta forma: a +--------------------+----+| Host | Db | ... +--------------------+----+| public.your.domain | % | ... (todos os privilgios configurados para N) e | %.your.domain | % | ... (todos os privilgios configurados para Y) e +--------------------+----+Naturalmente, voc deve sempre testar suas entradas nas tabelas de permisses (por exe o emplo, usar o mysqlaccess para ter certeza que os privilgios de acesso esto atualmente e a congurados da forma que voc imagina. e

4.3.11 Hashing de Senhas no MySQL 4.1

As contas de usurios do MySQL esto lisatadas na tabela user do banco de dados mysql. a a Para cada conta do MySQL denida uma senha, no entanto o que est armazenado na e a coluna Password da tabela user no seja uma verso da senha em texto puro, mas um valor a a hash computado para ela. Valores hash de senha so calculados pela funo PASSWORD(). a ca O MySQL usa senhas em duas fases da comunicao cliente/servidor: ca Primeiro, quando um cliente tenta se conectar ao servidor, existe uma etapa de autenticao inicial na qual o cliente deve apresentar uma senha que combina com o valor ca hash armazenado na tabela de usurios para a conta que aquele cliente deseja usar. a Em segundo lugar, depois que o cliente conecta, ele pode congurar ou alterar o hash da senha para as contas listadas na tabela de usurio (se ele tiver privilgios sucientes).O a e cliente pode fazer isto usando a funo PASSWORD() para gerar uma hash da senha ca ou usando as instrues GRANT ou SET PASSWORD. co Em outra palavras, o servidor usa valores hash durante a autenticao quando um cliente ca tenta a primeira conexo. O servidor gera os valores hash se um cliente conectado chama a a funo PASSWORD() ou usa uma instruo GRANT ou SET PASSWORD para denir ou alterar ca ca uma senha. O mecanismo de hash da senha foi atualizado no MySQL 4.1 para fornecer melhor segurana c e reduzir os riscos de senhas serem roubadas. No entanto, Este novo mecanismo s o e interpretado pelo servidor 4.1 e clientes 4.1, que podem resultar em alguns problemas de compatibilidade. Um cliente 4.1 pode conectar a um servidor pre-4.1, porque o cliente entende tanto o antigo quanto o novo mecanismo hash de senha. No entanto, um cliente pre-4.1 que tentar se conectar a um servidor 4.1 pode encontrar diculdades. Por exemplo, um cliente mysql 4.0 que tentar se conectar a um servidor 4.1 pode falhar com a seguinte mensagem de erro: shell> mysql Client does not support authentication protocol requested by server; consider upgrading MySQL client

246

MySQL Technical Reference for Version 5.0.0-alpha

A seguinte discusso descreve a diferena entre o antigo e o novo mecanismo de senha, e a c o que voc deve fazer se voc atualizar o seu servidor para a verso 4.1 mas precizar de e e a manter compatibilidade com clientes pre-4.1. Nota: Esta discusso contrasta no comportamento da verso 4.1 com o comportamento da a a pre-4.1, mas o da verso 4.1 descrito aqui comea relamente na verso 4.1.1. O MySQL a c a e uma distribuio disferente porque ela tem um mecanismo um pouco diferente daquele ca implementado na 4.1.1 e acima. Diferenas entre a verso 4.1.0 e as verses mais recentes c a o so descritas posteriormente. a Antes do MySQL 4.1, o hash de senha calculado pela funo PASSWORD() tem tamanho de ca 16 bytes. Este hash se parece com: mysql> SELECT PASSWORD(mypass); +--------------------+ | PASSWORD(mypass) | +--------------------+ | 6f8c114b58f2ce9e | +--------------------+ A coluna Password da tabela user (na qual estes hashes so armazenados) tambm tm 16 a e e bytes de tamanho antes do MySQL 4.1. A partir do MySQL 4.1, a funo PASSWORD() foi modicada para produzir um valor hash ca de 41 bytes. mysql> SELECT PASSWORD(mypass); +-----------------------------------------------+ | PASSWORD(mypass) | +-----------------------------------------------+ | *43c8aa34cdc98eddd3de1fe9a9c2c2a9f92bb2098d75 | +-----------------------------------------------+ De acordo com o mostrado, a coluna Password na tabela user tambm deve ter 41 bytes e para armazeanar estes valores. Se voc realiza uma nova instalao do MySQL 4.1, a coluna Password ser convertida e ca a para o tamanho de 41 bytes automaticamente. Se voc atualizar uma instalao mais antiga para a verso 4.1, voc executar o script e ca a e mysql_fix_privilege_tables para atualizar o tamanho da coluna Password de 16 para 41 bytes. (O script no altera valores de senhas existentes, que continuam com a 16 bytes.) Uma coluna Password mais larga pode armazenar hashes de senha no formato novo e no antigo. O formato de qualquer valor de hash de senha dado podeser determinado de dois modos: A diferena bvia o tamanho (16 bytes versus 41 bytes) c o e A segunda diferena que os hashes de senha no novo formato sempre comeam com c e c um caracter *, que as senhas no formato antigo nunca faziam. O formato maior do hash de senha tetm melhores propriedades criptogrcas, e a autena ticao do cliente baseada em hashs mais longos mais segura que aquela baseada nos ca e antigos hashes menores.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

247

A diferena entre os hashs de senhas menores e maiores so relevantes em como o servidor c a usa as senhas durante a autenticao e como ela gera hash de senhas para clientes conectados ca que realizam operaes de alterao de senha. co ca O modo no qual o servidor usa o hash de senha durante a autenticao afetada pela ca e largura da coluna Password: Se a coluna no for larga, apenas a autenticao de hash curto usada. a ca e Se a coluna larga, ela pode guardar tanto hash curtas quanto hashs longas, e o servidor e pode usar ambos os formatos: Clientes pre-4.1 podem conectar, mas como els s conhecem o mecanismo hash o antigo, eles s podem se conectar pelas contas com hashes curtos. o Clientes 4.1 podem autenticar contas com hashes longos ou curtos. Para contas com o hash curto, o processo de autenticao na verdade um pouco mais seguro ca e para clientes 4.1 que para clientes mais antigos. Em termos de segurana, o gradiente do c menos para o mais seguro : e Clientes pre-4.1 autenticando em contas com hash de senha curto Clientes 4.1 autenticando em contas com hash de senha curto Clientes 4.1 autenticando em contas com hash de senha longo O modo no qual o servidor gera hashes de senhas para clientes conectados afetado pela e largura da coluna Password e pela opo --old-passwords. Um servidor 4.1 gera hashes ca longos apenas se certas condices forem encontradas: A coluna Password deve ser grande o o suciente para armazenar valores longos e a opo --old-passwords no deve ser dada. ca a Estas condies se aplicam da seguinte forma: co A coluna Password deve ser grande o suciente para armazenar hashes longos (41 bytes). Se a coluna no foi atualizada e ainda tem a largura de 16 bytes (antes da a 4.1), o servidor avisa que o hash no pode caber nela e gera apenas hashes curtos a quando um cliente realiza a operao de troca de senha usando PASSWORD(), GRANT, ca ou SET PASSWORD. (Este comportamento ocoree se voc tiver atualizado para a verso e a 4.1 mas no executou o script mysql_fix_privilege_tables para aumentar a coluna a Password.) Se a coluna Password for larga, ela poder aramazenar tanto os hashes de senha curtos a quanto os longos. Neste caso, PASSWORD(), GRANT, e SET PASSWORD iro gerar hashes a longos a menos que o servidor tenha sido iniciado com a opo --old-passwords. Esta ca opo fora o servidor a gerar hashes de senha curtos. ca c O propsito da opo --old-passwords permitir que voc mantenha compatibilidade com o ca e e clientes com verses anteriores ` 4.1 sob circunstncias nas quais os servidores gerariam o a a hashes de senha longos. Ele no afeta a autenticao (clientes 4.1 podem ainda usar contas a ca que possuem hash de senha longo), mas ele no previne a criaa de um hash de senha longo a co na tabela user como resultado de uma operao de troca de senha. Onde isto ocorrer, a ca conta no mais poder ser usada por clientes pr-4.1. Se a opo --old-passwords, o a a e ca seguinte cenrio poss a e ivel: Um cliente antigo conecta a uma conta que tm um hash de senha curto. e O cliente altera a senha das contas. Sem --old-passwords, isto resulta na conta que tm um hash de senha longo. e

248

MySQL Technical Reference for Version 5.0.0-alpha

A prxima vez que o cliente antigo tentar se conectar ` conta, ele no conseguir, o a a a porque a conta agora exige o novo mecanismo de hash durante a autenticao. (Uma ca vez que uma conta tem um hash de senha longo na tabela de usurio, apenas os clientes a 4.1 podero ser autenticados, porque clientes de verses anteriores a 4.1 no entendem a o a o hash longo.) Este cenrio mostra que perigoso executar um servidor 4.1 sem usar a opo --olda e ca passwords, operaes de alterao de senha no iro gerar hashes de senha longos e assim co ca a a no faz com que as contas se tornem inacess a iveis para clientes mais antigos. (Estes clientes no podem bloquear eles mesmos inadivertidamente alterando suas senhas e cando com a um hash de senha longo. A desvantagem da opo --old-passwords que qualquer senha que voc criar ou alterar ca e e usar hashes curtos, mesmo para clientes 4.1. Assim, voc perde a segurana adicional a e c fornecida pelos hashes de senha longos. Se voc quiser criar uma conta qye tenha um hash e longo (por exemplom parr uso pelos clientes 4.1), voc deve faz-lo enquanto executa o e e servidor sem a opo --old-passwords. ca Os seguintes cenrios so poss a a iveis para executar um servidor 4.1: Cenario 1) Coluna Password menor na tabela de usurios a Apenas hashes curtos podem ser armazenados na coluna Password. O servidor usa apenas hasghes curtos durante a autenticao do cliente. ca Para clientes conectados, operaes de gerao de hash de senha envolvendo co ca PASSWORD(), GRANT ou SET PASSWORD usa hashes curtos exclusivamebnte. Qualquer alterao a senha de uma conta faz com que a conta tenha um hash de senha curto. ca A opo --old-passwords pode ser usada mas superua porque com uma coluna ca e Password menor, o servidor ir gerar hashes de senha curtos de qualquer forma. a Cenrio 2) Colunas Password longas; servidor no iniciado com a opo --old-passwords a a ca Hashes de senha longos e curtos podem ser armazenados na coluna Password. Clientes 4.1 podem autenticar contas com hashes curtos ou longos. Clientes anteioriores ao 4.1 s podem autenticar contas com hash curto. o Para clientes conectados, operaes de gerao de hash de senha envolvendo co ca PASSWORD(), GRANT, ou SET PASSWORD usam hashes longos exclusivamente. Qualquer mudana na senha de uma conta far com que ela possua um hash de senha longo. c a OLD_PASSWORD() pode ser usado para gerar explicitamente um hash curto. Por exemplo, para atribuir uma senha curta a uma conta, use UPDATE da seguinte forma: mysql> UPDATE user SET Password = OLD_PASSWORD(mypass) -> WHERE Host = some_host AND User = some_user; mysql> FLUSH PRIVILEGES; Como indicado anteriormente, o perigoso neste cenrio que poss a e e ivel que contas com hashes de senha curtos se tornem inacessiveis para cliente anteriores ao 4.1. Qualquer alterao a senha de uma conta feita via GRANT, SET PASSWORD, ou PASSWORD() faz com que ca a conta tenha um hash de senha longo, e a partir deste ponto, nenhum cliente anterior ao 4.1 poder autenticar esta conta at que ele seja atualizado para a verso 4.1. a e a Cenrio 3) Coluna Password longa; servidor iniciado com a opo --old-passwords a ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

249

Hashes longos e curtos podem ser armazenados na coluna Password. Clientes 4.1 podem autenticar contas que tenham hashes longos ou curtos (mas note que poss e ivel criar hashes longos apenas quando o servidor iniciado sem --olde passwords). Clientes anteriores ao 4.1 podem autentticar apenas contas com hashes curtos. Para clientes conectados, operaes de gerao de hash de senha envolvendo co ca PASSWORD(), GRANT, ou SET PASSWORD usa hashes curtos exclusivamente. Qualquer alterao em uma senha de conta faz com que a conta tenha um hash de senha curto. ca Neste cenrio, voc no pode criar contas que tenham hashes de senha longo, porque -a e a old-passwords previne a criao de hashes longos. Tambm, se voc criar uma conta com ca e e um hash longo antes de usar a opo --old-passwords, alterar a senha da conta enquanto ca --old-passwords est funcionando faz com que seja dada a conta uma sena curta, fazendo a com que ela perca os benef icios de segurana de um hash longo. c As disvantagens para este cenrio pode ser resumido como a seguir: a Cenrio 1) Voc no pode tirar vantagem do hash longo que fornece mais autenticao a e a ca segura. Cenrio 2) Contas com hashes curtos tornam clientes anteriores ao 4.1 inacess a iveis se voc e alterar a senha deles sem usar OLD_PASSWORD() explicitamente. Cenrio 3) --old-passwords evita que as contas com hashes curtos se tornem inacess a iveis, mas operaes de alterao de senhas fazem com que as contas com hashes longos seja co ca revertida para hashes curtos, e voc no pode alter-las de volta para hashes longos enquanto e a a --old-passwords est em efeito. a

Implicaoes de Alterao de Hashes de Senha para Aplicativos c ca

Um atualizao para o MySQL 4.1 para trazer problemas de compatibilidade para aplicaes ca co que usam PASSWORD() para gerar senha para os seus prprios propsitos. (Aplicativos o o no devem fazer isto, porque PASSWORD() deve ser usado paenas para gerenciar contas do a MySQL. Mas algumas aplicaes usam PASSWORD() para seus prprios propsitos.) Se voc co o o e atualizar para o MySQL 4.1 e executar o servidor sob condies onde ele gera hashes de co senha longo, uma aplicao que usa PASSWORD() para as suas prprias senhas ir falhar. O ca o a curso de ao recomendado modicar o aplicativo para usar outras funes como SHA1() ca e co ou MD5() para produzir valores de hash. Se isto no for poss voc pode utilizar a funo a ivel e ca OLD_PASSWORD(), que fornecida para gerar hashes curtos no formato antigo. (Mas note e que OLD_PASSWORD() pode vir a no ser mais suportado.) a Se o servidor est rodando sob circuntncias onde ele gera hashes de senha curtos, OLD_ a a mas equivalente a PASSWORD(). PASSWORD() est disponivel a e Hash de senhas no MySQL 4.1.0 difere do hash no 4.1.1 e acima. As diferenas da verso c a 4.1.0 so as seguintes: a Hashes de senhas de 45 bytes em vez de 41 bytes. A funo PASSWORD() no repetit ca a e ivel. Isto , com um dado argumento X, successivas e chamadas a PASSWORD(X) geram diferentes resultados.

250

MySQL Technical Reference for Version 5.0.0-alpha

4.3.12 Causas dos Erros de Accesso Negado

Se voc encontrar erros de Accesso Negado (Access denied) quando tentar conectar-se ao e servidor MySQL, a lista abaixo indica alguns caminhos que voc pode seguir para corrigir e o problema: Depois de instalar o MySQL, voc executou o script mysql_install_db para congurar e o contedo inicial das tabelas de permisses ? Se no, faa isto. Veja Seo 4.4.4 u o a c ca [Default privileges], Pgina 260. Testes os privilgios iniciais executando este comando: a e shell> mysql -u root test O servidor deve deixar voc conectar sem erros. Voc tambm deve assegurar que e e e exista o arquivo user.MYD no diretrio do banco de dados do MySQL. Normalmente o ele ca em CAMINHO/var/mysql/user.MYD. onde CAMINHO o caminho para a raiz da e instalao do MySQL. ca Depois de terminar uma instalao, voc deve conectar ao servidor e congurar seus ca e usurios e suas permisses de acesso. a o shell> mysql -u root mysql O servidor deve permitir a conexo pois o usurio root MySQL vem inicialmente a a congurado sem senha. Isto tambm um risco de segurana, portanto congurar e e c a senha do usurio root algo que deve ser feito enquanto voc congura os outros a e e usurios do MySQL. a Se voc tentar se conectar como root e obter este erro: e Access denied for user: @unknown to database mysql isto signica que voc no possui um registro na tabela user com o valor root no e a campo User e que o mysqld no pode rsolver o nome de mquina do cliente. Neste caso, a a voc deve reiniciar o servidor com a opo --skip-grant-tables e editar seu arquivo e ca /etc/hosts ou o \Windows\hosts para adicionar uma entrada para sua mquina. a Se voc obter um erro como o seguinte: e shell> mysqladmin -u root -pxxxx ver Access denied for user: root@localhost (Using password: YES) Signica que voc est usando uma senha incorreta. Veja Seo 4.4.8 [Passwords], e a ca Pgina 266. a Se voc esqueceu a senha de root, voc pode reiniciar o mysqld com a opo -e e ca skip-grant-tables para alterar a senha. Veja Seo A.4.2 [Resetting permissions], ca Pgina 927. a Se voc obter o erro acima mesmo se no tiver congurado uma senha, signica que e a voc tem algum arquivo my.ini congurado para passar alguma senha incorreta. Veja e Seo 4.1.2 [Option les], Pgina 216. Voc pode evitar o uso de arquivos de opes ca a e co com a opo --no-defaults, como a seguir: ca shell> mysqladmin --no-defaults -u root ver Se voc atualizou uma instalao existente do MySQL de um verso anterior e ca a a ` verso 3.22.11 para a Verso 3.22.11 ou posterior, voc executou o script a a e mysql_fix_privilege_tabels ? Se no faa isto. A estrutura das tabelas de a c permisses alteraram com a Verso 3.22.11 do MySQL quando a instruo GRANT se o a ca tornou funcional. Veja Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

251

Se os seus privilgios parecerem alterados no meio de uma sesso, pode ser que o e a superusurio os alterou. A recarga das tabelas de permisses afeta novas conexes a o o dos clientes, mas ela tambm afeta conexes existentes como indicado em Seo 4.4.3 e o ca [Privilege changes], Pgina 260. a Se voc no consegue fazer a sua senha funcionar, lembre-se que voc deve usar a e a e funo PASSWORD() se voc congurar a senha com instrues INSERT, UPDATE ou ca e co SET PASSWORD. A funo PASSWORD() desnecessria se voc especicar a senha usca e a e ando a instruo GRANT ... IDENTIFIED BY ou o comando mysqladmin password. Veja ca Seo 4.4.8 [Senhas], Pgina 266. ca a localhost um sinnimo para seu nome de mquina local, e tambm a mquina e o a e e a padro em que clientes tentam se conectar se voc no especicar explicitamente o a e a nome da mquina. Entretanto, conexes para localhost no funcionam se voc esa o a e tiver executando em um sistema que utilize MIT-pthreads (conexes localhost so o a feitas utilizando sockets Unix, que no so suportadas pelas MIT-pthreads). Para a a evitar este problema nestes sistemas, voc deve utilizar a opo --host para nomear e ca explicitamente o servidor. Isto far uma conexo TCP/IP ao servidor myssqld. Neste a a caso, voc deve ter seu nome de mquina real nos registros da tabela user no servidor. e a (Isto verdadeiro mesmo se voc estiver executando um programa cliente na mesma e e mquina que o servidor.) a Se voc obter o erro Access denied quando tentando conectar ao banco de dados com e mysql -u nome_usurio _nome_bd, voc pode ter um problema com a tabela user. a e Verique isto executando mysql -u root mysql e usando esta sentena SQL: c mysql> SELECT * FROM user; O resultado deve incluir uma entrada com as colunas Host e User combinando com o nome de seu computador e seu nome de usurio no MySQL. a A mensagem de erro Access denied ir dizer a voc com qual usurio voc est tena e a e a tando se logar, a mquina que est tentando conectar e se voc est utilizando uma a a e a senha ou no. Normalmente, voc deve ter um registro na tabela user que combine a e exatamente com o nome de mquina e o nome de usurio que forem fornecidos na a a mensagem de erro. Por exemplo, se voc obter uma mensagem de erro que contenha e Using password: NO, isto signica que voc est tentando se conectar sem uma senha. e a Se voc obter o seguinte erro quando estiver tentando conectar de uma mquina difere a ente da que o servidor MySQL estiver executando, ento no deve existir um registro a a na tabela user que combine com esta mquina: a Host ... is not allowed to connect to this MySQL server Voc pode corrigir isto utilizando a ferramenta de linha de comando mysql (no servie dor!) para adicionar um registro ` tabela user, db ou host para coincidir com o usurio a a e nome de mquina de onde voc est tentando conectar, depois execute o comando a e a mysqladmin flush-privileges. Se voc no estiver executando o MySQL Verso 3.22 e a a e voc no sabe o nmero IP ou o nome da mquina da qual estiver conectando, voc e a u a e deve colocar uma entrada com o valor % na coluna Host da tabela user e reiniciar o mysqld com a opo --log na mquina onde executado o servidor. Depois tente ca a e conectar a partir da mquina cliente, a informao no log do MySQL ir indicar como a ca a voc est realmente conectando. (Ento troque o % na tabela user com o nome da e a a mquina mostrado pelo log. De outra forma voc teria um sistema que seria inseguro.) a e

252

MySQL Technical Reference for Version 5.0.0-alpha

Outra razo para este erro no Linux pode ser porque voc est utilizando uma verso a e a a binria do MySQL que compilada com uma verso diferente da glibc que voc est a e a e a usando. Neste caso voc deve atualizar seu SO/Glibc ou fazer o download da verso e a fonte do MySQL e compil-la. Um RPM fonte , normalmente, fcil de compilar e a e a instalar, logo, isto no um grande problema. a e Se voc obter uma mensagem de erro onde o nome da mquina no exibido ou, no e a a e lugar do nome da mquina existir um IP, mesmo se voc tenta a conexo com um nome a e a de mquina: a shell> mysqladmin -u root -pxxxx -h some-hostname ver Access denied for user: root@ (Using password: YES) Isto signica que o MySQL obteve algum erro quando tentava resolver o IP para um nome de maquina. Neste caso voc pode executar mysqladmin flush-hosts para zerar e o cache DNS interno. Veja Seo 5.5.5 [DNS], Pgina 459. ca a Algumas solues permanentes so: co a Tente descobrir o que est errado com seu servidor DNS e corrija os erros. a Especique nmeros IPs no lugar de nomes nas tabelas de privilgios do MySQL. u e Inicie o mysqld com --skip-name-resolve. Inicie o mysqld com --skip-host-cache. Conecte ` localhost se voc estiver executando o servidor e o cliente na mesma a e mquina. a Coloque os nomes das mquinas clientes em /etc/hosts. a Se mysql -u root test funciona mas mysql -h nome_servidor -u root test resultar em Access denied, ento voc pode no ter o nome correto para a sua mquina na a e a a tabela user. Um problema comum quando o valor de Host na entrada da tabela e user especica um nome de mquina no qualicado, mas as rotinas de resoluo de a a ca nomes de seu sistema retornam um nome qualicado completo do dom inio (ou viceversa). Por exemplo, se voc tem uma entrada com o nome tcx na tabela user, mas e seu DNS diz ao MySQL que o nome da mquina tcx.subnet.se, a entrada no a e a ir funcionar. Tente adicionar um registro ` tabela user que contenha o nmero IP a a u de sua mquina como o valor da coluna Host. (Uma alternativa, seria adicionar um a registro ` tabela user com o valor de Host contendo um metacaracter, por exemplo, a tcx.%. Entretanto, o uso de nomes de mquinas terminando com % inseguro e a e no recomendado!) a e Se mysql -u nome_usurio test funciona mas mysql -u nome_usurio outro_bd no a a a funconar, voc no possui uma entrada para outro_bd listado na tabela db. e a Se mysql -u nome_usurio nome_bd funciona quando executado no prprio servidor, a o mas mysql -u nome_mquina -u nome_usurio nome_bd no funciona quando execua a a tado em outra mquina cliente, voc no possui o nome da mquina cliente listado na a e a a tabela user ou na tabela db. Se voc no estiver entendendo porque obtem Access denied, remova da tabela user e a todas as entradas da coluna Host que contenham meta caracteres (entradas que contenham $ ou _). Um erro muito comum inserir uma nova entrada com Host=% e e User=algum usurio, pensando que isto ir permitir a voc especicar localhost a a e para conectar da mesma mquina. A razo disto no funcionar que os privilgios a a a e e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

253

padres incluem uma entrada com Host=localhost e User=. Como esta entrada o tem o valor localhost em Host que mais espec e ica que %, ela usada no lugar e da nova entrada quando se conectar de localhost! O procedimento correto inserir e uma segunda entrada com Host=localhost e User=algum_usurio, ou remover a a entrada com Host=localhost e User= . Se voc obter o seguinte erro, voc pode ter um problema com a tabela db ou a tabela e e host: Access to database denied Se a entrada selecionada da tabela db tiver um valor vazio na coluna Host, tenha certeza que exista uma ou mais entradas correspondentes na tabela host especicando quais mquinas aplicam-se ` tabela db. a a Se voc obter o erro quando estiver utilizando comandos SQL SELECT ... INTO e OUTFILE ou LOAD DATA INFILE, a entrada na tabela user provavelmente no tem o a privilgio le habilitado. e Lembre-se que programas clientes iro usar parmetros de conexes especicados em a a o arquivos de congurao ou variveis ambientais. Veja Apndice F [Environment varica a e ables], Pgina 1092. Se parecer que algum cliente est enviando parmetros errados a a a para a conexo e voc no os especicou na linha de comando, verique seu ambiente e a e a o arquivo .my.cnf no seu diretrio home. Voc pode tambm conferir os arquivos de o e e conguraes do servidor MySQL, apesar de no ser interessante gravar conguraes co a co de cliente nestes arquivos. Veja Seo 4.1.2 [Option les], Pgina 216. Se voc obter ca a e a mensagem de acesso negado (Access denied) quando estiver executando um cliente sem opes, tenha certeza que voc no especicou uma senha antiga em nenhum de co e a seus arquivos de opes! Veja Seo 4.1.2 [Option les], Pgina 216. co ca a Se voc zer alteraes para as tabelas de permisses diretamente (utilizando uma ine co o struo INSERT ou UPDATE) e suas alteraes parecem ser ignoradas, lembre que voc ca co e deve usar uma instruo FLUSH PRIVILEGES ou executar um comando mysqladmin ca flush-privileges para o servidor ler novamente as tabelas com os privilgios. De e outra forma, suas alteraes no faro efeito at que o servidor seja reiniciado. Lembreco a a e se que depois de congurar a senha de root com um comando UPDATE, no ser a a necessrio especicar a senha at que voc atualize os privilgios, pois o servidor ainda a e e e no saber que voc alterou a senha! a a e Se voc tiver problemas de acesso com Perl, PHP, Python ou um programa ODBC, e tente conectar ao servidor com mysql -u nome_usurio nome_bd ou mysql -u nome_ a usurio -psua_senha nome_bd. Se voc consegue conectar com o cliente mysql, existe a e algum problema com seu programa e no o acesso aos privilgios (Note que no espao a e a c entre -p e a senha; voc tambm pode utilizar a sintaxe --password=sua_senha para e e especicar a senha. Se voc utilizar a opo -p sozinha, o MySQL ir lhe solicitar a e ca a senha.) Para testar, iniciae o daemon mysqld com a opo --skip-grant-tables. Ento voc ca a e pode alterar as tabelas de permisses do MySQL e utilizar o script mysqlaccess para o conferir se suas modicaes zeram o no o efeito desejado. Quando voc estiver co a e satisfeito com suas alteraes, execute mysqladmin flush-privileges para dizer ao co servidor mysqld para iniciar utilizando as novas tabelas com os privilgios. Nota: e Recarregar as tabelas de permisses sobrescreve a opo --skip-grant-tables. Isto o ca

254

MySQL Technical Reference for Version 5.0.0-alpha

lhe permite dizer ao servidor para comear a utilizar as tabelas de permisses novamente c o sem reinici-lo. a Se tudo mais falhar, inicie o servidor mysqld com uma opo de depurao (por exemca ca plo, --debug=d,general,query). Isto ir imprimir informaes de mquinas e usurios a co a a sobre tentativas de conexes, e tambm informaes sobre cada comando disparado. o e co Veja Seo E.1.2 [Making trace les], Pgina 1080. ca a Se voc tiver outros problemas com as tabelas de permisses do MySQL e sente que e o deve enviar o problema para a lista de discusso, sempre fornea um descarga das a c tabelas de permisses do seu MySQL. Voc pode descarregar as tabelas com o comando o e mysqldump mysql. Como sempre, envie seus problemas utilizando o script mysqlbug. Veja Seo 1.7.1.3 [Bug reports], Pgina 36. Em alguns casos voc pode precisar ca a e reiniciar o mysqld com a opo --skip-grant-tables para executar o mysqldump. ca

4.4 Gerenciamento das Contas dos Usurios no MySQL a

4.4.1 A Sintaxe de GRANT e REVOKE
GRANT priv_type [(column_list)] [, tipo_priv [(column_list)] ...] ON {tbl_name | * | *.* | db_name.*} TO user_name [IDENTIFIED BY [PASSWORD] password] [, user_name [IDENTIFIED BY [PASSWORD] password] ...] [REQUIRE NONE | [{SSL| X509}] [CIPHER cipher [AND]] [ISSUER issuer [AND]] [SUBJECT subject]] [WITH [GRANT OPTION | MAX_QUERIES_PER_HOUR # | MAX_UPDATES_PER_HOUR # | MAX_CONNECTIONS_PER_HOUR #]] REVOKE priv_type [(column_list)] [, priv_type [(column_list)] ...] ON {tbl_name | * | *.* | db_name.*} FROM user_name [, user_name ...] O comando GRANT implementado no MySQL verso 3.22.11 ou posterior. Para verses e a o anteriores do MySQL, a instruo GRANT no faz nada. ca a Os comandos GRANT e REVOKE permitem aos administradores do sistema criar usurios e a conceder e revogar direitos aos usurios do MySQL em quatro n a iveis de privilgios: e N Global ivel Privilgios globais aplicam para todos os bancos de dados em um determinado e servidor. Estes privilgios so armazenados na tabela mysql.user. GRANT ALL e a ON *.* e REVOKE ALL ON *.* concedero e revogaro apenas privilgios globais. a a e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

255

N dos bancos de dados ivel Privilgios de bancos de dados aplicam-se a todas as tabelas em um determinado e banco de dados. Estes privilgios so armazenados nas tabelas mysql.db e e a mysql.host. GRANT ALL ON db.* e REVOKE ALL ON db.* concedero e revogaro a a apenas privilgios de banco de dados. e N das tabelas ivel Privilgios de tabelas aplicam-se a todas as colunas em uma determinada e tabela. Estes privilgios so armazenados na tabela mysql.tables_priv. e a GRANT ALL ON db.table e REVOKE ALL ON db.table concedero e revogaro a a apenas privilgios de tabelas. e N das colunas ivel Privilgios de colunas aplicam-se a uma unica coluna em uma determinada e tabela. Estes privilgios so armazenados na tabela mysql.columns_priv. e a Para as instrues GRANT e REVOKE, tipo_priv pode ser especicado como um dos seguintes: co ALL [PRIVILEGES] ALTER CREATE CREATE TEMPORARY TABLES DELETE DROP EXECUTE FILE INDEX INSERT LOCK TABLES PROCESS REFERENCES RELOAD REPLICATION CLIENT REPLICATION SLAVE SELECT SHOW DATABASES SHUTDOWN SUPER Congura todos os privilgios simples exceto WITH GRANT e OPTION Permite o uso de ALTER TABLE Permite o uso de CREATE TABLE Permite o uso de CREATE TEMPORARY TABLE Permite o uso de DELETE Permite o uso de DROP TABLE. Permite que o usurio execute stored procedures (MySQL 5.0) a Permite o uso de SELECT ... INTO OUTFILE e LOAD DATA INFILE. Permite o uso de CREATE INDEX e DROP INDEX Permite o uso de INSERT Permite o uso de LOCK TABLES em tabelas nas quais se tem o privilgio SELECT. e Permite o uso de SHOW FULL PROCESSLIST Para o futuro Permite o uso de FLUSH Da o direto ao usurio de perguntar onde o slave/master est. a a Necessrio para a replicao dos slaves (para ler logs binrio a ca a do master). Permite o uso de SELECT SHOW DATABASES exibe todos os banco de dados. Permite o uso de mysqladmin shutdown Permite a conexo (uma vez) mesmo se max connections a tiverem sido alcanados e executa o comando CHANGE MASTER, c KILL thread, mysqladmin debug, PURGE MASTER LOGS e SET GLOBAL Permite o uso de UPDATE Sinnimo para sem privilgios. o e Sinnimo para WITH GRANT OPTION o

UPDATE USAGE GRANT OPTION

USAGE pode ser usado quando voc quer criar um usurio sem privilgios. e a e

256

MySQL Technical Reference for Version 5.0.0-alpha

Os privilgios CREATE TEMPORARY TABLES, EXECUTE, LOCK TABLES, REPLICATION ..., SHOW e DATABASES e SUPER so novos na verso 4.0.2. Para usar estes novos privilgios aps ata a e o ualizar para 4.0.2, voc tem que executar o script mysql_fix_privilege_tables. Veja e Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. ca a Em verses anteriores do MySQL, o privilgio PROCESS d o mesmo direitos que o novo o e a privilgio SUPER. e Para anular o privilgio grant de um usurio, utilize o valor tipo_priv de GRANT OPTION: e a mysql> REVOKE GRANT OPTION ON ... FROM ...; Os unicos valores de tipo_priv que voc pode especicar para uma tabela so SELECT, e a INSERT, UPDATE, DELETE, CREATE, DROP, GRANT, INDEX e ALTER. Os unicos valores de tipo_priv que voc pode especicar para uma coluna (isto , quando e e voc usar uma clusula column_list) so SELECT, INSERT e UPDATE. e a a O MySQL permite que voc crie privilgios a n de banco de dados mesmo se o banco de e e ivel dados no existir para tornar fcil de se preparar para o uso do banco de dados. Atualmente, a a no entanto, o MySQL no permite criar permisses de a n a o ivel de tabela se a tabela no a existir. O MySQL no revogar automaticamente qualquer privilgio, mesmo se voc apagar a a e e uma tabela ou banco de dados. Voc pode congurar privilgios globais utilizando a sintaxe ON *.*. Voc pode congurar e e e privilgios de bancos de dados utilizando a sintaxe ON nome_bd.*. Se voc especicar ON e e * e estiver com algum banco de dados aberto, ser congurado os privilgios somente para a e este banco de dados. (AVISO: Se voc especicar ON * e voc no tem possui um banco de e e a dados aberto, ir afetar os privilgios globais!). a e Note por favor Os metacaracteres _ e % so permitidos na especicao dos nomes de a ca bancos de dados em comandos GRANT. Isto signica que se voc deseja usar um caracater e _ como parte de um nome de banco de dados, voc deve especic-lo como \_ no coe a mando GRANT, para prevenir o usurio de poder acessar bancos de dados adicionais que a correspondam ao padro do metacaracter, ex., GRANT ... ON foo\_bar.* TO .... a Para acomodar concesses de direitos para usurios de mquinas arbitrrias, o MySQL suo a a a porta a especicao do valor user_name no formato usurio@mquina. Se voc desejar ca a a e especicar uma string user contendo caracteres especiais (como o -), ou uma string contendo caracteres especiais ou meta caracteres (como o %), voc pode colocar o usurio ou e a o nome de mquina entre aspas (por exemplo, usurio-teste@mquina-teste). a a a Voc pode especicar meta caracteres no nome da mquina. e a Por exemplo, user@"%.loc.gov" se aplica a user para qualquer mquina no dominio loc.gov, e a user@"144.155.166.%" se aplica a user em qualquer mquina na subrede de classe C a 144.155.166. O formato simples user sinnimo de user@"%". e o O MySQL no suporta metacaracteres em nomes de usurios. Usurios annimos so a a a o a denidos inserindo entradas com User= na tabela mysql.user ou criando um usurio a com um nome vazio com o comando GRANT. Nota: Se voc permite o acesso de usurios annimos ao seu servidor MySQL, voc deve e a o e tambm concecder privilgios a todos os usurios locais como user@localhost porque, de e e a outra forma, a entrada de usurio annimo para a mquina local na tabela mysql.user a o a ser usada quando o usurio tentar a conexo ao servidor MySQL da mquina local! a a a a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

257

Voc pode vericar se isto se aplica a voc executando a seguinte instruo: e e ca mysql> SELECT Host,User FROM mysql.user WHERE User=; No momento, GRANT suporta somente nomes de mquinas, tabelas bancos de dados e colunas a at 60 caracteres. Um nome de usurio pode ter at 16 caracteres. e a e Os privilgios para uma tabela ou coluna so formados atravs do OU lgico dos privilgios e a e o e em cada um dos quatro niveis de privilgios. Por exemplo, se a tabela mysql.user especica e que um usurio tem um privilgio global select, isto no pode ser negado por uma entrada a e a no n de banco de dados, tabela ou coluna. ivel Os privilgios para uma coluna podem ser calculados da seguinte forma: e privilgios globais e OR (privilgios de banco de dados AND privilgios de mquina) e e a OR privilgios de tabela e OR privilgios de coluna e Na maioria dos casos, os direitos a um usurio so atribu a a idos em apenas um dos n iveis de privilgios, portanto a vida normalmente no to complicada como mostrado acima. e a e a Os detalhes do procedimento de vericao dos privilgios so apresentados em Seo 4.3 ca e a ca [Sistema de privilgios], Pgina 226. e a Se voc concede privilgios para uma combinao de usurio e mquina que no existem e e ca a a a na tabela mysql.user, um registro adicionado e permanece l at ser removido com um e a e comando DELETE. Em outras palavras, GRANT pode criar registros na tabela user, mas REVOKE no as remover; para remov-las voc deve usar a instruo expl a a e e ca icita DELETE. Na Verso 3.22.12 ou posterior do MySQL, se um novo usurio criado ou se voc possui a a e e privilgios de concesso globais, a senha do usurio ser especicada utilizando a clusula e a a a a IDENTIFIED BY, se uma for dada. Se o usurio j possui uma senha, ela trocada pela nova. a a e Se voc no quiser enviar a senha em texto puro voc pode usar a opo PASSWORD seguido e a e ca de uma senha embaralhada da funo SQL PASSWORD() ou da funo da API C make_ ca ca scrambled_password(char *to, const char *password). CUIDADO: Se voc criar um novo usurio mas no especicar uma clusula IDENTIFIED e a a a BY, o usurio no possuir uma senha. Isto no seguro. a a a a e Senhas podem tambm ser conguradas com o comando SET PASSWORD. Veja Seo 5.5.6 e ca [SET OPTION], Pgina 460. a Se voc conceder privilgios para um banco de dados, uma entrada na tabela mysql.db e e e criada se necessrio. Quando todos os privilgios para o banco de dados forem removidos a e com REVOKE, este registro removido. e Se um usurio no tem privilgios em uma tabela, a tabela no mostrada quando o a a e a e usurio solicita uma lista de tabelas (com a instruo SHOW TABLES por exemplo). O mesmo a ca verdade para SHOW DATABASES e A clusula WITH GRANT OPTION d ao usurio habilidade de fornecer ` outros usurios quaisa a a a a espec quer privilgios que ele tenha em um nivel e ico de privilgio. Voc deve ter cuidado e e ao fornecer o privilgio grant, pois dois usurios podem se unir para unir privilgios! e a e MAX_QUERIES_PER_HOUR #, MAX_UPDATES_PER_HOUR # e MAX_CONNECTIONS_PER_HOUR # sp a novos no MySQL verso 4.0.2. Estas opes limitam o nmero de consultas/atualizaes e a co u co logins que o usurios pode fazer durente uma hora. Se # 0 (padro), ento isto signica que a e a a

258

MySQL Technical Reference for Version 5.0.0-alpha

no h limites para aquele usurio. Veja Seo 4.4.7 [Recursos do usurios], Pgina 265. a a a ca a a Nota: para especicar qualquer destas opes para um usurio existente sem adicionar co a outros privilgios adicionais, use GRANT USAGE ON *.* ... WITH MAX_.... e Voc no pode conceder a outro usurio um privilgio que no possua; o privilgio GRANT e a a e a e possibilita fornecer somente os privilgios que possuir. e Esteja ciente que quando conceder a um usurio o privilgio GRANT em um n particular a e ivel de privilgios, qualquer privilgio que o usurio j possua (ou seja fornecido no futuro!) nesse e e a a n tambm pode ser concedido por este usurio. Suponha que voc conceda a um usurio ivel e a e a o privilgio INSERT em um banco de dados. Se voc conceder o privilgio SELECT no banco e e e de dados e especicar WITH GRANT OPTION, o usurio alm de poder repassar o privilgio a e e SELECT poder tambm repassar o insert. Se voc concede o privilgio UPDATE para o a e e e usurio no banco de dados, o usurio poder conceder os privilgios INSERT, SELECT e a a a e UPDATE. Voc no deve conceder privilgios ALTER a um usurio comum. Se voc zer isto, o e a e a e usurio pode tentar enganar o sistema de privilgios renomeando tabelas! a e Perceba que se voc estiver utilizando privilgios de tabelas ou colunas, mesmo que para e e apenas um usurio, o servidor examina os privilgios de tabelas e colunas para todos os a e usurios e isto ir deixar o MySQL um pouco mais lento. a a Quando o mysqld inicia, todos os privilgios so lidos na memria. Privilgios de bancos de e a o e dados, tabelas e colunas so iniciados um vez, e privilgios ao n de usurio fazem efeito na a e ivel a prxima vez que o usurio conectar. Modicaes nas tabelas de permisses que voc realiza o a co o e utilizando GRANT ou REVOKE so percebidas pelo servidor imediatamente. Se voc modicar a e as tabelas de permisses manualmente (utilizando INSERT, UPDATE, etc), voc deve executar o e uma instruo FLUSH PRIVILEGES ou executar mysqladmin flush-privileges para dizer ca ao servidor para recarregar as tabelas de permisses. Veja Seo 4.4.3 [Privilege changes], o ca Pgina 260. a As maiores diferenas entre o padro SQL e verses MySQL de GRANT so: c a o a No MySQL privilgios so fornecidos para uma combinao de usurio e mquina e e a ca a a no somente para um usurio. a a O SQL-99 no possui privilgios no n global ou de bancos de dados, e no suporta a e ivel a todos os tipos de privilgios que o MySQL suporta. O MySQL no suporta os privilgios e a e TRIGGER, EXECUTE ou UNDER do SQL-99. Os privilgios do SQL-99 so estruturadados em uma maneira hierrquica. Se voc e a a e remover um usurio, todos os privilgios do usurio so removidos. No MySQL os a e a a privilgios concedidos no so removidos automaticamente, mas voc deve remov-los e a a e e se necessrio. a Se no MySQL voc possuir o privilgio INSERT em somente parte das colunas em uma e e tabela, voc pode executar instrues INSERT na tabela; As colunas em que voc no e co e a tem o privilgio INSERT iro receber seus valores padres. O SQL-99 necessita que voc e a o e tenha o privilgio INSERT em todas as colunas. e Quando voc remove uma tabela no SQL-99, todos os privilgios para a tabela so e e a removidos. Se voc remover um privilgio no SQL-99, todos os privilgios que foram e e e concedidos baseado neste privilgio so tambm removidos. No MySQL, privilgios s e a e e o podem ser removidos com comandos REVOKE expl icitos ou manipulando as tabelas de permisses do MySQL. o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

259

Para uma descrio do uso de REQUIRE, veja Seo 4.4.10 [Secure connections], Pgina 268. ca ca a

4.4.2 Nomes de Usurios e Senhas do MySQL a

Existem vrias diferenas entre a forma que nomes de usurios e senhas so usados pelo a c a a MySQL e a forma que so usados pelo Unix ou Windows: a Nomes de usurios, como usado pelo MySQL para propsitos de autenticao, no tem a o ca a nenhuma relao com os nomes de usurios do Unix (nomes de login) ou nomes de ca a usurios Windows. A maioria dos clientes MySQL, por padro, tentam se conectar a a utilizando o nome de usurio atual do Unix como o nome de usurio no MySQL, mas a a isto existe somente por convenincia. Programas clientes permite especicar um nome e diferente com as opes -u ou --user. Isto signica que voc no pode tornar um co e a banco de dados seguro a menos que todos os usurios do MySQL possuam senhas. a Qualquer um pode tentar se conectar ao servidor utilizando qualquer nome, e eles se conectaro com qualquer nome que no possua uma senha. a a Nomes de usurios MySQL podem ter o tamanho de at 16 caracteres; Nomes de a e usurio Unix normalmente so limitados at 8 caracteres. a a e Senhas MySQL no tem nenhuma relao com senhas Unix. No existe nenhuma a ca a associao entre a senha em que voc utiliza para logar-se a uma mquina Unix e a ca e a senha que utilizada para acessar um banco de dados na mesma mquina. e a O MySQL criptografa senhas utilizando um algor itimo diferente que o utilizado pelo processo de login do Unix. Veja as descries das funes PASSWORD() e ENCRYPT() em co co Seo 6.3.6.2 [Miscellaneous functions], Pgina 547. Perceba que mesmo que a senha ca a e armazenada embaralhada, o conhecimento da sua senha embaralhada o suciente e para conseguir se conectar ao servidor MySQL! A partir da verso 4.1, o MySQL emprega um mecanismo de senha e login diferentes a que seguro mesmo se for feito um sni no pacote TCP/IP e/ou o banco de dados e mysql for capturado. Usurios MySQL e seus privilgios so criados normalmente com o comando GRANT, Veja a e a Seo 4.4.1 [GRANT], Pgina 254. ca a Quando voc se conecta a um servidor MySQL com um cliente de linha de comando e voc pode especicar a senha com --password=sua-senha. Veja Seo 4.3.8 [Connecting], e ca Pgina 238. a mysql --user=monty --password=guess nome_do_banco Se voc deseja que o cliente lhe solicite a senha, deve ser especicado o parmetro -e a password sem nenhum argumento mysql --user=monty --password nome_do_banco ou no formato curto: mysql -u monty -p nome_do_banco Perceba que no ultimo exemplo a senha no nome do banco. a e Se voc deseja usar a opo -p para fornecer uma senha voc deve fazer assim: e ca e mysql -u monty -pguess database_name

260

MySQL Technical Reference for Version 5.0.0-alpha

Em alguns sistemas, a chamada da biblioteca que utilizada pelo MySQL para solicitar por e uma senha corta automaticamente a senha para 8 caracteres. Internamente o MySQL no a limita o tamanho limite da senha.

4.4.3 Quando as Alteraoes nos Privilgios tem Efeito c e

Quando o mysqld inicia, todas o contedo das tabelas de permisses so lidos em memria u o a o e tem efeito neste momento. As modicaes das tabelas de permisses que voc realiza utilizando GRANT, REVOKE ou co o e SET PASSWORD so imediatamente reconhecidas pelo servidor. a Se voc alterar as tabelas de permisses manualmente (utilizando INSERT, UPDATE, etc), voc e o e deve executar a instruo FLUSH PRIVILEGES ou executar mysqladmin flush-privileges ca ou mysqladmin reload para dizer ao servidor para recarregar as tabelas de permisses. De o outra forma suas alteraes no tero efeito at que o servidor seja reiniciado. Se voc co a a e e alterar as tabelas de permisses manualmente mas se esquecer de recarregar os privilgios, o e suas alterao vo parecer no ter feito nenhuma diferena! ca a a c Quando o servidor reconhecer que as tabelas de permisses foram alteradas, conexes exiso o tentes so afetadas da seguinte forma: a Alteraes nos privilgios de tabelas e colunas fazem efeito com a prxima requisio co e o ca do cliente. Alteraes nos privilgios de bancos de dados fazem efeito no prximo comando USE co e o nome_bd. Alteraes nos privilgios globais e alteraes de senhas fazem efeito na prxima vez co e co o que o cliente conectar.

4.4.4 Congurando os Privilgios Iniciais do MySQL e

Depois de instalar o MySQL, voc congura os privilgios iniciais dos acessos executando e e scripts/mysql_install_db. Veja Seo 2.3.1 [Quick install], Pgina 95. O script mysql_ ca a install_db inicia o servidor mysqld, depois inicializa as tabelas de permisses com a o seguinte congurao dos privilgios: ca e O usurio root do MySQL criado como um superusurio que pode fazer qualquer a e a coisa. Conexes devem ser feitas atravs da mquina local. o e a NOTA: A senha inicial de root vazia, portanto qualquer um que conectar como root e sem senha ter direito a todos os privilgios. a e Um usurio annimo criado e pode fazer o que desejar com bancos de dados com a o e nome test ou iniciando com test_. Conexes devem ser feitas da mquina local. o a Isto signica que usurios locais podem se conectar sem senha e serem tratados como a usurios annimos. a o Outros privilgios so negados. Por exemplo, usurios normais no podem executar e a a a mysqladmin ou mysqladmin processlist. NOTA: Os privilgios padres so diferentes no Windows. Veja Seo 2.1.1.8 [Executando e o a ca o Windows], Pgina 68. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

261

Como sua instao inicialmente parcialmente aberta, uma das primeiras coisas que voc ca e e deve fazer especicar uma senha para o usurio root do MySQL. Voc pode fazer isto e a e como a seguir (perceba que a senha foi especicada utilizando a funo PASSWORD()): ca shell> mysql -u root mysql mysql> SET PASSWORD FOR root@localhost=PASSWORD(nova_senha); Substitua nova_senha pela senha que voc deseja usar. e Se voc souber o que esta fazendo, voc tambm pode manipular diretamente a tabela e e e privilgios: e shell> mysql -u root mysql mysql> UPDATE user SET Password=PASSWORD(nova_senha) -> WHERE user=root; mysql> FLUSH PRIVILEGES; Outra forma de congurar a senha utilizando o comando mysqladmin: e shell> mysqladmin -u root password nova_senha Somente usurios com acesso de escrita/atualizao ao banco de dados mysql podem a ca alterar a senha de outros usurios. Todos os usurios comuns (no os annimos) a a a o podem alterar somente a prpria senha com um dos comandos acima ou com SET o PASSWORD=PASSWORD(nova_senha). Perceba que se voc atualizar a senha na tabela user diretamente utilizando UPDATE, voc e e deve dizer ao servidor para reler as tabelas de permisses (com FLUSH PRIVILEGES), de o outra forma a alterao no seria noticada. ca a Uma vez que a senha de root foi congurada, voc deve informar a senha quando se conectar e ao servidor MySQL como root. Voc pode desejar deixar a senha de root em branco para que voc no precise especic-la e e a a quando realizar conguraes adicionais ou testes. Entretanto, tenha certeza de congur-la co a antes de utilizar sua instalao para qualquer ambiente de produo. ca ca Veja o script scripts/mysql_install_db para ver como so congurados os privilgios a e padres. Voc pode usar isto como uma base para ver como adicionar outros usurios. o e a Se voc deseja que os privilgios iniciais sejam diferentes do descrito acima, poss e e e ivel modicar o script mysql_install_db antes de execut-lo. a Para recriar as tabelas de permisses completamente, remova todos os arquivos .frm .MYI o e .MYD no diretrio contendo o banco de dados mysql. (Este o diretrio chamado mysql o e o sob o diretrio do banco de dados, que listado quando voc executa mysqld --help.) o e e Depois execute o script mysql_install_db, possivelmente depois de edit-lo para criar os a privilgios desejveis. e a NOTA: Para verses do MySQL mais antigas que a verso 3.22.10, voc no deve apagar o a e a os arquivos .frm. Se voc zer isso acidentalmente, voc deve volt-los a partir de sua e e a distribuio MySQL antes de executar mysql_install_db. ca

4.4.5 Adicionando Novos Usurios ao MySQL a

Existem duas maneiras de adicionar usurios: utilizando instrues GRANT ou manipulando a co as tabelas de permisses do MySQL diretamente. O mtodo preferido utilizar instrues o e e co

262

MySQL Technical Reference for Version 5.0.0-alpha

GRANT, porque elas so mais concisas e menos propensas a erros. Veja Seo 4.4.1 [GRANT], a ca Pgina 254. a Existem vrios programas de colaboradores (como o phpMyAdmin) que podem ser utilizados a para criar e administrar usurios. Veja Apndice B [Contrib], Pgina 940. a e a Os exemplos abaixo mostram como usar o cliente mysql para congurar novos usurios. a Estes exemplos assumem que privilgios so congurados de acordo com os padres descritos e a o na seo anterior. Isto signica que para fazer alteraes, voc deve se conectar na mesma ca co e mquina em que o mysqld est executando, voc deve se conectar com o usurio root, e a a e a o usurio root deve ter os privilgios inster ao banco de dados mysql e o administrativo a e reload. Tambm, se voc alterou a senha do usurio root, voc deve especic-la para os e e a e a comandos mysql abaixo. Primeiro, use o programa mysql para se conectar ao servidor como o usurio root do a MySQL: shell> mysql --user=root mysql Voc pode adicionar novos usurios utilizando instrues GRANT: e a co mysql> GRANT ALL PRIVILEGES ON *.* TO monty@localhost IDENTIFIED BY alguma_senha WITH GRANT OPTION; mysql> GRANT ALL PRIVILEGES ON *.* TO monty@% IDENTIFIED BY alguma_senha WITH GRANT OPTION; mysql> GRANT RELOAD,PROCESS ON *.* TO admin@localhost; mysql> GRANT USAGE ON *.* TO dummy@localhost; Estas instrues GRANT conguram trs novos usurios: co e a monty Um superusurio completo que pode conectar ao servidor de qualquer lugar, a mas deve utilizar uma senha alguma_senha para fazer isto. Perceba que devemos utilizar instrues GRANT para monty@localhost e monty@"%". Se ns co o no adicionarmos a entrada com localhost, a entrada para o usurio annimo a a o para localhost que criada por mysql_install_db toma precedncia quando e e nos conectarmos da mquina local, porque ele contem um campo Host com um a valor mais espec ico e tambm vem antes na ordenao da tabela user. e ca Um usurio que possa conectar de localhost sem uma senha e que concedido a e os privilgios administrativos reload e process. Isto permite ao usurio a exe a ecuo dos comandos mysqladmin reload, mysqladmin refresh e mysqladmin ca flush-*, bem como o mysqladmin processlist. Nenhum privilgio a n de e ivel bancos de dados concedido. (Depois eles podem ser adicionados utilizando e instrues GRANT adicionais.) co Um usurio que pode conectar sem uma senha, mas somente na mquina loa a cal. No so concedidos nenhum privilgioo tipo de privilgio USAGE permite a a e e a criao de um usurio sem privilgios. Ele tem o efeito de criar todos os ca a e privilgios globais com N. Considera-se que voc ir conceder privilgios ese e a e pec icos a conta posteriormente.

admin

dummy

Tambm poss e e ivel adicionar a mesma informao de acesso do usurio diretamente, utica a lizando instrues INSERT e depois dizendo ao servidor para recarregar as tabelas de perco misses: o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

263

shell> mysql --user=root mysql mysql> INSERT INTO user VALUES(localhost,monty,PASSWORD(alguma_senha), Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y); mysql> INSERT INTO user VALUES(%,monty,PASSWORD(alguma_senha), Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y,Y); mysql> INSERT INTO user SET Host=localhost,User=admin, Reload_priv=Y, Process_priv=Y; mysql> INSERT INTO user (Host,User,Password) VALUES(localhost,dummy,); mysql> FLUSH PRIVILEGES; Dependendo da sua verso do MySQL, voc pode precisar utilizar um nmero diferente de a e u valores Y acima. (Verses anteriores ` verso 3.22.11 tem menos campos de privilgios, o a a e e posteriores a 4.02 tm mais). Para o usurio admin, a maior sintaxe legivel de INSERT e a usando SET que est dispon a partir da verso 3.22.11 a utilizada. a ivel a e Note que para congurar um superusurio, voc s precisar criar uma entrada na tabela a e o user com os campos de privilgios congurados para Y. No necessrio gerar entradas e a e a nas tabelas db ou host. Na ultima instruo INSERT (para o usurio dummy), apenas as colunas Host, User e ca a Password nos registros da tabela user tem valores atribu idos. Nenhuma das colunas de privilgios so denidas explicitamente, assim o MySQL atribui a todas o valor padro de e a a N. Isto a mesma coisa que o GRANT USAGE faz. e O seguinte exemplo adiciona um usurio custom que pode acessar o banco de a dados bankaccout apenas do localhost, o banco de dados expenses somente de whitehouse.gov e o banco de dados customer de todas de server.domain. Ele deseja utilizar a senha obscure das trs mquinas. e a Para congurar os privilgios deste usurio utilizando instrues GRANT, execute estes coe a co mandos: shell> mysql> -> -> -> mysql> -> -> -> mysql> -> -> -> mysql --user=root mysql GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON bankaccount.* TO custom@localhost IDENTIFIED BY obscure; GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON expenses.* TO custom@whitehouse.gov IDENTIFIED BY obscure; GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON customer.* TO custom@server.domain IDENTIFIED BY obscure;

Para congurar os privilgios do usurio modiciando as tabelas de permisses diretamente, e a o utilize estes comandos (perceba o FLUSH PRIVILEGES no nal): shell> mysql --user=root mysql mysql> INSERT INTO user (Host,User,Password) -> VALUES(localhost,custom,PASSWORD(obscure));

264

MySQL Technical Reference for Version 5.0.0-alpha

mysql> -> mysql> -> mysql> -> -> -> -> mysql> -> -> -> -> mysql> -> -> ->

INSERT INTO user (Host,User,Password) VALUES(whitehouse.gov,custom,PASSWORD(obscure)); INSERT INTO user (Host,User,Password) VALUES(server.domain,custom,PASSWORD(obscure)); INSERT INTO db (Host,Db,User,Select_priv,Insert_priv,Update_priv,Delete_priv, Create_priv,Drop_priv) VALUES (localhost,bankaccount,custom,Y,Y,Y,Y,Y,Y); INSERT INTO db (Host,Db,User,Select_priv,Insert_priv,Update_priv,Delete_priv, Create_priv,Drop_priv) VALUES (whitehouse.gov,expenses,custom,Y,Y,Y,Y,Y,Y); INSERT INTO db (Host,Db,User,Select_priv,Insert_priv,Update_priv,Delete_priv, Create_priv,Drop_priv) VALUES(server.domain,customer,custom,Y,Y,Y,Y,Y,Y);

Como no exemplo anterior que usaram as instrues INSERT, voc pode precisar de usar co e um nmero diferentes de valores Y, dependendo de sua verso do MySQL. u a As primeiras trs instrues INSERT adicionam entradas na tabela user que permite ao e co usurio custom conectar a partir de vrias mquinas com a senha determinada, mas no a a a a concede permisses ao mesmo (todos os privilgios so congurados com o valor padro de o e a a N). As prximas trs instrues INSERT adicionam entradas na tabela db que concedem o e co privilgios ` custom para os bancos de dados bankaccount, expenses e customer, mas s e a o quando acessados ` partir das mquinas apropriadas. Normalmente, depois de modicar a a as tabelas de permisses diretamente, voc deve dizer ao servidor para recarreg-las (com o e a FLUSH PRIVILEGES) para que as alteraes nos privilgios tenham efeito. co e Se voc deseja fornecer a um usurio espec e a ico acesso de qualquer mquina em um detera minado dom inio (por exemplo, meudomnio.com), voc pode utilizar uma instruo GRANT i e ca como a seguir: mysql> GRANT ... -> ON *.* -> TO myusername@%.mydomain.com -> IDENTIFIED BY mypassword; Para realizar a mesma coisa modicando diretamente as tabelas de permisses, faa isto: o c mysql> INSERT INTO user VALUES (%.meudominio, meunomedeusuario PASSWORD(minhasenha),...); mysql> FLUSH PRIVILEGES;

4.4.6 Deletando Usurios do MySQL a

DROP USER nome_usuario Este comando foi adicionado ao MySQL 4.1.1.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

265

Ele apaga um usurio que no possua nenhum privilgio. a a a Para deletar um usurio do MySQL voc usar o seguinte procedimento, realizando os passos a e na ordem mostrada. 1. Verique quais privilgios o usurio tem com SHOW PRIVILEGES. Veja Seo 4.6.8.11 e a ca [SHOW PRIVILEGES], Pgina 325. a 2. Delete todos os privilgios do usurio com REVOKE. e a Pgina 254. a 3. Delete o usurio com DROP USER. a Se voc estiver usando uma verso mais antiga do MySQL voc deve primeiro revogar os e a e privilgios e ento deletar o usurio com: e a a DELETE FROM mysql.user WHERE user=username and host=hostname; FLUSH PRIVILEGES; Veja Seo 4.4.1 [GRANT], ca

4.4.7 Limitando os Recursos dos Usurios a

A partir do MySQL 4.0.2 pode se limitar certos recursos por usurios. a At ento, o unico mtodo dispon de limitao de uso do servidor MySQL era cangurar e a e ivel ca a varivel de inicializao max_user_connections para um valor diferente de zero. Mas a ca este mtodo estritamente global e no permite o gerenciamento de usurios individuais, e e a a o que pode ser de interresse particular do Provedor de Servios Internet. c Consequentemente, o gerenciamento de trs recursos introduzido no n de usurio ine e ivel a dividual: Nmero de todas as consultas por hora: Todos os comandos que podiam ser executados u por um usurio. a Nmero de todas as atualizaes por hora: Qualquer comando que altera qualquer u co tabela ou banco de dados. Nmeor de conexes feitas por hora: Novas conexes abertas por hora. u o o Um usurio no contexto mencionado acima uma unica entrada na tabela user, que a e e identicada unicamente por suas colunas user e host. Todos os usurios no so limitados por padro no uso dos recursos acima, a menos que a a a a os limites sejam garantidos a eles. Estes limites podem ser concedidos apenas atravs do e GRANT (*.*) global, usando esta sintaxe: GRANT ... WITH MAX_QUERIES_PER_HOUR N1 MAX_UPDATES_PER_HOUR N2 MAX_CONNECTIONS_PER_HOUR N3; Pode-se especicar qualquer combinao dos recursos acima. N1, N2 e N3 so inteiros e ca a signicam contagem/hora. Se os usurios alcanam o limite de conexes dentro de uma hora, no ser aceita mais a c o a a nenhuma conexo at o m desta hora. De forma parecida se o usurio alcana o limite do a e a c nmero de consultas ou atualizaes, consultas ou atualizaes adicionais sero rejeitadas u co co a at que a hora acabe. Em todos os casos, uma mensagem de erro apropriada enviada. e e

266

MySQL Technical Reference for Version 5.0.0-alpha

Os valores atualmente usados por um usurio em particular pode ser descarregados (zerados) a enviando uma instruo GRANT com qualquer das clusulas acima, inclu ca a indo uma instruo ca GRANT com os valores atuais. Os valores atuais para todos os usurios para todos os usurios sero descarregados se os a a a privilgios forem recarregados (no servidor ou usando mysqladmin reload) ou se o comando e FLUSH USER_RESOURCES executado. e O resurso est habilitado assim que e concedido a um unico usurio qualquer das clusulas a a a GRANT de limitao. ca Como um prerequisito para a habilitao deste recurso, a tabela user no banco de dados ca mysql deve conter as colunas adicionais, como denido no script de criao de tabelas ca mysql_install_db e mysql_install_db.sh no subdiretrio scripts. o

4.4.8 Congurando Senhas

Na maioria dos casos voc deve utilizar GRANT para congurar seus usurios e senhas, pore a tanto, as informaes exibidas a seguir so aplicadas somentes para usurios avanados. co a a c Veja Seo 4.4.1 [GRANT], Pgina 254. ca a Os exemplos nas sees precedentes ilustram um princ co ipio importante: quando voc are mazena uma senha no-vazia utilizando INSERT ou UPDATE voc deve utilizar a funo a e ca PASSWORD() para criptograf-la. Isto porque a tabela user armazena senhas na forma a e criptografada, e no como texto puro. Se voc esquecer deste fato, provvel que voc a e e a e possa tentar congurar senhas desta forma: shell> mysql -u root mysql mysql> INSERT INTO user (Host,User,Password) VALUES(%,jeffrey,biscuit); mysql> FLUSH PRIVILEGES; O resultado que o valor biscuit armazenado como a senha na tabela user. Quando e e o usurio jeffrey tentar se conectar ao servidor utilizando esta senha, o cliente mysql a a criptografa utilizando a funo PASSWORD(), gerando um vetor de autenticao baseado em ca ca uma senha criptografada e um nmero randmico, obtido do servidor, e envia o resultado u o ao servidor. O servidor usa o valor do campo password na tabela user (que o valor e biscuit no criptografado ) para realizar os mesmos clculos e comparar os resultados. a a A comparao falha e o servidor rejeita a conexo: ca a shell> mysql -u jeffrey -pbiscuit test Access denied As senhas devem ser criptografadas quando elas so inseridas na tabela user, portanto a a instruo INSERT deveria ter sido informada no seguinte formato: ca mysql> INSERT INTO user (Host,User,Password) VALUES(%,jeffrey,PASSWORD(biscuit)); Voc deve tambm utilizar a funo PASSWORD() quando utilizar instrues SET PASSWORD: e e ca co mysql> SET PASSWORD FOR jeffrey@"%" = PASSWORD(biscuit); Se voc congurar senhas utilizando a instruo GRANT ... IDENTIFIED BY ou o comando e ca mysqladmin password, a funo PASSWORD() desnecessria. Ambos tomam o cuidado de ca e a criptografar a senha para voc, ento voc deve especicar a senha biscuit desta forma: e a e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

267

mysql> GRANT USAGE ON *.* TO jeffrey@"%" IDENTIFIED BY biscuit; ou shell> mysqladmin -u jeffrey password biscuit NOTA: PASSWORD() diferente da senha criptografada do Unix. e

4.4.9 Mantendo Sua Senha Segura

No aconselhvel especicar uma senha de uma forma que a exponha e possa ser descoberta a e a por outros usurios. Os mtodos que voc pode usar para especicar sua senha quando a e e executar programas clientes so listados abaixo, juntamente com as determinaes de riscos a co de cada mtodo: e Nunca fornea a um usurio normal acesso ` tabela mysql.user. O conhecimento de c a a uma senha criptografada possibilita a conexo como este usurio. As senhas s esto a a o a chegar ` senha real que foi usada (acontece embaralhadas para que no seja possivel a a muito a utilizao de senhas similares em outras aplicaes). ca co Uso da opo -psua_senha ou --password=sua_senha na linha de comando. Isto ca e conveniente mas inseguro, porque sua senha se torna vis ivel para programas de informao do sistema (como no ps) que pode ser chamado por outros usurios para ca a exibir linhas de comando. (clientes MySQL normalmente gravam zeros em cima do argumento da linha de comando durante sua sequncia de inicializao, mas ainda existe e ca um breve intervalo no qual o valor est visivel.) a Uso das opes -p ou --pasword (sem especicar o valor sua_senha). Neste caso, o co programa cliente solicita a senha do terminal: shell> mysql -u user_name -p Enter password: ******** Os caracteres * representam sua senha. E mais seguro digitar sua senha desta forma do que especic-la na linha de comando a porque ela no ca vis a outros usurios. Entretanto este mtodo de digitar uma a ivel a e senha vlido somente para programas que voc executa de forma interativa. Se voc e a e e deseja chamar um cliente de um script que no execute interativamente, no existir a a a oportunidade de digitar a senha do terminal. Em alguns sistemas, voc pode descobrir e que a primeira linha do seu script lida e interpretada (incorretamente) como sua e senha! Armazenar a sua senha em um arquivo de congurao. Por exemplo, voc pode listar ca e sua senha na seo [client] do arquivo .my.cnf no seu diretrio home: ca o [client] password=sua_senha Se voc armazenar sua senha em um arquivo .my.cnf, o arquivo no pode ser lido por e a seu grupo ou pelos outros usurios. Tenha certeza que o modo de acesso do arquivo a e 400 ou 600 Veja Seo 4.1.2 [Option les], Pgina 216. ca a Voc pode armazenar sua senha na varivel de ambiente MYSQL_PWD, mas este mtodo e a e deve ser considerado extremamente inseguro e no deve ser usado. Algumas verses a o de ps incluem uma opo para exibir o ambiente de processos em execuo; sua senha ca ca estaria em texto puro para a leitura para todos os usurios. Mesmo em sistemas sem a

268

MySQL Technical Reference for Version 5.0.0-alpha

esta verso do ps, seria imprudncia assumir que no existe outro mtodo para observar a e a e o ambiente de processos. Veja Apndice F [Variveis de ambiente], Pgina 1092. e a a Em resumo, os mtodos mais seguros seriam que o programa cliente solicitasse a senha ou e especicar a senha em um arquivo .my.cnf corretamente protegido.

4.4.10 Usando Conexes Seguras o 4.4.10.1 Conceitos Basicos

A partir da verso 4.0.0, o MySQL tem suporte a conexes cri[ptografadas com SSL. Para a o entender como o MySQL usa SSL, necessrio explicar alguns conceits bsicos de SSL e e a a X509. A pessoal que j esto familiarizada com eles podem saltar esta parte. a a Por padro o MySQL no usa conexes criptografadas entre o cliente e o servidor. Isto a a o signica que qualquer um pode observar todo o trco e ver os dados enviados e recebidos. a Podiase at mesmo alterar os dados enquanto eles estavam em transito entre o cliente e o e servidor. Algumas vezes voc precisao mover informaes sobre redes pblicas de um modo e co u seguro; em tais casos, usar uma conexo sem criptograa inaceitvel. a e a SSL um protocolo que utiliza diferentes algor e itimos de criptograa para assegurar que os dados recebidos por uma rede pblica so conveis. Ele tem um mecanismo para detectar u a a qualquer alterao, perda ou reenvio de dados. SSL tambm incorpora algoritmos para ca e reconhecer e fornecer identidades de vericao usando o padro X509. ca a Criptograa o modo de tornar qualquer tipo de dado ileg e ivel. De fato, as prticas de a hoje precisam de muitos elementos de segurana adicionais para algoritmos de criptograa. c Eles devem resistir a muitos tipos de atques conhecidos como apenas alterando a ordem da mensagem criptografada ou emviando o dado duas vezes. X509 um padro que torna poss e a ivel identicar algum na Internet. Ele mais comue e mente usado em aplicaes e-commerce. Em termos bsicos, deve haver algumas empreco a sas (chamadas Autoridades de Certicao) que atribuem certicados eletrnicos para ca o qualquer um que precise deles. Os certicados se baseiam em algor itmos de criptograa assimtricos que possuem duas chaves de criptograa (uma chave pblica e uma chave secreta). e u Um proprietrio de certicado pode provar a sua identidade mostrnado este certicado para a outra parte. Um certicado consiste das chaves pblicas do proprietrio. Qualquer dados u a criptografado com esta chave pblica pode ser descriptografada apenas usando a chave u secreta correspondente, que guardada pelo dono do certicado. e O MySQL no utiliza conexes criptografadas por padro, porque fazendo isto tornaria o a o a protocolo cliente/servidor muito lento. Qualquer tipo de funcionalidade adiocional exige que o conputador faa um trabalho adicional e a criptograa de dados uma operao c e ca intensiva da CPU que exige tempo e pode atrasar o MySQL nas tarefas principais. Por padro o MySQL ajustado para ser o mais rpido poss a e a ivel. Se voc precisa de mais informaes sobre SSL, X509 ou criptograa, voc deve usar se e co e mecanismo de busca favorita na Internet para procurar sobre o assunto que est interessado. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

269

4.4.10.2 Exigncias e
Para conseguir conexes seguras para trabalhar com o MySQL voc deve fazer o seguinte: o e 1. Insatale o biblioteca OpenSSL. Testamos o MySQL com OpenSSL 0.9.6. http://www.openssl.org/. 2. Congure o MySQL com --with-vio --with-openssl. 3. Se voc estiver usando um instalao antiga do MySQL, voc tem que atualizar a sua e ca e tabela mysql.user com algumas novas colunas relacionadas a SSL. Isto necessrio se e a suas tabelas de permisses so de uma verso anterior ao MySQL 4.0.0. O procedimento o a a est descrito em Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. a ca a 4. Voc pode vericar se um servidor mysqld em execuo suporta OpenSSL examinando e ca se SHOW VARIABLES LIKE have_openssl retorna YES.

4.4.10.3 Congurando Certicados SSL para o MySQL

Aqui est um exemplo para congurar certicados SSL para o MySQL: a DIR=pwd/openssl PRIV=$DIR/private mkdir $DIR $PRIV $DIR/newcerts cp /usr/share/ssl/openssl.cnf $DIR replace ./demoCA $DIR -- $DIR/openssl.cnf # Crie os aarquivos necessrio: $database, $serial e o diretrio a o $new_certs_dir (opcional) touch $DIR/index.txt echo "01" > $DIR/serial # # Gera~o do Certificate Authority(CA) ca # openssl req -new -x509 -keyout $PRIV/cakey.pem -out $DIR/cacert.pem \ -config $DIR/openssl.cnf # # # # # # # # # Saida exemplo: Using configuration from /home/monty/openssl/openssl.cnf Generating a 1024 bit RSA private key ................++++++ .........++++++ writing new private key to /home/monty/openssl/private/cakey.pem Enter PEM pass phrase: Verifying password - Enter PEM pass phrase: -----

270

MySQL Technical Reference for Version 5.0.0-alpha

# # # # # # # # # # # # # #

You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter ., the field will be left blank. ----Country Name (2 letter code) [AU]:FI State or Province Name (full name) [Some-State]:. Locality Name (eg, city) []: Organization Name (eg, company) [Internet Widgits Pty Ltd]:MySQL AB Organizational Unit Name (eg, section) []: Common Name (eg, YOUR name) []:MySQL admin Email Address []:

# # Create server request and key # openssl req -new -keyout $DIR/server-key.pem -out \ $DIR/server-req.pem -days 3600 -config $DIR/openssl.cnf # # # # # # # # # # # # # # # # # # # # # # # # # # Sada exemplo: i Using configuration from /home/monty/openssl/openssl.cnf Generating a 1024 bit RSA private key ..++++++ ..........++++++ writing new private key to /home/monty/openssl/server-key.pem Enter PEM pass phrase: Verifying password - Enter PEM pass phrase: ----You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter ., the field will be left blank. ----Country Name (2 letter code) [AU]:FI State or Province Name (full name) [Some-State]:. Locality Name (eg, city) []: Organization Name (eg, company) [Internet Widgits Pty Ltd]:MySQL AB Organizational Unit Name (eg, section) []: Common Name (eg, YOUR name) []:MySQL server Email Address []: Please enter the following extra attributes to be sent with your certificate request

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

271

# A challenge password []: # An optional company name []: # # Remove the passphrase from the key (optional) # openssl rsa -in $DIR/server-key.pem -out $DIR/server-key.pem # # Assina o certificado do servidor # openssl ca -policy policy_anything -out $DIR/server-cert.pem \ -config $DIR/openssl.cnf -infiles $DIR/server-req.pem # # # # # # # # # # # # # # # # Sada exemplo: i Using configuration from /home/monty/openssl/openssl.cnf Enter PEM pass phrase: Check that the request matches the signature Signature ok The Subjects Distinguished Name is as follows countryName :PRINTABLE:FI organizationName :PRINTABLE:MySQL AB commonName :PRINTABLE:MySQL admin Certificate is to be certified until Sep 13 14:22:46 2003 GMT (365 days) Sign the certificate? [y/n]:y

1 out of 1 certificate requests certified, commit? [y/n]y Write out database with 1 new entries Data Base Updated

# # Create client request and key # openssl req -new -keyout $DIR/client-key.pem -out \ $DIR/client-req.pem -days 3600 -config $DIR/openssl.cnf # # # # # # # # # Saida exemplo: Using configuration from /home/monty/openssl/openssl.cnf Generating a 1024 bit RSA private key .....................................++++++ .............................................++++++ writing new private key to /home/monty/openssl/client-key.pem Enter PEM pass phrase: Verifying password - Enter PEM pass phrase: -----

272

MySQL Technical Reference for Version 5.0.0-alpha

# # # # # # # # # # # # # # # # # # #

You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter ., the field will be left blank. ----Country Name (2 letter code) [AU]:FI State or Province Name (full name) [Some-State]:. Locality Name (eg, city) []: Organization Name (eg, company) [Internet Widgits Pty Ltd]:MySQL AB Organizational Unit Name (eg, section) []: Common Name (eg, YOUR name) []:MySQL user Email Address []: Please enter the following extra attributes to be sent with your certificate request A challenge password []: An optional company name []:

# # Remove a passphrase from the key (optional) # openssl rsa -in $DIR/client-key.pem -out $DIR/client-key.pem # # Sign client cert # openssl ca -policy policy_anything -out $DIR/client-cert.pem \ -config $DIR/openssl.cnf -infiles $DIR/client-req.pem # # # # # # # # # # # # # # # Sada exemplo: i Using configuration from /home/monty/openssl/openssl.cnf Enter PEM pass phrase: Check that the request matches the signature Signature ok The Subjects Distinguished Name is as follows countryName :PRINTABLE:FI organizationName :PRINTABLE:MySQL AB commonName :PRINTABLE:MySQL user Certificate is to be certified until Sep 13 16:45:17 2003 GMT (365 days) Sign the certificate? [y/n]:y

1 out of 1 certificate requests certified, commit? [y/n]y Write out database with 1 new entries

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

273

# Data Base Updated # # Create a my.cnf file that you can use to test the certificates # cnf="" cnf="$cnf [client]" cnf="$cnf ssl-ca=$DIR/cacert.pem" cnf="$cnf ssl-cert=$DIR/client-cert.pem" cnf="$cnf ssl-key=$DIR/client-key.pem" cnf="$cnf [mysqld]" cnf="$cnf ssl-ca=$DIR/cacert.pem" cnf="$cnf ssl-cert=$DIR/server-cert.pem" cnf="$cnf ssl-key=$DIR/server-key.pem" echo $cnf | replace " " > $DIR/my.cnf # # To test MySQL mysqld --defaults-file=$DIR/my.cnf & mysql --defaults-file=$DIR/my.cnf Voc tambm pode testar sua congurao modicando o arquivo my.cnf acima para fazer e e ca referncia aos certicados de demonstrao no diretrio mysql-dist-fonte/SSL. e ca o

4.4.10.4 Opoes SSL do GRANT c

O MySQL pode vericar atributos do certicado X509 em adio ao esquema normal de ca usurio/senha. Todas as opes comuns ainda so exigidas (usurio, senha, mscara do a co a a a endereo IP, noome tabela/banco de dados). c Existem diferentes possibilidades para limitarmos as conexes: o Sem nenhuma opo SSL ou X509, todos os tipos de conexes criptografadas/ descripca o tografadas so permitidas se o usurio e senha so vlidos. a a a a A opo REQUIRE SSL limita o servidor para permitir apenas conexes criptografadas ca o SSL. Note que esta opo pode ser omitida se no houver nenhum registro ACL que ca a permita conexes no SSL. o a mysql> GRANT ALL PRIVILEGES ON test.* TO root@localhost -> IDENTIFIED BY goodsecret REQUIRE SSL; REQUIRE X509 signica que o cliente deve ter um certicado vlido mas no nos procua a pamos sobre o certicado, o emissor ou assunto exato. A unica restrio que deve ser ca e poss vericar a sua assinatura com um dos certicados CA. ivel mysql> GRANT ALL PRIVILEGES ON test.* TO root@localhost

274

MySQL Technical Reference for Version 5.0.0-alpha

-> IDENTIFIED BY goodsecret REQUIRE X509; REQUIRE ISSUER emissor coloca uma restrio na tentativa de conexo: O cliente ca a deve apresentar um certicado X509 vlido emitido pelo CA emissor. Usar o certia cado X509 sempre implica em criptograa, assim a opo SSL desnecessria. ca e a mysql> -> -> > GRANT ALL PRIVILEGES ON test.* TO root@localhost IDENTIFIED BY goodsecret REQUIRE ISSUER C=FI, ST=Some-State, L=Helsinki, O=MySQL Finland AB, CN=Tonu Samuel/Email=tonu@mysql.com;

REQUIRE SUBJECT assunto exige que o cliente tenha um certicado X509 com o assunto assunto. Se o cliente apresenta um certicado que valido mas tem um e assunto diferente, a conexo disabilitada. a e mysql> -> -> > > GRANT ALL PRIVILEGES ON test.* TO root@localhost IDENTIFIED BY goodsecret REQUIRE SUBJECT C=EE, ST=Some-State, L=Tallinn, O=MySQL demo client certificate, CN=Tonu Samuel/Email=tonu@mysql.com;

REQUIRE CIPHER mtodo necessrio para assegurar que uma criptograa forte ser e e a a usada. O SSL pode ser fraco se algoritmos antigos com chaves de criptograas curtas so usados. Usando esta opo, podemos pedir por algum mtodo de criptograa exato a ca e para permitir a conexo. a mysql> GRANT ALL PRIVILEGES ON test.* TO root@localhost -> IDENTIFIED BY goodsecret -> REQUIRE CIPHER EDH-RSA-DES-CBC3-SHA; As opes SUBJECT, ISSUER e CIPHER podem ser combinadas na clusula REQUIRE desta co a forma: mysql> -> -> > > -> > -> GRANT ALL PRIVILEGES ON test.* TO root@localhost IDENTIFIED BY goodsecret REQUIRE SUBJECT C=EE, ST=Some-State, L=Tallinn, O=MySQL demo client certificate, CN=Tonu Samuel/Email=tonu@mysql.com AND ISSUER C=FI, ST=Some-State, L=Helsinki, O=MySQL Finland AB, CN=Tonu Samuel/Email=tonu@mysql.com AND CIPHER EDH-RSA-DES-CBC3-SHA;

A partir do MySQL 4.0 a palavra chave AND opcional entre opes REQUIRE. e co A ordem das opes no importa, mas nenhuma opo pode ser especicada duas vezes. co a ca

4.4.10.5 Opes SSL de Linha de Comando co

A seguinte tabela lista opes que so usadas para especicar o uso de SSL, arquivos de co a certicado e arquivos de chaves. Estas opes esto dispon co a iveis a partir do MySQL 4.0. Elas podem ser dadas na linha de comando ou no arquivo de opo. ca --ssl Para o servidor, especica que o servidor permite conexes SSL. Para um proo grama cliente, permite que o cliente se conecte ao servidor usando SSL. Esta

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

275

opo por si s no suciente para fazer uma conexo SSL ser usada. Voc ca o a e a e tambm deve especicar as opes --ssl-ca, --ssl-cert, e --ssl-key. e co Note que esta opo no exige uma conexo SSL. Por exemplo, se o servidor ou ca a a clienteest compilado sem suporte SSL, uma conexo no criptografada normal a a a ser usada. a O modo seguro de de se certicar que uma conexo SSL ser usada criar uma a a e conta no servidor que inclua uma clusula REQUIRE SSL na instruo GRANT. a ca Ento use esta conta para se conectar ao servidor, com um servidor e cliente a que tenham suporte a SSL habilitado. Voc pode usar esta opo para indicar que a conexo no deve usar SSL. Faa e ca a a c isto especicando a opo como --skip-ssl ou --ssl=0. ca --ssl-ca=file_name O caminho para um arquivo vom uma lista de Certifcados SSL conveis. a --ssl-capath=directory_name O caminho para um diretrio que contm certicados SSL conveis no formato o e a pem. --ssl-cert=file_name O nome do arquivo de certicado SSL usado para estabelecer uma conexo a segura. --ssl-cipher=cipher_list Uma lista de chaves permitidas, usado para criptograa SSL. cipher_list tem o mesmo formato que o comando openssl ciphers. Example: --ssl-cipher=ALL:-AES:-EXP --ssl-key=file_name O nome do arquivo de chave SSL a ser usado para estabelecer uma conexo a segura.

4.5 Preveno de Disastres e Recuperao ca ca

4.5.1 Backups dos Bancos de Dados
Como as tabelas do MySQL so armazenadas como arquivos, mais fcil realizar um a e a backup. Para obter um backup consistente, faa um LOCK TABLES nas tabelas relevantes c seguido por FLUSH TABLES para as tabelas. Veja Seo 6.7.5 [LOCK TABLES], Pgina 617. ca a Veja Seo 4.6.4 [FLUSH], Pgina 299. Voc s precisa de um bloqueio de leitura; isto ca a e o possibilita outras threads a continuarem a pesquisar nas tabelas enquanto voc copia os e arquivos no diretrio do banco de dados. O FLUSH TABLE necessrio para garantir que o e a todas as pginas ativas de a indices sero escritas em disco antes de iniciar o backup. a A partir das verses 3.23.56 e 4.0.12 BACKUP TABLE no permitir que voc sobrescreva o a a e arquivos exixtentes j que isso colocaria em risco a segurana. a c Se voc desejar realizar um backup ao n da linguagem SQL de um tabela, voc pode utie ivel e lizar SELECT INTO OUTFILE ou BACKUP TABLE. Veja Seo 6.4.1 [SELECT], Pgina 562.Veja ca a Seo 4.5.2 [BACKUP TABLE], Pgina 277. ca a

276

MySQL Technical Reference for Version 5.0.0-alpha

Outra maneira de efetuar um backup de um banco de dados utilizar o programa mysqldump e ou o script mysqlhotcopy. Veja Seo 4.9.7 [mysqldump], Pgina 361. Veja Seo 4.9.8 ca a ca [mysqlhotcopy], Pgina 366. a 1. Fazer um backup completo do seu banco de dados: shell> mysqldump --tab=/path/to/some/dir --opt db_name ou shell> mysqlhotcopy db_name /path/to/some/dir Voc tambm pode simplesmente copiar os arquivos das tabelas (*.frm, *.MYD) e e e os arquivos *.MYI) quando o servidor no estiver atualizando nada. O script a mysqlhotcopy utiliza este mtodo. (Mas nopte que estes mtodos no funcionaro e e a a se seu banco de dados contm tabelas InnoDB. InnoDB no armazena o contedo das e a u tabelas em diretrios de banco de dados, e o mysqlhotcopy funciona apenas para o tabelas MyISAM e ISAM.) 2. Interrompa o mysqld caso ele esteja em execuo, depois inicie-o com a opo --logca ca bin[=nome_arquivo]. Veja Seo 4.10.4 [Log binrio], Pgina 374. Os arquivos de log ca a a binrio fornecem a informao necessria para replicar alteraes ao banco de dados a ca a co que forem feitas depois do ponto em que voc executou mysqldump. e Se o seu servidor MySQL um slave, seja qual for o mtodo de backup que voc escolha, e e e quando voc faz backup dos dados do slave, voc deve tambm fazer backup dos arquivos e e e master.info e relay-log.info que so necessrios para continuar a replicao depois a a ca que voc restaurar os dados do slave. Se seu slave est sujeito a replicao de comandos e a ca LOAD DATA INFILE, voc tambm deve fazer backup dos arquivos SQL_LOAD-* que podem e e existir no diretrio especicado pela opo slave-load-tmpdir. (A localizao padro o ca ca a desta opo o valor da varivel tmpdirse no especicado.) O slave precisar destes ca e a a a arquivos para continuar a replicao de qualquer LOAD DATA INFILE interrompido. ca Se voc necessita restaurar alguma coisa, tente primeiro recuperar suas tabelas utilizando e REPAIR TABLE ou myisamchk -r. Isto deve funcionar em 99.9% de todos os caso, Se o myisamchk falhar, tente o seguinte procedimento: (Isto s ir funcionar se voc iniciou o o a e MySQL com --log-update, veja Seo 4.10.4 [Binary log], Pgina 374,): ca a 1. Restaure o backup original feito com o mysqldump ou backup binrio. a 2. Execute o seguinte comando para re-executar as atualizaes armazenadas no log co binrio: a shell> mysqlbinlog hostname-bin.[0-9]* | mysql Em seu caso voc pode querer re-executar apenas alguns log binrios, a partir de certas e a posis (normalmente voc quer re-executar todos os log binrios a partir da data de co e a restaurao do backup, co exceo de algumas consultas erradas). Veja Seo 4.9.5 ca ca ca [mysqlbinlog], Pgina 358 fpara mais informaes sobre o utilitrio mysqlbinlog e a co a como us-lo. a Se voc estiver utilizando o log atualizado, voc pode executar o contedo do log de e e u atualizao desta forma: ca shell> ls -1 -t -r hostname.[0-9]* | xargs cat | mysql

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

277

O comando ls usado para obter todos os arquivos de log na ordem correta. e Voc pode tambm fazer backups seletivos com SELECT * INTO OUTFILE nome_arquivo e e FROM nome_tabela e restaurar com LOAD DATA INFILE nome_arquivo REPLACE.... Para evitar registros duplicados, voc precisar de um chave PRIMARY KEY ou uma UNIQUE na e a tabela. A palavra chave REPLACE substitui os antigos registros com os novos quando um novo registro duplica um antigo registro em uma chave de valores unicos. Se voc tiver problemas de performance realizando backups no seu sistema, voc pode e e resolver isto congurando uma replicao e fazendo os backups na mquina slave no lugar ca a da master. Veja Seo 4.11.1 [Introduo a Replicao], Pgina 378. ca ca ca a Se voc estiver utilizando um sistema de arquivos Veritas, voc pode fazer: e e 1. Executar em um cliente (perl ?) FLUSH TABLES WITH READ LOCK 2. Bifurcar uma shell ou executar em outro cliente mount vfxs snapshot. 3. Executar no primeiro cliente UNLOCK TABLES 4. Copiar arquivos do snapshot 5. Desmontar snapshot

4.5.2 Sintaxe de BACKUP TABLE

BACKUP TABLE nome_tabela[,nome_tabela...] TO /caminho/para/diretrio/backup o Faz uma cpia de todos os arquivos de tabela para o diretrio de backup que o m o o e inimo necessrio para restaur-lo. Atualmente s funciona para tabelas MyISAM. Para tabela a a o MyISAM, copia os arquivos .frm (denies) e .MYD (dados). O arquivo de co indice pode ser reconstru a partir destes dois. ido Antes de utilizar este comando, por favor veja Veja Seo 4.5.1 [Backup], Pgina 275. ca a Durante o backup, o bloqueio de leitura (read lock) ser usado para cada tabela, uma de a cada vez, ` medida que o backup realizado. Se voc deseja fazer backup de diversas tabelas a e e como um snapshot, voc deve primeiro usar LOCK TABLES obtendo um bloqueio de leitura e para cada tabela no grupo. O comando retorna uma tabela com as seguintes colunas: Coluna Valor Table Nome da Tabela Op Sempre backup Msg type Um dos seguintes: status, error, info ou warning. Msg text A mensagem Note que o comando BACKUP TABLE est dispon a ivel somente no MySQL verso 3.23.25 e a posterior.

4.5.3 Sintaxe de RESTORE TABLE

RESTORE TABLE nome_tabela[,nome_tabela...] FROM /caminho/para/diretrio/backup o Restaura a tabela ou tabelas utilizando o backup feito com BACKUP TABLE. Tabelas existentes no sero reescritas - se voc tentar restaurar sobre uma tabela existente, obter um a a e a erro. A restaurao demora mais tempo do que o backup pois necessrio reconstruir o ca e a

278

MySQL Technical Reference for Version 5.0.0-alpha

indice. Quanto mais chaves tiver, mais demorado ser. Como no comando BACKUP TABLE, a atualmente s funciona com tabelas MyISAM. o O comando retorna uma tabela com as seguintes colunas: Coluna Table Op Msg type Msg text Valor Nome da Tabela Sempre restore Um dos seguintes: status, error, info ou warning A mensagem

4.5.4 Sintaxe de CHECK TABLE

CHECK TABLE nome_tabela[,nome_tabela...] [op~o [op~o...]] ca ca op~o = QUICK | FAST | MEDIUM | EXTENDED | CHANGED ca CHECK TABLE funciona somente em tabelas MyISAM. Em tabelas MyISAM a mesma coisa e que executar myisamchk --medium-check nome_tabela na tabela. Se voc no especicar nenhuma opo, MEDIUM usado. e a ca e Verica se existem erros na(s) tabela(s). Para as tabelas MyISAM as estat isticas das chaves so atualizadas. O comando retorna uma tabela com as seguintes colunas: a Coluna Table Op Msg type Msg text Valor Nome da Tabela. Sempre check Um dos seguintes: status, error, info, or warning A mensagem

Note que a instruo pode produzir vrias linhas de informaes para cada tabela conferida. ca a co A ultima linha ir ser do tipo Msg_type status e normalmente deve estar OK. Se voc no a e a obteve OK ou Not checked, deve ser executado, normalmente, um reparo da tabela. Veja Seo 4.5.6 [Table maintenance], Pgina 280. Table is already up to date signica que o ca a gerenciador de armazenamento para a tabela indica que no h necessidade de vericar a a a tabela. Os diferentes tipos de consistncias so as seguintes: e a Tipo QUICK FAST CHANGED MEDIUM EXTENDED Signicado No busca os registros vericando ligaes incorretas. a co S confere tabelas que no foram fechadas corretamente. o a S verica as tabelas que foram alteradas desde a ultima conferncia ou que o e no foram fechadas corretamente. a Busca os registros para vericanado que ligaes removidas esto ok. Isto co a tambm calcula uma chave de conferncia para os registros e verica isto e e com um checksum calculado para as chaves. Faz uma busca completa nas chaves para todas as chaves em cada registro. Isto assegura que a tabela est 100% consistente, mas pode demorar muito a tempo para executar!

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

279

Para tabelas MyISAM de tamanho dinmico, uma vericao iniciada sempre far uma veria ca a cao MEDIUM. Para registros de tamanho esttico ns saltamos a busca de registros para ca a o QUICK e FAST j que os registros esto raramente corrompidos. a a Voc pode combinar opes de consistncia como no exemplo a seguir que faz uma vericao e co e ca rpida na tabela para ve se ela foi fechada corretamente: a CHECK TABLE test_table FAST QUICK; NOTA: em alguns casos CHECK TABLE ir alterar a tabela! Isto acontece se a tabela estiver a marcada como corrupted (corrompida) ou not closed properly (no foi fechada corretaa mente) mas o CHECK TABLE no encontrar no encontrar nenhum problema na tabela. Neste a a caso, CHECK TABLE ir marcar a tabela como ok. a Se uma tabela estiver corrompida, prefer que seja um problema nos e ivel indices e no na a parte de dados. Todos os tipos de consistncia acima sempre confere os indices e deve ento e a encontrar a maioria dos erros. Se voc s quiser conferir uma tabela que acredita estar ok, voc no deve utilizar nenhuma e o e a opo para o comando check ou utilizar a opo QUICK. O ultimo deve ser utilizado quando ca ca voc estiver com pressa e o r e isco do QUICK no encontrar um erro no arquivo de dados for a m inimo (Na maioria dos casos o MySQL pode encontrar, sob utilizao normal, qualquer ca erro no arquivo de dados. Se isto ocorrer, ento a tabela ser marcada como corrupted, a a neste caso a tabela no poder ser utilizada at ser reparada). a a e FAST e CHANGED so normalmente chamados a partir de um script (um exemplo ser exea e cutado a partir do cron) Se voc desejar conferir suas tabelas de tempos em tempos. Na e maioria dos casos, o FAT uma opo melhor que CHANGED. (O unico caso em que isto no e ca a acontece quando voc suspeita que encontrou um bug no cdigo do MyISAM.). e e o EXTENDED deve ser utilizado somente depois de ter executado um check normalmente, mas continuar obtendo erros de uma tabela quando o MySQL tenta atualizar um registro ou encontrar um registro pela chave (isto seria muito dif ocorrer caso uma conferncia normal icil e tenha executado com sucesso!). Alguns problemas relatados por CHECK TABLE, no podem ser corrigidas automaticamente: a Found row where the auto_increment column has the value 0. Isto signica que voc possui um registro na tabela onde o campo e indice que utiliza o poss criar um registro onde a coluna recurso auto_increment contem o valor 0. (E ivel de auto incremento seja 0 denindo explicitamente 0 em uma instruo UPDATE). ca Isto no exatamente um erro, mas pode causar problemas se voc decidir descarregar a e e a tabela e restaur-la ou executar um ALTER TABLE na tabela. Neste caso a coluna a de auto incremento ir alterar seu valor, de acordo com as regras das colunas de auto a incremento, que pode causar problemas como um erro de chave duplicada. Para se livrar do alerta, basta executar uma instruo UPDATE para congurar a coluna ca para algum outro valor diferente de 0.

4.5.5 Sintaxe do REPAIR TABLE

REPAIR [LOCAL | NO_WRITE_TO_BINLOG] TABLE tbl_name[,tbl_name...] [QUICK] [EXTENDED] REPAIR TABLE funciona somente em tabelas MyISAM e a mesma coisa que executar e myisamchk -r nome_tabela na tabela.

280

MySQL Technical Reference for Version 5.0.0-alpha

Normalmente voc nunca deve executar este comando, mas se um disastre ocorrer voc e e vai precisar recuperar seus dados de uma tabela MyISAM utilizando REPAIR TABLE. Se as suas tabelas estiverem muito corrompidas, voc deve encontrar a razo, para eleiminar e a a necessidade de se usar REPAIR TABLE! Veja Seo A.4.1 [Crashing], Pgina 925. Veja ca a Seo 7.1.3 [MyISAM table problems], Pgina 636. ca a REPAIR TABLE repara uma tabela possivelmente corrompida. O comando retorna uma tabela com as seguintes colunas: Coluna Valor Table Nome da Tabela Op Sempre repair Msg type Um dos seguintes: status, error, info ou warning Msg text A mensagem Note que a instruo pode produzir vrias linhas de informaes para cada tabela recuperca a co ada. A ultima linha ser de Msg_type status e normalmente deve exibir OK. Se o retorno a no for OK, voc pode tentar reparar a tabela com myisamchk -o, j que REPAIR TABLE a e a ainda no implementa todas as opes de myisamchk. Futuramente iremos torn-lo mais a co a ex ivel. Se o parmetro QUICK for especicado, REPAIR tenta reparar somente a rvore de a a indices. Se voc utilizar EXTENTED, o MySQL criar o indice, registro a registro em vez de criar e a um indice de uma vez com ordenao; Isto pode ser melhor que a ordenao em chaves de ca ca tamanho xo se voc tiver grandes chaves do tipo char() que compactam muito bem. e No MySQL 4.0.2, existe um modo USE_FRM para REPAIR. Use-o se o arquivo .MYI estiver faltando ou o seu cabealho estiver corrompido. Neste modo o MySQL recriar a c a tabela, usando a informao do arquivo .frm. Este tipo de reparo no pode ser feito com ca a myisamchk. Aviso: Se o mysqld morre durante um REPAIR TABLE, essencial que voc faa imediatae e c mente outro REPAIR na tabela antes de executar qualquer outro comando nela. (Claro que sempre bom inciar com um backup). No pior caso voc pode ter um novo arquivo de e e indice limpo sem informao sobre o arquivo de dados e quando voc executar o prximo ca e o comando o arquivo de dados pode ser sobreescrito. Isto no um cenrio desejvel, mas a e a a poss ivel. Antes do MySQL 4.1.1, o comando REPAIR no era gravado no log binrio. Desde o MySQL a a 4.1.1. eles so escritos no log binrio a menos que a palavra chave opcional NO_WRITE_TO_ a a BINLOG (ou seu alias LOCAL) seja usada.

4.5.6 Utilizando myisamchk para Manuteno de Tabelas e ca Recuperao em Caso de Falhas ca

A partir do MySQL verso 3.23.13 voc pode mandar vericar as tabelas MyISAM com o a e comando CHECK TABLE. Veja Seo 4.5.4 [CHECK TABLE], Pgina 278. Pode-se reparar ca a tabelas com o comando REPAIR TABLE. Veja Seo 4.5.5 [REPAIR TABLE], Pgina 279. ca a Para vericar/reparar tabelas MyISAM (.MYI e .MYD) voc deve utilizar o utilitrio e a myisamchk. Para consistir/reparar tabelas ISAM (.ISM e .ISD) voc deve usar o utilitrio e a isamchk. Veja Cap ptexi tulo 7 [Tipos de Tabelas], Pgina 630. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

281

No texto a seguir iremos comentar sobre o myisamchk, mas tudo tambm se aplica ao antigo e isamchk. Voc pode utilizar o utilitrio myisamchk para obter informaes sobre suas tabelas de e a co bancos de dados, verc-las, repar-las ou otimiz-las. As seguintes sees descrevem como a a a co executar myisamchk (incluindo uma descrio de suas opes), como montar um calendrio ca co a de manuteno, e como utilizar o myisamchk para executar suas vrias funes. ca a co Voc pode, na maioria dos casos, utilizar o comando OPTIMIZE TABLES para otimizar e e reparar tabelas, mas no to rpido e convel (no caso real de erros fatais) como o a e a a a mysisamchk. Por outro lado, OPTIMIZE TABLE mais fcil de usar e voc no tem que se e a e a preocupar com a recarrega das tabelas. Veja Seo 4.6.1 [OPTIMIZE TABLE], Pgina 298. ca a Embora os reparos realizados pelo myisamchk sejam bastante seguros, porm sempre uma e e boa idia fazer um backup dos dados ANTES de realizar um reparo (ou qualquer coisa que e far grandes alteraes em alguma tabela) a co

4.5.6.1 Sintaxe do myisamchk

myisamchk chamado desta forma: e shell> myisamchk [op~es] nome_tabela co As op~es especicam o que voc deseja que o myisamchk faa. Elas so descritas abaixo. co e c a (Voc tambm pode obter a lista das opes com myisamchk --help.) Sem opes, o e e co co myisamchk simplesmente checa sua tabela. Para obter maiores informaes ou dizer ao co myisamchk para tomar aes corretivas, especique as opes descritas abaixo e nas sees co co co seguintes. nome_tabela o nome da tabela do banco de dados que voc deseja vericar/reparar. e e Se voc executar o myisamchk em algum lugar diferente do diretrio do banco de dados, e o voc deve especicar o caminho para o arquivo, porque myisamchk no faz idia de onde e a e seu banco de dados se encontra. Na verdade, myisamchk no se importa se os arquivos a esto localizados em um diretrio de banco de dado; voc pode copiar os arquivos que a o e correspondem a uma tabela de banco de dados em outra localizao e realizar neste outro ca lugar as operaes corretivas. co Voc pode nomear vrias tabelas na linha de comando do myisamchk se voc desejar. Voc e a e e tambm pode especicar um nome como um arquivo de e indice (com o suxo .MYI), que lhe permite especicar todas tabelas em um diretrio utilizando o padro *.MYI. Por o a exemplo, se voc est em um diretrio de banco de dados, voc pode checar todas as e a o e tabelas no diretrio desta forma: o shell> myisamchk *.MYI Se voc no estiver no diretrio do banco de dados, voc pode vericar todas as tabelas e a o e existentes especicando o caminho para o diretrio: o shell> myisamchk /caminho/para/banco_de_dados/*.MYI Voc pode vericar todas as tabelas em todos os bancos de dados especicando um meta e caracter com o caminho para o diretrio de banco de dados do MySQL: o shell> myisamchk /caminho/para/diretrio_dados/*/*.MYI o A maneira recomendada para conferir todas as tabelas rapidamente : e

282

MySQL Technical Reference for Version 5.0.0-alpha

myisamchk --silent --fast /caminho/para/diretrio_dados/*/*.MYI o isamchk --silent /caminho/para/diretrio_dados/*/*.ISM o Se voc quiser conferir todas as tabelas e reparar todas que estiverem corrompidas, pode e utilizar linha a seguir: myisamchk --silent --force --fast --update-state -O key_buffer=64M \ -O sort_buffer=64M -O read_buffer=1M -O write_buffer=1M \ /caminho/para/diretrio_dados/*/*.MYI o isamchk --silent --force -O key_buffer=64M -O sort_buffer=64M \ -O read_buffer=1M -O write_buffer=1M /caminho/para/diretrio_dados/*/*.ISM o A linha acima assume que voc tem mais de 64 MB de memria livre. e o Perceba que se voc obter um erro do tipo: e myisamchk: warning: 1 clients is using or hasnt closed the table properly Isto signica que voc est tentando vericar uma tabela que est sendo atualizada por e a a outro programa (como o servidor mysqld) que ainda no fechou o arquivo ou que nalizou a sem fechar o arquivo corretamente. Se o mysqld est em execuo, voc deve forar o sincronimo e fechamento de todas tabelas a ca e c com FLUSH TABLES e assegurar que ningum mais esteja utilizando as tabelas quando for e executar o myisamchk. No MySQL verso 3.23 a forma mais simples de evitar este problema a utilizar CHECK TABLE no lugar de myisamchk para vericar as tabelas. e

4.5.6.2 Opes Gerais do myisamchk co

myisamchk suporta as seguintes opes. co -# ou --debug=debug_options Sa ida do log de depurao. ca d:t:o,nomearquivo. A string debug_options geralmente e

-? ou --help Exibe uma mensagem de ajuda e sai. -O nome=op~o, --set-variable=nome=op~o ca ca Congura o valor de uma varivel. Por favor note que as sintaxes --seta variable=nome=valor e -O name=value esto obsoletas desde o MySQL 4.0. a Use --nome=valor. As variveis poss a iveis e seus valores padres para o myo isamchk podem ser examinados com myisamchk --help Varivel a Valor key buer size 523264 read buer size 262136 write buer size 262136 sort buer size 2097144 sort key blocks 16 decode bits 9 sort_buffer_size utilizado quando as chaves so reparadas pela ordenao e a ca das chaves, que o caso normal quando voc utiliza --recover. e e key_buffer_size utilizando quando voc estiver conferindo a tabela com e e -extended-check ou quando as chaves so reparadas inserindo-as registro a a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

283

registro na tabela (como com inserts normais). O reparo atravs de buer de e chaves (key buer) utilizado nos seguintes casos: e Se voc utilizar --safe-recover. e Se os arquivos temporrios necessrios para ordenar as chaves forem maior a a que o dobro do tamanho de quando se criasse o arquivo de chaves diretamente. Isto o caso quando se tem chaves CHAR, VARCHAR ou TEXT tao e grandes quanto necessrio pela ordenao para armazenar todas as chaves a ca durante o processo. Se voc tiver muito espao temporrio e puder forar e c a c o myisamchk a reparar por ordenao voc pode utilizar a opo --sortca e ca recover. Reparao atravs do buer de chaves (key buer) economiza muito mais espao ca e c em disco do que utilizando ordenao, mas muito mais lenta. ca e Se voc deseja uma reparao mais rpida, congure as variveis acima para e ca a a cerca de 1/4 da sua memria dispon o ivel. Voc pode congurar as variveis para e a valores altos, pois somente um dos buers acima ser utilizado a cada vez. a -s ou --silent Modo discreto ou silencioso. Escreve a sa somente quando um erro ocorre. ida Voc pode utilizar -s duas vezes (-ss) para deixar o mysisamchk mais silene cioso. -v ou --verbose Modo prolixo. Gera mais informao de sa ca ida. Ele pode ser utilizado com -d e -e. Utilize -v mltiplas vezes -vv, -vvv) para gerar mais sa u ida! -V ou --version Exibe a verso do myisamchk e sai. a -w ou, --wait No lugar de gerar um erro se a tabela estiver bloqueada, espere at que a tabela e que livre antes de continuar. Perceba que se voc estiver utilizando mysqld e na tabela com --skip-external-locking, a tabela s pode ser trancada por o outro comadno myisamchk.

4.5.6.3 Opes de Vericao do myisamchk co ca

-c ou --check Confere por erros na tabela. Esta a operao padro se voc no estiver e ca a e a utilizando opes que a anulam. co -e ou --extend-check Verica a tabela de forma completa (que bastante lento se voc tiver vrios e e a indices). Esta opo deve ser usada somente em casos extremos. Normalmente, ca myisamchk ou myisamchk --medium-check deve, na maioria dos casos, estar apto a encontrar quaisquer erros na tabela. Se voc estiver utilizando --extended-check e tiver muita memria, voc deve e o e aumentar um pouco o valor de key_buffer_size!

284

MySQL Technical Reference for Version 5.0.0-alpha

-F ou --fast Verica apenas tabelas que no foram fechadas corretamente. a -C ou --check-only-changed Verica apenas tabelas que foram alteradas desde a ultima vericao. ca -f ou --force Reinicia o myisamchk com -r (reparos) na tabela, se myisamchk encontrar quaisquer erros na tabela. -i ou --information Exibe informaes e estat co isticas sobre a tabela que estiver sendo vericada. -m ou --medium-check Mais rpido que extended-check, mas encontra somente 99.99% de todos os a erros. Deve, entretando, ser bom o bastante para a maioria dos casos. -U ou --update-state Armazena no arquivo .MYI quando a tabela foi vericada e se a tabela falhou. Isto deve ser utilizado para obter o benef integral da opo --check-onlyicio ca changed, mas voc no deve utilizar esta opo se o servidor mysqld esta usando e a ca a tabela e o mysqld esta sendo executado com --skip-external-locking. -T ou --read-only No marca as tabelas como vericadas. Isto util se voc utiliza o myisamchk a e e para vericar uma tabela que esteja em uso por alguma outra aplicao que ca no utiliza bloqueios (como no mysqld --skip-external-locking). a

4.5.6.4 Opes de Reparos do myisamchk co

As seguintes opes so usadas se voc iniciar o myisamchk com -r ou -o: co a e -B or --backup Faz um backup dos arquivos .MYD como filename-time.BAK --correct-checksum Correct checksum information for table. -D # ou --data-file-length=# Tamanho mximo do arquivo de dados (ao recriar arquivos de dados quando a eles esto cheios). a -e ou --extend-check Tenta recuperar todos registros poss iveis do arquivo de dados. Normalmente isto ir encontrar tambm vrias linhas com lixo. No utiliza esta opo a a e a a ca menos que esteja em desespero total. -f ou --force Sobrescreve antigos arquivos temporrios (nome_tabela,TMD) em vez de abora tar. -k # ou --keys-used=# Se voc estiver utilizando ISAM, diz ao manipulador de tabelas do ISAM para e atualizar somente os primeiros # indices. Se voc estiver utilizando MyISAM, e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

285

informa quais chaves usar, onde cada bit seleciona uma chave (a primeira chave possui o bit 0). Isto pode ser utilizado para inseres mais rpidas! co a Indices desativados podem ser reativados utilizando myisamchk -r. -l ou --no-symlinks No segue links simblicos. Normalmente o myisamchk repara a tabela para a o qual um link simblico aponta. Esta opo no existe no MySQL 4.0 pois o o ca a MySQL 4.0 no ir remover links simblicos durante os reparos. a a o -p or --parallel-recover Usa a mesma tcnica que -r e -n, mas cria todas as chaves em paralelo, em e threads diferentes. A opo foi adicionada no MySQL 4.0.2. Este cdigo alfa. ca o e Use por sua conta e risco! -r ou --recover Pode concertar quase tudo excetos chaves unicas que no so unicas (Que um a a e erro extremamente indesejvel com tabelas ISAM/MyISAM). Se voc deseja recua e perar uma tabela, esta primeira opo a ser tentada. Somente se o myisamchk e ca relatar que a tabela no pode ser recuperada pelo -r voc deve tentar ento a e a a opo -o. (Perceba que no caso indesejvel de -r falhar, o arquivo de daca a dos continuar intacto.) Se voc possui muita memria, voc deve aumentar o a e o e tamanho de sort_buffer_size! -o ou --safe-recover Utiliza um antigo mtodo de recuperao (le atravs de todos registros na ordem e ca e e atualiza todas as rvores de a indices baseado nos registros encontrados); esta opo muito mais lenta que -r, mas pode tratar vrios casos indesejveis que ca e a a o -r no consegue tratar. Este mtodo de recuperao tambm utiliza muito a e ca e menos espao em disco que -r. Normalmente sempre se deve tentar, primeiro, c um reparo com -r, e somente se ele falhar, usar -o. Se voc possuir muita memria, voc deve aumentar o tamanho de sort_ e o e buffer_size! -n ou --sort-recover Fora o uso de ordenao do myisamchk para resolver as chaves mesmo se os c ca arquivos temporrios forem muito grandes. a --character-sets-dir=... Diretrio onde conjuntos de caracteres so armazenados. o a --set-character-set=name Altere o conjunto de caracteres usado pelo indice .t ou --tmpdir=path Caminho para armazenar arquivos temporrios. Se isto no for congurado, a a myisamchk ir usar a varivel de ambiente TMPDIR para isto. A partir do MySQL a a 4.1, tmpdir pode ser congurado com uma lista de caminhos separados por dois pontos : (ponto e virgula ; no Windows). Eles sero usado da forma robina round.

286

MySQL Technical Reference for Version 5.0.0-alpha

-q ou --quick Reparo rpido sem modicar o arquivo de dados. Pode ser fornecido um sea gundo -q para forar o myisamchk para modicar o arquivo de dados original c no caso de chaves duplicadas. -u ou --unpack Descompacta arquivo empacotado com o myisampack.

4.5.6.5 Outras Opes do myisamchk co

Outras aes que o myisamchk pode fazer, alem de reparar e vericar tabelas: co -a or --analyze Analiza a distribuio das chaves. Isto aumenta o desempenho de join haca bilitando o otimizador de joins para melhor escolher em qual ordem ele deve unir as tabelas e quais chaves ele deve usar: myisamchk --describe --verbose table_name ou usar SHOW KEYS no MySQL. -d or --description Exibe alguma informao sobre tabela. ca -A or --set-auto-increment[=value] Fora que AUTO_INCREMENT com um valor maior ou igual a este. Se nenhum c valor dado, ento dene o prximo valor AUTO_INCREMENT com o maior valor e a o usado para a chave automatica + 1. -S or --sort-index Ordene o bloco da rvore a indice do mais alto para o mais baixo. Isto otimizar a as buscas e tornar a pesquisa em tabela atravs da chave mais rpida. a e a -R or --sort-records=# Ordena o registro de acordo com um indice. Isto faz com que seus dados estejam muito mais localizados e pode aumentar a velocidade das operaes co SELECT e ORDER BY neste indice. (Pode ser bem lento na primeira ordenao!) ca Para encontrar um nmero de u indices da tabela, use SHOW INDEX, que exibe os indices de um tabela na mesma ordem que o myisamchk os v. e Indices so a nmeros que se iniciam com 1. u

4.5.6.6 Uso de Memria do myisamchk o

Alocao de memria importante quando voc executa o myisamchk. myisamchk no ca o e e a utiliza mais memria do que voc especica com a opo -O. Se voc ir utilizar o myisamchk o e ca e a em grandes arquivos, voc deve decidir primeiro quanta memria deseja usar. O valor e o padro utilizar somente 3MB para correes. Utilizando valores maiores, o myisamchk a e co pode operar mais rapidamente. Por exemplo, se voc tiver mais que 32M de memria e o RAM, voc pode utilizar opes tais como esta (em adio `s vrias outras que podem ser e co ca a a especicadas): shell> myisamchk -O sort=16M -O key=16M -O read=1M -O write=1M ... Utilizando -O sort=16M provavelmente suciente para a maioria dos casos. e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

287

Certique-se que o myisamchk utiliza arquivos temporrios em TMPDIR. Se TMPDIR aponta a para um sistema de arquivos em memria, voc pode facilmente obter erros de memria. o e o Se isto acontecer, congure TMPDIR para apontar para algum diretrio com mais espao e o c reinicie o myisamchk. Quando reparando, o myisamchk tambm precisar de bastante espao em disco: e a c Dobra-se o tamanho do arquivo de registros (o original e uma cpia). Este espao no o c a necessrio se for feito um reparo com --quick, j que neste caso somente o arquivo e a a de indices ser recriado. Este espao necessrio no mesmo disco que se encontra o a c e a arquivo de registros original! Espao para o novo arquivo de c indice que substitui o antigo. O arquivo de indices antigo truncando no inicio, portanto, normalmente este espao ignorado. Este espao e c e c e necessrio no mesmo disco que o arquivo de a indice original! Quando utilizando --recover ou --sort-recover (mas no quando usando --safea recover, ser necessrio espao para um buer de ordenao de: (maior_chave a a c ca + tamanho_do_ponteiro_de_registro)*nmero_de_registros * 2. u Voc pode e conferir o tamanho das chaves e o tamanho do ponteiro de registro com myisamchk -dv tabela. Este espao alocado no disco temporrio (especicado por TMPDIR ou c e a --tmpdir=#). Se voc tiver um problema com espao em disco durante o reparo, pode-se tentar usar e c --safe-recover em vez de --recover.

4.5.6.7 Uso do myisamchk para Recuperao em Caso de Falhas ca

Se voc executa o mysqld com a opo --skip-external-locking (que o padro em e ca e a alguns sistemas, como o Linux), voc no pode utilizar com segurana o myisamchk para e a c conferir uma tabela se o mysqld estiver utilizando a mesma tabela. Se voc pode ter e certeza que ningum est acessando as tabelas atravs do mysqld enquanto voc executa e a e e o myisamchk, voc s tem que executar o mysqladmin flush-tables antes de iniciar a e o vericao das tabelas. Se voc no tem certeza, ento voc deve desligar o mysqld enquanto ca e a a e verica as tabelas. Se voc executa o myisamchk enquanto o mysqld estiver atualizando as e tabelas, voc pode obter um altera que a tabela est corrompida mesmo se no estiver. e a a Se voc no estiver utilizando --skip-external-locking, pode usar o myisamchk para e a conferir as tabelas a qualquer hora. Enquanto voc faz isto, todos os clientes que tentarem e atualizar a tabela iro esperar at que o myisamchk esteja pronto, antes de continuar. a e Se voc utilizar o myisamchk para reparar ou otimizar tabelas, voc DEVE sempre assegurar e e que o servidor mysqld no esteja utilizando a tabela (Isto tambm aplica se voc utiliza a e e --skip-external-locking). Se voc no desligar o mysql, voc deve, pelo menos, fazer e a e um mysqladmin flush-tables antes de executar o myisamchk. Suas tabelas podem estar corrompidos se o servidor e o myisamchk acessarem a tabela simultaneamente. Este cap itulo descreve como checar e lidar com dados corrompidos nos bancos de dados MySQL. Se suas tabelas corromperem com frequncia deve ser encontrada a razo para e a isto! Veja Seo A.4.1 [Falhas], Pgina 925. ca a A seo de tabelas MyISAM contm motivos do porque uma tabela pode estar corrompida. ca e Veja Seo 7.1.3 [MyISAM table problems], Pgina 636. ca a

288

MySQL Technical Reference for Version 5.0.0-alpha

Quando se realizar recuperao devido a falhas, importante entender que cada tabela ca e nome_tabela em um banco de dados corresponde a tres arquivos no diretrio do banco de o dados: Arquivo Propsito o nome_tabela.frm Arquivo com denies co da tabela (form) nome_tabela.MYD Arquivo de dados nome_tabela.MYI Arquivo de indices Cada um destes trs tipos de arquivos est sujeito a corrupo de vrias formas, mas e a ca a problemas ocorrem mais frequentemente em arquivos de dados e indices. O myisamchk trabalha criando uma cpia do arquivo de dados .MYD linha a linha. Ele o termina o estgio de reparos removendo o antigo arquivo .MYD e renomeando o novo arquivo a com nome original. Se for utilizada a opo --quick, myisamchk no cria um arquivo ca a .MYD temporrio, mas assume que o arquivo .MYD est correto e somente gera um novo a a arquivo indice sem mexer no arquivo de dados. Isto seguro, pois o myisamchk detecta e automaticamente se o arquivo .MYD est corrompido e aborda o reparo neste caso. Voc a e pode tambm fornecer duas opes --quick para o myisamchk. Neste caso, o myisamchk e co no aborta em alguns erros (como chaves duplicadas) mas tenta resolv-los modicando o a e arquivo .MYD. Normalmente o uso de duas opoes --quick util somente se voc tiver c e e muito pouco espao em disco para realizer um reparo normal. Neste caso voc deve pelo c e menos fazer um backup antes de executar o myisamchk.

4.5.6.8 Como Vericar Erros em Tabelas

Para conferir uma tabela MyISAM, utilize os seguintes comandos: myisamchk nome_tabela Encontra 99.99% de todos os erros. O que ele no pode encontrar corrompia e mento que envolva SOMENTE o arquivo de dados (que no comum). Se voc a e e desejar conferir uma tabela, voc deve executar normalmente o myisamchk sem e opes ou com as opes -s ou --silent. co co myisamchk -m nome_tabela Encontra 99.999% de todos os erros. Ele verica primeiramente erros em todas as entradas do indice e ento le todos os registros. Ele calcula um checksum a para todas as chaves nos registros e verica se o checksum o mesmo que o e checksum das chaves na rvore de a indices. myisamchk -e nome_tabela Realiza a vericao completa de todos os dados (-e signica conferncia exca e tendida). Ele faz uma conferncia lendo todas as chaves de cada registro e para vericar se eles realmente apontam para o registro correto. Isto pode demorar MUITO tempo em uma tabela grande com vrias chaves. myisamchk a normalmente ir parar depois do primeiro erro que encontrar. Se voc deseja a e obter mais informaes, pode adicionar a opo --verbose (-v). Isto faz o co ca myisamchk continuar a percorrer a tabela at um mximo de 20 erros. Em e a utilizao normal, um simples myisamchk (sem argumentos alm do nome da ca e tabela) suciente. e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

289

myisamchk -e -i nome_tabela Como o comando anterior, mas a opo -i diz ao myisamchk para exibir algumas ca informaes estat co isticas tambm. e

4.5.6.9 Como Reparar Tabelas

Na seo seguinte ns s falaremos do uso do myiasmchk em tabelas MyISAM (extenses ca o o o .MYI e .MYD). Se voc estiver usando tabelas ISAM (extenses .ISM e .ISD), voc deve usar e o e a ferramenta isamchk. A partir do MySQL verso 3.23.14, voc pode reparar tabelas MyISAM com o comando a e REPAIR TABLE. Veja Seo 4.5.5 [REPAIR TABLE], Pgina 279. ca a Os sintomas de uma tabela corrompida incluem pesquisas que abortam inesperadamente e erros como estes: nome_tabela.frm is locked against change Cant nd le nome_tabela.MYI (Errcode: ###) Unexpected end of le Record le is crashed Got error ### from table handler Para obter mais informaes sobre o erro voc pode executar perror ###. Aqui esto co e a os erros mais comuns que indicam um problema com a tabela: shell> perror 126 127 132 134 135 136 141 144 145 126 = Index file is crashed / Wrong file format 127 = Record-file is crashed 132 = Old database file 134 = Record was already deleted (or record file crashed) 135 = No more room in record file 136 = No more room in index file 141 = Duplicate unique key or constraint on write or update 144 = Table is crashed and last repair failed 145 = Table was marked as crashed and should be repaired Note que o erro 135 (no mais no arquivo de registro), no um erro que pode ser a a e corrigido por um simples reparo. Neste caso voc deve fazer: e ALTER TABLE tabela MAX_ROWS=xxx AVG_ROW_LENGTH=yyy; Voc tambm pode usar esta tcnica para o erro 136 (no mais no arquivo de e e e a indice). Em outros casos, voc deve reparar suas tabelas. myisamchk pode normalmente detectar a e maioria dos problemas que ocorrem. O processo de reparo involve at quatro estgios, descritos abaixo. Antes de comear, voc e a c e deve mudar para o diretrio do banco de dados e conferir as permisses dos arquivos de o o tabelas. Tenha certeza que eles possam ser lidos pelo usurio do Unix com o qual mysqld a executado (e para voc, porque voc precisa acessar os arquivos que est conferindo). e e e a Se no estiverem, voc precisa alterar os arquivos, eles tambm devem ter a permisso de a e e a escrita para voc. e

290

MySQL Technical Reference for Version 5.0.0-alpha

Se voc estiver utilizando o MySQL verso 3.23.16 e superior, voc pode (e deve) usar os e a e comandos CHECK e REPAIR para conferir e corrigir tabelas MyISAM. Veja Seo 4.5.4 [CHECK ca TABLE], Pgina 278. Veja Seo 4.5.5 [REPAIR TABLE], Pgina 279. a ca a A seo do manual sobre manuteno de tabelas inclui as opes para isamchk/myisamchk. ca ca co Veja Seo 4.5.6 [Table maintenance], Pgina 280. ca a A seguinte seo so para os casos onde o comando acima falhar ou se voc desejar usar os ca a e recursos extendidos que o isamchk e myisamchk fornecem. Se voc for reparar uma tabela da linha de comandos, deve primeiro desligar o servidor e mysqld. Perceba que quando voc executa mysqladmin shutdown em um servidor remoto, e o servidor mysqld ir continuar funcionando por um tempo depois do mysqladmin retornar, a at que todas as queries parem e todas as chaves sejam descarregadas no disco. e Estgio 1: Vericando suas tabelas a Execute myisamchk *.MYI ou myisamchk -e *.MYI se voc tiver tempo dispon e ivel. Utilize a opo -s (silencioso) para suprimir informaes desnecessrias. ca co a Se o servidor mysqld parar, deve ser utilizada a opo update para dizer ao myisamchk ca marcar a tabela como checada. Voc deve reparar somente as tabelas em que o myisamchk indicar um erro. Para tais e tabelas, v para o estgio 2. a a Se voc obter erros estranhos na vercao (como nos erros out of memory), ou se o e ca myisamchk quebrar, v para o estgio 3. a a Estgio 2: Reparo simples e seguro a NOTA: Se voc deseja que os reparos sejam mais rpidos, devem ser usadas as opes: -O e a co sorf_buffer=# -O key_buffer=# (onde # seria 1/4 da memria disponivel) para todos o comandos isamchk/myisamchk. Primeiro, tente usar myisamchk -r -q nome_tabela (-r -q signica modo de recuperao ca rpida). Ele tentar reparar o arquivo de a a indice sem mexer no arquivo de dados. Se o arquivo de dados estiver normal e os links apagados apontam nas localizaes corretas co dentro do arquivo de dados, isto deve funcionar e a tabela ser corrigida. Inicie o reparo da a prxima tabela. Outra maneira seria utilizar os seguintes procedimentos: o 1. Faa um backup do arquivo de dados antes de continuar. c 2. Utilize myisamchk -r nome_tabela (-r signica modo de recuperao). Isto reca mover registros incorretos e deletados do arquivo de dados e reconstroi o arquivo a de indices. 3. Se o passo anterior falhar, utilize myisamchk --safe-recover nome_tabela. O modo de recuperao segura utiliza um metdo de recuperao antiga que trata de alguns ca o ca casos que o modo de recuperao comum no consegue (porm mais lento). ca a e e Se voc obter erros estranhos no reparo (como em erros out of memory), ou se o myisamchk e falhar, v para o estgio 3. a a Estgio 3: Reparo dif a icil Voc s deve atingir este estgio se o primeiro bloco de 16K do arquivo de e o a indice estiver destru ou conter informaes incorretas, ou se o arquivo de ido co indice no existir. Neste a caso, necessrio criar um novo arquivo de e a indice. Faa como a seguir: c 1. Mova o arquivo de dados para algum lugar seguro.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

291

2. Use o arquivo de descrio de tabelas para criar novos arquivos (vazios) de dados e ca indices: shell> mysql nome_bd mysql> SET AUTOCOMMIT=1; mysql> TRUNCATE TABLE nome_tabela; mysql> quit Se sua verso do MySQL no possuir TRUNCATE TABLE, utilize DELETE FROM nome_ a a tabela. 3. Copie o antigo arquivo de dados de volta para o novo arquivo de dados criado. (No a s mova o antigo arquivo de volta para o novo arquivo; voc deve uma cpia no caso o e o de algo der errado.) Volte ao estgio 2. myisamchk -r -q deve funcionar agora. (Isto no deve ser um loop a a eterno.) No MySQL 4.0.2 voc tambm pode utilizar REPAIR ... USE_FRM o qual realiza todo o proe e cedimento automaticamente. Estgio 4: Reparo muito dif a icil Voc deve atingir este estgio somente se o arquivo de descrio tambm falhar. Isto nunca e a ca e deve acontecer, porque o arquivo de descrio no alterado depois da tabela ser criada: ca a e 1. Restaure o arquivo de descrio de um backup e volte ao estgio 3. Voc pode tambm ca a e e restaurar o arquivo de indice e voltar ao estgio 2. No ultimo caso, voc deve iniciar a e com myisamchk -r. 2. Se voc no tem um backup mas sabe exatamente como a tabela foi criada, crie uma e a cpia da tabela em outro banco de dados. Remova o novo arquivo de dados, e ento o a mova a descrio e arquivos de indice do outro banco de dados para o banco de dados ca com problemas. Isto lhe fornece um novo arquivos indice e descrio, mas mantm o ca e arquivo de dados da mesma forma. Volte ao estgio 2 e tente reconstruir o arquivo de a indices.

4.5.6.10 Otimizao de Tabelas ca

Para agrupar registros fragmentados e eliminar perda de espao resultante de remoes ou c co atualizaes de registros, execute myisamchk no modo de recuperao: co ca shell> myisamchk -r nome_tabela Voc pode otimizar uma tabela da mesma forma utilizando a instruo SQL OPTIMIZE e ca TABLE. OPTIMIZE TABLE faz o reparo de tabelas, analisa chaves e tambm ordena a rvore e a de indices para fazer pesquisas por chave mais rpidas. Tambm no existem possibilidade a e a de interao no desejvel entre o utilitrio e o servidor, porque o servidor faz todo o trabalho ca a a a quando voc utiliza OPTIMIZE TABLE. Veja Seo 4.6.1 [OPTIMIZE TABLE], Pgina 298. e ca a myisamchk tambm tem um nmero de outras opo que podem ser usadas para melhorar e u ca a performance de uma tabela: -S, --sort-index -R index_num, --sort-records=index_num -a, --analyze Para uma descrio completa da opo. Veja Seo 4.5.6.1 [myisamchk syntax], Pgina 281. ca ca ca a

292

MySQL Technical Reference for Version 5.0.0-alpha

4.5.7 Congurando um Regime de Manuteno das Tabelas ca

A partir do MySQL Verso 3.23.13, voc pode conferir tabelas MyISAM com o comando a e CHECK TABLE. Veja Seo 4.5.4 [CHECK TABLE], Pgina 278. Voc pode reparar tabelas ca a e com o comando REPAIR TABLE. Veja Seo 4.5.5 [REPAIR TABLE], Pgina 279. ca a E uma boa idia vericar as tabelas regularmente em vez de esperar que ocorram problemas. e Para propsitos de manuteno voc pode utilizar o myisamchk -s para vericar as tabelas. o ca e A opo -s (abreviao de --silent) faz com que o myisamchk execute em modo silencioso, ca ca exibindo mensagens somente quando ocorrem erros. E tambm uma boa idia vericar as tabelas quando o servidor inicia. Por exemplo, sempre e e que a mquina reinicia no meio de uma atualizao, voc normalmente precisar conferir a ca e a todas as tabelas que podem ter sido afetadas. (Isto umatabela com falhas esperadas.) e Voc pode adicionar um teste ao mysqld_safe que executa myisamchk para conferir todas e tabelas que foram modicadas durante as ultimas 24 horas se existir um arquivo .pid (process ID) antigo depois do ultimo reboot. (O arquivo .pid criado pelo mysqld quando e ele inicia e removido quando ele termina normalmente. A presena de um arquivo .pid c durante a inicializao do sistema indica que o mysqld terminou de forma anormal.) ca Um teste ainda melhor seria vericar qualquer tabela cuja a data da ultima modicao ca e mais recente que a do arquivo .pid. Voc tambm deve vericar suas tabelas regularmente durante a operao normal do sise e ca tema. Na MySQL AB, ns executamos uma tarefa agendada cron para conferir todas o nossas tabelas importantes uma vez por semana utilizando uma linha com esta no arquivo crontab: 35 0 * * 0 /diretrio/do/myisamchk --fast --silent /diretrio/de/dados/*/*.MYI o o Isto exibe informaes sobre tabelas com falhas para que possamos examin-las e repar-las co a a quando necessrio. a Como ns no estamos tendo tabelas com falhas inesperadas (tabelas corrompidas por razes o a o diferentes de problemas de hardware) por vrios anos (isto realmente verdade), uma vez a e por semana mais que suciente para ns. e o Ns recomendamos que para iniciar, voc execute myisamchk -s a cada noite em todas as o e tabelas que foram atualizadas durantes as ultimas 24 horas, at que voc cone no MySQL e e como ns conamos. o Normalmente voc no precisar de tanta manuteno em suas tabelas MySQL. Se voc e a a ca e estiver alterando tabelas com registros de tamanho dinmico (tabelas com colunas VARCHAR, a BLOB ou TEXT) ou tem tabelas com vrios registros apagados voc pode desejar de tempos a e em tempos (uma vez ao ms?) desfragmentar/recuperar espao das tabelas. e c Voc pode fazer isto utilizando OPTIMIZE TABLE nas tabelas em questo ou se voc puder e a e desligar o servidor mysqld por um tempo faa: c isamchk -r --silent --sort-index -O sort_buffer_size=16M */*.ISM myisamchk -r --silent --sort-index -O sort_buffer_size=16M */*.MYI

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

293

4.5.8 Obtendo Informaes sobre as Tabelas co

Para obter uma descrio de uma tabela ou estat ca isticas sobre ela, utilize os comandos mostrados abaixo, ns explicaremos algumas das informaes em mais detalhes posterioro co mente: myisamchk -d nome tabela Executa o myisamchk no modo descritivo para produzir uma descrio de sua tabela. Se voc iniciar o servidor MySQL utilizando a opo ca e ca --skip-locking, myisamchk pode relatar um erro para uma tabela que est sendo a atualizada enquanto executado. Entretanto, como o myisamchk no altera a tabela e a no modo de descrio, no existem riscos de destruio de dados. ca a ca co myisamchk -d -v nome tabela Para produzir mais informaes sobre o que myisamchk est fazendo, adicione -v para solicitar a execuo em modo verbose. a ca myisamchk -eis nome tabela Exibe somente as informaes mais importantes de uma co tabela. Ele lento porque necessrio ler a tabela inteira. e e a myisamchk -eiv nome tabela Isto se parece com -eis, mas lhe diz o que est sendo a feito. Exemplo da sa de myisamchk -d ida MyISAM file: Record format: Data records: Recordlength: company.MYI Fixed length 1403698 Deleted blocks: 226

table description: Key Start Len Index Type 1 2 8 unique double 2 15 10 multip. text packed stripped 3 219 8 multip. double 4 63 10 multip. text packed stripped 5 167 2 multip. unsigned short 6 177 4 multip. unsigned long 7 155 4 multip. text 8 138 4 multip. unsigned long 9 177 4 multip. unsigned long 193 1 text Exemplo da sa de myisamchk -d -v : ida MyISAM file: company Record format: Fixed length File-version: 1 Creation time: 1999-10-30 12:12:51 Recover time: 1999-10-31 19:13:01 Status: checked Data records: 1403698 Deleted blocks: 0 Datafile parts: 1403698 Deleted data: 0 Datafilepointer (bytes): 3 Keyfile pointer (bytes): 3 Max datafile length: 3791650815 Max keyfile length: 4294967294

294

MySQL Technical Reference for Version 5.0.0-alpha

Recordlength:

226

table description: Key Start Len Index Type 1 2 8 unique double 2 15 10 multip. text packed stripped 3 219 8 multip. double 4 63 10 multip. text packed stripped 5 167 2 multip. unsigned short 6 177 4 multip. unsigned long 7 155 4 multip. text 8 138 4 multip. unsigned long 9 177 4 multip. unsigned long 193 1 text Exemplo da sa de myisamchk -eis: ida Checking MyISAM file: company Key: 1: Keyblocks used: 97% Key: 2: Keyblocks used: 98% Key: 3: Keyblocks used: 97% Key: 4: Keyblocks used: 99% Key: 5: Keyblocks used: 99% Key: 6: Keyblocks used: 99% Key: 7: Keyblocks used: 99% Key: 8: Keyblocks used: 99% Key: 9: Keyblocks used: 98% Total: Keyblocks used: 98% Records: 1403698 Packed: 0% Recordspace used: 100% Blocks/Record: 1.00 Record blocks: 1403698 Recorddata: 317235748 Lost space: 0 Packed: Packed: Packed: Packed: Packed: Packed: Packed: Packed: Packed: Packed:

Rec/key 1 2 73 5 4840 1346 4995 87 178

Root Blocksize 15845376 1024 25062400 1024 40907776 1024 48097280 1024 55200768 1024 65145856 1024 75090944 1024 85036032 1024 96481280 1024

0% 50% 0% 60% 0% 0% 0% 0% 0% 17%

Max Max Max Max Max Max Max Max Max

levels: levels: levels: levels: levels: levels: levels: levels: levels:

4 4 4 3 3 3 3 3 4

M.recordlength: Empty space: Delete blocks: Deleted data: Linkdata:

226 0% 0 0 0

User time 1626.51, System time 232.36 Maximum resident set size 0, Integral resident set size 0 Non physical pagefaults 0, Physical pagefaults 627, Swaps 0 Blocks in 0 out 0, Messages in 0 out 0, Signals 0 Voluntary context switches 639, Involuntary context switches 28966 Exemplo da sa de myisamchk -eiv: ida Checking MyISAM file: company Data records: 1403698 Deleted blocks: - check file-size - check delete-chain block_size 1024: 0

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

295

index 1: index 2: index 3: index 4: index 5: index 6: index 7: index 8: index 9: No recordlinks - check index reference - check data record references Key: 1: Keyblocks used: 97% - check data record references Key: 2: Keyblocks used: 98% - check data record references Key: 3: Keyblocks used: 97% - check data record references Key: 4: Keyblocks used: 99% - check data record references Key: 5: Keyblocks used: 99% - check data record references Key: 6: Keyblocks used: 99% - check data record references Key: 7: Keyblocks used: 99% - check data record references Key: 8: Keyblocks used: 99% - check data record references Key: 9: Keyblocks used: 98% Total: Keyblocks used: 9%

index: 1 Packed: index: 2 Packed: index: 3 Packed: index: 4 Packed: index: 5 Packed: index: 6 Packed: index: 7 Packed: index: 8 Packed: index: 9 Packed: Packed:

0% 50% 0% 60% 0% 0% 0% 0% 0% 17%

Max levels: Max levels: Max levels: Max levels: Max levels: Max levels: Max levels: Max levels: Max levels:

4 4 4 3 3 3 3 3 4

- check records and index references [LOTS OF ROW NUMBERS DELETED] Records: 1403698 Recordspace used: 100% Record blocks: 1403698 Recorddata: 317235748 Lost space: 0 M.recordlength: Empty space: Delete blocks: Deleted data: Linkdata: 226 0% 0 0 0 Packed: Blocks/Record: 0% 1.00

User time 1639.63, System time 251.61 Maximum resident set size 0, Integral resident set size 0 Non physical pagefaults 0, Physical pagefaults 10580, Swaps 0 Blocks in 4 out 0, Messages in 0 out 0, Signals 0 Voluntary context switches 10604, Involuntary context switches 122798

296

MySQL Technical Reference for Version 5.0.0-alpha

Aqui esto os tamanhos dos arquivos de dados e a indices para a tabela utilizada nos exemplos anteriores: -rw-rw-r-1 monty tcx 317235748 Jan 12 17:30 company.MYD -rw-rw-r-1 davida tcx 96482304 Jan 12 18:35 company.MYM Explicaes para os tipos de informaes que o myisamchk produz so fornecidas abaixo. O co co a keyle o arquivo de e indices. Registro e linha so sinnimos: a o ISAM le Nome do arquivo ( indice) ISAM. Isam-version Verso do formato ISAM. Atualmente sempre 2. a Creation time Quando o arquivo de dados foi criado. Recover time Quando foi a ultima vez que o arquivo de indices/dados foi reconstru ido. Data records Quantos registros existem na tabela. Deleted blocks Quantos blocos apagados continuam alocando espao. Voc pode c e otimizar sua tabela para minimizar este espao. Veja Seo 4.5.6.10 [Otimizao], c ca ca Pgina 291. a Datale: Parts Para formato de registros dinmicos, isto indica quantos blocos de dados a existem. Para uma tabela otimizada sem registros fragmentados, isto o mesmo que e Data records. Deleted data Quantos bytes de dados deletados no recuperados existem. Voc pode a e otimizar sua tabela para minimizar este espao. Veja Seo 4.5.6.10 [Otimizao], c ca ca Pgina 291. a Data le pointer O tamanho do ponteiro do arquivo de dados, em bytes. Ele normalmente possui 2, 3, 4 ou 5 bytes. A maioria das tabelas trabalham com 2 bytes, mas isto ainda no pode ser controlado pelo MySQL ainda. Para tabelas xas, isto um a e endereo de registro. Para tabelas dinmicas, isto um endereo de byte. c a e c Keyle pointer O tamanho de um ponteiro de arquivo de indices, em bytes. Ele normalmente possui 1, 2 ou 3 bytes. A maioria das tabelas trabalham com 2 bytes, mas isto calculado automaticamente pelo MySQL. Ele sempre um endereo de bloco. e e c Max datale length Qual tamanho o arquivo de dados (arquivos .MYD) pode atingir, em bytes. Max keyle length Qual tamanho o arquivo de indices (.MYI pode atingir, em bytes. Recordlength Quanto espao cada registro ocupa, em bytes. c Record format O formato utilizado para armazenar as linhas da tabelas. Os exemplos anteriores abaixo utilizam Fixed length (tamanho xo). Outros valores poss iveis so a Compressed(compactado) e Packed(empacotado). table description Uma lista de todas as chaves na tabela. Para cada chave, alguma informao de baixo n apresentada: ca ivel e Key Start Len O Nmero desta chave. u Onde, no registro, esta parte do indice inicia. Qual o tamanho desta parte do indice. Para nmeros empacotados, isto u deve sempre ser o tamanho total da coluna. Para strings, deve ser mais curto que o tamanho total da coluna indexada, porque voc pode indexar e um prexo de uma coluna string.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

297

Index Type Root Blocksize

unique ou multip. (multiplos). Indica se um valor pode ou no exisitir a vrias vezes neste a indice. Que tipo de dados esta parte do indice tem. Isto um tipo de dados ISAM e com as opes packed, stripped ou empty. co Endereo do bloco de c indice raiz. O tamanho de cada bloco de indice. O tamanho padro 1024, mas o valor a e pode ser alterado na compilao. ca Este um valor estat e istico utilizado pelo otimizador. Ele diz quantos registros existem por valor para esta chave. Uma chave unica sempre tem um valor de 1. Ele pode ser atualizado depois que uma tabela carregada e (ou muito alterada) com myisamchk -a. Se isto no for completamente a atualizado, um valor padro de 30 fornecido. a e

Rec/key

No primeiro exemplo acima, a nona chave uma chave multi partes com duas partes. e Keyblocks used Qual o percentual de bloco de chaves so usados. Como a tabela a usada nos exemplos foi reorganizada com myisamchk, os valores so muito altos (muito a prximos do mximo terico). o a o Packed O MySQL tenta empacotar chaves com um suxo comum. Isto pode ser usado somente para chaves CHAR/VARCHAR/DECIMAL. Para strings grandes como nomes, isto pode reduzir signicativamente o espao utilizado. No terceiro exemplo acima, a quarta c chave possui 10 caracteres e uma reduo de 60% no espao obtida. ca c e Max levels Qual a profundidade da rvore-B para esta chave. Grandes tabelas com a chaves longas resultam em valores altos. Records Quantos registros existem na tabela. M.recordlength A mdia de tamanho do registro. e tamanho xo, isto o tamanho exato do registro. e Para tabelas com registros de

Packed O MySQL corta espaos do nal de strings. O valor Packed indica o percentual c de economia alcanado fazendo isto. c Recordspace used Qual percentual do arquivo de dados usado. e Empty space Qual percetual do arquivo de dados no usado. a e Blocks/Record Nmero mdio de blocos por registro (isto , de quantos links um regu e e istro fragmentado composto). Sempre ser 1 para tabelas de formato xo. Este e a valor deve permanecer o mais prximo poss o ivel de 1.0. Se ele aumentar, voc pode e reorganizar a tabela com myisamchk. Veja Seo 4.5.6.10 [Otimizao], Pgina 291. ca ca a Recordblocks Quantos blocos (links) so utilizados. Para formatos xos, este o mesmo a e que o nmero de registros. u Deleteblocks Quantos blocos (links) foram exclu idos. Recorddata Quantos bytes no arquivo de dados so usados. a Deleted data Quantos bytes no arquivo de dados foram apagados (sem uso). Lost space Se um registro atualizado para um tamanho menor, algum espao pere c e dido. Isto a soma de todas estas perdas, em bytes. e

298

MySQL Technical Reference for Version 5.0.0-alpha

Linkdata Quando o formato de tabela dinmica utilizado, fragmentos de registros a e so ligados com ponteiros (4 a 7 bytes cada). Linkdata a soma do montante de a e armazenamento utilizado por todos estes ponteiros. Se uma tabela foi compactada com myisampack, mysiamchk -d exibe informaes adicionais co sobre cada coluna da tabela. Veja Seo 4.8.4 [myisampack], Pgina 336, para um exemplo ca a desta informao e uma descrio do que ela signica. ca ca

4.6 Adiministrao do Banco de Dados e Referncia de ca e Linguagem

4.6.1 Sintaxe de OPTIMIZE TABLE
OPTIMIZE [LOCAL | NO_WRITE_TO_BINLOG] TABLE tbl_name[,tbl_name]... OPTIMIZE TABLE deve ser usado se voc apagou uma grande parte de uma tabela ou se voc e e fez vrias alteraes ` uma tabela com registros de tamanho varivel (tabelas que tenham a co a a campos do tipo VARCHAR, BLOB ou TEXT). Registros apagados so mantidos em uma lista a de ligaes e operaes INSERT subsequentes reutilizam posies de registros antigos. Voc co co co e pode utilizar OPTIMIZE TABLE para reclamar o espao inutilizado e para desfragmentar o c arquivo de dados. Na maioria da conguraes voc no tem que executar OPTIMIZE TABLE. Mesmo se voc co e a e zer diversas atualizaes para registros de tamanhos variveis no desejvel que voc co a a e a e precise fazer isto mais que uma vez por ms/semana e apenas em determinadas tabelas. e No momento OPTIMIZE TABLE s funciona em tabelas MyISAM e BDB. Para tabelas BDB, o OPTIMIZE TABLE atualmente mapeado para ANALIZE TABLE. Veja Seo 4.6.2 [ANALYZE e ca TABLE], Pgina 298. a Voc pode ter a otimizao de tabelas trabalhando em outros tipos de tabelas iniciando e ca o mysqld com --skip-new ou --safe-mode, mas neste caso, OPTIMIZE TABLE mapeado e apenas para ALTER TABLE. OPTIMIZE TABLE funciona da seguinte forma: Se a tabela tem registros exclu idos ou dividos, repara a tabela. Se as pginas de indice no esto ordenas, ordene-as. a a a Se as estatisticas no esto atualizadas (e o reparo no pode ser feito ordenando o a a a indice), atualize-as. Perceba que a tabela estar bloqueada durante o tempo em que OPTIMIZE TABLE estiver a executando. Antes do MySQL 4.1.1, o OPTIMIZE comnado no gravava no log binrio. Desde o MySQL a a 4.1.1 eles so escritos no log binrio a menos que a palavra chave opcional NO_WRITE_TO_ a a BINLOG (ou se alias LOCAL) seja usada.

4.6.2 Sintaxe de ANALYZE TABLE

ANALYZE [LOCAL | NO_WRITE_TO_BINLOG] TABLE tbl_name[,tbl_name...]

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

299

Analisa e armazena a distribuio de chaves para a tabela. Durante a anlise a tabela ca a e bloqueada com uma trava de leitura. Isto funciona em tabelas MyISAM e BDB. Isto seria equivalente a executar myisamchk -a na tabela. O MySQL utiliza a distribuio de chaves armazenadas para decidir em que ordem tabelas ca devem ser unidas quando algum faz um join em alguma coisa diferente de uma constante. e O comando retorna uma tabela com as seguintes colunas: Coluna Table Op Msg type Msg text Valor Nome da Tabela Sempre analyze Um dos seguintes: status, error, info ou warning A mensagem

Voc pode vericar a distribuio de chaves armazenadas com o comando SHOW INDEX. Veja e ca Seo 4.6.8.1 [Show database info], Pgina 303. ca a Se a tabela no foi alterada deste o ultimo comando ANALYZE TABLE, a tabela no ser a a a analisada novamente. Antes do MySQL 4.1.1, o ANALYZE comnado no gravava no log binrio. Desde o MySQL a a 4.1.1 eles so escritos no log binrio a menos que a palavra chave opcional NO_WRITE_TO_ a a BINLOG (ou se alias LOCAL) seja usada.

4.6.3 Sintaxe de CHECKSUM TABLE

CHECKSUM TABLE tbl_name[,tbl_name ...] [ QUICK | EXTENDED ] Reports a table checksum. If QUICK is specied, live table checksum is reported, or NULL if the table does not support live checksum. This is very fast. In EXTENDED mode the whole table is read row by row and the checksum is calculated. This can be very slow for large tables. By default - with neither QUICK nor EXTENDED - MySQL returns live checksum if the table support it and scans the table otherwise. Este comando est implementado no MySQL 4.1.1. a

4.6.4 Sintaxe de FLUSH

FLUSH [LOCAL | NO_WRITE_TO_BINLOG] flush_option [,flush_option] ... Voc deve utilizar o comando FLUSH se desejar limpar algum dos caches internos que o e MySQL usa. Para executar FLUSH, voc deve ter o privilgio RELOAD. e e op~es podem ser qualquer uma das seguintes: co Option Description

300

MySQL Technical Reference for Version 5.0.0-alpha

HOSTS

Esvazia as tabelas de cache de nomes de mquinas. Voc deve a e descarregar as tabelas de nomes de mquinas se alguma de suas a mquinas receber um nmero IP diferente ou se voc obter a a u e mensagem de erro Host ... is blocked. Quando mais de max_ connect_erros erros occorrer em um registro para uma determinada mquina enquanto se conecta ao servidor MySQL, o MySQL a assume que algo est errado e bloqueia futuras requisies desta a co mquina. A descarga na tabela de nomes de mquinas permite a a a a ` mquina se conectar novamente. Veja Seo A.2.5 [Mquina ca a bloqueada], Pgina 916.) Voc pode iniciar o mysqld com -O a e max_connection_errors=999999999 para evitar esta mensagem de erro. Recarrega a chave DES do arquivo que foi especicado com a opo ca --des-key-file durante inicializao do servidor. ca Fecha e reabre todos os arquivos de log. Se voc tiver especicado e o arquivo de logs de atualizaes ou um arquivo de log binrio sem co a uma extenso, o nmero de extenso do arquivo log ser sempre a u a a incrementado de um em relao ao arquivo anterior. Se voc usou ca e uma extenso no nome do arquivo, o MySQL ir fechar e reabrir a a o arquivo de log de atualizaes. Veja Seo 4.10.3 [Log de atco ca ualizao], Pgina 373. Isto a mesma coisa que enviar o sinal ca a e SIGHUP para o servidor mysqld. Recarrega os privilgios das tabelas de permisses no banco de e o dados mysql. Defragmenta a cache de consulta par utilizar melhor a sua memria. Este comando no remove qualquer consulta da cache, o a ao contrrio de RESET QUERY CACHE. a Fecha todas as tabelas abertas e fora o fechamento de todas as c tabelas em uso Descarga somente das tabelas fornecidas. Fecha todas tabelas abertas e bloqueia todas tabelas para todos os bancos de dados com leitura at que algum execute UNLOCK e e TABLES. Isto uma maneira muito conveniente para fazer backups e se voc possui um sistema de arquivos, como Veritas, que pode e fazer uma imagem instantnea (snapshot) de um certo momento. a Reinicia a maioria das variveis de status para zero. Isto algo a e que deve ser usado somente para depurar uma consulta. Zera todos os recirsos dos usurios. Isto permitir que usurios a a a bloqueados faam login novamente. Veja Seo 4.4.7 [Recursos de c ca usurios], Pgina 265. a a

DES_KEY_FILE LOGS

PRIVILEGES QUERY CACHE

TABLES [TABLE | TABLES] nome_tabela [,nome_tabela...] TABLES WITH READ LOCK

STATUS USER_RESOURCES

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

301

Antes do MySQL 4.1.1, o FLUSH comnado no gravava no log binrio. Desde o MySQL a a 4.1.1 eles so escritos no log binrio a menos que a palavra chave opcional NO_WRITE_TO_ a a BINLOG (ou se alias LOCAL) seja usada, ou que o comando contenha um dos argumentos: LOGS, MASTER, SLAVE, TABLES WITH READ LOCK, pois qualquer um desses argumwentos podem causar problemas se replicados para um slave. Voc pode tambm acessar cada um dos comandos vistos acima com o utilitrio mysqladmin, e e a utilizando os comandos flush-hosts, flush-logs, reload ou flush-tables. Tambm de uma olhada no comando RESET usado com a replicao. Veja Seo 4.6.5 e ca ca [RESET], Pgina 301. a

4.6.5 Sintaxe de RESET

RESET reset_option [,reset_option] ... O comando RESET usado para limpar coisas. Ele tambm atua como uma verso mais e e a forte do comando FLUSH. Veja Seo 4.6.4 [FLUSH], Pgina 299. ca a Para executar RESET, voc deve ter o privilgio RELOAD. e e Opo ca Descrio ca MASTER Deleta todos os logs binrios listados no arquivo a indice, esvaziando o arquivo de indice do log binrio. Anteriormente chamado FLUSH a MASTER. Veja Seo 4.11.7 [Replicao], Pgina 400. ca ca a Faz o slave esquecer a sua posio de replicao no log binrio do ca ca a master. Anteriormente chamado FLUSH SLAVE. Veja Seo 4.11.8 ca [Replicao], Pgina 402. ca a Remove todos os resulatdos de consultas da cache de consultas.

SLAVE

QUERY CACHE

4.6.6 Sintaxe de PURGE MASTER LOGS

PURGE {MASTER|BINARY} LOGS TO nome_binlog PURGE {MASTER|BINARY} LOGS BEFORE data Este comando usado para deletar todos os logs binrios estritamente anteriores ao binlog e a ou data especicada. Veja Seo 4.11.7 [Replication Master SQL], Pgina 400. ca a como um sinnimo para PURGE MASTER LOGS a partir do PURGE BINARY LOGS est disponivel a o MySQL 4.1.1.

4.6.7 Sintaxe de KILL

KILL thread_id Cada conexo ao mysqld executa em uma thread separada. Voc pode ver quais threas a e esto em execuo com o comando SHOW PROCESSLIST e matar uma thread com o comando a ca KILL thread_id. Se voc tiver o privilgio PROCESS, voc pode ver todas as threads. Se voc tiver o privilgio e e e e e SUPER, voc pode matar todas as threads. Caso contrrio, voc pode ver e matar somente e a e suas prprias threads. o

302

MySQL Technical Reference for Version 5.0.0-alpha

Voc tambm pode usar os comandos mysqladmin processlist e mysqladmin kill para e e examinar e matar threads. Nota: Atualmente voc no pode utilizar KILL com a biblioteca do servidor MySQL embue a tido, porque o servidor embutido apenas roda dentro das threads da aplicao, ela no cria ca a threads de conexes por si prpria. o o Quando voc utiliza um KILL, um sinal (ag) kill especico congurado para a thread. e e Na maioria dos casos pode levar algum tempo para a thread morrer pois o sinal kill s oe checado em intervalos especicos. Nos loops SELECT, ORDER BY e GROUP BY, o sinal checado depois de ler um bloco de e registros. Se o sinal kill est habilitado a instruo abortada. a ca e Na execuo de um ALTER TABLE o sinal kill conferido antes de cada bloco de registros ca e ser lido da tabela original. Se o sinal kill foi habilitado, o comando abortado e a tabela e temporria apagada. a Ao fazer um UPDATE TABLE and DELETE TABLE, o sinal de kill conferido depois de e que cada bloco lido e depois de cada atualizao ou remoo de registro. Se o sinal e ca ca kill est habilitado, a instruo abortada. Note que se voc no estiver utilizando a ca e e a transaes, as alteraes no iro ser desfeitas! co co a a GET_LOCK() ir aborar com NULL. a Uma thread INSERT DELAYED ir rapidamente descarregar todos registros que estiverem a em memria e morrer. o Se a thread estiver no manipulador de bloqueio de tabelas (status: Locked), o bloqueio de tabela ser abortado rapidamente. a Se a thread estiver esperando por espao livre em disco numa chamada write, a escrita c abortada com uma mensagem de espao em disco insuciente. e c

4.6.8 Sintaxe de SHOW

ou ou ou ou ou ou ou ou ou ou ou ou ou ou ou ou SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW SHOW DATABASES [LIKE wild] [OPEN] TABLES [FROM nome_bd] [LIKE wild] [FULL] COLUMNS FROM nome_tbl [FROM nome_bd] [LIKE wild] INDEX FROM nome_tbl [FROM nome_bd] TABLE STATUS [FROM nome_bd] [LIKE wild] STATUS [LIKE wild] VARIABLES [LIKE wild] [BDB] LOGS [FULL] PROCESSLIST GRANTS FOR user CREATE TABLE nome_tbl MASTER STATUS MASTER LOGS SLAVE STATUS WARNINGS [LIMIT row_count] ERRORS [LIMIT row_count] TABLE TYPES

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

303

SHOW fornece informaes sobre bancos de dados, tabelas, colunas ou informaes do estado co co do servidor. Se a parte LIKE wild usada, a string wild pode ser uma string que usa os e meta caracteres % e _ do SQL.

4.6.8.1 Recuperando Informaoes sobre Bancos de Dados, Tabelas, c Colunas e Indices

Voc pode usar nome_bd.nome_tabela como uma alternativa para a sintaxe nome_tabela e FROM nome_bd. Estas duas declaraes so equivalentes: co a mysql> SHOW INDEX FROM minhatabela FROM meudb; mysql> SHOW INDEX FROM meubd.minhatabela; SHOW DATABASES lista os bancos de dados no servidor MySQL. Voc tambm pode obter e e esta lista utilizando o comando mysqlshow. Na verso 4.0.2 voc ver apenas aqeules banco a e a de dados para os quais voc tem algum tipo de privilgio, se voc no tiver o privilgio e e e a e global SHOW DATABASES. SHOW TABLES lista as tabelas em um banco de dados espec ico. Esta lista tambm pode ser e obtida utilizando o comando mysqlshow nome_db. NOTA: Se um usurio no possui nenhum privilgio para uma tabela, a tabela no ser a a e a a de SHOW TABLES ou mysqlshow nome_db mostrada na saida SHOW OPEN TABLES lista as tabelas que esto abertas no cache de tabelas. Veja Seo 5.4.7 a ca [Cache de Tabelas], Pgina 451. O campo Comment diz quantas vezes a tabela est em a a cached e in_use. SHOW COLUMNS lista as colunas em uma determinada tabela. Se voc especicar a opo FULL, e ca tambm ir obter os privilgios que voc possui para cada coluna. Se os tipos de colunas e a e e forem diferentes do que voc esperava baseando na declarao CREATE TABLE, perceba que e ca o MySQL algumas vezes altera os tipos das colunas. Veja Seo 6.5.3.1 [Mudana de tipos ca c de colunas], Pgina 607. A partir do MySQL 4.1, a palavra chave FULL tambm faz com a e que qualquer comentrio por coluna seja mostrado. a A instruo DESCRIBE fornece informao similar ` SHOW COLUMNS. ca ca a [DESCRIBE], Pgina 614. a Veja Seo 6.6.2 ca

SHOW FIELDS um sinnimo para SHOW COLUMNS e SHOW KEYS um sinnimo para SHOW INDEX. e o o Voc tambm pode listar as colunas ou e e indices de uma tabela com mysqlshow nome_db nome_tabela ou mysqlshow -k nome_bd nome_tabela. SHOW INDEX retorna a informao de ca indice em um formato que lembra bem a chamada SQLStatistics do ODBC. As seguintes colunas so retornadas: a Coluna Table Non_unique Key_name Seq_in_ index Column_name Signicado Nome da tabela. 0 se o indice no puder conter duplicidades, 1 se a puder Nome do indice. Nmero da sequncia da coluna no u e indice, ` para tir de 1. Nome da coluna.

304

MySQL Technical Reference for Version 5.0.0-alpha

Collation

Cardinality Sub_part Null Index_type Comment

Como a coluna ordenada no e indice. No MySQL, pode ter valores A (Ascendente) ou NULL (Not sorted). Nmero de valores unicos no u indice. Isto atue alizado executando isamchk -a. Nmero de caracteres indexados se a coluna s u oe a indexada parcialmente. NULL se a chave inteira for indexada. Contm YES se a coluna puder conter NULL. e Mtodo de e indice utilizado. Vrios comentrios. No momento, ele diz no a a MySQL < 4.0.2 se o indice FULLTEXT ou no. e a

Perceba que como o Cardinality contado baseado nas estat e isticas armazenadas como inteiros, ele pode no ser exato para tabelas pequenas. a As colunas Null e Index_type foram adicionadas no MySQL 4.0.2.

4.6.8.2 SHOW TABLE STATUS

SHOW TABLE STATUS [FROM nome_bd] [LIKE wild] SHOW TABLE STATUS (introduzido na verso 3.23) funciona como o SHOW STATUS, mas fornece a muitas informaes sobre cada tabela. Voc tambm pode obter esta lista utilizando o co e e comando mysqlshow --status nome_bd. As seguintes colunas so retornadas: a Coluna Name Type Row_format Rows Avg_row_length Data_length Max_data_length Signicado Nome da tabela. Tipo da tabela. Veja Cap ptexi tulo 7 [Table types], Pgina 630. a O formato de armazenamento do registro (Fixed (Fixo), Dynamic(dinmico), ou Compressed (Compactado)). a Nmero de registros. u Tamanho mdio do registro. e Tamanho do arquivo de dados. Tamanho mximo do arquivo de dados. Para formatos de a registro xo, este o nmero maimo de registros na tabela. e u Para formatos de registro dinmicos, este o nmero total de a e u bytes de dados que pode ser armazenados na tabela, dado o tamanho do ponteiro de dados utilizado. Tamanho do arquivo de indice. Nmero de bytes alocados mas no utilizados. u a Prximo valor do auto incremento. o Quando a tabela foi criada. A ultima vez que arquivo de dados foi atualizado. Conjunto de caracter e collation da tabela. (novo no 4.1.1) Valor do checksum (se existir). (novo no 4.1.1) A ultima vez que a tabela foi vericada. Opes extras usadas com CREATE TABLE. co

Index_length Data_free Auto_increment Create_time Update_time Collation Checksum Check_time Create_options

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

305

Comment

O Comentrio utilizado quando a tabela criada (ou alguma a e informao do porqu do MySQL no poder acessar a inca e a formao da tabela). ca Tabelas InnoDB iro relatar o espao livre no tablespace no comentrio da tabela. a c a

4.6.8.3 SHOW STATUS

SHOW STATUS fornece informaes de status do servidor (como mysqladmin extendedco status). A sa parecida com o que est exibido abaixo, apesar dos nmeros e formatos ida e a u provavelmente serem diferentes: +--------------------------+------------+ | Variable_name | Value | +--------------------------+------------+ | Aborted_clients | 0 | | Aborted_connects | 0 | | Bytes_received | 155372598 | | Bytes_sent | 1176560426 | | Connections | 30023 | | Created_tmp_disk_tables | 0 | | Created_tmp_tables | 8340 | | Created_tmp_files | 60 | | Delayed_insert_threads | 0 | | Delayed_writes | 0 | | Delayed_errors | 0 | | Flush_commands | 1 | | Handler_delete | 462604 | | Handler_read_first | 105881 | | Handler_read_key | 27820558 | | Handler_read_next | 390681754 | | Handler_read_prev | 6022500 | | Handler_read_rnd | 30546748 | | Handler_read_rnd_next | 246216530 | | Handler_update | 16945404 | | Handler_write | 60356676 | | Key_blocks_used | 14955 | | Key_read_requests | 96854827 | | Key_reads | 162040 | | Key_write_requests | 7589728 | | Key_writes | 3813196 | | Max_used_connections | 0 | | Not_flushed_key_blocks | 0 | | Not_flushed_delayed_rows | 0 | | Open_tables | 1 | | Open_files | 2 | | Open_streams | 0 | | Opened_tables | 44600 |

306

MySQL Technical Reference for Version 5.0.0-alpha

| Questions | 2026873 | | Select_full_join | 0 | | Select_full_range_join | 0 | | Select_range | 99646 | | Select_range_check | 0 | | Select_scan | 30802 | | Slave_running | OFF | | Slave_open_temp_tables | 0 | | Slow_launch_threads | 0 | | Slow_queries | 0 | | Sort_merge_passes | 30 | | Sort_range | 500 | | Sort_rows | 30296250 | | Sort_scan | 4650 | | Table_locks_immediate | 1920382 | | Table_locks_waited | 0 | | Threads_cached | 0 | | Threads_created | 30022 | | Threads_connected | 1 | | Threads_running | 1 | | Uptime | 80380 | +--------------------------+------------+ As variveis de estado listadas acima tem o seguinte signicado: a Varivel a Aborted_clients Aborted_connects Bytes_received Bytes_sent Com_xxxx Connections Created_tmp_disk_ tables Created_tmp_tables Created_tmp_files Delayed_insert_threads Delayed_writes Delayed_errors Flush_commands Handler_delete Signcado Nmero de conexes abortadas porque o cliente morreu sem u o fechar a conexo corretamente. Veja Seo A.2.10 [Erros de a ca Comunicao], Pgina 918. ca a Nmero de tentativas que falharam ao tentar a conexo ao u a servidor MySQL. Veja Seo A.2.10 [Erros de Comunicao], ca ca Pgina 918. a Nmero de bytes recebidos por todos os clientes. u Nmero de bytes enviados para todos os clientes.. u Nmero de vezes que os comandos xxx foram executados. u Nmero de tentativas de conexo ao servidor MySQL. u a Nmero de tabelas temporrias implicitas em disco criadas u a durante a execuo de instrues. ca co Nmero de tabelas temporrias implicitas na memria criadas u a o durante execues de instrues. co co Quantos arquivos temporrios o mysqld criou. a Nmero de threads para tratamento de insertdelayed que u esto em uso. a Nmero de registros escritos com INSERT DELAYED. u Nmero de registros escritos com INSERT DELAYED onde algum u erro ocorreu (provavelmente duplicate key). Nmero de comandos FLUSH executados. u Nmero de vezes que um registro foi apagado da tabela. u

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

307

Handler_read_first

Handler_read_key Handler_read_next

Handler_read_prev Handler_read_rnd Handler_read_rnd_next

Handler_rollback Handler_update Handler_write Key_blocks_used Key_read_requests Key_reads Key_write_requests Key_writes Max_used_connections Not_flushed_key_blocks Not_flushed_delayed_ rows Open_tables Open_files Open_streams Opened_tables Rpl_status Select_full_join Select_full_range_join Select_range

Nmero de vezes que a primeira entrada foi lida de um u indice. Se este valor for alto, sugere que o servidor est fazendo vrias a a leituras de indices, por exemplo, SELECT col1 FROM foo, assumindo que col1 indexado. e Nmero de requisioes para ler um registro baseado em uma u c chave. Se este valor for alto, uma boa indicao que suas e ca pesquisas e tabelas esto indexadas corretamente. a Nmero de requisies para ler o prximo registro na ordem u co o da chave. Este valor ser aumentado se voc consultar uma a e coluna de indice com uma faixa restrita. Ele tambm aumene tar se forem feitas busca nos a indices. Nmro de requisies ao registros anterior na ordem da chave. e co Ele principalmente usado para otimizar ORDER BY ... DESC. e Nmero de requisies para ler um registro baseado em uma u co posio xa. O valor ser alto se voc estiver executando ca a e vrias pesquisas que exigem ordenao do resultado. a ca Nmero de requises para ler o prximo registro no arquivo u o o de dados. Ser alto se voc estiver fazendo vrias buscas na a e a tabela. Geralmente sugere que suas tabelas no esto correa a tamente indexadas ou que suas pesquisas no foram escritas a para tirar vantagem dos indices existentes. Nmeros de comandos ROLLBACK internos. u Nmero de requisies para atualizar um registro em uma u co tabela. Nmero de requisies para inserir um registro em uma u co tabela. O nmero de blocos utilizados no cache das chaves. u O nmero de requisies para ler um bloco de chaves do cache. u co O nmero de leituras f u isicas de blocos de chaves do disco. O nmero de requisies para gravar um bloco de chaves no u co cache. O nmero de escritas f u isicas de um bloco de chaves para o disco. O nmero mximo de conexes simultneas que foram usadas. u a o a Blocos de chaves no cache de chaves que foi alterado mas ainda no foi descarregado para o disco. a Nmero de registros esperando para serem escritos em las u INSERT DELAY. Nmero de tabelas abertas. u Nmero de arquivos abertos. u Nmero de uxos abertos (usado principalmente para logs). u Nmero de tabelas que foram abertas. u Status de replicao segura. (Ainda no est em uso). ca a a Nmero de joins sem chaves (Se for 0, voc deve conferir com u e cuidado o indice de suas tabelas). Nmero de joins onde foram usadas pesquisas segmentadas u na tabela de referencia. Nmero de joins onde foram usadas faixas da primeira tabela. u (Normalmente no cr a e itica mesmo se o valor estiver alto.)

308

MySQL Technical Reference for Version 5.0.0-alpha

Nmero de joins onde zemos uma busca completa na u primeira tabela. Select_range_check Nmero de joins sem chaves onde o uso de chave foi conferido u aps cada registro (Se for 0, o o indice de suas tabelas deve ser conferido com cuidado) Questions Nmero de consultas enviadas para o servidor. u Slave_open_temp_tables Nmero de tabelas temporrias atualmente abertas pela u a thread slave. Slave_running E ON se este slave est conectado a um master. a Slow_launch_threads Nmero de threads que levaram mais tempo do que slow_ u lauch_time para serem criadas. Slow_queries Nmero de consultas que levaram mais tempo que long_ u query_time segundos. Veja Seo 4.10.5 [Log de consultas ca lentas], Pgina 377. a Sort_merge_passes Nmero de ifuses feitas pelo algor u o itmo de ordenao. Se ca este valor for alto voc deve considerar o aumento de sort_ e buffer. Sort_range Nmero de ordenaoes que foram feitas com limites. u c Sort_rows Nmero de registros ordenados. u Sort_scan Nmero de ordenaoes que foram feitas lendo a tabela. u c ssl_xxx Variveis usadas por SSL; Ainda no implementado. a a Table_locks_immediate Nmero de vezes que um travamento de tabela foi obtido de u maneira automtica. a Table_locks_waited Nmero de vezes que um bloqueio de tabela no pde ser u a o obtido imediatamente e foi preciso esperar. Se o valor for alto, e voc tiver problemas de performance, suas consultas e devem ser otimizadas e depois dividir sua tabela ou tabelas ou usar replicao. Dispon ` partir da verso 3.23.33 ca ivel a a Threads_cached Nmero de threads no cache de threads. u Threads_connected Nmero de conexes atuais abertas. u o Threads_created Nmero de threads criadas para lidar com conexes. u o Threads_running Nmero de threads que no esto dormindo. u a a Uptime Quantos segundos o servidor est funcionando. a Alguns comentrios sobre a tabela acima: a Se Opened_tables for grande, provavelmente sua varivel table_cache est muito a a pequena. Se key_reads for grande, provavelmente sua varivel key_buffer_size provavelmente a est muito pequena. O indice de acertos do cache pode ser calculaldo com key_ a reads/key_read_requests. Se Handler_read_rnd for grande, provavelmente voc possui vrias consultas que exe a igem do MySQL fazer busca em tabelas inteiras ou voc tem joins que no utilizam e a chaves corretamente. Se Threads_created for grande voc pode desejar aumentar a varivel e a thread_cache_size. A taxa de acerto da cache pode ser calculada com Threads_created/Connections. Se Created_tmp_disk_tables for grande, voc pode querer aumentar a varivel tmp_ e a table_size par obter tabelas temporrias em memrias em vez de tabelas em disco. a o

Select_scan

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

309

4.6.8.4 SHOW VARIABLES

SHOW [GLOBAL | SESSION] VARIABLES [LIKE wild] SHOW VARIABLES exibe os valores de algumas variveis de sistema do MySQL. a As opes GLOBAL e SESSION so novas no MySQL 4.0.3. Com GLOBAL voc obter as co a e a variveis que sero utilizadas para novas conexes ao MySQL. Com SESSION voc obter a a o e a os valores que esto em efeito para a conexo atual. Se voc no estiver usando nenhuma a a e a opo, SESSION ser usada. ca a Se os valores padres no lhe servirem, voc pode congurar a maioria destas variveis uso a e a ando as opes de linha de comando na inicializao do mysqld. Veja Seo 4.1.1 [Commandco ca ca line options], Pgina 207. Voc pode alterar a maioria das variveis com o comando SET. a e a Veja Seo 5.5.6 [SET], Pgina 460. ca a de SHOW VARIABLES se parece com o exibido abaixo, embora o formato e os A saida nmeros possam divergir. Voc tambm pode conseguir esta informao usando o comando u e e ca mysqladmin variables. +---------------------------------+------------------------------+ | Variable_name | Value | +---------------------------------+------------------------------| | back_log | 50 | | basedir | /usr/local/mysql | | bdb_cache_size | 8388572 | | bdb_log_buffer_size | 32768 | | bdb_home | /usr/local/mysql | | bdb_max_lock | 10000 | | bdb_logdir | | | bdb_shared_data | OFF | | bdb_tmpdir | /tmp/ | | bdb_version | Sleepycat Software: ... | | binlog_cache_size | 32768 | | bulk_insert_buffer_size | 8388608 | | character_set | latin1 | | character_sets | latin1 big5 czech euc_kr | | concurrent_insert | ON | | connect_timeout | 5 | | convert_character_set | | | datadir | /usr/local/mysql/data/ | | delay_key_write | ON | | delayed_insert_limit | 100 | | delayed_insert_timeout | 300 | | delayed_queue_size | 1000 | | flush | OFF | | flush_time | 0 | | ft_boolean_syntax | + -><()~*:""&| | | ft_min_word_len | 4 | | ft_max_word_len | 84 | | ft_query_expansion_limit | 20 |

310

MySQL Technical Reference for Version 5.0.0-alpha

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

ft_stopword_file have_bdb have_innodb have_isam have_raid have_symlink have_openssl have_query_cache init_file innodb_additional_mem_pool_size innodb_buffer_pool_size innodb_data_file_path innodb_data_home_dir innodb_file_io_threads innodb_force_recovery innodb_thread_concurrency innodb_flush_log_at_trx_commit innodb_fast_shutdown innodb_flush_method innodb_lock_wait_timeout innodb_log_arch_dir innodb_log_archive innodb_log_buffer_size innodb_log_file_size innodb_log_files_in_group innodb_log_group_home_dir innodb_mirrored_log_groups interactive_timeout join_buffer_size key_buffer_size language large_files_support local_infile locked_in_memory log log_update log_bin log_slave_updates log_slow_queries log_warnings long_query_time low_priority_updates lower_case_table_names max_allowed_packet max_binlog_cache_size max_binlog_size max_connections

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

(built-in) YES YES YES NO DISABLED YES YES 1048576 8388608 ibdata1:10M:autoextend 4 0 8 1 ON 50 OFF 1048576 5242880 2 ./ 1 28800 131072 16773120 /usr/local/mysql/share/... ON ON OFF OFF OFF OFF OFF OFF OFF 10 OFF OFF 1047552 4294967295 1073741824 100

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

311

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

max_connect_errors max_delayed_threads max_heap_table_size max_join_size max_relay_log_size max_sort_length max_user_connections max_tmp_tables max_write_lock_count myisam_max_extra_sort_file_size myisam_repair_threads myisam_max_sort_file_size myisam_recover_options myisam_sort_buffer_size net_buffer_length net_read_timeout net_retry_count net_write_timeout open_files_limit pid_file port protocol_version query_cache_limit query_cache_size query_cache_type read_buffer_size read_rnd_buffer_size rpl_recovery_rank safe_show_database server_id slave_net_timeout skip_external_locking skip_networking skip_show_database slow_launch_time socket sort_buffer_size sql_mode table_cache table_type thread_cache_size thread_stack tx_isolation timezone tmp_table_size tmpdir version

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

10 20 16777216 4294967295 0 1024 0 32 4294967295 268435456 1 2147483647 force 8388608 16384 30 10 60 1024 /usr/local/mysql/name.pid 3306 10 1048576 0 ON 131072 262144 0 OFF 0 3600 ON OFF OFF 2 /tmp/mysql.sock 2097116 64 MYISAM 3 131072 READ-COMMITTED EEST 33554432 /tmp/:/mnt/hd2/tmp/ 4.0.4-beta

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

312

MySQL Technical Reference for Version 5.0.0-alpha

| wait_timeout | 28800 | +---------------------------------+------------------------------+ Cada opo descrita abaixo. Valores para tamanhos de buer, comprimento e tamanho ca e de pilha so fornecidos em bytes. Voc pode especicar valores com suxos K ou M para a e indicar o valor em kilobytes ou megabytes. Por exemplo, 16M indica 16 Megabytes. No a importa se os suxos esto em letras maisuculas ou minsculas; 16M e 16m so equivalentes: a u u a ansi_mode. Est ligado (ON) se o mysqld foi iniciado com --ansi. Veja Seo 1.8.2 a ca [Modo ANSI], Pgina 42. a back_log O nmero de requisies de conexes que o MySQL pode suportar. Isto entra u co o em cena quando a thread principal do MySQL recebe MUITAS solicitaes de conexes co o em um espao curto de tempo. Eles tomam algum tempo (porm muito pouco) da a c e thread principal para conferir a conexo e iniciar uma nova thread. O valor back_log a indica quantas requisies podem ser empilhadas durante este breve tempo antes do co MySQL parar de responder a novas requisies. Voc is precisa aument-lo se espera co e o a um nmero alto de conexes em um curto periodo de tempo u o Em outras palavras, este valor o tamanho da la de escuta para novas conexes e o TCP/IP. Seu sistema operacional tem o prprio limite para o tamanho desta la. o A pgina do manual Unix da chamada de sistema listen(2) deve fornecer maiores a detalhes. Conra a documentao do seus SO para saber o valor mximo para esta ca a varivel. Tentativas de congurar back_log maior do que o limite de seu sistema a operacional sero inecazes. a basedir O valor da opo --basedir. ca bdb_cache_size O buer que alocado para o cache de e indice e registros de tabelas BDB. Se voc no utiliza tabelas BDB, deve iniciar o mysqld com a opo --skip-bdb e a ca de memria para este cache. para evitar desperdicio o bdb_log_buffer_size O buer que alocado para o cache de e indice e registros de tabelas BDB. Se voc no utiliza tabelas BDB, deve congur-la com 0 ou iniciar o e a a mysqld com a opo --skip-bdb para evitar desperd de memria para este cache. ca icio o bdb_home O valor para a opo --bdb-home. ca bdb_max_lock O nmero mximo de bloqueios (1000 por padro) que podem ser feitas u a a em uma tabela BDB. Voc deve ser aument-la se obter erros do tipo: bdb: Lock e a table is out of available locks ou Got error 12 from ... quando so necessrias a a longas transaes ou quando o mysqld precisar examinar vrios registros para calcular co a a pesquisa. bdb_logdir O valor da opo --bdb-logdir. ca bdb_shared_data Est ligada (ON) se voc estiver utilizando --bdb-shared-data. a e bdb_tmpdir O valor da opo --bdb-tmpdir. ca binlog_cache_size. O tamanho do cache para armazenar instrues SQL para o co log binrio durante uma transao. Se voc geralmente utiliza transaes grandes, a ca e co multi-instrues, voc pode aumentar este valor para obter mais performance. Veja co e Seo 6.7.1 [COMMIT], Pgina 615. ca a bulk_insert_buffer_size (era myisam_bulk_insert_tree_size) MyISAM usa uma cache especial em rvore para fazer inseres em bloco (isto , INSERT ... a co e SELECT, INSERT ... VALUES (...), (...), ..., e LOAD DATA INFILE) mais rpidos. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

313

Esta varivel limita o tamanho da rvore cache em bytes por thread. Den com 0 a a i-la desabilitar esta otimizao Nota: esta cache s usada quando adicionado dados a a ca oe e uma tabela no vazia. O valor padro 8 MB. a a e character_set O conjunto de caracteres padro. a character_sets Os conjuntos de caracteres suportados. concurrent_inserts Se ON (ligado, por padro), o MySQL permitir o uso de INSERT a a em tabelas MyISAM ao mesmo tempo em que so executadas consultas SELECT. Voc a e pode desligar esta opo iniciando mysqld com --safe ou --skip-new. ca connect_timeout O nmero de segundos que o servidor mysqld espera para um pacote u de conexo antes de responder com Bad handshake. a datadir O valor da opo --datadir. ca delay_key_write Option for MyISAM tables. Can have one of the following values: OFF All CREATE TABLE ... DELAYED_KEY_WRITE so ignorados. a ON (padro) MySQL seguir a opo DELAY_KEY_WRITE para a a ca CREATE TABLE. ALL Todas as novas tabelas abertas so tratadas como se fossem a criadas com a opo DELAY_KEY_WRITE. ca Se DELAY_KEY_WRITE estiver habilitado, isto siginica que o buer de chaves das tabelas com esta opo no sero descarregadas a cada atualizao do ca a a ca indice, mas somente quando a tabela fechada. Isto ir aumentar bem a velocidade de escrita em chaves, e a mas voc deve adicionar vericao automtica de todas as tabelas com myisamchk e ca a --fast --force se voc us-lo. e a delayed_insert_limit Depois de inserir delayed_insert_limit registros, o agente que cuida de INSERT DELAYED ira conferir se exitem instrues SELECT pendentes. Se co sim, ele permite a execuo destas antes de continuar. ca delayed_insert_timeout Quanto tempo uma thread INSERT DELAYED deve esperar por instrues INSERT antes de terminar. co delayed_queue_size Qual tamanho deve ser alocado para a la (em linhas) para lidar com INSERT DELAYED. Se a la encher, algum cliente que executar INSERT DELAYED ir a esperar at existir espao na la novamente. e c habilitado (ON) se voc iniciar o MySQL com a opo --flush. flush E e ca flush_time Se esta varivel for congurada com um valor diferente de zero, ento a a a cada flush_time segundos todas tabelas sero fechadas (para economizar recursos e a sincronizar dados com o disco). Recomendamos esta opo somente em sistemas com ca Win95, Win98 ou outros sistemas com poucos recursos. ft_boolean_syntax Lista de operadores suportados por MATCH ... AGAINST(... IN BOOLEAN MODE). Veja Seo 6.8 [Pesquisa Fulltext], Pgina 619. ca a ft_min_word_len O tamanho minimo da palavra a ser inclu em um ida indice FULLTEXT. Nota: indices FULLTEXT devem ser reconstru idos depois de alterar esta varivel. (Esta a opo nova para o MySQL 4.0.) ca e ft_max_word_len O tamanho mximo da palavra a ser inclu a ida em um indice FULLTEXT. Nota: indices FULLTEXT devem ser reconstru idos depois de alterar esta varivel. (Esta opo nova para o MySQL 4.0.) a ca e

314

MySQL Technical Reference for Version 5.0.0-alpha

ft_query_expansion_limit Nnero de correspondncias a usar para consulta de exu e panso (em MATCH ... AGAINST (... WITH QUERY EXPANSION). (Esta opo nova no a ca e MySQL 4.1.1) ft_max_word_len_for_sort O tamanho mximo da palavra a ser inclu em um a ida indice FULLTEXT a ser usado no mtodo rpido de recriao do e a ca indice em REPAIR, CREATE INDEX, ou ALTER TABLE. Palavras mais longas so inseridas de modo lento. A a regra do dedo a seguinte: com ft_max_word_len_for_sort aumentando, MySQL a e criar arquivos temporrios maiores (tornando o processo lente, devido a E/S de a a disco), e colocar poucas chaves em um bloco ordenado (diminuindo a ecincia noa e vamente). Quando ft_max_word_len_for_sort muito pequeno, MySQL ir inserir e a vrias palavras no a indice de modo lento, mas pequenas palavras sero inseridas muito a rapidamente. ft_stopword_file O arquivo do qual se l a lista de palavras de parada para pesquisa e fulltext. Todas as palavras do arquivo sero usadas; comentrios no so seguidos. a a a a de palavras de parada a usada (como denido em Por padro, a lista j incluida a a e myisam/ft_static.c). Denir este parmetro com uma string vazia ("") disabilitaa a o ltro de palavras de parada. Nota: indices FULLTEXT devem ser reconstru idos depois de alterar esta varivel. (Esta opo nova para o MySQL 4.0.) a ca e have_innodb YES if mysqld suporta tabelas InnoDB. DISABLED se --skip-innodb e usado. have_bdb YES se o mysqld suportar tabelas Berkeley DB. DISABLED se a opo --skipca bdb for usada. have_raid YES se o mysqld suportar a opo RAID. ca have_openssl YES se o mysqld suportar SSL (criptograa) no protocolo cliente/ servidor. init_file O nome do arquivo especicado com a opo --init-file quando voc ca e iniciar o servidor. Este um arquivo das instrues SQL que voc deseja que o servidor e co e execute quando iniciado. e interactive_timeout O nmero de segundos que o servidor espera por atividade u em uma conexo antes de fech-la. Um cliente interativo denido como um cliente a a e que utiliza a opo CLIENT_INTERACTIVE para mysql_real_connect(). Veja tambm ca e wait_timeout. join_buffer_size O tamanho do buer que utilizado para full joins (joins que no e a utilizam indices). O buer alocado uma vez para cada full join entre duas tabelas. e Aumente este valor para obter um full join mais rpido quando a adio de a ca indices no a for poss ivel. (Normalmente a melhor forma de obter joins rpidas adicionar a e indices.) key_buffer_size Blocos de indices so buferizados e compartilhados por todas as a threads. key_buffer_size o tamanho do buer utilizado para indexar blocos. e Aumente-o para lidar melhor com os indices (para todas as leituras e escritas mltiplas) u para o mximo poss 64M em uma mquina com 256M que executa, principalmente, a ivel a o MySQL bastante comum. Entretanto, se voc deixar este valor muito grande e e (mais que 50% da sua memria total?) seu sistema pode iniciar a paginar e se tornar o MUITO lento. Lembre-se que como o MySQL no utiliza cache de leitura de dados, a ser necessrio deixar algum espao para o cache do sistema de arquivos para o Sistema a a c Operacional.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

315

Voc pode vericar a performance do buer de chaves executando SHOW STATUS e examie nar as variveis Key_read_requests, Key_reads, Key_write_requests e Key_writes. a A razo de Key_reads/Key_read_request deve normalmente ser < 0.01. O Key_ a write/Key_write_requests normalmnte prximo de 1 se voc estiver utilizando na e o e maioria updates/deletes mas deve ser bem menor se voc tender a fazer atualizaes que e co afetam vrias outras ao mesmo tempo ou se voc estiver utilizando DELAY_KEY_WRITE. a e Veja Seo 4.6.8 [SHOW], Pgina 302. ca a Para obter ainda mais velocidade quando estiver gravando vrios registros ao mesmo a tempo, utilize LOCK TABLES. Veja Seo 6.7.5 [LOCK TABLES], Pgina 617. ca a language A linguagem utilizada para mensagens de erro. large_file_support Se o mysqld foi compilado com opes para suporte a grandes co arquivos. locked_in_memory Se o mysqld foi travado na memria com --memlock o log Se o log de todas as consultas est habilitado. a log_update Se o log de atualizaes est habilitado. co a log_bin Se o log binrios est habilitado. a a log_slave_updates Se as atualizaes do slave devem ser logadas. co long_query_time Se uma consulta demorar mais que isto (em segundos), o contador Slow_queries ser incrementado. Se voc estiver utilizando --log-slow-queries, a e consulta ser logada ao arquivo de consultas lentas. Veja Seo 4.10.5 [Slow query a ca log], Pgina 377. Este valor medido em tempo real, no em tempo de CPU, assim a e a uma consulta que pode estar pode estar abaixo do limiar de um sistema de carga leve pode estar acima do limiar de um sistema de carga pesada. Veja Seo 4.10.5 [Log de ca consultas lentas], Pgina 377. a lower_case_nome_tabelas Se estiver congurado para 1, nomes de tabelas so ara mazenados em letras minsculas no disco e nomes de tabelas sero caso-insensitivo. u a Na verso .0.2, esta opo tambm se aplica aos nomes de banco de dados. Na verso a ca e a 4.1.1 esta opo tambm se aplcia a alias de tabelas. Veja Seo 6.1.3 [Caso sensitivo ca e ca nos nomes], Pgina 473. a max_allowed_packet O valor mximo de um pacote. O buer de mensagens inicia e ado por net_buffer_length bytes, mas pode crescer at max_allowed_packet bytes e quando for necessrio. Este valor por padro pequeno, para obter pacotes maiores a a e (possivelmente errados). Voc deve incrementar este valor se voc estiver usando colue e nas BLOB grandes. Ele deve to grande quanto o maior BLOB que voc deseja utilizar. O a e protocol atual limita o max_allowed_packet ` 16M no MySQL 3.23 e 1G no MySQL a 4.0. max_binlog_cache_size Se uma transao multi-instrues necessitar de mais que este ca co montante de memria, ser obtido o erro "Multi-statement transaction required more o a than max binlog cache size bytes of storage" ("Transao multi-instrues necessita ca co mais que max binlog cache size bytes de armazenamento"). max_binlog_size Dispon ivel a partir da 3.23.33. Se uma escrita ao log binrio a (replicao) exceder o valor fornecido, rotacione os logs. Voc no pode congur-lo ca e a a para menos de 4096 bytes (1024 na verso do MySQL anteriores a 4.0.14), ou mais que a 1 GB. O valor padro 1 GB. Nota se voc estiver usando transaes: uma transao a e e co ca

316

MySQL Technical Reference for Version 5.0.0-alpha

escrita em um bloco no arquivo de log binrio, j que ele nunca separado entre e a a e diversos logs binrios. Desta forma, se voc tiver grandes transaes, voc pode ter a e co e logs binrios maioores que max_binlog_size. Se max_relay_log_size (dispon a a ivel partir do MySQL 4.0.14) 0, ento max_binlog_size se aplicar bem aos relay logs. e a a max_connections O Nmero de clientes simultneos permitidos. Aumentar este valor u a aumenta o nmero de descritores de arquivos que o mysqld necessita. Veja abaixo u os comentrios sobre os limites de descritores de arquivos. Veja Seo A.2.6 [Muitas a ca conexes], Pgina 916. o a max_connect_errors Se houver mais que este nmero de conexes interrompidas a u o partir de uma mquina est mquina ter as prximas conexes bloqueadas. Voc a a a a o o e pode desbloquar uma mquina com o comadno FLUSH HOSTS. a max_delayed_threads No inicie mais do que este nmero de threads para lidar com a u instrues INSERT DELAYED. Se voc tentar inserir dados em uma nova tabela depois co e que todas as threads INSERT DELAYED estiverem em uso, o registro ser inserido como a se o atributo DELAYED no fosse especicado. Se voc congur-lo com 0, o MySQL a e a nunca criar uma thread max delayed. a max_heap_table_size Esta varivel dene o tamanho mximo que uma tabela HEAP a a criada pode ter. O valor da varivel usado para calcular um valor MAX_ROWS da tabela a e HEAP. A denio desta varivel no tem nenhum efeito sobre qualquet tabela HEAP ca a a existente, a memos que a tabela seja recriada com uma instruo como CREATE TABLE ca ou TRUNCATE TABLE, ou alterada com ALTER TABLE. max_join_size Joins que provavelmente forem ler mais que max_join_size registros retornam um erro. Congure este valor se os seus usurios tendem a realizar joins que a no possuem uma clusula WHERE, que tomam muito tempo, e retornam milhes de a a o registros. max_relay_log_size Dispon a partir da verso 4.0.14. Se uma escrita ao relay log ivel a (um tipo de log usado por slaves de replicao, veja Seo 4.11.3 [Replication Implemenca ca tation Details], Pgina 381) exceder o valor dado, rotacione o relay log. Esta varivel a a lhe permite colocar diferentes restries de tamanho no relay logs e logs binrios. No co a entanto, congurar a varivel com 0 far o MySQL usar max_binlog_size tanto para a a o log binrio quanto para o relay logs. Voc tem que congurar max_relay_log_size a e com 0 ou mais de 4096, e menos que 1 GB. O padro 0. a e max_seeks_for_key Limite do nmero mximo de buscas ao procurar linhas com base u a em uma chave. O otimizador MySQL assumir que quando pesquisar por linhas correa spondentes em uma tabela atravs da varredura da chave, no faremos mais que este e a nmero de busca de chave independente da cardinalidade da chave. Congurando este u parmetro com um valor baixo (100 ?) voc pode forar o MySQL a preferir chaves a e c em vez de varrer a tabela. max_sort_length O nmero de bytes utilizados para ordenar valores BLOB ou TEXT u (somente os primeiros max_sort_lenght bytes de cada valor so usados; o resto a e ignorado). max_user_connections O valor mximo de conexes ativas para um unico usurio (0 a o a = sem limite). max_tmp_tables (Esta opo ainda no faz nada.) Nmero mximo de tabelas temca a u a porrias que um cliente pode manter abertas ao mesmo tempo. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

317

max_write_lock_count Depois desta quantidade de bloqueios de escrita, permite que alguns bloqueios de leitura sejam executados. myisam_recover_options O valor da opo --myisam-recover. ca myisam_sort_buffer_size O buer que alocado ao ordenar o e indice quando estiver fazendo um REPAIR ou estiver criando indices com CREATE INDEX ou ALTER TABLE. myisam_max_extra_sort_file_size. Se a criao do arquivo temporrio para criao ca a ca rpida de a indices fosse este valor maior que quando for usado o cache de chaves, de preferncia ao mtodo de cache de chaves. Isto usado principalmente para forar que e e e c longas chaves de caracteres em tabelas grandes usem o mtodo de cache de chaves mais e lenta para criar o indice. NOTE que este parmetro fornecido em megabytes! a e myisam_repair_threads. Se este valor maior que um, durante o processo reparo e por ordena~o os ca indices de tabels MyISAM sero criados em paralelo - cada a indice em sua prpria thread. Nota reparos com multi-threads est ainda sob cdigo de qualidade o a o alpha. myisam_max_sort_file_size O tamanho mximo do arquivo temporrio que pera a e mitido ao MySQL usar enquanto recria os indices (durante REPAIR, ALTER TABLE ou LOAD DATA INFILE). Se o tamanho do arquivo for maior que isto, o indice ser criado a atravs do cache de chaves (que mais lento). NOTE que este parmetro fornecido e e a e em megabytes antes da verso 4.0.3 e em bytes a partir desta verso. a a net_buffer_length O buer de comunicaes congurado para este tamanho enco e tre queries. Isto no deve ser alterado normalmente, mas se voc tem muito pouca a e memria, pode congur-lo para o tamanho esperado de uma consulta. (Isto , o o a e tamanho experado das instrues SQL enviadas pelos clientes. Se as instrues exco co cederem este valor, o buer aumentado automaticamente, at max_allowed_packet e e bytes.) net_read_timeout Nmero de segundos para esperar por mais dados de uma conexo u a antes de abortar a leitura. Perceba que quando ns no esperamos dados de uma o a conexo, o tempo mximo de espera denido pelo write_timeout. Veja tambm a a e e slave_read_timeout. net_retry_count Se uma leitura na porta de comunicaes for interrompida, tente co novamente net_retry_count vezes antes de parar. Este valor deve ser bem alto no FreeBSD j que interrupes internas so enviadas para todas as threads. a co a net_write_timeout Nmero de segundos para esperar pela escrita de um bloco em u uma conexo antes de abortar a escrita. a open_files_limit Nmero de arquivos que o sistema permite que o mysqld abra. u Este o valor real dado para o sistema e pode ser diferente do valor que voc passa ao e e mysqld como parmetro de inicializao. Ele 0 em sistemas onde o MySQL no pode a ca e a alterar o nmero de arquivos abertos. u pid_file O valor da opo --pid-file. ca port O valor da opcao --port. protocol_version A verso do protocolo usada pelo servidor MySQL. a range_alloc_block_size Tamanho dos blocos que so alocados ao se fazer uma a otimizao da faixa. ca

318

MySQL Technical Reference for Version 5.0.0-alpha

read_buffer_size (era record_buffer) Cada thread que faz uma leitura sequencial aloca um buer deste tamanho para cada tabela lida. Se voc zer vrias leituras e a sequenciais, voc pode desejar aumentar este valor. e read_rnd_buffer_ae (era record_rnd_buffer) Ao ler registros na ordem depois de uma ordenao, os registros so lidos atravs deste buer para evitar pesquisas em ca a e disco. Pode melhorar bastante o ORDER BY se congurado com um valor alto. Como esta uma varivel espec e a ica da thread, no se pode den globalmente, mas apenas a i-la alter-la ao executar alguma consulta espec a ica grande. query_alloc_block_size Tamanho dos blocos de alocao de memria que so aloca o a cados para objetos criados durante a anlise e execuo da consulta. Se voc tiver a ca e problemas com fragmentao de memria ele pode ajudar a aumentar isto um pouco. ca o query_cache_limit No armazena resultados que so maiores que esta varivel. a a a (Padro 1M). a query_cache_size A memria alocada para armazenar resultados de consultas antigas. o Se 0, a cache de consulta desabilitada (padrot). e a query_cache_type Pode ser congurado com (somente numrico) e Valor 0 1 2 Comentrio a No armazena ou recupera resultados a Armazena todos os resultados exceto consultas SELECT SQL_NO_ CACHE .... DEMAND Armazena apenas consultas SELECT SQL_CACHE .... Alias OFF ON

query_prealloc_size Buer persistente para anlise e execuo da consulta. No a ca a e liberado entre consultas. Em teoria, tornando-o grande o suciente voc pode fazer e o MySQL executar consultas sem ter que fazer uma unica chamada malloc. safe_show_database No exibe bancos de dados nos quais o usurio no tem nenhum a a a privilgios. Isto pode melhorar a segurana se voc se preocupa com o fato das pessoas e c e estarem aptas a ver quais bancos de dados outros usurios possuem. Veja tambm a e skip_show_databases. server_id O valor da opo --server-id. ca skip_locking Est desligado (OFF) se o mysqld usar bloqueio externo. a skip_networking Est ligado (ON) se somente permitimos conexes locais (socket). a o skip_show_databases Isto previne usurios de fazerem SHOW DATABASES se eles no a a possuirem o privilgio PROCESS_PRIV. Isto pode aumentar a segurana se voc se e c e preocupa com o fato das pessoas poderem ver quais bancos de dados outros usurios a possuem. Veja tambm safe_show_databases. e slave_net_timeout Nmero de segundos para esperar por mais dados de uma conexo u a de master/slave antes de abortar a leitura. slow_launch_time Se a criao de threads demorar mais que este valor (em segundos), ca o contador Slow_launch_threads ser incrementado. a socket O socket Unix utilizado pelo servidor. sort_buffer Cada thread que precisar fazer uma ordenao aloca um buer deste ca tamanho. Aumente este valor para operaoes ORDER BY ou GROUP BY mais rpidas. c a Veja Seo A.4.4 [Arquivos temporrios], Pgina 929. ca a a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

319

table_cache O nmero de tabelas abertas para todas as threads. Aumentar este u valor aumenta o nmero de descritores de arquivos que o mysql necessita. O MySQL u precisa de dois descritores de arquivos para cada tabela unica aberta. Veja abaixo os comentarios sobre os limites do descritor de arquivos. Voc pode conferir se necessita a e aumentar o cache de tabela conferindo a varivel Opened_tables. Veja Seo 4.6.8.3 a ca [Tabelas Abertas], Pgina 305. Se esta varivel for grande e voc no faz muitos a a e a FLUSH TABLES (que apenas fora todas as tabelas a serem fechadas e reabertas), ento c a voc deve aumentar o valor desta varivel. e a Para informaes sobre como o cache de tabelas funciona, veja Seo 5.4.7 [Table cache], co ca Pgina 451. a table_type O tipo padro de tabelas. a thread_cache_size Quantas threads devem ser mantidas em cache para reutilizao. ca Quando um cliente desconecta, as threads dos clientes so colocadas no cache se no a a existir mais de thread_cache_size threads que antes. Todas novas threads sero a obtidas primeiramente do cache, e s quando o cache estiver vazio uma nova thread o e criada. Esta varivel pode ser aumentada para melhorar a performance se voc tiver a e vrias conexes novas. (Normalmente isto no d uma melhora de performance notvel a o a a a se voc possuir uma boa implementao de threads.) Examinando as diferenas entre e ca c Connections e Threads_create (veja Seo 4.6.8.3 [SHOW STATUS], Pgina 305 para ca a maiores detalhes) pode ser visto o quo ecente o cache de threads atual. a e thread_concurrency No Solaris, mysqld ir chamar thr_setconcurrency() com este a valor. thdr_setconcurrency() permite que a aplicao fornea ao sistema de threads ca c uma dica com o nmero desejado de threads que devem ser executados ao mesmo u tempo. thread_stack O tamanho da pilha para cada thread. Vrios dos limites detectados a pelo teste crash-me so dependentes deste valor. O padro grande o suciente para a a e operaes normais. Veja Seo 5.1.4 [Benchmarks do MySQL], Pgina 421. co ca a timezone O fuzo horrio para este servidor. a tmp_table_size Se uma tabela temporria em memria exceder este tamanho, o a o MySQL ir a convert-la automaticamente para uma tabela MyISAM em disco. Aua e mente o valor de tmp_table_size se voc zer vrias consultas GROUP BY avanadas e e a c voc tiver muita memria. e o tmpdir O diretrio utilizado para arquivos temporrios e tabelas temporrias. A partir o a a do MySQL 4.1, ele pode ser denido com uma lista de caminhos separados por dois pontos (:) (ponto e v irgula (; no Windows). Eles sero usados de modo robin-round. a Este recurso pode ser usado para dividir a craga entre diversos discos f isicos. transaction_alloc_block_size Tamanho dos blocos de alocao de memria que so ca o a alocados para consultas de armazenamento que so parte de uma transao que est a ca a para ser armazenada no log binrio ao se fazer um commit. a transaction_prealloc_block_size Buer persistente para transaction_alloc_ blocks que no liberado entre as consultas. Tornando-o grande o suciente para a e caber todas as consulta em uma transao comum voc pode evitar muitas chamadas ca e malloc. version O nmero da verso do servidor. u a

320

MySQL Technical Reference for Version 5.0.0-alpha

wait_timeout O nmero de segundos que o servidor espera pela atividade em uma u conexo antes de fech-la. Veja tambm interactive_timeout. a a e Na inicializao da thread, SESSION.WAIT_TIMEOUT inicializado por GLOBAL.WAIT_ ca e TIMEOUT ou GLOBAL.INTERACTIVE_TIMEOUT dependendo do tipo do cliente (como denido pela opo de conexo CLIENT_INTERACTIVE). ca a Veja tambm e interactive_timeout. A seo do manual que descreve o ajuste do MySQL contm algumas informaes de como ca e co sintonizar as variveis acima. Veja Seo 5.5.2 [Parmetros do servidor], Pgina 454. a ca a a

4.6.8.5 SHOW [BDB] LOGS

SHOW LOGS exibe estat isticas sobre os arquivos log existentes. Atualmente ele s exibe ino formaes sobre arquivos de log Berkeley DB, assim um alias para ele (dispon a partir co ivel do MySQL 4.1.1) SHOW BDB LOGS. e File exibe o caminho completo para o arquivo de log Type exibe o tipo do arquivo log (BDB para arquivos de log Berkeley DB). Status exibe o status do arquivo log (FREE se o arquivo pode ser removido, ou IN USE se o arquivo necessrio para o subsistema de transaes) e a co

4.6.8.6 SHOW PROCESSLIST

SHOW [FULL] PROCESSLIST exibe quais threads esto em execuo. Esta informao tambm a ca ca e pode ser obtida com o comando mysqladmin processlist. Se voc possuir o privilgio e e SUPER, poder ver todas as threads. Seno s poss a a o e ivel ver as prprias threads. Veja o Seo 4.6.7 [KILL], Pgina 301. Se voc no utiliza a opo FULL, ento somente os primeiros ca a e a ca a 100 caracteres de cada query serio exibidos. a A partir da verso 4.0.12, o MySQL informa o nome de maquina para conexes TCP/IP a o no formato nome_maquina:client_port para tornar mais fcil de se encontrar qual cliente a est fazendo o que. a Este comando muito util caso voc obtenha a mensagem de erro too many connections e e e deseja saber o que est ocorrendo. O MySQL reserva uma conexo extra por cliente a a com o privilgio SUPER para garantir que voc sempre consiga logar e conferir o sistema e e (assumindo que este privilgio no foi concedido para todos os usurios). e a a Alguns estados normalmente vistos em mysqladmin processlist Checking table A thread est realizando vericao [automtica] da tabela. a ca a Closing tables Signiica que a thread est descarregando os dados alterados na tabela a para o disco e fechando as tabelas usadas. Isto deve ser uma operao rpida. Se no, ca a a voc deve vericar se o seu disco no est cheio ou que o disco no est com sobrecarga. e a a a a Connect Out Slave est conectando ao master. a Copying to tmp table on disk O resultado temporrio foi maior que tmp_table_size a e a thread agora est alterando a tabela temporria na memria para o disco para a a o economizar memria. o Creating tmp table A thread est criando uma tabela temporria para guardar uma a a parte do resultado para a consulta.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

321

deleting from main table Ao executar a primeira parte de um delete multi-tabela e estamos deletando apenas da primeira tabela. deleting from reference tables Ao executar a segunda parte de um delete multitabela e estamos deletando o registros correspondentes em outras tabelas. Flushing tables A thread est executando FLUSH TABLES e est esperando que todas a a as threads fechem as suas tabelas. Killed Algum enviou um sinal para matar a thread e ela deve abortar a prxima vez e o que ele vericar o parmetro kill. O parmetro vericado em cada loop maior no a a e MySQL, mas em alguns casos ainda pode levar um tempo curto para a thread morrer. Se a thread est bloqueada par outra thread, a nalizao ter efeito assim que as a ca a outras threads liberarem o bloqueio. Sending data A thread est processando registros para uma instruo SELECT e a ca tambm est enviando dados ao cliente. e a Sorting for group A thread est fazendo uma ordenao para satisfazer a um GROUP a ca BY. Sorting for order A thread est fazendo uma ordenao para satisfazer a um ORDER a ca BY. Opening tables Isto simplesmente signica que a thread est tentando abrir uma a tabela. Este deve ser um procedimento muito rpido, a menos que algo previna da a abertura. Por exemplo um ALTER TABLE ou um LOCK TABLE pode prvenir a abertura de uma tabela at que o comando esteja nalizado. e Removing duplicates A consulta estava usando SELECT DISTINCT de tal modo que o MySQL no podia otimizar o distinct em um estagio anterior. Por isto o MySQL fez a um estgio extra para remover todos os registros duplicados antes de enviar o resultado a ao cliente. Reopen table A thread obteve um lock para a tabela, mas noticou aps o lock que a o estrutura da tabela alterou. Ela liberou o lock, fechou a tabela e agora est tentando a reabr i-la. Repair by sorting O cdigo de reparao est utilizando ordenamento para recriar os o ca a indices. Repair with keycache O cdigo de reparao est usando a criao de chaves uma a o ca a ca uma atravs da cache de chaves. Isto muito mais lento que Repair by sorting. e e Searching rows for update A thread esta fazendo uma primeira fase pra encontrar todos os registros coincidentes antes de atualiz-los. Isto deve ser feito se o UPDATE a est alterando o indice usado para encontrar os registros envolvidos. a Sleeping A thread est esperando que o cliente envie um novo comando a ela. a System lock A thread est esperando um lock de sistema externo para a tabela. Se a voc no est usando mltiplos servidores mysqld que esto acessando a mesma tabela, e a a u a voc pode desabilitar o lock de sistema com a opo --skip-external-locking. e ca Upgrading lock O manipulador de INSERT DELAYED est tentando obter um lock para a inserir registros na tabela. Updating A thread est procurando por registros para atualiz-los. a a User Lock A thread est esperando um GET_LOCK(). a

322

MySQL Technical Reference for Version 5.0.0-alpha

Waiting for tables A thread recebeu uma noticao que a estrutura de uma tabela ca foi alterada e ela precisa reabrir a tabela para receber a nova estrutura. Para poder reabrir a tabela ela deve esperar at que todas a outras threads tenham fechado a e tabela em questo. a A noticao acontece se outra thread usou FLUSH TABLES ou um dos seguintes ca comando na tabela em questo: FLUSH TABLES nome_tabela, ALTER TABLE, RENAME a TABLE, REPAIR TABLE, ANALYZE TABLE ou OPTIMIZE TABLE. waiting for handler insert O manipulador do INSERT DELAYED processou todas as inseres e est esperado por outras. co a A maioria dos estados so operaes muito rpidas. Se a thread permanecer em qualquer a co a destes estados por muitos segundos, pode haver um problema que precisa ser investigado. Existem outros estados que no so mencionados anteriormente, mas a maioia deles s so a a o a uteis para encontrar erros no mysqld.

4.6.8.7 SHOW GRANTS

SHOW GRANTS FOR usurio lista os comandos concedidos que devem ser usados para duplicar a os direitos de um usurio. a mysql> SHOW GRANTS FOR root@localhost; +---------------------------------------------------------------------+ | Grants for root@localhost | +---------------------------------------------------------------------+ | GRANT ALL PRIVILEGES ON *.* TO root@localhost WITH GRANT OPTION | +---------------------------------------------------------------------+ Para listar as permisses da sesso atual pode-se usar a funo CURRENT_USER() (nova na o a ca verso 4.0.6) para descobrir com qual usurio a sesso foi autenticada. Veja Seo 6.3.6.2 a a a ca [CURRENT_USER()], Pgina 547. a

4.6.8.8 SHOW CREATE TABLE

Exibe uma instruo CREATE TABLE que ir criar a seguinte tabela: ca a mysql> SHOW CREATE TABLE t\G *************************** 1. row *************************** Table: t Create Table: CREATE TABLE t ( id INT(11) default NULL auto_increment, s char(60) default NULL, PRIMARY KEY (id) ) TYPE=MyISAM SHOW CREATE TABLE cita os nomes de colunas e tabelas de acordo com o valor da opo ca SQL_QUOTE_SHOW_CREATE. Seo 5.5.6 [SET OPTION SQL_QUOTE_SHOW_CREATE], Pgina 460. ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

323

4.6.8.9 SHOW WARNINGS | ERRORS

SHOW WARNINGS [LIMIT row_count] SHOW ERRORS [LIMIT row_count] Este comando implementado no MySQL 4.1.0. e Ele mostra os erros,a visos e notas recebidos para o ultimo comando. Os erros/avisos so a reiniciados para cada comando que utiliza uma tabela. O servidor MySQL envia de volta o nmero total de avisos e erros que voc recebe para o u e ultimo comando; Isto pode ser retornado chamando mysql_warning_count(). At as mensagens max_error_count so armazenadas (variveis global e espec e a a icas da thread). Voc pode recuperar o nmero de erros de @error_count e avisos de @warning_count. e u SHOW WARNINGS mostra todos os erros, avisos e notas que voc recebeu para o ultimo coe mando enquanto SHOW ERRORS lhe mostra apenas o erro. mysql> DROP TABLE IF EXISTS no_such_table; mysql> SHOW WARNINGS; +-------+------+-------------------------------+ | Level | Code | Message | +-------+------+-------------------------------+ | Note | 1051 | Unknown table no_such_table | +-------+------+-------------------------------+ Note que no MySQL 4.1.0 apenas adicionamos a estrutura para avisos e poucos comandos MySQL ainda geraram avisos. A verso 4.1.1 suporta todos os tipos de avisos para LOAD a DATA INFILE e instrues DML tais como os comandos INSERT, UPDATE e ALTER. co Por exemplo, aqui est um caso simple que produz avisos de converso para instrues de a a co insero. ca mysql> create table t1(a tinyint NOT NULL, b char(4)); Query OK, 0 rows affected (0.00 sec) mysql> insert into t1 values(10,mysql),(NULL,test),(300,open source); Query OK, 3 rows affected, 4 warnings (0.15 sec) Records: 3 Duplicates: 0 Warnings: 4 mysql> show warnings; +---------+------+---------------------------------------------------------------+ | Level | Code | Message | +---------+------+---------------------------------------------------------------+ | Warning | 1263 | Data truncated for column b at row 1 | | Warning | 1261 | Data truncated, NULL supplied to NOT NULL column a at row 2 | | Warning | 1262 | Data truncated, out of range for column a at row 3 | | Warning | 1263 | Data truncated for column b at row 3 | +---------+------+---------------------------------------------------------------+ 4 rows in set (0.00 sec)

324

MySQL Technical Reference for Version 5.0.0-alpha

O nmero mximo de avisos pode ser espec u a icado usando a varivel do servidor max_ a error_count, SET max_error_count=[count]; Por padro 64. No caso de avisos desabila e itados, simplesmente zere esta varivel. No caso de max_error_count ser 0, ento o contaa a dor de avisos ainda representa quantos avisos ocorreram, mas nenhuma das mensagens so a armazenadas. Por exemplo, considere o seguinte instruo de tabela ALTER para o exemplo acima, o ca qual retorna apenas um mensagem de aviso embora o total de avisos seja 3, ao denir max error count=1. mysql> show variables like max_error_count; +-----------------+-------+ | Variable_name | Value | +-----------------+-------+ | max_error_count | 64 | +-----------------+-------+ 1 row in set (0.00 sec) mysql> set max_error_count=1; Query OK, 0 rows affected (0.00 sec) mysql> alter table t1 modify b char; Query OK, 3 rows affected, 3 warnings (0.00 sec) Records: 3 Duplicates: 0 Warnings: 3 mysql> show warnings; +---------+------+----------------------------------------+ | Level | Code | Message | +---------+------+----------------------------------------+ | Warning | 1263 | Data truncated for column b at row 1 | +---------+------+----------------------------------------+ 1 row in set (0.00 sec) mysql>

4.6.8.10 SHOW TABLE TYPES

SHOW TABLE TYPES Este comando implementado no MySQL 4.1.0. e SHOW TABLE TYPES lhe mostra a informao de status sobre o tipo de tabela. Isto particca e ulamente util para vericar se um tipo de tabela suportado; ou para ver qual o tipo de e e tabela padro. a mysql> SHOW TABLE TYPES; +--------+---------+-----------------------------------------------------------+ | Type | Support | Comment | +--------+---------+-----------------------------------------------------------+ | MyISAM | DEFAULT | Default type from 3.23 with great performance |

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

325

| HEAP | YES | Hash based, stored in memory, useful for temporary tables | | MERGE | YES | Collection of identical MyISAM tables | | ISAM | YES | Obsolete table type; Is replaced by MyISAM | | InnoDB | YES | Supports transactions, row-level locking and foreign keys | | BDB | NO | Supports transactions and page-level locking | +--------+---------+-----------------------------------------------------------+ 6 rows in set (0.00 sec) A opo Support DEFAULT indica se um tipo de tabela particular suportado, e qual o ca ee e tipo padro. Se o servidor iniciado com --default-table-type=InnoDB, ento o campo a e a Support do InnoDB ter o valor DEFAULT. a

4.6.8.11 SHOW PRIVILEGES

SHOW PRIVILEGES Este comando implementado no MySQL 4.1.0. e SHOW PRIVILEGES mostra a lista de privilgios de sistema o servidor MySQL suporta. e mysql> show privileges; +------------+--------------------------+------------------------------------------| Privilege | Context | Comment +------------+--------------------------+------------------------------------------| Select | Tables | To retrieve rows from table | Insert | Tables | To insert data into tables | Update | Tables | To update existing rows | Delete | Tables | To delete existing rows | Index | Tables | To create or drop indexes | Alter | Tables | To alter the table | Create | Databases,Tables,Indexes | To create new databases and tables | Drop | Databases,Tables | To drop databases and tables | Grant | Databases,Tables | To give to other users those privileges yo | References | Databases,Tables | To have references on tables | Reload | Server Admin | To reload or refresh tables, logs and priv | Shutdown | Server Admin | To shutdown the server | Process | Server Admin | To view the plain text of currently execut | File | File access on server | To read and write files on the server +------------+--------------------------+------------------------------------------14 rows in set (0.00 sec)

4.7 Localizao do MySQL e Utilizao Internacional ca ca

4.7.1 O Conjunto de Caracteres Utilizado para Dados e Ordenao ca
Por padro, o MySQL utiliza o conjunto de caracteres ISO-8859-1 (Latin1) com ordenao a ca de acordo com o sueco/nlands. Este tambm o conjunto de caracteres aplicvel nos e e e a EUA e oeste da Europa.

326

MySQL Technical Reference for Version 5.0.0-alpha

Todos os binrios padres do MySQL so compilados com --with-extraa o a charsets=complex. Isto adicionar cdigo a todos os programas padres para estarem a o o aptos a lidar com o conjuntos de caracteres latin1 e todos os multi-byte no binrio. a Outros conjuntos de caracteres sero carregados de um arquivo de denies de conjuntos a co de caracteres quando necessrios. a O conjunto de caracteres determina quais so os caracteres permitidos em nomes e qual a a forma de ordenao por clusulas ORDER BY e GROUP BY da instruo SELECT. ca a ca Voc pode alterar o conjunto de caracteres com a opo --default-character-set e ca na inicializao do servidor. Os conjuntos de caracteres dispon ca iveis dependem dos parmetros --with-charset=charset e --with-extra-charset= list-of-charset | a complex | all | none e os arquivos de conguraes de conjuntos de caracteres listados co em SHAREDIR/charsets/ Index. Veja Seo 2.3.3 [Opes de conguraes], Pgina 98. ca co co a Se o conjunto de caracteres for alterado durante a execuo do MySQL (que tambm pode alca e terar a ordenao), deve-se executar o 0myisamchk -r -q --set-character-set=charset ca em todas as tabelas. De outra forma seus indices podem no ser ordenados corretamente. a Quando um cliente conecta a um servidor MySQL, o servidor envia o conjunto de caracteres padro em uso ao cliente. O cliente ir alternar para o uso deste conjunto de caracteres a a nesta conexo. a Deve ser utilizado mysql_real_escape_string() quando desejar ignorar seguncias de e caracteres em uma consulta SQL. mysql_real_escape_string() identico ` antiga funo e a ca mysql_espace_string(), exceto pelo fato de usar a manipulador de conexo MySQL como a o primeiro parmetro. a Se o cliente for compilado com o caminho diferente daquele onde o servidor est instalado e a o usurio que congurou o MySQL no incluiu todos os conjuntos de caracteres no binrios a a a do MySQL, deve ser especicado para o cliente onde ele pode encontrar os conjuntos de caracteres adcicionais que sero necessrios se o servidor executar com um conjunto de a a caracteres diferente do cliente. Isto pode ser especicado colocando em um arquivo de opes do MySQL: co [client] character-sets-dir=/usr/local/mysql/share/mysql/charsets onde o caminho aponta para onde os conjuntos de caracteres dinmicos do MySQL so a a armazenados. Pode-se forar o cliente a usar conjuntos de caracteres espec c icos especicando: [client] default-character-set=nome-conjunto-caracteres mas normalmente isto nunca ser necessrio. a a

4.7.1.1 German character set

Para se fazer ordenao em Alemo, voc deve iniciar o mysqld com --default-characterca a e set=latin1_de. Isto lhe dar as seguintes caracteristicas. a Ao ordenar e comparar strings, o seguinte mapeamento feito na string antes de fazer a e comparao: ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

327

a -> ae o -> oe u -> ue -> ss Todos os caracteres acentuados, so convertidos para suas contra partes sem acentos e em a letras maisculas. Todas as letras so convertidas para maisculas. u a u Ao compara strings com LIKE o mapeamento de caracteres de um -> dois no feito. Todas a e as letras so convertidas para maisculas. Acentos so removidos para todas as letras a u a exceto: , , , , e . U u O o A a

4.7.2 Mensagens de Erros em Outras L inguas

mysqld pode exibir mensagens de erros nas seguintes l inguas: Tcheco, Dinamarqus, e Holands, Ingls (padro), Estonian, Francs, Alemo, Grego, Hngaro, Italiano, Japons, e e a e a u e Koreano, Noruegus, Noruegus-ny, Polons, Portugus, Romeno, Russo, Eslovaco, e e e e Espanhol e Sueco. Para iniciar o mysqld com uma l ingua particular, use uma das opes: --language=lngua co i ou -L lngua . Por exemplo: i shell> mysqld --language=swedish ou: shell> mysqld --language=/usr/local/share/swedish Perceba que todos as l inguas so especicados em minsculas. a u Os arquivos de linguagens esto localizados (por padro) em mysql_base_dir /share/LANGUAGE /. a a Para atualizar o arquivo com mensagens de erros, deve-se editar o arquivo errmsg.txt e executar o seguinte comando para gerar o arquivo errmsg.sys: shell> comp_err errmsg.txt errmsg.sys Se voc atualizar o MySQL para uma verso mais nova, lembre-se de repetir as alteraes e a co no novo arquivo errmsg.txt.

4.7.3 Adicionando um Novo Conjunto de Caracteres

Para adicionar outro conjunto de caracteres ao MySQL, utilize o seguinte procedimento. Decida se o conjunto simples ou complexo. Se o conjunto de caracteres no necessitar do e a uso de rotinas especiais de classicao de strings para ordenao e tambm no necessitar ca ca e a de suporte ` caracteres multi-byte, ser simples. Se ele necessitar de alguns destes recursos, a a ser complexo. a Por exemplo, latin1 e danish so conjuntos simples de caracteres enquanto big5 ou czech a so conjuntos de caracteres complexos. a Na seguinte seo, assumimos que voc nomeou seu conjunto de caracteres como MYSET. ca e Para um conjunto de caracteres simples use o seguinte: 1. Adicione MYSET para o nal do arquivo sql/share/charsets/Index Associe um nmero unico ao mesmo. u

328

MySQL Technical Reference for Version 5.0.0-alpha

2. Crie o arquivo sql/share/charsets/MYSET.conf. (O arquivo sql/share/charsets/latin1.conf pode ser utilizado como base para isto). A sintaxe para o arquivo muito simples: e Comentrios iniciam com um caractere # e continuam at o m da linha. a e Palavras so separadas por quantidades arbitrrias de espaos em brancos. a a c Ao denir o conjunto de caracteres, cada palavra deve ser um nmero no formato u hexadecimal O vetor ctype obtm as primeiras 257 palavras. Os vetores to_lower, to_upper e e sort_order obtm, cada um, as 256 palavras seguintes. e Veja Seo 4.7.4 [Vetor de caracteres], Pgina 329. ca a 3. Adicione o nome do conjunto de caracteres `s listas CHARSETS_AVAILABLE e COMPILED_ a CHARSETS no configure.in. 4. Recongure, recompile e teste. Para um conjunto de caracteres complexo faa o seguinte: c 1. Crie o arquivo strings/ctype-MYSET.c na distribuio fonte do MYSQL. ca 2. Adicione MYSET ao nal do arquivo sql/share/charsets/Index. Associe um nmero unico a ele. u 3. Procure por um dos arquivos ctype-*.c existentes para ver o que precisa ser denido, por exemplo strings/ctype-big5.c. Perceba que os vetores no seu arquivo deve ter nomes como ctype_MYSET, to_lower_MYSET e etc. Isto corresponde aos arrays no conjunto simples de caracteres - Seo 4.7.4 [Vetor de caracteres], Pgina 329 - para ca a um conjunto de caracteres complexo. 4. Prximo ao topo do arquivo, coloque um comentrio especial como este: o a /* * This comment is parsed by configure to create ctype.c, * so dont change it unless you know what you are doing. * * .configure. number_MYSET=MYNUMBER * .configure. strxfrm_multiply_MYSET=N * .configure. mbmaxlen_MYSET=N */ O programa configure utiliza este comentrio para incluir o conjunto de caracteres a na biblioteca MySQL automaticamente. As linhas strxfrm multiply e mbmaxlen sero explicadas nas prximas sees. S as a o co o inclua se voc precisar de funes de ordenao de strings ou das funes de conjuntos e co ca co de caracteres multi-byte, respectivamente. 5. Voc deve ento criar algumas das seguintes funes: e a co my_strncoll_MYSET() my_strcoll_MYSET() my_strxfrm_MYSET() my_like_range_MYSET() Veja Seo 4.7.5 [Ordenao de caracteres], Pgina 329. ca ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

329

6. Adicione o nome do conjunto de caracteres `s listas CHARSETS_AVAILABLE e COMPILED_ a CHARSETS no configure.in. 7. Recongure, recompile e teste. O arquivo sql/share/charsets/README fornece algumas instrues a mais. co Se voc desejar ter o seu conjunto de caracteres inclu na distribuio MySQL, envie e ido ca um email com um patch para a lista de email internals do MySQL. Veja Seo 1.7.1.1 ca [Mailing-list], Pgina 33. a

4.7.4 Os Vetores de Denioes de Caracteres c

to_lower[] e to_upper[] so vetores simples que denemm os caracteres minsculos e a u maisculos correspondentes a cada membro do conjunto de caracteres. Por exemplo: to_lower[A] deve conter a to_upper[a] deve conter A sort_order[] um mapa indicando como os caracteres devem ser ordenados para e propsitos de comparao e ordenao. Para vrios conjuntos de caracteres, isto o o ca ca a e mesmo que to_upper[] (que signica ordenar em caso insensitivo). O MySQL ordenar a caracteres baseado no valor de sort_order[caractere]. Para regras mais complicadas de ordenao, veja a discusso sobre ordenao de string abaixo. Veja Seo 4.7.5 [Ordenao ca a ca ca ca de strings], Pgina 329. a ctype[] um vetor com valores binrios, com um elemento para cada caracter. (Note e a que to_lower[], to_upper[] e sort_order[] so indexados pelo valor do caracter, mas o a ctype[] indexado pelo valor do caracter + 1. Este um antigo legado para tratamento e e de EOF.) Pode-se encontrar as seguintes mscaras binrias de denies em m_ctype.h: a a co #define _U 01 /* Maisculo */ #define _L 02 /* Minsculo */ u #define _N 04 /* Numeral (digito) */ #define _S 010 /* Caractere de espao */ c #define _P 020 /* Pontua~o */ ca #define _C 040 /* Caractere de controle */ #define _B 0100 /* Branco */ #define _X 0200 /* Digito heXadecimal */ A entrada ctype[] para cada caracter deve ser a unio dos valores da mscara binria que a a a descrevem o caracter. Por exemplo, A um caracter maisculo (_U) bem como um d e u igito hexadecimal (_X), portanto ctype[A+1] deve conter o valor: _U + _X = 01 + 0200 = 0201

4.7.5 Suporte ` Ordenao de Strings a ca

Se as regras de ordenao para a sua linguagem forem muito complexas para serem tratadas ca com uma simples tabela sort_order[], ser necessrio o uso das funes de ordenao de a a co ca strings.

330

MySQL Technical Reference for Version 5.0.0-alpha

No momento, a melhor documentao sobre isto so os conjuntos de caracteres que j esto ca a a a implementados. Conra os conjuntos de caracteres big5, czech, gbk, sjis e tis160 para exemplos. Voc deve especicar o valor strxfrm_multiply_MYSET=N no comentrio especial no topo e a do arquivo. N deve ser congurado para a razo mxima que as strings podem crescer a a durante my_strxfrm_MYSET (ele deve ser um inteiro positivo).

4.7.6 Suporte ` Caracteres Multi-byte a

Se voc deseja adicionar suporte para novos conjuntos de caracteres que incluem caracteres e multi-byte, voc precisa usar as funes para caracteres multi-byte. e co No momento, a melhor documentao sobre isto so os conjuntos de caracteres que j ca a a esto implementados. Conra os conjuntos de caracteres euc_kr, gb2312, gbk, sjis e ujis a para exemplos. Eles so implementados no arquivo ctype-conj_caracter.c no diretrio a o strings Voc deve especicar o valor mbmaxlen_MYSET=N no comentrio especial no topo do arquivo. e a N deve ser congurado como o tamanho em bytes do maior caracter no conjunto.

4.7.7 Problemas com Conjuntos de Caracteres

Se voc tentar usar um conjunto de caractere que no foi compilado dentro do se binrio, e a a voc pode encontrar aluguns problemas: e Seu programa tem um caminho errado para onde o conjunto de caracter est ara mazenado (Padro /usr/local/mysql/share/mysql/charsets). Isto pode ser cora rigido usando a opo --character-sets-dir para o programa em questo. ca a O conjunto sde caracteres multi-byte e no pode ser carregado dinamicamente. Neste e a caso voc tem que recompilar o programa com o suporte para o conjunto de caracteres. e O conjunto de caracteres dinmica, mas voc no tem um arquivo de congurao e a e a ca para ele. Neste caso voc deve instalar o arquivo congure para o conjunto de caracteres e de uma nova distriibuio do MySQL. ca Seu arquivo Index no contm o nome do conjunto de caracteres. a e ERROR 1105: File /usr/local/share/mysql/charsets/?.conf not found (Errcode: 2) Neste caso voc deve obter um novo arquivo Index ou adicionar o nome do conjunto e de caracters que falta manualmente. Para tabelas MyISAM, voc pode vericifcar o nome e nmero do conjunto de caracteres para e u uma tabela com myisamchk -dvv nome_tabela.

4.8 Utilitrios e Scripts do Lado do Servidor MySQL a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

331

4.8.1 Viso Geral dos Scripts e Utilitrios do Lado Servidor a a

Todos os programas MySQL possuem vrias opes diferentes, entretanto, todo programa a co MySQL fornece uma opo --help que pode ser usada para obter uma descrio completa ca ca das diferentes opes do programa. Por exemplo, experimente mysql --help. co Voc pode sobrepor ignorar as opes padres para todos os programas clientes com um e co o arquivo de opes. Seo 4.1.2 [Arquivo de opes], Pgina 216. co ca co a A lista abaixo descreve brevemente os programas MySQL. myisamchk Utilitrio para descrever, conferir, otimizar e reparar tabelas MySQL. Como o a myisamchk tem muitas funes, eles so descritos em seu prprio cap co a o itulo. Veja Cap ptexi tulo 4 [Administrao do Banco de Dados MySQL], Pgina 207. ca a make_binary_distribution Cria uma edio binria de um MySQL compilado. Isto pode ser enviado por ca a FTP para /pub/mysql/Incoming em support.mysql.com para a convenincia e de outros usurios MySQL. a mysqlbug mysqld O script para relatar erros no MySQL. Este script deve sempre ser utilizado quando for necessrio preencher um relatrio de erros para a lista do MySQL. a o O servidor (daemon) SQL. Deve sempre estar em execuo. ca

mysql_install_db Cria as tabelas de permisses do MySQL com os privilgios padres. Este o e o comando normalmente executado somente na primeira vez quando o MySQL e instalado em um sistema. e

4.8.2 mysqld-safe, o wrapper do mysqld

mysqld_safe a maneira recomendada para iniciar um daemon mysqld no Unix. mysqld_ e safe adiciona alguns recursos de segurana tais como reiniciar o servidor quando um erro c ocorrer e log de informaes de tempo de execuo a um arquivo log. co ca Note: Antes do MySQL 4.0, mysqld_safe chamado safe_mysqld. Para preservar a e compatibilidade com verses anteriores, a distribuio binria do MySQL para algumas o ca a vezes incluir safe_mysqld como um link simblico para mysqld_safe. a o Se voc no utilizar --mysqld=# ou --mysql-version=# o mysqld_safe ir utilizar um e a a executvel chamado mysqld-max se ele existir. Se no, mysqld_safe ir iniciar o mysqld. a a a Isto torna muito fcil utilizar o mysql-max no lugar do mysqld; basta copiar mysqld-max a no mesmo diretrio do mysqld e ele ser utillizado. o a Normalmente o script mysqld_safe nunca deve ser editado, em vez disto, coloque as opes co para o mysqld_safe na seo [mysqld_safe] no arquivo my.cnf. O mysqld_safe ir ler ca a todas as opes das sees [mysqld], [server] e [mysqld_safe] dos arquivos de opes. co co co (Para compatibilidade com verses anteriores, ele tambm l as sees [safe_mysqld].) o e e co Veja Seo 4.1.2 [Arquivo de opes], Pgina 216. ca co a Note que todas as opes na linha de comando para o mysqld_safe so passadas para o co a mysqld. Se voc deseja usar algumas opes no mysqld_safe que o mysqld no suporte, e co a voc deve especic-las no arquivo de opes. e a co

332

MySQL Technical Reference for Version 5.0.0-alpha

A maioria das opes para mysqld_safe so as mesmas que as do mysqld. Veja Seo 4.1.1 co a ca [Opes de linha de comando], Pgina 207. co a mysqld_safe suporta as seguintes opes: co --basedir=caminho --core-file-size=# Tamanho do arquivo core que o mysqld poder criar. Passado para ulimit -c. a --datadir=caminho --defaults-extra-file=caminho --defaults-file=caminho --err-log=caminho --log-error=caminho Gava o log de erro no caminho acima. Pgina 372. a --ledir=caminho Caminho para mysqld --log=caminho --mysqld=vers~o_do_mysqld a Nome da verso do mysqld no diretrio ledir que voc deseja iniciar. a o e --mysqld-version=vers~o a Similar ao --mysqld= mas aqui voc s fornece o suxo para o mysqld. Por e o exemplo, se voc utiliza --mysqld-version=max, o mysqld_safe ir iniciar a e a verso ledir/mysqld-max. Se o argumento para --mysqld-version estiver a vazio, ledir/mysqld ser usado. a --nice=# (adicionado no MySQL 4.0.14) --no-defaults --open-files-limit=# Nmero de arquivos que o mysqld poder abrir. Passado para ulimit -n. u a Perceba que ser necessrio iniciar mysqld_safe como root para isto funcionar a a corretamente! --pid-file=caminho --port=# --socket=caminho --timezone=# Congura a varivel de fuso horrio (TZ) para o valor deste parmetro. a a a --user=# O script mysqld_safe gravvel, portanto ele deve estar apto para iniciar um servidor que e a foi instalado de uma fonte ou uma verso binria do MySQL, mesmo se o servidor estiver a a instalado em localizaes um pouco diferentes. mysqld_safe espera uma destas condies co co ser verdadeira: O servidor e o banco de dados pode ser encontrado relativo ao diretrio de onde o o mysqld_safe foi chamado. mysqld_safe procura dentro de seu diretrio de trabalho o pelos diretrios bin e data (para distribuioes binrias) ou pelos diretrios libexec o c a o

Veja Seo 4.10.1 [Log de erro], ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

333

e var (para distribuies baseadas em cdigo fonte). Esta condio deve ser satisfeita co o ca se voc executar o mysqld_safe a partir do seu diretrio da instalao do MySQL (por e o ca exemplo, /usr/local/mysql para uma distribuio binria). ca a Se o servidor e os bancos de dados no forem encontrados relativos ao diretrio de a o trabalho, mysqld_safe tenta localiz-lo utilizando caminhos absolutos. Localizaes a co t ipicas so /usr/local/libexec e /usr/local/var. As localizaes atuais foram a co determinadas quando a distribuio foi constru da qual vem o mysqld_safe. Eles ca ida dever estar corretas se o MySQL foi instalado na localizao padro. ca a Como o mysqld_safe tentar encontrar o servidor e o banco de dados relativo a seu diretrio a o de trabalho, voc pode instalar uma distribuio binria do MySQL em qualquer lugar, e ca a desde de que o mysqld_safe seja iniciado a partir do diretrio da instalao: o ca shell> cd diretrio_instala~o_mysql o ca shell> bin/mysqld_safe & Se o mysqld_safe falhar, mesmo se invocado a partir do diretrio de instalao do MySQL, o ca voc pode modic-lo para usar o caminho para o mysqld e as opes de caminho que e a co seriam corretas para seu sistema. Perceba que se voc atualizar o MySQL no futuro, sua e verso modicada de mysqld_safe ser sobrescrita, portanto, voc deve fazer uma cpia de a a e o sua verso editada para que voc a possa reinstalar. a e

4.8.3 mysqld_multi, programa para gerenciar m ltiplos servidores u MySQL

mysqld_multi gerencia vrios processos mysqld executando em diferentes sockets UNIX e a portas TCP/IP. O programa ir pesquisar pelos grupos chamados [mysqld#] no my.cnf (ou no arquivo a fornecido no parmetro --config-file=...), onde # pode ser qualquer nmero positivo a u a partir de 1. Este nmero referenciado a seguir como nmero do grupo de opes ou u e u co GNR. Nmeros de grupos distinguem grupos de opes para um outro e so usados como u co a argumentos para mysqld_multi para especicar quais servidores voc deseja iniciar, parar e ou obter status. Opes listadas nestes grupos devem ser a mesma que voc usaria para co e iniciar o mysqld. (veja Seo 2.4.3 [Automatic start], Pgina 118). No entanto, para o ca a mysqld_multi, esteja certo que cada grupo inclui opes de valores tais como a porta, co socket, etc., para ser usado para cada processo mysqld individual. Uso: mysqld_multi [OPC~ES] {start|stop|report} [GNR,GNR,GNR...] O ou mysqld_multi [OPC~ES] {start|stop|report} [GNR-GNR,GNR,GNR-GNR,...] O O GNR acima signica o nmero do grupo. Voc pode iniciar, parar ou relacionar qualquer u e GNR ou vrios deles ao mesmo tempo. (Veja example). A lista dos GNR podem ser a separadas por v irgulas, ou pelo sinal sinal de menos (-), sendo que o ultimo signica que todos os GNRS entre GNR1-GNR2 sero afetados. Sem o argumento GNR todos os grupos a encontrados sero iniciados, parados ou listados. Perceba que voc no deve ter nenhum a e a espao em branco na lista GNR. Qualquer coisa depois de um espao em branco ignorado. c c e mysqld_multi suporta as seguintes opes: co

334

MySQL Technical Reference for Version 5.0.0-alpha

--config-file=... Arquivo de congurao alternativo. NOTA: Isto no ir afetar as prprias ca a a o opes do programa (grupo [mysqld_multi]), mas somente grupos [mysqld#]. co Sem esta opo tudo ser procurado a partir do arquivo my.cnf. ca a --example Fornece um exemplo de um arquivo de congurao. ca --help --log=... Arquivo Log. Deve ser informado o caminho completo e o nome do arquivo log. NOTA: se o arquivo existir, tudo ser anexado. a --mysqladmin=... Binrio mysqladmin a ser usado para o desligamento do servidor. a --mysqld=... Binrio mysqld a ser usado. Lembre-se que voc tambm pode fornecer mysqld_ a e e safe a esta opo. As opes so passadas ao mysqld. Apenas tenha certeza ca co a que o mysqld est localizado na sua varivel de ambiente PATH ou corrija o a a mysqld_safe. --no-log Imprime na sa padro em vez do arquivo log. Por padro o arquivo log ida a a sempre ca ligado. Exibe esta ajuda e sai.

--password=... Senha do usurio para o mysqladmin. a --tcp-ip Conecta ao(s) servidor(es) MySQL atravs de porta TCP/IP no lugar de socket e UNIX. Isto afeta a ao de desligar e relatar. Se um arquivo socket estiver ca faltando, o servidor pode ainda estar executando, mas s pode ser acessado o atravs da porta TCP/IP. Por padro a conexo feita atravs de socket UNIX. e a a e e

--user=... Usurio MySQL para o mysqladmin. a --version Exibe o nmero da verso e sai. u a Algumas notas sobre mysqld_multi: Tenha certeza que o usurio MySQL, que nalizar os servios mysqld (e.g. utilizando o a c mysqladmin) tem a mesma senha e usurio para todos os diretrios de dados acessados a o (para o banco de dados mysql). E tenha certeza que o usurio tem o privilgio a e Shutdown priv ! Se voc possui diversos diretrios de dados e vrios bancos de dados e o a mysql com diferentes senhas para o usurio root do MySQL, voc pode desejar a e criar um usurio comum multi-admin para cada um que utilize a mesma senha (veja a abaixo). Exemplo de como fazer isto: shell> mysql -u root -S /tmp/mysql.sock -psenha_root -e "GRANT SHUTDOWN ON *.* TO multi_admin@localhost IDENTIFIED BY multipass" Veja Se~o 4.3.6 [Privilgios], Pgina 232. ca e a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

335

Voc deve fazer isto para cada servidor mysqld executando em cada diretrio de dados, e o que voc tem (Apenas altere o socket, -S=...) e pid-file muito importante, se voc estiver utilizando mysqld_safe para iniciar e e o mysqld (ex. mysqld=mysqld safe) Todos os mysqld devem ter seus prprios pido file. A vantagem de utilizar o mysqld_safe no lugar de executar diretamente o mysqld que mysqld_safe guarda todos os processos e ir reinici-los, se um processo do e a a mysqld falhar devido a um sinal kill -9, ou similar. (Como um falha de segmentao, que ca nunca pode acontecer com o MySQL.) Por favor note que pode ser necessrio executar o a script mysqld_safe de um lugar espec ico. Isto signica que voc pode ter que alterar e o diretrio atual para um diretrio espec o o ico antes de iniciar o mysqld_multi. Se voc e tiver problemas ao iniciar, por favor veja o script mysqld_safe. Verique especialmente as linhas: -------------------------------------------------------------------------MY_PWD=pwd Check if we are starting this relative (for the binary release) if test -d /data/mysql -a -f ./share/mysql/english/errmsg.sys -a -x ./bin/mysqld -------------------------------------------------------------------------Veja Seo 4.8.2 [mysqld_safe], Pgina 331. O teste acima deve ser bem sucedido, ou ca a voc pode encontrar problemas. e Esteja certo do perigoso de iniciar mltiplos mysqlds no mesmo diretrio de dados. u o Utilize diretrios de dados diferentes, a menos que voc realmente SAIBA o que est o e a fazendo! O arquivo de socket e a porta TCP/IP devem ser diferentes para cada mysqld. O primeiro e quinto grupo mysqld foram intencionalmente deixados de lado no exemplo. Voc pode ter lacunas no arquivo de congurao. Isto lhe permite mais exibilidade. e ca A ordem na qual os mysqlds so iniciados ou desligados depende da ordem em que eles a aparecem no arquivo de congurao. ca Quando voc desejar referenciar a um grupo espec e ico utilizando GNR com este programa, basta utilizar o nmero no m do nome do grupo ([mysqld# <==). u Voc pode desejar utilizar a opo user para o mysqld, mas para isto voc precisa ser e ca e o usurio root quando iniciar o script mysqld_multi. No importa se a opo existe no a a ca arquivo de congurao; voc receber apenas um alerta se voc no for o superusurio ca e a e a a e o mysqlds for iniciado com a SUA conta no Unix. IMPORTANTE: Tenha certeza que o pid-file e o diretrio de dados acess para leitura e escrita (+execuo para o e ivel ca o diretrio) para ESTE usurio UNIX que iniciar o processo mysqld. NAO utilize a o a a conta de root para isto, a menos que voc SAIBA o que est fazendo! e a MAIS IMPORTANTE: Tenha certeza que voc entendeu os signicados das opes que e co so passadas para os mysqlds e porque VOCE PRECISARIA ter processos mysqld a separados. Iniciando mltiplos mysqlds em um diretrio de dados NAO IRA melhorar u o a performance em um sistema baseado em threads.

Veja Seo 4.2 [Servidores mltiplos], Pgina 219. ca u a Este um exemplo do arquivo de congurao para o funcionamento do mysqld_multi. e ca # Este arquivo provavelmente deve estar em seu diretrio home (~/.my.cnf) ou /etc/my o # Version 2.1 by Jani Tolonen

336

MySQL Technical Reference for Version 5.0.0-alpha

[mysqld_multi] mysqld = /usr/local/bin/mysqld_safe mysqladmin = /usr/local/bin/mysqladmin user = multi_admin password = multipass [mysqld2] socket port pid-file datadir language user [mysqld3] socket port pid-file datadir language user [mysqld4] socket port pid-file datadir language user [mysqld6] socket port pid-file datadir language user

= = = = = =

/tmp/mysql.sock2 3307 /usr/local/mysql/var2/hostname.pid2 /usr/local/mysql/var2 /usr/local/share/mysql/english john

= = = = = =

/tmp/mysql.sock3 3308 /usr/local/mysql/var3/hostname.pid3 /usr/local/mysql/var3 /usr/local/share/mysql/swedish monty

= = = = = =

/tmp/mysql.sock4 3309 /usr/local/mysql/var4/hostname.pid4 /usr/local/mysql/var4 /usr/local/share/mysql/estonia tonu

= = = = = =

/tmp/mysql.sock6 3311 /usr/local/mysql/var6/hostname.pid6 /usr/local/mysql/var6 /usr/local/share/mysql/japanese jani

Veja Seo 4.1.2 [Arquivos de opes], Pgina 216. ca co a

4.8.4 myisampack, O Gerador de Tabelas Compactadas de Somente Leitura do MySQL

myisampack usado para compactar tabelas MyISAM, e pack_isam usado para compactar e e tabelas ISAM. Como as tabelas ISAM esto ultrapassadas, ns iremos discutir aqui somente a o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

337

sobre o myisampack, mas tudo dito sobre myisampack tambm pode ser verdadeiro para o e pack_isam. myisampack trabalha compactando cada coluna na tabela separadamente. A informao ca necessria para descompactar colunas lida em memria quando a tabela aberta. Isto a e o e resulta em uma performance muito melhor quando estiver acessando registros individuais, porque voc precisar descompactar somente um registro, no um bloco muito maior do e a a disco como faz o Stacker no MS-DOS. Normalmente, myisampack compacta o arquivo de dados 40%-70%. O MySQL utiliza mapeamento de memria (nmap()) em tabelas compactadas e retorna ao o uso normal de leitura e escrita se nmap() no funcionar. a Por favor, note o seguinte: Depois de comapctada, a tabela somente-leitura. Isto , normalmente, pretendido e e (como quando acessamos tabelas compactadas em um CD). Permitir que se faa c gravao em uma tabela compactada tambm est em nossa lista TODO, mas com ca e a baixa prioridade. myisampack tambm pode compactar colunas BLOB ou TEXT. O antigo pack_isam (para e tabelas ISAM) no pode fazer isto. a myisampack chamado desta forma: e shell> myisampack [op~es] nome_arquivo ... co Cada nome arquivo deve ter o nome de um arquivo de indice (.MYI). Se voc no se e a encontra em um diretrio de bancos de dados, voc deve especicar o caminho completo o e para o arquivo. Pode-se omitir a extenso .MYI. a myisampack suporta as seguintes opes: co -b, --backup Realiza um backup da tabela como nome_tabela.OLD. -#, --debug=debug_options Log da sa ida de depurao. ca d:t:o,nome_arquivo. A string debug_options geralmante e

-f, --force Fora a compactao da tabela mesmo se ela se tornar maior ou se o c ca arquivo temporrio existir. a myisampack cria um arquivo temporrio a chamado nome_tabela.TMD enquanto ele compacta a tabela. Se voc e matar o myisampack o arquivo .TMD no pode ser removido. Normalmente, a myisampack sai com um erro se ele descobrir que nome_tabela.TMD existe. Com --force, myisampack compacta a tabela de qualquer maneira. -?, --help Exibe uma mensagem de ajuda e sai. -j nome_tabela_grande, --join=nome_tabela_grande Une todas as tabelas nomeadas na linha de comando em uma unica tabela nome_ tabela_grande. Todas tabelas que forem combinadas DEVEM ser idnticas e (mesmos nomes de colunas e tipos, alguns indices, etc.).

338

MySQL Technical Reference for Version 5.0.0-alpha

-p #, --packlength=# Especica o comprimento do tamanho de armazenamento, em bytes. O valor deve ser 1, 2 ou 3. (myisampack armazena todas as linhas com ponteiros de tamanhos 1, 2 ou 3 bytes. Na maioria dos casos normais, myisampack pode determinar o valor correto do tamanho antes de comear a compactar o arquivo, c mas ele pode noticar durante o processo de compactao que ele pode ter usado ca um tamanho menor. Neste caso myisampack ir exibir uma nota dizendo que a a prxima vez que voc compactar o mesmo arquivo voc pode utilizar um o e e registro de tamanho menor.) -s, --silent Modo silencioso. Escreve a sa somente quando algum erro ocorrer. ida -t, --test No compacta realmente a tabela, apenas testa a sua compactao. a ca -T dir_name, --tmp_dir=dir_name Utiliza o diretrio especicado como a localizao em que sero gravadas as o ca a tabelas temporrias. a -v, --verbose Modo verbose. Escreve informao sobre o prograsso e resultado da comca pactao. ca -V, --version Exibe informao de verso e sai. ca a -w, --wait Espera e tenta novamente se a tabela estiver em uso. Se o servidor mysqld foi iniciado com a opo --skip-locking, no uma boa idia chamar myisampack ca a e e se a tabela puder ser atualizada durante o processo de compactao. ca A seqncia de comandos mostrados abaixo ilustra uma t ue ipica seo de compactao de ca ca tabelas: shell> ls -l station.* -rw-rw-r-1 monty my 994128 Apr 17 19:00 station.MYD -rw-rw-r-1 monty my 53248 Apr 17 19:00 station.MYI -rw-rw-r-1 monty my 5767 Apr 17 19:00 station.frm shell> myisamchk -dvv station MyISAM file: station Isam-version: 2 Creation time: 1996-03-13 10:08:58 Recover time: 1997-02-02 3:06:43 Data records: 1192 Deleted blocks: 0 Datafile: Parts: 1192 Deleted data: 0 Datafile pointer (bytes): 2 Keyfile pointer (bytes): 2 Max datafile length: 54657023 Max keyfile length: 33554431 Recordlength: 834 Record format: Fixed length

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

339

table description: Key Start Len Index Type 1 2 4 unique unsigned long 2 32 30 multip. text Field 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 Start 1 2 6 10 11 31 32 62 97 132 167 171 187 222 226 242 262 282 302 332 336 340 341 349 357 365 367 369 373 377 378 380 388 392 396 400 404 405 409 413 Length Type 1 4 4 1 20 1 30 35 35 35 4 16 35 4 16 20 20 20 30 4 4 1 8 8 8 2 2 4 4 1 2 8 4 4 4 4 1 4 4 4

Root 1024 10240

Blocksize 1024 1024

Rec/key 1 1

340

MySQL Technical Reference for Version 5.0.0-alpha

41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57

417 421 425 429 449 479 480 481 560 639 718 797 805 806 807 827 831

4 4 4 20 30 1 1 79 79 79 79 8 1 1 20 4 4

shell> myisampack station.MYI Compressing station.MYI: (1192 records) - Calculating statistics normal: 20 empty-space: 16 pre-space: 0 end-space: 12 Original trees: 57 After join: 17 - Compressing file 87.14% shell> ls -l -rw-rw-r--rw-rw-r--rw-rw-r-station.* 1 monty 1 monty 1 monty empty-zero: table-lookups: 12 5 empty-fill: zero: 11 7

my my my

127874 Apr 17 19:00 station.MYD 55296 Apr 17 19:04 station.MYI 5767 Apr 17 19:00 station.frm

shell> myisamchk -dvv station MyISAM file: station Isam-version: 2 Creation time: 1996-03-13 10:08:58 Recover time: 1997-04-17 19:04:26 Data records: 1192 Deleted blocks: 0 Datafile: Parts: 1192 Deleted data: 0 Datafilepointer (bytes): 3 Keyfile pointer (bytes): 1 Max datafile length: 16777215 Max keyfile length: 131071 Recordlength: 834 Record format: Compressed table description:

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

341

Key Start Len Index Type 1 2 4 unique unsigned long 2 32 30 multip. text Field 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 Start 1 2 6 10 11 31 32 62 97 132 167 171 187 222 226 242 262 282 302 332 336 340 341 349 357 365 367 369 373 377 378 380 388 392 396 400 404 405 409 413 417 421 Length 1 4 4 1 20 1 30 35 35 35 4 16 35 4 16 20 20 20 30 4 4 1 8 8 8 2 2 4 4 1 2 8 4 4 4 4 1 4 4 4 4 4 Type constant zerofill(1) no zeros, zerofill(1) table-lookup no endspace, no endspace, no empty no endspace, zerofill(1) no endspace, no endspace, zerofill(1) no endspace, no endspace, no endspace, no endspace, no endspace, always zero always zero table-lookup table-lookup always zero no zeros, zerofill(1) no zeros, zerofill(1) table-lookup no zeros, zerofill(1) no zeros always zero table-lookup no zeros, zerofill(1) no zeros, zerofill(1) no zeros always zero no zeros always zero no zeros not_always not_always, no not_always, no not_always, no not_always, no not_always, no not_always no empty no empty no empty

Root 10240 54272

Blocksize 1024 1024 Bits 0 9 9 9 0 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 0 0 9 9 9 9 0 9 9 9 9 0 9 9 9 9 9 9 9 9

Rec/key 1 1

Huff tree 1 2 2 3 4 3 5 empty 6 7 empty 6 2 empty 5 empty 6 2 empty 5 8 8 5 6 2 2 3 9 10 2 2 2 2 11 3 2 2 2 12 13 2 2 2 2 2 2 2

342

MySQL Technical Reference for Version 5.0.0-alpha

43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 normal

425 429 449 479 480 481 560 639 718 797 805 806 807 827 831

4 20 30 1 1 79 79 79 79 8 1 1 20 4 4

always zero no empty no empty

no no no no no

endspace, no empty empty empty endspace empty

no empty no zeros, zerofill(2) no zeros, zerofill(1)

2 3 3 14 14 15 2 2 16 2 17 3 3 2 2

9 9 9 4 4 9 9 9 9 9 1 9 9 9 9

A informao exibida pelo myisampack descrita abaixo: ca e O nmero de colunas para qual nenhum empacotamento extra utilizado. u e

empty-space O nmero de colunas contendo valores que so somente espaos; estes ocuparo u a c a apenas 1 bit. empty-zero O nmero de colunas contendo valores que so somente 0s binrios; ocuparo u a a a 1 bit. empty-fill O nmero de colunas inteiras que no ocupam a faixa completa de bytes de u a seu tipo; estes so alteradas para um tipo menor (por exemplo, uma coluna a INTEGER pode ser alterada para MEDIUMINT). pre-space O nmero de colunas decimais que so armazenadas com espaos a esquerda. u a c Neste caso, cada valor ir conter uma contagem para o nmero de espaos. a u c end-space O nmero de colunas que tem muitos espaos espaos extras. Neste caso, cada u c c valor conter uma contagem para o nmero de espaos sobrando. a u c table-lookup A coluna tem somente um pequeno nmero de valores diferentes, que so conu a vertidos para um ENUM antes da compresso Human. a zero O nmero de colunas em que todos os valores esto zerados. u a

Original trees O nmero inicial de rvores Human. u a After join O nmero de rvores Human distintas que sobram depois de unir rvores para u a a poupar espao de cabealho. c c

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

343

Depois que uma tabela foi compactada, myisamchk -dvv exibe informaes adicionais sobre co cada campo: Type O tipo de campo deve conter as seguites descries: co constant Todas linhas tem o mesmo valor. no endspace No armazena espaos no m. a c no endspace, not_always No armazena espaos no m e no faz compactao de espaos a c a ca c nais para todos os valores. no endspace, no empty No armazena espaos no m. No armazena valores vazios. a c a table-lookup A coluna foi convertida para um ENUM. zerofill(n) Os n bytes mais signicativos no valor so sempre 0 e no so a a a armazenados. no zeros No armazena zeros. a always zero Valores zero so armazenados em 1 bit. a Huff tree A rvore Human associada com o campo. a Bits O nmero de bits usado na rvore Human. u a

Depois de ter executado pack_isam/myisampack voc deve executar o isamchk/myisamchk e para recriar o indice. Neste momento voc pode tambm ordenar os blocos de e e indices para criar estat isticas necessrias para o otimizador do MySQL trabalhar de maneira mais a eciente. myisamchk -rq --analyze --sort-index nome_tabela.MYI isamchk -rq --analyze --sort-index nome_tabela.ISM Depois de instalar a tabela compactada no diretrio de banco de dados MySQL voc deve o e fazer mysqladmin flush-tables para forar o mysqld a iniciar usando a nova tabela. c Se voc desejar descompactar uma tabela compactada, voc pode fazer isto com a opo e e ca --unpack para o isamchk ou myisamchk.

4.8.5 mysqld-max, om servidor mysqld extendido

mysqld-max o servidor MySQL (mysqld) congurado com as seguintes opes de cone co gurao: ca Opo ca with-server-sux=-max with-innodb with-bdb Comentrio a Adiciona um suxo ` string de verso mysqld a a Suporte a tabelas InnoDB Suporte para tabelas Berkeley DB (BDB)

344

MySQL Technical Reference for Version 5.0.0-alpha

CFLAGS=Suporte a links simblicos para Windows o DUSE SYMDIR A opo para habilitar o suporte ao InnoDB necessrio apenas no MySQL 3.23. No ca e a MySQL 4 e acima, o InnoDB j inclu por padro. ae ido a Voc pode encontrar os binrios do MySQL-max em http://www.mysql.com/downloads/mysql-max-4.0.h e a A distribuio binria Windows MySQL 3.23 inclui tanto o binrio mysqld.exe padro ca a a a e o binrio mysqld-max.exe. http://www.mysql.com/downloads/mysql-4.0.html. Veja a Seo 2.1.1 [Instalao no Windows], Pgina 60. ca ca a Note que como o Berkeley DB (BDB) no est dispon para todas plataformas, alguns a a ivel dos binrios Max podem no ter suporte para ela. Voc pode conferir quais tipos de tabelas a a e so suportadas executando a seguinte consulta: a mysql> SHOW VARIABLES LIKE "have_%"; +------------------+----------+ | Variable_name | Value | +------------------+----------+ | have_bdb | NO | | have_crypt | YES | | have_innodb | YES | | have_isam | YES | | have_raid | NO | | have_symlink | DISABLED | | have_openssl | NO | | have_query_cache | YES | +------------------+----------+ O signicado dos valores na segunda coluna so: a Valor Signicado. YES A opo est ativa e utilizada. ca a e NO O MySQL no est compilado com suporte a esta opo. a a ca DISABLED A opo xxx est desabilitada porque o mysqld foi iniciado com --skipca a xxxx ou porque no foi iniciado com todas as opes necessrias para habila co a itar esta opo. Neste caso o arquivo hostname.err deve conter uma razo ca a indicando o porque da opo estar desabilitada. ca NOTA: Para conseguir criar tabelas InnoDB voc DEVE editar suas opes de inicializao e co ca para incluir ao menos a opo innodb_data_file_path. Veja Seo 7.5.2 [InnoDB no ca ca MySQL 3.23], Pgina 643. a Para obter melhor performance para tabelas BDB, voc deve adicionar algumas opes de e co congurao para elas tambm .Veja Seo 7.6.3 [Iniciando BDB], Pgina 699. ca e ca a mysqld_safe tenta iniciar automaticamente qualquer binrio mysqld com o prexo -max. a Isto faz com que seja fcil testar um outro binrio mysqld em uma instalao existente. a a ca Apenas execute o configure com as opes deseejadas e, ento, instale o novo binrio co a a mysqld como mysqld-max no mesmo diretrio onde seu antigo binrio mysqld est. Veja o a a Seo 4.8.2 [mysqld_safe], Pgina 331. ca a No Linux, o RPM mysqld-max utiliza o recurso mysqld_safe j mencionado. (Ele apenas a instala o executvel mysqld-max e o mysqld_safe usar automaticamente este executvel a a a quando o mysqld_safe for reiniciado).

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

345

A tabela a seguir mostra quais tipos de tabelas nossos binrios MySQL-Max incluem: a Sistema Windows/NT AIX 4.3 HP-UX 11.0 Linux-Alpha Linux-Intel Linux-IA-64 Solaris-Intel SolarisSPARC SCO OSR5 UnixWare Mac OS X BDB S N N N S N N S S S N InnoDB S S S S S S S S S S S

Note que a partir do MySQL 4, voc no precisa de um servidos MySQL Max para o InnoDB e a porque ele inclu por padro. e ido a

4.9 Utilitrios e Scripts do Lado do Cliente MySQL a

4.9.1 Viso Geral dos Utilitrios e Scripts do Lado do Cliente a a
Todos clientes MySQL que comunicam com o servidor utilizando a biblioteca mysqlclient utilizam as seguintes variveis de ambiente: a Nome MYSQL_UNIX_PORT MYSQL_TCP_PORT MYSQL_PWD MYSQL_DEBUG TMPDIR Descrio ca O socket padro, utilizado para conexes ao localhost a o A porta TCP/IP padro a A senha padro a Opes de depurao-ratreamento durante depurao co ca ca O diretrio onde tabelas e arquivos temporrios so criados o a a

A utilizao de MYSQL_PWD insegura. Veja Seo 4.3.8 [Connecting], Pgina 238. ca e ca a No Unix, o cliente mysql utiliza o arquivo nomeado na varivel de ambiente MYSQL_ a HISTFILE para salvar o histrico da linha de comando. O valor padro para o arquivo de o a histrico $HOME/.mysql_history, onde $HOME o valor da varivel de ambiente HOME. o e e a Veja Apndice F [Environment variables], Pgina 1092. e a Se voc no quiser manter um arquivo que contenh um registro de suas consultas, primeiro e a remova .mysql_history se ele existir, ento use uma das seguintes tcnicas: a e Dena a varivel MYSQL_HISTFILE para /dev/null. Para que esta congurao tenha a ca efeito a cada vez que voc logar, coloque-a em um dos arquivos de inicializao da sua e ca shell. Crie .mysql_histfile como um link simblico para /dev/null: o shell> ln -s /dev/null $HOME/.mysql_history Voc s precisa de fazer isto uma vez. e o

346

MySQL Technical Reference for Version 5.0.0-alpha

Todos os programas MySQL podem receber vrias opes diferentes. Entretanto, todo a co programa MySQL fornece a opo --help que voc pode utilizar para obter uma descrio ca e ca completa das diferentes opes do programa. Por exemplo, experimente mysql --help co Voc pode sobrepor todas as opes padres para programas cliente padres com um arquivo e co o o de opes. Seo 4.1.2 [Option les], Pgina 216 co ca a A lista abaixo descreve resumidamente os programas MySQL: msql2mysql Um script shell que converte programas mSQL para MySQL. Ele no lida com a todos os casos, mas ele fornece um bom inicio para a converso. a mysql A ferramenta de linha de comando para a entrada de consultas interativamente ou a execuo de consultas a partir de um arquivo no modo batch. Veja ca Seo 4.9.2 [mysql], Pgina 347. ca a Este programa fornece uma interface grca para interagir com o servidor. a server. Veja Seo 4.9.3 [mysqlcc], Pgina 354. ca a

mysqlcc

mysqlaccess Um script que verica os privilgios de acesso para uma combinao de nome e ca de mquina, usurio e banco de dados. a a mysqladmin Utilitrio para realizar operaes administrativas, tais como criao ou remoo a co ca ca de bancos de dados, recarga das tabelas de permisses, descarga de tabelas em o disco e reabertura dos arquivos log. mysqladmin tambm pode ser usado para e exibir informaes de verso, processos e estado do servidor. Veja Seo 4.9.4 co a ca [mysqladmin], Pgina 356. a mysqlbinlog Utilitrio para leitura das consultas de um log binrio. Pode ser usado para a a recuperao de falhas com um backup antigo. Veja Seo 4.9.5 [mysqlbinlog], ca ca Pgina 358. a mysqldump Descarrega um banco de dados MySQL em um arquivo como instrues SQL co ou como arquivo texto separado por tabulao. Verso aprimorada do freeca a ware escrito originalmente por Igor Romanenko. Veja Seo 4.9.7 [mysqldump], ca Pgina 361. a mysqlimport Importa arquivos texto em suas tabelas respectivas utilizando LOAD DATA INFILE. Veja Seo 4.9.9 [mysqlimport], Pgina 367. ca a mysqlshow replace Exibe informaes sobre bancos de dados, tabelas, colunas e co indices. Um programa utilitrio que usado pelo msql2mysql, mas que tambm pode ser a e e aplicvel mais genericamente. replace altera conjuntos de caracteres. Utiliza a uma mquina de estado nito para comparar strings maiores primeiro. Pode a ser usada para trocar conjuntos de caracteres. Por exemplo, este comando troca a e b nos arquivos dados: shell> replace a b b a -- arquivo1 arquivo2 ...

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

347

4.9.2 mysql, A Ferramenta de Linha de Comando

O mysql uma shell SQL simples (com capacidades GNU readline). Ele suporta usos e interativos e no interativos. Quando usado interativamente, os resultados das consultas a so apresentadas no formato de tabela ASCII. Quando no usado interativamente (como a a um ltro por exemplo), o resultado apresentado em um formato separado por tabulaes. e co (O formato de sa pode ser alterado utilizando opes da linha de comando.) Voc pode ida co e executar scripts desta forma: shell> mysql database < script.sql > saida.tab Se voc tiver problemas devido a memria insuciente no cliente, utilize a opo --quick! e o ca Isto fora o mysql a utilizar mysql_use_result() no lugar de mysql_store_result() para c recuperar o conjunto de resultados. Utilizar o mysql muito fci. Inicie-o como mostrado a seguir: mysql banco_de_dados e a ou mysql --user=nome_usurio --password=sua_senha banco_de_dados. Digite uma ina struo SQL, termine-a com ;, \g, ou \G e pressione RETURN/ENTER. ca O mysql Suporta as seguintes opes: co -?, --help Exibe esta ajuda e sai. -A, --no-auto-rehash Sem reprocessamento automtico. O rehash deve ser usado se o usurio desejar a a que o cliente mysql complete as tabelas e campos. Esta opo usada para ca e acelerar a inicializao do cliente. ca --prompt=... Congura o prompt do mysql com o formato especicado. -b, --no-beep Deliga o beep nos erros. -B, --batch Exibe resultados com o caractere de tabulao como o separador, cada registro ca em uma nova linha. No utiliza o arquivo de histrico. a o --character-sets-dir=... Diretrio onde os conjuntos de caracteres esto localizados. o a -C, --compress Utiliza compactao no protocolo cliente/servidor. ca -#, --debug[=...] Log de Depurao. O padro d:t:o,/tmp/mysql.trace. ca a e -D, --database=... Qual banco de dados usar. Isto geralmente util em um arquivo my.cnf. e --default-character-set=... Congura o conjunto de caracters padro. a -e, --execute=... Executa o comando e sai. (Sa parecida com batch) ida

348

MySQL Technical Reference for Version 5.0.0-alpha

-E, --vertical Exibe a sa de uma consulta (linhas) verticalmente. Sem esta opo voc ida ca e tambm pode forar esta sa terminando suas instrues com \G. e c ida co -f, --force Continue mesmo se for obtido um erro SQL. -g, --no-named-commands Comandos nomeados sero desabilitados. Utilize somente a forma \*, ou use a comandos nomeados apenas no comeo da linha terminada com um ponto-ec virgula (;). Desde a verso 10.9, o cliente agora inicia com esta opo habilitada a ca por padro! Com a opo -g, entretando, comandos de formato longo contina ca uaro funcionando na primeira linha. a -G, --enable-named-commands Comandos nomeados so habilitados. Comandos de formato longo so aceitos a a assim como os comandos reduzidos \*. -i, --ignore-space Ignore caractere de espao depois de nomes de funes. c co -h, --host=... Conectar ` mquina especicada. a a -H, --html Produz sa HTML. ida

-X, --xml Produz sa XML. ida -L, --skip-line-numbers No escreve o nmero da linha para os erros. Util quando se deseja comparar a u arquivos com resultados que incluem mensagens de erro. --no-pager Desabilita paginao e impresso na sa padro. Veja tambm a ajuda interca a ida a e ativa (\h). Desabilita arquivo de sa ida. Veja tambm a ajuda interativa (\h). e

--no-tee

-n, --unbuffered Descarrega e atualiza o buer depois de cada pesquisa. -N, --skip-column-names No escrever nomes de colunas nos resultados. a -O, --set-variable nome=op~o ca Fornece um valor a uma varivel. --help lista as variveis. Por favor, note a a que as sintaxes --set-variable=name=value e -O name=value esto obsoletas a desde o MySQL 4.0, use --nome=valor. -o, --one-database Atualiza somente o banco de dados padro. Isto util para evitar atualizao a e ca em outros bancos de dados no log de atualizaes. co

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

349

--pager[=...] Tipo de sa ida. O padro sua varivel de ambiente PAGER. Paginadores vlidos a e a a so: less, more, cat [>nome arquivo], etc. Veja tambm a ajuda interativa (\h). a e Esta opo no funciona no modo batch. A opo pager funciona somente no ca a ca UNIX. -p[password], --password[=...] Senha a ser usada ao conectar ao servidor. Se uma senha no fornecida a e na linha de comando, lhe ser solicitado uma. Perceba que se voc utilizar o a e formato curto -p voc no pode ter um espao entre a opo e a senha. e a c ca -P --port=... Nmero da porta TCP/IP para usar na conexo. u a --protocol=(TCP | SOCKET | PIPE | MEMORY) Especica o protocolo de conexo usado. Novo no MySQL 4.1. a -q, --quick No faz cache do resultado, imprime linha a linha. Isto pode deixar o servidor a mais lento se a sa for suspendida. No usa arquivo de histrico. ida a o -r, --raw Exibe valores de colunas sem converso de escapes. Utilizado com --batch a --reconnect Se a conexo perdida, tentar reconectar ao servidor automaticamente (mas a e apenas uma vez). -s, --silent Opo para ser mais silencioso. ca -S --socket=... Arquivo socket para ser utilizado na conexo. a -t --table Sa no formato de tabela. Isto padro no modo no-batch. ida e a a

-T, --debug-info Exibe alguma informao de depurao na sa ca ca ida. --tee=... Anexa tudo no arquivo de sa ida. Veja tambm a ajuda interativa (\h). No e a funciona no modo batch.

-u, --user=# Usurio para login diferente do usurio atual do sistema. a a -U, --safe-updates[=#], --i-am-a-dummy[=#] Permite somente que UPDATE e DELETE utilizem chaves. Veja abaixo para maiores informaes sobre esta opo. Voc pode zerar esta opo se possui-la co ca e ca no arquivo my.cnf utilizando --safe-updates=0. -v, --verbose Modo verbose (-v -v -v fornece o formato de sa da tabela). ida -V, --version Gera sa com informao de verso e sai. ida ca a

350

MySQL Technical Reference for Version 5.0.0-alpha

-w, --wait

Espera e repete em vez de sair se a conexo estiver inacess a ivel.

Voc tambm pode congurar as seguntes variveis com -O ou --set-variable. Por favor, e e a note que as sintaxes --set-variable=nome=valor e -O name=value esto obsoletas desde a o MySQL 4.0, use --var=option: Nome Varivel a Padro Descrio a ca connect timeout 0 Nmero de seguntos antes de esgotar o tempo da conexo u a local-inle 0 Disabilita (0) ou habilita (1) capacidade LOCAL para LOAD DATA INFILE max allowed packet 16777216Tamanho mximo do pacote para enviar/receber do a servidor net buer length 16384 Tamanho do buer para comunicao TCP/IP e socket ca select limit 1000 Limite automtico para SELECT quando utilizar --safea updtaes max join size 1000000 Limite automtico para registros em uma join quando a utilizar --safe-updtaes. Se o cliente mysql perder a conex`o com o servidor enquanto envia uma consulta, ele tentar a a se reconectar imediatamente e automaticamente uma vez e enviar a consulta novamente. Note que mesmo se ele obter sucesso na reconexo, como sua primeira conexo foi nalizada, a a todas seus objetos da sesso anteriores foram perdidos: tabelas temporrias, e variveis de a a a sesso e de usurio. Desta forma, o comportamento acima pode ser perigoso para voc, a a e como neste exemplo onde o servidor foi desligado e reiniciado sem voc saber: e mysql> set @a=1; Query OK, 0 rows affected (0.05 sec) mysql> insert into t values(@a); ERROR 2006: MySQL server has gone away No connection. Trying to reconnect... Connection id: 1 Current database: test Query OK, 1 row affected (1.30 sec) mysql> select * from t; +------+ | a | +------+ | NULL | +------+ 1 row in set (0.05 sec) A varivel de usurio @a foi perdida com a conexo e depois da reconexo ela indenida. a a a a e Para se proteger deste risco, voc pode iniciar o cliente mysql com a opo --disablee ca reconnect. Se voc digitar help na linha de comando, mysql ir exibir os comandos que ele suporta: e a mysql> help

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

351

Display this text. Synonym for help. Clear command. Reconnect to the server. Optional arguments are db and host. delimiter (\d) Set query delimiter. edit (\e) Edit command with $EDITOR. ego (\G) Send command to mysql server, display result vertically. exit (\q) Exit mysql. Same as quit. go (\g) Send command to mysql server. nopager (\n) Disable pager, print to stdout. notee (\t) Dont write into outfile. pager (\P) Set PAGER [to_pager]. Print the query results via PAGER. print (\p) Print current command. prompt (\R) Change your mysql prompt. quit (\q) Quit mysql. rehash (\#) Rebuild completion hash. source (\.) Execute an SQL script file. Takes a file name as an argument. status (\s) Get status information from the server. system (\!) Execute a system shell command. tee (\T) Set outfile [to_outfile]. Append everything into given outfile. use (\u) Use another database. Takes database name as argument. Os comandos edit, nopager, pager, e system funcionam apenas no Unix. O comando status lhe fornece algumas informaes sobre a conexo e o servidor que est co a a utilizando. Se voc estiver executando no modo --safe-updates, status ir tambm e a e imprimir os valores para as variveis mysql que afetam suas consultas. a Uma opo util para iniciantes (introduzido no MySQL verso 3.23.11) o --safe-updates ca a e (ou --i-am-a-dummy para usurios que uma vez possam ter feito um DELETE FROM nome_ a tabela mas esqueceram da clusula WHERE). Quando utilizar esta opo, o mysql envia o a ca seguinte comando ao servidor MySQL quando abrir a conexo. a SET SQL_SAFE_UPDATES=1,SQL_SELECT_LIMIT=#select_limit#, SQL_MAX_JOIN_SIZE=#max_join_size#" onde #select_limit# e #max_join size# so variveis que podem ser conguradas da a a linha de comando mysql. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca a O efeito da opo acima : ca e Voc no tem permisso de utilizar uma instruo UPDATE ou DELETE se voc no possuir e a a ca e a uma chave na parte WHERE. Pode-se, entretanto, forar um UPDATE/DELETE utilizando c LIMIT:

MySQL commands: help (\h) ? (\h) clear (\c) connect (\r)

352

MySQL Technical Reference for Version 5.0.0-alpha

UPDATE nome_tabela SET campo_nao_chave=# WHERE campo_nao_chave=# LIMIT 1; Todos resultados maiores so limitados automaticamente a #select_limit# linhas. a SELECTs que provavelmente precisaro examinar mais que #max_join_size a combinaoes de linhas sero abortadas. c a Algumas dicas uteis sobre o cliente mysql: Alguns dados so muito mais leg a iveis quando exibido verticalmente, em vez da sa do ida tipo caixa horizontal comum. Por exemplo: Textos longos, que incluem vrias linhas, so a a vertical. muito mais fceis de serem lidos com saida a mysql> SELECT * FROM mails WHERE LENGTH(txt) < 300 lIMIT 300,1\G *************************** 1. row *************************** msg_nro: 3068 date: 2000-03-01 23:29:50 time_zone: +0200 mail_from: Monty reply: monty@no.spam.com mail_to: "Thimble Smith" <tim@no.spam.com> sbj: UTF-8 txt: >>>>> "Thimble" == Thimble Smith writes: Thimble> Hi. I think this is a good idea. Is anyone familiar with UTF-8 Thimble> or Unicode? Otherwise, Ill put this on my TODO list and see what Thimble> happens. Yes, please do that. Regards, Monty file: inbox-jani-1 hash: 190402944 1 row in set (0.09 sec) Para o log, voc pode utilizar a opo tee. O tee pode ser iniciado com a opo --tee=..., e ca ca ou pela linha de comando de maneira interativa com o comando tee. Todos os dados exibidos na tela sero anexados no arquivo fornecido. Isto tambm pode ser muito util para a e propsitos de depurao. O tee pode ser desabilitado da linha de comando com o comando o ca notee. Executando tee novamente o log reiniciado. Sem um parmetro o arquivo anterior e a ser usado. Perceba que tee ir atualizar os resultados dentro do arquivo depois de cada a a comando, pouco antes da linha de comando reaparecer esperando pelo prximo comando. o Navegar ou pesquisar os resultados no modo interativo em algum programa do UNIX como o less, more ou outro similar, agora poss com a opo --pager[=...]. Sem argumento, e ivel ca o cliente mysql ir procurar pela varivel de ambiente PAGER e congurar pager para este a a valor. pager pode ser iniciado a partir da linha de comando interativa com o comando pager e desabilitado com o comando nopager. O comando recebe um argumento opcional e e o pager ser congurado com ele. O comando pager pode ser chamado com um a argumento, mas isto requer que a opo --pager seja usada, ou o pager ser usado com a ca a padro. pager funciona somente no UNIX, uma vez que utilizado a funo popen(), saida a e ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

353

que no existe no Windows. No Windows a opo tee pode ser utilizada, entretanto ela a ca pode no ser cmoda como pager pode ser em algumas situaes. a o co Algumas dicas sobre pager: Voc pode us-lo para gravar em um arquivo: e a mysql> pager cat > /tmp/log.txt e os resultados iro somente para um arquivo. Voc tambm pode passar qualquer a e e opes para os programas que voc deseja utilizar com pager: co e mysql> pager less -n -i -S Note a opo -S exibida acima. Voc pode ach-la muito util quando navegar pelos ca e a a horizontal (nalize os comandos resultados; experimente com a opo com saida ca com \g, ou ;) e com sa vertical (nal dos comandos com \G). Algumas vezes um ida resultado com um conjunto muito largo dif ser lido na tela, com a opo -S para e icil ca less, voc pode navegar nos resultados com o less interativo da esquerda para a e direita, evitando que linhas maiores que sua tela continuem na prxima linha. Isto o pode tornar o conjunto do resultado muito mais leg ivel. voc pode alterar o modo e entre ligado e desligado com o less interativo com -S. Veja o h(help) para mais ajuda sobre o less. Voc pode combinar maneiras muito complexas para lidar com os resultados, por exeme plo, o seguinte enviaria os resultados para dois arquivos em dois diferentes diretrios, o em dois discos diferentes montados em /dr1 e /dr2, e ainda exibe o resultado na tela via less: mysql> pager cat | tee /dr1/tmp/res.txt | \ tee /dr2/tmp/res2.txt | less -n -i -S Voc tambm pode combinar as duas funes acima; tenha o tee habilitado, o pager e e co congurado para less e voc estar apto a navegar nos resultados no less do Unix e ainda e a ter tudo anexado em um arquivo ao mesmo tempo. A diferena entre UNIX tee usado com o c pager e o tee embutido no cliente mysql que o tee embutido funciona mesmo se voc no e e a tiver o comando UNIX tee dispon ivel. O tee embutido tambm loga tudo que exibido na e e tela, e o UNIX tee usado com pager no loga completamente. Por ultimo o tee interativo a mais cmodo para trocar entre os modos on e o, quando voc desejar logar alguma coisa e o e em um arquivo, mas deseja estar apto para desligar o recurso quando necessrio. a alterar o prompt no cliente de linha de comando mysql. A partir da verso 4.0.2 possivel a e Voc pode usar as seguintes opes do prompt: e co Opo ca Descrio ca \v verso mysqld a \d banco de dados em uso \h mquina na qual est conectado a a \p porta na qual est conectado a \u nome do usurio a \U nome usurio@maquina a \\ \ \n nova quebra de linha \t tab \ espao c

354

MySQL Technical Reference for Version 5.0.0-alpha

\ \R \r \m \y \Y \D \s \w

espao c hora no formato 24h (0-23) hora no formato 12h (1-12) minutos ano com dois digitos ano com quatro digitos formato completo da data segundos dia da semana no formato com 3 letras (Mon, Tue, ...) \P am/pm \o ms no formato de nmero e u \O ms no formato com 3 letras (Jan, Feb, ...) e \c contador que cresce a cada comando \ seguido por qualquer outra letra apenas retorna aquela letra. Voc pode denir o prompt nos seguintes lugares: e Varivel de Ambiente a Voc pode congurar o prompt em qualquer arquivo de congurao do MySQL, e ca no grupo mysql. Por exemplo: [mysql] prompt=(\u@\h) [\d]>\_ Linha de Comando Voc pode denir a opo --prompt na linha de comando para mysql. Por e ca exemplo: shell> mysql --prompt="(\u@\h) [\d]> " (usurio@maquina) [banco de dados]> a Interativamente Voc tambm pode usar o comando prompt (ou \R) para alterar o seu prompt e e interativamente. Por exemplo: mysql> prompt (\u@\h) [\d]>\_ PROMPT set to (\u@\h) [\d]>\_ (usuario@maquina) [banco de dados]> (usuario@maquina) [banco de dados]> prompt Returning to default PROMPT of mysql> mysql>

4.9.3 mysqlcc, The MySQL Control Center

mysqlcc, o Centro de Controle do MySQL, um cliente independente de plataforma que e fornece um interface grca ao usurio (GUI) para o servidor de banco de dados MySQL. a a Ela suporta uso interativo, incluindo destaque de sintaxe e complementao com tab. Ele ca fornece gerenciamento de banco de dados e tabelas e permite a administrao do servidor. ca Atualmente, o mysqlcc executa em plataformas Windows e Linux.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

355

mysqlcc no est inclu com a distribuio MySQL, mas pode ser feito o download a a ido ca separadamente em http://www.mysql.com/downloads/. mysqlcc suporta as seguintes opes: co -?, --help Exibe esta ajuda e sai. -b, --blocking_queries Usa consultas em bloco. -C, --compress Usa o protocolo servidor/cliente compactado. -c, --connection_name=name Este um sinnimo para --server. e o -d, --database=... Banco de dados a ser usado. Isto util principalmente no arquivo my.cnf. e -H, --history_size=# Tamanho do histrico para a janiela de consultas. o -h, --host=... Conecta a uma determinda mquina. a -p[password], --password[=...] Senha usada ao se conectar ao servidor. Se uma senha no for especicada a na linha de comando, voc dever inform-la. Note que se voc usar a forma e a a e simplicada -p no permitido um espao entre a opa e a senha. a e c co -g, --plugins_path=name Caminho para o diretrio onde os plugins do MySQL Control Center estao o lacalizados. -P port_num, --port=port_num Nmero da porta TCP/IP para uso na conexo. u a -q, --query Abre uma janela de consulta na inicializao. ca -r, --register Abre a caixa de dilogo Register Server na inicializao. a ca -s, --server=name Nome da conexo do MySQL Control Center. a -S --socket=... Arquivo socket usado na conexo. a -y, --syntax Habilita destque da sintaxe e complementao ca -Y, --syntax_file=name Arquivo de sintaxe para complementao. ca

356

MySQL Technical Reference for Version 5.0.0-alpha

-T, --translations_path=name Caminho para o diretrio onde as tradues do MySQL Control Center esto o co a localizados. -u, --user=# Usurio para login se diferente do usurio atual. a a -V, --version Exibe a verso e sai. a Voc tambm pode congurar as seguntes variveis com -O ou --set-variable. Por favor, e e a note que as sintaxes --set-variable=nome=valor e -O name=value esto obsoletas desde a o MySQL 4.0, use --var=option: Variable Name connect timeout local-inle max allowed packet net buer length select limit max join size Default Description 0 Number of seconds before connection timeout. 0 Disable (0) or enable (1) LOCAL capability for LOAD DATA INFILE 16777216Max packet length to send to/receive from server 16384 Buer for TCP/IP and socket communication 1000 Automatic limit for SELECT when using --safe-updtaes 1000000 Automatic limit for rows in a join when using --safeupdates

4.9.4 mysqladmin, Administrando um Servidor MySQL

Um utilitrio para realizar operaes administrativas. A sintaxe : a co e shell> mysqladmin [OPC~ES] comando [op~o_do_comando] comando... O ca Voc pode obter uma lista das opo que sua verso do mysqladmin suporta executando e ca a mysqladmin --help. O mysqladmin atual suporta os seguintes comandos: create databasename Cria um novo banco de dados. drop databasename Apaga um banco de dados e todas suas tabelas. extended-status Fornece uma mensagem extendida sobre o estado do servidor. flush-hosts Atualiza todos os nomes de mquinas que estiverem no cache. a flush-logs Atualiza todos os logs. flush-tables Atualiza todas as tabelas. flush-privileges Recarrega tabelas de permisses (mesmo que reload). o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

357

kill id,id,... Mata threads do MySQL. password ping Congura uma nova senha. Altera a antiga senha para nova senha. Checa se o mysqld est ativo. a

processlist Exibe lista de threads ativas no servidor, com a instruo SHOW PROCESSLIST. ca Se a opo --verbose passada, a sa ca e ida como aquela de SHOW FULL e PROCESSLIST. reload refresh shutdown Recarrega tabelas de permisso. a Atualiza todas as tabelas e fecha e abre arquivos de log. Desliga o servidor.

slave-start Inicia thread de replicao no slave. ca slave-stop Termina a thread de replicao no slave. ca status variables version Fornece uma mensagem curta sobre o estado do servidor. Exibe variveis dispon a iveis. Obtm informao de verso do servidor. e ca a

Todos comandos podem ser reduzidos para seu prexo unico. Por exemplo: shell> mysqladmin proc stat +----+-------+-----------+----+-------------+------+-------+------+ | Id | User | Host | db | Command | Time | State | Info | +----+-------+-----------+----+-------------+------+-------+------+ | 6 | monty | localhost | | Processlist | 0 | | | +----+-------+-----------+----+-------------+------+-------+------+ Uptime: 10077 Threads: 1 Questions: 9 Slow queries: 0 Opens: 6 Flush tables: 1 Open tables: 2 Memory in use: 1092K Max memory used: 1116K O resultado do comando mysqladmin status possui as seguintes colunas: Uptime Threads Questions Slow queries Opens Flush tables Open tables Nmero de segundos que o servidor MySQL est funciou a nando. Nmero de threads ativas (clientes). u Nmero de solicitaes dos clientes desde que o mysqld u co foi iniciado. Consultas que demoram mais que long_query_time segundos. Veja Seo 4.10.5 [Log de consultas lentas], ca Pgina 377. a Quantas tabelas foram abertas pelo mysqld. Nmero de comandos flush..., refresh e reload. u Nmero de tabelas abertas atualmente. u

358

MySQL Technical Reference for Version 5.0.0-alpha

Memory in use

Memria alocada diretamente pelo cdigo do mysqld o o (dispon somente quando o MySQL compilado com ivel e with-debug=full). Max memory used Memria mxima alocada diretamente pelo cdigo do o a o mysqld (dispon somente quando o MySQL compiivel e lado com with-debug=full). Se voc executa um mysqladmin shutdown em um socket (em outras palavras, em um e computador onde o mysqld est executando), mysqladmin ir esperar at que o arquivoa a e pid do MySQL seja removido para garantir que o servidor mysqld parou corretamente.

4.9.5 mysqlbinlog, Executando as Consultas a Partir de um Log Binrio a

Voc pode examinad o arquivo de log binrio (veja Seo 4.10.4 [Binary log], Pgina 374) e a ca a com o utilitrio mysqlbinlog. a shell> mysqlbinlog hostname-bin.001 exibir todas as consultas contidas no log binrio hostname-bin.001, junto com outras a a informaes (tempo da consulta, ID da thread que a executou, o timestamp de quando foi co executada, etc). Voc pode colocar a sa e ida do mysqlbinlog em um cliente mysql; isto usado para e recuperaes de falhas quando voc tem um backup antigo (veja Seo 4.5.1 [Backup], co e ca Pgina 275): a shell> mysqlbinlog hostname-bin.001 | mysql ou shell> mysqlbinlog hostname-bin.[0-9]* | mysql Voc tambm pode redirecionar a sa do mysqlbinlog para um arquivo texto, ento e e ida a modique este arquivo texto (para excluir as consultas que voc no quer executar por e a alguma razo), e ento execute as consultas a partir do arquivo texto dentro do mysql. a a mysqlbinlog possui a opo position=# que exibir apenas as consultas cujo oset no log ca a binrio maior ou igual a #. a e Se voc tiver mais que um log binrio para executar no servidor MySQL, o mtodo seguro e a e faz-lo em uma unica conexo MySQL. Aqui est o que pode ser INseguro: e e a a shell> mysqlbinlog hostname-bin.001 | mysql # DANGER!! shell> mysqlbinlog hostname-bin.002 | mysql # DANGER!! Isto causar problemas se o primeiro log binrio conter um CREATE TEMPORARY TABLE e o a a segundo contm uma consulta que utiliza esta tabela temporria: quando o primeiro mysql e a termina, ele apara a tabela temporria, assim a o segundo mysql relatar um tabela a a desconhecida. Isto ocorre porque voc deve executar todos os log binrios que voc deseja e a e em uma unica conexo, especialmente se voc usa tabelas temporrias. Aqui esto dois a e a a modos poss iveis: shell> mysqlbinlog hostname-bin.001 hostname-bin.002 | mysql shell> mysqlbinlog hostname-bin.001 > /tmp/queries.sql shell> mysqlbinlog hostname-bin.002 >> /tmp/queries.sql shell> mysql -e "source /tmp/queries.sql"

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

359

A partir do MySQL 4.0.14, mysqlbinlog pode preparar uma entrada para o mysql executar um LOAD DATA INFILE a partir de um log binrio. Como o log binrio contm os dados para a a e carregar (isto verdade para o MySQL 4.0; o MySQL 3.23 no grava o dado carregado em e a um log binrio, assim o arquivo original era necessrio quando se queria executar o contedo a a u do log binrio), mysqlbinlog copiar este data para um arquivo temporrio e imprime um a a a comando LOAD DATA INFILE para o mysql carregar este arquivo temporrio. O local onde o a arquivo temorrio criado o diretrio temporrio por padro; ele pode ser alterado com a e e o a a a opo local-load do mysqlbinlog. ca Antes do MySQL 4.1, mysqlbinlog no podia preaparar sa cab a ida iveis para mysql quando o log binrio continha consultas de diferentes threads usando tabelas temporrias de mesmo a a nome, se estas consultas eram entrelaadas. Isto est resolvido no MySQL 4.1. c a Voc tambm pode usar o mysqlbinlog --read-from-remote-server para ler o log binrio e e a diretamente de um servidor MySQL remoto. No entanto, isto algo que est obsoleto j e a a que queremos tornar fcil de se aplicar os logs binrios em servidores MySQL em execuo. a a ca mysqlbinlog --help lhe dar mais informaes a co

4.9.6 Usando mysqlcheck para Manuteno de Tabelas e ca Recuperao em Caso de Falhas ca

Desde o MySQL verso 3.23.38 voc estar apto a usar a nova ferramenta de reparos e a e a vericao de tabelas MyISAM. A diferena para o myisamchk que o mysqlcheck deve ser ca c e usado quando o servidor mysqld estiver em funcionamento, enquanto o myisamchk deve ser usado quando ele no estiver. O benef que voc no precisar mais desligar o servidor a icio e e a a mysqld para vericar ou reparar suas tabelas. O mysqlcheck utiliza os comandos do servidor MySQL CHECK, REPAIR, ANALYZE e OPTIMIZE de um modo conveniente para o usurio. a Existem trs modos alternativos de chamar o mysqlcheck: e shell> mysqlcheck [OPC~ES] database [tabelas] O shell> mysqlcheck [OPC~ES] --databases DB1 [DB2 DB3...] O shell> mysqlcheck [OPC~ES] --all-databases O Pode ser usado de uma maneira muito similar ao mysqldump quando o assunto for quais bancos de dados e tabelas devem ser escolhidas. O mysqlcheck tem um recurso especial comparado comparado aos outros clientes; o comportamento padro, vericando as tabelas (-c), pode ser alterado renomeando o binrio. Se a a voc deseja ter uma ferramenta que repare as tabelas como o procedimento padro, voc e a e deve copiar o mysqlcheck para o disco com um outro nome, mysqlrepair, ou crie um link simblico com o nome mysqlrepair. Se voc chamar mysqlrepair agora, ele ir reparar o e a as tabelas como seu procedimento padro. a Os nomes que podem ser utilizados para alterar o comportamento padro do mysqlcheck a so: a mysqlrepair: A op~o padr~o ser -r ca a a mysqlanalyze: A op~o padr~o ser -a ca a a mysqloptimize: A op~o padr~o ser -o ca a a As opes dispon co iveis para o mysqlcheck esto listadas aqui, por favor verique o que a a sua verso suporta com o mysqlcheck --help. a

360

MySQL Technical Reference for Version 5.0.0-alpha

-A, --all-databases Verica todos os bancos de dados. Isto o mesmo que databases com todos e os bancos de dados selecionados. -1, --all-in-1 Em vez de fazer uma consulta para cada tabela, execute todas as consultas separadamente para cada banco de dados. Nomes de tabelas estaro em uma a lista separada por v irgula. -a, --analyze Anlise as tabelas fornecidas. a --auto-repair Se uma tabela checada est corrompida, ela corrigida automaticamente. O a e reparo ser feito depois que todas as tabelas tiverem sido checadas e forem a detectadas tabelas corrompidas. -#, --debug=... Log de sa de depurao. Normalmente d:t:o,lename ida ca e --character-sets-dir=... Diretrio onde esto os conjuntos de caracteres. o a -c, --check Verifca erros em tabelas -C, --check-only-changed Verica somente tabelas que foram alteradas desde a ultima conferncia ou que e no foram fechada corretamente. a --compress Utilize compresso no protocolo server/cliente. a -?, --help Exibe esta mensagem de ajuda e sai. -B, --databases Para vericar diversos bancos de dados. Perceba a diferena no uso; Neste caso c nenhuma tabela ser fornecida. Todos os argumentos so tratados como nomes a a de bancos de dados. --default-character-set=... Congura o conjunto de caracteres padro. a -F, --fast Verica somente as tabelas que no foram fechadas corretamente a -f, --force Continue mesmo se ns obtermos um erro de sql. o -e, --extended Se voc estiver utilizando esta opo com CHECK TABLE, ir garantir que a e ca a tabela est 100 por cento consistente, mas leva bastante tempo. a Se voc utilizar esta opo com REPAIR TABLE, ele ir executar um comando e ca a de reparos na tabela, que no s ir demorar muito tempo para executar, mas a o a tambm pode produzir muitas linhas de lixo. e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

361

-h, --host=... Conecta ` mquina. a a -m, --medium-check Mais rpido que vericao extendida, mas encontra somente 99.99 de todos os a ca erros. Deve resolver a maioria dos casos. -o, --optimize Otimizador de tabelas -p, --password[=...] Senha para usar ao conectar ao servidor. Se a senha no for fornecida ser a a solicitada no terminal. -P, --port=... Nmero de porta para usar para conexo. u a -q, --quick Se esta opo for utilizada com CHECK TABLE, evita a busca de registros ca vericando links errados. Esta a conferncia mais rpida. e e a Se voc estiver utilizando esta opo com REPAIR TABLE, ela tentar reparar e ca a somente a rvore de a indices. Este o mtodo de reparo mais rpido para uma e e a tabela. -r, --repair Pode corrigir quase tudo exceto chaves unicas que no so unicas. a a -s, --silent Exibe somente mensagens de erro. -S, --socket=... Arquivo socket para usar na conexo. a --tables Sobrepe a opo databases (-B). o ca

-u, --user=# Usurio para o login, se no for o usurio atual. a a a -v, --verbose Exibe informao sobre os vrios estgios. ca a a -V, --version Exibe informao sobre a verso e sai. ca a

4.9.7 mysqldump, Descarregando a Estrutura de Tabelas e Dados

Utilitrio para descarregar um banco de dados ou uma coleo de bancos de dados para a ca backup ou transferencia para outro servidor SQL (No necessariamente um servidor a MySQL). A descarga ir conter instrues SQL para cria a tabela e/ou popular a tabela. a co Se a idia backup do servidor, deve ser considerada a utilizao do mysqlhotcopy. Veja e e ca Seo 4.9.8 [mysqlhotcopy], Pgina 366. ca a

362

MySQL Technical Reference for Version 5.0.0-alpha

shell> mysqldump [OPC~ES] banco_de_dados [tabelas] O OR mysqldump [OPC~ES] --databases [OPC~ES] BD1 [BD2 BD3...] O O OR mysqldump [OPC~ES] --all-databases [OPC~ES] O O Se voc no fornecer nenhuma tabela ou utilizar o --databases ou --all-databases, e a todo(s) o(s) banco(s) de dados ser(o) descarregado(s). aa Voc pode obter uma lista das opes que sua verso do mysqldump suporta executando e co a mysqldump --help. Perceba que se voc executar o mysqldump sem a opo --quick ou --opt, o mysqldump ir e ca a carregar todo o conjunto do resultado na memria antes de descarregar o resultado. Isto o provavelmente ser um problema se voc est descarregando um banco de dados grande. a e a Note que se voc estiver utilizando uma cpia nova do programa mysqldump e se voc for e o e fazer uma descarga que ser lida em um servidor MySQL muito antigo, voc no deve a e a utilizar as opes --opt ou -e. co mysqldump suporta as seguintes opes: co --add-locks Adicione LOCK TABLES antes de UNLOCK TABLE depois de cada descarga de tabelas. (Para obter inseres mais rpidas no MySQL.) co a --add-drop-table Adicione um drop table antes de cada instruo create. ca -A, --all-databases Descarrega todos os bancos de dados. Isto ir ser o mesmo que --databases a com todos os bancos de dados selecionados. -a, --all Inclui todas as opes do create espec co icas do MySQL. --allow-keywords Permite criao de nomes que colunas que so palavras chaves. Isto funciona ca a utilizando o nome da tabela como prexo em cada nome de coluna. -c, --complete-insert Utilize instrues de insert completas (com nomes de colunas). co -C, --compress Compacta todas as informaes entre o cliente e o servidor se ambos suportarem co a compactao. ca -B, --databases Para descarregar diversos bancos de dados. Perceba a diferena no uso. Neste c caso nenhuma tabela fornecida. Todos argumentos so estimados como nomes e a de bancos de dados. USE nome_bd; ser inclu na sa antes de cada banco a ido ida de dados novo. --delayed Insere registros com o comando INSERT DELAYED. -e, --extended-insert Utiliza a nova sintaxe multilinhas INSERT. (Fornece instrues de insero mais co ca compactas e mais rpidas.) a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

363

-#, --debug[=option_string] Rastreia a utilizao do programa (para depurao). ca ca --help Exibe uma mensagem de ajuda e sai. --fields-terminated-by=... --fields-enclosed-by=... --fields-optionally-enclosed-by=... --fields-escaped-by=... --lines-terminated-by=... Estas opes so usadas com a opo -T e tem o mesmo signicado que as co a ca clusulas correspondentes em LOAD DATA INFILE Veja Seo 6.4.8 [LOAD DATA], a ca Pgina 588. a -F, --flush-logs Atualiza o arquivo de log no servidor MySQL antes de iniciar a descarga. -f, --force, Continue mesmo se obter um erro de SQL durantes uma descarga de tabela. -h, --host=.. Descarrega dados do servidor MySQL na mquina especicada. A mquina a a padro localhost. a e -l, --lock-tables. Bloqueia todas as tabelas antes de iniciar a descarga. As tabelas so bloqueadas a com READ LOCAL para permitir inseres concorrentes no caso de tabelas MyISAM. co Por favor, note que ao descarregar multiplas tabelas, --lock-tables bloquear a as tabelas de cada banco de dados separadamente. Assim, usar esta opo no ca a garantir que suas tabelas sejam logicamente consistentes entre os banco de a dados. Tabela me diferentes bancos de dados podem ser descarregadas em estados completamente diferentes. -K, --disable-keys /*!40000 ALTER TABLE nome_tb DISABLE KEYS */; e /*!40000 ALTER TABLE nome_tb ENABLE KEYS */; ser colocado na sa a ida. Isto far com que a carga a de dados no MySQL 4.0 server seja mais rpida j que os a a indices so criados a depois que todos os dados so inseridos. a -n, --no-create-db CREATE DATABASE /*!32312 IF NOT EXISTS*/ nome_bd; no ser colocado a a na saida. A linha acima ser adicionada se a opo --databases ou a ca --all-databases for fornecida. -t, --no-create-info No grava informaes de criao de tabelas (A instruo CREATE TABLE.) a co ca ca -d, --no-data No grava nenhuma informao de registros para a tabela. Isto muito util se a ca e voc desejar apenas um dump da estrutura da tabela! e --opt O mesmo que --quick --add-drop-table --add-locks --extended-insert --lock-tables. Fornece a descarga mais rpida para leitura em um servidor a MySQL.

364

MySQL Technical Reference for Version 5.0.0-alpha

-pyour_pass, --password[=sua_senha] A senha para usar quando conectando ao servidor. Se no for especicado a a parte =sua_senha, o mysqldump ir perguntar por uma senha. a -P port_num, --port=porta_num O nmero da porta TCP/IP usado para conectar a uma mquina. (Isto usado u a e para conexes a mquinas diferentes de localhost, na qual sockets Unix so o a a utilizados.) -q, --quick No utiliza buers para as consultas, descarrega diretamente para sa padro. a ida a Utilize mysql_use_result() para fazer isto. -Q, --quote-names Coloca os nomes de colunas e tabelas entre . -r, --result-file=... Direcione a sa para um determinado arquivo. Esta opo deve ser usada no ida ca MSDOS porque previne a converso de nova linha \n para \n\r (nova linha a + retorno de carro). --single-transaction Esta opo envia um comando SQL BEGIN antes de carregar os dados do servica dor. Ele mais util com tabelas InnoDB e n READ_COMMITTED de isolao da e ivel ca transao, j que neste modo ela far um dump do estado de consistncia do ca a a e banco de dados no momento que o BEGIN for enviado sem bloquear qualquer aplicao. ca Ao usar esta opo voc deve manter em mente que ser feito um dump no ca e a estado consistente apenas das tabelas transacionais, ex., qualquer tabela MyISAM ou HEAP na qual for feito um dump durante est p[o pode ainda mudar de a ca estado. A opo --single-transaction foi adicionada na verso 4.0.2. Esta opo ca a ca e mutualmente exclusiva com a opo --lock-tables j que LOCK TABLES j faz ca a a um commit da transao anterior internamente. ca -S /path/to/socket, --socket=/path/to/socket O arquivo socket que ser utilizado quando conectar ` localhost (que a a a e mquina padro). a a --tables Sobrepe a opo databases (-B). o ca

-T, --tab=path-to-some-directory Cria um arquivo nome_tabela.sql, que contm os comandos SQL CREATE e e um arquivo nome_tabela.txt, que contm os dados, para cada tabela dada. O e formato do arquivo .txt feito de acordo com as opes --fields-xxx e -e co lines--xxx. Nota: Esta opo s funciona se mysqldump est sendo executado ca o a na mesma mquina que o daemon mysqld. Voc deve usar uma conta MySQL a e que tem o privilgio FILE, e o login de usurio/grupo com o qual o mysqld e a est sendo executado (normalmente usurio mysql, grupo mysql) precisa ter a a permisso para criar/gravar um arquivo no local especicado. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

365

-u user_name, --user=user_name O nome do usurio do MySQL para usar ao conectar ao servidor. O valor a padro seu nome de usurio no Unix. a e a -O nome=valor, --set-variable=nome=valor Conrgura o valor de uma varivel. As variveis poss a a iveis so listadas abaixo. a Note que a sintaxe --set-variable=nome=valor e -O nome=valor est obsoa leto desde o MySQL 4.0. Use --nome=valor. -v, --verbose Modo verbose. Exibe mais informaes sobre o que o programa realiza. co -V, --version Exibe informaes de verso e sai. co a -w, --where=where-condition Faz um dump apenas dos registros selecionados. Note que as aspas so obria gatrias: o "--where=user=jimf" "-wuserid>1" "-wuserid<1" -X, --xml Faz um dump do banco de dados no formato XML -x, --first-slave Faz um lock de todas as tabelas de todos os bancos de dados. --master-data Como --first-slave, mas tambm exibe algum comando CHANGE MASTER TO e o qual, mais tarde, far o seu slave iniciar a partir da posio certa no log a ca binrio do master, se voc tiver congurado o seu slave usando este dump SQL a e do master. -O net_buffer_length=#, where # < 16M Quando estiver criando instrues de inseres em mltiplas linhas (com a opo co co u ca --extended-insert ou --opt), mysqldump ir criar linhas at o tamanho de a e net_buffer_length. Se voc aumentar esta varivel, voc tambm deve se e a e e assegurar que a varivel max_allowed_packet no servidor MySQL maior que a e a net_buffer_length. O uso mais comum do mysqldump provavelmente para fazer backups de bancos de dados e inteiros. Veja Seo 4.5.1 [Backup], Pgina 275. ca a mysqldump --opt banco_dados > arquivo-backup.sql Voc pode ler de volta no MySQL com: e mysql banco_dados < arquivo-backup.sql ou mysql -e "source /path-to-backup/backup-file.sql" database Entretanto, muito util tambm popular outro servidor MySQL com informaes de um e e co banco de dados: mysqldump --opt banco_dados | mysql ---host=mquina-remota -C banco_dados a poss descarregar vrios bancos de dados com um comando: E ivel a

366

MySQL Technical Reference for Version 5.0.0-alpha

mysqldump --databases banco_dados1 [banco_dados2 banco_dados3...] > meus_bancosdedad Se desejar descarregar todos os bancos de dados, pode-se utilizar: mysqldump --all-databases > todos_bancos_dados.sql

4.9.8 mysqlhotcopy, Copiando Bancos de Dados e Tabelas do MySQL

O mysqlhotcopy um script perl que utiliza LOCK TABLES, FLUSH TABLES e cp ou scp para e fazer um backup rpido de um banco de dados. E a maneira mais rpida para fazer um a a backup do banco de dados e de algumas tabelas mas ele s pode ser executado na mesma o mquina onde os diretrios dos bancos de dados esto. O mysqlhotcopy s funciona no a o a o Unix e apenas para as tabelas MyISAM e ISAM. mysqlhotcopy nome_bd [/caminho/para/novo_diretrio] o mysqlhotcopy nome_bd_2 ... nome_bd_2 /caminho/para/novo_diretrio o mysqlhotcopy nome_bd./regex/ mysqlhotcopy suporta as seguintes opes: co -?, --help Exibe uma tela de ajuda e sai -u, --user=# Usurio para fazer login no banco de dados a -p, --password=# Senha para usar ao conectar ao servidor -P, --port=# Porta para usar ao conectar ao servidor local -S, --socket=# Qual socket usar ao conectando a um servidor local --allowold No aborta se o alvo j existir (renomeie-o para old) a a --keepold No apaga alvos anteriores (agora renomeados) quando pronto a --noindices No inclui arquivos de a indices na cpia para deixar o backup menor e mais o rpido. Os a indices podem ser recostru idos mais tarde com myisamchk -rq.. --method=# Metdo para copiar (cp ou scp). o -q, --quiet Seja silencioso exceto em erros --debug Habilita depurao ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

367

-n, --dryrun Relata aes sem realiz-las co a --regexp=# Copia todos bancos de dados com nomes que coincidem com a expresso regular a --suffix=# Suxo para nomes de bancos de dados copiados --checkpoint=# Insere entrada de ponto de controle um uma bd.tabela especicada --flushlog Atualiza logs uma vez que todas as tabelas estiverem bloqueadas. --tmpdir=# Diretrio Temporrio (em vez de /tmp). o a Voc pode utilizar perldoc mysqlhotcopy para obter uma documentao mais completa e ca de mysqlhotcopy. mysqlhotcopy l os grupos [client] e [mysqlhotcopy] dos arquivos de opes. e co Para poder executar mysqlhotcopy necessrio acesso de escrita ao diretrio de backup, e a o privilgio SELECT nas tabelas que desejar copiar e o privilgio Reload no MySQL (para e e poder executar FLUSH TABLES).

4.9.9 mysqlimport, Importando Dados de Arquivos Texto

mysqlimport fornece uma interface de linha de comando para a instruo SQL LOAD DATA ca INFILE. A maioria das opes aceitas correspondem diretamente `s opes de LOAD DATA co a co INFILE. Veja Seo 6.4.8 [LOAD DATA], Pgina 588. ca a mysqlimport chamado desta maneira: e shell> mysqlimport [op~es] banco_de_dados arquivo_texto1 [arquivo_texto2....] co Para cada arquivo texto passadoo na linha de comando, mysqlimport remove qualquer extenso do nome do arquivo e utiliza o resultado para determinar para qual tabela os dados do a arquivo sero importados. Por exemplo, arquivos chamados patient.txt, patient.text a e patient sero importados para uma tabela chamada patient. a mysqlimport suporta as seguintes opes: co -c, --columns=... Esta opo recebe uma lista de nomes de campos separados por v ca irgula como um argumento. A lista de campos utilizada para criar um comando LOAD e DATA INFILE adequado que ento passado ao MySQL. Veja Seo 6.4.8 [LOAD e a ca DATA], Pgina 588. a -C, --compress Compacta todas as informaes entre o cliente e o servidor se ambos suportarem co compresso. a -#, --debug[=option_string] Rastreia o programa (para depurao). ca

368

MySQL Technical Reference for Version 5.0.0-alpha

-d, --delete Esvazie a tabela antes de importar o arquivo texto. --fields-terminated-by=... --fields-enclosed-by=... --fields-optionally-enclosed-by=... --fields-escaped-by=... --lines-terminated-by=... Estas opes tem o mesmo signicado que as clusulas correspondentes para co a LOAD DATA INFILE. Veja Seo 6.4.8 [LOAD DATA], Pgina 588. ca a -f, --force Ignorar erros. Por exemplo, se uma tabela para um arquivo texto no existir, a continue processando quaisquer arquivos restantes. Sem --force, mysqlimport sai se uma tabela no existir. a --help Exibe uma mensagem de ajuda e sai. -h host_name, --host=host_name Importa dados para o servidor MySQL na mquina referida. A mquina padro a a a localhost. e -i, --ignore Veja a descrio para a opo --replace. ca ca --ignore-lines=n Ignora as primeiras n linhas do arquivo de dados. -l, --lock-tables Bloqueia TODAS as tabelas para escrita antes de processar qualquer arquivo texto. Isto garante que todas as tabelas so sincronizadas no servidor. a -L, --local L arquivos de entrada do cliente. Por padro, assumido que os arquivos texto e a e esto no servidor se voc conectar ` localhost (mquina padro). a e a a a -pyour_pass, --password[=sua_senha] Senha para conectar ao servidor. Se voc no especicar a parte =sua_senha, e a o mysqlimport ir pedir por uma senha. a -P port_num, --port=port_num O nmero da porta TCP/IP para usar quando conectar a uma mquina. u a --protocol=(TCP | SOCKET | PIPE | MEMORY) Para especicar o protocolo de conexo. Novo no MySQL 4.1. a -r, --replace As opes --replace e --ignore controlam o tratamento de registros de enco trada que duplicam registros existentes em valores de chaves unicas. Se voc es e pecicar --replace, novos registros substituiro registros que tiverem o mesmo a valor na chave unica. Se voc especicar --ignore, registros de entrada que e duplicariam um registro existente em um valor de chave unica so saltados. Se a voc no especicar nenhuma das duas opes, um erro ocorrer quando um e a co a valor de chave duplicado for encontrado e o resto do arquivo texto ser ignorado. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

369

-s, --silent Modo silencioso. Gera sa somente quando ocorrer algum erro. ida -S /path/to/socket, --socket=/path/to/socket O arquivo socket para usar ao conectar ` localhost (mquina padro). a a a -u user_name, --user=user_name O nome de usurio MySQL para usar ao conectar ao servidor. O valor padro a a seu nome de usurio atual no Unix. e a -v, --verbose Modo verbose. Gera mais informaes na sa co ida. -V, --version Exibe informao sobre a verso e sai. ca a Abaixo um exemblo da utilizao de mysqlimport: ca $ mysql --version mysql Ver 9.33 Distrib 3.22.25, for pc-linux-gnu (i686) $ uname -a Linux xxx.com 2.2.5-15 #1 Mon Apr 19 22:21:09 EDT 1999 i586 unknown $ mysql -e CREATE TABLE imptest(id INT, n VARCHAR(30)) test $ ed a 100 Max Sydow 101 Count Dracula . w imptest.txt 32 q $ od -c imptest.txt 0000000 1 0 0 \t M a x S y d o w \n 1 0000020 1 \t C o u n t D r a c u l a 0000040 $ mysqlimport --local test imptest.txt test.imptest: Records: 2 Deleted: 0 Skipped: 0 Warnings: 0 $ mysql -e SELECT * FROM imptest test +------+---------------+ | id | n | +------+---------------+ | 100 | Max Sydow | | 101 | Count Dracula | +------+---------------+

0 \n

4.9.10 mysqlshow, Exibindo Bancos de Dados, Tabelas e Colunas

mysqlshow pode ser usado para exibir rapidamente quais bancos de dados existem, suas tabelas, e o nome das colunas da tabela. Como o programa mysql voc pode obter as mesmas informaes com comandos SHOW. Veja e co Seo 4.6.8 [SHOW], Pgina 302. ca a

370

MySQL Technical Reference for Version 5.0.0-alpha

mysqlshow chamado assim: e shell> mysqlshow [OPC~ES] [banco_dados [tabela [coluna]]] O Se nenhum banco de dados fornecido, todos os bancos de dados encontrados so e a exibidos. Se nenhuma tabela fornecida, todas as tabelas encontradas no banco de dados so e a exibidas. Se nenhuma coluna for fornecida, todas colunas e tipos de colunas encontrados na tabela so exibidos. a Note que em verses mais novas do MySQL, voc s visualiza as tabelas/bancos de dao e o dos/colunas para quais voc tem algum privilgio. e e Se o ultimo argumento conter uma shell ou um meta-caracter do SQL, (*, ?, % ou _) somente o que coincidir com o meta-caracter exibido. Se um banco de dados conter e underscore (_), eles devem ser precedidos por uma barra invertida (algumas shells de Unix iro exigir duas), para se obter tabelas/colunas apropriadamente. * so convertidos em a a metacaracteres % do SQL e ? em metacaracteres do SQL. Isto pode causar alguma confuso quando algum tentar exibir as colunas para uma tabela com um _, neste caso o a e mysqlshow exibe somente os nomes de tabelas que casarem com o padro. Isto facilmente a e corrigido adicionando um % extra na linha de comando (como um argumento separador).

4.9.11 mysql_config, Opes para compilao do cliente MySQL co ca

mysql_config lhe fornece informao util sobre como compilar o seu cliente MySQL e ca conect-lo ao MySQL. a mysql_config suporta as seguintes opes: co --cflags Parmetros de compilao para encontrar arquivos inclu a ca idos e parmetros a e denies de compiladores criticos usados ao compilar a biblioteca co libmysqlclient. Opes de compilador para encontrar arquivos de incluso do MySQL. (Norco a malmente se usaria --cflags em vez disto) --libs --libs_r --socket --port --version Nmero da verso da distribuio MySQL. u a ca --libmysqld-libs ou --embedded Bibliotecas e opes exigidas para ligar com o servidor embutido MySQL. co Se voc executar mysql_config sem nenhuma opo ele exibir todas as opes suportadas e ca a co mais os valores de todas elas: Bibliotecas e opes exigidas para ligar com a biblioteca cliente do MySQL. co Bibliotecas e opes exigidas para ligar a biblioteca cliente do MySQL segura co com thread. O nome socket padro, denido ao congurar o MySQL. a O nmero da porta padro, denida ao congurar o MySQL. u a

--include

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

371

shell> mysql_config Usage: /usr/local/mysql/bin/mysql_config [OPTIONS] Options: --cflags [-I/usr/local/mysql/include/mysql -mcpu=pentiumpro] --include [-I/usr/local/mysql/include/mysql] --libs [-L/usr/local/mysql/lib/mysql -lmysqlclient -lz -lcrypt -lnsl -lm --libs_r [-L/usr/local/mysql/lib/mysql -lmysqlclient_r -lpthread -lz -lcrypt --socket [/tmp/mysql.sock] --port [3306] --version [4.0.16] --libmysqld-libs [-L/usr/local/mysql/lib/mysql -lmysqld -lpthread -lz -lcrypt -lnsl Voc pode us-lo para compilar o cliente MySQL como a seguir: e a CFG=/usr/local/mysql/bin/mysql_config sh -c "gcc -o progname $CFG --cflags progname.c $CFG --libs"

4.9.12 perror, Explicando Cdigos de Erros o

Para a maioria dos erros de sistema o MySQL ir, em adio a uma mensagem de texto a ca interna, imprimir tambm o cdigo de erro do sistema em um dos seguintes estilos: message e o ... (errno: #) ou message ... (Errcode: #). Voc pode descobrir o que o cdigo de erro signica exeminando a documentao para o e o ca seu sistema ou usar o utilitrio perror. a perror exibe a descrio para um cdigo de erro do sistema, ou um cdigo de erro do ca o o mecanismo de armazenamento MyISAM/ISAM (handler de tabela). perror utilizado assim: e shell> perror [OPC~ES] [CDIGO_ERRO [CDIGO_ERRO...]] O O O Exemplo: shell> perror 13 64 Error code 13: Permission denied Error code 64: Machine is not on the network Note que a mensagem de erro s ona maioria dependente do sistema! a

4.9.13 Como Executar Comandos SQL a Partir de um Arquivo Texto

O cliente mysql normalmente usado de maneira interativa, desta forma: e shell> mysql banco_dados Entretanto, tambm poss e e ivel colocar seus comandos SQL em um arquivo e dizer ao mysql para ler a entrada a partir deste arquivo. Para fazer isto, crie um arquivo texto arquivo_texto contendo os comandos que voc deseja executar. Ento execute o mysql e a como exibido abaixo:

372

MySQL Technical Reference for Version 5.0.0-alpha

shell> mysql banco_dados < arquivo_texto Voc tambm pode iniciar seu arquivo texto com uma instruo USER nome_bd. Neste caso, e e ca no necessrio especicar o nome do banco de dados na linha de comando: a e a shell> mysql < arquivo_texto Se voc j est executando o mysql, voc pode executar um arquivo de script SQL usando e a a e o comando source: mysql> source filename; Para mais informaes sobre o modo batch, Seo 3.5 [Modo batch], Pgina 193. co ca a

4.10 Os Arquivos de Log do MySQL

O MySQL tem vrios arquivos de log diferentes que podem ajud-lo a descobrir o que est a a a acontecendo dentro do mysqld: Log le O log de erros O log isam O log de consultas O log de atualizaes co O log binrio a Description Problemas encontrados iniciando, executando ou parando o mysqld. Documenta todas alteraes a tabelas ISAM. Usado somente para co depurao do cdigo isam. ca o Conexes estabelecidas e consultas executadas. o Desatulizado: Armazena todas as instrues que alteram dados. co

Armazena todas as instrues que alteram qualquer coisa. Usada co tambm para replicao. e ca O log para consul- Armazena todas queries que levaram mais de long_query_time seguntas lentas dos para executar ou que no usaram a indices. Todos logs podem ser encontrados no diretrio de dados do mysqld. Voc pode forar o o e c mysqld a reabrir os arquivos de log (ou em alguns casos trocar para um novo log) executando FLUSH LOGS. Veja Seo 4.6.4 [FLUSH], Pgina 299. ca a

4.10.1 O Log de Erros

A arquivo de log de erro contm informaes indicando quando o mysqld foi iniciado e e co nalizado e tambm qualquer erro cr e itico encontrado na execuo. ca Se o mysqld naliza inesperadamente e o mysqld_safe precisar reiniciar o mysqld, mysqld_ safe gravar uma linha restarted mysqld neste arquivo. Este log tambm guarda um aviso a e se o mysqld noticar uma tabela que precisa ser automaticamente vericada ou reparada. Em alguns sistemas operacionais, o log de erro ir conter registros de pilha de onde o mysqld a nalizou. Isto pode ser usado para saber onde e como o mysqld morreu. Veja Seo E.1.4 ca [Utilizando registros de pilha], Pgina 1082. a A partir do MySQL 4.0.10 voc pode especicar onde o mysqld armazena o arquivo de log e de erro com a opo --log-error[=filename]. Se nenhum nome de arquivo for dado, ca o mysqld usar mysql-data-dir/maquina.err no Unix e \mysql\data\mysql.err no a Windows.i Se voc executar flush logs o arquivo antigo ter o prexo --old e o mysqld e a criar um novo arquivo de log vazio. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

373

Em verses mais antigas do MySQL o tratamento do log de erro era feito pelo mysqld_safe o o qual redirecionava o arquivo de erro para maquina.err. Pode se alterar este nome de arquivo com a opo --err-log=nome_arq. ca Se voc no especicar --log-error ou se voc utilizar a opo --console, o erro ser e a e ca a escrito em stderr (o terminal). No Windows a sa sempre feita no arquivo .err se --console no for utilizado. ida e a

4.10.2 O Log de Consultas

Se voc deseja saber o que acontece com mysqld, voc deve inici-lo com a opo -e e a ca log[=arquivo]. Isto ir documentar todas conexes e consultas no arquivo log (por padro a o a nomeado nome_mquina.log). Este log pode ser muito util quando voc suspeitar de a e um erro em um cliente e deseja saber exatamente o que o mysqld acha que o cliente enviou. Older versions of the mysql.server script (from MySQL 3.23.4 to 3.23.8) pass mysqld_ safe a --log option (enable general query log). If you need better performance when you start using MySQL in a production environment, you can remove the --log option from mysql.server or change it to --log-bin. Veja Seo 4.10.4 [Binary log], Pgina 374. ca a Verses mais antigas do script mysql.server (MySQL 3.23.4 a 3.23.8) passam ao safe_ o mysql uma opo --log (habilita a log de consulta geral). Se voc precisar melhorar a ca e performance quando iniciar o uso do MySQL em um ambiente de produo, pode remover ca a opo --log do mysql.server ou alter-lo para --log-bin. Veja Seo 4.10.4 [Log ca a ca binrio], Pgina 374. a a As entradas neste log so escritas quando o mysqld recebe as questes. Pode estar difera o ente da ordem em que as instrues so executadas. Isto est em contraste com o log de co a a atualizaes e o log binrio nos quais as consultas so escritas depois de serem executadas, co a a mas que quaisquer travas sejam liberadas.

4.10.3 O Log de Atualizaes co

NOTA: O log de atualizaes est obsoleto e foi substitu co a ido pelo log binrio. Veja a Seo 4.10.4 [Log binrio], Pgina 374. O log binrio pode fazer qualquer coisa que poderia ca a a a ser feito com o log de atualizaes, e mais. O log de atualizao ser removido no MySQL co ca a 5.0 Quando iniciado com a opo --log-update[=nome_arquivo], o mysqld grava um arquivo ca log contendo todos os comandos SQL que atualizam dados. Se nenhum arquivo for fornecido, o nome da mquina usado. Se um nome de arquivo for fornecido, mas no possuir o a e a caminho, o arquivo gravado no diretrio de dados. Se nome_arquivo no possuir uma e o a extenso, o mysqld ir criar os arquivos com os nomes desta forma: nome_arquivo.###, a a onde ### um nmero que incrementado cada vez que mysqladmin refresh , mysqladmin e u e flush-logs ou a instruo FLUSH LOGS forem executados ou o servidor for reiniciado. ca NOTA: Para o esquema acima funcionar, voc no pode criar seus prprios arquivos com e a o o mesmo nome que os do log de atualizao + algumas extenses que podem ser tratadas ca o como nmeros, no diretrio usado pelo log de atualizao! u o ca

374

MySQL Technical Reference for Version 5.0.0-alpha

Se forem utilizadas as opes --log ou -l, o mysqld escreve um log geral com o nome de co arquivo nome_mquina.log, e o reinicio e a recarga no geram um novo arquivo de log a a (embora ele seja fechado e reaberto). Neste caso voc pode copi-lo (no Unix) usando: e a mv nome_mquina.log nome_mquina-antigo.log a a mysqladmin flush-logs cp nome_mquina-antigo.log para-diretrio-backup a o rm nome_mquina-antigo.log a O log de atualizao inteligente pois registra somente instrues que realmente alteram ca e co dados. Portanto, um UPDATE ou um DELETE com uma clusula WHERE que no encontre a a nenhum registro no escrito no log. Ele salta at instrues UPDATE que atribui a uma a e e co coluna o mesmo valor que ela possuia. O registro da atualizao feito imediatamente aps uma consulta estar completa mas antes ca e o que as bloqueios sejam liberados ou que algum commit seja feito. Isto garante que o log seja escrito na ordem de execuo. ca Se voc desejar atualizar um banco de dados a partir de arquivos de logs de atualizao, e ca voc pode fazer o seguinte (assumindo que seus logs de atualizao estejam nomeados na e ca forma nome_arquivo.###): shell> ls -1 -t -r nome_arquivo.[0-9]* | xargs cat | mysql ls utilizado para obter todos os arquivos de log na ordem correta. e Isto pode ser util se voc tiver que recorrer a arquivos de backup depois de uma falha e e desejar refazer as atualizaes que ocorreram entre a hora do backup e a falha. co

4.10.4 O Log Binrio a

O log binrio deve substituiu o log de atualizaes. O log de atualizaes ser removido do a co co a MySQL 5.0. O log binrio contm toda informao que est dispon no log de atualizaes a e ca a ivel co em um formato mais eciente e de maneira transacionalmente segura. O log binrio, como o antigo log de atualizao, apenas registra instrues que realmente a ca co atualizam os dados. Assim um UPDATE ou um DELETE com um WHERE que no encontra a nenhum registro no gravado no log. Ele ignora mesmo instrues UPDATE que denam a a e co uma coluna um valor que ela j tenha. a O propsito principal do log binrio poder atualizar o banco de dados durante uma o a e operao de restaurao de forma mais completa poss ca ca ivel, j que o log binrio conteria a a todas as atualizaes feitas depois que um backup foi realizado. co O log binrio tambm usado para replicar um mysqld slave a partir de um master. Veja a e e Seo 4.11 [Replicao], Pgina 378. ca ca a O log binrio tambm contm informao sobre o tempo que cada consulta leva para atua e e ca alizar o banco de dados. Ele no contm consultas que no modicam dados. Se voc quiser a e a e registrar todas as consultas (por exemplo, para encontrar um consulta com problema) voc e deve usar o log geral de consultas. Veja Seo 4.10.2 [Query log], Pgina 373. ca a Quando iniciado com a opo --log-bin[=nome_arquivo], o mysqld escreve um arquivo de ca log contendo todos comandos SQL que atualizam dados. Se nenhum arquivo for fornecido, ele aponta para o nome da mquina seguido de -bin. Se for fornecido o nome do arquivo, a mas ele no tiver o caminho, o arquivo escrito no diretrio de dados. a e o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

375

Se voc fornecer uma extenso ` --log-bin=nome_arquivo.extens~o, a extenso ser e a a a a a removida sem aviso. O mysqld ir acrescentar uma extenso ao nome de arquivo do log binrio que um nmero a a a e u que incrementado cada vez que mysqladmin refresh, mysqladmin flush-logs, a ine struo FLUSH LOGS forem executados ou o servidor for reiniciado. Um novo log binrio ca a tambm ser automaticamente criado quando o tamanho do log atual alcanar max_binlog_ e a c size. Nota se voc estiver usando transaes: uma transao escrita em um bloco no e co ca e arquivo de log binrio, j que ele nunca separado entre diversos logs binrios. Desta forma, a a e a se voc tiver grnades transaes, voc pode ter logs binrios maiores que max_binlog_size. e co e a Voc pode deletar todos os arquivos de log binrio com o comando RESET MASTER (veja e a Seo 4.6.5 [RESET], Pgina 301), ou apenas alguns deles com PURGE MASTER LOGS (veja ca a Seo 4.11.7 [Replicao SQL], Pgina 400). ca ca a Voc pode utilizar as seguintes opes ao mysqld para afetar o que documentado pelo log e co e binrio (tenha certeza de ler as notas que seguem esta tabela): a Opo ca binlog-do-db=nome_banco_ dados Descrio ca Diz ao master que ele deve registrar atualizaes no co log binrio se o banco de dado atual (ex.: aquele sea lecionado por USE) nome banco dados. Todos os e outros bancos de dados que no forem explicitamente a mencionados so ignorados. Note que se voc utia e liz-lo voc deve se assegurar que voc s faz atuala e e o izaes no banco de dados atual. (Exemplo: binlogco do-db=algum_bancodados) Exemplo do que no funciona como voc podea e ria esperar: se o servidor iniciado com binloge do-db=sales, e voc zer USE prices; UPDATE e sales.january SET amount=amount+1000;, esta consulta no ser gravada no log binrio. a a a Diz ao master que atualizaes onde o banco de co dados atual (ex.: aquele selecionado com USE) e nome banco dados no deve ser gravado no log a binrio. Note que se voc usar esta opo voc deve a e ca e ter certeza que voc s faz atualizaes no banco de e o co dados atual. (Exemplo: binlog-ignore-db=algum_ banco_dados) Exemplo do que no funciona como voc podea e ria esperar: se o servidor iniciado com binloge do-db=sales, e voc zer USE prices; UPDATE e sales.january SET amount=amount+1000;, esta consulta ser gravada no log binrio. a a

binlog-ignore-db=nome_banco_ dados

As regras esto avaliadas na seguinte ordem, para decidir se a consulta deve ser escrita no a log binrio ou no: a a 1. Existem as regras binlog-do-db ou binlog-ignore-db? No: grave a consulta no log binrio e saia. a a

376

MySQL Technical Reference for Version 5.0.0-alpha

Sim: V para o passo abaixo. a 2. Ento existe algumas regras (binlog-do-db ou binlog-ignore-db ou ambos). Existe a um banco de dados atual (algum banco de dados foi selecionado com USE?)? No: NAO grave a consulta e saia. a Sim: v para o passo abaixo. a 3. Existe um banco de dados. Existe alguma regra binlog-do-db? Sim: O banco de dados atual se encaixa em qualquer uma das regras binlog-dodb? Sim: grave a consulta e saia. No: NAO grave a consulta e saia. a No: V para o passo abaixo. a a 4. Existem algumas regras binlog-ignore-db. O banco de dados atual se encaixa em qualquer uma das regras binlog-ignore-db? Sim: no grave a consulta e saia. a No: grave a consulta e saia. a Ento, por exemplo, um slave em execuo com apenas binlog-do-db=sales no gravar a ca a a no log binrio qualquer consulta em que o banco de dados atual diferente de sales (em a e outras palavras, binlog-do-db pode, signicar algumas vezes, ignore outros bancos de dados). Para saber quais arquivos binrios foram usados, o mysqld ir criar tambm um arquivo a a e de indice para o log binrio que contm o nome de todos os arquivos de log binrio usados. a e a Por padro este arquivo tem o mesmo nome que o arquivo de log binrio, com a extenso a a a .index. Voc pode alterar o nome do arquivo de e indice do log binrio com a opo --loga ca bin-index=[nome_arquivo]. Voc no deve eduitar este arquivo manualmente enquanto e a o mysqld estiver em execuo; fazer isto confundiria o mysqld. ca Se estiver sendo usado replicao, os arquivos de log binrio antigos no devem ser apagados ca a a at ter certeza que nenhum slave ir mais precisar deles. Uma forma de fazer isto o utilizar e a e mysqladmin flush-logs uma vez por dia e ento remover qualquer log com mais de 3 dias. a Voc pode remov-los manualmente, ou de preferncia usando PURGE MASTER LOGS (veja e e e Seo 4.11.7 [Replicao SQL], Pgina 400) o qual atualizar de forma segura o arquivo de ca ca a a indice do log binrio para voc (e que pode ter um argumento de data desde o MySQL 4.1) a e Uma conexo com o privilgio SUPER pode desabilitar o registro no log binrio de suas a e a consultas usando SET SQL_LOG_BIN=0. Veja Seo 4.11.7 [Replicao SQL], Pgina 400. ca ca a Voc pode examinar o arquivo de log binrio com o utilitrio mysqlbinlog. Por exemplo, e a a voc pode atualizar um servidor MySQL a partir de um log binrio como mostrado a seguir: e a mysqlbinlog arquivo-log | mysql -h nome_servidor Veja Seo 4.9.5 [mysqlbinlog], Pgina 358 para mais informaes sobre o utilitrio ca a co a mysqlbinlog e como utiliz-lo. a mysqlbinlog --help ir lhe fornecer mais informaes de como usar este programa! a co Se voc estiver utilizando BEGIN [WORK] ou SET AUTOCOMMIT=0, voc deve utilizar o log e e binrio do MySQL para backups no lugar do antigo log de atualizao. a ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

377

O Log binrio feito imedatamente depois que uma consulta terminar mas antes que os a e bloqueios sejam liberados ou algum commit seja feito. Isto garante que o log seja feito na ordem de execuo. ca Atualizaes em tabelas no transacionais so armazenadas o log binrio imediatamentco a a a edepois da execuo. Para tabelas tranascionais como BDB ou InnoDB, Todas atualizaes ca co (UPDATE, DELETE ou INSERT) que alteram uma tabela transacional so armazenadas no cache a at um COMMIT. Quaisquer atualizaes a uma tabela no transacional so armazenadas e co a a no log binrio de uma vez. Todas as threads iro, no inicio, alocar um buer de binlog_ a a cache_size para registrar consultas. Se uma conaulta maior que o registro, a thread ir e a criar um arquivo temporrio para lidar com a mesma. O arquivo temporrio ser apagado a a a quando a thread terminar. O max_binlog_cache_size (padro 4G) pode ser usado para restringir o tamanho total a usado para armazenar uma consulta multi-transacional. Se uma transao maior que isto ca e ela falhar e far um roll back. a a Se voc estiver utilizando o log de atualizao ou o binrio, inseres concorrentes no e ca a co a funcionaro juntas com CREATE ... INSERT e INSERT ... SELECT. Isto para garantir que a e voc possa recriar uma cpia exata de suas tabelas aplicando o log em um backup. e o

4.10.5 O Log para Consultas Lentas

Quando iniciado com a opo --log-slow-queries[=file_name] o mysqld escreve em um ca arquivo log contendo todos os comandos SQL que levam mais de long_query_time segundos para executar. O tempo para obter os bloqueios de tabelas iniciais no so contados como a a tempo de execuo. ca O log de consultas lentas gerado depois que uma query executada e depois de todas as e e bloqueios serem liberados. Ela pode estar em ordem diferente da que as instrues foram co executadas. Se nenhum nome de arquivo for fornecido, o padro o nome da mquina com o suxo a e a -slow.log. Se um nome de arquivo for especicado, mas no conter o caminho, o arquivo a gravado no diretrio de dados. e o O log para queries lentas pode ser usado para encontrar queries que levam muito tempo para executar e que devem ser candidatas a otimizao. Com um log muito grande, isto ca pode ser uma tarefa dif icil. Voc pode utilizar o log de consultas lentas atravs do comando e e mysqldumpslow para obter um resumo das consultas que aparecem no log. Se a opo --log-long-format estiver sendo usada, ento as consultas que no estiverem ca a a utilizando indices sero escritas. Veja Seo 4.1.1 [Opes de linha de comando], Pgina 207. a ca co a

4.10.6 Manuteno do Log de Arquivo ca

O MySQL tem vrios arquivos de log que possibilitam ver o que est ocorrendo com mais a a facilidade. Veja Seo 4.10 [Arquivos de Log], Pgina 372. Porm de tempos em tempos ca a e deve ser feita uma limpeza nos arquivos de logs do MySQL para que eles no ocupem muito a do espao do disco. c

378

MySQL Technical Reference for Version 5.0.0-alpha

Ao utilizar o MySQL com arquivos log, voc necessitar de tempos em tempos remover e a antigos arquivos de log e dizer ao MySQL para logar com novos arquivos. Veja Seo 4.5.1 ca [Backup], Pgina 275. a Em uma instalao Linux RedHat), voc pode usar o script mysql-log-rotate para isto. ca e Se voc instalou o MySQL de uma distribuio RPM, o script deve ter sido instalado autoe ca maticamente. Perceba que voc deve ter cuidado com este script se voc estiver utilizando e e o log binrio para replicao! a ca Em outros sistemas voc deve instalar um pequeno script que ser executado pelo cron e a para lidar com os arquivos de log. Voc pode forar o MySQL a iniciar utilizando novos arquivos de log usando mysqladmin e c flush-logs ou utlizando o comando SQL FLUSH LOGS. Se voc usa o MySQL Verso 3.21 e a deve utilizar o comando mysqladmin refresh. O comando acima faz o seguinte: Se o log padro (--log) ou log de consultas lentas (--log-slow-queries) forem utia lizados, fecha e reabre o arquivo de log. (mysql.log e hostname-slow.log como padro). a Se o log de atualizao (--log-update) usado, fecha o log de atualizao e abre um ca e ca novo arquivo log com uma sequncia numrica mais alta. e e Se voc s estiver utilizando o log de atualizao, voc tem apenas que atualizar os logs e e o ca e ento mover os arquivos de log antigos para um backup. Se voc estiver utilizando o log a e normal, voc pode fazer algo assim: e shell> cd diretrio-dados-mysql o shell> mv mysql.log mysql.old shell> mysqladmin flush-logs e ento fazer um backup e remover o mysql.old. a

4.11 Replicao no MySQL ca

Capacidades de replicao permitidindo que os bancos de dados em um servidor MySQL ca seja duplicado em outro foram introduzidos no MySQL verso 3.23.15. Esta seo descreve a ca os vrios recursos da replicao no MySQL. Ele serve como uma referncia para as opes a ca e co dispon iveis na replicao. Voc ser introduzido a replicao e aprender como implementca e a ca a a la. Em direo ao nal, existem algumas questes mais perguntadas (FAQ), descries de ca o co problemas e como resolv-los. e Sugeriemos que voc visite nosso website em http://www.mysql.com/ frequentemente e e leia as atualizaes desta seo. A replicao esta constantemente sendo melhorada e ns co ca ca o atualizamos o manual frequentemente com a informao mais atual. ca

4.11.1 Introduo ca
A partir da verso 3.23.15, o MySQL suporta replicao de uma via internamente. Um a ca servidor atua como o master, enquando o outro atua como slave. O servidor master mantm e um log binrio de atualizaes (veja Seo 4.10.4 [Log binrio], Pgina 374). E mantido a co ca a a tambm um arquivo de e indices dos logs binrios para manter os registro da rotatividade a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

379

dos logs. Cada slave, na conexo, informa ao master onde parou desde a ultima atualizao a ca propagada com sucesso, realiza a atualizao e ento para e espera o master informar sobre ca a novas atualizaes. co Um slave tambm pode ser um master se voc condigurar uma cadeia de servidores em e e replicao. ca Note que se voc estiver usando replicao, todas atualizaes nas tabelas replicadas devem e ca co ser realizadas no servidor master. Seno, voc sempre deve ter cuidados para evitar conitos a e entre as atualizaes que os usurios enviam ao master e aquelas que os usurios enviam ao co a a slave. Replicao de uma via trazem benef ca icios de robustez, velocidade e administrao do sistema: ca A robustez aumentada com uma conguraao master/slave. No evento de problemas e c com o master, voc pode trocar para o slave como um backup. e A velocidade extra alcanada dividindo a carga das consultas dos clientes em proe c cessamento para entre os servidores master e slave, resultando em melhor tempo de resposta. Consultas SELECT podem ser enviadas para o slave para reduzir a carga do processamento das consultas do master. Consultas que modicam dados devem ainda ser enviados para o master e slave para no carem fora de sincronia. Esta estratgia de a e balancemento de carga efetiva se consultas que no sejam de atualizao dominarem, e a ca mas este o caso normal. e Outro benef de utilizar replicao que pode-se obter backups intantneos do sisicio ca e a tema fazendo backups no slave em vez de faz-los no master. Veja Seo 4.5.1 [Backup], e ca Pgina 275. a

4.11.2 Viso Geral da Implementao da Replicao a ca ca

A replicao no MySQL baseia-se no fato do servidor master manter o registro de todas ca as alteraes de seus bancos de dados (atualizaes, delees, etc) no log binrio. (veja co co co a Seo 4.10.4 [Log binrio], Pgina 374). Cada servidor slave recebe do master consultas ca a a salvas no log binrio, para que assim execute as mesmas consultas nos seus dados replicados. a E muito importante entender que o log binrio simplesmente um registro iniciando a partir a e de um ponto xo no tempo (o momento que voc habilitou o log binrio). Quaisquer slaves e a que voc congure necessitar de cpias do banco de dados do seu master como eles existiam e a o no momento em que o log binrio foi habilitado no master. Se voc iniciar os slaves com a e dados diferentes daqueles do master quando o log binrio foi iniciado, seus slaves falharo. a a A seguinte tabela indica a compatibilidade de replicao master/slave entre diferentes ca verses do MySQL. o Master Master Master Master 3.23.33 e 4.0.0 4.0.1 4.0.3 e posterior posterior Slave 3.23.33 e sim no a no a no a posterior Slave 4.0.0 no a sim no a no a Slave 4.0.1 sim no a sim no a Slave 4.0.3 e sim no a no a sim posterior

380

MySQL Technical Reference for Version 5.0.0-alpha

Como regra geral, sempre recomendado usar verses MySQL recentes, porque as capacie o dades de replicao esto sendo continuamente melhoradas. Com relao a verso 4.0, ca a ca a recomendamos usar a mesma verso para o master e o slave, com exceo de que o 4.0.2 a ca no recomandado para replicao. a e ca Note qye quando voc atualiza um mestre do MySQL 3.23 para o MySQL 4.0 (ou 4.1) e voc no deve reiniciar a replicao usando o log binrio antigo da verso 3.23, porque isto e a ca a a infelizmente deixa o slave 4.0 confuso. A atualizao pode seguramente feita deste modo, ca assumindo que voc tenha uma mestre 3.23 para atualizar e voc tenha slaves 4.0: e e 1. Bloqueie todas as atualizaes no mestre (FLUSH TABLES WITH READ LOCK). co 2. Espere at que todos os slaves tenham buscados todas as alteraes pelo master (use e co SHOW MASTER STATUS no master, e SELECT MASTER_POS_WAIT() nos slaves). Ento exa ecute STOP SLAVE nos slaves. 3. Finalize o MySQL no master e atualize o master para o MySQL 4.0. 4. Reinicie o MySQL no master. Grave o nome <name> do log binrio mais recentemente a criado do master. Voc pode obter o nome dos arquivos executando SHOW MASTER e STATUS no master. Ento envie estes comando em cada slave: a mysql> CHANGE MASTER TO MASTER_LOG_FILE=<name>, MASTER_LOG_POS=4; mysql> START SLAVE; Se voc tambm deve atualizar seus slaves da verso 3.23 para 4.0, voc deve primeiro e e a e atualizar seus slaves: Desligue cada um, atualize-os e os reinicie. Ento atualize o master a como descrito. A partir da verso 4.0.0, pode se usar LOAD DATA FROM MASTER para congurar um escrao. a Esteja certo que LOAD DATA FROM MASTER funciona atualmente apenas se todas as tabelas no master so do tipo MyISAM. Alm disso, estas instruo iro adquirir lock global de leitura, a e ca a assim nenhuma escrita ser poss enquanto as tabelas esto sendo transferidas do master. a ivel a Quando implementarmos hot backup de tabelas sem lock (no MySQL 5.0), este lock global de leitura no ser mais necessrio. a a a Devido a estas limitaes, recomendamos que voc s use LOAD DATA FROM MASTER se o conco e o junto de dados de master for relativamente pequeno, ou se um lock de leitura prolongado no master aceitvel. Enquanto a velocidade atual do LOAD DATA FROM MASTER pode variar de e a sistema para sistema, uma boa regra do dedo de quanto tempo ser necessrio considerar a a a e 1 segundo por 1 MB do arquivo de dados. Voc car prximo da estimativa se tanto o e a o master quanto o slave forem equivalentes a um Pentium 700 Mhz e estiverem conectado a uma rede de 100 MBits/s. E claro, esta apenas uma estimativa grosseira da ordem de e magnitude. Uma vez que o slave foi congurado corretamente e est em execuo, ele simplesmente a ca conectar ao master e esperar por atualizaes nos processos. Se o master for desligado a a co ou o slave perder conectividade com seu master, ele tentar conectar periodicamente at a e conseguir reconectar e constinuar as atualizaes. O intervalo de tentativa controlado pela co e opo --master-connect-retry. O padro 60 segundos. ca a e Cada slave mantm registro de onde parou. O servidor master no tem conhecimento de e a quandos slaves existem ou quais esto atualizados em um determinado momento. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

381

4.11.3 Detalhes de Implementao da Replicao ca ca

Trs threads esto envolvidas na replicao: uma no master e duas no slave. Quando e a ca START SLAVE executado, a thread de E/S criada no slave. Ela se conecta ao master e e e pede pelo envio de seus logs binrios. Ento uma thread (chamada Binlog dump no SHOW a a PROCESSLIST no master) criada no master para enviar estes logs binrios. A thread de e a E/S l o que o Binlog dump envia e simplesmente a copia para algum arquivo local no e diretorio de dados do slave chamado relay logs. A ultima thread, a thread de SQL, criada e no slave; ela l o relay logs e executa as consultas contidas nele. e Note que o master tem uma thread para cada servidor slave atualmente conectado. Com SHOW PROCESSLIST voc pode saber o que est acontecendo no master e no slave em e a relao a replicao. ca ca O exemplo seguinte ilustra como as trs threads aparecem em SHOW PROCESSLIST. O fore aquele usado por SHOW PROCESSLIST a partir do MySQL verso 4.0.15, mato da saida e a quando o contedo da coluna State foi alterado para ser mais signicativo comparado com u verses alteraes. o co No servidor master a sa se parece com isto: ida mysql> SHOW PROCESSLIST\G *************************** 1. row *************************** Id: 2 User: root Host: localhost:32931 db: NULL Command: Binlog Dump Time: 94 State: Has sent all binlog to slave; waiting for binlog to be updated Info: NULL No servidor slave, a sa se parece com isto: ida mysql> SHOW PROCESSLIST\G *************************** 1. row *************************** Id: 10 User: system user Host: db: NULL Command: Connect Time: 11 State: Waiting for master to send event Info: NULL *************************** 2. row *************************** Id: 11 User: system user Host: db: NULL Command: Connect Time: 11

382

MySQL Technical Reference for Version 5.0.0-alpha

State: Has read all relay log; waiting for the slave I/O thread to update it Info: NULL Aqui a thread 2 est no master. A thread 10 a thread de E/S no slave. A thread 11 a e e a thread de SQL no slave; note que o valor na coluna Time pode dizer quando o slave e comparado com o master (veja Seo 4.11.9 [FAQ da Replicao], Pgina 410). ca ca a A lista a seguir mostra os estados mais comuns que voc ver na coluna State para a thread e a Binlog Dump do master. Se voc no ver estas threads em um servidor master, a replicao e a ca no est sendo executada. a a Sending binlog event to slave Logs binrios consistem de eventos, onde um evento normamente uma consulta a e mais alguma informao. A thread l um evento do log binrio e ele enviado ca e a e para o slave. Finished reading one binlog; switching to next binlog A thread nalizou a leitura de um log binrio e est abrindo o seguinte a ser a a enviado para o slave. Has sent all binlog to slave; waiting for binlog to be updated A thread leu todos os log binrios e est inativa. Ela est esperando por a a a conexes no master para gravar mais dados no log binrio, se ele quiser. o a Waiting to finalize termination Estado muito breve que ocorre quando a thread para. Aqui esto os estados mais comuns que voc ver na coluna State para a thread de E/S a e a de um servidor slave. A partir do MySQL 4.1.1, este estado tambm aparece na coluna e de SHOW SLAVE STATUS. Isso signica que voc pode ter uma boa Slave_IO_State da saida e viso do que est acontecendo apenas com SHOW STATUS SLAVE. a a Connecting to master. Conectando ao master. Checking master version. Estado muito breve que ocorre um pouco depois da conexo ser estabelecida. a Registering slave on master. Estado muito breve que ocorre um pouco depois da conexo ser estabelecida. a Requesting binlog dump. Estado muito breve que ocorre um pouco depois da conexo com o master ser a estabelecida. A thread envia ao master um pedido para envio do contedo de u seu log binrio, iniciando a partir do log binrio requisitado e sua posio. a a ca Waiting to reconnect after a failed binlog dump request. Se o pedido de dump do log binrio falhar (devido a desconexo), a thread ca a a neste estado enquanto est inativa. A thread ca inativa por master-connecta retry segundos antes de uma nova tentativa. Reconnecting after a failed binlog dump request. Ento a thread tenta se conectar com o master. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

383

Waiting for master to send event. A thread conectou e est esperando que os eventos do log binrio cheguem. a a Isto pode demorar se o master estiver inativo. Se a espera for maior que slave_read_timeout segundos, o tempo se esgotar. Neste ponto, a thread a ir considerar a conexo quebrada e far uma nova tentativa de conexo. a a a a Queueing master event to the relay log. A thread leu o evento e o est copiando para o ser relay log para que a thread a SQL possa process-lo a Waiting to reconnect after a failed master event read. Um erro ocorreu durante a leitura (devido a desconexo); inativo por mastera connect-retry segundos antes de tentar se reconectar. Reconnecting after a failed master event read. Ento a thread tenta se reconectar. Quando a conexo estabelecida novaa a e mente, o estado se tornar Waiting for master to send event. a Waiting for the slave SQL thread to free enough relay log space Voc est usando um valor relay_log_space_limit diferente de zero e os relay e a logs tem crescido tanto que o seu tamanho combinado excedem este valor. A thread E/S ento espera at que a thread SQL libere espao suciente deletando a e c o contedo dos relay logs e assim poder deletar alguns arquivos de relay logs. u Waiting for slave mutex on exit. Estado muito breve que ocorre quando a thread esta parando. Aqui esto os estado mais comuns que voc ver na coluna State para a thread de SQL de a e a um servidor slave: Reading event from the relay log A thread leu um evento do relay log para poder process-lo. a Has read all relay log; waiting for the slave I/O thread to update it A thread processou todos os eventos nos arquivos de relay logs e est esperando a a thread de E/S gravar novos eventos no relay log. Waiting for slave mutex on exit. Estado muito breve que ocorre quando a thread parada. e A coluna State para a thread de E/S tambm podem mostrar um string de consulta. e Isto indica que a thread leu um evento do relay log, extraiu a conulta dele e est a est a a executando. Antes do MySQL 4.0.2, as threads de E/S e SQL eram combinadas em uma s e nenhum o relay log era usado. A vantagem do uso de duas threads que elas separam a leitura e e a execuo da consulta em duas tarefas independentes, e assim o trabalho de leitura da ca consulta no se torna lento se a execuo da consulta for lento. Por exemplo, se o servidor a ca slave no estiver em execuo por um instante, a sua thread de E/S pode rapidamente buscar a ca todos o contedo dos logs binrios do master quando o slave iniciar, mesmo se a thread u a de SQL demorar e levar horas para pegar os logs. Se o slave parar antes da thread SQL executar todas as consultas buscadas, a thread de E/S ter nalmente buscado tudo e assim a um cpia segura das consultas estar armazenada localmente nos relay logs do slave para o a

384

MySQL Technical Reference for Version 5.0.0-alpha

execuo na prxima execuo do slave. Isto permite que os log binrios sejam apagados ca o ca a no master, j que no h mais necessidade de esperar que o slave busque o contedo deles. a a a u Por padro, relay logs so nomeados usando nome de arquivos da forma a a host_name-relay-bin.nnn, onde host_name o nome da mquina servidora e a slave e nnn uma sequncia numrica. Arquivos de relay logs sucvessivos so criados e e e a usando uma sequncia de nmeros sucessiva, comeando com 001. O slave mantm e u c e registro dos relay logs em uso atualmente em um arquivo de indice. O nome de arquivo padro dos relay logs host_name-relay-bin.index. Por padro estes arquivos so a e a a criados no diretrio de dados do slave. O nome de arquivo padro pode ser sobrescrito o a com as opes --relay-log e --relay-log-index do servidor. co Relay logs tm o mesmo formato dos logs binrios, assim ele podem ser lidos com e a mysqlbinlog. Um relay log automaticamente deletado pela thread de SQL to logo e a no seja mais necessria (ex.: assim que tiver sido executado todos os seus eventos). a a No existem comandos para deletar relay logs j que a thread SQL cuida de faz-lo. a a e No entanto, a partir do MySQL 4.0.14, FLUSH LOGS rotaciona os relay logs), o que ir a inuenciar quando a thread de SQL delet-los. a Um novo relay log criado sob as seguintes condies: e co A primeira vez que a thread de E/S inicia depois que o servidor slave inicia (No MySQL 5.0, um novo relay log ser criado a cada vez que a thread de E/S inicia, no apenas a a pela primeira vez.) Uma instruo FLUSH LOGS executada (a partir da verso 4.0.14). ca e a O tamanho do relay log atual se torna muito grande. O signicado de muito grande determinado da seguinte forma: e max_relay_log_size, se max_relay_log_size > 0 max_binlog_size, se max_relay_log_size = 0 ou o MySQL mais velho que e 4.0.14 Um servidor de replicao slave cria dois arquivos pequenos no diretrio de dados. Estes ca o arquivos so chamados master.info e relay-log.info por padro. Eles possuem ina a formao como aquela mostrada na sa da instruo SHOW SLAVE STATUS (veja Seo 4.11.8 ca ida ca ca [Replicao], Pgina 402 para uma descrio deste comando). Como imagem de discos, eles ca a ca sobrevivem ao desligamento do slave. A prxima vez que o slave reiniciado, ele pode ler o e estes arquivos para saber o quanto ele processou do log binrio do master e do seus prprios a o relay logs. O arquivo master.info atualizado pela thread de E/S. e A correspondncia entre as linhas do arquivo e as colunas mostradas por SHOW SLAVE STATUS e aparece a seguir: Linha Descrio ca 1 Master_Log_File 2 Read_Master_Log_Pos 3 Master_Host 4 Master_User 5 Senha (no mostrado por SHOW SLAVE STATUS) a 6 Master_Port 7 Connect_Retry

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

385

O arquivo relay-log.info atualizada pela thread de SQL. A correspondncia entre as e e linhas do arquivo e as colunas mostradas por SHOW SLAVE STATUS apaerece a seguir: Linha Descrio ca 1 Relay_Log_File 2 Relay_Log_Pos 3 Relay_Master_Log_File 4 Exec_Master_Log_Pos Quando voc faz backup dos dados de seu slave, voc deve fazer backup destes 2 pequenos e e arquivos, junto com seus relay logs pois eles so necessrios para continuar a replicao a a ca depois que voc restaurar os dados do slave. Se voc perder os seus relay logs mas ainda e e tiver o arquivo relay-log.info, voc pode verifclos para determinar por quanto tempo e a thread de SQL executou no log binrio do master. Ento voc pode usar CHANGE MASTER a a e TO com as opes MASTER_RELAY_LOG e MASTER_RELAY_POS para dizer ao slave para reler co os log binrios a partir deste ponto. Isto exige que o log binrio ainda exista no servidor a a master. claro. e Se seu slave est sujeito a replicao de instrues LOAD DATA INFILE, voc tambm deve a ca co e e fazer backup dos arquivos SQL_L0AD-* que podem existir no diretrio que o slave utio liza para este propsito. O slave precisar destes arquivos para continuar a replicao de o a ca qualquer instruo LOAD DATA INFILE interrompido. ca A localizao do diretrio especicada usando a opo --slave-load-tmpdir. Seu valor ca o e ca padro, se no especicado, o valor da varivel tmpdir. a a e a

4.11.4 Como Congurar a Replicao ca

Aqui est uma descrio rpida de como congurar uma replicao completa em seu servia ca a ca dor MySQL atual. Ele assume que voc deseja replicar todos os bancos de dados e nunca e congurou uma replicao anteriormente. Voc precisar desligar seu servidor master rapca e a idamente para completar os passos delineados abaixo. O procedimento gravado para a congurao de um unico slave, mas voc pode us-lo e ca e a para congurar vrios slaves. a Este mtodo o modo mais direto de se congurar um slave, mas ele no o unico. Por e e a e exemplo, se voc j tem uma cpia instantnea dos dados do master, e o master j tem e a o a a o seu ID do servidor denido e o log binrio habilitado, voc pode congurar um slaver a e sem desligar o master ou mesmo bloquear suas atualizaes. Para maiores detalhes, veja co Seo 4.11.9 [Replication FAQ], Pgina 410. ca a Se voc deseja administrar uma congurao de replicao MySQL, sugerimos que leia todo e ca ca este cap itulo e experimente todos os comandos mencionados em Seo 4.11.7 [Replication ca Master SQL], Pgina 400 e Seo 4.11.8 [Replication Slave SQL], Pgina 402. Voc tambm a ca a e e deve se familiarizar com as opes de inicializao da replicao em my.cnf na Seo 4.11.6 co ca ca ca [Replication Options], Pgina 392. a Note que este procedimento e algumas das instrues SQL da replicao em sees posterico ca co ores se referrem ao privilgio SUPER. Antes do MySQL 4.0.2, use o privilgio PROCESS. e e 1. Certique-se que voc possui uma verso recente do MySQL instalado no servidor e a master e no(s) slave(s), e que estas verses s`o compat o a iveis de acordo com a tabela mostrada em Seo 4.11.2 [Replication Implementation], Pgina 379. ca a

386

MySQL Technical Reference for Version 5.0.0-alpha

Por favor no relate os erros at que voc tenha vericado que o problema est presente a e e a na ultima distribuio. ca 2. Congure uma conta no servidor master com o com a qual o slave possa se conectar. Deve ser dada a esta conta o privilgio REPLICATION SLAVE. (Se a verso do MySQL for e a anterior a 4.0.2, de ` conta o privilgio FILE.) Se a conta somente para a replicao a e e ca (o que recomendvel), ento voc no precisar fornecer nenhum privilgio adicional e a a e a a e para ele. O nome de mquina no nome da conta deve ser aquele usado por cada um dos servidores a slaves para conectar ao master. Por exemplo, para criar um usurio chamado repl que a pode acessar seu master de qualquer mquina, voc deve utilizar este comando: a e mysql> GRANT REPLICATION SLAVE ON *.* TO repl@% IDENTIFIED BY <password>; Para verses do MySQL anteriores a 4.0.2, use este comando: o mysql> GRANT FILE ON *.* TO repl@% IDENTIFIED BY <password>; Se voc planeja usar as instrues LOAD TABLE FROM MASTER ou LOAD DATA FROM MASTER e co a partir da mquina slave, voc precisar de permisso para esta conta adicional. a e a a Conceda a conta os privilgios globais SUPER e RELOAD. e Conceda o privilgio SELECT em todas as tabelas que voc deseja carregar. Quale e quer das tabelas master nas quais a conta no possa fazer um SELECT sero ignoa a radas por LOAD DATA FROM MASTER. 3. Se voc estiver usando tabelas MyISAM, descarregue todas as tabelas e bloqueie as e consultas de escrita executando o comando FLUSH TABLES WITH READ LOCK mysql> FLUSH TABLES WITH READ LOCK; e faa uma cpia de todos os dados existentes em seu servidor master. c o A maneira mais fcil de fazer isto simplesmente usar um programa (tar no Unix, a e PowerArchiver, WinRAR, WinZip ou qualquer outro software similar no Windows) para produzir um arquivo de banco de dados no diretrio de dados do seu master. Por o exemplo, para usar tar que cria um arquivo que inclui todos os bancos de dados, altere a localizao no diretrio de dados do servidor master, e ento execute este comando: ca o a shell> tar -cvf /tmp/mysql-snapshot.tar . Se voc quiser que o arquivo inclua apenas um banco de dados chamado estebd, utilize e este comando: shell> tar -cvf /tmp/mysql-snapshot.tar ./this_db Ento copie o arquivo para o diretrio /tmp na mquina servidora slave. Naquela a o a mquina, altere a localizao em um diretrio de dados do slave e desempacote o a ca o arquivo usando este comando: shell> tar -xvf /tmp/mysql-snapshot.tar Voc pode no desejar replicar o banco de dados mysql. Se no, voc pode exclu e a a e ilo do arquivo. Voc tambm no precisa incluir qualqer arquivo de log nos arquivos e e a master.info ou relay-log.info. Enquanto o lock de leitura colocado por FLUSH TABLES WITH READ LOCK estiver em funcionando, leia o valor atual do nome do log binrio e oset no master: a mysql > SHOW MASTER STATUS;

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

387

+---------------+----------+--------------+------------------+ | File | Position | Binlog_Do_DB | Binlog_Ignore_DB | +---------------+----------+--------------+------------------+ | mysql-bin.003 | 73 | test,bar | foo,manual,mysql | +---------------+----------+--------------+------------------+ 1 row in set (0.06 sec) A coluna File exibe o nome do log, enquanto Position exibe o oset. No exemplo acima, o valor do log binrio mysql-bin.003 e o oset 73. Grave os valores. Voc a e e e precisar us-los mais tarde quando estiver congurando o slave. a a Uma vez realizada a cpia e gravado o nome do log e oset, voc pode reabilitar a o e atividade de escrita no master: mysql> UNLOCK TABLES; Se voc estiver usando tabelas InnoDB, voc deve usar a ferramente InnoDB Hot e e Backup que est dispon a ivel para aqueles que compraram as licenas comerciais do c MySQL, suporte ou a prpria ferramenta de backup. Ele faz uma cpia consistente o o sem fazer nenhum lock no servidor master, e grava o nome do log e o oset correspondente em um snapshot para ser usado postriormente no slave. Mais informaes sobre co esta ferramenta esta dispon em http://www.innodb.com/order.php. ivel Sem a ferramenta Hot Backup, o modo mais rpido para tirar uma cpia das tabelas a o InnoDB desligar o servidor master e copiar os arquivos e logs de dados do InnoDB e e os arquivos de denio de tabela (.frm). Para gravar o nome e oset do arquivo de ca log atual voc deve fazer o seguinte antes de desligar o servidor: e mysql> FLUSH TABLES WITH READ LOCK; mysql> SHOW MASTER STATUS; E ento grave o nome e oset do log da sa de SHOW MASTER STATUS como mostrado a ida anteriormente. Uma vez gravado o nome e o oset do log, desligue o servidor sem destravar as tabelas para se certicar que ele nalizar com a cpia correspondente ao a o arquivo de log e oset: shell> mysqladmin -uroot shutdown Uma alternativa para tabelas MyISAM e InnoDB fazer um dump SQL do master em e vez de uma cpia binria como acima; para isso voc pode usar mysqldump --mastero a e data em seu master e mais tarde executar o dump SQL em seu slave. No entanto, isto mais lento que fazer a cpia binria. e o a Se o master foi executado anteriormente sem o --log-bin habilitado, os valores do nome do log e da posio mostrados por SHOW MASTER STATUS ou mysqldump estaro ca a vazios. Neste caso, grave a string vazia () para o nome do log e 4 para o oset. 4. Assegure-se que a seo [mysqld] do arquivo my.cnf no master inclui a opo logca ca bin. Esta seo tambm deve conter a opo server-id=unique number, onde master_ ca e ca id deve ser um valor inteiro entre 1 e 2^32 - 1. Por exemplo: [mysqld] log-bin server-id=1 Se estas opes no esto presentes, adicione-as e reinicie o servidor. co a a 5. Pare o servidor que ser usado como slave e adicione o seguinte ao arquivo my.cnf: a

388

MySQL Technical Reference for Version 5.0.0-alpha

6.

7.

8.

9.

10.

[mysqld] server-id=slave_id O valor slave_id, como o valor master_id, deve ser um valor inteiro de 1 to 2^32 - 1. Adicionalmente, muito importante que o ID do slave seja diferente do ID do master. e Por exemplo: [mysqld] server-id=2 Se voc estiver usando vrios servidores, cada um deve ter um valor server-id que seja e a diferente daquele do master e de cada um dos slaves. Pense nos valores de server-id como algo similar ao endereo IP: Estes IDs identicam de forma unica cada instncia c a de servidor na comunidade dos parceiros de replicao. ca Se voc no quiser especicar um server-id, ele ser congurado com 1 se voc no e a a e a tiver denido master-host, seno ele ser denido com 2. Note que no caso de omisso a a a do server-id, um master ir recusar conexes de todos os slaves e um slave ir recusar a o a se conectar a um master. Assim, omitir server-id s bom para backups com um log oe binrio. a Se voc zer um backup birio dos dados do servidor master, copie-o para o diretrio de e a o dados do servidor slave antes de inici-lo. Certique-se que os privilgios nos arquivos a e e diretrios esto corretos. O usurio com o qual o MySQL executa precisa estar apto o a a a l-los e alter-los, assim como no master. e a Se voc zer um backup usando mysqldump, inicie o slave primeiro (veja o prximo e o passo). Inicie o servidor slave. Se ele tiver sido replicado previamente, inicie o servidor slave com a opo --skip-slave-start. Voc tambm pode querer iniciar o servidor slave com ca e e a opo --log-warnings. Deste modo voc ir obter mais mensagens sobre problemas ca e a (por exemplo, problemas de rede, ou conexo). a Se voc fez um backup dos dados do servidor master usando mysqldump, carregue o e arquivo de dump no servidor slave: shell> mysql -u root -p < dump_file.sql Execute os seguintes comandos no slave, substutitua os valores dentro de <> com o os valores atuais relevantes ao ser sistema: mysql> CHANGE MASTER TO -> MASTER_HOST=<master host name>, -> MASTER_USER=<replication user name>, -> MASTER_PASSWORD=<replication password>, -> MASTER_LOG_FILE=<recorded log file name>, -> MASTER_LOG_POS=<recorded log offset>; A tabela a seguir lista o tamanho mximo da string para as variveis: a a MASTER_HOST 60 MASTER_USER 16 MASTER_PASSWORD 32 MASTER_LOG_FILE 255 Inicie a thread slave: mysql> START SLAVE;

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

389

Depois de realizado este procedimento, o slave deve se conectar ao master e pegar todas as atualizaes que ocorreram desde que o backup foi restaurado. co Se voc esqueceu de congurar o server-id no master, os slaves no podero se conectar e a a a eles: Se voc esqueceu de congurar o server-id no slave, voc ir obter o seguinte erro no e e a arquivo de log: Warning: one should set server_id to a non-0 value if master_host is set. The server will not act as a slave. Voc tambm encontrar mensagens de erro no log de erro do slave se ele no puder replicar e e a a por qualquer motivo. Uma vez que um slave est replicando, voc encontrar um arquivo chamado master.info a e a e um chamado relay-log.info no diretrio de dados. Estes dois arquivos so usados pelo o a slave para manter o registro de quanto foi processado do log binrio do master. No remova a a ou edite o arquivo, a menos que voc realmente saiba o que est fazendo e entenda as e a implicaes. Mesmo neste caso, mais aconselhvel usar o comando CHANGE MASTER TO. co e a NOTA: o contedo de master.info sobrepe algumas opes especicadas na lina de u o co comando ou no my.cnf veja Seo 4.11.6 [Opes de Replicao], Pgina 392 para mais ca co ca a detalhes. Agora que voc tem uma cpia instantnea, voc pode us-la para congurar outros slaves. e o a e a Para isso siga a poro referente ao slave descrita acima. Voc no precisa ter outra cpia ca e a o do master.

4.11.5 Recursos de Replicao e Problemas Conhecidos ca

Abaixo uma explicao do que e o que no suportado: ca e a e A Replicao ser feita corretamente com valores AUTO_INCREMENT, LAST_INSERT_ID ca a e TIMESTAMP. As funes USER() e LOAD_FILE() so replicadas sem alteraes e no funcionaro de co a co a a forma convel no slave. Isto tambm verdade para CONNECTION_ID() em verses de a e e o servidor slaves mais antigas que 4.1.1. A nova funo PASSWORD() no MySQL 4.1, ca e bem replicada desde os masters 4.1.1; o seu slave deve ser 4.1.0 ou acima para replica la. Se voc tem slaves mais antigos e precisa replicar PASSWORD() do seu master 4.1.x, e voc deve iniciar o master com a opo --old-password. e ca As varivies SQL_MODE, UNIQUE_CHECKS, SQL_SELECT_LIMIT, SQL_AUTO_IS_NULL e a TABLE_TYPE no so replicados ainda. FOREIGN_KEY_CHECKS replicado desde a a a e verso 4.0.14. a Voc deve uilizar o mesmo conjunto de caracteres (--default-character-set) no e master e slave. Seno, voc pode conseguir erros de chaves duplicadas no slave, pois a e uma chave que considrada como unica no conjunto de caracteres no master pode no e a ser unico no conjunto de caracteres do slave. Se voc estiver usando tabelas transacionais no master e no transacionais (para as e a mesmas tabelas) no slave, voc ter prblemas se o slave for parado no meio de um e a bloco BEGIN/COMMIT, j que o slave ir, mais tarde, iniciar a partir do in do bloco a a icio BEGIN. Este assunto est em nosso TODO e ser corrigido em um futuro prximo. a a o

390

MySQL Technical Reference for Version 5.0.0-alpha

Consultas de atualizao que usam variveis de usurios so mal replicadas nas verses ca a a a o 3.23 e 4.0. Isto corrigido no MySQL 4.1. Note que nomes de variveis de usurios e a a so caso insensitivo a partir da verso 5.0, assim voc deve levar isto em conta quando a a e congurar uma replicao entre um servidor com verso 5.0 e outro com uma verso ca a a anterior. O slave pode se conectar ao master usando SSL, se o master e o slave forem ambos 4.1.1 ou mais novos. Embora nunca tenhamos tido casos de ocorrnciar reais, teoricamente poss e e ivel de que o dado no master e no slave podem estar diferentes se uma consulta projetada e de modo que a modicao do dado seja no determin ca a istica, p.ex. deixar a vontade do otimizados de consultas (o que geralmente no uma boa prtica, mesmo fora da a e a replicao!). Para uma explicao detalhada Seo 1.8.6.2 [Open bugs], Pgina 54. ca ca ca a Antes do MySQL 4.1.1, os comandos FLUSH, ANALYZE, OPTIMIZE e REPAIR no so a a armazenados no log binrio e por isto no so replicados para o slave. Isto normala a a mente no um problema j que estes comandos no alteram nada. Isto signica, a e a a no entanto, que se voc atualizar a tabela de privilgio do MySQL diretamente sem e e usar a instruo GRANT e replicar o banco de dados de privilgios mysql, voc deve ca e e fazer um FLUSH PRIVILEGES em seu slave para que os novos privilgios tenham efeito. e Tambm, se voc utilizar FLUSH TABLES ao renomear uma tabela MyISAM envolvida e e em uma tabela MERGE, voc ter uqe executar FLUSH TABLES manualmente no servie a dor. Desde o MySQL 4.1.1, estes comandos so escritos no log binrio (exceto FLUSH a a LOGS, FLUSH MASTER, FLUSH SLAVE, FLUSH TABLES WITH READ LOCK) a menos que voc e especique NO_WRITE_TO_BINLOG (ou seu alias LOCAL). Para um exemplo da sintaxe Seo 4.6.4 [FLUSH], Pgina 299. ca a O MySQL suporta somente um master e vrios slaves. Posteriormente adicionaremos a um algoritimo de votao para trocar automaticamente o master se alguma coisa estiver ca errada com o master atual. Iremos tambm introduzir processos agentes para ajudar e a fazer o balanceamento de carga enviando consultas SELECT para diferentes slaves. Tabelas temporrias so replicadas, exceto no caso em que voc desliga o servidor slave a a e (e no apenas a thread slave), e voc tem alguns tabelas temporrias replicadas e so a e a a usadas em instrues UPDATES que ainda no foram executadas no slave. (Se voc co a e desligar o slave, as tabelas temporrias necessrias por estas atualizaes no estaro a a co a a mais dispon iveis quando o slave iniciar novamente.) Para evitar este problema, no a desligue o servidor enquanto ele tiver tabelas temporrias abertas. Em vez disto, use a este procedimento: 1. Envie uma instruo STOP SLAVE. ca 2. Use SHOW STATUS para vericar o valor da varivel Slave_open_temp_tables. a 3. Se o valor 0, envie um comando mysqladmin shutdown para desligar o slave. e 4. Se o valor diferente de 0, reinicie as threads slaves com START SLAVE. e 5. Repita o procedimento anterior para ver se voc ter melhor sorte na prxima vez. e a o Planejamoc corrigir este problema em um futuro prximo. o seguro conectar servidores em um relacionamento master/slave circular com log E slave-updates habilitado. Note, entretanto, que vrias consultas no iro funcionar a a a corretamente neste tipo de congurao a menos que o cdigo do cliente seja escrito para ca o

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

391

tomar cuidado dos potenciais problemas que podem ocorrer em diferentes sequncias e em servidores diferentes. Isto signica que voc pode fazer uma congurao parecida com o seguinte: e ca A -> B -> C -> A As IDs do servidor so codicadas nos eventos do log binrio. A saber quando o a a a evento que ele l foi originalmente criado por A, assim A no o executar no haver ee a a a a loop innito. Mas esta congurao circular s funcionar se voc realizar atualizaes ca o a e co no conitantes entre as tabelas. Em outras palavras, se voc insere dados em A e C, a e voc nunca deve inserir um registro em A que pode ter uma chave conltante com um e registro em C. Voc tambm no deve atualizar os mesmos registros em dois servidores e e a se a ordem que a atualizao aplicada importa. ca e Se houver um erro em uma consulta no slave, a thread slave ir terminar e uma mena sagem ir aparecer no log de erro do slave. Voc deve ento conectar a um slave a e a manualmente, corrigir a causa do erro (por exemplo, tabela no existente), e ento a a executar o comando sql SLAVE START. Se a conexo para o master for perdida, o slave ir tentar se reconectar imediatamente. a a Se ele falhar, o slave ir tenatr a cada master-connect-retry segundos (padro 60). a a Por causa disto, seguro desligar o master, e ento reinici-lo depois de um tempo. e a a O slave tambm est apto para lidar com interrupes de rede. No entanto o slave e a co noticar a a perda da rede apenas aps no ter recebido dados do master por slave_ a o a net_timeout segundos. Assim se sua perda for pequena, voc pode querer diminuir e slave_net_timeout. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. ca a Desligar o slave (corretamente) tambm seguro, pois mantm sinais de onde parou. e e e Desligamentos incorretos podem produzir problemas, especialmente se o cache de disco no foi sincronizado antes do sistema morrer. Seu sistema de tolerncia a falhas ser a a a melhorado se voc possuir um bom No-Break ou UPS. e Devido a natureza no trabnsacional das tabelas MyISAM, poss ter uma consulta a e ivel que atulizar apenas parcialmente uma taela e retornar um cdigo de erro. Isto a a o pode acontecer, por exemplo, em uma insero multi-registro que tem uma violao da ca ca restrio da chave o use uma consulta de atualizao nalizada aps atualizar alguns ca ca e o dos registros. Se isto acontecer no master, a thread slave sair e ir esperar o DBA a a decidir o que fazer com isto a menos que seja autenticado e a execuo da consulta ca resulte no mesmo cdigo de erro. Se este comportamento da validao do cdigo de o ca o erro no for desejvel, algum (ou todos) os erros podem ser ignorados com a opo a a ca --slave-skip-errors. Ela est dispon a partir da verso 3.23.47. a ivel a Se voc atualiza tabelas transacionais a partir de tabelas no-transacioanis dentro de e a um segmento BEGIN/COMMIT, a atualizao no log binrio pode estar fora de sincronia ca a se algumas threads alterarem a tabela no transacional antes do commit da transao. a ca Isto porque a transao escrita no log binrio apenas quando feito o commit. e ca e a e Antes da verso 4.0.15, qualquer atualizao de uma tabela no transacional gravada a ca a e no log binrio imeditamente quando a atualizao feita enquanto atualizaes transaa ca e co cionais so gravadas no COMMIT ou no gravadas se voc utilizar um ROLLBACK. Voc a a e e deve levar isto em conta quando atualizar tabelas transacionais e no transacionais na a mesma transao e voc estiver usando o log binrio para backup ou replicao. Na ca e a ca verso 4.0.15 ns alteramos o comportamento do registro de transaes que misturam a o co

392

MySQL Technical Reference for Version 5.0.0-alpha

atualizaes de tabelas transacionais e no transacionais, que soluciona o problema (orco a dem das consultas boas no log binrio, e todas as consultas necessrias so gravadas no a a a log binrio mesmo no caso de um ROLLBACK). O problema que permanece quando uma a e segunda conexo atualiza uma tabela no transacional enquanto a primeira transao a a ca da conexo ainda no est nalizada (ordenao errada ainda pode ocorrer, porque a a a ca a atualizao da segunda conexo ser gravada imediatamente depois de ela ter sido ca a a feita). A seguinte tabela lista problemas na verso 3.23 que esto corrigidas na verso 4.0: a a a LOAD DATA INFILE tratado apropriadamente desde que o arquivo ainda esteja no e servidor master no momento da propagao da atualizao. ca ca LOAD LOCAL DATA INFILE ser ignorado. a Na verso 3.23 RAND() em atualizaes no replicado apropriadamente. Use a co a e RAND(alguma_expr_nao_rand) se voc estiver replicando atualizes com RAND(). e co Voc pode, por exemplo, utilizar UNIX_TIMESTAMP() para o argumento de RAND(). e Isto corrigido na verso 4.0. e a

4.11.6 Opes de Inicializao da Replicao co ca ca

Voc deve utilizar a opo server-id no master e no slave para estabelecer uma ID de e ca conexo unica em cada servidor. Voc deve escolher um valor unico no intervalo de 1 a a e 2^32-1 para cada master e slave. Example: server-id=3 As opes que voc pode utilizar no servidor master para controle do log binrio esto todas co e a a descritas em Seo 4.10.4 [Log binrio], Pgina 374. ca a a A seguinte tabela descreve as opes que voc pode utilizar nos servidores slaves. Voc pode co e e especic-las na lina de comando ou no arquivo de opo. a ca NOTA: A replicao trata das seguintes opes de um modo especial: ca co --master-host --master-user --master-password --master-port --master-connect-retry Se no existir nenhum arquivo master.info quando o servidor slave inicia, ele usa valores a espec icados no arquivo de opes ou na linha de comando. Isto ir ocorrer quando voc co a e iniciar o servidor como um slave de replicao pela primeira vez, ou voc executar RESET ca e SLAVE e desliga e reiniciar o servidor slave. No entanto, se o arquivo master.info existe quando o servidor slave iniciar, ele usa o valor no arquivo e IGNORA qualquer valor especicado para aquelas opes no arquivo de co opo ou na linha de comando. ca Suponha que voc especique esta opo em seu arquivo my.cnf: e ca [mysqld] master-host=this_host A primeira vez que voc iniciar o servidor como um slave de replicao, ele ir ler e usar a e ca a opo do arquivo my.cnf. O servidor gravar ento aquele valor no arquivo master.info. ca a a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

393

A prxima vez que voc iniciar o servidor, ele ir ler o valor da mquina master a partir do o e a a arquivo master.info. Se voc modicar o arquivo my.cnf para especicar uma mquina e a master diferente, ele no ter efeito. Voc deve usar CHANGE MASTER TO. a a e A partir do MySQL 4.1.1, as seguintes opes tambm tratada de forma especial: co e e --master-ssl --master-ssl-ca --master-ssl-capath --master-ssl-cert --master-ssl-cipher --master-ssl-key O arquivo master.info inclui os valores correspondentes a essas opes. Adicionalmente, co o formato do arquivo na verso 4.1.1 inclui na sua primeira linha o nmero de linhas no a u arquivo. Se voc atualizar um servidor mais antigo para a verso 4.1.1, o master.info e a ser atualizado para o novo formato automaticamente quando o novo servidor iniciar. (Se a voc substituir um MySQL 4.1.1 ou mais novo por uma verso mais antiga que a 4.1.1, voc e a e deve remover a primeira linha manualmente antes de iniciar o servidor mais antigo pela primeira vez.) Como o servidor da precedncia a uma arquivo master.info existente sobre as opes de e co inicializao acima descrito, voc pode preferir usar as opes de inicializao para estes ca e co ca valores, e especique-os usando a instruo CHANGE MASTER TO. See Seo 4.11.8.1 [CHANGE ca ca MASTER TO], Pgina 402. a Este exemplo mostra um uso mais extensivo das opes de inicializao para congurar um co ca servidor slave: [mysqld] server-id=2 master-host=db-master.mycompany.com master-port=3306 master-user=pertinax master-password=freitag master-connect-retry=60 report-host=db-slave.mycompany.com The following list describes startup options for controlling replication: --log-slave-updates Diz ao slave para registrar as atualizaes feitas pela thread da SQL do slave co no log binrio do slave. E desligado por padro. E claro que ele exige que ele a a exige que o slave seja iniciado com o log binrio habilitado (opo --log-bin). a ca --log-slave-updates usado quando voc deseja colocar diversos servidores e e em cadeia. Por exemplo, voc pode querer uma congurao como esta: e ca A -> B -> C Isto , A o servidor master do slave B, e B o servidor master do slave C. e e e Para isto funcionar, onde B tanto uma master quanto um slave, voc deve e e iniciar B com a opo --log-slave-updates. A e B devem ser iniciados com ca o log binrio habilitado. a

394

MySQL Technical Reference for Version 5.0.0-alpha

--log-warnings Fazer slave exibir mais mensagens sobre o que est sendo feito. Por exema plo, ele avisar que ele obteve sucesso em reconectar depois de uma falha de a conexo/rede, o avisr sobre cada thread slave iniciada. a a Esta opo no est limitada apenas ao uso da replicao. Ela produz avisos ca a a ca atravs de um espectro de servidores ativos. e --master-host=host Especica o nome de mquina ou endereo de IP do master para replicao. a c ca Se esta opo no for dada, a thread slave no ser iniciada. O valor em ca a a a master.info tem precedncia se ele puder ser lido. Provavelmemte um nome e nelhor para est opo seria algo do tipo --bootstrap-master-host, mas a ca e muito tarde para alter-la agora. a --master-user=nome_usurio a O usurio da conta que a thread slave usar para autenticar ao conectar ao a a master. A conrta deve ter o privilgio REPLICATION SLAVE (Em verses ane o teriores a 4.0.2 ele devia ter o privilgio FILE). Se o usurio do master no e a a for congurado, assume-se o usurio teste. O valor em master.info toma a precedncia se puder ser lida. e --master-password=password A senha da conta com a qual a thread slave autenticar quando conectar ao masa ter. Se no denida, um senha vazia considerada. O valor em master.info a e toma precedncia se puder ser lido. e --master-port=portnumber A porta que o master est escutando. Se no denifa, a congurao de a a ca compilao do MYSQL_PORT consierada. Se voc no alterou as opes do ca e e a co configure , ela deve ser 3306. O valor em master.info toma precedncia se e ele puder ser lido. --master-connect-retry=seconds O nmero de segundos que a thread slave espera antes de tentar se conectar ao u master no caso do master ter ca ou a conexo for perdida. O padro 60. ido a a e O valor em master.info toma precedncia se puder ser lido. e --master-info-file=filename Especica o nome a ser usado no arquivo que o slave grava a informao sobre ca o master. O nome padro master.info no diretrio de dados. a e o --master-ssl --master-ssl-ca=file_name --master-ssl-capath=directory_name --master-ssl-cert=file_name --master-ssl-cipher=cipher_list --master-ssl-key=filename Estas opes so usadas para congurar um conexo de replicao segura para co a a ca o servidor master usando SSL. Os seus signicados so os mesmos das opes a co correspondentes --ssl, --ssl-ca, --ssl-capath, --ssl-cert, --ssl-cipher, --ssl-key descritas em Seo 4.4.10.5 [SSL options], Pgina 274. ca a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

395

Estas opes esto operacionais a partir do MySQL 4.1.1. co a --max-relay-log-size=# Para rotacionar o relay log automaticamente. VARIABLES], Pgina 309. a Veja Seo 4.6.8.4 [SHOW ca

--relay-log=filename Para especicar a localizao e nome que deve ser usado os relay logs. Voc ca e pode us-lo para ter nomes de relay logs independentes do nome de mquina, a a ou se o seu relay log tend a ser grande (e voc no que diminuir max_relay_ e a log_size) e voc precisa coloc-los em alguma rea diferente do diretrio de e a a o dados, ou se voc quiser aumentar a velocidade balanceando as cargas entre os e discos. --relay-log-index=filename Para especicar a localizao e nome que deve ser usado para arquivo de ca indice dos relay logs. --relay-log-info-file=filename Para dar outro nome a relay-log.info e/ou coloc-lo em outro diretrio, a o diferente do diretrio de dados. o --relay-log-purge=0|1 Disabilita/habilita a remoo automtica dos relay logs assim que ele no ca a a so mais necessrios. Esta uma varivel global que ode ser alterada a a e a dinmicamente com SET GLOBAL RELAY_LOG_PURGE=0|1. o valor padro 1. a a e Esta opo est dispon a partir do MySQL 4.1.1. ca a ivel --relay-log-space-limit=# Para colocar um limite superior no tamanho total de todos os relay logs no slave (Um valor 0 signica ilimitado). Isto util se voc tiver um disco r e e igido pequeno em. sua mquina slave. Quando o limite alcanado, a thread de E/S a e c ca em pausa (no l o log binrio do master) at que a thread de SQL tenha a e a e buscado e deletado alguns dos relay logs no utilizados. Note que este limite no a a absoluto: existem casos onde a thread SQL precisa de mais eventos para poder e deletar, neste caso a thread de E/S ir superar o limite at que a deleo seja a e ca possivel. Se isto no for feito ela entra em deadlock (o que acontecia antes do a MySQL 4.0.13). Os usurios no devem congurar --relay-log-space-limit a a para menos que duas vezes o valor de --max-binlog-size (ou --max-binlogsize se --max-relay-log-size for 0) porque neste caso h a chance de que a quando a thread de E/S espera por espao livre porque --relay-log-spacec limit excedido, a thread de SQL no tem relay log para apagar e assim e a no pode satisfazer a thread de E/S, forando-a a ignorar temporariamente a c --relay-log-space-limit. --replicate-do-table=db_name.nome_tabela Diz para thread slave restrigir a replicao a uma tabela espec ca ica. Para especicar mais de uma tabela, use a diretiva mltiplas vezes, uma para cada tabela. u Isto funcionar para atualizaes atravs de bancos de dados, em contraste com a co e --replicate-do-db. Por favor, leia as notas que seguem esta lista de opes co

396

MySQL Technical Reference for Version 5.0.0-alpha

--replicate-ignore-table=db_name.nome_tabela Diz a thread slave para no replicar qualquer comando que atualiza a tabela a especicada (mesmo se qualquer outra tabela puder ser atualizada pelo mesmo comando). Para especicar mais de uma tabela a ser ignorada, use a diretiva vrias vezes, para cada tabela. Isto funcionar para atualizaes atravs de a a co e bancos de dados, em contraste com --replicate-ignore-db. Por favor, leia as notas que seguem esta lista de opoes c --replicate-wild-do-table=db_name.nome_tabela Diz a thread slave para restringir a replicao a consultas onde qualquer das ca tabelas atualizadas correspondam a padro de meta caracteres especicado. a Para especicar mais de uma tabela, use a diretiva vria vezes, uma para cada a tabela, Isto funciona para atualizaes atravs de banco de dados. Por favor, co e leia as notas que seguem esta lista de opes co Exemplo: --replicate-wild-do-table=foo%.bar% replicar apenas a atualizaes que usam uma tabela em qualquer banco de dadis que comece co com foo e cujos nomes de tabelas comecem com bar. Note que se voc zer --replicate-wild-do-table=foo%.% ento a regra ser e a a propagada para CREATE DATABASE e DROP DATABASE, ex.: estas duas instrues co sero replicadas se o nome de banco de dados corresponder ao padro do banco a a de dados (foo% aqui) (testa mgica poss por % ser o padro da tabela). a e ivel a Caracteres curingas _ e % escapados: se voc quiser replicar, por exemplo, toe das as tableas do banco de dados my_own%db (este o nome exato do banco de e dados), e no replicar tabelas do banco de dados my1ownAABCdb, voc deve esa e capar o _ e %: voc deve usar algo como isto: replicate-wild-do-table=my\_ e own\%db. E se voc estiver especicando esta opo para a linha de comando, e ca dependendo do seu sistema, voc precisar escapar o \ (por exemplo, com e a uma shell bash, voc precisaria digitar --replicate-wild-do-table=my\\_ e own\\%db). --replicate-wild-ignore-table=db_name.nome_tabela Diz a thread slave pra no replicar um consulta onde qualquer tabela cora responda ao padro de meta caracteres dado. Para especicar mais de uma a tabela, use a diretiva vrias vezes, uma vez para cada tabela. Isto funcionar a a para atualizaes atravs de banco de dados. Por favor, leia as notas que seguem co e esta lista de opes co Exemplo: --replicate-wild-ignore-table=foo%.bar% no atualizar a a tabelas no banco de dados que iniciar com foo e cujo os nomes de tabela iniciem com bar. Note que se voc zer --replicate-wild-ignore-table=foo%.% ento a ree a gra ser propagada para CREATE DATABASE e DROP DATABASE, ex. estas duas a instrues no sero replciadas se o nome do banco de dados no corresponder co a a a ao padro (foo% aqui) (esta mgica ocorre devido ao % como padro da a a a tabela). Caracteres curingas _ e % escapados: replicate-wild-do-table logo acima. veja as anotaes na descrio de co ca

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

397

--replicate-do-db=nome_bd Diz ao slave para restringir a replicao a comandos onde o banco de dados ca atual (p.ex., aquele selecionado por USE) nome_bd. Para especicar mais de e uym banco de dadosm use a diretiva vrias vezes, uma vez por tabela. Note a que isto no replicar consultas entre bancos de dados tais como UPDATE algum_ a a bd.alguma_tabela SET foo=bar se for selecionado outro banco de dados ou nenhum banco de dados. Se voc precisa que atualizaes entre bancos de dados e co funcionem, certique-se de que voc tem o MySQL 3.23.28 ou posterior, e use e --replicate-wild-do-table=db_name.%. Por favor, leia as notas que seguem esta lista de opes co Exemplo do que no funciona como voc espera: se o slave iniciado com -a e e replicate-do-db=sales, e voc faz USE prices; UPDATE sales.january SET e amount=amount+1000;, esta consulta no ser replicada. a a Se voc precisar que atualizaes entre bancos de dados funcionem, use -e co replicate-wild-do-table=db_name.%. A principal razo para este comportamento de apenas vericar o banco de dados a atual que dif para um comando sozinho saber se deve ser replicado ou e e icil no; por exemplo se voc est usando comandos delete ou update multi-tabelas a e a que continuam entre mltiplos bancos de dados. Tambm muito mais rpido u e e a vericar apenas o banco de dados atual. --replicate-ignore-db=nome_bd Diz ao slave para no replicar qualquer comando onde o banco de dados atual a (p.ex. o selecionado por USE) nome_bd. Para especicar mais bancos de daods e use a diretiva diversas vezes, uma para cada banco de dados. Voc no deve e a utilizar esta diretiva se voc est usando atualizao atravs de tabelas e voc e a ca e e no quer que estas atualizaes sejam replicadas. Por favor, leia as notas que a co seguem esta lista de opes co Exemplo do que no funcionaria como esperado: se o slave iniciado com -a e replicate-ignore-db=sales, e voc faz USE prices; UPDATE sales.january e SET amount=amount+1000;, esta consulta ser replicada. a Se voc precisar de atualizaes entre banco de dados funcione, use e co --replicate-wild-ignore-table=db_name.%. --replicate-rewrite-db=de_nome->para_nome Diz ao slave para traduzir o banco de dados atual (p.ex. aquele selecionado por USE) para para_nome se ele era de_nome no master. Apenas instrues co envolvendo a tabela podem ser afetadas (CREATE DATABASE, DROP DATABASE no a podero), e apenas se de_nome era o banco de dados atual no master. Isto no a a funcionar para atualizaes entre banco de dados. Note que a translao a co ca e feita antes das regras de --replicate-* serem testadas. Exemplo: replicate-rewrite-db=master_db_name->slave_db_name --report-host=host O Nome de mquina ou nmero IP do slave a ser relatado ao master durante o a u registro do slave. Aparecer na sa de SHOW SLAVE HOSTS. Deixe indenido se a ida voc no quiser que o slave se registre no master. Note que ele no suciente e a a e

398

MySQL Technical Reference for Version 5.0.0-alpha

para o master simplesmente ler o nmero IP do slave fora dos sockets uma vez u que o slave se conecte. Devido ao NAT e outros assuntos de roteamento,a quele IP pode no ser vlido para se conectar ao slave a partir do master ou outras a a mquinas. a Esta opo est dispon a partir do MySQL 4.0.0. ca a ivel --report-port=portnumber Porta para conexo do slave relatado ao master durante o registro do slave. a Dena-o apenas se o slave est escutando por uma porta diferente da padro a a ou se voc tiver um tunel especial do master ou outros clientes para o slave. Se e no tiver certeza, deixe esta opo indenida. a ca Esta opo est dispon a partir do MySQL 4.0.0. ca a ivel --skip-slave-start Diz ao servidor slave para no iniciar a thread slave na iicializao do servidor. a ca O usurio pode inici-las mais tarde com START SLAVE. a a --slave_compressed_protocol=# Se 1, usa compactao no protocolo cliente/servidor se tanto o slave quanto o ca mester suport-la. a --slave-load-tmpdir=filename Esta opo igual ao valor da varivel tmpdir por padro. Quando a thread ca e a a SQL do slave replica um comando LOAD DATA INFILE, ele extrai os arquivos a serem carregados do relay logs em arquivos temporrios, e ento os carrega a a dentro da tabela. Se o arquivo carregado no master era enorme, os arquivos temporrios no slave tambm sero enormes; embora voc possa desejar que o a e a e slave coloque o arquivo temporrio em algum disco grande diferente de tmpdir, a usando esta opo. Nestes caso, voc tambm pode usar a opo --relay-log, ca e e ca j que os relay logs sero grandes tambm. --slave-load-tmpdir deve apontar a a e para o sistema de arquivo baseado em disco; no em um baseado em memria. a o Como o slave precisa de arquivos temporrios usados para replicar LOAD DATA a INFILE) para sobreviver a uma reinicializao da mquina. ca a --slave-net-timeout=# Nmero de segundos a esperer por mais dados do master antes de abortar a u leitura, considerando o quebra de conexo e as tentativas de reconectar. A a primeira vez ocorre imediatamente depois do tempo limite. O intervalo entre tentativas controlado pela opo --master-connect-retry. e ca --slave-skip-errors= [err_code1,err_code2,... | all] Diz ao a thread SQL do slave para continuar a replicao quando uma consulta ca retornar um erro de uma lista fornecida. Normalmente, a replicao ir parar ao ca a encontrar um erro, dando ao usurio a chance de resolver a inconsistncian nos a e dados manualmente. No use esta opo a menos que voc saiba exetamente a ca e o motivo dos erros. Se no houver erros em sua congurao da replicao e a ca ca programas clientes, e no houver erros no MySQL, voc nunca deve ter uma a e replicao abortada com erro. O uso indiscriminado desta opo resultar em ca ca a slaves fora de sincronia com o master e voc no ter idia de como o problema e a a e aconteceu.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

399

Para cdigos de erros, voc deve usar o nmero fornecido pela mensagem de o e u erron no seu log de erros do slave e na sa de SHOW SLAVE STATUS. Uma lista ida completa de mensagens de erro podem ser encontradas na distribuio fonte ca em Docs/mysqld_error.txt. Os cdigos de erros do servidor tambm so o e a listados em Seo 13.1 [Error-returns], Pgina 889. ca a Voc tambm pode (mas no deve) usar um valor no recomendado de all o que e e a a ir ignorar todas as mensagens de erro e continua em frente indiferentemente. a No preciso dizer, que se voc usar isto, no podemos garantir a integridade a e e a dos seus dados. Por favor, no reclame se seus dados no slave no estiver nem a a prximo daqueles em seu master neste caso voc foi avisado. o e Exemplos: --slave-skip-errors=1062,1053 --slave-skip-errors=all Algumas destas opes, como todas as opes --replicate-*, s podem ser denidas na co co o inicializao do servidor slave, e no com ele ligado. Planejamos corrigir isto. ca a Aqui est a ordem de avaliao das regras --replicate-*, para decidir se a consulta ser a ca a executada pelo slave ou ignorada por ele: 1. Existe alguma regra --replicate-do-db ou --replicate-ignore-db? Sim: teste-as como para --binlog-do-db e --binlog-ignore-db (veja Seo 4.10.4 [Binary log], Pgina 374). Qual o resultado do teste? ca a e ignore a consulta: ignore-a e saia. execute a consulta: no execute-a imediatamente, adie a deciso, v para o a a a passo abaixo. No: v para o passo abaixo. a a 2. Existe alguma regra --replicate-*-table? No: execute a consulta e saia. a Sim: v para o passo abaixo. Apenas tabela que sero atualizadas sero coma a a paradas `s regras (INSERT INTO sales SELECT * from prices: apenas sales ser a a comparada `s regras). Se vrias tabelas forem ser atualizadas (instrues multia a co tabelas) a primeira a corresponder a regra (com do ou ignore) vence (isto , e a primeira tabela comparada a regra. se nenhuma deciso pode ser tomada a e a segunda tabela compara `s regras, etc). e a 3. Existe alguma regra --replicate-do-table? Sim: o tabela encaixa em alguma delas? Sim: execute a consulta e saia. No: v para o passo abaixo. a a No: v para o passo abaixo. a a 4. Existe alguma regra --replicate-ignore-table? Sim: a tabela encaixa em alguma delas? Sim: ignore a consulta e saia. No: v para o passo abaixo. a a No: v para o passo abaixo. a a

400

MySQL Technical Reference for Version 5.0.0-alpha

5. Existe alguma regra --replicate-wild-do-table? Sim: a tabela se encaixa em qualquer uma delas? Sim: execute a consulta e saia. No: v para o passo abaixo. a a No: v para o passo abaixo. a a 6. Existe alguma regra --replicate-wild-ignore-table? Sim: a tabela se encaixa em qualquer uma delas? Sim: ignore a consulta e saia. No: v para o passo abaixo. a a No: v para o passo abaixo. a a 7. Nenhuma regra --replicate-*-table foi correspondida. Existe outra tabela para se testar com estas regras? Sim: loop. No: testamos todas as tabelas a serem atualizadas, nenhuma regra foi obedecida. a Existem regras --replicate-do-table ou --replicate-wild-do-table? Sim: ignore a consulta e saia. No: execute a consulta e saia. a

4.11.7 Instrues SQL para Controle do Servidor Master co

0 replicao pode ser controlada por meio da interface SQL. Esta seo discute instrues ca ca co para gerenciamento dos servidores masters de replicao. Seo 4.11.8 [Replication Slave ca ca SQL], Pgina 402 discute instrues para gerenciamento dos servidores slaves. a co

4.11.7.1 PURGE MASTER LOGS

PURGE {MASTER|BINARY} LOGS TO log_name PURGE {MASTER|BINARY} LOGS BEFORE date Deleta todos os logs binrios que esto listados no a a indice de log anteriores ao log ou data especicado. O log tambm remove da lista gravada no e indice de log, e assim o log dado se torna o primeiro. Exemplo: PURGE MASTER LOGS TO mysql-bin.010; PURGE MASTER LOGS BEFORE 2003-04-02 22:46:26; A variante BEFORE est dispon a ivel no MySQL 4.1; este argumento de data pode estar no formato YYYY-MM-DD hh:mm:ss. MASTER e BINARY so sinnimos, embora BINARY possa a o ser usado apenas a partir do MySQL 4.1.1. Se voc tiver um slave ativo que est atualmente lendo um dos logs que voc st tentando e a e a deletar, este comando no faz nada e falha com um erro. No entanto, se voc tiver um a e slave ativo e apagar um dos logs que ele quiser ler, o slave no poder replicar uma vez a a que ele esteja ativo. O comando seguro para de se executar enquanto os sslaves estiverem e replicando. Voc no precisa de par-los. e a a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

401

Voc deve primeiro vericar todos os slaves com SHOW SLAVE STATUS para ver qual log eles e esto lendo, e ento voc deve fazer uma lista dos logs no master com SHOW MASTER LOGS, a a e encontrar o log mais novo entre todos os slaves (se todos os slaves esto atualizados, ele a ser o ultimo log da lista), tirar backup de todos os logs que voc est prestes a deletar a e a (opcional) e deletar at o log alvo. e

4.11.7.2 RESET MASTER

RESET MASTER Deleta todos os logs binrios listado no arquivo de a indice, zerando o arquivo de indice do log binrio. a Esta instruo rea chamada FLUSH MASTER antes do MySQL 3.23.26. ca

4.11.7.3 SET SQL_LOG_BIN

SET SQL_LOG_BIN = {0|1} Disabilita ou habilita o log binrio para a conexo do usurio (SQL_LOG_BIN uma varivel a a a e a de sesso) se o cliente conecta usando uma conta que tem o privilgio SUPER. A instruo a e ca ignorada se o cliente no possui este privilgio. e a e

4.11.7.4 SHOW BINLOG EVENTS

SHOW BINLOG EVENTS [ IN log_name ] [ FROM pos ] [ LIMIT [offset,] row_count ] Mostra o evento no log binrio. Se voc no especicar log_name, o primeiro log binrio a e a a ser exibido. a Esta instruo est dispon a partir do MySQL 4.0. ca a ivel

4.11.7.5 SHOW MASTER STATUS

SHOW MASTER STATUS Fornece a informao de status no log binrio do master. ca a

4.11.7.6 SHOW MASTER LOGS

SHOW MASTER LOGS Lista o log binrio no master. Voc deve usar este comando antes de PURGE MASTER LOGS a e para descobrir at onde voc deve ir. e e

4.11.7.7 SHOW SLAVE HOSTS

SHOW SLAVE HOSTS Mostra uma lista de slaves atualmente registrados com o master. Note que slaves no a iniciados com a opo --report-host=slave_name no estaro visiveis nesta lista. ca a a

402

MySQL Technical Reference for Version 5.0.0-alpha

4.11.8 Instrues SQL para Controle do Servidor Slave co

A replicao pode ser controlada por meio da interface SQL. Esta seo discute instrues ca ca co para gerenciamento dos servidores slaves de replicao. Seo 4.11.7 [Replication Master ca ca SQL], Pgina 400 discute instrues para gerenciamento dos servidores master. a co

4.11.8.1 CHANGE MASTER TO

CHANGE MASTER TO master_def [, master_def] ... master_def = MASTER_HOST = host_name | MASTER_USER = user_name | MASTER_PASSWORD = password | MASTER_PORT = port_num | MASTER_CONNECT_RETRY = count | MASTER_LOG_FILE = master_log_name | MASTER_LOG_POS = master_log_pos | RELAY_LOG_FILE = relay_log_name | RELAY_LOG_POS = relay_log_pos | MASTER_SSL = {0|1} | MASTER_SSL_CA = ca_file_name | MASTER_SSL_CAPATH = ca_directory_name | MASTER_SSL_CERT = cert_file_name | MASTER_SSL_KEY = key_file_name | MASTER_SSL_CIPHER = cipher_list Altera os parmetros que o servidor slave usa para conectar e comunicar com o servidor a master. Os valores poss iveis para o valor master_def esto mostrados acima. a As opes do relay log (RELAY_LOG_FILE e RELAY_LOG_POS) esto dispon co a iveis a partir do MySQL 4.0. As opes SSL (MASTER_SSL, MASTER_SSL_CA, MASTER_SSL_CAPATH, MASTER_SSL_CERT, co MASTER_SSL_KEY, e MASTER_SSL_CIPHER) esto dispon a iveis a partir do MySQL 4.1.1. Voc e pode alterar estas opes mesmo nos slaves que so compilados sem suporte a SSL. Eles co a sero salvos no arquivo master.info mas ignorados at que voc use um servidor que a e e tenha suporte a SSL habilitado. Por exemplo: mysql> CHANGE MASTER TO -> MASTER_HOST=master2.mycompany.com, -> MASTER_USER=replication, -> MASTER_PASSWORD=bigs3cret, -> MASTER_PORT=3306, -> MASTER_LOG_FILE=master2-bin.001, -> MASTER_LOG_POS=4, -> MASTER_CONNECT_RETRY=10; mysql> CHANGE MASTER TO

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

403

-> ->

RELAY_LOG_FILE=slave-relay-bin.006, RELAY_LOG_POS=4025;

MASTER_USER, MASTER_PASSWORD, MASTER_SSL, MASTER_SSL_CA, MASTER_SSL_CAPATH, MASTER_SSL_CERT, MASTER_SSL_KEY, and MASTER_SSL_CIPHER are information for the slave to be able to connect to its master. If you dont specify some of these informations, the non-specied informations will keep their old value. For example, if the password to connect to your MySQL master has changed, you just need to issue mysql> STOP SLAVE; -- if replication was running mysql> CHANGE MASTER TO MASTER_PASSWORD=new3cret; mysql> START SLAVE; -- if you want to restart replication to tell the slave about the new password; no need to specify the information which did not change (host, port, user etc). MASTER_HOST, MASTER_PORT are the hostname or IP adress of the master host, and its TCP port. Note that if MASTER_HOST is equal to localhost, then, like in other parts of MySQL, the port may be ignored (if Unix sockets can be used for example). Se voc especicar MASTER_HOST ou MASTER_PORT, o slave assumir que o mestre diferente e a e do anterior (mesmo se voc especicar um valor de nost ou porta iguais ao do valor atual.) e Neste caso Assim, os valores antigos do nome e posio do log binrio do mestre no so mais ca a a a aplicveis, assim se voc no especicar MASTER_LOG_FILE e MASTER_LOG_POS no comando, a e a MASTER_LOG_FILE= e MASTER_LOG_POS=4 so silenciosamente adicionados a ele. a MASTER_LOG_FILE e MASTER_LOG_POS so as coordenadas das quais a thread de E/S do a slave comeara a ler do master na prxima vez em que ele for iniciado. If you specify any of c o them, you cant specify RELAY_LOG_FILE or RELAY_LOG_POS. If none of MASTER_LOG_FILE and MASTER_LOG_POS was specied, then the last coordinates of the slave SQL thread before CHANGE MASTER was issued, are used. This ensures that replication has no discontinuity, even if the slave SQL thread was late compared to the slave I/O thread, when you just want to change, say, the password to use. This safe behaviour was introduced starting from MySQL 4.0.17 and 4.1.1. (Before these versions, the used coordinates were the last coordinates of the slave I/O thread before CHANGE MASTER was issued, which caused the SQL thread to sometimes lose some events from the master, thus breaking replication.) CHANGE MASTER TO deleta todos os relay logs (e inicia um novo), a menos que voc especie que RELAY_LOG_FILE ou RELAY_LOG_POS (neste caso os relay logs sero mantidos; desde o a MySQL 4.1.1 a varivel global RELAY_LOG_PURGE ser denida com zero sem aviso prvio). a a e CHANGE MASTER TO atualiza master.info e relay-log.info. CHANGE MASTER util para congurar um slave quando voc tem a cpia do master e e e o gravou o registro e oset no master que corresponde a cpia tirada. Voc pode execuo e tar CHANGE MASTER TO MASTER_LOG_FILE=log_name_on_master, MASTER_LOG_POS=log_ offset_on_master no slave depois de restaurar a cpia. o O primeiro exemplo acima (CHANGE MASTER TO MASTER_HOST=master2.mycompany.com etc) altera as coordenadas do master e do seu log binrio. Isto quando voc deseja que o a e e slave replique o master. O segundo exemplo, usado com menos frequncia, quando o slave e e possui relay logs que, por alguma razo, voc deseja que o slave execute novamente; para a e fazer isto o master no precisa estar alcanavel, voc s precisa fazer CHANGE MASTER TO e a c e o iniciar a thread de SQL (START SLAVE SQL_THREAD). Voc pode usar isto mesmo fora da e

404

MySQL Technical Reference for Version 5.0.0-alpha

consigurao de replicao, em um servidor standalone, slave-de-ningum, para recuperao ca ca e ca depois de uma falha. Suponha que o seu servidor tenha falhado e voc tenha restaurado um backup. Voc deseja e e reexecutar o prprio log binrio do servidor (no os relay logs, mas logs binrios regulares), o a a a supostamente chamado myhost-bin.*. Primeiro faa uma cpia destes logs binrios em c o a alguns lugares seguros, no caso de voc no seguir exatamente o procedimento abaixo e e a acidentalmente apagar os logs binrios de servidor. Se voc estiver usando o MySQL 4.1.1 a e ou mais novos, dena SET GLOBAL RELAY_LOG_PURGE=0 para segurana adicional. Ento c a inicie o servidor sem log-bin, com um novo ID do servidor (diferente do anterior), com relay-log=myhost-bin (para fazer o servidor acreditar que estes logs binrios regulares a so relay logs) e skip-slave-start, ento execute estas instrues: a a co mysql> CHANGE MASTER TO -> RELAY_LOG_FILE=myhost-bin.153, -> RELAY_LOG_POS=410, -> MASTER_HOST=some_dummy_string; mysql> START SLAVE SQL_THREAD; Ento o servidor ir ler e executar seus prprios logs binrios, e assim conseguindo a recua a o a perao de falhas. Uma vez que a recuperao est nalizada, execute STOP SLAVE, desligue ca ca a o servidor, delete master.info e relay-log.info, e reinicie o servidor com suas opes co originais. No momento, especicar MASTER_HOST (mesmo com um valor modelo) come pulsrio para fazer o servidor pensar que ele um slave, e dar ao servidor um novo ID, o e diferente do anterior compulsrio seno o servidor ver os eventos com seus IDs e pene o a a sar que ele est em uma congurao de replicao circular e ignora os eventos, o que a a ca ca e indesejado. No futuro planejamos adicionar opes para lidar com estas pequenas restries. co co

4.11.8.2 LOAD DATA FROM MASTER

LOAD DATA FROM MASTER Tira uma cpia do master para o slave. Atualiza os valores de MASTER_LOG_FILE e MASTER_ o LOG_POS assim o slave ser iniciado replicando da posio correta. Respeitar a regras de a ca a excluso de tabelas e bancos de dados especicadas com as opes replicate-*. a co O uso desta instruo est sujeito ao seguinte: ca a Funciona apenas com tabelas MyISAM. Ele adquire um lock de leitura global no master enquanto tira um instantneo, que a evita atualizaes no master durante esta operao. co ca No futuro est planejado faz-lo funcionar com tabelas InnoDB e remover a necessidade de a e lock deleitura global usando o recurso de backup online sem bloqueio. Se voc estiver carregando tabelas grandes, voc pode aumentar os valores de net_read_ e e timeout e net_write_timeout no mestre e no slave. Veja Seo 4.6.8.4 [SHOW VARIca ABLES], Pgina 309. a Note que LOAD DATA FROM MASTER NAO copia nenhuma tabela do banco de dados mysql. Isto para tornar facil de se ter diferentes usurios e privilgios no master e no slave. e a e Esta instruo exige que o usurio de replicao usado para se conectar ao master tenha ca a ca privilgios RELOAD e SUPER no master, privilgios SELECT em todas as tabelas do master e e

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

405

que voc queira carregar. Todas as tabelas do master nas quais os usurios no tenham e a a privilgio SELETC sero ignoradas pelo LOAD DATA FROM MASTER; isto ocorre porque o mase a ter ir esconde-los do usurio: LOAD DATA FROM MASTER chama SHOW DATABASES para saber a a qual banco de dados do master carregar, mas SHOW DATABASES retorna apenas o banco de dados nos quais o usurio tem algum privilgio. Veja Seo 4.6.8.1 [Show database info], a e ca Pgina 303. No lado do slave, o usurio que executa LOAD DATA FROM MASTER deve ter a a permisso para apagar e criar o banco de dados e tabelas envolvidos. a

4.11.8.3 LOAD TABLE tbl_name FROM MASTER

LOAD TABLE tbl_name FROM MASTER Faz o download de uma cpia da tabela do master para o slave. Esta instruo impleo ca e mentada principalmente para depurao de LOAD DATA FROM MASTER. Exige que o usurio ca a de replicao que usado para conectar ao master tenha privilgios RELOAD e SUPER no ca e e master, e SELECT na tabela do master que ser carregada. No lado do slave, o usurio que a a envia LOAD TABLE FROM MASTER deve ter permisso para apagar e criar a tabela. Leia as a anotaes sobre tempo limite nadescrio de LOAD DATA FROM MASTER abaixo, elas se aplico ca cam aqui tambm. Por favor, leia tambm as limitaes de LOAD DATA FROM MASTER acima, e e co elas tambm se aplicam (por exemplo, LOAD TABLE FROM MASTER s funciona com tabelas e o MyISAM).

4.11.8.4 MASTER_POS_WAIT()
SELECT MASTER_POS_WAIT(master_log_file, master_log_pos) Esta uma funo, no um comando. E usada para assegurar que o slave tenha alcanado e ca a c (lido e executado) uma dada posio no log binrio do master. Veja Seo 6.3.6.2 [Miscelca a ca laneous functions], Pgina 547 para uma descrio completa. a ca

4.11.8.5 RESET SLAVE

RESET SLAVE Faz o slave esquecer a sua posio de replicao no log binrio do master. Esta instruo usca ca a ca e ada para uma inicializao limpa: ela deleta os arquivos master.info e relay-log.info, ca todos os relay logs e inicia um novo relay log. Nota: Todos os relay logs so deletados, mesmo a se no forem totalmente executados pela threads SQL do slave. (Esta uma condio que a e ca deveria existir em um slave de replicao altamente carregado, ou se voc enviasse uma ca e instruo STOP SLAVE.) As informaes de conexo armazenadas no arquivo master.info ca co a so imediatamente recarregadas com os valores especicados nas opes de inicializaco, a co a se forem especicadas. Estas informaes incluem valores como mquina master, porta do co a master, usurio do master e senha do master. Se a thread SQL do slave estava no meio de a uma replicao de tabelas temposrrias quando ela foi parada, e RESET SLAVE excutado, ca a e estas tabelas temporrias replicadas so deletadas no slave. a a Esta instruo era chamada FLUSH SLAVE antes do MySQL 3.23.26. ca

4.11.8.6 SET GLOBAL SQL_SLAVE_SKIP_COUNTER

SET GLOBAL SQL_SLAVE_SKIP_COUNTER = n

406

MySQL Technical Reference for Version 5.0.0-alpha

Salta os prximos n eventos do master. Util para recuperao de paradas da replicao o ca ca causada por um erro. Esta instruo s vlida quando a thread slave no est em execuo, em caso contrrio, ca o e a a a ca a retorna um erro. Antes do MySQL 4.0, omite a palavra chave GLOBAL da instruo. ca

4.11.8.7 SHOW SLAVE STATUS

SHOW SLAVE STATUS Fornece a informao de status nos parmetros essenciais da thread do slave. Se voc ca a e utilizar esta instruo usando no cliente mysql, voc pode usar o terminador \G em vez de ca e um ponto e v irgula no m, para conseguir um layout vertical mais leg ivel: mysql> SHOW SLAVE STATUS\G *************************** 1. row *************************** Slave_IO_State: Waiting for master to send event Master_Host: localhost Master_User: root Master_Port: 3306 Connect_Retry: 3 Master_Log_File: gbichot-bin.005 Read_Master_Log_Pos: 79 Relay_Log_File: gbichot-relay-bin.005 Relay_Log_Pos: 548 Relay_Master_Log_File: gbichot-bin.005 Slave_IO_Running: Yes Slave_SQL_Running: Yes Replicate_Do_DB: Replicate_Ignore_DB: Last_Errno: 0 Last_Error: Skip_Counter: 0 Exec_Master_Log_Pos: 79 Relay_Log_Space: 552 Until_Condition: None Until_Log_File: Until_Log_Pos: 0 Master_SSL_Allowed: No Master_SSL_CA_File: Master_SSL_CA_Path: Master_SSL_Cert: Master_SSL_Cipher: Master_SSL_Key: Seconds_Behind_Master: 8 Dependendp da sua verso do MySQL, voc pode no ver todos os campos como aqui a e a mostrado. Alguns campos esto presentes apenas a partir do MySQL 4.1.1. a

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

407

Os campos mostrados por SHOW SLAVE STATUS tem o seguinte signicado: Slave_IO_State Uma cpia da coluna State da sa de SHOW PROCESSLIST para a thread de E/S o ida do slave; lhe dir se est thread est tentando se conectar ao master, esperando a a a por eventos do master, reconectando ao master, etc. Os estados poss iveis esto a listados em Seo 4.11.2 [Replication Implementation], Pgina 379. Olhar est ca a a coluna necessrio porque, por exemplo, a thread pode estar em execuo mas e a ca no tem sucesso ao tentar se conectar ao master: apenas esta coluna lhe deixar a a ciente do problema de conexo. Por outro lado, o estado da thread SQL no a a copiada, porque as coisas so mais simples para esta thread: se ela estiver e a em execuo, no haver problema; se no, voc encontrar o erro na coluna ca a a a e a Last_Error (descrita abaixo). Este campo est presente a partir do MySQL 4.1.1. a Master_Host A mquina master atual. a Master_User O usurio usado para conectar ao master. a Master_Port A porta atual do master. Connect_Retry O valor atual de master-connect-retry. Master_Log_File O nome do arquivo de log binrio do master no qual a thread de E/S est lendo a a atualmente. Read_Master_Log_Pos A posio at a qual a thread de E/S leu no log binrio do master. ca e a Relay_Log_File O nome do arquivo de relay log na qual a thread SQL est lendo e executando a atualmente. Relay_Log_Pos A posio at a qual a thread de SQL leu e executou neste relay log. ca e Relay_Master_Log_File O nome do arquivo de log binrio do master no qual contm o ultimo evento a e executado pela thread de SQL. Slave_IO_Running Diz se a thread de E/S foi iniciada ou no. a Slave_SQL_Running Diz se a thread de SQL est iniciada ou no. a a Replicate_Do_DB, Replicate_Ignore_DB A lista de banco de dados que foi especicado com as opes --replicate-doco db e --replicate-ignore-db.

408

MySQL Technical Reference for Version 5.0.0-alpha

Replicate_Do_Table, Replicate_Ignore_Table, Replicate_Wild_Do_Table, Replicate_Wild_Ignore_Table As tabelas que foram especicadas com as opes --replicate-do-table, co --replicate-ignore-table, --replicate-wild-do-table, e --replicatewild-ignore_table. Estes campos esto presentes a partir do MySQL 4.1.1. a Last_Errno O nmero de erro retornado pela consulta executada mais recentemente. Um u valor 0 signica sem erro. Last_Error A mensagem de erro retonada pela consulta executada mais recentemente. Por exemplo: Last_Errno: 1051 Last_Error: error Unknown table z on query drop table z A mensagem indica que a tabela z existia no mestre e foi apagada l, mas ela a no existe no slave, assim DROP TABLE falhou no servidor. (Isto pode ocorrer se a o usurio esqueceu de copi-la no slave ao congur-lo). a a a A string vazia signica sem erro. Se o valor Last_Error no for vazio, ele a tambm apareceria como uma mensagem no log de erro do slave. Por exemplo: e Skip_Counter O ultimo valor usado por SQL_SLAVE_SKIP_COUNTER. Exec_Master_Log_Pos A posio no log binrio do master (Relay_Master_Log_File) do ultimo evento ca a executado pela thread de SQL. ((Relay_Master_Log_File,Exec_Master_Log_ Pos) no log binrio do master corresponde a (Relay_Log_File, Relay_Log_ a Pos) no relay log). Relay_Log_Space O tamanho total de todos os relay logs existentes. Until_Condition, Until_Log_File, Until_Log_pos O valor especicado na clusula UNTIL da instruo START SLAVE. a ca Until_Condition possui estes valores estes valorer: None se nenhuma clusula UNTIL foi especicada a Master se o slave estiver lendo at uma dada posio no log binrio do e ca a master. Relay se o slave estiver lendo at uma dada posio em seus relay logs e ca Until_Log_File e Until_Log_Pos indicam o nome do arquivo de log e e posio ca que dene o ponto no qual a thread SQL ir parar a execuo. a ca Estes campos esto presentes a partir do MySQL 4.1.1. a Master_SSL_Allowed, Master_SSL_CA_File, Master_SSL_CA_Path, Master_SSL_Cert, Master_SSL_Cipher, Master_SSL_Key Estes campos mostram os parmetros SSL usado pelo slave para se conectar os a master, se existirem.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

409

Master_SSL_Allowed possui estes valores: Yes se uma conexo SSL ao master permitida a e No se uma conexo SSL ao master no permitida a a e Ignored se uma conexo SSL permitida pelo servidor slave no tem suporte a a a SSL habilitado. Os valores dos outros campos correspodem ao valor das opes --master-ca, co --master-capath, --master-cert, --master-cipher, e --master-key. Estes campos esto presentes a partir do MySQL 4.1.1. a Seconds_Behind_Master O nmero de segundos passados desde o ultimo evento do master executado u pela thread salve SQL. Ser NULL quando nenhum evento foi executado ainda, a ou depois de CHANGE MASTER e RESET SLAVE. Esta coluna pode ser usada para saber "quo atrasado est o seu slave". Funcionar mesmo se o seu master e a a a slave no tiverem clocks idnticos. a e Estes campos esto presentes a partir do MySQL 4.1.1. a

4.11.8.8 START SLAVE

START SLAVE [thread_name [, thread_name] ... ] START SLAVE [SQL_THREAD] UNTIL MASTER_LOG_FILE = log_name, MASTER_LOG_POS = log_pos START SLAVE [SQL_THREAD] UNTIL RELAY_LOG_FILE = log_name, RELAY_LOG_POS = log_pos thread_name = IO_THREAD | SQL_THREAD START SLAVE sem nenhuma opo inicia ambas as threads slaves. A thread de E/S lem as ca e consultas do servidor master e as armazena no relay logs. A thread de SQL le o relay log e executa a consulta. Note que se START SLAVE obter sucesso no inicializao da thread slave ca ela retornar sem qualquer erro. Mas mesmo neste caso pode ser que a thread slave iniciou a e parou mais tarde (por que elas no conseguiram se conectar ao master ou leram o seu a log binrio ou qualquer outro problema). START SLAVE no lhe avisar sobre insto. Voc a a a e dever verica seu arquivo log de erro do slave por mensagens de erro gerada pela thread a slave, ou vericar que eles esto rodando bem com SHOW SLAVE STATUS. a A partir do MySQL 4.0.2, voc pode adicionar as opes IO_THREAD ou SQL_THREAD ` e co a instruo a ser chamada quando a thread iniciar. ca A partir do MySQL 4.1.1, uma cusula UNTIL pode ser adicionada para especicar que o a slave deve iniciar at que a thread de SQL alcance um determinado ponto no log binrio dp e a master ou no relay log do slave. Quando a thread SQL alcana este ponto, ela para. Se a c opo SQL_THREAD especicada na instruo, ela inicia apenas a thread de SQL. Seno, ela ca e ca a inicia ambas as threads slaves. Se a thread SQL j estiver em execuo, a clasula UNTIL a ca u e ignorada e um aviso enviado. e Com uma clusula UNTIL, voc deve especicar tanto uma nome de arquivo de log quanto a e uma posio. No misture opes do master e do relay logs. ca a co

410

MySQL Technical Reference for Version 5.0.0-alpha

Qualquer condio UNTIL restaurada por uma instruo STOP SLAVE subsequente, ou uma ca e ca instruo START SLAVE que no incluir a clusula UNTIL, ou um servidor reinicie. ca a a A clusula UNTIL pode ser util para depurar a replicao, ou para fazer com que a replicao a ca ca proceda at um pouco antes do ponto que voc deseja evitar que o slave replique uma e e instruo. Por exemplo, se uma instruo DROP TABLE foi executada no master, voc pode ca ca e usar UNTIL para dizer ao slave para executar at aquele ponto, mas no depois. Para e a encontrar qual o evento, use mysqlbinlog com o log do master ou o relay logs, ou usando e uma instruo SHOW BINLOG EVENTS. ca Se voc estiver usando UNTIL para ter o processo slave replicando consultas nas sees, e co e recomendado que voc inicie o slave com a opo --skip-slave-start para evitar que a e ca thread de SQL execute quando o slave iniciar. E provavelmente melhor usar esta opo ca em um arquivo de opo em vez de us-la na linha de comando, assim uma reinicializao ca a ca inesperada do servidor no faz com que isso seja esquecido. a A instruo SHOW SLAVE STATUS inclui campos na sa que mostram o valor atual da ca ida condio UNTIL. ca Este comando chamado SLAVE START antes do MySQL 4.0.5. No momento, SLAVE START e ainda aceito para compatibilidade com verses anteriores, mas est obsoleto. e o a

4.11.8.9 STOP SLAVE

STOP SLAVE [thread_name [, thread_name] ... ] thread_name = IO_THREAD | SQL_THREAD Para a thread slave. Como o START SLAVE, esta instruo pode ser usada com as opes ca co IO_THREAD e SQL_THREAD para chamar a thread ou threads que iro parar. a Este comando chamado SLAVE STOP antes do MySQL 4.0.5. No momento, SLAVE STOP e ainda aceito para compatibilidade com verses anteriores, mas est obsoleto. e o a

4.11.9 FAQ da Replicao ca

P: Como eu conguro um slave se o master j estiver em execuo e eu no quiser par-lo? a ca a a R: Existem diversas opes. Se voc tirou um backup do master em alguns pontos e gravou co e o nome e oset do log binrio (da sa do SHOW MASTER STATUS) correspondente ` cpia, a ida a o faa o seguinte: c 1. Esteja certo de que o slave possu um ID server unico. i 2. Execute as seguintes instrues no slave, preenchendo os valores apropriados para cada co parmetro: a mysql> CHANGE MASTER TO -> MASTER_HOST=master_host-name, -> MASTER_USER=master_user_name, -> MASTER_PASSWORD=master_pass, -> MASTER_LOG_FILE=recorded_log_name, -> MASTER_LOG_POS=recorded_log_pos; 3. Execute START SLAVE no slave.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

411

Se voc j no tiver um backup do master, aqui est um modo rpido de faz-lo de forma e a a a a e consistente: 1. 2. 3. 4. FLUSH TABLES WITH READ LOCK gtar zcf /tmp/backup.tar.gz /var/lib/mysql ( ou uma variao disto) ca - voc precisar dela mais tarde SHOW MASTER STATUS - esteja certo de gravar a saida e a UNLOCK TABLES

Uma alternativa tirar um dump do SQL do master em vez de uma cpia binria como e o a acima; para isto voc podee usar mysqldump --master-data em seu master e posteriore mente executar este dump SQL em seu slave. Isto , no entanto, mais lento que fazer uma e cpia binria. o a No importa qual dos dois mtodos voc usa, mais tarde siga as instrues para o caso em a e e co que voc tem uma cpia e gravou o nome e oset dos logs Voc pode usar a mesma cpia e o e o para congurar diversos slaves. Uma vez que os logs binrios do master esto intctos, voc a a a e pode esperar por dias ou meses para congurar um slave uma vez que voc possui a cpia e o do master. Em teoria a lacuna de espera pode ser innita. As duas limitaes prticas o co a e espao em disco do master sendo preenchido com logs antigos e a quantidade de tempo que c o slave gastar para busc-los. a a Voc tambm pode usar LOAD DATA FROM MASTER. Este um comando conveniente que tira e e e uma cpia, a restaur no slave e ajustar o nome e oset do log no slave, todos de uma o a vez. No futuro, LOAD DATA FROM MASTER ser o modo recomendado de congurar um slave. a Esteja avisado, no entanto, que o lock de leitura pode ser mantido por um longo tempo se voc usar este comando. Ele ainda no est implementado de forma to eciente quanto e a a a gostariamos. Se voc tiver tabelas grandes, o mtodo prefer neste momento ainda com e e ivel e uma cpia tar local depois de executar FLUSH TABLES WITH READ LOCK. o P: O slave precisa estar conectado ao master o tempo todo? R: No, ele no precisa. O slave pode ser desligado ou permanecer desconectado por horas a a ou mesmo dias, ento reconecta e busca as atualizaes. Por exemplo, voc pode usar uma a co e relao master/slave sobre uma conexo dial-up que est ligada espordicamente apenas por ca a a a um curto per iodo de tempo. A implicao disto que a uma hora dada qualquer no temos ca e a garantias de que o slave est sincronizado com o master a menos que voc tire algumas a e medidas especiais. No futuro, teremos a opo de bloquear o master at que pelo menos ca e um slave esteja sincronizado. P: Como posso saber se um slave est atrasado comparado ao master? Em outra palavras, a como eu sei que o dado da ultima consulta replicada pelo escravo? R: Se o slave for 4.1.1 ou mais novo, leia a coluna Seconds_Behind_Master de SHOW SLAVE STATUS. Para verso mais antigas o seguinte se aplica. Isto s poss se a thread salve de a oe ivel SQL existir (p.ex. se ele for exibida em SHOW PROCESSLIST, veja Seo 4.11.3 [Replication ca Implementation Details], Pgina 381) (no MySQL 3.23: se a thread slave existir, p.ex. a e mostrada em SHOW PROCESSLIST), e se ela executou pelo menos um evento do master. Realmente, quando a thread slave de SQL executa um evento lido do master, esta thread modica seu prprio tempo do timestamp do evento ( por isto que TIMESTAMP bem o e e replicado). Assim indicado na coluna Time na sa de SHOW PROCESSLIST, o nmero de e ida u segundos entre o timestamp do ultimo evento replicado e o tempo real da mquina slave. a Vopc podee usar isto para determinar a data do ultimo evento replicado. Note que se o e

412

MySQL Technical Reference for Version 5.0.0-alpha

seu slave foi desconectado do master por uma hora e ento reconectado, voc poder ver a e a uma vlaor de 3600 na coluna Time para a thread slave de SQL em SHOW PROCESSLIST... Isto ocorreria porque o slave est executando consultas de uma hora atrs. a a P: Como eu foro o master a bloquear as atualizaes at que o slave as busque? c co e R: Use o seguinte procedimento: 1. No master, execute estes comandos: mysql> FLUSH TABLES WITH READ LOCK; mysql> SHOW MASTER STATUS; Grave o nome do log e o oset da sa da instuo SHOW. ida ca 2. No slave, execute este comando, onde as coordenadas da replicao que so os arguca a mentos da funo MASTER_POS_WAIT() so os valores gravados nos passos anteriores: ca a mysql> SELECT MASTER_POS_WAIT(log_name, log_offset); A instruo SELECT ser bloqueada at que o slave alcance o arquivo de log e oset ca a e especicados. Neste ponto, o slave estar em sincronia com o master e a instruo ir a ca a retornar. 3. No master, execute a seguinte instruo para permitir que o master comece a processar ca atualizaes novamente: co mysql> UNLOCK TABLES; P: Sobre quais assuntos eu devo estar ciente ao congurar uma replicao de duas vias? ca R: Atualmente a replicao do MySQL no suporta nenhum protocolo de locking entre ca a master e slave para garantir a atomicidade de uma atualizao distribu (entre servidores). ca ida para um cliente A fazer uma atualizao para um co-master 1, Em outras palavras, possivel e ca e neste tempo, antes de propagar para o co-master 2, o cliente B pode fazer uma atualizao ca para o co-master 2 que far a atualizao do cliente A funcionar diferentemente da que ele a ca fez no co-master 1. Assim, quando a atualizao do cliente A zer a atualizao para o ca ca co-master, ele produzir tabelas que so diferentes daquelas que voc tem no co-master 1, a a e mesmo depois de todas as atualizaes do co-master2 tambm terem sido propagadas. Por co e isso voc no deve co-encadear dois servidores em uma replicao de duas vias, a menos e a ca que voc possa assegurar que suas atualizaes possem seguramente ocorrer em qualquer e co ordem, ou que de alguma forma voc cuide de alguma forma a atualizao fora de ordem e ca no cdigo do cliente. o Voc tambm deve perceber que replicao de duas vias no melhorar em muito o deseme e ca a penho, j que temos atualizaes envolvidas. Ambos os servidores precisam fazer a mesma a co quantidade de atualizaes cada, como se tivesse um servidor. A unica diferena que co c e haver uma pouco menos de conteno de lock, porque as atualizaes originando em outro a ca co servidor sero serializadas em uma thread slave. mesmo assim, este benef pode ser por a icio atrasos de rede. P: Como eu posso usar replicao para melhorar a performance do meu sistema? ca R: Voc devev congurar um servidor como master e direcionar todas as escritas para ele. e Ento congure tantos slaves quantos voc pode comprar e instalar, e distribua as leituras a e entre o master e os slaves. Voc tambm pode iniciar os slaves com --skip-bdb, --lowe e priority-updates e --delay-key-write=ALL para conseguir aumento de velocidade para o slave. Neste caso o slave usar tabelas MyISAM no transacionais em vez de tabelas BDB a a para conseguir mais velocidade.

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

413

Q: O que eu devo fazer para preparar o cdigo do cliente em minhas prprias aplicaes o o co para usar replicao para melhora de performance? ca A: Se a parte do seu cdigo que for responsvel pela acesso ao banco de dados tiver sido o a absta ido/modularizado apropriadamente, converte-lo para executar com uma congurao ca de replicao deve ser bem fcil. Apenas altere a implementao de seu acesso a banco de ca a ca dados para enviar todas as escritas para o master e todas as leituras para o master e o slave. Se o seu cdigo no tiver este n de abstrao, congurar um sistema de replicao lhe o a ivel ca ca dar a oportunidade e motivao de limp-lo. Voc deve iniciar criando uma biblioteca ou a ca a e mdulo wrapper com as seguites funes: o co safe_writer_connect() safe_reader_connect() safe_reader_query() safe_writer_query() safe_ no nome de cada funo signica que a funo cuidar do tratamento de todas as ca ca a condies de erro. co Voc pode, claro, usar diferentes nomes para as funes. O importante ter uma interface e e co e unicada para conexo para leitura, conexo para escrita, fazer uma leitura e fazer uma a a escrita. Voc deve ento converter o cdigo do seu cliente para usar a biblioteca wrapper. Este pode e a o ser um processo doloroso e assustador a princ ipio, mas ser graticante a longo prazo. Todas a as aplicaes que usam a abordagem descrita podero tirar vantagem de uma congurao co a ca master/slave, mesmo envolvendo vrios slaves. O cdigo ser muito mais fcil de manter, e a o a a adicionar opes para solues de problemas ser trivial. Voc s precisar modicar uma co co a e o a ou duas funes, por exemplo, para registrar quanto tempo uma consulta gastou ou qual co consulta, entre todas elas, retornou um erro. Se voc j tiver escrito muito cdigo, voc pode querer automatizar a converso de tarefas e a o e a usando o utilitrio replace, que vem com a distribuio padro do MySQL, ou simplesa ca a mente escrever seu prprio script Perl. Provavelmente, o seu cdigo segue algum padro o o a de reconhecimento. Se no, ento talvez sej melhor reescrev-lo ou pelo menos coloc-lo a a a e a dentro de um padro. a Q: Quando e em quanto a replicao do MySQL pode aumentar a performance do meu ca sistema? A: A replicao do MySQL mais benca para um sistema com leituras frequentes e ca e e escritas infrequentes. Em teoria, usando uma congurao um mastre/vrios slaves voc ca a e pode escalar o sistema adicionando mais slaves at que voc que sem largura de banda na e e rede, ou a sua carga de atualizaes cresa ao ponto que o master no possa trat-la. co c a a Para determinar quantos slaves voc pode ter antes dos beneficios adicionados comearem e c a estabilzar e quanto voc pode melhorar o desempenho do seu site, voc precisa saber o e e padro de suas consultas e determinar empiricamente (pelo benchmark) a ralao entre a a ca taxa nas leituras (leituras por segundo, ou max_reads) e nas escritas (max_writes) em um master e um slave comum. O exemplo aqui lhe mostrar um calculo simplicado do que a voc pode obter com replicao para o nosso sistema hipottico. e ca e Vamos dizer que o sistema de cargas consiste de 10% de escrita e 90% de leitura, e determinamos max_reads para ser 1200 - 2 * max_writes. Em outras palavras, nosso sistema

414

MySQL Technical Reference for Version 5.0.0-alpha

pode fazer 1200 leituras por segundo sem nenhuma escrita, a escrita mdia duas vezes e e mais lenta que a leitura mdia e a realao linear. Vamos supor que o master e cada slave e ca e possuem a mesma capacidade, e temos 1 master e N slaves. Ento temos para cada servidor a (master ou slave): leituras = 1200 - 2 * escritas (a partir do benchmark) leituras = 9* escritas / (N + 1) (as leituras so separadas, mas a escrita deve ir para a todos os servidores) 9*escritas/(N+1) + 2 * escritas = 1200 escritas = 1200/(2 + 9/(N+1) Esta anlise leva as seguintes concluses: a o Se N = 0 (que signica que no temos replicao) nosso sistema pode tratar 1200/11, a ca cerca de 109, escritas por segundos (o que signica que teremos 9 vezes mais leituras devidos a natureza de nossa aplicao) ca Se N = 1, podemos aumentar para 184 escritas por segundos. Se N = 8, conseguimos 400. Se N = 17, 480 escritas. Eventualmente, a medida que N se aproxima de innito (e seu oramento de menos c innito), podemos chegar prximo a 600 escritas por segundo, aumentando o througho put do sistema em cerca de 5,5 vezes. No entanto, com apenas 8 servidores, j o a aumentamos em quase 4 vezes. Note que nossos calculos assumem uma largura de banda de rede innita, e negligencia vrios outros fatores que podiam se tornar signicante em seu sistema. Em muitos casos, a voc pode no conseguir fazer um clculo similar ao acima que ir predizer exatamente o que e a a a acontecer em seus sistema se voc adicionar N slaves de replicao. No entanto, responder a e ca as seguintes questes deve ajud-lo a decidir quando e quanto a replicao aumentar a o a ca a performance do seu sistema: Qual a razo da leitura/escrita no seu sistema? a Quanto mais de carga de escrita um servidor pode tratar se voc reduzir a leitura? e Para quantos slaves voc tem largura de banda disponiovel em sua rede? e ca a P: Como eu posso usar replicao para fornecer redundncia/alta disponibilidade? R: Com os recursos disponiveis atualmente, voc teria que congurar um master e um slave e (ou diversos slaves) e escrever um script que monitoraria o master para ver se ele est no a ar e instruir as suas aplicaes e os slaves do master a alterar no caso de falha. Sugestes: co o Para dizer para um slave para alterar o master, use o comando CHANGE MASTER TO. Um bom modo de manter sua aplicao informadas sobre a localizao do master ca ca e tendo uma entrada DNS dinmica para o master. Com bind voc pode usar nsupdate a e para atualizar dinamicamente o seu DNS. Voc deve executar seus escravos com a opo --log-bin e sem --log-slave-updates. e ca Deste modo o slave estar pronto para se tornar um master assim que voc executar a e STOP SLAVE; RESET MASTER, e CHANGE MASTER TO em outros slaves. Por exemplo, considere que voce tenha a seguinte congurao (M representa o e ca master, S o slave, WC o cliente que faz a leitura e escrita do banco de dados;

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

415

clientes que fazem apenas a leitura do banco de dados bo so representadas j que a a a elas no precisam trocar): a WC \ v WC----> M / | \ / | \ v v v S1 S2 S3 S1 (como S2 e S3) um slave executando com --log-bin e sem --log-slave-updates. e Como as unicas escritas executada em S1 so aquelas replicadas de M, o log binrio em a a S1 empty (lembre-se, que S1 executado sem --log-slave-updates). Ento, por e e a alguma razo, M se torna indispon a ivel, e voc quer que o S1 se torne o novo master e (isto , direciona todos os WC para S1 e faa S2 e S3 replicar em S1). e c Certique-se que todos os slaves processaram aqulquer consulta em seus relay log. Em cada slave, execute STOP SLAVE IO_THREAD, ento verique a sa a ida de SHOW PROCESSLIST at voc ver Has read all relay log. Quando isto ocorrer para todos e e os slaves, eles podem ser recongurados para a nova congurao. Envie STOP SLAVE ca para todos os slaves, RESET MASTER no slave sendo promovido para master, e CHANGE MASTER nos outros slaves. Nenhum WC acessa M. Instru todos os WCs a direcionar as suas consultas para S1. De agora em diante, todas as consultas enviadas por WC para S1 so escritas no log a binrio de S1. O log binrio de S1 contm exatamente todas as consultas de escrita a a e enviada para S1 desde que M foi nalizado. Em S2 (e S3) faa STOP SLAVE, CHANGE c MASTER TO MASTER_HOST=S1 (onde S1 substituido pelo nome de mquina real de e a S1). Para CHANGE MASTER, adicione todas as informaes sobre como conectar a S1 de co S2 ou S3 (usurio, senha, porta). Em CHANGE MASTER, no necessrio especicar o a a e a nome do log binrio de S1 ou a sua posio: ns sabemos que ele o primeiro log a ca o e binrio, na posio 4, e estes so os padres de CHANGE MASTER. Finalmente faa START a ca a o c SLAVE em S2 e S3, e agora voc ter isto: e a WC / | WC | M(indisponvel) i \ | \ | v v S1<--S2 S3 ^ | +-------+ Quando M estiver ativo novamente, voc s precisa enviar a ele o mesmo CHANGE MASTER e o enviado a S2 e S3, assim que M se tornar um slave de S1 e pegar tudo que WC gravou enquando ele estava desativado. Agora para tornarmos M como master novamente (por exemplo, porque ela a melhor mquina), siga os procedimentos como se S1 estivesse e a indisponivel e M fosse o novo master; ento durante o procedimento no esquea d a a c

416

MySQL Technical Reference for Version 5.0.0-alpha

executar RESET MASTER em M antes de tornar S1, S2, S3 como slaves de M ou eles podem buscar escritas antigas de WC, antes da indisponibilidade de M. Atualmente estamos trabalhando na integrao de um sistema de eleio de master autca ca motico dentro do MySQL, mas at que ele esteja pronto, voc ter que criar suas prprias e e a o ferramentas de monitoramento.

4.11.10 Problemas com Replicao ca

Se voc tiver seguido as instrues e suia congurao de replicao no est funcionando, e co ca ca a a primeiro verique o seguinte: Verique as mensagens no log de erros. Muitos usurios perderam tempo por no fazer a a isto cedo o suciente. O master est logando ao log binrio? Verique com SHOW MASTER STATUS. Se estiver, a a Position ser diferente de zero. Se no, verique que deu a opo log-bin do master a a ca e deniu o server-id. O slave est executando? Faa SHOW SLAVE STATUS e verique se os valores Slave_IO_ a c Running e Slave_SQL_Running so ambos Yes. Se no, verique a opo do slave. a a ca Se o slave estiver rodando, ele estabeleceu uma conexo com o master? Faa SHOW a c PROCESSLIST, encontre as threads de E/S e SQL (veja Seo 4.11.3 [Replication Impleca mentation Details], Pgina 381 para ver como exibido), e verique a sua coluna State. a e Se ela disser Connecting to master, verique os privilgios do usurio de replicao e a ca no master, nome de mquina do master, sua congurao de DNS, se o master est a ca a atualmente em execuo e se ele est a alcance do slave. ca a Se o slave estava em execuo antes mas agora parou, a razo que normalmente ca a e algumas consultas que obtem sucesso no master falham no slave. Into nunca deve acontecer se voc tiver tirado a cpia apropriada do master e nunca modicou os dados e o no slave fora da thread slave. Se isto ocorrer, voc encontrou um erro; leia abaixo como e relat-lo. a Se uma consulta bem sucedida no master se recusou a executar no slave, e no parece a prtico fazer um nova sincronizao completa do banco de dados (p.ex.: deletar o banco a ca de dados slave e fazer uma nova cpia do master), tente o seguinte: o Primeiro veja se a tabela do slave estava diferente da do master. Entenda como isto aconteceu (pode ser um erro: leia o registro de alteraes no manual online co do MySQL como http://www.mysql.com/documentation para vericar se este e um erro conhecido e se ele j est corrigido). Ento faa a tabela do slave idntica a a a c e a do master e execute START SLAVE. Se o acima no funcionar ou no se aplica, tente entender se ele estaria seguro a a para fazer uma atualizao manualmente (se necessrio) e ento ignorar a prxima ca a a o consulta do master. Se voc decidiu que voc pode saltar a prxima consulta, execute as seguintes e e o instrues: co mysql> SET GLOBAL SQL_SLAVE_SKIP_COUNTER = n; mysql> START SLAVE;

Cap tulo 4: Administrao do Bancos de Dados MySQL ca

417

O valor de n deve ser 1 se a consulta no usa AUTO_INCREMENT ou LAST_INSERT_ a ID(). Seno, o valor de ser 2. A razo para usarem um valor de 2 para consultas a a que usam AUTO_INCREMENT ou LAST_INSERT_ID() que elas gastam dois eventos e no log binrio do master. a Tenha certeza de que voc no est tendo problemas com um erro antigo atuale a a izando para a verso mais recente. a Se voc tem certeza que o slave iniciou perfeitamente em sincronia com o master, e e que as tabelas envolvidas no foram atualizadas fora da thread slave, relate o a erro.

4.11.11 Relatando Problemas de Replicao ca

Quando voc tiver determinado que no h erro de usurio envolvido, e a replicao ainda e a a a ca no funciona perfeitamente ou est instvel, hora de comear a fazer num relatrio de a a a e c o erros. Ns precisamos do mximo de informaes que voc puder fornecer para conseguirmos o a co e rastrear o bug. Por favor gaste algum tempo e esforo preparando um bom relato de erro. c Se voc tiver uma forma repetit de demonstrar o problema, por favor inclua-o em nosso e ivel banco de dados de bugs http://bugs.mysql.com. Se voc tem um problema de fantasma e (um problema que no pode ser duplicado a sua vontade), use o seguinte procedimento: a 1. Verique se nenhum erro de usurio est envolvido. Por exemplo, se voc atualiza o a a e slave fora da thread slave, os dados podem car fora de sincronia e podem ocorrer violaes de chave unica nas atualizaes. Neste caso a thread slave ir terminar e co co a esperar que voc limpe as tabelas manualmente para entrar em sincronia. Este no e a e um problema de replicao; um problema de interferncia externa que faz com que a ca e e replicao falhe. ca 2. Execute o slave com as opes log-slave-updates e log-bin. Elas faro com que o co a registre todas as atualizaes que ele receber no seu prprio log binrio. co o a 3. Salve todas as evidncias antes de restaurar o estado da replicao. Se no tivermos e ca a nenhuma informao ou apenas algum esboo, ser um pouco mais dif para rastrearca c a icil mos o problema. As evidncias que voc deve coletar so: e e a Todos os logs binrios no master a Todos os logs binrios no slave a A sa de SHOW MASTER STATUS no master na hora que voc descobriu o problema. ida e A sa de SHOW SLAVE STATUS no master na hora que voc descobriu o problema. ida e Logs de erro no master e no slave 4. Utilize mysqlbinlog para examinar os logs binrios. A informao a seguir pode ser a ca util para encontrar a consulta problemtica, por exemplo: a mysqlbinlog -j pos_from_slave_status /caminho/para/log_do_slave | head Uma vez que voc coletou as evidncias do problema fantasma, tente isol-lo em um caso e e a de testes separados inicialmente. Ento relate o problema para http://bugs.mysql.com/ a com a maior quantidade poss iveis de informaes. co

418

MySQL Technical Reference for Version 5.0.0-alpha

5 Otimizao do MySQL ca
Otimizao uma tarefa complicada porque necessita um entendimento do sistema como ca e um todo. Enquanto for poss fazer algumas otimizaes com pequeno conhecimento de ivel co seu sistema ou aplicao, quanto mais otimizado voc desejar que o seu sistema esteja, mais ca e ter que saber sobre ele. a Este cap itulo tentar explicar e fornecer alguns exemplos de diferentes formas de otimizar a o MySQL. Lembre-se, no entanto, que sempre existiro (cada vez mais dif a iceis) formas adicionais de deixar seu sistema mais rpido. a

5.1 Viso Geral da Otimizao a ca

A parte mais importante para obter um sistema rpido com certeza o projeto bsico. Voc a e a e tambm precisa saber quais tipos de coisas seus sistema estar fazendo, e quais so gargalos e a a existentes. Os gargalos mais comuns so: a Pesquisa em disco E necessrio tempo para o disco encontrar uma quantidade de dados. a Com discos modernos em 1999, o tempo mdio para isto era normalmente menor que e 10ms, portanto em teoria poder iamos fazer 100 buscas por segundo. Este tempo melhora moderadamente com discos novos e isso muito dif otimizar para uma unica e icil tabela. A maneira de otimizar isto colocando os dados em mais de um disco. e Leitura de disco/Escrita (I/O) Quando o disco estiver na posio correta precisaremos ca que os dados sejam lidos. Com discos mais modernos em 1999, um disco retorna algo em torno de 10-20Mb/s. Isto mais fcil de otimizar que as buscas porque voc pode e a e ler vrios discos em paralelo. a Ciclos de CPU. Quando tivermos os dados na memria principal (ou se eles j estiverem o a l) precisaremos process-los para conseguir nosso resultado. O fator de limitao mais a a ca comum ter ppequenas tabelas, comparadas com a memria. Mas, com pequenas e o tabelas, normalmente no teremos problemas com velocidade. a Largura de banda da memria. Quando a CPU precisa de mais dados que podem caber o no cache da CPU a largura da banda da memria principal se torna um gargalo. Isto o um gargalo muito incomum para a maioria dos sistema, mas bom estarmos ciente e e dele.

5.1.1 Limitaes do Projeto MySQL/Trocas co

Quando usamos o mecanismos de armazenamento MyISAM, o MySQL utiliza travamento de tabela extremamente rpidos (mltiplas leituras / unica escrita). O maior problema a u com este tipo de tabela ocorre quando voc tem uma mistura do uxo xo de atualizaes e e co selees lentas na mesma tabela. Se isto for um problema com algumas tabelas, voc pode co e usa outro tipo de tabela. Veja Cap ptexi tulo 7 [Tipos de tabela], Pgina 630. a O MySQL pode trabalhar com tabelas transacionais e no transacionais. Para trabalhar a sem problemas com tabelas no transacionais (nas quais no se pode fazer um rollback se a a alguma coisa der errada), o MySQL tem as seguintes regras:

Cap tulo 5: Otimizao do MySQL ca

419

Todas as colunas possuem valor padro. a Se voc inserir um valor errado em uma coluna, como um NULL em uma coluna NOT e NULL ou um valor numrico muito grande em uma coluna numrica, o MySQL denir e e a coluna com o melhor valor poss ivel em vez de dar um erro. Para valores numricos e ou o maior valor poss isto 0, o menor valor possivel e ivel. Para strings into tanto uma e string vazia quanto a maior string poss que possa estar na coluna. ivel Todas as expresses calculadas retornam um valor que pode ser usado em vez de apreo sentar uma condio de erro. Por exemplo, 1/0 retorna NULL ca Para mais informaes sobre isto, veja Veja Seo 1.8.5 [Constraints], Pgina 52. co ca a O mostrado acima quer dizer que no se deve usar o MySQL para vericar o contedo dos a u campos, mas deve se fazer isto no aplicativo.

5.1.2 Portabilidade
Como todos os servidores SQL implementam diferentes partes de SQL, trabalhoso escrever e aplicativos SQL portveis. Para selects/inserts muito simples muito fcil, mas quanto mais a e a recursos voc precisa, mais dif se torna. Se voc quiser uma aplicao quue rpida com e icil e ca e a muitos bancos de dados ela se torna ainda mais dificil. Para fazer um aplicativo portvel complexo voc precisa escolher um nmero de servidores a e u SQL com o qual ele deve trabalhar.

Voc pode utilizar o MySQL programa/web-page crash-me - http://www.mysql.com/information/crashe - para encontrar funes, tipos e limites que voc pode utilizar com uma seleo de co e ca servidores de bancos de dados. O Crash-me agora testa quase tudo poss ivel, mas continua compreens com aproximadamente 450 itens testados. ivel Por exemplo, voc no deve ter nomes de colunas maior do que 18 caracteres se desejar e a utilizar o Informix ou DB2. Os programas de benchmarks e crash-me do MySQL so bastante independentes do bancos a de dados. Dando uma olhada em como ns os tratamos, voc pode sentir o que necessrio o e e a para escrever sua aplicao independente do banco de dados. Os benchmarks podem ser ca encontrados no diretrio sql-bench na distribuio fonte do MySQL. Eles so escritos em o ca a Perl com a interface de banco de dados DBI (que resolve a parte do problema de acesso). Veja http://www.mysql.com/information/benchmarks.html para os resultados deste benchmark. Como pode ser visto nestes resultados, todos os bancos de dados tem alguns pontos fracos. Isto , eles possuem diferentes compromissos de projeto que levam a comportamentos e diferentes. Se voc procura por independencia de banco de dados, precisar ter uma boa idia dos e a e gargalos de cada servidor SQL. O MySQL muito rpido para recuperao e atualizao e a ca ca de dados, mas ter problemas em misturar leituras/escritas lentas na mesma tabela. O a Oracle, por outro lado, possui um grande problema quando voc tentar acessar registros e que foram recentemente atualizados (at eles serem atualizados no disco). Bancos de dados e transacionais geralmente no so muito bons gerando tabelas de resumo das tabelas log, a a nestes casos o travamento de registros praticamente intil. e u

420

MySQL Technical Reference for Version 5.0.0-alpha

Para fazer sua aplicao realmente independente de banco de dados, voc precisar denir ca e a uma interface que possa ser expandida, por meio da qual voc far a manipulao dos dados. e a ca Como o C++ est dispon na maioria dos sistemas, faz sentido utilizar classes C++ para a ivel fazer a interface ao banco de dados. Se voc utilizar algum recurso espec e ico para algum banco de dados (como o comando REPLACE no MySQL), voc deve codicar um mtodo para os outros serviodores SQL para e e implementar o mesmo recurso (mas mais lento). Com o MySQL voc pode utilizar a sintaxe e /*! */ para adicionar palavras chave especicas do MySQL para uma query. O cdigo o dentro de /**/ ser tratado como um comentrio (ignorado) pela maioria dos servidores a a SQL. Se alta performance REAL mais importante que exatido, como em algumas aplicaes e a co WEB, uma possibilidade criar uma camada de aplicao que armazena todos os resultados e ca para lhe fornecer uma performance ainda mais alta. Deixando resultados antigos expirar depois de um tempo, voc pode manter o cache razoavelmente atual. Isto muito bom e e no caso de uma carga extremamente pesada, pois neste caso voc pode aumentar o cache e dinamicamente e congurar o tempo de expirao maior at que as coisas voltem ao normal. ca e Neste caso a informao de criao de tabelas devem conter informaes do tamanho inicial ca ca co do cache e com qual frequncia a tabela, normalmente, deve ser renovada. e

5.1.3 Para que Utilizamos o MySQL?

Durante o desenvolvimento inicial do MySQL, os recursos do MySQL foram desenvolvidos para atender nosso maior cliente. Eles lidam com data warehousing para alguns dos maiores varejistas na Sucia. e De todas as lojas, obtemos resumos semanais de todas as transaes de cartes de bonus e co o esperamos fornecer informaes uteis para ajudar os donos das lojas a descobrir como suas co campanhas publicitrias esto afetando seus clientes. a a Os dados so bem grandes (cerca de 7 milhes de transaes por ms), e armazenamos dados a o co e por cerca de 4-10 anos que precisamos apresentar para os usurios. Recebemos requisies a co semanais dos clientes que desejam ter acesso instantneo aos novos relatrios contendo a o estes dados. Resolvemos este problema armazenando todas informaes mensalmente em tabelas com co transaes compactadas. Temos um conjunto de macros (script) que geram tabelas resumco idas agrupadas por diferentes critrios (grupo de produto, id do cliente, loja...) das tabelas e com transaes. Os relatrios so pginas Web que so geradas dinamicamente por um co o a a a pequeno shell script que analisa uma pgina Web, executa as instrues SQL na mesma e a co insere os resultados. Ns usariamos PHP ou mod perl mas eles no estavam dispon o a iveis na poca. e Para dados gracos escrevemos um ferramenta simples em C que pode produzir GIFs baseados no resultado de uma consulta SQL (com alguns processamentos do resultado). Isto tambm executado dinamicamente a partir do script Perl que analisa os arquivos HTML. e e Na maioria dos casos um novo relatrio pode simplesmente ser feito copiando um script o existente e modicando a consulta SQL no mesmo. Em alguns casos, precisamos adicionar mais campos a uma tabela de resumo existente ou gerar uma nova, mas isto tambm bem e e

Cap tulo 5: Otimizao do MySQL ca

421

simples, pois mantemos todas as tabelas com as transas no disco. (Atualmente possuimos co pelo menos 50G de tabelas com transaes e 200G de outos dados do cliente.) co Ns tambm deixamos nossos clientes acessarem as tabelas sumrias diretamente com o e a ODBC para que os usurios avanados possam tambm fazer experimentar com os dados. a c e Ns no tivemos nenhum problema lidando com isso em um servidor Sun Ultra SPARCo a station (2x200 Mhz) bem modesto. Atualmente atualizamos um de nossos servidores para um UltraSPARC com 2 CPUs de 400 Mhz, e planejamos lidar com transaes no n co ivel de produto, o que pode signicar um aumento de pelo menos dez vezes nosso volume de dados. Acreditamos que podemos lidar com isto apenas adicionando mais disco aos nossos sistemas. Tambm estamos experimentando com Intel-Linux para obter mais poder de CPU por um e melhor preo. Agora que possuimos o formato binrios do bancos de dados portveis (a c a a partir da verso 3.23), comearemos a utiliz-lo para partes da aplicao. a c a ca Nossa sensao inicial que o Linux ir atuar muito melhor em cargas baixas e mdias e o ca e a e Solaris ir atuar melhor quando voc comear a ter uma carga alta pelo uso extremo de IO a e c de disco, mas ainda no temos nada conclusivo sobre isto. Depois de algumas discusses com a o um desenvolvedor do kernel do Linux, conclu imos que isto pode ser um efeito colateral do Linux; alocar muitos recursos para uma tarefa batch que a performance interativa se torna muito baixa. Isto deixa a mquina muito lenta e sem resposta enquanto grandes batches a estiverem em execuo. Esperamos que isto tenha um tratamento melhor em futuras verses ca o do kernel Linux.

5.1.4 O Pacote de Benchmark do MySQL

Esta seo deve conter uma descrio tcnica do pacote de benchmarks do MySQL (e ca ca e crash-me), mas a descrio ainda no est pronta. Atualmente, voc pode ter uma boa ca a a e idia do benchmark vericando os cdigos e resultados no diretrio sql-bench em qualquer e o o distribuio fonte do MySQL. ca Este conjunto de benchmark pretende ser um benchmark que ir dizer a qualquer usurio a a que operaes uma determinada implementao SQL ir realizar bem ou mal. co ca a Note que este benchmark utiliza uma unica thead, portanto ele mede o tempo m inimo para as operaes realizadas. Planejamos adicionar vrios testes multi-threaded no conjunto de co a benchmark no futuro. A seguinte tabela mostra alguns resultados comparativos de benchmark para diversos servidores de bancos de dados quando acessados por meio do ODBC em uma mquina Windows a NT 4.0. Lendo 2000000 linhas por indice SegundosSegundos mysql 367 249 mysql odbc 464 db2 odbc 1206 informix odbc 121126 ms-sql odbc 1634 20800 oracle odbc solid odbc 877 sybase odbc 17614

422

MySQL Technical Reference for Version 5.0.0-alpha

Inserindo 350768 linhas mysql mysql odbc db2 odbc informix odbc ms-sql odbc oracle odbc solid odbc sybase odbc

SegundosSegundos 381 206 619 3460 2692 4012 11291 1801 4802

Para os testes anteriores, o MySQL foi executado com um cache de indices de 8M.

Temos concentrado alguns resultados de benchmarks em http://www.mysql.com/information/benchmark Perceba que a Oracle no est inclu porque eles solicitaram a remoo. Todos bencha a ida ca marks Oracle devem ser aprovados pela Oracle! Acreditamos que os benchmarks da Oracle so MUITO tendecioso pois os benchmarks acima devem ser executados supostamente para a uma instalao padro para um unico cliente. ca a Para executar a suite de benchmarks, as seguintes exigncias devem ser satisfeitas: e O pacote de benchamark fornecido com a distribuio fonte do MySQL, assim voc e ca e deve ter uma distribuio fonte. Voc tambm pode fazer um download de uma disca e e tribuio em http://www.mysql.com/downloads/, ou usar a rvore fonte de desenca a volvimento atual. (veja Seo 2.3.4 [Installing source tree], Pgina 100). ca a Os scripts do benchmark so escritos em Perl e usam o mdulo Perl DBI para acessar o a o servidor de banco de dados, assim o DBI deve estar instalado. Voc tambm precisar e e a do driver DBD espercico do servidor para cada um dos servidores que voc quer testar. e Por exemplo, para testar o MySQL, PostgreSQL, e DB2, os mdulos DBD::mysql, o DBD::Pg e DBD::DB2 devem estar instalados. O pacote de benchmark est localizado no diretrio sql-bench da distribio fonte do a o ca MySQL. Para executar o teste de benchmark, altera a localizao dentro daquele diretrio ca o e execute o script run-all-tests: shell> cd sql-bench shell> perl run-all-tests --server=server_name server_name um dos servidores suportados. Voc pode obter uma lista de todos e e parmetros e servidores suportados executando run-all-tests --help. a crash-me tenta determinar quais recursos um banco de dados suporta e quais suas capacidades e limitaes atuais para a execuo de consultas. Por exemplo, ele determina: co ca Quais tipos de colunas so suportados a Quantos indices so suportados a Quais funes so suportadas co a Qual o tamanho mximo de uma query a Qual o tamanho mximo de um registro do tipo VARCHAR a Podemos encontrar o resultado do crash-me para diversos bancos de dados em http://www.mysql.com/information/crash-me.php.

Cap tulo 5: Otimizao do MySQL ca

423

5.1.5 Utilizando seus Prprios Benchmarks o

Denitivamente voc deve fazer benchmarks de sua aplicao e banco de dados para saber e ca quais so os gargalos. Corrigindo (ou substituindo o gargalho com um mdulo burro) a o voc pode facilmente identicar o prximo gargalo (e continuar). Mesmo se a performance e o geral para sua aplicao atualmente aceitvel, voc deve pelo menos criar um plano para ca e a e cada gargalo e decidir como resolv-lo se algum dia voc precisar de performance extra. e e Para um exemplo de programas de benchmarks portveis, consulte o conjunto de bencha marks do MySQL. Veja Seo 5.1.4 [Benchmarks do MySQL], Pgina 421. Voc pode pegar ca a e qualquer programa deste conjunto e modic-lo para suas necessidades. Fazendo isto voc a e pode tentar solues diferentes para seu problema e testar qual a mais rpida para voc. co e a e Outro pacote de benchmark grtis o Open Source Database Benchmark dispon a e ivel em http://osdb.sourceforge.net/. E muito comum que um problemas ocorram apenas quando o sistema estiver muito carregado. Ns tivemos alguns clientes que nos contactaram quando eles testaram um sistema o em produo e encontraram problemas de carga. Na maioria dos casos, problemas de deca sempenho ocorrem devido a assuntos relacionados ao projeto bsico do banco de dados a (busca em tabelas n~o s~o bons com alta carga) ou problemas com o sistema operacional e a a de bibliotecaa. A maioria das vezes, estes problemas seriam MUITO mais fceis de resolver a se os sistemas j no estivessem em uso. a a Para evitar problemas deste tipo, voc deve colocar algum esforo em e c testar a performance de toda sua aplicao sobre a pior carga poss ca ivel! Voc pode utilizar o Super Smack para isto. e Ele est dispon a ivel em: http://www.mysql.com/Downloads/super-smack/super-smack-1.0.tar.gz. Como o nome sugere, ele pode derrubar seu sistema se voc solicitar, portanto, utilize-o e somente em sistemas de desenvolvimento.

5.2 Otimizando SELECTs e Outras Consultas

Primeiramente, uma coisa que afeta todas as consultas: Quanto mais complexo seu sistema de permisses, maior a sobrecarga. o Se voc no tiver nenhuma instruo GRANT realizada, MySQL otmizar a vericao de e a ca a ca permisses de alguma forma. Dessa forma, se voc possui um volume muito alto, o tempo o e pode piorar tentando permitir o acesso. Por outro lado, maior vericao de permisses ca o resulta em uma sobrecarga maior. Se o seu problema com alguma funo expl e ca icita do MySQL, voc pode sempre consultar e o tempo da mesma com o cliente MySQL: mysql> SELECT BENCHMARK(1000000,1+1); +------------------------+ | BENCHMARK(1000000,1+1) | +------------------------+ | 0 | +------------------------+ 1 row in set (0.32 sec)

424

MySQL Technical Reference for Version 5.0.0-alpha

O exemplo acima demonstra que o MySQL pode excutar 1.000.000 expresses + em 0.32 o segundos em um PentiumII 400MHz. Todas funes MySQL devem ser bem otimizadas, mas existem algumas excesses e o co o benchmark(loop_count,expression) uma tima ferramenta para saber se existe um e o problema com sua query.

5.2.1 Sintaxe de EXPLAIN (Obter informaoes sobre uma SELECT) c

ou EXPLAIN nome_tabela EXPLAIN SELECT op~es_select co

EXPLAIN nome_tabela um sinnimo para DESCRIBE nome_tabela ou SHOW COLUMNS FROM e o nome_tabela. Quando uma instruo SELECT for precedida da palavra chave EXPLAIN, o MySQL explicar ca a como ele deve processar a SELECT, fornecendo informao sobre como as tabelas esto sendo ca a unidas e em qual ordem. Com a ajuda de EXPLAIN, voc pode ver quando devem ser adicionados e indices ` tabelas a para obter uma SELECT mais rpida que utiliza a indices para encontrar os registros. Voce deve executar frequentemente ANALYZE TABLE para atualizar estat isticas de tabela tais como a cardinalidade das chaves que podem afetar a escolha que o otimizador faz. Veja Seo 4.6.2 [ANALYZE TABLE], Pgina 298. ca a Voc tambm pode ver se o otimizador une as tabelas em uma melhor ordem. Para forar e e c o otimizador a utilizar uma ordem espec ica de join para uma instruo SELECT, adicione ca uma clusula STRAIGHT_JOIN. a Para ligaes mais complexas, EXPLAIN retorna uma linha de informao para cada tabela co ca utilizada na instruo SELECT. As tabelas so listadas na ordem que seriam lidas. O MySQL ca a soluciona todas as joins utilizando um mtodo multi-join de varedura simples. Isto signica e que o MySQL l uma linha da primeira tabela, depois encontra uma linha que combina na e segunda tabela, depois na terceira tabela e continua. Quando todas tabelas so processadas, a ele exibe as colunas selecionadas e recua atravs da lista de tabelas at uma tabela na qual e e existem registros coincidentes for encontrada. O prximo registro lido desta tabela e o o e processo continua com a prxima tabela. o No MySQL verso 4.1 a sa do EXPLAIN foi alterada para funcionar melhor com cona ida strues como UNIONs, subqueries e tabelas derivadas. A mais notvel a adio de duas co a e ca novas colunas: id e select_type. A sa de EXPLAIN inclui as seguintes colunas: ida id Identicador SELECT, o nmero sequncial desta SELECT dentro da consulta. u e

select_type Tipo de clusula SELECT, que pode ser uma das seguintes: a SIMPLE PRIMARY UNION SELECT simples (sem UNIONs ou subqueries). SELECT mais externa. Segunda SELECT e as SELECTs posteriores do UNION

Cap tulo 5: Otimizao do MySQL ca

425

DEPENDENT UNION Seunda SELECT e SELECTs posteriores do UNION, dependente da subquery exterior. SUBQUERY Primeiro SELECT na subquery. DEPENDENT SUBQUERY Primeiro SELECT, dependente da subquery exterior. DERIVED table type SELECT de tabela derivada (subquery na clusula FROM). a A tabela para a qual a linha de sa se refere. ida O tipo de join. Os diferentes tipos de joins so listados aqui, ordenados do a melhor para o pior tipo: system const A tabela s tem uma linha (= tabela de sistema). Este um caso o e especial do tipo de join const. A tabela tm no mximo um registro coincidente, o qual ser lido e a a na inicializao da consulta. Como s h um registro, os valores da ca o a coluna neste registro podem ser considerados constantes pelo resto do otimizador. Tabelas const so muito rpidas e so lidas apenas a a a uma vez! const usado quando voc compara todas as partes de uma chave e e PRIMARY/UNIQUE com restries: co SELECT * FROM const_table WHERE primary_key=1; SELECT * FROM const_table WHERE primary_key_part1=1 AND primary_key_part2=2; eq_ref Uma linha ser lida desta tabela para cada combinao de linhas a ca da tabela anterior. Este o melhor tipo de join depois dos tipos e const. E usado quando todas as partes do indice so usados pela a join e o indice unico (UNIQUE) ou uma chave primria (PRIMARY ee a KEY). eq_ref pode ser usado para coluna indexadas que comparada e com o\ operador =. O item comparado pode ser uma constante ou uma expresso que usa colunas de tabelas que so lidas antes desta a a tabela. Nos seguintes examplos, ref_table poder usar eq_ref a SELECT * FROM ref_table,other_table WHERE ref_table.key_column=other_table.column; SELECT * FROM ref_table,other_table WHERE ref_table.key_column_part1=other_table.column AND ref_table.key_column_part2=1; Todas as colunas com valores de indices correspondentes sero lidos a desta tabela para cada combinao de registros da tabela anterior. ca ref usado se o join usa apenas o prexo mais a esquerda da e

ref

426

MySQL Technical Reference for Version 5.0.0-alpha

chave, ou se a chave no unica (UNIQUE) ou uma chave primria a e a (PRIMARY KEY) (em outras palavras, se a join no puder selecionar a um unico registro baseado no valor da chave). Se a chave que e usada coincide apenas em alguns registros, este tipo de join bom. e ref pode ser usado para colunas indexadas que so comparadas a com o operador =. Nos seguintes exemplos, ref_table poder usar ref a SELECT * FROM ref_table WHERE key_column=expr; SELECT * FROM ref_table,other_table WHERE ref_table.key_column=other_table.column; SELECT * FROM ref_table,other_table WHERE ref_table.key_column_part1=other_table.column AND ref_table.key_column_part2=1; ref_or_null Como ref, mas com o adicional que faremos uma busca extra para linhas com NULL. Veja Seo 5.2.5 [IS NULL optimization], ca Pgina 434. a Esta otimizao do tipo join nova para o MySQL 4.1.1 e mais ca e e usada na resoluo de sub queries. ca range Apenas registros que esto numa dada faixa sero retornados, usa a ando um indice para selecionar os registros. A coluna key indica qual indice usado. key_len contm a maior parte da chave que e e foi usada. A coluna ref ser NULL para este tipo. a range pode ser usado para quando uma coluna de chave come parada a uma constante com =, <>, >, >=, <, <=, IS NULL, <=>, BETWEEN e IN. SELECT * FROM range_table WHERE key_column = 10; SELECT * FROM range_table WHERE key_column BETWEEN 10 and 20; SELECT * FROM range_table WHERE key_column IN (10,20,30);

SELECT * FROM ref_table WHERE key_column=expr OR key_column IS N

SELECT * FROM range_table WHERE key_part1= 10 and key_part2 IN ( index Isto o mesmo que ALL, exceto que apenas a rvore de e a indice e varrida. Isto normalmente mais rpido que ALL, j que o arquivo e a a de indice normalmente menor que o arquivo de dados. e Ele pode ser usado quando a consulta s usa colunas que so parte o a de um indice. ALL Ser feita uma varredura completa da tabela para cada combinao a ca de registros da tabela anterior. Isto normalmente no bom se a a e

Cap tulo 5: Otimizao do MySQL ca

427

tabela a primeiro tabela no marcada como const, e normalmente e a muito ruim em todos os casos ordenados. Voc normalmente pode e ebitar ALL adicionando mais indices, assim o registro pode ser retornado baseado em valores constantes ou valores de colunas de tabelas anteriores. possible_keys A coluna possible_keys indica quais indices o MySQL pode utilizar para encontrar os registros nesta tabela. Note que esta coluna totalmente indepene dente da ordem das tabelas. Isto signica que algumas das chaves em possible_ keys podem no ser usadas na prtica com a ordem de tabela gerada. a a Se esta coluna for NULL, no existem a indices relevantes. Neste caso, voc poder e a melhora a performance de sua query examinando a clusula WHERE para ver se a ela refere a alguma coluna ou colunas que podem ser indexadas. Se for verdade, crie um indice apropriado e conra a consulta com EXPLAIN novamente. Veja Seo 6.5.4 [ALTER TABLE], Pgina 608. ca a Para ver os indices existentes em uma tabela, utilize SHOW INDEX FROM nome_ tabela. key A coluna key indica a chave ( indice) que o MySQL decidiu usar. A chave ser NULL se nenhum indice for escolhido. Para forar o MySQL a usar um a c indice listado na coluna possible_keys, use USE INDEX/IGNORE INDEX em sua consulta. Veja Seo 6.4.1 [SELECT], Pgina 562. ca a Executando myisamchk --analyze (veja Seo 4.5.6.1 [sintaxe do myisamchk], ca Pgina 281) ou ANALYSE TABLE (veja Seo 4.6.2 [ANALYZE TABLE], Pgina 298) a ca a na tabela tambm ajudar o otimizador a escolher indices melhores. e a key_len A coluna key_len indica o tamanho da chave que o MySQL decidiu utilizar. O tamanho ser NULL se key for NULL. Note que isto nos diz quantas partes de a uma chave multi-partes o MySQL realmente est utilizando. a A coluna ref exibe quais colunas ou contantes so usadas com a key para a selecionar registros da tabela. A coluna rows informa o nmero de linhas que o MySQL deve examinar para u executar a consulta. Esta coluna contem informaes adicionais de como o MySQL ir resolver a co a consulta. A seguir uma explicao das diferentes strings de texto que podem ca ser encontradas nesta coluna: Distinct O MySQL no continuar a procurar por mais registros para a a a combinao de registro atual depois de ter encontrado o primeiro ca registro coincidente. O MySQL estava apto a fazer uma otimizao LEFT JOIN na conca sulta e no examinar mais registros nesta tabela para a coma a binao do registro anterior depois que encontrar um registro que ca satisfaa o critrio do LEFT JOIN. c e Exemplo:

ref rows Extra

Not exists

428

MySQL Technical Reference for Version 5.0.0-alpha

SELECT * FROM t1 LEFT JOIN t2 ON t1.id=t2.id WHERE t2.id IS NULL; Assume que t2.id denido com NOT NULL. Neste caso o MySQL e ir percorrer t1 e procurar pelos registros em t2 atravs de t1.id. a e Se o MySQL encontrar um registro combinando em t2, ele sabe que t2.id nunca poder ser NULL e no ir percorrer at o resto dos rega a e istros em t2 que possuirem o mesmo id. Em outras palavras, para cada registro em t1 o MySQL s precisa fazer uma unica pesquisa o em t2, independente de quantos registros coincidentes existirem em t2. range checked for each record (index map: #) O MySQL no encontrou um bom a indice para usar. No lugar, ele ir fazer uma vericao sobre qual a ca indice usar (se existir) para cada combinao das tabelas precedentes, e usar este ca a indice para recuperar os registros da tabela. Isto no muito rpido mas a e a e mais rpido que fazer um join sem um a indice. Using filesort O MySQL precisar fazer uma passada extra para descobrir como a recuperar os registros na ordem de classicao. A classicao ca ca e feita indo atravs de todos os registros de acordo com join type e e armazenar a chave de ordenao mais o ponteiro para o registro ca para todos os registros que combinarem com o WHERE. Ento as a chaves so classicadas. Finalmente os registros so recuperados a a na ordem de classicao. ca Using index A informao da coluna recuperada da tabela utilizando somente ca e informaes na rvore de co a indices sem ter que fazer uma pesquisa adicional para ler o registro atual. Isto pode ser feito quando todas as colunas usadas para a tabela zerem parte do mesmo indice. Using temporary Para resolver a consulta, o MySQL precisar criar uma tabela tema porria para armazenar o resultado. Isto acontece normalmente se a voc zer um ORDER BY em um conjunto de colunas diferentes das e quais voc fez um GROUP BY. e Using where Uma clusula WHERE ser utilizada para restringir quais registros a a sero combinados com a prxima tabela ou enviar para o cliente. a o se voc no possui esta informao e a tabela do tipo ALL ou e a ca e index, pode existir alguma coisa errada na sua query (Se voc no e a pretender examinar todos os registros da tabela). Se voc desejar deixar suas consultas o mais rpido poss e a ivel, voc deve dar uma e olhada em Using filesort e Using temporary. Voc pode ter uma boa indicao de quo boa sua join multiplicando todos os valores e ca a e de EXPLAIN. Isto deve dizer a grosso modo quantos registros o na coluna rows na saida

Cap tulo 5: Otimizao do MySQL ca

429

MySQL deve examinar para executar a consulta. Este nmero tambm usado quando u e e voc restringe consultas com a varivel max_join_size. Veja Seo 5.5.2 [Parmetros de e a ca a servidor], Pgina 454. a O exemplo a seguir mostra como um JOIN pode ser otimizado progressivamente utilizando a informao fornecida por EXPLAIN. ca Suponha que voc tem a instruo SELECT exibida abaixo, que voc est examinando utie ca e a lizando EXPLAIN: EXPLAIN SELECT tt.TicketNumber, tt.TimeIn, tt.ProjectReference, tt.EstimatedShipDate, tt.ActualShipDate, tt.ClientID, tt.ServiceCodes, tt.RepetitiveID, tt.CurrentProcess, tt.CurrentDPPerson, tt.RecordVolume, tt.DPPrinted, et.COUNTRY, et_1.COUNTRY, do.CUSTNAME FROM tt, et, et AS et_1, do WHERE tt.SubmitTime IS NULL AND tt.ActualPC = et.EMPLOYID AND tt.AssignedPC = et_1.EMPLOYID AND tt.ClientID = do.CUSTNMBR; Para este exemplo, assuma que: As colunas comparadas foram declaradas como a seguir: Tabela Coluna Tipo da coluna tt ActualPC CHAR(10) tt AssignedPC CHAR(10) tt ClientID CHAR(10) et EMPLOYID CHAR(15) do CUSTNMBR CHAR(15) As tabelas possuem os indices mostrados abaixo: Tabela Indice tt ActualPC tt AssignedPC tt ClientID et EMPLOYID (chave primria) a do CUSTNMBR (chave primria) a The tt.ActualPC values arent evenly distributed. Initially, before any optimizations have been performed, the EXPLAIN statement produces the following information: table type possible_keys key key_len ref rows Extra et ALL PRIMARY NULL NULL NULL 74 do ALL PRIMARY NULL NULL NULL 2135 et_1 ALL PRIMARY NULL NULL NULL 74 tt ALL AssignedPC,ClientID,ActualPC NULL NULL NULL 3872

430

MySQL Technical Reference for Version 5.0.0-alpha

range checked for each record (key map: 35) Como o tipo ALL em todas tabelas, esta sa indica que o MySQL est gerando um e ida a produto Cartesiano de todas as tabelas! Isto levar muito tempo para ser executado, pois a o produto do nmero de registros em cada tabela deve ser examinado ! Neste caso, existem u 74 * 2135 * 74 * 3872 registros. Se as tabelas forem maiores, imagine quanto tempo este tipo de consulta pode demorar. Um dos problemas aqui que o MySQL no pode (ainda) utilizar e a indices em colunas de maneira eciente se elas foram declaras ide forma diferente. Neste contexto, VARCHAR e CHAR so o mesmo a menos que tenham sido declarados com tamanhos diferentes. Como a tt.ActualPC declarado como CHAR(10) e et.EMPLOYID declarado como CHAR(15), existe e e aqui uma diferena de tamanho. c Para corrigir esta diferena entre tamanhos de registros, utilize ALTER TABLE para alterar o c tamanho de ActualPC de 10 para 15 caracteres: mysql> ALTER TABLE tt MODIFY ActualPC VARCHAR(15); Agora ambos campos tt.ActualPC e et.EMPLOYID so VARCHAR(15). Executando a ina struo EXPLAIN novamente produzir este resultado: ca a table type possible_keys key key_len ref rows Extra tt ALL AssignedPC,ClientID,ActualPC NULL NULL NULL 3872 Using where do ALL PRIMARY NULL NULL NULL 2135 range checked for each record (key map: 1) et_1 ALL PRIMARY NULL NULL NULL 74 range checked for each record (key map: 1) et eq_ref PRIMARY PRIMARY 15 tt.ActualPC 1 Isto no est perfeito, mas est bem melhor ( o produto dos valores de rows agora menor a a a por um fator de 74 ). Esta verso executada em vrios segundos. a e a Uma segunda alterao pode ser feita para eliminar as diferenas de tamanho das colunas ca c para as comparaes tt.AssignedPC = et_1.EMPLOYID e tt.ClientID = do.CUSTNMBR : co mysql> ALTER TABLE tt MODIFY AssignedPC VARCHAR(15), -> MODIFY ClientID VARCHAR(15); Agora EXPLAIN produz a sa mostrada abaixo: ida table type possible_keys key key_len ref rows Extra et ALL PRIMARY NULL NULL NULL 74 tt ref AssignedPC, ActualPC 15 et.EMPLOYID 52 Using where ClientID, ActualPC et_1 eq_ref PRIMARY PRIMARY 15 tt.AssignedPC 1 do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1 Este resultado quase o melhor que se pode obter. e O problema restante que, por padro, o MySQL assume que valores na coluna e a tt.ActualPC esto distribu a idos igualmente, e este no o caso para a tabela tt. a e Felizmente, fcil informar ao MySQL sobre isto: e a shell> myisamchk --analyze PATH_TO_MYSQL_DATABASE/tt shell> mysqladmin refresh Agora a join est perfeita, e EXPLAIN produz esta sa a ida:

Cap tulo 5: Otimizao do MySQL ca

431

possible_keys key key_len ref rows Extra AssignedPC NULL NULL NULL 3872 Using where ClientID, ActualPC et eq_ref PRIMARY PRIMARY 15 tt.ActualPC 1 et_1 eq_ref PRIMARY PRIMARY 15 tt.AssignedPC 1 do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1 Perceba que a coluna rows na sa de EXPLAIN uma boa ajuda para otimizador de joins ida e do MySQL. Para otimizar uma consulta, voc deve conferir se os nmeros esto perto da e u a realidade. Se no, voc pode obter melhor desempenho utilizando STRAIGHT_JOIN em sua a e instruo SELECT e tentar listar as tabelas em uma ordem diferente na clusula FROM. ca a

table type tt ALL

5.2.2 Estimando o Desempenho de uma Consulta

Na maioria dos casos voc pode estimar a performance contando buscas em disco. Para e tabelas pequenas, normalmente voc pode encontrar o registro com 1 pesquisa em disco e (uma vez que o indice provavelmente est no cache). Par tabelas maiores, voc pode estia e mar (usando ind de arvores B++) que voc precisar de: log(row_count) / log(index_ ices e a block_length / 3 * 2 / (index_length + data_pointer_length)) + 1 buscas em disco para encontrar um registro. No MySQL um bloco de indice tem geralmente 1024 bytes e o ponteiro de dados 4 bytes. Uma tabela de 500.000 registros com um indice com tamanho de 3 (inteiro mdio) lhe d: e a log(500,000)/log(1024/3*2/(3+4)) + 1 = 4 pesquisas. Como o indice acima necessita cerca de 500,000 * 7 * 3/2 = 5.2M, (assumindo que os buers de indices so carregados at 2/3, que o normal) voc provavelmente ter grande parte a e e e a dos indices em memria e provavelmente precisar somente de 1 ou 2 chamadas para ler o a dados do SO para encontrar o registro. Entretanto, para escritas, voc precisar utilizar 4 requisies para encontrar onde posie a co cionar o novo indice e normalmente 2 buscas para atualizar o indice e escrever o registro. Perceba que o que foi dito acima no signica que sua aplicao perder performance por N a ca a log N! Como tudo armazenado no cache de seu SO ou do servidor SQL as coisas comearo e c a a car um pouco mais lentas quando as tabelas comearem a crescer. Quando os dados se c tornam muito grandes para o cache, as coisas comearo a car bem mais lentas at que suas c a e aplicaes estejam limitadas a buscas em disco (o que aumenta em N log N). Para evitar co isto, aumente o cache de indice quando os dados crescerem. Veja Seo 5.5.2 [Parmetros ca a do servidor], Pgina 454. a

5.2.3 Velocidade das Consultas que Utilizam SELECT

Em geral, quando voc desejar tornar uma consulta lenta SELECT ... WHERE mais rpida, e a a primeira coisa que deve ser conferida se voc pode ou no adicionar um e e a indice. Veja Seo 5.4.3 [ ca indices MySQL], Pgina 447. Todas as referncias entre diferentes tabelas a e devem ser feitas normalmente com indices. Voc pode utilizar o comando EXPLAIN para dee terminas quais indices so usados para uma SELECT. Veja Seo 5.2.1 [EXPLAIN], Pgina 424. a ca a Algumas dicas gerais:

432

MySQL Technical Reference for Version 5.0.0-alpha

Para ajudar o MySQL a otimizar melhor as consultas, execute myisamchk --analyze em uma tabela depois dela ter sido carregada com dados relevantes. Isto atualiza um valor para cada parte do indice que indica o nmero mdio de registros que tem o u e mesmo valor. (Para indices unicos, isto sempre 1, claro). O MySQL usar isto e e a para decidir qual indice escolher quando voc conectar duas tabelas utilizando uma e expresso no constante. Os resultados de analyze podem ser conferidos utilizando a a SHOW INDEX FROM nome_tabela e examindo a coluna Cardinality. Para ordenar um indice e dados de acordo com um indice, utilize myisamchk --sortindex --sort-records=1 (se voc deseja ordenar pelo e indice 1). Se voc possui um e indice unico no qual deseja ler todos registros na ordem do indice, esta uma boa forma e para torn-lo mais rpido. Perceba entretanto, que esta ordenao no foi escrita de a a ca a maneira otimizada e levar muito tempo em tabelas grandes! a

5.2.4 Como o MySQL Otimiza Clusulas WHERE a

As otimizaes WHERE so colocadas aqui na parte da SELECT porque normalmente elas co a so usadas com SELECT, mas as mesmas otimizaes aplicam-se para WHERE em instrues a co co DELETE e UPDATE. Note tambm que esta seo est incompleta. O MySQL faz vrias otimizaes e ainda no e ca a a co a tivemos tempo para documentarmos todas elas. Algumas das otimizaes feitas pelo MySQL so so listadas abaixo: co a a Remoo de parnteses desnecessrios: ca e a ((a AND b) AND c OR (((a AND b) AND (c AND d)))) -> (a AND b AND c) OR (a AND b AND c AND d) Enlaos de constantes: c (a<b AND b=c) AND a=5 -> b>5 AND b=c AND a=5 Remoo de condies contantes (necessrio por causa dos enlaos de contantes): ca co a c (B>=5 AND B=5) OR (B=6 AND 5=5) OR (B=7 AND 5=6) -> B=5 OR B=6 Expresses constantes utilizadas por o indices so avaliadas somente uma vez. a COUNT(*) em uma unica tabela sem um WHERE recuperado diretamente da informao e ca da tabela dos tipos MyISAM e HEAP. Isto tambm feito para qualquer expresso NOT e e a NULL quando usada somente com uma tabela. Pr deteco de expresses contantes invlidas. O MySQL detecta rapidamente que e ca o a algumas instrues SELECT so imposs co a iveis e no retornar registros. a a HAVING fundido com WHERE se no for utilizado GROUP BY ou funes de agrupamento e a co (COUNT(), MIN()...). Para cada sub-join, um WHERE mais simples constru para obter uma avaliao mais e ido ca rpida de WHERE para cada sub-join e tambm para saltar registros da maneira mais a e rpida poss a ivel. Todas tabelas constantes so lidas primeiro, antes de qualquer tabelas na consulta. a Uma tabela constante : e

Cap tulo 5: Otimizao do MySQL ca

433

Uma tabela vazia ou uma tabela com 1 registro. Uma tabela que usada com uma clusula WHERE em um e a indice UNIQUE, ou uma PRIMARY KEY, onde todas as partes do indice so usadas com expresses constantes a o e as partes do indice so denidas como NOT NULL. a Todas as tabelas seguintes so usadas como tabelas constantes: a mysql> SELECT * FROM t WHERE primary_key=1; mysql> SELECT * FROM t1,t2 -> WHERE t1.primary_key=1 AND t2.primary_key=t1.id; A melhor combinao de join para unir as tabelas encontrada tentando todas as ca e possibilidades. Se todas colunas em ORDER BY e em GROUP BY vierem da mesma tabela, ento esta tabela ser preferencialmente a primeira na unio. a a a Se existerem uma clusula ORDER BY e uma GROUP BY diferente, ou se a ORDER BY ou a GROUP BY conterem colunas de tabelas diferentes da primeira tabela na la de join, uma tabela temporria ser criada. a a Se voc utilizar SQL_SMALL_RESULT, o MySQL usar a tabela temporria em memria. e a a o Cada indice de tabela consultado e o melhor e indice que cobrir menos de 30% dos registros usado. Se nenhum e indice for encontrado, uma varredura rpida feita pela a e tabela. Em alguns casos, o MySQL pode ler registros do indice mesmo sem consultar o arquivo de dados. Se todas colunas usadas do indice so numricas, ento somente a rvore de a e a a indice usada para resolver a consulta. e Antes de dar sa em cada registro, aqueles que no combinam com a clusula HAVING ida a a so ignorados. a

Some examples of queries that are very fast: mysql> SELECT COUNT(*) FROM tbl_name; mysql> SELECT MIN(key_part1),MAX(key_part1) FROM tbl_name; mysql> SELECT MAX(key_part2) FROM tbl_name -> WHERE key_part_1=constant; mysql> SELECT ... FROM tbl_name -> ORDER BY key_part1,key_part2,... LIMIT 10; mysql> SELECT ... FROM tbl_name -> ORDER BY key_part1 DESC,key_part2 DESC,... LIMIT 10; As seguintes consultas so resolvidas utilizando somente a rvore de a a indices (assumindo que as colunas indexadas so numricas): a e mysql> SELECT key_part1,key_part2 FROM tbl_name WHERE key_part1=val; mysql> SELECT COUNT(*) FROM tbl_name -> WHERE key_part1=val1 AND key_part2=val2; mysql> SELECT key_part2 FROM tbl_name GROUP BY key_part1; As consultas a seguir utilizam indexao para recuperar os registros na ordem de classica cao sem um passo de ordenao separado: ca ca mysql> SELECT ... FROM tbl_name -> ORDER BY key_part1,key_part2,... ; mysql> SELECT ... FROM tbl_name -> ORDER BY key_part1 DESC,key_part2 DESC,... ;

434

MySQL Technical Reference for Version 5.0.0-alpha

5.2.5 Como o MySQL Otimiza IS NULL

O MySQL pode fazer a mesma otimizao em column IS NULL que ele pode com column = ca constant_value. Por exemplos, o MySQL pode usar indices e faixas para buscar por NULL com IS NULL. SELECT * FROM table_name WHERE key_col IS NULL; SELECT * FROM table_name WHERE key_col <=> NULL; SELECT * FROM table_name WHERE key_col=# OR key_col=# OR key_col IS NULL Se voc usa column_name IS NULL em um NOT NULL em uma clusula WHERE na tabela e a que no usada no OUTER JOIN, esta espresso ser otimizada de qualquer forma. a e a a O MySQL 4.1. pode adicionalmente otimizar a combinao column = expr AND column IS ca NULL, uma forma que comum em sub queries resolvidas. EXPLAIN mostrar ref_or_null e a quando esta otimizao usada. ca e Esta otimizao pode tratar um IS NULL para qualquer parte da chave. ca Alguns exemplos de consultas que so otimizadas (assumindo chave em t2 (a,b)): a SELECT * FROM t1 WHERE t1.a=expr OR t1.a IS NULL; SELECT * FROM t1,t2 WHERE t1.a=t2.a OR t2.a IS NULL; SELECT * FROM t1,t2 WHERE (t1.a=t2.a OR t2.a IS NULL) AND t2.b=t1.b; SELECT * FROM t1,t2 WHERE t1.a=t2.a AND (t2.b=t1.b OR t2.b IS NULL);

SELECT * FROM t1,t2 WHERE (t1.a=t2.a AND t2.a IS NULL AND ...) OR (t1.a=t2.a AND t2. ref_or_null funciona fazendo primeiro uma leitura na chave indicada e depois disto uma busca separada por linhas com chave NULL. Note que a otimizao s pode tratar um n IS NULL. ca o ivel SELECT * FROM t1,t2 where (t1.a=t2.a AND t2.a IS NULL) OR (t1.b=t2.b AND t2.b IS NUL No caso acima o MySQL s usar busca de chave na parte (t1.a=t2.a AND t2.a IS NULL) o a e no poder usar a parte da chave em b. a a

5.2.6 Como o MySQL Otimiza Clusulas DISTINCT a

DISTINCT combinado com ORDER BY tambm ir em vrios casos criar uma tabela teme a a porria. a Note que como DISTINCT pode usar GROUP BY, voc deve estar ciente de como o MySQL fune ciona com campos na parte ORDER BY ou HAVING que no so parte dos campos selecionados. a a Veja Seo 6.3.7.3 [GROUP-BY-hidden-elds], Pgina 561. ca a Quando combinando LIMIT row_count com DISTINCT, o MySQL ir parar logo que encona trar row_count registros unicos. Se voc no utiliza colunas de todas tabelas usadas, o MySQL ir parar a varredura das e a a tabelas no usadas logo que encontrar a primeira coincidncia. a e

Cap tulo 5: Otimizao do MySQL ca

435

SELECT DISTINCT t1.a FROM t1,t2 where t1.a=t2.a; Neste caso, assumindo que t1 usando antes de t2 (conra com EXPLAIN), MySQL ir e a parar de ler de t2 (para aquele registro particular em t1) quandoo primeiro registro em t2 for encontrado.

5.2.7 Como o MySQL Otimiza LEFT JOIN e RIGHT JOIN

A LEFT JOIN B join_condition no MySQL est implementada como a seguir: a A tabela B congurada para ser dependente da tabela A e de todas as tabelas das e quais A depende. A tabela A congurada para ser dependente de todas as tabelas (exceto B) que so e a usadas na condio LEFT JOIN. ca A condio LEFT JOIN usada para decidir como devemos recuperar registros a partir ca e da tabela B. (Em outras palavras, qualquer condio na clasula WHERE no usada). ca u a e Todas as otimizaes padres de join so feitas, com a excesso que uma tabela sempre co o a a e lida depois de todas as tabelas das quais dependente. Se existir uma dependncia e e circular o MySQL ir emitir um erro. a Todas as otimizaes padres de WHERE so realizadas. co o a Se existir um registro em A que coincida com a clusula WHERE, mas no existir nenhum a a registro em B que coincida com a condio ON ento um registro extra em B gerado ca a e com todas as colunas com valor NULL. Se voc utiliza LEFT JOIN para encontrar registros que no existem em alguma tabela e e a est usando o seguinte teste: nome_coluna IS NULL na parte WHERE, onde nome colun a um campo que declarado como NOT NULL, ento o MySQL para de pesquisar por e e a mais registros (para uma combinao particular de chaves) depois de ter encontrado ca um registro que combinar com a condio LEFT JOIN. ca RIGHT JOIN implementado de forma anloga ` LEFT JOIN. e a a A ordem de leitura das tabelas forada por LEFT JOIN e STRAIGHT JOIN ir ajudar o c a otimizador de joins (que calcula em qual ordem as tabelas devem ser unidas) a fazer seu trabalho mais rapidamente, j que havero poucas permutaes de tabelas a serem conferia a co das. Perceba que o texto acima signica que se voc zer uma consulta do tipo: e SELECT * FROM b,a LEFT JOIN c ON (c.key=a.key) LEFT JOIN d (d.key=a.key) WHERE b.key=d.key A partir do MySQL 4.0.14, o MySQL faz a seguinte otimizao LEFT JOIN: ca Se a condio WHERE sempre falsa para a linha NULL gerada, o LEFT JOIN alterado para ca e e um join normal. Por exemplo, na seguinte consulta a clusula WHERE seria falso se t2.coluna fosse NULL, a asssim seguro converter para uma join normal. e SELECT * FROM t1 LEFT t2 ON (column) WHERE t2.column2 =5; -> SELECT * FROM t1,t2 WHERE t2.column2=5 AND t1.column=t2.column;

436

MySQL Technical Reference for Version 5.0.0-alpha

Isto pode ser feito mais rpido j que o MySQL pode agora usar a tabela t2 antes da tabela a a t1 se resultasse consulta melhor. Para forar uma ordem de tabela espec c ica, use STRAIGHT JOIN. O MySQL ir fazer uma pesquisa completa em b j que o LEFT JOIN ir fora-lo a ser lido a a a c antes de d. A correo neste caso alterar a consulta para: ca e SELECT * FROM b,a LEFT JOIN c ON (c.key=a.key) LEFT JOIN d (d.key=a.key) WHERE b.key=d.key

5.2.8 Como o MySQL Otimiza Clusulas ORDER BY a

Em alguns casos o MySQL pode utilizar indices para satisfazer uma requisio de ORDER BY ca ou GROUP BY sem fazer uma ordenao extra. ca O indice tambm pode ser usado mesmo se o ORDER BY no coincidir exatamente com o e a indice, uma vez que todas as partes de indices no usadas e todos os extras na coluna ORDER a BY so constantes na clusula WHERE. A seguinte consulta usar o a a a indice para resolver a parte ORDER BY / GROUP BY: SELECT * FROM t1 ORDER BY key_part1,key_part2,... SELECT * FROM t1 WHERE key_part1=constante ORDER BY key_part2 SELECT * FROM t1 WHERE key_part1=constante GROUP BY key_part2 SELECT * FROM t1 ORDER BY key_part1 DESC,key_part2 DESC SELECT * FROM t1 WHERE key_part1=1 ORDER BY key_part1 DESC,key_part2 DESC Alguns casos onde o MySQL no pode usar a indices para resolver o ORDER BY: (Note que o MySQL ainda usar a indices para encontrar o registro que coincide com a clusula WHERE): a Voc est fazendo um ORDER BY em diferentes chaves: e a SELECT * FROM t1 ORDER BY key1,key2 Voc est fazendo um ORDER BY usando partes de chaves no consecutivas. e a a SELECT * FROM t1 WHERE key2=constant ORDER BY key_part2 Voc est misturando ASC e DESC. e a SELECT * FROM t1 ORDER BY key_part1 DESC,key_part2 ASC As chaves usadas para buscar os registros so as mesmas usadas para fazer o ORDER BY: a SELECT * FROM t1 WHERE key2=constant ORDER BY key1 Voc est unindo muitas tabelas e as colunas nas quais voc est fazendo um ORDER BY e a e a no so todas da primeira tabela que no const e que usada para retornar registros. a a a e e (Esta a primeira tabela na sa do EXPLAIN que no usa um mtodo de busca de e ida a e registro const). Voc tem diferentes expresses ORDER BY e GROUP BY. e o O indice da tabela usada um tipo de e indice que no armazena registros em ordem. a (Como o indice HASH em tabelsn HEAP). Nestes casos onde o MySQL tem que ordenar o resultado, ele usa o seguinte algoritmo: L todos os registros de acordo com a chave ou por uma varredura da tabela. Registros e que no coincidem com a clusula WHERE so saltados. a a a

Cap tulo 5: Otimizao do MySQL ca

437

Armazena a chave ordenada em um buer (de tamanho sort_buffer). Quando o buer car cheio, execute ordeno-o e armazene o resultado em um arquivo temposrrio. Salve um ponteiro para o bloco ordenado. (No caso de todos os regitros a caberem no buer ordenado, nenhum arquivo temporrio criado). a e Repete o armazenamento acima at todas as linhas tenham sido lidos. e Faz um multi-merge at MERGEBUFF (7) regies para um bloco em outro arquivo teme o porrio. Repete at que todos os blocos do primeiro arquivo estejam no segundo ara e quivo. Repete o seguinte at que restem menos que MERGEBUFF2 (15) blocos. e No ultimo multi-merge, s o ponteiro para o registro (ltima parte de chave ordenada) o u escrito em um arquivo de resultado. e Agora o cdigo em sql/records.cc ser usado para ler atravs deles ordenadamente o a e usando os ponteiros de registro no arquivo resultante. Para otimizao , lemos em um ca grande bloco de ponteiros de registros, ordena-os ento lemos o registros ordenadamente a de de um buer de registro. (read_rnd_buffer_size) . Voc pode vericar com EXPLAIN SELECT ... ORDER BY se o MySQL pode usar e indices para resolver a consulta. Se voc obtiver Using filesort na coluna extra, ento o MySQL no e a a pode usar indices para resolver o ORDER BY. Veja Seo 5.2.1 [EXPLAIN], Pgina 424. ca a Se voc quiser ter uma velocidade ORDER BY maior, primeiro voc deve ver se voc pode e e e fazer que o MySQL use indices em vez de fazer um fase de ordenao extra. Se no for ca a poss ivel, ento voc pode fazer: a e Aumente o tamanho da varivel sort_buffer_size. a Aumente o temenho da varivel read_rnd_buffer_size. a Altere tmpdir para apontar para um disco dedicado com muito espao vazio. Se voc c e usa o MySQL 4.1 ou posterior voc pode distribuir a carga entre diversos discos fisicos e denindo tmpdir com uma lista de caminhos separados por dois pontos : (ponto e v irgula ; no Windows). Eles sero usados de acordo com o mtodo round-robin. Nota: a e Estes caminho devem estar em diferentes discos f isicos, e no em diferentes parties a co do mesmo disco. Por padro, o MySQL ordena todas as consultas GROUP BY x,y[,...] como se voc tivesse a e especicado ORDER BY x,y[,...]. Se voc incluir a clusula ORDER BY explicitamente, o e a MySQL a otimizar sem qualquer penalidade na velocidade, embora a ordenacao ainda a ocorra. Se a consulta inclui um GROUP BY mas voc deseja evitar a sobrecarga da ordenar o e resultado, voc pode suprimir a ordenacao especicando ORDER BY NULL: e INSERT INTO foo SELECT a,COUNT(*) FROM bar GROUP BY a ORDER BY NULL;

5.2.9 Como o MySQL Otimiza Clusulas LIMIT a

Em alguns casos o MySQL ir tratar a consulta de maneira diferente quando voc estiver a e utilizando LIMIT row_count e no estiver utilizando HAVING: a Se voc estiver selecionando apenas alguns registros com LIMIT, o MySQL usar e a indices em alguns casos quando ele normalmente preferiria fazer uma varredura completa na tabela.

438

MySQL Technical Reference for Version 5.0.0-alpha

Se voc utilizar LIMIT row_count com ORDER BY, O MySQL ir terminar a ordenao e a ca logo que ele encontrar os primeiros row_count registros em vez de ordenar a tabela inteira. Ao combinar LIMIT row_count com DISTINCT, o MySQL ir parar logo que ele encona trar row_count registros unicos. Em alguns casos um GROUP BY pode ser resolvido lendo a chave em ordem (ou fazer uma classicao na chave) e ento calcular resumos at o valor da chave alterar. Neste ca a e caso, LIMIT row_count no ir calcular nenhum GROUP BY desnecessrio. a a a Logo que o MySQL enviar os primeiros # registros para o cliente, ele ir abortar a a consulta. LIMIT 0 ir sempre retornar rapidamente um conjunto vazio. Isto util para conferir a e a consulta e obter os tipos de campos do resultado. Quando o servidor utiliza tabelas temporrias para resolver a consulta, o LIMIT row_ a count usado para calcular a quantidade de espao necessrio. e c a

5.2.10 Performance das Consultas que Utilizam INSERT

O tempo para inserir um registro consiste aproximadamente de: Conexo: (3) a Enviar a consulta para o servidor: (2) Analisar a consulta (2) Inserir o registro: (1 x tamanho do registro) Inserir os indices: (1 x nmero de u indices) Fechar: (1) onde os nmeros so de certa forma proporcionais ao tempo total. Isto no leva em conu a a sideraco o sobrecarga inicial para abrir tabelas (que feita uma vez para cada consulta a e concorrente em execuo). ca O tamanho da tabela diminuem a velocidade da insero de ca indices em N log N (Arvores B). Algumas maneiras de acelerar as inseres: co Se voc estiver inserindo vrios registros do mesmo cliente ao mesmo tempo, utilize e a instrues INSERT com listas de mltiplos valores. Isto muito mais rpido (muitas co u e a vezes em alguns casos) do que utilizar instrues INSERT separadas. Se voc esta co e adicionando dados a uma tabela que no est vazia, voc pode ajustar a varivel a a e a bulk_insert_buffer_size para tornr isto mais rpido. Veja Seo 4.6.8.4 [bulk_ a a ca insert_buffer_size], Pgina 309. a Se voc inserir vrios registros de diferentes clientes, voc pode obter velocidades mais e a e altas utilizando a instruo INSERT DELAYED. Veja Seo 6.4.3 [INSERT], Pgina 579. ca ca a Perceba que com MyISAM voc pode inserir registros ao mesmo tempo que SELECTs e estejam executando se no existirem registros apagados nas tabelas. a Ao carregar uma tabela de um arquivo texto, utilize LOAD DATA INFILE. Isto normale mente 20 vezes mais rpido do que utilizar vrias instrues INSERT Veja Seo 6.4.8 a a co ca [LOAD DATA], Pgina 588. a

Cap tulo 5: Otimizao do MySQL ca

439

E poss ivel com algum trabalho extra fazer o LOAD DATA INFILE executar ainda mais rpido quando a tabela tiver vrios a a indices. Utilize o seguinte procedimento: 1. Opcionalmente crie a tabela com CREATE TABLE. Por exemplo, utilizando mysql ou Perl-DBI. 2. Execute a instruo FLUSH TABLES ou o comando shell mysqladmin flush-tables. ca 3. Utilize myisamchk --keys-used=0 -rq /path/to/db/nome_tabela. Isto remover o uso de todos os indices da tabela. a 4. Insira dados na tabela com LOAD DATA INFILE. Isto no atualizar a a indices e ser a muito mais rpido. a 5. Se no futuro voc precisar da tabela somente para leitura, execute myisampack na e mesma para torn-la menor. Veja Seo 7.1.2.3 [Formato compactado], Pgina 635. a ca a 6. Recrie os indices com myisamchk -r -q /caminho/para/bd/nome_tabela. Isto criar a rvore de a a indices em memria antes de escrev-la para o disco, que o e e muito mais rpido porque evita que seja feita muita busca disco. A rvore de a a indices resultante tambm balanceada perfeitamente. e e 7. Execute uma instruo FLUSH TABLES ou o comando shell mysqladmin flushca tables. Note que LOAD DATA INFILE tamb faz a otimizao acima se voc a insero for em e ca e ca uma tabela vazia; a principal diferena com o procedimento acima qeu voc pode c e e deixar o myisamchk alocar muita mais memria temporria para a criao do o a ca indice que voc deseje que o MySQL alocasse para todas as recriaes de indice. e co Desde o MySQL 4.0 voc tambm pode usar ALTER TABLE nome_tbl DISABLE KEYS em e e vez de myisamchk --keys-used=0 -rq /caminho/para/bd/nome_tbl e ALTER TABLE nome_tbl ENABLE KEYS em vez de myisamchk -r -q /caminho/para/bd/nome_tbl. Deste modo voc tambm pode saltar os passos FLUSH TABLES. e e Voc pode acelerar inseres feitas usando vrias instrues bloqueando suas tabelas: e co a co LOCK TABLES a WRITE; INSERT INTO a VALUES (1,23),(2,34),(4,33); INSERT INTO a VALUES (8,26),(6,29); UNLOCK TABLES; A principal diferena na velocidade que o buer de c e indices descarregado no disco e somente uma vez, depois de todas instrues INSERT term sido completadas. Normalco mente existiria tantas descargas do buer de indices quanto instrues INSERT diferco entes. O bloqueio no necessrio se voc pode inserir todos registros com uma simples a e a e instruo. ca Para tabelas transacionais, voc deve usar BEGIN/COMMIT em vez de LOCK TABLES para e conseguir um aumento na velocidade. O bloqueio ir tambm diminuir o tempo total de testes de multi-conexes, mas o a e o tempo mximo de espera para algumas threads ir aumentar (porque eles esperam a a pelos bloqueios). Por exemplo: thread 1 faz 1000 inser~es co thread 2, 3 e 4 faz 1 inser~o ca thread 5 faz 1000 inser~es co mysql> mysql> mysql> mysql>

440

MySQL Technical Reference for Version 5.0.0-alpha

Se voc no estiver usando travas, 2, 3 e 4 iro terminar antes de 1 e 5, Se estiver e a a utilizando travas, 2, 3 e 4 provavelmente no iro terminar antes de 1 ou 5, mas o a a tempo total deve ser cerca de 40% mais rpido. a Como as operaes INSERT, UPDATE e DELETE so muito rpidas no MySQL, voc obter co a a e a melhor perfomance geral adicionando travas em tudo que zer mais que cerca de 5 inseres ou atualizaes em um registro. Se voc zer vrias inseres em um registro, co co e a co voc pode utilizar LOCK TABLES seguido de um UNLOCK TABLES de vez em quando (em e torno de 1000 registro) para permitr que outras threads acessem a tabela. Isto tambm e continua mostrando um bom ganho de performance. Com certeza, LOAD DATA INFILE muito mais rpido para carregar dados. e a Para obter mais velocidade para LOAD DATA INFILE e INSERT, aumente o tamanho do buer de chaves. Veja Seo 5.5.2 [Parmetros de servidor], Pgina 454. ca a a

5.2.11 Performance das Consultas que Utilizam UPDATE

Consultas de atualizao so otimizadas como uma consulta que usa SELECT com a sobreca a carga adicional de escrita. A velocida da escrita depende do tamanho dos dados e do nmero u de indices que sero atualizados. a Indices que no forem alterados no sero atualizados. a a a Outra forma para obter atualizaes rpidas atrasar as atualizaes e ento fazer vrias co a e co a a atualizaes em um registro posteriormente. Fazer vrias atualizaes em um registro co a co e muito mais rpido do que fazer uma por vez se voc travar a tabela. a e Perceba que, com formato de registros dinmicos, atualizar um registro para um valor maior a que o tamanho total pode dividir o registro. Portanto, se voc faz isso frequentemente, e e muito importante usar OPTIMZE TABLE de vez em quando. Veja Seo 4.6.1 [OPTIMIZE ca TABLE], Pgina 298. a

5.2.12 Performance das Consultas que Utilizam DELETE

Se voc deseja apagar todos os registros em uma tabela, deve usar TRUNCATE TABLE nome_ e tabela. Veja Seo 6.4.6 [TRUNCATE], Pgina 587. ca a O tempo para apagar um registro exatamente proporcional ao nmero de e u indices. Para apagar registros mais rapidamente, voc pode aumentar o tamanho do cache de e indices. Veja Seo 5.5.2 [Parmetros do servidor], Pgina 454. ca a a

5.2.13 Mais Dicas sobre Otimizaes co

Dicas no ordenadas para sistemas rpidos: a a Utilize conexes persistentes aos banco de dados para evitar a sobrecarga da conexo. o a Se voc no poder utilizar conexes persistentes e for fazer vrias novas conexes para e a o a o o banco de dados, voc pode desejar alterar o valor da varivel thread_cache_size. e a Veja Seo 5.5.2 [Parmetros do servidor], Pgina 454. ca a a Sempre verique se todas as suas consultas realmente utilizam os indices que foram criados nas tabelas. No MySQL voc pode fazer isto com o comando EXPLAIN. Veja e Seo 5.2.1 [Explain], Pgina 424. ca a

Cap tulo 5: Otimizao do MySQL ca

441

Tente evitar consultas SELECT complexas em tabelas que so muito atualizadas. Isto a evita problemas com travamento de tabelas. Com tabelas MyISAM que no tenham linhas deletadas, voc pode inserir registros ao a e mesmo tempo que outra tabela a estiver lendo. Se este recurso importante para voc, e e deve considerar mtodos onde voc no tem que apagar registrou ou executar OPTIMIZE e e a TABLE depois de ter apagado vrios registros. a Utilize ALTER TABLE ... ORDER BY expr1,expr2... se voc na maioria das vezes ree cupera registros na ordem expr1,expr2... Utilizando esta opo depois de grandes ca alteraes para a tabela, pode lhe dar um ganho de performance. co Em alguns casos pode fazer sentido introduzir uma coluna hash baseada nas informaes das outras colunas. Se esta coluna for curta e razoavelmente unica co pode ser muito mais rpido do que ter um grande indice em vrias colunas. No a a MySQL muito fcil usar esta coluna extra: SELECT * FROM nome_tabela WHERE e a hash=MD5(concat(col1,col2)) AND col_1=constante AND col_2=constante Para tabelas que alteram muito voc deve tentar evitar todas colunas VARCHAR ou BLOB. e Voc ter tamanho de registro dinmico assim que usar um simples campo VARCHAR ou e a a BLOB. Veja Cap ptexi tulo 7 [Tipos de tabelas], Pgina 630. a Normalmente no muito util cortar uma tabela em diferentes tabelas apenas porque a e os registros esto grandes. Para acessar um registro, o maior problema para a pera formance a busca em disco para encontra o primeiro byte do registro. Depois de e encontrar os dados a maioria dos novos discos podem ler o registro inteiro rpido o a bastante para a maioria das aplicaes. Os unicos caos onde realmente faz sentido co dividir uma tabela se ela uma tabela de registros com tamanho dinmico (veja e e a acima) que voc pode alterar para um tamanho xo, ou se voc frequentemente precisa e e examinar a tabela e no precisa da maioria das colunas. Veja Cap a ptexi tulo 7 [Tipos de tabela], Pgina 630. a Se frequentemente voc precisar calcular alguma coisa baseada em informao de vrios e ca a registros (ex: contagem de registros), provavlmente melhor introduzir uma nova e tabela e atualizar o contador em tempo real. Uma atualizao do tipo UPDATE table ca set count=count+1 where index_column=constante muito rapida! e Isto realmente importante quando voc usa bancos de dados como o MySQL que s e e o tem travamento de tabelas (multiplos leituras/escrita unica). Isto tambm dar melhor e a performance com a maioria dos banco de dados, j que o gerenciador de bloqueio de a registro ter menos a fazer neste caso. a Se voc precisar colerar estatisicas de tabelas maiores, utilize tabelas resumo em vez e de buscar em toda a tabela. Manter os resumos deve ser mais rpido que tentar criar a estatit iscas instantaneamente. E muito mais rpido criar novas tabelas atravs dos logs a e quando as coisas mudam (dependendo das descises de negcio) que ter que alterar a o o aplicao em execuo. ca ca Se possivel, deve-se classicar relatrios como instantneo ou estat o a isticos onde os dados necessrios para relatrios estai a o isticos so gerados apenas com base nas tabelas a resumo que so geradas a partir dos dados atuais. a Tire vantagem do fato de que a coluna tem valores padres. Insira valores explicitao mente apenas quando os valores a serem inseridos diferem do padro. Isto reduz a a analise que o MySQL precisa fazer e aumenta a velocidade de insero. ca

442

MySQL Technical Reference for Version 5.0.0-alpha

Em alguns casos conveniente empacotar e armazenar os dados em um campo e blob. Neste caso voc deve adicionar algum cdigo em sua aplicao para e o ca empacotar/desempacotar as coisas no campo blob, mas isto pode poupar vrios a acessos a algum estgio. Isto prtico quando voc possui dados que no conformam a e a e a com uma estrutura esttica de tabela. a Normalmente, voc deve tentar manter todos dados no-redundantes (o que chamado e a e de 3a forma normal na teoria de bancos de dados), mas voc no deve ter medo de e a duplicar alguns itens ou criar tabelas de resumo se voc precisar delas para ganhar e mais velocidade. Stored Procedures ou UDF (funes denidas pelo usurios) pode ser uma boa forma co a para obter mais performance. Neste caso voc deve, entretanto, sempre ter uma e maneira de fazer isso de outra maneira (mais lenta) se voc utilizar algum banco de e dados que no suporta isto. a Voc sempr pode ganhar velocidade fazendo cache de perguntas/respostas na sua e aplicao e tentando fazer vrias inseres/atualizaes ao mesmo tempo. Se seu banco ca a co co de dados suporta travamento de tabelas (como o MySQL e Oracle), isto deve ajudar a garantir que o cache de indices descarregado somente uma vez depois de todas e atualizaes. co Use INSERT /*! DELAYED */ quando no precisar saber quando os dados so gravados. a a Isto melhora a velocidade porque vrios registros podem ser gravados com uma simples a escrita em disco. Use INSERT /*! LOW_PRIORITY */ quando voc desejar que suas consultas sejam mais e importantes. Use SELECT /*! HIGH_PRIORITY */ para obter consultas que ignoram a la. Isto , a e consulta feita mesmo se alguem estiver esperando para fazer uma escrita. e Use a instruo INSERT multi-linhas para armazenar vrios registros com um comando ca a SQL (vrios servidores SQL suportam isto). a Use LOAD DATA INFILE para carregar volumes maiores de dados. Isto mais rpido que e a as inseres normais e mais rpido at quando o myisamchk for integrado no mysqld. co a e Use colunas AUTO_INCREMENT para garantir valores unicos. Use OPTIMIZE TABLE de vez em quando para evitar fragmentao quando estiver usando ca formatos de tabela dinmica. Veja Seo 4.6.1 [OPTIMIZE TABLE], Pgina 298. a ca a Use tabelas HEAP para obter mais velocidade sempre que poss ivel. Veja Cap ptexi tulo 7 [Tipos de tabelas], Pgina 630. a Quando estiver usando uma congurao de servidor Web normal, imagens devem ser ca armazenadas como arquivos. Isto , armazene apenas uma referncia para o arquivo e e no banco de dados. A principal razo para isto que um servidor Web normal muito a e e melhor trabalhando com cache de arquivos do que com contedo de banco de dados. u Portanto ser muito mais fcil obter um sistema rpido se voc utilizar arquivos. a a a e Use tabelas em memria para dados no-criticos que so acessados frequentemente o a a (como informaes sobre o ultimo banner visto para usurios que no possuem cookies). co a a Colunas com informaes identicas em diferentes tabelas devem ser declaradas idnticas co e e ter nomes idnticos. No entanto, antes da verso 3.23, voc pode obter ligaes mais e a e co lentas.

Cap tulo 5: Otimizao do MySQL ca

443

Tente manter os nomes mais simples (use nome em vez de nome_cliente na tabela cliente). Para deixar seus nomes portveis para outros servidores SQL voc deve manta e e los menores que 18 caracteres. Se voc realmente precisa de alta velocidade, voc deve vericar as interfaces de baixo e e n para armazenagem de dados que os diferentes servidores SQL suportam! Por exivel emplo, para acessar tabelas MySQL MyISAM diretamente, voc pode obter um aumento e de velocidade de 2-5 vezes comparado ao uso da interface SQL. Para conseguir essa faanha, os dados devem estar no mesmo servidor que sua aplicao, e normalmente c ca devem ser acessados por apenas um processo (porque travamento de arquivos externo so muito lentos). Os problemas acima podem ser eliminados introduzindo comandos a MyISAM de baixo n no servidor MySQL (isto pode ser a maneira mais fcil para auivel a mentar a performance). Tenha cuidado em projetar a interface com o banco de dados, ela deve ser bem facil para suportar estes tipos de otimizaes. co Em vrios casos mais rpido acessar dados de um banco de dados (utilizando uma a e a conexo ativa) do que acessar um arquivo texto, apenas pelo fato do banco de dados a ser mais compacto do que o arquivo texto (se voc estiver utilizando dados numricos), e e e isto ir envolver menos acessos ` disco. Voc tambm ir poupar cdigo porque a a e e a o no ser necessrio analisar seus arquivos texto para encontrar limites de registros e a a a campos. Voc pode tambm usar replicao para conseguir ainda mais performance nas suas e e ca aplicaes. Veja Seo 4.11 [Replicao], Pgina 378. co ca ca a Declarando uma tabela com DELAY_KEY_WRITE=1 ir tornar a atualizao de a ca indices mais rpida, pois as mesmas no sero escritas em disco at o arquivo ser fechado. a a a e O lado ruim que voc deve executar myisamchk nestas tabelas antes de iniciar o e e mysqld para garantir que os dados esto corretos se o mysqld for nalizado no meio a da execuo. Como a informao de chave pode sempre ser gerada a partir dos dados, ca ca voc no deve perder nada usando DELAY_KEY_WRITE. e a

5.3 Detalhes sobre Locks

5.3.1 Como o MySQL Trava as Tabelas
Voc pode encontrar uma discusso sobre diferentes mtodos de bloqueios no apndice. Veja e a e e Seo E.4 [Mtodos de bloqueio], Pgina 1087. ca e a Todos os bloqueios no MySQL so livres de deadlock, exceto para tipos de tabela InnoDB a e BDB. Isto gerenciado sempre requisitando todos os bloqueios necessrios de uma vez no e a comeo de uma consulta e sempre bloqueando as tabelas na mesma ordem. c Tipos de tabela InnoDB automaticamente adquire seus locks de registro e os tipos de tabela BDB seus locks de pginas, durante o processamento das instrues SQL, e no no in da a co a icio transao. ca O mtodo de bloqueio que o MySQL utiliza para ESCRITA funciona da seguinte forma: e Se no existirem travas na tabela, coloque uma bloqueio de escrita na mesma. a Caso contrrio, coloca a requisio de trava na la de bloqueios para escrita. a ca

444

MySQL Technical Reference for Version 5.0.0-alpha

O mtodo de bloqueio que o MySQL utilizado para LEITURA funciona da seguinte maneira: e Se no existirem tarvas na tabela, coloca um bloqueio de leitura na mesma. a Caso contrrio, coloca a requisio de trava na la de bloqueios para leitura. a ca Quando um bloqueio liberado, a trava ca dispon para as threads na la de bloqueios e ivel de escrita, e ento para as threads na la de bloqueios de leitura. a Isto signica que se voc possui vrias atualizaes em uma tabela, instrues SELECT iro e a co co a esperar at que no existam mais atualizaes. e a co Para contornar este problema no caso onde voc precisa fazer vrias operaes de INSERT e a co e SELECT em uma tabela, voc pode inserir registros em uma tabela temporria e atualizar e a a tabela real com os registros da tabela temporria de uma s vez. a o Isto pode ser feito usando o cdigo a seguir: o mysql> mysql> mysql> mysql> LOCK TABLES real_table WRITE, insert_table WRITE; INSERT INTO real_table SELECT * FROM insert_table; TRUNCATE TABLE insert_table; UNLOCK TABLES;

Voc pode utilizar as opes LOW_PRIORITY com INSERT, UPDATE ou DELETE ou HIGH_ e co PRIORITY com SELECT se voc desejar priorizar a recuperao em alguns casos espec e ca icos. Tambm podei-se iniciar o mysqld com --low-priority-updates para obter o mesmo e comportamento. Utilizar SQL_BUFFER_RESULT pode tambm tornar a criao de locks de tabelas mais cure ca tos.Veja Seo 6.4.1 [SELECT], Pgina 562. ca a Voc tambm pode alterar o cdigo de bloqueioss no mysys/thr_lock.c para usar uma e e o la simples. Neste caso, bloqueios de escrita e leitura devem ter a mesma prioridade, o que pode ajudar em algumas aplicaes. co

5.3.2 Detalhes sobre Lock de Tabelas

O cdigo de bloqueio de tabelas no MySQL livre de deadlock. o e O MySQL utiliza bloqueio de tabelas (no lugar de bloqueio de registros ou colnas) em todos os tipos de tabelas, exceto tabelas BDB, para obter uma alta velocidade nos bloqueios. Para grandes tabelas, bloqueio de tabelas MUITO melhor que bloqueio de registros para a e maioria das aplicaes, mas existem, claro, algumas desvantagens. co e Para tabelas BDB e InnoDB, O MySQL s utiliza bloqueio de tabelas se voc bloquear o e explicitamente a tabela com LOCK TABLES ou executar um comando quer ir modicar todos a os registros na tabela, como ALTER TABLE. Para estes tipos de tabelas ns recomendamos a o voc no utilizar LOCK TABLES. e a No MySQL verso 3.23.7 ou superior , voc pode inserir registros em tabelas MyISAM ao a e mesmo tempo que outras threads esto lendo da mesma tabela. Perceba que atualmente a isto funciona somente se no existirem buracos depois de registros apagados na tabela no a momento que a insero feita. Quando todos os buracos forem preenchidos com novos ca e dados, inseres concorrentes iro automaticamente ser habilitadas novamente. co a O bloqueio de tabelas habilita vrias threads para lerem de uma tabela ao mesmo tempo, a mas se uma thread desejar escrever a uma tabela, ela primeiramente deve obter acesso

Cap tulo 5: Otimizao do MySQL ca

445

exclusivo. Durante a atualizao, todas outras threads que desejarem acessar esta tabela ca em particular iro esperar at que a atualizao acabe. a e ca Como atualizaes em tabelas normalmente so consideradas mais importantes que SELECT, co a todas as instrues que atualizam uma tabela tem maior prioridade que instrues que co co simplesmente recuperam informaes. Isto deve garantir que atualizaes no quem na co co a la por terem sido passadas vrias consultas pesadas em uma tabela espec a ica. (Voc e ca ca pode alterar isto utilizando LOW PRIORITY com a instruo que faz a atualizao ou HIGH_PRIORITY com a instruo SELECT.) ca A partir do MySQL verso 3.23.7 pode-se utilizadar a varivel max_write_lock_count para a a forar o MySQL a fornecer temporariamente a todas as instrues SELECT, que esperam por c co uma tabela, uma prioridade mais alta depois de um nmero espec u ico de inseres em uma co tabela. O bloqueio de tabela no , no entanto, muito bom sobre os seguintes cenrios: a e a Um cliente emite uma SELECT que exige muito tempo para ser executada. Outro cliente ento executa um UPDATE na tabela usada. Este cliente ter que esperar a a at que a SELECT seja terminada. e Outro cliente executa outra instruo SELECT na mesma tabela. Como UPDATE tem ca maior prioridade que SELECT, esta SELECT ir esperar pelo trmino da UPDATE. Ela a e tambm ir esperar pelo trmino da primeira SELECT! e a e Uma thread est esperando por algo do tipo disco cheio, caso em que todas as threads a que desejam acessar a tabela com problema iro ser colocadas em estado de espera at a e que mais espao em disco seja dispon c ivel. Algumas solues poss co iveis para este problema so: a Tente deixar suas instrues SELECT sempre rpidas. Voc pode ter que criar algumas co a e tabelas de resumo para fazer isto. Inicie o mysqld com --low-priority-updates. Isto ir fornecer a todas instrues a co que atualizam (modicam) uma tabela prioridade menor que uma instruo SELECT. ca Neste caso a ultima instruo SELECT no cenrio anterior deveria executar antes da ca a instruo INSERT. ca Voc pode fornecer a uma instruo INSERT, UPDATE ou DELETE espec e ca ica menor prioridade com o atributo LOW_PRIORITY. Inicie o mysqld com um valor baixo para max write lock count para fornecer bloqueios de LEITURA depois de um certo nmero de bloqueios de ESCRITA. u Voc pode especicar que todas as atualizaes de uma thread espec e co ica deve ser feita utilizando prioridade baixa com o comando SQL: SET SQL_LOW_PRIORITY_UPDATES=1. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca a Voc pode especicar que uma SELECT espec e ica muito importante com o atributo e HIGH_PRIORITY. Veja Seo 6.4.1 [SELECT], Pgina 562. ca a Se voc tiver problemas com INSERT combinado com SELECT, utilize as novas tabelas e MyISAM, pois elas suportam SELECTs e INSERTs concorrentes. Se voc utiliza principalmente instrues INSERT e SELECT misturadas, o atributo e co DELAYED no INSERT provavelmente ir resolver seus problemas. Veja Seo 6.4.3 a ca [INSERT], Pgina 579. a

446

MySQL Technical Reference for Version 5.0.0-alpha

Se voc tiver problemas com SELECT e DELETE, a opo LIMIT para DELETE pode ajudar. e ca Veja Seo 6.4.5 [DELETE], Pgina 585. ca a

5.4 Otimizando a Estrutura de Banco de Dados

5.4.1 Opoes do Projeto c
O MySQL mantem dados de registros e indices em arquivos separados. Vrios (quase todos) a bancos de dados misturam dados de registros e indice no mesmo arquivo. Ns acreditamos o que a escolha do MySQL melhor para uma ampla escala de sistemas modernos. e Outra forma de armazenar os dados de registros manter a informao para cada coluna e ca em uma rea separada (exemplos so o SDBM e o Focus). Isto ir causar um ponto de a a a performance para toda consulta que acessar mais de uma coluna. Como isto degrada rapidamente quando mais de uma coluna acessada, acreditamos que este modelo no bom e a e para propsitos gerais de bancos de dados. o O caso mais comum aquele em que o e indice e dados so armazenados juntos (como no a Oracle/Sybase). Neste caso voc ir encontrar a informao do registro na folha da pgina e a ca a de indice. A coisa boa com este layout que ele, em vrios casos, dependendo de como e a o indice armazenado no cache, salva uma leitura de disco. As desvantagens deste layout e so: a A varredura da tabela muito mais lenta porque voc tem que ler os e e indices para encontrar os dados. No podem ser usados apenas a tabela de a indices para recuperar dados para uma consulta. Voc perde muito espao de armazenagem, j que que os e c a indices devem ser duplicados nos ns (pois os registros no podem ser armazenados nos ns). o a o Delees iro degenerar a tabela depois de um tempo (j que os co a a indices nos ns noro malmente no so atualizados na deleo). a a ca mais dif fazer o cache somente dos dados de E icil indices.

5.4.2 Deixando os Dados com o Menor Tamanho Poss ivel

Uma das otimizaes mais bsicas tentar manter seus dados (e co a e indices) utilizando o menor espao poss c ivel no disco (e em memria). Isto pode fornecer grandes melhorias porque a o leitura de disco mais rpida e normalmente menos memria principal ser usada. A e a o a indexao tambm exige menos recursos se for feita em colunas menores. ca e O MySQL suporta vrios diferentes tipos de tabelas e formatos de registros. Voc pode ter a e um timo ganho de performance escolhendo o formato certo de tabela a ser usada. Veja o Cap ptexi tulo 7 [Tipos de tabelas], Pgina 630. a Pode-se obter melhor performance em uma tabela e minimizar espao de armazenagem c utilizando as tcnicas listadas abaixo: e Utilize os tipos mais ecientes (menores) sempre que poss ivel. O MySQL tem vrios a tipos especializados que economizam espao em disco e memria. c o

Cap tulo 5: Otimizao do MySQL ca

447

Utilize tipos inteiros menores se poss ivel para obter tabelas menores. Por exemplo, MEDIUMINT normalmente melhor que INT. e Declare colunas para serem NOT NULL se poss ivel. Isto deixa tudo mais rpido e voc a e economiza um bit por coluna. Perceba que se voc realmente precisa de NULL nas suas e aplicaes, podem ser usados. Tente simplesmente no us-la em todas as colunas por co a a padro. a Se voc no possui nenhuma coluna de tamanho varivel (VARCHAR, TEXT ou BLOB), e a a um formato de registro de tamanho xo para utilizado. Isto mais rpido mas e e a infelizmente pode ocupar mais espao. Veja Seo 7.1.2 [Formatos de tabelas MyISAM], c ca Pgina 634. a O indice primrio de uma tabela deve ser o mais curto poss a ivel. Isto torna a identicao de um registro fcil e eciente. ca a Para cada tabela, voc deve decidir qual metdo de armazenamento/ e o indice utilizar. Veja Cap ptexi tulo 7 [Tipos de tabelas], Pgina 630. a Crie somente os indices necessrios. a Indices so bons para recuperao mas ruins a ca quando voc precisa armazenar os dados rapidamente. Se na maioria das vezes voc e e acessa uma tabela pesquisando em uma combinao de colunas, crie um ca indice para elas. A primeira parte do indice deve ser a coluna mais utilizada. Se voc SEMPRE e utiliza vrias colunas, deve usar a coluna com mais duplicaes em primeiro lugar para a co obter melhor compactao do ca indice. Se for melhor que uma coluna tenha um prexo unico nos primeiros caracteres, e melhor indexar somente este prexo. O MySQL suporta um indice em uma parte de uma coluna de caracteres. Indices menores so mais rpidos no somente porque a a a eles exigem menos espao em disco mas tambm porque eles iro fornecer a voc mais c e a e acerto no cache de indice e isto diminui acessos a disco. Veja Seo 5.5.2 [Parmetros ca a de servidor], Pgina 454. a Em algumas circunstncias pode ser benco dividir uma tabela que varrida frea e e quentemente em duas. Isto verdade especicamente se a tabela tiver um formato e dinmico e for poss utilizar um formato de tabela esttico que possa ser usada para a ivel a encontrar os registros relevantes quando se zer uma varredura da tabela.

5.4.3 Como o MySQL Utiliza Indices

Os indices so utilizados para encontrar registros com um valor espec a ico de uma coluna rapidamente. Sem um indice o MySQL tem de iniciar com o primeiro registro e depois ler atravs de toda a tabela at que ele encontre os registros relevantes. Quanto maior a tabela, e e maior ser o custo. Se a tabela possui um a indice para as colunas em questo, o MySQL a pode rapidamente obter uma posio para procurar no meio do arquivo de dados sem ter ca que varrer todos os registros. Se uma tabela possui 1000 registros, isto pelo menos 100 e vezes mais rpido do que ler todos os registros sequencialmente. Note que se voc precisar a e acessar quase todos os 1000 registros, seria mais rpido acess-los sequencialmente porque a a evitaria acessos ao disco. Todos os indices do MySQL (PRIMARY, UNIQUE e INDEX) so armazenados em rvores B. a a Strings so automaticamente compactadas nos espaos nais e prexados. Veja Seo 6.5.7 a c ca [CREATE INDEX], Pgina 613. a

448

MySQL Technical Reference for Version 5.0.0-alpha

Indices so utilizados nos seguintes modos: a Para encontrar rapidamente os registros que coincidam com uma clusula WHERE. a Para recuperar registros de outras tabelas ao realizar joins. Para encontrar o valor MAX() ou MIN() para uma coluna indexada espeica. Isto otimizado por um preprocessador que confere se voc est utilizando WHERE e e a key part #=constante em todas as partes da chave < N. Neste caso o MySQL ir fazer uma simples procura na chave e trocar a expresso MIN() com uma a a constante. Se todas as expresses forem trocadas por constantes, a consulta retornar o a imediatamente: SELECT MIN(key_part2),MAX(key_part2) FROM nome_tabela where key_part1=10 Para ordenar ou agrupar uma tabela se a ordenao ou agrupamento for feito em um ca prexo mais ` esquerda de uma chave util (por exemplo, ORDER BY key_part_1, key_ a part_2 ). A chave lida na ordem invertida se todas as partes da chave forem seguidas e por DESC. Veja Seo 5.2.8 [Otimizao ORDER BY], Pgina 436. ca ca a Em alguns casos uma consulta pode ser otimizada para recuperar valores sem consultar o arquivo de dados. Se todas colunas utilizadas para alguma tabela so numricas e fora e mam um prexo mais ` esquerda para alguma chave, os valores podem ser recuperados a da rvore de a indices para aumentar a velocidade: SELECT key_part3 FROM nome_tabela WHERE key_part1=1 Suponha que voc utilize a seguinte instruo SELECT: e ca mysql> SELECT * FROM nome_tabela WHERE col1=val1 AND col2=val2; Se um indice de colunas mltiplas existir em col1 e col2, os registros apropriados podem u ser recuperados diretamente. Se indices separados de unicas colunas existirem em col1 e col2, o otimizador tentar encontrar o a indice mais restritivo decidindo qual indice ir a encontrar menos registros e usar este indice para recuperar os registros. a Se a tabela possuir um indice de mltiplas colunas, qualquer prexo mais ` esquerda do u a indice pode ser usado pelo otimizador para encontrar registros. Por exemplo, se voc possui e um indice de trs colunas em (col1, col2, col3), voc tem capacidades de busca indexada e e em (col1), (col1, col2) e (col1, col2, col3). O MySQL no pode utilizar um a indice parcial se as colunas no formarem um prexo mais a ` esquerda do a indice. Suponha que voc tenha as instrues SELECT mostradas abaixo: e co mysql> SELECT * FROM nome_tabela WHERE col1=val1; mysql> SELECT * FROM nome_tabela WHERE col2=val2; mysql> SELECT * FROM nome_tabela WHERE col2=val2 AND col3=val3; Se um indice existir em (col1, col2, col3), somente a primeira consulta anteriores utiliza o indice. A segunda e terceira consultas involvem colunas indexadas, mas (col2) e (col2, col3) no so os prexos mais ` esquerda de (col1, col2, col3). a a a O MySQL tambm utiliza e indices para comparaes do tipo LIKE se o argumento para LIKE co for uma string constante que no inicie com um meta caracter Por exemplo as seguintes a instrues SELECT utilizam co indices: mysql> SELECT * FROM nome_tbl WHERE key_col LIKE "Patrick%"; mysql> SELECT * FROM nome_tbl WHERE key_col LIKE "Pat%_ck%";

Cap tulo 5: Otimizao do MySQL ca

449

Na primeira instruo, somente os registros com "Patrick" <= key_col < "Patricl" so ca a considerados. Na segunda instruo, somente registros com "Pat" <= key_col < "Pau" so ca a considerados. As seguintes instrues SELECT no usaro co a a indices: mysql> SELECT * FROM nome_tbl WHERE key_col LIKE "%Patrick%"; mysql> SELECT * FROM nome_tbl WHERE key_col LIKE other_col; Na primeira instruo, o valor LIKE inicia com um meta caracter. Na segunda instruo, o ca ca valor LIKE no uma constante. a e O MySQL 4.0 faz outra otimizao em LIKE. Se voc usar ... LIKE "%string%" e string ca e tiver mais de 3 caracteres, o MySQL usar o algor a itmo Turbo Boyer-Moore para inicializar o padro para a string e ento usar este padro para realizar a pesquisa mais rpido. a a a a Buscas usando nome_coluna IS NULL usa indices se nome_coluna um e indice. O MySQL normalmente utiliza o indice que encontra o menor nmero de registros. Um u indice usado para colunas que voc compara com os seguintes operadores: =, >, >=, <, e e <=, BETWEEN ou um LIKE com um padro que comea com um prexo sem meta caracteres a c como algo%. Qualquer indice que no cobrem todos os n a iveis de AND na clusula WHERE no utilizado a a e para otimizar a consulta. Em outras palavras: Para poder usar um indice, um prexo do indice deve ser utilizado em todo agrupamento AND. A seguinte clusula WHERE utilizar a a indices: ... WHERE index_part1=1 AND index_part2=2 AND other_column=3 ... WHERE index=1 OR A=10 AND index=2 /* index = 1 OR index = 2 */ ... WHERE index_part1=hello AND index_part_3=5 /* optimised like "index_part1=hello" */ ... WHERE index1=1 AND index2=2 OR index1=3 AND index3=3; /* Can use index on index1 but not on index2 or index 3 */ Estas clusulas WHERE no utilizam a a indices: /* index_part_1 is not used */ /* Index is not used in both AND parts */ ... WHERE index_part1=1 OR index_part2=10 /* No index spans all rows */ Perceba que algumas vezes o MySQL no utilizar um a a indice, mesmo se algum estiver dispon ivel. Um exemplo deste caso quando o uso do e indice necessita que o MySQL acesse mais de 30% dos registros na tabela. (Neste caso uma varredura da tabela provavelmente e mais rpido, j que ela necessitar de menos pesquisas em discos). No entanto, se uma a a a consulta utiliza LIMIT para recuperar somente parte dos registros, o MySQL ir utilizar um a indice de qualquer forma, pois assim pode encontrar os poucos registros mais rapidamente e retornar o resultado. ... WHERE index_part2=1 AND index_part3=2 ... WHERE index=1 OR A=10

5.4.4 Indices de Colunas

Todos os tipos de colunas do MySQL podem ser indexadas. O uso de indices nas colunas relevantes a melhor forma de melhorar a performance de operaes SELECT. e co

450

MySQL Technical Reference for Version 5.0.0-alpha

O nmero mximo de u a indices por tabelas e o tamanho mximo de um a indice denido pelo e mecanismo de armazenamento. Veja Cap ptexi tulo 7 [Table types], Pgina 630. Todos os a mecanismos de armazenamentos suportam um m inimo de 16 chaves por tabela e um indice de tamanho total m inimo de 256 bytes. Para colunas CHAR e VARCHAR voc pode indexar um prexo da coluna. Isto muito mais e e rpido e necessita de menos espao em disco do que indexar a coluna inteira. A sintaxe a c para utilizar na instruo CREATE TABLE para indexar um prexo de uma coluna se parece ca com o exemplo a seguir: INDEX nome_indice (nome_campo(tamanho)) O exemplo abaixo cria um indice para os primeiros 10 caracteres da coluna nome: mysql> CREATE TABLE teste ( nome CHAR(200) NOT NULL, INDEX nome_indice (nome(10))); Para colunas BLOB e TEXT, voc deve indexar um prexo da coluna. O e indice pode ter at e 255 bytes. No MySQL Verso 3.23.23 ou posterior, voc pode tambm criar a e e indices FULLTEXT especiais. Eles so utilizados para pesquisas textuais. Somente o tipo de tabela MyISAM suporta a indices FULLTEXT e apenas para colunas CHAR, VARCHAR e TEXT. Indexao sempre acontece ca sobre toda a coluna e indexao parcial (prexo) no suportada. Veja Seo 6.8 [Fulltext ca a e ca Search], Pgina 619 para detalhes. a

5.4.5 Indices de M ltiplas Colunas u

O MySQL pode criar indices em mltiplas colunas. Um u indice pode consistir de at 15 e colunas. (Em colunas CHAR e VARCHAR voc tambm pode utilizar um prexo da coluna e e como parte de um indice). Um indice de mltiplas colunas pode ser considerado um array ordenado contendo valores u que so criados concatenando valores de colunas indexadas. a O MySQL utiliza indices de mltiplas colunas de forma que consultas so rpidas quando u a a voc especica uma quantidade conhecida para a primeira coluna do e indice em uma clusula a WHERE, mesmo se voc no especicar valores para as outras colunas. e a Suponha que uma tabela tenha a seguinte especicao: ca mysql> CREATE TABLE teste ( id INT NOT NULL, ultimo_nome CHAR(30) NOT NULL, primeiro_nome CHAR(30) NOT NULL, PRIMARY KEY (id), INDEX nome (ultimo_nome,primeiro_nome)); Ento o indice nome um a e indice com ultimo_nome e primeiro_nome. O indice ser usado a para consultas que especicarem valores em um limite conhecido para ultimo_nome, ou para ambos ultimo_nome e primeiro_nome. Desta forma, o indice nome ser usado nas a seguintes consultas: mysql> SELECT * FROM teste WHERE ultimo_nome="Widenius";

Cap tulo 5: Otimizao do MySQL ca

451

mysql> SELECT * FROM teste WHERE ultimo_nome="Widenius" AND primeiro_nome="Michael"; mysql> SELECT * FROM teste WHERE ultimo_nome="Widenius" AND (primeiro_nome="Michael" OR primeiro_nome="Monty"); mysql> SELECT * FROM teste WHERE ultimo_nome="Widenius" AND primeiro_nome >="M" AND primeiro_nome < "N"; Entretanto, o indice nome no ser usado nas seguintes consultas: a a mysql> SELECT * FROM teste WHERE primeiro_nome="Michael"; mysql> SELECT * FROM teste WHERE ultimo_nome="Widenius" OR primeiro_nome="Michael"; Para maiores informaes sobre a maneira que o MySQL utiliza co indices para melhorar o desempenho das consultas, veja Seo 5.4.3 [ ca indices do MySQL], Pgina 447. a

5.4.6 Como o MySQL Conta as Tabelas Abertas

Ao executar o comando mysqladmin status, voc ver algo deste tipo: e a Uptime: 426 Running threads: 1 Questions: 11082 Reloads: 1 Open tables: 12 O valor Open tables de 12 ode ser bastante estranho se voc s possui 6 tabelas. e o O MySQL multithreaded, portanto ele pode haver clientes enviando consultas para uma e determinada tabela simultaneamente. Para minimizar o problema com dois clientes tendo diferentes estados no mesmo arquivo, a tabela aberta independentemente por cada thread e concorrente. Isto exige mais memria mas normalmente aumentar o desempenho. Com o a tabelas ISAM e MyISAM, um descritor extra de arquivo necessrio para o arquivo de dados, e a para cada cliente que tem a tabela aberta. O descritor de arquivo de indice compartilhado e entre todas as threads. Voc pode ler mais sobre este tpico na prxima seo. Veja Seo 5.4.7 [Cache de tabelas], e o o ca ca Pgina 451. a

5.4.7 Como o MySQL Abre e Fecha as Tabelas

As variveis do servidor table_cache, max_connections e max_tmp_tables afetam o a nmero mximo de arquivos que o servidor mantm abertos. Se voc aumentar um ou u a e e ambos destes valores, voc pode ir contra um limite imposto pelo seu sistema operacional e no nmero de arquivos abertos por processo. Voc pode aumentar o limite de arquivos u e abertos em muitos sistemas operacionais, embora o mtodo varia muito de um sistema e para outro. Consulte a documentao de seu Sistema Operacional para saber como faz-lo, ca e porque o mtodo para alterar o limite varia muito de um sistema para outro. e table_cache relacionado a max_connections. Por exemplo, para 200 conexes concore o rentes em execuo, voc deve ter um tamanho de cache de tabela de pelo menos 200 * n, ca e onde n o nmero mximo de tabelas em um join. Voc tambm precisa reservar alguns e u a e e descritores de arquivos para tabelas e arquivos temporrios. a

452

MySQL Technical Reference for Version 5.0.0-alpha

Esteja certo de que o seu sistema operacional pode tratar o nmero de descritores de u arquivos abertos denido pelo valor de table_cache. Se table_cache for muito alto, o MySQL pode esgotar os descritores de arquivo e recusar conexes, falhar na execuo de o ca consultas e ser muito instavel. Voc tambm tm que levar em conta que o mecanismo e e e de armazenamento MyISAM precisa de dois descritores de arquivos para cada tabela aberta. Voc pode aumentar o nmero de descritores de arquivo dispon e u iveis para o MySQL com a opo de inicializao --open-files-limit=#. Veja Seo A.2.17 [Tratamento de arquivos ca ca ca insucientes], Pgina 921. a A cache de tabelas abertas ser mantido em um n de table_cache entradas. O valor a ivel padro 64; isto pode ser alterado com a opo -O table_cache=# do mysqld. Note que o a e ca MySQL pode temporariamente abrir mais tabelas para poder se executar consultas. Um tabela no usada fechada e removida da cache de tabelas sob as seguintes cira e cuntncias: a Quando a cache est cheia e um thread tenta abrir uma tabela que no est na cache. a a a Quando a cache contm mais que table_cache entradas e uma thread no est mais e a a usando uma tabela. Quando algum executa mysqladmin refresh ou mysqladmin flush-tables. e Quando algum executa uma instruo FLUSH TABLES. e ca Quando o cache de tabela encher, o servidor usa o seguinte procedimento para encontrar uma entrada de cache para usar: Tabelas que no estiverem em uso so liberadas, na ordem LRU (least-recently-used), a a ou seja, a tabela que foi usada menos rcentemente. Se o cache estiver cheio e nenhuma tabelas pode ser liberada, mas uma nova tabela precisar ser aberta, o cache extendido temporariamente quando necessrio. e a Se o cache estiver no estado temporariamente extendido e uma tabela vai do estado em-uso para o fora-de-uso, a tabela fechada e liberada do cache. e A table is opened for each concurrent access. This means the table needs to be opened twice if two threads access the same table or if a thread accesses the table twice in the same query (for example, by joining the table to itself). Uma tabela aberta para cada acesso simultneo. Isto signica a tabela precisa ser aberta e a duas vezes se duas threads acessam a mesma tabela ou se uma thread acessa a tabela duas vezes na mesma consulta (por exemplo, fazendo um join da tabela com ela mesma). A primeira abertura de qualquer tabela exige dois descritores de arquivos; cada uso adicional da tabela exige somente um descritor. O descritor extra para a primeira abertura para o e arquivo de indice: este descritor compartilhado entre todas as threads. e Se voc est abrindo uma tabela com a instruo HANDLER nome_tabela OPEN, uma tabela e a ca dedicada alocada para a thread. Este objeto da tabela no compartilhado por outras e a e threads e no ser fechado at que a thread chame HANDLER nome_tabela CLOSE ou seja a a e nalizada. Veja Seo 6.4.9 [HANDLER], Pgina 595. Quando isto acontece, a tabela ca a e colocada de volta na cache de tabela (se a cache no estiver cheia). a Voc pode conferir se o seu cache de tabela est muito pequeno conferindo a varivel opened_ e a a tables do mysqld. Se este valor for muito grande, mesmo se voc no fez vrios FLUSH e a a TABLES, voc deve aumentar o tamanho da sua cache de tabelas. Veja Seo 4.6.8.3 [Opened_ e ca tables], Pgina 305. a

Cap tulo 5: Otimizao do MySQL ca

453

5.4.8 Desvantagem em Criar um N mero Grande de Tabelas no u Mesmo Banco de Dados

Se voc possui muitos arquivos em um diretrio, operaes de abrir, fechar e criao caro e o co ca a lentos. Se voc executar instrues SELECT em diversas tabelas, existir uma pequena e co a sobrecarga quando o cache de tabela estiver cheio, porque para toda tabela que teve que ser aberta, outra deve ser fechada. Voc pode reduzir esta sobrecarga tornando o cache de e tabelas maior.

5.5 Otimizando o Servidor MySQL

5.5.1 Sintonia dos Parmetros em Tempo de Sistema/Compilao a ca e na Inicializao ca
Ns iniciamos com o fator do n do sistema pois algumas destas decises devem ser feitas o ivel o bem cedo. Em outros casos uma rpida olhada para esta seo pode satisfazer porque ela a ca no to importante para os grandes ganhos. Entretanto, sempre bom ter ter noes de a e a e co como voc pode obter melhorias alterando coisas neste n e ivel. Qual sistema operacional a usar realmente importante! Para obter o melhor uso de e mquinas com mltiplas CPUs voc deve utilizar Solaris (porque a sua implemetao das a u e ca threads funcionam muito bem) ou Linux (porque o kernel 2.2 tem suporte SMP muito bom). Tambm, em Linux mais antigos temos o limite de tamanho de arquivo de 2G por padro. e a Se voc tem tal kernel e precisa desesperadamente de trabalhar com arquivos maiores que e 2G em mquinas intel Linux, voc deve obter o patch LFS para o sistema de arquivos ext2. a e Outros sistemas de arquivo como ReiserFS e XFS no possuem esta limitao de 2G. a ca Como ainda no temos o MySQL em produo em muitas outras plataformas, ns aconsela ca o hamos que voc teste a plataforma pretendida antes de escolhe-la, se possivel. e Outras dicas: Se voc possui RAM suciente, voc pode remover todos os dispositivos de troca. e e Alguns sistemas operacionais iro utilizar um disposotico de troca em alguns contextos, a mesmo se voc possuir memria livre. e o Utilize a opo do MySQL --skip-external-locking para evitar locks externos. ca Perceba que isto no ir afetar a funcionalidade do MySQL se voc estiver execua a e tando um unico servidor. Apenas lembre-se de desligar o servidor (ou travar as partes relevantes) antes de executar myisamchk. Em alguns sistemas esta opo obrigatrio ca e o porque o lock externo no funcionam em nenhum caso. a A opo --skip-external-locking est ligada por padro a partir do MySQL 4.0. ca a a Antes disto, era ligada por padro quando compilando com MIT-pthreads, porque a flock() no totalmente suportado pelas MIT-pthreads em todas plataformas. E a e tambm o padro para Linux pois o bloqueio de arquivos no Linux no muito seguro. e a a e O unico caso que voc no pode utilizar --skip-external-locking se voc precisa e a e e de vrios servidores MySQL (no clientes) acessando os mesmos dados, ou executar a a myisamchk na tabela sem dizer ao servidor para descarregar e travar as tabelas primeiro Voc pode continuar usando LOCK TABLES/UNLOCK TABLES mesmo se voc estiver utie e lizando --skip-external-locking.

454

MySQL Technical Reference for Version 5.0.0-alpha

5.5.2 Parmetros de Sintonia do Servidor a

Voc pode determinar tamanho padro do buer usados pelo servidor mysqld com este e a comando: shell> mysqld --help Este comando produz uma lista de todas as opes do mysqld e variveis congurveis. A co a a sa inclui os valores padro das variveis e se parece com isto: ida a a back_log current value: 5 bdb_cache_size current value: 1048540 binlog_cache_size current value: 32768 connect_timeout current value: 5 delayed_insert_timeout current value: 300 delayed_insert_limit current value: 100 delayed_queue_size current value: 1000 flush_time current value: 0 interactive_timeout current value: 28800 join_buffer_size current value: 131072 key_buffer_size current value: 1048540 lower_case_nome_tabelas current value: 0 long_query_time current value: 10 max_allowed_packet current value: 1048576 max_binlog_cache_size current value: 4294967295 max_connections current value: 100 max_connect_errors current value: 10 max_delayed_threads current value: 20 max_heap_table_size current value: 16777216 max_join_size current value: 4294967295 max_sort_length current value: 1024 max_tmp_tables current value: 32 max_write_lock_count current value: 4294967295 myisam_sort_buffer_size current value: 8388608 net_buffer_length current value: 16384 net_retry_count current value: 10 net_read_timeout current value: 30 net_write_timeout current value: 60 read_buffer_size current value: 131072 record_rnd_buffer_size current value: 262144 slow_launch_time current value: 2 sort_buffer current value: 2097116 table_cache current value: 64 thread_concurrency current value: 10 tmp_table_size current value: 1048576 thread_stack current value: 131072 wait_timeout current value: 28800 Se existir um servidor mysqld em execuo, voc pode ver quais valores ele est usando ca e a atualmente para as variveis executando esta instruo: a ca

Cap tulo 5: Otimizao do MySQL ca

455

mysql> SHOW VARIABLES; Voc tambm pode ver algumas estat e e isticas e indicadores de status para um servidor em execuo executando este comando: ca mysql> SHOW STATUS; Para encontrar uma descrio completa de todas as variveis na seo SHOW VARIABLES ca a ca neste manual. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. ca a Para informao sobre variveis de estado, veja Seo 4.6.8.3 [SHOW STATUS], Pgina 305. ca a ca a Variveis de servidor e informao de status tambm pode ser obtido usando mysqladmin: a ca e shell> mysqladmin variables shell> mysqladmin extended-status O MySQL utiliza algor itmos que so muito escalveis, portanto, normalmente voc pode a a e trabalhar com pouca memria. Entretanto, se voc fornecer ao MySQL mais memria, o e o obter um desempenho melhor. a Quando estiver ajustando um servidor MySQL, as duas variveis mais importantes que a devem ser usadas so key_buffer_size e table_cache. Voc deve se sentir conante que a e as duas estejam corretas antes de tentar alterar qualquer outra varivel. a Os seguintes exemplos indicam alguns valores t ipicos de variveis para diferentes cona guraes de tempo de execuo. Os exemplos usam o script mysqld_safe e usam a sintaxe co ca --name=value para denir a varivel name com o valor value. Esta sintaxe est dispon a a ivel a partir do MySQL 4.0. Para verses mais antigas do MySQL, tome as seguintes diferenas o c nas contas: Use safe_mysqld em vez de mysqld_safe. Congure as variveis usando a sintaxe --set-variable=name=value ou -O a name=value Para nomes de variveis que nalizam em _size, voc pode precisar especic-las sem a e a _size. Por exemplo, o nome antigo para sort_buffer_size sort_buffer. O nome e antigo para read_buffer_size record_buffer. Para ver quais variveis a verso do e a a seu servidor reconhece, use mysqld --help. Se voc possui pelo menos 256M de memria e vrias tabelas e deseja obter o melhor e o a desempenho com um nmero moderado de clientes, deve utilizar algo como: u shell> mysqld_safe --key_buffer_size=64M --table_cache=256 \ --sort_buffer_size=4M --read_buffer_size=1M & Se possui apenas 128M de memria e apenas algumas poucas tabelas, mas ainda deseja o realizar vrias ordenaes, voc pode utilizar: a co e shell> mysqld_safe --key_buffer_size=16M --sort_buffer_size=1M Se voc possuir pouca memria e tiver muitas conexes, utilize algo como: e o o shell> mysqld_safe --key_buffer_size=512K --sort_buffer_size=100K \ --read_buffer_size=100K & ou mesmo isto: shell> mysqld_safe --key_buffer_size=512K --sort_buffer_size=16K \ --table_cache=32 --read_buffer_size=8K -O net_buffer_length=1K &

456

MySQL Technical Reference for Version 5.0.0-alpha

Se voc estiver executando um GROUP BY ou ORDER BY em tabelas que so muito maiores e a que sua memria dispon voc deve aumentar o valor de record_rnd_buffer_size para o ivel e acelerar a leitura de registros aps a operao de ordenao. o ca ca Quando voc tiver instalado o MySQL, o diretrio support-files ir conter alguns e o a arquivos exemplos do my.cnf, my-huge.cnf, my-large.cnf, my-medium.cnf e my-small.cnf, voc pode us-los como base para otimizar seu sistema. e a Se voc possui vrias conexes simultneas, problemas de trocas podem ocorrer a menos e a o a que o mysqld tenha sido congurado para usar muito pouca memria para cada conexo. o a O mysqld tem melhor performance se voc tiver memria suciente para todas as conexes, e o o claro. e Perceba que se voc especica uma opo na linha de comando para o mysqld, ou mysqld_ e ca safe ele permanece em efeito somente para aquela chamada do servidor. Para usar a opo ca toda vez que o servidor executa, coloque-o em um arquivo de opo. ca Para ver os efeitos de uma alterao de parmetro, faa algo como: ca a c shell> mysqld --key_buffer_size=32m --help Tenha certeza que a opo --help seja a ultima do comando; de outra forma o efeito de ca qualquer opes listadas depois na linha de comando no sero reetidas na sa co a a ida.

5.5.3 Como a Compilao e a Ligao Afetam a Velocidade do ca ca MySQL

A maioria dos testes seguintes so feitos no Linux com os benchmarks do MySQL, mas eles a devem fornecer alguma indicao para outros sistemas operacionais e workloads. ca Voc obtm um executvel mais veloz quando ligado com -static. e e a No Linux, voc ir obter o cdigo mais rpido quando compilando com pgcc e -03. Para e a o a compilar sql_yacc.cc com estas opes, voc precisa de cerca de 200M de memria porque co e o o gcc/pgcc precisa de muita memria para criar todas as funes em linha. Tambm deve o co e ser congurado o parmetro CXX=gcc para evitar que a biblioteca libstdc++ seja incluida a (no necessria). Perceba que com algumas verses do pgcc, o cdigo resultante ir a e a o o a executar somente em verdadeiros processadores Pentium, mesmo que voc utilize a opo do e ca compilador para o cdigo resultante que voc quer, funcionando em todos os processadores o e do tipo x586 (como AMD). S pelo fato de utilizar um melhor compilador e/ou melhores opes do compilador voc o co e pode obter um aumento de desempenho de 10-30% na sua aplicao. Isto particularmente ca e importante se voc mesmo compila o servidor SQL! e Ns testamos ambos os compiladores Cygnus Codefusion e o Fujitsu, mas quando os testao mos, nenhum dos dois era sucientemente livre de erros para que o MySQL compilasse com as otimizaes. co Quando voc compila o MySQL deve incluir suporte somente para os conjuntos de carace teres que deseja usar. (Opo --with-charset=xxx). As distribuies binrias padro do ca co a a MySQL so compiladas com suporte para todos os conjuntos de caracteres. a Segue uma lista de algumas medidas que temos feito: Se voc utiliza o pgcc e compila tudo com -O6, o servidor mysqld 1% mais rpido do e e a que com o gcc 2.95.2.

Cap tulo 5: Otimizao do MySQL ca

457

Se voc liga dinamicamente (sem -static), o resultado 13% mais lento no Linux. e e Note que voc ainda pode utilizar uma biblioteca do MySQL dinamicamente ligada ` e a o sua aplicao cliente. E s o servidor que cr ca e itico para performance. Se voc corta seu binrio mysqld com strip libexec/mysqld, o binrio gerado pode e a a car at 4% mais rpido. e a Para uma conexo de um cliente para um servidor em execuo na mesma mquina, se a ca a voc conecta utilizando TCP/IP em vez de utilizar um arquivo socket Unix, o rendie mento 7.5% mais lento no mesmo computador. (Se voc zer conexo ` localhost, e e a a o MySQL ir, por padro, utilizar sockets). a a Para conexes TCP/IP de um cliente para um servidor, conectando a um servidor o remoto em outra mquina ser 8-11% mais lento que conectando ao servidor local na a a mesma mquina, mesmo para conexes Ethernet de 100M. a o Quando executar o nosso teste de benchamrk usando conexes seguras (todos os dados o crptografados com suporte interno SSL) ele se torna 55% mais lento. Se voc compilar com --with-debug=full, a maioria das consultas ser 20% mais e a lentas. Algumas consultas podem demorar muito mais tempo (por exemplo, os benchmarks do MySQL demonstram 35% de perda). Se utilizar --with-debug, a queda ser a de apenas 15%. Para uma verso do mysqld compilada com --with-debug=full, voc a e pode desabilitar a vericao de memria em tempo de execuo iniciando-o com a ca o ca opo --skip-safemalloc. O resultado nal neste caso deve estar prximo de quando ca o compilado com --with-debug. Em um Sun UltraSPARC-IIe, Forte 5.0 4% mais rpido que gcc 3.2. e a Em um Sun UltraSPARC-IIe, Forte 5.0 4% mais rpido em modo de 32 bits que em e a modo de 64 bits. Compilando com gcc 2.95.2 para o ultrasparc com a opo -mcpu=v8 -Wa,ca xarch=v8plusa melhora a performance em 4%. No Solaris 2.5.1, a MIT-pthreads 8-12% mais lenta do que as threads nativas do e Solaris em um unico processador. Com mais carga/CPUs a diferena deve aumentar. c Executar com --log-bin deixa o mysqld 1 % mais lento. Compilando no Linux-x86 com gcc sem frame pointers -fomit-frame-pointer ou fomit-frame-pointer -ffixed-ebp deixa o mysqld 1-4% mais rpido. a A distribuio MySQL-Linux fornecida pela MySQL AB normalmente compilada com ca e pgcc, mas vamos retornar ao uso do gcc pelo fato de um bug no pgcc que gera o cdigo o que no executa no AMD. Continuaremos a usar o gcc at que o bug seja resolvido. Neste a e meio tempo, se voc possui uma mquina que no seja AMD, voc pode ter um binrio e a a e a mais rpido compilando com o pgcc. O binrio padro do MySQL para Linux ligado a a a e estaticamente para conseguir mais desempenho e ser mais portvel. a

5.5.4 Como o MySQL Utiliza a Memria o

A lista abaixo indica algumas das maneiras inas quais o servidor mysqld utiliza a memria. o Onde aplicvel, o nome da varivel do servidor relevante ao uso de memria fornecido: a a o e

458

MySQL Technical Reference for Version 5.0.0-alpha

O buer de chave (varivel key_buffer_size) compartilhado por todas as threads; a e Outros buers usados pelo servido so alocados quando necessrios. Veja Seo 5.5.2 a a ca [Parmetros de servidor], Pgina 454. a a Cada conexo utiliza algum espao espec a c ico da thread: Uma de pilha (padro de 64K, a varivel thread_stack), um buer de conexo (varivel net_buffer_lenght), e um a a a buer de resultados (varivel net_buffer_lenght). Os buers de conexes e resultados a o so aumentados dinamicamente para max_allowed_packet quando necessrio. Quando a a uma consulta est sendo executada, uma cpia da string da consulta atual tambm a o e e alocada. Todas as threads compartilhas a mesma memria base. o Somente as tabelas ISAM e MyISAM compactadas so mapeadas em memria. Isto a o e porque o espao de memria de 32-bits de 4GB no grande o bastante para a maioria c o a e das grandes tabelas. Quando sistemas com endereamento de 64-bits se tornarem c comuns poderemos adicionar um suporte gieral para o mapeamento de memria. o Cada requisio fazendo uma varredura sequencial em uma tabela aloca um buer de ca leitura (varivel read_buffer_size). a Ao ler registros na ordem randmica (por exemplo, depois de uma ordenao) um o ca buer de leitura randmico alocado para evitar pesquisas em disco. (varivel read_ o e a rnd_buffer_size). Todas as joins so feitas em um unico passo, e a maioria delas podem ser feitas mesmo a sem usar uma tabela temporria. A maioria das tabelas temporrias so tabelas a a a baseadas em memria (HEAP). Tabelas temporrias com uma grande extenso de o a a registros (calculada como a soma do tamanho de todas as colunas) ou que contenham colunas BLOB so armazenadas em disco. a Um problema nas verses do MySQL anteriores a 3.23.2 que se uma tabela HEAP o e excede o tamanho de tmp_table_size, voc recebe o erro The table nome_tabela is e full. A partir da verso 3.23.2, isto tratado alterando automaticamente a tabela a e em memria HEAP para uma tabela baseada em disco MyISAM quando necessrio. Para o a contornar este problema, voc pode aumentar o tamanho da tabela temporria cone a gurando a opo tmp_table_size do mysqld, ou congurando a opo do SQL SQL_ ca ca BIG_TABLES no progrma cliente. Veja Seo 5.5.6 [SET OPTION], Pgina 460. Na verso ca a a 3.20 do MySQL, o nmero mximo da tabela temporria record_buffer*16; se voc u a a e e estiver utilizando esta verso, voc ter que aumentar o valor record_buffer. Voc a e a e tambm pode iniciar o mysqld com a opo --big-tables para sempre armazenar as e ca tabelas temporrias em disco. Entretanto isto afetar a velocidade de vrias consultas a a a complicadas. A maioria das requisies que realizam ordenao alocam um bufer de ordenao e 0-2 co ca ca arquivos temporrios dependendo do tamanho do resultado. Veja Seo A.4.4 [Arquivos a ca temporrio], Pgina 929. a a Quase todas as anlises e clculos so feitos em um armazenamento de memria local. a a a o Nenhuma sobrecarga de memria necessrio para o e a itens pequenos e a alocao e libca erao normal de memria lenta evitada. A memria alocada somente para grandes ca o e o e strings inesperadas; isto feito com malloc() e free(). e Cada arquivo de indice aberto uma vez e o arquivo de dados aberto uma vez e e para cada thread concorrente. Uma estrutura de tabela, estrutura de coluna para

Cap tulo 5: Otimizao do MySQL ca

459

cada coluna e um buer de tamanho 3 * n alocado para cada thread concorrente. e (onde n o maior tamanho do registro, sem levar em considerao colunas BLOB. Uma e ca coluna BLOB utiliza de 5 a 8 bytes mais o tamanho dos dados contidos na mesma. O manipulador de tabelas ISAM/MyISAM iro usar um registro extra no buer para uso a interno. Para cada tabela com colunas BLOB, um buer aumentado dinamicamente para ler e grandes valores BLOB. Se voc ler uma tabela, um buer do tamanho do maior registro e BLOB alocado. e Estruturas de manipulaco para todas tabelas em uso so salvos em um cache e gerena a ciado como FIFO. Normalmente o cache possui 64 entradas. Se uma tabela foi usada por duas threads ao mesmo tempo, o cache ter duas entredas para a tabela. Veja a Seo 5.4.7 [Cache de tabela], Pgina 451. ca a Um comando mysqladmin flush-tables fecha (ou instrues FLUSH TABLES) todas co tabelas que no esto em uso e marca todas tabelas em uso para serem fechadas quando a a a thread atualmente em execuo terminar. Isto ir liberar efetivamente a maioria da ca a memria em uso. o ps e outros programas de informaes do sistema podem relatar que o mysqld usa muita co memria. Isto pode ser causado pelas pilhas de threads em diferentes endereos de memria. o c o Por exemplo, a verso do ps do Solaris conta a memria no usada entre as pilhas como a o a memria usada. Voc pode vericar isto conferindo a memria dispon o e o ivel com swap -s. Temos testado o mysqld com detectores comerciais de perda de memria, portanto tais o perdas no devem existir. a

5.5.5 Como o MySQL Utiliza o DNS

Quando um novo cliente conecta ao mysqld, o mysqld extende uma nova thread para lidar com o pedido. Esta thread primeiro confere se o nome da mquina est no cache de nomes a a de mquinas. Se no, a thread tenta resolver o nome da mquina. a a a Se o sistema operacional suporta as chamadas seguras com thread gethostbyaddr_r() e gethostbyname_r(), a thread as utiliza para fazer a resoluo do nome mquina. ca a Se o sistema operacional no suporta as chamadas de threads seguras, a thread trava a um mutex e chama gethostbyaddr() e gethostbyname(). Perceba que neste caso nenhuma outra thread pode resolver outros nomes de mquinas que no existam no a a cache de nomes de mquina at que a primeira thread esteja destrave o mutex. a e Voc pode desabilitar a procura de nomes de mquinas no DNS iniciando o mysqld com a e a opo --skip-name-resolve. No entanto, neste caso voc s pode usar nmeros IP nas ca e o u tabelas de privilgio do MySQL. e Se voc possuir um DNS muito lento e vrias mquinas, pode obter mais desempenho e a a desligando a procura de nomes de mquinas usando a opo --skip-name-resolve ou a ca aumentando HOST_CACHE_SIZE (valor padro: 128) e recompilar mysqld. a Voc pode desabilitar o cache de nomes de mquinas iniciando o servidor com a opo -e a ca skip-host-cache. Para limpar a cache do nome de mquinas, envie uma instru;o FLUSH a ca HOSTS ou execute o comando mysqladmin flush-hosts. Se voc deseja disabilitar as conexes TCP/IP totalmente, inicie o mysqld com a opo e o ca --skip-networking.

460

MySQL Technical Reference for Version 5.0.0-alpha

5.5.6 Sintaxe de SET

SET [GLOBAL | SESSION] sql_variable=expression, [[GLOBAL | SESSION] sql_variable=expression] ... SET congura vrias opes que afetam a operao do servidor ou seu cliente. a co ca Os seguintes exemplos mostram as diferentes sintaxes que se pode usar para congurar variveis: a Em verses antigas do MySQL permitiamos o uso da sintaxe SET OPTION, mas esta sintaxe o agora est obsoleta. a No MySQL 4.0.3 adicionamos as opes GLOBAL e SESSION e acessamos as variveis de co a inicializao mais importantes. ca LOCAL pode ser usado como sinniumo de SESSION. o Se voc dene diversas variveis na mesma linha de comando, o ultimo modo GLOBAL | e a SESSION utilizado e sort_buffer_size=10000; @@local.sort_buffer_size=10000; GLOBAL sort_buffer_size=1000000, SESSION sort_buffer_size=1000000; @@sort_buffer_size=1000000; @@global.sort_buffer_size=1000000, @@local.sort_buffer_size=1000000; A sintaxe @@nome_varivel suoprtada para tornar a sintaxe do MySQL compat com a e ivel outros bancos de dados. As diferentes variveis de sistema que podem ser conguradas esto descritas na seo de a a ca variveis de sistema deste manual. Veja Seo 6.1.5 [Variveis de sistema], Pgina 475. a ca a a Se voc estiver usando SESSION (o padro) a opo que voc denir ter efeito at que o e a ca e a e sesso atual nalize ou at que vec atribua um valor diferente a esta opo. Se voc estiver a e e ca e usando GLOBAL, que exige o privilgio SUPER, a opo lembrada e usada pelas novas e ca e conexes at que o servidor reinicie. Se voc quiser tornar uma opo permanente, voc o e e ca e deve den em um arquivo de opo. Veja Seo 4.1.2 [Arquivos de opes], Pgina 216. i-la ca ca co a Para evitar o uso incorreto, o MySQL exibir um erro se voc usar SET GLOBAL com uma a e varivel que s pode ser usada com SET SESSION ou se voc no estiver usando SET GLOBAL a o e a com uma varivel global. a Se voc quiser denir uma varivel SESSION com um valor GLOBAL ou um valor GLOBAL ao e a valor padro do MySQL, voc pode congur-lo com DEFAULT. a e a SET max_join_size=DEFAULT; Isto idntico a: e e SET @@session.max_join_size=@@global.max_join_size; Se voc quiser restringir o valor mximo com o qual uma varivel de servidor pode ser cone a a gurado com o comando SET, voc pode especica-lo usando a opo de linha de comando e a ca --maximum-variable-name. Veja Seo 4.1.1 [Opes de lina de comando], Pgina 207. ca co a Voc pode obter uma lista da maioria das variveis com SHOW VARIABLES. Veja Seo 4.6.8.4 e a ca [SHOW VARIABLE], Pgina 309. Voc pode obter o valor de uma varivel espec a e a ica com a sintaxe @@[global.|local.]variable_name: SET SET SET SET SET

Cap tulo 5: Otimizao do MySQL ca

461

SHOW VARIABLES like "max_join_size"; SHOW GLOBAL VARIABLES like "max_join_size"; SELECT @@max_join_size, @@global.max_join_size; Segue aqui a descrio das variveis que usam uma sintaxe SET no padro e algumas ca a a a das outras variveis. A denio das outras variveis podem ser encontrados na seo a ca a ca variveis de sistema, entre as opes de inicializao ou na descrio de SHOW VARIABLES. a co ca ca Veja Seo 6.1.5 [Variveis de sistema], Pgina 475. Veja Seo 4.1.1 [Opes de linha de ca a a ca co comando], Pgina 207. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. a ca a AUTOCOMMIT= 0 | 1 Se congurado com 1 todas alteraes em uma tabela ser feita de uma vez. co a Para iniciar uma transao de vrios comandos, deve ser usada a instruo ca a ca BEGIN. Veja Seo 6.7.1 [COMMIT], Pgina 615. Se congurado com 0 deve ca a ser usado COMMIT/ROLLBACK para aceitar/recusar aquela transao. Veja ca Seo 6.7.1 [COMMIT], Pgina 615. Note que quando voc altera do modo ca a e no-AUTOCOMMIT para AUTOCOMMIT, o MySQL ir fazer um COMMIT automtico a a a em quaisquer transaes abertas. co BIG_TABLES = 0 | 1 Se denido com 1, todas as tabelas temporrias so armazenadas no disco em a a vez de o ser na meria. Isto ser um pouco mais lento, mas voc no ter o erro o a e a a The table tbl_name is full para grandes operaes SELECT que exigem uma co tabela temporria maior. O valor padro para uma nova conexo 0 (isto , usa a a a e e tabelas temporrias em memria) Esta opo era chamada SQL_BIG_TABLES. a o ca No MySQL 4.0 voc normalmente nunca deve precisar deste parmetro j que e a a o MySQL converter automaticamente tabelas em memria para tabelas em a o disco se isto for necessrio. a CHARACTER SET nome_conjunto_caracteres | DEFAULT Mapeia todas as strings do e para o cliente com o mapa especicado. Atualmente a unica opo para character_set_name cp1251_koi8, mas voc pode ca e e adicionar novos mapas editando o arquivo sql/convert.cc na distribuio ca fonte do MySQL. O mapeamento padro pode ser restaurado utilizando o valor a DEFAULT para character_set_name. Perceba que a sintaxe para congurar a opo CHARACTER SET diferente da ca e sintaxe para congurar as outras opoes. c DATE_FORMAT = format_str Determina como o servidor converte valores DATE para strings. Esta varivel a como uma opo global, local ou de linha de comando. format_ est disponivel a ca str pode ser especicado convenientemente usando a funo GET_FORMAT(). ca Veja Veja Seo 6.3.4 [Date and time functions], Pgina 529. ca a DATETIME_FORMAT = format_str Determina como o servidor converte valores DATETIME para string. Esta varivel est dispon como uma opo global, local ou de linha de comando. a a ivel ca format_str pode ser especicada convenientemente usando a funo ca GET_FORMAT(). Veja Veja Seo 6.3.4 [Date and time functions], Pgina 529. ca a

462

MySQL Technical Reference for Version 5.0.0-alpha

INSERT_ID = # Congura o valor que ser usado pelo comando INSERT ou ALTER TABLE seguinte a ao inserir um valor AUTO_INCREMENT. Isto usado principalmente com o log de e atualizaes. co LAST_INSERT_ID = # Congura o valor a ser retornado de LAST_INSERT_ID(). Ele armazenado e no log de atualizaes quando voc utiliza LAST_INSERT_ID() em um comando co e que atualiza uma tabela. LOW_PRIORITY_UPDATES = 0 | 1 Se congurado com 1, todas instrues INSERT, UPDATE, DELETE e LOCK TABLE co WRITE iro esperar at que no existam SELECT ou LOCK TABLE READ pendentes a e a na tabela afetada. Esta opo era chamada SQL_LOW_PRIORITY_UPDATES. ca MAX_JOIN_SIZE = value | DEFAULT No permite que SELECTs que provavelmente necessitem examinar mais que a valor combinaes de registros. Congurando este valor, voc pode obter co e SELECTs onde chaves no so usadas corretamente e que provavelmente gastaro a a a um bom tempo. Congurando-o para um valor diferente do DEFAULT ir denir a o atributo SQL_BIG_SELECTS com o padro. Se voc congurar o atributo SQL_ a e BIG_SELECTS novamente, a varivel SQL_MAX_JOIN_SIZE ser ignorada. Voc a a e pode congurar um valor padro para esta varivel iniciando o mysqld com -O a a max_join_size=#. Esta opo era chamada SQL_MAX_JOIN_SIZE ca Note que se o resultado da consulta ja estiver na cache de consultas, o vericaio acima no ser feita. O MySQL ir enviar o resultado ao cliente. Uma ca a a a vez que o resultado da consulta j foi consultado e no ser responsabilidade a a a do servidor enviar o resultado ao cliente. PASSWORD = PASSWORD(alguma senha) Congura a senha para o usurio atual. Qualquer usurio que no seja annimo a a a o pode alterar sua prpria senha! o PASSWORD FOR user = PASSWORD(alguma senha) Congura a senha para um usurio espec a ico no servidor atual. Somente um usurio com acesso ao banco de dados mysql pode fazer isto. O usurio a a deve ser fornecido no formato usurio@home_maquina, onde usurio e nome_ a a mquina so exatamente o que esto listados nas colunas User e Host da tabela a a a mysql.user. Por exemplo, se voc possui uma entrada com os campos User e e Host com bob e %.loc.gov, voc escreveria: e mysql> SET PASSWORD FOR bob@%.loc.gov = PASSWORD(newpass); Que equivalente a: e mysql> UPDATE mysql.user SET Password=PASSWORD(newpass) -> WHERE User=bob AND Host=%.loc.gov; mysql> FLUSH PRIVILEGES; QUERY_CACHE_TYPE = OFF | ON | DEMAND QUERY_CACHE_TYPE = 0 | 1 | 2 Dene a congurao da cache de consultas para esta thread. Set query cache ca setting for this thread.

Cap tulo 5: Otimizao do MySQL ca

463

Opo ca 0 ou OFF 1 ou ON 2 ou DEMAND

Descrio ca No armazena ou recupera resultados. a Armazena todos os resultados, exceto consultas SELECT SQL_ NO_CACHE .... Armazena apenas consultas SELECT SQL_CACHE ....

SQL_AUTO_IS_NULL = 0 | 1 Se congurado com 1 (padro) o ultimo registro inserido em uma tabela com um a regitro auto incremnto pode ser encontrado com a seguinte construo: WHERE ca auto_increment_column IS NULL. Isto usado por alguns programas ODBC e como o Access. SQL_BIG_SELECTS = 0 | 1 Se congurado com 0, o MySQL aborta as instrues SELECTs que provavelco mente levam muito tempo (isto , instrues para as quais o otimizador estima e co que o nmero de registros examinados provavelmente ir exceder o valor de u a MAX_JOIN_SIZE. Isto util quando uma instruo WHERE no aconselhada for e ca a utilizado. O valor padro para uma nova conexo 1 (que permitir qualquer a a e a instruo SELECT). ca Se voc denir MAX_JOIN_SIZE com um valor diferente de DEFAULT, SQL_BIG_ e SELECTS ser denida com 0. a SQL_BUFFER_RESULT = 0 | 1 SQL_BUFFER_RESULT fora para que o resultado das SELECTs seja colocado em c tabelas temporrias. Isto ir ajudar o MySQL a liberar mais cedos bloqueios a a de tabela e ajudaro em casos onde elas ocupam muito tempo para enviar o a conjunto de resultados para o cliente. SQL_SAFE_UPDATES = 0 | 1 Se congurado com 1, o MySQL ir aborar se tentarmos fazer um UPDATE a ou DELETE sem utilizar uma chave ou LIMIT na clusula WHERE. Desta forma a possivel capturar atualizaes erradas ao criarmos comandos SQL manuale co mente. SQL_SELECT_LIMIT = valor | DEFAULT O nmero mximo de registros para retornar de instrues SELECT. Se uma u a co SELECT tem uma clusula LIMIT, o LIMIT tem precedencia sobre o valor de a e SQL_SELECT_LIMIT. O valor padro para uma nova conexo unlimited (ilima a e itado). Se voc alterou o limite, o valor padro pode ser restaurado atribuindo e a o valor DEFAULT a SQL_SELECT_LIMIT. SQL_LOG_OFF = 0 | 1 Se congurado com 1, nenhum registro ser feito no log padro para este cliente, a a se o cliente tiver o privilgio SUPER. e SQL_LOG_BIN = 0 | 1 Se congurada com 0, nenhum registro feito no log binrio para o cliente, se e a o cliente tiver o privilgio SUPER. e

464

MySQL Technical Reference for Version 5.0.0-alpha

SQL_LOG_UPDATE = 0 | 1 Se congurado com 0, nenhum registro ser feito no log de atualizaes para a co o cliente, se o cliente tiver o privilgio SUPPER. Esta varivel est obsoleta a e a a partir da verso 5.0. a SQL_QUOTE_SHOW_CREATE = 0 | 1 Se congurado com 1, SHOW CREATE TABLE ir colocar os nomes de tabela e a colunas entre aspas. Est ligado por padro, para que replicao de tabelas a a ca com nomes de colunas estranhos funcione. Seo 4.6.8.8 [SHOW CREATE TABLE], ca Pgina 322. a TIMESTAMP = valor_timestamp | DEFAULT Congura a hora/data para este cliente. E usado para obter a hora e data original se voc utiliza o log de atualizaes para restaurar registros. valor_ e co timestamp deve ser um timestamp UNIX Epoch, no um timestamp MySQL. a TIME_FORMAT = format_str Determina como o servidor converte valores TIME para string. Esta varivel est a a dispon como uma opo global, local ou de linha de comando. format_str ivel ca pode ser especicada convenientemente usando a funo GET_FORMAT(). Veja ca Veja Seo 6.3.4 [Date and time functions], Pgina 529. ca a

5.6 Detalhes de Disco

Como mencionado acima, pesquisas em disco so o maior gargalo de desempenho. Estes a problemas cam cada vez mais aparentes quando os dados comeam a crescer tanto que c efetivo armazenamento em cache se torna imposs ivel. Para grandes bancos de dados, onde voc acessa dados mais ou menos aleatoriamente, voc pode ter certeza de que e e precisar de pelo menos uma busca em disco para ler e vrias para gravar os dados. a a Para minimizar este problema, utilize discos com menor tempo de pesquisa. Aumente o nmero de eixo de discos dispon u iveis (e ento reduza a sobrecarga da a pesquisa) ligando arquivos simbolicamente em diferentes discos ou utilizando striping de discos. Usando links simblicos o Signica que, para tabelas MyISAM, voc liga simbolicamente o e indice e/ou arquivos de dados ao local comum no diretrio de dados em outro o disco (que pode tambm ser striped). Isto torna os tempos de pesquisa e e leitura melhor (Se os discos no so usados para outras coisas). Veja a a Seo 5.6.1 [Links simblicos], Pgina 465. ca o a Striping Striping signica que voc possui vrios discos e coloca o primeiro bloco e a no primeiro disco, o segundo bloco no segundo disco, e o N-simo no (N mdulo nmero de discos) disco, e assim por diante. Isto signica que o u se o seu tamanho de dados normais menos que o tamanho do bloco e (ou perfeitamente alinhado) voc ir obter um desempenho muito melhor. e a Striping muito dependente do SO e do tamanho do bloco. Portanto mea e c a performance de sua aplicao com diferentes tamanhos de blocos. Veja ca Seo 5.1.5 [Benchamrks], Pgina 423. ca a

Cap tulo 5: Otimizao do MySQL ca

465

Perceba que a diferena de velocidade para striping muito dependente c e dos parmetros. Dependendo de como voc congura os parmetros do a e a striping e do nmero de discos voc pode obter uma diferena de vrias u e c a ordens de grandeza. Note que voc deve escolher a otimizao randmica e ca o ou pelo acesso sequencial. Para conabilidade voc pode desejar utilizar RAID 0+1 (striping + espelhamento) e mas neste caso voc ir precisar de 2*N discos para armazenar N discos de dados. e a Isto provavelmente a melhor opo se voc possuir dinheiro! Voc pode tambm, e ca e e e entretanto, ter que investir em algum software gerenciador de volumes para lidar com isto ecientemente. Uma boa opo variar os n ca e iveis de RAID de acordo com a importncia do dado. a a Por exemplo, ter dados com alguma importncia que podem ser regenerados em um a armazenamento RAID 0 enquanto os dados realemtente importantes como informaes co de mquinas e logs em um sistema RAID 0+1 ou RAID de N discos. RAID N pode a ser um problema se voc tem vrias escritas devido ao tempo para atualizar os bits de e a paridade. No Linux, voc pode obter um desempenho muito melhor (cerca de 100% sobre carga e pode ser comum) utilizando hdparm para congurar sua interface de disco! O exemplo a seguir deve ser muito util para o MySQL (e provavelmente vrias outras aplicaes): a co hdparm -m 16 -d 1 Perceba que o desempenho e conana ao utilizar o exemplo acima depende de seu c hardware, portanto ns sugerimos que voc teste bem seu sistema depois de utilizar o e hdparm! Por favor consulte a pgina do manual (man) do hdparm para maiores ina formaes! Se o hdparm no for usado corretamente, poder resultar em corrupo do co a a ca sistema de arquivos, assim realize backups de tudo antes de experimentar! Voc pode tambm congurar os parmetros para o sistema de arquivos que o banco e e a de dados usa: Se voc no precisa saber quando os arquivos foram acessados pela ultima vez e a (o que realmente util em um servidor de banco de dados), voc pode montar e e o seu sistema de arquivos com a opo -o noatime. Isto faz com que ele evite a ca atualizao do ultimo tempo de acesso no inode e com isto tambm evita algumas ca e buscas em disco. Em vrios sistemas operacionais os discos podem ser montados com a opo async a ca para congurar o sistema de arquivos a ser atualizado de modo ass incrono. Se o seu computador razoavelmente estvel, isto deve fornecer mais desempenho sem e a sacricar a segurana. (Esta opo ligada por padro no Linux.) c ca e a

5.6.1 Utilizando Links Simblicos o

Voc pode mover tabelas e bancos de dados do diretrio de banco de dados para outras e o localizaes e troc-los por links simblicas para os novos locais. Voc pode fazer isto, por co a o e exemplo, para mover um banco de dados para um sistema de arquivos com mais espao livre c ou aumentar a velocidade de seu sistema esipalhando suas tabelas para discos diferentes.

466

MySQL Technical Reference for Version 5.0.0-alpha

A maneira recomendada de se fazer isto ligar simbolicamente bancos de dados a discos e diferentes e s ligar tabelas como ultimo recurso. o

5.6.1.1 Utilizando Links Simblicos para Bancos de Dados o

No Unix, a maneira de ligar simbolicamente um banco de dados , primeiramente, criar um e diretrio em algum disco onde voc possui espao livre e ento criar uma ligao simblica o e c a ca o para ele a partir do diretrio do banco de dados do MySQL. o shell> mkdir /dr1/databases/test shell> ln -s /dr1/databases/test mysqld-datadir O MySQL no suporta que voc ligue um diretrio a vrios bancos de dados. Trocando um a e o a diretrio de banco de dados com uma ligao simblica ir funcionar bem desde que no o ca o a a sejam feitos links simblicos entre os bancos de dados. Suponha que voc tenha um banco o e de dados db1 sob o diretrio de dados do MySQL, e ento criar uma ligao simblica db2 o a ca o que aponte para db1. shell> cd /caminho/para/diretorio/dados shell> ln -s db1 db2 Agora, para qualquer tabela tbl_a em db1, tambm aparecer uma tabela tbl_a em db2. e a Se uma thread atualizar db1.tbl_a e outra atualizar db2.tbl_a, ocorrero porblemas. a Se voc realmente precisar e mysys/mf_format.c: para if (1) No Windows voc pode utilizar links simblicos para diretrios compilando o MySQL com e o o -DUSE_SYMDIR. Isto lhe permite colocar diferentes bancos de dados em discos diferentes. Veja Seo 5.6.1.3 [Links simblicos no Windows], Pgina 468. ca o a disto, voc e deve alterar o cdigo o seguinte em

if (flag & 32 || (!lstat(to,&stat_buff) && S_ISLNK(stat_buff.st_mode)))

5.6.1.2 Utilizando Links Simblicos para Tabelas o

Antes do MySQL 4.0 voc no deve utilizar tabelas com ligaes simblicas, se voc no tiver e a co o e a muito cuidado com as mesmas. O problema que se voc executar ALTER TABLE, REPAIR e e TABLE ou OPTIMIZE TABLE em uma tabela ligada simbolicamente, os links simblicos sero o a removidas e substituidos pelos arquivos originiais. Isto acontece porque o comando acima funcinoa criando um arquivo temporrio no diretrio de banco de dados e quando o comando a o completo, substitui o arquivo original pelo arquivo temporrio. e a Voc no deve ligar simbolicamente tabelas em um sistema que no possui uma chamada e a a realpath() completa. (Pelo menos Linux e Solaris suportam realpath() No MySQL 4.0 links simblicos s so suportados completamente por tabelas MyISAM. Para o o a outros tipos de tabelas voc provavelmente obter problemas estranhos ao fazer qualquer e a um dos comandos mencionados acima. O tratamento de links simblicos no MySQL 4.0 funciona da seguinte maneira (isto mais o e relevante somente para tabelas MyISAM.

Cap tulo 5: Otimizao do MySQL ca

467

No diretrio de dados voc sempre ter o arquivo de denies das tabelas e os arquivos o e a co de indice e o arquivo de dados. O arquivo de dados e o arquivo de indice podem ser movidos para qualquer lugar e substituidos no diretorio de dados pelos links simblicos. o O arquivo de denio no pode. ca a Voc pode ligar simbolicamente o arquivo e indice e o arquivo de dados para diretrios o diferentes, independente do outro arquivo. A ligao pode ser feita partir do sistema operacional (se o mysqld no estiver em exca a ecuo) ou usando as opes DATA DIRECTORY ou INDEX DIRECTORY em CREATE TABLE. ca co Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a myisamchk no ir substituir um link simblico pelo a a o indice/arquivo. Ele funciona diretamente nos arquivos apontados pelos links simblicos. Qualquer arquivo temporrio o a ser criado no mesmo diretrio que o arquivo de dados/indice est. a o a Quando voc remove uma tabela que est usando links simblicos, o link e o arquivo e a o para o qual ela aponta so apagados. Esta uma boa razo pela qual voc n~o deve a e a e a executar mysqld como root e no deve permitir que pessoas tenham acesso de escrita a ao diretrios de bancos de dados do MySQL. o Se voc renomear uma tabela com ALTER TABLE RENAME e no deseja alterar o banco de e a dados, o link simblico para o diretrio de banco de dados ser renomeada corretamente. o o a Se voc utiliza ALTER TABLE RENAME para mover uma tabela para outro banco de dados, e ento a tabela ser movida para outro diretrio de banco de dados e os links simblicos a a o o antigos e os arquivos para os quais eles apontam sero removidos. a Se voc no utiliza links simblicos, voc deve usar a opo --skip-symlink do mysqld e a o e ca para garantir que ningum pode usar mysqld para apagar ou renomear um arquivo fora e do diretrio de dados. o O que ainda no suportado: a e ALTER TABLE ignora todas as opes de tabela DATA DIRECTORY e INDEX DIRECTORY. co SHOW CREATE TABLE no relata se a tabela possui links simblicos antes do MySQL a o 4.0.15. Isto tambm verdade para mysqldump que usa SHOW CREATE TABLE para gerar e e instrues CREATE TABLE. co BACKUP TABLE e RESTORE TABLE no respeitam links simblicos. a o O arquivo frm nunca deve ser um link simblico (como dito anteriormente, apenas o os dados e indices podem ser links simblicos). Fazer isto (por exemplo para fazer o sinnimos), produzir resultados errados. Suponha que voc tenha um banco de dados o a e db1 sob o diretrio de dados do MySQL, uma tabela tbl1 neste banco de dados e voc o e faa um link simblico tbl2 no diretrio db1 que aponmta para tbl1: c o o shell> shell> shell> shell> cd ln ln ln /path/to/datadir/db1 -s tbl1.frm tbl2.frm -s tbl1.MYD tbl2.MYD -s tbl1.MYI tbl2.MYI

Agora se uma thread l db1.tbl1 e outra thread atualiza db1.tbl2, haver problee a mas: a cache de consultas ser enganada (ela acreditar que tbl1 no foi atualizado e a a a retornar resultados desatualizados), o comando ALTER em tbl2 tambm ir falhar. a e a

468

MySQL Technical Reference for Version 5.0.0-alpha

5.6.1.3 Usando Links Simblicos para Bancos de Dados no o Windows

A partir do MySQL verso 3.23.16, o mysqld-max e servidores mysql-max-nt na distribuio a ca MySQL so compilados com a opo -DUSE_SYMDIR. Isto permite que voc coloque um dia ca e retrio de banco de dados em discos diferentes adicionando um link simblico para ele. (Isto o o parecido com o a com que links simblicos funcionam no Unix, embora o procedimento e o para congurar o link seja diferente). No Windows, voc cria um link simblico para um banco de dados MySQL criando um e o arquivo que contem o caminho para o diretrio de destino. Salve o arquivo no diretrio o o de dados usando o nome de arquivo nome_bd.sym, onde nome_bd o nome do banco de e dados. Por exemplo, se o diretrio de dados do MySQL C:\mysql\data e voc precisa o e e ter o banco de dados foo localizado em D:\data\foo, voc deve criar o arquivo e C:\mysql\data\foo.sym que contm o caminho D:\data\foo\. Depois disto, todas e tabelas criadas no banco de dados foo sero criadas no D:\data\foo. O diretrio a o D:\data\foo deve existir para ele funcionar. Note tambm que o link simblico no ser e o a a usado se um diretrio com o nome do banco de dados existe no diretrio de dados MySQL. o o Isto signica que se voc j tem um diretrio de banco de dados chamado foo no direorio e a o de dados, voc deve mov-lo para D:\data antes do link simblico ser efetivado. (Para e e o evitar problemas, o servidor no deve estar executando quando voc mover o diretrio do a e o banco de dados.) Note que devido a penalidade que voc tem na velocidade quando abre todas as tabelas, e ns no habilitamos esta opo por padro, mesmo se voc compilar o MySQL com suporte o a ca a e a isto. Para habilitar links simblicos voc deve colocar no seu arquivo my.cnf ou my.ini o e a seguinte entrada: [mysqld] symbolic-links No MySQL 4.0 --simbolic-links est habilitado por padro. Se voc no precisa us-lo a a e a a voc pode usar a opo skip-symbolic-linkd. e ca

Cap tulo 6: Referncia de Linguagem do MySQL e

469

6 Referncia de Linguagem do MySQL e

O MySQL possui uma interface SQL muito complexa mas intuitiva e fcil de aprender. Este a cap itulo descreve os vrios comandos, tipos e funes que voc precisa conhecer para usar o a co e MySQL de maneira eciente e efetiva. Este cap itulo tambm serve como referncia para toe e das as funcionalidades inclu idas no MySQL. Para poder utilizar este cap itulo ecientemente, voc deve achar util fazer referncia aos vrios e e a indices.

6.1 Estrutura da Linguagem

6.1.1 Literais: Como Gravar Strings e Numerais
Esta seo descreve as diversas maneiras para gravar strings e nmeros no MySQL. Ela ca u tambm cobre as vrias nuances e pegadinhas pelas quais voc pode passar ao lidar com e a e estes tipos bsicos no MySQL. a

6.1.1.1 Strings
Uma string uma sequncia de caracteres, cercada por caracteres de aspas simples () e e ou duplas (") (Se voc utiliza o modo ANSI deve utilizar somente as aspas simples). e Exemplos: uma string "outra string" Em uma string, certas sequncias tem um signicado especial. Cada uma destas sequncias e e comeam com uma barra invertida (\), conhecida como caracter de escape. O MySQL c reconhece a seguinte sequncia de escape: e \0 \ \" \b \n \r \t \z Um caracter ASCII 0 (NUL). Um caracter de aspas simples (). Um caracter de aspas duplas ("). Um caracter de backspace. Um caracter de nova linha. Um caracter de retorno de carro. Um caracter de tabulao. ca ASCII(26) (Control-Z). Este caracter pode ser codicado para permitir que voc e contorne o problema que o ASCII(26) possui comoEND-OF-FILE ou EOF (Fim do arquivo) no Windows. (ASCII(26) ir causar problemas se voc tentar usar a e mysql banco_dados < nome_arquivo). O caracter de barra invertida (\) character. Um caracter %. Ele pode ser usado para pesquisar por instncias literais de % a em contextos onde % deve, de outra maneira, ser interpretado como um meta caracter. Veja Seo 6.3.2.1 [Funes de comparaes de string], Pgina 519. ca co co a

\\ \%

470

MySQL Technical Reference for Version 5.0.0-alpha

\_

Um caracter _. Ele usado para pesquisar por instncias literais de _ em e a contextos onde _ deve, de outra maneira, ser intrerpretado como um meta caracter. Veja Seo 6.3.2.1 [Funes de comparaes de string], Pgina 519. ca co co a

Note que se voc utilizar \% ou \_ em alguns contextos de strings, eles retornaro as e a strings \% e \_ e no % e _. a Estas so as vrias maneiras de incluir aspas com uma string: a a Um dentro de uma string com pode ser escrita como . Um " dentro de uma string com " pode ser escrita como "". Voc pode preceder o caracter de aspas com um caracter de escape (\). e Um dentro de uma string com " no precisa de tratamento especial e no precisa a a ser duplicada ou utilizada com caracter de escape. Da mesma maneira, " dentro de uma string com no necessita de tratamento especial. a As instrues SELECT exibidas abaixo demonstram como citaes e escapes funcionam: co co mysql> SELECT hello, "hello", ""hello"", hello, \hello; +-------+---------+-----------+--------+--------+ | hello | "hello" | ""hello"" | hello | hello | +-------+---------+-----------+--------+--------+ mysql> SELECT "hello", "hello", "hello", "hel""lo", "\"hello"; +-------+---------+-----------+--------+--------+ | hello | hello | hello | hel"lo | "hello | +-------+---------+-----------+--------+--------+ mysql> SELECT "This\nIs\nFour\nlines"; +--------------------+ | This Is Four lines | +--------------------+ Se voc deseja inserir dados binrios em uma coluna BLOB, os caracteres a seguir devem ser e a representados por sequncias de espace: e NUL \ " ASCII 0. Voc deve represent-lo como \0 (uma barra invertida e um caractere e a 0). ASCII 92, barra invertida. Representado como \\. ASCII 39, aspas simples. Representado como \. ASCII 34, aspas duplas. Representado como \".

Se voc escreve cdigo C, voc pode utilizar a funo da API C mysql_escape_string() e o e ca para caracteres de escape para a instruo INSERT. Veja Seo 12.1.2 [Viso geral da ca ca a funo API C], Pgina 778. No Perl, pode ser utilizado o mtodo quote do pacote DBI ca a e para converter caracteres especiais para as sequncias de escape corretas. Veja Seo 12.5.2 e ca [Classe DBI do Perl], Pgina 881. a

Cap tulo 6: Referncia de Linguagem do MySQL e

471

Deve ser utilizada uma funo de escape em qualquer string que contm qualquer um dos ca e caracteres especiais listados acima! Alternativamente, muitas APIs do MySQL fornecem algumas da capacidades de placeholder que permitem que voc insira marcadores especiais em um string de consulta e ento ligar e a os valores dos dados a eles quando voc executa a consulta. Neste caso, a API inclui, e automaticamente, os caracteres especiais de escape nos valores para voc. e

6.1.1.2 N meros u
Inteiros so representados como uma sequncia de d a e igitos. Nmeros de ponto utuante u utilizam . como um separador decimal. Ambos os tipos devem ser precedidos por - para indicar um valor negativo. Exemplos de inteiros vlidos: a 1221 0 -32 Exemplo de nmeros de ponto utuante vlidos: u a 294.42 -32032.6809e+10 148.00 Um inteiro pode ser usado em um contexto de ponto utuante; ele interpretado como o e de ponto utuante equivalente. A partir da verso 4.1.0, a constante TRUE avaliada com 1 e FALSE avaliada com 0. a e e

6.1.1.3 Valores Hexadecimais

O MySQL suporta valores hexadecimais. No contexto numrico estes atuam como um e inteiro (preciso de 64-bits). No contexto de strings, atuam como uma string binria onde a a cada par de d igitos hexadecimais convertido para um caracter: e mysql> SELECT x4D7953514C; -> MySQL mysql> SELECT 0xa+0; -> 10 mysql> SELECT 0x5061756c; -> Paul No MySQL 4.1 (e no MySQL 4.0 quando usado com a opa --new) o tipo padro de um co a valor hexadecimal uma string. Se voc deseja estar certo que a string tratado como um e e e nmero, voc pode usar CAST( ... AS UNSIGNED) no valor hexadecimal. u e A sintaxe xstringhexa (nova na verso 4.0) baseada no padro SQL e a sintaxe 0x a e a e baseada no ODBC. Strings hexadecimeis so frequentemente usadas pelo ODBC para suprir a valores para colunas BLOB. Voc pode converter uma string ou um nmero no formato e u hexadecimal com a funo HEX(). ca

472

MySQL Technical Reference for Version 5.0.0-alpha

6.1.1.4 Valores NULL

O valor NULL signica sem dados e diferente de valores como 0 para tipos numricos ou e e strings vazias para tipos string. Veja Seo A.5.3 [Problemas com NULL], Pgina 932. ca a NULL pode ser representado por \N ao usar o formato de arquivo texto para importao ou ca exportao (LOAD DATA INFILE, SELECT ... INTO OUTFILE). Veja Seo 6.4.8 [LOAD DATA], ca ca Pgina 588. a

6.1.2 Nomes de Banco de dados, Tabela, Indice, Coluna e Alias

Nomes de banco de dados, tabela, indice, coluna e apelidos seguem todos as mesmas regras no MySQL. Note que as regras foram alteradas a partir do MySQL verso 3.23.6, quando introduzimos a aspas em identicadores (nomes banco de dados, tabela e coluna) com . " funcionar a tambm para citar identicadores se voc executar no modo ANSI. Veja Seo 1.8.2 [Modo e e ca ANSI], Pgina 42. a Identicador Banco dados Tabela Coluna Alias de Tamanho mximo a (bytes) 64 64 64 255 Caracteres permitidos Qualquer caractere que permitido em um nome de diretrio e o exceto / ou .. Qualquer caractere permitido em um nome de arquivo, exceto / ou .. Todos os caracteres. Todos os caracteres.

Note que em adio ao mostrado acima, voc no pode ter ASCII(0) ou ASCII(255) ou o ca e a caracter de citao (aspas) em um identicador. ca Se o identicador uma palavra restrita ou contm caracteres especiais voc deve sempre e e e coloc-lo entre ao us-lo: a a mysql> SELECT * FROM select WHERE select.id > 100; Veja Seo 6.1.7 [Reserved words], Pgina 479. ca a Se voc estiver executando o MySQL no modo MAXDB ou ANSI_QUOTES, ele tambm pode e e citar identicadores com aspas duplas: mysql> CREATE TABLE "test" (col INT); ERROR 1064: You have an error in your SQL syntax. (...) mysql> SET SQL_MODE="ANSI_QUOTES"; mysql> CREATE TABLE "test" (col INT); Query OK, 0 rows affected (0.00 sec) Veja Seo 4.1.1 [Command-line options], Pgina 207. ca a Em verses do MySQL anteriores a 3.23.6, as regras se nomes eram as seguintes: o Um nome pode consistir de caracteres alfanumricos do conjunto atual de caractres e e tambm _ e $. O conjunto de caracteres padro o ISO-8859-1 Latin1; e pode e a e ser alterado com a opo --default-character-set no mysqld. Veja Seo 4.7.1 ca ca [Conjunto de caracteres], Pgina 325. a

Cap tulo 6: Referncia de Linguagem do MySQL e

473

Um nome pode iniciar com qualquer caractere que legal no nome. Em particular, e pode iniciar com um nmero (isto difere de vrios outros sistemas de bancos de dados!). u a Entretanto um nome no pode consistir somente de nmeros. a u O caractere . no pode ser utilizado em nomes porque ele usado para extender o a e formato pelo qual voc pode fazer referncias a colunas (veja abaixo). e e E recomendado que voc no utilize nomes como 1e, porque uma expresso como 1e+1 e a a e ambigua. Ela pode ser interpretada como a expresso 1e + 1 ou como o nmero 1e+1. a u No MySQL voc pode se referir a uma coluna utilizando uma das formas seguintes: e Signicado Coluna nome_campo de qualquer tabela usada na consulta contendo uma coluna com aquele nome. nome_tabela.nome_campo Coluna nome_campo da tabela nome_tabela do banco de dados atual. nome_bd.nome_tabela.nome_ Coluna nome_campo da tabela nome_tabela do banco campo de dados nome_bd. Esta forma dispon e ivel no MySQL Verso 3.22 ou posterior. a nome_coluna Uma coluna que uma palavra chave ou contem carace teres especiais. Voc no precisa especicar um prexo de nome_tabela ou nome_bd.nome_tabela para e a uma referncia de coluna em uma instruo, a menos que a referncia seja amb e ca e igua. Por exemplo, suponha que cada tabela t1 e t2 contenham uma coluna c, e voc deve recuperar e c em uma instruo SELECT que utiliza ambas tabelas t1 e t2. Neste caso, c amb ca e iguo porque ele no unico entre as tabelas usadas na instruo, portanto deve ser indicado qual a e ca a tabela que se deseja escrever, t1.c ou t2.c. De mesma forma, se voc for recuperar de e e uma tabela t em um banco de dados db1 e uma tabela t em um banco de dados db2, voc e deve se refererir `s colunas nestas tabelas como db1.t.nome_campo e db2.t.nome_campo. a A sintaxe .nome_tabela indica a tabela nome_tabela no banco de dados atual. Esta sintaxe aceitada para compatibilidade ODBC, porque alguns programas ODBC prexam e os nomes das tabelas com um caracter .. Coluna de referncia e nome_campo

6.1.3 Caso Sensitivo nos Nomes

No MySQL, bancos de dados e tabelas correspondem a diretrios e arquivos em seus dio retrios. Consequentemente, o caso sensitivo no sistema operacional ir determinar o caso o a sensitivo nos nomes de bancos de dados e tabelas. Isto signica que nomes de bancos de dados e tabelas so caso sensitivo na maioria dos Unix e caso insensitivo no Windows. Uma a exceo proeminente aqui o Mac OS X, quando o o sistema de arquivos padro HPS+ est ca e a a sendo usado. No entanto o Mac OS X tambm suporta volumes UFS, esle so caso sensitivo e a no Mac OS X assim como so no Unix. Veja Seo 1.8.3 [Extenses ao ANSI], Pgina 43. a ca o a NOTA: Apesar de nomes de bancos e tabelas serem caso insensitivo no Windows, voc no e a deve fazer referncia a um certo banco de dados ou tabela utilizando casos diferentes na e mesma consulta. A consulta a seguir no deve funcionar porque ela chama uma tabela a como minha_tabela e outra como MINHA_TABELA. mysql> SELECT * FROM minha_tabela WHERE MINHA_TABELA.col=1; Nomes de colunas no so caso sensitivo em todas as circunstncias. a a a

474

MySQL Technical Reference for Version 5.0.0-alpha

Aliases nas tabelas so caso sensitivo. A consulta seguinte no deve funcionar porque ela a a faz referncia ao alias como a e como A. e mysql> SELECT nome_campo FROM nome_tabela AS a WHERE a.nome_campo = 1 OR A.nome_campo = 2; Se voc tem um problema para lembrar o caso usado para os nomes de tabelas, adote uma e conveno consistente, como sempre criar bancos de dados e tabelas utilizando nomes em ca minsculas. u Uma maneira para evitar este problema iniciar o mysqld com -O lower_case_nome_ e tabelas=1. Por padro esta opo 1 no Windows e 0 no Unix. a ca e Se lower_case_nome_tabelas for 1, o MySQL ir converte todos os nomes de tabelas para a minsculo no armazenamento e pesquisa. (A partir da verso 4.0.2, esta opo tambm u a ca e se aplica ao nome do banco de dados. A partir da 4.1.1 isto tambm se aplica a alias de e tabelas). Perceba que se voc alterar esta opo, ser necessrio converter primeiramente e ca a a seus nomes de tabelas antigos para minsculo antes de iniciar o mysqld. u Se voc mover os arquivos MyISAM do Windows pare o Unix, voc pode, em alguns casos, e e precisar usar a ferramenta mysql_fix_extensions para corrigir o caso ad extenso do a arquivo em cada diretrio de banco de dados espec o ico (.frm em letra minscula, .MYI e u .MYD em letras maisculas). mysql_fix_extensions pode ser encontado no subdiretrio u o scripts.

6.1.4 Variveis de Usurio a a

O MySQL suporta variveis espec a icas da conexo com a sintaxe @nomevarivel. Um a a nome de varivel pode consiste de caracteres alfanumricos do conjunto de caracteres atual a e e tambm _, $ e .. O conjunto de caracteres padro ISO-8859-1 Latin1; ele pode ser e a e alterado com a opo --default-character-set do mysqld. Veja Seo 4.7.1 [Conjunto ca ca de caracteres], Pgina 325. Os nomes das variveis de usurios so caso insensitivo nas a a a a verso >= 5.0 e caso sensitivo nas verses < 5.0. a o As variveis no precisam ser inicializadas. Elas contm NULL por padro e podem ara a e a mazenar um valor inteiro, real ou uma string. Todas as variveis de uma thread so autoa a maticamente liberadas quando uma thread termina. Voc pode congurar uma variavel com a syntaxe SET. e SET @varivel= { expressao inteira | expressao real | expressao string } a [,@varivel= ...]. a Voc tambm pode atribuir um valor a uma varivel em outras instrues diferentes de SET. e e a co No entanto, neste caso o operador de atribuio := em vez de =, porque = reservado ca e e para comparaes em instrues diferentes de SET: co co mysql> SET @t1=0, @t2=0, @t3=0; mysql> SELECT @t1:=(@t2:=1)+@t3:=4,@t1,@t2,@t3; +----------------------+------+------+------+ | @t1:=(@t2:=1)+@t3:=4 | @t1 | @t2 | @t3 | +----------------------+------+------+------+ | 5 | 5 | 1 | 4 | +----------------------+------+------+------+

Cap tulo 6: Referncia de Linguagem do MySQL e

475

Variveis de usurios devem ser utilizadas em expresses onde so permitidas. Isto no a a o a a inclui utiliza-las em contextos onde um nmero explicitamente necessrio, assim como u e a na clusula LIMIT de uma instruo SELECT ou a clausula IGNORE number LINES de uma a ca instruo LOAD DATA. ca NOTE: Em uma instruo SELECT , cada expresso s avaliada quando enviada ao cliente. ca a oe Isto signica que nas clusula HAVING, GROUP BY, ou ORDER BY, voc no pode fazer referncia a e a e a uma expreeso que envolve variveis que so conguradas na instruo SELECT. Por a a a ca examplo, a seguinte instruo NAO funcionar como o esperado: ca a SELECT (@aa:=id) AS a, (@aa+3) AS b FROM nome_tabela HAVING b=5; A razo que o @aa no ir conter o valor da linha atual, mas o valor da id da linha a e a a previamente aceita. A regra geral nunca atribuir e usar a mesma varivel na mesma instruo. e a ca Outra questo com congurar uma varivel e us-la na mesma instruo que o tipo do a a a ca e resultado padro de uma varivel baseada no tipo da varivel no in a a e a icio da instruo. ca (Assume-se que uma varivel no atribu possui o valor NULL e do tipo STRING). O a a ida e seguitne exemplo ilustra isto: mysql> SET @a="test"; mysql> SELECT @a,(@a:=20) FROM table_name; Neste caso o MySQL relatar ao cliente que a coluna 1 uma string e converte todos os a e acessos de @a a strings, mesmo que @a seja congurada com um nmero para a segunda u linha. Depois que a instruo executada @a ser considerado como um nmero. ca e a u Se voc tiver qualquer problema com isto, evite tanto congurar e usar a mesma varivel e a na mesma instruo ou congurar a varivel com 0, 0.0 ou "" antes de us-la. ca a a

6.1.5 Variveis de Sistema a

A partir do MySQL 4.0.3 fornecemos melhor acesso a diversas variveis de sistema e conexo. a a Pode-se alterar a maioria dele ser ter de desligar o servidor. Exite dois tipos de variveis de sistema: Espec a ica de threads (ou espec ica da conexo), a variveis que esto apenas na conexo atual e variveis globais que so usadas para coniga a a a a urqar eventos globais. Variveis globais tambm so usadas para congurar os valores a e a iniciais da varivel espec a ica da thread correspondente a nova conexo. a Quando o mysqld inicia, todas as variveis globais so inicialisadas a partir dos argumentos a a de linha de comando e arquivos de opo. Voc pode alterar o valor com o comando SET ca e GLOBAL command. Quando uma nova thread criada, a varivel espec e a ica da thread e iniciada a partir das variveis globais e no alteram mesmo se voc executar um novo a a e comando SET GLOBAL. Para denir os valor de uma varivel GLOBAL, voc deve usar uma das seguintes sintaxes: a e (Aqui usamos sort_buffer_size como uma varivel exemplo). a SET GLOBAL sort_buffer_size=valor; SET @@global.sort_buffer_size=valor; Para denir o valor de uma varivel SESSION, voc pode usar uma das seguintes sintaxes: a e

476

MySQL Technical Reference for Version 5.0.0-alpha

SET SESSION sort_buffer_size=valor; SET @@session.sort_buffer_size=valor; SET sort_buffer_size=valor; Se voc no especicar GLOBAL ou SESSION ento ser usado SESSION. Veja Seo 5.5.6 e a a a ca [SET OPTION], Pgina 460. a LOCAL um sinnimo para SESSION. e o Para recuperar o valor de uma varivel GLOBAL voc pode usar um dos seguintes comandos: a e SELECT @@global.sort_buffer_size; SHOW GLOBAL VARIABLES like sort_buffer_size; Para retornar o valor de uma varivel SESSION voc pode usar um dos seguintes comandos: a e SELECT @@session.sort_buffer_size; SHOW SESSION VARIABLES like sort_buffer_size; Quando voc retorna o valor de uma carivel com a sintaxe @@nome_varivel e voc e a a e no especicar GLOBAL ou SESSION ento o MySQL retornar o valor espec a a a ico da thread (SESSION), se ele existir. Se no, o MySQL retornar o valor global. a a A razo da exigncia de GLOBAL apenas para denir a varivel GLOBAL, mas no para recua e a a per-la e assegurar que no criemos problemas posteriormente ao introduzirmos um varivel a a a especica da thread com o mesmo nome ou remover uma varivel especica da thread. Neste a caso, voc pode acidentalmente alterar o estado do servidor como um todo, e no apenas e a em sua conexo. a A seguir apresentamos uma lista completa de todas as variveis que altera e recupera se a voc pode usar GLOBAL ou SESSION com elas. e Nome Varivel a Tipo Valor Tipo autocommit bool SESSION big tables bool SESSION binlog cache size num GLOBAL bulk insert buer size num GLOBAL | SESSION concurrent insert bool GLOBAL connect timeout num GLOBAL convert character set string SESSION delay key write OFF | ON | ALL GLOBAL delayed insert limit num GLOBAL delayed insert timeout num GLOBAL delayed queue size num GLOBAL error count num SESSION ush bool GLOBAL ush time num GLOBAL foreign key checks bool SESSION identity num SESSION insert id bool SESSION interactive timeout num GLOBAL | SESSION join buer size num GLOBAL | SESSION key buer size num GLOBAL

Cap tulo 6: Referncia de Linguagem do MySQL e

477

last insert id local inle log warnings long query time low priority updates max allowed packet max max max max max binlog cache size binlog size connect errors connections error count

bool bool bool num bool num num num num num num num num num num num num num num num num num num num num num num num num enum num num num bool num

max delayed threads max heap table size max join size max relay log size max sort length max tmp tables max user connections max write lock count myisam max extra sort le size myisam repair threads myisam max sort le size myisam sort buer size net buer length net read timeout net retry count net write timeout query cache limit query cache size query cache type read buer size read rnd buer size rpl recovery rank safe show database server id

SESSION GLOBAL GLOBAL GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL GLOBAL GLOBAL GLOBAL GLOBAL SESSION GLOBAL GLOBAL SESSION GLOBAL SESSION GLOBAL GLOBAL SESSION GLOBAL GLOBAL GLOBAL GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL GLOBAL GLOBAL GLOBAL SESSION GLOBAL SESSION GLOBAL GLOBAL GLOBAL

| | |

| | | |

| | | | | | | |

| |

478

MySQL Technical Reference for Version 5.0.0-alpha

slave compressed protocol slave net timeout slow launch time sort buer size sql sql sql sql sql sql sql sql auto is null big selects big tables buer result log binlog log o log update low priority updates

bool num num num bool bool bool bool bool bool bool bool num bool bool bool num bool num enum num bool enum enum num num bool

sql max join size sql quote show create sql safe updates sql select limit sql slave skip counter sql warnings table cache table type thread cache size timestamp tmp table size tx isolation wait timeout warning count unique checks

GLOBAL GLOBAL GLOBAL GLOBAL SESSION SESSION SESSION SESSION SESSION SESSION SESSION SESSION GLOBAL SESSION GLOBAL SESSION SESSION SESSION SESSION GLOBAL SESSION GLOBAL GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION GLOBAL SESSION SESSION SESSION

| |

| | |

Variveis marcadas com num podem ter um valor numrico. Variveis marcadas com bool a e a podem ser denidas com 0, 1, ON ou OFF. Variveis do tipo enum devem, normalmente, ser a atribu idas com um dos valores dispon iveis para a varivel, mas podem tambm ser denidas a e com o nmero correspondente ao valor enum. (O primeiro valor enum 0). u e Aqui est uma descrio de algumas das variveis: a ca a Variveis a identity sql low priority updates sql max join size version Descrio ca Alias para Alias para Alias para Alias para last insert id (compatibilidade com Sybase) low priority updates max join size VERSION() (compatibilidade com Sybase (?))

Uma descrio da outra denio de tabela pode ser encontrada na seo de opes de ca ca ca co inicializao, na descrio de SHOW VARIABLES e na seo SET. Veja Seo 4.1.1 [Opes de ca ca ca ca co linha de comando], Pgina 207. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. Veja a ca a Seo 5.5.6 [SET OPTION], Pgina 460. ca a

Cap tulo 6: Referncia de Linguagem do MySQL e

479

6.1.6 Sintaxe de Comentrios a

O servidor MySQL suporta os estilos de comentrio # no fim da linha, -- no fim da linha a e /* na linha ou em multiplas linhas */ mysql> select 1+1; # Este comentrio continua at o fim da linha a e mysql> select 1+1; -- Este comnetrio continua at o fim da linha a e mysql> select 1 /* Este um comentrio de linha */ + 1; e a mysql> select 1+ /* Este um comentrio e a de mltiplas linhas u */ 1; Note que o estilo de comentrio -- requer que pelo menos um espao aps o cdigo --! a c o o Embora o servidor entenda as sintaxes de comentrios aqui descritas, existem algumas a limites no modo que o cliente mysql analisa o comentrio /* ... */: co a Caracteres de aspas simples e aspas duplas so utilizados para indicar o in de uma a icio string com aspas, mesmo dentro de um comentrio. Se as aspas no coincidirem com a a uma segunda aspas dentro do comentrio, o analisador no percebe que o comentrio a a a tem um m. Se voc estiver executando o mysql interativamente, voc pode perceber e e a confuso ocorrida por causa da mudana do prompt de mysql> para > ou ">. a c Um ponto e virgula utilizado para indicar o m de uma instruo SQL e qualquer e ca coisa que venha aps ele indica o in da prxima instruo. o icio o ca Estas limitaes se aplicam tanto a quando se executa mysql interativamente quanto quando co se coloca oos comandos em um arquivo e pede para que mysql leia as entradas deste arquivo com o comando mysql < some-file. MySQL suporta o estilo de comentrio SQL-99 -- apenas se o segundo trao for seguido a c de espao Veja Seo 1.8.4.7 [ANSI di comments], Pgina 51. c ca a

6.1.7 Tratamento de Palavras Reservadas no MySQL

Um problema comum ocorre quando tentamos criar tabelas com nome de campo que usam nomes de tipos de dados ou funes criadas no MySQL, com TIMESTAMP ou GROUP, Voc co e poder fazer isso (por exemplo, ABS um nome de campo permitido). No entanto espaos a e c no so permitidos entre o nome da funo e o caracter (, assim a funo pode ser distina a ca ca guida de uma referncia a um nome de coluna. e Se voc iniciar o servidor com a opo --ansi ou --sql-mode=IGNORE_SPACE, o servidor e ca permite que a chamada da funo tenha um espao entre um nome de funo e o caracter ca c ca ( seguinte. Isto faz com que o nome da funao seja tratado como uma palavra reservada; c como um resultadom nomes de coluna que so o mesmo que o nome de uma funo devem a ca ser colocada entre aspas como descrito em Seo 6.1.2 [Legal names], Pgina 472. ca a As seguintes palavras so explicitamente reservadas em MySQL. Muitas delas so proibidas a a pelo ANSI SQL92 como nomes de campos e/ou tabelas. (por examplo, group). Algumas poucas so reservadasporque o MySQL precisa delas e est usando (atualmente) um a a analisador yacc:

480

MySQL Technical Reference for Version 5.0.0-alpha

Word ADD ANALYZE ASC BDB BETWEEN BLOB CALL CHANGE CHECK COLUMNS CONSTRAINT CROSS CURRENT_TIMESTAMP DATABASES DAY_MINUTE DECIMAL DELAYED DESCRIBE DISTINCTROW DROP ENCLOSED EXIT FETCH FOR FOUND FULLTEXT HAVING HOUR_MINUTE IGNORE INFILE INOUT INT INTO ITERATE KEYS LEAVE LIMIT LOCALTIME LONG LOOP MATCH MEDIUMTEXT MINUTE_SECOND NOT NUMERIC OPTION

Word ALL AND ASENSITIVE BEFORE BIGINT BOTH CASCADE CHAR COLLATE CONDITION CONTINUE CURRENT_DATE CURSOR DAY_HOUR DAY_SECOND DECLARE DELETE DETERMINISTIC DIV ELSE ESCAPED EXPLAIN FIELDS FORCE FRAC_SECOND GRANT HIGH_PRIORITY HOUR_SECOND IN INNER INSENSITIVE INTEGER IO_THREAD JOIN KILL LEFT LINES LOCALTIMESTAMP LONGBLOB LOW_PRIORITY MEDIUMBLOB MIDDLEINT MOD NO_WRITE_TO_BINLOG ON OPTIONALLY

Word ALTER AS AUTO_INCREMENT BERKELEYDB BINARY BY CASE CHARACTER COLUMN CONNECTION CREATE CURRENT_TIME DATABASE DAY_MICROSECOND DEC DEFAULT DESC DISTINCT DOUBLE ELSEIF EXISTS FALSE FLOAT FOREIGN FROM GROUP HOUR_MICROSECOND IF INDEX INNODB INSERT INTERVAL IS KEY LEADING LIKE LOAD LOCK LONGTEXT MASTER_SERVER_ID MEDIUMINT MINUTE_MICROSECOND NATURAL NULL OPTIMIZE OR

Cap tulo 6: Referncia de Linguagem do MySQL e

481

ORDER OUTFILE PRIVILEGES READ REGEXP REPLACE RETURN RLIKE SENSITIVE SHOW SONAME SQL SQLWARNING SQL_SMALL_RESULT SQL_TSI_HOUR SQL_TSI_QUARTER SQL_TSI_YEAR STRAIGHT_JOIN TABLES TIMESTAMPADD TINYINT TRAILING UNION UNSIGNED USE UTC_DATE VALUES VARCHARACTER WHERE WRITE ZEROFILL

OUT PRECISION PROCEDURE REAL RENAME REQUIRE REVOKE SECOND_MICROSECOND SEPARATOR SMALLINT SPATIAL SQLEXCEPTION SQL_BIG_RESULT SQL_TSI_DAY SQL_TSI_MINUTE SQL_TSI_SECOND SSL STRIPED TERMINATED TIMESTAMPDIFF TINYTEXT TRUE UNIQUE UPDATE USER_RESOURCES UTC_TIME VARBINARY VARYING WHILE XOR

OUTER PRIMARY PURGE REFERENCES REPEAT RESTRICT RIGHT SELECT SET SOME SPECIFIC SQLSTATE SQL_CALC_FOUND_ROWS SQL_TSI_FRAC_SECOND SQL_TSI_MONTH SQL_TSI_WEEK STARTING TABLE THEN TINYBLOB TO UNDO UNLOCK USAGE USING UTC_TIMESTAMP VARCHAR WHEN WITH YEAR_MONTH

Os simbolos seguintes (da tabela acima) no so permitidos pelo SQL-99 mas permitidos a a pelo MySQL como nome de campos/tabelas. Isto ocorre porque alguns destes nomes so a muito naturais e vrios pessoas j o utilizaram. a a ACTION BIT DATE ENUM NO TEXT TIME TIMESTAMP

482

MySQL Technical Reference for Version 5.0.0-alpha

6.2 Tipos de Campos

MySQL suporta um certo nmeros de tipos de campos que podem ser agrupaos em trs cateu e gorias: tipos numricos, tipos de data e hora, e tipos string (caracteres). Esta seo primeiro e ca lhe d uma viso geral dos tipos dispon a a iveis e resume as exigencias de armazenamento em cada tipo de coluna, tambm fornece uma descrio mais detalhada da propriedade dos e ca tipos em cada categoria. A viso dada propositalmente breve. As descries mais detala e co hdas devem ser consultadas para informaes adicionais sobre tipos de campo particulares co como os formatos permitidos nos quais voc pode especicar valores. e Os tipos de campos suportados pelo MySQL esto listados abaixo: As seguintes letras so a a usadas como cdigo nas descries: o co M D Indica o tamanho mximo do display. O tamanho mximo ocial do display a a e 255. Aplica aos tipos de ponto utuante e indica o nmero de digitos aps o ponto u o decimal. O maior valor poss 30, mas no pode ser maior que M-2. ivel e a

Colchetes ([ and ]) indicam partes de tipos espec icos que so opicionais a Note que se voc especicar ZEROFILL para um campo MySQL automaticamente ir adie a cionar o atributo UNSIGNED ao campo. Aviso: voc deve estar ciente de que quando zer uma subtrao entre valores inteiros, e ca onde um deles do tipo UNSIGNED, o resultado ser sem sinal! Veja Seo 6.3.5 [Funes de e a ca co coero], Pgina 544. ca a TINYINT[(M)] [UNSIGNED] [ZEROFILL] Um inteiro muito pequeno. A faixa deste inteiro com sinal de -128 at 127. e e A faixa sem sinal de 0 at 255. e e BIT BOOL BOOLEAN

Estes so sinnimos para TINYINT(1). a o O sinnimo BOOLEAN foi adicionado na verso 4.1.0. o a Um tipo boolean verdadeiro ser introduzido de acordo com o SQL-99. a

SMALLINT[(M)] [UNSIGNED] [ZEROFILL] Um inteiro pequeno. A faixa do inteiro com sinal de -32768 at 32767. A e e faixa sem sinal de 0 a 65535. e MEDIUMINT[(M)] [UNSIGNED] [ZEROFILL] Um inteiro de tamanho mdio. A faica com sinal de -8388608 a 8388607. A e e faixa sem sinal de 0 to 16777215. e INT[(M)] [UNSIGNED] [ZEROFILL] Um inteiro de tamanho normal. A faixa com sinal de -2147483648 a e 2147483647. A faixa sem sinal de 0 a 4294967295. e INTEGER[(M)] [UNSIGNED] [ZEROFILL] Este um sinnimo para INT. e o

Cap tulo 6: Referncia de Linguagem do MySQL e

483

BIGINT[(M)] [UNSIGNED] [ZEROFILL] Um inteiro grande. A faixa com sinal de -9223372036854775808 a e 9223372036854775807. A faixa sem sinal de 0 a 18446744073709551615. e Existem algumas coisas sobre campos BIGINT sobre as quias voc deve estar e ciente: Todas as operaes aritimticas so feitas usando valores BIGINT ou co e a DOUBLE com sinal, no devemos utilizar inteiros sem sinal maiores que a c 9223372036854775807 (63 bits) exceto com funes ded bit! Se voc zer co e isto, alguns dos ultimos digitos no resultado podem estar errados por causa de erros de arredondamento na converso de BIGINT para DOUBLE. a O MySQL 4.0 pode tratar BIGINT nos seguintes casos: Usar inteiros para armazenar grandes valores sem sinais em uma coluna BIGINT. Em MIN(big_int_column) e MAX(big_int_column). Quando usar operadores (+, -, *, etc.) onde ambos os operandos so a inteiros. Voc pode armazenar valores inteiro exatos em um campo BIGINT e aramzenando-os como string, como ocorre nestes casos no haver a a nenhuma representao intermediaria dupla. ca -, +, e * sero utilizados em clculos aritimticos BIGINT quando ambos a a e os argumentos forem valores do tipo INTEGER! Isto signica que se voc e multilicar dois inteiros grandes (ou obter resultados de funes que retorco nam inteiros) voc pode obter resultados inesperados quando o resultado e for maior que 9223372036854775807. FLOAT(precis~o) [UNSIGNED] [ZEROFILL] a Um nmero de ponto utuante. No pode ser sem sinal. precis~o pode ser u a a <=24 para um nmero de ponto utuante de preciso simples e entre 25 e 53 u a para um nmero de ponto utuante de dupla-preciso. Estes tipos so como os u a a tipos FLOAT e DOUBLE descritos logo abaixo. FLOAT(X) tem o mesma faixa que os tipos correspondentes FLOAT e DOUBLE, mas o tamanho do display e nmero u de casas decimais indenido. e Na verso 3.23 do MySQL, este um verdadeiro valor de ponto utuante. Em a e verses anteriores , FLOAT(precis~o) sempre tem 2 casas decimais. o a Note que o uso de FLOAT pode trazer alguns problemas inesperados como nos clculos j que em MySQL todos so feitos com dupla-preciso. Veja a a a a Seo A.5.6 [Registros sem correspondentes], Pgina 934. ca a Esta sintaxe fornecida para comptibilidade com ODBC. e FLOAT[(M,D)] [UNSIGNED] [ZEROFILL] Um nmero de ponto utuante pequeno (preciso simples). Os valores u a permitidos esto entre -3.402823466E+38 e -1.175494351E-38, 0 e entre a 1.175494351E-38 e 3.402823466E+38. Se UNSIGNED for especicado, valores negativos no so permitidos O M a largura do display e o D o nmero de a a e e u

484

MySQL Technical Reference for Version 5.0.0-alpha

casas decimais. FLOAT sem um argumento ou FLOAT(X) onde X <=24 tende a um nmero de ponto utuante de preciso simples. u a DOUBLE[(M,D)] [UNSIGNED] [ZEROFILL] Um nmero de ponto utuante de tamanho normal (dupla-preciso). u a Valores permitidos esto a entre -1.7976931348623157E+308 e -2.2250738585072014E-308, 0 e entre 2.2250738585072014E-308 e 1.7976931348623157E+308. Se UNSIGNED for especicado, valores negativos no so permitidos. O M a largura do display e o D nmero de casa a a e e u decimais. DOUBLE sem argumento ou FLOAT(X) onde 25 <= X <= 53 so a nmeros de ponto utuante de dupla-preciso. u a DOUBLE PRECISION[(M,D)] [UNSIGNED] [ZEROFILL] REAL[(M,D)] [UNSIGNED] [ZEROFILL] Estes so sinnimos para DOUBLE. a o DECIMAL[(M[,D])] [UNSIGNED] [ZEROFILL] Um nmero de ponto utuante no empacotado. Se comporta como um campo u a CHAR: no empacotado signica que o nmero armazenado como uma string, a u e usando um caracter para cada digito do valor. O ponto decimal e, para nmeros u negativos, o sinal de menos (-), no so contados em M (mas reservado espao a a e c para isto). Se D for 0, os valores no tero ponto decimal ou parte fracionria. a a a A faixa mxima do valor DECIMAL a mesma do DOUBLE, mas a faixa atual para a e um campo DECIMAL dado pode ser limitado pela escolha de M e D. Se UNSIGNED especicado, valores negativos no so permitidos. e a a Se D no for denido ser considerado como 0. Se M no for denido consida a a e erado como 10. Note que antes da verso 3.23 do MySQL o argumento M deve incluir o espao a c necessrio para o sinal o ponto decimal. a e DEC[(M[,D])] [UNSIGNED] [ZEROFILL] NUMERIC[(M[,D])] [UNSIGNED] [ZEROFILL] FIXED[(M[,D])] [UNSIGNED] [ZEROFILL] Este um sinnimo para DECIMAL. e o O alias FIXED foi adicionado na verso 4.1.0 para compatibilidade com outros a servidores. DATE Uma data. A faixa suportada entre 1000-01-01 e 9999-12-31. e MySQL mostra valores DATE no formato AAAA-MM-DD, mas permite a voc a e atribuir valores a campos DATE utilizando tanto strings quanto nmeros. Veja u Seo 6.2.2.2 [DATETIME], Pgina 491. ca a DATETIME Um combinao de hora e data. A faixa suportada entre 1000-01-01 ca e 00:00:00 e 9999-12-31 23:59:59. MySQL mostra valores DATETIME no formato AAAA-MM-DD HH:MM:SS, mas permite a voc que atribuir valores a e campos DATETIME utilizado strings ou nmeros. Veja Seo 6.2.2.2 [DATEu ca TIME], Pgina 491. a

Cap tulo 6: Referncia de Linguagem do MySQL e

485

TIMESTAMP[(M)] Um timestamp. A faixa entre 1970-01-01 00:00:00 e algum momento no e ano 2037. No MySQL 4.0 ou anteriores, os valores TIMESTAMP so exibidos nos formatos a YYYYMMDDHHMMSS, YYMMDDHHMMSS, YYYYMMDD, ou YYMMDD, dependendo se M 14 e (ou no denido), 12, 8 ou 6, mas permite a voc atribuir valores ao campo a e TIMESTAMP usando strings ou nmeros. u Um campo TIMESTAMP util para gravar a data e a hora em uma operao e ca de INSERT or UPDATE porque automaticamente denido a data e a hora da e operao mais recente se voc prprio no especicar um valor. Voc tambm ca e o a e e pode denir a data e a hora atual atribuindo ao campo um valor NULL. Veja Seo 6.2.2 [Tipos de hora e data], Pgina 489. ca a Desde o MySQL 4.1, TIMESTAMP retornado com um string com o formato e YYYY-MM-DD HH:MM:SS. Se voc deseja t-lo como um nmero voc deve e e u e adcionar +0 a coluna timestamp. Teimestamp de tamanhos diferentes no so a a supoortados. Desde a verso 4.0.12, a opo --new pode ser usada para fazer a ca o servidor se comportar como na vers`o 4.1. a Um TIMESTAMP sempre armazenado em 4 bytes. O argumento M s afeta como e o a coluna TIMESTAMP exibida. e Note que colunas do tipo TIMESTAMP(M) columns onde M 8 ou 14 so apree a sentadas como nmeros enquanto as outras colunas TIMESTAMP(M) so strings. u a Isto apenas para assegurar que podemos eliminar e restaurar com segurana e c tabelas com estes tipos! Veja Seo 6.2.2.2 [DATETIME], Pgina 491. ca a TIME Uma hora. A faixa entre -838:59:59 e 838:59:59. MySQL mostra e valores TIME no formato HH:MM:SS, mas permite a voc atribuir valores e para as colunas TIME usando strings ou nmeros. Veja Seo 6.2.2.3 [TIME], u ca Pgina 495. a YEAR[(2|4)] Um ano no formato de 2 ou 4 digitos (padro so 4 digitos). Os valores pera a mitidos esto entre 1901 e 2155, 0000 no formato de 4 digitos, e 1970-2069 a se voc estiver usando o formato de 2 digitos (70-69). MySQL mostra valores e YEAR no formato YYYY, mas permie atribuir valores aos campos do tipo YEAR usando strings ou nmeros. (O tipo YEAR novo na verso 3.22 do MySL). Veja u e a Seo 6.2.2.4 [YEAR], Pgina 496. ca a [NATIONAL] CHAR(M) [BINARY | ASCII | UNICODE] Uma string de tamanho xo que sempre preenchida a direita com espaos at o e c e tamanho especicado quando armazenado. A faixa de M de 1 a 255 caracteres. e Espaos extras so removidos quando o valor recuperado. Valores CHAR so c a e a ordenados e comparados no modo caso insensitivo de acordo com o conjunto de caracteres padro, a menos que a palavra chave BINARY seja utilizada. a A partir da verso 4.1.0, se o valor M especicado maio que 255, o tipo de a e coluna convertido para TEXT. Este um recurso de compatibilidade. e e

486

MySQL Technical Reference for Version 5.0.0-alpha

NATIONAL CHAR (ou em sua forma reduzida NCHAR) o modo SQL-99 de denir e que um campo CHAR deve usar o conjunto CHARACTER padro. Este o a e padro no MySQL. a CHAR uma simplicao para CHARACTER. e ca A partir da verso 4.1.0, o atributo ASCII pode ser especicado o que atribui o a conjunto de caracteres latin1 a coluna CHAR. A partir da verso 4.1.1, o atributo UNICODE pode ser especicado o que atribui a o conjunto de caracteres ucs2 a coluna CHAR. O MySQL lhe permite criar um campo do tipo CHAR(0).Isto muito util quando e voc precisa de comptibilidade com aplicativos antigos que dependem da exe istncia de uma coluna, mas que, na verdade, no utiliza um valor. Isto tambm e a e muito bom quando voc precisa de uma coluna que s pode receber 2 valores. e e o Um CHAR(0), que no denido como um NOT NULL, s ir ocupar um bit e a e o a pode assumir 2 valores: NULL or "". Veja Seo 6.2.3.1 [CHAR], Pgina 497. ca a BIT BOOL CHAR This is a synonym for CHAR(1).

[NATIONAL] VARCHAR(M) [BINARY] Uma string de tamanho varivel. NOTA: Espaos extras so removidos quando a c a o caracter armazenado (o que difere da especicao ANSI SQL). A faixa de e ca M de 1 a 255 characters. Valores VARCHAR so ordenados e comparados no e a modo caso insensitivo a menos que a palavra chave BINARY seja utilizada. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. ca a A partir da verso 4.1.0, se o valor M especicado maio que 255, o tipo de a e coluna convertido para TEXT. Este um recurso de compatibilidade. e e VARCHAR uma simplicao para CHARACTER VARYING. Veja Seo 6.2.3.1 e ca ca [CHAR], Pgina 497. a TINYBLOB TINYTEXT Um campo BLOB ou TEXT com tamanho mximo de 255 (2^8 - 1) caracteres. a Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. Veja Seo 6.2.3.2 ca a ca [BLOB], Pgina 498. a BLOB TEXT Um campo BLOB ou TEXT com tamanho mximo de 65535 (2^16 - 1) caracteres. a Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. Veja Seo 6.2.3.2 ca a ca [BLOB], Pgina 498. a MEDIUMBLOB MEDIUMTEXT Um campo BLOB ou TEXT com tamanho mximo de 16777215 (2^24 - 1) caraca teres. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. Veja Seo 6.2.3.2 ca a ca [BLOB], Pgina 498. a

Cap tulo 6: Referncia de Linguagem do MySQL e

487

LONGBLOB LONGTEXT Um campo BLOB ou TEXT com tamanho mximo de 4294967295 ou 4G (2^32 a - 1) caracteres. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. Veja ca a Seo 6.2.3.2 [BLOB], Pgina 498. At a verso 3.23 o protocolo cliente/servidor ca a e a e tabelas MyISAM tinham um limite de 16M por pacote de transmisso/registro a de tabela, a partir da verso 4.x o tamanho mximo permitido das colunas a a LONGTEXT ou LONGBLOB depende do tamanho mximo congurado para o paa cote no protocolo cliente/servidor e da memria dispon o ivel. Veja Seo 6.2.3.2 ca [BLOB], Pgina 498. a ENUM(valor1,valor2,...) Uma enumerao. Um objeto string que s pode ter um valor, selecionado da ca o lista de valores valor1, valor2, ..., NULL ou valor especial de erro "". Um ENUM pode ter um mximo de 65535 valores diferentes. Veja Seo 6.2.3.3 a ca [ENUM], Pgina 499. a SET(valor1,valor2,...) Um conjunto. Um objeto string que pode ter zero ou mais valores, cada um deve ser selecionado da lista de valores valor1, valor2, .... Um SET pode ter at 64 membros. Veja Seo 6.2.3.4 [SET], Pgina 500. e ca a

6.2.1 Tipos Numricos e

MySQL suporta todos os tipos numricos da ANSI/ISO SQL92. Estes tipos incluem o tipos e de dados numricos exatos (NUMERIC, DECIMAL, INTEGER, e SMALLINT), assim como o tipos e de dados numricos aproximados (FLOAT, REAL, e DOUBLE PRECISION). A palavra-chave INT e um sinnimo para INTEGER, e a palavra-chave DEC um sinnimo para DECIMAL. e o e o Os tipos NUMERIC e DECIMAL so implementados como o mesmo tipo pelo MySQL, como a permitido pelo padro SQL92. Eles so usados por valores para os quais importante a a e preservar a exatido como, por exemplo, dados monetrios. Quando declarado um campo a a e de algum desses tipos a preciso e a escala podem ser (e normalmente ) especicadas; por a e exemplo: salario DECIMAL(5,2) Neste exemplo, 5 (precis~o) representa o nmero de digitos decimais signicantes que sero a u a armazenados no valor, e 2 (escala) representa o nmero de d u igitos que sero armazenados a aps o ponto decimal. Neste caso, no entanto, a faixa de valores que podem ser armazendos o na coluna salario de -99.99 a 99.99. (MySQL pode, na verdade, armazenar numeros e acima de 999.99 neste campo porque ele no precisa armazenar o sinal para nmeros a u positivos). Em ANSI/ISO SQL92, a sintaxe DECIMAL(p) equivalente a DECIMAL(p,0). Da mesma e forma, a sintaxe DECIMAL equivalente a DECIMAL(p,0), onde a implementao permite e ca decidir o valor de p. MySQL ainda no suporta nenhuma dessas duas formas variantes a dos tipos de dados DECIMAL/NUMERIC. Este, geralmente, no um problema srio, j que a e e a os principais benef icios destes tipos derivam da habilidade de controlar preciso e escala a explicitamente.

488

MySQL Technical Reference for Version 5.0.0-alpha

Valores DECIMAL e NUMERIC so armazenados como strings, ao invs de um nmero de pontoa e u utuante binrio, para preservar o preciso decimal destes valores. Um caracter usado a a e para cada digito, para o ponto decimal (se escala > 0), e para o sinal - (para nmeros u negativos). Se escala 0, valores DECIMAL e NUMERIC no contm ponto decimal ou parte e a e fracionria. a A faixa mxima dos valores DECIMAL e NUMERIC o mesmo do DOUBLE, mas a faixa real para a e um campo DECIMAL or NUMERIC pode ser limitado pela precis~o ou pela escala para uma a dada coluna. Quando atribu a uma coluna um valor com mais digitos aps o ponto e ido o decimal do que o permitido especicado na escala, o valor arredondado para aquela e escala. Quando atribuido um valor a uma coluna DECIMAL ou NUMERIC o qual excede a e faixa determinada pelas precis~o e escala especicada (ou padro), MySQL armazena o a a valor correspondente ao nal daquela faixa. Como uma extenso do padro ANSI/ISO SQL92, MySQL tambm suporta os tipos ina a e tegrais TINYINT, MEDIUMINT, e BIGINT como listado nas tabelas abaixo. Outra extenso a suportada pelo MySQL especicar, opcionalmente, o tamanho do display de um valor e inteiro entre parenteses seguindo o nome do tipo (por exemplo, INT(4)). Esta especicao ca opcional do tamanho usada para preenchimento a esquerda do display de valores cujo e tamanho menor que o especicado para a coluna, mas no limita a faixa de valores que e a podem ser armazendos na coluna, nem o nmero de d u igitos que sero mostrados para vala ores que excederem o tamanho especicado na coluna. Quando usados em conjunto com o atributo opcional de extenso ZEROFILL, o padro do preenchimento de espaos a substia a c e tuio por zeros. Por exemplo, para uma coluna declarada com INT(5) ZEROFILL, o valor ca 4 retornado como 00004. Note que se voc armazenar valores maiores que a largura do e e display em um coluna do tipo inteiro, voc pode ter problemas quando o MySQL gerar e tabelas temporrias para algum join complicado, j que nestes casos o MySQL acredita que a a os dados cabem na largura original da coluna. Todos os tipos inteiros podem ter um atributo opcional (no-padro) UNSIGNED. Valores a a sem sinal podem ser usados quando voc permite apenas nmeros positivos em uma coluna e u e voc precisa de uma faixa de valores um pouco maior para a coluna. e Desde o MySQL 4.0.2, tipos de ponto utuante tambm podem ser sem sinal (UNSIGNED). e Como no tipos inteiros, este atributoprevine que valores negativos sejam armazenados na coluna. Ao contrrio dos tipos negativos, o valor mximo da faixa permitida permanece o a a mesmo. O tipo FLOAT usado para representar tipos de dados numricos aproximados. O padro e e a SQL-92 permite uma especicao opcional da preciso (mas no da faixa do expoente) em ca a a bits, aps a a palavra FLOAT e entre parenteses. A implementao MySQL tambm suporta o ca e esta especicao opcional de preciso. Quando FLOAT usada para uma tipo de coluna ca a e sem especicao de preciso, MySQL utiliza quatro bytes para armazenar os valores. Uma ca a sintaxe variante tambm suportada, com dois numeros entre parenteses aps a palavra e e o FLOAT. Com esta opo, o primeiro nmero continua a representar a quantidade de bytes ca u necessria para armazenar o valor, e o segundo nmero especica o nmero de d a u u igitos a serem armazenados e mostrados aps o ponto decimal (como com DECIMAL e NUMERIC). o Quando pedido ao MySQL para armazenar um nmero em uma coluna com mais digitos e u decimais aps o ponto decimal que o especicado para esta coluna, o valor arredondado o e eliminando os digitos extras quando armazenado.

Cap tulo 6: Referncia de Linguagem do MySQL e

489

Os tipos REAL e DOUBLE PRECISION no aceitam especicaes de preciso. Como uma a co a extenso do padro SQL-92, o MySQL reconhece DOUBLE como um sinnimo para o tipo a a o DOUBLE PRECISION. Em constraste com a exigencia do padro de que a preciso do tipo a a REAL seja menor que aquele usado pelo DOUBLE PRECISION, MySQL implementa ambos como valores de ponto utuante de 8 bits de dupla preciso (quando no estiver executando a a em modo ANSI). Para uma portabilidade mxima, cdigos que requerem armazenamento a o de valores de dados numricos aproximados usam FLOAT ou DOUBLE PRECISION sem especie cao de preciso ou de numeros decimais. ca a Quando solicitado a armazenar um valor em uma coluna numrica que est fora da faixa e a permitida pelo tipo da coluna, o MySQL ajusta o valor ao limite da faixa permitida mais apropriado e armazena este valor. Por exemplo, a faixa de uma coluna INT de -2147483648 a 2147483647. Se voc tentar e e inserir -9999999999 em uma coluna INT, o valor ajustado para o limite mais baixo da e faixa de valores e -2147483648 armazenado. Da mesma forma, se voc tentar inserir e e 9999999999, 2147483647 ser armazenado. a Se o campo INT UNSIGNED, o tamanho da faixa do campo o mesmo mas o limite passa e e a ser de 0 a 4294967295. Se voc tentar armazenar -9999999999 e 9999999999, os valores e armazenados na coluna sero 0 e 4294967296. a Converses que ocorrem devido a ajustes so relatados como avisos para ALTER TABLE, o a LOAD DATA INFILE, UPDATE, e instrues INSERT multi-registros. co Tipo Bytes De At e TINYINT 1 -128 127 SMALLINT 2 -32768 32767 MEDIUMINT 3 -8388608 8388607 INT 4 -2147483648 2147483647 BIGINT 8 -9223372036854775808 9223372036854775807

6.2.2 Tipos de Data e Hora

Os tipos de data e hora so DATETIME, DATE, TIMESTAMP, TIME, e YEAR. Cada um desses a tipos tem uma faixa de valores legais, assim com um valor zero que usado quando e voc especica um valor ilegal. Note que o MySQL permite que voc armazene certos e e valores de datas inexistentes, como 1999-11-31. A razo para isto que pensamos que a e e responsabilidade do aplicativo tratar das vericaes de data, no do servidor SQL. Para co a fazer uma vericao rpida de data, MySQL s checa se o ms est na faixa de 0-12 ca a o e a e o dia est na faixa de 0-31. As faixas acima so denidas desta forma porque MySQL a a lhe permite armazenar, em um campo DATE ou DATETIME, datas onde o dia ou o dia/ms e so zero. Isto extremamente util para aplicativos que precisam armazenar uma data de a e nascimento na qual voc no sabe a data exata. Nestes casos voc simplesmente armazena e a e a data como 1999-00-00 ou 1999-01-00. (Voc no pode esperar obter um valor correto e a para funes como DATE_SUB() ou DATE_ADD para datas como estas.) co Aqui esto algumas consideraes para ter em mente quando estiver trabalhando com tipos a co de data e hora. MySQL recupera valores para um tipo de data ou hora dado em um formato padro, a mas ele tenta interpretar uma variedade de formatos para os valores fornecidos (por

490

MySQL Technical Reference for Version 5.0.0-alpha

exemplo, quando voc especica um valor a ser atribuido ou comparado a um tipo de e data ou hora). No entanto, s os formatos descritos na seo seguinte so suportados. E o ca a esperado que voc fornea valores permitidos. Resultados imprevisiveis podem ocorrer e c se voc usar outros formatos. e Embora o MySQL tente interpretar valores em diversos formatos, ele sempre espera que a parte da data referente ao ano esteja mais a esquerda do valor. Datas devem ser dadas na ordem ano-ms-dia (por exemplo, 98-09-04), ao invs das ordens mais e e usadas ms-dia-ano ou dia-ms-ano (por exemplo: 09-04-98, 04-09-98). e e MySQL converte automaticamente um tipo de data ou hora em um nmero se o valor u usado em um contexto numrico, e vice-versa. e e Quando o MySQL encontra um valor para um tipo de data ou hora que est fora da a desta seo), ele converte o valor faixa permitida ou ilegal neste tipo (veja o inicio e ca para zero. (A exceo ocorre no campo TIME, onde o valor fora da faixa ajustado ca e para o valor limite apropriado na faixa de valores deste tipo.) A tabela abaixo mostra o formato do valor zero para cada tipo: Tipo de Valor Zero Coluna DATETIME 0000-00-00 00:00:00 DATE 0000-00-00 TIMESTAMP 00000000000000 (tamanho depende do tamanho do display) TIME 00:00:00 YEAR 0000 Os valores zero so especiais, mas voc pode armazenar ou fazer referncia a eles a e e explicitamente usando os valores mostrados na tabela. Voc tambm pode fazer into e e usando 0 ou 0, o que mais fcil de escrever. e a Valores zero para data ou hora usados em MyODBC so convertidos automaticaa mente para NULL na verso 2.50.12 MyODBC e acima, porque ODBC no pode tratar a a tais valores.

6.2.2.1 Assuntos referentes ao ano 2000 (Y2K) e Tipos de Data

O MySQL tem sua prpria segurana para o ano 2000 (veja Seo 1.2.5 [compatibilidade o c ca com o ano 2000], Pgina 11), mas os dados entrados no MySQL podem no ter. Qualquer a a entrada contendo valores de ano de 2 digitos amb e iguo, porque o sculo desconhecido. e e Tais valores devem ser interpretados na forma de 4 digitos j que o MySQL armazena anos a internamente utilizando 4 digitos. Para tipos DATETIME, DATE, TIMESTAMP e YEAR, MySQL interpreta datas com valores amb iguos para o ano usando as seguintes regras: Valores de ano na faixa 00-69 so convertidos para 2000-2069. a Valores de anos na faixa 70-99 so convertidos para 1970-1999. a Lembre-se de que essas regras fornecem apenas palpites razoveis sobre o que a sua data a signica. Se a heuristica usada pelo MySQL no produz o valor voc deve fornecer entre a e sem ambiguidade contendo valores de ano de 4 digitos. ORDER BY ir ordenar tipos YEAR/DATE/DATETIME de 2 digitos apropriadamente. a

Cap tulo 6: Referncia de Linguagem do MySQL e

491

Note tembm que algumas funes com MIN() e MAX() iro converter TIMESTAMP/DATE e co a para um nmero. Isto signica que um timestamp com ano de 2 digitos no ir funcionar u a a corretamente com estas funes. A soluo neste caso converter o TIMESTAMP/DATE para co ca e um formato de ano de 4 digitos ou usar algo como MIN(DATE_ADD(timestamp,INTERVAL 0 DAYS)).

6.2.2.2 Os Tipos DATETIME, DATE e TIMESTAMP

Os tipos DATETIME, DATE, e TIMESTAMP so relacionados. Esta seo descreve suas caraca ca ter isticas, como eles se assemelham ou como se diferem. O tipo DATETIME usado quando voc precisa de valores que contm informaes sobre e e e co data e a a hora. MySQL recupera e mostra valores DATETIME no formato YYYY-MM-DD HH:MM:SS. A faixa suportada de 1000-01-01 00:00:00 at 9999-12-31 23:59:59. e e (Suportada signica que embora valores anteriores possam funcionar, no h nenhura a a garantia de disto.) O tipo DATA usado quando se necessita apenas do valor da data, sem a parte da hora. e MySQL recupera e mostra valores do tipo DATA no formato YYYY-MM-DD. A faixa suportada de 1000-01-01 at 9999-12-31. e e A coluna do tipo TIMESTAMP possui comportamento e propriedade variado, dependendo da verso do MySQL e do modo SQL que o servidor est executando. a a

Comportamento do TIMESTAMP ao executar no modo MAXDB

Quando o MySQL est executando no modo SQPDB, o TIMESTAMP comporta como DATETIME. a Nenhuma atualizao automtica da coluna TIMESTAMP ocorre, como descrito no pargrafo ca a a seguinte. O MySQL pode ser executado no modo MAXDB a partir da verso 4.1.1. Veja a Seo 4.1.1 [Command-line options], Pgina 207. ca a

Comportamento do TIMESTAMP quando no est executando no a a modo MAXDB

O tipo de campo TIMESTAMP fornece um tipo que pode ser usado para, automaticamente, marcar operaes INSERT or UPDATE com a data e hora atual. Se voc tiver multiplas colunas co e TIMESTAMP, s a primeira atualizada automaticamente. o e Atualizaes automaticas da primeira coluna TIMESTAMP ocorrem sob qualquer uma das co seguintes condies: co A coluna no explicitamente especicada em uma instruo INSERT ou LOAD DATA a e ca INFILE. A coluna no explicitamente especicada em uma instruo UPDATE e e alguma outra a e ca coluna muda o valor. (Note que um UPDATE que coloca em uma coluna o mesmo valor que ele j possui no ir causar a atualizao da coluna TIMESTAMP, porque se a a a ca voc atribui a uma coluna o seu valor atual, MySQL ignora a atualizao para maior e ca ecincia). e Voc dene explicitamente a uma coluna TIMESTAMP o valor NULL. e

492

MySQL Technical Reference for Version 5.0.0-alpha

Outras colunas TIMESTAMP, alm da primeira podem ser denidas com a data e hora atuais. e Basta deni-las com NULL ou NOW() Voc pode denir colunas TIMESTAMP com um valor diferente da data e hora atuais colocando e explicitamente o valor desejado. Isto verdade mesmo para a primeira coluna TIMESTAMP. e Voc pode usar esta propriedade se, por exemplo, voc quiser que um TIMESTAMP tenha seu e e valor denido como a data e hora atuais na criao de registros, mas no quer alter-los ca a a quando o registro for atualizado mais tarde: Deixe o MySQL denir a coluna quando o registro criado. Isto ir inicializa-la com e a a data e hora atuais. Quando voc realizar subsequentes atualizaoes em outras colunas do registro, dena e c explicitamente a coluna TIMESTAMP com o valor atual. Por outro lado, voc pode achar que mais fcil usar uma coluan DATETIME que voc iniciale e a e iza com NOW() quando o registro for criado e deixa como est em atualizaes subsequentes. a co

Propriedades TIMESTAMP quando executando no modo MAXDB

Quando o MySQL est executando no modo MAXDB, TIMESTAMP idntico ao DATETIME. a e e Ele usa o mesmo formato para armazenar e mostrar valores, e ele tem a mesma faixa. O MySQL pode ser executado no modo MAXDB a partir da verso 4.1.1. Veja Seo 4.1.1 a ca [Command-line options], Pgina 207. a

Propriedades TIMESTAMP a partir do MySQL 4.1 quando no a executado no modo MAXDB

No MySQL 4.1.0, colunas TIMESTAMP so armazenadas e mostradas no mesmo formato que a colunas DATETIME. Isto tambm signica que ele no podem ser estreitados ou alargae a dos nos modos descritos no pargrafo seguinte. Em outras palavras, voc no pode usar a e a TIMESTAMP(2), TIMESTAMP(4), etc. Em outros casos, as propriedades so as mesmas de a verses MySQL anteriores. o

Propriedades TIMESTAMP antes do MySQL 4.1

Valores TIMESTAMP podem ter valores do incio de 1970 at algum momento do ano 2037, e com a resoluo de um segundo. Valores so mostrados como nmeros ca a u O formato no qual o MySQL recupera e mostra valores TIMESTAMP depende do tamanho do display, como ilustrado pela tabela que se segue: O formato cheio TIMESTAMP de 14 e digitos, mas colunas TIMESTAMP podem ser criadas com tamanho de display menores: Tipo da Coluna Formato do Display TIMESTAMP(14) YYYYMMDDHHMMSS TIMESTAMP(12) YYMMDDHHMMSS TIMESTAMP(10) YYMMDDHHMM TIMESTAMP(8) YYYYMMDD TIMESTAMP(6) YYMMDD TIMESTAMP(4) YYMM TIMESTAMP(2) YY

Cap tulo 6: Referncia de Linguagem do MySQL e

493

Todas as colunas TIMESTAMP tem o mesmo tamanho de armazenamento, independente do tamanho de display. Os tamanhos de display mais comuns so 6, 8, 12, e 14. Voc pode a e especicar um tamanho de display arbitrario na hora da criao da tabela, mas valores de ca 0 ou maiores que 14 so mudados para 14. Valores a impares de tamanho na faixa de 1 a 13 so mudados para o maior nmero par mais prximo. a u o Nota: Na verso 4.1, TIMESTAMP retornado com uma string com o formato YYYY-MM-DD a e HH:MM:SS, e timestamp de diferentes tamamnhos no so mais suportados. a a Voc pode especicar calores DATETIME, DATE e TIMESTAMP usando qualquer conjunto de e formatos comum: Como uma string nos formatos YYYY-MM-DD HH:MM:SS ou YY-MM-DD HH:MM:SS. Uma sintaxe relaxada permitidanenhum caracter de pontuao pode ser usado e ca como um delimitador entre parte de data ou hora. Por exemplo, 98-12-31 11:30:45, 98.12.31 11+30+45, 98/12/31 11*30*45, e 98@12@31 11^30^45 so equivaa lentes. Como uma string nos formatos YYYY-MM-DD ou YY-MM-DD. Uma sintaxe relaxada permitida aqui tambm. Por exemplo, 98-12-31, 98.12.31, 98/12/31, e e e 98@12@31 so equivalentes. a Como uma string sem delimitadores nos formatos YYYYMMDDHHMMSS ou YYMMDDHHMMSS, desde que a string faa sentido como data. c Por example, 19970523091528 e 970523091528 so interpretadas com 1997-05-23 a 09:15:28, mas 971122129015 ilegal (tem uma parte de minutos sem sentido) e e se torna 0000-00-00 00:00:00. Como uma string sem delimitadores nos formatos YYYYMMDD ou YYMMDD, desde que a string tenha sentido com data. Por exemplo, 19970523 e 970523 so ina terpretedas como 1997-05-23, mas 971332 ilegal (tem uma parte de ms sem e e sentido) e se torna 0000-00-00. Como um nmero nos formatos YYYYMMDDHHMMSS ou YYMMDDHHMMSS, desde que o u nmero faa sentido como uma data. Por exemplo, 19830905132800 e 830905132800 u c so interpretedos como 1983-09-05 13:28:00. a Como um nmero nos formatos YYYYMMDD ou YYMMDD, desde que o nmero faa sentido u u c como data. Por exemplo, 19830905 e 830905 so interpretedos como 1983-09-05. a Como o resultado de uma funo que retorne uma valor aceitavel em um contexto ca DATETIME, DATE ou TIMESTAMP, tal como NOW() ou CURRENT_DATE. Valores DATETIME, DATE, ou TIMESTAMP ilegais so convertidos para o valor zero do tipo a apropriado (0000-00-00 00:00:00, 0000-00-00, ou 00000000000000). Para valores especicados com strings que incluem delimitadores de data, no necessrio a e a especicar dois digitos para valores de ms ou dia qua so menores que 10. 1979-6-9 e a o mesmo que 1979-06-09. Similarmente, para valores especicados como strings que e incluem delimitadores de hora, no necessrio especicar dois digitos para valores de a e a hora, minutos ou segundo que so menores que 10. 1979-10-30 1:2:3 R o mesmo que a e 1979-10-30 01:02:03. Valores especicados como nmeros devem ter 6, 8, 12, ou 14 digitos. Se o nmero de u u e 8 ou 14 digitos, ele assume estar no formato YYYYMMDD ou YYYYMMDDHHMMSS e que o ano dado pelos 4 primeiros d e igitos. Se o de 6 ou 12 d e igitos, ele assume estar no formato

494

MySQL Technical Reference for Version 5.0.0-alpha

YYMMDD or YYMMDDHHMMSS e que o ano dado pelos 2 primeiros digitos. Nmeros que no e u a possua estes tamanho so interpretados como calores preenchidos com zero at o tamanho a e mais prximo. o Valores especicados como strings no delimitadas so interpretados usando o seu tamanho a a como dado. Se a string possui 8 ou 14 caracteres, o ano assumido como os 4 primeiros e caracteres. De outra forma o assume-se que o ano so os 2 primeiros caracteres. A string a interpretadada esquerda para direita para encontrar os valores do ano, ms, dia, hora, e e minute e segundo, para as partes da string. Isto signica que voc no deve utilizar strings e a com menos de 6 caracteres. Por exemplo, se voc especicar 9903, pensando em repree sentar Maro de 1999, voc perceber que o MySQL insere uma data zero em sua tabela. c e a Isto ocorre porque os valores do ano e ms so 99 e 03, mas a parte contendo o dia no e a a existe (zero), ento o valor no uma data legal. No entanto, a partir do MySQL 3.23, voc a a e e pode especicar explicitamente um valor de zero para representar dia ou ms faltantes. Por e exemplo, voc pode usar 990300 para inserir o valor 1999-03-00. e Colunas TIMESTAMP armazena valores legais utilizando preciso total com a qual os valores a foram especicados, independente do tamanho do display. Isto tem diversas implicaes: co Sempre especique o ano, ms e dia, mesmo se seus tipos de coluna so TIMESTAMP(4) e a ou TIMESTAMP(2). De outra forma, os valores no sero datas legais date e um 0 ser a a a armazenado. Se voc usa ALTER TABLE para aumentar uma coluna TIMESTAMP, informaes sero e co a mostradas como se antes estivessem escondidas. De forma similar, reduzindo o tamanho de uma coluna TIMESTAMP no causa perda de a informao, exceto no sentido de que menos informao aparece quando os valores so ca ca a mostrados. Embora os valores TIMESTAMP sejam armazenados com preciso total, a unica funo a ca que opera diretamente com o valor armazenado UNIX_TIMESTAMP(). OUtras funes e co operam com o formato do valor recuperado Isto signica que no se pode usar funes a co como HOUR() or SECOND() a menos que a parte relevante do valor TIMESTAMP esteja inclu no valor formatado. POr exemplo, a parte HH de uma coluna TIMESTAMP no ido a mostrada a menos que o tamanho do display seja de pelo menos 10, logo tentar usar e HOUR() em um valor TIMESTAMP menor produz um resultado sem signicado. Voc pode, algumas vezes, atribuir valores de um tipo de data para um objeto de um e diferente tipo de data. No entanto pode haver algumas alteraes de valores ou perda de co informao ca Se voc atribuir um valor de DATE value a um objeto DATETIME ou TIMESTAMP, a parte e da hora do valor resultante denido como 00:00:00, porque o vlaor DATE no e a contm informaes de hora. e co Se voc atribuir um valor DATETIME ou TIMESTAMP para um objeto DATE, a parte da e hora do valor resultante deletado, pois o tipo DATE no armazena informaes de e a co hora. Lembre-se de que embora todos os valores DATETIME, DATE, e TIMESTAMP possam ser especicados usando o mesmo conjunto de formatos, os tipos no tem a mesa faixa de a valores. Por exemplo, valores TIMESTAMP no podem ser anteriores a 1970 ou posteriores a a 2037. Isto signicia que datas como 1968-01-01, so permitidas como valores a

Cap tulo 6: Referncia de Linguagem do MySQL e

495

DATETIME ou DATE, mas no so vlidas para valores TIMESTAMP e sero covertidas para a a a a 0 se atribuidas para tais objetos. Esteja ciente de certas diculdades quando especicar valores de data: A forma relaxada permitida em valores especicados com strings podem causar certas confuses. Por exemplo, um valor como 10:11:12 pode parecer com um valor de o hora devido ao limitador :, mas se usado em um contexto de data ser interpretado a como o ano 2010-11-12. O valor 10:45:15 ser convertido para 0000-00-00 a pois 45 no um valor de ms permitido. a e e O servidor MySQL funciona basicamente checando a validade da data: dias entre 0031, ms entre 00-12, anos entre 1000-9999. Qualquer data que no esteja nesta faixa e a ser revetida para 0000-00-00. Por favor, note que isto ainda lhe permite armazenar a datas invalidas tais como 2002-04-31. Isto permite a aplicaes web armazenar dados co de um formulrio sem vericaes adicionais. Para assegurar que a data valida, faa a co e c a checagem em sua aplicao. ca Valores de anos especicados com 2 digitos so amb a iguos, pois o sculo no conhecido. e a e MySQL interpreta valores de anos com dois digitos usando as seguintes regras: Valores de ano na faixa de 00-69 so convertidos para 2000-2069. a Valores de ano na faixa de 70-99 so convertidos para 1970-1999. a

6.2.2.3 O Tipo TIME

O MySQL recupera e mostra valores TIME no formato HH:MM:SS (ou no formato HHH:MM:SS para valores grandes). Volares TIME podem estar na faixa de -838:59:59 at 838:59:59. A razo para a parte da hora ser to grande que o tipo TIME pode ser e a a e usado no apenas para representar a hora do dia (que deve ser menor que 24 horas), mas a tambm para tempo restante ou intervalos de tempo entre dois eventos(que podem ser e maior que 24 horas ou mesmo negativo). Voc pode especicar valores TIME de variadas formas: e Como uma string no formato D HH:MM:SS.fra~o . (Note que o MySQL no arca a mazena ainda fraes para a coluna time.) Pode-se tambm utilizar uma das seguintes co e sintaxes relaxadas: HH:MM:SS.fra~o, HH:MM:SS, HH:MM, D HH:MM:SS, D HH:MM, D HH ou SS. Aqui D um ca e dia entre 0-33. Como uma string sem delimitadores no formato HHMMSS, desde que ela tenha sentido como uma hora. Por exemplo, 101112 esntendido como 10:11:12, mas 109712 e ilegal (a parte dos minutos no tem nenhum sentido) e se torna 00:00:00. e a Como um nmero no formato HHMMSS , desde que tenha sentido como uma hora. Por u exemplo, 101112 entendido com 10:11:12. Os formatos alternativos seguintes e tambm so entendidos: SS, MMSS, HHMMSS e HHMMSS.fra~o. Note que o MySQL e a ca ainda no armazena fraes. a co Como o resultado de uma funo que retorne um valor que aceitvel em um contexto ca e a do tipo TIME, tal como CURRENT_TIME.

496

MySQL Technical Reference for Version 5.0.0-alpha

Para valores TIME especicados como uma string que incluem delimitadores de hora, no a necessrio especicar dois d e a igitos para valores de hora, minutos ou segundos que sejam menores que 10. 8:3:2 o mesmo que 08:03:02. e Seja cuidadoso ao atribuir valores TIME pequenos para uma coluna TIME. Sem dois pontos, o MySQL interprete valores assumindo que os digitos mais a direita representam segundos. (MySQL interpreta valores TIME como tempo decorrido ao invs de hora do dia.) Por e exemplo, voc poderia pensar em 1112 e 1112 signicam 11:12:00 (11 horas e 12 e minutos), mas o MySQL o intepreta como 00:11:12 (onze minutos e 12 segundos). De forma similar, 12 e 12 so interpretados como 00:00:12. Valores TIME com dois pontos, a em contrapartida, so tratados como hora do dia. Isto , 11:12 signicar 11:12:00, a e a no 00:11:12. a Valores que so legais mas que esto fora da faixa permitidas so ajustados para o valor a a a limita da faixa mais apropriado. Por exemplo, -850:00:00 e 850:00:00 so convera tidos para -838:59:59 e 838:59:59, respectivmente. Valores TIME ilegais so convertidos para 00:00:00. Note que como 00:00:00 um a e valor TIME, no temos com dizer, a partir de um valor 00:00:00 armazenado na tabela, a se o valor original armazenado foi especicado como 00:00:00 ou se foi ilegal.

6.2.2.4 O Tipo YEAR

O tipo YEAR um tipo de 1 byte usado para representar anos. e O MySQL recupera e mostra valores YEAR no formato YYYY. A faixa de valores de 1901 e at 2155. e Voc pode especicar valores YEAR em uma variedade de formatos: e Como uma string de 4 digitos na faixa de 1901 at 2155. e Como um nmero de 4 digitos na faixa de 1901 at 2155. u e Como uma string de dis digitos na faixa 00 at 99. Valores na faixa de 00 at e e 69 e 70 at 99 so convetidas para valores YEAR na faixa de 2000 at 2069 e e a e 1970 at 1999. e Como um nmero de 2 digitos na faixa de 1 at 99. Valores na faixa de 1 at 69 e 70 u e e at 99 so convertidos para valores YEAR na faixa de 2001 at 2069 e 1970 at 1999. e a e e Note que a faixa para nmeros de dois d u igitos um pouco diferente da faixa de strings e de dois d igitos, pois no se pode especicar zero diretamente como um nmero e t-lo a u e interpretado com 2000. Voc deve especic-lo como uma string 0 ou 00 ou ele e a ser interpretado com 0000. a Como o resultado de uma funo que retorna um valor que aceitvel em um contexto ca e a do tipo YEAR, tal como NOW(). Valores YEAR ilegais so convertidos para 0000. a

6.2.3 Tipos String

Os tipos strings so CHAR, VARCHAR, BLOB, TEXT, ENUM, e SET. Esta seo descreve como a ca este tipos funcionam, suas exigncias de armazenamento e como us-los em suas consultas. e a Tipo Tam.max imo Bytes

Cap tulo 6: Referncia de Linguagem do MySQL e

497

TINYTEXT ou TINYBLOB TEXT ou BLOB MEDIUMTEXT ou MEDIUMBLOB LONGBLOB

2^8-1 2^16-1 (64K-1) 2^24-1 (16M-1) 2^32-1 (4G-1)

255 65535 16777215 4294967295

6.2.3.1 Os Tipos CHAR e VARCHAR

Os tipos CHAR e VARCHAR so parecidos, mas diferem no modo como so armazenados e a a recuperados. O tamanho de um campo CHAR xado pelo tamanho declarado na criao da tabela. O e ca tamanho pode ser qualquer valor entre 1 e 255 (Como na verso 3.23 do MySQL, o tamanho a pode ser de 0 a 255). Quando valores CHAR so armazenados, eles so preenchidos a direita a a com espaos at o tamanho especicado. Quando valores CHAR so recuperados, espaos c e a c extras so removidos. a Valores no campo VARCHAR so strings de tamanho varivel. Voc pode declarar um campo a a e VARCHAR para ter qualquer tamanho entre 1 e 255, assim como para campo CHAR. No entanto, diferente de CHAR, valores VARCHAR so armazendos usando apenas quantos caracteres forem a necessrios, mais 1 byte para gravar o tamanho. Valores no so preenchidos; ao contrrio, a a a a espaos extras so removidos quando valores so armazenados. (Esta remoo de espaos c a a ca c difere das especicaes do SQL-99). Nenhum caso de converso feito durante um o co a e armazenamento ou recuperao. ca Se voc atribuir um valor para uma coluna CHAR ou VARCHAR que exceda o tamanho mximo e a da coluna, o valor truncado para este tamanho. e A seguinte tabela ilustra as diferenas entre os dois tipos de colunas, mostrando o resultado c de se armazenar vrios valores de strings em campos CHAR(4) e VARCHAR(4): a Valor ab abcd abcdefgh CHAR(4) ab abcd abcd Exigncia e p/ armazenamento 4 bytes 4 bytes 4 bytes 4 bytes VARCHAR(4) Exigncia e p/ armazenamento 1 byte ab 3 bytes abcd 5 bytes abcd 5 bytes

Os valores recuperados para as colunas CHAR(4) e VARCHAR(4) sero os mesmos em cada a caso, j que espaos ectras so removidos das colunas CHAR quando recuperados. a c a Valores nas colunas CHAR e VARCHAR so ordenados e comparadaos no modo caso-insensitivo, a a menos que o atributo BINARY seja especicado quando a tabela for criada. O atributo BINARY signica que os valores das colunas so ordenados e comparados no modo casoa sensitivo de acordo com a ordem ASCII da maquina onde o servidor MySQL est sesndo a executado. BINARY no afeta como as colunas so armazenadas e recuperadas. a a A partir da verso 4.1.0, o tipo de coluna CHAR BYTE um alias para CHAR BINARY. Thite a e e um recurso para compatibilidade. O atributo BINARY pegajoso. Isto signica que se uma coluna denida com BINARY e e usada na expresso, toda a expresso comparada como um valor BINARY. a a e MySQL pode alterar sem aviso o tipo de uma coluna CHAR ou VARCHAR na hora de criar a tabela. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. ca a

498

MySQL Technical Reference for Version 5.0.0-alpha

6.2.3.2 Os Tipos BLOB e TEXT

Um BLOB um objeto binario grande que pode guardar um montante variado de dados. Os e quatro tipos BLOB: TINYBLOB, BLOB, MEDIUMBLOB, e LONGBLOB diferem apenas no tamanho maximo dos valores que eles podem guradar. Veja Seo 6.2.6 [Storage requirements], ca Pgina 502. a Os quatro tipos TEXT: TINYTEXT, TEXT, MEDIUMTEXT, e LONGTEXT correspondem aos quatro tipos BLOB e tm o mesmo tamanho mximo e necessidade de tamanho para armazenamento. e a A unica diferena entre os tipos BLOB e TEXT que ordenao e comparao so realizadas c e ca ca a no modo caso-sensitivo para valores BLOB e no modo caso-insensitivo para valores TEXT. Em outras palavras, um TEXT um BLOB no modo caso-insensitivo. Nenhum caso de converso e a feito durante um o armazenamento ou recuperao. e ca Se voc atribuir um valor a uma coluna BLOB ou TEXT que exceda o tamanho mximo do e a tipo da coluna, o valor truncado para servir ao campo. e Em muitos casos, podemos considerar um campo TEXT como um campo VARCHAR que pode ser to grande quando desejamos. Da mesma forma podemos considerar um campo BLOB a como um campo VARCHAR BINARY. As diferenas so: c a Voc pode ter indices em um campo BLOB e TEXT no MySQL Verso 3.23.2 e mais e a novas. Verses antigas do MySQL no suportam isto. o a No h remoo de espaos extras para campos BLOB e TEXT quando os valores so a a ca c a armazenados, como h em campos VARCHAR. a Colunas BLOB e TEXT no podem ter valores padres. a o A partir da verso 4.1.0, LONG e LONG VARCHAR mapeiam para o tipo de dados MEDIUMTEXT. a Este um recurso de compatibilidade. e MyODBC dene valores BLOB como LONGVARBINARY e valores TEXT como LONGVARCHAR. Como valores BLOB e TEXT podem ser extremamentes longos, voc pode deparar com alguns e problemas quando utiliz-los: a Se voc quiser utilizar GROUP BY ou ORDER BY em um campo BLOB ou TEXT, voc deve e e converte-los em objetos de tamanho xo. O modo padro de se fazer isto com a a e funo SUBSTRING. Por exemplo: ca mysql> SELECT comentario FROM nome_tabela,SUBSTRING(comentario,20) AS substr -> ORDER BY substr; Se voc no zer isto, s os primeiros max_sort_length bytes de uma coluna sero e a o a utilizados na ordenao. O valor padro de max_sort_length 1024; este calor pode ca a e ser alterado utilizando-se a opo -O quando o servidor inicializado. Voc pode ca e e agrupar uma expresso envolvendo valores BLOB ou TEXT especicando a posio da a ca coluna ou utilizando apelidos (alias): mysql> SELECT id,SUBSTRING(col_blob,1,100) FROM nome_tabela GROUP BY 2; mysql> SELECT id,SUBSTRING(col_blob,1,100) AS b FROM nome_tabela GROUP BY b; O tamanho mximo de uma objeto BLOB ou TEXT determinado pelo seu tipo, mas o a e maior valor que voc pode, atualmente, transmitir entre o cliente e o servidor determie e nado pela quantidade de memria dispon e o tamanho dos buers de comunicao. o ivel ca Voc pode mudar o tamanho do buer de mensagem (max_allowed_packet), mas voc e e deve faze-lo no servidor e no cliente. Veja Seo 5.5.2 [Server parameters], Pgina 454. ca a

Cap tulo 6: Referncia de Linguagem do MySQL e

499

Note que cada valor BLOB ou TEXT representado internamente por um objeto alocado e searadamente. Est uma diferena com todos os outros tipos de colunas, para o qual o ae c armazenamento alocado um por coluna quando a tabela aberta. e e

6.2.3.3 O Tipo ENUM

Um ENUM um objeto string cujo valor normalmente escolhido de uma lista de valores e e permitidos que so enumerados explicitamente na especicao da coluna na criao da a ca ca tabela. O valor pode ser a string vazia ("") ou NULL sob certas circunstncias: a Se voc inserir um valor invlido em um ENUM (isto , uma string que no est presente e a e a a na lista de valores permitidos), a string vazia inserida no lugar como um valor especial e de erro. Esta string pode se diferenciar de um string vazia norma pelo fato de que esta string tem uo valor numrico 0. Veremos mais sobre este assunto mais tarde. e Se um ENUM declarado NULL, NULL tambm um valor permitido para a coluna, e o e e e valor padrao NULL. Se um ENUM decalarado NOT NULL, o valor padro o primeiro e e a e elemento da lista de valores permitidos. Cada enumerao tem um ca indice: Valores da lista de elementos permitidos na especicao da coluna so nmeros ca a u comeados com 1. c O valor de indice de uma string vazia que indique erro 0. Isto signica que voc pode e e usar a seguinte instruo SELECT para encontrar linhas nas quais valores ENUM invlidos ca a forma atribuidos: mysql> SELECT * FROM nome_tabela WHERE col_enum=0; O indice de um valor NULL NULL. e Por exemplo, uma coluna especicada como ENUM("um", "dois", "tr^s") pode ter quqle quer um dos valores mostrados aqui. O indice de cada valor tambm mostrado: e e Valor NULL "" "um" "dois" "tr^s" e Indice NULL 0 1 2 3

Uma enumerao pode ter um mximo de 65535 elementos. ca a A partir da verso 3.23.51 espaos extras so automaticamente deletados dos valores ENUM a c a quando a tabela criada. e O caso da letra irrelevante quando voc atribui valores a um coluna ENUM. No entanto, e e valores recuperados posteriormente da coluna ter o caso de letras de acordo com os valores a que foram usados para especicar os valores permitidos na criao da tabela. ca Se voc recupera um ENUM em um contexto numrico, o indice do valor da coluna retornado. e e e Por exemplo, voc pode recuperar valores numricos de uma coluna ENUM desta forma: e e mysql> SELECT col_enum+0 FROM nome_tabela;

500

MySQL Technical Reference for Version 5.0.0-alpha

Se voc armazena um nmero em um ENUM, o nmero tratado como um e u u e indice, e o valor armazenado o membro da enumerao com este e ca indice. (No entanto, este no ir funcionar a a com LOAD DATA, o qual trata todas as entradas como strings.) No aconselhvel armazenar a e a nmeros em uma string ENUM pois pode tornar as coisas um pouco confusas. u Valores ENUM so armazenados de acordo com a ordem na qual os membros da enumerao a ca foram listados na especicao da coluna. (Em outras palavras, valores ENUM so ordenaca a dos de acordo com o seus nmeros de u indice.) Por exemplo, "a" vem antes de "b" para ENUM("a", "b"), mas "b" vem antes de "a" para ENUM("b", "a"). A string vazia vem antes de strings no-vazias, e valores NULL vem antes de todos os outros valores de enua merao. Para evitar resultados inesperados, especique a lista ENUM em ordem alfabtica. ca e Voc tambm pode usar GROUP BY CONCAT(col) para ter certeza de que as colunas esto e e a ordenadas alfabeticamente e no pelo indice numrico. a e Se voc quiser obter todos os valores possiveis para uma coluna ENUM, voc deve usar: e e SHOW COLUMNS FROM nome_tabela LIKE nome_coluna_enum e analizar a denio de ENUM ca na segunda coluna.

6.2.3.4 O Tipo SET

Um SET um objeto string que pode ter zero ou mais valores, cada um deve ser escolhido de e uma lista de valores permitidos especicados quando a tabela criada. Valores de colunas e SET que consistem de mltiplos membros so especados separados por virgula (,). Uma u a consquncia distop que valores dos membros de SET no podem, eles mesmos, conter e e a v irgula. Por exemplo, uma coluna especicada como SET("um", "dois") NOT NULL pode ter qualquer um destes valores: "" "um" "dois" "um, dois" Um SET pode ter no mximo 64 membros diferentes. a A partir da verso 3.23.51, espaos extras so automaticamente removidos dos valores de a c a SET quando a tabela criada. e MySQL armazena valores SET numericamente, com o bit de baixa-ordem do valor armazenado correspondendo ao primeiro membro do conjunto. Se voc recupera um valor e SET em um contexto numrico, o valor recuperado tem o conjunto de bits correspondente e aos membros que aparecem no valor da coluna. Por exemplo, voc pode recuperar valores e numricos de uma coluna SET assim: e mysql> SELECT col_set+0 FROM nome_tabela; Se um nmero armazenado em uma coluna SET, os bits que esto habilitados (com 1) u e a na representao binria do nmero determinam o qual o membro no valor da coluna. ca a u Suponha uma coluna especicada como SET("a","b","c","d"). Ento os membros tero a a os seguintes valores binrios: a SET membro a Valor decimal 1 Valor binrio a 0001

Cap tulo 6: Referncia de Linguagem do MySQL e

501

b c d

2 4 8

0010 0100 1000

Se voc atribuir um valor 9 a esta coluna, que 1001 em binrio, o primeiro e o quarto e e a valores membros do SET "a" e "d" so selecionados e o valor resultante "a,d". a e Para um valor contendo mais que um elemento de SET, no importa em qual ordem os a elementos so listados quando foram inseridos seus valores. Tambm no importa quana e a tas vezes um dado elemento e listado no valor. Quando o valor recuperado posteriore mente, cada elemento aparecer uma vez, listados de acordo com a ordem em que eles a foram especicados na crio da tabela. Por exemplo, se uma coluna especicada como ca e SET("a","b","c","d"), ento "a,d", "d,a" e "d,a,a,d,d" iro todos aparecer como a a "a,d" quando recuperados. Se voc dene um valor que no suportado pela coluna SET, o valor ser ignorado. e a e a Valores SET so ordenados numricamente. Valores NULL vm antes de valores SET no a e e a NULL. Normalmente, voc realiza um SELECT em uma coluna SET usando o operador LIKE ou a e funo FIND_IN_SET(): ca mysql> SELECT * FROM nome_tabela WHERE col_set LIKE %valor%; mysql> SELECT * FROM nome_tabela WHERE FIND_IN_SET(valor,col_set)>0; Mas o seguinte tambm funciona: e mysql> SELECT * FROM nome_tabela 2 WHERE col_set = val1,val2; mysql> SELECT * FROM nome_tabela 3 WHERE col_set & 1; A primeira desta instrues procura por uma correpondencia exata. A segunda por valores co contendo o primeiro membro. Se voc quer obter todos os valores poss e iveis para uma coluna SET, voc deve usar: SHOW e COLUMNS FROM nome_tabela LIKE nome_coluna_set e analizar a denio do SET na seca gunda coluna.

6.2.4 Escolhendo o Tipo Correto para uma Coluna

Para um uso mais eciente do armzenamento, tente usar o tipo mais adequado em todos os casos. Por exemplo, se um campo de inteiro for usado para valores em uma faixa entre 1 e 99999, MEDIUMINT UNSIGNED o melhor tipo. e Represtao precisa de valores monetrios um priblema comum. No MySQL voc deve ca a e e usar o tipo DECIMAL. Ele armazena uma string, ento nenhuma perda de preciso deve a a ocorrer. Se a preciso no to importante, o tipo DOUBLE pode ser satisfatrio. a a e a o Para uma alta preciso voc sempre pode converter para um tipo de ponto xo armazenado a e em um BIGINT. Isto perite fazer todos os clculos com inteiros e converter o resultado para a um ponto utuante somente quando necessrio. a

502

MySQL Technical Reference for Version 5.0.0-alpha

6.2.5 Usando Tipos de Colunas de Outros Mecanismos de Banco de Dados

Para facilitar o uso de code para implementaes SQL de outras empresas, MySQL mapeia co os tipos de campos como mostrado na tabela seguinte. Este mapeamento torna fcil mudar a denies de tabelas de outros mecanismos de banco de dados para o MySQL: co Tipo de outras empresas BINARY(NUM) CHAR VARYING(NUM) FLOAT4 FLOAT8 INT1 INT2 INT3 INT4 INT8 LONG VARBINARY LONG VARCHAR MIDDLEINT VARBINARY(NUM) Tipo MySQL CHAR(NUM) BINARY VARCHAR(NUM) FLOAT DOUBLE TINYINT SMALLINT MEDIUMINT INT BIGINT MEDIUMBLOB MEDIUMTEXT MEDIUMINT VARCHAR(NUM) BINARY

O mapeamento do tipo de campo ocorre na criao da tabela. Se voc cria uma tabela com ca e tipos usador por outras empresas e ento executa uma instruo DESCRIBE nome_tabela, a ca MySQL relaciona a estrutura de tabela utilizando os tipos equivalentes do MySQL.

6.2.6 Exigncias de Armazenamento dos Tipos de Coluna e

As exigncias de armazenamento para cada um dos tipos de colunas suportados pelo MySQL e esto listados por categoria. a

Exigncias de armazenamento para tipos numricos e e

Tipo da coluna TINYINT SMALLINT MEDIUMINT INT INTEGER BIGINT FLOAT(X) FLOAT DOUBLE DOUBLE PRECISION REAL DECIMAL(M,D) NUMERIC(M,D) Tamanho exigido 1 byte 2 bytes 3 bytes 4 bytes 4 bytes 8 bytes 4 se X <= 24 ou 8 se 25 <= X <= 53 4 bytes 8 bytes 8 bytes 8 bytes M+2 bytes se D > 0, M+1 bytes se D = 0 (D+2, se M < D) M+2 bytes se D > 0, M+1 bytes se D = 0 (D+2, se M < D)

Cap tulo 6: Referncia de Linguagem do MySQL e

503

Exigncia de armazenamento para tipos data e hora e

Tipo de coluna DATE DATETIME TIMESTAMP TIME YEAR Tamanho exigido 3 bytes 8 bytes 4 bytes 3 bytes 1 byte

Exigncia de armazenamento para tipos string e

Tamanho exigido M bytes, 1 <= M <= 255 L+1 bytes, onde L <= M e 1 <= M <= 255 L+1 bytes, onde L < 2^8 L+2 bytes, onde L < 2^16 L+3 bytes, onde L < 2^24 L+4 bytes, onde L < 2^32 1 ou 2 bytes, dependendo do nmero de valores enumeru ados (65535 valores no mximo) a SET(valor1,valor2,...) 1, 2, 3, 4 or 8 bytes, dependendo do nmero de membros u do conjunto (64 membros no mximo) a Tipos VARCHAR, BLOB e TEXT so de tamanho variveis, tendo o tamanho exigido para a a armazenamento dependendo do tamanho atual dos valores da coluna (representado por L na tabela anterior), e no do tamanho mximo do tipo. Por exemplo, uma coluna VARCHAR(10) a a pode guardar uma string com um tamanho mximo de 10 caracteres. O tamanho exigido a para armazenamento atual o tamanho da string (L), mais 1 byte para para gravar o e tamanho da string. Por exemplo, para a string abcd, L 4 e o tamanho exigido para e armazenamento 5 bytes. e Os tipos BLOB e TEXT exigem 1, 2, 3 ou 4 bytes para gravar o tamanho do valor da coluna, dependendo do tamanho mximo poss do tipo. Veja Seo 6.2.3.2 [BLOB], Pgina 498. a ivel ca a Se uma tabela inclui qualquer tipo de coluna de tamanho varivel, o formato do registro a tambm ser de tamanho varivel. Note que quando uma tabela criada, MySQL pode, e a a e sob certas condies, mudar uma coluna de um tipo de tamanho varivel para um tipo de co a tamanho xo, ou vice-versa. Veja Seo 6.5.3.1 [Silent column changes], Pgina 607. ca a O tamanho de um objeto ENUM determinado por um nmero de diferntes valores enumere u ados. Um byte usado para enumeraes at 255 valores poss e co e iveis. Dois bytes so usados a para enumeraes at 65535 valores. Veja Seo 6.2.3.3 [ENUM], Pgina 499. co e ca a O tamanho de uma objeto determinado pelo nmero de diferentes membros do conjunto. e u Se o tamanho do conjunto N, o objeto ocupa (N+7)/8 bytes, arredondados acima para 1, e 2, 3, 4, ou 8 bytes. Um SET pode ter no mximo 64 membros. Veja Seo 6.2.3.4 [SET], a ca Pgina 500. a O tamanho mximo de um registro em uma tabela MyISAM 65534 bytes. Cada coluna a e BLOB e TEXT ocupa apenas 5-9 bytes deste tamanho. Tipo de coluna CHAR(M) VARCHAR(M) TINYBLOB, TINYTEXT BLOB, TEXT MEDIUMBLOB, MEDIUMTEXT LONGBLOB, LONGTEXT ENUM(valor1,valor2,...)

504

MySQL Technical Reference for Version 5.0.0-alpha

6.3 Funoes para Uso em Clusulas SELECT e WHERE c a

Um select_expression ou where_definition em uma instruo SQL pode consistir de ca qualquer expresso utilizando as funes descritas abaixo. a co Uma expresso que contm NULL sempre produz um valor NULL a menos que esteja indicado a e na dodumentao para os operandos e funes envolvidos na expresso. ca co a Nota: No deve haver nenhum espao em branco entre um nome de funo e os parentesis a c ca que a seguem. Isto ajuda o analizador MySQL a distinguir entre chamadas de funes e co referncias a tabelas ou colunas que possuem o mesmo nome de uma funo. Espaos entre e ca c argumentos so permitidos. a Voc pode forar o MySQL a aceitar espaos depois do nome de funes iniciando o mysqld e c c co com a opo --ansi ou usando o CLIENT_IGNORE_SPACE no mysql_connect(), mas neste ca caso nome de funes se tornaro palavras reservadas. Veja Seo 1.8.2 [ANSI mode], co a ca Pgina 42. a Para sermos breve, exemplos mostram a saida do programa mysql na forma abreviada. Ento isto: a mysql> SELECT MOD(29,9); 1 rows in set (0.00 sec) +-----------+ | mod(29,9) | +-----------+ | 2 | +-----------+ mostrado desta forma: e mysql> SELECT MOD(29,9); -> 2

6.3.1 Operadores e Funoes de Tipos no Especicados c a 6.3.1.1 Parenteses

( ... ) Use parenteses para forar a ordem em que as expresses sero avaliadas. Por exemplo: c o a mysql> SELECT 1+2*3; -> 7 mysql> SELECT (1+2)*3; -> 9

6.3.1.2 Operadores de Comparao ca

Operaes de comparao resultam em um valor 1 (VERDADEIRO), 0 (FALSO), ou NULL. co ca Estas funes funcionam tanto para tipos numricos quanto para tipos strings. Strings co e

Cap tulo 6: Referncia de Linguagem do MySQL e

505

so convertidas automaticamente para nmeros e nmeros para strings quando necessrio a u u a (como em Perl). MySQL realiza comparaes de acordo com as seguintes regras: co Se um ou ambos os argumentos so NULL, o resultado da comparao NULL, exceto a ca e para o operador <=>. Se ambos os argumentos em uma comparao so strings, eles so comparados como ca a a strings. Se ambos os argumentos so inteiros, eles so comparados como inteiros. a a Valores hexadecimais so tratados como strings binrias se no comparadas a um a a a nmero. u Se uma dos argumentos uma coluna TIMESTAMP ou DATETIME e o outro argumento e e uma constante, a constante convertida para um timestamp antes da comparao ser e ca realizada. Isto ocorre para ser mais amigvel ao ODBC. a Em todos os outros casos, os argumentos so coparados como nmeros de ponto utua u ante (real). Por padro, comparaes de string so feita de modo independente do caso, usando o a co a conjunto de caracteres atual (ISO-8859-1 Latin1 por padro, o qual tambm funciona de a e forma excelente para o Ingls). e Se voc est comparando strings em caso insensitivo com qualquer dos operadores padres e a o (=, <>..., mas no o LIKE) espaos em branco no m da string (espaos, tabs e quebra de a c c linha) sero ignorados. a mysql> SELECT "a" ="A \n"; -> 1 Os seguintes exemplos ilustram a converso de strings para nmeros para operaes de a u co comparao: ca mysql> SELECT -> 0 mysql> SELECT -> 1 mysql> SELECT -> 0 mysql> SELECT -> 1 1 > 6x; 7 > 6x; 0 > x6; 0 = x6;

Note que quando voc est comparando uma coluna string com um nmero, o MySQL no e a u a pode usar indices para encontrar o valor rapidamente: SELECT * FROM table_name WHERE string_key=1 A razo para isto que existem muitas strings diferentes que podem retornar o valor 1: a e "1", " 1", "1a" ... = Igual: mysql> SELECT 1 = 0; -> 0 mysql> SELECT 0 = 0;

506

MySQL Technical Reference for Version 5.0.0-alpha

-> 1 mysql> SELECT 0.0 = 0; -> 1 mysql> SELECT 0.01 = 0; -> 0 mysql> SELECT .01 = 0.01; -> 1 <> != Diferente: mysql> SELECT .01 <> 0.01; -> 1 mysql> SELECT .01 <> 0.01; -> 0 mysql> SELECT zapp <> zappp; -> 1 <= Menor que ou igual: mysql> SELECT 0.1 <= 2; -> 1 < Menor que: mysql> SELECT 2 < 2; -> 0 >= Maior que ou igual: mysql> SELECT 2 >= 2; -> 1 > Maior que: mysql> SELECT 2 > 2; -> 0 <=> Igual para NULL: mysql> SELECT 1 <=> 1, NULL <=> NULL, 1 <=> NULL; -> 1 1 0 IS NULL IS NOT NULL Teste para saber se um valor ou no NULL: e a mysql> SELECT 1 IS NULL, 0 IS NULL, NULL IS NULL; -> 0 0 1 mysql> SELECT 1 IS NOT NULL, 0 IS NOT NULL, NULL IS NOT NULL; -> 1 1 0 Para estar apto a funcionar bem com outros programas, MySQL suporta os seguintes recursos extras quando utiliza-se IS NULL: Voc pode encontrar o ultimo registro inserido com: e SELECT * FROM nome_tabela WHERE auto_col IS NULL

Cap tulo 6: Referncia de Linguagem do MySQL e

507

Isto pode ser desabilitado congurando SQL_AUTO_IS_NULL=0. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca a Para colunas DATE e DATETIME NOT NULL voc pode encontrar a data espee cial 0000-00-00 utilizando: SELECT * FROM nome_tabela WHERE coluna_data IS NULL Isto necessrio para que algums aplicaes ODBC funcionem (j que e a co a ODBC no tem suporte a data 0000-00-00) a expr BETWEEN min AND max Se expr maior que ou igual a min e expr menor que ou igual a max, BETWEEN e e retorna 1, seno retornado 0. Isto equivalente a expresso (min <= expr AND a e e a expr <= max) se todos os argumentos so do mesmo tipo. Seno os tipos so a a a convertidos, conforme as regras acima, e aplicadas a todos os trs argumentos. e Note que antes da verso 4.0.5 argumentos eram convertidos para o tipo da a expr. mysql> SELECT 1 BETWEEN 2 AND 3; -> 0 mysql> SELECT b BETWEEN a AND c; -> 1 mysql> SELECT 2 BETWEEN 2 AND 3; -> 1 mysql> SELECT 2 BETWEEN 2 AND x-3; -> 0 expr NOT BETWEEN min AND max O mesmo que NOT (expr BETWEEN min AND max). expr IN (valor,...) Retorna 1 se expr qualquer dos valores na lista IN, seno retorna 0. Se todos e a os valores so constantes, ento os valores so avaliados de acordo com o tipo da a a a expr e ordenado. A busca do item ento feita usando pesquisa binria. Isto e a a signica que IN muito rpido se os valores da lista IN forem todos contantes. e a Se expr uma expresso strig em caso-sensitivo, a comparao realizadas no e a ca e modo caso-sensitvo: mysql> SELECT 2 IN (0,3,5,wefwf); -> 0 mysql> SELECT wefwf IN (0,3,5,wefwf); -> 1 O nmero de valores na lista IN limitada apenas pelo valor max_allowed_ u e packet. Na verso 4.1 (para se adequar ao padro SQL-99), IN returna NULL no apeans a a a se a expresso a sua esquerda NULL, mas tambm se nenhuma correspondncia a e e e encontrada na lista e uma de suas expresses NULL. e o e A partir do MySQL verso 4.1, uma clusula IN() tambm pode conter uma a a e subquery. Veja Seo 6.4.2.3 [ANY IN SOME subqueries], Pgina 572. ca a expr NOT IN (valor,...) O mesmo que NOT (expr IN (valor,...)).

508

MySQL Technical Reference for Version 5.0.0-alpha

ISNULL(expr) Se expr NULL, ISNULL() retorna 1, seno retorna 0: e a mysql> SELECT ISNULL(1+1); -> 0 mysql> SELECT ISNULL(1/0); -> 1 Note que a comprao de valores NULL usando = sempre ser falso! ca a COALESCE(lista) Retorna o primeiro elemento no NULL na lista: a mysql> SELECT COALESCE(NULL,1); -> 1 mysql> SELECT COALESCE(NULL,NULL,NULL); -> NULL INTERVAL(N,N1,N2,N3,...) Retorna 0 se N < N1, 1 se N < N2 e assim por diante ou -1 se N NULL. Todos e os argumentos so tratados como inteiros. Isto exige que N1 < N2 < N3 < ... < a Nn para que esta funo funcione corretamente. Isto ocorre devido a utilizao ca ca pesquisa binria (muito rpida): a a mysql> SELECT INTERVAL(23, 1, 15, 17, 30, 44, 200); -> 3 mysql> SELECT INTERVAL(10, 1, 10, 100, 1000); -> 2 mysql> SELECT INTERVAL(22, 23, 30, 44, 200); -> 0

6.3.1.3 Operadores Logicos

Em SQL, todos os operadores logicos avaliam TRUE (VERDADEIRO), FALSE (FALSO) ou NULL (DESCONHECIDO). No MySQL, esta implementao como 1 (TRUE), 0 ca e (FALSE), e NULL. A maioria deles comum entre diferentes bancos de dados SQL. no e entanto alguns podem retonar qualquer valor diferente de zero para TRUE. NOT ! NOT logico. Avalia como 1 se o operador 0, como 0 se o operador diferente e e de zero, e NOT NULL retorna NULL. mysql> SELECT NOT 10; -> 0 mysql> SELECT NOT 0; -> 1 mysql> SELECT NOT NULL; -> NULL mysql> SELECT ! (1+1); -> 0 mysql> SELECT ! 1+1; -> 1

Cap tulo 6: Referncia de Linguagem do MySQL e

509

O ultimo exemplo produz 1 pois a a expresso avaliada como (!1)+1. a e AND && AND lgico. Avalia como 1 se todos os operandos so diferentes de zero e no o a a NULL, como 0 se um ou mais operandos so 0, seno retorna NULL. e a a mysql> SELECT 1 && 1; -> 1 mysql> SELECT 1 && 0; -> 0 mysql> SELECT 1 && NULL; -> NULL mysql> SELECT 0 && NULL; -> 0 mysql> SELECT NULL && 0; -> 0 Por favor note que as verses do MySQL anteriores a verso 4.0.5 param a o a avaliao quando um valor NULL encontrado, e no continua o processo busca e a cando por poss iveis 0s. Isto signica que nessa verso, SELECT (NULL AND 0) a retorna NULL ao invs de 0. Na verso 4.0.5 o cdigo tem sido re-elaborado e a o para que o resultado sempre seja como prescrito pelo padro SQL utilizando a a otimizao sempre que poss ca ivel. OR lgico. Avalia como 1 se algum operando diferente de zero e como NULL o e se algum operando for NULL, seno 0 retornado. a e mysql> SELECT 1 || 1; -> 1 mysql> SELECT 1 || 0; -> 1 mysql> SELECT 0 || 0; -> 0 mysql> SELECT 0 || NULL; -> NULL mysql> SELECT 1 || NULL; -> 1 XOR lgico. Retorna NULL se o operando tambm NULL. Para operandos o e e no NULL, avalia como 1 se um nmero impar de operandos diferente de zero, a u e seno 0 retornado. a e mysql> SELECT 1 XOR 1; -> 0 mysql> SELECT 1 XOR 0; -> 1 mysql> SELECT 1 XOR NULL; -> NULL mysql> SELECT 1 XOR 1 XOR 1; -> 1 a XOR b matematicamente igual a (a AND (NOT b)) OR ((NOT a) and b). e

OR ||

XOR

510

MySQL Technical Reference for Version 5.0.0-alpha

XOR foi adicionado na verso 4.0.2. a

6.3.1.4 Funoes de Fluxo de Controle c

CASE valor WHEN [valor comparado] THEN resultado [WHEN [valor comparado] THEN resultado ...] [ELSE resultado] END CASE WHEN [condi~o] THEN result [WHEN [condi~o] THEN resultado ...] [ELSE ca ca resultado] END A primeira expresso retorna o resultado onde valor=valor comparado. A a segunda expresso retorna o o resultado da primeira condio, a qual vera ca e dadeira. Se no existe nenhum resultado correspondente, ento o resultado a a depois do ELSE retornado. Se no existe parte ELSE ento retornado NULL e a a e is returned: mysql> SELECT CASE 1 WHEN 1 THEN "um" WHEN 2 THEN "dois" ELSE "mais" END; -> "one" mysql> SELECT CASE WHEN 1>0 THEN "verdadeiro" ELSE "falso" END; -> "true" mysql> SELECT CASE BINARY "B" WHEN "a" THEN 1 WHEN "b" THEN 2 END; -> NULL O tipo do valor de retorno (INTEGER, DOUBLE ou STRING) do mesmo tipo do e primeiro valor retornado (a expresso depois do primeiro THEN). a IF(expr1,expr2,expr3) Se expr1 VERDADEIRA (expr1 <> 0 e expr1 <> NULL) ento IF() retorna e a expr2, seno ela retorna expr3. IF() returna um valor numrico ou string, a e dependendo do contexto no qual usado. e mysql> SELECT IF(1>2,2,3); -> 3 mysql> SELECT IF(1<2,sim,n~o); a -> sim mysql> SELECT IF(STRCMP(teste,teste1),n~o,sim); a -> n~o a Se expr2 ou expr3 explicitamente NULL ento o tipo resultante da funo e a ca IF() o tipo da coluna no NULL. (Este comportamento novo na verso 4.0.3 e a e a do MySQL). expr1 avaliada como um valor inteiro, o qual signica que se voc est testando e e a valores de ponto utuante ou strings, voc de faz-lo usando um operando de e e comparao: ca mysql> SELECT IF(0.1,1,0); -> 0 mysql> SELECT IF(0.1<>0,1,0); -> 1 No primeiro caso acima, IF(0.1) retorna 0 porque 0.1 convertido para um e valor inteiro, resultando um um teste IF(0). Isto pode no ser o que voc a e

Cap tulo 6: Referncia de Linguagem do MySQL e

511

esperava. No segundo caso, a comparao testa se o valor de ponto utuante ca no zero. O resultado da comparaao converte o termo em um interiro. a e c O tipo de retorno padro de IF() (o que pode importar quando ele ara e mazenado em uma tabela temporria) calculado na verso 3.23 do MySQL a e a de seguinte forma: Expresso a expr2 ou expr3 retorna string expr2 ou expr3 retorna um valor de ponto utuante expr2 ou expr3 retorna um inteiro Valor de retorno string ponto utuante inteiro

Se expr2 e expr3 so strings, ento o resultado caso-insensitivo se ambas a a e strings so caso insensitivo. (A patir da verso 3.23.51) a a IFNULL(expr1,expr2) Se expr1 no NULL, IFNULL() retorna expr1, seno retorna expr2. IFNULL() a e a retorna um valor numrico ou string, dependendo do contexto no qual usado: e e mysql> SELECT IFNULL(1,0); -> 1 mysql> SELECT IFNULL(NULL,10); -> 10 mysql> SELECT IFNULL(1/0,10); -> 10 mysql> SELECT IFNULL(1/0,yes); -> yes Na verso 4.0.6 e acima o valor resultante padro de IFNULL(expr1,expr2) o a a e mais geral das duas expresses, na seguinte ordem: STRING, REAL ou INTEGER. o A diferena das verses anteriores mais notvel quando se cria uma tabela c o e a baseada em uma expresso ou o MySQL tem que armazenar internamente um a valor de IFNULL() em uma tabela temporria. a CREATE TABLE foo SELECT IFNULL(1,"teste") as teste; Na verso 4.0.6 do MySQL o tipo da coluna teste CHAR(4) enquanto nas a e verses anteriores ela seria do tipo BIGINT. o NULLIF(expr1,expr2) Se expr1 = expr2 for verdadeiro, retornado NULL seno retornado expr1. e a e Isto o mesmo que CASE WHEN x = y THEN NULL ELSE x END: e mysql> SELECT NULLIF(1,1); -> NULL mysql> SELECT NULLIF(1,2); -> 1 Note que expr1 avaliada duas vezes no MySQL se os argumentos no so e a a iguais.

512

MySQL Technical Reference for Version 5.0.0-alpha

6.3.2 Funoes String c

Funes string retornam NULL se o tamanho do resultado for maior que o parmetro do co a servidor max_allowed_packet. Veja Seo 5.5.2 [Server parameters], Pgina 454. ca a Para funes que operam com as posies de uma string, a primeira posio numerada co co ca e como 1. ASCII(str) Retorna o valor do cdigo ASCII do caracter mais a esquerda da string str. o Retorna 0 se str uma string vazia. Retorna NULL se str NULL: e e mysql> SELECT ASCII(2); -> 50 mysql> SELECT ASCII(2); -> 50 mysql> SELECT ASCII(dx); -> 100 Veja tambm a funo ORD(). e ca BIN(N) Retorna um representao string do valor binrio de N, onde N um nmero ca a e u muito grande (BIGINT). Isto equivalente a CONV(N,10,2). Retorna NULL se N e NULL: e mysql> SELECT BIN(12); -> 1100

BIT_LENGTH(str) Retorna o tamanho da string str em bits: mysql> SELECT BIT_LENGTH(text); -> 32 CHAR(N,...) CHAR() interpretia os argumentos como inteiros e retorna uma string com caracteres dados pelo valor do cdigo ASCII referentes a estes inteiros. Valores o NULL so desconsiderados: a mysql> SELECT CHAR(77,121,83,81,76); -> MySQL mysql> SELECT CHAR(77,77.3,77.3); -> MMM CONCAT(str1,str2,...) Retorna a string resultante da concatenao dos argumentos. Retorna NULL ca se qualquer dos argumentos for NULL. Pode ter mais de 2 argumentos. Um argumento numrico convertido para sua forma string equivalente: e e mysql> SELECT CONCAT(My, S, QL); -> MySQL mysql> SELECT CONCAT(My, NULL, QL); -> NULL mysql> SELECT CONCAT(14.3); -> 14.3

Cap tulo 6: Referncia de Linguagem do MySQL e

513

CONCAT_WS(separador, str1, str2,...) CONCAT_WS() signica CONCAT With Separator (CONCAT com separador) e uma forma especial do CONCAT(). O primeiro argumento o separador para os e e outros argumentos. O separador adicionado entre as strings a serem concatee nadas: O separador pode ser uma string assim como os outros argumentos. Se o separador NULL, o resultado ser NULL. A funo ir desconsiderar qualquer e a ca a NULL depois do argumento do separador. mysql> SELECT CONCAT_WS(",","First name","Second name","Last Name"); -> First name,Second name,Last Name mysql> SELECT CONCAT_WS(",","First name",NULL,"Last Name"); -> First name,Last Name Antes do MySQL 4.1.1, CONCAT_WS() desconsiderava strings vazias assim como valores NULL. CONV(N,da_base,para_base) Converte nmeros entre diferentes bases. Retorna uma representao string do u ca nmero N, convertido da base da_base para base para_base. Retorna NULL se u qualquer argumento NULL. O argumento N interpretado como um inteiro, e e mas pode ser especicado como um inteiro ou uma string. A base m inima 2 e e a mxima 36. Se para_base um nmero negativo, N considerado como a e e u e um nmero com sinal. Caso contrrio, N tratado como um nmero sem sinal. u a e u CONV funciona com preciso de 64-bit: a mysql> SELECT CONV("a",16,2); -> 1010 mysql> SELECT CONV("6E",18,8); -> 172 mysql> SELECT CONV(-17,10,-18); -> -H mysql> SELECT CONV(10+"10"+10+0xa,10,10); -> 40 ELT(N,str1,str2,str3,...) Retorna str1 se N = 1, str2 se N = 2, e assim por diante. Retorna NULL se N menor que 1 ou maior que o nmero de argumentos. ELT() o complemento e u e de FIELD(): mysql> SELECT ELT(1, ej, Heja, hej, foo); -> ej mysql> SELECT ELT(4, ej, Heja, hej, foo); -> foo EXPORT_SET(bits,on,off,[separador,[numero_de_bits]]) Retorna uma string onde para todo bit 1 em bit, voc obtm uma string on e e e para cada bit 0 voc obtem uma string o, Cada string separada com e e separador (padro,,) e s nmero de bits (padro 64) de bits usado: a o u a e mysql> SELECT EXPORT_SET(5,S,N,,,4) -> S,N,S,N

514

MySQL Technical Reference for Version 5.0.0-alpha

FIELD(str,str1,str2,str3,...) Retorna o indice de str na lista str1, str2, str3, .... Retorns 0 se str no a for encontrada. FIELD() o complemento de ELT(): e mysql> SELECT FIELD(ej, Hej, ej, Heja, hej, foo); -> 2 mysql> SELECT FIELD(fo, Hej, ej, Heja, hej, foo); -> 0 FIND_IN_SET(str,strlista) Retorna um valor 1 para N se a string str est na lista strlist contendo N a substrings. A lista de string composta de substrings separadas pelo carace ter ,. Se o primeiro argumento uma string constante e o segundo uma e e coluna do tipo SET, a funo FIND_IN_SET() otimizada para usar aritmtica ca e e binria! Retorna 0 se str no est na strlista ou se strlista uma string a a a e vazia. Retorna NULL se os argumentos so NULL. Esta funo no ir funcionar a ca a a adequadamente se o primeiro argumento contm uma virgula (,): e mysql> SELECT FIND_IN_SET(b,a,b,c,d); -> 2 HEX(N_ou_S) Se N OU S um nmero, retornado um representao string do valor hexe u e ca adecimal de N, onde N um nmero muito grande (BIGINT). Isto equivalente e u e a CONV(N,10,16). Se N OU S uma string, retornado uma string hexadecimal de N OU S onde e e cada caracter de N OU S convertido para 2 d e igitos hexadecimais. Isto o e inverso da string 0xff. mysql> SELECT HEX(255); -> FF mysql> SELECT HEX("abc"); -> 616263 mysql> SELECT 0x616263; -> "abc" INSTR(str,substr) Retorna a posio da primeira ocorrncia da substring substr na string str. ca e o mesmo que as o LOCATE() com dois argumentos, exceto pelo fato de que os E argumentos esto tracados: a mysql> SELECT INSTR(foobarbar, bar); -> 4 mysql> SELECT INSTR(xbar, foobar); -> 0 Esta funo multi-byte. Na verso 3.23 do MySQL esta funo caso sensitivo, ca e a ca e enquanto na verso 4.0 ela s caso-sensitivo se os argumentos so uma string a oe a binria. a INSERT(str,pos,tam,novastr) Retorna a string str, com a a substring comeando na posio pos e contendo c ca tam caracteres substituida pela string novastr:

Cap tulo 6: Referncia de Linguagem do MySQL e

515

mysql> SELECT INSERT(Quadratico, 3, 4, Onde); -> QuOndetico Esta funo multi-byte. ca e LCASE(str) LOWER(str) Retorna a string str com todos caracteres alterados para letra minsculas de u acordo com o conjunto de caracteres atual (o padro ISO-8859-1 Latin1): a e mysql> SELECT LCASE(MYSQL); -> mysql Esta uma funo multi-byte. e ca LEFT(str,tam) Retorna os tam caracteres mais a esquerda da string str: mysql> SELECT LEFT(foobarbar, 5); -> fooba Esta funo multi-byte. ca e LOAD_FILE(nome_arquivo) Lb o arquivo e retona o conteudo do arquivo como uma string. O arquivo beve e estar no servidor, voc deve especicar o caminho completo para o arquivo, e e voc deve ter o privilgio FILE. O arquivo deve ser leg e e ivel para todos e ser menor que o especicado em max_allowed_packet. Se o arquivo no existe ou no pode ser lido devido a alguma das razes acima, a a o a funo retornar NULL: ca a mysql> UPDATE nome_tabela SET coluna_blob=LOAD_FILE("/tmp/picture") WHERE id=1; Se voc no est usando a verso 3.23 MySQL, voc tem que fazer a leitura e a a a e do arquivo dentro do seu aplicativo e criar uma instruo INSERT para atuca alizar o banco de dados com a informao do arquivo. Um modo de se fazer ca isto, se voc estiver usando a biblioteca MySQL++, pode ser encontrada em e http://www.mysql.com/documentation/mysql++/mysql++-examples.html. LOCATE(substr,str) LOCATE(substr,str,pos) A primeira sintaxe retorna a posio da primeira ocorrncia da substring substr ca e na string str. A segunda sintaxe retorna a posio da primeira ocorrncia da ca e substring substr na string str, iniciando na posio pos. Retornam 0 se ca substr no est em str: a a mysql> SELECT LOCATE(bar, foobarbar); -> 4 mysql> SELECT LOCATE(xbar, foobar); -> 0 mysql> SELECT LPAD(hi,4,??); -> ??hi

516

MySQL Technical Reference for Version 5.0.0-alpha

LTRIM(str) Retorna a string str com caracteres de espaos extras iniciais removidos: c mysql> SELECT LTRIM( barbar); -> barbar MAKE_SET(bits,str1,str2,...) Retorna um conjunto (uma string contendo substrings separadas por ,) contendo as strings que tem o bit correspondente em bits denido . str1 corresponde ao bit 1, str2 ao bit 2, etc. Strings NULL em str1, str2, ... no so a a adicionadas ao resultado: mysql> SELECT MAKE_SET(1,a,b,c); -> a mysql> SELECT MAKE_SET(1 | 4,Oi,meu,mundo); -> Oi,mundo mysql> SELECT MAKE_SET(0,a,b,c); -> OCT(N) Retorna uma representao string do valor octal de N, onde N um nmero ca e u muito grande. Isto equivalente a CONV(N,10,8). Retorna NULL se N NULL: e e mysql> SELECT OCT(12); -> 14 ORD(str) Se o caracter mais a esquerda da string str um caracter multi-byte, e retornado o cdigo para este caracter, calculado a partir dos valores e o do cdigo ASCII dos seus caracteres contituintes utizando-se a seguinte o frmula: ((primeiro byte do cdigo ASCII)*256+(segundo byte do cdigo o o o ASCII))[*256+terceiro byte do cdigo ASCII...]. Se o caracter mais a o esquerda no multi-byte, retornado o mesmo valor que a funo ASCII() a e e ca retorna: mysql> SELECT ORD(2); -> 50

LENGTH(str) OCTET_LENGTH(str) CHAR_LENGTH(str) CHARACTER_LENGTH(str) Retorna o tamanho da string str: mysql> SELECT LENGTH(text); -> 4 mysql> SELECT OCTET_LENGTH(text); -> 4 LENGTH() e OCTET_LENGTH() so sinnimos e medem o tamanho da length em a o bytes (octets). Um caracter multi-byte conta considerado vrios bytes. CHAR_ e a LENGTH() e CHARACTER_LENGTH() so sinnimos e medem o tamanho da string a o em caracteres. Um caracter multi-byte conta como um unico caracter. Isto signica que para uma string contendo cinco caracteres de dois bytes, LENGTH() retorna 10, enquanto CHAR_LENGTH() retorna 5.

Cap tulo 6: Referncia de Linguagem do MySQL e

517

MID(str,pos,len) MID(str,pos,len) um sinnimo para SUBSTRING(str,pos,len). e o POSITION(substr IN str) POSITION(substr IN str) um sinnimo para LOCATE(substr,str). e o QUOTE(str) Coloca uma string entre aspas para produzir um resultado que possa ser usada em uma intruo SQL como um valor de dados com o caracter de escape correto. ca A string retornada entre aspas simples e cada instqncia de aspas simples e a (), barra invertida (\), ASCII NUL, e Control-Z precedida por uma barra e invertida. Se o argumento NULL, o valor retornado a palavra NULL sem e e aspas simples. A funo QUOTE() foi adicionada na verso 4.0.3 do MySQL. ca a mysql> SELECT QUOTE("Dont"); -> Don\t! mysql> SELECT QUOTE(NULL); -> NULL REPEAT(str,cont) Retorna uma string consistindo da string str repetida cont vezes. Se cont <= 0, retornado uma string vazia. E retornado NULL se str ou cont so NULL: e a mysql> SELECT REPEAT(MySQL, 3); -> MySQLMySQLMySQL REPLACE(str,da_str,para_str) Retorna a string str com todas ocorrncias da string da_str substituida pela e string para_str: mysql> SELECT REPLACE(www.mysql.com, w, Ww); -> WwWwWw.mysql.com Esta funo multi-byte. ca e REVERSE(str) Returns the string str with the order of the characters reversed: mysql> SELECT REVERSE(abc); -> cba Esta funo multi-byte. ca e RIGHT(str,tem) mysql> SELECT RIGHT(foobarbar, 4); -> rbar Esta funo multi-byte. ca e RPAD(str,tam,strpreech) Retorna a string str, preenchida a direita com a string strpreench para um tamanho de tam caracteres. Se str maior que tam, o valor retornado reduzido e e para tam caracteres. mysql> SELECT RPAD(hi,5,?); -> hi???

518

MySQL Technical Reference for Version 5.0.0-alpha

RTRIM(str) Retourna a string str com caracteres de espaos extras nais removidos: c mysql> SELECT RTRIM(barbar ); -> barbar Esta funo multi-byte. ca e SOUNDEX(str) Retorna uma string soundex de str. Duas strings que parecidas fonticamentea devem ter strings soundex iguais. Uma string soundex padro e a possui 4 caracteres, mas a funo SOUNDEX() retorna uma string de tamanho ca arbitrrio. Voc posde usar SUBSTRING() no resultado para obter uma string a e soundex padro. Todos os caracteres no alfanumricos so ignorados na a a e a string dada. Todas caracteres internacionais fora da faixa A-Z so tratados a como vogais: mysql> SELECT SOUNDEX(Hello); -> H400 mysql> SELECT SOUNDEX(Quadratically); -> Q36324 SPACE(N) Retorna uma string contendo N caracteres de espao: c mysql> SELECT SPACE(6); ->

SUBSTRING(str,pos) SUBSTRING(str FROM pos) SUBSTRING(str,pos,tam) SUBSTRING(str FROM pos FOR tam) A forma sem um argumento tam retorna uma substring da string str iniciando na posio pos. A forma com um argumento tam retorna a substring com tam ca caracteres da string str, iniciando da posio pos. A forma variante que utiliza ca FROM a sintaxe SQL-92: e mysql> SELECT SUBSTRING(Quadratically,5); -> ratically mysql> SELECT SUBSTRING(foobarbar FROM 4); -> barbar mysql> SELECT SUBSTRING(Quadratically,5,6); -> ratica Esta funo multi-byte. ca e SUBSTRING_INDEX(str,delim,cont) Retorna a substring da string str antes de cont ocorrencias do delimitador delim. Se cont positivo, tudo a esquerda do delimitador nal (contando a e partir da esquerda) retornado. Se cont negativo, tudo a direita do delimie e tador nal (contando a partir da direita) retornado. e mysql> SELECT SUBSTRING_INDEX(www.mysql.com, ., 2); -> www.mysql mysql> SELECT SUBSTRING_INDEX(www.mysql.com, ., -2); -> mysql.com

Cap tulo 6: Referncia de Linguagem do MySQL e

519

Esta funo multi-byte. ca e TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str) Retorna a string str com todos prexos e/ou suxos remstr removidos. Se nenhum dos especicadores BOTH, LEADING ou TRAILING so dados, considerado a e BOTH. Se remstr no especicada, espaos so removidos: a e c a mysql> SELECT TRIM( bar ); -> bar mysql> SELECT TRIM(LEADING x FROM xxxbarxxx); -> barxxx mysql> SELECT TRIM(BOTH x FROM xxxbarxxx); -> bar mysql> SELECT TRIM(TRAILING xyz FROM barxxyz); -> barx Esta funo multi-byte. ca e UCASE(str) UPPER(str) Retorna a string str com todos caracteres alterados para letra maisculas de u acordo com o conjunto de caracteres atual (o padro ISO-8859-1 Latin1): a e mysql> SELECT UCASE(Hej); -> HEJ Esta uma funo multi-byte. e ca

6.3.2.1 Funoes de Comparao de Strings c ca

MySQL automaticamente converte nmeros para quando necessrio, e vice-versa: u a mysql> SELECT 1+"1"; -> 2 mysql> SELECT CONCAT(2, test); -> 2 test Se voc quiser converter um nmero em uma string de forma explicita, passe-o como um e u argumento de CONCAT(). Se uma funo de string tem uma string binria como argumento, a string resultante ca a e tambm um string binria. Um nmero convertido para uma string tratado como um e a u e string binria. Isto afeta apenas a comparao. a ca Normalmente, se qualquer expresso em uma string caso-sensitivo, a comparao reala e ca e izada no modo caso sensitivo. expr LIKE pad [ESCAPE car-escape] Correspondncia de padres usando uma simples expresso de comparaes e o a co SQL. Retorna 1 (VERDADEIRO) ou 0 (FALSO). Com LIKE voc pode usar os e seguintes meta-caracteres no padrao: Car Descrio ca % Corresponde a qualquer nmero de caracteres, at u e zero caracteres _ Corresponde a exatamente um caracter

520

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT David! LIKE David_; -> 1 mysql> SELECT David! LIKE %D%v%; -> 1 Para testar instncias literais de um meta caracter, preceda o caracter com o a carcter de escape. Se voc no especicar o caracter de ESCAPE, assume-se \: e a String Description \% Correponde a um caracter % \_ Correponde a um caracter _ mysql> SELECT David! LIKE David\_; -> 0 mysql> SELECT David_ LIKE David\_; -> 1 Para especicar um caracter de escape diferebte, use a clusula ESCAPE: a mysql> SELECT David_ LIKE David|_ ESCAPE |; -> 1 As seguintes instrues mostram que a comparao de strings so co ca a caso-insensitivo, a menos que um dos operandos seja uma string binria: a mysql> SELECT abc LIKE ABC; -> 1 mysql> SELECT abc LIKE BINARY ABC; -> 0 LIKE permitido em uma expresso numrica! (Esta uma extenso MySQL e a e e a para o LIKE do SQL-99.) mysql> SELECT 10 LIKE 1%; -> 1 Nota: Como MySQL usa sintaxe de escape do C em strings (por exemplo, \n), voc deve dobrar qualquer \ que voc usar em sua string LIKE. Por e e exemplo, para pesquisar por \n, especique-o como \\n. Para buscar por \, especique-o como \\\\ (as barras invertidas so eliminadas uma vez pelo a analizador e outra vez quando a correspondncia de padres feita, deixando e o e uma unicas barra invertida para ser vericada). Note: O LIKE atual no um caracter multi-byte. Comparaoes so feitas a e ca a caracter por caracter. expr NOT LIKE pad [ESCAPE car-escape] O mesmo que NOT (expr LIKE pad [ESCAPE car-escape]). expr SOUNDS LIKE expr O mesmo que SOUNDEX(expr)=SOUNDEX(expr) (dispon apenas na verso 4.1 ivel a ou posterior). expr REGEXP pad expr RLIKE pad Realiza a busca de padres em uma express string com base no padro pad. O o a a padro pode ser uma expresso regular extendida. Veja Apndice G [Regexp], a a e

Cap tulo 6: Referncia de Linguagem do MySQL e

521

Pgina 1093. Retorna 1 se expr conincide com pad, seno retorna 0. RLIKE a a um sinnimo para REGEXP, fornecido para compatibilidade com mSQL. Nota: e o Como MySQL usa a sintaxe de escape do C em strings (por exemplo, \n), voc deve dobrar qualquer \ que voc use em sua string REGEXP. Como na e e verso 3.23.4 do MySQL, REGEXP caso- insensitivo para strings normais (no a e a binrias). a mysql> SELECT Monty! REGEXP m%y%%; -> 0 mysql> SELECT Monty! REGEXP .*; -> 1 mysql> SELECT new*\n*line REGEXP new\\*.\\*line; -> 1 mysql> SELECT "a" REGEXP "A", "a" REGEXP BINARY "A"; -> 1 0 mysql> SELECT "a" REGEXP "^[a-d]"; -> 1 REGEXP e RLIKE usam o conjunto de caracteres atual (ISO-8859-1 Latin1 por padro) para decidir o tipo de caracter. a expr NOT REGEXP pad expr NOT RLIKE pad O mesmo que NOT (expr REGEXP pad). STRCMP(expr1,expr2) STRCMP() retorna 0 se as string so a mesma, -1 se o primeiro argumento a e menor que o segundo de acordo com a ordenao atual e 1 em caso contrrio: ca a mysql> SELECT STRCMP(texto, texto2); -> -1 mysql> SELECT STRCMP(texto2, texto); -> 1 mysql> SELECT STRCMP(texto, texto); -> 0 MATCH (col1,col2,...) AGAINST (expr [IN BOOLEAN MODE | WITH QUERY EXPANSION] ) MATCH ... AGAINST() usado para busca de textos completos e retorna a e relvncia - similaridade medidad entre o texto nas colunas (col1,col2,...) a e a consulta expr. Relevncia um nmero de ponto utuante. Relevncia a e u a zero signica que no houve nenhuma similaridade. MATCH ... AGAINST() est a a na verso 3.23.23 ou posterior do MySQL. A extenso IN BOOLEAN disponivel a a MODE foi adicionada na verso 4.0.1, WITH QUERY EXPANSION foi adicionado na a verso 4.1.1. Para detalhes e exemplos de uso, veja Seo 6.8 [Fulltext Search], a ca Pgina 619. a

6.3.2.2 Caso Sensitivo

BINARY O operador BINARY transforma uma string em uma string binria. Este um a e modo fcil de forar a comparao para se caso-sensitivo mesmo se a coluna a c ca no seja denida como BINARY ou BLOB: a

522

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT "a" = "A"; -> 1 mysql> SELECT BINARY "a" = "A"; -> 0 BINARY string um atalho para CAST(string AS BINARY). Veja Seo 6.3.5 e ca [Cast Functions], Pgina 544. BINARY foi introduzida na verso 3.23.0 do a a MySQL. Note que em alguns contextos MySQL no estar apto a usar o a a indice de forma eciente quando se transformar uma coluna indice em BINARY. Se voc quiser compara um blob caso-insensitivo voc pode sempre convert-lo para letras e e e maisculas antes de faer a comparao: u ca SELECT A LIKE UPPER(col_blobl) FROM nome_tabela; No planejamos introduzir em breve coero (casting) entre diferentes conjuntos de caraca ca teres para tornar compares de strings mais ex co ivel.

6.3.3 Funoes Numricas c e 6.3.3.1 Operaoes Aritimticas c e

Os operadores aritimticos usuais esto dispon e a iveis. -, +, e *, o resultado calculado e com preciso de BIGINT (64-bit) se ambos os argumentos so inteiros! Se um dos argumentos a a for um inteiro sem sinal, e o outro argumento um inteiro tambm, o resultado ser um e e a inteiro sem sinal. Veja Seo 6.3.5 [Cast Functions], Pgina 544. ca a + Adio: ca mysql> SELECT 3+5; -> 8 Subtrao: ca mysql> SELECT 3-5; -> -2 Multiplicao: ca mysql> SELECT 3*5; -> 15 mysql> SELECT 18014398509481984*18014398509481984.0; -> 324518553658426726783156020576256.0 mysql> SELECT 18014398509481984*18014398509481984; -> 0 O resultado da ultima expresso incorreta porque o resultado da multiplicao a e ca de inteiros excede a faixa de 64-bits dos clculos BIGINT. a Diviso: a mysql> SELECT 3/5; -> 0.60 Divises por zero produz um resultado NULL: o

Cap tulo 6: Referncia de Linguagem do MySQL e

523

mysql> SELECT 102/(1-1); -> NULL Uma diviso ser calculada com aritimtica BIGINT somente se executada em a a e um contexto no qual o resultado convertido para um interiro! e

6.3.3.2 Funoes Matematicas c

Todas as funes matematicas retornam NULL no caso de um erro. co Menos unario. Muda o sinal do argumento: mysql> SELECT - 2; -> -2 Note que se este operador utilizando com um BIGINT, o valor retornado um e e BIGINT! Isto signica que voc deve evitar usar - em inteiros que pode ter o e valor de -2^63! ABS(X) Retorna o valor absoluto de X: mysql> SELECT ABS(2); -> 2 mysql> SELECT ABS(-32); -> 32 O uso desta funo seguro com valores BIGINT. ca e SIGN(X) Retorna o sinal do argumento como -1, 0, ou 1, dependendo de quando X e negativo, zero, ou positivo: mysql> SELECT SIGN(-32); -> -1 mysql> SELECT SIGN(0); -> 0 mysql> SELECT SIGN(234); -> 1 MOD(N,M) % Modulo (como o operador % em C). Retorna o resto de N dividido por M: mysql> SELECT -> 4 mysql> SELECT -> 1 mysql> SELECT -> 2 mysql> SELECT -> 2 MOD(234, 10); 253 % 7; MOD(29,9); 29 MOD 9;

O uso desta funo seguro com valores BIGINT. O ultimo exemplo s funciona ca e o no MySQL 4.1 FLOOR(X) Retorna o maior valor inteiro no maior que X: a

524

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT FLOOR(1.23); -> 1 mysql> SELECT FLOOR(-1.23); -> -2 Note que o valor retornado convertido para um BIGINT! e CEILING(X) CEIL(X) Retorna o menor valor inteiro no menor que X: a mysql> SELECT CEILING(1.23); -> 2 mysql> SELECT CEIL(-1.23); -> -1 O alias CEIL() foi adicionado verso 4.0.6. a Note que o valor retornado convertido para um BIGINT! e ROUND(X) ROUND(X,D) Retorna o argumeto X, arredondado para o inteiro mais prximo. Com dois o argumentos o arredandamento feito para um nmero com D decimais. e u mysql> SELECT ROUND(-1.23); -> -1 mysql> SELECT ROUND(-1.58); -> -2 mysql> SELECT ROUND(1.58); -> 2 mysql> SELECT ROUND(1.298, 1); -> 1.3 mysql> SELECT ROUND(1.298, 0); -> 1 mysql> SELECT ROUND(23.298, -1); -> 20 Note que o comportamento de ROUND() quando o argumento est no meio do a caminho entre dois inteiros depende da implementao da biblioteca C. Alguns ca arredondamentos para o nmero mais prximo, so sempre para baixo, para u o a cima ou so zero. Se voc precisa de um tipo de arredondamento, voc deve a e e usar uma funo bem denida como TRUNCATE() ou FLOOR(). ca DIV Diviso de inteiros. Similar ao FLOOR() mas seguro com valores BIGINT. a mysql> SELECT 5 DIV 2 -> 2 DIV novo no MySQL 4.1.0. e Retorna o valor de e (the base of natural logarithms) raised to the power of X: mysql> SELECT EXP(2); -> 7.389056 mysql> SELECT EXP(-2); -> 0.135335

EXP(X)

Cap tulo 6: Referncia de Linguagem do MySQL e

525

LN(X)

Retorna o logaritmo natural de X: mysql> SELECT LN(2); -> 0.693147 mysql> SELECT LN(-2); -> NULL Esta funo foi adicionada na verso 4.0.3 do MySQL. E sinnimo de LOG(X) ca a o no MySQL. Se chamado com um parmetro, esta funo retorna o logar a ca itmo natural de X: mysql> SELECT LOG(2); -> 0.693147 mysql> SELECT LOG(-2); -> NULL Se chamado com dois parmetros, esta funo retorna o logar a ca itmo natural de X para uma base arbitraria B: mysql> SELECT LOG(2,65536); -> 16.000000 mysql> SELECT LOG(1,100); -> NULL A opo de base arbitrria foi adicionada na verso 4.0.3 do MySQL. LOG(B,X) ca a a equivalente a LOG(X)/LOG(B). e Returna o logar itmo na base 2 de X: mysql> SELECT LOG2(65536); -> 16.000000 mysql> SELECT LOG2(-100); -> NULL LOG2() util para descobrir quantos bits um nmero necessitaria para ser e u armazenado. Esta funo foi adicionada na verso 4.0.3 do MySQL. Em verses ca a o anteriores, voc pode usar LOG(X)/LOG(2). e Returna o logar itmo na base 10 de X: mysql> SELECT LOG10(2); -> 0.301030 mysql> SELECT LOG10(100); -> 2.000000 mysql> SELECT LOG10(-100); -> NULL

LOG(X) LOG(B,X)

LOG2(X)

LOG10(X)

POW(X,Y) POWER(X,Y) Retorna o valor de X elevado a potncia de Y: e mysql> SELECT POW(2,2); -> 4.000000 mysql> SELECT POW(2,-2); -> 0.250000

526

MySQL Technical Reference for Version 5.0.0-alpha

SQRT(X)

Retorna o a raiz quadrada no negativa de X: a mysql> SELECT SQRT(4); -> 2.000000 mysql> SELECT SQRT(20); -> 4.472136

PI()

Retorna o valor de PI. A quantidade de nmeros decimais padro 5, mas o u a e MySQL usa internamente a preciso dupla completa para PI. a mysql> SELECT PI(); -> 3.141593 mysql> SELECT PI()+0.000000000000000000; -> 3.141592653589793116

COS(X)

Retorna o cosseno de X, onde X dado em radianos: e mysql> SELECT COS(PI()); -> -1.000000

SIN(X)

Retorna o seno de X, onde X dado em radianos: e mysql> SELECT SIN(PI()); -> 0.000000

TAN(X)

Retorna a tangente de X, onde X dado em radianos: e mysql> SELECT TAN(PI()+1); -> 1.557408

ACOS(X)

Retorna o arco cosseno X, isto , o valor cujo cosseno X. Retorna NULL se X e e no est na faixa de -1 a 1: a a mysql> SELECT ACOS(1); -> 0.000000 mysql> SELECT ACOS(1.0001); -> NULL mysql> SELECT ACOS(0); -> 1.570796

ASIN(X)

Retorna o arco seno X, isto , o valor cujo seno X. Retorna NULL se X no est e e a a na faixa de -1 a 1: mysql> SELECT ASIN(0.2); -> 0.201358 mysql> SELECT ASIN(foo); -> 0.000000

ATAN(X)

Retorna o arco tangente X, isto , o valor cuja tangente X. X: e e mysql> SELECT ATAN(2); -> 1.107149 mysql> SELECT ATAN(-2); -> -1.107149

Cap tulo 6: Referncia de Linguagem do MySQL e

527

ATAN(Y,X) ATAN2(Y,X)

Retorna o arco tangente de duas variaveis X e Y. E similar ao caclculo do arco tengente de Y / X, exceto que os sinais de ambos argumentos so usados para a determinas o quadrante do resultado: mysql> SELECT ATAN(-2,2); -> -0.785398 mysql> SELECT ATAN2(PI(),0); -> 1.570796

COT(X)

Returns a cotangente de X: mysql> SELECT COT(12); -> -1.57267341 mysql> SELECT COT(0); -> NULL

CRC32(expr) Calcula um valor de vericao de redundncia c ca a iclica e retorna um valor unsigned de 32 bits. O resultado NULL se o argumento NULL. O argumento e e esperado uma string e ser tratado como tal se no for. e a a mysql> SELECT CRC32(MySQL); -> 3259397556 CRC32() est dispon a partir do MySQL 4.1.0. a ivel RAND() RAND(N) Retorna um valor de ponto utuante aleatrio na faixa de 0 a 1.0. Se um o argumento inteiro N especicado, ele usado como uma semente (produzindo e e uma sequncia repetitiva): e mysql> SELECT RAND(); -> 0.9233482386203 mysql> SELECT RAND(20); -> 0.15888261251047 mysql> SELECT RAND(20); -> 0.15888261251047 mysql> SELECT RAND(); -> 0.63553050033332 mysql> SELECT RAND(); -> 0.70100469486881 Voc no pode usar uma coluna com valores RAND() em uma clusula ORDER e a a BY, pois ORDER BY avaliaria a coluna mltiplas vezes. Na verso 3.23 voc pode u a e fazer: SELECT * FROM nome_tabela ORDER BY RAND() Isto util para obter um amostra aleatria de um conjunto SELECT * FROM e o tabela1,tabela2 WHERE a=b AND c<d ORDER BY RAND() LIMIT 1000. Note que um RAND() em uma clusula WHERE ser reavliado toda vez que WHERE a a executado. e

528

MySQL Technical Reference for Version 5.0.0-alpha

RAND() no um gerador de nmeros aletatrios perfeito, mas um modo a e u o e rpido de se gerar nmeros aleatrios ad hoc que sero portveis entre platafora u o a a mas para a mesma verso do MySQL. a LEAST(X,Y,...) Com dois ou mais argumentos, retorna o menor (valor-m inimo) argumento. Os argumentos so comparados usando as seguintes regras: a Se o valor de retorno usado em um contexto INTEGER, ou todos argumene tos so valores inteiro, eles so comparados como inteiros. a a Se o valor de retorno usado em um contexto REAL, ou todos argumentos e so valores reais, eles so comparados como inteiros. a a Se qualquer um dos argumento for uma string caso-sensitivo, os argumentos so comparados como strings caso-sensitivo. a Nos outros casos, caso-insensitivo: os argumentos so comparados como strings a

mysql> SELECT LEAST(2,0); -> 0 mysql> SELECT LEAST(34.0,3.0,5.0,767.0); -> 3.0 mysql> SELECT LEAST("B","A","C"); -> "A" Em verses do MySQL anteriores a verso 3.22.5, voc pode usar MIN() no o a e lugar de LEAST. GREATEST(X,Y,...) Retorna o maior (valor mximo) argumento. Os argumentos so comparados a a usando as mesmas regras do LEAST: mysql> SELECT GREATEST(2,0); -> 2 mysql> SELECT GREATEST(34.0,3.0,5.0,767.0); -> 767.0 mysql> SELECT GREATEST("B","A","C"); -> "C" Em verses do MySQL anteriores a verso 3.22.5, voc pode usar MAX() no o a e lugar de GRATEST. DEGREES(X) Retorna o argumento X, convertido de radianos para graus: mysql> SELECT DEGREES(PI()); -> 180.000000 RADIANS(X) Retorna o argumento X, convertido de graus para radianos: mysql> SELECT RADIANS(90); -> 1.570796

Cap tulo 6: Referncia de Linguagem do MySQL e

529

TRUNCATE(X,D) Retiorna o nmero X, truncado para D casas decimais. Se D 0, o resultado no u e a ter ponto deciaml ou prate fracionria: a a mysql> SELECT TRUNCATE(1.223,1); -> 1.2 mysql> SELECT TRUNCATE(1.999,1); -> 1.9 mysql> SELECT TRUNCATE(1.999,0); -> 1 mysql> SELECT TRUNCATE(-1.999,1); -> -1.9 A partir do MySQL 3.23.51 todos o nmeros so arredondados para zero. u a Se D negativo, ento D numeros da parte inteira so zerados: e a a mysql> SELECT TRUNCATE(122,-2); -> 100 Note que como os nmeros decimais no so normalmente armazenados como u a a nmeros exatos, mas como valores de dupla preciso, voc pode obter o seguinte u a e resultado: mysql> SELECT TRUNCATE(10.28*100,0); -> 1027 O resultado acima acontece porque 10.28 , na verdade, armazenado como e 10.2799999999999999.

6.3.4 Funoes de Data e Hora c

Esta seo descreve as funes que podem ser usadas para manipular valores temporais. ca co Veja Seo 6.2.2 [Tipos de data e hora], Pgina 489 para uma descrio da faixa de valca a ca ores que cada tipo tem e os formatos vlidos nos quais valores de data e hora podes ser a especicados. Aqui est um exemplo que usa funes de data. A consulta seguinte seleciona todos os a co registros com um valores em uma coluna col_data dentro dos ultimos 30 dias: mysql> SELECT algo FROM nome_tabela WHERE TO_DAYS(NOW()) - TO_DAYS(col_data) <= 30; (Note que a consulta tambm selecionar registros com datas futuras.) e a Funes que esperam valores de data normaemente aceitaram valores datetime e ignoram a co parte da hora. Funes que esperam valores de hora normalmente aceitaro valores datetime co a e ignoram a parte da data. Funes que retornam a data ou hora atual so avaliadas apenas uma vez por consulta, no co a inicio da sua execuo. Isto signica que vrias referncias a uma funo com NOW() dentro ca a e ca de uma mesma consulta sempre produzir o memo resultado. Este princ a ipio tambm se e aplica a CURDATE(), CURTIME(), UTC_DATE(), UTC_TIME(), UTC_TIMESTAMP(), e qualquer um dos seus sinnimos. o A faixa do valor retornado na seguinte descrio da funo se aplica a datas completas. Se ca ca uma data um valor zero ou uma data incompleta tal como 2001-11-00, funes que e co

530

MySQL Technical Reference for Version 5.0.0-alpha

extraem parte de uma data podem retornam 0. Por exemplo, DAYOFMONTH(2001-11-00) retorna 0. DATE(expr) Extrai a parte da data da expresso date ou datetime em expr. a mysql> SELECT DATE(2003-12-31 01:02:03); -> 2003-12-31 DATE() est dispon a partir do MySQL 4.1.1. a ivel TIME(expr) Extrai a parte da hora da expresso time ou datetime em expr. a mysql> SELECT TIME(2003-12-31 01:02:03); -> 01:02:03 mysql> SELECT TIME(2003-12-31 01:02:03.000123); -> 01:02:03.000123 TIME() est dispon a partir do MySQL 4.1.1. a ivel TIMESTAMP(expr) TIMESTAMP(expr,expr2) Com um argumento, retorna a expresso date ou datetime em expr como um a valor datetime. Com dois argumentos, adiciona a expresso time e expr2 ` a a expresso date ou datetime em expr e retorna um valor datetime. a mysql> SELECT TIMESTAMP(2003-12-31); -> 2003-12-31 00:00:00 mysql> SELECT TIMESTAMP(2003-12-31 12:00:00,12:00:00); -> 2004-01-01 00:00:00 TIMESTAMP() est dispon a partir do MySQL 4.1.1. a ivel DAYOFWEEK(data) Retorna o indice do dia da semana para data (1 = Domingo, 2 = Segunda, ... 7 = Sbado). Estes valores de a indices correspondem ao padro ODBC. a mysql> SELECT DAYOFWEEK(1998-02-03); -> 3 WEEKDAY(data) Retorna o indice do dia das semana para data (0 = Segunda, 1 = Tera, ... 6 c = Domingo): mysql> SELECT WEEKDAY(1998-02-03 22:23:00); -> 1 mysql> SELECT WEEKDAY(1997-11-05); -> 2 DAYOFMONTH(data) Retorna o dia do ms para data, na faixa de 1 at 31: e e mysql> SELECT DAYOFMONTH(1998-02-03); -> 3 DAY(date) DAY() um sinnimo para DAYOFMONTH(). Est dispon a partir do MySQL e o a ivel 4.1.1.

Cap tulo 6: Referncia de Linguagem do MySQL e

531

DAYOFYEAR(data) Retorna o dia do ano para data, na faixa de 1 at 366: e mysql> SELECT DAYOFYEAR(1998-02-03); -> 34 MONTH(data) Retorna o ms para data, na faixa de 1 at 12: e e mysql> SELECT MONTH(1998-02-03); -> 2 DAYNAME(data) Retorna o nome do dia da semana para data: mysql> SELECT DAYNAME(1998-02-05); -> Thurday MONTHNAME(data) Retorna o nome do ms para data: e mysql> SELECT MONTHNAME(1998-02-05); -> February QUARTER(data) Retorna o trimaster para data, na faixa de 1 at 4: e mysql> SELECT QUARTER(98-04-01); -> 2 WEEK(data [,modo]) A funo retorna o nmero da semana para date. A forma de dois argumentos ca u de WEEK() permite que voc especique se a semana comea no Domingo ou na e c Segunda e se o valor de retorno deve estar na faixa de 0-53 ou 1-5. Quando o argumento modo omitido, o valor de uma varivel de servidor default_week_ e a format (ou 0 no MySQL 4.0 e mais novo) assumido. Veja Seo 5.5.6 [SET e ca OPTION], Pgina 460. a A seguinte tabela demonstra como o argumento modo funciona: Valor Signicado 0 Semana comea no Domingo; retorna o valor na faixa de 0 a 53; semana c 1 a primeira semana neste ano. e 1 Semana comea na Segunda; retorna o valor na faixa de 0 a 53; semana c 1 a primeira semana com mais de 3 dias neste ano e 2 Semana comea no Domingo; retorna o valor na faixa de 1 a 53; semana c 1 a primeira semana neste ano. e 3 Semana comea na Segunda; retorna o valor na faixa de 1 a 53; semana c 1 a primeira semana com mais de 3 dias neste ano. e 4 Semana comea no Domingo; retorna o valor na faixa de 0 a 53; semana c 1 a primeira semana com mais de 3 dias neste ano. e 5 Semana comea na Segunda; retorna o valor na faixa de 0 a 53; semana c 1 a primeira semana neste ano. e 6 Semana comea no Domingo; retorna o valor na faixa de 0 a 53; semana c 1 a primeira semana que tenha mais de 3 dias neste ano. e 7 Semana comea na Segunda; retorna o valor na faixa de 1 a 53; semana c 1 a primeira semana neste ano. e

532

MySQL Technical Reference for Version 5.0.0-alpha

O valor mode de 3 pode ser usado a partir do MySQL 4.0.5. O valor mode de 4 e acima pode ser usado a partir do MySQL 4.0.17. mysql> SELECT -> 7 mysql> SELECT -> 7 mysql> SELECT -> 8 mysql> SELECT -> 53 WEEK(1998-02-20); WEEK(1998-02-20,0); WEEK(1998-02-20,1); WEEK(1998-12-31,1);

Nota: Na verso 4.0, WEEK(#,0) foi alterado para corresponder ao calendrio a a americano. Antes WEEK() era calculada de forma errada para data no EUA. (Na verdade WEEK(#) e WEEK(#,0) era errado para todos os casos). Note que se a data for a ultima semana do ano anterior, o MySQL retornar 0 a se voc no usar 2, 3, 6 ou 7 como argumento opcional modo: e a mysql> SELECT YEAR(2000-01-01), WEEK(2000-01-01,0); -> 2000, 0 Pode-se questionar que o MySQL deveria retornar 52 para a funo WEEK() ja ca que a data dada ocorre, na verdade, ma 52a. semana de 1999. Ns decidimos o retornar 0 j que queremos que funao retorne o nmero da semana do ano a c u dado. Isto faz com que o uso da funao WEEK() seja seguro quando combinado c com outras funes que extraiam um parte de uma data. co Se voc prefere que o resultado seja avaliado em relaco ao ano que aontm o e a e primeiro dia da semana de uma data dada, ento voc deve usar o 2, 3, 6 ou 7 a e como argumento opcional modo: mysql> SELECT WEEK(2000-01-01,2); -> 52 Alternativamente voc pode usar a funo YEARWEEK(): e ca mysql> SELECT YEARWEEK(2000-01-01); -> 199952 mysql> SELECT MID(YEARWEEK(2000-01-01),5,2); -> 52 WEEKOFYEAR(data) Retorna a semana da data como um nmero na faixa de 1 a 53. u mysql> SELECT WEEKOFYEAR(1998-02-20); -> 8 WEEKOFYEAR() esta dispon a partir do MySQL 4.1.1. ivel YEAR(data) Retorna o ano para data na faixa de 1000 a 9999: mysql> SELECT YEAR(98-02-03); -> 1998

Cap tulo 6: Referncia de Linguagem do MySQL e

533

YEARWEEK(data) YEARWEEK(data,inicio) Retorna o ano e a semana para a data. O argumento inicio funciona exatamente como o argumento inicio de WEEK(). Note que o ano pode ser diferente do ano no argumento data para a primeira e a ultima semana do ano: mysql> SELECT YEARWEEK(1987-01-01); -> 198653 Note que o nmero da semana diferente do que seria retornado pela funo u e ca WEEK() (0) para os argumentos opcionais 0 ou 1, j que WEEK() retorna a a semana no centexto de um ano dado. HOUR(hora) Retorna a hora para hora. A faixa do valor retornado ser de 0 a 23 para o a valor hora do dia. mysql> SELECT HOUR(10:05:03); -> 10 No entanto, a faixa dos valores TIME atualmente so muito grandes, assim HOUR a pode retornar valores maior que 23: mysql> SELECT HOUR(272:59:59); -> 272 MINUTE(hora) Retorna o minuto para hora, na faixa de 0 a 59: mysql> SELECT MINUTE(98-02-03 10:05:03); -> 5 SECOND(hora) Retorna o segundo para hora, na faixa de 0 a 59: mysql> SELECT SECOND(10:05:03); -> 3 MICROSECOND(expr) Retorna os microsegundos da expresso time ou datetime em expr como um a nmero na faixa de 0 a 999999. u mysql> SELECT MICROSECOND(12:00:00.123456); -> 123456 mysql> SELECT MICROSECOND(1997-12-31 23:59:59.000010); -> 10 MICROSECOND() est dispon a partir do MySQL 4.1.1. a ivel PERIOD_ADD(P,N) Adiciona N meses ao per iodo P (no formato AAMM ou AAAAMM). Retorna um valor no formato AAAAMM. Note que o argumento de per iodo P no um valor de data: a e mysql> SELECT PERIOD_ADD(9801,2); -> 199803

534

MySQL Technical Reference for Version 5.0.0-alpha

PERIOD_DIFF(P1,P2) Retorna o nmero de meses entre os per u iodos P1 e P2. P1 e P2 devem estar no formato AAMM ou AAAAMM. Note que os argumentos de per iodo P1 e P2 no so valores de data: a a mysql> SELECT PERIOD_DIFF(9802,199703); -> 11 DATE_ADD(data,INTERVAL tipo expr) DATE_SUB(data,INTERVAL tipo expr) Estas funes realizam operaes aritmticas em datas. co co e A partir do MySQL 3.23, INTERVAL expr tipo permitido nos dois lados do e operador + se a expressao em ambos os lados um valor date ou datetime. e Para o operador -, INTERVAL expr tipoe permitido apenas no lado direito, e porque no faz sentido subtrair um valor date ou datetime de um intervalo. a (Veja exemplo abaixo.) data um valor DATETIME ou DATE especicando a data de in e icio. expr is an expresso especicando o intervala a ser adicionado ou subtraido da data de a in icio. expr uma string; ela pode iniciar com um - para intervalos negativos. e type uma palavra chave indicando como a expresso deve ser interpretada. e a A seguinte tabela mostra como os argumentos tipo e expr se relacionam: tipo do valor SECOND MINUTE HOUR DAY MONTH YEAR MINUTE_SECOND HOUR_MINUTE DAY_HOUR YEAR_MONTH HOUR_SECOND DAY_MINUTE DAY_SECOND DAY_MICROSECOND HOUR_MICROSECOND MINUTE_MICROSECOND SECOND_MICROSECOND MICROSECOND Formarto esperado da expr SECONDS MINUTES HOURS DAYS MONTHS YEARS MINUTES:SECONDS HOURS:MINUTES DAYS HOURS YEARS-MONTHS HOURS:MINUTES:SECONDS DAYS HOURS:MINUTES DAYS HOURS:MINUTES:SECONDS DAYS.MICROSECONDS HOURS.MICROSECONDS MINUTES.MICROSECONDS SECONDS.MICROSECONDS MICROSECONDS

Os valores do tipo DAY_MICROSECOND, HOUR_MICROSECOND, MINUTE_ MICROSECOND, SECOND_MICROSECOND e MICROSECOND so permitidos aps o a o MySQL 4.1.1. O MySQL permite qualquer delimitador de pontuao no formato de expr. Os ca delimitadores mostrados na tabela so apenas sugeridos. Se o argumento date a um valor de DATA e seus clculos envolvem apenas as partes ANO, M^S, e DIA e a E

Cap tulo 6: Referncia de Linguagem do MySQL e

535

(into , nenhuma parte de hora), o resultado um valor do tipo DATE. Seno, e e a o resultado um valor do tipo DATETIME: e mysql> SELECT 1997-12-31 23:59:59 + INTERVAL 1 SECOND; -> 1998-01-01 00:00:00 mysql> SELECT INTERVAL 1 DAY + 1997-12-31; -> 1998-01-01 mysql> SELECT 1998-01-01 - INTERVAL 1 SECOND; -> 1997-12-31 23:59:59 mysql> SELECT DATE_ADD(1997-12-31 23:59:59, -> INTERVAL 1 SECOND); -> 1998-01-01 00:00:00 mysql> SELECT DATE_ADD(1997-12-31 23:59:59, -> INTERVAL 1 DAY); -> 1998-01-01 23:59:59 mysql> SELECT DATE_ADD(1997-12-31 23:59:59, -> INTERVAL 1:1 MINUTE_SECOND); -> 1998-01-01 00:01:00 mysql> SELECT DATE_SUB(1998-01-01 00:00:00, -> INTERVAL 1 1:1:1 DAY_SECOND); -> 1997-12-30 22:58:59 mysql> SELECT DATE_ADD(1998-01-01 00:00:00, -> INTERVAL -1 10 DAY_HOUR); -> 1997-12-30 14:00:00 mysql> SELECT DATE_SUB(1998-01-02, INTERVAL 31 DAY); -> 1997-12-02 mysql> SELECT DATE_ADD(1992-12-31 23:59:59.000002, -> INTERVAL 1.999999 SECOND_MICROSECOND); -> 1993-01-01 00:00:01.000001 Se voc especicado um intervalo muito curto (no inclue todas as partes que e a seriam esperadas pelo intervalo para aquele tipo), MySQL assume que voc e no especicou a parte mais a esquerda do valor do intervalo. Por exemplo, se a voc especica um tipo DAY_SECOND, o valor esperado de expr dever ter as e a partes de dias, horas, minutos e segundos. Se voc especica um valor como e 1:10, MySQL assume que as partes do dia e da hora foram esquecidas e o valor representa minutos e segundos. Em outras palavras, 1:10 DAY_SECOND interpretado de forma equivalente a 1:10 MINUTE_SECOND. Isto anlogo a e e a forma que o MySQL interpreta valores TIME representado tempo decorrido no lugar de hora do dia. Note que se voc adicionar ou subtrair de uma data algo contendo uma parte e de hora, o resultado automaticamente convertido para um valor datetime: e mysql> SELECT DATE_ADD(1999-01-01, INTERVAL 1 DAY); -> 1999-01-02 mysql> SELECT DATE_ADD(1999-01-01, INTERVAL 1 HOUR); -> 1999-01-01 01:00:00

536

MySQL Technical Reference for Version 5.0.0-alpha

Se voc utilizar datas mal formadas, o valor retornado NULL. S voc adicionar e e e MONTH, YEAR_MONTH, ou YEAR e a data resultante tiver um dia maior que o dia mximo para aquele ms, o dia ajustado para o dia mximo no ms. a e e a e mysql> SELECT DATE_ADD(1998-01-30, interval 1 month); -> 1998-02-28 Note pelo exemplo anterior que a palavra-chave INTERVAL e o especicador tipo no so caso sensitivo. a a ADDDATE(data,INTERVAL expr type) ADDDATE(expr,dias) Quando chamada com a forma INTERVAL do segundo argumento, ADDDATE() e um sinnimo para DATE_ADD(). A funo relcionada SUBDATE() um sinnimo o ca e o para DATE_SUB(). mysql> SELECT DATE_ADD(1998-01-02, INTERVAL 31 DAY); -> 1998-02-02 mysql> SELECT ADDDATE(1998-01-02, INTERVAL 31 DAY); -> 1998-02-02 A partir do MySQL 4.1.1, a segunda sintaxe permitida, onde expr uma e e expreso date ou datetime e dias o nmero de dias a ser adicionado a expr. a e u mysql> SELECT ADDDATE(1998-01-02, 31); -> 1998-02-02 ADDTIME(expr,expr2) ADDTIME() adiciona expr2 a expr e retorna o resultado. expr uma expresso e a date ou datetime, e expr2 uma expresso time. e a mysql> SELECT ADDTIME("1997-12-31 23:59:59.999999", "1 1:1:1.000002"); -> 1998-01-02 01:01:01.000001 mysql> SELECT ADDTIME("01:00:00.999999", "02:00:00.999998"); -> 03:00:01.999997 ADDTIME() foi adicionado no MySQL 4.1.1. EXTRACT(tipo FROM data) A funo EXTRACT() usa o mesmo tipo de intervalo especicado como DATE_ ca ADD() ou DATE_SUB(), mas extrai partes da da data em vez de realizar aritimtica de data. e mysql> SELECT EXTRACT(YEAR FROM "1999-07-02"); -> 1999 mysql> SELECT EXTRACT(YEAR_MONTH FROM "1999-07-02 01:02:03"); -> 199907 mysql> SELECT EXTRACT(DAY_MINUTE FROM "1999-07-02 01:02:03"); -> 20102 mysql> SELECT EXTRACT(MICROSECOND FROM "2003-01-02 10:30:00.00123"); -> 123

Cap tulo 6: Referncia de Linguagem do MySQL e

537

DATEDIFF(expr,expr2) TIMEDIFF(expr,expr2) DATEDIFF() retorna o nmero de dias entre a data inicial expr e a data nal u expr2. expr e expr2 so expresses de datas ou data e hora. Apenas a parte a o da data dos valores s usados no clculo. a a TIMEDIFF() retorna o tempo entre a hora inicial expr e a hora nal expr2. expr e expr2 so expresses de hora ou data e hora, mas ambas devem ser do a o mesmo tipo. mysql> SELECT DATEDIFF(1997-12-31 -> 1 mysql> SELECT DATEDIFF(1997-11-31 -> -30 mysql> SELECT TIMEDIFF(2000:01:01 -> -00:00:00.000001 mysql> SELECT TIMEDIFF(1997-12-31 -> 46:58:57.999999 23:59:59,1997-12-30); 23:59:59,1997-12-31);

00:00:00, 2000:01:01 00:00:00.000001

23:59:59.000001,1997-12-30 01:01:01.0

DATEDIFF() e TIMEDIFF() foram adicionados no MySQL 4.1.1. TO_DAYS(data) Dada uma data data, retorna o nmero do dia (o nmero de dias desde o ano u u 0); mysql> SELECT TO_DAYS(950501); -> 728779 mysql> SELECT TO_DAYS(1997-10-07); -> 729669 TO_DAYS() no pode ser usado com valores que orecedem o advento do calena dario Gregoriano (1582), porque ele no leva em conta os dias perdidos quando a o calendrio foi mudado. a FROM_DAYS(N) Dado um nmero de dia N, retorna um valor DATE: u mysql> SELECT FROM_DAYS(729669); -> 1997-10-07 FROM_DAYS() no pode ser usado com valores que orecedem o advento do calena dario Gregoriano (1582), porque ele no leva em conta os dias perdidos quando a o calendrio foi mudado. a DATE_FORMAT(data,formato) Formata o valor de data de acordo com a string formato string. Os seguintes identicadores podem ser utilizados na string formato: Specier %M %W %D %Y %y Description Nome do ms (January..December) e Nome da semana (Sunday..Saturday) Dia do ms com suxo Ingls (0th, 1st, 2nd, 3rd, etc.) e e Ano, numerico, 4 digitos Ano, numerico, 2 digitos

538

MySQL Technical Reference for Version 5.0.0-alpha

Ano para a semana onde o Domingo o primeiro dia da e semana, numerico, 4 digitos; usado com %V %x Ano para a semana onde a segunda o primeiro dia da e semana, numerico, 4 digitos; usado com %v %a Nome da semana abreviado (Sun..Sat) %d Dia do ms, numerico (00..31) e %e Dia do ms, numerico (0..31) e %m Ms, numerico (00..12) e %c Ms, numerico (0..12) e %b Nome do ms abreviado (Jan..Dec) e %j Dia do ano (001..366) %H Hora (00..23) %k Hora (0..23) %h Hora (01..12) %I Hora (01..12) %l Hora (1..12) %i Minutos, numerico (00..59) %r Tempo, 12-horas (hh:mm:ss seguido por AM ou PM) %T Tempo, 24-horas (hh:mm:ss) %S Segundos (00..59) %s Segundos (00..59) %f Microsegundos (000000..999999) %p AM ou PM %w Dia da semana (0=Domingo..6=Sabado) %U Semana(00..53), onde o Domingo o primeiro dia da e semana. %u Semana(00..53), onde a Segunda o primeiro dia da e semana. %V Semana(01..53), onde o Domingo o primeiro dia da see mana; usado com %X %v Semana(01..53), onde a Segunda o primeiro dia da see mana; usado com %x %% Um literal %. Todos os outros caracteres so apenas copiados para o resultado, sem intera pretao. ca O especicador dr formato %f est dispon a partir do MySQL 4.1.1. a ivel Como na verso 3.23 do MySQL, o caracter % exigido antes dos caracteres a e de especicao de formato. Em verses anteriores do MySQL % era opcional. ca o A razo para a faixa de valores do ms e do dia comearem com zero a e c e que o MySQL permite datas incompletas tais como 2004-00-00 serem armazenadas no MySQL 3.23. mysql> SELECT DATE_FORMAT(1997-10-04 22:23:00, %W %M %Y); -> Saturday October 1997 mysql> SELECT DATE_FORMAT(1997-10-04 22:23:00, %H:%i:%s); -> 22:23:00 mysql> SELECT DATE_FORMAT(1997-10-04 22:23:00, %D %y %a %d %m %b %j);

%X

Cap tulo 6: Referncia de Linguagem do MySQL e

539

-> 4th 97 Sat 04 10 Oct 277 mysql> SELECT DATE_FORMAT(1997-10-04 22:23:00, %H %k %I %r %T %S %w); -> 22 22 10 10:23:00 PM 22:23:00 00 6 mysql> SELECT DATE_FORMAT(1999-01-01, %X %V); -> 1998 52 STR_TO_DATE(str,format) Esta a funo reversa da funo DATE_FORMAT(). Ela pega uma string str, e e ca ca um formato format, e retorna uma valor DATETIME. Os valores date, time, ou datetime contidos em str devem ser dados no formato indicado por format. Para o especicadores que podem ser usados em format, veja a tabela na descrio da funo DATE_FORMAT(). Todos os outros caracteres sero apenas ca ca a exibidos, no sendo interpretados. Se str contm um valor date, time, ou a e datetime ilegal, STR_TO_DATE() retorna NULL. mysql> SELECT STR_TO_DATE(03.10.2003 09.20, %d.%m.%Y %H.%i) -> 2003-10-03 09:20:00 mysql> SELECT STR_TO_DATE(10rap, %crap) -> 0000-10-00 00:00:00 mysql> SELECT STR_TO_DATE(2003-15-10 00:00:00, %Y-%m-%d %H:%i:%s) -> NULL STR_TO_DATE() est dispon a partir do MySQL 4.1.1. a ivel GET_FORMAT(DATE | TIME | TIMESTAMP, EUR | USA | JIS | ISO | INTERNAL) Retorna uma string de formato. Esta funo util combinado com as funes ca e co DATE_FORMAT() e STR_TO_DATE(), e quando congurarmos as variveis do servia dor DATE_FORMAT, TIME_FORMAT e DATETIME_FORMAT. Os trs valores poss e iveis para o primeiro argumento e os cinco valores possiveis para o segundo argumento resultam em 15 strings de formato poss iveis (para o especicador usado, veja a tabela na descrio da funo DATE_FORMAT()): ca ca Chamada da Funo ca GET_FORMAT(DATE,USA) GET_FORMAT(DATE,JIS) GET_FORMAT(DATE,ISO) GET_FORMAT(DATE,EUR) GET_FORMAT(DATE,INTERNAL) GET_FORMAT(TIMESTAMP,USA) GET_FORMAT(TIMESTAMP,JIS) GET_FORMAT(TIMESTAMP,ISO) GET_FORMAT(TIMESTAMP,EUR) GET_FORMAT(TIMESTAMP,INTERNAL) GET_FORMAT(TIME,USA) GET_FORMAT(TIME,JIS) GET_FORMAT(TIME,ISO) GET_FORMAT(TIME,EUR) GET_FORMAT(TIME,INTERNAL) Resultado %m.%d.%Y %Y-%m-%d %Y-%m-%d %d.%m.%Y %Y%m%d %Y-%m-%d-%H.%i.%s %Y-%m-%d %H:%i:%s %Y-%m-%d %H:%i:%s %Y-%m-%d-%H.%i.%s %Y%m%d%H%i%s %h:%i:%s %p %H:%i:%s %H:%i:%s %H.%i.%S %H%i%s

Formato ISO do ISO ISO 9075, no do ISO 8601. e a

540

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT DATE_FORMAT(2003-10-03, GET_FORMAT(DATE, EUR) -> 03.10.2003 mysql> SELECT STR_TO_DATE(10.31.2003, GET_FORMAT(DATE, USA)) -> 2003-10-31 mysql> SET DATE_FORMAT=GET_FORMAT(DATE, USA); SELECT 2003-10-31; -> 10-31-2003 GET_FORMAT() est dispon a partir do MySQL 4.1.1. Veja Veja Seo 5.5.6 a ivel ca [SET OPTION], Pgina 460. a SUBDATE(date,INTERVAL expr type) SUBDATE(expr,days) Quando chamado com a forma INTERVAL do segunto argumento, SUBDATE() e um sinonimo para DATE_SUB(). mysql> SELECT DATE_SUB(1998-01-02, INTERVAL 31 DAY); -> 1997-12-02 mysql> SELECT SUBDATE(1998-01-02, INTERVAL 31 DAY); -> 1997-12-02 A partir do MySQL 4.1.1, a segunda sintaxe permitida, onde expr uma e e expresso date ou datetime e days o nmero de dias a ser subtra de expr. a e u ido mysql> SELECT SUBDATE(1998-01-02 12:00:00, 31); -> 1997-12-02 12:00:00 SUBTIME(expr,expr2) SUBTIME() subtrai expr2 de expr e retorna o resultado. expr uma expresso e a date ou datetime, e expr2 uma expresso time. e a mysql> SELECT SUBTIME("1997-12-31 23:59:59.999999", "1 1:1:1.000002"); -> 1997-12-30 22:58:58.999997 mysql> SELECT SUBTIME("01:00:00.999999", "02:00:00.999998"); -> -00:59:59.999999 SUBTIME() foi adicionado no MySQL 4.1.1. TIME_FORMAT(hora,formato) E usado como a funo DATE_FORMAT() acima, mas a string de formato pode ca conter apenas os especicadores de formato que tratam de horas, minutos e segundos. Outros especicadores produzem um valor NULL ou 0. Se o valor time contm uma hora que maior que 23, os especicadores de e e formato de hora %H e %k produzem um valor maior que a faixa como de 0..23. O outro especicador do formato de hora produz o valor da hora mdulo 12: o mysql> SELECT TIME_FORMAT(100:00:00, %H %k %h %I %l); -> 100 100 04 04 4 LAST_DAY(data) Pega um valor date ou datetime e retorna o valor correspondente para o ultimo dia do ms. Retorna NULL se o argumento invalido. e e mysql> SELECT LAST_DAY(2003-02-05), LAST_DAY(2004-02-05); -> 2003-02-28, 2004-02-29 mysql> SELECT LAST_DAY(2004-01-01 01:01:01);

Cap tulo 6: Referncia de Linguagem do MySQL e

541

-> 2004-01-31 mysql> SELECT LAST_DAY(2003-03-32); -> NULL LAST_DAY() est dispon a partir do MySQL 4.1.1. a ivel MAKEDATE(ano,diadoano) Retorna uma data, dado os valores da ano e dia do ano. diadoano deve ser maior que 0 ou o resultado ser NULL. a mysql> SELECT MAKEDATE(2001,31), MAKEDATE(2001,32); -> 2001-01-31, 2001-02-01 mysql> SELECT MAKEDATE(2001,365), MAKEDATE(2004,365); -> 2001-12-31, 2004-12-30 mysql> SELECT MAKEDATE(2001,0); -> NULL MAKEDATE() est dispon a partir do MySQL 4.1.1. a ivel MAKETIME(hora,minuto,segundo) Retorna um valor time calculado a partir dos argmentos hora, minuto e segundo. mysql> SELECT MAKETIME(12,15,30); -> 12:15:30 MAKETIME() est dispon a partir do MySQL 4.1.1. a ivel CURDATE() CURRENT_DATE CURRENT_DATE() Retorna a data atual como um valor no formato YYYY-MM-DD ou YYYYMMDD, dependendo se a funo usada num contexto numrico ou de string. ca e e mysql> SELECT CURDATE(); -> 1997-12-15 mysql> SELECT CURDATE() + 0; -> 19971215 CURTIME() CURRENT_TIME CURRENT_TIME() Retorna a hora atual como um valor no formato HH:MM:SS ou HHMMSS, dependo se a funo usada em um contexto numrico ou como string: ca e e mysql> SELECT CURTIME(); -> 23:50:26 mysql> SELECT CURTIME() + 0; -> 235026

542

MySQL Technical Reference for Version 5.0.0-alpha

NOW() SYSDATE() CURRENT_TIMESTAMP CURRENT_TIMESTAMP() LOCALTIME LOCALTIME() LOCALTIMESTAMP LOCALTIMESTAMP() Retorna a data e hora atual como um valor no formato YYYY-MM-DD HH:MM:SS ou YYYYMMDDHHMMSS, dependendo se a funo utilizada num contexto numrico ca e e ou de string. mysql> SELECT NOW(); -> 1997-12-15 23:50:26 mysql> SELECT NOW() + 0; -> 19971215235026 UNIX_TIMESTAMP() UNIX_TIMESTAMP(data) Se chamado sem argumento, retorna um tipo timestamp do Unix (segundos desde 1970-01-01 00:00:00 GMT) como um inteiro sem sinal. Se UNIX_ TIMESTAMP() chamada com um argumento data, retornado o valor do argue e mento como segundo desde 1970-01-01 00:00:00 GMT. data pode ser um string DATE, uma string DATETIME, um TIMESTAMP, ou um nmero no formato u YYMMDD ou YYYYMMDD na hora local: mysql> SELECT UNIX_TIMESTAMP(); -> 882226357 mysql> SELECT UNIX_TIMESTAMP(1997-10-04 22:23:00); -> 875996580 Qaundo UNIX_TIMESTAMP usado em uma coluna TIMESTAMP, a funo retorna e ca o valor timestamp interno diretamente, sem nenhuma converso string-paraa unix-timestamp implicita. Se voc passar uma data fora da faixa para UNIX_ e TIMESTAMP(), a funo ir retornar 0, mas por favor note que s vericaes ca a o co bsicas so realizadas. (ano 1970-2037, ms 01-12, dia 01-31). a a e Se voc subtrair colunas UNIX_TIMESTAMP(), voc pode querer mudar o resule e tado para inteiro com sinal. Veja Seo 6.3.5 [Funes de tipagem], Pgina 544. ca co a FROM_UNIXTIME(unix_timestamp) FROM_UNIXTIME(unix_timestamp,format) Retorna a representao do argumento unix_timestamp como um valor no forca mato YYYY-MM-DD HH:MM:SS ou YYYYMMDDHHMMSS, dependendo de do contexto em que a fun utilizada: co e mysql> SELECT FROM_UNIXTIME(875996580); -> 1997-10-04 22:23:00 mysql> SELECT FROM_UNIXTIME(875996580) + 0; -> 19971004222300

Cap tulo 6: Referncia de Linguagem do MySQL e

543

Se o formato dado o resultado formatado de acordo com a string formato. e e formato pode conter os especicadores listados acima para a funo DATE_ ca FORMAT() mysql> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(), -> %Y %D %M %h:%i:%s %x); -> 2003 6th August 06:22:58 2003 SEC_TO_TIME(seconds) Retorna o argumento segundos, convertido em horas, minutos e segundos como um valor no formato HH:MM:SS ou HHMMSS, dependendo do contexto em que a funo utilizada: ca e mysql> SELECT SEC_TO_TIME(2378); -> 00:39:38 mysql> SELECT SEC_TO_TIME(2378) + 0; -> 3938 TIME_TO_SEC(time) Retorna o argumento time, convertido em segundos: mysql> SELECT TIME_TO_SEC(22:23:00); -> 80580 mysql> SELECT TIME_TO_SEC(00:39:38); -> 2378 UTC_DATE UTC_DATE() Retorna a data UTC atual como um valor no formato YYYY-MM-DD ou YYYYMMDD, dependendo se a funo usada emum contexto string ou numrico: ca e e mysql> SELECT UTC_DATE(), UTC_DATE() + 0; -> 2003-08-14, 20030814 UTC_DATE() est dispon a partir do MySQL 4.1.1. a ivel UTC_TIME UTC_TIME() Retorna a hora UTC atual como um valor no formato HH:MM:SS ou HHMMSS, dependendo se a funo usada em um contexto string ou numrico: ca e e mysql> SELECT UTC_TIME(), UTC_TIME() + 0; -> 18:07:53, 180753 UTC_TIME() est dispon a partir do MySQL 4.1.1. a ivel UTC_TIMESTAMP UTC_TIMESTAMP() Retorna a data e hora UTC atual como um valor no formato YYYY-MM-DD HH:MM:SS ou YYYYMMDDHHMMSS, dependendo se a funo usada em um conca e texto string ou numrico: e mysql> SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0; -> 2003-08-14 18:08:04, 20030814180804 UTC_TIMESTAMP() est dispon a partir do MySQL 4.1.1. a ivel

544

MySQL Technical Reference for Version 5.0.0-alpha

6.3.5 Funoes de Converso c a

As funes CAST() e CONVERT() devem ser usada para tomar um valor de um tipo e produzir co um valor de outro tipo. As suas sintaxes so as seguintes: a CAST(express~o AS tipo) a CONVERT(express~o,tipo) a CONVERT(expr USING transcoding_name) O valor tipo pode ser um dos seguintes: BINARY CHAR DATE DATETIME SIGNED {INTEGER} TIME UNSIGNED {INTEGER} CAST() e CONVERT() esto dispon a iveis a partir do MySQL 4.0.2. O tipo de converso CHAR a est disponivel a partir do verso 4.0.6. A forma USING de CONVERT() est dispon a a a ivel a partir da verso 4.1.0. a CAST() e CONVERT(... USING ...) so da sintaxe SQL-99. a CONVERT() da sintaxe ODBC. e A forma no-USING de a

CAST() da sintaxe SQL-99 syntax e CONVERT() da sintaxe ODBC. e e As funes de converso so principalmente uteis quando voc deseja criar uma coluna com co a a e um tipo espec ico em uma CREATE ... SELECT: CREATE TABLE nova_tabela SELECT CAST(2000-01-01 AS DATE); As funes tambm podem ser uteis para ordenar colunas ENUM na ordem lexicogrca. co e a Normalmente a ordenao das colunas ENUM ocorrem usando os valores numricos internos. ca e Converter os valores para CHAR resultam em uma ordenao lexicogrca: ca a SELECT enum_col FROM tbl_name ORDER BY CAST(enum_col AS CHAR); CAST(string AS BINARY) a mesma coisa que BINARY string. CAST(expr AS CHAR) trata e a expresso como uma string com o conjunto de caracteres padro. a a NOTA: No MysQL 4.0 o CAST() para DATE, DATETIME ou TIME s marca a coluna para ser o um tipo espec ico mas no altera o valor da coluna. a No MySQL 4.1.0 o valor ser convertido para a coluna correta quando for enviado para o a usurio (este um recurso de como o novo protocolo na verso 4.1 envia as informaes de a e a co data para o cliente): mysql> SELECT CAST(NOW() AS DATE); -> 2003-05-26 Em verses futuras do MySQL (provavelmente 4.1.2 ou 5.0) iremos corrigir o fato de que o CAST tambm altera o resultado se voc us-lo como parte de uma expresso mais complexa, e e a a como CONCAT("Data: ",CAST(NOW() AS DATE)).

Cap tulo 6: Referncia de Linguagem do MySQL e

545

Voc no deve utilizar CAST() para extrair dados em formatos diferentes, mas sim para e a usar funes strins como LEFT ou EXTRACT(). Veja Seo 6.3.4 [Funes de data e tempo], co ca co Pgina 529. a Para converter uma string para um valor numrico, normalmente no necessrio se fazer e a e a nada; apenas use a string como se fosse um nmero: u mysql> SELECT 1+1; -> 2 Se voc usar um nmero em um contexto string, o nmero ser convertido automaticamente e u u a para uma string BINARY. mysql> SELECT CONCAT("hello you ",2); -> "hello you 2" O MySQL suporta aritimtico com valores de 64 bits com sinal e sem sinal. Se voc est e e a usando operaes numricas (como +) e um dos operandos unsigned integer (inteiro co e e sem sinal), o resultado tambm ser sem sinal (unsigned). Voc pode forar o tipo usando e a e c os operadores de converso SIGNED e UNSIGNED para converter a operao para um inteiro a ca de 64 bits com sinal e sem sinal, respectivamente. mysql> SELECT CAST(1-2 AS UNSIGNED) -> 18446744073709551615 mysql> SELECT CAST(CAST(1-2 AS UNSIGNED) AS SIGNED); -> -1 Note que se um dos operandos for um valor de ponto utuante o resultado um valor de e ponto utuante e no afetado pela regra acima. (Neste contexto DECIMAL() considerado a e e um valor de ponto utuante). mysql> SELECT CAST(1 AS UNSIGNED) -2.0; -> -1.0 Se voc estiver utilizando uma string em uma operao aritimtica, ela convertida para e ca e e um nmero de ponto utuante. u O tratamento de valores sem sinais foi mudado no MySQL 4.0 para suportar valores BIGINT apropriadamente. Se voc tiver algum cdigo que deseja executar no MySQL 4.0 e 3.23 e o (casos em que voc provavelmente no poder usar a funo CAST()), voc pode utilizar o e a a ca e seguinte truque para conseguir um resultado com sinal quando subtraindo duas colunas do tipo unsigned integer (inteiro sem sinal): SELECT (coluna_sem_sinal_1+0.0)-(coluna_sem_sinal_2+0.0); A idia que as colunas sejam convertidas para valores de ponto utuante antes da subtrao e e ca ocorrer. Se voc tiver algum problema com colunas UNSIGNED no seu aplicao MySQL antiga ao e ca portar para o MySQL 4.0, voc pode usar a opo --sql-mode=NO_UNSIGNED_SUBTRACTION e ca ao iniciar mysqld. Note, no entanto, que enquanto voc utilizar esta opo, no ser poss e ca a a ivel conseguir um uso efetivo do tipo de coluna BIGINT UNSIGNED. CONVERT() com USING usado para converter dados entre diferentes conjuntos de caracteres. e No MySQL, nomes trancodicados so o mesmo que o nome do conjunto de caracteres correa spondentes. Por exemplo, esta instruo converte a string abc no conjunto de caracteres ca padro do servidor na string correspondente no conjunto de caracteres utf8: a SELECT CONVERT(abc USING utf8);

546

MySQL Technical Reference for Version 5.0.0-alpha

6.3.6 Outras Funoes c 6.3.6.1 Funoes Binrias c a

O MySQL utiliza aritimtica BIGINT (64bits) para operaes binrias, assim estes opere co a adores possuem uma faixa mxima de 64 bits. a | Operador binrio OR a mysql> SELECT 29 | 15; -> 31 O resultado um inteiro sem sinal de 64 bits. e Operado binrio AND a mysql> SELECT 29 & 15; -> 13 O resultado um inteiro sem sinal de 64 bits. e Operado binrio XOR a mysql> SELECT 1 ^ 1; -> 0 mysql> SELECT 1 ^ 0; -> 1 mysql> SELECT 11 ^ 3; -> 8 O resultado um inteiro sem sinal de 64 bits. e XOR foi adicionado na verso 4.0.2. a Desloca um nmero BIGINT (muito grande) a esquerda: u mysql> SELECT 1 << 2; -> 4 O resultado um inteiro sem sinal de 64 bits. e >> Desloca um nmero BIGINT (muito grande) a direita: u mysql> SELECT 4 >> 2; -> 1 O resultado um inteiro sem sinal de 64 bits. e Inverte todos os bits: mysql> SELECT 5 & ~1; -> 4 O resultado um inteiro sem sinal de 64 bits. e

&

<<

BIT_COUNT(N) Retorna o nmero de bits que so passados no argumento N: u a mysql> SELECT BIT_COUNT(29); -> 4

Cap tulo 6: Referncia de Linguagem do MySQL e

547

6.3.6.2 Funoes Diversas c

DATABASE() Retorna o nome do banco de dados atual: mysql> SELECT DATABASE(); -> test Se nenhum banco de dados estiver selecionado, DATABASE() retorna NULL a partir do MySQL 4.1.1, e uma string vazia em verses anteriores. o USER() SYSTEM_USER() SESSION_USER() Retorna o nome do usurio MySQL e nome de mquina atual: a a mysql> SELECT USER(); -> davida@localhost O valor indica o nome do usurio que voc especicou ao conectar ao servidor e a e a mquina cliente da qual voc se conectou. (Antes do MySQL verso 3.22.11, a e a o valor da funo no inclui o nome da mquina cliente.) ca a a Voc pode extrair apenas a parte do nome do usurio, desconsiderando se o e a valor inclui a parte do nome de mquina, desta forma: a mysql> SELECT SUBSTRING_INDEX(USER(),"@",1); -> davida CURRENT_USER() Retorna o nome do usurio e o nome de mquina com os quais a sesso atual a a a foi autenticada. Este valor corresponde a conta que usada para acessar seu e privilgio de acessos. Ela pode ser diferente do valor de USER(). e

mysql> SELECT USER(); -> davida@localhost mysql> SELECT * FROM mysql.user; -> ERROR 1044: Access denied for user: @localhost to database m mysql> SELECT CURRENT_USER(); -> @localhost O exemplo ilustra que embora o cliente tenha especicado um nome de usurio a davida (como indicado pelo valor da funo USER()), o servidor autenticou o ca cliente usando uma conta de usurio annimo (como visto pela parte vazia no a o nome de usurio do valor CURRENT_USER()). Um modos de isto ocorrer que a e no haja uma conta listada na tabela de permisses para davida. a o PASSWORD(str) OLD_PASSWORD(str) Calcula a senha a partir de senha str em texto puro. Est a funo que ae ca e utilizada para criptografar a senha do MySQL para armazenamento na coluna Password da tabela de permisses user o mysql> SELECT PASSWORD(badpwd); -> 7f84554057dd964b

548

MySQL Technical Reference for Version 5.0.0-alpha

A criptograa de PASSWORD() no e revers a ivel. PASSWORD() no realiza a criptograa da senha da mesa maneira que as senhas a Unix so criptografadas. Veja ENCRYPT(). a Note: A funo PASSWORD() usada pelo sistema de autenticao no servica e ca dor MySQL, voc N~O deve uitliz-las em suas prprias aplicaes. Para este e A a o co propsito utilize MD5() ou SHA1(). Veja tambm RFC-2195 para maiores ino e formaes sobre o tratamento de senha e autenticao segura em suas aplicaes. co ca co ENCRYPT(str[,salt]) Criptografa str utilizando a chamada de sistema crypt() do Unix. O argumento salt deve ser uma string com dois caracteres. (Na verso 3.22.16 do a MySQL, salt deve ser maior que dois caracteres.) mysql> SELECT ENCRYPT("hello"); -> VxuFAJXVARROc ENCRYPT() ignora tudo depois dos primeiros 8 caracteres de str, pelo menos em alguns sistemas. Este comportamento determinado pela implementao e ca da chamada de sistema crypt(). Se crypt() no estiver dispon a ivel no seu sistema, ENCRYPT() sempre retorna NULL. Devido a isto recomendamos que voc use MD5() ou SHA1() em vez dos e existentes em sua plataforma. ENCODE(str,senha_str) Criptografa str usando senha_str como a senha. Para descriptografar o resultado, utilize DECODE(). O resultado uma string binria do mesmo tamanho de str. Se voc deseja e a e salv-la em uma coluna, use uma coluna do tipo BLOB. a DECODE(cript_str,senha_str) Descriptografa o string criptografada cript_str usando senha_str como a senha. cript_str deve ser uma string retornada de ENCODE(). MD5(string) Calcula um checksum MD5 de 128 bits para a string. O valor retornado como e um nmero hexadecimal de 32 digitos que pode, por exemplo, ser usado como u uma chave hash: mysql> SELECT MD5("testing"); -> ae2b1fca515949e5d54fb22b8ed95575 Este o "RSA Data Security, Inc. MD5 Message-Digest Algorithm". e SHA1(string) SHA(string) Calcula um checksum SHA1 de 160 bit para a string, como descrito no RFC 3174 (Algoritmo Hash de Segurana). O valor retornado como um nmero c e u hexadecial de 40 digitos, or NULL no caso do argumento ser NULL . Uma das possibilidades para o uso desta funo a chave hash. Voc tambm pode us-lo ca e e e a como uma funo segura de criptograa para armazenar senhas. ca mysql> SELECT SHA1("abc"); -> a9993e364706816aba3e25717850c26c9cd0d89d

Cap tulo 6: Referncia de Linguagem do MySQL e

549

SHA1() foi adicionado na verso 4.0.2, e pode ser considerada um equivalente a ao MD5() com criptograa mais segura. SHA() um sinnimo para SHA1(). e o AES_ENCRYPT(string,string_chave) AES_DECRYPT(string,string_chave) Estas funes permitem criptograa/descriptograa de dados usando o algoco ritmo ocial AES (Padro Avanado de Criptograa), antes conhecido como a c Rijndael. Criptgraa com uma chave de 128 bits podem ser usadas, mas voc e pode extend-la para 256 bits atravs da fonte. Ns escolhemos 128 bits porque e e o muito mais rpido e bastante seguro. e a e Os argumentos de entrada podem ser de qualquer tamanho. Se ambos argumentos so NULL, o resultado desta funo tam bm ser NULL. a ca e a de bloco, padding usado para codicar Como o AES um algoritimo de nivel e e strings de tamanho impares e ento a string resultante pode ser calculada como a 16*(trunc(tamanho string/16)+1). Se AES_DECRYPT() detectar dados invlidos ou padding incorreto, ela retorna a NULL. No entanto, poss para o AES_DECRYPT() retornar um valor no-NULL e ivel a (possivelmente lixo) se os dados de entrada ou a chave eram invlidos a Voc pode usar as funes AES para armazenar dados de forma criptografada e co modicando as suas consultas: INSERT INTO t VALUES (1,AES_ENCRYPT(text,password)); Voc pode obter mais segurana no transferindo a chave em suas conexes a e c a o cada consulta, o que pode ser conseguido armazenando-o em varveis do lado a do servidor na hora das conexo. a SELECT @password:=my password; INSERT INTO t VALUES (1,AES_ENCRYPT(text,@password)); AES_ENCRYPT() e AES_DECRYPT() foram adicionados na verso 4.0.2, e podem a ser considerados a funo de criptograa mais segura atualmente dispon no ca ivel MySQL. DES_ENCRYPT(string_para_ciptografar [, (numero_chave | chave_string) ] ) Criptografa a string com a chave dada utilizando o algortimo Triplo-DES. Note que esta funo s funciona se o MySQL tiver sido congurado com suporte ca o a SSL. Veja Seo 4.4.10 [Conexes seguras], Pgina 268. ca o a A chave de criptograa utilizada escolhida da seguinte forma: e Argumento Somente um argumento Nmero da chave u string Descrio ca A primeira chave de des-key-file utilizada. e

A chave dada (0-9) de des-key-file utilizada. e A chave_string dada ser utilizada para criptografar a string_para_criptografar. O string retornada ser uma string binria onde o primeiro caracter ser a a a CHAR(128 | nmero_chave). u O 128 adicionado para facilitar o reconhecimento da chave de criptograa. Se e voc usar uma chave string, numro_chave ser 127. e e a

550

MySQL Technical Reference for Version 5.0.0-alpha

Havendo erro, esta funo retorna NULL. ca O tamanho da string para o resultado ser novo_tamanho= tamanho_orig + a (8-(tamanho_orig % 8))+1. O des-key-file ter o seguinte formato: a numero_chave chave_string_des numero_chave chave_string_des Cada numero_chave deve ser um nero na faixa de 0 a 9. As linhas do arquivo u podem estar em qualquer ordem. chave_string_des a string que ser usada e a para criptografar a mensagem. Entre o nmero e a chave deve haver pelo menos u um espao. A primeira chave a chave padro que ser utilizada se no for c e a a a especicada nenhuma chave como argumento para DES_ENCRYPT() Voc pode dizer ao MySQL para ler novos valores de arquivos de chave com o e comando FLUSH DES_KEY_FILE. Isto exige o privilgio Reload_priv. e de ter um conjunto de chaves padres que ele d a aplicao um Um beneficio o e a ca modo de vericar a existncia de valores criptografados em colunas, sem dar ao e usurio nal o direito de descriptografar estes valores. a mysql> SELECT endereco_clientes FROM tabela_clientes WHERE cartao_credito_criptografado = DES_ENCRYPT("numero_cartao_credito") DES_DECRYPT(string_para_descriptografar [, chave_string]) Derscritogra uma string criptografada com DES_ENCRYPT(). Note que esta funo s funciona se o MySQL tiver sido congurado com suporte ca o SSL. Veja Seo 4.4.10 [Conexes seguras], Pgina 268. ca o a Se nenhum argumento chave_string for dado, DES_DECRYPT() examina o primeiro byte da string criptografada para determinar o nmero de chave DES u que foi usado para criptografar a string original, e ento l a chave de des-keya e file para descriptografar a mensagem. Para isto funcionar o usurio deve ter a o privilgio SUPER. e Se voc passar para esta funo um argumento chave_string, aquela string e ca e usada como a chave para descriptografar a mensagem. Se a string_para_descriptografar no se paracer com uma string cripa tografada, o MySQL retornar a string_para_descriptografar dada. a Havendo erro, esta funo retorna NULL. ca COMPRESS(string_para_compactar) Compacta uma string mysql> SELECT LENGTH(COMPRESS(REPEAT("a",1000))); -> 21 1 row in set (0.00 sec) mysql> SELECT LENGTH(COMPRESS("")); -> 0 1 row in set (0.00 sec) mysql> SELECT LENGTH(COMPRESS("a"));

Cap tulo 6: Referncia de Linguagem do MySQL e

551

-> 13 1 row in set (0.00 sec) mysql> SELECT LENGTH(COMPRESS(REPEAT("a",16))); -> 15 1 row in set (0.00 sec) COMPRESS() foi adicionado no MySQL 4.1.1. Se exigido, o MySQL tem que ser compilado com uma biblioteca de compactao como zlib. Seno , o valor de ca a retorno sempre NULL. e O contedo da string compactada armazenada da seguinte forma: u e Strings vazias so armazenadas como strings vazias a Strings que no esto vazias so armazenadas como um string descoma a a pacatada de 4 byte de tamanho (low-byte-rst) seguida pela string compactada com gzip. Se a string naliza com espao, adicionamos um . c extra para evitar problemas com o corte do espao nal o resultado deve c ser armazenado em um campo CHAR ou VARCHAR. O uso de CHAR ou VARCHAR para armazenar strings compactadas no recomendado. E melhor usar a e uma coluna BLOB. UNCOMPRESS(string_para_descompactar) Descompacta uma string compactado pela funo COMPRESS() ca mysql> select UNCOMPRESS(COMPRESS("any string")); -> any string 1 row in set (0.00 sec) UNCOMPRESS() foi adicionado no MySQL 4.1.1 Se exigido, o MySQL tem que ser compilado com uma biblioteca de compactao como zlib. Seno , o valor ca a de retorno sempre NULL. e UNCOMPRESSED_LENGTH(string_compactada) Retorna o tamanho da string compactada antes da compactao ca mysql> select UNCOMPRESSED_LENGTH(COMPRESS(REPEAT("a",30))); -> 30 1 row in set (0.00 sec) UNCOMPRESSED_LENGTH() foi adicionado no MySQL 4.1.1 LAST_INSERT_ID([expr]) Retorna o ultimo valor gerado automaticamente que tenha sido inserido em um coluna AUTO_INCREMENT. mysql> SELECT LAST_INSERT_ID(); -> 195 O ultimo ID que foi gerado e mantido no servidor em uma base por conexo. a Isto signica que o valor que a funo retona para um dado cliente o valor ca e AUTO_INCREMENT gerado mais recentemente por aquele cliente. O valor no a pode ser afetado pelos outros clientes, mesmo se eles gerarem um valor AUTO_ INCREMENT deles mesmos. Este comportamento assegura que voc pode recue perar seu prprio ID sem se preocupar com a atividade de outros clientes e sem o precisar de locks ou transaes. co

552

MySQL Technical Reference for Version 5.0.0-alpha

O valor de LAST_INSERT_ID() no alterado se voc atualizar uma coluna a e e AUTO_INCREMENT de uma linha com um valor no-mgico (Isto , um valor que a a e no seja NULL e nem 0). a Se voc inserir muitos registros ao mesmo tempo com uma instruo insert, e ca LAST_INSERT_ID() retorna o valor da primeira linha inserida. A razo para a isto tornar poss reproduzir facilmente a mesma intruo INSERT em algum e ivel ca outro servidor. Se expr dado com um argumento para LAST_INSERT_ID(), ento o valor e a do argumento retornado pela funo e congurado como o prximo valor e ca e o para ser retornado pela LAST_INSERT_ID(). Isto pode ser util para simular sequncias: e Primeiro crie a tabela: mysql> CREATE TABLE sequencia (id INT NOT NULL); mysql> INSERT INTO sequencia VALUES (0); Ento a tabela pode ser usada para gerar sequncia de nmeros como estes: a e u mysql> UPDATE sequencia SET id=LAST_INSERT_ID(id+1); Voc pode gerar sequncias sem chamar LAST_INSERT_ID(), mas a utilidade e e de se usar a funo deste modo que o valor ID mantido no servidor como o ca e e ultimo valor gerado automaticamente (seguro para multi-usurrio). Voc pode a e recuperar a nova ID como voc leria qualquer valor AUTO_INCREMENT normal e no MySQL. Por exemplo, LAST_INSERT_ID() (sem um argmento) retornar a a nova ID. A funo mysql_insert_id() da API C tambm pode ser usada para ca e obter o valor. Note que como mysql_insert_id() s atualizado depois de instrues INSERT oe co e UPDATE, voc no pode utilizar a funo da API C para recuperar o valor para e a ca LAST_INSERT_ID(expr) depois de executar outra instruo SQL como SELECT ca ou SET. Veja Seo 12.1.3.32 [mysql_insert_id()], Pgina 803. ca a FORMAT(X,D) Formata o nmero X com um format como #,###,###.##, arredondado para u D casas decimais, e retorna o resultado como uma string. Se D 0, o resultado e no ter nehum ponto decimal ou parte fracionria: a a a mysql> SELECT FORMAT(12332.123456, 4); -> 12,332.1235 mysql> SELECT FORMAT(12332.1,4); -> 12,332.1000 mysql> SELECT FORMAT(12332.2,0); -> 12,332 VERSION() Retorna uma string indicando a verso do servidro MySQL: a mysql> SELECT VERSION(); -> 3.23.13-log Note que se seu verso nalizar com -log, signica que o log est habilitado. a a

Cap tulo 6: Referncia de Linguagem do MySQL e

553

CONNECTION_ID() Retorna a identicao (ID da thread) desta conexo. Cada conexo tem seu ca a a prprio ID unico: o mysql> SELECT CONNECTION_ID(); -> 23786 GET_LOCK(str,temo_limite) Tenta conseguir uma trava com o nome dado pela string str, com um tempo limite de timeout segundos. Retorna 1 se o bloqueio foi obtido com sucesso, 0 se o tempo esgotou (por exemplo, porque outro cliente ja bloqueou o nome), ou NULL se uma erro ocorreu (tal como estouro de memria ou a threado tiver sido o nalizada com mysqladmin kill). Uma trava liberada quando voc executa e e RELEASE_LOCK(), executa uma nova GET_LOCK(), ou a thread termina. (tanto de forma normal quanto anormal) Esta funo pode ser usada para implementar ca bloqueio de aplicao ou para simular registros travados. Nomes so bloqueados ca a em uma base ampla do servidor. Se um nome foi bloqueado por um cliente, GET_LOCK() trava qualquer pedido de bloqueio de outro cliente com o mesmo nome. Isto permite que clientes que concordam com um dado nome da trava possam usar a string para realizar travamento de consultas cooperativas: mysql> SELECT GET_LOCK("lock1",10); -> 1 mysql> SELECT IS_FREE_LOCK("lock2"); -> 1 mysql> SELECT GET_LOCK("lock2",10); -> 1 mysql> SELECT RELEASE_LOCK("lock2"); -> 1 mysql> SELECT RELEASE_LOCK("lock1"); -> NULL Note que a segunda chamada de RELEASE_LOCK() retorna NULL porque a trava "lock1" foi liberada automaticamente pela segunda chamada GET_LOCK(). RELEASE_LOCK(str) Libera a trava nomeada pela string str que foi obtida com GET_LOCK(). Retorna 1 se a trava foi liberada, 0 se a trava no foi bloquada pela thread (caso a onde a trava no liberada), e NULL se o nome da trava no existe. (A trava a e a nunca exitir se ela nunca for obtida pela chamada de GET_LOCK() ou se ela ja a tiver sido liberada). A instruo DO conveniente para ser utilizada com RELEASE_LOCK(). Veja ca e Seo 6.4.10 [DO], Pgina 597. ca a IS_FREE_LOCK(str) Verica se a trava chamada str est livre para ser utilizada (ex. no est a a a bloqueada). Retorna 1 se a trava est liver (ningum a esta usando), 0 se a a e trava est em uso, e NULL caso ocorra erro (como argumentos incorretos). a BENCHMARK(cont,expr) A funo BENCHMARK() executa a expresso expr repetidamente cont vezes. Ela ca a pode ser usada para medir a velocidade em que o MySQL processa a expresso. a

554

MySQL Technical Reference for Version 5.0.0-alpha

O valor resultante sempre 0. A inteno us-la no clientei mysql, relatando e ca e a o tempo de execuo da consulta: ca mysql> SELECT BENCHMARK(1000000,ENCODE("hello","goodbye")); +----------------------------------------------+ | BENCHMARK(1000000,ENCODE("hello","goodbye")) | +----------------------------------------------+ | 0 | +----------------------------------------------+ 1 row in set (4.74 sec) O tempo relatado o tempo decorrido no cliente, no o tempo de CPU no servie a dor. Pode ser aconselhvel executar BENCHMARK() diversas vezes e interpretar a o resultado cosiderado o peso da carga da maquina servidora. INET_NTOA(expr) Dado um endereo numrico de rede (4 ou 8 bytes), retorna a representaco no c e a formato com pontos do endereo como uma string: c mysql> SELECT INET_NTOA(3520061480); -> "209.207.224.40" INET_ATON(expr) Dada a represenao com pontos de um endereo de rede como uma string, ca c retorna um inteiro que representa o valor numrico deste endereo. Endereos e c c podem ter 4 ou 8 bytes de endereamento: c mysql> SELECT INET_ATON("209.207.224.40"); -> 3520061480 O nmero gerado sempre na ordem de bytes da rede; por exemplo o nmero u e u acima calculado como 209*256^3 + 207*256^2 + 224*256 +40. e MASTER_POS_WAIT(nome_log, log_pos [, tempo_limite]) Envia blocos o slave alcanar (ex.: ter lido e aplicado todas as atualizaes) a c co posio especica no log master. Se a informao master no est inicializada, ca ca a a ou se os argumentos esto incorretos, retorna NULL. Se o slave no est em a a a execuo, enviar blocos e ir esperar at que ele seja iniciado e v para (ou ca a a e a passe por) a posio especicada. Se o slave j passou pela posio especicada, ca a ca retorna imediatamente. Se tempo_limite (novo na verso 4.0.10) especicado, ir esperar at que a e a e tempo_limite segundos tenham se passado. tempo_limite deve ser maior que 0; zero ou um tempo_limite negativo signica sem tempo limite. O valor de retorno o nmero de eventos de log que ele tem que esperar para obter a e u posio especicada, NULL no caso de erro, ou -1 se o tempo limite tiver sido ca excedido. O comando util para controle de sincronizao mo master/slave. e ca FOUND_ROWS() Uma instruo SELECT pode incluir uma clusula LIMIT para restringir o ca a nmero de linhas que o servidor retorna para um cliente. Em alguns casos, u e desejvel saber quantas linhas a instruo teria retornado sem o LIMIT, mas a ca sem executar a instruo novamente. Para obter esta contagem de linhas, ca

Cap tulo 6: Referncia de Linguagem do MySQL e

555

inclua uma opo SQL_CALC_FOUND_ROWS na instruo SELECT, ento chame ca ca a FOUND_ROWS() loga depois: mysql> SELECT SQL_CALC_FOUND_ROWS * FROM nome_tabela WHERE id > 100 LIMIT 10; mysql> SELECT FOUND_ROWS(); O segundo SELECT ir retornar um nmero indicando quantas linhas o primeiro a u SELECT teria retornado se ele fosse escrito sem a clusula LIMIT. (Se o instruo a ca SELECT anterior no inclui a opo SQL_CALC_FOUND_ROWS, ento FOUND_ROWS() a ca a pode retornar um resultado diferente quando LIMIT usado daquele que no e a e usado). Note que se voc estiver usando SELECT SQL_CALC_FOUND_ROWS ..., o MySQL e tem que calcular quantos registros existem em todo o conjunto de resultados. No entanto, isto mais rpido que se voc no utilizar LIMIT, j que o resultado e a e a a precisa ser enviado ao cliente. SQL_CALC_FOUND_ROWS e FOUND_ROWS() podem ser uteis em situaes em que co voc queira restringir o nmero de registros que uma consulta retorna, mas e u tambm determinar o nmero de linhas em todo o resultado sem executar a e u consulta novamente. Um exemplo um script web que apresenta um display e paginado contendo links para as pginas que mostram outras sees de um a co resultado de busca. Usar FOUND_ROWS() lhe permite determinar quantos outras pginas so necessrias para o resto do resultado. a a a O uso de SQL_CALC_FOUND_ROWS e FOUND_ROWS() mais complexa para cone sultas UNION que para instrues SELECT simples, porque LIMIT pode ocorrer co em vrios lugares em um UNION. Ele pode ser aplicado a instrues SELECT a co individuais no UNION, ou globais ao resultado UNION como um todo. A inteno de SQL_CALC_FOUND_ROWS para UNION que ele deve retornar a ca e contagem das linhas que seriam retornadas sem um LIMIT global. As consies co para uso de SQL_CALC_FOUND_ROWS com UNION so: a A palavra chave SQL_CALC_FOUND_ROWS deve aparecer na primeira SELECT do UNION. O valor de FOUND_ROWS() exato apenas se UNION ALL for usado. Se UNION e sem ALL for usado, as duplicatas so removidas e o valor de FOUND_ROWS() a apenas aproximado. e Se nenhum LIMIT est presente no UNION, SQL_CALC_FOUND_ROWS ignoa e rado e retorna o nmero de linhas na tabela temporria que criada para u a e processar o UNION. SQL_CALC_FOUND_ROWS e FOUND_ROWS() esto dispon a iveis a partir da verso a 4.0.0 do MySQL.

6.3.7 Funoes e Modicadores para Usar com Clusulas GROUP BY c a

556

MySQL Technical Reference for Version 5.0.0-alpha

6.3.7.1 Funoes GROUP BY c

Se voc utiliza um funo de agrupamento em uma instruo que no contenha um clusula e ca ca a a GROUP BY, equivale a fazer um agrupamento com todos os registros. COUNT(expr) Retorna a quantidade instrucao SELECT: mysql> SELECT -> -> -> de valores no-NULL nos registros recuperados por uma a estudante.nome_estudente,COUNT(*) FROM estudante,curso WHERE estudante.id_estudante=curso.id_estudante GROUP BY nome_estudante;

COUNT(*) difere um pouco ao retornar o nmero de registros recuperados, se u eles possu irem ou no valores NULL. a COUNT(*) otimizado para retornar muito rpido se SELECT recuoperar registros e a de uma tabela, nenhuma outra coluna for retornada, e no houver nenhuma a clusula WHERE. Por exemplo: a mysql> SELECT COUNT(*) FROM estudente; Esta otimizaco se aplica apenas a tabelas MyISAM e ISAM, porque uma contagem a exata de registros armazenada para estes tipos de tabelas e podem ser acese sadas muito rapidamente. Para mecanismos de armazenamentos transacionais (InnodB, BDB), armazenar um contagem de registros exatos mais problemtico e a porque mltiplas transaes podem estar ocorrendo, e cada uma pode afetar a u co contagem. COUNT(DISTINCT expr,[expr...]) Retorna a quantidade de regiastros com valores no-NULL diferentes: a mysql> SELECT COUNT(DISTINCT resultados) FROM estudente; No MySQL voc pode obter o nmero de combinao de expresses distintas e u ca o que no contm NULL fornecendo uma lista de expresses. No SQL-99 voc a e o e teria que concatenar todas as expresso utilizando COUNT(DISTINCT ...). a AVG(expr) Retorna o valor mdio de expr: e mysql> SELECT nome_estudante, AVG(nota_teste) -> FROM estudante -> GROUP BY nome_estudante; MIN(expr) MAX(expr)

Retorna o valor m inimo o u mximo de expr. MIN() e MAX() poder usar uma a string como argumento; nestes casos eles retornam o a string de valor m inimo ou mximo. Veja Seo 5.4.3 [ a ca Indices do MySQL], Pgina 447. a mysql> SELECT nome_estudante, MIN(nota_teste), MAX(nota_teste) -> FROM estudante -> GROUP BY nome_estudante;

Cap tulo 6: Referncia de Linguagem do MySQL e

557

Em MIN(), MAX() e outras funes de agrupamento o MySQL, atualmente, co compara colunas ENUM e SET pelo seu valor string em vez de faz-lo pela sua e posio relativa de string no conjunto. Isto ser reticado. ca a SUM(expr) Retorna a soma de expr. Note que se o conjunto de retorno no possuir registros a ele retornar NULL! a GROUP_CONCAT(expr) Sintaxe completa: GROUP_CONCAT([DISTINCT] expr [,expr ...] [ORDER BY {inteiro_sem_sinal | nome_coluna | formula} [ASC | [SEPARATOR valor_str]) Esta funo foi adicionada na verso 4.1 do MySQL. Ele retorna a string resulca a tante contendo valores de um grupo: mysql> SELECT nome_estudante, -> GROUP_CONCAT(note_teste) -> FROM estudante -> GROUP BY nome_estudante; ou mysql> SELECT nome_estudante, -> GROUP_CONCAT(DISTINCT nota_teste -> ORDER BY nota_teste DESC SEPARATOR " ") -> FROM estudante -> GROUP BY nome_estudante; No MySQL voc pode obter valores de combinaes de expresses concatenae co o dos. Voc pode eliminar valores duplicados utilizando DISTINCT. Se voc quiser e e ordenar valores no resultado voc deve utilizar a clusula ORDER BY. Para ore a denar inversamente, adicione a palavra chave DESC (descendente) ao nome da coluna que voc est ordenando na clusula ORDER BY. O padro a ordem crese a a a e cente; pode-se tambm especicla explicitamente usando a palavra chave ASC. e a SEPARATOR o valor string que deve ser inserido entre os valores no resultado. e O padro um virgula (","). Voc pode remover o separador especicando a e e SEPARATOR "". Voc pode denir um tamanho mximo permitido com a varivel group_ e a a concat_max_len em sua congurao. A sintaxe para se fazer isto em tempo ca de execuo : ca e SET [SESSION | GLOBAL] group_concat_max_len = unsigned_integer; Se um tamanho mximo tiver sido atribuido, o resultado truncado no seu a e tamanho mximo. a A funo GROUP_CONCAT() uma implementao aprimorada da funo bsica ca e ca ca a LIST() suportada pelo Sybase SQL Anywhere. GROUP_CONCAT() compat e ivel com a funcionalidade extrwemamente limitada de de LIST(), se utilizada em apenas uma coluna e nenhuma outra opo especicada. LIST() no tem ca e a uma ordem de classicao padro. ca a

558

MySQL Technical Reference for Version 5.0.0-alpha

VARIANCE(expr) Retorna a varincia padro de expr (considerando linha como toda a populao, a a ca no com uma amostra; assim ele tem o nmero de linhas como denominador). a u Esta uma extenso do SQL-99 (dispon somente a partir da verso 4.1). e a ivel a STD(expr) STDDEV(expr) Retorna o desvio padro de expr (a raiz quadrada de VARIANCE()). Esta a e uma extenso do SQL-99. O formato STDDEV() desta funo fornecida para a ca e compatibilidade com Oracle. BIT_OR(expr) Retorna o resultado da operao binria OR de todos os bits em expr. O calca a cululo relizado com preciso de 64 bits (BIGINT). e a A funo retortna 0 se no houver registros coincidentes. ca a BIT_XOR(expr) Retorna o bitwise XOR de todos os bits em expr. O calculo relizado com e preciso de 64-bits (BIGINT). a A funo retorna 0 se no houver linhas coincidentes. ca a Esta funo est dispon a partir do MySQL 4.1.1. ca a ivel BIT_AND(expr) Retorna o resultado da operao binria AND de todos os bits em expr. O ca a calcululo relizado com preciso de 64 bits (BIGINT). e a A funo retortna 1 se no houver registros coincidentes. ca a

6.3.7.2 Modicadores GROUP BY

No MySQL 4.1.1, a clusula GROUP BY permite um modicador WITH ROLLUP que faz com a que uma linha extra seja adicionada ` saida resumo. Estas linhas representam operaes de a co resumo de n mais alto (ou super agregadas). Assim, o ROLLUP permite que voc responda ivel e questes em multiplos n o iveis de anlise com uma unica consulta. Ele pode ser usado, a por exemplo, para fornecer suporte para operaes OLAP (Online Analytical Processing co Processamento Anal itico OnLine). Como ilustrao, suponha que uma tabela chamada sales tenha as colunas year, country, ca product e profit para registrar as vendas lucrativas: CREATE TABLE sales ( year INT NOT NULL, country VARCHAR(20) NOT NULL, product VARCHAR(32) NOT NULL, profit INT ); O contedo da tabela pode ser resumido pode ano com um simples GROUP BY como este: u mysql> SELECT year, SUM(profit) FROM sales GROUP BY year; +------+-------------+

Cap tulo 6: Referncia de Linguagem do MySQL e

559

| year | SUM(profit) | +------+-------------+ | 2000 | 4525 | | 2001 | 3010 | +------+-------------+ Esta sa mostra o lucro total para cada ano, mas se voc tambm quiser determinar o ida e e lucro total somado em todos os anos, voc deve adicionar os valores adicionais ou executar e uma consulta adicional. Ou voc pode usar o ROLLUP, que fornece os dois n e iveis de anlise com uma unica consulta. a Adicionando um modicador WITH ROLLUP a clusula GROUP BY faz com que a consulta a produza outra linha que mostra o total geral de todos os anos: mysql> SELECT year, SUM(profit) FROM sales GROUP BY year WITH ROLLUP; +------+-------------+ | year | SUM(profit) | +------+-------------+ | 2000 | 4525 | | 2001 | 3010 | | NULL | 7535 | +------+-------------+ A linha de total super-agrupada identicada pelo valor NULL na coluna year. e ROLLUP tem um efeito mais complexo quando h mltiplas colunas GROUP BY. Neste caso, a u cada vez que houver um break (alterao no valor) em qualquer agrupamento, com ca exceo da ultima coluna, a consulta produz um linha resumo super-agrupada extra. ca Por exemplo, sem ROLLUP, um resumo na tabela sales baseada no year, country e product pode se parecer com isto: mysql> SELECT year, country, product, SUM(profit) -> FROM sales -> GROUP BY year, country, product; +------+---------+------------+-------------+ | year | country | product | SUM(profit) | +------+---------+------------+-------------+ | 2000 | Finland | Computer | 1500 | | 2000 | Finland | Phone | 100 | | 2000 | India | Calculator | 150 | | 2000 | India | Computer | 1200 | | 2000 | USA | Calculator | 75 | | 2000 | USA | Computer | 1500 | | 2001 | Finland | Phone | 10 | | 2001 | USA | Calculator | 50 | | 2001 | USA | Computer | 2700 | | 2001 | USA | TV | 250 | +------+---------+------------+-------------+ A sa indica os valores resumidos apenas no n ida ivel year/country/product da anlise. a Quando ROLLUP adicionado, a consulta produz diversas linhas extras: e mysql> SELECT year, country, product, SUM(profit)

560

MySQL Technical Reference for Version 5.0.0-alpha

-> FROM sales -> GROUP BY year, country, product WITH ROLLUP; +------+---------+------------+-------------+ | year | country | product | SUM(profit) | +------+---------+------------+-------------+ | 2000 | Finland | Computer | 1500 | | 2000 | Finland | Phone | 100 | | 2000 | Finland | NULL | 1600 | | 2000 | India | Calculator | 150 | | 2000 | India | Computer | 1200 | | 2000 | India | NULL | 1350 | | 2000 | USA | Calculator | 75 | | 2000 | USA | Computer | 1500 | | 2000 | USA | NULL | 1575 | | 2000 | NULL | NULL | 4525 | | 2001 | Finland | Phone | 10 | | 2001 | Finland | NULL | 10 | | 2001 | USA | Calculator | 50 | | 2001 | USA | Computer | 2700 | | 2001 | USA | TV | 250 | | 2001 | USA | NULL | 3000 | | 2001 | NULL | NULL | 3010 | | NULL | NULL | NULL | 7535 | +------+---------+------------+-------------+ Para esta consulta, adicionar ROLLUP faz com que a sa inclua uma informao resumida ida ca ROLLUP: nos qualtro niveis de anlise, no s em um. Aqui est como interpretar a saida a a o a Seguindo cada conjunto de produtos para um dado ano e pa um linha de resumo is, extra produzida mostrando o total para todos os produtos. Estas linhas tm a coluna e e product atribu com NULL. ida Seguindo cada conjunto de linhas para um dado ano, uma l;inha resumo extra proe e produtos. Estas linhas tm as colunas duzida mostrando o total para todos os paises e country e products atribu idas com NULL. Finalmente, seguindo todas as outras linhas, um linha resumo extra produzida e mostrando o total geral para todos os anos, pa ises e produtos. Esta linha tem as colunas year, country e products atribu idas com NULL. Outras Consideraes ao Usar ROLLUP co O seguinte item lista alguns comportamentos espec icaos para a implementao do ROLLUP ca no MySQL: Quando voc usa ROLLUP, voc no pode usar uma clusula ORDER BY para ordenar os e e a a resultados. (Em outras palavras, ROLLUP e ORDER BY so exclusivos mutualmente.) No a entanto, voc ainda tem algum controle sobre a ordem de ordenao. O GROUP BY no MySQL e ca ordena os resultados, e voc pode usar as palavras chaves ASC e DESC explicitamente com e colunas chamadas na lista GROUP BY para especicar a ordem de classicao para colunas ca individuais. (A linha resumo de n mais alto adicionado por ROLLUP ainda aparece depois ivel da linha para as quais elas so calculadas, considerando a ordenao.) a ca

Cap tulo 6: Referncia de Linguagem do MySQL e

561

LIMIT pode ser usado para restringir o nmerod e linhas retornadas para o cliente. LIMIT u e aplicado depois do ROLLUP, assim o limite se aplica contra as linhas extras adicionadas por ROLLUP. Por exemplo: mysql> SELECT year, country, product, SUM(profit) -> FROM sales -> GROUP BY year, country, product WITH ROLLUP -> LIMIT 5; +------+---------+------------+-------------+ | year | country | product | SUM(profit) | +------+---------+------------+-------------+ | 2000 | Finland | Computer | 1500 | | 2000 | Finland | Phone | 100 | | 2000 | Finland | NULL | 1600 | | 2000 | India | Calculator | 150 | | 2000 | India | Computer | 1200 | +------+---------+------------+-------------+ Note que usar LIMIT com ROLLUP pode produzir resultados mais dif iceis de interpretar, porque voc tm menos contexto para entender as linhas super agrupadas. e e O indicador NULL em cada linha super-agrupadas so produzidas quando a linha enviada a e para o cliente. O servidor olha por cada coluna chamada na clusula GROUP BY seguindo a aquela mais a esquerda que tem o valor alterado. Para qualquer coluna no resultado com o nome que uma combinao lxica de qualquer daqueles nomes, seu valor denido com e ca e e NULL. (Se voc especica o agrupamento de colunas pelo nmero da coluna, o servidor e u identica quais colunas denir com NULL pelo nmero.) u Como os valores NULL em linhas super agrupadas so colocadas dentro do resultado como a um estgio posterior no processamento da consulta, voc no pode test-los com valores a e a a NULL dentro da prpria consulta. Por exemplo, voc no pode adicionar HAVING product o e a IS NULL a consulta para eliminar da sa todas as linhas com exceo das agrupadas. ida ca Por outro lado, o valor NULL aparece como NULL no lado do cliente e pode ser testado usando qualquer interface de programao do cliente MySQL. ca

6.3.7.3 GROUP BY com Campos Escondidos

O MySQL tem extendido o uso de GROUP BY. Voc pode utilizar colunas ou clculos na e a expresso SELECT que no aparecem na parte GROUP BY. Ele espera por qalquer valor poss a a ivel para este grupo. Voc pode utilizar isto para conseguir um melhor desempenho evitando e ordenao e agrupamento em itens desnecessrios. Por exemplo, voc no precisa fazer um ca a e a agrupamento em cliente.nome na consulta seguinte: mysql> SELECT pedido.idcliente,cliente.nome,MAX(pagamento) -> FROM pedido, cliente -> WHERE pedido.idcliente = cliente.idcliente -> GROUP BY pedido.idcliente; No padro SQL, voc teria que adicionar cliente.nome a clusula GROUP BY. No MySQL, a e a o nom redundante se voc no o executa em modo ANSI. ee e a

562

MySQL Technical Reference for Version 5.0.0-alpha

No utilize este recurso se as colunas omitidas na parte GROUP BY no so unicas no grupo! a a a Voc obter resultados inexperados. e a Em alguns casos, voc pode utilizar MIN e MAX para obter o valor de uma coluna espec e ica, mesmo que ele no seja unico. O exemplo seguinte fornece o valor de coluna do registro a contendo o menor valor na coluna ordem: SUBSTR(MIN(CONCAT(RPAD(ordem,6, ),coluna)),7) Veja Seo 3.6.4 [example-Maximum-column-group-row], Pgina 197. ca a Note que se voc estiver usando a verso 3.22 do MySQL (ou anterior) ou se estiver tentando e a seguir o SQL-99, voc no pode utilizar expresses nas clusulas GROUP BY or ORDER BY. Voc e a o a e pode contornar esta limitao utilizando um alias para a expresso: ca a mysql> SELECT id,FLOOR(value/100) AS val FROM nome_tabela -> GROUP BY id,val ORDER BY val; Na verso 3.23 do MySQL voc pode fazer: a e mysql> SELECT id,FLOOR(value/100) FROM nome_tabela ORDER BY RAND();

6.4 Manipulao de Dados: SELECT, INSERT, UPDATE e DELETE ca

6.4.1 Sintaxe SELECT
SELECT [STRAIGHT_JOIN] [SQL_SMALL_RESULT] [SQL_BIG_RESULT] [SQL_BUFFER_RESULT] [SQL_CACHE | SQL_NO_CACHE] [SQL_CALC_FOUND_ROWS] [HIGH_PRIORITY] [DISTINCT | DISTINCTROW | ALL] express~o_select,... a [INTO {OUTFILE | DUMPFILE} nome_arquivo op~es_exporta~o] co ca [FROM tabelas_ref [WHERE defini~o_where] ca [GROUP BY {inteiro_sem_sinal | nome_col | formula} [ASC | DESC], ... [WITH ROLLUP]] [HAVING where_definition] [ORDER BY {inteiro_sem_sinal | nome_coluna | formula} [ASC | DESC], ...] [LIMIT [offset,] row_count | row_count OFFSET offset] [PROCEDURE nome_procedimento(lista_argumentos)] [FOR UPDATE | LOCK IN SHARE MODE]] SELECT utilizado para retornar registros selecionados de uma ou mais tabelas. Cada e express~o_select indica as colunas que voc deseja recuperar. SELECT tanbm pode ser a e e utilizado para retornar registros calculados sem referncia a nenhuma tabela. Por exemplo: e mysql> SELECT 1 + 1; -> 2 Todas as clusulas usada devem ser fornecidas exatamente na ordem mostrada na descrio a ca da sintaxe. Por exemplo, uma clusula HAVING deve vir depois de qualquer clusula GROUP a a BY e antes de qualquer clusula ORDER BY. a

Cap tulo 6: Referncia de Linguagem do MySQL e

563

Uma expresso SELECT pode utilizar um alias usando AS nome_alias. O alias usado a e como o nome da coluna da expresso e pode ser usado com clusulas ORDER BY ou a a HAVING. Por exemplo: mysql> SELECT CONCAT(primeiro_nome, ,ultimo_nome) AS nome_completo FROM minha_tabela ORDER BY nome_completo; A palavra chave AS opcional quando se utiliza alias em uma expresso SELECT. O e a exemplo anterior poderia ser escrito assim: mysql> SELECT CONCAT(last_name,, ,first_name) full_name FROM mytable ORDER BY full_name; Como AS opcional, pode ocorrer um problema se voc esquecer a v e e irgula entre duas expresses SELECT: O MySQL interpretar o segundo como um nome de alias. Por o a exemplo, na seguinte instruo, columnb tratada como um nome de alias: ca e mysql> SELECT columna columnb FROM mytable; No permitido utilizar um alias de coluna em uma clusula WHERE, pois o valor da a e a coluna pode ainda no ter sido determinado quando a clusula WHERE for executada. a a Veja Seo A.5.4 [Problemas com alias], Pgina 933. ca a A clusula FROM table_references indica a tabela de onde os registros sero retora a nados. Se voc indicar mais de uma tabela, voc estar realizando uma join. Para e e a informaes sobre a sintaxe de join, veja Seo 6.4.1.1 [JOIN], Pgina 567. Para cada co ca a tabela especicada, voc pode, opcionalmente, especicar um alias. e nome_tabela [[AS] alias] [[USE INDEX (lista_indice)] | [IGNORE INDEX (lista_indi Como na verso 3.23.12 do MySQL, voc pode dar sugestes sobre qual a e o indice o MySQL deve usar ao recuperar informaes de uma tabela. Isto util se EXPLAIN mostrar que o co e MySQL esta utilizando o indice errado da lista de indices poss iveis. Especicando USE INDEX (lista_indice) voc pode dizer ao MySQL para usar somente um dos e indices poss iveis para encontrar registros em uma tabela. A sintaxe alternativa IGNORE INDEX (lista_indice) pode ser usada para dizer ao MySQL para no utilizar alguns a indices particulares. Na verso 4.0.9 do MySQL voc tambm pode usar FORCE INDEX. Ele funciona como a e e USE INDEX (lista_indice) mas ele assume que uma varredura em uma tabelas e MUITO cara. Em outras palavras, uma varredura s ser usada se no houver nenhum o a a modo de utilizar um dos indices dados para encontrar registros nas tabelas. USE/IGNORE/FORCE KEY sinnimo de USE/IGNORE/FORCE INDEX. e o Nota: USE/IGNORE/FORCE INDEX afeta apenas os indices usados quando o MySQL decide como encontrar registros na tabela e como fazer a ligao. Ele no tem efeito se ca a um indice ser usado ao resolver um ORDER BY ou GROUP BY. a No MySQL 4.0.14 voc pode usar SET MAX_SEEKS_FOR_KEY=# como um modo alternae tivo de forar o MySQL a preferir a busca em chaves em vez de varrer a tabela. c Voc pode se referir a uma tabela como nome_tabela (dentro do banco de dados e atual) ou como nomebd.nome_tabela para especicar um banco de dados. Voc e pode se referir a um coluna como nome_coluna, nome_tabela.nome_coluna ou nomebd.nome_tabela.nome_coluna. Voc no precisa especicar um prexo e a nome_tabla ou nomebd.nome_tabela para referncia a uma coluna em uma instruo e ca SELECT a menos a referncia seja ambigua. Veja Seo 6.1.2 [Legal names], Pgina 472, e ca a

564

MySQL Technical Reference for Version 5.0.0-alpha

para exemplos de ambiguidade que exigem a forma mais explicita de referncia a e coluna. A partir da verso 4.1.0, voc pode especicar DUAL como um nome de tabela dummy, a e em situaes onde nenhuma tabela for refernciada. Este um recurso puramente para co e e compatibilidade, alguns outros servidores exijem esta sintaxe. mysql> SELECT 1 + 1 FROM DUAL; -> 2 Pode se denir um alias fazendo referncia a uma tabela utilizando nome_tabela [AS] e nome_alias: mysql> SELECT t1.nome, t2.salario FROM funcionarios AS t1, info AS t2 -> WHERE t1.nome = t2.nome; mysql> SELECT t1.nome, t2.salario FROM funcionarios t1, info t2 -> WHERE t1.nome = t2.nome; Colunas selecionadas para sa podem ser referidas em clusulas ORCER BY e GROUP ida a BY usando nomes de colunas, alias de colunas ou posies de colunas. As posies de co co colunas comeam com 1: c mysql> SELECT college, region, seed FROM tournament -> ORDER BY region, seed; mysql> SELECT college, region AS r, seed AS s FROM tournament -> ORDER BY r, s; mysql> SELECT college, region, seed FROM tournament -> ORDER BY 2, 3; Para ordenar inversamente, adicione a palavra-chave DESC (descendente) ao nome da coluna na clusula ORDER BY na qual voc est ordenando. A ordem padro ascedente; a e a a e ela pode ser especicada explicitamente usando a palavra-chave ASC. Na clusula WHERE, voc pode usar qualquer uma das funes suportadas pelo MySQL. a e co Exceto para funes de agruopamento (resumo) Veja Seo 6.3 [Funes], Pgina 504. co ca co a A clusula HAVING pode se referir a qualquer coluna ou alias denido na express~o_ a a select. Ele aplicado no nal, pouco antes dos itens serem enviados ao cliente, sem e otimizao. LIMIT aplicada depois de HAVING.) estar na clusula WHERE. Por exemplo, ca e a no escreva isto: a mysql> SELECT nome_col FROM nome_tabela HAVING nome_col > 0; Escreva assim: mysql> SELECT nome_col FROM nome_tabela WHERE nome_col > 0; Na verso 3.22.5 ou posterior, voc tambm pode escrever consultar desta forma: a e e mysql> SELECT usuario,MAX(salario) FROM usuarios -> GROUP BY usuario HAVING MAX(salario)>10; Em verses mais antigas, voc pode escrever desta forma: o e mysql> SELECT usuario,MAX(salario) AS soma FROM usuarios -> group by usuario HAVING soma>10; As opes DISTINCT, DISTINCTROW e ALL especicam quando registros duplicados deco vem ser retornados. O padro (ALL), todos os registros coincidentes so retornados. a e a DISTINCT e DISTINCTROW so sinnimos e espcicam que registros duplicados no cona o junto de resultados devem ser remopvidos.

Cap tulo 6: Referncia de Linguagem do MySQL e

565

STRAIGHT_JOIN, HIGH_PRIORITY e opes comeando com SQL_ so extenses do co c a o MySQL para SQL-99. No MySQL 4.1.1, GROUP BY permite um modicador WITH ROLLUP. Seo 6.3.7.2 [Modicadores GROUP BY], Pgina 558. ca a Veja

HIGH_PRIORITY dar uma prioridade maior ao SELECT do que para uma instruo a ca que atualizam uma tabela. Voc s deve isto para consultas que sejam rpidas e e o a devam ser feitas imediatamente. Uma consulta SELECT HIGH_PRIORITY retornar a se a tabela est bloqueada para leitura memsmo se houver uma instruo de atua ca alizao que estiver esperando a liberao da tabela. ca ca SQL_BIG_RESULT pode ser usado com GROUP BY ou DISTINCT para dizer ao otimizador que o conjunto de resultados ter muitas linhas. Neste caso, o MySQL a usar diretamente tabelas temporarias em disco se necessrio. O MySQL tambm a a e ir, neste caso, preferir ordenar fazendo uma tabela temporria com um cahve a a nos elementos GROUP BY. SQL_BUFFER_RESULT fora para que o resultado seja colocado em uma tabela temc porria. Isto ajuda o MySQL a liberar as travas de tabelas mais cedo e ajudar a a nos casos onde ele lev muito tempo para enviar o conjunto de resultado ao cliente. a SQL_SMALL_RESULT, uma opo especica do MySQL, pode ser usada com GROUP ca BY ou DISTINCT para dizer ao otimizador que o conjunto de resultados ser pea queno. Neste caso, o MySQL usa tabelas temporrias rpidas para armazenar a a a tabela resultante em vez de usar ordenao. Na verso 3.23 do MySQL isto no ca a a e necessrio normalmente. a SQL_CALC_FOUND_ROWS (verso 4.0.0 e acima) diz ao MySQL para calcular quana tas linhas haveriam no conjunto de resultados, desconsiderando qualquer clusula a LIMIT. O nmero de linhas pode ser recuperado com SELECT FOUND_ROWS(). Veja u Seo 6.3.6.2 [Funes diversas], Pgina 547. ca co a Por favor, note que em nverses anteriores a 4.1.0 isto no funciona com LIMIT o a 0, o qual otimizado para retornar instantaneamente (resultando em 0 registros). e Veja Seo 5.2.9 [Otimizao LIMIT], Pgina 437. ca ca a SQL_CACHE diz ao MySQL para armazenar o resultado da consulta em um cache de consultas se voc estiver utilizando QUERY_CACHE_TYPE=2 (DEMAND). Veja Seo 6.9 e ca [Cache de consultas], Pgina 625. No caso da consulta com UNIONs e/ou suba queries esta opo ter efeito se usada em qualquer SELECT da consulta. ca a SQL_NO_CACHE diz ao MySQL para no armazenar o resulado da consulta nesta a cache de consultas. Veja Seo 6.9 [Cache de consultas], Pgina 625. No caso da ca a consulta com UNIONs e/ou subqueries esta opo ter efeito se usada em qualquer ca a SELECT da consulta. Se voc utiliza GROUP BY, os registros de sa sero ordenados de acordo com o GROUP e ida a BY como se voc tivesse um ORDER BY sobre todos os campos no GROUP BY. O MySQL e tem expandido a clusula GROUP BY para que voc tambm possa especicar ASC e DESC a e e depois das colunas chamadas na clusula: a SELECT a,COUNT(b) FROM tabela_teste GROUP BY a DESC O MySQL tem extendido o uso do GROUP BY para lhe permitir selecionar campos que no a esto mencionados na clusula GROUP BY. Se voc no est conseguindo os resultados a a e a a

566

MySQL Technical Reference for Version 5.0.0-alpha

esperados ara a sua consulta, leia a descrio de GROUP BY. Veja Seo 6.3.7 [Group by ca ca functions and modiers], Pgina 555. a A partir do MySQL 4.1.1, GROUP BY permite um modicador WITH ROLLUP. Seo 6.3.7.2 [GROUP BY Modiers], Pgina 558. ca a Veja

A clusula LIMIT pode ser usada para restringir o nmero de linhas retornadas pela a u instruo SELECT. LIMIT utiliza um ou dois agumebntos numricos, que devem ser ca e constants inteiras. Com um argumento. o valor especif o nmero de linhas para retornar do in do ica u icio resultado. Com dois argumentos, o primeiro especica a posio do primeiro registro a ca ser retornado e o segundo especica o nmero mximo de linhas a retornar. A posio u a ca do registro inicial 0 (no 1): e a Para ser compat com o PostgreeSQL, o MySQL suporta a sintaxe: LIMIT row_count ivel OFFSET offset. mysql> SELECT * FROM tabela LIMIT 5,10; # Recupera linhas 6-15 Para recuperar todos os registros de um determinado oset at um m do resultado e voc pode usar um nmero grande como segundo parmetro: e u a Se um dos argumentos dado, ele indica o nmero mximo de linhas a retornar: e u a mysql> SELECT * FROM tabela LIMIT 5; # Recupera as primeiras 5 linhas Em outras palavras, LIMIT n equivalente a LIMIT 0,n. e A forma SELECT ... INTO OUTFILE nome_arquivo do SELECT grava os registros selecionados em um arquivo. O arquivo criado na mquina servidora e no pode j e a a a existir (entre outras coisas, isto previne tabelas de banco de dados e arquivos tais como /etc/passwd de serem destru idos). Voc deve ter o privilgio FILE na mquina e e a servidora para utilizar esta forma de SELECT. A instruo SELECT ... INTO OUTFILE tem como inteno deixar que voc descarregue ca ca e rapidamente um tabela de uma mquina servidora. Se voc quiser criar o arquivo a e resultante em outra mquina, diferente do servidor, voc no deve usar SELECT ... a e a INTO OUTFILE. Neste caso voc deve usar algum programa cliente como mysqldump e --tab ou mysql -e "SELECT..." > outfile para gerar o arquivo. SELECT ... INTO OUTFILE o complemento de LOAD DATA INFILE; a sintaxe para a e parte op~es_exporta~o de uma instruo consiste das mesmas clusulas CAMPOS e co ca ca a LINHAS que so usadas com a instruo LOAD DATA INFILE. Veja Seo 6.4.8 [LOAD a ca ca DATA], Pgina 588. a No arquivo texto resultante, somente os seguintes coracteres so escritos com o caracter a ESCAPE BY: O caracter ESCAPE BY O primeiro caracter em FIELDS TERMINATED BY O primeiro caracter em LINES TERMINATED BY Adicionalmente, ASCII 0 convertido para ESCAPE BY seguido por 0 (ASCII 48). e A razo para o mostrado acima que voc deve escapar qualquer caracter FIELDS a e e TERMINATED BY, ESCAPE BY, or LINES TERMINATED BY para termos a segurana que o c

mysql> SELECT * FROM tabela LIMIT 95,18446744073709551615; # Recupera linhas 96-

Cap tulo 6: Referncia de Linguagem do MySQL e

567

arquivo poder ser lido de volta. E feito escape de ASCII 0 para facilitar a visuzlizao a ca com alguns paginadores. Como o arquivo resultante no tem que estar em conformidade com a sintaxe SQL, a nada mais precisa ser seguido de caraceres de escape. Aqui segue um exemplo de como se obter um arquivo no formato usado por muitos programas antigos. SELECT a,b,a+b INTO OUTFILE "/tmp/result.text" FIELDS TERMINATED BY , OPTIONALLY ENCLOSED BY " LINES TERMINATED BY "\n" FROM tabela_teste; Se voc utilizar INTO DUMPFILE em vez de INTO OUTFILE, o MySQL s ir escrever um e o a linha no arquivo, sem nenhum terminador de linha ou colunas e sem realizar nenhum processo de escape. Ele util se voc quiser armazenar um valor BLOB em um arquivo. e e Note que qualuqer arquivo criado por INTO OUTFILE e INTO DUMPFILE sero escritos a por todos os usurios no servidor! A razo que o servidor MySQL no pode criar a a e a um arquivo que pertence a qualquer um alm do usurio que o est executando (voc e a a e nunca deve executar mysqld como root). Assim o arquivo tem que poder ser gravado por todos para que voc possa manipular o seu contedo. e u Uma clusula PROCEDURE chama um procedimento que devia processar os dados em um a resultado. Para um exemplo, veja Seo 14.3.1 [procedure analyse], Pgina 909. ca a Se voc utilizar FOR UPDATE em um mecanismo de armazenamento com locks de pginas e a ou registros, as linhas examinadas sero travadas para escrita at o m da transao a e ca atual.

6.4.1.1 Sintaxe JOIN

O MySQL suporta as seguintes sintaxes JOIN para uso em instrues SELECT: co tabela_ref, tabela_ref tabela_ref [INNER | CROSS] JOIN table_reference [join_condition] tabela_ref STRAIGHT_JOIN tabela_ref tabela_ref LEFT [OUTER] JOIN table_reference [join_condition] tabela_ref NATURAL [LEFT [OUTER]] JOIN tabela_ref { OJ tabela_ref LEFT OUTER JOIN tabela_ref ON expr_condicional } tabela_ref RIGHT [OUTER] JOIN table_reference [join_condition] tabela_ref NATURAL [RIGHT [OUTER]] JOIN tabela_ref Onde tabela_ref denido como: e a condi~o_join denido como: ca e ON expr_condicional | USING (lista_colunas) Geralamente voc no dever ter nenhuma condio na parte ON que usada para restringir e a a ca e quais registros voc ter no seu resultado, mas ao invs disto, especicar estas condies na e a e co clusula WHERE. Existem excees para isto. a co

nome_tabela [[AS] alias] [[USE INDEX (lista_indice)] | [IGNORE INDEX (lista_indice)]

568

MySQL Technical Reference for Version 5.0.0-alpha

Note que a sintaxe INNER JOIN permite uma condi~o_join apenas a partir da verso ca a 3.23.17. O mesmo acontece para JOIN e CROSS JOIN apenas a partir do MySQL 4.0.11. A ultima sintaxe LEFT OUTER JOIN mostrada na lista anterior s existe para compatibilidade o com ODBC: Pode se usar um alias para referncia a tabelas com nome_tabela AS nome_alias ou e nome_tabela nome_alias: mysql> SELECT t1.nome, t2.salario FROM funcionarios AS t1, info AS t2 -> WHERE t1.nome = t2.nome; A condicional ON qualquer condio da forma que pode ser usada em uma clusula e ca a WHERE. Se no houver registros coincidentes para a tabela a direita da parte ON ou USING em a um LEFT JOIN, uma linha com NULL atribu a todas as colunas usada para a tabela ido e a direita. Voc pode usar este fato para encontrar registro em uma tabela que no e a houver contrapartes em outra tabela mysql> SELECT tabela1.* FROM tabela1 -> LEFT JOIN tabela2 ON tabela1.id=tabela2.id -> WHERE tabela2.id IS NULL; Este exemplo encontra todas as linhas em tabela1 com um valor id que no est a a presente em tabela2 (isto , toda as linhas em tabela1 sem linha correspondente e em tabela2). Assume-se que tabela2.id declarada NOT NULL. Veja Seo 5.2.7 e ca [Otimizao LEFT JOIN], Pgina 435. ca a A clusula USING (lista_colunas) nomeia uma lista de colunas que devem existir em a ambas as tabelas. As seguintes duas clusulas so semanticamente idnticas: a a e a LEFT JOIN b USING (c1,c2,c3) a LEFT JOIN b ON a.c1=b.c1 AND a.c2=b.c2 AND a.c3=b.c3 Um NATURAL [LEFT] JOIN de duas tabelas denido para ser semanticamente equivae lente a um INNER JOIN ou um LEFT JOIN com uma clusula USING que nomeia todas a as colunas que exitem em ambas as tabelas. INNER JOIN e , (v irgula) so semanticamente equivalentes na ausncia da condio a e ca join: ambos produziro um produto Cartesiano entre as tabelas especicadas. (isto , a e todos os registros na primeira tabela sero ligados com todos os registros na segunda a tabela). RIGHT JOIN funciona de forma anloga a um LEFT JOIN. Para manter o cdigo portvel a o a entre banco de dados, recomendado usar LEFT JOIN em vez de RIGHT JOIN. e STRAIGHT_JOIN identico a JOIN, exceto pelo fato de que a tabela de esquerda sempre e lida antes da tabela da direita. Ele pode ser usado para aqueles casos (poucos) onde e o otimizador join coloca as tabelas na ordem errada. Como na verso 3.23.12, voc pode dar sugestes sobre qual a e o indice o MySQL deve us quando retornar informaes de uma tabela. Isto util se EXPLAIN mostar que co e o MySQL est utilizando o a indice errado da lista de indices poss iveis. Especicando USE INDEX (lista_indice), voc pode dizer ao MySQL para usar somente um dos e indices poss iveis para encontrar registros em uma tabela. A sintaxe alternativa IGNORE INDEX (lista_indice) pode ser usado para dizer ao MySQL para no utilizar a indices particulares.

Cap tulo 6: Referncia de Linguagem do MySQL e

569

Na verso 4.0.9 do MySQL voc tambm pode utilizar FORCE INDEX. Ele funciona a e e como USE INDEX (key_list) mas com assume que uma varredura na tabela MUITO e cara. Em outras palavras, uma varredura na tabela s ser feita se no houver modo o a a de uitlizar um dos indices fornecidos para se enecontrar registros no tabela. USE/IGNORE KEY so sinnimos de USE/IGNORE INDEX. a o Nota: USE/IGNORE/FORCE INDEX afeta apenas os indices usados quando o MySQL decide como encontrar registros na tabela e como fazer a ligao. Ele no tem efeito se um ca a indice ser usado ao resolver um ORDER BY ou GROUP BY. a Alguns exemplos: mysql> mysql> mysql> mysql> -> mysql> -> mysql> -> FROM tabela1,tabela2 WHERE tabela1.id=tabela2.id; FROM tabela1 LEFT JOIN tabela2 ON tabela1.id=tabela2.id; FROM tabela1 LEFT JOIN tabela2 USING (id); FROM tabela1 LEFT JOIN tabela2 ON tabela1.id=tabela2.id LEFT JOIN tabela3 ON tabela2.id=tabela3.id; SELECT * FROM tabela1 USE INDEX (chave1,chave2) WHERE chave1=1 AND chave2=2 AND chave3=3; SELECT * FROM tabela1 IGNORE INDEX (chave3) WHERE chave1=1 AND chave2=2 AND chave3=3; SELECT SELECT SELECT SELECT * * * *

Veja Seo 5.2.7 [Otimizao LEFT JOIN], Pgina 435. ca ca a

6.4.1.2 Sintaxe UNION

SELECT ... UNION [ALL] SELECT ... [UNION SELECT ...] UNION foi implementado no MySQL 4.0.0. UNION usado para combinar o resultado de muitas instrues SELECT em um unico conjunto e co de resultados. As colunas listadas na poro expresso select de SELECT devem ter o mesmo tipo. Os nomes ca a das colunas usadas na primeira consulta SELECT sero usadas como nomes de colunas para a o resultado retornado. Os comandos SELECT so comandos selects normais, mas com a seguinte restrio: a ca Somente o ultimo comando SELECT pode ter INTO OUTFILE. Se voc no utilzar a palavra-chave ALL para o UNION, todas as linhas retornadas sero e a a unicas, como se voc tivesse utilizado um DISTINCT para o resultado nal. Se voc especicar e e ALL, voc obter todos os regitros encontrados em todas as instrues SELECT. e a co Se voc quiser usar um ORDER BY para o resultado UNION nal, voc deve utilizar parenteses: e e (SELECT a FROM nome_tabela WHERE a=10 AND B=1 ORDER BY a LIMIT 10) UNION (SELECT a FROM nome_tabela WHERE a=11 AND B=2 ORDER BY a LIMIT 10) ORDER BY a;

570

MySQL Technical Reference for Version 5.0.0-alpha

6.4.2 Sintaxe de Subquery

Uma subquery uma instruo SELECT dentro de outra instruo. Por exemplo: e ca ca SELECT * FROM t1 WHERE column1 = (SELECT column1 FROM t2); No exemplo acima, SELECT * FROM t1 ... a consulta principal (ou instruo principal ), e ca e (SELECT column1 FROM t2) a subquery. Dizemos que a subquery est aninhada na e a consulta principal, e de fato poss e ivel aninhar subqueries dentro de outras subqueries, a uma grande profundidade. uma subquery deve estar sempres dentro de parenteses. A partir da verso 4.1. o MySQL suporta todas as formas de subqueries e operaes que o a co padro SQL exige, assim como alguns recursos que so especicos do MySQL. A principal a a vantagem das subqueries so: a elas permitem consultas que esto estruturadas assim poss a e ivel isolar cada parte de uma instruo, ca elas fornecem modos alternativos de realizar operaes que, de outra forma, exigiriam co joins e unions complexos, elas so, na opinio de muitas pessoas, leg a a iveis. De fato, foi a inovao das subqueries ca que deu `s pessoas a idia original do nome SQL Structured Query Language. a e Com verses MySQL anteriores era necessrio evitar ou contornar as subqueries, mas as o a pessoas que comeam a escrever cdigo agora descobriro que subqueries so uma parte c o a a muito util do pacote de ferramentas. Aqui est uma instruo exemplo que mostra o ponto principal sobre a sintaxe de subquery a ca como especicado pelo SQL padro e suportado no MySQL. a DELETE FROM t1 WHERE s11 > ANY (SELECT COUNT(*) /* no hint */ FROM t2 WHERE NOT EXISTS (SELECT * FROM t3 WHERE ROW(5*t2.s1,77)= (SELECT 50,11*s1 FROM t4 UNION SELECT 50,77 FROM (SELECT * FROM t5) AS t5))); Para as verses do MySQL anteriores a 4.1, a maioria da subqueries podem ser reescritas o com sucesso usando join e outros mtodos. Veja Seo 6.4.2.11 [Rewriting subqueries], e ca Pgina 578. a

6.4.2.1 A Subquery como um Operando Escalar

Na sua forma mais simples (a subquery scalar o oposto das subqueries de row ou table e que ser discutido posteriormente), uma subqquery um opernado simples. Assim voc a e e pode us-la se um valor de uma coluna ou literal permitido, e voc pode esperar que a e e eles tenham certas caracter isticas que todos os operandos possuem: um tipo de dados, um tamanho, um indicador para informar se ele pode ser NULL, etc. Por exemplo: CREATE TABLE t1 (s1 INT, s2 CHAR(5) NOT NULL); SELECT (SELECT s2 FROM t1);

Cap tulo 6: Referncia de Linguagem do MySQL e

571

The subquery in the above SELECT has a data type of CHAR, a length of 5, a character set and collation equal to the defaults in eect at CREATE TABLE time, and an indication that the value in the column can be NULL. In fact almost all subqueries can be NULL, because if the table is empty as in the example then the value of the subquery will be NULL. There are few restrictions. A subquerys outer statement can be any one of: SELECT, INSERT, UPDATE, DELETE, SET, or DO. A subquery can contain any of the keywords or clauses that an ordinary SELECT can contain: DISTINCT, GROUP BY, ORDER BY, LIMIT, joins, hints, UNIONs, comments, functions, and so on. So, when you see examples in the following sections that contain the rather Spartan construct (SELECT column1 FROM t1), imagine that your own code will contain much more diverse and complex constructions. For example, suppose we make two tables: CREATE TABLE t1 (s1 INT); INSERT INTO t1 VALUES (1); CREATE TABLE t2 (s1 INT); INSERT INTO t2 VALUES (2); Then perform a SELECT: SELECT (SELECT s1 FROM t2) FROM t1; The result will be 2 because there is a row in t2, with a column s1, with a value of 2. The subquery may be part of an expression. If it is an operand for a function, dont forget the parentheses. For example: SELECT UPPER((SELECT s1 FROM t1)) FROM t2;

6.4.2.2 Comparaes Usando Subquery co

The most common use of a subquery is in the form: <non-subquery operand> <comparison operator> (<subquery>) Where <comparison operator> is one of: = > < >= <= <> For example: ... a = (SELECT column1 FROM t1) At one time the only legal place for a subquery was on the right side of a comparison, and you might still nd some old DBMSs which insist on that. Here is an example of a common-form subquery comparison which you cant do with a join: nd all the values in table t1 which are equal to a maximum value in table t2. SELECT column1 FROM t1 WHERE column1 = (SELECT MAX(column2) FROM t2); Here is another example, which again is impossible with a join because it involves aggregating for one of the tables: nd all rows in table t1 which contain a value which occurs twice.

572

MySQL Technical Reference for Version 5.0.0-alpha

SELECT * FROM t1 WHERE 2 = (SELECT COUNT(column1) FROM t1);

6.4.2.3 Subqueries with ANY, IN, and SOME

Syntax: <operand> <comparison operator> ANY (<subquery>) <operand> IN (<subquery>) <operand> <comparison operator> SOME (<subquery>) The word ANY, which must follow a comparison operator, means return TRUE if the comparison is TRUE for ANY of the rows that the subquery returns. For example, SELECT s1 FROM t1 WHERE s1 > ANY (SELECT s1 FROM t2); Suppose that there is a row in table t1 containing {10}. The expression is TRUE if table t2 contains {21,14,7} because there is a value in t2 7 which is less than 10. The expression is FALSE if table t2 contains {20,10}, or if table t2 is empty. The expression is UNKNOWN if table t2 contains {NULL,NULL,NULL}. The word IN is an alias for = ANY. Thus these two statements are the same: SELECT s1 FROM t1 WHERE s1 = ANY (SELECT s1 FROM t2); SELECT s1 FROM t1 WHERE s1 IN (SELECT s1 FROM t2); The word SOME is an alias for ANY. Thus these two statements are the same: SELECT s1 FROM t1 WHERE s1 <> ANY (SELECT s1 FROM t2); SELECT s1 FROM t1 WHERE s1 <> SOME (SELECT s1 FROM t2); Use of the word SOME is rare, but the above example shows why it might be useful. The English phrase a is not equal to any b means, to most peoples ears, there is no b which is equal to a which isnt what is meant by the SQL syntax. By using <> SOME instead, you ensure that everyone understands the true meaning of the query.

6.4.2.4 Subqueries with ALL

Syntax: <operand> <comparison operator> ALL (<subquery>) The word ALL, which must follow a comparison operator, means return TRUE if the comparison is TRUE for ALL of the rows that the subquery returns. For example, SELECT s1 FROM t1 WHERE s1 > ALL (SELECT s1 FROM t2); Suppose that there is a row in table t1 containing {10}. The expression is TRUE if table t2 contains {-5,0,+5} because all three values in t2 are less than 10. The expression is FALSE if table t2 contains {12,6,NULL,-100} because there is a single value in table t2 12 which is greater than 10. The expression is UNKNOWN if table t2 contains {0,NULL,1}. Finally, if table t2 is empty, the result is TRUE. You might think the result should be UNKNOWN, but sorry, its TRUE. So, rather oddly, SELECT * FROM t1 WHERE 1 > ALL (SELECT s1 FROM t2); is TRUE when table t2 is empty, but

Cap tulo 6: Referncia de Linguagem do MySQL e

573

SELECT * FROM t1 WHERE 1 > (SELECT s1 FROM t2); is UNKNOWN when table t2 is empty. In addition, SELECT * FROM t1 WHERE 1 > ALL (SELECT MAX(s1) FROM t2); is UNKNOWN when table t2 is empty. In general, tables with NULLs and empty tables are edge cases when writing subquery code, always consider whether you have taken those two possibilities into account.

6.4.2.5 Correlated Subqueries

A correlated subquery is a subquery which contains a reference to a column which is also in the outer query. For example: SELECT * FROM t1 WHERE column1 = ANY (SELECT column1 FROM t2 WHERE t2.column2 = t1.column2); Notice, in the example, that the subquery contains a reference to a column of t1, even though the subquerys FROM clause doesnt mention a table t1. So MySQL looks outside the subquery, and nds t1 in the outer query. Suppose that table t1 contains a row where column1 = 5 and column2 = 6; meanwhile table t2 contains a row where column1 = 5 and column2 = 7. The simple expression ... WHERE column1 = ANY (SELECT column1 FROM t2) would be TRUE, but in this example the WHERE clause within the subquery is FALSE (because 7 <> 5), so the subquery as a whole is FALSE. Scoping rule: MySQL evaluates from inside to outside. For example: SELECT column1 FROM t1 AS x WHERE x.column1 = (SELECT column1 FROM t2 AS x WHERE x.column1 = (SELECT column1 FROM t3 WHERE x.column2 = t3.column1)); In the above, x.column2 must be a column in table t2 because SELECT column1 FROM t2 AS x ... renames t2. It is not a column in table t1 because SELECT column1 FROM t1 ... is an outer query which is further out. For subqueries in HAVING or ORDER BY clauses, MySQL also looks for column names in the outer select list. MySQLs unocial recommendation is: avoid correlation because it makes your queries look more complex, and run more slowly.

6.4.2.6 EXISTS and NOT EXISTS

If a subquery returns any values at all, then EXISTS <subquery> is TRUE, and NOT EXISTS <subquery> is FALSE. For example: SELECT column1 FROM t1 WHERE EXISTS (SELECT * FROM t2); Traditionally an EXISTS subquery starts with SELECT * but it could begin with SELECT 5 or SELECT column1 or anything at all MySQL ignores the SELECT list in such a subquery, so it doesnt matter. For the above example, if t2 contains any rows, even rows with nothing but NULL values, then the EXISTS condition is TRUE. This is actually an unlikely example, since almost always a [NOT] EXISTS subquery will contain correlations. Here are some more realistic examples. Example: What kind of store is present in one or more cities?

574

MySQL Technical Reference for Version 5.0.0-alpha

SELECT DISTINCT store_type FROM Stores WHERE EXISTS (SELECT * FROM Cities_Stores WHERE Cities_Stores.store_type = Stores.store_type); Example: What kind of store is present in no cities? SELECT DISTINCT store_type FROM Stores WHERE NOT EXISTS (SELECT * FROM Cities_Stores WHERE Cities_Stores.store_type = Stores.store_type); Example: What kind of store is present in all cities? SELECT DISTINCT store_type FROM Stores S1 WHERE NOT EXISTS ( SELECT * FROM Cities WHERE NOT EXISTS ( SELECT * FROM Cities_Stores WHERE Cities_Stores.city = Cities.city AND Cities_Stores.store_type = Stores.store_type)); The last example is a double-nested NOT EXISTS query it has a NOT EXISTS clause within a NOT EXISTS clause. Formally, it answers the question does a city exist with a store which is not in Stores?. But its easier to say that a nested NOT EXISTS answers the question is x TRUE for all y?.

6.4.2.7 Row Subqueries

The discussion to this point has been of column (or scalar) subqueries subqueries which return a single column value. A row subquery is a subquery variant that returns a single row value and may thus return more than one column value. Here are two examples: SELECT * FROM t1 WHERE (1,2) = (SELECT column1, column2 FROM t2); SELECT * FROM t1 WHERE ROW(1,2) = (SELECT column1, column2 FROM t2); The queries above are both TRUE if table t2 has a row where column1 = 1 and column2 = 2. The expression (1,2) is sometimes called a row constructor and is legal in other contexts too. For example SELECT * FROM t1 WHERE (column1,column2) = (1,1); is equivalent to SELECT * FROM t1 WHERE column1 = 1 AND column2 = 1; The normal use of row constructors, though, is for comparisons with subqueries that return two or more columns. For example, this query answers the request: nd all rows in table t1 which are duplicated in table t2: SELECT column1,column2,column3 FROM t1 WHERE (column1,column2,column3) IN (SELECT column1,column2,column3 FROM t2);

Cap tulo 6: Referncia de Linguagem do MySQL e

575

6.4.2.8 Subqueries in the FROM clause

Subqueries are legal in a SELECT statements FROM clause. The syntax that youll actually see is: SELECT ... FROM (<subquery>) AS <name> ... The AS <name> clause is mandatory, because any table in a FROM clause must have a name. Any columns in the <subquery> select list must have unique names. You may nd this syntax described elsewhere in this manual, where the term used is derived tables. For illustration, assume you have this table: CREATE TABLE t1 (s1 INT, s2 CHAR(5), s3 FLOAT); Heres how to use the Subqueries in the FROM clause feature, using the example table: INSERT INTO t1 VALUES (1,1,1.0); INSERT INTO t1 VALUES (2,2,2.0); SELECT sb1,sb2,sb3 FROM (SELECT s1 AS sb1, s2 AS sb2, s3*2 AS sb3 FROM t1) AS sb WHERE sb1 > 1; Result: 2, 2, 4.0. Heres another example: Suppose you want to know the average of the sum for a grouped table. This wont work: SELECT AVG(SUM(column1)) FROM t1 GROUP BY column1; But this query will provide the desired information: SELECT AVG(sum_column1) FROM (SELECT SUM(column1) AS sum_column1 FROM t1 GROUP BY column1) AS t1; Notice that the column name used within the subquery (sum_column1) is recognized in the outer query. At the moment, subqueries in the FROM clause cannot be correlated subqueries.

6.4.2.9 Subquery Errors

There are some new error returns which apply only to subqueries. This section groups them together because reviewing them will help remind you of some points. ERROR 1235 (ER_NOT_SUPPORTED_YET) SQLSTATE = 42000 Message = "This version of MySQL doesnt yet support LIMIT & IN/ALL/ANY/SOME subquery" This means that SELECT * FROM t1 WHERE s1 IN (SELECT s2 FROM t2 ORDER BY s1 LIMIT 1) will not work, but only in some early versions, such as MySQL 4.1.1.

576

MySQL Technical Reference for Version 5.0.0-alpha

ERROR 1240 (ER_CARDINALITY_COL) SQLSTATE = 21000 Message = "Operand should contain 1 column(s)" This error will occur in cases like this: SELECT (SELECT column1, column2 FROM t2) FROM t1; Its okay to use a subquery that returns multiple columns, if the purpose is comparison. Veja Seo 6.4.2.7 [Row subqueries], Pgina 574. But in other contexts the subquery ca a must be a scalar operand. ERROR 1241 (ER_SUBSELECT_NO_1_ROW) SQLSTATE = 21000 Message = "Subquery returns more than 1 row" This error will occur in cases like this: SELECT * FROM t1 WHERE column1 = (SELECT column1 FROM t2); but only when there is more than one row in t2. That means this error might occur in code that has been working for years, because somebody happened to make a change which aected the number of rows that the subquery can return. Remember that if the object is to nd any number of rows, not just one, then the correct statement would look like this: SELECT * FROM t1 WHERE column1 = ANY (SELECT column1 FROM t2); Error 1093 (ER_UPDATE_TABLE_USED) SQLSTATE = HY000 Message = "You cant specify target table x for update in FROM clause" This error will occur in cases like this: UPDATE t1 SET column2 = (SELECT MAX(column1) FROM t1); Its okay to use a subquery for assignment within an UPDATE statement, since subqueries are legal in UPDATE and in DELETE statements as well as in SELECT statements. However, you cannot use the same table, in this case table t1, for both the subquerys FROM clause and the update target. Usually, failure of the subquery causes the entire statement to fail.

6.4.2.10 Optimizing Subqueries

Development is ongoing, so no optimization tip is reliable for the long term. Some interesting tricks that you might want to play with are: Using subquery clauses which aect the number or order of the rows in the subquery, for example SELECT * FROM t1 WHERE t1.column1 IN (SELECT column1 FROM t2 ORDER BY column1); SELECT * FROM t1 WHERE t1.column1 IN (SELECT DISTINCT column1 FROM t2); SELECT * FROM t1 WHERE EXISTS

Cap tulo 6: Referncia de Linguagem do MySQL e

577

(SELECT * FROM t2 LIMIT 1); Replacing a join with a subquery, for example SELECT DISTINCT column1 FROM t1 WHERE t1.column1 IN ( SELECT column1 FROM t2); instead of SELECT DISTINCT t1.column1 FROM t1, t2 WHERE t1.column1 = t2.column1; Moving clauses from outside to inside the subquery, for example: SELECT * FROM t1 WHERE s1 IN (SELECT s1 FROM t1 UNION ALL SELECT s1 FROM t2); instead of SELECT * FROM t1 WHERE s1 IN (SELECT s1 FROM t1) OR s1 IN (SELECT s1 FROM t2); Para outro exemplo: SELECT (SELECT column1 + 5 FROM t1) FROM t2; em vez de: SELECT (SELECT column1 FROM t1) + 5 FROM t2; Using a row subquery instead of a correlated subquery, for example: SELECT * FROM t1 WHERE (column1,column2) IN (SELECT column1,column2 FROM t2); instead of SELECT * FROM t1 WHERE EXISTS (SELECT * FROM t2 WHERE t2.column1=t1.column1 AND t2.column2=t1.column2); Using NOT (a = ANY (...)) rather than a <> ALL (...). Using x = ANY (table containing {1,2}) rather than x=1 OR x=2. Using = ANY rather than EXISTS The above tricks may cause programs to go faster or slower. Using MySQL facilities like the BENCHMARK() function, you can get an idea about what helps in your own situation. Dont worry too much about transforming to joins except for compatibility with older versions. Some optimizations that MySQL itself will make are: 1. MySQL will execute non-correlated subqueries only once, (use EXPLAIN to make sure that a given subquery really is non-correlated), 2. MySQL will rewrite IN/ALL/ANY/SOME subqueries in an attempt to take advantage of the possibility that the select-list columns in the subquery are indexed, 3. MySQL will replace subqueries of the form ... IN (SELECT indexed_column FROM single_table ...) with an index-lookup function, which EXPLAIN will describe as a special join type, 4. MySQL will enhance expressions of the form

578

MySQL Technical Reference for Version 5.0.0-alpha

value {ALL|ANY|SOME} {> | < | >= | <=} (non-correlated subquery) with an expression involving MIN or MAX (unless NULLs or empty sets are involved). For example, WHERE 5 > ALL (SELECT x FROM t) might be treated as WHERE 5 > (SELECT MAX(x) FROM t) There is a chapter titled How MySQL Transforms Subqueries in the MySQL Internals Manual, which you can nd by downloading the MySQL source package and looking for a le named internals.texi.

6.4.2.11 Rewriting Subqueries for Earlier MySQL Versions

Up to version 4.0, only nested queries of the form INSERT ... SELECT ... and REPLACE ... SELECT ... are supported. The IN() construct can be used in other contexts. It is often possible to rewrite a query without a subquery: SELECT * FROM t1 WHERE id IN (SELECT id FROM t2); This can be rewritten as: SELECT t1.* FROM t1,t2 WHERE t1.id=t2.id; The queries: SELECT * FROM t1 WHERE id NOT IN (SELECT id FROM t2); SELECT * FROM t1 WHERE NOT EXISTS (SELECT id FROM t2 WHERE t1.id=t2.id); Can be rewritten as: SELECT table1.* FROM table1 LEFT JOIN table2 ON table1.id=table2.id WHERE table2.id IS NULL; A LEFT [OUTER] JOIN can be faster than an equivalent subquery because the server might be able to optimise it better a fact that is not specic to MySQL Server alone. Prior to SQL-92, outer joins did not exist, so subqueries were the only way to do certain things in those bygone days. Today, MySQL Server and many other modern database systems oer a whole range of outer joins types. For more complicated subqueries you can often create temporary tables to hold the subquery. In some cases, however, this option will not work. The most frequently encountered of these cases arises with DELETE statements, for which standard SQL does not support joins (except in subqueries). For this situation there are three options available: The rst option is to upgrade to MySQL version 4.1. The second option is to use a procedural programming language (such as Perl or PHP) to submit a SELECT query to obtain the primary keys for the records to be deleted, and then use these values to construct the DELETE statement (DELETE FROM ... WHERE ... IN (key1, key2, ...)). The third option is to use interactive SQL to construct a set of DELETE statements automatically, using the MySQL extension CONCAT() (in lieu of the standard || operator). For example:

Cap tulo 6: Referncia de Linguagem do MySQL e

579

SELECT CONCAT(DELETE FROM tab1 WHERE pkid = , "", tab1.pkid, "", ;) FROM tab1, tab2 WHERE tab1.col1 = tab2.col2; You can place this query in a script le and redirect input from it to the mysql command-line interpreter, piping its output back to a second instance of the interpreter: shell> mysql --skip-column-names mydb < myscript.sql | mysql mydb MySQL Server 4.0 supports multiple-table DELETEs that can be used to eciently delete rows based on information from one table or even from many tables at the same time. Multiple-table UPDATEs are also supported from version 4.0.

6.4.3 Sintaxe INSERT

INSERT [LOW_PRIORITY | DELAYED] [IGNORE] [INTO] nome_tabela [(nome_coluna,...)] VALUES ((express~o | DEFAULT),...),(...),... a [ ON DUPLICATE KEY UPDATE nome_coluna=express~o, ... ] a INSERT [LOW_PRIORITY | DELAYED] [IGNORE] [INTO] nome_tabela [(nome_coluna,...)] SELECT ... INSERT [LOW_PRIORITY | DELAYED] [IGNORE] [INTO] nome_tabela SET nome_coluna=(express~o | DEFAULT), ... a [ ON DUPLICATE KEY UPDATE nome_coluna=express~o, ... ] a

or

or

INSERT insere novos registros em uma tabela existente. A forma INSERT ... VALUES da instruo insere registros baseado em valores especicados explicitamente. A forma INSERT ca ... SELECT insere linhas selecionadas de outra(s) tabela(s). A forma INSERT ... VALUES com listas de mltiplos valores suportado a partir da verso 3.22.5. A sintaxe nome_ u e a coluna=express~o suportada a partir da vero 3.22.10 do MySQL. a e a nome_tabela a tabela na qual as linhas sero inseridas. A lista de nome das colunas ou e a a clusula SET indica para quais colunas a instruo especica valor: a ca Se voc no especicar a lista de colunas para INSERT ... VALUES ou INSERT ... e a SELECT, os valores para todas as colunas na tabela devem ser fornecidos na lista VALUES() ou pelo SELECT. Se voc no souber a ordem das colunas nas tabelas, use e a DESCRIBE nome_tabela para descobrir. Qualquer coluna que no tiver o valor fornecido explicitamente assumir o seu valor a a padro. Por exemplo, se voc especicar uma lista de colunas que no denem todas a e a as coolunas na tabela, `s colunas no denidas sero atribu a a a idos o seu valor padro. a Atribuio de valor padro denido em Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a e ca a Voc tambm pode utilizar a palavra-chave DEFAULT para atribuir o valor padro a uma e e a coluna (Novo na verso 4.0.3. do MySQL). Fica mais fcil de se escrever instrues a a co INSERT que atribuem valor a apenas algumas colunas porque ele permite que voc evite e escrever uma lista VALUES() incompleta (uma lista que no inclu um valor para cada a

580

MySQL Technical Reference for Version 5.0.0-alpha

coluna da tabela). De outa forma, voc teria que escrever a lista de nomes de colunas e correspondentes a cada valor na lista VALUES(). MySQL sempre tem uma valor padro para todos os campos. Isto algo imposto pelo a e MySQL para estar apto a funcionar com tabelas transacionais e no transcaionais. a Nossa viso que a vericao do contedo dos campos deve ser feita pela application a e ca u and not in the database server. Uma express~o pode se referir a qualquer coluna que tenha sida denaida anteriora mente na lista de valores. Por exemplo, voc pode dizer: e mysql> INSERT INTO nome_tabela (col1,col2) VALUES(15,col1*2); Mas no: a mysql> INSERT INTO nome_tabela (col1,col2) VALUES(col2*2,15); Se voc especicar a palavra chave DELAYED, o servidor coloca a linha ou linhas a e serem inseridas em um buer, e o cliente que envia a instruo INSERT DELAYED ento ca a pode contiuar. Se a tabela est ocupada, o servidor guarda a linha. Quando a tabela a ca livre, ele comea a inserir linhas, vericando peridicamente para ver se h novos c o a pedidos de leitura para a tabela. Se houver, a la de linhas atrasadas suspensa at e e que a tabela que livre de novo. Se voc especicar a palavra-chave LOW_PRIORITY, a execuo do INSERT atrasada at e ca e e que nenhum outro cliente esteja lendo a tabela. Isto inclui outros clientes que comeam c a ler enquanto clientes existentes j esto lendo e enquanto a instruo INSERT LOW_ a a ca PRIORITY est esperando. E poss a ivel, consequentemente, para um cliente que envia uma instruo INSERT LOW_PRIORITY esperar por um tempo muito longo (ou mesmo para ca sempre) em um ambiente de muita leitura. (E diferente de INSERT DELAYED, que deixa o cliente continuar de uma vez. Veja Seo 6.4.3.2 [INSERT DELAYED], Pgina 582. ca a Note que LOW_PRIORITY no deve normalmente ser usado com tabelas MyISAM ja que a elas disabilitam inseres concorrentes. Veja Seo 7.1 [MyISAM], Pgina 631. co ca a Se voc especicar a palavra-chave IGNORE em um INSERT com muitas linhas, quqlquer e linha que duplicar uma chave PRIMARY ou UNIQUE existente em uma tabela so ignorados a e no so inseridos. Se voc no especicar IGNORE, a insero abortada se houver a a e a ca e quqlquer linhq que duplique um valor de uma chave existente. Voc pode determinar e com funo mysql_info() da API C quantas linhas foram inseridas nas tabelas. ca Se voc especicar se uma clusula ON DUPLICATE KEY UPDATE (noca no MySQL 4.1.0), e a e uma linha que causasse a duplicao de um valor fosse inserida em uma chave PRIMARY ca ou UNIQUE, um UPDATE da linha antiga seria realizado. Por exemplo, o comando: mysql> INSERT INTO table (a,b,c) VALUES (1,2,3) -> ON DUPLICATE KEY UPDATE c=c+1; no caso da coluna a ser declarada como UNIQUE e ja existir o valor 1, o exemplo acima seria idntico a e mysql> UPDATE table SET c=c+1 WHERE a=1; Nota: se a coluna b tambm for unica, o comando UPDATE seria escrito como e mysql> UPDATE table SET c=c+1 WHERE a=1 OR b=2 LIMIT 1; e se a=1 OR b=2 casasse com diversas linhas, somente uma linha ser atualizada! em a geral, deve-se tentar evitar utilizar a clusula ON DUPLICATE KEY em tabelas com a mltiplas chaves UNIQUE. u

Cap tulo 6: Referncia de Linguagem do MySQL e

581

Desde o MySQL 4.1.1 pode-se utilizar a funao VALUES(nome_coluna) para se referir c ao valor da coluna na parte INSERT do comando INSERT ... UPDATE - que o valor e que seria inserido se no houvesse conitos de chaves duplicadas. Esta funo esa ca e pecialmente util em inseres de mltiplas linhas. Naturalmente a funo VALUES() co u ca s tem sentido em um comando INSERT ... UPDATE e retorna NULL no caso de outros o comandos. Exemplo: mysql> INSERT INTO table (a,b,c) VALUES (1,2,3),(4,5,6) -> ON DUPLICATE KEY UPDATE c=VALUES(a)+VALUES(b); O camondo acima e idntico a e mysql> INSERT INTO table (a,b,c) VALUES (1,2,3) -> ON DUPLICATE KEY UPDATE c=3; mysql> INSERT INTO table (a,b,c) VALUES (4,5,6) -> ON DUPLICATE KEY UPDATE c=9; A utilizar ON DUPLICATE KEY UPDATE, a opo DELAYED ignorada. ca e Se MySQL foi congurado usando a opo DONT_USE_DEFAULT_FIELDS, instrues ca co INSERT geram um erro a menos que voc especique valores explicitamete para todas e as colunas que exigem um valor no-NULL. Veja Seo 2.3.3 [Opes do configure], a ca co Pgina 98. a Voc pode encontrar o valor usado por uma coluna AUTO_INCREMENT com a funo e ca mysql_insert_id. Veja Seo 12.1.3.32 [mysql_insert_id()], Pgina 803. ca a Se voc utilizar instrues INSERT ... SELECT ou INSERT ... VALUES com lista de valores e co mltiplos, voc pode utilizar a funo mysql_info() da API C para obter informao sobre u e ca ca a consulta. O formato da string de informao mostrado aqui: ca e Records: 100 Duplicates: 0 Warnings: 0 Duplicates indica o nmero de linhas que no puderam ser inseridas porque duplicariam u a alguns valores de indices unicos existentes. Warnings indica o nmero de tentativas de u insero de um valor em uma coluna que de alguma forma estava problematico. Avisos ca (Warnings) podem ocorrer sob qualquer uma das seguintes condies: co Inserir NULL em uma coluna declarada com NOT NULL. A coluna denida com o seu e valor padro. a Denir uma coluna numrica com um valor que esteja fora da faixa permitida. O valor e revertido para nal apropriado da faixa. e Denir uma coluna numrica com um valor como 10.34 a. O lixo no nal eliminado e e e a parte numrica restante inserida. Se o valor no zer sentido como um nmero, e e a u atribuido 0 a coluna. e Inserir uma string em uma coluna CHAR, VARCHAR, TEXT, ou BLOB e que exceda o tamanho mximo da coluna. O valor truncado para o tamanho mximo da coluna. a e a Inserir um valor em uma coluna date ou time e que seja invlido para o tipo da coluna. a A coluna preenchida com o valor de zero apropriado para o tipo. e

6.4.3.1 Sintaxe INSERT ... SELECT

INSERT [LOW_PRIORITY] [IGNORE] [INTO] nome_tabela [(column list)] SELECT ...

582

MySQL Technical Reference for Version 5.0.0-alpha

Com a instruo INSERT ... SELECT voc pode inserir muitas linhas rapidamente em uma ca e tabela a partir de outras tabelas INSERT INTO tblTemp2 (fldID) SELECT tblTemp1.fldOrder_ID FROM tblTemp1 WHERE tblTemp1.fldOrder_ID > 100; As seguintes condies servem para uma instruo INSERT ... SELECT: co ca Antes do MySQL 4.0.1, INSERT ... SELECT operava implicitamente em modo IGNORE. A partir do MySQL 4.0.1, voc deve especicar IGNORE explicitamente para ignorar e registros que causaria violao de chave duplicada. ca Antes do MySQL 4.0.14, a tabela alvo da instruo INSERT no pode aparecer na ca a clusula FROM da parte SELECT da consulta. Esta limitao deixada na verso 4.0.14. a ca e a Colunas AUTO_INCREMENT funcionam da mesma forma. Em programas C, Voc pode usar a funo mysql_info() da API C para obter ine ca formao sobre a consulta. Veja Seo 6.4.3 [INSERT], Pgina 579. ca ca a Para assegurar que o log binrio possa ser usado para re-criar a tabela original, MySQL a no permitir inseres concorrentes em um INSERT ... SELECT. a a co Voc tambm pode utilizar REPLACE em vez de INSERT para sobrescrever linhas antigas. e e REPLACE a contra parte para INSERT IGNORE no tratamento de novas linhas contendo e valores de chave unicos que duplicam linhas antigas: As novas linhas so usadas para a substituir as linhas antigas em vez de descart-las. a

6.4.3.2 Sintaxe INSERT DELAYED

INSERT DELAYED ... A opo DELAYED para a instruo INSERT um opo espec ca ca e ca ica do MySQL que muito util e se voc tiver clientes que no possam esperar que o INSERT se complete. Este um problema e a e comum quando voc utiliza o MySQL para fazer log e voc tambm execute periodicamente e e e instrues SELECT e UPDATE que levem muito tempo para completar. DELAYED foi intriduzido co no MySQL verso 3.22.15. Ela uma extenso do MySQL ao SQL-92. a e a INSERT DELAYED s funciona com tabelas ISAM e MyISAM. Note que como tabelas MyISAM o suportam SELECT e INSERT concorrentes, se no houver blocos livres no meio do arquivo a de dados, voc raramente precisar utilizar INSERT DELAYED com MyISAM. Veja Seo 7.1 e a ca [MyISAM], Pgina 631. a Quando voc utiliza INSERT DELAYED, o cliente ir obter um OK de uma vez e a linha ser e a a inserida quando a tabela no estiver sendo usada por outra thread. a Outro grande beneficio do uso de INSERT DELAYED e que inseres de muitos clientes so co a empacotados juntos e escritos em um bloco. Isto muito mais rpido que se fazer muitas e a inseres seperadas. co Note que atualmente as linhas enleirdas s so armazenadas em memria at que elas o a o e sejam inseridas na tabela. Isto signica que se voc matar o mysqld com kill -9 ou se e o mysqld nalizar inesperadamente, as linhas enleiradas que no forma escritas em disco a so perdidas. a A seguir temos uma descrio em detalhes do que acontece quando voc utiliza a opo ca e ca DELAYED com INSERT ou REPLACE. Nesta descrio, a thread e a thread que recebe um ca

Cap tulo 6: Referncia de Linguagem do MySQL e

583

comando INSERT DELAYED e handler a thread que trata todas as instrues INSERT e co DELAYED de uma tabela particular. Quando uma thread executa uma instruo DELAYED em uma tabela, uma thread hanca dler criada para processar todas as instruoes DELAYED para a tabela, se tal handler e c ainda no existir. a A thread verica se o handler j adquiriu uma trava DELAYED; se no, ele diz a thread a a handler para faz-lo. A trava DELAYED pode ser obtida mesmo se outras threads tiver e uma trava de LEITURA ou ESCRITA na tabela. De qualquer forma, o handler ir esperar a por todas as travas ALTER TABLE ou FLUSH TABLES para se assegurar que a estrutura da tabela est atualizada. a A thread executa a instruo INSERT, mas em vez de escrever a linha na tabela, ela ca pe uma cpia da linha nal na la que gerenciada pela thread handler. Quaisquer o o e erros de sintaxe so noticados pela thread e relatadas ao programa cliente. a O cliente no pode relatar o nmero de duplicatas ou o valor AUTO_INCREMENT para a u a linha resultante; ele no pode obt-los do servidor, pois o INSERT retorna antes da a e operao de insero ser completada. Se voc utiliza a API C, a funo mysql_info() ca ca e ca no ir retornar nada signicante, pela mesma razo. a a a O log binrio atualizado pela thread handler quando a linha inserida na tabela. No a e e caso de insero de mltiplas linhas, o log binrio atualizado quando a primeira linha ca u a e inserida. e Depois que todas as linhas delayed_insert_limit so escrita, o handle verica se a alguma instruo SELECT est pendente. Se estiver, ele permite que ela seja executada ca a antes de continuar. Quando o handler no tiver mais linhas na la, a tabela destravada. Se nunhum coa e mando INSERT DELAYED novo recebido dentro de delayed_insert_timeout segundos, e o handler termina. Se mais que delayed_queue_size esto pendentes em uma la handler espec a ica, a thread requisitando INSERT DELAYED espera at que haja espa na la. Isto feito e co e para assegurar que o servidor mysqld no utilize toda a memria rea de memria de a o a o atraso. A thread handler ir aparecer na lista de processos do MySQL process list com a delayed_insert na coluna Command. Ela ser nalizada se voc executar um a e comando FLUSH TABLES ou mat-la com KILL thread_id. No entanto, primeiro ela a armazenar todas as linhas enleiradas na tabela antes de sair. Durante este tempo a ela no aceitar nenhum comando INSERT novo da outra thread. Se voc executar um a a e comando INSERT DELAYED depois disto, uma nova thread handler ser criada. a Note que o mostrado acima signica que o comando INSERT DELAYED tem prioridade maior que um comando INSERT normal se j houver um handler INSERT DELAYED em exa ecuo! Outro comando de atualizao ter que esperar at que a la INSERT DELAYED ca ca a e esteja vazia, algum nalize a thread handler (com KILL thread_id), ou algum exee e cute FLUSH TABLES. As seguintes variveis de estado fornecem informo sobre comandos INSERT DELAYED: a ca Varivel a Delayed_insert_threads Signicado Nmero de threads handler u

584

MySQL Technical Reference for Version 5.0.0-alpha

Delayed_writes Nmeros de linhas escrita com INSERT DELAYED u Not_flushed_delayed_ Nmero de linhas esperando para serem escritas u rows Voc pode visualizar estas variveis com a instruo SHOW STATUS ou executando um e a ca comando mysqladmin extended-status. Note que INSERT DELAYED mais lento que um INSERT normal se a tabela no estiver e a em uso. Tambm h uma sobrecarga adicional para o servidor tratar um thread separada e a para cada tabela na qual voc utiliza INSERT DELAYED. Isto signica que voc s deve usar e e o INSERT DELAYED quando voc estiver certo de necessita dele! e

6.4.4 Sintaxe UPDATE

UPDATE [LOW_PRIORITY] [IGNORE] nome_tabela SET nome_coluna1=expr1 [, nome_coluna2=expr2 ...] [WHERE defini~o_where] ca [ORDER BY ...] [LIMIT row_count] ou UPDATE [LOW_PRIORITY] [IGNORE] nome_tabela [, nome_tabela ...] SET nome_coluna1=expr1 [, nome_coluna2=expr2 ...] [WHERE defini~o_where] ca UPDATE atualiza uma coluna em registros de tabelas existentes com novos valores. A clusula a SET indica quais colunas modicar e os valores que devem ser dados. A clusula WHEREi, se a dada, especica quais linhas devem ser atualizadas. Seno todas as linhas so atualizadas. a a Se a clusula ORDER BY especicada, as linhas sero atualizada na ordem especicada. a e a Se voc especicar a palavra-chave LOW_PRIORITY, a execuo de UPDATE e atrasada at que e ca e nenhum outro cliente esteja lendo da tabela. Se voc especicar a palavra-chave IGNORE, a instruo no ser abortada memso se ns e ca a a o obtermos erros de chaves duplicadas durante a atualizao. Linhas que causem conitos ca no sero atualizadas. a a Se voc acessa um coluna de nome_tabela em uma expresso, UPDATE utiliza o valor atual e a da coluna. Por exemplo, a seguinte instruo dene a coluna age com o valor atual mais ca um: mysql> UPDATE persondata SET age=age+1; Atribuioes UPDATE so avaliadas da esquerda para a direitat. Por exemplo, a seguinte ca a instruo dobra a coluna age e ento a incrementa: ca a mysql> UPDATE persondata SET age=age*2, age=age+1; Se voc dene uma coluna ao valor que ela possui atualmente, o MySQL notar isto no e a e a ir atualiz-la. a a UPDATE retorna o nmero de linhas que forma realmente alteradas. No MySQL Verso 3.22 u a ou posterior, a funo mysql_info() da API C retorna o nmero de linhas encontradas e ca u atualizadas e o nmero de avisos que ocorreram durante o UPDATE. u

Cap tulo 6: Referncia de Linguagem do MySQL e

585

A partir do MySQL verso 3.23, voc pode utilizar LIMIT row_count para restringir o a e escopo do UPDATE. Uma clusula LIMIT funciona da seguinte forma: a Antes do MySQL 4.0.13, LIMIT uma restrio que afeta as linhas. A instruo para e ca ca assim que altera row_count linhas que satisfaam a clusula WHERE. c a Da verso 4.0.13 em diante, LIMIT uma restrio de linhas correspondentes. A ina e ca struo para assim que ela encontrar row_count linhas que satisfaam a clusula WHERE, ca c a tendo elas sido alteradas ou no. a Se uma clusula ORDER BY utilizada (dispon no MySQL 4.0.0), as linhas sero atuala e ivel a izadas nesta ordem. Isto s util em conjunto com LIMIT. oe A partir da MySQL Verso 4.0.4, voc tambm pode realizar operaes UPDATE que cobrem a e e co mltiplas tabelas: u UPDATE items,month SET items.price=month.price WHERE items.id=month.id; O exemplo mostra um inner join usando o operador de v irgula, mas instrues UPDATE co multi-tabelas podem usar qualquer tipo de join permitida na instruo SELECT, como LEFT ca JOIN. Nota: voc no pode utilizar ORDER BY ou LIMIT com multi-tabelas UPDATE. e a

6.4.5 Sintaxe DELETE

DELETE [LOW_PRIORITY] [QUICK] [IGNORE] FROM table_name [WHERE defini~o_where] ca [ORDER BY ...] [LIMIT row_count] ou DELETE [LOW_PRIORITY] [QUICK] [IGNORE] table_name[.*] [, table_name[.*] ...] FROM tabelas-referentes [WHERE defini~o_where] ca ou DELETE [LOW_PRIORITY] [QUICK] [IGNORE] FROM nome_tabela[.*] [, nome_tabela[.*] ...] USING tabelas-referentes [WHERE defini~o_where] ca DELETE deleta linhas de nome_tabela que satisfaam a condio dada por defini~o_ c ca ca where, e retorna o nmero de registros deletados. u Se voc exeecutar um DELETE sem clusula WHERE, todas as linhas so deletadas. Se voc o e a a e zer no modo AUTOCOMMIT, isto ir funcionar como TRUNCATE. Veja Seo 6.4.6 [TRUNCATE], a ca Pgina 587. No MySQL 3.23, DELETE sem uma clusula WHERE retornar zero como o a a a nmero de registros afetados. u

586

MySQL Technical Reference for Version 5.0.0-alpha

Se voc realmente quiser saber quantos registros so deletados quando voc deletar todas as e a e linhas mesmo sofrendo uma com a queda da velocidade, voc pode utilizar uma instruo e ca DELETE desta forma: mysql> DELETE FROM nome_tabela WHERE 1>0; Note que isto muito mais lento que DELETE FROM nome_tabela sem clusula WHERE, pois e a ele deleta uma linha de cada vez. Se voc especicar a palavra-chave LOW_PRIORITY, a execuo do DELETE atrasda at que e ca e e nenhum outro cliente esteja lendo da tabela. Para tabelas MyISAM, Se voc especicar a palavra QUICK, o mecanismo de armazenamento e no ir fundir os indices exclu a a idos durante a deleo, o que pode aumentar a velocidade de ca certos tipos de deleo. ca A velocidade das operaes de deleo tambm pode ser afetadas pelos fatores discutidos co ca e em Seo 5.2.12 [Delete speed], Pgina 440. ca a A opo IGNORE faz com que o MySQL ignore todos os erros durente o processo de deleo ca ca dos registros. Erros encontrados durante o estgio de anlise so processados da maneira a a a comum. Erros que so ignorados devido ao uso desta opo so retornados como aviso. a ca a Esta opo aparece pela primeira vez na verso 4.1.1. ca a Em tabelas MyISAM, registros deletados so mantidos em uma lista encadeada e operes a co INSERT subsequentes reutilizam posies de registros antigos. Para recuperar espeos co c no utilizados e reduzir o tamanho do arquivo, utilize a instruo OPTIMIZE TABLE ou a ca o utiliztrio myisamchk para reorganizar as tabelas. OPTIMIZE TABLE mais fcil, mas a e a myisamchk mais rpido. Veja Seo 4.6.1 [OPTIMIZE TABLE], Pgina 298 e Seo 4.5.6.10 e a ca a ca [Optimization], Pgina 291. a O primeiro formato de delo de multi-tabelas suportado a partir do MySQL 4.0.0. O ca e segundo formato de deleo multi-tabelas suportado a partir do MySQL 4.0.2. ca e A idia que apenas linhas coincidentes da tabelas listadas antes de FROM ou antes da e e clusula USING so deletadas. O efeito que voc pode deletar l;inhas de muitas tabelas ao a a e e mesmo tempo e tambm ter tabelas adicionais que so utilizadas para busca. e a O .* depois do nome da tabela existe apenas para ser compat com o Access: ivel DELETE t1,t2 FROM t1,t2,t3 WHERE t1.id=t2.id AND t2.id=t3.id ou DELETE FROM t1,t2 USING t1,t2,t3 WHERE t1.id=t2.id AND t2.id=t3.id No cso acima ns deletamos linhas coincidente apenas na tabela t1 e t2. o O exemplo mostra um inner join usando o operador de v irgula, mas instrues UPDATE co multi-tabelas podem usar qualquer tipo de join permitida na instruo SELECT, como LEFT ca JOIN. Se uma clusula ORDER BY utilizada (dispon no MySQL 4.0.0), as linhas sero deletadas a e ivel a naquela ordem. Isto s util se usado em conjunto com LIMIT. Por exemplo: oe DELETE FROM somelog WHERE user = jcole ORDER BY timestamp

Cap tulo 6: Referncia de Linguagem do MySQL e

587

LIMIT 1 Isto ir deletar as entradas antigas (por timestamp) onde as linhas casam com a clusula a a WHERE. A opo espec ca ica do MySQL LIMIT row_count para DELETE diz ao servidor o nmero u mximo de linhas a serem deletadas antes do controle retornar ao cliente. Isto pode ser a usado para assegurar que uma comando DELETE espec ico mo tomar muito tempo, Voc a a e pode simplesmente repetir o comando DELETE at que o nmero de linhas afetadas seja e u menor que o valor LIMIT. No MySQL 4.0, voc pode especicar mltiplas tabelas na instruo DELETE para deletar e u ca linhas de uma ou mais tabelas dependendo de uma condio particular em vrias tabelas. ca a No entanto voc no pode utilizar ORDER BY ou LIMIT em uma multi-tabela DELETE. e a

6.4.6 Sintaxe TRUNCATE

TRUNCATE TABLE nome_tabela Na verso 3.23 TRUNCATE TABLE mapeada para COMMIT; DELETE FROM table_name. Veja a e Seo 6.4.5 [DELETE], Pgina 585. ca a TRUNCATE TABLE difere de DELETE FROM ... do seguinte modo: Operaes truncate apagam e recriam a tabela, o que muito mais rpido que deletar co e a registros um a um. Operaes truncate no so seguras a transao; voc irobter um erro se voc tiver co a a ca e a e uma transao ativa ou ativar um travamento de tabela. ca O nmero de linhas apagadas no retornado. u a e Uma vez que o arquivo de denio nome_tabela.frm deja vlido, a tabela pode ser ca a recriada deta forma, mesmo se o arquivo de dados ou de indice estiver corrompido. TRUNCATE uma extenso Oracle SQL. Esta instruo foi adicionada no MySQL 3.23.28, e a ca embora da verso 3.23.28 a 3.23.32, a palavra chave TABLE deva ser omitida. a

6.4.7 Sintaxe REPLACE

REPLACE [LOW_PRIORITY | DELAYED] [INTO] nome_tabela [(nome_coluna,...)] VALUES (express~o,...),(...),... a REPLACE [LOW_PRIORITY | DELAYED] [INTO] nome_tabela [(nome_coluna,...)] SELECT ... REPLACE [LOW_PRIORITY | DELAYED] [INTO] nome_tabela SET nome_coluna=express~o, nome_coluna=express~o,... a a

ou

ou

REPLACE funciona exatamente como o INSERT, exceto que se um registro antigo na tabela tem o mesmo valor que um novo registro em um indice UNIQUE ou PRIMARY KEY, o registro antigo deletado antes que o novo registro seja inserido. Veja Seo 6.4.3 [INSERT], e ca Pgina 579. a

588

MySQL Technical Reference for Version 5.0.0-alpha

Em outras palavras, voc no pode acessar os valores do registro antigo em uma instruo e a ca REPLACE. Em algumas verses antigas do MySQL aparentemente voc podia fazer isto, mas o e era um bug que j foi arrumado. a Par aestar apto a utilizar REPLACE voc deve ter privilgios INSERT e DELETE para a tabela. e e Quando voc utilizar um comando REPLACE, mysql_affected_rows() retornar 2 se a nova e a linha substituir uma linha antiga. Isto porque uma linha foi inserida depois que a linha e duplicada foi deletada. Este fato torna fcil determinar se REPLACE adicionou ou subsitituiu uma linha: verique a se o valor de linhas afetadas 1 (adicionado) ou 2 (substituido). e Note que a menos que a tabela utilize indices UNIQUE ou PRIMARY KEY, utilizar um comando REPLACE replace no faz sentido. Ele se torna equivalente a um INSERT, porque no existe a a indice a ser usado para determinar se uma nova linha duplica outra. Seqgue aqui o algoritmo usado em mais detalhes: (Ele tambm usado com LOAD DATA ... e e REPLACE. - Insere a linha na tabela - Enquanto ocorrer erro de chave duplicada para chaves primria ou nica a u - Reverte as chaves alteradas - Le as linha conflitantes da tabela atravs do valor da chave duplicada e - Deleta as linhas conflitantes - Tenta inserir o chave primria e nica original na rvore a u a

6.4.8 Sintaxe LOAD DATA INFILE

LOAD DATA [LOW_PRIORITY | CONCURRENT] [LOCAL] INFILE file_name.txt [REPLACE | IGNORE] INTO TABLE nome_tabela [FIELDS [TERMINATED BY \t] [[OPTIONALLY] ENCLOSED BY ] [ESCAPED BY \\ ] ] [LINES [STARTING BY ] [TERMINATED BY \n] ] [IGNORE nmero LINES] u [(nome_coluna,...)] A instruo LOAD DATA INFILE l linhas de uma arquivo texto para uma tabela em uma ca e velocidade muito alta. Se a palavra-chave LOCAL especicada, ela interpretada com e e respeito ao m da conexo do cliente. Quando LOCAL especicado, o arquivo lido pelo a e e programa cliente na mquina cliente e enviada ao servidor. Se LOCAL no especicada, a a e o arquivo deve estar localizado na mquina servidora e lida diretamente pelo servidor a e (LOCAL est dispon no MySQL Verso 3.22.6 ou posterior). a ivel a Por razes de segurana, ao ler arquivos textos no servidor, os arquivos devem tambm o c e estar no diretrio de banco de dados ou serem lidos por todos. Tambm, para utilizar LOAD o e

Cap tulo 6: Referncia de Linguagem do MySQL e

589

DATA INFILE em arquivos do servidor, voc deve ter privilgio FILE na mquina servidora. e e a Veja Seo 4.3.7 [Privilgios fornecidos], Pgina 236. ca e a A partir do MySQL 3.23.49 e MySQL 4.0.2 (4.0.13 no Windows) LOCAL s funcionar se o o a seu servidor e o seu cliente forem habilitados para permitir isto. Por exemplo so o mysqld foi iniciado com --local-infile=0, LOCAL no ir funcionar. Veja Seo 4.3.4 [LOAD a a ca DATA LOCAL], Pgina 231. a Se voc especicar a palavra-chave LOW_PRIORITY, a execuo da instruo LOAD DATA e ca ca e atrasada at nenhum outro cliente estar lendo a tabela. e Se voc especicar a palavra-chave CONCURRENT com uma tabela MyISAM, outras threads e podem retornar dados da tabela enquanto LOAD DATA est executando. Utilizar esta opo a ca ir afetar o desempenho de LOAD DATA um pouco, mesmo se nenhuma outra thread utilizar a a tabela ao mesmo tempo. Utilizar LOCAL ser um pouco mais lento que deixar o servidor acessar os arquivos diretaa mente, pois o contedo do arquivo deve ser enviado pela conexo da mquina cliente at a u a a e mquina servidora. Por outro lado, voc no precisa de ter o privilgio FILE para carregar a e a e arquivos locais. Se voc estiver utilizando uma verso do MySQL anterior a 3.23.24, voc no poder ler de e a e a a um FIFO com LOAD DATA INFILE. Se voc precisar ler de um FIFO (por exemplo a sa e ida de gunzip), utilize LOAD DATA LOCAL INFILE. Voc tambm pode carregar arquivo de dados utilizado o utilitrio mysqlimport; ele opera e e a enviando um comando LOAD DATA INFILE para o servidor. A opo --local faz com que ca mysqlimport leia ao arquivo de dados a partir da mquina cliente. Voc pode especicar a e a opo --compress para conseguir melhor desempenho sobre redes lentas se o cliente e o ca servidor suportar protocolos compactados. Ao localizar arquivos na mquina servidora, o servidor utiliza as segintes regras: a Se um caminho absoluto dado, o servidor utiliza o caminho desta forma. e Se um caminho relativo com um ou mais componentes dados, o servidor busca o e arquivo em relao ao diretrio de dados do servidor. ca o Se um nome de arquivo sem nenhum componente dado, o servidor procura pelo e arquivo no diretorio de banco de dados do banco de dados atual. Note que estas regras signicam que um arquivo chamado ./myfile.txt lido no diretrio e o de dados do servidor, enquanto um arquivo chamado myfile.txt l o diretrio de dados do e o naco de dados atual. Por exemplo, a seguinte instruo LOAD DATA l o arquivo data.txt ca e do diretrio de dados de db1 pois db1 o banco de dados atual, mesmo que a instruo o e ca carrega explicitamente o arquivo em uma tabela no banco de dados db2: mysql> USE db1; mysql> LOAD DATA INFILE "data.txt" INTO TABLE db2.my_table; As palavras-chave REPLACE e IGNORE controlam o tratamento de entrada de registros que duplicam linhas existentes em valores de chave unica. Se voc especicar REPLACE, as linhas inseridas substituiro as linhas existentes (em outras e a palavras, linhas que tiverem o mesmo valor de um indice primrio ou unico como linhas a existentes). Veja Seo 6.4.7 [REPLACE], Pgina 587. ca a

590

MySQL Technical Reference for Version 5.0.0-alpha

Se voc especicar IGNORE, registros inseridos que duplicam uma linha existente em um e valor de chave unica ser ignorados. Se voc no especicar nenhuma das opes, o com a e a co portamento depende de se a palavra chave LOCAL especicada ou no. Sem LOCAL, um erro e a ocorre quando um valor de chave duplicada encontrado, e o resto do arquivo texto ignoe e rado. Com LOCAL o comportamento padro o mesmo de quando IGNORE for especicado, a e isto porque o servidor no tem como parar no meio da operao. e a ca Se voc quiser ignorar as restries de chaves estrangeiras durante a carga voc pode faze e co e SET FOREIGN_KEY_CHECKS=0 antes de executar LOAD DATA. Se voc utiliza LOAD DATA INFILE em uma tabela MyISAM vazia, todos os e indices no-nicos a u so criados em um batch separado (como em REPAIR). Isto normalmente torna LOAD DATA a INFILE muito mais rpido quando voc tem diversos a e indices. Normalmente isto muito e rpido mas em casos extremos voc pode tornar o a e indice mais rpido ainda desligando-os a com ALTER TABLE .. DISABLE KEYS e usando ALTER TABLE .. ENABLE KEYS para recriar os indices. Veja Seo 4.5.6 [Manuteno de tabelas], Pgina 280. ca ca a LOAD DATA INFILE o complemento de SELECT ... INTO OUTFILE. Veja Seo 6.4.1 e ca [SELECT], Pgina 562. Para gravar dados de uma tabela em um arquivo, use SELECT ... a INTO OUTFILE. Para ler o arquivo de volta em uma tabela, use LOAD DATA INFILE. A sintaxe das clusulas FIELDS e LINES a mesma para ambos os comandos. Ambas as a e clusulas so opicionais, mas FIELDS deve preceder LINES se ambos so especicados. a a a Se voc especicar uma clusula FIELDS, cada uma das subclusulas (TERMINATED BY, e a a [OPTIONALLY] ENCLOSED BY, e ESCAPED BY) tambm so opicionais, exceto pelo fato de e a que voc deve especicar pelo menos uma delas. e Se voc no especicar uma clusula FIELDS, o padro o mesmo que se voc tivesse escrito e a a a e e isto: FIELDS TERMINATED BY \t ENCLOSED BY ESCAPED BY \\ Se voc no especicar uma clusula LINES, o padro o mesmo que se voc tivesse escrito e a a a e e isto: LINES TERMINATED BY \n Nota: Se voc gerou o arquivo texto no Windows, voc deve alterar o mostrado acima para: e e LINES TERMINATED BY \r\n j que o Windows utiliza dois caracteres como um terminador a de linha. Alguns programas como wordpad, pode usar \r como terminador de linha. Se todas as linas que voc deseja ler tem um prexo comum que voc quer saltar, voc pode e e e usar LINES STARTING BY prefix_string. Em outras palavras, o padro faz com que LOAD DATA INFILE funcione da seguinte maneira a ao se ler uma entrada: Procure pelo limite da linha em linhas novas. Se LINES STARTING BY prefix for usado, l at que o prexo seja encontrado e comea e e c a ler o caracter seguinte ao prexo. Se a linha no inclui o preco e;a ser saltada. a a Quebre a linha em campos na tabulaes. co No espere que os campos estejam entre aspas. a Interprete a ocorrncia de tabulaes, novas linhas ou \ precedidos por \ como e co caracteres literias que so parte dos valores dos campos. a

Cap tulo 6: Referncia de Linguagem do MySQL e

591

Inversamente, os padres fazem SELECT ... INTO OUTFILE funcionar da seguinte forma ao o escrever as sa idas: Escreva tabulaes entre os campos. co No coloque campos entre aspas. a Utilize \ para considerar como parte dos campos instncias de tabulao, nova linha a ca ou \ que estejam dentro dos valores dos campos. Escreva novas linhas no m de cada linha. Note que para escrever FIELDS ESCAPED BY \\, voc deve especicar duas barras invere tidas para que o valor seja lido como uma unica barra invertida. A opo IGNORE nmero LINES pode ser utilizado para ignorar linhas no inicio do arquivo. ca u Por exemplo, voc pode usar IGNORE 1 LINES para saltar uma linha de cabealho contendo e c nomes de colunas: mysql> LOAD DATA INFILE "/tmp/file_name" INTO TABLE test IGNORE 1 LINES; Quando voc utiliza SELECT ... INTO OUTFILE em conjunto com LOAD DATA INFILE para e escrever os dados de um banco de dados em um arquivo e ento ler o arquivo de volta no a banco de dados posteriormente, as opes para tratamento de linhas e campos para ambos co os comandos devem coincidir. Seno, LOAD DATA INFILEno ir interpretar o contedo do a a a u arquivo de forma apropriada. Suponha que voc utilize SELECT ... INTO OUTFILE para e escrever um arquivo com os campos separados por v irgulas: mysql> SELECT * INTO OUTFILE data.txt -> FIELDS TERMINATED BY , -> FROM ...; Para ler o arquivo delimitado com v irgula de volta, a instruo correta seria: ca mysql> LOAD DATA INFILE data.txt INTO TABLE table2 -> FIELDS TERMINATED BY ,; Se voc tentasse ler do arquivo com a instruo abaixo, no iria funcionar pois ela instrui e ca a LOAD DATA INFILE a procurar por tabulaes entre campos: co mysql> LOAD DATA INFILE data.txt INTO TABLE table2 -> FIELDS TERMINATED BY \t; O resultado desejado que cada linha de entrada fosse interpretada como um unico campo. e LOAD DATA INFILE pode ser usado para ler arquivos obtidos de fontes externas. Por exemplo, um arquivo no formato dBASE ter campos separados por v a irgulas e entre aspas duplas. Se as linhas no arquivo so terminadas por com uma nova linha, o comando mostardo aqui a ilustra as opes do tratamento de campos e linhas que voc usaria pra carregar o arquivo. co e the le: mysql> LOAD DATA INFILE data.txt INTO TABLE nome_tabela -> FIELDS TERMINATED BY , ENCLOSED BY " -> LINES TERMINATED BY \n; Qualquer uma das opes de tratamento de campos e linhas podem especicar uma string co vazia (). Se no for vazio, os valores de FIELDS [OPTIONALLY] ENCLOSED BY e FIELDS a ESCAPED BY devem ser um caracter simples. Os valores de FIELDS TERMINATED BY e LINES

592

MySQL Technical Reference for Version 5.0.0-alpha

TERMINATED BY podem ser mais de uma caracter. Por exemplo, para escrever linhas terminadas pelos par retorno de carro/alimentao de linha, ou para ler um arquivo contendo ca tais linhas, especique uma clusula LINES TERMINATED BY \r\n. a Por exemplo, para ler um arquivo de piadas, que so separadas com uma linha de %%, em a uma tabela SQL, voc pode fazer: e CREATE TABLE jokes (a INT NOT NULL AUTO_INCREMENT PRIMARY KEY, joke TEXT NOT NULL); LOAD DATA INFILE "/tmp/jokes.txt" INTO TABLE jokes FIELDS TERMINATED BY "" LINES TERMINATED BY "\n%%\n" (joke); FIELDS [OPTIONALLY] ENCLOSED BY controla a citao dos campos. Para saida (SELECT ca ... INTO OUTFILE), se voc omitir a palavra OPTIONALLY, todos os campos estaro entra e a o caracter ENCLOSED BY. Um exemplo de tal sa (usando v ida irgula como delimitador de campo) mostrado abaixo: e "1","a "2","a "3","a "4","a string","100.20" string containing a , comma","102.20" string containing a \" quote","102.20" string containing a \", quote and comma","102.20"

Se voc especicar OPTIONALLY, o caracter ENCLOSED BY s usados para delimitar campos e oe CHAR e VARCHAR: 1,"a 2,"a 3,"a 4,"a string",100.20 string containing a , comma",102.20 string containing a \" quote",102.20 string containing a \", quote and comma",102.20

Note que a ocorrncia de caracter ENCLOSED BY dentro do valor do campo indicado coloe e cando um caracter ESCAPED BY antes dele. Note tambm que se voc especicar um valor e e ESCAPED BY vazio, poss e ivel gerar sa idas que no podero ser lidas aprorpiadamente por a a LOAD DATA INFILE. Por exemplo, a sa mostrada seria apareceria como a seguir se o carida acter de escape fosse vazio. Observe que o segundo campo na quarta linha contm uma e v irgula seguida de aspas, o que (erroneamente) parece terminar o campo: 1,"a 2,"a 3,"a 4,"a string",100.20 string containing a , comma",102.20 string containing a " quote",102.20 string containing a ", quote and comma",102.20

Para entrada, o caracter ENCLOSED BY, se presente, ser eliminado do m dos valores dos a campos. (Isto verdade se OPTIONALLY for especicado; OPTIONALLY no tem efeito na e a interpretao da entrada). A ocorrncia de caracteres ENCLOSED BY precedido pelo caracter ca e ESCAPED BY so interpretados como parte do campo atual. a Se o campo comea com o caracter ENCLOSED BY, instncias daquele caracter so reconhecic a a dos como terminao de um valor do campo apenas se seguido pelo campo ou sequncia de ca e linah TERMINATED BY. Para evitar ambiguidade, ocorrncias do caracter ENCLOSED BY dene tro de um valor de campo pode ser duplicado e ser interpretado como uma unica instncia a a do caracter. Por exemplo, se ENCLOSED BY " for especicado, aspas sero tratadas como a mostrado abaixo: "The ""BIG"" boss" -> The "BIG" boss

Cap tulo 6: Referncia de Linguagem do MySQL e

593

The "BIG" boss -> The "BIG" boss The ""BIG"" boss -> The ""BIG"" boss FIELDS ESCAPED BY controla como escrever ou ler caracteres especiais. Se o caracter FIELDS ESCAPED BY no estivaer vazio, ele ser usado para preceder o seguinte caracter de sa a a ida: O caracter FIELDS ESCAPED BY O caracter FIELDS [OPTIONALLY] ENCLOSED BY O primeiro caracter dos valores FIELDS TERMINATED BY e LINES TERMINATED BY ASCII 0 (o que escrito seguido de um caracter de escape ASCII 0, no o byte de e e a valor zero). Se o caracter FIELDS ESCAPED BY estiver vazio, nenhum caracter ser escapado. Provavela mente no uma boa idia especicar um caracter de escape vazio, principalmente se os a e e valores dos campos em seus conter qualquer caracter na lista dada. Para entradas, se o caracter FIELDS ESCAPED BY no estiver vazio, as ocorrncias daquele a e caracter so eliminadas e o caracter seguinte tomado como parte do valor do campo. As a e excees so um 0 ou N escapado (por exemplo, \0 ou \N se o caracter de escape for co a \). Estas sequencias so interpretadas como os ASCII 0 (um byte de valor zero) e NULL. a Veja abaixo as regras no tratamento de NULL. Para maiores informaes sobre a sintaxe \-escape, veja Seo 6.1.1 [Literals], Pgina 469. co ca a Em certos casos, as opes de tratamento de campoe e linhas se interagem: co Se LINES TERMINATED BY uma string vazia e FIELDS TERMINATED BY no vazio, as e a e linhas tambm sero terminadas com FIELDS TERMINATED BY. e a Se os valores FIELDS TERMINATED BY e FIELDS ENCLOSED BY so ambos vazios (), um a formato de linha de tamanhos xos (sem delimitadores) utilizada. Com formato de e linhas de tamanho xo, nenhum deliitador usado entre os campos (mas voc ainda e e pode ter um terminador de linha). Valores de colunas so escritos e lidos usando o a tamanho denido das colunas. Por exemplo, se uma coluna declarada como INT(7), e os valores das colunas so escritos utilizando campos de 7 caracteres. Na sa a ida, os valores das colunas so obtidos lendo 7 caracteres. a LINES TERMINATED BY ainda usado para separar linhas. Se uma linha no contm e a e todos os campos, o resto dos campos sero congurados com o seu valor padro. Se a a voc no tiver um terminador de linha, voc deve deni-lo com . Neste caso o arquivo e a e texto deve conter todos os campos para cada linha. O formato de linhas de tamanho xo tambm afetam o tratamento de valores NULL; e veja abixo. Note que este formato no funciona se voc estiver utilizando um conjunto a e de caracteres mulyi-byte. O tratamento do valor NULL varia, dependendo das opes de FIELDS e LINES que voce co usar: Para os valores FIELDS e LINES padres, NULL escrito como \N para sa e \N lido o e ida e como NULL para as entradas (assumindo que o caracter ESCAPED BY \). e Se FIELDS ENCLOSED BY no for vazio, um campo contendo a palavra literal NULL como a seu valor lido como um valor NULL (isto difere da palavra NULL entre os caracteres e FIELDS ENCLOSED BY, a qual lida como a string NULL). e Se FIELDS ESCAPED BY for vazio, NULL escrito como a palavra NULL. e

594

MySQL Technical Reference for Version 5.0.0-alpha

Com os formatos de tamanho xos (que acontecem quando FIELDS TERMINATED BY e FIELDS ENCLOSED BY estiverem ambos vazios), NULL escrito como uma string vazia. e Note que isto faz com que os valores NULL e uma string vazia na tabela sero indista ing uiveis quando escritas no arquivo pois elas so ambas escritas como strings vazias. a Se voc precisar estar saber diferenciar as duas ao ler o arquivo de volta, voc no deve e e a utilizar o formato de tamanho xo. Alguns casos no so suportados por LOAD DATA INFILE: a a Linhas de tamanho xo (FIELDS TERMINATED BY e FIELDS ENCLOSED BY vazios) e colunas BLOB ou TEXT. Se voc especicar um separador que igual ao prexo do outro, LOAD DATA INFILE e e no poder interpretar a entratada apropriadamente. Por exemplo, a seguinte clusula a a a FIELDS causaria problemas: FIELDS TERMINATED BY " ENCLOSED BY " Se FIELDS ESCAPED BY estiver vazio, um valor de campo que contm uma ocorrncia de e e FIELDS ENCLOSED BY ou LINES TERMINATED BY seguido por valores FIELDS TERMINATED BY far com que LOAD DATA INFILE pare de ler um campo ou linha antes do esperado. a Isto ocorre porque LOAD DATA INFILE no pode determinar apropriadamente onde o a valor de campo ou linha acaba. A oseguinte exemplo carrega todas as colunas da tablea persondata: mysql> LOAD DATA INFILE persondata.txt INTO TABLE persondata; Nenhuma lista de campo especicada, assim LOAD DATA INFILE espera linhas de entradas e que contenha um campo para cada coluna da tabela. Os valores padres de FIELDS e LINES o so usados. a Se voc deseja carregar somente algumas das colunas das tabelas, especique uma lista de e campos: mysql> LOAD DATA INFILE persondata.txt -> INTO TABLE persondata (col1,col2,...); Voc deve especicar uma lista de campos se a ordem dos campos no arquivo de entrada e diferem da ordem das colunas na tabela. Seno o MySQL no poder dizer como combinar a a a os campos da entrada nas colunas da tabela. Se uma linha tiver poucos campos, as colunas para os quais o campo de entrada no esa tiverem presentes sero denidas com o valor padro. Atribuio de valor padro descrito a a ca a e em Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a Um valor de campo vazio interpretado de forma diferente de que se o valor do campo e estiiver faltando: Para tipos string, a coluna denida com uma string vazia. e Para tipos numricos, a coluna denida com 0. e e Para tipos de data e hora, a coluna denida com o valor zero apropriado para o e tipo. Veja Seo 6.2.2 [Tipos date e time], Pgina 489. ca a Note que estes so os mesmos valores que resultam se voc atribuir uma string vazia exa e plicitamente a um tipo string, numrico, de data ou de hora em uma instruo INSERT ou e ca UPDATE.

Cap tulo 6: Referncia de Linguagem do MySQL e

595

Colunas TIMESTAMP s so denidas com a hora e data atual se houver um valor NULL para o a a coluna (isto , \N), ou (apenas para a primeira coluna TIMESTAMP) se a coluna TIMESTAMP e esta a esquerda da lista de campos quando esta for especicada. Se uma linha de entrada tiver muitos campos, os campos extras sero ignorados e o nmero a u de avisos incrementado. Note que antes do MySQL 4.1.1 o aviso apenas um nmero que e e u indica que alguma coisa deu errado. No MySQL 4.1.1 voc pode fazer SHOW WARNINGS para e obter mais informaes sobre o que deu errado. co LOAD DATA INFILE considera todas as entradas como strings, assim voc no pode utiliar e a valores numricos para colunas ENUM ou SET do mesmo modo que voc pode com instrues e e co INSERT. Todos os valores ENUM e SET devem ser espec icados como strings! Se voc estiver usando a API C, voc pode obter informaes sobre a consulta chamando a e e co funo mysql_info() da API C quando a consulta LOAD DATA INFILE terminar. O formato ca da string de informao mostrado aqui: ca e Records: 1 Deleted: 0 Skipped: 0 Warnings: 0 Avisos ocorrem sob as mesmas circuntncias que quando so inseridos via instruo INSERT a a ca (veja Seo 6.4.3 [INSERT], Pgina 579), exceto que LOAD DATA INFILE tambm gera avisos ca a e quando houver poucos ou muitos campos na linha de entrada. Os avisos no so armazenaa a dos em nenhum local; o nmero de avisos s pode ser utilizado como uma indicao se tudo u o ca correr bem. Se voc obter avisos e quiser saber exatamente porque eles ocorreram, um modo de se e fazer isto utilizar SELECT ... INTO OUTFILE em outro arquivo e campor-lo ao arquivo de e a entrada original. Se voc precisar que LOAD DATA leia de um pipe, voc pode utilizar o seguinte truque: e e mkfifo /mysql/db/x/x chmod 666 /mysql/db/x/x cat < /dev/tcp/10.1.1.12/4711 > /nt/mysql/db/x/x mysql -e "LOAD DATA INFILE x INTO TABLE x" x Se voc estiver usando uma verso do MySQL a anterior a 3.23.25 voc s poder fazer o e a e o a descrito acima com LOAD DATA LOCAL INFILE. No MySQL 4.1.1 voc pode usar SHOW WARNINGS para conseguir a lista do primeiros max_ e error_count avisos. Veja Seo 4.6.8.9 [SHOW WARNINGS], Pgina 323. ca a Para mais informaes sobre a ecincia de INSERT versus LOAD DATA INFILE e a melhora co e na velocidade de LOAD DATA INFILE, Veja Seo 5.2.10 [Velocidade da insero], Pgina 438. ca ca a

6.4.9 Sintaxe HANDLER

HANDLER nome_tabela OPEN [ AS alias ] HANDLER nome_tabela READ nome_indice { = | >= | <= | < } (valor1,valor2,...) [ WHERE ... ] [LIMIT ... ] HANDLER nome_tabela READ nome_indice { FIRST | NEXT | PREV | LAST } [ WHERE ... ] [LIMIT ... ] HANDLER nome_tabela READ { FIRST | NEXT } [ WHERE ... ] [LIMIT ... ] HANDLER nome_tabela CLOSE

596

MySQL Technical Reference for Version 5.0.0-alpha

A instruo HANDLER fornece acesso direto a interface do mecanismo de armazenamento de ca tabelas MyISAM. A primeira forma da instruo HANDLER abre uma tabela, tornando a acess atravs de ca ivel e subsequentes instrues HANDLER ... READ. Este objeto de tabela no copartilhada com co a e outras threads e no sero fechadas at que as chamadas de thread HANDLER nome_tabela a a e CLOSE ou a thread termine. A segunda forma busca um registro (ou mais, especicado pela clusula LIMIT) onde o a indice especicado satisfaz os valores dados e a condio WHERE encontrada. Se voc tiver um ca e e indice multi-coluna, especique as colunas do indice como uma lista separadas por v irgulas. Especique o valor de todas as colunas no indice, ou especique valores para o prexo mais a esquerda das colunas indices. Suponha que um indice inclui trs colunas chamadas col_a, e col_b, e col_c, nesta ordem. A instruo HANDLER pode especicar valores para todas as ca trs colunas no e indice, ou para as colunas no prexo mais a esquerda. Por exemplo: HANDLER ... index_name = (col_a_val,col_b_val,col_c_val) ... HANDLER ... index_name = (col_a_val,col_b_val) ... HANDLER ... index_name = (col_a_val) ... A terceira forma busca uma linha (ou mais, especicado pela clusula LIMIT) da tabela na a ordem do indice, correspondendo a condio WHERE. ca A quarta forma (sem especicao de indice) busca um registro (ou mais, especicado pela ca clusula LIMIT) da tabela na ordem natural da linhas (como armazenado no arquivo de a dados) de acordo com a condio WHERE mais rpido que HANDLER nome_tabela READ ca e a nome_indice quando necessria uma varredura completa da tabela. e a HANDLER ... CLOSE fecha uma tabela que foi aberta com HANDLER ... OPEN. Nota: Se voc estiver utilizando a interface HANDLER para PRIMARY KEY voc deve se lembrar e e de colocar o nome entre aspas: HANDLER tbl READ PRIMARY > (...) HANDLER uma instruo de baixo n e ca ivel. Por exemplo, ela no fornece consitncia. Isto , a e e HANDLER ... OPEN NAO pega uma imagem instntanea da tabela, e NAO trava a tabela. a Isto signica que depois que um HANDLER ... OPEN feito, os dados da tabela podem e ser modicados (por esta ou outra thread) e estas modicaes podem aparecer apenas co parcialmente nas buscas HANDLER ... NEXT ou HANDLER ... PREV. As razes para se utilizar esta interface em vez do SQL normal so: o a Ela mais rpida que SELECT porque: e a Um mecanismo de armazenamento designado alocado pela thread em HANDLER e OPEN. Existe menos anlise envolvida. a N`o existe sobrecaga de otimizao e vericao de consultas. a ca ca A tabela utilizada no precisa estar travada em pedidos de dois handlers. a A interface handler no precisa fornecer uma aprncia consistente dos dados (por a e exemplo, dirty-reads so permitidas), assim o mecanismo de armazenamento pode a fazer otimizaes que o SQL normalmente no permite. co a E muito mais fcil portar aplicaes que usam interface como ISAM para o MySQL. a co Ele permite se fazer uma travessia em um banco de dados de uma maneira que no a e facil (em alguns casos impossivel) de fazer com SQL. A interface handler um modo e

Cap tulo 6: Referncia de Linguagem do MySQL e

597

mais natural de mostrar dados ao trabalhar com aplicaes que fornecem uma interface co interativa com o usurio para o banco de dados. a

6.4.10 Sintaxe DO
DO express~o, [express~o, ...] a a Executa a expresso mas no retorna nenhum resultado. Este um modo curto de SELECT a a e express~o, express~o, mas tem a vantagem de ser rpida quando voc no se preocupa a a a e a com o resultado. Ele util principalmente com funes que tem efeitos em um dos lados, como RELEASE_LOCK. e co

6.5 Denio de Dados: CREATE, DROP e ALTER ca

6.5.1 Sintaxe CREATE DATABASE
CREATE DATABASE [IF NOT EXISTS] nome_bd CREATE DATABASE cria um banco de dados com o nome dados. As regras para os nomes de banco de daddos permitidos so daods em Seo 6.1.2 [Legal a ca names], Pgina 472. Um erro ocorre se o banco de dados j existir e voc no especicou a a e a IF NOT EXISTS. Banco de dados no MySQL so implementados como diretrios contendo arquivos que cora o respondem a tabelas no banco de dados. Por no haver tabelas em um banco de dados a quando ele criado, a instruo CREATE DATABASE apenas cria um diretrio sob o diretrio e ca o o de dados do MySQL. Voc tambm pode criar banco de dados com mysqladmin. Veja Seo 4.9 [Scripts do Lado e e ca do Servidor], Pgina 345. a

6.5.2 Sintaxe DROP DATABASE

DROP DATABASE [IF EXISTS] nome_bd DROP DATABASE deleta todos as tabelas no banco de dados e deleta o banco de dados. Se voc zer um DROP DATABASE em um banco de dados ligado simbolicamente, o link e o banco e de dados original so deletados. Tenha cuidado com este comando! a DROP DATABASE retorna o nmero de arquivos que foram removidos do diretorio de banco u de dados. Para tabelas MyISAM, isto trs vezes o nmero de tabelas, pois cada tabela e e u corresponde a um arquivo .MYD, um arquivo .MYI e um arquivo .frm. O comando DROP DATABASE remove do diretrio de banco de dados dado todos os arquivos o com a seguinte extenso: a Ext Ext Ext Ext .BAK .DAT .HSH .ISD .ISM .ISM .MRG .MYD .MYI .db .frm Todos os subdiretrios que consistem de 2 digitos (diretrios RAID) tambm so removidos. o o e a

598

MySQL Technical Reference for Version 5.0.0-alpha

No MySQL Verso 3.22 ou posterior, voc pode utilizar a palavra chave IF EXISTS para a e prevenir da ocorrncia de um erro se o banco de dados no existir. e a Voc tambm pode deletar um banco de dados com mysqladmin. Veja Seo 4.9 [Scripts e e ca do Lado do Servidor], Pgina 345. a

6.5.3 Sintaxe CREATE TABLE

CREATE [TEMPORARY] TABLE [IF NOT EXISTS] nome_tabela [(defini~o_create,...)] ca [table_options] [select_statement] ou CREATE [TEMPORARY] TABLE [IF NOT EXISTS] nome_tabela [(]LIKE nome_antigo_tabela[)]; defini~o_create: ca nome_coluna tipo [NOT NULL | NULL] [DEFAULT valor_padr~o] [AUTO_INCREMENT] a [[PRIMARY] KEY] [COMMENT string] [defini~o_refer^ncia] ca e | [CONSTRAINT [symbol]] PRIMARY KEY (index_col_name,...) | KEY [nome_indice] (index_nome_coluna,...) | INDEX [nome_indice] (index_nome_coluna,...) | [CONSTRAINT [symbol]] UNIQUE [INDEX] [index_name] (index_col_name,...) | FULLTEXT [INDEX] [nome_indice] (index_nome_coluna,...) | [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (index_col_name,...) [defini~o_refer^ncia] ca e | CHECK (expr) tipo: | | | | | | | | | | | | | | | | | | | TINYINT[(tamanho)] [UNSIGNED] [ZEROFILL] SMALLINT[(tamanho)] [UNSIGNED] [ZEROFILL] MEDIUMINT[(tamanho)] [UNSIGNED] [ZEROFILL] INT[(tamanho)] [UNSIGNED] [ZEROFILL] INTEGER[(tamanho)] [UNSIGNED] [ZEROFILL] BIGINT[(tamanho)] [UNSIGNED] [ZEROFILL] REAL[(tamanho,decimais)] [UNSIGNED] [ZEROFILL] DOUBLE[(tamanho,decimais)] [UNSIGNED] [ZEROFILL] FLOAT[(tamanho,decimais)] [UNSIGNED] [ZEROFILL] DECIMAL(tamanho,decimais) [UNSIGNED] [ZEROFILL] NUMERIC(tamanho,decimais) [UNSIGNED] [ZEROFILL] CHAR(tamanho) [BINARY | ASCII | UNICODE] VARCHAR(tamanho) [BINARY] DATE TIME TIMESTAMP DATETIME TINYBLOB BLOB MEDIUMBLOB

Cap tulo 6: Referncia de Linguagem do MySQL e

599

| | | | | | |

LONGBLOB TINYTEXT TEXT MEDIUMTEXT LONGTEXT ENUM(value1,value2,value3,...) SET(value1,value2,value3,...)

index_nome_coluna: nome_coluna [(tamanho)] [ASC | DESC] defini~o_refer^ncia: ca e REFERENCES nome_tabela [(index_nome_coluna,...)] [MATCH FULL | MATCH PARTIAL] [ON DELETE op~o_refer^ncia] ca e [ON UPDATE op~o_refer^ncia] ca e op~o_refer^ncia: ca e RESTRICT | CASCADE | SET NULL | NO ACTION | SET DEFAULT op~es_tabela: table_option [table_option] ... co op~es_tabela: co TYPE = {BDB | HEAP | ISAM | InnoDB | MERGE | MRG_MYISAM | MYISAM } | AUTO_INCREMENT = # | AVG_ROW_LENGTH = # | CHECKSUM = {0 | 1} | COMMENT = string | MAX_ROWS = # | MIN_ROWS = # | PACK_KEYS = {0 | 1 | DEFAULT} | PASSWORD = string | DELAY_KEY_WRITE = {0 | 1} | ROW_FORMAT = { DEFAULT | DYNAMIC | FIXED | COMPRESSED } | RAID_TYPE = { 1 | STRIPED | RAID0 } RAID_CHUNKS=# RAID_CHUNKSIZE=# | UNION = (table_name,[table_name...]) | INSERT_METHOD = { NO | FIRST | LAST } | DATA DIRECTORY = caminho absluto para o diretrio o | INDEX DIRECTORY = caminho absluto para o diretrio o | DEFAULT CHARACTER SET character_set_name [COLLATE collation_name] instru~o_select: ca [IGNORE | REPLACE] [AS] SELECT ...

(Alguma instru~o vlida) ca a

CREATE TABLE cria uma tabela com op nome dado no banco de dados atual.

600

MySQL Technical Reference for Version 5.0.0-alpha

As regras para nomes de tabelas permitidos so dados em Seo 6.1.2 [Legal names], a ca Pgina 472. Por padro a tabela criada no banco de dados atual. Um erro ocorre se a a e no houver o banco de dados atual ou se a tabela j existir. a a No MySQL Verso 3.22 ou posterior, o nome de tabela pode ser especicado como nome_ a bd.nome_tabela para criar a tabela em um banco de dados espec ico. Ele funciona sem se preoocupar se existe um banco de dados atual. A partir do MySQL Verso 3.23, voc pode usar a palavra-chave TEMPORARY qaundo voc a e e criar uma tabela. A tabela temporria vis a e ivel apenas a para a conexo atual, e ser a a automaticamente deletada quando a conexo fechada. Isto signica que duas conexes a e o diferentes podem usar o mesmo nome de tabela temporria sem conitos outras ou com a uma tabela existente com o mesmo nome. (A tabela existente escondida at que a tabela e e temporria seja deletada). A partir do MySQL 4.0.2 voc deve ter o privilgio CREATE a e e TEMPORARY TABLES para poder criar tabelas temporrias. a No MySQL Verso 3.23 ou posterior voc pode utilizar as palavras-chaves IF NOT EXISTS a e para que no ocorra um erro se a tabela j existir. Note que no h vericao de que a a a a a ca tabela existente tem uma estrutura idntica a aquela indicada pela instruo CREATE TABLE e ca A partir da verso 4.1.0, o atributo SERIAL pode ser usado com um alias para BIGINT NOT a NULL AUTO_INCREMENT UNIQUE. Este um recuros para compatibilidade. e Como no MySQL 3.23, voc pode criar uma tabela de autra adicionando uma instruo e ca SELECT no m da instruo CREATE TABLE: ca CREATE TABLE new_tbl SELECT * FROM orig_tbl; Os indices no so transportados para a nova tabela, e algumas converses de tipos de a a o coluna podem ocorrer. Por exemplo, o atributoAUTO_INCREMENT no est preservado e a a colunas VARCHAR podem se tornar colunas CHAR. Quando criar uma tabela com CREATE ... SELECT, de um apelido para qualquer chamada de funo ou expresses em uma consulta. Se voc no o zer, a instruo CREATE pode ca o e a ca falhar ou resultar em nomes de colunas indesejveis. a CREATE TABLE artists_and_works SELECT artist.name, COUNT(work.artist_id) AS number_of_works FROM artist LEFT JOIN work ON artist.id = work.artist_id GROUP BY artist.id; No MySQL 4.1, voc pode especicar explicitamente o tipo para uma coluna gerada: e CREATE TABLE foo (a tinyint not null) SELECT b+1 AS a FROM bar; No MySQL 4.1 voc pode utilizar LIKE para criar uma tabela baseada em uma denio de e ca outra tabela. No MySQL 4.1 voc tambm pode especicar o tipo para uma coluna gerada: e e CREATE TABLE new_tbl LIKE orig_tbl; Cada tabela nome_tabela representada por algum arquivo no diretrio de banco de dados. e o No caso das tabelas tipo MyISAM voc ir obter: e a CREATE TABLE ... LIKE no copia nenhuma opo de tabela DATA DIRECTORY ou INDEX a ca DIRECTORY que foi especicada para a tabela original. Arquivo nome_tabela.frm Proposito Arquivo de formato (denio) da tabela. ca

Cap tulo 6: Referncia de Linguagem do MySQL e

601

nome_tabela.MYD nome_tabela.MYI

Arquivo de dados Arquivo Indice

Para mais informaes de propriedades de varios tipo de coluna, veja Seo 6.2 [Column co ca types], Pgina 482: a Se nem NULL nem NOT NULL for especicado, a coluna tratada como se NULL fosse e especicado. Uma coluna integer pode ter o atributo adicional AUTO_INCREMENT. Quando voc insere e um valor de NULL (recomendado) ou 0 em uma coluna AUTO_INCREMENT indexada, a coluna denida com o valor da prxima sequncia. Normalmente ele valor+1, onde e o e e valor o maior valor para a coluna column atualmente na tabela. A sequncia de AUTO_ e e INCREMENT comea com 1. Veja Seo 12.1.3.32 [mysql_insert_id()], Pgina 803. c ca a A partir do MySQL 4.1.1, especicando o parmetro NO_AUTO_VALUE_ON_ZERO para a a opo do servidor --sql-mode ou a varivel do servidor sql_mode permite que voc ca a e aramzene 0 nas colunas AUTO_INCREMENT como 0, em vez de gerar uma nova sequncia e de valores. Veja Seo 4.1.1 [Command-line options], Pgina 207. ca a Se voc deletar a linha contendo o valor mximo para uma coluna AUTO_INCREMENT, e a o valor ser reutilizado por uma tabela ISAM, ou BDB, mas no por tabelas MyISAM a a ou InnoDB. Se voc deletar todas as linhas na sua tabela com DELETE FROM nome_ e tabela (sem um WHERE) no modo AUTOCOMMIT, a sequencia ser reiniciada em todos os a tipos de tabela, exceto InnoDB. Veja Seo 7.5.12.5 [InnoDB auto-increment column], ca Pgina 675. a Nota: S pode haver uma coluna AUTO_INCREMENT por tabela, e ela deve ser indexada e o no pode ter uma valor DEFAULT. No MySQL Verso 3.23, uma coluna AUTO_INCREMENT a a funcionar corretamente apenas se conter apenas valores positivos. Inserir um nmero a u negativo considerado como a insero de um nmero positivo muito grande. Isto e ca u ocorre para evitar problemaa de preciso quando os nmeros vo de positivo para a u a negativo e tambm para assegurar que no se obtenha, acidentalmente, uma coluna e a AUTO_INCREMENT que contenha 0. Em tabelas MyISAM e BDB voc pode especicar colunas AUTO_INCREMENT secundrias em e a uma chave ulti-coluna. Veja Seo 3.6.9 [exemplo-AUTO INCREMENT], Pgina 201. ca a com alguns aplicativos ODBC, voc pode encontrar o Para tornar MySQL compativel e valor AUTO_INCREMENT da ultima linha inserida com a seguinte consulta: SELECT * FROM nome_tabela WHERE auto_col IS NULL Valores NULL so tratados em colunas TIMESTAMP de modo diferente de outros tipos a de colunas. Voc no pode armazenar um NULL literal em uma coluna TIMESTAMP; e a denindo a coluna com NULL lhe atribui a a data e a hora atual. Como colunas TIMESTAMP se comportam desta forma, os atributos NULL e NOT NULL no se aplicam de a modo normal e so ignorados se voc os especicar. a e Por outro lado, tornar o uso de colunas TIMESTAMP mais fcil para os clientes MySQL, o a servidor relata que tal coluna pode ter o valor NULL atribu (a que verdade), mesmo ido e que TIMESTAMP nunca contenham, realmente, um valor NULL. Voc pode ver isto quando e voc utiliza DESCRIBE nome_tabela para obter informaes sobre sua tabela. e co Note que denir uma coluna TIMESTAMP com 0 no o mesmo que den com NULL, a e i-la porque 0 um valor TIMESTAMP vlido. e a

602

MySQL Technical Reference for Version 5.0.0-alpha

Um valor padro (DEFAULT) tem que ser constante, ele no pode ser uma funo ou a a ca uma expresso. a Se nenhum valor DEFAULT especicado para uma coluna, o MySQL atribuir um e a automaticamente, como a seguir. Se a coluna aceitar NULL como um valor, o valor padro NULL. a e Se a coluna declarada como NOT NULL, o valor padro depende do tipo de coluna: e a Para tipos numricos no declarados com o atributo AUTO_INCREMENT, o padro e a a 0. Para uma coluna AUTO_INCREMENT, o valor padro o prximo valor na e a e o sequncia. e Para tipos date e time diferentes de TIMESTAMP, o padro o valor zero apropriado a e para o tipo. Para a primeira coluna TIMESTAMP na tabela, o padro a data e a e hora atuais. Veja Seo 6.2.2 [Tipos date e time], Pgina 489. ca a Para tipos string diferentes de ENUM, o valor padro uma string vazia. Para ENUM, a e o padro o primeiro valor enumerado. a e Valores padres devem ser constantes. Isto signica, por exemplo, que voc no pode o e a denir o padro de uma coluna date como o valor de funes como NOW() or CURRENT_ a co DATE. Um comentrio para uma coluna pode ser especicado com a opo COMMENT. O coa ca mentrio mostrado pela instruo SHOW CREATE TABLE e por SHOW FULL COLUMNS. Esta a e ca opo est dispon a partir do MySQL 4.1. (Ela perimitida mas ignorada em verses ca a ivel e o anteriores.) KEY normalmente um sinnimo para INDEX. A partir da verso 4.1, o atributo de chave e o a PRIMARY KEY tambm pode ser especicado apenas como KEY. Isto foi implementado e para compatibilidade com outros bancos de dados. No MySQL,uam chave UNIQUE s pode ter valores distintos. Um erro ocorre se voc o e tantar adicionar uma nova linha com uma chave que coincida com uma j existente. a PRIMARY KEY uma chave unica (KEY) onde todas as colunas chaves devem ser denidas e como NOT NULL. Se elas no forem explicitamente declaradas como NOT NULL, isto ser a a feito implicitamente e sem aviso. No MySQL a chave chamada PRIMARY. Uma tabela e pode ter apenas uma PRIMARY KEY. Se voc no tiver uma PRIMARY KEY e alguma e a aplicao perguntar pela PRIMARY KEY em sua tabela, o MySQL retornar a primeira ca a chave UNIQUE, que no possui nenhuma coluna NULL, como a PRIMARY KEY. a Uma PRIMARY KEY pode ser um indice multi-coluna. Porm, voc no pode criar um e e a indice multi-coluna usando o atributo de chave PRIMARY KEY em uma especicao de ca coluna. Fazendo assim apenas colunas simples podero ser marcadas como primrias. a a Voc deve utilizar uma clusula PRIMARY KEY(index_nome_coluna, ...) separada. e a Um indice UNIQUE aquele no qual todos os valores no e indice devem ser distintos. A exceo a isto que se for permtido conter valores NULL em uma coluna no ca e indice, ele pode conter mltiplos valores NULL. Este exceo no se aplica a tabelas BDB, que u ca a permitem apenas um unico NULL. Se a chave PRIMARY ou UNIQUE consistir de apenas uma coluna e ela do tipo inteiro, e voc tambm poder se referir a ela como _rowid (novo na verso 3.23.11). e e a a Se voc no atribuir um nome ao e a indice que no um PRIMARY KEY, ele ter o mesmo a e a nome da prmeira index_nome_coluna, com um suxo opicional (_2, _3, ...) para

Cap tulo 6: Referncia de Linguagem do MySQL e

603

torn-lo unico. Voc pode nome de a e indices para uma tabela usando SHOW INDEX FROM nome_tabela. Veja Seo 4.6.8.1 [Show database info], Pgina 303. ca a Apenas os tipos de tabelas MyISAM, InnoDB, e BDB suportam indices em coluna que possam ter valores NULL. Nos outros casos voc deve declarar tais colunas NOT NULL ou e um erro ser retornado. a Com a sintaxe nome_coluna(length) em uma especicao de ca indice, voc pode criar e um indice que utiliza apenas os primeiros length() bytes de uma coluna CHAR ou VARCHAR. Isto pode tornar o arquivo de indices muito menor. Veja Seo 5.4.4 [ ca Indices], Pgina 449. a Apenas os tipos de tabela MyISAM e (a partir do MySQL 4.0.14) InnoDB suportam indice em colunas BLOB e TEXT. Ao colocar um indice em uma coluna BLOB ou TEXT voc sempre DEVE especicar o tamanho do e indice, at 255 bytes. Por exemplo: e CREATE TABLE test (blob_col BLOB, INDEX(blob_col(10))); Uma especicao index_col_name pode nalizar com ASC ou DESC. Esta palavras ca chaves so permitidas para estenso futura para especicar o armazenamento do valor a a do indice em crescente ou decrescente. Atualmente elas so analisadas mas ignoradas; a valores de indice so sempre armazenados em ordem crescente. a Quando voc utiliza ORDER BY ou GROUP BY com uma coluna TEXT ou BLOB, o servidor e ardena valores usando apenas o nmero inicial de bytes, indicado pela varivel do u a servidor max_sort_length. Veja Seo 6.2.3.2 [BLOB], Pgina 498. ca a No MySQL Verso 3.23.23 ou posterior, voc tambm pode criar a e e indices FULLTEXT especiais. Eles so usados para busca full-text. Apenas o tipo de tabela MyISAM suporta a indices FULLTEXT. Eles s podem ser criados em colunas CHAR, VARCHAR, e TEXT. A o indexao sempre ocorre sobre toda a coluna; ca indices parciais no so suportados. Veja a a Seo 6.8 [Fulltext Search], Pgina 619 para detalhes de operao. ca a ca No MySQL Verso 3.23.44 ou posterior, tabelas InnoDB suportam vericao de chaves a ca estrangeiras. Veja Seo 7.5 [InnoDB], Pgina 643. Note que a sintaxe FOREIGN KEY no ca a InnoDB mais restrita que a sintaxe apresentada acima. As colunas da tabela indicada e devem ser nomeadas explicitmente. O InnoDB suporta ambas as aes ON DELETE e co ON UPDATE em chaves esrtrangiras nos MySQL 3.23.50 e 4.0.8, respectivamente. Veja a seo InnoDB do manual para a sintaxe precisa. Veja Seo 7.5.5.2 [InnoDB foreign ca ca key constraints], Pgina 654. Para outros tipos de tabelas, MySQL Server analisa as a sinatxes FOREIGN KEY, CHECK e REFERENCES no comando CREATE TABLE, mas sem tal ao ser tomada. Veja Seo 1.8.4.5 [ANSI di Foreign Keys], Pgina 50. ca ca a Para tabelas ISAM e MyISAM, cada coluna NULL tem um bit extra, arredondado para o byte mais prximo. O tamanho mximo de um registro em bytes pode ser calculado o a como a seguir: tamanho da linha = 1 + (soma do tamanho da coluna) + (nmeros de coluna NULL + delete_flag 7)/8 u + (nmero de colunas de tamanho varivel) u a delete_flag 1 para tabelas com formato de registro esttico. Tabelas estticas usam e a a um bit no registro para um parmetro que indica se o linha foi deletada. delete_flag a 0 para tabelas dinmicas porque este parmetro armazenado no cabealho da linha e a a e c dinmica. a

604

MySQL Technical Reference for Version 5.0.0-alpha

Estes clculos no se aplicam ` tabelas InnoDB, para a qual o tamanho do armazenaa a a mento no diferente para colunas NULL comparados a colunas NOT NULL. a e A opao op~o_tabela e SELECT s so implmentadas no MySQL Verso 3.23 e acima. c ca o a a A opo TYPE para especicar o tipo de tabela possui os seguintes valores: ca Tipo de tabela BDB ou BerkeleyDB HEAP ISAM InnoDB MERGE MRG_MyISAM MyISAM Descrio ca Tabelas de transaao segura com bloqueio de pgina. Veja c a Seo 7.6 [BDB], Pgina 698. ca a Os dados desta tabela so armazenados apenas na memria. a o Veja Seo 7.4 [HEAP], Pgina 642. ca a O mecanismo de armazenamento original. Veja Seo 7.3 ca [ISAM], Pgina 641. a Tabelas com transaes eguras com bloqueio de linha. Veja co Seo 7.5 [InnoDB], Pgina 643. ca a Uma coleo de tabelas MyISAM usadas como uma tabela. ca Veja Seo 7.2 [MERGE], Pgina 638. ca a Um apelido para tabelas MERGE O novo mecanismo de armazenamento portvel binrio que a a substitui o ISAM. Veja Seo 7.1 [MyISAM], Pgina 631. ca a

Veja Capptexi tulo 7 [Tipos de tabelas], Pgina 630. a Se um tipo de tabela especicado, e este tipo no est dispon e a a ivel, MySQL ir usar a MyISAM. Por exemplo, se uma denio de tabela inclui a opo TYPE=BDB mas o ca ca MySQL no suporta tabelas BDB, a tabela ser criada como uma tabela MyISAM. Isto a a de se ter uma congurao de replicao onde voc tem tabelas transatorna possivel ca ca e cionaisno master mas as tabelas criadas no slave so no transacionais (para obter mais a a velocidade). No MySQL 4.1.1 voc obtm um aviso se o tipo de tabela especicado e e no aceito. a e Os outros tipos de tabelas so utilizados para otimizar o comportamento da tabela. Na a maioria dos casos, voc no precisa especicar nenhuma delas. As opes funcionam e a co com todos os tipos, a menos que haja indicao: ca Opo ca AUTO_INCREMENT Descrio ca O prximo valor AUTO_INCREMENT que voc quer denir em o e sua tabela (apenas MyISAM; para denir o primeiro valor auto incrementeem uma tabela InnoDB insira uma linha com um valor de menos um e delete esta linha). Uma aproximao do tamanho mdio de linha em sua tabela. ca e Voc s precisa den para tabelas grnades com tamanho e o i-la de registros variveis. a Dena com 1 se voc quiser manter um checksum para toe das as linha (deixa a tabela um pouco mais lenta para atualizaes, mas ca mais fcil encontrar tabelas corrompidas) co a (apenas MyISAM). Um comentrio de 60 caracteres para a sua tabela. a Nmero mximo de linhas que voc deseja armazenar na u a e tabela. Nmero m u inimo de linha que voc planeja armazenar na e tabela.

AVG_ROW_LENGTH CHECKSUM

COMMENT MAX_ROWS MIN_ROWS

Cap tulo 6: Referncia de Linguagem do MySQL e

605

Dena com 1 se voc quiser um e indice menor, Normalmente torna a atualizao mais lenta e a leitura mais rpida (apeca a nas MyISAM e ISAM). Denr com 0 ir desabilitar empacotaa mento das chaves. Denir com DEFAULT (MySQL 4.0) dir ao a mecanismo de armazenamento para empacotar apenas colunas CHAR/VARCHAR longas. PASSWORD Criptografa o arquivo .frm com uma senha. Esta opo no ca a fa nada na verso padro do MySQL. a a DELAY_KEY_WRITE Dena com 1 se quiser atrasar a atualizao das chaves da ca tabela at que a tabela seja fechada (apenas MyISAM). e ROW_FORMAT Dene como as linhas devem ser armazenadas. Atualmente esta opo s funciona com tabelas MyISAM, as quais suporca o tam os formatos de linha DYNAMIC e FIXED. Veja Seo 7.1.2 ca [Formatos das tabelas MyISAM], Pgina 634. a Quando voc utiliza uma tabela MyISAM, MySQL usa o produto de MAX_ROWS * AVG_ e ROW_LENGTH para decidir o tamanho da tabela resultante. Se voc no especicar e a qualquer uma das opes acima, o tamanho mximo de uma tabela ser 4G (ou 2G co a a se o seu sistema operacional s suporta tabelas de 2G). A razo para isto apenas o a e manter o tamanho dos ponteiros baixo para tornar o indice menor e mais rpido se a voc realmente no precisa de tabelas grandes. e a Se voc no utilizar PACK_KEYS, o padro s empacotar strings, no nmeros. Se voc e a a e o a u e utilizar PACK_KEYS=1, nmeros tambm sero empacotados. u e a Ao empacotar chaves numricas binrias, o MySQL usar a compactao prexada. e a a ca Isto signica que voc s ter grandes benef e o a icios disto se voc tiver muitos nmeros e u iguais. Compactao prexada signica que toda a chave precisa de um byte extra ca para indicar quantos bytes das caves anteriores so o mesmo da prxima chave (note a o que o ponteiro para a linha armazenado na ordem do byte mais alto em primeiro diree tamente depois da chave, para aumentar compactao). Isto signica que se voc tiver ca e muitas chaves iguais em duas linhas consecutivas, todas os chaves iguais seguintes iro normalmente ter apenas 2 bytes (incluindo o ponteiro para a linha). Compare isto a isto ao caso comum onde as chaves seguintes iro levar tamanho armazenamento chave a + tamanho ponteiro (nomralmente 4). Por outro lado, se todas as chaves so totala mente diferente, voc usar 1 byte por chave, se a chave no puder ter valores NULL. e a a (Neste caso o tamanho da chave empacotada ser armazenado no mesmo byte que a e usado para marcar se a chave NULL.) e No MySQL 3.23, Se voc especicar um SELECT depois de uma instruo CREATE, e ca MySQL criar novos campos para todos os elemento em SELECT. Por exemplo: a mysql> CREATE TABLE test (a INT NOT NULL AUTO_INCREMENT, -> PRIMARY KEY (a), KEY(b)) -> TYPE=MyISAM SELECT b,c FROM test2; Isto ir criar uma tabela MyISAM com trs colunas, a, b e c. Note que as colunas a e da instruo SELECT so inseridas do lado correto da tabela, n`o sobreposta nela. ca a a Considere o seguinte exemplo: mysql> SELECT * FROM foo; +---+ | n | PACK_KEYS

606

MySQL Technical Reference for Version 5.0.0-alpha

+---+ | 1 | +---+ mysql> CREATE TABLE bar (m INT) SELECT n FROM foo; Query OK, 1 row affected (0.02 sec) Records: 1 Duplicates: 0 Warnings: 0 mysql> SELECT * FROM bar; +------+---+ | m | n | +------+---+ | NULL | 1 | +------+---+ 1 row in set (0.00 sec) Para cada linha na tabela foo, uma linha inserida em bar com os valores de foo e os e valores padres para a nova coluna. o CREATE TABLE ... SELECT no ir criar automaticamente nenhum a a indice para voc. e Isto feito intencionalmente para deixar o comando o mais ex poss e ivel ivel. Se voc e quiser ter indices em uma tabela criada, voc deve especic-lo antes da instruo e a ca SELECT: mysql> CREATE TABLE bar (UNIQUE (n)) SELECT n FROM foo; Se ocorrer qualquer erro durante enquanto os dados so copiados para a tabela, ele ser a a automaticamente deletado. Voc pode preceder o SELECT por IGNORE ou REPLACE para indicar como tratar registros e que duplicam valores de chave unica. Com IGNORE, novos registros que duplicam um registro existente em um valor de chave unica so descartados. Com REPLACE, novos a registros substituem registros que tem o mesmo valor de chave unica. Se nem IGNORE nem REPLACE so especicados, valir de chave unica duplicados resultam em erro. a Para assegurar que o log binrio/atualizao pode ser usado para recriar a tabela a ca original, MySQL no permitir inseres concorrentes durante um CREATE TABLE ... a a co SELECT. A opo RAID_TYPE ir ajud-lo a exceder o limite de 2G/4G limit para arquivo de ca a a dados MyISAM (no o arquivo de a indice) em sistemas operacionais que no suportam a arquivos grandes. Note que esta opo no recomendada para sistema de arquivos ca a e que suportam arquivos grandes! Voc pode obter mais velocidade da gargalo de E/S colocando diretorios RAID em e diferentes discos f isicos. RAID_TYPE funcionar em qualquer sistema operacional, desde a que voc tenha congurado o MySQL com --with-raid. Por agora o unico RAID_TYPE e permitido STRIPED (1 e RAID0 so utilizados para isto). e a Se voc especicar RAID_TYPE=STRIPED para tabeals MyISAM, MyISAM criar subdie a retrios RAID_CHUNKS chamados 00, 01, 02 no diretrio de banco de dados. Em cada um o o destes diretrios MyISAM criar uma nome_tabela.MYD. Ao escrever dados no arquivo o a de dados, o manipulador RAID ir mapear o primeiro RAID_CHUNKSIZE *1024 bytes a

Cap tulo 6: Referncia de Linguagem do MySQL e

607

para o primeiro arquivo e os prximos RAID_CHUNKSIZE *1024 bytes para o prximo o o arquivo. UNION utilizado quando voc quer utilizar uma coleo de tabelas identicas como uma. e e ca Isto s funciona com tabelas MERGE. Veja Seao 7.2 [MERGE], Pgina 638. o c a No momento voc precisa ter privilgios SELECT, UPDATE e DELETE nas tabelas mapeadas e e para uma tabela MERGE. Todas as tabelas mapeadas devem estar no mesmo banco de dados na tabela MERGE. Se voc quiser inserir dados em uma tabela MERGE, voc tem que especicar com e e INSERT_METHOD na tabela onde o registro deve ser inserido. INSERT_METHOD uma e opo util somente para tabelas MERGE. Veja Seo 7.2 [MERGE], Pgina 638. Esta ca ca a opo foi introduzida no MySQL 4.0.0. ca Na tabela criada a chave PRIMARY ser colocado primeiro, seguida de todas a chaves a unicas (UNIQUE) e ento das chaves normais. Isto ajuda o otimizador MySQL para a priorizar qual chave utilizar e tambm a detectaa mais rapidamente chaves unicas e (UNIQUE) duplicadas. Utilizando DATA DIRECTORY=directorio ou INDEX DIRECTORY=directorio voc e pode especicar onde o mecanismo de armazenamento deve colocar os seus arquivos de tabelas e indices. Note que diretrio deve ser um caminho completo para o diretrio o o (no um caminho relativo). a Isto s funciona para tabelas MyISAM no MySQL 4.0, quando no estiver usando a opo o a ca --skip-symlink. Veja Seo 5.6.1.2 [Links simblicos para tabelas], Pgina 466. ca o a

6.5.3.1 Alterao de Especicaes de Colunas ca co

Em alguns casos, MySQL altera sem aviso uma especicao de coluna dada em uma ca instruo CREATE TABLE. (Isto tambm pode ocorrer com ALTER TABLE.): ca e Colunas VARCHAR com um tamanho menor que quatro so alteradas para CHAR. a Se qulquer coluna em uma tabela tem um tamanho varivel, toda a linha de tamanho a e varvel como resultado. Consequentementem se uma tabela contm qualquer coluna a e de tamanho varivel (VARCHAR, TEXT, ou BLOB), todas as colunas CHAR maior que trs a e caracteres so alteradas para colunas VARCHAR. Isto no afeta como voc utiliza as a a e colunas; no MySQL, VARCHAR apenas um modo diferente de armazenar caracteres. O e MySQL realiza esta converso porque ela salva espao e torna as operes de tabela a c co mais rpidas. Veja Capptexi tulo 7 [Tipos de tabela], Pgina 630. a a A partir da verso 4.1.0, se um campo CHAR ou VARCHAR com uma especicao de a ca tamanho maior que 255 convertido para TEXT. Este um recurso para compatibilie e dade. O tamanho do display TIMESTAMP deve ser para e na faixa de 2 a 14. Se voc especie car um tamanho de display de 0 opu maior que 14, o tamaho convertido para 14. e Tamanhos de valor impar na faixa de 1 a 13 so convertidos para o nmero para mais a u prximo acima. o Voc no pode armazenar um NULL literal em uma coluna TIMESTAMP; den com e a i-la NULL a atribui a data e hora atual. Por colunas TIMESTAMP comportarem deste modo, os atributos NULL e NOT NULL no se aplicam no modo normal e so ignorados se voc a a e

608

MySQL Technical Reference for Version 5.0.0-alpha

especic-los. DESCRIBE nome_tabela sempre indica que a uma coluna TIMESTAMP a pode ser atribu valores NULL. ido MySQL mapeia certos tipos de colunas utilizados por outros produtos de banco de dados para tipos MySQL. Veja Seo 6.2.5 [Tipos de colunas de outros produtos], ca Pgina 502. a Se voc quiser ver se o MySQL utiliza um tipo de coluna diferente do especicado, axecute e uma instruo DESCRIBE nome_tabela depois de criar ou alterar a sua tabela. ca Outras alteraes de tipos de colunas podem ocorrer se voc compactar a tabela utilizando co e myisampack. Veja Seo 7.1.2.3 [Formato compactado], Pgina 635. ca a

6.5.4 Sintaxe ALTER TABLE

ALTER [IGNORE] TABLE nome_tbl especifica~o_alter [, especifica~o_alter ...] ca ca especifica~o_alter: ca ADD [COLUMN] defini~o_create [FIRST | AFTER nome_coluna ] ca | ADD [COLUMN] (defini~o_create, defini~o_create,...) ca ca | ADD INDEX [nome_indice] (index_nome_col,...) | ADD [CONSTRAINT [symbol]] PRIMARY KEY (index_col_name,...) | ADD [CONSTRAINT [symbol]] UNIQUE [index_name] (index_col_name,...) | ADD FULLTEXT [index_name] (index_col_name,...) | ADD [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (index_col_name,...) [defini~o_referncia] ca | ALTER [COLUMN] nome_col {SET DEFAULT literal | DROP DEFAULT} | CHANGE [COLUMN] nome_col_antigo defini~o_create ca [FIRST | AFTER nome_coluna] | MODIFY [COLUMN] defini~o_create [FIRST | AFTER nome_coluna] ca | DROP [COLUMN] nome_col | DROP PRIMARY KEY | DROP INDEX nome_indice | DISABLE KEYS | ENABLE KEYS | RENAME [TO] nome_nova_tbl | ORDER BY col | CHARACTER SET character_set_name [COLLATE collation_name] | table_options ALTER TABLE lhe permite alterar a estrutura da tabela existente. Por exemplo, voc pode e adicionar ou deletar colunas, criar ou remover indices, alterar o tipo de coluna existentes, ou renomear coluna ou tabelas. Voc tambm pode alterar o comentrio para a tabela e e e a tipo de tabela. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a Se voc utilizar ALTER TABLE para alterar a especicao da coluna, mas DESCRIBE tbl_ e ca name indicar que a sua coluna no foi alterada, poss que o MySQL tenha ignorado ou a e ivel a sua modicao por uma das razes descritas em Seo 6.5.3.1 [Silent column changes], ca o ca Pgina 607. Por exemplo, se voc tentar alterar uma coluna VARCHAR para CHAR, MySQL a e ainda usar VARCHAR se a tabela conter outras colunas de tamanho varivel. a a

Cap tulo 6: Referncia de Linguagem do MySQL e

609

ALTER TABLE funciona fazendo uma cpia temporria da tabela original. A alterao o a ca e realizada na cpia, assim a tabela original deletada e a nova tabela renomeada. Isto feito o e e e de tal forma que todas as desnecessriaatualizaoes so automaticamente redirecionadas a c a para a nova tabela sem nenhuma atualizao errada. Enquanto o ALTER TABLE executado, ca e a tabela original pode ser lida por outros clientes. Atualizaes e escrita na tabela so co a guardadas at a nova tabela estar pronta. e Note que se voc utilizar qualquer outra opo de ALTER TABLE, exceto RENAME, o MySQL e ca ir sempre criar um a tabela temporria, mesmo se os dados no precisarem realmente a a a serem copiados (como quando voc altera o nome de uma coluna). Planejamos corrigir e isto no futuro, mas como no se faz ALTER TABLE com tanta frequncia, isto no de alta a e a e prioridade em nosso TO DO. Para tabelas MyISAM, vOc pode aumentar a velocidade na e parte da recriao dos ca indices (que a parte mais lenta do processo recriao) atribuindo um ca alto valor ` varivel myisam_sort_buffer_size. a a Para utilizar ALTER TABLE, voc precisa dos privilgios ALTER, INSERT e CREATE na e e tabela. IGNORE uma extenso do MySQL ao SQL-92. Ele controla como o ALTER TABLE e a funciona se houver duplicao em chaves unicas na nova tabela. Se IGNORE no ca a e especicado, a cpia abortada e retornada. Se IGNORE for especicado, para linhas o e com duplicatas em chaves unicas, somente a primera linha usada; as outras so e a deletadas. Voc pode executar mltiplas clusulas ADD, ALTER, DROP e CHANGE em uma unica e u a instruo ALTER TABLE. Esta uma extenso do MySQL ao SQL-92, que permite ca e a paenas uma clusula de cada por instruo ALTER TABLE. a ca CHANGE col_name, DROP col_name, e DROP INDEX so extenses do MySQL ao SQL-92. a o MODIFY uma extenso do Oracle para ALTER TABLE. e a A palavra opcional COLUMN uma palavra puramente desnecessria e pode ser omitida. e a Se voc utilizar ALTER TABLE nome_tbl RENAME TO novo_nome sem nenhuma outra e opo, MySQL simplesmente renomeia os arquivos correspondentes a tabela nome_tbl. ca No h necessidade de se criar uma tabela temporria. Veja Seo 6.5.5 [RENAME a a a ca TABLE], Pgina 612. a Clusulas definiao_create usam a mesma sintaxe para ADD e CHANGE assim como a c~ para CREATE TABLE. Note que a sintaxe inclui o nome da coluna, no apenas o tipo da a coluna. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a Voc pode renomear ma coluna usando uma clusula CHANGE nome_col_antiga e a defini~es_create. Para tal, especique o nome das colunas antiga e da nome e o co tipo que a coluna atual possui. Por exemplo, para renomear uma coluna INTEGER de a para b, faa assim: c mysql> ALTER TABLE t1 CHANGE a b INTEGER; Se voc quiser mudar um tipo de coluna, mas no o nome, a sintaxe CHANGE ainda exige e a dois nomes de colunas, mesmo que sejam o mesmo. Por exemplo: mysql> ALTER TABLE t1 CHANGE b b BIGINT NOT NULL; No entanto, como no MySQL Verso 3.22.16a, voc tambm pode utilizar MODIFY para a e e alterar um tipo de coluna sem renome-lo: a mysql> ALTER TABLE t1 MODIFY b BIGINT NOT NULL;

610

MySQL Technical Reference for Version 5.0.0-alpha

Se voc utilizar CHANGE ou MODIFY para reduzir uma coluna na qual exista um e indice em parte da coluna (por exemplo, se voc tiver um e indice nos primeiros 10 caracteres de uma coluna VARCHAR), voc no poder reduzir a coluna para um tamanho menor e a a que o nmero de caracteres indexados. u Quando voc altera um tipo de coluna usando CHANGE ou MODIFY, erter os dados para e o novo tipo da melhor forma poss ivel. No MySQL Verso 3.22 ou posterior voc pode utilizar FIRST ou ADD ... AFTER nome_ a e col para aadicionar uma coluna em uma posio espec ca ica na linha da tabela. O padro adicionar a coluna no m. A partir do MySQL Verso 4.0.1, voc pode a e a e tambm utilizar as palavras-chave FIRST e AFTER em CHANGE ou MODIFY. e ALTER COLUMN especica um novo valor padro para uma coluna ou remover o valor a padro antigo. Se o padro antigo removido e a coluna pode ser NULL, o novo padro a a e a NULL. Se a coluna no pode ser NULL, MySQL atribui um valor padro, como descrito e a a em Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a DROP INDEX remove um indice. Esta uma extenso do MySQL ao SQL-92. Veja e a Seo 6.5.8 [DROP INDEX], Pgina 614. ca a Se colunas forem removidas de uma tabela, as colunas tambm so removidas de quale a quer indice do qual eles fazem parte. Se todas as colunas que compe um o indice so a exclu idas, o indice tambm exclu e e ido. Se uma tabela contm apenas uma coluna, a coluna no pode ser exclu e a ida. Se o que voc pretende remover a tabela, use DROP TABLE. e e DROP PRIMARY KEY deleta o indice primrio. Se tal a indice no existe, ele apaga o prmeiro a indice unico (UNIQUE) na tabela. (MySQL marca a primeira chave unica (UNIQUE) como PRIMARY KEY se nenhuma PRIMARY KEY foi especicada explicitamente.) Se voc adicionar UNIQUE INDEX ou PRIMARY KEY a uma tabela, elas so armazenadas e a antes de qualquer indice no UNIQUE para que possa detectar cahves duplicadas o mais a rpido poss a ivel. ORDER BY lhe permite criar a nova tabela com as linhas em uma ordem espec ica. Note que a tabela no permanecer nesta ordem depois de insres e delees. Em algunas a a co co casos, isto pode tornar a ordenao mais para o MySQL se a tabela estiver ordenada ca pela coluna que voc escolheu. Esta opo util principalmente quando voc sabe qeu e ca e e na maioria das vezes voc ir inserir os registros em certa ordem; utilizando esta opo e a ca depois de grandes mudanas na tabela, voc obter melhor desempenho. c e a Se voc utilizar ALTER TABLE em uma tabela MyISAM, todos os e indices que no so a a unicos so criados em um grupo separado (como em REPAIR). Isto deve tornar ALTER a TABLE muito mais rpido quando voc tiver vrios a e a indices. A partir do MySQL 4.0 o recurso acima pode ser ativado explicitamente. ALTER TABLE ... DISABLE KEYS faz o MySQL parar de atualizar chaves que no so unicas em tabelas a a MyISAM. ALTER TABLE ... ENABLE KEYS deve ser usado para recriar indices perdidos. Como o MySQL faz isso com um algoritmo especial que muito mais rpido que e a inserir chaves uma a uma, disabilitar chaves podem trazer um aumento de velocidade considervel em inseres volumosas. a co Com a funo mysql_info() da API C, voc pode saber quantos registros foram copiaca e dos, e (quando IGNORE for usado) quantos registros foram deletados devido a duplicao ca de valores de chaves unicas.

Cap tulo 6: Referncia de Linguagem do MySQL e

611

As clusulas FOREIGN KEY, CHECK e REFERENCES no fazem nada, exceto para tipos a a de tabela InnoDB que suportam ... ADD [CONSTRAINT [symbol]] FOREIGN KEY (...) REFERENCES ... (...) e ... DROP FOREIGN KEY .... Veja Seo 7.5.5.2 [InnoDB forca eign key constraints], Pgina 654. A sintaxe para outros tipos de tabela s fornecido a oe para comptibilidade, para tornar fcil portar o cdigo de outro servidor SQL e executar a o aplicaes que criam tabelasd com referncias. Veja Seo 1.8.4 [Diferenas do ANSI], co e ca c Pgina 46. a ALTER TABLE ignora as opes de tabela DATA DIRECTORY e INDEX DIRECTORY. co Se voc quiser alterar todas as colunas CHAR/VARCHAR/TEXT para um novo cone junto de caracteres (por exemplo, depois de atualizar do MySQL 4.0.x para o 4.1.1) voc pode fazer: e ALTER TABLE table_name CHARACTER SET character_set_name; Note que o seguinte comando s ir alterar o default character set para uma tabela: o a ALTER TABLE table_name DEFAULT CHARACTER SET character_set_name; O default character set o conjunto de caracteres que usado se voc no especie e e a car o conjunto de caracteres para uma nova coluna que voc adicionar a tabela (por e exemplo com ALTER TABLE ... ADD coluna). Aqui temos um exemplo que mostra alguns dos usos de ALTER TABLE. Ns comeamos com o c uma tabela t1 que crida como mostrado aqui: e mysql> CREATE TABLE t1 (a INTEGER,b CHAR(10)); Para renomear a tabela de t1 para t2: mysql> ALTER TABLE t1 RENAME t2; Para alterar a coluna a de INTEGER para TINYINT NOT NULL (deixando o mesmo nome), e alterar a coluna b de CHAR(10) para CHAR(20) e renome-la de b para c: a mysql> ALTER TABLE t2 MODIFY a TINYINT NOT NULL, CHANGE b c CHAR(20); Para adicionar um nova coluna TIMESTAMP chamada d: mysql> ALTER TABLE t2 ADD d TIMESTAMP; Para adicionar um indice na coluna d, e tornar a colua a a chave primria: a mysql> ALTER TABLE t2 ADD INDEX (d), ADD PRIMARY KEY (a); Para remover a coluna c: mysql> ALTER TABLE t2 DROP COLUMN c; Para adiciomar um nova coluna inteira AUTO_INCREMENT chamada c: mysql> ALTER TABLE t2 ADD c INT UNSIGNED NOT NULL AUTO_INCREMENT, ADD INDEX (c); Note que ns indexamos c, porque colunas AUTO_INCREMENT devem ser indexadas e tambm o e por isso declaramos c como NOT NULL, pois colunas indexadas no podem ser NULL. a Quando voc adicionar uma coluna AUTO_INCREMENT, valores de coluna so preenchidos com e a sequncia de nmeros automaticamente para voc. Voc pode denir o primeiro nmero da e u e e u sequncia executando SET INSERT_ID=valor antes de ALTER TABLE ou usando a opo de e ca tabela AUTO_INCREMENT=valor. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca a

612

MySQL Technical Reference for Version 5.0.0-alpha

Com tabelas MyISAM tables, se voc no alterar a coluna AUTO_INCREMENT, a sequncia de e a e nmeros no ser afetada. Se voc excluir uma coluna AUTO_INCREMENT e adicionar outra u a a e coluna AUTO_INCREMENT, a numerao iniciar a partir do 1 novamente. ca a Veja Seo A.7.1 [Problemas com ALTER TABLE], Pgina 938. ca a

6.5.5 Sintaxe RENAME TABLE

RENAME TABLE nome_tabela TO novo_nome_tabela[, nome_tabela2 TO novo_nome_tbl2,...] A renomeao feita automicamente, o que signica que nenhuma outra thread pode acessar ca e qualquer uma das tabelas enquanto a renomeao est sendo exectuda. Isto torna poss ca a ivel substituir uma tabela por uma tabela vazia: CREATE TABLE tabela_nova (...); RENAME TABLE tabela_antiga TO tabela_backup, tabela_nova TO tabela_antiga; A renomeao feita da esquera para a direita, o que signica que se voc quiser trocar os ca e e nomes das tabelas, voc deve fazer: e RENAME TABLE tabela_antiga TO tabela_backup, tabela_nova TO tabela_antiga, tabela_backup TO tabela_nova; Desde que dois banco de dados estejam no mesmo disco voc pode renomear de um banco e de dados para outro: RENAME TABLE bd_atual.nome_tabela TO outro_bd.nome_tabela; Quando voc executa RENAME, voc no pode ter nenhuma tabela bloqueada ou transaes e e a co ativas. Voc tambm deve ter o privilgio ALTER e DROP na tabela original e o privilgio e e e e CREATE e INSERT na nova tabela. Se o MySQL encontrar qualquer erro uma renomeao multi-tabela, ele far um renomeao ca a ca reversa para todas a tabelas renomeadas para retornar tudo ao estado original. RENAME TABLE foi adicionado no MySQL 3.23.23.

6.5.6 Sintaxe DROP TABLE

DROP TABLE remove uma ou mais tabelas. Todos os dados e denies de tabela so removico a dos, assim tenha cuidado com este comando! No MySQL Verso 3.22 ou posteriorm voc pode usar a palavra-chave IF EXISTS para a e prevenir um erro de ocorrer se no existir a tabela. Na verso 4.1 consegue-se um NOTA a a para todas as tabelas no esistentes se for usado IF EXISTS. Veja Seo 4.6.8.9 [SHOW a ca WARNINGS], Pgina 323. a RESTRICT e CASCADE so permitidos para portao se tornar tornar mais fcil. No momento a ca a eles no fazem nada. a Nota: DROP TABLE far automaticamente um commit da transao ativa atualmente (exceto a ca se voc estiver usando a verso 4.1 e a palavra-chave TEMPORARY. e a A opco TEMPORARY ignorada na verso 4.0. Na verso 4.1 esta opo funciona como a a e a a ca seguir:

DROP [TEMPORARY] TABLE [IF EXISTS] nome_tabela [, nome_tabela,...] [RESTRICT | CASCA

Cap tulo 6: Referncia de Linguagem do MySQL e

613

S apaga tabelas temporrias. o a INo naliza uma transao em execuo. a ca ca Nenhum direito de acesso vericado. e Usar TEMPORARY uma boa maneira de assegurar que voc no apague uma tabela real. e e a

6.5.7 Sintaxe CREATE INDEX

CREATE [UNIQUE|FULLTEXT] INDEX nome_indice ON nome_tabela (index_col_name,...) index_col_name: col_name [(length)] [ASC | DESC] A instruo CREATE INDEX no faz nada em verses do MySQL anterior a 3.22. Na verso ca a o a 3.22 ou posteriores, CREATE INDEX mapeado para uma instruo ALTER TABLE para criar e ca indices. Veja Seo 6.5.4 [ALTER TABLE], Pgina 608. ca a Normalmente voc cria todos os indices em uma tabela ao mesmo tempo em que a prpria e o tabela criada com CREATE TABLE. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. CREATE e ca a INDEX lhe permite adicionar indices a tabelas existentes. Uma lista de colunas na forma (col1,col2,...) cria um indice com mltiplas colunas. u Valores de indice so formados concatenando os valores de colunas dadas. a Para colunas CHAR e VARCHAR, indices que utilizam apenas parte da coluna podem ser criados, usando a sintaxe nome_coluna(length) para indexar os primeiros length() bytes de cada valor da coluna. (Para colunas BLOB e TEXT, um prexo length exigido; length() e pode ter um valor at 255 caracteres.) A instruo mostrada aqui cria um e ca indice usando os primeiros 10 caracteres da coluna name: mysql> CREATE INDEX part_of_name ON customer (name(10)); Como a maioria dos nomes normalmente diferem nos primeiros 10 caracteres, este indice no deve ser muito menor que um a indice criado com toda a coluna name. Alm disso, e usar colunas parciais como indices pode fazer o arquivo de indice muito menor, o que pode economizar muito espao em disco e pode tambm aumentar a velocidade de operaes c e co INSERT! Note que voc pode adicionar um e indice em uma coluna que pode ter valores apenas se voc e estiver usando o MySQL Verso 3.23.2 ou mais novo e estiver usando os tipos de tabelas a MyISAM, InnoDB, ou BDB. Voc s pode adicionar um e o indice em uma coluna BLOB/ TEXT se voc estiver usando o MySQL Verso 3.23.2 ou mais novo e estiver usando os tipos de tablea e a MyISAM ou BDB, ou MySQL Verso 4.0.14 ou mais novo e o tipo de tabela InnoDB. Para um a indice em uma coluna BLOB/TEXT, o tamanho do prexo sempre deve ser especicado. Uma especicao index_col_name pode nalizar com ASC ou DESC. Esta palavras chaves ca so permitidas para estenso futura para especicar o armazenamento do valor do a a indice em crescente ou decrescente. Atualmente elas so analisadas mas ignoradas; valores de a indice so sempre armazenados em ordem crescente. a Para mais detalhes sobre como o MySQL utiliza indices, veja Seo 5.4.3 [ ca Indices MySQL], Pgina 447. a

614

MySQL Technical Reference for Version 5.0.0-alpha

Ind ices FULLTEXT s podem indexar colunas CHAR, VARCHAR e TEXT, e apenas em tabelas o MyISAM. Indices FULLTEXT esto dispon a iveis no MySQL Verso 3.23.23 e posterior. Seo 6.8 a ca [Pesquisa Fulltext], Pgina 619. a

6.5.8 Sintaxe DROP INDEX

DROP INDEX nome_indice ON nome_tabela DROP INDEX apaga o indice chamado nome_indice da tabela nome_tabela. DROP INDEX no a faz nada nem verses do MySQL anteriores a 3.22. Na verso 3.22 ou posterior, DROP INDEX o a mapeada em uma instruo ALTER TABLE para apagar o e ca indice. Veja Seo 6.5.4 [ALTER ca TABLE], Pgina 608. a

6.6 Comandos Utilitrios Bsicos do Usurio MySQL a a a

6.6.1 Sintaxe USE
USE nome_db A instruo USE nome_bd diz ao MySQL para usar o banco de dados nome_bd como padro ca a para as consultas subsequentes. O banco de dados continua como o atual at o nal da e sesso ou at outra instruo USE ser executada: a e ca mysql> USE db1; mysql> SELECT COUNT(*) FROM mytable; # seleciona de db1.mytable mysql> USE db2; mysql> SELECT COUNT(*) FROM mytable; # seleciona de db2.mytable Torna um banco de dados particular como o atual no signica que a instruo USE no a ca a o permita acessar tabelas em outros bancos de dados. O exemplo seguinte acessa a tabela author do banco de dados db1 e a tabela editor do banco de dados db2: mysql> USE db1; mysql> SELECT author_name,editor_name FROM author,db2.editor -> WHERE author.editor_id = db2.editor.editor_id; A instruo USE fornecida para compatibilidade com o Sybase. ca e

6.6.2 Sintaxe DESCRIBE (Obtem Informaoes Sobre Colunas) c

{DESCRIBE | DESC} nome_tabela [nome_coluna | meta_carac] DESCRIBE um atalho para SHOW COLUMNS FROM. Veja Seo 4.6.8.1 [Show database info], a ca Pgina 303. a DESCRIBE fornece informao sobre as colunas da tabela. nome_coluna deve ser um nome ca de coluna ou uma string contendo os meta caracteres % e _ do SQL para ter a sa ida apenas com nomes que corespondam com a string. No necessrio colocar a string entre a e a aspas. Se os tipos de colunas so diferentes do esperado baseado nas instrues CREATE TABLE, a co note que algumas vezer o MySQL altera o tipo das colunas. Veja Seo 6.5.3.1 [Alterando ca colunas sem aviso], Pgina 607. a

Cap tulo 6: Referncia de Linguagem do MySQL e

615

Esta instruo fornecida para compatibilidade com Oracle. ca e A instruo SHOW fornece informao similar. Veja Seo 4.6.8 [SHOW], Pgina 302. ca ca ca a

6.7 Comandos Transacionais e de Lock do MySQL

6.7.1 Sintaxe de START TRANSACTION, COMMIT e ROLLBACK
Por padro, MySQL executado em modo autocommit. Isto signica que assim que voc a e e executa uma instruo que atualiza (modica) uma tabela, o MySQL armaena a atualizao ca ca no disco. Se voc estiver usando tabelas com segurana a transao (como InnoDB \ ou BDB), voc e c ca e pode colocar o MySQL em modo no autocommit com o seguinte comando: a SET AUTOCOMMIT=0 Depois de disabilitar o modo autocommit congurando a varivel AUTOCOMMIT com zero, a voc deve utilizar COMMIT para armazenar suas alteraes em disco ou ROLLBACK se voc e co e deseja ignorar as alteraes que voc fez desde o in da sua transao. co e icio ca Se voc quiser disabilitar o modo autocommit para uma unica srie de instrues, voc pode e e co e utiliar a instruo START TRANSACTION: ca START TRANSACTION; SELECT @A:=SUM(salary) FROM table1 WHERE type=1; UPDATE table2 SET summmary=@A WHERE type=1; COMMIT; BEGIN e BEGIN WORK podem ser usados em vez de START TRANSACTION para iniciar uma transao. START TRANSACTION foi adicionado no MySQL 4.0.11; ele uma sintaxe do ca e SQL-99 e o modo recomendado de iniciar umaa transao an ad-hoc. BEGIN e BEGIN WORK e ca esto dispon a iveis a partir do MySQL 3.23.17 e 3.23.19, respectivamente. Note que se voc estiver usando tabelas sem segurana a transao, quaisquer alteraes e c ca co sero armazenadas de uma vez, se considerar o status do modo autocommit. a Se voc executar uma instruo ROLLBACK depois de atualizar uma tabela no-transacional, e ca a voc obter um erro (ER_WARNING_NOT_COMPLETE_ROLLBACK), como um aviso. Todas as e a tabelas seguras a transao sero restauradas mas qualquer tabela se segurana a transao ca a c ca no sofrero alteraes. a a co Se voc estiver usando START TRANSACTION ou SET AUTOCOMMIT=0, voc deve usar o log e e binrio do MySQL para backup no lugar do antigo log de atualizao. Transaes so a ca co a armazenadas no log binrio em um bloco, sobre COMMIT, para assegurar que transaes nas a co quais foram feitas rolled back no foram armazenadas. Veja Seo 4.10.4 [Log binrio], a ca a Pgina 374. a Voc pode alterar o n isolao para transaes com SET TRANSACTION ISOLATION LEVEL. e ivel ca co Veja Seo 6.7.6 [SET TRANSACTION], Pgina 619. ca a

616

MySQL Technical Reference for Version 5.0.0-alpha

6.7.2 Instrues que No Podem Ser Desfeitas co a

No se pode fazer o roll back de algumas instrues. Em geral, elas incluem instrues DDL a co co (data denition language), como aquelas que criam ou removem banco de dados, ou aquelas que criam, apagam ou alteram tabelas. Voc pode desejar projetar as suas transaes para no incluir estas instrues. Se voc e co a co e executar uma instruo da quale no se pode fazer roll back em uma transao, e ento ca a ca a outra intrues falhar posteriormente, o efeito total da transao no pode ser desfeito co ca a usando uma instruo ROLLBACK. ca

6.7.3 Instrues que Fazem um Commit Implicito co

Os seguintes comandos nalizam uma transao implicitamente (como se voc tivesse feito ca e um COMMIT antes de executar o comando): Comando Comando Comando ALTER TABLE BEGIN CREATE INDEX DROP DATABASE DROP INDEX DROP TABLE LOAD MASTER DATA LOCK TABLES RENAME TABLE SET AUTOCOMMIT=1 START TRANSACTION TRUNCATE UNLOCK TABLES tambm naliza uma transao se qualquer tabela estiver atualmente bloe ca queada. Antes do MySQL 4.0.13, CREATE TABLE naliza uma transao se o log binrio est ca a a habilitado. Transaes no podem ser aninhadas. Isto uma consequncia do COMMIT impl co a e e icito realizado por qualquer transao atual quando voc envia uma instruo START TRANSACTION ou um ca e ca de seus sinnimos. o

6.7.4 Sintaxe de SAVEPOINT e ROLLBACK TO SAVEPOINT

A partir do MySQL 4.0.14 e 4.1.1. o InnoDB suporta os comando SQL SAVEPOINT e ROLLBACK TO SAVEPOINT. SAVEPOINT identificador Esta instruo congura um savepoint de uma transao cujo nome identificador. Se ca ca e a transao atual j tiver um savepoint com o mesmo nome, o savepointy antigo deletado ca a e o novo denido. e e ROLLBACK TO SAVEPOINT identificador Esta instruo faz o roll back de uma transao at o savepoint indicado. Modicaes feitas ca ca e co nesta transao aps o savepoint foram denidas como desfeitas no roll back, mas o InnoDB ca o no libera o lock de linha que forma arnmazenados na memria depois do savepoint. (Note a o que para uma nova linha inserida, a informao do lock carregada pala ID da transao ca e ca armazenada na linha; o lock no armazenado separadamente na memria. Neste caso, o a e o lock de linha liberado no undo.) Sevapoints que foram denidos aps o sevepoint indicado e o so deletados. a Se o comando retorna o seguinte erro, signica que no existem savepoints como o nome a especicado.

Cap tulo 6: Referncia de Linguagem do MySQL e

617

ERROR 1181: Got error 153 during ROLLBACK Todos os savepoints da transao atual so deletados se voc executar um COMMIT ou um ca a e ROLLBACK que no chamou um savepoint. a

6.7.5 Sintaxe LOCK TABLES e UNLOCK TABLES

LOCK TABLES nome_tabela [AS alias] {READ [LOCAL] | [LOW_PRIORITY] WRITE} [, nome_tabela [AS alias] {READ [LOCAL] | [LOW_PRIORITY] WRITE} ...] ... UNLOCK TABLES LOCK TABLES bloqueia tabelas para a thread atual. UNLOCK TABLES libera qualquer trava existente para a thread atual. Todas as tabela que esto bloqueadas pela thread atual so a a implicitamente desbloquadas quando a thread executa um outro LOCK TABLES, ou quando a conexo ao servidor fechada. a e Para usar LOCK TABLES no MySQL 4.0.2 voc precisa do privilgio global LOCK TABLES e e e um privilgio SELECT nas tabelas envolvidas No MySQL 3.23 voc precisa ter os privilgios e e e SELECT, insert, DELETE e UPDATE para as tabelas. A razo principal para utilizar LOCK TABLES para emular transaes ou obter mais velocia e co dade ao atualizar tabelas. Isto explicado em mais detalhes posteriormente. e Se uma thread obtem uma trava de leitura (READ) em uma tabela, aquela thread (e todas as outras threads) s podero ler da tabela. Se uma thread obter uma trava de escrita (WRITE) o a na tabela, apenas a thread que bloqueou poder ler ou escrever na tabela. Outras threads a sero bloqueadas. a A diferena entre READ LOCAL e READ que READ LOCAL permite que instrues INSERT no c e co a conitantes sejam executadas enquanto a trava est ativa. Isto, no entatnto, no pode ser a a usado se voc for manipular o arquivo de banco de dados fora do MySQL enquanto a trava e estiver ativa. Quando voc usa LOCK TABLES, voc deve travar todas as tabelas que voc for usar e utilizar e e e o mesmo alias que estiver utilizando em suas consultas! Se voc estiver usando uma tabela e vrias vezes em uma consulta (com aliases), voc deve obter um trava para cada alias. a e Bloqueio de escrita (WRITE) normalmente tm maior prioridade que bloqueio de leitura e (READ), para assegurar que atualizaes so processadas assim que poss co a ivel. Isto signica que se uma thread obtida um bloqueio de leitura (READ) e outra thread requisitar um bloqueio de escrita (WRITE), bloqueios de leitura (READ) subsequentes iro esperar at a a e thread de escrita (WRITE) tiver obtido a trava e a liberado. Voc pode usar travas LOW_ e PRIORITY WRITE para permitir que outras threads obtenham bloqueios de leitura (READ) enquanto a thread estiver esperando pela trava de escrita (WRITE). Voc s deve utilizar e o bloqueios LOW_PRIORITY WRITE se voc estiver certo que haver um momento onde nenhuma e a thread ter bloqueio de leitura (READ). a LOCK TABLES funciona da seguinte maneira: 1. Ordene todas as tabelas a serem travadas em uma ordem denida internamente (do ponto do usurio a ordem indenida). a e 2. Se uma tabela bloqueada com uma trava de leitura e de escrita, coloque a trava de e escrita antes da trava de leitura.

618

MySQL Technical Reference for Version 5.0.0-alpha

3. Bloqueie uma tabela por vez at que a thread obtenha todas as travas. e Esta pol itica assegura que as tabelas sejam bloqueadas sem deadlock. H no entanto outra a coisa da qual preciso estar ciente neste esquema: e Se coc estiver usando uma trava de escita LOW_PRIORITY WRITE em uma tabela, signica e apenas que o MySQL ir esperar por esta trava particular at que no haja mais treads a e a fazendo um bloqueio de leitura (READ). Quando a thread tiver obtido a trava de escrita (WRITE) e est esperando ppo obter o trava para a prxima tabela na lista de tabelas a o bloqueadas, todas as outras threads iro esperar que a trva de escrita (WRITE) seja liberada. a Se isto tornar um srio problema com sua aplicao, voc deve converter algumas de suas e ca e tabellas para tabelas com segurana em transaes. c co Voc pode matar com segurana um thread que est esperando por um bloqueio de tabela e c a com KILL. Veja Seo 4.6.7 [KILL], Pgina 301. ca a Note que voc no deve travar nenhuma tabela que voc esteja usando com INSERT DELAYED. e a e Isto porque este o caso que o INSERT feito por uma thread separada. e e e Normalmente, voc no tem que travar tabelas, j que todas as instrues UPDATE so atome a a co a icas; nenhuma outra thread pode interferir com qualquer outra executando uma instruo ca SQL. Existem poucos casos em que voc gostaria de travar as tabelas de qualquer forma: e Se voc for executar operaes em um grupo de tabelas, muito mais rpido travar as e co e a tabelas que voc for utilizar. O lado ruim que nenhuma outra thread pode atualizar e e uma tabela travada para leitura (READ) (incluindo aquela que guarda o lock) e nenhuma outra thread pode ler uma tabela bloqueada para escrita (WRITE) alm daquele que e guarda o lock. A razo de algumas coisas serem rpidas sob LOCK TABLES que o MySQL no ir a a e a a descarregar a cache de tabelas bloqueadas at que UNLOCK TABLES seja chamado (nore malmente a cache de chaves descarregada a cada instruo SQL). Isto aumenta a e ca velocidade de insero, atualizao e deleo) em tabelas MyISAM. ca ca ca Se voc estiver usando um mecanismo de armazenamento no MySQL que no suporte e a transaes, voc deve usar LOCK TABLES se voc quiser se assegurar que nenhuma outra co e e thread venha entre um SELECT e um UPDATE. O exemplo mostrado aqui exige LOCK TABLES para ser executado com segurana: c mysql> mysql> mysql> -> mysql> LOCK TABLES trans READ, customer WRITE; SELECT SUM(value) FROM trans WHERE customer_id=some_id; UPDATE customer SET total_value=sum_from_previous_statement WHERE customer_id=some_id; UNLOCK TABLES;

Sem LOCK TABLES, existe uma chance que outra thread possa inserir uma nova linha na tabela trans entre a execuo das instrues SELECT e UPDATE. ca co Utilizando atualizaes incrementais (UPDATE customer SET value=value+new_value) ou co a funo LAST_INSERT_ID()i, voc pode evitar o uso de LOCK TABLES em muitos casos. ca e Voc tambm pode resolver alguns casos usando as funes de bloqueio a n de usurio e e co ivel a GET_LOCK() e RELEASE_LOCK(). Estas travas so salvas em uma tabela hash no servidor e a implementado com pthread_mutex_lock() e pthread_mutex_unlock() para alta velocidade. Veja Seo 6.3.6.2 [Funes diversas], Pgina 547. ca co a

Cap tulo 6: Referncia de Linguagem do MySQL e

619

Veja Seo 5.3.1 [Internal locking], Pgina 443, para mais informaes sobre pol ca a co itica de bloqueios. Voc pode trocar todas as tabelas em todos os banco de dados com trava de leitura com e o comando FLUSH TABLES WITH READ LOCK. Veja Seo 4.6.4 [FLUSH], Pgina 299. Este ca a e um modo muito conveiente de tirar backups se voc tiver um sistema de arquivos, como e Veritas, que pode tirar snapshots. NOTE: LOCK TABLES mo seguro com transaes e far um commit implicitamente em a e co a qualquer transao ativa antes de tentar travar as tabelas. ca

6.7.6 Sintaxe SET TRANSACTION

SET [GLOBAL | SESSION] TRANSACTION ISOLATION LEVEL { READ UNCOMMITTED | READ COMMITTED | REPEATABLE READ | SERIALIZABLE } Dene o n de isolao da transao para global, toda a sesso ou a prxima transao. ivel ca ca a o ca O comportamento padro denir o n a e ivel de isolao para a prxima (no iniciada) ca o a transao. Se voc usa a palavra-chave GLOBAL, a instruo dene o nivel de transao ca e ca ca padro globalmente para todas as novas conexes criadas a partir deste ponto (mas no a o a existe conexo). Voc precisa do privilgio SUPER para fazer isto. Usar a palavra-chave a e e SESSION dene o n de transao padro para todas a transaes futuras relaizadas na ivel ca a co conexo atual. a Para a descrio de cada n ca ivel de isolao da transao do InnoDB, veja Seo 7.5.9.1 ca ca ca [InnoDB transaction isolation], Pgina 662. O InnoDB suporta cada um destes n a iveis a padro REPEATABLE READ. partir do MySQL 4.0.5. O nivel a e Voc pode denir o nivel de isolao global padro para o mysqld com --transactione ca a isolation=.... Veja Seo 4.1.1 [Opes de linha de comando], Pgina 207. ca co a

6.8 Pesquisa Full-text no MySQL

MATCH (col1,col2,...) AGAINST (expr [IN BOOLEAN MODE | WITH QUERY EXPANSION] ) A partir da verso 3.23.23, MySQL tem suporte para indexao e busca full-text. a ca Indices full-text no MySQL so um a indice do tipo FULLTEXT. Indices FULLTEXT so usados apenas a com tabelas MyISAM e podem ser criadas a partir de colunas CHAR, VARCHAR ou TEXT durante um CREATE TABLE ou adicionados posteriormente com ALTER TABLE ou CREATE INDEX. Para banco de dados maiores, ser muito mais rpido carregar seus dados em uma tabela que no a a a tnha indices FULLTEXT, que criar o indice com ALTER TABLE (ou CREATE INDEX). Carregar dados em uma tabela que j tenha um a indice FULLTEXT ser muito mais lento. a Pesquisa full-text realizada com a funo MATCH(). e ca mysql> CREATE TABLE articles ( -> id INT UNSIGNED AUTO_INCREMENT NOT NULL PRIMARY KEY, -> title VARCHAR(200), -> body TEXT, -> FULLTEXT (title,body) -> ); Query OK, 0 rows affected (0.00 sec)

620

MySQL Technical Reference for Version 5.0.0-alpha

mysql> INSERT INTO articles VALUES -> (NULL,MySQL Tutorial, DBMS stands for DataBase ...), -> (NULL,How To Use MySQL Efficiently, After you went through a ...), -> (NULL,Optimizing MySQL,In this tutorial we will show ...), -> (NULL,1001 MySQL Tricks,1. Never run mysqld as root. 2. ...), -> (NULL,MySQL vs. YourSQL, In the following database comparison ...), -> (NULL,MySQL Security, When configured properly, MySQL ...); Query OK, 6 rows affected (0.00 sec) Records: 6 Duplicates: 0 Warnings: 0 mysql> SELECT * FROM articles -> WHERE MATCH (title,body) AGAINST (database); +----+-------------------+------------------------------------------+ | id | title | body | +----+-------------------+------------------------------------------+ | 5 | MySQL vs. YourSQL | In the following database comparison ... | | 1 | MySQL Tutorial | DBMS stands for DataBase ... | +----+-------------------+------------------------------------------+ 2 rows in set (0.00 sec) A funo MATCH() realiza um busca de linguagem natural por uma string contra uma coleo ca ca de texto (um conjunto de uma ou mais colunas incluidas em um indice FULLTEXT). A string pesquisada dada como o argumento de AGAINST(). A busca realizada na forma casoe e insensitivo. Para cada uma das linhas da tabela, MATCH() retorna um valor relevante, isto , uma medida de similaridade entre a string pesquisada e o texto naquela nas colunas e identicadas na lista MATCH(). Quando MATCH() utilizado na clusula WHERE (veja exemplo acima) as linhas retornadas e a so automaticamente ordenadas com a maior relevncia primerio. Valores de relevncia so a a a a nmeros de ponto utuante no negativos. Relevncia zero signica nenhuma similaridade. u a a Relevncia computado baseada no nmero de palavras na linha, o nmero de palavras a e u u unica naquela linha, o nmero de palavras na coleo e o nmero de documentos (linhas) u ca u que contenham uma palavra particular. Tambm poss realizar uma busca no modo booleano. Isto explicado posteriormente e e ivel e nesta seo. ca O exemplo precedente uma ilustro bsica mostrando como usar a funo MATCH(). e ca a ca Linhas so retornodas em ordem decrescente de relevncia. a a O prximo exemplo mostra como retornar o valores de relevncia explicitamente. Como o a nem a clusula WHERE nem a ORDER BY esto presentes, as linhas so retornadas fora de a a a ordem. mysql> SELECT id,MATCH (title,body) AGAINST (Tutorial) FROM articles; +----+-----------------------------------------+ | id | MATCH (title,body) AGAINST (Tutorial) | +----+-----------------------------------------+ | 1 | 0.64840710366884 | | 2 | 0 |

Cap tulo 6: Referncia de Linguagem do MySQL e

621

| 3 | 0.66266459031789 | | 4 | 0 | | 5 | 0 | | 6 | 0 | +----+-----------------------------------------+ 6 rows in set (0.00 sec) O exemplo seguinte mais complexo. A consulta retorna a relevncia e ainda ordena e a as linhas em ordem decrescente de relevncia. Para conseguir este resultado, voc deve a e especicar MATCH() duas vezes. Isto no ir causar sobrecarga adicional, pois o otimizador a a MySQL ir notar que duas chamadas MATCH() so idnticas e invocam o cdigo da busca a a e o full-text apenas uma vez. mysql> SELECT id, body, MATCH (title,body) AGAINST -> (Security implications of running MySQL as root) AS score -> FROM articles WHERE MATCH (title,body) AGAINST -> (Security implications of running MySQL as root); +----+-------------------------------------+-----------------+ | id | body | score | +----+-------------------------------------+-----------------+ | 4 | 1. Never run mysqld as root. 2. ... | 1.5055546709332 | | 6 | When configured properly, MySQL ... | 1.31140957288 | +----+-------------------------------------+-----------------+ 2 rows in set (0.00 sec) Desde a verso 4.1.1, pesquisas full-text suportam expanso de consulta (em particular, a a sua variante blind query expansion). Ela geralmente util quando uma frase pesquisada e muito curta, o que normalmente signica que um usurio est conando em um cone a a hecimento contido, que a pesquisa full-text normalmente perde. Por exemplo, um usuario pesquisanado por database podem realmente signicar que MySQL, Oracle, DB2, RDBMS so todas frases que devem coincidir com databases e devem ser encontrados a tambm. Isto conhecimento contido. Blind query expansion (also known as automatic e e relevance feedback) works by performing the search twice, where the search phrase for the second search is the original search phrase concatenated with the few top found documents from the rst search. Thus, if one of these documents contained the word databases and the word MySQL, then the second search will nd the documents that contain the word MySQL but not database. Another example could be searching for books by Georges Simenon about Maigret, when a user is not sure how to spell Maigret. Then, searching for Megre and the reluctant witnesses will nd only Maigret and the Reluctant Witnesses without query expansion, but all books with the word Maigret on the second pass of a search with query expansion. Note: because blind query expansion tends to increase noise signicantly, by returning non-relevant documents, its only meaningful to use when a search phrase is rather short. O MySQL utiliza um analizados muito simples para separar texto em palavras. Uma palavra uma sequncia de caracteres consistindo de letras, digitos, , e _. Quale e quer palavra presente na lista de palavra de parada ou for muito curta ignorada. O e tamanho padro m a inimo das palavras que sero encontradas pela pesquisa full-text de quaa e tro caracteres. Isto pode ser alterado como descrito em Seo 6.8.2 [Fulltext Fine-tuning], ca Pgina 624. a

622

MySQL Technical Reference for Version 5.0.0-alpha

Toda palavra correta na lista de colees e na consulta pesada de acordo com sua sigco e nicncia na consulta ou coleo. Deste modo, uma palavra que est presente em vrios a ca a a documentos ter peso menor (e poder ter at mesmo um peso zero), j que ele tm um a a e a e valor semntico baixo nesta coleo particular. Por outro lado, se a palavra rara, ela recea ca e ber um peso alto. O peso das palavras so ento combinados para computar a relevncia a a a a das linhas. Tal tcnica funciona melhor com colees grandes (de fato, ela cuidadosamente ajustado e co e deste modo). Para tabelas muito pequenas, a distribuio das palavras no reetem adeca a quadamente seus valores semnticos, e este modelo pode algumas vezes produzir resultados a bizarros. mysql> SELECT * FROM articles WHERE MATCH (title,body) AGAINST (MySQL); Empty set (0.00 sec) A busca pela palavra MySQL no produz resultados no exemplo acima, porque esta palavra a est presente em mais da metade das linhas. Como tal, ela efetivamente tratada como a e palavra de parada (isto , uma palavra com valor semntico zero). Este o comportamento e a e mais desejvel uma consulta de linguagem natural no deve retornar toda segunda linha a a de uma tabela de 1 GB. Uma palavra que casa com metade dos registros em uma tabela tem menos chance de encontrar dosumentos relevantes. De fato, muito mais provvel encontrar vrios documentos e a a irrelevantes. Todos ns sabemos que isto acontece com muita frequncia quando tentamos o e encontrar alguma coisa na internet com um mecanismo de busca. E com esta razo que estes a registros tem sido atribu com um baixo valor semntico neste banco de dados particular. ido a Na verso 4.0.1, MySQL tambm pode realizar buscas full-text booleanas usando o modia e cador IN BOOLEAN MODE. mysql> SELECT * FROM articles WHERE MATCH (title,body) -> AGAINST (+MySQL -YourSQL IN BOOLEAN MODE); +----+------------------------------+-------------------------------------+ | id | title | body | +----+------------------------------+-------------------------------------+ | 1 | MySQL Tutorial | DBMS stands for DataBase ... | | 2 | How To Use MySQL Efficiently | After you went through a ... | | 3 | Optimizing MySQL | In this tutorial we will show ... | | 4 | 1001 MySQL Tricks | 1. Never run mysqld as root. 2. ... | | 6 | MySQL Security | When configured properly, MySQL ... | +----+------------------------------+-------------------------------------+ Esta consulta recupera todos os registros que contenham a palavra MySQL (note: o ponto inicial de 50% no utilizado), mas que no contenha a palavra YourSQL. Note que a a e a pesquisa em modo booleano no ordena os registros automaticamente em ordem decrescente a de relevncia. Voc pode ver isto no resultado da consulta anterior, onde a linha com a maior a e relevncia (aquela que contm MySQL duas vezes) listada por ultimo, no em primeiro. a e e a Um busca full-text booleana tambm pode funcionar mesmo sem um indice FULLTEXT, no e entanto ela seria lenta. A busca full-text booleana suporte potencialmente as seguintes operaes: co + Um sinal de mais precedente indica que esta palavra deve estar presente em cada linha retornada.

Cap tulo 6: Referncia de Linguagem do MySQL e

623

Um sinal de menos precedente indice que esta palavra no deve estar presente a em qualquer linha retornada. Por padro (quando nem mais nem menos especicado) a palavra opcional, a e e mas as linhas que a contm sero avaliadas positivamente. Isto dene o come a portamento de MATCH() ... AGAINST() sem o modicados IN BOOLEAN MODE.

<>

Estes dois operadores so usados para alterar a contribuio de uma palvara a ca no valor de relevncia que tribu a um registro. O operador < reduz a a a ido contribuio e o operador > a aumenta. Veja o exemplo abaixo. ca Parenteses so usado para agrupar palavras em subexpresses. a o Um til precedente atua como um operador de negao, tornando a contribuio ca ca da palavra para a relevncia da linha ser negativa. Ele util para marcar a e palavras "ruidosas". Linhas com tais palavras tero uma avaliao mais baixa a ca que outras, mas no ser exclu a a ida, como seria com o operador -. Um asterisco um operador de truncamento. Diferente dos outros operadores, e ele deve ser inserida ao m da palavra, no deve ser precedente. a A frase que colocada entre aspas duplas ", coincidem apenas com linhas que e contenha esta frase literalmente, como foi digitada.

() ~

* "

E aqui esto alguns exeplos: a apple banana encontra linhas que contenha pela menos uma destas palavras. +apple +juice ... ambas as palavras. +apple macintosh ... palavra apple, mas avaliada mais alto se tambm conter macintosh. e +apple -macintosh ... palavra apple mas no macintosh. a +apple +(>turnover <strudel) ... apple e turnover, ou apple e strudel (em qualquer ordem), mas avalia apple pie melhor que apple strudel. apple* ... apple, apples, applesauce, e applet. "some words" ... some words of wisdom, mas no some noise words. a

6.8.1 Restries Full-text co

Pesquisas full-text so suportadas apenas por tabelas MyISAM. a Pesquisas full-text pode ser usadas com UCS-2 (mas funcionam com UTF-8 a partir do MySQL 4.1.1). Todos os parmetros da funo MATCH() devem ser colunas da mesma tabela que a ca e parte do mesmo indice FULLTEXT, a menos que MATCH() esteja IN BOOLEAN MODE.

624

MySQL Technical Reference for Version 5.0.0-alpha

Todas as colunas no indice FULLTEXT devem ter o mesmo conjunto de caracter. A lista de coluna MATCH() deve casar exatamente a lista de colunas em algum denio ca de indice FULLTEXT para a tabela, a menos que este MATCH() seja IN BOOLEAN MODE. O argumento para AGAINST() deve ser uma string constante.

6.8.2 Ajuste Fino de Pesquisas Full-text no MySQL

Infelizmente, pesquisas full-text ainda possui poucos parmetros de ajuste, embora adicionar a alguns seja de grande prioridade no TODO. Se voc tiver uma distribuio fonte do MySQL e ca (veja Seo 2.3 [Instalando o fonte], Pgina 94), voc pode exercer maior controle sobre o ca a e comportamenteo de pesquisas full-text. Note que o busca full-text foi cuidadosamente ajustada para a melhor busca efetiva. Mocar o comportamento padro ir, na maioria dos casos, apenas tornar os resultados de a a busca piores. No alteren o fonte do MySQL a menos que voc saiba o que est fazendo! a e a A descrio das variveis full-text na lista a seguir devem ser conguradas no servidor na ca a inicializao. Voc no pode modic-los dinamicamente enquanto o servidor estiver em ca e a a execuo. ca O tamanho m inimo de palavras a serem indexadas denido pela variavel ft_min_ e word_len do MySQL. Veja Seo 4.6.8.4 [ft_min_word_len], Pgina 309. ca a (Esta varivel s est dispon a partir do MySQL verso 4.0.) a o a ivel a O valor padro quatro caracteres. Altere-o para o valor de sua preferncia e reconstrua a e e os seus indices FULLTEXT. Por exemplo, se voc quiser pesquisar palavras de trs e e caracteres, voc pode denir esta varivel colocando a seguinte linha no arquivo de e a opes: co [mysqld] ft_min_word_len=3 Ento reinicie o servidor e reconstrua seus a indices FULLTEXT. A lista de palavras de parada pode ser carregada do arquivo especicado pela varivel a ft_stopword_file. Veja Seo 4.6.8.4 [ft_stopword_file], Pgina 309. Reconstrua ca a o seu indice FULLTEXT depois de modicar a lista de palavras de parada. (Esta varvel a a partir do MySQL verso 4.0.10 e posterior) s est disponivel o a a O ponto inical de 50% determinado pelo esquema de pesagem particular escolhido. e Para disabilit-lo, altere a seguinte linha em myisam/ftdefs.h: a #define GWS_IN_USE GWS_PROB Para: #define GWS_IN_USE GWS_FREQ Ento recompile o MySQL. No h necessidade de reconstruir o a a a indice neste caso. Note: fazendo isto voc diminui em muito a habilidade do MySQL fornecer valores de e relevncia adequados para a funo MATCH(). Se voc realmente precisa buscar por tais a ca e palavras comuns, seria melhor faz-lo utilizando IN BOOLEAN MODE, que no observa o e a poonto inicial de 50%. Algumas vezes o mantedor do mecanismo de busca gostaria de alterar os operadores usados por busca full-text boolanas. Eles so denidos pela varivel ft_boolean_ a a

Cap tulo 6: Referncia de Linguagem do MySQL e

625

syntax. Veja Seo 4.6.8.4 [ft_boolean_syntax], Pgina 309. Ainda, esta varivel ca a a e somente leitura; este valor est denido em myisam/ft_static.c. a Para mudanas full-text que exigem que voc reconstrua seu c e indice FULLTEXT, o modo mais fcil de faz-lo para uma tabela MyISAM usar a seguinte instruo, a qual reconstroi o a e e ca arquivo de indice: mysql> REPAIR TABLE nome_tabela QUICK;

6.8.3 TODO de Pesquisas Full-text

Fazer todas as operaes com co indices FULLTEXT mais rpidas. a Operadores de proximidade Supporte para "always-index words". Elas poderiam ser quaisquer strings que o usurio a quisesse tratar como palavra, os exemplos so "C++", "AS/400", "TCP/IP", etc. a Suporte a busca full-text em tabelas MERGE. Suporte a UCS-2. Tornar a lista de palavras de parada dependente da linguagem dos dados. Stemming (dependente da linguagem dos dados. claro). e Pre-analizadores de UDF genricas fornecidas pelo usurio. e a Tornar os modelos mais exiveis (adicionando algum parmetro ajsutvel a FULLTEXT a a em CREATE/ALTER TABLE).

6.9 Cache de Consultas do MySQL

A partir da verso 4.0.1, O servidor MySQL dispes do recurso Query Cache (cache de a o consultas). Quando em uso, o cache de consultas armazena o textop de uma consulta SELECT junto com o resultado correspondente que foi enviado para o cliente. Se uma consulta identica recebida mais tarde, o servidor retornar o resultado da cache de consultas ao e a invs de analisar e executar a mesma consulta novamente. e NOTE: A cache de consulta no retornam dados antigos. Quando o dado modicado, a e qualquer entrada relevante na cache de consulta atualizado. e A cache de consultas extremamente util em um ambiente onde (algumas) tabelas no e a mudam com frequncia e voc tem vrias consultas idnticas. Esta uma situao t e e a e e ca ipica em muitos servidores web que utilizam muito contedo dinmico. u a Abaixo est algumas performances de dados da cache de consultas. (Estes resultado foram a gerados rodando o pacote de benchmark do MySQL em um Linux Alpha 2 x 500 MHz com 2 GB RAM e uma cache de consultas de 64 MB): Se todas as consultas que voc estiver realizando forem simples (tais como selecionar e um registro de uma tabela com um registro); mas ainda diferente daquelas em que as consultas no so armazendas, a sobrecarga de ter a cache de consultas ativa de a a e 13%. Este pode ser considerado como o cenrio de pior caso. No entanto, na vida real, a consultas so muito mais complicadas que nosso exemplo simples, assim a sobrecarga a , normalmente, signicantemente menor. e

626

MySQL Technical Reference for Version 5.0.0-alpha

Buscas depois de uma linha em uma tabela de uma linha 238% mais rpido. Isto e a pode ser considerado perto do m inimo de ganho a ser esperado para uma consulta que est armazenada. a Se voc quiser disabilitar o codigo da cache de consulta dena query_cache_size=0. e Disabilitando o cdigo da cache de consultas no haver nenhuma sobrecarga notvel. o a a a do cdigo com ajuda da opo de conigurao (cache de consultas pode ser excluido o ca ca --without-query-cache)

6.9.1 Como a Cache de Consultas Opera

Consultas so comparadas antes da anlise, logo a a SELECT * FROM nome_tabela e Select * from nome_tabela so consideradas consultas diferentes pela cache de consulta, assim consultas precisam ser a exatamente a mesma (byte a byte) para serem vistas como idnticas. Alm disso, uma e e consulta pode ser vista como diferente se, por exemplo, um cliente estiver usando um novo formato de protocolo de comunicao ou um conjunto de caracteres diferente de outro ca cliente. Cansultas que utilizam banco de dados diferentes, utilizam verses de protocolos diferentes o ou que usam conjunto de caracters padro diferentes so considerados consultas diferentes a a e armazenadas separadamente. A cache funciona para consultas do tipo SELECT SQL_CALC_FOUND_ROWS ... e SELECT FOUND_ROWS() ... porque o nmero de registros encontrados tambm armazenado na u e e cache. Se o resultado da consulta foi retornado da cache de consultas, ento o estado da varivel a a Com_select no ir ser aumentado, mas Qcache_hits ser. Veja Seo 6.9.4 [Estado e a a a ca Manuteno da Cache de Consultas], Pgina 628. ca a Se uma tabela alterada (INSERT, UPDATE, DELETE, TRUNCATE, ALTER ou DROP e TABLE|DATABASE), ento todas as caches de consulta que utilizam esta tabela a (possivelmente atarvs de uma tabela MRG_MyISAM!) se torna invlida e removida da e a e cache. Tabelas InnoDB transacionais que foram alteradas sero invalidadas quando um COMMIT a e realizado. No MySQL 4.0 a cache de consulta est disbilitada dentro da transao (ela no retorna a ca a resultados), mas a partir da verso 4.1.1 as caches de consultas funcionaro com tabelas a a InnoDB dentro da transao (ela usar o nmero da verso da tabela para detectar se a ca a u a data atual ou no). e a Antes da verso 5.0, consultas com comentrios na mesma linha no podem ser trazidas da a a a cache (mas elas sero colocadas na cache se satisfazerem outras condies). a co Uma consulta no pode ser armazenada em cache se contem uma das funes: a co Funo ca Funo ca Funo ca Fun~es Definidas por co CONNECTION_ID FOUND_ROWS Usuarios

Cap tulo 6: Referncia de Linguagem do MySQL e

627

GET_LOCK RELEASE_LOCK LOAD_FILE MASTER_POS_WAIT NOW SYSDATE CURRENT_TIMESTAMP CURDATE CURRENT_DATE CURTIME CURRENT_TIME DATABASE ENCRYPT (com um parmetro) LAST_INSERT_ID a RAND UNIX_TIMESTAMP (sem USER BENCHMARK parmetros) a Um consulta no pode ser armazenada em cache se conter variveis, referenciar o a a banco de dados do sistema mysql, for da forma SELECT ... IN SHARE MODE, SELECT ... INTO OUTFILE ..., SELECT ... INTO DUMPFILE ... ou da forma SELECT * FROM AUTOINCREMENT_FIELD IS NULL (para retornar a ID da ultima insero - ODBC contorna ca este problema). No entanto, FOUND_ROWS() retornar o valor correto, mesmo se a consulta precedente foi a buscada da cache. No caso de uma consulta no utilizar qualquer tabela, ou utilizar tabelas temporrias, ou a a se o usurio tiver um privilgio de coluna para qualquer tabela chamada, esta consulta no a e a ser armazenada em cache. a Antes de uma consulta ser trazida da cache de consulta, o MySQL ir vericar se o usurio a a com privilgio SELECT para todos os banco de dados e tabelas envolvidos. Se este no for e a o caso, o resultado em cache no ser usado. a a

6.9.2 Congurao da Cache de Consultas ca

A cache de consultas adiciona algumas variveis do sistema MySQL para mysqld os quais a podem ser denidos em um arquivo de congurao, na linha de comando ao iniciar mysqld. ca query_cache_limit No armazene em cache resultados que so maiores que isto. a a (Padro 1M). a query_cache_min_res_unit Esta varivel est presente a partir da verso 4.1. a a a O resultado de uma consulta (os dados que tambm so enviados ao cliente) are a e mazenado na cache de consulta durante o recuperao do resultado. Consequentemente ca o dado normalmente no tratado em um grande bloco. A cache de de conaultas aloca a e blocos para armazenar o dado em demanda, assim quando um bloco preenchido, um e novo bloco alocado. Como a operao de alocao de memria caro, a cache de cone ca ca o e sulta aloca blocos com um tamanho m inimo de query_cache_min_res_unit. Quando a consulta executada, o ultimo bloco do resultado cortado para o tamanho atual do e e dado, assim a memria sem uso liberada. o e O valor padro de query_cache_min_res_unit 4 KB o qual deve ser adequada a e para a maioria dos casos. Se voc tiver vrias consultas com resultados pequenos, o tamanho padro do e a a bloco pode levar a fragmentao de memria (indicado por um grande nmero de ca o u blocos livres (Qcache_free_blocks), que podem fazer a cache de consultas deletar consultas da cache devido a perda de memria) (Qcache_lowmem_prunes)). Neste o caso voc deve diminuir query_cache_min_res_unit. e

628

MySQL Technical Reference for Version 5.0.0-alpha

Se voc tem muitas consultas com resultados grandes (veja Qcache_total_blocks e e Qcache_queries_in_cache),voc pode aumentar a performance aumentadno e query_cache_min_res_unit. No entanto, seja cuidadoso para no torn-lo muito a a grande (veja o ponto anterior). query_cache_size A quantidade de memria (especicada em bytes) alocada para o armazenar resultados de consultas antigas. Se ele for 0, a cache de consultas est a desbilitada (padro). a query_cache_type Pode ser atribuido (apenas numrico) com e Opo ca Descrio ca 0 (OFF, no armazene ou retorne resultados) a 1 (ON, armazene todos os resultados, exceto consultas SELECT SQL_ NO_CACHE ...) 2 (DEMAND, armazene apenas cconsultas SELECT SQL_CACHE ...) Dentro de uma thread (conexo), o comportamento da cache de consulta pode ser alterado a do padro. A sintaxe a seguinte: a e QUERY_CACHE_TYPE = OFF | ON | DEMAND QUERY_CACHE_TYPE = 0 | 1 | 2 Opo ca Descrio ca 0 or OFF No armazene ou recupere resultados a 1 or ON Aramazene todos os resultados exceto consultas SELECT SQL_ NO_CACHE .... 2 or DEMAND Armazene apenas consultas SELECT SQL_CACHE ....

6.9.3 Opes da Cache de Consultas na SELECT co

Existem duas possibilidades de parmetros relacionados a cache de consultas que podem a ser especicados em uma consulta SELECT: Opo ca Descrio ca SQL_CACHE Se QUERY_CACHE_TYPE DEMAND, permite que a query seja armazenada e em cache. Se QUERY_CACHE_TYPE ON, este o padro. Se QUERY_ e e a CACHE_TYPE OFF, no faz nada. e a SQL_NO_CACHE Faz esta consulta no armazenvel em cache, no permite que esta a a a consulta seja armazenada em cache.

6.9.4 Estado e Manuteno da Cache de Consultas ca

Com o comando FLUSH QUERY CACHE voc pode desfragmentar a cache de consultas para e melhor utilizar a memria. Este comnado no remover qualquer consulta da cache. FLUSH o a a TABLES tambm descarrega a cache de consultas. e O camnado RESET QUERY CACHE remove todas os resultados de consultas da cache de consultas. Voc pode vericar se a cache de consltas est presente em sua verso do MySQL: e a a mysql> SHOW VARIABLES LIKE have_query_cache; +------------------+-------+ | Variable_name | Value | +------------------+-------+

Cap tulo 6: Referncia de Linguagem do MySQL e

629

| have_query_cache | YES | +------------------+-------+ 1 row in set (0.00 sec) Voc pode monitorar o desempenho da cache de consultas com SHOW STATUS: e Varivel a Descrio ca Qcache_queries_in_ Nmero de consultas registrada na cache. u cache Qcache_inserts Nmero de consultas adicionadas na cache. u Qcache_hits Nmero de acertos da cache. u Qcache_lowmem_prunes Nmero de consultas que foram deletadas u da cache devido a memria baixa. o Qcache_not_cached N;mero de consultas no armazenadas u a em cache (no armazenveis, ou devido a a a QUERY_CACHE_TYPE). Qcache_free_memory Quantidade de memria livre para cache de o consultas. Qcache_free_blocks Nmero de blocos de memria livre na u o cache de consultas Qcache_total_blocks Nmero total de blocos na cache de u consultas. Nmero total de consultas = Qcache_inserts + Qcache_hits + Qcache_not_cached. u A cache de consultas utiliza blocos de tamanhos variveis, assim Qcache_total_blocks a e Qcache_free_blocks podem indicar fragmentao de memria da cache de consultas. ca o Depois de um FLUSH QUERY CACHE apenas um unico (grande) bloco livre permanece. Nota: Toda consulta precisa de um m inimo de 2 blocos (um para o texto da consulta e um ou mais para o resultado da conulta). Tambm, cada tabela que usada por uma consulta e e precisa de um bloco, mas se duas ou mais consultas usam a mesma tabela, apenas um bloco precisa ser alocado. Voc pode utilizar a varivel de estado Qcache_lowmem_prunes para ajustar o tamanho da e a cache de consultas. Ela conta o nmero de consultas que so removidas da cache para liberar u a memria para armazenar novas consultas. A cache de consultas utiliza uma estratgia least o e recently used (LRU) para decidir quais consultas sero removidas da cache. a

630

MySQL Technical Reference for Version 5.0.0-alpha

7 Tipos de Tabela do MySQL

No MySQL Verso 3.23.6, voc pode escolher entre 3 formatos de tabelas bsicos (ISAM, HEAP a e a e MyISAM). Verses mais novas do MySQL suportam tipos de tabelas adicionais (InnoDB o ou BDB), dependendo de como voc o compila. Um banco de dados pode conter tabelas de e diferentes tipos. Ao criar uma nova tabela, voc pode dizer ao MySQL que tipo de tabela criar. O tipo de e tabela padro , normalmente, MyISAM. a e MySQL sempre criar um arquivo .frm para guardar as denies de coluna e tabela. Os a co indices e dados da tabela sero armazenados em um ou mais arquivos, dependendo do tipo a de tabela. Se voc tentar utilziar um tipo de tabela que no est ativa ou no foi compilada com o e a a a MySQL, ele ir criar uma tabela do tipo MyISAM. Este comportamento conveniente quando a e voc quer copiar tabelas entre servidores MySQL que suportam tipos de tabel;as diferentes. e (Talvez o seu servidor master suporte mecanismos de armazenamento tarnsacionais para aumento de segurana, enquanto o servidor slave s utiliza mecanismos de aramazenamento c o no-transacionais para maior velocidade.) a Esta mudanaautomatica de tipos de tabela podem confuso para novos usurios MySQL. c a Planejamos arrumar isto introduzindo avisos no protocolo cliente/servidor na verso 4.1 e a gerar um aviso quando uma tipo de tabela automaticamente alterado. e Voc pode converter tabelas entre tipos diferentes com a instruo ALTER TABLE. Veja e ca Seo 6.5.4 [ALTER TABLE], Pgina 608. ca a Note que o MySQL suporta dois tipos diferentes de tabelas: tabelas seguras com transao ca (InnoDB and BDB) e tabelas no seguras com tarnsao HEAP, ISAM, MERGE, e MyISAM). a ca Vantagens de tabelas seguras com transao (TST): ca Mais segura. Mesmo se o MySQL falhar ou se voc tiver problemas com hardware, e voc pode ter os seus dados de volta, ou atravs de recuperao automatica ou de um e e ca backup + o log de transao. ca Voc pode combinar muitas instrues e aceitar todas de uma vez com o comando e co COMMIT. Voc pode executar um ROLLBACK para ignorar suas mudanas (se voc no estiver e c e a rodando em modo auto-commit). Se uma atualizao falhar, todas as suas mudanas sero restauradas. (Com tabelas ca c a NTST todas as mudanas que tiverem sido feitas so permanentes). c a Pode fornecer melhor concorrncia se a tabela obter muitas atualizaes concorrentes e co com leituras. Note que para utilizar tabelas InnoDB voc tem que usar pelo menos a opo de inicializao e ca ca innodb_data_file_path. Veja Seo 7.5.3 [InnoDB start], Pgina 644. ca a Vantagens de tabelas no seguras com transao (NTST): a ca Muito mais rpida e no h nenhuma sobrecarga de transao. a a a ca Usar menos spao em disco j que no h nenhuma sobrecarga de transao. a c a a a ca Usar menos memria para as atualizaes. a o co Voc pode combinar tabelas TST e NTST na mesma instruo para obter o melhor dos e ca dois mundos.

Cap tulo 7: Tipos de Tabela do MySQL

631

7.1 Tabelas MyISAM

MyISAM o tipo de tabela padro no MySQL Verso 3.23. Ela baseada no cdigo ISAM e e a a e o possui vrias extenses uteis. a o O indice armazenado em um arquivo com extenso .MYI (MYIndex), e os dados so e a a armazenados em um arquivo com a extenso .MYD (MYData). Voc pode vericar/reparar a e tabelas MyISAM com o utilitrio myisamchk. Veja Seo 4.5.6.7 [Recuperao de Falhas], a ca ca Pgina 287. Voc pode compactar tabelas MyISAM com myisampack para utilizar menos a e espao. Veja Seo 4.8.4 [myisampack], Pgina 336. O itens seguintes so novos no MyISAM: c ca a a Existe um parmetro no arquivo MyISAM que indica se a tabela foi fechada corretamente. a Se o mysqld iniciado com --myisam-recover, tabelas MyISAM sero automaticamente e a vericadas e/ou reparadas na abertura se a tabela no foi fechada apropriadamente. a Voc pode INSERIR novas linhas em uma tabela que no tenha blocos livres no meio e a do arquivo de dados, na mesma hora outras threadas so lidas da tabela (insero a ca concorrente). Um bloco livre pode vir de uma atualizao de uma linha de tamanho ca dinmico com muitos dados para uma linha com menos dados ou ao deletarmos linhas. a Quando todos os blocos livres so usados, todas as inseres futurs sero concorrentes a co a de novo. Suporte a grandes arquivos (63-bit) em sistema de arquivos/sistemas operacionais que suportam grandes arquivos. Todo dado armazenado com byte mais baixo primeiro. Isto torna a mquina e SO e a independentes. A unica exigncia para a portabilidade do arquivo binrio que a a e a e mquina utilize inteiros com sinais em complemento de dois (como toda a mquina a a nos ultimos 20 anos tem) e formato de pontos utuante IEEE (tambm totalmente e dominante entre mquinas mainstream). A unica rea de mquinas que no podem a a a a suportar compatibilidade binria so sistemas embutidos (porque eles, algumas vezes, a a tem processadores peculiares). No h uma grande perda de velocidade em armazenar o byte mais baixo de dados a a primeiro; os bytes em um registro de tabela esto normalmente desalinhados e isto a no d muito poder de leitura do byte desalinhado em outra ordem alm da ordem a a e reversa. O cdigo atual busca-valor-coluna tambm no critico em relao ao tempo o e a e ca comparado a outro cdigo. o Todas as chaves numricas esto armazendas com o byte mais alto em primeiro para e a conseguir melhor compactao do ca indice. Tratamento interno de uma coluna AUTO_INCREMENT. MyISAM ir atualiz-lo a a automaticamenteem um INSERT/UPDATE. O valor AUTO_INCREMENT pode ser zerado com myisamchk. Ele far colunas AUTO_INCREMENT mais rpidas (pelo menos 10%) a a e nmeros natigos no iro reutilizar como no antigo ISAM. Note que quando um u a a AUTO_INCREMENT denido no m de uma chave multi-parte o comportamento antigo e ainda est presente. a Ao inserir ordenandamente (como quando se utiliza colunas AUTO_INCREMENT) a rvore a chave ser separada de forma que o nodo mais alto contenha apenas uma chave. Isto a ir aumentar a utilizao de espao na rvore de chaves. a ca c a Colunas BLOB e TEXT podem ser indexados.

632

MySQL Technical Reference for Version 5.0.0-alpha

Valores NULL so perimitidos em colunas indexadas. Isto gasta 0-1 bytes/chave. a O tamanho mximo da chave de 500 bytes por padro (pode ser alterado recomopia e a lando). No caso de chaves maiores que 250 bytes, um tamanho de bloco de chave maior que o padro de 1024 bytes usado para esta chave. a e Nmero mximo de chaves/tabelas 32 por padro. Isto pode ser aumentado para 64 u a e a sem ser necessrio recompilar myisamchk. a myisamchk marcar as tabelas como vericadas se algum execut-las sem --updatea e a state. myisamchk --fast s vericar aquelas tabelas que no tenham esta marca. o a a myisamchk -a armazena estat isticas para partes de chaves(e no apenas para toda a a chave como no ISAM). Linhas de tamanho dinmico sero agora muito menos fragmentados quando misturar a a delees com atualizaes e inseres. Isto feito combinando automaticamente blocos co co co e deletados adjacentes e extendendo blocos se o prximo bloco deletado. o e myisampack pode empacotar colunas BLOB e VARCHAR. Voc pode colocar arquivos de dados e e indices em diretrios diferentes para obter o maior velocidade (com a opo DATA/INDEX DIRECTORY="caminho" para CREATE ca TABLE). Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a MyISAM tambm suporta os seguintes itens, os quais o MySQL estar apto a utilizar em um e a futuro prximo: o Suporte a tipos VARCHAR reais; uma coluna VARCHAR inicia com um tamanho armazenado em 2 bytes. Tabelas com VARCHAR podem ter um registro de tamanho xo ou dinmico. a VARCHAR e CHAR podem ser maior que 64K. Todos os segmentos de chaves tm a sua e prpria denio de linguagem. Isto habilitar o MySQL para ter diferentes denies o ca a co de linguagens por coluna. Um indice computado em hash pode ser usado para UNIQUE. Isto lhe permitir ter a UNIQUE em qualquer combinao de colunas na tabela. (Voc no pode procurar em ca e a um em um indice computado UNIQUE, de qualquer forma.) Note que os arquivos de indice so muito menores com MyISAM que com ISAM. Isto signica a que MyISAM usar normalmente menos recursos do sistema que ISAM, mas precisar de mais a a tempo de CPU quando inserir dados em um indice compactado. As seguintes opes para mysqld podem ser usadas para alterar o comportamento de tabelas co MyISAM. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. ca a Opo ca --myisam-recover=# -O myisam_sort_buffer_size=# --delay-key-write=ALL -O myisam_max_extra_sort_file_ size=# Descrio ca Recuperao automtica de tabelas com falhas. ca a Buer utilizado ao recuperar tabelas. No desarrega buers de chaves entre escritas para a qualquer tabela MyISAM Usada paa ajudar o MySQL a decidir quando utilzar o mtodo lento, mas seguro, de criao de e ca indices de cache de chaves. Note este parmetro dado em a e megabytes antes da verso 4.0.3 e em bytes a partir a desta verso. a

Cap tulo 7: Tipos de Tabela do MySQL

633

No utilzia o mtodo rpido de ordenao de a e a ca indice para criar indices se o arquivo temporrio se tornasse a maior que o valor dado. Note que este parmetro a e dado em megabytes antes da verso 4.0.3 e em bytes a a partir desta verso. a -O bulk_insert_buffer_size=# Tamanho da arvore cache utilizado na otimizao de ca inseres em bloco. Note que este um limite por co e thread! A recuperao automtica ativada se voc iniciar o mysqld com --myisam-recover=#. ca a e e Veja Seo 4.1.1 [Opes de linha de comando], Pgina 207. Na abertura, vericado se ca co a e a tabela est marcada como quebrada ou se a variavel de contagem de abertura para esta a tabela no 0 e voc a est executando com --skip-external-locking. Se nenhuma das a e e a vericaes acima forem verdadeiras o seguinte ocorre. co -O myisam_max_sort_file_size=# Verica-se se a tabela possui erros. Se encontrarmos um erro, tente fazer um reparao rpida (com ordenao e sem recriar ca a ca o arquivo de dados) da tabela. Se o reparao falhar devido a um erro no arquivo de dados (por exemplo um erro ca de chave duplicada), feita uma nova tentativa, mas desta vez o arquivo de dados e e recriado. Se a reparao falhar, tente mais uma vez com o antigo mtodo de opo de reparao ca e ca ca (escrever linha a linha sem ordenao) o qual deve estar apto a reparar qualquer tipo ca de erros com pequenas exigncias de disco. e Se a recuperao no estiver apta a recuperar todas as linhas de uma instruo completada ca a ca previamente e voc no especicou FORCE como uma opo para myisam-recover, ento a e a ca a reparao automtica abortar com uma mensagem de erro no arquivo de erros: ca a a Error: Couldnt repair table: test.g00pages Caso voc tenha utilizado a opo FORCE, voc ir obter um aviso no arquivo de erro: e ca e a Warning: Found 344 of 354 rows when repairing ./test/g00pages Note que se voc executar uma recuperao automtica com a opo BACKUP, voc e ca a ca e deve ter um script cron que mova automaticamente arquivos com nome como tablename-datetime.BAK do diretrio de banco de dados para uma media de backup. o Veja Seo 4.1.1 [Opes de linha de comando], Pgina 207. ca co a

7.1.1 Espao Necessrio para Chaves c a

O MySQL pode suportar diversos tipos de indices, mas o tipo normal ISAM ou MyISAM. e Eles utilizam um indice de rvore-B, e voc pode calcular aproximadamente o tamanho do a e arquivo de indice como (key_length+4)/0.67, somado sobre todas as chaves. (Isto para e o pior caso, quando todas as chaves so inseridas ordenadamente e ns no temos nenhuma a o a chave compactada.) Indices string so compactados em espaos. Se a primeira parte do a c indice uma string, ele e tambm ser compactado em prexo. Compactao em espao torna o arquivo de e a ca c indice menor que o indicado acima se a coluna string tem muitos espaos no m ou uma coluna c e VARCHAR no usada em sua totalidade. Compactao de prexo usado em chaves que a ca e

634

MySQL Technical Reference for Version 5.0.0-alpha

iniciam com uma string. A Compactao de prexo ajuda se existirem muitas strings com ca o prexo idntico. e Em tabelas MyISAM, voc tambm pode utilizar prexos em nmeros comprimidos especie e u cando PACK_KEYS=1 quando voc cria a tabela. Isto ajuda quando voc tem muitas chaves e e inteiras que tm prexo idntico quando o nmero armazenado com o byte mais alto e e u e primeiro.

7.1.2 Formatos de Tabelas MyISAM

MyISAM suporta 3 tipos diferentes de tabelas. Dois deles so escolhidos automaticamente a dependendo do tipo das colunas que voc est usando. O terceiro, tabelas compactadas, s e a o pode ser criado com a ferramenta myisampack. Quando voc cria (CREATE) ou altera (ALTER uma tabela, voc pode, para tabelas que no e e a possuem BLOBs, forar o formato da tabela para DYNAMIC ou FIXED com a opo de tabela c ca ROW_FORMAT=#. No futuro voc estar apto a compactar/descompactar tabelas especie a cando ROW_FORMAT=compressed | default para ALTER TABLE. Veja Seo 6.5.3 [CREATE ca TABLE], Pgina 598. a

7.1.2.1 Caracter isticas de Tabelas Estticas (Tamanho Fixo) a

Este o formato padro. E usado quando a tabela no contm colunas VARCHAR, BLOB, ou e a a e TEXT. Este o formato mais e simples e seguro. E tambm o mais rpidos dos formatos em disco. e e a A velocidade vem da facilidade de se encontrar dados no disco. Procurar por algo com um indice no formato esttico muito simples. Apenas multiplique o nmero de linhas pelo a e u seu tamanho. Tambm, ao varrermos uma tabela, muito simples ler um nmero contante de registros a e e u cada leitura de disco. A segurana evidenciada se o seu computador falha ao escrever em um arquivo MyISAM c e de tamanho xo, caso no qual o myisamchk pode facilemente descobrir onde cada linha comea e termina. Assim, geralmente pode se recuperar todos os registros, exceto os escritos c parcialmente. Note que no MySQL todos os indices sempre podem ser reconstru idos. Todas as colunas CHAR, NUMERIC, e DECIMAL tem espaos adicionados at o tamanho c e da coluna. E muito rpida. a Facil de se colocar em cache. Fcil de reconstruir depois de uma falha, pois os registros esto localizados em posies a a co xas. No precisa ser reorganizada (com myisamchk) a menos que um grande nmero de a u registros sejam deletados e voc queira retornar espao de diaco livre ao sistema ope c eracional. Normalmente exige mais espao de disco que tabelas dinmicas. c a

Cap tulo 7: Tipos de Tabela do MySQL

635

7.1.2.2 Caracter isticas de Tabelas Dinmicas a

Este formato usado se a tabela contm colunas VARCHAR, BLOB ou TEXTou se as tabelas e e so criadas com ROW_FORMAT=dynamic. a Este formato um pouco mais complexo porque cada linha tem que ter um cabealho que e c diz o seu tamanho. Um registro tambm pode acabar em mais de um local quando ca e maior em uma atualizao. ca Voc pode utilizar OPTIMIZE tabela ou myisamchk para desfragmentar uma tabela. Se e voc tiver dados estticos que voc acessa/altera demias na mesma tabela, como alguma e a e coluna VARCHAR ou BLOB, pode ser uma boa idia mover as colunas dinmicas para outra e a tabela apenas para evitar fragmentao. ca Todas as colunas string so dinmicas (exceto aquelas com tamanho menor que 4). a a Cada registro precedido por um mapa de bits indicando quais colunas esto vazias e a () para colunas string ou zero para colunas numricas (Isto diferente de colunas e e contendo valores NULL). Se uma coluna de string tem um tamanho de zero depois da remoo de espaos extras, ou uma coluna numrica tem um valor de zero, isto ca c e e marcado no mapa de bits e no salvado em disco. Strings no vazias so salvas como a e a a um byte de tamanho mais o conteudo da string. Geralmente utiliza muito menos espao de disco que tabelas de tamanho xo. c Cada registro utiliza apenas o espeo necessrio. Se um registro aumenta, ele separado c a e em varios pedaos, de acordo com a necessidade. Isto resulta em fragmentao do c ca registro. Se voc atualiza uma linha com informaes que ultrapassam o seu tamanho, a linha e co ser fragmentada. Neste caso, voc pode precisar executar myisamchk -r de tempos a e em tempos para obter melhor performance. Use myisamchk -ei nome_tabela para algumas estat isticas. a e a No fcil de recontru aps uma falha, pois um registro pode ser fragmentado em i-la o muitos pedaos e um link (fragmento) pode ser perdido. c O tamanho esperado para registros de tamanho dinmico : a e 3 + (nmero de colunas + 7) / 8 u + (nmero de colunas char) u + tamanho empacotado de colunas numricas e + tamanho das strings + (nmero de colunas NULL + 7) / 8 u Existe uma penalidade de 6 bytes para cada link. Um registro dinmico ligado sempre a e que uma atualizao causa um aumento do registro. Cada novo link ter pelo menos ca a 20 bytes, assim o prximo aumento estar, provavelemente, no mesmo link. Se no, o a a haver outro link. Voc pode checar quantos links existem com myisamchk -ed. Todos a e os links podem ser removidos com myisamchk -r.

7.1.2.3 Caracter isticas de Tabelas Compactadas

Este um tipo somente leitura que gerado com a ferramenta opcional myisampack (pack_ e e isam para tabelas ISAM):

636

MySQL Technical Reference for Version 5.0.0-alpha

Todas as distribuies MySQL, mesmo aquelas existentes antes do MySQL se tornar co GPL, podem ler tabelas que forma compactadas com myisampack. Tabelas compactadas utilizam muito pouco espao em disco. Isto minimiza o uso de c disco, o que muito bom quando se utiliza discos lentos (com CD-ROMs). e Cada registro compactado separadamente (pouca sobrecarga de acesso). O cabealho e c de um registro xo (1-3 bytes) dependendo do maior registro na tabela. Cada coluna e compactada diferentemente. Alguns dos tipos de compactao so: e ca a Existe, geralmente, uma tabela Human diferente para cada coluna. Compactao de espao de suxos. ca c Compactao de espao de prexos. ca c Nmeros com valor 0 so armazenados usando 1 bit. u a Se os valores em uma coluna inteira tem uma faixa pequena, a coluna armazenada e usando o menor tipo poss ivel. Por exemplo, uma coluna BIGINT (8 bytes) pode ser armazenada como uma coluna TINYINT (1 byte) se todos os valores esto na a faixa de 0 a 255. Se uma coluna tem apenas um pequeno conjunto de valores poss iveis, o tipo de coluna convertido para ENUM. e Uma coluna pode usar uma combinao das compactaes acima. ca co Pode tratar registros de tamanho xo ou dinmico. a Pode ser descompactada com myisamchk.

7.1.3 Problemas com Tabelas MyISAM

O formato do arquivo que o MySQL usa para armazenar dados tem sido testado extensivamente, mas sempre h circunstncias que podem fazer com que tabelas de banco de dados a a sejam corrompidas.

7.1.3.1 Tabelas MyISAM Corrompidas

Mesmo se o formato MyISAM for muito convel (todas as alteraes na tabela so escritas a co a antes da instruo SQL retornar), voc ainda pode ter tabelas corrompidas se algum dos ca e seguintes itens ocorrer: O processo mysqld ser nalizado no meio de uma escrita. Finalizao inesperada do computador (por exemplo, se o computador desligado). ca e Um erro de hardware. Voc estar usando um programa externo (como myisamchk) em uma tabela aberta. e Um bug de um software no cdigo MySQL ou MyISAM. o Os sintomas t ipicos de uma tabela corrompida so: a Voc obtem o erro Incorrect key file for table: .... Try to repair it e enquanto seleciona dados da tabela. Consultas no encontram linhas em uma tabela ou retornam dados incompletos. a

Cap tulo 7: Tipos de Tabela do MySQL

637

Voc pode vericar se uma tabela est ok com o comando CHECK TABLE. Veja Seo 4.5.4 e a ca [CHECK TABLE], Pgina 278. a Voc pode repara um tabela corrompida com REPAIR TABLE. Veja Seo 4.5.5 [REPAIR e ca TABLE], Pgina 279. Voc tambm pode repar-la, quando o mysqld no estiver em a e e a a execuo com o comando myisamchk. sintaxe myisamchk. ca Se a sua tabela estiver muito corrompida voc deve tentar encontrar o razo! Veja e a Seo A.4.1 [Falhas], Pgina 925. ca a Neste caso, a coisa mais importante de saber se a tabela foi corrompida porque o mysqld foi e nalizado (pode se vericar isto facilmente vericando se h uma linha restarted mysqld a recente no arquivo de erro do mysql. Se este no o caso, ento voc deve tentar fazer um a e a e caso de teste disto. Veja Seo E.1.6 [Caso de teste reproduz ca iveis], Pgina 1084. a

7.1.3.2 O Cliente est usando a tabela ou no a fechou de forma a a apropriada

Cada arquivo .MYI do MyISAM tem um contador no cabealho que pode ser usado para c vericar se uma tabela foi fechada apropriadamente. Se voc obteve o seguinte aviso de CHECK TABLE ou myisamchk: e # clients is using or hasnt closed the table properly isto signica que este contador eta fora de sincronia. Insto no signica que a tabela est a a corrompida, mas signica que voc poderia pelo menos fazer uma vericao na tabeal para e ca vericar se est ok. a O contador funciona da seguinte forma: A primeira vez que a tabela atualizada no MySQL, um contador no cabealho do e c arquivo de indice incrementado. e a e co O contador no alterado durante outras alteraes. Quando a ultima intncia da tabela fechda (devido a um FLUSH ou porque no h a e a a espao na cache de tabelas) o contador decremetado se a tabela tiver sido atualizada c e em qualquer ponto. Quando voc raparar a tabela ou veric-la e ela estiver ok, o contador zerado. e a e Para evitar problemas com interaes com outros processos que podem fazer uma co vericao na tabela, o contador no decrementado no fechamento se ele for 0. ca a e Em outras palavras, o unico modo dele car fora de sincronia : e As tabelas MyISAM so copiadas sem um LOCK e FLUSH TABLES. a O MySQL ter falhado entre uma atualizao e o fechamento nal. (Note que a tabela ca pode ainda estar ok j que o MySQL sempre faz escritas de tudo entre cada instruo.) a ca Algum ter feito um myisamchk --recover ou myisamchk --update-state em uma e tabela que estava em uso por mysqld. Muitos servidores mysqld estrem usando a tabela e um deles tiver feito um REPAIR ou CHECK da tabela enquanto ela estava em uso por outro servidor. Nesta congurao o ca CHECK seguro de se fazer (mesmo se voc obter ovisos de outros servidor), mas REPAIR e e deve ser evitado pois ele atualmente substitui o arquivo de dados por um novo, o qual no mostrado para os outros servidores. a e

638

MySQL Technical Reference for Version 5.0.0-alpha

7.2 Tabelas MERGE

Tabelas MERGE so novas no MySQL Verso 3.23.25. O cdigo ainda est em gamma, mas a a o a deve estar razoavelmente estvel. a Uma tabela MERGE (tambm conhecida como tabela MRG_MyISAM) uma coleo de tabelas e e ca MyISAM idnticas que podem ser usada como uma. Voc s pode fazer SELECT, DELETE, e e e o UPDATE da coleo de tabelas. Se voc zer um DROP na tabela MERGE, voc s est apagando ca e e o a a especicao de MERGE. ca Note que DELETE FROM tabela_merge usado sem um WHERE s limpar o mapeamento a o a tabela, no deletando tudo nas tabeals mapeadas. (Planejamos consertar isto na verso a a 4.1). Com tabelas idnticas queremos dizer que todas as tabelas so criadas com informaes e a co de colunas e chaves idnticas. Voc no pode fundir tabelas nas quais as colunas so e e a a empacotadas de forma diferente, no tenham as mesmas colunas ou tenham as chaves em a ordem diferente. No entanto, algumas das tabelas podem ser compactadas com myisampack. Veja Seo 4.8.4 [myisampack], Pgina 336. ca a Ao criar uma tabela MERGE, voc obter uma arquivo de denio de tabela .frm e um e a ca arquivo de lista de tabela .MRG. O arquivo .MRG contm apenas a lista de arquivos e indices (arquivos .MYI) que devem ser usados como um. Antes da verso 4.1.1, todas as tabelas a usadas devem estar no mesmo banco de dados assim como a prpria tabela MERGE. o Atualmente voc precisa ter os privilgios SELECT, UPDATE e DELETE em tabelas mapeadas e e para uma tabela MERGE. Tabelas MERGE podem ajud-lo a resolver os seguintes problemas: a Facilidade de gernciamento de um conjunto de log de tabelas. Por exemplo, voc pode e colocar dados de meses diferentes em arquivos separadosfrom dierent months into separate les, compress some of them with myisampack, and then create a MERGE to use these as one. Lhe da maior velocidade. Voc pode separar uma grande tabela somente leitura baseado e em algum critrio e ento colocar as diferentes partes da tabela em discos diferentes. e a Uma tabela MERGE desta forma pode ser muito mais rpida que se usada em uma grande a RAID para obter o memo tipo de tabela. (Voc pode, claro, usar tambm um nivel e e e benef icio.) Faz pesquisas mais ecientes. Se voc sabe exatamente o que voc esta procurando, e e voc pode buscar em apenas um dos pedaos da tabelas para algumas pesquisas e e c utilizar tabelas MERGE para outras. Voc pode at ter diferentes tabelas MERGE ativas, e e com possiveis arquivos sobrepostos. Reparaes mais ecientes. E facil reparar os arquivos individuais que so mapeados co a para um arquivo MERGE que tentar reparar um arquivo realmente grande. Mapeamento instantneo de diversos arquivos como um. Uma tabela MERGE usa o a indice de tabelas individuais. No necessrio manter um a e a indice de para ela. Isto torna a coleo de tabelas MERGE MUITO rpido de fazer ou remapear. Note que voc ca a e deve especicar a denio de chave quando voc cria uma tabela MERGE!. ca e Se voc tem um conjunto de tabelas que voc junta a uma tabela grande por demanda e e ou bacth, voc deveria criar uma tabela MERGE delas por demanda. Isto muito mais e e rpido economizar bastante espao em disco. a e a c

Cap tulo 7: Tipos de Tabela do MySQL

639

Contornam o limite de tamanho de arquivos do sistema operacional. Voc pode criar um apelido/sinnimo para uma tabela usando MERGE sobre uma tabela. e o No deve haver nenhum impacto notvel na performance ao se fazer isto (apenas algua a mas chamadas indiretas e chamadas de memcpy() para cada leitura). As desvantagens de tabelas MERGE so: a Voc s pode utilizar tabelas MyISAM idnticas em uma tabela MERGE. e o e REPLACE no funciona. a Tabelas MERGE usam mais descritores de arquivos. Se voc estiver usando uma tabela e MERGE que mapeia mais de 10 tabelas e 10 usurios a esto usando, voc est usando a a e a 10*10 + 10 descritores de arquivos. (10 arquivos de dados para 10 usurios e 10 arquivos a de indices compartilhados). A leitura de chaves lenta. Quando voc faz uma leitura sobre uma chave, o mecane e ismo de armazenamento MERGE precisar fazer uma leitura em todas as tabelas para a vericar qual casa melhor com a chave dada. Se voc ento zer uma "leia prximo", e a o o mecanismo de armazenamento MERGE precisar procurar os buers de leitura para a encontrar a prxima chave. Apenas quando um buer de chaves usado, o mecano e ismo de armazenamento precisar ler o prximo bloco de chaves. Isto torna as chaves a o MERGE mais lentas em pesquisas eq_ref, mas no em pesquisas ref. Veja Seo 5.2.1 a ca [EXPLAIN], Pgina 424. a Voc no pode fazer DROP TABLE, ALTER TABLE, DELETE FROM nome_tabela sem uma e a clusula WHERE, REPAIR TABLE, TRUNCATE TABLE, OPTIMIZE TABLE, ou ANALYZE TABLE a em nenhuma das tabelas que mapeada por uma tabela MERGE que est "aberta". e a Se voc zer isto, a tabela MERGE pode ainda se referir a tabela original e voc obter e e a resultados inexperados. O modo mais fcil de contornar esta decincia e atravs do coa e e mando FLUSH TABLES, assegurando que nenhuma tabela MERGE permanecer "aberta". a Quando voc cria uma tabela MERGE voc deve especicar com UNION=(lista-de-tabelas) e e quais tabelas voc quer usar com uma. Opcionalmente voc pode especicar com INSERT_ e e METHOD se voc quer que inseres em tabelas MERGE ocorram na primeira ou na ultima e co tabela da lista UNION. Se voc no especicar INSERT_METHOD ou especicar NO, entao e a a todos os comandos INSERT na tabela MERGE retornaro um erro. a O seguinte exemplo lhe mostra como utilizaqr tabelas MERGE: TABLE t1 (a INT NOT NULL AUTO_INCREMENT PRIMARY KEY, message CHAR(20)); TABLE t2 (a INT NOT NULL AUTO_INCREMENT PRIMARY KEY, message CHAR(20)); INTO t1 (message) VALUES ("Testing"),("table"),("t1"); INTO t2 (message) VALUES ("Testing"),("table"),("t2"); TABLE total (a INT NOT NULL AUTO_INCREMENT PRIMARY KEY, message CHAR(20)) TYPE=MERGE UNION=(t1,t2) INSERT_METHOD=LAST; SELECT * FROM total; Note que no criamos uma chave UNIQUE ou PRIMARY KEY na tabela total j que a chave a a no ser unica na tabela total. a a Note que voc tambm pode manipular o arquivo .MRG diretamente de fora do servidor e e MySQL: shell> cd /mysql-data-directory/current-database CREATE CREATE INSERT INSERT CREATE

640

MySQL Technical Reference for Version 5.0.0-alpha

shell> ls -1 t1.MYI t2.MYI > total.MRG shell> mysqladmin flush-tables Agora voc pode fazer coisas como: e mysql> SELECT * FROM total; +---+---------+ | a | message | +---+---------+ | 1 | Testing | | 2 | table | | 3 | t1 | | 1 | Testing | | 2 | table | | 3 | t2 | +---+---------+ Note que a coluna a, declarada como PRIMARY KEY, no unica, j que tabelas MERGE no a e a a podem forca a unicidade sobre um conjunto de tabelas MyISAM selecionadas. Para remapear uma tabela MERGE voc pode fazer o seguinte: e Fazer um DROP na tabela e recri-la a Usar ALTER TABLE nome_tabela UNION=(...) Alterar o arquivo .MRG e executar um FLUSH TABLE na tabela MERGE e todas as tabelas selecionadas para forar o mecanismo de armazenamento a ler o novo arquivo de c denio. ca

7.2.1 Problemas com Tabelas MERGE

Segue abaixo os problemas conhecidos com tabelas MERGE: Uma tabela MERGE no pode manter restries UNIQUE sobre toda tabela. Quando voc a co e faz um INSERT, os dados vo para a primeira ou ultima tabela (de acordo com INSERT_ a METHOD=xxx) e estas tabelas MyISAM asseguram que os dados so unicos, mas no se a a sabe nada sobre outras tabelas MyISAM. DELETE FROM tabela_merge usado sem um WHERE s limpar o mapeamento da tabela, o a no deletando tudo na tabela mapeada. a RENAME TABLE em uma tabela usada por uma tabela MERGE ativa pode corromper a tabela. Isto ser corrigido no MySQL 4.1.x. a Criao de uma tabela do tipo MERGE no verica se o tabelas selecionadas so de tipos ca a a compat iveis ou se elas existem. O MySQL far uma vericao rpida de se o tamanho a ca a do registro igual entre tabelas mapeadas quando a tabela MERGE usada, mas esta e e no uma vericao total. a e ca Se voc usar tabelas MERGE deste modo, voc poder obter problemas estranhos. e e a Se voc usar ALTER TABLE para adicionar primeiro um e indice UNIQUE em uma tabela usada em uma tabela MERGE e ento usar ALTER TABLE para adicionar um a indice normal na tabela MERGE, a ordem da chave ser diferente para as atabelas se houvesse uma a chave no unica antiga na tabela. Isto ocorre porque ALTER TABLE coloca chaves UNIQUE a

Cap tulo 7: Tipos de Tabela do MySQL

641

antes de chaves normais para estar apto a detectar chaves duplicadas o mais rpido a poss ivel. DROP TABLE em uma tabela que est em uso por uma tabela MERGE no funcionar no a a a Windows porque o mecanismo de armazenamento MERGE faz o mapeamento da tabela escondido da camada mais alta do MySQL. Como o Windows no permite que voc a e apague arquivos que estejam abertos, voc deve primeiro descarregar todas as tabelas e MERGE (com FLUSH TABLES) ou apagar a tabela MERGE antes de apagar a tabela. Ns o consertaremos isto assim que introduzirmos VIEWs.

7.3 Tabelas ISAM

O tipo de tabela ISAM, obsoleto, desaparecer na verso 5.0. Ele est inclu no fonte a a a ido do MySQL 4.1 mas no mais compilado. MyISAM uma implementao melhor deste e a e e ca handler de tabela e voc deve converter todas as tabelas ISAM para tabelas MySAM o mais e rpido poss a ivel. ISAM usa um indice B-tree. O indice armazenado em um arquivo com a extenso e a .ISM, e os dados so armazenados em um arquivo com a extenso .ISD. Voc pode a a e vericar/reparar tabelas ISAM com o utilitrio isamchk. Veja Seo 4.5.6.7 [Recuperao a ca ca de falhas], Pgina 287. a ISAM tem os seguintes recursos/propriedades: Chaves compactadas e de tamanho xo. Registros de tamanho xo e dinmico a 16 chaves com 16 chaves parciais/chaves Tamanho mximo da chave de 256 (padro) a a Os dados so armazenados em formato de mquina; isto rpido mas dependente da a a e a e maquina/SO. A maioria das coisas que so verdadeiras para tabelas MyISAM tambm so verdadeiras a e a para tabelas ISAM. Veja Seo 7.1 [Tabelas MyISAM], Pgina 631. As maiores diferenas ca a c comparados a tabelas MyISAM so: a Tabelas ISAM no so bninrios portveis entre SO/Pataformas. a a a a No pode lidar com tabelas > 4G. a S suporta compactao de prexo em strings. o ca Limite de chaves menor. Tabelas dinmicas so mais fragmentadas. a a Tableas so compactadas com pack_isam ao invs de myisampack. a e Se voc quiser converter uma tabela ISAM em uma tabela MyISAM de forma a se poder e utilizar utilitrios tais como mysqlcheck, use uma instruo ALTER TABLE: a ca mysql> ALTER TABLE nome_tabela TYPE = MYISAM; A verses embutidas do MySQL no supoortam tabelas ISAM. o a

642

MySQL Technical Reference for Version 5.0.0-alpha

7.4 Tabelas HEAP

Tabeals HEAP usam indices hash e so armazenadas na memria. Isto as torna muito rpidas, a o a mas se o MySQL falhar voc ir perder todos os dados armazenados nela. HEAP muito e a e util para tabelas temporrias! a As tabelas HEAP do MySQL utilizam hashing 100% dinmico sem reas em excesso. No a a a h espaos extras necessrios para listas livres. Tabelas HEAP tambm no tm problemas a c a e a e com deleo + insero, o que normalmente comum em tabelas com hash: ca ca e mysql> CREATE TABLE test TYPE=HEAP SELECT ip,SUM(downloads) AS down -> FROM log_table GROUP BY ip; mysql> SELECT COUNT(ip),AVG(down) FROM test; mysql> DROP TABLE test; Aqui seguem algumas coisas que voc deve considerar ao utilizar tabelas HEAP: e Voc sempre deve utilizar a especicao MAX_ROWS na instruo CREATE para assegurar e ca ca que voc no ir utilizar toda a memria acidentalmente. e a a o Indices s sero utilizados com = e <=> (mas MUITO rpido). o a e a Tabelas HEAP s podem usar chaves inteiras para procurar por uma linha; compare isto o a tabelas MyISAM onde qualquer prexo de chave pode ser usada para encontrar linhas. Tabelas HEAP usam um formato de registro de tamanho xo. HEAP no suporta colunas BLOB/TEXT. a HEAP no suporta colunas AUTO_INCREMENT. a Antes do MySQL 4.0.2, HEAP no suportava um a indice em uma coluna NULL. Voc pode ter chaves no unicas em uma tabela HEAP (isto no comum em tabelas e a a e com hash). Tabelas HEAP so compartilhadas entre todos os clientes (como qualquer outra tabela). a Voc no pode pesquisar pela prxima entrada na ordem (isto , usar o e a o e indice para fazer um ORDER BY). Dados de tabelas HEAP so alocados em blocos menores. As tabelas so 100% dinmicas a a a (na insero). No so necessrias areas excessivas e espao de chave extra. Linhas ca a a a c deletadas so colocadas em uma lista encadeada e so reutilizadas quando voc insere a a e novos dados na tabela. Voc precisa de memria extra suciente para todas as tabelas HEAP que voc quiser e o e utilizar ao mesmo tempo. Para liberar memria, voc deve executar DELETE FROM tabela_heap, TRUNCATE o e tabeala_heap ou DROP TABLE tabela_heap. O MySQL no pode descobrir aproximadamente quantas linhas existem entre dois a valores (isto utilizado pela atimizador de escala para decidar qual indice usar). Isto e pode afetar algumas consultas se voc alterar uma tabela MyISAM para uma tabela e HEAP. Para assegurar que voc no vai cometer nenhum erro acidentalmente, voc no pode e a e a criar tabelas HEAP maiores que max_heap_table_size. A memria necessria para uma linha na tabela HEAP : o a e

Cap tulo 7: Tipos de Tabela do MySQL

643

SUM_OVER_ALL_KEYS(max_length_of_key + sizeof(char*) * 2) + ALIGN(length_of_row+1, sizeof(char*)) sizeof(char*) 4 em uma mquina de 32 bits e 8 em uma mquina de 64 bits. e a a

7.5 Tabelas InnoDB

7.5.1 Viso Geral de Tabelas InnoDB a
O InnoDB prove o MySQL com um mecanismo de armazenamento seguro com transaes co (compat ivel com ACID) com commit, rollback, e recuperao em caso de falhas. InnoDB ca faz bloqueio a n de registro e tambm fornece uma leitura sem bloqueio em SELECT em ivel e um estilo consistente com Oracle. Estes recursos aumentam a performance e a concorrncia e de multi usurios. No h a necessidade de escalonamento de bloqueios em InnoDB, pois a a a o bloqueio a n de registro no InnoDB cabe em um espao muito pequeno. InnoDB o ivel c e primeiro gerenciador de armazenamento no MySQL que suportam restries FOREIGN KEY. co InnoDB foi desenvolvido para obter o mximo de performance ao processar grande volume de a dados. Sua ecincia de CPU provavelmente no conseguido por nenhum outro mecanismo e a e de banco de dados relacional com base em disco. InnoDB usado na produo de vrios sites com banco de dados grandes e que necessitam e ca a de alto desempenho. O famoso site de not icias Slashdot.org utiliza InnoDB. Mytrix, Inc. armazena mais de 1 TB de dados em InnoDB, em outro site trata uma carga mdia de 800 e inseres/atualizaes por segundo em InnoDB. co co Tecnicamente, InnoDB um banco de dados completo colocado sob o MySQL. InnoDB tem e sua prpria rea de buer para armazenar dados e o a indices na memria principal. InnoDB o armazena suas tabelas e indices em um espaco de tabela, o qual pode consistir de vrios a arquivos (ou parties de disco raw). Isto diferente, por exemplo de tabelas MyISAM, co e onde cada tabela armazenada como um arquivo separado. Tabelas InnoDB podem ser de e qualquer tamanho, mesmo em sistemas operacionais onde o sistema de arquivo limitado e a 2 GB. Voc pode encontrar as ultimas informaes sobre InnoDB em http://www.innodb.com/. e co A verso mais atualizada do manual do InnoDB sempre colocada l. a e a InnoDB publicade sob a mesma Licena GNU GPL, Verso 2 (de Junho de 1991) e c a que MySQL. Se voc distribuir MySQL/InnoDB, e sua aplicao no satisfaz as e ca a restries da licena GPL, voc deve comprar uma lincena comercial MySQL Pro em co c e c https://order.mysql.com/?sub=pg&pg_no=1.

7.5.2 InnoDB no MySQL Verso 3.23 a

A partir do MySQL verso 4.0, InnoDB est habilitado por padro. A seguinte informao a a a ca s se aplica a srie 3.23. o e Tabelas InnoDB esto inclu a idas na distribuio fonte a partir do MySQL 3.23.34a e est ca a ativado no binrio MySQL -Max da srie 3.23. No Windows os binrios -Max esto contidos a e a a na distribuio padro. ca a

644

MySQL Technical Reference for Version 5.0.0-alpha

Se voc tiver feito o download de uma verso binria do MySQL que inclui suporte para e a a InnoDB, simplesmente siga as instrues do manual do MySQL para instalar um vrso co a binria do MySQL. Se voc j tem o MySQL-3.23 instalado, ento o modo mais simples de a e a a instalar MySQL -Max substituir i executvel do servidor mysqld com o executvel corree a a spondente na distribuio -Max. MySQL e MySQL -Max diferem apenas no executvel do ca a servidor. Veja Seo 2.2.9 [Instalando uma distribuio binria], Pgina 91. Veja Seo 4.8.5 ca ca a a ca [mysqld-max], Pgina 343. a Para compilar o MySQL com suoprte a InnoDB, faa o download do MySQL-3.23.34a ou c posterior de http://www.mysql.com/ e congure o MySQL com a opo --with-innodb. ca Veja o manual MySQL sobre como instalar uma distribuio fonte. Veja Seo 2.3 [Instaca ca lando uma distribuio fonte], Pgina 94. ca a cd /caminho/para/fonte/mysql-3.23.37 ./configure --with-innodb Para utiliar tabelas InnoDB no MySQL-Max-3.23 voc deve especicar parmetros de cone a gurao na seo [mysqld] do arquivo de congurao my.cnf, ou no Windows opcionalca ca ca mente em my.ini. No m inimo, na verso 3.23 voc deve especicar innodb_data_file_path onde voc especia e e car o nome e tamanho dos arquivos de dados. Se voc no mencionar innodb_data_home_ e a dir em my.cnf o padro criar estes arquivoas no diretorio_dados do MySQL. Se voc a e e especicar innodb_data_home_dir como uma string vazia, ento voc pode dar caminhos a e absolutos ao seu arquivo de dados em innodb_data_file_path. O modo m inimo de modicar de adicionar a seao [mysqld] a linha e c innodb_data_file_path=ibdata:30M mas para obter melhor desempenho melhor que voc especique as opes como recomene e co dado. Veja Seo 7.5.3 [Inicializao InnoDB], Pgina 644. ca ca a

7.5.3 Opes de Inicializao do InnoDB co ca

Para habilitar tabelas InnoDB no MySQL verso 3.23, veja Seo 7.5.2 [InnoDB in MySQL a ca 3.23], Pgina 643. a No MySQL-4.0 no necessrio se fazer nada espec a e a ico para habilitar tabelas InnoDB. O comportamento padro no MySQL 4.0 e MySQL 4.1 criar um arquivo ibdata1 autoa e extens ivel de 10 MB no diretrio de dados do MySQL e dois ib_logfiles de 5MB em o datadir. (No MySQL-4.0.0 e 4.0.1 o arquivo de dados 64 MB e no auto-extens e a e ivel.) Note: Para obter uma boa performance voc deve denir explicitamente os parmetros e a listados nos seguintes exemplos. Se voc no quiser utilizar tabelas InnoDB, voc pode adicionar a opo skip-innodb ao e a e ca seu arquivo de oo do MySQL. ca A partir das verses 3.23.50 e 4.0.2 InnoDB permite que o ultimo arquivo de dados n linha o innodb_data_file_path seja especicado como auto-extens ivel. A sintaxe de innodb_ data_file_path a seguinte: e caminhodados:tamanhoespec;caminhodados:tamanhoespec;... ... ;caminhodados:tamanhoespec[:autoextend[:max:tamanhoespec]]

Cap tulo 7: Tipos de Tabela do MySQL

645

Se voc especicar o ultimo arquivo de dados coma a opo autoextend, InnoDB extender e ca a o ultimo arquivo de dados se ele car sem espao no tablespace. O aumento de 8 MB a c e cada vez. Um exemplo: innodb_data_home_dir = innodb_data_file_path = /ibdata/ibdata1:100M:autoextend instrui InnoDB a criar apenas um unico arquivo de dados com tamanho inicial de 100 MB e que extendido em blocos de 8 MB quando o espao acabar. Se o disco car cheio voc e c e pode querer adicionar outro arquivo de dados a outro disco, por exemplo. Ento voc a e tem que olhar o tamanho de ibdata1, arredondar o tamanho para baixo at o mltiplo e u de 1024 * 1024 bytes (= 1 MB) mais prximo, e especicar o tamanho arredondado de o ibdata1 explicitamente em innodb_data_file_path. Depois disto voc pode adicionar e outros arquivos de dados: innodb_data_home_dir = innodb_data_file_path = /ibdata/ibdata1:988M;/disk2/ibdata2:50M:autoextend Tenha cuidado com sistema de arquivos onde o tamanho mximo do arquivo 2 GB. O a e InnoDB no est ciente disto. Neste sistemas de arquivos voc pode querer especicar o a a e tamanho mximo para o arquivo de dados: a innodb_data_home_dir = innodb_data_file_path = /ibdata/ibdata1:100M:autoextend:max:2000M Um exemplo de my.cnf simples. Suponha que voc tenha um computador com 128 MB e RAM e um disco r igido. Abaixo est o exemplo dos parmetros de congurao poss a a ca iveis para my.cnf ou my.ini para o InnoDB. Ns consideramos que voc est executando o e a MySQL-Max-3.23.50 ou posterior, our MySQL-4.0.2 ou posterior. Este exemplo serve para a maioria dos usurios, tanto em Unix e Windows, que no querem distribuir a a arquivos de dados InnoDB e arquivos de log em vrios discos. Isto cria um arquivo de a dados ibdata1 auto-extens ivel e dois arquivos de log ib_logfile0 e ib_logfile1 do InnoDB no datadir do MySQL (normalmente /mysql/data). O arquivo de log ib_arch_log_0000000000 do InnoDB tambm ca em datadir. e [mysqld] # Voc^ pode escrever outras op~es do servidor MySQL aqui e co # ... # Arquivos de dados deve estar aptos # a guardar os seus dados e ndices. i # Esteja certo que voc^ tem espao e c # livre suficiente em disco. innodb_data_file_path = ibdata1:10M:autoextend # Defina o tamanho da rea de buffer com a # 50 - 80 % da meria do seu computador o set-variable = innodb_buffer_pool_size=70M set-variable = innodb_additional_mem_pool_size=10M # Defina o tamanho do seu arquivo log # para 25 % da tamanho da rea de buffer a set-variable = innodb_log_file_size=20M set-variable = innodb_log_buffer_size=8M # Defina ..flush_log_at_trx_commit

646

MySQL Technical Reference for Version 5.0.0-alpha

# com 0 se voc^ puder perder e # algumas das ultimas trnsa~es co innodb_flush_log_at_trx_commit=1 Check that the MySQL server has the rights to create les in datadir. Note que os arquivo de dados devem ser < 2 GB em alguns sistemas de arquivos! O tamanho combinado do arquivos de log devem ser < 4 GB. O tamanho combinado dos arquivos de dados devem ser >= 10 MB. Quando voc criar um banco de dados pela primeira vez, melhor que voc inicie o servidor e e e MySQL do prompt de comando. Ento InnoDB ir imprimir a informao sobre a criao a a ca ca do banco de dados na tela e voc poder ver o que est acontecendo. Veja abaixo na e a a prxima seo como a sa na tela se parece. Por exemplo, no Windows voc pode iniciar o ca ida e mysqld-max.exe com: your-path-to-mysqld\mysqld-max --console Onde colocar o my.cnf ou my.ini no Windows? As regras para o Windows so o seguinte: a Apenas o my.cnf ou my.ini deve ser criado. O arquivo my.cnf deve ser colocado no direttio raiz do drive C:. o O arquivo my.ini deve ser colocado no diretrio WINDIR, e.g, C:\WINDOWS ou o C:\WINNT. Voc pode usar o comando SET do MS-DOS para imprimir o valor de e WINDIR. Se o seu PC utiliza um carrgador de boot onde o drive C: no o drive de boot, ento a e a a sua unica op`o usar o arquivo my.ini. ca e Onde especicar as opes no Unix? No Unix o mysqld l opes dos seguintes arquivos, co e co se eles existirem, na seguinte ordem: /etc/my.cnf Opes globais. co COMPILATION_DATADIR/my.cnf Opes espec co icas do servidor. defaults-extra-file O arquivo especicado com --defaults-extra-file=.... ~/.my.cnf Opes espec co icas do usurio a COMPILATION_DATADIR o dirertrio de dados do MySQL o qual foi especicado e o como uma opo do ./configure quando o mysqld foi compilado. (normalmente ca /usr/local/mysql/data para uma instalao binria ou /usr/local/var para uma ca a instalao fonte). ca Se voc no estiver certo de onde mysqld l o seu my.cnf ou my.ini, voc pode dar o e a e e caminho como a primeira opo de linha de comando para o servidor: mysqld --defaultsca file=your_path_to_my_cnf. O InnoDB forma o caminho do diretrio a um arquivo de dados concatenando textualmente o innodb_data_home_dir a um nome de arquivo de dados ou caminho em innodb_data_ file_path, adicionando uma poss barra ou barra invertida entre eles se for necessrio. ivel a Se a palavra-chave innodb_data_home_dir no mencionada em my.cnf, o padro para a e a ele o diretrio ponto ./ que signica o datadir de MySQL. e o Um exemplo de my.cnf avanado. Suponha que voc tenha um computador Linux com c e 2 GB RAM e trs disco r e igidos de 60 GB (no caminho de diretrios /, /dr2 e /dr3). o Abaixo esta um exemplo de parmetros de congurao poss a ca iveis no arquivo my.cnf para o InnoDB.

Cap tulo 7: Tipos de Tabela do MySQL

647

Note que o InnoDB no cria diretrios: voc mesmo deve cri-los. Use o comando mkdir a o e a do Unix ou MS-DOS para criar o diretrio base do grupo de dados e de log. o [mysqld] # Voc^ pode escrever outras op~es do servidor MySQL aqui e co # ... innodb_data_home_dir = # Os arquivos de devem estar aptos a # guardar seus dados e ndices i innodb_data_file_path = /ibdata/ibdata1:2000M;/dr2/ibdata/ibdata2:2000M:autoextend # Defina o tamanho da rea de buffer para a # 50 - 80 % da memria do seu computador, o # mas esteja certo, no Linux x86, que o # total de memria usada < 2 GB o e set-variable = innodb_buffer_pool_size=1G set-variable = innodb_additional_mem_pool_size=20M innodb_log_group_home_dir = /dr3/iblogs # .._log_arch_dir deve ser o mesmo # que .._log_group_home_dir innodb_log_arch_dir = /dr3/iblogs set-variable = innodb_log_files_in_group=3 # Defina o tamanho do arquivo de log # para cerca de 15% do tamanho da # rea da buffer a set-variable = innodb_log_file_size=150M set-variable = innodb_log_buffer_size=8M # Defina ..flush_log_at_trx_commit com # 0 se voc^ puder permitir a perda de e # algumas das ultimas transa~es. co innodb_flush_log_at_trx_commit=1 set-variable = innodb_lock_wait_timeout=50 #innodb_flush_method=fdatasync #set-variable = innodb_thread_concurrency=5 Note que ns colocamos os dois arquivos de dados em discos diferentes. O InnoDB o preencher o tablespace de tabela formado pelos arquivos de dados de baixo para cima. a Em alguns casos ele aumentar o desempenho do banco de dados se todos os dados no a a forem colocados no mesmo disco f isico. Colocar os arquivos de log em discos diferentes dos de dados geralmente, benco para o desempenho. Voc pode usar parties de discos e e e co raw (dispositivos raw) como arquivos de dados. Em alguns Unixs eles aumentam a E/S. Vejam a seo sobre gerenciamento de espao de arquivos no InnoDB para saber como ca c especic-los no my.cnf. a Aviso: no Linux x86 voc deve ter cuidado par no denir um uso de memria muito alto. e a o glibc permitir que o rea do processo cresa acima da pilha da thread, o que far com que a a c a o seu servidor falhe. Isto um risco se o valor de e innodb_buffer_pool_size + key_buffer + max_connections * (sort_buffer + read_buffer_size) + max_connections * 2 MB

648

MySQL Technical Reference for Version 5.0.0-alpha

prximo de 2 GB ou exceda 2 GB. Cada thread usar uma pilha (geralmente 2 MB, mas e o a no binrio da MySQL AB somente 256 KB) e no pior caso usar tmabm sort_buffer + a e a e read_buffer_size de memria adicional. o

Como sintonizar outros parmetros do servidor mysqld? Valores comuns que servem para a a maioria dos usurios so: a a

skip-locking set-variable set-variable set-variable # # # # # # set-variable

= max_connections=200 = read_buffer_size=1M = sort_buffer=1M Defina key_buffer com 5 - 50% de sua RAM dependendo de quanto voc^ usa tabelas MyISAM, mas e mantenha key_buffer + tamanho da rea de buffer do InnoDB < 80% de a sua RAM = key_buffer=...

Note que alguns parmetros so dados usando o formato do parmetro numrico de my.cnf: a a a e set-variable = innodb... = 123, outros (parmetros string e booleanos) com outro fora mato: innodb_... = ... .

O signicado dos parmetros de congurao so os seguintes: a ca a

Opo ca innodb_file_per_table

innodb_data_home_dir

Descrio ca Dispon ivel a partir da verso 4.1.1. Esta opo faz a ca com que o InnoDB armazene cada tabela criada em seu prprio arquivo .ibd. Veja a seo sobre multiplos o ca tablespaces. A parte comum do caminho do diretrio para todos aro quivos de dados InnoDB. Se voc no mencionar esta e a opo em my.cnf, o padro o datadir do MySQL. ca a e Voc pde especic-lo tambm como uma string vazia, e a e e neste caso voc poder utilizar caminhos de arquivos e a absolutos em innodb_data_file_path.

Cap tulo 7: Tipos de Tabela do MySQL

649

innodb_data_file_path

innodb_mirrored_log_groups innodb_log_group_home_dir innodb_log_files_in_group innodb_log_file_size

innodb_log_buffer_size

Caminho para os arquivos de dados individuais e os seus tamanhos. O caminho do diretrio completo para o cada arquivo de dados obtido concatenando inne odb data home dir ao caminho especicado aqui. O tamanho do arquivo especicado em megabytes, adicioe nando o M depois da especicao do tamanho. InnoDB ca tambm entende a abreviao G, 1 G signica 1024 MB. e ca A partir da verso 3.23.44 voc pode denir o tamanho a e do arquivo maior que 4 GB em sistemas operacionais que seuportam que suportam arquivos grandes. Em alguns sistemas operacionais arquivos devem ser menor que 2 GB. Se voc no especicar innodb_data_file_path, o e a comportamento padro a partir do verso 4.0 criar um a a e arquivo de dados ibdata1 de 10 MB auto-extens ivel. A soma do tamanho dos arquivos devem ser menores que 10 MB. Nmero de cpias idnticas de grupos de log mantidos u o e para os banco de dados. Atualmente deve ser denido com 1. Caminho do diretrio de arquivos de log do InnoDB. Se o voc no mencionar esta opo no my.cnf o padro o e a ca a e datadir do MySQL. Nmero de arquivos de log no grupo de log. O InnoDB u escreve nos arquivos de modo circular. O valor recomendado aqui 2. O valor padro 2. e a e Tamanho de cada arquivo de log em um grupo de logs em megabytes. Faixa de valores sens iveis de 1M a 1/n-th do tamanho do rea de buer especicado abaixo, onde n a e o nmero de arquivos de log no grupo. Quanto maior o u e valor, menos atividade de descarga necessria na rea e a a de buer, economizando E/S de disco. Mas arquivos de log maiores tambm signica que a recuperao ser lenta e ca a no caso de falhas. O tamanho combinado do arquivo de log deve ser menor que 4GB em comutadores de 32 bits. O padro 5M. a e O tamanho do buer que o InnoDB utiliza para escrever o log em aruivos no disco. Faixa de valores sens iveis de 1M a 8M. Um buer de log grande permite aumentar transaes para executarem sem precisar de escrever o log co em at se fazer um commit da transao. iAlem disso, e ca se voc tiver grande transaes, fazer um buer de log e co maior economiza E/S de disco.

650

MySQL Technical Reference for Version 5.0.0-alpha

innodb_flush_log_at_trx_ commit

innodb_log_arch_dir

innodb_log_archive

innodb_buffer_pool_size

innodb_buffer_pool_awe_ mem_mb

Normalmente atribuido 1, signicando que em um come mit de uma transao o log descarregado para o disco ca e e as modicaoes feitas pela transao se tornam perc ca manentes, sobrevivendo a uma falha no banco de dados. Se voc estiver disposto a comprometer esta segrana e e c est executando transaes pequenas, voc pode den a co e i-lo com 0 ou 2 para reduzir E/S de discos nos logs. O valor 0 signica que o log s escrito no arquivo e este descaroe e regado pro disco aproximadamente uma vez por segundo. O valor 2 signica que o log escrito no arquivo a cada e commit, mas o arquivo de log s descarregado em disco oe aproximadamente uam vez por segundo. O valor padro a 1 a partir do MySQL-4.0.13; antes era 0. e O diretrio onde arquivos de log totalmente escritos seo riam escritos se usarmos arquivamento de log. Atualmente o valor deste parmetro deve ser denido igual a a innodb_log_group_home_dir. Atualmente este valor deve ser denido com 0. Como a recuperao ai partir de um backup deve ser feito pelo ca MySQL usando os seus prprios arquivos de log, no h o a a nenhuma necessidade de se arquivos os arquivos de log do InnoDB. O tamanho do buer de memria que o InnoDB usa o para armazenar dados e indices de suas tabelas. Quanto maior for este valor, menor ser a necessidade de E/S a de disco para acessar dados na tabela. Em um servidor de banco de dados dedicado voc pode denir este e parmetro at 80% do tamanho da memria f a e o isica da mquina. No atribua um valor muito alto, pois a coma a petio da memria f ca o isica pode causar paginao no sisca tema operacional. Tamanho da rea de buer em Mb, se estiver locala izado na memria AWE do Windows 32 bits. Deipon o ivel a partir da verso 4.1.0 e relevante apenas no Wina dows 32 bits. Se o seu Windows suporta mais 4GB de memria, chamado Address Windowing Extensions, o voc pode alolcar a rea de buer do InnoDB em uma e a memria f o isica AWE usando este parmetro. O maior a valor possivel para isto 64000. Se este parmetro for e a especicado, ento innodb buer pool size a janela no a e espao de endereo de 32 bits do mysqld onde o InnoDB c c mapeia aquela memria AWE. Um bom valor para inno odb buer pool size 500M. e

Cap tulo 7: Tipos de Tabela do MySQL

651

innodb_additional_mem_ pool_size

innodb_file_io_threads innodb_lock_wait_timeout

innodb_flush_method innodb_force_recovery

Tamanho do pool da memria que o InnoDB utiliza para o armazenar informaes de dicionrio de dados e outras esco a truturas de dados internas. Um bom valor aqui pode ser 2M, mas quanto mais tabelas voc tiver em sua aplicao, e ca mais voc precisar alocar aqui. Se o InnoDB car sem e a memria neste pool, ele l comeara a alocar memria do o c o sistema operacional e a escrever mensagens de aviso no log de erro do MySQL. Nmero de threads de E/S de arquivos no InnoDB. Noru malmente ele deve ser 4, mas no Windows E/S de disco pode se beneciar de um nmero maior. u Tempo limite em segundos que uma transao InnoDB ca pode esperar por uma trava antes de fazer um roll back. InnodDB detecta automaticamente deadlocks de transaes em sua prpria tabela bloqueada e faz um co o roll back da transao. Se voc utiliza o comando LOCK ca e TABLES, ou outro mecanismo de armazenamento seguro com transaes diferente do InnoDB na mesma transao, co ca ento um deadlock pode crescer, o que no seria notia a cado pelo InnoDB. Nestes casos o tempo limite util para e resolver a situao. ca (Dispon a partir da verso 3.23.40.) O valor padro ivel a a para este parmetro fdatasync. Outra opo O_ a e ca e DSYNC. Aviso: esta opo s deve ser denida em uma situao de ca o ca emergncia quando voc quiser um dump de suas tabelas e e em um banco de dados corropido! Os valores poss iveis so a de 1 - 6. Veja abaixo na seo Forando a recuperao ca c ca sobre o signicado dos valores. Como uma medida segura o InnoDB previne que um usurio modique os dados a quando esta opo > 0. Esta opo est dispon ca e ca a ivel a partir da verso 3.23.44. a

7.5.4 Criando Tablespaces no InnoDB

Suponha que voc instalou o MySQL e editou my.cnf para que ele contenha os parmetros e a de congurao do InnoDB necessrios. Antes de iniciar o MySQL voc deve vericar se ca a e os diretrios que voc especicou para os arquivos de dados e de log do InnoDB existem e o e se voc tem direito de acesso a estes diretrios. InnoDB no pode criar diretrios, apenas e o a o arquivos. Verique tambm se voc tm espao suciente em disco para or arquivos de e e e c dados e de log. Quando iniciar o MySQL, InnoDB comeara criando os seus arquivos de dados e de log. O c InnoDB ir imprimir algo como o mostrado a seguir: a ~/mysqlm/sql > mysqld InnoDB: The first specified datafile /home/heikki/data/ibdata1 did not exist: InnoDB: a new database to be created!

652

MySQL Technical Reference for Version 5.0.0-alpha

InnoDB: Setting file /home/heikki/data/ibdata1 size to 134217728 InnoDB: Database physically writes the file full: wait... InnoDB: datafile /home/heikki/data/ibdata2 did not exist: new to be created InnoDB: Setting file /home/heikki/data/ibdata2 size to 262144000 InnoDB: Database physically writes the file full: wait... InnoDB: Log file /home/heikki/data/logs/ib_logfile0 did not exist: new to be created InnoDB: Setting log file /home/heikki/data/logs/ib_logfile0 size to 5242880 InnoDB: Log file /home/heikki/data/logs/ib_logfile1 did not exist: new to be created InnoDB: Setting log file /home/heikki/data/logs/ib_logfile1 size to 5242880 InnoDB: Log file /home/heikki/data/logs/ib_logfile2 did not exist: new to be created InnoDB: Setting log file /home/heikki/data/logs/ib_logfile2 size to 5242880 InnoDB: Started mysqld: ready for connections Um novo banco de dados InnoDB foi criado. Voc pode se conectar ao servidor MySQL e com o programa cliente MySQL de costume como mysql. Quando voc naliza o servidor e MySQL com mysqladmin shutdown, a sa do InnoDB ser como a seguinte: ida a 010321 18:33:34 010321 18:33:34 InnoDB: Starting InnoDB: Shutdown mysqld: Normal shutdown mysqld: Shutdown Complete shutdown... completed

Agora voc pode ver os diretrios de arquivos de dados e logs e voc ver os e o e a arquivos criados. O diretrio de log tambm ir conter um pequeno arquivo chamado o e a ib_arch_log_0000000000. Este arquivo foi resultado da criao do banco de dados, ca depois do InnoDB desligar o arquivamento de log. Quando o MySQL for iniciado novamente, a sa ser a seguinte: ida a ~/mysqlm/sql > mysqld InnoDB: Started mysqld: ready for connections

7.5.4.1 Se Alguma Coisa Der Errado Na Criao Do Banco de ca Dados

Se o InnoDB imprmir um erro do sistema operacional em uma operao de arquivo normalca mente o problema um dos seguintes: e Voc no criou os diretrios de dados e de logo do InnoDB. e a o mysqld no tem o direito de criar arquivos neste diretrio. a o mysqld no le o arquivo my.cnf ou my.ini corretom e consequentemente no enxa a erga as opes que voc especicou. co e O disco est cheio ou a quota de disco foi excedida. a Voc criou um subdiretrio cujo nome igual ao arquivo de dados que voc especicou. e o e e

Cap tulo 7: Tipos de Tabela do MySQL

653

Existe um erro de sintaxe em innodb_data_home_dir ou innodb_data_file_path. Se ocorrer algum erro na criao de banco de dados InnoDB, voc deve deletar todos os ca e arquivos criados pelo InnoDB. Isto signica todos os arquivos de dados, de log, o pequeno log arquivado e no caso de voc j ter criado algumas tableas InnoDB, delete tambm os e a e arquivos .frm correspondentes a estas tabelas do diretrio de banco de dados do MySQL. o Ento voc pode tentar criar o banco de dados InnoDB novamente. a e

7.5.5 Criando Tabelas InnoDB

Suponha que voc tenha iniciado o cliente MySQL com o comando mysql test. Para criar e uma tabela no formato InnoDB voc deve especicar TYPE = InnoDB no comando SQL de e criao da tabela: ca CREATE TABLE CUSTOMER (A INT, B CHAR (20), INDEX (A)) TYPE = InnoDB; Este comando SQL criar uma tabela e um a indice na coluna A no tablespace do InnoDB consistindo dos arquivos de dados que voc especicou em my.cnf. Adicionalmente o e MySQL criar um arquivo CUSTOMER.frm no diretrio de banco de dados test do MySQL. a o Internamente, InnoDB adicionar ao seu prprio diretrio de dados uma entrada para tabela a o o test/CUSTOMER. Assim voc pode criar uma tabela de mesmo nome CUSTOMER em outro e banco de dados do MySQL e os nomes de tabela no iro colidir dentro do InnoDB. a a Voc pode consultar a quantidade de espao livre no tablespace do InnoDB utilizabdo o e c comando de status da tabela do MySQL para qualquer tabela que voc criou com TYPE = e InnoDB. Ento a quantidade de espao livre no tablespace aparecer na seo de comentrio a c a ca a da tabela na sa de SHOW. Um exemplo: ida SHOW TABLE STATUS FROM test LIKE CUSTOMER Note que a estat isticas SHOW dada sobre tabelas InnoDB so apenas aproximadas: elas no a a so usadas na otimizao SQL. Tamanho reservado de tabelas e indices em bytes esto a ca a acurado.

7.5.5.1 Convertendo Tabelas MyISAM para InnoDB

O InnoDB no tem uma otimizao especial para criao de a ca ca indices separados. Assim no a h custo para exportar e importar a tabela e criar a indices posteriormente. O modo mais rpido de se alterar uma tabela para InnoDB fazer as inseres diretamente em uma tabela a e co InnoDB, isto , use ALTER TABLE ... TYPE=INNODB, ou crie uma tabela InnoDB vazia com e denies idnticas e insira os registro com INSERT INTO ... SELECT * FROM .... co e Para obter um melhor controle sobre o processo de insero, pode ser bom inserir grandes ca tabelas em pedaos: c INSERT INTO newtable SELECT * FROM oldtable WHERE yourkey > something AND yourkey <= somethingelse; Depois de todos os dados serem inseridos voc pode renomear as tabelas. e Durante a canverso de tabelas grandes voc deve congurar rea de buer com um a e a a tamanho grande para reduzir a E/S de disco. No deve ser maior que 80% da memria a o f isica. Voc deve congurar o arquivo de log do InnoDB grande, assim como o buer de e log.

654

MySQL Technical Reference for Version 5.0.0-alpha

Certique-se de que voc no ir ocupar todo o tablespace: tabelas InnoDB gasta muito e a a mais espao que tabelas MyISAM. Se um ALTER TABLE car sem espao, ele ir iniciar um c c a rollback, que pode levar horas se ele estiver no limite de disco. Para inseres, o InnoDB co utiliza o buer de insero para fundir registros de ca indices secundrios a a indices em grupos. Isto economiza muito a E/S de disco. No rollback tal mecanismo no usado e o rollback a e pode demorar 30 vezes mais que a insero. ca No caso de um rollback demorado, se voc no tiver dados valiosos e seu banco de dados, e a melhor que voc mate o processo de banco de dados, delete todos os arquivos de dados e e e de log do InnoDB e todos os arquivos de tabela .frm e inicie o seu trabalho de novo, do que esperar que milhes de E/Ss de disoc de complete. o

7.5.5.2 Restrioes FOREIGN KEY c

A partir da verso 3.23.43b, o InnoDB disponibiliza restries de chaves estrangeiras. O a co InnoDB o primeiro tipo de tabela da MySQL, que permite denir restries de chaves e co estrangeiras para guardar a integridade dos seus dados. A sintaxe da denio das restriess de chaves estrangeiras no InnoDB: ca co [CONSTRAINT [symbol]] FOREIGN KEY (index_col_name, ...) REFERENCES nome_tabela (index_nome_coluna, ...) [ON DELETE {CASCADE | SET NULL | NO ACTION | RESTRICT}] [ON UPDATE {CASCADE | SET NULL | NO ACTION | RESTRICT}] Ambas as tabelas devem ser do tipo InnoDB, na tabela deve existir um indice onde as colunas de chaves estrangeiras listadas como as PRIMEIRAS colunas e na tabela indicada deve haver um indice onde as colunas indicadas so listadas como as PRIMEIRAS colunas a e na mesma ordem. O InnoDB no cria indices automaticamente em chaves estrangeiras a para chaves refernciadas: voc tem que cri-las explicitamente. Os e e a indices so necessrios a a para vericao de chaves estrangeiras para ser rpido e no exigir a varredura da tabela. ca a a Colunas correspondentes nas chaves estrangeiras e a chave referenciada devem ter tipos de dados internos parecidos dentro do InnoDB para que possam ser comparados sem uma converso de tipo. O tamanho e a sinalizao de tipos inteiros devem ser o mesmo. O a ca tamanho do tipos string no precisam ser o mesmo. Se voc especicar uma ao SET NULL, a e ca esteja certo de que voc no declarou as colunas na tabela lha como NOT NULL. e a Se o MySQL retornar o erro de nmero 1005 de uma instruo CREATE TABLE, e a string u ca de mensagem de erro se referir ao errno 150, ento a criao da tabela falhou porque um a ca restrio de chaves estrangeiras no foi formada corretamente. Similarmente, se uma ALTER ca a TABLE falhar e se referir ao errno 150, sgnica que um denio de chave estrangeira foi ca formada incorretamente na tabela alterada. A partir da verso 4.0.13, voc pode usar SHOW a e INNODB STATUS para ver uma explicao detalhada do ultimo erro de chave estrangeira do ca InnoDB no servidor. A partir de verso 3.23.50, InnoDB no verica restries de chaves estrangeiras naqueles a a co valores de chaves estrangeiras ou chaves refernciadas que contenham uma coluna NULL. e Um desvio do padro SQL: se na tabela pai existirem diversos registros tm o mesmo valor a e de chave referncia, ento o InnoDB atua na vericao da chave estrangeira como o outro e a ca

Cap tulo 7: Tipos de Tabela do MySQL

655

registro pai como se o mesmo valor de chave no existisse. Por exemplo, se voc tiver a e denido uma restrio de tipo RESTRICT, e existir um registro lho com diversos registros ca pais, o InnoDB no permite a deleo de qualquer um dos registros pais. a ca A partir da verso 3.23.50, voc tambm pode associar a clusula ON DELETE CASCADE ou a e e a ON DELETE SET NULL com a restrio de chave estrangeira. Opes correspondentes do ON ca co UPDATE esto disponiveis a partir da verso 4.0.8. Se ON DELETE CASCADE for especicado, a a e um registro na tabela pai for deletado, ento o InnoDB automaticamente tambm deleta a e todos aqueles registros na tabela lha cujos valores de chaves estrangeiras so iguais ao valor a da chave refernciada no registro pai Se ON DELETE SET NULL for especicado, os registros e lhos so automaticamente atualizados e assim as colunas na chave estrangeira so denidas a a com o valor NULL do SQL. Um desvio dos padres SQL: se ON UPDATE CASCADE ou ON UPDATE SET NULL retornam para o atualizar a MESMA TABELA que ja tenha sido atualizada durante o processo cascata, ele atua como RESTRICT. Isto para prevenirloops innitos resultantes de atualizaes em e co cascata. Um ON DELETE SET NULL auto referncial, por outro lado, funciona desde a verso e a 4.0.13. ON DELETE CASCADE auto referncial j est funcionando. e a a Um exemplo: CREATE TABLE parent(id INT NOT NULL, PRIMARY KEY (id)) TYPE=INNODB; CREATE TABLE child(id INT, parent_id INT, INDEX par_ind (parent_id), FOREIGN KEY (parent_id) REFERENCES parent(id) ON DELETE SET NULL ) TYPE=INNODB; Um exemplo complexo: CREATE TABLE product (category INT NOT NULL, id INT NOT NULL, price DECIMAL, PRIMARY KEY(category, id)) TYPE=INNODB; CREATE TABLE customer (id INT NOT NULL, PRIMARY KEY (id)) TYPE=INNODB; CREATE TABLE product_order (no INT NOT NULL AUTO_INCREMENT, product_category INT NOT NULL, product_id INT NOT NULL, customer_id INT NOT NULL, PRIMARY KEY(no), INDEX (product_category, product_id), FOREIGN KEY (product_category, product_id) REFERENCES product(category, id) ON UPDATE CASCADE ON DELETE RESTRICT, INDEX (customer_id), FOREIGN KEY (customer_id) REFERENCES customer(id)) TYPE=INNODB; A partir da verso 3.23.50 o InnoDB lhe permite adicionar novas restrioes de chaves a c o estrangeiras a uma tabela. ALTER TABLE seunomedetabela ADD [CONSTRAINT [symbol]] FOREIGN KEY (...) REFERENCES anothertablename(...) [on_delete_and_on_update_actions]

656

MySQL Technical Reference for Version 5.0.0-alpha

Lembre-se de criar os indices necessrios primeiro. a A partir da verso 4.0.13, o InnoDB suporta a ALTER TABLE suatabela DROP FOREIGN KEY id_chave_estrangeira_gerada_internamente Voc tem que usar SHOW CREATE TABLE para daterminar as ids de chaves estrangeiras gere adas internamente quando voc apaga uma chave estrangeira. e Na verso anterior a 3.23.50 do InnoDB, ALTER TABLE ou CREATE INDEX no devem ser a a usadas em conexes com tabelas que tm restrioes de chaves estrangeiras ou que so reo e c a fernciadas em restries de chaves estrangeiras: Qualquer ALTER TABLE remove todas as e co restries de chaves estrangeiras denidas na tabela. Voc no deve utilizar ALTER TABLE co e a para tabela referenciadas tambm, mas utilizar DROP TABLE e CREATE TABLE para modifcar e o esquema. Quando o MySQL faz um ALTER TABLE ele pode usar internamente RENAME TABLE, e isto ir confundir a restrio de chave estrangeira que se refere a tabela. Uma a ca instruo CREATE INDEX processada no MySQL como um ALTER TABLE, e estas restries ca e co tambm se aplicam a ele. e Ao fazer a vericao de chaves estrangeiras, o InnoDB dene o bloqueio a nivel de linhas ca compartilhadas em registros lhos e pais que ele precisa vericar. O InnoDB verica a restrio de chaves estrangeiras imediatamente: a vericao no aplicada no commit da ca ca a e transaao. c Se voc quiser ignorar as restries de chaves estrangeiras durante, por exemplo um operao e co ca LOAD DATA, voc pode fazer SET FOREIGN_KEY_CHECKS=0. e O InnoDB lhe permite apagar qualquer tabela mesmo que ela quebre a restrio de chaves ca estrangeira que referencia a tabela. Ao apagar um tabela restrio que denida na inca e struo create tambm apagada. ca e e Se voc recriar uma tabela que foi apagada, ela deve ter uma denio de acordo com a e ca restrio de chaves estrangeiras que faz referncia a ela. Ela deve ter os nomes e tipos de ca e colunas corretor e deve ter os indices na chave referenciada como indicado acima. Se esta condio no for satisfeita, o MySQL retornar o erro de nmero 1005 e se refere ao errno ca a a u 150 na string de mensagem de erro. A partir da verso 3.23.50 o InnoDB retorna da denio de chave estrangeira de uma tabela a ca quando voc chama e SHOW CREATE TABLE seunometabela Assim o mysqldump tambm produz as dinies de tabelas corretas no arquivo dump e e co no se esquece das chaves estrangeiras. a Voc tambm pode listar as restries de chaves estrangeiras de uma tabela T com e e co SHOW TABLE STATUS FROM seubancodedados LIKE T As restries de chaves estrangeiras so listadas no comentrio da tabela impresso na sa co a a ida.

7.5.5.3 Multiplos tablespaces - colocando cada tabela em seu prprio arquivo .ibd o
NOTA IMPORTANTE: se voc atualizar para o InnoDB-4.1.1 ou posterior, ser dif e a icil retornar a verso 4.0 ou 4.1.0! Isto ocorre porque verses anteriores do InnoDB no a o a permitem vrios tablespaces. Se voc precisar retornar para a verso 4.0, voc dever fazer a e a e a

Cap tulo 7: Tipos de Tabela do MySQL

657

um dump das tabelas e recriar todo o tablespace do InnoDB. Se voc no tiver criado e a novas tabelas InnoDB em verses posteriores a 4.1.1, e e precisar retornar a verso anterior o a rapidamente, voc pode fazer um downgrade direto para a verso 4.0.18 do MySQL, ou e a outra da srie 4.0. Antes de fazer o downgrade diretamente para a verso 4.0.xx, voc ter e a e a que nalizar todas as conexes a verses >= 4.1.1 e deixar o mysqld to run purge and o o the insert buer merge to completion, so that SHOW INNODB STATUS shows the Main thread in the state waiting for server activity. Then you can shut down mysqld and start 4.0.18 or later in the 4.0 series. A direct downgrade is not recommended, however, because it is not extensively tested. Starting from MySQL-4.1.1, you can now store each InnoDB table and its indexes into its own le. This feature is called multiple tablespaces, because then each table is stored into its own tablespace. You can enable this feature by putting the line innodb_file_per_table in the [mysqld] section of my.cnf. Then InnoDB stores each table into its own le tablename.ibd in the database directory where the table belongs. This is like MyISAM does, but MyISAM divides the table into a data le tablename.MYD and the index le tablename.MYI. For InnoDB, both the data and the indexes are in the .ibd le. If you remove the line innodb_file_per_table from my.cnf, then InnoDB creates tables inside the ibdata les again. The old tables you had in the ibdata les before an upgrade to >= 4.1.1 remain there, they are not converted into .ibd les. InnoDB always needs the system tablespace, .ibd les are not enough. The system tablespace consists of the familiar ibdata les. InnoDB puts there its internal data dictionary and undo logs. You CANNOT FREELY MOVE .ibd les around, like you can MyISAM tables. This is because the table denition is stored in the InnoDB system tablespace, and also because InnoDB must preserve the consistency of transaction ids and log sequence numbers. You can move an .ibd le and the associated table from a database to another (within the same MySQL/InnoDB installation) with the familiar RENAME command: RENAME TABLE olddatabasename.tablename TO newdatabasename.tablename; If you have a clean backup of an .ibd le taken from the SAME MySQL/InnoDB installation, you can restore it to an InnoDB database with the commands: ALTER TABLE tablename DISCARD TABLESPACE; /* CAUTION: deletes the current .ibd file! <put the backup .ibd file to the proper place> ALTER TABLE tablename IMPORT TABLESPACE; Clean in this context means: There are no uncommitted modications by transactions in the .ibd le. There are no unmerged insert buer entries to the .ibd le. Purge has removed all delete-marked index records from the .ibd le. mysqld has ushed all modied pages of the .ibd le from the buer pool to the le. You can make such a clean backup .ibd le with the following method. Stop all activity from the mysqld server and commit all transactions.

658

MySQL Technical Reference for Version 5.0.0-alpha

Wait that SHOW INNODB STATUS\G shows that there are no active transactions in the database, and the main thread of InnoDB is Waiting for server activity. Then you can take a copy of the .ibd le. Another (non-free) method to make such a clean .ibd le is to Use InnoDB Hot Backup to backup the InnoDB installation. Start a second mysqld server on the backup and let it clean up the .ibd les in the backup. It is in the TODO to allow moving clean .ibd les also to another MySQL/InnoDB installation. That requires resetting of trx ids and log sequence numbers in the .ibd le.

7.5.6 Adicionando e Removendo Arquivos de Dados e Log do InnoDB

A partir da verso 3.23.50 e 4.0.2 voc pode especicar o ultimo arquivo de dados InnoDB a e com autoextend. De forma alternativa, pode se aumentar o seu tablespace especicando um arquivo de dados adicional. Para fazer isto voc tem que nalizar o servidor MySQL, e edite o arquivo my.cnf adicionando um novo arquivo de dados no final de innodb_data_ file_path, e entao iniciar o servidor MySQL de novo. Atualmente voc no pode remover um arquivo de dados do InnoDB. Para reduzir o e a tamanho de seu banco de dados voc tem que utilizar mysqldump para fazer um dump e de todas as suas tabelas, criar um novo banco de dados e importar suas tabelas para um novo banco de dados. Se voc quiser alterar o nmero ou o tamanho do seu arquivo de log InnoDB, voc tem e u e que nalizar o MySQL e certicar que ele nalizou sem erros. Copie ento o arquivo de log a antigo em um local seguro apenas para o caso de algo der errado ao nalizar e voc precisar e recuperar o banco de dados. Delete os arquivos de log antigo do diretrio de arquivos de o logm edite o my.cnf e inicie o MySQL novamente. O InnoDB lhe dir no inicio que ele a est criando novos arquivos de log. a

7.5.7 Fazendo Backup e Recuperando um Banco de Dados InnoDB

A chave para um gerenciamento seguro de banco de dados tirar backups regularmente. e O InnoDB Hot Backup uma ferramenta de backup online que voc pode utilizar pra fazer e e backup dos seus banco de dados InnoDB enquanto ele est executando. O InnoDB Hot a Backup no exige que voc nalize o seu banco de dados e no realiza nenhum bloqueio a e a ou cria disturbio no seu processo normal de banco de dados. O InnoDB Hot Backup e uma ferramenta adcional paga e que no est inclu na distribuio padro do MySQL. a a ida ca a Veja o site do InnoDB Hot Backup http://www.innodb.com/manual.php para informaes co detalhadas e telas do produto. Se voc puder desativar o servidor MySQL, ento, para fazer um backup de binario do seu e a banco de dados voc deve fazer o seguinte: e Finalize o seu banco de dados MySQL e certique-se de que ele nalizou sem erros. Copie todos os seus arquivos de dados em um local seguro.

Cap tulo 7: Tipos de Tabela do MySQL

659

Copie todos os seus arquivos de log do InnoDB em um local seguro. Copie o(s) seu(s) arquivo(s) de congurao my.cnf em um local seguro. ca Copie todos os arquivos .frm da suas tabelas InnoDB em um local seguro. Alm de fazer um backup de binrio descrito acima, voc tambm deve fazer um dump da e a e e sua tabela com mysqldump. A razo para se fazer isto que um arquivo binrio pode ser a e a corrompido cem voc perceber. Dumps de tabelas so armazenados em um arquivo texto e a leg e muito mais simples que arquivos binrios de banco de dados. Ver tabelas corropidas ivel a atravs de arquivos de dump mais fcil e, como o seu formato simples, a chance dos e e a e dados se corromperem seriamente so bem menores. a Uma boa idia fazer dumps ao mesmo tempo que voc faz o backup de binrio do seu e e e a banco de dados. Voc tem que fechar todos os bancos de dados nos clientes para ter uma e cpia consistente de todas as suas tabelas em seu dump. Ento voc pode fazer o backup o a e de binrio e voc ter uma cpia consistente de seu banco de dados em dois formatos. a e a o Para se poder recuperar o seu banco de dados InnoDB atravs do backup de binrio descrito e a acima, voc tem que executar o seu banco de dados MySQL com o sistema de log geral e e o arquivamento de log do MySQL ligado. Com sistema de log geral ns queremos dizer o o mecanismo de log do servidor MySQL que independente dos logs do InnoDB. e Para recuperao de falhas do seu processo do servidor MySQL, a unica coisa que voc deve ca e fazer reinici-lo. InnoDB vericar automaticamente os logs e realizar um roll-forward e a a a do banco de dados para o situao atual. O InnoDB far automaticamente um roll back de ca a transaes sem commit existentes no momento da falha. Durante a recuperao, InnoDB co ca ir imprimir algo como o seguinte: a ~/mysqlm/sql > mysqld InnoDB: Database was not shut down normally. InnoDB: Starting recovery from log files... InnoDB: Starting log scan based on checkpoint at InnoDB: log sequence number 0 13674004 InnoDB: Doing recovery: scanned up to log sequence number 0 13739520 InnoDB: Doing recovery: scanned up to log sequence number 0 13805056 InnoDB: Doing recovery: scanned up to log sequence number 0 13870592 InnoDB: Doing recovery: scanned up to log sequence number 0 13936128 ... InnoDB: Doing recovery: scanned up to log sequence number 0 20555264 InnoDB: Doing recovery: scanned up to log sequence number 0 20620800 InnoDB: Doing recovery: scanned up to log sequence number 0 20664692 InnoDB: 1 uncommitted transaction(s) which must be rolled back InnoDB: Starting rollback of uncommitted transactions InnoDB: Rolling back trx no 16745 InnoDB: Rolling back of trx no 16745 completed InnoDB: Rollback of uncommitted transactions completed InnoDB: Starting an apply batch of log records to the database... InnoDB: Apply batch completed InnoDB: Started mysqld: ready for connections

660

MySQL Technical Reference for Version 5.0.0-alpha

Se o seu banco de dados for corrompido ou o seu disco falhar, voc ter que fazer recue a peraes de um backup. no caso de dados corropidos, voc deve primeiro encontrar um co e backup que no est corrompido. A partir de um backup, faa a recuperao a partir do a a c ca arquivo de logs gerais do MySQL de acordo com a instruo no manual do MySQL. ca

7.5.7.1 Forando a recuperao c ca

Se ocorre o corrompimento de uma pgina do banco de dados, voc pode desejar fazer a e um dump de suas tabelas no banco de dados com SELECT INTO OUTFILE, e normalmente a maioria dos dados estar intacto e correto. Mas o corrompimento pode fazer com que a SELECT * FROM table, ou operaes de background do InnoDB falhe ou apresentem avisos, co ou at mesmo a recuperao roll-forward do InnoDB falhe. A partir do InnoDB 3.23.44, e ca existe uma opo do my.cnf com a qual voc pode forar o InnoDB a inicializar, e voc ca e c e tambm pode prevenir que operaes de background sejam executadas, e assim voc poder e co e a fazer um dump de suas tabelas. Por exemplo, voc pode congurar e set-variable = innodb_force_recovery = 4 no my.cnf. As alternativas para innodb_force_recovery esto listadas abaixo. O banco de dados no a a deve ser usado com estas opes! Como medida de segurana o InnoDB previne um usurio co c a de fazer um INSERT, UPDATE, ou DELETE quando esta opo > 0. ca e A partir da verso 3.23.53 e 4.0.4, voc tem permisso de se fazer um DROP ou CREATE de uma a e a tabela mesmo se a recuperao forada est sendo usada. Se voc sabe que determinada ca c a e tabela est causando uma falha no rollback, voc pode delet-la. Voc pode usar isto a e a e tambm para para um rollback em execuo causado por uma falha importanta ou ALTER e ca TABLE. Voc pode matar o processo mysqld e usar a opo do my.cnf innodb_force_ e ca recovery=3 para trazer o seu banco de dados sem o rollback. Apague ento a tabela que a est causando o rollback. a Um nmero maior abaixo signica que todas as precaues de nmeros menores esto inu co u a clu idas. Se voc puder fazer um dump de todas as suas tabelas com uma opo de no e ca mximo 4, ento voc est relativamente seguro que apenas alguns dados em paginas india a e a viduais corrompidas so perdidos. A opo 6 mais dramtica, porque pginas de bancos a ca e a a de dados so deixadas e um estado obsoleto, que podem introduzir mais corrompimento em a a rvores-B e outras estruturas de banco de dados. 1 (SRV FORCE IGNORE CORRUPT) deixa o servidor executar mesmo se ele detectar uma pgina corrompida; tenta fazer SELECT * FROM table saltar os a indices corrompidos e pginas, o que ajuda ao fazer dump de tabelas; a 2 (SRV FORCE NO BACKGROUND) evita que a thread principal seja executada: se uma falha ocorresse na remoo, isto seria evitado. ca 3 (SRV FORCE NO TRX UNDO) no executa rollback de transaes depois da rea co cuperao; ca e co 4 (SRV FORCE NO IBUF MERGE) tambm previne operaes merge no buer de inseres: se eles causassem falhar, melhor no faz-los; no calcula as estat co a e a isticas da tabelas; 5 (SRV FORCE NO UNDO LOG SCAN) no procura por undo logs quando iniciar a o banco de dados: InnoDB tratar mesmo transaes incompletas como comitadas; a co

Cap tulo 7: Tipos de Tabela do MySQL

661

6 (SRV FORCE NO LOG REDO) no faa o roll-forward no log em em conexo com a c a recuperao. ca

7.5.7.2 Ponto de Vericao ca

O InnoDB implementa um mecanismo de ponto de vericao chamado fuzzy checkpoint. O ca InnoDB descarregar pginas de banco de dados modicados da res de buer em pequenos a a a grupos. No h necessidade de descarregar a rea de buer em um unico grupo, o que iria, a a a na prtica, para o processamento da instruo SQL do usurio por um instante. a ca a Na recuperao de falhas o InnoDB procura por um rotulo de ponto de vericao escrito ca ca nos arquivos de log. Ele sabe que todas as modicaes no banco de dados anteriores ao co rtulo j esto presentes na imagem em disco do banco de dados. O InnoDB varre os o a a arquivos de log a partir do ponto de vericao apicando as modicaes registradas no ca co banco de dados. O InnoDB escreve no arquivo de log de um modo circular. Todas as modicaes efetico vadas que tornam a pagina de banco de dados na rea de buer diferente das imagens em a disco devem estar dispon iveis no arquivo de log no caso do InnoDB precisar fazer uma recuperao. Isto signica que quando O InnoDB comea a reutilizar um arquivo de log no ca c modo circular, ele deve estar certo de que imagens em disco da pagina de banco de dados j contm as modicaes registradas no arquivo de log que o InnoDM ir utilizar. Em a e co a outras palavras, o InnoDB precisa criar um ponto de vericao e geralmente isto envolve ca descarga de pginas de banco de dados modicados para o disco. a O exposto acima explica o porque que fazer o seu arquivo de log muito maior pode economizar E/S de disco com pontos de vericao. Pode fazer sentido congurar o tamanho ca do arquivo de log to grande quanto a `rea de buer ou mesmo maior. O problema com a a arquivos de log grandes que a recuperao de falhas pode ser mais demorada pois haver e ca a mais itens a se aplicar ao banco de dados.

7.5.8 Movendo um Banco de Dados InnoDB para Outra Mquina a

No Windows o InnoDB armazena os nomes de banco de dados e tabelas internamente sempre em letras minsculas. Para mover bancos de dados em um formato binrio do Unix u a para o Windows ou do Windows para o Unix voc deve ter todas os nomes de tabelas e e banco de dados em letras minscula. Um modo conveniente de fazer isto adicionar no u e Unix a linha set-variable=lower_case_table_names=1 na seo [mysqld] de seu my.cnf antes de voc iniciar a criao de sua tabela. no Windows ca e ca o valor 1 o padro. e a Arquivos de dados e log do InnoDB so binrios compat a a iveis com todas as plataformas se o formato do nmero de ponto utuante nas mquinas o mesmo. Voc pode mover u a e e um banco de dados InnoDB simplesmente copiando todos os arquivos relevantes, os quais ns j listamos na seo anterior sobre backup do banco de dados. Se o formato de ponto o a ca utuante nas mquinas so diferentes mas voc no utiliza tipos de dados FLOAT ou DOUBLE a a e a em suas tabelas ento o procedimento o mesmo; apenas copie os arquivos relevantes. Se a e

662

MySQL Technical Reference for Version 5.0.0-alpha

os formatos so diferentes e suas tabelas contenham dados de ponto utuante, voc tem a e que utilizar mysqldump e mysqlimport para mover estas tabelas. Uma dica de desempenho desligar o modo auto-commit quando voc importa dados em e e seu banco de dados, assumindo que o seu tablespace tem espao suciente para o grande c segmento de roolback que a transao de importao ira gerar. S faa o commit depois de ca ca o c importar toda a tabela ou um segmento de uma tabela.

7.5.9 Modelo Transacional do InnoDB

No modelo transacional do InnoDB o objetivo combinar as melhores propriedades de um e banco de dados multi-versioning a um bloqueio de duas fases tradicional. O InnoDB faz bloqueio a nivel de registro e execulta consultas como leitura consistente sem bloqueio, por padrao, no estilo do Oracle. A tabela travada no InnoDB armazenada com tanta e ecincia em relao ao espao que a escala de bloqueio no necessria: normalmente e ca c a e a diversos usurios tem permisso para bloquear todos os registros no banco de dados, ou a a qualquer subconjunto aleatrio de regitsros, sem que o InnoDB que sem memria. o o No InnoDB todas as atividades de usurios acontecem dentro de transaes. Se o modo a co autocommit usado no MySQL, ento cada instruo SQL forma uma unica transao. O e a ca ca MySQL sempre inicia uma nova conexo com o modo autocommit ligado. a Se o modo autocommit desligado com SET AUTOCOMMIT = 0, ento podemos achar que um e a usurio sempre tem uma transao aberta. Se for executada uma instruo SQL COMMIT ou a ca ca ROLLBACK, a transao atual nalizada e uma nova iniciada. Ambas instrues liberaro ca e e co a todas as travas do InnoDB que foram denidas durante a transao atual. Um COMMIT ca signica que as alteraes feitas na transao atual se tornam permanentes e vis co ca iveis a outros usurios. Uma instruo ROLLBACK, por outro lado, cancela todas as modicaes a ca co feitas pela transao corrente. ca Se a conexo tem AUTOCOMMIT = 1, ento o usurio pode ainda relaizar uma transao a a a ca multi-instruo iniciando-a com START TRANSACTION ou BEGIN e nalizando-a com COMMIT ca ou ROLLBACK.

7.5.9.1 InnoDB e SET ... TRANSACTION ISOLATION LEVEL ...

Em termos de n iveis de isolamento transacional SQL-92, o padro InnoDB REPEATABLE a e READ. A partir da verso 4.0.5, InnoDB oferece todos os n a iveis de isolamento transacional diferentes descritos pelo padro SQL-92. Voc pode denir o n a e ivel de isolamento padro a para todas as conexes na seo [mysqld] do my.cnf: o ca transaction-isolation = {READ-UNCOMMITTED | READ-COMMITTED | REPEATABLE-READ | SERIALIZABLE} Um usurio pode alterar o n a ivel de isolamento de um unica seo ou todas as prximas ca o sees com a instruo SQL SET TRANSACTION. Sua sintaxe a sseguinte: co ca e SET [SESSION | GLOBAL] TRANSACTION ISOLATION LEVEL {READ UNCOMMITTED | READ COMMITTED | REPEATABLE READ | SERIALIZABLE} Note que no h hifens no nome dos n a a iveis na sintaxe SQL.

Cap tulo 7: Tipos de Tabela do MySQL

663

O comportamento padro denir o n a e ivel de isolamento para a prxima transao (no o ca a iniciada). Se voc especicar a palavra chave GLOBAL na instruo acima, ela determinar o e ca a n de isolamento globalmente para todas as novas conexes criadas a partir deste ponto ivel o (mas no conexo exitentes). Voc precisa do privilgio SUPER para fazer isto. Usar a palavra a a e e chave SESSION dine a transao padro para todas as transaes realizadas futuramente ca a co na conexo atual. Qualquer cliente livre para alterar o n a e ivel de isolamento da sesso a (mesmo no meio de uma transao), ou o n de isolamento para a prxima transao. ca ivel o ca Voc pode consultar o n de isolamento da transao global ou da sesso com: e ivel ca a SELECT @@global.tx_isolation; SELECT @@tx_isolation; Nos travamentos de registro, InnoDB usa o chamado bloqueio de chave seguinte (next-key locking). Isto signica que alm dos registros de e indices, o InnoDB tambm pode bloquear e a lacuna antes de um registro de indice para bloquear inseres por outros usurios co a imediatamente antes do registro de indice. Um bloqueio de chave seguinte signica um bloqueio que trava um registro de indice e a lacuna antes dele. O bloqueio de lacuna signica um bloqueio que s trava a lacuna antes do registro de o indice. Uma descrio detalhada de cada n de isolamento em InnoDB: ca ivel READ UNCOMMITTED Tambm chamada dirty read: SELECTs sem bloqueio so ree e a verso mais nova de um registro; alizados de forma a no procurar por uma possivel a a assim as leituras no so consistentes sob este n a a ivel de isolamento; de outra forma este n funciona como READ COMMITTED. ivel READ COMMITTED N ivel de isolamento parecido com o Oracle. Todas as instrues co SELECT ... FOR UPDATE e SELECT ... LOCK IN SHARE MODE s travam o registro de o indice, n~o a lacuna antes dele e assim permite livre insero de novos registros prximo a ca o ao registro travado. Mas ainda no tipo de faixa UPDATE e DELETE, o InnoDB deve denir lock da chave seguinte ou da lacuna e bloquear inseres feitas por outros usurios nas co a lacunas cobertas pela faixa. Ist necessrio j que deve se bloquear linhas fantasmas oe a a para a replicao e recuperao no MySQL funcionar. Leituras consistentes (Consistent ca ca reads) comportam como no Oracle: cada leitura consistente, mesmo dentro da mesma transao, congura e l a sua prpria cpia recente. ca e o o REPEATABLE READ Este o n e ivel de isolamento padro do InnoDB. SELECT ... FOR a UPDATE, SELECT ... LOCK IN SHARE MODE, UPDATE, e DELETE que utilizam um indice unico com uma condio de busca unica, travam apenas o registro de ca indice encontrado, e no a lacuna antes dele. De outra forma estas operaes empregam travamento de a co registro seguinte, bloqueando a faixa de indice varrida com trava de chave seguinte ou de lacuna e bloqueando novas inseres feitas por outros usurios. Em leituras co a consistentes (consistent reads) existe uma diferena importante do n de isolmento c ivel todas as leituras consistentes dentro da mesma transao lem o anterior: neste nivel ca e mesma cpia estabelacido pela primeira leitura. Esta converso signica que se voc o a e executa diversas SELECTs dentro da mesma transao, elas tambm so consistentes ca e a entre elas. SERIALIZABLE Este n ivel como o anterior, mas todos os SELECTs so convertidos e a implicitamente para SELECT ... LOCK IN SHARE MODE.

664

MySQL Technical Reference for Version 5.0.0-alpha

7.5.9.2 Leitura Consistente sem Lock

Uma leitura consistente signica que o InnoDB utiliza multi-versioning para apresentar a uma consulta uma cpia do banco de dados em um dado momento. O consulta ver as o a mudanas feitas por aquelas transaes que zeram o commit antes daquele momento e c co no ver nenhuma mudana feita por transaes posteriores ou que zeram o commit. A a a c co exceo a esta regra que a consulta ver as mudanas feitas pela transao que executar ca e a c ca a consulta. Se voc est utilizando o n e a ivel de isolamento padro REPEATABLE READ, ento todas as a a leituras consistentes dentro da mesma transao lem a mesma cpia estabelacida pela ca e o primeira leitura naquela transao. Voc pode obter uma cpia recente para sua consulta ca e o fazendo um commit da transao atual e executando uma nova consulta. ca Leituras consistentes o modo padro no qual o InnoDB processa instrues SELECT em e a co niveis de isolamento READ COMMITTED e REPEATABLE READ. Uma leitura consistentes no a congura nenhuma trava em tabelas que ela acessa e assim outros usurios esto livres para a a modicar estas tabelas ao mesmo tempo que uma leitura consistente esta sendo feita na tabela.

7.5.9.3 Lock de Leitura SELECT ... FOR UPDATE e SELECT ... LOCK IN SHARE MODE
Uma leitura consistente no conveniente em alguma circunstncias. Suponha que voc a e a e queira adicionar uma nova linha em sua tabela CHILD, e est certo que ela j possui um pai a a na tabela PARENT. Suponha que voc utilize leitura consistente para ler a tabela PARENT e certamente veja o e pai do lho na tabela. Agora voc pode adiciona com segurana o registro lho na tabela e c CHILD? No, porque pode ter acontecido de outro usurio ter deletado o registro pai da a a tabela PARENT, e voc no estar ciente disto. e a A soluo realizar o SELECT em um modo de travamento, LOCK IN SHARE MODE. ca e SELECT * FROM PARENT WHERE NAME = Jones LOCK IN SHARE MODE; Realizar uma leitura em modo compartilhado signica que lemos o dado dispon ivel por ultimo e conguramos travas de leitura nos registros lidos. Se o este dado pertencer a uma transao de outro usurio que ainda no fez commit, esperaremos at que o commit seja ca a a e realizado. Uma trava em modo compartilhado previne que ocorra atualizaes ou delees co co de registros j lidos. Depois de vermos que a consulta acima retornou o pai Jones, a podemos com segurana adicionar o seu lho a tabela CHILD, e realizar o commit de nossa c transao. Este exemplo mostra como implementar integridade referncial no cdigo de sua ca e o aplicao. ca Deixe-nos mostrar outro exemplo: temos um compo de contador inteiro em uma tabela CHILD_CODES que usamos para atribuir um identicador unico para cada lho que adi cionamos na tabela CHILD. Obviamente, usar uma leitura consistente ou uma leitura em modo compartilhado para ler o valor atual do contador no uma boa idia, j que dois a e e a usurios do banco de dados podem ver o mesmo valor para o contador e, assim, ter a iamos um erro de chave duplicada ao adicionarmos os dois lhos com o mesmo identicador para a tabela.

Cap tulo 7: Tipos de Tabela do MySQL

665

Neste caso existem dois bons modos de se implementar a leitura e o incremento do contador: (1) atualizar o contador primeiro aumentando-o de 1 e s depois disto l-lo, ou (2) ler o o e contador primeiro com um modo de bloqueio FOR UPDATE, e increment-lo depois disto: a SELECT COUNTER_FIELD FROM CHILD_CODES FOR UPDATE; UPDATE CHILD_CODES SET COUNTER_FIELD = COUNTER_FIELD + 1; Um SELECT ... FOR UPDATE ir ler o dado dispon por ultimo atribuindo travas exclusivas a ivel a cada linha que ele ler. Assim ele atribui uma mesma trava que um UPDATE SQL pesquisado atribuiria nos registros.

7.5.9.4 Lock da Chave Seguinte: Evitando Problemas com Fantasmas

Em um lock de registro o InnoDB utiliza um algoritmo chamado trava de chave seguinte. O InnoDB faz o lock de registro, assim quando ele faz uma busca ou varre a tabela, ele atribui travas compartilhadas ou exclusivas nos registros que ele encontra. Assim o bloqueio de registro mais precisamente chamado lock de registro de e indice. A trava que o InnoDB atribui em registro de indices tambm afetas as lacunas antes daquele e registro de indice. Se um usurio tem uma trava compartilhada ou exclusiva no registro R em a um indice, ento outro usurio no pode inserir um novo registro de a a a indice imediatamente antes de R na ordem do indice. Este bloqueio de lacunas feito para prevenir o chamado e problema de fantasma. Suponha que eu queira ler e travar todos os lhos com identicador maior que 100 da tabela CHILD e atualizar alguns campos nos registros selecionados. SELECT * FROM CHILD WHERE ID > 100 FOR UPDATE; Suponha que exista um indice na tabela CHILD na coluna ID. Nossa consulta varrer aquele a indice comeando do primeiro registro onde ID maior que 100. Agora, se a trava atribu c e ida no registro de indice no travasse inseres feitas nas lacunas, um novo lho poderia ser a co inserido na tabela. Se agora eu executasse em minha transao ca SELECT * FROM CHILD WHERE ID > 100 FOR UPDATE; novamente, eu veria um novo lho no resultado que a consulta retorna. Isto contra o e princ ipio de isolamento das transaes: uma transao deve executar sem que os dados que co ca ele estaja lendo sejam alterados durante a transao. Se considerarmos um conjunto de ca registros como um item de dados, ento o novo lho fantasma quebrar o principio do a a isolamento. Quando o InnoDB varre um indice ele tambm pode bloquear a lacuna depois do ultimo e registro no indice. Assim como no exemplo anterior: a trava atribuida pelo InnoDB ir a previnir que seja feita qualquer insero na tabela onde ID seja maior que 100. ca Voc pode utilizar trava de chave seguinte para implementar uma vericao de unicidade e ca em sua aplicao: se voc ler os seus dados em modo compartilhado e no ver um registro ca e a que duplique o que voc ir inserir, ento voc pode inser com segurana e saber que o e a a e i-lo c trava de chave seguinte atribuida ao registro sucessor ao seu durante a leitura ir previnir a que algum insira um registro que duplique o seu neste intervalo. Assim a trava de chave e seguinte permite que voc bloqueie a no existncia de algo em sua tabela. e a e

666

MySQL Technical Reference for Version 5.0.0-alpha

7.5.9.5 Locks Denidos por Diferentes Instrues SQL no InnoDB co

SELECT ... FROM ...: esta uma leitura consistente, lendo uma cpia do banco de e o dados e no deninfo travas. a SELECT ... FROM ... LOCK IN SHARE MODE: atribui travas de chave seguinte compratilhadas em todos os regitros de indices que a leitura encontrar. SELECT ... FROM ... FOR UPDATE: atribui travas de chave seguinte exclusivas em todos os registros de inidices que a leitura encontra. INSERT INTO ... VALUES (...): atribui uma trava exclusiva em registros inseridos; note que est rava no uma trava de chave seguinte e no previne que outros usurios a a e a a insiram nas lacunas antes do registro inserido. Se um erro de chave duplicada ocorrerm, atribua uma trava compartilhada no registro de indice duplicado. INSERT INTO T SELECT ... FROM S WHERE ... atribui uma trava exclusiva em cada linha inserida em T. Faz a busca em S como uma leitura consistente, mas congura travas de chave seguinte compartilhada em S se o log do MySQL estiver ligado. O InnoDB tem que atribuir travas neste ultimo caso porque em recuperaes roll-forward co de um backup, toda instruo SQL tem que ser executada exatamente da mesma ca forma que foi feito originalmente. CREATE TABLE ... SELECT ... realiza o SELECT como uma leitura consistente ou com travas compartilhadas, como no item anterior. REPLACE feita como uma insero se no houver colises em uma chave unica. De e ca a o outra forma, uma trava de chave seguinte exclusiva colocada na linha que deve ser e atualizada. UPDATE ... SET ... WHERE ...: atribui trava de chave seguinte exclusiva em todos os registros que a busca encontrar. DELETE FROM ... WHERE ...:atribui trava de chave seguinte exclusiva em todos os registros que a busca encontrar. Se uma restrio FOREIGN KEY denida na tabela. qualquer inserao, atualizao ca e c ca ou deleo que exige vericao da condio de restrio congura travas de registros ca ca ca ca compartilhados nos registros que que ele olha na vericao da restrio. Tambm no ca ca e caso onde a restrio falha. o InnoDB dene estes bloqueios. ca LOCK TABLES ... : atribui trava a tabela. Na implementao a camada MySQL de ca cdigo atribui este bloqueio. A deteco automatica de deadlocks do InnoDB no pode o ca a ser feita onde tais travas de tabelas esto envolvidas: veja a seo seguinte. Tambm, a ca e que voc obtenha uma vez que o MySQL sabe sobre bloqueio de registros, impossivel e e um bloqueio em uma tabela na qual outro usurio tenha bloqueio de registro. Mas a isto no coloca a integridade da transao em perigo. Veja Seo 7.5.15 [Restries a ca ca co InnoDB], Pgina 678. a

7.5.9.6 Deteco de Deadlock e Rollback ca

O InnoDB detecta automaticamente o deadlock de transaes e faz um roll back da(s) co transao(es) para prevenir o deadlockck. A partir da verso 4.0.5, o InnoDB tentar ca o a a escolher pequenas transaes para se fazer roll back. O tamanho de uma transao co ca e

Cap tulo 7: Tipos de Tabela do MySQL

667

determinado pelo nmero de linhas que foram inseridas, atualizadas ou deletadas. Antes u da verso 4.0.5, InnoDB sempre fazia roll back da transao cujo pedido de bloqueio fosse o a ca ultimo a criar o deadlock, isto , um ciclo no grafo de espera da transao. e ca O InnoDB no pode detectar deadlocks onde uma trava atribuida por uma instruo MySQL a ca LOCK TABLES est envolvida ou se uma trava denida em outro mecanismo de banco de a dados diferente de InnoDB est envolvida. Voc tem que resolver estas situaes usando a e co innodb_lock_wait_timeout congurado em my.cnf. Quando o InnoDB realiza um rollback completo de uma transao, todos as travas da ca transao so liberadas. No entanto, se feito o rollback de apenas uma unica instruo ca a e ca SQL como um resultado de um erro, algumas das travass denidas pela instruo podem ca ser preservadas. Isto ocorre porque o InnoDB armazena as travas de registro em um formato onde ele no pode saber qual trava foi denida por qual instruo SQL. a ca

7.5.9.7 Um Exemplo de Como a Leitura Consistente Funciona no InnoDB

Suponha que voc esteja utilizando o n de isolamento padro REPEATABLE READ. Quando e ivel a voc executa uma leitura consistente, isto , uma instruo SELECT comum, o InnoDB dar e e ca a a sua transao um ponto no tempo de acordo com o que a sua consulta viu no banco de ca dados Assim, se a transao B deleta uma linha e faz um commit depois que o ponto no ca tempo foi atribuido, ento voc no ver a linha deletada. Inseres e atualizao so feitos a e a a co ca a de forma parecida. Voc pode avanar o seu ponto no tempo fazendo um commit da transao e fazendo outro e c ca SELECT. Isto chamado controle de concorrncia multi-version. e e User A User B SET AUTOCOMMIT=0; time | | | | v SELECT * FROM t; empty set INSERT INTO t VALUES (1, 2); SELECT * FROM t; empty set COMMIT; SELECT * FROM t; empty set; COMMIT; SELECT * FROM t; --------------------| 1 | 2 | --------------------SET AUTOCOMMIT=0;

668

MySQL Technical Reference for Version 5.0.0-alpha

Assima o usurio A v a linha inserida por B apenas quando B zer um commit da insero a e ca e A tiver feito um commit de sua prpria transao pois assim o ponto no tempo avanado o ca e c para depois do commit de B. Se voc deseja ver o estado mais atual do banco de dados, voc deve utilizar uma trava de e e leitura: SELECT * FROM t LOCK IN SHARE MODE;

7.5.9.8 Como lidar com deadlocks?

Deadlocks so um problema clssico em a a perigosos, a menos que eles sejam to a transaes. Normalmente voc tem que co e pre estejam preparada a reexecutar uma deadlocks. banco de dados transacionais, mas eles no so a a frequentes que voc no possa executar certas e a escrever suas aplicaes de forma que elas semco transao se for feito um roll back por causa de ca

O InnoDB utiliza bloqueio automtico de registro. Voc pode obter deadlocks mesmo no caso a e de transaes que inserem ou deletam uma unica linha. Isto ococrre porque estas operaes co co no so realmente atmicas: elas automaticamente atribuem travas aos (possivelmente a a o muitos) registros se indices da linha inserida/deletada. Voc pode lidar com deadlocks e reduz com os seguintes truques: e i-lo Use SHOW INNODB STATUS em verses do MySQL posteriores a 3.23.52 e 4.0.3 para o determinar a causa do ultimo deadlock. Isto pode lhe ajudar a sintonizar a sua aplicao ca a avitar travas. Sempre estar preparado para reexecutar uma transao se ela falhar em um deadlock. ca Deadlocks no sAo perigosos. Apenas tente de novo. a Commit sua transaes com frequncia. Transaes pequenas tm menos chaces de co e co e colidir. Se voc estiver utilizando as travas de leitura SELECT ... FOR UPDATE ou ... LOCK IN e SHARE MODE, tente usar um n de isolamente mais baixo READ COMMITTED. ivel Accesse as suas tabelas e linha em uma ordem xa. Assim as transaes formaro las co a ordenadas e no entraro em deadlock. a a Adicione indices bem escolhidos a sua tabela. Ento a suas consultas precisaro varrer a a menos registros de indice e consequentemente atribuiro menos locks. Use EXPLAIN a SELECT para fazer o MySQL selecione indices apropriados a sua consulta. Use menos locks: se voc pode utilizar um SELECT para retornar dados de uma copia e de banco de dados antiga, no adicione a clusula FOR UPDATE ou LOCK IN SHARE MODE. a a Usar o n de isolamento READ COMMITTED bom aqui, pois cada leitura consistente ivel e dentro da mesma transao l da sua prpria cpia atual. ca e o o Se nada ajudar, serialize suas transaes com bloqueio de tabela: LOCK TABLES t1 co WRITE, t2 READ, ... ; [faz algo com tabelas t1 e t2 aqui]; UNLOCK TABLES. Bloqueio de tabela faz com que suas transaes se enlerem em ordem e deadlocks co sero evitados. Note que LOCK TABLES inicia implictamente uma transao, assim a ca como o comando BEGIN, e UNLOCK TABLES naliza implicitamente uma transao em ca um COMMIT.

Cap tulo 7: Tipos de Tabela do MySQL

669

Outra soluo para colocar transaes em srie criar uma tabela semforo auxiliar ca co e e a onde exista apenas uma unica linha. Cada transao atualiza esta linha antes de ca acessar outra tabela. Deste modo todas as transaes acontecem em srie. Note que co e o algoritmo de deteco automtico de deadlock do InnoDB tambm funciona pois a ca a e trava de srie uma trava de registro. Na trava de tabela do MySQL ns temos que e e o recorrer ao mtodo do tempo limite para resolver um deadlock. e

7.5.10 Dicas de Ajuste de Desempenho

1. Se o aplicativo top do Unix ou o Gerenciado de Tarefas do Windows mostrar que percentual de uso da CPU com sua carga de trabalho menor que 70%, provavelmente e sua carga de trabalho est no limite do disco. Talvez voc esteja fazendo muitos a e commits de transaes ou a rea de buer muito pequena. Tornar o buer maior co a e pode lhe ajudar, mas no o congure com mais de 80% da memria f a o isica. 2. Envolva diversas modicaes em uma transao. O InnoDB deve descarregar o log co ca em disco a cada commit da transao se esta transao zer modicaes no banco ca ca co de dados. Uma vez que o velocidade de rotao do disco normalmente 167 revca e olues/segundo, o nmero de commits ca limitado aos mesmos 167/segundo se o co u disco no enganar o sistema operacional. a 3. Se voc puder ter perda dos ultimos commits feitos em transaes, voc pode congurar e co e o parmetro innodb_flush_log_at_trx_commit no arquivo my.cnf com 0. O InnoDB a tenta descarregar o log uma vez por segundo de qualquer forma, embora a descarga no seja garantida. a 4. Torne os seus arquivos de log maiores, to grande quanto a rea de buer. Quando o a a InnoDB escrever o arquivo de log totalmente, ele ter que escrever o contedo modicado a u da rea de buer no disco em um ponto de vericao. Arquivos de log menores a ca causaro muitos escrita desnecessrias em disco. O ponto negativo em arquivos grandes a a que o tempo de recuperao ser maior. e ca a 5. O buer de log tambm deve ser grande, cerca de 8 MB. e 6. (Relevante para verso 3.23.39 e acima.) Em algumas verses do Linux e Unix, descara o regar arquivos em disco com o comando fdatasync do Unix e outros mtodos paree cido surpreendentemente lento. O mtodo padro que o InnoDB utiliza a funo e e a e ca fdatasync. Se voc no estiver satisfeito com o desempenho da escrita do banco de e a dados, voc pode tentar congurar innodb_flush_method em my.cnf com O_DSYNC, e embora O_DSYNC parea ser mais lento em alguns sistemas. c 7. Ao importar dados para o InnoDB, esteja certo de que o MySQL no est com a a autocommit=1 ligado. Assim cada insero exige uma descarga de log em disco. ca Coloque antes da linha de importao de arquivo do SQL ca SET AUTOCOMMIT=0; e depois dele COMMIT; Se voc utilizar a opo mysqldump --opt, voc obter arquivos dump que so mais e ca e a a rpidos de importar tambm em uma tabela InnoDB, mesmo sem coloc-los entre SET a e a AUTOCOMMIT=0; ... COMMIT;.

670

MySQL Technical Reference for Version 5.0.0-alpha

8. Tome cincia dos grandes rollbacks de inseres em massa: o InnoDB utiliza o buer de e co insero para economizar E/S de disco em inseres, mas em um rollback corresponca co dente tal mecanismo no usado. Um rollback no limite de disco pode demorar cerca a e de 30 vezes mais que a inssero correspondente. Matar o processa de banco de dados ca no ir ajudar pois o rollback ir reiniciar ao se entrar no banco de dados. O unico a a a modo de se livrar de um rollback deste tipo aumentar a rea de buer de forma que e a o rollback dependa do limite de CPU e seja executado rpidamente ou deltar todo o a banco de dados InnoDB. 9. Tome cincia tambm de outras grandeas operaes com limite de disco. Use DROP e e co TABLE ou TRUNCATE (a partiir do MySQL-4.0) para esvaziar uma tabela, no DELETE a FROM suatabela. 10. Utilize INSERT multi-line para reduzir a sobrecarga de comunicao entre o cliente e o ca servidro se voc precisar inserir muitas linhas: e INSERT INTO suatabela VALUES (1, 2), (5, 5); Esta dica vlida para inseres em qualquer tipo de tabela, no apenas no InnoDB. e a co a

7.5.10.1 SHOW INNODB STATUS e o Monitor InnoDB

A partir da verso 3.23.41, o InnoDB inclui o Monitor InnoDB que imprime informaes a co sobre o estado interno do InnoDB. A partir das verses 3.23.52 e 4.0.3 voc pode usar o o e comando SQL SHOW INNODB STATUS para trazer a sa do Monitor InnoDB padro para ida a o cliente SQL. os dados so uteis para ajuste do desempenho. Se voc estiver usando o a e cliente SQL interativo mysql, a sa mais leg ida e ivel se voc substituir o ponto e v e irgula normalmente usado no nal das instrues por \G: co SHOW INNODB STATUS\G Outro modo de usar os Monitores InnoDB deix-los gravando dados continuamente na sa e a ida padro do servidor mysqld (nota: o cliente MySQL no exibir nada). Ao ser ligado, os a a a Monitores InnoDB exibir dados um vez a cada 15 segundos. Se voc executar mysqld a e normalmente direcionada para o log .err no datadir como um daemon ento esta saida e a do MySQL. Este dado util para ajuste do desempenho. No Windows voc deve iniciar o e e mysqld-max a partir do Prompt do MSDOS com a opo --standalone --console para ca direcionar a sa para a janela do prompt do MS-DOS. ida Existe um innodb_lock_monitor separada que imprime a mesma informao que innodb_ ca monitor mais informaes sobre travas conguradas por cada transao. co ca A informao impressa inclui dados sobre: ca espera de bloqueios de uma transao, ca espera de semforo de threads, a pedido de E/S de arquivos pendentes, estat isticas de rea de buer e a atividade de fuso do buer de insero e remoo da thread principal do InnoDB. a ca ca Voc pode iniciar o Monitor InnoDB com o seguinte comando SQL: e CREATE TABLE innodb_monitor(a INT) type = innodb; e par-lo com a

Cap tulo 7: Tipos de Tabela do MySQL

671

DROP TABLE innodb_monitor; A sintaxe CREATE TABLE s um modo de passar um comando ao mecanismo InnoDB atravs e o e do analisador SQL do MySQL: a tabela criada no relevante para o Monitor InnoDB. Se a e voc fechar o banco de dados quando o manitor estiver em execuo, e voc quiser iniciar e ca e o monitor novamente, voc deve apagar a tabela antes de executar um novo CREATE TABLE e para iniciar o monitor. A sinstaxe pode alterar em distribuio futuras. ca Uma sa padro do Monitor InnoDB: ida a ================================ 010809 18:45:06 INNODB MONITOR OUTPUT ================================ -------------------------LOCKS HELD BY TRANSACTIONS -------------------------LOCK INFO: Number of locks in the record hash table 1294 LOCKS FOR TRANSACTION ID 0 579342744 TABLE LOCK table test/mytable trx id 0 582333343 lock_mode IX RECORD LOCKS space id 0 page no 12758 n bits 104 table test/mytable index PRIMARY trx id 0 582333343 lock_mode X Record lock, heap no 2 PHYSICAL RECORD: n_fields 74; 1-byte offs FALSE; info bits 0 0: len 4; hex 0001a801; asc ;; 1: len 6; hex 000022b5b39f; asc ";; 2: len 7; hex 000002001e03ec; asc ;; 3: len 4; hex 00000001; ... ----------------------------------------------CURRENT SEMAPHORES RESERVED AND SEMAPHORE WAITS ----------------------------------------------SYNC INFO: Sorry, cannot give mutex list info in non-debug version! Sorry, cannot give rw-lock list info in non-debug version! ----------------------------------------------------SYNC ARRAY INFO: reservation count 6041054, signal count 2913432 4a239430 waited for by thread 49627477 op. S-LOCK file NOT KNOWN line 0 Mut ex 0 sp 5530989 r 62038708 sys 2155035; rws 0 8257574 8025336; rwx 0 1121090 1848344 ----------------------------------------------------CURRENT PENDING FILE I/OS -------------------------Pending normal aio reads: Reserved slot, messages 40157658 4a4a40b8 Reserved slot, messages 40157658 4a477e28 ... Reserved slot, messages 40157658 4a4424a8 Reserved slot, messages 40157658 4a39ea38 Total of 36 reserved aio slots

672

MySQL Technical Reference for Version 5.0.0-alpha

Pending aio writes: Total of 0 reserved aio slots Pending insert buffer aio reads: Total of 0 reserved aio slots Pending log writes or reads: Reserved slot, messages 40158c98 40157f98 Total of 1 reserved aio slots Pending synchronous reads or writes: Total of 0 reserved aio slots ----------BUFFER POOL ----------LRU list length 8034 Free list length 0 Flush list length 999 Buffer pool size in pages 8192 Pending reads 39 Pending writes: LRU 0, flush list 0, single page 0 Pages read 31383918, created 51310, written 2985115 ---------------------------END OF INNODB MONITOR OUTPUT ============================ 010809 18:45:22 InnoDB starts purge 010809 18:45:22 InnoDB purged 0 pages Algumas notas sobre a sa ida: Se a seo LOCKS HELD BY TRANSACTIONS relatar espera de bloqueios, ento a ca a sua aplicao pode ter diputa de travas. A saida tambm ajuda a rastrear as razes de ca e o deadlocks nas transaes. co A seo SYNC INFO ir relatar semforos reservados se voc compilar o InnoDB com ca a a e UNIV_SYNC_DEBUG denido em univ.i. A seo SYNC ARRAY INFO relatas as threads que esperam por semforos e esca a tat isticas sobre quantas vezes a thread precisou esperar por um mutex ou por um semforo de trava de leitura/escrita. Um nmero grande de espera da thread pelo a u semforo pode ser um resultado de E/S de disco ou problemas de disputa dentro do a InnoDB. As disoutas pode ser devido a paralelismo pesado de consultas ou problemas na programao das threads no sistema operacional. ca A seo CURRENT PENDING FILE I/OS lista os pedidos de E/S de arquivos que ca esto pendente. Um nmero grande indica que a carga de trabalho esta no limite de a u disco. A seo BUFFER POOL lhe d estat ca a iticas sobre leitura e escrita das pginas. Voc a e pode calcular a partir destes nmeros quanto de E/S em arquivos de dados a sua u consulta esta fazendo atualmente.

Cap tulo 7: Tipos de Tabela do MySQL

673

7.5.11 Implementao de Multi-versioning ca

Como o InnoDB um banco de dados multi-version, ele deve mantar informaes de verses e co o antigas de seus registros na tablespace. Esta informao armazenada na estrutura de dados ca e que chamamos de segmento rollback como uma estrutura de dados anoga no Oracle. Internamente o InnoDB adiciona dois campos a cada linha armazenada no banco de dados. Um campo de 6 bytes diz ao identicador da transao sobrea a ultima transao que ca ca inseriu ou atualizou um registro. Uma deleo tambm tratada internamente como uma ca e e atualizao ande um bit especial denido para indicae a daleo. Cada linha contm ca e ca e tambm um campo de 7 bytes chamado roll pointer. O roll pointer aponta para um registro e log de itens a desfazer escrito no segmento rollback. Se o registro foi atualizado, ento este a registro de log contm a informao necessria para reconstruir o contedo da linha antes e ca a u de ela ter sido atualizada. O InnoDB usa a informao no segmento rollback para realizar o operao de desfazer ca ca necessria em um rollback de uma transao. Ele tambm usa a informao para construir a ca e ca verses mais novas de um registro para uma leitura consistente. o Os logs de itens a desfazer em um segmwnto rollback so divididos en logs de insero e a ca atualizao. Logs de insero s so necessrios em rollback das transaes e podem ser ca ca o a a co discartados assim que se zer o commit das transaes. Logs de atualizao tambm so co ca e a utilizados em leituras consistentes, e eles s podem ser descartados quando no houver mais o a transaes para as quais o InnoDB atribuiu uma cpia do banco de dados que precisasse das co o informaes do log de atualizaes em uma leitura consistente para construir uma verso co co a mais nova do registro do banco de dados. Voc deve se lembrar de fazer commit em suas transaoes regularmente, inclusive aquelas e ca transaes que s fazem leituras consistentes. Seno o InnoDB no pode descartar dados co o a a do log de atualizao e o segmento rollback pode crescer demias, enchendo o seu tablespace. ca O tamanho f isico de um registro log de itens a desfazer em um segmento rollback nore malmente menor que o registro inserido ou atualizado correspondente. Voc pode usar esta e informao para calcular o espao necessrio para o seu segmento rollback. ca c a Neste esquema multi-versioning uma linha no sicamente removida do banco de dados a e imediatamente quando voc a deleta com uma instruo SQL. Apenas quando o InnoDB e ca puder descartar o registro de log de itens a desfazer da atualizao ele pode, tambm, ca e remover sicamente a linha correspondente e seu registros de indices do banco de dados. Esta operao de remoo chamada purge e bem rpida, tendo, normalmente, a mesma ca ca e e a ordem de tempo da instruo SQL que fez a deleo. ca ca

7.5.12 Estrutura de Tabelas e Indices

O MySQL armazena suas informaes de dicionrios de dados de tabelas em arquivos .frm co a no diretrio de banco de dados. Mas todo tabela do tipo InnoDB tambm tem sua prpria o e o entrada no dicionrios de dados interno do InnoDB dentro da tablespace. Quando o MySQL a apaga uma tabela ou um banco de dados, ele tem que deletar o(s) arquivo(s) .frm e a entrada correspondente dentro do dicionrio de dados do InnoDB. Esta a razo pela a e a qual voc no pode mover tabelas InnoDB entre banco de dados simplesmente movendo e a

674

MySQL Technical Reference for Version 5.0.0-alpha

os arquivos .frm e porque DROP DATABASE no funcionava em tabelas do tipo InnoDB em a versOes do MySQL anteriores a 3.23.43. Toda tabela InnoDB tem um indice especial chamado de indice agrupado onde os dados dos registros so armazenados. Se voc denir um chave primaria (PRIMARY KEY) na sua a e tabela, ento o a indice da chave primria ser o a a indice agrupado. Se voc no denir uma chave primria para a sua tabela, o InnoDB ir gerar internamente e a a a um indice agrupado qonde as linhas so ordenadas pela ID da linha que o InnoDB atribui a as linhas nestas tabelas. O ID da linha um campo de 6 bytes que cresce quando novas e linhas so inseridas. Assim as linhas armazenadas pela sua ID estaro sicamente na ordem a a de insero. ca Acessar uma linha pelo indice agrupado rpido porque os dados do registro estaro na e a a mesma pgina que a busca de a indice nos indicar. Em muitos bancos de dados, os dados so armazenados em pgina diferente daquela em que se encontra os registros de a a indices, Se uma tabela grande, a arquitetura do e indice agrupado geralmente economiza E/S de disco se coparado a soluo tradicional. ca O registro em indices no agrupados (tambm os chamamos de a e indices secundrios) em a InnoDB contm o valor da chave primria para a linha. O InnoDB usa este valor de chave e a primria para buscar o registro do a indice agrupado. Note que se a chave primria for grande, a os indices secundrios iro utilizar ainda mais espao. a a c

7.5.12.1 Estrutura F isica do Indice

Todos os indices no InnoDB so rvores-B onde os registros de a a indice so armazenados na a pgina de folhas da rvore, O tamanho padro de uma pgina de indice 16 Kb. Quando a a a a e novos registros so inseridos, InnoDB tenta deixar 1 / 16 de paginas livre para futuras a inseres e atualzaes de registro de co co indices. Se registros de indice so inseridos em ordem sequencial (ascendente ou descendente, os a pginas de indices resultantes estaro cerce de 15/16 completa. Se os registros so inseridos a a a em ordem aleatoria, ento as pginas estaro de 1/2 a 15/16 completos. Se o fator de a a a preenchimento de uma pgina a indice car abaixo de 1/2, o InnoDB tentar contrair o a rvore de indice para liberar a pgina. a a

7.5.12.2 Buer de Insero ca

E uma situao comum em aplicativos de banco de dados que a chave prmria seja um ca a identicador unico e os novos registros so inseridos em ordem crescente de acordo com a a chave primria. Assim a insero nos a ca indices agrupados no exigem leituras aleatorias a a disco. Por outro lado, indices secundrios so normalmente no so unicos e inseres acontea a a a co cem em uma ordem relativamente aleatria nos indices secundrios. Isto causaria diversos o a acessos de E/S aleatrios em disco sem um mecanismo especial usado em InnoDB. o Se um registro de indice deve ser inserido a um indice secundrio que no unico, o InnoDB a a e verica se a pgina de a indice secundrio j est na rea de buer. Se este for o caso, o a a a a InnoDB far a insero diretamente n pgina do a ca a a indice. Mas, se a pgina de a indice no a for encontrada na rea de buer, O InnoDB insere o registro em uma estrutura de buer a

Cap tulo 7: Tipos de Tabela do MySQL

675

de insero especial. O buer de insero mantido to pequeno que ele cabe totalmente ca ca e a na rea de buer e inseres nele podem ser feitas muito rpido. a co a O buer de insero unido periodicamente ` rvore de indices secundrios no banco de ca e aa a dados. Geralmente ns podemos juntar diversas inseres na mesma pgina na rvore o co a a indice o que economiza E/S de disco. Buers de inseres podem aumentar a velocidade co das inseres em uma tabela em cerca de 15 vezes. co

7.5.12.3 Indices Hash Adaptativos

Se um banco de dados couber quase totalmente na memria principal, ento o modo mais o a rpido de realizar consultas nela usar a e indices hash. O InnoDB tem um mecanismo automatico que monitora as buscas em indices feitas nso indices denidos na tabela e, se o InnoDB notar que as consultas podiam ser beneciadas da constru de ca indices hash, tal indice automaticamente construido. e Mas note que um indice hash sempre constru com base em um e ido indice de rvore-B a existente na tabela. O InnoDB pode construir um indice hash em um prexo de qualquer tamanho da chave denida pela rvore-B, dependendo de que padro de busca o InnoDB a a observa em indices de rvore-B. Um a indice hash pode ser parcial: no exigido que todo o a e indice seja armazenado na rea de buer. O InnoDB contruir a a indices hash por demanda naquelas pginas de a indice que so frequentemente acessadas. a Deste forma, Atravs do mecanismo de e indice hash adptativo o InnoDB se adapta a uma memria principal ampla, aporoximando-se da arquitetura dos bancos de dados de memria o o principal.

7.5.12.4 Estrutura dos Registros F isicos

Cada registro de indice no InnoDB contm um cabealho de 6 bytes. O cabealho e c c e usado para ligar registros consecutivos e tambm para bloqueio de regiostros. e Registros em indices agrupados contm capos para todas as colunas denidas denidas e pelo usurio. Adicionalmente, existe um campo de 6 bytes para a ID da transao e a ca um campo de 7 bytes para o roll pointer. Se o usurio no tiver denido uma chave prmiria para uma tabela, ento cada registro a a a a de indice agrupado tambm contm um campo ID de 6 bytes. e e Cada registro de indice secundrio tambm contm todos os campos denidos para a a e e chave de indice agrupado. Um registro tambm contm um ponteiro para cada campo do registro. Se o tamanho e e total dos campos em um registro menor que 128 bytes, ento o ponteiro de 1 byte, e a e seno de 2 bytes. a e

7.5.12.5 Como Funciona uma Coluna AUTO_INCREMENT no InnoDB

Depois que um banco de dados inicia, quando um usurio faz a primeira insero em uma a ca tabela T onde uma coluna auto-increment foi denida, e o usurio no fornece um valor a a explicito para a coluna, ento o InnoDB executa SELECT MAX(auto-inc-column) FROM T, a

676

MySQL Technical Reference for Version 5.0.0-alpha

e atribui aquele valor incrementado de um a coluna e ao contador de auto incremento da tabela. Dizemos que o contador de auto incremento para a tabela T foi inicializado. O InnoDB segue o mesmo procedimento na inicializao do contador de auto incremento ca para uma tabela recem criada. Note que se o usurio especica em uma insero o valor 0 a coluna auto-increment. o a ca InnoDM trata a linha como se o valor no tivesse sido especicado. a Depois do contador de auto incremento tiver sido inicializado, se um usurio insere uma a linha onde especicamos explicitamente o valor da coluna e o valor maior que o valor e atual do contador, ento o contador congurado com o valor especicado. Se o usurio a e a no especicar um valor explicitamente, o InnoDB incrementa a contador de um e atribui a o seu novo valor a coluna. O mecanismo de auto incremento, ao atribuir valor ao contador, desvia de manipuladores de travas e transaes. De outra forma voc tambm pode obter lacuas na sequncia de co e e e nmeros se voc zer um roll back da transao que tiver obtido nmeros do contador. u e ca u O comportamento do auto incremento no denido se um usurio passar um valor negativo a e a a coluna ou se o valor se tornar maior que o valor inteiro mximo que pode ser armazenado a no tipo inteiro especicado.

7.5.13 Gerenciamento do Espao de Arquivos e E/S de Disco c 7.5.13.1 E/S de Disco

Na E/S de disco o InnoDB usa E/S ass incrona. No Windows NT ele usa a E/S ass incrona nativa fornecida pelo sistema operacional. No Unix, o InnoDB usa E/S ass incrona simulada constru dentro do InnoDB: o InnoDB cria um nmero de threads de E/S que cuidam ida u das operaes de E/S, tais como leitura. Em uma verso futura adcionaremos suporte para co a E/S simulada no Windows NT e E/S nativa nas verses de Unix que possuam este recurso. o No Windows NT o InnoDB usa E/S sem buer. Isto signica que as pginas de disco que a o InnoDB l ou escreve no so armazenadas na cache de arquivo do sistema operacional. e a a Isto economiza um pouco da banda de memria. o A partir da verso 3.23.41, o InnoDB usa uma tcnica de descarga de arquivo da novel a e chamado escrita dupla (doublewrite). Ela adiciona segurana a recuperao em falhas c ca depois de uma falha do sistema operacional ou queda de fora e aumenta o desempenho na c maioria dos sistemas Unix, reduzindo a necessidade de operaes fsinc. co Escrita dupla signica que antes do InnoDB escrever pginas em um arquivo de dados, ele a primeiro os escreve em rea de tablespaces cont a inuos chamados de buer de escrita dupla (doublewrite buer). Apenas aps a escrita e a descarga no buer de escrita dupla tiver sido o completada, o InnoDB escreve a pgina em sua posio apropriada na arquivo de dados. Se a ca o sistema operacional falhar no meio da escrita da pgina, o InnoDB ir fazer a recuperao a a ca procurando uma cpia da pgina no buer de escrita dupla. o a A partir da verso 3.23.41 voc tambm pode usar uma partio de disco raw como um a e e ca arquivo de dados, mas insto ainda no foi testado. Quando voc cria um navo arquivo a e de dados voc tem que colocar a palavra chave newraw imediatamente depois do tamanho e

Cap tulo 7: Tipos de Tabela do MySQL

677

do arquivo de dados em innodb_data_file_path. A partio deve ter, pelo menos, o ca tamanho que voc especicou. Note que 1M no InnoDB 1024 x 1024 bytes, enquanto na e e especicao de disco 1 MB normalmente signica 1000 000 bytes. ca innodb_data_file_path=/dev/hdd1:5Gnewraw;/dev/hdd2:2Gnewraw Quando voc reinicia o banco de dados voc deve alterar a palavra chave para raw. Seno e e a o InnoDB escrever sobre a sua partio! a ca innodb_data_file_path=/dev/hdd1:5Graw;/dev/hdd2:2Graw Usando um disco raw voc pode ter E/S sem buer em algumas veses de Unix. e o Quando voc usar parties de disco raw, certique-se de que voc tem permisses que e co e o permitem acesso de leitura e escrita na conta usada para executar o servidor MySQL. Existem duas heur isticas read-ahead no InnoDB: read-ahead sequencial e read-ahead aleatria. Na read-ahead sequencial o InnoDB percebe que o padro de acesso a um o a segmento no tablespace sequencial. ento o InnoDB enviar uma grupo de leitura das e a a paginas do banco de dados para o sistema de E/S. No read-ahead aleatrio o InnoDB o percebe que algumas reas no tablespace parecem estar no processo de serem totalmente a lidas na rea de buer. O InnoDB envia as leituras remanescente para o sistema de E/S. a

7.5.13.2 Gerenciamento do Espao de Arquivo c

Os arquivos de dados denido no arquivo de congurao forma o tablespace do InnoDB. Os ca arquivos so simplesmente concatenado para formar o tablespace, no h nenhuma listagem a a a em uso. Atualmente voc no pode denir onde suas tabelas sero alocadas no tablespace. e a a No entanto, em um tablespace criado recentemente, o InnoDB alocar espao a partir do a c low end O tablespace consiste de pginas de banco de dados cujo tamanho padro 16 KB. As a a e pginas so agrupadas numa extendso de 64 pginas consecutivas. Os arquivos dentro a a a a de um tablespace so chamados segmentos no InnoDB. O Nome do segmento rollback um a e tanto enganador porque na verdade ele contm vrios segmentos no tablespace. e a Para cada indice no InnoDB ns alocamos dois segmentos: um para ns que no so o e o a a folhas da rvore-B e outro para ns de folhas. A idia aqui conseguir melhorar a a e o e e sequencialidade dos ns de folhas, que comtm os dados. o e Quando um segmento cresce dentro da tablespace, o InnoDB aloca as primeiras 32 pginas a para ele, individualmente. Depois disto o InnoDB inicia a alocao de toda a extenso do ca a segmento. O InnoDB pode adicionar a um grande segmento at 4 extenses de uma vez e o para assegurar a boa sequencilidade dos dados. Algumas pginas na tablespace contm bitmaps de outras pginas e dessa forma algumas a e a poucas extenses em um tablespace do InnoDB no podem ser alocadas ao segmento como o a um todo, mas apenas como pginas individuais. a Quando voc executa uma consulta SHOW TABLE STATUS FROM ... LIKE ... para saber soe bre o espao livre dispon no tablespace, o InnoDB ir relatar as extenses que estejam c ivel a o denitivamente livres na tabelspace. O InnoDB sempre reserva algumas extenses para o limpeza e outros propsitios internos; estas extenses reservadas no estao inclu o o a idas no espao livre. c

678

MySQL Technical Reference for Version 5.0.0-alpha

Quando voc deletar dados de uma tabela, o InnoDB contrair o e a indice de rvore-B cora respondente. Ele depende do padro de delees se isto liberar pginas individuais ou exa co a tenses da tablespace, assim que o espao liberado estiver dispon para outros usurios. o c ivel a Apagar a tabela ou deletar todos os registros dela garante a liberao do espao para outca c ros usurios, mas lembre-se que registros deletados s podem ser sicamente removidos em a o uma operao de remoo (purge), depois que no houver mais necessidades de rollback ca ca a em trasaes ou leituras consistentes. co

7.5.13.3 Desfragmentando uma Tabela

Se houver inseres ou delees aleatrias nos co co o indices de uma tabela, os indices podem se tornar fragmentados. Com frangmentao queremos dizer que a ordem f ca isica das pginas a de indice no disco no est prxima a ordem alfabtica dos registros nas pginas, ou que a a o e a existe muitas pginas sem uso no bloco de 64 pginas no qual os a a indices so alocados. a Isto pode aumentar a varredura de indices de voc usar mysqldump periodicamente para e se fazer uma cpiad a tabela em um arquivo texto, apagar a tabela e recarreg-la a partir o a do arquivo texto. Outro modo de se fazer a desfragmentao realizar uma operao alter ca e ca table nula ALTER TABLE nometabela TYPE=InnoDB. Isto faz com que o MySQL reconstrua a tabela. Se as inseres a um co indice so sempre crescentes e os registros s so deletados a partir a o a do m, ento o algoritmo do gerenciamento de espao de arquivo do InnoDB garante que a a c fragmentao nos ca indices no ocorrero. a a

7.5.14 Tratando Erros

O tratamento de erro no InnoDB nem sempre o mesmo que o especicado no padro e a SQL. De acordo com o SQL-99, qualquer erro durante uma instruo SQL deve provocar o ca rollback da instruo. O InnoDB, algumas faz o rollback de apenas parte da instruo, ou ca ca de toda instruo. A seguinte lista especica o tratamento de erro do InnoDB. ca Se voc car sem espao no tablespace voc obter do MySQL o erro Table is full e c e a e o InnoDB far o rollback da instruo. a ca Um deadlock de uma transao ou em caso de se esgotar o tempo de espera em uma ca trava o InnoDB far um rollback de toda a transao. a ca Um erro de chave duplicada faz um rollback da insero deste registro em particular, ca mesmo em instrues como INSERT INTO ... SELECT .... Caso voc no especique co e a a opo IGNORE em sua instruo, provavelmente isto ser diferente e o InnoDB far ca ca a a rollback desta instruo SQL. ca Um erro de registro muito grande faz um rollback da instruo SQL. ca Outros erros so geralmente detectado pela camada de cdigo do MySQL e fazem o a o rollback da instruo correspondente. ca

7.5.15 Restries em Tabelas InnoDB co

Tabelas InnoDB no suportam a indices fulltext.

Cap tulo 7: Tipos de Tabela do MySQL

679

No Windows o InnoDB armazena os nomes de banco de dados e tabelas internamente sempre em letras minsculas. Para mover bancos de dados em um formato binrio do u a Unix para o Windows ou do Windows para o Unix voc deve ter todas os nomes de e tabelas e banco de dados em letras minscula. u Aviso: NAO converta o sistema de tabelas MySQL de MyISAM PARA InnoDB! Isto no suportado; se voc zer isto o MySQL no reiniciar at que voc restaure o a e e a a e e sistema de tabelas antigo de um backup ou os regenere com o script mysql_install_ db. SHOW TABLE STATUS no d estat a a isticas exatas sobre tabelas InnoDB, exceto sobre o tamanho f isico reservado pela tabela. O contador de linha apenas uma estimativa e rude usada na otimizao SQL. ca Se voc tentar criar um e indice unico em um prexo de coluna voc obter um erro. e a CREATE TABLE T (A CHAR(20), B INT, UNIQUE (A(5))) TYPE = InnoDB; Se voc criar um e indice que no seja unico em um prexo de uma coluna, o InnoDB a criar um a indice sobre toda a coluna. INSERT DELAYED no suportado por tabelas InnoDB. a e As operaes LOCK TABLES do MySQL no tem conhecimento dos bloqueios de resistro co a do InnoDBcongurados em instrues SQL completadas: isto signica que voc pode co e conseguir um bloqueio de tabela mesmo se j existir transaes de outros usurios que a co a tiverem bloqueios de registros na mesma tabela. Assim suas operaes sobre a tabela co poder ter que esperar se eles colidirem com essas travas de outros usurios. Tambm a e pode ocorrer um deadlock. No entanto isto no tarz perigo a instegridade da transao, a ca pois o bloqueio de registro denido pelo InnoDB sempre cuidar da integridade. Um a bloqueio de tabela tambm previne que outras transaes adquiram mais bloqueios de e co registros (em um modo de bloqueio conitante) na tabela. Uma tabela no pode ter mais de 1000 colunas. a DELETE FROM TABLE no gera a tabela novamente, mas, ao invs diato, deleta todas as a e linhas, uma a uma, o que no rpido. Em verses futuras do MySQL voc poder a e a o e a usar TRUNCATE que mais rpido. e a O tamanho de pgina padro utilizado no InnoDB 16KB. Recompilando o cdigo a a e o pode se congur-la com 8 KB a 64 KB. O tamanho mximo de um registro menos a a e da metade da pgina de banco de dados nas verses anteriores a 3.23.40 do InnoDB. A a o partir da distribuio fonte da verso 3.23.41 colunas BLOB e TEXT podem ter at 4 ca a e GB e o tamanho total do registro tambm devem ser menores que 4GB. O InnoDB no e a armazena campos cjo tamanho menor que 128 bytes em pginas separadas. Depois e a do InnoDB modicar o registro armazenando campos grandes em pginas separadas, a o tamanho restante da linha deve ser menor que metade da pgina de banco de dados. a O tamanho mximo da chave de 7000 bytes. a e Em alguns sistemas operacionais os arquivos de dados devem ser menores que 2 GB. O tamanho combinado dos arquivos de log devem ser menores que 4GB. O tamanho mximo do tablespace 4 bilhes de pginas de banco de dados. Este a e o a tambm o tamanho mximo da tabela. O tamanho m e e a inimo do tabelspace de 10 e MB. Quando voc reinicia o servidor MySQL, o InnoDB pode reutilizar um valor antigo e para uma coluna AUTO_INCREMENT.

680

MySQL Technical Reference for Version 5.0.0-alpha

Voc no pode denir o primeiro valor de uma coluna AUTO_INCREMENT no InnoDB e a com CREATE TABLE ... AUTO_INCREMENT=... (ou ALTER TABLE ...). Para denir este valor insira uma linha com o valor de menos e delete esta linha.

7.5.16 Histrico de Alteraoes do InnoDB o c 7.5.16.1 MySQL/InnoDB-4.1.1, December 4, 2003

Multiple tablespaces now available for InnoDB. You can store each InnoDB type table and its indexes into a separate .ibd le into a MySQL database directory, into the same directory where the .frm le is stored. The MySQL query cache now works for InnoDB tables also if AUTOCOMMIT=0, or the statements are enclosed inside BEGIN ... COMMIT. Reduced InnoDB memory consumption by a few megabytes if one sets the buer pool size < 8 MB. You can use raw disk partitions also in Windows.

7.5.16.2 MySQL/InnoDB-4.0.16, October 22, 2003

Fixed a bug: in contrary to what was said in the manual, in a locking read InnoDB set two record locks if a unique exact match search condition was used on a multi-column unique key. For a single column unique key it worked right. Fixed a bug: if one used the rename trick #sql... -> rsql... to recover a temporary table, InnoDB asserted in row_mysql_lock_data_dictionary(). There are several outstanding non-critical bugs reported in the MySQL bugs database. Their xing has been delayed, because resources are allocated to the upcoming 4.1.1 release.

7.5.16.3 MySQL/InnoDB-3.23.58, September 15, 2003

Fixed a bug: InnoDB could make the index page directory corrupt in the rst Btree page splits after mysqld startup. A symptom would be an assertion failure in page0page.c, in function page_dir_find_slot(). Fixed a bug: InnoDB could in rare cases return an extraneous row if a rollback, purge, and a SELECT coincided. Fixed a possible hang over the btr0sea.c latch if SELECT was used inside LOCK TABLES. Fixed a bug: if a single DELETE statement rst managed to delete some rows and then failed in a FOREIGN KEY error or a Table is full error, MySQL did not roll back the whole SQL statement as it should.

7.5.16.4 MySQL/InnoDB-4.0.15, September 10, 2003

Fixed a bug: if you updated a row so that the 8000 byte maximum length (without BLOB and TEXT) was exceeded, InnoDB simply removed the record from the clustered

Cap tulo 7: Tipos de Tabela do MySQL

681

index. In a similar insert, InnoDB would leak reserved le space extents, which would only be freed at the next mysqld startup. Fixed a bug: if you used big BLOB values, and your log les were relatively small, InnoDB could in a big BLOB operation temporarily write over the log produced after the latest checkpoint. If InnoDB would crash at that moment, then the crash recovery would fail, because InnoDB would not be able to scan the log even up to the latest checkpoint. Starting from this version, InnoDB tries to ensure the latest checkpoint is young enough. If that is not possible, InnoDB prints a warning to the .err log of MySQL and advises you to make the log les bigger. Fixed a bug: setting innodb_fast_shutdown=0 had no eect. Fixed a bug introduced in 4.0.13: if a CREATE TABLE ended in a comment, that could cause a memory overrun. Fixed a bug: If InnoDB printed Operating system error number .. in a file operation to the .err log in Windows, the error number explanation was wrong. Workaround: look at section 13.2 of http://www.innodb.com/ibman.php about Windows error numbers. Fixed a bug: If you created a column prex PRIMARY KEY like in t(a CHAR(200), PRIMARY KEY (a(10))) on a xed-length CHAR column, InnoDB would crash even in a simple SELECT. CCHECK TABLE would report the table as corrupt, also in the case where the created key was not PRIMARY.

7.5.16.5 MySQL/InnoDB-4.0.14, Junho de 2003

bullet InnoDB now supports the SAVEPOINT and ROLLBACK TO SAVEPOINT SQL statements. See http://www.innodb.com/ibman.php#Savepoints for the syntax. bullet You can now create column prex keys like in CREATE TABLE t (a BLOB, INDEX (a(10))). bullet You can also use O_DIRECT as the innodb_flush_method on the latest versions of Linux and FreeBSD. Beware of possible bugs in those operating systems, though. bullet Fixed the checksum calculation of data pages. Previously most OS le system corruption went unnoticed. Note that if you downgrade from version >= 4.0.14 to an earlier version < 4.0.14 then in the rst startup(s) InnoDB will print warnings: InnoDB: Warning: an inconsistent page in the doublewrite buffer InnoDB: space id 2552202359 page number 8245, 127th page in dblwr buf. but that is not dangerous and can be ignored. bullet Modicado o algor itmo de substituio da rea de buer para que ele tente descarregar ca a as pginas modicados se no houver pginas a serem sustitu a a a idas nos ultimos 10% da lista LRU. Isto pode produzir e/s de disco se a carga de trabalho for uma mistura de leituras e escritas. bullet O algor itmo de descarga do ponto de vericao da rea de buer agora tambm tenta ca a e descarregar vizinhos prximos a pgina no m da lista de ush. Isto pode aumentar o a a velocidade de desligamento do banco de dados e pode tambm aumentar as escritas e em disco se o arquivo de log do InnoDB for muito pequeno comparado ao tamanho da a rea de buer.

682

MySQL Technical Reference for Version 5.0.0-alpha

bullet Na verso 4.0.13 fazemos SHOW INNODB STATUS exibir informaes detalhadas a co sobre o ultimo erro de UNIQUE KEY, mas armazenar esta informao podia deixar o ca REPLACE bem mais lento. No exibimos nem armazenamos mais a informao. a ca bullet Corrigido um erro: SET FOREIGN KEY CHECKS=0 no era replicado apropriadaa mente na replicao do MySQL. A correo provavelmente no ser feita na srie 3.23. ca ca a a e bullet Corrigido um erro: o parmetro innodb max dirty pages pct no levav em conta a a as pginas livres na rea de buer. Isto podia levar a descargas excessivas mesmo a a se houvesse muitas pginas livres na rea de buer. Soluo: SET GLOBAL inna a ca odb max dirty pages pct = 100.

7.5.16.6 MySQL/InnoDB-3.23.57, June 20, 2003

bullet Changed the default value of innodb_flush_log_at_trx_commit from 0 to 1. If you have not specied it explicitly in your my.cnf, and your application runs much slower with this new release, it is because the value 1 causes a log ush to disk at each transaction commit. bullet Fixed a bug: InnoDB forgot to call pthread mutex destroy() when a table was dropped. That could cause memory leakage on FreeBSD and other non-Linux Unixes. bullet Fixed a bug: MySQL could erroneously return Empty set if InnoDB estimated an index range size to 0 records though the range was not empty; MySQL also failed to do the next-key locking in the case of an empty index range. bullet Fixed a bug: GROUP BY and DISTINCT could treat NULL values inequal.

7.5.16.7 MySQL/InnoDB-4.0.13, 20 de Maio de 2003

bullet O InnoDB agora suporta ALTER TABLE DROP FOREIGN KEY. Voc deve usar SHOW CREATE e TABLE para ver a ID de chaves estrangeiras geradas internamente quando quiser apagar uma chave estrangeira. bullet SHOW INNODB STATUS agora esxibe informaes detalhadas do ultimo erro de FOREIGN co KEY e UNIQUE KEY detectados. Se voc no entender porque o InnoDB retorna o erro e a 150 de um CREATE TABLE, voc pode utilizar isto para estudar a razo. e a bullet ANALYZE TABLE agora tambm funciona para tabelas do tipo InnoDB. Ela faz 10 e inseres aleatrias para cada das rvores de co o a indices e atualiza a estimativa da cardinalidade do indice adequadamente. Note que como isto apenas uma estimativa, e repetidas execues de ANALYZE TABLE podem produzir diferentes nmeros. O MySQL co u usa a estimativa de cardinalidade do indice apenas an otimizao de joins. Se alguma ca join no otimizada de modo apropriado, voc pode tentar usar ANALYZE TABLE. a e e bullet A capacidade de commit de grupo do InnoDB agora tambm funciona quando o log e binrio do MySQL est habilitado. Deve haver mais de 2 threads cliente para commit a a de grupo estar ativo. bullet Alterado o valor padro de innodb_flush_log_at_trx_commit de 0 para 1. Se voc a e no tiver especicado-o explicitamente em seu my.cnf, e sua aplicao executar muito a ca mais lentamente nesta nova distribuio porque o valor 1 faz com que seja descarca e regado um log para disco a cada commit de transaes. co

Cap tulo 7: Tipos de Tabela do MySQL

683

bullet Adicionado uma nova varivel global congurvel de sistema do MySQL (innodb_max_ a a dirty_pages_pct). Ela um interio na faixa de 0 - 100. O padro 90. A thread e a e principal no InnoDB tenta descarregar as pginas da rea de buer j que grande parte a a a deste percetual ainda no foi descarregado em nenhum momento. a bullet Se innodb_force_recovery=6, no deixar o InnoDB fazer reparao de pginas cora ca a rompidas baseadas no buer de dupla escrita. bullet O InnoDB agora inica mais rpido porque ele no dene a memria na rea de buer a a o a para zero. bullet Corrigido um erro: a denio FOREIGN KEY do InnoDB era confudida com as palavras ca chaves foreign key dentro dos comentrios do MySQL. a bullet Corrigido um ero: se voc apagasse um tablea para qual havia uma referncia de e e chave estrangeira, e posteriormente criasse a mesma tabela com tipo de colunas no a correspondentes, o InnoDB podia entrar em dict0load.c, na funo dict_load_table. ca bullet Corrigido um erro: GROUP BY e DISTINCT podia tratar valores NULL como diferentes. O MySQL tambm falahva ao fazer o lock da prxima chave no caso de uma faixa de e o indice vazia. bullet Corrigido um erro: no faz COMMIT da transao atual quando uma tabela MyISAM a ca e atualizada; isto tambm faz com que CREATE TABLE no faa commit de uma transao e a c ca InnoDB, mesmo quando o log binrio estiver habilitado. a bullet Corrigido um erro: no permite que ON DELETE SET NULL modique a mesma tabela a onde o delete foi feito; podemos permit porqeu into no pode produzir loops innitos i-lo a em operaes em cascata. co bullet Corrigido um erro: permitir HANDLER PREV e NEXT tambm depois de posicionar o cursor e com uma busca unica na chave primria a bullet Corrigido um erro: se MIN() ou MAX() resultasse em um deadlock ou em esgotamento do tempo de espera do lock, o MySQL no retornava um erro, mas NULL como o valor a da funo. ca bullet Corrigido um erro: o InnoDB esquecia de chamar pthread_mutex_destroy() quando uma tabela era apagada. Isto podia causar perda de memria no FreeBSD e outros o Unix, exceto o Linux.

7.5.16.8 MySQL/InnoDB-4.1.0, 03 de Abril de 2003

O InnoDB agora suporta at 64 GB de memria de rea de buer em um conputador e o a Intel de 32 bits com Windows. Isto poss porque o InnoDB pode utilizar a extenso e ivel a AWE de Windows para endereos de memria sobre o limite de 4 GB de um procesc o sador de 32 bits. Uma nova varivel de inicializao innodb buer pool awe mem mb a ca habilita o AWE e dene o tamanho da rea de buer em megabytes. a Reduz o tamanho do cabealho de buer e tabela bloqueada. O InnoDB utiliza 2% a c menos de memria. o

7.5.16.9 MySQL/InnoDB-3.23.56, 17 de Maro de 2003 c

Corrigido um erro grave na otimizao de consultas do InnoDB: consultas do tipo ca

684

MySQL Technical Reference for Version 5.0.0-alpha

SELECT ... WHERE indice col < x and SELECT ... WHERE indice col > x podiam provocar a varredura da tabela mesmo se a seletividade fosse muito boa. Corrigido um erro potencial quando MySQL chama store lock with TL IGNORE no meio de uma consulta.

7.5.16.10 MySQL/InnoDB-4.0.12, 18 Maro de 2003 c

Nas recuperaes de falhas, agora o InnoDB mostra o progresso em percentual do co rollback de uma transao. ca Corrigido um erro/recurso: se seu aplicativo usa mysql use result(), e usa >= 2 conexes para enviar consultas SQL, ele poderia entrar em deadlock na hash S-latch o adaptativa em btr0sea.c. Agora o mysqld libera a S-latch se ela passar o dado de uma SELECT para o cliente. Corrigido um erro: o MySQL podia, erroneamente, retornar Empty set se o InnoDB estimasse o tamanho da faixa do indice para 0 registro mesmo se o registro no estivesse a vazio; o MySQL tambm falhava para fazer o lock da prxima chave no caso de uma e o faixa de indice vazia.

7.5.16.11 MySQL/InnoDB-4.0.11, 25 de Fevereiro de 2003

Corrigido um erro introduzido na verso 4.0.10: SELECT ... FROM ... ORDER BY a ... DESC podia entrar em loop innito. Um erro proeminente: SET FOREIGN KEY CHECKS=0 no replicado de forma a e apropriada na replicao do MySQL. ca

7.5.16.12 MySQL/InnoDB-4.0.10, 04 de Fevereiro de 2003

Em INSERT INTO t1 SELECT ... FROM t2 WHERE ... anteriormente o MySQL denia um bloqueio de tabela em t2. O bloqueio agora foi removido. Aumentou o tamanho mximo mostardo de SHOW INNODB STATUS para 200 KB. a Corrigido um erro grave na otimizao da consulta do InnoDB: consultas do tipo SEca LECT ... WHERE indice col < x and SELECT ... WHERE indice col > x podia provocar a varredura da tabela mesmo quand a seletividade estivess muito boa. Corrigido um erro: a remoo (purge) podia causar lentido em uma tabela BLOB ca a cuja rvore de a indice de chave primria fosse de altura 1. Sintomas: os semforos a a esperam devido a um tarva X denida em btr free externally stored eld(). Corrigido um erro: usar o comando HANDLER do InnoDB em um tratamento recente de um mysqld com falha em ha innobase::change active index(). Corrigido um erro: se o MySQL estimar uma consulta no meio de uma instruo ca SELECT, o InnoDB ir parar na trava de a idice hash adaptativa em btr0sea.c. Corrigido um erro: O InnoDB podia relatar corrompimento e declara em page dir nd owner slot() se uma busca de indice hash adaptativo coincidiu com uma remoo ou uma insero. ca ca

Cap tulo 7: Tipos de Tabela do MySQL

685

Corrigido um erro: algumas ferramentas de snapshot de sistema de arquivos no Windows 2000 podia provocar uma falha na escrita em arquivo s InnoDB com erro ERROR LOCK VIOLATION. Agora, em escritas s incronas, o InnoDB tenta escrever novamente at 100 vezes em intervalos de 1 segundo. e Corrigido um erro: REPLACE INTO t1 SELECT ... no funciona se t1 tiver uma a coluna com auto incremento. a e Um erro proeminente: SET FOREIGN KEY CHECKS=0 no replicado de forma apropriada em replicaes do MySQL. co

7.5.16.13 MySQL/InnoDB-3.23.55, 24 de Janeiro de 2003

Em INSERT INTO t1 SELECT ... FROM t2 WHERE ... anteriormente o MySQL denia um bloqueio de tabela em t2. O bloqueio agora foi removido. Corrigido um erro: se o tamanho total dos arquivos de log do InnoDB fosse maior que 2GB em um comoputador de 32 bits, o InnoDB escreveria o log em uma posio errada. ca Isto poderia fazer com que a recuperao em caso de falhas e o InnoDB Hot Backup ca falhassem na varredura do log. Corrigido um erro: restaurao do cursos de ca indice poderia, teoricamente, falhar. Consrtado um erro: uma declarao em in btr0sea.c, na funo btr search info update slow ca ca podia, teoriacamente, falhar em uma disputa de 3 threads. Corrigido um erro: a remoo (purge) podia causar lentido em uma tabela BLOB ca a cuja rvore de a indice de chave primria fosse de altura 1. Sintomas: os semforos a a esperam devido a um tarva X denida em btr free externally stored eld(). Corrigido um erro: se o MySQL estimar uma consulta no meio de uma instruo ca SELECT, o InnoDB ir parar na trava de a idice hash adaptativa em btr0sea.c. Corrigido um erro: O InnoDB podia relatar corrompimento e declara em page dir nd owner slot() se uma busca de indice hash adaptativo coincidiu com uma remoo ou uma insero. ca ca Corrigido um erro: algumas ferramentas de snapshot de sistema de arquivos no Windows 2000 podia provocar uma falha na escrita em arquivo s InnoDB com erro ERROR LOCK VIOLATION. Agora, em escritas s incronas, o InnoDB tenta escrever novamente at 100 vezes em intervalos de 1 segundo. e Um erro proeminente: SET FOREIGN KEY CHECKS=0 no replicado de forma a e apropriada em replicaes do MySQL. O conserto aparecer na verso 4.0.11 e provavelco a a mente no ser passada a verso 3.23 a a a Corrigido um erro na funo page cur search with match em pageOcur.c do InnoDB ca que faz com que ele que na mesma pgina indenidamente. Este erro evidentemente a s est presente em tabelas com mais de uma pgina. o a a

7.5.16.14 MySQL/InnoDB-4.0.9, 14 de Janeiro de 2003

Removida a mensagem de aviso: InnoDB: Out of memory in additional memory pool. Corrigido um erro: se o tamanho total dos arquivos de log do InnoDB fosse maior que 2GB em um comoputador de 32 bits, o InnoDB escreveria o log em uma posio errada. ca

686

MySQL Technical Reference for Version 5.0.0-alpha

Isto poderia fazer com que a recuperao em caso de falhas e o InnoDB Hot Backup ca falhassem na varredura do log. Corrigido um erro: restaurao do cursos de ca indice poderia, teoricamente, falhar.

7.5.16.15 MySQL/InnoDB-4.0.8, 07 de Janeiro de 2003

Agora, o InnoDB tambm suporta FOREIGN KEY (...) REFERENCES ...(...) [ON e UPDATE CASCADE | ON UPDATE SET NULL | ON UPDATE RESTRICT | ON UPDATE NO ACTION]. Tabelas e indices agora reservam 4% a menos de espao na tablespace. Tabelas exisc tentes tambm reservam menos espao. Atualizando para 4.0.8 vaoc ver mais espao e c e a c livre em "InnoDB free" em SHOW TABLE STATUS. Corrigido um erro: atualizar a chave primria de um registro gera uma erro de chave a estrangeira em todas as chaves estrangeiras que fazem referncia a chaves secundrias do e a registro a ser atualizado. Alm disso, se uma restrio de referncia de chave estrangeira e ca e s se refere a primeir coluna em um o indice e houver mais colunas neste indice, atualizar a coluna adicional ir gerar um erro de chave estrangeira. a Corrigido um erro: se um indice contm algumas colunas duas vezes e esta coluna e e atualizada, a tabela se tornar corrompida. Agora o InnoDB previne a criao de tais a ca indices. Corrigido um erro: removido mensagens de erros supruos 149 e 150 do arquivo .err e quando um SELECT bloquado provoca um deadlock ou um esgota o tempo limite de espera de um bloqueio. Consrtado um erro: uma declarao em in btr0sea.c, na funo btr search info update slow ca ca podia, teoriacamente, falhar em uma disputa de 3 threads. Corrigido um erro: no poss trocar o n de isolamento da tarnasao de volta a e ivel ivel ca para REPEATABLE READ depouis de den com outro valor. i-lo

7.5.16.16 MySQL/InnoDB-4.0.7, 26 de Dezembro de 2002

O InnoDB na verso 4.0.7 essencialmente o mesmo da in 4.0.6. a e

7.5.16.17 MySQL/InnoDB-4.0.6, 19 de Dezembro de 2002

Uma vez que innodb log arch dir no tm relevncia sob o MySQL, no h necessidade a e a a a de se especic-lo no arquivo my.cnf. a LOAD DATA INFILE em modo AUTOCOMMIT=1 no faz mais commits implicitos a para cada 1MB de log binrio escrito. a Corrigido um erro introduzido na verso 4.0.4: LOCK TABLES ... READ LOCAL no a a deve denir bloqueio de registros ao l-los. Isto provoca deadlocks e esgostamento do e tempo limite de espera das travas do registro no mysqldump. Corrigido dois erros introduzidos na verso 4.0.4: em AUTO INCREMENT, REa PLACE pode fazer com que o contador pode ser deixado como 1. Um deadlock ou esgotamento do tempo limite de espera de travas podem causar o mesmo problema.

Cap tulo 7: Tipos de Tabela do MySQL

687

Corrigido um erro: TRUNCATE em uma tabela temporria causa erro no InnoDB. a Corrigido um erro introduzido na verso 4.0.5: se o log binrio no estivessem ligado, a a a INSERT INTO ... SELECT ... ou CREATE TABLE ... SELECT ... podiam fazer com que o InnoDB pendurasse em um semforo criado em btr0sea.c, line128. Soluo: a ca ligar o log binrio. a Corrigido um erro: na replicao, executar SLAVE STOP no meio de uma transao ca ca multi-instruo podia fazer com que SLAVE START s realizasse parte da transao. ca o ca Um erro parecido podia ocorrer se o slave nalizasse devido a um erro e fosse reiniciado.

7.5.16.18 MySQL/InnoDB-3.23.54, 12 de Dezembro de 2002

Corrigido um erro: a estimativa de alcance do InnoDB exagerava em muito o tamanho de de uma pequna faixa de indice se o caminho ao ponto nal da faixa na rvore de a indice j era um ramo na ra Isto podia causar varreduras de tabela desnecessriaem a iz. a consultas SQL. Corrigido um erro: ORDER BY podia falhar se voc no tiver criado um chave primria e a a para um tabela, mas tiver denido diversos indices nos quais pelo menos um era um indice unico (UNIQUE) com todos as suas colunas declaradas como NOT NULL. Corrigido um erro: um esgotamento do tempo de espera se um lock na conexo com a ON DELETE CASCADE podia causar corrompimento em indices. Corrigido um erro: se um SELECT era feito com uma chave unica a partir de um indice primrio, e a busca correspondesse a um registro marcado para deleo, o InnoDB podia a ca erroneamente retornar o PROXIMO registro. Corrigido um erro introduzido na verso 3.23: LOCK TABLE ... READ LOCAL no a a devia denir lock de registro na leitura das linhas. Isto causava deadlocks e esgotamento do tempo de espera do lock no mysqldump. Corrigido um erro: se um indice continha algumas colunas duas vezes, e aquela coluna est atualizada, a tabela fcava corrompida. De agora em diante o InnoDB previne a a criao de tais ca indices.

7.5.16.19 MySQL/InnoDB-4.0.5, 18 de Novembro de 2002

O InnoDb agora suporta os n iveis READ COMMITTED e and READ UNCOMMITTED de isolmento de transao. O READ COMMITTED emula mais proximamente ca o Oracle e portar aplicaes de Oracle para MySQL se torna mais fcil. co a A resoluo de deadlock agora seletiva: tentamos pegar como vitimas transaes com ca e co menos linhas modicadas ou inseridas. Denies FOREIGN KEY agora est ciente da congurao lower case nome tabelas co a ca no arquivo my.cnf. SHOW CREATE TABLE no exibe o nome do banco de dados para uma denio a ca FOREIGN KEY se a tabela referida est no mesmo banco de dados que a tabela. a O InnoDB faz uma vericao de consistncia para vericar a maioria das pginas de ca e a indices antes de escrev-las no arquivo de dados. e

688

MySQL Technical Reference for Version 5.0.0-alpha

Se voc denir innodb force recovery > 0, o InnoDB tenta saltar para os registros e e pginas com a indices corrompidos fazendo SELECT * FROM tabela. Isto ajuda no dump. O InnoDB agora usa E/S ass incrona e sem buer no Windows 2000 e XP; e apenas E/S sem buer ass incrono por simulao no NT, 95/98/ME. ca Corrigido um erro: a estimativa de alcance do InnoDB exagerava em muito o tamanho de de uma pequna faixa de indice se o caminho ao ponto nal da faixa na rvore de a indice j era um ramo na ra Isto podia causar varreduras de tabela desnecessriaem a iz. a consultas SQL. A correo tambm ser feita na verso 3.23.54. ca e a a Corrigido um erro presente nas verses 3.23.52, 4.0.3, 4.0.4: A inicializao do Inno ca oDB podia levar muito tempo ou at mesmo falhar em alguns computadores Windows e 95/98/ME. Corrigido um erro: o lock AUTO-INC er guardado para o m da transao se ele fosse a ca concedido depois de uma espera de lock. Isto podia causar deadlocks desnecessrios. a Corrigido um erro: se SHOW INNODB STATUS, innodb monitor, ou innodb lock monitor tiver exibido centenas de transaes em um relatrio, e a sa co o ida car truncada, o InnoDB travaria, imprimindo no log de erros muitas esperas por um mutex criado em srv0srv.c, line 1621. Corrigido um erro: SHOW INNODB STATUS no Unix sempre relata o tamanho mdio e dos arquivos lidos como 0 bytes. Corrigido um erro potencial na verso 4.0.4: o InnoDB agora faz ORDER BY ... DESC a como o MyISAM. Corrigido um erro: DROP TABLE podia causar falhas ou um travamento se houvesse um rollback executando concorrentemente na tabela. A correo ser feita na srie 3.23 ca a e se este for um problema para os usurios. a Corrigido um erro: ORDER BY podia falhar se voc no tivesse criado um chave e a primria para uma tabela, mas tivesse denido diversos a indices nos quais pelo menos um seja um indice unico (UNIQUE) com todas as suas colunas declaradas como NOT NULL. Corrigido um erro: um espera pelo tempo limite na conexo com ON DELETE CASa CADE podia causar corrompimento nos indices. Corrigido um erro: se um SELECT era feito com uma chave unica a partir de um indice primrio e a busca correspondesse a um registro marcado para deleo, o InnoDB podia a ca retornar o prximo registro. o Outstanding bugs: na verso 4.0.4 dois erros foram introduzidos no a AUTO INCREMENT. REPLACE pode fazer com que o contador seja decrementado. Um deadlock ou uma espera de tempo limite de lock pode causar o mesmo problema. Eles sero corrigidos na versao 4.0.6. a

7.5.16.20 MySQL/InnoDB-3.23.53, 09 de Outubro de 2002

Usamos novamente E/S de disco sem buer para arquivos de dados no Windows. A performance de leitura do Windows XP e Windows 2000 parecem estar muito fraca com E/S normal.

Cap tulo 7: Tipos de Tabela do MySQL

689

Ajustamos a estimativa de faixa para uqe varreduras de indices na faixa tenham preferncia sobre a varredura completa de e indices. Permitir a remoo e criao de tableas mesmo se o innodb force recovery est conguca ca a rado. Pode se usar isto para remover uma tabela que causaria uma falha no rollback ou deleo, ou se uma importao de tabelas com falhas causa um rollback na recuperao. ca ca ca Corrigido um erro presente nas verses 3.23.52, 4.0.3, 4.0.4: A inicializao do InnoDB o ca podia demorar ou mesmo travar em alguns computadores Windows 95/98/ME. Corrigido um ero: a nalizao rpida (que padro), algumas vezes cava lenta pela ca a e a unio do buer de remoo e insero. a ca ca Corrigido um erro: fazer um grande SELECT de uma tabela onde nenhum registro estava vis em uma leitura consistente podia causar uma espera de semforo muito ivel a longo (> 600 segundos) em btr0cur.c line 310. Corrigido um erro: o lock AUTO-INC era guarda para o m da transao se fosse ca concedido depois de uma espera de lock. Isto podia causar um deadlock desnecessrio. a Corrigido um erro: se voc criar uma tabela temporria dentro de LOCK TABLES, e e a usar esta tabela temporria, causar um falha de declarao em ha innobase.cc. a a ca Corrigido um erro: se SHOW INNODB STATUS, innodb monitor, ou innodb lock monitor tiver exibido centenas de transaes em um relatrio, e a sa co o ida car truncada, o InnoDB travaria, imprimindo no log de erros muitas esperas por um mutex criado em srv0srv.c, line 1621. Corrigido um erro: SHOW INNODB STATUS no Unix sempre relata o tamanho mdio e dos arquivos lidos como 0 bytes.

7.5.16.21 MySQL/InnoDB-4.0.4, 02 de Outubro de 2002

Usamos novamente E/S de disco sem buer para arquivos de dados no Windows. A performance de leitura do Windows XP e Windows 2000 parecem estar muito fraca com E/S normal. Aumentado o tamanho mximo da chave de tabelas InnoDB de 500 para 1024 bytes. a Aumentado o campo de comentrio da tabela em SHOW TABLE STATUS a assim at a e 16000 caracteres da denio de chaves estrangeiras pode ser exibidas aqui. ca O contador de auto incremento no mais incrementado de um insero de uma linha a e ca falhar imediatamente. Permitir a remoo e criao de tableas mesmo se o innodb force recovery est conguca ca a rado. Pode se usar isto para remover uma tabela que causaria uma falha no rollback ou deleo, ou se uma importao de tabelas com falhas causa um rollback na recuperao. ca ca ca Corrigido um erro: Usar ORDER BY primarykey DESC na verso 4.0.3 causa um falha a de declarao em btr0pcur.c, line 203. ca Corrigido um ero: a nalizao rpida (que padro), algumas vezes cava lenta pela ca a e a unio do buer de remoo e insero. a ca ca Corrigido um erro: fazer um grande SELECT de uma tabela onde nenhum registro estava vis em uma leitura consistente podia causar uma espera de semforo muito ivel a longo (> 600 segundos) em btr0cur.c line 310.

690

MySQL Technical Reference for Version 5.0.0-alpha

Corrigido um erro: se a cache de consultas do MySQL foi usada, ela no ca invalidada a por uma modicao feita por ON DELETE CASCADE ou ...SET NULL. ca Corrigido um erro: se voc criar uma tabela temporria dentro de LOCK TABLES, e e a usar esta tabela temporria, causar um falha de declarao em ha innobase.cc. a a ca Corrigido um erro: se voc denisse innodb ush log at trx commit com 1, SHOW e VARIABLES mostraria seu valor como 16 milhes. o

7.5.16.22 MySQL/InnoDB-4.0.3, 28 de Agosto de 2002

Removido um deadlock desnecessrio quando a insero precisa esperar por um lock a ca de leitura, atualizao ou deleo para liberar o lock da prxima chave. ca ca o O comando SQL HANDLER do MySQL agora tambm funciona para os tipos de tabela e InnoDB. O InnoDB faz o HANDLER sempre ler como leitura consistente. HANDLER um e caminho de acesso direto a leitura de indices individuais das tabelas. Em alguns casos HANDLER pode ser usado como um substituto de cursores do lado do servidor. Corrigido um erro na verso 4.0.2: mesmo uma unica insero podia causar um falha a ca na verso AIX. a Corrigido um erro: se voc usar em um nome de tabela caracteres cujo cdigo > 127, e o e em DROP TABLE o InnoDB podia falhar na linha 155 de pars0sym.c. A compilao do fonte agora fornece um verso funcional, ambas em HP-UX-11 e HPca a UX-10.20. A fonte da verso 4.0.2 funciona apenas na verso 11, e a fonte do 3.23.52 a a apenas na 10.20. Corrigido um erro: se compilado em um Solaris 64-bits, o InnoDB produz um erro de bus na inicializao. ca

7.5.16.23 MySQL/InnoDB-3.23.52, 16 de Agosto de 2002

O conjunto de recursos da verso 3.23 ser congelada a partir desta verso. Novos a a a recursos iro para o branch da verso 4.0, e apenas erros corrigidos sero feitos para o a a a branch da verso 3.23. a Muitas consultas joins no limite da CPU agora so executadas mais rpido. No Wina a dows tambm muitas outras consultas no limite da CPU executar mais rpido. e a do Monitor Inn Um novo comando SQL, SHOW INNODB STATUS retorna a saida oDB para o cliente. O Monitor InnoDB agora exibe informaes detalhadas no ultimo co deadlock detectado. O InnoDB faz o otimizador de consultas SQL evitar muito mais varreduras apenas na faixa de indice e escolhe a varredura de toda a tabela. Agora isto est corrigido. a "BEGIN" e "COMMIT" esto agora adicionados no log binrio das transaes A a a co replicao do MySQL agora respeita as bordas da transao: um usurio no ver ca ca a a a mais meia transaes na replicao dos slaves. co ca Um slave de replicao agora exibe na recuperao de falhas o ultima posio do log ca ca ca binrio do master que ele podia recuperar. a Uma nova congurao innodb ush log at trx commit=2 faz o InnoDB gravar o log ca para uma cache de arquivo do sistema operacional a cada commit. Isto quase e

Cap tulo 7: Tipos de Tabela do MySQL

691

to rpido quanto congurar innodb ush log at trx commit=0, e congurar com 2 a a tambm tem o recurso no qual em uma falha onde o sistema operacional no teve probe a lemas, nenhuma transao cujo commit foi realizado perdida. Se osistema operacional ca e falhar ou houver um queda de fora,ento a congurar com 2 no mais segura que c a a e congurar com 0. Adicionado campos de checksum ao bloqueio de log. SET FOREIGN KEY CHECKS=0 ajuda na importao de tabelas numa ordem arca bitrria que no respeita as regras de chaves estrangeiras. a a SET UNIQUE CHECKS=0 aumenta a velocidade da importao das tabelas dentro ca do InnoDB se voc tiver restries de chave unica em e co indices secundrios. a SHOW TABLE STATUS agora tambm lista poss e iveis ON DELETE CASCADE ou ON DELETE SET NULL no campo de comentrio da tabela. a Quando CHECK TABLE est executando em qualquer tipo de tabela InnoDB, ela a agora verica tambm o indice hash adaptativo para todas as tabelas. e Se voc deniu ON DELETE CASCADE ou SET NULL e atualizou o chave referencie ada no registro pai, o InnoDB deletava ou atualizava o registro lho. Isto est alterado a conforme o SQL-92: voc recebe o erro Cannot delete parent row. e Melhorado o algoritmo de auto incremento: agora o primeiro inserte ou SHOW TABLE STATUS inicializa o contador de auto incremento para a tabela. Isto remove quase todos os deadlocks causados pelo SHOW TABLE STATUS. Alinhado alguns buers usados na leitura e escrita dos arquivos de dados. Isto permite usar dispositivos raw sem buer como arquivos de dados no Linux. Corrigido um erro: se voc atualizasse a chave primria de uma tabela, podia ocorrer e a uma falha de declarao em page0page.ic line 515. ca Corrigido um erro: se voc deleta ou atualiza um registro referenciado em uma restrio e ca de chave estrangeira e a vericao de chave estrangeira esperapor um lock, ento ca a a vericao pode relatar um resultado errneo. Isto tambm afeta a operao ON ca o e ca DELETE... Corrigido um erro: Um deadlock ou um erro de tempo esgotado na espera do lock no InnoDB causa um rollback de toda a transao, mas o MySQL ainda podia gravar as ca instrues SQL no log binrio, embora o InnoDB faa um rollback delas. Isto podia, co a c por exemplo, fazer a replicao do banco de dados car fora de sincronia. ca Corrigido um erro: se o banco de dados falha no meio de um commit, ento a recua perao pode perder pginas de tablespace. ca a Corrigido um erro: se voc especicar um conjunto de caracteres no my.cnf, ento, ao e a contrrio do que est no manual, em uma restrio de chave estrangeira uma coluna do a a ca tipo string tinha que ter o mesmo tamanho na tabela que faz a referncia e na tabela e referenciada. Corrigido um erro: DROP TABLE ou DROP DATABASE podiam falhar se houvesse um CREATE TABLE executando simultaneamente. Corrigido um erro: se voc congurasse a rea de buer com mais de 2GB em um e a computador de 32 bits, o InnoDB falharia no buf0buf.ic linha 214.

692

MySQL Technical Reference for Version 5.0.0-alpha

Corrigido um erro: Em cmputadores de 64 bits,atualizando registros que contenham SQL NULL em algumas colunas faziam o undo log e o ordinary log se tornavam corrupto. Corrigido um erro: innodb log monitor causava um travamento se ele suprimisse a exibio de locks para uma pgina. ca a Corrigido um erro: na verso HP-UX-10.20, mutexes perderiam memria e causariam a o condies de corrida e falhariam em alguma parte do cdigo do InnoDB. co o Corrigido um erro: se voc rodou em modo AUTOCOMMIT, executou um SELECT, e e imeditamente depois um RENAME TABLE, ento RENAME falharia e o MySQL a reclamaria com o erro 192. Corrigido um erro: se compilado no Solaris 64 bits, o InnoDB produiria um erro de bus na inicializao. ca

7.5.16.24 MySQL/InnoDB-4.0.2, 10 de Julho de 2002

InnoDB is essentially the same as InnoDB-3.23.51. If no innodb data le path is specied, InnoDB at the database creation now creates a 10 MB auto-extending data le ibdata1 to the datadir of MySQL. In 4.0.1 the le was 64 MB and not auto-extending.

7.5.16.25 MySQL/InnoDB-3.23.51, 12 de Junho de 2002

Corrigido um erro: uma join podia resultar em um segmentation faut ao copiar de uma coluna BLOB para TEXT se alguma das colunas BLOB ou TEXT na tabela continham um valor NULL do SQL. Corrigido um erro: se voc adicionasse restries de chaves estrangeiras auto referenciais e co com ON DELETE CASCADE a tabelas e uma deleo de registro fazia o InnoDB tentar ca deletar o mesmo registro duas vezes devido a deleo em cascata e ento voc obtinha ca a e um falha de declarao. ca Corrigido um erro: se voc usar o lock de usurio do MySQL e fechasse uma conexo, e a a ento o InnoDB podia falhar em ha innobase.cc, line 302. a

7.5.16.26 MySQL/InnoDB-3.23.50, 23 de Abril de 2002

O InnoDB agora suporta uma auto extenso do ultimo arquivo de dados. Voc no a e a precisa prealocar todos os arquivos de dados na inicializao do banco de dados. ca Faz diversas alteraes para facilitar o uso da ferramenta Hot Backup do InnoDB. Esta co uma ferramenta separada paga que voc pode usar para tirar backus online do seu e e banco de dados se desligar o servidor ou congurar qualquer lock. Se voc quiser executar a ferramenta Hot Backup do InnoDB em um arquivo de dados e auto extendido voc ter que atualiz-lo para a verso ibbackup-0.35. e a a a A fase de varredura do log na recuperao de falhas agora executar muito mais rpido. ca a a A partir desta verso do servidor, a ferramenta de hot backup trunca os ns dos arquivos a de dados do backup do InnoDB inutilizados.

Cap tulo 7: Tipos de Tabela do MySQL

693

Para permitir que a ferramenta de hot backp funcione, no Windows no usaremos mais a E/S sem buer ou E/S ass incrona nativa; usaremos a mesma assincronia simulada como no Unix. Agora voc pode denir as clusulas ON DELETE CASCADE ou ON DELETE SET e a NULL em caves estrangeiras. Restries de chaves estrangeiras agora sobrevivem a ALTER TABLE e e CREATE co INDEX. Suprimimos a vericao de FOREIGN KEY se qualquer um dos valores de coluna na ca chave estrangeira ou chave referenciada a ser vericada SQL NULL. Isto compat e e ivel com Oracle, por exemplo. SHOW CREATE TABLE agora tambm lista todas as restries de chaves estrangeiras. e co O mysqdump tambm no esquece mais sobre sobre chaves estrangeiras na deniode e a ca tabelas. Agora voc pode adicionar uma nova restrio de chave estrangeira com ALTER TAe ca BLE ... ADD CONSTRAINT FOREIGN KEY (...) REFERENCES ... (...). As denies de FOREIGN KEY agora permitem nomes de tabela e colunas entre co aspas invertidas. O comando MySQL SET TRANSACTION ISOLATION LEVEL ... agora tem o seguinte efeito em tabelas InnoDB: se uma transao denida como SERIALIZABLE ca e ento o InnoDB conceitualmente adiciona LOCK IN SHARE MODE para todas as a leituras consistentes. Se uma transao denida com qualquer outro n de isolao, ca e ivel ca ento o InnoDB obedece sua estratgia de lock padro que REPEATABLE READ. a e a e SHOW TABLE STATUS no conguram mais um x-lock no m de um a indice auto incremento se um contador auto incremento j tiver sido inicializado. Isto remove a quase todos os casos de deadlock causados por SHOW TABLE STATUS. Corrigido em erro: em uma instruo CREATE TABLE statement a string foreign ca seguida por caracter que no seja de espao confuder o analizador do FOREIGN KEY a c e faz a criao de tabelas falhar com nmero de erro 150. ca u

7.5.16.27 MySQL/InnoDB-3.23.49, 17 de Fevereiro de 2002

Corrigido um erro: se voc chamasse DROP DATABASE para um banco de dados no e qual haviam consultas executando simultaneamente, o MySQL podia falhar ou travar. A falha foi corrigida, mas uma correo completa ter que esperar por alguas mudanas ca a c na camada de cdigo do MySQL. o Corrigido um erro: no Windows deve se colocar o nome do banco de dados em minsculo u para DROP DATABASE funcionar. Corrigido na verso 3.23.49: o caso no mais a a e problema no Windows. No Unix o nome de banco de dadospermanece caso sensitivo. Corrigido um erro: se se denisse um conjunto de caracteres diferente de latin1 como o conjunto de caracteres padro, ento a denio das restries de chaves estrangeiras a a ca co podiam falhar em uma declarao em dict0crea.c, relatando um erro interno 17. ca

7.5.16.28 MySQL/InnoDB-3.23.48, 09 de Fevereiro de 2002

Ajustado o otimizador SQL para favorecer busca de indices sobre a varredura de tabelas

694

MySQL Technical Reference for Version 5.0.0-alpha

com mais frequencia. Corrigido um problema de performance quando diversas consultas SELECT grandes esto executando concorrentemente em um computados Linux multiprocessador. a Grandes consultas SELECT no limite da CPU tambe sero executadas mais rap a ido em todas as plataformas de uma maneira geral. Se olog binrio do MySQL usado, o InnoD agora exibe, aps a recuperao de falhas, a e o ca o nome do ultimo arquivo de log binrio do MySQL e a posio neste arquivo (=byte a ca oset) que o InnoDB pode recuperar. Isto util, por exemplo, quando sincronizar um e banco de dados master e um slave na replicao novamente. ca Adicionado uma mensagem de erro melhor para ajudar nos problemas de instalao. ca Pode-se agora recuperar tambm tabelas temporrias do MySQL que se tronaram rfo e a o a dentro do tablespace do InnoDB. O InnoDB agora previne que uma declarao FOREIGN KEY onde o sinal no o ca a e mesmo nas colunas inteiras de referncia e referenciada. e Corrigido um erro: chamar SHOW CREATE TABLE ou SHOW TABLE STATUS poderia causar corrompimento de memria e fazer o mysqld falhar. O mysqldump, o especialmente, corria este risco, j que ele chamava SHOW CREATE TABLE com a frequencia. Corrigido um erro: se no Unix voc fazia um ALTER TABLE em uma tabela e, sie multaneamente, executava consultas nela, o mysqld podia falhar em uma declarao ca no row0row.c, linha 474. Corrigido um erro: se inserir diversas tabelas contendo uma coluna auto incremento estava envolvida dentro do LOCK TABLES, o InnoDB falhava em lock0lock.c. A verso 3.23.47 permitia diversos NULLS em um a indice secundrio UNIQUE. Mas a CHECK TABLE no era relaxed: ele rporta atabela como corrompida. CHECK TAa BLE no reclama mais nesta situao. a ca Corrigido um erro: no Sparc e outros processadores high-endian, SHOW VARIABLES exibia innodb ush log at trx commit e outros parmetros de inicializao booleanos a ca sempre como OFF mesmo se eles estivessem habiliados. Corrigido um erro: se voc executava mysqld-max-nt como um servio no Windows e c NT/2000, a nalizao do servio noesperava o suciente que o desligamento do Innca c a oDb nalizasse.

7.5.16.29 MySQL/InnoDB-3.23.47, 28 de Dezembro de 2001

A recuperao agora mais rpida, especialmente em um sistema de carga leve, pois a ca e a vericao do background tem sido feita com mais frequencia. ca O InnoDB permite agora diversos valores de chaves parecidas em um indice secundrio a UNIQUE se aqueles valores contm NULLs do SQL. Assim a conveno agora a e ca e mesma das tabelas MyISAM. O InnoDB traz uma melhor estimativa de contagem de linhas de uma tabela contendo BLOBs. Em uma restrio FOREIGN KEY, o InnoDB agora caso insensitivo para nomes de ca e colunas e no Windows para nome de tabelas tambm. e

Cap tulo 7: Tipos de Tabela do MySQL

695

O InnoDB permite uma coluna FOREIGN KEY do tipo CHAR se referir a uma coluna do tipo VARCHAR e vice versa. O MySQL silenciosamente troca os tipos de algumas colunas entre CHAR e VARCHAR e estas alteraes silenciosas no seguem declaraes co a co de FOREIGN KEY mais. A recuperao era mais sucept ao corrompimento de arquivos de log. ca ivel Clculo de estat a isticas desnecessrias forma removidas das consultas que geravam um a tabea temporria. Algumas consultas ORDER BY e DISTINCT executaro muito a a mais rpido agora. a O MySQL agora sabe que a varredura de uma tabela InnoDB feita atravs de uma e e chave primria. Isto economizar uma ordenao em algumas consultas ORDER BY. a a ca O tamanho mximo da chave de tabelas InnoDB est restrita novamente a 500 bytes. a a O interpretador do MySQL no pode tratar chaves longas. a O valor padro de innodb lock wait timeout foi alterado de innito para 50 segundos, a e o valor padro de innodb le io threads de 9 para 4. a

7.5.16.30 MySQL/InnoDB-4.0.1, 23 de Dezembro de 2001

O InnoDB o mesmo da verso 3.23.47. e a Na verso 4.0.0 o interpretador do MySQL no conhece a sintaxe de LOCK IN SHARE a a MODE. Isto foi corrigido. Na verso 4.0.0 delees multi-tabelas no funcionavam para tabelas transacinais, Isto a co a foi corrigido.

7.5.16.31 MySQL/InnoDB-3.23.46, 30 de Novembro de 2001

E o mesmo da verso 3.23.45. a

7.5.16.32 MySQL/InnoDB-3.23.45, 23 de Novembro de 2001

Esta uma distribuio para correo de erros. e ca ca Nas verses 3.23.42-.44, ao criar uma tabela no Windows voc tinha que usar letras o e minsculas nos nomes de bancos de dados para poder acessara tabela. Corrigido na u verso 3.23.45. a O InnoDB agora descarrega stdout e stderr a cada 10 segundos; se eles estiverem redirecionados para arquivos, o contedo do arquivo pode ser melhor vizualizado com u um editor. Corrigida um falha em .44, in trx0trx.c, linha 178 quando voc removia uma tabela e cujo o arquivo .frm no existia dentro do InnoDB. a Corrigido um erro no buer de insero. A rvore do buer de insero podia entrar em ca a ca um estado de inconsistncia, causando uma falha, e tambm falhara recuperao, Este e e ca erro podia aparecer, especialmente, em importao de grandes tabelas ou alteraes. ca co Corrigido um erro na recuperao: o InnoDB podia entrar em loop innito constanteca mente exibindo uma mensagem de aviso de que ele no podia encontrar blocos livres a na rea de buer. a

696

MySQL Technical Reference for Version 5.0.0-alpha

Corrigido um erro: quando voc criava uma tabela temporria de um tipo InnoDB e e a ento usava ALTER TABLE para ela,o servidor MySQL podia falhar. a Previnia a criao das tabeas do sistema do MySQL, mysql.user, mysql.host, ou ca mysql.db, no tipo InnoDB. Corrigido um erro que podia causar um falha de declarao na verso 3.23.44 em ca a srv0srv.c, linha 1728.

7.5.16.33 MySQL/InnoDB-3.23.44, 02 de Novembro de 2001

Voc pode denir restries de chaves estrangeiras em tabelas InnoDB. Um exemplo: e co FOREIGN KEY (col1) REFERENCES table2(col2). Voc pode criar arquivos de dados > 4 GB naqueles sistems de arquivos que permitem e isto. Melhorado os monitores do InnoDB, incluindo um novo innodb table monitor que permite que voc mostre o contedo do dicionrio de dados interno do InnoDB. e u a DROP DATABASE funcionar tambm com tabelas InnoDB. a e Caracteres de acento no conjunto de caracteres padro latin1 sero ordenados de acordo a a com com a ordenao do MySQL. NOTA: se voc est usando o latin1 e inseriu caracca e a teres cujo cdigo > 127 em uma coluna CHAR indexada, voc deve executar CHECK o e e TABLE em sua tabela quando atualizar para a verso 3.23.43, e remover e reimportar a a tabela se CHECK TABLE relatar um erro. reports an error! O InnoDB calcular melhor a estmativa da cardinlidade da tabela. a Alterao na resoluo do deadlock: na verso 3.23.43 um deadlock fazia rolls back ca ca a apenas nas instrues SQL, 3.23.44 faz o rollback de toda a transao. co ca Deadlock, esgotamento do tempo de espera do lock e violao das restries de chave ca co estrangeiras (sem registro pais e registros lhos existentes) agora retorna cdigos de o erro nativos do MySQL 1213, 1205, 1216, 1217, respectivamente. Um novo parmetro do my.cnf (innodb thread concurrency) ajuda no ajuste de pera formance em ambientes de alta concorrncia. e Uma nova opo do my.cnf (innodb force recovery) lhe ajuda no dump de tabelas de ca um banco de dados corrompidos. Uma nova opo do my.cnf (innodb fast shutdown) aumentar a velocidade do desligaca a mento. Normalmente o InnoDB faz uma unio total dos buers de insero e remoo a ca ca na nalizao. ca Aumentado o tamanho mximo da chave para 7000 bytes de um tamanho anterior de a 500 bytes. Corrigido um erro na replicao de colunas auto-incremento com insero de multiplas ca ca linhas. Corrigido um erro quando o caso das letras alteram em uma atualizao de uma coluna ca de indice secundrio. a Corrigido uma trava quando havia > 24 arquivos de dados. Corrigido uma falha quando MAX(col) selecionado de uma tabela vazia, e col uma e e coluna diferente da primeira em um indice multi-colunas. Corrigido um erro na remoo que podia causar falhas. ca

Cap tulo 7: Tipos de Tabela do MySQL

697

7.5.16.34 MySQL/InnoDB-3.23.43, 04 de Outubro de 2001

Ele essencialmente o mesmo que o InnoDB-3.23.42. e

7.5.16.35 MySQL/InnoDB-3.23.42, 09 de Setembro de 2001

Corrigido um erro que corrompia a tabela se a chave primria de um registro com mais a de 8000-byte fosse atualizado. Existem 3 tipos de InnoDB Monitors: innodb monitor, innodb lock monitor, and innodb tablespace monitor. Agora o innodb monitor tambm mostra a taxa de acerto da e a rea de buer e o total de registros inseridos, atualizados, deletados e lidos. Corrigido um erro em RENAME TABLE. Arruamdo um erro em replicao com uma coluna auto-incremento. ca

7.5.16.36 MySQL/InnoDB-3.23.41, 13 de Agosto de 2001

Suporte para < 4 GB de registros. O limite anterior era de 8000 bytes. Usa o mtodo de descarga do arquivo de dupla escrita. e Parties de disco raw suportadas como arquivos de dados. co InnoDB Monitor. Diversos erros corrigidos um erro em ORDER BY (Sort aborted) arrumado.

7.5.16.37 MySQL/InnoDB-3.23.40, 16 de Julho de 2001

Apenas alguns erros raros foram concertados

7.5.16.38 MySQL/InnoDB-3.23.39, 13 de Junho de 2001

Agora CHECK TABLE funciona em tabelas InnoDB. Um novo parmetro innodb_unix_file_flush_method em my.cnf introduzido. Ele a e pode ser usado para sintonizar o desempenho da escrita em disco. Uma coluna auto-increment agora obtem novos valores antes do mecanimo de transao. ca Isto economiza tempo de CPU e elimina deadlocks em transaes em atribuies de co co novos valores. Diversos erros arrumados, o mais importante o erro de rollback na 3.23.38. e

7.5.16.39 MySQL/InnoDB-3.23.38, 12 de Maio de 2001

A nova sintaxe SELECT ... LOCK IN SHARE MODE introduzida. e O InnoDB agora chama fsync depois de cada escrita em disco e clacula um checksum para todas as pginas do banco de dados que ele escreve ou l, revelando defeitos e a e disco. Diversos erros arrumados.

698

MySQL Technical Reference for Version 5.0.0-alpha

7.5.17 Informaes de Contato do InnoDB co

Informes para contato do Innobase Oy, produtor do mecanismo InnoDB. co http://www.innodb.com/. E-mail: sales@innodb.com phone: 358-9-6969 3250 (office) 358-40-5617367 (mobile) Innobase Oy Inc. World Trade Center Helsinki Aleksanterinkatu 17 P.O.Box 800 00101 Helsinki Finland Web site:

7.6 Tabelas BDB ou BerkeleyDB

7.6.1 Viso Geral de Tabelas BDB a
BerkeleyDB, dispon em http://www.sleepycat.com/ tem provido o MySQL com um ivel mecanismo de armazenamento transacional. O suporte para este mecanismo de armazenamento est inclu na distribuio fonte do MySQL a partir da verso 3.23.34 e est ativo a ido ca a a no binrio do MySQL-Max. Este mecanismo de armazenamento chamado normalmente a e de BDB. Tabelas BDB podem ter maior chance de sobrevivncia a falhas e tambm so capazes de e e a realizar operaes COMMIT e ROLLBACK em transaes. A distribuio fonte do MySQL vem co co ca com uma distribuio BDB que possui alguns pequenos patchs para faze-lo funcionar mais ca suavemente com o MySQL. Voc no pode usar uma verso BDB sem estes patchs com o e a a MySQL. Na MySQL AB, ns estamos trabalhando em cooperao com a Sleepycat para manter a o ca alta qualidade da interface do MySQL/BDB. Quando trouxemos o suporte a tabelas BDB, nos comprometemos a ajudar os nosso usurios a a localizar o problema e criar um caso de teste reproduz ivel para qualquer problema envolvendo tabelas BDB. Tais casos de teste sero enviados a Sleepycat que nos ajudar a a a encontrar e arrumar o problema. Como esta uma operao de dois estgios, qualquer e ca a problema com tabelas BDB podem levar um tempo um pouco maior para ser resolvido do que em outros mecanismos de armazenamento. De qualquer forma, como o cdigo do Berkeo leyDB tem sido usado em autras aplicaes alm do MySQL, ns no vemos nenhum grande co e o a problema com isto. Veja Seo 1.4.1 [Suporte], Pgina 17. ca a

7.6.2 Instalando BDB

Se voc tiver feito o download de uma verso binria do MySQL que inclui suporte a Berkee a a leyDB, simplesmente siga as instrues de instalao de uma verso binria do MySQL. Veja co ca a a Seo 2.2.9 [Instalando o binrio], Pgina 91. Veja Seo 4.8.5 [mysqld-max], Pgina 343. ca a a ca a Para compilar o MySQL com suporte a BerkeleyDB, faa o download do MySQL verso c a 3.23.34 ou mais novo e congure MySQL com a opo --with-berkeley-db. Veja Seo 2.3 ca ca [Instalando o fonte], Pgina 94. a

Cap tulo 7: Tipos de Tabela do MySQL

699

cd /path/to/source/of/mysql-3.23.34 ./configure --with-berkeley-db Por favor, de uma olhada no manual fornecido com a distribuio BDB para informaes ca co mais atualizadas. Mesmo sendo o BerkeleyDB muito testado e convel, a interface com o MySQL ainda a e considerada com qualidade gamma. Ns estamos ativamente melhorando e otimizando para o torn-la estvel o mais breve poss a a ivel.

7.6.3 Opes de Inicializao do BDB co ca

Se voc estiver executando com AUTOCOMMIT=0 ento as suas alteraes em tabelas BDB no e a co a sero atualizadas at que voc execute um COMMIT. No lugar de commit voc pode executar a e e e um ROLLBACK para ignorar as suas alteraes. Veja Seo 6.7.1 [COMMIT], Pgina 615. co ca a Se voc estiver execuando AUTOCOMMIT=1 (padro), ser feito um commit das sua alteraes e a a co imediatamente. Voc pode iniciar uma transao estendida com o comando SQL BEGIN e ca WORK, depois do qual no ser feito commit de suas alteraes ae que voc execute COMMIT a a co e (ou faa ROLLBACK das alteraes.) c co As seguintes opes do mysqld podem ser usadas pa alterar o comportamento de tabelas co BDB: Opo ca --bdbhome=directory --bdb-lockdetect=# --bdblogdir=directory --bdb-no-sync --bdb-no-recover Descrio ca Diretrio base das tabelas BDB. Ele deve ser o o mesmo diretrio usado para --datadir. o Deteco de travas de Berkeley. Pode ser ca (DEFAULT, OLDEST, RANDOM, ou YOUNGEST). Diretrio de arquivos log de Berkeley DB. o

No sincroniza logs descarregados. a No inicia Berkeley DB no modo de recua perao. ca --bdb-shared-data Inicia Berkeley DB no modo de multi-processos (No usa DB_PRIVATE ao inicializar Berkeley a DB) --bdbDiretorio de arquivos temporrios do Berkeley a tmpdir=directory DB. --skip-bdb Disabilita o uso de tabelas BDB. -O bdb_max_ Dene o nmero mximo de travas poss u a iveis. lock=1000 Veja Seo 4.6.8.4 [bdb_max_lock], Pgina 309. ca a Se voc utiliza --skip-bdb, MySQL no ir inicializar o biblioteca Berkeley DB e isto ir e a a a economizar muita memria. E claro que voc no pode utilizar tabelas BDB se voc estiver o e a e usando esta opo. Se voc tentar criar uma tabela BDB, o MySQL criar uma tabela ca e a MyISAM. Normalmente voc deve iniciar mysqld sem --bdb-no-recover se voc pretende usar e e tabelas BDB. Isto pode, no entanto, lhe trazer problemas quando voc tentar iniciar o e mysqld e os arquivos de log do BDB estiverem corrompidos. Veja Seo 2.4.2 [Iniciando o ca servidor], Pgina 116. a

700

MySQL Technical Reference for Version 5.0.0-alpha

Com bdb_max_lock voc pode especicar o nmero mcimo de travas (10000 por padro) e u a a que voc pode tar ativas em uma tabela BDB. Voc deve aument-lo se voc obter um erro do e e a e tipo bdb: Lock table is out of available locks ou Got error 12 from ... quando voc e zer transaes longas ou quando mysqld tiver que examinar muitas linhas para calcular a co consulta. Voc tambm pode desejar alterar binlog_cache_size e max_binlog_cache_size se voc e e e estiver usando transaes multi-linhas. Veja Seo 6.7.1 [COMMIT], Pgina 615. co ca a

7.6.4 Caracter isticas de Tabelas BDB:

Para estar apto a fazer roolback da transao, o mecanismo de armazenamento BDB ca mantm arquivos de log. Para obter o mximo de desempenho voc deve colocar estes e a e arquivos em outro disco diferente do usado por seus bancos de dados usando a opo ca --bdb-logdir. O MySQL realiza um ponto de vericao a cada vez que um novo arquivo de log ca do BDB iniciado e remove qualquer arquivo de log que no for necessrio para a e a a transao atual. Pode se executar FLUSH LOGS a qualquer momento para faze um ca ponto de vericao de tabelas Berkeley DB. ca Para recuperao de desastres, deve-se usar backups de tabelas mais log binrio do ca a MySQL. Veja Seo 4.5.1 [Backup], Pgina 275. ca a Aviso: Se voc delatar arquivos de log antigos que esto em uso, o BDB no estar apto e a a a a fazer a recuperao e voc pode perder dados se algo der errado. ca e O MySQL precisa de uma PRIMARY KEY em cada tabela BDB para poder fazer referncia e a linha lida anteriormente. Se voc no criar um o MySQL criar uma chave primria e a a a oculta para voc. A chave oculta tem um tamanho de 5 bytes e incrementada a cada e e tentaiva de insero. ca Se todas as colunas que voc acessa em uma tabela BDB so parte do mesmo e a indice ou parte de uma chave primria, ento o MySQL pode executar a consulta ser ter que a a acessar a linha atual. Em uma tabela MyISAM o descrito acima guardado apenas se e as colunas so parte do mesmo a indice. A PRIMARY KEY ser mais rpida que qualquer outra chave, j que a PRIMARY KEY a a a e armazenada junto com o registro do dado. Como as outras chaves so armazenads a como os dados da chave + a PRIMARY KEY, importante manter a PRIMARY KEY o menor e poss para economizar disco e conseguir maior velocidade. ivel LOCK TABLES funciona em tabelas BDB como nas outras tabelas. Se voc no utilizar e a LOCK TABLE, MySQL comandar um bloqueio interno de mltipla-escrita nas tabelas a u para assegurar que a tabela ser bloqueada apropriadamente se outra thread executar a um bloqueio de tabela. Bloqueios internos em tabelas BDB feito por pgina. e a SELECT COUNT(*) FROM nome_tabela lento pois tabelas BDB no mantm um contador e a e do nmero de linha na tabela. u A varredura sequencial mais lenta que com tabelas MyISAM j que os dados em tabelas e a BDB so armazenados em rvores-B e no em um arquivo de dados separado. a a a

Cap tulo 7: Tipos de Tabela do MySQL

701

A aplicao sempre deve estar preparada para tratar casos onde qualquer alterao de ca ca uma tabela BDB pode fazer um rollback automtico e quqlquer leitura pode falhar com a um erro de deadlock. As chaves no so compactadas por prexo ou por suxo como em tabelas MyISAM. Em a a outras palavras, a informao da chave gastar um pouco mais de espao em tabelas ca a c BDB quando comparadas a tabelas MyISAM. Existem buracos frequentemente em tabelas BDB para permitir que voc insira novas e linhas no meio da rvore de chaves. Isto torna tabelas BDB um pouco maiores que a tabelas MyISAM. O otimizador precisa conhecer aproximadamente o nmero de linhas na tabela. O u MySQL resolve isto contando inseres e mantendo isto em um segmento separado em co cada tabela BDB. Se voc no executar vrias instrues DELETE ou ROLLBACK, este e a a co nmero dever estar sucientemente prximo do exato para o otimizador do MySQL, u a o mas como o MySQL s armazerna o nmero ao nalizar, ele pode estar incorreto se o o u MySQL nalizar inesperadamente. Isto no deve ser fatail mesmo se este nmero no a u a for 100% correto. POde se atualizar o nmero de linhas executando ANALYZE TABLE ou u OPTIMIZE TABLE. Veja Seo 4.6.2 [ANALYZE TABLE], Pgina 298 . Veja Seo 4.6.1 ca a ca [OPTIMIZE TABLE], Pgina 298. a Se voc car com o seu disco cheio com uma tabela BDB, voc obter um erro (provavele e a mente erro 28) e deve ser feito um rollback da transao. Isto est em contraste com ca a as tabelas MyISAM e ISAM onde o mysqld ir esperar por espao suciente em disco pra a c continuar.

7.6.5 Itens a serem corrigidos no BDB num futuro prximo: o

E muito lento abrir muitas tabelas BDB ao mesmo tempo. Se voc for utilizar tabelas e BDB, voc no deve ter um cache de tabela muito grande (> 256) e voc deve usar e a e --no-auto-rehash com o cliente mysql. Ns planejamos arrumar isto parcialmente na o versp 4.0. a SHOW TABLE STATUS ainda mo fornece muitas informaes para tabelas BDB a co Otimizar o desempenho. Fazer com que no seja utilizado bloqueio de pginas quando varrermos a tabela. a a

7.6.6 Sistemas operacionais suportados pelo BDB

Atualmente sabemos que o mecanismo de armazenamento BDB funciona com os seguintes sistemas operacionais: Linux 2.x Intel Sun Solaris (sparc e x86) FreeBSD 4.x/5.x (x86, sparc64) IBM AIX 4.3.x SCO OpenServer SCO UnixWare 7.0.1

702

MySQL Technical Reference for Version 5.0.0-alpha

Ele

no funciona com os seguintes sistemas operacionais. a Linux 2.x Alpha Linux 2.x AMD64 Linux 2.x IA64 Linux 2.x s390 Max OS X

Nota: A lista acima no est completa; atualizaremos ela assim que recebermos mais ina a formaes. co Se voc construir o MySQL como suporte a tabelas BDB e obter o seguinte erro no arquivo e de log quando voc iniciar o mysqld: e bdb: architecture lacks fast mutexes: applications cannot be threaded Cant init dtabases Isto signica que as tabelas BDB no so suportadas por sua arquitetura. Neste caso voc a a e deve reconstruir o MySQL sem o suporte a tabelas BDB.

7.6.7 Restries em Tabelas BDB co

Aqui segue as restries que voc tem quando utiliza tabelas BDB: co e Tabelas BDB armazenam no arquivo .db o caminho para o arquivo no qual ela foi crada. (Isto foi feito para tornar poss detectar travas em um ambiente multi-usurio que ivel a suporte links simblicos) o O efeito disto que tabelas BDB no podem ser movidas entre diretrios! e a o Ao tirar backups de tabelas BDB, voc pode utilizar mysqldump ou tirar backup de todos e os arquivos nome_tabela.db e os arquivos de log do BDB. Os arquivos de log do BDB so os arquivos no diretrio de dados base chamado log.XXXXXXXXXX (dez digitos); O a o mecanismo de armazenamento BDB guarda transaes no terminadas em arquivos de co a log e exige que estes arquivos sejam apresentados quando o mysqld iniciar.

7.6.8 Erros Que Podem Ocorrer Usando Tabelas BDB

Se voc obter o seguinte erro no log hostname.err ao iniciar o mysqld: e bdb: Ignoring log file: .../log.XXXXXXXXXX: unsupported log version # signica que a nova verso BDB no suporta o formato do arquivo de log antigo. Neste a a caso voc tem que deletar todos os logs BDB do seu diretrio de banco de dados (o arquivo e o com nomes no formato log.XXXXXXXXXX) e reiniciar o mysqld. Tambm recomentdamos e que voc faa um mysqldump --opt de sua tabela BDB antiga, delete as tabelas antigas e c e restaure o dump. Se voc no estiver executando em modo auto-commit e deltar uma tabela que refere a e enciada em outra transao, voc pode obter a seguinte mensagem de erro em seu log ca e de erro do MySQL: 001119 23:43:56 bdb: Missing log fileid entry 001119 23:43:56 bdb: txn_abort: Log undo failed for LSN: 1 3644744: Invalid

Cap tulo 7: Tipos de Tabela do MySQL

703

Isto no fatal mas no recomendamos deletar tabelas se no estiver no modo autoa e a a commit, at que este problema seja resolvido (a soluo no trivial). e ca a e

704

MySQL Technical Reference for Version 5.0.0-alpha

8 Introduo ao MaxDB ca
MaxDB um banco de dados empresarial. O MaxDB o novo nome de um sistema de e e gerenciamento de banco de dados formalmente chamado SAP DB.

8.1 Historia do MaxDB

A histria do SAP DB vem do o inicio dos anos 80, quando ele foi desenvolvido como um produto comercial (Adabas). O banco de dados mudou de nome diversas vezes desde ento. a Quando a SAP AG, uma companhia Alem tomou conta do desenvolvimento deste sistema a de banco de dados, ele foi chamado de SAP DB. A SAP desenvolve sistemas de banco de dados para servir como um sistema de armazenamento para todas as aplicaes pesadas SAP, chamadas R/3. O SAP DB foi criado para co fornecer uma alternativa para sistemas de banco de dados como o Oracle, Microsoft SQL Server, ou DB2 da IBM. Em Outubro de 2000, A SAP AG liberou o SAP DB soba licena c GNU GPL (veja Apndice H [GPL license], Pgina 1096), fazendo dele um programa open e a source. Em Outubro de 2003, mais de 2000 clientes da SAP AG estavam usando SAP DB como o seu principal sistema de banco de dados, e mais de outros 2000 clientes o estavam usando como um sistema de banco de dados a parte alm do banco de dados principal, e como parte de uma soluo APO/LivaCache. ca Em Maio de 2003, uma parceria foi formada entre a MySQL AB e a SAP AG. Esta parceria permite ` MySQL AB desenvolver no SQP DB, renome-lo e a vender licenas comerciais a a c do SAP DB para clientes que no queiram ser limitados pelas restries impostas a eles a co quando usam o sistema de banco de dados sob uma licena GNU GPL (veja Apndice H c e [GPL license], Pgina 1096). Em Agosto 2003, o SAP DB foi renomeado para MaxDB pela a MySQL AB.

8.2 Licenciamento e Suporte

O MaxDB pode ser usado sob as mesmas licenas dispon c iveis para os outros produtos distribu idos pela MySQL AB (veja Seo 1.4.3 [MySQL licenses], Pgina 18). Assim, o ca a sob a GNU General Public License (veja Apndice H [GPL license], MaxDB estar disponivel a e Pgina 1096), e uma licena comercial (veja Seo 1.4 [Licensing and Support], Pgina 17). a c ca a A MySQL ir oferecer suporte para MaxDB para clientes no-SAP. a a A primeira verso renovada ser o MaxDB 7.5.00 que ser liberada no m de 2003. a a a

8.3 Conceitos Bsicos do MaxDB a

O MaxDB opera como um produto cliente/servidor. Ele foi desenvolvido para cobrir a demanda de instalaes que processam um alto volume de transaes on line. Tanto a co co expanso quanto o backup online do banco de dados so suportados. O Microsoft Clustered a a Server suportado diretamente para implementaes multi-servidor; outras solues para e co co falhas devem ser feitas manualmente. A ferramenta de gerenciamento de banco de dados so fornecidos tanto na implementao Windows quanto na baseada em browser. a ca

Cap tulo 8: Introduo ao MaxDB ca

705

8.4 Diferenas de Recursos entre o MaxDB e o MySQL c

A lista a seguir fornece um pequeno resumo das principais diferenas entre o MaxDB e o c MySQL; ela no esta completa. a MaxDB funciona como um sistema cliente/servidor. O MySQL pode ncionar como um sistema cliente/servidor ou como um sistema embutido. O MaxDB no pode ser executado em todas as plataformas suportadas pelo MySQL. a Por exemplo, o MaxDB no funciona no OS/2 da IBM. a O MaxDB usa um protocolo de rede proprietrio para comunicao cliente servidor, a ca enquanto o MySQL usa o TCP/IP (com ou sem criptograa SSL), sockets (sob sistemas do tipo Unix) ou named pipes (sob sistemas da familia Windows-NT). O MaxDB suporta stored procedures. Para o MySQL, stored procedures no esto a a programadas para implementao at a verso 5.0. O MaxDB tambm suporta proca e a e gramao de triggers por meio de extenso SQL, que est previsto para o MySQL 5.1. ca a a O MaxDB contm um depurador para linguagens com stored procedures, pode fazer e cascade de triggers aninhados e suporta vrios triggers por ao e linha. a ca com interface de usurios em modo texto, grco ou baseado O MaxDB distribuido e a a web. O MySQL distribu apenas com interfaces de usurios em modo text; uma e ido a interface grca do usurio (MySQL Control Center) distribu separadamente da a a e ida distribuo principal. Interfaces com o usurios baseada em Web para o MySQL so ca a a ofereceidas por terceiros. O MaxDB suporta um nmero de interfaces de programao tambm suportadas pelo u ca e MySQL. No entanto, o MaxDB no suporta RDO, ADO, ou .NET, os quais so supora a tadas pelo MySQL. O MaxDB suporta SQL embarcado apenas com C/C++. O MaxDB contm recursos administrativos que o MySQL no tem: Agendamento de e a tarefas por hora, evento, e alerta , e permite enviar mensagens para um administrador de banco de dados nos avisos.

8.5 Interoperability Features between MaxDB and MySQL

Os seguintes recursos sero inclu a idos nas verso do MaxDB a serem distribu a idas aps a o verso 7.5.00. Estes recursos permitiro interoperabilidade entre MaxDB e MySQL: a a Haver um proxy MySQL permitindo que se conecte ao MaxDb usando o protocolo a MySQL. Isto faz com que seja poss usar os programas clientes do MySQL para o ivel MaxDB, com a interface de linha de comando mysql, o utilitrio de dump mysqldump, o a programa de importao mysqlimport. Usando o mysqldump, pode-se facilmente fazer ca o dump de dados de um sistema de banco de dados e exportar estes dados para outro sistema de banco de dados. Replicao entre MySQL e MaxDB ser suportado em ambas as direes. Isto , tanto ca a co e o MySQL quanto o MaxDb podem ser usados como o servidor master da replicao. ca O plano a longo prazo convergir e extender a sintaxe da replicao para que assim e ca ambos os sistemas de bancos de dados entendam a mesma sintaxe. Veja Seo 4.11.1 ca [Replication Intro], Pgina 378. a

706

MySQL Technical Reference for Version 5.0.0-alpha

8.6 Links Relacionados ao MaxDB

A pgina principal para informaes sobre o MaxDB http://www.mysql.com/maxdb. a co e Eventualmente, todas as informaes disponiveis em http://www.sapdb.org sero movidas co a para l. a

8.7 Palavras Reservadas no MaxDB

Assim como o MySQL, o MaxDB tem algumas palavras reservadas que tenham signicados especiais. Normalmente elas no podem ser usadas como nomes de identicadores, tais a como nomes de bancos de dados ou tabelas. A tabela a seguir lista as palavras reservadas no MaxDB, indica o contexto no qual estas palavras so utilizadas e indica se elas possuem a correspondentes ou no no MySQL. Se existir, o signicado no MySQL pode ser idntico a e ou diferente em alguns aspectos. O principal objetivo listar em que o MaxDB difere do e MySQL; embora esta lista no esteja completa. a Para a lista de palavras reservadas do MySQL, veja Veja Seo 6.1.7 [Reserved words], ca Pgina 479. a Reservada MaxDB @ ADDDATE() ADDTIME() ALPHA ARRAY ASCII() AUTOCOMMIT BOOLEAN no Contexto do uso no MaxDB Pode preceder identicadores, como @table Funo SQL ca Funo SQL ca Funo SQL ca Tipo de dados Funo SQL ca Transaes; co ON por padro a Tipos de coluna; BOOLEAN aceita como valor apenas TRUE, FALSE, e NULL CHECK TABLE Tipos de coluna Funo SQL ca Implicit commits of transactions happen when data denition queries are being issued Funo SQL ca Funo SQL ca Correspondente no MySQL No permitido a ADDDATE(); nova no MySQL 4.1.1 ADDTIME(); nova no MySQL 4.1.1 Nenhuma correspondencia No implementado a ASCII(), mas implementado com um signicado diferente Transaes; OFF por padro co a BOOLEAN was added in MySQL version 4.1.0; it is a synonym for BOOL which is mapped to TINYINT(1). It accepts integer values in the same range as TINYINT as well as NULL. TRUE and FALSE can be used as aliases for 1 and 0. CHECK TABLE; similar, mas com uso diferente COLUMN; noise word CHAR(); identical syntax; similar, not identical usage Implicit commits of transactions happen when data denition queries are being issued, but also with a number of other queries Nenhuma correspondencia COT(); identical syntax and implementation

CHECK COLUMN CHAR() COMMIT

COSH() COT()

Cap tulo 8: Introduo ao MaxDB ca

707

CREATE DATABASE DATE() DATEDIFF() DAY() DAYOFWEEK() DISTINCT DROP EBCDIC() EXPAND() EXPLAIN FIXED() FLOAT() HEX() INDEX() INDEX

SQL, data language Funo SQL ca Funo ca Funo ca Funo ca Funo ca SQL SQL SQL SQL

denition

CREATE DATABASE(); DATABASE is used in a dierent context, for example CREATE DATABASE CURRENT_DATE DATEDIFF(); nova no MySQL 4.1.1 Nenhuma correspondencia DAYOFWEEK(); the rst day (1) by default is Monday in MaxDB, and Sunday in MySQL DISTINCT; but used in a dierent context: SELECT DISTINCT DROP INDEX; similar, but not identical usage Nenhuma correspondencia Nenhuma correspondencia EXPLAIN; similar, but not identical usage Nenhuma correspondencia Nenhuma correspondencia HEX(); similar, but not identical usage INSTR() or LOCATE(); similar, but not identical syntaxes and meanings USE INDEX, IGNORE INDEX and similar hints are being used in the FROM clause of a SELECT query, like in SELECT ... FROM ... USE INDEX Nenhuma correspondencia LENGTH(); identical syntax, but slightly different implementation Nenhuma correspondencia LIKE; but the extended LIKE MaxDB provides rather resembles the MySQL REGEX MySQL supports %, and as wildcards in a LIKE comparison

Funes SQL AVG, MAX, co MIN, SUM inter alia in DROP INDEX Funo SQL ca Funo SQL ca Optimization Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca USE INDEX, IGNORE INDEX and similar hints are being used right after SELECT, like SELECT ... USE INDEX Funo SQL ca Funo SQL ca Funo SQL ca Comparisons MaxDB supports %, , ctrl+underline, ctrl+up arrow, *, and ? as wildcards in a LIKE comparison Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca Column types; comparisons

INITCAP() LENGTH() LFILL() LIKE LIKE wildcards

LPAD() LTRIM() MAKEDATE() MAKETIME() MAPCHAR() MICROSECOND() NOROUND() NULL

LPAD(); slightly dierent implementation LTRIM(); slightly dierent implementation MAKEDATE(); nova no MySQL 4.1.1 MAKETIME(); nova no MySQL 4.1.1 Nenhuma correspondencia MICROSECOND(); nova no MySQL 4.1.1 Nenhuma correspondencia NULL; MaxDB supports special NULL values that are returned by arithmetic operations that lead to an overow or a division by zero; MySQL does not support such special values

708

MySQL Technical Reference for Version 5.0.0-alpha

PI REF RFILL() ROWNO RPAD() RTRIM() SEQUENCE SINH() SOUNDS() STATISTICS SUBSTR() SUBTIME() SYNONYM

Funo SQL ca Data type Funo SQL ca Predicate in WHERE clause Funo SQL ca Funo SQL ca CREATE SEQUENCE, DROP SEQUENCE Funo SQL ca Funo SQL ca UPDATE STATISTICS Funo SQL ca Funo SQL ca Data denition language: CREATE [PUBLIC] SYNONYM, RENAME SYNONYM, DROP SYNONYM Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca Funo SQL ca

PI(); identical syntax and implementation, but parantheses are mandatory Nenhuma correspondencia Nenhuma correspondencia Similar to LIMIT clause RPAD(); slightly dierent implementation RTRIM(); slightly dierent implementation AUTO_INCREMENT; similar concept, but differing implementation Nenhuma correspondencia SOUNDEX(); slightly dierent syntax ANALYZE; similar concept, but diering implementation SUBSTRING(); slightly dierent implementation SUBTIME(); nova no MySQL 4.1.1 Nenhuma correspondencia

TANH() TIME() TIMEDIFF() TIMESTAMP() TIMESTAMP() as argument to DAYOFMONTH() and DAYOFYEAR() TIMEZONE() TRANSACTION() TRANSLATE() TRIM() TRUNC() USE USER UTC_DIFF() VALUE() VARIANCE() WEEKOFYEAR()

Nenhuma correspondencia CURRENT_TIME TIMEDIFF(); nova no MySQL 4.1.1 TIMESTAMP(); nova no MySQL 4.1.1 Nenhuma correspondencia

Funo SQL ca Returns the ID of the current transaction Funo SQL ca Funo SQL ca Funo SQL ca mysql commandline user interface command Funo SQL ca Funo SQL ca Funo SQL, alias for ca COALESCE() Funo SQL ca Funo SQL ca

Nenhuma correspondencia Nenhuma correspondencia REPLACE(); identical syntax and implementation TRIM(); slightly dierent implementation TRUNCATE(); slightly dierent syntax and implementation USE USER(); identical syntax, but slightly different implementation, and parantheses are mandatory UTC_DATE(); provides a means to calculate the result of UTC_DIFF() COALESCE(); identical syntax and implementation Nenhuma correspondencia WEEKOFYEAR(); nova no MySQL 4.1.1

Cap tulo 8: Introduo ao MaxDB ca

709

8.8 Funoes c 8.9 Tipos de Colunas

710

MySQL Technical Reference for Version 5.0.0-alpha

9 Conjunto de Caracteres Nacionais e Unicode

Melhora do tratamento dos conjuntos de caracteres um do recursos adicionado ao MySQL e na verso 4.1. Este capitulo explica: a O que so conjuntos de caracteres e collations a O sistema padro de multi n a iveis A nova sintaxe no MySQL 4.1 Funes e operaes afetadas co co O signifcado individual de cada conjunto de caracter e collation Os recursos descritos aqui esto como implementados no MySQL 4.1.1. (MySQL 4.1.0 a possui alguns, mas no todos destes recuros, e alguns deles esto implementados de forma a a diferente.)

9.1 Conjuntos de Caracteres e Collations em Geral

Um conjunto de caracters um conjunto de simbolos e cdigos. Uma collation um conjunto e o e de regras para comparao de caracteres em um conjunto de caracteres. Vamos deixar a ca distino clara com um exemplo de um conjunto de caracteres imaginrio. ca a Suponha que temos um alfabeto com quatro letras: A, B, a, b. Damos um nmero u a cada letra: A = 0, B = 1, a = 2, c = 3. A letra A o s e imbolo, o nmero 0 o u e cdigo para A, e a combinao de todas as quatro letra e seus cdigos um conjunto de o ca o e caracteres. Agora suponha que desejamos comparar dusa strings, A e B. O modo mais simples de se fazer isto olhar o cdigo 0 para A e 1 para B e como 0 menor que 1, dezemos que e o e A menor que B. Agora, o que zemos foi apenas aplicar um collation a nosso conjunto de e caracteres. A collation um conjunto de regras (apenas um regra neste caso): compara os e cdigos. Chamamos isto a mais simples de todas as collations poss o iveis como um collation binria. a Mas e se voc dissesse que letras m e inusculas e maisculas so equivalentes? Ento haveriam u a a pelo menos duas regras: (1) tratar as letras minsculas a e b como equivalentes a A e u B; (2) e ento comparar os cdigos. Chamamos isto de collation caso insensitivo. E um a o pouco mais complexo do que collation binria. a Na vida real, a maioria dos conjuntos de caracteres possuem muitos caracteres: no apenas a A e B mas todo o alfabeto, algumas vezes alfabetos mltiplos ou sistemas de escritas u ocidentais com milhares de caracteres, junto com muitos s imbolos especiais e sinais de pontuao. Em geral as collations tambm possuem diversas regras: no apenas caso ca e a insensitivo mas acentos insensitivos e mapeamento de mltiplos caracteres (como a regra u de que = OE em uma das duas collations alems). O a O MySQL 4.1 pode fazer as seguintes coisas para voc: e Armazena a string usando um variedade de conjunto de caracteres Compara strings usando uma variedade de collations Mistura strings com diferentes conjuntos de caracteres ou collations no mesmo servidor, o mesmo banco de dados ou a mesma tabela

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

711

Permite a especicao de conjunto de caracteres e collations em qualquer n ca ivel A este respeito, o MySQL 4.1 no s mais ex que o MySQL 4.0, mas tambm est a oe ivel e a bem a frente de outros SGBDs. No entanto, para usar os novos recursos efetivamente, voc e precisar aprender quais conjuntos de caracteres e collations esto dispon a a iveis, como alterar os seus padres e o que os vrios operadores de string fazem como ele. o a

9.2 Conjunto de Caracteres e Collations no MySQL

Um conjunto de caracter sempre tem pelo menos uma collation. Ele pode ter diversas collations. Por exemplo, conjunto de caracteres latin1 (ISO-8859-1 West European) tem os seguintes collations: Collation latin1_bin latin1_danish_ci latin1_german1_ci latin1_german2_ci latin1_swedish_ci latin1_general_ci Notas: Dois conjuntos de caracteres diferentes no podem ter a mesma collation. a Cada conjunto de caracteres tem uma collation que a collation padro. Por exemplp, e a o collation padro para latin1 latin1_swedish_ci. a e Perceba que existe uma conveno para nomes de collations: Elas iniciam com o nome do ca conjunto de caracteres com o qual elas so associadas, eles normalmente incluem um nome a de linguagem e nalizam com _ci (caso insensitivo), _cs (caso sensitivo), ou _bin (binario). Signicado Binario de acordo com a codicao latin1 ca Dinamarqus/Noruegus e e Alemo DIN-1 a Alemo DIN-2 a Sueco/Finnish Multilingua

9.3 Determinando o Conjunto de Caracteres e Collation Padres o

Existem conguraes padres para conjuntos de caracteres e collations em quatro n co o iveis: servidor, banco de dados, tabela, conexo. A seguinte descrio pode parecer complexa, a ca mas ser encontrada na prtica que os padres em multi-n a a o iveis levam a resultados naturais e bvios. o

9.3.1 Conjunto de Caracteres e Collations do Servidor

O MySQL Server possui um conjunto de caracteres de servidor e collation de servidor que no podem ser nulos. a O MySQL determina o conjunto de caracteres e collations de servidor desta forma: De acordo com as opes de congurao em efeito quando o servidor iniciado. co ca e

712

MySQL Technical Reference for Version 5.0.0-alpha

Neste n ivel, a deciso simples. O conjunto de caracteres e collations do servidor a e dependem das opes que voc usa quando voc inicia o mysqld. Voc pode usar co e e e --default-character-set=character_set_name para o conjunto de caracteres, e junto com isto voc pode adcionar --default-collation=collation_name para e a collation. Se voc no especicar um conjunto de caracteres, o mesmo que e a e utilizar --default-character-set=latin1. Se voc especicar apenas um conjunto e de caracteres (por exemplo, latin1) mas no uma collation, o mesmo que usar a e --default-charset=latin1 --collation=latin1_swedish_ci pois latin1_swedish_ci a collation padro para latin1. Desta forma, os trs comando seguintees todos tm o e a e e mesmo efeito: shell> mysqld shell> mysqld --default-character-set=latin1 shell> mysqld --default-character-set=latin1 --default-collation=latin1_swedish_ci Um modo de o conjunto recompilando. Se voc quiser alterar o conjunto de caracteres e e e collation padres na construo dos fontes, utilize: --with-character-set e --witho ca collation como argumento para configure. Por exemplo: shell> ./configure --with-character-set=latin1 ou shell> ./configure --with-character-set=latin1 --with-collation=latin1_german1_ci Tanto o mysqld quanto o configure vericam que a combinao conjunto de ca caracteres/collations vlida. Cada programa exibe um mensagem de erro e termina se a e a combinao no for vlida. ca a a

9.3.2 Conjunto de Caracteres e Collation de Banco de Dados

Todo banco de dados tem um conjunto de caracteres de banco de dados e uma collatio de banco de dados, que no podem ser nulos. Os comandos CREATE DATABASE e ALTER a DATABASE agora possuem clusulas opcionais para especicarem o collation e conjunto de a caracteres de banco de dados: CREATE DATABASE db_name [DEFAULT CHARACTER SET character_set_name [COLLATE collation_name]] ALTER DATABASE db_name [DEFAULT CHARACTER SET character_set_name [COLLATE collation_name]] Exemplo: CREATE DATABASE db_name DEFAULT CHARACTER SET latin1 COLLATE latin1_swedish_ci; O MySQL escolhe o conjunto de caracteres e collations do banco de dados desta forma: Se CHARACTER SET X e COLLATE Y foram especicados, ento o conjunto de caracteres a e X e a collation Y. e Se CHARACTER SET X foi especicado sem COLLATE, ento o conjunto de caracteres X a e e a collation o padro. e a

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

713

Seno utiliza o conjunto de caracteres e a collation de servidor. a A sintaxe CREATE DATABASE ... DEFAULT CHARACTER SET ... do MySQL anloga a sine a taxe CREATE SCHEMA ... CHARACTER SET ... do padro SQL. Por isto, poss criar bana e ivel cos de dados com com conjunto de caracteres e collations diferentes, no mesmo servidor MySQL. O conjuto de caracteres e collations do banco de dados so usados como valores padres a o se o conjunto de caracteres e a collation de tabela no forem especicados nas instrues a co CREATE TABLE. Eles no possuem nenhum outro propsito. a o

9.3.3 O Conjunto de Caracteres e Collations de Tabela

Toda tabela tem um conjunto de caracteres e collations de tabela, que no pode ser nulo. a As instrues CREATE TABLE e ALTER TABLE agora possuem um clusula opcional para esco a pecicar o conjunto de caracteres e collation de tabela: CREATE TABLE table_name ( column_list ) [DEFAULT CHARACTER SET character_set_name [COLLATE collation_name]] ALTER TABLE table_name [DEFAULT CHARACTER SET character_set_name] [COLLATE collation_name] Exemplo: CREATE TABLE t1 ( ... ) DEFAULT CHARACTER SET latin1 COLLATE latin1_danish_ci; O MySQL escolhe o conjunto de caracteres e collation de tabela desta forma: Se CHARACTER SET X e COLLATE Y forem especicados, ento o conjunto de caracteres a e X e collation Y. e Se CHARACTER SET X foi especicado sem COLLATE, ento o conjunto de caracteres X a e e o collation o padro. e a Seno, o conjunto de caracteres e collation so os padres. a a o O conjunto de caracteres e collation de tabela so usado como valores padres, se o cona o junto de caracteres e collation de colunas no so especicados nas denies de colunas a a co individuais. O conjunto de caracteres e collation de tabelas so extenses MySQL; no h a o a a nada deste tipo na padro SQL. a

9.3.4 Conjunto de Caracteres e Collation de Colunas

Toda coluna caracter (isto , uma colua do tipo CHAR, VARCHAR, ou TEXT) tem um conjunto e de caracteres e collation de coluna, que no pode ser nulo. A sintaxe de denio de coluna a ca agora possui uma clusula opcional para especicar o conjunto de caracteres e collation: a column_name {CHAR | VARCHAR | TEXT} (column_length) [CHARACTER SET character_set_name [COLLATE collation_name]] Exemplo: CREATE TABLE Table1 ( column1 VARCHAR(5) CHARACTER SET latin1 COLLATE latin1_german1_ci

714

MySQL Technical Reference for Version 5.0.0-alpha

); O MySQL escolhe o conjunto de caracteres e collation de coluna desta forma: Se CHARACTER SET X e COLLATE Y forem especicados, ento o conjunto de caracteres a e X e collation Y. e Se CHARACTER SET X foi especicado sem COLLATE, ento o conjunto de caracteres X a e e o collation o padro. e a Seno, o conjunto de caracteres e collation so os padres. a a o As clusulas CHARACTER SET e COLLATE so do padro SQL. a a a

9.3.5 Exemplos de Atribuies de Conjuntos de Caracteres e co Collation

Os seguintes exemplos mostram como o MySQL determina valores de conjunto de caracteres e collations padres. o

Exemplo 1: Denio de Tabela + Coluna ca

CREATE TABLE t1 ( c1 CHAR(10) CHARACTER SET latin1 COLLATE latin1_german1_ci ) DEFAULT CHARACTER SET latin2 COLLATE latin2_bin; Aqui voc tem uma coluna com um conjunto de caracteres latin1 e um collation latin1_ e german1_ci. A denio explicita, assim ele direto. Note que no h problemas em ca e e a a armazenar uma coluna latin1 em uma tabela latin2.

Example 2: Denio de Tabela + Coluna ca

CREATE TABLE t1 ( c1 CHAR(10) CHARACTER SET latin1 ) DEFAULT CHARACTER SET latin1 COLLATE latin1_danish_ci; Desta vez temos uma coluna com um conjunto de caracteres latin1 e uma collation padro. a Agora, embora possa parecer natural, a collation padro tomada do n a e ivel de tabela. Como a collation padro para latin1 sempre latin1_swedish_ci, a coluna c1 ter uma a e a collation latin1_swedish_ci (e no latin1_danish_ci). a

Exemplo 3: Denio de Tabela + Coluna ca

CREATE TABLE t1 ( c1 CHAR(10) ) DEFAULT CHARACTER SET latin1 COLLATE latin1_danish_ci; Temos uma coluna com um conjunto de caracteres padro e uma collation padro. Nesta a a circunstncia, o MySQL olha para o n de tabela para determinar o conjunto de caracteres a ivel e collation de coluna. Assim o conjunto de caracteres para colune c1 latin1 e sua collation e latin1_danish_ci. e

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

715

Exemplo 4: Denio de Banco de Dados + Tabela + Coluna ca

CREATE DATABASE d1 DEFAULT CHARACTER SET latin2 COLLATE latin2_czech_ci; USE d1; CREATE TABLE t1 ( c1 CHAR(10) ); Criamos uma coluna sem especicar seu conjunto de caracteres e collation. Tambm no e a especicamos um conjunto de caracteres e uma collation na n ivel de tabela. Nestas circubntncias, o MySQL olha para o n a ivel de banco de dados para a determinao. (A ca congurao do banco de dados se torna a congurao da tabela e ento a congurao ca ca a ca da coluna). Assim o conjunto de caracteres para coluna c1 latin2 e sua collation e e latin2_czech_ci.

9.3.6 Conjunto de Caracteres e Collation de Conexo a

Toda conexo tem o seu conjunto de caracteres e collation, que no podem ser nulos. Esistem a a atualmente dois conjuntos de caracteres de conexo, que chamamos connection/literals e a connection/results quando necessrio distingui-los. e a Considere o que uma conexo: o que voc faz quando conecta ao servidor. O cliente e a e e envia instrues SQL, como consultas, pela conexo com o sevidor. O servidor envia reco a spostas, como resultados, pela conexo de volta para o cliente. Isto leva a diversas questes, a o tal como: (a) em qual conjunto de caracteres est uma consulta quando ela deixa o cliente? a (b) em qual conjunto de caracteres o servidor deve traduzir uma consulta aps receb-la? o e (c) para qual conjunto de caracteres o servidor deve traduzir antes de enviar o resultado ou mensagem de erros de volta para o cliente? Voc pode fazer um ajuste no das conguraes e co para isto, ou voc pode depender dos padres (neste caso, voc pode ignorar esta seo). e o e ca Existem suas instrues que afetam o conjunto de caracteres da conexo: co a SET NAMES character_set_name SET CHARACTER SET character_set_name SET NAMES indica o que est na instruo SQL que o cliente envia. Assim, SET NAMES a ca cp1251diz ao servidor que futuras mensagens vindas do cliente estaro no conjunto de cara acteres cp1251 e o servidor est livre para traduzir para seu prprio conjunto de caracteres, a o se apropriado. SET CHARACTER SET indica o que est na instruo SQL que o cliente envia, e tambm o que a ca e est no resultado que o servidor envia de volta para o cliente. Assim, SET CHARACTER SET a inclui SET NAMES, e tambm especica qual conjunto de caracteres o valor da coluna ter e a se, por exempo, voc usar uma instruo SELECT. e ca EXEMPLO: Suponha que column1 denido como CHAR(5) CHARACTER SET latin2. Se e voc no utilizar SET CHARACTER SET, ento para SELECT column1 FROM t o servidor enviar e a a a de volta todos os valores para column1 usando o conjunto de caracteres latin2. Se por outro lado voc usar SET CHARACTER SET latin1 ento o servidor, antes de enviar de volta, e a converter os valores latin2 para latin1. Tal converso lenta e poder ter perdas. a a e

716

MySQL Technical Reference for Version 5.0.0-alpha

Quando voc executa SET NAMES ou SET CHARACTER SET, voc tambm est alterando a e e e a collation da conexo. No entanto a collation da conexo existe apenas para consistncia. a a e Normalmente o seu valor no importa. a Com o cliente mysql, no necessrio executar SET NAMES todas as vezes que voc inic-lo. a e a e a Voc pode adicionar a opo --default-character-set-name a sua linha de instruo do e ca ca mysql, ou em seu arquivo de opo. Por exemplo, a seguinte congurao do arquivo de ca ca opo ir alterar o conjunto de caracteres da conexo cada vez que voc executar mysql: ca a a e [mysql] default-character-set-name=character_set_name

9.3.7 Conjunto de Caracteres e Collation de Caracter de String Literal

Todo caracter de uma string literal tem um conjunto de caracteres e collation, que podem ser nulos. Um caracter de uma string literal pode ter um introdutor de conjunto de caracteres opcional e clusula COLLATE: a [_character_set_name]string [COLLATE collation_name] Exemplos: SELECT string; SELECT _latin1string; SELECT _latin1string COLLATE latin1_danish_ci; A instruo simples SELECT string usa o conjunto de caracteres da conexo/literal. ca a A expresso _character_set_name formalmente chamada um introdutor. Ele diz ao a e analisador que a string que ele vai seguir est no conjunto de caracteres X. Como isto a tem confundido as pessoas no passado, enfatizamos que um introdutor no faz qualquer a converso, ele simplesmente um sinal que no altera o valor da string. Um introdutor a a tambm permitido antes de uma notao de um literal hexa padro e um literal hexa e e ca a numrico (xliteral e 0xnnnn), e antes de ? (substituio de parmetros ao usar intrues e ca a co preparadas dentro de uma interface de linguagem de programao). ca Exemplos: SELECT _latin1 xAABBCC; SELECT _latin1 0xAABBCC; SELECT _latin1 ?; O MySQL determina um conjunto de caracteres e collation de literal desta forma: Se _X e COLLATE Y forma especicados ento o conjunto de caracteres do literal X e o a e collation do literal Y e Se _X especicado mas COLLATE no especicado, ento o conjunto de caracteres do e a e a literal X e a collation do literal a collation padro do X e e a De outra forma, o conjunto de caracteres e collation o da conexo/literal. e a Exemplos: Uma string com o conjunto de caracteres latin1 e collation latin1_german1_ci. SELECT _latin1Mller COLLATE latin1_german1_ci; u

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

717

Uma string com conjunto de caracteres latin1 e e sua collation padro, isto , latin1_ a e swedish_ci: SELECT _latin1Mller; u Uma string com o conjunto de caracteres e a collation da conexo/literal: a SELECT Mller; u Introdutores de conjunto de caracteres e a clusula COLLATE so implementados de acordo a a com as especicaes do padro SQL. co a

9.3.8 Clusula COLLATE em Vrias Partes de uma Consulta SQL a a

Com a clusula COLLATE voc pode sobrescrever o padro da collation, qualquer que seja a e a ele, para comparao. COLLATE pode ser usada em vrias partes da consulta SQL. Aqui ca a esto alguns exemplos: a Com ORDER BY: SELECT k FROM t1 ORDER BY k COLLATE latin1_german2_ci; Com AS: SELECT k COLLATE latin1_german2_ci AS k1 FROM t1 ORDER BY k1; Com GROUP BY: SELECT k FROM t1 GROUP BY k COLLATE latin1_german2_ci; Com aggregate functions: SELECT MAX(k COLLATE latin1_german2_ci) FROM t1; Com DISTINCT: SELECT DISTINCT k COLLATE latin1_german2_ci FROM t1; Com WHERE: SELECT * FROM t1 WHERE _latin1 Mller COLLATE latin1_german2_ci = k; u Com HAVING: SELECT k FROM t1 GROUP BY k HAVING k = _latin1 Mller COLLATE latin1_german2_ci; u

718

MySQL Technical Reference for Version 5.0.0-alpha

9.3.9 Precedncia da Clusula COLLATE e a

A clusula COLLATE tem alta precedncia (maior que ||), ento a expresso a e a a x || y COLLATE z equivalente a: e x || (y COLLATE z)

9.3.10 Operador BINARY

O operador BINARY uma atalho para uma clusula COLLATE. Por exemplo, BINARY x e a equivalente a x COLLATE y, onde y o nome de uma collation binria apropriada. Por e e a exemplo, assumindo que a coluna a do conjunto de caracteres latin1, estas duas consultas e tm o mesmo efeito: e SELECT * FROM t1 ORDER BY BINARY a; SELECT * FROM t1 ORDER BY a COLLATE latin1_bin; Nota: Todo conjunto de caracteres tem um collation binrio. a

9.3.11 Alguns Casos Especiais Onde a Determinao da Collation ca e Trabalhosa

Na grande maioria das consultas, obvio qual collation que o MySQL usa para resolver e uma operao de comparao. Por exemplo, nos seguintes casos deve estar claro que a ca ca collationser a collation de coluna da coluna x: a SELECT x FROM T ORDER BY x; SELECT x FROM T WHERE x = x; SELECT DISTINCT x FROM T; No entanto, quando mltiplos operandos esto envolvidos, pode haver ambiguidade. Por u a exemplo: SELECT x FROM T WHERE x = Y; Esta consulta deve usar a collation de coluna x, ou da string literal Y? O padro SQL resolve tal questo usando o que se costuma chamar real coercibilidade. a a A essncia : Como x e Y tem collation, qual collation toma precedncia? E complexo, e e e mas estas regras cuidariam da maioria das situaes: co Uma clusula COLLATE explicita tem precedncia 4 a e Uma concatenao de duas strings com diferentes collations tem precedncia 3. ca e Uma collation de coluna tem precedncia 2. e Uma collation de literal tem precedncia 1. e Estas regras resolvem ambiguidades da seguinte forma: Use a collation com a maior precedncia. e Se ambos os lados tiverem a mesma precedncia, ento ter um erro se a collation no e a a a so as mesmas. a

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

719

Exemplos: column1 = A column1 = A COLLATE x column1 COLLATE x = A COLLATE y Usa a collation de column1 Usa a collation de A Error

9.3.12 Collations Devem Ser para o Conjunto de Caracteres Certo

Lembramos que cada conjunto de caracteres tem um ou mais collation, e cada collation associada com um e apenas um conjunto de caracteres. Consequentemente, a seguinte e instruo causa um mensagem de erro porque a collation latin2_bin no permitida com ca a e o conjunto de caracteres latin1: mysql> SELECT _latin1 x COLLATE latin2_bin; ERROR 1251: COLLATION latin2_bin is not valid for CHARACTER SET latin1

9.3.13 Um exemplo do Efeito da Collation

Suponha que a coluna X na tabela T possui estes valores na coluna latin1: Muffler Mller u MX Systems MySQL E suponha que os valores da coluna so retornados usando a seguinte instruo: a ca SELECT X FROM T ORDER BY X COLLATE collation_name; A ordem resultante dos valores para diferentes collation mostrado nesta tabela: e latin1_swedish_ci latin1_german1_ci latin1_german2_ci Muer Muer Mller u MX Systems Mller u Muer Mller u MX Systems MX Systems MySQL MySQL MySQL A tabela um exemplo que mostra que mostra qual seria o efeito se usassemos collation e diferentes em um clusula ORDER BY. O caracter que est causando o problema neste exa a emplo o U com dois pontos sobre ele, que os Alemes chamam de U-umlaut, mas ns e a o chamamos de U-diaeresis. A primeira coluna mostra o resultado da SELECT usando as regras de collation Suco/Finlands, que diz que U-diaeresis ordena com Y. e e A segunda coluna mostra o resultado da SELECT usando as regras Almo DIN-1, que diz a que U-diaeresis ordena com U. A terceira coluna mostra o resultado da SELECT usando as regras Almo DIN-2, que diz que a U-diaeresis ordena com UE. Trs collation diferentes, trs resultados diferentes. Isto o que o MySQL est aqui para e e e a tratar. Usando a collation apropriada, voc pode esclher a ordem que voc deseja. e e

720

MySQL Technical Reference for Version 5.0.0-alpha

9.4 Operaoes Afetadas pelo Suporte a Conjunto de c Caracteres

Esta seo descreve operaces que pegam a informao do conjunto de caracteres dentro da ca o ca conta agora.

9.4.1 Strings de Resultados

O MySQL tem muitos operadores e funes que retornam um string. Esta seo responde co ca a questo: Qual o conjunto de caracteres e collation de um certa string? a e Para funes simples que pegam uma string de entrada e retornam uma string de resultado co como sa a sa do conjunto de caracteres e collation so as mesmas da entrada principal. ida, ida a Por exemplo, UPPER(X) retorna uma string cuja string de caracter e collation so os mesmo a de X. O mesmo se aplica a: INSTR(), LCASE(), LOWER(), LTRIM(), MID(), REPEAT(), REPLACE(), REVERSE(), RIGHT(), RPAD(), RTRIM(), SOUNDEX(), SUBSTRING(), TRIM(), UCASE(), UPPER(). (Note tambm: a funo REPLACE(), diferente de todas as outras e ca funes, ignora a collation da string de entrada e realiza uma comparao de caso-insensitivo co ca todas as vezes.) Para operaes que combinam mltiplas entradas de string e retornam uma unica sa de co u ida string, As regras de agregamento do SQL-99 se aplicam. Eles so: a Se ocorrer um COLLATE X explicito, ento use X a Se ocorrerem COLLATE X e COLLATE Y explicitos, ento erro a Seno, se todas as collations so X, ento use X a a a Seno, o resultado no possui collation a a Por exemplo, com CASE ... WHEN a THEN b WHEN b THEN c COLLATE X END, a collation resultante X. O mesmo se aplica a: CONCAT(), GREATEST(), IF(), LEAST(), CASE, UNION, ||, e ELT(). Para operaes que convertem para dados de caracteres, o resultado do conjunto de carco acteres e collation da string esto no connection/literals character set e possuem a cona nection/literals collation. Isto se aplica a: CHAR(), CAST(), CONV(), FORMAT(). HEX(), SPACE().

9.4.2 CONVERT()
CONVERT() fornece um modo de converter dados entre diferentes conjunto de caracteres. A sintaxe : e CONVERT(expr USING transcoding_name) No MySQL, nomes transcodicados so o mesmo que o nomes dos conjuntos de caracteres a correspondentes. Exemplos: SELECT CONVERT(_latin1Mller USING utf8); u INSERT INTO utf8table (utf8column) SELECT CONVERT(latin1field USING utf8) FROM latin1table; CONVERT(... USING ...) implementado de acordo com a especicao SQL-99. e ca

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

721

9.4.3 CAST()
Voc tambm pode usar CAST() para converter uma string para um conjunto de caracteres e e diferente. O novo formato : e CAST ( character_string AS character_data_type CHARACTER SET character_set_name ) Exemplo: SELECT CAST(_latin1test AS CHAR CHARACTER SET utf8); Voc no usar uma clusula COLLATE dentro de um CAST(), mas voc pode us-la fora, isto e a a e a , CAST(... COLLATE ...) ilegal mas CAST(...) COLLATE ... permitido. e e e Exemplo: SELECT CAST(_latin1test AS CHAR CHARACTER SET utf8) COLLATE utf8_bin; Se voc usar CAST() sem especicar CHARACTER SET, ento o conjunto de caracteres e cole a lation resultante so o conjunto de caracteres da conexo/literal e a sua collation padro. a a a Se voc usar CAST() com CHARACTER SET X, ento o conjunto de caracteres resultante X e e a e a collation resultante a collation padro de X. e a

9.4.4 SHOW CHARACTER SET

O comando SHOW CHARACTER SET exibe todos os conjunto de caracteres dsipon iveis. Ele aceita uma clusula LIKE opcional que indica qual nome de conjunto de caracteres coincidir. a Por exemplo: mysql> SHOW CHARACTER SET LIKE latin%; +---------+-----------------------------+-------------------+--------+ | Charset | Description | Default collation | Maxlen | +---------+-----------------------------+-------------------+--------+ | latin1 | ISO 8859-1 West European | latin1_swedish_ci | 1 | | latin2 | ISO 8859-2 Central European | latin2_general_ci | 1 | | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | | latin7 | ISO 8859-13 Baltic | latin7_general_ci | 1 | +---------+-----------------------------+-------------------+--------+ 4 rows in set (0.00 sec) Notas sobre a lista precedente: A coluna Maxlen exie o nmero mximo de bytes usado para armazenar um caracter. u a

9.4.5 SHOW COLLATION

A sa de SHOW COLLATION inclui todos os conjunto de caracteres dispon ida iveis. Ele tem uma clusula LIKE opcional que indice com qual nome de collation que ele deve coincidir. a mysql> SHOW COLLATION LIKE latin1%; +-------------------+---------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +-------------------+---------+----+---------+----------+---------+

722

MySQL Technical Reference for Version 5.0.0-alpha

| latin1_german1_ci | latin1 | 5 | | | 0 | | latin1_swedish_ci | latin1 | 8 | Yes | Yes | 0 | | latin1_danish_ci | latin1 | 15 | | | 0 | | latin1_german2_ci | latin1 | 31 | | Yes | 2 | | latin1_bin | latin1 | 47 | | Yes | 0 | | latin1_general_ci | latin1 | 48 | | | 0 | | latin1_general_cs | latin1 | 49 | | | 0 | +-------------------+---------+----+---------+----------+---------+ 7 rows in set (0.00 sec) A coluna Default indica se uma collation o padro para o seu conjunto de caracteres. e a Compiled indica se o conjunto de caracteres ou no compilado no servidor. Sortlen e a relacionado a quantidade de memria exigida para armazenar strings expressadas no e o conjunto de caracteres.

9.4.6 SHOW CREATE DATABASE

A consulta seguinte mostra uma instruo CREATE DATABASE que criar o banco de dados ca a dado. O resultado inclui todas as opes de banco de dados. DEFAULT CHARACTER SET e co COLLATE so suportados. Todas as opes de banco de dados so armazenadas em um a co a arquivo texto que pode se encontrado no diretrio de banco de dados. o

mysql> SHOW CREATE DATABASE a; +----------+-----------------------------------------------------------------------| Database | Create Database +----------+-----------------------------------------------------------------------| a | CREATE DATABASE a /*!40100 DEFAULT CHARACTER SET macce COLLATE macce_ +----------+-----------------------------------------------------------------------1 row in set (0.00 sec)

9.4.7 SHOW FULL COLUMNS

A instruo SHOW COLUMNS agora mostra as collations das colunas da tabela, quando ca chamado como SHOW FULL COLUMNS. Colunas com tipos de dados CHAR, VARCHAR ou TEXT tem collation no-NULL. Tipos numricos e outros que no seja caracteres tem collations a e a NULL. Por exemplo: mysql> SHOW FULL COLUMNS FROM a; +-------+---------+-------------------+------+-----+---------+-------+ | Field | Type | Collation | Null | Key | Default | Extra | +-------+---------+-------------------+------+-----+---------+-------+ | a | char(1) | latin1_swedish_ci | YES | | NULL | | | b | int(11) | NULL | YES | | NULL | | +-------+---------+-------------------+------+-----+---------+-------+ 2 rows in set (0.02 sec) O conjunto de caracteres no parte do display. a e

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

723

9.5 Suporte Unicode

Existem dois novos conjunto de caracteres para armazenar dados Unicode: ucs2 (o conjunto de caracteres UCS-2 Unicode) e utf8 (a codicao UTF-8 do conjunto de caracteres do ca Unicode). Na UCS-2 (representao Unicode binria) todo caracter representado por um cdigo ca a e o Unicode de dois bytes com o byte mais signicante primeiro. Por exemplo: "LATIN CAPITAL LETTER A" tem o cdigo 0x0041 e armazenado como uma sequncia de o e e dois bytes: 0x00 0x41. "CYRILLIC SMALL LETTER YERU" (Unicode 0x044B) e armazenada como uma sequncia de dois bytes: 0x04 0x4B. Para caracteres Unicode e e seus cdigo veja a Unicode Home Page (http://www.unicode.org/). o Restrio temporria: UCS-2 no pode (ainda) ser usado como um conjunto de caracca a a teres de cliente. Insto signica que SET NAMES ucs2 no funcionar. a a O conjunto de caracteres UTF8 (representaao Unicode trasnformada) um modo alc e ternativo de armazenar dados Unicode. Ele implementado de acordo com a RFC2279. e A idia do conjunto de caracteres UTF8 que vrios caracteres Unicodes cobem em e e a uma sequncia de bytes de tamanhos diferentes. e Letras, digitos e sinais de pontuao do Latin bsico usam um byte. ca a A maioria das letras script da Europa e Oriente Mdio cabem em uma sequncia e e de dois bytes: letras Latin extendidas (com til, agudo, grave e outros acentos), Cir ilico, Grego, Armenio, Hebreu, Arabe, S e outors. irio Idegrafos Coreanos, Chineses e Japoneses usam sequncias de trs bytes. o e e Atualmente, o suporte MySQL UTF8 no inclui sequncias de quatro-bytes. a e Dica: economize spao com UTF8, use VARCHAR em vez de CHAR. Seno, o MySQL tem c a que reservar 30 bytes para uma coluna CHAR(10) CHARACTER SET utf8, pois este o e tamanho mximo poss a ivel.

9.6 UTF8 para Metdados

O metadados o dado sobre o dado. Qualquer coisa que descreva os bancos de dados, como e o opsto de ser o contedo do banco de dados, metadados. Assim nomes de colunas, banco u e de dados, usurios, verses e a maioria dos resultados strings de SHOW, so metadados. a o a Todos os metadados devem estar no mesmo conjunto de caracteres. (Seno, SHOW no funa a cionaria corretamente devido aos diferentes registros na mesma coluna estarem em conjunto de caracteres diferentes). Por outro lado, metadados devem incluir todos os caracteres em todas as linguagens (sen`o os usurios no poderiam nomear as colunas e tabelas na suas a a a prprias linguagens). Para permitir ambos os objetivos, o MySQL armazena metadados em o um conjunto de caracteres Unicode, chamado UTF8. Isto no causa qualquer rompimento a se voc nunca usar caracteres acentuados. Mas se voc zer, dever estar ciente que o e e a metadado est em UTF8. a Isto signica que funes USER() (e seus sinnimos), SESSION_USER() and SYSTEM_USER()), co o CURRENT_USER(), e VERSION() ter o conjunto de caracteres UTF8 por padro. a a Isto NAO signica que o cabealho das colunas e os resultados da funo DESCRIBE estaro c ca a no conjunto de caracteres UTF8 por padro. (Quando voc zer SELECT column1 FROM t o a e

724

MySQL Technical Reference for Version 5.0.0-alpha

nome column1 ser retornado do servidor para o cliente no conjunto de caracteres do cliente a como determinado pela instruo SET NAMES.) ca Se voc quizer que o servidor passe o resultado de volta em um conjunto de caracteres noe a UTF8, ento use SET CHARACTER SET para forar o servidor a converter (veja Seo 9.3.6 a c ca [Charset-connection], Pgina 715), ou congurar o cliente para fazer a a converso, mas esta a a para muitos clientes at no nal no ciclo do produto MySQL opo no estar disponivel ca a a e 4.x. Se voc est apenas usando, por exemplo, a funo USER() para comparao ou atribuio e a ca ca ca dentro de uma unica instruo ... no preocupe. O MySQL far alguma converso au ca a a a tomtica para voc. a e SELECT * FROM Table1 WHERE USER() = latin1_column; Isto funcionar, porque o contedo de latin1_column convertido automaticamente para a u e UTF8 antes da comparao. ca INSERT INTO Table1 (latin1_column) SELECT USER(); Isto funcionar, porque o contudo de USER() convertido automaticamente para latin1 a e e antes da atribuio. A converso automtica ainda no est totalmente implementada, mas ca a a a a deve funcionar corretamente em uma verso posterior. a Embora a converso automtica no esteja no padro SQL, o documento do padro SQL diz a a a a a que todo conjunto de caracteres (em termos de caracteres suportados) um subconjunto e do Unicode. Desde que isto seja um princ ipio bem conhecido que o que aplica a um superconjunto pode ser aplicado a um subconjunto, acreditamos que uma collation para Unicode pode ser aplicado para comparaes com strings no -Unicode. co a NATA DA VERSAO 4.1.1: Os arquivos errmsg.txt estaro todos em UTF8 depois deste a ponto. Converso o conjunto de caracteres do clientes sero automticos, como para metadaa a a dos. Tambm: Podemos alterar o comportamento padro para passar de volta o metadado e a do resultado em um futuro prximo. o

9.7 Compatibilidade com Outros SGBDs

Para compatibilidade com o SAP DB estas duas instrues so a mesma: co a CREATE TABLE t1 (f1 CHAR(n) UNICODE); CREATE TABLE t1 (f1 CHAR(n) CHARACTER SET ucs2);

9.8 Novo Formato do Arquivo de Congurao do Conjunto ca de Caracteres

No MySQL 4.1, a congurao de um conjunto de caracteres armazenado em um arquivo ca e XML, um arquivo por conjunto de caracteres (na verso anterior, esta informao era a ca armazenada em arquivos .conf)

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

725

9.9 Conjunto de Caracteres Nacional

No MySQL-4.x e mais novos, NCHAR e CHAR eram sinnimos. ANSI dene NCHAR ou NATIONAL o CHAR como um modo de denir que uma coluna CHAR deve usar alguns conjuntos de caracteres predenidos. O MySQL usa utf8 como o conjunto de caracteres predenido. Por exemplo, estas declaraes de tipos de colunas so equivalentes: co a CHAR(10) CHARACTER SET utf8 NATIONAL CHARACTER(10) NCHAR(10) Como estas: VARCHAR(10) CHARACTER SET utf8 NATIONAL VARCHAR(10) NCHAR VARCHAR(10) NATIONAL CHARACTER VARYING(10) NATIONAL CHAR VARYING(10) Voc pode usar Nliteral para criar uma string em um conjunto de caracteres nacional. e Estas duas instrues so equivaletes: co a SELECT Nsome text; SELECT _utf8some text;

9.10 Atualizando para o MySQL 4.0

Agora, e sobre a atalizao de verses mais antigas do MySQL? o MySQL 4.1 quase ca o e compaivel com o MySQL 4.0 e verses anteriores pela simples razo que quase todos os o a recursos so novos, ento no h nada em verses anteriores que conitem com ele. No a a a a o entanto, existem algumas diferenas e poucas coisas com as quais deve estar ciente. c O mais importante: O conjunto de caracteres do MySQL 4.0 tem as propriedades do conjunto de caracteres do MySQL 4.1 e da collation do MySQL 4.1. Voc ter que e a desaprender isto. qui pra frente no iremos empacotar o conjunto de caracteres e a collation a no mesmo objeto. Existe um tratamento especial do conjunto de caracteres nacional no MySQL 4.1. NCHAR no o mesmo que CHAR e literais N... no so o mesmo dos literais .... a e a a Finalmente, existe um formato de arquivo diferente para armazenar informaes co sobre conjunto de caracteres e collation. Esteja certo que voc reinstalou o diretrio e o /share/mysql/charsets/ contendo o novo arquivo de conguraes. co Se voc quiser iniciar o mysqld de uma distribuio 4.1.x com dados craidos pelo MySQL e ca 4.0, voc deve iniciar o servidor com o mesmo conjunto de caracteres e collation. Neste caso e voc no precisar de reindexar os dados. e a a Existem dois modos de faz-lo: e shell> ./configure --with-character-set=... --with-collation=... shell> ./mysqld --default-character-set=... --default-collation=... Se voc usou o mysql com, por exemplo, oconjunto de caracteres danish do MySQL 4.0, e voc agora deve usar o conjunto de caracteres latin1 e a collation latin1_danish_ci: e

726

MySQL Technical Reference for Version 5.0.0-alpha

shell> ./configure --with-character-set=latin1 --with-collation=latin1_danish_ci shell> ./mysqld --default-character-set=latin1 --default-collation=latin1_danish_ci Use a tabela mostrada na prxima seo para encontrar o nome do antigo conjunto de o ca caracteres do MySQL 4.0 e o par conjunto de caracteres/collation equivalente no MySQL 4.1.

9.10.1 Conjunto de Caracteres do MySQL e o Par/Conjunto de Caracter/Collation Correspondente do MySQL 4.1

ID 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Conjunto de Caracter - 4.0 big5 czech dec8 dos german1 hp8 koi8_ru latin1 latin2 swe7 usa7 ujis sjis cp1251 danish hebrew win1251 tis620 euc_kr estonia hungarian koi8_ukr win1251ukr gb2312 greek win1250 croat gbk cp1257 latin5 latin1_de Conjunto de Caracter - 4.1 big5 latin2 dec8 cp850 latin1 hp8 koi8r latin1 latin2 swe7 ascii ujis sjis cp1251 latin1 hebrew (removed) tis620 euckr latin7 latin2 koi8u cp1251 gb2312 greek cp1250 latin2 gbk cp1257 latin5 latin1 Collation - 4.1 big5_chinese_ci latin2_czech_ci dec8_swedish_ci cp850_general_ci latin1_german1_ci hp8_english_ci koi8r_general_ci latin1_swedish_ci latin2_general_ci swe7_swedish_ci ascii_general_ci ujis_japanese_ci sjis_japanese_ci cp1251_bulgarian_ci latin1_danish_ci hebrew_general_ci (removed) tis620_thai_ci euckr_korean_ci latin7_estonian_ci latin2_hungarian_ci koi8u_ukrainian_ci cp1251_ukrainian_ci gb2312_chinese_ci greek_general_ci cp1250_general_ci latin2_croatian_ci gbk_chinese_ci cp1257_lithuanian_ci latin5_turkish_ci latin1_german2_ci

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

727

9.11 Os conjuntos de Caracteres e Collations que o MySQL Suporta

Aqui est uma lista do conjunto de caracter e collation que o MySQL suporta. Como as a opes e congurao de instalao diferem, alguns sites no tero todos os itens da lista, co ca ca a a e alguns sites tero itens que no esto na lista porque a denio de novos conjunto de a a a ca caracteres e collation direto. e O MySQL suporta mais de 70 collations e mais de 30 conjunto de caracteres. mysql> SHOW CHARACTER SET; +----------+-----------------------------+---------------------+--------+ | Charset | Description | Default collation | Maxlen | +----------+-----------------------------+---------------------+--------+ | big5 | Big5 Traditional Chinese | big5_chinese_ci | 2 | | dec8 | DEC West European | dec8_swedish_ci | 1 | | cp850 | DOS West European | cp850_general_ci | 1 | | hp8 | HP West European | hp8_english_ci | 1 | | koi8r | KOI8-R Relcom Russian | koi8r_general_ci | 1 | | latin1 | ISO 8859-1 West European | latin1_swedish_ci | 1 | | latin2 | ISO 8859-2 Central European | latin2_general_ci | 1 | | swe7 | 7bit Swedish | swe7_swedish_ci | 1 | | ascii | US ASCII | ascii_general_ci | 1 | | ujis | EUC-JP Japanese | ujis_japanese_ci | 3 | | sjis | Shift-JIS Japanese | sjis_japanese_ci | 2 | | cp1251 | Windows Cyrillic | cp1251_bulgarian_ci | 1 | | hebrew | ISO 8859-8 Hebrew | hebrew_general_ci | 1 | | tis620 | TIS620 Thai | tis620_thai_ci | 1 | | euckr | EUC-KR Korean | euckr_korean_ci | 2 | | koi8u | KOI8-U Ukrainian | koi8u_general_ci | 1 | | gb2312 | GB2312 Simplified Chinese | gb2312_chinese_ci | 2 | | greek | ISO 8859-7 Greek | greek_general_ci | 1 | | cp1250 | Windows Central European | cp1250_general_ci | 1 | | gbk | GBK Simplified Chinese | gbk_chinese_ci | 2 | | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | | armscii8 | ARMSCII-8 Armenian | armscii8_general_ci | 1 | | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | | ucs2 | UCS-2 Unicode | ucs2_general_ci | 2 | | cp866 | DOS Russian | cp866_general_ci | 1 | | keybcs2 | DOS Kamenicky Czech-Slovak | keybcs2_general_ci | 1 | | macce | Mac Central European | macce_general_ci | 1 | | macroman | Mac West European | macroman_general_ci | 1 | | cp852 | DOS Central European | cp852_general_ci | 1 | | latin7 | ISO 8859-13 Baltic | latin7_general_ci | 1 | | cp1256 | Windows Arabic | cp1256_general_ci | 1 | | cp1257 | Windows Baltic | cp1257_general_ci | 1 | | binary | Binary pseudo charset | binary | 1 | +----------+-----------------------------+---------------------+--------+ 33 rows in set (0.01 sec)

728

MySQL Technical Reference for Version 5.0.0-alpha

NB: TODOS OS CONJUNTO DE CARACTERES TEM UMA COLLATION BINARIA. INCLU NAO IMOS A COLLATION BINARIA EM TODAS AS DESCRICOES A SEGUIR.

9.11.1 O Conjunto de Caracteres Unicode

E claro que existem os nossos dois conjuntos de caracteres Unicode. Voc pode armazenar e texto em cerca de 650 l inguas usando estes conjunto de caracteres. No adicionamos um a grande nmero de collations para estes dois novos conjuntos ainda, mas isto acontecer u a logo. Agora eles possuem a collation caso-insensitivo e acento-insensitivo, mais a collation binria. a +---------+-----------------+-------------------+--------+ | Charset | Description | Default collation | Maxlen | +---------+-----------------+-------------------+--------+ | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | | ucs2 | UCS-2 Unicode | ucs2_general_ci | 2 | +---------+-----------------+-------------------+--------+

9.11.2 Conjunto de Caracteres para Plataformas Espec icas

+----------+-----------------------------+---------------------+--------+ | Charset | Description | Default collation | Maxlen | +----------+-----------------------------+---------------------+--------+ | dec8 | DEC West European | dec8_swedish_ci | 1 | | hp8 | HP West European | hp8_english_ci | 1 | +----------+-----------------------------+---------------------+--------+

9.11.3 Conjunto de Caracteres do Sul da Europa e Oriente Mdio e

+----------+-----------------------------+---------------------+--------+ | Charset | Description | Default collation | Maxlen | +----------+-----------------------------+---------------------+--------+ | armscii8 | ARMSCII-8 Armenian | armscii8_general_ci | 1 | | cp1256 | Windows Arabic | cp1256_general_ci | 1 | | hebrew | ISO 8859-8 Hebrew | hebrew_general_ci | 1 | | greek | ISO 8859-7 Greek | greek_general_ci | 1 | | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | | geostd8 | Georgian | geostd8_general_ci | 1 | +----------+-----------------------------+---------------------+--------+

9.11.4 Os Conjuntos de Caracteres Asiticos a

O conjunto de caracteres Asitico que suportamos inclui Chins, Japons, Coreano e Taia e e lands. Estes podem ser complicados. Por exemplo, o conjunto Chins devem permitir e e milhares de caracteres diferentes. +----------+-----------------------------+---------------------+--------+ | Charset | Description | Default collation | Maxlen |

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

729

+----------+-----------------------------+---------------------+--------+ | big5 | Big5 Traditional Chinese | big5_chinese_ci | 2 | | gb2312 | GB2312 Simplified Chinese | gb2312_chinese_ci | 2 | | gbk | GBK Simplified Chinese | gbk_chinese_ci | 2 | | euckr | EUC-KR Korean | euckr_korean_ci | 2 | | ujis | EUC-JP Japanese | ujis_japanese_ci | 3 | | sjis | Shift-JIS Japanese | sjis_japanese_ci | 2 | | tis620 | TIS620 Thai | tis620_thai_ci | 1 | +----------+-----------------------------+---------------------+--------+

9.11.5 Os Conjuntos de Caracteres Blticos a

O conjunto de caracter Bltico cobre as linguagens da Estonia, Letnia e Litunia. Existem a o a dois conjunto de caracteres Blticos suportados: a latin7 (ISO 8859-13 Baltic): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | latin7_estonian_cs | latin7 | 20 | | | 0 | | latin7_general_ci | latin7 | 41 | Yes | | 0 | | latin7_general_cs | latin7 | 42 | | | 0 | | latin7_bin | latin7 | 79 | | | 0 | +----------------------+----------+----+---------+----------+---------+ cp1257 (Windows Baltic): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp1257_lithuanian_ci | cp1257 | 29 | | | 0 | | cp1257_bin | cp1257 | 58 | | | 0 | | cp1257_general_ci | cp1257 | 59 | Yes | | 0 | +----------------------+----------+----+---------+----------+---------+

9.11.6 Os Conjuntos de Caracteres Cir ilicos

Aqui esto os conjunto de caracteres e collation cir a ilicos para uso com as linguagens Belarssia, Blgaro, Russo e Ucraniano. u u cp1251 (Windows Cyrillic): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp1251_bulgarian_ci | cp1251 | 14 | | | 0 | | cp1251_ukrainian_ci | cp1251 | 23 | | | 0 | | cp1251_bin | cp1251 | 50 | | | 0 | | cp1251_general_ci | cp1251 | 51 | Yes | | 0 | | cp1251_general_cs | cp1251 | 52 | | | 0 |

730

MySQL Technical Reference for Version 5.0.0-alpha

+----------------------+----------+----+---------+----------+---------+ cp866 (DOS Russian): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp866_general_ci | cp866 | 36 | Yes | | 0 | | cp866_bin | cp866 | 68 | | | 0 | +----------------------+----------+----+---------+----------+---------+ koi8r (KOI8-R Relcom Russian, primarily used in Russia on Unix): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | koi8r_general_ci | koi8r | 7 | Yes | | 0 | | koi8r_bin | koi8r | 74 | | | 0 | +----------------------+----------+----+---------+----------+---------+ koi8u (KOI8-U Ukrainian, primarily used in Ukraine on Unix): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | koi8u_general_ci | koi8u | 22 | Yes | | 0 | | koi8u_bin | koi8u | 75 | | | 0 | +----------------------+----------+----+---------+----------+---------+

9.11.7 O Conjunto de Caracteres da Europa Central

Temos algum suporte para conjunto de caracteres usados na Repblica Tcheca, Eslovquia, u a Hungria, Romnia, Eslovnia, Crocia e Polnia. e e a o cp1250 (Windows Central European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp1250_general_ci | cp1250 | 26 | Yes | | 0 | | cp1250_czech_ci | cp1250 | 34 | | Yes | 2 | | cp1250_bin | cp1250 | 66 | | | 0 | +----------------------+----------+----+---------+----------+---------+ cp852 (DOS Central European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp852_general_ci | cp852 | 40 | Yes | | 0 | | cp852_bin | cp852 | 81 | | | 0 | +----------------------+----------+----+---------+----------+---------+ macce (Mac Central European): +----------------------+----------+----+---------+----------+---------+

Cap tulo 9: Conjunto de Caracteres Nacionais e Unicode

731

| Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | macce_general_ci | macce | 38 | Yes | | 0 | | macce_bin | macce | 43 | | | 0 | +----------------------+----------+----+---------+----------+---------+ latin2 (ISO 8859-2 Central European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | latin2_czech_ci | latin2 | 2 | | Yes | 4 | | latin2_general_ci | latin2 | 9 | Yes | | 0 | | latin2_hungarian_ci | latin2 | 21 | | | 0 | | latin2_croatian_ci | latin2 | 27 | | | 0 | | latin2_bin | latin2 | 77 | | | 0 | +----------------------+----------+----+---------+----------+---------+ keybcs2 (DOS Kamenicky Czech-Slovak): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | keybcs2_general_ci | keybcs2 | 37 | Yes | | 0 | | keybcs2_bin | keybcs2 | 73 | | | 0 | +----------------------+----------+----+---------+----------+---------+

9.11.8 Os Conjuntos de Caracteres da Europa Ocidental

O Cojunto de Caracteres da Europa Ocidental cobre a maioria das linguagens desta regio a como Francs, Espanhol, Catalo, Basco, Portugus, Italiano, Albans, Holands, Alemo, e a e e e a Finlandes, Dinamarqus, Sueco, Noruegus, Faroese, Islands, Irlands, Escocs e Ingls e e e e e e latin1 (ISO 8859-1 West European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | latin1_german1_ci | latin1 | 5 | | | 0 | | latin1_swedish_ci | latin1 | 8 | Yes | Yes | 0 | | latin1_danish_ci | latin1 | 15 | | | 0 | | latin1_german2_ci | latin1 | 31 | | Yes | 2 | | latin1_bin | latin1 | 47 | | Yes | 0 | | latin1_general_ci | latin1 | 48 | | | 0 | | latin1_general_cs | latin1 | 49 | | | 0 | +----------------------+----------+----+---------+----------+---------+ A collation latin1_swedish_ci o padro que provavelmente usado pela maioria e a e dos usurios do MySQL. E constantemente indicado que ele baseado nas regras de a e collation do Suco/Finlands, mas voc encontrar Sucos e Finlandeses que descordam e e e a e desta armao. ca

732

MySQL Technical Reference for Version 5.0.0-alpha

As collations latin1_german1_ci e latin1_german2_ci so baseadas nos padres a o DIN-1 e DIN-2, onde DIN signica Deutsches Institut fr Normung (isto , a resposta u e Alem ao ANSI). DIN-1 chamada collation de dicionrio e o DIN-2 chamado a a e a e collation de agenda. Regras latin1_german1_ci (dicionrios): a = A, = O, = U, = s A O U Regras latin1_german2_ci (agendas): = AE, = OE, = UE, = ss A O U macroman (Mac West European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | macroman_general_ci | macroman | 39 | Yes | | 0 | | macroman_bin | macroman | 53 | | | 0 | +----------------------+----------+----+---------+----------+---------+ cp850 (DOS West European): +----------------------+----------+----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +----------------------+----------+----+---------+----------+---------+ | cp850_general_ci | cp850 | 4 | Yes | | 0 | | cp850_bin | cp850 | 80 | | | 0 | +----------------------+----------+----+---------+----------+---------+

Cap tulo 10: Extenses Espacias em MySQL o

733

10 Extenses Espacias em MySQL o

O MySQL 4.1 introduz extenses espaciais para permitir gerar, armazenar e analisar recuro sos geogrcos. Atualmente estes recursos esto disponiveis apenas para tabelas MyISAM. a a Este cap itulo cobre os seguintes tpicos: o A base destas extenses espaciais no modelo OpenGIS o Formato de dados para representao de dados espaciais ca Como usar dados espaciais no MySQL Uso do indice para dados espaciais Diferenas do MySQL para a especicao OpenGIS c ca

10.1 Introduo ca
O MySQL implementea extenses espaciais seguindo especicaes do Open GIS o co Consortium (OGC). Este um consrcio internacional com mais de 250 companhias, e o agncias, universidades participando no desenvolvimento de solues conceituais e co dispon iveis publicamente que podem der uteis com todos os tipos de aplicaes que co gerenciam dados espaciais. O OGC mantm um web site em http://www.opengis.org/. e Em 1997, o Open GIS Consortium publicou o OpenGIS R Simple Features Specications For SQL (Especicaes de Recursos OpenGIS R Simples Para SQL), um docuco mento que propos diversos modos conceituais de para extender um SQL RDBMS para suportar dados espaciais. Esta especicao est dispon ca a ivel no web site do OpenGIS em http://www.opengis.org/techno/implementation.htm. Ele contm informaes adie co cionais relevantes a este cap itulo. O MySQL implementa um subconjunto do ambiente SQL com Tipos Geomtricos proposto e pela OGC. Este termo se refere a um ambiente SQL que tem sido extendido com um conjunto de tipos geomrtricos. Uma coluna SQL com valor geomtrico implementada e e e como uma coluna de um tipo geomtrico. As especicaes descrevem um conjunto de tipod e co geomtricos do SQL, bem como funes deste tipo para criar e analisar valores geomtricos. e co e Um recurso geogrco qualquer coisa no mundo que tem uma posio. a e ca Um recurso pode ser: Uma entidade. Por exemplo, uma montanha, uma lagoa, em cidade Um espao. Por exemplo, um rea de cdigo postal, os trpicos c a o o Uma localizao denida. Por exemplo, um cruzamento. como um lugar espec ca ico onde duas ruas se interceptam. Voc tambm pode encontrar documentos que utilizam o termo recurso geoespacial para se e e referir a recursos geogrcos. a Geometria outra palavra que denota um recurso geogrco. O signicado original da e a palavra geometria denota um ramo da matemtica. Outro signicado vindo da cartograa, a se referem aos recursos geomtricos que os cartgrafos usam para mapear o mundo. e o Este cap itulo utiliza todos estes termos como sinnimo: recurso geogrco, recurso geoeso a pacial, recurso ou geometria, O termo normalmente mais usado aqui geometry. e Vamos denir uma geometria como um ponto ou um agregado de pontos representando alguma coisa no mundo que possui uma localizao. ca

734

MySQL Technical Reference for Version 5.0.0-alpha

10.2 O Modelo Geomtrico OpenGIS a

O conjunto de tipos geomtricos, proposto pelo ambiente SQL com Tipos Geomtricos da e e OGC, base do Modelo Geomtrico OpenGIS. Neste modelo, cada objeto geomtrico tem e e e as seguintes propriedades gerais: associado com um Sistema de Referncia Espacial, que descreve a coordenada espacial, e e na qual o objeto denido. e pertence a alguma classe geomtrica. e

10.2.1 A Hierarquia da Classe Geometry

As classes geometry denem uma hierarquia como a seguir: Geometry (no-instancivel) a a Point (instancivel) a Curve (no-instancivel) a a LineString (instancivel) a Line LinearRing Surface (no-instancivel) a a Polygon (instancivel) a GeometryCollection (instancivel) a MultiPoint (instancivel) a MultiCurve (no-instancivel) a a MultiLineString (instancivel) a MultiSurface (no-instancivel) a a MultiPolygon (instancivel) a Algumas destas classes so abstratas (no-instancivel). Isto , no poss a a a e a e ivel criar um objeto desta classe. Outras classes so instanciveis e objetos podem ser criados deles. a a Cada classe tem propriedades e podem ter declaraes (regras que denem intncias de co a classes vlidas). a Geometry a classe base. E uma classe abstrata (no-instancivel). As subclasses ine a a stanciveis de Geometry so restritas a objetos geomtricos de zero, uma e duas dimenses a a e o que existem no espeao de coordenadas bidimensional. Todas as classes geomtricas inc e stanciveis so denidas para que instncias vlidas da classe geometry so topologicamente a a a a a fechados (isto , todas as geometrias denidas incluem seus limites). e A classe base Geometry tem subclasses para Point, Curve, Surface e GeometryCollection: Point representam objetos sem dimenso. a Curve representam para objetos de uma dimenso, e tem a subclasse LineString, com a subclasses Line e LinearRing. Surface criado para objetos bidimensionais e tem a subclasse Polygon. e

Cap tulo 10: Extenses Espacias em MySQL o

735

GeometryCollection tem classes de coleo com zero-, uma- e duas-dimenses ca o chamadas MultiPoint, MultiLineString e MultiPolygon para modelagem geomtrica correspondente a colees de Points, LineStrings e Polygons e co respectivamente. MultiCurve e MultiSurface so introduzidas como superclasses a abastratas que generalizam a interface de coleo para tratar Curves e Surfaces. ca Geometry, Curve, Surface, MultiCurve e MultiSurface so denidos como classes no a a instanciveis. Eles denem em conjunto de mtodos comuns para suas subclasses e incluidos a e por razes de extensabilidade. o Point, LineString, Polygon, GeometryCollection, MultiPoint, MultiLineString, MultiPolygon so classses instanciveis. a a

10.2.2 Classe Geometry

Geometry a classe raiz da hierarquia. E uma classe no instancivel mas possui vria e a a a propriedades comuns a todos os valores de geometria de qualquer das subclasses Geometry. Estas propriedades esto descritas na lista a seguir ( Subclasses particulares tem as suas a prprias propriedades espec o icas, descritas posteriormente):

Propriedades de geometria
Um valor geometry tem as seguintes propriedades: E o tipo (type). Cada geometria pertence a uma das classes instanciveis na hierarquia. a Seu SRID ou Identicador de Referncia Espacial. Este valor identica o Sistema de e Referncia Espacial associada da geometria, o qual descreve o coordenada espacial na e qual objeto geomtrico est denido. a Coordenadas (coordinates) em seu Sistema de Referncia Espacial, representado por e um nmero de preciso dupla (8 byte). Todas as geometrias no-vazias incluem pelo u a a menos um par de coordenadas (X,Y). Geometrias vazias no contem cooredenadas. a Coordenadas esto relacionadas ao SRID. Por exemplo, em sistemas de coordenadas a diferentes, a distncia entre dois objetos podem diferir mesmo quando os objetos tm a e as mesmas coordenadas, porque as distncias no sistema de coordenadas planar e a a distncia no sistema geocentrico (coordenadas na superf da Terra) so coisas difera icie a entes. Seu interior (interior), limite (boundary) e exterior (exterior). Todas as geometrias ocupam alguma poro no espao. O exterior de uma geomeca c tria todo espao no ocupado pela geometria. O interiro o espeao ocupado pela e c a e c geometria. O limite a interface entre o interior e o exterior e Seu MBR (Retngulo de Limite M a inimo - Minimum Bounding Rectangle), ou Envelope, da geometria. Este a geometria limitar, formado pelas coordenadas de m e inimo e mximo (X,Y): a ((MINX MINY, MAXX MINY, MAXX MAXY, MINX MAXY, MINX MINY)) A qualidade de ser simple ou non-simple (simples ou no simples). Valores geometricos a alguns tipos (LineString, Multipoint, MultiLineString) podem ser simples ou noa simples. Cada tipo determina sua prrpia armao de ser simples ou no-simples. o ca a

736

MySQL Technical Reference for Version 5.0.0-alpha

A qualidade de ser closed ou not closed (fechado ou no fechado). Valores geomtricos a e de alguns tipos (LineString, MultiString) podem ser fechado ou no fechado. Cada a tipo determina a sua prpria armao de ser fechado ou no fachado. o ca a A qualidade de ser empty ou not empty (vazio ou no vazio). Uma geometria vazia se a e ela no tem nenhum ponto. Exterior, interior e limite de ma geometria vazia no esto a a a denidos. (isto , eles so representados por valores NULL). Uma geometria vazia e a e denida sempre simples e ter um rea de 0. a Sua dimenso (dimension). Uma geometria pode ter uma dimenso de 1, 0, 1 or 2: a a 1 usado para geometrias vazias 0 usado para geometrias sem tamanho e sem area. 1 usado para geometrias com tamanho diferente de zero e sem area. 2 usado para geometrias com area diferente de zero. Points tem uma dimensio de zero. LineStrings tem uma dimenso de 1. a a Polygons tem uma dimenso de 2. Dimenses de MultiPoints, MultiLineStrings e a o MultiPolygons so a mesma da dimenso dos elementos dos quais eles consistem. a e a

10.2.3 Classe Point

Um Point uma geometria que representa um unico local no espao coordenado. e c

Exemplos de Point
Imagine um mapa do munod de larga-escala com muitas cidades. Um ponto poderia representar cada cidade. Em um mapa da cidade, um Point poderia epresntar uma parada de onibus.

Propriedades de Point
Valor de coordenada X. Valor da coordenada Y. O Point denido como uma geometria de dimenso zero. e a O limite de um Point um conjunto vazio. e

10.2.4 Classe Curve

Uma Curve uma geometria unidimensional, normalmente representado por uma sequncia e e de pontos. Subclasses particulares de Curve dene o tipo de interpolao entre pontos. ca Curve uma classe no-instancivel. e a a

Propriedades de Curve
As coordenadas de seus pontos. Curve deniido como uma geometria unidimensional. e

Cap tulo 10: Extenses Espacias em MySQL o

737

A Curve simples (simple) se ela no passa pelo mesmo ponto duas vezes. e a A Curve fechada (closed) se o ponto inicial igual ao ponto nal. e e O limite (boundary) de uma Curve fechada vazio. e O limite (boundary) de uma Curve no-fachada cociste do seus dois pontos nais. a A Curve que simples (simple) e fechada (closed) uma LinearRing. e e

10.2.5 Classe LineString

Uma LineString uma Curve com interpolao linear entre pontos. e ca

Exemplos de LineString
Em um mapa mundi uma LineStrings poderia representar os rios. Um um mapa da cidade uma LineStrings poderia respresntar ruas.

Propriedades LineString
Coordenadas de segmentos LineString denidos por cada par de pontos consecutivos. Uma LineString uma Line, se ela consiste de exatamente dois pontos. e A LineString uma LinearRing, se for fechada (closed) e simples (simple). e

10.2.6 Classe Surface

Uma Surface uma geometria bidimensional. Ele uma classe no instancivel. Sua unica e e a a subclasse instancivel Polygon. a e

Propriedades de Surface
Uma Surface denida com uma geomtria bidimensional. e A especicao OpenGIS dene uma Surface simples como uma geometria que consiste ca de um unico patch que associado com um exterior boundary (limite exterior) e zero e ou mais interior boundaries (limites interiores). O limite (boundary) de uma Surface simples o conjunto de curvas fechadas corree spondente a seus limites exterior e interior.

10.2.7 Classe Polygon

Um Polygon uma Surface planar representando uma geometria multi-lados. Ela e e denida por um limite exterior e zero ou mais limites interiores, onde cada limite interior dene um buraco no Polygon.

738

MySQL Technical Reference for Version 5.0.0-alpha

Exemplos de Polygon
Em um mapa de regio, objetos Polygon podem representar orestas, distritos, etc. a As armaes para os polygons (as regras que denem polygons vlidos) so: co a a 1. O limite (boundary) de um Polygon consiste de um conjunto de LinearRings (ex. LineStrings que so simples e fechadas) que fazem os seus limites interior e exterior. a 2. Dois aneis no limite no podem se cruzar. Os aneis no limite de um Polygon podem a se interseptar em um Point, mas apenas como uma tangente. 3. Um Polygon no pode ter linhas cortadas, pontas ou cavidades. a 4. O interior de cada Polygon e um conjunto de pontos conectados. 5. O Exterior de um Polygon com um ou mais buracos no est conectado. Cada buraco a a dene um componenete conectados do exterior. Nas armaes acimas, poligonos so geometrias simples. Estas armaes fazem de um co a co Polygon uma geometria simples.

10.2.8 Classe GeometryCollection

Um GeometryCollection uma geometria que um coleo de um ou mais geometrias de e e ca qualquer classe. Todos os elementos em uma GeometryCollection deve estar no mesmo Sistema de Referncia Espacial (ex. no mesmo sistema de coordenadas). GeometryCollection no coloca e a nenhuma outra restrio em seus elementos, embora as subclasses de GeometryCollection ca descritas abaixo possam restringir membros com base em: Tipo de Elementos (por exemplo, um MultiPoint pode conter apenas elementos Point Dimenso. a Restries no grau de sobreposio espacial entre elementos. co ca

10.2.9 Classe MultiPoint

Um MultiPoint uma coleo de geometrias compostas de elementos Point. Os pontos e ca no esto conectados ou ordenados de forma alguma. a a

Exemplos de MultiPoint
Em um mapa mundi, um Multipoint podia representar uma cadeia de pequenas ilhas.

Propriedades de MultiPoint
MultiPoint denido com uma geometria sem dimenso. e a Um MultiPoint simples se no h dois valores de seus Point iguais no MultiPoint e a a (tem valores de coordenadas iguais). O limite (boundary) de um MultiPoint um conjunto vazio. e

Cap tulo 10: Extenses Espacias em MySQL o

739

10.2.10 Classe MultiCurve

Uma MultiCurve uma coleo de geometria compostas de elementos Curve. MultiCurve e ca uma classe no instancivel. e a a

Propriedades de MultiCurve
A MultiCurve denida como uma geometria de uma dimenso. e a A MultiCurve simples se e somente se todos os seus elementos so simples, a unica e a interseo entre quaisquer dois elementos ocorrem entre pontos que esto nos limites ca a (boundaries) de ambos os elementos. O limite (boundary) de uma MultiCurve obtida aplicando a "mod 2 union rule": e Um ponto est no limite (boundary) de uma MultiCurve se ele est no limite de um a a nmero impar de elementos da MultiCurve. u Um MultiCurve fechado se todos os seus elementos so fechados. e a O limite de uma MultiCurve fechada e sempre vazio.

10.2.11 Classe MultiLineString (Multi Linhas)

Um MultiLineString uma coleo de geomtrias MultiCurve composto de elementos e ca e LineString.

MultiLineString
Em uma mapa regional, um MultiLineString pode represntar um rede hidrograca ou uma malha de rodovias.

10.2.12 Classe MultiSurface (Multi Superf icies)

Um MultiSurface uma coleo geometrica compostos de elementos de superf Multie ca icie Surface uma classe no instancivel. Sua unica subclasse instancivel MultiPolygon e a a a e

Armaoes de MultiSurface c
1. O interior de quaisquer duas superf icies em uma MultiSurface no podem se intera ceptar. 2. O limite de quaiqsquer dois elementos em um MultiSurface podem interceptar em um nmero nito de pontos. u

10.2.13 Classe MultiPolygon (Multi Pol igonos)

Um MultiPolygon um objeto MultiSurface compostos de elementos Polygon. e

Exemplos de MultiPolygon
Em um mapa regional, um MultiPolygon pode representar um sistema de lagos.

740

MySQL Technical Reference for Version 5.0.0-alpha

As araoes dos MultiPolygons so: c a

1. O interior de dois valores Polygon que so elementos de um MultiPolygon no podem a a interceptar. 2. Os limites (Boundaries) de quaisquer dois valores Polygon que so elementos de um a MultiPolygon no podem cruzar e pode se tocar em um nmero nito de pontos. (O a u cruzamento tambm proibido pela primeira armao.) e e ca 3. Um MultiPolygon no pode ter linhas cortadas, pontas ou cavidades. Um MultiPolya gon um conjunto de pontos regular e fechado. e 4. O interior de um MultiPolygon composto por mais de um Polygon no est conectado, a a o nmero de componentes conectados do interior de um MultiPolygon igual ao u e nmero de valores Polygon no MultiPolygon. u

Propriedades de MultiPolygon
MultiPolygon denido como uma geometria bidimensional. e O limite (boundary) de um MultiPolygon um conjunto de curvas fechadas (valores e LineStrings) correspondente ao limite dos valores seus elementos Polygon. Cada Curve no limite do MultiPolygon este no limite de exatamente um elemento Polygon. Toda Curve no limite de um elemento Polygon est no limite do MultiPolygon. a

10.3 Formatos de Dados Espaciais Suportados

Esta seo descreve o formato de dados espaciais padro que so utilizados para representar ca a a objetos geometry em consultas. Eles so: a Formato Well-Known Text (WKT). Formato Well-Known Binary (WKB). Internamente, o MySQL armazena valores geometry em um formato que no identico nem a e ao format WKT ou WKB.

10.3.1 Formato Well-Known Text (WKT)

A representao Well-Known Text (WKT) de Geometry criada para troca de dados de ca e geometria na forma ASCII. Exemplos de representaes WKT representations de objetos geometry so: co a Um Point (ponto). POINT(15 20) Note que pontos coordenados so especicados sem separo por v a ca irgulas. Um LineString (linha) com quatro pontos. LINESTRING(0 0, 10 10, 20 25, 50 60)

Cap tulo 10: Extenses Espacias em MySQL o

741

Um Polygon (pol igono) com um anel exterior e um anl interior. e POLYGON((0 0,10 0,10 10,0 10,0 0),(5 5,7 5,7 7,5 7, 5 5)) Um MultiPoint (multipontos) com trs valores Points. e MULTIPOINT(0 0, 20 20, 60 60) Um MultiLineString (multi linhas) com dois valores LineString. MULTILINESTRING((10 10, 20 20), (15 15, 30 15)) Um MultiPolygon (multi pol igonos) com dois valores Polygon. MULTIPOLYGON(((0 0,10 0,10 10,0 10,0 0)),((5 5,7 5,7 7,5 7, 5 5))) Um GeometryCollection (Coleo de Geometria) consistindo de dois valores Points ca e um LineString. GEOMETRYCOLLECTION(POINT(10 10), POINT(30 30), LINESTRING(15 15, 20 20)) Uma gramtica Backus-Naur que especica as regras de produo formal para gravar valores a ca WKT podem ser encontrados na documentao de especicao OGC indicada prximo ao ca ca o in deste cap icio itulo.

10.3.2 Formato Well-Known Binary (WKB)

A representao Well-Known Binary (WKB) para valores geomtricos denida pela esca e e pecicao OpenGIS. Ela tambm denida no padro ISO "SQL/MM Part 3: Spatial". ca e e a WKB usado para trocar dados geometry como uxos binrios representados por valores e a BLOB contendop informaes geomtricas WKB. co e WKB usa inteiros sem sinal de 1-byte e 4-byte e nmeros de preciso dupla de 8-byte u a (formato IEEE 754). Um byte 8 bits. e Por exemplo, um valor WKB que corresonde a POINT(1 1) consiste desta sequncia de 21 e bytes (cada um representado aqui por dois digitos hexa): 0101000000000000000000F03F000000000000F03F A sequncia pode ser quebrada nestes componentes: e Byte order : 01 WKB type : 01000000 X : 000000000000F03F Y : 000000000000F03F A respresentao do componente est a seguir: ca a O byte order pode ser de 0 ou 1 para indicar o tipo little-endian ou big-endian. Os byte orders little-endian e big-endian tambm so conhecidos como Network Data Repree a sentation - Representao de Dados de Rede (NDR) e External Data Representation ca Representao de Dados Externos (XDR), repectivamente. ca O tipo WKB um cdigo que indica o tipo de geometria. Valores de 1 a 7 ine o dicam Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, e GeometryCollection. Um valor Point tm coordenadas X e Y, cada uma representada como um valor de e dupla preciso. a Valores WKB para valores de geometria mais complexas so representados por estrutras de a dados mais complexas, como detalhado na epecicao OpenGIS. ca

742

MySQL Technical Reference for Version 5.0.0-alpha

10.4 Criando um Banco de Dados MySQL Habilitado Espacialmente

Esta seo descreve os tipos de dados que voc pode usar para representar dados espaciais ca e no MySQL e as funes dispon co iveis para criar e recuperar valores espaciais.

10.4.1 Tipos de Dados Espaciais do MySQL

MySQL fornece um hierarquia de tipos de dados que correspondem as classes na hierarquia de classes do Modelo Geometrico OpenGIS. Alguns destes tipos guardam valores de geometria unicos: GEOMETRY POINT LINESTRING POLYGON O tipo GEOMETRY o mais genrico destes tipos, ele pode armazenar geometrias de qualquer e e tipo. Os outros tipos restringem seus valores a tipos de geometria espec icos. Os outros tipos de dados tem colees de valores: co MULTIPOINT MULTILINESTRING MULTIPOLYGON GEOMETRYCOLLECTION GEOMETRYCOLLECTION pode armazenar uma coleao de objetos de qualquer tipo. Os outros c tipos de colees restrigem o tipo dos membros da coleo para um tipo de geometria co ca especico.

10.4.2 Criando Valores Espaciais

Esta seo descreve como criar valores espaciais usando as funes Well-Known Text e ca co Well-Known Binary que esto denidas no padro OpenGIS, e usando funes espec a a co icas do MySQL.

10.4.2.1 Criando Valores Geometry Usando Funoes WKT c

O MySQL fornece algumas funes que utilizam a representao Well-Known Text (e, opco ca cionalmente, um identicador sistema de referncia espacial (SRID)) e retorna a geometria e correspondente. GeomFromText() aceita um WKT de qualquer tipo de geometria com seu primeiro argumento. Uma implementao tambm fornece uma funo de construo espec ca e ca ca ica do tipo para cada tipo de geometria. GeomFromText(wkt[,srid]) GeometryFromText(wkt[,srid]) Controi um valor geometria de qualquer tipo usando sua representao WKT ca e SRID.

Cap tulo 10: Extenses Espacias em MySQL o

743

PointFromText(wkt[,srid]) Controi um valor POINT usando sua representao WKT e SRID. ca LineFromText(wkt[,srid]) LineStringFromText(wkt[,srid]) Constroi um valor LINESTRING usando sua representao WKT e SRID. ca PolyFromText(wkt[,srid]) PolygonFromText(wkt[,srid]) Constroi um valor POLYGON usasdo sua representao WKT e SRID. ca MPointFromText(wkt[,srid]) MultiPointFromText(wkt[,srid]) Contri um valor MULTIPOINT usando sua representao WKT e SRID. o ca MLineFromText(wkt[,srid]) MultiLineStringFromText(wkt[,srid]) Contri um valor MULTILINESTRING usando sua representao WKT e SRID. o ca MPolyFromText(wkt[,srid]) MultiPolygonFromText(wkt[,srid]) Contri um valor MULTIPOLYGON usando sua representao WKT e SRID. o ca GeomCollFromText(wkt[,srid]) GeometryCollectionFromText(wkt[,srid]) Constri um valor GEOMETRYCOLLECTION usando sua representao WKT e o ca SRID. A especicao OpenGIS tambm descreve funes opcionais para construo de valores ca e co ca Polygon ou MultiPolygon baseados na representao WKT de uma coleo de anis ou ca ca e valores LineString fechados. Estes valores podem se interceptar. OMySQL ainda no a implementou estas funes: co BdPolyFromText(wkt,srid) Constri um valor Polygon a partir de um valor MultiLineString no formato o WKT contendo uma coleo arbitrria de valores LineString fechados. ca a BdMPolyFromText(wkt,srid) Constri um valor MultiPolygon a partir de um valor MultiLineString no o formato WKT contendo uma coleo arbitrria de vlaores LineString fechados. ca a

10.4.2.2 Criando Valores Geometry Usando Funoes WKB c

O MySQL fornece um conjunto de funes que utilizam um BLOB contendo representao co ca Well-Known Binary (e, opcionalmente, um indenticador de sistema de referncia espacial e (SRID)), e retornam a geometria correspondente. GeomFromWKT pode acitar um WKB de qualquer tipo de geometria como seu primeiro argumento. Uma implementao tambm fornece uma funo de construo espec ca e ca ca ica para cada tipo de geometria como descrito na lista acima.

744

MySQL Technical Reference for Version 5.0.0-alpha

GeomFromWKB(wkb,srid) GeometryFromWKB(wkt,srid) Constri um valor geometria de qualquer tipo usando seua representao WKB o ca e SRID. PointFromWKB(wkb[,srid]) Constri um valor POINT usando sua representao WKB e SRID. o ca LineFromWKB(wkb[,srid]) LineStringFromWKB(wkb[,srid]) Constri um valor LINESTRING usando sua representao WKB e SRID. o ca PolyFromWKB(wkb[,srid]) PolygonFromWKB(wkb[,srid]) Constri um valor POLYGON usando sua representao WKB e SRID. o ca MPointFromWKB(wkb[,srid]) MultiPointFromWKB(wkb[,srid]) Constri um valor MULTIPOINT usando sua representao WKB e SRID. o ca MLineFromWKB(wkb[,srid]) MultiLineStringFromWKB(wkb[,srid]) Constri um valor MULTILINESTRING usando sua representao WKB e SRID. o ca MPolyFromWKB(wkb[,srid]) MultiPolygonFromWKB(wkb[,srid]) Constri um valor MULTIPOLYGON usando sua representao WKB e SRID. o ca GeomCollFromWKB(wkb[,srid]) GeometryCollectionFromWKB(wkt[,srid]) Constri um valor GEOMETRYCOLLECTION usando sua representao WKB e o ca SRID. A especicao do OpenGIS tambm descreve funes adicionais para construo de valores ca e co ca Polygon ou MultiPolygon baseados em uma representao WKB de uma coleo de anis ca ca e ou valores de LineString fechadas. Estes valores podem se interceptar. O MySQL ainda no implementou estas funes: a co BdPolyFromWKB(wkb,srid) Constri um valor Polygon a partir de um valor MultiLineString no formato o WKB contendo uma coleo arbitrria de valores LineString fechados. ca a BdMPolyFromWKB(wkb,srid) Constri um valor MultiPolygon a partir de um valor MultiLineString no o formato WKB contendo uma coleo arbitrria de valores LineString fechados. ca a

10.4.2.3 Criando uma Valor de Geometira Usando Funoes c Especicas do MySQL

Nota: o MySQL aindo no implementou as funes listadas nesta seo. a co ca O MySQL fornece um conjunto de funes uteis para criar representaes WKB de geomeco co tria. A funo descrita nesta seo so extenses MySQL para a especicao OpenGIS. ca ca a o ca

Cap tulo 10: Extenses Espacias em MySQL o

745

O resultado destas funes so valores BLOBs contendo representaes WKB de valores de co a co geometria sem SRID. Os resultados destas funes podem ser substituidos como primeiro co argumento para a fam de funes GeomFromWKB(). ilia co Point(x,y) Constri um Point WKB usando suas cooerdenadas. o MultiPoint(pt1,pt2,...) Constri um MultiPoint WKB usando WKBPoints. Quando o argumento no o a Point WKB, o valor de retorno NULL. e e LineString(pt1,pt2,...) Constri um LineString WKB de um nmero de Points WKB. Quando o o u argumento no Point WKB, o valor de retorno NULL. Quando o nmero de a e e u Points menor que dois o valor de retorno NULL. e e MultiLineString(WKBLineString,WKBLineString,...,WKBLineString) Constri um MultiLineString WKB usando LineStrings WKB. Quando o o argumento no LineString WKB, o valor de retorno NULL. a e e Polygon(ls1,ls2,...) Constri um Polygon de um nmero de LineStrings WKB. Quando o arguemo u nto no representa o WKB de um LinearRing (ex. LineString no fechada e a a simples) o valor de retorno NULL. e MultiPolygon(poly1,poly2,...) Constri um MultiPolygon WKB de um conjunto de Polygons WKB. Quando o o argumento no um Polygon WKB, o valor de retorno NULL. a e e GeometryCollection(WKBGeometry,WKBGeometry,..,WKBGeometry) Constucts a GeometryCollection WKB. Quando o argumento no uma repa e resentao WKB bem formada de uma geometria, o valor de retorno NULL. ca e

10.4.3 Criando Colunas Espaciais

O MySQL fornece um modo padro de criar colunas espaciais para tipos de geometria, por a exemplo, com CREATE TABLE ou ALTER TABLE. Atualmente, colunas espaciais so suportadas a apenas por tabelas MyISAM. CREATE TABLE Use a instruo CREATE TABLE para criar uma tabela com uma coluna esca pacial: mysql> CREATE TABLE geom (g GEOMETRY); Query OK, 0 rows affected (0.02 sec) mysql> ALTER TABLE Use a instruo ALTER TABLE para adicionar ou deletar uma coluna espacial ca a ou de uma tabela existente: mysql> ALTER TABLE geom ADD pt POINT; Query OK, 0 rows affected (0.00 sec)

746

MySQL Technical Reference for Version 5.0.0-alpha

Records: 0 Duplicates: 0 Warnings: 0 mysql> ALTER TABLE geom DROP pt; Query OK, 0 rows affected (0.00 sec) Records: 0 Duplicates: 0 Warnings: 0 mysql>

10.4.4 Entrando com Dados em Colunas Espaciais

Depois de criar as colunas espaciais, voc pode preench-las com os dados espaciais. e e Os valores devem ser armazenados no formato de geometria interna, mas voc pode converte e las para este formato a partir dos formatos Well-Known Text (WKT) ou Well-Known Binary (WKB). Os exemplos a seguir demonstram como inserir valores de geometria em uma tabela convertendo valores WKT em formatos de geometria interna. Voc pode realizar a converso diretamente na instruo INSERT: e a ca INSERT INTO geom VALUES (GeomFromText(POINT(1 1))); SET @g = POINT(1 1); INSERT INTO geom VALUES (GeomFromText(@g)); Ou a coverso pode ser feita primeiro que o INSERT: a SET @g = GeomFromText(POINT(1 1)); INSERT INTO geom VALUES (@g); Os seguintes exemplos inserem geometrias mais comlexas nas tabelas: SET @g = LINESTRING(0 0,1 1,2 2); INSERT INTO geom VALUES (GeomFromText(@g)); SET @g = POLYGON((0 0,10 0,10 10,0 10,0 0),(5 5,7 5,7 7,5 7, 5 5)); INSERT INTO geom VALUES (GeomFromText(@g)); SET @g = GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(0 0,1 1,2 2,3 3,4 4)); INSERT INTO geom VALUES (GeomFromText(@g)); Todos os exemplos anteiores usam GeomFromText() para criar os valores de geometria. Voc e tambm pode usar funes de tipo especicos: e co SET @g = POINT(1 1); INSERT INTO geom VALUES (PointFromText(@g)); SET @g = LINESTRING(0 0,1 1,2 2); INSERT INTO geom VALUES (LineStringFromText(@g)); SET @g = POLYGON((0 0,10 0,10 10,0 10,0 0),(5 5,7 5,7 7,5 7, 5 5)); INSERT INTO geom VALUES (PolygonFromText(@g)); SET @g = GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(0 0,1 1,2 2,3 3,4 4)); INSERT INTO geom VALUES (GeomCollFromText(@g)); Note que se um programa aplicativo cliente que quiser utilizar representaes WKB de co valores de geometria, ele responsvel por enviar corretamente WKB formadas em consultas e a

Cap tulo 10: Extenses Espacias em MySQL o

747

para o servidor. No entanto, existem diversos modos de satisfazer esta exigncia. Por e exemplo: Inserindo um Point(1,1) com sintaxe literal hexa: Uma aplicao ODBC pode enviar uma representao WKB, ligando como um arguca ca mento do tipo BLOB: INSERT INTO geom VALUES (GeomFromWKB(?)); Outra interfaces de programao podem suportar um mecanimo de placeholder similar. ca Em um programa C, voc pode fazer um escape de um valor binrio usando mysql_ e a real_escape_string() e incluindo o resultado em string de consulta que enviada ao e servidor. Veja Seo 12.1.3.44 [mysql_real_escape_string()], Pgina 815. ca a

INSERT INTO geom VALUES (GeomFromWKB(0x0101000000000000000000F03F000000000000F03

10.4.5 Buscando Dados Espaciais

Valores de geometria, previamente armazenados na tabela, pode, ser buscados com a converso em formatos internos. Voc tambm pode convert-los no formato WKT ou WKB. a e e e

10.4.5.1 Buscando Dados Espaciais em um Formato Interno

Buscar valores de geometria usando formatos internos pode ser util em transferncias de e tabela para tabela: CREATE TABLE geom2 (g GEOMETRY) SELECT g FROM geom;

10.4.5.2 Buscando Dados Espaciais no Formato WKT

A funo AsText() fornece acesso textual a valores de geometria. Ele converte a geometria ca a partir de um formato interno em uma string WKT. mysql> SELECT AsText(g) FROM geom; +-------------------------+ | AsText(p1) | +-------------------------+ | POINT(1 1) | | LINESTRING(0 0,1 1,2 2) | +-------------------------+ 2 rows in set (0.00 sec)

10.4.5.3 Buscando Dados Espaciais no Formato WKB

A funo AsBinary fornece acesso binrio a valores de geometria. Ela converte uma geomeca a tria a partir de um formato interno em um BLOB contendo um valor WKB. SELECT AsBinary(g) FROM geom;

748

MySQL Technical Reference for Version 5.0.0-alpha

10.5 Analisando Informao Espacial ca

Depois de preencher colunas espaciais com valores, voc est pronto para consult-los e e a a analis-los. O MySQL fornece um conjunto de funes para realizar diversas operaes a co co em dados espaciais. Estas funes podem ser agrupadas em quatro grandes categorias de co acordo com o tipo de operao que eles realizam: ca Funes que convertem geometrias entre vrios formatos. co a Funes que fornecem acesso a propriedades qualitativas ou quantitativas de um geco ometria Funes que descrevem reales entre duas geometrias. co co Funes que criam novas geometrias de outras existentes. co Funes de anlise espacial podem ser usados em muitos contextos, tais como: co a Qualquer programa SQL interativo, como mysql ou MySQLCC. Aplicativos escritos em qualquer linguagem duportando uma API do cliente MySQL.

10.5.1 Funoes Para Converter Geometrias Entre Formatos c Diferentes

O MySQL suporta as seguintes funes para converter valores geomtricos entre formatos co e internos e os formatos WKB e WKT: GeomFromText(wkt[,srid]) Converte um valor string de sua representao WKT em formato de geometria ca interna e retorna o resultado. Um nmero de funes espec u co icas de tipo tambm e so suportadas, como PointFromText() e LineFromText(); veja Seo 10.4.2.1 a ca [GIS WKT Functions], Pgina 742. a GeomFromWKB(wkb [,srid]) Converte um valor binrio da sua representao WKB em formato de geometria a ca interna e retorna o resultado. Um nmero de funes espec u co icas de tipo tambm e so suportadas, como PointFromWKB() e LineFromWKB(); veja Seo 10.4.2.2 a ca [GIS WKB Functions], Pgina 743. a AsText(g) Converte um valor em formato de geomtria interna em sua representao WKT ca e retorna a string resultante. mysql> SET @g = LineString(1 1,2 2,3 3); mysql> SELECT AsText(GeomFromText(@g)); +--------------------------+ | AsText(GeomFromText(@G)) | +--------------------------+ | LINESTRING(1 1,2 2,3 3) | +--------------------------+ AsBinary(g) Converte um valor em formato de geomtria interna em sua representao WKB ca e retorna o valor binrio resultante a

Cap tulo 10: Extenses Espacias em MySQL o

749

10.5.2 Funoes de Anlise das Propriedades de Geometry c a

Cada funo que pertencem a este grupo tomam um valor de geometria como seus arguca mentos e retornam alguma propriedade quantitativa e qualitativa desta geometria. Algumas funes restrigem os seus tipos de argumentos. tais funes retornam NULL se o argumento co co de um tipo de geometria incorreta. Por exemplo, Area() retorna NULL se o tipo do objeto e no for nem Polygon nem MultiPolygon. a

10.5.2.1 Funoes de Anlise das Propriedades de Geometry em c a Geral

As funes listadas nesta seo no restrigem seus argumentos e acitam um valor geometria co ca a de qualquer tipo. GeometryType(g) Retorna como string o nome do tipo da geometria da qual esta instncia g a de geometry um membro. O nome corresponder a uma das subclasses ine a stanciveis de Geometry. a mysql> SELECT GeometryType(GeomFromText(POINT(1 1))); +-------------------------------------------------+ | GeometryType(GeomFromText(POINT(1 1))) | +-------------------------------------------------+ | POINT | +-------------------------------------------------+ Dimension(g) Retorna a dimenso herdada deste objeto g de geometria. O resultado pode ser a 1, 0, 1 or 2. (o signicado destes valores dado em Seo 10.2.2 [GIS class e ca geometry], Pgina 735.) a mysql> SELECT Dimension(GeomFromText(LineString(1 1,2 2))); +------------------------------------------------+ | Dimension(GeomFromText(LineString(1 1,2 2))) | +------------------------------------------------+ | 1 | +------------------------------------------------+ SRID(g) Retorna um inteiro indicando ID do Sistema de Referncia Espacial do valor de e geometria g. mysql> SELECT SRID(GeomFromText(LineString(1 1,2 2))); +-----------------------------------------------+ | SRID(GeomFromText(LineString(1 1,2 2),101)) | +-----------------------------------------------+ | 101 | +-----------------------------------------------+

Envelope(geometry g):geometry Retorna o Retngulo de Limite M a inimo (Minimum Bounding Rectangle (MBR)) para o valor de geometria g. O resultado retornado como um e polygon (poligono).

750

MySQL Technical Reference for Version 5.0.0-alpha

mysql> SELECT AsText(Envelope(GeomFromText(LineString(1 1,2 2),101))); +------------------------------------------------------+ | AsText(Envelope(GeomFromText(LineString(1 1,2 2))) | +------------------------------------------------------+ | POLYGON((1 1,2 1,2 2,1 2,1 1)) | +------------------------------------------------------+ O polygon denido pelos pontos nos cantos da caixa que o limita: e POLYGON((MINX MINY, MAXX MINY, MAXX MAXY, MINX MAXY, MINX MINY)) A especicao OpenGIS tambm dene as seguintes funes, que o MySQL ainda no ca e co a implementou: Boundary(g) Retorna uma geometria que o fechamento do limite combinacional do valor e da geometria g. IsEmpty(g) Retorna 1 se o valor da geometria g e a geometria vazia, 0 se ela no est vazia a a e 1 se o argumento NULL. Se a geometria est vazia, ela representa um e a conjunto de pontos vazios. IsSimple(g) Atualmewnte esta funo no deve ser usada. Quando implementada, seu comca a portamento ser como descrito no prximo pargrafo. a o a Retorna 1 se o valor da geometria g no tem nenhum ponto geomtrico anora e mal, como a interseo prpria ou tangente prpria. IsSimple retorna 0 se o ca o o argumento no simples, e 1 se NULL. a e e A descrio de cada geomtrica instancivel dada anteriormente neste cap ca e a itulo inclui a condio especica que faz com que uma instncia desta classe seja ca a classicada como no simples. a

10.5.2.2 Funoes de Anlise das Propriedades de Point c a

Um Point consiste de suas coordenadas X e Y, que podem ser obtidas usando as seguintes funes: co X(p) Retorna o valor da coordenada X para o ponto p como um nmero de dupla u preciso. a mysql> SELECT X(GeomFromText(Point(56.7 53.34))); +--------------------------------------+ | X(GeomFromText(Point(56.7 53.34))) | +--------------------------------------+ | 56.7 | +--------------------------------------+ Y(p) Retorna o valor da coordenada Y para o ponto p como um nmero de dupla u preciso. a

Cap tulo 10: Extenses Espacias em MySQL o

751

mysql> SELECT Y(GeomFromText(Point(56.7 53.34))); +--------------------------------------+ | Y(GeomFromText(Point(56.7 53.34))) | +--------------------------------------+ | 53.34 | +--------------------------------------+

10.5.2.3 Funoes de Anlise das Propriedades de LineString c a

Uma LineString consiste de valores Point. Voc pode extrair pontos particulares de uma e LineString, contar o nmero de pontos que ela contm ou obter o seu tamanho. u e EndPoint(ls) Retorna o Point que o ponto nal do valor LineString ls. e mysql> SELECT AsText(EndPoint(GeomFromText(LineString(1 1,2 2,3 3)))); +------------------------------------------------------------+ | AsText(EndPoint(GeomFromText(LineString(1 1,2 2,3 3)))) | +------------------------------------------------------------+ | POINT(3 3) | +------------------------------------------------------------+ GLength(ls) Returna como um nmero de preciso dupla o tamanho do valor LineString u a ls em sua referncia espacial associada. e mysql> SELECT GLength(GeomFromText(LineString(1 1,2 2,3 3))); +--------------------------------------------------+ | GLength(GeomFromText(LineString(1 1,2 2,3 3))) | +--------------------------------------------------+ | 2.8284271247462 | +--------------------------------------------------+ IsClosed(ls) Returna 1 se o valor LineString ls fechado (isto , seus valores StartPoint() e e e EndPoint() so os mesmos). Returna 0 se ls no fechado, e 1 se ele a a e e NULL. mysql> SELECT IsClosed(GeomFromText(LineString(1 1,2 2,3 3))); +---------------------------------------------------+ | IsClosed(GeomFromText(LineString(1 1,2 2,3 3))) | +---------------------------------------------------+ | 0 | +---------------------------------------------------+ NumPoints(ls) retorna o nmero de pontos no valor LineString ls. u mysql> SELECT NumPoints(GeomFromText(LineString(1 1,2 2,3 3))); +----------------------------------------------------+ | NumPoints(GeomFromText(LineString(1 1,2 2,3 3))) | +----------------------------------------------------+

752

MySQL Technical Reference for Version 5.0.0-alpha

| 3 | +----------------------------------------------------+ PointN(ls,n) Returna o n-simo ponto no valor Linestring ls. e mysql> SELECT AsText(PointN(GeomFromText(LineString(1 1,2 2,3 3)),2)); +-----------------------------------------------------------+ | AsText(PointN(GeomFromText(LineString(1 1,2 2,3 3)),2)) | +-----------------------------------------------------------+ | POINT(2 2) | +-----------------------------------------------------------+

StartPoint(ls) Returna o Point que o ponto inicial do valor LineString ls. e mysql> SELECT AsText(StartPoint(GeomFromText(LineString(1 1,2 2,3 3)))); +-------------------------------------------------------------+ | AsText(StartPoint(GeomFromText(LineString(1 1,2 2,3 3)))) | +-------------------------------------------------------------+ | POINT(1 1) | +-------------------------------------------------------------+ A especicao OpenGIS tambm dene as seguintes funes, que o MySQL ainda no ca e co a implementou: IsRing(ls) Retorna 1 se o valor LineString ls fechado (isto , seus valores e e StartPoinnt() e EndPoint() so os mesmos) e simples (no passa pelo a e a mesmo ponto mais de uma vez). Retorna 0 se ls no um anel, 1 se NULL. a e e

10.5.2.4 Funoes de Anlise das Propriedades de MultiLineString c a

GLength(mls) Retorna o tamanho do valor de MultiLineString mls como um nmero e preu ciso dupla. O tamanha de mls igual a soma dos tamanhos de seus elementos. a e mysql> SELECT GLength(GeomFromText(MultiLineString((1 1,2 2,3 3),(4 4,5 5 +-------------------------------------------------------------------+ | GLength(GeomFromText(MultiLineString((1 1,2 2,3 3),(4 4,5 5)))) | +-------------------------------------------------------------------+ | 4.2426406871193 | +-------------------------------------------------------------------+ IsClosed(MultiLineString m):Integer IsClosed(mls) Returna 1 se o valor MultiLineString mls fechado (isto , os valores e e StartPoint() e EndPoint() so os mesmos para cada LineString em mls). a Returna 0 se mls no fechada, e 1 se for NULL. a e mysql> SELECT IsClosed(GeomFromText(MultiLineString((1 1,2 2,3 3),(4 4,5 +--------------------------------------------------------------------+

Cap tulo 10: Extenses Espacias em MySQL o

753

| IsClosed(GeomFromText(MultiLineString((1 1,2 2,3 3),(4 4,5 5)))) | +--------------------------------------------------------------------+ | 0 | +--------------------------------------------------------------------+

10.5.2.5 Funoes de Anlise das Propriedades de Polygon c a

Area(poly)

Returna como um nmero de dupla preciso a rea do valor Polygon poly, u a a como medido em seu sistema de referncia espacial. e mysql> SELECT Area(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 +------------------------------------------------------------------------| Area(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1)) +------------------------------------------------------------------------| +-------------------------------------------------------------------------

NumInteriorRings(poly) Retorna o nmero de anis interiores no valor Polygon poly. u e mysql> SELECT NumInteriorRings(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0) +------------------------------------------------------------------------| NumInteriorRings(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 +------------------------------------------------------------------------| +------------------------------------------------------------------------1 row in set (0.00 sec)

ExteriorRing(poly) Retorna o anel exterior do valor Polygon poly como uma LineString. mysql> SELECT AsText(ExteriorRing(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 +------------------------------------------------------------------------| AsText(ExteriorRing(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2 +------------------------------------------------------------------------| LINESTRING(0 0,0 3,3 3,3 0,0 0) +-------------------------------------------------------------------------

InteriorRingN(poly,n) Retorna o n-simo anel exterior para o valor Polygon poly como uma e LineString. mysql> SELECT AsText(InteriorRingN(GeomFromText(Polygon((0 0,0 3,3 3,3 0, +------------------------------------------------------------------------| AsText(InteriorRingN(GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 +------------------------------------------------------------------------| LINESTRING(1 1,1 2,2 2,2 1,1 1) +------------------------------------------------------------------------A especicao OpenGIS tambm dene as seguintes funes, que o MySQL ainda no ca e co a implementou:

754

MySQL Technical Reference for Version 5.0.0-alpha

Centroid(poly) O centide matemtico para o valor Polygon poly como um Point. O resultado o a no garantido estar neste Polygon. a e PointOnSurface(poly) Returna um valor Point que esta garantidamente no valor Polygon poly.

10.5.2.6 Funoes de Anlise das Propriedades de MultiPolygon c a

Area(mpoly) Retorna como um nmero de preciso dupla a rea do valor MultiPolygon u a a mpoly, como medido no sistema de referncia espacial deste MultiPolygon. e mysql> SELECT Area(GeomFromText(MultiPolygon(((0 0,0 3,3 3,3 0,0 0),(1 1, +------------------------------------------------------------------------| Area(GeomFromText(MultiPolygon(((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1, +------------------------------------------------------------------------| +------------------------------------------------------------------------A especicao OpenGIS tambm dene as seguintes funes, que o MySQL ainda no ca e co a implementou: Centroid(mpoly) O centride matemtico para este MultiPolygon como um Point. O resultado o a no garantido estar neste MultiPolygon. a e PointOnSurface(mpoly) Retorna um valor Point que garantido estar no valor MultiPolygon mpoly. e

10.5.2.7 Funoes de Anlise das Propriedades de c a GeometryCollection

NumGeometries(gc) Retorna o nmero de geometrias no valor GeometryCollection gc. u mysql> SELECT NumGeometries(GeomFromText(GeometryCollection(Point(1 1),Li +------------------------------------------------------------------------| NumGeometries(GeomFromText(GeometryCollection(Point(1 1),LineString(2 2 +------------------------------------------------------------------------| +-------------------------------------------------------------------------

GeometryN(gc,n) Retorna o n-sima geometria no valor GeometryCollection gc. O nmero de e u geometrias comea em 1. c mysql> SELECT AsText(GeometryN(GeomFromText(GeometryCollection(Point(1 1) +------------------------------------------------------------------------| AsText(GeometryN(GeomFromText(GeometryCollection(Point(1 1),LineString( +-------------------------------------------------------------------------

Cap tulo 10: Extenses Espacias em MySQL o

755

| POINT(1 1) +------------------------------------------------------------------------Nota: Funes para tipos de geometrias espec co icas retornam NULL se a geomtria passada e do tipo de geometria errado. Por exemplo Area() retorna NULL se o tipo do objeto no a e nem Polygon nem MultiPolygon.

10.5.3 Funoes Que Criam Novas Geometrias de Outras c Existentes 10.5.3.1 Funoes de Geometria Que Produzem Novas Geometrias c
Na seo Seo 10.5.2 [Geometry property functions], Pgina 749 ns j discutimos algumas ca ca a o a funes que podem construir novas geometrias se outras existentes: co Envelope(g) StartPoint(ls) EndPoint(ls) PointN(ls,n) ExteriorRing(poly) InteriorRingN(poly,n) GeometryN(gc,n)

10.5.3.2 Operadores Espaciais

OpenGIS propem algumas outras funes que podem produzir geometrias. Elas esto o co a designadas a implementar Operadores Espaciais. Estas funes ainda no esto implementadas no MySQL. Elas devem aparecer em disco a a tribuies futuras. co Intersection(g1,g2) Retorna uma geometria que representa a insterseo do conjunto de pontos dos ca valores das geometrias g1 com g2. Union(g1,g2) Retorna uma geometria que representa a unio do conjunto de pontos dos vala ores das geometrias g1 com g2. Difference(g1,g2) Retorna uma geometria que representa a diferena do conjunto de pontos dos c valores das geometrias g1 com g2. SymDifference(g1,g2) Retorna uma geometria que representa a diferena simtrica do conjunto de c e pontos dos valores das geometrias g1 com g2. Buffer(g,d) Retiorna uma geometria que representa todos os pontos cuja distncia do valor a da geometria g menor que ou igual a distncia de d. e a

756

MySQL Technical Reference for Version 5.0.0-alpha

ConvexHull(g) Retorna uma geometria que representa a casca convexa de do valor da geometria g.

10.5.4 Funoes Para Testar Relaes Espaciais Entre Objetos c co Geomtricos e

A funo descrita nesta seo toma duas geometrias como parmetros de entrada e retorna ca ca a uma relao qualitativa ou quantitativa entre eles. ca

10.5.5 Relaes de Retngulo de Limite M co a inimo (Minimal Bounding Rectangles - MBR) em Geometrias
O MySQL fornece algumas funes que podem testar relaes entre retngulos de limite co co a m inimo de duas geometrias g1 e g2. Elas incluem: MBRContains(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de g1 contm o e Retngulo de Limite Minimo de g2. a mysql> SET @g1 = GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0))); mysql> SET @g2 = GeomFromText(Point(1 1)); mysql> SELECT MBRContains(@g1,@g2), MBRContains(@g2,@g1); ----------------------+----------------------+ | MBRContains(@g1,@g2) | MBRContains(@g2,@g1) | +----------------------+----------------------+ | 1 | 0 | +----------------------+----------------------+ MBRWithin(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de g1 esta dentro do Retngulo de Limite M a inimo de g2. mysql> SET @g1 = GeomFromText(Polygon((0 0,0 3,3 3,3 0,0 0))); mysql> SET @g2 = GeomFromText(Polygon((0 0,0 5,5 5,5 0,0 0))); mysql> SELECT MBRWithin(@g1,@g2), MBRWithin(@g2,@g1); +--------------------+--------------------+ | MBRWithin(@g1,@g2) | MBRWithin(@g2,@g1) | +--------------------+--------------------+ | 1 | 0 | +--------------------+--------------------+ MBRDisjoint(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de duas geometrias g1 e g2 no fazem interseo. a ca MBREqual(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de duas geometrias g1 e g2 so o mesmo. a

Cap tulo 10: Extenses Espacias em MySQL o

757

MBRIntersects(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de duas geometrias g1 e g2 se interseptam. MBROverlaps(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de duas geometrias g1 e g2 se sobrepe. o MBRTouches(g1,g2) Retorna 1 ou 0 para indicar se o Retngulo de Limite M a inimo de duas geometrias g1 e g2 se tocam.

10.5.6 Funoes que Testam Relacionamentos Espaciais Entre c Geometrias

A especicao OpenGIS dene as seguintes funes, que o MySQL ainda no implementou. ca co a Elas devem aparecer em distribuies futuras. Quando implementadas, fornecero suporte co a total para anlise espacial, no apenas suporte baseado em MBR. a a As funes operam em dois valores de geometria g1 e g2. co Contains(g1,g2) Retorna 1 ou 0 para indicar se g1 contem completamente g2 ou no. a Crosses(g1,g2) Retorna 1 se g1 cruza espacialmente g2. Retorna NULL se g1 um Polygon e ou um MultiPolygon, ou se g2 um Point ou um MultiPoint. Seno 0 e a e retornado. O termo spatially crosses denota uma relao espacial entre duas geometrias ca que tm as seguintes propriedades: e As duas geometrias se interseptam A interseo resulta em uma geometria que tem uma dimenso que menor ca a e que a dimenso mxima das duas geometrias dadas. a a A interseo no igual a nenhuma das duas geometrias dadas. ca a e Disjoint(g1,g2) Retorna 1 ou 0 para indicar se g1 espacialmente disjunta de g2 ou no. e a Equals(g1,g2) Retorna 1 ou 0 para indicar se g1 espacialmente igual a g2 ou no. e a Intersects(g1,g2) Retorna 1 ou 0 para indicar se g1 intersepta espacialmente g2 ou no. a Overlaps(g1,g2) Retorna 1 ou 0 para indicar se g1 sobrepe espacialmente a g2 ou no. O termo o a sobrepor espacialmente usado se duas geometrias fazem interseo e suas e ca intersees resultam em uma geometria da mesma dimenso mas difernete de co a ambas as geometrias dadas.

758

MySQL Technical Reference for Version 5.0.0-alpha

Touches(g1,g2) Retorna 1 ou 0 para indicar se g1 spatially touches g2, ou no. Duas geometrias a se tocam espacialmente se o interiro de ambas geometrias no se interseptam, a mas o limite de uma delas intersepta o limite ou o interior das geometrias. Within(g1,g2) Retorna 1 ou 0 para indicar se g1 est espacialmente dentro da g2, ou no. a a Distance(g1,g2) Retorna como um nmero de preciso dupla, a menor distncia entre quaiquer u a a dois pontos nas duas geometrias. Related(g1,g2,pattern_matrix) Retorna 1 ou 0 indicando se o relacionamento espacial especicado por matriz_ padr~o existe entre g1 e g2 ou no. Retorna 1 se os argumentos so NULL. A a a a matriz padro uma string. Sua especicao ser indicada aqui quando esta a e ca a funo estiver implementada. ca

10.6 Otimizando Anlises Espaciais a

E sabido que operaes de busca em banco de dados no espaciais podem ser otimizadas co a utilizando indices. Isto ainda verdade em banco de dados espaciais. Com a ajuda de grande e variedades de mtodos de indexaco multi-dimensionais, o quais j tm sido desenvolvidos, e a a e otimizar buscas espaciais. As mais comuns delas so: possivel e a Consulta de ponto que buscam por todos os objetos que contem um dado ponto. Consulta de regio que buscam por todos os objetos que sobrepe uma dada regio. a o a O MySQL utiliza Arvores R com separao quadrtica para indexar colunas espaciais. Um ca a indice espacial constru usando o MBR de uma geometria. Para a maioria da geomee ido trias, o MBR um retngulo m e a inimo que cerca a geometria. Para uma linha (linestring) horizontal ou uma vertical, o MBR um retngulo degenerado, nas linhas e nos pontos e a respectivamente.

10.6.1 Criando Indices Espaciais

O MySQL pode criar indices espaciais usando uma sintaxe similar `quela usada para criar a indices regulares, mas extendida com a palavra-chave SPATIAL. Colunas espaciais indexadas devem ser declaradas como NOT NULL. Os seguintes exemplos demonstram como criar indices de colunas espaciais. Com CREATE TABLE: mysql> CREATE TABLE geom (g GEOMETRY NOT NULL, SPATIAL INDEX(g)); Com ALTER TABLE: mysql> ALTER TABLE geom ADD SPATIAL INDEX(g); Com CREATE INDEX: mysql> CREATE SPATIAL INDEX sp_index ON geom (g); Para remover indices espaciais, use ALTER TABLE ou DROP INDEX:

Cap tulo 10: Extenses Espacias em MySQL o

759

Com ALTER TABLE: mysql> ALTER TABLE geom (ADD SPATIAL KEY(g)); Com DROP INDEX: mysql> DROP INDEX sp_index ON geom; Example: Suponha que uma tabela geom contm mais de 32000 geometrias, que esto e a armazenadas na coluna g do tipo GEOMETRY. A tabela tambm tem um campo AUTO_ e INCREMENT fid, armazenando valores dos IDs de objetos. mysql> SHOW FIELDS FROM geom; +-------+----------+------+-----+---------+----------------+ | Field | Type | Null | Key | Default | Extra | +-------+----------+------+-----+---------+----------------+ | fid | int(11) | | PRI | NULL | auto_increment | | g | geometry | | | | | +-------+----------+------+-----+---------+----------------+ 2 rows in set (0.00 sec) mysql> SELECT COUNT(*) FROM geom; +----------+ | count(*) | +----------+ | 32376 | +----------+ 1 row in set (0.00 sec) Para adicionar um indice espacial na coluna g, use esta instruo: ca mysql> ALTER TABLE geom ADD SPATIAL INDEX(g); Query OK, 32376 rows affected (4.05 sec) Records: 32376 Duplicates: 0 Warnings: 0

10.6.2 Usando Indice Espacial

O otimizador investiga se os indices espaciais dispon iveis podem ser envolvidos na busca se uma consulta com uma funo como MBRContains() ou MBRWithin() na clusula WHERE ca a e executada. Por exemplo, suponhamos que queremos encontrar todos os objetos que esto a no retngulo dado: a mysql> SELECT fid,AsText(g) FROM geom WHERE mysql> MBRContains(GeomFromText(Polygon((30000 15000,31000 15000,31000 16000,30000 +-----+----------------------------------------------------------------------------| fid | AsText(g) +-----+----------------------------------------------------------------------------| 21 | LINESTRING(30350.4 15828.8,30350.6 15845,30333.8 15845,30333.8 15828.8) | 22 | LINESTRING(30350.6 15871.4,30350.6 15887.8,30334 15887.8,30334 15871.4) | 23 | LINESTRING(30350.6 15914.2,30350.6 15930.4,30334 15930.4,30334 15914.2) | 24 | LINESTRING(30290.2 15823,30290.2 15839.4,30273.4 15839.4,30273.4 15823) | 25 | LINESTRING(30291.4 15866.2,30291.6 15882.4,30274.8 15882.4,30274.8 15866.2) | 26 | LINESTRING(30291.6 15918.2,30291.6 15934.4,30275 15934.4,30275 15918.2)

760

MySQL Technical Reference for Version 5.0.0-alpha

| 249 | LINESTRING(30337.8 15938.6,30337.8 15946.8,30320.4 15946.8,30320.4 15938.4) | 1 | LINESTRING(30250.4 15129.2,30248.8 15138.4,30238.2 15136.4,30240 15127.2) | 2 | LINESTRING(30220.2 15122.8,30217.2 15137.8,30207.6 15136,30210.4 15121) | 3 | LINESTRING(30179 15114.4,30176.6 15129.4,30167 15128,30169 15113) | 4 | LINESTRING(30155.2 15121.4,30140.4 15118.6,30142 15109,30157 15111.6) | 5 | LINESTRING(30192.4 15085,30177.6 15082.2,30179.2 15072.4,30194.2 15075.2) | 6 | LINESTRING(30244 15087,30229 15086.2,30229.4 15076.4,30244.6 15077) | 7 | LINESTRING(30200.6 15059.4,30185.6 15058.6,30186 15048.8,30201.2 15049.4) | 10 | LINESTRING(30179.6 15017.8,30181 15002.8,30190.8 15003.6,30189.6 15019) | 11 | LINESTRING(30154.2 15000.4,30168.6 15004.8,30166 15014.2,30151.2 15009.8) | 13 | LINESTRING(30105 15065.8,30108.4 15050.8,30118 15053,30114.6 15067.8) | 154 | LINESTRING(30276.2 15143.8,30261.4 15141,30263 15131.4,30278 15134) | 155 | LINESTRING(30269.8 15084,30269.4 15093.4,30258.6 15093,30259 15083.4) | 157 | LINESTRING(30128.2 15011,30113.2 15010.2,30113.6 15000.4,30128.8 15001) +-----+----------------------------------------------------------------------------20 rows in set (0.00 sec) Agora veriquemos o modo que esta consulta executada, usando EXPLAIN: e

mysql> EXPLAIN SELECT fid,AsText(g) FROM geom WHERE mysql> MBRContains(GeomFromText(Polygon((30000 15000,31000 15000,31000 16000,30000 +----+-------------+-------+-------+---------------+------+---------+------+------+| id | select_type | table | type | possible_keys | key | key_len | ref | rows | +----+-------------+-------+-------+---------------+------+---------+------+------+| 1 | SIMPLE | geom | range | g | g | 32 | NULL | 50 | +----+-------------+-------+-------+---------------+------+---------+------+------+1 row in set (0.00 sec) Agora veriquemos o que aconteceria se ns no tivssemos o a e indices espaciais:

mysql> EXPLAIN SELECT fid,AsText(g) FROM geom IGNORE INDEX (g) WHERE mysql> MBRContains(GeomFromText(Polygon((30000 15000,31000 15000,31000 16000,30000 +----+-------------+-------+------+---------------+------+---------+------+-------+| id | select_type | table | type | possible_keys | key | key_len | ref | rows | +----+-------------+-------+------+---------------+------+---------+------+-------+| 1 | SIMPLE | geom | ALL | NULL | NULL | NULL | NULL | 32376 | +----+-------------+-------+------+---------------+------+---------+------+-------+1 row in set (0.00 sec) Vamos executar a consulta acima, ignorando a chave espacial que temos:

mysql> SELECT fid,AsText(g) FROM geom IGNORE INDEX (g) WHERE mysql> MBRContains(GeomFromText(Polygon((30000 15000,31000 15000,31000 16000,30000 +-----+----------------------------------------------------------------------------| fid | AsText(g) +-----+----------------------------------------------------------------------------| 1 | LINESTRING(30250.4 15129.2,30248.8 15138.4,30238.2 15136.4,30240 15127.2) | 2 | LINESTRING(30220.2 15122.8,30217.2 15137.8,30207.6 15136,30210.4 15121) | 3 | LINESTRING(30179 15114.4,30176.6 15129.4,30167 15128,30169 15113) | 4 | LINESTRING(30155.2 15121.4,30140.4 15118.6,30142 15109,30157 15111.6) | 5 | LINESTRING(30192.4 15085,30177.6 15082.2,30179.2 15072.4,30194.2 15075.2)

Cap tulo 10: Extenses Espacias em MySQL o

761

| 6 | LINESTRING(30244 15087,30229 15086.2,30229.4 15076.4,30244.6 15077) | 7 | LINESTRING(30200.6 15059.4,30185.6 15058.6,30186 15048.8,30201.2 15049.4) | 10 | LINESTRING(30179.6 15017.8,30181 15002.8,30190.8 15003.6,30189.6 15019) | 11 | LINESTRING(30154.2 15000.4,30168.6 15004.8,30166 15014.2,30151.2 15009.8) | 13 | LINESTRING(30105 15065.8,30108.4 15050.8,30118 15053,30114.6 15067.8) | 21 | LINESTRING(30350.4 15828.8,30350.6 15845,30333.8 15845,30333.8 15828.8) | 22 | LINESTRING(30350.6 15871.4,30350.6 15887.8,30334 15887.8,30334 15871.4) | 23 | LINESTRING(30350.6 15914.2,30350.6 15930.4,30334 15930.4,30334 15914.2) | 24 | LINESTRING(30290.2 15823,30290.2 15839.4,30273.4 15839.4,30273.4 15823) | 25 | LINESTRING(30291.4 15866.2,30291.6 15882.4,30274.8 15882.4,30274.8 15866.2) | 26 | LINESTRING(30291.6 15918.2,30291.6 15934.4,30275 15934.4,30275 15918.2) | 154 | LINESTRING(30276.2 15143.8,30261.4 15141,30263 15131.4,30278 15134) | 155 | LINESTRING(30269.8 15084,30269.4 15093.4,30258.6 15093,30259 15083.4) | 157 | LINESTRING(30128.2 15011,30113.2 15010.2,30113.6 15000.4,30128.8 15001) | 249 | LINESTRING(30337.8 15938.6,30337.8 15946.8,30320.4 15946.8,30320.4 15938.4) +-----+----------------------------------------------------------------------------20 rows in set (0.46 sec) Quando o indice no usado, o tempo de execuo para esta consulta cresce de 0.00 segundos a e ca para 0.46 segundos. Nas veres futuras, o indices espaciais tambm sero usados para otimizar outras funes. e a co Veja Seo 10.5.4 [Functions for testing spatial relations between geometric objects], ca Pgina 756. a

10.7 Compatibilidade e Conformidade com o MySQL

10.7.1 Recursos GIS Que Ainda No Esto Implementados a a
Views de Metadados Adicionais Especicaes OpenGIS prope vrias views adicionais de metadados. Por exco o a emplo, um sistema de view chamado GEOMETRY_COLUMNS contem uma descrio ca de colunas geometria, uma linha para coda coluna de geometria no banco de dados. Funes para adicionar/apagar colunas espaciais co OpenGIS assume que colunas podem ser adcionados ou apagados usando funes AddGeometryColumn() e DropGeometryColumn(). No MySQL isto co deve ser feito utilizando as instrues ALTER TABLE, CREATE INDEX e DROP co INDEX Itens relacionados a Sistema de Referncia Espaciasi e suas IDs (SRIDs): e Funes como Length() e Area() assumem um sistemas de coordenadas co planas. Todos os objetos so ataulmente considerados como estando no mesmo a sistema de coordenadas planas.

762

MySQL Technical Reference for Version 5.0.0-alpha

A funo OpenGIS Length() em LineString e MultiLineString ca atualmente devem ser chamadas como GLength() no MySQL. O problema que e ela conita com a funo SQL existente Length() que calcula o tamanho de um ca valor string e algumas vezes no poss distinguir se a funo foi chamada a e ivel ca co contexto textual ou espacial. Ns precisamos resolver isto de algum modo, o ou escolher um outro nome de funo. ca

Cap tulo 11: Stored Procedures e Funes co

763

11 Stored Procedures e Funoes c

Stored procedures e funes so recursoso novos no MySQL verso 5.0. Uma stored proceco a a dure um conjunto de comandos SQL que podem ser armazenados no servidor. Uma vez e que isto tenha sido feito, os clientes no precisam de reenviar os comnados individuais mas a pode fazer referncia `s stored procedures. e a Stored procedures podem fornecer um aumento no desempenho j que menos informao a ca precisa ser enviada entre o servidor e o cliente. O lado negativo que isto aumenta a carga e no sistema do servidor de banco de dados, j que a maior parte do trabalho feita no a e servidor e menor parte feita do lado do cliente (aplicao). E geralmente existem muitas e ca mquinas clientes (como servidoes web) mas apenas um ou poucos servidores e banco de a dados. Stored procedures tambm permitem que voc tenha bibliotecas de funes no servidor e e co de banco de dados. No entanto, linguagens de aplicaes modernas j permitem que isto co a seja feito internamente com classes, por exemplo, e usar estes recursos das linguagens de aplicaes clientes benco para o programador mesmo fora do escopo do banco de dados co e e usado. Situaes onde stored procedures fazem sentido: co Quando vrias aplicaes clientes so escritas em diferentes linguagens ou funcionam a co a em diferentes plataformas, mas precisam realizar as mesmas operaes de banco de co dados. Quando a segurana prioritria. Bancos, por exemplo, usam stored procedures para c e a todas as operaes comuns. Isto fornece um ambiente consistente e seguro, e procedures co podem assegurar que cada operao seja registrada de forma apropriada. Neste tipo ca de condigurao, aplicaes e usurios no conseguiriam nenhuma acesso as tabelas do ca co a a banco de dados diretamente, mas apenas podem executar stored procedures espec icas. O MySQL segue a sintaxe SQL:2003 para stored procedures, que tambm usada pelo DB2 e e da IBM. Suporte para compatibilidade de outras linguagens de stored procedures (PL/SQL, T-SQL) podem ser adicionadas posteriormente. A implementao do MySQL de stored procedures ainda est em progresso. Todas as ca a sintaxes descritas neste capitulo so suportadas e qualquer limitao e extenso est docua ca a a mentada de forma aprorpiada. Stored procedures exigem a tabela proc na banco de dados mysql. Esta tabela criada e durante a instalao do MySQL 5.0. Se voc ataulizar para o MySQL 5.0 a partir de uma ca e verso anterior, certique de atualizar a sua tabela de permisso para ter certeza que a a a tabela proc existe. Veja Seo 2.5.6 [Upgrading-grant-tables], Pgina 130. ca a

11.1 Sintaxe de Stored Procedure

Stored procedures e funes so rotinas criadas com as instrues CREATE PROCEDURE e co a co CREATE FUNCTION. Um procedimento chamado usando uma instruo CALL e s pode e ca o passar valores de retorno usadno variveis de sa a ida. Funes podem retornar um valor esco calar e pode ser chamadas de dentro de uma instruo como quqlquer outra funo (isto ca ca , chamando o nome da funcao). Rotinas armazenadas podem chamar outras rotinas are mazenadas. Uma rotina pode ser tanto um procedimento como uma funo. ca

764

MySQL Technical Reference for Version 5.0.0-alpha

Atualmentem o MySQL s preserva o contexto para o banco de dados padro. Isto , se o a e voc usar USE dbname dentro de um procedimento, o banco de dados original restaurado e e depois da sa da rotina. Uma rotina herda o banco de dados padro de quem a chama, ida a assim geralmente as rotinas devem utilizar uma instruo USE dbname, ou especique todas ca as tabelas com uma referncia de banco de dados explicita, ex. dbname.tablename. e O MySQL suporta uma extenso muito util que permite o uso da instruo regular SELECT a ca (isto , sem usar cursores ou variveis locais) dentro de uma stored procedure. O resultado e a de tal consulta simplesmente enviado diretamente para o cliente. Vrias instrues SELECT e a co geram vria resultados, assim o cliente deve usar um biblioteca cliente do MySQL que a suporta vrios resultados. Isto signica que o cliente deve usar uma biblioteca cliente a a partir de uma verso do MySQL mais recente que 4.1, pelo menos. a A seo seguinte descreve a sintaxe usada para criar, alterar, remover e condultar stored ca procedures e funes. co

11.1.1 Manuteno de Stored Procedures ca 11.1.1.1 CREATE PROCEDURE e CREATE FUNCTION

CREATE PROCEDURE sp_name ([parameter[,...]]) [characteristic ...] routine_body CREATE FUNCTION sp_name ([parameter[,...]]) [RETURNS type] [characteristic ...] routine_body parameter: [ IN | OUT | INOUT ] param_name type type: Any valid MySQL data type characteristic: LANGUAGE SQL | [NOT] DETERMINISTIC | SQL SECURITY {DEFINER | INVOKER} | COMMENT string routine_body: Valid SQL procedure statement(s) A clusula RETURNS pode ser especicada apenas por uma FUNCTION. E usada para indicar a o tipo de retorno da funo, e o corpo da funo deve conter uma instruo RETURN value. ca ca ca A lista de parmetros entre parenteses deve estar sempre presente. Se no houver a a parmetros, uma lista de parmetros vazia de () deve ser usada. Cada parmetro um a a a e parmetro IN por padro. Para especicar outro tipo de parmetro, use a palavra chave a a a

Cap tulo 11: Stored Procedures e Funes co

765

OUT ou INOUT antes do nome do parmetro. Especicar IN, OUT ou INOUT s valido para a oe uma PROCEDURE. A instruo CREATE FUNCTION usada em verso novas do MySQL para suporte a UDFs ca e a (User Dened Functions - Funes Denidas pelo Usurio). Veja Seo 14.2 [Adding funcco a ca tions], Pgina 899. As UDFs continuam a ser suportadas, mesmo com a existencia de stored a functions. Uma UDF pode ser considerada como uma stored function externa. No entanto, note que stored functions compartilham os seus namespace com as UDFs. Um framework para stored procedures externas sero introduzidas em um futuro prxima. a o Isto permitir que voc escreva stored procedures em outras linguagens alm de SQL. a e e Provavelmente, uma das primeiras linguagens a ser suportada sea PHP, j que o mecanismo a do PHP pequeno, seguro com threads e pode facilmente ser embutido. Como o framework e ser publico, esperado que muitas outras linguagens tambm sejam suportadas. a e e Uma funo considerada deterministica se ela sempre retorna o mesmo resultado para ca e os mesmos parmetros de entrada, e no deterministica caso contrrio. O otimizado pode a a a usar este fato. Atualmente, a caracter istica DETERMINISTIC aceita, mas ainda no usada. e a e A caracter istica SQL SECURITY pode ser usada para especicar se a rotina deve ser executada usando as permisses do usurio que criou a rotina, ou o usurio que a chamou. O valor o a a padro DEFINER. Este recurso novo no SQL:2003. a e e O MySQL ainda no usa o privilgio GRANT EXECUTE. Assim ,por enquanto, se um proceda e imento p1() chama a tabela t1,o usurio deve ter privilgios na tabela t1 para chamar o a e procedimento p1() com sucesso. MySQL stores the SQL_MODE settings in eect at the time a routine is created, and will always execute routines with these settings in force. A clusula COMMENT uma extenso do MySQL, e pode ser usada para descrever o stored a e a procedure. Esta informao exibida pelas instrues SHOW CREATE PROCEDURE e SHOW ca e co CREATE FUNCTION. O MySQL permite rotinas contendo instrues DDL (como CREATE e DROP) e instrues de co co transao SQL (como COMMIT). Isto no exigido por padro e depende de especicaes ca a e a co de implementao. ca NOTA: Atualmente, stored FUNCTIONs no podem conter referncias `s tabelas. Note que a e a isto inclui algumas instrues SET, mas exclui algumas instrues SELECT. Esta limitao co co ca ser retirada assim que poss a ivel. A seguir temos um exemplo de uma stored procedure simples que usa um parmetro OUT. O a exemplo usa o comando delimiter do cliente mysql para alterar o delimitador de instruo ca para antes da denio do procedure. Isto permite que o delimitador ; usado no corpo de ca procedure seja passado para o servidor em vez de ser interpretado pelo mysql. mysql> delimiter | mysql> CREATE PROCEDURE simpleproc (OUT param1 INT) -> BEGIN -> SELECT COUNT(*) INTO param1 FROM t; -> END -> | Query OK, 0 rows affected (0.00 sec)

766

MySQL Technical Reference for Version 5.0.0-alpha

mysql> CALL simpleproc(@a)| Query OK, 0 rows affected (0.00 sec) mysql> SELECT @a| +------+ | @a | +------+ | 3 | +------+ 1 row in set (0.00 sec) A seguir esta um exemplo de uma funo que utiliza um parametro, realiza uma operao ca ca usando uma funo SQL e retorna o resultado: ca mysql> delimiter | mysql> CREATE FUNCTION hello (s CHAR(20)) RETURNS CHAR(50) -> RETURN CONCAT(Hello, ,s,!); -> | Query OK, 0 rows affected (0.00 sec) mysql> SELECT hello(world)| +----------------+ | hello(world) | +----------------+ | Hello, world! | +----------------+ 1 row in set (0.00 sec)

11.1.1.2 ALTER PROCEDURE e ALTER FUNCTION

ALTER PROCEDURE | FUNCTION sp_name [characteristic ...] characteristic: NAME newname | SQL SECURITY {DEFINER | INVOKER} | COMMENT string Este comando pode ser usado para renomear uma stored procedure ou function, e para alterar suas caracter isticas. Mais de uma mudana pode ser especicada em uma instruo c ca ALTER PROCEDURE ou ALTER FUNCTION.

11.1.1.3 DROP PROCEDURE e DROP FUNCTION

DROP PROCEDURE | FUNCTION [IF EXISTS] sp_name Este comando usado para deletar uma stored procedure ou function. Isto , a rotina e e especicada removida do servidor. e

Cap tulo 11: Stored Procedures e Funes co

767

A clusula IF EXISTS uma extenso do MySQL. Ela previne que um erro ocorra se o a e a procedimento ou funo no existe. Um aviso produzido e pode ser vizualizado com SHOW ca a e WARNINGS.

11.1.1.4 SHOW CREATE PROCEDURE e SHOW CREATE FUNCTION

SHOW CREATE PROCEDURE | FUNCTION sp_name Este comando uma extenso do MySQL. De forma similar a SHOW CREATE TABLE, ele e a retorna a string exata que pode ser usada para recriar a rotina chamada.

11.1.2 SHOW PROCEDURE STATUS e SHOW FUNCTION STATUS

SHOW PROCEDURE | FUNCTION STATUS [LIKE pattern] Este comando uma extenso do MySQL. Ele retorna caracter e a isticas da rotina, tais como nome, tipo, quem criou, datas de modicao e criao. Se nenhum padro especicado, a ca ca a e informao de todas as stored procedures ou todas as stored functions listado, dependendo ca e de qual instruo voc utiliza. ca e

11.1.3 CALL
CALL sp_name([parameter[,...]]) O comando CALL usado para chamar uma rotina que foi denida anteriormente com e CREATE PROCEDURE.

11.1.4 BEGIN ... END Compound Statement

[begin_label:] BEGIN statement(s) END [end_label] As rotinas armazenadas podem conter vrias instrues, usando um instruo BEGIN ... a co ca END. begin_label e end_label devem ser os mesmos, se ambos forem especicados. Notem que a clusula opcional [NOT] ATOMIC ainda no suportada. Isto signica que a a e nenhum savepoint de transao denido no inicio do bloco da instruo e a clusula ca e ca a BEGIN usada neste contexto no tem nenhum efeito no transao atual. a ca Vrias instrues exigem que um cliente tenha permisso para enviar strings de querys a co a contendo ;. Isto tratado no cliente mysql e linha de comando com o comando delimiter. e Alterando o delimitador ; do nal da consulta (por exemplo, para |) permite que ; seja usado no corpo de uma rotina.

11.1.5 Instruo DECLARE ca

A instruo DECLARE usada para denir vrios itens locais para uma rotina: variaveis locais ca e a (veja Seo 11.1.6 [Variables in Stored Procedures], Pgina 768), condies e handlers (veja ca a co

768

MySQL Technical Reference for Version 5.0.0-alpha

Seo 11.1.7 [Conditions and Handlers], Pgina 768) e cursors (veja Seo 11.1.8 [Cursors], ca a ca Pgina 770). As instrues SIGNAL e RESIGNAL ainda no so suportadas. a co a a DECLARE s pode ser usada dentro de uma instruo composta BEGIN ... END e deve estar o ca no in icio, antes de qualquer outra instruo. ca

11.1.6 Variables in Stored Procedures

Voc pode declarar e usar variveis dentro de uma rotina. e a

11.1.6.1 Varivel Local DECLARE a

DECLARE var_name[,...] type [DEFAULT value] Este comando usado para declarar variveis locais. O escopo de uma varivel est dentro e a a a do bloco BEGIN ... END.

11.1.6.2 Instruo Varivel SET ca a

SET variable = expression [,...] A instruo SET em stored procedures uma verso estendida do comando SET geral. As ca e a variveis indicadas podem ser aquelas declaradas dentro de uma rotina, ou variveis globais a a do servidor. A instruo SET em stored procedures implementada como parte da sintaxe pr-existente ca e e de SET. Isto permite uma sintaxe estendida de SET a=x, b=y, ... onde variveis de tipos a diferentes (variaveis declaradas localamente, variveis do servidor e variveis globais e de a a sesso do servidor) podem estar misturadas. Ela tambm permite combinaes de variveis a e co a locais e algumas opes que s fazem sentido para variveis globais e de sistema; neste caso co o a as opes so aceitas mas ignoradas. co a

11.1.6.3 Instruo SELECT ... INTO ca

SELECT column[,...] INTO variable[,...] table_expression Esta sintaxe de SELECT armazena colunas selecionadas diretamente nas variveis. Por esta a razo, apenas uma linha pode ser recuperada. Esta instruo tambm extremamente util a ca e e quando usada em conjunto com cursores. SELECT id,data INTO x,y FROM test.t1 LIMIT 1;

11.1.7 Condies e Handlers co

Certas condies podem exigir tratamento espec co ico. Estas condies podem ser relaco cionadas a erros, bem como controle de uxo geral dentro da rotina.

11.1.7.1 DECLARE Conditions

DECLARE condition_name CONDITION FOR condition_value

Cap tulo 11: Stored Procedures e Funes co

769

condition_value: SQLSTATE [VALUE] sqlstate_value | mysql_error_code Esta instruo especica condies que necessitaro de tratamento especial. Ela associa um ca co a nome com uma condio de erro especica. O nome pode ser subsequentemente usado em ca uma instruo DECLARE HANDLER. Veja Seo 11.1.7.2 [DECLARE Handlers], Pgina 769. ca ca a Alm dos valores SQLSTATE, cdigos de erro do MySQL tambm so suportados. e o e a

11.1.7.2 DECLARE Handlers

DECLARE handler_type HANDLER FOR condition_value[,...] sp_statement handler_type: CONTINUE | EXIT | UNDO condition_value: SQLSTATE [VALUE] sqlstate_value | condition_name | SQLWARNING | NOT FOUND | SQLEXCEPTION | mysql_error_code Esta instruo especica handlers para lidar com uma ou mais condies. Se uma dessas ca co condies ocorrer, a instruo especicada executada. co ca e Para um handler CONTINUE, a execuo das rotinas atuais continuam depois da instruo ca ca handler. Para um handler EXIT, a execuo da rotina atual terminada. O handler_type ca e UNDO ainda no suportado. Atualmente o UNDO se comporta como CONTINUE. a e SQLWARNING is shorthand for all SQLSTATE codes that begin with 01. NOT FOUND is shorthand for all SQLSTATE codes that begin with 02. EXCEPTION is shorthand for all SQLSTATE codes not caught by SQLWARNING or NOT FOUND. Alm dos valores SQLSTATE, cdigos de erro do MySQL tambm so suportados. e o e a Por exemplo: mysql> CREATE TABLE test.t (s1 int,primary key (s1)); Query OK, 0 rows affected (0.00 sec) mysql> delimiter | ysql> CREATE PROCEDURE handlerdemo () -> BEGIN -> DECLARE CONTINUE HANDLER FOR 23000 SET @x2 = 1; -> set @x = 1;

770

MySQL Technical Reference for Version 5.0.0-alpha

-> INSERT INTO test.t VALUES (1); -> set @x = 2; -> INSERT INTO test.t VALUES (1); -> SET @x = 3; -> END; -> | Query OK, 0 rows affected (0.00 sec) mysql> CALL handlerdemo()| Query OK, 0 rows affected (0.00 sec) mysql> SELECT @x| +------+ | @x | +------+ | 3 | +------+ 1 row in set (0.00 sec) Notice that @x is 3, which shows that MySQL executed to the end of the procedure. If the line DECLARE CONTINUE HANDLER FOR 23000 SET @x2 = 1; had not been present, MySQL would have taken the default (EXIT) path after the second INSERT failed due to the PRIMARY KEY constraint, and SELECT @x would have returned 2.

11.1.8 Cursors
Simple cursors are supported inside stored procedures and functions. The syntax is as in embedded SQL. Cursors are currently asensitive, read-only, and non-scrolling. Asensitive means that the server may or may not make a copy of its result table. For example: CREATE PROCEDURE curdemo() BEGIN DECLARE done INT DEFAULT 0; DECLARE CONTINUE HANDLER FOR SQLSTATE 02000 SET done = 1; DECLARE cur1 CURSOR FOR SELECT id,data FROM test.t1; DECLARE cur2 CURSOR FOR SELECT i FROM test.t2; DECLARE a CHAR(16); DECLARE b,c INT; OPEN cur1; OPEN cur2; REPEAT FETCH cur1 INTO a, b; FETCH cur2 INTO c; IF NOT done THEN IF b < c THEN

Cap tulo 11: Stored Procedures e Funes co

771

INSERT INTO test.t3 VALUES (a,b); ELSE INSERT INTO test.t3 VALUES (a,c); END IF; END IF; UNTIL done END REPEAT; CLOSE cur1; CLOSE cur2; END

11.1.8.1 Declaring Cursors

DECLARE cursor_name CURSOR FOR sql_statement Multiple cursors may be dened in a routine, but each must have a unique name.

11.1.8.2 Cursor OPEN Statement

OPEN cursor_name This statement opens a previously declared cursor.

11.1.8.3 Cursor FETCH Statement

FETCH cursor_name This statement fetches the next row (if a row exists) using the specied open cursor, and advances the cursor pointer.

11.1.8.4 Cursor CLOSE Statement

CLOSE cursor_name This statement closes a previously opened cursor.

11.1.9 Flow Control Constructs

The IF, CASE, LOOP, WHILE, ITERATE, and LEAVE constructs are fully implemented. These constructs may each contain either a single statement, or a block of statements using the BEGIN ... END compound statement. Constructs may be nested. FOR loops are not currently supported.

11.1.9.1 IF Statement
IF search_condition THEN statement(s) [ELSEIF search_condition THEN statement(s)] ... [ELSE statement(s)]

772

MySQL Technical Reference for Version 5.0.0-alpha

END IF IF implements a basic conditional construct. If the search_condition evaluates to true, the corresponding SQL statement is executed. If no search_condition matches, the statement in the ELSE clause is executed. Please note that there is also an IF() function. Veja Seo 6.3.1.4 [Control ow functions], ca Pgina 510. a

11.1.9.2 CASE Statement

CASE case_value WHEN when_value THEN statement [WHEN when_value THEN statement ...] [ELSE statement] END CASE or CASE WHEN search_condition THEN statement [WHEN search_condition THEN statement ...] [ELSE statement] END CASE CASE implements a complex conditional construct. If a search_condition evaluates to true, the corresponding SQL statement is executed. If no search condition matches, the statement in the ELSE clause is executed. Please note that the syntax of a CASE statement inside a stored procedure diers slightly from that of the SQL CASE expression. The CASE statement can not have an ELSE NULL clause, and the construct is terminated with END CASE instead of END. Veja Seo 6.3.1.4 ca [Control ow functions], Pgina 510. a

11.1.9.3 LOOP Statement

[begin_label:] LOOP statement(s) END LOOP [end_label] LOOP implements a simple loop construct, enabling repeated execution of a particular statement or group of statements. The statements within the loop are repeated until the loop is exited, usually this is accomplished with a LEAVE statement. begin_label and end_label must be the same, if both are specied.

11.1.9.4 LEAVE Statement

LEAVE label This statement is used to exit any ow control construct.

Cap tulo 11: Stored Procedures e Funes co

773

11.1.9.5 ITERATE Statement

ITERATE label ITERATE can only appear within LOOP, REPEAT, and WHILE statements. ITERATE means do the loop iteration again. For example: CREATE PROCEDURE doiterate(p1 INT) BEGIN label1: LOOP SET p1 = p1 + 1; IF p1 < 10 THEN ITERATE label1; END IF; LEAVE label1; END LOOP label1; SET @x = p1; END

11.1.9.6 REPEAT Statement

[begin_label:] REPEAT statement(s) UNTIL search_condition END REPEAT [end_label] The statements within a REPEAT statement are repeated until the search_condition is true. begin_label and end_label must be the same, if both are specied. For example: mysql> delimiter | mysql> CREATE PROCEDURE dorepeat(p1 INT) -> BEGIN -> SET @x = 0; -> REPEAT SET @x = @x + 1; UNTIL @x > p1 END REPEAT; -> END -> | Query OK, 0 rows affected (0.00 sec) mysql> CALL dorepeat(1000)| Query OK, 0 rows affected (0.00 sec) mysql> SELECT @x| +------+ | @x | +------+ | 1001 | +------+ 1 row in set (0.00 sec)

774

MySQL Technical Reference for Version 5.0.0-alpha

11.1.9.7 WHILE Statement

[begin_label:] WHILE search_condition DO statement(s) END WHILE [end_label] The statements within a WHILE statement are repeated as long as the search_condition is true. begin_label and end_label must be the same, if both are specied. For example: CREATE PROCEDURE dowhile() BEGIN DECLARE v1 INT DEFAULT 5; WHILE v1 > 0 DO ... SET v1 = v1 - 1; END WHILE; END

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

775

12 Ferramentas de Clientes e APIs do MySQL

Este cap itulo descreve as APIs dispon iveis para o MySQL, onde consegui-las e como utiliza las. A API C a coberta mais estensamente, j que ela foi desenvolvida pela equipe do e a MySQL e a base para a maioria das outras APIs. e

12.1 API C do MySQL

O cdigo da API C distribu com o MySQL. Ele est inclu na biblioteca mysqlclient o e ido a ido e permite programas em C a fazer acesso em banco de dados. Muitos dos clientes na distribuio fonte do MySQL est escrito em C. Se voc estiver ca a e procurando por exemplos que demonstrem como utilizar a API C, d uma olhada neste e clientes. Voc pode encontr-los no diretrio clients na distribuio fonte do MySQL. e a o ca A maioria das outras clientes API (todos exceto Connector/J) usam a biblioteca mysqlclient para se comunicar com o servidor MySQL. Isto signica que, por exemplo, voc pode tirar vantagem das mesmas variveis de ambientes que so utilizados por outros e a a programas clientes, pois eles refernciados pela biblioteca. Veja Seo 4.9 [Client-Side e ca Scripts], Pgina 345, para uma lista destas variveis. a a O cliente tem um tamanho mximo de buer de comunicao. O tamanho do buer que a ca e alocado inicialmente (16K bytes) automaticamente aumentado para o tamanho mximo e a (o mximo 16M). Como o tamanho do buer aumentado somente como autorizao de a e e ca demanda, o simples aumento do limite mximo padro no faz, por si s, que mais recursos a a a o sejam usado. Esta vericao de tamanho na maioria vericaes por consultas erradas e ca e co pacotes de comunicaes. co O buer de comunicao deve ser grande o suciente para conter uma unica instruo ca ca SQL (para trfego cliente-servidor) e uma linha de dado retornado (para traco servidora cliente). Cada buer de comunicao de thread dinamicamente aumentado para manipular ca e qualquer consulta ou linha at o limite mximo. Por exemplo, se voc tiver valores BLOB e a e que contenham at 16M de dados, voc deve ter um limite de buer de comunicao de pelo e e ca menos 16M (no servidor e no cliente). A mximo padro do cliente 16M. mas o mximo a a a padro no servidor 1M. Voc pode aumentar iso alterando o valor do parmetro max_ a e e a allowed_packet quando o servidor iniciado. Veja Seo 5.5.2 [Par6ametros de servidor], e ca Pgina 454. a O servidor MySQL encolhe cada buer de comunicao para net_buffer_length bytes ca depois de cada consulta. Para clientes, o tamanho do buer associado com um conexo a no reduzido at que a conexo seja fechada, quando a memria de tempo do cliente a e e a o e recuperada. Para programao com threads, veja Seo 12.1.14 [Threaded clients], Pgina 863. Para ca ca a criar uma aplicao stand-alone que inclua o "servidor" e o "cliente" no mesmo programa ca (e que no comunica com um servidor MySQL externo), veja Seo 12.1.15 [libmysqld], a ca Pgina 864. a

776

MySQL Technical Reference for Version 5.0.0-alpha

12.1.1 Tipos de Dados da API C

MYSQL MYSQL_RES Esta estrutura representa o resultado de uma consulta que retorna linhas (SELECT, SHOW, DESCRIBE, EXPLAIN). A informao retornada de uma consulta ca chamada conjunto de resultado no resto desta seo. e ca MYSQL_ROW Esta uma representao segura de tipo de uma linha de dados. Ela implee ca e mentada atualmente como um vetor de strings de tamanho xo (Voc no pode e a trat-los como strings terminadas com null se os valores do campo podem conter a dados binrios, porque tais valores podem conter um byte null internamente.). a Linhas so obtidas pela chamada de mysql_fetch_row(). a MYSQL_FIELD Esta estrutura contm informao sobre um campo, tais como nome, tipo e e ca tamanho do campo. Seus membros so descritos em mais detalhes aqui. Voc a e pode obter a estrutura MYSQL_FIELD para cada campo chamando mysql_fetch_ field() repetidamente. Valores de campos no so parte desta estrutura; eles a a esto contidos na estrutura MYSQL_ROW. a MYSQL_FIELD_OFFSET Esta uma representao segura de um oset em uma lista de campos MySQL. e ca (Usado por mysql_field_seek().) Osets so nmeros de campos em um a u registro, comeando com zero. c my_ulonglong O tipo usado pelo nmero de linhas e para mysql_affected_rows(), u mysql_num_rows(), e mysql_insert_id(). Este tipo fornece uma faixa de 0 a 1.84e19. Em alguns sistemas, tentar imprimir um valor do tipo my_ulonglong no funa cionar. Para imprimir tais valores, converta-os para unsigned long e use o a formato de impresso %lu. Exemplo: a A estrutura MYSQL_FIELD contem os membros listados aqui: char * name O nome do campo, como um string terminada com null. char * table O nome da tabela contendo este campo, se no for um campo calculado. Para a campos calculador, o valor table uma string vazia. e char * def O valor padro para este campo, como um string terminada em null. Ele a e atribuido apenas se voc utilizar mysql_list_fields(). e Esta estrutura representa um manpulador para uma conexo ao banco de dados. a E usada para quase todas as funes MySQL. co

printf ("Nmero de linhas: %lu\n", (unsigned long) mysql_num_rows(resultad u

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

777

enum enum_field_types tipo O tipo do campo. O valor tipo pode ser um dos seguintes: Valou tipo Descrio do tipo ca FIELD_TYPE_TINY campo TINYINT FIELD_TYPE_SHORT campo SMALLINT FIELD_TYPE_LONG campo INTEGER FIELD_TYPE_INT24 campo MEDIUMINT FIELD_TYPE_LONGLONG campo BIGINT FIELD_TYPE_DECIMAL campo DECIMAL ou NUMERIC FIELD_TYPE_FLOAT campo FLOAT FIELD_TYPE_DOUBLE campo DOUBLE ou REAL FIELD_TYPE_TIMESTAMP campo TIMESTAMP FIELD_TYPE_DATE campo DATE FIELD_TYPE_TIME campo TIME FIELD_TYPE_DATETIME campo DATETIME FIELD_TYPE_YEAR campo YEAR FIELD_TYPE_STRING campo CHAR FIELD_TYPE_VAR_STRING campo VARCHAR FIELD_TYPE_BLOB campo BLOB ou TEXT (usa max_length para determinar o tamanho mximo) a FIELD_TYPE_SET campo SET FIELD_TYPE_ENUM campo ENUM FIELD_TYPE_NULL campo tipo-NULL FIELD_TYPE_CHAR Deprecado; use FIELD_TYPE_TINY Voc pode utilizar a macro IS_NUM() para testar se uma campo tem um tipo e numrico. Passe o valor tipo para IS_NUM() e ele ir avaliar como VERe a DADEIRO (TRUE) se o campo for numrico: e if (IS_NUM(campo->tipo)) printf("Campo numrico\n"); e e unsigned int length A largura de um campo, como especicado nas denies da tabela. co unsigned int max_length A largura mxima do campo no conjunto de resultados (O tamanho do maior a valor do campo para os registro no resultado atual). Se voc utilizar mysql_ e store_result() ou mysql_list_fields(), ele contem o tamanho mximo a para o campo. Se voc utiliza mysql_use_result(), o valor desta varivel e a zero. e unsigned int param Diferentes parmetros binrios para o campo. O valor de param pode ter zero a a ou mais dos seguintes conjunto de bits: Valor param Descrio param ca NOT_NULL_FLAG Campo no pode ser NULL a PRI_KEY_FLAG Campo parte de uma chave primria e a UNIQUE_KEY_FLAG Campo parte de uma chave unica e MULTIPLE_KEY_FLAG Campo parte de uma chave no unica e a

778

MySQL Technical Reference for Version 5.0.0-alpha

UNSIGNED_FLAG Campo tem o atributo UNSIGNED ZEROFILL_FLAG Campo tem o atributo ZEROFILL BINARY_FLAG Campo tem o atributo BINARY AUTO_INCREMENT_FLAG Campo tem o atributo AUTO_INCREMENT ENUM_FLAG Campo um ENUM (obsoleto) e SET_FLAG Campo um SET (obsoleto) e BLOB_FLAG Campo um BLOB ou TEXT (obsoleto) e TIMESTAMP_FLAG Campo um TIMESTAMP (obsoleto) e Uso dos parmetros BLOB_FLAG, ENUM_FLAG, SET_FLAG, e TIMESTAMP_FLAG a foram obsoletos porque eles indicavam o tipo de um campo e no um a atributo do tipo. E prefer ivel testar campo->tipo para FIELD_TYPE_BLOB, FIELD_TYPE_ENUM, FIELD_TYPE_SET, ou FIELD_TYPE_TIMESTAMP. O seguinte exemplo ilustra o uso t ipico do valor param: if (campo->param & NOT_NULL_FLAG) printf("Campo n~o pode ser nulo\n"); a Voc pode usar as seguintes macros para determinar o status dos valores param: e Status param Descrio ca IS_NOT_NULL(param) Verdadeiro se se este campo denido como NOT e NULL IS_PRI_KEY(param) Verdadeiro de este campo uma chave primria e a IS_BLOB(param) Verdadeiro se este campo um BLOB ou TEXT e (obsoleto; teste campo->tipo) unsigned int decimals O nmero de decimais para um campo numrico. u e

12.1.2 Viso Geral das Funo da API C a ca

As funes dispon co iveis na API C so resumidas aqui e descritas em maiores detalhes em a uma seo posterior. Veja Seo 12.1.3 [Funes API C], Pgina 783. ca ca co a Funo ca mysql aected rows() mysql change user() mysql character set name() mysql close() mysql connect() mysql create db() Descrio ca Retorna o nmero de linhas alteradas/deletadas/insweridas u pela ultima consulta \ UPDATE, DELETE, ou INSERT. Muda o usuario em um banco de dados em uma conexo a aberta. Retorna o nome do conjunto de carcters padro para a a conexo. a Fecha ua conexo com o servidor a Se conecta ao servidro MySQL. Esta funo est deprecad; ca a utilize mysql_real_connect(). Cria um banco de dados. Esta funo est obsoleta; utiliza ca a o comando SQL CREATE DATABASE.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

779

mysql data seek() mysql debug() mysql drop db() mysql dump debug info() mysql eof()

Busca por uma nmero de linha arbitrrio em um conjunto u a de resultados de uma consulta. Faz um DBUG_PUSH com a string dada. Apaga um banco de dados; Esta funo esta obsoleta; utiliza ca o comando SQL DROP DATABASE. Faz o servidor escrever informaes de depourao no log. co ca Determina quando a ulitma linha de um conjunto de resultados foi lida. Esta funo foi obsoleta; Utilize mysql_ ca errno() ou mysql_error() Retorna o nmero de erro para a funo MySQL chamada u ca mais recentemente. Retorna a mensagem de erro para funo MySQL chamada ca mais recentemente. Escapa caracteres especiais em uma string para ser usada em uma instruo SQL. ca Retorna o tipo do prximo campo na tabela. o Retorna o tipo de um campo da tabela, dado um nmero u do campo. Retorna um vetor de todas as estruturas do campo. Retorna o tamanho de todas as colunas na linha atual. Busca o prximo registro no conjunto de resultados. o Coloca o cursor da coluna em uma coluna espec ica. Retorna o nmero de colunas resultantes da consulta mais u recente. Retorna a posio do cursos de campos usado pelo ultimo ca mysql_fetch_field(). Libera a memria usada por um conjunto de resultados. o Retorna a verso do cliente como uma string. a Returna a verso do cliente como um inteiro. a Retorna uma string descrevendo a conexo. a Retorna o nmero da verso do servidor como um inteiro u a (Novo na verso 4.1) a Retorna a verso do protovolo usado para a conexo. a a

mysql errno() mysql error() mysql escape string() mysql fetch eld() mysql fetch eld direct() mysql fetch elds() mysql fetch lengths() mysql fetch row() mysql eld seek() mysql eld count() mysql eld tell() mysql free result() mysql get client info() mysql get client version() mysql get host info() mysql get server version() mysql get proto info()

780

MySQL Technical Reference for Version 5.0.0-alpha

mysql get server info() mysql info() mysql init() mysql insert id() mysql kill() mysql list dbs() mysql list elds() mysql list processes() mysql list tables() mysql num elds() mysql num rows() mysql options() mysql ping() mysql query() mysql real connect() mysql real escape string()

Retorna o nmero da verso do servidor. u a Retorna informao sobre a consulta executada mais recenca temente. Obtem ou inicializa uma estrutura MYSQL. Retorna o ID gerado para uma coluna AUTO_INCREMENT pela consulta anterior. Mata uma thread dada. Retorna o nome do banco de dados correspondente a uma expresso regular. a retorna nome de campos coincidindo com uma expresso a regular. Retorna uma lista das threads atuais do servidor. Retorna os nomes de tabelas correspondente a uma expresso regular. a Retorna o nmero de coluans em um conjunto de resultados. u Retorna o nmero de linhas em um conjunto de resultados. u Dene opes de conexo para mysql_connect(). co a Verica se a conexo ao servidor est funcionando, rea a conectando se necessrio. a Executa uma consulta SQL especicada com uma string terminada com null. Conecta ao servidor MySQL. Escapa caracteres especiais em uma string para ser utilizada em uma instruo SQL, olhando na conta o conjunto de ca caracteres atual da conexo a Executa uma consulta SQL especicada como uma string xa. Diz ao servidor pra recarregar a tabela de permisses o Busca por um oset de linha no resultado, usando o valor retornado de mysql_row_tell(). Retorna a posio dio cursor de linhas. ca Seleciona um banco de dados.

mysql real query() mysql reload() mysql row seek() mysql row tell() mysql select db()

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

781

mysql set server option() mysql sqlstate() mysql shutdown() mysql stat() mysql store result() mysql thread id() mysql thread safe() mysql use result() mysql warning count() mysql commit() mysql rollback() mysql autocommit() mysql more results() mysql next result()

Dene uma opo para a conexo (como multica a statements). Retorna o cdigo de erro SQLSTATE para o ultimo erro. o Desliga o servidor de banco de dados. Retorna o status do servidor como uma string. Recupera um resultado completo para o cliente. Retorna a identicao da thread atual. ca Retorna 1 se o cliente foi compilado como thread-safe. Inicia uma resultado recuperado registro por registro. Retorna a contagem do aviso da instruo SQL anterior. ca Faz um commits na transao (novo na verso 4.1). ca a Faz um roll back na transao (novo na verso 4.1). ca a Muda o modo autocommit em ligado/desligado (novo na verso 4.1). a Verica se no existem mais resultados (novo na verso 4.1). a a Retorna/Inicia o prximo resultado em execues consultas o co mltiplas (inovo na verso 4.1). u a

Para se conectar ao servidor, chame mysql_init() para iniciar um manipulador de conexo, a ento chame mysql_real_connect() com este manipulador (com informaes de nome a co de mquina, usurios e senha). Conectado, mysql_real_connect() dene o parmetro a a a reconnect (parte da estrutura MYSQL) para um valor de 1. Este parmetro indica, no a evento que uma consulta no pode ser realizada por perda de conexo, para tentar reconectar a a ao servidor ao antes de desistir. Quando no precisar mais da conexo, chame mysql_ a a close() para termin-la. a Enquanto a conexo estiver ativa, o cliente pode enviar consultas SQL para o servidor a usando mysql_query() ou mysql_real_query(). A diferena entre os dois que mysql_ c e query() espera que a consulta seja especicada como uma string terminada em null, enquanto mysql_real_query() espera um string de tamanho xa. Se a string conter dados binrios (a qual pode incluir bytes null), vocdeve usar mysql_real_query(). a e Para cada consulta no-SELECT (por exemplo, INSERT, UPDATE, DELETE), voc pode descoa e brir quantas linhas foram alteradas (afetadas) chamando mysql_affected_rows(). Para consultas SELECT, voc retorna os registros selecionados como um resultado. (Note que e algumas intrues so como a SELECT ao retornar registros. Elas incluem SHOW, DESCRIBE co a e EXPLAIN. elas devem ser tratadas da mesma maneira que instrues SELECT.) co Existem dois modos para um cliente processa o resultado. Um mode recuperar todo o e resultado de uma vez chamando mysql_store_result(). Esta funo busca no servidor ca todas as linhas retornadas pela consulta e as armazena no cliente. O segundo modo o e

782

MySQL Technical Reference for Version 5.0.0-alpha

cliente iniciar um retorno do resultado registro por registro chamando mysql_use_result(). Esta funo inicia o retorno, mas no busca realmente nenhuma linha do servidor. ca a Em ambos os casos, acesse registros chamando mysql_fetch_row(). Com mysql_store_ result(), mysql_fetch_row() acessa registros que j tenham sido buscado do servidor. a Com mysql_use_result(), mysql_fetch_row() recupera, na verdade, o registro do servidor. Informaes sobre o tamanho dos dados em cada registro dispon pela chamada co e ivel mysql_fetch_lengths(). Depois de nalizar o uso do resultado, chame mysql_free_result() para liberar a memria o usada por ele. Os dois mecanismos de recuperao so complementares. Programas clientes devem escolher ca a a abordagem mais apropriada para suas necessidades. Na prtica, clientes tendem a utilizar a mysql_store_result(). Uma vantagem de mysql_store_result() que pelo fato de todos os registros serem e trazidos para o cliente, voc no s pode acessar registros sequencialmente, mas tambm e a o e pode mover para tarz e para frente no resultado utilizando mysql_data_seek() ou mysql_ row_seek() para altera a posio atual do registro no resultado. Voc tambm pode saber ca e e quantas linhas existem chamando mysql_num_rows(). Por outro lado, a necessidade de memria para mysql_store_result() pode ser muito alta para resultados grandes e voc o e encontrar como mais facilidade condies de estouro de memria. a co o Uma vantagem de mysql_use_result() que o clientes exige menos memria para o ree o sultado porque ele mantem apenas um registro por vez (por haver menor sobrecarga de alocao, mysql_use_result() pode ser mais rpido). As desvantagens so que voc deve ca a a e processar cada registro rapidamente para evitar prender o servidor, voc no tem acesso e a aleatrio aos registros no resultado (voc s pode acess-los sequencialmente) e voc no o e o a e a sabe quantos registros existem no resultado at que voc recupere todos eles. Alm disso, e e e voc deve recuperar todos os registros mesmo que voc j tenham encontrado a informao e e a ca que procura antes do nalizar o conjunto de resultados. A API torna poss para os clientes responder apropriadamente as consultas (recuperando ivel somente os regiostros necessrios) sem saber se a consulta uma instruo SELECT ou no. a e ca a Voc pode fazer isto chamando mysql_store_result() depois de cada mysql_query() (ou e mysql_real_query()). Se o resultado for obtido com sucesso, a consulta foi um SELECT e voc pode ler os registros. Se a obteno do resultado falhar, chame mysql_field_count() e ca para determinar se o resultado era o esperado. Se mysql_field_count() retornar zero, a consulta no retornou nenhum dado (indicando que ela era um INSERT, UPDATE, DELETE, a etc.), e no era esperado que retornasse registros. Se mysql_field_count() diferente de a e zero, a consulta deveria retornar registros, mas no o fez. Isto indica que a consulta foi um a SELECT que falhou. Veja a descrio de mysql_field_count() para um exemplo de como ca deve ser feito. mysql_store_result() e mysql_use_result() permitem que voc obtenha informao e ca sobre os campos que montam o resultado (o nmero de campos, os seus nome e tipos, etc.) u Voc pode acessar informaes de campo sequencialmente dentro dos registros chamando e co mysql_fetch_field() repetidamente, ou pelo nmero do campo dentro do registro u chamando mysql_fetch_field_direct(). A posio atual do cursor de campos pode ser ca alterada cahamando mysql_field_seek(). Denir o cursor de campo afeta chamadas

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

783

subsequentes de mysql_fetch_field(). Voc tambm pode conseguir informaes de e e co todos os campos de uma s vez chamando mysql_fetch_fields(). o Para detectar e relatar problemas, o MySQL fornace acesso a informaes de erro atravs das co e funes mysql_errno() e mysql_error(). Elas retornam o cdigo de erro ou a mensagem co o de erro para a funo chamada mais recentemente que tenha tido sucesso ou que tenha ca falhado, permitindo a voc determinar quando um erro ocorreu e qual foi ele. e

12.1.3 Descrio das Funes da API C ca co

Nas descries a seguir, um parmetro ou valor retornado NULL signica NULL no sentido da co a linguagem de programao C, no um valor NULL do MySQL. ca a Funes que retornam um valor geralmente retornam um ponteiro ou um inteiro. A menos co que seja especicado, funces que retornam um ponteiro, retornam um valor diferente de o NULL para indicar sucesso ou um valor NULL para indicar um erro, e funes que retornam co um inteiro, retoprnam zero para indicar sucesso ou um valor diferente de zero para indicar um erro. A menos que a descrio da funo diga algo diferente, no faa teste com outro ca ca a c valor alm do zero. e if (result) /* correct */ ... error ... if (result < 0) ... error ... /* incorrect */

if (result == -1) /* incorrect */ ... error ... Quando uma funo retornar um erro, a subsecao Erros de descrio de funes lista os ca ca co poss iveis tipos de erro. Voc pode descobrir quais deles ocorreu chamando mysql_errno(). e Uma representao string do erro pode ser obtida chamando mysql_error(). ca

12.1.3.1 mysql_affected_rows()
my_ulonglong mysql_affected_rows(MYSQL *mysql)

Descrio ca
Retorna o nmero de registros alterados pelo ultimo UPDATE, deletados elo ultimo DELETE ou u inseridos pelo ultimo INSERT. Pode ser chamado imediatamente aps mysql_query() para o instrues UPDATE, DELETE, ou INSERT. Para instrues SELECT, mysql_affected_rows() co co funciona como mysql_num_rows().

Valor Retornado
Um inteiro maior que zero indica o nmero de registros afetados ou recuperados. Zero indica u que nenhum registro foi atualizado por uma instruo UPDATE, nenhuma linha foi encontrada ca pela clusula WHERE na consulta ou a consulta ainda no foi executada. -1 indica que a a a

784

MySQL Technical Reference for Version 5.0.0-alpha

consulta retornou um erro ou que, para uma consulta SELECT, mysql_affected_rows() foi chamado antes da chamada mysql_store_result().

Erros
Nenhum.

Exemplo
mysql_query(&mysql,"UPDATE products SET cost=cost*1.25 WHERE group=10"); printf("%ld products updated",(long) mysql_affected_rows(&mysql)); Se se for especicado o parmetro CLIENT_FOUND_ROWS ao conectar no mysqld, mysql_ a affected_rows() retornar o nmero de linhas encontardos pela clusula WHERE para a a u a instruo UPDATE. ca Note que quando for utilizado um comando REPLACE, mysql_affected_rows() retornar a 2 se o novo registro substituir um mais antigo. Isto porque neste caso um registro foi e inserido e depois os registros duplicados foram deletados.

12.1.3.2 mysql_change_user()
my_bool mysql_change_user(MYSQL *mysql, const char *user, const char *password, const char *db)

Descrio ca
Altera o usurio faz com que o banco de dados especicado por db se torne o banco de a e dados padro (atual) na conexo especicada por mysql. Em consultas subsequentes este a a banco de dados o padro para referncias a tabelas que no especicam o banco de dados e a e a explicitamente. Esta funo foi introduzida na verso do MySQL. ca a mysql_change_user() falha a menos que o usurio conectado possa ser autenticado ou se a ele no tiver permisso para utilizar o banco de dodos. Neste caso o usurio e o banco de a a a dados no so alterados. a a O parmetro db pode ser denido como NULL se voc no dseseja ter um banco de dados a e a padro. a A partir da verso 4.0.6 do MySQL este comando sempre far ROLLBACK de qualquer a a transao ativa, fecha todas as tabelas temporrias, destrava todas as tabelas bloqueadas e ca a volta a um estado como se tivesse feito uma inova conexo. Isto ir acontecer mesmo se o a a usurio no foi alterado. a a

Valor Retornado
Zero se obteve successo. Diferente de zero se ocorreu um erro.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

785

Erros
O mesmo que pode ser obtido com mysql_real_connect(). CR_COMMANDS_OUT_OF_SYNC Comandos forma executados em ordem inapropriada. CR_SERVER_GONE_ERROR O servidor MySQL nalizou. CR_SERVER_LOST A conexo ao servidor foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu. ER_UNKNOWN_COM_ERROR O servidor MySQL no possui este comando (provavelmente um verso mais a a antiga) ER_ACCESS_DENIED_ERROR O usurio ou a senha estavam errados. a ER_BAD_DB_ERROR O banco de dados no existe. a ER_DBACCESS_DENIED_ERROR O usurio no tem direitos de acessoa este banco de dados. a a ER_WRONG_DB_NAME O nome de banco de dados muito grande. e

Exemplo
if (mysql_change_user(&mysql, "user", "password", "new_database")) { fprintf(stderr, "Failed to change user. Error: %s\n", mysql_error(&mysql)); }

12.1.3.3 mysql_character_set_name()
const char *mysql_character_set_name(MYSQL *mysql)

Descrio ca
Retorna o conjunto de caracteres padro para a conexo atual. a a

Valor Retornado
O conjunto de carcteres padro a

786

MySQL Technical Reference for Version 5.0.0-alpha

Erros
Nenhum.

12.1.3.4 mysql_close()
void mysql_close(MYSQL *mysql)

Descrio ca
feca uma conexo aberta anteriormente. mysql_close() tambm desaloca o ponteiro do a e manipulador da conexo para o mysql se ele tiver sido alocado automaticamente por mysql_ a init() ou mysql_connect().

Valor Retornado
Nenhum.

Erros
Nenhum.

12.1.3.5 mysql_connect()
MYSQL *mysql_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd)

Descrio ca
A funo est obsoleta. E melhor utilizar mysql_real_connect(). ca a mysql_connect() tenta estabelecer uma conexo a um banco de dados MySQL executando a em host. mysql_connect() deve completar com suceso antes que voc podssa executar e qualquer uma das funo da API, com a exceo de mysql_get_client_info(). ca ca O signicado dos parmetros so os mesmos que os parmetros correspondentes para mysql_ a a a real_connect() com a diferena que o parmetro de conexo pode ser NULL. Neste caso a c a a API C aloca memria para a estrutura de conexo automaticamente e a libera quando voc o a e chamar mysql_close(). A disvantagem desta abordagem que voc no pode retornar uma e e a mensagem de erro se a conexo falhar. (Para obter informaes de erro de mysql_errno() a co ou mysql_error(), voc deve fornecer um ponteiro MYSQL vlido.) e a

Valor Retornado
O mesmo de mysql_real_connect().

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

787

Erros
O mesmo de mysql_real_connect().

12.1.3.6 mysql_create_db()
int mysql_create_db(MYSQL *mysql, const char *db)

Descrio ca
Cria o banco de dados nomeado pelo parmetro db. a Esta funo est obsoleta. E melhor utilizar mysql_query() para comandar uma instruo ca a ca SQL CREATE DATABASE.

Valor Retornado
Zero se o banco de dados foi criado com successo. Diferente de zero se ocorreu um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Exemplo
if(mysql_create_db(&mysql, "my_database")) { fprintf(stderr, "Failed to create new database. mysql_error(&mysql)); }

Error: %s\n",

12.1.3.7 mysql_data_seek()
void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset)

788

MySQL Technical Reference for Version 5.0.0-alpha

Descrio ca
Busca um registro arbitrrio em um resultado de uma consulta. O valor do oset um a e nmero de linha e deve estar em uma faixa de 0 at mysql_num_rows(stmt)-1. u e Esta funo exige que a estrutura do resultado contenha todo o resultado da consulta, assim ca mysql_data_seek() s pode ser usado em conjunto com mysql_store_result(), no com o a mysql_use_result().

Valor Retornado
Nenhum.

Erros
Nenhum.

12.1.3.8 mysql_debug()
void mysql_debug(const char *debug)

Descrio ca
Faz um DBUG_PUSH com a string dada. mysql_debug() usa a biblioteca de depurao ca Fred Fish. Para utilizar esta funo voc deve compilar a biblioteca cliente para suportar ca e depurao. Veja Seo E.1 [Depurando o servidor], Pgina 1079. Veja Seo E.2 [Depurando ca ca a ca o cliente], Pgina 1085. a

Valor Retornado
Nenhum.

Erros
Nenhum.

Exemplo
A chamada mostrada aqui faz com que a biblioteca cliente gere um arquivo de rastreamento /tmp/client.trace na mquina cliente: a mysql_debug("d:t:O,/tmp/client.trace");

12.1.3.9 mysql_drop_db()
int mysql_drop_db(MYSQL *mysql, const char *db)

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

789

Descrio ca
Apaga o banco de dados nomeado pelo parmetro db. a Esta funo est obsoleta. E melhor utilizar mysql_query() para realizar uma instruo ca a ca SQL DROP DATABASE.

Valor Retornado
Zero se o banco de dados foi apagdo com sucesso. Diferente de zero ocorreu um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Exemplo
if(mysql_drop_db(&mysql, "my_database")) fprintf(stderr, "Failed to drop the database: Error: %s\n", mysql_error(&mysql));

12.1.3.10 mysql_dump_debug_info()
int mysql_dump_debug_info(MYSQL *mysql)

Descrio ca
Instrui o servidor a gravar algumas informaes de depurao no log. Para funcionar, o co ca usurio conectado deve ter pivilgio SUPER. a e

Valor Retornado
Zero se o comando obteve sucesso. Diferete de zero se ocorreu um erro.

790

MySQL Technical Reference for Version 5.0.0-alpha

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.11 mysql_eof()
my_bool mysql_eof(MYSQL_RES *result)

Descrio ca
Esta funo est obsoleta. mysql_errno() ou mysql_error() podem ser usados em seu ca a lugar. mysql_eof() determina se o ultimo registro de um resultado foi lido. Se voc buscar um resultado com um chamada mysql_store_result() bem sucedida, o e cliente recebe todo o resultado em uma operao. Neste caso, um valor NULL retornado de ca e mysql_fetch_row() sempre signica que o m do resultado foi atingido e no necessrio a e a chamar mysql_eof(). Quando usado com mysql_store_result(), mysql_eof() sempre retornar verdadeiro. a Por outro lado, se voc utilizar mysql_use_result() para iniciar um resultado recuperado, e as linhas do conjunto so obtido do servidor uma a uma, chamando mysql_fetch_row() a repetidamente. Como pode ocorrer um erro na conexo durante este processo, um valor NULL a retornado de mysql_fetch_row() no signica, necessriaemente, que o m do resultado a a fo atingido normalmente. Neste caso, voc pode utilizar mysql_eof() para determinar o e que aconteceu. mysql_eof() retorna um valor diferente de zero se o m do resultaod foi atingido e zero se ocorreu um erro. Historicamente, mysql_eof() preterido pelas funes de erro padro do MySQL mysql_ e co a errno() e mysql_error(). Como estas funes de erro fornecem a mesma informao, co ca o uso das duas ultimas preferido sobre mysql_eof(), a qual est obsoleta. (De fato, e a elas fornecem mais informaes, porque mysql_eof() retorna apenas um valor booleano co enquanto as funes de erro indicam uma razo para a ocorrncia do erro quando ele ocorre). co a e

Valor Retornado
Zero se nenhum erro ocorreu. Diferente de zero o m do resultado foi atingido.

Erros
Nenhum.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

791

Exemplo
Os exemplos seguintes mostram como voc deve usar mysql_eof(): e mysql_query(&mysql,"SELECT * FROM some_table"); result = mysql_use_result(&mysql); while((row = mysql_fetch_row(result))) { // faz algo com os dados } if(!mysql_eof(result)) // mysql_fetch_row() falha devido a um erro { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); } No entanto, voc pode conseguir o mesmo efeito com as funes de erro padres do MySQL: e co o mysql_query(&mysql,"SELECT * FROM some_table"); result = mysql_use_result(&mysql); while((row = mysql_fetch_row(result))) { // faz algo com os dados } if(mysql_errno(&mysql)) // mysql_fetch_row() falha devido a um erro { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); }

12.1.3.12 mysql_errno()
unsigned int mysql_errno(MYSQL *mysql)

Descrio ca
Para a conexo especicada pelo mysql, mysql_errno() retorna o cdigo de erro para a a o funo API chamada mais recentemente que tenha obtido sucesso ou falhado. Um valor de ca retorno de zero signica que um erro ocorreu. Nmeros de mensagens de erro de clientes u so listados no arquivo de cabealho errmsg.h do MySQL. Nmeros de mensagem de a c u erros do servidor so listados no arquivo mysqld_error.h. Na distribuio fonte do a ca MySQL voc pode encontrar uma lista completa de neros de mensagens de erro no arquivo e u Docs/mysqld_error.txt. Os cdigos de erros do servidor esto listados em Seo 13.1 o a ca [Error-returns], Pgina 889. a Note que algumas funes como mysql_fetch_row() no conguram o mysql_errno() se co a elas obterem sucesso. Uma regra do dedo que todas as funes que precisam perguntar ao servidor por ina e co formao iro zerar mysql_errno() se obterem sucesso. ca a

792

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
Um valor de cdigo de erro para a ultima chamada mysql xxx, se ele falhar, Zero signica o que nenhum erro ocorreu.

Erros
Nenhum.

12.1.3.13 mysql_error()
const char *mysql_error(MYSQL *mysql)

Descrio ca
Para a conexo especicada por mysql, mysql_error() retorna um string terminada em a null contendo a mensagem de erro para a funo de API chamda mais recentemente que ca tenha falhado. Se a funo no falhou, o valor de retorno de mysql_error() pode ser o ca a erro anterior ou uma string vazia para indicar que no ocorreu erro. a Uma regra do dedo que todas as funes que precisam pedir informao ao servidor iro a e co ca a zerar mysql_error() se obterem sucesso. Para todas as funes que zeram mysql_errno, os seguintes dois testes so equivalentes: co a if(mysql_errno(&mysql)) { // ocorreu um erro } if(mysql_error(&mysql)[0] != \0) { // ocorreu um erro } A l ingua da mensagem de erro do cliente pode ser alterada recompilando a biblioteca do cliente MySQL. Atualmente voc pode escolher mensagens de erro em vrias l e a inguas diferentes. Veja Seo 4.7.2 [Languages], Pgina 327. ca a

Valor Retornado
Uma string terminada em null que descreve um erro. Uma string vazia se nenhum erro ocorrer.

Erros
Nenhum.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

793

12.1.3.14 mysql_escape_string()
Voc deve usar mysql_real_escape_string() em seu lugar! e Esta funo identica a mysql_real_escape_string() exceto que mysql_real_escape_ ca e string() pega um manipulador de cnexo como seu primeiro argumento e escapa a string a de acordo com a conjunto de caracteres padro. mysql_escape_string() no utiliza um a a argumento de conexo e no respeita o conjunto de caracteres atual. a a

12.1.3.15 mysql_fetch_field()
MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result)

Descrio ca
Retorna a denio de uma coluna de um resultado como uma estrutura MYSQL_FIELD. ca Chame esta funo repetidamente para retornar informaes sobre todas as colunas no ca co resultado. mysql_fetch_field() retorna NULL quando no existirem mais campos. a mysql_fetch_field() denido para retornar a informao do primeiro campo cada vez e ca que voc executar uma nova consulta SELECT. O campo retornado por mysql_fetch_ e field() tambm afetado pela chamadas mysql_field_seek(). e e Se vov tiver chamado mysql_query() para realizar um SELECT em uma tabela mas no e a tiver chamado mysql_store_result(), MySQL retorna o tamanho padro do blob (8K a bytes) quando chamar mysql_fetch_field() para saber o tamanho de um campo BLOB. (O tamanho de 8 k escolhido porque o MySQL no sabe o tamanho mximo do BLOB. Ele e a a pode ser congurado algumas vezes.) Uma vez retornado o resultado, campo->tamanho_max contm o tamanho da maior valor para esta coluna em uma consulta espec e ica.

Valor Retornado
A estrutura MYSQL_FIELD para a coluna atual. NULL no houver mais colunas. a

Erros
Nenhum.

Exemplo
MYSQL_FIELD *field; while((field = mysql_fetch_field(result))) { printf("field name %s\n", field->name); }

794

MySQL Technical Reference for Version 5.0.0-alpha

12.1.3.16 mysql_fetch_fields()
MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result)

Descrio ca
Retorna um vetor de todas as estruturas MYSQL_FIELD no resultado. Cada estrutura fornece a denio do campo para uma coluna do resultado. ca

Valor Retornado
Um vetor da estrutura MYSQL_FIELD para todas as colunas no resultado.

Erros
Nenhum.

Exemplo
unsigned int num_fields; unsigned int i; MYSQL_FIELD *fields; num_fields = mysql_num_fields(result); fields = mysql_fetch_fields(result); for(i = 0; i < num_fields; i++) { printf("Field %u is %s\n", i, fields[i].name); }

12.1.3.17 mysql_fetch_field_direct()
MYSQL_FIELD *mysql_fetch_field_direct(MYSQL_RES *result, unsigned int fieldnr)

Descrio ca
Dado um nmero de campo fieldnr para uma colua em resultado, retorna a informao u ca de campo daquela coluna como uma estrutura MYSQL_FIELD Voc pode utilizar esta funo e ca para retornar a denio para uma coluna arbitrria. O valor de fieldnr deve estar na ca a faixa de 0 a mysql_num_fields(result)-1.

Valor Retornado
A estrutura MYSQL_FIELD para uma coluna espec ica.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

795

Erros
Nenhum.

Exemplo
unsigned int num_fields; unsigned int i; MYSQL_FIELD *field; num_fields = mysql_num_fields(result); for(i = 0; i < num_fields; i++) { field = mysql_fetch_field_direct(result, i); printf("Field %u is %s\n", i, field->name); }

12.1.3.18 mysql_fetch_lengths()
unsigned long *mysql_fetch_lengths(MYSQL_RES *result)

Descrio ca
Retorna o tamanho da coluna do registro atual em um resultado. Se voc planeja copiar e calores dos compos, esta informao de tamanho util tambm para a otimizao, ca e e ca porque voc pode evitar a chamada strlen(). Se o resultado contm dados birios, voc e e a e deveutilizar esta funo para determinar o tamanho dos dados, pois strlen() retorna um ca valor incorreto para quaquer campo contendo caracteres nulos. O tamanho para colunas vazias e para colunas contendo valores NULL zero. Para ver como e distnguir este dois casos, veja a descrio de mysql_fetch_row(). ca

Valor Retornado
Um vetor de unsigned long integers (inteiros longos sem sinal) representando o tamanho de cada coluna (no incluindo nenhuma caracter nulo). NULL se ocorrer um erro. a

Erros
mysql_fetch_lengths() s vlido para o registro atual no resultado. Ele retorna NULL oe a se voc cham-lo antes de mysql_fetch_row() ou depois de retornar todos os registros em e a um resultado.

Exemplo
MYSQL_ROW row;

796

MySQL Technical Reference for Version 5.0.0-alpha

unsigned long *lengths; unsigned int num_fields; unsigned int i; row = mysql_fetch_row(result); if (row) { num_fields = mysql_num_fields(result); lengths = mysql_fetch_lengths(result); for(i = 0; i < num_fields; i++) { printf("Column %u is %lu bytes in length.\n", i, lengths[i]); } }

12.1.3.19 mysql_fetch_row()
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

Descrio ca
Recuera o prximo registro do resultado. Quando usado depois de mysql_store_result(), o mysql_fetch_row() retorna NULL quando no houver mais registros para retornar. Quando a usado depois de mysql_use_result(), mysql_fetch_row() retorna NULL quando no houa ver mais registros para retornar ou ocorrer um erro. O nmero de valores no registro dado por mysql_num_fields(result). Se row guarda u e o valor retornado de uma chamada mysql_fetch_row(), apontadores para os valores so a acessados como row[0] a row[mysql_num_fields(result)-1]. Valores NULL no registro so indicados por apontadores NULL. a Os tamanhos dos valores do campo no registro poden ser obtidos chamando mysql_fetch_ lengths(). Campos vazios e campos contendo NULL tem tamanho 0; voc pode distingui-los e vericando o apontador para o valor do campo. Se o apontador NULL, o campo NULL; e e seno o campo est vazio. a a

Valor Retornado
Uma estrutura MYSQL_ROW para o prximo registro. NULL se no houver mais linhas para o a retornar ou ocorrer um erro.

Erros
Note que o erro no zerado entre as chamadas a mysql_fetch_row() a e CR_SERVER_LOST A conexo com o servidor foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

797

Exemplo
MYSQL_ROW row; unsigned int num_fields; unsigned int i; num_fields = mysql_num_fields(result); while ((row = mysql_fetch_row(result))) { unsigned long *lengths; lengths = mysql_fetch_lengths(result); for(i = 0; i < num_fields; i++) { printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL"); } printf("\n"); }

12.1.3.20 mysql_field_count()
unsigned int mysql_field_count(MYSQL *mysql) Se voc estiver utilizando uma verso anterior a verso 3.22.24 do MySQL, voc deve utilizar e a a e unsigned int mysql_num_fields(MYSQL *mysql).

Descrio ca
Retorna o nmero de colunas para a consulta mais recente na conexo. u a Normalmente esta funo utilizada quando mysql_store_result() retorna NULL (ento ca e a voc no possui um apontador para o resultado). Neste caso, voc pode chamar mysql_ e a e field_count() para determinar se mysql_store_result() no produziu um resultado a vazio. Isto permite que o programa cliente tome a ao aprpriada sem saber se a consulta ca foi uma instruo SELECT (ou do mesmo tipo). O exemplo mostrado aqui ilustra como isto ca pode ser feito. Veja Seo 12.1.12.1 [NULL mysql_store_result()], Pgina 861. ca a

Valor Retornado
Um unsigned integer (inteiro sem sinal) representando o nmero de campo em um resultado. u

Erros
Nenhum.

798

MySQL Technical Reference for Version 5.0.0-alpha

Exemplo
MYSQL_RES *result; unsigned int num_fields; unsigned int num_rows; if (mysql_query(&mysql,query_string)) { // error } else // query succeeded, process any data returned by it { result = mysql_store_result(&mysql); if (result) // there are rows { num_fields = mysql_num_fields(result); // retrieve rows, then call mysql_free_result(result) } else // mysql_store_result() returned nothing; should it have? { if(mysql_field_count(&mysql) == 0) { // query does not return data // (it was not a SELECT) num_rows = mysql_affected_rows(&mysql); } else // mysql_store_result() should have returned data { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); } } } Uma alternativa substituir a chamada mysql_field_count(&mysql) com e mysql_errno(&mysql). Neste caso, voc est vericando diretamente um erro de e a mysql_store_result() em vez de conferir o valor de mysql_field_count() se a instruo ca foi uma SELECT.

12.1.3.21 mysql_field_seek()
MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)

Descrio ca
Dene o cursor campo com o oset dado. A prxima chamada para mysql_fetch_field() o ir recuperar a denio de campo da coluna associada com o oset. a ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

799

Para buscar o inicio de um registro, passe zero como valor do offset.

Valor Retornado
O valor anterior do cursor de campo.

Erros
Nenhum.

12.1.3.22 mysql_field_tell()
MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES *result)

Descrio ca
Retorna a posio do cursos do campo usado pelo ultimo mysql_fetch_field(). Este valor ca pode ser usado como um argumento para mysql_field_seek().

Valor Retornado
O oset atual do cursor de campo.

Erros
Nenhum.

12.1.3.23 mysql_free_result()
void mysql_free_result(MYSQL_RES *result)

Descrio ca
Libera a memria alocada para o resultado por mysql_store_result(), mysql_use_ o result(), mysql_list_dbs(), etc. Quando voc nalizar o uso do resultado, voc deve e e liberar a memria utilizada chamando mysql_free_result(). o

Valor Retornado
Nenhum.

Erros
Nenhum.

800

MySQL Technical Reference for Version 5.0.0-alpha

12.1.3.24 mysql_get_client_info()
char *mysql_get_client_info(void)

Descrio ca
Retorna uam string que representa a verso da biblioteca cliente. a

Valor Retornado
Uma string representando a verso da biblioteca cliente do MySQL. a

Erros
Nenhum.

12.1.3.25 mysql_get_client_version()
unsigned long mysql_get_client_version(void)

Descrio ca
Retorna um inteiro que representa a verso da biblioteca cliente. O valor tem o formato a XYYZZ onde X a verso principal, YY o nivel da distribuico e ZZ o nmero da verso e a e a e u a dentro do n da distribuio. Por exemplo, um valor de 40102 representa uma biblioteca ivel ca cliente na verso 4.1.2. a

Valores de Retorno
Um inteiro que representa a verso da biblioteca clientes do mysql. a

Erros
Nenhum.

12.1.3.26 mysql_get_host_info()
char *mysql_get_host_info(MYSQL *mysql)

Descrio ca
Retorna uma string descrevendo o tipo da conexo em uso, incluindo o nome da maquina a servidora.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

801

Valor Retornado
Uma string respresntando o nome da mquina servidora e o tipo de conexo. a a

Erros
Nenhum.

12.1.3.27 mysql_get_proto_info()
unsigned int mysql_get_proto_info(MYSQL *mysql)

Descrio ca
Retorna a verso do protocolo usado pela conexo atual. a a

Valor Retornado
Um unsigned integer (inteiro sem sinal) representando a verso do protocolo usado pela a conexo atual. a

Erros
Nenhum.

12.1.3.28 mysql_get_server_info()
char *mysql_get_server_info(MYSQL *mysql)

Descrio ca
Retorna um string que representa o nmero da verso do servidor. u a

Valor Retornado
Um string representando o nmero da verso do servidor. u a

Erros
Nenhum.

12.1.3.29 mysql_get_server_version()
unsigned long mysql_get_server_version(MYSQL *mysql)

802

MySQL Technical Reference for Version 5.0.0-alpha

Descrio ca
Retorna o nmero de verso do servidor como um inteiro (novo na verso 4.1) u a a

Valor Retornado
Um nmero que representa a verso do servidor MySQL no formato: u a verso principal*10000 + verso menor*100 + sub verso a a a Por exemplo, 4.1.0 retornado como 40100. e Ela util para determinar a verso do servidor rapidamente em um programa cliente para e a saber se algumas capacidades existem.

Erros
Nenhum.

12.1.3.30 mysql_info()
char *mysql_info(MYSQL *mysql)

Descrio ca
Retorna um string fornecendo informao sobre a consulta executada mais recentemente, ca mas apenas para as instrues listadas aqui. Para outras inastrues, mysql_info() retorna co co NULL. O formato da string varia dependendo do tipo de consulta, como descrito aqui. Os nmeros so apenas ilustrativos; a string ir conter valores apropriados para a consulta. u a a INSERT INTO ... SELECT ... Formato da string: Records: 100 Duplicates: 0 Warnings: 0 INSERT INTO ... VALUES (...),(...),(...)... Formato da string: Records: 3 Duplicates: 0 Warnings: 0 LOAD DATA INFILE ... Formato da string: Records: 1 Deleted: 0 Skipped: 0 Warnings: 0 ALTER TABLE Formato da string: Records: 3 Duplicates: 0 Warnings: 0 UPDATE Formato da string: Rows matched: 40 Changed: 40 Warnings: 0 Note que mysql_info() retorna um valor no-NULL para INSERT ... VALUES somente na a forma de mltiplas linhas da instruo (isto , apenas se uma lista com vrios valores u ca e a e especicada).

Valor Retornado
Uma string represntando informao adicional sobre a consulta executada mais recenteca mente. NULL se no houver nenhuma informao dispon para a consulta. a ca ivel

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

803

Erros
Nenhum.

12.1.3.31 mysql_init()
MYSQL *mysql_init(MYSQL *mysql)

Descrio ca
Aloca ou inicializa um objeto MYSQL apropriado para mysql_real_connect(). Se mysql e um ponteiro NULL, a funo aloca, inicializa e retorna um novo objeto. Seno o objeto ca a e inicializado e o endereo do objeto retornado. Se mysql_init() aloca um novo objeto, c e ele ser liberado quando mysql_close() for chamado para fechar a conexo. a a

Valor Retornado
Um handle MYSQL* inicializado. NULL se no houver memria suciente para alocar o novo a o objeto.

Erros
Em caso de memria insuciente, NULL retornado. o e

12.1.3.32 mysql_insert_id()
my_ulonglong mysql_insert_id(MYSQL *mysql)

Descrio ca
Retorna o ID gerado para uma coluna AUTO_INCREMENT pela consulta anterior. Use esta funo depois de ter realizado um consulta INSERT em uma tabela que contenha um campo ca AUTO_INCREMENT. Note que mysql_insert_id() retorna 0 se a consulta anterior no gerar um valor AUTO_ a INCREMENT. Se voc desejar salvar o valor para uso posterior, chame mysql_insert_id() e imediatamente depois da consulta que gerou o valor. Se a consulta anterior retornar um erro, o valor de mysql_insert_id() indenido. e mysql_insert_id() atualizado depois de instrues INSERT e UPDATE que geram um valor e co AUTO_INCREMENT ou que denem um valor de coluna com LAST_INSERT_ID(expr). Veja Seo 6.3.6.2 [Funes diversas], Pgina 547. ca co a Note tambm que o valor da funo SQL LAST_INSERT_ID() sempre contm o o valor AUTO_ e ca e INCREMENT gerado mais recentemente e no zerado entre as consultas porque o valor desta a e funo mantido no servidor. ca e

804

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
O valor do campo AUTO_INCREMENT que foi atualizado pela consulta anterior. Retorna zero se no houve consultas anteriores na conexo ou se a consulta no atualizou o valor a a a AUTO_INCREMENT.

Erros
Nenhum.

12.1.3.33 mysql_kill()
int mysql_kill(MYSQL *mysql, unsigned long pid)

Descrio ca
Diz para o servidor matar um thread especicada pelo pid.

Valor Retornado
Zero em caso de sucesso. Diferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.34 mysql_list_dbs()
MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)

Descrio ca
Retorna um resultado com nome de banco de dados no servidor que correspondem a uma expresso regular especicada pelo parmetro wild. wild pode conter o meta caracteres % a a ou _, ou pode ser um ponteiro NULL para coreesponder a todos os banco de dados. Chamar mysql_list_dbs() o mesmo que executar a consulta SHOW databases [LIKE wild]. e Voc deve liberar o resultado com mysql_free_result(). e

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

805

Valor Retornado
Um conjunto de resultados MYSQL_RES no caso de sucesso. NULL se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.35 mysql_list_fields()
MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)

Descrio ca
Retorna um resultado contendo nomes de campos de uma tabela dada que correspondam a expresso regular especicada pelo parmetro wild. wild pode conter os metacaracteres % a a ou _, ou pode ser um ponteiro NULL para corresponder a todos os campos. Chamar mysql_ list_fields() o mesmo que executar a consulta SHOW COLUMNS FROM nome_tabela [LIKE e wild]. Note que recomendado que voc use SHOW COLUMNS FROM nome_tabela em vez de mysql_ e e list_fields(). Voc deve liberar o resultado com mysql_free_result(). e

Valor Retornado
Um conjunto de resultados MYSQL_RES em caso de sucesso. NULL se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a

806

MySQL Technical Reference for Version 5.0.0-alpha

CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.36 mysql_list_processes()
MYSQL_RES *mysql_list_processes(MYSQL *mysql)

Descrio ca
Retorna um resultado descrevendo a thread atual do servidor. E o mesmo tipo de informao ca relatado por mysqladmin processlist ou uma consulta SHOW PROCESSLIST. Voc deve liberar o resultado com mysql_free_result(). e

Valor Retornado
Um conjunto de resultados MYSQL_RES em caso de sucesso. NULL se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.37 mysql_list_tables()
MYSQL_RES *mysql_list_tables(MYSQL *mysql, const char *wild)

Descrio ca
Retorna um resultado contendo nomes de tabelas no banco de dados atual que correspondam a expresso regular especicada pelo parmetro wild. wild pode conter os mets caracteres a a % or _, ou pode ser uma ponteiro NULL para corresponde a todas as tabelas. Chamar mysql_list_tables() o mesmo que executar a consulta SHOW tables [LIKE wild]. e Voc deve liberar o resultado com mysql_free_result(). e

Valor Retornado
Um conjunto de resultados MYSQL_RES em caso de sucesso. NULL se ocorrer um erro.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

807

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.38 mysql_num_fields()
unsigned int mysql_num_fields(MYSQL_RES *result) ou unsigned int mysql_num_fields(MYSQL *mysql) A segunda forma no funciona na verso 3.22.24 ou mais novas do MySQL. Para passar um a a argumento MYSQL* voc de utilizar unsigned int mysql_field_count(MYSQL *mysql) em e seu lugar.

Descrio ca
Retorna o nmero de colunas em um resultado. u Note que voc pode obter o nmero de colunas com um ponteiro para o conjunto de resule u tados ou para um manipulador (handle) de conexo. Voc usaria o manipular de conexo a e a se mysql_store_result() ou mysql_use_result() retorna NULL (ento voc no tem um a e a ponteiro para o resultado). Neste caso, voc pode chamar mysql_field_count() para dee terminar se mysql_store_result() no produziu um resultado vazio. Isto permite que o a programa cliente tome a ao apropriada sem saber se a consulta foi uma instruo SELECT ca ca (ou do tipo SELECT). O exemplo mostrado abaixo ilustra como isto pode ser feito. Veja Seo 12.1.12.1 [NULL mysql_store_result()], Pgina 861. ca a

Valor Retornado
Um unsigned integer (inteiro sem sinal) representando o nmero de campos no conjunto de u resultasdos.

Erros
Nenhum.

808

MySQL Technical Reference for Version 5.0.0-alpha

Exemplo
MYSQL_RES *result; unsigned int num_fields; unsigned int num_rows; if (mysql_query(&mysql,query_string)) { // erro } else // query succeeded, process any data returned by it { result = mysql_store_result(&mysql); if (result) // existem resgitros { num_fields = mysql_num_fields(result); // retorna registros e chama mysql_free_result(result) } else // mysql_store_result() retorna vazio; era esperado? { if (mysql_errno(&mysql)) { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); } else if (mysql_field_count(&mysql) == 0) { // consulta n~o retora dados a // (ela n~o era um SELECT) a num_rows = mysql_affected_rows(&mysql); } } } Uma alternativa (se voc souber qyue a sua consulta retornou um resultado) substituir e e a chamada mysql_errno(&mysql) pela vericao de se mysql_field_count(&mysql) = ca e 0. Isto s acontece se alguma coisa der errado. o

12.1.3.39 mysql_num_rows()
my_ulonglong mysql_num_rows(MYSQL_RES *result)

Descrio ca
Retorna o nmero de linhas em um resultado. u O uso de mysql_num_rows() depende de se voc utiliza mysql_store_result() ou mysql_ e use_result() para retornar o resultado. Se voc usa mysql_store_result(), mysql_num_ e rows() pode ser chamado imediatamente. Se voc usa mysql_use_result(), mysql_num_ e

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

809

rows() no retornar o valor correto at que todas as linhas no resultado tenham sido a a e recuperadas.

Valor Retornado
O nmero de linhas no resultado. u

Erros
Nenhum.

12.1.3.40 mysql_options()
int mysql_options(MYSQL *mysql, enum mysql_option option, const char *arg)

Descrio ca
Pode ser usado para denir opes extras de conexo e afetar o comportamento de uma co a conexo. Esta funo pode ser chamada vrias vezes para denir diversas opes. a ca a co mysql_options() deve ser chamado depois de mysql_init() e antes de mysql_connect() ou mysql_real_connect(). O argumento option a opo que voc que denir; o argumento arg o valor para a e ca e e opo. Se a opo um inteiro, ento arg deve apontar para o valor do inteiro. ca ca e a Valores poss iveis para as opes: co Opo ca MYSQL_OPT_CONNECT_TIMEOUT MYSQL_OPT_COMPRESS MYSQL_OPT_READ_TIMEOUT Tipo de argumento unsigned int * No usado a unsigned int * unsigned int * ponteiro para unsigned integer opcional No usado a Funo ca Tempo limite de conexo em a segundos. Usa o protocolo cliente/servidor compactado. Limite de tempo para a leitura do servidor (funciona atualmente apenas no Windows em conexes TCP/IP) o Limite de tempo para a escrita no servidor (funciona atualmente apenas no Windows em conexes TCP/IP) o Se nenhum ponteiro for dado ou se apontar para um unsigned int != 0 o comando LOAD LOCAL INFILE est habilitado. a Usa named pipes para conectar ao servidor MySQL no NT.

MYSQL_OPT_WRITE_TIMEOUT

MYSQL_OPT_LOCAL_INFILE

MYSQL_OPT_NAMED_PIPE

810

MySQL Technical Reference for Version 5.0.0-alpha

MYSQL_INIT_COMMAND

char *

MYSQL_READ_DEFAULT_FILE MYSQL_READ_DEFAULT_GROUP

char * char *

MYSQL_OPT_PROTOCOL

unsigned int * char*

MYSQL_SHARED_MEMORY_BASE_NAME

Comando para executar ao conectar ao servidor MySQL. Ser automaticamente execua tado ao se reconectar. L opes do arquivo de opes e co co denido no lugar de my.cnf. L opes do grupo indicado no e co arquivo my.cnf ou no arquivo especicado com MYSQL_READ_ DEFAULT_FILE. Tipo de protocolo usado. Deve ser um dos valores apresentados em mysql_protocol_type denido no mysql.h. Nome do objeto em meria para o comunicao com o servidor. ca Deve ser o mesmo que a opo ca shared-memory-base-name usada para o servidor mysqld no qual voc quer se conectar. e

Note que o grupo client sempre lido se voc utiliza MYSQL_READ_DEFAULT_FILE ou MYSQL_ e e READ_DEFAULT_GROUP. O grupo especicado no arquivo de ops pode conter as seguintes opes: co co Opo ca connect-timeout compress database debug disable-localinfile host init-command interactivetimeout localinfile[=(0|1)] max_allowed_packet password pipe Descrio ca Tempo limite de conexo em segundos. No Linux a este tempo limite tambm utilizado para esperar e e pela primeira resposta do servidor Utiliza o protocolo cliente/servidor compactado. Conecta a este banco de dados se nenhum banco de dados for especicado no comando de conexo. a Opes de depurao. co ca Disabilita o uso de LOAD DATA LOCAL. Nome de mquina padro. a a Comando para executar ao conectar ao servidor MySQL. Ser executado automaticamente ao a reconectar. O mesmo que o especicado em CLIENT_ INTERACTIVE para mysql_real_connect(). Veja Seo 12.1.3.43 [mysql real connect], Pgina 813. ca a Se no houver argumento ou o argumento for difera ente de 0 habilita o uso de LOAD DATA LOCAL. Tamanho mximo dos pacotes que o cliente pode ler a do servidor. Senha padro. a Usa named pipes para conectar ao servidor MySQL no NT.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

811

protocol=(TCP | SOCKET | PIPE | MEMORY) port return-found-rows

Qual protocolo usar ao conectar no servidor (Novo na verso 4.1) a

Nmero padro da porta. u a Diz ao mysql_info() para retornar registros encontrados no lugar de registros atualizados ao usar UPDATE. shared-memoryNome da memria comprtilhada utilizada para o base-name=name conectar ao servidor (o padro "MySQL"). Novo a e na verso 4.1. a socket Nmero padro do socket. u a user Usurio padro. a a Note que timeout foi substituido por connect-timeout, mas timeout ainda funcionar a por enquanto. Para maiores informaes sobre arquivos de opes, veja Seo 4.1.2 [Arquivo de opes], co co ca co Pgina 216. a

Valor Retornado
Zero em caso de sucesso. Diferente de zero se voc utilizar uma opo desconhecida. e ca

Exemplo
MYSQL mysql; mysql_init(&mysql); mysql_options(&mysql,MYSQL_OPT_COMPRESS,0); mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"odbc"); if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)) { fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql)); } O exemplo acima diz ao cliente para usar o protocolo cliente/servidor compactado e ler a opo adicional da seo odbc no arquivo de opes my.cnf. ca ca co

12.1.3.41 mysql_ping()
int mysql_ping(MYSQL *mysql)

Descrio ca
Verica se a conexo ao servidor est funcionando. Se ela tiver ca feita uma tentativa a a ido e de conexo automaticamente. a Esta funo pode ser usada pelos clientes que se cam inativo por um longo tempo para ca vericar se o servidor fechou a conexo e reconectar se necessrio. a a

812

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
Zero se o servidor estiver funcionando. Diferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.42 mysql_query()
int mysql_query(MYSQL *mysql, const char *query)

Descrio ca
Executa uma consulta SQL apontada pela string terminada em null query. A consulta deve deve consistir de uma unica instruo SQL. Voc no deve adicionar ponto e v ca e a irgula (;) ou \g ao m da instruo. ca mysql_query() no pode ser usadas por consultas que contenham dados binrios; voc deve a a e utilizar mysql_real_query() em seu lugar. (Dados binrios podem conter o caracter \0, a que mysql_query() interpreta como o m a string de consulta.) Se voc quiser saber se a consulta deve retornar um resultado ou no, voc pode utilizar e a e mysql_field_count() para vericar isto. Veja Seo 12.1.3.20 [mysql_field_count()], ca Pgina 797. a

Valor Retornado
Zero se a consulta obteve sucesso. Diferente de zero se ocorreu um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

813

12.1.3.43 mysql_real_connect()
MYSQL *mysql_real_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd, const char *db, unsigned int port, const char *unix_socket, unsigned long client_flag)

Descrio ca
mysql_real_connect() tenta estabelecer uma conexo mecanismo MySQL de banco de a dados executando em host. mysql_real_connect() deve completar com suceeso antes que voc possa executar qualquer um das outars funoes da API, com a excesso de mysql_ e ca a get_client_info(). Os parmetros so especicados da seguinte forma: a a O primeiro parmetro deve ser o endereo de uma estrutura MYSQL existente. Antes a c de chamar mysql_real_connect() voc deve chamar mysql_init() para inicializar a e estrutura MYSQL. Voc pode alterar vria opes de conexo com a chamada mysql_ e a co a options(). Veja Seo 12.1.3.40 [mysql options], Pgina 809. ca a O valor de host pode ser tanto um nome de mquivo quanto um endereo IP. Se host a c NULL ou a string "localhost", a conexo feita na mquina local. Se o SO suporta e a e a sockets (Unix) ou named pipes (Windows), eles so utilizados em vez de TCP/IP para a a conexo ao servidor. a O parmetro user contm a indeticao do usurio MySQL. Se user NULL ou a a e ca a e string vazia "", considera-se o usurio padro. Sob Unix, ele o login atual. Sob ODBC a a e no Windows, o usurio atual deve ser especicado explicitamente. Veja Seo 12.2.2 a ca [Administrador ODBC], Pgina 871. a O parmetro passwd contm a senha para user. Se passwd NULL, somente entradas a e e na tabela user para usurios que tenham campo de senha em branco (vazia) sero a a vericados ipor um padro coincidenete. Isto permite que o admistrador do banco a de dados congure o sistema de privilgios do MySQL de tal maneira que usurios e a os usurios conseguiro privileios diferentes, dependendo se ele espcicou ou no uma a a a senha. Nota: No tente criptografar a senha antes de chamar mysql_real_connect(); senhas a criptografadas so tratadas automaticamente pela API cliente. a db o nome de banco de dados. Se db no NULL, a conexo denir o banco de dados e a e a a padro com este valor. a Se port no 0, o valor ser usado como o nmero da porta para as conexes TCP/IP. a e a u o Note que o parmetro host determina o tipo da conexo. a a Se unix_socket no NULL, a string especica o socket ou named pipe que deve ser a e usado. Note que o parmetro host determina o tipo de conexo. a a O valor de client_flag normalmente 0, mas pode ser denido como uma combinao e ca dos parmetro seguintes em circunstncias especiais: a a Nome do parmetro a CLIENT_COMPRESS Descrio do parmetro ca a Usa protocolo compactado.

814

MySQL Technical Reference for Version 5.0.0-alpha

CLIENT_FOUND_ROWS CLIENT_IGNORE_SPACE CLIENT_INTERACTIVE CLIENT_LOCAL_FILES CLIENT_MULTI_ STATEMENTS

CLIENT_MULTI_RESULTS

CLIENT_NO_SCHEMA

CLIENT_ODBC CLIENT_SSL

Retorna o nmero de linhas encontradas (corresponu dentes a um padro), no o nmero de linha efetivo. a a u Permite espao depois do nome de funes. torna todos c co os nomes de funes palavras reservadas. co Permite interactive_timeout segundos (no lugar de wait_timeout segundos) de inatividade antes de fechar a conexo. a Habilita LOAD DATA LOCAL. Diz ao servidor que o cliente pode enviar consultas multi linhas (separado com ;). Se este parmetro no est a a a denido, consultas de multil linhas est disabilitado. a (Novo na verso 4.1). a Diz ao servidor que o cliente pode tratar mult iplos conjuntos de resultados de um multi consulta ou stored procedures. Isto denido automaticamente se CLIENT_ e MULTI_STATEMENTS est lidado. Novo na verso 4.1. a a No permite a sintaxe db_name.nome_tabela.nome_ a coluna. Isto para o ODBC. Ele faz com que o anale izador gere um erro se voc utilizar aquela sintaxe. E util e para achar erros em alguns programas ODBC. O cliente um cliente ODBC. Torna o mysqld mais e amigvel ao ODBC. a Usa SSL (protocolo criptografado). Esta opo no deve ca a ser congurao pelo aplicativo; ele denida internaca e mente na biblioteca cliente.

Valor Retornado
Um handle de conexo MYSQL* se a conexo foi obtida com sucesso, NULL se a conexo a a a falhou. Para um conexo estabelecida o valor de retorn o mesmo que o valor do primeiro a e parmetro. a

Erros
CR_CONN_HOST_ERROR Falhou ao conectar ao servidor MySQL. CR_CONNECTION_ERROR Falhou ao conectar ao servidor MySQL local. CR_IPSOCK_ERROR Falhou au criar um socket IP. CR_OUT_OF_MEMORY Sem memria. o CR_SOCKET_CREATE_ERROR Falhou ao criar um socket Unix. CR_UNKNOWN_HOST Falhou ao procurar o endereo IP para o nome de maquina. c

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

815

CR_VERSION_ERROR Um erro de protocolo resultou da tentativa de conexao a um servidor com uma biblioteca cliente que utiliza uma verso de protocolo diferente. Isto pode a acontecer se voc utiliza uma biblioteca cliente muito antiga para se conectar a e um novo servidor qua no foi iniciado com a opo --old-protocol. a ca CR_NAMEDPIPEOPEN_ERROR Falhou ao criar um named pipe no Windows. CR_NAMEDPIPEWAIT_ERROR Falhou ao esperar por um named pipe no Windows. CR_NAMEDPIPESETSTATE_ERROR Falhou ao conseguir mainpulador do pipe no Windows. CR_SERVER_LOST Se connect_timeout > 0 e leva mais que connect_timeout segundos para conectar ao servidor ou se o servidro foi nalizado ao executar o init-command.

Exemplo
MYSQL mysql; mysql_init(&mysql); mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"seu_programa"); if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)) { fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql)); } Usando mysql_options() a biblioteca MySQL ir ler as sees [client] e [seu_programa] a co no arquivo my.cnf o qual ir assegurar que seu programa ir funcionar, mesmo se alguem a a tiver congurado o MySQL de um modo fora do padro. a Note que sob a conexo, mysql_real_connect() dene o parmetro reconnect (parte da a a estrutura MYSQL) para um valor de 1. Este parmetro indica, no evento em que uma consulta a no pode ser realizada devido a perda de conexo, para tentar se reconectar ao servidor a a antes de esgotar as tentativas.

12.1.3.44 mysql_real_escape_string()
unsigned long mysql_real_escape_string(MYSQL *mysql, char *to, const char *from, unsigned long length)

Descrio ca
A funo usada para criar um string SQL vlida que voc pode usar em uma instruo ca e a e ca SQL. Veja Seo 6.1.1.1 [Sintaxe de string], Pgina 469. ca a

816

MySQL Technical Reference for Version 5.0.0-alpha

A string em from codicada para uma string SQL com escape, levando em conta o conjunto e de caracteres atual da conexon. O resultado colocada em to e uma byte nulo de termino a e ca adcionado. Caracteres codicados so NUL (ASCII 0), \n, \r, \, , " e Control-Z e a (veja Seo 6.1.1 [Literais], Pgina 469). (O MySQL precisa que apenas a barra invertida ca a e as aspas utilizadas para citar a consulta sejam escapadas. Esta funo coloca os outros ca caracteres entre aspas para torn-lo mais fcil de ser lido em arquivos log.) a a A string apontada por from deve ter o tamanho de length bytes. Voc deve alocar o buer e to para o tamanho de pelo menos length*2+1 bytes. (No pior caso, cada caracter pode precisar de ser codicado como se utilizasse dois bytes, e voc preciria de espao para o e c byte null de terminao.) Quando mysql_real_escape_string() retornar, o contedo de ca u to ser uma string terminada em null. O valor o tamanho da string codicada. no a e a incluindo o caracter nulo usado para terminar a string.

Exemplo
char query[1000],*end; end = strmov(query,"INSERT INTO test_table values("); *end++ = \; end += mysql_real_escape_string(&mysql, end,"Whats this",11); *end++ = \; *end++ = ,; *end++ = \; end += mysql_real_escape_string(&mysql, end,"binary data: \0\r\n",16); *end++ = \; *end++ = ); if (mysql_real_query(&mysql,query,(unsigned int) (end - query))) { fprintf(stderr, "Failed to insert row, Error: %s\n", mysql_error(&mysql)); } A funo strmov() usada no exemplo est inclu na biblioteca mysqlclient e funciona ca a ida como strcpy() mas retorna um ponteiro para null de terminao do primeiro parmetro. ca a

Valor Retornado
O tamanho do valor colocado em to, no incluindo o caracter null de terminao. a ca

Erros
Nenhum.

12.1.3.45 mysql_real_query()
int mysql_real_query(MYSQL *mysql, const char *query, unsigned long length)

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

817

Descrio ca
Executa a consulta SQL apontada por query, que deve ser uma string de length bytes. A consulta deve consistir de uma instruo SQL simples. Voc no deve adicionar um ponto ca e a e virgula (;) ou \g no m da instruo. ca Voc deve utilizar mysql_real_query() em lugar de mysql_query() para consultas que e contenham dados binrios, pois eles podem conter o caracter \0. Alm disso, mysql_real_ a e query() mais rpido que mysql_query() pois ele no faz chamadas strlen() na string e a a de consulta. Se voc quiser saber se a consulta retornou um resultado ou no, voc pode usar mysql_ e a e a field_count(). Veja Seo 12.1.3.20 [mysql eld count], Pgina 797. ca

Valor Retornado
Zero se a consulta obteve sucesso. Deiferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.46 mysql_reload()
int mysql_reload(MYSQL *mysql)

Descrio ca
Diz ao servidor MySQL para recarregar a tabela de ables. The connected user must have the RELOAD privilege. This function is deprecated. It is preferable to use mysql_query() to issue a SQL FLUSH PRIVILEGES statement instead.

Valor Retornado
Zero for success. Non-zero if an error occurred.

818

MySQL Technical Reference for Version 5.0.0-alpha

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.47 mysql_row_seek()
MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset)

Descrio ca
Atribui ao cursor de linha um registro arbitrrio em resultado de uma consulta. O valor a do offset um oset do registro que deve ser um valor retornado de mysql_row_tell() e ou mysql_row_seek(). Este valor no simplesmente um nmero de linha; se voc quiser a u e buscar um registro em um resultado usando o nmero de linha utilize mysql_data_seek(). u Esta funo exige que a estrutura do resultado contenha todo o resultado da consulta, assim ca mysql_row_seek() pode ser um usado em conjunto apenas com mysql_store_result(), e no com mysql_use_result(). a

Valor Retornado
O valor anterior do cursor de linha. Este valor pode ser passado a uma chamada subsequente mysql_row_seek().

Erros
Nenhum.

12.1.3.48 mysql_row_tell()
MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result)

Descrio ca
Retorna a posio atual do cursor de linha para a ultima mysql_fetch_row(). Este valor ca pode ser utilizado como argumento para mysql_row_seek(). Voc deve utilizar mysql_row_tell() somente depois de mysql_store_result(), e no e a depois de mysql_use_result().

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

819

Valor Retornado
O oset atual do cursos de linha.

Erros
Nenhum.

12.1.3.49 mysql_select_db()
int mysql_select_db(MYSQL *mysql, const char *db)

Descrio ca
Faz com que o banco de dados espexcicado por db se torne o padro (atual) na conexo a a especicada por mysql. Nas consultas seguintes este banco de dados o padro para tabelas e a que no incluem uma especicao explicita para o banco de dados. a ca mysql_select_db() falha a menos que o usurio conectado possa ser autenticado com a permisso para utilizar o banco de dados. a

Valor Retornado
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.50 mysql_set_server_option()
int mysql_set_server_option(MYSQL *mysql, enum enum_mysql_set_option option)

Descrio ca
Habilita ou desabilita uma opo para a conexo. option por ter um dos seguintes valores: ca a MYSQL OPTION MULTI STATEMENTS ON multi instrues. Habilita suporte a co MYSQL OPTION MULTI STATEMENTS OFF multi instrues. Desabilita suporte a co

820

MySQL Technical Reference for Version 5.0.0-alpha

Valores Retornados
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a ER_UNKNOWN_COM_ERROR O servidor no suportou mysql_set_server_option() (que o caso no qual o a servidor mais antigo que 4.1.1) ou o servidor no suportou a opo que se e a ca tentou denir.

12.1.3.51 mysql_shutdown()
int mysql_shutdown(MYSQL *mysql)

Descrio ca
Diz ao servidor de banco de dados para nalizar. O usurio conectado deve ter privilgio a e SHUTDOWN.

Valor Retornado
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.52 mysql_sqlstate()
const char *mysql_sqlstate(MYSQL *mysql)

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

821

Descrio ca
Retorna uma string terminada em null contendo o cdigo de erro SQLSTATE para o ultimo o erro. O cdigo de erro consiste de cinco caracteres. 00000 signica sem erros. Os o valores so especicados pelo ANSI SQL e ODBC. Para uma lista de valores poss a iveis, veja Seo 13.1 [Error-returns], Pgina 889. ca a Note que nem todos os erros j esto mapeados para SQLSTATE. O valor HY000 (erro a a geral) usado para erros no mapeados. e a Esta funo foi adicionada ao MySQL 4.1.1. ca

Valores Retornados
Uma string terminada em null contendo o cdigo de erro SQLSTATE. o

Veja Tambm e
a ca Veja Seo 12.1.3.12 [mysql errno], Pgina 791. Veja Seo 12.1.3.13 [mysql error], ca Pgina 792. Veja Seo 12.1.7.18 [mysql stmt sqlstate], Pgina 855. a ca a

12.1.3.53 mysql_ssl_set()
int mysql_ssl_set(MYSQL *mysql, const char *key, const char *cert, const char *ca, const char *capath, const char *cipher)

Descrio ca
mysql_ssl_set() usado para estabelecer conexo segura usando SSL. Ela deve ser e a chamada antes de mysql_real_connect(). mysql_ssl_set() no faz nada a mesno que o suporte OpenSSL esteja habilitado na biba lioteca cliente. mysql e o handler da conexo retornado de mysql_init(). Os outros parmetros so a a a especicados como a seguir: key o caminho para o arquivo de chave. e cert o caminho para o arquivo do certicado. e ca o caminho para o arquivo de autoridade do certicado. e capath o caminho para um diretrio que contm certicados SSL CA conveis no e o e a formato pem. cipher a lista de cifras permitidas para uso para criptograa SSL. e Qualquer parmetro SSL no utilizado pode ser dado com NULL. a a

Valores Retornados
Esta funo sempre retorna 0. Se a congurao SSL est incorreta, mysql_real_connect() ca ca a retornar um erro quando voc tentar se conectar. a e

822

MySQL Technical Reference for Version 5.0.0-alpha

12.1.3.54 mysql_stat()
char *mysql_stat(MYSQL *mysql)

Descrio ca
Retorna uma string contendo informaes sinmilares a aquelas fornecidas pelo comando co mysqladmin status. Isto inclui o tempo de conexo em segundos e o nmero de threads a u em execuo, recargas e tabelas abertas. ca

Valor Retornado
Uma string descrevendo o status do servidor. NULL se um erro ocorrer.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.55 mysql_store_result()
MYSQL_RES *mysql_store_result(MYSQL *mysql)

Descrio ca
Voc deve chamar mysql_store_result() ou mysql_use_result() para cada consulta que e retorne dados com sucesso (SELECT, SHOW, DESCRIBE, EXPLAIN). Voc no precisa chamar mysql_store_result() ou mysql_use_result() para outras cone a sultas, mas ele no causar nenhum dano ou nenhuma queda notel de desempenho se voc a a e chamar mysql_store_result() em todos os casos. Voc pode detectar se a consulta no e a obteve resultado vericando se mysql_store_result() retornou 0. Se voc quiser saber se a consulta devia retornar algum resultado, voc pode utilizar e e mysql_field_count() para fazer a vericao. Veja Seo 12.1.3.20 [mysql eld count], ca ca Pgina 797. a mysql_store_result() l todo o resultado de uma consulta para um cliente, aloca uma e estrutura MYSQL_RES e coloca o resultado nesta estrutura. mysql_store_result() retorna um ponteiro para null se a consulta no retornar um rea sultado (se a consulta foi, por exemplo, uma instruo INSERT). ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

823

mysql_store_result() tambm retorna um ponterio para null se a leitura do resultado e falhar. Voc pode vercar se voc obteve um erro vericando se mysql_error() no ree e a tornou um ponterio para null, se mysql_errno() retorna <> 0, ou se mysql_field_count() retorna <> 0. Um resultado vazio retornado se no houver registros a retornar. (Um resultado vazio e a e diferente de um ponteiro para null em um valor de retorno). Uma vez que voc tenha chamado mysql_store_result() e tenha retornado um resultado e que no uma apontador para null, voc pode chamar mysql_num_rows() para descobrir a e e quantas linhas existem no resultado. Voc pode chamar mysql_fetch_row() para buscar registros no resultado ou mysql_row_ e seek() e mysql_row_tell() para obter ou denir a poio atual do registro dentro do ca resultado. Voc deve chamar mysql_free_result() quando tiver terminado com o resultado. e Veja Seo 12.1.12.1 [NULL mysql_store_result()], Pgina 861. ca a

Valor Retornado
Uma estrutura de resultado MYSQL_RES com o resultado. NULL se um erro ocorreu.

Erros
mysql_store_result() zera mysql_error e mysql_errno se ela obter sucesso. CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Sem memoria. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.56 mysql_thread_id()
unsigned long mysql_thread_id(MYSQL *mysql)

Descrio ca
Retorna a ID da thread da conexo atual. Este valor pode ser usado como um argumento a para mysql_kill() para nalizar a thread. Se a conexo for perdida e voc reconectar com mysql_ping(), a ID da thread ir alterar. a e a Isto signica que voc deve obter a ID da thread e guard-la para uso posterior. Voc deve e a e obt-la quando precisar dela. e

824

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
A ID da thread da conexo atual. a

Erros
Nenhum.

12.1.3.57 mysql_use_result()
MYSQL_RES *mysql_use_result(MYSQL *mysql)

Descrio ca
Voc deve chamar mysql_store_result() ou mysql_use_result() para cada consulta que e retornar data com sucesso (SELECT, SHOW, DESCRIBE, EXPLAIN). mysql_use_result() inicicia a recuperao de um resultado mas no l realmente o reca a e sultado no cliente como mysql_store_result() faz. Cada regiostro deve ser recuperado individualmente fazendo chamadas a mysql_fetch_row(). Ele l o resultado de uma cone sulta diretamente do servidor sem armazenar em uma tabela temporria ou em um buer a local, o o que mais rpido e utiliza menos memria que mysql_store_result(). O cliente e a o s ir alocar memria para o registro atual para o buer de comunicao que pode crescer io a o ca para max_allowed_packet bytes. Por outro lado , voc no deve utilizar mysql_use_result() se voc estiver fazendo vrios e a e a processamentos para cada registros no lado do cliente, ou se a sa enviada para a tela, ida e na qual o usurio de digitar um ^S (parada de tela). Isto ir prender o servidor e impedir a a outras threads de atualizar qualquer tabela na qual o dados esteja sendo buascado. Ao usar mysql_use_result(), voc deve executar mysql_fetch_row() at um valor NULL e e ser retornado, seno, os registros no buscados retornaro como part do resultado de sua a a a prxima consulta. A API C fornecer o erro Commands out of sync; you cant run this o a command now se voc esquecer de faz-lo. e e Voc no pode utilizar mysql_data_seek(), mysql_row_seek(), mysql_row_tell(), e a mysql_num_rows(), ou mysql_affected_rows() com m resultado retornado de mysql_use_result(), nem pode executar outras consultas at que mysql_use_result() e tenha nalizado. (No entanto, depois de buscar todos os regitros, mysql_num_rows() retornar corretamente o nmero de regiostros buscados). a u Voc deve chamar mysql_free_result() aps terminar de utilizar o resultado. e o

Valor Retornado
Uma estrutura de resultado MYSQL_RES. NULL se ocorrer um erro.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

825

Erros
mysql_use_result() zera mysql_error e mysql_errno se ela obter sucesso. CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Sem memria. o CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.3.58 mysql_warning_count()
unsigned int mysql_warning_count(MYSQL *mysql)

Descrio ca
Retorna o nmero de avisos gerados durante a execuo da instruo SQL anterior. u ca ca Dispon a partir do MySQL 4.1. ivel

Valores de Retorno
A contagem de avisos.

Errors
Nenhum.

12.1.3.59 mysql_commit()
my_bool mysql_commit(MYSQL *mysql)

Descrio ca
Faz um commits na transao atual. Dispon no MySQL 4.1 ca ivel

Valor Retornado
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

826

MySQL Technical Reference for Version 5.0.0-alpha

Erros
Nenhum.

12.1.3.60 mysql_rollback()
my_bool mysql_rollback(MYSQL *mysql)

Descrio ca
Faz um rollback na transao atual. Dispon no MySQL 4.1 ca ivel

Valor Retornado
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

Erros
Nenhum.

12.1.3.61 mysql_autocommit()
my_bool mysql_autocommit(MYSQL *mysql, my_bool mode)

Descrio ca
Dene o modo autocommit como ligado se mode 1, desligado se mode 0. e e

Valor Retornado
Zero em caso de sucesso. Deiferente de zero se ocorrer um erro.

Erros
Nenhum.

12.1.3.62 mysql_more_results()
my_bool mysql_more_results(MYSQL *mysql)

Descrio ca
Retorna verdade se mais resultados da consulta atualmente em execuo existem, e a ca aplicao deve chamar mysql_next_result() para buscar os resultados. Dispon ca ivel no MySQL 4.1

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

827

Valor Retornado
TRUE (1) se existem mais resultados. FALSE (0) se no existem mais resultados. a Note que na maioria dos casos chama-se mysql_next_result() para se mais de um resultado existe e inicia o prximo resultado se ele existir. o Veja Seo 12.1.8 [C API multiple queries], Pgina 855. ca a Veja Seo 12.1.3.63 ca [mysql next result], Pgina 827. a

Erros
Nenhum.

12.1.3.63 mysql_next_result()
int mysql_next_result(MYSQL *mysql)

Descrio ca
Se existem mais resultados da consulta, mysql_next_result() l o prximo resultado da e o no MySQL 4.1 consulta e retorna o status a aplicao. Disponivel ca Note que voc deve chamar mysql_free_result() para a consulta anterior se ela retornar e um resultado. Depois de chamar mysql_next_result() o estado da conexo como se tivesse chamado a e mysql_real_query() para a prima consulta. Isto signica que voc agora pode chamar e mysql_store_result(), mysql_warning_count(), mysql_affected_rows() ... na conexo. a Se mysql_next_result() retorna um erro, nenhuma outra instruo ser executada e no ca a a haver mais resultado para buscar. a Veja Seo 12.1.8 [C API multiple queries], Pgina 855. ca a

Valor Retornado
0 em caso de sucesso e haver mais resultados. -1 se no houver mais resultados. > 0 se a ocorrer um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. Por exemplo se voc no chamar mysql_use_result() para um resulatdo anterior. e a CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a

828

MySQL Technical Reference for Version 5.0.0-alpha

CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.4 Instrues Preparadas da API C co

A partir da verso 4.1 do MySQL, o protocolo cliente/servidor fornece o uso de instrues a co preparadas. E capacidade utilizam estruturas de dados de tratamento de instrues MYSQL_ co STMT. Execuo preparada um modo eciente de executar uma instruo mais de uma vez. A ca e ca instruo primeiramente analizada para prepar-la para a execuo. Ento executada ca e a ca a e uma ou mais vezes posteriormente, utilizando o manipulador de instrues retornado pela co funo preparada. ca Execuo preparada mais rpida que a execuo direta para instrues executadas mais ca e a ca co que uma vez, pois a consulta analizada apenas uma vez. No caso de execuo direta , e ca a consulta analisada todas as vezes que ela executada. Execuo preparada tambm e e ca e pode fornecer uma reduo de trco de rede porque para cada execuo das instrues ca a ca co preparadas, necessrio enviar dados apenas os parmetros. e a a Outra vantagem de instrues preparadas que ela utiliza um protocolo binrio, que faz co e a a transferncia dos dados entre clinete e servidor de forma mais eciente. Instrues e co preparadas tambm podem suportar ligao de entrada e sa com a execuo de cnsultas e ca ida ca mltiplas. u

12.1.5 Tipos de Dados de Instruoes Preparadas da API C c

Note: A API para instrues preparadas ainda assunto de reviso. Esta informao co e a ca e fornecida para os adeptos, mas esteja ciente que a API pode alterar. Instruo preparadas utilizam principalmente as estruturas de dados MYSQL_STMT e MYSQL_ ca BIND seguintes. Uma terceira estrutura, MYSQL_TIME, usada para tranferir dados tempoe rais. MYSQL_STMT Esta estrutura representa uma instruo preparada. Uma instruo preparada ca ca e chamando mysql_prepare(), que retorna uma handler da instruo, que ca e um ponteiro para um MYSQL_STMT. O handler usado para todas as funes e co subsequentes relacionadas `s instrues. a co A estrutura MYSQL_STMT no possui membros para uso em aplicao. a ca Mltiplos handles de instrues podem estar associados com uma unica conexo. u co a O limite no nmero de handlers depende dos recursos de sistemas dispon u iveis. MYSQL_BIND Esta estrutura usada tanto para a entrada da consulta (valores de dados enviae dos ao servidor) quanto para sa (valores de resultado retornados do servidor). ida Para entrada, ela usada com mysql_bind_param() para ligar os valores os dae dos dos parmetros para armazenar em buers para uso pelo mysql_execute(). a Para sa ida, ela usada com mysql_bind_result() para ligar o buer de resule tado para uso na busca de registros com mysql_fetch().

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

829

A estrutura MYSQL_BIND contm os seguintes membros para uso em aplicativos. e Cada um deles utiliza tanto a entrada quanto a sa ida, embora algumas vezes sejam para diferentes propsitos dependendo da direo da transfer6encia de o ca dados: enum enum_field_types buffer_type O tipo do buer. Os valores de buffer_type esto listados postea riormente nesta seo. Para entrada, buffer_type indica que tipo ca de valor voc est ligando a um parmetro de uma consulta. Para a e a a sa ida, ele indica que tipo de valor voc espera receber em um buer e de resultado. void *buffer Para entrada, este um ponteiro para o buer no qual os dados e de parmetros de uma consulta, esto armazenados. Para sa a a ida, ele um ponteiro para o buer no qual se deve retornar o valor e de uma coluna do resultado. Para tipos numricos, o buffer deve e apontar para uma varivel do tipo C apropriado. (Se voc estiver a e associando a varivel com uma coluna que tem o atributo UNSIGNED, a a varivel deve ser um tipo C unsigned.) Para colunas de tipo data a e hora, o buffer deve apontar para uma estrutura MYSQL_TIME. Para colunas do tipo caracter e string binria, o buffer aponta a para um buer de caracter. unsigned long buffer_length O tamanho atual de *buffer em bytes. Ele indica a quantidade mxima de dados que pode ser armazenado no buer. Para cara acteres e dados C binrios, o valor buffer_length especica o a tamanho do *buffer quando utilizado com mysql_bind_param(), ou o nmero mximo de bytes de dados que pode ser buscado em u a um buer quando usado com mysql_bind_result(). unsigned long *length Um ponteiro para uma varivel unsigned long que indica o nmero a u atual de bytes de dados armazenado em *buffer. length usado e usado para caracteres e dados C binrios. Para a ligao dos e a ca dados do parmetro de entrada, length aponta para uma varivel a a unsigned long que indica o tamanho do valor do parmetro ara mazenado em *buffer; isto usado pelo mysql_execute(). Se e o tamanho um ponteiro nulo, o protocolo assume que todos os e caracteres e dados binrios so terminados com null. a a Para ligao dos valores de sa mysql_fetch() coloca o tamanho ca ida, dos valores de coluna retornados na varivel para onde o *length a aponta. length ignorado por tipos de dados numricos e trmporais porque e e o tamanho do valord dos dados determinado pelo valor buffer_ e type.

830

MySQL Technical Reference for Version 5.0.0-alpha

bool *is_null Este membro aponta para uma varivel my_bool que verdadeiro a e se um valor NULL, falso se ele no NULL. Para entrada, dena e a e *IS_NULL como verdadeiro para indicar que voc est passando um e a valor NULL como um parmetro. Para saida, este valor verdadeiro a e se o valor de um resultado retornado de uma consulta NULL. e MYSQL_TIME Esta estrutura utilizada para enviar e receber dados DATE, TIME, DATETIME e e TIMESTAMP diretamente de e para o servidor. Isto feito congurando o membro e buffer_type de uma estrutura MYSQL_BIND para um dos tipos temporais e congurando o membro buffer para apontar para uma estrutura MYSQL_TIME. A estrutura MYSQL_TIME contm os seguintes membros: e unsigned int year O ano. unsigned int month O ms do ano. e unsigned int day O dia do ms. e unsigned int hour A hora do dia. unsigned int minute O minuto da hora. unsigned int second Os segundos. my_bool neg Um parmetrio booleano para indicar se o tempo negativo. a e unsigned long second_part A parte fracionria do segundo. Este membro no atualmente a a e usado. Apenas aquelas partes de uma estrutura MYSQL_TIME que se aplica a um dado tipo de valor temporal so usados: Os elementos year, month e day so usados a a para valores DATE, DATETIME e TIMESTAMP. Os elementos hour, minute e second so usados para valores TIME, DATETIME e TIMESTAMP. Veja Seo 12.1.9 [C API a ca date handling], Pgina 856. a A seguinte tabela mostra os valores permitidos que podem ser especicados no membro buffer_type da estrutura MYSQL_BIND. A tabela tambm mostra aqueles tipos SQL que e correspondem mais proximamente a cada valor buffer_type, e, para tipos numricos e e temporais, o tipo C correspondente. buffer_type Valor MYSQL_TYPE_TINY MYSQL_TYPE_SHORT Tipo SQL TINYINT SMALLINT Tipo C char short int

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

831

MYSQL_TYPE_LONG INT MYSQL_TYPE_LONGLONG BIGINT MYSQL_TYPE_FLOAT FLOAT MYSQL_TYPE_DOUBLE DOUBLE MYSQL_TYPE_TIME TIME MYSQL_TYPE_DATE DATE MYSQL_TYPE_DATETIME DATETIME MYSQL_TYPE_TIMESTAMP TIMESTAMP MYSQL_TYPE_STRING CHAR MYSQL_TYPE_VAR_STRING VARCHAR MYSQL_TYPE_TINY_BLOB TINYBLOB/TINYTEXT MYSQL_TYPE_BLOB BLOB/TEXT MYSQL_TYPE_MEDIUM_BLOB MEDIUMBLOB/MEDIUMTEXT MYSQL_TYPE_LONG_BLOB LONGBLOB/LONGTEXT Uma converso de tipo implcita pode ser realizada em ambas a

long int long long int float double MYSQL_TIME MYSQL_TIME MYSQL_TIME MYSQL_TIME

as direes. co

12.1.6 Viso Geral das Funes de Instruoes Preparadas da API a co c C

Note: A API para instrues preparadas ainda assunto de reviso. Esta informao co e a ca e fornecida para os adeptos, mas esteja ciente que a API pode alterar. As funes dispon co iveis nas instrues preparadas esto resumidas aqui e desctias em maiores co a detalhes em um seo posterior. Veja Seo 12.1.7 [C API Prepared statement functions], ca ca Pgina 833. a Funo ca Descrio ca mysql prepare() mysql param count() mysql get metadata() mysql bind param() mysql execute() mysql stmt aected rows() mysql bind result() mysql stmt store result() mysql stmt data seek() Prepara uma string SQL para execuo. ca Retorna o nmero de parmetros em uma instruo SQL u a ca preparada. Retorna metadados de instrues preparadas em forma de co um conjunto de resultados. Associa o buers de dados da aplicao com o parmetro ca a marcado na instruo SQL preparada. ca Executa a instruao preparada. c Retorna o nmero de registros alteradosi, deletados ou inu seridos pela ultima consulta UPDATE, DELETE, ou INSERT. Associa o buers de dados da aplicao com colunas no ca resultado. Retorna o resultado completo para o cliente. Busca um nmero de registro arbitrrio no resultado de uma u a consulta.

832

MySQL Technical Reference for Version 5.0.0-alpha

mysql stmt row seek() mysql stmt row tell() mysql stmt num rows() mysql fetch() mysql stmt close() mysql stmt errno() mysql stmt error() mysql stmt sqlstate() mysql send long data()

Busca por um oset de registro no resultado de uma busca, utilizando o valor reotornado de mysql_stmt_row_tell(). Retorna a posio do cursor de registro. ca Retorna o total de registros do resultado de uma instruo ca armazenada. Busca o prximo conjunto de dados do resultado e retorna o os dados para todas as colunas limites. Libera a memria usada pela instruo preparada. o ca Retorna o nmero de erro para a ultima instruo execuu ca tada. Retorna a mensagem de erro para a ultima instruo exe ca cutada. Retorna o cdigo de erro SQLSTATE para a execuo da o ca ultima instruo. ca Envia dados longos em blocos para o servidor.

Chama mysql_prepare() para preparar e iniciar o manipulador de instrues, mysql_bind_ co param() para fornecer os dados do parmetro e mysql_execute() para executar a consulta. a Voc pode repetir o mysql_execute() alterando o valor do parmetro no buer respectivo e a fornecido por mysql_bind_param(). Se a consulta uma instruo SELECT ou qualquer outra consulta que produz um resultado, e ca mysql_prepare() tambm retornar a informao dos meta dados do resultado na forma e a ca de um resultado MYSQL_RES atravs de um mysql_get_metadata(). e Voc pode forncer o buer de resultado usando mysql_bind_result(), assim mysql_ e fetch() retornar automaticamente os dados para este buer. Esta busca feita registro a e a registro. Voc tambm pode enviar o texto ou dado binrio em blocos para o servidor utilizando e e a mysql_send_long_data(), especcando a opo is_long_data=1 ou length=MYSQL_LONG_ ca DATA ou -2 na estrutura MYSQL_BIND fornecida com mysql_bind_param(). Quando a execuo for completada, o handler da instruo deve ser fechado usando mysql_ ca ca stmt_close() para que todos os recursos associados a ele sejam liberados. Se voc obteve os metadados de um resultado de uma instruo SELECT chamando mysql_ e ca get_metadata(), voc tambm deve liber-lo usando mysql_free_result(). e e a

Execution Steps:
Para prepara e executar uma instruo, uma aplicao: ca ca 1. Chama mysql_prepare() e passa uma string contendo uma instruo SQL. Em uma ca operao de preparo bem sucedida, o mysql_prepare retorna o manipulador de inca struo vlido para a aplicao. ca a ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

833

2. Se a consulta produz um resultado, chama mysql_get_metadata para obter o conjunto de resultado de metadados. Este metadado est na forma de um resultado, embora a um separado daqueles que contm as linhas retornadas pela consulta. O resultado de e metadados indica quantos colunas esto no resultado e contm informaes sobre cada a e co coluna. 3. Dene o valor de qualquer parmetro usando mysql_bind_param. Todos os parmetros a a devem ser denidos. De outra forma a execuo da consulta retornar um erro ou ca a produzir resultados inesperados. a 4. Chama mysql_execute() para executar a instruo. ca 5. Se a consulta produz um resultado, liga o buer de dados usado para retornar o valor do registro chamando mysql_bind_result(). 6. Busca os dados no buer, registro a registro chamando mysql_fetch() repetidas vezes at no haver mais registros. e a 7. Repete os passos de 3 a 6 como necessrio, alterando o valor dos parmetros e rea a executando a instruo. ca Quando mysql_prepare() chamado, o protocolo cliente/servidor do MySQL realiza as e seguintes aes: co O servidor analiza a consulta e envia o status de OK de volta para o cliente atribuindo uma identicao de instruo. Ele tambm envia um nmero total de parmetros, uma ca ca e u a contagem de colunas e sua meta informao se for um resultado orientado a consulta. ca Toda a sintaxe e semntica da consulta vericada pelo servidor durante a chamada. a e O cliente utiliza esta identicao da instruo para as operaes adicionais, assim o ca ca co servidor pode identicar a instruo dentre outras existentes. O cliente tambm aloca ca e um manipulador de instrues com esta identicao e o retorna para a aplicao. co ca ca Quando o mysql execute() chamado, no protocolo cliente/servidor do MySQL realiza as e seguintes operaes: co O cliente utiliza o manipulador de instrues e envia o dado do parmetro para o co a servidor. O servidor identica a instruo usando a identicao fornecida pelo cliente, substitui ca ca o marcador do parmetro com o dado fornecido mais recente e executa a consulta. Se a a consulta produz um resultado, o servidor envia o dado de volta para o cliente. Seno a envia o status de OK como nmero total de registros alterados, deletados ou inseridos. u Quando mysql_fetch() chamado, no protocolo cliente/servidor do MySQL realiza as e seguintes aes: co O cliente l os dados do pacote registro por registro e o coloca no buer de dados da e aplicao fazendo as converses necessrias. Se o tipo do buer de aplicao o mesmo ca o a ca e do tipo do campo retornado do servidor, as converses so diretas. o a Voc pode obter o cdigo de erro, mensagens e o valor SQLSTATE da instruo utilizando e o ca mysql_stmt_errno(), mysql_stmt_error() e mysql_stmt_sqlstate() respectivamente.

12.1.7 Descrio das Funes de Instruo Preparada da API C ca co ca

Para preparar e executar consultas use as seguites funoes. c

834

MySQL Technical Reference for Version 5.0.0-alpha

12.1.7.1 mysql_prepare()
MYSQL_STMT * mysql_prepare(MYSQL *mysql, const char *query, unsigned long length)

Descrio ca
Prepara a consulta SQL apontada pela string com terminao em nulo query, e retorna um ca handle da instruo para ser usado por operaes adicionais na instruo. A consulta deve ca co ca consistir de uma unica instruo SQL. Voc no deve adicionar ponto e virgula (;) ou \g ca e a a instruo. ca A aplicao pode incluir um ou mais marcadores de parmetro na instruo SQL, embutindo ca a ca interrogaes (?) na string SQL na posio aprpriada. co ca Os marcadores s so vlidos em certos lugares na instruo SQL. Por exemplo, eles no o a a ca a so permitidos em lista VALUES() de uma instruo INSERT (para especicar valores para a ca uma linha ou em uma comparao com uma coluna em uma clusula WHERE para especicar ca a uma valor de comparao. No entanto, eles no so permitidos como identicadores (tais ca a a como nomes de colunas ou tabelas), na lista select que indica as colunas a serem retornadas por uma instruo SELECT), ou para especicar ambos operandos de um operador binrio ca a determinar como o sinal de igual =. A ultima restrio necessria porque seria impossivel ca e a o tipo do parmetro. Em geral, parmetros so vlidos somente em instruo de Linguagem a a a a ca de Manipulao de Dados (Data Manipulation Languange-DML), e no em instrues de ca a co Linguagem de Denio de Dados (Data Denation Language-DDL). ca Os marcadores de parmetro devem limitar variveis de aplicaes utilizando mysql_bind_ a a co param() antes de executar a instruo. ca

Valor Retornado
Um ponteiro para uma estrutura MYSQL_STMT se o preparo obteve sucesso. NULL se ocorreu um erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Falta de memria o CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

835

Se o preparo no obteve sucesso (isto , mysql_prepare() retorna um ponteiro NULL), as a e mensagens de erros podem ser obtidas chamando mysql_error().

Exemplo
Para o uso de mysql_prepare() consulte o exemplo de Seo 12.1.7.5 [mysql_execute()], ca Pgina 837. a

12.1.7.2 mysql_param_count()
unsigned long mysql_param_count(MYSQL_STMT *stmt)

Descrio ca
Retorna o nmero de marcadores de parmetros presentes na consulta preparada. u a

Valor Retornado
Um unsigned long (inteiro sem sinal) representando o nmero de parmetros em uma inu a struo. ca

Erros
Nenhum.

Exemplo
Para utilizar mysql_param_count() consulte o exemplo de Seo 12.1.7.5 [mysql_ ca execute()], Pgina 837. a

12.1.7.3 mysql_get_metadata()
MYSQL_RES *mysql_get_metadata(MYSQL_STMT *stmt)

Descrio ca
Se uma instruo passada para mysql_prepare() rproduziu um resultado, mysql_get_ ca metadata() retorna o resultado dos meta dados na forma de um ponteiro para uma estrutura MYSQL_RES que tambm pode ser usada para processar a meta informao como o nmero e ca u total de campos e informao de campos indiv ca iduais. Este ponteriro para o resultado pode ser passado como um argumento para qualquer um dos campos com base na API que processam o resultado dos metadados, como: mysql_num_fields() mysql_fetch_field()

836

MySQL Technical Reference for Version 5.0.0-alpha

mysql_fetch_field_direct() mysql_fetch_fields() mysql_field_count() mysql_field_seek() mysql_field_tell() mysql_free_result() A estrutura do resultado deve estar liberada quando voc acabar de us-lo. Voc pode e a e faz-lo passando para mysql_free_result(). E semelhante ao modo que voc libera um e e resulatdo chamado com mysql_store_result(). O resultado retornado por mysql_get_metadata() contm apenas metadados. Ele no e a contm qualquer resultado de registro. As linhas so obtidas usando o handle de instruo e a ca com mysql_fetch().

Valor Retornado
Uma estrutura de resultado MYSQL_RES. NULL se nenhuma meta informao existe para a ca consulta preparada.

Erros
CR_OUT_OF_MEMORY Falta de memria o CR_UNKNOWN_ERROR Ocorreu um erro desconhecido

Exemplo
Para utilizar mysql_get_metadata() [mysql_fetch()], Pgina 846 a consulte o exemplo de Seo ca 12.1.7.13

12.1.7.4 mysql_bind_param()
my_bool mysql_bind_param(MYSQL_STMT *stmt, MYSQL_BIND *bind)

Descrio ca
mysql_bind_param() utilizado para ligar dados para os marcadores de parmetros na e a instruo SQL que foi passada para mysql_prepare(). Ele utiliza a estrutura MYSQL_BIND ca para fornecer os dados. bind o endereo de um vetor de estruturas MYSQL_BIND. A e c biblioteca cliente espera que o vetor deve contenha um elemento para cada marcador de parmetro ? que est presente na consulta. a a Suponha que voc prepare a seguinte instruo: e ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

837

INSERT INTO mytbl VALUES(?,?,?) Quando voc ligar os parmetros, o vetor da estrutura MYSQL_BIND deve conter trs elee a e mentos e pode estar declarado assim: MYSQL_BIND bind[3]; O membro de cada elemento MYSQL_BIND que deve estar congurado est descrito em a Seo 12.1.5 [C API Prepared statement datatypes], Pgina 828. ca a

Valor Retornado
Zeros se a ligao foi obtida com sucesso. Diferente de zero se ocorrer um erro. ca

Erros
CR_NO_PREPARE_STMT No existem instrues preparadas a co CR_NO_PARAMETERS_EXISTS No existem parmetros para ligar a a CR_INVALID_BUFFER_USE Indica se a ligao forncer dados longos em bolcos e se o tipo de buer binrio ca a e a ou no uma string. a e CR_UNSUPPORTED_PARAM_TYPE A converso no suportada. Possivelmente o valor de buffer_type invlido a a e e a ou no um dos tipos suportados listados acima. a e CR_OUT_OF_MEMORY Falta de memria o CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Exemplo
Para utilizar mysql_bind_param() consulte o exemplo de Seo 12.1.7.5 [mysql_ ca execute()], Pgina 837. a

12.1.7.5 mysql_execute()
int mysql_execute(MYSQL_STMT *stmt).

Descrio ca
mysql_execute() executa a consulta preparada associada ao controlador de instrues. O co valor atual do marcador de parmetros enviado para o servidor durante esta chamada, e a e o servidor substituir marcadores com os novos dados fornecidos.

838

MySQL Technical Reference for Version 5.0.0-alpha

Se a instruo um UPDATE, DELETE ou INSERT, o nmero total de registros altrados, deleca e u tados ou inseridos pode ser encontrado chamando mysql_stmt_affected_rows(). Se este um resultado de uma consulta como SELECT, deve se chamar mysql_fetch() para buscar e dados previamente para fazer qualquer outra funo que resulte em um processamento de ca consulta. Para mais informaes sobre como buscar os resultados, consulte Seo 12.1.7.13 co ca [mysql_fetch()], Pgina 846 a

Valor Retornado
Zero se a execuo obteve sicesso. Diferente de zero se ocorreu um erro. O cdigo de erro e ca o a mensagem podem ser obtidas chamando mysql_stmt_errno() e mysql_stmt_error().

Erros
CR_NO_PREPARE_QUERY Nenhuma consulta preprada previamente para execuo ca CR_ALL_PARAMS_NOT_BOUND No forma fornecidos todos os dados de parmetros. a a CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Falta de memria o CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Exemplo
O seguinte exemplo demonstra como criar e preencher uma tabela usando mysql_ prepare(), mysql_param_count(), mysql_bind_param(), mysql_execute() e mysql_stmt_affected_rows(). A varivel mysql considerada como um controlador de a e conexo vlido. a a #define STRING_SIZE 50 #define DROP_SAMPLE_TABLE "DROP TABLE IF EXISTS test_table" #define CREATE_SAMPLE_TABLE "CREATE TABLE test_table(col1 INT,\ col2 VARCHAR(40),\ col3 SMALLINT,\ col4 TIMESTAMP)" #define INSERT_SAMPLE "INSERT INTO test_table(col1,col2,col3) VALUES(?,?,?)"

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

839

MYSQL_STMT MYSQL_BIND my_ulonglong int short int char unsigned long my_bool

*stmt; bind[3]; affected_rows; param_count; small_data; int_data; str_data[STRING_SIZE]; str_length; is_null;

if (mysql_query(mysql, DROP_SAMPLE_TABLE)) { fprintf(stderr, " DROP TABLE failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0); } if (mysql_query(mysql, CREATE_SAMPLE_TABLE)) { fprintf(stderr, " CREATE TABLE failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0); } /* Prepare an INSERT query with 3 parameters */ /* (the TIMESTAMP column is not named; it will */ /* be set to the current date and time) */ stmt = mysql_prepare(mysql, INSERT_SAMPLE, strlen(INSERT_SAMPLE)); if (!stmt) { fprintf(stderr, " mysql_prepare(), INSERT failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0); } fprintf(stdout, " prepare, INSERT successful\n"); /* Get the parameter count from the statement */ param_count= mysql_param_count(stmt); fprintf(stdout, " total parameters in INSERT: %d\n", param_count); if (param_count != 3) /* validate parameter count */ { fprintf(stderr, " invalid parameter count returned by MySQL\n"); exit(0); }

840

MySQL Technical Reference for Version 5.0.0-alpha

/* Bind the data for all 3 parameters */ /* INTEGER PARAM */ /* This is a number type, so there is no need to specify buffer_length */ bind[0].buffer_type= MYSQL_TYPE_LONG; bind[0].buffer= (char *)&int_data; bind[0].is_null= 0; bind[0].length= 0; /* STRING PARAM */ bind[1].buffer_type= MYSQL_TYPE_VAR_STRING; bind[1].buffer= (char *)str_data; bind[1].buffer_length= STRING_SIZE; bind[1].is_null= 0; bind[1].length= &str_length; /* SMALLINT PARAM */ bind[2].buffer_type= MYSQL_TYPE_SHORT; bind[2].buffer= (char *)&small_data; bind[2].is_null= &is_null; bind[2].length= 0; /* Bind the buffers */ if (mysql_bind_param(stmt, bind)) { fprintf(stderr, " mysql_bind_param() failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Specify the data values for the first row */ int_data= 10; /* integer */ strncpy(str_data, "MySQL", STRING_SIZE); /* string str_length= strlen(str_data); /* INSERT SMALLINT data as NULL */ is_null= 1; /* Execute the INSERT statement - 1*/ if (mysql_execute(stmt)) { fprintf(stderr, " mysql_execute(), 1 failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Get the total number of affected rows */

*/

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

841

affected_rows= mysql_stmt_affected_rows(stmt); fprintf(stdout, " total affected rows(insert 1): %ld\n", affected_rows); if (affected_rows != 1) /* validate affected rows */ { fprintf(stderr, " invalid affected rows by MySQL\n"); exit(0); } /* Specify data values for second row, then re-execute the statement */ int_data= 1000; strncpy(str_data, "The most popular open source database", STRING_SIZE); str_length= strlen(str_data); small_data= 1000; /* smallint */ is_null= 0; /* reset */ /* Execute the INSERT statement - 2*/ if (mysql_execute(stmt)) { fprintf(stderr, " mysql_execute, 2 failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Get the total rows affected */ affected_rows= mysql_stmt_affected_rows(stmt); fprintf(stdout, " total affected rows(insert 2): %ld\n", affected_rows); if (affected_rows != 1) /* validate affected rows */ { fprintf(stderr, " invalid affected rows by MySQL\n"); exit(0); } /* Close the statement */ if (mysql_stmt_close(stmt)) { fprintf(stderr, " failed while closing the statement\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); }

Nota: Para exemplos completos do uso das funes de instrues preparadas, veja co co tests/client_test.c. Este arquivo pode ser obtido em uma distribuio fonte ou do ca repositrio do Bitkeeper. o

842

MySQL Technical Reference for Version 5.0.0-alpha

12.1.7.6 mysql_stmt_affected_rows()
my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT *stmt)

Descrio ca
Retorna o nmero total de registros alterados, deletados ou inseridos pela ultima instruo u ca executada. Pode ser chamada imediatamente depois de mysql_execute() para instrues co UPDATE, DELETE ou INSERT. Para instrues SELECT, mysql_stmt_affected_rows() funco ciona como mysql_num_rows().

Valor Retornado
Um integer (inteiro) maior que zero indica o nmero de registros afetados ou retornados. u Zero indica que nenhum registro foi atualizado em uma instruo UPDATE, nenhum regitro ca coincidiu com a clusula WHERE na consulta ou que nenhuma consulta foi exeutada ainda. a 1 indica que a consulta retornou um erro ou que, para uma consulta SELECT, mysql_stmt_ affected_rows() foi chamado antes de chamra mysql_fetch().

Erros
Nenhum.

Exemplo
Para utilizar mysql_stmt_affected_rows() consulte o exemplo de Seo 12.1.7.5 [mysql_ ca execute()], Pgina 837. a

12.1.7.7 mysql_bind_result()
my_bool mysql_bind_result(MYSQL_STMT *stmt, MYSQL_BIND *bind)

Descrio ca
mysql_bind_result() usado para associar (ligar) colunas no resultados ao buer de dados e e buer de tamanho. Quando mysql_fetch() chamado para buscar dados, o protocolo e cliente/servidor MySQL os coloca os dados para as colunas limite no buer especicado. Note que todas as colunas devem ser limitadas por buers antes da chamada de mysql_ fetch(). bind o endereo de um vetor de estruturas MYSQL_BIND. A biblioteca cliente e c espera que o vetor contenha um elemento para cada coluna no resultado. Seno mysql_ a fetch() simplesmente ignorado os dados trazidos; os buers devem se sucientemente grande para guardar os dados, porque o protocolo no retorna dados em blocos. a Uma coluna pode ser limitada a qualquer hora, mesmo depois do resultado ter sido parcialmente recuperado. A nova ligao tem efeito ba prxima vez em que mysql_fetch() ca o

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

843

chamado. Suponha que uma aplicao liga a coluna em um resultado e chama mysql_ e ca fetch(). O protocolo cliente/servidor retorna dados em buers limitados. Agora suponha que a aplicao ligue a coluna a um diferente cojunto de buers, ento o protocolo no ca a a coloca os dados em um novo buer limitado at que a prxima chamada mysql_fetch() e o ocorra. Para ligar uma coluna, uma aplicao chama mysql_bind_result() e passa o tipo, o enca dereo e o endereo do buer do tamanho. Os membros de cada elemento MYSQL_BIND que c c deve ser congurado esto descritos em Seo 12.1.5 [C API Prepared statement datatypes], a ca Pgina 828. a

Valor Retornado
Zero se a ligao obteve sucesso. Diferente de zero se ocorreu um erro. ca

Erros
CR_NO_PREPARE_STMT No existe instrues preparadas a co CR_UNSUPPORTED_PARAM_TYPE A converso no suportada. Possivelmente o buffer_type invlido ou no a a e e a a na lista dos tipos de buers suportados CR_OUT_OF_MEMORY Falta de memria o CR_UNKNOWN_ERROR Ocorreu um erro desconhecido

Exemplo
Para utilizar mysql_bind_result() consulta o exemplo de Seo 12.1.7.13 [mysql_ ca fetch()], Pgina 846 a

12.1.7.8 mysql_stmt_store_result()
int mysql_stmt_store_result(MYSQL_STMT *stmt)

Descrio ca
Voc deve chamar mysql_stmt_store_result() para cada consulta que produz um resule tado com sucesso (SELECT,SHOW,DESCRIBE, EXPLAIN), e s se voc quiser armazenar todo o o e resultado no buer no cliente, assim que a chamada mysql_fetch() subsequente retornar os dados em buers. Voc necessrio chamar mysql_stmt_store_result() para outras consultas, mas se voc ee a e o zer, no causar nenhum dano ou queda de performance em todo caso. Voc pode a a e detectar se a consulta produziu um resultado vericado se mysql_get_metadata() retorna NULL. Para mais informaes consulte Seo 12.1.7.3 [mysql_get_metadata()], Pgina 835. co ca a

844

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
Zero se o resultado foi armazenado em buer com sucesso ou Diferente de zero em caso de erro.

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Falta de memoria. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

12.1.7.9 mysql_stmt_data_seek()
void mysql_stmt_data_seek(MYSQL_STMT *stmt, my_ulonglong offset)

Descrio ca
Busca um registro arbitrrio no resultado de uma instruo. O valor do offset um a ca e nmero de registro e deve estar na faixa de 0 a mysql_stmt_num_rows(stmt)-1. u Esta funo exige que a estrutura do resultado da instruo contenha todo o resultado da ca ca ultima consulta executada, assim mysql_stmt_data_seek() pode ser usada em conjunto apenas com mysql_stmt_store_result().

Valor Retornado
Nenhum.

Erros
Nenhum.

12.1.7.10 mysql_stmt_row_seek()
MYSQL_ROW_OFFSET mysql_stmt_row_seek(MYSQL_STMT *stmt, MYSQL_ROW_OFFSET offset)

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

845

Descrio ca
Dene o cursor de linha com um registro arbitrrio em um resultado de instruo. O valor a ca do offset um oset de registro e deve ser um valor retornado de mysql_stmt_row_tell() e ou mysql_stmt_row_seek(). Este valor no um nmero de linha; se voc quiser buscar um a e u e registro em um resultado usando um nmero de linha, utilize mysql_stmt_data_seek(). u Esta funo exige que a estrutura do resultado contenha todo o resultado da consulta, assim ca mysql_stmt_row_seek() pode ser usado em conjunto apenas com mysql_stmt_store_ result().

Valor Retornado
O valor anterior do cursor de linha. Este valor pode ser passado a uma chamada subsequente de mysql_stmt_row_seek().

Erros
Nenhum.

12.1.7.11 mysql_stmt_row_tell()
MYSQL_ROW_OFFSET mysql_stmt_row_tell(MYSQL_STMT *stmt)

Descrio ca
Retorna a posio corrente do cursor de linha para o ultimo mysql_fetch(). Este valor ca pode ser usado como um argumento para mysql_stmt_row_seek(). Voc deve usar mysql_stmt_row_tell() somente depois de mysql_stmt_store_result(). e

Valor Retornado
O oset atual do cursor de linha.

Erros
Nenhum.

12.1.7.12 mysql_stmt_num_rows()
my_ulonglong mysql_stmt_num_rows(MYSQL_STMT *stmt)

846

MySQL Technical Reference for Version 5.0.0-alpha

Descrio ca
Rertorna o nmero de registros no resultado. u O uso de mysql_stmt_num_rows() depende de se voc utilizou ou no mysql_stmt_store_ e a result() para armazenar todo o resultado no manipulador de instrues. co Se voc utilizou mysql_stmt_store_result(), mysql_stmt_num_rows() pode ser chamado e imediatamente.

Valor Retornado
O nmero de linhas no resultado. u

Erros
Nenhum.

12.1.7.13 mysql_fetch()
int mysql_fetch(MYSQL_STMT *stmt)

Descrio ca
mysql_fetch() retorna o prximo registro no resultado. Ele pode ser chamado apenas o enquanto existir o conjunto de resultados. Per exemplo, depois de uma chamada de mysql_ execute() que cria o resultado ou depois de mysql_stmt_store_result(), que chamado e depois de mysql_execute() para armazenar todo o resultado. mysql_fetch retorna os dados de uma linha usando o buers limitado por mysql_bind_ result(). Ele retorna os dados neste buer para todas as colunas no registro atual e os tamanhos so retornados para o apontador length. a Note que, todas as colunas devem ser limitadas pela aplicao antes de chamar mysql_ ca fetch(). Se um valor do dado buscado um valor NULL, o valor *is_null da estrutura MYSQL_BIND e correspondente contm VERDADEIRO (1). Seno, o dado e seu tamanho retornado nos e a e elementos *buffer e *length baseados no tipo de buer especicado pela aplicao. Cada ca tipo numrico e temporal tem um tamanho xo como mostrado na tabela a seguir. O e tamano dos tipos strings dependem do tasmanho do valor dos dados atual, como indicado por data_length. Type Length MYSQL_TYPE_TINY 1 MYSQL_TYPE_SHORT 2 MYSQL_TYPE_LONG 4 MYSQL_TYPE_LONGLONG 8 MYSQL_TYPE_FLOAT 4 MYSQL_TYPE_DOUBLE 8

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

847

MYSQL_TYPE_TIME MYSQL_TYPE_DATE MYSQL_TYPE_DATETIME MYSQL_TYPE_TIMESTAMP MYSQL_TYPE_STRING MYSQL_TYPE_VAR_STRING MYSQL_TYPE_TINY_BLOB MYSQL_TYPE_BLOB MYSQL_TYPE_MEDIUM_BLOB MYSQL_TYPE_LONG_BLOB

sizeof(MYSQL_TIME) sizeof(MYSQL_TIME) sizeof(MYSQL_TIME) sizeof(MYSQL_TIME) tam_dado tam_dado tam_dado tam_dado tam_dado tam_dado

Valor Retornado
Valor retornado 0 1 MYSQL_NO_DATA Descrio ca Sucesso, o dado foi buscado para o buers de dados da aplicao. ca Ocorreu um erro. O cdigo e a mensagem de erro podem o ser obtidos chamando mysql_stmt_errno() e mysql_ stmt_error(). No existem mais registros/dados a

Erros
CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Falta de memoria. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_SERVER_LOST A conexo ao servidor MySQL foi perdida durante a consulta. a CR_UNKNOWN_ERROR Um erro desconhecido ocorreu. CR_UNSUPPORTED_PARAM_TYPE O tipo de buer MYSQL_TYPE_DATE, MYSQL_TYPE_TIME, MYSQL_TYPE_ e DATETIME, ou MYSQL_TYPE_TIMESTAMP, mas o tipo de dado no DATE, TIME, a e DATETIME ou TIMESTAMP. Todos os outros erros de converso no suportada so retornados de mysql_ a a a bind_result().

Exemplo
O seguinte exemplo demonstra como buscar dados de uma tabela usando mysql_get_ metadata(), mysql_bind_result() e mysql_fetch(). (Este exemplo espera recuperar

848

MySQL Technical Reference for Version 5.0.0-alpha

as duas linahs inseridas pelo exemplo mostrado em Seo 12.1.7.5 [mysql_execute()], ca Pgina 837.) A varivel mysql onsiderada como um handle de conexo vlido handle. a a c a a #define STRING_SIZE 50 #define SELECT_SAMPLE "SELECT col1, col2, col3, col4 FROM test_table" MYSQL_STMT MYSQL_BIND MYSQL_RES MYSQL_TIME unsigned long int short int char my_bool *stmt; bind[4]; *prepare_meta_result; ts; length[4]; param_count, column_count, row_count; small_data; int_data; str_data[STRING_SIZE]; is_null[4];

/* Sample which is incorporated directly in the manual under Prepared statements section (Example from mysql_fetch() */ /* Prepare a SELECT query to fetch data from test_table */ stmt = mysql_prepare(mysql, SELECT_SAMPLE, strlen(SELECT_SAMPLE)); if (!stmt) { fprintf(stderr, " mysql_prepare(), SELECT failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0); } fprintf(stdout, " prepare, SELECT successful\n"); /* Get the parameter count from the statement */ param_count= mysql_param_count(stmt); fprintf(stdout, " total parameters in SELECT: %d\n", param_count); if (param_count != 0) /* validate parameter count */ { fprintf(stderr, " invalid parameter count returned by MySQL\n"); exit(0); } /* Fetch result set meta information */ prepare_meta_result = mysql_get_metadata(stmt); if (!prepare_meta_result) {

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

849

fprintf(stderr, " mysql_get_metadata(), returned no meta information\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Get total columns in the query */ column_count= mysql_num_fields(prepare_meta_result); fprintf(stdout, " total columns in SELECT statement: %d\n", column_count); if (column_count != 4) /* validate column count */ { fprintf(stderr, " invalid column count returned by MySQL\n"); exit(0); } /* Execute the SELECT query */ if (mysql_execute(stmt)) { fprintf(stderr, " mysql_execute(), failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Bind the result buffers for all 3 columns before fetching them */ /* INTEGER COLUMN */ bind[0].buffer_type= MYSQL_TYPE_LONG; bind[0].buffer= (char *)&int_data; bind[0].is_null= &is_null[0]; bind[0].length= &length[0]; /* STRING COLUMN */ bind[1].buffer_type= MYSQL_TYPE_VAR_STRING; bind[1].buffer= (char *)str_data; bind[1].buffer_length= STRING_SIZE; bind[1].is_null= &is_null[1]; bind[1].length= &length[1]; /* SMALLINT COLUMN */ bind[2].buffer_type= MYSQL_TYPE_SHORT; bind[2].buffer= (char *)&small_data; bind[2].is_null= &is_null[2]; bind[2].length= &length[2]; /* TIMESTAMP COLUMN */ bind[3].buffer_type= MYSQL_TYPE_TIMESTAMP; bind[3].buffer= (char *)&ts;

850

MySQL Technical Reference for Version 5.0.0-alpha

bind[3].is_null= &is_null[3]; bind[3].length= &length[3]; /* Bind the result buffers */ if (mysql_bind_result(stmt, bind)) { fprintf(stderr, " mysql_bind_result() failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Now buffer all results to client */ if (mysql_stmt_store_result(stmt)) { fprintf(stderr, " mysql_stmt_store_result() failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); } /* Fetch all rows */ row_count= 0; fprintf(stdout, "Fetching results ...\n"); while (!mysql_fetch(stmt)) { row_count++; fprintf(stdout, " row %d\n", row_count); /* column 1 */ fprintf(stdout, " column1 (integer) : "); if (is_null[0]) fprintf(stdout, " NULL\n"); else fprintf(stdout, " %d(%ld)\n", int_data, length[0]); /* column 2 */ fprintf(stdout, " column2 (string) : "); if (is_null[1]) fprintf(stdout, " NULL\n"); else fprintf(stdout, " %s(%ld)\n", str_data, length[1]); /* column 3 */ fprintf(stdout, " column3 (smallint) : "); if (is_null[2]) fprintf(stdout, " NULL\n"); else fprintf(stdout, " %d(%ld)\n", small_data, length[2]);

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

851

/* column 4 */ fprintf(stdout, " column4 (timestamp): "); if (is_null[3]) fprintf(stdout, " NULL\n"); else fprintf(stdout, " %04d-%02d-%02d %02d:%02d:%02d (%ld)\n", ts.year, ts.month, ts.day, ts.hour, ts.minute, ts.second, length[3]); fprintf(stdout, "\n"); } /* Validate rows fetched */ fprintf(stdout, " total rows fetched: %d\n", row_count); if (row_count != 2) { fprintf(stderr, " MySQL failed to return all rows\n"); exit(0); } /* Free the prepared result metadata */ mysql_free_result(prepare_meta_result);

/* Close the statement */ if (mysql_stmt_close(stmt)) { fprintf(stderr, " failed while closing the statement\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0); }

12.1.7.14 mysql_send_long_data()
my_bool mysql_send_long_data(MYSQL_STMT *stmt, unsigned int parameter_number, const char *data, ulong length)

Descrio ca
Permite que um aplicao envie os dados dos parmetros para o servidor em partes (ou ca a blocos). Esta funo pode ser chamada vrias vezes parar enviar partes de valores de ca a dados binrios e caracteres para uma coluna, que deve do tipo TEXT ou BLOB. a parameter_number indica a qual parmetro o dado associado. Os parmetros so nua e a a merados comeando com 0. data um ponteiro para um buer contendo dados a serem c e enviados, e length indica a quantidade de bytes no buer.

852

MySQL Technical Reference for Version 5.0.0-alpha

Valor Retornado
Zero se os dados so enviados com sucesso para o servidir. Diferente de zero se ocorrer um a erro.

Erros
CR_INVALID_PARAMETER_NO Nmero de parmetro invlido u a a CR_COMMANDS_OUT_OF_SYNC Os comando foram executados em uma ordem inpropriada. CR_OUT_OF_MEMORY Falta de memoria. CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_UNKNOWN_ERROR Um erro desconhecido ocorreu.

Example
O exemplo seguinte demonstra como enviar os dados para um coluna do tipo TEXT em blocos. Ele insere o dado MySQL - The most popular open source database na coluna text_column. A varivel mysql considerada como um handle de conexo vlido. a e a a #define INSERT_QUERY "INSERT INTO test_long_data(text_column) VALUES(?)" MYSQL_BIND bind[1]; long length; if (!mysql_prepare(mysql, INSERT_QUERY, strlen(INSERT_QUERY)) { fprintf(stderr, "\n prepare failed"); fprintf(stderr, "\n %s", mysql_error(mysql)); exit(0); } memset(bind, 0, sizeof(bind)); bind[0].buffer_type= MYSQL_TYPE_STRING; bind[0].length= &length; bind[0].is_null= 0;

/* Bind the buffers */ if (mysql_bind_param(stmt, bind)) {

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

853

fprintf(stderr, "\n param bind failed"); fprintf(stderr, "\n %s", mysql_stmt_error(stmt)); exit(0); } /* Supply data in chunks to server */ if (!mysql_send_long_data(stmt,0,"MySQL",5)) { fprintf(stderr, "\n send_long_data failed"); fprintf(stderr, "\n %s", mysql_stmt_error(stmt)); exit(0); } /* Supply the next piece of data */ if (mysql_send_long_data(stmt,0," - The most popular open source database",40)) { fprintf(stderr, "\n send_long_data failed"); fprintf(stderr, "\n %s", mysql_stmt_error(stmt)); exit(0); } /* Now, execute the query */ if (mysql_execute(stmt)) { fprintf(stderr, "\n mysql_execute failed"); fprintf(stderr, "\n %s", mysql_stmt_error(stmt)); exit(0); }

12.1.7.15 mysql_stmt_close()
my_bool mysql_stmt_close(MYSQL_STMT *)

Descrio ca
Fecha a instruo preparada. mysql_stmt_close() tambm desaloca o manipulador de ca e instrues apontado por stmt. co Se a instruo atual tiver resultados pendentes ou no lidos, esta funo os cancela para ca a ca que a prxima consulta possa ser executada. o

Valor Retornado
Zero se a instruo for liberada com sucesso. Diferente de zero se ocorrer um erro. ca

854

MySQL Technical Reference for Version 5.0.0-alpha

Erros
CR_SERVER_GONE_ERROR O servidor MySQL foi nalizado. CR_UNKNOWN_ERROR Ocorreu um erro desconhecido.

Exemplo
Para utilizar mysql_stmt_close() consulte o exemplo de Seo 12.1.7.5 [mysql_ ca execute()], Pgina 837. a

12.1.7.16 mysql_stmt_errno()
unsigned int mysql_stmt_errno(MYSQL_STMT *stmt)

Descrio ca
Para a instruo especicada por stmt, mysql_stmt_errno() retorna o cdigo de erro para ca o a funo de instrues da API chamada mais recentemente. Um valor de retorno de zero ca co signica que no ocorreu nenhum erro. Nmeros de mensagens de erro do cliente esto a u a listadas no arquivo cabelho errmsg.h do MySQL. Nmeros de mensagens de erro do c u servidor esto listado no arquivo mysqld_error.h. Na distribuio fonte do MySQL voc a ca e pode encontrar uma lista completa de mensagens de erros e nmero de erros no arquivo u Docs/mysqld_error.txt. Os cdigos de erros do servidor tambm esto listados em o e a Seo 13.1 [Error-returns], Pgina 889. ca a

Valor Retornado
Um valor de cdigo de erro. Zero se no ocorreu erro. o a

Erros
Nenhum

12.1.7.17 mysql_stmt_error()
const char *mysql_stmt_error(MYSQL_STMT *stmt)

Descrio ca
Para a instruo especicada por stmt, mysql_stmt_error() retorna uma string terminada ca em null contendo a mensagem de erro para a funo de instruo da API chamada mais ca ca recentemente. Um string vazia ("") retornado se no ocorreu nenhum erro. Isto signica e a que os seguintes comandos so equivalentes: a

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

855

if (mysql_stmt_errno(stmt)) { // an error occured } if (mysql_stmt_error(stmt)[0]) { // an error occured } A linguagem da mensagem de erro do cliente pode ser alterada recompilando a biblioteca cliente do MySQL. Atualmente voc pode escolher mensagem de erros em diversas linguae gens.

Valor Retornado
Um string contendo a descrio do erro. Uma string vazia se no ocorrer erros. ca a

Erros
Nenhum

12.1.7.18 mysql_stmt_sqlstate()
const char *mysql_stmt_sqlstate(MYSQL_STMT *stmt)

Descrio ca
Para a intruo especicada por stmt, mysql_stmt_sqlstate(), retorna uma string terca minada em null contendo o cdigo de erro SQLSTATE para funo API de instrues o ca co preparadas mais recentemente chamada que tenha obtido sucesso ou falhado. O cdigo o de erro consiste de cinco caracteres. "00000" signica sem erros. Os valores so esa pecicados pelo ANSI SQL e ODBC. Para uma lista de valores poss iveis, veja Seo 13.1 ca [Error-returns], Pgina 889. a Note que nem todos os erros j esto mapeados para SQLSTATE. O valor "HY000" (erro a a geral) usado para erros no mapeados. e a

Valores Retornados
Uma string terminada em null contendo o cdigo de erro SQLSTATE. o

12.1.8 Tratando a Execuo de M ltiplas Consultas na API C ca u

A partir da verso 4.1, o MySQL suporta a execuo de multiplas instrues especicadas em a ca co uma unica string de consulta. Para utiliz-lo com uma dada conexo, voc deve especicar a a a e

856

MySQL Technical Reference for Version 5.0.0-alpha

opo CLIENT_MULTI_STATEMENTS no parmetro do mysql_real_connect() quando abrir a ca a conexo. Voc tambm pode congur-la para uma conexo chamando mysql_set_server_ a e e a a option(MYSQL_OPTION_MULTI_STATEMENTS_ON) Por padro mysql_query() ou mysql_real_query() retornam apenas o status da primeira a consulta e o status das consultas subsequentes podem ser processados usando mysql_more_ results() e mysql_next_result(). /* Connect to server with option CLIENT_MULTI_STATEMENTS */ mysql_real_connect(..., CLIENT_MULTI_STATEMENTS); /* Now execute multiple queries */ mysql_query(mysql,"DROP TABLE IF EXISTS test_table;\ CREATE TABLE test_table(id INT);\ INSERT INTO test_table VALUES(10);\ UPDATE test_table SET id=20 WHERE id=10;\ SELECT * FROM test_table;\ DROP TABLE test_table"; do { /* Process all results */ ... printf("total affected rows: %lld", mysql_affected_rows(mysql)); ... if (!(result= mysql_store_result(mysql))) { printf(stderr, "Got fatal error processing query\n"); exit(1); } process_result_set(result); /* client function */ mysql_free_result(mysql); }while (!mysql_more_results(mysql))

12.1.9 Manipulando Valores de Data e Hora na API C

O novo protocolo binrio dispon a ivel no MySQL 4.1 e acima lhe permite enviar e receber dados de hora e data (DATE, TIME, DATETIME e TIMESTAMP) utilizando a estrutura MYSQL_ TIME. Os membros desta estrutura esto em Seo 12.1.5 [C API Prepared statement a ca datatypes], Pgina 828. a Para enviar um valor de dado temporal, voc cria uma instruo preparada com mysql_ e ca prepare(). Ento, antes de chamar mysql_execute() para executar a instruo, use o a ca seguinte procedimento para congurar cada parmetro temporal: a 1. Na estrutura MYSQL_BIND associado com o valor do dado, congure o membro buffer_ type para o tipo que indique qual tipo de valor temporal voc est enviando. Para e a

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

857

valores DATE, TIME, DATETIME, ou TIMESTAMP congure buffer_type para MYSQL_TYPE_ DATE, MYSQL_TYPE_TIME, MYSQL_TYPE_DATETIME, ou MYSQL_TYPE_TIMESTAMP repectivamente. 2. Congure o membro buffer da estrutura MYSQL_BIND com o endereo da estrutura c MYSQL_TIME na qual voc passr o valor temporal. e a 3. Preencha os membros da estrutura MYSQL_TIME que so apropriadas para o tipo de a valor temporal que voc est passando. e a Use mysql_bind_param() para ligar os dados do parmetro a instruo. Ento chame a ca a mysql_execute(). Para recuperar valores temporais, o procedimento similar, exceto pelo fato de que voc e e congura o membro buffer_type com o valor que voc espera receber e o membro buffer e com o endereo de uma estrutura MYSQL_TIME na qual o valor retornado deve ser colocado. c Use mysql_bind_results() para ligar o buer a instruo depois da chamada de mysql_ ca execute() e antes de buscar os resultados. Aqui est um exemplo simples que insere dados DATE, TIME e TIMESTAMP. A varivel mysql a a considerada como um handle de conexo vlido. e a a MYSQL_TIME MYSQL_BIND MYSQL_STMT ts; bind[3]; *stmt;

strmov(query, "INSERT INTO test_table(date_field, time_field, timestamp_field) VALUES(?,?,?"); stmt= mysql_prepare(mysql, query, strlen(query))); /* define a entrada do buffer com 3 par^metros */ a bind[0].buffer_type= MYSQL_TYPE_DATE; bind[0].buffer= (char *)&ts; bind[0].is_null= 0; bind[0].length= 0; .. bind[1]= bind[2]= bind[0]; .. mysql_bind_param(stmt, bind); /* fornece os dados a serme enviados na estrutura ts */ ts.year= 2002; ts.month= 02; ts.day= 03; ts.hour= 10; ts.minute= 45; ts.second= 20;

858

MySQL Technical Reference for Version 5.0.0-alpha

mysql_execute(stmt); ..

12.1.10 Descrio das Funes de Threads da API C ca co

Voc precisa utilizar as seguintes funes quando quiser criar um cliente em uma thread. e co Veja Seo 12.1.14 [Clientes em threads], Pgina 863. ca a

12.1.10.1 my_init()
void my_init(void)

Descrio ca
Esta funo precisa ser chamada uma vez pelo programa antes de se chamar qualquer ca funo do MySQL. Ela inicializa algumas varveis globais que o MySQL precisa. se voc ca a e est usando uma biblioteca cliente de thread segura, tambm ser feita uma chamada a a e a mysql_thread_init() para esta thread. Ela chamada automaticamente por mysql_init(), mysql_server_init() e e mysql_connect().

Valor Retornado
Nenhum

12.1.10.2 mysql_thread_init()
my_bool mysql_thread_init(void)

Descrio ca
Esta funo preisa aser chamada para cada thread criada para inicializar variveis espec ca a icas de threads. Ela automaticamente chamada por my_init() e mysql_connect(). e

Valor Retornado
Zero se obtver sucesso. Diferente de zero se ocorrer um erro.

12.1.10.3 mysql_thread_end()
void mysql_thread_end(void)

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

859

Descrio ca
Esta funo precisa ser chamada antes da chamada de pthread_exit() para liberar a ca memria alocada por mysql_thread_init(). o Note que a funo no chamada automaticamente pela biblioteca cliente. Deve ser ca a e chamada explicitamente para evitar perda de memria. o

Valor Retornado
Nenhum.

12.1.10.4 mysql_thread_safe()
unsigned int mysql_thread_safe(void)

Descrio ca
Esta funo indica se o cliente compilado como uma thread segura. ca e

Valor Retornado
1 se o cliente possui thread segura, 0 em outro caso.

12.1.11 Descrio das Funes do Servidor Embutido da API C ca co

Voc deve utilizar as seguints funes se voc quiser permitir que a sua aplicao seja ligada e co e ca a biblicoteca de servidor MySQL embutido. Veja Seo 12.1.15 [libmysqld], Pgina 864. ca a Se o programa ligado com -lmysqlclient em vez de -lmysqld, estas funes no faro e co a a nada. Isto torna possivel escolher entre usar o servidor MySQL embutido e um servidor stand-alone sem modicar nenhum cdigo. o

12.1.11.1 mysql_server_init()
int mysql_server_init(int argc, char **argv, char **groups)

Descrio ca
Esta funo deve ser chamada uma vez no program usando o servidor embutido antes de ca se chamar qualquer iutra funo do MySQL. Ela inicia o servidor e inicializa qualquer ca subsistema (mysys, InnoDB, etc.) que o servidor utilize. Se esta funo no for chamada, o ca a programa ir falhar. Se voc estiver usando o pacote DBUG que vem com o MySQL, voc a e e deve chamar esta funo depois de ter chamado MY_INIT(). ca Os argumentos argc e argv so anlogos ao argumentos para o main(). O primeiro elemento a a de argv ignorado (ele contm normalmente, o nome do programa). por convenincia, argc e e e

860

MySQL Technical Reference for Version 5.0.0-alpha

pode ser 0 (zero) se no houver argumentos de linha de comando para o servidor. mysql_ a server_init() faz uma copia dos argumentos, assim seguro destruir argv ou groups e depois da chamada. A lista de strings terminadas em NULL em groups seleciona qual grupo no arquivo de opes co ser ativado. Veja Seo 4.1.2 [Arquivos de opes], Pgina 216. Por convenincia, groups a ca co a e deve ser NULL, caso no qual os grupos [server] d [emedded] estaro ativos. a

Exemplo
#include <mysql.h> #include <stdlib.h> static char *server_args[] = { "this_program", /* this string is not used */ "--datadir=.", "--key_buffer_size=32M" }; static char *server_groups[] = { "embedded", "server", "this_program_SERVER", (char *)NULL }; int main(void) { mysql_server_init(sizeof(server_args) / sizeof(char *), server_args, server_groups); /* Use any MySQL API functions here */ mysql_server_end(); return EXIT_SUCCESS; }

Valor Retornado
0 se okay, 1 se ocorrer um erro.

12.1.11.2 mysql_server_end()
void mysql_server_end(void)

Descrio ca
Esta funo deve ser chamada no programa depois de todas outra funes MySQL. Ela ca co naliza o srvidor embutido.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

861

Valor Retornado
Nenhum.

12.1.12 D vidas e problemas comuns ao utilzar a API C u 12.1.12.1 Porque Algumas Vezes mysql_store_result() Retorna NULL Aps mysql_query() Returnar com Sucesso? o
E poss para mysql_store_result() retornar NULL seguida de uma chamda com sucesso ivel ao mysql_query(). Quando isto acontece, signica que uma da seguintes condies ocorreu: co Existe um falha no malloc() (por exemplo, se o resultado for muito grande). Os dados no podem ser lidos (ocorreu um erro na conexo). a a A consulta no retornou dados (por exemplo, ela era um INSERT, UPDATE, ou DELETE). a Voc sempre pode vericar se a instruo devia produzir um resultado no vazio chamando e ca a mysql_field_count(). Se mysql_field_count() retornar zero, o resultado est vazio e a a ultima consulta era uma instruo que no devia retorbar valor (por exemplo, um INSERT ou ca a um DELETE). Se mysql_field_count() retorna um valor diferente se zero, a instruo devia ca ter produzido um resultado no vazio. Veja a descrio da funo mysql_field_count() a ca ca para um exemplo. Voc pode testar um erro chamando mysql_error() ou mysql_errno(). e

12.1.12.2 Que Resultados Posso Onbetr de uma Consulta?

Sobre o resultado restornado de uma consulta, voc pode obter as seguintes informaoes: e ca mysql_affected_rows() retorna o nmero de registros afetados pela ultima consulta u ao se fazer uma INSERT, UPDATE, ou DELETE. Uma exceo que se for utilizado DELETE ca e sem uma clusula WHERE, a tabela recriada vazia, o que mais rpido! Neste caso, a e e a mysql_affected_rows() retorna zero para o nmero de registros afetados. u mysql_num_rows() retorna o nmero de registros em um resultado. u Com mysql_store_result(), mysql_num_rows() pode ser chamado assim que mysql_ store_result() retornar. Com mysql_use_result(), mysql_num_rows() s pode o ser chamado depois de ter buscado todos os registros com mysql_fetch_row(). mysql_insert_id() retorna o ID gerado pela ultima consulta que inseriu um registro em uma tabela com indice AUTO_INCREMENT. Veja Seo 12.1.3.32 [mysql_insert_ ca id()], Pgina 803. a Algumas consultas (LOAD DATA INFILE ..., INSERT INTO ... SELECT ..., UPDATE) retornam informaes adcionais. O resultado retornado por mysql_info(). Veja a co e descrio de mysql_info() para o formato da string que ela returnou. mysql_info() ca retorna um ponteiro NULL se no houver informaes adicionais. a co

862

MySQL Technical Reference for Version 5.0.0-alpha

12.1.12.3 Como Posso Obter a ID Unica para a Ultima Linha Inserida?

Se voc inserir um registro em uma tabela contendo uma coluna que tiver o atributo AUTO_ e INCREMENT, voc pode obter o ID gerado mais recentemente chamando a funo mysql_ e ca insert_id(). Voc tambm pode recuperar o ID utilizando a funo LAST_INSERT_ID() em uma string e e ca de consulta que foi passada a mysql_query(). Voc pode vericar se um e indice AUTO_INCREMENT usado executando o seguinte cdigo. e o Ele tambm verica se a consulta era um INSERT com um e indice AUTO_INCREMENT: if (mysql_error(&mysql)[0] == 0 && mysql_num_fields(result) == 0 && mysql_insert_id(&mysql) != 0) { used_id = mysql_insert_id(&mysql); } O ID gerado mais recentemente mantido no servidor em uma base por conexo. Ele no e a a ser alterado por outro cliente. Ele no ser alterado mesmo se voc atualizar outra coluna a a a e AUTO_INCREMENT com um valor no mgico (isto , um valor que no NULL e nem 0). a a e a e Se voc quiser utilizar o ID que foi gerado por uma tabela e inserido em uma segunda tabela, e voc ode utilizar instrues SQL como esta: e co INSERT INTO foo (auto,text) VALUES(NULL,text); INSERT INTO foo2 (id,text) VALUES(LAST_INSERT_ID(),text); # gera ID inserindo NULL # usa ID na segunda tabela

12.1.12.4 Problemas com Ligao na API C ca

Ar ligar com a API C, os segintes error podem ocorrem em alguns sistemas: gcc -g -o client test.o -L/usr/local/lib/mysql -lmysqlclient -lsocket -lnsl Undefined first referenced symbol in file floor /usr/local/lib/mysql/libmysqlclient.a(password.o) ld: fatal: Symbol referencing errors. No output written to client Se isto acontecer em seu sistema, voc deve incluir a biblioteca math adiconando -lm ao e m da linha de compilao/ligao. ca ca

12.1.13 Construindo Programas Clientes

Se voc compilar clientes MySQL escritos por voc mesmo ou obtido de terceiros, else e e devem ser ligados utilizando a opo -lmysqlclient -lz no comando de ligao. Voc ca ca e tambm pode prcisar de especicar uma opo -L para dizer ao ligado onde encntrar a e ca biblioteca. Por exemplo, se a biblioteca instalada em /usr/local/mysql/lib, use e L/usr/local/mysql/lib -lmysqlclient -lz no comando de ligao. ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

863

Para clientes que utilizam arquivos de cabealho do MySQL, pode ser necessrio especicar a c a opo -I ao compil-los, (por exemplo, -I/usr/local/mysql/include), assim o compilador ca a pode encontrar o arquivo de cabealho. c Para o mostrado acima de forma simples no Unix, fornecemos o script mysql_config para voc. Veja Seo 4.9.11 [mysql_config], Pgina 370. e ca a Voc pode utiliz-lo para compila o cliente MySQL como a seguir: e a CFG=/usr/local/mysql/bin/mysql_config sh -c "gcc -o progname $CFG --cflags progname.c $CFG --libs" sh -c necessrio para fazer com que a sheel no trate a sa de mysql_config como uma e a a ida palavra.

12.1.14 Como Fazer um Cliente em Threads

A biblioteca cliente quase segura com threads. O maior problema que a subrotinas em e e net.c que leem dos sockets no so seguras a interrupes. Isto foi feito pesando que voc a a co e pudesse desejar ter o seu prprio alarme que possa quebrar uma longa leitura no servidor. o Se voc instalar manipuladores de interrupo para a interrupo SIGPIPE, o manipulador e ca ca socket deve ser segura com threads. Nos binrios antigos que distribu a imos em nosso web site (http://www.mysql.com/), as bibliotecas clientes no esto normalmente compiladas com a opo de segurana com thread a a ca c (os binrios so complados com segurana com thread por padro). Distribuies binrias a a c a co a mais novas devem ter uma biblioteca normal e uma segura com threads. Para termos um cliente em threads onde voc pode interromper o cliente a partir de oute ras threads a denir tempo limites ao falar com o servidor MySQL, voc deve utilizar as e bibliotecas -lmysys, -lmystrings, e -ldbug e o cdigo net_serv.o que o servidor utiliza. o Se voc no precisar de insterrupes ou de tempos limites, voc pode apenas compilar um e a co e biblioteca cliente (mysqlclient_r) segura com threads e utiliz-las. Veja Seo 12.1 [API a ca C MySQL], Pgina 775. Neste caso voc no precisa se preocupar com o arquivo objeto a e a net_serv.o ou outras bibliotecas MySQL. Quando usar um cliente em thread e voc quiser utilizar tempos limite e interrupes, voc e co e pode ter um grande uso das rotinas no arquivo thr_alarm.c. Se voc estiver utilizando e rotinas da biblioteca mysys, a unica coisa que voc deve lembrar de chamar primeiro e e my_init()! Veja Seo 12.1.10 [Funes Threads do C], Pgina 858. ca co a Todas as funes com excesso de mysql_real_connect() so seguras com thread por co a a padro. As anotaes seguintes descrevem como compilar uma biblioteca cliente segura com a co thread e utiliz-la de maneira segura. (As anotaes abaixo para mysql_real_connect() na a co verdade se aplicam tambm a mysql_connect(), mas como mysql_connect() est obsoleto, e a voc deve utilizar mysql_real_connect().) e Para tornar mysql_real_connect() seguro com thread, voc deve recompilar a biblioteca e cliente com este comando: shell> ./configure --enable-thread-safe-client Isto ir criar uma biblioteca cliente libmysqlclient_r. (Assumindo que o seu SO tenha a a funo gethostbyname_r() segura com thread). Esta biblioteca segura com thread por ca e conexo. Voc pode deixar duas threads compartilharem a mesma conexo com os seguintes a e a cuidados:

864

MySQL Technical Reference for Version 5.0.0-alpha

Duas threads no podem enviar uma consaulta ao servidor MySQL ao mesmo tempo a na mesma conexo. Em particular, voc deve assegurar que entre um mysql_query() a e e mysql_store_result() nenhuma outra thread est usando a mesma conexo. a a Vrias threads podem acessr resultados diferentes que so recuperados com mysql_ a a a store_result(). Se voc utilizar mysql_use_result, voc ter que assegurar que nenhuma outra thread e e a est usando a mesma conexo at que o resultado seja fechado. No entanto, melhor a a e e para clientes em threads que compartilham a mesma conexo utilizar mysql_store_ a result(). Se voc quiser utilizar mltiplas threads na mesma conexo, voc deve ter uma trava e u a e mutex na combinao das chamadas mysql_query() e mysql_store_result(). Uma ca vez que mysql_store_result() esteja pronto, a trva pode ser liberada e outras threads podem utilizar a mesma conexo. a Se voc programa com threads POSIX, voc pode utilizar pthread_mutex_lock() e e e pthread_mutex_unlock() para estabelecer e liberar uma trava mutex. Voc precisa saber o seguinte se voc tiver uma thread que estiver chamando funes MySQL e e co que no criaram a conexo ao banco de dados MySQL: a a Quando voc chamar mysql_init() ou mysql_connect(), MySQL ir criar um varivel e a a especica da thread para a thread que utilizada pela bibklioteca de depurao (entre outra e ca coisas). Se voc chamar uma funo MySQL, antes da thread chamar mysql_init() ou mysql_ e ca connect(), a thread no ter as variveis espec a a a icas de thread necessrias alocadas e voc a e acabar nalizando com uma descarga de memria mais cedo ou mais tarde. a o Para fazer que as coisas funcionem suavemente voc tem que fazer o seguinte: e 1. Chama my_init() no inicio do seu programa se for chamar qualquer outra funo ca MySQL antes de chamar mysql_real_connect(). 2. Chame mysql_thread_init() no manipulador de thread antes de chamar qualquer outra funo MySQL. ca 3. Na thread, chame mysql_thread_end() antes de chamar pthread_exit(). Isto ir a liberar a memria usada pelas variveis espec o a icas da thread do MySQL. Voc pode obter alguns erros devido a s e imbolos indenidos ao ligar seu cliente com libmysqlclient_r. Na maioria dos casos isto ocorre por no estar inclu a biblioteca a ida de threads na linha de ligao/compilao. ca ca

12.1.15 libmysqld, a Biblioteca do Servidor Embutido MySQL 12.1.15.1 Viso Geral da Biblioteca do Servidor MySQL a Embutido
A biblioteca do servidor MySQL embutido torna poss executar um servidor MySQL com ivel todos os recursos dentro de uma aplicao cliente. Os principais benef ca icios so o aumento a de velocidade e o gerenciamento mais simples de aplicaes embutidas. co

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

865

A biblioteca do servidor embutido baseada na verso cliente/servidor do MySQL, que e a e escrita em C/C++. Consequentemente, o servidor embutido tambm escrito em C/C++. e e No h nenhum servidor embutido dispon em outra linguagem. a a ivel A API idntica para a verso embutida do MySQL e a verso cliente/servidor. Para alterar e e a a uma aplicao em thread antiga para utilizar a biblioteca embutida, voc normalmente s ca e o precisa adicionar chamadas as seguintes funes: co Funo ca mysql_server_ init() mysql_server_end() mysql_thread_ init() mysql_thread_end() Quando chamar Deve ser chamada antes de qualquer outra funo MySQL, de ca preferncia no inicio da funo main(). e ca Deve ser chamada antes da sa do programa. ida Deve ser chamada em cada thread que voc criar que acessar e a o MySQL. Deve ser chamada antes de se chamar pthread_exit()

Voc deve ligar seu cdigo com libmysqld.a em vez de libmysqlclient.a. e o As funes acima mysql_server_xxx tambm esto inclu co e a idas em libmysqlclient.a para permitir a troca entre a verso embutida e a clienete/servidor apenas ligando sua aplicao a ca na biblioteca certa. Veja Seo 12.1.11.1 [mysql_server_init()], Pgina 859. ca a

12.1.15.2 Compilando Programas com libmysqld

Para obter uma biblioteca libmysqld voc deve congurar o MySQL com a opo --withe ca embedded-server. Quando voc liga o seu programa com libmysqld, voc tambm deve incluir a biblioteca e e e espec ica do sistema pthread e algumas bibliotecas que o servidor MySQL utiliza. Voc e pode conseguir a lista completa de bibliotecas executando mysql_config --libmysqldlibs. Os parmetros corretos para compilar e ligar um programa em thread devem ser usados, a mesmo se voc no chamar nenhuma funo thread diretamente em seu cdigo. e a ca o

12.1.15.3 Restries no Uso de um Servidor MySQL Embutido co

O servidor embutido tem as seguintes limitaes: co No tem suporte a tabelas ISAM. (Isto feito para tornar a biblioteca menor) a e No possui funes denidas pelo usurio (UDF). co a No ratreia pilha em caso de descarga de memria. a o Sem suporte a RAID interno. (Normalmente no necessrio j que a maioria dos SO a e a a possui suporte a arquivos grandes). Voc pode congur-lo como servidor ou master (sem replicao). e a ca Voc no pode conectar ao servidor embutido de um processo externo com sockets ou e a TCP/IP. Algumas desta limitaes podem ser alteradas editando o arquivo mysql_embed.h e reco compilando o MySQL.

866

MySQL Technical Reference for Version 5.0.0-alpha

12.1.15.4 Usando Arquivo de Opes com o Servidor Embutido co

O descrito abaixo o modo recomendado de utilizar arquivos de opes para facilitar a troca e co entre uma aplicao cliente/servidor uma onde o MySQL est embutido. Veja Seo 4.1.2 ca e a ca [Arquivos de opo], Pgina 216. ca a Coloque as sees comuns na seo [server]. Ela ser lida por ambas as verses do co ca a o MySQL. Coloque a opces espec o icas do cliente/servidor na seo [mysqld]. ca Coloque as opes especicas do MySQL embutido na seo [embedded]. co ca Coloque as opes especicas da aplicao na seo [ApplicationName_SERVER]. co ca ca

12.1.15.5 Itens a Fazer no Servidor Embutido (TODO)

Estamos fornecendo opes para deixar de fora algumas partes do MySQL para tornar co a biblioteca menor. Ainda h muita otimizao de velocidade a se fazer. a ca O erros so escritos no stderr. Adicionaremos uma opo para especicar um nome a ca de arquivo para eles. Temos que alterar o InnoDB para no ser to descritivo quando usado em um servidor a a embutido.

12.1.15.6 Um Exemplo Simples de Servidor Embutido

Este programa e makele exemplo devem funcionar sem nenhuma alterao em um sistema ca Linux ou FreeBSD. Para outros sistemas operacionais, pequenas mudanas sero necessrias. c a a Este exemplo feito para dar detalhes sucientes para enteder o problema, sem a desordem e que uma parte necessria de uma aplicao real. e a ca Para experimentar o exemplo, crie um diretrio test_libmysqld no mesmo n o ivel que o diretrio fonte do mysql-4.0. Salve o fonte test_libmysqld.c e o GNUmakefile no o diretrio e execute GNU make de dentro do diretrio test_libmysqld. o o test_libmysqld.c /* * A simple example client, using the embedded MySQL server library */ #include #include #include #include <mysql.h> <stdarg.h> <stdio.h> <stdlib.h>

MYSQL *db_connect(const char *dbname); void db_disconnect(MYSQL *db); void db_do_query(MYSQL *db, const char *query);

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

867

const char *server_groups[] = { "test_libmysqld_SERVER", "embedded", "server", NULL }; int main(int argc, char **argv) { MYSQL *one, *two; /* * * * * * * * * mysql_server_init() devve ser chamado antes de qualquer fun~o mysql. ca Voc^ pode usar mysql_server_init(0, NULL, NULL), e iniciar e o servidor usando os grupos = { "server", "embedded", NULL }. Em seu arquivo $HOME/.my.cnf file, voc^ provavelmente deseja colocar: e

[test_libmysqld_SERVER] language = /path/to/source/of/mysql/sql/share/english * claro que voc^ poderia modifcar argc e argv antes de pass-los E e a * a esta fun~o. Ou poder criar novos do modo que preferir. Mas ca a * todos os argumentos em argv (exceto argv[0], que o nome do e * programa) devem ser op~es vlidas para o servidor MySQL. co a * * Se voc^ ligar este cliente em um biblioteca mysqlclient e * normal, esta fun~o n~o far nada. ca a a */ mysql_server_init(argc, argv, (char **)server_groups); one = db_connect("test"); two = db_connect(NULL); db_do_query(one, "SHOW TABLE STATUS"); db_do_query(two, "SHOW DATABASES"); mysql_close(two); mysql_close(one); /* Isto deve ser chamado depois de todas outras fun~es mysql*/ co mysql_server_end(); exit(EXIT_SUCCESS); }

868

MySQL Technical Reference for Version 5.0.0-alpha

static void die(MYSQL *db, char *fmt, ...) { va_list ap; va_start(ap, fmt); vfprintf(stderr, fmt, ap); va_end(ap); (void)putc(\n, stderr); if (db) db_disconnect(db); exit(EXIT_FAILURE); } MYSQL * db_connect(const char *dbname) { MYSQL *db = mysql_init(NULL); if (!db) die(db, "mysql_init failed: no memory"); /* * Certifique-se que o cliente e o servidor utilizam grupos diferentes. * Isto critico pois o servidor n~o aceitar as op~es do e a a co * cliente e vice versa. */ mysql_options(db, MYSQL_READ_DEFAULT_GROUP, "test_libmysqld_CLIENT"); if (!mysql_real_connect(db, NULL, NULL, NULL, dbname, 0, NULL, 0)) die(db, "mysql_real_connect failed: %s", mysql_error(db)); return db; } void db_disconnect(MYSQL *db) { mysql_close(db); } void db_do_query(MYSQL *db, const char *query) { if (mysql_query(db, query) != 0) goto err; if (mysql_field_count(db) > 0) { MYSQL_RES *res; MYSQL_ROW row, end_row;

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

869

int num_fields; if (!(res = mysql_store_result(db))) goto err; num_fields = mysql_num_fields(res); while ((row = mysql_fetch_row(res))) { (void)fputs(">> ", stdout); for (end_row = row + num_fields; row < end_row; ++row) (void)printf("%s\t", row ? (char*)*row : "NULL"); (void)fputc(\n, stdout); } (void)fputc(\n, stdout); mysql_free_result(res); } else (void)printf("Affected rows: %lld\n", mysql_affected_rows(db));

return; err: die(db, "db_do_query failed: %s [%s]", mysql_error(db), query); } GNUmakefile # This assumes the MySQL software is installed in /usr/local/mysql inc := /usr/local/mysql/include/mysql lib := /usr/local/mysql/lib # If you have not installed the MySQL software yet, try this instead #inc := $(HOME)/mysql-4.0/include #lib := $(HOME)/mysql-4.0/libmysqld CC := gcc CPPFLAGS := -I$(inc) -D_THREAD_SAFE -D_REENTRANT CFLAGS := -g -W -Wall LDFLAGS := -static # You can change -lmysqld to -lmysqlclient to use the # client/server library LDLIBS = -L$(lib) -lmysqld -lz -lm -lcrypt ifneq (,$(shell grep FreeBSD /COPYRIGHT 2>/dev/null)) # FreeBSD LDFLAGS += -pthread else # Assume Linux

870

MySQL Technical Reference for Version 5.0.0-alpha

LDLIBS += -lpthread endif # This works for simple one-file test programs sources := $(wildcard *.c) objects := $(patsubst %c,%o,$(sources)) targets := $(basename $(sources)) all: $(targets) clean: rm -f $(targets) $(objects) *.core

12.1.15.7 Licensiando o Servidor Embutido

O cdigo fonte do MySQL coberto pela liceno GNU GPL (veja Apndice H [Licena o e ca e c GPL], Pgina 1096). Um resultado disto que qualquer programa que incluam, na ligao a e ca com libmysqld, o cdigo fonte do MySQL deve ser distribu como software livre. (sob o ido com a GPL). uma licena compativel c Ns encorajamos a todos a promover o software livre distribuindo o cdigo sob a GPL ou o o uma licena compat c ivel. Para aqueles que no puderem faz-lo, outra opo comprar um a e ca e licena comercial para o cdigo MySQL da MySQL AB. Para maiores detalhes, consulte c o Seo 1.4.3 [MySQL licenses], Pgina 18. ca a

12.2 Suporte ODBC ao MySQL

O MySQL fornece suporte para ODBC atravs do programa MyODBC. Este cap e itulo lhe ensinar como instalar o MyODBC, e como us-lo. Aqui, voc tambm encontrar uma lista a a e e a de programas comuns que so conhecidos por funcionar com MyODBC. a

12.2.1 Como Instalar o MyODBC

MyODBC 2.50 um driver de n 0 (com recursos de n 1 e 2) e especicao de ODBC e ivel ivel ca 2.50 de 32 bits para conectar um programa ODBC ao MySQL. MyODBC funciona nos Windows 9x/Me/NT/2000/XP e na maioria da plataformas Unix. MyODBC 3.51 uma verso e a melhorada com n 1 (core API completo + recursos de n 2) e especicao de ODBC ivel ivel ca 3.5x. MyODBC Open Source, e voc pode encontrar a verso mais nova em e e a http://www.mysql.com/downloads/api-myodbc.html. Note que a verso 2.50.x a utiliza a licena LGPL, enquanto a verso 3.51.x utiliza a licena GPL. c a c Se vc tiver problemas com o MyODBC e seu programa tambm funciona com OLEDB, voc e e e deve experimentar o driver OLEDB. Normalmente voc s precisa instalar o MyODBC em msquinas Windows. Voc s precisar e o a e o a de MyODBC para Unix se tiver um programa como ColdFusion que roda em mquinas Unix a e utilizam ODBC para conectar ao banco de dados.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

871

Se voc quiser instalar MyODBC em um Unix, voc precisar de um gerenciador ODBC. e e a MyODBC funciona com a maioria dos gerenciadores ODBC para Unix. Para instalar MyODBC no Windows, voc deve baixar o arquivo MyODBC .zip apropriado, e descompact-lo com WinZip ou algum programa parecido e executar o arquivo SETUP.EXE. a No Windows/NT/XP voc pode obter o seguinte erro ao tentar instalar o MyODBC: e An error occurred while copying C:\WINDOWS\SYSTEM\MFC30.DLL. Restart Windows and try installing again (before running any applications which use ODBC) O problema neste caso que algum outro progrma est utilizando ODBC e pela forma que e a como o Windows feito, voc pode, neste caso, no estar apto a instalar um novo driver e e a ODBC com programa de instao do ODBC da Microsoft. Neste caso voc pode continuar ca e selecionando Ignore para copiar o resto dos aerquivos ODBC e a instalao nal deve ca funcionar. Se no funcionar, a soluo reinicializar seu computador em modo seguro a ca e (Escolhendo-o ao pressionar F8 assim que seu computador iniciar o Windows durante a reinicializao), instalar MyODBC, e reiniciar em modo normal. ca Para conectar a uma mquina Unix de uma mquina Windows, com uma aplicao a a ca ODBC (uma que no tenha suporte nativo as MySQL), voc deve primeiro instalar a e MyODBC em uma mquina Windows. a O usurio mquina Windows devem ter privilgios para acessar o servidor MySQL a e a e na mquina Unix. Isto pode ser feito om o comando GRANT. Veja Seo 4.4.1 [GRANT], a ca Pgina 254. a Voc deve criar uma entrada ODBC DSN como a seguir: e Abra o painel de controle na mquina Windows. a D um duplo clique no icone Fonte de Dados ODBC 32-bit. e Clique na seo Usurio DSN. ca a Clique no boto Adicionar. a Selecione MySQL na tela Criar Nova Fonte de Dados e clique no boto Finalizar. a A tela de congurao padro do Driver MySQL mostrada. Veja Seo 12.2.2 ca a e ca [Administrador ODBC], Pgina 871. a Agora inicie a sua aplicao e selcione o driver ODBC com o DSN que voc especicou ca e no adminitrador ODBC. Verique se h outra opo de congurao na tela do MySQL (trace, no pergunta ao a ca ca a conectar, etc) que voc possa tentar se ocorrerem problemas. e

12.2.2 Como Preencher os Vrios Campos no Programa de a Administrao do ODBC ca

Existem trs maneiras poss e iveis de especicar o nome de servidor no Windows95: Use o endereo IP no servidor. c Adicione um arquivo \Windows\lmhosts com a seguinte informao: ca ip nome_maquina Por exemplo:

872

MySQL Technical Reference for Version 5.0.0-alpha

194.216.84.21 meu_nome_maquina Congure o PC para utilizar DNS. Exemplo de como preencher a configura~o do ODBC. ca Windows DSN name: test Description: This is my test database MySQL Database: test Server: 194.216.84.21 User: monty Password: my_password Port: O valor para o campo Windows DSN name qualquer nome que seja unico em sua congurao e ca ODBC Windows. Voc no precisa especicar valores para os campos Server, User, Password, ou Port ina e a tela de congurao do ODBC. No entanto, se voc o zer, os valores sero utilizados como ca e a padro posteriormente ao se tentar fazer uma nova conexo. Voc tem a opo de alterar a a e ca os valores neste momento. Se o nmero da porta no dado, a porta padro (3306) utilizada. u a e a e Se voc especicar a opo Read options from C:\my.cnf, os grupos client e odbc sero e ca a lidos do arquivo C:\my.cnf. Voc pode utilizar todas as opes que so uteis a mysql_ e co a options(). Veja Seo 12.1.3.40 [mysql_options()], Pgina 809. ca a

12.2.3 Parmetros de Conexo do MyODBC a a

Pode-se especicar os seguintes parmetros para MyODBC na seo [Servername] de a ca um arquivo ODBC.INI ou atravs do argumento InConnectionString na chamada e SQLDriverConnect(). Parmetro a Valor padro a Comentrio a user ODBC (on O nome do usurio usado para se conectar ao MySQL. a Windows) server localhost O nme de mquina do servidor MySQL. a database O banco de dados padro. a option 0 Um inteiro com o qual voc pode especicar como o e MyODBC deve tarbalhar. Veja abaixo. port 3306 A porta TCP/IP usada se o servidor (server) no for a localhost. stmt Uma instruo que ser executada ao conectar ao MySQL. ca a password A senha para a combinao servidor(server)ca usurio(user). a socket O socket ou pipe Windows para se conectar. O argumento option usado para dizer ao MyODBC que o cliente no 100% compat com e a e ivel ODBC. No Windows, o parmetro option normalmente denido mudando as diferentes a e opes na tela de conexo mas tambm podem ser denidas no argumento option. As co a e seguintes opes esto listadas na mesma ordem em que aparecem na tela de conexo do co a a MyODBC: Bit Descrio ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

873

O cliente no pode aceitar que MyODBC retorne a largura real de uma coluna. a O clinete n pode aceitr que MySQL retorne o valor real de colunas afetadas. a Se este parmetro for denido o MySQL retornar registros encontrados. E a a necessriop o MySQL 3.21.14 ou posterior para funcionar. a 4 Faz um log de depurao em c:\myodbc.log. E o mesmo que colocar MYSQL_ ca DEBUG=d:t:O,c::\myodbc.log no AUTOEXEC.BAT 8 No dene nenhum limite de pacote para resultados e parmetros. a a 16 No faz perguntas mesmo se o driver quisesse. a 32 Simula um driver ODBC 1.0 em alguns contextos. 64 Ignora o uso do nome de banco de dados bancodedados.tabela.coluna 128 Fora o usa de cursores de gerenciadores ODBC (experimental). c 256 Disabilita o uso de busca estendida (experimental). 512 Completa campos CHAR para tamanho de coluna cheias. 1024 SQLDescribeCol() retrnar nome de colunas totalmente qualicados. a 2048 Usa o protocolo cliente/servidor comprimido. 4096 Diz ao seridor para ignorar espaos aps nome de funes e antes de ( c o co (necessrio para PowerBuilder). Torna todos os nomes de funes palavrasa co chaves! 8192 Conecta com named pipes ao servidor mysqld executando no NT. 16384 Altera colunas LONGLONG para colunas INT (algumas aplicaes no podem co a tratar LONGLONG). 32768 Retorna user como Table qualier e Table owner para SQLTables (experimental) 65536 L parametros dos grupos client e odbc no my.cnf e a 131072 Adiciona algumas vericaes extras de segurana (no deve ser necessrio, co c a a mas...) Se voc quiser ter muitas opes, voc deve somar os parmetros acima! Por exemplo, e co e a denir a opo como 12 (4+8) lhe permite debugar sem limite de pacotes. ca O MYODBC.DLL padro compilado para um rendimento otimizado. Se voc quiser depurar a e e o MyODBC (por exemplo, habiliatr o trace), voc deve utilizar MYODBCD.DLL. Para instalar e este arquivo copie MYODBCD.DLL sobre o arquivo MYODBC.DLL instalado.

1 2

12.2.4 Como Relatar Problemas com o MyODBC

MyODBC tem sido testado com Access, Admndemo.exe, C++-Builder, Borland Builder 4, Equipe de Desenvovimento Centura (formalmente Gupta SQL/Windows), ColdFusion (em Solaris e NT com svc pack 5), Crystal Reports, DataJunction, Delphi, ERwin, Excel, iHTML, FileMaker Pro, FoxPro, Notes 4.5/4.6, SBSS, Perl DBD-ODBC, Paradox, Powerbuilder, Powerdesigner 32 bit, VC++, e Visual Basic. Se voc souber de qualquer outra aplicao que funcione com MyODBC, envie-nos email para e ca lista de email odbc do MySQL sobre isto! Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a Com alguns programas voc pode obter um erro como este: Another user has modifies e the record that you have modified. Na maioria dos casos ele pode ser resolvido fazendo o especicado abaixo: Adicione um chave primria para a tabela se j no houver uma. a a a Adicione uma coluan timestamp se j no existir uma. a a

874

MySQL Technical Reference for Version 5.0.0-alpha

S utilize campos double oat. Alguns programa podem falhar quando comparam o oats simples. Se o exposto acima no ajudar, voc deve fazer um arquivo de rastreamento do MyODBC e a e tentar encontrar o que est dando errado. a

12.2.5 Programas que Funcionam com MyODBC

A maioria dos programas devem funcionar com MyODBC, mas para cada um dos listados aqui, ns mesmos testamos e recebemos conrmaao de alguns usurios que eles funcionam: o c a Programa Comentrio a Access Para fazer o Access funcionar: Se voc estiver usando Access 2000, voc deve obter e instalar o Microsoft e e MDAC (Microsoft Data Access Components) mais recente (verso 2.6 a ou acima) em http://www.microsoft.com/data/. Ele ir consertar o a o seguinte bug no Access: quando voc exporta dados para o MySQL, e os nomes de tabelas e colunas no so especicados. Outro modo de a a contornar este bug atualizar para MyODBC Verso 2.50.33 e MySQL e a Verso 3.23.x, que juntos fornecem um modo de contornar este erro! a Voc tambm deve obter e instalar Microsoft Jet 4.0 Service Pack 5 (SP5) e e que pode ser encontrado em http://support.microsoft.com/support/kb/articles/Q 239/1/14.ASP. Isto ir corrigir alguns casos onde colunas so marcadas a a como #deletadas# no Access. Note que se voc estiver usando o MySQL Verso 3.22, voc deve aplicar o e a e patch MDAC e utilizar MyODBC 2.50.32 ou 2.50.34 e acima para contornar este problema. Para todas as verses do Access, voc deve habilitar a opo do MyOo e ca DBC Return matching rows. Para Access 2.0, voc tambm deve habilitar e e Simulate ODBC 1.0. Voc deve ter um timestamp em todas as tabelas que voc deseja atue e alizar. Para maior portabilidade TIMESTAMP(14) ou apenas TIMESTAMP e recomendado no lugar de outras variaes de TIMESTAMP(X). co Voc deve ter uma chave primia na tabela. Se no, registros novos ou e a a atualizados podem aparecer como #DELETED#. S use campos DOUBLE oat. O Access falaha ao comparar com campos o single oats. Os sintomas normais so que registros novos ou atualizados a podem aparecer como #DELETED# ou que voc no possa encontarar ou e a atualizar registros. Se voc estiver ligando uma tabela com MyODBC, que tem BIGINT como e uma de suas colunas, o resultado ser mostrado como #DELETED. A soluo a ca para contornar este problema : e Tenha um ou mais colunas modelos com TIMESTAMP como o tipo de dados, de preferncia TIMESTAMP(14). e Verique Change BIGINT columns to INT na ciaxa dilogo de a opes de conexo no Admiistrador DSN ODBC co a

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

875

Delete o link a tabela e o recrie. Ele ainda mostra o registro anterior como #DELETADO#, mas novos registros adicionados/atualizados sero mostrados apropriadamente. a Se voc ainda obter o erro Another user has changed your data depois e de adicionar uma coluna TIMESTAMP, o seguinte truque pode lhe ajudar: N`o utilize visualizar planilha de dados da tabela. Crie um formulario com a os campos que voc quer, e use visulizar planilha de dados de formulrio. e a Voc deve denir a propriedade DefaultValue para a coluna TIMESTAMP e com NOW(). Esta pode ser uma boa idia para oculta a coluna TIMESTAMP e da visualizao para que seus usurios no quem confusos. ca a a Em alguns casos, o Access pode gerar consultas SQL invlidas a que o MySQL no entende. Voc pode arrumar isto selecionando a e "Query|SQLSpecific|Pass-Through" no menu do Access. No NT o Access ir mostrar colunas BLOB como OLE OBJECTS. Se voc a e quiser colunas MEMO, voc deve alterar a coluna para TEXT com ALTER e TABLE. O Access no pode sempre tratar colunas DATE apropriadamente. Se voc a e tiver um problema com isto, mude as colunas para DATETIME. Se voc tiver no Acces um coluna denida como BYTE, o Access tentar e a export-la como TINYINT em vez de TINYINT UNSIGNED. Isto lhe tar proba a lemas se voc tiver valores > 127 na coluna! e

ADO

Quando voc est codicando com a API ADO e MyODBC voc precisa ter e a e ateno com algumas propriedades padres que no so suportadas pelo ca o a a servidor MySQL. Por exemplo, usando CursorLocation Property como adUseServer retornar de RecordCount Property um resultado de -1. Para a ter o valor correto, voc precisa denir esta propriedade a adUseClient, como e mostrado no cdigo VB abaixo: o Dim myconn As New ADODB.Connection Dim myrs As New Recordset Dim mySQL As String Dim myrows As Long myconn.Open "DSN=MyODBCsample" mySQL = "SELECT * from user" myrs.Source = mySQL Set myrs.ActiveConnection = myconn myrs.CursorLocation = adUseClient myrs.Open myrows = myrs.RecordCount myrs.Close myconn.Close Outro modo de contornar o problea utilizar uma instruo SELECT COUNT(*) e ca para uma consulta parecida para obter a contagem de registros correta.

876

MySQL Technical Reference for Version 5.0.0-alpha

Active server pages (ASP) Voc deve usar a opo Return matching rows. e ca Aplicaes BDE co Para faze-las funcionar, voc deve denir os seguintes parmetros: Dont e a optimize column widths e Return matching rows. Borland Builder 4 Qaundo voc inicia uma consulta, voc pode utilizar a propriedade Active ou e e utilizar o mtodo Open. Note que Active ir iniciar automaticamente execue a tando uma consulta SELECT * FROM ... que pode no ser algo bom se suas a tabelas forem grandes. ColdFusion (No Unix) A seguinte informaes tirada da documentao do ColdFusion: co e ca Utilize a seguinte informao para congurar o ColdFusion Server para ca Linux para utilizar o driver unixODBC driver com MyODBC para fonte de dados MySQL. Allaire vericou que o MyODBC Verso 2.50.26 funciona com a MySQL Verso 3.22.27 e ColdFusion para Linux. (Quqlquer verso mais a a nova tambm deve funcionar.) Voc pode fazer o download do MyODBC em e e http://www.mysql.com/downloads/api-myodbc.html ColdFusion Verso 4.5.1 lhe permite utilizar o Administrador ColdFusion para a adicionar a fonte de dados MySQL. No entanto o driver no est inclu com a a ido o ColdFusion Verso 4.5.1. Antes que o driver MySQL aparecer na lista dropa down de fonte de dados ODBC, voc deve construir e copiar o driver MyODBC e para /opt/coldfusion/lib/libmyodbc.so. O diretrio Contrib contm o programa mydsn-xxx.zip que lhe permite o e construir e remover o arquivo de registro DSN para o driver MyODBC em aplicaes Coldfusion. co DataJunction Voc tem que alter-lo para uma sa VARCHAR em vez de ENUM, ja que ele e a ida exporta o ultimo de uma maneira que cause um grief no MySQL. Excel Funciona. Algumas dicas: Se voc tiver problema com datas, tente selecion-las como strings utie a lizando a funo CONCAT(). Por exemplo: ca select CONCAT(rise_time), CONCAT(set_time) from sunrise_sunset; Valores retornados deste modo como strings devem ser reconhecidos corretamente como valores time pelo Excel97. O propsito de CONCAT() neste exemplo enganar o ODBC fazendo-o o e pensar que a coluna do tipo string. Sem o CONCAT(), ODBC sabe que e a coluna do tipo time e o Excel no entende isto. e a Note que este um bug do Excel, pois ele converte automaticamente uma e string para um time. Isto seria timo se a fonte fosse um arquivo texto, o mas se torna um erro quando a fonte e uma conexo ODBC que relata a tipos exatos para cada coluna.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

877

Word Para recuperar os dados do MySQL para documentos Word/Excel, voc precisa e utilizar o driver MyODBC e a ajuda do Add-in Microsoft Query. Por exemplo, crie um bd com uma tabela contendo 2 colunas de texto: Insira registros utilizando a ferramente cliente de linha de comando mysql. Crie um arquivo DSN usando o gerenciador ODBC, my, por exemplo, para o bd acima. Abra o aplicativo Word. Crie um novo documento vazio. Utilizando a barra de ferramentas chamada Banco de Dados, pressione o boto insira banco de dados. a Pressione o boto Obter Dados. a No moemnto certo, pressione o boto Ms Query na tela Obter Dados. a No Ms Query crie uma Nova Fonte de Dados utilizando o arquivo DSN my. Selecione a nova consulta. Selecione as colunas que voc deseja. e Crie um ltro de desejar. Faa um Ordenao se quiser. c ca Selecione Enviar Dados para o Microsoft Word. Clique em Finalizar. Clique em Inserir dados e selecione os registros. Clique OK e voc ver os registros no seu documento Word. e a odbcadmin Pograma teste para ODBC. Delphi Voc deve utilizar o BDE Verso 3.2 ou mais atual. Veja a opo i Dont e a ca optimize column width ao conectar no MySQL. Aqui est um cdigo de Delphi potencialmente util que congura uma entrada a o ODBC e uma entrada BDE para para MyODBC (a entrada BDE exige de um Editor de Alias BDE que gratuito em um site Delphi Super Page. (Obrigado e a Bryan Brunton bryan@flesherfab.com por isto): fReg:= TRegistry.Create; fReg.OpenKey(\Software\ODBC\ODBC.INI\DocumentsFab, True); fReg.WriteString(Database, Documents); fReg.WriteString(Description, ); fReg.WriteString(Driver, C:\WINNT\System32\myodbc.dll); fReg.WriteString(Flag, 1); fReg.WriteString(Password, ); fReg.WriteString(Port, ); fReg.WriteString(Server, xmark); fReg.WriteString(User, winuser); fReg.OpenKey(\Software\ODBC\ODBC.INI\ODBC Data Sources, True);

878

MySQL Technical Reference for Version 5.0.0-alpha

fReg.WriteString(DocumentsFab, MySQL); fReg.CloseKey; fReg.Free; Memo1.Lines.Add(DATABASE NAME=); Memo1.Lines.Add(USER NAME=); Memo1.Lines.Add(ODBC DSN=DocumentsFab); Memo1.Lines.Add(OPEN MODE=READ/WRITE); Memo1.Lines.Add(BATCH COUNT=200); Memo1.Lines.Add(LANGDRIVER=); Memo1.Lines.Add(MAX ROWS=-1); Memo1.Lines.Add(SCHEMA CACHE DIR=); Memo1.Lines.Add(SCHEMA CACHE SIZE=8); Memo1.Lines.Add(SCHEMA CACHE TIME=-1); Memo1.Lines.Add(SQLPASSTHRU MODE=SHARED AUTOCOMMIT); Memo1.Lines.Add(SQLQRYMODE=); Memo1.Lines.Add(ENABLE SCHEMA CACHE=FALSE); Memo1.Lines.Add(ENABLE BCD=FALSE); Memo1.Lines.Add(ROWSET SIZE=20); Memo1.Lines.Add(BLOBS TO CACHE=64); Memo1.Lines.Add(BLOB SIZE=32); AliasEditor.Add(DocumentsFab,MySQL,Memo1.Lines); C++ Builder Testado com BDE verso 3.0. O unico problema conhecido que quando o a e esquema de tabelas alterado, os campos da consulta no so atualizados. e a a O BDE, no entanto, parece no reconhecer chaves primrias, apenas o a a indice PRIMARY, mas isto ser um problema. a Vision Voc deve utilizar a opco Return matching rows. e a

Visual Basic Para estar apto para habilitar uma tabela, voc deve denir uma chave primria e a para a tabela. Visual Basic com ADO no pode manipular inteiros grandes. Isto signica a que algumas consultas como SHOW PROCESSLIST no iro funcionar apropriadaa a mente. A correo deinir a opo OPTION=16384 na string de conexo ODBC ca e ca a ou congurar a opo Change BIGINT columns to INT na tela de conexo do ca a MyODBC. Voc pode desejar denir a opo Return matching rows. e ca VisualInterDev Se voc obtem o erro [Microsoft][ODBC Driver Manager] Driver does not e support this parameter a razo pode ser que voc tem um BIGINT em seu a e resultado. Tente denir a opo Change BIGINT columns to INT na tela de ca conexo do MyODBC. a Visual Objects Voc deve utilizar a opo Dont optimize column widths. e ca

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

879

12.2.6 Como Obter o Valor de uma Coluna AUTO_INCREMENT no ODBC

Um problema comum como obter o valor de um ID gerado automaticamente em um e INSERT. Com ODBC, voc pode fazer algo assim (considerando que auto um campo e e AUTO_INCREMENT): INSERT INTO foo (auto,text) VALUES(NULL,text); SELECT LAST_INSERT_ID(); Ou, se voc estiver prestes a insrir o ID em outra tabela, voc pode fazer assim: e e INSERT INTO foo (auto,text) VALUES(NULL,text); INSERT INTO foo2 (id,text) VALUES(LAST_INSERT_ID(),text); Veja Seo 12.1.12.3 [Obtendo um ID unico], Pgina 862. ca a Para o beneficio de alguns aplicativos ODBC (pelo menos Delphi e Access), a seguinte consulta pode ser utilizada para encontrar um registro rcem inserido: e SELECT * FROM nome_tabela WHERE auto IS NULL;

12.2.7 Relatando Problemas com MyODBC

Se voc encontrar diculdades com MyODBC, voc deve iniciar fazendo um arquivo log pelo e e gerenciador ODBC (o log obtido ao requisitar logs do ODBCADMIN) e um log MyODBC. Para obter um log MyODBC, voc precisa fazer o seguinte: e 1. Esteja certo de que voc est utilizando myodbcd.dll e no myodbc.dll. O e a a modo mais fcil de se fazer isto obter myodbcd.dll da distribuio MyODBC a e ca e copi-la sobre o myodbc.dll, o qual estar, provavelmente, em seu diretrio a a o C:\Windows\system32 ou C:\winnt\system32. Note que voc provavelmente deseja restaurar o myodbc.dll antigo ao nalizar o teste, e j que ele bem mais rpido que myodbcd.dll. a e 2. Marque a opo Trace MyODBC na tela de conexo/congurao do MyODBC. O logo ca a ca ser escrito no arquivo C:\myodbc.log. a Se a opo de ratreamento no for lembrada quando voc retornar a tela acima, signica ca a e que voc no est utilizando o driver myodbcd.dll (veja o item acima). e a a 3. Inicie sua aplicao e tente faz-la falhar. ca e Verique o arquivo de rastreamento do MyODBC, para saber o que pode estar errado. Vioc deve estar apto a encontrar as consultas executadas buscando aps a string >mysql_ e o real_query no arquivo myodbc.log. Voc tambm devev tentar duplicar as consultas no monitor mysql ou admndemo para dee e scobrir se o erro do MyODBC ou do MySQL. e Se voc encontar algo errado, envie-nos somente os registros relevantes (max 40 registros) e para a lista de email odbc do MySQL. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. Por ca a favor, nunca envie todo o arquivo log do MyODBC ou ODBC! Se voc no puder encontrar o que est errado, a ultima opo fazer um arquivo e a a ca e (tar ou zip) que contenha um arquivo de rastreamento do MyODBC, o arquivo log do ODBC, e um arquivo README que explique o problema. Voc pode envi-lo para e a

880

MySQL Technical Reference for Version 5.0.0-alpha

ftp://support.mysql.com/pub/mysql/secret/. Somente ns da MySQL AB teremos o acesso ao arquivo que voc enviar, a seremos bem discretos com os dados! e Se voc pode criar um programa que tambm mostre este problema, nos envie ele tambm. e e e Se o programa funciona com algum outro servidor MySQL, voc deve fazer um arquivo de e log do MyODBC onde voc faz exatamente a mesma coisa no ouuto servidor SQL. e Lembre-se que quanto mais informaes voc nos fornecer, mais satisfatria ser a soluo co e o a ca encontrada para o problema!

12.3 Conectividade Java (JDBC) ao MySQL

Existem 2 drivers JDBC suportados pelo MySQL: MySQL Connector/J do MySQL AB, implementado 100% em Java nativo. Este produto era formalmente conhecido como o driver mm.mysql. Voc pode fazer o doenload do e MySQL Connector/J em http://www.mysql.com/products/connector-j/.

O driver Resin JDBC, que pode ser encontrado em http://www.caucho.com/projects/jdbc-mysql/in Para informao, consulte qualquer documentao JDBC, alm das documentao dos proca ca e ca prietrios de cada driver para recursos espec a icos do MySQL.

12.4 API PHP do MySQL

PHP uma linguagem script do lado do servidor embutida em HTML que pode ser usada e para criar pginas web dinmicas. Ele contm suporte para acesso a diversos banco de dados, a a e incluindo o MySQL. PHP pode ser executado como um programa separado ou compilado como um mdulo para uso com o servidro web Apache. o A distribuio e documentao est dispon no web site PHP (http://www.php.net/). ca ca a ivel

12.4.1 Problemas Comuns com MySQL e PHP

Error: "Maximum Execution Time Exceeded" Este um limite do PHP; v at o are a e quivo php3.ini e dena o tempo mximo de excuo para algo maior que 30 segundos, a ca de acordo com a necessidade. Tambm no uma m idia dobrar a ram permitida e a e a e por script para 16 MB em vez de 8 MB. Error: "Fatal error: Call to unsupported or undened function mysql connect() in .." Isto signica que sua verso do PHP no compilada com suporte ao MySQL. a a e Voc tambm pode compilar um mdulo MySQL dinmico e carreg-lo no PHP ou e e o a a recompilar o PHP com suporte ao MySQL. Isto descrito em detalhes no manual e PHP. Error: "undened reference to uncompress" Isto signica que a biblioteca cliente e compilada com suporte a um protocolo cliente/servidor compactado. A correo ca e adicionar -lz por ultimo ao ligar com -lmysqlclient.

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

881

12.5 API Perl do MySQL

Esta seo documenta a interface Perl DBI. A interface anterior era chamada mysqlperl. ca DBI/DBD a intrface Perl recomendada atual;mente, assim mysqlperl est obsoleta e no e a a ser documentada aqui. a

12.5.1 DBI com DBD::mysql

DBI uma interface genrica para muitos bancos de dados. Isto signica que vocc pode e e e escrever um script que funciona com diferentes mecanismos de banco de dados sem nenhuma mudana. Voc precisa de um DataBase Driver - Driver de Banco de Dados (DBD) denido c e para cada tipo de banco de dados, para o MySQL este driver chamado DBD::mysql. e Para mais informao sobre Perl5 DBI, visite a pagina web do DBI e leia a documentao: ca ca http://dbi.perl.org/ Note que se voc quiser usar transaes com Perl, voc precisa ter o DBD-mysql verso e co e a 1.2216 ou posterior. Recomendamos usar a verso 2.1022 ou mais nova. a Installation instructions for MySQL Perl support are given in Seo 2.7 [Perl support], ca Pgina 164. a Se voc tiver o modulo MySQL instalado, voc pode achar informao sobre as funcionalie e ca dades especicas do MySQL com um dos seguintes comandos: shell> perldoc DBD/mysql shell> perldoc mysql

12.5.2 A interface DBI

Mtodos e Atributos DBI Portteis e a Mtodo/Atributo e Descrio ca connect Estabelece uma conexo ao servidor de banco de a dados. disconnect Disconecta de um servidor de banco de dados. prepare Prepara uma instruo SQL para ser executada. ca execute Executa instrues preparadas. co do Prepara e executa uma instruo SQL. ca quote Coloca valores string ou BLOB entre aspas para serem inseridos. fetchrow_array Busca a prxima linha como um vetor de campos. o fetchrow_arrayref Busca a prxima linha como um vetor referncia de o e campos. fetchrow_hashref Busca a prima linha como uma referncia a uma e tabela hash. fetchall_arrayref Busca todos os dados como um vetor de vetor (matriz). finish Finaliza uma instruo e deixa os recursos do sistema ca livres. rows Retorna o nmero de linhas afetadas. u data_sources Retorna um vetor de banco de dados dispon ives ne localhost.

882

MySQL Technical Reference for Version 5.0.0-alpha

ChopBlanks

Controla de o mtodo fetchrow_* elimina os espaos e c em branco. NUM_OF_PARAMS O nmero de colchetes em uma instruo preparada. u ca NULLABLE Quais colunas podem ser NULL. trace Realiza rastreamento para depurao. ca Mtodos e Atributos especicos do MySQL e Descrio ca O ultimo valor AUTO_INCREMENT. Quais colunas so valores BLOB. a Quais colunas so chaves. a Quais colunas so numricas. a e Quais colunas so chaves primrias. a a Quais colunas NAO PODEM ser NULL. Veja NULLABLE. O tamanho mximo das colunas. a O tamanho mximo das colunas presentes no a resultado. Nomes de colunas. Nmero de campos retornados. u Nome de tabelas no resultado. Todos os tipos de colunas

Mtodo/Atributos e mysql_insertid is_blob is_key is_num is_pri_key is_not_null length max_length NAME NUM_OF_FIELDS table type

Os mtodos Perl so descritos em maiores detalhes nas sees seguintes. Variveis usadas e a co a em mtodos que retornam valor tem estes signicados: e $dbh $sth $rc $rv Manipulador do Banco de Dados Manipulador da Instruo ca Cdigo de Retorno (geralmente um status) o Valor de Retorno (geralmente um contador de linhas)

Mtodos e Atributos DBI Portteis e a connect($data_source, $username, $password) Usa o mtodo connect para fazer uma conexo do banco de dados a fonte de e a dados. O valor $data_source deve comear com DBI:driver_name:. Exemplo c de uso de connect com o driver DBD::mysql: $dbh = DBI->connect("DBI:mysql:$database", $user, $password); $dbh = DBI->connect("DBI:mysql:$database:$hostname", $user, $password); $dbh = DBI->connect("DBI:mysql:$database:$hostname:$port", $user, $password); Se o nome do usurio e/ou senha no so denidos, DBI usa os valores das a a a variveis de anbiente DBI_USER e DBI_PASS, respctivamente. Se voc no esa e a pecicar um nome de mquina, ele utiliza o padro localhost. Se voc no a a e a especicar um nmero de porta, ele utiliza a porta padro do MySQL(3306). u a At o Msql-Mysql-modules Verso 1.2009, o valor $data_source permitia ala a guns modicadores:

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

883

mysql_read_default_file=file_name L file_name como um arquivo de opo. Para informao sobre e ca ca arquivo de opes veja Seo 4.1.2 [Option les], Pgina 216. co ca a mysql_read_default_group=group_name O grupo padro ao se ler uma arquivo de opes , normalamente, a co e o grupo [client]. Especicando a aopo mysql_read_default_ ca group, o grupo padro se torna o grupo [group_name]. a mysql_compression=1 Utiliza comunicao compactada enter o cliente e o servidor ca (MySQL Verso 3.22.3 ou posterior). a mysql_socket=/path/to/socket Especica o caminho do socket Unix que utilizado para se conectar e ao servidor (MySQL Verso 3.21.15 ou posterior). a Mliplos modicadores podem ser dados. Cada um deve ser precedido de ponto u e v irgula. Por exemplo, se voc quiser evitar colocar o nome de usurio e senha em um e a script DBI, voc pode busc-los em um arquivo de opo ~/.my.cnf do usurio e a ca a ao invs de escrever a sua chamada connect desta forma: e $dbh = DBI->connect("DBI:mysql:$database" . ";mysql_read_default_file=$ENV{HOME}/.my.cnf", $user, $password); Esta chamado ir ler opes dinidas pelo grupo [client] no arquivo de opes. a co co Se voc quiser fazer a mesma coisa mas utilizar opes especicadas no grupo e co [perl], voc pode fazer: e $dbh = DBI->connect("DBI:mysql:$database" . ";mysql_read_default_file=$ENV{HOME}/.my.cnf" . ";mysql_read_default_group=perl", $user, $password); disconnect O mtodo disconnect disconecta o manipulador de banco de dados do banco e de dados. Ele normalmente chamado pouco antes de voc sair do programa. e e Exemplo: $rc = $dbh->disconnect; prepare($statement) Prepara uma instruo SQL para execuo pelo mecanismo de banco de dados ca ca e retorna um manipulador de instruo ($sth), que voc pode utilizar para ca e chamar o mtodo execute. e Normalmente voc manipula a instruo SELECT (e instrues do tipo SELECT e ca co tais como SHOW, DESCRIBE, e EXPLAIN) atravs de prepare e execute. Exemplo: e $sth = $dbh->prepare($statement) or die "Cant prepare $statement: $dbh->errstr\n"; Se vo quiser ler grandes resultados em seu cliente, voc pode dizer ao Perl para e e utilizar mysql_use_result() com:

884

MySQL Technical Reference for Version 5.0.0-alpha

my $sth = $dbh->prepare($statement { "mysql_use_result" => 1}); execute O mtodo execute executa um instruo preparada. Para instruo noe ca ca a SELECT, execute retorna o nmero de linha afetadas. Se nenhuma linha foi u afetada, execute retorna "0E0", que o Perl trata como zero mas considera com true. Se um erro ocorrer, execute retorna undef. Para instrues SELECT, co execute apenas inicia a consulta SQL no banco de dados; voc precisa utilizar e um dos mtodos de fetch_* descritos aqui para recuperar dados. Exemplo: e $rv = $sth->execute or die "cant execute the query: " . $sth->errstr;

do($statement) O mtodo do prepara e executa uma instruo SQL e retorna o nmero linhas e ca u afetadas. Se nenhuma lina for afetada, do retorna "0E0", que o Perl trata como zero mas considera como true (verdadeiro). Este mtodo geralmente usado e e por instrues no-SELECT que no podem ser preparadas previamente (devida co a a a limitaes do driver) ou que no precisa ser esecutada mais que uma vez co a (inserts, deletes, etc.). Exemplo: $rv = $dbh->do($statement) or die "Cant execute $statement: $dbh- >errstr\n"; Geralamente a instruo do mais rpida (e prefer ca e a ivel) que prepare/execute para instrues que no contm parmetros. co a e a quote($string) O mtodo quote usada para "escapar" qualquer caracter especial contido na e e string e para adcionar as aspas necessrias na sa a ida. Exemplo: $sql = $dbh->quote($string) fetchrow_array Este mtodo busca a prxima linha de dados e a retorna como um vetor de a o valores de campo. Exemplo: while(@row = $sth->fetchrow_array) { print qw($row[0]\t$row[1]\t$row[2]\n); } fetchrow_arrayref Este mtodo busca a prxima linha de dados e a retorna como uma referncia e o e a um vetor de valores de campos. Exemplo: while($row_ref = $sth->fetchrow_arrayref) { print qw($row_ref->[0]\t$row_ref->[1]\t$row_ref->[2]\n); } fetchrow_hashref Este mtodo busca uma linha de dados e retorna uma referncia a uma tabela e e hash contendo pares nome de campos/valores. Este mtodo no to eciente e a e a quanto utilizar referncias a vetor como demostrado acima. Exemplo: e while($hash_ref = $sth->fetchrow_hashref) { print qw($hash_ref->{firstname}\t$hash_ref->{lastname}\t\ $hash_ref->{title}\n);

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

885

} fetchall_arrayref Este mtodo usado para obter todos os dados (linhas) a serem retornados e e de uma instruo SQL. Ele retorna uma referncia a um vetor de referncias ca e e a vetores para cada linha. Voc acessa ou imprime dados utilizando um loop e aninhado. Exemplo: my $table = $sth->fetchall_arrayref or die "$sth->errstr\n"; my($i, $j); for $i ( 0 .. $#{$table} ) { for $j ( 0 .. $#{$table->[$i]} ) { print "$table->[$i][$j]\t"; } print "\n"; } finish Indica que mais nenhum dado ser buscado para este manipulador de instruo. a ca Voc chama este mtodo para liberar o manipulador de instruo e qualquer e e ca recuros de sistema associado a ele. Exemplo: $rc = $sth->finish; Retorna o nmero de linhas alteradas (atualiadas, deletadas, etc.) pelo ultimo u comando. Ele normalmente utilizado aps uma instruo execute noe o ca a SELECT. Exemplo: $rv = $sth->rows; Retorna uma referncia a um vetor de valores que indicam se colunas podem e conter valores NULL. Os valores poss iveis para cada element do vetor 0 ou e uma string vazia se a coluna no puder ser NULL, 1 se puder e 2 se a o estado a NULL da coluna desconhecido. Exemplo: e $null_possible = $sth->{NULLABLE};

rows

NULLABLE

NUM_OF_FIELDS este atributi indica o nmero de campos retornados pela instruo SELECT ou u ca SHOW FIELDS. Voc pode us-la para vericar se uma instruo retornou um ree a ca sultado: Um valor zero indica uma intruo no-SELECT como INSERT, DELETE, ca a ou UPDATE. Exemplo: $nr_of_fields = $sth->{NUM_OF_FIELDS}; data_sources($driver_name) Este mtodo retorna um vetor contendo o nome dos bancos de dados dispon e iveis no servidor MySQL na mquina localhost. Exemplo: a @dbs = DBI->data_sources("mysql"); ChopBlanks Este atributo determina se o mtodo fetchrow_* ir apagar espaos em branco e a c no inicio ou no m dos valores retornados. Exemplo: $sth->{ChopBlanks} =1;

886

MySQL Technical Reference for Version 5.0.0-alpha

trace($trace_level) trace($trace_level, $trace_filename) O mtodo trace habilita ou disabilita o rastreamento. Quando chamado como e um mtodo da classe DBI, ele afeta o rastreamento em todos os manipuladores. e Quando chamado como um mtodo do manipulador de banco de dados ou e de instruo, ele afeta o rastreamento para o manipulador dado (e qualquer ca lho futuro do manipulador). Denir $trace_level com 2 fornece detalhes da informao do rastreamento. Denir $trace_level com 0 desabilita o rastreaca mento. A sa do rastreamento vai para a sa padro de erros por padro. Se ida ida a a $trace_filename for esecicado, o arquivo aberto no modo append e a sa e ida para todos manipuladores rastreados traced handles escrita neste arquivo. e Exemplo:

DBI->trace(2); # rastreia tudo DBI->trace(2,"/tmp/dbi.out"); # rastreia tudo para # /tmp/dbi.out $dth->trace(2); # rastreia este manipulador de banco de dado $sth->trace(2); # rastreia este manipulador de instru~es co Voc tambm pode habilitar o rastreamento DBI congurando a varivel de e e a ambiente DBI_TRACE. Congur-la com um valor numrico o mesmo que a e e chamar DBI->(value). Congur-la com um caminhao o mesmo que chamar a e DBI->(2,value). Mtodos e Atributos Especicos do MySQL e Os mtodos mostrados aqui so espec e a icso do MySQL e no so parte do padro DBI. a a a Diversos mtodos j esto obsoletos: is_blob, is_key, is_num, is_pri_key, is_not_null, e a a length, max_length, e table. Quando existir uma alternativa no padro DBI, ela ser a a listada aqui: mysql_insertid Se voc utilizar o recurso AUTO_INCREMENT do MySQL, os novos valores autoe increment sero armazenados aqui. Exemplo: a $new_id = $sth->{mysql_insertid}; Com verses antigas da interface DBI, voc pode usar $sth->{insertid}. o e is_blob Retorna uma referncia a um vetor de valores booleanos; para cada elemento e do vetor, um valor TRUE indica que a respectiva coluna um BLOB. Exemplo: e $keys = $sth->{is_blob}; is_key Retorna um referncia a um vetor de valores booleanos; para cada elemento do e vetor, um valor de TRUE indica que a coluna respectiva uma chave. Exemplo: e $keys = $sth->{is_key}; is_num Retorna uma referncia a um vetor de valores booleanos; para cada elemento e do vetor, um valor de TRUE indica que a coluna respectiva contm valores e numricos. Exemplo: e $nums = $sth->{is_num};

Cap tulo 12: Ferramentas de Clientes e APIs do MySQL

887

is_pri_key Retorna uma referncia a um vetor de valores booleanos; para cada elemento do e vetor, um valor de TRUE indica que a respectiva coluna uma chave primria. e a Exemplo: $pri_keys = $sth->{is_pri_key}; is_not_null Retorna uma referncia para um vetor de valores booleanos; para cada elemento e do vetor, um valor de FALSE indica que esta coluna pode conter valores NULL Exemplo: $not_nulls = $sth->{is_not_null}; is_not_null est obsoleto; prefer utilizar o atributo NULLABLE (descrito a e ivel acima), porque ele um padro DBI. e a length max_length Cada um destes mtodos retornam uma refercia a um vetor com tamanho de e e colunas. O vetor length indica a tamanho mximo que cada coluna pode ter a (como declarado na descrio da tabela). O vetor max_length indica o tamanho ca mximo presente atualmente no resultado. Exemplo: a $lengths = $sth->{length}; $max_lengths = $sth->{max_length}; NAME table type Retorna um referncia a um vetor de nomes de colunas. Exemplo: e $names = $sth->{NAME}; Retorna um referncia a um vetor de nomes de tabelas. Exemplo: e $tables = $sth->{table}; Retorna uma referncia a um vetor com tipos de colunas. Exemplo: e $types = $sth->{type};

12.5.3 Mais Informaes DBI/DBD co

Voc pode utilizar o comando perldoc para conseguir mais informao sobre DBI. e ca perldoc DBI perldoc DBI::FAQ perldoc DBD::mysql Vo tambm pode utilizar as ferramentas pod2man, pod2html, etc., para traduzir para outro e e formato. Voc pode encontrar as ultimas informaes sobre DBI na pagina web DBI: e co http://dbi.perl.org/.

12.6 API C++ do MySQL

MySQL Connector/C++ (ou MySQL++) a API ociaL do MySQL para C++. Mais ine formaes podem ser encontradas em http://www.mysql.com/products/mysql++/. co

888

MySQL Technical Reference for Version 5.0.0-alpha

12.6.1 Borland C++

Voc pode compilar o fonte do MySQL Windows com Borland C++ 5.02. (O fonte Windows e s incluem projetos para Microsoft VC++, para Borland C++ voc mesmo tem que fazer os o e arquivos de projetos.) Um problema conhecido copm o Borland C++ que ele usa uam estrutura de alinhamento e diferente do VC++. Isto signica que voc ter problema se voc tentar utilizar as bibliotecas e a e libmysql.dll padres (que foi compilado com VC++) com Borland C++. Voc pode fazer o e o seguinte para ebitar este problema. Voc pode utilizar bibliotecas MySQL estticas para Borland C++ que voc pode ene a e contar em http://www.mysql.com/downloads/os-win32.html. S chame mysql_init() com NULL como um argumento, no uma struct MySQL preo a alocada.

12.7 API Python do MySQL

MySQLdb fornece suporte MySQL para Python, compat com a API Python DB version ivel 2.0. Ela pode ser encontrada em http://sourceforge.net/projects/mysql-python/.

12.8 API Tcl do MySQL

MySQLtcl uma API simples para aceeso ao servidor de banco de dados e MySQL a partir da linguagem de programao Tcl. Ela pode ser encontrada em ca http://www.xdobry.de/mysqltcl/.

12.9 Eiel Wrapper do MySQL

Eiel MySQL uma interface para o servidor de banco de dados MySQL, utilizando a e linguagem de programao Eiel, escrita por Michael Ravits. Ela pode ser encontrada em ca http://efsa.sourceforge.net/archive/ravits/mysql.htm.

Cap tulo 13: Tratamento de Erros no MySQL

889

13 Tratamento de Erros no MySQL

Este cap itulo descreve como o MySQL trata erros.

13.1 Erros Retornados

A seguir esto cdigos de erro que podem aparecer quando voc chama o MySQL de qualquer a o e lingugem da mquina. a As coluna Name e Error Code correspondem a denio no arquivo de cdigo fonte do ca o MySQL: include/mysqld_error.h A coluna SQLSTATE corrsponde a denies no arquivo de cdigo fonte do MySQL: co o include/sql_state.h O cdigo de erro SQLSTATE s aparecer se voc utilizar o MySQL verso 4.1. O cdigo o o a e a o SQLSTATE foi adicionado para compatibilidade com o comportamento de X/Open / ANSI / ODBC. Um texto sugerido para cada cdigo de erro pode ser encontrado no arquivo de mensagem o de erro: share/english/errmsg.sys Como atualizaes so frequentes, poss que a fonte acima contenha cdigos de erros co a e ivel o adicionais. Name ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER HASHCHK NISAMCHK NO YES CANT CREATE FILE CANT CREATE TABLE CANT CREATE DB DB CREATE EXISTS DB DROP EXISTS DB DROP DELETE DB DROP RMDIR CANT DELETE FILE CANT FIND SYSTEM REC CANT GET STAT CANT GET WD CANT LOCK CANT OPEN FILE FILE NOT FOUND CANT READ DIR CANT SET WD CHECKREAD DISK FULL DUP KEY Error Code 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 SQLSTATE HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 23000

890

MySQL Technical Reference for Version 5.0.0-alpha

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

ERROR ON CLOSE ERROR ON READ ERROR ON RENAME ERROR ON WRITE FILE USED FILSORT ABORT FORM NOT FOUND GET ERRNO ILLEGAL HA KEY NOT FOUND NOT FORM FILE NOT KEYFILE OLD KEYFILE OPEN AS READONLY OUTOFMEMORY OUT OF SORTMEMORY UNEXPECTED EOF CON COUNT ERROR OUT OF RESOURCES BAD HOST ERROR HANDSHAKE ERROR DBACCESS DENIED ERROR ACCESS DENIED ERROR NO DB ERROR UNKNOWN COM ERROR BAD NULL ERROR BAD DB ERROR TABLE EXISTS ERROR BAD TABLE ERROR NON UNIQ ERROR SERVER SHUTDOWN BAD FIELD ERROR WRONG FIELD WITH GROUP WRONG GROUP FIELD WRONG SUM SELECT WRONG VALUE COUNT TOO LONG IDENT DUP FIELDNAME DUP KEYNAME DUP ENTRY WRONG FIELD SPEC PARSE ERROR EMPTY QUERY NONUNIQ TABLE INVALID DEFAULT MULTIPLE PRI KEY TOO MANY KEYS

1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069

HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY001 HY001 HY000 08004 08004 08S01 08S01 42000 42000 42000 08S01 23000 42000 42S01 42S02 23000 08S01 42S22 42000 42000 42000 21S01 42000 42S21 42000 23000 42000 42000 42000 42000 42000 42000 42000

Cap tulo 13: Tratamento de Erros no MySQL

891

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

TOO MANY KEY PARTS 1070 TOO LONG KEY 1071 KEY COLUMN DOES NOT EXITS 1072 BLOB USED AS KEY 1073 TOO BIG FIELDLENGTH 1074 WRONG AUTO KEY 1075 READY 1076 NORMAL SHUTDOWN 1077 GOT SIGNAL 1078 SHUTDOWN COMPLETE 1079 FORCING CLOSE 1080 IPSOCK ERROR 1081 NO SUCH INDEX 1082 WRONG FIELD TERMINATORS 1083 BLOBS AND NO TERMINATED 1084 TEXTFILE NOT READABLE 1085 FILE EXISTS ERROR 1086 LOAD INFO 1087 ALTER INFO 1088 WRONG SUB KEY 1089 CANT REMOVE ALL FIELDS 1090 CANT DROP FIELD OR KEY 1091 INSERT INFO 1092 UPDATE TABLE USED 1093 NO SUCH THREAD 1094 KILL DENIED ERROR 1095 NO TABLES USED 1096 TOO BIG SET 1097 NO UNIQUE LOGFILE 1098 TABLE NOT LOCKED FOR WRITE 1099 TABLE NOT LOCKED 1100 BLOB CANT HAVE DEFAULT 1101 WRONG DB NAME 1102 WRONG TABLE NAME 1103 TOO BIG SELECT 1104 UNKNOWN ERROR 1105 UNKNOWN PROCEDURE 1106 WRONG PARAMCOUNT TO PROCEDURE 1107 WRONG PARAMETERS TO PROCEDURE 1108 UNKNOWN TABLE 1109 FIELD SPECIFIED TWICE 1110 INVALID GROUP FUNC USE 1111 UNSUPPORTED EXTENSION 1112 TABLE MUST HAVE COLUMNS 1113 RECORD FILE FULL 1114 UNKNOWN CHARACTER SET 1115 TOO MANY TABLES 1116

42000 42000 42000 42000 42000 42000 00000 00000 00000 00000 08S01 08S01 42S12 42000 42000 HY000 HY000 HY000 HY000 HY000 42000 42000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 42000 42000 42000 42000 HY000 42000 42000 HY000 42S02 42000 42000 42000 42000 HY000 42000 HY000

892

MySQL Technical Reference for Version 5.0.0-alpha

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

TOO MANY FIELDS TOO BIG ROWSIZE STACK OVERRUN WRONG OUTER JOIN NULL COLUMN IN INDEX CANT FIND UDF CANT INITIALIZE UDF UDF NO PATHS UDF EXISTS CANT OPEN LIBRARY CANT FIND DL ENTRY FUNCTION NOT DEFINED HOST IS BLOCKED HOST NOT PRIVILEGED PASSWORD ANONYMOUS USER PASSWORD NOT ALLOWED PASSWORD NO MATCH UPDATE INFO CANT CREATE THREAD WRONG VALUE COUNT ON ROW CANT REOPEN TABLE INVALID USE OF NULL REGEXP ERROR MIX OF GROUP FUNC AND FIELDS NONEXISTING GRANT TABLEACCESS DENIED ERROR COLUMNACCESS DENIED ERROR ILLEGAL GRANT FOR TABLE GRANT WRONG HOST OR USER NO SUCH TABLE NONEXISTING TABLE GRANT NOT ALLOWED COMMAND SYNTAX ERROR DELAYED CANT CHANGE LOCK TOO MANY DELAYED THREADS ABORTING CONNECTION NET PACKET TOO LARGE NET READ ERROR FROM PIPE NET FCNTL ERROR NET PACKETS OUT OF ORDER NET UNCOMPRESS ERROR NET READ ERROR NET READ INTERRUPTED NET ERROR ON WRITE NET WRITE INTERRUPTED TOO LONG STRING TABLE CANT HANDLE BLOB

1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163

HY000 42000 HY000 42000 42000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 42000 42000 42000 HY000 HY000 21S01 HY000 42000 42000 42000 42000 42000 42000 42000 42000 42S02 42000 42000 42000 HY000 HY000 08S01 08S01 08S01 08S01 08S01 08S01 08S01 08S01 08S01 08S01 42000 42000

Cap tulo 13: Tratamento de Erros no MySQL

893

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

TABLE CANT HANDLE AUTO INCREMENT 1164 DELAYED INSERT TABLE LOCKED 1165 WRONG COLUMN NAME 1166 WRONG KEY COLUMN 1167 WRONG MRG TABLE 1168 DUP UNIQUE 1169 BLOB KEY WITHOUT LENGTH 1170 PRIMARY CANT HAVE NULL 1171 TOO MANY ROWS 1172 REQUIRES PRIMARY KEY 1173 NO RAID COMPILED 1174 UPDATE WITHOUT KEY IN SAFE MODE 1175 KEY DOES NOT EXITS 1176 CHECK NO SUCH TABLE 1177 CHECK NOT IMPLEMENTED 1178 CANT DO THIS DURING AN TRANSACTION 1179 ERROR DURING COMMIT 1180 ERROR DURING ROLLBACK 1181 ERROR DURING FLUSH LOGS 1182 ERROR DURING CHECKPOINT 1183 NEW ABORTING CONNECTION 1184 DUMP NOT IMPLEMENTED 1185 FLUSH MASTER BINLOG CLOSED 1186 INDEX REBUILD 1187 MASTER 1188 MASTER NET READ 1189 MASTER NET WRITE 1190 FT MATCHING KEY NOT FOUND 1191 LOCK OR ACTIVE TRANSACTION 1192 UNKNOWN SYSTEM VARIABLE 1193 CRASHED ON USAGE 1194 CRASHED ON REPAIR 1195 WARNING NOT COMPLETE ROLLBACK 1196 TRANS CACHE FULL 1197 SLAVE MUST STOP 1198 SLAVE NOT RUNNING 1199 BAD SLAVE 1200 MASTER INFO 1201 SLAVE THREAD 1202 TOO MANY USER CONNECTIONS 1203 SET CONSTANTS ONLY 1204 LOCK WAIT TIMEOUT 1205 LOCK TABLE FULL 1206 READ ONLY TRANSACTION 1207 DROP DB WITH READ LOCK 1208 CREATE DB WITH READ LOCK 1209 WRONG ARGUMENTS 1210

42000 HY000 42000 42000 HY000 23000 42000 42000 42000 42000 HY000 HY000 HY000 42000 42000 25000 HY000 HY000 HY000 HY000 08S01 HY000 HY000 HY000 HY000 08S01 08S01 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 42000 HY000 HY000 HY000 25000 HY000 HY000 HY000

894

MySQL Technical Reference for Version 5.0.0-alpha

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

NO PERMISSION TO CREATE USER 1211 UNION TABLES IN DIFFERENT DIR 1212 LOCK DEADLOCK 1213 TABLE CANT HANDLE FULLTEXT 1214 CANNOT ADD FOREIGN 1215 NO REFERENCED ROW 1216 ROW IS REFERENCED 1217 CONNECT TO MASTER 1218 QUERY ON MASTER 1219 ERROR WHEN EXECUTING COMMAND 1220 WRONG USAGE 1221 WRONG NUMBER OF COLUMNS IN SELECT 1222 CANT UPDATE WITH READLOCK 1223 MIXING NOT ALLOWED 1224 DUP ARGUMENT 1225 USER LIMIT REACHED 1226 SPECIFIC ACCESS DENIED ERROR 1227 LOCAL VARIABLE 1228 GLOBAL VARIABLE 1229 NO DEFAULT 1230 WRONG VALUE FOR VAR 1231 WRONG TYPE FOR VAR 1232 VAR CANT BE READ 1233 CANT USE OPTION HERE 1234 NOT SUPPORTED YET 1235 MASTER FATAL ERROR READING BINLOG 1236 SLAVE IGNORED TABLE 1237 WRONG FK DEF 1238 KEY REF DO NOT MATCH TABLE REF 1239 CARDINALITY COL 1240 SUBSELECT NO 1 ROW 1241 UNKNOWN STMT HANDLER 1242 CORRUPT HELP DB 1243 CYCLIC REFERENCE 1244 AUTO CONVERT 1245 ILLEGAL REFERENCE 1246 DERIVED MUST HAVE ALIAS 1247 SELECT REDUCED 1248 TABLENAME NOT ALLOWED HERE 1249 NOT SUPPORTED AUTH MODE 1250 SPATIAL CANT HAVE NULL 1251 COLLATION CHARSET MISMATCH 1252 SLAVE WAS RUNNING 1253 SLAVE WAS NOT RUNNING 1254 TOO BIG FOR UNCOMPRESS 1255 ZLIB Z MEM ERROR 1256 ZLIB Z BUF ERROR 1257

42000 HY000 40001 HY000 HY000 23000 23000 08S01 HY000 HY000 HY000 21000 HY000 HY000 HY000 42000 HY000 HY000 HY000 42000 42000 42000 HY000 42000 42000 HY000 HY000 42000 HY000 21000 21000 HY000 HY000 HY000 HY000 42S22 42000 01000 42000 08004 42000 42000 HY000 HY000 HY000 HY000 HY000

Cap tulo 13: Tratamento de Erros no MySQL

895

ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER ER

ZLIB Z DATA ERROR CUT VALUE GROUP CONCAT WARN TOO FEW RECORDS WARN TOO MANY RECORDS WARN NULL TO NOTNULL WARN DATA OUT OF RANGE WARN DATA TRUNCATED WARN USING OTHER HANDLER CANT AGGREGATE COLLATIONS DROP USER REVOKE GRANTS CANT AGGREGATE 3COLLATIONS CANT AGGREGATE NCOLLATIONS VARIABLE IS NOT STRUCT UNKNOWN COLLATION SLAVE IGNORED SSL PARAMS SERVER IS IN SECURE AUTH MODE WARN FIELD RESOLVED BAD SLAVE UNTIL COND MISSING SKIP SLAVE UNTIL COND IGNORED

1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278

HY000 HY000 01000 01000 01000 01000 01000 01000 42000 42000 42000 42000 42000 HY000 HY000 HY000 HY000 HY000 HY000 HY000 HY000

896

MySQL Technical Reference for Version 5.0.0-alpha

14 Estendendo o MySQL
14.1 MySQL Internals
Este cap itulo descreve vrias coisas que voc precisa saber ao trabalhar no cdigo do a e o MySQL. Se voc planeja contribuir com o desenvolvimento do MySQL, quiser ter acesso ao e cdigo entre verses, ou apenas deseja acompanhar o desenvolvimento, siga as instrues o o co em Seo 2.3.4 [Instalando a rvore de fontes], Pgina 100. Se voc est interessada nos ca a a e a MySQL internals, voc tambm deve se inscrever na nossa lista de emails internals. Esta e e lista relativamente de baixo trco. Para detalhes de como se inscrever, por favor veja e a Seo 1.7.1.1 [Mailing-list], Pgina 33. Todos os desenvolvedores na MySQL AB esto na ca a a lista internals e ns ajudamos outras pessoal que esto trabalhando no cdigo MySQL. o a o Esteja a vontade de utilizar esta tanto para perguntas sobre o cdigo qunato para enviar o patches com os auqis voc gostaria de contribui no projeto MySQL! e

14.1.1 Threads MySQL

O servidor MySQL cria as seguintes threads: A thread da conexo TCP/IP trata todas as requisies de conexo e cria uma nova a co a thread dedicada para tratar a autenticao e consulta SQL processada por cada ca conexo. a No Windows NT existe um thread que trata named pipe que fazem o mesmo trabalho que as threads da conexo TCP/IP em pedidos de conexo de named pipe. a a A thread de sinal trata todos os sinais. Esta thread tambm trata normalmente de e alarmes e chamadas process_alarm() para forar um tempo limite em conexes que c o tm estado parados por um tempo grande. e Se o mysqld compilado com -DUSE_ALARM_THREAD, uma thread dedicada que trata e dos alarmes criada. Ela s utilizadas em alguns sistemas onde h problemas com e oe a sigwait() ou se deseja utilizar o cdigo thr_alarm() em aplicaes sem uma thread o co dedicada para tratar sianis. Se utilizada a opo --flush_time=#, uma thread dedicada criada para descarregar e ca e todas as tabelas em um dado intervalo. Cada conexo tem a sua prpria thread. a o Cada tabela diferente na qual utilizada INSERT DELAYED tem sua prpria thread. e o Se voc quiser utilizar --master-host, uma thread de replicao slave ser iniciada e ca a para ler e aplicar atualizaes do master. co mysqladmin processlist mostra apenas a thread da conexo, do INSERT DELAYED, e da a replicao. ca

14.1.2 Pacotes de Teste do MySQL

At pouco tempo, o nosso principal pacote de teste com cobertura total era baseado em e dados proprietrios de clientes e por esta razo no era dispon publicamente. A unica a a a ivel

Cap tulo 14: Estendendo o MySQL

897

parte dispon ivel publicamente de nosso processo de teste consistia de um teste crashme, um benchamrk Perl DBI/DBD encontrado no diretrio sql-bench e testes variadaos o localizadaos no diretrio tests. A falta de um um pacote de teste padronizado dispon o ivel publicamente tem criado diculdade para nosso usurios e para nossos desenvolvedores de a fazer teste de regresso no cdigo do MySQL. Para resolver este problema, ns criamos a o o um novo sistema de teste que inclu nas distribuies fonte e binria do Unix a partir e ido co a da verso 3.23.29. Os testes podem ser executados no Unix ou no Windows usando um a ambiente Cygwin. Eles no podem ser executados em um ambiente Windows nativo. a O conjunto de testes de atual no testa tudo no MySQL, mas deve pegar os bugs mais bvios a o no cdigo de processamento SQL, detalhes de SO/biblioteca, e bem compleo em teste de o e replicaes. Nosso objetivo eventual ter os testes cobrindo 100% do cdigo. Contibuies co e o co para o nosso pacote de teste so benvindas. Voc pode desejar contribuir com testes que a e examinam a funcionalidade critica ao seu sistema, o que ir assegurar que todas as futuras a verses do MySQL iro funcionar bem com suas aplicaes. o a co

14.1.2.1 Executando o Pacote de Testes do MySQL

O sistema de teste consiste de um interpretador de linguagem de teste (mysqltest), um script shell para executar todos os testes (mysql-test-run), os casos de teste atual escritos em uma linguagem de teste especial e seus resultados esperados. Para executar o pacote de teste em seu sistema depois de uma construo, digite make test ou mysql-test/mysqlca test-run da raiz do fonte. Se voc tiver uma distribuio binria instalada, digite cd para e ca a de instalao. (ex. /usr/local/mysql), e faa scripts/mysql-test-run. Todos os a raiz ca c testes devem dar certo. Se no, voc deve tentar encontrar o porque e relatar o problema a e se este um bug n MySQL. Veja Seo 14.1.2.3 [Relatando bugs no mysqltest], Pgina 898. e ca a Se voc tiver uma cpia de mysqld executando n mquina onde voc deseja executar o e o a a e teste, voc no tem de par-lo, desde que no esteja usando as portas 9306 e 9307. Se e a a a uma destas portas forem tomadas, voc deve editar mysql-test-run e alterar os valores da e porta do master e/ou slave para uma dispon ivel. Voc pode executar um cado de teste individual com mysql-test/mysql-test-run test_ e name. Se um teste falhar, voc de testar executando mysql-test-run com a opo --force para e ca vericar se nenhum outro teste falhou.

14.1.2.2 Extendendo o Pacote de Teste do MySQL

Voc pode utilizar a linguagem mysqltest para escrever o seu prprio caso de teste. Infelize o mente ns ainda no escrevemos a documentao completa para ela. Voc pode, no entanto, o a ca e olhar os nosso casos de teste atuais e us-los como um exemplo. O seguintes pontos devem a ajud-lo a comear: a c Os teste esto localizados em mysql-test/t/*.test a Um caso de teste consiste de instrues terminadas em ; e similar a entrada do cliente co e de linha de comando mysql. Uma instruo por padro uma consulta a ser enviada ca a e ao servidor MySQL, a menos que ele seja reconhecido como um comando insterno (ex. sleep).

898

MySQL Technical Reference for Version 5.0.0-alpha

Todas as consultas que produzem resultadosex., SELECT, SHOW, EXPLAIN, etc., devem ser precedidas com @/path/to/result/file. O arquivo deve conter os resultados esperados. Um modo fcil de gerar o arquivo resultante executar mysqltest -r < a e t/test-case-name.test do diretrio mysql-test, e ento editar o arquivo resultante o a gerado e, se necessrio, ajust-los a sa esperada. Neste caso, tenha cuidado de no a a ida a adicionar ou deletar quaisquer caracteres invis iveis - tenha certeza de apenas alterar o texto e/ou adicionar linhas deletadas. Se voc tiver que inserir uma linha, esteja certo e que os campos so separados com tabulao e que h uma tabulao no nal. Voc a ca a ca e pode querer utilizar od -c para ter certeza que seu editor de texto no bagunu nada a co durante a edio. Ns, claro, esperamos que voc nunca tenha que editar a sa de ca o e e ida mysqltest -r j que voc s dever faz-lo quando encontra um bug. a e o a e Para estar consistente com a nossa congurao, voc deve colocar seus arquivos ca e de resultados no diretrio mysql-test/r e o nomeie como test_name.result. Se o o teste produzir mais de um resultado, voc deve usar test_name.a.result, test_ e name.b.result, etc. Se uma instruo retornar um erro, voc eve espacicar na linha anterior a instruo ca e ca com --error error-number. O nmero do erro pode ser uma lista de nmeros de erros u u poss iveis separados com ,. Se voc estiver escrevendo em teste de replicao, voc deve coloca source e ca e include/master-slave.inc; na primeira linha do arquivo. Para trocar entre master e slave, utilize connection master; e connection slave;. se voc precisar fazer e alguma coisa em uma conexo alternativa, voc pode fazer connection master1; a e para o master e connection slave1; para o slave. Se voc precisar fazer alguma coisa em um loop, voc pode usar algo assim: e e let $1=1000; while ($1) { # do your queries here dec $1; } Para dormir entre consultas, use o comando sleep. Ele suporta fraes de um seco gundo, assim voc pode fazer sleep 1.3;, por exemplo, para dormir 1.3 segundos. e Para executar o slave com opes adicionais para o seu caso de teste, coloque-os na co formato de linha de comando mysql-test/t/test_name-slave.opt. Para o master, coloque-os em mysql-test/t/test_name-master.opt. Se voc tiver uma questo sobre o pacote de testes, ou tiver um caso de teste para e a contribuir, envie um e-mail para lista de email internals do MySQL. Veja Seo 1.7.1.1 ca [Mailing-list], Pgina 33. Como a lista no aceita anexos, voc deve utilizar o ftp para a a e enviar os arquivos relevantes: ftp://support.mysql.com/pub/mysql/Incoming/

14.1.2.3 Relatando Bugs no Pacote de Teste do MySQL

Se a sua verso no passar no pacote de teste voc deve fazer o seguinte: a a e No envie um relatrio de bug antes de ter feito tudo poss a o ivel para encontrar o que esta errado! Quando o zer, por favor, utilize o script mysqlbug assim podemoster

Cap tulo 14: Estendendo o MySQL

899

informaes sobre o seu sistema e a verso do MySQL. Veja Seo 1.7.1.3 [Relato de co a ca Erros], Pgina 36. a Esteja certo de inluir a sa de mysql-test-run, assim como o contedoi de todos os ida u arquivos .reject no diretrio mysql-test/r. o Se um pacote de teste falhar, verique se o teste tambm falha quando executado e sozinho: cd mysql-test mysql-test-run --local test-name Se falhar, voc deve congurar o MySQL com --with-debug e executar mysql-teste run com a opo --debug. Se into tambm falhar envie o arquivo de rastreamento ca e var/tmp/master.trace para ftp://support.mysql.com/pub/mysql/secret assim ns o podemos examin-los. Por favor, se lembre de tambm incluir uma descrio completa a e ca do seu sistema, a verso do binrio do mysqld e como voc o compilou. a a e Tente tambm executar mysql-test-run com a opo --force para ver se h qualquer e ca a outro teste que tenha falhado. Se voc prprio compilou o MySQL, verique nosso manual sobre como compilar o e o MySQL na sua platforma ou, de preferncia, use um dos binrios que ns compilamos e a o para voc no http://www.mysql.com/downloads/. Todos os seus binrios padres e a o devem passar no pacote de teste! Se voc obter um erro, como Result length mismatch ou Result content mismatch, e signica que a sa do teste no igual a sa esperada. Este pode ser um bug no ida a e ida MySQL ou que o seu verso do mysqld produz resultados um pouco diferentes sobre a certas circuntncias. a Resultado de testes que falharam so colocados em um arquivo com o mesmo nome a base que o arquivo de resultado com a extenso .reject. Se o seu caso de teste est a a falhando, voc deve fazer um di nos dois arquivos. Se voc no puder ver como els e e a so diferentes, examine ambos com od -c e tamb verique os seus tamanhos. a e Se um teste falhar totalmente, voc deve vericar os arquivos de log no diretrio mysqle o test/var/log para avisos sobre o que deu errado. Se voc tiver compilado o MySQL com depurao voc pode tentar depur-lo execue ca e a tando mysql-test-run com a opes --gdb e/ou --debug. Veja Seo E.1.2 [Criando co ca arquivos de rastreamento], Pgina 1080. a Se voc no tiver compilado o MySQL com depurao voc deve, provavelmente, faz-lo. e a ca e e Apenas especique a opo --with-debug no configure! Veja Seo 2.3 [Instalando ca ca o Fonte], Pgina 94. a

14.2 Adicionando Novas Funoes ao MySQL c

Existem dois modos de se adicionar novas funes ao MySQL: co Voc pode adicionar novas funes atravs da interface de funes denidas por usurios e co e co a - user-denable function (UDF). Funes denidas por usurios so adicionadas e reco a a movidas dinamicamente usando as instrues CREATE FUNCTION e DROP FUNCTION. Veja co Seo 14.2.1 [CREATE FUNCTION], Pgina 900. ca a

900

MySQL Technical Reference for Version 5.0.0-alpha

Voc pode adicionar as funes como uma funo nativa do MySQL. Funes nativas e co ca co so compiladas no servidor mysqld e cam dispon a iveis em uma base permanente. Cada mtodo tem suas vantagens e desvantagens: e Se voc escreve uma funo denida pelo usurio, voc deve instalar o arquivo objeto e ca a e no seu servidor. Se voc compilou a sua funao dentro do servidor voc no precisar e c e a a fazer isto. Voc pode adicionar UDFs para um distribuio binria MySQL. Funes nativas exe ca a co igem que voc modique a sua distribuio fonte. e ca Se voc atualizar a sua ditribuio MySQL, voc pode continuar a usar a sua UDF e ca e previamente instalada. Para funes nativas, voc deve repetir as suas modicaes a co e co cada vez que voc atualizar. e Seja qual for o mtodo que voc utilizou para adicionar novas funes, eles podem ser usados e e co como funes nativas tais como ABS() ou SOUNDEX(). co

14.2.1 Sintaxe CREATE FUNCTION/DROP FUNCTION

CREATE [AGGREGATE] FUNCTION nome_fun~o RETURNS {STRING|REAL|INTEGER} ca SONAME nome_bibliot_compartilhada DROP FUNCTION function_name Uma funo denida pelo usurio (user-denable function - UDF) um modo de extender ca a e o MySQL com uma nova funo que funciona como funes nativas do MySQL tais como ca co ABS() e CONCAT(). AGGREGATE uma nova opo do MySQL Verso 3.23. Uma funo AGGREGATE funciona e ca a ca exatamente como uma funo GROUP nativa do MySQL como SUM ou COUNT(). ca CREATE FUNCTION salva o nome e o tipo da funo e o nome da biblioteca compartilhada ca na tabela do sistema mysql.func. Voc deve ter privilgios INSERT e DELETE no banco de e e dados mysql para criar e deletar funes. co Todas as funes ativas so recarregadas a cada vez que o servidor reiniciado, a menos co a e que voc reinicie o mysqld com a opo --skip-grant-tables. Neste caso, a inicializao e ca ca de UDF ignorada e as UDFs esto indispon e a iveis. (Uma funo ativa aquela que foi ca e carregada com CREATE FUNCTION e no foi removida com DROP FUNCTION.) a Para instrues sobre como escrever funes denidas por usurios, veja Seo 14.2 [Adding co co a ca functions], Pgina 899. Para o mecanisnmo UDF funcionar, as funes dever ser escritas a co em C ou C++, seu sistema operacional deve suporta carregamento dinmico e voc deve a e compilar o mysqld dinamicamente (e no estaticamente). a Note que para fazer AGGREGATE funcioanr, voc deve ter uma tabela mysql.func que contm e e a coluna type. Se voc no tem esta tabela, voc deve executar o script mysql_fix_ e a e privilege_tables para cri-la. a

14.2.2 Adicionando Novas Funoes Denidas Por Usurio c a

Para o mecanismo UDF funcionar, as funes devem estar em C ou C++ e o seu sistema co operacional deve suporta carregamento dinmico. A distribuio fonte do MySQL inclui um a ca

Cap tulo 14: Estendendo o MySQL

901

arquivo sql/udf_example.cc que denem 5 novas funes. Consulte este arquivo para co ver como a conveno de chamadas UDF funciona. ca Para o mysqld estar apto a usar funes UDF, voc deve congurar o MySQL com --withco e mysqld-ldflags=-rdynamic. A razo que para muitas plataformas (incluindo Linux) a e voc pode carregar uma biblioteca (com dlopen()) de um programa ligado estaticamente, e que voc teria se estivesse usando --with-mysqld-ldflags=-all-static. Se voc quiser e e usar uma UDF que precisa acessar s imbolos do mysqld (como o exemplo metaphone em sql/udf_example.cc que usa default_charset_info), voc deve ligar o programa com e -rdynamic (veja man dlopen). Se voc estiver usando uma verso precompilada do servidor, use o MySQL-Max, que sue a porta carregamento dinmico. a Para cada funo que voc deseja usar nas instrues SQL, voc deve denir funes C ca e co e co (ou C++) correspondente. Na discusso abaixo, o nome xxx usado um nome de funo a e ca exemplo. Para distinguir entre o uso de SQL e C/C++, XXX() (maiscula) indica a chamada u da funo SQL e xxx() (minscula) indica da chamada da funo C/C++. ca u ca Aa funes C/C++ que voc escreve para implemmentar a interface para XXX() so: co e a xxx() (exigido) A funo principal. E onde o resultado da funo computado. A correca ca e spondncia entre o tipo SQL e o tipo retornado da sua funo C/C++ mostrada e ca e aqui: Tipo SQL Tipo C/C++ STRING char * INTEGER long long REAL double xxx_init() (opcional) A funo de inicializao para xxx(). Ela pode ser usada para: ca ca Verica o nmero de argumentos para XXX(). u Verica se os argumentos so de um tipo exigido ou, alternativamente, diga a ao MySQL para converter os argumentos para o tipo desejado quando a funo principal chamada. ca e Aloca a memria exigida pela funo principal. o ca Especica o tamanho mximo do resultado. a Especica (para funes REAL) o nmero mximo de decimais. co u a Especica se o resultado pode ser NULL. xxx_deinit() (opicional) A funo de nalizao para xxx(). Ela deve liberar qualquer memria alocada ca ca o pela funo de inicializao. ca ca Quando uma instruo SQL invoka XXX(), o MySQL chama a funo de inicializao xxx_ ca ca ca init() para realizar qualquer congurao necessria, tais como vericao de argumentos ca a ca e alocao de memria. Se xxx_init() retorna um erro, a instruo SQL abortada com ca o ca e uma mensagem e as funes principais e de nalizao no so chamadas. Seno, a funo co ca a a a ca principal xxx() chamada uma vez para cada linha. Depois de todas as linhas tiverem e

902

MySQL Technical Reference for Version 5.0.0-alpha

sido processadas, a funo de nalizao xxx_deinit() chamada, podendo assim realizar ca ca e qualquer limpeza. Para funes agregadas (como SUM()), voc tambm deve fornecer as seguintes funes: co e e co xxx_reset() (exigida) Zera a soma e insere um argumento como o valor inicial para um novo grupo. xxx_add() (exigida) Adiciona o argumento a soma antiga. Quando se usa UDFs agregadas o MySQL funciona da seguinte maneira: 1. Chama xxx_init() para deixar funes agregadas alocarem a memria necessria para co o a armazenar os resultados. 2. Ordena a tabela de acordo com a expresso GROUP BY. a 3. Para a primeira linha em um novo grupo, chama a funo xxx_reset(). ca 4. Para cada nova linha que pertence ao mesmo grupo, chame a funo xxx_add(). ca 5. Quando o grupo muda ou depois da ultima linha ter sido processada, chame xxx() para obter o resultado para o conjunto. 6. Repita 3-5 at que todas as linhas tenham sido processada. e 7. Chame xxx_deinit() para deixar a UDF liberar a memria alocada. o Todas as funes devem ser seguras com thread (no apenas a funo principal, mas tambm co a ca e as funes de inicializao e nalizao). Isto signica que voc no tem permisso para co ca ca e a a alocar qualquer varivel global ou esttica que alterou! Se voc precisa de memria, voc a a e o e deve aloc-la em xxx_init() e liber-la em xxx_deinit(). a a

14.2.2.1 Sequncia de Chamadas UDF para Funoes Simples e c

A funo principal deve ser declarada como mostrado aqui. Note que o tipo retornado e ca os parmetros diferem, dependendo se voc ir declarar a funo SQL XXX() para retornar a e a ca STRING, INTEGER, ou REAL na instruo CREATE FUNCTION: ca Para funes STRING: co char *xxx(UDF_INIT *initid, UDF_ARGS *args, char *result, unsigned long *length, char *is_null, char *error); Para funes INTEGER: co long long xxx(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error); Para funes REAL: co double xxx(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error); As funes de inicializao e nalizao so declaradas desta forma: co ca ca a my_bool xxx_init(UDF_INIT *initid, UDF_ARGS *args, char *message); void xxx_deinit(UDF_INIT *initid);

Cap tulo 14: Estendendo o MySQL

903

O parmetro initid passado para todas as trs funes. Ela aponta para uma estrutura a e e co UDF_INIT que usada para passar informaes entre as funes. Os membros da estrutura e co co UDF_INIT so listados abaixo. A funo de inicializao deve estar em todos os menbros a ca ca que desejam ser alterados. (Para utilizar o padro para um membro, deixe-o inalterado.): a my_bool maybe_null xxx_init() deve denir maybe_null com 1 se xxx() pode retornar NULL. O valor padro 1 se qualquer um dos argumentos so declarados como maybe_ a e a null. unsigned int decimals Nmero de decimais. O valor padro o nmero mximo de deciamis no u a e u a argumento passado na funo principal. (Por exemplo, se a funo passada ca ca e function is passed 1.34, 1.345 e 1.3, o padro seria 3, pois 1.345 tem 3 a decimais. unsigned int max_length O tamanho mximo de um resultado string. O valor padro difere dependendo a a do tipo de resultado da funo. Para funes strings, o padro o temanho ca co a e do maior argumento. Para funes do tipo inteiro, o padro 21 digitos. Para co a e funes do tipo real, o padro 13 mais o nmero de decimais indicados por co a e u initid->decimals. (Para funes numricas, o tamanho inclui qualquer carco e acter de sinal ou ponto decimal.) Se voc quiser retornar um blon, voc pode den com 65K ou 16M; esta e e i-lo memria no alocada, mas usada para decidir qual tipo de coluna utilizar se o a e houver necessidade dese armazenar dados temporrios. a char *ptr Um ponteiro que a funo pode usar para o seus propsitos. Por exemplo, ca o funes pode usar initid->ptr para comunicar memrias alocadas entre co o funes. Na xxx_init(), aloca a memria e a atribui a este ponteiro: co o initid->ptr = allocated_memory; Em xxx() e xxx_deinit(), se rera a initid->ptr para usar ou liberar a memria. o

14.2.2.2 Sequncia de Chamadas UDF para Funoes Agregadas e c

Aqui segue uma descrio das diferentes funes que voc precisa denir quando voc quer ca co e e criar uma funo UDF agregada. ca e Note que a seguinte funo NAO necessria ou usada pelo MySQL 4.1.1. Voc ainda pode ca a e manter a denio de sua funo se voc quiser o seu cdigo funcinonando com o MySQL ca ca e o 4.0 e MySQL 4.1.1 char *xxx_reset(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error); Esta funo chamada quando o MySQL encontra a primiera linha em um novo grupo. Na ca e funo voc deve zerar quaisquer variveis sumrias internas e ento denir o argumento ca e a a a dados como o primeiro argumento no grupo. Em muitos casos isto implementado internamente zerando todas as variveis (por exemplo, e a chamando xxx_clear() e ento chamando xxx_add(). a

904

MySQL Technical Reference for Version 5.0.0-alpha

A seguinte funo s exigida pelo MySQL 4.1.1 e acima: ca o e char *xxx_clear(UDF_INIT *initid, char *is_null, char *error); Esta funo chamada quando o MySQL precisa de zerar o resumo dos resultados. Ele ca e ser chamado no comeo de cada grupo novo mas tambm pode ser chamado para zerar os a c e valores para uma consulta que no tiver registros coincidentes. is_null ser denido para a a apontar para CHAR(0) antes de chamar xxx_clear(). Voc pode usar o ponteiro error para armazenar um byte se alguma coisa der errado. e char *xxx_add(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error); Esta funo chamada por todas as linhas que pertencem ao mesmo grupo, exceto na ca e primeira linha. Nesta voc deve adicionar o valor em UDF ARGS a sua variavel sumria e a interna. A funo xxx() deve ser declarada da mesma forma que voc dene uam funo UDF ca e ca simples. Veja Seo 14.2.2.1 [Chamando UDF], Pgina 902. ca a A funo chamada quando todas as linhas no grupo tem sido processada. Normamente ca e voc nunca deve acessar a varivel args aqui mas retornar o seu valor baseado em sua e a varivel sumria interna. a a Todos os argumentos processados em xxx_reset() e xxx_add() devem ser feito de forma idntica as UDFs normais. Veja Seo 14.2.2.3 [Argumentos UDF], Pgina 904. e ca a O tratamento do valor de retorno em xxx() deve ser feito de forma idntica a uma UDF e normal. Veja Seo 14.2.2.4 [Valores de retorno UDF], Pgina 906. ca a O argumento ponteiro para is_null e error o mesmo para todas as chamadas xxx_ e reset(), xxx_clear(), xxx_add() e xxx(). Voc pode utilizar isto para lembrar que voc e e obteve um erro ou se a funo xxx() deve retornar NULL. Note que voc no deve armazenar ca e a uma string em *error! Ela um parmetro de apenas 1 byte! e a is_null zerado para cada grupo (antes de chamar xxx_clear()). error nunca zerado. e e Se isnull ou error so denidos depois de xxx() ento o MySQL retornar NULL como o a a a rsultado para a funo do grupo. ca

14.2.2.3 Processando Argumentos

O parmetro args aponta para uma estrutura UDF_ARGS que tem os mambros listados a abaixo: unsigned int arg_count O nmero de argumentos. Verique o valor na funo de inicializao se voc u ca ca e quiser que ssua funo seja chamada com um nmero espec ca u ico de argumentos. For exemplo: if (args->arg_count != 2) { strcpy(message,"XXX() requires two arguments"); return 1; }

Cap tulo 14: Estendendo o MySQL

905

enum Item_result *arg_type Os tipos para cada argumento. Os valores de tipos poss iveis so STRING_ a RESULT, INT_RESULT, e REAL_RESULT. Para ter certeza que os argumentos so de um tipo dado e retornar um erro se a no forem, verique o vetor arg_type na funo de inicializao. Por exemplo: a ca ca if (args->arg_type[0] != STRING_RESULT || args->arg_type[1] != INT_RESULT) { strcpy(message,"XXX() requires a string and an integer"); return 1; } Como uma alternativa para exigir que os argumentos de sua funo sejam de um ca tipo espec ico, voc pode usar a funao de inicializao para denir o elemento e c ca arg_type com o tipo que voc quiser. Isto faz com que o MySQL converta e argumentos para aqueles tipo a cada chamada de xxx(). Por exemplo, para fazer converso dos dois primeiros argumentos para string e integer, faa isto a c com xxx_init(): args->arg_type[0] = STRING_RESULT; args->arg_type[1] = INT_RESULT; char **args args->args informa a funo de inicializao sobre a natureza geral dos arca ca gumentos chamados com sua funo. Para um argumento constante i, argsca >args[i] aponta para o valor do argumento. (Veja abaixo sobre instrues co de como acessar o valor de forma apropriada). Para um argumento no cona stante, args->args[i] 0. Um argumento constante uma expresso uma e e a e expresso que utiliza apenas constante, tais como 3 ou 4*7-2 ou SIN(3.14). a Um argumento no constante uma expresso que refere a valores que podem a e a alterar a cada linha, tais como nomes de coluna ou funes que so chamadas co a com argumentos no contantes. a Para cada chamada da funo principal, args->args contm os argumentos ca e atuais que so passados pela linhas sendo processadas atualmente. a As funes podem se referir a um argumento i como a seguir: co Um argumento do tipo STRING_RESULT dado como um apontador e string mais um tamanho, para permitir o tratamento de dados binrios a de tamanho arbitrrio. Os contedo da string esto dispon a u a iveis como args->args[i] e o tamanho da string args->lengths[i]. Voc no e e a deve assumir aue as strings so terminadas em null. a Para um argumnto do tipo INT_RESULT, voc deve converter e args->args[i] para um valor long long: long long int_val; int_val = *((long long*) args->args[i]); Para um argumento do tipo REAL_RESULT, voc deve converter argse >args[i] para um valor double: double real_val;

906

MySQL Technical Reference for Version 5.0.0-alpha

real_val = *((double*) args->args[i]); unsigned long *lengths Para a funo de inicializao, o vetor lengths indica o tamanho mximo da ca ca a string para cada argumento. Voc no deve alter-los. Para cada chamada da e a a funo principal, lengths contm o tamanho atual de quaisquer argumentos ca e string que so passados para a linha sendo processada atualmente. Para argua mentos do tipo INT_RESULT ou REAL_RESULT, lengths ainda contm o tamanho e mximo do argumento (como para a funo de inicializao). a ca ca

14.2.2.4 Valor de Retorno e Tartamento de Erros

A funo de inicializao deve retornar 0 se nenhum erro ocorrer e 1 em outro caso. Se ca ca ocorrer um erro, xxx_init() deve armazenar uma mensagem de erro terminada em null no parmetro message. A mensagem ser retornada ao cliente. O buer de mensagens tem a a MYSQL_ERRMSG_SIZE caracteres, mas voc deve tentar manter a mensagem com menos que e 80 caracteres assim ela cabe na tela de terminal padro. a O valor de retorno de uma funo principal xxx() o valor da funo, para funes long ca e ca co long e double. Uma funo string deve retornar um ponteiro ao resultado e armazenar o ca tamanho da string no argumento length. Den-os ao contedo e tamanho do valor de retorno. Por exemplo: a u memcpy(result, "result string", 13); *length = 13; O buer result que passado para o clculo da funo de 255 bytes. Se o seu resultado e a ca e couber nele, voc no ter que se preocupar com alocao de memria para os resultados. e a a ca o Se a sua funo string precisar retornar uma string maior que 255 bytes, voc deve alocar o ca e espao para ela com malloc() em sua funo xxx_init() ou sua funo xxx() e liber-la c ca ca a em sua funo xxx_deinit(). Voc pode armazenar a memria alocada na posio ptr na ca e o ca estrutura UDF_INIT para ser reutilizado por chamadas xxx() futuras. Veja Seo 14.2.2.1 ca [Chamadno UDF], Pgina 902. a Para indicar um valor de retorno de NULL na funo principal, dena is_null com 1: ca *is_null = 1; Para indicar um erro retornado na funo principal, atribua 1 ao parmetro error: ca a *error = 1; Se xxx() denir *error com 1 para qualquer linha, o valor da funo NULL para a linha ca e atual e qualquer linha subsequente processada pela instruo na qual XXX() foi chamado. ca (xxx() nem mesmo ser chamado para linhas subsequentes.) Nota: na verso do MySQL a a anterior a 3.22.10, voc deve congurar *error e *is_null: e *error = 1; *is_null = 1;

14.2.2.5 Compilando e Instalando Funoes Denidas Por Usurio c a

Arquivos implementando UDFs devem ser compilados e instalados na mquina onde o a servidor est sendo executado. Este processo descrito abaixo pelo arquivo UDF exemplo a e

Cap tulo 14: Estendendo o MySQL

907

udf_example.cc que inclu na distribuio fonte do MySQL. Este arquivo contm as e ido ca e seguintes funes: co metaphon() retorna uma string metafonica do argumento string. Ela algo como uma e string soundex, mas mais voltada para o ingls. e e myfunc_double() retorna a soma de valores ASCII de caracteres e seus argumentos, dividido pela soma de tamanho de seus argumentos. myfunc_int() retorna a soma do tamanho de seus argumentos. sequence([const int]) retorna uma sequncia iniciando a partir de um nmero dado e u ou 1 se nenhum nmero for fornecido. u lookup() retorna o IP de um nome de mquina. a reverse_lookup() retorna o nome de mauina para um nmero IP. A funo pode ser u ca chamada com uma string "xxx.xxx.xxx.xxx" ou quatro nmeros. u A arquivo carregvel dinamicamente deve ser compilado como um arquivo objeto compara tilhvel usando um comando como este: a shell> gcc -shared -o udf_example.so myfunc.cc Voc pode encontrar facilmente as opes de compilador corretas para seu sistema execue co tando este comando no diretrio sql da sua rvore de fonte MySQL: o a shell> make udf_example.o Voc deve executar comando de compilador similar `quele que o make mostra, exceto que e a voc deve remover a opo -c prxima ao m da linha e adicionar -o udf_example.so. e ca o (Em alguns sistemas voc pode precisar deixar o comando -c.) e Uma vez que voc tenha compilado um objeto compartilhado contendo UDFs, voc e e deve instal-lo e avisar o MySQL sobre ele. Compilar um objeto compartilhado de a udf_example.cc produz um arquivo com nome parecido com udf_example.so (o nome exato pode variar de plataforma para plataforma). Copie este arquivo para algum diretrio o procurado com o ligador dinmico ld, tal como /usr/lib ou adicione o diretrio no a o qual voc colocou o objeto compartilhado ao arquivo de congurao do ligador (e.g. e ca /etc/ld.so.conf). Em muitos sistemas voc pode as variveis de ambiente LD_LIBRARY ou LD_LIBRARY_PATH e a para apontar para o diretrio onde se encontra os seus arquivos de funes UDF. A pgina o co a dlopen do manual diz a voc quais variveis voc deve utilizar em seu sistema. Voc e a e e deve congurar isto nos scripts de inicializao mysql.server ou mysqld_safe e reiniciar ca o mysqld. Depois da biblioteca ser instalada, notique mysqld sobre as novas funes com estes coco mandos: mysql> CREATE FUNCTION metaphon RETURNS STRING SONAME "udf_example.so"; mysql> CREATE FUNCTION myfunc_double RETURNS REAL SONAME "udf_example.so"; mysql> CREATE FUNCTION myfunc_int RETURNS INTEGER SONAME "udf_example.so"; mysql> CREATE FUNCTION lookup RETURNS STRING SONAME "udf_example.so"; mysql> CREATE FUNCTION reverse_lookup -> RETURNS STRING SONAME "udf_example.so"; mysql> CREATE AGGREGATE FUNCTION avgcost -> RETURNS REAL SONAME "udf_example.so"; Funes podem ser deletadas utilizando-se DROP FUNCTION: co

908

MySQL Technical Reference for Version 5.0.0-alpha

mysql> mysql> mysql> mysql> mysql> mysql>

DROP DROP DROP DROP DROP DROP

FUNCTION FUNCTION FUNCTION FUNCTION FUNCTION FUNCTION

metaphon; myfunc_double; myfunc_int; lookup; reverse_lookup; avgcost;

As instrues CREATE FUNCTION e DROP FUNCTION atualizam a tabela de sistema func no co banco de dados mysql. O nome da funo, tipo e biblioteca compartilhada so salvas na ca a tabela. Voc deve ter os privilgios INSERT e DELETE para o banco de dados mysql para e e criar e deletar funes. co Voc no deve usar CREATE FUNCTION para adicionar uma funo que j tenha sido criada. e a ca a Se voc precisar reinstalar uma funo, voc deve remov-la com DROP FUNCTION e ento e ca e e a reinstal-la com CREATE FUNCTION. Voc precisaria fazer isto, por exemplo, se voc recoma e e pilar uma nova verso da sua funo, assim o mysqld obtem a nova verso. Por outro lado, a ca a o servidor continuar a utilizar a verso antiga. a a Funes ativas so recarregadas a cada vez que o servidor inicia, a menos que voc inicie co a e mysqld com a opo --skip-grant-tables. Neste caso, a a inicializao de UDF ignorada ca ca e e as UDFs cam indispon iveis. Uma funo ativa aquela que carregada com CREATE ca e FUNCTION e no removida com DROP FUNCTION.) a

14.2.3 Adicionando uma Nova Funo Nativa ca

O procedimento para adicionar uma nova funo nativa descrito aqui. Note que voc ca e e no pode adicionar funes nativas a distribuio binria porque o procedimento envolve a co ca a modicao no cdigo fonte do MySQL. Voc deve compilar o MySQL de uma distribuio ca o e ca fonte. Note tambm que se voc migrar para outra verso do MySQL (por exemplo, quando e e a uma nova verso liberada), voc precisar repetir o procedimento com a nova verso. a e e a a Para adicionar uma funo MySQL nativa, siga estes passos: ca 1. Adicionr uma linha a lex.h que dena o nome da funo no vetor sql_functions[]. ca 2. Na funo prottipo simples (utilize apenas zero, um, dois ou trs argumentos), voc ca o e e e deve especicar SYM(FUNC ARG#) em lex.h (onde # o nmero de argumentos) e u como o segundo argumento no vetor sql_functions[] e adicionar uma funo que ca cria um objeto de funo em item_create.cc. De uma olhada em "ABS" e create_ ca funcs_abs() para um exemplo disto. Se o prottipo da funo for complicado (por exemplo, tiver um nmero varivel de o ca u a argumentos), voc deve adicionar duas linhas a sql_yacc.yy. Uma indica o s e imbolo pre-processador que o yacc deve dinir (isto deve ser adicionado no comeo do arquivo). c Ento dena os parmetros da funo e adicione um item com estes parmetros a a a ca a regra simple_expr do analizador. Por exemplo, verique todas as acorrncias de ATAN e em sql_yacc.yy para ver como ele feito. e 3. Em item_func.h, declare uma classe herdada de Item_num_func ou Item_str_func, dependendo se sua funo retorna um nmero ou uma string. ca u 4. Em item_func.cc, adicione uma das seguintes declaraes, dependendo se voc est co e a denindo uma funo numrica ou string: ca e

Cap tulo 14: Estendendo o MySQL

909

double Item_func_newname::val() longlong Item_func_newname::val_int() String *Item_func_newname::Str(String *str) Se voc herdar seu objeto de qualquer um dos itens padres (como Item_num_func), e o voc provavelmente s dever denir uma das funes acima e deixar os objetos pais e o a co cuidar das outras funes. Por exemplo, a classe Item_str_func dene uma funo co ca val() que executa atof() no valor retornado por ::str(). 5. Voc tambm deve, provavelmente, denir a seguinte funo objeto: e e ca void Item_func_newname::fix_length_and_dec() Esta funo deve pelo menos calcular max_length baseado nos argumentos dados. max_ ca length o nmero mximo de caracteres que a funo pode retornar. Esta funo e u a ca ca tambm deve denir maybe_null = 0 se a funo principal no puder retornar um e ca a valor NULL. A funo pode vericar se algum dos argumentos da funo pode retornar ca ca NULL vericando a varivel de argumentos maybe_null. Voc pode dar uma olhada em a e Item_func_mod::fix_length_and_dec para um exemplo t ipico de como fazer isto. Todas as funes devem ser seguras com thread (em outras palavras, no utilize qualquer co a varivel global ou esttica nas funes sem protege-las com mutexes). a a co Se voc retornar NULL, de ::val(), ::val_int() ou ::str() voc deve denir null_value e e com 1 e retornar 0. Para funes objetos ::str(), existem algumas consideraes adicionais das quais voc co co e deve estar ciente: O arguemto String *str fornece um buer string que pode ser utilizado para guardar o resultado. (Para mais informaes sobre o tipo String, d uma olhada no arquivo co e sql_string.h.) A funo ::str() deve retornar a string que guarda o resultado ou (char*) 0 se o ca resultado NULL. e Todas as funes string atuais tentam evitar a alocao de memria a menos que seja co ca o absolutamente necessrio! a

14.3 Adicionado Novos Procedimentos ao MySQL

No MySQL, voc pode denir um procedimento em C++ que pode acessar e modicar os e dados em uma consulta antes que ela seja enviada ao cliente. A modicao pode ser feita ca linha a linha ou a nivel GROUP BY. Ns criamos um procedimento exemplo no MySQL Verso 3.23 para mostrar o que pode o a ser feito. Adicionalmente recomendamos que voc de uma olhada em mylua. Com isto voc pode e e utilizar a linguagem LUA para carregar um procedimento em tempo de execuo no mysqld. ca

14.3.1 Anlise de Procedimento a

analyse([max elements,[max memory]]) Este procedimento denido em sql/sql_analyse.cc. Ele examina o resultado de sua e consulta e retorna uma anlise do resultado: a

910

MySQL Technical Reference for Version 5.0.0-alpha

max elements (padro 256) o nmero mximo de valores distintos que analyse notia e u a car por coluna. Isto utilizado por analyse para vericar se o tipo timo da coluna a e o deve ser do tipo ENUM. max memory (padro 8192) a memria mxima que analyse deve alocar por coluna a e o a enquanto tenta encontrar todos os valores distintos. SELECT ... FROM ... WHERE ... PROCEDURE ANALYSE([max elements,[max memory]])

14.3.2 Escrevendo um Procedimento

No momento, a unica documentao sobre isto o cdigo fonte. ca e o Voc pode encontrar todas as informaes sobre procedimentos examinando os seguintes e co arquivos: sql/sql_analyse.cc sql/procedure.h sql/procedure.cc sql/sql_select.cc

Apndice A: Problemas e Erros Comuns e

911

Apndice A Problemas e Erros Comuns e

Este cap itulo lista alguns problemas e mensagens de erro comuns que os usurios encontram. a Voc aprender como entender o problema e o que fazer para resolv-lo. Voc tambm e a e e e encontrar solues apropriadas para alguns prblemas comuns. a co

A.1 Como Determinar o Que Est Causando Problemas a

Quando voc encontrar problemas, a primeira coisa que voc deve fazer descobrir qual o e e e programa / parte do equipamento est causando problema: a Se voc tiver um dos seguintes sintomas, ento provavel que haja um problema de e a e hardware (como memria, placa me, CPU ou disco r o a igido) ou kernel: O teclado no funciona. Isto normalmente pode ser vericado pressionando CAPS a LOCK. Se a luz do CAPS LOCK no alterar, voc dever trocar o seu teclado. a e a (Antes de fazer isto, voc deve tentar reiniciar o seu computador e vericar todos e os cabos do teclado.) O ponteiro do mouse no move. a A mquina no responde ao ping de uma mquina remota. a a a Diferente, programas no relacionados no comportam corretamente. a a Se o seu sistema reiniciar inesperadamente (um programa de n do usurio nunca ivel a deve nalizar o seu sistema). Neste caso voc deve inciar vericando todos os seus cabos e executando alguma fere ramenta de diagnstico para vericar o seu hardware. Voc tambm deve vericar se o e e existem patches, atualizaes ou service packs para o seu sistema operacional que podeco riam resolver o seu problema. Verique tambm que todas as suas bibliotecas (como e glibc) esto atualizadas. a Sempre bom usar uma mquina com memria ECC para descobrir problemas de e a o memria antecipadamente. o Se o seu teclado est travado, voc deve estar apto a consert-lo logando em sua a e a mquina a partir de outra mquina e executando kbd_mode -a nela. a a Por favor, examine o seu arquivo de log do sistema (/var/log/messages ou similar) procurando pela razo de seus problemas. Se voc acha que o problema est no MySQL a e a ento voc deve examinar o arquivo de log do MySQL. Veja Seo 4.10.4 [Log binrio], a e ca a Pgina 374. a Se voc acha que voc no tem problema de hardware, voc deve tentar encontrar qual e e a e o programa que est causando problemas. a Tente usar top, ps, taskmanager, ou algum programa parecido, para vericar qual programa est utilizando toda a CPU oui travando a mquina. a a Verique com top, df, ou um programa similar se voc excedeu a quantidade de e memria, espao em disco, arquivos abertos ou algum outro recurso cr o c itico. Se o problema algum processo em execuo, voc sempre pode tentar mat-lo. Se ele e ca e a no quiser morrer, provavelmente h um bug em seu sistema operacional. a a

912

MySQL Technical Reference for Version 5.0.0-alpha

Se depois de voc examinar todas as outras possibilidades e voc tiver conclu que o e e ido e cliente MySQL ou o servidor MySQL que est causando problemas, hora de fazer um a e relatrio de erro para a nossa lista de emails ou nossa equipe de suporte. No relatrio de o o erro, tente dar uma descrio bem detalhada de como o sistema se comporta e o que voc ca e acha que est acontecendo. Voc tambm deve dizer porque voc acha que o MySQL que a e e e e esta causando problemas. Lev em considerao todas as situaes neste cap ca co itulo. Indique qualquer problema exatamente como ele aparece quando voc examina o seu sistema. Use e o mtodo cortar e colar para qualquer sa e/ou mensagem de erro do programa e/ou e ida arquivos de log! Tente descrever em detalhes qual programa no est funcionando e todos os sintomas que a a voc v! Ns recebemos muitos relatrios de erros que apenas indicavam "o sistema no e e o o a funciona". Isto no nos fornece qualquer informao sobre o que poderia ser o problema. a ca Se um programa falhar, sempre util saber: e O programa em questo realizou um operao de segmentation fault (core dumped)? a ca O program aesta consumindo toda a CPU? Verique com top. Deixe o programa rodar por um tempo. Ele pode estar avaliando algo pesado. Se o servidor mysqld que est causando problemas, voc pode fazer um mysqladmin e a e -u root ping ou mysqladmin -u root processlist? O que o progrma cliente diz (tente com mysql, por exemplo) quando voc tenta conectar e ao servidor MySQL? O cliente travou? Voc obteve qualquer sa do programa? e ida Quando enviar um relatrio de erro, voc deve seguir o que descrito neste manual. Veja o e e Seo 1.7.1.2 [Fazendo perguntas], Pgina 35. ca a

A.2 Erros Comuns Usando o MySQL

Esta seo lista alguns erros que os usurios obtm frequqntemente. Voc encontrar deca a e e a scries de erros e como resolv-los aqui. co e

A.2.1 Erro: Access Denied

Veja Seo 4.3.12 [Acesso Negado], Pgina 250. Veja Seo 4.3.6 [Privilgios], Pgina 232. ca a ca e a

A.2.2 Erro: MySQL server has gone away

Esta seo tambm cobre o erro relacionado sobre perda de conex~o com o servidor ca e a durante uma consulta. A razo mais comum para o erro MySQL server has gone away que o servidor esgotou a e o tempo limite e fechou a conexo. Por padro, o servidor fecha uma conexo depois de a a a 8 horas se nada aconctecer. Voc pode alterar o tempo limite congurando a varivel e a wait_timeout quando voc iniciar o mysqld. e Outra razo comum para receber o erro MySQL server has gone away porque voc exa e e ecutou um fechar em sua conexo MySQL a ento tentou executar uma consulta na a a conexo fechada. a

Apndice A: Problemas e Erros Comuns e

913

Se voc tiver um script, voc s tem que executar a consulta novamente para o cliente e e o reconectar autometicamente. Voc normalmente pode obter os seguintes cdigos de erros neste caso (qual voc obter e o e a depender do SO): a Cdigo de erro o Descrio ca CR_SERVER_GONE_ERROR O cliente no pode enviar um pedido ao servidor. a CR_SERVER_LOST O cliente no obteve um erro ao escrever no servidor, a mas no obteve uma resposta completa (ou nenhuma rea sposta) a seu pedido. Voc tambm ir obter este erro se algum tiver matado a thread em execuo com kill e e a e ca #threadid#. Voc pode vericar que o MySQL no morreu executando mysqladmin version e examie a nando o tempo em execuo. Se o problema que o mysqld falhou voc deve descobrir a ca e e razo da falha. Voc deve neste caso iniciar vericando se executar a consulta novamente a e ir nalizar o MySQL novamente. Veja Seo A.4.1 [Falhas], Pgina 925. a ca a Voc tambm pode obter estes erros se voc enviar uma consulta incorreta ou muito grande e e e ao servidor. Se mysqld recebe um pacote muito grande ou fora de ordem. ele assume que alguma coisa saiu errado com o cliente e fecha a conexo. Se voc precisa de grandes a e consultas (por exemplo, se voc est trabalhando com grandes colunas BLOB), voc pode e a e aumentar o limite da consulta iniciando o mysqld com a opo -O max_allowed_packet=# ca (padro 1M). A memria extra alocada sobre demanda, assim o mysqld alocar mais a o e a memria apenas quando voc executar uma grande consulta ou quando o mysqld deve o e retornar um grande registro de resultado! Voc tambm obter uma conexo perdida se voc estiver enviando um pacote >= 16M e e e a a e se seu cliente for mais antigo que a verso 4.0.8 e a verso do seu servidor 4.0.8 e acima a a e ou vice versa. Se voc quiser fazer um relatrio de erros descreendo este prolema, esteja certo de ter e o inclu as seguintes informaes: ido co Informe se o MySQL morreu ou no. (Voc pode encontrar into no arquivo a e hostname.err). Veja Seo A.4.1 [Falhas], Pgina 925. ca a Se uma cosulta espec ica matar o mysqld e as tabelas envolvidas foram vericadas com CHECK TABLE antes que voc zesse a consulta, voc pode fazer um caso de teste para e e isto? Veja Seo E.1.6 [Caso de testes reproduz ca iveis], Pgina 1084. a Qual o valor da varivel wait_timeout no servidor MySQL? mysqladmin variables e a lhe d o valor destas variveis. a a Voc tentou executar mysqld com --log e vericou se a consulta executada apareceu e no log? Veja Seo 1.7.1.2 [Fazendo perguntas], Pgina 35. ca a

A.2.3 Erro: Cant connect to [local] MySQL server

Um cliente MySQL em Unix pode conectar ao servidor mysqld de dois modos diferentes: sockets Unix, que conectam atravs de um arquivo no sistema de arquivos (padro e a /tmp/mysqld.sock) ou TCP/IP, que conecta atravs um nmero de porta. Sockets Unix e u

914

MySQL Technical Reference for Version 5.0.0-alpha

so mais rpidos que TCP/IP mas s podem ser usados quando conectados ao servidor no a a o mesmo computador. Sockets Unix so usados se voc no especicar um nome de mquina a e a a ou se voc especicar o nome de mquina especial localhost. e a No Windows, se o servidor mysqld est rodando no 9x/Me, voc s pode conectar via a e o TCP/IP. Se o servidor estiver rodando no NT/2000/XP e o mysqld iniciado com -e enable-named-pipe, voc tambm pode conectar com named pipes. O nome do named e e pipes MySQL. Se voc no der um nome de mquina quando conectar ao mysqld, um e e a a cliente MySQL tentar conectar primeiro ao named pipe, e se isto no funcionar ele ir a a a conectar a porta TCP/IP. Voc pode forar o uso de named pipes no Windows usando . e c como nome de mquina. a O erro (2002) Cant connect to ... normalmente signica que no h um servidor MySQL a a rodando no sistema ou que voc est usando um arquivo socket ou porta TCP/IP errado e a ao tentar conectar so servidor mysqld. Inicie vericando (usando ps ou gerenciador de tarefas do Windows) que h um processo a chamado mysqld executando em seu sistema! Se no houver nenhum processo mysqld, voc a e deve iniciar um. Veja Seo 2.4.2 [Iniciando o servidor], Pgina 116. ca a Se um processo mysqld estiver em execuo, voc pode vericar o servidor tentando estas ca e diferentes conexes (o nmero da porta e o caminho do socket devem ser diferente em sua o u consigurao, claro): ca e shell> mysqladmin version shell> mysqladmin variables shell> mysqladmin -h hostname version variables shell> mysqladmin -h hostname --port=3306 version shell> mysqladmin -h ip for your host version shell> mysqladmin --protocol=socket --socket=/tmp/mysql.sock version Note o uso de aspas para traz em vez de aspas para frente com o comando hostname; isto provoca a sa de hostname (que , o nome de mquina atual) para ser substitu no ida e a ido comando mysqladmin. Aqui esto algumas razes pela quais o erro Cant connect to local MySQL server pode a o ocorrer: mysqld no est rodando. a a Voc est rodando em um sistema que usa MIT-pthreads. Se voc estiver executando e a e em um sistema que no possui threads nativas, o mysqld usa o pacote MIT-pthreads. a Veja Seo 2.2.3 [Qual SO], Pgina 78. No entanto, nem todas as verses de MITca a o pthreads suportam sockets Unix. Em um sistema sem suporte a sockets voc sempre e deve especicar o nome de mquina explicitamente ao conectar ao servidor. Tente usar a este comando para vericar a conexo com o servidor: a shell> mysqladmin -h hostname version Algum removeu o socket Unix que o mysqld utiliza (por padro /tmp/mysqld.sock). e a Voc deve ter um trabalho cron que remove o socket MySQL (por exemplo, um tre balhoque remove arquivos antigos do diretrio /tmp). Voc sempre pode executar o e mysqladmin version e vericar que o socket que o mysqladmin est tentando usar a realmente existe. A correo neste caso alterar o trabalho cron para no remover ca e a mysqld.sock ou para colocar o socket em outro local. Veja Seo A.4.5 [Problemas ca com mysql.sock], Pgina 929. a

Apndice A: Problemas e Erros Comuns e

915

Voc iniciou o servidor mysqld com a opo --socket=/path/to/socket. Se voc e ca e alterar o caminho do socket para o servidor, voc tambm deve noticar o cliente e e MySQL sobre o novo caminho. Voc pode fazer isto fornecendo o caminho do socket e como um argumento para o cliente. Veja Seo A.4.5 [Problemas com mysql.sock], ca Pgina 929. a Voc est usando Linux e uma thread nalizou (core dumped). Neste caso voc deve e a e matar as outras threads mysqld (por exemplo, com o script mysql_zap antes de voc e poder iniciar um novo servidor MySQL. Veja Seo A.4.1 [Falhas], Pgina 925. ca a Voc pode no ter privilgios de leitura e escrita tanto no diretrio que guarda o arquivo e a e o de socket quanto no prprio arquivo de socket. Neste caso voc deve mudar o privilgio o e e do diretrio/arquivo ou reiniciar mysqld para que ele use um diretorio que voc possa o e utilizar. Se voc obter a mensagem de erro Cant connect to MySQL server on alguma_maquina, e voc pode tentar o seguinte para descobrir qual o problema: e e Verique se o servidor est funcionando fazendo telnet seu-servidor num-portaa tcp-ip e pressione Enter algumas vezes. Se houver um servidor MySQL em execuo ca nesta porta voc deve obter uma resposta que inclui o nmero da verso do servidor e u a MySQL em execuo. Se voc obter um erro como telnet: Unable to connect to ca e remote host: Connection refused, ento no h nenhum servidor rodando na porta a a a dada. Tente conectar ao daemon mysqld na mquina local e verique a porta TCP/IP que o a mysqld est congurado para usar (varivel port) com mysqladmin variables. a a Verique se o seu servidor mysqld no foi iniciado com a opo --skip-networking. a ca

A.2.4 Erro: Client does not support authentication protocol

O MySQL 4.1 usa um protocolo de autenticao baseado em um algor ca itmo de hashing de com aquele usado por outros clientes. Se voc atualizar o servidor senha que incompativel e e para a verso 4.1, tentar se conectar a ele com um cliente mais antigo pode falhar com a a seguinte mensagem: shell> mysql Client does not support authentication protocol requested by server; consider upgrading MySQL client Para resolver este problema voc deve fazer um dos seguintes: e Atualizar todos os progrmas clientes para usar a biblioteca cliente 4.1.1 ou mais nova. Use uma conta com uma senha antiga ao conectar em clientes anteriores ao 4.1. Reset o usurio que precisa de um cliente anterior ao 4.1 para usar a senha antiga: a mysql> UPDATE user SET Password = OLD_PASSWORD(mypass) -> WHERE Host = some_host AND User = some_user; mysql> FLUSH PRIVILEGES; Diga ao servidor para usar o algoritmo de hashing de senha antigo: 1. Inicie o mysqld com --old-passwords. 2. Dena a senha para todos os usurios que tenham senha longa. Voc pode encona e trar estes usurios com: a

916

MySQL Technical Reference for Version 5.0.0-alpha

SELECT * FROM mysql.user WHERE LEN(password) > 16; Para mais informaes sobre hash de senha e autenticao, veja Seo 4.3.11 [Password co ca ca hashing], Pgina 245. a

A.2.5 Erro: Host ... is blocked

Se voc obter um erro como este: e Host hostname is blocked because of many connection errors. Unblock with mysqladmin flush-hosts signica que o mysqld obteve diversos (max_connect_errors) pedidos de conexo da a mquina hostname e que foram interrompidos no eio. Depois de max_connect_errors a pedidos com falhas o mysqld assume que algo est errado (como um attack de um a cracker), e bloqueia o site para tais conexes at algum executar o comando mysqladmin o e e flush-hosts. Por padro, o mysqld bloqueia um host depois de 10 erros de conexo. Voc pode facilmente a a e ajustar isto iniciando o servidor assim: shell> mysqld_safe -O max_connect_errors=10000 & Note que se voc obter esta mensagem de erro para uma dada mquina, voc deve primeirae a e mente vericar se no h nada errado com a conexo TCP/IP desta mquina. Se sua a a a a conexo TCP/IP no estiver funcionando, no ser nada bom aumentar o valor da varivel a a a a a max_connect_errors!

A.2.6 Erro: Too many connections

Se voc obter o erro Too many connections quando vac tentar se conectar ao MySQL, isto e e signica que j existe max_connections clientes conectados ao servidor mysqld. a Se voc precisar de mais conexes do que o padro (100), ento voc deve reiniciar o mysqld e o a a e com um valor maior para a varivel max_connections. a Note que atualmente o mysqld permite que (max_connections+1) clientes se conectem. A ultima conexo reservada para um usurio com o privilgio SUPER. Ao no dar este a e a e a privilgio a usurios normais (eles no precisam dele), um administrador com este privilgio e a a e pode logar e utilizar SHOW PROCESSLIST para descobrir o que pode estar errado. Veja Seo 4.6.8.6 [SHOW PROCESSLIST], Pgina 320. ca a O nmero mximo de conexes MySQL depende de quo boa a biblioteca de threads u a o a e na dada plataforma. Linux ou Solaris devem estar aptos a suportar 500-1000 conexes o simultneas, dependendo de quanta RAM voc tem e do que o cliente est fazendo. a e a

A.2.7 Erro: Some non-transactional changed tables couldnt be rolled back

Se voc obter o erro/aviso: Warning: Some non-transactional changed tables couldnt e be rolled back ao tentar fazer um ROLLBACK, isto signica que algumas das tabelas que voc utiliza na transao no suportam transaes. Estas tabelas no transacionaisn no e ca a co a a sero afetadas pela instruo ROLLBACK. a ca

Apndice A: Problemas e Erros Comuns e

917

O caso mais comum em que isto acontece quando voc tenta criar uma tabela de um tipo e e que no suportado por seu binrio mysqld. Se o mysqld no suporta um tipo de tabela a e a a (ou se o tipo de tabela est disabilitado por uma opo de inicializao), ele criar a tabela a ca ca a com o tipo mais comumente usado em suas outras tabelas, que provavelmente o MyISAM. e Voc pode vericar o tipo de uma tabela fazendo: e SHOW TABLE STATUS LIKE nome_tabela. Veja Seo 4.6.8.2 [SHOW TABLE STATUS], ca Pgina 304. a Voc pode vericar as extenso que seu binrio mysqld suporta com: e a a show variables like have_%. Veja Seo 4.6.8.4 [SHOW VARIABLES], Pgina 309. ca a

A.2.8 Erro: Out of memory

Se voc executar uma consulta e obter algo como o seguinte erro: e mysql: Out of memory at line 42, malloc.c mysql: needed 8136 byte (8k), memory in use: 12481367 bytes (12189k) ERROR 2008: MySQL client ran out of memory note que o erro se refere ao cliente MySQL mysql. A razo para este erro simplesmente a e que o cliente no possui memria sucente para armazenar todo o resultado. a o Para solucionar o problema, primeiro verique que sua consulta est correta. E razovel a a que voc deva retornar tantos registros? Se for, voc pode utilizar mysql --quick, que usa e e mysql_use_result() para retornar o resultado. Isto coloca menos carga no cliente (mas mais carga nop servidor).

A.2.9 Erro: Packet too large

Quando um cliente MySQL ou o servidor mysqld recebe um pacote maior que max_allowed_ packet bytes, ele envia o erro Packet too large e fecha a conexo. a No MySQL 3.23 o maior pacote possivel 16M (devido a limites do protocolo e cliente/servidor). No MySQL 4.0.1 e acima el s limitado pela quantidade de memria oe o que voc tem no seu servidor (at um mximo terico de 2GB). e e a o Um pacote de conexo uma unica instruo SQL enviada ao servidor MySQL ou um unica a e ca linha enviada para o cliente. Quando um cliente MySQL ou o servidor mysqld obtem um pacote maior que max_allowed_ packet bytes, ele envia o erro Packet too large e fecha a conexo. Com alguns clientes voc a e tambm pode obter o erro Lost connection to MySQL server during query se o pacote e de comunicao for muito grande. ca Note que tanto o cliente quanto o servidor tem a sua prpria varivel max_allowed_packet. o a Se voc quiser tratar os pacotes grandes, voc tem que aumentar esta varivel tanto no e e a cliente quanto no servidor. E seguro aumentar esta varivel j que a memria s alocada quando necessrio; esta a a o o e a varivel mais uma precauo para pegar pacotes errados entre o cliente/servidor e tambm a e ca e para assegurar que voc use pacotes grandes acidentalemente e assim que sem memria. e o Se voc estiver usando o cliente mysql, voc pode especicar um buer maior iniciando e e o cliente com mysql --set-variable=max_allowed_packet=8M. Outros clientes tem

918

MySQL Technical Reference for Version 5.0.0-alpha

mtodos diferentes de congurar esta varivel. Por favor, note que --set-variable est e a a obsoleta desde o MySQL 4.0, em seu lugar utilize --max-allowed-packet=8M. Voc pode utilizar o arquivo de opo para denir max_allowed_packet com um e ca tamanho maior no mysqld. Por exemplo, se voc est esperando armazenar o tamanho e a total de um MEDIUMBLOB em uma tabela, voc precisar iniciar o servidor com a opo e a ca set-variable=max_allowed_packet=16M. Voc tambm pode obter problemas estranhos com pacotes grandes se voc estiver usando e e e blobs grandes, mas voc no deu para mysqld accesso a memria suciente para tratar a e a o consulta. Se voc suspeita que este o caso, tente adicionar ulimit -d 256000 no inicio do e e script mysqld_safe e reinicie o mysqld.

A.2.10 Erros de Comunicao / Comunicao Abortada ca ca

A partir do MySQL 3.23.40 voc s recebe o erro de Conex~o abortada se voc iniciar o e o a e mysqld com --warnings. Se voc encontar erros como o seguinte em seu log de erro. e 010301 14:38:23 Aborted connection 854 to db: users user: josh Veja Seo 4.10.1 [Error log], Pgina 372. ca a Isto signica que algum dos seguintes problemas ocorreu: O programa cliente no chamou mysql_close() antes de sair. a O cliente tem esperado mais que wait_timeout ou interactive_timeout sem fazer nenhuma requisio. Veja Seo 4.6.8.4 [wait_timeout], Pgina 309. Veja Seo 4.6.8.4 ca ca a ca [interactive_timeout], Pgina 309. a O programa cliente nalizou abuptamente no meio de uma transferncia. e Quando o descrito acima ocorrer, a varivel Aborted_clients do servidor incrementeda. a e A varivel Aborted_connects do servidor incrementeda quando: a e Quando um pacote de conexo no contm a informao correta. a a e ca Quando o usurio no tiver privilgios para conectar ao banco de dados. a a e Quando o usurio usar uma senha errada. a Quando levar mais de connect_timeout segundos para obter um pacote de conexo. a Veja Seo 4.6.8.4 [connect_timeout], Pgina 309. ca a Note que o descrito acima podia indicar que algum est tentando derrubar o seu banco de e a dados. Outras razes para problemas com Clientes abortados / Conexes abortadas. o o O uso de protocolo Ethernet com Linux, tanto half quanto full duplex. Muitos drivers de Ethernet do Linux possui este bug. Voc deve test-lo transferindo um arquivo enorme e a via ftp entre estas duas mquinas. Se uma transferncia entra no modo de estouroa e pausa-esoturo-pausa... ento voc est experimentando uma s a e a indorme de duplex no Linux A unica soluo trocar o modo duplex, tanto da placa de rede quanto do ca e Hub/Switch entre full duplex e half duplex e testar os resultados para decidir qual a e melhor congurao. ca Alguns problemas com a biblioteca de threads interrompe uma leitura.

Apndice A: Problemas e Erros Comuns e

919

TCP/IP mal congurado. Defeitos na rede, hub, switch, cabos, ... Isto pode ser diagnosticado de forma apropriada aomente atravs de reposio de hardware. e ca max_allowed_packet muito pequeno ou a consulta exige memria livre que voc e o e alocou para mysqld. Veja Seo A.2.9 [Packet too large], Pgina 917. ca a

A.2.11 Erro: The table is full

exitem alguns casos diferentes nos quais voc pode obter este erro: e Voc est usando um verso mais antiga do MySQL (antes da 3.23.0) quando uma e a a tabela temporria em memria se torna maior que tmp_table_size bytes. Para evitar a o este problema, voc pode utilizar a opo -O tmp_table_size=# para fazer o mysqld e ca aumentar o tamanho da tabela temporria ou usar a opo SQL SQL_BIG_TABLES antes a ca de disparar a consulta problematica. Veja Seo 5.5.6 [SET], Pgina 460. ca a Voc tambm pode iniciar mysqld com a opo --big-tables. Isto extamente o e e ca e mesmo que usar SQL_BIG_TABLES para toadas as consultas. No MySQL Verso 3.23, se uma tabelas temporrias em memria se torna maior que a a o tmp_table_size, o servido automaticamente a converte para tabelas em disco MyISAM. Voc est usando tabelas InnoDB e ca sem espao no tablespace do InnoDB. Neste e a c cado a soluo extender o tablespace do InnoDB. ca e Voc est usando tabelas ISAM ou MyISAM em um SO que s suporta arquivos de 2G e e a o voc alcanou este limite para os arquivos de dado ou e c indice. Voc est usando tabelas MyISAM e o dado necessrio ou tamanho do e a a indice maior que e alqueles para os quais o MySQL alocou ponteiros. (Se voc no especicar MAX_ROWS e a para CREATE TABLE o MySQL s alocar ponteriros para guardar 4G de dados). o a Voc pode vericar o tamanho mximo do dados/ e a indice fazendo SHOW TABLE STATUS FROM database LIKE nome_tabela; ou usando myisamchk -dv database/nome_tabela. Se este o problema, voc pode corrig fazendo algo como: e e i-lo ALTER TABLE nome_tabela MAX_ROWS=1000000000 AVG_ROW_LENGTH=nnn; Voc s precisa especicar AVG_ROW_LENGTH para tabelas com campos BLOB/TEXT j e o a que neste caso o MySQL no pode otimizar o espao necessrio baseado apenas no a c a nmero de linhas. u

A.2.12 Erro: Cant create/write to file

Se voc obter um erro do tipo abaixo em suas consultas: e Cant create/write to file \\sqla3fe_0.ism. signica que o MySQL no pode criar um arquivo temporrio para o resultado no diretrio a a o temporrio dado. (O erro acima um mensagem de erro t a e ipica no Windows; a mensagem de erro do Unix parecida.) A correo iniciar o mysqld com --tmpdir=path ou adicionar e ca e ao seu arquivo de opo: ca

920

MySQL Technical Reference for Version 5.0.0-alpha

[mysqld] tmpdir=C:/temp assumindo que o diretrioe c:\\temp existe. o Pgina 216. a Veja Seo 4.1.2 [Arquivos de opo], ca ca

Verique tambm o cdigo de erro que voc obteve com perror. Outra razo pode ser um e o e a erro de disco cheio; shell> perror 28 Error code 28: No space left on device

A.2.13 Erro no Cliente: Commands out of sync

Se voc obter Commands out of sync; you cant run this command now no cdigo de seu e o cliente, voc est chamando funes do cliente na ordem errada. e a co Isto pode acontecer, por exemplo, se voc est utilizando mysql_use_result() e tenta e a executar uma nova consulta antes de chamar mysql_free_result(). Isto tambm pode e acontecer se voc tentar executar duas consultas que retornam dados sem um mysql_use_ e result() ou mysql_store_result() entre elas.

A.2.14 Erro: Ignoring user

Se voc obter o seguinte erro: e Found wrong password for user: some_user@some_host; ignoring user signica que quando o mysqld foi iniciado ou quando recarregiou a tabela de permisses, o ele encontrou uma entrada na tabela user com uma senha invlida. Como resultado, a a entrada simplesmente ignorada pelo sistema de permisses. e o As poss iveis causas e correes para este problema: co Voc pode executar uma nova verso do mysqld com uma tabela user antiga. Voc e a e pode vericar isto executando mysqlshow mysql user para ver se o campo da senha e menor que 16 caracteres. Se for, voc pode corrigir esta condio executando o script e ca scripts/add_long_password. O usurio tem um senha antiga (8 caracteres) e voc no iniciou o mysqld com a opo a e a ca --old-protocol. Atualize o usurio na tabela user com uma nova senha ou reinicie a o mysqld com --old-protocol. Voc especicou uma senha na tabela de usurio user sem sar a funo PASSWORD(). e a ca Use mysql para atualizar o usurio na tabela user com uma nova senha. Utilize a a funo PASSWORD(): ca mysql> UPDATE user SET password=PASSWORD(your password) -> WHERE user=XXX;

A.2.15 Erro: Table xxx doesnt exist

Se voc obter o erro Table xxx doesnt exist ou Cant find file: xxx (errno: 2), e signica que no existem tabelas no banco de dados atual com o nome xxx. a

Apndice A: Problemas e Erros Comuns e

921

Note que como o MySQL utiliza diretrios e arquivos para armazenar banco de dados e o tabelas, o nome de banco de dados e tabelas so caso-sensitive! (No Windows o nome de a banco de dados e tabelas no so caso-sensitivo mas todas as referncias a uma dada tabela a a e dentro de uma consulta devem utilizar o mesmo caso!) Voc pode vericar quais tabelas existem no banco de dados atual com SHOW TABLES. Veja e Seo 4.6.8 [SHOW], Pgina 302. ca a

A.2.16 Erro: Cant initialize character set xxx

Se voc obtr um erro do tipo: e MySQL Connection Failed: Cant initialize character set xxx signica que um dos seguintes problemas: e O conjunto de caracter multi-byte e voc no tem suporte para o conjunto de carace e a teres no cliente. Neste caso voc precisa recompilar o cliente com --with-charset=xxx ou com --withe extra-charsets=xxx. Veja Seo 2.3.3 [congure options], Pgina 98. ca a Todos os bionrios MySQL padres so compilados com --with-extra-charactera o a sets=complex que habilita o suporte para todos os conjuntos de caracteres multi-byte. Veja Seo 4.7.1 [Conjunto de caracteres], Pgina 325. ca a O conjunto de caracteres simples e no foi compilado no mysqld e os arquivos de e a denio do conjunto de caracteres no esto localizados onde o cliente esperava enca a a contr-los. a Neste caso voc precisa: e Recompilar o cliente com suporte ao conjunto de caracteres. Veja Seo 2.3.3 ca [congure options], Pgina 98. a Especicar para o cliente onde o arquivo de denio do conjuntos de caracteres ca est. Para muitos clientes voc pode faz-lo com a opo --character-setsa e e ca dir=path-to-charset-dir. Copie o arquivo de denio de caracteres no caminho onde o cliente espera que ca eles estejam.

A.2.17 Arquivo No Encontrado a

Se voc obter ERROR ... not found (errno: 23), Cant open file: ... (errno: 24), e ou qualquer outro erro com errno 23 ou errno 24 no MySQL, signica que voc no alocou e a descritores de arquivo suciente para o MySQL. Voc pode usar o utilitrio perror para e a obter uma descrio sobre o que o nmero de erro signica: ca u shell> perror 23 File table overflow shell> perror 24 Too many open files shell> perror 11 Resource temporarily unavailable

922

MySQL Technical Reference for Version 5.0.0-alpha

O problema aqui que mysqld est tentando manter aberto muitos arquivos simultanee a manete. Voc pode tambm dizer para o mysqld no abrir muitos arquivos de uma vez ou e e a aumentar o nmero de descritores de arquivos dispon u iveis para o mysqld. Para dizer para o mysqld manter aberto poucos arquivos por vez, voc pode tornar a cache e de tabela menor usando a opo -O table_cache=32 para mysqld_safe (o valor padro ca a 64). Reduzindo o valor de max_connections tambm reduzir o nmero de arquivos e e a u abertos (o valor padro 90). a e Para alterar o nmero de descritores de arquivos dispon u iveis para mysqld, voc pode usar a e opo --open-files-limit=# para mysqld_safe ou -O open-files-limit=# para mysqld. ca Veja Seo 4.6.8.4 [open_files_limit], Pgina 309. O modo mais fcil de fazer isto ca a a e adicioar a opo ao seu arquivo de opo. Veja Seo 4.1.2 [Arquivos abertos], Pgina 216. ca ca ca a Se voc tiver um verso antiga do mysqld que no suporte isto, voc pode editar o script e a a e mysqld_safe. Existe uma linha ulimit -n 256 comentada no script. Voc pode remover e o caracter # para descomentar esta linha, e altere o nmero 256 para afetar o nmero u u de descritores de arquivos dispon iveis para mysqld. ulimit (e open-files-limit) podem aumentar o nmero de descritorese de arquivo, mas u apenas at o limite imposto pelo sistema operacional. Tambm h um limite maior que s e e a o pode ser sobrescrito se voc iniciar o mysqld_safe ou mysqld como root (apenas se lembre e que voc tambm precisa usar a opo --user=... neste caso). Se voc precisa aumentar o e e ca e limite do SO no nmero dos descritores de arquivo disponiveis para cada processo, cosulte u a documentaco para ser sistema operacional. a Note que se voc rodar o shell tcsh, ulimit no funcioar! tcsh tambm relatar o valor e a a e a incorreto quando voc pergunta pelo limite atual! Neste caso voc deve iniciar mysqld_safe e e com sh!

A.3 Assuntos Relacionados a Instalao ca

A.3.1 Problemas de Ligao com a Biblioteca do Cliente MySQL ca
Se voc estiver ligando o seu programa e obter o erro de s e imbolos sem referncia que iniciam e com mysql_, como os seguintes: /tmp/ccFKsdPa.o: In function main: /tmp/ccFKsdPa.o(.text+0xb): undefined reference to mysql_init /tmp/ccFKsdPa.o(.text+0x31): undefined reference to mysql_real_connect /tmp/ccFKsdPa.o(.text+0x57): undefined reference to mysql_real_connect /tmp/ccFKsdPa.o(.text+0x69): undefined reference to mysql_error /tmp/ccFKsdPa.o(.text+0x9a): undefined reference to mysql_close voc deve estar apto a resolv-los adicionando e e -lmysqlclient no nal da sua linha de ligao. ca -Lpath-to-the-mysql-library

Se voc obter erros de undefined reference (refer^ncia indefinida) para as funes e e co descompactadas ou compactadas, adicione -lz no nal sa sua linha de ligao e tente ca novamente!

Apndice A: Problemas e Erros Comuns e

923

Se voc obter erros de undefined reference (refer^ncia indefinida) para funes que e e co devem existir em seu sistema, como connect, verique a pgina do man sobre a funo em a ca questo para saber quais bibiotecas voc deve adicionar a sua linha de ligao! a e ca Se voc obter erros de undefined reference (refer^ncia indefinida) para funes que e e co no existem em seu sistema, como o seguinte a mf_format.o(.text+0x201): undefined reference to __lxstat normalmente signica que sua biblioteca compilada em um sistema que no 100% come a e pat ivel com o seu. Neste caso voc de fazer o download da ultima distribuio fonte e ca do MySQL e compil-la voc mesmo. Veja Seo 2.3 [Instalao da distribuio fonte], a e ca ca ca Pgina 94. a Se voc estiver tentando executar um programa e ento obter erros de s e a imbolos sem referncia que comeam com mysql_ ou que a biblioteca do mysqlclient no pode e c a encontrar, signica que seu sistema no pode encontrar a biblioteca compartilhada a libmysqlclient.so. A correo deste problema dizer ao seu sistema para buscar onde a biblioteca esta lacolca e izada usando um dos seguintes mtodos: e Adicione o caminho ao diretrio onde est o libmysqlclient.so ` varivel de ambio a a a ente LD_LIBRARY_PATH. Adicione o caminho ao diretrio onde est o libmysqlclient.so ` varivel de ambio a a a ente LD_LIBRARY. Copie libmysqlclient.so a algum local que pesquisado pelo seu sistema, como e /lib, e atualize a informao da biblioteca compartilhada executando ldconfig. ca OUtro modo de resolver este problema ligar o seu programa estaticamente, com -static, e ou removendo as bibliotecas dinmicas do MySQL antes de ligar o seu cdigo. Na prxima a o o vez voc deve estar certo que nenhum outro programa esta usando bibliotecas dinmicas! e a

A.3.2 Como Executar o MySQL Como Um Usurio Normal a

O servidor mysqld pode ser iniciado por qualquer usurio. Para fazer com que o mysqld a execute como um usurio nome_usurio do Unix, voc deve fazer o seguinte: a a e 1. Pare o servidor se ele estiver em execuo (use mysqladmin shutdown). ca 2. Altere o diretrio de banco de dados e arquivos para que nome_usurio tenha privilgios o a e de leitura e escrita do arquivo (voc pode precisar estar como o usurio root do Unix): e a shell> chown -R nome_usuario /caminho/para/dir_dados/mysql Se o diretrio ou arquivos dentro do diretrio de dados do MySQL so links simbolicos, o o a voc tambm precisar seguir estes links e alterar os diretrios e arquivos para os quais e e a o ele aponta. chown -R pode no seguir o link simblico para voc. a o e 3. Inicie o servidor como o usurio nome_usurio, ou, se voc est usando o MySQL a a e a Verso 3.22 ou mais antiga, inicie o mysqld como o usurio root do Unix e use a opo a a ca --user=nome_usuario. mysqld trocar para executar como o usurio nome_usurio a a a do Unix antes de aceitar qualquer conexo. a 4. Para iniciar o servidor automaticamente com o nome de usurio dado na inicializao a ca do sistema, adicione um linha user que especica o nome do usurio ao grupo [mysqld] a

924

MySQL Technical Reference for Version 5.0.0-alpha

do arquivo de opes /etc/my.cnf ou o arquivo de opes my.cnf no diretrio de co co o dados do servidor. Por exemplo: [mysqld] user=nome_usuario Neste ponto, seu processo mysqld deve estar executando bem e redondo como usurio nome_ a usuario do Unix. No entanto algo no altera: o contedo da tabela de permisses. Por a u o padro (logo depois de executar o script de instalao das tabelas de permisses mysql_ a ca o install_db), o usurio MySQL root o unico com permisso para acessar o banco de a e a dados mysql ou para criar ou apagar banco de dados. A menos que voc tenha alterado e estas permisses, elas ainda valem. Isto no deve imped de de acessar o MySQL como o a i-lo usurio root do MySQL quando voc est logado como outro usurio Unix deiferente de a e a a root; apenas especique a opo -u root ao programa cliente. ca Note que acessar o MySQL como root, fornecendo -u root na linha de comando diferente e de de executar o MySQL como o usurio root do Unix,or como outro Usurio Unix. A a a permisso de acesso e nome de usurios do MySQL esto completamente separados dos a a a nomes de usurio do Unix. A unica conexo com os nomes de usurio do Unix que se a a a e voc no utilizar a opo -u quando chamr o seu programa cliene, o cliente tentar conectar e a ca a usando seu nome de login do Unix como o seu nome de usurio do MySQL a Se a sua conta Unix no esta segura, voc deve pelo menos colocar uma senha no usurio a e a root do MySQL na tabela de acesso. Seno qualquer usurio com uma conta nesta mquina a a a poder executar mysql -u root nome_bd e fazer o que quiser. a

A.3.3 Problemas com Permisses de Arquivos o

Se voc tiver problemas com permisses de arquivo, por exemplo, se o mysql enviar a e o seguinte mensagem de erro quando voc criar uma tabela: e ERROR: Cant find file: path/with/filename.frm (Errcode: 13) ento a varivel de ambiente UMASK pode estar congurada incorretamente quando o mysqld a a inicia. O valor umask padro 0660. Voc pode alterar este comportamento iniciando o a e e mysqld_safe como a seguir: shell> UMASK=384 # = 600 em octal shell> export UMASK shell> /path/to/mysqld_safe & Por padro o MySQL criar o banco de dados e diretrios RAID com permisso tipo 0700. a a o a Voc pode modicar este comportamento congurando a varivel UMASK_DIR. Se voc denir e a e isto, novos diretrios so criados com a combinao de UMASK e UMASK_DIR. Por exemplo, o a ca se voc quiser ao grupo a todos os novos diretrios, voc pode fazer: e o e shell> UMASK_DIR=504 # = 770 em octal shell> export UMASK_DIR shell> /path/to/mysqld_safe & No MySQL Verso 3.23.25 e acima, o MySQL assume que o valor para UMASK e UMASK_DIR a est em octal se ele iniciar com um zero. a Veja Apndice F [Variveis de ambiente], Pgina 1092. e a a

Apndice A: Problemas e Erros Comuns e

925

A.4 Assuntos Relacionados a Administrao ca

A.4.1 O Que Fazer Se o MySQL Continua Falhando
Todas as verses do MySQL so testadas em muitas plataformas antes de serem distribu o a idas. Isto no signica que no existe nenhum erro no MySQL, mas signica que se houver erros, a a eles so poucos e podem ser dif a iceis de encontrar. Se voc tiver u problema, sempre ajudar e a se voc tentar encontrar exatamente o que falhou em seu sistema e assim voc ter uma e e a chance muito maior de t-lo corrigido rapidamente. e Primeiro, voc deve tentar descobrir o problema que o daemon do mysqld morre ou se o e e seu problema relativo ao seu cliente. Voc pode vericar o quanto tempo o seu servidor e e mysqld est em execuo utilizando o mysqladmin version. Se o mysqld morrer, voc pode a ca e encontrar a causa disto no arquivo mysql-data-directory/nome_maquina.err. Veja Seo 4.10.1 [Registro de Erros], Pgina 372. ca a Em alguns sistemas voc pode encontrar neste arquivo um stack trace de onde o mysqld e nalizou e assim voc pode resolver com resolve_back_stack. Veja Seo E.1.4 [Usando e ca o stack trace], Pgina 1082. Note qte os valores da varivel escrita no arquivo .err no a a a podem sempre estar 100% corretas. Muitas falhas do MySQL so causadas por arquivos de a indices/dados corrompidos. O MySQL atualizar os dados em disco, com a chamada de sistema write(), depois de todas a as intrues SQL e antes do ser noticado sobre o resultado. (Isto no verdade se voc co a e e estiver executando com delay_key_write, caso no qual apenas o dado escrito.) Insto e signica que o dado salvo mesmo se o mysqld falhar, j que o SO se certicar de que o e a a dado no descarregado esta escrito em disco. Voc pode forar o MySQL a sincronizar tudo a e c para o disco depois de todo comando SQL inicando o mysqld com --flush. O exposto acimo signica que normalmente voc no deve ter tabelas corrompidas a menos e a que: Algum/algo nalize o mysqld ou a mquina no meio de uma atualizao. e a ca Voc encontrou um bug no mysqld que faa com que ele nalize no meio de uma e c atualizao. ca e a Algum est manipulando os arquivos de dados/ indices de fora do mysqld sem o bloqueio de tabela apropriado. Se voc estiver executando muitos servidores mysqld no mesmo dado em um sistema e que no suporta bons bloqueios de sistema de arquivos (normalmente tartando o daea mon lockd) ou se voc est executando multiplos servidores com --skip-externale a locking Voc tem um arquivo de dados/ e indices que contem muitos dados errados que deixam o mysqld confuso. Voc encontrou um bug no cdigo de armazenamento do dado. Isto no desejvel mas e o a e a poss e ivel. Neste caso voc ode tentar alterar o tipo de arquivo para outro mecanismo e de armazenamento usando ALTER TABLE em uma cpia corrigida da tabela! o Por ser muito dif saber o motivo das falhas, tente primeiro vericar se o que est funcioicil a nando para outros est falhando com voc. Por favor, tente o seguinte: a e

926

MySQL Technical Reference for Version 5.0.0-alpha

Finalize o daemon mysqld com mysqladmin shutdown, execute myisamchk --silent --force */*.MYI em todas as tabelas e reinicie o daemon mysqld. Isto ir assegurar a que voc est executando de um estado limpo. Veja Cap e a ptexi tulo 4 [Administrador de Banco de Dados MySQL], Pgina 207. a Use mysqld --log e tente determinar a partir da informao no log se alguma consulta ca especica nalizou o servidor. Aproximadamente 95% de todos os erros so relacionados a com um consulta em particular! Normalmente ela uma das ultimas consultas no e arquivo de log antes do MySQL reiniciar Veja Seo 4.10.2 [Registro de consultas], ca Pgina 373. Se voc puder nalizar o MySQL repetidamente com uma das consultas, a e mesmo quando voc tiver vericado todas as tabelas logo antes de realiz-la, ento e a a voc estar apto a localizar o bug e deve fazer um relatrio de bug para isto! Veja e a o Seo 1.7.1.3 [Relatrio de bugs], Pgina 36. ca o a Tente fazer um caso de teste que possamos utilizar para reproduzir o problema. Veja Seo E.1.6 [Caso de testes reproduz ca iveis], Pgina 1084. a Tente executar o teste incluso mysql-test e o benchmark do MySQL. Veja Seo 14.1.2 ca [Pacote de testes do MySQL], Pgina 896. Eles devem testar o MySQL bem. Voc a e tambm pode adicionar ao benchmark um cdigo que simule a sua aplicao! O benche o ca mark pode ser encontrado no diretrio bench na distribuio fonte ou, em uma diso ca tribuio binria, no diretrio sql-bench sob o diretrio de instalao do seu MySQL. ca a o o ca Experimente fork_test.pl e fork2_test.pl. Se voc congurar o MySQL para depuraao, ser muito mais fcil para obter ine c a a formaes sobre possiveis erros se alguma coisa der errado. Recongure o MySQL com co a opo --with-debug ou --with-debug=full no configure e ento recompile-o. Veja ca a Seo E.1 [Depurando o servidor], Pgina 1079. ca a Congurar o MySQL para depurao faz com que um alocador de memria seja inclu ca o ido para que se possa encontrar alguns erros. Ele tambm fornece muita informao sobre e ca o que est acontecendo. a Voc aplicou todas as ultimas correes para o seu sistema operacional? e co Use a opo --skip-external-locking com o mysqld. Em alguns sistemas, o gerencica ador de bloqueios lockd no funciona de forma apropriada; a opo --skip-externala ca locking faz com que mysqld no utilize bloqueio externo. (Isto signica que voc no a e a pode executar 2 servidores mysqld sobre o memo dado e que voc deve ser cuidadoso e ao utilizar myisamchk, mas pode ser instrutivo tentar a opo como teste). ca Voc tentou mysqladmin -u root processlist quando o mysqld parecia estar rodando e mas no respondia? Algumas vezes o mysqld no est <<comatose>> mesmo quando a a a voc acha que no. O problema pode ser que todas as conexes esto em uso, o pode e a o a haver algum problema interno de bloqueio. mysqladmin processlist normalmente estar apto a fazer uma conexo mesmo nestes casos e pode fornecer informao util a a ca sobre o nmero conexes atuais e os seus estados. u o Execute o comando mysqladmin -i 5 status ou mysqladmin -i 5 -r status ou em uma janela separada para produzir estat isticas enquanto voc executa outras consultas. e Experimente o seguinte: 1. Inicie o mysqld a partir do gdb (ou em outro depurador). Veja Seo E.1.3 [Usando ca gdb no mysql], Pgina 1081. a

Apndice A: Problemas e Erros Comuns e

927

2. Execute o seu script de testes. 3. Imprima o <<backtrace>> e as varveis locais nos 3 n a iveis mais baixos. No gdb voc pode faz-lo com o seguinte comando quando o mysqld falhar dentro do gdb: e e backtrace info local up info local up info local Com gdb voc tambm pode examinar quais threads existem com info threads e e e troca para uma thread espec ica com thread #, onde # a ID da thread. e Tente simular a sua aplicao com um script Perl para forar o MySQL a falhar o ca c mudar o seu comportamento. Envie um relatrio de bug normal. Veja Seo 1.7.1.3 [Relatrio de erros], Pgina 36. o ca o a Seja mais detalhista que o normal. Como o MySQL funciona para muitas pessoas, pode ser que as falhas resultem de algo que exista apenas em seu computador (por exemplo, um erro que relacionado a suas bibliotecas de sistemas em particular). e Se voc tiver um problema em tabelas com registros do tamanho dinmico e voc no e a e a est usando colunas BLOB/TEXT (mas apenas colunas VARCHAR, voc pode tentar alterar a e todas as colunas VARCHAR para CHAR com ALTER TABLE. Isto forara o MySQL a usar c linhas de tamanho xo. Linhas de tamanho xo utilizam um pouco mais de espao c extra, mas so muito mais tolerante a corrompimento. a O cdigo de registro dinmico atual foi usado pela MySQL AB por pelo menos 3 anos o a em qualquer problema, mas por natureza os registro de tamanho dinmico so mais a a propensos a erros, assim pode ser uma boa idia tentar o exposto acima para ver se e ajuda.

A.4.2 Como Recuperar uma Senha de Root Esquecida

Se voc nunca deniu um senha de root para o MySQL, ento o servidor no ir exigir e a a a uma senha para a conexo como root. E recomendado que sempre seja denida uma senha a para cada usurio. Veja Seo 4.3.2 [Segurana], Pgina 229. a ca c a Se voc tiver denido um senha de root, mas a esqueceu, voc pode denir uma nova senha e e com o seguinte procedimento: 1. Finalize o daemon mysqld enviando um kill (no kill -9) para o servidor mysqld. O a pid armazenado em um arquivo .pid, que normalmente est no diretrio de banco e a o de dados do MySQL: shell> kill cat /mysql-data-directory/hostname.pid Voc deve ser o usurio root do Unix ou o mesmo usurio com o qual o mysqld est e a a a executando para fazer isto. 2. Reinicie o mysqld com a opo --skip-grant-tables. ca 3. Dena uma nova senha com o comando mysqladmin password: shell> mysqladmin -u root password mynewpassword

928

MySQL Technical Reference for Version 5.0.0-alpha

4. Agora voc tambm pode parar o mysqld e reinici-lo normalmente, ou apenas carregue e e a a tabela de privilgios com: e shell> mysqladmin -h hostname flush-privileges 5. Depois disto, voc deve estar apto para conectar usando a nova senha. e De forma alternativa, voc pode denir a nova senha usando o cliente mysql: e 1. Finalize e reinicie o mysqld com a opo --skip-grant-tables com descrito acima. ca 2. Conecte ao servidor mysqld com: shell> mysql -u root mysql 3. Dispare os seguintes comandos no cliente mysql: mysql> UPDATE user SET Password=PASSWORD(minhanovasenha) -> WHERE User=root; mysql> FLUSH PRIVILEGES; 4. Depois disto, voc deve estar apto a conectar usando a nova senha. e 5. Voc agora pode parar o mysqld e reinici-lo normalmente. e a

A.4.3 Como o MySQL Trata de Discos Sem Espao c

Quando o ocorre uma condio de disco sem espao, o MySQL faz seguinte: ca c Ele verica a cada minuto para ver se existe espao suciente para escrever a linha c atual. Se houver espao suciente, ele continua como se nada tivesse aconteciso. c A cada 6 minutos ele grava uma entrada no log de arquivo avisando sobre a condio ca de disco cheio. Para aliviar o problema, voc pode realizar as seguintes aes: e co Para continuar, voc s tem que liberar espao suciente em disco para inserir todos e o c os registros. Para abortar a thread, voc deve enviar um mysqladmin kill para a thread. A thread e ser abortada a prxima vez que ele vericar o disco (em 1 minuto). a o Note que outra thread pode estar esperando pelas tabelas que provocaram a condio ca de disco cheio. Se voc tiver diversas theads bloqueadas, matar a que est esperando e a pela condio de disco cheio ir permitir as outras threads de continuar. ca a A exceo ao comportamento acima quando voc usa REPAIR ou OPTIMIZE ou quando os ca e e indices so criados em um grupo antes de um LOAD DATA INFILE ou depois de uma instruo a ca ALTER TABLE. Todos os comandos acima podem usar arquivos temporrios grandes que por si prprios a o poderiam causar grandes problemas para o resto do sistema. Se o MySQL car sem espao c em disco enquanto faz qualquer uma das operaes acima, ele remover o arquivo temporrio co a a grande e indicara que houve falha na tabela (exceto para ALTER TABLE, no qual a tabela antiga car inalterada). a

Apndice A: Problemas e Erros Comuns e

929

A.4.4 Onde o MySQL Armazena Arquivos Temporrios a

O MySQL usa o valor da varivel de ambiente TMPDIR como caminho para o diretria a o que aramzena os arquivos temporrios. Se voc no tiver denido TMPDIR, o MySQL usa a e a o padro do sistema, que normalmente /tmp ou /usr/tmp. Se o sistema de arquivo a e contendo o seu diretrio de arquivo temporrio muito pequeno, voc deve editar o mysqld_ o a e e safe para congurar TMPDIR para apontar para um diretrio onde voc tenha espao suo e c ciente! Voc tambm pode denir o diretrio temporrio usando a opo --tmpdir com e e o a ca mysqld. O MySQL cria todos os arquivos temporrios como arquivos ocultos. Isto assegura que os a arquivos temporrios sero removidos se o mysqld for terminado. A desvantagem de usar a a arquivos ocultos que voc no ver um arquivo temporrio grande que enche o sistema de e e a a a arquivos no qual o diretrio de arquivos temporrios est localizado. o a a Ao ordenar (ORDER BY ou GROUP BY), o MySQL normalmente usa um ou dois arquivos temporrios. O espao em disco mximo que voc precisa : a c a e e (tamanho do que ordenado + sizeof(apontador do banco de dados)) e * nmeros de linhas encontradas u * 2 sizeof(apontados do banco de dados) normalmene 4, mas pode crescer no futuro para e tabelas realmente grandes. Para algumas consultas SELECT, o MySQL tambm cria tabelas SQL temporrias. Elas no e a a so ocultas e tm nomes da forma SQL_*. a e ALTER TABLE cria uam tabela temporria no mesmo diretrio da tabela original. a o Se voc est usando o MySQL 4.1 ou posterior voc pode espalhar a carga entre vrios e a e a discos f isicos denindo --tmpdir com uma lista de caminhos separados por dois pontos : (ponto e v irgula ; no Windows). Eles sero feitos atravs de escalonamento round-robin. a e Nota: Estes caminhos devem ser de diferentes discos fisicos, e no parties diferentes do a co mesmo disco.

A.4.5 Como Proteger ou AlterarHow to Protect or Change the MySQL Socket File /tmp/mysql.sock
Se voc tiver problemas com o fato que de que qualquer um pode deletar o socket de comue nicao /tmp/mysql.sock do MySQL, voc pode, na maioria das verses Unix, protejer o ca e o seu sistema de arquivos /tmp denindo o bit sticky. Conecte como root e faa o seguinte: c shell> chmod +t /tmp Isto protejer o seu sistema de arquivos /tmp para que os arquivos s possam ser deletados a o pelo seus donos ou pelo superusurio (root). a Voc pode vericar se o bit sticky est setado executando ls -ld /tmp. Se o ultimo bit e a de permisso t, o bit est congurado a e a Voc pode alterar o local onde o MySQL usa/coloca o arquivo de socket da seguinte maneira: e Especique o caminho em uma arquivo de opo local ou global. Por exemplo, coloque ca em /etc/my.cnf:

930

MySQL Technical Reference for Version 5.0.0-alpha

[client] socket=path-for-socket-file [mysqld] socket=path-for-socket-file Veja Seo 4.1.2 [Arquivo de opes], Pgina 216. ca co a Especicando isto na linha de comando para o mysqld_safe e na maioria dos clientes com a opo --socket=path-for-socket-file. ca Especique o caminho para o socket na varivel de ambiente MYSQL_UNIX_PORT. a Denindo o caminho com a opo --with-unix-socket-path=path-for-socket-file ca do configure. Veja Seo 2.3.3 [congure options], Pgina 98. ca a Voc pode testar se o socket funciona com o seguinte comando: e shell> mysqladmin --socket=/path/to/socket version

A.4.6 Problemas Com Fuso Horrio a

Se voc tiver problema com SELECT NOW() retornando valores em GMT e no em sua hora e a local, voc ter que denir a varivel de ambinte TZ com a seu fuso horrio atual. Isto deve e a a a ser feito no ambiente no qual o servidor executado, por exemplo, em mysqld_safe ou e mysql.server. Veja Apndice F [Variveis de ambiente], Pgina 1092. e a a

A.5 Assuntos Relacionados a Consultas

A.5.1 Caso-Sensitivito em Pesquisas
Por padro, as pesquisas no MySQL so caso-insensitivo (a menos que haja algum conjunto a a de caracter que nunca seja caso-insensitivo, com czech). Isto signica que se voc buscar e com nome_coluna LIKE a%, voc obter todos os valores de colunas que iniciam com A e a ou a. Se voc quiser fazer esta busca caso-sensitivo, use algo como INSTR(nome_coluna, e "A")=1 para vericar o prexo. Ou use STRCMP(nome_coluna, "A") = 0 se o valor da coluna deve se exatamente "A". Operaes de comparaes simples (>=, >, = , < , <=, ordenando e agrupando) so basedos co co a em cada valor de ordenao do caracter. Caracteres com o mesmo valor de ordenao ca ca (como E, e e ) so tratados como o mesmo caracter! e a Em verses antigas do MySQL, comparaes com LIKE eram feitas com o valor de letra o co maiscula de cada caracter (E == e mas E <> ). Nas verses mais novas, LIKE funciona u e o assim como os outros operadores de comparao. ca Se voc quiser que uma coluna sempre seja tratada de modo caso-sensitivo, declare a como e BINARY. Veja Seo 6.5.3 [CREATE TABLE], Pgina 598. ca a Se voc est usando caracteres Chineses na codicao big5, voc pode tornar todas as e a ca e colunas de caracteres BINARY. Isto funciona porque a ordenao de caracteres de codicao ca ca big5 baseada na ordem do cdigo ASCII. e o

Apndice A: Problemas e Erros Comuns e

931

A.5.2 Problemas Usando Colunas DATE

O formato de um valor DATE YYYY-MM-DD. De acordo com o padro SQL, nenhum outro e a formato permitido. Voc deve usar este formato em expresses UPDATE e na clusula e e o a WHERE de insrtrues SELECT. Por exemplo: co mysql> SELECT * FROM nome_tabela WHERE date >= 1997-05-05; Por convenincia, o MySQL converte automaticamente uma data em um nmero se a data e u usada em um contexto numrico (e vice versa). Ele tambm esperto o bastante para e e e e permitir uma forma de string relaxada em uma atualizao e em uma clusula WHERE ca a que compara uma data a uma coluna TIMESTAMP, DATE, ou DATETIME. (Forma relaxada signica que qualquer caracter de pontuao pode seu usado como separador entre as partes. ca Por exemplo, 1998-08-15 e 1998#08#15 so equivalentes). O MySQL tambm pode a e converter uma string sem separadores (como 19980815), desde que ela faa sentido como c uma data. A data especial 0000-00-00 pode ser armazenada e recuperada como 0000-00-00. Ao usar uma data 0000-00-00 com o MyODBC, ele a converter automaticamente em NULL a em sua verso 2.50.12 e acima, porqie o ODBC no pode tratar este tipo de data. a a Como o MySQL realiza a converso descrita acima, a seguinte instruo funcionar: a ca a mysql> INSERT INTO nome_tabela (idate) VALUES (19970505); mysql> INSERT INTO nome_tabela (idate) VALUES (19970505); mysql> INSERT INTO nome_tabela (idate) VALUES (97-05-05); mysql> INSERT INTO nome_tabela (idate) VALUES (1997.05.05); mysql> INSERT INTO nome_tabela (idate) VALUES (1997 05 05); mysql> INSERT INTO nome_tabela (idate) VALUES (0000-00-00); mysql> SELECT idate FROM nome_tabela WHERE idate >= 1997-05-05; mysql> SELECT idate FROM nome_tabela WHERE idate >= 19970505; mysql> SELECT MOD(idate,100) FROM nome_tabela WHERE idate >= 19970505; mysql> SELECT idate FROM nome_tabela WHERE idate >= 19970505; No entatnto o seguinte no funcionar: a a mysql> SELECT idate FROM nome_tabela WHERE STRCMP(idate,19970505)=0; STRCMP() uma funo string, assim ela converte idate em uma string e realiza um come ca parao de string. Ela no converte 19970505 em uma datae e realiza uma comparaas ca a ca de data. Note que o MySQL faz uma vericao muito limitada da validade da data. Se voc ca e aramazenar uma data incorreto, tal como 1998-2-31, a data invalida ser armazenada. a Como o MySQL empacota a data para armazenamento, ele no pode armazenar qualquer a data dada como j que ela no caberia dentro do buer de resultado. As regras de aceitao a a ca das datas so: a Se o MySQL pode armazenar e recuperar um data dada, a data errada acieta para e colunas DATE e DATETIME. Todos os valores de dia entre 0-31 so aceitos para qualquer data. Isto torna muito a conveniente para plicaes web nas quais voc pede ano, ms e dia em 3 campos diferco e e entes.

932

MySQL Technical Reference for Version 5.0.0-alpha

O campo do dia ou ms pode ser zero. Isto conveniente se voc quiser armazenar e e e uma data de aniversrio em uma coluna DATE e voc no sabea parte da data. a e a Se a data no pode ser convertida para qualquer valor razovel, um 0 armazenado no a a e campo DATE, o qual ser recuperado como 0000-00-00. Isto uma questo tanto de vea e a locidade quanto de convenincia j que acreditamos que a responsabilidade do banco de e a dados recuperar a mesma data que voc armazenou (mesmo se a data no era logicamente e e a correta em todos os casos). Ns pensamos que papel da aplicao vericar as datas, e no o e ca a do servidor.

A.5.3 Problemas com Valores NULL

O conceito do valor NULL uma fonte comum de confuso para os iniciantes em SQL, que e a frequentemente pensa que NULL a mesma coisa que uma string vazia "". Este no o e a e caso! Por exemplo, as seguintes intrues so completamente diferentes: co a mysql> INSERT INTO minha_tabela (telefone) VALUES (NULL); mysql> INSERT INTO minha_tabela (telefone) VALUES (""); Ambas as intrues inserem um valor na coluna telefone, mas a primeira insere um valor co NULL e a segunda insere uma string vazia. O signicado do primeiro pode ser considerado como telefone no conhecido e o signicado da segunda pode ser considerado como ela a e no tem telefone. a Em SQL, o valor NULL sempre falso em coparao a qualquer outro valor, mesmo NULL. e ca Uma expresso que contm NULL sempre produz um valor NULL a menos que seja indicado a e na documentao para os operadores e funes involvidos na expresso. Todas as colunas ca co a no seguinte exemplo retornam NULL: mysql> SELECT NULL,1+NULL,CONCAT(Invisible,NULL); Se voc quiser procurar por uma coluna cujo valor NULL, voc np pode usar o teste =NULL. e e e a A seguinte instruo no retorna nenhuma linha, pois expr = NULL FALSO, para qualquer ca a e expresso: a mysql> SELECT * FROM minha_tabala WHERE phone = NULL; Para procurar por valores NULL, voc deve usar o teste IS NULL. A seguir mostramos como e encontrar o nmuro de telefone NULL e o nmero de telefone vazio: e u mysql> SELECT * FROM minha_tabela WHERE telefone IS NULL; mysql> SELECT * FROM minha_tabela WHERE telefone = ""; Note que voc pode adicionar um e indice a uma coluna que tenha valores NULL apenas se voc estiver usando o MySQL verso 3.23.2 ou mais novo e estiver usando tipos de tabelas e a NyISAM, InnoDB ou BDB. Em verses anteriores e com outros tipos de tabelas, voc deve o e declara tais colunas como NOT NULL. Isto tambm signica que voc ento no poder inserir e e a a a NULL em uma coluna indexada. Ao ler dados com LOAD DATA INFILE, colunas vazias so atualizadas com . Se voc quiser a e um valor NULL em uma coluna, voc deve usar \N no arquivo texto. A palavra literal e NULL tambm pode ser usada em algumas circunstncias. Veja Seo 6.4.8 [LOAD DATA], e a ca Pgina 588. a

Apndice A: Problemas e Erros Comuns e

933

Ao usar ORDER BY, valores NULL so apresentados primeiro, ou por ultimo se voc especicar a e DESC para armazenar em ordem decrescente. Exceo: Nos MySQL 4.0.2 at 4.0.10, se voc ca e e armazenar em ordem decrescente usando DESC, valores NULL so apresentados por ultimo. a Ao usar GROUP BY, todos os valores NULL so considerados iguais. a Funes de agrupamento (resumo) como COUNT(), MIN() e SUM() ignoram valores NULL. co A exceo a isto COUNT(*), que conta linhas e no colunas individuais. Por exemplo, ca e a a seguinte instruo deve produzir duas contagens. A primeira a contagem do nmero ca e u de linhas na tabela e a segunda a contagem do nmero de valores diferentes de NULL na e u coluna age: mysql> SELECT COUNT(*), COUNT(age) FROM person; Para ajudar com o tratamento de NULL, voc pode usar os operadores IS NULL e IS NOT e NULL e a funo IFNULL(). ca Para alguns tipos de colunas, valores NULL so tratados de forma especial, Se voc inserir a e NULL na primeira coluna TIMESTAMP de uma tabela, a data e hora atual sero inseridos. Se a voc isere NULL em uma coluna AUTO_INCREMENT, o prximo nmero na sequncia inserida. e o u e e

A.5.4 Problemas com alias

Voc pode usar um alias para referir a uma coluna no GROUP BY, ORDER BY, ou na parte e HAVING. Aliases podem ser usados para dar as colunas nomes melhores: SELECT SQRT(a*b) as rt FROM nome_tabela GROUP BY rt HAVING rt > 0; SELECT id,COUNT(*) AS cnt FROM nome_tabela GROUP BY id HAVING cnt > 0; SELECT id AS "Customer identity" FROM nome_tabela; Note que o padro SQL no permite que voc se rera a uma alias na clusula WHERE. a a e a Isto porque quando o cdigo WHERE executado o valor da coluna ainda no pode ser e o e a determinado. Por exemplo, a seguinte consulta ilegal: e SELECT id,COUNT(*) AS cnt FROM nome_tabela WHERE cnt > 0 GROUP BY id; A instruo WHERE executada para determinar quais linhas devem ser inclu ca e idas na parte GROUP BY enquanto HAVING usado para decidir quais linhas o conjunto de resultados deve e usar.

A.5.5 Deletando Linhas de Tabelas Relacionadas

Como o MySQL no suporta subconsultas (antes da verso 4.1), enm o uso de mais de uma a a tabela na instruao DELETE (antes da verso 4.0), voc deve usar a seguinte abordagem para c a e deletar linhas de 2 tabelas relacionadas: 1. SELECT as linhas baseado em alguma condio WHERE na tabela principal. ca 2. DELETE as linhas da tabela princiapl basada nas mesmas condies. co 3. DELETE FROM tabela_relacionada WHERE coluna_relacionada IN (linhas_ selecionadas). Se o nmero total de caracteres na consulta com colunas_relacionadas maior que u e 1,048,576 (o valor padro de max_allowed_packet, voc deve separ-lo em duas partes a e a menores e executar mltiplas instrues DELETE. Voc provavelmente obter o DELETE mais u co e a

934

MySQL Technical Reference for Version 5.0.0-alpha

rpido apenas delatando 100-1000 ids de colunas_relacionadas por consulta se colunas_ a relacionadas um e indice. Se colunas_relacionadas no um a e indice, a velocidadi e independente do nmero de argumentos na clusula IN. u a

A.5.6 Resolvendo Problemas Com Registros No Encontrados a

If you have a complicated query that has many tables and that doesnt return any rows, you should use the following procedure to nd out what is wrong with your query: 1. Teste a consulta com EXPLAIN e verique se voc pode encontrar alguma coisa que est e a errada. Veja Seo 5.2.1 [EXPLAIN], Pgina 424. ca a 2. Selcione apenas aqueles campos que so usados na clusula WHERE. a a 3. Remova uma tabela por vez da consulta at que ela retorne alguns registros. Se as e tabelas so grandes, uma boa idia usar LIMIT 10 com a consulta. a e e 4. Faa um SELECT da coluna encontrou um registro com a tabela que foi removido por c ultima da consulta. 5. Se voc estiver comparando colunas FLOAT ou DOUBLE com nmeros que tenham decie u mais, voc no pode usar =. Este problema comum na maioria das linguagens de e a e computadores porque valores de ponto-utuante no so valores exatos. Na maioria a a dos casos, alterar o FLOAT por DOUBLE corrigir isto. Veja Seo A.5.7 [Problemas com a ca oat], Pgina 934. a 6. Se voc ainda no pode imaginar o que est errado, crie um teste m e a a inimo que possa ser executado com mysql test < query.sql e possa mostrar seus problemas. Voc e pode criar um arquivo de teste com mysqldump --quick banco_de_dados tabela > query.sql. Abra o arquivo em um editor, remova algumas linhas inseridas (se houver muitas) e adicione sua instruo select no m do arquivo. ca Teste se voc ainda est tendo problemas fazendo: e a shell> mysqladmin create test2 shell> mysql test2 < query.sql Envie o arquivo de teste usando mysqlbug para lista de email gerais do MySQL. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a

A.5.7 Problemas com Comparao de Ponto Flutuante ca

Nmeros de ponto utuante geram confuses algumas vezes, pois estes nmeros no so u o u a a armazenados como valores exatos dentro da arquitetura dos computadores. O que pode ser ver na tela no o valor exato do nmero. a e u Tipos de campos FLOAT, DOUBLE e DECIMAL so assim. a CREATE TABLE t1 (i INT, d1 DECIMAL(9,2), d2 DECIMAL(9,2)); INSERT INTO t1 VALUES (1, 101.40, 21.40), (1, -80.00, 0.00), (2, 0.00, 0.00), (2, -13.20, 0.00), (2, 59.60, 46.40), (2, 30.40, 30.40), (3, 37.00, 7.40), (3, -29.60, 0.00), (4, 60.00, 15.40), (4, -10.60, 0.00), (4, -34.00, 0.00), (5, 33.00, 0.00), (5, -25.80, 0.00), (5, 0.00, 7.20), (6, 0.00, 0.00), (6, -51.40, 0.00);

Apndice A: Problemas e Erros Comuns e

935

mysql> SELECT i, SUM(d1) AS a, SUM(d2) AS b -> FROM t1 GROUP BY i HAVING a <> b; +------+--------+-------+ | i | a | b | +------+--------+-------+ | 1 | 21.40 | 21.40 | | 2 | 76.80 | 76.80 | | 3 | 7.40 | 7.40 | | 4 | 15.40 | 15.40 | | 5 | 7.20 | 7.20 | | 6 | -51.40 | 0.00 | +------+--------+-------+ O resultado est correto. Embora parea que os primeiros cinco registros no devessem a c a passar no teste de comparao, eles deviam porque a diferena entre o nmero mostrado ca c u est na dcima casa decimal ou depende da arquitetura do computador. a e O problema no pode ser resolvido usando ROUND() (ou funo similar), porque o resultado a ca ainda um nmero de ponto utuante. Exemplo: e u mysql> SELECT i, ROUND(SUM(d1), 2) AS a, ROUND(SUM(d2), 2) AS b -> FROM t1 GROUP BY i HAVING a <> b; +------+--------+-------+ | i | a | b | +------+--------+-------+ | 1 | 21.40 | 21.40 | | 2 | 76.80 | 76.80 | | 3 | 7.40 | 7.40 | | 4 | 15.40 | 15.40 | | 5 | 7.20 | 7.20 | | 6 | -51.40 | 0.00 | +------+--------+-------+ E assim que o nmero da coluna a se parece: u mysql> SELECT i, ROUND(SUM(d1), 2)*1.0000000000000000 AS a, -> ROUND(SUM(d2), 2) AS b FROM t1 GROUP BY i HAVING a <> b; +------+----------------------+-------+ | i | a | b | +------+----------------------+-------+ | 1 | 21.3999999999999986 | 21.40 | | 2 | 76.7999999999999972 | 76.80 | | 3 | 7.4000000000000004 | 7.40 | | 4 | 15.4000000000000004 | 15.40 | | 5 | 7.2000000000000002 | 7.20 | | 6 | -51.3999999999999986 | 0.00 | +------+----------------------+-------+ Dependendo da arquitetura do computador voc pode ou no ver resultados similares. Cada e a CPU pode avaliar um nmere de ponto utuante de forma diferente. Por exemplo, em u

936

MySQL Technical Reference for Version 5.0.0-alpha

alguma mquinas voc pode obter resultados corretos multiplicando ambos argumentos a e por 1, como no exemplo a seguir. AVISO: NUNCA CONFIE NESTE METODO EM SUAS APLICACOES, ESTE E UM EXEMPLO DE UM METODO ERRADO!!! mysql> SELECT i, ROUND(SUM(d1), 2)*1 AS a, ROUND(SUM(d2), 2)*1 AS b -> FROM t1 GROUP BY i HAVING a <> b; +------+--------+------+ | i | a | b | +------+--------+------+ | 6 | -51.40 | 0.00 | +------+--------+------+ A razo pela qual o mtodo acima parece funcionar que na mquina onde o teste foi a e e a realizado, a CPU de aritimtica de ponto utuante realizada arredondando nmeros para e e u serem iguais, mas no h nenhuma regra que qualquer CPU deva fazer assim, ento isto a a a no convel. a e a O modo correto de fazermos comparaes de ponto utuante primeiro decidir qual a co e e tolerncia desejada entre os nmeros e ento fazer a comparao com o nmero tolerado. a u a ca u Por exemplo, se ns concordarmos que nmeros de ponto utuante devem ser considerados o o u mesmo, se eles forem o mesmo com preciso de quatro casas deciamis (0.0001), a comparao a ca deve ser feita assim: mysql> SELECT i, SUM(d1) AS a, SUM(d2) AS b FROM t1 -> GROUP BY i HAVING ABS(a - b) > 0.0001; +------+--------+------+ | i | a | b | +------+--------+------+ | 6 | -51.40 | 0.00 | +------+--------+------+ 1 row in set (0.00 sec) E vice-versa, se ns quisermos obter registros onde os nmeros so o mesmo, o teste seria: o u a mysql> SELECT i, SUM(d1) AS a, SUM(d2) AS b FROM t1 -> GROUP BY i HAVING ABS(a - b) < 0.0001; +------+-------+-------+ | i | a | b | +------+-------+-------+ | 1 | 21.40 | 21.40 | | 2 | 76.80 | 76.80 | | 3 | 7.40 | 7.40 | | 4 | 15.40 | 15.40 | | 5 | 7.20 | 7.20 | +------+-------+-------+

A.6 Assuntos Relacionados ao Otimizador

O MySQL usa um otimizador baseado no custo para descobrir o melhor modo de resolver uma consulta. Em muitos casos o MySQL pode calcular a melhor consulta poss mas em ivel

Apndice A: Problemas e Erros Comuns e

937

alguns casos o MySQL no tem informao suciente sobre os dados e precisa fazer alguns a ca palpites sobre os dados. Esta seo do manual direcionada para os casos nos quais o MySQL no faz isto corretaca e a mente. A ferramenta que se tem dispon para ajudar o MySQL a fazer as coisas certas so: ivel a EXPLAIN. Veja Seo 5.2.1 [EXPLAIN], Pgina 424. ca a ANALYZE TABLE. Veja Seo 4.6.2 [ANALYZE TABLE], Pgina 298. ca a USE INDEX, FORCE INDEX and IGNORE INDEX. Veja Seo 6.4.1 [SELECT], Pgina 562. ca a STRAIGHT JOIN a n de tabela e global. Veja Seo 6.4.1 [SELECT], Pgina 562. ivel ca a Congurar variveis espec a icas de threads. Veja Seo 4.6.8.4 [SHOW VARIABLES], ca Pgina 309. a

A.6.1 Camo evitar o varredura da tabela,,,

EXPLAIN mostrar ALL na coluna type quando o MySQL usa uma busca na tabela para a resolver uma consulta. Isto acontece normalmente quando: A tabela to pequena que mais rpido fazer uma varredura na tabela que uma e a e a busca nas chaves. Isto um caso comum para tabelas com menos de 10 linhas e um e tamanho de linha pequeno. No h nenhum restrio utilizvel na clusula ON ou WHERE para colunas indexadas. a a ca a a Voc est comparando colunas indexadas com constantes e o MySQL calculou (baseado e a na rvore de a indices) que a constante cobre uma parte muito grande da tabela e uma busca na tabela seria mais rpido.. Veja Seo 5.2.4 [Where optimizations], Pgina 432. a ca a Voc est usando uma chave com baixa cardinalidade (= muitos registros coincidentes) e a atravs de outra coluna. O MySQL assumir neste caso que usar a chave far muitas e a a pesquisas de chave e neste caso a varredura da tabela seria mais rpido. a O que voc pode fazer para evita uma busca errada em tabelas grandes : e e Use ANALYZE TABLE para a tabela em quasto atualizar a distribuio das chaves.. Veja a ca Seo 4.6.2 [ANALYZE TABLE], Pgina 298. ca a Use FORCE INDEX para a tabela em questo para dizer ao MySQL que uma busca na a tabela muito cara comparado com usar um dos e indices dados. Veja Seo 6.4.1 ca [SELECT], Pgina 562. a SELECT * FROM t1,t2 force index(index_for_column) WHERE t1.column=t2.column; Inicie o mysqld com --max-seeks-for-key=1000 ou faa SET MAX_SEEKS_FOR_ c KEY=1000 para dizer ao otimizador que nenhuma busca de chave far mais que 1000 a pesquisas nas chaves.

A.7 Assuntos Relacionados a Denioes de Tabelas c

938

MySQL Technical Reference for Version 5.0.0-alpha

A.7.1 Problemas com ALTER TABLE.

ALTER TABLE altera uma tablea para o conjunto de caracteres atual. Se voc obter um erro e de chave duplicada durante ALTER TABLE, ento a causa que o novo conjunto de caracteres a e mapeia duas chaves para o mesmo valor ou que a tabela est corrompida, caso no qual voc a e deve fazer um REPAIR TABLE na tabela. Se ALTER TABLE nalizar com um erro com este: Error on rename of ./database/name.frm to ./database/B-a.frm (Errcode: 17) o problema pode ser que o MySQL falhou em um ALTER TABLE anterior e existe uma tabela antiga chamada A-algumacoisa ou B-algumacoisa. Neste caso, v at o diretrio de a e o dados do MySQL e delete todos os campos que tenham nomes iniciando com A- ou B-. (Voc pode quere mov-los para algum lugar em vez de delet-los.) e e a ALTER TABLE funciona do seguinte modo: Cria uma nova tabela chamada A-xxx com as alteraes pedidas. co Todos os registros da tabela antiga so copiadas para A-xxx. a A tabela antiga renomeada com B-xxx. e A-xxx renomeada com o nome da sua tabela antiga. e B-xxx deletada. e Se algo der errado com a operao de renomeao, o MySQL tenta desfazer a mudana. ca ca c Se algo der seriamente errado (isto no deve acontecer, claro), o MySQL pode deixar a a e tabela antiga como B-xxx, mas uma simples renomeao no n do sistema deve trazer ca ivel o seus dados de volta.

A.7.2 Como Alterar a Ordem das Colunas em Uma Tabela

O ponto principal do MySQL abstrair a aplicao do formato de armazenamento dos e ca dados. Voc sempre deve especicar a ordem na qual voc deseja recuperar os dados. Por e e exemplo: SELECT nome_coluna1, nome_coluna2, nome_coluna3 FROM nome_tabela; retornar na ordem nome_coluna1, nome_coluna2, nome_coluna3, enquanto: a SELECT nome_coluna1, nome_coluna3, nome_coluna2 FROM nome_tabela; retornar colunas na ordem nome_coluna1, nome_coluna3, nome_coluna2. a Se voc quiser alterar a ordem das colunas, voc pode fazer o seguinte: e e 1. Crie uma nova abela com as colunas na ordem correta. 2. Execute INSERT INTO tabela_nova SELECT campos-na-ordem-de-tabela_nova FROM tabela_antiga. 3. Delete ou renomeie tabela_antiga. 4. ALTER TABLE tabela_nova RENAME tabela_antiga. Em uma aplicao, voc nunca deve usar SELECT * e recuperar as colunas baseado em suas ca e posies, pois a ordem e a posio nas quais as colunas so retornadas no permanecer co ca a a a a mesma se voc adicionar/mover/deletar colunas. Uma simples alterao na estrutura de e ca seu banco de dados causaria uma falha em sua aplicao. E claro que SELECT * muito ca e em testes de cosultas. mais cabivel

Apndice A: Problemas e Erros Comuns e

939

A.7.3 Problemas com TEMPORARY TABLE

Segue uma lista de limitaes com TEMPORARY TABLES. co Uma tabela temporria s pode ser do tipo HEAP, ISAM, MyISAM, MERGE, ou InnoDB. a o Voc no pode usar tabelas temporrias mais que uma vez na mesma consulta. Por e a a exemplo, o seguinte no funciona. a mysql> SELECT * FROM tabela_temporria, tabela_temporria AS t2; a a Voc no pode usar RENAME em uma tabela temporria (TEMPORARY). Note que ALTER e a a TABLE nome_orig RENAME nome_novo funciona!

940

MySQL Technical Reference for Version 5.0.0-alpha

Apndice B Contribuio de Programas e ca

Muitos usurios do MySQL tm contribu com muitas ferramentas de suporte e add-ons a e ido uteis. Uma lista de alguns programas dispon iveis no website do MySQL (ou qualquer) mirror e apresentada aqui. Voc tambm pode visitar nosso nossa lista online de programas relacionados ao MySQL e e em http://www.mysql.com/portal/software/. As facilidades da comunidade tambm e permitem suas contribuies! co Se voc quiser construir suporte ao MySQL para interface Perl DBI/ DBD, voc deve buscar e e os arquivos Data-Dumper, DBI e DBD-mysql e instal-los. Veja Seo 2.7 [Suporte Perl], a ca Pgina 164. a Note: Os programas listados aqui podem ser baixados e usados livremente. Os direitos autorias pertencem aos seus respectivos donos. Por favor, veja a documentao de cada produto ca para maiores detalhes sobre licenciamento e termos. A MySQL AB no assume responsa abilidade sobre a validade das informaes neste cap co itulo ou sobre a operao apropriada ca dos programas listados aqui.

B.1 APIs
Perl Modules http://www.mysql.com/Downloads/Contrib/KAMXbase1.2.tar.gz Converte arquivos .dbf em tabelas do MySQL. Mdulo Perl escrito por Pratap o Pereira pereira@ee.eng.ohio-state.edu, expandido por Kevin A. McGrail kmcgrail@digital1.peregrinehw.com. Este conversor pode tratra campos MEMO. http://www.mysql.com/Downloads/Contrib/HandySQL-1.1.tar.gz HandySQL uma mdulo de acesso ao MySQL. Ele oferece uma interface C embutida em Perl e o e aproximadamente 20% mais rpida que o DBI regular. e a OLEDB http://www.mysql.com/Downloads/Win32/MyOLEDB3.exe Pacote de instalao ca MyOLEDB 3.0 da SWSoft. http://www.mysql.com/Downloads/Win32/mysql-oledb-3.0.0.zip Fonte do MyOLEDB 3.0. http://www.mysql.com/Downloads/Win32/MySamples.zip Exemplos e documentao do MyOLEDB. ca http://www.mysql.com/Downloads/Win32/MyOLEDB.chm Arquivos de ajuda do MyOLEDB. http://www.mysql.com/Downloads/Win32/libmyodbc.zip Biblioteca esttica a do MyODBC usada para construir o MyOLEDB. Baseada no cdigo MyODBC. o C++ http://www.mysql.com/Downloads/Contrib/mysql-c++-0.02.tar.gz Biblioteca wrapper C++ dp MySQL. Por Roland Haenel, rh@ginster.net.

Apndice B: Contribuio de Programas e ca

941

http://www.mysql.com/Downloads/Contrib/MyDAO.tar.gz API C++ do MySQL. Por Satish spitfire@pn3.vsnl.net.in. Inspirado pela API C++ de Roland Haenel e pela biblioteca MyC de Ed Carp. http://www.mysql.com/products/mysql++/ API C++ do MySQL (mais que uma bibliteca wrapper). Originalmente criado por kevina@clark.net. Mantido por Sinisa na MySQL AB. http://nelsonjr.homepage.com/NJrAPI/ Um biblioteca independente de banco de dados em C++ que suporta MySQL. Delphi http://www.mysql.com/Downloads/Contrib/DelphiMySQL2.zip Delphi para libmysql.dll, por bsilva@umesd.k12.or.us. Interface

http://www.mysql.com/Downloads/Contrib/Udmysql.pas Um wrapper para libmysql.dll para uso com Delphi. Por Reiner Sombrowsky. http://www.fichtner.net/delphi/mysql.delphi.phtml Uma interface Delphi para o MySQL, com cdigo fonte. Por Matthias Fichtner. o http://www.productivity.org/projects/tmysql/ TmySQL, uma biblioteca para utilizar o MySQL com Delphi. https://sourceforge.net/projects/zeoslib/ Zeos Library um conjunto e de componentes de banco de dados para MySQL, PostgreSQL, Interbase, MS SQL, Oracle e DB/2. Tambm inclui ferrementas de desenvolvimento tais como e Database Explorer e Database Designer. http://www.mysql.com/Downloads/Contrib/JdmMysqlDriver-0.1.0.tar.gz Um driver da VisualWorks 3.0 Smalltalk para MySQL. Por joshmiller@earthlink.net. http://www.mysql.com/Downloads/Contrib/Db.py caching. Por gandalf@rosmail.com. Mdulo o python com

http://www.mysql.com/Downloads/Contrib/MySQLmodule-1.4.tar.gz Interface python para MySQL. Por Joseph Skinner joe@earthlight.co.nz. Modicado por Joerg Senekowitsch senekow@ibm.net. http://www.mysql.com/Downloads/Contrib/mysqltcl-1.53.tar.gz Interface Tcl para o MySQL. Baseado no msqltcl-1.50.tar.gz. Para a verso 2.0 e a mais informaes, veja http://www.xdobry.de/mysqltcl/. co http://www.mysql.com/Downloads/Contrib/MyC-0.1.tar.gz Uma API com Visual Basic por Ed Carp. http://www.mysql.com/Downloads/Contrib/Vdb-dflts-2.1.tar.gz Esta e uma nova verso de um conjunto de bibliotecas utilitrias com a inteno de a a ca fornecer uma interface genrica para o mecanismo de banco de dados SQL para e que sua aplicao se torne de 3 camadas. A vantagem que voc pode facilmente ca e e trocar o mecanismo de banco de dados implementando um arquvo para o novo backend sem qualquer alterao em sua aplicao. Por damian@cablenet.net. ca ca http://www.mysql.com/Downloads/Contrib/DbFramework-1.10.tar.gz DbFramework uma coleo de classes para manipular o banco de dados MySQL. e ca As classes so baseadas no CDIF Data Model Subject Area. Por Paul Sharpe a paul@miraclefish.com.

942

MySQL Technical Reference for Version 5.0.0-alpha

http://www.mysql.com/Downloads/Contrib/pike-mysql-1.4.tar.gz Modulo MySQL para pike. Para uso com o servidor web Roxen. http://www.mysql.com/Downloads/Contrib/squile.tar.gz Mdulo o para guile que permite ao guile interagir com banco de dados SQL. Por Hal Roberts. http://www.mysql.com/Downloads/Contrib/stk-mysql.tar.gz Interface para o Stk. Stk o Tk widgets com Scheme em vez do Tcl. Por Terry Jones. e http://www.mysql.com/Downloads/Contrib/eiffel-wrapper-1.0.tar.gz Eiffel wrapper por Michael Ravits. http://www.mysql.com/Downloads/Contrib/SQLmy0.06.tgz FlagShip Replaceable Database Driver (RDD) para MySQL. Por Alejandro Fernandez Herrero. A homepage do Flagship RDD http://www.fship.com/rdds.html. e http://www.mysql.com/Downloads/Contrib/mydsn-1.0.zip Binrio e Fonte a para mydsn.dll. mydsn deve ser usado para construir e remover o arquivo de registro DSN para o driver MyODBC am aplicaes Coldfusion. Por Miguel co Angel Solrzano. o http://www.mysql.com/Downloads/Contrib/MySQL-ADA95_API.zip Uma interface ADA95 para a API do MySQL. Por Francois Fabien. http://www.mysql.com/Downloads/Contrib/MyTool-DLL_for_VB_and_ MySQL.zip Uma DLL com a API C do MySQL para Visual Basic. Por Ken Menzel kenm@icarz.com. http://www.mysql.com/Downloads/Contrib/MYSQLX.EXE Objeto ActiveX do MySQL para acesso direto do ser servidor MySQL atravs do IIS/ASP, VB, e VC++ evitando o ODBC que mais lento. Totalmente atualizvel, multi-thread e a com suporte total para todos os tipos de campos do MySQL (verso 2001.1.1). a Por SciBit http://www.scibit.com/. http://www.fastflow.it/mylua/ Site do MyLUA; como utilizar a linguagem LUA para escrever PROCEDURE MySQL que podem ser carregados em tempo de execuo. ca http://www.mysql.com/Downloads/Contrib/lua-4.0.tar.gz LUA 4.0 http://www.mysql.com/Downloads/Contrib/mylua-3.23.32.1.tar.gz Correo para o MySQL 3.23.32 para usar o LUA 4.0. Por Cristian Giussani. ca http://www.mysql.com/Downloads/Contrib/patched_myodbc.zip Correo ca (para suporte ao Omniform 4.0) para o driver MyODBC. Por Thomas Thaele tthaele@papenmeier.de

B.2 Conversores
http://www.mysql.com/Downloads/Contrib/mssql2mysql.txt Conversor do MS-SQL para MySQL. Por Michael Koer. O site do mssql2mysql e http://www.kofler.cc/mysql/mssql2mysql.html. http://www.mysql.com/Downloads/Contrib/dbf2mysql-1.14.tar.gz Conversor de aruivos .dbf em tabelas MySQL. Por Maarten Boekhold (boekhold@cindy.et.tudelft.nl), William Volkman, e Michael Widenius. Este conversor inclui suporte rudimentar a campos MEMO para somente-leitura.

Apndice B: Contribuio de Programas e ca

943

http://www.mysql.com/Downloads/Contrib/dbf2mysql-1.13.tgz Converte arquivos .dbf em tabelas MySQL. Por Maarten Boekhold, boekhold@cindy.et.tudelft.nl, e Michael Widenius. Este conversor no a pode tratar campos MEMO. http://www.mysql.com/Downloads/Contrib/dbf2mysql.zip Converte arquivos FoxPro .dbf em tabelas MySQL no Windows. Por Alexander Eltsyn, ae@nica.ru ou ae@usa.net. http://www.mysql.com/Downloads/Contrib/dbf2sql.zip Programa pequeno e simples que pode lhe ajudar a transportar os dados de uma tabela foxpro em uma tabela MySQL. Por Danko Josic. http://www.mysql.com/Downloads/Contrib/dump2h-1.20.gz Converte a sa ida de um mysqldump em um arquivo de cabealho (.h) do C. Por Harry Brueckner, c brueckner@mail.respublica.de. http://www.mysql.com/Downloads/Contrib/exportsql.txt Um script parecido com access_to_mysql.txt, exceto que ele totalmente congurvel, tem melhor e a converso de tipo (incluindo deteco de campos TIMESTAMP), fornece avisos e a ca sugestes enquanto converte, coloca todos os caracteres especiais em dados binrios o a e texto e assim por diante. Tambm converte para o mSQL v1 e v2, e no tem custo. e a Veja http://www.cynergi.net/exportsql/ para a ultima verso. Por Pedro Freire, a support@cynergi.net. Note: N`o funciona com Access 2.0! a http://www.mysql.com/Downloads/Contrib/access_to_mysql.txt Cole esta funo em um mdulo Access de um banco de dados que possua as tabelas que voc ca o e deseja exportar. Veja tambm o exportsql. Por Brian Andrews. Nota: No funciona e a com Access 2.0! http://www.mysql.com/Downloads/Contrib/importsql.txt Um script que faz exatamente o contrrio do exportsql.txt. Ou seja, ele importa dados do MySQL a para um banco de dado no Access via ODBC. Ele bem acess e ivel quando combinado com exportsql, pois ele deixa voc uar o Access para todo desenvolvimento e e administrao do BD, e sincroniza com o seu servidor MySQL. Sem custos. Veja ca http://www.netdive.com/freebies/importsql/ para atualizaes. Criado por Lauco rent Bossavit da NetDIVE. Nota: no funciona com Access2! a http://www.mysql.com/Downloads/Contrib/mdb2sql.bas Conversor do Access97 para MySQL por Moshe Gurvich. http://www.mysql.com/Downloads/Contrib/msql2mysqlWrapper-1.0.tgz Um wrapper C do mSQL para MySQL. Por alfred@sb.net http://www.mysql.com/Downloads/Contrib/sqlconv.pl Um script simples que pode ser usado para copiar campos de uma tabela MySQL para outro, em blocos. Basicamente voc pode rodar mysqldump e canaliz-lo para o script sqlconv.pl. e a O script analisar a sa do mysqldump e rearranjar os campos para que sejam a ida a inseridosd em uma nova tabela. Um exemplo quando voc quer criar uma nova e e tabela em local diferente do qual voc est trabalhando, mas a tabela apenas um e a e pouco diferente (isto - campos em ordem diferente, etc.). Por Steve Shreeve. e http://www.mysql.com/Downloads/Contrib/oracledump Progrma Perl para converter bancos de dados Oracle em MySQL. Tem o mesmo formato de sa do ida mysqldump. Por Johan Andersson.

944

MySQL Technical Reference for Version 5.0.0-alpha

http://www.mysql.com/Downloads/Contrib/excel2mysql Programa Perl para importar pastas de trabalho do Excel em um banco de dados MySQL. Por Stephen Hurd shurd@sk.sympatico.ca http://www.mysql.com/Downloads/Contrib/T2S_100.ZIP. Programa Windos para converter arquivos textos em banco de dados MySQL. Por Asaf Azulay.

B.3 Utilitrios a
http://worldcommunity.com/opensource/utilities/mysql_backup.html MySQL Backup um script de backup para o MySQL. Por Peter F. Brown. e http://www.mysql.com/Downloads/Contrib/mysql_watchdog.pl Monitora a daemon do MySQL par poss iveis travamentos. Por Yermo Lamers, yml@yml.com. http://www.mysql.com/Downloads/Contrib/mysql_structure_dumper.tar.gz http://www.mysql.com/Downloads/Contrib/mysql_structure_dumper.tgz Exibe a estrutura de toda a tabela em um banco de dados. Por Thomas Wana. http://www.mysql.com/Downloads/Contrib/mysqlsync. Um script Perl para manter cpias remotas de uma banco de dados MySQL em sioncronia com uma cpia master o o central. Por Mark Jeftovic. markjr@easydns.com. http://www.mysql.com/Downloads/Contrib/MySQLTutor-0.2.tar.gz. MySQLTutor. Um tutorial MySQL para iniciantes. http://www.mysql.com/Downloads/Contrib/mysql_replicate.pl Programa Perl que trata replicaes. Por elble@icculus.nsg.nwu.edu co http://www.mysql.com/Downloads/Contrib/dbcheck Script Perlque tira backup de uma tabela antes de executar isamchk nelas. Por Elizabeth. http://www.mysql.com/Downloads/Contrib/mybackup. http://www.mswanson.com/mybackup (home page do mybackup) Wrapper para o mysqldump para backup de todos os bancos de dados. Por Marc Swanson. http://www.mysql.com/Downloads/Contrib/mdu.pl.gz Exibe o armazenamento usado em um banco de dados MySQL.

Apndice C: Colaboradores do MySQL e

945

Apndice C Colaboradores do MySQL e

Este apndice lista o desenvolvedores, coolaboradores e responsveis por suporte que ajue a daram a fazer o MySQL o que ele hoje. e

C.1 Desenvolvedores do MySQL

Estes so os desenvolvedores que que so ou foram empregaos pela MySQL AB para trabalhar a a no programa de banco de dados MySQL, listado na ordem em que comearam a trabalhar para c ns. Na sequncia de cada um dos desenvolvedores est uma pequena lista de tarefas pelas o e a quais o desenvolvedor resposvel ou as realizaes de cada um. Todos os desenvolvedores e a co esto envovidos no suporte. a Michael (Monty) Widenius Desenvolvedor l ider e prioncipal autor do servidor MySQL (mysqld). Novas funes para a biblioteca de string. co A maioria das bibliotecas mysys. As biblotecas ISAM e MyISAM (tratamento do arquivo de indices em rvore-B a e compactao do ca indice e formato de regitsros diferentes). A biblioteca HEAP. Um sistema de tabela em memria com nosso hashing o totalmente dinmico. Em uso desde 1981 e publicado em 1984. a O programa replace (gastou bastante tempo nele, bem LEGAL!). e MyODBC, o driver ODBC para Windows95. Correo de bugs nas MIT-pthreads para faz-la funcionar com o Servidor ca e MySQL. E tambm Unireg, uma ferramenta com muitas utilidades. e Portabilidade de ferramentas mSQL como msqlperl, DBD/DBI, e DB2mysql. A maioria dos programas crash-me e a fundao do benchmarks do ca MySQL. David Axmark Principal escritor inicial do Manual de Referncia, incluindo melhoras no e texi2html. Atualizao automatica do manual no site. ca Suporte incial ao Autoconf, Automake, e Libtool. Licenciamento. Partes de todos os arquivos textos. (Hoje em dia apenas o README e deixado. O reto inclu no manual.) e ido Varios testes de novos recursos. Nosso expert em assuntos legais de Software Livre. Responsvel pela lista de email (que nunca tem tempo para faz-lo correa e tamente...). Nossa portabilidade do cdigo original (mais de 10 anos). Hoje em dia o apenas algumas partes do mysys foram deixadas.

946

MySQL Technical Reference for Version 5.0.0-alpha

Algum para o Monty chamar no meio da noite que ele percebe que aquele e novo recurso funciona. Chefe "Open Sourcerer" (relaes na comunidade MySQL). co Jani Tolonen mysqlimport Diversas extenses dos clientes de linha de comando. o PROCEDURE ANALYSE() Sinisa Milivojevic Compactao (com zlib) no protocolo cliente/servidor. ca Hashing perfeito para fase do analisador lexicogrco. a INSERT multi-linhas Opo -e domysqldump ca LOAD DATA LOCAL INFILE Opo SQL_CALC_FOUND_ROWS do SELECT ca Opo --max-user-connections=... ca net_read e net_write_timeout GRANT/REVOKE e SHOW GRANTS FOR Novo protocolo cliente/servidor para 4.0 UNION na verso 4.0 a DELETE/UPDATE multi-tabelas Tabelas derivadas na verso 4.1 a Gernciamento de recursos do usurio e a Desenvolvedor inicial da APC C++ MySQL++ e do cliente MySQLGUI. Tonu Samuel (past developer) interface VIO (a fundao para o protocolo cliente/servidor criptografado). ca Sistema de arquivos do MySQL (um modo de usar banco de dados MySQL como arquivos e diretrios). o A expresso CASE. a As funes MD5() e COALESCE(). co Suporte RAID para tabelas MyISAM. Sasha Pachev Implementao inicial da replicao (at verso 4.0). ca ca e a SHOW CREATE TABLE. mysql-bench Matt Wagner Pacote de teste do MySQL Webmaster (at 2002). e Coordenador do desenvolvimento. c

Apndice C: Colaboradores do MySQL e

947

Miguel Solorzano Desenvolvimento e contruo das distribuies Win32 ca co Cdigo do servidor Windows NT. o WinMySQLAdmin Timothy Smith (past developer) Suporte a conjunto de caracteres dinmicos. a congure, RPMs e outra partes dos sistemas constru idos. Desenvolvedor inicial do libmysqld, o servidor embutido.

Sergei Golubchik Pesquisa Full-text. Adioo de chaves ` biblioteca MERGE. ca a Jeremy Cole Indrek Siitan Design/programao de nossa interface web. ca Autor do nosso sistema de gerenciamento de newsletter. Jorge del Conde MySQLCC (MySQL Control Center) Desenvolvento do Win32 Implantao inicial do portal na web. ca Venu Anuganti Connector/ODBC (MyODBC) 3.51 Novo protocolo cliente/servidor para a verso 4.1 (para instrues a co preparadas). Arjen Lentz Responsvel pelo Manual de Referncia do MySQL a e Preparao da edio impressa do Manual. ca ca Alexander (Bar) Barkov, Alexey (Holyfoot) Botchkov, and Ramil Kalimullin Dados espaciais (GIS) e implementao de Arvores-R para verso 4.1 ca a Unicode e conjunto de caracteres para verso 4.1; documentao para os a ca mesmos. Oleksandr (Sanja) Byelkin Cache de consultas na verso 4.0 a Implementao de subconsultas (4.1). ca Aleksey (Walrus) Kishkin and Alexey (Ranger) Stroganov Anlise e desenho dos benchmarks. a Aprovao e edio deste manual. ca ca ALTER TABLE ... ORDER BY .... UPDATE ... ORDER BY .... DELETE ... ORDER BY ....

948

MySQL Technical Reference for Version 5.0.0-alpha

Manuteno do pacote de teste do MySQL. ca Zak Greant Advogado do Open Source, relaes da comunidade MySQL co Carsten Pedersen O programa de certicao do MySQL. ca Lenz Grimmer Engenharia de produo (contruo e distribuio) ca ca ca Peter Zaitsev Funes SHA1(), AES_ENCRYPT() e AES_DECRYPT(). co Depurao, pondo em ordem vrios recursos. ca a Alexander (Salle) Keremidarski Suporte. Depurao. ca Per-Erik Martin Desenvolvedor responsvel por stored procedures (5.0) e triggers. a Jim Winstead Lidera o desenvolvimento web Mark Matthews Driver do Connector/J (Java). Peter Gulutzan Adequao aos padres SQL-99, SQL:2003. ca o Documentao do algoritmo/cdigo existente do MySQL. ca o Documentao do conjunto de caracteres. ca Guilhem Bichot Replciao, a partir do MySQL verso 4.0. ca a Correo do tratamento de expoentes para DECIMAL. ca Autor do mysql_tableinfo. Antony T. Curtis MySQL Database para OS/2.

C.2 Coolaboradores do MySQL

Enquanto a MySQL AB for dona dos direitos autorais do servidor MySQL e do manual MySQL, desejamos reconhecer aqueles que tiveram contibuies de qualquer tipo na distribui~o co ca do MySQL. Os colaboradores esto listados aqui, em uma ordem randmica: a o Gianmassimo Vigazzola qwerg@mbox.vol.it or qwerg@tin.it A portabilidade inicial para Win32/NT. Per Eric Olsson Pelas cr iticas mais ou menos condtrutivas e pelo teste do formato de registro dinmico. a

Apndice C: Colaboradores do MySQL e

949

Irena Pancirov irena@mail.yacc.it Portabilidade para Win32 com compilador Borland. mysqlshutdown.exe e mysqlwatch.exe David J. Hughes Pelo esforo para fazer um banco de dados SQL shareware. Na TcX, a prec decessora da MySQL AB, iniciamos com mSQL, mas achamos que ele no poa dia satisfazer os nossos propositos assim escrevemos uma interface SQL para nossa aplicao Unireg. Os clientes mysqladmin e mysql so programas que ca a foram largamente inuenciados pelo mSQL. Nos esforamos muito tentando c fazer da sintaxe do MySQL um superconjunto do mSQL. Muitas das idias de e API eram emprestadas do mSQL para tornar fcil de se portar programas livres a para o mSQL para a API do MySQL. O programa MySQL no contm nena e hum cdigo do mSQL. Dois arquivos na distribuio (client/insert_test.c o ca e client/select_test.c) so baseados nos arquivos correspondentes (sem a direitos autorais) na distribuio do mSQL, mas so modicados como exemplo ca a mostrando as alteraes necessrias para converter um cdigo do mSQL para o co a o servidor MySQL.. (mSQL e de direito autora de David J. Hughes.) Patrick Lynch Por ajudar-nos a adquirir o http://www.mysql.com/. Fred Lindberg Por congurar o qmail para tratar a lista de email do MySQL e pela incr ivel ajuda que obtemos gerenciando a lista de emails do MySQL. Igor Romanenko igor@frog.kiev.ua mysqldump (antigo msqldump, mas portado e aprimorado por Monty). Yuri Dario Por manter e expandir a portabilidade do MySQL para OS/2. Tim Bunce Autor do mysqlhotcopy. Zarko Mocnik zarko.mocnik@dem.si Ordenao em esloveno. ca "TAMITO" tommy@valley.ne.jp O macro do conjunto de caracteres _MB e os conjuntos de caracteres ujis e sjis. Joshua Chamas joshua@chamas.com Base para inseres concorrentes, sintaxe da data estendida, depurao no NT co ca resposta na lista de email do MySQL. Yves Carlier Yves.Carlier@rug.ac.be mysqlaccess, um progrma para mostrar os direitos de acesso do usurio. a Rhys Jones rhys@wales.com (e GWE Technologies Limited) Por um dos primeiros drives JDBC. Dr Xiaokun Kelvin ZHU X.Zhu@brad.ac.uk Desenvolvimento de um dos primeiros drivers JDBC e outras ferramentas Java relacionadas ao MySQL.

950

MySQL Technical Reference for Version 5.0.0-alpha

James Cooper pixel@organic.com Por congurar um arquivo de lista de email com busca em seu site. Rick Mehalick Rick_Mehalick@i-o.com Pelo xmysql, um cliente grco X para o servidor MySQL. a Doug Sisk sisk@wix.com Por fornecer pacotes RPM do MySQL para Linux Red Hat Diemand Alexander V. axeld@vial.ethz.ch Por fornecer pacotes RPM do MySQL para Linux Red Hat-Alpha. Antoni Pamies Olive toni@readysoft.es Por fornecer verses RPM de vrios clientes MySQL para Intel e SPARC. o a Jay Bloodworth jay@pathways.sde.state.sc.us Por forncer verses RPM do MySQL verso 3.21. o a David Sacerdote davids@secnet.com Ideias para vericao segura de nomes de mquinas DNS. ca a Wei-Jou Chen jou@nematic.ieo.nctu.edu.tw Algum suporte para caracteres chineses (BIG5). Wei He hewei@mail.ied.ac.cn Diversas funcionalidades para o conjunto de casracteres chineses(GBK). Jan Pazdziora adelton@fi.muni.cz Oredenao em Tcheco ca Zeev Suraski bourbon@netvision.net.il Formatao de tempo FROM_UNIXTIME(), funes ENCRYPT() e conseleheiro do ca co bison. Membro ativo da lista de email. Luuk de Boer luuk@wxs.nl Portado (e extendido) o pacote de benchmark para DBI/DBD. Tem sido de grande ajuda com o crash-me e benchmarks em execuo. Algumas novas ca funes de data. O script mysql_setpermissions. co Alexis Mikhailov root@medinf.chuvashia.su funes denidas por usurios (UDFs); CREATE FUNCTION e DROP FUNCTION. co a Andreas F. Bobak bobak@relog.ch A extenso AGGREGATE para funOes UDF. a c Ross Wakelin R.Wakelin@march.co.uk Ajuda na congurao do InstallDhield para o MySQL-Win32. ca Jethro Wright III jetman@li.net A biblioteca libmysql.dll. James Pereria jpereira@iafrica.com Mysqlmanager, uma ferramenta Win32 GUI para administrao do servidor ca MySQL. Curt Sampson cjs@portal.ca Potabilidade de MIT-pthreads para NetBSD/Alpha e NetBSD 1.3/i386.

Apndice C: Colaboradores do MySQL e

951

Martin Ramsch m.ramsch@computer.org Exemplos no Tutorial MySQL. Steve Harvey Por fazer mysqlaccess mais seguro. Konark IA-64 Centre of Persistent Systems Private Limited http://www.pspl.co.in/konark/. Ajuda com a portabilidade do servidor MySQL para Win64. Albert Chin-A-Young. Atulizao do congure para Tru64, suporte a arquivos grandes e suporte a ca melhores wrappers TCP. John Birrell Emulacao do pthread_mutex() para OS/2. Benjamin Pugmann Exetnso de tabelas MERGE para tratar INSERTS. Membro ativo na lista de a emails do MySQL. Jocelyn Fournier Excelente ao mostrar e relatar inumerveis bugs. (especialmente no cdigo da a o subconsulta no MySQL 4.1) Marc Liyanage Manuteno dos pacotes do Mac OS X e fornecimento de feedbacks sobre como ca criar pacotes para Mac OS X. Robert Rutherford Por fornecer informaes e feedback sobre o port QNX. co Outros colaboradores, pesquisadores de bug e responsaveis por testes: James H. Thompson, Maurizio Menghini, Wojciech Tryc, Luca Berra, Zarko Mocnik, Wim Bonis, Elmar Haneke, jehamby@lightside, psmith@BayNetworks.com, duane@connect.com.au, Ted Deppner ted@psyber.com, Mike Simons, Jaakko Hyvatti. E vrios relatos/correes de bugs do pessoal da lista de email. a co Um grande tributo vai `queles que nos ajudaram a responder dvidas na lista de email do a u MySQL. Daniel Koch dkoch@amcity.com Congurao do Irix. ca Luuk de Boer luuk@wxs.nl Dvidas de benchmark. u Tim Sailer tps@users.buoy.com Questes do DBD-mysql. o Boyd Lynn Gerber gerberb@zenez.com Questes relacionadas ao SCO. o Richard Mehalick RM186061@shellus.com Questes relacionadas ao xmysql e questes bsicas de instalao. o o a ca

952

MySQL Technical Reference for Version 5.0.0-alpha

Zeev Suraski bourbon@netvision.net.il Questes de congurao do mdulo Apache (log & autent) e questes relao ca o o cionadas ao PHP, questes relacionadas a sintaxe SQL e outras questes gerais. o o Francesc Guasch frankie@citel.upc.es Questes gerais. o Jonathan J Smith jsmith@wtp.net Questes espec o icas do SO Linux, sintaxe SQL e outra coisas que podem precisar de algum trabalho. David Sklar sklar@student.net Usando o MySQL a partir de PHP e Perl. Alistair MacDonald A.MacDonald@uel.ac.uk Ainda no especicado, mas ex e pode lidar com Linux e, talvez, HP-UX. a e ivel Tentar conseguir usurios para utilizar mysqlbug. a a John Lyon jlyon@imag.net Questes sobre instalao do MySQL em sistemas Linux, usando ou arquivos o ca .rpm ou compilando o fonter. Lorvid Ltd. lorvid@WOLFENET.com Assuntos simples de contas/licena/suporte/direitos autorais c Patrick Sherrill patrick@coconet.com Questes sobre interfaces ODBC e VisualC++. o Randy Harmon rjharmon@uptimecomputers.com Questes sobre DBD, Linux, e algumas sintxe SQL. o

C.3 Responsveis pela Documentao e Traduo a ca ca

As seguintes pessoas nos ajudaram com a escrita da documentao do MySQL e a traduo ca ca da documentao ou mensagens de erro no MySQL. ca Paul DuBois Ajuda no progresso deste manual tornando-o correto e compreendivel. O que inclui rescrever o ingls do Monty e David em um ingls que todo mundo cone e hece. Kim Aldale Ajudou a reescrever o ingls utilizado por Monty e Davis em ingls correto. e e Michael J. Miller Jr. mke@terrapin.turbolift.com Pelo primeiro manual MySQL. E diversas graa/linguagem corrigidas no FAQ (que virou o manual MySQL a muito tempo atras) Yan Cailin Primeiro tradutor do Manual de Referncia do MySQL em chins e e simplicado no in icio de 2000, no qual a verso do cdigo Big5 e HK a o (http://mysql.hitstar.com/) foram baseadas. Pagina pessoal em linuxdb.yeah.net (http://linuxdb.yeah.net).

Apndice C: Colaboradores do MySQL e

953

Jay Flaherty fty@mediapulse.com Grande parte da seo Perl DBI/DBD no manual. ca Paul Southworth pauls@etext.org, Ray Loyzaga yar@cs.su.oz.au Aprovao do Manual de Referncia. ca e Therrien Gilbert gilbert@ican.net, Jean-Marc Pouyot jmp@scalaire.fr Mensagens de erro em Francs. e Petr Snajdr, snajdr@pvt.net Mensagens de erro em Tcheco. Jaroslaw Lewandowski jotel@itnet.com.pl Mensagens de erro em Polons e Miguel Angel Fernandez Roiz Mensagens de erro em Espanhol Roy-Magne Mo rmo@www.hivolda.no Mensagens de erro em noruegus e teste da verso 3.21.#. e a Timur I. Bakeyev root@timur.tatarstan.ru Mensagens de erro em russo. brenno@dewinter.com & Filippo Grassilli phil@hyppo.com Mensagens de erro em italiano. Dirk Munzinger dirk@trinity.saar.de Mensagens de erro em alemo. a Billik Stefan billik@sun.uniag.sk Mensagens de erro en eslovaco. Stefan Saroiu tzoompy@cs.washington.edu Mensagens de erro em romeno. Peter Feher Mensagens de erro em hungaro. Roberto M. Serqueira Mensagens de erro em portugus. e Carsten H. Pedersen Mensgens de erro em dinamarqus. e Arjen G. Lentz Mensagens de erro em holands, completando a traduo parcial mais cedo. e ca (tambm trabalhou na consistencia e graa). e

C.4 Bibliotecas usadas e incluidas com o MySQL

A seguir est uma lista dos criadores da biblioteca que inclu a imos com o fonte do servidor MySQL para facilitar a compilao e instalao do MySQL. Somos muito agradecidos a ca ca todos os indiv iduos que as criaram e tm feito a nossa vida mais fcil. e a

954

MySQL Technical Reference for Version 5.0.0-alpha

Fred Fish

Pela sua excelente depurao de C e biblioteca trace. Monty fez pequenas ca melhoras nesta biblioteca (velocidade e opes adicionais). co

Richard A. OKeefe Por sua biblioteca string de dom inio pblico. u Henry Spencer Pela sua biblioteca regex, usada em WHERE column REGEXP regexp. Chris Provenzano Pthreads portveis no n de usurio. Do direito de uso: Este produto inclui a ivel a software desenvolvido por Chris Provenzano, pela Univesidade da Califrnia, o Berkeley e colaboradores. Atualmente estamos usando a verso 1 60 beta6 a corrigida pelo Monty (veja mit-pthreads/Changes-mysql). Jean-loup Gailly and Mark Adler Pela biblioteca zlib (usada no MySQL para Windows). Bjorn Benson Por seu pacote safe malloc (vericador de memria) que usado quando voc o e e congura o MySQL com --debug. Free Software Foundation A biblioteca readline (para o cliente mysql). The NetBSD fondation O pacote libedit (usado opcionalmente pelo cliente de linha de comando mysql).

C.5 Pacotes que suportam o MySQL

A seguir encontra-se uma lista dos criadores/mantenedores de algumas das mais importantes APIs/pacotes/aplicaes que muitas pessoas utilizam com o MySQL. co No podemos listar todos os pacotes existentes aqui porque a lista seria a muito dif icil de manter. Para outros pacotes, v ao portal do software em a http://www.mysql.com/portal/software. Tim Bunce, Alligator Descartes Pela interface DBD (Perl). Andreas Koenig a.koenig@mind.de Pela interface Perl para o servidor MySQL. Jochen Wiedmann wiedmann@neckar-alb.de Por manter o mdulo Perl DBD::mysql. o Eugene Chan eugene@acenet.com.sg Por portar o PHP para o servidor MySQL. Georg Richter Teste do MySQL 4.1 e caador de bugs. Nova extenso (API) mysqli do c a PHP 5.0 para uso com o MySQL 4.1 e acima.

Apndice C: Colaboradores do MySQL e

955

Giovanni Maruzzelli maruzz@matrice.it Por portar iODBC (ODBC para Unix). Xavier Leroy Xavier.Leroy@inria.fr O autor da LinuxThreads (usada pelo servidor MySQL no Linux).

C.6 Ferramentas que so usadas para criar o MySQL a

Segue aqui uma lista de algumas das ferramentas que usamos para criar o MySQL. Ns o a utilizamos para expressar nossos agradecimentos para aquelea que as criaram e sem as quais no poderiamos ter feito do MySQL o que ele hoje. a e Free Software Foundation De quem obtemos um excelente compilador (gcc), a biblioteca libc (de onde pegamos emprestado o strto.c para termos algum cdigo funcionando em o Linux) Free Software Foundation From whom we got an excellent compiler (gcc), an excellent debugger (gdb and the libc library (from which we have borrowed strto.c to get some code working in Linux). Free Software Foundation & The XEmacs development team For a really great editor/environment used by almost everybody at MySQL AB. Julian Seward Author of valgrind, an excellent memory checker tool that has helped us nd a lot of otherwise hard to nd bugs in MySQL. Dorothea Ltkehaus and Andreas Zeller u For DDD (The Data Display Debugger) which is an excellent graphical frontend to gdb).

C.7 Responsveis pelo Suporte do MySQL a

Enquanto a MySQL AB montm todos os direitos autorais do servidor MySQL e do manual e MySQL, desejamos apresentar as seguintes companias, que nos ajudaram nanceiramente no desenvolvimento do servidor MySQL, nos pagando para desenvolver novos recursos ou nos dando hardware para o desenvolvimento do servidor MySQL. VA Linux / Andover.net Replicaes de fundos. co NuSphere Edio do manual MySQL. ca Stork Design studio O site da MySQL usado entre 1998-2000. Intel Compaq SWSoft Contribuio para desenvolvimento nas plataformas Windows e Linux. ca Contribuio no desenvolvimento do Linux/Alpha ca Desenvolvimento da verso embutida do mysqld. a

956

MySQL Technical Reference for Version 5.0.0-alpha

FutureQuest --skip-show-database

Apndice D: Histrico de Alteraes do MySQL e o co

957

Apndice D Histrico de Alteraoes do MySQL e o c

Este apndice lista as alteraes de verso para verso no cdigo fonte do MySQL. e co a a o Estamos agora trabalhando ativamente no MySQL 4.1 & 5.0 e s forneceremos correes o co de erros cr iticos para o MySQL 4.0 e MySQL 3.23. Atualizamos esta seo a medida que ca adicionamos novos recursos, para que assim todos possam acompanhar o desenvolvimento. Nossa seo de TODO contm os planos adicionais que temos para as verses 4.1 e 5.0. ca e o Veja Seo 1.6 [TODO], Pgina 27. ca a Note que tendemos a atualizar o manual ao mesmo tempo em que fazemos as alteraes no co MySQL. Se voc encontrar um verso listada aqui que voc no pode encontrar na pgina de e a e a a download do MySQL (http://www.mysql.com/downloads/), signica que a verso ainda a no foi liberada! a A data mencionada com uma verso liberada a data do ultimo BitKeeper ChangeSet a e na qual esta distribuio particular foi baseada, e no a data em que os pacotes estavam ca a dispon iveis. Os binrios esto dispon a a iveis normalmente alguns dias aps a data indicada do o ChangeSet - contruir e testar todos os pacotes levam algum tempo.

D.1 Alteraoes na distribuio 5.0.0 (Development) c ca

No momento, a verso 5.0 s est dispon em seu cdigo fonte. Veja Seo 2.3.4 [Installing a o a ivel o ca source tree], Pgina 100. a O seguinte log de alteraes mostra o que j foi feito na rvore 5.0: co a a Suporte bsico a stored procedures (estilo SQL-99). a Adicionado SELECT INTO lista_de_vars, que pode ser misturados, p.ex.: tipos locais e globais. O log de atualizao est obsoleto (no mais suportado). Ele est totlalmente subca a a e a stitu pelo log binrio. ido a Nomes de variveis de usurios agora esto em caso insensitivo: se voc zer SET a a a e claro que o contedo da varivel ainda @a=10; ento SELECT @A; retornar 10. E a a u a e caso sensitivo, apenas o seu nome caso insensitivo. e

D.2 Alteraes na distribuio 4.1.x (Alpha) co ca

A verso 4.1 do servidor MySQL inclui muitos melhoramentos e novos rea cursos. Os binrios desta verso esto dispon a a a iveis para download em http://www.mysql.com/downloads/mysql-4.1.html. Subqueries: SELECT * FROM t1 WHERE t1.a=(SELECT t2.b FROM t2); SELECT * FROM t1 WHERE (1,2,3) IN (SELECT a,b,c FROM t2); Tabelas derivadas: SELECT t1.a FROM t1, (SELECT * FROM t2) t3 WHERE t1.a=t3.a;

958

MySQL Technical Reference for Version 5.0.0-alpha

Sintaxe INSERT ... ON DUPLICATE KEY UPDATE .... Ela lhe permite fazer um UPDATE de um registro existente se a insero criasse um valor duplicado em uma chave PRIMARY ca ou UNIQUE. (REPLACE lhe permite sobrescrever um registro existente, o que totalmente e diferente). Veja Seo 6.4.3 [INSERT], Pgina 579. ca a Uma nova funo de agrupamento GROUP_CONCAT(). Veja Seo 6.3.7 [Group by funcca ca tions and modiers], Pgina 555. a Suporte a Unicode Extensivo (UTF8). Os conjuntos de caracteres podem ser denidos por colunas, tabelas e bancos de dados. Nova cache de chaves para tabelas MyISAM com vrios parmetros de ajustes. Voc a a e pode tem multiplas caches de cahves, indices precarregados em caches para batches ... Indices BTREE em tabelas HEAP. Suporte a OpenGIS (Dados Geogrcos). Veja Cap a ptexi tulo 10 [Spatial extensions in MySQL], Pgina 733. a SHOW WARNINGS exibe avisos para o ultimo comando. WARNINGS], Pgina 323. a Veja Seo 4.6.8.9 [SHOW ca

Protocolo binrio mais rpido com instrues prepardas e ligao de parmetros. Veja a a co ca a Seo 12.1.4 [C API Prepared statements], Pgina 828. ca a Agora voc pode executar vrias instrues com uma unica chamada a API C e de uma e a co vez e ento ler o resultado Veja Seo 12.1.8 [C API multiple queries], Pgina 855. a ca a Create Table: CREATE [TEMPORARY] TABLE [IF NOT EXISTS] tabela LIKE tabela. Comando HELP baseado no servidor que pode ser usado no cliente mysql de linha de comando (e outros clientes) para obter ajuda para comandos SQL. Para uma lista completa das atualizaes, veja a seo de alteraes para cada distribuio co ca co ca 4.1.x individual.

D.2.1 Alteraes na distribuio 4.1.2 (not released yet) co ca

Functionality added or changed: ENGINE is now a synonym for the TYPE option for CREATE TABLE and ALTER TABLE. Added init_connect and init_slave server variables. The values should be SQL statements to be executed when each client connects or each time a slaves SQL thread starts, respectively. C API enhancement: SERVER_QUERY_NO_INDEX_USED and SERVER_QUERY_NO_GOOD_ INDEX_USED ags are now set in server_status eld of MYSQL structure. It is these ags that make the query to be logged as slow if mysqld was started with --logslow-queries --log-queries-not-using-indexes. Bugs xed: Fixed a bug with the INTERVAL() function when 8 or more comparison arguments are provided. (Bug #1561) Packaging: Fixed a bug in the Mac OS PKG postinstall script (mysql_install_db was called with an obsolete argument).

Apndice D: Histrico de Alteraes do MySQL e o co

959

Packaging: Added missing le mysql_create_system_tables to the server RPM package. This bug was xed for the 4.1.1 RPMs by updating the MySQL-server RPM from MySQL-server-4.1.1-0 to MySQL-server-4.1.1-1. The other RPMs were not aected by this change. Fixed a bug in myisamchk and CHECK TABLE that sometimes resulted in a spurious error Found key at page ..... that points to record outside datafile for a table with a FULLTEXT index. (Bug #1977) Fixed a hang in full-text indexing of strings in multi-byte (all besides utf8) charsets. (Bug #2065) Fixed a crash in full-text indexing of UTF-8 data. (Bug #2033) Replication: a rare race condition in the slave SQL thread that could lead to an incorrect complaint that the relay log is corrupted. (Bug #2011) Replication: if an administrative command on a table (OPTIMIZE TABLE, REPAIR TABLE etc) was run on the slave, this could sometimes stop the slave SQL thread (this did not lead to any corruption; one just had to type START SLAVE to get replication going again). (Bug #1858) Replication: in the slave SQL thread, a multi-table UPDATE could produce an incorrect complaint that some record was not found in one table, if the UPDATE was preceded by a INSERT ... SELECT. (Bug #1701)

D.2.2 Alteraes na distribuio 4.1.1 (01 de Dez de 2003) co ca

Funcionalidades adicionadas ou alteradas: Added IGNORE option for DELETE statement. The MySQL source distribution now also includes the MySQL Internals Manual internals.texi. Added mysql_set_server_option() C API client function to allow multiple statement handling in the server to be enabled or disabled. The mysql_next_result() C API function now returns -1 if there are no more result sets. Renamed CLIENT_MULTI_QUERIES connect option ag to CLIENT_MULTI_STATEMENTS. To allow for a transition period, the old option will continue to be recognized for a while. Require DEFAULT before table and database default character set. This enables us to use ALTER TABLE table_name ... CHARACTER SET=... to change the character set for all CHAR, VARCHAR, and TEXT columns in a table. Added MATCH ... AGAINST( ... WITH QUERY EXPANSION) and the ft_query_ expansion_limit server variable. Removed unused ft_max_word_len_for_sort server variable. Full-text search now supports multi-byte character sets and the Unicode utf8 character set. (The Unicode ucs2 character set is not yet supported.) Phrase search in MATCH ... AGAINST ( ... IN BOOLEAN MODE) no longer matches partial words.

960

MySQL Technical Reference for Version 5.0.0-alpha

Added aggregate function BIT_XOR() for bitwise XOR operations. Replication over SSL now works. The START SLAVE statement now supports an UNTIL clause for specifying that the slave SQL thread should be started but run only until it reaches a given position in the masters binary logs or in the slaves relay logs. Produce warnings even for single-row INSERT statements, not just for multiple-row INSERT statements. Previously, it was necessary to set SQL_WARNINGS=1 to generate warnings for single-row statements. Added delimiter (\d) command to the mysql command-line client for changing the statement delimiter (terminator). The default delimiter is semicolon. CHAR, VARCHAR, and TEXT columns now have lengths measured in characters rather than in bytes. The character size depends on the columns character set. This means, for example, that a CHAR(n) column for a multi-byte character set will take more storage than before. Similarly, index values on such columns are measured in characters, not bytes. LIMIT no longer accepts negative arguments (they used to be treated as very big positive numbers before). The DATABASE() function now returns NULL rather than the empty string if there is no database selected. Added --sql-mode=NO_AUTO_VALUE_ON_ZERO option to suppress the usual behaviour of generating the next sequence number when zero is stored in an AUTO_INCREMENT column. With this mode enabled, zero is stored as zero; only storing NULL generates a sequence number. Warning: Incompatible change! Client authentication now is based on 41-byte passwords in the user table, not 45-byte passwords as in 4.1.0. Any 45-byte passwords created for 4.1.0 must be reset after running the mysql_fix_privilege_tables script. Added MySQL Server option and global variable secure-auth that disallows authentication for accounts that have old (pre-4.1.1) passwords. Added MySQL command line client option secure-auth. If this option is set, client will refuse to send password in old (pre-4.1.1) format. Warning: Incompatible change! Renamed the C API mysql_prepare_result() function to mysql_get_metadata() as the old name was confusing. Added DROP USER username@hostname statement to drop an account that has no privileges. The interface to aggregated UDF functions has changed a bit. You must now declare a xxx_clear() function for each aggregate function XXX(). The CONCAT_WS() function no longer skips empty strings. Added new ADDTIME(), DATE(), DATEDIFF(), LAST_DAY(), MAKEDATE(), MAKETIME(), MICROSECOND(), SUBTIME(), TIME(), TIMEDIFF(), TIMESTAMP(), UTC_DATE(), UTC_ TIME(), UTC_TIMESTAMP(), and WEEKOFYEAR() functions. Added new syntax for ADDDATE() and SUBDATE(). The second argument now may be a number representing the number of days to be added to or subtracted from the rst date argument.

Apndice D: Histrico de Alteraes do MySQL e o co

961

Added new type values DAY_MICROSECOND, HOUR_MICROSECOND, MINUTE_MICROSECOND, SECOND_MICROSECOND, and MICROSECOND for DATE_ADD(), DATE_SUB(), and EXTRACT(). Added new %f microseconds format specier for DATE_FORMAT() and TIME_FORMAT(). All queries in which at least one SELECT does not use indexes properly now are written to the slow query log when long log format is used. It is now possible to create a MERGE table from MyISAM tables in dierent databases. Formerly, all the MyISAM tables had to be in the same database, and the MERGE table had to be created in that database as well. Adicionada as novas funes COMPRESS(), UNCOMPRESS() e UNCOMPRESSED_LENGTH(). co Ao fazer SQL SQL_MODE=#, para um modo complexo (como ANSI) agora atualizamos a varivel SQL_MODE para incluir todas as opes que o modo exige. a co Adicionada a funo ROLLUP OLAP (Online Analytical Processing - Processamento ca Analitico Online), que lhe d um resumo para cada n GROUP BY. a ivel Adicionado os cdigos SQLSTATE para todos os erros do servidor. o Adicionado mysql_sqlstate() e mysql_stmt_sqlstate() que retornam o cdigo de o erro SQLSTATE para o ultimo erro. --lower-case-table-names=1 agora tambm faz a aliases caso insensitivo. (Bug e #534) Colunas TIME com valor de horas maior do que 24 eram retornadas incorretamente para o cliente. As instrues ANALYZE, OPTIMIZE, REPAIR e FLUSH so agora armazenados no log co a binrio e assim replicados para o slave. Este registro no ocorre se a palavra chave opa a cional NO_WRITE_TO_BINLOG (ou seu alias LOCAL) for usada. As excees so que FLUSH co a LOGS, FLUSH MASTER, FLUSH SLAVE e FLUSH TABLES WITH READ LOCK, no so registraa a dos no log em qualquer caso. Para uma sintaxe completa, veja Seo 4.6.4 [FLUSH], ca Pgina 299. a Nova varivel global RELAY_LOG_PURGE para habilitar ou desabilitar automaticamente a a remoo de relay logs. ca LOAD DATA agora produz avisos que podem ser buscados com SHOW WARNINGS. Adicionado o suporte a sintaxe CREATE TABLE nome_tabela (LIKE nome_tabela2). CREATE TABLE nome_tabela (...) TYPE=storage_engine agora gera um aviso se o mecanismo de armazenamento no for respeitado. A tabela ainda criada como a e MyISAM, como antes. Muitas sub selectas so muito mais rpidas que antes. a a Disabled the PURGE LOGS statement that was added in in version 4.1.0. The statement now should be issued as PURGE MASTER LOGS or PURGE BINARY LOGS. Added SHOW BDB LOGS as an alias for SHOW LOGS. Added SHOW MASTER LOGS (which had been deleted in version 4.1.0) as an alias for SHOW BINARY LOGS. Added Slave_IO_State and Seconds_Behind_Master columns to the output of SHOW SLAVE STATUS. Slave_IO_State indicates the state of the slave I/O thread, and

962

MySQL Technical Reference for Version 5.0.0-alpha

Seconds_Behind_Master indicates the number of seconds by which the slave is late compared to the master. --lower-case-table-names=1 now also makes aliases case insensitive. (Bug #534) Bugs corrigidos: Fixed merging types and length of elds in UNION Fixed a bug in privilege handling that caused connections from certain IP addresses to be assigned incorrect database-level privileges. A connection could be assigned the database privileges of the previous successful authentication from one of those IP addresses, even if the IP address username and database name were dierent. (Bug #1636) Error-handling functions were not called properly when an error resulted from [CREATE | REPLACE| INSERT] ... SELECT statements. HASH, BTREE, RTREE, ERRORS, and WARNINGS no longer are reserved words. (Bug #724) Fix for bug in ROLLUP when all tables were const tables. (Bug #714) Fixed a bug in UNION that prohibited NULL values from being inserted into result set columns where the rst SELECT of the UNION retrieved NOT NULL columns. Fixed name resolution of columns of reduced subqueries in unions. (Bug #745) Fixed memory overrun in subqueries in select list with WHERE clause bigger than outer query WHERE clause. (Bug #726) Fixed a bug that caused MyISAM tables with FULLTEXT indexes created in 4.0.x to be unreadable in 4.1.x. Fixed a data loss bug in REPAIR TABLE ... USE_FRM when used with tables that contained TIMESTAMP columns and were created in 4.0.x. Fixed reduced subquery processing in ORDER BY/GROUP BY clauses. (Bug #442) Fixed name resolution of outer columns of subquery in INSERT/REPLACE statements. (Bug #446) Fixed bug in marking columns of reduced subqueries. (Bug #679) Fixed a bug that made CREATE FULLTEXT INDEX syntax illegal. Fixed a crash when a SELECT that required a temporary table (marked by Using temporary in EXPLAIN output) was used as a derived table in EXPLAIN command. (Bug #251) Fixed a rare table corruption bug in DELETE from a big table with a new (created by MySQL-4.1) fulltext index. LAST_INSERT_ID() now returns 0 if the last INSERT statement didnt insert any rows. Corrigido a perda dos ultimos caracteres na sa da funo (bug #447) ida ca Corrigido um erro de replicao raro quando um transao extendia em dois ou mais ca ca relay logs e o escravo era parada enquanto ele estava executando a parte da transao ca que estava no segundo relay log ou em um adicional. Ento a replicao parava no a ca inicio do segundo relay log ou adicional, o que estava incorreto. (ele deve parar no BEGIN, no primeiro relay log). (Bug #53) Agora CONNECTION_ID() replicado apropriadamente (bug #177). e A nova funo PASSWORD() na verso 4.1 replicada apropriadamente (bug #344). ca a e

Apndice D: Histrico de Alteraes do MySQL e o co

963

Corrigida a dupla liberao de memria ca o Corrigido um erro em UNION envolvendo tabelas temporrias. a Corrigido um erro de falha em DERIVED TABLES quando EXPLAIN usado em um e DERIVED TABLES com um join Corrigido um erro de falha no DELETE com ORDER BY e LIMIT causado pala inicializao ca do vetor do ponteiro de referncias. e Corrigido um erro na funo USER() causado pelo erro no tamanho da string alocada ca Corrigido um erro de falha quando se tentava criar uma tabela com coluna do tipo GEOMETRY com um mecanismo de armazenamenti que no a suporta. a Corrigido um erro de falha no UNION causado pela lista de select vazia e um campo no a existente sendo usado em algumas das instrues SELECTs individuais. co Corrigido um erro de replicao com um master na verso 3.23 e um slave na 4.0: o ca a slave perdia a replicao de tabelas temporrias se FLUSH LOGS era executado no master ca a (Bug #254). Corrigido um bug de segurana: Um servidor compilado ser suporte a SSL ainda perc mitia conexes de usurios que possuiam a opo REQUIRE SSL especicado para as o a ca suas contas. Quando um usurio indenido era usado em uma atualizao de consulta no master a ca (como INSERT INTO t VALUES(@a) onde @a nunca havia sido denido por esta conexo), a ento o slave podia replicar a consulta de forma incorreta se uma transao anterior a ca no master usava uma varivel de usurio de mesmo nome. (Bug #1331) a a Corrigido um erro com instrues preparadas: O uso do parmetro ? de instrues co a co preparadas como argumento de certas funes e clusulas fazia com que o servidor co a falhasse durante chamadas mysql_prepare(). (Bug #1500) Corrigido um erro com instrues preparadas: co depois da chamada de mysql stmt prepare, colchetes so permitidos em todas as instrues consequentes, a co mesmo se eles no forem preparados (bug #1946) a

D.2.3 Alteraes na distribuio 4.1.0 (03 Apr 2003: Alpha) co ca

Funcionalidades adicionadas ou alteradas: Nova autenticao do cliente, mais segura, baseada em senha de 45-byte na tabela ca user. Nova funo CRC32() para calcular valor de vericao de redundncia c ca ca a iclica. No Windows, agora estamos usando memria compartilhada para comunicar entre o servidor e cliente quando eles esto executando na mesma mquina e voc est a a e a conectando a localhost. REPAIR das tabelas MyISAM agora usam menos espao temporrio em disco ao ordenar c a as colunas de caracteres. A vericao de DATE/DATETIME agora um bit estritamente para suportar a habilidade ca e de deitiguir automaticamente entre date, datetime e time com microsegundos. Por exemplo, tipos de dados YYYYMMDD HHMMDD no so mais suportados; deve-se tambm a a e ter separadores entre as partes DATE/TIME ou no. a

964

MySQL Technical Reference for Version 5.0.0-alpha

Ajuda do lado do servidor para todas as funes do MySQL. Pode-se agora digitar co help week no cliente mysql e conseguir ajuda para a funo week(). ca Adionada a nova funo da API C mysql_get_server_version(). ca Corrigido um buh na libmysqlclient que buscava campos padres. o Corrigido um bug no cliente mysql.cc ao ignorar comentrios a Adicionado o mtodo record_in_range() para tabelas MERGE poderem escolher o e indice certo quando houverem muitos para serem escolhidos. A replicao agora funciona com RAND() e variveis de usurios @var. ca a a Permite-se alterar o modo para ANSI_QUOTES com o servidor no ar. Agora pode se matar EXPLAIN SELECT. Veja Seo 4.6.7 [KILL], Pgina 301. ca a Agora pode se matar REPAIR TABLE. Veja Seo 4.6.7 [KILL], Pgina 301. ca a Permiti-se especicar lista de chaves vazias para USE INDEX, IGNORE INDEX e FORCE INDEX. Agora DROP TEMPORARY TABLE apenas apaga tabelas temporrias e no naliza a a transaes. co Adicionado suporte para UNION em tabelas derivadas. Warning: Alterao imcompat ca ivel! TIMESTAMP agora retornado comi uma string do e tipo YYYY-MM-DD HH:MM:SS e tamanhos de timestamp diferentes no so suportados. a a Esta alterao era necessria para compatibilidade com o padro SQL. Em uma verso ca a a a futura, uma alterao adicional ser feita (compat ca a ivel co esta alterao), permitindo ca que o tamanho do timestamp indique o nmero de d u igitos desejado para a frao de ca segundos. Novo protocolo cliente/servidor mais rpido que suporta instrues preparadas, limitar a co parmetros e colunas de resultados, transferncia binaria de dados, avisos. a a Adicionado nome de banco de dados e de nomes reais de tabela (no caso de alias) ` a estrutura MYSQL_FIELD. Consultas multi linhas: Agora voc pode executar diversas consultas de uma vez e e ento ler o resultados. a Em CREATE TABLE foo (a INT not null primary key) a palavra PRIMARY agora ope cional. Em CREATE TABLE o atributo SERIAL agora um alias para BIGINT NOT NULL AUTO_ e INCREMENT UNIQUE. SELECT ... FROM DUAL um alias para SELECT .... (Para ser compat com alguns e ivel outros bancos de dados). Se criado um CHAR/VARCHAR muito grande, ele alterado automaticamente para TEXT e a ou BLOB; Ser exibido um aviso neste caso. a POde-se especicar os tipos BLOB/TEXT diferentes com a sintaxe BLOB(tamanho) e TEXT(tamanho). O MySQL ir alter-los automaticamente para um dos tipos internos a a BLOB/TEXT. CHAR BYTE um alias para CHAR BINARY. e VARCHARACTER um alias para VARCHAR. e Novos operadores inteiro MOD inteiro e inteiro DIV inteiro.

Apndice D: Histrico de Alteraes do MySQL e o co

965

Adicionado SERIAL DEFAULT VALUE como um alias para AUTO_INCREMENT. Adicionado TRUE e FALSE como alias para 1 e 0, respectivamente. Agora aliases so forados em tabelas dferivadas, como no SQL-99. a c orrigido SELECT .. LIMIT 0 para retornar a contagem aproriada de linhas para SQL_ CALC_FOUND_ROWS. Pode-se especicar muitos diretrios temporrios para serem usados de modo roundo a robin com: --tmpdir=nomedir1:nomedir2:nomedir3. Subqueries: SELECT * from t1 where t1.a=(SELECT t2.b FROM t2). Tabelas derivadas: SELECT a.col1, b.col2 FROM (SELECT MAX(col1) AS col1 FROM root_table) a, other_table b WHERE a.col1=b.col1; Conjuntos de caracteres a serem denidos por colunas, tabelas e banco de dados. Suporte a Unicode (UTF8). Nova sintaxe CONVERT(... USING ...) para converso de valores strings entre conjunto a de caracteres. Indices BTREE em tabelas HEAP. Servidor embutido mais rpido (novo protocolo de comunicao interno). a ca Pode-se adicionar um comentrio por coluna em CREATE TABLE. a SHOW FULL COLUMNS FROM nome_tabela exibe os comentrios das colunas. a ALTER DATABASE. Suporte a GIS (dados geometricos). Veja Capptexi tulo 10 [Spatial extensions in MySQL], Pgina 733. a SHOW [COUNT(*)] WARNINGS exibe avisos sobre o ultimo comnado. Pode se especicar um tipo de coluna para em um CREATE TABLE ... SELECT denindo a coluna na parte CREATE. CREATE TABLE foo (um tinyint n~o nulo) SELECT b+1 AS a FROM bar; a expr SOUNDS LIKE expr o mesmo que SOUNDEX(expr)=SOUNDEX(expr). e Adicionada nova funo VARIANCE(expr) que retorna a varincia de expr ca a Pode se criar um tabela a partir de uma existente usando CREATE [TEMPORARY] TABLE [IF NOT EXISTS] tabela (LIKE tabela). A tabela tambm pode ser normal ou teme porria. a Novas opes --reconnect e --disable-reconnect para o cliente mysql, para reco conectar automaticamente ou no se a conexo for perdida. a a START SLAVE (STOP SLAVE) no retorna mais um erro se o slave j est iniciado (parado); a a a ele retorns um aviso. SLAVE START e SLAVE STOP no mais aceitada pelo analisador de consulta; use START a e SLAVE e STOP SLAVE em seu lugar.

966

MySQL Technical Reference for Version 5.0.0-alpha

D.3 Alteraes na distribuio 4.0.x (Production) co ca

A verso 4.0 do servidor MySQL inclui muitos aprimoramentos e novos recursos: a O tipo de tabela InnoDB agora est inclu no binrio padro, adicionando transaes, a ido a a co lock de linha e chaves estrangeiras. Veja Seao 7.5 [InnoDB], Pgina 643. c a Uma cache de consultas, oferecendo um grande aumento da performance para muitas aplicaes. Armazenando resultados completos, mais tarde consultas idnticas podem co e ser retornadas instataneamente. Veja Seo 6.9 [Query Cache], Pgina 625. ca a Melhora na indexao full-text com modo booleano, truncamento e busca de frase. ca Veja Seo 6.8 [Fulltext Search], Pgina 619. ca a Melhor das tabelas MERGE, suportando INSERTs e AUTO_INCREMENT. Veja Seo 7.2 ca [MERGE], Pgina 638. a Sintaxe UNION em SELECT. Veja Seo 6.4.1.2 [UNION], Pgina 569. ca a Instrues DELETE multi-tabelas. Veja Seo 6.4.5 [DELETE], Pgina 585. co ca a libmysqld, a biblioteca do servidor embutido. Veja Seo 12.1.15 [libmysqld], ca Pgina 864. a Opes adicionais para o privilgio GRANT para maior controle e segurana. Veja co e c Seo 4.4.1 [GRANT], Pgina 254. ca a Gerenciamento dos recursos dos usurios no sistema GRANT, particularmente util para a provedores e outro fornecedores de hospedagem. Veja Seo 4.4.7 [User resources], ca Pgina 265. a Variveis de servidores dinmicas, permitindo que alteraes na congurao sejam a a co ca feitas ser precisar derrubar o servidor. Veja Seo 5.5.6 [SET OPTION], Pgina 460. ca a Melhora do cdigo da replicao e seus recursos. Veja Seo 4.11 [Replication], o ca ca Pgina 378. a Novas funes e opes numerosas. co co Alteraes do cdigo existente para melhora da performance e conabilidade. co o Para uma lista completa de alteraes, visite a seo para cada distribuio 4.0.x individual. co ca ca

D.3.1 Alteraoes na distribuio 4.0.17 (not released yet) c ca

Functionality added or changed: Allow spaces in windows service names. Changed the default Windows service name for mysqld from MySql to MySQL. This should not aect usage, because service names are not case sensitive. When you install mysqld as a service on Windows systems, mysqld will read startup options in option les from the option group with the same name as the service name. (Except when the service name is MySQL). Bugs xed: Fixed bug #1335 when lesort was never shown in EXPLAIN if query contained ORDER BY NULL clause. Fixed invalidation of whole query cache on DROP DATABASE. (Bug #1898)

Apndice D: Histrico de Alteraes do MySQL e o co

967

Fixed bug in range optimizer that caused wrong results for some not likely AND/OR queries. (Bug #1828) Fixed a crash in ORDER BY when ordering by expression and identier. (Bug #1945) Fixed a crash in an open HANDLER when an ALTER TABLE was executed in a dierent connection. (Bug #1826) Fixed a bug in trunc* operator of full-text search which sometimes caused MySQL not to nd all matched rows. Fixed bug in zero prepending to DECIMAL column type. Fixed optimiser bug, introduced in 4.0.16, when REF access plan was preferred to more ecient RANGE on another column. Fixed problem when installing a MySQL server as a Windows service using a command of the form mysqld --install mysql --defaults-file=path-to-file. Fixed an incorrect result from a query that uses only const tables (such as one-row tables) and non-constant expression (such as RAND()). (Bug #1271) Fixed bug when the optimiser did not take SQL_CALC_FOUND_ROWS into account if LIMIT clause was present. (Bug #1274) mysqlbinlog now asks for a password at the console when the -p or --password option is used with no argument. This is consistent with the way that other clients such mysqladmin and mysqldump already behave. Note: A consequence of this change is that it is no longer possible to invoke mysqlbinlog as mysqlbinlog -p pass_val (with a space between the -p option and the following password value). (Bug #1595) Bug accidentally introduced in 4.0.16 where the slave SQL thread deleted its replicated temporary tables when STOP SLAVE was issued. In a chain replication setup A->B->C, if 2 sessions on A updated temporary tables of the same name at the same time, the binary log of B became incorrect, resulting in C becoming confused. (Bug #1686) In a chain replication setup A->B->C, if STOP SLAVE was issued on B while it was replicating a temporary table from A, then when START SLAVE was issued on B, the binary log of B became incorrect, resulting in C becoming confused. (Bug #1240) When MASTER_LOG_FILE and MASTER_LOG_POS were not specied, CHANGE MASTER used the coordinates of the slave I/O thread to set up replication, which broke replication if the slave SQL thread lagged behind the slave I/O thread. This caused the slave SQL thread to lose some events. The new behaviour is to use the coordinates of the slave SQL thread instead. Veja Seo 4.11.8.1 [CHANGE MASTER TO], Pgina 402. (Bug ca a #1870) Now if integer is stored or converted to TIMESTAMP or DATETIME value checks of year, month, day, hour, minute and second ranges are performed and numbers representing illegal timestamps are converted to 0 value. This behaviour is consistent with manual and with behaviour of string to TIMESTAMP/DATETIME conversion. (Bug #1448) Fixed bug when BIT_AND() and BIT_OR() group functions returned incorrect value if SELECT used a temporary table and no rows were found. (Bug #1790). BIT_AND() is now unsigned in all contexts. This means that it will now return 18446744073709551615 (= 0x) instead of -1 if there were no rows in the result.

968

MySQL Technical Reference for Version 5.0.0-alpha

Fixed bug with BIT_AND() still returning signed value for an empty set in some cases. (Bug #1972) Fixed bug with ^ (XOR) and >> (bit shift) still returning signed value in some cases. (Bug #1993) Replication: a rare race condition in the slave SQL thread, which could lead to a wrong complain that the relay log is corrupted. (Bug #2011) Replication: if an administrative command on a table (OPTIMIZE TABLE, REPAIR TABLE etc) was run on the slave, this could sometimes stop the slave SQL thread (this did not led to any corruption; one just had to type START SLAVE to get replication going again). (Bug #1858) Replication: in the slave SQL thread, a multi-table UPDATE could produce a wrong complain that some record was not found in one table, if the UPDATE was preceded by a INSERT ... SELECT. (Bug #1701)

D.3.2 Alteraes na distribuio 4.0.16 (17 Out 2003) co ca

Funcionalidades adicionadas ou alteradas: Write memory allocation information to error log when doing mysqladmin debug. This only works on system that support the mallinfo() call (like newer Linux systems). Added the following new server variables to allow more precise memory allocation: range_alloc_block_size, query_alloc_block_size, query_prealloc_size, transaction_alloc_block_size, and transaction_prealloc_size. mysqlbinlog now reads option les. To make this work one must now specify --readfrom-remote-server when reading binary logs from a MySQL server. (Note that using a remote server is deprecated and may disappear in future mysqlbinlog versions). Block SIGPIPE signals also for non-threaded programs. The blocking is moved from mysql_init() to mysql_server_init(), which is automatically called on the rst call to mysql_init(). Added --libs_r and --include options to mysql_config. New > prompt for mysql. This prompt is similar to the > and "> prompts, but indicates that an identier quoted with backticks was begun on an earlier line and the closing backtick has not yet been seen. Atualizado o mysql_install_db para poder usar o endereo de IP da mquina local c a em vez do nome da mquina ao criar as tabelas de permisses iniciais de skip-namea o resolve foi especicado. Esta opo pode ser util no FreeBSD para evitar problemas ca de segurana de threads com o resolver de bibliotecas do FreeBSD. (Obrigado a Jeremy c Zawodny pelo patch) A documentation change: Added a note that when backing up a slave, it is necessary also to back up the master.info and relay-log.info les, as well as any SQL_LOAD-* les located in the directory specied by the --slave-load-tmpdir option. All these les are needed when the slave resumes replication after you restore the slaves data. Bugs corrigidos:

Apndice D: Histrico de Alteraes do MySQL e o co

969

Fixed a spurious error ERROR 14: Cant change size of file (Errcode: 2) on Windows in DELETE FROM table_name without a WHERE clause or TRUNCATE TABLE table_ name, when table_name is a MyISAM table. (Bug #1397) Fixed a bug that resulted in thr_alarm queue is full warnings after increasing the max_connections variable with SET GLOBAL. (Bug #1435) Made LOCK TABLES to work when Lock_tables_priv is granted on the database level and Select_priv is granted on the table level. Fixed crash of FLUSH QUERY CACHE on queries that use same table several times (Bug #988). Fixed core dump bug when setting an enum system variable (such as SQL_WARNINGS) to NULL. Extended the default timeout value for Windows clients from 30 seconds to 1 year. (The timeout that was added in MySQL 4.0.15 was way too short). This xes a bug that caused ERROR 2013: Lost connection to MySQL server during query for queries that lasted longer than 30 seconds, if the client didnt specify a limit with mysql_options(). Users of 4.0.15 on Windows should upgrade to avoid this problem. More out of memory checking in range optimiser. Fixed and documented a problem when setting and using a user variable within the same SELECT statement. (Bug #1194). Fixed bug in overrun check for BLOB values with compressed tables. This was a bug introduced in 4.0.14. It caused MySQL to regard some correct tables containing BLOB values as corrupted. (Bug #770, Bug #1304, and maybe Bug #1295) SHOW GRANTS showed USAGE instead of the real column-level privileges when no tablelevel privileges were given. When copying a database from the master, LOAD DATA FROM MASTER dropped the corresponding database on the slave, thus erroneously dropping tables that had no counterpart on the master and tables that may have been excluded from replication using replicate-*-table rules. Now LOAD DATA FROM MASTER no longer drops the database. Instead, it drops only the tables that have a counterpart on the master and that match the replicate-*-table rules. replicate-*-db rules can still be used to include or exclude a database as a whole from LOAD DATA FROM MASTER. A database will also be included or excluded as a whole if there are some rules like replicate-wilddo-table=db1.% or replicate-wild-ignore-table=db1.%, as is already the case for CREATE DATABASE and DROP DATABASE in replication. (Bug #1248) Fixed a bug where mysqlbinlog crashed with a segmentation fault when used with the -h or --host option. (Bug #1258) Fixed a bug where mysqlbinlog crashed with a segmentation fault when used on a binary log containing only nal events for LOAD DATA. (Bug #1340) Fixed compilation problem when compiling with OpenSSL 0.9.7 with disabled old DES support (If OPENSSL_DISABLE_OLD_DES_SUPPORT option was enabled). Fixed a bug when two (or more) MySQL servers were running on the same machine, and they were both slaves, and at least one of them was replicating some LOAD DATA INFILE command from its master. The bug was that one slave MySQL server sometimes deleted the SQL_LOAD-* les (used for replication of LOAD DATA INFILE and located

970

MySQL Technical Reference for Version 5.0.0-alpha

in the slave-load-tmpdir directory, which defaults to tmpdir) belonging to the other slave MySQL server of this machine, if these slaves had the same slave-load-tmpdir directory. When that happened, the other slave could not replicate LOAD DATA INFILE and complained about not being able to open some SQL_LOAD-* le. (Bug #1357) If LOAD DATA INFILE failed for a small le, the master forgot to write a marker (a Delete_file event) in its binary log, so the slave could not delete 2 les (SQL_LOAD-*.info and SQL_LOAD-*.data from its tmpdir. (Bug #1391) On Windows, the slave forgot to delete a SQL_LOAD-*.info le from tmpdir after successfully replicating a LOAD DATA INFILE command. (Bug #1392) When a connection terminates, MySQL writes DROP TEMPORARY TABLE statements to the binary log for all temporary tables which the connection had not explicitely dropped. MySQL forgot to backquote the database and table names in the statement. (Bug #1345) On some 64-bit machines (some HP-UX and Solaris machines), a slave installed with the 64-bit MySQL binary could not connect to its master (it connected to itself instead). (Bug #1256, Bug #1381) Code was introduced in MySQL 4.0.15 for the slave to detect that the master had died while writing a transaction to its binary log. This code reported an error in a legal situation: When the slave I/O thread was stopped while copying a transaction to the relay log, the slave SQL thread would later pretend that it found an unnished transaction. (Bug #1475)

D.3.3 Alteraes na distribuio 4.0.15 (03 Sep 2003) co ca

IMPORTANT: If you are using this release on Windows, you should upgrade at least your clients (any program that uses libmysql.lib) to 4.0.16 or above. This is because the 4.0.15 release had a bug in the Windows client library that causes Windows clients using the library to die with a Lost connection to MySQL server during query error for queries that take more than 30 seconds. This problem is specic to Windows; clients on other platforms are unaected. Funcionalidades adicionadas ou alteradas: O mysqldump agora coloca todos os identicadores corretamente entre aspas ao conectar com o servidor. Isto assegura que durante o processo de dump, O mysqldump nunca enviar consultas ao servidor que resultam em um erro de sintaxe. Este problema no a a est relacionado a sa do programa mysqldump, que no foi alterado. (Bug #1148) a ida a Altera a informao de metadados do resultado e assim MIN() e MAX() informamm que ca eles podem retornar NULL (isto verdade porque um conjunto vazio retornar NULL). e a (Bug #324) Produz uma mensagem de erro no Windows se um segundo servidor mysqld iniciado e na mesma porta TCP/IP que um servidor mysqld j em execuo. a ca As variveis do servidor mysqld wait_timeout, net_read_timeout e net_write_ timeout agora funcionam no Windows. Agora pode-se tambm denir o tempo limite e de leitura e escrita em clientes Windows com a opo mysql_options() ca

Apndice D: Histrico de Alteraes do MySQL e o co

971

Adicionada a opo --sql-mode=NO_DIR_IN_CREATE para tornar poss para os slaves ca ivel ignorarem as opes INDEX DIRECTORY e DATA DIRECTORY dadas para CREATE TABLE. co Quando ele est ligado, SHOW CREATE TABLE no exibir os diretrios dados. a a a o SHOW CREATE TABLE agora exibe as opes INDEX DIRECTORY e DATA DIRECTORY, se eles co fossem especicados quando a tabela era criada. A varivel do servidor open_files_limit agora exibe o limite de arquivos abertos real. a MATCH ... AGAINST() em modo de linguagem natural agora tratam de palavra presentes em mais de 2,000,000 linhas como stopwords. As imagens do disco de instalao do Mac OS X agora incluem um pacote ca MySQLStartupItem.pkg adicional que habilita a inicializao automtica do MySQL ca a no boot do sistema. Veja Seo 2.1.3 [Mac OS X installation], Pgina 71. ca a A maioria da documentao inclu na distribuio tar do binrio (.tar.gz) foi ca ida ca a movida para o subdiretrio docs. Veja Seo 2.2.5 [Installation layouts], Pgina 83. o ca a O manual agora est inclu com um arquivo info tradicional na distribuio binria. a ido ca a (Bug #1019) A distribuio binria agora incluem a biblioteca do servidor embutido (libmysqld) ca a por padro. Devido a problemas de ligao com compiladores diferentes do gcc, ele no a ca a estava inclu em todos os pacotes da distribuio inicial da verso 4.0.15. Os pacotes ido ca a afetados forma reconstruidos e distribuidos como 4.0.15a. Veja Seo 1.5.1.2 [Nutshell ca Embedded MySQL], Pgina 24. a O MySQL agora pode usar o otimizador de faixa para BETWEEN com limites no cona stantes. (Bug #991) Mensagens de erro de replicao agora incluem o banco de dados padro, assim os ca a usurios podem vericar em qual banco de dados a consulta com erro est rodando. a a Uma alterao da documentao: Adicionado um pargrafo sobre como as opes ca ca a co binlog-do-db e binlog-ignore-db so testadas em um banco de dados no master a (veja Seo 4.10.4 [Binary log], Pgina 374), e um pargrafo sobre como replicateca a a do-db, replicate-do-table e opes anlogas so testadas em bancos de dados e co a a tabelas no slave (veja Seo 4.11.6 [Replication Options], Pgina 392). ca a Agora o slave no replica SET PASSWORD se estiver congurado para excluir o banco a de dados mysql da replicao (usando, por exemplo, replicate-wild-ignoreca table=mysql.%). Este j era o caso para GRANT e REVOKE desde a verso 4.0.13 a a (embora houvesse o Bug #980 nas verses 4.0.13 & 4.0.14, que foi corrigido na verso o a 4.0.15). Rewrote the information shown in the State column of SHOW PROCESSLIST for replication threads and for MASTER_POS_WAIT() and added the most common states for these threads to the documentation, veja Seo 4.11.3 [Replication Implementation Details], ca Pgina 381. a Adiciona um teste na replicao para detectar o caso no qual o master morre no meio ca da gravao de uma transao no log binrio; tal transao inacabada agora dispara ca ca a ca uma mensagem de erro no slave. Um comando GRANT que cria um usurio annimo (isto , uma conta com nome de a o e usurio vazio) no exige mais FLUSH PRIVILEGES para a conta ser conhecida no servidor. a a (Bug #473)

972

MySQL Technical Reference for Version 5.0.0-alpha

CHANGE MASTER agora descarrega o relay-log.info. Anteriormente isto era feito na prxima execuo de START SLAVE, assim se o mysqld fosse desligado no slave o ca depois de CHANGE MASTER sem executar START SLAVE, o nome e posio do relay log ca eram perdidos. Na reinicializao eles eram carregados a partir do relay-log.info, ca revertendo-os para seus valores antigos (incorretos) de antes do CHANGE MASTER, exibindo mensagens de erro (j que o relay log antigo no existia mais) e as threads a a slaves se recusavam a iniciar. (Bug #858) Bugs corrigidos: Corrigido o overow do buer no tratamewnto de senhas, que podia potencialmente ser explorardo pelo usurio MySQL com privilgios na tabela mysql.user para exea e cutar cdigo aleatrios para obter acessi com o UID do processo mysqld (obrgado a o o Jedi/Sector One por detectar e reportar este erro.) Corrigido um falha do servidor com FORCE INDEX em uma consulta contendo "Range checked for each record" na sa do EXPLAIN. (Bug #1172) ida Corrigido o tratamento de permisso de tabelas/colunas - a ordenao apropriada (do a ca mais especico para o menos especico, veja Seo 4.3.10 [Request access], Pgina 242) ca a no era respeitada (Bug #928) a Corrigido um bug raro no MYISAM introduzido na verso 4.0.3 onde o handler do a arquivo de indice no era diretamente atualizado depois de um UPDATE de registros a dinamicos separados. Corrigido o erro Cant unlock file ao executar myisamchk --sort-index no Windows. (Bug #1119) Corrigido um poss deadlock ao alterar key_buffer_size enquanto a cache de chaves ivel era ativamente usada. (Bug #1088) Corrigido um bug de overow em MyISAM e ISAM quando um registro era atualiado na tabela com um grande nmero de colunas e pelo meno uma coluna BLOB/TEXT. u Corrigido um resultado incorreto ao fazer UNION e LIMIT #,# quando no era usado a parenteses na parte SELECT. Corrigido um resultado incorreto ao fazer UNION e ORDER BY .. LIMIT # quando no a usado parenteses na parte SELECT. Corrigido um problema com SELECT SQL_CALC_FOUND_ROWS ... UNION ALL ... LIMIT # onde FOUND_ROWS() retornava o nmero incorreto de linhas. u Corrigidos um erro de pilha indesejado quando tinhamos uma grande expresso do tipo a 1+1-1+1-1... de uma ceta combinao. (Bug #871) ca Corrigido o erro que algumas vezes fazia uma tabela com um indice FULLTEXT estar marcada como "analyzed". Corrigido o MySQL para que o tamanho do campo (na API C) para a segunda coluna em SHOW CREATE TABLE seja sempre maior que o tamanho do dado. A unica aplicao ca conhecida que era afetada pelo comportamento anterior era o Borland dbExpress, que truncava a sa do comando. (Bug #1064) ida Corrigida a falha na comparao de strings usando o conjunto de caracteres tis620. ca (Bug #1116) Corrigido um bug do ISAM na otimizao de MAX(). ca

Apndice D: Histrico de Alteraes do MySQL e o co

973

myisamchk --sort-records=N no marca mais a tabela como danicada se a ordenao a ca falhar devido a uma chave inapropriada. (Bug #892) Corrigido um erro no tratamento de tabelas MyISAM compactadas que algumas vezes torna imposs se reparar tabelas compactadas no modo "Repair by sort". "Repair ivel with keycache" (myisamchk --safe-recover) funcionad. (Bug #1015) Correo de um erro na propagao do nmero da verso do manual inclu no arquivo ca ca u a ido de distribuio. (Bug #1020) ca Corrigida um problema de ordenacao da chave (uma chave primria - PRIMARY a declarada em uma coluna que no explicitamente marcada como NOT NULL era ora e denada depois de uma chave UNIQUE para uma coluna NOT NULL). Corrigido o resultado de INTERVAL qaundo aplicado a um valor DATE. (Bug #792) Corrida a compilao da biblioteca do servidor embutido da arquivo de especicao ca ca do RPM. (Bug #959) Adicionado alguns arquivos que faltavam na arquivo de especicao do RPM e corca rigido alguns erros de criao do RPM que ocorriam no Red Hat Linux 9. (Bug #998) ca Corrigida a avaliao incorreta de XOR na clusula WHERE. (Bug #992) ca a Corrigido um erro com processamento na cache de consultas com tabelas unidas a partir de mais de 255 tabelas. (Bug #930) Correo dos resultados incorretos da consulta outer join (ex. LEFT JOIN) quando a ca condio ON sempre falsa, e a faixa de busca usada. (Bug #926) ca e e Corrigido um erro causando resultados incorretos de MATCH ... AGAINST() em algumas joins. (Bug #942) Tabelas MERGE no ignoram mais "Using index" (da sa de EXPLAIN). a ida Corrigido um erro que fazia uma tabela vazia ser marcada como "analyzed". (Bug #937) Corrigida a falha em myisamchk --sort-records quando usada em tabelas compactadas. Corrigido o ALTER TABLE lento (quando comparado a verso 3.23) e comandos relaa cionados tais como CREATE INDEX. (Bug #712) Correo de segmentation fault resultante de LOAD DATA FROM MASTER quando o mestre ca estava executando sem a opo --log-bin. (Bug #934) ca Corrigido um erro de segurana: Um servidor compilado com suporte a SSL ainda c permitia conexes por usurios que tinham a opo REQUIRE SSL especicadas por o a ca suas contas. Corrigido um erro aleatrio: Algumas vezes o slave replicava consultas GRANT ou REVOKE o mesmo se estivesse congurado para excluir o banco de dados mysql da replicao (por ca exemplo, usando replicate-wild-ignore-table=mysql.%). (Bug #980) Os campos Last_Errno e Last_Error na sa ida de SHOW SLAVE STATUS agora so a limpadas por CHANGE MASTER e quando a thread slave de SQL inicia. (Bug #986) Um erro de documentao: ela dizia que RESET SLAVE no altera a informao de ca a ca conexo (master host, port, user e password), embora ela o zesse. A instruo retorna a ca estes valores para a opo de inicializao (master-host etc) se houvesse alguma. (Bug ca ca #985)

974

MySQL Technical Reference for Version 5.0.0-alpha

SHOW SLAVE STATUS agora exibe a informao correta (master host, port, user e passca word) depois de RESET SLAVE (isto , ela mostra os novos valores, que so copiados das e a opes de inicializao se houver alguma). (Bug #985) co ca Disabilitada a propagao da posio original do log do master para eventos porque ca ca isto gerava valores inesperados para Exec_Master_Log_Pos e problemas com MASTER_ POS_WAIT() em conguraes de replicao A->B->C. (Bug #1086) co ca Corrigido uma segmentation fault no mysqlbinlog quando --position=x era usado com x estando entre um evento Create_file e o evento Append_block, Exec_load ou Delete_file. (Bug #1091) mysqlbinlog exibia avisos superuos quando se usava --database, o que causava erro de sintaxe quando enviado para mysql. (Bug #1092) O mysqlbinlog --database tambm ltra LOAD DATA INFILE (anteriormente, ele le trava todas as consultas exceto LOAD DATA INFILE). (Bug #1093) O mysqlbinlog em alguns casos esquece de colocar um # em frente do LOAD DATA INFILE original (este comando exibido apenas para informao, no para ser exee ca a cutado; mais tarde ele funcionava como LOAD DATA LOCAL com um nome de arquivo diferente, para execuo pelo mysql). (Bug #1096) ca binlog-do-db e binlog-ignore-db ltravam LOAD DATA INFILE incorretamente (ele era escrito parcialmente para o log binrio). Isto resultava em um corrompimento do a log binrio, que podia fazer o slave parar com um erro. (Bug #1100) a Quando, em uma transao, um tabela transacional (como uma tabela InnoDB) era ca atualizada, e posteriormente na mesma transao um tabela no transacional (como ca a um tabela MyISAM) era atualizada usando o contedo atualizado da tabela transacional u (com INSERT ... SELECT por exemplo), as consultas eram escritas no log binrio em a uma ordem incorreta. (Bug #873) Quando em uma transao, INSERT ... SELECT atualizava uma tabela no transaca a cional, e um ROLLBACK era executado, nenhum erro era atualizado para o cliente. Agora o cliente avisado que no se pode fazer roll back de algumas alteraes, como j era e a co a o caso para um INSERT normal. (Bug #1113) Corrigido um erro portencial: Quando STOP SLAVE era executado enquanto a thread slave de SQL estava no meio de uma transao, e ento CHANGE MASTER era usado para ca a direcionar para o slave para alguma instruo no transacional, a thread slave de SQL ca a cava confusa (porque ela ainda podia achar que estava em uma transao). ca

D.3.4 Alteraes na distribuio 4.0.14 (18 Jul 2003) co ca

Funcionalidades adicionadas ou alteradas: InnoDB agora suporta indexao pelo prexo de um campo. Isto signica, em particuca larm que as colunas BLOB e TEXT pode ser indexadas em tabelas InnoDB, o que no era a poss antes. ivel Uma alterao de documentao: Funo INTERVAL(NULL, ...) retorna -1. ca ca ca Habilitado o INSERT do SELECT quando a tabela na qual os registros so inseridos a tambm uma tabela listada no SELECT. e e Permite CREATE TABLE e INSERT de qualquer UNION.

Apndice D: Histrico de Alteraes do MySQL e o co

975

A opo SQL_CALC_FOUND_ROWS agora sempre retorna o nmero total de rgistro de ca u qulquer UNION. Removida a opo --table de mysqlbinlog para evitar repetir a funcionalidade ca mysqldump. Alterado levemente o otimizador para preferir busca de indice sobre busca em toda a tabela em alguns casos limites. Adicionado uma varivel especica da thread, max_seeks_for_key, que pode ser usada a para forar a otimizao para usar chaves em vez de varrer a tabela, mesmo se a c ca cardinalidade do indice for baixa. Adicionada a otimizao que converte LEFT JOIN para joins normais em alguns casos. ca Uma alterao da documentao: adicionado um pargrafo sobre falhas em replicao ca ca a ca (como usar um slave sobrevivente como um novo master, como resumir a congurao ca original). Veja Seo 4.11.9 [Replication FAQ], Pgina 410. ca a Uma alterao de documentao: adicionado avisos sobre uso seguro do comando ca ca CHANGE MASTER. Veja Seo 4.11.8.1 [CHANGE MASTER TO], Pgina 402. ca a O MySQL agora envia um aviso (e no um erro, como na verso 4.0.13) quando ele a a abre uma tabela que foi criada com o MySQL 4.1. Adicionada a opo --nice para mysqld_safe para permitir congurar a exatido do ca a processo mysqld. (Obrigado a Christian Hammers por fornecer o patch inicial.) (Bug #627) Adicionada a opo --read-only para que o mysqld no permita atualizaes, exceto ca a co da thread escrava ou de usurios com o privilgio SUPER. (Pacth original de Markus a e Benning). SHOW BINLOG EVENTS FROM x onde x menor que 4, agora converte silenciosamente x e para 4 em vez de exibir um erro. A mesma alterao foi feita para CHANGE MASTER TO ca MASTER_LOG_POS=x e CHANGE MASTER TO RELAY_LOG_POS=x. mysqld agora s adiciona um tratamento de interrupo para o sinal SIGINT se voc o ca e come-lo com a nova opo --gdb. Isto porque alguns usurios MySQL encontraram ca ca e a alguns problemas estranhos quando acidentalmente enviavam SIGINT para a threads mysqld. RESET SLAVE agora limpa os campos Last_Errno e Last_Error na sa de SHOW SLAVE ida STATUS. Adicionada a varivel max_relay_log_size; o relay log ser rotacionado automaticaa a mente quando seu tamanho exceder max_relay_log_size. Mas se max_relay_log_ size for 0 (o padro), max_binlog_size ser usado (como em verses mais antigas). a a o max_binlog_size ainda se aplica a logs binrios em qualquer caso de uso. a FLUSH LOGS agora rotaciona os relay logs em adio aos outros tipos de logs que ele j ca a rotacionava. Bugs corrigidos: Comparao/ordenao para o conjunto de caracteres latin1_de foi reescrita. O alca ca goritmo antigo no podia tratar casos como "s" > "a". Veja Seo 4.7.1.1 [German a a ca character set], Pgina 326. Em casos raros ela resultava em tabela corrompida. a Corrigido um problema com a prompt de senha no Windows. (Bug #683)

976

MySQL Technical Reference for Version 5.0.0-alpha

ALTER TABLE ... UNION=(...) para uma tabela MERGE agora permitida mesmo que e alguma tabela MyISAM seja somente leitura. (Bug #702) Corrigido um problema com CREATE TABLE t1 SELECT x41. (Bug #801) Removido alguns avisos de lock incorretos do log de erro. Corrigida um estouro de memria ao se fazer REPAIR em uma tabela com uma chave o auto incremento multi-partes onde uma parte era um pacote CHAR. Corrigida uma provvel condio de corrida no cdigo da replicao que podia levar a ca o ca potencialmente a instrues INSERT no sendo replicadas no evento de um comando co a FLUSH LOGS ou quando o log binrio excede max_binlog_size. (Bug #791) a Corrigido um bug que pode levar a falha em INTERVAL e GROUP BY ou DISTINCT. (Bug #807) Corrigido um bug no mysqlhotcopy, assim ele agora aborta em operaes de cpia co o de tabelas sem sucesso. Corrigido outro bug, assim ele obtem sucesso quando houver milhares de tabelas para copiar. (Bug #812) Corrigido o problema com mysqlhotcopy que falhava ao ler opes do arquivo de opo. co ca (Bug #808) Corrigido um bug no otimizador que algumas vezes prevenia o MySQL de usar indices FULLTEXT mesmo se fosse poss ivel (por exemplo, em SELECT * FROM t1 WHERE MATCH a,b AGAINST("index") > 0). Corrigido um bug com table is full em operaes UNION. co Corrigido um problema de segurana no qual usurios habilitados sem privilgios obtinc a e ham informaes na lista de banco de dados existentes usando SHOW TABLES e comandos co parecidos. Corrigido um problema de pilha no UnixWare/OpenUnix. Corrigido um problema de congurao UnixWare/OpenUNIX e OpenServer. ca Corrigido um problema de pilha cheia na vericao da senha. ca Corrigido um problema com max_user_connections. HANDLER sem um indice agora funciona apropriadamente quando uma tabela tem registros deletados. (Bug #787) Corrigido um erro com LOAD DATA em mysqlbinlog. (Bug #670) Correo: SET CHARACTER SET DEFAULT fucniona. (Bug #462) ca Corrigido o comportamento de tabelas MERGE em consultas ORDER BY ... DESC. (Bug #515) Corrigida a falha do servidor em PURGE MASTER LOGS ou SHOW MASTER LOGS quando o log binrio estava desligado. (Bug #733) a Corrigido o problema de vericao de senha no Windows. (Bug #464) ca Corrigido um erro na comparao de uma coluna DATETIME e uma constante inteira. ca (Bug #504) Corrigido o modo remoto de mysqlbinlog. (Bug #672) Corrigido ERROR 1105: Unknown error que ocorria para algumas consultas SELECT, onde uma coluna declarada como NOT NULL era comparada com uma expresso que a podia tomar o valor NULL.

Apndice D: Histrico de Alteraes do MySQL e o co

977

Alterado o timeout em mysql_real_connect() para usar poll() em vez de select() para contornar problemas cmo muitos outros arquivos abertos no cliente. Corrigido resultados incorretos de MATCH ... AGAINST usado com uma consulta LEFT JOIN. Corrigido um bug que limitava o valor mximo para variveis mysqld em 4294967295 a a quando eles eram especicados na linha de comando. Corrigido um bug que algumas vezes causavam falsos erros de Access denied nas instrues HANDLER ... READ, quando uma tabela referenciada via um alias. co e Corrigido um problema de portabilidade com safe_malloc, o qual fazia com que o MySQL para enviar erros de "Freeing wrong aligned pointer" no SCO 3.2. ALTER TABLE ... ENABLE/DISABLE KEYS podia causar um core dump quando feito depois de uma instruo INSERT DELAYED na mesma tabela. ca Corrigido um problema com converso da hora local para GMT onde algumas vezes a resultava em diferentes (mas corretos) timestamps. Agora o MySQL deve usar o menor valor de poss neste caso. (Bug #316) ivel Uma cache de consultas muito pequena podia fazer o mysqld falhar. (Bug #549) Corrigido um bug (acidentalemnte introduzida por ns mas presente apenas na verso o a 4.0.13) que faz INSERT ... SELECT em uma coluna AUTO_INCREMENT que no replica a bem. Este bug est no master, no no slave. (Bug #490) a a Corrigido um bug: Quando uma instruo INSERT ... SELECT inseria linhas em uma ca tabela no transacional, mas falhava no mesmo ponto (por exemplo, devido a erros de a Duplicate key), a consulta no era escrita no log binrio. Agora ela escrita no log a a e binrio, com seus cdigos de erros, como todas as outras cosultas so. Sobre a opo a o a ca slave-skip-errors para como tratar consultas completadas parcialmente no slave, veja Seo 4.11.6 [Replication Options], Pgina 392. (Bug #491) ca a SET FOREIGN_KEY_CHECKS=0 no era replicado apropriadamente. A correo provavela ca mente no ser feita para 3.23. a a Em um slave, LOAD DATA INFILE sem clusulas IGNORE ou REPLACE no master, era a replicada com IGNORE. Enquanto isto no for um problemase os dados do master e a slave so identicos (em LOAD que no produz conitos de duplicao no master no a a ca a produzir nada no slave de qualquer forma), o que verdade em operaes normais, a e co para depurao melhor no adicionar silenciosamente o IGNORE. Deste modo, voc ca e a e pode obter uma mensagem de erro no slave e descobrir que por alguma razo, os dados a no master e slave so diferentes e investigar o porque. (Bug #571) a Em um slave, LOAD DATA INFILE exibia uma mensagem incomplete Duplicate entry %-.64s for key %d (o nome e valor da chave no eram mencionados) no caso de a conito de duplicao (o que no acontece em operaes normais). (Bug #573) ca a co Quando usado um slave compilado com --debug, CHANGE MASTER TO RELAY_LOG_POS podia causar um falha de declarao da depurao. (Bug #576) ca ca Ao fazer um LOCK TABLES WRITE em uma tabela InnoDB, o commit podia no acontecer, a se a consulta no era escrita no log binrio (por exemplo, se --log-bin no era usado, a a a ou binlog-ignore-db era usado). (Bug #578) Se um master na verso 3.23 tivesse aberto tabelas temporrias que tinham sido replia a cadas para um slave na verso 4.0, e o log binrio rotacionado, estas tabelas temporrias a a a

978

MySQL Technical Reference for Version 5.0.0-alpha

eram automaticamente removidas pelo slave (o que causa problemas se o master os utiliza subsequecialmente). Este erro foi corrigido na verso 4.0.13, mas de um modo a que cria um incovenincia indesejada: se o master na verso 3.23 morrer brutalmente. e a (queda de fora), sem tempo suciente para escrever automaticamente instrues DROP c co TABLE em seu log binrio. ento o slave na verso 4.0.13 no noticaria que as tabelas a a a a temporrias tinham sido removidas, at o servidor mysqld slave ter sido reiniciado. a e Este pequeno incoveniente est corrigido na verso 3.23.57 e 4.0.14 (signicando que o a a master deve ser atualizado para a verso 3.23.57 e o slave para a 4.0.14 para remover a o incoveniente). (Bug #254) Se MASTER_POS_WAIT() estava espereando e o slave estava inativo, e thread slave de SQL terminada, MASTER_POS_WAIT() esperaria para sempre. Agora quando a thread slave de SQL termina, MASTER_POS_WAIT() retorna NULL imediatamente (slave stopped). (Bug #651) Depois de RESET SLAVE; START SLAVE;, o valor de Relay_Log_Space exibido por SHOW SLAVE STATUS era muito grande para 4 bytes. (Bug #763) Se uma consulta era ignorada no slave (devido a replicate-ignore-table e outras regras similares), o escravo ainda verica se a consulta consegue o mesmo cdigo de o erro (0, sem erro) como no master. Assim se o master tiver um erro na consulta (por exemplo, Duplicate entry em uma insero de mltiplas linhas), ento o slave parava ca u a e avisava que cdigo de erro no coincidia. (Bug #797) o a

D.3.5 Alteraes na distribuio 4.0.13 (16 May 2003) co ca

Funcionalidades adicionadas ou alteradas: PRIMARY KEY agora implica NOT NULL. (Bug #390) a a O pacote de binrios do Windows agora est compilado com --enable-local-infile encontrar a congura`o de construo do Unix. ca ca Removida a medida do tempo de mysql-test-run. time no aceita todos os a parmetros exigidos em muitas aplicaes (por exemplo, QNX) e a medida de tempo a co no reamente necessria (isto no um benchmark). a e a a e SHOW MASTER STATUS e SHOW SLAVE STATUS exigem o privilgio SUPER; agora eles e aceitam REPLICATION CLIENT. (Bug #343) Adicionada otimizao de reparao do MyISAM em multi-threads e a varivel ca ca a myisam_repair_threads para habilit-lo. a Veja Seo 4.6.8.4 [myisam_repair_ ca threads], Pgina 309. a Adicionada a varivel innodb_max_dirty_pages_pct que controla a quantidade de a pginas sujas permitidas na rea de buer do InnoDB. a a As mensagens de erro CURRENT_USER() e Access denied agora relatam o nome de mquina exatamente como ele est especicado no comando GRANT. a a Removido os resultados de benchmark das distribuies fonte e binrias. Eles ainda co a esto dispon a iveis na rvore fonte do BK. a Tabelas InnoDB agora suportam ANALYZE TABLE. O MySQL agora envia um erro quando ele abre uma tabela que foi criada com o MySQL 4.1.

Apndice D: Histrico de Alteraes do MySQL e o co

979

A opo --new agora altera altera os itens binrios (0xFFDF) para serem tratados ca a como strings binrias em vez de nmeros por padro. Isto corrige alguns problemas a u a com conjunto de caracteres onde conveniente colocar a string como um item binrio. e a Depois destas alteraes voc deve converter a string binria para INTEGER com um co e a CAST se voc quiser comparar dois itens binrios, um com o outro, e saber qual e a e maior. SELECT CAST(0xfeff AS UNSIGNED) < CAST(0xff AS UNSIGNED). Este ser o a comportamento padro no MySQL 4.1. (Bug #152) a Habilitado delayed_insert_timeout no Linux (as bibliotecas glibc mais modernas tem um pthread_cond_timedwait corrigido). (Bug #211) No cria mais threads de insert delayed que o dado por max_insert_delayed_threads. a (Bug #211) Alterado o UPDATE ... LIMIT para aplicar o limite as linhas encontradas, independente de terem sido alteradas. Anteriormente o limite era aplicado como uma restrio no ca nmero de linhas alteradas. u Ajustado o otimizador para favorecer ind ices em cluster em ver de busca na tabela. BIT_AND() e BIT_OR() agora retornam um valor de 64 bits sem sinal. Adicionado avisos ao log de erro do porqu de um falha em uma conexo segura (quando e a executando com --log-warnings). As opes --skip-symlink e --use-symbolic-links esto obsoletas e forma subco a stitu idas com --symbolic-links. A opo padro para innodb_flush_log_at_trx_commit foi alterada de 0 para 1 ca a para tornar tabelas InnoDB como ACID por padro. Veja Seo 7.5.3 [InnoDB start], a ca Pgina 644. a Adicionado o recurso para SHOW KEYS para mostrar chaves que esto disabilitadas pelo a comando ALTER TABLE DISABLE KEYS. Ao usar um tipo de tabela no existente com CREATE TABLE, primeiro v se o tipo de a e tabela padro existe antes de utilizar MyISAM. a Adicionado MEMORY como um alias para HEAP. Renomeada a funo rnd para my_rnd j que o nome era muito genrico e um s ca a e e imbolo exportado no libmysqlclient (obrigado a Dennis Haney pelo patch inicial). Correo de portabilidade: renomeado include/dbug.h para include/my_debug.h. ca mysqldump no deleta mais o log binrio sem aviso quando chamado com --mastera a data ou --first-slave; enquanto este comportamento era conveniente para alguns usurios, outros podia sofrer com ele. Agora deve perguntar explicitamente pela sua a deleo com a nova opo --delete-master-logs. ca ca Se o slave congurado (usando, por exemplo, replicate-wild-ignoree table=mysql.%) para ecluir mysql.user, mysql.host, mysql.db, mysql.tables_priv e mysql.columns_priv da replicao, ento GRANT e REVOKE no sero replicados. ca a a a Bugs corrigidos: A mensagem de erro Access denied ao logar tinha um valor Using password incorreto. (Bug #398) Corrigido um bug com NATURAL LEFT JOIN, NATURAL RIGHT JOIN e RIGHT JOIN quando usadas muitas tabelas em joins. O problema era que o mtodo JOIN no era sempre e a

980

MySQL Technical Reference for Version 5.0.0-alpha

associoado com as tabelas envolvida no mtodo JOIN. Se voc tiver uma consulta que e e usa muitos RIGHT JOIN ou NATURAL ... JOINS voc deve vericar se eles funcionam e como voc espera depois de atualizar o MySQL para esta versa. (Bug #291) e o O cliente de linha de comando mysql no olha mais os comnados \* dentro de stringd a com aspas invertidas. Corrigido Unknown error ao usar UPDATE ... LIMIT. (Bug #373) Corrigido o problema com o modo ANSI e GROUP BY com constantes. (Bug #387) Corrigido o erro com UNION e OUTER JOIN. (Bug #386) Corrigido o erro se usado um UPDATE multi-tabelas e a consulta exige um tabela e temporria maior que tmp_table_size. (Bug #286) a Executa mysql_install_db com a opo -IN-RPM para a instalao do Mac OS X no ca ca a falhar em sistemas com a congurao de nome de mquina feita de forma inapropriada. ca a LOAD DATA INFILE agora ir ler 000000 como uma data zerada em vez de "2000-00a 00". Corrigido um erro que fazia que DELETE FROM table WHERE const_expression sempre deletasse toda a tabela (mesmo se o resultado da expresso fosse falso). (Bug #355) a Corrigido um bug de core dump ao usar FORMAT(nan,#). (Bug #284) Corrigido um erro na resoluo do nome com HAVING ... COUNT(DISTINCT ...). ca Corrigido resultados incorretos da operao de truncamento (*) em MATCH ... ca AGAINST() em alguns joins complexos. Fixed a crash in REPAIR ... USE_FRM command, when used on read-only, nonexisting table or a table with a crashed index le. Fixed a crashing bug in mysql monitor program. It occurred if program was started with --no-defaults, with a prompt that contained hostname and connection to nonexisting db was requested Fixed problem when comparing a key for a multi-byte-character set. (Bug #152) Fixed bug in LEFT, RIGHT and MID when used with multi-byte character sets and some GROUP BY queries. (Bug #314) Fix problem with ORDER BY being discarded for some DISTINCT queries. (Bug #275) Fixed that SET SQL_BIG_SELECTS=1 works as documented (This corrects a new bug introduced in 4.0) Fixed some serious bugs in UPDATE ... ORDER BY. (Bug #241) Fixed unlikely problem in optimising WHERE clause with constant expression like in WHERE 1 AND (a=1 AND b=1). Fixed that SET SQL_BIG_SELECTS=1 works again. Introduced proper backtick quoting for db.table in SHOW GRANTS. FULLTEXT index stopped working after ALTER TABLE that converts TEXT column to CHAR. (Bug #283) Fixed a security problem with SELECT and wildcarded select list, when user only had partial column SELECT privileges on the table. Mark a MyISAM table as "analyzed" only when all the keys are indeed analyzed.

Apndice D: Histrico de Alteraes do MySQL e o co

981

Only ignore world-writeable my.cnf les that are regular les (and not, for example, named pipes or character devices). Fixed few smaller issues with SET PASSWORD. Fixed error message which contained deprecated text. Fixed a bug with two NATURAL JOINs in the query. SUM() didnt return NULL when there was no rows in result or when all values was NULL. On Unix symbolic links handling was not enabled by default and there was no way to turn this on. Added missing dashes to parameter --open-files-limit in mysqld_safe. (Bug #264) Fixed incorrect hostname for TCP/IP connections displayed in SHOW PROCESSLIST. Fixed a bug with NAN in FORMAT(...) function ... Fixed a bug with improperly cached database privileges. Fixed a bug in ALTER TABLE ENABLE / DISABLE KEYS which failed to force a refresh of table data in the cache. Fixed bugs in replication of LOAD DATA INFILE for custom parameters (ENCLOSED, TERMINATED and so on) and temporary tables. (Bug #183, Bug #222) Fixed a replication bug when the master is 3.23 and the slave 4.0: the slave lost the replicated temporary tables if FLUSH LOGS was issued on the master. (Bug #254) Fixed a bug when doing LOAD DATA INFILE IGNORE: When reading the binary log, mysqlbinlog and the replication code read REPLACE instead of IGNORE. This could make the slaves table become dierent from the masters table. (Bug #218) Fixed a deadlock when relay_log_space_limit was set to a too small value. (Bug #79) Fixed a bug in HAVING clause when an alias is used from the select list. Fixed overow bug in MyISAM when a row is inserted into a table with a large number of columns and at least one BLOB/TEXT column. Bug was caused by incorrect calculation of the needed buer to pack data. Fixed a bug when SELECT @nonexistent variable caused the error in client - server protocol due to net printf() being sent to the client twice. Fixed a bug in setting SQL_BIG_SELECTS option. Fixed a bug in SHOW PROCESSLIST which only displayed a localhost in the "Host" column. This was caused by a glitch that only used current thread information instead of information from the linked list of threads. Removed unnecessary Mac OS X helper les from server RPM. (Bug #144) Allow optimization of multiple-table update for InnoDB tables as well. Fixed a bug in multiple-table updates that caused some rows to be updated several times. Fixed a bug in mysqldump when it was called with --master-data: the CHANGE MASTER TO commands appended to the SQL dump had incorrect coordinates. (Bug #159) Fixed a bug when an updating query using USER() was replicated on the slave; this caused segfault on the slave. (Bug #178). USER() is still badly replicated on the slave (it is replicated to "").

982

MySQL Technical Reference for Version 5.0.0-alpha

D.3.6 Alteraes na distribuio 4.0.12 (15 Mar 2003: co ca Production)

Functionality added or changed: mysqld no longer reads options from world-writeable cong les. Integer values between 9223372036854775807 and 9999999999999999999 are now regarded as unsigned longlongs, not as oats. This makes these values work similar to values between 10000000000000000000 and 18446744073709551615. SHOW PROCESSLIST will now include the client TCP port after the hostname to make it easier to know from which client the request originated. Bugs xed: Fixed mysqld crash on extremely small values of sort_buffer variable. INSERT INTO u SELECT ... FROM t was written too late to the binary log if t was very frequently updated during the execution of this query. This could cause a problem with mysqlbinlog or replication. The master must be upgraded, not the slave. (Bug #136) Fixed checking of random part of WHERE clause. (Bug #142) Fixed a bug with multiple-table updates with InnoDB tables. This bug occurred as, in many cases, InnoDB tables cannot be updated on the y, but osets to the records have to be stored in a temporary table. Added missing le mysql_secure_installation to the server RPM subpackage. (Bug #141) Fixed MySQL (and myisamchk) crash on articially corrupted .MYI les. Dont allow BACKUP TABLE to overwrite existing les. Fixed a bug with multi-table UPDATE statements when user had all privileges on the database where tables are located and there were any entries in tables_priv table, that is, grant_option was true. Fixed a bug that allowed a user with table or column grants on some table, TRUNCATE any table in the same database. Fixed deadlock when doing LOCK TABLE followed by DROP TABLE in the same thread. In this case one could still kill the thread with KILL. LOAD DATA LOCAL INFILE was not properly written to the binary log (hence not properly replicated). (Bug #82) RAND() entries were not read correctly by mysqlbinlog from the binary log which caused problems when restoring a table that was inserted with RAND(). INSERT INTO t1 VALUES(RAND()). In replication this worked ok. SET SQL_LOG_BIN=0 was ignored for INSERT DELAYED queries. (Bug #104) SHOW SLAVE STATUS reported too old positions (columns Relay_Master_Log_File and Exec_Master_Log_Pos) for the last executed statement from the master, if this statement was the COMMIT of a transaction. The master must be upgraded for that, not the slave. (Bug #52) LOAD DATA INFILE was not replicated by the slave if replicate_*_table was set on the slave. (Bug #86)

Apndice D: Histrico de Alteraes do MySQL e o co

983

After RESET SLAVE, the coordinates displayed by SHOW SLAVE STATUS looked un-reset (though they were, but only internally). (Bug #70) Fixed query cache invalidation on LOAD DATA. Fixed memory leak on ANALYZE procedure with error. Fixed a bug in handling CHAR(0) columns that could cause incorrect results from the query. Fixed rare bug with incorrect initialisation of AUTO_INCREMENT column, as a secondary column in a multi-column key (veja Seo 3.6.9 [AUTO_INCREMENT on secondary column ca in a multi-column key], Pgina 201), when data was inserted with INSERT ... SELECT a or LOAD DATA into an empty table. On Windows, STOP SLAVE didnt stop the slave until the slave got one new command from the master (this bug has been xed for MySQL 4.0.11 by releasing updated 4.0.11a Windows packages, which include this individual x on top of the 4.0.11 sources). (Bug #69) Fixed a crash when no database was selected and LOAD DATA command was issued with full table name specied, including database prex. Fixed a crash when shutting down replication on some platforms (for example, Mac OS X). Fixed a portability bug with pthread_attr_getstacksize on HP-UX 10.20 (Patch was also included in 4.0.11a sources). Fixed the bigint test to not fail on some platforms (for example, HP-UX and Tru64) due to dierent return values of the atof() function. Fixed the rpl_rotate_logs test to not fail on certain platforms (e.g. Mac OS X) due to a too long le name (changed slave-master-info.opt to .slave-mi).

D.3.7 Alteraes na distribuio 4.0.11 (20 Feb 2003) co ca

Functionality added or changed: NULL is now sorted LAST if you use ORDER BY ... DESC (as it was before MySQL 4.0.2). This change was required to comply with the SQL-99 standard. (The original change was made because we thought that SQL-99 required NULL to be always sorted at the same position, but this was incorrect). Added START TRANSACTION (SQL-99 syntax) as alias for BEGIN. This is recommended to use instead of BEGIN to start a transaction. Added OLD_PASSWORD() as a synonym for PASSWORD(). Allow keyword ALL in group functions. Added support for some new INNER JOIN and JOIN syntaxes. For example, SELECT * FROM t1 INNER JOIN t2 didnt work before. Novell NetWare 6.0 porting eort completed, Novell patches merged into the main source tree. Bugs xed: Fixed problem with multiple-table delete and InnoDB tables.

984

MySQL Technical Reference for Version 5.0.0-alpha

Fixed a problem with BLOB NOT NULL columns used with IS NULL. Re-added missing pre- and post(un)install scripts to the Linux RPM packages (they were missing after the renaming of the server subpackage). Fixed that table locks are not released with multi-table updates and deletes with InnoDB storage engine. Fixed bug in updating BLOB columns with long strings. Fixed integer-wraparound when giving big integer (>= 10 digits) to function that requires an unsigned argument, like CREATE TABLE (...) AUTO_INCREMENT=#. MIN(key_column) could in some cases return NULL on a column with NULL and other values. MIN(key_column) and MAX(key_column) could in some cases return incorrect values when used in OUTER JOIN. MIN(key_column) and MAX(key_column) could return incorrect values if one of the tables was empty. Fixed rare crash in compressed MyISAM tables with blobs. Fixed bug in using aggregate functions as argument for INTERVAL, CASE, FIELD, CONCAT_WS, ELT and MAKE_SET functions. When running with --lower-case-table-names (default on Windows) and you had tables or databases with mixed case on disk, then executing SHOW TABLE STATUS followed with DROP DATABASE or DROP TABLE could fail with Errcode 13.

D.3.8 Alteraes na distribuio 4.0.10 (29 Jan 2003) co ca

Functionality added or changed: Added option --log-error[=file_name] to mysqld_safe and mysqld. This option will force all error messages to be put in a log le if the option --console is not given. On Windows --log-error is enabled as default, with a default name of host_name.err if the name is not specied. Changed some things from Warning: to Note: in the log les. The mysqld server should now compile on NetWare. Added optimization that if one does GROUP BY ... ORDER BY NULL then result is not sorted. New --ft-stopword-file command-line option for mysqld to replace/disable the built-in stopword list that is used in full-text searches. Veja Seo 4.6.8.4 ca [ft_stopword_file], Pgina 309. a Changed default stack size from 64K to 192K; This xes a core dump problem on Red Hat 8.0 and other systems with a glibc that requires a stack size larger than 128K for gethostbyaddr() to resolve a hostname. You can x this for earlier MySQL versions by starting mysqld with --thread-stack=192K. Added mysql_waitpid to the binary distribution and the MySQL-client RPM subpackage (required for mysql-test-run). Renamed the main MySQL RPM package to MySQL-server. When updating from an older version, MySQL-server.rpm will simply replace MySQL.rpm.

Apndice D: Histrico de Alteraes do MySQL e o co

985

If a slave is congured with replicate_wild_do_table=db.% or replicate_wild_ ignore_table=db.%, these rules will be applied to CREATE/DROP DATABASE too. Added timeout value for MASTER_POS_WAIT(). Bugs xed: Fixed initialisation of the random seed for newly created threads to give a better rand() distribution from the rst call. Fixed a bug that caused mysqld to hang when a table was opened with the HANDLER command and then dropped without being closed. Fixed bug in logging to binary log (which aects replication) a query that inserts a NULL in an AUTO_INCREMENT column and also uses LAST_INSERT_ID(). Fixed an unlikely bug that could cause a memory overrun when using ORDER BY constant_expression. Fixed a table corruption in myisamchks parallel repair mode. Fixed bug in query cache invalidation on simple table renaming. Fixed bug in mysqladmin --relative. On some 64 bit systems, show status reported a strange number for Open_files and Open_streams. Fixed incorrect number of columns in EXPLAIN on empty table. Fixed bug in LEFT JOIN that caused zero rows to be returned in the case the WHERE condition was evaluated as FALSE after reading const tables. (Unlikely condition). FLUSH PRIVILEGES didnt correctly ush table/column privileges when mysql.tables_ priv is empty. Fixed bug in replication when using LOAD DATA INFILE one a le that updated an AUTO_INCREMENT column with NULL or 0. This bug only aected MySQL 4.0 masters (not slaves or MySQL 3.23 masters). Note: If you have a slave that has replicated a le with generated AUTO_INCREMENT columns then the slave data is corrupted and you should reinitialise the aected tables from the master. Fixed possible memory overrun when sending a BLOB value larger than 16M to the client. Fixed incorrect error message when setting a NOT NULL column to an expression that returned NULL. Fixed core dump bug in str LIKE "%other_str%" where str or other_str contained characters >= 128. Fixed bug: When executing on master LOAD DATA and InnoDB failed with table full error the binary log was corrupted.

D.3.9 Alteraes na distribuio 4.0.9 (09 Jan 2003) co ca

Functionality added or changed: OPTIMIZE TABLE will for MyISAM tables treat all NULL values as dierent when calculating cardinality. This helps in optimising joins between tables where one of the tables has a lot of NULL values in a indexed column:

986

MySQL Technical Reference for Version 5.0.0-alpha

SELECT * from t1,t2 where t1.a=t2.key_with_a_lot_of_null; Added join operator FORCE INDEX (key_list). This acts likes USE INDEX (key_list) but with the addition that a table scan is assumed to be VERY expensive. One bad thing with this is that it makes FORCE a reserved word. Reset internal row buer in MyISAM after each query. This will reduce memory in the case you have a lot of big blobs in a table. Bugs xed: A security patch in 4.0.8 causes the mysqld server to die if the remote hostname cant be resolved. This is now xed. Fixed crash when replication big LOAD DATA INFILE statement that caused log rotation.

D.3.10 Alteraes na distribuio 4.0.8 (07 Jan 2003) co ca

Functionality added or changed: Default max_packet_length for libmysqld.c is now 1024*1024*1024. One can now specify max_allowed_packet in a le ready by mysql_options(MYSQL_ READ_DEFAULT_FILE). for clients. When sending a too big packet to the server with the not compressed protocol, the client now gets an error message instead of a lost connection. We now send big queries/result rows in bigger hunks, which should give a small speed improvement. Fixed some bugs with the compressed protocol for rows > 16M. InnoDB tables now also support ON UPDATE CASCADE in FOREIGN KEY constraints. See the InnoDB section in the manual for the InnoDB changelog. Bugs xed: Fixed bug in ALTER TABLE with BDB tables. Fixed core dump bug in QUOTE() function. Fixed a bug in handling communication packets bigger than 16M. Unfortunately this required a protocol change; If you upgrade the server to 4.0.8 and above and have clients that uses packets >= 255*255*255 bytes (=16581375) you must also upgrade your clients to at least 4.0.8. If you dont upgrade, the clients will hang when sending a big packet. Fixed bug when sending blobs longer than 16M to client. Fixed bug in GROUP BY when used on BLOB column with NULL values. Fixed a bug in handling NULL values in CASE ... WHEN ...

D.3.11 Alteraes na distribuio 4.0.7 (20 Dec 2002) co ca

Functionality added or changed: mysqlbug now also reports the compiler version used for building the binaries (if the compiler supports the option --version).

Apndice D: Histrico de Alteraes do MySQL e o co

987

Bugs xed: Fixed compilation problems on OpenUnix and HPUX 10.20. Fixed some optimization problems when compiling MySQL with -DBIG_TABLES on a 32 bit system. mysql_drop_db() didnt check permissions properly so anyone could drop another users database. DROP DATABASE is checked properly.

D.3.12 Alteraes na distribuio 4.0.6 (14 Dec 2002: Gamma) co ca

Functionality added or changed: Added syntax support for CHARACTER SET xxx and CHARSET=xxx table options (to be able to read table dumps from 4.1). Fixed replication bug that caused the slave to loose its position in some cases when the replication log was rotated. Fixed that a slave will restart from the start of a transaction if its killed in the middle of one. Moved the manual pages from man to man/man1 in the binary distributions. The default type returned by IFNULL(A,B) is now set to be the more general of the types of A and B. (The order is STRING, REAL or INTEGER). Moved the mysql.server startup script in the RPM packages from /etc/rc.d/init.d/mysql to /etc/init.d/mysql (which almost all current Linux distributions support for LSB compliance). Added Qcache_lowmem_prunes status variable (number of queries that were deleted from cache because of low memory). Fixed mysqlcheck so it can deal with table names containing dashes. Bulk insert optimization (veja Seo 4.6.8.4 [bulk_insert_buffer_size], Pgina 309) ca a is no longer used when inserting small (less than 100) number of rows. Optimization added for queries like SELECT ... FROM merge_table WHERE indexed_ column=constant_expr. Added functions LOCALTIME and LOCALTIMESTAMP as synonyms for NOW(). CEIL is now an alias for CEILING. The CURRENT_USER() function can be used to get a user@host value as it was matched in the GRANT system. Veja Seo 6.3.6.2 [CURRENT_USER()], Pgina 547. ca a Fixed CHECK constraints to be compatible with SQL-99. This made CHECK a reserved word. (Checking of CHECK constraints is still not implemented). Added CAST(... as CHAR). Added PostgreSQL compatible LIMIT syntax: SELECT ... LIMIT row_count OFFSET offset mysql_change_user() will now reset the connection to the state of a fresh connect (Ie, ROLLBACK any active transaction, close all temporary tables, reset all user variables etc..)

988

MySQL Technical Reference for Version 5.0.0-alpha

CHANGE MASTER and RESET SLAVE now require that slave threads be both already stopped; these commands will return an error if at least one of these two threads is running. Bugs xed: Fixed number of found rows returned in multi table updates Make --lower-case-table-names default on Mac OS X as the default le system (HFS+) is case insensitive. Veja Seo 6.1.3 [Name case sensitivity], Pgina 473. ca a Transactions in AUTOCOMMIT=0 mode didnt rotate binary log. A x for the bug in a SELECT with joined tables with ORDER BY and LIMIT clause when lesort had to be used. In that case LIMIT was applied to lesort of one of the tables, although it could not be. This x also solved problems with LEFT JOIN. mysql_server_init() now makes a copy of all arguments. This xes a problem when using the embedded server in C# program. Fixed buer overrun in libmysqlclient library that allowed a malicious MySQL server to crash the client application. Fixed security-related bug in mysql_change_user() handling. All users are strongly recommended to upgrade to version 4.0.6. Fixed bug that prevented --chroot command-line option of mysqld from working. Fixed bug in phrase operator "..." in boolean full-text search. Fixed bug that caused OPTIMIZE TABLE to corrupt the table under some rare circumstances. Part rewrite of multi-table-update to optimise it, make it safer and more bug free. LOCK TABLES now works together with multi-table-update and multi-table-delete. --replicate-do=xxx didnt work for UPDATE commands. (Bug introduced in 4.0.0) Fixed shutdown problem on Mac OS X. Major InnoDB bugs in REPLACE, AUTO_INCREMENT, INSERT INTO ... SELECT ... were xed. See the InnoDB changelog in the InnoDB section of the manual. RESET SLAVE caused a crash if the slave threads were running.

D.3.13 Alteraes na distribuio 4.0.5 (13 Nov 2002) co ca

Functionality added or changed: Port number was added to host name (if it is known) in SHOW PROCESSLIST command Changed handling of last argument in WEEK() so that one can get week number according to the ISO 8601 specication. (Old code should still work). Fixed that INSERT DELAYED threads doesnt hang on Waiting for INSERT when one sends a SIGHUP to mysqld. Change that AND works according to SQL-99 when it comes to NULL handling. In practice, this only aects queries where you do something like WHERE ... NOT (NULL AND 0).

Apndice D: Histrico de Alteraes do MySQL e o co

989

mysqld will now resolve basedir to its full path (with realpath()). This enables one to use relative symlinks to the MySQL installation directory. This will however cause show variables to report dierent directories on systems where there is a symbolic link in the path. Fixed that MySQL will not use index scan on index disabled with IGNORE INDEX or USE INDEX. to be ignored. Added --use-frm option to mysqlcheck. When used with REPAIR, it gets the table structure from the .frm le, so the table can be repaired even if the .MYI header is corrupted. Fixed bug in MAX() optimization when used with JOIN and ON expressions. Added support for reading of MySQL 4.1 table denition les. BETWEEN behaviour changed (veja Seo 6.3.1.2 [Comparison Operators], Pgina 504). ca a Now datetime_col BETWEEN timestamp AND timestamp should work as expected. One can create TEMPORARY MERGE tables now. DELETE FROM myisam_table now shrinks not only the .MYD le but also the .MYI le. When one uses the --open-files-limit=# option to mysqld_safe its now passed on to mysqld. Changed output from EXPLAIN from where used to Using where to make it more in line with other output. Removed variable safe_show_database as it was no longer used. Updated source tree to be built using automake 1.5 and libtool 1.4. Fixed an inadvertently changed option (--ignore-space) back to the original -ignore-spaces in mysqlclient. (Both syntaxes will work). Dont require UPDATE privilege when using REPLACE. Added support for DROP TEMPORARY TABLE ..., to be used to make replication safer. When transactions are enabled, all commands that update temporary tables inside a BEGIN/COMMIT are now stored in the binary log on COMMIT and not stored if one does ROLLBACK. This xes some problems with non-transactional temporary tables used inside transactions. Allow braces in joins in all positions. Formerly, things like SELECT * FROM (t2 LEFT JOIN t3 USING (a)), t1 worked, but not SELECT * FROM t1, (t2 LEFT JOIN t3 USING (a)). Note that braces are simply removed, they do not change the way the join is executed. InnoDB now supports also isolation levels READ UNCOMMITTED and READ COMMITTED. For a detailed InnoDB changelog, see Seo 7.5.16 [InnoDB change history], Pgina 680 in ca a this manual. Bugs xed: Fixed bug in MAX() optimization when used with JOIN and ON expressions. Fixed that INSERT DELAY threads dont hang on Waiting for INSERT when one sends a SIGHUP to mysqld. Fixed that MySQL will not use an index scan on an index that has been disabled with IGNORE INDEX or USE INDEX.

990

MySQL Technical Reference for Version 5.0.0-alpha

Corrected test for root user in mysqld_safe. Fixed error message issued when storage engine cannot do CHECK or REPAIR. Fixed rare core dump problem in complicated GROUP BY queries that didnt return any result. Fixed mysqlshow to work properly with wildcarded database names and with database names that contain underscores. Portability xes to get MySQL to compile cleanly with Sun Forte 5.0. Fixed MyISAM crash when using dynamic-row tables with huge numbers of packed elds. Fixed query cache behaviour with BDB transactions. Fixed possible oating point exception in MATCH relevance calculations. Fixed bug in full-text search IN BOOLEAN MODE that made MATCH to return incorrect relevance value in some complex joins. Fixed a bug that limited MyISAM key length to a value slightly less that 500. It is exactly 500 now. Fixed that GROUP BY on columns that may have a NULL value doesnt always use disk based temporary tables. The lename argument for the --des-key-file argument to mysqld is interpreted relative to the data directory if given as a relative pathname. Removed a condition that temp table with index on column that can be NULL has to be MyISAM. This was okay for 3.23, but not needed in 4.*. This resulted in slowdown in many queries since 4.0.2. Small code improvement in multi-table updates. Fixed a newly introduced bug that caused ORDER BY ... LIMIT row_count to not return all rows. Fixed a bug in multi-table deletes when outer join is used on an empty table, which gets rst to be deleted. Fixed a bug in multi-table updates when a single table is updated. Fixed bug that caused REPAIR TABLE and myisamchk to corrupt FULLTEXT indexes. Fixed bug with caching the mysql grant table database. Now queries in this database are not cached in the query cache. Small x in mysqld_safe for some shells. Give error if a MyISAM MERGE table has more than 2 ^ 32 rows and MySQL was not compiled with -DBIG_TABLES. Fixed some ORDER BY ... DESC problems with InnoDB tables.

D.3.14 Alteraes na distribuio 4.0.4 (29 Sep 2002) co ca

Fixed bug where GRANT/REVOKE failed if hostname was given in non-matching case. Dont give warning in LOAD DATA INFILE when setting a timestamp to a string value of 0. Fixed bug in myisamchk -R mode. Fixed bug that caused mysqld to crash on REVOKE.

Apndice D: Histrico de Alteraes do MySQL e o co

991

Fixed bug in ORDER BY when there is a constant in the SELECT statement. One didnt get an error message if mysqld couldnt open the privilege tables. SET PASSWORD FOR ... closed the connection in case of errors (bug from 4.0.3). Increased max possible max_allowed_packet in mysqld to 1 GB. Fixed bug when doing a multi-line INSERT on a table with an AUTO_INCREMENT key which was not in the rst part of the key. Changed LOAD DATA INFILE to not recreate index if the table had rows from before. Fixed overrun bug when calling AES_DECRYPT() with incorrect arguments. --skip-ssl can now be used to disable SSL in the MySQL clients, even if one is using other SSL options in an option le or previously on the command line. Fixed bug in MATCH ... AGAINST( ... IN BOOLEAN MODE) used with ORDER BY. Added LOCK TABLES and CREATE TEMPORARY TABLES privilege on the database level. One must run the mysql_fix_privilege_tables script on old installations to activate these. In SHOW TABLE ... STATUS, compressed tables sometimes showed up as dynamic. SELECT @@[global|session].var_name didnt report global | session in the result column name. Fixed problem in replication that FLUSH LOGS in a circular replication setup created an innite number of binary log les. Now a rotate-binary-log command in the binary log will not cause slaves to rotate logs. Removed STOP EVENT from binary log when doing FLUSH LOGS. Disable the use of SHOW NEW MASTER FOR SLAVE as this needs to be completely reworked in a future release. Fixed a bug with constant expression (for example, eld of a one-row table, or eld from a table, referenced by a UNIQUE key) appeared in ORDER BY part of SELECT DISTINCT. --log-binary=a.b.c now properly strips o .b.c. FLUSH LOGS removed numerical extension for all future update logs. GRANT ... REQUIRE didnt store the SSL information in the mysql.user table if SSL was not enabled in the server. GRANT ... REQUIRE NONE can now be used to remove SSL information. AND is now optional between REQUIRE options. REQUIRE option was not properly saved, which could cause strange output in SHOW GRANTS. Fixed that mysqld --help reports correct values for --datadir and --bind-address. Fixed that one can drop UDFs that didnt exist when mysqld was started. Fixed core dump problem with SHOW VARIABLES on some 64 bit systems (like Solaris sparc). Fixed a bug in my_getopt(); --set-variable syntax didnt work for those options that didnt have a valid variable in the my_option struct. This aected at least the default-table-type option. Fixed a bug from 4.0.2 that caused REPAIR TABLE and myisamchk --recover to fail on tables with duplicates in a unique key.

992

MySQL Technical Reference for Version 5.0.0-alpha

Fixed a bug from 4.0.3 in calculating the default datatype for some functions. This aected queries of type CREATE TABLE table_name SELECT expression(),... Fixed bug in queries of type SELECT * FROM table-list GROUP BY ... and SELECT DISTINCT * FROM .... Fixed bug with the --slow-log when logging an administrator command (like FLUSH TABLES). Fixed a bug that OPTIMIZE of locked and modied table, reported table corruption. Fixed a bug in my_getopt() in handling of special prexes (--skip-, --enable-). --skip-external-locking didnt work and the bug may have aected other similar options. Fixed bug in checking for output le name of the tee option. Added some more optimization to use index for SELECT ... FROM many_tables .. ORDER BY key limit # Fixed problem in SHOW OPEN TABLES when a user didnt have access permissions to one of the opened tables.

D.3.15 Alteraes na distribuio 4.0.3 (26 Aug 2002: Beta) co ca

Fixed problem with types of user variables. (Bug #551) Fixed problem with configure ... --localstatedir=.... Cleaned up mysql.server script. Fixed a bug in mysqladmin shutdown when pid le was modied while mysqladmin was still waiting for the previous one to disappear. This could happen during a very quick restart and caused mysqladmin to hang until shutdown_timeout seconds had passed. Dont increment warnings when setting AUTO_INCREMENT columns to NULL in LOAD DATA INFILE. Fixed all boolean type variables/options to work with the old syntax, for example, all of these work: --lower-case-table-names, --lower-case-table-names=1, -O lowercase-table-names=1, --set-variable=lower-case-table-names=1 Fixed shutdown problem (SIGTERM signal handling) on Solaris. (Bug from 4.0.2). SHOW MASTER STATUS now returns an empty set if binary log is not enabled. SHOW SLAVE STATUS now returns an empty set if slave is not initialised. Dont update MyISAM index le on update if not strictly necessary. Fixed bug in SELECT DISTINCT ... FROM many_tables ORDER BY not-used-column. Fixed a bug with BIGINT values and quoted strings. Added QUOTE() function that performs SQL quoting to produce values that can be used as data values in queries. Changed variable DELAY_KEY_WRITE to an enum to allow one set DELAY_KEY_WRITE for all tables without taking down the server. Changed behaviour of IF(condition,column,NULL) so that it returns the value of the column type.

Apndice D: Histrico de Alteraes do MySQL e o co

993

Made safe_mysqld a symlink to mysqld_safe in binary distribution. Fixed security bug when having an empty database name in the user.db table. Fixed some problems with CREATE TABLE ... SELECT function(). mysqld now has the option --temp-pool enabled by default as this gives better performance with some operating systems. Fixed problem with too many allocated alarms on slave when connecting to master many times (normally not a very critical error). Fixed hang in CHANGE MASTER TO if the slave thread died very quickly. Big cleanup in replication code (less logging, better error messages, etc..) If the --code-file option is specied, the server calls setrlimit() to set the maximum allowed core le size to unlimited, so core les can be generated. Fixed bug in query cache after temporary table creation. Added --count=N (-c) option to mysqladmin, to make the program do only N iterations. To be used with --sleep (-i). Useful in scripts. Fixed bug in multi-table UPDATE: when updating a table, do_select() became confused about reading records from a cache. Fixed bug in multi-table UPDATE when several elds were referenced from a single table Fixed bug in truncating nonexisting table. Fixed bug in REVOKE that caused user resources to be randomly set. Fixed bug in GRANT for the new CREATE TEMPORARY TABLE privilege. Fixed bug in multi-table DELETE when tables are re-ordered in the table initialisation method and ref lengths are of dierent sizes. Fixed two bugs in SELECT DISTINCT with large tables. Fixed bug in query cache initialisation with very small query cache size. Allow DEFAULT with INSERT statement. The startup parameters myisam_max_sort_file_size and myisam_max_extra_sort_ file_size are now given in bytes, not megabytes. External system locking of MyISAM/ISAM les is now turned o by default. One can turn this on with --external-locking. (For most users this is never needed). Fixed core dump bug with INSERT ... SET db_name.table_name.colname=. Fixed client hangup bug when using some SQL commands with incorrect syntax. Fixed a timing bug in DROP DATABASE New SET [GLOBAL | SESSION] syntax to change thread-specic and global server variables at runtime. Added variable slave_compressed_protocol. Renamed variable query_cache_startup_type to query_cache_type, myisam_bulk_ insert_tree_size to bulk_insert_buffer_size, record_buffer to read_buffer_ size and record_rnd_buffer to read_rnd_buffer_size. Renamed some SQL variables, but old names will still work until 5.0. Veja Seo 2.5.2 ca [Upgrading-from-3.23], Pgina 123. a Renamed --skip-locking to --skip-external-locking.

994

MySQL Technical Reference for Version 5.0.0-alpha

Removed unused variable query_buffer_size. Fixed a bug that made the pager option in the mysql client non-functional. Added full AUTO_INCREMENT support to MERGE tables. Extended LOG() function to accept an optional arbitrary base parameter. Seo 6.3.3.2 [Mathematical functions], Pgina 523. ca a Veja

Added LOG2() function (useful for nding out how many bits a number would require for storage). Added LN() natural logarithm function for compatibility with other databases. It is synonymous with LOG(X).

D.3.16 Alteraes na distribuio 4.0.2 (01 Jul 2002) co ca

Cleaned up NULL handling for default values in DESCRIBE table_name. Fixed truncate() to round up negative values to the nearest integer. Changed --chroot=path option to execute chroot() immediately after all options have been parsed. Dont allow database names that contain \. lower_case_table_names now also aects database names. Added XOR operator (logical and bitwise XOR) with ^ as a synonym for bitwise XOR. Added function IS_FREE_LOCK("lock_name"). Based on code contributed by Hartmut Holzgraefe hartmut@six.de. Removed mysql_ssl_clear() from C API, as it was not needed. DECIMAL and NUMERIC types can now read exponential numbers. Added SHA1() function to calculate 160 bit hash value as described in RFC 3174 (Secure Hash Algorithm). This function can be considered a cryptographically more secure equivalent of MD5(). Veja Seo 6.3.6.2 [Miscellaneous functions], Pgina 547. ca a Added AES_ENCRYPT() and AES_DECRYPT() functions to perform encryption according to AES standard (Rijndael). Veja Seo 6.3.6.2 [Miscellaneous functions], Pgina 547. ca a Added --single-transaction option to mysqldump, allowing a consistent dump of InnoDB tables. Veja Seo 4.9.7 [mysqldump], Pgina 361. ca a Fixed bug in innodb_log_group_home_dir in SHOW VARIABLES. Fixed a bug in optimiser with merge tables when non-unique values are used in summing up (causing crashes). Fixed a bug in optimiser when a range specied makes index grouping impossible (causing crashes). Fixed a rare bug when FULLTEXT index is present and no tables are used. Added privileges CREATE TEMPORARY TABLES, EXECUTE, LOCK TABLES, REPLICATION CLIENT, REPLICATION SLAVE, SHOW DATABASES and SUPER. To use these, you must have run the mysql_fix_privilege_tables script after upgrading. Fixed query cache align data bug. Fixed mutex bug in replication when reading from master fails.

Apndice D: Histrico de Alteraes do MySQL e o co

995

Added missing mutex in TRUNCATE TABLE; This xes some core dump/hangup problems when using TRUNCATE TABLE. Fixed bug in multiple-table DELETE when optimiser uses only indexes. Fixed that ALTER TABLE table_name RENAME new_table_name is as fast as RENAME TABLE. Fixed bug in GROUP BY with two or more elds, where at least one eld can contain NULL values. Use Turbo Boyer-Moore algorithm to speed up LIKE "%keyword%" searches. Fixed bug in DROP DATABASE with symlink. Fixed crash in REPAIR ... USE_FRM. Fixed bug in EXPLAIN with LIMIT offset != 0. Fixed bug in phrase operator "..." in boolean full-text search. Fixed bug that caused duplicated rows when using truncation operator * in boolean full-text search. Fixed bug in truncation operator of boolean full-text search (incorrect results when there are only +word*s in the query). Fixed bug in boolean full-text search that caused a crash when an identical MATCH expression that did not use an index appeared twice. Query cache is now automatically disabled in mysqldump. Fixed problem on Windows 98 that made sending of results very slow. Boolean full-text search weighting scheme changed to something more reasonable. Fixed bug in boolean full-text search that caused MySQL to ignore queries of ft_min_ word_len characters. Boolean full-text search now supports phrase searches. New congure option --without-query-cache. Memory allocation strategy for root memory changed. Block size now grows with number of allocated blocks. INET_NTOA() now returns NULL if you give it an argument that is too large (greater than the value corresponding to 255.255.255.255). Fix SQL_CALC_FOUND_ROWS to work with UNIONs. It will work only if the rst SELECT has this option and if there is global LIMIT for the entire statement. For the moment, this requires using parentheses for individual SELECT queries within the statement. Fixed bug in SQL_CALC_FOUND_ROWS and LIMIT. Dont give an error for CREATE TABLE ...(... VARCHAR(0)). Fixed SIGINT and SIGQUIT problems in mysql.cc on Linux with some glibc versions. Fixed bug in convert.cc, which is caused by having an incorrect net_store_ length() linked in the CONVERT::store() method. DOUBLE and FLOAT columns now honor the UNSIGNED ag on storage. InnoDB now retains foreign key constraints through ALTER TABLE and CREATE/DROP INDEX. InnoDB now allows foreign key constraints to be added through the ALTER TABLE syntax.

996

MySQL Technical Reference for Version 5.0.0-alpha

InnoDB tables can now be set to automatically grow in size (autoextend). Added --ignore-lines=n option to mysqlimport. This has the same eect as the IGNORE n LINES clause for LOAD DATA. Fixed bug in UNION with last oset being transposed to total result set. REPAIR ... USE_FRM added. Fixed that DEFAULT_SELECT_LIMIT is always imposed on UNION result set. Fixed that some SELECT options can appear only in the rst SELECT. Fixed bug with LIMIT with UNION, where last select is in the braces. Fixed that full-text works ne with UNION operations. Fixed bug with indexless boolean full-text search. Fixed bug that sometimes appeared when full-text search was used with const tables. Fixed incorrect error value when doing a SELECT with an empty HEAP table. Use ORDER BY column DESC now sorts NULL values rst. (In other words, NULL values sort rst in all cases, whether or not DESC is specied.) This is changed back in 4.0.10. Fixed bug in WHERE key_name=constant ORDER BY key_name DESC. Fixed bug in SELECT DISTINCT ... ORDER BY DESC optimization. Fixed bug in ... HAVING GROUP_FUNCTION(xxx) IS [NOT] NULL. Fixed bug in truncation operator for boolean full-text search. Allow value of --user=# option for mysqld to be specied as a numeric user ID. Fixed a bug where SQL_CALC_ROWS returned an incorrect value when used with one table and ORDER BY and with InnoDB tables. Fixed that SELECT 0 LIMIT 0 doesnt hang thread. Fixed some problems with USE/IGNORE INDEX when using many keys with the same start column. Dont use table scan with BerkeleyDB and InnoDB tables when we can use an index that covers the whole row. Optimized InnoDB sort-buer handling to take less memory. Fixed bug in multi-table DELETE and InnoDB tables. Fixed problem with TRUNCATE and InnoDB tables that produced the error Cant execute the given command because you have active locked tables or an active transaction. Added NO_UNSIGNED_SUBTRACTION to the set of ags that may be specied with the --sql-mode option for mysqld. It disables unsigned arithmetic rules when it comes to subtraction. (This will make MySQL 4.0 behave more like 3.23 with UNSIGNED columns). The result returned for all bit functions (|, <<, ...) is now of type unsigned integer. Added detection of nan values in MyISAM to make it possible to repair tables with nan in oat or double columns. Fixed new bug in myisamchk where it didnt correctly update number of parts in the MyISAM index le. Changed to use autoconf 2.52 (from autoconf 2.13).

Apndice D: Histrico de Alteraes do MySQL e o co

997

Fixed optimization problem where the MySQL Server was in preparing state for a long time when selecting from an empty table which had contained a lot of rows. Fixed bug in complicated join with const tables. This x also improves performance a bit when referring to another table from a const table. First pre-version of multi-table UPDATE statement. Fixed bug in multi-table DELETE. Fixed bug in SELECT CONCAT(argument_list) ... GROUP BY 1. INSERT ... SELECT did a full rollback in case of an error. Fixed so that we only roll back the last statement in the current transaction. Fixed bug with empty expression for boolean full-text search. Fixed core dump bug in updating full-text key from/to NULL. ODBC compatibility: Added BIT_LENGTH() function. Fixed core dump bug in GROUP BY BINARY column. Added support for NULL keys in HEAP tables. Use index for ORDER BY in queries of type: SELECT * FROM t WHERE key_part1=1 ORDER BY key_part1 DESC,key_part2 DESC Fixed bug in FLUSH QUERY CACHE. Added CAST() and CONVERT() functions. The CAST and CONVERT functions are nearly identical and mainly useful when you want to create a column with a specic type in a CREATE ... SELECT statement. For more information, read Seo 6.3.5 [Cast ca Functions], Pgina 544. a CREATE ... SELECT on DATE and TIME functions now create columns of the expected type. Changed order in which keys are created in tables. Added new columns Null and Index_type to SHOW INDEX output. Added --no-beep and --prompt options to mysql command-line client. New feature: management of user resources. GRANT ... WITH MAX_QUERIES_PER_HOUR N1 MAX_UPDATES_PER_HOUR N2 MAX_CONNECTIONS_PER_HOUR N3; Veja Seo 4.4.7 [User resources], Pgina 265. ca a Added mysql_secure_installation to the scripts/ directory.

D.3.17 Alteraes na distribuio 4.0.1 (23 Dec 2001) co ca

Added system command to mysql. Fixed bug when HANDLER was used with some unsupported table type. mysqldump now puts ALTER TABLE tbl_name DISABLE KEYS and tbl_name ENABLE KEYS in the sql dump. Added mysql_fix_extensions script. Fixed stack overrun problem with LOAD DATA FROM MASTER on OSF/1.

ALTER TABLE

998

MySQL Technical Reference for Version 5.0.0-alpha

Fixed shutdown problem on HP-UX. Added DES_ENCRYPT() and DES_DECRYPT() functions. Added FLUSH DES_KEY_FILE statement. Added --des-key-file option to mysqld. HEX(string) now returns the characters in string converted to hexadecimal. Fixed problem with GRANT when using lower_case_table_names=1. Changed SELECT ... IN SHARE MODE to SELECT ... LOCK IN SHARE MODE (as in MySQL 3.23). A new query cache to cache results from identical SELECT queries. Fixed core dump bug on 64-bit machines when it got an incorrect communication packet. MATCH ... AGAINST(... IN BOOLEAN MODE) can now work without FULLTEXT index. Fixed slave to replicate from 3.23 master. Miscellaneous replication xes/cleanup. Got shutdown to work on Mac OS X. Added myisam/ft_dump utility for low-level inspection of FULLTEXT indexes. Fixed bug in DELETE ... WHERE ... MATCH .... Added support for MATCH ... AGAINST(... IN BOOLEAN MODE). Note: you must rebuild your tables with ALTER TABLE tablename TYPE=MyISAM to be able to use boolean full-text search. LOCATE() and INSTR() are now case-sensitive if either argument is a binary string. Changed RAND() initialisation so that RAND(N) and RAND(N+1) are more distinct. Fixed core dump bug in UPDATE ... ORDER BY. In 3.23, INSERT INTO ... SELECT always had IGNORE enabled. Now MySQL will stop (and possibly roll back) by default in case of an error unless you specify IGNORE. Ignore DATA DIRECTORY and INDEX DIRECTORY directives on Windows. Added boolean full-text search code. It should be considered early alpha. Extended MODIFY and CHANGE in ALTER TABLE to accept the FIRST and AFTER keywords. Indexes are now used with ORDER BY on a whole InnoDB table.

D.3.18 Alteraes na distribuio 4.0.0 (Oct 2001: Alpha) co ca

Added --xml option to mysql for producing XML output. Added full-text variables ft_min_word_len, ft_max_word_len, and ft_max_word_ len_for_sort. Added documentation for libmysqld, the embedded MySQL server library. Also added example programs (a mysql client and mysqltest test program) which use libmysqld. Removed all Gemini hooks from MySQL server. Removed my_thread_init() and my_thread_end() from mysql_com.h, and added mysql_thread_init() and mysql_thread_end() to mysql.h.

Apndice D: Histrico de Alteraes do MySQL e o co

999

Support for communication packets > 16M. In 4.0.1 we will extend MyISAM to be able to handle these. Secure connections (with SSL). Unsigned BIGINT constants now work. MIN() and MAX() now handle signed and unsigned BIGINT numbers correctly. New character set latin1_de which provides correct German sorting. STRCMP() now uses the current character set when doing comparisons, which means that the default comparison behaviour now is case-insensitive. TRUNCATE TABLE and DELETE FROM tbl_name are now separate functions. One bonus is that DELETE FROM tbl_name now returns the number of deleted rows, rather than zero. DROP DATABASE now executes a DROP TABLE on all tables in the database, which xes a problem with InnoDB tables. Added support for UNION. Added support for multi-table DELETE operations. A new HANDLER interface to MyISAM tables. Added support for INSERT on MERGE tables. Patch from Benjamin Pugmann. Changed WEEK(date,0) to match the calendar in the USA. COUNT(DISTINCT) is about 30% faster. Speed up all internal list handling. Speed up IS NULL, ISNULL() and some other internal primitives. Full-text index creation now is much faster. Tree-like cache to speed up bulk inserts and myisam_bulk_insert_tree_size variable. Searching on packed (CHAR/VARCHAR) keys is now much faster. Optimized queries of type: SELECT DISTINCT * from tbl_name ORDER by key_part1 LIMIT row_count. SHOW CREATE TABLE now shows all table attributes. ORDER BY ... DESC can now use keys. LOAD DATA FROM MASTER automatically sets up a slave. Renamed safe_mysqld to mysqld_safe to make this name more in line with other MySQL scripts/commands. Added support for symbolic links to MyISAM tables. Symlink handling is now enabled by default for Windows. Added SQL_CALC_FOUND_ROWS and FOUND_ROWS(). This makes it possible to know how many rows a query would have returned without a LIMIT clause. Changed output format of SHOW OPEN TABLES. Allow SELECT expression LIMIT .... Added ORDER BY syntax to UPDATE and DELETE. SHOW INDEXES is now a synonym for SHOW INDEX. Added ALTER TABLE tbl_name DISABLE KEYS and ALTER TABLE tbl_name ENABLE KEYS commands.

1000

MySQL Technical Reference for Version 5.0.0-alpha

Allow use of IN as a synonym for FROM in SHOW commands. Implemented repair by sort for FULLTEXT indexes. REPAIR TABLE, ALTER TABLE, and OPTIMIZE TABLE for tables with FULLTEXT indexes are now up to 100 times faster. Allow SQL-99 syntax Xhexadecimal-number. Cleaned up global lock handling for FLUSH TABLES WITH READ LOCK. Fixed problem with DATETIME = constant in WHERE optimization. Added --master-data and --no-autocommit options to mysqldump. (Thanks to Brian Aker for this.) Added script mysql_explain_log.sh to distribution. (Thanks to mobile.de).

D.4 Alteraes na distribuio 3.23.x (Recent; still co ca supported)

Please note that since release 4.0 is now production level, only critical xes are done in the 3.23 release series. You are recommended to upgrade when possible, to take advantage of all speed and feature improvements in 4.0. Veja Seo 2.5.2 [Upgrading-from-3.23], Pgina 123. ca a The 3.23 release has several major features that are not present in previous versions. We have added three new table types: MyISAM InnoDB A new ISAM library which is tuned for SQL and supports large les. A transaction-safe storage engine that supports row level locking, and many Oracle-like features.

BerkeleyDB or BDB Uses the Berkeley DB library from Sleepycat Software to implement transaction-safe tables. Note that only MyISAM is available in the standard binary distribution. The 3.23 release also includes support for database replication between a master and many slaves, full-text indexing, and much more. All new features are being developed in the 4.x version. Only bug xes and minor enhancements to existing features will be added to 3.23. The replication code and BerkeleyDB code is still not as tested and as the rest of the code, so we will probably need to do a couple of future releases of 3.23 with small xes for this part of the code. As long as you dont use these features, you should be quite safe with MySQL 3.23! Note that the above doesnt mean that replication or Berkeley DB dont work. We have done a lot of testing of all code, including replication and BDB without nding any problems. It only means that not as many users use this code as the rest of the code and because of this we are not yet 100% condent in this code.

D.4.1 Alteraes na distribuio 3.23.59 (not released yet) co ca

If a query was ignored on the slave (because of replicate-ignore-table and other similar rules), the slave still checked if the query got the same error code (0, no error)

Apndice D: Histrico de Alteraes do MySQL e o co

1001

as on the master. So if the master had an error on the query (for example, Duplicate entry in a multiple-row insert), then the slave stopped and warned that the error codes didnt match. This is a backport of the x for MySQL 4.0. (Bug #797) mysqlbinlog now asks for a password at console when the -p/--password option is used with no argument. This is how the other clients (mysqladmin, mysqldump..) already behave. Note that one now has to use mysqlbinlog -p<my_password>; mysqlbinlog -p <my_password> will not work anymore (in other words, put no space after -p). (Bug #1595) On some 64-bit machines (some HP-UX and Solaris machines), a slave installed with the 64-bit MySQL binary could not connect to its master (it connected to itself instead). (Bug #1256, #1381) Fixed a Windows-specic bug present since MySQL version 3.23.57 and 3.23.58, which caused Windows slaves to crash when they started replication if a master.info le existed. (Bug #1720)

D.4.2 Alteraes na distribuio 3.23.58 (11 Sep 2003) co ca

Fixed buer overow in password handling which could potentially be exploited by MySQL users with ALTER privilege on the mysql.user table to execute random code or to gain shell access with the UID of the mysqld process (thanks to Jedi/Sector One for spotting and reporting this bug). mysqldump now correctly quotes all identiers when communicating with the server. This assures that during the dump process, mysqldump will never send queries to the server that result in a syntax error. This problem is not related to the mysqldump programs output, which was not changed. (Bug #1148) Fixed table/column grant handling - proper sort order (from most specic to less specic, veja Seo 4.3.10 [Request access], Pgina 242) was not honored. (Bug #928) ca a Fixed overow bug in MyISAM and ISAM when a row is updated in a table with a large number of columns and at least one BLOB/TEXT column. Fixed MySQL so that eld length (in C API) for the second column in SHOW CREATE TABLE is always larger than the data length. The only known application that was aected by the old behaviour was Borland dbExpress, which truncated the output from the command. (Bug #1064) Fixed ISAM bug in MAX() optimization. Fixed Unknown error when doing ORDER BY on reference table which was used with NULL value on NOT NULL column. (Bug #479)

D.4.3 Alteraes na distribuio 3.23.57 (06 Jun 2003) co ca

Fixed problem in alarm handling that could cause problems when getting a packet that is too large. Fixed problem when installing MySQL as a service on Windows when one gave 2 arguments (option le group name and service name) to mysqld. Fixed kill pid-of-mysqld to work on Mac OS X.

1002

MySQL Technical Reference for Version 5.0.0-alpha

SHOW TABLE STATUS displayed incorrect Row_format value for tables that have been compressed with myisampack. (Bug #427) SHOW VARIABLES LIKE innodb_data_file_path displayed only the name of the rst datale. (Bug #468) Fixed security problem where mysqld didnt allow one to UPDATE rows in a table even if one had a global UPDATE privilege and a database SELECT privilege. Fixed a security problem with SELECT and wildcarded select list, when user only had partial column SELECT privileges on the table. Fixed unlikely problem in optimising WHERE clause with a constant expression such as in WHERE 1 AND (a=1 AND b=1). Fixed problem on IA-64 with timestamps that caused mysqlbinlog to fail. The default option for innodb_flush_log_at_trx_commit was changed from 0 to 1 to make InnoDB tables ACID by default. Veja Seo 7.5.3 [InnoDB start], Pgina 644. ca a Fixed problem with too many allocated alarms on slave when connecting to master many times (normally not a very critical error). Fixed a bug in replication of temporary tables. (Bug #183) Fixed 64 bit bug that aected at least AMD hammer systems. Fixed a bug when doing LOAD DATA INFILE IGNORE: When reading the binary log, mysqlbinlog and the replication code read REPLACE instead of IGNORE. This could make the slaves table become dierent from the masters table. (Bug #218) Fixed overow bug in MyISAM when a row is inserted into a table with a large number of columns and at least one BLOB/TEXT column. Bug was caused by incorrect calculation of the needed buer to pack data. The binary log was not locked during TRUNCATE table_name or DELETE FROM table_ name statements, which could cause an INSERT to table_name to be written to the log before the TRUNCATE or DELETE statements. Fixed rare bug in UPDATE of InnoDB tables where one row could be updated multiple times. Produce an error for empty table and column names. Changed PROCEDURE ANALYSE() to report DATE instead of NEWDATE. Changed PROCEDURE ANALYSE(#) to restrict the number of values in an ENUM column to # also for string values. mysqldump no longer silently deletes the binary logs when invoked with the --masterdata or --first-slave option; while this behaviour was convenient for some users, others may suer from it. Now one has to explicitly ask for binary logs to be deleted by using the new --delete-master-logs option. Fixed a bug in mysqldump when it was invoked with the --master-data option: The CHANGE MASTER TO statements that were appended to the SQL dump had incorrect coordinates. (Bug #159)

D.4.4 Alteraes na distribuio 3.23.56 (13 Mar 2003) co ca

Fixed mysqld crash on extremely small values of sort_buffer variable.

Apndice D: Histrico de Alteraes do MySQL e o co

1003

Fixed a bug in privilege system for GRANT UPDATE on column level. Fixed a rare bug when using a date in HAVING with GROUP BY. Fixed checking of random part of WHERE clause. (Bug #142) Fixed MySQL (and myisamchk) crash on articially corrupted .MYI les. Security enhancement: mysqld no longer reads options from world-writeable cong les. Security enhancement: mysqld and safe_mysqld now only use the rst --user option specied on the command line. (Normally this comes from /etc/my.cnf) Security enhancement: Dont allow BACKUP TABLE to overwrite existing les. Fixed unlikely deadlock bug when one thread did a LOCK TABLE and another thread did a DROP TABLE. In this case one could do a KILL on one of the threads to resolve the deadlock. LOAD DATA INFILE was not replicated by slave if replicate_*_table was set on the slave. Fixed a bug in handling CHAR(0) columns that could cause incorrect results from the query. Fixed a bug in SHOW VARIABLES on 64-bit platforms. The bug was caused by incorrect declaration of variable server_id. The Comment column in SHOW TABLE STATUS now reports that it can contain NULL values (which is the case for a crashed .frm le). Fixed the rpl_rotate_logs test to not fail on certain platforms (e.g. Mac OS X) due to a too long le name (changed slave-master-info.opt to .slave-mi). Fixed a problem with BLOB NOT NULL columns used with IS NULL. Fixed bug in MAX() optimization in MERGE tables. Better RAND() initialisation for new connections. Fixed bug with connect timeout. This bug was manifested on OSs with poll() system call, which resulted in timeout the value specied as it was executed in both select() and poll(). Fixed bug in SELECT * FROM table WHERE datetime1 IS NULL OR datetime2 IS NULL. Fixed bug in using aggregate functions as argument for INTERVAL, CASE, FIELD, CONCAT_WS, ELT and MAKE_SET functions. When running with --lower-case-table-names (default on Windows) and you had tables or databases with mixed case on disk, then executing SHOW TABLE STATUS followed with DROP DATABASE or DROP TABLE could fail with Errcode 13. Fixed bug in logging to binary log (which aects replication) a query that inserts a NULL in an auto_increment eld and also uses LAST_INSERT_ID(). Fixed bug in mysqladmin --relative. On some 64 bit systems, show status reported a strange number for Open_files and Open_streams.

1004

MySQL Technical Reference for Version 5.0.0-alpha

D.4.5 Alteraes na distribuio 3.23.55 (23 Jan 2003) co ca

Fixed double freed pointer bug in mysql_change_user() handling, that enabled a specially hacked version of MySQL client to crash mysqld. Note, that one needs to login to the server by using a valid user account to be able to exploit this bug. Fixed bug with the --slow-log when logging an administrator command (like FLUSH TABLES). Fixed bug in GROUP BY when used on BLOB column with NULL values. Fixed a bug in handling NULL values in CASE ... WHEN .... Bugx for --chroot (veja Seo D.4.6 [News-3.23.54], Pgina 1004) is reverted. ca a Unfortunately, there is no way to make it to work, without introducing backwardincompatible changes in my.cnf. Those who need --chroot functionality, should upgrade to MySQL 4.0. (The x in the 4.0 branch did not break backward-compatibility). Make --lower-case-table-names default on Mac OS X as the default le system (HFS+) is case insensitive. Fixed a bug in scripts/mysqld_safe.sh in NOHUP_NICENESS testing. Transactions in AUTOCOMMIT=0 mode didnt rotate binary log. Fixed a bug in scripts/make_binary_distribution that resulted in a remaining @HOSTNAME@ variable instead of replacing it with the correct path to the hostname binary. Fixed a very unlikely bug that could cause SHOW PROCESSLIST to core dump in pthread mutex unlock() if a new thread was connecting. Forbid SLAVE STOP if the thread executing the query has locked tables. This removes a possible deadlock situation.

D.4.6 Alteraes na distribuio 3.23.54 (05 Dec 2002) co ca

Fixed a bug, that allowed to crash mysqld with a specially crafted packet. Fixed a rare crash (double freed pointer) when altering a temporary table. Fixed buer overrun in libmysqlclient library that allowed malicious MySQL server to crash the client application. Fixed security-related bug in mysql_change_user() handling. All users are strongly recommended to upgrade to the version 3.23.54. Fixed bug that prevented --chroot command-line option of mysqld from working. Fixed bug that made OPTIMIZE TABLE to corrupt the table under some rare circumstances. Fixed mysqlcheck so it can deal with table names containing dashes. Fixed shutdown problem on Mac OS X. Fixed bug with comparing an indexed NULL eld with <=> NULL. Fixed bug that caused IGNORE INDEX and USE INDEX sometimes to be ignored. Fixed rare core dump problem in complicated GROUP BY queries that didnt return any result.

Apndice D: Histrico de Alteraes do MySQL e o co

1005

Fixed a bug where MATCH ... AGAINST () >=0 was treated as if it was >. Fixed core dump in SHOW PROCESSLIST when running with an active slave (unlikely timing bug). Make it possible to use multiple MySQL servers on Windows (code backported from 4.0.2). One can create TEMPORARY MERGE tables now. Fixed that --core-file works on Linux (at least on kernel 2.4.18). Fixed a problem with BDB and ALTER TABLE. Fixed reference to freed memory when doing complicated GROUP BY ... ORDER BY queries. Symptom was that mysqld died in function send_fields. Allocate heap rows in smaller blocks to get better memory usage. Fixed memory allocation bug when storing BLOB values in internal temporary tables used for some (unlikely) GROUP BY queries. Fixed a bug in key optimising handling where the expression WHERE column_name = key_column_name was calculated as true for NULL values. Fixed core dump bug when doing LEFT JOIN ... WHERE key_column=NULL. Fixed MyISAM crash when using dynamic-row tables with huge numbers of packed elds. Updated source tree to be built using automake 1.5 and libtool 1.4.

D.4.7 Alteraes na distribuio 3.23.53 (09 Oct 2002) co ca

Fixed crash when SHOW INNODB STATUS was used and skip-innodb was dened. Fixed possible memory corruption bug in binary log le handling when slave rotated the logs (only aected 3.23, not 4.0). Fixed problem in LOCK TABLES on Windows when one connects to a database that contains upper case letters. Fixed that --skip-show-databases doesnt reset the --port option. Small x in safe_mysqld for some shells. Fixed that FLUSH STATUS doesnt reset delayed_insert_threads. Fixed core dump bug when using the BINARY cast on a NULL value. Fixed race condition when someone did a GRANT at the same time a new user logged in or did a USE database. Fixed bug in ALTER TABLE and RENAME TABLE when running with -O lower_case_ table_names=1 (typically on Windows) when giving the table name in uppercase. Fixed that -O lower_case_table_names=1 also converts database names to lower case. Fixed unlikely core dump with SELECT ... ORDER BY ... LIMIT. Changed AND/OR to report that they can return NULL. This xes a bug in GROUP BY on AND/OR expressions that return NULL. Fixed a bug that OPTIMIZE of locked and modied MyISAM table, reported table corruption. Fixed a BDB-related ALTER TABLE bug with dropping a column and shutting down immediately thereafter.

1006

MySQL Technical Reference for Version 5.0.0-alpha

Fixed problem with configure ... --localstatedir=.... Fixed problem with UNSIGNED BIGINT on AIX (again). Fixed bug in pthread mutex trylock() on HPUX 11.0. Multi-threaded stress tests for InnoDB.

D.4.8 Alteraes na distribuio 3.23.52 (14 Aug 2002) co ca

Wrap BEGIN/COMMIT around transaction in the binary log. This makes replication honour transactions. Fixed security bug when having an empty database name in the user.db table. Changed initialisation of RND() to make it less predicatable. Fixed problem with GROUP BY on result with expression that created a BLOB eld. Fixed problem with GROUP BY on columns that have NULL values. To solve this we now create an MyISAM temporary table when doing a GROUP BY on a possible NULL item. From MySQL 4.0.5 we can use in memory HEAP tables for this case. Fixed problem with privilege tables when downgrading from 4.0.2 to 3.23. Fixed thread bug in SLAVE START, SLAVE STOP and automatic repair of MyISAM tables that could cause table cache to be corrupted. Fixed possible thread related key-cache-corruption problem with OPTIMIZE TABLE and REPAIR TABLE. Added name of administrator command logs. Fixed bug with creating an auto-increment value on second part of a UNIQUE() key where rst part could contain NULL values. Dont write slave-timeout reconnects to the error log. Fixed bug with slave net read timeouting Fixed a core-dump bug with MERGE tables and MAX() function. Fixed bug in ALTER TABLE with BDB tables. Fixed bug when logging LOAD DATA INFILE to binary log with no active database. Fixed a bug in range optimiser (causing crashes). Fixed possible problem in replication when doing DROP DATABASE on a database with InnoDB tables. Fixed that mysql_info() returns 0 for Duplicates when using INSERT DELAYED IGNORE. Added -DHAVE_BROKEN_REALPATH to the Mac OS X (darwin) compile options in configure.in to x a failure under high load.

D.4.9 Alteraes na distribuio 3.23.51 (31 May 2002) co ca

Fix bug with closing tags missing slash for mysqldump XML output. Remove end space from ENUM values. (This xed a problem with SHOW CREATE TABLE.) Fixed bug in CONCAT_WS() that cut the result.

Apndice D: Histrico de Alteraes do MySQL e o co

1007

Changed name of server variables Com_show_master_stat to Com_show_master_ status and Com_show_slave_stat to Com_show_slave_status. Changed handling of gethostbyname() to make the client library thread-safe even if gethostbyname_r doesnt exist. Fixed core-dump problem when giving a wrong password string to GRANT. Fixed bug in DROP DATABASE with symlinked directory. Fixed optimization problem with DATETIME and value outside DATETIME range. Removed Sleepycats BDB doc les from the source tree, as theyre not needed (MySQL covers BDB in its own documentation). Fixed MIT-pthreads to compile with glibc 2.2 (needed for make dist). Fixed the FLOAT(X+1,X) is not converted to FLOAT(X+2,X). (This also aected DECIMAL, DOUBLE and REAL types) Fixed the result from IF() is case in-sensitive if the second and third arguments are case sensitive. Fixed core dump problem on OSF/1 in gethostbyname_r. Fixed that underowed decimal elds are not zero lled. If we get an overow when inserting +11111 for DECIMAL(5,0) UNSIGNED columns, we will just drop the sign. Fixed optimization bug with ISNULL(expression_which_cannot_be_null) and ISNULL(constant_expression). Fixed host lookup bug in the glibc library that we used with the 3.23.50 Linux-x86 binaries.

D.4.10 Alteraes na distribuio 3.23.50 (21 Apr 2002) co ca

Fixed buer overow problem if someone specied a too long datadir parameter to mysqld Add missing <row> tags for mysqldump XML output. Fixed problem with crash-me and gcc 3.0.4. Fixed that @@unknown_variable doesnt hang server. Added @@VERSION as a synonym for VERSION(). SHOW VARIABLES LIKE xxx is now case-insensitive. Fixed timeout for GET_LOCK() on HP-UX with DCE threads. Fixed memory allocation bug in the glibc library used to build Linux binaries, which caused mysqld to die in free(). Fixed SIGINT and SIGQUIT problems in mysql. Fixed bug in character table converts when used with big ( > 64K) strings. InnoDB now retains foreign key constraints through ALTER TABLE and CREATE/DROP INDEX. InnoDB now allows foreign key constraints to be added through the ALTER TABLE syntax. InnoDB tables can now be set to automatically grow in size (autoextend).

1008

MySQL Technical Reference for Version 5.0.0-alpha

Our Linux RPMS and binaries are now compiled with gcc 3.0.4, which should make them a bit faster. Fixed some buer overow problems when reading startup parameters. Because of problems on shutdown we have now disabled named pipes on Windows by default. One can enable named pipes by starting mysqld with --enable-named-pipe. Fixed bug when using WHERE key_column = J or key_column=j. Fixed core-dump bug when using --log-bin with LOAD DATA INFILE without an active database. Fixed bug in RENAME TABLE when used with lower_case_table_names=1 (default on Windows). Fixed unlikely core-dump bug when using DROP TABLE on a table that was in use by a thread that also used queries on only temporary tables. Fixed problem with SHOW CREATE TABLE and PRIMARY KEY when using 32 indexes. Fixed that one can use SET PASSWORD for the anonymous user. Fixed core dump bug when reading client groups from option les using mysql_options(). Memory leak (16 bytes per every corrupted table) closed. Fixed binary builds to use --enable-local-infile. Update source to work with new version of bison. Updated shell scripts to now agree with new POSIX standard. Fixed bug where DATE_FORMAT() returned empty string when used with GROUP BY.

D.4.11 Alteraes na distribuio 3.23.49 co ca

Dont give warning for a statement that is only a comment; this is needed for mysqldump --disable-keys to work. Fixed unlikely caching bug when doing a join without keys. In this case the last used eld for a table always returned NULL. Added options to make LOAD DATA LOCAL INFILE more secure. MySQL binary release 3.23.48 for Linux contained a new glibc library, which has serious problems under high load and Red Hat 7.2. The 3.23.49 binary release doesnt have this problem. Fixed shutdown problem on NT.

D.4.12 Alteraes na distribuio 3.23.48 (07 Feb 2002) co ca

Added --xml option to mysqldump for producing XML output. Changed to use autoconf 2.52 (from autoconf 2.13) Fixed bug in complicated join with const tables. Added internal safety checks for InnoDB. Some InnoDB variables were always shown in SHOW VARIABLES as OFF on high-byte-rst systems (like SPARC).

Apndice D: Histrico de Alteraes do MySQL e o co

1009

Fixed problem with one thread using an InnoDB table and another thread doing an ALTER TABLE on the same table. Before that, mysqld could crash with an assertion failure in row0row.c, line 474. Tuned the InnoDB SQL optimiser to favor index searches more often over table scans. Fixed a performance problem with InnoDB tables when several large SELECT queries are run concurrently on a multiprocessor Linux computer. Large CPU-bound SELECT queries will now also generally run faster on all platforms. If MySQL binlogging is used, InnoDB now prints after crash recovery the latest MySQL binlog name and the oset InnoDB was able to recover to. This is useful, for example, when resynchronising a master and a slave database in replication. Added better error messages to help in installation problems of InnoDB tables. It is now possible to recover MySQL temporary tables that have become orphaned inside the InnoDB tablespace. InnoDB now prevents a FOREIGN KEY declaration where the signedness is not the same in the referencing and referenced integer columns. Calling SHOW CREATE TABLE or SHOW TABLE STATUS could cause memory corruption and make mysqld crash. Especially at risk was mysqldump, because it frequently calls SHOW CREATE TABLE. If inserts to several tables containing an AUTO_INCREMENT column were wrapped inside one LOCK TABLES, InnoDB asserted in lock0lock.c. In 3.23.47 we allowed several NULL values in a UNIQUE secondary index for an InnoDB table. But CHECK TABLE was not relaxed: it reports the table as corrupt. CHECK TABLE no longer complains in this situation. SHOW GRANTS now shows REFERENCES instead of REFERENCE.

D.4.13 Alteraes na distribuio 3.23.47 (27 Dec 2001) co ca

Fixed bug when using the following construct: SELECT ... WHERE key=@var_name OR key=@var_name2 Restrict InnoDB keys to 500 bytes. InnoDB now supports NULL in keys. Fixed shutdown problem on HP-UX. (Introduced in 3.23.46) Fixed core dump bug in replication when using SELECT RELEASE_LOCK(). Added new command: DO expression,[expression] Added slave-skip-errors option. Added statistics variables for all MySQL commands. longer.) Fixed default values for InnoDB tables. Fixed that GROUP BY expr DESC works. Fixed bug when using t1 LEFT JOIN t2 ON t2.key=constant. mysql_config now also works with binary (relocated) distributions. (SHOW STATUS is now much

1010

MySQL Technical Reference for Version 5.0.0-alpha

D.4.14 Alteraes na distribuio 3.23.46 (29 Nov 2001) co ca

Fixed problem with aliased temporary table replication. InnoDB and BDB tables will now use index when doing an ORDER BY on the whole table. Fixed bug where one got an empty set instead of a DEADLOCK error when using BDB tables. One can now kill ANALYZE, REPAIR, and OPTIMIZE TABLE when the thread is waiting to get a lock on the table. Fixed race condition in ANALYZE TABLE. Fixed bug when joining with caching (unlikely to happen). Fixed race condition when using the binary log and INSERT DELAYED which could cause the binary log to have rows that were not yet written to MyISAM tables. Changed caching of binary log to make replication slightly faster. Fixed bug in replication on Mac OS X.

D.4.15 Alteraes na distribuio 3.23.45 (22 Nov 2001) co ca

(UPDATE|DELETE) ...WHERE MATCH bugx. shutdown should now work on Darwin (Mac OS X). Fixed core dump when repairing corrupted packed MyISAM les. --core-file now works on Solaris. Fix a bug which could cause InnoDB to complain if it cannot nd free blocks from the buer cache during recovery. Fixed bug in InnoDB insert buer B-tree handling that could cause crashes. Fixed bug in InnoDB lock timeout handling. Fixed core dump bug in ALTER TABLE on a TEMPORARY InnoDB table. Fixed bug in OPTIMIZE TABLE that reset index cardinality if it was up to date. Fixed problem with t1 LEFT_JOIN t2 ... WHERE t2.date_column IS NULL when date column was declared as NOT NULL. Fixed bug with BDB tables and keys on BLOB columns. Fixed bug in MERGE tables on OS with 32-bit le pointers. Fixed bug in TIME_TO_SEC() when using negative values.

D.4.16 Alteraes na distribuio 3.23.44 (31 Oct 2001) co ca

Fixed Rows_examined count in slow query log. Fixed bug when using a reference to an AVG() column in HAVING. Fixed that date functions that require correct dates, like DAYOFYEAR(column), will return NULL for 0000-00-00 dates. Fixed bug in const-propagation when comparing columns of dierent types. (SELECT * FROM date_col="2001-01-01" and date_col=time_col)

Apndice D: Histrico de Alteraes do MySQL e o co

1011

Fixed bug that caused error message Cant write, because of unique constraint with some GROUP BY queries. Fixed problem with sjis character strings used within quoted table names. Fixed core dump when using CREATE ... FULLTEXT keys with other storage engines than MyISAM. Dont use signal() on Windows because this appears to not be 100% reliable. Fixed bug when doing WHERE col_name=NULL on an indexed column that had NULL values. Fixed bug when doing LEFT JOIN ... ON (col_name = constant) WHERE col_name = constant. When using replications, aborted queries that contained % could cause a core dump. TCP_NODELAY was not used on some systems. (Speed problem.) Applied portability xes for OS/2. (Patch by Yuri Dario.) The following changes are for InnoDB tables: Add missing InnoDB variables to SHOW VARIABLES. Foreign keys checking is now done for InnoDB tables. DROP DATABASE now works also for InnoDB tables. InnoDB now supports datales and raw disk partitions bigger than 4 GB on those operating systems that have big les. InnoDB calculates better table cardinality estimates for the MySQL optimiser. Accent characters in the default character set latin1 are ordered according to the MySQL ordering. Note: if you are using latin1 and have inserted characters whose code is greater than 127 into an indexed CHAR column, you should run CHECK TABLE on your table when you upgrade to 3.23.44, and drop and reimport the table if CHECK TABLE reports an error! A new my.cnf parameter, innodb_thread_concurrency, helps in performance tuning in heavily concurrent environments. A new my.cnf parameter, innodb_fast_shutdown, speeds up server shutdown. A new my.cnf parameter, innodb_force_recovery, helps to save your data in case the disk image of the database becomes corrupt. innodb_monitor has been improved and a new innodb_table_monitor added. Increased maximum key length from 500 to 7000 bytes. Fixed a bug in replication of AUTO_INCREMENT columns with multiple-line inserts. Fixed a bug when the case of letters changes in an update of an indexed secondary column. Fixed a hang when there are > 24 datales. Fixed a crash when MAX(col) is selected from an empty table, and col is not the rst column in a multi-column index. Fixed a bug in purge which could cause crashes.

1012

MySQL Technical Reference for Version 5.0.0-alpha

D.4.17 Alteraes na distribuio 3.23.43 (04 Oct 2001) co ca

Fixed a bug in INSERT DELAYED and FLUSH TABLES introduced in 3.23.42. Fixed unlikely bug, which returned non-matching rows, in SELECT with many tables and multi-column indexes and range type. Fixed an unlikely core dump bug when doing EXPLAIN SELECT when using many tables and ORDER BY. Fixed bug in LOAD DATA FROM MASTER when using table with CHECKSUM=1. Added unique error message when one gets a DEADLOCK during a transaction with BDB tables. Fixed problem with BDB tables and UNIQUE columns dened as NULL. Fixed problem with myisampack when using pre-space lled CHAR columns. Applied patch from Yuri Dario for OS/2. Fixed bug in --safe-user-create.

D.4.18 Alteraes na distribuio 3.23.42 (08 Sep 2001) co ca

Fixed problem when using LOCK TABLES and BDB tables. Fixed problem with REPAIR TABLE on MyISAM tables with row lengths in the range from 65517 to 65520 bytes. Fixed rare hang when doing mysqladmin shutdown when there was a lot of activity in other threads. Fixed problem with INSERT DELAYED where delay thread could be hanging on upgrading locks with no apparent reason. Fixed problem with myisampack and BLOB. Fixed problem when one edited .MRG tables by hand. (Patch from Benjamin Pugmann). Enforce that all tables in a MERGE table come from the same database. Fixed bug with LOAD DATA INFILE and transactional tables. Fix bug when using INSERT DELAYED with wrong column denition. Fixed core dump during REPAIR of some particularly broken tables. Fixed bug in InnoDB and AUTO_INCREMENT columns. Fixed bug in InnoDB and RENAME TABLE columns. Fixed critical bug in InnoDB and BLOB columns. If you have used BLOB columns larger than 8000 bytes in an InnoDB table, it is necessary to dump the table with mysqldump, drop it and restore it from the dump. Applied large patch for OS/2 from Yuri Dario. Fixed problem with InnoDB when one could get the error Cant execute the given command... even when no transaction was active. Applied some minor xes that concern Gemini. Use real arithmetic operations even in integer context if not all arguments are integers. (Fixes uncommon bug in some integer contexts).

Apndice D: Histrico de Alteraes do MySQL e o co

1013

Dont force everything to lowercase on Windows. (To x problem with Windows and ALTER TABLE). Now --lower_case_names also works on Unix. Fixed that automatic rollback is done when thread end doesnt lock other threads.

D.4.19 Alteraes na distribuio 3.23.41 (11 Aug 2001) co ca

Added --sql-mode=value[,value[,value]] option to mysqld. Veja Seo 4.1.1 ca [Command-line options], Pgina 207. a Fixed possible problem with shutdown on Solaris where the .pid le wasnt deleted. InnoDB now supports < 4 GB rows. The former limit was 8000 bytes. The doublewrite le ush method is used in InnoDB. It reduces the need for Unix fsync() calls to a fraction and improves performance on most Unix avors. You can now use the InnoDB Monitor to print a lot of InnoDB state information, including locks, to the standard output. This is useful in performance tuning. Several bugs which could cause hangs in InnoDB have been xed. Split record_buffer to record_buffer and record_rnd_buffer. To make things compatible to previous MySQL versions, if record_rnd_buffer is not set, then it takes the value of record_buffer. Fixed optimising bug in ORDER BY where some ORDER BY parts where wrongly removed. Fixed overow bug with ALTER TABLE and MERGE tables. Added prototypes for my_thread_init() and my_thread_end() to mysql_com.h Added --safe-user-create option to mysqld. Fixed bug in SELECT DISTINCT ... HAVING that caused error message Cant find record in #...

D.4.20 Alteraes na distribuio 3.23.40 co ca

Fixed problem with --low-priority-updates and INSERT statements. Fixed bug in slave thread when under some rare circumstances it could get 22 bytes ahead on the oset in the master. Added slave_net_timeout for replication. Fixed problem with UPDATE and BDB tables. Fixed hard bug in BDB tables when using key parts. Fixed problem when using GRANT FILE ON database.* ...; previously we added the DROP privilege for the database. Fixed DELETE FROM tbl_name ... LIMIT 0 and UPDATE FROM tbl_name ... LIMIT 0, which acted as though the LIMIT clause was not present (they deleted or updated all selected rows). CHECK TABLE now checks if an AUTO_INCREMENT column contains the value 0. Sending a SIGHUP to mysqld will now only ush the logs, not reset the replication. Fixed parser to allow oats of type 1.0e1 (no sign after e). Option --force to myisamchk now also updates states.

1014

MySQL Technical Reference for Version 5.0.0-alpha

Added option --warnings to mysqld. Now mysqld prints the error Aborted connection only if this option is used. Fixed problem with SHOW CREATE TABLE when you didnt have a PRIMARY KEY. Properly xed the rename of innodb_unix_file_flush_method variable to innodb_ flush_method. Fixed bug when converting BIGINT UNSIGNED to DOUBLE. This caused a problem when doing comparisons with BIGINT values outside of the signed range. Fixed bug in BDB tables when querying empty tables. Fixed a bug when using COUNT(DISTINCT) with LEFT JOIN and there werent any matching rows. Removed all documentation referring to the GEMINI table type. GEMINI is not released under an Open Source license.

D.4.21 Alteraes na distribuio 3.23.39 (12 Jun 2001) co ca

The AUTO_INCREMENT sequence wasnt reset when dropping and adding an AUTO_INCREMENT column. CREATE ... SELECT now creates non-unique indexes delayed. Fixed problem where LOCK TABLES tbl_name READ followed by FLUSH TABLES put an exclusive lock on the table. REAL @variable values were represented with only 2 digits when converted to strings. Fixed problem that client hung when LOAD TABLE FROM MASTER failed. myisamchk --fast --force will no longer repair tables that only had the open count wrong. Added functions to handle symbolic links to make life easier in 4.0. We are now using the -lcma thread library on HP-UX 10.20 so that MySQL will be more stable on HP-UX. Fixed problem with IF() and number of decimals in the result. Fixed date-part extraction functions to work with dates where day and/or month is 0. Extended argument length in option les from 256 to 512 chars. Fixed problem with shutdown when INSERT DELAYED was waiting for a LOCK TABLE. Fixed core dump bug in InnoDB when tablespace was full. Fixed problem with MERGE tables and big tables (> 4G) when using ORDER BY.

D.4.22 Alteraes na distribuio 3.23.38 (09 May 2001) co ca

Fixed a bug when SELECT from MERGE table sometimes results in incorrectly ordered rows. Fixed a bug in REPLACE() when using the ujis character set. Applied Sleepycat BDB patches 3.2.9.1 and 3.2.9.2. Added --skip-stack-trace option to mysqld. CREATE TEMPORARY now works with InnoDB tables.

Apndice D: Histrico de Alteraes do MySQL e o co

1015

InnoDB now promotes sub keys to whole keys. Added option CONCURRENT to LOAD DATA. Better error message when slave max_allowed_packet is too low to read a very long log event from the master. Fixed bug when too many rows where removed when using SELECT DISTINCT ... HAVING. SHOW CREATE TABLE now returns TEMPORARY for temporary tables. Added Rows_examined to slow query log. Fixed problems with function returning empty string when used together with a group function and a WHERE that didnt match any rows. New program mysqlcheck. Added database name to output for administrative commands like CHECK, REPAIR, OPTIMIZE. Lots of portability xes for InnoDB. Changed optimiser so that queries like SELECT * FROM tbl_name,tbl_name2 ... ORDER BY key_part1 LIMIT row_count will use index on key_part1 instead of filesort. Fixed bug when doing LOCK TABLE to_table WRITE,...; INSERT INTO to_table... SELECT ... when to_table was empty. Fixed bug with LOCK TABLE and BDB tables.

D.4.23 Alteraes na distribuio 3.23.37 (17 Apr 2001) co ca

Fixed a bug when using MATCH() in HAVING clause. Fixed a bug when using HEAP tables with LIKE. Added --mysql-version option to safe_mysqld Changed INNOBASE to InnoDB (because the INNOBASE name was already used). All configure options and mysqld start options now use innodb instead of innobase. This means that before upgrading to this version, you have to change any conguration les where you have used innobase options! Fixed bug when using indexes on CHAR(255) NULL columns. Slave thread will now be started even if master-host is not set, as long as server-id is set and valid master.info is present. Partial updates (terminated with kill) are now logged with a special error code to the binary log. Slave will refuse to execute them if the error code indicates the update was terminated abnormally, and will have to be recovered with SET SQL_SLAVE_SKIP_ COUNTER=1; SLAVE START after a manual sanity check/correction of data integrity. Fixed bug that erroneously logged a drop of internal temporary table on thread termination to the binary log this bug aected replication. Fixed a bug in REGEXP on 64-bit machines. UPDATE and DELETE with WHERE unique_key_part IS NULL didnt update/delete all rows. Disabled INSERT DELAYED for tables that support transactions.

1016

MySQL Technical Reference for Version 5.0.0-alpha

Fixed bug when using date functions on TEXT/BLOB column with wrong date format. UDFs now also work on Windows. (Patch by Ralph Mason.) Fixed bug in ALTER TABLE and LOAD DATA INFILE that disabled key-sorting. These commands should now be faster in most cases. Fixed performance bug where reopened tables (tables that had been waiting for FLUSH or REPAIR) would not use indexes for the next query. Fixed problem with ALTER TABLE to InnoDB tables on FreeBSD. Added mysqld variables myisam_max_sort_file_size and myisam_max_extra_sort_ file_size. Initialise signals early to avoid problem with signals in InnoDB. Applied patch for the tis620 character set to make comparisons case-independent and to x a bug in LIKE for this character set. Note: All tables that uses the tis620 character set must be xed with myisamchk -r or REPAIR TABLE ! Added --skip-safemalloc option to mysqld.

D.4.24 Alteraes na distribuio 3.23.36 (27 Mar 2001) co ca

Fixed a bug that allowed use of database names containing a . character. This xes a serious security issue when mysqld is run as root. Fixed bug when thread creation failed (could happen when doing a lot of connections in a short time). Fixed some problems with FLUSH TABLES and TEMPORARY tables. (Problem with freeing the key cache and error Cant reopen table....) Fixed a problem in InnoDB with other character sets than latin1 and another problem when using many columns. Fixed bug that caused a core dump when using a very complex query involving DISTINCT and summary functions. Added SET TRANSACTION ISOLATION LEVEL ... Added SELECT ... FOR UPDATE. Fixed bug where the number of aected rows was not returned when MySQL was compiled without transaction support. Fixed a bug in UPDATE where keys werent always used to nd the rows to be updated. Fixed a bug in CONCAT_WS() where it returned incorrect results. Changed CREATE ... SELECT and INSERT ... SELECT to not allow concurrent inserts as this could make the binary log hard to repeat. (Concurrent inserts are enabled if you are not using the binary or update log.) Changed some macros to be able to use fast mutex with glibc 2.2.

D.4.25 Alteraes na distribuio 3.23.35 (15 Mar 2001) co ca

Fixed newly introduced bug in ORDER BY. Fixed wrong dene CLIENT_TRANSACTIONS.

Apndice D: Histrico de Alteraes do MySQL e o co

1017

Fixed bug in SHOW VARIABLES when using INNOBASE tables. Setting and using user variables in SELECT DISTINCT didnt work. Tuned SHOW ANALYZE for small tables. Fixed handling of arguments in the benchmark script run-all-tests.

D.4.26 Alteraes na distribuio 3.23.34a co ca

Added extra les to the distribution to allow INNOBASE support to be compiled.

D.4.27 Alteraes na distribuio 3.23.34 (10 Mar 2001) co ca

Added the INNOBASE storage engine and the BDB storage engine to the MySQL source distribution. Updated the documentation about GEMINI tables. Fixed a bug in INSERT DELAYED that caused threads to hang when inserting NULL into an AUTO_INCREMENT column. Fixed a bug in CHECK TABLE / REPAIR TABLE that could cause a thread to hang. REPLACE will not replace a row that conicts with an AUTO_INCREMENT generated key. mysqld now only sets CLIENT_TRANSACTIONS in mysql->server_capabilities if the server supports a transaction-safe storage engine. Fixed LOAD DATA INFILE to allow numeric values to be read into ENUM and SET columns. Improved error diagnostic for slave thread exit. Fixed bug in ALTER TABLE ... ORDER BY. Added max_user_connections variable to mysqld. Limit query length for replication by max_allowed_packet, not the arbitrary limit of 4 MB. Allow space around = in argument to --set-variable. Fixed problem in automatic repair that could leave some threads in state Waiting for table. SHOW CREATE TABLE now displays the UNION=() for MERGE tables. ALTER TABLE now remembers the old UNION=() denition. Fixed bug when replicating timestamps. Fixed bug in bidirectional replication. Fixed bug in the BDB storage engine that occurred when using an index on multi-part key where a key part may be NULL. Fixed MAX() optimization on sub-key for BDB tables. Fixed problem where garbage results were returned when using BDB tables and BLOB or TEXT elds when joining many tables. Fixed a problem with BDB tables and TEXT columns. Fixed bug when using a BLOB key where a const row wasnt found.

1018

MySQL Technical Reference for Version 5.0.0-alpha

Fixed that mysqlbinlog writes the timestamp value for each query. This ensures that one gets same values for date functions like NOW() when using mysqlbinlog to pipe the queries to another server. Allow --skip-gemini, --skip-bdb, and --skip-innodb options to be specied when invoking mysqld, even if these storage engines are not compiled in to mysqld. One can now do GROUP BY ... DESC. Fixed a deadlock in the SET code, when one ran SET @foo=bar, where bar is a column reference, an error was not properly generated.

D.4.28 Alteraes na distribuio 3.23.33 (09 Feb 2001) co ca

Fixed DNS lookups not to use the same mutex as the hostname cache. This will enable known hosts to be quickly resolved even if a DNS lookup takes a long time. Added --character-sets-dir option to myisampack. Removed warnings when running REPAIR TABLE ... EXTENDED. Fixed a bug that caused a core dump when using GROUP BY on an alias, where the alias was the same as an existing column name. Added SEQUENCE() as an example UDF function. Changed mysql_install_db to use BINARY for CHAR columns in the privilege tables. Changed TRUNCATE tbl_name to TRUNCATE TABLE tbl_name to use the same syntax as Oracle. Until 4.0 we will also allow TRUNCATE tbl_name to not crash old code. Fixed no found rows bug in MyISAM tables when a BLOB was rst part of a multi-part key. Fixed bug where CASE didnt work with GROUP BY. Added --sort-recover option to myisamchk. myisamchk -S and OPTIMIZE TABLE now work on Windows. Fixed bug when using DISTINCT on results from functions that referred to a group function, like: SELECT a, DISTINCT SEC_TO_TIME(SUM(a)) FROM tbl_name GROUP BY a, b; Fixed buer overrun in libmysqlclient library. Fixed bug in handling STOP event after ROTATE event in replication. Fixed another buer overrun in DROP DATABASE. Added Table_locks_immediate and Table_locks_waited status variables. Fixed bug in replication that broke slave server start with existing master.info. This xes a bug introduced in 3.23.32. Added SET SQL_SLAVE_SKIP_COUNTER=n command to recover from replication glitches without a full database copy. Added max_binlog_size variable; the binary log will be rotated automatically when the size crosses the limit. Added Last_Error, Last_Errno, and Slave_skip_counter variables to SHOW SLAVE STATUS.

Apndice D: Histrico de Alteraes do MySQL e o co

1019

Fixed bug in MASTER_POS_WAIT() function. Execute core dump handler on SIGILL, and SIGBUS in addition to SIGSEGV. On x86 Linux, print the current query and thread (connection) id, if available, in the core dump handler. Fixed several timing bugs in the test suite. Extended mysqltest to take care of the timing issues in the test suite. ALTER TABLE can now be used to change the denition for a MERGE table. Fixed creation of MERGE tables on Windows. Portability xes for OpenBSD and OS/2. Added --temp-pool option to mysqld. Using this option will cause most temporary les created to use a small set of names, rather than a unique name for each new le. This is to work around a problem in the Linux kernel dealing with creating a bunch of new les with dierent names. With the old behaviour, Linux seems to "leak" memory, as its being allocated to the directory entry cache instead of the disk cache.

D.4.29 Alteraes na distribuio 3.23.32 (22 Jan 2001: co ca Production)

Changed code to get around compiler bug in Compaq C++ on OSF/1, that broke BACKUP, RESTORE, CHECK, REPAIR, and ANALYZE TABLE. Added option FULL to SHOW COLUMNS. Now we show the privilege list for the columns only if this option is given. Fixed bug in SHOW LOGS when there werent any BDB logs. Fixed a timing problem in replication that could delay sending an update to the client until a new update was done. Dont convert eld names when using mysql_list_fields(). This is to keep this code compatible with SHOW FIELDS. MERGE tables didnt work on Windows. Fixed problem with SET PASSWORD=... on Windows. Added missing my_config.h to RPM distribution. TRIM("foo" from "foo") didnt return an empty string. Added --with-version-suffix option to configure. Fixed core dump when client aborted connection without mysql_close(). Fixed a bug in RESTORE TABLE when trying to restore from a non-existent directory. Fixed a bug which caused a core dump on the slave when replicating SET PASSWORD. Added MASTER_POS_WAIT().

D.4.30 Alteraes na distribuio 3.23.31 (17 Jan 2001) co ca

The test suite now tests all reachable BDB interface code. During testing we found and xed many errors in the interface code. Using HAVING on an empty table could produce one result row when it shouldnt.

1020

MySQL Technical Reference for Version 5.0.0-alpha

Fixed the MySQL RPM so it no longer depends on Perl5. Fixed some problems with HEAP tables on Windows. SHOW TABLE STATUS didnt show correct average row length for tables larger than 4G. CHECK TABLE ... EXTENDED didnt check row links for xed size tables. Added option MEDIUM to CHECK TABLE. Fixed problem when using DECIMAL() keys on negative numbers. HOUR() (and some other TIME functions) on a CHAR column always returned NULL. Fixed security bug in something (please upgrade if you are using an earlier MySQL 3.23 version). Fixed buer overow bug when writing a certain error message. Added usage of setrlimit() on Linux to get -O --open-files-limit=# to work on Linux. Added bdb_version variable to mysqld. Fixed bug when using expression of type: SELECT ... FROM t1 LEFT JOIN t2 ON (t1.a=t2.a) WHERE t1.a=t2.a In this case the test in the WHERE clause was wrongly optimised away. Fixed bug in MyISAM when deleting keys with possible NULL values, but the rst keycolumn was not a prex-compressed text column. Fixed mysql.server to read the [mysql.server] option le group rather than the [mysql_server] group. Fixed safe_mysqld and mysql.server to also read the server option section. Added Threads_created status variable to mysqld.

D.4.31 Alteraes na distribuio 3.23.30 (04 Jan 2001) co ca

Added SHOW OPEN TABLES command. Fixed that myisamdump works against old mysqld servers. Fixed myisamchk -k# so that it works again. Fixed a problem with replication when the binary log le went over 2G on 32-bit systems. LOCK TABLES will now automatically start a new transaction. Changed BDB tables to not use internal subtransactions and reuse open les to get more speed. Added --mysqld=# option to safe_mysqld. Allow hex constants in the --fields-*-by and --lines-terminated-by options to mysqldump and mysqlimport. By Paul DuBois. Added --safe-show-database option to mysqld. Added have_bdb, have_gemini, have_innobase, have_raid and have_openssl to SHOW VARIABLES to make it easy to test for supported extensions. Added --open-files-limit option to mysqld. Changed --open-files option to --open-files-limit in safe_mysqld.

Apndice D: Histrico de Alteraes do MySQL e o co

1021

Fixed a bug where some rows were not found with HEAP tables that had many keys. Fixed that --bdb-no-sync works. Changed --bdb-recover to --bdb-no-recover as recover should be on by default. Changed the default number of BDB locks to 10000. Fixed a bug from 3.23.29 when allocating the shared structure needed for BDB tables. Changed mysqld_multi.sh to use congure variables. Patch by Christopher McCrory. Added xing of include les for Solaris 2.8. Fixed bug with --skip-networking on Debian Linux. Fixed problem that some temporary les where reported as having the name UNOPENED in error messages. Fixed bug when running two simultaneous SHOW LOGS queries.

D.4.32 Alteraes na distribuio 3.23.29 (16 Dec 2000) co ca

Congure updates for Tru64, large le support, and better TCP wrapper support. By Albert Chin-A-Young. Fixed bug in <=> operator. Fixed bug in REPLACE with BDB tables. LPAD() and RPAD() will shorten the result string if its longer than the length argument. Added SHOW LOGS command. Remove unused BDB logs on shutdown. When creating a table, put PRIMARY keys rst, followed by UNIQUE keys. Fixed a bug in UPDATE involving multi-part keys where one specied all key parts both in the update and the WHERE part. In this case MySQL could try to update a record that didnt match the whole WHERE part. Changed drop table to rst drop the tables and then the .frm le. Fixed a bug in the hostname cache which caused mysqld to report the hostname as in some error messages. Fixed a bug with HEAP type tables; the variable max_heap_table_size wasnt used. Now either MAX_ROWS or max_heap_table_size can be used to limit the size of a HEAP type table. Changed the default server-id to 1 for masters and 2 for slaves to make it easier to use the binary log. Renamed bdb_lock_max variable to bdb_max_lock. Added support for AUTO_INCREMENT on sub-elds for BDB tables. Added ANALYZE of BDB tables. In BDB tables, we now store the number of rows; this helps to optimise queries when we need an approximation of the number of rows. If we get an error in a multi-row statement, we now only roll back the last statement, not the entire transaction. If you do a ROLLBACK when you have updated a non-transactional table you will get an error as a warning.

1022

MySQL Technical Reference for Version 5.0.0-alpha

Added --bdb-shared-data option to mysqld. Added Slave_open_temp_tables status variable to mysqld Added binlog_cache_size and max_binlog_cache_size variables to mysqld. DROP TABLE, RENAME TABLE, CREATE INDEX and DROP INDEX are now transaction endpoints. If you do a DROP DATABASE on a symbolically linked database, both the link and the original database is deleted. Fixed DROP DATABASE to work on OS/2. Fixed bug when doing a SELECT DISTINCT ... table1 LEFT JOIN table2 ... when table2 was empty. Added --abort-slave-event-count and --disconnect-slave-event-count options to mysqld for debugging and testing of replication. Fixed replication of temporary tables. Handles everything except slave server restart. SHOW KEYS now shows whether key is FULLTEXT. New script mysqld_multi. Veja Seo 4.8.3 [mysqld_multi], Pgina 333. ca a Added new script, mysql-multi.server.sh. Thanks to Tim Bunce Tim.Bunce@ig.co.uk for modifying mysql.server to easily handle hosts running many mysqld processes. safe_mysqld, mysql.server, and mysql_install_db have been modied to use mysql_print_defaults instead of various hacks to read the my.cnf les. In addition, the handling of various paths has been made more consistent with how mysqld handles them by default. Automatically remove Berkeley DB transaction logs that no longer are in use. Fixed bug with several FULLTEXT indexes in one table. Added a warning if number of rows changes on REPAIR/OPTIMIZE. Applied patches for OS/2 by Yuri Dario. FLUSH TABLES tbl_name didnt always ush the index tree to disk properly. --bootstrap is now run in a separate thread. This xes a problem that caused mysql_ install_db to core dump on some Linux machines. Changed mi_create() to use less stack space. Fixed bug with optimiser trying to over-optimise MATCH() when used with UNIQUE key. Changed crash-me and the MySQL benchmarks to also work with FrontBase. Allow RESTRICT and CASCADE after DROP TABLE to make porting easier. Reset status variable which could cause problem if one used --slow-log. Added connect_timeout variable to mysql and mysqladmin. Added connect-timeout as an alias for timeout for option les read by mysql_ options().

D.4.33 Alteraes na distribuio 3.23.28 (22 Nov 2000: Gamma) co ca

Added new options --pager[=...], --no-pager, --tee=... and --no-tee to the mysql client. The new corresponding interactive commands are pager, nopager, tee

Apndice D: Histrico de Alteraes do MySQL e o co

1023

and notee. Veja Seo 4.9.2 [mysql], Pgina 347, mysql --help and the interactive ca a help for more information. Fixed crash when automatic repair of MyISAM table failed. Fixed a major performance bug in the table locking code when one constantly had a lot of SELECT, UPDATE and INSERT statements running. The symptom was that the UPDATE and INSERT queries were locked for a long time while new SELECT statements were executed before the updates. When reading options_files with mysql_options() the return-found-rows option was ignored. One can now specify interactive-timeout in the option le that is read by mysql_ options(). This makes it possible to force programs that run for a long time (like mysqlhotcopy) to use the interactive_timeout time instead of the wait_timeout time. Added to the slow query log the time and the user name for each logged query. If you are using --log-long-format then also queries that do not use an index are logged, even if the query takes less than long_query_time seconds. Fixed a problem in LEFT JOIN which caused all columns in a reference table to be NULL. Fixed a problem when using NATURAL JOIN without keys. Fixed a bug when using a multi-part keys where the rst part was of type TEXT or BLOB. DROP of temporary tables wasnt stored in the update/binary log. Fixed a bug where SELECT DISTINCT * ... LIMIT row_count only returned one row. Fixed a bug in the assembler code in strstr() for SPARC and cleaned up the global.h header le to avoid a problem with bad aliasing with the compiler submitted with Red Hat 7.0. (Reported by Trond Eivind Glomsrd) The --skip-networking option now works properly on NT. Fixed a long outstanding bug in the ISAM tables when a row with a length of more than 65K was shortened by a single byte. Fixed a bug in MyISAM when running multiple updating processes on the same table. Allow one to use FLUSH TABLE tbl_name. Added --replicate-ignore-table, --replicate-do-table, --replicate-wildignore-table, and --replicate-wild-do-table options to mysqld. Changed all log les to use our own IO_CACHE mechanism instead of FILE to avoid OS problems when there are many les open. Added --open-files and --timezone options to safe_mysqld. Fixed a fatal bug in CREATE TEMPORARY TABLE ... SELECT .... Fixed a problem with CREATE TABLE ... SELECT NULL. Added variables large_file_support,net_read_timeout, net_write_timeout and query_buffer_size to SHOW VARIABLES. Added status variables created_tmp_files and sort_merge_passes to SHOW STATUS. Fixed a bug where we didnt allow an index name after the FOREIGN KEY denition. Added TRUNCATE table_name as a synonym for DELETE FROM table_name.

1024

MySQL Technical Reference for Version 5.0.0-alpha

Fixed a bug in a BDB key compare function when comparing part keys. Added bdb_lock_max variable to mysqld. Added more tests to the benchmark suite. Fixed an overow bug in the client code when using overly long database names. mysql_connect() now aborts on Linux if the server doesnt answer in timeout seconds. SLAVE START did not work if you started with --skip-slave-start and had not explicitly run CHANGE MASTER TO. Fixed the output of SHOW MASTER STATUS to be consistent with SHOW SLAVE STATUS. (It now has no directory in the log name.) Added PURGE MASTER LOGS TO. Added SHOW MASTER LOGS. Added --safemalloc-mem-limit option to mysqld to simulate memory shortage when compiled with the --with-debug=full option. Fixed several core dumps in out-of-memory conditions. SHOW SLAVE STATUS was using an uninitialised mutex if the slave had not been started yet. Fixed bug in ELT() and MAKE_SET() when the query used a temporary table. CHANGE MASTER TO without specifying MASTER_LOG_POS would set it to 0 instead of 4 and hit the magic number in the master binlog. ALTER TABLE ... ORDER BY ... syntax added. This will create the new table with the rows in a specic order.

D.4.34 Alteraes na distribuio 3.23.27 (24 Oct 2000) co ca

Fixed a bug where the automatic repair of MyISAM tables sometimes failed when the datale was corrupt. Fixed a bug in SHOW CREATE when using AUTO_INCREMENT columns. Changed BDB tables to use new compare function in Berkeley DB 3.2.3. You can now use Unix sockets with MIT-pthreads. Added the latin5 (turkish) character set. Small portability xes.

D.4.35 Alteraes na distribuio 3.23.26 (18 Oct 2000) co ca

Renamed FLUSH MASTER and FLUSH SLAVE to RESET MASTER and RESET SLAVE. Fixed <> to work properly with NULL. Fixed a problem with SUBSTRING_INDEX() and REPLACE(). (Patch by Alexander Igonitchev) Fix CREATE TEMPORARY TABLE IF NOT EXISTS not to produce an error if the table exists. If you dont create a PRIMARY KEY in a BDB table, a hidden PRIMARY KEY will be created. Added read-only-key optimization to BDB tables.

Apndice D: Histrico de Alteraes do MySQL e o co

1025

LEFT JOIN in some cases preferred a full table scan when there was no WHERE clause. When using --log-slow-queries, dont count the time waiting for a lock. Fixed bug in lock code on Windows which could cause the key cache to report that the key le was crashed even if it was okay. Automatic repair of MyISAM tables if you start mysqld with --myisam-recover. Removed the TYPE= keyword from CHECK and REPAIR. Allow CHECK options to be combined. (You can still use TYPE=, but this usage is deprecated.) Fixed mutex bug in the binary replication log long update queries could be read only in part by the slave if it did it at the wrong time, which was not fatal, but resulted in a performance-degrading reconnect and a scary message in the error log. Changed the format of the binary log added magic number, server version, binlog version. Added server ID and query error code for each query event. Replication thread from the slave now will kill all the stale threads from the same server. Long replication user names were not being handled properly. Added --replicate-rewrite-db option to mysqld. Added --skip-slave-start option to mysqld. Updates that generated an error code (such as INSERT INTO foo(some_key) values (1),(1)) erroneously terminated the slave thread. Added optimization of queries where DISTINCT is only used on columns from some of the tables. Allow oating-point numbers where there is no sign after the exponent (like 1e1). SHOW GRANTS didnt always show all column grants. Added --default-extra-file=# option to all MySQL clients. Columns referenced in INSERT statements now are initialised properly. UPDATE didnt always work when used with a range on a timestamp that was part of the key that was used to nd rows. Fixed a bug in FULLTEXT index when inserting a NULL column. Changed to use mkstemp() instead of tempnam(). Based on a patch from John Jones.

D.4.36 Alteraes na distribuio 3.23.25 (29 Sep 2000) co ca

Fixed that databasename works as second argument to mysqlhotcopy. The values for the UMASK and UMASK_DIR environment variables now can be specied in octal by beginning the value with a zero. Added RIGHT JOIN. This makes RIGHT a reserved word. Added @@IDENTITY as a synonym for LAST_INSERT_ID(). (This is for MSSQL compatibility.) Fixed a bug in myisamchk and REPAIR when using FULLTEXT index. LOAD DATA INFILE now works with FIFOs. (Patch by Toni L. Harbaugh-Blackford.) FLUSH LOGS broke replication if you specied a log name with an explicit extension as the value of the log-bin option.

1026

MySQL Technical Reference for Version 5.0.0-alpha

Fixed a bug in MyISAM with packed multi-part keys. Fixed crash when using CHECK TABLE on Windows. Fixed a bug where FULLTEXT index always used the koi8_ukr character set. Fixed privilege checking for CHECK TABLE. The MyISAM repair/reindex code didnt use the --tmpdir option for its temporary les. Added BACKUP TABLE and RESTORE TABLE. Fixed core dump on CHANGE MASTER TO when the slave did not have the master to start with. Fixed incorrect Time in the processlist for Connect of the slave thread. The slave now logs when it connects to the master. Fixed a core dump bug when doing FLUSH MASTER if you didnt specify a lename argument to --log-bin. Added missing ha_berkeley.x les to the MySQL Windows distribution. Fixed some mutex bugs in the log code that could cause thread blocks if new log les couldnt be created. Added lock time and number of selected processed rows to slow query log. Added --memlock option to mysqld to lock mysqld in memory on systems with the mlockall() call (as in Solaris). HEAP tables didnt use keys properly. (Bug from 3.23.23.) Added better support for MERGE tables (keys, mapping, creation, documentation...). Veja Seo 7.2 [MERGE], Pgina 638. ca a Fixed bug in mysqldump from 3.23 which caused some CHAR columns not to be quoted. Merged analyze, check, optimize and repair code. OPTIMIZE TABLE is now mapped to REPAIR with statistics and sorting of the index tree. This means that for the moment it only works on MyISAM tables. Added a pre-alloced block to root malloc to get fewer mallocs. Added a lot of new statistics variables. Fixed ORDER BY bug with BDB tables. Removed warning that mysqld couldnt remove the .pid le under Windows. Changed --log-isam to log MyISAM tables instead of isam tables. Fixed CHECK TABLE to work on Windows. Added le mutexes to make pwrite() safe on Windows.

D.4.37 Alteraes na distribuio 3.23.24 (08 Sep 2000) co ca

Added created_tmp_disk_tables variable to mysqld. To make it possible to reliably dump and restore tables with TIMESTAMP(X) columns, MySQL now reports columns with X other than 14 or 8 to be strings. Changed sort order for latin1 as it was before MySQL Version 3.23.23. Any table that was created or modied with 3.23.22 must be repaired if it has CHAR columns that may contain characters with ASCII values greater than 128!

Apndice D: Histrico de Alteraes do MySQL e o co

1027

Fixed small memory leak introduced from 3.23.22 when creating a temporary table. Fixed problem with BDB tables and reading on a unique (not primary) key. Restored the win1251 character set (its now only marked deprecated).

D.4.38 Alteraes na distribuio 3.23.23 (01 Sep 2000) co ca

Changed sort order for German; all tables created with German sortorder must be repaired with REPAIR TABLE or myisamchk before use! Added --core-file option to mysqld to get a core le on Linux if mysqld dies on the SIGSEGV signal. MySQL client mysql now starts with option --no-named-commands (-g) by default. This option can be disabled with --enable-named-commands (-G). This may cause incompatibility problems in some cases, for example, in SQL scripts that use named commands without a semicolon, etc.! Long format commands still work from the rst line. Fixed a problem when using many pending DROP TABLE statements at the same time. Optimizer didnt use keys properly when using LEFT JOIN on an empty table. Added shorter help text when invoking mysqld with incorrect options. Fixed non-fatal free() bug in mysqlimport. Fixed bug in MyISAM index handling of DECIMAL/NUMERIC keys. Fixed a bug in concurrent insert in MyISAM tables. In some contexts, usage of MIN(key_ part) or MAX(key_part) returned an empty set. Updated mysqlhotcopy to use the new FLUSH TABLES table_list syntax. Only tables which are being backed up are ushed now. Changed behaviour of --enable-thread-safe-client so that both non-threaded (lmysqlclient) and threaded (-lmysqlclient_r) libraries are built. Users who linked against a threaded -lmysqlclient will need to link against -lmysqlclient_r now. Added atomic RENAME TABLE command. Dont count NULL values in COUNT(DISTINCT ...). Changed ALTER TABLE, LOAD DATA INFILE on empty tables and INSERT ... SELECT ... on empty tables to create non-unique indexes in a separate batch with sorting. This will make the above calls much faster when you have many indexes. ALTER TABLE now logs the rst used insert id correctly. Fixed crash when adding a default value to a BLOB column. Fixed a bug with DATE_ADD/DATE_SUB where it returned a datetime instead of a date. Fixed a problem with the thread cache which made some threads show up as ***DEAD*** in SHOW PROCESSLIST. Fixed a lock in our thr rwlock code, which could make selects that run at the same time as concurrent inserts crash. This only aects systems that dont have the pthread_ rwlock_rdlock code. When deleting rows with a non-unique key in a HEAP table, all rows werent always deleted.

1028

MySQL Technical Reference for Version 5.0.0-alpha

Fixed bug in range optimiser for HEAP tables for searches on a part index. Fixed SELECT on part keys to work with BDB tables. Fixed INSERT INTO bdb_table ... SELECT to work with BDB tables. CHECK TABLE now updates key statistics for the table. ANALYZE TABLE will now only update tables that have been changed since the last ANALYZE. Note that this is a new feature and tables will not be marked to be analysed until they are updated in any way with 3.23.23 or newer. For older tables, you have to do CHECK TABLE to update the key distribution. Fixed some minor privilege problems with CHECK, ANALYZE, REPAIR and SHOW CREATE commands. Added CHANGE MASTER TO statement. Added FAST, QUICK EXTENDED check types to CHECK TABLES. Changed myisamchk so that --fast and --check-only-changed are also honored with --sort-index and --analyze. Fixed fatal bug in LOAD TABLE FROM MASTER that did not lock the table during index re-build. LOAD DATA INFILE broke replication if the database was excluded from replication. More variables in SHOW SLAVE STATUS and SHOW MASTER STATUS. SLAVE STOP now will not return until the slave thread actually exits. Full-text search via the MATCH() function and FULLTEXT index type (for MyISAM les). This makes FULLTEXT a reserved word.

D.4.39 Alteraes na distribuio 3.23.22 (31 Jul 2000) co ca

Fixed that lex_hash.h is created properly for each MySQL distribution. Fixed that MASTER and COLLECTION are not reserved words. The log generated by --slow-query-log didnt contain the whole queries. Fixed that open transactions in BDB tables are rolled back if the connection is closed unexpectedly. Added workaround for a bug in gcc 2.96 (intel) and gcc 2.9 (IA-64) in gen_lex_hash.c. Fixed memory leak in the client library when using host= in the my.cnf le. Optimized functions that manipulate the hours/minutes/seconds. Fixed bug when comparing the result of DATE_ADD()/DATE_SUB() against a number. Changed the meaning of -F, --fast for myisamchk. Added -C, --check-onlychanged option to myisamchk. Added ANALYZE tbl_name to update key statistics for tables. Changed binary items 0x... to be regarded as integers by default. Fix for SCO and SHOW PROCESSLIST. Added auto-rehash on reconnect for the mysql client. Fixed a newly introduced bug in MyISAM, where the index le couldnt get bigger than 64M. Added SHOW MASTER STATUS and SHOW SLAVE STATUS.

Apndice D: Histrico de Alteraes do MySQL e o co

1029

D.4.40 Alteraes na distribuio 3.23.21 co ca

Added mysql_character_set_name() function to the MySQL C API. Made the update log ASCII 0 safe. Added the mysql_config script. Fixed problem when using < or > with a char column that was only partly indexed. One would get a core dump if the log le was not readable by the MySQL user. Changed mysqladmin to use CREATE DATABASE and DROP DATABASE statements instead of the old deprecated API calls. Fixed chown warning in safe_mysqld. Fixed a bug in ORDER BY that was introduced in 3.23.19. Only optimise the DELETE FROM tbl_name to do a drop+create of the table if we are in AUTOCOMMIT mode (needed for BDB tables). Added extra checks to avoid index corruption when the ISAM/MyISAM index les get full during an INSERT/UPDATE. myisamchk didnt correctly update row checksum when used with -ro (this only gave a warning in subsequent runs). Fixed bug in REPAIR TABLE so that it works with tables without indexes. Fixed buer overrun in DROP DATABASE. LOAD TABLE FROM MASTER is suciently bug-free to announce it as a feature. MATCH and AGAINST are now reserved words.

D.4.41 Alteraes na distribuio 3.23.20 co ca

Fixed bug in 3.23.19; DELETE FROM tbl_name removed the .frm le. Added SHOW CREATE TABLE.

D.4.42 Alteraes na distribuio 3.23.19 co ca

Changed copyright for all les to GPL for the server code and utilities and to LGPL for the client libraries. See http://www.fsf.org/licenses/. Fixed bug where all rows matching werent updated on a MyISAM table when doing update based on key on a table with many keys and some key changed values. The Linux MySQL RPMs and binaries are now statically linked with a linuxthread version that has faster mutex handling when used with MySQL. ORDER BY can now use REF keys to nd subsets of the rows that need to be sorted. Changed name of print_defaults program to my_print_defaults to avoid name confusion. Fixed NULLIF() to work as required by SQL-99. Added net_read_timeout and net_write_timeout as startup parameters to mysqld. Fixed bug that destroyed index when doing myisamchk --sort-records on a table with prex compressed index.

1030

MySQL Technical Reference for Version 5.0.0-alpha

Added pack_isam and myisampack to the standard MySQL distribution. Added the syntax BEGIN WORK (the same as BEGIN). Fixed core dump bug when using ORDER BY on a CONV() expression. Added LOAD TABLE FROM MASTER. Added FLUSH MASTER and FLUSH SLAVE. Fixed big/little endian problem in the replication.

D.4.43 Alteraes na distribuio 3.23.18 co ca

Fixed a problem from 3.23.17 when choosing character set on the client side. Added FLUSH TABLES WITH READ LOCK to make a global lock suitable for making a copy of MySQL datales. CREATE TABLE ... SELECT ... PROCEDURE now works. Internal temporary tables will now use compressed index when using GROUP BY on VARCHAR/CHAR columns. Fixed a problem when locking the same table with both a READ and a WRITE lock. Fixed problem with myisamchk and RAID tables.

D.4.44 Alteraes na distribuio 3.23.17 co ca

Fixed a bug in FIND_IN_SET() when the rst argument was NULL. Added table locks to Berkeley DB. Fixed a bug with LEFT JOIN and ORDER BY where the rst table had only one matching row. Added 4 sample my.cnf example les in the support-files directory. Fixed duplicated key problem when doing big GROUP BY operations. (This bug was probably introduced in 3.23.15.) Changed syntax for INNER JOIN to match SQL-99. Added NATURAL JOIN syntax. A lot of xes in the BDB interface. Added handling of --no-defaults and --defaults-file to safe_mysqld.sh and mysql_install_db.sh. Fixed bug in reading compressed tables with many threads. Fixed that USE INDEX works with PRIMARY keys. Added BEGIN statement to start a transaction in AUTOCOMMIT mode. Added support for symbolic links for Windows. Changed protocol to let client know if the server is in AUTOCOMMIT mode and if there is a pending transaction. If there is a pending transaction, the client library will give an error before reconnecting to the server to let the client know that the server did a rollback. The protocol is still backward-compatible with old clients. KILL now works on a thread that is locked on a write to a dead client.

Apndice D: Histrico de Alteraes do MySQL e o co

1031

Fixed memory leak in the replication slave thread. Added new log-slave-updates option to mysqld, to allow daisy-chaining the slaves. Fixed compile error on FreeBSD and other systems where pthread_t is not the same as int. Fixed master shutdown aborting the slave thread. Fixed a race condition in INSERT DELAYED code when doing ALTER TABLE. Added deadlock detection sanity checks to INSERT DELAYED.

D.4.45 Alteraes na distribuio 3.23.16 co ca

Added SLAVE START and SLAVE STOP statements. Added TYPE=QUICK option to CHECK and to REPAIR. Fixed bug in REPAIR TABLE when the table was in use by other threads. Added a thread cache to make it possible to debug MySQL with gdb when one does a lot of reconnects. This will also improve systems where you cant use persistent connections. Lots of xes in the Berkeley DB interface. UPDATE IGNORE will not abort if an update results in a DUPLICATE_KEY error. Put CREATE TEMPORARY TABLE commands in the update log. Fixed bug in handling of masked IP numbers in the privilege tables. Fixed bug with delay_key_write tables and CHECK TABLE. Added replicate-do-db and replicate-ignore-db options to mysqld, to restrict which databases get replicated. Added SQL_LOG_BIN option.

D.4.46 Alteraes na distribuio 3.23.15 (May 2000: Beta) co ca

To start mysqld as root, you must now use the --user=root option. Added interface to Berkeley DB. (This is not yet functional; play with it at your own risk!) Replication between master and slaves. Fixed bug that other threads could steal a lock when a thread had a lock on a table and did a FLUSH TABLES command. Added the slow_launch_time variable and the Slow_launch_threads status variable to mysqld. These can be examined with mysqladmin variables and mysqladmin extended-status. Added functions INET_NTOA() and INET_ATON(). The default type of IF() now depends on the second and third arguments and not only on the second argument. Fixed case when myisamchk could go into a loop when trying to repair a crashed table. Dont write INSERT DELAYED to update log if SQL_LOG_UPDATE=0. Fixed problem with REPLACE on HEAP tables.

1032

MySQL Technical Reference for Version 5.0.0-alpha

Added possible character sets and time zone to SHOW VARIABLES output. Fixed bug in locking code that could result in locking problems with concurrent inserts under high load. Fixed a problem with DELETE of many rows on a table with compressed keys where MySQL scanned the index to nd the rows. Fixed problem with CHECK on table with deleted keyblocks. Fixed a bug in reconnect (at the client side) where it didnt free memory properly in some contexts. Fixed problems in update log when using LAST_INSERT_ID() to update a table with an AUTO_INCREMENT key. Added NULLIF() function. Fixed bug when using LOAD DATA INFILE on a table with BLOB/TEXT columns. Optimized MyISAM to be faster when inserting keys in sorted order. EXPLAIN SELECT ... now also prints out whether MySQL needs to create a temporary table or use le sorting when resolving the SELECT. Added optimization to skip ORDER BY parts where the part is a constant expression in the WHERE part. Indexes can now be used even if the ORDER BY doesnt match the index exactly, as long as all the unused index parts and all the extra ORDER BY columns are constants in the WHERE clause. Veja Seo 5.4.3 [MySQL indexes], Pgina 447. ca a UPDATE and DELETE on a whole unique key in the WHERE part are now faster than before. Changed RAID_CHUNKSIZE to be in 1024-byte increments. Fixed core dump in LOAD_FILE(NULL).

D.4.47 Alteraes na distribuio 3.23.14 co ca

Added mysql_real_escape_string() function to the MySQL C API. Fixed a bug in CONCAT() where one of the arguments was a function that returned a modied argument. Fixed a critical bug in myisamchk, where it updated the header in the index le when one only checked the table. This confused the mysqld daemon if it updated the same table at the same time. Now the status in the index le is only updated if one uses --update-state. With older myisamchk versions you should use --read-only when only checking tables, if there is the slightest chance that the mysqld server is working on the table at the same time! Fixed that DROP TABLE is logged in the update log. Fixed problem when searching on DECIMAL() key eld where the column data contained leading zeros. Fix bug in myisamchk when the AUTO_INCREMENT column isnt the rst key. Allow DATETIME in ISO8601 format: 2000-03-12T12:00:00 Dynamic character sets. A mysqld binary can now handle many dierent character sets (you can choose which when starting mysqld). Added command REPAIR TABLE.

Apndice D: Histrico de Alteraes do MySQL e o co

1033

Added mysql_thread_safe() function to the MySQL C API. Added the UMASK_DIR environment variable. Added CONNECTION_ID() function to return the client connection thread ID. When using = on BLOB or VARCHAR BINARY keys, where only a part of the column was indexed, the whole column of the result row wasnt compared. Fix for sjis character set and ORDER BY. When running in ANSI mode, dont allow columns to be used that arent in the GROUP BY part.

D.4.48 Alteraes na distribuio 3.23.13 co ca

Fixed problem when doing locks on the same table more than 2 times in the same LOCK TABLE command; this xed the problem one got when running the test-ATIS test with --fast or --check-only-changed. Added SQL_BUFFER_RESULT option to SELECT. Removed end space from double/oat numbers in results from temporary tables. Added CHECK TABLE command. Added changes for MyISAM in 3.23.12 that didnt get into the source distribution because of CVS problems. Fixed bug so that mysqladmin shutdown will wait for the local server to close down. Fixed a possible endless loop when calculating timestamp. Added print_defaults program to the .rpm les. Removed mysqlbug from the client .rpm le.

D.4.49 Alteraes na distribuio 3.23.12 (07 Mar 2000) co ca

Fixed bug in MyISAM involving REPLACE ... SELECT ... which could give a corrupted table. Fixed bug in myisamchk where it incorrectly reset the AUTO_INCREMENT value. LOTS of patches for Linux Alpha. MySQL now appears to be relatively stable on Alpha. Changed DISTINCT on HEAP temporary tables to use hashed keys to quickly nd duplicated rows. This mostly concerns queries of type SELECT DISTINCT ... GROUP BY .... This xes a problem where not all duplicates were removed in queries of the above type. In addition, the new code is MUCH faster. Added patches to make MySQL compile on Mac OS X. Added IF NOT EXISTS clause to CREATE DATABASE. Added --all-databases and --databases options to mysqldump to allow dumping of many databases at the same time. Fixed bug in compressed DECIMAL() index in MyISAM tables. Fixed bug when storing 0 into a timestamp. When doing mysqladmin shutdown on a local connection, mysqladmin now waits until the PID le is gone before terminating.

1034

MySQL Technical Reference for Version 5.0.0-alpha

Fixed core dump with some COUNT(DISTINCT ...) queries. Fixed that myisamchk works properly with RAID tables. Fixed problem with LEFT JOIN and key_field IS NULL. Fixed bug in net_clear() which could give the error Aborted connection in the MySQL clients. Added options USE INDEX (key_list) and IGNORE INDEX (key_list) as parameters in SELECT. DELETE and RENAME should now work on RAID tables.

D.4.50 Alteraes na distribuio 3.23.11 co ca

Allow the ALTER TABLE tbl_name ADD (field_list) syntax. Fixed problem with optimiser that could sometimes use incorrect keys. Fixed that GRANT/REVOKE ALL PRIVILEGES doesnt aect GRANT OPTION. Removed extra ) from the output of SHOW GRANTS. Fixed problem when storing numbers in timestamps. Fix problem with timezones that have half hour osets. Allow the syntax UNIQUE INDEX in CREATE statements. mysqlhotcopy - fast online hot-backup utility for local MySQL databases. By Tim Bunce. New more secure mysqlaccess. Thanks to Steve Harvey for this. Added --i-am-a-dummy and --safe-updates options to mysql. Added select_limit and max_join_size variables to mysql. Added SQL_MAX_JOIN_SIZE and SQL_SAFE_UPDATES options. Added READ LOCAL lock that doesnt lock the table for concurrent inserts. (This is used by mysqldump.) Changed that LOCK TABLES ... READ doesnt anymore allow concurrent inserts. Added --skip-delay-key-write option to mysqld. Fixed security problem in the protocol regarding password checking. _rowid can now be used as an alias for an integer type unique indexed column. Added back blocking of SIGPIPE when compiling with --thread-safe-clients to make things safe for old clients.

D.4.51 Alteraes na distribuio 3.23.10 co ca

Fixed bug in 3.23.9 where memory wasnt properly freed when using LOCK TABLES.

D.4.52 Alteraes na distribuio 3.23.9 co ca

Fixed problem that aected queries that did arithmetic on group functions. Fixed problem with timestamps and INSERT DELAYED. Fixed that date_col BETWEEN const_date AND const_date works.

Apndice D: Histrico de Alteraes do MySQL e o co

1035

Fixed problem when only changing a 0 to NULL in a table with BLOB/TEXT columns. Fixed bug in range optimiser when using many key parts and or on the middle key parts: WHERE K1=1 and K3=2 and (K2=2 and K4=4 or K2=3 and K4=5) Added source command to mysql to allow reading of batch les inside the mysql client. Original patch by Matthew Vanecek. Fixed critical problem with the WITH GRANT OPTION option. Dont give an unnecessary GRANT error when using tables from many databases in the same query. Added VIO wrapper (needed for SSL support; by Andrei Errapart and Tnu Samuel). o Fixed optimiser problem on SELECT when using many overlapping indexes. MySQL should now be able to choose keys even better when there are many keys to choose from. Changed optimiser to prefer a range key instead of a ref key when the range key can uses more columns than the ref key (which only can use columns with =). For example, the following type of queries should now be faster: SELECT * from key_part_1=const and key_part_2 > const2 Fixed bug that a change of all VARCHAR columns to CHAR columns didnt change row type from dynamic to xed. Disabled oating-point exceptions for FreeBSD to x core dump when doing SELECT FLOOR(POW(2,63)). Renamed mysqld startup option from --delay-key-write to --delay-key-writefor-all-tables. Added read-next-on-key to HEAP tables. This should x all problems with HEAP tables when using non-UNIQUE keys. Added option to print default arguments to all clients. Added --log-slow-queries option to mysqld to log all queries that take a long time to a separate log le with a time indicating how long the query took. Fixed core dump when doing WHERE key_col=RAND(...). Fixed optimization bug in SELECT ... LEFT JOIN ... key_col IS NULL, when key_ col could contain NULL values. Fixed problem with 8-bit characters as separators in LOAD DATA INFILE.

D.4.53 Alteraes na distribuio 3.23.8 (02 Jan 2000) co ca

Fixed problem when handling indexles larger than 8G. Added latest patches to MIT-pthreads for NetBSD. Fixed problem with timezones that are < GMT - 11. Fixed a bug when deleting packed keys in NISAM. Fixed problem with ISAM when doing some ORDER BY ... DESC queries. Fixed bug when doing a join on a text key which didnt cover the whole key. Option --delay-key-write didnt enable delayed key writing. Fixed update of TEXT column which involved only case changes.

1036

MySQL Technical Reference for Version 5.0.0-alpha

Fixed that INSERT DELAYED doesnt update timestamps that are given. Added function YEARWEEK() and options x, X, v and V to DATE_FORMAT(). Fixed problem with MAX(indexed_column) and HEAP tables. Fixed problem with BLOB NULL keys and LIKE "prefix%". Fixed problem with MyISAM and xed-length rows < 5 bytes. Fixed problem that could cause MySQL to touch freed memory when doing very complicated GROUP BY queries. Fixed core dump if you got a crashed table where an ENUM eld value was too big.

D.4.54 Alteraes na distribuio 3.23.7 (10 Dec 1999) co ca

Fixed workaround under Linux to avoid problems with pthread_mutex_timedwait, which is used with INSERT DELAYED. Veja Seo 2.6.2 [Linux], Pgina 137. ca a Fixed that one will get a disk full error message if one gets disk full when doing sorting (instead of waiting until we got more disk space). Fixed a bug in MyISAM with keys > 250 characters. In MyISAM one can now do an INSERT at the same time as other threads are reading from the table. Added max_write_lock_count variable to mysqld to force a READ lock after a certain number of WRITE locks. Inverted ag delay_key_write on show variables. Renamed concurrency variable to thread_concurrency. The following functions are now multi-byte-safe: LOCATE(substr,str), POSITION(substr IN str), LOCATE(substr,str,pos), INSTR(str,substr), LEFT(str,len), RIGHT(str,len), SUBSTRING(str,pos,len), SUBSTRING(str FROM pos FOR len), MID(str,pos,len), SUBSTRING(str,pos), SUBSTRING(str FROM pos), SUBSTRING_INDEX(str,delim,count), RTRIM(str), TRIM([[BOTH | TRAILING] [remstr] FROM] str), REPLACE(str,from_str,to_str), REVERSE(str), INSERT(str,pos,len,newstr), LCASE(str), LOWER(str), UCASE(str) and UPPER(str); patch by Wei He. Fix core dump when releasing a lock from a non-existent table. Remove locks on tables before starting to remove duplicates. Added option FULL to SHOW PROCESSLIST. Added option --verbose to mysqladmin. Fixed problem when automatically converting HEAP to MyISAM. Fixed bug in HEAP tables when doing insert + delete + insert + scan the table. Fixed bugs on Alpha with REPLACE() and LOAD DATA INFILE. Added interactive_timeout variable to mysqld. Changed the argument to mysql_data_seek() from ulong to ulonglong.

Apndice D: Histrico de Alteraes do MySQL e o co

1037

D.4.55 Alteraes na distribuio 3.23.6 co ca

Added -O lower_case_table_names={0|1} option to mysqld to allow users to force table names to lowercase. Added SELECT ... INTO DUMPFILE. Added --ansi option to mysqld to make some functions SQL-99 compatible. Temporary table names now start with #sql. Added quoting of identiers with (" in --ansi mode). Changed to use snprintf() when printing oats to avoid some buer overows on FreeBSD. Made FLOOR() overow safe on FreeBSD. Added --quote-names option to mysqldump. Fixed bug that one could make a part of a PRIMARY KEY NOT NULL. Fixed encrypt() to be thread-safe and not reuse buer. Added mysql_odbc_escape_string() function to support big5 characters in MyODBC. Rewrote the storage engine to use classes. This introduces a lot of new code, but will make table handling faster and better. Added patch by Sasha for user-dened variables. Changed that FLOAT and DOUBLE (without any length modiers) no longer are xed decimal point numbers. Changed the meaning of FLOAT(X): Now this is the same as FLOAT if X <= 24 and a DOUBLE if 24 < X <= 53. DECIMAL(X) is now an alias for DECIMAL(X,0) and DECIMAL is now an alias for DECIMAL(10,0). The same goes for NUMERIC. Added option ROW_FORMAT={default | dynamic | fixed | compressed} to CREATE_ TABLE. DELETE FROM table_name didnt work on temporary tables. Changed function CHAR_LENGTH() to be multi-byte character safe. Added function ORD(string).

D.4.56 Alteraes na distribuio 3.23.5 (20 Oct 1999) co ca

Fixed some Y2K problems in the new date handling in 3.23. Fixed problem with SELECT DISTINCT ... ORDER BY RAND(). Added patches by Sergei A. Golubchik for text searching on the MyISAM level. Fixed cache overow problem when using full joins without keys. Fixed some congure issues. Some small changes to make parsing faster. Adding a column after the last eld with ALTER TABLE didnt work. Fixed problem when using an AUTO_INCREMENT column in two keys

1038

MySQL Technical Reference for Version 5.0.0-alpha

With MyISAM, you now can have an AUTO_INCREMENT column as a key sub part: CREATE TABLE foo (a INT NOT NULL AUTO_INCREMENT, b CHAR(5), PRIMARY KEY (b,a)) Fixed bug in MyISAM with packed char keys that could be NULL. AS on eld name with CREATE TABLE table_name SELECT ... didnt work. Allow use of NATIONAL and NCHAR when dening character columns. This is the same as not using BINARY. Dont allow NULL columns in a PRIMARY KEY (only in UNIQUE keys). Clear LAST_INSERT_ID() if one uses this in ODBC: WHERE auto_increment_column IS NULL. This seems to x some problems with Access. SET SQL_AUTO_IS_NULL=0|1 now turns on/o the handling of searching after the last inserted row with WHERE auto_increment_column IS NULL. Added new variable concurrency to mysqld for Solaris. Added --relative option to mysqladmin to make extended-status more useful to monitor changes. Fixed bug when using COUNT(DISTINCT ...) on an empty table. Added support for the Chinese character set GBK. Fixed problem with LOAD DATA INFILE and BLOB columns. Added bit operator ~ (negation). Fixed problem with UDF functions.

D.4.57 Alteraes na distribuio 3.23.4 (28 Sep 1999) co ca

Inserting a DATETIME into a TIME column no longer will try to store days in it. Fixed problem with storage of oat/double on little endian machines. (This aected SUM().) Added connect timeout on TCP/IP connections. Fixed problem with LIKE "%" on an index that may have NULL values. REVOKE ALL PRIVILEGES didnt revoke all privileges. Allow creation of temporary tables with same name as the original table. When granting a user a GRANT option for a database, he couldnt grant privileges to other users. New command: SHOW GRANTS FOR user (by Sinisa). New date_add syntax: date/datetime + INTERVAL # interval_type. Chamas. Fixed privilege check for LOAD DATA REPLACE. Automatic xing of broken include les on Solaris 2.7 Some congure issues to x problems with big lesystem detection. REGEXP is now case-insensitive if you use non-binary strings. By Joshua

Apndice D: Histrico de Alteraes do MySQL e o co

1039

D.4.58 Alteraes na distribuio 3.23.3 co ca

Added patches for MIT-pthreads on NetBSD. Fixed range bug in MyISAM. ASC is now the default again for ORDER BY. Added LIMIT to UPDATE. Added mysql_change_user() function to the MySQL C API. Added character set to SHOW VARIABLES. Added support of --[whitespace] comments. Allow INSERT into tbl_name VALUES (), that is, you may now specify an empty value list to insert a row in which each column is set to its default value. Changed SUBSTRING(text FROM pos) to conform to SQL-99. (Before this construct returned the rightmost pos characters.) SUM() with GROUP BY returned 0 on some systems. Changed output for SHOW TABLE STATUS. Added DELAY_KEY_WRITE option to CREATE TABLE. Allow AUTO_INCREMENT on any key part. Fixed problem with YEAR(NOW()) and YEAR(CURDATE()). Added CASE construct. New function COALESCE().

D.4.59 Alteraes na distribuio 3.23.2 (09 Aug 1999) co ca

Fixed range optimiser bug: SELECT * FROM table_name WHERE key_part1 >= const AND (key_part2 = const OR key_part2 = const). The bug was that some rows could be duplicated in the result. Running myisamchk without -a updated the index distribution incorrectly. SET SQL_LOW_PRIORITY_UPDATES=1 was causing a parse error. You can now update index columns that are used in the WHERE clause. UPDATE tbl_ name SET KEY=KEY+1 WHERE KEY > 100 Date handling should now be a bit faster. Added handling of fuzzy dates (dates where day or month is 0), such as 1999-01-00. Fixed optimization of SELECT ... WHERE key_part1=const1 AND key_part_2=const2 AND key_part1=const4 AND key_part2=const4; indextype should be range instead of ref. Fixed egcs 1.1.2 optimiser bug (when using BLOB values) on Linux Alpha. Fixed problem with LOCK TABLES combined with DELETE FROM table. MyISAM tables now allow keys on NULL and BLOB/TEXT columns. The following join is now much faster: SELECT ... FROM t1 LEFT JOIN t2 ON ... WHERE t2.not_null_column IS NULL. ORDER BY and GROUP BY can be done on functions.

1040

MySQL Technical Reference for Version 5.0.0-alpha

Changed handling of const item to allow handling of ORDER BY RAND(). Indexes are now used for WHERE key_column = function. Indexes are now used for WHERE key_column = col_name even if the columns are not identically packed. Indexes are now used for WHERE col_name IS NULL. Changed heap tables to be stored in low byte rst order (to make it easy to convert to MyISAM tables) Automatic change of HEAP temporary tables to MyISAM tables in case of table is full errors. Added --init-file=file_name option to mysqld. Added COUNT(DISTINCT value, [value, ...]). CREATE TEMPORARY TABLE now creates a temporary table, in its own namespace, that is automatically deleted if connection is dropped. New reserved words (required for CASE): CASE, THEN, WHEN, ELSE and END. New functions EXPORT_SET() and MD5(). Support for the GB2312 Chinese character set.

D.4.60 Alteraes na distribuio 3.23.1 co ca

Fixed some compilation problems.

D.4.61 Alteraes na distribuio 3.23.0 (05 Aug 1999: Alpha) co ca

A new storage engine library (MyISAM) with a lot of new features. Veja Seo 7.1 ca [MyISAM], Pgina 631. a You can create in-memory HEAP tables which are extremely fast for lookups. Support for big les (63-bit) on OSs that support big les. New function LOAD_FILE(filename) to get the contents of a le as a string value. New operator <=> which will act as = but will return TRUE if both arguments are NULL. This is useful for comparing changes between tables. Added the ODBC 3.0 EXTRACT(interval FROM datetime) function. Columns dened as FLOAT(X) are not rounded on storage and may be in scientic notation (1.0 E+10) when retrieved. REPLACE is now faster than before. Changed LIKE character comparison to behave as =; This means that e LIKE is e now true. (If the line doesnt display correctly, the latter e is a French e with a dot above.) SHOW TABLE STATUS returns a lot of information about the tables. Added LIKE to the SHOW STATUS command. Added Privileges column to SHOW COLUMNS. Added Packed and Comment columns to SHOW INDEX. Added comments to tables (with CREATE TABLE ... COMMENT "xxx").

Apndice D: Histrico de Alteraes do MySQL e o co

1041

Added UNIQUE, as in CREATE TABLE table_name (col INT not null UNIQUE) New create syntax: CREATE TABLE table_name SELECT ... New create syntax: CREATE TABLE IF NOT EXISTS ... Allow creation of CHAR(0) columns. DATE_FORMAT() now requires % before any format character. DELAYED is now a reserved word (sorry about that :( ). An example procedure is added: analyse, le: sql_analyse.c. This will describe the data in your query. Try the following: SELECT ... FROM ... WHERE ... PROCEDURE ANALYSE([max elements,[max memory]]) This procedure is extremely useful when you want to check the data in your table! BINARY cast to force a string to be compared in case-sensitive fashion. Added --skip-show-database option to mysqld. Check whether a row has changed in an UPDATE now also works with BLOB/TEXT columns. Added the INNER join syntax. NOTE: This made INNER a reserved word! Added support for netmasks to the hostname in the MySQL grant tables. You can specify a netmask using the IP/NETMASK syntax. If you compare a NOT NULL DATE/DATETIME column with IS NULL, this is changed to a compare against 0 to satisfy some ODBC applications. (By shreeve@uci.edu.) NULL IN (...) now returns NULL instead of 0. This will ensure that null_column NOT IN (...) doesnt match NULL values. Fix storage of oating-point values in TIME columns. Changed parsing of TIME strings to be more strict. Now the fractional second part is detected (and currently skipped). The following formats are supported: [[DAYS] [H]H:]MM:]SS[.fraction] [[[[[H]H]H]H]MM]SS[.fraction] Detect (and ignore) fractional second part from DATETIME. Added the LOW_PRIORITY attribute to LOAD DATA INFILE. The default index name now uses the same case as the column name on which the index name is based. Changed default number of connections to 100. Use bigger buers when using LOAD DATA INFILE. DECIMAL(x,y) now works according to SQL-99. Added aggregate UDF functions. Thanks to Andreas F. Bobak (bobak@relog.ch) for this! LAST_INSERT_ID() is now updated for INSERT INTO ... SELECT. Some small changes to the join table optimiser to make some joins faster. SELECT DISTINCT is much faster; it uses the new UNIQUE functionality in MyISAM. One dierence compared to MySQL Version 3.22 is that the output of DISTINCT is no longer sorted.

1042

MySQL Technical Reference for Version 5.0.0-alpha

All C client API macros are now functions to make shared libraries more reliable. Because of this, you can no longer call mysql_num_fields() on a MYSQL object, you must use mysql_field_count() instead. Added use of LIBWRAP; patch by Henning P. Schmiedehausen. Dont allow AUTO_INCREMENT for other than numerical columns. Using AUTO_INCREMENT will now automatically make the column NOT NULL. Show NULL as the default value for AUTO_INCREMENT columns. Added SQL_BIG_RESULT; SQL_SMALL_RESULT is now default. Added a shared library RPM. This enhancement was contributed by David Fox (dsfox@cogsci.ucsd.edu). Added --enable-large-files and --disable-large-files switches to configure. See configure.in for some systems where this is automatically turned o because of broken implementations. Upgraded readline to 4.0. New CREATE TABLE options: PACK_KEYS and CHECKSUM. Added --default-table-type option to mysqld.

D.5 Alteraes na distribuio 3.22.x (Old; discontinued) co ca

The 3.22 version has faster and safer connect code than version 3.21, as well as a lot of new nice enhancements. As there arent really any major changes, upgrading from 3.21 to 3.22 should be very easy and painless. Veja Seo 2.5.4 [Upgrading-from-3.21], Pgina 129. ca a

D.5.1 Alteraes na distribuio 3.22.35 co ca

Fixed problem with STD(). Merged changes from the newest ISAM library from 3.23. Fixed problem with INSERT DELAYED. Fixed a bug core dump when using a LEFT JOIN/STRAIGHT_JOIN on a table with only one row.

D.5.2 Alteraes na distribuio 3.22.34 co ca

Fixed problem with GROUP BY on TINYBLOB columns; this caused bugzilla to not show rows in some queries. Had to do total recompile of the Windows binary version as VC++ didnt compile all relevant les for 3.22.33 :(

D.5.3 Alteraes na distribuio 3.22.33 co ca

Fixed problems in Windows when locking tables with LOCK TABLE. Quicker kill of SELECT DISTINCT queries.

Apndice D: Histrico de Alteraes do MySQL e o co

1043

D.5.4 Alteraes na distribuio 3.22.32 (14 Feb 2000) co ca

Fixed problem when storing numbers in timestamps. Fix problem with timezones that have half hour osets. Added mysqlhotcopy, a fast online hot-backup utility for local MySQL databases. By Tim Bunce. New more secure mysqlaccess. Thanks to Steve Harvey for this. Fixed security problem in the protocol regarding password checking. Fixed problem that aected queries that did arithmetic on GROUP functions. Fixed a bug in the ISAM code when deleting rows on tables with packed indexes.

D.5.5 Alteraes na distribuio 3.22.31 co ca

A few small xes for the Windows version.

D.5.6 Alteraes na distribuio 3.22.30 co ca

Fixed optimiser problem on SELECT when using many overlapping indexes. Disabled oating-point exceptions for FreeBSD to x core dump when doing SELECT FLOOR(POW(2,63)). Added print of default arguments options to all clients. Fixed critical problem with the WITH GRANT OPTION option. Fixed non-critical Y2K problem when writing short date to log les.

D.5.7 Alteraes na distribuio 3.22.29 (02 Jan 2000) co ca

Upgraded the congure and include les to match the latest 3.23 version. This should increase portability and make it easier to build shared libraries. Added latest patches to MIT-pthreads for NetBSD. Fixed problem with timezones that are < GMT -11. Fixed a bug when deleting packed keys in NISAM. Fixed problem that could cause MySQL to touch freed memory when doing very complicated GROUP BY queries. Fixed core dump if you got a crashed table where an ENUM eld value was too big. Added mysqlshutdown.exe and mysqlwatch.exe to the Windows distribution. Fixed problem when doing ORDER BY on a reference key. Fixed that INSERT DELAYED doesnt update timestamps that are given.

D.5.8 Alteraes na distribuio 3.22.28 (20 Oct 1999) co ca

Fixed problem with LEFT JOIN and COUNT() on a column which was declared NULL + and it had a DEFAULT value. Fixed core dump problem when using CONCAT() in a WHERE clause. Fixed problem with AVG() and STD() with NULL values.

1044

MySQL Technical Reference for Version 5.0.0-alpha

D.5.9 Alteraes na distribuio 3.22.27 co ca

Fixed prototype in my_ctype.h when using other character sets. Some congure issues to x problems with big lesystem detection. Fixed problem when sorting on big BLOB columns. ROUND() will now work on Windows.

D.5.10 Alteraes na distribuio 3.22.26 (16 Sep 1999) co ca

Fixed core dump with empty BLOB/TEXT column argument to REVERSE(). Extended /*! */ with version numbers. Changed SUBSTRING(text FROM pos) to conform to SQL-99. (Before this construct returned the rightmost pos characters.) Fixed problem with LOCK TABLES combined with DELETE FROM table Fixed problem that INSERT ... SELECT didnt use BIG_TABLES. SET SQL_LOW_PRIORITY_UPDATES=# didnt work. Password wasnt updated correctly if privileges didnt change on: GRANT ... IDENTIFIED BY Fixed range optimiser bug in SELECT * FROM table_name WHERE key_part1 >= const AND (key_part2 = const OR key_part2 = const). Fixed bug in compression key handling in ISAM.

D.5.11 Alteraes na distribuio 3.22.25 co ca

Fixed some small problems with the installation.

D.5.12 Alteraes na distribuio 3.22.24 (05 Jul 1999) co ca

DATA is no longer a reserved word. Fixed optimiser bug with tables with only one row. Fixed bug when using LOCK TABLES table_name READ; FLUSH TABLES; Applied some patches for HP-UX. isamchk should now work on Windows. Changed configure to not use big le handling on Linux as this crashes some Red Hat 6.0 systems

D.5.13 Alteraes na distribuio 3.22.23 (08 Jun 1999) co ca

Upgraded to use Autoconf 2.13, Automake 1.4 and libtool 1.3.2. Better support for SCO in configure. Added option --defaults-file=file_name to option le handling to force use of only one specic option le. Extended CREATE syntax to ignore MySQL Version 3.23 keywords.

Apndice D: Histrico de Alteraes do MySQL e o co

1045

Fixed deadlock problem when using INSERT DELAYED on a table locked with LOCK TABLES. Fixed deadlock problem when using DROP TABLE on a table that was locked by another thread. Add logging of GRANT/REVOKE commands in the update log. Fixed isamchk to detect a new error condition. Fixed bug in NATURAL LEFT JOIN.

D.5.14 Alteraes na distribuio 3.22.22 (30 Apr 1999) co ca

Fixed problem in the C API when you called mysql_close() directly after mysql_ init(). Better client error message when you cant open socket. Fixed delayed_insert_thread counting when you couldnt create a new delayed insert thread. Fixed bug in CONCAT() with many arguments. Added patches for DEC 3.2 and SCO. Fixed path-bug when installing MySQL as a service on NT. MySQL on Windows is now compiled with VC++ 6.0 instead of with VC++ 5.0. New installation setup for MySQL on Windows.

D.5.15 Alteraes na distribuio 3.22.21 co ca

Fixed problem with DELETE FROM TABLE when table was locked by another thread. Fixed bug in LEFT JOIN involving empty tables. Changed the mysql.db column from CHAR(32) to CHAR(60). MODIFY and DELAYED are no longer reserved words. Fixed a bug when storing days in a TIME column. Fixed a problem with Host ... is not allowed to connect to this MySQL server after one had inserted a new MySQL user with a GRANT command. Changed to use TCP_NODELAY also on Linux (should give faster TCP/IP connections).

D.5.16 Alteraes na distribuio 3.22.20 (18 Mar 1999) co ca

Fixed STD() for big tables when result should be 0. The update log didnt have newlines on some operating systems. INSERT DELAYED had some garbage at end in the update log.

D.5.17 Alteraes na distribuio 3.22.19 (Mar 1999: Production) co ca

Fixed bug in mysql_install_db (from 3.22.17). Changed default key cache size to 8M. Fixed problem with queries that needed temporary tables with BLOB columns.

1046

MySQL Technical Reference for Version 5.0.0-alpha

D.5.18 Alteraes na distribuio 3.22.18 co ca

Fixes a fatal problem in 3.22.17 on Linux; after shutdown not all threads died properly. Added option -O flush_time=# to mysqld. This is mostly useful on Windows and tells how often MySQL should close all unused tables and ush all updated tables to disk. Fixed problem that a VARCHAR column compared with CHAR column didnt use keys eciently.

D.5.19 Alteraes na distribuio 3.22.17 co ca

Fixed a core dump problem when using --log-update and connecting without a default database. Fixed some configure and portability problems. Using LEFT JOIN on tables that had circular dependencies caused mysqld to hang forever.

D.5.20 Alteraes na distribuio 3.22.16 (Feb 1999: Gamma) co ca

mysqladmin processlist could kill the server if a new user logged in. DELETE FROM tbl_name WHERE key_column=col_name didnt nd any matching rows. Fixed. DATE_ADD(column, ...) didnt work. INSERT DELAYED could deadlock with status upgrading lock Extended ENCRYPT() to take longer salt strings than 2 characters. longlong2str is now much faster than before. For Intel x86 platforms, this function is written in optimised assembler. Added the MODIFY keyword to ALTER TABLE.

D.5.21 Alteraes na distribuio 3.22.15 co ca

GRANT used with IDENTIFIED BY didnt take eect until privileges were ushed. Name change of some variables in SHOW STATUS. Fixed problem with ORDER BY with only index optimization when there were multiple key denitions for a used column. DATE and DATETIME columns are now up to 5 times faster than before. INSERT DELAYED can be used to let the client do other things while the server inserts rows into a table. LEFT JOIN USING (col1,col2) didnt work if one used it with tables from 2 dierent databases. LOAD DATA LOCAL INFILE didnt work in the Unix version because of a missing le. Fixed problems with VARCHAR/BLOB on very short rows (< 4 bytes); error 127 could occur when deleting rows. Updating BLOB/TEXT through formulas didnt work for short (< 256 char) strings.

Apndice D: Histrico de Alteraes do MySQL e o co

1047

When you did a GRANT on a new host, mysqld could die on the rst connect from this host. Fixed bug when one used ORDER BY on column name that was the same name as an alias. Added BENCHMARK(loop_count,expression) function to time expressions.

D.5.22 Alteraes na distribuio 3.22.14 co ca

Allow empty arguments to mysqld to make it easier to start from shell scripts. Setting a TIMESTAMP column to NULL didnt record the timestamp value in the update log. Fixed lock handler bug when one did INSERT INTO TABLE ... SELECT ... GROUP BY. Added a patch for localtime_r() on Windows so that it will no lonher crash if your date is > 2039, but instead will return a time of all zero. Names for user-dened functions are no longer case-sensitive. Added escape of ^Z (ASCII 26) to \Z as ^Z doesnt work with pipes on Windows. mysql_fix_privileges adds a new column to the mysql.func to support aggregate UDF functions in future MySQL releases.

D.5.23 Alteraes na distribuio 3.22.13 co ca

Saving NOW(), CURDATE() or CURTIME() directly in a column didnt work. SELECT COUNT(*) ... LEFT JOIN ... didnt work with no WHERE part. Updated config.guess to allow MySQL to congure on UnixWare 7.1.x. Changed the implementation of pthread_cond() on the Windows version. get_lock() now correctly times out on Windows!

D.5.24 Alteraes na distribuio 3.22.12 co ca

Fixed problem when using DATE_ADD() and DATE_SUB() in a WHERE clause. You can now set the password for a user with the GRANT ... TO user IDENTIFIED BY password syntax. Fixed bug in GRANT checking with SELECT on many tables. Added missing le mysql_fix_privilege_tables to the RPM distribution. This is not run by default because it relies on the client package. Added option SQL_SMALL_RESULT to SELECT to force use of fast temporary tables when you know that the result set will be small. Allow use of negative real numbers without a decimal point. Day number is now adjusted to maximum days in month if the resulting month after DATE_ADD/DATE_SUB() doesnt have enough days. Fix that GRANT compares columns in case-insensitive fashion. Fixed a bug in sql_list.h that made ALTER TABLE dump core in some contexts.

1048

MySQL Technical Reference for Version 5.0.0-alpha

The hostname in user@hostname can now include . and - without quotes in the context of the GRANT, REVOKE and SET PASSWORD FOR ... statements. Fix for isamchk for tables which need big temporary les.

D.5.25 Alteraes na distribuio 3.22.11 co ca

Important: You must run the mysql_fix_privilege_tables script when you upgrade to this version! This is needed because of the new GRANT system. If you dont do this, you will get Access denied when you try to use ALTER TABLE, CREATE INDEX, or DROP INDEX. GRANT to allow/deny users table and column access. Changed USER() to return a value in user@host format. Formerly it returned only user. Changed the syntax for how to set PASSWORD for another user. New command FLUSH STATUS that resets most status variables to zero. New status variables: aborted_threads, aborted_connects. New option variable: connection_timeout. Added support for Thai sorting (by Pruet Boonma pruet@ds90.intanon.nectec.or.th). Slovak and Japanese error messages. Conguration and portability xes. Added option SET SQL_WARNINGS=1 to get a warning count also for simple (single-row) inserts. MySQL now uses SIGTERM instead of SIGQUIT with shutdown to work better on FreeBSD. Added option \G (print vertically) to mysql. SELECT HIGH_PRIORITY ... killed mysqld. IS NULL on a AUTO_INCREMENT column in a LEFT JOIN didnt work as expected. New function MAKE_SET().

D.5.26 Alteraes na distribuio 3.22.10 co ca

mysql_install_db no longer starts the MySQL server! You should start mysqld with safe_mysqld after installing it! The MySQL RPM will, however, start the server as before. Added --bootstrap option to mysqld and recoded mysql_install_db to use it. This will make it easier to install MySQL with RPMs. Changed +, - (sign and minus), *, /, %, ABS() and MOD() to be BIGINT aware (64-bit safe). Fixed a bug in ALTER TABLE that caused mysqld to crash. MySQL now always reports the conicting key values when a duplicate key entry occurs. (Before this was only reported for INSERT.) New syntax: INSERT INTO tbl_name SET col_name=value, col_name=value, ...

Apndice D: Histrico de Alteraes do MySQL e o co

1049

Most errors in the .err log are now prexed with a time stamp. Added option MYSQL_INIT_COMMAND to mysql_options() to make a query on connect or reconnect. Added option MYSQL_READ_DEFAULT_FILE and MYSQL_READ_DEFAULT_GROUP to mysql_options() to read the following parameters from the MySQL option les: port, socket, compress, password, pipe, timeout, user, init-command, host and database. Added maybe_null to the UDF structure. Added option IGNORE to INSERT statements with many rows. Fixed some problems with sorting of the koi8 character sets; users of koi8 must run isamchk -rq on each table that has an index on a CHAR or VARCHAR column. New script mysql_setpermission, by Luuk de Boer. It allows easy creation of new users with permissions for specic databases. Allow use of hexadecimal strings (0x...) when specifying a constant string (like in the column separators with LOAD DATA INFILE). Ported to OS/2 (thanks to Antony T. Curtis antony.curtis@olcs.net). Added more variables to SHOW STATUS and changed format of output to be like SHOW VARIABLES. Added extended-status command to mysqladmin which will show the new status variables.

D.5.27 Alteraes na distribuio 3.22.9 co ca

SET SQL_LOG_UPDATE=0 caused a lockup of the server. New SQL command: FLUSH [ TABLES | HOSTS | LOGS | PRIVILEGES ] [, ...] New SQL command: KILL thread_id. Added casts and changed include les to make MySQL easier to compile on AIX and DEC OSF/1 4.x Fixed conversion problem when using ALTER TABLE from a INT to a short CHAR() column. Added SELECT HIGH_PRIORITY; this will get a lock for the SELECT even if there is a thread waiting for another SELECT to get a WRITE LOCK. Moved wild_compare() to string class to be able to use LIKE on BLOB/TEXT columns with \0. Added ESCAPE option to LIKE. Added a lot more output to mysqladmin debug. You can now start mysqld on Windows with the --flush option. This will ush all tables to disk after each update. This makes things much safer on the Windows platforms but also much slower.

D.5.28 Alteraes na distribuio 3.22.8 co ca

Czech character sets should now work much better.

1050

MySQL Technical Reference for Version 5.0.0-alpha

DATE_ADD() and DATE_SUB() didnt work with group functions. mysql will now also try to reconnect on USE database commands. Fix problem with ORDER BY and LEFT JOIN and const tables. Fixed problem with ORDER BY if the rst ORDER BY column was a key and the rest of the ORDER BY columns wasnt part of the key. Fixed a big problem with OPTIMIZE TABLE. MySQL clients on NT will now by default rst try to connect with named pipes and after this with TCP/IP. Fixed a problem with DROP TABLE and mysqladmin shutdown on Windows (a fatal bug from 3.22.6). Fixed problems with TIME columns and negative strings. Added an extra thread signal loop on shutdown to avoid some error messages from the client. MySQL now uses the next available number as extension for the update log le. Added patches for UNIXWARE 7.

D.5.29 Alteraes na distribuio 3.22.7 (Sep 1998: Beta) co ca

Added LIMIT clause for the DELETE statement. You can now use the /*! ... */ syntax to hide MySQL-specic keywords when you write portable code. MySQL will parse the code inside the comments as if the surrounding /*! and */ comment characters didnt exist. OPTIMIZE TABLE tbl_name can now be used to reclaim disk space after many deletes. Currently, this uses ALTER TABLE to regenerate the table, but in the future it will use an integrated isamchk for more speed. Upgraded libtool to get the congure more portable. Fixed slow UPDATE and DELETE operations when using DATETIME or DATE keys. Changed optimiser to make it better at deciding when to do a full join and when using keys. You can now use mysqladmin proc to display information about your own threads. Only users with the PROCESS privilege can get information about all threads. (In 4.0.2 one needs the SUPER privilege for this.) Added handling of formats YYMMDD, YYYYMMDD, YYMMDDHHMMSS for numbers when using DATETIME and TIMESTAMP types. (Formerly these formats only worked with strings.) Added connect option CLIENT_IGNORE_SPACE to allow use of spaces after function names and before ( (Powerbuilder requires this). This will make all function names reserved words. Added the --log-long-format option to mysqld to enable timestamps and INSERT IDs in the update log. Added --where option to mysqldump (patch by Jim Faucette). The lexical analyser now uses perfect hashing for faster parsing of SQL statements.

Apndice D: Histrico de Alteraes do MySQL e o co

1051

D.5.30 Alteraes na distribuio 3.22.6 co ca

Faster mysqldump. For the LOAD DATA INFILE statement, you can now use the new LOCAL keyword to read the le from the client. mysqlimport will automatically use LOCAL when importing with the TCP/IP protocol. Fixed small optimise problem when updating keys. Changed makeles to support shared libraries. MySQL-NT can now use named pipes, which means that you can now use MySQL-NT without having to install TCP/IP.

D.5.31 Alteraes na distribuio 3.22.5 co ca

All table lock handing is changed to avoid some very subtle deadlocks when using DROP TABLE, ALTER TABLE, DELETE FROM TABLE and mysqladmin flush-tables under heavy usage. Changed locking code to get better handling of locks of dierent types. Updated DBI to 1.00 and DBD to 1.2.0. Added a check that the error message le contains error messages suitable for the current version of mysqld. (To avoid errors if you accidentally try to use an old error message le.) All count structures in the client (affected_rows(), insert_id(), ...) are now of type BIGINT to allow 64-bit values to be used. This required a minor change in the MySQL protocol which should aect only old clients when using tables with AUTO_INCREMENT values > 16M. The return type of mysql_fetch_lengths() has changed from uint * to ulong *. This may give a warning for old clients but should work on most machines. Change mysys and dbug libraries to allocate all thread variables in one struct. This makes it easier to make a threaded libmysql.dll library. Use the result from gethostname() (instead of uname()) when constructing .pid le names. New better compressed server/client protocol. COUNT(), STD() and AVG() are extended to handle more than 4G rows. You can now store values in the range -838:59:59 <= x <= 838:59:59 in a TIME column. Warning: incompatible change!! If you set a TIME column to too short a value, MySQL now assumes the value is given as: [[[D ]HH:]MM:]SS instead of HH[:MM[:SS]]. TIME_TO_SEC() and SEC_TO_TIME() can now handle negative times and hours up to 32767. Added new option SET SQL_LOG_UPDATE={0|1} to allow users with the PROCESS privilege to bypass the update log. (Modied patch from Sergey A Mukhin violet@rosnet.net.) Fixed fatal bug in LPAD(). Initialise line buer in mysql.cc to make BLOB reading from pipes safer.

1052

MySQL Technical Reference for Version 5.0.0-alpha

Added -O max_connect_errors=# option to mysqld. Connect errors are now reset for each correct connection. Increased the default value of max_allowed_packet to 1M in mysqld. Added --low-priority-updates option to mysqld, to give table-modifying operations (INSERT, REPLACE, UPDATE, DELETE) lower priority than retrievals. You can now use {INSERT | REPLACE | UPDATE | DELETE} LOW_PRIORITY ... You can also use SET SQL_LOW_PRIORITY_UPDATES={0|1} to change the priority for one thread. One side eect is that LOW_PRIORITY is now a reserved word. :( Add support for INSERT INTO table ... VALUES(...),(...),(...), to allow inserting multiple rows with a single statement. INSERT INTO tbl_name is now also cached when used with LOCK TABLES. (Previously only INSERT ... SELECT and LOAD DATA INFILE were cached.) Allow GROUP BY functions with HAVING: mysql> SELECT col FROM table GROUP BY col HAVING COUNT(*)>0; mysqld will now ignore trailing ; characters in queries. This is to make it easier to migrate from some other SQL servers that require the trailing ;. Fix for corrupted xed-format output generated by SELECT INTO OUTFILE. Warning: incompatible change! Added Oracle GREATEST() and LEAST() functions. You must now use these instead of the MAX() and MIN() functions to get the largest/smallest value from a list of values. These can now handle REAL, BIGINT and string (CHAR or VARCHAR) values. Warning: incompatible change! DAYOFWEEK() had oset 0 for Sunday. Changed the oset to 1. Give an error for queries that mix GROUP BY columns and elds when there is no GROUP BY specication. Added --vertical option to mysql, for printing results in vertical mode. Index-only optimization; some queries are now resolved using only indexes. Until MySQL 4.0, this works only for numeric columns. Veja Seo 5.4.3 [MySQL indexes], ca Pgina 447. a Lots of new benchmarks. A new C API chapter and lots of other improvements in the manual.

D.5.32 Alteraes na distribuio 3.22.4 co ca

Added --tmpdir option to mysqld, for specifying the location of the temporary le directory. MySQL now automatically changes a query from an ODBC client: SELECT ... FROM table WHERE auto_increment_column IS NULL to: SELECT ... FROM table WHERE auto_increment_column == LAST_INSERT_ID() This allows some ODBC programs (Delphi, Access) to retrieve the newly inserted row to fetch the AUTO_INCREMENT id.

Apndice D: Histrico de Alteraes do MySQL e o co

1053

DROP TABLE now waits for all users to free a table before deleting it. Fixed small memory leak in the new connect protocol. New functions BIN(), OCT(), HEX() and CONV() for converting between dierent number bases. Added function SUBSTRING() with 2 arguments. If you created a table with a record length smaller than 5, you couldnt delete rows from the table. Added optimization to remove const reference tables from ORDER BY and GROUP BY. mysqld now automatically disables system locking on Linux and Windows, and for systems that use MIT-pthreads. You can force the use of locking with the --enableexternal-locking option. Added --console option to mysqld, to force a console window (for error messages) when using Windows. Fixed table locks for Windows. Allow $ in identiers. Changed name of user-specic conguration le from my.cnf to .my.cnf (Unix only). Added DATE_ADD() and DATE_SUB() functions.

D.5.33 Alteraes na distribuio 3.22.3 co ca

Fixed a lock problem (bug in MySQL Version 3.22.1) when closing temporary tables. Added missing mysql_ping() to the client library. Added --compress option to all MySQL clients. Changed byte to char in mysql.h and mysql_com.h.

D.5.34 Alteraes na distribuio 3.22.2 co ca

Searching on multiple constant keys that matched more than 30% of the rows didnt always use the best possible key. New functions <<, >>, RPAD() and LPAD(). You can now save default options (like passwords) in a conguration le (my.cnf). Lots of small changes to get ORDER BY to work when no records are found when using elds that are not in GROUP BY (MySQL extension). Added --chroot option to mysqld, to start mysqld in a chroot environment (by Nikki Chumakov nikkic@cityline.ru). Trailing spaces are now ignored when comparing case-sensitive strings; this should x some problems with ODBC and ag 512! Fixed a core dump bug in the range optimiser. Added --one-thread option to mysqld, for debugging with LinuxThreads (or glibc). (This replaces the -T32 ag) Added DROP TABLE IF EXISTS to prevent an error from occurring if the table doesnt exist.

1054

MySQL Technical Reference for Version 5.0.0-alpha

IF and EXISTS are now reserved words (they would have to be sooner or later). Added lots of new options to mysqldump. Server error messages are now in mysqld_error.h. The server/client protocol now supports compression. All bug xes from MySQL Version 3.21.32.

D.5.35 Alteraes na distribuio 3.22.1 (Jun 1998: Alpha) co ca

Added new C API function mysql_ping(). Added new API functions mysql_init() and mysql_options(). You now MUST call mysql_init() before you call mysql_real_connect(). You dont have to call mysql_ init() if you only use mysql_connect(). Added mysql_options(...,MYSQL_OPT_CONNECT_TIMEOUT,...) so you can set a timeout for connecting to a server. Added --timeout option to mysqladmin, as a test of mysql_options(). Added AFTER column and FIRST options to ALTER TABLE ... ADD columns. This makes it possible to add a new column at some specic location within a row in an existing table. WEEK() now takes an optional argument to allow handling of weeks when the week starts on Monday (some European countries). By default, WEEK() assumes the week starts on Sunday. TIME columns werent stored properly (bug in MySQL Version 3.22.0). UPDATE now returns information about how many rows were matched and updated, and how many warnings occurred when doing the update. Fixed incorrect result from FORMAT(-100,2). ENUM and SET columns were compared in binary (case-sensitive) fashion; changed to be case-insensitive.

D.5.36 Alteraes na distribuio 3.22.0 co ca

New (backward-compatible) connect protocol that allows you to specify the database to use when connecting, to get much faster connections to a specic database. The mysql_real_connect() call is changed to: mysql_real_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd, const char *db, uint port, const char *unix_socket, uint client_flag) Each connection is handled by its own thread, rather than by the master accept() thread. This xes permanently the telnet bug that was a topic on the mail list some time ago. All TCP/IP connections are now checked with backward-resolution of the hostname to get better security. mysqld now has a local hostname resolver cache so connections should actually be faster than before, even with this feature.

Apndice D: Histrico de Alteraes do MySQL e o co

1055

A site automatically will be blocked from future connections if someone repeatedly connects with an improper header (like when one uses telnet). You can now refer to tables in dierent databases with references of the form tbl_ name@db_name or db_name.tbl_name. This makes it possible to give a user read access to some tables and write access to others simply by keeping them in dierent databases! Added --user option to mysqld, to allow it to run as another Unix user (if it is started as the Unix root user). Added caching of users and access rights (for faster access rights checking) Normal users (not anonymous ones) can change their password with mysqladmin password new_password. This uses encrypted passwords that are not logged in the normal MySQL log! All important string functions are now coded in assembler for x86 Linux machines. This gives a speedup of 10% in many cases. For tables that have many columns, the column names are now hashed for much faster column name lookup (this will speed up some benchmark tests a lot!) Some benchmarks are changed to get better individual timing. (Some loops were so short that a specic test took < 2 seconds. The loops have been changed to take about 20 seconds to make it easier to compare dierent databases. A test that took 1-2 seconds before now takes 11-24 seconds, which is much better) Re-arranged SELECT code to handle some very specic queries involving group functions (like COUNT(*)) without a GROUP BY but with HAVING. The following now works: mysql> SELECT COUNT(*) as C FROM table HAVING C > 1; Changed the protocol for eld functions to be faster and avoid some calls to malloc(). Added -T32 option to mysqld, for running all queries under the main thread. This makes it possible to debug mysqld under Linux with gdb! Added optimization of not_null_column IS NULL (needed for some Access queries). Allow STRAIGHT_JOIN to be used between two tables to force the optimiser to join them in a specic order. String functions now return VARCHAR rather than CHAR and the column type is now VARCHAR for elds saved as VARCHAR. This should make the MyODBC driver better, but may break some old MySQL clients that dont handle FIELD_TYPE_VARCHAR the same way as FIELD_TYPE_CHAR. CREATE INDEX and DROP INDEX are now implemented through ALTER TABLE. CREATE TABLE is still the recommended (fast) way to create indexes. Added --set-variable option wait_timeout to mysqld. Added time column to mysqladmin processlist to show how long a query has taken or how long a thread has slept. Added lots of new variables to show variables and some new to show status. Added new type YEAR. YEAR is stored in 1 byte with allowable values of 0, and 1901 to 2155. Added new DATE type that is stored in 3 bytes rather than 4 bytes. All new tables are created with the new date type if you dont use the --old-protocol option to mysqld.

1056

MySQL Technical Reference for Version 5.0.0-alpha

Fixed bug in record caches; for some queries, you could get Error from table handler: # on some operating systems. Added --enable-assembler option to configure, for x86 machines (tested on Linux + gcc). This will enable assembler functions for the most important string functions for more speed!

D.6 Alteraes na distribuio 3.21.x co ca

Version 3.21 is quite old now, and should be avoided if possible. This information is kept here for historical purposes only.

D.6.1 Alteraoes na distribuio 3.21.33 c ca

Fixed problem when sending SIGHUP to mysqld; mysqld core dumped when starting from boot on some systems. Fixed problem with losing a little memory for some connections. DELETE FROM tbl_name without a WHERE condition is now done the long way when you use LOCK TABLES or if the table is in use, to avoid race conditions. INSERT INTO TABLE (timestamp_column) VALUES (NULL); didnt set timestamp.

D.6.2 Alteraes na distribuio 3.21.32 co ca

Fixed some possible race conditions when doing many reopen/close on the same tables under heavy load! This can happen if you execute mysqladmin refresh often. This could in some very rare cases corrupt the header of the index le and cause error 126 or 138. Fixed fatal bug in refresh() when running with the --skip-external-locking option. There was a very small time gap after a mysqladmin refresh when a table could be corrupted if one thread updated a table while another thread did mysqladmin refresh and another thread started a new update ont the same table before the rst thread had nished. A refresh (or --flush-tables) will now not return until all used tables are closed! SELECT DISTINCT with a WHERE clause that didnt match any rows returned a row in some contexts (bug only in 3.21.31). GROUP BY + ORDER BY returned one empty row when no rows where found. Fixed a bug in the range optimiser that wrote Use_count: Wrong count for ... in the error log le.

D.6.3 Alteraes na distribuio 3.21.31 co ca

Fixed a sign extension problem for the TINYINT type on Irix. Fixed problem with LEFT("constant_string",function). Fixed problem with FIND_IN_SET().

Apndice D: Histrico de Alteraes do MySQL e o co

1057

LEFT JOIN core dumped if the second table is used with a constant WHERE/ON expression that uniquely identies one record. Fixed problems with DATE_FORMAT() and incorrect dates. DATE_FORMAT() now ignores % to make it possible to extend it more easily in the future.

D.6.4 Alteraes na distribuio 3.21.30 co ca

mysql now returns an exit code > 0 if the query returned an error. Saving of command-line history to le in mysql client. tommy@mix.hive.no. Fixed problem with empty lines that were ignored in mysql.cc. Save the pid of the signal handler thread in the pid le instead of the pid of the main thread. Added patch by tommy@valley.ne.jp to support Japanese characters SJIS and UJIS. Changed safe_mysqld to redirect startup messages to hostname.err instead of hostname.log to reclaim le space on mysqladmin refresh. ENUM always had the rst entry as default value. ALTER TABLE wrote two entries to the update log. sql_acc() now closes the mysql grant tables after a reload to save table space and memory. Changed LOAD DATA to use less memory with tables and BLOB columns. Sorting on a function which made a division / 0 produced a wrong set in some cases. Fixed SELECT problem with LEFT() when using the czech character set. Fixed problem in isamchk; it couldnt repair a packed table in a very unusual case. SELECT statements with & or | (bit functions) failed on columns with NULL values. When comparing a eld = eld, where one of the elds was a part key, only the length of the part key was compared. By Tommy Larsen

D.6.5 Alteraes na distribuio 3.21.29 co ca

LOCK TABLES + DELETE from tbl_name never removed locks properly. Fixed problem when grouping on an OR function. Fixed permission problem with umask() and creating new databases. Fixed permission problem on result le with SELECT ... INTO OUTFILE ... Fixed problem in range optimiser (core dump) for a very complex query. Fixed problem when using MIN(integer) or MAX(integer) in GROUP BY. Fixed bug on Alpha when using integer keys. (Other keys worked on Alpha.) Fixed bug in WEEK("XXXX-xx-01").

1058

MySQL Technical Reference for Version 5.0.0-alpha

D.6.6 Alteraes na distribuio 3.21.28 co ca

Fixed socket permission (clients couldnt connect to Unix socket on Linux). Fixed bug in record caches; for some queries, you could get Error from table handler: # on some operating systems.

D.6.7 Alteraes na distribuio 3.21.27 co ca

Added user level lock functions GET_LOCK(string,timeout), RELEASE_LOCK(string). Added Opened_tables to show status. Changed connect timeout to 3 seconds to make it somewhat harder for crackers to kill mysqld through telnet + TCP/IP. Fixed bug in range optimiser when using WHERE key_part_1 >= something AND key_ part_2 <= something_else. Changed configure for detection of FreeBSD 3.0 9803xx and above WHERE with string_col_key = constant_string didnt always nd all rows if the column had many values diering only with characters of the same sort value (like e and e with an accent). Strings keys looked up with ref were not compared in case-sensitive fashion. Added umask() to make log les non-readable for normal users. Ignore users with old (8-byte) password on startup if not using --old-protocol option to mysqld. SELECT which matched all key elds returned the values in the case of the matched values, not of the found values. (Minor problem.)

D.6.8 Alteraes na distribuio 3.21.26 co ca

FROM_DAYS(0) now returns "0000-00-00". In DATE_FORMAT(), PM and AM were swapped for hours 00 and 12. Extended the default maximum key size to 256. Fixed bug when using BLOB/TEXT in GROUP BY with many tables. An ENUM eld that is not declared NOT NULL has NULL as the default value. (Previously, the default value was the rst enumeration value.) Fixed bug in the join optimiser code when using many part keys on the same key: INDEX (Organisation,Surname(35),Initials(35)). Added some tests to the table order optimiser to get some cases with SELECT ... FROM many_tables much faster. Added a retry loop around accept() to possibly x some problems on some Linux machines.

D.6.9 Alteraes na distribuio 3.21.25 co ca

Changed typedef string to typedef my_string for better portability.

Apndice D: Histrico de Alteraes do MySQL e o co

1059

You can now kill threads that are waiting on a disk-full condition. Fixed some problems with UDF functions. Added long options to isamchk. Try isamchk --help. Fixed a bug when using 8 bytes long (alpha); filesort() didnt work. DISTINCT, ORDER BY and GROUP BY on 64-bit processors.

Aects

D.6.10 Alteraes na distribuio 3.21.24 co ca

Dynamic loadable functions. Based on source from Alexis Mikhailov. You couldnt delete from a table if no one had done a SELECT on the table. Fixed problem with range optimiser with many OR operators on key parts inside each other. Recoded MIN() and MAX() to work properly with strings and HAVING. Changed default umask value for new les from 0664 to 0660. Fixed problem with LEFT JOIN and constant expressions in the ON part. Added Italian error messages from brenno@dewinter.com. configure now works better on OSF/1 (tested on 4.0D). Added hooks to allow LIKE optimization with international character support. Upgraded DBI to 0.93.

D.6.11 Alteraes na distribuio 3.21.23 co ca

The following symbols are now reserved words: TIME, DATE, TIMESTAMP, TEXT, BIT, ENUM, NO, ACTION, CHECK, YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, STATUS, VARIABLES. Setting a TIMESTAMP to NULL in LOAD DATA INFILE ... didnt set the current time for the TIMESTAMP. Fix BETWEEN to recognise binary strings. Now BETWEEN is case-sensitive. Added --skip-thread-priority option to mysqld, for systems where mysqlds thread scheduling doesnt work properly (BSDI 3.1). Added ODBC functions DAYNAME() and MONTHNAME(). Added function TIME_FORMAT(). This works like DATE_FORMAT(), but takes a time string (HH:MM:SS) as argument. Fixed unlikely(?) key optimiser bug when using OR operators of key parts inside AND expressions. Added variables command to mysqladmin. A lot of small changes to the binary releases. Fixed a bug in the new protocol from MySQL Version 3.21.20. Changed ALTER TABLE to work with Windows (Windows cant rename open les). Also xed a couple of small bugs in the Windows version. All standard MySQL clients are now ported to MySQL for Windows. MySQL can now be started as a service on NT.

1060

MySQL Technical Reference for Version 5.0.0-alpha

D.6.12 Alteraes na distribuio 3.21.22 co ca

Starting with this version, all MySQL distributions will be congured, compiled and tested with crash-me and the benchmarks on the following platforms: SunOS 5.6 sun4u, SunOS 5.5.1 sun4u, SunOS 4.14 sun4c, SunOS 5.6 i86pc, Irix 6.3 mips5k, HPUX 10.20 hppa, AIX 4.2.1 ppc, OSF/1 V4.0 alpha, FreeBSD 2.2.2 i86pc and BSDI 3.1 i386. Fix COUNT(*) problems when the WHERE clause didnt match any records. (Bug from 3.21.17.) Removed that NULL = NULL is true. Now you must use IS NULL or IS NOT NULL to test whether a value is NULL. (This is according to SQL-99 but may break old applications that are ported from mSQL.) You can get the old behaviour by compiling with -DmSQL_ COMPLIANT. Fixed bug that core dumped when using many LEFT OUTER JOIN clauses. Fixed bug in ORDER BY on string formula with possible NULL values. Fixed problem in range optimiser when using <= on sub index. Added functions DAYOFYEAR(), DAYOFMONTH(), MONTH(), YEAR(), WEEK(), QUARTER(), HOUR(), MINUTE(), SECOND() and FIND_IN_SET(). Added SHOW VARIABLES command. Added support of long constant strings from SQL-99: mysql> SELECT first second; -> first second Upgraded Msql-Mysql-modules to 1.1825. Upgraded mysqlaccess to 2.02. Fixed problem with Russian character set and LIKE. Ported to OpenBSD 2.1. New Dutch error messages.

D.6.13 Alteraes na distribuio 3.21.21a co ca

Congure changes for some operating systems.

D.6.14 Alteraes na distribuio 3.21.21 co ca

Fixed optimiser bug when using WHERE data_field = date_field2 AND date_field2 = constant. Added SHOW STATUS command. Removed manual.ps from the source distribution to make it smaller.

D.6.15 Alteraes na distribuio 3.21.20 co ca

Changed the maximum table name and column name lengths from 32 to 64. Aliases can now be of any length. Fixed mysqladmin stat to return the right number of queries.

Apndice D: Histrico de Alteraes do MySQL e o co

1061

Changed protocol (downward compatible) to mark if a column has the AUTO_INCREMENT attribute or is a TIMESTAMP. This is needed for the new Java driver. Added Hebrew sorting order by Zeev Suraski. Solaris 2.6: Fixed configure bugs and increased maximum table size from 2G to 4G.

D.6.16 Alteraes na distribuio 3.21.19 co ca

Upgraded DBD to 1.1823. This version implements mysql_use_result in DBD-Mysql. Benchmarks updated for empress (by Luuk). Fixed a case of slow range searching. Congure xes (Docs directory). Added function REVERSE() (by Zeev Suraski).

D.6.17 Alteraes na distribuio 3.21.18 co ca

Issue error message if client C functions are called in wrong order. Added automatic reconnect to the libmysql.c library. If a write command fails, an automatic reconnect is done. Small sort sets no longer use temporary les. Upgraded DBI to 0.91. Fixed a couple of problems with LEFT OUTER JOIN. Added CROSS JOIN syntax. CROSS is now a reserved word. Recoded yacc/bison stack allocation to be even safer and to allow MySQL to handle even bigger expressions. Fixed a couple of problems with the update log. ORDER BY was slow when used with key ranges.

D.6.18 Alteraes na distribuio 3.21.17 co ca

Changed documentation string of --with-unix-socket-path to avoid confusion. Added ODBC and SQL-99 style LEFT OUTER JOIN. The following are new reserved words: LEFT, NATURAL, USING. The client library now uses the value of the environment variable MYSQL_HOST as the default host if its dened. SELECT col_name, SUM(expr) now returns NULL for col_name when there are matching rows. Fixed problem with comparing binary strings and BLOB values with ASCII characters over 127. Fixed lock problem: when freeing a read lock on a table with multiple read locks, a thread waiting for a write lock would have been given the lock. This shouldnt aect data integrity, but could possibly make mysqld restart if one thread was reading data that another thread modied.

1062

MySQL Technical Reference for Version 5.0.0-alpha

LIMIT offset,count didnt work in INSERT ... SELECT. Optimized key block caching. This will be quicker than the old algorithm when using bigger key caches.

D.6.19 Alteraes na distribuio 3.21.16 co ca

Added ODBC 2.0 & 3.0 functions POWER(), SPACE(), COT(), DEGREES(), RADIANS(), ROUND(2 arg) and TRUNCATE(). Warning: Incompatible change! LOCATE() parameters were swapped according to ODBC standard. Fixed. Added function TIME_TO_SEC(). In some cases, default values were not used for NOT NULL elds. Timestamp wasnt always updated properly in UPDATE SET ... statements. Allow empty strings as default values for BLOB and TEXT, to be compatible with mysqldump.

D.6.20 Alteraes na distribuio 3.21.15 co ca

Warning: Incompatible change! mysqlperl is now from Msql-Mysql-modules. This means that connect() now takes host, database, user, password arguments! The old version took host, database, password, user. Allow DATE 1997-01-01, TIME 12:10:10 and TIMESTAMP 1997-01-01 12:10:10 formats required by SQL-99. Warning: Incompatible change! This has the unfortunate side-eect that you no longer can have columns named DATE, TIME or TIMESTAMP. :( Old columns can still be accessed through tablename.columnname!) Changed Makeles to hopefully work better with BSD systems. Also, manual.dvi is now included in the distribution to avoid having stupid make programs trying to rebuild it. readline library upgraded to version 2.1. A new sortorder german-1. That is a normal ISO-Latin1 with a german sort order. Perl DBI/DBD is now included in the distribution. DBI is now the recommended way to connect to MySQL from Perl. New portable benchmark suite with DBD, with test results from mSQL 2.0.3, MySQL, PostgreSQL 6.2.1 and Solid server 2.2. crash-me is now included with the benchmarks; this is a Perl program designed to nd as many limits as possible in an SQL server. Tested with mSQL, PostgreSQL, Solid and MySQL. Fixed bug in range-optimiser that crashed MySQL on some queries. Table and column name completion for mysql command-line tool, by Zeev Suraski and Andi Gutmans. Added new command REPLACE that works like INSERT but replaces conicting records with the new record. REPLACE INTO TABLE ... SELECT ... works also. Added new commands CREATE DATABASE db_name and DROP DATABASE db_name.

Apndice D: Histrico de Alteraes do MySQL e o co

1063

Added RENAME option to ALTER TABLE: ALTER TABLE name RENAME TO new_name. make_binary_distribution now includes libgcc.a in libmysqlclient.a. This should make linking work for people who dont have gcc. Changed net_write() to my_net_write() because of a name conict with Sybase. New function DAYOFWEEK() compatible with ODBC. Stack checking and bison memory overrun checking to make MySQL safer with weird queries.

D.6.21 Alteraes na distribuio 3.21.14b co ca

Fixed a couple of small configure problems on some platforms.

D.6.22 Alteraes na distribuio 3.21.14a co ca

Ported to SCO Openserver 5.0.4 with FSU Pthreads. HP-UX 10.20 should work. Added new function DATE_FORMAT(). Added NOT IN. Added automatic removal of ODBC function conversions: {fn now() } Handle ODBC 2.50.3 option ags. Fixed comparison of DATE and TIME values with NULL. Changed language name from germany to german to be consistent with the other language names. Fixed sorting problem on functions returning a FLOAT. Previously, the values were converted to INT values before sorting. Fixed slow sorting when sorting on key eld when using key_column=constant. Sorting on calculated DOUBLE values sorted on integer results instead. mysql no longer requires a database argument. Changed the place where HAVING should be. According to the SQL standards, it should be after GROUP BY but before ORDER BY. MySQL Version 3.20 incorrectly had it last. Added Sybase command USE database to start using another database. Added automatic adjusting of number of connections and table cache size if the maximum number of les that can be opened is less than needed. This should x that mysqld doesnt crash even if you havent done a ulimit -n 256 before starting mysqld. Added lots of limit checks to make it safer when running with too little memory or when doing weird queries.

D.6.23 Alteraes na distribuio 3.21.13 co ca

Added retry of interrupted reads and clearing of errno. This makes Linux systems much safer! Fixed locking bug when using many aliases on the same table in the same SELECT.

1064

MySQL Technical Reference for Version 5.0.0-alpha

Fixed bug with LIKE on number key. New error message so you can check whether the connection was lost while the command was running or whether the connection was down from the start. Added --table option to mysql to print in table format. Moved time and row information after query result. Added automatic reconnect of lost connections. Added != as a synonym for <>. Added function VERSION() to make easier logs. New multi-user test tests/fork_test.pl to put some strain on the thread library.

D.6.24 Alteraes na distribuio 3.21.12 co ca

Fixed ftruncate() call in MIT-pthreads. This made isamchk destroy the .ISM les on (Free)BSD 2.x systems. Fixed broken __P_ patch in MIT-pthreads. Many memory overrun checks. All string functions now return NULL if the returned string should be longer than max_allowed_packet bytes. Changed the name of the INTERVAL type to ENUM, because INTERVAL is used in SQL-99. In some cases, doing a JOIN + GROUP + INTO OUTFILE, the result wasnt grouped. LIKE with _ as last character didnt work. Fixed. Added extended SQL-99 TRIM() function. Added CURTIME(). Added ENCRYPT() function by Zeev Suraski. Fixed better FOREIGN KEY syntax skipping. New reserved words: MATCH, FULL, PARTIAL. mysqld now allows IP number and hostname for the --bind-address option. Added SET CHARACTER SET cp1251_koi8 to enable conversions of data to and from the cp1251_koi8 character set. Lots of changes for Windows 95 port. In theory, this version should now be easily portable to Windows 95. Changed the CREATE COLUMN syntax of NOT NULL columns to be after the DEFAULT value, as specied in the SQL-99 standard. This will make mysqldump with NOT NULL and default values incompatible with MySQL Version 3.20. Added many function name aliases so the functions can be used with ODBC or SQL-92 syntax. Fixed syntax of ALTER TABLE tbl_name ALTER COLUMN col_name SET DEFAULT NULL. Added CHAR and BIT as synonyms for CHAR(1). Fixed core dump when updating as a user who has only SELECT privilege. INSERT ... SELECT ... GROUP BY didnt work in some cases. An Invalid use of group function error occurred. When using LIMIT, SELECT now always uses keys instead of record scan. This will give better performance on SELECT and a WHERE that matches many rows. Added Russian error messages.

Apndice D: Histrico de Alteraes do MySQL e o co

1065

D.6.25 Alteraes na distribuio 3.21.11 co ca

Congure changes. MySQL now works with the new thread library on BSD/OS 3.0. Added new group functions BIT_OR() and BIT_AND(). Added compatibility functions CHECK and REFERENCES. CHECK is now a reserved word. Added ALL option to GRANT for better compatibility. (GRANT is still a dummy function.) Added partly-translated Dutch error messages. Fixed bug in ORDER BY and GROUP BY with NULL columns. Added function LAST_INSERT_ID() SQL function to retrieve last AUTO_INCREMENT value. This is intended for clients to ODBC that cant use the mysql_insert_id() API function, but can be used by any client. Added --flush-logs option to mysqladmin. Added command STATUS to mysql. Fixed problem with ORDER BY/GROUP BY because of bug in gcc. Fixed problem with INSERT ... SELECT ... GROUP BY.

D.6.26 Alteraes na distribuio 3.21.10 co ca

New program mysqlaccess. CREATE now supports all ODBC types and the mSQL TEXT type. All ODBC 2.5 functions are also supported (added REPEAT). This provides better portability. Added text types TINYTEXT, TEXT, MEDIUMTEXT and LONGTEXT. These are actually BLOBtypes, but all searching is done in case-insensitive fashion. All old BLOB elds are now TEXT elds. This only changes that all searching on strings is done in case-sensitive fashion. You must do an ALTER TABLE and change the datatype to BLOB if you want to have tests done in case-sensitive fashion. Fixed some configure issues. Made the locking code a bit safer. Fixed very unlikely deadlock situation. Fixed a couple of bugs in the range optimiser. Now the new range benchmark testselect works.

D.6.27 Alteraes na distribuio 3.21.9 co ca

Added --enable-unix-socket=pathname option to configure. Fixed a couple of portability problems with include les. Fixed bug in range calculation that could return empty set when searching on multiple key with only one entry (very rare). Most things ported to FSU Pthreads, which should allow MySQL to run on SCO. Veja Seo 2.6.6.9 [SCO], Pgina 161. ca a

1066

MySQL Technical Reference for Version 5.0.0-alpha

D.6.28 Alteraes na distribuio 3.21.8 co ca

Works now in Solaris 2.6. Added handling of calculation of SUM() functions. For example, you can now use SUM(column)/COUNT(column). Added handling of trigometric functions: PI(), ACOS(), ASIN(), ATAN(), COS(), SIN() and TAN(). New languages: Norwegian, Norwegian-ny and Portuguese. Fixed parameter bug in net_print() in procedure.cc. Fixed a couple of memory leaks. Now allow also the old SELECT ... INTO OUTFILE syntax. Fixed bug with GROUP BY and SELECT on key with many values. mysql_fetch_lengths() sometimes returned incorrect lengths when you used mysql_ use_result(). This aected at least some cases of mysqldump --quick. Fixed bug in optimization of WHERE const op field. Fixed problem when sorting on NULL elds. Fixed a couple of 64-bit (Alpha) problems. Added --pid-file=# option to mysqld. Added date formatting to FROM_UNIXTIME(), originally by Zeev Suraski. Fixed bug in BETWEEN in range optimiser (did only test = of the rst argument). Added machine-dependent les for MIT-pthreads i386-SCO. There is probably more to do to get this to work on SCO 3.5.

D.6.29 Alteraes na distribuio 3.21.7 co ca

Changed Makefile.am to take advantage of Automake 1.2. Added the beginnings of a benchmark suite. Added more secure password handling. Added new client function mysql_errno(), to get the error number of the error message. This makes error checking in the client much easier. This makes the new server incompatible with the 3.20.x server when running without --old-protocol. The client code is backward-compatible. More information can be found in the README le! Fixed some problems when using very long, illegal names.

D.6.30 Alteraes na distribuio 3.21.6 co ca

Fixed more portability issues (incorrect sigwait and sigset denes). configure should now be able to detect the last argument to accept().

D.6.31 Alteraes na distribuio 3.21.5 co ca

Should now work with FreeBSD 3.0 if used with FreeBSD-3.0-libc_r-1.0.diff, which can be found at http://www.mysql.com/downloads/os-freebsd.html.

Apndice D: Histrico de Alteraes do MySQL e o co

1067

Added new -O tmp_table_size=# option to mysqld. New function FROM_UNIXTIME(timestamp) which returns a date string in YYYY-MM-DD HH:MM:SS format. New function SEC_TO_TIME(seconds) which returns a string in HH:MM:SS format. New function SUBSTRING_INDEX(), originally by Zeev Suraski.

D.6.32 Alteraes na distribuio 3.21.4 co ca

Should now congure and compile on OSF/1 4.0 with the DEC compiler. Conguration and compilation on BSD/OS 3.0 works, but due to some bugs in BSD/OS 3.0, mysqld doesnt work on it yet. Conguration and compilation on FreeBSD 3.0 works, but I couldnt get pthread_ create to work.

D.6.33 Alteraes na distribuio 3.21.3 co ca

Added reverse check lookup of hostnames to get better security. Fixed some possible buer overows if lenames that are too long are used. mysqld doesnt accept hostnames that start with digits followed by a ., because the hostname may look like an IP number. Added --skip-networking option to mysqld, to allow only socket connections. (This will not work with MIT-pthreads!) Added check of too long table names for alias. Added check if database name is okay. Added check if too long table names. Removed incorrect free() that killed the server on CREATE DATABASE or DROP DATABASE. Changed some mysqld -O options to better names. Added -O join_cache_size=# option to mysqld. Added -O max_join_size=# option to mysqld, to be able to set a limit how big queries (in this case big = slow) one should be able to handle without specifying SET SQL_BIG_ SELECTS=1. A # = is about 10 examined records. The default is unlimited. When comparing a TIME, DATE, DATETIME or TIMESTAMP column to a constant, the constant is converted to a time value before performing the comparison. This will make it easier to get ODBC (particularly Access97) to work with the above types. It should also make dates easier to use and the comparisons should be quicker than before. Applied patch from Jochen Wiedmann that allows query() in mysqlperl to take a query with \0 in it. Storing a timestamp with a 2-digit year (YYMMDD) didnt work. Fix that timestamp wasnt automatically updated if set in an UPDATE clause. Now the automatic timestamp eld is the FIRST timestamp eld. SELECT * INTO OUTFILE, which didnt correctly if the outle already existed.

1068

MySQL Technical Reference for Version 5.0.0-alpha

mysql now shows the thread ID when starting or doing a reconnect. Changed the default sort buer size from 2M to 1M.

D.6.34 Alteraes na distribuio 3.21.2 co ca

The range optimiser is coded, but only 85% tested. It can be enabled with --new, but it crashes core a lot yet... More portable. Should compile on AIX and alpha-digital. At least the isam library should be relatively 64-bit clean. New isamchk which can detect and x more problems. New options for isamlog. Using new version of Automake. Many small portability changes (from the AIX and alpha-digital port) Better checking of pthread(s) library. czech error messages by snajdr@pvt.net. Decreased size of some buers to get fewer problems on systems with little memory. Also added more checks to handle out of memory problems. mysqladmin: you can now do mysqladmin kill 5,6,7,8 to kill multiple threads. When the maximum connection limit is reached, one extra connection by a user with the process acl privilege is granted. Added -O backlog=# option to mysqld. Increased maximum packet size from 512K to 1024K for client. Almost all of the function code is now tested in the internal test suite. ALTER TABLE now returns warnings from eld conversions. Port changed to 3306 (got it reserved from ISI). Added a x for Visual FoxBase so that any schema name from a table specication is automatically removed. New function ASCII(). Removed function BETWEEN(a,b,c). Use the standard SQL syntax instead: expr BETWEEN expr AND expr. MySQL no longer has to use an extra temporary table when sorting on functions or SUM() functions. Fixed bug that you couldnt use tbl_name.field_name in UPDATE. Fixed SELECT DISTINCT when using hidden group. For example: mysql> SELECT DISTINCT MOD(some_field,10) FROM test -> GROUP BY some_field; Note: some_field is normally in the SELECT part. Standard SQL should require it.

D.6.35 Alteraes na distribuio 3.21.0 co ca

New reserved words used: INTERVAL, EXPLAIN, READ, WRITE, BINARY. Added ODBC function CHAR(num,...).

Apndice D: Histrico de Alteraes do MySQL e o co

1069

New operator IN. This uses a binary search to nd a match. New command LOCK TABLES tbl_name [AS alias] {READ|WRITE} ... Added --log-update option to mysqld, to get a log suitable for incremental updates. New command EXPLAIN SELECT ... to get information about how the optimiser will do the join. For easier client code, the client should no longer use FIELD_TYPE_TINY_BLOB, FIELD_ TYPE_MEDIUM_BLOB, FIELD_TYPE_LONG_BLOB or FIELD_TYPE_VAR_STRING (as previously returned by mysql_list_fields). You should instead only use FIELD_TYPE_ BLOB or FIELD_TYPE_STRING. If you want exact types, you should use the command SHOW FIELDS. Added varbinary syntax: 0x###### which can be used as a string (default) or a number. FIELD_TYPE_CHAR is renamed to FIELD_TYPE_TINY. Changed all elds to C++ classes. Removed FORM struct. Fields with DEFAULT values no longer need to be NOT NULL. New eld types: ENUM A string which can take only a couple of dened values. The value is stored as a 1-3 byte number that is mapped automatically to a string. This is sorted according to string positions!

A string which may have one or many string values separated with ,. The string is stored as a 1-, 2-, 3-, 4- or 8-byte number where each bit stands for a specic set member. This is sorted according to the unsigned value of the stored packed number. Now all function calculation is done with double or long long. This will provide the full 64-bit range with bit functions and x some conversions that previously could result in precision losses. One should avoid using unsigned long long columns with full 64-bit range (numbers bigger than 9223372036854775807) because calculations are done with signed long long. ORDER BY will now put NULL eld values rst. GROUP BY will also work with NULL values. Full WHERE with expressions. New range optimiser that can resolve ranges when some keypart prex is constant. Example: mysql> SELECT * FROM tbl_name -> WHERE key_part_1="customer" -> AND key_part_2>=10 AND key_part_2<=10;

SET

D.7 Alteraes na distribuio 3.20.x co ca

Version 3.20 is quite old now, and should be avoided if possible. This information is kept here for historical purposes only. Changes from 3.20.18 to 3.20.32b are not documented here because the 3.21 release branched here. And the relevant changes are also documented as changes to the 3.21 version.

1070

MySQL Technical Reference for Version 5.0.0-alpha

D.7.1 Alteraes na distribuio 3.20.18 co ca

Added -p# (remove # directories from path) to isamlog. All les are written with a relative path from the database directory Now mysqld shouldnt crash on shutdown when using the --log-isam option. New mysqlperl version. It is now compatible with msqlperl-0.63. New DBD module available. Added group function STD() (standard deviation). The mysqld server is now compiled by default without debugging information. This will make the daemon smaller and faster. Now one usually only has to specify the --basedir option to mysqld. All other paths are relative in a normal installation. BLOB columns sometimes contained garbage when used with a SELECT on more than one table and ORDER BY. Fixed that calculations that are not in GROUP BY work as expected (SQL-99 extension). Example: mysql> SELECT id,id+1 FROM table GROUP BY id; The test of using MYSQL_PWD was reversed. Now MYSQL_PWD is enabled as default in the default release. Fixed conversion bug which caused mysqld to core dump with Arithmetic error on SPARC-386. Added --unbuffered option to mysql, for new mysqlaccess. When using overlapping (unnecessary) keys and join over many tables, the optimiser could get confused and return 0 records.

D.7.2 Alteraes na distribuio 3.20.17 co ca

You can now use BLOB columns and the functions IS NULL and IS NOT NULL in the WHERE clause. All communication packets and row buers are now allocated dynamically on demand. The default value of max_allowed_packet is now 64K for the server and 512K for the client. This is mainly used to catch incorrect packets that could trash all memory. The server limit may be changed when it is started. Changed stack usage to use less memory. Changed safe_mysqld to check for running daemon. The ELT() function is renamed to FIELD(). The new ELT() function returns a value based on an index: FIELD() is the inverse of ELT() Example: ELT(2,"A","B","C") returns "B". FIELD("B","A","B","C") returns 2. COUNT(field), where field could have a NULL value, now works. A couple of bugs xed in SELECT ... GROUP BY. Fixed memory overrun bug in WHERE with many unoptimisable brace levels. Fixed some small bugs in the grant code.

Apndice D: Histrico de Alteraes do MySQL e o co

1071

If hostname isnt found by get_hostname, only the IP is checked. Previously, you got Access denied. Inserts of timestamps with values didnt always work. INSERT INTO ... SELECT ... WHERE could give the error Duplicated field. Added some tests to safe_mysqld to make it safer. LIKE was case-sensitive in some places and case-insensitive in others. Now LIKE is always case-insensitive. mysql.cc: Allow # anywhere on the line. New command SET SQL_SELECT_LIMIT=#. See the FAQ for more details. New version of the mysqlaccess script. Change FROM_DAYS() and WEEKDAY() to also take a full TIMESTAMP or DATETIME as argument. Before they only took a number of type YYYYMMDD or YYMMDD. Added new function UNIX_TIMESTAMP(timestamp_column).

D.7.3 Alteraes na distribuio 3.20.16 co ca

More changes in MIT-pthreads to get them safer. Fixed also some link bugs at least in SunOS. Changed mysqld to work around a bug in MIT-pthreads. This makes multiple small SELECT operations 20 times faster. Now lock_test.pl should work. Added mysql_FetchHash(handle) to mysqlperl. The mysqlbug script is now distributed built to allow for reporting bugs that appear during the build with it. Changed libmysql.c to prefer getpwuid() instead of cuserid(). Fixed bug in SELECT optimiser when using many tables with the same column used as key to dierent tables. Added new latin2 and Russian KOI8 character tables. Added support for a dummy GRANT command to satisfy Powerbuilder.

D.7.4 Alteraes na distribuio 3.20.15 co ca

Fixed fatal bug packets out of order when using MIT-pthreads. Removed possible loop when a thread waits for command from client and fcntl() fails. Thanks to Mike Bretz for nding this bug. Changed alarm loop in mysqld.cc because shutdown didnt always succeed in Linux. Removed use of termbits from mysql.cc. This conicted with glibc 2.0. Fixed some syntax errors for at least BSD and Linux. Fixed bug when doing a SELECT as superuser without a database. Fixed bug when doing SELECT with group calculation to outle.

1072

MySQL Technical Reference for Version 5.0.0-alpha

D.7.5 Alteraes na distribuio 3.20.14 co ca

If one gives -p or --password option to mysql without an argument, the user is solicited for the password from the tty. Added default password from MYSQL_PWD (by Elmar Haneke). Added command kill to mysqladmin to kill a specic MySQL thread. Sometimes when doing a reconnect on a down connection this succeeded rst on second try. Fixed adding an AUTO_INCREMENT key with ALTER_TABLE. AVG() gave too small value on some SELECT statements with GROUP BY and ORDER BY. Added new DATETIME type (by Giovanni Maruzzelli maruzz@matrice.it). Fixed that dening DONT_USE_DEFAULT_FIELDS works. Changed to use a thread to handle alarms instead of signals on Solaris to avoid race conditions. Fixed default length of signed numbers. (George Harvey georgeh@pinacl.co.uk.) Allow anything for CREATE INDEX. Add prezeros when packing numbers to DATE, TIME and TIMESTAMP. Fixed a bug in OR of multiple tables (gave empty set). Added many patches to MIT-pthreads. This xes at least one lookup bug.

D.7.6 Alteraes na distribuio 3.20.13 co ca

Added standard SQL-92 DATE and TIME types. Fixed bug in SELECT with AND-OR levels. Added support for Slovenian characters. The Contrib directory contains source and instructions for adding other character sets. Fixed bug with LIMIT and ORDER BY. Allow ORDER BY and GROUP BY on items that arent in the SELECT list. (Thanks to Wim Bonis bonis@kiss.de, for pointing this out.) Allow setting of timestamp values in INSERT. Fixed bug with SELECT ... WHERE ... = NULL. Added changes for glibc 2.0. To get glibc to work, you should add the gibc-2.0-sigwait-patch before compiling glibc. Fixed bug in ALTER TABLE when changing a NOT NULL eld to allow NULL values. Added some SQL-92 synonyms as eld types to CREATE TABLE. CREATE TABLE now allows FLOAT(4) and FLOAT(8) to mean FLOAT and DOUBLE. New utility program mysqlaccess by Yves.Carlier@rug.ac.be. This program shows the access rights for a specic user and the grant rows that determine this grant. Added WHERE const op field (by bonis@kiss.de).

Apndice D: Histrico de Alteraes do MySQL e o co

1073

D.7.7 Alteraes na distribuio 3.20.11 co ca

When using SELECT ... INTO OUTFILE, all temporary tables are ISAM instead of HEAP to allow big dumps. Changed date functions to be string functions. This xed some funny side eects when sorting on dates. Extended ALTER TABLE for SQL-92 compliance. Some minor compatibility changes. Added --port and --socket options to all utility programs and mysqld. Fixed MIT-pthreads readdir_r(). Now mysqladmin create database and mysqladmin drop database should work. Changed MIT-pthreads to use our tempnam(). This should x the sort aborted bug. Added sync of records count in sql_update. This xed slow updates on rst connection. (Thanks to Vaclav Bittner for the test.)

D.7.8 Alteraes na distribuio 3.20.10 co ca

New insert type: INSERT INTO ... SELECT ... MEDIUMBLOB xed. Fixed bug in ALTER TABLE and BLOB values. SELECT ... INTO OUTFILE now creates the le in the current database directory. DROP TABLE now can take a list of tables. Oracle synonym DESCRIBE (DESC). Changes to make_binary_distribution. Added some comments to installation instructions about configures C++ link test. Added --without-perl option to configure. Lots of small portability changes.

D.7.9 Alteraes na distribuio 3.20.9 co ca

ALTER TABLE didnt copy null bit. As a result, elds that were allowed to have NULL values were always NULL. CREATE didnt take numbers as DEFAULT. Some compatibility changes for SunOS. Removed config.cache from old distribution.

D.7.10 Alteraes na distribuio 3.20.8 co ca

Fixed bug with ALTER TABLE and multi-part keys.

1074

MySQL Technical Reference for Version 5.0.0-alpha

D.7.11 Alteraes na distribuio 3.20.7 co ca

New commands: ALTER TABLE, SELECT ... INTO OUTFILE and LOAD DATA INFILE. New function: NOW(). Added new eld File_priv to mysql/user table. New script add_file_priv which adds the new eld File_priv to the user table. This script must be executed if you want to use the new SELECT ... INTO and LOAD DATA INFILE ... commands with a version of MySQL earlier than 3.20.7. Fixed bug in locking code, which made lock_test.pl test fail. New les NEW and BUGS. Changed select_test.c and insert_test.c to include config.h. Added status command to mysqladmin for short logging. Increased maximum number of keys to 16 and maximum number of key parts to 15. Use of sub keys. A key may now be a prex of a string eld. Added -k option to mysqlshow, to get key information for a table. Added long options to mysqldump.

D.7.12 Alteraes na distribuio 3.20.6 co ca

Portable to more systems because of MIT-pthreads, which will be used automatically if configure cannot nd a -lpthreads library. Added GNU-style long options to almost all programs. Test with program --help. Some shared library support for Linux. The FAQ is now in .texi format and is available in .html, .txt and .ps formats. Added new SQL function RAND([init]). Changed sql_lex to handle \0 unquoted, but the client cant send the query through the C API, because it takes a str pointer. You must use mysql_real_query() to send the query. Added API function mysql_get_client_info(). mysqld now uses the N_MAX_KEY_LENGTH from nisam.h as the maximum allowable key length. The following now works: mysql> SELECT filter_nr,filter_nr FROM filter ORDER BY filter_nr; Previously, this resulted in the error: ambiguous. Column: filter_nr in order clause is

mysql now outputs \0, \t, \n and \\ when encountering ASCII 0, tab, newline or \ while writing tab-separated output. This is to allow printing of binary data in a portable format. To get the old behaviour, use -r (or --raw). Added german error messages (60 of 80 error messages translated). Added new API function mysql_fetch_lengths(MYSQL_RES *), which returns an array of column lengths (of type uint).

Apndice D: Histrico de Alteraes do MySQL e o co

1075

Fixed bug with IS NULL in WHERE clause. Changed the optimiser a little to get better results when searching on a key part. Added SELECT option STRAIGHT_JOIN to tell the optimiser that it should join tables in the given order. Added support for comments starting with -- in mysql.cc (Postgres syntax). You can have SELECT expressions and table columns in a SELECT which are not used in the group part. This makes it ecient to implement lookups. The column that is used should be a constant for each group because the value is calculated only once for the rst row that is found for a group. mysql> SELECT id,lookup.text,SUM(*) FROM test,lookup -> WHERE test.id=lookup.id GROUP BY id; Fixed bug in SUM(function) (could cause a core dump). Changed AUTO_INCREMENT placement in the SQL query: INSERT INTO table (auto_field) VALUES (0); inserted 0, but it should insert an AUTO_INCREMENT value. mysqlshow.c: Added number of records in table. Had to change the client code a little to x this. mysql now allows doubled or "" within strings for embedded or ". New math functions: EXP(), LOG(), SQRT(), ROUND(), CEILING().

D.7.13 Alteraes na distribuio 3.20.3 co ca

The configure source now compiles a thread-free client library -lmysqlclient. This is the only library that needs to be linked with client applications. When using the binary releases, you must link with -lmysql -lmysys -ldbug -lmystrings as before. New readline library from bash-2.0. LOTS of small changes to configure and makeles (and related source). It should now be possible to compile in another directory using VPATH. Tested with GNU Make 3.75. safe_mysqld and mysql.server changed to be more compatible between the source and the binary releases. LIMIT now takes one or two numeric arguments. If one argument is given, it indicates the maximum number of rows in a result. If two arguments are given, the rst argument indicates the oset of the rst row to return, the second is the maximum number of rows. With this its easy to do a poor mans next page/previous page WWW application. Changed name of SQL function FIELDS() to ELT(). Changed SQL function INTERVALL() to INTERVAL(). Made SHOW COLUMNS a synonym for SHOW FIELDS. Added compatibility syntax FRIEND KEY to CREATE TABLE. In MySQL, this creates a non-unique key on the given columns. Added CREATE INDEX and DROP INDEX as compatibility functions. In MySQL, CREATE INDEX only checks if the index exists and issues an error if it doesnt exist. DROP INDEX always succeeds.

1076

MySQL Technical Reference for Version 5.0.0-alpha

mysqladmin.c: added client version to version information. Fixed core dump bug in sql_acl (core on new connection). Removed host, user and db tables from database test in the distribution. FIELD_TYPE_CHAR can now be signed (-128 to 127) or unsigned (0 to 255) Previously, it was always unsigned. Bug xes in CONCAT() and WEEKDAY(). Changed a lot of source to get mysqld to be compiled with SunPro compiler. SQL functions must now have a ( immediately after the function name (no intervening space). For example, USER( is regarded as beginning a function call, and USER ( is regarded as an identier USER followed by a (, not as a function call.

D.7.14 Alteraes na distribuio 3.20.0 co ca

The source distribution is done with configure and Automake. It will make porting much easier. The readline library is included in the distribution. Separate client compilation: the client code should be very easy to compile on systems which dont have threads. The old Perl interface code is automatically compiled and installed. Automatic compiling of DBD will follow when the new DBD code is ported. Dynamic language support: mysqld can now be started with Swedish or English (default) error messages. New functions: INSERT(), RTRIM(), LTRIM() and FORMAT(). mysqldump now works correctly for all eld types (even AUTO_INCREMENT). The format for SHOW FIELDS FROM tbl_name is changed so the Type column contains information suitable for CREATE TABLE. In previous releases, some CREATE TABLE information had to be patched when re-creating tables. Some parser bugs from 3.19.5 (BLOB and TIMESTAMP) are corrected. TIMESTAMP now returns dierent date information depending on its create length. Changed parser to allow a database, table or eld name to start with a number or _. All old C code from Unireg changed to C++ and cleaned up. This makes the daemon a little smaller and easier to understand. A lot of small bug xes done. New INSTALL les (not nal version) and some information regarding porting.

D.8 Alteraes na distribuio 3.19.x co ca

Version 3.19 is quite old now, and should be avoided if possible. This information is kept here for historical purposes only.

D.8.1 Alteraoes na distribuio 3.19.5 c ca

Some new functions, some more optimization on joins. Should now compile clean on Linux (2.0.x).

Apndice D: Histrico de Alteraes do MySQL e o co

1077

Added functions DATABASE(), USER(), POW(), LOG10() (needed for ODBC). In a WHERE with an ORDER BY on elds from only one table, the table is now preferred as rst table in a multi-join. HAVING and IS NULL or IS NOT NULL now works. A group on one column and a sort on a group function (SUM(), AVG()...) didnt work together. Fixed. mysqldump: Didnt send password to server.

D.8.2 Alteraes na distribuio 3.19.4 co ca

Fixed horrible locking bug when inserting in one thread and reading in another thread. Fixed one-o decimal bug. 1.00 was output as 1.0. Added attribute Locked to process list as information if a query is locked by another query. Fixed full magic timestamp. Timestamp length may now be 14, 12, 10, 8, 6, 4 or 2 bytes. Sort on some numeric functions could sort incorrectly on last number. IF(arg,syntax_error,syntax_error) crashed. Added functions CEILING(), ROUND(), EXP(), LOG() and SQRT(). Enhanced BETWEEN to handle strings.

D.8.3 Alteraes na distribuio 3.19.3 co ca

Fixed SELECT with grouping on BLOB columns not to return incorrect BLOB info. Grouping, sorting and distinct on BLOB columns will not yet work as expected (probably it will group/sort by the rst 7 characters in the BLOB). Grouping on formulas with a xed string size (use MID() on a BLOB) should work. Ao se fazer um full join (sem chave diretas) em tabelas mltiplas com campos BLOB, o u BLOB vinha como lixo na sa ida. Corrigido DISTINCT com colunas calculadas.

1078

MySQL Technical Reference for Version 5.0.0-alpha

Apndice E Portando para Outros Sistemas e

Este apndice lhe ajudar a portar o MySQL para outros sistemas operacionais. Primeiro e a verique a lista de sistemas operacionais atualemente suportados. Veja Seo 2.2.3 [Qual ca SO], Pgina 78. Se voc criou uma nova portabilidade do MySQL, por favor, deixe nos a e conhec-la para que possamos lista-la aqui e em nosso site web. (http://www.mysql.com/), e recomendando-a a outros usurios. a Nota: se voce criou uma nova portabilidade para o MySQL, voc est livre para distribu e a i-la sob a licena GPL, mas isto no te d os direitos autorais do MySQL. c a a Uma biblioteca thread Posix funcionando necessria para o servidor. No Solaris 2.5 ns use a o amos Pthreads da Sun (o suporte da thread nativa na verso 2.4 e anterior no est boa o sua a a ciente), no Linux usamos LinuxThreads criada por Xavier Leroy, Xavier.Leroy@inria.fr. A parte dif de portar para uma nova variante Unix sem um bom suporte a thread nativa icil , provavelmente, portar par MIT-pthreads. Veja mit-pthreads/README e Programando e em Thhredas POSIX (http://www.humanfactor.com/pthreads/). At o MySQL 4.0.2, a distribuio do MySQL incluiu uma verso remendada e ca a do Pthreads de Chris Provenzano do MIT (veja o site de MIT Pthreads em http://www.mit.edu/afs/sipb/project/pthreads/ e uma introduo a programao ca ca em http://www.mit.edu:8001/people/proven/IAP_2000/). Eles podem ser usadas por alguns sistemas operacionais que no tm threads POSIX. Veja Seo 2.3.6 [MIT-pthreads], a e ca Pgina 106. a Tambm poss usar outro pacote de threads no n do usurio chamado FSU Pthreads e e ivel ivel a (veja http://moss.csc.ncsu.edu/~mueller/pthreads/). Esta implementao est usada ca a para portar para o SCO. Veja os programas thr_lock.c e thr_alarm.c no diretrio mysys para alguns o testes/exemplos destes problemas. Tanto o servidor quanto o cliente precisam de um compilador C++ funcionanado. Ns o usamos gcc em muitas plataormas. Outros compiladores que sabemos que funciona so a o SPARCworksm Sun Forte, Irix cc, HP-UX aCC, IBM AIX xlC_r), Intel ecc e Compaq cxx). Para compilar apenas o cliente use ./configure --without-server. Atualmente no h nenhum suporte para compilao s do servidor, nem est em pauta a a e ca o a sua adio a menos que algum tenha uma boa razo para isto. ca e a Se voc quiser/precisar de alterar qualquer Makefile ou o script do congure voc tambm e e e precisar do GNU Automake e Autoconf. Veja Seo 2.3.4 [Instalando a rvore de fontes], a ca a Pgina 100. a Todos os passos necessrios para refazer tudo desde os arquivos mais bsicos. a a /bin/rm */.deps/*.P /bin/rm -f config.cache aclocal autoheader aclocal automake autoconf

Apndice E: Portando para Outros Sistemas e

1079

./configure --with-debug=full --prefix=your installation directory # O makefile gerado acima precsa do GNU make 3.75 ou mais novo. # (chamado gmake abaixo) gmake clean all install init-db Se voc encontrar problemas com uma nova portabilidade, voc ter que fazer alguma e e depurao do MySQL! Veja Seo E.1 [Depurando o servidor], Pgina 1079. ca ca a Nota: antes de iniciar a depurao do mysqld, obtenha primeiro os programas de teste ca mysys/thr_alarm e mysys/thr_lock para funcionar. Isto asegurar que sus instalao da a ca thread tem pelo menos uma chance remota de funcionar.

E.1 Depurando um Servidor MySQL

Se voc estiver usando uma funcionalidade que muito nova no MySQL, voc pode tene e e tar executar o mysqld com --skip-new (que desabilitar todas novas funcionalidades com a pontecialidade de ero) ou com --safe-mode que desabilita vrias otimizaes que podem a co criar problemas. Veja Seo A.4.1 [Falhas], Pgina 925. ca a Se o mysqld no quiser iniciar, voc deve vericar se voc no tem qualquer arquivo my.cnf a e e a que interfere com sua congurao. Voc pode vericar seus argumento do my.cnf com ca e mysqld --print-defaults e evitar us-los iniciando com mysqld --no-defaults .... a Se o mysqld comea a consumir CPU ou memria ou se ele car lento, voc pode usar o c o e mysqladmin processlist status para achar algum que esteja executando uma consulta e que demore algum tempo. POde ser uma boa idia executar mysqladmin -i10 processlist e status em alguma janela se voc estiver tendo problemas de desempenho ou problemas com e novos clientes que no podem conectar. a O comando mysqladmin debug ir trazer alguma informao sobre as em uso, memria a ca o usada e uso das consultas no arquivo de log do mysql. Isto pode ajudar a resolver problemas. Este comando tambm fornece informaes uteis mesmo se voc no tiver compilado MySQL e co e a para depurao! ca Se o problema que algumas tabelas esto cando maior e mais lentas voc deve tentar e a e otimizar a tabela com OPTIMIZE TABLE ou myisamchk. Veja Capptexi tulo 4 [Administrao de Banco de Dados MySQL], Pgina 207. Voc tambm deve tentar vericar as ca a e e consultas lentas com EXPLAIN. Voc tambm deve ler a seo espec e e ca ica do SO neste manual para saber sobre problemas que podem ser unicos em seu ambiente. Veja Seo 2.6 [Notas Espec ca icas do Sistema Operacional], Pgina 133. a

E.1.1 Compilando o MYSQL para Depurao ca

Se voc tiver um problema espec e ico, voc sempre pode tentar depurar o MySQL. Para fazer e isto voc deve congurar o MySQL com a opo --with-debug ou --with-debug=full. e ca Voc pode vericar se o MySQL foi compilado com depurao executando: mysqld -e ca help. Se o parmetro --debug estiver listado entre as opes ento voc tm a depurao a co a e e ca habilitada. mysqladmin ver tambm lista a verso do mysqld como mysql ... --debug e a neste caso.

1080

MySQL Technical Reference for Version 5.0.0-alpha

se voc estiver usando gcc ou egcs, a congurao recomendada : e ca e CC=gcc CFLAGS="-O2" CXX=gcc CXXFLAGS="-O2 -felide-constructors \ -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql \ --with-debug --with-extra-charsets=complex Isto evitar problemas com a biblioteca libstdc++ e com excees C++ (muitos compia co ladores tm problemas com excees C++ no cdigo da thread) e compila uma verso MySQL e co o a com suporte para todos os conjuntos caracter. Se voc suspeita de um erro despejo de memria, voc pode congurar o o MySQL com e o e --with-debug=full, que ir instalar vericar de alocao de memria (SAFEMALLOC). No a ca o entanto, a execuo com SAFEMALLOC um pouco lenta, assim se voc tiver problemas de ca e e desempenho voc deve iniciar o mysqld com a opao --skip-safemalloc. Isto disabilitar e c a a vericao de despejo de momria para cada chamada a malloc() e free(). ca o Se o mysqld parar de falhar quando voc compilar com --with-debug, voc provavelmente e e encontrou um erro de compilao ou erro de tempo dentro do MySQL. Neste caso voc pode ca e tentar adicionar -g `s variveis CFLAGS e CXXFLAGS acima e no usar --with-debug. Se a a a agora o mysqld morre, voc pode pelo menos execut-lo com gdb ou usar o gdb no arquivo e a core para descobrir que aconteceu. Quando voc congura o MySQL para depurao voc habilita automaticamente diversas e ca e funes de vericao de segurana extra que monitora a sade do mysqld. Se eles enconco ca c u trarem algo inesperado, uma entrada ser encrita no stderr, que mysqld_safe direciona a para o log de erros! Isto tambm signica que se voc estiver tendo alguns problemas inexe e perados com o MySQL e estiver usando uma distribuio fonte, a primeira coisa que voc ca e deve fazer congurar o MySQL para depurao! (A segunda coisa enviar uma mensagem e ca e para a lista de email do MySQL e pedir ajuda. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a Por favor, use o script mysqlbug para todos os relatos de bug e questes referentes a verso o a do MySQL que voc est usando! e a Na distribuio do MySQL para Windows, mysqld.exe , por padro, compilado com ca e a suporte a arquivos trace.

E.1.2 Criando Arquivos Trace (Rastreamento)

Se o servidor mysqld no inicia ou se voc pode fazer o servidor mysqld falhar rapidamente, a e voc pode tentar criar um arquivo trace para encontrar o problema. e Para fazer isto voc tem que ter um mysqld compilado para depurao. Voc pode vericar e ca e isto executando mysqld -V. Se o nmero da verso naliza com -debug, ele est compilado u a a com suporte a arquivos trace. Inicie o servidor mysqld com um log trace em /tmp/mysqld.trace (ou C:\mysqld.trace no Windows): mysqld --debug No Windows voc tambm deve usar o parmetro --standalone para no iniciar o mysqld e e a a como um servio: c Em uma janela de console faa: c mysqld --debug --standalone

Apndice E: Portando para Outros Sistemas e

1081

Depois disso voc pode usar a ferramenta de linha de comando mysql.exe em uma segunda e janela de console para reproduzir o problema. Voc pode nalizar o servidor mysqld acima e com mysqladmin shutdown. Note que o arquivo trace ser muito grande! Se voc quiser ter um arquivo trace menor, a e voc pode usar algo como: e mysqld --debug=d,info,error,query,general,where:O,/tmp/mysqld.trace que apenas exibe informaes com a maioria das tags interrassants em co /tmp/mysqld.trace. Se voc zer um relatrio de bug sobre isto, por favor s envie as linhas do trace para a lista e o o de email apropriada quando algo parecee estar errado! Se voc no puder localizar o local e a errado, voc pode fazer um ftp do arquivo trace, junto com um relatrio de bug completo, e o para ftp://support.mysql.com/pub/mysql/secret/ para que assim um desenvolvedor do MySQL possa dar uma olhada nele. O arquivo trace feito com o pacote DBUG de Fred Fish. Veja Seo E.3 [O pacote DBUG], e ca Pgina 1085. a

E.1.3 Depurando o mysqld no gdb

Na maioria dos sistemas voc tambm pode iniciar o mysqld a partir do gdb para obter e e mais informaes se o mysqld falhar. co Com uma verso antiga do gdb no Linux voc deve usar run --one-thread se voc quiser a e e estar apto a depurar a thread mysqld. Neste caso voc s pode ter uma thread ativa por e o vez. Ns recomendamos que voc atualize para gdb 5.1 ASAP j que a depurao da thread o e a ca funciona muito melhor com esta verso! a Ao executar o mysqld com gdb, voc deve disabilitar a pilha de rastreamento com --skipe stack-trace para estar apto a conseguir segmentation fault com gdb. E muito dif depurar o MySQL no gdb se voc zer muitas conexes o tempo todo j que icil e o a gdb no libera a memria para threads antigas. Voc pode evitar este problema iniciando a o e mysqld com -O thread_cache_size= max_connections +1. Na maioria dos casos s o o uso de -O thread_cache_size=5 j ajuda muito! a Se voc quiser um tiver um core dump no Linux quando o mysqld morre com um sinal e SIGSEGV, voc pode iniciar o mysqld com a opao --core-file. Este arquivo core pode e c ser usado para fazer um rastreamento que pode lhe ajudar a descobrir porque o mysqld morreu: shell> gdb mysqld core gdb> backtrace full gdb> exit Veja Seo A.4.1 [Falhas], Pgina 925. ca a Se voc estiver usando gdb 4.17.x ou acima no Linux, voc deve instalar um arquivo .gdb, e e com a seguinte informao, em seu diretrio atual: ca o set print sevenbit off handle SIGUSR1 nostop noprint handle SIGUSR2 nostop noprint handle SIGWAITING nostop noprint

1082

MySQL Technical Reference for Version 5.0.0-alpha

handle SIGLWP nostop noprint handle SIGPIPE nostop handle SIGALRM nostop handle SIGHUP nostop handle SIGTERM nostop noprint Se voc tiver problemas depurando threads com gdb, voc deve fazer o download do gdb e e 5.x e experiment-lo. A nova verso do gdb tem um tratamento de threads bem melhorado. a a Aqui est um exemplo de como depurar o mysqld: a shell> gdb /usr/local/libexec/mysqld gdb> run ... backtrace full # Faa isto quando o mysqld falhar c acima e uma email gerado com mysqlbug e envie-o para lista de email do Inclua a saida MySQL. Veja Seo 1.7.1.1 [Mailing-list], Pgina 33. ca a Se o mysqld travar voc pode usar algumas ferramentas de sistema como strace ou e /usr/proc/bin/pstack para exeminar onde mysqld travou. strace /tmp/log libexec/mysqld Se voc estiver usando a interface Perl DBI, voc pode habilitar a informao de depuao e e ca ca usando o mtodo trace ou denindo a varivel de ambiente DBI_TRACE. Veja Seo 12.5.2 e a ca [Classe Perl DBI], Pgina 881. a

E.1.4 Usando Stack Trace

Em alguns sistemas operacionais, o log de erro ir conter um stack trace se mysqld nalizar a inesperadmente. Voc pode us-lo para descobrir onde (e talvez por que) o mysqld nale a izou. Veja Seo 4.10.1 [Log de erro], Pgina 372. Para obter um stack trace, voc no ca a e a deve compilar o mysqld com a opo -fomit-frame-pointer para gcc. Veja Seo E.1.1 ca ca [Compilando para depurao], Pgina 1079. ca a Se o arquivo de erro conter algo como o seguinte: mysqld got signal 11; The manual section Debugging a MySQL server tells you how to use a stack trace and/or the core file to produce a readable backtrace that may help in finding out why mysqld died Attemping backtrace. You can use the following information to find out where mysqld died. If you see no messages after this, something went terribly wrong stack range sanity check, ok, backtrace follows 0x40077552 0x81281a0 0x8128f47 0x8127be0 0x8127995 0x8104947 0x80ff28f 0x810131b

Apndice E: Portando para Outros Sistemas e

1083

0x80ee4bc 0x80c3c91 0x80c6b43 0x80c1fd9 0x80c1686 voc pode descobrir onde o mysqld nalizou fazendo o seguinte: e 1. Copie os nmeros acima em um arquivo, por exemplo mysqld.stack. u 2. Faa um arquivo de s c imbolos para o servidor mysqld: nm -n libexec/mysqld > /tmp/mysqld.sym Note que a maioria das distribuies binrias do MySQL (exceto para o pacotes de co a "depurao" onde as informaes so inclu ca co a idas dentro dos binrios) j possuem o ara a quivo acima, chamado mysqld.sym.gz. Neste caso voc pode simplesmente desempae cot-lo fazendo: a gunzip < bin/mysqld.sym.gz > /tmp/mysqld.sym 3. Execute resolve_stack_dump -s /tmp/mysqld.sym -n mysqld.stack. Isto exibir a onde o mysqld nalizou. Se isto no lhe ajuda a descobrir o porque o a a mysqld morreu, voc deve fazer um relato de erro e incluir a sa do comando acima e ida no relatrio. o Note no entanto que na maioria dos casos, termos apenas um stack trace, no nos a ajudar a encontrar a razo do problema. Para estarmos apto a localizar o erro ou a a fornecer um modo de contorn-lo, precisariamos, na maioria dos casos, conhecer a a consulta que matou o mysqld e de preferncia um caso de teste para que possamos e repetir o problema! Veja Seo 1.7.1.3 [Relato de erros], Pgina 36. ca a

E.1.5 Usando Arquivos de Log para Encontrar a Causa dos Erros no mysqld
Note que antes de iniciarmos o mysqld com --log voc deve vericar todas as suas tabelas e com myisamchk. Veja Capptexi tulo 4 [Administrao do Banco de Dados MySQL], ca Pgina 207. a Se o mysqld morre ou trava, voc deve iniciar o mysqld com --log. Quando o mysqld e morre de novo, voc pode examinar o m do arquivo de log para a consulta que matou o e mysqld. Se voc estiver usando --log sem um nome de arquivo, o log armazenado no diretrio e e o do banco de dados como nomemaquina.log. Na maioria dos casos a ultima consulta no e arquivo de log que matou mysqld, mas se poss ivel voc deve vericar isto reiniciando o e mysqld e executando a consulta encontrada por meio da ferramenta de linha de comando mysql. Se isto funcionar, voc tambm deve testar todas as consultas complicadas que no e e a completaram. Voc tambm pode tentar o comando EXPLAIN em todas as instrues SELECT que levam e e co muito tempo para assegurar que o mysqld est usando a indices apropriados. Veja Seo 5.2.1 ca [EXPLAIN], Pgina 424. a Voc pode encontrar as consultas que levam muito twempo para executar iniciando o mysqld e com --log-slow-queries. Veja Seo 4.10.5 [Log de consultas lentas], Pgina 377. ca a

1084

MySQL Technical Reference for Version 5.0.0-alpha

Se voc encontrar o texto mysqld restarted no arquivo de registro de erro (normalmente e chamado hostname.err) voc provavelmente encontrou uma consulta que provocou a falha e no mysqld. Se isto acontecer voc deve vericar todas as suas tabelas com myisamchk e (veja Cap ptexi tulo 4 [Administrao do Banco de Dados MySQL], Pgina 207) e testar ca a a consulta no arquivo de log do MySQL para ver se ela no funcionou. Se voc encona e trar tal consulta, tente primeiro atualizar para uma verso mais nova do MySQL. Se isto a no ajudar e voc no puder encontrar nada no arquivo de mensagem mysql, voc deve a e a e relatar o erro para uma lista de email do MySQL. As listas de email esto descritas em a http://lists.mysql.com/, que tambm possui os links para as listas de arquivos online. e Se voc iniciou o mysqld com myisam-recover, o MySQL vericar automaticamente e a e tentar reparar as tabelas MyISAM se elas estiverem marcadas como no fechadas a a apropriadamente ou com falha. Se isto acontecer, o MySQL ir escrever uma entrada a Warning: Checking table ... no arquivo nomemaquina.err, a qual seguida por e Warning: Repairing table se a tabela precisar ser reparada. Se voc obter vrios desses e a erros, sem que o mysqld nalize inesperadamente um pouco antes, ento algo est errado e a a precisa ser investigado melhor. Veja Seo 4.1.1 [Opes de linha de comando], Pgina 207. ca co a claro que no um bom sinal se o mysqld morreu inesperadamente, mas neste caso no se E a e a deve invwestigar as mensagens Checking table... e sim tentar descobrir por que o mysqld morreu.

E.1.6 Fazendo um Caso de Teste Se Ocorre um Corrompimento de Tabela

Se voc tm tabelas corrompidas ou se o mysqld sempre falha depois de alguns comendos e e de atualizao, voc pode testar se este erro reproduz fazendo o seguinte: ca e e ivel Desligue o daemon MySQL (com mysqladmin shutdown). Faa um backup das tabelas (para o caso da reparao fazer algo errado) c ca Verique todas as tabelas com myisamchk -s database/*.MYI. Repare qualquer tabela errada com myisamchk -r database/table.MYI. Faa um segundo backup das tabelas. c Remove (ou mova para outro local) qualquer arquivo de log antigo do diretrio de o dados se voc precisar de mais espao. e c Inicie o mysqld com --log-bin. Veja Seo 4.10.4 [Log binrio], Pgina 374. Se voc ca a a e quiser encontrar uma consulta que provoque uma falha no mysqld, voc deve usar e --log --log-bin. Quando voc obter uma tabela danicada, pare o servidor mysql. e Restaure o backup. Reinicie o servidor mysqld sem --log-bin Re-execute os comandos com mysqlbinlog update-log-file | mysql. O log de atualizao est salvo no diretrio do banco de dados com o nome nomemaquina-bin.#. ca a o Se as tabelas forem corrompidas novamente ou voc puder fazer o mysqld e nalizar com o comando acima, vc ter encontrado um erro reproduz e a ivel que deve ser facilmente corrigido! Envie as tabelas e o log binrio por ftp para a ftp://support.mysql.com/pub/mysql/secret/ e coloque-o em nosso sistema de

Apndice E: Portando para Outros Sistemas e

1085

erros em http://bugs.mysql.com/. Se voc um consumidor com suporte, voc e e e tambm pode enviar um email para support@mysql.com para alertar a equipe do e MySQL sobre o problema e t-lo corr e igido o mais rpido poss a ivel.. Voc tambm pode usar o script mysql_find_rows para executar algumas das instrues e e co de atualizao se voc quiser estreitar o problema. ca e

E.2 Depurando um cliente MySQL.

Para estar apto a depurar um cliente MySQL com o pacote de depurao integradom voc ca e deve congurar o MySQL com --with-debug ou --with-debug=full. Veja Seo 2.3.3 ca [opes de congurao], Pgina 98. co ca a Antes de executar um cliente, voc deve congurar a varivel de ambiente MYSQL_DEBUG: e a shell> MYSQL_DEBUG=d:t:O,/tmp/client.trace shell> export MYSQL_DEBUG Isto faz com que os clientes gerem um arquivo trace em /tmp/client.trace. Se voc tiver problemas com seu prprio cdigo cliente, voc deve tentar se conectar ao e o o e servidor e executar a sua consulta usando um cliente que esteja funcionando. Faa isto c executando o mysql no modo de depurao (assumindo que voc tenha compilado o MySQL ca e com esta opo). ca shell> mysql --debug=d:t:O,/tmp/client.trace Isto ir fornecer informao util no caso de voc enviar um relatrio de erro. Veja a ca e o Seo 1.7.1.3 [Relatrio de erros], Pgina 36. ca o a Se o seu cliente falhar em algum cdigo aparentemente legal, voc deve vericar se o seu o e arquivo mysql.h inclu corresponde com o seu arquivo da biblioteca mysql. Um erro ido muito comum usar um arquivo mysql.h antigo de uma instalao MySQL antiga com e ca uma nova biblioteca MySQL.

E.3 O Pacote DBUG

O servidor MySQL e a maioria dos clientes MySQL so compilados com o pacote DBUG a originalmente criado por Fred Fish. Quando se congura o MySQL para depurao, este ca pacote torna poss obter um arquivo trace sobre o que o programa est depurando. Veja ivel a Seo E.1.2 [Criando arquivos trace], Pgina 1080. ca a Utiliza-se o pacote de depurao chamando o programa com a opo --debug="..." ou ca ca -#.... A maioria dos programas MySQL tem uma string de depurao padro que ser usada ca a a se voc no especicar uma opo para --debug. O arquivo trace padro normalmente e a ca a e /tmp/programname.trace no Unix e \programname.trace no Windows. A string de controle de depurao uma sequncia de campos separados por dois pontos ca e e como a seguir: <field_1>:<field_2>:...:<field_N> Cada campo consiste de um carcater de parmetro obrigatrio seguido por uma "," e lista a o de modicadores separdas por virgula opcionais:

1086

MySQL Technical Reference for Version 5.0.0-alpha

flag[,modifier,modifier,...,modifier] Os carcteres de parmetros atualmente reconhecidos so: a a Parmetro Descrio a ca d Habilita a sa de macros DBUG <N> para o estado atual. Pode ser seguido ida por uma lista de palavras chaves que selecionam a sa apenas para as macros ida DBUG com aquela palavra chave. Uma lista de palavras chaves vazia indica a sa para todas as macros. ida D Atraso depois de cada linha de sa do depurados. O argumento o nmero de ida e u dcimos de segundo do atraso, sujeito `s capacidades da mquina. Por exemplo, e a a -#D,20 atrasa em dois segundos f Limita a depurao e/ou rastreamento, e perlemento da lista de funes lisca co tadas. Note que uma lista nula disabilitar todas as funes. O parmetro "d" a co a ou "t" apropriado ainda deve ser dado, este parmetro s limita as suas aesse a o co eles estiverem habilitados. F Identica o nome do arquivo fonte para cada linha de sa da depurao ou ida ca rastreamento. i Identica o processo com o PID ou a ID da thread para cada linha de sa da ida depurao ou rastreamento. ca g Habilita a modelagem. Cria um arquivo chamado dbugmon.out contendo informaes que poder ser usadas para moldar o programa. Pode ser seguida por co uma lista de palavras chaves que selecionam a modelagem apenas para as funes co naquela lista. Uma lista nula indica que todas as funes sero consideradas. co a L Identica o nmero da linha do arquivo fonte para cada linha de sa da u ida depurao ou rastreamento. ca n Exibe a profundidade de aninhamento da funo atual para cada linha de sa ca ida da depurao ou rastreamento. ca N Nmero de cada linha de sa do dbug. u ida o Redireciona o uxo de sa do depurador para um arquivo espec ida ico. A sa ida padro stderr. a e O Igual a o, mas o arquivo realmente descarregado entre cada escrita. Quando e necessrio o arquivo fechado e reaberto entre cada escrita. a e p Limita as aes do depurador para um processo espec co ico. Um processo deve ser indenticado com a macro DBUG PROCESS e corresponder a um dos itens especicados na lista de aes do depurador que devem ocorrer. co P Exibe o nome do processo atual para cada linha de sa da depurao ou ida ca rastreamento. r Quando recebe um novo estado, no herda o n a ivel de aninhamento da funo ca do estado anterior. Util quando a sa iniciada na margem esquerda. ida e S Executa a funo sanity( le , line ) a cada funo depurada at que sanity() ca ca e retorne algo diferente de 0. (Geralmente usada com safemalloc para encontrar falhas de memria). o t Habilita a linhas do trace de chamada/sa de funes. Pode ser seguido ida co por uma lista (contendo apenas um modicador) dando um o n ivel numrico e ser exibida, tanto para mximo de rastreamento, alm do que nenhuma saida a e a a depurao quanto para macros trace. O padro uma opo de tempo de ca a e ca compilao. ca

Apndice E: Portando para Outros Sistemas e

1087

Alguns exemplos de strings de controle do depurador que podem aparecer em uma linha de comando do shell (o "-#" normalmente usado para introduzir uma string de controle a e um aplicativo) so: a -#d:t -#d:f,main,subr1:F:L:t,20 -#d,input,output,files:n -#d:t:i:O,\\mysqld.trace No MySQL, tags comuns de serem usadas (com a opo d) so: enter,exit,error,warning,info ca a e loop.

E.4 Mtodos de Lock e

Atualmente o MySQL s suporta bloqueios de tabela para tipos ISAM/MyISAM e HEAP, o bloqueios a nivel de pgina para tabelas BDB e bloqueio a nivel de registros para tabelas a InnoDB. Veja Seo 5.3.1 [Bloqueio interno], Pgina 443. Com tabelas MyISAM pode se misca a turar livremente INSERT e SELECT sem travas, se as instrues INSERTs no so conltantes. co a a (ex.: se eles so inseridos no m da tabela em vez de preencherem espaos liberados por a c dados/linhas deletados). A partir da verso 3.23.33, voc pode analisar a conteno do bloqueio de tabela no seu sisa e ca tema vericando as variveis de ambiente Table_locks_waited e Table_locks_immediate. a Para decidir se voc quer usar um tipo de tabela com bloqueio a n e ivel de registro, voc e dever olhar o que o aplicativo faz e o qual o padro de seleo/atualizao dos dados. a e a ca ca Pontos a favor do bloqueios de registros: Poucos conitos de bloqueios ao acessar registros diferentes em muitas threads. Poucas alteraes para rollback. co bloquear um unico registro por um longo tempo. Torna possivel Contras: Gasta mais memria que bloqueios a n de pgina ou tabela. o ivel a mais lento que bloqueios a n de pgina ou tabela quando usado em uma grande E ivel a parte da tabela, pois deve-se fazer muito mais travamentos. E dinitivamente muito pior que outras travas se voc frequentemente utiliza GROUP BY e em uma grande parte dos dados ou feita uma varredura de toda a tabela. e Com n ivel de bloqueios mais altos pode-se tambm, com mais facilidade, suportar e travas de diferentes tipos para sintonizar a aplicao j que a sobreposio de bloqueio ca a ca menos percept que para bloqueios a n de registro. e ivel ivel Bloqueios de tabela so superiores a bloqueios a n a ivel de pgina / registro nos seguintes a casos: Muitas leituras Leituras e atualizaes em chaves restritas; onde atualiza ou deleta-se um registro co e que pode ser buscado com uma leitura de chave: UPDATE nome_tbl SET coluna=valor WHERE unique_key# DELETE FROM nome_tbl WHERE unique_key=#

1088

MySQL Technical Reference for Version 5.0.0-alpha

SELECT combinado com INSERT (e muito poucas instrues UPDATEs e DELETEs). co Muitas varreduras / GROUP BY em toda a tabela sem nenhuma escrita. Outra opes alm de bloqueios a n de pgina / registro: co e ivel a Versioning (como usamos no MySQL para inseres concorrentes) onde voc pode ter um co e escrita e vrias leituras ao mesmo tempo. Isto signica que o banco de dados/tabelas suporta a diferentes viiews para os dados dependendo de quando se comea a acess-lo. Outros nomes c a deste recurso so time travel, cia na escrita ou cpia por demanda. a o o Cpia por demanda em muitos casos muito melhor que bloqueio a n o e ivel de registro ou pgina; o piro caso, no entanto, usa muito mais memria que a usada em travamentos a o normais. Em vez de se usar bloqueio de registro pode-se usar bloqueios no aplicativo (como o get lock/release lock no MySQL). Isto s funciona em aplicaticos bem comportados. Em muitos casos pode se fazer um palpite sobre qual tipo de bloqueio melhor para a e aplicao. mas geralmente muito dif dizer que um dado tipo de bloqueio melhor que ca e icil e outro; tudo depende da aplicao e diferentes partes da aplicao podem exigir diferentes ca ca tipos de bloqueios. Aqui esto algumas dicas sobre travamento no MySQL: a A maioria das aplicaes web fazem diversos selects, muito poucas delees, atualizaoes co co principalmente nas chaves e inseres em tabelas espec co icas. A congurao base do MySQL ca bem sitonizada para esta nalidade. e Usurios concorrentes no so um problema se eles no misturam atualizaes com selees a a a a co co que precisam examinar muitas linhas na mesma tabela. Se misturado inseres e excluses na mesma tabela ento INSERT DELAYED pode ser de e co o a grande ajuda. Pode se tambm usar LOCK TABLES para aumentar a velocidade (muitas atualizaes com e co um travamento simples muito mais rpida que atualizaes sem travamento). Separar as e a co coisas em tabelas diferentes tambm ajudar. e a Se voc tiver problemas de velocidade com travamento de tabelas no MySQL, voc pode e e estar apto a resolver isto convertendo alguma de suas tabelas para tipos InnoDB ou BDB. Veja Seo 7.5 [InnoDB], Pgina 643. Veja Seo 7.6 [BDB], Pgina 698. ca a ca a A seo de otimizao no manual cobre diversos aspectos de como sintonizar a sua aplicao. ca ca ca Veja Seo 5.2.13 [Dicas], Pgina 440. ca a

E.5 Comentrios Sobre Threads RTS a

Tentamos usar os pacotes RTS thread com o MySQL mas nos deparamos com o seguinte problema: Eles usam um verso antiga de diversas chamadas POSIX e muito tedioso fazer wrappers a e para todas as funes. Estamos inclinados a pensar que seria mais fcil alterar a biblioteca co a de threads para a especicao POSIX mais nova. ca Alguns wrappers j esto escritos. Veja mysys/my_pthread.c para maiores informaes. a a co Pelo menos o seguinte deve ser mudado:

Apndice E: Portando para Outros Sistemas e

1089

pthread_get_specific deve usar um argumento. sigwait deve usar dois argumentos. Diversas funes (pelo menos pthread_cond_wait, pthread_cond_timedwait) deve retornar co o cdigo do erro. Agora eles retornam -1 e conguram errno. o Outro problema que threads a nivel do usuario usam o sinal ALRM e isto aborta diversas e das funes (read, write, open...). O MySQL deve fazer uma nova tentativa de interrupo co ca em todos mas no facil de se verica isto. a e O maior problema no solucionado o seguinte: a e Para conseguir alarmes de threads alteramos mysys/thr_alarm.c para esperar entre alarmes com pthread_cond_timedwait(), mas isto aborta com o erro EINTR. Tentamos depurar a biblioteca thread para descobrirmos porque isto acontece, mas no podemos a encontrar nenhuma soluo fcil. ca a Se algum quiser experimentar o MySQL com RTS threads sugerimos o seguinte: e Altere as funes que o MySQL usa da biblioteca de threads para POSIX. Isto no co a deve levar tanto tempo. Compile todas as bibliotecas com -DHAVE_rts_threads. Compile thr_alarm. Se houver alguma pequena diferena na implementao, elas devem ser corrigidas alc ca terando my_pthread.h e my_pthread.c. Execute thr_alarm. Se ele executar sem mensagens de aviso, erro ou aborto, voc e est na trilha certa. Aqui est uma execuo bem sucedidad no Solaris: a a ca Main thread: 1 Thread 0 (5) started Thread: 5 Waiting process_alarm Thread 1 (6) started Thread: 6 Waiting process_alarm process_alarm thread_alarm Thread: 6 Slept for 1 (1) sec Thread: 6 Waiting process_alarm process_alarm thread_alarm Thread: 6 Slept for 2 (2) sec Thread: 6 Simulation of no alarm needed Thread: 6 Slept for 0 (3) sec Thread: 6 Waiting process_alarm process_alarm thread_alarm Thread: 6 Slept for 4 (4) sec Thread: 6 Waiting process_alarm thread_alarm

1090

MySQL Technical Reference for Version 5.0.0-alpha

Thread: 5 Slept for 10 (10) sec Thread: 5 Waiting process_alarm process_alarm thread_alarm Thread: 6 Slept for 5 (5) sec Thread: 6 Waiting process_alarm process_alarm ... thread_alarm Thread: 5 Slept for 0 (1) sec end

E.6 Diferena en Entre Alguns Pacotes de Threads c

MySQL muito dependente do pacote de threads usado. Assim ao escolher uma boa e plataforma para o MySQL, o pacote de threads muito importante. e Existem pelo menos trs tipos de pacotes de threads: e Threads de usurios em um processo unico. A troca de threads gerenciada com a e alarmes e a bilioteca thread gerencia todas as funes no segura as threads com travaco a mento. Operaes de leitura, excrita e operaao so normalmente gernciada com uma co c a e select espec ica da thread que troca para outra thread se a thread em execuo tiver que ca esperar por dados. Se os pacotes de threads do usurio esto integrados com as bibliotea a cas padro (threads FreeBSD e BSDI) o pacote da thread exige menos sobreposicao a que pacotes de threads que tm que mapear todas as chamadas no seguras (MITe a pthreads, FSU Pthreads e RTS threads). Em alguns ambientes (SCO, por exemplo), todas as chamadas do sistema so seguras a threads e assim o mapeamento pode ser a feito muito facilmente (FSU Pthreads em SCO). Desvantagem: Todas as chamadas mapeadas levam pouco tempo e bem malicioso para tratar todas as situaes. Tambm e co e h, normalmente, algumas chamadas de sistema que no so tratados pelo pacote de a a a thread (como MIT-threads e sockets). O agendamento de threads nem sempre timo. eo Threads de usurios em processos separados. A troca de threads feita pelo kernel a e e todos os dados so compartilhados entre threads. O pacote de thread gerncia as a e chamadas padro de threads para permitir o compartilhamento de dadps entre threads. a LinuxThreads usado neste mtodo. Desvantagem: Diversos processos. A criao de e e ca thrads lenta. Se uma thread morrer as outras normalmente travaro e voc voc e a e e dever mat-las antes de reiniciar. A troca de threads tambm tem um custo um a a e pouco alto. Threads de kernel. A troca de threads feita pela biblioteca de thread ou pelo kernele e muito rpida. Tudo feito em um processo, mas em alguns sistema, ps pode mostrar e a e threads diferentes. Se uma thread abortar, todo o processo abortado. A maioria das e chamadas do sistema so seguras a threads e devem exigir muito pouca sobrecarga. a Solaris, HP-UX, AIX e OSF/1 tm threads de kernel. e

Apndice E: Portando para Outros Sistemas e

1091

Em alguns sistemas, threads do kernel so gerenciadas threads de usurio integrads em a a bibkliotecas de sistemas. Nestes casos a troca de thread pode ser feita pela biblioteca de threads e o kernel no tm real conhecimento da thread. a e

1092

MySQL Technical Reference for Version 5.0.0-alpha

Apndice F Variveis de Ambientes do MySQL e a

Aqui est uma lista de todas as variveis de ambiente que so usada diretamente ou india a a retamente pelo MySQL. A maioria delas tambm pode ser encontrada em outros lugares e neste manual. Note que qualquer opo na linha de comando sobrescreve os valores especicados nos ca arquivos de congurao e variveis de ambientes, e valores nos arquivos de congurao ca a ca tem preferncia sobre valores em vriveis de ambientes. e a utilizar um arquivo congue em vez de uma varivel de amEm muitos casos preferivel e a biente para modicar o comportamento do MySQL. Veja Seo 4.1.2 [Arquivos de opes], ca co Pgina 216. a Varivel a Descrio ca CXX Dena-a em seu compilador C++ ao rodar o congure. CC Dena-a em seu compilador C ao executar congure. CFLAGS Parmetros para o seu compilador C ao executar o congure. a CXXFLAGS Parmetros para o seu compilador C++ ao executar o a congure. DBI_USER O nome do usurio padro para Perl DBI. a a DBI_TRACE Usado ao rastrear o Perl DBI. HOME O caminho padro para o arquivo de histrico do mysql a o e $HOME/.mysql_history. LD_RUN_PATH Usado para especicar onde o seu libmysqlclient.so est. a MYSQL_DEBUG Opes de debug-trace ao depurar. co MYSQL_HISTFILE O caminho para o arquivo de histrico do mysql. o MYSQL_HOST Nome de mquina padro usada pelo cliente de linha de coa a mando mysql. MYSQL_PS1 Prompt de comando para usar no cliente de linha de comando mysql. Veja Seo 4.9.2 [mysql], Pgina 347. ca a MYSQL_PWD A senha padro ao conectar ao mysqld. Note que o uso disto a inseguro! e MYSQL_TCP_PORT A porta TCP/IP padro. a MYSQL_UNIX_PORT O socket padro; usado para conexes localhost. a o PATH Usado pela shell para encontrar os programas MySQL. TMPDIR O diretrio onde as tabelas temporrias so criadas. o a a TZ Pode ser congurado para seu fuso horrio local. Veja a Seo A.4.6 [Problemas de Fuso Horrio], Pgina 930. ca a a UMASK_DIR A mscara de criao de diretrio do usurio ao se criar dia ca o a retrios. Note que feito um AND com UMASK! o e UMASK A mscara de criao dos arquivos do usurio, usado ao se a ca a criar um arquivo. USER O usurio padro no Windows para usar ao conectar ao a a mysqld.

Apndice G: Sintaxe de Expresses Regulares do MySQL e o

1093

Apndice G Sintaxe de Expresses Regulares do e o MySQL

Um expresso regular (regex) um modo poderoso de especicar um pesquisa complexa. a e O MySQL usa a implementao do Henry Spencer de expresses regulares, a qual est em ca o a conformidade com o POSIX 1003.2. MySQL usa a verso extendida. a Esta uma referncia simplria que salta os detalhes. Para obter informaes exatas, veja e e o co a pgina manual do regex(7) de Henry Spencer que est inclu na distribuico fonte. a a ida a Veja Apndice C [Credits], Pgina 945. e a Uma expresso regular descreve um conjunto de strings. A regexp mais simples uma que a e no tenha nenhum caracter especial nela. Por exeplo, o regexp hello combina com hello a e nada mais. Expresses regulares no triviais usam certas construes especiais e assim podem encontrar o a co mais de uma string. Por exemplo, o regexp hello|word combina tanto com a string hello quanto com a string word. Como um exemplo mais complicado, o regexp B[an]*s mcombina com qualquer das strings Bananas, Baaaaas, Bs, e qualquer string iniciando com um B, e nalizando com um s, e contendo qualquer nmero de caracteres a ou n entre eles. u Um expresso reguklar pode utilizar qualquer dos um dos caracteres/ construtores especiais: a ^ Combina com o inicio de uma string. mysql> SELECT "fo\nfo" REGEXP "^fo$"; mysql> SELECT "fofo" REGEXP "^fo"; $ Combina com o m de uma string. mysql> SELECT "fo\no" REGEXP "^fo\no$"; mysql> SELECT "fo\no" REGEXP "^fo$"; . Combina com qualquer caracter (incluindo novas linhas) mysql> SELECT "fofo" REGEXP "^f.*"; mysql> SELECT "fo\nfo" REGEXP "^f.*"; a* Combina com qualquer sequncia de zero ou mais carcteres a. e mysql> SELECT "Ban" REGEXP "^Ba*n"; mysql> SELECT "Baaan" REGEXP "^Ba*n"; mysql> SELECT "Bn" REGEXP "^Ba*n"; a+ Cobina com qualquer sequncia de um ou mais caracteres a. e mysql> SELECT "Ban" REGEXP "^Ba+n"; mysql> SELECT "Bn" REGEXP "^Ba+n"; a? Combina com zero ou um caracter a. mysql> SELECT "Bn" REGEXP "^Ba?n"; mysql> SELECT "Ban" REGEXP "^Ba?n"; mysql> SELECT "Baan" REGEXP "^Ba?n"; de|abc Combina tant com a sequencia de como com abc. -> 1 -> 1 -> 0 -> 1 -> 0 -> 1 -> 1 -> 1 -> 1 -> 1 -> 1 -> 0 -> 0 -> 1

1094

MySQL Technical Reference for Version 5.0.0-alpha

mysql> mysql> mysql> mysql> mysql> mysql> (abc)*

SELECT SELECT SELECT SELECT SELECT SELECT

"pi" REGEXP "pi|apa"; "axe" REGEXP "pi|apa"; "apa" REGEXP "pi|apa"; "apa" REGEXP "^(pi|apa)$"; "pi" REGEXP "^(pi|apa)$"; "pix" REGEXP "^(pi|apa)$";

-> -> -> -> -> ->

1 0 1 1 1 0

Combina com zero ou mais instncias da sequncia abc. a e mysql> SELECT "pi" REGEXP "^(pi)*$"; mysql> SELECT "pip" REGEXP "^(pi)*$"; mysql> SELECT "pipi" REGEXP "^(pi)*$"; -> 1 -> 0 -> 1

{1} {2,3}

Existe um modo mais geral de se escrever regexp que combinam com muitas ocorrncias de um tomo anterior. e a a* a+ a? Pode ser escrito como a{0,}. Pode ser escrito como a{1,}. Pode ser escrito como a{0,1}.

Para ser mais preciso, um tomo seguido por um limite contendo um inteiro i a e nenhuma virgula casa com uma sequncia de exatamente i combinaes do e co a tomo. Um tomo seguido por um limite contendo i e uma virgula casa com a uma sequncia de i ou mais combinaes do tomo. Um tomo seguido por e co a a um limite contendo dois inteiros i e j casa com uma seqquncia de i at j e e (inclusive) combinaes de tomos. co a Ambos os argumentos devem estar na faixa de 0 ate RE_DUP_MAX (padro a e 255), inclusive. Se houver dois argumentos, o segundo deve ser maior ou igual ao primeiro. [a-dX] [^a-dX] Combina com qualquer caracter que seja (ou no, se ^ usado) a, b, c, d a e ou X. Para incluir um caracter literal ], ele deve ser imediatamente seguido pelo colchete de abertura [. Para incluir um caracter literal -, ele deve ser escrito primeiro ou por ultimo. Assim o [0-9] encontra qualquer d igito decimal. Qualquer caracter que no tenha um signicado denido dentro de um para [] a no tem nenhum signicado especial e combina apenas com ele mesmo. a mysql> mysql> mysql> mysql> mysql> mysql> SELECT SELECT SELECT SELECT SELECT SELECT "aXbc" REGEXP "[a-dXYZ]"; "aXbc" REGEXP "^[a-dXYZ]$"; "aXbc" REGEXP "^[a-dXYZ]+$"; "aXbc" REGEXP "^[^a-dXYZ]+$"; "gheis" REGEXP "^[^a-dXYZ]+$"; "gheisa" REGEXP "^[^a-dXYZ]+$"; -> -> -> -> -> -> 1 0 1 0 1 0

[[.caracter.]] A sequncia de caracteres daquele elemento ordenado. A sequncia um unico e e e elemento da lista de expresses entre colchetes. Um expresso entre colchetes o a contendo um elemento ordenado multi-caracter pode ento combinar com mais a

Apndice G: Sintaxe de Expresses Regulares do MySQL e o

1095

de um caracter, por exemplo, se a sequncia ordenada inclui um elemento ore denado ch, ento a expreso regular [[.ch.]]*c casa com os primeiros cinco a a caracteres de chchcc. [=classe_caracter=] Uma classe equivalente, procura pela sequncia de caracteres de todos elementos e ordenados equivalentes `quele, incluindo ele mesmo. a Por exemplo, se o e (+) so os membros de uma classe equivalente, ento a a [[=o=]], [[=(+)=]] e [o(+)] so todos sinnimos. Uma classe equivalente a o no pode ser o nal de uma escala. a [:character_class:] Dentro de colchets, o nome de uma classe de caracter entre [: e :] procura pela lista de todos os caracteres pertencentes a esta classe. Os nomes de classes de caracteres padres so: o a Nome Nome Nome alnum digit punct alpha graph space blank lower upper cntrl print xdigit Ele procura pelas classes de caracteres denidas na pgina ctype(3) do manual. a Um local pode forncer outros. Uma classe de caracter no pode ser usada como a o nal de uma escala. mysql> SELECT "justalnums" REGEXP "[[:alnum:]]+"; -> 1 mysql> SELECT "!!" REGEXP "[[:alnum:]]+"; -> 0 [[:<:]] [[:>:]] Combina com a string null no inicio e no m de uma palavra, respectivamente. Uma palavra denida como uma sequencia de caracteres de palavra os quais e no so nem precedido e nem seguidos por caracteres de palavras. Um caracter a a de palavra um caracter alfa numrico (como denido por ctype(3)) ou um e e underscore (_). mysql> SELECT "a word a" REGEXP "[[:<:]]word[[:>:]]"; -> 1 mysql> SELECT "a xword a" REGEXP "[[:<:]]word[[:>:]]"; -> 0 mysql> SELECT "weeknights" REGEXP "^(wee|week)(knights|nights)$"; -> 1

1096

MySQL Technical Reference for Version 5.0.0-alpha

Apndice H GPL - Licena P blica Geral do e c u GNU

Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Preamble
The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free softwareto make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundations software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) oer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each authors protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modied by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reect on the original authors reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in eect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyones free use or not licensed at all. The precise terms and conditions for copying, distribution and modication follow.

Apndice H: GPL - Licena Pblica Geral do GNU e c u

1097

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The Program, below, refers to any such program or work, and a work based on the Program means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modications and/or translated into another language. (Hereinafter, translation is included without limitation in the term modication.) Each licensee is addressed as you. Activities other than copying, distribution and modication are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Programs source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option oer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a. You must cause the modied les to carry prominent notices stating that you changed the les and the date of any change. b. You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c. If the modied program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modied work as a whole. If identiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions

1098

MySQL Technical Reference for Version 5.0.0-alpha

for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a. Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b. Accompany it with a written oer, valid for at least three years, to give any thirdparty, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c. Accompany it with the information you received as to the oer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an oer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface denition les, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by oering access to copy from a designated place, then oering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you

Apndice H: GPL - Licena Pblica Geral do GNU e c u

1099

indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may dier in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program species a version number of this License which applies to it and any later version, you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.

1100

MySQL Technical Reference for Version 5.0.0-alpha

10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are dierent, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.

NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

END OF TERMS AND CONDITIONS

Apndice H: GPL - Licena Pblica Geral do GNU e c u

1101

How to Apply These Terms to Your New Programs

If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source le to most eectively convey the exclusion of warranty; and each le should have at least the copyright line and a pointer to where the full notice is found.
one line to give the programs name and a brief idea of what it does. Copyright (C) yyyy name of author This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) 19yy name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type show w. This is free software, and you are welcome to redistribute it under certain conditions; type show c for details.

The hypothetical commands show w and show c should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than show w and show c; they could even be mouse-clicks or menu itemswhatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a copyright disclaimer for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program Gnomovision (which makes passes at compilers) written by James Hacker. signature of Ty Coon, 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License.

1102

MySQL Technical Reference for Version 5.0.0-alpha

Indices dos Comandos, Tipos e Funoes SQL c

!
! (NOT logico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 != (diferente) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

<
< (menor que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . << . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . << (deslocamento a esquerda) . . . . . . . . . . . . . . <= (menor que ou igual) . . . . . . . . . . . . . . . . . . . . <=> (Igual a) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . <> (diferente) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 201 546 506 506 506

"
" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

%
% (meta caracter). . . . . . . . . . . . . . . . . . . . . . . . . . 469 % (modulo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523

=
= (igual) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505

> &
& (operado binrio AND) . . . . . . . . . . . . . . . . . . . 546 a && (AND lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 o > (maior que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 >= (maior que ou igual) . . . . . . . . . . . . . . . . . . . . 506 >> (deslocamento a direita) . . . . . . . . . . . . . . . 546

(
() (parenteses) . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 (Control-Z) \z . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

^
^ (operado binrio XOR) . . . . . . . . . . . . . . . . . . . 546 a

*
* (multiplica~o) . . . . . . . . . . . . . . . . . . . . . . . . . 522 ca

_ (meta caracter). . . . . . . . . . . . . . . . . . . . . . . . . . 469

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

+
+ (adi~o) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 ca

\
\" \ \\ \0 \b \n \r \t \z (aspas duplas). . . . . . . . . . . . . . . . . . . . . . . . . . (aspas simples) . . . . . . . . . . . . . . . . . . . . . . . . (escape) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . (ASCII 0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . (backspace) . . . . . . . . . . . . . . . . . . . . . . . . . . . . (nova linha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . (retorno de carro) . . . . . . . . . . . . . . . . . . . . . . (tab) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . (Control-Z) ASCII(26) . . . . . . . . . . . . . . . . . . 469 469 469 469 469 469 469 469 469

- (menos unrio) . . . . . . . . . . . . . . . . . . . . . . . . . . . a - (subtraao) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . c~ -p op~es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . co -password op~es . . . . . . . . . . . . . . . . . . . . . . . . . . co 523 522 267 267

.
.my.cnf file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 .mysql_history, arquivo . . . . . . . . . . . . . . . . . . . 345 .pid (process ID), arquivo . . . . . . . . . . . . . . . . 292

|
| (operador binrio OR) . . . . . . . . . . . . . . . . . . . 546 a || (OR lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 o

/
/ (divis~o) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 a /etc/passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 /etc/passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566

~
~ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546

 Indices dos Comandos, Tipos e Funes SQL co

1103

A
ABS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACOS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADDDATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADDTIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . adi~o (+) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ca AES_DECRYPT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AES_ENCRYPT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ALTER COLUMN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ALTER FUNCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . ALTER PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . . ALTER TABLE . . . . . . . . . . . . . . . . . . . . . . . 608, 610, ANALYZE TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AND lgico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . o AND, operado binrio . . . . . . . . . . . . . . . . . . . . . . a Area() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753, aritimticas, fun~es . . . . . . . . . . . . . . . . . . . . . e co ARQUIVO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . arquivo .my.cnf . . . . . 135, 216, 218, 239, 253, AS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563, AsBinary() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ASCII() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ASIN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . aspas duplas (\"). . . . . . . . . . . . . . . . . . . . . . . . . . aspas em identificadores . . . . . . . . . . . . . . . . . . aspas simples (\) . . . . . . . . . . . . . . . . . . . . . . . . AsText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ATAN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ATAN2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AUTO_INCREMENT, usando com DBI . . . . . . . . . . . . AVG() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 526 536 536 522 549 549 933 610 766 766 938 298 509 546 754 546 515 267 567 748 512 526 469 472 469 748 526 526 886 556

BOOLEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 Boundary() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 Buffer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755

C
C:\my.cnf file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 CALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 CASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510, 772 CAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 CC variveis de ambiente . . . . . . . . . . . . . . . . . . . 98 a CC, varivel de ambiente . . . . . . . . . . . . . 105, 1092 a CEILING() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 Centroid() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754 CFLAGS, varivel de ambiente . . . . . . . . 105, 1092 a CHANGE MASTER TO . . . . . . . . . . . . . . . . . . . . . . . . . . . 402 CHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485, 496 CHAR VARYING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 CHAR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 CHAR_LENGTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 CHARACTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 CHARACTER VARYING . . . . . . . . . . . . . . . . . . . . . . . . . 486 CHARACTER_LENGTH() . . . . . . . . . . . . . . . . . . . . . . . . 516 CHECK TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 CHECKSUM TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 ChopBlanks, mtodo DBI . . . . . . . . . . . . . . . . . . . . 885 e CLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771 COALESCE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 coer~o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521 ca Comentrio sintaxe . . . . . . . . . . . . . . . . . . . . . . . . 479 a COMMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46, 615 compara~o, operadores de . . . . . . . . . . . . . . . . . 504 ca COMPRESS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550 CONCAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 CONCAT_WS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 connect(), mtodo DBI . . . . . . . . . . . . . . . . . . . . . 882 e CONNECTION_ID() . . . . . . . . . . . . . . . . . . . . . . . . . . . 552 Contains() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 CONV() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 CONVERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 ConvexHull() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 COS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 COT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 COUNT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 COUNT(DISTINCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 CRC32() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 CREATE DATABASE . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 CREATE FUNCTION . . . . . . . . . . . . . . . . . . . . . . . 764, 900 CREATE INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613 CREATE PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . 764 CREATE TABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598 CROSS JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 Crosses() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 CSS, variavel de ambiente . . . . . . . . . . . . . . . . . 104 CURDATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 CURRENT_DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 CURRENT_TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 CURRENT_TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . 541

B
backspace (\b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . BACKUP TABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BdMPolyFromText() . . . . . . . . . . . . . . . . . . . . . . . . . BdMPolyFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . BdPolyFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . BdPolyFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . BEGIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615, BENCHMARK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BETWEEN ... AND . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIGINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . binrias, fun~es . . . . . . . . . . . . . . . . . . . . . . . . . a co BINARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482, BIT_AND() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_COUNT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_LENGTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_OR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_OR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIT_XOR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BLOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486, BOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482, 469 277 743 744 743 744 767 553 507 482 512 546 521 486 558 201 546 512 201 558 558 498 486

1104

MySQL Technical Reference for Version 5.0.0-alpha

CURRENT_USER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 CURTIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 CXX varveis de ambiente . . . . . . . . . . . . . . . . . . . 98 a CXX, varivel de ambiente . . . . . . . . . . . . 105, 1092 a CXXFLAGS environment variable . . . . . . . . . . . . . . 99 CXXFLAGS, varveis de ambiente . . . . . . . . . . . . . 99 a CXXFLAGS, variavel de ambiente . . . . . . . . . . . . 105 CXXFLAGS, varivel de ambiente . . . . . . . . . . . 1092 a

D
data e hora, fun~es de . . . . . . . . . . . . . . . . . . . . 529 co data_sources(), mtodo DBI . . . . . . . . . . . . . . . . 885 e Database information, obtaining . . . . . . . . . . 302 DATABASE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484, 491, 931 DATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 DATE_ADD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 DATE_FORMAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 DATE_SUB() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 DATEDIFF() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 DATETIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484, 491 DAY() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 DAYNAME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 DAYOFMONTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 DAYOFWEEK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 DAYOFYEAR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 DBI->{ChopBlanks} . . . . . . . . . . . . . . . . . . . . . . . . . 885 DBI->{is_blob} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886 DBI->{is_key} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886 DBI->{is_not_null} . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->{is_num} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886 DBI->{is_pri_key} . . . . . . . . . . . . . . . . . . . . . . . . . 886 DBI->{length} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->{max_length} . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->{mysql_insertid} . . . . . . . . . . . . . . . . . . . . 886 DBI->{NAME} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->{NULLABLE} . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 DBI->{NUM_OF_FIELDS}. . . . . . . . . . . . . . . . . . . . . . 885 DBI->{table} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->{type} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBI->connect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882 DBI->data_sources() . . . . . . . . . . . . . . . . . . . . . . . 885 DBI->disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . 883 DBI->do() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 DBI->execute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 DBI->fetchall_arrayref . . . . . . . . . . . . . . . . . . . 885 DBI->fetchrow_array . . . . . . . . . . . . . . . . . . . . . . . 884 DBI->fetchrow_arrayref . . . . . . . . . . . . . . . . . . . 884 DBI->fetchrow_hashref . . . . . . . . . . . . . . . . . . . . 884 DBI->finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 DBI->prepare() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883 DBI->quote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 DBI->quote() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 DBI->rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 DBI->trace . . . . . . . . . . . . . . . . . . . . . . . . . . . 885, 1082 DBI_TRACE, varivel de ambiente . . . . . . . . . . . 886 a DBI_TRACE, varivel de ambiente . . . . 1082, 1092 a

DBI_USER, varivel de ambiente . . . . . . . . . . . 1092 a DEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 DECIMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 DECLARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 DECODE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 DEGREES() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 DELAYED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582 DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 DES_DECRYPT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550 DES_ENCRYPT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549 DESC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 DESCRIBE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192, 614 diferente (!=) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 diferente (<>) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 Difference() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 Dimension() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749 disconnect, mtodo DBI . . . . . . . . . . . . . . . . . . . . 883 e Disjoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 Distance() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 DISTINCT . . . . . . . . . . . . . . . . . . . . . . . . . . 180, 434, 556 DIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 diversas, fun~es . . . . . . . . . . . . . . . . . . . . . . . . . 547 co divis~o (/) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 a DO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 do(), mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 e DOUBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 DOUBLE PRECISION . . . . . . . . . . . . . . . . . . . . . . . . . . 484 DROP DATABASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 DROP FUNCTION . . . . . . . . . . . . . . . . . . . . . . . . . 766, 900 DROP INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610, 614 DROP PRIMARY KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 DROP PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766 DROP TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 DROP USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 DUMPFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

E
ELT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 ENCODE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 ENCRYPT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 EndPoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 ENUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487, 499 Envelope() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749 environment variable, CXXFLAGS . . . . . . . . . . . . . 99 Environment variable, LD_RUN_PATH . . . . . . . . 166 Equals() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 escape (\\) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 execute, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . 884 e EXP() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 EXPLAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 EXPORT_SET() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 ExteriorRing() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753 EXTRACT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

 Indices dos Comandos, Tipos e Funes SQL co

1105

F
FALSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FETCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fetchall_arrayref, mtodo DBI . . . . . . . . . . . . . e fetchrow_array, mtodo DBI . . . . . . . . . . . . . . . . e fetchrow_arrayref, mtodo DBI . . . . . . . . . . . . . e fetchrow_hashref, mtodo DBI . . . . . . . . . . . . . . e FIELD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_IN_SET() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . finish, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . e FIXED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FLOAT(M,D) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FLOAT(precis~o) . . . . . . . . . . . . . . . . . . . . . . 483, a FLOOR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FLUSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fluxo de controle, fun~es . . . . . . . . . . . . . . . . co FORCE INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . 563, FORMAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FOUND_ROWS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FROM_DAYS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FROM_UNIXTIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . fun~es de data e hora . . . . . . . . . . . . . . . . . . . . . co fun~es de fluxo de controle . . . . . . . . . . . . . . co fun~es definidas pelo usurio . . . . . . . . . . . . co a fun~es matematicas . . . . . . . . . . . . . . . . . . . . . . . co fun~es string . . . . . . . . . . . . . . . . . . . . . . . . . . . . co fun~es, aritimticas . . . . . . . . . . . . . . . . . . . . . co e fun~es, binrias . . . . . . . . . . . . . . . . . . . . . . . . . co a fun~es, diversas . . . . . . . . . . . . . . . . . . . . . . . . . co fun~es, GROUP BY. . . . . . . . . . . . . . . . . . . . . . . . . . co functions de compara~o de string . . . . . . . . . ca 471 771 885 884 884 884 513 515 514 885 484 483 483 484 523 299 510 568 552 554 563 537 542 529 510 900 523 512 546 546 547 556 519

GROUP BY, fun~es. . . . . . . . . . . . . . . . . . . . . . . . . . 556 co GROUP_CONCAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

H
HANDLER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595 HEX() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 HOME varivel de ambiente . . . . . . . . . . . . . . . . . 345 a HOME, varivel de ambiente . . . . . . . . . . . . . . . 1092 a host.frm, problemas encontrando . . . . . . . . . . 112 HOUR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533

I
identificadores, aspas . . . . . . . . . . . . . . . . . . . . IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IF() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IFNULL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IGNORE INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . 563, IGNORE KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563, igual (=) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INET_ATON() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INET_NTOA() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INNER JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438, INSERT ... SELECT. . . . . . . . . . . . . . . . . . . . . . . . . . INSERT DELAYED . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSERT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSERT, cooncess~o de privilgios com a e instru~es . . . . . . . . . . . . . . . . . . . . . . . . . . . . co INSTR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . instru~es GRANT . . . . . . . . . . . . . . . . . . . . . . . . . . co instru~es INSERT . . . . . . . . . . . . . . . . . . . . . . . . . co INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INTEGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . InteriorRingN() . . . . . . . . . . . . . . . . . . . . . . . . . . . Intersection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intersects() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INTERVAL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IS NOT NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IS NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434, IS NULL, e ndices . . . . . . . . . . . . . . . . . . . . . . . . . i is_blob, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . e IS_FREE_LOCK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . is_key, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . e is_not_null, mtodo DBI . . . . . . . . . . . . . . . . . . . e is_num, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . e is_pri_key, mtodo DBI . . . . . . . . . . . . . . . . . . . . e IsClosed() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751, IsEmpty() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ISNULL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ISOLATION LEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . IsRing() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IsSimple() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ITERATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 771 510 511 568 569 505 507 554 554 567 579 581 582 514 262 514 261 262 482 482 753 755 757 508 506 506 449 886 553 886 887 886 886 752 750 507 619 752 750 773

G
GeomCollFromText() . . . . . . . . . . . . . . . . . . . . . . . . GeomCollFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . GEOMETRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GEOMETRYCOLLECTION . . . . . . . . . . . . . . . . . . . . . . . . GeometryCollection(). . . . . . . . . . . . . . . . . . . . . . GeometryCollectionFromText() . . . . . . . . . . . . . GeometryCollectionFromWKB() . . . . . . . . . . . . . . GeometryFromText() . . . . . . . . . . . . . . . . . . . . . . . . GeometryFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . GeometryN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GeometryType() . . . . . . . . . . . . . . . . . . . . . . . . . . . . GeomFromText(). . . . . . . . . . . . . . . . . . . . . . . . 742, GeomFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . 743, GET_FORMAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_LOCK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GLength() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751, GRANT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GRANT, instru~o . . . . . . . . . . . . . . . . . . . . . . . . . . ca GRANT, instru~es . . . . . . . . . . . . . . . . . . . . . . . . . co GRANTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GREATEST() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 744 742 742 745 743 744 742 743 754 749 748 748 539 553 752 254 273 261 322 528

1106

MySQL Technical Reference for Version 5.0.0-alpha

J
JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

M
maior que (>) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . maior que ou igual (>=) . . . . . . . . . . . . . . . . . . . . MAKE_SET() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MAKEDATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MAKETIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MASTER_POS_WAIT() . . . . . . . . . . . . . . . . . . . . 405, MATCH ... AGAINST() . . . . . . . . . . . . . . . . . . . . . . . matematicas, fun~es . . . . . . . . . . . . . . . . . . . . . . co MAX() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . max_length, mtodo DBI . . . . . . . . . . . . . . . . . . . . e MBRContains() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MBRDisjoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MBREqual() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MBRIntersects() . . . . . . . . . . . . . . . . . . . . . . . . . . . MBROverlaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MBRTouches() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MBRWithin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MD5() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MEDIUMBLOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MEDIUMINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MEDIUMTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . menor que (<) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . menor que ou igual (<=) . . . . . . . . . . . . . . . . . . . . menos unrio (-) . . . . . . . . . . . . . . . . . . . . . . . . . . . a Meta caracter (%). . . . . . . . . . . . . . . . . . . . . . . . . . Meta caracter (_). . . . . . . . . . . . . . . . . . . . . . . . . . MICROSECOND() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MID() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MIN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MINUTE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MLineFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . . MOD (modulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MOD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . modulo (%) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . modulo (MOD). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MONTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MONTHNAME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MPointFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . MPointFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . MPolyFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . . MPolyFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . . MULTILINESTRING . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiLineString() . . . . . . . . . . . . . . . . . . . . . . . . . MultiLineStringFromText() . . . . . . . . . . . . . . . . multiplica~o (*) . . . . . . . . . . . . . . . . . . . . . . . . . ca MULTIPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiPoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiPointFromText(). . . . . . . . . . . . . . . . . . . . . . MultiPointFromWKB() . . . . . . . . . . . . . . . . . . . . . . . MULTIPOLYGON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiPolygon() . . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiPolygonFromText() . . . . . . . . . . . . . . . . . . . MultiPolygonFromWKB() . . . . . . . . . . . . . . . . . . . . my_init() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . my_ulonglong, imprimindo valores . . . . . . . . . my_ulonglong, tipo C . . . . . . . . . . . . . . . . . . . . . . MySQL C type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 506 516 541 541 554 521 523 556 887 756 756 756 756 757 757 756 548 486 482 486 506 506 523 469 469 533 516 556 533 743 523 523 523 523 531 531 743 744 743 744 742 745 743 522 742 745 743 744 742 745 743 744 858 776 776 830

K
KILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

L
LAST_DAY() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540 LAST_INSERT_ID() . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 LAST_INSERT_ID([expr]) . . . . . . . . . . . . . . . . . . . 551 LCASE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 LD_RUN_PATH environment variable . . . . . . . . . 166 LD_RUN_PATH variveis de ambiente . . . . . . . . . 147 a LD_RUN_PATH, varivel de ambiente . . . 140, 1092 a LEAST() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 LEAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772 LEFT JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435, 567 LEFT OUTER JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 LEFT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 LENGTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 length, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . 887 e LIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 LIKE, e ndices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 i LIKE, e meta caracteres . . . . . . . . . . . . . . . . . . . 448 LIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437, 554 LineFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 LineFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744 LINESTRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 LineString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745 LineStringFromText(). . . . . . . . . . . . . . . . . . . . . . 743 LineStringFromWKB() . . . . . . . . . . . . . . . . . . . . . . . 744 LN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 LOAD DATA FROM MASTER . . . . . . . . . . . . . . . . . . . . . . 404 LOAD DATA INFILE . . . . . . . . . . . . . . . . . . . . . . 588, 932 LOAD TABLE FROM MASTER . . . . . . . . . . . . . . . . . . . . 405 LOAD_FILE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 LOCALTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 LOCALTIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 LOCATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 LOCK TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 LOG() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525 LOG10() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525 LOG2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525 logico, operadores . . . . . . . . . . . . . . . . . . . . . . . . 508 LONG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 LONGBLOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 LONGTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 LOOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772 LOWER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 LTRIM() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

 Indices dos Comandos, Tipos e Funes SQL co

1107

MYSQL, tipo C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776 mysql_affected_rows() . . . . . . . . . . . . . . . . . . . . 783 mysql_autocommit(). . . . . . . . . . . . . . . . . . . . . . . . 826 MYSQL_BIND, tipo C . . . . . . . . . . . . . . . . . . . . . . . . 828 mysql_bind_param() . . . . . . . . . . . . . . . . . . . . . . . . 836 mysql_bind_result() . . . . . . . . . . . . . . . . . . . . . . . 842 mysql_change_user() . . . . . . . . . . . . . . . . . . . . . . . 784 mysql_character_set_name() . . . . . . . . . . . . . . . 785 mysql_close() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786 mysql_commit(). . . . . . . . . . . . . . . . . . . . . . . . . . . . 825 mysql_connect() . . . . . . . . . . . . . . . . . . . . . . . . . . . 786 mysql_create_db() . . . . . . . . . . . . . . . . . . . . . . . . . 787 mysql_data_seek() . . . . . . . . . . . . . . . . . . . . . . . . . 787 MYSQL_DEBUG varivel de ambiente . . . . . . . . . . 345 a MYSQL_DEBUG varivel de ambiente . . . . . . . . . 1085 a mysql_debug() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788 MYSQL_DEBUG, varivel de ambiente . . . . . . . . 1092 a mysql_drop_db() . . . . . . . . . . . . . . . . . . . . . . . . . . . 788 mysql_dump_debug_info() . . . . . . . . . . . . . . . . . . 789 mysql_eof() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790 mysql_errno() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791 mysql_error() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792 mysql_escape_string() . . . . . . . . . . . . . . . . . . . . 470 mysql_escape_string() . . . . . . . . . . . . . . . . . . . . 793 mysql_execute() . . . . . . . . . . . . . . . . . . . . . . . . . . . 837 mysql_fetch() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846 mysql_fetch_field() . . . . . . . . . . . . . . . . . . . . . . . 793 mysql_fetch_field_direct() . . . . . . . . . . . . . . . 794 mysql_fetch_fields(). . . . . . . . . . . . . . . . . . . . . . 794 mysql_fetch_lengths() . . . . . . . . . . . . . . . . . . . . 795 mysql_fetch_row() . . . . . . . . . . . . . . . . . . . . . . . . . 796 MYSQL_FIELD, tipo C . . . . . . . . . . . . . . . . . . . . . . . 776 mysql_field_count() . . . . . . . . . . . . . . . . . . 797, 807 MYSQL_FIELD_OFFSET, tipo C . . . . . . . . . . . . . . . . 776 mysql_field_seek() . . . . . . . . . . . . . . . . . . . . . . . . 798 mysql_field_tell() . . . . . . . . . . . . . . . . . . . . . . . . 799 mysql_free_result() . . . . . . . . . . . . . . . . . . . . . . . 799 mysql_get_client_info() . . . . . . . . . . . . . . . . . . 800 mysql_get_client_version() . . . . . . . . . . . . . . . 800 mysql_get_host_info() . . . . . . . . . . . . . . . . . . . . 800 mysql_get_metadata. . . . . . . . . . . . . . . . . . . . . . . . 835 mysql_get_proto_info() . . . . . . . . . . . . . . . . . . . 801 mysql_get_server_info() . . . . . . . . . . . . . . . . . . 801 mysql_get_server_version() . . . . . . . . . . . . . . . 801 MYSQL_HISTFILE varivel de ambiente . . . . . . 345 a MYSQL_HISTFILE, varivel de ambiente . . . . 1092 a MYSQL_HOST, varivel de ambiemte . . . . . . . . . . 239 a MYSQL_HOST, varivel de ambiente . . . . . . . . . 1092 a mysql_info() . . . . . . . . . . . . . . . . . 581, 584, 595, 610 mysql_info() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 mysql_init() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803 mysql_insert_id() . . . . . . . . . . . . . . . . . . . . . . . . . . 49 mysql_insert_id() . . . . . . . . . . . . . . . . . . . . . . . . . 803 mysql_insertid DBI, atrinuto . . . . . . . . . . . . . . 886 mysql_kill() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 804 mysql_list_dbs() . . . . . . . . . . . . . . . . . . . . . . . . . . 804 mysql_list_fields() . . . . . . . . . . . . . . . . . . . . . . . 805 mysql_list_processes() . . . . . . . . . . . . . . . . . . . 806

mysql_list_tables() . . . . . . . . . . . . . . . . . . . . . . . 806 mysql_more_results(). . . . . . . . . . . . . . . . . . . . . 826 mysql_next_result().. . . . . . . . . . . . . . . . . . . . . . 827 mysql_num_fields() . . . . . . . . . . . . . . . . . . . . . . . . 807 mysql_num_rows() . . . . . . . . . . . . . . . . . . . . . . . . . . 808 mysql_options() . . . . . . . . . . . . . . . . . . . . . . . . . . . 809 mysql_param_count() . . . . . . . . . . . . . . . . . . . . . . . 835 mysql_ping() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811 mysql_prepare() . . . . . . . . . . . . . . . . . . . . . . . . . . . 834 MYSQL_PS1, varivel de ambiente . . . . . . . . . . 1092 a MYSQL_PWD varivel de ambiente . . . . . . . . . . . . 345 a MYSQL_PWD, varivel de ambiente . . . . . . . . . . . 239 a MYSQL_PWD, varivel de ambiente . . . . . . . . . . 1092 a mysql_query() . . . . . . . . . . . . . . . . . . . . . . . . . 812, 861 mysql_real_connect(). . . . . . . . . . . . . . . . . . . . . . 813 mysql_real_escape_string() . . . . . . . . . . . . . . . 815 mysql_real_query() . . . . . . . . . . . . . . . . . . . . . . . . 816 mysql_reload() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817 MYSQL_RES, tipo C. . . . . . . . . . . . . . . . . . . . . . . . . . 776 mysql_rollback(). . . . . . . . . . . . . . . . . . . . . . . . . . 826 MYSQL_ROW, tipo C. . . . . . . . . . . . . . . . . . . . . . . . . . 776 mysql_row_seek() . . . . . . . . . . . . . . . . . . . . . . . . . . 818 mysql_row_tell() . . . . . . . . . . . . . . . . . . . . . . . . . . 818 mysql_select_db() . . . . . . . . . . . . . . . . . . . . . . . . . 819 mysql_send_long_data(). . . . . . . . . . . . . . . . . . . 851 mysql_server_end() . . . . . . . . . . . . . . . . . . . . . . . . 860 mysql_server_init() . . . . . . . . . . . . . . . . . . . . . . . 859 mysql_set_sever_option() . . . . . . . . . . . . . . . . . 819 mysql_shutdown() . . . . . . . . . . . . . . . . . . . . . . . . . . 820 mysql_sqlstate() . . . . . . . . . . . . . . . . . . . . . . . . . . 820 mysql_ssl_set() . . . . . . . . . . . . . . . . . . . . . . . . . . . 821 mysql_stat() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822 MYSQL_STMT, tipo C . . . . . . . . . . . . . . . . . . . . . . . . 828 mysql_stmt_affected_rows() . . . . . . . . . . . . . . . 842 mysql_stmt_close() . . . . . . . . . . . . . . . . . . . . . . . . 853 mysql_stmt_data_seek() . . . . . . . . . . . . . . . . . . . 844 mysql_stmt_errno() . . . . . . . . . . . . . . . . . . . . . . . . 854 mysql_stmt_error(). . . . . . . . . . . . . . . . . . . . . . . . 854 mysql_stmt_num_rows() . . . . . . . . . . . . . . . . . . . . 845 mysql_stmt_row_seek() . . . . . . . . . . . . . . . . . . . . 844 mysql_stmt_row_tell() . . . . . . . . . . . . . . . . . . . . 845 mysql_stmt_sqlstate() . . . . . . . . . . . . . . . . . . . . 855 mysql_stmt_store_result() . . . . . . . . . . . . . . . . 843 mysql_store_result() . . . . . . . . . . . . . . . . . 822, 861 MYSQL_TCP_PORT varivel de ambiente . . . . . . 345 a MYSQL_TCP_PORT, variavel de ambiente . . . . . 225 MYSQL_TCP_PORT, varivel de ambiente . . . . 1092 a mysql_thread_end() . . . . . . . . . . . . . . . . . . . . . . . . 858 mysql_thread_id() . . . . . . . . . . . . . . . . . . . . . . . . . 823 mysql_thread_init() . . . . . . . . . . . . . . . . . . . . . . . 858 mysql_thread_safe() . . . . . . . . . . . . . . . . . . . . . . . 859 MYSQL_UNIX_PORT varivel de ambiente . . . . . 345 a MYSQL_UNIX_PORT, varivel de ambiente . . . . 116 a MYSQL_UNIX_PORT, variavel de ambiente . . . . 225 MYSQL_UNIX_PORT, varivel de ambiente . . . 1092 a mysql_use_result() . . . . . . . . . . . . . . . . . . . . . . . . 824 mysql_warning_count(). . . . . . . . . . . . . . . . . . . . 825

1108

MySQL Technical Reference for Version 5.0.0-alpha

N
NAME, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . . . . e NATIONAL CHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NATURAL LEFT JOIN. . . . . . . . . . . . . . . . . . . . . . . . . . NATURAL LEFT OUTER JOIN . . . . . . . . . . . . . . . . . . . NATURAL RIGHT JOIN . . . . . . . . . . . . . . . . . . . . . . . . NATURAL RIGHT OUTER JOIN . . . . . . . . . . . . . . . . . . NCHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOT BETWEEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOT IN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOT LIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOT logico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOT REGEXP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . nova linha (\n) . . . . . . . . . . . . . . . . . . . . . . . . . . . . NOW() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NUL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185, NULL, valor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NULLABLE, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . e NULLIF() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NUM_OF_FIELDS, mtodo DBI . . . . . . . . . . . . . . . . . e NUMERIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NumGeometries() . . . . . . . . . . . . . . . . . . . . . . . . . . . NumInteriorRings() . . . . . . . . . . . . . . . . . . . . . . . . NumPoints() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 485 567 567 567 567 485 507 507 520 508 521 469 541 469 932 472 885 511 885 484 754 753 751

PointOnSurface() . . . . . . . . . . . . . . . . . . . . . . . . . . PolyFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . PolyFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POLYGON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Polygon() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PolygonFromText() . . . . . . . . . . . . . . . . . . . . . . . . . PolygonFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . POSITION() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POW() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POWER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . prepare(), mtodo DBI . . . . . . . . . . . . . . . . . . . . . e PRIMARY KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . 602, PROCESSLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PURGE MASTER LOGS. . . . . . . . . . . . . . . . . . . . . . . . . .

754 743 744 742 745 743 744 517 525 525 883 610 320 400

Q
QUARTER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 QUOTE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 quote(), mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . 884 e

R
RADIANS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 RAND() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 REAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 ref_or_null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 REGEXP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 Related() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 RELEASE_LOCK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553 RENAME TABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 REPAIR TABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 REPEAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 REPLACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 REPLACE ... SELECT . . . . . . . . . . . . . . . . . . . . . . . . 581 REPLACE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 REQUIRE GRANT, op~es . . . . . . . . . . . . . . . . . . . . . 273 co RESET MASTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 RESET SLAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 RESTORE TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 restri~es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 co retorno (\r). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 retorno de carro (\r) . . . . . . . . . . . . . . . . . . . . . . 469 REVERSE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 REVOKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 RIGHT JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 RIGHT OUTER JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 RIGHT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 RLIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 ROLLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46, 615 ROLLBACK TO SAVEPOINT . . . . . . . . . . . . . . . . . . . . . 616 ROLLUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558 ROUND() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 rows, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 e RPAD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 RTRIM() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

O
OCT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 OCTET_LENGTH() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 OLD_PASSWORD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 op~es de configura~o, --with-charset . . . . 99 co ca op~es de configura~o, --with-extra-charset co ca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 op~es de linha de comando . . . . . . . . . . . . . . . . . 207 co OPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771 operadores logicos . . . . . . . . . . . . . . . . . . . . . . . . 508 OPTIMIZE TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 OR logico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 OR, operador binrio . . . . . . . . . . . . . . . . . . . . . . 546 a ORD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 ORDER BY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 Overlaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757

P
parenteses ( e ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 PASSWORD() . . . . . . . . . . . . . . . . . . . 240, 266, 547, 920 PATH, variavel de ambiente . . . . . . . . . . . . . . . . . 93 PATH, varivel de ambiente . . . . . . . . . . . . . . . 1092 a PERIOD_ADD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 PERIOD_DIFF() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 PI() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 POINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 Point() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745 PointFromText() . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 PointFromWKB() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744 PointN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752

 Indices dos Comandos, Tipos e Funes SQL co

1109

S
SAVEPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616 SEC_TO_TIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 SECOND() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 SELECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 SELECT INTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768 SELECT INTO TABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 SELECT, otimizando . . . . . . . . . . . . . . . . . . . . . . . . 424 SELECT, velocidade do . . . . . . . . . . . . . . . . . . . . . 431 SESSION_USER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 SET . . . . . . . . . . . . . . . . . . . . . . . . . . 460, 487, 500, 768 SET GLOBAL SQL_SLAVE_SKIP_COUNTER . . . . . . . . 405 SET OPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 SET PASSWORD, instru~es . . . . . . . . . . . . . . . . . . 266 co SET SQL_LOG_BIN . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 SET TRANSACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 SHA() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 SHA1() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 SHOW BINLOG EVENTS . . . . . . . . . . . . . . . . . . . . . . . . 401 SHOW COLUMNS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW CREATE FUNCTION . . . . . . . . . . . . . . . . . . . . . . 767 SHOW CREATE PROCEDURE . . . . . . . . . . . . . . . . . . . . . 767 SHOW CREATE TABLE . . . . . . . . . . . . . . . . . . . . . 302, 322 SHOW DATABASES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW FIELDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW FUNCTION STATUS . . . . . . . . . . . . . . . . . . . . . . 767 SHOW GRANTS . . . . . . . . . . . . . . . . . . . . . . . . . . . 302, 322 SHOW INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW KEYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW MASTER LOGS . . . . . . . . . . . . . . . . . . . . . . 302, 401 SHOW MASTER STATUS . . . . . . . . . . . . . . . . . . . . 302, 401 SHOW PRIVILEGES . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 SHOW PROCEDURE STATUS . . . . . . . . . . . . . . . . . . . . . 767 SHOW PROCESSLIST . . . . . . . . . . . . . . . . . . . . . . 302, 320 SHOW SLAVE HOSTS . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 SHOW SLAVE STATUS . . . . . . . . . . . . . . . . . . . . . 302, 406 SHOW STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW TABLE STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW TABLE TYPES . . . . . . . . . . . . . . . . . . . . . . 302, 324 SHOW TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW VARIABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SHOW WARNINGS . . . . . . . . . . . . . . . . . . . . . . . . . 302, 323 SIGN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 SIN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 SMALLINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 SOUNDEX() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518 SOUNDS LIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 SPACE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518 SQL_CACHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628 SQL_NO_CACHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628 SQRT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525 SRID() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749 START SLAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 START TRANSACTION . . . . . . . . . . . . . . . . . . . . . . . . . 615 StartPoint() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 STD() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558 STDDEV() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558 STOP SLAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

STR_TO_DATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . STRAIGHT_JOIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . STRCMP() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . string, fun~es . . . . . . . . . . . . . . . . . . . . . . . . . . . co string, fun~es de compara~o de . . . . . . . . . . co ca SUBDATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SUBSTRING() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SUBSTRING_INDEX() . . . . . . . . . . . . . . . . . . . . . . . . . SUBTIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . subtra~o (-) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ca SUM() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SymDifference() . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSDATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM_USER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

539 567 521 512 519 540 518 518 540 522 557 755 541 547

T
tab (\t) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 Table scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937 table, mtodo DBI. . . . . . . . . . . . . . . . . . . . . . . . . . 887 e table_cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 TAN() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486, 498 threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485, 495 TIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 TIME_FORMAT() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540 TIME_TO_SEC() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 TIMEDIFF() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484, 491 TIMESTAMP() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 TINYBLOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 TINYINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 TINYTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 Tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 TMPDIR, varivel de ambiente . . . . . . . . 116, 1092 a TO_DAYS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 Touches() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 trace DBI, mtodo. . . . . . . . . . . . . . . . . . . . . . . . . . 885 e trace, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . 1082 e TRIM() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 TRUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 TRUNCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 TRUNCATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 type, mtodo DBI . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 e TZ, varivel de ambiente . . . . . . . . . . . . . 930, 1092 a

U
UCASE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 UDF, fun~es. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900 co ulimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 UMASK, variavel de ambiente . . . . . . . . . . . . . . . 924 UMASK, varivel de ambiente . . . . . . . . . . . . . . 1092 a UMASK_DIR, varivel de ambiente . . . . . 924, 1092 a unrio, menos (-). . . . . . . . . . . . . . . . . . . . . . . . . . 523 a UNCOMPRESS() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551 UNCOMPRESSED_LENGTH() . . . . . . . . . . . . . . . . . . . . 551

1110

MySQL Technical Reference for Version 5.0.0-alpha

uni~o (UNION) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 a UNION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 Union() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 UNIQUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 UNIX_TIMESTAMP() . . . . . . . . . . . . . . . . . . . . . . . . . . 542 UNLOCK TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 UNTIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584 UPPER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 USE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 USE INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563, 568 USE KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563, 569 USER() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 USER, varivel de ambiente . . . . . . . . . . . . . . . . 239 a USER, varivel de ambiente . . . . . . . . . . . . . . . 1092 a usurio, fun~es definidas por . . . . . . . . . . . . 900 a co UTC_DATE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 UTC_TIME() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 UTC_TIMESTAMP() . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

V
vairaveis de ambiente CXXFLAGS . . . . . . . . . . . . . 99 valores hexadecimais . . . . . . . . . . . . . . . . . . . . . . 471 VARCHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486, 496 VARCHARACTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 VARIANCE() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557 variveis de ambiente, CC . . . . . . . . . . . . . . . . . . 98 a variveis de ambiente, CXX . . . . . . . . . . . . . . . . . 98 a Variveis de ambiente, LD_RUN_PATH. . . . . . . . 147 a varivel de ambiente CC . . . . . . . . . . . . . . . . . . . 105 a Varivel de ambiente CC . . . . . . . . . . . . . . . . . . 1092 a varivel de ambiente CFLAGS . . . . . . . . . . . . . . . 105 a Varivel de ambiente CFLAGS . . . . . . . . . . . . . . 1092 a variavel de ambiente CXX . . . . . . . . . . . . . . . . . . 104 varivel de ambiente CXX . . . . . . . . . . . . . . . . . . 105 a Varivel de ambiente CXX . . . . . . . . . . . . . . . . . 1092 a varivel de ambiente CXXFLAGS . . . . . . . . . . . . . 105 a Varivel de ambiente CXXFLAGS . . . . . . . . . . . . 1092 a varivel de ambiente DBI_TRACE . . . . . . . . . . . . 886 a Varivel de ambiente DBI_TRACE . . . . . . . . . . . 1092 a Varivel de ambiente DBI_USER . . . . . . . . . . . . 1092 a Varivel de ambiente HOME . . . . . . . . . . . . . . . . 1092 a varivel de ambiente LD_RUN_PATH . . . . . . . . . . 140 a Varivel de ambiente LD_RUN_PATH . . . . . . . . . 1092 a Varivel de ambiente MYSQL_DEBUG . . . . . . . . . 1092 a Varivel de ambiente MYSQL_HISTFILE . . . . . 1092 a varivel de ambiente MYSQL_HOST . . . . . . . . . . . 239 a Varivel de ambiente MYSQL_HOST . . . . . . . . . . 1092 a

Varivel de ambiente MYSQL_PS1 . . . . . . . . . . . 1092 a varivel de ambiente MYSQL_PWD . . . . . . . . . . . . 239 a Varivel de ambiente MYSQL_PWD . . . . . . . . . . . 1092 a varivel de ambiente MYSQL_TCP_PORT . . . . . . 225 a Varivel de ambiente MYSQL_TCP_PORT . . . . . 1092 a varivel de ambiente MYSQL_UNIX_PORT . . . . . 225 a Varivel de ambiente MYSQL_UNIX_PORT . . . . . 116, a 1092 Varivel de ambiente PATH . . . . . . . . . . . . . . . . 1092 a Varivel de ambiente TMPDIR . . . . . . . . . . 116, 1092 a Varivel de ambiente TZ . . . . . . . . . . . . . . 930, 1092 a Varivel de ambiente UMASK . . . . . . . . . . . 924, 1092 a Varivel de ambiente UMASK_DIR . . . . . . 924, 1092 a varivel de ambiente USER . . . . . . . . . . . . . . . . . 239 a Varivel de ambiente USER . . . . . . . . . . . . . . . . 1092 a varivel de ambiente, DBI_TRACE . . . . . . . . . . 1082 a varivel de ambiente, HOME . . . . . . . . . . . . . . . . 345 a varivel de ambiente, MYSQL_DEBUG . . . . . . . . . 345 a varivel de ambiente, MYSQL_DEBUG . . . . . . . . 1085 a varivel de ambiente, MYSQL_HISTFILE . . . . . 345 a varivel de ambiente, MYSQL_PWD . . . . . . . . . . . 345 a variavel de ambiente, MYSQL_TCP_PORT . . . . . 225 varivel de ambiente, MYSQL_TCP_PORT . . . . . 345 a variavel de ambiente, MYSQL_UNIX_PORT . . . . 225 varivel de ambiente, MYSQL_UNIX_PORT . . . . 345 a varivel de ambiente, PATH . . . . . . . . . . . . . . . . . 93 a VERSION() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552

W
WEEK() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 WEEKDAY() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 WEEKOFYEAR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 WHERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 WHILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774 Within() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 without-server op~o . . . . . . . . . . . . . . . . . . . . . . . 98 ca

X
X() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 XOR, logical. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 XOR, operado binrio . . . . . . . . . . . . . . . . . . . . . . 546 a

Y
Y() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 YEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485, 496 YEAR() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

Concept Index

1111

Concept Index
--with-raid, erros de ligaao . . . . . . . . . . . . . . . . 104 c APIs, lista de . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954 APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775 APIs, Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 aplicando, patches . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 argumentos, processando . . . . . . . . . . . . . . . . . . . . 904 aritimticas, expresses. . . . . . . . . . . . . . . . . . . . . . 522 e o armazenamento de dados . . . . . . . . . . . . . . . . . . . . 446 armazenamento dos tipos de colunas, exigncias e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 arquivo config.cache . . . . . . . . . . . . . . . . . . . . . . . 103 arquivo de opoes . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 c arquivo no encontrado, mensagem . . . . . . . . . . . 924 a arquivo RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 arquivo temporrio, direito de escrita . . . . . . . . . 116 a arquivo texto, importando . . . . . . . . . . . . . . . . . . . 367 arquivo, log de atuliazao . . . . . . . . . . . . . . . . . . 373 ca arquivos de conguraao . . . . . . . . . . . . . . . . . . . . 253 c arquivos de log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 arquivos de log, nomes . . . . . . . . . . . . . . . . . . . . . . 276 arquivos de script . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 arquivos log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Arquivos Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 arquivos my.cnf . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 arquivos tmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 arquivos, config.cache . . . . . . . . . . . . . . . . . . . . . 103 arquivos, limites de tamanho . . . . . . . . . . . . . . . . . 10 arquivos, log binario . . . . . . . . . . . . . . . . . . . . . . . . 374 arquivos, log de consultas . . . . . . . . . . . . . . . . . . . 373 arquivos, log de consultas lentas . . . . . . . . . . . . . 377 arquivos, mensagem de erros . . . . . . . . . . . . . . . . . 327 arquivos, permisses . . . . . . . . . . . . . . . . . . . . . . . . 924 o arquivos, reparando . . . . . . . . . . . . . . . . . . . . . . . . . 284 arredondamento, erros . . . . . . . . . . . . . . . . . . . . . . 529 arredondamento, erros de. . . . . . . . . . . . . . . . . . . . 483 rvores fonte de desenvolvimento . . . . . . . . . . . . . 100 a aspas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 aspas, em string . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 atualizaao, log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 c atualizando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 atualizando da 4.0 para 4.1 . . . . . . . . . . . . . . . . . . 121 atualizando da verso 3.20 para 3.21 . . . . . . . . . 129 a atualizando da verso 3.21 para 3.22 . . . . . . . . . 129 a atualizando da verso 3.22 para 3.23 . . . . . . . . . 127 a atualizando para uma arquitetura diferente . . . 131 atualizando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . 46 atualizando, 3.23 para 4.0 . . . . . . . . . . . . . . . . . . . 123 atualizando, releases do MySQL . . . . . . . . . . . . . . 84 atualizando, tabela de permisses . . . . . . . . . . . . 130 o aumentando a performance . . . . . . . . . . . . . . . . . . 412 aumentando a velocidade . . . . . . . . . . . . . . . . . . . . 378 AUTO-INCREMENT, ODBC . . . . . . . . . . . . . . . 879 AUTO INCREMENT. . . . . . . . . . . . . . . . . . . . . . . 201 AUTO_INCREMENT e valores NULL . . . . . . . . . . . . . . 933

A
abertas, tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 abortados, clientes . . . . . . . . . . . . . . . . . . . . . . . . . . 918 abortados, conexo . . . . . . . . . . . . . . . . . . . . . . . . . 918 a abrindo tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 access denied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912 accesso negado, erro . . . . . . . . . . . . . . . . . . . . . . . . 912 acesso, controle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 acesso, privilgio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 e ACID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 ACID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643 ACLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 ActiveState Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 adicionando conjunto de caracteres . . . . . . . . . . . 327 adicionando funoes nativas . . . . . . . . . . . . . . . . . 908 c adicionando novas funoes . . . . . . . . . . . . . . . . . . . 899 c adicionando novos privilgios de usurios . . . . . 261 e a adicionando novos usurios . . . . . . . . . . . . . . . . . . . 92 a adicionando, funoes denidas por usurio . . . . 900 c a adicionando, procedimentos . . . . . . . . . . . . . . . . . 909 administraao de servidor . . . . . . . . . . . . . . . . . . . 356 c ADO program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 875 agrupando, expresses . . . . . . . . . . . . . . . . . . . . . . . 504 o aliases, em clusulas GROUP BY . . . . . . . . . . . . . . . 562 a aliases, em clusulas ORDER BY . . . . . . . . . . . . . . . 562 a aliases, em expresses . . . . . . . . . . . . . . . . . . . . . . . 563 o aliases, nomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 aliases, para expresses . . . . . . . . . . . . . . . . . . . . . . 562 o aliases, para tabelas . . . . . . . . . . . . . . . . . . . . . . . . . 564 alteraoes de colunas sem aviso . . . . . . . . . . . . . . 607 c alteraoes na verso 4.0 . . . . . . . . . . . . . . . . . . . . . 966 c a alteraoes na verso 4.1 . . . . . . . . . . . . . . . . . . . . . 957 c a alteraoes, log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957 c alteraoes, verso 5.0 . . . . . . . . . . . . . . . . . . . . . . . . 957 c a alterando a localizaao do socket . . . . . . . . 119, 929 c alterando a ordem das colunas . . . . . . . . . . . . . . . 938 alterando a tabela . . . . . . . . . . . . . . . . . . . . . . . . . . 610 alterando campos . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 alterando localizao do socket . . . . . . . . . . . . . . . . 98 ca alterando tabelas . . . . . . . . . . . . . . . . . . . . . . . 608, 938 alterando, colunas . . . . . . . . . . . . . . . . . . . . . . . . . . 610 Ano 2000, assuntos referentes ao . . . . . . . . . . . . . 490 annimo, usurio . . . . . . . . . . . . . . . . . . . . . . . 240, 260 o a anonymous user . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 anonimo, usurio . . . . . . . . . . . . . . . . . . . . . . . . . . 243 o a ANSI modo, executando . . . . . . . . . . . . . . . . . . . . . . 42 Apache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 apagando, usurio . . . . . . . . . . . . . . . . . . . . . . . . . . 264 a API C, funes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778 co API C, problemas com ligaao . . . . . . . . . . . . . . . 862 c

1112

MySQL Technical Reference for Version 5.0.0-alpha

B
backup de banco de dados . . . . . . . . . . . . . . 361, 366 backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 backups, banco de dados . . . . . . . . . . . . . . . . . . . . 277 banco de dados, backups . . . . . . . . . . . . . . . . . . . . 275 banco de dados, criando . . . . . . . . . . . . . . . . . . . . . 172 banco de dados, deletando . . . . . . . . . . . . . . . . . . . 597 banco de dados, descarregando . . . . . . . . . . 361, 366 banco de dados, exibindo . . . . . . . . . . . . . . . . . . . . 369 banco de dados, informaoes sobre . . . . . . . . . . . 192 c banco de dados, links simblicos . . . . . . . . . . . . . 466 o banco de dados, projetos . . . . . . . . . . . . . . . . . . . . 446 banco de dados, replicando . . . . . . . . . . . . . . . . . . 378 banco de dados, selecionando . . . . . . . . . . . . . . . . 173 banco de dados, usando . . . . . . . . . . . . . . . . . . . . . 172 bancos de dados relacionais, deniao . . . . . . . . . . 4 c bancos de dados, nomes . . . . . . . . . . . . . . . . . . . . . 472 barra invertida, caracter de escape . . . . . . . . . . . 469 batch, modo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 batch, mysql option . . . . . . . . . . . . . . . . . . . . . . . . 347 BDB, tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 BDB, tipo de tabela . . . . . . . . . . . . . . . . . . . . . . . . . . 630 benchmark, pacote . . . . . . . . . . . . . . . . . . . . . . . . . . 421 benchmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 BerkeleyDB, tipo de tabela . . . . . . . . . . . . . . . . . . 630 biblioteca do servidor embutido MySQL . . . . . . 864 biblioteca mysqlclient . . . . . . . . . . . . . . . . . . . . . . 775 bibliotecas, lista de . . . . . . . . . . . . . . . . . . . . . . . . . 953 Big5 Chinese, codicaao de caracteres . . . . . . . 930 c binario, log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 BitKeeper, rvores . . . . . . . . . . . . . . . . . . . . . . . . . . 100 a BLOB , valores padres em campos . . . . . . . . . . . . 498 o BLOB, indexando colunas. . . . . . . . . . . . . . . . . . . . . 603 BLOB, inserindo dados binrios . . . . . . . . . . . . . . . 470 a BLOB, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 blocking_queries, opao do mysqlcc option . . 355 c Borland Builder 4 . . . . . . . . . . . . . . . . . . . . . . . . . . 876 Borland C++, compilador . . . . . . . . . . . . . . . . . . . . 888 buer de cliente, tamanho . . . . . . . . . . . . . . . . . . . 775 bugs, banco de dados . . . . . . . . . . . . . . . . . . . . . . . . 36 bugs, conhecidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 bugs, relatando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 bugs.mysql.com . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

C
C API, tipos de dados . . . . . . . . . . . . . . . . . . . . . . 775 C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940 C++ Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 878 C++, APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 C++, compilador gcc . . . . . . . . . . . . . . . . . . . . . . . . . 98 C, funoes de instruoes preparadas da API . . . 831 c c cache de tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 caches, limpando . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 clculo de datas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 a campos, alterando . . . . . . . . . . . . . . . . . . . . . . . . . . 610 campos, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 caracteres de escape . . . . . . . . . . . . . . . . . . . . . . . . 469

caracteres multi-byte . . . . . . . . . . . . . . . . . . . . . . . . 330 caracteres, conjunto de . . . . . . . . . . . . . . . . . . 99, 325 carregando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . 176 case sensitivo, em vericaao de acesso . . . . . . . 234 c caso sensitivo nos nomes . . . . . . . . . . . . . . . . . . . . 473 caso sensitivo, de nomes de bancos de dados . . . 44 caso sensitivo, de nomes de tabelas . . . . . . . . . . . . 44 caso-sensitivito, em pesquisas . . . . . . . . . . . . . . . . 930 caso-sensitivo, em comparaao de string . . . . . . 519 c cast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521 casts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 certicaao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 c ChangeLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957 changes, version 3.19 . . . . . . . . . . . . . . . . . . . . . . . 1076 changes, version 3.20 . . . . . . . . . . . . . . . . . . . . . . . 1069 changes, version 3.21 . . . . . . . . . . . . . . . . . . . . . . . 1056 changes, version 3.22 . . . . . . . . . . . . . . . . . . . . . . . 1042 changes, version 3.23 . . . . . . . . . . . . . . . . . . . . . . . 1000 character-sets-dir, opao mysql . . . . . . . . . . . 347 c chaves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 chaves estrangeiras . . . . . . . . . . . . . . . . . . 50, 198, 611 chaves multi-column . . . . . . . . . . . . . . . . . . . . . . . . 450 chaves primrias, deletando . . . . . . . . . . . . . . . . . . 610 a chaves, pesquisando em duas . . . . . . . . . . . . . . . . 200 cheio, disco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928 Chinese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930 citando dados binrios . . . . . . . . . . . . . . . . . . . . . . 470 a cliente, depurando . . . . . . . . . . . . . . . . . . . . . . . . . 1085 clientes em threads . . . . . . . . . . . . . . . . . . . . . . . . . 863 clientes, construindo clientes . . . . . . . . . . . . . . . . . 862 coerao, operadores . . . . . . . . . . . . . . . . . . . . . . . . . 521 c colchetes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876 colunas alterando . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 colunas, alterando . . . . . . . . . . . . . . . . . . . . . . . . . . 938 colunas, exibindo . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 colunas, exigncias de armazenamento . . . . . . . . 502 e colunas, indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 colunas, nomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 colunas, outros tipos . . . . . . . . . . . . . . . . . . . . . . . . 502 colunas, selecionado . . . . . . . . . . . . . . . . . . . . . . . . . 179 comandos fora de sincronia . . . . . . . . . . . . . . . . . . 920 comandos SQL, replicaao do master . . . . . . . . . 400 c comandos SQL, replicaao do slave . . . . . . . . . . . 402 c comandos, lista de . . . . . . . . . . . . . . . . . . . . . . . . . . 350 comandos, para a distribuiao binria . . . . . . . . . 91 c a comandos, replicaao do master . . . . . . . . . . . . . . 400 c comandos, replicaao do slave . . . . . . . . . . . . . . . . 402 c comandos, sintaxe . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 combinaao de padres . . . . . . . . . . . . . . . . . . . . . . 185 c o comentrios de colunas . . . . . . . . . . . . . . . . . . . . . . 602 a comentrios, adicionando . . . . . . . . . . . . . . . . . . . . 479 a comentrios, iniciando . . . . . . . . . . . . . . . . . . . . . . . . 51 a comercial, tipos de suporte . . . . . . . . . . . . . . . . . . . 17 compactadas, tabelas . . . . . . . . . . . . . . . . . . . 336, 635 companias colaboradoras, lista de . . . . . . . . . . . . 955 comparaao de string, case-sensitivo . . . . . . . . . . 519 c Compatibilidade com o Ano 2000 . . . . . . . . . . . . . 11

Concept Index

1113

compatibilidade com ODBC. . . . . . . . . . . . . 505, 506 compatibilidade com Oracle . . . . . . . . . . . . . . . . . 614 Compatibilidade com Oracle . . . . . . . . . . . . . . . . . . 45 compatibilidade com Sybase . . . . . . . . . . . . . . . . . 614 compatibilidade entre as verses do MySQL . . 121, o 123 compatibilidade entre verses do MySQL . . . . 127, o 129 compatibilidade padres . . . . . . . . . . . . . . . . . . . . . . 42 o compatibilidade, com ODBC . . . 473, 483, 568, 601 compatibilidade, com Oracle . . . . . . . . . . . . . 45, 558 compatibilidade, com padro SQL . . . . . . . . . . . . . 42 a compatibilidade, com PostgreSQL . . . . . . . . . . . . . 45 compatibilidade, with mSQL . . . . . . . . . . . . . . . . 520 compatibilidade, Y2K . . . . . . . . . . . . . . . . . . . . . . . . 11 compatibility, with ODBC . . . . . . . . . . . . . . . . . . 1063 compilaao, otimizando . . . . . . . . . . . . . . . . . . . . . 453 c compilaao, velocidade . . . . . . . . . . . . . . . . . . . . . . 456 c compilador C++ no pode criar executveis . . . 104 a a compilador, C++ gcc . . . . . . . . . . . . . . . . . . . . . . . . . 98 compilando funoes denidas por usurios . . . . 906 c a compilando no Windows . . . . . . . . . . . . . . . . . . . . 134 compilando, estaticamente . . . . . . . . . . . . . . . . . . . . 98 compilando, problemas . . . . . . . . . . . . . . . . . . . . . . 103 compress, opao do mysqlcc . . . . . . . . . . . . . . . . . 355 c compress, opao mysql . . . . . . . . . . . . . . . . . . . . . . 347 c concedendo privlgios . . . . . . . . . . . . . . . . . . . . . . . 254 e Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768 conectando ao servidor . . . . . . . . . . . . . . . . . 168, 238 conectando remotamente com SSH . . . . . . . . . . . 133 conectando, vericaao . . . . . . . . . . . . . . . . . . . . . . 239 c Conector/ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 conexo abortada . . . . . . . . . . . . . . . . . . . . . . . . . . . 918 a confgurando senhas . . . . . . . . . . . . . . . . . . . . . . . . . 266 cong.cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 conguraao ps-instalaao . . . . . . . . . . . . . . . . . . 111 c o c conguraao, opoes de . . . . . . . . . . . . . . . . . . . . . . . 98 c c configure, executando depois da invocaao c anterior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 configure, script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Conjunto de caracteres . . . . . . . . . . . . . . . . . . . . . . 710 conjunto de caracteres, adicionando . . . . . . . . . . 327 connect_timeout variable . . . . . . . . . . . . . . . . . . . 356 connect_timeout, varivel. . . . . . . . . . . . . . . . . . . 350 a connection_name, opao do mysqlcc . . . . . . . . . 355 c Connector/J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 constante, tabela . . . . . . . . . . . . . . . . . . . . . . . 425, 432 construindo programs clientes. . . . . . . . . . . . . . . . 862 consultas lentas, log . . . . . . . . . . . . . . . . . . . . . . . . . 377 consultas, estimando performance . . . . . . . . . . . . 431 consultas, exemplos . . . . . . . . . . . . . . . . . . . . . . . . . 195 consultas, fazendo . . . . . . . . . . . . . . . . . . . . . . . . . . 169 consultas, log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 consultas, projeto de Estudo de Gmeos . . . . . . 202 e consultas, velocidade . . . . . . . . . . . . . . . . . . . . . . . . 423 consultoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 contando registros em uma tabela . . . . . . . . . . . . 188 contatos, informaao . . . . . . . . . . . . . . . . . . . . . . . . . 16 c

contribiao, programas . . . . . . . . . . . . . . . . . . . . . . 940 c controle de acesso . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 convenoes tipogrcas . . . . . . . . . . . . . . . . . . . . . . . . 2 c a convenoes, tipogrcas . . . . . . . . . . . . . . . . . . . . . . . 2 c a conversores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 copiando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600 copyrights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 crackers, segurana contra . . . . . . . . . . . . . . . . . . . 229 c crash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1079 crash-me . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 crash-me, programa . . . . . . . . . . . . . . . . . . . . 419, 421 criando banco de dados . . . . . . . . . . . . . . . . . . . . . 172 criando opoes de inicializaao padro . . . . . . . . 216 c c a criando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 criando, relatrios de bug . . . . . . . . . . . . . . . . . . . . . 36 o criptograa de senha, reversibilidade . . . . . . . . . 547 Cursors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 custos de suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 cvs, rvore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 a

D
dados, carregando em tabelas . . . . . . . . . . . . . . . . 176 dados, conjunto de caracteres . . . . . . . . . . . . . . . . 325 dados, importando . . . . . . . . . . . . . . . . . . . . . . . . . . 367 dados, recuperando . . . . . . . . . . . . . . . . . . . . . . . . . 177 dados, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 Data e Hora, Tipos . . . . . . . . . . . . . . . . . . . . . . . . . 489 data, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 database, opao do mysqlcc . . . . . . . . . . . . . . . . . 355 c database, opao mysql . . . . . . . . . . . . . . . . . . . . . . 347 c DataJunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876 datas, calculando . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 date values, problems . . . . . . . . . . . . . . . . . . . . . . . 495 DATE, problemas com coluna . . . . . . . . . . . . . . . 931 DBI Perl, modulo . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 DBI, interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 DBI/DBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887 DBUG, pacote . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085 debug, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . 347 c debug-info, opao mysql . . . . . . . . . . . . . . . . . . . . 349 c default-character-set, opao mysql . . . . . . . . 347 c deniao, bancos de dados . . . . . . . . . . . . . . . . . . . . . 4 c delayed insert limit . . . . . . . . . . . . . . . . . . . . . . . . . 583 deleao, mysql.sock . . . . . . . . . . . . . . . . . . . . . . . . 929 c deletando chaves primrias . . . . . . . . . . . . . . . . . . 610 a deletando funoes . . . . . . . . . . . . . . . . . . . . . . . . . . . 900 c deletando indices . . . . . . . . . . . . . . . . . . . . . . . 610, 614 deletando linhas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933 deletando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 deletando usurio . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 a deletando usurios . . . . . . . . . . . . . . . . . . . . . . . . . . 264 a deletando, banco de dados . . . . . . . . . . . . . . . . . . . 597 Delphi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877, 941 depurando o cliente . . . . . . . . . . . . . . . . . . . . . . . . 1085 depurando o servidor . . . . . . . . . . . . . . . . . . . . . . 1079 derived tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 desatualizando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

1114

MySQL Technical Reference for Version 5.0.0-alpha

descarregando banco de dados . . . . . . . . . . . 361, 366 descarregando tabelas . . . . . . . . . . . . . . . . . . . . . . . 177 desconectando do servidor . . . . . . . . . . . . . . . . . . . 168 desenvolvedores, lista de . . . . . . . . . . . . . . . . . . . . . 945 desligando o server . . . . . . . . . . . . . . . . . . . . . 113, 114 dicas, otimizaao . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 c digitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 dinmicas, tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . 635 a direito de escrita no tmp . . . . . . . . . . . . . . . . . . . . 116 disco cheio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928 disco, detalhes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 discos, dividindo dados entre . . . . . . . . . . . . . . . . 468 display, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 distribuiao binria do MySQL . . . . . . . . . . . . . . . 80 c a distribuiao binria, instalando . . . . . . . . . . . . . . . 91 c a distribuiao binaria, on HP-UX . . . . . . . . . . . . . . 153 c distribuiao fontes do MySQL . . . . . . . . . . . . . . . . 80 c distribuioes binrias . . . . . . . . . . . . . . . . . . . . . . . . . 86 c a distribuioes binrias no Linux . . . . . . . . . . . . . . . 141 c a distribuioes fontes, instalando . . . . . . . . . . . . . . . . 94 c DNS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 download, fazendo . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

estrutura de diretrio, padro . . . . . . . . . . . . . . . . . 83 o a Estudos de Gmeos, consultas . . . . . . . . . . . . . . . 202 e etiqueta para a rede . . . . . . . . . . . . . . . . . . . . . . 35, 41 Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876 executando configure depois da invocaao c prioritria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 a executando consultas. . . . . . . . . . . . . . . . . . . . . . . . 169 executando mltiplos servidores . . . . . . . . . . . . . . 219 u executando um servidor web . . . . . . . . . . . . . . . . . . 20 executando, modo ANSI . . . . . . . . . . . . . . . . . . . . . . 42 executando, modo batch. . . . . . . . . . . . . . . . . . . . . 193 execute, opao mysql . . . . . . . . . . . . . . . . . . . . . . . 347 c exemplos de consultas . . . . . . . . . . . . . . . . . . . . . . . 195 exemplos de saida do myisamchk . . . . . . . . . . . . . 293 exemplos, tabelas compactadas . . . . . . . . . . . . . . 338 exibindo informaao de banco de dados . . . . . . . 369 c expresso, aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 a expresses extendidas . . . . . . . . . . . . . . . . . . . . . . . 185 o expresses regulares, sintaxe . . . . . . . . . . . . . . . . 1093 o expresses, aliases . . . . . . . . . . . . . . . . . . . . . . . . . . 563 o extenses ao, padro SQL . . . . . . . . . . . . . . . . . . . . 42 o a extraindo datas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

E
Eiel Wrapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888 emprego com MySQL . . . . . . . . . . . . . . . . . . . . . . . . 16 emprego, informaao para contatos . . . . . . . . . . . . 16 c enable-named-commands, opo mysql . . . . . . . . 348 ca endereo da mailing list . . . . . . . . . . . . . . . . . . . . . . . 2 c endereo eletrnico, para suporte ` clientes . . . . 41 c o a entre aspas, string . . . . . . . . . . . . . . . . . . . . . . . . . . 884 ENUM, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 Errcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 errno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 erro de aceeso negado . . . . . . . . . . . . . . . . . . . . . . . 912 erros comuns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911 erros conhecidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 erros de arredondamento;. . . . . . . . . . . . . . . . . . . . 529 erros de ligao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 ca erros internos de compilao . . . . . . . . . . . . . . . . . 103 ca erros, checksum error . . . . . . . . . . . . . . . . . . . . . . . 144 erros, conhecidos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 erros, directory checksum error . . . . . . . . . . . . . . 144 erros, linguagem . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 erros, lista de . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912 erros, relatando . . . . . . . . . . . . . . . . . . . . . . . . . . . 2, 36 erros, relatrios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 o erros, tartamento para UDFs . . . . . . . . . . . . . . . . 906 erros, vericando tabelas . . . . . . . . . . . . . . . . . . . . 288 escolhendo tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 escolhendo, uma verso do MySQL . . . . . . . . . . . . 80 a espao de armazenamento, minimizando . . . . . . 446 c Espao, Extenao no MySQL . . . . . . . . . . . . . . . . 733 c c estabilidade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 estaticamente, compilando . . . . . . . . . . . . . . . . . . . . 98 estimando performance de consultas . . . . . . . . . . 431 estrangeiras, chaves . . . . . . . . . . . . . . . . . . . . . . 50, 198

F
falhas repetidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925 falhas, recuperaao . . . . . . . . . . . . . . . . . . . . . . . . . 287 c fatal signal 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 fazendo consultas . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 fazendo parceria com a MySQL AB . . . . . . . . . . . 15 fechando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 ferramenta de clientes . . . . . . . . . . . . . . . . . . . . . . . 775 ferramenta de linha de comando . . . . . . . . . . . . . 347 ferramentas, lista de . . . . . . . . . . . . . . . . . . . . . . . . 955 ferramentas, mysqld multi . . . . . . . . . . . . . . . . . . . 333 ferramentas, mysqld safe . . . . . . . . . . . . . . . . . . . . 331 ferramentas, safe mysqld . . . . . . . . . . . . . . . . . . . . 331 ush tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 force, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . 348 c foreign key, restriao . . . . . . . . . . . . . . . . . . . . . . . . . 52 c foreign keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 FreeBSD, resolvendo problemas . . . . . . . . . . . . . . 105 full-text, pesquisa . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 FULLTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 funoes binrias, exemplos . . . . . . . . . . . . . . . . . . . 201 c a funoes de data, compatibilidade Y2K . . . . . . . . . 11 c funoes denidas por usurio, adicionando . . . . 899 c a funoes denidas por usurios, adicionado . . . . 900 c a funoes nativas, adicionando . . . . . . . . . . . . . . . . . 908 c funoes para clusulas SELECT e WHERE . . . . . . . . 504 c a funoes, agrupando . . . . . . . . . . . . . . . . . . . . . . . . . 504 c funoes, API C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778 c funoes, deletando . . . . . . . . . . . . . . . . . . . . . . . . . . 900 c funoes, instruoes preparadas da API C . . . . . 831 c c funoes, novas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899 c fuso horrio, problemas . . . . . . . . . . . . . . . . . . . . . 930 a

Concept Index

1115

G
gcc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 gdb, usando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1081 General Public License . . . . . . . . . . . . . . . . . . . . . . . . 5 General Public License, MySQL . . . . . . . . . . . . . . 18 geoespacial, recurso . . . . . . . . . . . . . . . . . . . . . . . . . 733 geogrcos, reucursos . . . . . . . . . . . . . . . . . . . . . . . 733 a geometria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733 GIS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733 globais, privilgios . . . . . . . . . . . . . . . . . . . . . . . . . . 254 e GPL, Licena Publica Geral . . . . . . . . . . . . . . . . 1096 c GPL, Licena P blica Geral do GNU . . . . . . . 1096 c u GPL, MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 graphical tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 gratis, licensiamento . . . . . . . . . . . . . . . . . . . . . . . . . 19 GROUP BY, aliases em . . . . . . . . . . . . . . . . . . . . . . . . 562 GROUP BY, extenses ao padro SQL . . . . . . . . . . 565 o a GROUP BY, extenses para o padro SQL . . . . . . 561 o a GUI tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

H
Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769 HEAP, tipo de tabela . . . . . . . . . . . . . . . . . . . . . . . . . 630 help, opao do mysqlcc . . . . . . . . . . . . . . . . . . . . . 355 c help, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . 347 c hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 565 histria do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 o histrico, arquivo de . . . . . . . . . . . . . . . . . . . . . . . . 345 o history_size, opao do mysqlcc . . . . . . . . . . . . 355 c hora, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 host, opao do mysql . . . . . . . . . . . . . . . . . . . . . . . 355 c host, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . 348 c host, tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 HP-UX, distribuiao binaria . . . . . . . . . . . . . . . . . 153 c html, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . 348 c

inicializaao, parmetros . . . . . . . . . . . . . . . . . . . . 454 c a inicializando o servidor automaticamente . . . . . 118 iniciando o mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . 923 iniciando o servidor . . . . . . . . . . . . . . . . . . . . . . . . . 111 iniciando vrios servidores . . . . . . . . . . . . . . . . . . . 219 a iniciando, comentrios . . . . . . . . . . . . . . . . . . . . . . . . 51 a InnoDB, tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 InnoDB, tipo de tabela . . . . . . . . . . . . . . . . . . . . . . 630 inserao, velocidade . . . . . . . . . . . . . . . . . . . . . . . . . 438 c INSERT DELAYED . . . . . . . . . . . . . . . . . . . . . . . . 582 instalaao de pacotes, Mac OS X PKG . . . . . . . . 71 c instalaao, layouts de . . . . . . . . . . . . . . . . . . . . . . . . 83 c instalaao, viso geral . . . . . . . . . . . . . . . . . . . . . . . . 60 c a instalando o Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 instalando, distribuiao binria . . . . . . . . . . . . . . . 91 c a instalando, distribuioes fontes . . . . . . . . . . . . . . . . 94 c instalando, pacotes RPM do Linux . . . . . . . . . . . . 69 instalando, Perl no Windows . . . . . . . . . . . . . . . . 165 installing, funoes denidas por usurios . . . . . . 906 c a inteiros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 internals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896 Internet Relay Chat . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Internet Service Providers . . . . . . . . . . . . . . . . . . . . 19 interno, travamento . . . . . . . . . . . . . . . . . . . . . . . . . 443 IRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 ISAM, tipo de tabela . . . . . . . . . . . . . . . . . . . . . . . . . 630 ISP servios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 c

J
Java, conectividade . . . . . . . . . . . . . . . . . . . . . . . . . 880 JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880

K
key space, MyISAM . . . . . . . . . . . . . . . . . . . . . . . . . 633 keys, foreign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

I
ID unico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862 idade, calculando . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 ignore-space, mysql option . . . . . . . . . . . . . . . . . 348 importando dados . . . . . . . . . . . . . . . . . . . . . . . . . . 367 indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613 indices e colunas BLOB . . . . . . . . . . . . . . . . . . . . . . . 603 ind ices e colunas TEXT . . . . . . . . . . . . . . . . . . . . . . . 603 ind ices e IS NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 indices e valores NULL . . . . . . . . . . . . . . . . . . . . . . . 603 indices multi-coluna . . . . . . . . . . . . . . . . . . . . . . . . . 450 indices multi-parte . . . . . . . . . . . . . . . . . . . . . . . . . . 613 indices, colunas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 indices, deletando . . . . . . . . . . . . . . . . . . . . . . 610, 614 indices, e LIKE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 indices, nomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 indices, prexo mais a esquerda de . . . . . . . . . . . 448 indices, tamanho de blocos . . . . . . . . . . . . . . . . . . 314 ind ices, uso de . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 informaoes gerais . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 c

L
layouts de instalaao . . . . . . . . . . . . . . . . . . . . . . . . . 83 c libmysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864 Licena Pblica Geral (GPL) . . . . . . . . . . . . . . . . . . 5 c u licenas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 c licenciamento, custo . . . . . . . . . . . . . . . . . . . . . . . . . . 17 licenciamento, exemplos . . . . . . . . . . . . . . . . . . . . . . 18 licenciamento, gratis . . . . . . . . . . . . . . . . . . . . . . . . . 19 licenciamento, informaao para contatos . . . . . . . 16 c licenciamento, pol iticas . . . . . . . . . . . . . . . . . . . . . . . 18 licenciamento, termos . . . . . . . . . . . . . . . . . . . . . . . . 17 ligaao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862 c ligaao, erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 c ligaao, velocidade . . . . . . . . . . . . . . . . . . . . . . . . . . 456 c limitaoes de projeto . . . . . . . . . . . . . . . . . . . . . . . . 418 c limites, tamanho de arquivo . . . . . . . . . . . . . . . . . . 10 limpando caches . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 lingaao, problemas com . . . . . . . . . . . . . . . . . . . . 862 c l inguas, suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

1116

MySQL Technical Reference for Version 5.0.0-alpha

linha de comando, ferramentas . . . . . . . . . . . . . . . 347 linha de comando, histrico . . . . . . . . . . . . . . . . . . 345 o linha de comando, opao mysql . . . . . . . . . . . . . . 347 c linha de comando, opoes . . . . . . . . . . . . . . . . . . . 207 c linha de comando, opoes, mysqlcc . . . . . . . . . . . 355 c linhas, deletando . . . . . . . . . . . . . . . . . . . . . . . . . . . 933 links simblicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 o links symbolicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 Linux, distribuiao binrias . . . . . . . . . . . . . . . . . . 141 c a lista de colaboradores . . . . . . . . . . . . . . . . . . . . . . . 948 lista de discusso MySQL . . . . . . . . . . . . . . . . . . . . 33 a listas de discusso . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 a listas de email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 listas de mensagens, guias . . . . . . . . . . . . . . . . . . . . 41 listas de mensagens, localizaao dos arquivos . . . 35 c literais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 local-infile . . . . . . . . . . . . . . . . . . . . . . . . . . 350, 356 localizaao padro da instalaao . . . . . . . . . . . . . . 83 c a c lock de tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 lock de, registro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 locks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 log, alteraoes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957 c log, arquivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98, 377 logomarcas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

M
Mac OS X, instalaao . . . . . . . . . . . . . . . . . . . . . . . . 71 c make_binary_distribution . . . . . . . . . . . . . . . . . 331 mantendo, arquivos de log . . . . . . . . . . . . . . . . . . . 377 manual, convenoes tipogrcas . . . . . . . . . . . . . . . . 2 c a manual, formatos dispon iveis . . . . . . . . . . . . . . . . . . 2 manual, online location . . . . . . . . . . . . . . . . . . . . . . . . 2 manutenao, tabelas . . . . . . . . . . . . . . . . . . . . . . . . 292 c marcas registradas . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 master/slave, conguraao . . . . . . . . . . . . . . . . . . . 379 c max memory used . . . . . . . . . . . . . . . . . . . . . . . . . . 358 max_allowed_packet . . . . . . . . . . . . . . . . . . . 350, 356 max_join_size . . . . . . . . . . . . . . . . . . . . . . . . . 350, 356 MBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 memria virtual, problemas quando compilando o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 memoria, uso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 memory use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 mensagem de erro, exibindo . . . . . . . . . . . . . . . . . 371 mensagem de erro, linguagem . . . . . . . . . . . . . . . . 327 mensagens de erro, arquivo no encontrado . . . 924 a MERGE, deniao de tabelas . . . . . . . . . . . . . . . . 638 c MERGE, tipo de tabela. . . . . . . . . . . . . . . . . . . . . . . . 630 meta caracteres, e LIKE . . . . . . . . . . . . . . . . . . . . . 448 meta caracteres, na tabela mysql.columns_priv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 meta caracteres, na tabela mysql.db . . . . . . . . . 243 meta caracteres, na tabela mysql.host . . . . . . . 243 meta caracteres, na tabela mysql.tables_priv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 metacaracteres, na tabela mysql.user . . . . . . . . 239 mtodos, travamento . . . . . . . . . . . . . . . . . . . . . . . 1087 e

Minimum Bounding Rectangle . . . . . . . . . . . . . . . 756 MIT-pthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 modo ANSI, executando . . . . . . . . . . . . . . . . . . . . . . 42 modo batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 mdulos, lista dos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 o monitor, terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 mostrando informaoes de banco de dados . . . . 369 c mostrando, informaoes, SHOW . . . . . . . . . . . . . . . . 303 c mostrando, status da tabela . . . . . . . . . . . . . . . . . 304 mSQL compatibilidade . . . . . . . . . . . . . . . . . . . . . . 520 msql2mysql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 mudana de privilgios . . . . . . . . . . . . . . . . . . . . . . 245 c e multi mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 multi-byte, caracteres . . . . . . . . . . . . . . . . . . . . . . . 330 multi-byte, conjunto de caracteres . . . . . . . . . . . . 921 multi-colunas, indices . . . . . . . . . . . . . . . . . . . . . . . 450 multi-parte, indice . . . . . . . . . . . . . . . . . . . . . . . . . . 613 mltiplos servidores . . . . . . . . . . . . . . . . . . . . . . . . . 219 u My, derivaao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 c my.cnf, arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 MyISAM, tabelas compactadas . . . . . . . . . . 336, 635 MyISAM, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . 503 MyISAM, tipo de tabela . . . . . . . . . . . . . . . . . . . . . . 630 myisamchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100, 331 myisamchk, exemplos de sa . . . . . . . . . . . . . . . 293 ida myisamchk, opoes . . . . . . . . . . . . . . . . . . . . . . . . . . 282 c myisampack . . . . . . . . . . . . . . . . . . . . . . . 336, 608, 635 MyODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 MyODBC, relatando problemas . . . . . . . . . . . . . . 879 mysladmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 mysql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346, 347 MySQL AB, deniao . . . . . . . . . . . . . . . . . . . . . . . . 12 c MySQL, certicaao . . . . . . . . . . . . . . . . . . . . . . . . . 14 c MySQL, consultoria . . . . . . . . . . . . . . . . . . . . . . . . . . 14 MySQL, denioes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 c MySQL, histria do . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 o MySQL, introduao . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 c mysql, opao de linha de comando . . . . . . . . . . . 347 c MySQL, pronncia . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 u MySQL, tipo de tabelas . . . . . . . . . . . . . . . . . . . . . 630 MySQL, treinamento . . . . . . . . . . . . . . . . . . . . . . . . . 14 MYSQL, verso do. . . . . . . . . . . . . . . . . . . . . . . . . . . 75 a mysql.sock, alterando localizaao do . . . . . . . . . . . 98 c mysql.sock, proteao . . . . . . . . . . . . . . . . . . . . . . . 929 c mysql_fix_privilege_tables . . . . . . . . . . . . . . . 250 mysql_install_db . . . . . . . . . . . . . . . . . . . . . . . . . . 331 mysql_install_db, script . . . . . . . . . . . . . . . . . . . 115 mysqlaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 mysqladmin . . . . . . . . . . 299, 301, 305, 346, 597, 598 mysqlbinlog . . . . . . . . . . . . . . . . . . . . . . . . . . . 346, 358 mysqlbug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 mysqlcc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346, 354 mysqlcc, opoes de linha de comando . . . . . . . . 355 c mysqlclient, biblioteca . . . . . . . . . . . . . . . . . . . . . 775 mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 mysqld , tamanho de buer do servidor . . . . . . . 454 mysqld, iniciando . . . . . . . . . . . . . . . . . . . . . . . . . . . 923 mysqld, opoes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 c

Concept Index

1117

mysqld-max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mysqld_multi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mysqld_safe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mysqldump . . . . . . . . . . . . . . . . . . . . . . . . 132, 346, mysqlimport . . . . . . . . . . . . . . . . . . 132, 346, 367, mysqlshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mysqltest, Programa de Tste do MySQL . . . . .

343 333 331 361 589 346 896

O
O que criptograa? . . . . . . . . . . . . . . . . . . . . . . . . 268 e O que um X509/Certicado? . . . . . . . . . . . . . . . 268 e objetivos do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . 5 obtendo o MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 ODBC compatibilidade . . . . . . . . . . . . . . . . . . . . . 568 ODBC compatibility . . . . . . . . . . . . . . . . . . . . . . . 1063 ODBC, administrador . . . . . . . . . . . . . . . . . . . . . . . 871 ODBC, compatibilidade . . . . . . . . . . . . 473, 483, 601 ODBC, compatibilidade com . . . . . . . . . . . . 505, 506 odbcadmin program . . . . . . . . . . . . . . . . . . . . . . . . 877 OLEDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940 one-database, mysql option . . . . . . . . . . . . . . . . . 348 online location of manual . . . . . . . . . . . . . . . . . . . . . . 2 opao cong-le . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 c opao congure, with-low-memory . . . . . . . . . . 103 c opao de linha de comando mysql . . . . . . . . . . . . 347 c opao example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao mysqladmin . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao no-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao tcp-ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opao version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 c opaoes de inicializaao, padro . . . . . . . . . . . . . . 216 c c a opoes de linha de comando, mysqlcc . . . . . . . . 355 c opoes de reparo, myisamchk . . . . . . . . . . . . . . . . 284 c opoes de vericaa, myisamchk . . . . . . . . . . . . . 283 c c opoes frornecidas pelo MySQL . . . . . . . . . . . . . . 168 c opoes mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 c opoes padres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 c o opoes, conguraao . . . . . . . . . . . . . . . . . . . . . . . . . 98 c c opoes, myisamchk . . . . . . . . . . . . . . . . . . . . . . . . . . 282 c opoes, replicaao . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 c c Open Source, deniao . . . . . . . . . . . . . . . . . . . . . . . . 5 c open tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OpenGIS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733 opens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OpenSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 operaoes aritimticas . . . . . . . . . . . . . . . . . . . . . . . 522 c e operadores de coero . . . . . . . . . . . . . . . . . . 521, 522 ca optimizaoes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 c optimizando, tabelas . . . . . . . . . . . . . . . . . . . . . . . . 291 Oracle, compatibilidade . . . . . . . . . . . . . . . . . 558, 614 ordenaao, conjunto de caracteres . . . . . . . . . . . . 325 c ordenando dados . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 ordenando registros de tabelas . . . . . . . . . . . . . . . 180 ordenando strings . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 ordenando tabela de permisses . . . . . . . . . 241, 243 o ORDER BY, aliases em . . . . . . . . . . . . . . . . . . . . . . . . 562 otimizaao, dicas . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 c otimizando DISTINCT . . . . . . . . . . . . . . . . . . . . . . 434 otimizando, LEFT JOIN . . . . . . . . . . . . . . . . . . . . 435 otimizando, LIMIT . . . . . . . . . . . . . . . . . . . . . . . . . 437

N
named pipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 no delimitadas, strings . . . . . . . . . . . . . . . . . . . . . 494 a no encontrados, regitros . . . . . . . . . . . . . . . . . . . . 934 a no pode criar/gravar arquivos . . . . . . . . . . . . . . 919 a no transacionais, tabelas . . . . . . . . . . . . . . . . . . . 916 a nativa, suporte de thread . . . . . . . . . . . . . . . . . . . . . 78 nativas, adicionando funoes . . . . . . . . . . . . . . . . . 908 c net_buffer_length . . . . . . . . . . . . . . . . . . . . 350, 356 NetWare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74, 164 no-auto-rehash, opao mysql . . . . . . . . . . . . . . . 347 c no-beep, mysql option . . . . . . . . . . . . . . . . . . . . . . 347 no-named-commands, opao mysql . . . . . . . . . . . . 348 c no-pager, opao mysql . . . . . . . . . . . . . . . . . . . . . . 348 c no-tee, opo mysql . . . . . . . . . . . . . . . . . . . . . . . . 348 ca nome de mquina, armazenando em cache . . . . 459 a nome de maquinas padrao . . . . . . . . . . . . . . . . . . . 238 nome de usurios e senhas . . . . . . . . . . . . . . . . . . . 259 a Nome do Golnho do MySQL . . . . . . . . . . . . . . . . . . 5 Nome do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 nomeando, releases do MySQL . . . . . . . . . . . . . . . . 81 nomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 nomes alias, caso sensitivo . . . . . . . . . . . . . . . . . . . 473 nomes de banco de dados, caso sensitivo . . . . . . . 44 nomes de bancos de dados, caso sensitivo . . . . . 473 nomes de colunas, caso sensitivo . . . . . . . . . . . . . 473 nomes de tabelas, caso sensitivo . . . . . . . . . . 44, 473 nomes validos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 nomes, caso sensitivo . . . . . . . . . . . . . . . . . . . . . . . . 473 nomes, variveis . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 a NOT NULL, restries . . . . . . . . . . . . . . . . . . . . . . . 53 co notaao de mscara de rede, na tabela mysql.user c a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Novell NetWare . . . . . . . . . . . . . . . . . . . . . . . . . 74, 164 novos procedimentos, adcionado . . . . . . . . . . . . . 909 novos usurios, adicionando . . . . . . . . . . . . . . . . . . 92 a NULL e colunas AUTO_INCREMENT . . . . . . . . . . . . . . 933 NULL e colunas TIMESTAMP . . . . . . . . . . . . . . . . . . . 933 NULL vs. valores vazios . . . . . . . . . . . . . . . . . . . . . . 932 NULL, teste para nulo . . . . . . . . . . . . . . . . . . . 508, 511 NULL, testes para nulo . . . . . . . . . . . . . . . . . . . . . . . 506 NULL, valores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 NULL, valores e indices . . . . . . . . . . . . . . . . . . . . . . . 603 numericos, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 nmero de ponto utuante . . . . . . . . . . . . . . . . . . 483 u nmeros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 u nmeros de release . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 u nmeros vlidos, exemplos. . . . . . . . . . . . . . . . . . . 471 u a

1118

MySQL Technical Reference for Version 5.0.0-alpha

P
pack_isam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 pacotes, lista de . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954 padrao do nome de maquinas . . . . . . . . . . . . . . . . 238 padro, privilgios . . . . . . . . . . . . . . . . . . . . . . . . . . 260 a e Padros SQL, diferenas do . . . . . . . . . . . . . . . . . . 258 a c padres, combinao . . . . . . . . . . . . . . . . . . . . . . . . 185 o ca padres, embutico . . . . . . . . . . . . . . . . . . . . . . . . . . 866 o pager, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . 348 c palavras reservadas, exceoes de . . . . . . . . . . . . . 479 c palavras-chave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 par6ametros de inicializao, mysqlcc . . . . . . . . 355 ca paramentros de inicializaao, sintonia . . . . . . . . 453 c parmetros de inicialiazaao, mysql . . . . . . . . . . 347 a c parmetros, servidor . . . . . . . . . . . . . . . . . . . . . . . . 454 a parando o servidor . . . . . . . . . . . . . . . . . . . . . . . . . . 118 password, opao do mysqlcc . . . . . . . . . . . . . . . . . 355 c password, opao mysql . . . . . . . . . . . . . . . . . . . . . . 349 c patches, aplicando . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 performance, aumentando . . . . . . . . . . . . . . . 412, 446 performance, benchmarks . . . . . . . . . . . . . . . . . . . 423 performance, detalhes de disco . . . . . . . . . . . . . . . 464 performance, estimando . . . . . . . . . . . . . . . . . . . . . 431 Perl API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 Perl DBI/DBD, problemas de instalaao . . . . . . 166 c Perl, instalando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Perl, instalando no Windows . . . . . . . . . . . . . . . . 165 Perl, modulos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940 permisses de tabelas . . . . . . . . . . . . . . . . . . . . . . . 245 o perror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 pesquisa full-text . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 pesquisando em duas chaves . . . . . . . . . . . . . . . . . 200 pesquisas e caso-sensitivito . . . . . . . . . . . . . . . . . . 930 PHP API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 plugins_path, opao do mysqlcc . . . . . . . . . . . . 355 c ponto decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 ponto utuante . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 port, opao do mysqlcc . . . . . . . . . . . . . . . . . . . . . 355 c port, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . 349 c portabilidade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 portabilidade, tipos . . . . . . . . . . . . . . . . . . . . . . . . . 502 portando para outros sistemas . . . . . . . . . . . . . . 1078 ps-instalao, conguraao e testes . . . . . . . . . . 111 o ca c ps-instalao, multiplos servidores. . . . . . . . . . . 219 o ca PostgreSQL, compatibilidade . . . . . . . . . . . . . . . . . 45 preo do suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 c prexo mais a esquerda de indices . . . . . . . . . . . . 448 PRIMARY KEY, restriao . . . . . . . . . . . . . . . . . . . 52 c privilgio de acesso . . . . . . . . . . . . . . . . . . . . . . . . . 226 e privilgio, mudana . . . . . . . . . . . . . . . . . . . . . . . . . 245 e c privilgio, sistemas de . . . . . . . . . . . . . . . . . . . . . . . 232 e privilgios de usurio, apagando . . . . . . . . . . . . . 264 e a privilgios de usurio, deletando . . . . . . . . . . . . . 264 e a privilgios globais . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 e privilgios, adicionando . . . . . . . . . . . . . . . . . . . . . 261 e privilgios, apagando . . . . . . . . . . . . . . . . . . . . . . . . 264 e privilgios, concedendo . . . . . . . . . . . . . . . . . . . . . . 254 e privilgios, deletando . . . . . . . . . . . . . . . . . . . . . . . . 264 e

privilgios, exibir . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 e privilegios, localizaao de informaoes . . . . . . . . 236 c c privilgios, padro . . . . . . . . . . . . . . . . . . . . . . . . . . 260 e a privilgios, revogando . . . . . . . . . . . . . . . . . . . . . . . 254 e problemas cc1plus . . . . . . . . . . . . . . . . . . . . . . . . . 103 problemas com bloqueios de tabela . . . . . . . . . . . 444 problemas com fuso horrio. . . . . . . . . . . . . . . . . . 930 a problemas de ligaao . . . . . . . . . . . . . . . . . . . . . . . . 922 c problemas e erros comuns . . . . . . . . . . . . . . . . . . . 911 problemas inicializando o servidor . . . . . . . . . . . . 116 problemas instalando no Solaris . . . . . . . . . . . . . . 144 problemas, colunas DATE . . . . . . . . . . . . . . . . . . . . . 931 problemas, compilando . . . . . . . . . . . . . . . . . . . . . . 103 problemas, erros de acesso negado . . . . . . . . . . . . 912 problemas, instalando no IBM-AIX . . . . . . . . . . 155 problemas, instalando Perl . . . . . . . . . . . . . . . . . . 166 problemas, ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . 879 problemas, relatando . . . . . . . . . . . . . . . . . . . . . . . . . 36 problems, date values . . . . . . . . . . . . . . . . . . . . . . . 495 procedimentos, adicionando . . . . . . . . . . . . . . . . . 909 procedures, stored . . . . . . . . . . . . . . . . . . . . . . . 49, 763 processando, argumentos . . . . . . . . . . . . . . . . . . . . 904 processos, exibindo . . . . . . . . . . . . . . . . . . . . . . . . . 320 processos, suporte de . . . . . . . . . . . . . . . . . . . . . . . . . 78 procurando, pginas web MySQL . . . . . . . . . . . . . 35 a produtos, vendendo . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Programa Access . . . . . . . . . . . . . . . . . . . . . . . . . . . 874 programa, crash-me . . . . . . . . . . . . . . . . . . . . . . . . . 419 programas clientes . . . . . . . . . . . . . . . . . . . . . . . . . . 862 programas, contribuiao . . . . . . . . . . . . . . . . . . . . . 940 c programas, lista de . . . . . . . . . . . . . . . . . . . . . 331, 345 projeto, limitaoes . . . . . . . . . . . . . . . . . . . . . . . . . . 418 c projetos, detalhes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 projetos, escolhas . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 prompt de comando . . . . . . . . . . . . . . . . . . . . . . . . . 353 prompt, mysql option . . . . . . . . . . . . . . . . . . . . . . . 347 prompts, signicados . . . . . . . . . . . . . . . . . . . . . . . . 171 pronncia, MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 u Protocol mismatch . . . . . . . . . . . . . . . . . . . . . . . . . . 129 protocol, mysql option . . . . . . . . . . . . . . . . . . . . . 349 protocol, mysql, opao . . . . . . . . . . . . . . . . . . . . . 368 c Protocolos no correspondetes . . . . . . . . . . . . . . . 129 a Provedores de Servios de Internet . . . . . . . . . . . . 19 c Python, API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888

Q
queries, exemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Query Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625 query, opao do mysqlcc . . . . . . . . . . . . . . . . . . . . 355 c questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 questes, respondendo . . . . . . . . . . . . . . . . . . . . . . . . 41 o quick, mysql option . . . . . . . . . . . . . . . . . . . . . . . . 349

Concept Index

1119

R
RAID, erros de compilaao . . . . . . . . . . . . . . . . . . 104 c RAID, table type . . . . . . . . . . . . . . . . . . . . . . . . . . . 606 raw, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 c recongurando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 reconnect, mysql option . . . . . . . . . . . . . . . . . . . . 349 recriando tabelas de permisses . . . . . . . . . . . . . . 261 o recuperando dados de tabelas . . . . . . . . . . . . . . . . 177 recupraao em caso de falhas . . . . . . . . . . . . . . . . 287 c recursos do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 recursos principais do MySQL . . . . . . . . . . . . . . . . . 6 RedHat Package Manager . . . . . . . . . . . . . . . . . . . . 69 reduzindo o tamanho dos dados . . . . . . . . . . . . . . 446 referncias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611 e regex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093 register, opao do mysqlcc . . . . . . . . . . . . . . . . . 355 c registro, lock de . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 registro, ordenando . . . . . . . . . . . . . . . . . . . . . . . . . 180 registros no encontrados . . . . . . . . . . . . . . . . . . . . 934 a registros, contando . . . . . . . . . . . . . . . . . . . . . . . . . . 188 registros, secionando . . . . . . . . . . . . . . . . . . . . . . . . 178 relatando problemas com MyODBC . . . . . . . . . . 879 relatando, bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 relatando, erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 relatrio de bug, critrio para . . . . . . . . . . . . . . . . . 38 o e relatrio, erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 o releases, atualizando . . . . . . . . . . . . . . . . . . . . . . . . . 84 releases, esquema de nomenclatura . . . . . . . . . . . . 81 releases, testando . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 reordenando colunas . . . . . . . . . . . . . . . . . . . . . . . . 938 repairando tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . 289 replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 replicaao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 c replicaao do master, comandos . . . . . . . . . . . . . . 400 c replicaao do slave, comandos . . . . . . . . . . . . . . . . 402 c Resolvendo problemas no FreeBSD . . . . . . . . . . . 105 Resolvendo problemas no Solaris . . . . . . . . . . . . . 105 respondendo `s questes, etiqueta . . . . . . . . . . . . . 41 a o Responsveis pela Documentaao, lista dos . . . 952 a c Retngulo de Limite M a inimo . . . . . . . . . . . . . . . . 756 revogando privlgios . . . . . . . . . . . . . . . . . . . . . . . . 254 e root, recuperando senha do . . . . . . . . . . . . . . . . . . 927 root, senha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 RTS-threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1088

S
safe-mode, comando . . . . . . . . . . . . . . . . . . . . . . . . 351 safe-updates, opao mysql . . . . . . . . . . . . . . . . . 349 c safe_mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 Sakila . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 script mysqlbug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 script mysqlbug, localizao . . . . . . . . . . . . . . . . . . . 2 ca script, arquivos de . . . . . . . . . . . . . . . . . . . . . . . . . . 193 scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331, 333, 347 scripts mysql_install_db . . . . . . . . . . . . . . . . . . . 115 scripts, mysqlbug . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 segurana com transaao, tabelas . . . . . . . . . . . . 643 c c

segurana contra crackers . . . . . . . . . . . . . . . . . . . 229 c segurana de sistema . . . . . . . . . . . . . . . . . . . . . . . . 226 c selecionando banco de dados . . . . . . . . . . . . . . . . . 173 SELECT, Query Cache . . . . . . . . . . . . . . . . . . . . . . . 625 select_limit . . . . . . . . . . . . . . . . . . . . . . . . . . 350, 356 senha, conguraao . . . . . . . . . . . . . . . . . . . . . . . . . 462 c senha, usurio root . . . . . . . . . . . . . . . . . . . . . . . . . 260 a senhas esquecidas . . . . . . . . . . . . . . . . . . . . . . . . . . . 927 senhas seguras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 senhas, congurando . . . . . . . . . . . . . . . . . . . 257, 266 senhas, para usurios . . . . . . . . . . . . . . . . . . . . . . . 259 a senhas, recuperando . . . . . . . . . . . . . . . . . . . . . . . . 927 sequncia de chamadas para funoes agregadas, e c UDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903 sequncia de chamadas para funoes simples, UDF e c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902 sequencia de emulaao . . . . . . . . . . . . . . . . . . . . . . 552 c server, opao do mysqlcc . . . . . . . . . . . . . . . . . . . 355 c servios, ISP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 c servios, web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 c servidor web, executando . . . . . . . . . . . . . . . . . . . . . 20 servidor, administraao. . . . . . . . . . . . . . . . . . . . . . 356 c servidor, conectando . . . . . . . . . . . . . . . . . . . . 168, 238 servidor, depurando . . . . . . . . . . . . . . . . . . . . . . . . 1079 servidor, desligar o . . . . . . . . . . . . . . . . . . . . . 113, 114 servidor, disconectando. . . . . . . . . . . . . . . . . . . . . . 168 servidor, inicializando e parando . . . . . . . . . . . . . 118 servidor, iniciando o . . . . . . . . . . . . . . . . . . . . . . . . 111 servidor, problemas inicializando o . . . . . . . . . . . 116 servidores, mltiplos . . . . . . . . . . . . . . . . . . . . . . . . 219 u SET, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 set-variable, opao mysql . . . . . . . . . . . . . . . . . 348 c shell, sintaxe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 silent, mysql option . . . . . . . . . . . . . . . . . . . . . . . 349 simblicos, links . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 o sintaxe de expresses regulares, descriao . . . . 1093 o c sistema de privilgios . . . . . . . . . . . . . . . . . . . . . . . 232 e sistema de privilgios, dexcria . . . . . . . . . . . . . . . 232 e c sistema, otimizaao . . . . . . . . . . . . . . . . . . . . . . . . . 453 c sistema, segurana . . . . . . . . . . . . . . . . . . . . . . . . . . 226 c sistema, tabela de . . . . . . . . . . . . . . . . . . . . . . . . . . 425 sistema, variveis . . . . . . . . . . . . . . . . . . . . . . . . . . . 475 a sistemas operacionais, limites de tamanho de arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 sistemas operacionais, suportados . . . . . . . . . . . . . 78 sistemas operacionais, Windows versus Unix . . 134 sites de espelhos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 skip-column-names, opao mysql . . . . . . . . . . . . 348 c skip-line-numbers, mysql option . . . . . . . . . . . 348 slow queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 socket, alteraao localizaao dos . . . . . . . . . . . . . . 98 c c socket, opao do mysqlcc . . . . . . . . . . . . . . . . . . . 355 c socket, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . 349 c Solaris, problemas de instalaao . . . . . . . . . . . . . . 144 c Solaris, resolvendo problemas . . . . . . . . . . . . . . . . 105 SQL, deniao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 c SQL-92, extenses ao . . . . . . . . . . . . . . . . . . . . . . . . 42 o sql_yacc.cc problemas . . . . . . . . . . . . . . . . . . . . . 103

1120

MySQL Technical Reference for Version 5.0.0-alpha

SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 SSL e X509 Basicos . . . . . . . . . . . . . . . . . . . . . . . . . 268 SSL, opoes de linha de comando . . . . . . . . . . . . 274 c SSL, opoes relacionadas . . . . . . . . . . . . . . . . . . . . 273 c status, comando . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 status, resultado do comando . . . . . . . . . . . . . . . . 357 status, tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 stored procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . 763 stored procedures e triggers, deniao . . . . . . . . . 49 c string entre aspas . . . . . . . . . . . . . . . . . . . . . . . . . . . 884 string tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 string, ordenaao . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 c string, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 strings no delimitadas . . . . . . . . . . . . . . . . . . . . . . 494 a strings, caracteres de escape . . . . . . . . . . . . . . . . . 469 strings, deniao . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 c striping, deniao . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 c subqueries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 subquery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 subselects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 sugestes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568 o superusurio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 a suporte a clientes, endereo eletrnico . . . . . . . . . 41 c o suporte ` thread no-nativa . . . . . . . . . . . . . . . . . 106 a a suporte tcnico, endereo eletrnico . . . . . . . . . . . 41 e c o suporte tcnico, licenciamento . . . . . . . . . . . . . . . . 18 e suporte, custo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 suporte, endereo eletrnico . . . . . . . . . . . . . . . . . . 41 c o suporte, licenciamento . . . . . . . . . . . . . . . . . . . . . . . 18 suporte, para sistemas operacionais . . . . . . . . . . . 78 suporte, termos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 suporte, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 supresso, valores padro . . . . . . . . . . . . . . . . . . . . . 99 a a supresso, valores padres . . . . . . . . . . . . . . . . . . . . 53 a o Sybase, compatibilidade . . . . . . . . . . . . . . . . . . . . . 614 syntax, opo do mysqlcc . . . . . . . . . . . . . . . . . . . 355 ca syntax_file, opo do mysqlcc . . . . . . . . . . . . . 355 ca

T
tabela db, ordenando . . . . . . . . . . . . . . . . . . . . . . . . tabela de permisses, ordenando . . . . . . . . . 241, o tabela de sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . tabela est cheia . . . . . . . . . . . . . . . . . . . . . . . . . . . . a tabela host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . tabela host table, ordenando . . . . . . . . . . . . . . . . tabela user, ordenando . . . . . . . . . . . . . . . . . . . . . tabela, alterando . . . . . . . . . . . . . . . . . . . . . . . . . . . tabela, aumnetando performance . . . . . . . . . . . . . tabela, permisses . . . . . . . . . . . . . . . . . . . . . . . . . . o tabelas abertas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . tabelas BDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . tabelas Berkeley DB . . . . . . . . . . . . . . . . . . . . . . . . tabelas compactadas . . . . . . . . . . . . . . . . . . . . . . . . tabelas compactadas, formato . . . . . . . . . . . . . . . tabelas constantes . . . . . . . . . . . . . . . . . . . . . . . . . . tabelas de permisses, recriando . . . . . . . . . . . . . o tabelas dinmicas, caracter a isticas . . . . . . . . . . . . 243 243 425 919 244 243 241 610 446 245 451 698 698 336 635 432 261 635

tabelas HEAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642 tabelas ISAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641 tabelas temporrias, problemas . . . . . . . . . . . . . . 939 a tabelas transacionais . . . . . . . . . . . . . . . . . . . . . . . . . 46 tabelas, abrindo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 tabelas, aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564 tabelas, alterando . . . . . . . . . . . . . . . . . . . . . . . . . . . 938 tabelas, alterando a ordem das colunas . . . . . . . 938 tabelas, atualizando . . . . . . . . . . . . . . . . . . . . . . . . . . 46 tabelas, carregando dados . . . . . . . . . . . . . . . . . . . 176 tabelas, constante. . . . . . . . . . . . . . . . . . . . . . . . . . . 425 tabelas, contando regitros . . . . . . . . . . . . . . . . . . . 188 tabelas, copiando . . . . . . . . . . . . . . . . . . . . . . . . . . . 600 tabelas, criando . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 tabelas, deletando . . . . . . . . . . . . . . . . . . . . . . . . . . 612 tabelas, deletando linhas . . . . . . . . . . . . . . . . . . . . 933 tabelas, descarregando . . . . . . . . . . . . . . . . . . 361, 366 tabelas, desfragmentaao . . . . . . . . . . . . . . . . . . . . 635 c tabelas, desfragmentar . . . . . . . . . . . . . . . . . . . . . . 292 tabelas, exibindo . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 tabelas, fechando . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 tabelas, fuso de . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638 a tabelas, ID unico para o ultimo registro . . . . . . 862 tabelas, informaoes . . . . . . . . . . . . . . . . . . . . . . . . 293 c tabelas, informaoes sobre . . . . . . . . . . . . . . . . . . . 192 c tabelas, laterando . . . . . . . . . . . . . . . . . . . . . . . . . . . 608 tabelas, mostrando status . . . . . . . . . . . . . . . . . . . 304 tabelas, muitas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 tabelas, nomes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 tabelas, optimizando . . . . . . . . . . . . . . . . . . . . . . . . 291 tabelas, ordenando registros . . . . . . . . . . . . . . . . . 180 tabelas, recuperando dados . . . . . . . . . . . . . . . . . . 177 tabelas, regime de manutenao . . . . . . . . . . . . . . . 292 c tabelas, reparando . . . . . . . . . . . . . . . . . . . . . . . . . . 289 tabelas, selecinando colunas . . . . . . . . . . . . . . . . . 179 tabelas, selecionado registros . . . . . . . . . . . . . . . . 178 tabelas, tamanho mximo . . . . . . . . . . . . . . . . . . . . 10 a tabelas, tipos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630 tabelas, travamento . . . . . . . . . . . . . . . . . . . . . . . . . 443 tabelas, vericaao . . . . . . . . . . . . . . . . . . . . . . . . . . 283 c tabelas, vericando erros . . . . . . . . . . . . . . . . . . . . 288 table is full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 table, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . 349 c tables, desfragmentaao . . . . . . . . . . . . . . . . . . . . . 298 c tables, ush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 tables, fragmentaao . . . . . . . . . . . . . . . . . . . . . . . . 298 c tables, multiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 tables, RAID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606 tamanho das tabelas . . . . . . . . . . . . . . . . . . . . . . . . . 10 tamanho de buer do servidor mysqld . . . . . . . . 454 tamanho, display . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 tar, problemas no Solaris . . . . . . . . . . . . . . . . . . . . 144 Tcl, API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888 TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 tebela de permisses, atualizando . . . . . . . . . . . . 130 o tee, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 c tempo esgotado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 tempo excedido, connect_timeout varivel . . . 350 a

Concept Index

1121

tempo limite . . . . . . . . . . . . . . . . . . . . . . . . . . . 553, 583 terminal monitor, denio . . . . . . . . . . . . . . . . . . 168 ca testando a instalao . . . . . . . . . . . . . . . . . . . . . . . . 112 ca testando mysqld, mysqltest . . . . . . . . . . . . . . . . . . 896 testando o servidor . . . . . . . . . . . . . . . . . . . . . . . . . 112 testando, conectando ao servidor . . . . . . . . . . . . . 239 testando, releases do MySQL . . . . . . . . . . . . . . . . . 82 testes ps-instalaao . . . . . . . . . . . . . . . . . . . . . . . . 111 o c testing, installation . . . . . . . . . . . . . . . . . . . . . . . . . 112 Texinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 TEXT , valores padres em campos . . . . . . . . . . . . 498 o TEXT, indexando colunas. . . . . . . . . . . . . . . . . . . . . 603 TEXT, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 texto, arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 thread, suporte de . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357, 896 threads, clientes em . . . . . . . . . . . . . . . . . . . . . . . . . 863 threads, diferenas entre pacotes . . . . . . . . . . . . 1090 c threads, exibindo . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 threads, RTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1088 timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 timeout, connect_timeout variable. . . . . . . . . . . 356 TIMESTAMP e valores NULL . . . . . . . . . . . . . . . . . . . . 933 tipo, converso de . . . . . . . . . . . . . . . . . . . . . . . . . . 504 a tipos de campos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 tipos de dados, C API . . . . . . . . . . . . . . . . . . . . . . 775 Tipos de data e hora . . . . . . . . . . . . . . . . . . . . . . . . 489 tipos de data, Y2K assuntos . . . . . . . . . . . . . . . . . 490 tipos de suporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 tipos de tabela, escolhedo . . . . . . . . . . . . . . . . . . . 630 tipos string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 tipos strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 tipos, campos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 tipos, data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 tipos, hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 tipos, numricos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 e tipos, portabilidade . . . . . . . . . . . . . . . . . . . . . . . . . 502 ToDo list for MySQL . . . . . . . . . . . . . . . . . . . . . . . . 27 TODO, servidor embutido . . . . . . . . . . . . . . . . . . . 866 TODO, symlinks . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 tools, graphical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 tools, GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 trabalhos no MySQL . . . . . . . . . . . . . . . . . . . . . . . . . 16 Tradutores, lista de . . . . . . . . . . . . . . . . . . . . . . . . . 952 transaoes, suporte . . . . . . . . . . . . . . . . . . . . . . 46, 643 c translations_path, opao do mysqlcc . . . . . . . 355 c tratando erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906 travamento, mtodos . . . . . . . . . . . . . . . . . . . . . . . 1087 e treinamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

ultimo registro, ID unico . . . . . . . . . . . . . . . . . . . . 862 unbuffered, opao mysql . . . . . . . . . . . . . . . . . . . . 348 c unico, ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862 Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 UNIQUE, restriao . . . . . . . . . . . . . . . . . . . . . . . . . . 52 c unnamed views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 uptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 URLS para download do MySQL . . . . . . . . . . . . . 75 usando multiplos discos para guardar dados . . . 468 user, opao do mysqlcc . . . . . . . . . . . . . . . . . . . . . 356 c user, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . 349 c uso de memria, myisamchk . . . . . . . . . . . . . . . . . 286 o uso, do MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 usurio, funoes de nidas, adicionando . . . . . . 900 a c usurios, adicionando . . . . . . . . . . . . . . . . . . . . . . . . 92 a usurios, adicionando privilgios . . . . . . . . . . . . . 261 a e usurios, deletando . . . . . . . . . . . . . . . . . . . . . . . . . 264 a usurios, do MySQL . . . . . . . . . . . . . . . . . . . . . . . . 420 a usurios, funoes denidas por . . . . . . . . . . . . . . . 899 a c usuarios, root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 usurios, variveis . . . . . . . . . . . . . . . . . . . . . . . . . . 474 a a UTF-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 utilitrios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944 a

V
valor de retorno, UDFs . . . . . . . . . . . . . . . . . . . . . . 906 valores negativos. . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 valores padro, supresso . . . . . . . . . . . . . . . . . . . . . 99 a a valores padres . . . . . . . . . . . . . . . . . . . . 418, 579, 602 o valores padres em campos BLOB e TEXT . . . . . . 498 o valores padres, supresso . . . . . . . . . . . . . . . . . . . . 53 o a varveis de ambiente . . . . . . . . . . . . . . . . . . . . . . . . 216 a VARCHAR, tamanho . . . . . . . . . . . . . . . . . . . . . . . . . . 503 variveis de ambiente . . . . . . . . . . . . . . 253, 331, 345 a variveis de ambientes, lista . . . . . . . . . . . . . . . . 1092 a variveis de sistema . . . . . . . . . . . . . . . . . . . . . . . . . 475 a variveis de usurios . . . . . . . . . . . . . . . . . . . . . . . . 474 a a variaveis, mysqld . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 variveis, status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 a variveis, valores . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 a velocidade da inserao . . . . . . . . . . . . . . . . . . . . . . 438 c velocidade das consultas . . . . . . . . . . . . . . . . 423, 431 velocidade de compilaao . . . . . . . . . . . . . . . . . . . . 456 c velocidade de ligaao . . . . . . . . . . . . . . . . . . . . . . . . 456 c velocidade, aumentado . . . . . . . . . . . . . . . . . . . . . . 378 vendendo produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 verbose, opao mysql . . . . . . . . . . . . . . . . . . . . . . . 349 c vericaao de permisses, efeito na velocidade c o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 vericando erros em tabelas . . . . . . . . . . . . . . . . . 288 verso, escolhendo . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 a verso, ultima . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 a version, opao do mysqlcc . . . . . . . . . . . . . . . . . . 356 c version, opao mysql . . . . . . . . . . . . . . . . . . . . . . . 349 c vertical, opao mysql . . . . . . . . . . . . . . . . . . . . . . 347 c views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 viso geral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 a

U
UCS-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UDFs, compilando . . . . . . . . . . . . . . . . . . . . . . . . . . UDFs, deniao . . . . . . . . . . . . . . . . . . . . . . . . . . . . c UDFs, valor de retorno . . . . . . . . . . . . . . . . . . . . . . 710 906 899 906

1122

MySQL Technical Reference for Version 5.0.0-alpha

viso geral da instalaao. . . . . . . . . . . . . . . . . . . . . . 94 a c Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 878

W
wait, opao mysql . . . . . . . . . . . . . . . . . . . . . . . . . . c Well-Known Binary, formato . . . . . . . . . . . . . . . . Well-Known Text, formato . . . . . . . . . . . . . . . . . . Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows, assuntos em aberto . . . . . . . . . . . . . . . . Windows, atualizando . . . . . . . . . . . . . . . . . . . . . . . 349 741 740 870 136 132

Windows, compilando no . . . . . . . . . . . . . . . . . . . . Windows, versus Unix. . . . . . . . . . . . . . . . . . . . . . . WKB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WKT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . wrappers, Eiel . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

134 134 741 740 877 888

X
xml, mysql option . . . . . . . . . . . . . . . . . . . . . . . . . . . 348