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
| Parameter | Tipe | Deskripsi |
|---|---|---|
raster_obj | raster | Objek raster. |
band | integer | Nomor band, dimulai dari 0. |
key | text | Nama item metadata yang akan diambil. Berikan 'all' untuk mengembalikan semua item metadata sebagai objek JSON. |
Nilai kembalian
Ketiga bentuk overload mengembalikan text.
| Pola pemanggilan | Nilai kembalian |
|---|---|
Tanpa argumen key | Semua item metadata sebagai objek JSON |
key diatur ke nama tertentu | Nilai dari item metadata tersebut |
key diatur ke 'all' | Semua item metadata sebagai objek JSON |
band + key diatur ke nama tertentu | Nilai 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.0001488117874873806Ambil 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
-------------
1043112Ambil 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"}