“Django/docs/3.0.x/ref/contrib/postgres/indexes”的版本间差异

来自菜鸟教程
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 specific model indexes =
+
= PostgreSQL 特定的模型索引 =
  
The following are PostgreSQL specific [[../../../models/indexes|<span class="doc">indexes</span>]]
+
以下是 PostgreSQL 特定的 [[../../../models/indexes|索引]] ,可从 <code>django.contrib.postgres.indexes</code> 模块获得。
available from the <code>django.contrib.postgres.indexes</code> module.
 
  
 
<div id="brinindex" class="section">
 
<div id="brinindex" class="section">
  
== <code>BrinIndex</code> ==
+
== BrinIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>BrinIndex</code><span class="sig-paren">(</span>''<span class="n">autosummarize</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="n">pages_per_range</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>Creates a [https://www.postgresql.org/docs/current/brin-intro.html BRIN index].</p>
+
<dd><p>创建 [https://www.postgresql.org/docs/current/brin-intro.html BRIN 索引] </p>
<p>Set the <code>autosummarize</code> parameter to <code>True</code> to enable [https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION automatic
+
<p><code>autosummarize</code>参数设置为<code>True</code>,使[https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION 自动汇总]由autovacuum执行。</p>
summarization] to be performed by autovacuum.</p>
+
<p><code>pages_per_range</code> 参数采用正整数。</p>
<p>The <code>pages_per_range</code> argument takes a positive integer.</p>
 
 
<div class="versionchanged">
 
<div class="versionchanged">
  
<p>The <code>autosummarize</code> parameter was added.</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">
  
== <code>BTreeIndex</code> ==
+
== BTreeIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>BTreeIndex</code><span class="sig-paren">(</span>''<span class="n">fillfactor</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>Creates a B-Tree index.</p>
+
<p>创建 B 树索引。</p>
<p>Provide an integer value from 10 to 100 to the [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] parameter to
+
<p>[https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p></dd></dl>
tune how packed the index pages will be. PostgreSQL's default is 90.</p></dd></dl>
 
  
  
第44行: 第42行:
 
<div id="ginindex" class="section">
 
<div id="ginindex" class="section">
  
== <code>GinIndex</code> ==
+
== GinIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>GinIndex</code><span class="sig-paren">(</span>''<span class="n">fastupdate</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="n">gin_pending_list_limit</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>Creates a [https://www.postgresql.org/docs/current/gin.html gin index].</p>
+
<dd><p>创建 [https://www.postgresql.org/docs/current/gin.html gin 索引] </p>
<p>To use this index on data types not in the [https://www.postgresql.org/docs/current/gin-builtin-opclasses.html built-in operator classes],
+
<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>
you need to activate the [https://www.postgresql.org/docs/current/btree-gin.html btree_gin extension] on
+
<p><code>fastupdate</code> 参数设置为 <code>False</code> 以禁用在 PostgreSQL 中默认启用的 [https://www.postgresql.org/docs/current/gin-implementation.html#GIN-FAST-UPDATE GIN 快速更新技术] </p>
PostgreSQL. You can install it using the
+
<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|<code>BtreeGinExtension</code>]] migration
 
operation.</p>
 
<p>Set the <code>fastupdate</code> parameter to <code>False</code> to disable the [https://www.postgresql.org/docs/current/gin-implementation.html#GIN-FAST-UPDATE GIN Fast
 
Update Technique] that's enabled by default in PostgreSQL.</p>
 
<p>Provide an integer number of bytes to the [https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-GIN-PENDING-LIST-LIMIT gin_pending_list_limit] parameter
 
to tune the maximum size of the GIN pending list which is used when
 
<code>fastupdate</code> is enabled.</p></dd></dl>
 
  
  
第64行: 第55行:
 
<div id="gistindex" class="section">
 
<div id="gistindex" class="section">
  
== <code>GistIndex</code> ==
+
== GistIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>GistIndex</code><span class="sig-paren">(</span>''<span class="n">buffering</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="n">fillfactor</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>Creates a [https://www.postgresql.org/docs/current/gist.html GiST index]. These indexes are
+
<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>
automatically created on spatial fields with [[../../gis/model-api#django.contrib.gis.db.models.BaseSpatialField|<code>spatial_index=True</code>]]. They're
+
<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>
also useful on other types, such as
+
<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|<code>HStoreField</code>]] or the [[../fields#range-fields|<span class="std std-ref">range
+
<p>[https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p></dd></dl>
fields</span>]].</p>
 
<p>To use this index on data types not in the built-in [https://www.postgresql.org/docs/current/gist-builtin-opclasses.html gist operator classes],
 
you need to activate the [https://www.postgresql.org/docs/current/btree-gist.html btree_gist extension] on PostgreSQL.
 
You can install it using the
 
[[../operations#django.contrib.postgres.operations|<code>BtreeGistExtension</code>]] migration
 
operation.</p>
 
<p>Set the <code>buffering</code> parameter to <code>True</code> or <code>False</code> to manually enable
 
or disable [https://www.postgresql.org/docs/current/gist-implementation.html#GIST-BUFFERING-BUILD buffering build] of the index.</p>
 
<p>Provide an integer value from 10 to 100 to the [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] parameter to
 
tune how packed the index pages will be. PostgreSQL's default is 90.</p></dd></dl>
 
  
  
第87行: 第68行:
 
<div id="hashindex" class="section">
 
<div id="hashindex" class="section">
  
== <code>HashIndex</code> ==
+
== HashIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>HashIndex</code><span class="sig-paren">(</span>''<span class="n">fillfactor</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>Creates a hash index.</p>
+
<p>创建哈希索引。</p>
<p>Provide an integer value from 10 to 100 to the [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] parameter to
+
<p>[https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] 参数提供一个从 10 到 100 的整数值,以调整索引页面的打包方式。 PostgreSQL 的默认值为 90。</p>
tune how packed the index pages will be. PostgreSQL's default is 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>Use this index only on PostgreSQL 10 and later</p>
+
<p>仅在 PostgreSQL 10 及更高版本上使用此索引</p>
<p>Hash indexes have been available in PostgreSQL for a long time, but
+
<p>哈希索引在 PostgreSQL 中已经存在很长时间了,但它们在旧版本中存在许多数据完整性问题。</p>
they suffer from a number of data integrity issues in older versions.</p>
 
  
 
</div></dd></dl>
 
</div></dd></dl>
第111行: 第90行:
 
<div id="spgistindex" class="section">
 
<div id="spgistindex" class="section">
  
== <code>SpGistIndex</code> ==
+
== SpGistIndex ==
  
 
<dl>
 
<dl>
<dt>''class'' <code>SpGistIndex</code><span class="sig-paren">(</span>''<span class="n">fillfactor</span><span class="o">=</span><span class="default_value">None</span>'', ''<span class="o">**</span><span class="n">options</span>''<span class="sig-paren">)</span></dt>
+
<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>
<p>Creates an [https://www.postgresql.org/docs/current/spgist.html SP-GiST index].</p>
+
 
<p>Provide an integer value from 10 to 100 to the [https://www.postgresql.org/docs/current/sql-createindex.html#SQL-CREATEINDEX-STORAGE-PARAMETERS fillfactor] parameter to
+
</div>
tune how packed the index pages will be. PostgreSQL's default is 90.</p></dd></dl>
+
<div class="clearer">
  
  
</div>
 
  
 
</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 参数设置为 TrueFalse 以手动启用或禁用索引的 缓冲构建

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。