Funzione st_makeenvelope

Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime 18.2 e versioni successive

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Restituisce un GEOMETRY valore che rappresenta la busta allineata all'asse 2D (rettangolo di selezione minimo) definita dalle due coordinate (x1, y1) dell'angolo e (x2, y2).

Syntax

st_makeenvelope ( x1, y1, x2, y2 )

Arguments

  • x1 DOUBLE: valore che rappresenta la coordinata X del primo angolo.
  • y1 DOUBLE: valore che rappresenta la coordinata Y del primo angolo.
  • x2 DOUBLE: valore che rappresenta la coordinata X del secondo angolo.
  • y2 DOUBLE: valore che rappresenta la coordinata Y del secondo angolo.

Returns

Valore di tipo GEOMETRY, che rappresenta la busta allineata all'asse 2D dei due angoli di input. Lo SRID della geometria restituita è 0.

Gli angoli di input possono essere forniti in qualsiasi ordine; la busta risultante è uguale a se gli angoli sono stati normalizzati in (xmin, ymin) e (xmax, ymax).

Il tipo della geometria restituita dipende dagli angoli di input:

  • Se la casella viene degenerata in un singolo punto (x1 = x2 e y1 = y2), il risultato è un punto.
  • Se la casella viene degenerata in un segmento (x1 = x2 o y1 = y2, ma non entrambi), il risultato è una linea con due punti.
  • In caso contrario, il risultato è un poligono con cinque vertici (anello chiuso).

La funzione restituisce NULL se uno degli input è NULL.

Examples

-- Returns the polygon envelope defined by two corners.
> SELECT st_astext(st_makeenvelope(1.0, 2.0, 4.0, 6.0));
  POLYGON((1 2,1 6,4 6,4 2,1 2))
-- Corners may be provided in any order.
> SELECT st_astext(st_makeenvelope(4.0, 6.0, 1.0, 2.0));
  POLYGON((1 2,1 6,4 6,4 2,1 2))
-- Returns a point when the box degenerates to a point.
> SELECT st_astext(st_makeenvelope(3.0, 5.0, 3.0, 5.0));
  POINT(3 5)
-- Returns a linestring when the box degenerates to a horizontal segment.
> SELECT st_astext(st_makeenvelope(1.0, 0.0, 4.0, 0.0));
  LINESTRING(1 0,4 0)
-- Returns a linestring when the box degenerates to a vertical segment.
> SELECT st_astext(st_makeenvelope(0.0, 2.0, 0.0, 7.0));
  LINESTRING(0 2,0 7)
-- The SRID of the returned geometry is always 0.
> SELECT st_srid(st_makeenvelope(0.0, 0.0, 10.0, 10.0));
  0
  • Last updated on