Oracle¶

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

• python-oracledb

Поведение автоинкремента¶

Объекты таблиц SQLAlchemy, включающие целочисленные первичные ключи, обычно предполагаются с «автоинкрементным» поведением, то есть они могут генерировать собственные значения первичного ключа при INSERT. Для использования в Oracle доступны два варианта: использование столбцов IDENTITY (только для Oracle 12 и выше) или ассоциация SEQUENCE со столбцом.

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', start=1), primary_key=True),
      Column(...), ...
)

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

Уровень изоляции транзакций / автокоммит¶

База данных Oracle поддерживает режимы изоляции «READ COMMITTED» и «SERIALIZABLE». Уровень изоляции AUTOCOMMIT также поддерживается диалектом cx_Oracle.

Чтобы задать параметры выполнения по каждому соединению, выполните следующие действия:

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

Для READ COMMITTED и SERIALIZABLE диалект Oracle устанавливает уровень на уровне сессии с помощью ALTER SESSION, который возвращается к настройке по умолчанию, когда соединение возвращается в пул соединений.

Допустимые значения для isolation_level включают:

• READ COMMITTED

• AUTOCOMMIT

• SERIALIZABLE

Идентификатор Корпус¶

В Oracle словарь данных представляет все нечувствительные к регистру имена идентификаторов с помощью текста UPPERCASE. С другой стороны, SQLAlchemy считает имя идентификатора в нижнем регистре нечувствительным к регистру. Диалект Oracle преобразует все нечувствительные к регистру идентификаторы в эти два формата и обратно во время взаимодействия на уровне схемы, например, при отражении таблиц и индексов. Использование имени UPPERCASE на стороне SQLAlchemy указывает на то, что идентификатор чувствителен к регистру, и SQLAlchemy заключит имя в кавычки - это приведет к несоответствию с данными словаря данных, полученными от Oracle, поэтому, если имена идентификаторов не были действительно созданы как чувствительные к регистру (т.е. с использованием имен в кавычках), на стороне SQLAlchemy следует использовать все имена в нижнем регистре.

Максимальная длина идентификатора¶

Oracle изменила максимальную длину идентификатора по умолчанию, начиная с версии Oracle Server 12.2. До этой версии длина составляла 30, а в версии 12.2 и выше она теперь равна 128. Это изменение влияет на SQLAlchemy в области генерируемых имен SQL-меток, а также на генерацию имен ограничений, особенно в том случае, когда используется функция соглашения об именовании ограничений, описанная в Настройка соглашений об именовании ограничений.

Чтобы помочь с этим и другими изменениями, 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)

Максимальная длина идентификатора играет важную роль как при генерации анонимизированных SQL-меток в операторах SELECT, так и, что более важно, при генерации имен ограничений на основе соглашения об именовании. Именно в этой области в 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)

Однако при length=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)

Таким образом, приложения, использующие версии SQLAlchemy до 1.4 на сервере Oracle версии 12.2 или выше, могут столкнуться со сценарием миграции базы данных, в котором требуется «DROP CONSTRAINT» для имени, которое ранее было сгенерировано с меньшей длиной. Такая миграция будет неудачной, если длина идентификатора будет изменена без предварительной корректировки имени индекса или ограничения. Таким приложениям настоятельно рекомендуется использовать create_engine.max_identifier_length, чтобы сохранить контроль над генерацией усеченных имен, а также полностью проверять и тестировать все миграции баз данных в промежуточной среде при изменении этого значения, чтобы убедиться, что влияние этого изменения было смягчено.

Поддержка ОГРАНИЧЕНИЙ/ОТКАЗОВ/ФЕТЧ¶

Такие методы, как Select.limit() и Select.offset(), используют синтаксис FETCH FIRST N ROW / OFFSET N ROWS, предполагая Oracle 12c или выше, и предполагая, что оператор SELECT не встроен в составной оператор, такой как UNION. Этот синтаксис также доступен непосредственно при использовании метода Select.fetch().

