ST_SubRaster - PolarDB

Topik ini menjelaskan fungsi ST_SubRaster, yang digunakan untuk mengonversi level piramida tertentu atau band dari objek raster asli menjadi objek raster baru.

Sintaksis

raster ST_SubRaster(raster raster_obj ,
                    integer pyramidLevel default 0,
                    cstring bands default '',
                    cstring storageOption  default '',
                    cstring options default '{}')

Parameter

Parameter	Deskripsi
raster_obj	Nama objek raster asli.
pyramidLevel	Level piramida yang ingin Anda konversi.
bands	Band yang ingin Anda konversi. Nilai parameter ini dapat berupa array bilangan bulat atau rentang bilangan bulat. Bilangan bulat dimulai dari 0. Contoh: `'0-2'` dan `'1,2,3'`. Nilai default: `"`. Nilai default menentukan untuk menghasilkan objek raster baru berdasarkan semua band.
storageOption	String JSON yang menentukan cara menyimpan objek raster baru. Untuk informasi lebih lanjut, lihat parameter storageOption.
options	String JSON yang menentukan cara menghasilkan objek raster baru. Untuk informasi lebih lanjut, lihat parameter options.

Tabel berikut menjelaskan parameter dalam nilai parameter storageOption.

Parameter	Deskripsi	Tipe	Nilai default	Catatan
chunking	Menentukan apakah akan menyimpan objek raster baru sebagai chunk.	boolean	Sama dengan objek raster asli.	Tidak ada.
chunkdim	Dimensi yang digunakan untuk menyimpan objek raster baru sebagai chunk.	string	Sama dengan objek raster asli.	Parameter ini hanya valid jika parameter `chunking` diatur ke true.
chunktable	Nama tabel chunk yang digunakan untuk menyimpan objek raster baru.	string	`''`	Jika `''` atau nilai NULL ditentukan, tabel chunk sementara dengan nama acak dibuat untuk menyimpan data. Tabel chunk sementara ini hanya valid dalam sesi saat ini. Untuk membuat tabel chunk permanen untuk objek raster baru, Anda harus menentukan nama untuk tabel chunk.
compression	Format yang digunakan untuk mengompres objek raster.	string	Sama dengan objek raster asli.	Nilai valid: NONE JPEG ZLIB PNG LZO LZ4
quality	Kualitas gambar objek raster baru setelah kompresi.	integer	Sama dengan objek raster asli.	Nilai valid: 1 hingga 99. Parameter ini hanya valid jika parameter compression diatur ke JPEG.
interleaving	Tipe interleaving objek raster baru.	string	Sama dengan objek raster asli.	Nilai valid: bip: band interleaved by pixel (BIP) bil: band interleaved by line (BIL) bsq: band sequential (BSQ)
endian	Format endian objek raster baru.	string	Sama dengan objek raster asli.	Nilai valid: NDR: little endian XDR: big endian
celltype	Tipe piksel objek raster baru.	string	Sama dengan objek raster asli.	Nilai valid: 1bb: 1-bit Boolean 2bui: 2-bit unsigned integer 4bui: 4-bit unsigned integer 8bsi: 8-bit signed integer 8bui: 8-bit unsigned integer 16bsi: 16-bit signed integer 16bui: 16-bit unsigned integer 32bsi: 32-bit signed integer 32bui: 32-bit unsigned integer 64bsi: 64-bit signed integer 64bui: 64-bit unsigned integer 32bf: 32-bit floating number 64bf: 64-bit floating number

Tabel berikut menjelaskan parameter dalam nilai parameter options.

Parameter	Deskripsi	Tipe	Nilai default	Catatan
parallel	Derajat paralelisme yang diizinkan.	integer	ganos.parallel.degree	Nilai valid: 1 hingga 64.
stretch	Metode yang digunakan untuk meregangkan nilai piksel.	string	none	Nilai valid: none: Fungsi ini tidak meregangkan nilai piksel. Jika nilai piksel melebihi rentang nilai yang didukung oleh tipe piksel, fungsi ini mengganti nilai piksel dengan ekstremum yang ditentukan. Ekstremum ini bisa berupa nilai maksimum atau minimum, tergantung pada nilai piksel. stats: Fungsi ini meregangkan nilai piksel berdasarkan statistik raster asli. Statistik objek raster asli harus diperoleh. Sebelum memanggil fungsi ini, Anda dapat menggunakan fungsi ST_SummaryStats untuk mendapatkan statistik. data_type: Fungsi ini meregangkan nilai piksel berdasarkan ekstremum yang ditentukan untuk tipe piksel.

Contoh:

Mengonversi band tertentu menjadi objek raster baru.

SELECT ST_SubRaster(rast, 1, '0-2', '{"chunktable":"chunk_table", "chunking":true}')
FROM raster_sub
WHERE id=1;

Mengonversi tipe piksel dan meregangkan nilai piksel secara paralel.

SELECT ST_SubRaster(rast, 1, '0-2', '{"chunktable":"chunk_table", "chunking":true, "celltype": "8BUI"}', '{"stretch": "data_type", "parallel": 4}')
FROM raster_sub
WHERE id=1;