SELECT

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

Синтаксис
Ограничения
Примеры

Запрос позволяет выбрать данные из следующих сущностей и их соединений:

Синтаксис чтения из standalone-таблицы подразумевает использование внешней readable-таблицы, которая указывает на нужную standalone-таблицу.

Запросы к логическим таблицам и представлениям по умолчанию возвращают данные, актуальные на текущий момент. Чтобы выбрать срез данных на определенный момент времени, укажите ключевое слово FOR SYSTEM_TIME с нужным значением. Для standalone-таблиц ключевое слово недоступно: запросы к таким таблицам всегда возвращают текущее состояние данных.

Запрос также можно использовать для получения информации о самом запросе, а также как подзапрос в других запросах:

на выгрузку данных,
на создание или обновление логического представления,
на создание материализованного представления,
на вставку данных из другой сущности.

Запрос SELECT обрабатывается в порядке, описанном в разделе Порядок обработки запросов на чтение данных. В ответе возвращается:

объект ResultSet c выбранными записями или информацией о запросе при успешном выполнении запроса;
исключение при неуспешном выполнении запроса.

Синтаксис

SELECT column_list
FROM [db_name.]entity_name
[FOR SYSTEM_TIME time_expression [AS alias_name]]
[DATASOURCE_TYPE = datasource_alias]
[ESTIMATE_ONLY]

Параметры:

column_list: Список выбираемых столбцов таблицы или представления. Можно указывать символ * для выбора всех столбцов.
db_name: Имя логической базы данных, из которой выбираются данные. Опционально, если выбрана логическая БД, используемая по умолчанию.
entity_name: Имя таблицы или представления, из которого выбираются данные.
time_expression: Выражение, задающее момент или период времени, за который выбираются данные или изменения данных. Синтаксис см. ниже.
alias_name: Псевдоним таблицы или представления. Может включать латинские буквы, цифры и символы подчеркивания.
datasource_alias: Системный псевдоним СУБД хранилища, из которой выбираются данные. Возможные значения: 'adb', 'adqm', 'adg', 'adp'.

В запросах можно указывать:

ключевые слова, перечисленные в секции Поддерживаемые ключевые слова,
функции, перечисленные в разделе Поддержка SQL,
псевдонимы для имен таблиц, представлений и столбцов.

Некоторые агрегатные функции и типы соединений недоступны для исполнения в определенных СУБД хранилища. Список доступных возможностей см. в разделе Поддержка SQL.

Поддерживаемые ключевые слова

В запросе можно использовать следующие ключевые слова, которые должны быть указаны в порядке их перечисления:

FOR SYSTEM_TIME — задает момент времени или период, за который выбираются данные или изменения данных. Поддерживается для логических таблиц, логических и материализованных представлений. Описание и синтаксис см. в секции Ключевое слово FOR SYSTEM_TIME;
JOIN ON — соединяет данные нескольких таблиц и (или) представлений из одной или нескольких логических БД. Возможные значения см. в секции Возможные типы соединений;
WHERE — задает условия выбора данных. Условия в запросах к ADG могут включать ключевое слово COLLATE;
GROUP BY — группирует данные;
HAVING — задает условия выбора сгруппированных данных;
ORDER BY — сортирует данные;
LIMIT или FETCH NEXT <N> ROWS ONLY— ограничивает количество возвращаемых строк;
OFFSET — пропускает указанное количество строк в результате запроса. Описание и синтаксис см. в секции Ключевое слово OFFSET;
DATASOURCE_TYPE — задает СУБД хранилища, из которой выбираются данные. Поддерживается для логических таблиц, логических и материализованных представлений;
ESTIMATE_ONLY — включает режим получения информации о запросе, а не самих данных. Описание см. в секции Ключевое слово ESTIMATE_ONLY.

Ключевое слово FOR SYSTEM_TIME

Ключевое слово FOR SYSTEM_TIME задает момент, по состоянию на который запрашиваются данные, или период (диапазон дельт), за который запрашиваются изменения. Возможные значения см. в таблице ниже.