Использование FETCH FIRST / OFFSET может быть отключено на любой версии Oracle путем передачи enable_offset_fetch=False в create_engine(), что заставит использовать «унаследованный» режим, использующий оконные функции. Этот режим также выбирается автоматически при использовании версии Oracle до 12c.

При использовании унаследованного режима или когда оператор Select с ограничением/смещением встроен в составной оператор, используется эмулированный подход для LIMIT / OFFSET на основе оконных функций, который включает создание подзапроса с использованием ROW_NUMBER, что чревато проблемами производительности, а также проблемами построения SQL для сложных операторов. Тем не менее, этот подход поддерживается всеми версиями Oracle. См. примечания ниже.

поддержка возврата¶

База данных Oracle полностью поддерживает RETURNING для операторов INSERT, UPDATE и DELETE, которые вызываются с одним набором связанных параметров (то есть, оператор в стиле cursor.execute(); SQLAlchemy обычно не поддерживает RETURNING с операторами executemany). Также может быть возвращено несколько строк.

НА КАСКАДЕ ОБНОВЛЕНИЙ¶

Oracle не имеет встроенной функциональности ON UPDATE CASCADE. Решение на основе триггеров доступно по адресу https://asktom.oracle.com/tkyte/update_cascade/index.html .

При использовании SQLAlchemy ORM имеет ограниченные возможности для ручного выпуска каскадных обновлений - укажите объекты ForeignKey, используя ключевые аргументы «deferrable=True, initially=“deferred“», и укажите «passive_updates=False» для каждого отношения().

Совместимость с Oracle 8¶

Когда Oracle 8 обнаружен, диалект внутренне настраивает себя на следующее поведение:

• флаг use_ansi устанавливается в False. Это имеет эффект преобразования всех фраз JOIN в предложение WHERE, а в случае LEFT OUTER JOIN используется оператор (+) Oracle.

• типы данных NVARCHAR2 и NCLOB больше не генерируются как DDL, когда используется Unicode - вместо них выдаются VARCHAR2 и CLOB. Это происходит потому, что эти типы, похоже, не работают корректно в Oracle 8, хотя они доступны. Типы NVARCHAR и NCLOB всегда будут генерировать NVARCHAR2 и NCLOB.

Синоним/Отражение¶

При использовании отражения с объектами Table диалект может опционально искать таблицы, обозначенные синонимами, в локальных или удаленных схемах или доступных через 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 может возвращать информацию об ограничениях foreign key, unique и CHECK, а также об индексах таблиц.

Необработанная информация об этих ограничениях может быть получена с помощью Inspector.get_foreign_keys(), Inspector.get_unique_constraints(), Inspector.get_check_constraints() и Inspector.get_indexes().

При использовании отражения на уровне Table, Table также будет включать эти ограничения.

Обратите внимание на следующие предостережения:

• При использовании метода Inspector.get_check_constraints() Oracle создает специальное ограничение «IS NOT NULL» для столбцов, в которых указано «NOT NULL». По умолчанию это ограничение не возвращается; чтобы включить ограничение «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 ограничение UNIQUE не будет доступно как объект UniqueConstraint, поскольку Oracle в большинстве случаев отражает уникальные ограничения с индексом UNIQUE (исключением, по-видимому, является случай, когда два или более уникальных ограничений представляют одни и те же столбцы); вместо этого Table будет представлять их с помощью Index с установленным флагом unique=True.

• Oracle создает неявный индекс для первичного ключа таблицы; этот индекс исключается из всех результатов индексации.

• список столбцов, отражаемых для индекса, не будет включать имена столбцов, начинающиеся с SYS_NC.

Имена таблиц с табличными пространствами SYSTEM/SYSAUX¶

Методы 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+cx_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, все типы UPPERCASE, которые, как известно, действительны в 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¶

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.BFILE (sqlalchemy.types.LargeBinary)

