SET

📖 Описание

Функция SET возвращает вложенную таблицу того же типа, оставляя по одному экземпляру каждого значения. Исходная коллекция не изменяется, если результат присваивается другой переменной.


🧩 Синтаксис

Синтаксис SET в Oracle PL/SQL:

SET (nt)

⚙️ Параметры и аргументы

nt — исходная вложенная таблица; SET возвращает новую коллекцию с уникальными значениями.


📝 Примечание

  • Операции возможны только с коллекциями nested tables. Результатом операции также является коллекция nested tables.
  • Порядок элементов результата не гарантирован. Таблицы ниже описывают состав результата и число повторов, а не порядок строк DBMS_OUTPUT.

💻 Уникальные номера мастерских

В списке регистраций номера 401 и 402 встречаются несколько раз. SET оставит по одному номеру. Результат записывается отдельно: исходный список сохраняет все шесть регистраций.

DECLARE
  TYPE studio_list IS TABLE OF NUMBER;
  v_registrations studio_list := studio_list(401, 402, 401, 403, 402, 401);
  v_unique studio_list;
  PROCEDURE show_result(p_label VARCHAR2, p_values studio_list) IS
    v_index PLS_INTEGER;
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_label || ': COUNT=' || p_values.COUNT);
    v_index := p_values.FIRST;
    WHILE v_index IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(TO_CHAR(p_values(v_index)));
      v_index := p_values.NEXT(v_index);
    END LOOP;
  END;
BEGIN
  v_unique := SET(v_registrations);
  show_result('Unique studios', v_unique);
  DBMS_OUTPUT.PUT_LINE('Registrations: ' || v_registrations.COUNT);
END;
/
Результат Состав COUNT
v_unique 401, 402, 403 — каждый один раз 3
v_registrations исходные повторы сохранены 6

💻 Уникальные материалы

Отдельный блок работает со строковыми кодами материалов. Пустая инициализированная коллекция после SET остаётся пустой.

DECLARE
  TYPE material_list IS TABLE OF VARCHAR2(20);
  v_materials material_list := material_list('CLAY', 'GLAZE', 'CLAY', 'BRUSH', 'GLAZE');
  v_unique material_list;
  v_empty material_list := material_list();
  PROCEDURE show_result(p_label VARCHAR2, p_values material_list) IS
    v_index PLS_INTEGER;
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_label || ': COUNT=' || p_values.COUNT);
    v_index := p_values.FIRST;
    WHILE v_index IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(p_values(v_index));
      v_index := p_values.NEXT(v_index);
    END LOOP;
  END;
BEGIN
  v_unique := SET(v_materials);
  show_result('Unique materials', v_unique);
  v_unique := SET(v_empty);
  show_result('Empty input', v_unique);
END;
/
Вызов Состав результата COUNT
SET(v_materials) CLAY, GLAZE, BRUSH — каждый один раз 3
SET(v_empty) нет элементов 0

SET требует сравнимых элементов. Это функция над вложенной таблицей, а не предложение SET оператора UPDATE и не команда SET клиента SQL*Plus.

Сравните: MULTISET EXCEPT DISTINCT, MULTISET EXCEPT, MULTISET INTERSECT DISTINCT, MULTISET INTERSECT, MULTISET UNION DISTINCT, MULTISET UNION. Все примеры используют Nested Tables.

См. документацию Oracle: SET.

Включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Состав и количество элементов ниже рассчитаны по данным примеров; порядок вывода не фиксирован.