适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
表示一个几何对象,如点、线串、多边形等,其坐标参考系统是欧几里得的,适用于第一个(X)和第二个(Y)坐标,以及(如果存在的话)它的 Z 坐标。 基础坐标参考系统由 GEOMETRY
类型的 SRID 值描述。 如果基础坐标引用系统未知,则使用值 0
。 X、Y、(可选)Z 坐标的单位是 SRID 隐含的(除非 SRID 值 0
,在这种情况下取决于用户的使用上下文)。
注释
Iceberg 表不支持 GEOMETRY
列。
语法
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