<?php
/* vim: set expandtab sw=4 ts=4 sts=4: */
/**
* Holds the PhpMyAdmin\Normalization class
*
* @package PhpMyAdmin
*/
namespace PhpMyAdmin;
use PhpMyAdmin\Index;
use PhpMyAdmin\Message;
use PhpMyAdmin\Relation;
use PhpMyAdmin\Template;
use PhpMyAdmin\Transformations;
use PhpMyAdmin\Url;
use PhpMyAdmin\Util;
/**
* Set of functions used for normalization
*
* @package PhpMyAdmin
*/
class Normalization
{
/**
* DatabaseInterface instance
*
* @var DatabaseInterface
*/
private $dbi;
/**
* @var Relation $relation
*/
private $relation;
/**
* Constructor
*
* @param DatabaseInterface $dbi DatabaseInterface instance
*/
public function __construct(DatabaseInterface $dbi)
{
$this->dbi = $dbi;
$this->relation = new Relation();
}
/**
* build the html for columns of $colTypeCategory category
* in form of given $listType in a table
*
* @param string $db current database
* @param string $table current table
* @param string $colTypeCategory supported all|Numeric|String|Spatial
* |Date and time using the _pgettext() format
* @param string $listType type of list to build, supported dropdown|checkbox
*
* @return string HTML for list of columns in form of given list types
*/
public function getHtmlForColumnsList(
$db,
$table,
$colTypeCategory = 'all',
$listType = 'dropdown'
) {
$columnTypeList = [];
if ($colTypeCategory != 'all') {
$types = $this->dbi->types->getColumns();
$columnTypeList = $types[$colTypeCategory];
}
$this->dbi->selectDb($db);
$columns = $this->dbi->getColumns(
$db,
$table,
null,
true
);
$type = "";
$selectColHtml = "";
foreach ($columns as $column => $def) {
if (isset($def['Type'])) {
$extractedColumnSpec = Util::extractColumnSpec($def['Type']);
$type = $extractedColumnSpec['type'];
}
if (empty($columnTypeList)
|| in_array(mb_strtoupper($type), $columnTypeList)
) {
if ($listType == 'checkbox') {
$selectColHtml .= '<input type="checkbox" value="'
. htmlspecialchars($column) . '"/>'
. htmlspecialchars($column) . ' [ '
. htmlspecialchars($def['Type']) . ' ]</br>';
} else {
$selectColHtml .= '<option value="' . htmlspecialchars($column) . ''
. '">' . htmlspecialchars($column)
. ' [ ' . htmlspecialchars($def['Type']) . ' ]'
. '</option>';
}
}
}
return $selectColHtml;
}
/**
* get the html of the form to add the new column to given table
*
* @param integer $numFields number of columns to add
* @param string $db current database
* @param string $table current table
* @param array $columnMeta array containing default values for the fields
*
* @return string HTML
*/
public function getHtmlForCreateNewColumn(
$numFields,
$db,
$table,
array $columnMeta = []
) {
$cfgRelation = $this->relation->getRelationsParam();
$contentCells = [];
$availableMime = [];
$mimeMap = [];
if ($cfgRelation['mimework'] && $GLOBALS['cfg']['BrowseMIME']) {
$mimeMap = Transformations::getMIME($db, $table);
$availableMime = Transformations::getAvailableMIMEtypes();
}
$commentsMap = $this->relation->getComments($db, $table);
for ($columnNumber = 0; $columnNumber < $numFields; $columnNumber++) {
$contentCells[$columnNumber] = [
'column_number' => $columnNumber,
'column_meta' => $columnMeta,
'type_upper' => '',
'length_values_input_size' => 8,
'length' => '',
'extracted_columnspec' => [],
'submit_attribute' => null,
'comments_map' => $commentsMap,
'fields_meta' => null,
'is_backup' => true,
'move_columns' => [],
'cfg_relation' => $cfgRelation,
'available_mime' => isset($availableMime) ? $availableMime : [],
'mime_map' => $mimeMap
];
}
return Template::get(
'columns_definitions/table_fields_definitions'
)->render([
'is_backup' => true,
'fields_meta' => null,
'mimework' => $cfgRelation['mimework'],
'content_cells' => $contentCells,
'change_column' => $_POST['change_column'],
'is_virtual_columns_supported' => Util::isVirtualColumnsSupported(),
'browse_mime' => $GLOBALS['cfg']['BrowseMIME'],
'server_type' => Util::getServerType(),
'max_rows' => intval($GLOBALS['cfg']['MaxRows']),
'char_editing' => $GLOBALS['cfg']['CharEditing'],
'attribute_types' => $this->dbi->types->getAttributes(),
'privs_available' => $GLOBALS['col_priv'] && $GLOBALS['is_reload_priv'],
'max_length' => $this->dbi->getVersion() >= 50503 ? 1024 : 255,
'dbi' => $this->dbi,
'disable_is' => $GLOBALS['cfg']['Server']['DisableIS'],
]);
}
/**
* build the html for step 1.1 of normalization
*
* @param string $db current database
* @param string $table current table
* @param string $normalizedTo up to which step normalization will go,
* possible values 1nf|2nf|3nf
*
* @return string HTML for step 1.1
*/
public function getHtmlFor1NFStep1($db, $table, $normalizedTo)
{
$step = 1;
$stepTxt = __('Make all columns atomic');
$html = "<h3 class='center'>"
. __('First step of normalization (1NF)') . "</h3>";
$html .= "<div id='mainContent' data-normalizeto='" . $normalizedTo . "'>" .
"<fieldset>" .
"<legend>" . __('Step 1.') . $step . " " . $stepTxt . "</legend>" .
"<h4>" . __(
'Do you have any column which can be split into more than'
. ' one column? '
. 'For example: address can be split into street, city, country and zip.'
)
. "</br>(<a class='central_columns_dialog' data-maxrows='25' "
. "data-pick=false href='#'> "
. __(
'Show me the central list of columns that are not already in this table'
) . " </a>)</h4>"
. "<p class='cm-em'>" . __(
'Select a column which can be split into more '
. 'than one (on select of \'no such column\', it\'ll move to next step).'
)
. "</p>"
. "<div id='extra'>"
. "<select id='selectNonAtomicCol' name='makeAtomic'>"
. '<option selected="selected" disabled="disabled">'
. __('Select one…') . "</option>"
. "<option value='no_such_col'>" . __('No such column') . "</option>"
. $this->getHtmlForColumnsList(
$db,
$table,
_pgettext('string types', 'String')
)
. "</select>"
. "<span>" . __('split into ')
. "</span><input id='numField' type='number' value='2'>"
. "<input type='submit' id='splitGo' value='" . __('Go') . "'/></div>"
. "<div id='newCols'></div>"
. "</fieldset><fieldset class='tblFooters'>"
. "</fieldset>"
. "</div>";
return $html;
}
/**
* build the html contents of various html elements in step 1.2
*
* @param string $db current database
* @param string $table current table
*
* @return string HTML contents for step 1.2
*/
public function getHtmlContentsFor1NFStep2($db, $table)
{
$step = 2;
$stepTxt = __('Have a primary key');
$primary = Index::getPrimary($table, $db);
$hasPrimaryKey = "0";
$legendText = __('Step 1.') . $step . " " . $stepTxt;
$extra = '';
if ($primary) {
$headText = __("Primary key already exists.");
$subText = __("Taking you to next step…");
$hasPrimaryKey = "1";
} else {
$headText = __(
"There is no primary key; please add one.<br/>"
. "Hint: A primary key is a column "
. "(or combination of columns) that uniquely identify all rows."
);
$subText = '<a href="#" id="createPrimaryKey">'
. Util::getIcon(
'b_index_add',
__(
'Add a primary key on existing column(s)'
)
)
. '</a>';
$extra = __(
"If it's not possible to make existing "
. "column combinations as primary key"
) . "<br/>"
. '<a href="#" id="addNewPrimary">'
. __('+ Add a new primary key column') . '</a>';
}
$res = [
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'hasPrimaryKey' => $hasPrimaryKey,
'extra' => $extra
];
return $res;
}
/**
* build the html contents of various html elements in step 1.4
*
* @param string $db current database
* @param string $table current table
*
* @return string HTML contents for step 1.4
*/
public function getHtmlContentsFor1NFStep4($db, $table)
{
$step = 4;
$stepTxt = __('Remove redundant columns');
$legendText = __('Step 1.') . $step . " " . $stepTxt;
$headText = __(
"Do you have a group of columns which on combining gives an existing"
. " column? For example, if you have first_name, last_name and"
. " full_name then combining first_name and last_name gives full_name"
. " which is redundant."
);
$subText = __(
"Check the columns which are redundant and click on remove. "
. "If no redundant column, click on 'No redundant column'"
);
$extra = $this->getHtmlForColumnsList($db, $table, 'all', "checkbox") . "</br>"
. '<input type="submit" id="removeRedundant" value="'
. __('Remove selected') . '"/>'
. '<input type="submit" value="' . __('No redundant column')
. '" onclick="goToFinish1NF();"'
. '/>';
$res = [
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'extra' => $extra
];
return $res;
}
/**
* build the html contents of various html elements in step 1.3
*
* @param string $db current database
* @param string $table current table
*
* @return string HTML contents for step 1.3
*/
public function getHtmlContentsFor1NFStep3($db, $table)
{
$step = 3;
$stepTxt = __('Move repeating groups');
$legendText = __('Step 1.') . $step . " " . $stepTxt;
$headText = __(
"Do you have a group of two or more columns that are closely "
. "related and are all repeating the same attribute? For example, "
. "a table that holds data on books might have columns such as book_id, "
. "author1, author2, author3 and so on which form a "
. "repeating group. In this case a new table (book_id, author) should "
. "be created."
);
$subText = __(
"Check the columns which form a repeating group. "
. "If no such group, click on 'No repeating group'"
);
$extra = $this->getHtmlForColumnsList($db, $table, 'all', "checkbox") . "</br>"
. '<input type="submit" id="moveRepeatingGroup" value="'
. __('Done') . '"/>'
. '<input type="submit" value="' . __('No repeating group')
. '" onclick="goToStep4();"'
. '/>';
$primary = Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = [];
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$res = [
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'extra' => $extra,
'primary_key' => json_encode($pk)
];
return $res;
}
/**
* build html contents for 2NF step 2.1
*
* @param string $db current database
* @param string $table current table
*
* @return string HTML contents for 2NF step 2.1
*/
public function getHtmlFor2NFstep1($db, $table)
{
$legendText = __('Step 2.') . "1 " . __('Find partial dependencies');
$primary = Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = [];
$subText = '';
$selectPkForm = "";
$extra = "";
foreach ($primarycols as $col) {
$pk[] = $col->getName();
$selectPkForm .= '<input type="checkbox" name="pd" value="'
. htmlspecialchars($col->getName()) . '">'
. htmlspecialchars($col->getName());
}
$key = implode(', ', $pk);
if (count($primarycols) > 1) {
$this->dbi->selectDb($db);
$columns = (array) $this->dbi->getColumnNames(
$db,
$table
);
if (count($pk) == count($columns)) {
$headText = sprintf(
__(
'No partial dependencies possible as '
. 'no non-primary column exists since primary key ( %1$s ) '
. 'is composed of all the columns in the table.'
),
htmlspecialchars($key)
) . '<br/>';
$extra = '<h3>' . __('Table is already in second normal form.')
. '</h3>';
} else {
$headText = sprintf(
__(
'The primary key ( %1$s ) consists of more than one column '
. 'so we need to find the partial dependencies.'
),
htmlspecialchars($key)
) . '<br/>' . __(
'Please answer the following question(s) '
. 'carefully to obtain a correct normalization.'
)
. '<br/><a href="#" id="showPossiblePd">' . __(
'+ Show me the possible partial dependencies '
. 'based on data in the table'
) . '</a>';
$subText = __(
'For each column below, '
. 'please select the <b>minimal set</b> of columns among given set '
. 'whose values combined together are sufficient'
. ' to determine the value of the column.'
);
$cnt = 0;
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
$cnt++;
$extra .= "<b>" . sprintf(
__('\'%1$s\' depends on:'),
htmlspecialchars($column)
) . "</b><br>";
$extra .= '<form id="pk_' . $cnt . '" data-colname="'
. htmlspecialchars($column) . '" class="smallIndent">'
. $selectPkForm . '</form><br/><br/>';
}
}
}
} else {
$headText = sprintf(
__(
'No partial dependencies possible as the primary key'
. ' ( %1$s ) has just one column.'
),
htmlspecialchars($key)
) . '<br/>';
$extra = '<h3>' . __('Table is already in second normal form.') . '</h3>';
}
$res = [
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'extra' => $extra,
'primary_key' => $key
];
return $res;
}
/**
* build the html for showing the tables to have in order to put current table in 2NF
*
* @param array $partialDependencies array containing all the dependencies
* @param string $table current table
*
* @return string HTML
*/
public function getHtmlForNewTables2NF(array $partialDependencies, $table)
{
$html = '<p><b>' . sprintf(
__(
'In order to put the '
. 'original table \'%1$s\' into Second normal form we need '
. 'to create the following tables:'
),
htmlspecialchars($table)
) . '</b></p>';
$tableName = $table;
$i = 1;
foreach ($partialDependencies as $key => $dependents) {
$html .= '<p><input type="text" name="' . htmlspecialchars($key)
. '" value="' . htmlspecialchars($tableName) . '"/>'
. '( <u>' . htmlspecialchars($key) . '</u>'
. (count($dependents)>0?', ':'')
. htmlspecialchars(implode(', ', $dependents)) . ' )';
$i++;
$tableName = 'table' . $i;
}
return $html;
}
/**
* create/alter the tables needed for 2NF
*
* @param array $partialDependencies array containing all the partial dependencies
* @param object $tablesName name of new tables
* @param string $table current table
* @param string $db current database
*
* @return array
*/
public function createNewTablesFor2NF(array $partialDependencies, $tablesName, $table, $db)
{
$dropCols = false;
$nonPKCols = [];
$queries = [];
$error = false;
$headText = '<h3>' . sprintf(
__('The second step of normalization is complete for table \'%1$s\'.'),
htmlspecialchars($table)
) . '</h3>';
if (count((array)$partialDependencies) == 1) {
return [
'legendText'=>__('End of step'), 'headText'=>$headText,
'queryError'=>$error
];
}
$message = '';
$this->dbi->selectDb($db);
foreach ($partialDependencies as $key => $dependents) {
if ($tablesName->$key != $table) {
$backquotedKey = implode(', ', Util::backquote(explode(', ', $key)));
$queries[] = 'CREATE TABLE ' . Util::backquote($tablesName->$key)
. ' SELECT DISTINCT ' . $backquotedKey
. (count($dependents)>0?', ':'')
. implode(',', Util::backquote($dependents))
. ' FROM ' . Util::backquote($table) . ';';
$queries[] = 'ALTER TABLE ' . Util::backquote($tablesName->$key)
. ' ADD PRIMARY KEY(' . $backquotedKey . ');';
$nonPKCols = array_merge($nonPKCols, $dependents);
} else {
$dropCols = true;
}
}
if ($dropCols) {
$query = 'ALTER TABLE ' . Util::backquote($table);
foreach ($nonPKCols as $col) {
$query .= ' DROP ' . Util::backquote($col) . ',';
}
$query = trim($query, ', ');
$query .= ';';
$queries[] = $query;
} else {
$queries[] = 'DROP TABLE ' . Util::backquote($table);
}
foreach ($queries as $query) {
if (!$this->dbi->tryQuery($query)) {
$message = Message::error(__('Error in processing!'));
$message->addMessage(
Message::rawError(
$this->dbi->getError()
),
'<br /><br />'
);
$error = true;
break;
}
}
return [
'legendText' => __('End of step'),
'headText' => $headText,
'queryError' => $error,
'extra' => $message
];
}
/**
* build the html for showing the new tables to have in order
* to put given tables in 3NF
*
* @param object $dependencies containing all the dependencies
* @param array $tables tables formed after 2NF and need to convert to 3NF
* @param string $db current database
*
* @return array containing html and the list of new tables
*/
public function getHtmlForNewTables3NF($dependencies, array $tables, $db)
{
$html = "";
$i = 1;
$newTables = [];
foreach ($tables as $table => $arrDependson) {
if (count(array_unique($arrDependson)) == 1) {
continue;
}
$primary = Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = [];
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$html .= '<p><b>' . sprintf(
__(
'In order to put the '
. 'original table \'%1$s\' into Third normal form we need '
. 'to create the following tables:'
),
htmlspecialchars($table)
) . '</b></p>';
$tableName = $table;
$columnList = [];
foreach ($arrDependson as $key) {
$dependents = $dependencies->$key;
if ($key == $table) {
$key = implode(', ', $pk);
}
$tmpTableCols =array_merge(explode(', ', $key), $dependents);
sort($tmpTableCols);
if (!in_array($tmpTableCols, $columnList)) {
$columnList[] = $tmpTableCols;
$html .= '<p><input type="text" name="'
. htmlspecialchars($tableName)
. '" value="' . htmlspecialchars($tableName) . '"/>'
. '( <u>' . htmlspecialchars($key) . '</u>'
. (count($dependents)>0?', ':'')
. htmlspecialchars(implode(', ', $dependents)) . ' )';
$newTables[$table][$tableName] = [
"pk"=>$key, "nonpk"=>implode(', ', $dependents)
];
$i++;
$tableName = 'table' . $i;
}
}
}
return ['html' => $html, 'newTables' => $newTables, 'success' => true];
}
/**
* create new tables or alter existing to get 3NF
*
* @param array $newTables list of new tables to be created
* @param string $db current database
*
* @return array
*/
public function createNewTablesFor3NF(array $newTables, $db)
{
$queries = [];
$dropCols = false;
$error = false;
$headText = '<h3>' .
__('The third step of normalization is complete.')
. '</h3>';
if (count((array)$newTables) == 0) {
return [
'legendText'=>__('End of step'), 'headText'=>$headText,
'queryError'=>$error
];
}
$message = '';
$this->dbi->selectDb($db);
foreach ($newTables as $originalTable => $tablesList) {
foreach ($tablesList as $table => $cols) {
if ($table != $originalTable) {
$quotedPk = implode(
', ',
Util::backquote(explode(', ', $cols->pk))
);
$quotedNonpk = implode(
', ',
Util::backquote(explode(', ', $cols->nonpk))
);
$queries[] = 'CREATE TABLE ' . Util::backquote($table)
. ' SELECT DISTINCT ' . $quotedPk
. ', ' . $quotedNonpk
. ' FROM ' . Util::backquote($originalTable) . ';';
$queries[] = 'ALTER TABLE ' . Util::backquote($table)
. ' ADD PRIMARY KEY(' . $quotedPk . ');';
} else {
$dropCols = $cols;
}
}
if ($dropCols) {
$columns = (array) $this->dbi->getColumnNames(
$db,
$originalTable
);
$colPresent = array_merge(
explode(', ', $dropCols->pk),
explode(', ', $dropCols->nonpk)
);
$query = 'ALTER TABLE ' . Util::backquote($originalTable);
foreach ($columns as $col) {
if (!in_array($col, $colPresent)) {
$query .= ' DROP ' . Util::backquote($col) . ',';
}
}
$query = trim($query, ', ');
$query .= ';';
$queries[] = $query;
} else {
$queries[] = 'DROP TABLE ' . Util::backquote($originalTable);
}
$dropCols = false;
}
foreach ($queries as $query) {
if (!$this->dbi->tryQuery($query)) {
$message = Message::error(__('Error in processing!'));
$message->addMessage(
Message::rawError(
$this->dbi->getError()
),
'<br /><br />'
);
$error = true;
break;
}
}
return [
'legendText' => __('End of step'),
'headText' => $headText,
'queryError' => $error,
'extra' => $message
];
}
/**
* move the repeating group of columns to a new table
*
* @param string $repeatingColumns comma separated list of repeating group columns
* @param string $primaryColumns comma separated list of column in primary key
* of $table
* @param string $newTable name of the new table to be created
* @param string $newColumn name of the new column in the new table
* @param string $table current table
* @param string $db current database
*
* @return array
*/
public function moveRepeatingGroup(
$repeatingColumns,
$primaryColumns,
$newTable,
$newColumn,
$table,
$db
) {
$repeatingColumnsArr = (array)Util::backquote(
explode(', ', $repeatingColumns)
);
$primaryColumns = implode(
',',
Util::backquote(explode(',', $primaryColumns))
);
$query1 = 'CREATE TABLE ' . Util::backquote($newTable);
$query2 = 'ALTER TABLE ' . Util::backquote($table);
$message = Message::success(
sprintf(
__('Selected repeating group has been moved to the table \'%s\''),
htmlspecialchars($table)
)
);
$first = true;
$error = false;
foreach ($repeatingColumnsArr as $repeatingColumn) {
if (!$first) {
$query1 .= ' UNION ';
}
$first = false;
$query1 .= ' SELECT ' . $primaryColumns . ',' . $repeatingColumn
. ' as ' . Util::backquote($newColumn)
. ' FROM ' . Util::backquote($table);
$query2 .= ' DROP ' . $repeatingColumn . ',';
}
$query2 = trim($query2, ',');
$queries = [$query1, $query2];
$this->dbi->selectDb($db);
foreach ($queries as $query) {
if (!$this->dbi->tryQuery($query)) {
$message = Message::error(__('Error in processing!'));
$message->addMessage(
Message::rawError(
$this->dbi->getError()
),
'<br /><br />'
);
$error = true;
break;
}
}
return [
'queryError' => $error, 'message' => $message
];
}
/**
* build html for 3NF step 1 to find the transitive dependencies
*
* @param string $db current database
* @param array $tables tables formed after 2NF and need to process for 3NF
*
* @return string
*/
public function getHtmlFor3NFstep1($db, array $tables)
{
$legendText = __('Step 3.') . "1 " . __('Find transitive dependencies');
$extra = "";
$headText = __(
'Please answer the following question(s) '
. 'carefully to obtain a correct normalization.'
);
$subText = __(
'For each column below, '
. 'please select the <b>minimal set</b> of columns among given set '
. 'whose values combined together are sufficient'
. ' to determine the value of the column.<br />'
. 'Note: A column may have no transitive dependency, '
. 'in that case you don\'t have to select any.'
);
$cnt = 0;
foreach ($tables as $table) {
$primary = Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$selectTdForm = "";
$pk = [];
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$this->dbi->selectDb($db);
$columns = (array) $this->dbi->getColumnNames(
$db,
$table
);
if (count($columns) - count($pk) <= 1) {
continue;
}
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
$selectTdForm .= '<input type="checkbox" name="pd" value="'
. htmlspecialchars($column) . '">'
. '<span>' . htmlspecialchars($column) . '</span>';
}
}
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
$cnt++;
$extra .= "<b>" . sprintf(
__('\'%1$s\' depends on:'),
htmlspecialchars($column)
)
. "</b><br>";
$extra .= '<form id="td_' . $cnt . '" data-colname="'
. htmlspecialchars($column) . '" data-tablename="'
. htmlspecialchars($table) . '" class="smallIndent">'
. $selectTdForm
. '</form><br/><br/>';
}
}
}
if ($extra == "") {
$headText = __(
"No Transitive dependencies possible as the table "
. "doesn't have any non primary key columns"
);
$subText = "";
$extra = "<h3>" . __("Table is already in Third normal form!") . "</h3>";
}
$res = [
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'extra' => $extra
];
return $res;
}
/**
* get html for options to normalize table
*
* @return string HTML
*/
public function getHtmlForNormalizeTable()
{
$htmlOutput = '<form method="post" action="normalization.php" '
. 'name="normalize" '
. 'id="normalizeTable" '
. '>'
. Url::getHiddenInputs($GLOBALS['db'], $GLOBALS['table'])
. '<input type="hidden" name="step1" value="1">';
$htmlOutput .= '<fieldset>';
$htmlOutput .= '<legend>'
. __('Improve table structure (Normalization):') . '</legend>';
$htmlOutput .= '<h3>' . __('Select up to what step you want to normalize')
. '</h3>';
$choices = [
'1nf' => __('First step of normalization (1NF)'),
'2nf' => __('Second step of normalization (1NF+2NF)'),
'3nf' => __('Third step of normalization (1NF+2NF+3NF)')];
$htmlOutput .= Util::getRadioFields(
'normalizeTo',
$choices,
'1nf',
true
);
$htmlOutput .= '</fieldset><fieldset class="tblFooters">'
. "<span class='floatleft'>" . __(
'Hint: Please follow the procedure carefully in order '
. 'to obtain correct normalization'
) . "</span>"
. '<input type="submit" name="submit_normalize" value="' . __('Go') . '" />'
. '</fieldset>'
. '</form>'
. '</div>';
return $htmlOutput;
}
/**
* find all the possible partial dependencies based on data in the table.
*
* @param string $table current table
* @param string $db current database
*
* @return string HTML containing the list of all the possible partial dependencies
*/
public function findPartialDependencies($table, $db)
{
$dependencyList = [];
$this->dbi->selectDb($db);
$columns = (array) $this->dbi->getColumnNames(
$db,
$table
);
$columns = (array)Util::backquote($columns);
$totalRowsRes = $this->dbi->fetchResult(
'SELECT COUNT(*) FROM (SELECT * FROM '
. Util::backquote($table) . ' LIMIT 500) as dt;'
);
$totalRows = $totalRowsRes[0];
$primary = Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = [];
foreach ($primarycols as $col) {
$pk[] = Util::backquote($col->getName());
}
$partialKeys = $this->getAllCombinationPartialKeys($pk);
$distinctValCount = $this->findDistinctValuesCount(
array_unique(
array_merge($columns, $partialKeys)
),
$table
);
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
foreach ($partialKeys as $partialKey) {
if ($partialKey
&& $this->checkPartialDependency(
$partialKey,
$column,
$table,
$distinctValCount[$partialKey],
$distinctValCount[$column],
$totalRows
)
) {
$dependencyList[$partialKey][] = $column;
}
}
}
}
$html = __(
'This list is based on a subset of the table\'s data '
. 'and is not necessarily accurate. '
)
. '<div class="dependencies_box">';
foreach ($dependencyList as $dependon => $colList) {
$html .= '<span class="displayblock">'
. '<input type="button" class="pickPd" value="' . __('Pick') . '"/>'
. '<span class="determinants">'
. htmlspecialchars(str_replace('`', '', $dependon)) . '</span> -> '
. '<span class="dependents">'
. htmlspecialchars(str_replace('`', '', implode(', ', $colList)))
. '</span>'
. '</span>';
}
if (empty($dependencyList)) {
$html .= '<p class="displayblock desc">'
. __('No partial dependencies found!') . '</p>';
}
$html .= '</div>';
return $html;
}
/**
* check whether a particular column is dependent on given subset of primary key
*
* @param string $partialKey the partial key, subset of primary key,
* each column in key supposed to be backquoted
* @param string $column backquoted column on whose dependency being checked
* @param string $table current table
* @param integer $pkCnt distinct value count for given partial key
* @param integer $colCnt distinct value count for given column
* @param integer $totalRows total distinct rows count of the table
*
* @return boolean TRUE if $column is dependent on $partialKey, False otherwise
*/
private function checkPartialDependency(
$partialKey,
$column,
$table,
$pkCnt,
$colCnt,
$totalRows
) {
$query = 'SELECT '
. 'COUNT(DISTINCT ' . $partialKey . ',' . $column . ') as pkColCnt '
. 'FROM (SELECT * FROM ' . Util::backquote($table)
. ' LIMIT 500) as dt' . ';';
$res = $this->dbi->fetchResult($query, null, null);
$pkColCnt = $res[0];
if ($pkCnt && $pkCnt == $colCnt && $colCnt == $pkColCnt) {
return true;
}
if ($totalRows && $totalRows == $pkCnt) {
return true;
}
return false;
}
/**
* function to get distinct values count of all the column in the array $columns
*
* @param array $columns array of backquoted columns whose distinct values
* need to be counted.
* @param string $table table to which these columns belong
*
* @return array associative array containing the count
*/
private function findDistinctValuesCount(array $columns, $table)
{
$result = [];
$query = 'SELECT ';
foreach ($columns as $column) {
if ($column) { //each column is already backquoted
$query .= 'COUNT(DISTINCT ' . $column . ') as \''
. $column . '_cnt\', ';
}
}
$query = trim($query, ', ');
$query .= ' FROM (SELECT * FROM ' . Util::backquote($table)
. ' LIMIT 500) as dt' . ';';
$res = $this->dbi->fetchResult($query, null, null);
foreach ($columns as $column) {
if ($column) {
$result[$column] = isset($res[0][$column . '_cnt']) ? $res[0][$column . '_cnt'] : null;
}
}
return $result;
}
/**
* find all the possible partial keys
*
* @param array $primaryKey array containing all the column present in primary key
*
* @return array containing all the possible partial keys(subset of primary key)
*/
private function getAllCombinationPartialKeys(array $primaryKey)
{
$results = [''];
foreach ($primaryKey as $element) {
foreach ($results as $combination) {
array_push(
$results,
trim($element . ',' . $combination, ',')
);
}
}
array_pop($results); //remove key which consist of all primary key columns
return $results;
}
}