You are on page 1of 54

MySQL Query Browser

MySQL Query Browser


Esta uma traduo do manual MySQL Query Browser que pode ser encontrado em dev.mysql.com. O Manual MySQL Query Browser original em ingls e esta traduo no obrigatoriamente to atualizada quanto a verso original. Abstract Este o Manual do MySQL Query Browser. Documento gerado em: 2010-03-11 (revision: 241)
Copyright 1997-2007 MySQL AB, 2008-2010 Sun Microsystems, Inc. All rights reserved. U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms. Sun, Sun Microsystems, the Sun logo, Java, Solaris, StarOffice, MySQL Enterprise Monitor 2.0, MySQL logo and MySQL are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Copyright 1997-2007 MySQL AB, 2008-2010 Sun Microsystems, Inc. Tous droits r?serv?s. L'utilisation est soumise aux termes du contrat de licence.Sun, Sun Microsystems, le logo Sun, Java, Solaris, StarOffice, MySQL Enterprise Monitor 2.0, MySQL logo et MySQL sont des marques de fabrique ou des marques d?pos?es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. UNIX est une marque d?pos?e aux Etats-Unis et dans d'autres pays et licenci?e exlusivement par X/Open Company, Ltd. This documentation is NOT distributed under a GPL license. Use of this documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how MySQL disseminates it (that is, electronically for download on a Web site with the software) or on a CD-ROM or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of MySQL AB. MySQL AB reserves any and all rights to this documentation not expressly granted above. Please contact the http://www.mysql.com/company/contact/ for more information or if you are interested in doing a translation.

Table of Contents
1. Introduo ao programa MySQL Query Browser .....................................................................................1 2. Instalao ....................................................................................................................................2 2.1. Introduo .........................................................................................................................2 2.2. Instalando sob o Sistema Operacional Windows ............................................................................2 2.2.1. Utilizando o Instalador do Windows ................................................................................2 2.2.2. Instalando a Partir de um Arquivo ZIP .............................................................................2 2.3. Instalando sob Sistema Operacional Linux ...................................................................................2 2.3.1. Instalando o Tarball Genrico .......................................................................................2 2.3.2. Instalao RPM ........................................................................................................3 2.4. Instalando Sob Sistema Operacional Mac OS X ............................................................................4 3. Removendo as Ferramentas GUI MySQL ..............................................................................................5 3.1. Desintalar Windows ...........................................................................................................5 3.2. Desinstalar Linux ..............................................................................................................5 3.3. Desintalar OS X ...............................................................................................................5 4. Executando MySQL GUI Tools .........................................................................................................6 4.1. Executando sob o Sistema Operacional Windows ..........................................................................6 4.2. Executando sob Sistema Operacional Linux .................................................................................6 4.3. Executando sob Sistema Operacional Mac OS X ...........................................................................6 5. A Caixa de Dilogo de Conexo do MySQL Query Browser .......................................................................8 5.1. Caixa de Dilogo de Conexo ..................................................................................................8 6. Uma Turn pelo MySQL Query Browser ............................................................................................ 11 6.1. A Janela Principal de Query .................................................................................................. 11 6.2. A Barra de Ferramentas Query ............................................................................................... 12 6.2.1. Os Botes de Navegao ........................................................................................... 12 6.2.2. A rea de Query ..................................................................................................... 12 6.2.3. Os Botes de Ao .................................................................................................. 13 6.3. A Barra de Ferramentas Avanada .......................................................................................... 13 6.4. A rea de Resultados ......................................................................................................... 13 6.5. O Navegador de Objetos ...................................................................................................... 14 6.5.1. O Navegador de Banco de Dados ................................................................................. 14 6.5.2. O Navegador de Marcadores ....................................................................................... 15 6.5.3. O Navegador de Histrico .......................................................................................... 15 6.6. O Navegador de Informaes ................................................................................................ 16 6.6.1. O Navegador de Sintaxe ............................................................................................ 16 6.6.2. O Navegador de Funes ........................................................................................... 16 6.6.3. O Navegador de Parmetros ....................................................................................... 16 6.6.4. O Navegador de Transaes ....................................................................................... 16 6.7. O Editor de Scripts ............................................................................................................ 16 6.7.1. Os Botes de Depurao de Erros de Script ..................................................................... 18 6.7.2. A rea de Script ..................................................................................................... 19 7. Utilizando o MySQL Query Browser ................................................................................................. 20 7.1. Acessando e Editando Queries Manualmente .............................................................................. 20 7.2. Construindo Queries ........................................................................................................... 20 7.3. Criando Views ................................................................................................................. 21 7.4. Navegando em Conjuntos de Resultados na rea de Resultados ....................................................... 21 7.5. Exportando Grupos de Resultados .......................................................................................... 22 7.6. Manuseando Colunas BLOB e TEXT ...................................................................................... 22 7.7. Editando Grupo de Resultados Dentro da rea de Resultados .......................................................... 22 7.8. Comparando Grupos de Resultados ......................................................................................... 23 7.9. Criando views Master-Detail ................................................................................................. 23 7.10. Gerenciando Stored Procedures e Functions com o MySQL Query Browser ....................................... 24 7.11. Editando Queries a Partir de uma Ferramenta de Desenvolvimento .................................................. 24 8. O MySQL Table Editor ................................................................................................................. 26 8.1. Introduo ....................................................................................................................... 26 8.2. A Janela do Editor Principal .................................................................................................. 26 8.3. A Aba de Colunas e ndices .................................................................................................. 27 8.3.1. O Editor de Coluna .................................................................................................. 27 8.3.2. A rea de Detalhes .................................................................................................. 27 8.4. A Aba Opes da Tabela ..................................................................................................... 28 8.5. A Aba Opes Avanadas .................................................................................................... 29 8.5.1. A Seo Diversos .................................................................................................... 29 8.5.2. A Seo Opes de Fileira ......................................................................................... 29 8.5.3. A Seo Opes de Armazenamento ............................................................................. 29 8.5.4. A Seo Opes de Mescla de Tabelas ........................................................................... 29 iv

MySQL Query Browser

8.5.5. A Seo de Configurao de Tabela RAID ...................................................................... 29 8.6. Aplicando Suas Modificaes ................................................................................................ 29 9. Caixa de Dilogo de Opes ........................................................................................................... 31 9.1. Introduo ....................................................................................................................... 31 9.2. Opes Gerais .................................................................................................................. 31 9.3. Conexes ........................................................................................................................ 32 9.4. Editores .......................................................................................................................... 34 9.5. A Seo Browser ............................................................................................................... 34 9.5.1. Opes de Exposio ............................................................................................... 35 9.5.2. Opes de Declarao .............................................................................................. 35 9.5.3. Diversos ............................................................................................................... 36 A. Instalando a partir dos Fontes .......................................................................................................... 37 A.1. Introduo ...................................................................................................................... 37 A.2. Fazendo o Download do Cdigo-Fonte .................................................................................... 37 A.3. Gerando a partir dos fontes sob o Windows ............................................................................... 37 A.3.1. Pr-Requisitos ....................................................................................................... 37 A.3.2. Compilando e Gerando ............................................................................................. 37 A.4. Gerando o Sistema a Partir dos Fontes sob a Plataforma Linux ........................................................ 39 A.4.1. Pr-Requisitos ....................................................................................................... 39 A.5. Compilando e Gerando ....................................................................................................... 40 A.5.1. Gerando Binrios Estticos ........................................................................................ 40 A.5.2. Gerando RPMs ...................................................................................................... 41 B. Analisando Erros da Aplicao ........................................................................................................ 42 B.1. Analisando Erros de Conexo ............................................................................................... 42 B.2. Analisando Problemas de Visualizao .................................................................................... 42 C. Como so armazenadas conexes ..................................................................................................... 43 D. Arquivos XML comuns a todas as aplicaes GUI MySQL ...................................................................... 44 E. Arquivos XML usados pelo MySQL Query Browser .............................................................................. 45 F. Notas para Tradutores ................................................................................................................... 46 G. Software de Terceiros utilizados nas ferramentas GUI MySQL .................................................................. 47 G.1. Biblioteca PCRE .............................................................................................................. 47 G.2. Suporte PNG ................................................................................................................. 47

List of Figures
5.1. Caixa de Dilogo de Conexes ........................................................................................................8 6.1. A janela principal de query do MySQL Query Browser ......................................................................... 11 6.2. A rea de Query expandida a 10 linhas ............................................................................................. 12 6.3. Os cones de estado do MySQL Query Browser .................................................................................. 13 6.4. A Barra de Ferramentas Avanada .................................................................................................. 13 6.5. O navegador de Banco de Dados .................................................................................................... 14 6.6. O Editor de Scripts .................................................................................................................... 16 6.7. A Caixa de dilogo Abrir Arquivo .................................................................................................. 17 7.1. A Ferramenta Tabela .................................................................................................................. 20 7.2. O cones de Manuseio de Campos BLOB .......................................................................................... 22 7.3. A listagem parmetros dinmicos ................................................................................................... 23 7.4. Stored Procedure no Navegador de Banco de Dados ............................................................................. 24 8.1. O MySQL Table Editor ............................................................................................................... 26 8.2. O Editor de Colunas ................................................................................................................... 27 8.3. O Editor de ndices .................................................................................................................... 27 8.4. A Caixa de Dilogo de Confirmao de Edio de Tabela ...................................................................... 29 9.1. Caixa de dilogo de Opes .......................................................................................................... 31 9.2. Caixa de dilogo de Opes: Conexes ............................................................................................ 32 9.3. A Caixa de Dilogo de Opes do Query Browser ............................................................................... 35 B.1. Caixa de Dilogo de Mensagem de Erro ........................................................................................... 42

vi

List of Tables
A.1. Componentes Requeridos ............................................................................................................ 39 A.2. Requisitos para o MySQL Query Browser ........................................................................................ 39

vii

Chapter 1. Introduo ao programa MySQL Query Browser


O MySQL Query Browser uma ferramenta grfica fornecida pela MySQL AB para criar, executar e otimizar solicitaes SQL em um ambiente grfico. Assim como o MySQL Administrator foi criado para administrar um servidor MySQL, o MySQL Query Browser foi criado para auxiliar voc a selecionar e analisar dados armazenados dentro de um Banco de Dados MySQL. Enquanto todas as solicitaes executadas no MySQL Query Browser tambm podem ser executadas pela linha de comando utilizando-se o utilitrio mysql, o MySQL Query Browser permite a execuo e edio dos dados de maneira grfica, que mais intuitiva para o usurio. MySQL Query Browser foi projetado para trabalhar com verses 4.0 ou superiores do servidor MySQL. MySQL Query Browser o resultado do esforo motivado pelo feedback que a MySQL AB tem recebido de muitos usurios em um perodo de vrios anos. Entretanto, caso entenda que um recurso importante para voc esteja faltando ou caso descubra um erro de programa, por favor use o nosso Sistema de Erros MySQL para requisitar melhorias ou reportar problemas. Para o MySQL Query Browser, existe um frum especfico disponvel em http://forums.mysql.com/list.php?108.

Chapter 2. Instalao
2.1. Introduo
MySQL GUI Tools executa em Windows, Linux e Mac OS X. Voc pode encontrar MySQL GUI Tools para o sistema operacional que deseja na pgina MySQL GUI Tools Downloads.

2.2. Instalando sob o Sistema Operacional Windows


MySQL GUI Tools roda em sistemas operacionais baseados em Windows NT 32-bit, incluindo Windows 2000, XP e 2003. No roda sob Windows NT 4 e anteriores.

2.2.1. Utilizando o Instalador do Windows


MySQL GUI Tools pode ser instalado em todos os sistemas operacionais Windows utilizando o pacote de instalao do Instalador do Windows (.msi). O pacote MSI contm um arquivo formato ZIP chamado mysql-gui-tools-version-win32.msi, onde version indica a verso MySQL GUI Tools . O Mecanismo do Instalador do Microsoft Windows foi atualizado na verso do Windows XP; Aqueles que utilizam uma verso prvia de Windows devem ler o artigo Base de Conhecimento Microsoft para informaes sobre como atualizar para a verso mais recente do mecanismo Instalador Microsoft. Adicionalmente, a Microsoft recentemente introduziu a ferramenta WiX (Windows Installer XML). Este o primeiro projeto Open Source da Microsoft que se tem em amplo conhecimento. Mudamos para o WiX porque um projeto Open Source e ele nos permite manipular um completo processo de instalao Windows de maneira flexvel utilizando scripts. Melhorar o Assistente de Instalao MySQL depende de suporte e retorno de informao de usurios como voc. Caso ache que no Assistente de Instalao MySQL estejam faltando alguns recursos importantes para voc ou descubra um erro, por favor reporte-os em nosso banco de dados de bugs utilizando-se das instrues descritas em How to Report Bugs or Problems. Para instalar MySQL GUI Tools, clique com o boto direito do mouse sobre o arquivo MSI e selecione a opo INSTALL. Na janela Setup Type voc poder selecionar a opo de instalao complete ou custom. Caso no deseje instalar todo o pacote MySQL GUI Tools selecione a opo custom. A Instalao tipo Custom tambm fornece a opo de instalar suporte a outros idiomas alm do Ingls. MySQL GUI Tools suporta os Idiomas Alemo, Grego, Japons, Polons e Portugus (Brasil). A menos que voc tenha definido outro local, MySQL GUI Tools ser instalado em C:\%PROGRAMFILES%\MySQL\MySQL Tools for version\, onde %PROGRAMFILES% o diretrio padro para programas windows em seu computador e version o nmero da verso do MySQL GUI Tools. O diretrio %PROGRAMFILES% pode ser , por exemplo, C:\Program Files ou C:\programme.

