function DatabaseSchema_pgsql::ensureIdentifiersLength
Make sure to limit identifiers according to PostgreSQL compiled in length.
PostgreSQL allows in standard configuration identifiers no longer than 63 chars for table/relation names, indexes, primary keys, and constraints. So we map all identifiers that are too long to drupal_base64hash_tag, where tag is one of:
- idx for indexes
- key for constraints
- pkey for primary keys
- seq for sequences
Parameters
string $table_identifier_part: The first argument used to build the identifier string. This usually refers to a table/relation name.
string $column_identifier_part: The second argument used to build the identifier string. This usually refers to one or more column names.
string $tag: The identifier tag. It can be one of 'idx', 'key', 'pkey' or 'seq'.
Return value
string The index/constraint/pkey identifier.
10 calls to DatabaseSchema_pgsql::ensureIdentifiersLength()
- DatabaseSchema_pgsql::addPrimaryKey in includes/
database/ pgsql/ schema.inc - Add a primary key.
- DatabaseSchema_pgsql::addUniqueKey in includes/
database/ pgsql/ schema.inc - Add a unique key.
- DatabaseSchema_pgsql::constraintExists in includes/
database/ pgsql/ schema.inc - Helper function: check if a constraint (PK, FK, UK) exists.
- DatabaseSchema_pgsql::createTableSql in includes/
database/ pgsql/ schema.inc - Generate SQL to create a new table from a Drupal schema definition.
- DatabaseSchema_pgsql::dropIndex in includes/
database/ pgsql/ schema.inc - Drop an index.
File
-
includes/
database/ pgsql/ schema.inc, line 67
Class
Code
protected function ensureIdentifiersLength($table_identifier_part, $column_identifier_part, $tag) {
$info = $this->getPrefixInfo($table_identifier_part);
$table_identifier_part = $info['table'];
// Filters out potentially empty $column_identifier_part to ensure
// compatibility with old naming convention (see prefixNonTable()).
$identifiers = array_filter(array(
$table_identifier_part,
$column_identifier_part,
$tag,
));
$identifierName = implode('_', $identifiers);
// Retrieve the max identifier length which is usually 63 characters
// but can be altered before PostgreSQL is compiled so we need to check.
if (empty($this->maxIdentifierLength)) {
$this->maxIdentifierLength = $this->connection
->query("SHOW max_identifier_length")
->fetchField();
}
if (strlen($identifierName) > $this->maxIdentifierLength) {
$saveIdentifier = 'drupal_' . $this->hashBase64($identifierName) . '_' . $tag;
}
else {
$saveIdentifier = $identifierName;
}
return $saveIdentifier;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.