Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_AsEWKB

Última atualização: Aug 22, 2026

Retorna a representação Extended Well-Known Binary (EWKB) de um objeto de geometria ou geografia. Diferentemente do padrão Well-Known Binary (WKB), a saída inclui o identificador de referência espacial (SRID).

Sintaxe

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

Parâmetros

Parâmetro

Descrição

g1

Objeto de geometria ou geografia a serializar.

NDRorXDR

Ordem de bytes da saída. Valores válidos: XDR (big endian) e NDR (little endian). O valor padrão é NDR.

Notas de uso

  • O WKB padrão não inclui SRID. Use ST_AsEWKB quando o sistema de destino exigir metadados de SRID incorporados à saída binária.

  • Tipos de geometria compatíveis: strings circulares, curvas, superfícies poliédricas, triângulos, superfícies de rede irregular triangulada (TIN) e objetos 3D.

Exemplos

Retorne o EWKB com a ordem de bytes little endian padrão:

SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326));

Saída:

                           st_asewkb
---------------------------------------------------------------
 \x0103000020e61000000100000005000000000000000000f03f000000000.
.000f03f000000000000f03f00000000000000400000000000000040000000.
.00000000400000000000000040000000000000f03f000000000000f03f000.
.000000000f03f
(1 row)

Retorne o EWKB com ordem de bytes big endian:

SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326),'XDR');

Saída:

                           st_asewkb
---------------------------------------------------------------
 \x0020000003000010e600000001000000053ff00000000000003ff000000.
.00000003ff000000000000040000000000000004000000000000000400000.
.000000000040000000000000003ff00000000000003ff00000000000003ff.
.0000000000000
(1 row)