Skip to content

migrate:import

10.4+

Perform one or more migration processes.

Perform all migrations or import specific migrations with various options for limiting, updating, and progress tracking.

Help topics:

Examples

  • migrate:import --all
  • migrate:import --all --no-progress
  • migrate:import --tag=user,main_content
  • migrate:import classification,article
  • migrate:import user --limit=2
  • migrate:import user --idlist=5
  • migrate:import node_revision --idlist=1:2,2:3,3:5
  • migrate:import user --limit=50 --feedback=20
  • migrate:import --all --delete

Arguments

  • [migrationIds]. Comma-separated list of migration IDs.

Options

  • --all. Process all migrations
  • --tag=TAG. A comma-separated list of migration tags to import
  • --limit=LIMIT. Limit on the number of items to process in each migration
  • --feedback=FEEDBACK. Frequency of progress messages, in items processed
  • --idlist=IDLIST. Comma-separated list of IDs to import. As an ID may have more than one column, concatenate the columns with the colon ':' separator
  • --update. In addition to processing unprocessed items from the source, update previously-imported items with the current data
  • --force. Force an operation to run, even if all dependencies are not satisfied
  • --execute-dependencies. Execute all dependent migrations first
  • --timestamp. Show progress ending timestamp in progress messages
  • --total. Show total processed item number in progress messages
  • --progress. Show progress bar [default: 1]
  • --no-progress. Negate the --progress option.
  • --delete. Delete destination records missed from the source. Not compatible with --limit and --idlist options, and high_water_property source configuration key.

Global Options

  • -v|vv|vvv, --verbose. Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  • -y, --yes. Auto-accept the default for all user prompts. Equivalent to --no-interaction.
  • -l, --uri=URI. A base URL for building links and selecting a multi-site. Defaults to https://default.
  • To see all global options, run drush core:global-options.

Aliases

  • mim
  • migrate-import

Legend

  • An argument or option with square brackets is optional.
  • Any default value is listed at end of arg/option description.
  • An ellipsis indicates that an argument accepts multiple values separated by a space.