diff --git a/doc/update/background_migrations.md b/doc/update/background_migrations.md index 27eaa53a5d11b12655c4991b7d059d8f362b10b9..8117d76d3fc11f6a3099fad2d028e1c6d0827381 100644 --- a/doc/update/background_migrations.md +++ b/doc/update/background_migrations.md @@ -315,10 +315,12 @@ use the information in the failure error logs or the database: When dealing with multiple arguments, such as `[["id"],["id_convert_to_bigint"]]`, escape the comma between each argument with a backslash <code>\</code> to prevent an invalid character error. - The command should be: + Every comma in the `job_arguments` parameter value must be escaped with a backslash. + + For example: ```shell - sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,events,id,'[["id"]\, ["id_convert_to_bigint"]]'] + sudo gitlab-rake gitlab:background_migrations:finalize[CopyColumnUsingBackgroundMigrationJob,ci_builds,id,'[["id"\, "stage_id"]\,["id_convert_to_bigint"\,"stage_id_convert_to_bigint"]]'] ``` ::EndTabs