ST_Multi - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

ST_Multi

ST_Multi converte uma geometria para o multitipo correspondente. Se a geometria de entrada já é um multitipo ou uma coleção de geometria, uma cópia dela é retornada. Se a geometria de entrada for ponto, uma linestring ou um polígono, será retornado um multiponto, um multipolígono ou um multipolígono, respectivamente, que contenha a geometria de entrada.

Sintaxe

ST_Multi(geom)

Argumentos

geom

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

GEOMETRY com subtipo MULTIPOINT, MULTILINESTRING, MULTIPOLYGON ou GEOMETRYCOLLECTION.

O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) da geometria retornada é o mesmo da geometria de entrada.

Nulo será retornado se geom for nulo.

Exemplos

O SQL a seguir retorna um multiponto de um multiponto de entrada. 

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('MULTIPOINT((1 2),(3 4))', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;MULTIPOINT((1 2),(3 4))

O SQL a seguir retorna um multiponto de um ponto de entrada. 

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('POINT(1 2)', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;MULTIPOINT((1 2))

O SQL a seguir retorna uma coleção de geometria de uma coleção de geometria de entrada. 

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('GEOMETRYCOLLECTION(POINT(1 2),MULTIPOINT((1 2),(3 4)))', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;GEOMETRYCOLLECTION(POINT(1 2),MULTIPOINT((1 2),(3 4)))