All Products
Search
Document Center

ApsaraDB RDS:ST_MetaData

Last Updated:Mar 29, 2026

Mengembalikan metadata dari objek raster atau band tertentu dalam bentuk string JSON.

Tiga bentuk overload mengikuti pola progresif:

  • Tanpa key: mengembalikan semua item metadata sebagai objek JSON.

  • Dengan `key`: mengembalikan nilai untuk satu item metadata; gunakan 'all' untuk mendapatkan semua item sebagai objek JSON.

  • Dengan band dan key: sama seperti di atas, tetapi terbatas pada metadata dari band tertentu.

Sintaksis

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

Parameter

ParameterTipeDeskripsi
raster_objrasterObjek raster.
bandintegerNomor band, dimulai dari 0.
keytextNama item metadata yang akan diambil. Berikan 'all' untuk mengembalikan semua item metadata sebagai objek JSON.

Nilai kembalian

Ketiga bentuk overload mengembalikan text.

Pola pemanggilanNilai kembalian
Tanpa argumen keySemua item metadata sebagai objek JSON
key diatur ke nama tertentuNilai dari item metadata tersebut
key diatur ke 'all'Semua item metadata sebagai objek JSON
band + key diatur ke nama tertentuNilai dari item metadata tersebut pada band yang ditentukan
band + key diatur ke 'all'Semua item metadata dari band yang ditentukan sebagai objek JSON

Contoh

Ambil semua metadata tingkat objek

SELECT ST_MetaData(raster_obj) FROM raster_table;

Ambil item metadata tertentu berdasarkan nama

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

Output:

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

Ambil semua metadata tingkat objek menggunakan key='all'

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

Output:

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

Ambil item metadata tertentu dari sebuah band

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

Output:

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

Ambil semua metadata untuk sebuah band menggunakan key='all'

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

Output:

{"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"}