Note
Utilizar o Instalador Windows para instalar os MySQL GUI Tools criar automaticamente entradas no menu Start.

2.2.2. Instalando a Partir de um Arquivo ZIP


Caso voc tenha problemas ao executar o instalador, como alternativa, pode fazer o download do arquivo ZIP sem o instalador. Este arquivo chamado mysql-gui-tools-noinstall-version-win32.zip. Utilizando um programa que descompacte o formato ZIP, extraia o contedo do arquivo para o diretrio de sua escolha.Voc pode tambm criar atalhos para MySQLAdministrator.exe, MySQLMigrationTool.exe, MySQLQueryBrowser.exe e MySQLWorkbench.exe em sua rea de trabalho ou para a barra de atalhos.

2.3. Instalando sob Sistema Operacional Linux


MySQL GUI Tools roda sob equipamentos Linux que tenham ambiente grfico instalado. desenvolvido para rodar sob desktop Gnome com suporte a GTK2 e foi testado em kernel Linux nas verses 2.4 e 2.6. Ele tambm dever rodar em outras verses, alm de inmeros sistemas operacionais Unix-like.

2.3.1. Instalando o Tarball Genrico


O arquivo tar genrico permite que voc instale MySQL GUI Tools na maioria das distribuies Linux. O arquivo tarball chamado mysql-gui-tools-version.tar.gz, onde version indica a verso do MySQL GUI Tools (por exemplo, 5.0r3). Para ver todos os arquivos contidos no tarball, execute o seguinte comando:

Instalao

shell> tar -tzf

mysql-gui-tools-version.tar.gz

Para instalar o MySQL GUI Tools, execute o seguinte comando:


shell> tar --directory=/opt -xzvf mysql-gui-tools-version.tar.gz

Este procedimento instala diversos arquivos binrios no diretrio /opt/mysql-gui-tools-version. Caso voc instale os MySQL GUI Tools para o diretrio opt, cones, para serem usados nos atalhos da rea de trabalho ou para criar tens de menu , podero ser encontrados no diretrio opt/mysql-gui-tools-version/share/mysql-gui.

2.3.2. Instalao RPM


Adicionalmente ao tarball genrico, alguns RPMs de distribuies especficas esto disponveis. Atualmente estas incluem Red Hat Enterprise Linux (RHEL) 3 e 4, Fedora Core 5 (FC5) e SuSE Linux 10.x. Para FC5 e SuSE a ferramenta gtkmm24 requerida para instalar a verso RPM do MySQL GUI Tools. Em FC5 voc poder instalar esta ferramenta a partir da linha de comando da seguinte maneira:
shell> yum -install gtkmm24

Para instalao em Sistemas Operacionais SuSE Linux:


shell> yast2 -i gtkmm24

Note
Voc dever possuir privilgios de usurio root para executar o comando yast2. Os RPMs Red Hat so auto-suficientes, no necessitando pacotes adicionais para a instalao. Os downloads RPM so compostos de ferramentas GUI independentes combinadas em um arquivo TAR nico. Extraia os RPMs individuais da seguinte maneira:
shell> tar -zxf mysql-gui-tools-version.tar.gz

Este procedimento ir descompactar os arquivos RPM para o diretrio atual. Instale todos os arquivos RPM digitando:
shell> rpm -iv mysql-*.rpm

Caso voc esteja atualizando para uma verso mais nova de MySQL GUI Tools digite:
shell> rpm -Uv mysql-*.rpm

Caso instale os arquivos RPM individualmente, voc dever instalar o arquivo mysql-gui-tools-version.rpm primeiro para atender as necessidades de dependncias. Ao atualizar, os pacotes no podem ser instalados separadamente, pois conflitos de verso iro ocorrer caso isto seja feito. Caso deseje, voc poder instalar apenas um dos MySQL GUI Tools. Por exemplo, para instalar o MySQL Administrator somente, digite o seguinte:
shell> rpm -iv mysql-gui-toolsversion.rpm mysql-administratorversion.rpm

Caso seja possvel, o processo de instalao RPM criar atalhos no menu inicial de seu gerenciador de janelas. Por exemplo, SuSE Linux com o gerenciador de janelas KDE adicionar atalhos para MySQL GUI Tools sob os tens de menu DEVELOPMENT, OTHER TOOLS. Da mesma maneira, em FC5, atalhos sero criados sob o tem de menu DEVELOPMENT. cones, para uso como atalhos de desktop ou para criar tens de menu, podero ser encontrados no diretrio / usr/share/mysql-gui. Veja a pgina MySQL GUI Tools Downloads para a listagem mais atualizada dos diversos arquivos de pacotes RPM disponveis.

Instalao

2.4. Instalando Sob Sistema Operacional Mac OS X


Para Instalar o Administrador MySQL sob Mac OS X, d um clique-duplo no arquivo baixado .dmg e espere que o sistema seja aberto e anexado. Quando uma janela contendo os cones MySQL GUI Tools surgir na tela, arraste-a para a sua pasta de aplicaes ou qualquer outro local de sua preferncia. Assim que a cpia estiver completa, voc poder ejetar a imagem de disco.

Chapter 3. Removendo as Ferramentas GUI MySQL


Sob Linux e OS X fcil desinstalar todos as MySQL GUI Tools ou aplicaes individuais. Sob Windows, remover aplicaes individuais um pouco mais problemtico.

3.1. Desintalar Windows


Para desinstalar as MySQL GUI Tools, abra o Control Panel e selecione Add or Remove Programs. Encontre a entrada MySQL Tools e aperte o boto REMOVE. Executar esta opo desinstalar todas as ferramentas GUI.

Note
Atualmente, no h nenhuma opo de linha de comando para desisntalar as MySQL GUI Tools. Aps ter removido as MySQL GUI Tools voc poder remover o diretrio MySQL Tools for version. A menos que voc tenha definido outro durante a instalao, voc o encontrar abaixo do diretrio C:\%PROGRAMFILES%\MySQL\. Voc poder remover aplicaes individuais manualmente. V para o diretrio C:\%PROGRAMFILES%\MySQL\ e exclua os arquivos exe e chm associados com a aplicao que deseja remover. Tambm remova o cone prprio do menu Start.

Note
Remover uma aplicao manualmente no remover todos os arquivos pertencentes aplicao.

3.2. Desinstalar Linux


A menos que tenha alterado o caminho original, voc dever encontrar as MySQL GUI Tools no diretrio / opt/mysql-gui-tools-version. Caso tenha instalado as MySQL GUI Tools utilizando arquivos RPM, poder remover todas as ferramentas digitando a seguinte linha de comando:
shell> rpm -U mysql-*.rpm

Voc poder remover ferramentas individualmente usando a opo U com o nome especfico da ferramenta que quer remover. Por instncia, para remover somente a ferramenta Administrador digite:
shell> rpm -U mysql-administrator-version.rpm

Note
Lembre-se, caso voc planeje manter qualquer uma das MySQL GUI Tools voc dever manter tambm o arquivo mysql-gui-tools-version.rpm. Aps remover todas as MySQL GUI Tools, remova o diretrio /opt/mysql-gui-tools-version. Caso tenha removido somente algumas ferramentas, remova somente o diretrio associado elas. Caso tenha instalado as MySQL GUI Tools usando um tarball genrico, voc pode remover as ferramentas excluindo o diretrio / opt/mysql-gui-tools-version. Caso queira remover uma ferramenta individual, localize o diretrio associado ela e remova-o.

3.3. Desintalar OS X
Localize o diretrio onde instalou as MySQL GUI Tools, e exclua as aplicaes movendo seus cones para a lixeira (Trash).

Chapter 4. Executando MySQL GUI Tools


A maneira de executar quaisquer dos MySQL GUI Tools depende do sistema operacional que voc est usando.

4.1. Executando sob o Sistema Operacional Windows


Sob o Windows, o nome dos arquivos executveis do conjunto MySQL GUI Tools so: MySQLAdministrator.exe MySQLQueryBrowser.exe MySQLWorkbench.exe MySQLMigrationTool.exe

Execute quaisquer dos programas do MySQL GUI Tools dando um duplo-clique sobre o cone de sua rea de trabalho ou selecionando-o a partir do menu Start. Alternativamente, voc pode abrir uma janela do DOS e iniciar o programa a partir da linha de comando. por exemplo, voc poderia executar o MySQL Administrator da seguinte maneira:
C:\> "C:\%PROGRAMFILES%\MySQL\MySQL Tools for version\MySQLAdministrator.exe"

%PROGRAMFILES% o diretrio padro para os programas windows em seu computador, por exemplo C:\Program Files ou C:\programme. caso o caminho contenha espaos, voc dever adicionar aspas ao comando como mostrado acima.

4.2. Executando sob Sistema Operacional Linux


Sob Linux, os nomes dos arquivos executveis do conjunto MySQL GUI Tools so: mysql-administrator mysql-query-browser mysql-workbench

Note
No existe verso Linux do programa MySQL Migration Toolkit. Caso voc tenha instalado MySQL GUI Tools para o diretrio /opt usando o arquivo tar, mude para o diretrio / opt/mysql-gui-tools-version para executar quaisquer dos programas do MySQL GUI Tools. Para executar o MySQL Administrator voc dever digitar:
shell> ./mysql-administrator

Contudo, adicionar /opt/mysql-gui-tools-version varivel PATH torna muito mais simples a maneira de executar MySQL GUI Tools Voc no precisar se preocupar sobre seu diretrio atual de operao. Quando instalado a partir de arquivos RPM, os MySQL GUI Tools so encontrados no diretrio /usr/bin. Este diretrio geralmente incluido na varivel PATH, portanto executar quaisquer dos programas do MySQL GUI Tools simplesmente requer que se digite o nome do arquivo executvel, independentemente do seu diretrio atual. Por exemplo:
shell> mysql-administrator

Para essas distribuies, que normalmente criam tens de menu, voc tambm pode, obviamente, executar quaisquer das ferramentas selecionando o item do menu.

4.3. Executando sob Sistema Operacional Mac OS X


Sob Mac OS X, navegue para o diretrio de instalao do MySQL GUI Tools e d um clique-duplo sobre a aplicao que deseja 6

Executando MySQL GUI Tools

executar.

Note
No existe verso OS X do programa MySQL Migration Toolkit.

Chapter 5. A Caixa de Dilogo de Conexo do MySQL Query Browser


5.1. Caixa de Dilogo de Conexo
Assim que o MySQL Query Browser for iniciado, mostrar uma janela de dilogo de conexo. Voc necessitar especificar o servidor MySQL ao qual deseja se conectar, as credenciais necessrias para autorizao naquele servidor, qual mquina hospeda este servidor (e qual porta ele utiliza) e ainda o banco de dados (Schema) voc ir acessar. Voc pode tambm especificar outras opes, caso seja necessrio. Voc deve escolher um banco de dados padro para poder executar sua declaraes SQL. possvel escolher o banco de dados padro aps conectar ao servidor, porm definir o banco de dados padro a partir da caixa de dilogo de conexes pode poupar tempo em conexes posteriores.

Figure 5.1. Caixa de Dilogo de Conexes

A Caixa de Dilogo de Conexo do MySQL Query Browser

