Support for the Oracle database.

The following table summarizes current support levels for database release versions.

DBAPI Support¶

The following dialect/DBAPI options are available. Please refer to individual DBAPI sections for connect information.

• cx-Oracle

自动增量行为¶

通常假定包含整数主键的SQLAlchemy表对象具有“自动递增”行为，这意味着它们可以在插入时生成自己的主键值。对于在Oracle中使用，有两个选项可用，即使用标识列（仅限Oracle 12及更高版本）或序列与列的关联。

t = Table('mytable', metadata,
    Column('id', Integer, Identity(start=3), primary_key=True),
    Column(...), ...
)

CREATE TABLE mytable (
    id INTEGER GENERATED BY DEFAULT AS IDENTITY (START WITH 3),
    ...,
    PRIMARY KEY (id)
)

t = Table('mytable', metadata,
      Column('id', Integer, Sequence('id_seq'), primary_key=True),
      Column(...), ...
)

t = Table('mytable', metadata,
      Column('id', Integer, Sequence('id_seq'), primary_key=True),
      autoload_with=engine
)

事务隔离级别/自动提交¶

Oracle数据库支持“READ COMMITTED”和“SERIALIZABLE”隔离模式。CX_ORACLE方言也支持AUTOCOMMIT隔离级别。

使用每个连接执行选项进行设置：

connection = engine.connect()
connection = connection.execution_options(
    isolation_level="AUTOCOMMIT"
)

为 READ COMMITTED 和 SERIALIZABLE ，Oracle方言使用以下命令在会话级别设置级别 ALTER SESSION ，当连接返回到连接池时，它将恢复为其默认设置。

的有效值 isolation_level 包括：

• READ COMMITTED

• AUTOCOMMIT

• SERIALIZABLE

标识符大小写¶

在Oracle中，数据字典使用大写文本表示所有不区分大小写的标识符名称。另一方面，SQLAlchemy认为所有小写标识符名称都不区分大小写。在模式级通信期间，Oracle方言将所有不区分大小写的标识符转换为这两种格式，例如表和索引的反射。在sqlAlchemy端使用大写名称表示区分大小写的标识符，sqlAlchemy将引用该名称-这将导致与从Oracle接收的数据字典数据不匹配，因此，除非标识符名称真正创建为区分大小写（即使用带引号的名称），否则所有小写名称都应在sqlAlchemy上使用。一边。

最大标识符长度¶

自Oracle Server 12.2版起，Oracle已更改默认的最大标识符长度。在这个版本之前，长度是30，对于12.2及更高版本，现在是128。此更改会影响生成的SQL标签名称区域中的SQLAlchemy以及约束名称的生成，尤其是在中描述的约束命名约定功能的情况下 配置约束命名约定 正在被使用。

为了帮助进行此更改和其他更改，Oracle包含了“兼容性”版本的概念，它是一个独立于实际服务器版本的版本号，以帮助迁移Oracle数据库，并且可以在Oracle服务器本身中进行配置。使用此版本检索兼容性 SELECT value FROM v$parameter WHERE name = 'compatible'; . SQLAlchemy Oracle方言负责确定默认的最大标识符长度时，将在第一次连接时尝试使用此查询，以确定服务器的有效兼容性版本，该版本确定服务器允许的最大标识符长度。如果表不可用，则使用服务器版本信息。

从SQLAlchemy 1.4开始，Oracle方言的默认最大标识符长度为128个字符。第一次连接时，将检测到兼容版本，如果兼容版本低于Oracle 12.2版，则最大标识符长度将更改为30个字符。在所有情况下，设置 create_engine.max_identifier_length 参数将绕过此更改，给定的值将按原样使用：

engine = create_engine(
    "oracle+cx_oracle://scott:tiger@oracle122",
    max_identifier_length=30)

在SELECT语句中生成匿名SQL标签时，最大标识符长度都会发挥作用，但在根据命名约定生成约束名称时更为关键。正是这个区域使得SQLAlchemy需要保守地更改这个默认值。例如，以下命名约定根据标识符长度生成两个截然不同的约束名称：

