このトピックでは、ST_ImportFrom関数について説明します。 この関数は、Object Storage Service (OSS) オブジェクト、Multi-Cloud object Storage (MinIO) オブジェクト、またはHadoop Distributed File System (HDFS) ファイルをGanosのラスターオブジェクトにインポートするために使用されます。
構文
ラスターST_ImportFrom(cstring chunkTableName、
cstring url,
cstring storageOptionのデフォルト '{}' 、
cstring importOptionデフォルト '{}');
パラメーター
パラメーター | 説明 |
chunkTableName | チャンクテーブルの名前です。 名前は、ガノスのテーブル命名規則に準拠している必要があります。 |
url | OSSオブジェクト、MinIOオブジェクト、またはHDFSファイルのURL。 詳細については、「オブジェクトストレージパス」をご参照ください。 |
storageOption | ラスターオブジェクトに関するストレージ情報を指定するために使用されるJSON文字列。 |
importOption | OSSオブジェクト、MinIOオブジェクト、またはHDFSファイルのインポートのパラメーターを設定するために使用されるJSON文字列。 |
次の表に、storageOptionパラメーターのフィールドを示します。
フィールド | データ型 | デフォルト値 | 説明 |
チャンキング | Boolean | true | 新しいラスターオブジェクトのデータをチャンクとして保存するかどうかを指定します。 |
chunkdim | String | この値は、元の構成データの値と同じです。 | システムが新しいラスタオブジェクトのデータをチャンク化する元となるディメンション。 形式: (w, h, b) 。 説明 このフィールドは、chunkingフィールドをtrueに設定した場合にのみ有効になります。 |
compression | String | lz4 | システムが新しいラスターオブジェクトのデータを圧縮する形式。 有効な値:
デフォルト値: lz4。 |
品質 | integer | 75 | 圧縮後の新しいラスターオブジェクトの画質。 このフィールドは、圧縮フィールドをjpegまたはjp2kに設定した場合にのみ有効です。 |
interleaving | String | この値は、元の構成データの値と同じです。 | 新しいラスターオブジェクトのデータをインターリーブするために使用されるメソッド。 有効な値:
|
blockendian | String | 「NDR」 | 各データチャンクのバイトを格納するために使用されるシーケンス。 有効な値:
|
セルタイプ | String | この値は、元の構成データの値と同じです。 | 新しいラスタオブジェクトのピクセルタイプ。 有効な値:
|
次の表に、importOptionパラメーターのフィールドを示します。
フィールド | データ型 | デフォルト値 | 説明 |
mapping_oss_ファイル | Boolean | false | OSSオブジェクトをGanosのメモリ内ファイルにマップするかどうかを指定します。 説明 ラスターデータを読み取るとき、一部のドライバーはOSSオブジェクトに保存されているデータを最適化しません。 結果として、少量のデータを必要とする多数の要求が生成される。 これは性能を低下させる。 このフィールドを使用して、OSSオブジェクトをGanosのメモリ内ファイルにマップし、パフォーマンスを向上させることができます。 OSSオブジェクトの最大サイズは、ganos.raster.memory_oss_file_max_size (GUC) パラメーターで指定します。 |
パラレル | integer | ganos.parallel.de gree GUCパラメーターの値と同じです。 | 許可されている並列処理の程度。 有効な値: 1 ~ 64。 |
compute_stats | Boolean | false | インポートプロセス中にバンド統計を自動的に計算するかどうかを指定します。 |
約 | Boolean | false | サンプリング方法を使用するかどうかを指定します。 説明 このフィールドがtrueに設定されている場合、統計値はサンプリング方式で計算されます。 結果は不正確かもしれません。 |
要因 | integer | 4 | nのサンプリング係数は、各サンプリングユニットがサンプリングプロセス中にn個のピクセルから構成されることを示す。 この設定は、approxパラメーターがtrueに設定されている場合にのみ有効です。 |
exclusive_nodata | Boolean | true | nodata値を除外するかどうかを指定します。 |
説明
この関数は、ラスターオブジェクトを作成し、作成したラスターオブジェクトにOSSオブジェクト、MinIOオブジェクト、またはHDFSファイルをインポートするために使用されます。
ST_RasterDrivers関数を使用して、サポートされているデータ型を取得できます。
例:
-- OSSオブジェクトのURLにAccessKey ID、AccessKey secret、エンドポイントを指定して、ラスターオブジェクトを作成します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif') を選択します。-- スキーマを指定します。
ST_ImportFrom('schema.chunk_table ','OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif') を選択します。-- MinIOオブジェクトのURLでホストとポートを指定します。
ST_ImportFrom('chunk_table' 、'MIO://<ak >:< ak_secret>@ 10.0.0.1:443/mybucket/data/image.tif') を選択します。-- HDFSファイルのURLにuser_nameパラメーターを指定します。
ST_ImportFrom('chunk_table' 、'HDFS://<user_name>@ 10.0.0.1:8020/path/image.tif') を選択します。-- サブセットを含むネットワーク共通データフォーム (NetCDF) イメージを指定します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc') を選択します。-サブセットを含むHDF5イメージを指定します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.hdf5://ds/hcc') を選択します。-インポート時のチャンクあたりのサイズと圧縮形式を指定します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif' 、'{"chunkdim":"(128,128、3)" 、"compression":"none"}') を選択します。-インポート処理の並列度を指定します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc' 、'{}' 、'{"parallel": 4}') を選択します。-- Ganosのメモリ内ファイルにOSSオブジェクトをマッピングします。
ST_ImportFrom('chunk_table','OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc', '{}', '{"parallel": 4, "mapping_oss_file":true}');
-インポート後にバンド統計を自動的に計算します。
ST_ImportFrom('chunk_table' 、'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif','','{"compute_stats":true}');