Модуль работы с БД - История изменений

Sidminik: /* client.requireFromDatabase() */

2025-12-30T05:35:30Z

client.requireFromDatabase()

← Предыдущая версия		Версия от 05:35, 30 декабря 2025
Строка 84:		Строка 84:

	===<code>client.requireFromDatabase()</code>===		===<code>client.requireFromDatabase()</code>===
	Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.		Выполняет запрос и срабатывает как <code>require()</code>, но код модуля получает из БД. В основном используется в планировщике.

	<syntaxhighlight lang="javascript">		<syntaxhighlight lang="javascript">
	requireFromDatabase(name: string): Promise<any>		requireFromDatabase(name: string): Promise<any>
	</syntaxhighlight>		</syntaxhighlight>

Sidminik: /* client.executeScalar() */

2025-12-30T05:35:10Z

client.executeScalar()

← Предыдущая версия		Версия от 05:35, 30 декабря 2025
Строка 76:		Строка 76:
	===<code>client.executeScalar()</code>===		===<code>client.executeScalar()</code>===
	Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.		Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.

			<code>query: string</code> текст SQL запроса <code>parameters?: QueryParameter[]</code> массив параметров запроса, в тексте запроса можно ставить символ <code>?</code>, на его место будет подставляться правильно отформатированный параметр

	<syntaxhighlight lang="javascript">		<syntaxhighlight lang="javascript">
	query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр


	executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>		executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>
	</syntaxhighlight>		</syntaxhighlight>

Sidminik: /* client.execute() */

2025-12-30T05:34:28Z

client.execute()

← Предыдущая версия		Версия от 05:34, 30 декабря 2025
Строка 46:		Строка 46:
	Выполняет запрос. В зависимости от типа БД ответ может различаться.		Выполняет запрос. В зависимости от типа БД ответ может различаться.

	IExecuteResult это интерфейс для максимально общего описания возвращаемых значений. Содержит массив записей и метаданные.		<code>IExecuteResult</code> это интерфейс для максимально общего описания возвращаемых значений. Содержит массив записей и метаданные.

	<syntaxhighlight lang="javascript">		<syntaxhighlight lang="javascript">
Строка 68:		Строка 68:
	</syntaxhighlight>		</syntaxhighlight>

	query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр		<code>query: string</code> текст SQL запроса <code>parameters?: QueryParameter[]</code> массив параметров запроса, в тексте запроса можно ставить символ <code>?</code>, на его место будет подставляться правильно отформатированный параметр

	<syntaxhighlight lang="javascript">		<syntaxhighlight lang="javascript">

Sidminik: /* client.execute() */

2025-12-30T05:33:15Z

client.execute()

← Предыдущая версия		Версия от 05:33, 30 декабря 2025
Строка 70:		Строка 70:
	query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр		query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр

			<syntaxhighlight lang="javascript">
	execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>		execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>
			</syntaxhighlight>

	===<code>client.executeScalar()</code>===		===<code>client.executeScalar()</code>===

Sidminik: /* Начало работы */

2025-12-30T05:32:54Z

Начало работы

← Предыдущая версия		Версия от 05:32, 30 декабря 2025
Строка 39:		Строка 39:
	Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.		Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.

			<syntaxhighlight lang="javascript">
	async disconnect(): Promise<void>		async disconnect(): Promise<void>
			</syntaxhighlight>

	===<code>client.execute()</code>===		===<code>client.execute()</code>===
Строка 46:		Строка 48:
	IExecuteResult это интерфейс для максимально общего описания возвращаемых значений. Содержит массив записей и метаданные.		IExecuteResult это интерфейс для максимально общего описания возвращаемых значений. Содержит массив записей и метаданные.

			<syntaxhighlight lang="javascript">
	interface IExecuteResult {		interface IExecuteResult {
	records: Array<{ [columnName: string]: any }>;		records: Array<{ [columnName: string]: any }>;
Строка 53:		Строка 55:
	}		}
	}		}
			</syntaxhighlight>

	Тип получаемых параметров:		Тип получаемых параметров:

			<syntaxhighlight lang="javascript">
	type QueryParameter = null \|		type QueryParameter = null \|
	number \|		number \|
Строка 61:		Строка 66:
	Date \|		Date \|
	{ type: 'date' \| 'time'; value: Date }		{ type: 'date' \| 'time'; value: Date }
			</syntaxhighlight>

	query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр		query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр

Строка 69:		Строка 76:
	Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.		Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.

			<syntaxhighlight lang="javascript">
	query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр		query: string текст SQL запроса parameters?: QueryParameter[] массив параметров запроса, в тексте запроса можно ставить символ ?, на его место будет подставляться правильно отформатированный параметр


	executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>		executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>
			</syntaxhighlight>

	===<code>client.requireFromDatabase()</code>===		===<code>client.requireFromDatabase()</code>===
	Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.		Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.

			<syntaxhighlight lang="javascript">
	requireFromDatabase(name: string): Promise<any>		requireFromDatabase(name: string): Promise<any>
			</syntaxhighlight>

Sidminik: /* Начало работы */

2025-12-30T05:30:56Z

Начало работы