from sqlalchemy import Column
from sqlalchemy import Index
from sqlalchemy import Integer
from sqlalchemy import MetaData
from sqlalchemy import Table
from sqlalchemy.dialects import oracle
from sqlalchemy.schema import CreateIndex

m = MetaData(naming_convention={"ix": "ix_%(column_0N_name)s"})

t = Table(
    "t",
    m,
    Column("some_column_name_1", Integer),
    Column("some_column_name_2", Integer),
    Column("some_column_name_3", Integer),
)

ix = Index(
    None,
    t.c.some_column_name_1,
    t.c.some_column_name_2,
    t.c.some_column_name_3,
)

oracle_dialect = oracle.dialect(max_identifier_length=30)
print(CreateIndex(ix).compile(dialect=oracle_dialect))

如果标识符长度为30，则上面的CREATE INDEX如下所示：

CREATE INDEX ix_some_column_name_1s_70cd ON t
(some_column_name_1, some_column_name_2, some_column_name_3)

但是，当长度=128时，它变为：

CREATE INDEX ix_some_column_name_1some_column_name_2some_column_name_3 ON t
(some_column_name_1, some_column_name_2, some_column_name_3)

因此，在Oracle server 12.2版或更高版本上运行SQLAlchemy 1.4之前版本的应用程序将面临数据库迁移的情况，即希望对以前生成的较短长度的名称“删除约束”。当标识符长度更改而不首先调整索引或约束的名称时，此迁移将失败。强烈建议此类应用程序利用 create_engine.max_identifier_length 为了保持对截断名称生成的控制，并在更改此值时全面检查和测试登台环境中的所有数据库迁移，以确保已减轻此更改的影响。

极限/偏移支撑¶

直到12c版，Oracle才对LIMIT和OFFSET提供直接支持。为了在从8系列开始的所有广泛使用的Oracle版本中实现这种行为，SQLAlchemy当前使用ROWNUM来实现LIMIT/OFFSET；准确的方法来自https://blogs.oracle.com/oraclemagazine/on-rownum-and-limiting-results.

当前只有一个选项可以影响其行为：

• 默认情况下不使用“FIRST_ROWS（）”优化关键字。要启用此优化指令的使用，请指定 optimize_limits=True 到 create_engine() .

支持更改行号策略，其中包括一个使用 row_number() 窗口函数以及使用oracle12c“FETCH FIRST N ROW/OFFSET N ROWS”关键字的函数可能会在将来的版本中添加。

返回支持¶

Oracle数据库支持有限的返回形式，以便从insert、update和delete语句中检索匹配行的结果集。Oracle的返回..in to语法只支持返回一行，因为它依赖out参数才能运行。此外，受支持的DBAPI还有进一步的限制（请参见 返回支持 ）

SQLAlchemy的“隐式返回”功能通常在Oracle后端启用，它使用在insert中返回，有时还使用update语句来获取新生成的主键值和其他SQL默认值和表达式。默认情况下，“隐式返回”通常只获取单个 nextval(some_seq) 嵌入到insert中的表达式，以便在insert语句中增加序列并同时返回值。要全面禁用此功能，请指定 implicit_returning=False 到 create_engine() ：：

engine = create_engine("oracle://scott:tiger@dsn",
                       implicit_returning=False)

隐式返回也可以作为表选项逐个表禁用：

# Core Table
my_table = Table("my_table", metadata, ..., implicit_returning=False)


# declarative
class MyClass(Base):
    __tablename__ = 'my_table'
    __table_args__ = {"implicit_returning": False}

更新层叠时¶

Oracle没有原生更新时级联功能。https://asktom.oracle.com/tkyte/update_cascade/index.html上提供了基于触发器的解决方案。

使用SQLAlchemy ORM时，ORM手动发出级联更新的能力有限-使用“deferrable=true，initially='deferred'”关键字参数指定foreignkey对象，并在每个关系（）上指定“passive_updates=false”。

Oracle 8兼容性¶

当检测到Oracle 8时，方言在内部将自身配置为以下行为：

