Documented try_catch (and sql: execute) in migrations

[mnocon]

Target: 5.0 (we need to wait until it's released)

Adding doc for https://github.com/ibexa/migrations/pull/430

In addition, because it was missing, I've added doc for the "sql: execute" step (this might be cherry-picked to 4.6 as well)

[github-actions]

Preview of modified files

Preview of modified Markdown:

• docs/content_management/data_migration/importing_data.md
• docs/release_notes/ibexa_dxp_v5.0.md

[mnocon]

Stolen from https://github.com/ibexa/migrations/blob/main/tests/bundle/Command/MigrateCommand/migrate-command-fixtures/sql-execute.yaml

[mnocon]

Tested locally:

09:15:17 NOTICE    [app] Executing migration: "l5"
09:15:17 INFO      [app] Processing step: 0
09:15:17 INFO      [app] Type "try_catch" | Mode: "execute" | Matching step: "Ibexa\Migration\ValueObject\Step\TryCatchStep"
09:15:17 INFO      [app] Processing step: 0
09:15:17 INFO      [app] Type "language" | Mode: "create" | Matching step: "Ibexa\Migration\ValueObject\Step\LanguageCreateStep"
✅ Migration l5 finished executing.

[Steveb-p]

In both cases migration is treated as if it succeeded.

Non-matching exceptions throw immediately just like before.

[mnocon]

Thanks! Added in af4288e

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

code_samples/ change report

Before (on target branch)	After (in current PR)
code_samples/data_migration/examples/sql_execute.yaml	code_samples/data_migration/examples/sql_execute.yaml
	docs/content_management/data_migration/importing_data.md@141:```yaml docs/content_management/data_migration/importing_data.md@142:[[= include_file('code_samples/data_migration/examples/sql_execute.yaml') =]] docs/content_management/data_migration/importing_data.md@143:``` 001⫶- 002⫶ type: sql 003⫶ mode: execute 004⫶ query: 005⫶ - 006⫶ driver: mysql 007⫶ sql: 'INSERT INTO test_table (test_value) VALUES ("foo");' 008⫶ - 009⫶ driver: sqlite 010⫶ sql: 'INSERT INTO test_table (test_value) VALUES ("foo");' 011⫶ - 012⫶ driver: postgresql 013⫶ sql: "INSERT INTO test_table (test_value) VALUES ('foo');"
code_samples/data_migration/examples/try_catch_step.yaml	code_samples/data_migration/examples/try_catch_step.yaml
	docs/content_management/data_migration/importing_data.md@176:```yaml docs/content_management/data_migration/importing_data.md@177:[[= include_file('code_samples/data_migration/examples/try_catch_step.yaml') =]] docs/content_management/data_migration/importing_data.md@178:``` 001⫶- 002⫶ type: try_catch 003⫶ mode: execute 004⫶ allowed_exceptions: 005⫶ - Throwable 006⫶ stop_after_first_exception: true 007⫶ steps: 008⫶ - 009⫶ type: language 010⫶ mode: create 011⫶ metadata: 012⫶ languageCode: ger-DE 013⫶ name: German 014⫶ enabled: true docs/release_notes/ibexa_dxp_v5.0.md@21:``` yaml docs/release_notes/ibexa_dxp_v5.0.md@22:[[= include_file('code_samples/data_migration/examples/try_catch_step.yaml') =]] docs/release_notes/ibexa_dxp_v5.0.md@23:``` 001⫶- 002⫶ type: try_catch 003⫶ mode: execute 004⫶ allowed_exceptions: 005⫶ - Throwable 006⫶ stop_after_first_exception: true 007⫶ steps: 008⫶ - 009⫶ type: language 010⫶ mode: create 011⫶ metadata: 012⫶ languageCode: ger-DE 013⫶ name: German 014⫶ enabled: true

Download colorized diff