SuperAPI AI 工具集

drupal-migrations

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

本技能围绕 Drupal 迁移(Migration)API,用于将外部或旧站数据导入 Drupal,覆盖 D7 到 D11 的升级、CSV 导入、JSON API 导入以及自定义 source、process、destination 插件。

用途:编写迁移定义与插件,把旧系统或外部数据源的数据转换并导入 Drupal 实体。

主要能力:迁移 YAML 结构包含 id、label、migration_group 分组、source、process、destination(如 entity:node 与 default_bundle)、migration_dependencies;process 插件覆盖 default_value、static_map、concat、migration_lookup、entity_lookup、entity_generate、skip_on_empty、skip_on_value、sub_process;支持通过 migration_lookup 引用已迁移实体、entity_lookup 按字段值引用已有实体、entity_generate 在不存在时创建实体,以及多值字段迭代与空值/特定值跳过。可编写自定义 source 插件(继承 SqlBase,实现 query、fields、getIds、prepareRow,使用 MigrateSource 属性)和自定义 process 插件(继承 ProcessPluginBase,实现 transform,使用 MigrateProcess 属性)。

使用方式:通过 Drush 执行迁移管理,常用命令包括 drush migrate:status 查看状态、drush migrate:import migration_id 运行、加 --update 更新已有记录、加 --limit=50 分批避免内存问题、drush migrate:rollback migration_id 回滚、drush migrate:reset-status migration_id 修复 busy 状态、drush migrate:messages migration_id 查看逐行错误。

适用场景:站点升级、批量内容导入、需要维护实体引用的数据迁移。

限制:资料未提供具体版本兼容范围、性能基准与完整安装步骤;使用前需自行确认环境与依赖。相关文档见 https://www.skills.sh/edutrul/drupal-ai/drupal-migrations。