このトピックでは、ST_AsDatasetFile関数について説明します。 この関数は、ラスターオブジェクトの特定の部分をBYTEAタイプのファイルに変換するために使用されます。
構文
setofレコードST_AsDatasetFile (ラスターraster_obj、
ボックスの範囲、
integer pyramidLevel default 0,
cstring bands default '',
cstring形式のデフォルト 'GTiff' 、
cstring create_optionデフォルト '{}' 、
cstring process_optionデフォルト '{}' 、
out ext cstring,
アウトデータbytea);
パラメーター
パラメーター | 説明 |
raster_obj | パーツを変換するラスタオブジェクト。 |
範囲 | 抽出するデータの部分。 デフォルトでは、データの一部は地理座標系 (GCS) に基づいて指定されます。 |
pyramidLevel | データを抽出するピラミッドレベル。 有効な値は0から始まります。 デフォルト値:0 |
バンド | データを抽出するバンドのID。 有効なバンドIDは0から始まります。 このパラメーターの値は、バンドIDの範囲または配列です。 例: '0-2 ' および '1,2,3' デフォルト値:'' デフォルト値は、Ganosがすべてのバンドからデータを抽出することを指定します。 |
形式 | ファイルの形式。 詳細については、「ST_RasterDrivers」をご参照ください。 |
create_option | 抽出されたデータを使用してデータセットを作成するオプション。 このパラメーターの値はJSON文字列です。 詳細については、「ST_RasterDrivers」をご参照ください。 |
process_option | 抽出されたデータを処理するオプション。 このパラメーターの値はJSON文字列です。 rast_coordオプションは、ピクセル座標を使用して入力バウンディングボックスを指定するかどうかを指定します。 ピクセル座標を使用して入力境界ボックスを指定する場合、x座標は列番号を指定します。 を指定し、y座標は行番号を指定します。 ピクセルの x座標とy座標の有効な値は0から始まります。 |
ext | ファイルの形式。 サポートされるファイル形式は、TIFおよびXMLを含む。 |
データ | ファイルのBYTEAタイプのデータ。 |
説明
- 指定するファイル形式は、Ganosのドライバでサポートされている必要があります。 したがって、ST_RasterDrivers関数のcan_asfileパラメーターをtrueに設定する必要があります。 詳細については、「ST_RasterDrivers」をご参照ください。
- 抽出されたデータを格納するキャッシュのデフォルトサイズは100 MBです。 つまり、最大100 MBの抽出データを返すことができます。 返される抽出データのサイズを調整する場合は、ganos.raster.clip_max_buffer_sizeパラメーターを使用してキャッシュサイズを変更できます。
- create_optionパラメーターの値は、ST_RasterDrivers関数のcreate_optionsパラメーターから取得できます。 詳細については、「ST_RasterDrivers」をご参照ください。
例
-- 抽出するデータの部分を指定します。
SELECT ST_AsDatasetFile(raster_obj、
'(-180,-90), (0,0)'::Box)
FROM raster_table
WHERE id =1;
-データを抽出するピラミッドレベルを指定します。
SELECT ST_AsDatasetFile(raster_obj、
'(-180,-90), (0,0)'::Box,
1)
FROM raster_table
WHERE id =1;
-データを抽出するバンドのIDを指定します。
SELECT ST_AsDatasetFile(raster_obj、
'(-180,-90), (0,0)'::Box,
1,
'0-2 ')
FROM raster_table
WHERE id =1;
-- Ganosが抽出されたデータをGIFファイルとして保存するように指定します。
SELECT ST_AsDatasetFile(raster_obj、
'(-180,-90), (0,0)'::Box,
1,
'0-2 '、
「ギフト」)
FROM raster_table
WHERE id =1;
-抽出されたデータを処理するために使用されるファイル形式とオプションを指定します。
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;
-ピクセル座標を使用して入力境界ボックスを指定することを指定します。
SELECT ST_AsDatasetFile(raster_obj、
'(0,0) 、(100,100)'::Box、
1,
'0-2 '、
「GTiff」、
'{}',
'{"rast_coord":"true"}')
FROM raster_table
WHERE id =1;