method sqlalchemy.dialects.oracle.BFILE.__init__(length: Optional[int] = None)¶

наследуется от sqlalchemy.types.LargeBinary.__init__ метода LargeBinary

Создайте тип LargeBinary.

Параметры:

length – опционально, длина столбца для использования в DDL-запросах, для тех бинарных типов, которые принимают длину, например, тип MySQL BLOB.

class sqlalchemy.dialects.oracle.BINARY_DOUBLE¶

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.BINARY_DOUBLE (sqlalchemy.types.Double)

method sqlalchemy.dialects.oracle.BINARY_DOUBLE.__init__(precision: Optional[int] = None, asdecimal: bool = False, decimal_return_scale: Optional[int] = None)¶

наследуется от sqlalchemy.types.Float.__init__ метода Float

Постройте поплавок.

Параметры:

• precision – числовая точность для использования в DDL CREATE TABLE. Бэкенды должны пытаться обеспечить, чтобы эта точность указывала на число цифр для общего типа данных Float. … примечание:: Для бэкенда Oracle параметр Float.precision не принимается при рендеринге DDL, поскольку Oracle не поддерживает точность float, указанную как число десятичных знаков. Вместо этого используйте специфический для Oracle тип данных FLOAT и укажите параметр FLOAT.binary_precision. Это новое в версии 2.0 SQLAlchemy. Чтобы создать независимый от базы данных Float, отдельно указывающий двоичную точность для Oracle, используйте TypeEngine.with_variant() следующим образом: from sqlalchemy import Column from sqlalchemy import Float from sqlalchemy.dialects import oracle Column( «float_data», Float(5).with_variant(oracle.FLOAT(binary_precision=16), «oracle») )

• asdecimal – тот же флаг, что и у Numeric, но по умолчанию имеет значение False. Обратите внимание, что установка этого флага в значение True приводит к преобразованию с плавающей точкой.

• decimal_return_scale – Масштаб по умолчанию, используемый при преобразовании значений с плавающей точкой в десятичные числа Python. Значения с плавающей точкой обычно намного длиннее из-за неточности десятичных дробей, а большинство типов баз данных с плавающей точкой не имеют понятия «масштаб», поэтому по умолчанию тип float ищет первые десять десятичных знаков при преобразовании. Указание этого значения отменяет эту длину. Обратите внимание, что типы MySQL float, которые включают «масштаб», будут использовать «масштаб» по умолчанию для decimal_return_scale, если не указано иное.

class sqlalchemy.dialects.oracle.BINARY_FLOAT¶

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.BINARY_FLOAT (sqlalchemy.types.Float)

method sqlalchemy.dialects.oracle.BINARY_FLOAT.__init__(precision: Optional[int] = None, asdecimal: bool = False, decimal_return_scale: Optional[int] = None)¶

наследуется от sqlalchemy.types.Float.__init__ метода Float

Постройте поплавок.

Параметры:

• precision – числовая точность для использования в DDL CREATE TABLE. Бэкенды должны пытаться обеспечить, чтобы эта точность указывала на число цифр для общего типа данных Float. … примечание:: Для бэкенда Oracle параметр Float.precision не принимается при рендеринге DDL, поскольку Oracle не поддерживает точность float, указанную как число десятичных знаков. Вместо этого используйте специфический для Oracle тип данных FLOAT и укажите параметр FLOAT.binary_precision. Это новое в версии 2.0 SQLAlchemy. Чтобы создать независимый от базы данных Float, отдельно указывающий двоичную точность для Oracle, используйте TypeEngine.with_variant() следующим образом: from sqlalchemy import Column from sqlalchemy import Float from sqlalchemy.dialects import oracle Column( «float_data», Float(5).with_variant(oracle.FLOAT(binary_precision=16), «oracle») )

• asdecimal – тот же флаг, что и у Numeric, но по умолчанию имеет значение False. Обратите внимание, что установка этого флага в значение True приводит к преобразованию с плавающей точкой.

