适用于:
Databricks SQL
Databricks 运行时 17.1 及以上
Lakehouse//RT
Important
此功能目前以公共预览版提供。
表示地理对象(点、线字符串、多边形等),其坐标引用系统是地理对象,并由类型的 SRID 值 GEOGRAPHY 描述。 地理对象所在的基础空间是一个周期性空间,第一个轴表示经度(以度为单位),第二个轴表示纬度(以度为单位)。 坐标应位于 [-180, 180] 经度和 [-90, 90] 纬度范围内。
Note
GEOGRAPHY 在度量视图或 Lakeflow 管道物化视图中,列不被支持作为尺寸,因为这些上下文需要 GROUP BY 支持,而地理空间数据目前还不提供此类支持。 若要在指标视图中使用地理空间数据,请将列添加为度量值而不是维度。
Syntax
GEOGRAPHY ( { srid | ANY } )
Limits
类型为GEOGRAPHY(ANY)的列可以保存地理数据,并且每行的 SRID 值可以不同。
无法永久保存 GEOGRAPHY(ANY) 类型的列。
唯一允许用于 GEOGRAPHY 类型的 SRID 值是 4326。
如果用户尝试定义包含 SRID 值以外的GEOGRAPHY列,用户将收到4326错误。
Literals
有关如何创建 GEOGRAPHY 值的详细信息,请参阅:
-
st_geogfromewkt函数 -
st_geogfromgeojson函数 -
st_geogfromtext函数 -
st_geogfromwkb函数 -
st_geogfromwkt函数 -
to_geography函数 -
try_to_geography函数
Notes
- 若要将
GEOGRAPHY值转换为地理空间标准或广泛使用的格式之一,可以使用:-
st_asbinary功能 ,用于以 WKB 格式导出 aGEOGRAPHY -
st_asewkt功能用于 导出GEOGRAPHY扩展 WKT(EWKT)格式。 -
st_asgeojson函数 ,用于导出 GeoJSONGEOGRAPHY格式。 -
st_astext导出 WKT 格式的 aGEOGRAPHY功能。
-
Examples
> SELECT hex(st_asbinary(st_geogfromtext('POINT(1 2)')));
0101000000000000000000f03f0000000000000040
> SELECT st_asewkt(st_geogfromwkb(X'0101000000000000000000f03f0000000000000040'));
SRID=4326;POINT(1 2)
> SELECT st_asgeojson(st_geogfromtext('POINT(1 2)'));
{"type":"Point","coordinates":[[1,2]]}
> SELECT st_astext(st_geogfromgeojson('{"type":"Point","coordinates":[[1,2]]}'));
POINT(1 2)
> SELECT st_astext(to_geography('{"type":"Point","coordinates":[[1,2]]}'));
POINT(1 2)
> SELECT try_to_geography('not a geography value');
NULL