GET_ENTITY_DDL
Содержание раздела
Поддерживается в версиях: 6.12 / 6.11 / 6.10 / 6.9 / 6.8 / 6.7 / 6.6 / 6.5 / 6.4 / 6.3 / 6.2 / 6.1 / 6.0 / 5.8 / 5.7 / 5.6 / 5.5 / 5.4 / 5.3.
Запрос возвращает содержимое DDL-запроса на создание логической сущности в текущем состоянии.
Информацию можно получить по следующим логическим сущностям:
- логической таблице,
- прокси-таблице,
- логическому представлению,
- материализованному представлению,
- внешней таблице загрузки,
- внешней таблице выгрузки,
- внешней readable-таблице,
- внешней writable-таблице.
Для логической таблицы запрос также возвращает информацию о текущих retention-правилах.
Синтаксис
GET_ENTITY_DDL([db_name.]entity_name)
Параметры:
db_name-
Имя логической базы данных, которой принадлежит запрашиваемая сущность. Опционально, если выбрана логическая БД, используемая по умолчанию.
entity_name-
Имя таблицы или представления, по которому запрашивается информация.
Варианты ответа
Успешный ответ содержит объект ResultSet с одной строкой, в которой представлен DDL-запрос на создание сущности. Неуспешный ответ содержит исключение.
Начиная с версии 6.1, система возвращает DDL-запрос, содержащий переносы строк. В предыдущих версиях DDL-запрос возвращался без переносов.
Примеры
Запрос по сущности указанной логической БД
GET_ENTITY_DDL(marketing.stores)
Запрос по сущности логической БД, выбранной по умолчанию
-- выбор логической базы данных marketing в качестве базы данных по умолчанию
USE marketing;
-- запрос информации по представлению sales_and_stores
GET_ENTITY_DDL(sales_and_stores);
На рисунке ниже показан фрагмент ответа GET_ENTITY_DDL по материализованному представлению sales_and_stores.
Фрагмент ответа GET_ENTITY_DDL