• “使用”ansi标志设置为false。这样做的效果是将所有连接短语转换为WHERE子句，如果是左外部连接，则使用Oracle的（+）运算符。

• 当 Unicode 使用-varchar2和clob。这是因为这些类型在Oracle8上似乎不能正常工作，即使它们是可用的。这个 NVARCHAR 和 NCLOB 类型将始终生成nvarchar2和nclob。

• 当使用cx_oracle时，“本机Unicode”模式被禁用，即sqlAlchemy在作为绑定参数传入之前将所有python unicode对象编码为“string”。

同义词/dblink反射¶

当对表对象使用反射时，方言可以通过传递标志来选择性地搜索由同义词表示的表，无论是在本地模式还是远程模式中，还是通过dblink访问的表。 oracle_resolve_synonyms=True 作为关键字参数 Table 结构：

some_table = Table('some_table', autoload_with=some_engine,
                            oracle_resolve_synonyms=True)

设置此标志时，给定的名称（例如 some_table 将不仅仅在 ALL_TABLES 视图，但也在 ALL_SYNONYMS 查看此名称是否实际上是其他名称的同义词。如果同义词位于并引用dblink，则Oracle方言知道如何使用dblink语法（例如 @dblink ）

oracle_resolve_synonyms 在接受反射参数的地方接受，包括 MetaData.reflect() 和 Inspector.get_columns() .

如果同义词未使用，则应禁用此标志。

约束反射¶

Oracle方言可以返回有关外键、唯一和检查约束以及表上索引的信息。

有关这些约束的原始信息可以使用 Inspector.get_foreign_keys() ， Inspector.get_unique_constraints() ， Inspector.get_check_constraints() 和 Inspector.get_indexes() .

使用反射时 Table 水平 Table 还将包括这些约束。

注意以下注意事项：

• 当使用 Inspector.get_check_constraints() 方法，Oracle为指定“not null”的列生成一个特殊的“is not null”约束。这个约束是 not 默认情况下返回；要包含“is not null”约束，请传递标志 include_all=True ：：

  from sqlalchemy import create_engine, inspect
  
  engine = create_engine("oracle+cx_oracle://s:t@dsn")
  inspector = inspect(engine)
  all_check_constraints = inspector.get_check_constraints(
      "some_table", include_all=True)

• 在大多数情况下，当反映 Table ，唯一约束将 not 可作为 UniqueConstraint 对象，因为在大多数情况下，Oracle使用唯一索引来镜像唯一约束（当两个或多个唯一约束表示同一列时似乎是例外）； Table 而是用 Index 与 unique=True 标志集。

• Oracle为表的主键创建隐式索引；此索引是 排除 从所有索引结果。

• 为索引反映的列列表将不包括以sys_nc开头的列名称。

带有系统/系统辅助表空间的表名¶

这个 Inspector.get_table_names() 和 Inspector.get_temp_table_names() 方法分别返回当前引擎的表名列表。这些方法也是操作中发生的反射的一部分，例如 MetaData.reflect() . 默认情况下，这些操作不包括 SYSTEM 和 SYSAUX 操作中的表空间。为了更改此设置，可以在引擎级别使用 exclude_tablespaces 参数：：

# exclude SYSAUX and SOME_TABLESPACE, but not SYSTEM
e = create_engine(
  "oracle://scott:tiger@xe",
  exclude_tablespaces=["SYSAUX", "SOME_TABLESPACE"])

日期时间兼容性¶

Oracle没有已知的数据类型 DATETIME 相反，它只有 DATE ，它实际上可以存储日期和时间值。因此，Oracle方言提供了 DATE 它是 DateTime . 此类型没有特殊行为，并且仅作为此类型的“标记”存在；此外，当数据库列被反映并且该类型被报告为 DATE ，时间支持 DATE 使用类型。

Oracle表选项¶

create table短语与Oracle一起支持以下选项 Table 构建：

• ON COMMIT ：：

  Table(
      "some_table", metadata, ...,
      prefixes=['GLOBAL TEMPORARY'], oracle_on_commit='PRESERVE ROWS')

