getColumns();
$columnTypeList = $types[$colTypeCategory];
}
$GLOBALS['dbi']->selectDb($db, $GLOBALS['userlink']);
$columns = $GLOBALS['dbi']->getColumns(
$db, $table, null,
true, $GLOBALS['userlink']
);
$type = "";
$selectColHtml = "";
foreach ($columns as $column => $def) {
if (isset($def['Type'])) {
$extracted_columnspec = Util::extractColumnSpec($def['Type']);
$type = $extracted_columnspec['type'];
}
if (empty($columnTypeList)
|| in_array(mb_strtoupper($type), $columnTypeList)
) {
if ($listType == 'checkbox') {
$selectColHtml .= ''
. htmlspecialchars($column) . ' [ '
. htmlspecialchars($def['Type']) . ' ]';
} else {
$selectColHtml .= '';
}
}
}
return $selectColHtml;
}
/**
* get the html of the form to add the new column to given table
*
* @param integer $num_fields 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
*/
function PMA_getHtmlForCreateNewColumn(
$num_fields, $db, $table, $columnMeta=array()
) {
$cfgRelation = PMA_getRelationsParam();
$content_cells = array();
$available_mime = array();
$mime_map = array();
if ($cfgRelation['mimework'] && $GLOBALS['cfg']['BrowseMIME']) {
$mime_map = PMA_getMIME($db, $table);
$available_mime = PMA_getAvailableMIMEtypes();
}
$comments_map = PMA_getComments($db, $table);
for ($columnNumber = 0; $columnNumber < $num_fields; $columnNumber++) {
$content_cells[$columnNumber] = array(
'columnNumber' => $columnNumber,
'columnMeta' => $columnMeta,
'type_upper' => '',
'length_values_input_size' => 8,
'length' => '',
'extracted_columnspec' => array(),
'submit_attribute' => null,
'comments_map' => $comments_map,
'fields_meta' => null,
'is_backup' => true,
'move_columns' => array(),
'cfgRelation' => $cfgRelation,
'available_mime' => isset($available_mime)?$available_mime:array(),
'mime_map' => $mime_map
);
}
return PMA\libraries\Template::get(
'columns_definitions/table_fields_definitions'
)
->render(
array(
'is_backup' => true,
'fields_meta' => null,
'mimework' => $cfgRelation['mimework'],
'content_cells' => $content_cells
)
);
}
/**
* 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
*/
function PMA_getHtmlFor1NFStep1($db, $table, $normalizedTo)
{
$step = 1;
$stepTxt = __('Make all columns atomic');
$html = "
"
. __('First step of normalization (1NF)') . "
";
$html .= "
" .
""
. "
";
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
*/
function PMA_getHtmlContentsFor1NFStep2($db, $table)
{
$step = 2;
$stepTxt = __('Have a primary key');
$primary = PMA\libraries\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. "
. "Hint: A primary key is a column "
. "(or combination of columns) that uniquely identify all rows."
);
$subText = ''
. Util::getIcon(
'b_index_add.png', __(
'Add a primary key on existing column(s)'
)
)
. '';
$extra = __(
"If it's not possible to make existing "
. "column combinations as primary key"
) . " "
. ''
. __('+ Add a new primary key column') . '';
}
$res = array(
'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
*/
function PMA_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 = PMA_getHtmlForColumnsList($db, $table, 'all', "checkbox") . ""
. ''
. '';
$res = array(
'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
*/
function PMA_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 = PMA_getHtmlForColumnsList($db, $table, 'all', "checkbox") . ""
. ''
. '';
$primary = PMA\libraries\Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = array();
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$res = array(
'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
*/
function PMA_getHtmlFor2NFstep1($db, $table)
{
$legendText = __('Step 2.') . "1 " . __('Find partial dependencies');
$primary = PMA\libraries\Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = array();
$subText = '';
$selectPkForm = "";
$extra = "";
foreach ($primarycols as $col) {
$pk[] = $col->getName();
$selectPkForm .= ''
. htmlspecialchars($col->getName());
}
$key = implode(', ', $pk);
if (count($primarycols) > 1) {
$GLOBALS['dbi']->selectDb($db, $GLOBALS['userlink']);
$columns = (array) $GLOBALS['dbi']->getColumnNames(
$db, $table, $GLOBALS['userlink']
);
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)
) . ' ';
$extra = '
' . __('Table is already in second normal form.')
. '
';
} else {
$headText = sprintf(
__(
'The primary key ( %1$s ) consists of more than one column '
. 'so we need to find the partial dependencies.'
), htmlspecialchars($key)
) . ' ' . __(
'Please answer the following question(s) '
. 'carefully to obtain a correct normalization.'
)
. ' ' . __(
'+ Show me the possible partial dependencies '
. 'based on data in the table'
) . '';
$subText = __(
'For each column below, '
. 'please select the minimal set 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 .= "" . sprintf(
__('\'%1$s\' depends on:'), htmlspecialchars($column)
) . " ";
$extra .= '
';
}
}
}
} else {
$headText = sprintf(
__(
'No partial dependencies possible as the primary key'
. ' ( %1$s ) has just one column.'
), htmlspecialchars($key)
) . ' ';
$extra = '
' . __('Table is already in second normal form.') . '
';
}
$res = array(
'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
*/
function PMA_getHtmlForNewTables2NF($partialDependencies,$table)
{
$html = '
' . sprintf(
__(
'In order to put the '
. 'original table \'%1$s\' into Second normal form we need '
. 'to create the following tables:'
), htmlspecialchars($table)
) . '
');
$message->addMessage(
Message::rawError(
$GLOBALS['dbi']->getError($GLOBALS['userlink'])
)
);
$error = true;
break;
}
}
return array(
'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
*/
function PMA_getHtmlForNewTables3NF($dependencies, $tables, $db)
{
$html = "";
$i = 1;
$newTables = array();
foreach ($tables as $table=>$arrDependson) {
if (count(array_unique($arrDependson)) == 1) {
continue;
}
$primary = PMA\libraries\Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = array();
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$html .= '
' . sprintf(
__(
'In order to put the '
. 'original table \'%1$s\' into Third normal form we need '
. 'to create the following tables:'
), htmlspecialchars($table)
) . '
');
$message->addMessage(
Message::rawError(
$GLOBALS['dbi']->getError($GLOBALS['userlink'])
)
);
$error = true;
break;
}
}
return array(
'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 $primary_columns 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
*/
function PMA_moveRepeatingGroup(
$repeatingColumns, $primary_columns, $newTable, $newColumn, $table, $db
) {
$repeatingColumnsArr = (array)Util::backquote(
explode(', ', $repeatingColumns)
);
$primary_columns = implode(
',', Util::backquote(explode(',', $primary_columns))
);
$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 ' . $primary_columns . ',' . $repeatingColumn
. ' as ' . Util::backquote($newColumn)
. ' FROM ' . Util::backquote($table);
$query2 .= ' DROP ' . $repeatingColumn . ',';
}
$query2 = trim($query2, ',');
$queries = array($query1, $query2);
$GLOBALS['dbi']->selectDb($db, $GLOBALS['userlink']);
foreach ($queries as $query) {
if (!$GLOBALS['dbi']->tryQuery($query, $GLOBALS['userlink'])) {
$message = Message::error(__('Error in processing!'));
$message->addMessage('
');
$message->addMessage(
Message::rawError(
$GLOBALS['dbi']->getError($GLOBALS['userlink'])
)
);
$error = true;
break;
}
}
return array(
'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
*/
function PMA_getHtmlFor3NFstep1($db, $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 minimal set of columns among given set '
. 'whose values combined together are sufficient'
. ' to determine the value of the column. '
. '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 = PMA\libraries\Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$selectTdForm = "";
$pk = array();
foreach ($primarycols as $col) {
$pk[] = $col->getName();
}
$GLOBALS['dbi']->selectDb($db, $GLOBALS['userlink']);
$columns = (array) $GLOBALS['dbi']->getColumnNames(
$db, $table, $GLOBALS['userlink']
);
if (count($columns) - count($pk) <= 1) {
continue;
}
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
$selectTdForm .= ''
. '' . htmlspecialchars($column) . '';
}
}
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
$cnt++;
$extra .= "" . sprintf(
__('\'%1$s\' depends on:'), htmlspecialchars($column)
)
. " ";
$extra .= '
';
}
}
}
if ($extra == "") {
$headText = __(
"No Transitive dependencies possible as the table "
. "doesn't have any non primary key columns"
);
$subText = "";
$extra = "
" . __("Table is already in Third normal form!") . "
";
}
$res = array(
'legendText' => $legendText,
'headText' => $headText,
'subText' => $subText,
'extra' => $extra
);
return $res;
}
/**
* get html for options to normalize table
*
* @return string HTML
*/
function PMA_getHtmlForNormalizetable()
{
$html_output = ''
. '';
return $html_output;
}
/**
* 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
*/
function PMA_findPartialDependencies($table, $db)
{
$dependencyList = array();
$GLOBALS['dbi']->selectDb($db, $GLOBALS['userlink']);
$columns = (array) $GLOBALS['dbi']->getColumnNames(
$db, $table, $GLOBALS['userlink']
);
$columns = (array)Util::backquote($columns);
$totalRowsRes = $GLOBALS['dbi']->fetchResult(
'SELECT COUNT(*) FROM (SELECT * FROM '
. Util::backquote($table) . ' LIMIT 500) as dt;'
);
$totalRows = $totalRowsRes[0];
$primary = PMA\libraries\Index::getPrimary($table, $db);
$primarycols = $primary->getColumns();
$pk = array();
foreach ($primarycols as $col) {
$pk[] = Util::backquote($col->getName());
}
$partialKeys = PMA_getAllCombinationPartialKeys($pk);
$distinctValCount = PMA_findDistinctValuesCount(
array_unique(
array_merge($columns, $partialKeys)
), $table
);
foreach ($columns as $column) {
if (!in_array($column, $pk)) {
foreach ($partialKeys as $partialKey) {
if ($partialKey
&& PMA_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. '
)
. '