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

PolarDB:ST_ImportObj

最終更新日:Jun 21, 2024

この関数は、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

インポートのオプション。 有効な値:

  • schema

  • search_path

  • ignore_missing

  • force_triangulate

  • metallic_roughness

  • obj_data_column

  • obj_id_column

制限とオプション

  • データ制限:

    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