• COMPRESS ：：

   Table('mytable', metadata, Column('data', String(32)),
       oracle_compress=True)
  
   Table('mytable', metadata, Column('data', String(32)),
       oracle_compress=6)
  
  The ``oracle_compress`` parameter accepts either an integer compression
  level, or ``True`` to use the default compression level.

Oracle特定索引选项¶

Index('my_index', my_table.c.data, oracle_bitmap=True)

Index('my_index', my_table.c.data, oracle_compress=True)

Index('my_index', my_table.c.data1, my_table.c.data2, unique=True,
       oracle_compress=1)

Oracle数据类型¶

与所有的sqlAlchemy方言一样，已知对Oracle有效的所有大写类型都可以从顶级方言导入，无论它们是否源自 sqlalchemy.types 或者来自当地方言：

from sqlalchemy.dialects.oracle import \
            BFILE, BLOB, CHAR, CLOB, DATE, \
            DOUBLE_PRECISION, FLOAT, INTERVAL, LONG, NCLOB, NCHAR, \
            NUMBER, NVARCHAR, NVARCHAR2, RAW, TIMESTAMP, VARCHAR, \
            VARCHAR2

特定于Oracle或具有Oracle特定构造参数的类型如下：

class sqlalchemy.dialects.oracle.BFILE(length=None)¶

类签名

class sqlalchemy.dialects.oracle.BFILE (sqlalchemy.types.LargeBinary)

method sqlalchemy.dialects.oracle.BFILE.__init__(length=None)¶

inherited from the sqlalchemy.types.LargeBinary.__init__ method of LargeBinary

构造一个大二进制类型。

参数

length¶ -- 可选，用于ddl语句中的列的长度，用于接受长度的二进制类型，例如mysql blob类型。

class sqlalchemy.dialects.oracle.DATE(timezone=False)¶

提供Oracle日期类型。

此类型没有特殊的python行为，只是它的子类 DateTime 这是为了适应甲骨文 DATE 类型支持时间值。

0.9.4 新版功能.

类签名

class sqlalchemy.dialects.oracle.DATE (sqlalchemy.types.DateTime)

method sqlalchemy.dialects.oracle.DATE.__init__(timezone=False)¶

inherited from the sqlalchemy.types.DateTime.__init__ method of DateTime

构建新的 DateTime .

参数

timezone¶ -- 布尔函数。指示日期时间类型应启用时区支持（如果在 base date/time-holding type only . 建议使用 TIMESTAMP 当使用此标志时直接使用数据类型，因为某些数据库包含独立的通用日期/时间保持类型，这与支持时区的时间戳数据类型不同，例如Oracle。

class sqlalchemy.dialects.oracle.DOUBLE_PRECISION(precision=None, asdecimal=False, decimal_return_scale=None)¶

类签名

class sqlalchemy.dialects.oracle.DOUBLE_PRECISION (sqlalchemy.types.Float)

method sqlalchemy.dialects.oracle.DOUBLE_PRECISION.__init__(precision=None, asdecimal=False, decimal_return_scale=None)¶

inherited from the sqlalchemy.types.Float.__init__ method of Float

构造一个浮点。

参数

• precision¶ -- 用于DDL的数字精度 CREATE TABLE .

• asdecimal¶ -- 与…相同的标志 Numeric ，但默认为 False . 请注意，将此标志设置为 True 导致浮点转换。

• decimal_return_scale¶ -- 从浮点转换为python小数时使用的默认小数位数。由于小数点不准确，浮点值通常要长得多，而且大多数浮点数据库类型没有“小数位数”的概念，因此默认情况下，浮点类型在转换时查找前十位小数。指定此值将覆盖该长度。注意，如果没有另外指定，mysql float类型（包括“scale”）将使用“scale”作为decimal_return_scale的默认值。…版本已添加：：0.9.0

class sqlalchemy.dialects.oracle.INTERVAL(day_precision=None, second_precision=None)¶

类签名

