tdbc_mysql

пакет require tdbc::mysql 1.0
tdbc::mysql::connection create db ?-option значение...?
tdbc::mysql::connection new ?-option значение...?
tdbc::mysql::datasources ?-system|-user?
tdbc::mysql::drivers
tdbc::mysql::datasource команда имя_драйвера ?ключевое_слово-значение?...

Описание

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

Подключение к базе данных MYSQL осуществляется вызовом tdbc::mysql::connection create, передавая ему имя для обращения к базе данных и набор пар -option-value. Доступные опции перечислены в разделе ПАРАМЕТРЫ ПОДКЛЮЧЕНИЯ ниже. В качестве альтернативы можно использовать tdbc::mysql::connection new для создания подключения к базе данных с автоматически присвоенным именем. Возвращаемое значение из tdbc::mysql::connection new — это имя, выбранное для дескриптора соединения.

Побочным эффектом tdbc::mysql::connection create является создание нового подключения к базе данных.. Смотрите tdbc::connection(n) для получения подробностей о том, как использовать подключение для управления базой данных.

Параметры подключения

Команда объекта tdbc::mysql::connection create поддерживает параметры -encoding, -isolation, -readonly и -timeout, общие для всех драйверов TDBC. Параметр -encoding всегда завершится ошибкой, если кодировка не utf-8; подключение к базе данных всегда использует кодировку UTF-8, чтобы иметь возможность передавать произвольные символы Юникода. Параметр -readonly должен быть 0, так как MySQL не предлагает подключений только для чтения.

Кроме того, распознаются следующие параметры:

-host имя_хоста: Подключается к хосту, указанному в имя_хоста. Этот параметр должен быть задан при первоначальном создании подключения; его нельзя изменить после подключения. По умолчанию подключается к локальному хосту.
-port число: Подключается к серверу MySQL, слушающему на порте, указанном в число. Этот параметр нельзя изменить после подключения. Он используется только тогда, когда указан хост, и он не равен localhost.
-socket путь: Подключается к серверу MySQL, слушающему на Unix-сокете или именованной трубе, указанном в путь. Этот параметр нельзя изменить после подключения. Он используется только тогда, когда -host не указан или равен localhost.
-user имя: Представляет имя в качестве имени пользователя серверу MySQL. По умолчанию используется текущий идентификатор пользователя.
-passwd пароль
-password пароль: Эти два параметра являются синонимами. Они представляют заданный пароль как пароль пользователя серверу MySQL. По умолчанию пароль не предоставляется.
-database имя
-db имя: Эти два параметра являются синонимами. Они представляют заданное имя как имя базы данных по умолчанию для использования в запросах MySQL. Если не указано, используется база данных по умолчанию для текущего пользователя.
-interactive флаг: Значение флаг должно быть булевым. Если оно true (или любое эквивалентное значение), устанавливается значение таймаута по умолчанию для интерактивного пользователя, в противном случае — для пакетного пользователя. Этот параметр имеет значение только при первоначальном подключении. При использовании метода configure для подключения MySQL используйте параметр -timeout для установки желаемого значения таймаута.
-ssl_ca строка
-ssl_capath строка
-ssl_cert строка
-ssl_cipher строка
-ssl_key строка: Эти пять параметров устанавливают уполномочивающую организацию, путь поиска сертификата уполномочивающей организации, сертификат SSL, шифр передачи и ключ SSL в заданных строковых аргументах. Эти параметры могут быть указаны только при первоначальном подключении к базе данных, а не в методе configure существующего подключения. По умолчанию SSL не используется.

Примеры

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

Подключается к серверу MySQL на локальном хосте с использованием метода подключения по умолчанию, представляя идентификатор пользователя «joe» и пароль «sesame». Использует «joes_database» в качестве имени базы данных по умолчанию.

Дополнительные методы подключения

Помимо обычных методов объекта tdbc::connection(n), подключения к базе данных MySQL поддерживают один дополнительный метод:

$connection evaldirect sqlЗапрос: Этот метод принимает заданный sqlЗапрос и интерпретирует его как родной SQL-код MySQL, оценивает его без подготовки. Запрос не должен содержать подстановки переменных. Результат возвращается в виде списка списков, где каждый подсписок представляет собой список столбцов строки результата, отформатированные как строки. Обратите внимание, что форматирование строк выполняется MySQL, а не Tcl, поэтому такие детали, как отображение чисел с плавающей запятой, могут отличаться. Эта команда не рекомендуется для случаев, когда обычные методы prepare или preparecall работают корректно. Она предоставляется для того, чтобы можно было выполнять операторы языка управления данными, не реализованные в API подготовленных запросов MySQL, такие как CREATE DATABASE или CREATE PROCEDURE.

Смотрите также

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

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

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TdbcmysqlCmd/tdbc_mysql.htm