Sintaksis, parameter, dan contoh ST_AsDatasetFile - ApsaraDB RDS

Mengekstraksi ekstensi spasial dari objek raster dan mengembalikannya sebagai file dalam format BYTEA.

Sintaksis

setof record ST_AsDatasetFile(raster raster_obj,
                              box extent,
                              integer pyramidLevel default 0,
                              cstring bands default '',
                              cstring format default 'GTiff',
                              cstring create_option default '{}',
                              cstring process_option default '{}',
                              out ext cstring,
                              out data bytea);

Parameter

Parameter	Deskripsi
raster_obj	Objek raster tempat data diekstraksi.
extent	Kotak pembatas area yang akan diekstraksi. Koordinat menggunakan sistem koordinat geografis (GCS) secara default.
pyramidLevel	Tingkat piramida yang akan dibaca. Nilai valid dimulai dari 0. Nilai default: `0`.
bands	ID band yang akan diekstraksi. ID band valid dimulai dari 0. Tentukan rentang (`'0-2'`) atau daftar yang dipisahkan koma (`'1,2,3'`). Nilai default: `''` (semua band).
format	Format file output. Untuk format yang didukung, lihat ST_RasterDrivers. Nilai default: `'GTiff'`.
create_option	String JSON berisi opsi pembuatan untuk dataset output. Nilai valid berasal dari bidang `create_options` yang dikembalikan oleh ST_RasterDrivers. Nilai default: `'{}'`.
process_option	String JSON berisi opsi pemrosesan. Opsi `rast_coord` menentukan apakah parameter `extent` menggunakan koordinat piksel. Jika diatur ke `"true"`, koordinat x dipetakan ke kolom piksel dan koordinat y dipetakan ke baris piksel, keduanya dimulai dari 0. Nilai default: `'{}'`.
ext (out)	Ekstensi file dari data yang dikembalikan. Nilai yang didukung: `TIF`, `XML`.
data (out)	Konten file dalam format bytea.

Catatan penggunaan

Format output harus didukung oleh driver Ganos dengan can_asfile diatur ke true. Untuk memeriksa format yang didukung, panggil ST_RasterDrivers.
Secara default, fungsi ini mengembalikan hingga 100 MB data yang diekstraksi. Untuk menyesuaikan batas ini, ubah ukuran cache menggunakan ganos.raster.clip_max_buffer_size.
Nilai valid untuk create_option berasal dari bidang create_options dalam output ST_RasterDrivers.

Contoh

Ekstraksi ekstensi geografis menggunakan pengaturan default:

SELECT ST_AsDatasetFile(raster_obj,
                        '(-180,-90), (0,0)'::Box)
FROM raster_table
WHERE id = 1;

Ekstraksi dari tingkat piramida tertentu:

SELECT ST_AsDatasetFile(raster_obj,
                        '(-180,-90), (0,0)'::Box,
                        1)
FROM raster_table
WHERE id = 1;

Ekstraksi band tertentu:

SELECT ST_AsDatasetFile(raster_obj,
                        '(-180,-90), (0,0)'::Box,
                        1,
                        '0-2')
FROM raster_table
WHERE id = 1;

Simpan data yang diekstraksi sebagai file GIF:

SELECT ST_AsDatasetFile(raster_obj,
                        '(-180,-90), (0,0)'::Box,
                        1,
                        '0-2',
                        'GIF')
FROM raster_table
WHERE id = 1;

Tentukan format file dan opsi pembuatan untuk data yang diekstraksi:

SELECT ST_AsDatasetFile(raster_obj,
                        '(-180,-90), (0,0)'::Box,
                        1,
                        '0-2',
                        'GTiff',
                        '{"blockxsize":256, "blockysize":256, "compress": "DEFLATE"}')
FROM raster_table
WHERE id = 1;

Gunakan koordinat piksel untuk menentukan kotak pembatas:

SELECT ST_AsDatasetFile(raster_obj,
                        '(0,0), (100,100)'::Box,
                        1,
                        '0-2',
                        'GTiff',
                        '{}',
                        '{"rast_coord":"true"}')
FROM raster_table
WHERE id = 1;