class sqlalchemy.dialects.oracle.INTERVAL (sqlalchemy.types.NativeForEmulated, sqlalchemy.types._AbstractInterval)

method sqlalchemy.dialects.oracle.INTERVAL.__init__(day_precision=None, second_precision=None)¶

构造一个间隔。

请注意，目前只支持日到秒的时间间隔。这是由于在可用的dbapi中缺少对年到月间隔的支持。

参数

• day_precision¶ -- 日精度值。这是要为“日”字段存储的位数。默认为“2”

• second_precision¶ -- 第二个精度值。这是为小数秒字段存储的位数。默认为“6”。

class sqlalchemy.dialects.oracle.NCLOB(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False, _expect_unicode=False)¶

类签名

class sqlalchemy.dialects.oracle.NCLOB (sqlalchemy.types.Text)

method sqlalchemy.dialects.oracle.NCLOB.__init__(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False, _expect_unicode=False)¶

inherited from the sqlalchemy.types.String.__init__ method of String

创建字符串保持类型。

参数

• length¶ -- 可选，用于DDL和CAST表达式的列的长度。如果没有，可以安全地省略 CREATE TABLE 将发布。某些数据库可能需要 length 在DDL中使用，并在 CREATE TABLE 如果 VARCHAR 不包括长度。该值是否解释为字节或字符是特定于数据库的。

• collation¶ -- 可选，在DDL和CAST表达式中使用的列级排序规则。使用SQLite、MySQL和PostgreSQL支持的COLLATE关键字呈现。E、 g.：>>>从sqlalchemy import cast，select，String>>>打印（select（cast（'some String'，String（collation='utf8'）））select cast（：param_1 AS VARCHAR COLLATE utf8）AS anon_

• convert_unicode¶ -- 当设置为 True , the String 类型将假定输入将作为python 2下的python unicode对象传递，结果将作为python unicode对象返回。在DBAPI在python 2下不支持pythonUnicode的罕见情况下，sqlachemy将在字符串上使用自己的编码器/解码器功能，参考 create_engine.encoding 参数参数传递给 create_engine() 作为编码。…已弃用：：1.3 String.convert_unicode 参数已弃用，将在将来的版本中删除。所有现代DBAPI现在都直接支持PythonUnicode，而这个参数是不必要的。对于极为罕见的情况，python unicode将由sqlachemy在后端进行编码/解码， does 本机支持python unicode，字符串值 "force" 可以在此处传递，这将导致无条件使用SQLAlchemy的编码/解码服务。…注意：：sqlacalchemy的unicode转换标志和特性只适用于python 2；在python 3中，所有字符串对象都是unicode对象。出于这个原因，以及事实上，几乎所有现代DBAPI现在都支持Unicode，即使在Python2下， String.convert_unicode 标志本身就是一个遗留功能。…注：在绝大多数情况下， Unicode 或 UnicodeText 数据类型应用于 Column 它期望存储非ascii数据。这些数据类型将确保在数据库端使用正确的类型，并在Python2下设置正确的Unicode行为。。另请参见： create_engine.convert_unicode - Engine 宽参数

• unicode_error¶ -- 可选，用于处理Unicode转换错误的方法。表现得像 errors 标准库的关键字参数 string.decode() 函数，要求 String.convert_unicode 设置为 "force" …已弃用：：1.3 String.unicode_errors 参数已弃用，将在将来的版本中删除。这个参数对于现代的python dbapis来说是不必要的，并且会显著降低性能。

class sqlalchemy.dialects.oracle.NUMBER(precision=None, scale=None, asdecimal=None)¶

类签名

class sqlalchemy.dialects.oracle.NUMBER (sqlalchemy.types.Numeric, sqlalchemy.types.Integer)

method sqlalchemy.dialects.oracle.NUMBER.__init__(precision=None, scale=None, asdecimal=None)¶

构造一个数字。

参数

• precision¶ -- 用于DDL的数字精度 CREATE TABLE .

• scale¶ -- DDL中使用的数字刻度 CREATE TABLE .