Caso a conexo com o servidor seja estabelecida com sucesso, todos os valores sero salvos para conexes futuras (veja a seo que descreve como o MySQL Query Browser armazena informaes de conexo). O campo Password , no entanto, estar sempre vazio: Por razes de segurana, a senha no armazenada junto com as outras opes, a menos que voc determine que isso seja feito, na seo General Options da Options dialog. Para definir opes de conexo avanadas, clique no boto DETAILS e marque as opes desejadas: Use compression protocol - Usar compresso ao comunicar com o servidor MySQL. Use SSL if available - Encriptar comunicaes com o servidor MySQL usando protocolo SSL. Esta opo s funciona caso a biblioteca cliente MySQL em sua mquina cliente possua o protocolo SSL habilitado. Use ANSI quotes to quote identifiers - Envolve todos os nomes de objetos em aspas-duplas ( " ) ao invs de 9

A Caixa de Dilogo de Conexo do MySQL Query Browser

acento agudo ( ). Caso tenha dificuldades para se conectar, por favor veja a seo Resolvendo Erros de Conexo no apndice Resolvendo Erros de Aplicao. Voc pode mudar quaisquer dos valores nos perfis de conexo simplesmente sobre-escrevendo os valores existentes com novos valores. Da mesma maneira, caso voc selecione um outro perfil de conexo, poder mudar quaisquer de seus valores. Ao clicar no boto OK aps mudar os valores do perfil, as mudanas s so armazenadas permanentemente caso uma conexo seja estabelecida com sucesso ao servidor MySQL. Voc tambm pode clicar no boto ... prximo caixa drop-down CONNECTION. Este procedimento mostrar a caixa de dilogo Options que possui a seo Connections para modificar o perfil de conexo. Os valores que voc pode definir so encontrados na janela de dilogo de Conexo na descrio da seo Connections do Options dialog.

10

Chapter 6. Uma Turn pelo MySQL Query Browser


6.1. A Janela Principal de Query
A partir do momento que fizer uma conexo com sucesso a um servidor MySQL voc ser apresentado a janela principal de query do MySQL Query Browser. Toda a funcionalidade da aplicao est disponvel atravs desta janela.

Figure 6.1. A janela principal de query do MySQL Query Browser

A janela principal de query dividida em vrias sees: Query Toolbar: A barra de ferramentas de query onde voc criar e executar suas queries. Ela composta de trs botes de navegao (GO BACK, NEXT e REFRESH), a rea de query, dois botes de ao (EXECUTE e STOP) e um indicador de estado. Advanced Toolbar: A barra de ferramentas avanada contm trs grupos de botes: Os botes de transao (START, COMMIT e ROLLBACK), os botes de gerenciamento de query (EXPLAIN, COMPARE) e os botes de construo de query (SELECT, FROM, WHERE e assim por diante.) A barra de ferramentas avanada s visvel quando as caixas de opo Show advanced toolbars e Show composer buttons toolbar na tela de opes do navegador esto marcadas. veja Section 9.5, A Seo Browser. Result Area: Todos os resultados da query executada so mostrados na rea de resultado. Voc pode ter mltiplas abas ativas ao mesmo tempo, permitindo que voc trabalhe em mltiplas queries. A rea de resultado pode ser dividida vertical e horizontalmente para realizar comparaes e queries em diferentes partes de uma rea de resultado dividida podem ser unidas para anlise de resultados resumo/detalhamento (master-detail). Object Browser: O Navegador de Objetos parte da barra lateral e permite a voc gerenciar seus bancos de dados, marcadores e histrico. Voc pode selecionar que banco de dados e tabelas sero pesquisadas, adicionar queries frequentemente usadas a uma coleo de marcadores e navegar atravs de queries previamente executadas permitindo que sejam usadas novamente.

11

Uma Turn pelo MySQL Query Browser

Caso existam muitos bancos de dados no seu servidor MySQL, o campo de pesquisa com o cone de lente de aumento til para filtrar o banco de dados que voc est procurando. Digitar a letra t ou T, por exemplo, ir definir o filtro para bancos de dados cujos nomes comecem com a letra t. O filtro no faz distino entre letras MAISCULAS ou minsculas (case-insensitive). Voc tambm pode filtrar os bancos de dados usando o caracteres curinga ? para substituir uma letra por qualquer caracter e * de nenhuma a qualquer quantidade de caracteres. Por exemplo, a string *boo?* ir procurar por bancos de dados com os nomes books, coursebooks, e bookings. Information Browser: O Navegador de Informaes parte da barra lateral e usado para localizar funes embutidas e para gerenciar queries que contenham parmetros. Um exemplo disto quando estabelecemos um par de queries resumo/detalhamento (master-detail). Os dados na query master esto disponveis como parmetros para a query detail.

Usando o menu VIEW, a maioria destas sees podem ser mostradas e ocultadas marcando ou desmarcando os elementos que voc deseja ver. Cada um destes tpicos ser melhor detalhado nas sees seguintes.

6.2. A Barra de Ferramentas Query


Todas as queries, se geradas automaticamente, grfica ou manualmente, aparecem na Query Toolbar. A maneira mais simples de usar o MySQL Query Browser digitando a query direto na rea de query e clicando o boto execute. Um terminador de declarao como ; ou \G no exigido.

6.2.1. Os Botes de Navegao


esquerda da rea de query esto os botes de navegao. Os botes de navegao permitem que voc navegue atravs do seu histrico de query. assim voc consegue revisar e re-executar uma query executada previamente. O histrico de query est disponvel atravs do object browser. Clicar no boto GO BACK carregar a query previamente executada no seu histrico, enquanto o boto GO NEXT carregar a query seguinte. Somente queries que executaram sem erros sero adicionadas ao seu histrico. medida que voc navega com os botes NEXT e GO BACK, as queries que so mostradas a voc no so executadas a menos que voc as execute explcitamente atravs do processo de clicar o boto EXECUTE. O boto REFRESH re-executa o ltima query executada, que pode ou no ser a query atualmente mostrada na rea de query.

6.2.2. A rea de Query


A rea de query onde os textos de todas as queries e declaraes so mostrados. Por padro, a rea de query composta por trs linhas e automaticamente se expande quando necessrio, at o limite mximo de 10 linhas de altura. Para queries com mais de 10 linhas, a rea de query se torna rolvel. Para espao adicional, voc pode pressionar a tecla F11 para maximizar a rea de query. Voc pode tambm fazer isso selecionando MAXIMIZE QUERY AREA no menu VIEW. Quando a query maximizada, a nmerao de linha mostrada e a rea de query permite ajustar seu tamanho clicando e arrastanto a linha que divide a rea de query da rea de resultados. Para restaurar a rea de query, pressione a tecla F11 novamente.

Figure 6.2. A rea de Query expandida a 10 linhas

Os seguintes comandos estaro disponveis clicando com o boto direito do mouse na rea de query: CUT (Ctrl+X), COPY (Ctrl+C), PASTE (Ctrl+V), CLEAR (Ctrl+N), OPEN QUERY ... (Ctrl+O) e SAVE QUERY AS ... (Ctrl+S). Os comandos Open e Save carregam o contedo de um arquivo SQL para dentro da rea de query ou gravam o contedo da area de query em um arquivo de texto.

12

Uma Turn pelo MySQL Query Browser

6.2.3. Os Botes de Ao
direita da rea de query se encontram os botes de ao. O boto EXECUTE executa as queries presentes na rea de query, enquanto o boto STOP encerra a execuo. Caso clique na seta para baixo localizada abaixo do boto EXECUTE, existem trs opes de execuo possveis: EXECUTE (Ctrl+Enter): Esta opo executa a query e mostra os resultados na rea de resultado atualmente ativa. EXECUTE IN NEW TAB (Ctrl+Shift+Enter ): Esta opo executa a query e mostra os resultados em um nova rea de resultados criada s para este fim. SPLIT TAB AND EXECUTE (Ctrl+Alt+Enter ): Divide a rea de resultados horizontalmente e mostra o resultado da query na metade inferior da rea de resultados.

direita dos botes de ao se encontra o indicador de estado. O indicador de estado mostra o logotipo padro do MySQL enquanto o MySQL Query Browser est em repouso e mostra um logotipo animado enquanto o MySQL Query Browser est ocupado processando uma query. Ambos os cones podem ser vistos na ilustrao seguinte:

Figure 6.3. Os cones de estado do MySQL Query Browser

6.3. A Barra de Ferramentas Avanada


Abaixo da barra de query se encontra a Advanced Toolbar. A Advanced Toolbar contm um conjunto de botes para controle de transaes, gerenciamento e construo de queries.

Figure 6.4. A Barra de Ferramentas Avanada

O painel esquerdo da barra de ferramentas avanada contm os botes de controle de transao. Da esquerda para a direita, os botes permitem que voc inicie, confirme e cancele uma transao. Da mesma maneira que ao usar o cliente de linha de comando, voc s pode usar transaes em tabelas que suportem este recurso (tabelas tipo InnoDB por exemplo). Para mais informaes sobre transaes, veja Modelo Transacional do InnoDB. O painel central fornece botes para gerenciamento de query. O boto EXPLAIN pode ser usado para obter a saida EXPLAIN para a query atual vinda do servidor MySQL, enquanto o boto COMPARE permite a voc comparar os resultados de duas queries. O prximo painel contm os botes de construo de query. Voc pode usar estes botes para construir uma query visualmente clicando nas tabelas e colunas que deseja incluir em sua query, utilizando ponteiros especiais do mouse para indicar qual parte da query os diferentes campos e tabelas iro ocupar. O painel direito contm o boto CREATE VIEW. Mais informaes sobre o boto CREATE VIEW pode ser obtida na seo Criando Views.

6.4. A rea de Resultados


Todos os resultados das queries so mostrados na rea de resultados. Com a rea de resultados voc pode usar multiplas abas e reas de resultado individuais podem ser divididas tanto horizontal como verticalmente. Novas abas podem ser criadas selecionando a opo EXECUTE IN NEW TAB na barra de query ou ainda clicando o boto NEW TAB localizado no alto da rea de resultados. Adicionalmente, voc tambm pode clicar com o boto da direita do mouse sobre a rea de resultados atual e escolher a opo ADD NEW TABSHEET (CTRL+T). Abas individuais so fechadas tanto ao clicar com o boto direito do mouse na rea de resultados e selecionando a opo REMOVE TAB quanto ao clicar no cone X da aba que deseja fechar. Para dividir a rea de resultados, clique com o boto da direita do mouse sobre ela e escolha a opo SPLIT TAB VERTICALLY ou a 13

Uma Turn pelo MySQL Query Browser

opo SPLIT TAB HORIZONTALLY. Aps dividir a rea de resultados voc pode escolher uma metade da rea de resultados e ver os conjuntos de resultados dentro dela. Voc pode remover sees da rea de resultado ao clicar com o boto direito do mouse na seo que deseja remover e clicar em REMOVE RESULTSET. Ao navegar em um conjunto de resultados especialmente grande, voc pode pressionar a tecla F12 para maximizar a rea de resultados ou, ento pode selecionar a opo MAXIMIZE TABSHEETS do menu VIEW. Pressionar a tecla F12 novamente ir restaurar a rea de resultados ao seu tamanho original. A rea de resultados pode ser usada para revisar e editar os resultados de uma query, mas a edio, no entanto, depende de que a query seja baseada em uma tabela somente e que haja informao chave suficiente para identificar as fileiras (rows) de maneira nica e exclusiva. Para editar o contedo de uma rea de resultados voc deve habilitar o modo de edio atravs do uso do boto EDIT na base da rea de resultados. Qualquer edio que voc faa no ser aplicada imediatamente ao banco de dados, mas quando clicar no boto APPLY CHANGES localizado prximo ao boto EDIT. Clicar no boto DISCARD CHANGES ir descartar quaisquer mudanas que tenham sido feitas nos dados.

6.5. O Navegador de Objetos


O navegador de objetos permite que voc navegue pelos bancos de dados do servidor, seus marcadores e seu histrico de query.

6.5.1. O Navegador de Banco de Dados


O navegador de banco de dados (schemata) a primeira tela do navegador de objetos. Voc pode usar o navegador de banco de dados no somente para selecionar tabelas e campos para uma query, mas tambm para editar tabelas, criar novas tabelas e bancos de dados e tambm exclu-los. O navegador de banco de dados pode ser usado para definir o banco de dados padro (default); Este procedimento necessrio antes que voc possa disparar queries contra as tabelas.

Figure 6.5. O navegador de Banco de Dados

O Banco de Dados padro atual estar sempre em destaque com texto em negrito. Para mudar o banco de dados padro, clique com o boto da direita do mouse sobre o banco de dados desejado e selecione a opo MAKE DEFAULT SCHEMA ou d um clique-duplo 14

Uma Turn pelo MySQL Query Browser

sobre o banco de dados desejado. Voc pode filtrar os bancos de dados mostrados usando a barra de pesquisa localizada no alto do navegador de banco de dados. medida que voc preenche a barra de pesquisa, os banco de dados que no correspondem ao valor pesquisado so ocultados na tela de exibio. Voc pode limpar a barra de pesquisa ao clicar no boto X ao lado direito da barra de pesquisa. Todos os bancos de dados sero visualizados novamente. Voc pode especificar que objetos sero filtrados ao clicar no cone ampulheta esquerda da barra de pesquisa e selecionando a opo adequada. As Opes so Schemata, Schema Assets, Columns/Indices e Custom Selection. Para ver as tabelas de um banco de dados, stored procedures e views, clique na flecha negra esquerda do nome do banco de dados.Voc pode ver as colunas de uma tabela clicando na flecha negra esquerda do nome da tabela. Colunas que fazem parte de uma chave primria (primary key) tem um cone que uma pequena chave esquerda de seu nome. Caso contrrio, elas tero um cone com um diamante azul. Ao clicar na flecha negra esquerda de uma view, as colunas que formam a view sero mostradas. Ao clicar na flecha negra esquerda de uma stored procedure ou uma stored function, os argumentos da stored procedure ou da function sero mostrados. Para criar um novo banco de dados, clique com o boto direito do mouse dentro do navegador de banco de dados e selecione a opo CREATE NEW SCHEMA. Para criar uma nova tabela, clique com o boto da direita do mouse sobre o banco de dados desejado e selecione a opo CREATE NEW TABLE. Para criar uma nova view, clique com o boto direito do mouse sobre o banco de dados desejado e selecione a opo CREATE NEW VIEW. Para criar uma nova stored procedure ou stored function, clique com o boto da direita do mouse sobre o banco de dados desejado e selecione a opo CREATE NEW PROCEDURE / FUNCTION. voc pode excluir objetos clicando com o boto direito do mouse sobre o objeto que deseja excluir e selecionando a opo apropriada (DROP SCHEMA, DROP TABLE, etc.). Voc pode editar um objeto clicando com o boto direito do mouse e selecionando o tipo de edio adequada (EDIT TABLE, EDIT VIEW, etc.). Caso voc selecione a opo EDIT TABLE, o MySQL Table Editor ser mostrado com a tabela selecionada. Para mais informaes sobre edio de tabelas, veja The MySQL Table Editor. Quando as opes EDIT VIEW, EDIT FUNCTION ou EDIT PROCEDURE so selecionadas, as declaraes CREATE VIEW, CREATE PROCEDURE ou CREATE FUNCTION sero mostradas em uma nova aba utilizando o Editor de Script. possivel editar todas as functions/procedures do servidor de uma vez selecionando a opo EDIT ALL STORED PROCEDURES / FUNCTIONS do menu SCRIPT. Caso voc necessite da declarao CREATE de qualquer objeto, clique com o boto direito do mouse sobre o objeto e selecione a opo COPY SQL TO CLIPBOARD. A declarao CREATE apropriada ser copiada para a rea de transferncia e pode ser usada para re-criar o objeto selecionado.

Note
Somente o objeto criado com o comando COPY SQL TO CLIPBOARD. As declaraes necessrias para preencher o objeto no sero.

6.5.2. O Navegador de Marcadores


Voc pode colocar suas queries mais frequentemente usadas em marcadores, assim voc poder reabri-las rapidamente e utiliz-las depois. Para adicionar uma query a seus marcadores (bookmarks) , selecione e arraste-o da rea de query para dentro do navegador de marcadores. Seus marcadores podem ser organizados em pastas e sub-pastas para facilitar o gerenciamento de suas queries. Para adicionar uma sub-pasta clique com o boto direito do mouse em uma pasta existente e selecione a opo CREATE BOOKMARK FOLDER. Voc pode excluir marcadores e pastas clicando com o boto direito do mouse sobre elas e selecionando a opo DELETE ITEMS. Aps a confirmao de que deseja apag-lo, o item ser removido de sua listagem de marcadores.

Warning
Caso voc apague uma pasta, todos os tens e sub-pastas dentro dela tambm sero apagados.

6.5.3. O Navegador de Histrico


Com o Navegador de Histricos voc pode navegar atravs de todas as queries que executou previamente. Para expandir as queries de um determinado dia, d um clique-duplo no dia. Para carregar um tem do histrico na rea de query, d um clique-duplo nela ou arraste-a para a rea de query. Voc pode remover tens do histrico ao clicar com o boto direito do mouse sobre eles e selecionar a opo DELETE SELECTED HISTORY ENTRIES do menu drop-down. Voc tambm pode utilizar a opo CLEAR HISTORY para apagar todas as entradas do histrico. Voc pode criar marcadores a partir de tens do histrico clicando com o boto direito do mouse sobre o tem de histrico selecionado e selecionar a opo ADD HISTORY ITEM AS BOOKMARK do menu.

15

Uma Turn pelo MySQL Query Browser

6.6. O Navegador de Informaes


O Navegador de Informaes fornece acesso a todas as informaes que no esto diretamente relacionadas aos dados dentro do banco de dados. O navegador de parmetros fornece diferentes parmetros locais, globais e dinmicos que auxiliam a construo de suas queries, enquanto o navegador de syntax fornece uma conveniente referncia sintaxe de query MySQL. O Navegador de Funes uma referncia rpida vrias funes internas do servidor MySQL. O Navegador de Transaes lista todas as queries que fazem transaes nicas e pode ser utilizado com histrico de transaes nicas.

6.6.1. O Navegador de Sintaxe


O Navegador de Sintaxe fornece uma ferramenta de referncia rpida para determinar sintaxes corretas a serem usadas durante a construo de queries. Ao efetuar o duplo-clique nos diversos tipos de sintaxe (SELECT, REPLACE e assim por diante) voc consegue acesso a informao de referncia usando o sistema de ajuda interno. A Informao de Referncia mostrada em uma nova Aba dentro da rea de Resultado. Para expandir uma determinada categoria de sintaxe, d um duplo-clique no cabealho da categoria.

6.6.2. O Navegador de Funes


O Navegador de Funes fornece uma ferramenta de referncia rpida para utilizao de funes internas do servidor MySQL. Ao dar um duplo-clique sobre as vrias funes, voc ter acesso a informaes de referncia utilizando o sistema de ajuda interno. Para expandir a categoria de uma determinada funo, d um duplo-clique sobre o cabealho da categoria. A Informao de Referncia ser mostrada em uma nova Aba dentro da rea de Resultados.

6.6.3. O Navegador de Parmetros


O Navegador de Parmetros contm todos os parmetros locais, globais e dinmicos que podem ser includos em sua query. Parmetros Locais afetam a query na janela atual da query apenas. Parmetros Globais afetam todas as queries. Parmetros dinmicos so gerados automaticamente a partir de queries existentes. Categorias de Parmetros podem ser mostradas ou ocultadas ao clicar sobre os cabealhos GLOBAL PARAMS, LOCAL PARAMS e DYNAMIC PARAMS. Para definir o valor de um parmetro, clique no valor e pressione a tecla F2 ou d um clique-duplo sobre o valor. Para adicionar um novo parmetro, clique com o boto direito do mouse dentro do Navegador de Parmetros e selecione a opo ADD PARAMETER. Para apagar um parmetro, clique com o boto direito do mouse e selecione a opo DELETE PARAMETER. Para transformar um parmetro Local em Global, clique com o boto direito do mouse sobre o parmetro e selecione a opo MOVE PARAMETER TO GLOBAL PARAMETERS.

6.6.4. O Navegador de Transaes


O Navegador de Transaes fornece uma lista de todas as declaraes que foram executadas na transao atual. O Navegador de Transao ser mostrado quando voc iniciar uma transao usando os botes de controle de transao.

6.7. O Editor de Scripts


O Script Editor fornece uma interface alternativa para ser utilizada ao lidar com grandes scripts SQL que agrupem mltiplas declaraes SQL.

Figure 6.6. O Editor de Scripts

16

Uma Turn pelo MySQL Query Browser

O Editor de Scripts mostrado dentro de uma Aba individual dentro da rea de Resultados. Quando uma aba do Editor de Scripts est ativa, Os botes da Advanced Toolbar so substitudos pelos botes de depurao de scripts. Para abrir um script no Editor de Scripts, selecione a opo OPEN SCRIPT ... do menu FILE. Voc tambm pode pressionar as teclas Ctrl + O para abrir um script SQL. Para criar uma nova janela de Editor de Script sem carregar um script, selecione a opo NEW SCRIPT TAB do menu FILE. Caso voc tenha problemas com conjuntos de caracteres (por exemplo, Caracteres acentuados Espanhis, Russos ou Chineses no serem mostrados corretamente), aqui vai uma orientao: Evite codificao ANSI em seus arquivos de script. Ao invs de usar ANSI, grave seus scripts em codificao UTF-8. Tenha cuidado ao carregar arquivos de script gerados por outras ferramentas. Muitas delas gravam arquivos em codificao ANSI, o que significa que voc ter de abr-los como ANSI no Query Browser (veja a caixa combo FILES OF TYPE na caixa de dilogo abrir arquivo):

Figure 6.7. A Caixa de dilogo Abrir Arquivo

17

Uma Turn pelo MySQL Query Browser

H significantes limitaes para arquivos formatados no padro ANSI; a definio de localidade corrente deve ser a mesma da mquina onde o arquivo foi originado. Por exemplo, voc no pode armazenar um script em ANSI em uma verso Francsa do Windows e esperar que ela carregue corretamente em uma verso Espanhola do Windows. Por Causa desta e de muitas outras limitaes ns recomendamos sempre com veemncia o uso da codificao Unicode para scripts. No importa se voc utiliza a verso UTF-8 ou a verso UTF-16, desde que ambas sejam formatos de transformao Unicode e possam ser lidos apropriadamente por quaisquer das ferramentas GUI MySQL. Usando UTF, voc pode at escrever texto Espanhol com comentrios em Chins em uma verso Alem de Windows. O frum MySQL Query Browser fornece muitas contribuies de usurios de conjuntos de caracteres no-Latin1; veja em http://forums.mysql.com/list.php?108.

6.7.1. Os Botes de Depurao de Erros de Script


Os seguintes Botes esto disponveis quando usamos o Editor de Scripts: Execute: Executa o script desde o comeo e no para a execuo at que o fim do script seja encontrado. Continue: Executa o script desde o comeo (ou da posio atual) e para por causa de erros ou pontos-de-parada (break points). Step: Executa a prxima declarao, funes sero executadas, mas no sofrero passo-a-passo internamente. Pause: Para a execuo do script e destaca a prxima declarao a ser executada. Stop: Para a execuo do script.

18

Uma Turn pelo MySQL Query Browser

6.7.2. A rea de Script


O script atualmente em edio no Editor de Scripts mostrado na Script Area. A Script Area possui os recursos de numerao de linha e destaque de sintaxe para facilitar o trabalho com os scripts. Linhas de Script que so marcadas com um ponto azul sua esquerda podem ser marcadas como pontos-de-parada. Para definir uma linha como ponto-de-parada, clique no ponto azul. Voc tambm consegue definir um ponto-de-parada posicionando o cursor na linha que voc deseja marcar e clicar na opo TOGGLE BREAKPOINT no menu SCRIPT. Para remover todos os pontos-de-parada, selecione a opo REMOVE ALL BREAKPOINTS do menu SCRIPT. Para executar um grupo de declaraes, destaque as declaraes que voc deseja executar e selecione a opo EXECUTE SELECTION do menu SCRIPT.

19

Chapter 7. Utilizando o MySQL Query Browser


Neste captulo iremos descrever as ferramentas disponveis no MySQL Query Browser utilizando-nos de exemplos prticos.

7.1. Acessando e Editando Queries Manualmente


O Programa query browser mais frequentemente usado para executar queries e analisar seus resultados. A maneira mais direta de criar uma query digitando-a diretamente na rea de Query. medida que voc digita sua query, as pores de sintaxe SQL da query (SELECT, FROM, WHERE e assim por diante) so destacadas em azul. medida que voc digita sua query, a rea de Query vai expandindo de 3 linhas iniciais de comprimento at o mximo de 10 linhas. Caso queira espao adicional, voc pode pressionar a tecla F11 para maximizar a rea de query. Voc tambm pode selecionar a opo MAXIMIZE QUERY AREA do menu VIEW para maximizar a rea de query. Quando a rea de query est maximizada, numerao de linha mostrada e a rea de query pode ser redimensionada ao clicar e arrastar a linha que divide a rea de query da rea de resultados. Para restaurar a rea de query forma original, pressione a tecla F11 novamente. A partir do momento que uma query foi digitada, clique no boto EXECUTE e os resultados da sua query sero mostrados na rea de resultado. Voc tambm pode pressionar as teclas Ctrl+ Enter para executar a query. Caso haja um erro em sua query, uma rea de erro aparece na parte inferior da rea de resultados e mostra uma relevante mensagem de erro e o respectivo cdigo do erro. Adicionalmente ao carregar os resultados da query na rea de resultados atual, voc tambm pode criar uma nova rea de resultados para mostrar os resultados de sua query ou dividir sua rea de resultados atual e carregar resultados em uma nova seo. Para executar a query e carregar os resultados em uma nova rea de resultados clique na flecha apontada para baixo localizada abaixo do boto EXECUTE e selecione a opo EXECUTE IN NEW TAB ou pressione Ctrl+Shift+Enter . Para dividir a rea de resultados atual e mostrar os resultados da query clique na seta apontada para baixo localizada abaixo do boto EXECUTE e selecione a opo SPLIT TAB AND EXECUTE ou pressione as teclas Ctrl+Alt+Enter. Voc dever definir um banco de dados padro antes de disparar queries contra tabelas especficas (entenda que voc ainda pode executar queries que no so especficas de banco de dados). Voc pode definir o banco de dados padro na tela de conexo ou clicando com o boto direito do mouse sobre um banco de dados no navegador de banco de dados e selecionando MAKE DEFAULT SCHEMA ou ainda selecionando a opo CHANGE DEFAULT SCHEMA do menu FILE.

7.2. Construindo Queries


Uma caracterstica do MySQL Query Browser a habilidade de construir queries. Utilize o navegador de banco de dados para selecionar as colunas e as tabelas que deseja para a query e tenha a query criada automaticamente a partir das suas escolhas. O primeiro passo para construir uma query selecionar uma tabela para ela. Clique e arraste uma tabela para a rea de query para iniciar uma query. Por exemplo, ao arrastar a tabela City para a rea de query, o texto SELECT * FROM City C adicionado rea de query. Voc tambm pode dar um duplo-clique na tabela para iniciar uma nova query SELECT.

Figure 7.1. A Ferramenta Tabela

Quando voc seleciona uma tabela a partir do navegador de banco de dados e o arrasta sobre a rea de query, uma ferramenta de tabela com algumas aes de composio mostrada. Solte a tabela que voc est arrastando sobre a ao desejada e a query ser modificada de acordo com o comando. As seguintes aes so possveis: SELECT substitui a declarao atual por uma query SELECT contendo a tabela arrastada. Add Table Adiciona a tabela arrastada lista de tabelas na query SELECT atual. JOIN Table: Caso uma query SELECT j exista na caixa de query, com uma tabela nela, a nova tabela arrastada ser adicionada e a clasula WHERE apropriada para executar o JOIN ser adicionada. LEFT OUTER JOIN o mesmo caso do anterior, porm cria uma declarao LEFT OUTER JOIN ao invs de uma declarao JOIN. UPDATE substitui a declarao atual pela declarao UPDATE contendo a tabela arrastada. 20

Utilizando o MySQL Query Browser

INSERT substitui a declarao atual pela declarao INSERT contendo a tabela arrastada. DELETE substitui a declarao atual pela declarao DELETE contendo a tabela arrastada.

Tabelas so unidas baseando-se em colunas de mesmo nome para tabelas MyISAM e informao de chaves estrangeiras (foreign key) para tabelas InnoDB. A partir do momento que uma tabela selecionada, voc pode selecionar colunas especficas para efetuar uma query; Clique no boto SELECT localizado nos botes de contruo de query na barra de botes. O ponteiro do seu mouse ser mudado para um ponteiro Select, o qual voc pode usar para selecionar colunas do navegador de banco de dados. Por exemplo, ao clicar nos campos Id, Name e Country do banco de dados exemplo world, a query SELECT C.Id, C.Name, C.Country FROM City C criada na rea de query. A partir do momento que voc selecionou as colunas que desejava para a query, voc pode usar outros botes de construo de query para completar sua query com clusulas WHERE, GROUP BY e ORDER BY. Quando uma nova seo da query adicionada com os botes de construo de query, o cursor na rea de query colocado na posio para a edio; se voc clicar em um campo com o ponteiro WHERE, o cursor estar na posio para voc digitar nos detalhes da clusula WHERE. Voc pode trocar entre os diferentes ponteiros construtores de query ao clicar sobre os botes de construo de query na barra de botes ou ao usar uma combinao de teclas Ctrl+Alt e a primeira letra do ponteiro que voc deseja usar (Ctrl+Alt+S para SELECT, Ctrl+Alt+W para WHERE e assim sucessivamente.) Caso os botes de construo de query no estejam visveis, eles podem ser exibidos atravs das opes do navegador. Veja Section 9.5.1, Opes de Exposio para mais informaes.

7.3. Criando Views


A maneira mais simples de criar uma view usando o MySQL Query Browser usando o boto CREATE VIEW. Executa uma query que representa a view que voc deseja criar. Assim que a query executada, clique no boto CREATE VIEW, fornea um nome para a view e ela ser criada. Voc tambm pode criar uma view clicando com o boto direito do mouse sobre o banco de dados ao qual voc deseja adicionar uma view para o navegador de banco de dados e selecionando a opo CREATE NEW VIEW. Aps entrar um nome para a view, um modelo de view ser mostrado no editor de script.

7.4. Navegando em Conjuntos de Resultados na rea de Resultados


A partir do momento que voc tenha executado com sucesso uma query, voc pode ver e manipular o conjunto de resultados dentro da rea de resultados. Voc pode navegar a rea de resultados usando as teclas de setas, tab e PageUp/PageDown. As teclas Home e End podem ser usadas para mover para a primeira e ltima colunas dentro de uma determinada fileira (row). Sua posio atual dentro do conjunto de resultados mostrada no canto esquerdo inferior da janela de aplicao. Os botes FIRST e LAST na parte inferior da rea de resultados podem ser usados para mover para a primeira e ltima fileira do conjunto de resultados. Dados tipo NULL sero indicados com o cone especial NULL para diferenciar de dados tipo NULL de strings vazias. campos BLOB sero vazios e tero um cone especial BLOB. Ao navegar um grupo de resultados particularmente grande, voc pode pressionar a tecla F12 para maximizar a rea de resultados.Voc pode tambm selecionar a opo MAXIMIZE TABSHEETS do menu VIEW para maximizar a rea de resultados. Pressionar a tecla F12 novamente ir restaurar a rea de resultados a seu tamanho original. Para pesquisar um valor especfico dentro do grupo de resultados, clique no boto SEARCH. Para ver opes adicionais de pesquisa, clique no boto DETAILS >>. As seguintes opo estaro disponveis: Case Sensitive: A pesquisa executada de maneira sensvel ao caso (case-sensitive), ou seja, diferenciando MAISCULAS de minsculas. por padro, as pesquisas no so case-sensitive. Whole Words Only: A pesquisa no permite comparaes parciais. Por padro, comparaes parciais so permitidas (por ex. Edm ir coincidir com Edmonton). Search From Top: A pesquisa iniciar com a primeira fileira do grupo de resultados. Search From Cursor: A pesquisa iniciar a partir da fileira atualmente selecionada. Search all Text / Columns: A pesquisa ir envolver todas as colunas do grupo de resultados.

21

Utilizando o MySQL Query Browser

Search Only in Selected Text / Column: A pesquisa ir envolver somente a(s) coluna(s) selecionada(s) do grupo de resultados. Search Up: A pesquisa ir varrer o grupo de resultados, iniciando no local designado para incio e movendo-se para cima. Search Down: A pesquisa ir varrer o grupo de resultados, iniciando no local definido para incio e se mover para baixo.

Para executar uma pesquisa e substituio em um grupo de resultados, clique na aba Replace na janela de dilogo de pesquisa. As opes para executar uma operao de substituio so as mesmas da operao de pesquisa comum. Para substituir apenas a primeira ocorrncia de um texto, clique no boto REPLACE. Para substituir todas as ocorrncias de um texto, clique no boto REPLACE ALL.

7.5. Exportando Grupos de Resultados


Voc pode exportar qualquer grupo de resultados do MySQL Query Browser clicando com o boto direito do mouse dentro do grupo de resultados e selecionando uma opo do sub-menu EXPORT RESULTSET. Voc pode selecionar para exportar o grupo de resultados nos formatos CSV, XML, HTML, Microsoft Excel XLS ou PLIST.

7.6. Manuseando Colunas BLOB e TEXT


O MySQL Query Browser fornece funcionalidades para lidar com colunas BLOB e TEXT atravs de uma srie de cones especiais.

Figure 7.2. O cones de Manuseio de Campos BLOB

Estes cones aparecem em qualquer coluna BLOB ou TEXT em seu grupo de resultados. Da esquerda para a direita, os cones seguintes esto disponveis: Open File: Este cone se parece com uma pasta de arquivo e usado para abrir um arquivo e carreg-lo para dentro do campo. View: Este cone se parece com uma lente de aumento e usado para abrir o visualizador de campo para ver o contedo de um campo. O visualizador de campo pode ser usado para abrir campos tipo TEXT e BLOB que contenham imagens. Edit: Este cone se parece com um lpis e abre o visualizador de campo no modo de edio, permitindo a voc fazer alteraes aos dados e aplicar as alteraes ao grupo de resultados. Save: Este cone parece com um disco flexvel e usado para gravar o contedo de um campo TEXT ou BLOB em um arquivo. Clear: Este cone parece um X em uma caixa negra e usado para limpar o contedo de um campo TEXT ou BLOB.

Somente os cones View e Save so visveis caso voc no tenha habilitado o modo de edio. Veja Section 7.7, Editando Grupo de Resultados Dentro da rea de Resultados para informaes sobre edio de grupo de resultados. A funcionalidade representada pelos cones est disponvel tambm clicando com o boto direito do mouse sobre o campo. Os cones de manuseio BLOB podem ser mostrados e ocultados atravs as opes de display. Veja Section 9.5.1, Opes de Exposio para mais informaes.

7.7. Editando Grupo de Resultados Dentro da rea de Resultados


Quando uma query baseada em uma tabela nica e h informao chave suficiente, o grupo de resultados pode ser editado de dentro da rea de resultados. Para editar um grupo de resultados clique no boto EDIT. Caso o boto EDIT no esteja ativo, seu grupo de resultados no editvel. Uma vez em modo de edio, voc pode inserir, atualizar e excluir fileiras do grupo de resultados. Navegue pelos campos usando as teclas Tab e teclas de setas e pressione a tecla Enter para editar o contedo de um campo. Voc tambm pode dar um duploclique em um campo para torn-lo editvel. Quando estiver editando um campo, use a tecla tab para mover para o prximo campo editvel. Todos os campos editveis so destacados em azul para fcil identificao. Para adicionar fileiras ao grupo de resultados, role para a fileira em branco na base da rea de resultados e preencha os campos. Todas as novas fileiras so destacadas em verde.

22

Utilizando o MySQL Query Browser

Para excluir uma fileira clique com o boto direito do mouse sobre a fileira e selecione a opo DELETE ROW. Todas as fileiras apagadas so destacadas em vermelho. Modificaes feitas para o grupo de resultados no so aplicadas imediatamente, mas armazenadas at que o boto APPLY CHANGES seja pressionado. Voc pode cancelar todas as suas edies com o boto DISCARD CHANGES. Sair do modo de edio sem escolher gravar ou descartar suas alteraes gerar uma solicitao do sistema para que voc grave ou descarte suas modificaes.

7.8. Comparando Grupos de Resultados


Voce pode comparar grupos de resultados graficamente com o MySQL Query Browser, permitindo que voc determine facilmente onde fileiras devem ser inseridas, editadas ou apagadas. Para comparar dois grupos de resultados, execute a primeira query que deseja comparar. Assim que o grupo de resultados esteja carregado, clique com o boto direito do mouse sobre o grupo de resultados e selecione a opo SPLIT TAB HORIZONTALLY. Carregue a segunda query dentro da nova seo da rea de resultados e clique no boto COMPARE para comparar os dois grupos de resultados . Quando voc tiver ativado o modo de comparao, ambos os grupos de resultados iro rolar juntos, tanto vertical quanto horizontalmente. Fileiras sero combinadas para comparao, com fileiras em branco adicionadas quando em um grupo houver uma fileira e no outro faltar. Caso um grupo de resultados tenha uma fileira e o outro grupo no tenha, esta fileira ser destacada em verde. O outro grupo de resultados ter uma fileira vazia que estar destacada em vermelho. Caso ambos os grupos de resultado tenham uma fileira combinando, mas os campos individuais sejam diferentes, este campos sero destacados em azul. Para comparar com sucesso dois grupos de resultado, voc necessitar duas queries que combinem mesmos nomes de colunas e na mesma ordem. Para o MySQL Query Browser comparar fileiras, chaves primrias devem ser definidas nas tabelas usadas na comparao.

7.9. Criando views Master-Detail


MySQL Query Browser torna fcil ver dados que estejam em um relacionamento master-detail (um para muitos). Isto pode ser til para visualizar dados de cliente/compras, grupo/membro e assim por diante. Para mostrar uma view master-detail, primeiro execute a query da tabela mestre (master) em uma nova rea de resultado. Por exemplo, usando o banco de dados de exemplo world, voc pode emitir uma query tipo SELECT Code, Name, Continent FROM Country. Assim que voc tiver criado o grupo de resultados mestre, clique com o boto direito do mouse na rea de resultados e selecione a opo SPLIT TAB VERTICALLY. Para a query detail, crie uma query que use parmetros dinmicos disponveis a partir da query mestre, como visto no navegador de parmetros. Neste exemplo, ns podemos executar uma query na tabela City da seguinte maneira: SELECT Id, Name FROM City WHERE Country = :Code. O Caracter Dois pontos (:) indica para o MySQL Query Browser que voc est adicionando um parmetro dinmico e uma lista pop-up de parmetros disponveis deve aparecer dentro da rea de query, permitindo que voc utilize as teclas de seta para selecionar um parmetro. Voc tambm pode digitar o nome do parmetro que gostaria de usar para vincular a query detail.

Figure 7.3. A listagem parmetros dinmicos

Uma vez que tenha executado a query detail, ela ir automaticamente se atualizar sempre que voc mudar a fileira ativa na query mestre, permitindo a voc ver rapidamente todas as fileiras da query detail medida que navega pelo grupo de resultados mestre. Voc pode repetir o processo, dividir a rea de resultados de novo, permitindo que voc tenha grupos de resultados detail para grupos de resultados detail .

23

Utilizando o MySQL Query Browser

Note
Voc pode continuar dividindo um grupo de resultado somente na mesma direo da diviso anterior, mas no pode, por exemplo, dividir verticalmente e depois, horizontalmente.

7.10. Gerenciando Stored Procedures e Functions com o MySQL Query Browser


Quando utilizado com servidores MySQL verso 5 e superiores, o MySQL Query Browser suporta criao, edio e visualizao de stored procedures e functions. Stored procedures e stored functions so mostradas no navegador de banco de dados com um cone especial para distingui-las das tabelas comuns e views. Clique na flecha esquerda da stored procedure ou stored function para mostrar a lista de parmetros para aquela procedure ou function.

Figure 7.4. Stored Procedure no Navegador de Banco de Dados

Para editar uma stored procedure ou uma stored function, clique com o boto direito do mouse sobre ela no navegador de banco de dados e selecione a opo EDIT PROCEDURE ou a opo EDIT FUNCTION. Este procedimento abrir um nova aba de editor de script mostrando a procedure/function selecionada. Uma vez que tenha terminado de edit-la , clique no boto EXECUTE acima da rea de script ou clique na opo EXECUTE do menu SCRIPT para atualizar a procedure/function. Para criar uma nova stored procedure ou function, selecione a opo CREATE STORED PROCEDURE / FUNCTION do menu SCRIPT. Entre o nome desejado para a procedure/function e clique no boto respectivo CREATE PROCEDURE ou CREATE FUNCTION. Um Modelo similar ao seguinte ser criado:
DELIMITER \\ DROP PROCEDURE IF EXISTS `test`.`new_proc`\\ CREATE PROCEDURE `test`.`new_proc` () BEGIN END\\ DELIMITER ;

Aps digitar a procedure/function, clique o boto EXECUTE acima da rea de script ou clique na opo EXECUTE do menu SCRIPT para cri-la. Para editar todas as stored procedures/functions de uma vez, selecione a opo EDIT ALL STORED PROCEDURES / FUNCTIONS do menu SCRIPT. Um nova aba de edio de script ser criada, contendo todas as stored procedures and stored functions para o banco de dados padro atual. Para excluir uma stored procedure ou stored function existente, clique com o boto direito do mouse sobre elas no navegador de banco de dados e escolha a opo DROP PROCEDURE ou DROP FUNCTION.

7.11. Editando Queries a Partir de uma Ferramenta de Desenvolvimento


24

Utilizando o MySQL Query Browser

Com a finalidade de ajudar os programadores a otimizar e localizar erros em suas queries mais eficientemente, o MySQL Query Browser pode copiar queries de cdigos de aplicao usando seu ambiente de desenvolvimento integrado (IDE) predileto.

Note
Esta funcionalidade s est disponvel para a verso Windows do sistema MySQL Query Browser. O cdigo PHP seguinte ser usado como exemplo:
$SQL = "SELECT Id, Name, Country FROM City" . "WHERE Name LIKE $cityname";

Para copiar a listagem para o MySQL Query Browser, copie o bloco de cdigo (incluindo a poro de atribuio), clique com o boto direito do mouse dentro da rea de query do MySQL Query Browser e selecione a opo PASTE CLIPBOARD CONTENT AS PHP CODE. As pores de texto No-query da rea selecionada sero descartadas e a query ser copiada na rea de query. Os elementos dinmicos da query so convertidos em parmetros locais, visveis no navegador de parmetros:
SELECT Id, Name, Country FROM City WHERE Name LIKE :cityname

Para definir um valor para um parmetro local, destaque o valor no navegador de parmetros e pressione a tecla F2. Voc tambm pode dar um clique-duplo sobre o valor para edit-lo. O valor que voc atribuir ser usado quando a query for executada. Depois de editar uma query, clique com o boto direito do mouse dentro da rea de query e selecione a opo COPY QUERY AS PHP CODE. O cdigo PHP circundante ser re-inserido junto com a query modificada. Esta funcionalidade permite que voc edite queries rapidamente enquanto programa.

25

Chapter 8. O MySQL Table Editor


8.1. Introduo
O MySQL Table Editor um componente dos programas MySQL Query Browser e MySQL Administrator e permite a criao e modificao visual de tabelas. O MySQL Table Editor pode ser acessado a partir do MySQL Query Browser ao clicar com o boto da direita em uma tabela dentro do navegador de banco de dados e selecionando a opo EDIT TABLE ou ao clicar com o boto da direita sobre um banco de dados dentro do navegador de banco de dados e selecionar a opo CREATE NEW TABLE. O MySQL Table Editor pode ser acessado a partir do MySQL Administrator atravs da tela CATALOGS. A partir do momento que voc tenha selecionado um banco de dados, clique com o boto da direita do mouse e selecione a opo EDIT TABLE do menu suspenso. Voc tambm pode selecionar uma tabela e clicar no boto EDIT TABLE para acessar o MySQL Table Editor.

8.2. A Janela do Editor Principal


O MySQL Table Editor consiste de um ambiente de trabalho dividido em 3 abas, algumas caixas de informaes gerais e 3 botes de ao. Independentemente da aba que esteja ativa, voc pode editar o nome e os comentrios da tabela.

Figure 8.1. O MySQL Table Editor

A rea das Abas dividida em trs sees: Columns and Indices: Use a Aba de Colunas e ndices para criar e modificar a informao de colunas e ndices da tabela. Voc tambm pode criar relacionamentos de CHAVE ESTRANGEIRA (FK) utilizando-se desta Aba. 26

O MySQL Table Editor

Table Options: Use as Aba de Opes de Tabela para escolher o mecanismo de armazenamento e o conjunto de caracteres padro a serem usados pela tabela. Advanced Options: Use a Aba de Opes Avanadas para configurar opes como o diretrio de armazenamento por-tabela, opes de tabela MERGE e RAID e comprimento de tabela/fila.

Cada uma dessas reas sero discutidas em mais detalhes nas sees seguintes.

8.3. A Aba de Colunas e ndices


A Aba Columns and Indices pode ser usada para mostrar e editar todas as informaes de colunas e ndices de sua tabela. Usando esta Aba, voc pode adicionar, excluir e alterar colunas e ndices.

8.3.1. O Editor de Coluna


Voc pode usar o editor de colunas para mudar o nome, tipo de dados, valor padro e outras propriedades das colunas de sua tabela.

Figure 8.2. O Editor de Colunas

Para mudar o nome, tipo de dados, valor padro ou comentrio de uma coluna, d um clique-duplo no valor que voc deseja mudar. O valor se tornar editvel e voc poder aplicar suas modificaes pressionando a tecla Enter. Para modificar as caractersticas de uma coluna (UNSIGNED, BINARY, ASCII e assim por diante) marque ou desmarque as caixas correspondentes s caractersticas que deseja modificar. esquerda do nome da coluna h um cone que indica se a coluna membro de uma chave primria. caso o cone seja uma pequena chave, a coluna pertence uma chave primria, caso contrrio o cone ser um diamante azul. Para adicionar or remover uma coluna da chave primria, basta clicar sobre o cone.

8.3.2. A rea de Detalhes


A rea de Detalhes da Aba Columns and Indices dividida em trs outras abas usadas para modificar o ndice, chave primria e informaes diversas dependendo de suas colunas.

8.3.2.1. A Aba ndices


A Aba Indices mantm todas as informaes de ndices para sua tabela. Voc pode adicionar, apagar e modificar ndices usando a aba de ndices, em combinao com o editor de colunas.

Figure 8.3. O Editor de ndices

27

O MySQL Table Editor

Para adicionar um ndice, clique no boto + (mais) abaixo da listagem de ndices. O MySQL Query Browser faz uma solicitao de um nome de ndice e um novo ndice criado. Para excluir um ndice, selecione o ndice e clique no boto (menos) . Use as caixas de dilogo INDEX NAME e INDEX KIND para modificar o nome e o tipo (UNIQUE, FULLTEXT e assim por diante) do ndice. Para adicionar colunas a um ndice, clique e arraste a coluna para a caixa INDEX COLUMNS ou selecione a coluna que deseja adicionar e clique no boto + (mais) direita da caixa INDEX COLUMNS. Voc pode remover uma coluna do ndice selecionando a coluna e clicando no boto (menos) para excluir a coluna do ndice. Para mudar um ndice para somente se referir a um prefixo de coluna (como tipos de dados texto CHAR and VARCHAR), selecione a coluna do ndice que deseja prefixar na caixa INDEX COLUMNS e ento clique no cone da seta direita da caixa INDEX COLUMNS. Selecione a opo SET INDEX COLUMN LENGTH do menu suspenso que for mostrado.

8.3.2.2. A Aba Chaves Estrangeiras


A Aba Foreign Keys dividida em duas sees, uma com uma lista das chaves estrangeiras e outra com vrias caixas de dilogo para setagens das chaves estrangeiras. Para adicionar uma chave estrangeira, clique no boto + (mais) abaixo da lista de chaves estrangeiras. O MySQL Query Browser solicitar um nome para a chave estrangeira e uma nova chave estrangeira ser criada. Para excluir uma chave estrangeira, selecione a chave estrangeira e clique no boto (menos) abaixo da lista de chaves estrangeiras. Voc pode modificar o nome de uma chave estrangeira, sua ao ON DELETE e sua ao ON UPDATE usando caixas de dilogo proporcionadas na seo FOREIGN KEY SETTINGS da Aba. Para estabelecer um relacionamento de chave estrangeira, selecione uma tabela da lista drop-down REF. TABLE. As colunas que podem ser referenciadas como chaves estrangeiras so listadas na rea abaixo, que tem duas sees. Para adicionar uma coluna (da tabela que voc est editando) voc pode dar um duplo-clique na rea abaixo de COLUMN e ento selecionar uma coluna da caixa de listagem drop-down ou pode ainda arrastar uma coluna a partir do editor de colunas para a seo COLUMN. Para adicionar uma coluna (de uma tabela de referncia) d um duplo-clique na rea abaixo do REFERENCE COLUMN e ento selecione uma coluna a partir da caixa de listagem drop-down.

8.3.2.3. A Aba Detalhes da Coluna


A Aba Column Details fornece uma interface para configurar os parmetros de uma coluna sem utilizar a interface tabela do editor de coluna. Todas as configuraes esto disponveis em Column Editor e so tambm disponveis na Aba Detalhes da Coluna, e, adicionalmente, voc tambm pode configurar o conjunto de caracteres da coluna e a colao padro da coluna a partir da aba de detalhes da coluna.

8.4. A Aba Opes da Tabela


A Aba Table Options permite que voc mude o mecanismo de armazenamento e o conjunto de caracteres padro de sua tabela. Uma lista de mecanismos de armazenamento disponveis exibida, em conjunto com um pequeno resumo das caractersticas e limitaes de cada um deles. Para mudar o mecanismo de armazenamento de sua tabela, clique no boto de rdio prximo ao mecanismo de armazenamento desejado. Para mudar o conjunto de caracteres padro ou colao de sua tabela, selecione uma nova opo a partir da lista drop-down de con28

O MySQL Table Editor

junto de caracteres disponveis.

8.5. A Aba Opes Avanadas


A Aba Advanced Options usada para configurar as opes da tabela que devem ser consideradas fora do conjunto padro de opes que a maioria dos usurios define enquanto cria e modifica tabelas. A Aba Advanced Options dividida em diversas sub-sees, cada uma descrita em sees posteriores deste manual. Para descries da maioria das opes configuradas na Aba de Opes avanadas, veja Sintaxe CREATE TABLE.

8.5.1. A Seo Diversos


A seo Various da Aba Advanced Options contm opes para voc definir o comportamento PACK KEYS, a tabela senha,o valor inicial AUTO_INCREMENT e o comportamento da atualizao chave de retardo. O AUTO_INCREMENT e os comportamentos da atualizao chave de retardo aplicam-se somente a tabelas MyISAM.

8.5.2. A Seo Opes de Fileira


A Seo Row Options pode ser usada para configurar opes como formato da fileira, uso do checksum e os parmetros do tamanho da fileira necessrios para tabelas maiores. Para definir o formato da fileira, escolha o formato desejado da fileira a partir da caixa de listagem drop-down. Veja Formatos de Tabelas MyISAM, para mais informaes sobre diferentes formatos de fileiras que sejam disponveis. Esta opo somente se aplica a tabelas MyISAM. Quando voc sabe que uma tabela ser particularmente grande, utilize as opes AVG ROW LENGTH, MIN ROWS e MAX ROWS para habilitar o servidor MySQL para melhor acomodar seus dados. Veja Sintaxe CREATE TABLE, para mais informaes sobre como usar estas opes.

8.5.3. A Seo Opes de Armazenamento


A seo Storage Options usada para configurar um caminho personalizado para o armazenamento de tabelas e arquivos de dados. Esta opo pode auxiliar a melhorar a integridade dos dados e a performance do servidor armazenando diferentes tabelas em diferentes discos rgidos. Esta opo somente est disponvel para tabelas MyISAM e para servidores que no estejam rodando sob sistema operacional Windows.

8.5.4. A Seo Opes de Mescla de Tabelas


As Seo de Opes Merge Table usada para configurar MESCLA de Tabelas em MyISAM. Para criar uma tabela MESCLADA, selecione MERGE como seu mecanismo de armazenamento em Table Options Tab e ento especifique as tabelas que voc deseja MESCLAR na caixa de dilogo UNION TABLES. Voc tambm pode especificar a ao que o servidor deve tomar quando usurios tentarem executar declaraes INSERT na tabela mesclada. Veja Tabelas MERGE, para mais informaes sobre tabelas MESCLADAS.

8.5.5. A Seo de Configurao de Tabela RAID


A seo Table RAID Settings permite a configurao do suporte RAID para tabelas MyISAM. O sistema RAID permite aos arquivos de dados da tabela MyISAM crescerem alm do limite de tamanho de 2GB/4GB imposto por alguns sistemas operacionais. Para mais informaes sobre o uso do suporte a RAID com MyISAM, veja Sintaxe CREATE TABLE.

8.6. Aplicando Suas Modificaes


As modificaes que voc faz com MySQL Table Editor no so imediatamente aplicadas, mas enfileiradas para serem aplicadas em lotes aps voc ter feito todas as suas edies. Para aplicar as modificaes que voc tenha feito, clique no boto APPLY CHANGES. A caixa de dilogo Confirm Table Edit ser mostrada.

Figure 8.4. A Caixa de Dilogo de Confirmao de Edio de Tabela


29

O MySQL Table Editor

Voc pode clicar no boto EXECUTE para confirmar as modificaes e aplic-las ou clicar no boto CANCEL para cancelar as modificaes (a janela do editor de tabela ser mostrada com os valores anteriores intactos). Voc tambm pode clicar no boto DISCARD CHANGES na janela principal do MySQL Table Editor para cancelar todas as modificaes que fez. Voc tambm pode copiar as mudanas propostas para a rea de transferncia para mais adiante editar selecionando as declaraes ALTER TABLE ou CREATE TABLE, clique com o boto da direita do mouse e selecione COPY do menu suspenso.

30

Chapter 9. Caixa de Dilogo de Opes


9.1. Introduo
A caixa de dilogo Options permite que voc configure perfis de conexo, configuraes gerais do programa e mais. Voc pode abrir a janela de dilogo Options usando um dos seguintes mtodos: Na janela de dilogo de conexo, clique no boto .... Na janela principal da aplicao selecione OPTIONS ... do menu TOOLS.

Figure 9.1. Caixa de dilogo de Opes

Na barra lateral da caixa de dilogo, voc pode selecionar a seo que deseja configurar. Existem trs botes de ao no canto direito inferior da janela: APPLY: Aplica e grava as alteraes. DISCARD: Descarta qualquer modificao que tenha sido feita. CLOSE: fecha a janela de dilogo Options. caso voc no tenha aplicado ou descartado suas modificaes, ser solicitado a voc que tome uma destas providncias.

9.2. Opes Gerais


31

Caixa de Dilogo de Opes

A seo General Options permite que voc especifique um nmero de configuraes que so vlidas para todos os aplicativos grficos MySQL. Store Window Positions: Quando uma aplicao iniciada em uma prxima vez, sua ltima posio de janela ser utilizada. Show Tip of Day: Caso esteja marcado, uma janela suspensa com a dica do dia aparecer ao iniciar o programa. Store Passwords: Caso marcado, senhas sero armazenadas no perfil de conexo do usurio. Voc pode especificar um mtodo de armazenamento de senha: Plaintext: Senhas so armazenadas sem encriptao; este mtodo pode ser inseguro. Obscured: Senhas so armazenadas usando um algortimo fraco. Este mtodo de encriptao independente do sistema operacional. OS Specific: Usa o mtodo de encriptao padro fornecido pelo sistema operacional. O padro o tipo Plaintext. Language: Define a Linguagem usada pela interface. O padro o English. Default Font: O tipo de fonte usado em todo o texto da aplicao. Data Font: O tipo de fonte usado em todos os comandos SQL e visualizao dos dados obtidos nas tabelas. Code Font: O tipo de fonte utilizado em todos os comandos SQL digitados pelo usurio.. Ignorelist: Sempre que marque a opo Do Not Show This Message Again em caixa de mensagens e erros, elas sero adicionados a esta lista. caso voc queira que uma mensagem em especial seja mostrada novamente, clique no boto REMOVE aps selecionar a mensagem na lista.

Voc pode mudar o tipo e o tamanho de qualquer das fontes da aplicao clicando no boto CHOOSE ... direita da fonte.

9.3. Conexes
A seo Connections possibilita que voc crie, edite e exclua perfis de conexo. A caixa central mostra a lista de perfs atualmente disponveis, juntamente com o histrico de conexes que foram feitas sem serem armazenadas em um perfil. Voc pode ocultar ou tornar visvel tanto a rvore Connections quanto a rvore History dando um duplo-clique sobre elas. Conexes so automaticamente adicionadas rvore History sempre que voc estabelece uma conexo ao servidor MySQL sem utilizar nenhum dos perfs armazenados na rvore Connections. Elas no aparecero na caixa drop-down da caixa de dilogo Connection, mas voc pode utilizar qualquer uma delas ao digitar manualmente seu nome na caixa Connection da caixa de dilogo Connection.

Figure 9.2. Caixa de dilogo de Opes: Conexes

32

Caixa de Dilogo de Opes

Para editar um perfil de conexo existente, clique sobre seu nome e mude os valores mostrados nas abas Connection Parameters e Advanced Parameters, e ento clique sobre o boto APPLY CHANGES para confirmar suas alteraes. Quando voc seleciona um perfil de conexo tanto da rvore Connections como da rvore History, a Aba Connection Parameters mostra os seguintes campos: Connection: o rtulo do perfil de conexo. Este o nome pelo qual voc se referir ao perfil e que aparece no caixa dropdown Connection da caixa de dilogo de conexo. ele pode conter quaisquer caracteres, incluindo espaos. Escolha nomes significativos para que voc possa identificar facilmente a que conexo os perfis se referem. Os nomes podem auxili-lo a diferenciar conexes a servidores MySQL diferentes ou conexes de diferentes usurios a um determinado servidor MySQL. Username: O nome de usurio usado para conectar ao servidor MySQL. Password: A senha usada para conectar ao servidor MySQL. Perceba que estas senhas no so armazenadas no perfil de conexo, a menos que seja configurada na seo Opes Gerais. Hostname: O nome do Mquina Hospedeira onde o servidor MySQL roda ou seu endereo IP. Port: A porta TCP/IP onde o servidor MySQL atende na Mquina Hospedeira. Type: Especifica o protocolo usado para se conectar ao servidor de banco de dados. O protocolo padro MySQL (que utiliza o protocolo nativo MySQL). Schema: O Banco de Dados padro para a conexo ao usar o MySQL Query Browser. Notes: Voc pode utilizar este campo para adicionar comentrios ou informao adicional descrevendo o perfil de conexo.

Note
A Aba Advanced Parameters no estar disponvel em todas as plataformas. Os parmetros avanados tambm 33

Caixa de Dilogo de Opes

podem ser configurados na caixa de dilogo de Conexo. Utilize o boto DETAILS ... para mostrar a opo Advanced Connection Options. Quando voc seleciona um perfil de conexo tanto na lista Connections quanto na lista History, a Aba Advanced Parameters mostra as seguintes caixa de checagem: Use compressed protocol: Caso marcada, a comunicao entre a aplicao e o servidor MySQL sofrer compresso, o que ir aumentar as taxas de transferncia. Este procedimento corresponde a iniciar a ferramenta de linha de comando do MySQL com a opo --compress. Return number of found rows, not number of affected rows: Por padro, MySQL retorna o nmero de fileiras modificadas pela ltima declarao UPDATE, apagadas pela ltima declarao DELETE ou inseridas pela ltima declarao INSERT. Quando esta opo est marcada, o servidor retorna o nmero de fileiras que coincidem com a declarao WHERE para a declarao UPDATE. Ignore spaces after function names, make them reserved words: Normalmente, qualquer referncia a um nome de funo em um comando SQL deve ser seguido imediatamente de um parntese de abertura. Caso esta opo esteja marcada, espaos podem aparecer entre o nome da funo e o parntese, como em:
COUNT (*)

Habilitar esta opo, transforma os nomes de funo em palavras reservadas. Esta opo corresponde a iniciar a ferramenta de linha de comando MySQL com a opo --ignore-spaces option. Allow interactive_timeout seconds of inactivity before disconnect: Normalmente, a conexo fechada pelo servidor MySQL aps um certo perodo de inatividade no lado cliente. Este perodo pode ser configurado com a varivel interactive_timeout. Caso marcado, o servidor no fechar a conexo a menos que o perodo de inatividade exceda o valor configurado em interactive_timeout. este procedimento corresponde a iniciar a ferramenta de linha de comando MySQL com a opo --connect-timeout=seconds . Enable LOAD DATA LOCAL handling: Por padro, a opo LOCAL da declarao LOAD DATA desabilitada por razes de segurana. Habilitar esta opo permite que voc carregue dados a partir da mquina local (a mquina onde o cliente da aplicao GUI est rodando). Este procedimento corresponde a iniciar a ferramenta de linha de comando MySQL com a opo --local-infile=1. (Perceba que esta opo no tem efeito a menos que o servidor MySQL permita manipulao LOCAL.)

9.4. Editores
A seo Editors usada para configurar opes especficas para os diferentes editores disponveis no pacote GUI MySQL. At o momento da edio deste manual, est limitado ao MySQL Table Editor. Show SQL command before applying changes: Define se o MySQL Table Editor dever mostrar a voc a declarao CREATE TABLE ou ALTER TABLE antes de execut-las para confirmao, ao clicar no boto APPLY CHANGES. All columns Not Null per default: Define se o MySQL Table Editor designar colunas como sendo NOT NULL por padro quando criar novas colunas. All integer columns unsigned per default: Define se colunas tipo Integer sero declaradas como UNSIGNED (sem sinal + ou -) por padro quando novas colunas so criadas. Default storage engine: Define o tipo de motor de armazenamento a ser associado a tabelas recm-criadas. Este valor independente do motor de armazenamento padro do servidor MySQL. PK Naming: Dita o formato que deve ser usado para nomear colunas tipo PRIMARY KEY que forem automaticamente geradas. a parte %tablename% ser substituda pelo nome apropriado da tabela. Index Naming: Define o nome automaticamente gerado para novos ndices. O texto %nr% ser substitudo por um nmero automaticamente incrementado. FK Naming: Configura o nome usado ao criar novas chaves estrangeiras. PK Datatype: O Tipo de dados usado quando criada uma coluna tipo PRIMARY KEY. Def. data type O tipo de dados padro atribudo a todas as novas colunas que no faam parte de uma PRIMARY KEY.

9.5. A Seo Browser


34

Caixa de Dilogo de Opes

A seo Browser permite que voc defina opes relacionadas ao programa MySQL Query Browser. A seo Browser dividida em trs reas: Display Options, Query Options e Various.

Figure 9.3. A Caixa de Dilogo de Opes do Query Browser

9.5.1. Opes de Exposio


As opes de exposio afetam a visualizao do MySQL Query Browser. Show advanced toolbars: Mostra ou oculta a Barra de Ferramentas Avanada. Hide the tab when only one page is open: Determina se apresenta o cone da aba no alto da rea de Resultado caso haja apenas uma rea de resultado. Toolbars use gradient background: Habilita e desabilita o uso de efeitos gradiente na tela de fundo da Barra de Ferramentas de Declaraes . Show field overlay images for long VARCHAR, TEXT, and BLOG fields: Liga ou desliga os cones de gerenciamento BLOB. Show composer buttons toolbar: Liga ou Desliga os botes de composio de declarao na Barra de Ferramentas Avanada.

9.5.2. Opes de Declarao


Enforce queries to be editable by adding primary key columns to the select: Adiciona colunas PRIMARY KEY a uma declarao que no faz SELECT explicitamente delas, para garantir que os resultados da declarao possam 35

Caixa de Dilogo de Opes

ser editados. As colunas PRIMARY KEY no sero mostradas neste caso, mas ainda sero armazenadas. Open resultset in associated application after export: Fora a aplicao associada a ser aberta aps selecionar a opo EXPORT RESULTSET do menu suspenso aberto com o clique do boto direito do mouse na rea de Resultados.

9.5.3. Diversos
Associate sql/query files with Query Browser: Configura o sistema Windows para que associe todos os arquivos .sql com o programa MySQL Query Browser. Como resultado desta ao, todos os arquivos deste tipo sero abertos com o MySQL Query Browser por padro.

36

Appendix A. Instalando a partir dos Fontes


A.1. Introduo
Normalmente, voc preferir instalar as ferramentas GUI MySQL a partir de arquivos executveis. Ns nos esforamos ao mximo para assegurar que os executveis de instalao tenham as melhores opes possveis. Caso, por qualquer motivo, voc deseje compilar as ferramentas voc mesmo, siga essas instrues.

A.2. Fazendo o Download do Cdigo-Fonte


O cdigo fonte para as ferramentas GUI MySQL est disponvel em nossas rvores pblicas de Subversion localizada em http://dev.mysql.com/tech-resources/sources.html. Voc precisar da rvore mysql-gui-common indiferentemente de que ferramenta GUI voc pretende gerar. A rvore mysqlgui-common contm arquivos fontes e grficos usados para todas as ferramentas GUI MySQL. Para ter acesso a essas rvores , voc tem de instalar um sistema Subversion. Subversion disponvel gratuitamente em http://subversion.tigris.org/.

A.3. Gerando a partir dos fontes sob o Windows


Instalar a partir dos fontes sob o Windows requer mltiplos compiladores comerciais e por causa disto prefervel instalar a partir dos executveis. Caso voc possua os pr-requisitos necessrios voc poder gerar as ferramentas GUI MySQL a partir do cdigo fonte sob o Windows.

A.3.1. Pr-Requisitos
Para compilar as ferramentas GUI MySQL a partir do cdigo-fonte sob o Windows, voc precisar do programa Borland Delphi 7, Microsoft Visual Studio.NET 2003 e algumas bibliotecas que esto disponveis na internet no formato cdigo-fonte aberto. Assegure-se de que os programas DCC32.exe e DEVENV.exe /? possam ser lanados a partir da linha de comando. Voc necessitar dos seguintes executveis para compilar a partir dos fontes: glib-2.0 libxml-2 mysql client libraries (4.0 ou superior, 5.0 preferencialmente) pcre-1.4 MS Visual C runtime libraries 7.1 Java include files 1.4.2_04 Lua 5.0.2

A.3.2. Compilando e Gerando


Assegure-se que voc tenha criado uma cpia das rvores mysql-administrator, mysql-gui-common e mysqlquery-browser, e que seus diretrios locais estejam localizados no mesmo diretrio, por exemplo em Personal Files\MySQLGUI\. Os arquivos fonte e bibliotecas devem ser dispostos na seguinte estrutura de rvore de diretrios:
Working Directory | |- mysql-administrator |- mysql-gui-common |- mysql-query-browser |- mysql-gui-win-res | |-include | | | |-glib-2.0 | |-java | | | | | |-win32 | |

37

Instalando a partir dos Fontes

| |-libxml | |-lua | |-mysql | |-pcre | |-windows | |-lib | |-glib-2.0 |-java |-libxml |-lua |-mysql |-pcre |-windows

A.3.2.1. Gerando a partir da linha de comando


Para gerar o programa a partir da linha de comando, abra o prompt de comando do windows e mude para o diretrio que o repositrio central da ferramenta (por exemplo para o MySQL Administrator ser work\mysql-administrator). Existem 3 arquivos batch para iniciar a gerao: build_debug.cmd build_release.cmd build_commercial.cmd

Execute um deles para gerar uma imagem de execuo da aplicao. Ela ser gerada no diretrio bin\windows. Um outro metdo dar um clique-duplo em um dos arquivos build_buildtype.cmd, onde buildtype um dos seguintes termos: debug, release e commercial. O script de gerao commercial se destina a usurios que possuam uma licena e faam uso da verso comercial da biblioteca cliente do MySQL.

A.3.2.2. Gerando a partir de uma IDE (Interface de Desenvolvimento)


Antes que voc possa abrir qualquer projeto, ter de instalar estes componentes. Caso contrrio, alguns formulrios no iro abrir e voc receber mensagens de erro. Para instalar os componentes, v para o diretrio mysql-gui-common\source\windows\. Copie os seguintes diretrios para o seu diretrio fonte do Delphi (C:\Program Files\Borland\Delphi7\Source\). png SynEdit TNT UniCodeEditor VirtualTreeview

D um clique-duplo em cada arquivo *.dpk destacado abaixo. Isto ir abrir o Delphi. Aperte compile and install para instalar os componentes. Repita a operao para cada arquivo *.dpk. SynEdit\Packages\SynEdit_D7.dpk TNT\Packages\TntUnicodeVcl_D70.dpk VirtualTreeview\Packages\VirtualTreesD7D.dpk UniCodeEditor\Packages\UniCodeEditorD7.dpk

Estes componentes tem de ser instalados atravs da opo INSTALL do menu COMPONENT. Clique no boto BROWSE e selecione os arquivos abaixo. Pressione OK aps cada arquivo. png\PNGImage.pas

38

Instalando a partir dos Fontes

Aps instalar os componentes voc poder abrir os projetos como destacado abaixo. Para gerar a aplicao a partir da IDE do Delphi 7 simplesmente d um clique-duplo em edit_xxxx.cmd. Isto ir iniciar o Delphi 7 e abrir o arquivo. Para gerar uma imagem completa de execuo selecione a opo BUILD ALL PROJECTS do menu PROJECT. Como no modo de linha de comando, existem trs arquivos diferentes. edit_debug.cmd edit_release.cmd edit_commercial.cmd

Uma imagem de execuo ser gerada no diretrio bin\windows. Abrir o projeto Delphi no utilizando o script edit_*.cmd ir definir incorretamente as configuraes do projeto e ocorrero problemas no momento de gerar os projetos.

A.4. Gerando o Sistema a Partir dos Fontes sob a Plataforma Linux


A.4.1. Pr-Requisitos
A maneira mais fcil de instalar os pacotes requeridos usando um gerenciador de pacotes de resoluo automtica de dependncia, como o apt-get ou yum. Voc pode instalar estas dependncias manualmente, mas este ser um processo muito tedioso,j que alguns deles requerem outros pacotes que requerem outros pacotes e assim por diante. Requisitos comuns esto listados abaixo. Para algumas distribuies o nome do pacote tambm mencionado.

Table A.1. Componentes Requeridos


Software gcc/g++ autoconf, automake libtool x11-libs glibc libstdc++ glib gtk+ libglade2 libsigc++ glibmm-2.4 gtkmm-2.4 pcre pkgconfig libxml2 MySQL 5.0 or 5.1 client libs and headers 2.6+ 2.6+ 2.5+ 2.0.x 2.4 2.4 4.x or newer 0.15+ 2.6.x libx11-dev libc6-dev libstdc++6-4.0-dev libglib2.0-dev libgtk2.0-dev libglade2-dev libglibmm2.4-dev libpcre3-dev pkg-config libxml2-dev libmysqlclient15-dev xorg-x11-devel xorg-xll-devel libstdc++devel glib2-devel gtk2-devel libglade2-devel glibmm24-devel Version 4 Ubuntu 6 g++ SuSE 10.x gcc-c++

libsigc++-2.0-dev libsigc++2-devel

libgtkmm-2.4-dev gtkmm24-devel pcre-devel pkgconfig libxml2-devel

Requisitos adicionais para gerar o MySQL Query Browser so:

Table A.2. Requisitos para o MySQL Query Browser


Software libgtkhtml libgnomeprint Version 2.11 or 3.x 2.2 Ubuntu 6 libgtkhtml2-dev libgnomeprint2.239 SuSE 10.x

Instalando a partir dos Fontes

Software

Version

Ubuntu 6 dev

SuSE 10.x

A.5. Compilando e Gerando


Para gerar quaisquer das ferramentas, voc necessitar baixar a rvore fonte de arquivos para mysql-gui-common e a rvore para a aplicao desejada (por exemplo: mysql-administrator, mysql-query-browser) no mesmo nvel de diretrio. Primeira gerao de mysql-gui-common: 1. 2. 3. 4. 5. cd mysql-gui-common sh ./autogen.sh ./configure --prefix=/opt/mysql-administrator make make install

Apesar da opo --prefix permitir o valor que voc quiser, normalmente voc ir especificar /usr/local (o padro) or / usr, mas para fazer binrios pr-compilados, algo em /opt pode ser mais apropriado. Aps o mysql-gui-common ter sido criado com sucesso, voc pode criar as ferramentas individuais (neste exemplo ns criaremos o mysql-administrator): 1. 2. 3. 4. 5. cd mysql-administrator sh ./autogen.sh ./configure --prefix=/opt/mysql-administrator make make install

Se tudo correr bem, os arquivos devero ser corretamente gerados e instalados.

A.5.1. Gerando Binrios Estticos


Criar binrios estticos uma tarefa no trivial em Linux, devido quantidade enorme de bibliotecas dependentes que provm do GNOME e bibliotecas associadas. Adicionalmente: Muitas bibliotecas no vem com suas verses estticas (lib*.a) embutidas. Neste caso, ns necessitamos ger-las ns mesmos. Algumas bibliotecas no podem ser vinculadas estaticamente, como a glibc, por causa da libnss*.so. Algumas bibliotecas dependem de arquivos de dados e mdulos do pacote original, especialmente no caso do gtk/gnome. Os problemas no ocorrem somente quando o usurio perde estes arquivos de dados; Algumas coisas podem no funcionar devido a diferentes distribuies que colocam arquivos em caminhos diferentes.

A soluo atual criar parcialmente o binrio esttico, com a biblioteca mais comum deixando-o vinculado dinamicamente (glibc e gtk). gtkmm, gtksourceview, gtkhtml e dependncias (como o gnome) so vinculados estticamente. A soluo ideal seria gerar binrios personalizados para cada distribuio principal e/ou escolhida, mas ns no temos tempo/recursos para isso at o presente momento. Para gerar os binrios: 1. 2. Verifique no script source/linux/static_make todos os arquivos que devem ser removidos ou movidos para fora da pasta /usr/lib. Execute o script.

40

Instalando a partir dos Fontes

necessrio obrigar o linker a procurar a verso esttica de cada biblioteca e tambm explicitar a lista de bibliotecas dependentes que foram vinculadas de outro modo a bibliotecas dinmicas.

A.5.2. Gerando RPMs


Para gerar RPMs, um arquivo de formato j fornecido e o RPMs ser gerado automaticamente aps ./configure ter sido executado. O Arquivo de formato requisita um arquivo fonte tipo tarball com a seguinte estrutura:
mysql-administrator/ mysql-administrator/mysql-gui-common/* mysql-administrator/mysql-administrator/*

O contedo de cada sub-diretrio a rvore da fonte inteira para cada ferramenta (Arquivos especficos do Windows e fonte de metadata so opcionais, claro). Voc pode gerar um arquivo tar.gz e p-lo em /usr/src/redhat/SOURCES (ou em qualquer que seja o lugar do seu diretrio de FONTES rpm). Ento, execute: rpmbuild -ba mysql-administrator.spec Este procedimento deve gerar os arquivos srpm e rpm para a ferramenta.

41

Appendix B. Analisando Erros da Aplicao


B.1. Analisando Erros de Conexo
Caso ocorra um erro ao selecionar um perfil de conexo e tentar estabelecer uma conexo ao servidor MySQL definido no perfil, uma janela contendo a informao sobre o erro ser mostrada (veja a figura).

Figure B.1. Caixa de Dilogo de Mensagem de Erro

Normalmente, isto significa que ou as credenciais especificadas no perfil esto incorretas (nome de usurio errado, senha errada) ou que voc no tem privilgios para conectar ao servidor MySQL a partir desta mquina cliente. Veja Causas dos Erros de Accesso Negado, para mais informaes. Entretanto, uma outra causa para falha de conexo que pode haver um problema de rede que impea voc de localizar a mquina onde o servidor MySQL est rodando. Por esta razo, a caixa de dilogo fornece um boto chamado PING. Clicar neste boto enviar uma requisio PING ICMP para a mquina hospedeira do servidor MySQL. caso a mquina hospedeira esteja disponvel na rede, voc ver algo similar a :
Reply from 127.0.0.1: Time=0ms TTL=128 Reply from 127.0.0.1: Time=1ms TTL=128

Isto indicar que a mquina est ao alcance da rede, e que a causa da falha de conexo no um problema de rede.

B.2. Analisando Problemas de Visualizao


Caso, rodando sob o Windows, Os controles no windows paream de alguma maneira deslocados, selecione START, CONTROL PANEL, DISPLAY. Selecione a aba SETTINGS e clique no boto ADVANCED.... Mude sua configurao de DPI para Normal (96 DPI). Caso, rodando sob Linux, mensagens e sub-ttulos apaream muito grandes, sua resoluo de vdeo provavelmente est configurada para um valor muito alto. Use gnome-font-properties para mudar sua fonte-padro para um valor menor ou v a Details e configure sua resoluo para 72 ou algum outro valor mais adequado.

42

Appendix C. Como so armazenadas conexes


Em Windows, perfs de conexo so armazenados no diretrio C:\Documents and Settings\UserName\Application Data\MySQL, onde UserName o nome do usurio do Windows atualmente conectado. Em Linux, os arquivos so armazenados no diretrio ~/.mysqlgui. As definies so armazenadas em um arquivo chamado mysqlx_user_connections.xml. O contedo deste arquivo se parece com:
<?xml version="1.0"?> <user_connections> <last_connection>1</last_connection> <password_storage_type>2</password_storage_type> <user_connection> <connection_name></connection_name> <username>root</username> <hostname>localhost</hostname> <port>3306</port> <schema></schema> <advanced_options/> <storage_path></storage_path> <notes></notes> <connection_type>0</connection_type> <storage_type>2</storage_type> <password></password> </user_connection> ...

Voc pode editar o arquivo manualmente, mas tenha cuidado para no invalidar o formato XML. Quando fizer alteraes editando e salvando o arquivo, elas s sero mostradas a prxima vez que voc abrir a seo Connections do Options Dialog. No ser necessrio reiniciar sua aplicao para que as modificaes tenham efeito. Administradores de banco de dados podem editar o arquivo e copi-lo para outra mquina executando as ferramentas GUI MySQL. Isto facilita manter perfs de conexes idnticos em vrias mquinas, sem ter de configur-los individualmente. Todos os arquivos de configurao XML para as ferramentas GUI MySQL so compatveis com Multi-Plataforma e podem ser transferidos entre sistemas em mquinas Windows e Linux.

43

Appendix D. Arquivos XML comuns a todas as aplicaes GUI MySQL


Em Windows, arquivos XML comuns a todas as aplicaes GUI MySQL so armazenados no diretrio C:\Documents and Settings\UserName\Application Data\MySQL, onde UserName o nome do usurio Windows atualmente logado. Em Linux, os arquivos so armazenados no diretrio ~/.mysqlgui. mysqlx_common_options.xml: Armazena opes selecionadas no Options dialog. mysqlx_user_connections.xml: Este arquivo descrito em Como so armazenadas as conexes.

44

Appendix E. Arquivos XML usados pelo MySQL Query Browser


Adicionalmente aos arquivos comuns, o MySQL Query Browser utiliza vrios arquivos XML para finalidades internas. mysqlqb_functions.xml: Armazena uma lista de funes e operadores para uso do Navegador de Funes . mysqlx_dbm_data types.xml: Armazena uma lista de tipos de dados MySQL disponveis para uso com autocomplemento e com o MySQL Table Editor mysqlx_dbm_charsets.xml: Armazena os conjuntos de caracteres MySQL disponveis. mysqlqb_history.xml : Armazena as queries que compe o Navegador de Histrico. mysqlqb_bookmark.xml: Armazena as queries que formam o Navegador de Marcadores.

45

Appendix F. Notas para Tradutores


Voc poder descobrir que as ferramentas GUI MySQL e/ou sua documentao no esto disponveis em sua linguagem preferida. Caso voc queira traduzir o programa ou sua documentao, ou participar da traduo, por favor entre em contato com a equipe de documentao MySQL antes de iniciar sua traduo. O endereo de email da equipe de traduo da documentao MySQL http://www.mysql.com/company/contact/. Em seu email, por favor informe o que voc gostaria de traduzir (as ferramentas, sua documentao ou mesmo o manual de referencia do MySQL inteiro, caso aceite o desafio), e d tambm alguma informao a seus respeito: Qual o seu nome? Onde voc mora? A quanto tempo voc usa o MySQL? J fez outras tradues? Ir trabalhar sozinho ou com um grupo de tradutores? Qual o tempo disponvel para traduo ? Qual a sua motivao para fazer a traduo?

Ns entraremos em contato com voc o mais breve possvel. O formato usado para ambos, programas e documentao, o formato DocBook XML. A partir deste formato base, todos os outros formatos disponveis so gerados (HTML, CHM, PDF, etc.). Seria uma pena se voc comeasse a traduo, digamos, a partir da verso HTML desta documentao, por que no seramos capazes de utiliz-la neste formato. tambm poderia ocorrer de algum mais j haver realizado (ou estivesse realizando) esta mesma traduo. Portanto, dizemos mais uma vez, por favor contate a equipe de documentao MySQL antes de mais nada.

46

Appendix G. Software de Terceiros utilizados nas ferramentas GUI MySQL


As Ferramentas GUI MySQL incorporaram suporte PCRE e PNG atravs do uso de bibliotecas de terceiros.

G.1. Biblioteca PCRE


Suporte a expresses regulares fornecido pela pacote da biblioteca PCRE, que software open source, escrita por Philip Hazel e registrado pela University de Cambridge, Inglaterra. A fonte para a biblioteca PCRE pode ser encontrada em: ftp:/ / ftp.csx.cam.ac.uk/pub/software/programming/pcre/.

G.2. Suporte PNG


O suporte a PNG para a verso Windows fornecido pelo componente TPNGImage que software open source, escrito e registrado por Gustavo Daud. A fonte para TPNGImage pode ser encontrada em: http://pngdelphi.sourceforge.net .

47