You can specify the parameters in the following tables for
Connector/ODBC when configuring a DSN. Users on Windows can use
the Options and Advanced panels when configuring a DSN to set
these parameters; see the table for information on which options
relate to which fields and checkboxes.Unix と Mac OS X
ではパラメータ名と値を、DSN
構成のキーワードおよび値のペアとして使用してください。あるいは、SQLDriverConnect()
呼び出しにある InConnectionString
引数内で、これらのパラメータを設定することもできます。
| パラメータ | デフォルト値 | コメント |
user |
ODBC (Windows) | MySQL の接続に使用されるユーザ名 |
server |
localhost |
MySQL サーバのホスト名 |
database |
デフォルトのデータベース | |
option |
0 | Connector/ODBC の動作を指定するオプション。下記参照。 |
port |
3306 |
server が localhost
出ない場合に、TCP/IP ポートが使用 |
stmt |
MySQL への接続時に実行されるステートメント | |
password |
server 上の user
アカウントのパスワード |
|
socket |
server が localhost
の場合に接続される Unix ソケット
ファイルもしくは Windows
の名前付きパイプ |
option 引数は、クライアントの ODBC
への適合が 100% でない場合に、Connector/ODBC
にその旨を告知します。Windows
では通常、接続スクリーンのチェックボックスをトグルしてオプションを選択しますが、option
引数でオプションを選択することもできます。次のオプションは、Connector/ODBC
接続スクリーンに表示される順序でリストされています
:
| 値 | Windows チェックボックス | 概要 |
| 1 | Don't Optimized Column Width | Connector/ODBC が実際のカラムの幅をリターンするのを、クライアントは許容できない。 |
| 2 | Return Matching Rows | MySQL が、影響下にある行の真の値をリターンするのを、クライアントは許容できない。このフラッグがセットされる場合、MySQL は代わりに 「found rows」 をリターンする。これには MySQL 3.21.14 以降が必要になる。 |
| 4 | Trace Driver Calls To myodbc.log | デバッグ ログを、Windows では
C:\myodbc.log 、Unix 形式では
/tmp/myodbc.log に作成する。 |
| 8 | Allow Big Results | 結果とパラメータにパケット制限を設定しない。 |
| 16 | Don't Prompt Upon Connect | ドライバが希望しても、質問をプロンプトしない。 |
| 32 | Enable Dynamic Cursor | 動的カーソルのサポートを有効または無効にする( Connector/ODBC 2.50. では利用不可 ) 。 |
| 64 | Ignore # in Table Name |
db_name.tbl_name.col_name
でのデータベース名の使用を無視。 |
| 128 | User Manager Cursors | ODBC マネージャー カーソルの使用を強制実行する ( 実験用 ) 。 |
| 256 | Don't Use Set Locale | 拡張されたフェッチの使用を無効にする ( 実験用 ) 。 |
| 512 | Pad Char To Full Length |
CHAR
カラムを最長のカラム幅にパッドする。 |
| 1024 | Return Table Names for SQLDescribeCol |
SQLDescribeCol()
が完全に修飾されたカラム名をリターンする。 |
| 2048 | Use Compressed Protocol | 圧縮されたクライアント / サーバ プロトコルを使用。 |
| 4096 | Ignore Space After Function Names | ファンクション名の後と、‘(’
の前にあるスペースを無視するようサーバに通達
( PowerBuilder に必要 )
。これですべてのファンクション名がキーワードになる。 |
| 8192 | Force Use of Named Pipes | 名前つきパイプで、NT で起動している mysqld に接続する。 |
| 16384 | Change BIGINT Columns to Int |
BIGINT カラムを INT
カラムに変更 (
ある種のアプリケーションは
BIGINT を処理できない ) 。 |
| 32768 | No Catalog (exp) |
SQLTables から、'user' を
Table_qualifier および
Table_owner
とてしてリターンする ( 実験用 )。 |
| 65536 | Read Options From my.cnf
|
my.cnf の [client] および
[odbc]
グループからパラメータを読み取る。 |
| 131072 | Safe | 追加のセイフティー チェックを加える ( 本来なら必要ない ) 。 |
| 262144 | Disable transaction | トランザクションを無効にする。 |
| 524288 | Save queries to myodbc.sql
|
c:\myodbc.sql(/tmp/myodbc.sql)
ファイルへのクエリのロギングを有効にする(
デバッグ モードでのみ有効 ) 。 |
| 1048576 | Don't Cache Result ( forward only cursors ) | 結果をドライバ内でローカルにキャッシュせず、サーバ
(mysql_use_result())
から読み取る。これは forward-only
カーソルのみで使用できる。このオプションは、大きなテーブルを扱っていて、ドライバが全結果セットをキャッシュするのを防ぎたい時に重要になる。 |
| 2097152 | Force Use Of Forward Only Cursors |
Forward-onlyカーソルの使用を強制行使する。アプリケーションがデフォルトのスタティック
/
動的カーソルの種類をセットし、それが非キャッシュの結果セットを使おうとする場合は、このオプションが
forward-only カーソルの挙動を保証する。 |
| 4194304 | Enable auto-reconnect. | 自動再接続の機能を有効にする。不完全なトランザクションの間の自動再接続は破損の原因となるため、トランザクションとこのオプションを併用しないこと。自動再接続での接続は、元来の設定や環境を受け継いでいないので注意。このオプションは、Connector/ODBC 3.5.13. で有効。 |
| 8388608 | Flag Auto Is Null | このオプションはセットの際に、接続が
SQL_AUTO_IS_NULL オプションを 1
にセットする起因なる。標準の挙動が無効になるが、古いアプリケーションを有効にして、AUTO_INCREMENT
値を正確に指定することもある。詳細は、
を参照。このオプションは Connector/ODBC
3.5.13. で有効。 |
複数のオプションを選択するには、それらの値を加算します。例えば、option
を 12 (4+8)
にセットすると、パケット制限なしでデバッグすることができます。
次のテーブルは、様々な構成で推奨する
option 値の例のリストです :
| 構成 | オプション値 |
| Microsoft Access、Visual Basic | 3 |
| ドライバ トレース生成 ( デバッグ モード ) | 4 |
| Microsoft Access ( DELETE クエリが改善されたもの ) | 35 |
| 行数過多の大規模なテーブル | 2049 |
| Sybase PowerBuilder | 135168 |
| クエリ ログ生成 ( デバッグ モード ) | 524288 |
| クエリ ログと同時にドライバ トレースを生成 ( デバッグ モード ) | 524292 |
| 非キャッシュ結果を伴う大規模なテーブル | 3145731 |
