Definition
ST_Y wählt einen Eingabeparameter vom Typ "ST_Point" aus und gibt dessen Y-Koordinate zurück. In SQLite kann "ST_Y" auch die Y-Koordinate eines ST_Point aktualisieren.
Syntax
Oracle und PostgreSQL
sde.st_y (point1 sde.st_point)
SQLite
double st_y (point1 geometryblob) geometry st_y (input_shape geometryblob, new_Yvalue double)
Rückgabetyp
Doppelte Genauigkeit
Die Funktion "ST_Y" kann mit SQLite verwendet werden, um die Y-Koordinate eines Punktes zu aktualisieren. In diesem Fall wird ein geometryblob zurückgegeben.
Beispiel
Die Tabelle "y_test" wird mit zwei Spalten erstellt: der Spalte "gid", durch die die einzelnen Zeilen eindeutig gekennzeichnet werden, und der Spalte "pt1" vom Typ ST_Point.
Mit den INSERT-Anweisungen werden zwei Zeilen eingefügt. Eine Zeile enthält einen Punkt ohne Z-Koordinate oder Messwert. Die andere Zeile enthält sowohl eine Z-Koordinate als auch einen Messwert.
Die SELECT-Abfrage verwendet die Funktion "ST_Y", um die Y-Koordinate jedes Punkt-Features abzurufen.
Oracle
CREATE TABLE y_test (
gid integer unique,
pt1 sde.st_point
);
INSERT INTO Y_TEST VALUES (
1,
sde.st_pointfromtext ('point (10.02 20.02)', 4326)
);
INSERT INTO Y_TEST VALUES (
2,
sde.st_pointfromtext ('point zm(10.1 20.01 5.0 7.0)', 4326)
);
SELECT gid, sde.st_y (pt1) "The Y coordinate"
FROM Y_TEST;
GID The Y coordinate
1 20.02
2 20.01
PostgreSQL
CREATE TABLE y_test (
gid integer unique,
pt1 sde.st_point
);
INSERT INTO y_test VALUES (
1,
sde.st_point ('point (10.02 20.02)', 4326)
);
INSERT INTO y_test VALUES (
2,
sde.st_point ('point zm(10.1 20.01 5.0 7.0)', 4326)
);
SELECT gid, sde.st_y (pt1)
AS "The Y coordinate"
FROM y_test;
gid The Y coordinate
1 20.02
2 20.01
SQLite
CREATE TABLE y_test (gid integer);
SELECT AddGeometryColumn(
NULL,
'y_test',
'pt1',
4326,
'pointzm',
'xyzm',
'null'
);
INSERT INTO y_test VALUES (
1,
st_point ('point (10.02 20.02)', 4326)
);
INSERT INTO y_test VALUES (
2,
st_point ('point zm(10.1 20.01 5.0 7.0)', 4326)
);
SELECT gid, st_y (pt1)
AS "The Y coordinate"
FROM y_test;
gid The Y coordinate
1 20.02
2 20.01
Die Funktion "ST_Y" kann auch verwendet werden, um den Koordinatenwert eines vorhandenen Punktes zu aktualisieren. In diesem Beispiel wird der Y-Koordinatenwert des zweiten Punktes in "y_Test" mit "ST_Y" aktualisiert.
UPDATE y_test
SET pt1=st_y(
(SELECT pt1 FROM y_test WHERE gid=2),
20.1
)
WHERE gid=2;