“Django/docs/3.0.x/ref/contrib/postgres/indexes”的版本间差异
(autoload) |
小 (Page commit) |
||
第1行: | 第1行: | ||
+ | {{DISPLAYTITLE:PostgreSQL 特定模型索引 — Django 文档}} | ||
<div id="module-django.contrib.postgres.indexes" class="section"> | <div id="module-django.contrib.postgres.indexes" class="section"> | ||
<span id="postgresql-specific-model-indexes"></span> | <span id="postgresql-specific-model-indexes"></span> | ||
− | = PostgreSQL | + | = PostgreSQL 特定的模型索引 = |
− | + | 以下是 PostgreSQL 特定的 [[../../../models/indexes|索引]] ,可从 <code>django.contrib.postgres.indexes</code> 模块获得。 | |
− | |||
<div id="brinindex" class="section"> | <div id="brinindex" class="section"> | ||
− | == | + | == BrinIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">BrinIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">autosummarize</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="n"><span class="pre">pages_per_range</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
− | <dd><p> | + | <dd><p>创建 [https://www.postgresql.org/docs/current/brin-intro.html BRIN 索引] 。</p> |
− | <p> | + | <p>将<code>autosummarize</code>参数设置为<code>True</code>,使[https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION 自动汇总]由autovacuum执行。</p> |
− | + | <p><code>pages_per_range</code> 参数采用正整数。</p> | |
− | <p> | ||
<div class="versionchanged"> | <div class="versionchanged"> | ||
− | <p> | + | <p><span class="versionmodified changed"> 2.2 版更改: </span> 添加了 <code>autosummarize</code> 参数。</p> |
</div></dd></dl> | </div></dd></dl> | ||
第27行: | 第26行: | ||
<div id="btreeindex" class="section"> | <div id="btreeindex" class="section"> | ||
− | == | + | == BTreeIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">BTreeIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">fillfactor</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
<dd><div class="versionadded"> | <dd><div class="versionadded"> | ||
− | + | <p><span class="versionmodified added">2.2 版中的新功能。</span></p> | |
</div> | </div> | ||
− | <p> | + | <p>创建 B 树索引。</p> |
− | <p> | + | <p>为 [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p></dd></dl> |
− | |||
第44行: | 第42行: | ||
<div id="ginindex" class="section"> | <div id="ginindex" class="section"> | ||
− | == | + | == GinIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">GinIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">fastupdate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="n"><span class="pre">gin_pending_list_limit</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
− | <dd><p> | + | <dd><p>创建 [https://www.postgresql.org/docs/current/gin.html gin 索引] 。</p> |
− | <p> | + | <p>要在不在 [https://www.postgresql.org/docs/current/gin-builtin-opclasses.html 内置运算符类] 中的数据类型上使用此索引,您需要在 PostgreSQL 上激活 [https://www.postgresql.org/docs/current/btree-gin.html btree_gin 扩展] 。 您可以使用 [[../operations#django.contrib.postgres.operations|BtreeGinExtension]] 迁移操作安装它。</p> |
− | + | <p>将 <code>fastupdate</code> 参数设置为 <code>False</code> 以禁用在 PostgreSQL 中默认启用的 [https://www.postgresql.org/docs/current/gin-implementation.html#GIN-FAST-UPDATE GIN 快速更新技术] 。</p> | |
− | + | <p>为 [https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-GIN-PENDING-LIST-LIMIT gin_pending_list_limit] 参数提供整数字节以调整启用 <code>fastupdate</code> 时使用的 GIN 挂起列表的最大大小。</p></dd></dl> | |
− | [[../operations#django.contrib.postgres.operations| | ||
− | |||
− | <p> | ||
− | |||
− | <p> | ||
− | |||
− | <code>fastupdate</code> | ||
第64行: | 第55行: | ||
<div id="gistindex" class="section"> | <div id="gistindex" class="section"> | ||
− | == | + | == GistIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">GistIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">buffering</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="n"><span class="pre">fillfactor</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
− | <dd><p> | + | <dd><p>创建 [https://www.postgresql.org/docs/current/gist.html GiST 索引] 。 这些索引是在 [[../../gis/model-api#django.contrib.gis.db.models.BaseSpatialField|spatial_index=True]] 的空间字段上自动创建的。 它们也可用于其他类型,例如 [[../fields#django.contrib.postgres.fields|HStoreField]] 或 [[../fields#range-fields|范围字段]] 。</p> |
− | + | <p>要对不在内置 [https://www.postgresql.org/docs/current/gist-builtin-opclasses.html gist 运算符类] 中的数据类型使用此索引,您需要在 PostgreSQL 上激活 [https://www.postgresql.org/docs/current/btree-gist.html btree_gist 扩展] 。 您可以使用 [[../operations#django.contrib.postgres.operations|BtreeGistExtension]] 迁移操作安装它。</p> | |
− | + | <p>将 <code>buffering</code> 参数设置为 <code>True</code> 或 <code>False</code> 以手动启用或禁用索引的 [https://www.postgresql.org/docs/current/gist-implementation.html#GIST-BUFFERING-BUILD 缓冲构建] 。</p> | |
− | [[../fields#django.contrib.postgres.fields| | + | <p>为 [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p></dd></dl> |
− | |||
− | <p> | ||
− | |||
− | |||
− | [[../operations#django.contrib.postgres.operations| | ||
− | |||
− | <p> | ||
− | |||
− | <p> | ||
− | |||
第87行: | 第68行: | ||
<div id="hashindex" class="section"> | <div id="hashindex" class="section"> | ||
− | == | + | == HashIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">HashIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">fillfactor</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
<dd><div class="versionadded"> | <dd><div class="versionadded"> | ||
− | + | <p><span class="versionmodified added">2.2 版中的新功能。</span></p> | |
</div> | </div> | ||
− | <p> | + | <p>创建哈希索引。</p> |
− | <p> | + | <p>为 [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p> |
− | |||
<div class="admonition-use-this-index-only-on-postgresql-10-and-later admonition"> | <div class="admonition-use-this-index-only-on-postgresql-10-and-later admonition"> | ||
− | <p> | + | <p>仅在 PostgreSQL 10 及更高版本上使用此索引</p> |
− | <p> | + | <p>哈希索引在 PostgreSQL 中已经存在很长时间了,但它们在旧版本中存在许多数据完整性问题。</p> |
− | |||
</div></dd></dl> | </div></dd></dl> | ||
第111行: | 第90行: | ||
<div id="spgistindex" class="section"> | <div id="spgistindex" class="section"> | ||
− | == | + | == SpGistIndex == |
<dl> | <dl> | ||
− | <dt>''class'' < | + | <dt>''<span class="pre">class</span>'' <span class="sig-name descname"><span class="pre">SpGistIndex</span></span><span class="sig-paren">(</span>''<span class="n"><span class="pre">fillfactor</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span>'', ''<span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">options</span></span>''<span class="sig-paren">)</span></dt> |
<dd><div class="versionadded"> | <dd><div class="versionadded"> | ||
+ | <p><span class="versionmodified added">2.2 版中的新功能。</span></p> | ||
+ | |||
+ | </div> | ||
+ | <p>创建 [https://www.postgresql.org/docs/current/spgist.html SP-GiST 索引] 。</p> | ||
+ | <p>为 [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p></dd></dl> | ||
</div> | </div> | ||
− | + | ||
− | < | + | </div> |
− | + | <div class="clearer"> | |
− | |||
</div> | </div> | ||
− | [[Category:Django 3.0.x | + | [[Category:Django 3.0.x 文档]] |
2021年10月31日 (日) 04:09的最新版本
PostgreSQL 特定的模型索引
以下是 PostgreSQL 特定的 索引 ,可从 django.contrib.postgres.indexes
模块获得。
BrinIndex
- class BrinIndex(autosummarize=None, pages_per_range=None, **options)
创建 BRIN 索引 。
将
autosummarize
参数设置为True
,使自动汇总由autovacuum执行。pages_per_range
参数采用正整数。2.2 版更改: 添加了
autosummarize
参数。
BTreeIndex
- class BTreeIndex(fillfactor=None, **options)
2.2 版中的新功能。
创建 B 树索引。
为 fillfactor 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。
GinIndex
- class GinIndex(fastupdate=None, gin_pending_list_limit=None, **options)
创建 gin 索引 。
要在不在 内置运算符类 中的数据类型上使用此索引,您需要在 PostgreSQL 上激活 btree_gin 扩展 。 您可以使用 BtreeGinExtension 迁移操作安装它。
将
fastupdate
参数设置为False
以禁用在 PostgreSQL 中默认启用的 GIN 快速更新技术 。为 gin_pending_list_limit 参数提供整数字节以调整启用
fastupdate
时使用的 GIN 挂起列表的最大大小。
GistIndex
- class GistIndex(buffering=None, fillfactor=None, **options)
创建 GiST 索引 。 这些索引是在 spatial_index=True 的空间字段上自动创建的。 它们也可用于其他类型,例如 HStoreField 或 范围字段 。
要对不在内置 gist 运算符类 中的数据类型使用此索引,您需要在 PostgreSQL 上激活 btree_gist 扩展 。 您可以使用 BtreeGistExtension 迁移操作安装它。
将
buffering
参数设置为True
或False
以手动启用或禁用索引的 缓冲构建 。为 fillfactor 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。
HashIndex
- class HashIndex(fillfactor=None, **options)
2.2 版中的新功能。
创建哈希索引。
为 fillfactor 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。
仅在 PostgreSQL 10 及更高版本上使用此索引
哈希索引在 PostgreSQL 中已经存在很长时间了,但它们在旧版本中存在许多数据完整性问题。
SpGistIndex
- class SpGistIndex(fillfactor=None, **options)
2.2 版中的新功能。
创建 SP-GiST 索引 。
为 fillfactor 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。