st_force2d fonksiyon

Şunun için geçerlidir: Databricks SQL Databricks Runtime 18.1 ve üzeri

Önemli

GEOGRAPHY değerleri desteği Genel Önizleme aşamasındadır. GEOMETRY değerleri için destek genel kullanıma sunulmuştur.

Note

Bu özellik Databricks SQL Klasik ambarlarında kullanılamaz. Databricks SQL ambarları hakkında daha fazla bilgi edinmek için bkz. SQL ambar türleri.

Girişin GEOGRAPHY veya GEOMETRY değerin 2B projeksiyonunu döndürür.

Sözdizimi

st_force2d ( geoExpr )

Argümanlar

• geoExpr: Bir GEOGRAPHY veya GEOMETRY değer.

İadeler

Giriş değerinin 2B projeksiyonunu temsil eden veya GEOGRAPHYtüründe GEOMETRY bir değer.

Çıkışın GEOGRAPHY veya GEOMETRY değerin SRID değeri, giriş değerinin değerine eşittir.

İşlev, birinci parametre NULL ise NULL döndürür.

Notlar

Girişin Z veya M koordinatları varsa, bunlar çıkışta dışlanır.

Giriş zaten 2B ise işlev değişmeden döndürür.

Örnekler

-- Drops the M coordinate from a point geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POINT M (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a multipoint geography.
> SELECT st_astext(st_force2d(st_geogfromtext('MULTIPOINT ZM (EMPTY,0 0 10 20, 1 1 11 21)')));
  MULTIPOINT(EMPTY,(0 0),(1 1))
-- Drops the Z coordinate from a polygon geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POLYGON Z ((0 0 2,1 0 3,0 1 4,0 0 5))')));
  POLYGON((0 0,1 0,0 1,0 0))
-- Drops the Z coordinate from a point geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT Z (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a linestring geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('LINESTRING ZM (0 0 10 20, 1 1 11 21)')));
  LINESTRING(0 0,1 1)
-- Returns the input 2D geometry as is.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT(1 2)')));
  POINT(1 2)
-- Preserves the SRID of the input geography.
> SELECT st_srid(st_force2d(st_geogfromtext('POINT(1 2)')));
  4326
-- Preserves the SRID of the input geometry.
> SELECT st_srid(st_force2d(st_geomfromtext('POINT(1 2)', 4326)));
  4326
-- Returns NULL if the input is NULL.
> SELECT st_force2d(NULL);
   NULL

İlgili işlevler

• st_ndims işlev