Para compilar apenas as bibliotecas clientes do MySQL e programas clientes e não o servidor, use a opção --without-server:

shell> ./configure --without-server

Se você não possui um compilador C++, mysql não irá compilar (ele é o programa cliente que exige C++). Neste caso, você pode remover o código no configure que testa pelo compilador C++ e executar ./configure com a opção --without-server. O passo da compiação continuará tentaindo construir mysql, mas você pode ignorar as advertências sobre mysql.cc. (Se o make parar, tente make -k para continuar com o resto da compilação mesmo se erros ocorrerem.)

Se você quiser uma biblioteca embutida do MySQL (libmysqld.a) você deve usar a opção --with-embedded-server.

Se você não deseja que seus arquivos de logs e diretórios de bancos de dados fiquem 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 diretório instalação para que tudo seja instalado sobre /usr/local/mysql em vez do padrão /usr/local. O segundo comando preserva o diretório da instalação padrão, mas altera a localização padrão para diretórios de bancos de dados (normalmente /usr/local/var) e altera para /usr/local/mysql/data. Depois de ter compilado o MySQL, você pode alterar estas opçãoes com arquivos de opções. See Secção 4.1.2, “Arquivo de Opções my.cnf”.

Se você estiver usando Unix e deseja que o arquivo socket do MySQL fique em um diretório diferente do padrão (normalmente no diretório /tmp ou /var/run) use 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ê também pode, mais tarde, alterar a localização de mysql.sock usando os arquivos de opções do MySQL. See Secção A.4.5, “Como Proteger ou AlterarHow to Protect or Change the MySQL Socket File /tmp/mysql.sock”.

Se você deseja compilar programas linkeditados estaticamente (por exemplo, para criar uma distribuição binária, obter mais velocidade, ou evitar problemas com algumas distribuições Red Hat Linux), execute configure desta forma:

shell> ./configure --with-client-ldflags=-all-static \
--with-mysqld-ldflags=-all-static

Se você estiver usando gcc e não tem libg++ ou libstdc++ instalados você pode dizer ao configure para usar o gcc como seu compilador C++:

shell> CC=gcc CXX=gcc ./configure

Quando você usar como seu compilador C++, ele não tentará ligar com o libg++ ou libstdc++. Isto pode ser uma boa idéia para se fazer se você tiver as bibliotecas acimas instaladas, já que algumas versões destas bibliotecas tem causado problemas estranhos para utilizadores do MySQL no passado.

Segue algumas configurações de variáveis de ambiente comuns, dependendo do compilador que você estiver usando:

Na maioria dos casos você pode obter um binário MySQL razoavelmente otimizado usando as opções acima e adicionar as seguintes opções para a linha de configuração:

--prefix=/usr/local/mysql --enable-assembler \
--with-mysqld-ldflags=-all-static

A linha completa de configuração deverá ser, em outras palavras, algo como o seguinte para todas as versões recentes do gcc:

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 binários que fornecemos no site Web MySQL em http://www.mysql.com são todos compilados com otimização plena e deve ser perfeito para a maioria dos utilizadores. See Secção 2.2.8, “Binários MySQL compilados pela MySQL AB”. Existem algumas definições de configuração que você pode alterar para criar um binário ainda mais rápido, mas isto é somente para utilizadores avançados. See Secção 5.5.3, “Como a Compilação e a Ligação Afetam a Velocidade do MySQL”.

Se a construção falhar e produzir erros sobre seu compilador ou linkeditor não estarem aptos para criarem a biblioteca compartilhada libmysqlclient.so.r# ('r#' é um número de versão), você pode evitar este problema fornecendo a opção --disable-share para o configure. Neste caso, configure não construirá uma biblioteca libmysqlclient.so.* compartilhada.

Você pode configurar o MySQL para não usar valores de campos DEFAULT para campos não-NULL (isto é, campos que não podem ser NULL). See Secção 1.8.5.2, “Restrições de NOT NULL”.

shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS ./configure

Por padrão, o MySQL usa o conjunto de caracteres ISO-8859-1 (Latin1). Para alterar o conjunto padrão, use a opção --with-charset:

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. See Secção 4.7.1, “O Conjunto de Caracteres Utilizado para Dados e Ordenação”.

Se você desja converter os caracteres entre o servidor e o cliente, você deve dar uma olhada no comando SET OPTION CHARACTER SET. See Secção 5.5.6, “Sintaxe de SET”.

