RU/dbConnect - Revision history

XNeroX at 06:20, 7 February 2025

2025-02-07T06:20:49Z

← Older revision		Revision as of 06:20, 7 February 2025
Line 19:		Line 19:
	*** '''port''': Порт хоста. Например: ''port=1234'' (опционально, по умолчанию используется стандартный порт MySQL)		*** '''port''': Порт хоста. Например: ''port=1234'' (опционально, по умолчанию используется стандартный порт MySQL)
	*** '''unix_socket''': Unix-сокет или именованный канал для использования (опционально)		*** '''unix_socket''': Unix-сокет или именованный канал для использования (опционально)
			*** '''charset''': Сообщает серверу кодировку базы данных отличную от стандартной. Например: ''charset=utf8'' (опционально)

	===Необязательные параметры===		===Необязательные параметры===
Line 30:		Line 31:
	**'''tag''' (Значение по умолчанию "tag<nowiki>=</nowiki>script"). Строка, которая помогает идентифицировать активность этого соединения в [[Server_Commands#debugdb\|файле журнала отладки базы данных]].		**'''tag''' (Значение по умолчанию "tag<nowiki>=</nowiki>script"). Строка, которая помогает идентифицировать активность этого соединения в [[Server_Commands#debugdb\|файле журнала отладки базы данных]].
	**'''suppress''' разделенный запятыми список кодов ошибок, которые следует игнорировать. (например "suppress<nowiki>=</nowiki>1062,1169").		**'''suppress''' разделенный запятыми список кодов ошибок, которые следует игнорировать. (например "suppress<nowiki>=</nowiki>1062,1169").
	**'''~~charset~~''' ~~если вы хотите общаться~~ с ~~сервером~~, ~~используя набор символов~~, ~~отличный от набора~~ по умолчанию, ~~вам необходимо указать, какой~~ из ~~них. (например "charset<nowiki>=</nowiki>utf8"~~). ~~(используется только~~ в ~~MySQL)~~		**'''multi_statements''' Использование нескольких операторов (разделенных точкой с запятой) в одном запросе. Используйте dbPrepareString при построении запроса с несколькими операторами, чтобы снизить риск SQL-инъекций.
			**'''queue''' Имя очереди, которую необходимо использовать. (Значение по умолчанию для SQLite - «sqlite», для MySQL по умолчанию - строка хоста из аргумента host). Асинхронные запросы к базе данных в одной очереди обрабатываются по порядку, один за другим. Можно использовать любое имя.
			**'''use_ssl''' Использование SSL, может быть установлено значение 1 или 0, игнорируется для SQLite

	===Возвращает===		===Возвращает===

Linkbrt: /* Пример */

2020-02-18T19:15:28Z

Пример

← Older revision		Revision as of 19:15, 18 February 2020
Line 36:		Line 36:

	==Пример==		==Пример==
	~~This example opens a connection to a~~ SQLite ~~database file in the current resource~~		В этом примере открывается соединение с файлом базы данных SQLite в текущем ресурсе.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "sqlite", "file.db" )		test_db = dbConnect( "sqlite", "file.db" )
	</syntaxhighlight>		</syntaxhighlight>

	~~This example opens a connection to a~~ SQLite ~~database file in another resource~~		В этом примере открывается соединение с файлом базы данных SQLite в другом ресурсе.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "sqlite", ":resname/file.db" )		test_db = dbConnect( "sqlite", ":resname/file.db" )
	</syntaxhighlight>		</syntaxhighlight>

	~~This example opens a connection to a~~ SQLite ~~database file in the global databases directory~~		В этом примере открывается соединение с файлом базы данных SQLite в каталоге глобальных баз данных.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "sqlite", ":/file.db" )		test_db = dbConnect( "sqlite", ":/file.db" )
	</syntaxhighlight>		</syntaxhighlight>

	~~This example opens a connection to a~~ SQLite ~~database file in a sub directory of the global databases directory~~		В этом примере открывается соединение с файлом базы данных SQLite в подкаталоге каталога глобальных баз данных.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )		test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )
	</syntaxhighlight>		</syntaxhighlight>

	~~This example opens a connection to a~~ MySQL ~~database called 'frank' at server~~ ip 1.2.3.4 ~~and allows the connection to be shared~~. ~~Note that changing the database or other connection dependent settings affect all connections that are shared~~.		В этом примере открывается соединение с базой данных MySQL с именем «frank» на сервере с ip 1.2.3.4 используя набор символов utf8 и с разрешением совместного использования соединения. Обратите внимание, что изменение базы данных или других зависимых от подключения настроек влияет на все общие подключения.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4", "username", "password", "share=1" )		test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4", "username", "password", "share=1" )
	</syntaxhighlight>		</syntaxhighlight>

	~~This example opens a connection to a~~ SQLite ~~database is disallows sharing of the connection~~		В этом примере открывается соединение с базой данных SQLite, запрещается совместное использование соединения.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )		test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )
			</syntaxhighlight>

			В этом примере выводится сообщение об отладке, установлено ли соединение с базой данных SQLite или нет
			<syntaxhighlight lang="lua">
			test_db = dbConnect( "sqlite", "file.db" )

			if test_db then
			outputDebugString( "Связь с базой данных была успешно установлена." )
			else
			outputDebugString( "Не удалось установить соединение с базой данных." )
			end
			</syntaxhighlight>

			В следующем примере показано, как можно найти общий ресурс для операций с базой данных с экспортированными функциями (запросить и выполнить):
			<syntaxhighlight lang="lua">
			function connect()
			DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )
			if (not DBConnection) then
			outputDebugString("Ошибка: не удалось установить соединение с сервером базы данных MySQL")
			else
			outputDebugString("Успешно: Соединено с сервером базы данных MySQL")
			end
			end

			addEventHandler("onResourceStart",resourceRoot, connect)

			function query(...)
			local queryHandle = dbQuery(DBConnection, ...)
			if (not queryHandle) then
			return nil
			end
			local rows = dbPoll(queryHandle, -1)
			return rows
			end

			function execute(...)
			local queryHandle = dbQuery(DBConnection, ...)
			local result, numRows = dbPoll(queryHandle, -1)
			return numRows
			end

			function getDBConnection()
			return DBConnection
			end
	</syntaxhighlight>		</syntaxhighlight>

