ST_AsDatasetFile - ApsaraDB RDS

Topik ini menjelaskan fungsi ST_AsDatasetFile, yang digunakan untuk mengonversi bagian tertentu dari objek raster menjadi file bertipe 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 yang bagian tertentunya ingin Anda konversi.
extent	Bagian data yang ingin Anda ekstrak. Secara default, bagian data ditentukan berdasarkan sistem koordinat geografis (GCS).
pyramidLevel	Tingkat piramida dari mana Anda ingin mengekstrak data. Nilai valid dimulai dari 0. Nilai default: 0.
bands	ID band dari mana Anda ingin mengekstrak data. ID band valid dimulai dari 0. Nilai parameter ini dapat berupa rentang atau array dari ID band. Contoh: `'0-2'` dan `'1,2,3'`. Nilai default: `''`. Nilai default menentukan bahwa Ganos mengekstrak data dari semua band.
format	Format file. Untuk informasi lebih lanjut, lihat ST_RasterDrivers.
create_option	Opsi berdasarkan mana Anda ingin membuat dataset menggunakan data yang diekstraksi. Nilai parameter ini adalah string JSON. Untuk informasi lebih lanjut, lihat ST_RasterDrivers.
process_option	Opsi berdasarkan mana Anda ingin memproses data yang diekstraksi. Nilai parameter ini adalah string JSON. Opsi rast_coord menentukan apakah koordinat piksel digunakan untuk menentukan kotak pembatas input. Jika koordinat piksel digunakan untuk menentukan kotak pembatas input, koordinat x menentukan nomor kolom piksel dan koordinat y menentukan nomor baris piksel. Nilai valid koordinat x dan y dimulai dari 0.
ext	Format file. Format file yang didukung termasuk TIF dan XML.
data	Data bertipe BYTEA dari file.

Deskripsi

Format file yang Anda tentukan harus didukung oleh driver di Ganos. Oleh karena itu, atur parameter can_asfile dalam fungsi ST_RasterDrivers ke true. Untuk informasi lebih lanjut, lihat ST_RasterDrivers.
Ukuran cache default untuk menyimpan data yang diekstraksi adalah 100 MB, yang berarti hingga 100 MB data dapat dikembalikan. Untuk menyesuaikan ukuran data yang diekstraksi, ubah ukuran cache menggunakan parameter ganos.raster.clip_max_buffer_size.
Nilai parameter create_option dapat diperoleh dari parameter create_options dalam fungsi ST_RasterDrivers. Untuk informasi lebih lanjut, lihat ST_RasterDrivers.

Contoh

--Tentukan bagian data yang ingin Anda ekstrak.
SELECT ST_AsDatasetFile(raster_obj, 
                  '(-180,-90), (0,0)'::Box) 
FROM raster_table    
WHERE id =1;

--Tentukan tingkat piramida dari mana Anda ingin mengekstrak data.
SELECT ST_AsDatasetFile(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1) 
FROM raster_table
WHERE id =1;

--Tentukan ID band dari mana Anda ingin mengekstrak data.
SELECT ST_AsDatasetFile(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1,
                 '0-2') 
FROM raster_table    
WHERE id =1;

--Tentukan bahwa Ganos menyimpan 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 yang digunakan untuk memproses 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;

--Tentukan bahwa koordinat piksel digunakan untuk menentukan kotak pembatas input.
SELECT ST_AsDatasetFile(raster_obj, 
                  '(0,0), (100,100)'::Box,
                 1,
                 '0-2',
                       'GTiff',
                       '{}',
                       '{"rast_coord":"true"}') 
FROM raster_table    
WHERE id =1;