第4章 Maven アーティファクトとしての仮想データベースの作成

手順

1. テキストエディターで POM ファイルを作成し、ビルドの依存関係を定義します。以下に例を示します。

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.teiid</groupId>
     <artifactId>dv-customer</artifactId>
     <name>dv-customer</name>
     <description>Demo project to showcase maven based vdb</description>
     <packaging>vdb</packaging>
     <version>1.0</version>
   
     <build>
       <plugins>
         <plugin>
           <groupId>org.teiid</groupId>
           <artifactId>vdb-plugin</artifactId>
           <version>1.2.0</version>
           <extensions>true</extensions>
           <executions>
             <execution>
               <goals>
                 <goal>vdb</goal>
               </goals>
             </execution>
           </executions>
         </plugin>
       </plugins>
     </build>
   </project>

2. Maven プロジェクトを作成し、DDL ファイルから仮想データベース定義をインポートします。以下に例を示します。

   vdb-project
   ├── pom.xml
   └── src
       └── main
           └── vdb
               └── vdb.ddl

3. 仮想データベースの構造を指定する DDL ファイルを作成し、プロジェクトの /src/main/vdb ディレクトリーに .ddl エクステンションで保存します。たとえば、vdb.ddlです。

   以下の例は、postgreSQL データソースを使用する仮想データベースの DDL ファイルのサンプルを示しています。

   例： vdb.ddl

   CREATE DATABASE customer OPTIONS (ANNOTATION 'Customer VDB');
   USE DATABASE customer;
   
   CREATE FOREIGN DATA WRAPPER postgresql;
   CREATE SERVER sampledb TYPE 'NONE' FOREIGN DATA WRAPPER postgresql;
   
   CREATE SCHEMA accounts SERVER sampledb;
   CREATE VIRTUAL SCHEMA portfolio;
   
   SET SCHEMA accounts;
   IMPORT FOREIGN SCHEMA public FROM SERVER sampledb INTO accounts OPTIONS("importer.useFullSchemaName" 'false');
   
   SET SCHEMA portfolio;
   
   CREATE VIEW CustomerZip(id bigint PRIMARY KEY, name string, ssn string, zip string) AS
      SELECT c.ID as id, c.NAME as name, c.SSN as ssn, a.ZIP as zip
      FROM accounts.CUSTOMER c LEFT OUTER JOIN accounts.ADDRESS a
      ON c.ID = a.CUSTOMER_ID;

   DDL を使用して仮想データベースを定義する方法の詳細は、『Data Virtualization Reference』の「 DDL metadata for schema objects 」を参照してください。完全な DDL の定義については、本書では扱いません。

4. 仮想データベースアーティファクトをビルドします。Maven プロジェクトのルートフォルダーにターミナルウィンドウを開き、以下のコマンドを入力します。

   mvn clean install

   このコマンドは、ターゲットリポジトリーに ${project.name}-$2020.Q1.vdb ファイルを生成します。

5. 以下のコマンドを入力して、アーティファクトをリモートリポジトリーにデプロイします。

   mvn clean install deploy