AddPrimaryKeyConstraint replaces setPrimaryKey but usage is unclear

[HectorOrdonez]

In #6867 doctrine deprecates setPrimaryKey, and says we should use addPrimaryKeyConstraint instead.

Usage of setPrimaryKey was:

$table->setPrimaryKey(['id']);

However, addPrimaryKeyConstraint requires a PrimaryKeyConstraint object, not an string[], like previously.

I could not find references to how are we supposed to use this new functionality and the upgrade docs do not mention it.

[morozov]

Tests are a good reference. For example,

dbal/tests/Schema/TableTest.php

Lines 1022 to 1030 in 615a601

	$table = new Table('t');
	$table->addColumn('id', Types::INTEGER);
	$table->addPrimaryKeyConstraint(
	PrimaryKeyConstraint::editor()
	->setColumnNames(
	UnqualifiedName::unquoted('id'),
	)
	->create(),
	);