カテゴリ:

地理空間関数、 変換関数

TRY_TO_GEOMETRY

入力を解析し、 GEOMETRY 型の値を返します。

この関数は基本的に TO_GEOMETRY と同じですが、 TO_GEOMETRY がエラーを発行したときに NULL を返す点が異なります。

こちらもご参照ください。

TO_GEOMETRY

構文

次のいずれかを使用します。

TRY_TO_GEOMETRY( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

TRY_TO_GEOMETRY( <binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

TRY_TO_GEOMETRY( <variant_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

引数

必須:

varchar_expression

引数は、次のいずれかの形式で有効なジオメトリオブジェクトを表す文字列式である必要があります。

  • WKT （よく知られているテキスト）。

  • WKB （周知のバイナリ）16進数形式（先頭に 0x なし）。

  • EWKT （周知のテキスト）。

  • EWKB （周知のバイナリ）16進数形式（先頭に 0x なし）。

  • GeoJSON

binary_expression

引数は WKB または EWKB 形式のバイナリ式である必要があります。

variant_expression

引数は、 GeoJSON 形式の OBJECT である必要があります。

オプション:

srid

使用する SRID の整数値。

allow_invalid

TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 無効な地理空間形状の処理方法の指定 をご参照ください。

戻り値

この関数は、 GEOMETRY 型の値を返します。

使用上の注意

  • 入力が、サポートされている適切な形式（WKT、 WKB、 EWKT、 EWKB、 GeoJSON）として解析できない場合は、 NULL を返します。

  • GeoJSON、 WKT、および WKB 入力の場合は、 srid 引数が指定されていないと、結果の GEOMETRY オブジェクトの SRID は0に設定されます。

例

これは、 TRY_TO_GEOMETRY 関数と VARCHAR データの簡単な使用法を示しています。

select try_to_geometry('INVALID INPUT');
Copy
+--------------------------------------+
| try_to_geometry('INVALID INPUT')     |
|--------------------------------------|
| NULL                                 |
+--------------------------------------+
Copy
言語: 日本語