dblink_build_sql_insert

примечание

Эта страница переведена при помощи нейросети GigaChat.

dblink_build_sql_insert – создает оператор INSERT с использованием локального кортежа, заменяя значения полей первичного ключа альтернативными значениями, которые были предоставлены.

Синтаксис

dblink_build_sql_insert(text relname,
                        int2vector primary_key_attnums,
                        integer num_primary_key_atts,
                        text[] src_pk_att_vals_array,
                        text[] tgt_pk_att_vals_array) returns text

Описание

dblink_build_sql_insert может быть полезен для выборочной репликации локальной таблицы в удаленную базу данных. Она выбирает строку из локальной таблицы на основе первичного ключа, а затем создает команду SQL INSERT, которая будет дублировать эту строку, но с заменой значений первичного ключа значениями в последнем аргументе. Чтобы создать точную копию строки, просто укажите одинаковые значения для последних двух аргументов.

Аргументы

relname

Имя локального отношения, например foo или myschema.mytab. Включите двойные кавычки, если имя содержит прописные буквы или специальные символы, например "FooBar", без кавычек строка будет преобразована в нижний регистр.

primary_key_attnums

Номера атрибутов (основанные на 1) полей первичного ключа, например 1 2.

num_primary_key_atts

Количество полей первичного ключа.

src_pk_att_vals_array

Значения полей первичного ключа, которые будут использоваться для поиска локального кортежа. Каждое поле представлено в текстовой форме. Возникает ошибка, если нет локального ряда с этими значениями первичного ключа.

tgt_pk_att_vals_array

Значения полей первичного ключа, которые должны быть размещены в результирующей команде INSERT. Каждое поле представлено в текстовой форме.

Возвращаемое значение

Возвращает запрошенную инструкцию SQL в виде текста.

Примечания

Начиная с версии PostgreSQL 9.0, номера атрибутов в primary_key_attnums интерпретируются как логические номера столбцов, соответствующие положению столбца в SELECT * FROM relname. Предыдущие версии интерпретировали числа как физические позиции столбцов. Разница существует, если какие-либо столбцы слева от указанного столбца были удалены за время существования таблицы.

Примеры

SELECT dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a"}', '{"1", "b''a"}');
             dblink_build_sql_insert
--------------------------------------------------
 INSERT INTO foo(f1,f2,f3) VALUES('1','b''a','1')
(1 row)