適用対象:
Databricks SQL
Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
最初の GEOMETRY 値が 2 番目の GEOMETRY 値内にある場合は true を返します。
Syntax
st_within ( geo1, geo2 )
Arguments
-
geo1: 最初のGEOMETRY値。 -
geo2: 2 番目のGEOMETRY値。
Returns
最初のBOOLEAN値が 2 番目のGEOMETRY値内にあるかどうかを示す、GEOMETRY型の値。
この関数は、geometry コレクションをサポートしていません。
詳細と正式な定義については、DE-9IM マトリックス定義の Within 述語を参照してください。
いずれかの入力がNULLされている場合、関数はNULLを返します。
エラー条件
- いずれかの入力ジオメトリがジオメトリーコレクションの場合、この関数はST_INVALID_ARGUMENT.INVALID_TYPEを返します。
- 入力ジオメトリに同じ SRID 値がない場合、関数は ST_DIFFERENT_SRID_VALUESを返します。
Examples
-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false