{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 )
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/10/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because if this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb adds support.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
Ticket URL: <https://code.djangoproject.com/ticket/30913>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Old description:
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in version
11. This can be used to add non-key columns to the index.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:1>
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in
> version 11. This can be used to add non-key columns to the index.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in version
11. This can be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 )
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/10/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because if this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb adds support.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:2>
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in
> version 11. This can be used to add non-key columns to the index.
>
> {{{
> CREATE INDEX idx
> ON t1 ( col1 )
> INCLUDE ( col2 )
> }}}
>
> This allows for Index Only Scans on queries like:
>
> {{{
> SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
> }}}
>
> More info:
> https://www.postgresql.org/docs/current/sql-createindex.html
> https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
> indexes
> https://www.postgresql.org/docs/10/indexes-index-only-scans.html
>
> The idea is to add an additional kwarg to `Index` to support this:
>
> {{{
> Index(
> name='some-idx',
> fields=['headline'],
> include=['pub_date']
> }}}
>
> One of the biggest possibilities of this feature is to add included
> columns to unique indexes and use them to perform Index Only Scans. This
> would require adding the same kwarg to `UniqueConstraint`. The
> implementation would be a lot like the `condition` kwargs to both `Index`
> and `UniqueConstraint`.
>
> At the moment the only Django-supported database that can use this
> feature is Postgres but it's also supported by Microsoft SQL Server and
> IBM Db2 with the same syntax. Because if this I think it shouldn't be
> implemented as a postgres only feature but exposed on
> `BaseDatabaseSchemaEditor` to ease the adding of support when/if sqlite
> or mariadb adds support.
>
> I have a proof of concept I'm working on and will create a PR soon if
> accepted.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in version
11. This can be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 )
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/10/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
)
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because if this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb adds support.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:3>
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in
> version 11. This can be used to add non-key columns to the index.
>
> {{{
> CREATE INDEX idx
> ON t1 ( col1 )
> INCLUDE ( col2 )
> }}}
>
> This allows for Index Only Scans on queries like:
>
> {{{
> SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
> }}}
>
> More info:
> https://www.postgresql.org/docs/current/sql-createindex.html
> https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
> indexes
> https://www.postgresql.org/docs/10/indexes-index-only-scans.html
>
> The idea is to add an additional kwarg to `Index` to support this:
>
> {{{
> Index(
> name='some-idx',
> fields=['headline'],
> include=['pub_date']
> )
> }}}
>
> One of the biggest possibilities of this feature is to add included
> columns to unique indexes and use them to perform Index Only Scans. This
> would require adding the same kwarg to `UniqueConstraint`. The
> implementation would be a lot like the `condition` kwargs to both `Index`
> and `UniqueConstraint`.
>
> At the moment the only Django-supported database that can use this
> feature is Postgres but it's also supported by Microsoft SQL Server and
> IBM Db2 with the same syntax. Because if this I think it shouldn't be
> implemented as a postgres only feature but exposed on
> `BaseDatabaseSchemaEditor` to ease the adding of support when/if sqlite
> or mariadb adds support.
>
> I have a proof of concept I'm working on and will create a PR soon if
> accepted.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in version
11. This can be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 );
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/10/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
)
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because if this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb adds support.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:4>
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX` in
> version 11. This can be used to add non-key columns to the index.
>
> {{{
> CREATE INDEX idx
> ON t1 ( col1 )
> INCLUDE ( col2 );
> }}}
>
> This allows for Index Only Scans on queries like:
>
> {{{
> SELECT col1, col2 FROM t1 WHERE col1 = 'foo';
> }}}
>
> More info:
> https://www.postgresql.org/docs/current/sql-createindex.html
> https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
> indexes
> https://www.postgresql.org/docs/10/indexes-index-only-scans.html
>
> The idea is to add an additional kwarg to `Index` to support this:
>
> {{{
> Index(
> name='some-idx',
> fields=['headline'],
> include=['pub_date']
> )
> }}}
>
> One of the biggest possibilities of this feature is to add included
> columns to unique indexes and use them to perform Index Only Scans. This
> would require adding the same kwarg to `UniqueConstraint`. The
> implementation would be a lot like the `condition` kwargs to both `Index`
> and `UniqueConstraint`.
>
> At the moment the only Django-supported database that can use this
> feature is Postgres but it's also supported by Microsoft SQL Server and
> IBM Db2 with the same syntax. Because if this I think it shouldn't be
> implemented as a postgres only feature but exposed on
> `BaseDatabaseSchemaEditor` to ease the adding of support when/if sqlite
> or mariadb adds support.
>
> I have a proof of concept I'm working on and will create a PR soon if
> accepted.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX`. This can
be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 )
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/current/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because if this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb adds support.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:5>
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX`. This can
> be used to add non-key columns to the index.
>
> {{{
> CREATE INDEX idx
> ON t1 ( col1 )
> INCLUDE ( col2 )
> }}}
>
> This allows for Index Only Scans on queries like:
>
> {{{
> SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
> }}}
>
> More info:
> https://www.postgresql.org/docs/current/sql-createindex.html
> https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
> indexes
> https://www.postgresql.org/docs/current/indexes-index-only-scans.html
>
> The idea is to add an additional kwarg to `Index` to support this:
>
> {{{
> Index(
> name='some-idx',
> fields=['headline'],
> include=['pub_date']
> }}}
>
> One of the biggest possibilities of this feature is to add included
> columns to unique indexes and use them to perform Index Only Scans. This
> would require adding the same kwarg to `UniqueConstraint`. The
> implementation would be a lot like the `condition` kwargs to both `Index`
> and `UniqueConstraint`.
>
> At the moment the only Django-supported database that can use this
> feature is Postgres but it's also supported by Microsoft SQL Server and
> IBM Db2 with the same syntax. Because if this I think it shouldn't be
> implemented as a postgres only feature but exposed on
> `BaseDatabaseSchemaEditor` to ease the adding of support when/if sqlite
> or mariadb adds support.
>
> I have a proof of concept I'm working on and will create a PR soon if
> accepted.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX`. This can
be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 )
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/current/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because of this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb/mysql get it.
I have a proof of concept I'm working on and will create a PR soon if
accepted.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:6>
* keywords: db-indexes => postgresql covering index include
* component: Database layer (models, ORM) => Migrations
* stage: Unreviewed => Accepted
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:7>
* owner: nobody => Hannes Ljungberg
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:8>
* has_patch: 0 => 1
Old description:
> Postgres got support for the `INCLUDE` clause in `CREATE INDEX`. This can
> be used to add non-key columns to the index.
>
> {{{
> CREATE INDEX idx
> ON t1 ( col1 )
> INCLUDE ( col2 )
> }}}
>
> This allows for Index Only Scans on queries like:
>
> {{{
> SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
> }}}
>
> More info:
> https://www.postgresql.org/docs/current/sql-createindex.html
> https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
> indexes
> https://www.postgresql.org/docs/current/indexes-index-only-scans.html
>
> The idea is to add an additional kwarg to `Index` to support this:
>
> {{{
> Index(
> name='some-idx',
> fields=['headline'],
> include=['pub_date']
> }}}
>
> One of the biggest possibilities of this feature is to add included
> columns to unique indexes and use them to perform Index Only Scans. This
> would require adding the same kwarg to `UniqueConstraint`. The
> implementation would be a lot like the `condition` kwargs to both `Index`
> and `UniqueConstraint`.
>
> At the moment the only Django-supported database that can use this
> feature is Postgres but it's also supported by Microsoft SQL Server and
> IBM Db2 with the same syntax. Because of this I think it shouldn't be
> implemented as a postgres only feature but exposed on
> `BaseDatabaseSchemaEditor` to ease the adding of support when/if sqlite
> or mariadb/mysql get it.
>
> I have a proof of concept I'm working on and will create a PR soon if
> accepted.
New description:
Postgres got support for the `INCLUDE` clause in `CREATE INDEX`. This can
be used to add non-key columns to the index.
{{{
CREATE INDEX idx
ON t1 ( col1 )
INCLUDE ( col2 );
}}}
This allows for Index Only Scans on queries like:
{{{
SELECT col1, col2 FROM t1 WHERE t1 = 'foo';
}}}
More info:
https://www.postgresql.org/docs/current/sql-createindex.html
https://use-the-index-luke.com/blog/2019-04/include-columns-in-btree-
indexes
https://www.postgresql.org/docs/current/indexes-index-only-scans.html
The idea is to add an additional kwarg to `Index` to support this:
{{{
Index(
name='some-idx',
fields=['headline'],
include=['pub_date']
)
}}}
One of the biggest possibilities of this feature is to add included
columns to unique indexes and use them to perform Index Only Scans. This
would require adding the same kwarg to `UniqueConstraint`. The
implementation would be a lot like the `condition` kwargs to both `Index`
and `UniqueConstraint`.
At the moment the only Django-supported database that can use this feature
is Postgres but it's also supported by Microsoft SQL Server and IBM Db2
with the same syntax. Because of this I think it shouldn't be implemented
as a postgres only feature but exposed on `BaseDatabaseSchemaEditor` to
ease the adding of support when/if sqlite or mariadb/mysql get it.
--
Comment:
PR: https://github.com/django/django/pull/11991
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:9>
* needs_better_patch: 0 => 1
Comment:
See
[https://github.com/django/django/pull/11991/commits/053fc84d750227fb54a9837536a976f09a39157a#r414298432
comment].
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:10>
Comment (by Mariusz Felisiak <felisiak.mariusz@…>):
In [changeset:"104493311ef9361f03b957844b5a591f7f76d1b0" 10449331]:
{{{
#!CommitTicketReference repository=""
revision="104493311ef9361f03b957844b5a591f7f76d1b0"
Refs #30913 -- Added BaseDatabaseSchemaEditor._index_condition_sql().
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:11>
* needs_better_patch: 1 => 0
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:12>
* needs_better_patch: 0 => 1
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:13>
* needs_better_patch: 1 => 0
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:14>
* stage: Accepted => Ready for checkin
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:15>
* status: assigned => closed
* resolution: => fixed
Comment:
In [changeset:"8c7992f658e1125f8dc20b19206e8bbbe4187372" 8c7992f]:
{{{
#!CommitTicketReference repository=""
revision="8c7992f658e1125f8dc20b19206e8bbbe4187372"
Fixed #30913 -- Added support for covering indexes on PostgreSQL 11+.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:16>
Comment (by Mariusz Felisiak <felisiak.mariusz@…>):
In [changeset:"f83b44075dafa429d59e8755aa47e15577cc49f9" f83b4407]:
{{{
#!CommitTicketReference repository=""
revision="f83b44075dafa429d59e8755aa47e15577cc49f9"
Refs #30913 -- Added system checks for covering indexes and unique
constraints support.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/30913#comment:17>