You are here

protected function CommentStorageSchema::getSharedTableFieldSchema in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/comment/src/CommentStorageSchema.php \Drupal\comment\CommentStorageSchema::getSharedTableFieldSchema()

Gets the schema for a single field definition.

Entity types may override this method in order to optimize the generated schema for given field. While all optimizations that apply to a single field have to be added here, all cross-field optimizations should be via SqlContentEntityStorageSchema::getEntitySchema() instead; e.g., an index spanning multiple fields.

Parameters

\Drupal\Core\Field\FieldStorageDefinitionInterface $storage_definition: The storage definition of the field whose schema has to be returned.

string $table_name: The name of the table columns will be added to.

string[] $column_mapping: A mapping of field column names to database column names.

Return value

array The schema definition for the table with the following keys:

  • fields: The schema definition for the each field columns.
  • indexes: The schema definition for the indexes.
  • unique keys: The schema definition for the unique keys.
  • foreign keys: The schema definition for the foreign keys.

Throws

\Drupal\Core\Field\FieldException Exception thrown if the schema contains reserved column names or if the initial values definition is invalid.

Overrides SqlContentEntityStorageSchema::getSharedTableFieldSchema

File

core/modules/comment/src/CommentStorageSchema.php, line 48

Class

CommentStorageSchema
Defines the comment schema handler.

Namespace

Drupal\comment

Code

protected function getSharedTableFieldSchema(FieldStorageDefinitionInterface $storage_definition, $table_name, array $column_mapping) {
  $schema = parent::getSharedTableFieldSchema($storage_definition, $table_name, $column_mapping);
  $field_name = $storage_definition
    ->getName();
  if ($table_name == 'comment_field_data') {

    // Remove unneeded indexes.
    unset($schema['indexes']['comment_field__pid__target_id']);
    unset($schema['indexes']['comment_field__entity_id__target_id']);
    switch ($field_name) {
      case 'thread':

        // Improves the performance of the comment__num_new index defined
        // in getEntitySchema().
        $schema['fields'][$field_name]['not null'] = TRUE;
        break;
      case 'entity_type':
      case 'field_name':
        assert($storage_definition instanceof RequiredFieldStorageDefinitionInterface);
        if ($storage_definition
          ->isStorageRequired()) {

          // The 'entity_type' and 'field_name' are required so they also need
          // to be marked as NOT NULL.
          $schema['fields'][$field_name]['not null'] = TRUE;
        }
        break;
      case 'created':
        $this
          ->addSharedTableFieldIndex($storage_definition, $schema, TRUE);
        break;
      case 'uid':
        $this
          ->addSharedTableFieldForeignKey($storage_definition, $schema, 'users', 'uid');
    }
  }
  return $schema;
}