Linkbrt: /* Необязательные параметры */

2020-02-18T18:49:58Z

Необязательные параметры

← Older revision		Revision as of 18:49, 18 February 2020
Line 23:		Line 23:
	*'''username:''' Обычно требуется для MySQL, игнорируется для SQLite		*'''username:''' Обычно требуется для MySQL, игнорируется для SQLite
	*'''password:''' Обычно требуется для MySQL, игнорируется для SQLite		*'''password:''' Обычно требуется для MySQL, игнорируется для SQLite
	*'''options :''' ~~List of key~~=~~value pairs separated by semicolons~~. ~~Supported keys are~~:		*'''options :''' Список ключей = Пары значений, которые разделены точкой с запятой. Поддерживаемые ключи:
	**'''share''' ~~which can be set to~~ 0 or 1. (~~Default value for~~ SQLite is "share=1", ~~for~~ MySQL is "share=0"). ~~When set to~~ 1, ~~the connection is shared and will be used by other calls to~~ dbConnect ~~with the same host string~~. ~~This is usually a good thing for~~ SQLite ~~connections~~, ~~but not so good for~~ MySQL ~~unless care is taken~~.		**'''share''' может быть установлен на 0 или 1. (Значение по умолчанию для SQLite это "share=1", а для MySQL это "share=0"). Когда установлено значение 1, подключение становится общим и это будет использоваться другими вызовами dbConnect с той же строкой хоста. Это обычно хорошо для SQLite подключений, но не очень хорошо для MySQL если не соблюдать осторожность.
	**'''batch''' ~~which can be set to~~ 0 or 1. (~~Default is~~ "batch=1"). ~~When set to~~ 1, ~~queries called in the same frame are automatically batched together which can significantly speed up inserts~~/~~updates~~. ~~The downside is you lose control of the feature that is used to achieve batching~~ (~~For~~ SQLite ~~it is transactions~~, ~~for~~ MySQL ~~it is~~ autocommit ~~mode~~). ~~Therefore~~, ~~if you use transactions~~, ~~lock tables or control~~ autocommit ~~yourself~~, ~~you may want to disable this feature~~.		**'''batch''' может быть установлен на 0 ил 1. (По умолчанию "batch=1"). Когда установлено на 1, запросы, вызываемые в одном кадре, автоматически объединяются, что может значительно ускорить вставку / обновление. Недостатком является то, что вы теряете контроль над функцией, которая используется для достижения пакетной обработки (для SQLite это транзакции, для MySQL это режим autocommit). Следовательно, если вы используете транзакции, блокируете таблицы или управляйте режимом autocommit самостоятельно, вы можете отключить эту функцию.
	**'''autoreconnect''' ~~which can be set to~~ 0 or 1. (~~Default value~~ "autoreconnect=1"). ~~When set to~~ 1, ~~dropped connections will automatically be reconnected~~. ~~Note that session variables~~, ~~user variables~~, ~~table locks and temporary tables will be reset because of the reconnection~~. ~~So if you use these fancy features~~, ~~you will need to turn autoreconnect off and cope with dropped connections some other way~~.		**'''autoreconnect''' может быть установлен на 0 или 1. (По умолчанию "autoreconnect=1"). Когда установлено на 1, разорванные подключения будут автоматически переподключены. Обратите внимание, что переменные сеанса (вкл. SET NAMES), пользовательские переменные, закрытые и временные таблицы будут сброшены из-за переподключения. Так что, если вы используете необычные функции, вам нужно будет отключить автоподключение и справиться с разорванными соединениями другим способом.
	**'''log''' ~~which can be set to~~ 0 or 1. (~~Default value~~ "log~~<nowiki>~~=~~</nowiki>~~1"). ~~When set to~~ 0, ~~activity from this connection will not be recorded in the~~ [[Server_Commands#debugdb\|~~database debug log file~~]].		**'''log''' может быть установлен на 0 или 1. (Значение по умолчанию "log=1"). Когда установлено на 0, активность с данного подключения не будет записана в [[Server_Commands#debugdb\|файл журнала отладки базы данных.]].
	**'''tag''' (~~Default value~~ "tag<nowiki>=</nowiki>script"). ~~A string which helps identify activity from this connection in the~~ [[Server_Commands#debugdb\|~~database debug log file~~]].		**'''tag''' (Значение по умолчанию "tag<nowiki>=</nowiki>script"). Строка, которая помогает идентифицировать активность этого соединения в [[Server_Commands#debugdb\|файле журнала отладки базы данных]].
	**'''suppress''' ~~A comma separated list of error codes to ignore~~. (~~eg.~~ "suppress<nowiki>=</nowiki>1062,1169").		**'''suppress''' разделенный запятыми список кодов ошибок, которые следует игнорировать. (например "suppress<nowiki>=</nowiki>1062,1169").
	**'''charset''' ~~If you want to communicate with the server using a character set different from the default~~, ~~you'll need to indicate which one~~. (~~eg.~~ "charset<nowiki>=</nowiki>utf8"). (~~used only in~~ MySQL)		**'''charset''' если вы хотите общаться с сервером, используя набор символов, отличный от набора по умолчанию, вам необходимо указать, какой из них. (например "charset<nowiki>=</nowiki>utf8"). (используется только в MySQL)

	===Возвращает===		===Возвращает===

Dmitry7zip: Some translation

2015-06-19T19:36:13Z

Some translation

← Older revision		Revision as of 19:36, 19 June 2015
Line 3:		Line 3:
	{{RU/Server function}}		{{RU/Server function}}
	Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].		Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].
	{{RU/Note\|~~Connecting and disconnecting many times can have a performance impact on the server~~. ~~For optimal performance it is recommended that you use~~ dbConnect ~~only once when the resource starts~~, ~~and share the connection element with the whole script~~.}}		{{RU/Note\|Подсоединение и отсоединение много раз может негативно повлиять на производительность сервера. Для оптимальной производительности рекомендуется использовать dbConnect только один раз, когда ресурс запускается, и использовать это соединение во всем ресурсе.}}
	{{RU/Note\|dbConnect на Linux MySQL требует libmysqlclient.so.15 (для MTA 1.3), или libmysqlclient.so.16 (для MTA 1.4)}}		{{RU/Note\|dbConnect на Linux MySQL требует libmysqlclient.so.15 (для MTA 1.3), или libmysqlclient.so.16 (для MTA 1.4)}}
	==Синтаксис==		==Синтаксис==
Line 12:		Line 12:
	===Обязательные параметры===		===Обязательные параметры===
	*'''databaseType:''' Тип базы данных. Может быть ''sqlite'' или ''mysql''		*'''databaseType:''' Тип базы данных. Может быть ''sqlite'' или ''mysql''
	*'''host:''' ~~The target to connect to~~. ~~The format of this depends on the database type~~.		*'''host:''' Цель для подключения. Формат зависит от типа базы данных.
	** Для SQLite ~~it is a~~ [[filepath]] ~~to a~~ SQLite ~~database file~~. ~~If the filepath starts with~~ ":/" ~~then the server's global databases directory is used~~. ~~The file will be created if it does not exist~~.		** Для SQLite это [[filepath\|путь]] к файлу SQLite базы данных. Если путь начинается с ":/" будет использоваться глобальный каталог баз данных сервера. Файл будет создан, если он не существует.
	** Для MySQL ~~it is a list of key~~=~~value pairs separated by semicolons~~. ~~Supported keys are~~:		** Для MySQL это список формата ключ=значение, разделенный точкой с запятой. Поддерживаются следующие ключи:
	*** '''dbname''': ~~Name of the database to use e.g~~. ''dbname=test''		*** '''dbname''': Имя базы данных для использования. Например: ''dbname=test''
	*** '''host''': ~~Host address e.g~~. ''host=127.0.0.1''		*** '''host''': Адрес хоста. Например: ''host=127.0.0.1''
	*** '''port''': ~~Host port e.g~~. ''port=1234'' (~~optional~~, ~~defaults to standard~~ MySQL ~~port if not used~~)		*** '''port''': Порт хоста. Например: ''port=1234'' (опционально, по умолчанию используется стандартный порт MySQL)
	*** '''unix_socket''': Unix ~~socket or named pipe to use~~ (~~optional, thankgoodness~~)		*** '''unix_socket''': Unix-сокет или именованный канал для использования (опционально)

	===Необязательные параметры===		===Необязательные параметры===

Strix at 21:44, 12 March 2015

2015-03-12T21:44:44Z

← Older revision		Revision as of 21:44, 12 March 2015
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Translate~~\|RU~~}}		{{Translate}}
	{{RU/Server function}}		{{RU/Server function}}
	Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].		Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].

Strix at 21:44, 12 March 2015

2015-03-12T21:44:22Z

← Older revision		Revision as of 21:44, 12 March 2015
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{Translate\|RU}}
	{{RU/Server function}}		{{RU/Server function}}
	Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].		Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery\|dbQuery]]. Для отключения используйте [[RU/destroyElement\|destroyElement]].

Strix at 00:27, 27 December 2014

2014-12-27T00:27:09Z

← Older revision		Revision as of 00:27, 27 December 2014
Line 19:		Line 19:
	*** '''unix_socket''': Unix socket or named pipe to use (optional, thankgoodness)		*** '''unix_socket''': Unix socket or named pipe to use (optional, thankgoodness)

	===~~Optional Arguments~~===		===Необязательные параметры===
	*'''username:''' Обычно требуется для MySQL, игнорируется для SQLite		*'''username:''' Обычно требуется для MySQL, игнорируется для SQLite
	*'''password:''' Обычно требуется для MySQL, игнорируется для SQLite		*'''password:''' Обычно требуется для MySQL, игнорируется для SQLite
Line 75:		Line 75:
	==Смотрите также==		==Смотрите также==
	{{RU/Registry_functions}}		{{RU/Registry_functions}}

			[[en:dbConnect]]

Strix: Created page with "NOTOC {{RU/Server function}} Эта функция открывает подключение к базе данных и возвращает элемент, которы..."

2014-12-27T00:24:33Z

Created page with "__NOTOC__ {{RU/Server function}} Эта функция открывает подключение к базе данных и возвращает элемент, которы..."

New page

__NOTOC__
{{RU/Server function}}
Эта функция открывает подключение к базе данных и возвращает элемент, который может быть использован с [[RU/dbQuery|dbQuery]]. Для отключения используйте [[RU/destroyElement|destroyElement]].
{{RU/Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}
{{RU/Note|dbConnect на Linux MySQL требует libmysqlclient.so.15 (для MTA 1.3), или libmysqlclient.so.16 (для MTA 1.4)}}
==Синтаксис==
<syntaxhighlight lang="lua">
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )
</syntaxhighlight>
{{RU/OOP||[[Connection]]}}
===Обязательные параметры===
*'''databaseType:''' Тип базы данных. Может быть ''sqlite'' или ''mysql''
*'''host:''' The target to connect to. The format of this depends on the database type.
** Для SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.
** Для MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:
*** '''dbname''': Name of the database to use e.g. ''dbname=test''
*** '''host''': Host address e.g. ''host=127.0.0.1''
*** '''port''': Host port e.g. ''port=1234'' (optional, defaults to standard MySQL port if not used)
*** '''unix_socket''': Unix socket or named pipe to use (optional, thankgoodness)

===Optional Arguments===
*'''username:''' Обычно требуется для MySQL, игнорируется для SQLite
*'''password:''' Обычно требуется для MySQL, игнорируется для SQLite
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables, user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").
**'''charset''' If you want to communicate with the server using a character set different from the default, you'll need to indicate which one. (eg. "charset<nowiki>=</nowiki>utf8"). (used only in MySQL)

===Возвращает===
Возвращает элемент подключения к базе данных, если проблем нет, в противном случае ''false''.

==Пример==
This example opens a connection to a SQLite database file in the current resource
<syntaxhighlight lang="lua">
test_db = dbConnect( "sqlite", "file.db" )
</syntaxhighlight>

This example opens a connection to a SQLite database file in another resource
<syntaxhighlight lang="lua">
test_db = dbConnect( "sqlite", ":resname/file.db" )
</syntaxhighlight>

This example opens a connection to a SQLite database file in the global databases directory
<syntaxhighlight lang="lua">
test_db = dbConnect( "sqlite", ":/file.db" )
</syntaxhighlight>

This example opens a connection to a SQLite database file in a sub directory of the global databases directory
<syntaxhighlight lang="lua">
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )
</syntaxhighlight>

This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.
<syntaxhighlight lang="lua">
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4", "username", "password", "share=1" )
</syntaxhighlight>

This example opens a connection to a SQLite database is disallows sharing of the connection
<syntaxhighlight lang="lua">
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )
</syntaxhighlight>

==Требования==
{{RU/Requirements|1.1.1-9.03328|n/a}}

==Список изменений==
{{ChangelogHeader}}
{{ChangelogItem|1.3.1-9.04817|Добавлены опции 'log', 'tag' и 'suppress'}}
{{ChangelogItem|1.3.5-9.06386|Добавлена опция 'charset'}}

==Смотрите также==
{{RU/Registry_functions}}

RU/dbConnect - Revision history

XNeroX at 06:20, 7 February 2025

Linkbrt: /* Пример */

Linkbrt: /* Необязательные параметры */

Dmitry7zip: Some translation

Strix at 21:44, 12 March 2015

Strix at 21:44, 12 March 2015

Strix at 00:27, 27 December 2014

Strix: Created page with "__NOTOC__ {{RU/Server function}} Эта функция открывает подключение к базе данных и возвращает элемент, которы..."

Strix: Created page with "NOTOC {{RU/Server function}} Эта функция открывает подключение к базе данных и возвращает элемент, которы..."