• asdecimal¶ -- 默认为真。返回值是否应作为python decimal对象或float发送。不同的dbapis根据数据类型发送一个或另一个-数字类型将确保返回值在dbapis中是一致的。

• decimal_return_scale¶ -- 从浮点转换为python小数时使用的默认小数位数。由于小数点不准确，浮点值通常要长得多，而且大多数浮点数据库类型都没有“小数位数”的概念，因此默认情况下，浮点类型在转换时查找前十位小数。指定此值将覆盖该长度。包含显式“.scale”值的类型，如基 Numeric 以及mysql float类型，将使用“.scale”值作为decimal_return_scale的默认值，如果没有另外指定。…添加的版本：0.9.0

当使用 Numeric 类型，应注意确保asdecimal设置适用于正在使用的dbapi-当numeric应用decimal->float或float->decimal的转换时，此转换会对收到的所有结果列产生额外的性能开销。

本地返回十进制（例如psycopg2）的dbapis在设置为 True ，因为本机十进制转换减少了浮点问题的数量，并且数字类型本身不需要应用任何进一步的转换。但是，另一个DBAPI以本机方式返回浮动 will 产生额外的转换开销，并且仍然会受到浮点数据丢失的影响-在这种情况下 asdecimal=False 将至少移除额外的转换开销。

class sqlalchemy.dialects.oracle.LONG(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False, _expect_unicode=False)¶

类签名

class sqlalchemy.dialects.oracle.LONG (sqlalchemy.types.Text)

method sqlalchemy.dialects.oracle.LONG.__init__(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False, _expect_unicode=False)¶

inherited from the sqlalchemy.types.String.__init__ method of String

创建字符串保持类型。

参数

• length¶ -- 可选，用于DDL和CAST表达式的列的长度。如果没有，可以安全地省略 CREATE TABLE 将发布。某些数据库可能需要 length 在DDL中使用，并在 CREATE TABLE 如果 VARCHAR 不包括长度。该值是否解释为字节或字符是特定于数据库的。

• collation¶ -- 可选，在DDL和CAST表达式中使用的列级排序规则。使用SQLite、MySQL和PostgreSQL支持的COLLATE关键字呈现。E、 g.：>>>从sqlalchemy import cast，select，String>>>打印（select（cast（'some String'，String（collation='utf8'）））select cast（：param_1 AS VARCHAR COLLATE utf8）AS anon_

• convert_unicode¶ -- 当设置为 True , the String 类型将假定输入将作为python 2下的python unicode对象传递，结果将作为python unicode对象返回。在DBAPI在python 2下不支持pythonUnicode的罕见情况下，sqlachemy将在字符串上使用自己的编码器/解码器功能，参考 create_engine.encoding 参数参数传递给 create_engine() 作为编码。…已弃用：：1.3 String.convert_unicode 参数已弃用，将在将来的版本中删除。所有现代DBAPI现在都直接支持PythonUnicode，而这个参数是不必要的。对于极为罕见的情况，python unicode将由sqlachemy在后端进行编码/解码， does 本机支持python unicode，字符串值 "force" 可以在此处传递，这将导致无条件使用SQLAlchemy的编码/解码服务。…注意：：sqlacalchemy的unicode转换标志和特性只适用于python 2；在python 3中，所有字符串对象都是unicode对象。出于这个原因，以及事实上，几乎所有现代DBAPI现在都支持Unicode，即使在Python2下， String.convert_unicode 标志本身就是一个遗留功能。…注：在绝大多数情况下， Unicode 或 UnicodeText 数据类型应用于 Column 它期望存储非ascii数据。这些数据类型将确保在数据库端使用正确的类型，并在Python2下设置正确的Unicode行为。。另请参见： create_engine.convert_unicode - Engine 宽参数

• unicode_error¶ -- 可选，用于处理Unicode转换错误的方法。表现得像 errors 标准库的关键字参数 string.decode() 函数，要求 String.convert_unicode 设置为 "force" …已弃用：：1.3 String.unicode_errors 参数已弃用，将在将来的版本中删除。这个参数对于现代的python dbapis来说是不必要的，并且会显著降低性能。

