View a markdown version of this page

H3_Polyfill - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

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.

H3_Polyfill

H3_Polyfill retorna os IDs de célula H3 correspondentes aos hexágonos e pentágonos contidos no polígono de entrada da resolução indicada. Para obter informações sobre a indexação H3, consulte H3.

Sintaxe

H3_Polyfill(geom, resolution)

Argumentos

geom

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. A geom deve ser um POLYGON.

resolução

Um valor do tipo de dados INTEGER ou uma expressão avaliada como um tipo INTEGER. O valor representa a resolução do sistema de grade H3. O valor deve ser um número inteiro entre 0 e 15, inclusive. Com 0 sendo o mais aproximado e 15 sendo o mais preciso.

Tipo de retorno

SUPER: representa uma lista de IDs de células H3.

Se geom não for uma POLYGON, será retornado um erro.

Se resolução estiver fora dos limites, um erro será retornado.

Se geom estiver vazio, NULL será retornado.

Exemplos

O SQL a seguir retorna uma matriz do tipo de dados SUPER dos IDs de célula H3 de um polígono e uma resolução 4. 

SELECT H3_Polyfill(ST_GeomFromText('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'), 4);

 h3_polyfill
----------------------------------------------------------------------------------------------------------------------------------------------------------
 [596538848238895103,596538805289222143,596538856828829695,596538813879156735,596537920525959167,596538685030137855,596538693620072447,596538839648960511]