甲骨文¶ T0>

支持Oracle数据库。

DBAPI支持¶

以下dialect / DBAPI选项可用。请参阅各个DBAPI部分的连接信息。

• CX-甲骨文 T0>
• Jython的zxJDBC

连接参数¶

The dialect supports several create_engine() arguments which affect the behavior of the dialect regardless of driver in use.

• use_ansi - 使用ANSI JOIN结构（请参阅Oracle 8一节）。默认为True。如果False，则Oracle-8兼容构造用于连接。
• optimize_limits - 默认为False。参见LIMIT / OFFSET部分。
• use_binds_for_limits - 默认为True。参见LIMIT / OFFSET部分。

自动增量行为¶

包含整数主键的SQLAlchemy表对象通常被认为具有“自动增量”行为，这意味着它们可以在INSERT时生成它们自己的主键值。由于Oracle没有“自动增量”功能，SQLAlchemy依赖序列来生成这些值。With the Oracle dialect, a sequence must always be explicitly specified to enable autoincrement. 这与假定使用具有自动增量功能的数据库的大多数文档示例不同。要指定序列，请使用传递给Column构造的sqlalchemy.schema.Sequence对象：

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

当使用表反射时，这一步也是必需的，即autoload = True：

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

标识符套管¶

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

LIMIT / OFFSET支持¶

Oracle不支持LIMIT或OFFSET关键字。SQLAlchemy与ROWNUM一起使用了一个包装子查询方法。The exact methodology is taken from http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html .

有两个选项会影响其行为：

• “FIRST ROWS()”优化关键字默认不使用。要启用此优化指令，请将optimize_limits=True指定为create_engine()。
• 为极限/偏移量传递的值将作为绑定参数发送。一些用户已经观察到，如果值作为绑定发送并且不是字面呈现，Oracle会产生一个糟糕的查询计划。要在SQL语句中逐字地显示限制/偏移值，请将use_binds_for_limits=False指定为create_engine()。

当使用完全不同的窗口查询方法（即ROW_NUMBER()OVER（ORDER BY））来提供LIMIT / OFFSET（注意大多数用户不会观察到此情况）时，某些用户报告了更好的性能。为了适应这种情况，用于LIMIT / OFFSET的方法可以完全替换。请参阅http://www.sqlalchemy.org/trac/wiki/UsageRecipes/WindowFunctionsByDefault中的配方，该配置安装了一个选择编译器，该选择编译器使用窗口函数替代极限/偏移量的生成。

返回支持¶

Oracle数据库支持有限的RETURNING形式，以便从INSERT，UPDATE和DELETE语句中检索匹配行的结果集。Oracle的RETURNING..INTO语法只支持返回一行，因为它依赖OUT参数才能正常工作。另外，受支持的DBAPI还有其他限制（请参阅RETURNING Support）。

SQLAlchemy的“隐式返回”功能通常在Oracle后端启用，它在INSERT中使用RETURNING，有时使用UPDATE语句来获取新生成的主键值和其他SQL默认值和表达式。默认情况下，“隐式返回”通常只会获取嵌入到INSERT中的单个nextval(some_seq)表达式的值，以便在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}

ON UPDATE CASCADE ¶

Oracle没有本地ON UPDATE CASCADE功能。基于触发器的解决方案可在http://asktom.oracle.com/tkyte/update_cascade/index.html中找到。

使用SQLAlchemy ORM时，ORM手动发布级联更新的能力有限 - 使用“deferrable = True”，initial ='deferred'“关键字参数指定ForeignKey对象，并在每个关系()上指定”passive_updates = False“。

Oracle 8兼容性¶

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

• use_ansi标志被设置为False。这具有将所有JOIN短语转换为WHERE子句的效果，并且在LEFT OUTER JOIN使用Oracle的（+）运算符的情况下。
• 当使用Unicode时，NVARCHAR2和NCLOB数据类型不再生成为DDL - 而是发出VARCHAR2和CLOB。这是因为这些类型在Oracle 8上似乎不能正常工作，即使它们可用。NVARCHAR和NCLOB类型将始终生成NVARCHAR2和NCLOB。
• 在使用cx_oracle时，“native unicode”模式被禁用，即SQLAlchemy在将所有Python unicode对象作为绑定参数传入之前将其编码为“string”。

