Structured Query Language (SQL) - это стандартный компьютерный язык, содержащий набор определенного синтаксиса и выражений, используемых для доступа и управления данными в базах данных и в других технологиях обработки данных.
Американский национальный институт стандартов (ANSI) определяет стандарт для SQL. Большинство систем управления реляционными базами данных используют этот стандарт и расширяют его, благодаря чему синтаксис SQL в разных СУБД немного отличается друг от друга.
Выражения запроса в ArcGIS соответствуют стандартным выражениям SQL. Синтаксис SQL, который вы используете в выражении, зависит от источника данных. Каждый источник данных имеет свой собственный вариант SQL, они называются диалектами SQL, к ним относятся:
- Файловые данные, включая файловые базы геоданных, шейп-файлы, виды таблиц в памяти, текстовые файлы, такие как таблицы.dbf, .csv, .txt, .xlsx и сервисы объектов, которые используют стандартизованные запросы, используют диалект ArcGIS SQL, который поддерживает подмножество возможностей SQL.
- Мобильные базы геоданных, ST_geometry SQLite, Open Geospatial Consortium (OGC) GeoPackage и Microsoft Excel используют диалект SQL SQLite.
- Базы данных и многопользовательские базы геоданных используют синтаксис SQL базовой РСУБД, например Oracle, Microsoft SQL Server, PostgreSQL, SAP HANA и IBM Db2, где каждая база данных использует свой собственный немного другой диалект SQL.
При использовании диалоговых окон ArcGIS для построения выражения SQL используется автозаполнение, чтобы помочь вам применить правильный синтаксис для запрашиваемого источника данных. По мере ввода появляется запрос, показывающий имена полей, значения, ключевые слова и операторы, поддерживаемые вашим источником данных.
Подсказка:
Просмотрите следующее, чтобы определить, когда используется синтаксис ArcGIS SQL или когда используется синтаксис SQL базовой СУБД при создании выражения SQL.
- Если данные в вашем выражении SQL поступают из нескольких источников данных, произойдет следующее:
- Если источниками данных являются как файловые источники, так и СУБД, будет использоваться синтаксис ArcGIS SQL.
- Если все данные в вашем выражении SQL поступают из одного и того же источника данных, произойдет следующее:
- Если источником данных являются данные на основе файлов, будет использоваться синтаксис ArcGIS SQL.
- Если источником данных является база данных или многопользовательская база геоданных, ArcGIS передаст выражение SQL в СУБД для разрешения, и вам нужно будет проконсультироваться с документацией для вашей системы управления базой данных, чтобы узнать о синтаксисе конкретного выражения и поддерживаемых типах данных.
В ArcGIS Pro диалоговое окно выражения SQL можно найти в следующих местах:
- Выбрать по атрибутам с помощью инструмента геообработки Выбрать в слое по атрибуту.
- Вкладка Определяющий запрос в диалоговом окне Свойства слоя.
- Вкладка Фильтры отображения на панели Символы.
- Создать запрос с помощью панели Создать новые запросы.
- Экспортируйте таблицы с помощью инструмента геообработки Экспорт таблицы.
- Экспортируйте объекты с помощью инструмента геообработки Экспорт объектов.
- Используйте инструмент геообработки Вычислить поле, чтобы создать выражение для выполнения простых или сложных вычислений значений поля.
- Используйте Выборку для запроса данных для дальнейшего анализа.
- Используйте инструмент геообработки Создать таблицу запроса, чтобы создать Вид слоя или таблицы.
- Используйте инструмент геообработки Создать векторный слой, чтобы создать такой слой.
- Создайте вид в базе данных или базе геоданных с помощью инструмента геообработки Создать вид базы данных.
- Используйте инструмент геообработки Присоединить, чтобы добавить несколько входных наборов данных в целевой набор данных.
- Используйте ProSDK Core.Data.QueryDef.
Синтаксис выражения SQL
Выражение SQL содержит комбинацию одного или нескольких значений, операторов и функций SQL, которые можно использовать для запроса или выбора подмножества объектов и записей таблиц в ArcGIS.
Все запросы SQL выражаются с помощью ключевого слова SELECT.
SELECT * FROM формирует первую часть выражения SQL и автоматически предоставляется вам в большинстве диалоговых окон ArcGIS. Например, когда вы составляете запрос, записывая синтаксис SQL, оператор SELECT используется для выбора полей из слоя или таблицы и предоставляется вам.
Следующая часть выражения SQL, которая идет после SELECT * FROM <Layer_name> - это условие WHERE. Условие WHERE используется для получения записей, соответствующих определенным критериям, и является частью выражения, которое вы должны построить.
Подсказка:
Звездочка (*) в выражении SQL используется для запроса всех столбцов.
Вот базовая форма условия WHERE SQL-выражения:
- <Field_name> <Operator> <Value or String>
Например, STATE_NAME = 'Florida'. Это выражение содержит одно предложение и выбирает все объекты, содержащие слово 'Florida' в поле STATE_NAME.
Для составных выражений используется следующая форма:
- <Field_name> <Operator> <Value or String> <Connector> <Field_name> <Operator> <Value or String> ...
Например, STATE_NAME = 'Florida' OR (STATE_NAME = 'South Carolina' AND POP2010 > 15000). Это составное выражение состоит из нескольких условий, связанных логическим оператором AND или OR, и выбирает все объекты, содержащие текст Florida в поле STATE_NAME, и все объекты, которые содержат текст South Carolina в поле STATE_NAME, и значение больше 15000 в поле с именем POP2010.
Подсказка:
По желанию, круглые скобки () могут использоваться для определения порядка операций в составных выражениях.
Поскольку вы выбираете столбцы в целом, вы не можете ограничить SELECT возвратом только некоторых столбцов в соответствующей таблице, поскольку синтаксис SELECT * жестко запрограммирован. По этой причине ключевые слова, такие как DISTINCT, ORDER BY и GROUP BY, нельзя использовать в выражении SQL в ArcGIS, за исключением случаев использования подзапросов. Чтобы узнать больше, посмотрите раздел Подзапросы ниже.
В следующих разделах описаны элементы общих выражений SQL-запросов, используемых в ArcGIS.
Часто используемые запросы: поиск строк
Строковые значения в выражениях всегда заключаются в одинарные кавычки, например:
STATE_NAME = 'California'
Строки в выражениях чувствительны к регистру, кроме случаев работы в базах геоданных в Microsoft SQL Server. Чтобы выполнять не чувствительный к регистру поиск в других источниках данных, можно использовать функцию SQL для преобразования всех значений в один регистр. Для источников данных на основе файлов, таких как файловые базы геоданных или шейп-файлы, для задания регистра выборки можно использовать функцию UPPER или LOWER. Например, при помощи следующего выражения выбирается штат, имя которого написано как 'Rhode Island' или 'RHODE ISLAND':
UPPER(STATE_NAME) = 'RHODE ISLAND'
При помощи оператора LIKE (вместо оператора =) строится поиск частей строк. Например, данное выражение выбирает Mississippi и Missouri среди названий штатов США:
STATE_NAME LIKE 'Miss%'
Чтобы задать несколько значений, используйте оператор IN. Например, выберите все значения в Калифорнии, Нью-Йорке и Колорадо.
STATE_NAME IN ('California', 'New York', 'Colorado')Если строка содержит одинарную кавычку, вам в первую очередь требуется использовать другую одинарную кавычку как символ управляющей последовательности, например:
NAME = 'Alfie''s Trough'
OWNER_NAME IN ('Joseph D''Souza', 'Katherine Smith', 'Tim O''Brien')Символ процента (%) означает, что на этом месте может быть что угодно – один символ или сотня, или ни одного. В качестве альтернативы, для поиска с помощью группового подстановочного знака, представляющего один символ, используйте знак подчеркивания (_). Следующий пример показывает выражение для выбора имен Catherine Smith и Katherine Smith:
OWNER_NAME LIKE '_atherine Smith'
Можно также использовать операторы больше (>), меньше (<), больше или равно (>=), меньше или равно (<=), не равно (<>) и BETWEEN, чтобы выбирать строковые значения на основании их сортировки. Например, этот запрос выбирает все города в покрытии, названия которых начинаются с букв от М до Z:
CITY_NAME >= 'M'
Строковые функции могут использоваться для форматирования строк. Например функция LEFT возвращает определенное количество символов начиная с левого края строки. Данный запрос возвращает все штаты, начинающиеся на букву A:
LEFT(STATE_NAME,1) = 'A'
Список поддерживаемых функций вы найдете в документации по своей РСУБД.
Часто используемые выражения: поиск значений NULL
Вы можете использовать ключевое слово NULL, чтобы отбирать объекты и записи, содержащие пустые поля. Перед ключевым словом NULL всегда стоит IS или IS NOT. Например, чтобы найти города, для которых не была введена численность населения по данным переписи 1996 года, можно использовать следующее выражение:
POPULATION IS NULL
Или, чтобы найти все города, для которых указана численность населения, используйте:
POPULATION96 IS NOT NULL
Если выбрано поле геометрии, поиск можно выполнять только по ключевым словам NULL и NOT NULL.
Часто используемые выражения: поиск чисел
Точка (.) всегда используется в качестве десятичного разделителя, независимо от региональных настроек. В выражениях в качестве разделителя десятичных знаков нельзя использовать запятую.
Вы можете запрашивать цифровые значения, используя операторы равно (=), не равно (<>), больше (>), меньше (<), больше или равно (>=) и меньше или равно (<=), а также BETWEEN(между), например:
POPULATION >= 5000
Числовые функции можно использовать для форматирования чисел. Например функция ROUND округляет до заданного количества десятичных знаков данные в файловой базе геоданных:
ROUND(SQKM,0) = 500
Список поддерживаемых числовых функций см. в документации по РСУБД.
Даты и время
Общие правила и часто используемые выражения
В таких источниках данных, как база геоданных, даты хранятся в полях даты–времени. Однако в шейп-файлах это не тек. Поэтому большинство из примеров синтаксиса запроса, представленных ниже, содержит ссылки на время. В некоторых случаях часть запроса, касающаяся времени, может быть без всякого вреда пропущена, когда известно, что поле содержит только даты; в других случаях её необходимо указывать, или запрос вернет синтаксическую ошибку.
Поиск полей с датой требует внимания к типу поля даты/времени и синтаксису, необходимому для вашего источника данных. Если вы создаете запрос в Конструкторе запросов в режиме Условие, правильный синтаксис будет сгенерирован автоматически. Ниже приведен пример запроса, который возвращает все записи после 1 января 2011, включительно, для поля даты/времени из файловой базы геоданных:
INCIDENT_DATE >= timestamp '2011-01-01 00:00:00'
Примечание:
В ArcGIS Pro невозможно вставить и просмотреть значение даты до 100 CE. Если вы используете тип даты, который хранит время, время 00:00:00 эквивалентно 12 часам ночи (полночи).
Когда значением даты является не нулевое значение (например, январь 12, 1999, 04:00:00), то запрос только даты не возвратит данную запись. Если вы задаете в запросе только дату для поля в формате дата-время, недостающие поля времени заполняются нулями, и будут выбраны только записи, время которых соответствует 12:00:00 a.m. (полуночи).
Таблица атрибутов отображает дату и время в удобном для пользователя формате, согласно вашим региональным установкам, а не в формате исходной базы данных. У этого подхода есть ряд недостатков:
- Строка, отображаемая в SQL-запросе, может иметь только небольшое сходство со значением, показанным в таблице, особенно когда в нее входит время. Например время, введенное как 00:00:15, отображается в атрибутивной таблице как 12:00:15 AM с региональными настройками США, а сопоставимый синтаксис запроса Datefield = '1899-12-30 00:00:15'.
- Атрибутивная таблица не имеет сведений об исходных данных, пока вы не сохраните изменения. Она сначала попытается отформатировать значения для соответствия её собственному формату, затем, поверх сохраненных изменений, она попытается подогнать получившиеся результаты для соответствия базе данных. По этой причине, вы можете вводить время в шейп-файл, но обнаружите, что оно удаляется при сохранении ваших изменений. Поле будет содержать значение '1899-12-30', которое будет отображаться как 12:00:00 AM или эквивалентно, в зависимости от ваших региональных настроек.
Синтаксис даты-времени для баз геоданных
Ниже приведены примеры SQL синтаксиса даты-времени, поддерживаемого файловыми базами геоданных, мобильными базами геоданных и датами в шейп-файле. Некоторые многопользовательские базы геоданных и источники данных РСУБД также поддерживают SQL синтаксис даты-времени, хотя для этих источников данных может требоваться немного иной SQL синтаксис.
Обратитесь к документации вашей системы управления базой данных, чтобы узнать об SQL синтаксисе конкретного выражения и поддерживаемых типах данных.
Примечание:
- Oracle не поддерживает поля, содержащие только дату (esriFieldTypeDateOnly), и поля, содержащие только время (esriFieldTypeTimeOnly).
- PostgreSQL не поддерживает поля временных меток со смещениями (esriFieldTypeTimestampOffset).
Файловые базы геоданных
Перед полями только с датами и полями только со временем в файловых базах геоданных должно стоять, соответственно, слово date или time. Перед полями, содержащими дату и время, должно стоять timestamp.
Datefield = timestamp 'yyyy-mm-dd'
Файловые базы геоданных поддерживают использование времени в поле даты, поэтому его можно добавить в выражение:
Datefield = timestamp 'yyyy-mm-dd hh:mm:ss'
Для полей только с датой, только со временем и временных меток со смещениями используйте следующие форматы:
//DateOnlyField = time 'yyyy-mm-dd' DateOnlyField = time '2003-01-08' //TimeOnlyField = date 'HH24:mm:ss' TimeOnlyField = date '14:35:00' //TimestampOffsetField = timestamp 'yyyy-mm-dd HH24:mm:ss -TZH:TZM' TimestampOffsetField = timestamp '2003-01-08 14:35:00 -08:00'
Мобильные базы геоданных
Перед некоторыми полями с датой стоит слово JULIANDAY. Другие синтаксически не форматируются в функции.
Datefield = JULIANDAY('yyyy-mm-dd')Мобильные базы геоданных поддерживают использование времени в поле с датами, поэтому его можно добавить в выражение:
Datefield = JULIANDAY('yyyy-mm-dd HH24:mm:ss')//TimestampOffsetField = 'yyyy-mm-dd HH24:mm:ss -TZH:TZM'
TimestampOffsetField = '2003-01-08 14:35:00 -08:00'
//DateOnlyField = JULIANDAY('yyyy-mm-dd')
DateOnlyField = JULIANDAY('2003-01-08')
//TimeOnlyField = 'HH24:mm:ss'
TimeOnlyField = '14:35:00'Шейп-файлы, покрытия и прочие файловые источники данных
Перед датами в шейп-файлах должно быть слово date.
Datefield = date 'yyyy-mm-dd'
Шейп-файлы и покрытия не поддерживают использование времени в поле даты.
Известные ограничения
Построение запросов к датам, находящимся в левой части (первой таблице) соединения, работает только для файловых источников данных, таких как файловые базы геоданных, шейп-файлы и таблицы DBF. Но возможен обходной путь при работе с другими, не файловыми, источниками, такими как многопользовательские базы геоданных, как описано ниже.
Запрос к датам левой части соединения будет выполнен успешно, если использовать ограниченную версию SQL, разработанную для файловых источников данных. Если вы не используете такой источник данных, можете перевести выражение для использования этого формата. Это можно сделать, убедившись, что выражение запроса включает поля из более чем одной присоединенной таблицы. Например, если соединены класс пространственных объектов и таблица (FC1 и Table1), и они поступают из многопользовательской базы геоданных, следующее выражение не будет выполнено или не вернет данные:
FC1.date = date #01/12/2001# FC1.date = date '01/12/2001'
Чтобы запрос был выполнен успешно, можно создать вот такой запрос:
FC1.date = date '01/12/2001' and Table1.OBJECTID > 0
Так как запрос включает поля из обеих таблиц, будет использована ограниченная версия SQL. В этом выражении Table1.OBJECTID всегда > 0 для записей, которые сопоставлены в процессе создания соединения, поэтому это выражение всегда верно для всех строк, содержащих сопоставления соединения.
Чтобы быть уверенным, что каждая запись с FC1.date = date '01/12/2001' выбрана, используйте следующий запрос:
FC1.date = date '01/12/2001' and (Table1.OBJECTID IS NOT NULL OR Table1.OBJECTID IS NULL)
Такой запрос будет выбирать все записи с FC1.date = date '01/12/2001', независимо от того, есть ли сопоставление при соединении для каждой отдельной записи.
Комбинированные выражения
Составные запросы могут комбинироваться путем соединения выражений операторами AND и OR. Вот пример запроса для выборки всех домов с общей площадью более 1500 квадратных футов и гаражом более чем на три машины:
AREA > 1500 AND GARAGE > 3
Когда вы используете оператор OR, по крайней мере одно из двух разделенных оператором OR выражений, должно быть верно для выбираемой записи, например:
RAINFALL < 20 OR SLOPE > 35
Используйте оператор NOT в начале выражения, чтобы найти объекты или записи, не соответствующие условию выражения, например:
NOT STATE_NAME = 'Colorado'
Оператор NOT можно комбинировать с AND и OR. Вот пример запроса, который выбирает все штаты Новой Англии за исключением штата Maine:
SUB_REGION = 'New England' AND NOT STATE_NAME = 'Maine'
Вычисления
Вычисления можно включить в запросы с помощью математических операторов +, –, * и /. Можно использовать вычисление между полем и числом, например:
AREA >= PERIMETER * 100
Вычисления также могут производиться между полями. Например чтобы найти районы с плотностью населения меньшим или равным 25 человек на 1 квадратную милю, можно использовать вот такой запрос:
POP1990 / AREA <= 25
Приоритет выражения в скобках
Выражения выполняются в последовательности, определяемой стандартными правилами. Например, заключённая в круглые скобки часть выражения выполняется раньше, чем часть выражения за скобками.
HOUSEHOLDS > MALES * (POP90_SQMI + AREA)
При редактирования выражения SQL можно добавить скобки в режиме редактирования SQL вручную или использовать команды Группировать и Разгруппировать в режиме условия, чтобы добавить или удалить их.
Подзапросы
Подзапрос – это запрос, вложенный в другой запрос и поддерживаемый только в базах геоданных. Подзапросы могут использоваться в SQL-выражении для применения предикативных или агрегирующих функций, или для сравнения данных со значениями, хранящимися в другой таблице и т.п. Это может быть сделано с помощью ключевых слов IN или ANY. Например этот запрос выбирает только те страны, которых нет в таблице indep_countries:
COUNTRY_NAME NOT IN (SELECT COUNTRY_NAME FROM indep_countries)
Примечание:
Шейп-файлы и прочие файловые источники данных, не относящиеся к базам геоданных, не поддерживают подзапросы. Подзапросы, выполняемые на версионных многопользовательских классах объектов и таблицах, не возвращают объекты, которые хранятся в дельта-таблицах. Файловые базы геоданных имеют ограниченную поддержку подзапросов, описанных в данном разделе, в то время, как многопользовательские базы геоданных поддерживают их полностью. Информацию обо всех возможностях подзапросов к многопользовательским базам геоданных смотрите в документации по своей РСУБД.
Этот запрос возвращает объекты, где GDP2006 больше, чем GDP2005 любых объектов, содержащихся в countries (странах):
GDP2006 > (SELECT MAX(GDP2005) FROM countries)
Поддержка подзапросов в файловых базах геоданных ограничена следующим:
- Скалярные подзапросы с операторами сравнения. Скалярный подзапрос возвращает одно значение, например:
GDP2006 > (SELECT MAX(GDP2005) FROM countries)
Для файловых баз геоданных, набор функций AVG, COUNT, MIN, MAX и SUM может использоваться лишь в скалярных подзапросах. - Предикат EXISTS, например:
EXISTS (SELECT * FROM indep_countries WHERE COUNTRY_NAME = 'Mexico')
Операторы
Ниже приведен полный список операторов, поддерживаемых файловыми базами геоданных, шейп-файлами, покрытиями и прочими файловыми источниками данных. Они также поддерживаются в многопользовательских базах геоданных, хотя для этих источников данных может требоваться иной синтаксис. Кроме нижеперечисленных операторов, многопользовательские базы геоданных поддерживают дополнительные возможности. Более подробную информацию см. в документации по своей РСУБД.
Арифметические операторы
Для сложения, вычитания, умножения и деления числовых значений можно использовать арифметические операторы.
| Оператор | Описание |
|---|---|
* | Арифметический оператор умножения |
/ | Арифметический оператор деления |
+ | Арифметический оператор сложения |
- | Арифметический оператор вычитания |
Операторы сравнения
Операторы сравнения используются для сравнения одного выражения с другим.
| Оператор | Описание |
|---|---|
< | Меньше. Может использоваться со строками (сравнение основывается на алфавитном порядке) и для числовых вычислений, а также дат. |
<= | Меньше или равно. Может использоваться со строками (сравнение основывается на алфавитном порядке) и для числовых вычислений, а также дат. |
<> | Не равно. Может использоваться со строками (сравнение основывается на алфавитном порядке) и для числовых вычислений, а также дат. |
> | Больше. Может использоваться со строками (сравнение основывается на алфавитном порядке) и для числовых вычислений, а также дат. |
>= | Больше или равно. Может использоваться со строками (сравнение основывается на алфавитном порядке) и для числовых вычислений, а также дат. |
IS [NOT] NULL | Выбирает запись, если там в определенном поле есть нулевое значение. Если перед NULL стоит NOT, запись будет выбрана, если в указанном поле есть какое-то значение. |
Логические операторы
Подобно операторам сравнения, логические операторы проверяют истинность выражения и возвращают значения, истинные для данного выражения.
| Оператор | Описание |
|---|---|
И | Соединяет два условия и выбирает запись, в которой оба условия являются истинными. Например, выполнение следующего запроса выберет все дома с площадью более 1 500 квадратных футов и гаражом на две и более машины: AREA > 1500 AND GARAGE > 2 |
[NOT] BETWEEN x AND y | Выбирает записи, если они содержат значение больше или равное x, но меньше или равное y. Если в начале указано NOT, запись будет выбрана, если значение находится вне заданного диапазона. Например это выражение выбирает все записи со значениями, которые больше или равны 1 и меньше или равны 10: OBJECTID BETWEEN 1 AND 10 Вот эквивалент этого выражения: OBJECTID >= 1 AND OBJECTID <= 10 Однако выражение с оператором BETWEEN обрабатывается быстрее, если у вас поле проиндексировано. |
[NOT] EXISTS | Возвращает TRUE (истинно), если подзапрос возвращает хотя бы одну запись; в противном случае возвращает FALSE (ложно). Например, данное выражение вернет TRUE, если поле OJBECTID содержит значение 50: EXISTS (SELECT * FROM parcels WHERE OBJECTID = 50) EXISTS поддерживается только файловыми и многопользовательскими базами геоданных. |
[NOT] IN | Выбирает запись, если она содержит одну из нескольких строк или значений в поле. Если впереди стоит NOT, будет выбрана запись, если в поле не содержится таких строк или значений. Например, это выражение будет искать четыре названия штатов: STATE_NAME IN ('Alabama', 'Alaska', 'California', 'Florida') |
x [NOT] LIKE y [ESCAPE 'escape-character'] | Используйте оператор LIKE (вместо оператора = ) с групповыми символами, если хотите построить запрос по части строки. Символ процента (%) означает, что на этом месте может быть что угодно – один символ или сотня, или ни одного. В качестве альтернативы, для поиска с помощью группового подстановочного знака, представляющего один символ, используйте знак подчеркивания (_). Если вам нужен доступ к несимвольным данным, используйте функцию CAST. Например, этот запрос возвращает числа, начинающиеся на 8, из целочисленного поля SCORE_INT: CAST (SCORE_INT AS VARCHAR(10)) LIKE '8%' Для включения символа (%) или (_) в вашу строку поиска, используйте ключевое слово ESCAPE для указания другого символа вместо escape, который в свою очередь обозначает настоящий знак процента или подчёркивания. Например данное выражение возвращает все строки, содержащие 10%, такие как 10% DISCOUNT или A10%: AMOUNT LIKE '%10$%%' ESCAPE '$' |
НЕ | Выбирает записи, не соответствующие указанному выражению. Например это выражение выберет все штаты, кроме Калифорнии (California): NOT STATE_NAME = 'California' |
ИЛИ | Соединяет два условия и выбирает запись, где истинно хотя бы одно условие. Например выполнение следующего запроса выберет все дома с площадью более 1,500 квадратных футов или гаражом на две и более машины: AREA > 1500 OR GARAGE > 2 |
Операторы строковой операции
| Оператор | Описание |
|---|---|
|| | Возвращает символьную строку, являющуюся результатом конкатенации двух или более строковых выражений. FIRST_NAME || MIDDLE_NAME || LAST_NAME |
Функции
Ниже приведен полный список функций, поддерживаемых файловыми базами геоданных, шейп-файлами, покрытиями и прочими файловыми источниками данных. Функции также поддерживаются в многопользовательских базах геоданных, хотя в этих источниках данных может использоваться иной синтаксис или имена функций. Кроме нижеперечисленных функций, многопользовательские базы геоданных поддерживают дополнительные возможности. Более подробную информацию см. в документации по своей РСУБД.
Функции дат
Все функции дат возвращают значение даты.
Файловые базы геоданных
| Функция | Описание |
|---|---|
CURRENT_DATE | Возвращает текущую дату. |
EXTRACT(extract_field FROM extract_source) | Возвращает фрагмент extract_field из extract_source. Аргумент extract_source является выражением даты–времени (DATE, DateOnly, TimeOnly, TimestampOffset). Значением аргумента extract_field может быть одно из следующих ключевых слов: YEAR, MONTH, DAY, HOUR, MINUTE или SECOND, MILLISECOND, TIMEZONE_HOUR, TIMEZONE_MINUTE. |
CURRENT TIME | Возвращает текущую дату. |
Примеры использования EXTRACT для файловой базы геоданных:
- EXTRACT(YEAR from DateOnly) > 1951
- EXTRACT(YEAR from DateTimestamp) > 1981
- EXTRACT(YEAR from TimestampOffset) > 1981
- EXTRACT(TIMEZONE_HOUR from timeStampOffset) > 3
- EXTRACT(TIMEZONE_MINUTE from timeStampOffset) = 30
Мобильные базы геоданных
| Функция | Описание |
|---|---|
CURRENT_DATE | Возвращает текущую дату. |
EXTRACT(extract_field, extract_source) | Возвращает фрагмент extract_field из extract_source. Аргумент extract_source является выражением даты–времени (DATE, DateOnly, TimeOnly, TimestampOffset). Значением аргумента extract_field может быть одно из следующих ключевых слов: YEAR, MONTH, DAY, HOUR, MINUTE или SECOND, MILLISECOND, TIMEZONE_HOUR, TIMEZONE_MINUTE. |
CURRENT TIME | Возвращает текущую дату. |
Примеры использования EXTRACT для мобильной базы геоданных:
- EXTRACT('YEAR', DateOnly) > 1951
- EXTRACT('YEAR', DateTimestamp) > 1981
- EXTRACT('YEAR', TimestampOffset) > 1981
- EXTRACT('TIMEZONE_HOUR', timeStampOffset) > 3
- EXTRACT('TIMEZONE_MINUTE', timeStampOffset) = 30
Строковые функции
Аргументы, обозначаемые как string_exp , могут быть названием столбца, строковой константой или результатом другой скалярной функции, где исходные данные могут быть представлены в виде символов.
Аргументы, обозначаемые character_exp, являются строками символов переменной длины.
Аргументы, указанные как start или length могут быть числовыми постоянными или результатами других скалярных функций, где исходные данные представлены числовым типом.
Строковые функции, перечисленные здесь, базируются на 1; то есть, первым символом в строке является символ 1.
| Функция | Описание |
|---|---|
CHAR_LENGTH(string_exp) | Возвращает длину строкового выражения в символах. |
LOWER(string_exp) | Возвращает строку, идентичную string_exp, в которой все символы верхнего регистра изменены на символы нижнего регистра. |
POSITION(character_exp IN character_exp) | Возвращает место первого символьного выражения во втором символьном выражении. Результат – число с точностью, определяемой реализацией и коэффициентом кратности 0. |
SUBSTRING(string_exp FROM start FOR length) | Возвращает символьную строку, извлекаемую из string_exp, начинающуюся с символа, положение которого определяется символами start и length. |
TRIM(BOTH | LEADING | TRAILING trim_character FROM string_exp) | Возвращает string_exp с удаленным trim_character с начала, с конца или с обоих концов строки. |
UPPER(string_exp) | Возвращает строку, идентичную string_exp, в которой все символы нижнего регистра изменены на символы верхнего регистра. |
Числовые функции
Все числовые функции возвращают числовые значения.
Аргументы, обозначенные как numeric_exp, float_exp или integer_exp, могут быть именем столбца, результатом другой скалярной функции или числовой константой, где исходные данные могут быть представлены числовым типом.
| Функция | Описание |
|---|---|
ABS(numeric_exp) | Возвращает абсолютное значение numeric_exp. |
ACOS(float_exp) | Возвращает угол в радианах, равный арккосинусу float_exp. |
ASIN(float_exp) | Возвращает угол в радианах, равный арксинусу float_exp. |
ATAN(float_exp) | Возвращает угол в радианах, равный арктангенсу float_exp. |
CEILING(numeric_exp) | Возвращает наименьшее целочисленное значение, большее или равное numeric_exp. |
COS(float_exp) | Возвращает косинус float_exp в котором float_exp —угол, выраженный в радианах. |
FLOOR(numeric_exp) | Возвращает наибольшее целое значение, меньшее или равное numeric_exp. |
LOG(float_exp) | Возвращает натуральный логарифм float_exp. |
LOG10(float_exp) | Возвращает логарифм по основанию 10 float_exp. |
MOD(integer_exp1, integer_exp2) | Возвращает результат деления integer_exp1 на integer_exp2. |
POWER(numeric_exp, integer_exp) | Возвращает значение numeric_exp в степени integer_exp. |
ROUND(numeric_exp, integer_exp) | Возвращает numeric_exp, округленное до integer_exp знаков справа от десятичной точки. Если integer_exp отрицательное, numeric_exp округляется до |integer_exp| знаков слева от десятичной запятой. |
SIGN(numeric_exp) | Возвращает указатель знака numeric_exp. Если numeric_exp меньше нуля, возвращается -1. Если numeric_exp равно нулю, возвращается 0. Если numeric_exp больше нуля, возвращается 1. |
SIN(float_exp) | Возвращает синус float_exp, где float_exp — угол, выраженный в радианах. |
TAN(float_exp) | Возвращает тангенс float_exp, где float_exp — угол, выраженный в радианах. |
TRUNCATE(numeric_exp, integer_exp) | Возвращает numeric_exp, округленное до integer_exp знаков справа от десятичной запятой. Если integer_exp отрицательное, numeric_exp округляется до |integer_exp| знаков слева от десятичной запятой. |
Функция CAST
Функция CAST() преобразует значение или выражение из одного типа данных в другой указанный тип данных. Синтаксис выглядит так:
CAST (expression AS data_type(length))
- Где expression - обязательный параметр, который может быть буквальным значением или допустимым выражением любого типа (например, имя столбца, переменная), который будет преобразован.
- Где data_type - обязательный параметр, а используемое ключевое слово - это результирующий тип данных, к которому будет приведено выражение. В таблице ниже представлен список ключевых слов, используемых для допустимых типов данных.
- Где length - необязательный параметр, указывающий длину результирующего типа данных.
Например, в некоторых сценариях может потребоваться строковая операция, но запрос не будет работать, если данные хранятся в поле числового типа. Однако с помощью функции CAST() вы можете преобразовать числовое поле в строку для операции SQL. Этот код преобразует числовое поле SQLNUM в текстовое поле, которое затем можно использовать в текстовой операции.
CAST(SQLNUM AS CHARACTER(12))
В следующей таблице содержатся ключевые слова, используемые для преобразования типов данных, которые могут быть указаны в верхнем или нижнем регистре.
| Тип данных | Ключевое слово |
|---|---|
Long Integer |
|
Short Integer |
|
Float (с плавающей точкой одинарной точности) |
|
Double (с плавающей точкой двойной точности) |
|
String |
|
Дата и время |
|
Примечание:
| |
Примеры функции CAST
- Пример 1:
CAST(AREA AS INTEGER)
Приведение AREA, которое является типом данных Float, к INTEGER возвращает целое число и усекает любое значение результата после десятичного.
- Пример 2:
CAST(Rent AS FLOAT) + Utilities > 2000.45
Приведение Rent, которое является типом данных CHARACTER, к типу данных FLOAT, а Utilities также является типом данных FLOAT.
EsriCast
Операторы SQLite CAST работают с собственными типами данных. Однако с выпуском новых типов полей, а также других, "не родных" типов данных, вам необходимо настроить операторы для правильной работы SQLite. EsriCast предназначен, для того чтобы позволить операторам SQLite мобильных баз геоданных понимать различные типы данных, с которыми ArcGIS Pro может работать.
Пример синтаксиса: EsriCast(expression, source_data_type, target_data_type)
Ключевые слова данных EsriCast
| Тип данных | Ключевое слово EsriCast |
|---|---|
Short | Int16 |
Long | Int32 |
Big Integer | Int64 |
Float | Float32 |
Double | Float64 |
Только дата | DateOnly |
Только время | TimeOnly |
Смещение Дата/Время | Временная отметка |
Дата Время | Дата |
Текст | Текст |
Примеры конвертации данных EsriCast
| Тип данных в Тип данных | Синтаксис EsriCast |
|---|---|
Короткое целое в Длинное целое | EsriCast(FC_Short_Data,'int16','int32') |
Большое целочисленное в Короткое целое | EsriCast(FC_BigInteger_Data, 'int64', 'int16') |
Число с плавающей точкой в Число двойной точности | EsriCast(FC_Float_Data, 'float32', 'float64') |
Дата/Время в Только дата | EsriCast(FC_DateTime_Data, 'date', 'dateonly') |
Только время в Сдвиг метки времени | EsriCast(FC_TimeOnly_Data, 'timeonly', 'timestamp') |
Текст в Короткое целое | EsriCast(FC_Text_Data, 'text', 'int16') |