docs: add documentation for oracle_tablespace option

Added documentation for the new table option  to specify the
 option when creating a table in Oracle. This includes an example
usage and a detailed description of the feature. Pull request courtesy of Miguel Grillo.

For more details, see the discussion at https://github.com/sqlalchemy/sqlalchemy/issues/12016.

diff --git a/doc/build/changelog/unreleased_20/12016.rst b/doc/build/changelog/unreleased_20/12016.rst
new file mode 100644 (file)
index 0000000..5fa68d0
--- /dev/null
+++ b/doc/build/changelog/unreleased_20/12016.rst
@@ -0,0 +1,7 @@
+.. change::
+    :tags: feature, oracle
+    :ticket: 12016
+
+    Added new table option `oracle_tablespace` to specify the `TABLESPACE` option
+    when creating a table in Oracle. This allows users to define the tablespace in 
+    which the table should be created. Pull request courtesy of Miguel Grillo.

diff --git a/lib/sqlalchemy/dialects/oracle/base.py b/lib/sqlalchemy/dialects/oracle/base.py
index 159d6eeb61ae93a4f56f8c4b027a007f65888d62..18bca4ab0beeeddeab1d3a73e7f7358dce6dd64c 100644 (file)
--- a/lib/sqlalchemy/dialects/oracle/base.py
+++ b/lib/sqlalchemy/dialects/oracle/base.py
@@ -500,6 +500,15 @@ in conjunction with the :class:`_schema.Table` construct:
    The ``oracle_compress`` parameter accepts either an integer compression
    level, or ``True`` to use the default compression level.
 
+* ``TABLESPACE``::
+
+    Table('mytable', metadata, ...,
+        oracle_tablespace="EXAMPLE_TABLESPACE")
+
+    The ``oracle_tablespace`` parameter specifies the tablespace in which the
+    table is to be created. This is useful when you want to create a table in a
+    tablespace other than the default tablespace of the user.
+
 .. _oracle_index_options:
 
 Oracle Specific Index Options