• decimal_return_scale – Масштаб по умолчанию, используемый при преобразовании значений с плавающей точкой в десятичные числа Python. Значения с плавающей точкой обычно намного длиннее из-за неточности десятичных дробей, а большинство типов баз данных с плавающей точкой не имеют понятия «масштаб», поэтому по умолчанию тип float ищет первые десять десятичных знаков при преобразовании. Указание этого значения отменяет эту длину. Обратите внимание, что типы MySQL float, которые включают «масштаб», будут использовать «масштаб» по умолчанию для decimal_return_scale, если не указано иное.

class sqlalchemy.dialects.oracle.DATE¶

Укажите тип oracle DATE.

Этот тип не имеет особого поведения в Python, за исключением того, что он является подклассом DateTime; это сделано для того, чтобы соответствовать тому факту, что тип Oracle DATE поддерживает значение времени.

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.DATE (sqlalchemy.dialects.oracle.types._OracleDateLiteralRender, sqlalchemy.types.DateTime)

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

наследуется от sqlalchemy.types.DateTime.__init__ метода DateTime

Создайте новый DateTime.

Параметры:

timezone – булево. Указывает, что тип datetime должен включать поддержку временных зон, если она доступна только для базового типа удержания даты/времени. Рекомендуется использовать непосредственно тип данных TIMESTAMP при использовании этого флага, так как некоторые базы данных включают отдельные общие типы даты/времени, отличные от типа данных TIMESTAMP с поддержкой временных зон, например, Oracle.

class sqlalchemy.dialects.oracle.FLOAT¶

Oracle FLOAT.

Это то же самое, что и FLOAT, за исключением того, что принимается специфический для Oracle параметр FLOAT.binary_precision, а параметр Float.precision не принимается.

Типы Oracle FLOAT указывают точность в терминах «двоичной точности», которая по умолчанию равна 126. Для типа REAL это значение равно 63. Этот параметр не имеет четкого соответствия определенному количеству десятичных знаков, но приблизительно эквивалентен желаемому количеству десятичных знаков, деленному на 0,3103.

Добавлено в версии 2.0.

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.FLOAT (sqlalchemy.types.FLOAT)

method sqlalchemy.dialects.oracle.FLOAT.__init__(binary_precision=None, asdecimal=False, decimal_return_scale=None)¶

Постройте FLOAT

Параметры:

• binary_precision – Значение двоичной точности Oracle для отображения в DDL. Оно может быть приближено к количеству десятичных знаков по формуле «десятичная точность = 0,30103 * двоичная точность». Значение по умолчанию, используемое Oracle для FLOAT / DOUBLE PRECISION, равно 126.

• asdecimal – См. Float.asdecimal

• decimal_return_scale – См. Float.decimal_return_scale

class sqlalchemy.dialects.oracle.INTERVAL¶

Members

__init__()

Классная подпись

класс 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¶

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.NCLOB (sqlalchemy.types.Text)

method sqlalchemy.dialects.oracle.NCLOB.__init__(length: Optional[int] = None, collation: Optional[str] = None)¶

наследуется от sqlalchemy.types.String.__init__ метода String

Создайте тип, удерживающий строку.

Параметры:

• length – необязательный, длина столбца для использования в выражениях DDL и CAST. Может быть опущена, если не будет выдаваться CREATE TABLE. Некоторые базы данных могут требовать length для использования в DDL, и будут выдавать исключение при выдаче CREATE TABLE DDL, если включена VARCHAR без длины. Интерпретируется ли значение как байты или как символы, зависит от конкретной базы данных.

• collation – Необязательно, collation на уровне столбцов для использования в выражениях DDL и CAST. Используется ключевое слово COLLATE, поддерживаемое SQLite, MySQL и PostgreSQL. Например: … sourcecode:: pycon+sql >>> from sqlalchemy import cast, select, String >>> print(select(cast(„some string“, String(collation=“utf8“)))) {printsql}SELECT CAST(:param_1 AS VARCHAR COLLATE utf8) AS anon_1 … примечание:: В большинстве случаев для Unicode или UnicodeText следует использовать типы данных Column, которые предполагают хранение неасксичных данных. Эти типы данных гарантируют, что в базе данных используются правильные типы.