class sqlalchemy.dialects.oracle.RAW(length=None)¶

类签名

class sqlalchemy.dialects.oracle.RAW (sqlalchemy.types._Binary)

method sqlalchemy.dialects.oracle.RAW.__init__(length=None)¶

inherited from the sqlalchemy.types._Binary.__init__ method of sqlalchemy.types._Binary

cx_Oracle¶

Support for the Oracle database via the cx-Oracle driver.

oracle+cx_oracle://user:pass@hostname:port[/dbname][?service_name=<service>[&key=value&key=value...]]

engine = create_engine("oracle+cx_oracle://scott:tiger@hostname:port/?service_name=myservice&encoding=UTF-8&nencoding=UTF-8")

myalias =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = mymachine.example.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = orclpdb1)
    )
  )

engine = create_engine("oracle+cx_oracle://scott:tiger@myalias/?encoding=UTF-8&nencoding=UTF-8")

engine = create_engine("oracle+cx_oracle://scott:tiger@hostname:1521/dbname?encoding=UTF-8&nencoding=UTF-8")

>>> import cx_Oracle
>>> cx_Oracle.makedsn("hostname", 1521, sid="dbname")
'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=hostname)(PORT=1521))(CONNECT_DATA=(SID=dbname)))'

e = create_engine(
    "oracle+cx_oracle://user:pass@dsn?encoding=UTF-8&nencoding=UTF-8&mode=SYSDBA&events=true")

import cx_Oracle
e = create_engine(
    "oracle+cx_oracle://user:pass@dsn",
    connect_args={
        "encoding": "UTF-8",
        "nencoding": "UTF-8",
        "mode": cx_Oracle.SYSDBA,
        "events": True
    }
)

e = create_engine(
    "oracle+cx_oracle://user:pass@dsn", coerce_to_unicode=False)

import cx_Oracle
from sqlalchemy import create_engine
from sqlalchemy.pool import NullPool

pool = cx_Oracle.SessionPool(
    user="scott", password="tiger", dsn="orclpdb",
    min=2, max=5, increment=1, threaded=True,
    encoding="UTF-8", nencoding="UTF-8"
)

engine = create_engine("oracle://", creator=pool.acquire, poolclass=NullPool)

with engine.connect() as conn:
    print(conn.scalar("select 1 FROM dual"))

import cx_Oracle
from sqlalchemy import create_engine
from sqlalchemy.pool import NullPool

pool = cx_Oracle.SessionPool(
    user="scott", password="tiger", dsn="orclpdb",
    min=2, max=5, increment=1, threaded=True,
    encoding="UTF-8", nencoding="UTF-8"
)

def creator():
    return pool.acquire(cclass="MYCLASS", purity=cx_Oracle.ATTR_PURITY_SELF)

engine = create_engine("oracle://", creator=creator, poolclass=NullPool)

with engine.connect() as conn:
    print(conn.scalar("select 1 FROM dual"))

engine = create_engine("oracle+cx_oracle://scott:tiger@orclpdb/?encoding=UTF-8&nencoding=UTF-8")

from sqlalchemy import create_engine, event

engine = create_engine("oracle+cx_oracle://scott:tiger@host/xe")

@event.listens_for(engine, "do_setinputsizes")
def _log_setinputsizes(inputsizes, cursor, statement, parameters, context):
    for bindparam, dbapitype in inputsizes.items():
            log.info(
                "Bound parameter name: %s  SQLAlchemy type: %r  "
                "DBAPI object: %s",
                bindparam.key, bindparam.type, dbapitype)

from sqlalchemy import create_engine, event
from cx_Oracle import CLOB

engine = create_engine("oracle+cx_oracle://scott:tiger@host/xe")

@event.listens_for(engine, "do_setinputsizes")
def _remove_clob(inputsizes, cursor, statement, parameters, context):
    for bindparam, dbapitype in list(inputsizes.items()):
        if dbapitype is CLOB:
            del inputsizes[bindparam]

engine = create_engine("oracle+cx_oracle://dsn", coerce_to_decimal=False)