適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
使用指定的半徑傳回輸入 GEOMETRY 值的緩衝區。
Syntax
st_buffer ( geoExpr, radiusExpr )
Arguments
-
geoExpr:一個GEOMETRY值。 -
radiusExpr:作為緩衝區半徑的DOUBLE值。 半徑的單位是幾何座標參考系統的單位。
Returns
使用指定的半徑傳回輸入 GEOMETRY 值的緩衝區。
緩衝區是這個幾何體與一個半徑為指定半徑 radiusExpr的圓盤的 Minkowski 總和(如果半徑為非負數)或 Minkowski 差異(如果半徑為負數)。 理論上,結果的邊界由圓或圓弧組成。 在這裡,我們會使用聚合線條來近似這些弧線,並以幾何值傳回結果。
結果一律為 2D 多邊形或多面形(捨棄輸入中的 Z 和 M 座標)。
Examples
-- Expands a point into a circle-like polygon with a 1-unit radius.
> SELECT st_astext(st_envelope(st_buffer(st_geomfromtext('POINT(0 0)'), 1)));
POLYGON((-1 -1,-1 1,1 1,1 -1,-1 -1))
-- Shrinks a small polygon so much that nothing is left
> SELECT st_astext(st_buffer(st_geomfromtext('POLYGON((0 0,2 0,2 2,0 2,0 0))'), -5));
POLYGON EMPTY