attribute sqlalchemy.dialects.oracle..sqlalchemy.dialects.oracle.NVARCHAR2¶

alias of NVARCHAR

class sqlalchemy.dialects.oracle.NUMBER¶

Классная подпись

класс sqlalchemy.dialects.oracle.NUMBER (sqlalchemy.types.Numeric, sqlalchemy.types.Integer)

class sqlalchemy.dialects.oracle.LONG¶

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.LONG (sqlalchemy.types.Text)

method sqlalchemy.dialects.oracle.LONG.__init__(length: Optional[int] = None, collation: Optional[str] = None)¶

наследуется от sqlalchemy.types.String.__init__ метода String

Создайте тип, удерживающий строку.

Параметры:

• length – необязательный, длина столбца для использования в выражениях DDL и CAST. Может быть опущена, если не будет выдаваться CREATE TABLE. Некоторые базы данных могут требовать length для использования в DDL, и будут выдавать исключение при выдаче CREATE TABLE DDL, если включена VARCHAR без длины. Интерпретируется ли значение как байты или как символы, зависит от конкретной базы данных.

• collation – Необязательно, collation на уровне столбцов для использования в выражениях DDL и CAST. Используется ключевое слово COLLATE, поддерживаемое SQLite, MySQL и PostgreSQL. Например: … sourcecode:: pycon+sql >>> from sqlalchemy import cast, select, String >>> print(select(cast(„some string“, String(collation=“utf8“)))) {printsql}SELECT CAST(:param_1 AS VARCHAR COLLATE utf8) AS anon_1 … примечание:: В большинстве случаев для Unicode или UnicodeText следует использовать типы данных Column, которые предполагают хранение неасксичных данных. Эти типы данных гарантируют, что в базе данных используются правильные типы.

class sqlalchemy.dialects.oracle.RAW¶

Классная подпись

класс sqlalchemy.dialects.oracle.RAW (sqlalchemy.types._Binary)

class sqlalchemy.dialects.oracle.ROWID¶

Тип Oracle ROWID.

При использовании в функции cast() или аналогичной, генерируется ROWID.

Классная подпись

класс sqlalchemy.dialects.oracle.ROWID (sqlalchemy.types.TypeEngine)

class sqlalchemy.dialects.oracle.TIMESTAMP¶

Oracle реализация TIMESTAMP, которая поддерживает дополнительные режимы, специфичные для Oracle

Добавлено в версии 2.0.

Members

__init__()

Классная подпись

класс sqlalchemy.dialects.oracle.TIMESTAMP (sqlalchemy.types.TIMESTAMP)

method sqlalchemy.dialects.oracle.TIMESTAMP.__init__(timezone: bool = False, local_timezone: bool = False)¶

Создайте новый TIMESTAMP.

Параметры:

• timezone – булево. Указывает, что тип TIMESTAMP должен использовать тип данных Oracle TIMESTAMP WITH TIME ZONE.

• local_timezone – булево. Указывает, что тип TIMESTAMP должен использовать тип данных Oracle TIMESTAMP WITH LOCAL TIME ZONE.

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_decimal=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+cx_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+cx_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)

python-oracledb¶

Support for the Oracle database via the python-oracledb driver.

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

python-oracledb выпущен компанией Oracle для замены драйвера cx_Oracle. Он полностью совместим с cx_Oracle и имеет как «тонкий» клиентский режим, не требующий зависимостей, так и «толстый» режим, использующий клиентский интерфейс Oracle так же, как и cx_Oracle.

engine = sa.create_engine("oracle+oracledb://...", thick_mode={
    "lib_dir": "/path/to/oracle/client/lib", "driver_name": "my-app"
})