ST_MetaData - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Retorna metadados de um objeto raster ou de uma banda específica como uma string JSON.

As três sobrecargas seguem um padrão progressivo:

Sem key: retorna todos os itens de metadados como um objeto JSON.
Com key: retorna o valor de um único item de metadado; use 'all' para obter todos os itens como um objeto JSON.
Com band e key: igual ao anterior, mas restrito aos metadados de uma banda específica.

Sintaxe

text ST_MetaData(raster raster_obj);
text ST_MetaData(raster raster_obj,
                text key);
text ST_MetaData(raster raster_obj,
                integer band,
                text key);

Parâmetros

Parâmetro	Tipo	Descrição
`raster_obj`	raster	O objeto raster.
`band`	integer	O número da banda, iniciando em 0.
`key`	text	Nome do item de metadado a recuperar. Use `'all'` para retornar todos os itens de metadados como um objeto JSON.

Valor de retorno

Todas as três sobrecargas retornam text.

Padrão de chamada	Valor de retorno
Sem o argumento `key`	Todos os itens de metadados como um objeto JSON
`key` definido com um nome específico	Valor desse item de metadado
`key` definido como `'all'`	Todos os itens de metadados como um objeto JSON
`band` + `key` definido com um nome específico	Valor desse item de metadado na banda especificada
`band` + `key` definido como `'all'`	Todos os itens de metadados da banda especificada como um objeto JSON

Exemplos

Obter todos os metadados no nível do objeto

SELECT ST_MetaData(raster_obj) FROM raster_table;

Obter um item de metadado específico por nome

SELECT ST_MetaData(raster_obj, 'swh#scale_factor')
FROM raster_table;

Saída:

      st_metadata
-----------------------
 0.0001488117874873806

Obter todos os metadados no nível do objeto usando key='all'

SELECT ST_MetaData(raster_obj, 'all')
FROM raster_table;

Saída:

      st_metadata
-----------------------
{"AREA_OR_POINT":"Area"}

Obter um item de metadado específico de uma banda

SELECT ST_MetaData(raster_obj, 0, 'NETCDF_DIM_time')
FROM raster_table;

Saída:

 st_metadata
-------------
 1043112

Obter todos os metadados de uma banda usando key='all'

SELECT ST_MetaData(raster_obj, 0, 'all')
FROM raster_table;

Saída:

{"add_offset":"4.907141431495487","long_name":"Significant height of combined wind waves and swell","missing_value":"-32767","NETCDF_DIM_time":"1043112","NETCDF_VARNAME":"swh","scale_factor":"0.0001488117874873806","units":"m","_FillValue":"-32767"}