MySQL Front
MySQL Front
MySQL Front
Manual
MySQL-Front
Table of Contents
Part I Introduction
1 Features ................................................................................................................................... 5
2 Minimum Requirements
................................................................................................................................... 6
3 Installation...................................................................................................................................
/ Uninstallation
6
4 Purchase ................................................................................................................................... 7
Part II Program
1 Files
................................................................................................................................... 8
Connection
.......................................................................................................................................................... 8
Object Browser
.......................................................................................................................................................... 8
Data Browser
.......................................................................................................................................................... 8
SQL Editor
.......................................................................................................................................................... 8
System Tools
.......................................................................................................................................................... 8
Open
.......................................................................................................................................................... 9
Save
.......................................................................................................................................................... 9
Save as
.......................................................................................................................................................... 9
Recent files
.......................................................................................................................................................... 9
Import
.......................................................................................................................................................... 9
SQL File
......................................................................................................................................................... 9
Text File
......................................................................................................................................................... 10
MS Access File......................................................................................................................................................... 10
ODBC Table ......................................................................................................................................................... 10
Export
.......................................................................................................................................................... 11
SQL File
......................................................................................................................................................... 11
Text File
......................................................................................................................................................... 11
HTML File
......................................................................................................................................................... 12
XML File
......................................................................................................................................................... 12
.......................................................................................................................................................... 12
Close
.......................................................................................................................................................... 13
Close all
.......................................................................................................................................................... 13
Exit
.......................................................................................................................................................... 13
2 Edit
................................................................................................................................... 13
Undo
.......................................................................................................................................................... 13
Redo
.......................................................................................................................................................... 13
Cut
.......................................................................................................................................................... 13
Copy
.......................................................................................................................................................... 14
Paste
.......................................................................................................................................................... 14
Delete
.......................................................................................................................................................... 14
Select all
.......................................................................................................................................................... 14
Copy to File
.......................................................................................................................................................... 14
.......................................................................................................................................................... 15
Rename
.......................................................................................................................................................... 15
3 Search
................................................................................................................................... 15
Search
.......................................................................................................................................................... 15
Replace
.......................................................................................................................................................... 15
Search Next
.......................................................................................................................................................... 15
Copyright (C) 2000-2005 by Star-Tools GmbH
II
4 View
................................................................................................................................... 16
Object Browser
.......................................................................................................................................................... 16
Data Browser
.......................................................................................................................................................... 16
SQL Editor
.......................................................................................................................................................... 16
Location Bar
.......................................................................................................................................................... 16
Navigator
.......................................................................................................................................................... 16
Favorites
.......................................................................................................................................................... 16
SQL Log
.......................................................................................................................................................... 17
List
.......................................................................................................................................................... 17
Report
.......................................................................................................................................................... 17
Status Bar
.......................................................................................................................................................... 17
Window Bar
.......................................................................................................................................................... 17
Refresh
.......................................................................................................................................................... 17
Refresh all
.......................................................................................................................................................... 18
5 Favorites................................................................................................................................... 18
Add
.......................................................................................................................................................... 18
Properties
.......................................................................................................................................................... 18
6 Database................................................................................................................................... 19
New
.......................................................................................................................................................... 19
Database
......................................................................................................................................................... 19
Table
......................................................................................................................................................... 19
View
......................................................................................................................................................... 19
Routine
......................................................................................................................................................... 19
Trigger
......................................................................................................................................................... 20
Index
......................................................................................................................................................... 20
Field
......................................................................................................................................................... 20
Foreign Key
......................................................................................................................................................... 20
Host
......................................................................................................................................................... 20
User
Remove
......................................................................................................................................................... 21
.......................................................................................................................................................... 21
Database
......................................................................................................................................................... 21
Table
......................................................................................................................................................... 21
View
......................................................................................................................................................... 21
Routine
......................................................................................................................................................... 21
Trigger
......................................................................................................................................................... 21
Index
......................................................................................................................................................... 21
Field
......................................................................................................................................................... 22
Foreign Key
......................................................................................................................................................... 22
Host
......................................................................................................................................................... 22
Process
......................................................................................................................................................... 22
User
Properties
......................................................................................................................................................... 22
.......................................................................................................................................................... 22
Server
......................................................................................................................................................... 22
Database
......................................................................................................................................................... 23
Table
......................................................................................................................................................... 23
View
......................................................................................................................................................... 23
Routine
......................................................................................................................................................... 24
Trigger
......................................................................................................................................................... 24
Index
......................................................................................................................................................... 24
Field
......................................................................................................................................................... 24
Foreign Key
......................................................................................................................................................... 24
Host
......................................................................................................................................................... 24
User
......................................................................................................................................................... 25
Copyright (C) 2000-2005 by Star-Tools GmbH
III
MySQL-Front
Variable
......................................................................................................................................................... 25
.......................................................................................................................................................... 25
Edit record
.......................................................................................................................................................... 25
Run
.......................................................................................................................................................... 25
Run Selection
.......................................................................................................................................................... 26
Empty
.......................................................................................................................................................... 26
7 Extras
................................................................................................................................... 26
Search
.......................................................................................................................................................... 26
Replace
.......................................................................................................................................................... 27
Transfer
.......................................................................................................................................................... 27
Synchronize
.......................................................................................................................................................... 28
8 Settings ................................................................................................................................... 29
Global settings
.......................................................................................................................................................... 29
Sessions
.......................................................................................................................................................... 31
Import
.......................................................................................................................................................... 32
Export
.......................................................................................................................................................... 33
9 Help
................................................................................................................................... 33
Index
.......................................................................................................................................................... 33
Homepage
.......................................................................................................................................................... 33
Forum
.......................................................................................................................................................... 33
MySQL manual
.......................................................................................................................................................... 33
Install Update
.......................................................................................................................................................... 34
Registration
.......................................................................................................................................................... 34
Info
.......................................................................................................................................................... 34
35
1 How to Start
................................................................................................................................... 35
2 Connection
...................................................................................................................................
Problems
35
3 Using the...................................................................................................................................
Program
36
4 Speed up...................................................................................................................................
the Program
37
5 Missing Features
................................................................................................................................... 38
6 SSH Tunnel
................................................................................................................................... 38
7 PHP Tunnel
................................................................................................................................... 38
8 Translations
................................................................................................................................... 39
9 Known Bugs
................................................................................................................................... 39
Part IV Others
39
1 Shareware
................................................................................................................................... 39
2 Licence ................................................................................................................................... 39
3 Redistribution
................................................................................................................................... 40
4 Copyright................................................................................................................................... 40
5 Liability /...................................................................................................................................
Warranty
41
6 Support /...................................................................................................................................
Additional Help
41
IV
Index
42
MySQL-Front
Introduction
1.1
Features
MySQL-Front is an easy to use, compact, and very fast graphical tool to manage your MySQL
database - from anywhere in the world.
The program makes it possible to perform all essential administration tasks such as create/change
data structures, viewing / creating data, and direct execution of SQL commands easily and
comfortably with the look and feel of Microsoft Windows.
High-Degree of Compatibility:
Supports MySQL databases starting with version 3.23
Supports all commonly used MySQL table and column types
If desired, use of the MySQL DLL to access the database and thus compatible with future
versions
Runs on any version of Windows (starting with 95 / NT 4.0) system
Use of numerous Windows API functions to ensure compatibility with future Windows versions
Full Drag&Drop and Copy&Paste support
If the ISP prohibits external access to the database, use a PHP tunnel to still access the
database
Ease of Use:
Windows-conformant use of all elements
Clearly structured menu prompts
Efficient use either via keyboard or with mouse only
Data structure depiction same as in Windows Explorer
Interactive dialogs to edit the entiered data structures
Data depiction with data grid same as in MS Excel
Detailed manual
Very fast because of efficient programming and using the "Multi Query Support".
Individual Configuration:
Language settings (more than 30 languages available, unicode supported)
Design settings
Various options to configure the database linkage
Numerous program use settings
Syntax highlighting with individual colors
Standard Database Editing:
Create, change and delete databases, tables, views, procedures, functions, triggers, indices,
fields and foreign keys
Create, change and delete data incl. Memo / BLOB using a HEX editor
Display graphics in BLOB data (BMP, GIF, JPEG and PNG)
Full Unicode support for data and identifiers
Data / Data Structure Import:
SQL File
Text File (CSV format)
MS Access File
ODBC (Open Database Connector)
Introduction
1.2
38
Minimum Requirements
Hardware:
PC with Pentium (compatible) processor
10 MB hard disk space
Software:
Microsoft Windows 98 / NT 4.0
MySQL database version 3.23.20
(PHP Tunnel 38 : Webserver with PHP 4.1.0)
Documentation:
MySQL database manual
1.3
Installation / Uninstallation
Installation is very simple: Launch the MySQL-Front_Setup.exe setup program and follow the
instructions in your language. Defaults are offered for all configuration possibilities, which function
problem-free on almost all systems.
Uninstallation is just as simple: Select the uninstall program from the start menu or the Windows
Control Panel (Software) and confirm done.
MySQL-Front
The Setup program accepts optional command line parameters. These can be useful to system
administrators, and to other programs calling the Setup program.
MySQL-Front_Setup.exe [Options]
List of Options:
/SP
Disables the "This will install... Do you wish to continue?" prompt at the beginning of Setup.
/NOCANCEL
Prevents the user from cancelling during the installation process, by disabling the Cancel button
and ignoring clicks on the close button.
/LOADINF="filename"
Instructs Setup to load the settings from the specified file after having checked the command line.
This file can be prepared using the '/SAVEINF=' command as explained below.
Don't forget to use quotes if the filename contains spaces.
/SAVEINF="filename"
Instructs Setup to save installation settings to the specified file.
Don't forget to use quotes if the filename contains spaces.
/DIR="x:\dirname"
Overrides the default directory name displayed on the Select Destination Location wizard page. A
fully qualified pathname must be specified.
/GROUP="folder name"
Overrides the default folder name displayed on the Select Start Menu Folder wizard page.
/NOICONS
Instructs Setup to initially check the Don't create any icons check box on the Select Start Menu
Folder wizard page.
1.4
Purchase
Shareware Version Notes:
You can order the shareware version of this program as follows:
On the Internet through the online shop.
Or use the online order form.
All other ordering details and prices are listed on the ordering form.
Updates of the shareware version may be downloaded from the Internet whenever they become
available.
Program
Program
2.1
Files
2.1.1
Connection
2.1.2
31
Object Browser
Menu: File / Object Browser (only professional mode)
2.1.3
31
Data Browser
Menu: File / Data Browser (only professional mode)
2.1.4
31
SQL Editor
Menu: File / SQL Editor (only professional mode)
Opens a window with an editor used to directly create and execute SQL scripts.
See also:
Sessions
2.1.5
31
System Tools
Menu: File / System Tools (only professional mode)
Opens a window with various tools used to configure the database server.
MySQL-Front
See also:
Sessions
2.1.6
31
Open
Menu: File / Open (only SQL Editor)
2.1.7
Save
Menu: File / Save (only SQL Editor)
2.1.8
Save as
Menu: File / Save as (only SQL Editor)
Saves a SQL script to a file and prompts for the file name.
See also:
Save 9
2.1.9
Recent files
Menu: File / Recent files (only SQL Editor)
2.1.10 Import
2.1.10.1 SQL File
Menu: File / Import / SQL File
Executes all SQL queries from the specified file in the selected database.
Program
10
SQL queries are executed directly without first loading the entire file into the SQL Editor. This means
the execution is much faster and saves system resources.
Error Handling: (Only CSV file)
Deactivates MySQL-Front error handling. This means data records are written to the database
much faster.
Error show:
Only shows errors that occurred without informing the user explicitly.
Error Save in file:
Saves the sections with an error during importing to a file
2.1.10.2 Text File
Menu: File / Import / Text File
MySQL-Front
11
2.1.11 Export
2.1.11.1 SQL File
Menu: File / Export / SQL File
The selected data and their structures are exported to a SQL file. This conforms largely to the output
of mysqldump.
Use this file to save the content of database to a file. This is rather practical for data backup or to
send data, for example.
Include:
Structure: Exports the data structure with CREATE TABLE queries.
Data: Exports the data.
Database:
Create Database(s): Generates CREATE DATABASE queries
Select Database(s): Generates USE `databasename` queries
Handle existing data:
Drop before Create: Generates a corresponding DROP query before each vor CREATE query to
delete any existing data.
Complete Insert Queries: Generates INSERT queries for which the field name is also indicated for
every field. (Only meaningful if data are not to be added to an existing table and if the existing
table does not exactly correspond with the table to be exported.)
General:
Include Comments: Adds comments to the file to make the file easier to read.
Quote Identifiers: Encloses all identifiers in quotes. This is required if identifiers contain empty
character strings or reserved words.
Disable Keys: Deactivates foreign key verification while importing the file.
Lock Tables: Prevents updates of other programs/users during the export.
2.1.11.2 Text File
Menu: File / Export / Text File
The selected data and their structures are saved to a comma separated values text file.
These types of files are easily used by programs such as Excel.
This format used to be the default format to transfer table contents between different programs. This
is more frequently done with XML files as well.
If several tables are selected, a file is created for each table.
Write Headlines:
Generates a line containing the field names.
Program
12
Separator:
Specifies the separating character between the fields or a fixed column width for individual fields.
Quote Character:
Character used to enclose all string fields.
New Line:
Selects the default line break.
2.1.11.3 HTML File
Menu: File / Export / HTML File
The selected data and their structures are saved to a file viewable with a Web browser.
This is useful to easily send data and their structures via email or show to other developers via
Internet/Intranet.
The generated file uses the so-called cascading style sheet (CSS) to visually improve output.
However, browsers without CSS also display the data but in that case with less formatting.
BLOB field data are not exported since HTML cannot display these.
Include:
Structure: Exports the data structure with CREATE TABLE queries.
Data: Exports the data.
2.1.11.4 XML File
Menu: File / Export / XML File
The selected data and their structures are exported to an XML file.
The XML format increasingly develops into the default format for data transfer between different
systems.
Importing XML files, however, is rather complex and resource-intensive. Many systems therefore do
not offer such an import as of yet.
2.1.12 Print
Menu: File / Print (requires Internet Explorer)
12
Tip:
Data can be exported to a PDF file using the PDF printer driver.
MySQL-Front
13
2.1.13 Close
Menu: File / Close
13
2.1.15 Exit
Menu: File / Exit
2.2
Edit
2.2.1
Undo
Menu: File / Undo (only SQL Editor)
2.2.2
Redo
Menu: File / Redo (only SQL Editor)
2.2.3
Cut
Menu: Edit / Cut
Copies the current selection to the Windows Clipboard. Once the content of the Clipboard has been
inserted somewhere the selection is deleted.
Copyright (C) 2000-2005 by Star-Tools GmbH
Program
14
See also:
Delete 14
2.2.4
Copy
Menu: Edit / Copy
2.2.5
14
Paste
Menu: Edit / Paste
2.2.6
15
Delete
Menu: Edit / Delete
2.2.7
Select all
Menu: Edit / Select all
2.2.8
Copy to File
Menu: Edit / Copy to file
MySQL-Front
2.2.9
15
15
2.2.10 Rename
Menu: Edit / Rename
2.3
Search
2.3.1
Search
Menu: Search / Search
2.3.2
15
Replace
Menu: Search / Replace
Searches for a character string and then replaces this string with a different character string.
See also:
Search Next
2.3.3
15
Search Next
Menu: Search / Search Next
Program
2.4
View
2.4.1
Object Browser
16
2.4.2
Data Browser
Menu: View / Data Browser (only standard mode)
2.4.3
SQL Editor
Menu: View / SQL Editor (only standard mode)
2.4.4
Location Bar
Menu: View / Address Bar
MySQL-Front offers the same navigation as with Web Browsers with the help of URLs. This can
significantly speed up searches with many databases / tables.
Favorites also use these addresses (URI format). It is also possible to call MySQL-Front by using a
URL. This means links from the Windows start menu or other programs can be directly setup to
connect with a specific view within MySQL-Front.
This also functions the other way around. Addresses of other programs can also be entered into
MySQL-Front. For example, entering http://www.mysql-front.com/ opens the homepage of MySQLFront in the Web Browser.
2.4.5
Navigator
Menu: View / Navigator
2.4.6
Favorites
Menu: View / Favorites
Frequently used addresses can be saved as Favorites within MySQL-Front similar to the function
found in other programs such as Web Browsers.
Copyright (C) 2000-2005 by Star-Tools GmbH
MySQL-Front
17
2.4.7
SQL Log
Menu: View / SQL Log
2.4.8
List
Menu: View / List
Elements within the Object Browser can also be depicted only as a text name without details. Since
this additional information does not have to be loaded from the database, the display is much faster.
2.4.9
Report
Menu: View / Report
All elements can also be depicted with additional information within the Object Browser. This means
details can be displayed in an organized structure without having to open and view the properties of
individual objects.
Additional hints such as focused menu entries, for example, are displayed within the status bar of the
program
The Window Bar shows like the Task Bar of Windows all windows inside MySQL-Front. While several
different windows are opened the Window Bar enables the fast and easy switching between the
windows.
2.4.12 Refresh
Menu: View / Refresh
Updates and redraws the right side of the current window of the database.
See also:
Refresh All
18
Program
18
Updates and redraws the entire window of the database. This means all elements (and possibly the
cache as well) of the current window are updated.
Note:
If several windows of the same session are open, update and redraw also includes these other
windows.
See also:
Refresh
17
2.5
Favorites
2.5.1
Add
Menu: Favorites / Add
The current view (address) is added to the list of Favorites. An individual name can be indicated for
each Favorite. (Assignment of identical names is not permitted.)
The format of the address will be described here
See also:
Properties
2.5.2
18
18
Properties
Menu: Favorites / Properties
The Favorites view is used to edit Favorites. A unique name can be indicated for each Favorite.
Format of the address:
mysql://username:password@www.myserver.com:3306/browser/databasename/tablename/
Addresses starting with "mysql://" refer to MySQL-Front. MySQL-Front passes other addresses to the
respectively linked program.
The username / password is not needed since it will be stored in the session.
The server has to be the same like the server of the session.
There are some additional parameter possible:
Data Browser:
limit: Number of records
filter: Filter of the SELECT query to get the data
SQL Editor:
file: Filename to open
MySQL-Front
19
It's also possible to start MySQL-Front with a address as parameter. In this case the servername /
username will be needed to detect the correct session.
2.6
Database
2.6.1
New
2.6.1.1
Database
Menu: Database / New / Database
Table
Menu: Database / New / Table
View
Menu: Database / New / View
Routine
Menu: Database / New / Routine
Program
2.6.1.5
20
Trigger
Menu: Database / New / Trigger
Index
Menu: Database / New / Index
Field
Menu: Database / New / Field
Foreign Key
Menu: Database / New / Foreign Key
Host
Menu: Database / New / Host
MySQL-Front
21
2.6.1.10 User
Menu: Database / New / User (only with MySQL version 4.0 and higher)
2.6.2
Remove
2.6.2.1
Database
Menu: Database / Remove / Database
Table
Menu: Database / Remove / Table
View
Menu: Database / Remove / View
Routine
Menu: Database / Remove / Routine
Trigger
Menu: Database / Remove / Trigger
Index
Menu: Database / Remove / Index
Program
2.6.2.7
22
Field
Menu: Database / Remove / Field
Foreign Key
Menu: Database / Remove / Foreign Key
Host
Menu: Database / Remove / Host
2.6.3
Properties
2.6.3.1
Server
Menu: Database / Properties / Server
General:
Displays additional information about the database server such as version and uptime.
The database can be closed. (This is only possible if sufficient access rights are available.)
Errors: (This is available if the database is located on "localhost" only.)
Displays the error log of the database.
Hosts:
Copyright (C) 2000-2005 by Star-Tools GmbH
MySQL-Front
23
Database
Menu: Database / Properties / Database
Table
Menu: Database / Properties / Table
View
Menu: Database / Properties / View
Program
2.6.3.5
24
Routine
Menu: Database / Properties / Routine
Trigger
Menu: Database / Properties / Trigger
Index
Menu: Database / Properties / Index
Field
Menu: Database / Properties / Field
Foreign Key
Menu: Database / Properties / Foreign Key
MySQL-Front
25
2.6.3.11 User
Menu: Database / Properties / User (only with MySQL version 4.0 and higher)
2.6.4
2.6.5
Delete record
Menu: Database / Delete Record (only Data Browser)
2.6.6
Edit record
Menu: Database / Edit
2.6.7
Run
Menu: Database / Run (only SQL Editor)
Program
26
Larger scripts in the form of a file can be imported directly (and thus quicker) when using Import
from a SQL File 9 .
If you do not want to change the SQL script, you should import instead of using the SQL Editor.
See also:
Run Selection
2.6.8
26
Run Selection
Menu: Database / Run Selection (only SQL Editor)
Executes the current/selected query of the SQL Editor. This is useful for testing individual sections of
a script.
See also:
Run 25
2.6.9
Empty
Menu: Database / Empty
Empties the data of the selected element (sets the data fields to NULL).
2.7
Extras
2.7.1
Search
Menu: Extras / Search
MySQL-Front
2.7.2
27
Replace
Menu: Extras / Replace
MySQL-Front offers a data Search&Replace function within whole databases. Depending on the
applied search mask/criteria, data within the database can be replaced in part or as a whole.
Search&Replace requires significant resources if tables are large. The actual amounts vary
depending on numerous different factors.
Search for:
Old value / pattern for which to search
Replace with:
New value / new pattern
Search options:
Case sensitive: Capital/small letters are not adjusted.
Whole values: Only values completely matching the search pattern are considered.
Regular expression: Search using regular expressions.
Backup:
A table can be generated before synchronization. This table will be assigned the name of the
respective table with the extension "_bak". Already existing copies with this extension are
overwritten without warning.
A backup copy is generated completely within the database. Creating backups can use significant
resources of the database if tables are large.
Warning:
Existing data are changed and cannot be restored during replacing.
User or program errors are always a possibility.
Data backups are therefore important and should be created frequently!
See also:
Replace 15
Search 26
2.7.3
Transfer
Menu: Extras / Transfer
Program
28
mouse.
Structure:
The data structure (objects) will be transfered.
Data:
The data will be transfered.
See also:
Synchronize
2.7.4
28
Synchronize
Menu: Extras / Synchronize
MySQL-Front allows the synchronization of different tables. The primary index is used to identify the
data. This means that tables can be synchronized only with a primary index.
The objects of the table(s) (fields / indices) are identified with the column names.
Foreign keys are not transferred during the synchronization.
You can synchronizie two different tables on different (or the same) session.
Otherwise it's possible to synchronize two databases or two entiered sessions. But it's not
recommended to synchronize two sessions, since this encloses the "mysql" database.
What:
Either the data structure (objects) and/or the data can be synchronized.
Direction:
Only the table(s) identified as slaves are modified.
Update existing objects:
The settings (e.g. data type) of existing object is updated.
Existing data:
Existing data are updated (overwritten) without any warning.
Ignore Foreign Keys:
Foreign keys are deactivated during synchronization. Please consult the MySQL manual for a
description of advantages and disadvantages of this functionality.
Lock Tables:
A table being synchronized is locked to other users / programs during the synchronization process.
Please consult the MySQL manual for a description of advantages and disadvantages of this
functionality.
Backup:
A table can be generated before synchronizing data. This table will be assigned the name of the
respective table with the extension "_bak". Already existing copies with this extension are
overwritten without warning.
Copyright (C) 2000-2005 by Star-Tools GmbH
MySQL-Front
29
A backup copy is generated completely within the database. Creating backups can use significant
resources of the database if tables are large.
Warning:
Existing data are changed during synchronization and cannot be restored.
User or program errors are always a possibility.
Data backups are therefore important and should be created frequently!
See also:
Transfer
27
2.8
Settings
2.8.1
Global settings
Menu: Settings / Global Settings
This is where all of the settings for the program itself are configured. Included are language, design,
and user level, for example.
View:
Language:
Selects the language used in MySQL-Front. (This does not apply to database messages.)
Skin:
Selects the appearance (icons) of MySQL-Front.
User Level:
Describes the basic window layout within MySQL-Front. (To change this option please close all
windows before.)
Navigator: Table details:
Shows indices, fields, and constraints within the navigator in addition to the other elements.
(The right side does not list any information for these elements.)
Navigator: System Tools: view (Standard Mode)
Shows the system tools of the database (hosts, users, etc.). Obtaining this information from the
database takes a little time.
Files:
Languages:
Indicates the folder of the language files.
Skins:
Indicates the folder of the skin files.
Database Macros:
Indicates the folder of the MySQL macros.
Global Macros:
Indicates the folder of the global MySQL macros.
User Macros:
Indicates the folder of the user-defined MySQL macros.
File types: associate:
.sql:
Copyright (C) 2000-2005 by Star-Tools GmbH
Program
30
Links files with the .sql extension with MySQL-Front in Windows Explorer.
mysql://
Links URI (Unified Resource Identifier) starting with "mysql://" with MySQL-Front in the
whole Windows system. This allows to open (and execute) SQL files from the local system
or from any address in the Internet.
Data Browser:
Data Font:
Indicates the font used to display data in data tables.
NULL values:
Indicates the background color and a font for NULL values.
Maximal column width:
Wide data fields can be limited as specified so that several columns are visible on screen at
once.
Memo data in grid:
Describes wether the content of text fields is also displayed within the data table.
BLOB data in grid:
Describes wether the content of BLOB fields is also displayed within the data table. (Only
meaningful if text is saved within the BLOB fields. The latter is not intended by MySQL but is
still done by a few users.)
Default sorting:
Indicates whether the data of the database is to be sorted based on the primary index by
default. In case of larger tables, this uses more system resources of the database.
Editor:
SQL Font:
Indicates the font used by the SQL Editor.
Line Numbers:
Shows line numbers.
Auto. Indent:
Automatic Indent is enabled.
Tabulator:
Allowes the usage of the <Tab> key.
Tab in spaces:
Each tabulator (from the file of of the keyboard) will be translated to spaces.
Tabstop:
Numbers of chars for the tabulator.
Right Edge:
Shows line on the right to help the user not to use too large lines.
Code Completition:
Activates the code completition popup window in the SQL Editor. The time for showing the
popup help can be entered in Milliseconds (ms).
SQL Log:
Font:
Indicates the font used in the SQL log.
Line numbers:
Line numbers are displayed within the SQL log.
Time:
Shows the local time when the query has been sent to the database. (To change this option
please close all windows before.)
Result:
Shows the result of the SQL query sent to the database. (To change this option please close all
MySQL-Front
31
windows before.)
Errors:
Shows received errors from the database. (To change this option please close all windows
before.)
Highlighting:
Uses the same colors for the SQL log and the SQL Editor. Assigning the colors requires
computing time every time the SQL log is updated. MySQL-Front is thus faster if the SQL log is
used without colors.
Lines:
MySQL-Front requires more time and system resources for a large log. It is thus recommended
limiting the size of the log.
HTTP Proxy:
Some internal networks and ISPs do not permit direct access to the database from the Internet due
to security reasons. If this is the case, an HHTP proxy is used.
MySQL-Front applies the http protocol for PHP tunneling.
Updates:
MySQL-Front is able to check automatically whether a program update is available.
See also:
Sessions
2.8.2
31
Sessions
Menu: Settings / Sessions
In MySQL-Front, settings relevant to database linkages are saved in "sessions". Each session
contains various connection-related settings such as server, user, and password as well as numerous
additional settings such as selection of utilized databases or caching settings.
This means it might also be advisable, in certain situations, to create different sessions for a database
connection (e.g., one with caching and one without).
(To edit / delete a session you have to close all open windows of this session before.)
Common:
Name:
Specifies the name of the session used to identify the session in MySQL-Front.
Connection:
Server:
Address of the server hosting the database. The server is described with a domain name or an
IP address.
Port:
Port number of the database (usually 3306).
Connection Type:
Indicates the type of database access. Direct access is usually possible. For reasons of
compatibility, the use of a vendor library might be necessary. This library is supplied together
with the MySQL database.
Some ISPs do not permit access to the database from external computers. This problem can
Copyright (C) 2000-2005 by Star-Tools GmbH
Program
32
18
to delete the cache once when working with the session as well.
Data Browser:
Limit:
MySQL-Front can limit the number of records loaded in the Data Browser. This is practical in
case of large tables since loading the complete table might take a long time or even exceed the
memory capacity of the workstation.
Default Sorting:
MySQL-Front can load the records sorted in accordance with the order of the primary index of
the database. This makes viewing these records much easier. Sorting can use significant
resources of the database if tables are large.
See also:
Global Settings
2.8.3
29
Import
Menu: Settings / Import
MySQL-Front
33
See also:
Export 33
2.8.4
Export
Menu: Settings / Export
Saves all settings (session and global settings) to a file. This means that these setting can also be
transferred to another computer or restored after a hard drive crash.
Note:
This file also contains the passwords for the sessions. The file should therefore be safeguarded
appropriately.
See also:
Import 32
2.9
Help
2.9.1
Index
Menu: Settings / Sessions
2.9.2
Homepage
Menu: Help / Homepage
2.9.3
Forum
Menu: Help / Forum
2.9.4
41
MySQL manual
Menu: Help / MySQL Manual
Program
2.9.5
34
Install Update
Menu: Help / Install Update (needs a running internet connection)
MySQL-Front can install updates automatically. This requires the MySQL-Front is exited, which is
why all open sessions have to be closed.
The update itself runs fully automatic until MySQL-Front is restarted.
2.9.6
Registration
Menu: Help / Registration (only unregistered shareware version)
2.9.7
Info
Menu: Help / Info
MySQL-Front
FAQ
3.1
How to Start
35
3.2
Connection Problems
MySQL-Front reports connection problems: "Can't connect to MySQL server on
'www.server.com' (10060)". What can I do?
Check the network connection to the server.
Check your Internet connection and your firewall.
Findout and solve other problems why MySQL-Front is not able to create a network connection
to the database server.
Read the MySQL manual: http://dev.mysql.com/doc/mysql/en/Can_not_connect_to_server.html
I get the following error from the database: "Access denied for user:
username@123.yourprovider.com". What can I do?
Please be sure to enter exactly the login information (user, password and database) you received
from your database administrator (often your ISP).
If this does not help you, please contact your ISP and ask if you are allowed to login from your
local client to the database on your account. Frequently, the ISP does not permit this. In this case,
you may be able to connect by using a PHP Tunnel 38 or a SSH Tunnel 38 .
Additional information is listed in the MySQL manual:
http://dev.mysql.com/doc/mysql/en/Access_denied.html
MySQL-Front reports connection problems #1130: "Host '123.yourprovider.com' is not allowed
to connect to this MySQL server". What can I do?
Some database administrators (ISPs) permit access to the MySQL database not from all
computers due to reasons of security. This means MySQL-Front cannot access the database
normally.
This problem can be circumvented with the useage of so-called PHP Tunnel
38
or a SSH
FAQ
Tunnel
38
36
3.3
38
38
MySQL-Front
37
program about any changes. Because of this MySQL-Front can't recognize which changes you've
forced by your manually SQL statements.
When I press the refresh button, navigation is not actualized. Why?
The "Refresh" button updates only the right side to speed up this process.
If you want to refresh the navigator or the cache as well, please select the View / Refresh All menu
or press the shift key while clicking on the refresh button in the toolbar.
Do you have a list of shortcuts of the keyboard?
A lot of shortcuts are used on the same way like you know it from the most other Windows
programs. Some shortcuts has different functions depends on the place you use it. Please use the
menu to find out which shortcuts are availble for the current selected compontent of the application.
I can't see if a field is unique in version 3.x. (In version 2.x I was able to see that). Why?
MySQL-Front version 2.x shows columns as unique. But a MySQL column has no attribute to be
unique. So this was a bug of version 2.x.
How can I step back after an update?
Please install the version you want to have. This will overwrite a newer version.
I purchased a shareware version of MySQL-Front and received it on a disk. How can I use a
current version?
Please download the current version from the Internet. Please copy the license key file MySQLFront.key from the disk to the setup program or to the installed program folder.
3.4
FAQ
38
3.5
Missing Features
I miss some important / nice features in MySQL-Front. How can I get these feature or
functions?
Please submit your suggestions to the MySQL-Front forum 41 . The developers will try to
implement the feature or function.
3.6
SSH Tunnel
What is a SSH tunnel and how does it work?
Please refer the MySQL manual:
http://dev.mysql.com/doc/mysql/en/windows-and-ssh.html
See also:
PHP Tunnel
3.7
38
PHP Tunnel
What is a PHP tunnel and how does it work?
Some ISPs permit access to the MySQL database only from the Web server due to reasons of
security. This means MySQL-Front cannot access the database normally (error: Access denied).
This problem can be circumvented with the use of so-called PHP tunnel.
Install the PHP script phpMySQL.php on the Web server (included with the program). Then,
from within the session, select the connection type "PHP tunnel" and specify the respective URL of
the PHP script.
MySQL-Front converts the database query into an HTTP request and sends this request to the
PHP script on the Web server. (The script can access the database since it is, same as the other
scripts, located on the Web server.) The PHP script then converts the reply of the database and
sends it as the HTTP result back to MySQL-Front.
Unfortunately, this is somewhat awkward and also significantly slower than any direct access.
However, this makes it possible to access the database even if the provider does not permit
access any other way.
If you are connected with the Internet through a firewall, you might have to use an HTTP proxy
(Global settings 29 ).
In rare cases, it is necessary to enter "localhost" as server in the session settings (tab Connection).
This is the case if the Web server does not feature DNS resolution.
Since PHP doesn't support to use resources in sessions each single database request opens a new
database process and close them after receiving the single response. Because of this by using the
PHP Tunnel the database is not be able to remember any session settings like variables, rollback
or something like this.
MySQL-Front
See also:
SSH Tunnel 38
Sessions 31
Speed up the Program
3.8
39
37
Translations
I would like to translate MySQL-Front into another language. Am I allowed to do so?
Yes. All language files are stored in the folder:
C:\Program Files\MySQL-Front\Languages
English is the original language. Just copy this file and translate it into the language of your choice.
The program "Ini Translator", http://initranslator.sourceforge.net/ is a small but effective program
to create and edit translations.
We would be pleased if we could offer your specific translation together with MySQL-Front for
download to provide other users with the opportunity to enjoy your language file as well. If you are
offering your quality translation to us, we will provide you with one free MySQL-Front license.
3.9
Known Bugs
Are there any errors known to exist in MySQL-Front?
Unfortunately, yes:
Date values with the value "00" as month or day / "0000" as year are not supported.
Date values before the year 1900 are not supported within the Data Browser, too.
Unsigned Bigint values with 64 bits (value > 9223372036854775807) are not supported within
the Data Browser.
Should you detect any further errors or problems, please inform the developer via the forum
they will try to correct the problem as soon as possible.
Others
4.1
Shareware
33
and
You may test and evaluate this program free of charge and pass it along to other interested users as
well (without any registration key). Proper and standard use, however, requires registration of the
program (purchasing the program).
After the trial period is over, the program will work in the lite mode only:
The Object Browser is only usable as 'Read only'.
It is not possible to insert new data records in the Data Browser.
Profile Mode: Read only use of the system tools.
One license is required for each user using MySQL-Front! If several licenses are ordered, it is
possible to obtain one key for all licenses.
4.2
Licence
This software is available for a free evaluation period of 30 days.
During this time period, the license to use the software is a "gift" from the copyright owner to the user.
Copyright (C) 2000-2005 by Star-Tools GmbH
Others
40
Because this is a gift, the user has no rights to make any demands pertaining to the copyright owner.
Special note: The user is not entitled to any warranties or guarantees of any kind.
To use this software for an unlimited time, the user has to purchase a license.
This software can be evaluated before the actual purchase. Because of this the software is provided
as is and without warranty of any kind.
4.3
Redistribution
Redistrubtions in the internet has to be granted by the copyright owner. It's only allowed to publish this
software in the internet if the publishing is listed on the download page of the program.
Additional the publisher has to make sure to update the binary program dayly. (Further informations
on the download page of this program.)
Redistributions on physical media like CDs and DVDs are allowed without limitations if the author of
the media uses the latest available version of this program right before manufactureing the media.
4.4
Copyright
The right to redistribute this product on the Internet has to be granted by the copyright owner. This
software may be published on the Internet only if the appropriate data, permissions, and information
appear on the download page of the program.
Additionally, the publisher has to make sure to update the binary program daily. (Further information
is listed on the download page of this program.)
Redistribution on physical media such as CDs and DVDs is permitted without restrictions if the author
of the media uses the latest version of this program available immediately before manufacturing the
media.
The following is the copyright (C) owner of MySQL-Front:
Postal Mail:
Star-Tools GmbH
Hopfenweg 207
22851Norderstedt
Germany
Internet:
http://www.mysqlfront.de/
Special thanks for using external toolboxes:
Cristian Nicola for DirectSQL under LGPL
SynEdit Development Team for SynEdit under MPL
Markus Stephany for TMPHexEditor as freeware
TurboPower Software for TurboPower LockBox under MPL
Gustavo Huffenbacher Daud for TPNGImage as freeware
Finn Tolderlund (Anders Melander) for TGIFImage
Special thanks for translations and generating the graphics depicted in the program
34
MySQL-Front
4.5
41
Liability / Warranty
If this program is used improperly, it may result in the irretrievable destruction of all data in your
MySQL database!
It is thus absolutely necessary to create a backup before using MySQL-Front. According to the ruling
by the district court of Konstanz, Germany 1 S 292/95 from May 10, 1997, daily data backup is
reasonable and can be expected!
Thus, any responsibility or liability for any losses or damages is not accepted!
NOT UNDER ANY CIRCUMSTANCES!
Note for the shareware version:
The purchase of this software is subject to BGB 494 (German Civil Code) and thus is defined as
a "trial purchase." This means that the software can be evaluated before the actual purchase. The
software is provided as is without warranty of any kind. Any rights for modifications or follow-up
corrections do not exist.
Should you detect any errors, please inform our support staff via the forum
correct the problem within a few days.
4.6
33
Index
Location Bar
Index
Minimum Requirements
MS Access file (Import)
Add Favorite 18
ANALYZE 36
Object Browser 8, 16
ODBC Table (Import) 10
Open (File) 9
OPTIMIZE 36
CHECK 36
Close 13
Close all 13
Connection 8
Copy 14
Copy to File 14
Cut 13
-PPaste 14
Paste from File
Print 12
Procedure 19
Purchase 7
-D-
-RRecent files 9
Redo 13
Rename 15
Replace 15, 27
13
-F-
-S-
16
5
19
12
-IInstallation / Uninstallation
-LList
17
15
8, 16
-E-
Favorites
Features
Function
6
10
-O-
-C-
Exit
16
-M-
-A-
Data Browser
Delete 14
42
Save (File) 9
Save as (File) 9
Search 15, 26
Search Next 15
Select all 14
Service 23
SQL Editor 8
SQL File (Export) 11
SQL File (Import) 9
SSH Tunnel 38
Status Bar 17
Stored Function 19
Stored Procedure 19
Synchronize 28
System Tools 8
Copyright (C) 2000-2005 by Star-Tools GmbH
MySQL-Front
43
11
10
-UUndo
13
-WWindow Bar
17
12