Spec-Zone.ru › Tcl/Tk

tdbc_sqlite3

Имя

tdbc::sqlite3 — Драйвер TDBC для менеджера баз данных SQLite3

Синтаксис

package require tdbc::sqlite3 1.0
tdbc::sqlite3::connection create db fileName ?-option value...?

Описание

Драйвер tdbc::sqlite3 предоставляет интерфейс к базе данных, соответствующий Tcl DataBase Connectivity (TDBC), и позволяет скрипту Tcl подключаться к базе данных SQLite3. Он также предоставляется как пример работы по написанию драйвера базы данных на Tcl, чтобы авторы драйверов имели отправную точку для дальнейшего развития.

Подключение к базе данных SQLite3 осуществляется вызовом tdbc::sqlite3::connection create, передав ему строку, используемую в качестве дескриптора соединения, а затем имя файла базы данных. Побочным эффектом tdbc::sqlite3::connection create является создание нового соединения с базой данных. В качестве альтернативы можно использовать tdbc::sqlite::connection new для создания соединения с базой данных с автоматически присвоенным именем. Возвращаемое значение tdbc::sqlite::connection new — это имя, выбранное для дескриптора соединения. Смотрите tdbc::connection(n) для получения подробной информации о том, как использовать соединение для управления базой данных.

Параметры конфигурации

Стандартные параметры конфигурации -encoding, -isolation, -readonly и -timeout распознаются как в tdbc::sqlite3::connection create, так и в методе configure полученного соединения.

Поскольку кодировка базы данных SQLite3 всегда известна, параметр -encoding принимает только utf-8 в качестве кодировки и всегда возвращает utf-8 для кодировки. Фактическая кодировка может быть установлена с помощью оператора SQLite3 PRAGMA при создании новой базы данных.

Реализованы только уровни изоляции readuncommitted и serializable. Другие уровни изоляции повышаются до serializable.

Флаг -readonly не реализован. -readonly 0 принимается молча, в то время как -readonly 1 вызывает ошибку.

Ошибки

Если имя столбца не уникально среди столбцов в наборе результатов, результаты -as dicts будут пропускать все, кроме правого из дублирующихся столбцов. Это ограничение можно обойти, добавив соответствующие клаузы AS в операторы SELECT, чтобы гарантировать уникальность всех возвращаемых имён столбцов. Планируется исправить эту ошибку с помощью реализации драйвера на C, что также значительно улучшит производительность.

См. также

tdbc, tdbc::connection, tdbc::resultset, tdbc::statement

Авторские права

Copyright (c) 2008 by Kevin B. Kenny.

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TdbcsqliteCmd/tdbc_sqlite3.htm

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API