メインコンテンツへスキップ

TDVから外部データソースへの書き込みおよびDDL実行について（データベース形式）

  • 更新

    概要

    TDVに追加したデータソースをデータサービスとして公開（パブリッシュ）し、そのデータサービスに対してINSERTやCREATE TABLEなどのクエリを実行することで、データソースに変更を加えることができます。

    本記事では、以下の５種類のクエリをTDV公開データサービスに対して実行し、どのような結果となるかをステップバイステップで説明します。

     

     

    検証環境

    PostgreSQL（外部データソース）

    外部データソース用のPostgreSQLインスタンス（5432ポート）です。
    TDV ServerにバンドルされているリポジトリDB（9408ポート）やデフォルトキャッシュデータベース（9404ポート）とは異なります。
    TDVに追加するデータソースとして、PostgreSQLインスタンス内に作成済みの「契約管理データベース」を使用します。
    「契約管理データベース」は「契約管理スキーマ」を持ち、そのスキーマ内に「契約テーブル」が存在します。
    「契約テーブル」には10件のレコードが存在しています。（以下はDBeaverで接続しプレビューしたものです。）

    0_dbeaver_postgres.png

    CREATE TABLEでは、「契約管理スキーマ」内に新しいテーブルを作成しますので、TDV ServerからPostgreSQLデータソースへの接続に利用するユーザー（tdv）には各種クエリ（INSERT, UPDATE, …）を実行するために必要な権限がPostgreSQL側で事前に付与されています。

     

    TDV Server

    TDV Serverは、PostgreSQL（外部データソース）と同一サーバー上で実行されています。

     

    データソース

    PostgreSQL（外部データソース）の「契約管理データベース」がデータソースとして追加されており、

    0_tdvstudio_ds.png

    「契約管理スキーマ」とその配下の「契約テーブル」がイントロスペクトされ、メタデータが追加されています。

    0_tdvstudio_ds_table.png

     

    公開データサービス

    コンポジットデータサービス「契約管理データベース」>「契約管理スキーマ」>「契約テーブル」がデータサービス（データベース方式）として公開されています。

    0_tdvstudio_published_table.png

    コンポジットデータサービス「契約管理データベース」には、コンテナのマッピング設定を事前に行います。
    ここでは、コンポジットデータサービス「契約管理データベース」直下の「契約管理スキーマ」とデータソース「契約管理データベース」直下の「契約管理スキーマ」の対応付けを行います。
    これにより、公開テーブル「契約管理データベース」>「契約管理スキーマ」>「契約テーブル」に対して外部のクライアントアプリなどからDDLクエリが実行された場合には、対応するスキーマ、すなわちデータソース「契約管理データベース」>「契約管理スキーマ」に対してそのDDLがわたされ、結果として、データソース「契約管理データベース」の先にある物理データソース（PostgreSQL）に対してそのDDLが実行されることになります。

    0_tdvstudio_published_database.png

     

     

    INSERT

    DBeaverからTDV公開テーブルに対して、以下のINSERTクエリを実行します。

    INSERT INTO 契約管理スキーマ.契約テーブル(
    "契約ＩＤ",
    契約名,
    金額,
    取引先名,
    契約開始日,
    契約終了日
)
VALUES(
    11,
    'サーバー構築',
    80000,
    'BCDシステムズ',
    '2024-01-01',
    '2024-03-31'
)

    1_insert_dbeaver_tdv_published_table.png

     

    続いて、TDV公開テーブルに対して、以下のSELECTクエリを実行し、 レコードが1件追加されたことを確認します。

    SELECT
	*
FROM
	契約管理スキーマ.契約テーブル

    1_insert_dbeaver_tdv_published_table_selectresult.png

     

    TDV Studio上でも同様に確認します。

    1_insert_tdvstudio_published_table_selectresult.png

    1_insert_tdvstudio_ds_table_selectresult.png

     

    最後に、物理データソース（PostgreSQL）のテーブルも直接参照して確認します。

    1_insert_dbeaver_postgres_table_selectresult.png

     

    このように、TDVの公開データサービスにINSERTクエリを実行することで、その先の物理データソースに対してINSERTを実行することができます。

     

     

    UPDATE

    DBeaverからTDV公開テーブルに対して、以下のUPDATEクエリを実行します。

    UPDATE
    契約管理スキーマ.契約テーブル
