CREATE OR REPLACE SPATIAL REFERENCE SYSTEM
    srid srs_attribute ...

CREATE SPATIAL REFERENCE SYSTEM
    [IF NOT EXISTS]
    srid srs_attribute ...

srs_attribute: {
    NAME 'srs_name'
  | DEFINITION 'definition'
  | ORGANIZATION 'org_name' IDENTIFIED BY org_id
  | DESCRIPTION 'description'
}

srid, org_id: 32-bit unsigned integer

Это оператор, который создаёт определение пространственной справочной системы (SRS) и сохраняет его в словаре данных. В MySQL 9.2.0 и более поздних версиях требуется CREATE_SPATIAL_REFERENCE_SYSTEM разрешение (или SUPER). Полученную запись в словаре данных можно проверить, используя таблицу INFORMATION_SCHEMA ST_SPATIAL_REFERENCE_SYSTEMS.

Значения SRID должны быть уникальными, поэтому если не указано ни OR REPLACE, ни IF NOT EXISTS, возникает ошибка, если определение SRS с заданным значением srid уже существует.

С помощью синтаксиса CREATE OR REPLACE любое существующее определение SRS с тем же значением SRID заменяется, если только это значение SRID не используется в каком-либо столбце существующей таблицы. В противном случае возникает ошибка. Например:

mysql> CREATE OR REPLACE SPATIAL REFERENCE SYSTEM 4326 ...;
ERROR 3716 (SR005): Can't modify SRID 4326. There is at
least one column depending on it.

Чтобы определить, какой столбец или столбцы используют SRID, используйте этот запрос, заменив 4326 на SRID определения, которое вы пытаетесь создать:

SELECT * FROM INFORMATION_SCHEMA.ST_GEOMETRY_COLUMNS WHERE SRS_ID=4326;

С помощью синтаксиса CREATE ... IF NOT EXISTS любое существующее определение SRS с тем же значением SRID приводит к игнорированию нового определения и появлению предупреждения.

Значения SRID должны находиться в диапазоне 32-битных беззнаковых целых чисел со следующими ограничениями:

Атрибуты оператора должны удовлетворять следующим условиям:

Вот пример оператора CREATE SPATIAL REFERENCE SYSTEM. Значение DEFINITION переформатировано на несколько строк для удобства чтения. (Для того, чтобы оператор был корректным, это значение должно быть на одной строке.)

CREATE SPATIAL REFERENCE SYSTEM 4120
NAME 'Greek'
ORGANIZATION 'EPSG' IDENTIFIED BY 4120
DEFINITION
  'GEOGCS["Greek",DATUM["Greek",SPHEROID["Bessel 1841",
  6377397.155,299.1528128,AUTHORITY["EPSG","7004"]],
  AUTHORITY["EPSG","6120"]],PRIMEM["Greenwich",0,
  AUTHORITY["EPSG","8901"]],UNIT["degree",0.017453292519943278,
  AUTHORITY["EPSG","9122"]],AXIS["Lat",NORTH],AXIS["Lon",EAST],
  AUTHORITY["EPSG","4120"]]';

Грамматика определений SRS основана на грамматике, определённой в Спецификации реализации OpenGIS: Услуги преобразования координат, Ревизия 1.00, OGC 01-009, 12 января 2001 г., раздел 7.2. Данная спецификация доступна по адресу http://www.opengeospatial.org/standards/ct.

MySQL включает следующие изменения в спецификацию:

Если определение SRS указывает код авторитета для проекции (что рекомендуется), возникает ошибка, если в определении отсутствуют обязательные параметры. В этом случае сообщение об ошибке указывает на причину проблемы. Методы проекций и обязательные параметры, поддерживаемые MySQL, показаны в таблице 15.7, «Поддерживаемые методы проекций пространственной справочной системы» и таблице 15.8, «Параметры проекций пространственной справочной системы».

В следующей таблице показаны поддерживаемые методы проекций. MySQL допускает неизвестные методы проекций, но не может проверять определение на наличие обязательных параметров и не может преобразовывать пространственные данные в или из неизвестной проекции. Подробные объяснения работы каждой проекции, включая формулы, см. в Руководстве по EPSG 7-2.

В следующей таблице показаны параметры проекции, которые распознает MySQL. Распознавание происходит в первую очередь по коду авторитета. Если код авторитета отсутствует, MySQL использует нечувствительное к регистру сопоставление по имени параметра. Для получения подробной информации о каждом параметре, найдите его по коду в Онлайн-реестре EPSG.