yiisoft / db-migration

The package implementing migration for yiisoft/db.
https://www.yiiframework.com/
BSD 3-Clause "New" or "Revised" License
29 stars 16 forks source link

Better constraints management in migrations #5

Open arogachev opened 9 years ago

arogachev commented 9 years ago

Currently we have to specify foreign key name with both adding and dropping.

$this->addForeignKey(
    'tests_questions_test_id_fkey',
    'tests_questions',
    'test_id',
    'tests',
    'id',
    'CASCADE',
    'CASCADE'
);
$this->dropForeignKey('tests_questions_test_id_fkey', 'tests_questions');

Some DBMS like MySQL generate it automatically, but the dropping part for me is more frustrating. You have to look through all previous migrations and find the name of corresponding foreign key. One solution will be following some convention and ask team members to follow it too, but it will be great if:

1) Foreign key names will be generated automatically so we can just write this:

$this->addForeignKey(
    'tests_questions',
    'test_id',
    'tests',
    'id',
    'CASCADE',
    'CASCADE'
);

2) And for the dropping part we can specify relations something like that:

$this->dropForeignKey('tests_questions', ['test_id' => 'tests.id']);

And foreign key will be found and dropped automatically.

That way developer only cares about relations and not names.

I think It can be applied to primary keys, indices, etc. too.

What do you think? Is it possible with DBMS?

Maybe use some naming convention if DBMS don't support auto generation? In this case we can build constraint name string depending on relations and add / drop it.

Funding

Fund with Polar

Vovan-VE commented 9 years ago

ColumnSchemaBuilder, which is new in 2.0.6, can also be changed to creare single column FK like following:

$this->createTable('child', [
    ...
    'parent_id' => $this->integer()->notNull()
                        ->foreignKey('parent', 'id', 'RESTRICT', 'CASCADE'),
    ...
]);
sergeymakinen commented 7 years ago

I’m working on PRs to solve this. Part 1 is about getting info about constraints (some info is already available in Yii, some is partially available and some is absent) across all supported DBs. Part 2 is about a high level interface (similar to Phinx - at the moment). I plan to maintain BC, so no pain is expected. :) No ETA yet.

sergeymakinen commented 7 years ago

Current status:

  1. Part 1:
    • SQL is ready
    • API is ready
    • Tests are 80% ready
    • Implemented on MySQL, tests pass
  2. Part 2:
    • Under construction. :)

I expect 1—2 weeks to finish part 1 and make a PR depending my job’s schedule.

sergeymakinen commented 7 years ago

Part 1 has arrived.

sergeymakinen commented 7 years ago

Status update on part 2:

  1. SQL is ready
  2. API is ready
  3. Tests are 70% ready, about 1700 new tests ATM 😄

I expect 1–3 weeks to polish tests. Stay tuned. ;)

sergeymakinen commented 7 years ago

Status update 2 on part 2:

  1. I was busy. :(
  2. Everything is okay.
  3. I aim for a PR in 2 weeks.