This project aims to give you a jump-start on building migrations.

Clone the project into modules/custom of your Drupal installation and run composer install within the modules directory.

drush upm-da {key} {database name} --username={name} --password={password}

up_migrate comes with some base classes usefull for building migrations.

Since the mapping tables create by Migrate do not have proper unique indexes, the ID map "fastsql" alters the definitions of the map tables and add proper indexes. This increases migration performance significant. up_migrate sets the ID map for all migrations if they do not specify the property idMap for themself.

up_migrate comes with a set of pre-defined source plugins.

The abstract class \Drupal\up_migrate\Plugin\migrate\source\SqlBase is meant to be the parent class for all custom migration sources. It allows configuring sources from directly within a migration yml file.

Example for definition in migrate_plus.migration.{id}.yml:

source:
  table:
    name: users
    alias: u
    ids:
      uid: integer

This sets the base table of the migration source to a table named "users". The table can be referenced by using the alias "u" and have one unique key named "uid".

Example for definition in custom source plugin (must extend SqlBase)

/**
 * @MigrateSource(
 *   id = "upm_examples__user",
 *   table = {
 *     "name": "users",
 *     "alias": "u",
 *     "ids": {
 *       "uid": "integer"
 *     }
 *   }
 * )
 */

For more complex ID definitions simply override the function getIds().

up_migrate provides a custom read-only stream wrapper to access files needed for migrations in a handy way.

To setup the correct directoy to your migration files, add the following code to your settings.php

// Set private folder.
$settings['file_migration_source_path'] = '/path/to/migration/files';