すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_ImportFrom

最終更新日:May 06, 2024

このトピックでは、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

システムが新しいラスターオブジェクトのデータを圧縮する形式。 有効な値:

  • none

  • jpeg

  • zlib

  • png

  • lzo

  • lz4

  • snappy

  • zstd

  • jp2k

デフォルト値: lz4。

品質

integer

75

圧縮後の新しいラスターオブジェクトの画質。 このフィールドは、圧縮フィールドをjpegまたはjp2kに設定した場合にのみ有効です。

interleaving

String

この値は、元の構成データの値と同じです。

新しいラスターオブジェクトのデータをインターリーブするために使用されるメソッド。 有効な値:

  • bip: ピクセルによってインターリーブされるバンド

  • bil: ラインによってインターリーブされるバンド

  • bsq: バンドシーケンシャル

blockendian

String

「NDR」

各データチャンクのバイトを格納するために使用されるシーケンス。 有効な値:

  • NDR: 少しエンディアン

  • XDR: ビッグエンディアン

セルタイプ

String

この値は、元の構成データの値と同じです。

新しいラスタオブジェクトのピクセルタイプ。 有効な値:

  • 1bb: 1ビット整数

  • 2bui: 2ビット符号なし整数

  • 4bui : 4ビット符号なし整数

  • 8bsi : 8bit符号付き整数

  • 8bui : 8bit符号なし整数

  • 16bsi : 16bit符号付き整数

  • 16bui : 16ビット符号なし整数

  • 32bsi : 32ビット符号付き整数

  • 32bui : 32ビット符号なし整数

  • 32bf : 32bitフロート

  • 64bsi : 64bit符号付き整数

  • 64bui : 64bit符号なし整数

  • 64bf : 64bitフロート

次の表に、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}');