如何在TYPO3扩展ext_tables.sql中添加存储型计算列？

我想给TYPO3里的Solr索引队列任务加个存储型计算列优化查询性能：原来执行... WHERE changed > indexed处理90万条记录要8秒，换成带索引的计算列后执行... WHERE indexed-changed < 0仅需不到10ms。

直接用MySQL语句添加计算列是可行的：

ALTER TABLE my_extension ADD COLUMN `indexed-changed` INT AS (indexed - changed) STORED; 

但把这段定义写到TYPO3扩展的ext_tables.sql里时，数据库分析器直接报错：

CREATE TABLE tx_solr_indexqueue_item (
    ...
    `changed` int(11) DEFAULT '0' NOT NULL,
    `indexed` int(11) DEFAULT '0' NOT NULL,
    `indexed-changed` int(11) AS (`indexed` - `changed`) STORED,
    ...
);

错误提示：

Database analysis failed
[SQL Error] line 0, col 564: Error: Expected NOT, NULL, DEFAULT, AUTO_INCREMENT, UNIQUE, PRIMARY, COMMENT, COLUMN_FORMAT, STORAGE or REFERENCES, got 'AS' in statement

TYPO3自带的数据库分析器不支持原生计算列的定义语法，没法直接在ext_tables.sql里写，下面两种方法符合TYPO3规范，能实现需求：

方法一：编写自定义数据库迁移脚本 #

通过TYPO3的迁移机制执行添加计算列的SQL，步骤如下：

1. 在你的扩展目录下创建Classes/Migrations/AddIndexedChangedCalculatedColumn.php文件，内容如下：

<?php
declare(strict_types=1);

namespace Vendor\YourExtension\Migrations;

use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class AddIndexedChangedCalculatedColumn implements \TYPO3\CMS\Core\Database\Schema\MigrationInterface
{
    public function execute()
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tx_solr_indexqueue_item');
        // 先检查列是否存在，避免重复执行报错
        $columns = $connection->getSchemaManager()->listTableColumns('tx_solr_indexqueue_item');
        if (!isset($columns['indexed-changed'])) {
            // 添加存储型计算列
            $connection->executeQuery(
                'ALTER TABLE tx_solr_indexqueue_item ADD COLUMN `indexed-changed` INT AS (`indexed` - `changed`) STORED;'
            );
            // 为计算列添加索引，这是性能提升的关键
            $connection->executeQuery(
                'CREATE INDEX idx_indexed_changed ON tx_solr_indexqueue_item (`indexed-changed`);'
            );
        }
        return true;
    }
}

2. 在扩展的ext_localconf.php中注册该迁移脚本：

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']['addIndexedChangedCalculatedColumn'] =
    \Vendor\YourExtension\Migrations\AddIndexedChangedCalculatedColumn::class;

3. 进入TYPO3安装工具，运行数据库分析并执行更新，迁移脚本会自动执行。

方法二：手动执行SQL语句（适合开发/测试环境） #

生产环境中也可以直接用数据库管理工具（如phpMyAdmin、MySQL Workbench）执行以下SQL：

-- 添加存储型计算列
ALTER TABLE tx_solr_indexqueue_item ADD COLUMN `indexed-changed` INT AS (`indexed` - `changed`) STORED;
-- 为计算列添加索引
CREATE INDEX idx_indexed_changed ON tx_solr_indexqueue_item (`indexed-changed`);

执行完成后，进入TYPO3安装工具的数据库分析页面，点击「标记所有为已同步」，避免后续分析再次报错。

• 确保使用的MySQL版本为5.7及以上，该版本才支持存储型计算列
• 必须为计算列添加索引，否则无法实现预期的性能提升
• 迁移脚本中加入列存在检查，可避免重复执行导致的报错

内容的提问来源于stack exchange，提问作者Nalmar