← Предыдущая версия		Версия от 05:30, 30 декабря 2025
Строка 32:		Строка 32:
	Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.		Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.

			<syntaxhighlight lang="javascript">
	async connect(): Promise<void>		async connect(): Promise<void>
			</syntaxhighlight>

	===<code>client.disconnect()</code>===		===<code>client.disconnect()</code>===

Sidminik: /* Начало работы */

2025-12-30T05:29:49Z

Начало работы

← Предыдущая версия		Версия от 05:29, 30 декабря 2025
Строка 34:		Строка 34:
	async connect(): Promise<void>		async connect(): Promise<void>

	===client.disconnect()===		===<code>client.disconnect()</code>===
	Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.		Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.

	async disconnect(): Promise<void>		async disconnect(): Promise<void>

	===client.execute()===		===<code>client.execute()</code>===
	Выполняет запрос. В зависимости от типа БД ответ может различаться.		Выполняет запрос. В зависимости от типа БД ответ может различаться.

Строка 64:		Строка 64:
	execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>		execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>

	===client.executeScalar()===		===<code>client.executeScalar()</code>===
	Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.		Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.

Строка 72:		Строка 72:
	executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>		executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>

	===client.requireFromDatabase()===		===<code>client.requireFromDatabase()</code>===
	Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.		Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.


	requireFromDatabase(name: string): Promise<any>		requireFromDatabase(name: string): Promise<any>

Sidminik: /* Начало работы */

2025-12-30T05:29:08Z

Начало работы

← Предыдущая версия		Версия от 05:29, 30 декабря 2025
Строка 29:		Строка 29:
	Такой трюк работает, благодаря общему интерфейсу.		Такой трюк работает, благодаря общему интерфейсу.

	===client.connect()===		===<code>client.connect()</code>===
	Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.		Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.

Sidminik: /* Начало работы */

2025-12-30T05:27:40Z

Начало работы

← Предыдущая версия		Версия от 05:27, 30 декабря 2025
Строка 21:		Строка 21:
	Можно в полностью автоматическом режиме получить клиент для нужной СУБД, получая при этом универсальное решение для любой БД:		Можно в полностью автоматическом режиме получить клиент для нужной СУБД, получая при этом универсальное решение для любой БД:

			<syntaxhighlight lang="javascript">
	const { getChemicClient } = require('@chemsoft/db')		const { getChemicClient } = require('@chemsoft/db')

	const client = getChemicClient()		const client = getChemicClient()
			</syntaxhighlight>

	Такой трюк работает, благодаря общему интерфейсу.		Такой трюк работает, благодаря общему интерфейсу.

	client.connect()		===client.connect()===
	Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.		Производит подключение к БД. Почему не реализовано в конструкторе? Для того, чтобы реализовать ленивый запрос зависимостей, таким образом, подключены будут только используемые в текущий момент пакеты для подключения к БД.

			async connect(): Promise<void>

	~~async connect(): Promise<void>~~		===client.disconnect()===
	client.disconnect()
	Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.		Производит отключение от БД в явном виде, таким образом не будет создаваться лишних соединений с БД, на одного пользователя будет только одно подключение. Необходимо вызвать в конце потока исполнения скрипта.

			async disconnect(): Promise<void>

	~~async disconnect(): Promise<void>~~		===client.execute()===
	client.execute()
	Выполняет запрос. В зависимости от типа БД ответ может различаться.		Выполняет запрос. В зависимости от типа БД ответ может различаться.

Строка 61:		Строка 63:

	execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>		execute(query: string, parameters?: QueryParameter[]): Promise<IExecuteResult>
	client.executeScalar()
			===client.executeScalar()===
	Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.		Выполняет запрос и возвращает одно скалярное значение (даже если может быть возвращено несколько колонок). Если возвращено несколько записей и колонок, то возвращает данные из первой записи и первой колонки.

Строка 68:		Строка 71:

	executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>		executeScalar(query: string, parameters?: QueryParameter[]): Promise<any>
	client.requireFromDatabase()
			===client.requireFromDatabase()===
	Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.		Выполняет запрос и срабатывает как require(), но код модуля получает из БД. В основном используется в планировщике.


	requireFromDatabase(name: string): Promise<any>		requireFromDatabase(name: string): Promise<any>

Sidminik: /* Начало работы */

2025-12-30T05:25:47Z

Начало работы

← Предыдущая версия		Версия от 05:25, 30 декабря 2025
Строка 10:		Строка 10:
	Можно запросить клиент для необходимой СУБД вручную:		Можно запросить клиент для необходимой СУБД вручную:

			<syntaxhighlight lang="javascript">
	const {AccessClient, MssqlClient, OracleClient} = require('@chemsoft/db')		const {AccessClient, MssqlClient, OracleClient} = require('@chemsoft/db')

Строка 17:		Строка 17:
	const oracle = new OracleClient(`connection string`)		const oracle = new OracleClient(`connection string`)
	const oracle = new PostgresClient(`connection string`)		const oracle = new PostgresClient(`connection string`)
			</syntaxhighlight>

	Можно в полностью автоматическом режиме получить клиент для нужной СУБД, получая при этом универсальное решение для любой БД:		Можно в полностью автоматическом режиме получить клиент для нужной СУБД, получая при этом универсальное решение для любой БД: