## Tcl8.6.17/Tk8.6.17 Documentation > tdbc::sqlite3 Package Commands, version 1.1.12 > tdbc_sqlite3

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

### NAME

tdbc::sqlite3 — SQLite3 基礎データ管理の為のTDBC 駆動譜　　　　　TDBC driver for the SQLite3 database manager

### 構文 SYNOPSIS

package require tdbc::sqlite3 1.0

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

### 説明 DESCRIPTION

tdbc::sqlite3 駆動譜は Tcl DataBase Connectivity (TDBC) に準拠する基礎データ対話機能を提供して Tcl 記述譜を SQLite3 基礎データに接続できるようにする｡ それは又､Tcl 内で基礎データ駆動譜を如何にして書くかの動作する用例を提供するので､駆動譜の著作者は更なる開発の為の開始点を得る｡　　　　　　　 The tdbc::sqlite3 driver provides a database interface that conforms to Tcl DataBase Connectivity (TDBC) and allows a Tcl script to connect to a SQLite3 database. It is also provided as a worked example of how to write a database driver in Tcl, so that driver authors have a starting point for further development.

SQLite3 基礎データへの接続は､接続操作子として使われる文字列に基礎データのファイル名を続けて渡して tdbc::sqlite3::connection create を起動して､確立する｡ tdbc::sqlite3::connection create の副作用は､基礎データへの新しい接続を生成する事である｡ 別法としては､自動的に代入された名前を使って tdbc::sqlite::connection new が基礎データ接続を生成することに使用できる｡ 基礎データを操作する為の接続を如何に使用するかの詳細については､tdbc::connection(n) を参照されたい｡　　　　　　　 Connection to a SQLite3 database is established by invoking tdbc::sqlite3::connection create, passing it a string to be used as the connection handle followed by the file name of the database. The side effect of tdbc::sqlite3::connection create is to create a new database connection.. As an alternative, tdbc::sqlite::connection new may be used to create a database connection with an automatically assigned name. The return value from tdbc::sqlite::connection new is the name that was chosen for the connection handle. See tdbc::connection(n) for the details of how to use the connection to manipulate a database.

### 構成設定指示項目 CONFIGURATION OPTIONS

tdbc::sqlite3::connection create と 結果の接続の構成設定手段の両方で､標準的な構成設定指定の -encoding と -isolation と -readonly と -timeout は全て認識される｡　　　　　　 The standard configuration options -encoding, -isolation, -readonly and -timeout are all recognized, both on tdbc::sqlite3::connection create and on the configure method of the resulting connection.

SQLite3 基礎データの文字符号化は､常に広く知られているように､-encoding 指示は utf-8 のみを符号化として受付け､常に符号化として utf-8 を返す｡ 実際の文字符号化は､新しい基礎データを生成する時に､ SQLite3 PRAGMA 宣言を使い設定する｡　　　　　　　 Since the encoding of a SQLite3 database is always well known, the -encoding option accepts only utf-8 as an encoding and always returns utf-8 for an encoding. The actual encoding may be set using a SQLite3 PRAGMA statement when creating a new database.

分離水準の readuncommitted と serializable だけが実装されている｡ 他の分離水準はserializable となる様に促されている｡　　　　　　 Only the isolation levels readuncommitted and serializable are implemented. Other isolation levels are promoted to serializable.

読出し専用 -readonly 旗徴は実装されてない｡他のどの値も不都合を報告するが､偽値 論理値は応答なしで受容れられる｡ The -readonly flag is not implemented. A false boolean value is accepted silently, while any other value reports an error.

大文字小文字保持 -keepcase 旗徴は特別であり､基礎データの汎データを取出す為の種々の方法の中で表と列の名前が如何に報告されるか制御する｡無為設定では､旗徴は零であり､即ち､表と列の名前は全て小文字で報告される｡そうでない場合､表と列の名前は基礎データ内で定義された通りに報告される｡ The -keepcase flag is special and controls how table and column names are reported in the various methods to retrieve database metadata. By default the flag is zero, i.e. table and column names are reported all lower case. Otherwise, table and column names are reported as defined in the database.

### 瑕疵 BUGS

もし､結果となる群の中の欄内でどれかの欄の名前が重複していると､-as dicts の結果は重複している最右欄を除いて全て失われる｡ この制限は､全ての返り欄の名前の重複を確実に除く為に SELECT 宣言に適当な AS 項を追加する事により､回避することができる｡ この駆動譜の C 実装を使用した瑕疵訂正が計画されており､それにより出来栄えが改善されるであろう｡　　　　　　 If any column name is not unique among the columns in a result set, the results of -as dicts returns will be missing all but the rightmost of the duplicated columns. This limitation can be worked around by adding appropriate AS clauses to SELECT statements to ensure that all returned column names are unique. Plans are to fix this bug by using a C implementation of the driver, which will also improve performance significantly.

### SEE ALSO

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

### KEYWORDS

TDBC, SQL, SQLite3, database, connectivity, connection

### 著作権 COPYRIGHT

Copyright (c) 2008 by Kevin B. Kenny.