この関数は、Object Storage Service (OSS) バケットまたはメモリに保存されているOBJファイルをデータベースにインポートします。
構文
boolean ST_ImportObj(text table_name, text url, text id, text options default '{}');
ブールST_ImportObj(text table_name, bytea content, text id, text options default '{}'); 戻り値
戻り値 | 説明 |
true | ファイルがインポートされます。 |
false | ファイルのインポートに失敗しました。 |
Parameters
パラメーター | 説明 |
table_name | OBJテーブルの名前と、対応するシャードテーブルのプレフィックス。 |
url | Object Storage Service (OSS) バケット内のファイルのパス。 |
id | OBJファイルのID (文字列) 。 |
content | バイナリストリーム形式のOBJファイル。 |
options | インポートのオプション。 有効な値:
|
制限とオプション
データ制限:
diffusetextureタイプのテクスチャファイルのみがサポートされています。 他のタイプのテクスチャファイルは無視されます。
インポートのオプション:
オプション
データ型
説明
デフォルト値
例
schema
String
必要なテーブルのスキーマ。
パブリック
postgres
search_path
String
マテリアルまたはテクスチャの検索パス。
OBJファイルがURLを使用して指定される場合、OBJファイルの親パスが使用されます。 それ以外の場合、このパラメータは空のままになります。
OSS:// foo/bar
ignore_missing
Boolean
マテリアルファイルまたはテクスチャファイルが取得されない場合にエラーを無視するかどうかを指定します。
true
false
force_triangulate
Boolean
非三角形面を強制的に三角測量するかどうかを指定します。
true
false
metallic_roughness
Boolean
OBJファイルをmetallic_roughnessタイプのマテリアルとして解析するかどうかを指定します。 このパラメーターがfalseに設定されている場合、OBJファイルはspecular_glassity型のマテリアルとして解析されます。
true
false
obj_data_column
String
プライマリテーブルのデータフィールド。
obj_data
my_data
obj_id_column
String
プライマリテーブルのデータIDフィールド。
obj_id
my_id
次の表に、プライマリテーブルのスキーマを示します。
フィールド
データ型
説明
コメント
id
シリアル
プライマリテーブルのID。
プライマリテーブルのプライマリキー。
[obj_id_column]
text
データレコードのID。
このフィールドを指定できます。 デフォルトのフィールド名はobj_idです。これは、ユーザーが指定した値に基づいてシステムによって指定されます。
[obj_data_column]
sfmesh
データ。
このフィールドを指定できます。 このフィールドのデフォルト値はobj_dataです。
次の表に、コンポーネントテーブルのスキーマを示します。
フィールド
データ型
説明
コメント
id
シリアル
コンポーネントテーブルのID。
コンポーネントテーブルの主キー。
obj_id
text
データレコードのID。
フィールド名はobj_idに固定され、ユーザーが指定した値に基づいてシステムが指定します。
component_id
text
コンポーネントID。
元のOBJファイル内のコンポーネントのシーケンス番号。
name
text
コンポーネント名。
OBJファイルのグループまたはオブジェクト名。 グループ名またはオブジェクト名が複数存在する場合は、ファーストネームが値として使用されます。 それ以外の場合、フィールドはMesh_[object sequence number] に設定されます。
tags
jsonb
OBJファイルのタグ。
コンポーネント
sfmesh
コンポーネント名。
-
次の表に、テクスチャテーブルのスキーマを示します。
フィールド
データ型
説明
コメント
id
シリアル
テクスチャテーブルのID。
テクスチャテーブルの主キー。
obj_id
text
データレコードのID。
フィールド名はobj_idに固定され、ユーザーが指定した値に基づいてシステムが指定します。
texture_id
text
テクスチャのID。
元のOBJファイルのテクスチャのシーケンス番号。
name
text
テクスチャ名。
テクスチャのファイル名。
テクスチャ
テクスチャ
テクスチャ名。
-
例
SELECT ST_ImportObj('test_obj', 'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_obj.obj');
---------
t
強制三角測量インポートを無効にします。
SELECT ST_ImportObj('test_obj', 'OSS://<ak >:< ak_secret>@ oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_obj.obj', '{"force_triangulate": false}');
---------
t