## Tcl8.6.17/Tk8.6.17 Documentation > tdbc::mysql Package Commands, version 1.1.12 > tdbc_mysql

### 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::mysql — TDBC-MYSQL の橋渡し　　　　TDBC-MYSQL bridge
  構文 SYNOPSIS
  説明 DESCRIPTION
  接続指示項目 CONNECTION OPTIONS
    -host hostname
    -port number
    -socket path
    -user name
    -passwd password
    -password password
    -database name
    -db name
    -interactive flag
    -ssl_ca string
    -ssl_capath string
    -ssl_cert string
    -ssl_cipher string
    -ssl_key string
  用例 EXAMPLES
  追加の接続手段 ADDITIONAL CONNECTION METHODS
    $connection evaldirect sqlStatement
  SEE ALSO
  KEYWORDS
  著作権 COPYRIGHT

### NAME

tdbc::mysql — TDBC-MYSQL の橋渡し　　　　TDBC-MYSQL bridge

### 構文 SYNOPSIS

package require tdbc::mysql 1.0

tdbc::mysql::connection create db ?-option value...?
tdbc::mysql::connection new ?-option value...?

tdbc::mysql::datasources ?-system|-user?

tdbc::mysql::drivers

tdbc::mysql::datasource command driverName ?keyword-value?...

### 説明 DESCRIPTION

tdbc::mysql 駆動譜は Tcl DataBase Connectivity (TDBC) に準拠する基礎データ対話機能を提供して Tcl 記述譜を MySQL 基礎データに接続できるようにする｡　　　　　　 The tdbc::mysql driver provides a database interface that conforms to Tcl DataBase Connectivity (TDBC) and allows a Tcl script to connect to a MySQL database.

MYSQL 基礎データへの接続は､tdbc::mysql::connection create を起動し､それに与えるべき基礎データ操作子と -option-value 対の群との名前を渡して､確立される｡利用できる指示項目は下の CONNECTION OPTIONS に列挙されている｡ 別法としては､tdbc::mysql::connection new が､基礎データ接続を生成するために使用でき､名前は自動的に代入される｡tdbc::mysql::connection new からの返り値は操作子の為に選ばれた名前である｡　　　　　　 Connection to an MYSQL database is established by invoking tdbc::mysql::connection create, passing it the name to give the database handle and a set of -option-value pairs. The available options are enumerated under CONNECTION OPTIONS below. As an alternative, tdbc::mysql::connection new may be used to create a database connection with an automatically assigned name. The return value from tdbc::mysql::connection new is the name that was chosen for the connection handle.

tdbc::mysql::connection create の副作用は､新しく基礎データへの接続を生成する事である｡ 基礎データを操作する為の接続を如何に使用するかの詳細については､tdbc::connection(n) を参照されたい｡　　　　　　 The side effect of tdbc::mysql::connection create is to create a new database connection.. See tdbc::connection(n) for the details of how to use the connection to manipulate a database.

### 接続指示項目 CONNECTION OPTIONS

tdbc::mysql::connection create 対象命令は全ての TDBC 駆動譜に共通に -encoding と -isolation と -readonly と -timeout 指示項目を運営している｡-encoding 指示項目は､文字符号が utf-8 でない限り失敗する ; 基礎データ接続は常に任意のユニコード文字を転換することができる UTF-8 文字符号を使う｡ -readonly 指定は 0 でなければならない､理由は MySQL は読出し専用接続は提供していないから｡　　　　　 The tdbc::mysql::connection create object command supports the -encoding, -isolation, -readonly and -timeout options common to all TDBC drivers. The -encoding option will always fail unless the encoding is utf-8; the database connection always uses UTF-8 encoding to be able to transfer arbitrary Unicode characters. The -readonly option must be 0, because MySQL does not offer read-only connections.

更に､次の指示項目が認識される: 　　　　　　　 In addition, the following options are recognized:

-host hostname
  hostname によって指定される主人に接続する｡ この指定は､接続の最初の生成に設定しなければならない; 接続した後には変更できない｡ 無為設定は局所主人である｡　　　　　　 Connects to the host specified by hostname. This option must be set on the initial creation of the connection; it cannot be changed after connecting. Default is to connect to the local host.

-port number
  番号number によって指定されたポートを聴く MySQL 中央集中処理装置を接続する｡ この指定は､接続した後には変更することができない｡ これは､host が指定されそれがlocalhostでない場合にのみ使われる｡　　　　　　 Connects to a MySQL server listening on the port specified by number. This option may not be changed after connecting. It is used only when host is specified and is not localhost.

-socket path
  Unix socket 又はpathにより指定されるパイプを聴く MySQL 中央集中処理装置を接続する｡ この指定は､接続した後には変更することができない｡ これは､host が指定されそれがlocalhostでない場合にのみ使われる｡　　　　　　 Connects to a MySQL server listening on the Unix socket or named pipe specified by path . This option may not be changed after connecting. It is used only when -host is not specified or is localhost.