Cuidado: Se você alterar o conjunto de caracteres depois de ter criado qualquer tabela, você deve executar myisamchk -r -q --set-character--set=charset em cada tabela. Seus índices podem ser ordenados incorretamente. (Isto pode acontecer se você instalar o MySQL, criar algumas tabelas, depois reconfigurar o MySQL para usar um conjunto diferente de caracteres e reinstalá-lo).

Com a opção --with-extra-charset=LISTA você pode definir qual conjunto de caracteres adicionais deve ser compilado no servidor.

Aqui LISTA é uma lista de conjuntos de caracteres separados por espaços, complex para incluir todos caracteres que não podem ser carregados dinamicamente ou all para incluir todos os conjuntos nos binários.

Para configurar o MySQL com código para depuração, use a opção --with-debug:

shell> ./configure --with-debug

Isto inclui uma alocação segura de memória que pode encontrar alguns erros e fornecer saída sobre o que está acontecendo. See Secção E.1, “Depurando um Servidor MySQL”.

Se seus programas clientes usam threads, você precisará também compilar uma versão thread-safe da biblioteca cliente do MySQL com as opções do configure --enable-thread-safe-client. Isto irá criar uma biblioteca libmysqlclient_r com o qual você deverá ligar suas aplicações que fazem uso de threads. See Secção 12.1.14, “Como Fazer um Cliente em Threads”.

Opções que pertençam a sistemas particulares podem ser encontrados na seção com detalhes específicos de sistemas neste manual. See Secção 2.6, “Notas específicas para os Sistemas Operacionais”.

Se configure é executado depois dele já ter sido chamado, ele pode usar informação que foi colhida durante a chamada anterior. Esta informação é armazenada no arquivo config.cache. Quando configure inicia, ele procura por este arquivo, lê seu conteúdo, se ele existir, assumindo que aquela informação continua correta. Essa conjetura é inválida quando você reconfigurar.

Cada vez que você executa configure, você deve executar make de novo para recompilar. Entretanto, você pode desejar remover primeiro antigos arquivos objeto de construções anteriores, porque eles foram compilados usando diferentes opções de configuração.

Se você obtêm erros quando sql_yacc.cc como os mostrados abaixo, você provavelmente tem de falta de memória ou espaço de swap:

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 memória para compilar sql_yacc.cc com funções inline. Tente executando configure com a opção --with-low-memory:

shell> ./configure --with-low-memory

Esta opção adiciona -fno-inline na a linha de compilação se você estiver usando gcc e -O0 se você estiver usando outro programa. Você deve tentar a opção --with-low-memory mesmo se você tiver muita memória e espaço de swap que você ache ser suficieente para não ocorrer erros. Este problema tem ocorrido mesmo em sistemas com boas configurações de hardware e a opção --with-low-memory geralmente corrige isto.

Por padrão, configure escolhe c++ como o nome do compilador e GNU c++ liga com -lg++. Se você estiver usando gcc, este comportamento pode causar problemas durante a compilação, como o seguinte:

configure: error: installation or configuration problem:
C++ compiler cannot create executables.

Você podem também ter problemas durante a compilação relacionados à g++, libg++ ou libstdc++.

Uma causa destes problemas é que você pode não ter g++ ou você pode ter g++ mas não ter o libg++ ou o libstdc++. De uma olhada no arquivo config.log. Ele deve conter a razão exata do porque seu compilador C++ não funciona! Para trabalhar evitando estes problemas, você pode usar gcc como seu compilador C++. Tente configurar a variável de ambiente CXX para "gcc -O3". Por exemplo:

shell> CXX="gcc -O3" ./configure

Isto funciona porque gcc compila código fonte C++ tão bem quanto g++ faz, mas não ifaz a ligação em libg++ ou libstdc++ por padrão.

Outra forma de corrigir estes problemas, com certeza, é instalando g++, libg++ e libstdc++. No entanto gostariamos de lhe recomendar a não usar libg++ ou libstdc++ com o MySQL já que isto irá aumentar o tamanho do binário do mysqld sem lhe trazer nenhum benefício. Algumas versões destas bibliotecas também tem causado problemas estranhos para os utilizadores MySQL no passado.

