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()

PointFromWKB(wkb[, srid])

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()是同义词。

ST_PointFromWKB(wkb[, srid])

使用其 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()是同义词。