Определение
ST_Z принимает ST_Point как входной параметр и возвращает координату z (высоту). В SQLite ST_Z также может обновить координату z ST_Point.
Синтаксис
Oracle и PostgreSQL
sde.st_z (geometry1 sde.st_point)
SQLite
st_z (geometry geometryblob) st_z (input_shape geometryblob, new_Zvalue double)
Тип возврата
Oracle
Число (Number)
PostgreSQL
Целочисленное (Integer)
SQLite
При возврате ST_Z координаты z точки используется двойная точность. При обновлении ST_Z координаты z точки возвращается geometryblob.
Пример:
Таблица z_test создается с двумя столбцами: id, который уникально определяет каждую строку, и точечным столбцом geometry. Инструкция INSERT вставляет строку в таблицу z_test.
Инструкция SELECT указывает ИД столбца и z-координату двойной точности точки, вставленной предыдущей инструкцией.
Oracle
CREATE TABLE z_test (
id integer unique,
geometry sde.st_point
);
INSERT INTO z_test (id, geometry) VALUES (
1,
sde.st_point (2, 3, 32, 5, 4326)
);
SELECT id, sde.st_z (geometry) Z_COORD
FROM Z_TEST;
ID Z_COORD
1 32
PostgreSQL
CREATE TABLE z_test (
id integer unique,
geometry sde.st_point
);
INSERT INTO z_test (id, geometry) VALUES (
1,
sde.st_point (2, 3, 32, 5, 4326)
);
SELECT id, sde.st_z (geometry)
AS Z_COORD
FROM z_test;
id z_coord
1 32
SQLite
CREATE TABLE z_test (id integer);
SELECT AddGeometryColumn(
NULL,
'z_test',
'pt1',
4326,
'pointzm',
'xyzm',
'null'
);
INSERT INTO z_test (id, pt1) VALUES (
1,
st_point (2, 3, 32, 5, 4326)
);
SELECT id, st_z (pt1)
AS "The z coordinate"
FROM z_test;
id The z coordinate
1 32.0
Функция ST_Z в SQLite также может обновить значение координаты существующей точки. В данном примере функция ST_Z используется для обновления значения координаты z первой точки в z_test.
UPDATE z_test
SET pt1=st_z(
(SELECT pt1 FROM z_test where id=1), 32.04)
WHERE id=1;