Ключевое слово относится к логической таблице, логическому представлению или материализованному представлению, после имени которого оно следует. Если в запросе соединяется несколько логических таблиц и представлений, для каждой логической сущности можно указать свое ключевое слово FOR SYSTEM_TIME, при этом значения этих ключевых слов могут различаться (см. пример ниже).

Ключевое слово недоступно в запросах к standalone-таблицам.

Если ключевое слово не указано, из логических таблиц и логических представлений выбираются данные, актуальные на момент обработки запроса, из материализованного представления — данные, актуальные на момент последней синхронизации этого представления.

В таблице ниже описаны возможные значения выражения FOR SYSTEM_TIME time_expression.

Выражение	Описание	Доступно для материализованных представлений
`FOR SYSTEM_TIME AS OF 'YYYY-MM-DD hh:mm:ss'`	Запрос данных, актуальных на указанную дату и время	+
`FOR SYSTEM_TIME AS OF DELTA_NUM delta_num`	Запрос данных, актуальных на дату и время закрытия дельты с номером `delta_num`	+
`FOR SYSTEM_TIME AS OF LATEST_UNCOMMITTED_DELTA`	Запрос данных на текущий момент, включая данные, загруженные в горячей дельте. По горячей дельте возвращаются записи, загруженные в рамках непрерывного диапазона завершенных операций записи (см. параметры `cn_from` и `cn_to`в разделе GET_DELTA_HOT)	–
`FOR SYSTEM_TIME STARTED IN (delta_num1, delta_num2)`	Запрос данных, добавленных или измененных в период между дельтой `delta_num1` и дельтой `delta_num2` (включая граничные дельты)	+ Если обе дельты есть в представлении
`FOR SYSTEM_TIME FINISHED IN (delta_num1, delta_num2)`	Запрос данных, удаленных в период между дельтой `delta_num1` и дельтой `delta_num2` (включая граничные дельты)	+ Если обе дельты есть в представлении

Наличие и значение ключевого слова FOR SYSTEM_TIME в запросах к материализованным представлениям влияют на порядок маршрутизации запросов).

Поддерживаемые типы соединений

Поддерживаются следующие типы соединений:

[INNER] JOIN — внутреннее соединение,
NATURAL JOIN — внутреннее соединение по всем столбцам с одинаковыми именами, ключи соединения не указываются,
LEFT [OUTER] JOIN — левое внешнее соединение,
RIGHT [OUTER] JOIN — правое внешнее соединение,
FULL [OUTER] JOIN — полное внешнее соединение,
CROSS JOIN — декартово произведение таблиц или представлений, ключи соединения не указываются.

Ключевое слово COLLATE

Ключевое слово COLLATE позволяет задать правило сопоставления символьных строк, например, приравнять строки в верхнем и нижнем регистрах. Ключевое слово доступно в условии, заданном с помощью ключевого слова WHERE (см. пример ниже).

Ключевое слово COLLATE поддерживается только для запросов к ADG. Это означает, что для его корректной работы в запросе нужно либо указать ADG в качестве источника данных (DATASOURCE_TYPE = 'adg'), либо обращаться к логической сущности, данные которой размещены только в ADG.

Подробнее о правилах сопоставления символьных строк в ADG см. в документации Tarantool.

Ключевое слово OFFSET

Ключевое слово OFFSET позволяет пропустить первые несколько строк результата и выбрать только последующие строки (см. примеры ниже). В качестве значения ключевого слова можно указать любое неотрицательное целое число, начиная с нуля, или переменную. Если для OFFSET указано значение 0, то пропускается 0 строк, что равносильно запросу без OFFSET.

Запросы с OFFSET без ограничения количества строк не поддерживаются. То есть, если ключевое слово OFFSET указано в запросе, то перед ним должно быть ключевое слово LIMIT <N> или FETCH NEXT <N> ROWS ONLY. Обратного ограничения нет: ключевые слова LIMIT <N> и FETCH NEXT <N> ROWS ONLY можно использовать без OFFSET.