Usar gcc como compilador C++ também é exigido, se você quiser compilar o MySQL com a funcionalidade RAID (veja Secção 6.5.3, “Sintaxe CREATE TABLE” para mais informações sobre tipos de tabela RAID) e você estiver usando o GNU gcc versão 3 e acima. Se você obter erros como estes abaixo durante o estágio de ligação quando você configurar o MySQL para compilar com a opção --with-raid, tente usar o gcc como o seu compilador C++ definindo a variável de ambiente CXX mencionada acima:

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':
: undefined reference to `operator delete(void*)'
collect2: ld returned 1 exit status

Se sua compilação falhar com erros, como um dos seguintes, você deve atualizar sua versão de make para GNU make:

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 são conhecidos por terem alguns problemas com o make.

O GNU make versão 3.75 irá funcionar.

Se você deseja definir algumas opções que devem ser usadas pelo seu compilador C ou C++, adicione as opções para as variáveis de ambiente CFLAGS e CXXFLAGS. Você pode também especificar os nomes do compilador a ser usado da mesma forma utilizando CC e CXX. Exemplo:

shell> CC=gcc
shell> CFLAGS=-O3
shell> CXX=gcc
shell> CXXFLAGS=-O3
shell> export CC CFLAGS CXX CXXFLAGS

Olhe em Secção 2.2.8, “Binários MySQL compilados pela MySQL AB” para uma lista de definição de opções que tenham sido úteis em vários sistemas.

Se você recebeu uma mensagem de erro como esta, é necessário atualizar o compilador 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, o configure não detectou corretamente o tipo do último argumento para accept(), 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 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 regenera config.h.)

O arquivo sql_yacc.cc é gerado pelo sql_yacc.yy. Normalmente o processo de construção não necessita criar sql_yacc.cc, porque o MySQL já vem com uma cópia pré-gerada. Entretanto, se você necessita recriá-lo você pode encontrar este erro:

"sql_yacc.yy", line xxx fatal: default action causes potential...

Isto é um indício de que sua versão do yacc é deficiente. Provavelmente você precisará instalar o bison (a versão GNU de yacc) e usá-lo no lugar do yacc.

Se você necessita depurar mysqld ou um cliente MySQL, execute configure com a opção --with-debug, então recompile e ligue seus clientes com a nova biblioteca cliente. See Secção E.2, “Depurando um cliente MySQL.”.

Se você tem um erro de compilação no Linux (ex. SuSE Linux 8.1 ou Red Hat Linux 7.3) parecido com o seguinte:

libmysql.c:1329: warning: passing arg 5 of `gethostbyname_r' from incompatible pointer type
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 padrão, o script configure tenta determinar o número correto de argumentos usando o compilador GNU C++ g++. Ele testa os resultados errados permitidos, se o g++ não está instalado. Existem dois modos de contornar este problema:

Note que você precisa executar o configure novamente após isto.

Na maioria dos sitemas, você pode forçar o uso de MIT-pthreads executando o configure com a opção --with-mit-threads:

shell> ./configure --with-mit-threads

Construção em um diretório não fonte não é suportado com o uso de MIT-pthreads, porque nós queremos minimizar nossas alterações para este código.

As verificações que determinam se MIT-pthreads será usado ou não, ocorrerá somente durante a parte do processo de configuração que trata com o código do servidor. Se você configurou a distribuição usando --without-server para construir somente o código cliente, clientes não irão saber se o MIT-pthreads está sendo usado e irá usar conexões socket Unix por padrão. Como os sockets Unix não funcionam sob MIT-pthreads, isto significa que você precisará usar -h ou --host quando executar programas clientes.

Quando o MySQL é compilado usando MIT-pthreads, travas de sistema são desabilitadas por padrão por razões de performance. Você pode dizer ao servidor para usar travas de sistema com a opção --external-locking. Isto só é necessário se você quiser executar dois servidores MySQL no mesmo diretório de dados (no que não é 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 conexões ao servidor falham. Por exemplo:

shell> mysqladmin version
mysqladmin: connect to server at '' failed;
error: 'Can't connect to mysql server on localhost (146)'

A solução para isto é matar o servidor mysqld e reiniciá-lo. Isto só aconteceu conosco quando forçamos uma queda do servidor e fizemos uma reinicialização imediata.

Com MIT-pthreads, a chamada de sistema sleep() não é interrompível com SIGINT (break). Isto só é percebido quando você executa mysqladmin --sleep. Você deve esperar pela chamada sleep() para terminar, antes da interrução ser servida e o processo parar.

Na ligação, você pode receber mensagens de alerta como estes (pelo menos no Solaris); 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 também podem ser ignorados:

implicit declaration of function `int strtoll(...)'
implicit declaration of function `int strtoul(...)'

Não colocamos readline para funcionar com MIT-pthreads. (Isto não é necessário, mas pode ser interessante para alguns.)

Compilador VC++ 6.0 (atualizado com o SP 4 ou 5 e pacote Pre-processador) O pacote Pre-processador é necessário para a macro assembler. Mais detalhes em: http://msdn.microsoft.com/vstudio/downloads/updates/sp/vs6/sp5/faq.aspx.

Aproximadamente 45 MB de espaço em disco.

64 MB de RAM