Topik ini menjelaskan fungsi ST_SubRaster, yang mentransformasikan level piramida atau band dari objek raster.
Sintaksis
raster ST_SubRaster(raster raster_obj,
integer pyramidLevel default 0,
cstring bands default '', /* Semua band */
cstring storageOption default '')
Parameter
| Parameter | Deskripsi |
| raster_obj | Objek raster asli yang level piramida atau band-nya ingin Anda transformasikan. |
| pyramidLevel | Level piramida yang ingin Anda transformasikan. |
| bands | Band yang ingin Anda transformasikan. Nilai bidang ini bisa berupa array bilangan bulat atau rentang bilangan bulat mulai dari 0. Contoh: "0-2" dan "1,2,3". Nilai default: string kosong (''). Nilai default menentukan untuk mentransformasikan semua band. |
| storageOption | String JSON yang menentukan cara menyimpan objek raster baru. |
Tabel berikut menggambarkan bidang dalam parameter storageOption.
| Bidang | Deskripsi | Tipe | Nilai default | Catatan pengaturan |
| chunking | Menentukan apakah akan menyimpan objek raster baru sebagai chunk. | Boolean | Sama dengan objek raster asli | Tidak tersedia. |
| chunkdim | Dimensi yang digunakan untuk menyimpan objek raster baru sebagai chunk. | String | Sama dengan objek raster asli | Bidang ini hanya berlaku ketika bidang chunking disetel ke true. |
| chunktable | Nama tabel chunk. | String | String kosong ('') | Secara default, tabel chunk sementara dengan nama acak dibuat untuk menyimpan data. Tabel chunk sementara ini hanya valid dalam sesi saat ini. Untuk menyimpan objek raster baru secara permanen, Anda harus menentukan bahwa Anda ingin membuat tabel chunk permanen di bidang chunktable. |
| compression | Format yang digunakan untuk kompresi gambar. | String | Sama dengan objek raster asli | Enam format kompresi didukung: None, JPEG, Zlib, PNG, LZO, dan LZ4. |
| quality | Kualitas gambar dari objek raster baru. | Integer | Sama dengan objek raster asli | Bidang ini hanya berlaku dalam format JPEG. |
| interleaving | Jenis interleaving dari objek raster baru. | String | Sama dengan objek raster asli | Nilai valid:
|
| endian | Format endian dari objek raster baru. | String | Sama dengan objek raster asli | Nilai valid:
|
Contoh
SELECT ST_SubRaster(rast, 1, '0-2', '{"chunktable":"chunk_table", "chunking":true}')
FROM raster_sub
WHERE id=1;