SET
    金額 = 70000,
    契約終了日 = NULL
WHERE
    "契約ＩＤ" = 8

    2_update_dbeaver_tdv_published_table.png

     

    続いて、TDV公開テーブルに対して、以下のSELECTクエリを実行し、 契約ＩＤ = 8のレコードが更新されたことを確認します。

    SELECT
	*
FROM
	契約管理スキーマ.契約テーブル

    2_update_dbeaver_tdv_published_table_selectresult.png

     

    TDV Studio上でも同様に確認します。

    2_update_tdvstudio_published_table_selectresult.png

    2_update_tdvstudio_ds_table_selectresult.png

     

    最後に、物理データソース（PostgreSQL）のテーブルも直接参照して確認します。

    2_update_dbeaver_postgres_table_selectresult.png

     

    このように、TDVの公開データサービスにUPDATEクエリを実行することで、その先の物理データソースに対してUPDATEを実行することができます。

     

     

    DELETE

    DBeaverからTDV公開テーブルに対して、以下のDELETEクエリを実行します。

    DELETE
FROM
    契約管理スキーマ.契約テーブル
WHERE
    "契約ＩＤ" = 3

    3_delete_dbeaver_tdv_published_table.png

     

    続いて、TDV公開テーブルに対して、以下のSELECTクエリを実行し、 契約ＩＤ = 3のレコードが削除されたことを確認します。

    SELECT
	*
FROM
	契約管理スキーマ.契約テーブル

    3_delete_dbeaver_tdv_published_table_selectresult.png

     

    TDV Studio上でも同様に確認します。

    3_delete_tdvstudio_published_table_selectresult.png

    3_delete_tdvstudio_ds_table_selectresult.png

     

    最後に、物理データソース（PostgreSQL）のテーブルも直接参照して確認します。

    3_delete_dbeaver_postgres_table_selectresult.png

     

    このように、TDVの公開データサービスにDELETEクエリを実行することで、その先の物理データソースに対してDELETEを実行することができます。

     

     

    CREATE TABLE

    DBeaverからTDV公開テーブルに対して、以下のCREATE TABLEクエリを実行します。

    CREATE TABLE 契約管理スキーマ.顧客テーブル(
    "顧客ＩＤ" INT PRIMARY KEY,
    "顧客名" VARCHAR(100),
    "住所" VARCHAR(255),
    "電話番号" VARCHAR(20),
    "メールアドレス" VARCHAR(100),
    "登録日" DATE
)

    4_createtable_dbeaver_tdv_published_table.png

     

    続いて、TDV公開テーブルに対して、以下のSELECTクエリを実行し、顧客テーブルが作成されたことを確認します。

    SELECT
	*
FROM
	契約管理スキーマ.顧客テーブル

    4_createtable_dbeaver_tdv_published_table_selectresult.png

     

    TDV Studio上でも同様に確認します。

    4_createtable_tdvstudio.png

     

    最後に、物理データソース（PostgreSQL）のテーブルも直接参照して確認します。

    4_createtable_dbeaver_postgres_table.png

     

    このように、TDVの公開データサービスにCREATE TABLEクエリを実行することで、その先の物理データソースに対してCREATE TABLEを実行することができます。

     

     

    DROP TABLE

    DBeaverからTDV公開テーブルに対して、以下のDROP TABLEクエリを実行します。

    DROP TABLE 契約管理スキーマ.契約テーブル

    5_droptable_dbeaver_tdv_published_table.png

     

    続いて、TDV公開テーブルに対して、以下のSELECTクエリを実行し、契約テーブルが削除されたことを確認します。

    SELECT
	*
FROM
	契約管理スキーマ.契約テーブル

    5_droptable_dbeaver_tdv_published_table_selectresult.png

     

    TDV Studio上でも同様に確認します。

    5_droptable_tdvstudio.png

     

    最後に、物理データソース（PostgreSQL）のテーブルも直接参照して確認します。

    5_droptable_dbeaver_postgres.png

     

    このように、TDVの公開データサービスにDROP TABLEクエリを実行することで、その先の物理データソースに対してDROP TABLEを実行することができます。