-user name
  MySQL 中央集中処理装置に使用者の名前としてname を与える｡ 無為設定は現在の使用者識別番号である｡　　　　　　 Presents name as the user name to the MySQL server. Default is the current user ID.

-passwd password

-password password
  これ等二つの指示項目は類義語である｡ これらは与えられたpasswordを使用者の暗証番号としてMySQL 中央集中処理装置に与える｡ 無為設定は暗証番号を与えない｡　　　　　　 These two options are synonymous. They present the given password as the user's password to the MySQL server. Default is not to present a password.

-database name

-db name
  これ等二つの指示項目は類義語である｡ これらは､MySQL 中央集中処理装置内で､無為設定の基礎データ名としてnameを与える｡ もし指定されていない場合､無為設定の基礎データは現在の使用者が使用される｡　　　　　　 These two options are synonymous. They present the given name as the name of the default database to use in MySQL queries. If not specified, the default database for the current user is used.

-interactive flag
  旗印flagの値は論理値でなければならない｡もしそれが論理真値 (又はそれと等価な何か)である場合､無為設定の制限時間は対話使用者に設定され､そうでない場合､無為設定の制限時間はバッチ使用者に設定される｡ この指示項目は最初の接続にのみ意味を持つ｡ MySQL 接続上で configure手段を使う時は､望ましい制限時間時を設定する為に -timeout 指示項目を使用されたい｡　　　　　　 The flag value must be a Boolean value. If it is true (or any equivalent), the default timeout is set for an interactive user, otherwise, the default timeout is set for a batch user. This option is meaningful only on initial connection. When using the configure method on a MySQL connection use the -timeout option to set the timeout desired.

-ssl_ca string

-ssl_capath string

-ssl_cert string

-ssl_cipher string

-ssl_key string
  これら五つの指示項目は､与えられた文字列引数に､認証者と､認証者捜査経路と､SSLサーバ証明書と､転送暗号と､SSL 検索用語を設定する｡ これらの指定は基礎データへの初期接続にのみ指定され､既存の接続への configure 手段では指定されない｡無為設定はSSLでは使用しない｡ 訳註 (SSL) Secure Sockets Layer データを暗号化してやり取りする手順 　　　　　　　 These five options set the certificate authority, certificate authority search path, SSL certificate, transfer cipher, and SSL key to the given string arguments. These options may be specified only on initial connection to a database, not in the configure method of an existing connection. Default is not to use SSL.

### 用例 EXAMPLES

    tdbc::mysql::connection -user joe -passwd sesame -db joes_database

局部ホスト上で､MySQL 中央集中処理装置に､無為設定の接続手段を使用し､接続して､使用者識別番号に 'joe' ､暗証番号 'sesame' を与える｡ 'joes_database' を無為設定の名前に使用する｡　　　　　　 Connects to the MySQL server on the local host using the default connection method, presenting user ID 'joe' and password 'sesame'. Uses 'joes_database' as the default database name.

### 追加の接続手段 ADDITIONAL CONNECTION METHODS

tdbc::connection(n) 対象上の通常の手段に加えて､MySQL 基礎データへの接続は､一つの追加的手段を運営している｡　　　　　 In addition to the usual methods on the tdbc::connection(n) object, connections to a MySQL database support one additional method:

$connection evaldirect sqlStatement
  この手段は､与えられた sqlStatement を取り､固有の SQL 符号命令を MySQL として解釈実行し､準備することなくそれを評価する｡この命令文は変数置換を含むことができない｡ 結果の群は､文字列として書式化された結果の行の欄のリストになっている仔リストのリストとして返される｡ 註意すべきは､文字列書式化は MySQL によってなされ､ Tcl によってではないので､従って浮動小数の外観の如く詳細が異なっていることがある｡ この命令はどこであれ､通常の準備､又は､準備呼出し手段が正しく動く様な処では推奨されない｡ その様になっているので､CREATE DATABASE や CREATE PROCEDURE の様な MySQL の用意された命令文の API 内で実装されたのではないデータ管理言語命令文は実行されるかもしれない｡　　　　　　　 This method takes the given sqlStatement and interprets as MySQL native SQL code and evaluates it without preparing it. The statement may not contain variable substitutions. The result set is returned as a list of lists, with each sublist being the list of columns of a result row formatted as character strings. Note that the string formatting is done by MySQL and not by Tcl, so details like the appearance of floating point numbers may differ. This command is not recommended for anything where the usual prepare or preparecall methods work correctly. It is provided so that data management language statements that are not implemented in MySQL's prepared statement API, such as CREATE DATABASE or CREATE PROCEDURE, can be executed.

### SEE ALSO

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

### KEYWORDS

TDBC, SQL, MySQL, database, connectivity, connection

### 著作権 COPYRIGHT

Copyright (c) 2009 by Kevin B. Kenny.