12.16.4 从 WKB 值创建几何值的函数
这些函数以BLOB作为参数,其中包含一个熟知的二进制(WKB)table 示形式,并可选地包含一个空间参考系统标识符(SRID)。它们返回相应的几何。
ST_GeomFromWKB()接受任何几何类型的 WKB 值作为其第一个参数。其他功能提供了特定于类型的构造功能,用于构造每种几何类型的几何值。
这些函数还接受第 12.16.5 节“创建几何值的特定于 MySQL 的函数”中的函数返回的几何对象。因此,这些功能可用于向本节中的功能提供第一个参数。但是,自 MySQL 5.7.19 起,不赞成使用几何参数并产生警告。 MySQL 8.0 不接受几何参数。要将调用从使用几何参数迁移到使用 WKB 参数,请遵循以下准则:
有关 WKB 格式的说明,请参见众所周知的二进制(WKB)格式。
-
将
ST_GeomFromWKB(Point(0, 0))
之类的结构重写为Point(0, 0)
。 -
将
ST_GeomFromWKB(Point(0, 0), 4326)
之类的结构重写为ST_GeomFromWKB(ST_AsWKB(Point(0, 0)), 4326)
。 (或者,在 MySQL 8.0 中,您可以使用ST_SRID(Point(0, 0), 4326)
.)
GeomCollFromWKB(wkb[, srid]), GeometryCollectionFromWKB(wkb[, srid])
ST_GeomCollFromWKB(),ST_GeometryCollectionFromWKB(),GeomCollFromWKB()和GeometryCollectionFromWKB()是同义词。有关更多信息,请参见ST_GeomCollFromWKB()的描述。
GeomCollFromWKB()和GeometryCollectionFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomCollFromWKB()和ST_GeometryCollectionFromWKB()。
GeomFromWKB(wkb[, srid]), GeometryFromWKB(wkb[, srid])
ST_GeomFromWKB(),ST_GeometryFromWKB(),GeomFromWKB()和GeometryFromWKB()是同义词。有关更多信息,请参见ST_GeomFromWKB()的描述。
GeomFromWKB()和GeometryFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomFromWKB()和ST_GeometryFromWKB()。
LineFromWKB(wkb[, srid]), LineStringFromWKB(wkb[, srid])
ST_LineFromWKB(),ST_LineStringFromWKB(),LineFromWKB()和LineStringFromWKB()是同义词。有关更多信息,请参见ST_LineFromWKB()的描述。
LineFromWKB()和LineStringFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_LineFromWKB()和ST_LineStringFromWKB()。
MLineFromWKB(wkb[, srid]), MultiLineStringFromWKB(wkb[, srid])
ST_MLineFromWKB(),ST_MultiLineStringFromWKB(),MLineFromWKB()和MultiLineStringFromWKB()是同义词。有关更多信息,请参见ST_MLineFromWKB()的描述。
MLineFromWKB()和MultiLineStringFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MLineFromWKB()和ST_MultiLineStringFromWKB()。
MPointFromWKB(wkb[, srid]), MultiPointFromWKB(wkb[, srid])
ST_MPointFromWKB(),ST_MultiPointFromWKB(),MPointFromWKB()和MultiPointFromWKB()是同义词。有关更多信息,请参见ST_MPointFromWKB()的描述。
MPointFromWKB()和MultiPointFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPointFromWKB()和ST_MultiPointFromWKB()。
MPolyFromWKB(wkb[, srid]), MultiPolygonFromWKB(wkb[, srid])
ST_MPolyFromWKB(),ST_MultiPolygonFromWKB(),MPolyFromWKB()和MultiPolygonFromWKB()是同义词。有关更多信息,请参见ST_MPolyFromWKB()的描述。
MPolyFromWKB()和MultiPolygonFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPolyFromWKB()和ST_MultiPolygonFromWKB()。
ST_PointFromWKB()和PointFromWKB()是同义词。有关更多信息,请参见ST_PointFromWKB()的描述。
PointFromWKB()已过时,将在以后的 MySQL 版本中删除。请改用ST_PointFromWKB()。
PolyFromWKB(wkb[, srid]), PolygonFromWKB(wkb[, srid])
ST_PolyFromWKB(),ST_PolygonFromWKB(),PolyFromWKB()和PolygonFromWKB()是同义词。有关更多信息,请参见ST_PolyFromWKB()的描述。
PolyFromWKB()和PolygonFromWKB()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_PolyFromWKB()和ST_PolygonFromWKB()。
ST_GeomCollFromWKB(wkb[, srid]), ST_GeometryCollectionFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个GeometryCollection
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_GeomCollFromWKB(),ST_GeometryCollectionFromWKB(),GeomCollFromWKB()和GeometryCollectionFromWKB()是同义词。
ST_GeomFromWKB(wkb[, srid]), ST_GeometryFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造任何类型的几何值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_GeomFromWKB(),ST_GeometryFromWKB(),GeomFromWKB()和GeometryFromWKB()是同义词。
ST_LineFromWKB(wkb[, srid]), ST_LineStringFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个LineString
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_LineFromWKB(),ST_LineStringFromWKB(),LineFromWKB()和LineStringFromWKB()是同义词。
ST_MLineFromWKB(wkb[, srid]), ST_MultiLineStringFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个MultiLineString
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_MLineFromWKB(),ST_MultiLineStringFromWKB(),MLineFromWKB()和MultiLineStringFromWKB()是同义词。
ST_MPointFromWKB(wkb[, srid]), ST_MultiPointFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个MultiPoint
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_MPointFromWKB(),ST_MultiPointFromWKB(),MPointFromWKB()和MultiPointFromWKB()是同义词。
ST_MPolyFromWKB(wkb[, srid]), ST_MultiPolygonFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个MultiPolygon
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_MPolyFromWKB(),ST_MultiPolygonFromWKB(),MPolyFromWKB()和MultiPolygonFromWKB()是同义词。
使用其 WKBtable 示形式和 SRID 构造一个Point
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_PointFromWKB()和PointFromWKB()是同义词。
ST_PolyFromWKB(wkb[, srid]), ST_PolygonFromWKB(wkb[, srid])
使用其 WKBtable 示形式和 SRID 构造一个Polygon
值。
如果 WKB 或 SRID 参数为NULL
,则结果为NULL
。
ST_PolyFromWKB(),ST_PolygonFromWKB(),PolyFromWKB()和PolygonFromWKB()是同义词。