Рекомендуется сочетать OFFSET с ключевым словом ORDER BY для получения упорядоченного набора строк. Ключевое слово ORDER BY необязательно, однако без него запрос с OFFSET возвращает неупорядоченный и потому непредсказуемый набор строк.

Таким образом, для ключевого слова OFFSET поддерживается следующий синтаксис:

[ ORDER BY <column_name> ]
{ LIMIT <value_1> | FETCH NEXT <value_1> ROWS ONLY } 
OFFSET <value_2> [ ROW | ROWS ]

Ключевое слово ESTIMATE_ONLY

Ключевое слово ESTIMATE_ONLY позволяет запросить информацию о выполнении запроса к данным, а не сами данные (см. пример ниже).

Если ключевое слово указано, запрос возвращает следующую информацию:

имя СУБД хранилища, в которой предполагается выполнение запроса;
план выполнения запроса (для ADB и ADP) — результат выполнения команды EXPLAIN в СУБД хранилища. Подробнее о команде EXPLAIN в ADB см. в документации Greenplum, о команде в ADP — в документации PostgreSQL;
обогащенный запрос — запрос, подготовленный системой на основе исходного запроса с учетом специфики СУБД хранилища.

В ответе возвращается объект ResultSet с одной строкой, содержащей JSON-строку в следующем формате:

{
  "plugin": "<имя_СУБД>",
  "estimation": <план_выполнения_запроса>,
  "query": <обогащенный_запрос>
}

Ниже показан пример JSON-строки, полученной из ADB. Для наглядности пример представлен в виде дерева, а не плоской строки.

{
  "plugin": "ADB",
  "estimation": [
    {
      "Plan": {
        "Node Type": "Gather Motion",
        "Senders": 4,
        "Receivers": 1,
        "Slice": 1,
        "Segments": 4,
        "Gang Type": "primary reader",
        "Startup Cost": 0.00,
        "Total Cost": 433.70,
        "Plan Rows": 50000,
        "Plan Width": 8,
        "Plans": [
          {
            "Node Type": "Seq Scan",
            "Parent Relationship": "Outer",
            "Slice": 1,
            "Segments": 4,
            "Gang Type": "primary reader",
            "Relation Name": "sales_actual",
            "Alias": "sales_actual",
            "Startup Cost": 0.00,
            "Total Cost": 432.18,
            "Plan Rows": 50000,
            "Plan Width": 8
          }
        ]
      },
      "Settings": {
        "Optimizer": "Pivotal Optimizer (GPORCA)"
      }
    }
  ],
  "query": "SELECT * FROM (SELECT id FROM marketing.sales_actual WHERE sys_from <= 98 AND COALESCE(sys_to, 9223372036854775807) >= 98)"
}

Ниже показан пример JSON-строки, полученной из ADP. Для наглядности пример представлен в виде дерева, а не плоской строки.

{
  "plugin": "ADP",
  "estimation": [
    {
      "Plan": {
        "Node Type": "Seq Scan",
        "Parallel Aware": false,
        "Relation Name": "sales_actual",
        "Alias": "sales_actual",
        "Startup Cost": 0.00,
        "Total Cost": 18.80,
        "Plan Rows": 880,
        "Plan Width": 64
      }
    }
  ],
  "query": "SELECT * FROM (SELECT id FROM marketing.sales_actual WHERE sys_from <= 98 AND COALESCE(sys_to, 9223372036854775807) >= 98)"
}

Ограничения

Запрос может обращаться либо к логической БД, либо к сервисной БД (см. SELECT FROM INFORMATION_SCHEMA), но не к обеим одновременно.
Если ключами соединения в запросе выступают поля типа Nullable, то строки, где хотя бы один из ключей имеет значение NULL, не соединяются.
Ключевое слово ORDER BY не поддерживается для SELECT-подзапроса в составе запроса CREATE MATERIALIZED VIEW.

Примеры

Звездочка и WHERE

Запрос с неявным указанием столбцов и ключевым словом WHERE:

SELECT * FROM marketing.sales
WHERE store_id = 1234

DATASOURCE_TYPE

Запрос с перечислением столбцов и выбором данных из определенной СУБД хранилища (ADQM):

SELECT sold.store_id, sold.product_amount
FROM marketing.stores_by_sold_products AS sold
DATASOURCE_TYPE = 'adqm'

GROUP BY, ORDER BY и LIMIT

Запрос с агрегацией, группировкой и сортировкой данных, а также выбором первых 20 строк:

SELECT s.store_id, SUM(s.product_units) AS product_amount
FROM marketing.sales AS s
GROUP BY (s.store_id)
ORDER BY product_amount DESC
LIMIT 20

ESTIMATE_ONLY

Запрос на получение информации о запросе:

SELECT s.store_id, SUM(s.product_units) AS product_amount
FROM marketing.sales AS s
GROUP BY (s.store_id)
ORDER BY product_amount DESC
ESTIMATE_ONLY

Описание ключевого слова см. в секции Ключевое слово ESTIMATE_ONLY.

COLLATE

Запрос строк с указанными значениями без учета регистра:

SELECT * from marketing.sales 
WHERE product_code = 'ABC1234' AND product_code <> 'abc4567' COLLATE 'unicode_ci'
DATASOURCE_TYPE = 'adg'

Описание ключевого слова см. в секции Ключевое слово COLLATE.

OFFSET

Запрос 20 строк, начиная с десятой:

SELECT * from marketing.sales FETCH NEXT 20 ROWS ONLY OFFSET 9

Описание ключевого слова см. в секции Ключевое слово OFFSET.

ORDER BY, LIMIT и OFFSET

Запрос 20 строк, упорядоченных по значению id и выбираемых начиная с десятой строки результата:

SELECT * from marketing.sales ORDER BY id LIMIT 20 OFFSET 9

Такое сочетание ключевых слов позволяет выбирать данные порциями с сохранением их порядка.

FOR SYSTEM_TIME AS OF DELTA_NUM

Запрос записей, актуальных на момент закрытия дельты с номером 9, из материализованного представления:

SELECT * FROM marketing.sales_and_stores FOR SYSTEM_TIME AS OF DELTA_NUM 9

Описание ключевого слова см. в секции Ключевое слово FOR SYSTEM_TIME.

Соединение таблиц из разных логических БД

Запрос с соединением данных логических таблиц из двух разных логических БД:

SELECT
  st.id,
  st.category,
  s.product_code
FROM marketing.stores AS st
INNER JOIN marketing_new.sales AS s
  ON st.id = s.store_id

О возможных типах соединений см. в секции Поддерживаемые типы соединений.

Соединение изменений из разных дельт

Запрос с соединением записей логической таблицы, добавленных и измененных в двух различных диапазонах дельт:

  SELECT st.id, st.category, s.product_code 
  FROM marketing.stores FOR SYSTEM_TIME STARTED IN(0,7) AS st 
  INNER JOIN marketing.sales FOR SYSTEM_TIME STARTED IN(0,1) AS s 
  ON st.id = s.store_id

О возможных типах соединений см. в секции Поддерживаемые типы соединений.

Запрос из standalone-таблицы

-- запрос данных из standalone-таблицы, на которую указывает внешняя readable-таблица payments_ext_read_adg
SELECT p.agreement_id, p.code, SUM(p.amount) AS amount, p.currency_code 
FROM marketing.payments_ext_read_adg AS p 
GROUP BY p.agreement_id, p.code, p.currency_code

Соединение standalone-таблицы и логической таблицы

-- запрос данных из логической таблицы clients и standalone-таблицы, на которую указывает 
--   внешняя readable-таблица agreements_ext_read_adp
SELECT a.id, a.client_id, c.last_name, c.first_name, c.patronymic_name 
FROM marketing.agreements_ext_read_adp AS a
LEFT JOIN marketing.clients FOR SYSTEM_TIME AS OF delta_num 9 AS c
  ON a.client_id = c.id