同义词/ DBLINK反射¶

When using reflection with Table objects, the dialect can optionally search for tables indicated by synonyms, either in local or remote schemas or accessed over DBLINK, by passing the flag oracle_resolve_synonyms=True as a keyword argument to the Table construct:

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

设置此标志时，不仅在ALL_TABLES视图中搜索给定的名称（如some_table），还会在ALL_SYNONYMS如果同义词位于并指向DBLINK，则oracle方言知道如何使用DBLINK语法（例如@dblink）查找表的信息。

oracle_resolve_synonyms is accepted wherever reflection arguments are accepted, including methods such as MetaData.reflect() and Inspector.get_columns().

如果同义词没有被使用，这个标志应该被禁用。

日期时间兼容性¶

Oracle没有称为DATETIME的数据类型，它只有DATE，它实际上可以存储日期和时间值。出于这个原因，Oracle方言提供了一个类型oracle.DATE，它是DateTime的子类。这种类型没有特殊的行为，仅作为这种类型的“标记”出现；此外，当数据库列被反映并且类型被报告为DATE时，将使用支持时间的oracle.DATE类型。

Oracle表选项¶

CREATE TABLE短语通过与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的UPPERCASE类型都可以从顶级方言导入，无论它们源自sqlalchemy.types还是来自当地方言：

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

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

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

基础：sqlalchemy.types.LargeBinary

__初始化__ T0> （ T1> 长度=无 T2> ） T3> ¶ T4>

inherited from the __init__() method of LargeBinary

构建一个LargeBinary类型。

参数：	length¶ – optional, a length for the column for use in DDL statements, for those binary types that accept a length, such as the MySQL BLOB type.

class sqlalchemy.dialects.oracle。 DATE （ timezone = False ） T5> ¶ T6>

Bases: sqlalchemy.types.DateTime

提供oracle DATE类型。

这种类型没有特殊的Python行为，除了它的子类types.DateTime；这是为了适应Oracle DATE类型支持时间值的事实。

版本0.9.4中的新功能

__初始化__ T0> （ T1> 时区=假 T2> ） T3> ¶ T4>

继承自 DateTime的 __init__()

构建一个新的DateTime。

参数：	时区 ¶ - 布尔值。如果为True，并由后端支持，则会产生'TIMESTAMP WITH TIMEZONE'。对于不支持时区感知时间戳的后端，不起作用。

class sqlalchemy.dialects.oracle。 DOUBLE_PRECISION （ precision = None， scale = None，asdecimal = None ） ¶

基础：sqlalchemy.types.Numeric

class sqlalchemy.dialects.oracle。 INTERVAL （ day_precision =无， second_precision =无 T5> ） T6> ¶ T7>

基础：sqlalchemy.types.TypeEngine

__init__(day_precision=None, second_precision=None)¶

构建一个INTERVAL。

请注意，目前仅支持DAY TO SECOND间隔。这是由于缺少对可用DBAPI（cx_oracle和zxjdbc）中YEAR TO MONTH间隔的支持。

参数：	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)¶

基础：sqlalchemy.types.Text

__init__(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False)¶

inherited from the __init__() method of String

创建一个字符串保存类型。

参数：

