now 2 scripts to create tables for the infrastructure
This commit is contained in:
Marc Delisle
@@ -5,6 +5,10 @@ phpMyAdmin - Changelog
|
|||||||
$Id$
|
$Id$
|
||||||
$Source$
|
$Source$
|
||||||
|
|
||||||
|
2004-07-23 Marc Delisle <lem9@users.sourceforge.net>
|
||||||
|
* Documentation.html: take into account the new script to
|
||||||
|
create tables for the infrastructure
|
||||||
|
|
||||||
2004-07-23 Alexander M. Turek <me@derrabus.de>
|
2004-07-23 Alexander M. Turek <me@derrabus.de>
|
||||||
* config.inc.php, libraries/config_import.lib.php,
|
* config.inc.php, libraries/config_import.lib.php,
|
||||||
libraries/select_lang.lib.php: Made phpMyAdmin aware that there is a
|
libraries/select_lang.lib.php: Made phpMyAdmin aware that there is a
|
||||||
|
|||||||
@@ -165,18 +165,32 @@
|
|||||||
in your browser. phpMyAdmin should now display a welcome screen
|
in your browser. phpMyAdmin should now display a welcome screen
|
||||||
and your databases, or a login dialog if using HTTP or cookie
|
and your databases, or a login dialog if using HTTP or cookie
|
||||||
authentication mode.</li>
|
authentication mode.</li>
|
||||||
<li> For a whole set of new features (bookmarks, comments, SQL-history, PDF-generation, field contents transformation, etc.)
|
</ol>
|
||||||
you need to create a set of tables in your database. Please look at your scripts/
|
<a name="linked-tables"></a>
|
||||||
|
<h3>Linked-tables infrastructure</h3>
|
||||||
|
<p>
|
||||||
|
For a whole set of new features (bookmarks, comments, SQL-history,
|
||||||
|
PDF-generation, field contents transformation, etc.)
|
||||||
|
you need to create a set of special tables. Those tables can be located
|
||||||
|
in your own database, or in a central database for a multi-user
|
||||||
|
installation (this database would then be accessed by the controluser,
|
||||||
|
so no other user should have rights to it).
|
||||||
|
<br /> <br />
|
||||||
|
Please look at your scripts/
|
||||||
directory, where you should find a file called <i>create_tables.sql</i>.
|
directory, where you should find a file called <i>create_tables.sql</i>.
|
||||||
(If you are using a Windows server, pay special attention to <a href="#faq1_23">FAQ 1.23</a>).
|
(If you are using a Windows server, pay special attention to <a href="#faq1_23">FAQ 1.23</a>).
|
||||||
If your MySQL server's version is 4.1.2 or later, please use <i>create_tables_mysql_4_1_2+.sql</i> instead.
|
If your MySQL server's version is 4.1.2 or later, please use <i>create_tables_mysql_4_1_2+.sql</i> instead.
|
||||||
You can already use your phpMyAdmin to create the tables for you. Please be
|
You can already use your phpMyAdmin to create the tables for you. Please be
|
||||||
aware that you may have to have special (administrator) privileges to create
|
aware that you may need special (administrator) privileges to create
|
||||||
the database and tables. After having imported the <i>create_tables.sql</i> file,
|
the database and tables, and that the script may need some tuning,
|
||||||
you should specify the table names in your <i>config.inc.php</i> file. The directives
|
depending on the database name.
|
||||||
used for that can be found in the <a href="#config">Configuration section</a>.</li>
|
<br /> <br />
|
||||||
|
After having imported the <i>create_tables.sql</i> file,
|
||||||
</ol>
|
you should specify the table names in your <i>config.inc.php</i> file. The directives
|
||||||
|
used for that can be found in the <a href="#config">Configuration section</a>.
|
||||||
|
You will also need to have a controluser with the proper rights to
|
||||||
|
those tables (see section <i>Using authentication modes</i> below).</li>
|
||||||
|
</p>
|
||||||
|
|
||||||
<h3>Upgrading from an older version</h3>
|
<h3>Upgrading from an older version</h3>
|
||||||
<ul>
|
<ul>
|
||||||
@@ -589,45 +603,19 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
<b>$cfg['Servers'][$i]['pmadb']</b> string
|
<b>$cfg['Servers'][$i]['pmadb']</b> string
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
Starting with version 2.3.0 phpMyAdmin offers a lot of features
|
The name of the database containing the linked-tables infrastructure.
|
||||||
to work with master / foreign - tables. To use those as well as
|
|
||||||
the bookmark feature you need special tables with a
|
|
||||||
predefined structure, which we explain below.
|
|
||||||
<br /><br />
|
<br /><br />
|
||||||
See the <a href="#setup">Quick Install section</a> in this document for a quick way
|
See the <a href="#linked-tables">Linked-tables infrastructure</a>
|
||||||
of creating those tables. Also, if you are using a Windows server,
|
section in this document to see the benefits of this infrastructure,
|
||||||
read <a href="#faq1_23">FAQ 1.23</a>.
|
and for a quick way of creating this database and the needed tables.
|
||||||
<br /><br />
|
<br /><br />
|
||||||
If you are the only user of this phpMyAdmin installation, you can
|
If you are the only user of this phpMyAdmin installation, you can
|
||||||
use your current database to store those special tables; in this
|
use your current database to store those special tables; in this
|
||||||
case, just put your current database name in
|
case, just put your current database name in
|
||||||
<tt>$cfg['Servers'][$i]['pmadb']</tt>.
|
<tt>$cfg['Servers'][$i]['pmadb']</tt>. For a multi-user installation,
|
||||||
|
set this parameter to the name of your central database containing
|
||||||
|
the linked-tables infrastructure.
|
||||||
<br /><br />
|
<br /><br />
|
||||||
If you are setting up a multi-user phpMyAdmin installation,
|
|
||||||
you will need to create a new database and setup special privileges,
|
|
||||||
so, as superuser:
|
|
||||||
<br /><br />
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
create a new database for phpMyAdmin:<br />
|
|
||||||
<tt> CREATE DATABASE phpmyadmin;</tt><br />
|
|
||||||
If using MySQL 4.1.2 or later, use instead:<br />
|
|
||||||
<tt> CREATE DATABASE phpmyadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;</tt><br />
|
|
||||||
Note that "controluser" must have
|
|
||||||
<tt>SELECT, INSERT, UPDATE</tt> and <tt>DELETE</tt>
|
|
||||||
privileges on this database. Here is a query to set up
|
|
||||||
those privileges (using "phpmyadmin"
|
|
||||||
as the database name, and "pma" as the
|
|
||||||
controluser):<br />
|
|
||||||
<tt>
|
|
||||||
GRANT SELECT,INSERT,UPDATE,DELETE ON phpmyadmin.* to 'pma'@'localhost';
|
|
||||||
</tt><br />
|
|
||||||
do <b>not</b> give any other user rights on this database.
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
enter the database name in <tt>$cfg['Servers'][$i]['pmadb']</tt>
|
|
||||||
</li>
|
|
||||||
</ul><br />
|
|
||||||
</dd>
|
</dd>
|
||||||
|
|
||||||
<dt>
|
<dt>
|
||||||
@@ -638,22 +626,9 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
Since release 2.2.0 phpMyAdmin allows to bookmark queries. This can be
|
Since release 2.2.0 phpMyAdmin allows to bookmark queries. This can be
|
||||||
useful for queries you often run.<br /><br />
|
useful for queries you often run.<br /><br />
|
||||||
|
|
||||||
To allow the usage of this functionality you have to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>within this database create a table following this scheme:
|
|
||||||
<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_bookmark` (<br />
|
|
||||||
id int(11) DEFAULT '0' NOT NULL auto_increment,<br />
|
|
||||||
dbase varchar(255) NOT NULL,<br />
|
|
||||||
user varchar(255) NOT NULL,<br />
|
|
||||||
label varchar(255) NOT NULL,<br />
|
|
||||||
query text NOT NULL,<br />
|
|
||||||
PRIMARY KEY (id)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='Bookmarks';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>enter the table name in
|
<li>enter the table name in
|
||||||
<tt>$cfg['Servers'][$i]['bookmarktable']</tt></li>
|
<tt>$cfg['Servers'][$i]['bookmarktable']</tt></li>
|
||||||
</ul><br />
|
</ul><br />
|
||||||
@@ -701,25 +676,9 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
The keys can be numeric or character.
|
The keys can be numeric or character.
|
||||||
<br /><br />
|
<br /><br />
|
||||||
|
|
||||||
To allow the usage of this functionality the superuser has to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>
|
|
||||||
within this database create a table following this scheme:
|
|
||||||
<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_relation` (<br />
|
|
||||||
`master_db` varchar(64) NOT NULL default '',<br />
|
|
||||||
`master_table` varchar(64) NOT NULL default '',<br />
|
|
||||||
`master_field` varchar(64) NOT NULL default '',<br />
|
|
||||||
`foreign_db` varchar(64) NOT NULL default '',<br />
|
|
||||||
`foreign_table` varchar(64) NOT NULL default '',<br />
|
|
||||||
`foreign_field` varchar(64) NOT NULL default '',<br />
|
|
||||||
PRIMARY KEY (`master_db`, `master_table`, `master_field`),<br />
|
|
||||||
KEY foreign_field (foreign_db, foreign_table)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='Relation table';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
put the relation table name in
|
put the relation table name in
|
||||||
<tt>$cfg['Servers'][$i]['relation']</tt>
|
<tt>$cfg['Servers'][$i]['relation']</tt>
|
||||||
@@ -746,20 +705,9 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
<br />
|
<br />
|
||||||
This configuration variable will hold the name of this special
|
This configuration variable will hold the name of this special
|
||||||
table.
|
table.
|
||||||
To allow the usage of this functionality the superuser has to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>within this database create a table following this scheme:
|
|
||||||
<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_table_info` (<br />
|
|
||||||
`db_name` varchar(64) NOT NULL default '',<br />
|
|
||||||
`table_name` varchar(64) NOT NULL default '',<br />
|
|
||||||
`display_field` varchar(64) NOT NULL default '',<br />
|
|
||||||
PRIMARY KEY (`db_name`, `table_name`)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='Table information for phpMyAdmin';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
put the table name in
|
put the table name in
|
||||||
<tt>$cfg['Servers'][$i]['table_info']</tt>
|
<tt>$cfg['Servers'][$i]['table_info']</tt>
|
||||||
@@ -785,43 +733,14 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
pages) and "table_coords" (storing coordinates where each
|
pages) and "table_coords" (storing coordinates where each
|
||||||
table will be placed on a PDF schema output).
|
table will be placed on a PDF schema output).
|
||||||
<br /><br />
|
<br /><br />
|
||||||
You must be using the "relation" feature and have a table of
|
You must be using the "relation" feature.
|
||||||
PDF pages (see <tt><a href="#table_coords">$cfg['Servers'][$i]['pdf_pages']</a></tt>) to create PDF
|
|
||||||
output.
|
|
||||||
<br /><br />
|
<br /><br />
|
||||||
To allow the usage of this functionality the superuser has to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>
|
<li>
|
||||||
within this database create a table following this scheme:
|
put the correct table names in
|
||||||
<br />
|
<tt>$cfg['Servers'][$i]['table_coords']</tt> and
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_table_coords` (<br />
|
|
||||||
`db_name` varchar(64) NOT NULL default '',<br />
|
|
||||||
`table_name` varchar(64) NOT NULL default '',<br />
|
|
||||||
`pdf_page_number` int NOT NULL default '0',<br />
|
|
||||||
`x` float unsigned NOT NULL default '0',<br />
|
|
||||||
`y` float unsigned NOT NULL default '0',<br />
|
|
||||||
PRIMARY KEY (`db_name`, `table_name`, `pdf_page_number`)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='Table coordinates for phpMyAdmin PDF output';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
also within this database create:<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_pdf_pages` (<br />
|
|
||||||
`db_name` varchar(64) NOT NULL default '',<br />
|
|
||||||
`page_nr` int(10) unsigned NOT NULL auto_increment,<br />
|
|
||||||
`page_descr` varchar(50) NOT NULL default '',<br />
|
|
||||||
PRIMARY KEY (page_nr),<br />
|
|
||||||
KEY (db_name)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='PDF Relationpages for PMA';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
put the first table name in
|
|
||||||
<tt>$cfg['Servers'][$i]['table_coords']</tt>
|
|
||||||
and the second table name in
|
|
||||||
<tt>$cfg['Servers'][$i]['pdf_pages']</tt>
|
<tt>$cfg['Servers'][$i]['pdf_pages']</tt>
|
||||||
</li>
|
</li>
|
||||||
</ul><br />
|
</ul><br />
|
||||||
@@ -848,33 +767,15 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
for further information. To use the MIME-transformation system, your column_info
|
for further information. To use the MIME-transformation system, your column_info
|
||||||
table has to have the three new fields 'mimetype', 'transformation', 'transformation_options'.
|
table has to have the three new fields 'mimetype', 'transformation', 'transformation_options'.
|
||||||
<br /><br />
|
<br /><br />
|
||||||
To allow the usage of this functionality the superuser has to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>
|
|
||||||
within this database create a table following this scheme:
|
|
||||||
<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_column_info` (<br />
|
|
||||||
id int(5) unsigned NOT NULL auto_increment,<br />
|
|
||||||
db_name varchar(64) NOT NULL default '',<br />
|
|
||||||
table_name varchar(64) NOT NULL default '',<br />
|
|
||||||
column_name varchar(64) NOT NULL default '',<br />
|
|
||||||
`comment` varchar(255) NOT NULL default '',<br />
|
|
||||||
mimetype varchar(255) NOT NULL default '',<br />
|
|
||||||
transformation varchar(255) NOT NULL default '',<br />
|
|
||||||
transformation_options varchar(255) NOT NULL default '',<br />
|
|
||||||
PRIMARY KEY (id),<br />
|
|
||||||
UNIQUE KEY db_name (db_name, table_name, column_name)<br />
|
|
||||||
) TYPE=MyISAM COMMENT='Comments for Columns';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
put the table name in
|
put the table name in
|
||||||
<tt>$cfg['Servers'][$i]['column_info']</tt>
|
<tt>$cfg['Servers'][$i]['column_info']</tt>
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
To update your PRE-2.5.0 Column_comments Table use this:<br />
|
to update your PRE-2.5.0 Column_comments Table use this:<br />
|
||||||
<tt>
|
<tt>
|
||||||
ALTER TABLE `pma_column_comments` <br />
|
ALTER TABLE `pma_column_comments` <br />
|
||||||
ADD `mimetype` VARCHAR( 255 ) NOT NULL ,<br />
|
ADD `mimetype` VARCHAR( 255 ) NOT NULL ,<br />
|
||||||
@@ -905,25 +806,9 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
|
|||||||
see <b>$cfg['QueryFrame']</b>.
|
see <b>$cfg['QueryFrame']</b>.
|
||||||
<br /><br />
|
<br /><br />
|
||||||
|
|
||||||
To allow the usage of this functionality the superuser has to:
|
To allow the usage of this functionality:
|
||||||
<ul>
|
<ul>
|
||||||
<li>set up "pmadb" as described above</li>
|
<li>set up <a href="#pmadb">pmadb</a> and the linked-tables infrastructure</li>
|
||||||
<li>
|
|
||||||
within this database create a table following this scheme:
|
|
||||||
<br />
|
|
||||||
<tt>
|
|
||||||
CREATE TABLE `pma_history` (<br />
|
|
||||||
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,<br />
|
|
||||||
`username` VARCHAR( 64 ) NOT NULL ,<br />
|
|
||||||
`db` VARCHAR( 64 ) NOT NULL ,<br />
|
|
||||||
`table` VARCHAR( 64 ) NOT NULL ,<br />
|
|
||||||
`timevalue` TIMESTAMP NOT NULL ,<br />
|
|
||||||
`sqlquery` TEXT NOT NULL ,<br />
|
|
||||||
PRIMARY KEY ( `id` ) ,<br />
|
|
||||||
INDEX ( `username` , `db` , `table` , `timevalue` )<br />
|
|
||||||
) TYPE=MyISAM COMMENT='SQL history';<br />
|
|
||||||
</tt>
|
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
put the table name in
|
put the table name in
|
||||||
<tt>$cfg['Servers'][$i]['history']</tt>
|
<tt>$cfg['Servers'][$i]['history']</tt>
|
||||||
|
|||||||
Reference in New Issue
Block a user