class Update10101
Same name in other branches
- 11.x core/modules/pgsql/src/Update10101.php \Drupal\pgsql\Update10101
An update class for sequence ownership.
@internal
Hierarchy
- class \Drupal\pgsql\Update10101 implements \Drupal\Core\DependencyInjection\ContainerInjectionInterface
Expanded class hierarchy of Update10101
See also
https://www.drupal.org/i/3028706
2 files declare their use of Update10101
- pgsql.install in core/
modules/ pgsql/ pgsql.install - Install, update and uninstall functions for the pgsql module.
- PostgreSqlSequenceUpdateTest.php in core/
modules/ pgsql/ tests/ src/ Functional/ Database/ PostgreSqlSequenceUpdateTest.php
File
-
core/
modules/ pgsql/ src/ Update10101.php, line 24
Namespace
Drupal\pgsqlView source
class Update10101 implements ContainerInjectionInterface {
/**
* Sequence owner update constructor.
*
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entityTypeManager
* The entity type manager.
* @param \Drupal\Core\Entity\EntityLastInstalledSchemaRepositoryInterface $entityLastInstalledSchemaRepository
* The last installed schema repository service.
* @param \Drupal\Core\Database\Connection $connection
* The database connection.
* @param \Drupal\Core\Extension\ModuleExtensionList $moduleExtensionList
* The module extension list.
* @param \Drupal\Core\Extension\ModuleHandlerInterface $moduleHandler
* The module handler service.
*/
public function __construct(EntityTypeManagerInterface $entityTypeManager, EntityLastInstalledSchemaRepositoryInterface $entityLastInstalledSchemaRepository, Connection $connection, ModuleExtensionList $moduleExtensionList, ModuleHandlerInterface $moduleHandler) {
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container) {
return new static($container->get('entity_type.manager'), $container->get('entity.last_installed_schema.repository'), $container->get('database'), $container->get('extension.list.module'), $container->get('module_handler'));
}
/**
* Update *all* existing sequences to include the owner tables.
*
* @param array $sandbox
* Stores information for batch updates.
*
* @return \Drupal\Core\StringTranslation\PluralTranslatableMarkup|null
* Returns the amount of orphaned sequences fixed.
*/
public function update(array &$sandbox) : ?PluralTranslatableMarkup {
if ($this->connection
->databaseType() !== 'pgsql') {
// This database update is a no-op for all other core database drivers.
$sandbox['#finished'] = 1;
return NULL;
}
if (!isset($sandbox['progress'])) {
$sandbox['fixed'] = 0;
$sandbox['progress'] = 0;
$sandbox['tables'] = [];
// Discovers all tables defined with hook_schema().
// @todo We need to add logic to do the same for on-demand tables. See
// https://www.drupal.org/i/3358777
$modules = $this->moduleExtensionList
->getList();
foreach ($modules as $extension) {
$module = $extension->getName();
$this->moduleHandler
->loadInclude($module, 'install');
$schema = $this->moduleHandler
->invoke($module, 'schema');
if (!empty($schema)) {
foreach ($schema as $table_name => $table_info) {
foreach ($table_info['fields'] as $column_name => $column_info) {
if (str_starts_with($column_info['type'], 'serial')) {
$sandbox['tables'][] = [
'table' => $table_name,
'column' => $column_name,
];
}
}
}
}
}
// Discovers all content entity types with integer entity keys that are
// most likely serial columns.
$entity_types = $this->entityTypeManager
->getDefinitions();
/** @var \Drupal\Core\Entity\EntityTypeInterface $entity_type */
foreach ($entity_types as $entity_type) {
$storage_class = $entity_type->getStorageClass();
if (is_subclass_of($storage_class, SqlContentEntityStorage::class)) {
$id_key = $entity_type->getKey('id');
$revision_key = $entity_type->getKey('revision');
$original_storage_definitions = $this->entityLastInstalledSchemaRepository
->getLastInstalledFieldStorageDefinitions($entity_type->id());
if ($original_storage_definitions[$id_key]->getType() === 'integer') {
$sandbox['tables'][] = [
'table' => $entity_type->getBaseTable(),
'column' => $id_key,
];
}
if ($entity_type->isRevisionable() && $original_storage_definitions[$revision_key]->getType() === 'integer') {
$sandbox['tables'][] = [
'table' => $entity_type->getRevisionTable(),
'column' => $revision_key,
];
}
}
}
$sandbox['max'] = count($sandbox['tables']);
}
else {
// Adds ownership of orphan sequences to tables.
$to_process = array_slice($sandbox['tables'], $sandbox['progress'], 50);
// Ensures that a sequence is not owned first, then ensures that the a
// sequence exists at all before trying to alter it.
foreach ($to_process as $table_info) {
if ($this->connection
->schema()
->tableExists($table_info['table'])) {
$owned = (bool) $this->getSequenceName($table_info['table'], $table_info['column']);
if (!$owned) {
$sequence_name = $this->connection
->makeSequenceName($table_info['table'], $table_info['column']);
$exists = $this->sequenceExists($sequence_name);
if ($exists) {
$transaction = $this->connection
->startTransaction($sequence_name);
try {
$this->updateSequenceOwnership($sequence_name, $table_info['table'], $table_info['column']);
$sandbox['fixed']++;
} catch (DatabaseExceptionWrapper $e) {
$transaction->rollBack();
}
}
}
}
$sandbox['progress']++;
}
}
if ($sandbox['max'] && $sandbox['progress'] < $sandbox['max']) {
$sandbox['#finished'] = $sandbox['progress'] / $sandbox['max'];
return NULL;
}
else {
$sandbox['#finished'] = 1;
return new PluralTranslatableMarkup($sandbox['fixed'], '1 orphaned sequence fixed.', '@count orphaned sequences fixed');
}
}
/**
* Alters the ownership of a sequence.
*
* This is used for updating orphaned sequences.
*
* @param string $sequence_name
* The appropriate sequence name for a given table and serial field.
* @param string $table
* The unquoted or prefixed table name.
* @param string $column
* The column name for the sequence.
*
* @see https://www.drupal.org/i/3028706
*/
private function updateSequenceOwnership(string $sequence_name, string $table, string $column) : void {
$this->connection
->query('ALTER SEQUENCE IF EXISTS ' . $sequence_name . ' OWNED BY {' . $table . '}.[' . $column . ']');
}
/**
* Retrieves a sequence name that is owned by the table and column.
*
* @param string $table
* A table name that is not prefixed or quoted.
* @param string $column
* The column name.
*
* @return string|null
* The name of the sequence or NULL if it does not exist.
*/
public function getSequenceName(string $table, string $column) : ?string {
return $this->connection
->query("SELECT pg_get_serial_sequence(:table, :column)", [
':table' => $this->connection
->getPrefix() . $table,
':column' => $column,
])
->fetchField();
}
/**
* Checks if a sequence exists.
*
* @param string $name
* The fully-qualified sequence name.
*
* @return bool
* TRUE if the sequence exists by the name.
*
* @see \Drupal\pgsql\Driver\Database\pgsql\Connection::makeSequenceName()
*/
private function sequenceExists(string $name) : bool {
return (bool) \Drupal::database()->query("SELECT c.relname FROM pg_class as c WHERE c.relkind = 'S' AND c.relname = :name", [
':name' => $name,
])
->fetchField();
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
Update10101::create | public static | function | Instantiates a new instance of this class. | Overrides ContainerInjectionInterface::create |
Update10101::getSequenceName | public | function | Retrieves a sequence name that is owned by the table and column. | |
Update10101::sequenceExists | private | function | Checks if a sequence exists. | |
Update10101::update | public | function | Update *all* existing sequences to include the owner tables. | |
Update10101::updateSequenceOwnership | private | function | Alters the ownership of a sequence. | |
Update10101::__construct | public | function | Sequence owner update constructor. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.