Merge branch 'dnldnz-finalize-migrations-command-commas' into 'master'

Finalize background migrations: escape EVERY comma

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/169924



Merged-by: Jon Glassman <jglassman@gitlab.com>
Approved-by: Jon Glassman <jglassman@gitlab.com>
Co-authored-by: Daniel Diniz <8012210-dnldnz@users.noreply.gitlab.com>

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>&#92;</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