{"title":"Tablespaces","version":"4.2","locale":"en","docname":"topics/db/tablespaces","url":"/en/4.2/topics/db/tablespaces/","canonical":"https://djangodocs.dev/en/4.2/topics/db/tablespaces/","summary":"A common paradigm for optimizing performance in database systems is the use of tablespaces to organize disk layout. Warning Django does not create the tablespaces…","html":"

TablespacesLink to this heading#

\n

A common paradigm for optimizing performance in database systems is the use of\ntablespaces to organize disk layout.

\n\n
\n

Declaring tablespaces for tablesLink to this heading#

\n

A tablespace can be specified for the table generated by a model by supplying\nthe db_tablespace option inside the model’s\nclass Meta. This option also affects tables automatically created for\nManyToManyFields in the model.

\n

You can use the DEFAULT_TABLESPACE setting to specify a default value\nfor db_tablespace. This is useful for setting\na tablespace for the built-in Django apps and other applications whose code you\ncannot control.

\n
\n
\n

Declaring tablespaces for indexesLink to this heading#

\n

You can pass the db_tablespace option to an\nIndex constructor to specify the name of a tablespace to use for the index.\nFor single field indexes, you can pass the\ndb_tablespace option to a Field constructor\nto specify an alternate tablespace for the field’s column index. If the column\ndoesn’t have an index, the option is ignored.

\n

You can use the DEFAULT_INDEX_TABLESPACE setting to specify\na default value for db_tablespace.

\n

If db_tablespace isn’t specified and you didn’t\nset DEFAULT_INDEX_TABLESPACE, the index is created in the same\ntablespace as the tables.

\n
\n
\n

An exampleLink to this heading#

\n
Python
class TablespaceExample(models.Model):\n    name = models.CharField(max_length=30, db_index=True, db_tablespace="indexes")\n    data = models.CharField(max_length=255, db_index=True)\n    shortcut = models.CharField(max_length=7)\n    edges = models.ManyToManyField(to="self", db_tablespace="indexes")\n\n    class Meta:\n        db_tablespace = "tables"\n        indexes = [models.Index(fields=["shortcut"], db_tablespace="other_indexes")]\n
\n

In this example, the tables generated by the TablespaceExample model (i.e.\nthe model table and the many-to-many table) would be stored in the tables\ntablespace. The index for the name field and the indexes on the many-to-many\ntable would be stored in the indexes tablespace. The data field would\nalso generate an index, but no tablespace for it is specified, so it would be\nstored in the model tablespace tables by default. The index for the\nshortcut field would be stored in the other_indexes tablespace.

\n
\n
\n

Database supportLink to this heading#

\n

PostgreSQL and Oracle support tablespaces. SQLite, MariaDB and MySQL don’t.

\n

When you use a backend that lacks support for tablespaces, Django ignores all\ntablespace-related options.

\n
","rootId":"tablespaces","toc":[{"title":"Declaring tablespaces for tables","anchor":"declaring-tablespaces-for-tables","children":[]},{"title":"Declaring tablespaces for indexes","anchor":"declaring-tablespaces-for-indexes","children":[]},{"title":"An example","anchor":"an-example","children":[]},{"title":"Database support","anchor":"database-support","children":[]}],"breadcrumbs":[{"docname":"topics/index","title":"Using Django","url":"/en/4.2/topics/"},{"docname":"topics/db/index","title":"Models and databases","url":"/en/4.2/topics/db/"}],"prev":{"docname":"topics/db/multi-db","title":"Multiple databases","url":"/en/4.2/topics/db/multi-db/"},"next":{"docname":"topics/db/optimization","title":"Database access optimization","url":"/en/4.2/topics/db/optimization/"},"formats":{"html":"/en/4.2/topics/db/tablespaces/","markdown":"/en/4.2/topics/db/tablespaces.md","json":"/en/4.2/topics/db/tablespaces.json"},"source":"https://github.com/django/django/blob/stable/4.2.x/docs/topics/db/tablespaces.txt","official":"https://docs.djangoproject.com/en/4.2/topics/db/tablespaces/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}