TempDB.Create - Revision history

Admin: 1 revision imported

2026-04-01T10:00:50Z

1 revision imported

1>Admin at 08:14, 3 February 2026

2026-02-03T08:14:59Z

Admin: 1 revision imported

2025-01-22T06:57:14Z

1 revision imported

1>Admin at 16:22, 22 November 2024

2024-11-22T16:22:48Z

Admin: 1 revision imported

2021-02-07T06:54:37Z

1 revision imported

Admin at 07:11, 17 November 2019

2019-11-17T07:11:04Z

New page

{{infobox function
|name=Create
|object=[[Временная таблица базы данных]]
|caption=Создание объекта временной таблицы
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, неверные аргументы, ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Временная таблица базы данных]]}}
Функция создает новый объект временной таблицы базы данных. Функция может быть вызвана с интерфейсом временной таблицы.

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Create'''({{Optional|<Наименования столбцов с типами данных (STRING)>}}):''<Новый объект (TEMPDB)>''
</code>

==== Аргументы ====
* <code>''<Наименования столбцов с типами данных (STRING)>''</code> - Задает наименования столбцов в создаваемой таблице через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
** Наименование столбца подчиняется стандартным правилам создания наименований в системе и может содержать международные символы.
** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[:<Размер>[:<Точность>]]</code>, возможно указание на следующие типы:
*** '''NUMBER''', '''NUM''' -- задает вещественное число с указанием на точность его представления. Тип записывается в виде <code>NUMBER:<Общее количество цифр>:<Количество цифр после точки></code>.
*** '''INTEGER''', '''INT''' -- задает целое 64-битное число.
*** '''REAL''' -- задает произвольное вещественное число (в инженерной нотации)
*** '''DATE''' -- задает тип данных даты и времени.
*** '''STRING''', '''STR''' -- задает строковой тип данных с указанием длины строки в виде <code>STRING:<Длина строки в символах></code>. Для строк произвольной длины, необходимо указать ноль (возможности при работе с такими строками имеют определенные ограничения для SQL серверов).
*** '''ANY''', '''DB''' -- задает произвольный тип базы данных.
*** '''<Тип данных БД>[.<Вид данных БД>]''' -- задает определенный тип данных базы данных. В ''типе данных БД'' можно указать '''REF''', '''DOC''', '''JOUR''', '''STOR''' или '''ENUM'''.
** Также ''тип данных'' можно задать с помощью указания на существующий реквизит объекта базы данных, иногда такой способ является более универсальным. В это случае формат записи выглядит следующим образом: <code>-><Тип данных БД>.<Вид данных БД>.<Реквизит объекта БД></code>. Система автоматически использует тип данных указанного реквизита для создания столбца временной таблицы.
** ''Флаги столбца'' представляют совокупность букв-указаний. В данный момент можно использовать следующие указания:
*** '''I''' -- Добавить индекс к данному столбцу после создания
*** '''U''' -- Текстовые данные, хранящиеся в столбце будут использовать формат UTF-16. '''Внимание''': без такого указания, по умолчанию текст будет храниться в текущей кодировке ANSI, что может явиться причиной потери международных символов.

==== Возвращаемое значение ====
Возвращает новый объект временной таблицы базы данных.

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами документа ЗаказНаПроизводство, при этом в ней также заполнено поле документа ВыпускПродукции.
// Документ ВыпускПродукции подчинен документу ЗаказНаПроизводство. Выборка документов происходит за период с НачДата по КонДата.
//Таблица номенклатуры из резервов с выпусками и заданиями
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5");
//Заказы на производство
аТемп.LoadFrom("Stor.Резервы","@LINK->зЗад,Номенклатура->зН,?(@EXPENSE=1,-Количество,Количество)->Количество",
"(BegOfDay(@DATE)>=НачДата)And(BegOfDay(@DATE)<=КонДата)","IsType(@LINK,Doc.ЗаказНаПроизводство)");
//Заполняем зДок (подчиненный документ -- ВыпускПродукции)
вТемп:=TempDB.Create("зДок2:DB,зЗад:DB");
//Выбираются только те документы выпусков, основания которых (ЗаказНаПроизводство) находятся в таблице аТемп
вТемп.LoadFrom("Doc.ВыпускПродукции","@ELEMENT->зДок2,@ELEMENT.ДокОснование->зЗад","@ELEMENT.ДокОснование IN аТемп.зЗад");
//Заполним столбец зДок оригинальной таблицы, объединение происходит по условию ":зЗад=зЗад".
аТемп.Update(вТемп,":зЗад=зЗад,зДок2->зДок");
//В дальнейшем таблицу аТемп можно выводить на экран или использовать в последующих запросах.
</pre>

← Older revision	Revision as of 10:00, 1 April 2026
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Временная таблица базы данных]]}}
-Функция создает новый объект временной таблицы базы данных. Функция может быть вызвана с интерфейсом временной таблицы.
+Функция создает новый объект временной таблицы базы данных с заданными столбцами и их типами данных, если это необходимо. При указании второго аргумента, функция создает или открывает постоянную таблицу внешней базы данных по их именам. Если таблица уже существовала, сервер проверит последовательность и типы данных столбцов таблицы. Если какой-то их типов отличается, функция вызовет исключение, иначе будет создан объект, с помощью которого можно обращаться к этой таблице. Если столбец ранее не сущестсвовал, он будет добавлен в таблицу. Если таблицы с таким именем не было в указанной базе данных, она будет создана. Имена БД должны быть предварительно перечислены [[Установки сервера|установках сервера]] (ветка '''SimpleDBases'''). Для наименований таблиц рекомендуется использовать латиницу или цифры, запрещено использовать знаки "." или ",". Таблица может содержать большее количество столбцов, тем указано в функции, если таблица содержит меньшее количество, недостающие столбцы будут созданы. Функция вызывается из интерфейса временной таблицы.
 == Синтаксис ==
 <code>
-{{Grey|TempDB.}}'''Create'''({{Optional|<Наименования столбцов с типами данных (STRING)>}}):''<Новый объект (TEMPDB)>''
+{{Grey|TempDB.}}'''Create'''({{Optional|<Наименования столбцов с типами данных (STRING)>,<Имя внешней БД и наименование ее таблицы (STRING)>}}):''<Новый объект (TEMPDB)>''
 </code>
 ==== Аргументы ====
-* <code>''<Наименования столбцов с типами данных (STRING)>''</code> - Задает наименования столбцов в создаваемой таблице через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
+* <code>''<Наименования столбцов с типами данных (STRING)>''</code> - {{Optional}} Задает наименования столбцов в создаваемой таблице через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
 ** Наименование столбца подчиняется стандартным правилам создания наименований в системе и может содержать международные символы.
 ** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[.<Размер>[.<Точность>]]</code>, возможно указание на следующие типы:
@@ Line 35: / Line 35: @@
 *** '''I''' -- Добавить индекс к данному столбцу после создания
 *** '''U''' -- Текстовые данные, хранящиеся в столбце будут использовать формат UTF-16. '''Внимание''': без такого указания, по умолчанию текст будет храниться в текущей кодировке ANSI, что может явиться причиной потери международных символов.
 ==== Возвращаемое значение ====

← Older revision	Revision as of 06:57, 22 January 2025
(No difference)

@@ Line 23: / Line 23: @@
 * <code>''<Наименования столбцов с типами данных (STRING)>''</code> - Задает наименования столбцов в создаваемой таблице через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
 ** Наименование столбца подчиняется стандартным правилам создания наименований в системе и может содержать международные символы.
-** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[:<Размер>[:<Точность>]]</code>, возможно указание на следующие типы:
+** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[.<Размер>[.<Точность>]]</code>, возможно указание на следующие типы:
-*** '''NUMBER''', '''NUM''' -- задает вещественное число с указанием на точность его представления. Тип записывается в виде <code>NUMBER:<Общее количество цифр>:<Количество цифр после точки></code>.
+*** '''NUMBER''', '''NUM''' -- задает вещественное число с указанием на точность его представления. Тип записывается в виде <code>NUMBER.<Общее количество цифр>.<Количество цифр после точки></code>.
 *** '''INTEGER''', '''INT''' -- задает целое 64-битное число.
 *** '''REAL''' -- задает произвольное вещественное число (в инженерной нотации)
 *** '''DATE''' -- задает тип данных даты и времени.
-*** '''STRING''', '''STR''' -- задает строковой тип данных с указанием длины строки в виде <code>STRING:<Длина строки в символах></code>. Для строк произвольной длины, необходимо указать ноль (возможности при работе с такими строками имеют определенные ограничения для SQL серверов).
+*** '''STRING''', '''STR''' -- задает строковой тип данных с указанием длины строки в виде <code>STRING.<Длина строки в символах></code>. Для строк произвольной длины, необходимо указать ноль (возможности при работе с такими строками имеют определенные ограничения для SQL серверов).
 *** '''ANY''', '''DB''' -- задает произвольный тип базы данных.
 *** '''<Тип данных БД>[.<Вид данных БД>]''' -- задает определенный тип данных базы данных. В ''типе данных БД'' можно указать '''REF''', '''DOC''', '''JOUR''', '''STOR''' или '''ENUM'''.

← Older revision	Revision as of 06:54, 7 February 2021
(No difference)