View a markdown version of this page

ST_Force4D - Amazon Redshift

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

ST_Force4D

ST_Force4D retorna uma geometria 4D da geometria de entrada. Para geometrias 2D, as coordenadas z e m dos pontos não vazios na geometria de saída são todas definidas como 0. Para geometrias 3DM, as coordenadas z dos pontos não vazios na geometria de saída são todas definidas como 0. Para geometrias 3DZ, as coordenadas m dos pontos não vazios na geometria de saída são todas definidas como 0. Para geometrias 4D, uma cópia da geometria de entrada será retornada. Pontos vazios na geometria de entrada permanecem pontos vazios na geometria de saída.

Sintaxe

ST_Force4D(geom)

Argumentos

geom

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

Tipo de retorno

GEOMETRY.

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada.

Nulo será retornado se geom for nulo.

Se geom estiver vazio, será retornado uma geometria vazia.

Exemplos

O SQL a seguir retorna uma geometria 4D de uma geometria 3DM.

SELECT ST_AsEWKT(ST_Force4D(ST_GeomFromText('MULTIPOINT M(0 1 2, EMPTY, 2 3 4, 5 6 7)')));
st_asewkt ----------- MULTIPOINT ZM ((0 1 0 2),EMPTY,(2 3 0 4),(5 6 0 7))