すべてのプロダクト
Search
ドキュメントセンター

PolarDB:ST_AsBinary

最終更新日:Jul 01, 2024

このトピックでは、ST_AsBinary関数について説明します。 この関数は、ジオメトリオブジェクトまたはgeographyオブジェクトを表すWell-Known Binary (WKB) 文字列を返します。 返されるWKB文字列には、空間参照識別子 (SRID) メタデータが含まれていません。

構文

bytea  ST_AsBinary(geometry g1);
bytea  ST_AsBinary(geometry g1, text NDRorXDR);
bytea  ST_AsBinary(geography g1);
bytea  ST_AsBinary(geography g1, text NDRorXDR);

パラメーター

項目

説明

g1

WKB表現を取得するジオメトリオブジェクトまたは地理オブジェクト。

NDRorXDR

使用するバイトオーダー。 有効な値:

  • XDR: ビッグエンディアン。

  • NDR: リトルエンディアン。 デフォルト値です。

説明 

  • WKB仕様は、標準WKBストリングがSRIDを含まないことを定義する。 SRIDを含むWKB文字列を取得する場合は、ST_AsEWKB関数を使用します。

  • この関数は、円形ストリング、カーブ、多面体サーフェス、三角形、三角形不規則ネットワーク (TIN) サーフェス、および3Dオブジェクトをサポートします。

  • デフォルトのリトルエンディアンバイト順序を保持したWKB文字列を取得します。

    SELECT ST_AsBinary(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326));
                              st_asbinary
    ---------------------------------------------------------------
     \x01030000000100000005000000000000000000f03f000000000000f03f0.
    .00000000000f03f0000000000000040000000000000004000000000000000.
    .400000000000000040000000000000f03f000000000000f03f00000000000.
    .0f03f
    (1 row)
  • 指定されたビッグエンディアンバイト順序を持つWKB文字列を取得します。

    SELECT ST_AsBinary(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326),'XDR');
                              st_asbinary
    ---------------------------------------------------------------
     \x000000000300000001000000053ff00000000000003ff00000000000003.
    .ff00000000000004000000000000000400000000000000040000000000000.
    .0040000000000000003ff00000000000003ff00000000000003ff00000000.
    .00000
    (1 row)