GET_ENTITY_DDL

Содержание раздела

1. Синтаксис
2. Варианты ответа
3. Примеры
   1. Запрос по сущности указанной логической БД
   2. Запрос по сущности логической БД, выбранной по умолчанию

Поддерживается в версиях:  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