Object Storage Service (OSS)、MinIO、または Hadoop 分散ファイルシステム (HDFS) からデータベースにファイルをインポートします。
構文
raster ST_ImportFrom(cstring chunkTableName,
cstring url,
cstring storageOption default '{}',
cstring importOption default '{}');パラメーター
| パラメーター | 説明 |
| chunkTableName | チャンクテーブルの名前。この名前は、データベーステーブルの命名規則に準拠している必要があります。 |
| url | 外部ファイルのパス。パスの作成方法の詳細については、「ST_CreateRast」をご参照ください。 |
| storageOption | ラスターオブジェクトのストレージ情報を指定する JSON 文字列。 |
| importOption | インポートオプションを指定する JSON 文字列。 |
storageOption のパラメーターは次のとおりです：
| パラメーター | 型 | デフォルト値 | 説明 |
| chunking | boolean | true | チャンクストレージを使用するかどうかを指定します。 |
| chunkdim | string | 生データと同じ | チャンクのディメンション情報。フォーマット：(w, h, b)。 説明 このパラメーターは、chunking が true の場合にのみ有効です。 |
| compression | string | lz4 | 圧縮アルゴリズムのタイプ。有効値：
デフォルト：lz4 |
| quality | integer | 75 | 圧縮品質。このパラメーターは、jpeg および jp2k 圧縮アルゴリズムでのみ有効です。 |
| interleaving | string | 生データと同じ | インターリーブ方式。有効値：
|
| blockendian | string | 'NDR' | チャンクストレージのバイトオーダー。有効値：
|
| celltype | string | 生データと同じ | ピクセルタイプ。有効値：
|
importOption のパラメーターは次のとおりです。
| パラメーター | 型 | デフォルト値 | 説明 |
| mapping_oss_file | boolean | false | OSS 上のファイルをインメモリファイルにマッピングするかどうかを指定します。 説明 ラスターデータの読み取り時に、一部のドライバーは OSS に保存されているデータに対して最適化されていません。これにより、データ量の少ないリクエストが多数生成され、パフォーマンスが低下します。このパラメーターは、OSS ファイル全体をインメモリオブジェクトにマッピングして、パフォーマンスを向上させます。合計ファイルサイズは、GUC パラメーター ganos.raster.memory_oss_file_max_size によって設定されます。 |
| parallel | integer | GUC パラメーター ganos.parallel.degree の値。 | 操作の並列処理の次数を設定します。有効値：1～64。 |
説明
この関数は、ラスターオブジェクトを作成し、外部の OSS ファイルをオブジェクトにインポートします。
サポートされているデータの型を取得するには、ST_RasterDrivers 関数を呼び出します。
例
-- 外部テーブル名とパスのみを指定
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif');
-- サブセットを持つ NetCDF ファイルに対応するイメージを指定
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc');
-- インポート時にチャンクサイズと圧縮タイプを指定
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif', '{"chunkdim":"(128,128,3)", "compression":"none"}');
-- インポート時に並列処理の次数を指定
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc', '{}', '{"parallel": 4}');