length¶ – optional, a length for the column for use in DDL and CAST expressions. 如果没有发布CREATE TABLE，可以安全地省略。某些数据库可能需要用于DDL的length，并且在CREATE TABLE DDL时会引发异常如果包含没有长度的VARCHAR，则发布。值是否被解释为字节或字符是数据库特定的。 整理 ¶ - 可选，用于DDL和CAST表达式的列级别排序规则。使用SQLite，MySQL和Postgresql支持的COLLATE关键字进行呈现。例如。： >>> from sqlalchemy import cast, select, String >>> print select([cast('some string', String(collation='utf8'))]) SELECT CAST(:param_1 AS VARCHAR COLLATE utf8) AS anon_1 0.8版新增：增加了对所有字符串类型的COLLATE支持。 convert_unicode ¶ - 当设置为True时，String类型将假定输入将作为Python unicode对象传递，结果以Python unicode对象。If the DBAPI in use does not support Python unicode (which is fewer and fewer these days), SQLAlchemy will encode/decode the value, using the value of the encoding parameter passed to create_engine() as the encoding. 当使用本地支持Python unicode对象的DBAPI时，通常不需要设置此标志。For columns that are explicitly intended to store non-ASCII data, the Unicode or UnicodeText types should be used regardless, which feature the same behavior of convert_unicode but also indicate an underlying column type that directly supports unicode, such as NVARCHAR. 对于非常罕见的情况，Python unicode将由本地支持Python unicode的后端由SQLAlchemy编码/解码，值force可以在这里传递，这将导致无条件地使用SQLAlchemy的编码/解码服务。 unicode_error ¶ - 可选，一种用于处理Unicode转换错误的方法。行为与标准库的string.decode()函数的errors关键字参数相同。该标志要求将convert_unicode设置为force - 否则，SQLAlchemy不保证处理unicode转换的任务。请注意，此标志为已经返回unicode对象的后端（大多数DBAPI所执行的操作）的后端操作增加了显着的性能开销。此标志只能用作从不同或损坏编码的列中读取字符串的最后手段。

class sqlalchemy.dialects.oracle。 NUMBER （ precision = None， scale = None，asdecimal = None ） ¶

基础：sqlalchemy.types.Numeric，sqlalchemy.types.Integer

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

基础：sqlalchemy.types.Text

__init__(length=None, collation=None, convert_unicode=False, unicode_error=None, _warn_on_bytestring=False)¶

inherited from the __init__() method of String

创建一个字符串保存类型。

参数：

length¶ – optional, a length for the column for use in DDL and CAST expressions. 如果没有发布CREATE TABLE，可以安全地省略。某些数据库可能需要用于DDL的length，并且在CREATE TABLE DDL时会引发异常如果包含没有长度的VARCHAR，则发布。值是否被解释为字节或字符是数据库特定的。 整理 ¶ - 可选，用于DDL和CAST表达式的列级别排序规则。使用SQLite，MySQL和Postgresql支持的COLLATE关键字进行呈现。例如。： >>> from sqlalchemy import cast, select, String >>> print select([cast('some string', String(collation='utf8'))]) SELECT CAST(:param_1 AS VARCHAR COLLATE utf8) AS anon_1 0.8版新增：增加了对所有字符串类型的COLLATE支持。 convert_unicode ¶ - 当设置为True时，String类型将假定输入将作为Python unicode对象传递，结果以Python unicode对象。If the DBAPI in use does not support Python unicode (which is fewer and fewer these days), SQLAlchemy will encode/decode the value, using the value of the encoding parameter passed to create_engine() as the encoding. 当使用本地支持Python unicode对象的DBAPI时，通常不需要设置此标志。For columns that are explicitly intended to store non-ASCII data, the Unicode or UnicodeText types should be used regardless, which feature the same behavior of convert_unicode but also indicate an underlying column type that directly supports unicode, such as NVARCHAR. 对于非常罕见的情况，Python unicode将由本地支持Python unicode的后端由SQLAlchemy编码/解码，值force可以在这里传递，这将导致无条件地使用SQLAlchemy的编码/解码服务。 unicode_error ¶ - 可选，一种用于处理Unicode转换错误的方法。行为与标准库的string.decode()函数的errors关键字参数相同。该标志要求将convert_unicode设置为force - 否则，SQLAlchemy不保证处理unicode转换的任务。请注意，此标志为已经返回unicode对象的后端（大多数DBAPI所执行的操作）的后端操作增加了显着的性能开销。此标志只能用作从不同或损坏编码的列中读取字符串的最后手段。

class sqlalchemy.dialects.oracle。 RAW 长度=无 ） T5> ¶ T6>

基础：sqlalchemy.types._Binary

cx_Oracle ¶ T0>

通过cx-Oracle驱动程序支持Oracle数据库。

oracle+cx_oracle://user:pass@host:port/dbname[?key=value&key=value...]

engine = create_engine("oracle+cx_oracle://dsn", coerce_to_unicode=True)

from sqlalchemy import text, Unicode
result = conn.execute(
    text("select username from user").columns(username=Unicode))

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

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

zxjdbc ¶ T0>

通过zxJDBC为Jython驱动程序支持Oracle数据库。

oracle+zxjdbc://user:pass@host/dbname