Add support for unlogged tables in PostgreSQL

[f-lombardo]

Q	A
Type	bug/feature/improvement
Feature	see #6044

Summary

Add support for creating unlogged PostgreSQL tables:
https://www.postgresql.org/docs/current/sql-createtable.html

I added a boolean unlogged option to default_table_options doctrine configuration
https://www.doctrine-project.org/projects/doctrine-bundle/en/latest/configuration.html
For example:

doctrine:
    dbal:
        default_table_options:
            unlogged: true

[derrabus]

Thank you. As always, we need functional tests that prove that your change actually works. Assertions on generated SQL are never sufficient.

In this case, the following scenarios must be covered:

• Create a table with that new option.
• Introspect logged and unlogged tables.
• Compare a logged with an unlogged table and vice versa.
• What happens if I use that option on a database that does not support it?

[derrabus]

Since this is a new feature and 3.6.x is closed for features, I'm targeting the 3.7.x branch now. Please rebase your PR onto that branch to make sure you don't run into merge conflicts.

[f-lombardo]

* What happens if I use that option on a database that does not support it?

I think nothing should happen, since the option shouldn't be used by any other db driver

[SenseException]

UNLOGGED was introduced in 9.1, if I believe what the docs say. At least this isn't breaking between versions supported by DBAL.

What's the use case that made you create the PR for adding this new feature?

[f-lombardo]

What's the use case that made you create the PR for adding this new feature?

I have many Behat tests that read/write data on PostgreSQL DBs and I'd like to run them faster. As I'm using test data, I'm not concerned about possible data corruption in case of crashes.

[derrabus]

Thank you!

[f-lombardo]

Thank you!

It was a pleasure!
Do you think we should also edit documentation about this new feature?

[derrabus]

Sure, go ahead!

[f-lombardo]

Sure, go ahead!

I'm looking at the docs folder and I'm a bit confused. What docs do yo think I should edit?

[derrabus]

I'm a bit confused

Why's that?

[f-lombardo]

I don't understand where to put this new information, since I haven't found any part of the documentation regarding the already existing table options for MySQL.

[derrabus]

There a chapter on schema representation. This is where this piece of information fits best, I'd say. But note that…

dbal/docs/en/reference/schema-representation.rst

Line 77 in 4e673be

This chapter is far from being completely documented.

[f-lombardo]

Hi @derrabus , do you already have a planned date for a release containing this feature?

Thanks.

[derrabus]

No. But I realize that there are already some features waiting to be released, so I don't want to wait too long either. That being said, you can use the feature already by using a 3.7.x-dev snapshot.

[f-lombardo]

Any news about release dates for this update?

[greg0ire]

Yes.