GEOMETRY 类型

适用于： Databricks SQL Databricks Runtime 17.1 及更高版本

表示一个几何对象，如点、线串、多边形等，其坐标参考系统是欧几里得的，适用于第一个（X）和第二个（Y）坐标，以及（如果存在的话）它的 Z 坐标。 基础坐标参考系统由 GEOMETRY 类型的 SRID 值描述。 如果基础坐标引用系统未知，则使用值 0 。 X、Y、（可选）Z 坐标的单位是 SRID 隐含的（除非 SRID 值 0 ，在这种情况下取决于用户的使用上下文）。

语法

GEOMETRY ( { srid | ANY } )

限制

类型为 GEOMETRY(ANY) 的列可以存储每行其 SRID 值不同的几何图形。 无法持久保存类型 GEOMETRY(ANY) 列。

支持大约 11000 个 SRID 值。

如果用户尝试定义具有不受支持的 SRID 值的列，用户将收到GEOMETRY错误。

文本

有关如何创建 GEOMETRY 值的详细信息，请参阅：

• st_geomfromgeojson 函数
• st_geomfromtext 函数
• st_geomfromwkb 函数
• st_geomfromwkt 函数
• to_geometry 函数
• try_to_geometry 函数

注释

• 若要将 GEOMETRY 值转换为地理空间标准或广泛使用的格式之一，可以使用：
  • st_asbinary 用于 导出 GEOMETRY WKB 格式的函数。
  • st_asewkb 函数 以扩展 WKB （EWKB） 格式导出 GEOMETRY 。
  • st_asewkt 函数 以扩展 WKT （EWKT） 格式导出 GEOMETRY 。
  • st_asgeojson 用于 导出 GEOMETRY GeoJSON 格式的函数。
  • st_astext 函数 以 WKT 格式导出 GEOMETRY 。

例子

> SELECT hex(st_asbinary(st_geomfromtext('POINT(1 2)')));
  0101000000000000000000f03f0000000000000040

> SELECT st_asewkt(st_geomfromwkb(X'0101000000000000000000f03f0000000000000040'));
  POINT(1 2)

> SELECT st_asgeojson(st_geomfromtext('POINT(1 2)'));
  {"type":"Point","coordinates":[[1,2]]}

> SELECT st_astext(st_geomfromgeojson('{"type":"Point","coordinates":[[1,2]]}'));
  POINT(1 2)

> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[[1,2]]}'));
  POINT(1 2)

> SELECT try_to_geometry('not a geometry value');
  NULL

相关内容

• st_asbinary 函数
• st_asgeojson 函数
• st_asewkb 函数
• st_asewkt 函数
• st_astext 函数
• st_geomfromewkb 函数
• st_geomfromgeojson 函数
• st_geomfromtext 函数
• st_geomfromwkb 函数
• to_geometry 函数
• try_to_geometry 函数