DBPARTNER2 Client(64) 操作ガイド

解説・操作書

3020-6-153-10

前書き

対象製品

P-2963-4514 DBPARTNER2 Client(64)（参照版） 02-00（適用OS：Windows Server 2012，Windows 10，Windows Server 2016，Windows Server 2019）

P-2963-4614 DBPARTNER2 Client(64)（更新版） 02-00（適用OS：Windows Server 2012，Windows 10，Windows Server 2016，Windows Server 2019）

P-2963-4714 DBPARTNER2 Client(64)（定義版） 02-00（適用OS：Windows Server 2012，Windows 10，Windows Server 2016，Windows Server 2019）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，DABroker，DBPARTNER，HiRDB，VOS3/LS，VOS3/US，VOS3/XS，XDMは，株式会社 日立製作所の商標または登録商標です。

Microsoft，Excel，Windows，Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleおよびJavaは，オラクルおよびその関連会社の登録商標です。

UNIXは，The Open Groupの商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

製品構成について

DBPARTNER2 Client(64)（以降，DBPARTNER2 Clientと表記します）の形名の違いで，次に示す機能の差異があります。

機能

P-2963-4514

（参照版）

P-2963-4614

（更新版）

P-2963-4714

（定義版）

データ抽出

○

○

○

データ更新

−

○

○

表定義

−

−

○

データベースの保存

−

−

○

（凡例）

○：機能を使えます。

−：機能を使えません。

発行

2021年6月　3020-6-153-10

著作権

All Rights Reserved. Copyright (C) 2020, 2021, Hitachi, Ltd.

変更内容

変更内容(3020-6-153-10)　DBPARTNER2 Client(64)(参照版) 02-00，DBPARTNER2 Client(64)(更新版) 02-00，DBPARTNER2 Client(64)(定義版) 02-00

追加・変更内容

変更個所

ODBC接続のドライバにDBPARTNER ODBC 3.0 Driverを追加しました。

これに伴い，DBPARTNER ODBC 3.0 Driverのセットアップ方法やデータベース接続の設定の説明を追加しました。

1.3.1，2.1.1，2.2.3，2.4.2，2.4.2(12)，2.4.2(18)，2.6，2.7.1，2.7.2，4.1.1(2)，5.1.1(2)，5.2.1(2)，8.，11.1.1，11.3，付録C，付録D.1，付録I.1，付録I.2，付録I.3

DBPARTNER2から表を定義できる機能（表定義機能）を追加しました。

これによって，SQLを使用しなくても表を定義できるようになり，定義した表は更新，又は削除ができます。

また，抽出したデータを別の表としてデータベースに保存できます。

1.2，1.2.4，2.2.1，2.5.2，2.5.2(11)，3.1，3.2.1，3.4.1(1)，3.4.1(3)，4.1.1(1)，4.1.1(3)，4.1.3，4.1.3(1)(a)，4.1.3(3)，4.2.9，4.2.9(2)，4.2.11，6.1.1(1)，6.1.1(4)，6.1.2，6.1.2(2)，6.1.3，6.1.4，7.1.1(6)，7.1.5，7.1.6(1)，8.1，8.2，8.2.1，8.2.2，8.3，8.3.1，8.3.2，8.3.3，8.3.4，8.3.5，8.3.6，8.3.7，8.3.8，8.3.9，8.4.5，9.，10.1.2，11.1.3，付録D.1，付録H

次のメッセージを追加しました。

DBP0528W，DBP1039W，DBP1059W，DBP1065E，DBP1070W，DBP1071W，DBP1072W，DBP1079W，DBP2040W，DBP3501E，DBP3502E，DBP3503E，DBP3504E，DBP3505E，DBP3506E，DBP3507E，DBP3508E，DBP3509E，DBP3510E，DBP3511E，DBP3512E，DBP3513E，DBP3514E，DBP3515E，DBP3516E，DBP3517E，DBP3518E，DBP3519E，DBP3520E，DBP3521W，DBP3522E，DBP3523E，DBP3524E，DBP3525E，DBP3528E，DBP3529E，DBP3531I，DBP3532E，DBP3533E，DBP3534E，DBP3535E，DBP3536E，DBP3537E，DBP3538E，DBP3539W，DBP3540E，DBP3541W，DBP3542E，DBP3543W，DBP3544E，DBP3545W，DBP3546W，DBP3547W，DBP3548W，DBP3549W，DBP3550W，DBP3551W，DBP3552W，DBP3553W，INS0201E，INS0202E，DPOD0001-E，DPOD0002-E，DPOD0003-E，DPOD0004-E，DPOD0005-E，DPOD0006-E，DPOD0007-E，DPOD0008-E，DPOD0009-E，DPOD0010-E，DPOD0011-E，DPOD0012-E，DPOD0013-E，DPOD0014-E，DPOD0015-E，DPOD0016-E，DPOD0017-E，DPOD0018-E，DPOD0019-E，DPOD0031-E，DPOD0034-E，DPOD0035-E

11.2.1，11.3

次のメッセージを変更しました。

DBP0712W，DBP1032W，DBP2029W，DBP2041W，DBP3007E，DBP6001E

11.2.1

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，データベースアクセスプログラムDBPARTNER2 Clientの使い方について説明したものです。

このマニュアルで説明するDBPARTNER2 Clientからアクセスできるサーバのデータベースを次に示します。

UNIX，Windows関連のデータベース

HiRDB，ORACLE，HADB

上記以外のデータベースにアクセスする場合，アクセス条件を設定するときの規則や使える機能は，各データベースに依存します。

DBPARTNER2の最新情報

次に示すアドレスで，DBPARTNER2の最新情報を参照できます。

http://www.hitachi.co.jp/soft/dbpart/

対象読者

DBPARTNER2をクライアントPCに組み込んで業務処理をするシステム管理者とオペレータの方々を対象にしています。

Windowsの操作について知識があることを前提としています。さらに，データベースのサーバと接続するときには，サーバの環境に関する知識があることを前提としています。

マニュアルで使用する記号

全体で使用する記号

このマニュアル全体で使う記号を次のように定義します。

<　>：文字キーを示します。

［　］：メニューの名称やダイアログボックス又はダイアログボックス中のボタンを示します。

補足：操作や機能の補足説明を示します。

Windowsの［スタート］ボタンからメニューをたどって開く操作又はダイアログボックスのメニューを開く操作は，ハイフンでつないで表記します。

（例）

［スタート］ボタンから［プログラム］メニューの下の［DBPARTNER2］メニューを選ぶ操作は「［スタート］-［プログラム］-［DBPARTNER2］メニューを選ぶ」と表記します。

Windowsを組み込んだドライブやフォルダ名は，標準的な例で記述してあります。標準的な環境と異なるWindowsで使うときは，ドライブやフォルダ名をお使いになるWindowsの環境に読み替えてください。

図中で使用する記号

このマニュアルの図中に使う記号を次のように定義します。

条件式の文法で使用する記号

このマニュアルの条件式の説明で使う記号を次のように定義します。

記号

意味

｜

ストローク

横に並べられた複数の項目に対し，項目間の区切りを示し，「又は」の意味を示します。

（例）

A｜B｜Cは，「A，B又はC」を意味します。

{　}

波括弧

この記号で囲まれている複数の項目のうちから一つを選択します。項目が縦に複数行にわたって記述されている場合は，そのうちの1行分を選択します。項目が並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。

（例）

{A｜B｜C}では，「A，B又はCのどれかを指定する」ことを示しています。

〔　〕

きっ甲

この記号で囲まれている項目は省略してもよいことを意味します。複数の項目が縦又は横に並べて記述されている場合には，すべてを省略するか，記号{　}と同じく，どれか一つを選択します。

（例）

〔A〕は「何も指定しない」か，「Aと指定する」ことを示します。〔B｜C〕は「何も指定しない」か，「B又はCと指定する」ことを示します。

…

リーダ

記述が省略されていることを示します。この記号の直前に示された項目を繰り返し複数個指定できます。

（例）

A，B，B，…は，「Aの後ろにBを必要個指定する」ことを示します。

＿

下線

括弧内のすべての項目を省略したときに，システムが仮定する値を示します。複数の項目のうち，1項目にだけ付けてあります。

（例）

〔A｜B｜C〕は，「A，B，Cのどれも指定しなかった場合，システムはCを指定したときと同じ処理をする」ことを示します。

《　》

二重角括弧

設定値を省略したときに，システムが仮定する値を示します。

（例）

《HiRDB》は，「値を省略すると，HiRDBという文字列が仮定される」ことを示します。

△

白三角

空白を空けることを示します。

（例）

EDIT△PANELは，EDITとPANELの間に一つ空白を空けることを示します。

△n

白三角

空白をn回以上繰り返して指定することを示します。

（例）

NOT△₂INは，NOTの後ろに二つ以上の空白を空けることを示します。

コマンドの変数指定で使用する記号

このマニュアルの条件式の変数指定で使う記号を次のように定義します。

記号

意味

〈　〉

項目を記述するときに従わなければならない構文要素を示します。

このマニュアルで使用する構文要素

このマニュアルの文法説明で使用する構文要素の種類を次に示します。

種類

定義

〈英字〉

A〜Z　a〜z

〈英大文字〉

A〜Z　@　#　¥

〈英小文字〉

a〜z

〈数字〉

0〜9

〈英数字〉

A〜Z　a〜z　0〜9

〈カナ文字〉

ア〜ン　ヲ　カナ小文字　゛　゜　ー

〈記号〉

！　”　＃　＄　％　＆　‘　’　（　）　＋　，　ー　．　／　：　；　＜　＝　＞　＠　［　］　＾　＿　｛　｝　￣　タブ　空白

第1編　概要

1　DBPARTNER2の紹介

この章では，DBPARTNER2の特長と機能，サーバと接続する形態について説明します。

1.1　DBPARTNER2の概要

DBPARTNER2とは，クライアントPCからサーバのデータベースにアクセスできるようにする製品です。DBPARTNER2を使うと，サーバのデータベースからデータを取り出したり，データベースのデータを更新したりできます。

DBPARTNER2に関連する製品を次の表に示します。

このマニュアルでは，DBPARTNER2 Clientについて説明します。

表1‒1　DBPARTNER2に関連する製品

DBPARTNER2の関連製品

機能

DBPARTNER2※

DBPARTNER2 Client

WindowsのGUIでデータベースにアクセスする製品です。

注※

必要に応じてクライアントPCにインストールします。DBPARTNER2のインストールとDBPARTNER2の概要については，「2.2　DBPARTNER2のインストール」を参照してください。

DBPARTNER2の関連製品を使ったデータベースへのアクセスを次の図に示します。

図1‒1　DBPARTNER2の関連製品を使ったデータベースへのアクセス

1.2　DBPARTNER2の機能

DBPARTNER2を使うと，データベースから指定した条件に合ったデータを読み込めます（データの抽出）。また，抽出したデータを編集してデータベースを更新できます（データの更新）。

DBPARTNER2の抽出／更新の概要を次の図に示します。

図1‒2　DBPARTNER2の抽出／更新の概要

DBPARTNER2の機能の一覧を次の表に示します。

表1‒2　DBPARTNER2の機能の一覧

DBPARTNER2の機能

説明

必要な製品

データの抽出

DBPARTNER2からサーバ上のデータベースにアクセスしてデータを抽出できます。データを抽出するときは，条件を付けたり件数を制限したりできます。

−

データの更新

DBPARTNER2からサーバにあるデータベースのデータを，追加／変更／削除できます。

−

表の定義

DBPARTNER2からサーバのデータベースに，表を定義できます。

−

DBPARTNER2からのSQL文の入力と実行

DBPARTNER2から，直接SQL文を入力してデータベースにアクセスできます。

−

1.2.1　データの抽出

クライアントPCからサーバ上のデータベースにアクセスしてデータを抽出できます。

DBPARTNER2のGUI画面を使ってデータを抽出する基本操作については「4.1　データの抽出の基本操作」を，詳しい操作については，「4.　データの抽出（［抽出］メニュー）」を参照してください。

DBPARTNER2を使ったデータの抽出を次の図に示します。

図1‒3　DBPARTNER2を使ったデータの抽出

(1)　抽出で使える機能

サーバのデータベースからデータを抽出するときは，抽出する表と抽出するデータの転送先を選んで指定します。このとき，複数の表を結合してデータを抽出することもできます。さらに，データベース上の表からデータを抽出するときに特定した列だけを抽出したり，条件に合うデータだけを抽出したりできます。

抽出で使える機能の一覧を次の表に示します。詳しい操作については，「4.2　抽出で使える機能」を参照してください。

表1‒3　抽出で使える機能の一覧

抽出で使える機能

説明

複数の表を結合して抽出する

表と表で共通する列を結び付けて，一つの表として抽出できます（表結合）。関連する表のデータを一括して利用できます。

表を選択するときに絞り込みをする

抽出対象の表の一覧から抽出する表を選ぶときに，条件を付けて絞り込めます。抽出対象の表が大量にある場合などに，効率良く表を選べます。

特定の列だけを抽出する

抽出する表から特定の列だけを選んで抽出できます。選択した列のデータをソートしたり，列のデータの最大値，最小値などを抽出したりすることもできます。

条件に合うデータを抽出する

抽出する表から条件に合うデータだけを抽出できます。また，複数の条件式を関連付けることもできます。例えば，定価が60,000円以上のデータを抽出する条件と，商品名が冷蔵庫又はテレビのデータを抽出する条件を「AND」で関連付けます。この場合，定価が60,000円以上でかつ，商品名が冷蔵庫又はテレビのデータだけを抽出できます。

特定の列で，条件に合うデータを抽出する

列と条件の両方を設定して，データを抽出できます。指定した列のデータのうち，条件に合うデータだけを抽出できます。

可変記号を使ってデータを抽出する

条件に合うデータを抽出するときに設定する条件式に，可変記号を設定できます。条件式の条件値だけを変更するときに使います。操作を手続き化している場合も，手続きを書き直す必要がなく，可変記号に対する実行値を入力するだけでデータを抽出できます。これによって，日付や市場取引価格などの刻々と変化する値に応じてデータを抽出できます。

抽出するデータの件数を制限する

データを抽出するときに，その件数を指定できます。抽出するデータをソートして上位10件だけを抽出したり，表計算ソフトに表示できるデータ量を考慮して，抽出する件数を制限したりするときなどに使います。

抽出するデータを事前に確認する

実際に抽出を実行する前に，対象となるデータを表示して，そこでデータの内容を確認できます。また，対象となるデータの件数も表示されます。抽出するデータが正しいか，又は抽出する条件が正しいかなどを確認できます。さらに，確認したデータを別表として保存したり，条件を変更／追加して絞り込んだりできます。クライアントPCにデータを抽出する前にデータの内容を確認できるので，効率的にデータを抽出できます。

見出し辞書で，データベースの定義に依存しない表現を使える

データベース内の表名や列名に対して，任意の名称を設定できます。サーバ側のデータベースを意識しないで，業務で使い慣れた名称で操作できます。任意の名称を登録する辞書を見出し辞書といいます。見出し辞書を使うと，DBPARTNER2はサーバではなく見出し辞書にアクセスして表名や列名を取得するため，サーバにアクセスしている間の待ち時間が短縮できます。

手順ファイルを使ってデータを抽出する

データを抽出したときに指定した表名，列名，条件などを手順ファイルに登録して，登録した内容に従って抽出できます。手順ファイルを使うと，毎日同じ条件でデータを抽出するときに作業効率を向上できます。手順ファイルに登録した内容は，必要に応じて変更できます。手順ファイルの操作方法については，「6.1　手順ファイル」を参照してください。

1.2.2　抽出したデータの用途

DBPARTNERからデータを抽出するときに転送先（又は連携先）を選択すると，データの使い道を選べます。抽出データの用途について次の表に示します。

表1‒4　 抽出したデータの用途

用途

説明

抽出データの参照（表示）

抽出したデータを結果表示用の画面，又は連携先に表示させて確認できます。

抽出データの更新

抽出したデータを編集して，データベースを更新できます。

抽出データの格納

抽出したデータはtext形式やExcel形式にしてファイルに格納できます。

1.2.3　データの更新

DBPARTNER2からデータベースのデータを追加，変更又は削除できます。DBPARTNER2のGUI画面を使ってデータを更新する方法については，「5.　データの更新（［抽出］メニュー）」を参照してください。

DBPARTNER2のGUI画面を使ってデータを更新する方法には，表計算ソフト（Excel）からデータを更新する方法とDBPARTNER2のウィンドウを使ってデータを更新する方法があります。

(1)　表計算ソフトからデータを更新する場合

表計算ソフトを起動して，連携用のメニューを選んでください。

抽出する表，列，条件などを設定します。設定した条件に従って抽出したデータは，表計算ソフトのウィンドウに貼り付けられます。

表計算ソフトのウィンドウでデータを編集して更新データを作成します。最後に表計算ソフトのメニューからデータベースを更新するコマンドを選んでデータベースを更新します。

(2)　DBPARTNER2のウィンドウを使ってデータを更新する場合

データベースからデータを抽出します。データの抽出と同様に条件を設定したり，手順ファイルを利用したりして抽出できます。

DBPARTNER2のウィンドウ上で，抽出したデータの一部を変更するなどの編集をして，更新データを作成します。

DBPARTNER2のウィンドウからコマンドを選んで，データベースのデータを更新します。

(3)　データ更新の例

DBPARTNER2を使ったデータの更新を次の図に示します。

図1‒4　DBPARTNER2を使ったデータの更新

1.2.4　表の定義

クライアントPCからサーバのデータベースに，表を定義できます。DBPARTNER2のGUI画面から必要な情報を入力するだけで表を定義できるので，SQLを使う必要がありません。また，既に定義した表を編集したり削除したりできます。表を定義する方法については，「9.　定義（［定義］メニュー）」を参照してください。

DBPARTNER2からの表定義の概要を次の図に示します。

図1‒5　DBPARTNER2からの表定義

(1)　表を定義するときに指定する項目

表を定義するときは，次に示す項目を指定します。

表名，表見出し及び表注釈の定義

表名，表見出し及び表注釈は［表定義］ダイアログボックスで定義します。このうち，表名は必ず定義してください。表名，表見出し及び表注釈の定義については，「9.2.1　表定義」を参照してください。

列名，列見出し，列属性，データ長及び小数点以下のけた数の定義

列名，列見出し，列属性，データ長及び小数点以下のけた数は［列定義］ダイアログボックスで定義します。このうち，列名及び列属性は必ず定義してください。列名，列見出し，列属性，データ長及び小数点以下のけた数の定義については，「9.2.2　列定義」を参照してください。

(2)　定義した表に対する詳細情報の定義

定義した表には，その表に対する詳細情報を定義できます。定義できる詳細情報を次に示します。

(a)　列注釈の定義とNULL値禁止の指定

定義したそれぞれの列に，注釈を定義できます。さらに，定義した列にNULL値が指定されるのを禁止できます。列注釈とNULL値の禁止は［列詳細定義］ダイアログボックスで定義します。列注釈の定義とNULL値の禁止については，「9.2.3　列詳細定義」を参照してください。

(b)　表を格納する領域の指定

HiRDBに定義した表は，RDエリアへ格納されます。DBPARTNER2からは，定義した表を格納するRDエリアを指定できます。また，任意の列をキーにして表の行データを分割して，複数のRDエリアに格納することもできます。表を格納するRDエリアと表の格納条件は［格納領域設定］ダイアログボックスで定義します。

ORACLEに定義した表は，テーブルスペースへ格納されます。DBPARTNER2からは，定義した表を格納するテーブルスペースを指定できます。

表を格納する領域の指定については，「9.2.4　格納領域設定」を参照してください。

(c)　インデクスの定義

定義した表に対してインデクスを定義できます。インデクスの定義については，「9.2.5　インデクス定義」を参照してください。

1.2.5　DBPARTNER2からのSQL文の入力と実行

DBPARTNER2から，直接SQL文を入力してデータベースにアクセスできます。

入力できるSQL文については，該当するデータベースのマニュアルを参照してください。

1.3　DBPARTNER2とサーバを接続する形態

DBPARTNER2とサーバを接続する形態について説明します。DBPARTNER2の接続形態は，ODBC接続です。

ODBC接続

ODBCに準拠した方式で，クライアントPCとデータベースがあるサーバを接続する形態です。

1.3.1　ODBC接続の場合のアクセス形態

(1)　ODBCドライバを使ってアクセスできるデータベース

ODBCドライバを使ってアクセスできるデータベースを次の表に示します。

表1‒5　ODBCドライバを使ってアクセスできるデータベース

ドライバの種類

アクセスできるデータベース

DBPARTNER ODBC 3.0 Driver

HiRDB，Oracle，VOS3 XDM/RD E2，VOS3 XDM/SD E2

HiRDB ODBC 3.0 Driver

HiRDB

Oracle ODBC Driver

Oracle

HADB ODBC Driver

HADB

(2)　適用範囲（ODBC接続の場合）

ODBC接続の場合の，DBPARTNER2の適用範囲について説明します。データベースによって，使える機能に制限があります。制限については，「付録C　データベースとDBPARTNER2で使える機能の関係」を参照してください。

(a)　結合できる表の数

1回のデータ抽出処理で処理対象にできるデータベースの個数は1個です。つまり，複数のデータベースから同時にデータを抽出できません。

1個のデータベースから結合できる表の最大数は，データベースによって異なります。結合できるデータベースの表の最大数を次の表に示します。

表1‒6　結合できる表の最大数（ODBC接続）

データベース

結合できる表の最大数

VOS3 XDM/SD E2

1個

HiRDB，ORACLE，HADB，VOS3 XDM/RD E2

15個

権限によって処理対象とならない表があります。権限については，システム管理者に確認してください。

(b)　DBPARTNER2でのデータベースの用語

DBPARTNER2では，各データベースで使う用語を統一して扱っています。DBPARTNER2でのデータベースの用語を次の表に示します。

表1‒7　DBPARTNER2でのデータベースの用語（ODBC接続）

データベース

DBPARTNER2で使う用語

表

表名

列名

意味

データの集まりの単位

サーバが表に付けた名称

表内の列に付けられた名称

VOS3 XDM/RD E2

表

表ヘッダ又は表名※

列ヘッダ又は列名※

HiRDB，ORACLE，

HADB

表

表名

列名

VOS3 XDM/SD E2

表

表見出し，又は表名

列見出し，又は構成要素名

注※

ヘッダを定義している場合は，ヘッダの情報が表名，又は列名として扱われます。

(c)　抽出したデータをほかのアプリケーションに転送するときの条件

抽出したデータを，ほかのアプリケーション（表計算ソフト）のシートに転送する場合の条件について説明します。

Excelとの連携

DBPARTNER2の転送先にExcel連携を設定した場合，データの抽出と同時にExcelが自動起動します。

(d)　データ形式

DBPARTNER2で扱える形式のデータの一覧を次の表に示します。DAT形式とTEXT形式のデータについては，「付録B　ファイル出力するデータ形式のフォーマット」を参照してください。

表1‒8　転送時のデータ形式

形式

拡張子

利用できるソフトウェア

CSV

.csv

流通ソフトウェア

DAT

.dat

流通ソフトウェア

TEXT

.txt

流通ソフトウェア

XLSB

.xlsb

Excel 2007以降

XLSX

.xlsx

Excel 2007以降

1.4　DBPARTNER2で使える文字

DBPARTNER2で使える文字についての注意を次に示します。

データベースに格納されているデータは，JIS/S-JISで取り出してください。JIS/S-JISコードの文字とは，次のような文字です。

1バイト文字でX'20'〜X'7E'，又はX'A1'〜X'DF'

2バイト文字で1バイト目が，X'81'〜X'9F'，又はX'E0'〜X'FC'

2バイト文字で2バイト目が，X'40'〜X'7E'，又はX'80'〜X'FC'

例えば，CHAR属性の列にX'00'が入っている場合は，X'00'以降のデータは取り出されません。データを取り出す対象となる列にX'00'から始まるデータが格納されている場合は，NULL値となります。

データを取り出す対象となる列にバイナリデータが格納されている場合は，文字列として取り出されます。

JIS/S-JIS以外のデータを取り出した場合は，正しく動作しません。

0バイト定数とNULL値を区別しないでください。

DBPARTNER2では，0バイト定数とNULL値はどちらもNULL値として扱われ，区別されません。

データは，JIS/S-JISコードでデータベースに格納してください。ただし，一つの列が4096バイト以上のデータは更新できません。

表名や列名にダブルクォーテーション（"）を含まないでください。表名や列名にダブルクォーテーションが含まれている場合は，正しく動作しません。

Windowsの［画面のプロパティ］の［フォントサイズ］は，「小さいフォント」，又は「大きいフォント」に設定してください。それ以外のフォントが設定されている場合，画面が正しく表示されない場合があります。

第2編　準備

2　環境の設定

この章では，DBPARTNER2の実行環境を設定する方法について説明します。

2.1　DBPARTNER2の環境を設定する手順

DBPARTNER2の環境を設定する手順について説明します。

2.1.1　ODBC接続の場合に環境を設定する手順

DBPARTNER2 ClientをODBC接続で使うときの環境設定の手順を次に示します。

DBPARTNER2 Clientをインストールします。

DBPARTNER2 ClientをクライアントPCに組み込みます。インストール手順については，「2.2　DBPARTNER2のインストール」を参照してください。

接続先定義ファイルを設定します。

DBPARTNER2からアクセスするサーバの環境を設定するファイルを，接続先定義ファイルといいます。接続先定義ファイルに指定するパラメタについては，「2.4　接続先定義ファイルの作成」を参照してください。

接続先定義ファイル以外にも，情報ファイルに接続先の情報を指定できます。情報ファイルの作成方法については，「2.5　情報ファイルの作成」を参照してください。

ODBCドライバをセットアップします。

ODBCドライバのセットアップについては，「2.6　DBPARTNER ODBC 3.0 Driverのセットアップ」を参照してください。

DBPARTNER2を起動して，接続先のサーバと利用者を設定します。

接続先のサーバと利用者を設定する方法については，「3.3　接続先のサーバと利用者の設定（［接続］メニュー）」を参照してください。

環境設定で作成する接続先定義ファイルの内容とODBCドライバのセットアップ時の設定内容との関係を次の図に示します。

図2‒1　環境設定で作成する接続先定義ファイルの内容とODBCドライバのセットアップ時の設定内容との関係（ODBC接続の場合）

注※1

接続先定義ファイルに「大阪センタ」という接続先に関する情報を定義します。

注※2

「&UID」「&PASS」の代わりに，実際のユーザIDとパスワードに使う文字列を指定すると，毎回その値でサーバにアクセスします。

2.2　DBPARTNER2のインストール

DBPARTNER2をインストールする方法について説明します。

2.2.1　DBPARTNER2の製品の種類

DBPARTNER2には，参照版，更新版，定義版があります。業務で使うDBPARTNER2を選んでインストールしてください。

(1)　DBPARTNER2の製品体系

DBPARTNER2は，次の製品を同梱しています。DBPARTNER2の製品名と機能を次の表に示します。

表2‒1　DBPARTNER2の製品名と機能

DBPARTNER2の製品名

機 能

DBPARTNER2 Client

WindowsのGUIでデータベースにアクセスする製品です。

2.2.2　DBPARTNER2のインストールの手順

画面に従ってインストールしてください。

2.2.3　DBPARTNER2をインストールすると作成されるファイル

DBPARTNER2をインストールすると作成されるフォルダの構成とファイルの一覧をそれぞれ次の図と表に示します。

図2‒2　DBPARTNER2をインストールすると作成されるフォルダの構成

注※1

DBPARTNER2 Client をインストールした，任意のフォルダを示します。

注※2

Windowsの標準的なシステムフォルダを示します。

表2‒2　DBPARTNER2をインストールすると作成されるファイルの一覧

ファイルの格納先

コンポーネント

ファイル名

ファイルの内容

DBPARTNER2 Client のフォルダ

DBPARTNER2

Readme.txt

Readmeファイル

DBP2REG.exe

再配布ファイル

登録用の実行形式

DBPOREG3X.exe

ODBCドライバインストール用

DBPARTNER2 Client¥GUI のフォルダ

DBPARTNER2

Dbpart2.exe

実行形式

Dbp2upd.exe

結果表示の実行形式

Dbico.dll

Dbp2cat.dll

Dbp2cch.dll

Dbp2ccm.dll

Dbp2cdl.dll

Dbp2cpr.dll

Dbp2ctr.dll

Dbp2def.dll

Dbp2dic.dll

Dbp2dpl.dll

Dbp2ex.dll

Dbp2exl.dll

Dbp2prs.dll

ダイナミックライブラリ

dbp2exl(64)2019.xlam

Excel 2019連携アドイン

dbp2exl_img1.png

dbp2exl_img2.png

dbp2exl_img3.jpg

Excel連携アドイン関連ファイル

Dbpcon.dpl

接続先定義ファイル

Dbpart2.inf

情報ファイル

Dbpart2.ini

設定ファイル

Dbpart2.err

エラーメッセージ

Dbpart2.hlp

オンラインヘルプ

見出し変更ツール

Dbp2dicutl.exe

見出し変更の実行形式

Dbp2dict.ocx

見出し変更ツール部品

DBPARTNER2 Clientのフォルダ¥Samples

ファイルのサンプル

dbpodcon.dpl

ODBC接続の設定例

Windowsのフォルダ¥System32

Visual Studio再配布ファイル

mfc140.dll

mfc140u.dll

mfcm140.dll

mfcm140u.dll

concrt140.dll

msvcp140.dll

msvcp140_1.dll

msvcp140_2.dll

msvcp140_codecvt_ids.dll

vccorlib140.dll

vcruntime140.dll

vcruntime140_1.dll

再配布ファイル

DBPARTNER2

Dbp2xdl.dll

Dbp2xll.dll

ダイナミックライブラリ

ODBC

Dbpodbc3X.dll

Dbpodst3X.dll

DBPARTNER ODBC 3.0 Driver

Windowsのフォルダ¥SysWOW64

Visual Studio再配布ファイル

MSVBVM50.dll

VB5JP.dll

再配布ファイル

注

DBPARTNER2 Clientのフォルダとは，クライアントPCにDBPARTNER2 Clientをインストールしたフォルダのことです。デフォルトでは，C:¥Program Files¥Hitachi¥Dbp2clフォルダになります。

Windowsのフォルダとは，Windowsをインストールしたフォルダ（C:¥Windows）を示します。

2.2.4　再インストールする方法

DBPARTNER2が使うファイルが破壊された場合やバージョンを変更する場合は，DBPARTNER2を再インストールする必要があります。

再インストールするときは，「2.2.2　DBPARTNER2のインストールの手順」に従ってください。インストールを途中で中止した場合も，再インストールし直してください。

表2-2に示すファイルが既にシステムにある場合は，一部のユーザ資産（接続先定義ファイル「Dbpcon.dpl」及び情報ファイル「Dbpart2.inf」）を除き，そのファイルの内容は置き換えられます。

2.2.5　アンインストールする方法

アンインストールできるのは，前回インストールしたファイルです。次に示すファイルはアンインストールされません。

インストール時に上書きされなかったファイル（接続先定義ファイルなど）

抽出データ格納用に作成したファイルなどユーザが作成したファイル

アンインストールの手順を次に示します。

［コントロールパネル］から［アプリケーションの追加と削除］アイコンを開きます。

［アプリケーションの追加と削除のプロパティ］ダイアログボックスの［セットアップと削除］タグを選ぶと，インストール済みのアプリケーションの一覧が表示されます。

一覧からDBPARTNER2 Client(64)を選んで［追加と削除］ボタンをクリックします。

2.3　DBPARTNER2を稼働するときに作成するファイル

DBPARTNER2を稼働するときに作成するファイルを次の表に示します。

表2‒3　DBPARTNER2を稼働するときに作成するファイル

ファイルの種類

ファイル名

格納する内容

必要度

接続先定義ファイル

Dbpcon.dpl，又はユーザ任意

接続先のサーバの環境など

○

情報ファイル

Dbpart2.inf

データ入力やデータ表示，キャンセル処理に関する設定など

△

（凡例）

○：必要なファイルです。

△：任意に作成できるファイルです。

2.3.1　接続先定義ファイル

接続するサーバの環境，起動／終了操作などを定義するファイルです。接続先定義ファイルは，インストール後に必ず作成してください。

接続先定義ファイルには，アクセスするサーバの環境を定義します。このため，環境を知っているシステム管理者相当の方が作成してください。

インストールすると，DBPARTNER2 Clientのフォルダ¥GUI下に「Dbpcon.dpl」というファイル名で作成されます。カスタムインストールの場合は任意の名称を設定できます。この場合，拡張子は「.dpl」にしてください。

接続先定義ファイルの作成方法については，「2.4　接続先定義ファイルの作成」を参照してください。

2.3.2　情報ファイル

接続先定義ファイルとオプション画面で設定できる項目以外で，更に詳細にDBPARTNER2の動作を変更するため使うファイルです。

ファイル名は「Dbpart2.inf」で固定です。情報ファイルの作成方法については，「2.5　情報ファイルの作成」を参照してください。

2.4　接続先定義ファイルの作成

接続先定義ファイルには，DBPARTNER2からアクセスする接続先（サーバ）の環境や操作するときのオプションを指定します。接続先定義ファイルは，サーバの環境を知っているシステム管理者の方が作成してください。

一つのファイル内には，複数の接続先を定義できます。ファイル名は任意に決められます。また，いったん作成した接続先定義ファイルに新しく接続先を追加したり，既存の接続先の定義内容を変更したりできます。

DBPARTNER2をインストール時，接続先定義ファイルがない場合は，DBPARTNER2が作成します（ファイル名は「Dbpcon.dpl」）。

2.4.1　接続先定義ファイルの作成手順

DBPARTNER2 Clientのフォルダ¥GUIにある，Dbpcon.dpl，又はサンプルファイルを，Notepad.exeなどのテキストエディタで開きます。

サンプルファイルとして，次のものが提供されています。

サンプルの格納先：DBPARTNER2のフォルダ¥Samples

サンプルファイル名：Dbpodcon.dpl（ODBC用）

データを編集します。

詳細は，「2.4.2　パラメタに指定する値」以降を参照してください。

完成したテキストを（「Dbpcon.dpl」のファイル名で）上書き保存します。

2.4.2　パラメタに指定する値

接続先定義ファイルのパラメタに指定する内容について説明します。パラメタの一覧を次の表に示し，以降各パラメタについて説明します。

表2‒4　接続先定義ファイルに指定するパラメタ

パラメタ

定義する内容

指定例

ODBC

※

HOSTNAME：

接続先のサーバの名称

HOSTNAME：大阪センタ

○

CNCTOPT：

接続オプション（サーバとの接続・切断のタイミング）

CNCTOPT：ALLTIME

△

COM：

使用する通信形態

COM：ODBC

○

CLMHEAD：

Excelのシートへ，又はTEXT形式，DAT形式のファイルへデータを転送するときの項目名の有無

CLMHEAD：YES

CLMHEAD：NO

△

CLMMAXCNT：

列一覧に表示する列数の最大

CLMMAXCNT：256

△

DATACHK：

抽出したデータをテキスト形式に変換する場合のデータチェックの要不要

DATACHK：YES

DATACHK：NO

DATACHK：SEL

△

EXCLUSIVE：

データベースの排他オプション

EXCLUSIVE：WITH SHARE LOCK

△

INDICATE：

［抽出経過表示］ダイアログボックスでの，グラフ又は抽出件数の表示の有無

INDICATE：YES

INDICATE：NO

△

INFNAME：

情報ファイル名のパス

INFNAME：C:¥USERINF.INF

△

TBLMAXCNT：

表一覧に表示する表数の最大

TBLMAXCNT：256

△

UPDFIN：

次の時点でそれまでの処理を有効にするかを確認するメッセージの出力を指定します。

更新処理中に［キャンセル］ボタンをクリックした時点

作成した更新データに対する更新処理が終了した時点

データベースを更新し，終了処理中にエラーが発生した時点

UPDFIN：0

UPDFIN：1

UPDFIN：2

UPDFIN：3

△

UPDINS

追加する行にNULL値のデータを含む場合の扱い

UPDINS：NULLSET

UPDINS：NULLNONE

△

UPDUNIT：

データベース更新時に更新処理を実行する単位

UPDUNIT：BLOCK

UPDUNIT：SINGLE

UPDUNIT：BLOCK2

UPDUNIT：ROWID

△

UPEXCLUSIVE：

更新する表が使用中だったときの対処

UPEXCLUSIVE：WITH　ROLLBACK=ON

UPEXCLUSIVE：WITH　ROLLBACK=OFF

△

〈

コメント

〈ログオン操作〉

△

NCHARTYPE：

NCHAR属性に指定する半角文字の扱い

NCHARTYPE：1

△

ODBCCON：

サーバに接続するときのユーザID〔，パスワード〕

ODBCCON：&UID

〔，&PASS〕

△

ODBCHEAD：

ODBC接続でサーバがVOS3　XDM/RD E2編成ファイルの場合，表ヘッダ及び列ヘッダの表示の有無

ODBCHEAD：ALL

ODBCHEAD：TBL

ODBCHEAD：CLM

ODBCHEAD：NO

△

TABLESPACE：

抽出結果として表をデータベース内に格納する場合の格納領域名称

TABLESPACE：table1

△

TBLPRFIX：

データベースに格納する抽出結果の，表の名称の先頭文字

TBLPRFIX：table1

△

（凡例）

○：必ず指定するパラメタです。

△：任意に指定できるパラメタです。

注※

ODBC接続を示します。

(1)　CLMHEAD:{YES | NO}

機能

抽出データをファイル，又はクリップボードに格納する場合に，項目名を出力するかどうかを，YES又はNOで指定します。このパラメタを省略すると，NOが仮定されます。

YES：抽出データの1列目に項目名を出力します。

NO ：抽出データの1列目に項目名を出力しません。

使用制限

すべての接続形態で使用できます。

指定例

CLMHEAD:YES

(2)　CLMMAXCNT:0〜8192

機能

列一覧に表示する最大の列数を指定します。指定範囲は0〜8192です。0を指定した場合は，制限はありません。このパラメタを省略すると，0が仮定されます。

使用制限

すべての接続形態で使用できます。ただし，次に示す場合は制限が有効になりません。

列見出しを作成するとき

定義機能を使用するとき

見出し辞書を使用するとき

指定例

CLMMAXCNT:8192

注意事項

CLMMAXCNTで列情報が，繰り返し列又は配列列の最初の要素番号で切られた場合，その列は繰り返し列又は配列列として扱われません。このような場合，DBP0708Wメッセージが出力されるので，CLMMAXCNTの値を大きくしてください。

(3)　CNCTOPT:{ALLTIME | ANYTIME}

機能

サーバとの接続・切断のタイミングを指定します。サーバに対してアクセス要求が発生している期間だけサーバと接続するか，アクセス要求に関係なくサーバと接続したままとするかを指定します。なお，どちらの場合もDBPARTNER2 Clientがサーバにアクセス要求が発生する場合，［サーバアクセス］ダイアログボックスが表示されます。

ALLTIME

一度サーバとの接続が行われると，ユーザが切断するまでサーバと接続したままとなります。処理速度は向上しますが，サーバを占有してしまうことになります。

ANYTIME

サーバに対してアクセス要求が発生している期間だけサーバと接続します。処理が終了すると自動的に切断されます。サーバを占有することはありませんが，1回の処理速度が低下します。アクセス要求が発生している期間を次に示します。

ユーザID及びパスワードを確認している期間

表名の一覧をデータベースから取得する期間

列名の一覧をデータベースから取得する期間

表名，列名，条件などを設定後，抽出するデータの件数を確認する期間

表名，列名，条件などを設定後，データを抽出している期間

更新処理の開始から終了するまでの期間

使用制限

すべての接続形態で使用できます。

指定例

CNCTOPT:ANYTIME

(4)　COM:{ODBC}

機能

使用する通信形態を指定します。

ODBC ：ODBC接続

使用制限

すべての接続形態で使用できます。ODBC接続の場合は，必ず設定してください。

指定例

COM:ODBC

(5)　DATACHK:{YES | NO | SEL}

機能

抽出データの中の表示できない文字をチェックするかどうかを指定します。このパラメタを省略すると，「NO」が仮定されます。

NO：文字をチェックしません。

YES：文字をチェックし，表示できない文字があった場合は，処理を中止します。

SEL：文字をチェックし，表示できない文字があった場合は，処理の中止/続行を問い合わせます。

使用制限

すべての接続形態で使用できます。

指定例

DATACHK:SEL

(6)　EXCLUSIVE:任意の文字列

機能

データを抽出するときのデータベースへの排他モードを設定します。ここで指定した文字列は，DBPARTNER2 Clientが作成したSQLの最後に付加されます。排他モードについては，各データベースのマニュアルを参照してください。

使用制限

すべての接続形態で使用できます。

指定例

EXCLUSIVE:WITH SHARE LOCK

(7)　HOSTNAME:任意の文字列

機能

接続先を選択する画面に表示する文字列を指定します。接続するサーバをユーザが識別できるようにするための名称です。ユーザが識別できれば，どんな名称を指定してもかまいません。ただし，ODBC接続の場合，データソース名と同じ文字列を指定してください。

文字数は半角文字32文字まで入力できます。全角文字と半角文字が混在してもかまいません。

使用制限

すべての接続形態で使用します。必ず設定してください。

指定例

HOSTNAME:東京センタ

(8)　INDICATE:{YES | NO}

機能

抽出処理の経過を示す画面の表示を指定します。このパラメタを省略すると，YESが仮定されます。

YES：抽出処理の経過を示す画面を表示します。

NO：抽出処理の経過を示す画面を表示しません。

使用制限

すべての接続形態で使用できます。

指定例

INDICATE:YES

(9)　INFNAME:絶対パスファイル名

機能

情報ファイルのパス名を指定します。拡張子は「.inf」とし，絶対パスファイル名で指定してください。パラメタを指定しない，又は指定した情報ファイル名がない場合は，Dbpart2.infの情報を使用します。

使用制限

すべての接続形態で使用できます。

指定例

 INFNAME:C:¥USERINF.INF

(10)　NCHARTYPE:{0 | 1 | 2}

機能

NCHAR属性の列に指定する定数に含まれる半角文字の扱いを指定します。

0

全角文字だけが指定できます。半角文字を含んでいる場合はエラーとなります。

1

全角文字と半角スペース文字が指定できます。ただし，半角スペースが文字列の先頭に奇数個ある場合はエラーとなります。また，文字列に含まれている半角スペースの個数が奇数個の場合は，文字列の最後に半角スペースを自動的に付加します。ただし，「'」（シングルクォーテーション）で囲まれている場合は半角スペースを付加しません。

2

全角文字，及び半角文字が指定できます。ただし，文字列に含まれている半角文字の個数が奇数個の場合は，文字列の最後に半角スペースを自動的に付加します。ただし，「'」（シングルクォーテーション）で囲まれている場合は半角スペースを付加しません。

このパラメタを省略すると，0が仮定されます。

使用制限

ODBC接続の場合に使用できます。

指定例

NCHARTYPE:2

(11)　ODBCCON:ユーザID[,パスワード]

機能

ODBC接続の場合，サーバに接続するときのユーザID,パスワードを指定します。

使用制限

ODBC接続の場合に使用できます。

指定例

ODBCCON:USER1,PASS1

(12)　ODBCHEAD:{ALL | TBL | CLM | NO}

機能

ODBC接続の場合に表ヘッダ及び列ヘッダの表示の有無を指定します。表ヘッダ及び列ヘッダが表示できるのは，VOS3 XDM/RD E2編成ファイルの場合だけです。また，このパラメタがALL又はCLMの場合，抽出データの項目名はDBPARTNER2 Clientで作成します。それ以外の場合，サーバから返される項目名となります。このパラメタを省略すると，NOが仮定されます。

ALL：表ヘッダ及び列ヘッダを表示します。

TBL：表ヘッダだけ表示します。

CLM：列ヘッダだけ表示します。

NO：表ヘッダ及び列ヘッダを表示しません。

使用制限

ODBC接続の場合に使用できます。

指定例

ODBCHEAD:ALL

(13)　TABLESPACE:任意の文字列

機能

抽出結果をデータベースに格納する場合に，表を格納する領域名称を指定します。このパラメタで設定した表領域名称が表定義時に表示されます。領域名称にはデータベースで定義されている名称を指定してください。このパラメタを省略するとデータベースによって作業領域が割り当てられて格納されます。

抽出結果として表をデータベースに格納する操作を次に示します。

転送先を「データベース」としてデータを抽出する。

データ確認でサンプル表示したデータを保存利用する。

予約処理をする。

使用制限

ODBC接続の場合に使用できます。

指定例

TABLESPACE:table1

(14)　TBLMAXCNT:0〜8192

機能

表一覧で表示する表数の最大を個数で指定します。指定範囲は0〜8192です。表一覧には，このパラメタで指定した数まで表示できます。このパラメタを省略すると0が仮定されます。 使用する用語辞書によって，操作時に表一覧に表示される最大表数が異なります。

使用制限

すべての接続形態で使用できます。ただし，見出し辞書で「DBPARTNER2の情報を利用する」を使用している場合は，無視されます。

指定例

TBLMAXCNT:8192

(15)　TBLPRFIX:任意の文字列

機能

抽出結果として表をデータベースに格納する場合に，表の名称の先頭文字を指定します。

このパラメタで設定した先頭文字が表定義時に表示されます。

抽出結果として表をデータベースに格納する操作を次に示します。

転送先を「データベース」としてデータを抽出する。

データ確認でサンプル表示したデータを保存利用する。

予約処理をする。

抽出結果としての表に先頭文字を付けることで，［定義］メニューの［表定義］で定義した表及びデータベース内の既存の表を区別できます。

使用制限

ODBC接続の場合に使用できます。

指定例

TBLPRFIX:table1

(16)　UPDFIN:{0 | 1 | 2 | 3}

機能

次に示す時点で，更新処理の有効（Commit），無効（Rollback）にするかを確認するメッセージの出力を指定します。

このパラメタを省略すると，0が仮定されます。

0

更新処理が正常終了した時点で，自動的に有効（Commit）にする。処理をキャンセルしたり，エラーが発生したりすると更新処理を自動的に無効（Rollback）にする。

1

更新処理が正常終了した時点で有効（Commit）／無効（Rollback）を問い合わせるメッセージを表示する。処理をキャンセルしたり，エラーが発生したりすると更新処理を自動的に無効（Rollback）にする。

2

更新処理が正常終了した時点で，自動的に有効（Commit）にする。処理をキャンセルしたり，エラーが発生したりすると有効（Commit）／無効（Rollback）を問い合わせるメッセージを表示する。

3

更新処理が正常終了した時点で有効（Commit）／無効（Rollback）を問い合わせるメッセージを表示する。処理をキャンセルしたり，エラーが発生したりすると有効（Commit）／無効（Rollback）を問い合わせるメッセージを表示する。

使用制限

すべての接続形態で使用できます。ODBC接続でRollbackをサポートしていないデータベースのときは，このパラメタは無視されます。

UPDFINに2又は3を指定する場合の注意事項

エラーが発生した時にエラー発生行までの更新処理を有効（Commit）にする場合，発生したエラーの内容や有効にするデータに問題がないことを確認した上で実行してください。

データ更新時に発生したエラーによってはサーバプログラムで自動的にRollbackされ更新処理が無効になる場合があります。この場合，有効（Commit）を選択してもエラー発生行までの更新処理を有効にすることはできません。

指定例

UPDFIN:3

(17)　UPDINS:{NULLSET | NULLNONE}

機能

UPDUNITパラメタでBLOCK/BLOCK2/ROWIDのどれかを使用した場合で，追加（INSERT）する行にNULL値のデータを含む場合の扱いを指定します。UPDUNITパラメタを省略，又はSINGLEを指定している場合は無視されます。このパラメタを省略すると，NULLSETが仮定されます。

NULLSET

NULL値を設定した列のデータとしてデータベースにNULL値を挿入します。データベースの仕様によって，NULL値を挿入できない場合があります。このような場合は，データベース側のエラーが返されます。

NULLNONE

NULL値を設定しなかった列以外のデータだけをデータベースに挿入します。データを挿入しなかった列の扱いはデータベースによって異なります。

NULLNONEを指定した場合の注意事項

NULLNONEを設定した場合，更新する行のNULL値の有無を判断しながら更新処理を実行します。特に更新する行が複数あり，各行のNULL値の位置に統一性がない場合は，NULLSETを設定した場合に比べて，処理に時間が掛かります。

指定例

UPDINS：NULLNONE

(18)　UPDUNIT:{SINGLE | BLOCK | BLOCK2 | ROWID}

機能

データベースの更新処理を行うSQLの作成単位を指定します。このパラメタを省略すると，SINGLEが仮定されます。

SINGLE：1行単位

BLOCK ：更新種別（変更，追加，削除）単位

BLOCK2：変更・削除は行の条件データのNULL値の並びが同一の単位，追加は種別単位

ROWID ：更新種別（変更・追加・削除）単位で，特定行に対して変更・削除を実行

使用制限

すべての接続形態で使用できます。

指定例

UPDUNIT:SINGLE

BLOCKを指定した場合の注意事項

NULL値データを含む行の変更，削除はできません。NULL値データを含む行の変更，削除が行われた場合，DBP0712Wメッセージが表示されます。NULL値データを含む行の変更，削除を行う場合は，SINGLEを指定してください。

漢字，混在文字データを含む行の変更，追加，削除はできません。漢字，混在文字データを含む行の変更，追加，削除が行われた場合，ODBCマネージャの仕様によってエラーが表示されます。漢字，混在文字データを含む行の変更，追加，削除を行う場合は，SINGLEを指定してください。

BLOCK2を指定した場合の注意事項

変更，削除を行う行データの，NULL値の並びが同一の単位でSQLを作成します。そのため，BLOCK更新でNULL値データを含む行の変更，削除ができます。

NULL値の並びが頻繁に変わる場合は，性能が悪くなります。

ROWIDを指定した場合の注意事項

ROWIDを指定すると，特定行を変更又は削除できます。そのため，例え同一データの行が複数存在しても，変更又は削除したデータしか更新されません。

ROWIDを使用できるのは，ODBC接続でデータベースがHiRDB，ORACLE，VOS3 XDM/RD E2の場合だけです。ROWIDを使用できないデータベースに対して指定された場合には，接続時にエラーとなります。

(19)　UPEXCLUSIVE

機能

データを更新するときのデータベースへの排他モードを設定します。ここで指定した文字列は，DBPARTNER2 Clientが作成したSQLの最後に付加されます。排他モードについては，各データベースのマニュアルを参照してください。

使用制限

すべての接続形態で使用できます。

指定例

UPEXCLUSIVE:WITH ROLLBACK

2.4.3　パラメタを指定するときの規則

接続先定義ファイルに指定するパラメタの規則について説明します。

(1)　パラメタの定義順序

HOSTNAME：パラメタを必ず先頭に定義してください。そのほかのパラメタの指定順序は任意です。

(2)　パラメタの書き出し位置

各パラメタの先頭に空白文字を入れないでください。

（正しい例）

1カラム目
↓
HOSTNAME：大阪センタ

（誤った例）

1カラム目に空白
↓
△△HOSTNAME：大阪センタ

（凡例）

△：1文字の空白

(3)　入力できる文字

各パラメタは半角文字（JIS8コード）で入力してください。ただし，次に示す文字列は全角文字（シフトJISコード）でも入力できます。全角文字と半角文字が混在してもかまいません。

HOSTNAME:パラメタに指定するサーバ名称

＜パラメタに指定するコメント行の文字列

(4)　各パラメタに指定できる文字数

各パラメタは，すべて1行で指定してください。2行にわたる指定はできません。また，1行は256バイト以内としてください。

(5)　指定回数

一つのファイルに異なる複数の接続先を定義できます。ただし，同じ接続先を複数指定できません。一つの接続先ごとに表2-1に示した必ず指定するパラメタをすべて定義してください。また，一つの接続先に対して同じパラメタを複数指定できません（ただし，＜コメントは複数指定できます）。

（正しい例）

1カラム目
↓
 HOSTNAME:大阪センタ
 CNCTOPT:ALLTIME
 ＜ログオフ操作＞
 COM:ODBC

 HOSTNAME:東京センタ
 CNCTOPT:ALLTIME
 COM:ODBC

（誤った例）

二つ目の接続先にHOSTNAME:パラメタの指定がない

1カラム目
↓
 HOSTNAME:大阪センタ
 CNCTOPT:ALLTIME
 ＜ログオフ操作＞
 COM:ODBC

 CNCTOPT:ALLTIME
 COM:ODBC

2.5　情報ファイルの作成

情報ファイルとは，接続先定義ファイルとオプション画面で設定できる項目以外で，さらに詳細にDBPARTNER2の動作を変更するために使うファイルです。情報ファイルは，インストール時に「DBPARTNER2 Clientのフォルダ¥GUI」下に「Dbpart2.inf」というファイル名で作成されます。作成されたファイルの定義内容を，必要に応じて編集できます。

2.5.1　情報ファイルの作成手順

情報ファイルは次の手順で作成します。作成した情報ファイルの内容は，次回のDBPARTNER2の起動から有効になります。

DBPARTNER2をインストールしたフォルダ¥GUI から，Dbpart2.infをNotepad.exeなどのテキストエディタで開きます。

テキストを編集します。

項目の指定方法については，「2.5.2　情報ファイルに指定できる項目」以降を参照してください。

完成したテキストを上書き保存します。

2.5.2　情報ファイルに指定できる項目

情報ファイルに指定できる項目を次の表に示します。

表2‒5　 情報ファイルに指定できる項目

指定できる項目

セクション名

データ抽出時のキャンセル処理に関する設定（ODBC接続でだけ有効）

ODBCで接続されているサーバからデータを抽出中に［キャンセル］ボタンをクリックすると，［キャンセル］ボタンをクリックするまでに処理したデータを出力できます。

Expand

データ抽出に関する設定

サーバからデータを抽出するときに，表結合の状態を調べたり，抽出件数の最大値を設定したりします。

SelectOption

表一覧情報の絞り込みに関する設定

サーバから表一覧情報を取得するときに，表名を条件として情報を絞り込めます。

Filter

メニューの活性／非活性に関する設定

DBPARTNER2の特定のメニューを強制的に非活性にできます。

MenuView

［表設定］ダイアログボックスに表示させる表の表属性に関する設定

指定した表属性を持つ表だけを，［表設定］ダイアログボックスに表示できます。

TableList

［オプション設定］ダイアログボックスに関する設定

［オプション設定］ダイアログボックスに設定する値を，あらかじめ情報ファイルで設定できます。

Options

［接続先設定］ダイアログボックスに関する設定

［接続先設定］ダイアログボックスに設定する値を，あらかじめ情報ファイルで設定できます。

Connect

列選択をした状態での更新に関する設定

列選択をした状態での更新に関するオプションを，あらかじめ情報ファイルで設定できます。

UpdateOption

特定のメッセージ表示に関する設定

メッセージの表示の有無を，あらかじめ情報ファイルで設定できます。

MessageOption

メッセージファイル出力に関する設定

メッセージファイル出力の有無を，あらかじめ情報ファイルで設定できます。

MSGTrace

データベースの格納に関する設定

データベースの格納に関する設定を，あらかじめ情報ファイルで設定できます。

DatabaseSave

［データ表示］ウィンドウに関する設定

［データ表示］ウィンドウを起動時に表示する有無を，あらかじめ情報ファイルで設定できます。

ExecOption

手順ファイルに関する設定

手順ファイル実行時，又は作成時に関する設定を，あらかじめ情報ファイルで設定できます。

CatalogOption

［登録表一覧］に表示する接続先名に関する設定

［見出し選択］ダイアログボックスの［登録表一覧］ウィンドウに表示する接続先名称が設定できます。

DicFilter

(1)　データ抽出時のキャンセル処理に関する設定（ODBC接続でだけ有効）−Expandセクション

ODBCで接続されているサーバからデータを抽出中に［キャンセル］ボタンをクリックすると，［キャンセル］ボタンをクリックするまでに処理したデータを出力できます。

次の斜体文字で示す文字列の2行を，情報ファイルに記述します。

［Expand］

SelectStop＝EFFECTIVE

(2)　データ抽出に関する設定−SelectOptionセクション

サーバからデータを抽出するときに，表結合の状態を調べたり，抽出件数の最大値を設定したりします。各パラメタは手順ファイルの参照・実行時にも有効となります。

次の斜体文字で示す文字列を，情報ファイルに記述します。

[SelectOption]

JoinCheck = {INDEXCHECK | INDEXNOCHECK}

CountLimit = 1〜999999999

MaxDataCnt = 1〜 999999999

CntCheckTime = hh:mm(開始時刻) , hh:mm(終了時刻)

WarningSelectMsg = {YES | NO}

MaxCell = 512 〜 999999999

WarningCell = 512 〜 999999999

(a)　JoinCheck = { INDEXNOCHECK | INDEXCHECK }

表を複数選択して抽出する場合の表結合の状態を調べ，結合条件がない場合は警告メッセージを表示します。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

INDEXNOCHECK

「表A.列A1=表B.列B1」の条件がない場合，メッセージを表示する。

INDEXCHECK

INDEXNOCHECKでのチェックに加え，列A1又は列B1の少なくともどちらかにインデクスがない場合，メッセージを表示する。

（例）

表結合の状態を調べ，結合した表のどちらかにインデクスがない場合，メッセージを表示させる。

[SelectOption]
JoinCheck = INDEXCHECK

(b)　CountLimit = 1〜999999999

［DBPARTNER2］ウィンドウの［件数制限］で設定する値の最大値を指定します。ここで指定した値より大きな値を［件数制限］で設定した場合，抽出処理をエラーにします。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

（例）

［DBPARTNER2］ウィンドウの［件数制限］で設定する値の最大値として500を設定する。

[SelectOption]
CountLimit = 500

(c)　MaxDataCnt = 1〜999999999

［DBPARTNER2］ウィンドウの［件数表示］に関係なく，常に件数を表示し，指定した件数以上の抽出を中止します。値が正しく設定されていない場合はエラーとなり，DBPARTNER2を終了させます。このパラメタを省略すると，抽出件数はチェックされません。また，転送先がデータベースのときや，データ確認時にもチェックされません。

（例）

DBPARTNER2での抽出件数の上限値を10000に設定する。

[SelectOption]
MaxDataCnt = 10000

(d)　CntCheckTime = hh : mm(開始時刻) , hh : mm(終了時刻)

(c)のパラメタMaxDataCntを適用する時間帯を指定します。開始時刻と終了時刻の対で指定します。指定した時間帯の間はMaxDataCntが有効になります。指定した形式が誤っているか，範囲外の時刻が設定されている場合はエラーとなり，DBPARTNER2を終了させます。このパラメタはMaxDataCntパラメタ指定時に有効となります。パラメタの値を省略すると，時刻に関係なくMaxDataCntが有効となります。

時刻の形式　hh : mm（hh：00〜23，mm：00〜59）

（例）

MaxDataCntが適用される時間帯を9時から17時とする。

[SelectOption]
MaxDataCnt = 10000
CntCheckTime = 09:00 , 17:00

(e)　WarningSelectMsg = { YES | NO }

(c)のパラメタMaxDataCntが表示するメッセージを選択します。値が正しく設定されていない場合はエラーとなり，DBPARTNER2を終了させます。このパラメタを省略すると，NOが仮定されます。

YES：抽出処理を続行する／しないを選択する，警告メッセージを表示します。

NO ：抽出処理を中止する警告メッセージを表示します。

（例）

MaxDataCntが表示するメッセージを「抽出処理を続行する／しない」の警告メッセージとする。

[SelectOption]
MaxDataCnt = 10000
WarningSelectMsg = YES

(f)　MaxCell = 512〜999999999

抽出するデータの総セル数の上限値を設定します。［件数表示］のチェックに関係なく件数を確認して総セル数が上限値を超えるときはエラーメッセージを表示します。総セル数を求める式を次に示します。

総セル数 = 抽出件数×抽出列数

値が正しく設定されていない場合はエラーとなってDBPARTNER2を終了させます。このデータを省略，又は転送先がデータ確認のときはセル数をチェックしません。WarningCellも指定するときは，WarningCellの値より大きい値を指定してください。

（例）

抽出セル数を15000に設定する。

[SelectOption]
MaxCell = 15000

(g)　WarningCell = 512 〜 999999999

抽出するデータの総セル数の上限値を設定します。［件数表示］のチェックに関係なく件数を確認して総セル数が上限値を超えるときは警告メッセージを表示します。総セル数を求める式を次に示します。

総セル数 = 抽出件数×抽出列数

値が正しく設定されていない場合はエラーとなってDBPARTNER2を終了させます。このデータを省略，又は転送先がデータ確認のときはセル数をチェックしません。

（例）

抽出セル数として10000を指定する。

[SelectOption]
MaxCell = 15000
WarningCell = 10000

(3)　表一覧情報の絞り込みに関する設定−Filterセクション

サーバから表一覧情報を取得するときに，表名を条件として情報を絞り込めます。サーバ側に定義されている表数が多いため，目的の表の情報を取得できない場合などに使います。

次の斜体文字で示す文字列を，情報ファイルに記述します。

［Filter］

TBLName1＝条件式1

TBLName2＝条件式2

：

TBLName100＝条件式3

Filterの指定は，TBLNameX（Xは1〜100までの整数）に絞り込み条件式を指定します。絞り込み条件式の記述方法については，「4.2.3　表選択時の絞り込み」を参照してください。

複数の条件を指定した場合は，どれかの条件に一致した表名の情報を得ることができます。

絞り込み条件式を指定するTBLNameの番号からは1から始まる連番を使ってください。番号の重複や欠落がある場合は正常に動作しません。

（例）二つの絞り込み条件式を指定する場合

条件は，ユーザ「ABC」が作成した表で「一覧」という文字で終わる表名の情報，及び，ユーザ「XYZ」が作成したすべての表の情報です。

［Filter］
TBLName1＝ABC.*一覧
TBLName2＝XYZ.*

(4)　メニューの活性／非活性に関する設定−MenuViewセクション

DBPARTNER2の特定のメニューを強制的に非活性にできます。予約／保存機能は使いたいが，表の定義機能はユーザに公開したくないときに使います。

非活性にできるメニューを次に示します。

［表定義・更新(C)...］

［表削除(D)...］

［表名・列名変更(A)...］

この機能は，情報ファイルのMenuViewで指定します。

次の斜体文字で示す文字列を，情報ファイルに記述します。

［MenuView］

Create_Table＝Hide又はNormal

Delete_Table＝Hide又はNormal

Alter_Table＝Hide又はNormal

MenuViewの指定は，メニューごとにHide（非活性）／Normal（インストール時の設定）を指定します。各メニューの対応を次に示します。

Create_Table−−−［表定義・更新(C)...］

Delete_Table−−−［表削除(D)...］

Alter_Table−−−［表名・列名変更(A)...］

（例）

［表削除(D)...］だけを非活性にする場合

［MenuView］
Create_Table＝Normal
Delete_Table＝Hide
Alter_Table＝Normal

(5)　［表設定］ダイアログボックスに表示させる表の表属性に関する設定−TableListセクション

指定した表属性を持つ表だけを，［表設定］ダイアログボックスに表示できます。

次に示す斜体文字の文字列を情報ファイルに記述します。

[TableList]

TableType = "'表属性'[,'表属性',…]"

FilterHistoryNum = 5〜30

TableTypeの指定は，［表設定］ダイアログボックスに表示させる表の表属性を指定します。256バイトまでの文字列を指定してください。257バイト以降の文字列は無視されます。

表属性には，「TABLE」，「VIEW」，「SYSTEM TABLE」，「GLOBAL TEMPORARY」，「LOCAL TEMPORARY」，「ALIAS」，「SYNONYM」などがあります。値が正しく設定されていない場合は，データベースアクセス時にエラーメッセージを表示します。

FilterHistoryNumの指定は，［表の絞り込み条件設定画面］で表示する履歴の数を指定してください。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

（例）

'TABLE'，'VIEW'，'SYSTEM TABLE' の表属性のどれかを持ち，［表の絞り込み条件設定画面］で表示する履歴の数を20と指定した表だけを［表設定］ダイアログボックスに表示させる場合

[TableList]
TableType = "'TABLE','VIEW','SYSTEM TABLE'"
FilterHistoryNum = 20

(6)　［オプション設定］ダイアログボックスに関する設定−Optionsセクション

［オプション設定］ダイアログボックスに設定する値を，あらかじめ情報ファイルで設定できます。情報ファイルで設定した値は，［オプション設定］ダイアログボックスで表示が非活性になり，操作できなくなります。このため，DBPARTNER2を使った業務を実行しているグループ内で同じ情報ファイルを使えば，動作環境を統一できます。

次に示す斜体文字の文字列を情報ファイルに記述します。

[Options]

Wait = 0〜999

WaitLimit = 1〜999

Value = {YES/NO}

ValueOrder = {SORT/NOSORT}

TableList = {NOSAVE/SAVE}

TableOrder ={SORT/NOSORT}

Dictionary ={PC/PC+DB}

DictUsed = {YES/NO}

DataChk = {YES/NO}

DataCnt = 1〜32767

VieApp1 = 完全ファイル名

TrnsFile = {完全ファイル名/NO}

TrnsDef = {START/EVERY}

DicDirectory = 絶対パス

ViewMode = {Normal/Detail}

TrmOverWrite = {YES/NO}

FuncHead = {YES/NO}

Display = {YES/NO}

(a)　Wait = 0〜999

［抽出時間の上限］チェックと［抽出時間］テキストに設定する値（分）を指定します。値を指定すると，二つのコントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

0：［抽出時間の上限］のチェックを解除します。

1〜999：［抽出時間の上限］をチェックし，指定した値が［抽出時間］テキストに設定されます。

（例）

抽出時間の上限を60分に設定します。

[Options]
Wait = 60

(b)　WaitLimit = 1〜999

［抽出時間の上限］チェックで使う［抽出時間］テキストで設定できる最大値を分で指定します。ここで指定した値より大きな値が設定された場合は，［オプション設定］ダイアログボックスの［OK］ボタンを押した時にメッセージを表示します。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

（例）

抽出時間で指定できる最大値を60分に設定します。

[Options]
WaitLimit = 60

(c)　Value = { YES | NO }

［手順実行時の実行値入力画面表示］チェックボックスの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

NO：［手順実行時の実行値入力画面表示］をチェックします。

YES：［手順実行時の実行値入力画面表示］のチェックを解除します。

（例）

［手順実行時の実行値入力画面表示］のチェックを解除します。

[Options]
Value = YES

(d)　ValueOrder = {SORT | NOSORT}

［可変記号のソート］チェックボックスの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

SORT：［可変記号のソート］をチェックします。

NOSORT：［可変記号のソート］のチェックを解除します。

（例）

［可変記号のソート］をチェックします。

[Options]
VALUEORDER = SORT

(e)　TableList = { NOSAVE | SAVE }

［表一覧情報を毎回サーバから取得して表示］チェックボックスの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

NOSAVE：［表一覧情報を毎回サーバから取得して表示］をチェックします。

SAVE：［表一覧情報を毎回サーバから取得して表示］のチェックを解除します。

（例）

［表一覧情報を毎回サーバから取得して表示］をチェックします。

[Options]
TableList = NOSAVE

(f)　TableOrder ={ SORT | NOSORT }

［表一覧情報をソートして表示］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

SORT：［表一覧情報をソートして表示］をチェックします。

NOSORT：［表一覧情報をソートして表示］のチェックを解除します。

（例）

［表一覧情報をソートして表示］をチェックします。

[Options]
TableOrder = SORT

(g)　Dictionary ={ PC | PC+DB }

［用語辞書］を使用する場合の［辞書種別］の値を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

PC：「DBPARTNERの情報を使用する」を選択した状態にします。

PC+DB：「DBPARTNERとDBの情報を使用する」を選択した状態にします。

（例）

「DBPARTNERとDBの情報を使用する」を選択した状態にします。

[Options]
Dictionary =PC+DB

(h)　DictUsed = { YES | NO }

［用語辞書］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

YES：［用語辞書］をチェックします。

NO：［用語辞書］のチェックを解除します。

（例）

［用語辞書］をチェックします。

[Options]
DictUsed = YES

(i)　DataChk = { YES | NO }

［データ確認］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

YES：［データ確認］をチェックします。

NO：［データ確認］のチェックを解除します。

（例）

［データ確認］をチェックします。

[Options]
DataChk = YES

(j)　DataCnt = 1〜32767

［確認件数］テキストの値（件数）を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

（例）

データを確認する件数を500に設定します。

[Options]
DataCnt = 500

(k)　VieApp1 = 完全ファイル名

［確認プログラム］のファイル名を指定します。256バイトまでの文字列を指定してください。257バイト以降の文字列は無視されます。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，確認プログラム起動時にエラーメッセージが表示されます。

（例）

データを確認するプログラムとして，Notepad.exeを設定します。

[Options]
VieApp1 = C:¥WINDOWS¥NOTEPAD.EXE

(l)　TrnsFile = { 完全ファイル名 | NO }

［転送先］テキストのファイル名を指定します。256バイトまでの文字列を指定してください。257バイト以降の文字列は無視されます。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，データ格納時にエラーメッセージが表示されます。［転送先］テキストのファイル名を空白にしたい場合は，NOを指定してください。

（例）

データの抽出結果を，Data.txtという名称のファイルに転送します。

[Options]
TrnsFile = C:¥DATA.TXT

(m)　TrnsDef = { START | EVERY }

［転送先］の状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

START：［起動時のみ有効］を選択します。

EVERY：［毎回有効］を選択します。

（例）

転送先がファイルの場合，起動時に設定された転送先ファイル名を有効にします。

[Options]
TrnsDef = START

(n)　DicDirectory = 絶対パス

［辞書ディレクトリ］テキストのパスを指定します。256バイトまでの文字列を指定してください。257バイト以降の文字列は読み捨てられます。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，辞書ファイルのアクセスエラーが表示されます。

（例）

使用する用語辞書のディレクトリをc:¥dicに設定します。

[Options]
DicDirectory = c:¥dic

(o)　ViewMode = { Normal | Detail }

［手順の一覧にファイル情報を表示］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

Normal：［手順の一覧にファイル情報を表示］のチェックを解除します。

Detail：［手順の一覧にファイル情報を表示］をチェックします。

（例）

［手順の一覧にファイル情報を表示］のチェックを解除します。

[Options]
ViewMode = Normal

(p)　TrmOverWrite = { YES | NO }

［転送先ファイルの上書きメッセージを表示］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

YES：［転送先ファイルの上書きメッセージを表示］をチェックします。

NO ：［転送先ファイルの上書きメッセージを表示］のチェックを解除します。

（例）

［転送先ファイルの上書きメッセージを表示］をチェックします。

[Options]
TrmOverWrite = YES

(q)　FuncHead = { YES | NO }

［集合関数を指定した項目名の見出し表示］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合はエラーメッセージを表示し，DBPARTNER2を終了させます。

YES：［集合関数を指定した項目名の見出し表示］をチェックします。

NO ：［集合関数を指定した項目名の見出し表示］のチェックを解除します。

（例）

［集合関数を指定した項目名の見出し表示］をチェックします。

[Options]
FuncHead = YES

(r)　Display = {YES | NO}

［インデクス情報を表示］チェックの状態を指定します。値を指定すると，コントロールが非活性状態となり，変更できなくなります。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

YES：［インデクス情報を表示］をチェックします。

NO ：［インデクス情報を表示］のチェックを解除します。

（例）

［集合関数を指定した項目名の見出し表示］をチェックします。

[Options]
Display = YES

(7)　［接続先設定］ダイアログボックスに関する設定−Connectセクション

［接続先設定］ダイアログボックスに設定する値を，あらかじめ情報ファイルで設定できます。

次に示す斜体文字の文字列を情報ファイルに記述します。

[Connect]

ConnectID = Upper

［接続先設定］ダイアログボックスで入力した文字列を大文字に変換します。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

（例）

［接続先］ダイアログボックスで入力した文字列を大文字に変換する場合

[Connect]
ConnectID = Upper

(8)　列選択をした状態での更新に関する設定−UpdateOptionセクション

列選択をした状態で更新できるようにします。

また，抽出列を削除してデータ変更，削除する場合，更新する行を決める条件に，検索条件も使用する場合に指定します。

次に示す斜体文字の文字列を情報ファイルに記述します。

［UpdateOption］

ColumnMove = ｛YES | NO｝

Condition = ｛YES | NO｝

(a)　ColumnMove = ｛YES | NO｝

列選択をした状態で更新できるようにします。

YES：列選択をした状態で更新できるようにします。

NO ：列選択をした状態では更新できません。

（例）

列選択をした状態で更新できるようにします。

[UpdateOption]
ColumnMove = YES

(b)　Condition = ｛YES | NO｝

抽出列を削除してデータ変更，削除をする場合，更新する行を決める条件に，検索条件も使用する場合に指定します。ColumnMove = YESを設定した場合に有効となります。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

YES：更新する条件を決める条件に，検索条件も指定します。

NO ：更新する条件を決める条件に，検索条件は指定しません。

（例）

更新をする行を決める条件に検索条件も指定します。

Condition = YES

(9)　特定のメッセージ表示に関する設定−MessageOption

指定されたメッセージを表示しないようにします。

次の斜体文字で示す文字列を，情報ファイルに記述します。

[MessageOption]

HideMsg ＝ {ID1[,ID2,...,IDn]}

指定できるメッセージIDは0711，1057，2029，3550です。

値が正しく設定されていない場合は，エラーメッセージを表示してDBPARTNER2を終了させます。

（例）

メッセージ1057，2029を表示しないようにします。

[MessageOption]
HideMsg = 1057,2029

(10)　メッセージのファイル出力に関する設定−MSGTrace

メッセージのファイル出力の有無，及びファイル出力に関する項目を設定します。

次の斜体文字で示す文字列を，情報ファイルに記述します。

[MSGTrace]

Trace = {0 | 1}

Directory = 絶対パス

MaxFileSize = 1〜1024

(a)　Trace = {0 | 1}

メッセージをファイルに出力するかどうかを指定します。値が正しく設定されていない場合は，0が仮定されます。

0：メッセージをファイルに出力しません。

1：メッセージをファイルに出力します。

（例）

メッセージをファイルに出力します。

[MSGTrace]
Trace = 1

(b)　Directory = 絶対パス

メッセージを出力するファイルのパス名を，絶対パスで指定します。パス名は，247文字以内で指定してください。247文字を超える部分は切り捨てられます。値が正しく設定されていない場合は，パスとしてDBPARTNER2インストールフォルダ¥GUI¥TEMPが仮定されます。

（例）

メッセージをC:¥Windows¥TEMPファイルに出力します。

[MSGTrace]
Directory = C:¥WINDOWS¥TEMP

(c)　MaxFileSize = 1〜1024

メッセージファイル一つ当たりの最大容量（キロバイト）を指定します。値が正しく設定されていない場合は，5キロバイトが仮定されます。ファイル名はDBGMSGT.LOGで固定です。メッセージがMaxFileSizeに指定した値を超えると，ファイル名DBGMSGT.LOGがDBGMSGT.BAKに変更された後，新しくDBGMSGT.LOGが作成され，先頭からデータが書き込まれます。

（例）

メッセージを出力するファイルの最大値を10キロバイトとします。

[MSGTrace]
MaxFileSize = 10

(11)　データベースの格納に関する設定−DatabaseSave

抽出結果をデータベースに格納するとき，表が既に存在する場合，既存の表を削除するかどうかを指定します。

次の斜体文字で示す文字列を，情報ファイルで記述します。

[DatabaseSave]

DropTable = {0 | 1 | 2}

このパラメタを省略すると，0が仮定されます。

0：表が存在するかどうかは確認しません。表が既に存在する場合はデータベースでエラーになります。

1：表が既に存在する場合，確認メッセージを表示した後，表を削除します。

2：表が既に存在する場合，確認メッセージを表示した後，表を削除しますが，格納領域名が異なる場合は，エラーとなります。

（例）

表が既に存在する場合，確認メッセージを表示して，表を削除します。

[DatabaseSave]
DropTable = 1

(12)　［データ表示］ウィンドウに関する設定−ExecOption

［データ表示］ウィンドウをDBPARTNER2起動時にローディングする場合に設定します。値が正しく設定されていない場合は，エラーメッセージを表示し，DBPARTNER2を終了させます。

次の斜体文字で示す文字列を，情報ファイルに記述します。

[ExecOption]

UpLoad = {YES | NO}

YES：［データ表示］ウィンドウをDBPARTNER2起動時にローディングします。

NO ：［データ表示］ウィンドウをDBPARTNER2起動時にローディングしません。

（例）

［データ表示］ウィンドウをDBPARTNER2起動時にローディングしておく。

[ExecOption]
Updload = YES

(13)　手順ファイルのオプションに関する設定−CatalogOption

手順ファイルの実行時，又は作成時に関するオプションを設定します。

手順ファイルの実行時に次の斜体文字で示す文字列を，情報ファイルに記述します。

[CatalogOption]

ViewMode = {0 | 1}

Convert0204 = {YES | NO}

(a)　ViewMode = {0 | 1}

Excelからの手順ファイル実行時に［DBPARTNER2］ウィンドウを非表示にする場合に指定します。値が正しく設定されていない場合には，エラーメッセージを表示し，DBPARTNER2を終了させます。

0：Excelからの手順ファイル実行時，［DBPARTNER2］ウィンドウを表示します。

1：Excelからの手順ファイル実行時，［DBPARTNER2］ウィンドウを非表示にします。

（例）

Excelからの手順ファイル実行時に，［DBPARTNER2］ウィンドウを非表示にします。

[CatalogOption]
ViewMode = 1

(b)　Convert0204 = {YES | NO}

DBPARTNER/Client32 02-04で利用できる形式の手順ファイルを作成するときに指定します。値を追加すると［手順ファイルの登録］ダイアログボックスの［ファイルの種類］に「Client32形式(*.dpc)」が追加されます。このとき，DBPARTNER2のオプションで［手順の一覧にファイル情報を表示］にチェックしていると，設定が無効になります。

参照：「7.1.7　手順ファイルのファイル情報の表示」

値が正しく設定されていない場合は，エラーメッセージを表示しDBPARTNER2を終了させます。

YES：［手順ファイル］ダイアログボックスの［ファイルの種類］に「Client32形式(*.dpc)」を追加する。

NO：［手順ファイル］ダイアログボックスの［ファイルの種類］に「Client32形式(*.dpc)」を追加しない。

（例）

［ファイルの種類］に「Client32形式(*.dpc)」を追加します。

Convert0204 = YES

(14)　［登録表一覧］に表示する接続先名に関する設定− DicFilter

［見出し選択］ダイアログボックスの［登録表一覧］に表示する接続先名称を指定します。

次の斜体文字で示す文字列を，情報ファイルに記述します。

HostName = xxx

xxx：接続先名

値を指定すると，［登録表一覧］には設定した接続先名だけが表示されます。

（例）

［見出し選択］ダイアログボックスに接続先名として「osaka」を表示させます。

HostName = osaka

2.6　DBPARTNER ODBC 3.0 Driverのセットアップ

インストールが完了したら，データソースを設定します。

データソースは，［DBPARTNER ODBC 3.0 Driverセットアップ］ダイアログボックスで設定します。

データソースを設定する操作を次の図に示します。

図2‒3　データソースを設定する操作

［スタートメニュー］−［Windows管理ツール］から，［データソース（ODBC）］を選択します。

［ODBCデータソース アドミニストレータ］ダイアログボックスの［追加(D)...］ボタン（新規作成の場合），又は［構成(C)...］ボタンをクリックします。

これらのボタンは，［ユーザDSN］タブ，又は［システムDSN］タブにあります。

新規作成の場合はデータソースの新規作成ダイアログボックスでDBPARTNER ODBC 3.0 Driverを選択し，［完了］ボタンを押すと，［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックスが表示されます。

［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックスでは，次のオプションが設定できます。

データソースに関する情報

接続するデータベースに関する情報

データソースのオプション情報

設定後，［適用(A)］，又は［OK］ボタンをクリックします。

［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックスの詳細を次に示します。

2.6.1　［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックス

［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックスで設定する項目の詳細について説明します。

(1)　［一般］タブ

［一般］タブでは，データソースの接続に関する情報を指定します。

［データソース名(S)］　〜＜1〜32けたの文字列＞

ODBCアプリケーションからの接続要求時に使用するデータソースの名前を入力します。データソース名は省略できません。

［説明(D)］

必要に応じて，データソースの機能や内容が分かるように簡単な説明を入力します。半角文字で256文字まで入力できます。

［ホスト名またはIPアドレス(I)］　〜＜1〜32けたの文字列＞

接続するサーバのホスト名，又はIPアドレスを指定します。省略はできません。

［サービス名またはポート番号(P)］

接続するサーバのサービス名又はポート番号を指定します。省略した場合は，40179を仮定します。

［テスト接続(T)］

ドライバのユーザID・パスワードの入力のダイアログボックスが表示され，指定されている設定内容で接続できるかどうかをテストします。

［OK］

設定内容を有効にして，ダイアログボックスを閉じます。

［キャンセル］

設定内容を無効にして，ダイアログボックスを閉じます。

［適用(A)］

設定内容を有効にします。

(2)　［データベース］タブ

［データベース］タブでは，接続するデータベースに関する情報を指定します。

［接続データベース(D)］　〜＜1〜32けたの文字列＞

接続するDBMSをコンボボックスのメニューの中から選択します。表示されるメニューは次のとおりです。

HiRDB：HiRDBを示します。

Oracle：ORACLEを示します。

XDM/RD：XDM/RD E2を示します。

XDM/SD：XDM/SD E2を示します。

［データベースホスト名(O)］

接続データベースがHiRDBの場合，HiRDBのホスト名(PDHOST)を指定します。HiRDB以外の場合は不活性になります。

［データベース識別子(K)］　〜＜文字列＞

データベースを識別するための情報を入力します。DBMSごとの指定内容を次の表に示します。

表2‒6　各データベースのデータベース識別子として入力する内容

接続データベース

データベース識別子

HiRDB

HiRDBのポート番号(PDNAMEPORT)※1

ORACLE

ORACLEのリスナー名※2

XDM/RD E2

DBSで指定されているデータベース識別子

XDM/SD E2

DBSで指定されているデータベース識別子

注※1

データベースが一つでPCサーバにHiRDBのポート番号が設定してあるときは指定しなくても接続できます。省略すると，PDNAMEPORTの値が仮定されます。

注※2

接続文字列を指定します。データベースが一つの場合は省略できます。省略すると，ORACLE_SIDの値が仮定されます。

(3)　［オプション］タブ

［オプション］タブでは，データソースのオプションを設定します。

［送信バッファサイズ(S)］　〜＜64〜16000キロバイト＞

サーバとの通信での送受信領域のサイズをキロバイト単位で指定します。デフォルトは64キロバイトです。

［受信バッファサイズ(R)］　〜＜1〜16000キロバイト＞

サーバとの通信での受信領域のサイズをキロバイト単位で指定します。デフォルトは64キロバイトです。

［応答監視時間(T)］　〜＜0〜9999秒＞

サーバとの通信での応答監視時間を秒単位で指定します。サーバとの通信時，この指定値を超えても応答がない場合は処理を打ち切ります。応答監視をしない場合は，0を指定します。デフォルトは60秒です。

［ユーザ外字］

DBPARTNER ODBC 3.0 Driverで作成した外字と，DBMS上で作成した外字を対応付けるかどうかを指定します。

外字を対応付ける場合，［使用する(U)］をチェックし，［選択(E)...］ボタンでユーザ外字変換ファイルを指定します。このグループボックスを設定すると，DBPARTNER ODBC 3.0 Driverはユーザ外字変換ファイルの内容に従って，外字コードを変換します。

詳しくは，「付録H　ユーザ外字変換ファイル」を参照してください。

［EUC-SJIS変換を行なう(C)］

DABrokerの動作文字コードがEUCで，EUC-SJIS変換する場合にチェックします。ODBCアプリケーションでEUCコード処理をする場合は，チェックを外してください。チェックを外すと，すべてのEUC-SJIS変換ができません。

［Oracle接続でSQLDescribeParamを使用(D)］

接続データベースがORACLEの場合，通常SQLDescribeParamは使用できませんが，このチェックを指定するとすべてのパラメタのSQLデータ型がSQL_VARCHAR型で出力されます。このオプションはMicrosoftリモートデータオブジェクト（RDO）を使う場合に指定します。デフォルトはチェックなしです。

［検索データの余分な空白文字を削除(P)］

検索データの後ろの余分な空白文字を削除するかどうかを指定します。デフォルトはチェックなしです。

送受信バッファサイズは，取り扱うデータが長大データの場合以外，変更しないことをお勧めします。

DBPARTNER ODBC 3.0 Driverでは，指定されたサイズの送受信領域を使用するSQLステートメントごとに送信用，受信用それぞれ一つずつ確保します（1ステートメントごとに指定サイズのメモリを使用）。そのため，使用するマシンの性能を考慮し，適正な値を指定する必要があります。

DBPARTNER ODBC 3.0 Driverでは，指定されたサイズの受信領域に格納できる行数分の結果データを，サーバから一度に受け取り処理します。そのため受信バッファサイズを大きくすると一度に取得できるデータ数は多くなり，通信の発生頻度は減少します。しかし，受信バッファサイズの指定が大き過ぎると，メモリを圧迫するおそれがあります。また，1回のデータ通信量の増大によって，フェッチ性能の劣化を招くおそれもあります。したがって，この項目を指定する場合は，上限1024キロバイト（1メガバイト）程度までに抑えて，使用するマシン性能などを考慮し，適正な値に設定する必要があります。受信バッファサイズ指定の目安を次に示します。

2.7　インストール後のデータベース接続の設定

ODBC接続の場合の，DBPARTNER2とHiRDB，ORACLE，HADBとの接続での指定値について説明します。

2.7.1　HiRDB（DBPARTNER ODBC 3.0 Driverを使用）の場合のデータベース接続

DBPARTNER ODBC 3.0 Driverを使用して，HiRDBと接続する場合の指定値の関係を次の図に示します。

図2‒4　DBPARTNER2 Client，ODBCドライバの指定値の関係（HiRDBの場合）

2.7.2　ORACLE（DBPARTNER ODBC 3.0 Driverを使用）の場合のデータベース接続

DBPARTNER ODBC 3.0 Driverを使用して，ORACLEと接続する場合の指定値の関係を次の図に示します。

図2‒5　DBPARTNER2 Client，ODBCドライバの指定値の関係（ORACLEの場合）

2.7.3　HiRDBの場合のデータベース接続

HiRDBと接続する場合の指定値の関係を次の図に示します。

図2‒6　DBPARTNER2 Client，ODBCドライバの指定値の関係（HiRDBの場合）

注※

接続先定義ファイルにユーザIDとパスワードを設定すると，接続先設定画面は表示されません。

2.7.4　ORACLEの場合のデータベース接続

ORACLEと接続する場合の指定値の関係を次の図に示します。

図2‒7　DBPARTNER2 Client，ODBCドライバの指定値の関係（ORACLEの場合）

注※

接続先定義ファイルにユーザIDとパスワードを設定すると，接続先設定画面は表示されません。

2.7.5　HADBの場合のデータベース接続

HADBと接続する場合の指定値の関係を次の図に示します。

図2‒8　DBPARTNER2 Client，ODBCドライバの指定値の関係（HADBの場合）

注※

接続先定義ファイルにユーザIDとパスワードを設定すると，接続先設定画面は表示されません。

第3編　GUIの操作

3　DBPARTNER2の操作の概要

この章では，DBPARTNER2を起動してから終了するまでの操作の概要について説明します。

3.1　起動から終了までの操作

DBPARTNER2の操作について説明します。操作の概要を次の図に示します。

図3‒1　DBPARTNER2の操作の概要

注※

必要に応じてオプションを設定します。

DBPARTNER2を起動してからデータの抽出/データの更新/表定義などの操作をした後，DBPARTNER2を終了するまでの基本的な操作について説明します。

DBPARTNER2を起動します。

Windowsのスタートメニューから，DBPARTNER2を起動します。

参照：「3.2　DBPARTNER2の起動」

サーバに接続します（［接続］メニュー）。

接続先のサーバと利用者(ユーザID，パスワード)を設定してサーバと接続します。

参照：「3.3　接続先のサーバと利用者の設定（［接続］メニュー）」

データの操作をします（［抽出］，［定義］メニュー）。

各操作は［DBPARTNER2］ウィンドウから始めます。

DBPARTNER2の操作には大きく分けて次の三つがあります。

データベースにアクセスしてデータベースのデータを抽出する

抽出したデータを編集してデータベースを更新する

データベースへ表を定義する

参照：「3.4　データの操作」

DBPARTNER2を終了します。

［ファイル］メニューの［終了］を選んでDBPARTNER2を終了します。

参照：「3.5　DBPARTNER2の終了」

このほかに必要に応じて，次の個所を参照してください。

各操作での設定内容を手順ファイルに登録してDBPARTNER2の操作を手続き化する

参照：「6.　定型業務の登録と実行（［手順］メニュー）」

データの抽出時間に上限を設定などオプションを設定する

参照：「7.　オプション（［ツール］メニュー）」

データの抽出時に列や条件を設定する

参照：「8.　列と条件を設定するときの規則」

接続先定義ファイルのパラメタを指定して操作をカスタマイズする

参照：「2.4.3　パラメタを指定するときの規則」

ダイアログボックスに表示する表一覧や列一覧の最大表示数を変更する

データを抽出する際に列名もデータと合わせて抽出する

データを更新する処理をDBPARTNER2側で制御する

補足

更新処理をキャンセル，又はDBPARTNER2でエラーが発生したときに，その時点までに終了した更新処理を無効にします。さらに，メッセージを出力して処理の有効/無効を選択できます。

3.2　DBPARTNER2の起動

DBPARTNER2の起動には，次に示す二つの方法があります。

DBPARTNER2のインタフェースを使って起動する方法

抽出したデータをファイル（抽出データ格納ファイル）に格納しておく場合は，この方法で起動することをお勧めします。

ほかのアプリケーションから起動する方法

抽出したデータを表計算ソフトで操作する場合は，この方法で起動することをお勧めします。

3.2.1　DBPARTNER2を起動する方法

DBPARTNER2を起動する方法について説明します。

(1)　メニューから起動する方法

DBPARTNER2を起動する方法について説明します。データの転送先を「ファイル」とする場合は，この方法で起動することをお勧めします。

スタートメニューの［DBPARTNER2］−［DBPARTNER2］メニューを選びます。

［DBPARTNER2］ウィンドウが表示されます。

［DBPARTNER2］ウィンドウ中のボタンは，次に示すメニューコマンドと同じ機能があります。ボタンを使うと，メニューをプルダウンする必要がないので便利です。

[図データ]:［手順(B)］−［登録(S)...］メニュー

[図データ]:［手順(B)］−［実行(E)...］メニュー

[図データ]:［手順(B)］−［参照(R)...］メニュー

[図データ]:［接続(A)］−［接続(C)...］メニュー

[図データ]:［接続(A)］−［切断(D)］メニュー

[図データ]:［抽出(S)］−［確認(P)...］メニュー

[図データ]:［抽出(S)］−［実行(E)］メニュー

[図データ]:［抽出(S)］−［表名(T)...］メニュー

[図データ]:［抽出(S)］−［転送先(O)...］メニュー

[図データ]:［抽出(S)］−［列設定(U)...］メニュー

[図データ]:［抽出(S)］−［条件設定(C)...］メニュー

[図データ]:［SQL(Q)］−［SQL入力実行(S)...］メニュー

[図データ]:［SQL(Q)］−［ファイルから実行(F)...］メニュー

[図データ]:［定義(D)］−［表定義・更新(C)...］メニュー

[図データ]:［定義(D)］−［表削除(D)...］メニュー

[図データ]:［定義(D)］−［表名・列名変更(A)...］メニュー

[図データ]:［ツール(X)］−［見出し編集(L)...］メニュー

(2)　メニューを使わないで起動する方法

Windowsの［エクスプローラ］で「Dbpart2.exe」を開始するとDBPARTNER2を起動できます。

(3)　手順ファイルを使って起動する方法

手順ファイルを使ってDBPARTNER2を開始するときは，Windowsの［スタート］−［ファイル名を指定して実行(R)...］を使います。

例えば，Shiire.dpcという手順ファイルで開始するときは，［ファイル名を指定して実行］ダイアログボックスに，パスの入力が格納先から必要です。例えば，C:¥Program Files¥HITACHI¥DBP2CL¥GUIにあるshiire.dpcという手順ファイルを実行したい場合には，コマンドラインに「Dbpart2.exe C:¥Program Files¥HITACHI¥DBP2CL¥GUI¥shiire.dpc」と設定してください。手順ファイルを使って［ファイル名を指定して実行］から開始したときは，処理終了後にDBPARTNER2も終了します。

3.2.2　ほかのアプリケーションから起動する方法

DBPARTNER2をほかのアプリケーションから起動する方法について説明します。Excelと連携する場合は，DBPARTNER2，Excelのどちらから起動しても連携できます。

(1)　Excel連携

Excel連携を使用する場合は，DBPARTNER2のインストール時に作成される「DBPARTNER連携マクロ」を，Excelのアドインマネージャに登録する必要があります。

「DBPARTNER連携マクロ」は次のとおりです。

表3‒1　DBPARTNER連携マクロ

マクロの種類

説明

dbp2exl(64)2019.xlam

Excel連携

アドインマネージャへの登録は次の手順で行います。

［ファイル］タブの［オプション］を選択します。

［Excelのオプション］ダイアログボックスが表示されます。

左のペインで［アドイン］を選択します。

アドインの管理画面が表示されます。

アドインの管理画面の管理コンボボックスで［Excelアドイン］を選択し，［設定...］ボタンをクリックします。

［アドイン］ダイアログボックスが表示されます。

［参照...］ボタンをクリックします。

ファイルを選択するダイアログボックスが表示されるので，DBPARTNER2が存在するフォルダから表3-1のマクロを選択します。

ファイルを選択するダイアログボックスで［OK］ボタンをクリックします。

有効なアドインの一覧に「DBPARTNER2 Link (64)」が追加されます。

「DBPARTNER2 Link (64)」のチェックをONにします。

［アドイン］ダイアログボックスで［OK］ボタンをクリックします。

ExcelとDBPARTNER2が連携するためのマクロがExcelに登録されます。

ExcelのリボンにDBPARTNER2のメニューが表示されます。［DBPARTNER2］から［抽出］や［手順ファイル利用］を選ぶと，DBPARTNER2が起動できます。

また，［DBPARTNER2］ウィンドウから，Excelを起動することもできます。

3.3　接続先のサーバと利用者の設定（［接続］メニュー）

利用するデータベースが格納されているサーバと利用者（ユーザIDとパスワード）を設定します。これらは，データの抽出より前に設定してください。

接続先のサーバと利用者を設定するときに，画面上に淡色で表示されている項目があります。この項目には入力できません。

3.3.1　接続先のサーバの設定

［接続先設定］ダイアログボックス中の接続先の一覧から，利用するサーバを選択します。接続先の一覧には，接続先定義ファイルのHOSTNAMEに指定したサーバ名称が表示されます。接続先定義ファイルについては，「2.4.3　パラメタを指定するときの規則」を参照してください。

一度設定した接続先のサーバ名は，次に変更するまで引き継がれます。このため，1回前の操作時と同じサーバに接続する場合は，接続先のサーバを設定する必要はありません。また，接続先定義ファイルにサーバ名を一つしか登録していない場合も，設定する必要はありません。この場合，登録済みのサーバ名が［接続先設定］ダイアログボックスに淡色表示されて，選択できなくなります。

入力例を次に示します。

［接続(A)］−［接続(C)...］メニューを選びます。

［接続先設定］ダイアログボックスが表示されます。接続先を接続先の一覧から選択してください。

接続先の一覧は［▼］をクリックして表示させます。

一覧には，接続先定義ファイルに登録済みの接続先の名称が表示されます。

接続先を設定したら，次に利用者を設定します。

3.3.2　利用者の設定

［接続先設定］ダイアログボックスで接続先のサーバを設定したら，次にユーザIDとパスワードを設定します。

ODBC接続の場合は，各データベースシステムで定義されたユーザIDとパスワードです。

ユーザIDとパスワードは，接続先定義ファイルの定義内容によって設定するかどうかが決まります。［接続先設定］ダイアログボックスと接続先定義ファイルの関係を次の表に示します。

表3‒2　［接続先設定］ダイアログボックスと接続先定義ファイルの関係

接続先定義ファイルの内容

ユーザIDとパスワードの入力が必要かどうか

ダイアログボックスの状態

ユーザIDとパスワードの両方を定義している

ユーザIDとパスワードの両方とも入力が不要

ユーザIDとパスワードを入力する領域が淡色表示

ユーザIDを定義している

パスワードの入力が必要

ユーザIDを入力する領域が淡色表示

パスワードを定義している

ユーザIDの入力が必要

パスワードを入力する領域が淡色表示

接続先のサーバを設定した［接続先設定］ダイアログボックスに，ユーザIDとパスワードをキーボードから入力します。

パスワードは画面上に文字数分の「*」（アスタリスク）で表示されます。

［OK］ボタンをクリックします。

サーバと接続されます。

3.3.3　DBPARTNER2とサーバとの接続のタイミング

DBPARTNER2とサーバとの接続のタイミングは，接続先定義ファイルの指定内容によって決まります。詳細は，「2.4.3　パラメタを指定するときの規則」を参照してください。

ここでは，初めてサーバと接続するタイミングについてだけ説明します。次のどちらかの時点でサーバを起動しておいてください。DBPARTNER2がサーバにアクセスするときには［サーバアクセス］ダイアログボックスが表示されます。

ユーザIDとパスワードの少なくともどちらか一方の入力が必要な場合

［接続先設定］ダイアログボックスでユーザIDとパスワードを入力した後［OK］ボタンをクリックして，DBPARTNER2がサーバとの接続を確認するとき

ユーザIDとパスワードの両方とも入力が不要な場合

［DBPARTNER2］ウィンドウで，［表名(T)...］ボタンをクリックして，DBPARTNER2が表一覧をデータベースから取得するとき

3.4　データの操作

DBPARTNER2を起動してサーバと接続してからの操作について説明します。各操作は［DBPARTNER2］ウィンドウから始めます。

3.4.1　データを操作する手順

DBPARTNER2のクライアントPCから，データベースのデータを操作する手順について説明します。

(1)　データベースのデータを抽出する

まず，データベースにある表から抽出対象とする表を選択します。次に，抽出するデータの転送先（連携，ファイル，データベース，又はクリップボード）を設定します。最後に，選択した表から列を選択したり条件を設定したりして抽出対象とするデータを設定します。設定後，抽出を実行します。

データの抽出方法については，「4.　データの抽出（［抽出］メニュー）」を参照してください。

(2)　抽出したデータを編集してデータベースを更新する

表計算ソフト又は［データ表示］ウィンドウへデータを抽出し，そこで更新用データを作成します。更新用データを作成後に表計算ソフト上からデータベースを更新できます。

データの更新方法については，「5.　データの更新（［抽出］メニュー）」を参照してください。

(3)　データベースへ表を定義する

データベースへ表を定義する場合，表名，列名を定義します。さらに必要に応じて，列に注釈を付けたりインデクスを定義したり表格納領域を定義したりします。また，既存の表の編集や削除もできます。

表の定義方法については，「9.　定義（［定義］メニュー）」を参照してください。

3.4.2　表の例

3〜8章の例題で使う表を次に示します。

(1)　表名の一覧

表見出し

所有者

仕入れ

USER01，USER02

在庫

USER01，USER02

売上げ

USER01，USER02

商品ファイル

USER01

(2)　表「仕入れ」の内容

コード

商品名

定価（円）

原価（円）

数量（個）

A01

色鉛筆

100

80

12

C02

ペン

300

250

48

B01

色紙

150

100

24

A02

色鉛筆

150

120

48

D01

手帳

800

600

50

C01

ペン

400

12

C03

ペン

350

250

30

3.5　DBPARTNER2の終了

DBPARTNER2を終了するには，［DBPARTNER2］ウィンドウの［ファイル］−［終了(X)］メニューを使います。［ファイル］メニューをプルダウンできる状態のときならば，いつでも終了できます。

［終了(X)］メニューを選びます。

次の場合は終了が抑止されます。

DBPARTNER2がダイアログボックスを表示中は，ExcelやWindowsを終了してもDBPARTNER2は同時終了できません。

DBPARTNER2がサーバ接続中又は切り離し中は，Windowsは終了できません。

4　データの抽出（［抽出］メニュー）

この章では，データベースからデータを抽出する操作について説明します。また，データを抽出するときに使える機能について説明します。

4.1　データの抽出の基本操作

データの抽出とは，クライアントPCからサーバ上のデータベースにアクセスしてデータを取り出すことです。ここでは，データの抽出の基本操作について説明します。データベースを更新する目的で抽出する更新用の抽出も同じ操作です。

DBPARTNER2を起動してからデータを抽出してDBPARTNER2を終了するまでの操作を次の図に示します。

図4‒1　データの抽出の操作

4.1.1　データを抽出する操作の手順

(1)　操作

DBPARTNER2を起動してサーバと接続後，データを抽出します。データの抽出は［DBPARTNER2］ウィンドウから始めます。

入力例を次に示します。

［DBPARTNER2］ウィンドウで［表名(T)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示され，データベース中の表が一覧で表示されます。

［詳細表示(P)］チェックボタンにチェックすると，表名以外の情報を表示できます。

参照：「4.2.1　表一覧表示方法の設定」

表一覧には，接続先定義ファイルに指定している数まで表示できます。

参照：「2.4.3　パラメタを指定するときの規則」

表の一覧から抽出したい表の表名をクリックして，［選択(S)］ボタンをクリックします。

複数表を結合して，データを抽出するときは，この操作を繰り返してください。選択したい表をダブルクリックしても選択できます。

選択できる表は最大15個です。複数表を結合する場合は，表と表の関係を示す結合条件が必要です。結合条件は，［条件設定］ダイアログボックスで設定してください。

参照：「4.1.2　抽出する表の選択」

選択した表が表示されます。

表を削除する場合

［選択表一覧(A)］から削除したい表をクリックします。次に［削除(D)］ボタンをクリックします。複数の表を削除したい場合，この操作を繰り返してください。

削除したい表をダブルクリックしても削除できます。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［表名(T)...］には，［表選択］ダイアログボックスで選択した表名が表示されます。

列を設定してデータを抽出する場合，［列設定(U)...］ボタンをクリックします。

条件を設定してデータを抽出する場合，［条件設定(C)...］ボタンをクリックします。

［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスが表示されます。

列一覧には，接続先定義ファイルに指定している数まで表示できます。

参照：「2.4.3　パラメタを指定するときの規則」

特定の列のデータを抽出するとき，このダイアログボックスで列を設定します。列を設定後，条件も設定できます。

参照：「4.2.4　特定の列のデータの抽出」又は「4.2.6　条件を設定したデータの抽出」

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［条件設定(C)...］ボタンをクリックすると，［条件設定］ダイアログボックスが表示されます。

［列一覧(C)］には，接続先定義ファイルに指定している数まで表示できます。

参照：「2.4.3　パラメタを指定するときの規則」

条件を設定してデータを抽出するとき，このダイアログボックスで条件を設定します。条件を設定後，列も設定できます。複数表を結合してデータを抽出する場合は，表結合条件式で結合する条件を設定してください。

参照：「4.2.4　特定の列のデータの抽出」又は「4.2.6　条件を設定したデータの抽出」

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。ここまでに設定した項目が表示されるので内容を確認してください。

設定した内容を変更又は削除したい場合，［列設定］ダイアログボックス，又は［条件設定］ダイアログボックスを開いて，設定し直してください。

設定した条件をすべて削除したい場合は，［抽出(S)］−［列情報の最新(N)］をクリックすると，最新の列情報を取得し直せます。［列情報の最新］については「4.1.4　最新列情報の取得」を参照してください。

［選択列］には，選択した列数が表示されます（10,000列まで表示されます）。

表名だけ選択して列を設定していない場合には表示されません。

抽出するデータの件数を制限したい場合，［件数制限(L)］欄に件数を入力します。

参照：「4.2.8　抽出するデータの件数の制限」

設定した列や条件を確認したら，［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンをクリックします。

［転送先設定］ダイアログボックスが表示されます。

参照：「4.1.3　抽出したデータの転送先の設定」

抽出したデータの転送先として，ファイル，連携，データベース，又はクリップボードを選びます。Excelなどと連携する場合は，転送先は自動的に設定されます。

ファイル名を変更する場合は，［ファイル(F)］テキストボックスの設定内容を変更します。

［OK］ボタンをクリックします。

［ファイル(F)］を選択して［...］ボタンをクリックすると，［転送先のファイル名の設定］ダイアログボックスが表示されます。

ファイル名，ファイルの種類，フォルダ，及びドライブを入力します。

参照：「4.1.3　抽出したデータの転送先の設定」

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定した転送先が表示されます。

抽出するデータの件数を確認するときは，［件数表示(N)］をオンにします。

［抽出(E)］ボタンをクリックします。

［件数表示(N)］をオンにしていると，抽出するデータの件数が，メッセージのダイアログボックスに表示されます。

［はい(Y)］ボタンをクリックすると，このダイアログボックスが閉じてデータの抽出が開始されます。

件数を表示しない場合は，［DBPARTNER2］ウィンドウの［抽出(E)］ボタンをクリックすれば，データの抽出を実行できます。

［抽出経過表示］ダイアログボックスが表示されます。

ここまでに指定された内容でDBPARTNER2がデータを抽出して，転送します。

実行経過は，グラフにパーセントで表示されます。ODBC接続で件数表示をしない場合,実行経過は件数で表示されます。抽出するデータが多いと，処理時間が長くなります。条件などを設定して必要なデータだけを抽出するようにしてください。

［キャンセル］ボタンをクリックすると，データの抽出処理が中断されます。

［抽出経過表示］ダイアログボックスは，正常に処理が終了すると自動的に閉じ，［DBPARTNER2］ウィンドウに戻ります。

これで，データの抽出と転送が終わりました。Excelにデータを転送した場合，シート上でデータを編集して，更新できます。

複数表を結合してデータを抽出する場合

表間の関係を示す条件（結合条件）を［条件設定］ダイアログボックスの［表結合(J)...］を使用して設定してください。例えば，表Aのa列と表Bのb列が共通であり，a列とb列のデータが同じ行を抽出したい場合には，結合条件「a=b」を［条件設定］ダイアログボックスに設定してください。設定方法については，「4.2.2　複数の表からのデータの抽出（表結合）」を参照してください。

複数表からデータを抽出するときに結合条件を設定していない表があった場合

データの抽出を確認するメッセージダイアログボックスが表示されます。抽出すると，すべての組み合わせで抽出されます。すべての組み合わせとは，結合条件を設定している表の各行に結合条件を設定していない表の全行を付けることです。例えば，結合条件が設定されていない表A（h行）と表B（i行）と表C（j行）から無条件でデータを抽出すると（h×i×j）の行が抽出されます。

詳細は，「4.2.2　複数の表からのデータの抽出（表結合）」を参照してください。

件数表示できない場合があります

列に集合関数を設定している場合，又は表結合条件式を設定している場合は，件数表示できないことがあります。

また，VOS3 XDM/SD E2では件数表示できません。

抽出処理を中断した場合

それまでに抽出したデータは捨てられます。ODBC接続で他社データベースにアクセスしている場合は，中断できないことがあります。

転送先のメモリが満杯になった場合

抽出するデータが多く，転送先のメモリが満杯になった場合，メモリ分までのデータが抽出されるか，又はほかのアプリケーションのメッセージダイアログボックスが表示されます（流通ソフトウェアによって異なります）。

(2)　データを抽出するときの制限

DBPARTNER2の制限で，データを抽出できない場合があります。

DBPARTNER ODBC 3.0 Driverを経由してデータベースにアクセスする場合，列名長（バイト）と列の定義長（バイト）の合計値が次の計算式をどちらも満たす表でないと抽出できません。

92+Σ列数(20+↑　列名長　↑※)≦65536

52+Σ列数(20+↑列の定義長↑※)≦65536

注※　4の倍数に切り上げ

(3)　データを抽出するときの注意

DBPARTNER2以外の制限（データベースの制限）で，データを抽出するときに注意する項目を次の表に示します。

表4‒1　データを抽出するときに注意する項目

データベース名

注意する内容

VOS3 XDM/SD E2

複数表から抽出できません。

［列設定］ダイアログボックスでは，［ソート(S)...］ボタンと［集合関数(S)］ボタンは選択できません。実行時にエラーになります。

HiRDB

参照権限のない表が表示されることがあります。

ORACLE

参照権限のない表が表示されることがあります。

HADB

参照権限のない表が表示されることがあります。

4.1.2　抽出する表の選択

抽出する表を選択します。オプションで見出し辞書を使う設定をしている場合には，見出し辞書中の表から選択します。

データを抽出する表を［表選択］ダイアログボックスで選択します。［表選択］ダイアログボックスの［詳細表示(P)］チェックボックスをオンにすると，所有者，表名以外に種別，注釈が表示されます。［表選択］ダイアログボックスで表示される情報について説明します。

所有者

表の所有者

表名

表の名称。通常はデータベースで定義された表ヘッダが表示されます。表ヘッダが定義されていない場合は表名が表示されます。

種別

データベースで定義された表種別が表示されます。種別については，各データベースのマニュアルを参照してください。

TABLE

VIEW

SYSTEM TABLE

GLOBAL TEMPORARY

LOCAL TEMPORARY

ALIAS

SYNONYM

注釈

データベースで表定義時に表注釈を設定している場合は，注釈が表示されます。

オプションで見出し辞書を使う設定をしていると，見出し辞書に登録された表見出しが表示されます。

表を選択するときには，次の操作ができます。

表一覧表示方法の設定

表を選択する目安として，所有者や，注釈などの項目を表示する設定ができます。

参照：「4.2.1　表一覧表示方法の設定」

複数の表を結合してデータを抽出

表間で共通する列を結び付けて表を結合し，一つの表として抽出できます（表結合）。

参照：「4.2.2　複数の表からのデータの抽出（表結合）」

表選択時の絞り込み

［表選択］ダイアログボックスで，一覧表示された表の中から抽出する表を選択するときに，条件を付けて絞り込めます。

参照：「4.2.3　表選択時の絞り込み」

(1)　操作

［DBPARTNER2］ウィンドウで［表名(T)...］ボタンをクリックすると，［表選択］ダイアログボックスが表示されて，抽出対象の表が一覧表示されます。

抽出する表を選択してください。

4.1.3　抽出したデータの転送先の設定

抽出したデータの転送先を設定します。データを抽出する場合，必ず転送先を設定してください。

転送先には，ファイル，連携，データベース，クリップボードがあります。

ファイル

抽出するデータをファイルに格納する

連携

抽出するデータを，［データ表示］ウィンドウ，又は表計算ソフトに転送する

データベース

抽出するデータを別表としてデータベースに保存する

クリップボード

抽出するデータをクリップボードに貼り付ける

転送先には前回設定した転送先が仮定されています。ただし，次の場合には「ファイル」が選択されています。

インストール直後（ファイル名は，Dbpdata.txt）

また，バイナリのデータを含む表の抽出は，［データ表示］ウィンドウに限ります。詳細は，「4.2.10　バイナリデータを含む表の抽出」を参照してください。

(1)　ファイルに転送する

次に示す項目を入力してください。転送されたデータの形式については，「付録B　ファイル出力するデータ形式のフォーマット」を参照してください。

ファイル名

格納するファイル名をキーボードから入力します。ファイル名はユーザが任意に決められます。また，ファイル名の一覧から選択することもできます。ファイル名が一覧に表示しきれない場合は，一覧の右端にスクロールバーが表示されます。一覧をスクロールしてファイル名を表示させてください。

既存のファイル名を指定した場合，そのファイルに上書きされます。また，ファイル名には，あらかじめDbpdata.txtが仮定されています。

フォルダ

フォルダの一覧から選択してください。フォルダを選択しない場合は，表示されている抽出データ格納ファイルのフォルダになります。

ファイルの種類

利用するほかのアプリケーションのデータ形式に合わせて，データ形式を選択してください。［▼］をクリックして表示されるデータ形式の一覧から選択します。

ドライブ

ドライブを一覧から選択してください。ドライブの一覧は［▼］をクリックして表示させます。ドライブを選択しないと，抽出データ格納ファイルのドライブになります。

(a)　入力例

［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンをクリックします。

［転送先設定］ダイアログボックスが表示されます。

［ファイル(F)］オプションボタンをオンにします。

これで転送先にファイルが設定されました。

［OK］ボタンをクリックします。

［転送先のファイル名の設定］ダイアログボックスが表示されます。

ファイル名，ファイルの種類，フォルダ，及びドライブを入力します。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。絶対パス名が表示されます。

(2)　連携先に転送する

抽出したデータを，［データ表示］ウィンドウ，又はほかのアプリケーションのシートへ転送します。

Excelと連携する場合は，DBPARTNER2，又はExcelのどちらからでも連携できます。

(a)　［データ表示］ウィンドウを使った抽出

［データ表示］ウィンドウを使った抽出について説明します。［データ表示］ウィンドウについては，「5.2.3(1)　［データ表示］ウィンドウ」を参照してください。

［データ表示］ウィンドウに抽出したデータを表示するには，二つの方法があります。

すべてのデータを取り出した後で表示する（一括出力）

データベースからの抽出が終了すると，データが表示されます。

一括出力の場合は，［データ表示］ウィンドウでの操作はありません。抽出が完了すると自動的にデータが表示されます。

データをブロックに分けて表示する（逐次出力）

データベースから，幾つかのブロックに分けて抽出します。データは，一つのブロックの抽出が終わると表示されます。次のデータを取得する操作をすると，最終行に続いて新しいブロックのデータが表示されます。

逐次出力にするには，あらかじめ次の操作が必要です。

［転送先設定］ダイアログボックスの［詳細設定(U)...］ボタンをクリックします。

［データ表示設定］ダイアログボックスが表示されます。

［区切って出力(P):］チェックボックスをオンにします。

［件(L)］テキストボックスが活性化されます。

1ブロックで転送させるレコードの件数を，［件(L)］テキストボックスに入力します。件数のデフォルトは10件です。

逐次出力の場合は，最初のブロックの抽出が完了すると，自動的に［データ表示］ウィンドウにデータが表示されます。その後，次のブロックのデータを表示させるための操作を次に示します。

［抽出(S)］−［次データ表示(N)］を選択します。

新しいデータが，最終行以降に表示されます。

現在表示されている以降のデータを一括して表示させたいときは，［抽出(S)］−［一括表示(A)］を選択します。

現在表示されている以降のデータを表示させる必要がないときは，［抽出(S)］−［中止(C)］を選択します。

(3)　データベースに転送する

抽出したデータを別の表としてデータベースに保存します。この場合，表を定義する［表定義］ダイアログボックスが表示されるので，表を定義してください。表定義については，「9.1　表定義の概要」を参照してください。DBPARTNER2からデータベースへ定義する表は，「一時」，「保存」，「一時，保存以外」の三つの種別に区別されます。ここで定義する表は，「保存」表として扱われます。

「保存」表は，接続先定義ファイルのTABLESPACEパラメタで指定した領域に格納されます。TABLESPACEパラメタについては，「2.4.3　パラメタを指定するときの規則」を参照してください。

(a)　操作

［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンをクリックします。

［転送先］ダイアログボックスが表示されます。

［データベース(D)］オプションボタンをオンにします。

これで転送先にデータベースが設定されました。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。データベースが転送先として表示されます。

注

データベースに転送できるのは，DBPARTNER ODBC 3.0 Driverを経由してデータベースにアクセスする場合だけです。

(4)　クリップボードに転送する

抽出したデータをクリップボードに転送します。転送されたデータの形式については，「付録B　ファイル出力するデータ形式のフォーマット」のTEXT形式です。

クリップボードに転送する場合の設定方法を説明します。

(a)　操作

［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンをクリックします。

［転送先］ダイアログボックスが表示されます。

［クリップボード(S)］オプションボタンをオンにします。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。クリップボードが転送先として表示されます。

4.1.4　最新列情報の取得

抽出するデータの抽出条件を設定中に，手順ファイルを参照しているときの表示中の抽出条件と実際のデータベース，又は辞書の内容が異なる場合に，最新の列情報を取得し直し，抽出条件を最新の条件に自動更新できます。

操作は［抽出(S)］−［列情報の最新(N)］メニューを選択します。この操作によって，抽出条件中の以下の項目を最新の状態に更新します。

［列設定］ダイアログボックスで設定した内容

［条件設定］ダイアログボックスで設定した内容

メインメニューの表示状態と実際のデータベース，又は辞書の内容の変更内容でのこの機能の動作を次の表に示します。

表4‒2　 最新列情報の内容

最新列情報取得前の

データベース定義変更の内容

［列設定］ダイアログボックスで設定した内容

［条件設定］ダイアログボックスで設定した内容

列の追加

変わらない

変わらない

列の削除

削除した列を選択している場合だけ，該当する列を非選択状態にする。

条件式中に削除した列が含まれている場合にだけ，該当条件式が削除される。※

列の順序変更

変わらない

変わらない

列名変更

列を削除した場合と同じ

列を削除した場合と同じ

その他列情報の変更

最新の状態になる

最新の状態になる

注※

条件式を削除した場合，条件関連式をクリアします。ただし，OUTER JOIN式は例外となります。

規則

最新情報の取得後，［列設定］ダイアログボックス又は［条件設定］ダイアログボックスを表示したときの列一覧は，列情報の変更内容にかかわらず，最新の状態となります。

この機能を使用しても，仮想列の記述内容は変わりません。

削除した選択列にソートを指定していた場合，削除した選択列のソート優先度より低い優先度を持つ選択列の優先度は，すべて一つ繰り上げとなります。

すべての選択列がなくなった場合は，全列抽出となります。

4.1.5　項目名を表示する設定

抽出するデータを転送するときに，項目名を出力するかどうかを設定します。項目名を出力するときは，［抽出(S)］−［項目名(H)］メニューをオンにします。オンにすると，項目名が出力されます。

この設定は，接続先定義ファイルのCLMHEADパラメタでYESを指定したときと同じです。DBPARTNER2起動時には接続先定義ファイルのCLMHEADパラメタの値が仮定されます。また，ここでの設定は接続先定義ファイルには反映されません。

4.2　抽出で使える機能

データを抽出するときに使える機能について説明します。

抽出で使える機能の一覧を次の表に示します。

表4‒3　抽出で使える機能の一覧

抽出で使える機能

説明

表一覧の表示方法を設定する

抽出する表を選択するときに，目安となる情報を一覧に表示します。

複数の表を結合して抽出する

表と表で共通する列を結び付けて，一つの表として抽出できます（表結合）。関連する表のデータを一括して利用できます。

表を選択するときに絞り込みをする

抽出対象の表の一覧から抽出する表を選ぶときに，条件を付けて絞り込めます。抽出対象の表が大量にある場合などに，効率良く表を選べます。

特定の列だけを抽出する

抽出する表から特定の列だけを選んで抽出できます。選択した列のデータをソートしたり，列のデータの最大値，最小値などを抽出したりすることもできます。

条件に合うデータを抽出する

抽出する表から条件に合うデータだけを抽出できます。また，複数の条件式を関連付けることもできます。例えば，定価が50,000円以上のデータを抽出する条件と，商品名が冷蔵庫又はテレビのデータを抽出する条件を「AND」で関連付けます。この場合，定価が50,000円以上でかつ，商品名が冷蔵庫又はテレビのデータだけを抽出できます。

特定の列で，条件に合うデータを抽出する

列と条件の両方を設定して，データを抽出できます。指定した列のデータのうち，条件に合うデータだけを抽出できます。

可変記号を使ってデータを抽出する

条件に合うデータを抽出するときに設定する条件式に，可変記号を設定できます。条件式の条件値だけを変更するときに使います。操作を手続き化している場合も，手続きを書き直す必要がなく，可変記号に対する実行値を入力するだけでデータを抽出できます。これによって，日付や市場取引価格などの刻々と変化する値に応じてデータを抽出できます。

抽出するデータの件数を制限する

データを抽出するときに，その件数を指定できます。抽出するデータをソートして上位10件だけを抽出したり，表計算ソフトに表示できるデータ量を考慮して，抽出する件数を制限したりするときなどに使います。

抽出するデータを事前に確認する

実際に抽出を実行する前に，対象となるデータを表示して，そこでデータの内容を確認できます。また，対象となるデータの件数も表示されます。抽出するデータが正しいか，又は抽出する条件が正しいかなどを確認できます。さらに，確認したデータを別表として保存したり，条件を変更/追加して絞り込んだりできます。クライアントPCにデータを抽出する前にデータの内容を確認できるので，効率的にデータを抽出できます。

見出し辞書で，データベースの定義に依存しない表現を使える

データベース内の表名や列名に対して，任意の名称を設定できます。サーバ側のデータベースを意識しないで，業務で使い慣れた名称で操作できます。任意の名称を登録する辞書を見出し辞書といいます。見出し辞書を使うと，DBPARTNER2はサーバではなく見出し辞書にアクセスして表名や列名を取得するため，サーバにアクセスしている間の待ち時間が短縮できます。

手順ファイルを使ってデータを抽出する

データを抽出したときに指定した表名，列名，条件などを手順ファイルに登録して，登録した内容に従って抽出できます。手順ファイルを使うと，毎日同じ条件でデータを抽出するときに作業効率を向上できます。手順ファイルに登録した内容は，必要に応じて変更できます。手順ファイルの操作方法については，「6.1　手順ファイル」を参照してください。

4.2.1　表一覧表示方法の設定

データベースから表名を取得するとき，表を選択しやすいように表一覧に幾つかの情報を表示できます。

表示できる項目を次に示します。

グループ名

所有者

表名

種別

注釈

(1)　表一覧表示方法を設定する操作

［DBPARTNER2］ウィンドウで［表名(T)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

［表選択］ダイアログボックスの［詳細表示(P)］チェックボックスをチェックします。

［表示設定(I)...］ボタンが活性化されます。

［表示設定(I)...］ボタンをクリックします。

［表一覧表示方法の設定］ダイアログボックスが表示されます。

表示する項目を選択して［表示］ボタンをクリックします。

表示しない項目がある場合は，項目を選択して［非表示］ボタンをクリックします。

［OK］ボタンをクリックします。

表一覧表示方法が設定されます。

(2)　規則

「表名」は「非表示」を設定できません。

項目は，「グループ名」，「所有者」，「表名」，「種別」，「注釈」の順で表示されます。

「グループ名」は，見出し辞書を使用した場合に表示されます。

4.2.2　複数の表からのデータの抽出（表結合）

複数の表を結合させて，データを抽出できます。結合するためには，それぞれの表に共通する列がなければなりません。共通する列は［表結合条件式］ダイアログボックスで条件を設定して結び付けます。これを結合条件といいます。

結合には，結合条件を満たす行だけを抽出する通常の結合（内結合）と，通常の結合で得られる情報以外に，ある表に関してはすべての情報を抽出する結合（外結合）の2種類があります。

(1)　内結合

複数の表から結合条件を満たす行だけ抽出します。これを通常の結合，内結合といいます。例えば，仕入れ表と在庫表という二つの表を内結合する場合には，条件を満たす仕入れ表の行と，条件を満たす在庫表の行を抽出します。

内結合の例を次の図に示します。

図4‒2　内結合の例

(2)　外結合

全体の情報を持つ外表と部分的な情報を持つ内表とを結合するときに，外表に関するすべての行も抽出できます。これを外結合といいます。例えば，仕入れ表と在庫表という二つの表を外結合する場合には，仕入れ表のすべての行と，条件を満たす在庫表の行を抽出します。

外結合の例を次の図に示します。

図4‒3　外結合の例

(3)　複数表からデータを抽出する操作

内結合，外結合の例を基に複数表を結合してデータを抽出する操作を説明します。複数表からデータを抽出する操作を次の図に示します。

図4‒4　複数表からデータを抽出する操作

(4)　注意

(a)　結合条件を設定しなかった場合

結合条件を設定しないと，すべての組み合わせで抽出されます。すべての組み合わせとは，結合条件を設定している表の各行に結合条件を設定していない表の全行を付けることです。例えば，結合条件が設定されていない表A（h行）と表B（i行）と表C（j行）から無条件でデータを抽出すると（h×i×j）個の行が抽出されます。

(b)　HiRDBの場合

表種別が「ALIAS」の場合は「ALIAS」表としか結合できません。表種別は［表選択］ダイアログボックスの［詳細表示］チェックボックスをオンにすると表示されます。

外結合をする場合，選択できる表の数は2までです。

4.2.3　表選択時の絞り込み

［表選択］ダイアログボックスに表示された表の一覧から，表を選択するときに条件を付けて絞り込めます。表を選択する操作（抽出，見出し辞書）で使えます。

条件は，表の「所有者名」「表名」それぞれに設定できます。ワイルドカード（所有者名，表名で条件文字列以外の部分）には半角文字の「*」及び「?」を使用します。

*：0文字以上の文字列

?：1文字の文字列

また，次の文字パターンで表を絞り込めます。

前方一致（例：ABC*）：文字列の先頭がABCで以降は任意の文字

後方一致（例：*ABC）：文字列の最後がABCで以前は任意の文字

部分一致（例：?ABC?）：5文字の文字列のうち，2〜4文字目がABC

中間一致（例：*ABC*）：文字列にABCを含む

(1)　［表の絞り込み条件設定］ダイアログボックス

表を絞り込む操作で使う［表の絞り込み条件設定］ダイアログボックスを次に示します。

タイトルバー

「表の絞り込み条件設定」と表示されます。

［所有者(C)］

所有者に対する絞り込み条件を指定します。今までに指定した条件（接続先に関係なく）のうち，最新の5個※が表示されます。

［表名(T)］

表名に対する絞り込み条件を指定します。今までに指定した条件（接続先に関係なく）のうち，最新の5個※が表示されます。

［英大小文字同一視(D)］

英字の大文字と小文字を区別するかどうかを指定します。

［OK］ボタン

設定した絞り込み条件で表を検索します。検索が終わると，［表選択］ダイアログボックスに戻り，条件に該当する表を表示します。

［キャンセル］ボタン

絞り込みの条件の設定を無効にして，［表選択］ダイアログボックスに戻ります。

(2)　操作

表を絞り込む操作について説明します。

［DBPARTNER2］ウィンドウの［表名(T)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されて，表一覧に表が表示されます。

［絞り込み(F)...］ボタンをクリックします。

［表の絞り込み条件設定］ダイアログボックスが表示されます。

絞り込む条件を設定します。

所有者，表名のそれぞれに，前方一致，後方一致，部分一致，中間一致のどれかの条件を設定します。「*」「?」以外の部分が一致させる文字列です。

（例）

所有者が「U」で始まる表を絞り込む場合,［所有者(C):］に「U*」を設定する

表名の1〜3文字が「仕入れ」で4文字目が分からない表を絞り込む場合,［表名(T):］に「仕入れ?」を設定する

英字の大文字と小文字を区別しない場合は，「英大小文字同一視」をクリックする

［OK］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。条件に合った表名だけが一覧に表示されます。

再度，絞り込みをする場合，前回絞り込んだ表を対象にするのではなく，1.で表示された表を絞り込み対象とします。

補足

再度絞り込みをする場合，既に選択されている表はそのまま残ります。

(3)　規則と注意

(a)　条件に指定できる文字

使える文字は，全角文字，半角文字です。

絞り込み条件の文字列の前後に指定された空白は無視されます。

「*」「?」はワイルドカードとして扱われるため，絞り込む条件に指定できません。

(b)　指定できる長さ

条件に指定できる長さは，254バイトです。

（所有者名※+表名※）の最大が，254バイトです。

注※　前後に空白が設定されている場合はその空白を省いた文字数です。

(c)　絞り込み対象

データベースに表ヘッダがある表に対しては表ヘッダで，表ヘッダがない表に対しては表名で絞り込まれます。見出し辞書を使っている場合は，見出し辞書に登録している表見出しで絞り込まれます。

(d)　「所有者がない表」を絞り込み条件にしたい場合

所有者には文字を入力しないで絞り込みを実行すると所有者がない表が表示されます。

(e)　［詳細表示］をチェックしている場合

［表一覧表示方法の設定］ダイアログボックスで"所有者"を"非表示"にした場合は，［所有者］での絞り込みはできません。

4.2.4　特定の列のデータの抽出

列を設定して，特定の列のデータを抽出します。このとき，列のデータをソートしたり，最大値や最小値のデータを抽出したりすることもできます。

(1)　抽出する列を設定する

列の設定は［列設定］ダイアログボックスを使います。

(a)　［列設定］ダイアログボックス

［列設定］ダイアログボックスを表示するには，［DBPARTNER2］ウィンドウで表名を設定した後で，［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスを次に示します。

［列設定］ダイアログボックスの次に示すボタンを使って，抽出したい列を絞り込んでください。

ボタン

機能

［列一覧(C)］

表に定義されている列名を［列一覧］に示します。

［表名非表示(I)］

チェックすると，［列選択］リストの表名が非表示になります。

複数の表が選択されている場合にだけ，活性化されます。

［追加(A)］

［選択列］リストに列を追加します。

［挿入(P)］

［選択列］リストに列を挿入します。

［種別変更(F)］

［ファイル種別］ダイアログボックスを表示します。

［削除(D)］

［選択列］リストの不要な列を削除します。

［全列削除(E)］

［選択列］リストのすべての列を削除します。

［ソート(S)...］

列にソートを設定します。

［集合関数(B)...］

列に集合関数を設定します。

［更新条件(U)...］

［更新条件の列の設定］ダイアログボックスを表示します。

注

更新条件の列の設定については，「5.2.4　条件を設定して更新する行を決定する」を参照してください。

［列一覧］

表中の列名が表示されます。

全表示を選択した場合は，すべての表の列名が表示されます。

選択した表のうち，一つの表の列だけを表示させる場合は，［表名］表示領域の［▼］をクリックして表示される表名の中から表を選択してください。

列名は，接続先定義ファイルに指定している数まで表示できます。詳細は，「2.4.3　パラメタを指定するときの規則」を参照してください。

［表名(T)］

抽出する表の表名が表示されます。

複数表を選択した場合は，「全表示」と表示されます。

［選択列］リスト

［列設定］ダイアログボックスで追加・選択した内容が表示されます。ソート，更新条件などの情報は列名の前に追加されます。書式を次に示します。

[ファイル種別情報],[更新条件情報],[ソート情報]¥t[列名]

［ファイル種別情報］，［更新条件情報］，［ソート情報］がない場合は，列名情報だけを表示します。

［ファイル種別情報］は，LONG VARBINARY属性の場合に，列に設定したファイル種別の情報を表示します。

［更新条件情報］には，設定した更新条件の設定情報が表示されます。更新条件が解除されると，「*」が表示されます。

［ソート情報］には，列に設定したソート設定の情報で「昇順n」又は「降順n」が表示されます。

［列名］には，選択した列名が表示されます。集合関数が設定されている場合には，「集合関数（列名）」の書式で表示されます。

［選択列］テキスト

選択した列の数が表示されます。

［選択列］リストを確認後，［OK］ボタンをクリックして，［列設定］ダイアログボックスを閉じます。

複数の列をまとめて操作できます

列名の一覧で列を複数選択してから，［追加(A)］［挿入(P)］［削除(D)］ボタンをクリックしてください。

(b)　列を追加する

列名の一覧から選択した列を，［選択列］リストの最後尾に追加します。

入力例

［列一覧(C)］ラジオボタンを選択します。

追加したい列の列名を選びます。

［追加(A)］ボタンをクリックします。

選択した列が追加されます。

(c)　列を挿入する

列名の一覧から選択した列を，［選択列］リストに挿入します。

入力例

［列一覧(C)］ラジオボタンを選択します。

抽出したい列の列名をクリックします。

挿入したい位置をクリックします。

［挿入(P)］ボタンをクリックします。

選択した列が挿入されます。

(d)　列を削除する

［選択列］リストから，不要な列を削除します。

入力例

削除したい列をクリックします。

［削除(D)］ボタンをクリックします。

選択した列が削除されます。

(e)　全列を削除する

［選択列］リストのすべての列を削除します。

入力例

［全列削除(E)］ボタンをクリックします。

すべての列が削除されます。

(2)　列のデータをソートする

選択した列のデータをソートします。［ソート(S)...］ボタンをクリックして表示される［ソート設定］ダイアログボックスで，ソートやソート時の優先順位を設定します。ただし，ソートを設定できない列もあります。ソートを設定できない列については，「8.　列と条件を設定するときの規則」を参照してください。

(a)　ソートを設定する

［ソート設定］ダイアログボックスで設定する内容について説明します。

ソートを設定する列名の選択

ソートを設定する列名を，列一覧から選択します。

ソート方法の設定

条件を設定するボタンでソートします。

［昇順(A)］：昇順でのソートを設定するボタンです。

［降順(D)］：降順でのソートを設定するボタンです。

設定した内容は，設定内容一覧に表示されます。

ソートの条件が複数ある場合，設定内容一覧の上位にある条件が優先順位の高い条件となります。優先順位は変更することもできます。詳細は，「4.2.4(2)(c)　優先順位を変更する」を参照してください。

入力例

［列設定］ダイアログボックスの［ソート(S)...］ボタンをクリックします。

［ソート設定］ダイアログボックスが表示されます。

ソートを設定する列名を選びます。

ソートの条件を設定するボタンをクリックします。

複数の条件を設定する場合，2.〜3.の操作を繰り返してください。

設定内容が［設定内容一覧］に表示されます。

［OK］ボタンをクリックします。

［列設定］ダイアログボックスにソートの条件が表示されます。条件の右に付けられた番号は，優先順位を示します（条件が一つの場合も表示されます）。

(b)　ソートの設定を削除する

ソートの条件を取り消す場合，次の順序でソートの条件を削除します。

［ソート設定］ダイアログボックス中の，削除するソートの条件を選びます。

［削除(D)］ボタンをクリックします。指定したソートの条件が削除されます。

(c)　優先順位を変更する

ソートの条件の優先順位を変更します。変更には，優先順位の［↑(U)］ボタン（優先順位を高くする）又は［↓(O)］ボタン（優先順位を低くする）を使います。

入力例

優先順位を変更するソートの条件をクリックします。

優先順位を変更するボタンをクリックします。

優先順位を一つ高くする場合はボタンを1回クリック，二つ高くする場合は2回クリックしてください。

優先順位が変更されます。

［OK］ボタンをクリックします。

［列設定］ダイアログボックスにソートの条件が表示されます。条件の右に付けられた番号は，優先順位を示します。

(3)　集合関数を設定する

集合関数を設定すると，列中のデータの最大値，最小値などを抽出できます。ただし，集合関数を設定した場合は，表データそのものは抽出できません。

集合関数は，［集合関数設定］ダイアログボックスを使って設定します。ただし，集合関数が設定できない列もあります。詳細は，「8.　列と条件を設定するときの規則」を参照してください。

(a)　選択した列に集合関数を設定する

［列設定］ダイアログボックスで抽出する列を設定して，［集合関数設定］ダイアログボックスを開くと，初めはすべての列にグループ分けが設定されています。その中から，集合関数を設定する列名を選んでから，集合関数のボタンをクリックすると，その列に集合関数が設定されます。　

設定した列名と集合関数は，［選択列］に表示されます。オプションを設定すると，抽出時の列名をデータベースの見出し辞書の見出しで表示できます。オプション設定については，「7.1.10　集合関数指定時の列の見出し表示」を参照してください。

設定できる集合関数

表4-4に示す集合関数を設定できます。

表4‒4　［集合関数設定］ダイアログボックスで設定できる集合関数

ボタン名

機能

抽出時の表示形式

最大(M)

列のデータ中から最大値を抽出します。

「7.1.10　集合関数指定時の列の見出し表示」を参照

最小(S)

列のデータ中から最小値を抽出します。

平均(A)

列のデータの平均値を抽出します。

合計(T)

列のデータの合計値を抽出します。

件数(C)

列のデータの件数を抽出します。

複数の列をまとめて操作できます

設定内容一覧で列を複数指定してから，集合関数のボタンをクリックしてください。

グループ分けを設定する

列にグループ分けを設定しておくと，グループ（列中の同じデータの集合）単位で集合関数を算出してデータが抽出されます。抽出するデータをソートする場合は，［ソート設定］ダイアログボックスで，ソートやソート時の優先順位を設定してください。

集合関数を設定した列をグループ分けの設定に戻すときは，列を選択後，［グループ(G)］ボタンをクリックします。

同一名称の列に，グループ分けを2回以上設定できません。また，既に集合関数を設定した表に列を挿入すると，その列にはグループ分けが設定されます。

グループ分けと集合関数を設定した場合の抽出結果を次に示します。

入力例

［集合関数(B)...］ボタンをクリックします。

［集合関数設定］ダイアログボックスが表示されます。

［列設定］ダイアログボックスで設定したすべての列にグループ分けが設定されています。

集合関数を設定する列をクリックします。

［最小(S)］ボタンをクリックします。

設定した内容が［設定内容一覧］に表示されます。

［OK］ボタンをクリックします。

設定した内容が［列設定］ダイアログボックスに表示されます。

集合関数を設定したときの例を次の表に示します。

(b)　設定したすべての集合関数の取り消し

［集合関数設定］ダイアログボックスで各列に設定したすべての集合関数を取り消すには，［全取消(D)］ボタンをクリックします。

入力例

［集合関数(B)...］ボタンをクリックします。

［集合関数設定］ダイアログボックスが表示されます。

［全取消(D)］ボタンをクリックします。

［集合関数設定］ダイアログボックスが閉じます。

設定していた集合関数がすべて取り消されます。

4.2.5　仮想列の追加と削除

(1)　仮想列の追加

データベース中から抽出した列の値を編集して，新しい列（仮想列）を追加できます。仮想列はDBPARTNER2で抽出した結果にだけ追加され，データベースの内容には影響しません。

仮想列の追加には［列設定］ダイアログボックスと［仮想列編集］ダイアログボックスを使います。

［列設定］ダイアログボックスについては，「4.2.4(1)(a)　［列設定］ダイアログボックス」を参照してください。

［列設定］ダイアログボックスの次に示すボタンを使って，仮想列を追加します。

ボタン

機能

［仮想列(V)］

［列一覧］に対して，仮想列を表示します。

［追加(A)］

［選択列］リストに仮想列を追加します。

［挿入(P)］

［仮想列編集］ダイアログボックスを表示します。

［編集(O)...］

仮想列を編集します。

［削除(D)］

［選択列］リストの不要な列を削除します。

［全列削除(E)］

［選択列］リストのすべての仮想列を削除します。

［ソート(S)...］

列にソートを設定します。

［集合関数(B)...］

列に集合関数を設定します。

［更新条件(U)...］

［更新条件の列の設定］ダイアログボックスを表示します。

注

更新条件の列の設定については，「5.2.4　条件を設定して更新する行を決定する」を参照してください。

(a)　［仮想列編集］ダイアログボックス

［仮想列編集］ダイアログボックスを次に示します。

［表名(T)］

表名を表示するエリア。複数表選択の時は列名一覧を表示している表名，又は「全表示」を表示する。

［列一覧(F)］

［表名(T)］で選択した表に定義されている列名（データベース中の列，及び設定済みの仮想列）を一覧表示する。

［属性］

［列一覧］で選択した列の属性を表示する。

［長さ］

［列一覧］で選択した列の長さを表示する。

［選択(S)］ボタン

［列一覧］で選択した列を［列内容］に入力する。

［列名称(V)］

仮想列の名称を設定する。最大46バイト。

［列内容(C)］

仮想列の演算内容を設定する。最大30,000バイト。

［列内容］にLONG VARBINARY属性の列は指定できません。指定した場合は実行時にエラーとなります。

［0〜9］，［000］，［.］，［||］，［/］，［*］，［-］，［+］，［(］，［)］ボタン

［列内容］のカーソルの後ろにボタンの文字を挿入する。

［後退］ボタン

［列内容］のカーソルの1文字前を消去する。

［削除］ボタン

［列内容］のカーソルの1文字後ろを消去する。

［OK］ボタン

設定した仮想列の編集を有効にし，ダイアログボックスを閉じる。

［キャンセル］ボタン

操作を無効にし，ダイアログボックスを閉じる。

(b)　入力例

［DBPARTNER2］ウィンドウでデータベース中の表名を設定した後で，［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスが表示されます。

［列一覧(C)］ラジオボタンをクリックします。

データベース中の列から，抽出する列を設定します。

［仮想列(V)］ラジオボタンをクリックします。

［追加(A)］ボタンをクリックします。

［仮想列編集］ダイアログボックスが表示されます。

［仮想列編集］ダイアログボックスで，仮想列の内容を設定します。

［列名称(V)］に仮想列の名称を設定します。

［列一覧(F)］から，編集する列をクリックします。

［選択(S)］ボタンで選択した列を［列内容(C)］に反映します。

四則演算のボタンなどで［列内容(C)］の内容を編集します。

編集が完了したら［OK］ボタンをクリックします。

［列設定］ダイアログボックスに戻ります。［選択列］に仮想列が追加されます。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定した内容が表示されます。

(2)　仮想列の編集

設定してある仮想列の内容を編集します。

入力例

［DBPARTNER2］ウィンドウでデータベース中の表名を設定した後で，［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスが表示されます。

編集する仮想列をクリックします。

［編集(O)...］ボタンをクリックします。

［仮想列編集］ダイアログボックスが表示されます。

［仮想列編集］ダイアログボックスで，仮想列の内容を編集します。

［列名称(V)］に仮想列の名称を設定します。

［列一覧(F)］から，編集する列をクリックします。

［選択(S)］ボタンで選択した列を［列内容(C)］に反映します。

四則演算のボタンで［列内容(C)］の内容を編集します。

編集が完了したら［OK］ボタンをクリックして，［列設定］ダイアログボックスに戻ります。

仮想列の使用例

［仮想列編集］ダイアログボックスの［列内容］には，CASE文を入力できます。

CASE文を使用すると，条件に一致した行の値の演算結果を仮想列のデータとして抽出できます。

CASE文を使用した次のような条件を［列内容］に設定します。

抽出の対象となるデータベース中のデータが次のようになっているものとします。

この場合，CASE文で設定した条件で抽出すると次の結果が得られます。

(3)　仮想列の削除

［選択列］リストから，不要な仮想列を削除します。

入力例

［列設定］ダイアログボックスの［選択列］から，削除したい仮想列をクリックします。

［削除(D)］ボタンをクリックします。

選択した仮想列が削除されます。

［OK］ボタンをクリックして，［列設定］ダイアログボックスを閉じます。

4.2.6　条件を設定したデータの抽出

条件を設定してデータを抽出します。条件は，［DBPARTNER2］ウィンドウの［条件設定(C)...］ボタンをクリックして表示される［条件設定］ダイアログボックスで設定します。

(1)　［条件設定］ダイアログボックス

［条件設定］ダイアログボックスを次に示します。

条件の設定で使うボタンを次の表に示します。条件は，サーバや列の属性によって使用が制限されます。条件の使用制限については「8.　列と条件を設定するときの規則」を参照してください。

表4‒5　 条件の設定で使うボタン

条件の種類

ボタン又は［条件(O)］

意味

比較条件

=

列の値と条件値が同じ

<>

列の値が条件値と異なる

>

列の値が条件値より大きい

>=

列の値が条件値以上

<

列の値が条件値より小さい

<=

列の値が条件値以下

NULL条件

NULL

列の値がナル値

NOT NULL

列の値がナル値以外

IN条件

IN...

列の値が，指定した複数の値のどれかと同じ，又はどれとも異なる

LIKE条件

LIKE

列の値が，指定した文字パターンと同じ

NOT LIKE

列の値が，指定した文字パターンと異なる

BETWEEN条件

BETWEEN...

列の値が，「指定した値1」と「指定した値2」の間，又はそれ以外

列演算条件

列演算...

演算を用いた条件式で比較する

比較条件

可変記号...

条件値を可変とする

IN条件

LIKE条件

BETWEEN条件

WHERE句に指定できる条件

直接入力

SQLのWhere句の形式で記述した条件を，そのまま指定できる

表結合条件

表結合...

表と表を結合する

［条件設定］ダイアログボックスを開くと，［DBPARTNER2］ウィンドウで指定した表中のすべての列が一覧で表示されます。複数表を選択した場合は，すべての表の列名が表示されます。選択した表のうち，一つの表の列だけを表示させる場合は，表名表示領域の［▼］をクリックして表示される表名の中から表を選択してください。列の一覧から条件を設定する列を選択して条件を設定してください。

［表名(T)］

抽出する表の表名が表示されます。

複数表を選択した場合は，「全表示」と表示されます。

［列属性］

選択した列の属性と長さが表示されます。

［列一覧(F)］

抽出する表中の列名の一覧が表示されます。

オプション設定でインデクス情報の表示を指定している場合は，列に定義されているインデクスの種別が表示されます。表示される内容については，「7.1.9　インデクス情報の表示」を参照してください。

［条件(O)］

比較条件式，NULL条件式及びLIKE条件式を設定します。

［一覧(N)］

設定した条件式が表示されます。

［設定(S)］［削除(D)］［変更(U)］［取消(R)］［↑(P)］［↓(W)］ボタン

［一覧(N)］の条件を操作します。

［関連(L)］

複数の条件を関連付けた場合にその内容が表示されます。

［OK］ボタン

設定内容を確認後，クリックします。［条件設定］ダイアログボックスが閉じます。

列を選択すると，ダイアログボックスにその列の属性が表示されます。表示される列の属性と長さ，及び列属性とデータベースのデータ型との対応については，「付録D　DBPARTNER2の列属性」を参照してください。

(2)　比較条件式の設定

(a)　形式

列　{=|<>|>|>=|<|<=}　定数

左辺と右辺を比較し，条件に合うデータを抽出します。右辺の定数は可変記号を設定できます。

比較条件式を設定するときの規則については，「8.　列と条件を設定するときの規則」を参照してください。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［条件(O)］の［▼］をクリックして，比較条件式を選びます。

［条件(O)］の右辺に設定する内容をキーボードから入力します。

［設定(S)］ボタンをクリックします。

［一覧(N)］に設定した条件式が表示されます。

複数の条件を設定するときは，1.〜4.の操作を繰り返してください。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定した条件が表示されます。

比較条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

(3)　NULL条件式の設定

(a)　形式

列　{IS NULL|IS NOT NULL}

ナル値を持つデータ，又はナル値を持たないデータを抽出します。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［条件(O)］の［▼］をクリックして，NOT NULLを選びます。

［設定(S)］ボタンをクリックします。

［一覧(N)］に設定した条件式が表示されます。

条件式の左に付けられた数字（この場合は1）は，条件式の項番です。条件式を関連付けるときに使用します。

参照：「4.2.6(11)　条件式を関連付ける」

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定した条件が表示されます。

NULL条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(4)　IN条件式の設定

(a)　形式

列　{IN|NOT IN}　(定数1，定数2，…，定数255)

右辺に指定した定数が含まれるデータ，又は含まれないデータを抽出します。右辺の定数は可変記号を設定できます。定数は，255 個まで設定できます。

IN条件式を設定するときの規則については，「8.　列と条件を設定するときの規則」を参照してください。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［IN...］ボタンをクリックします。

［IN条件式］ダイアログボックスが表示されます。

［種別(K)］で「列が値のいずれかと一致しているデータを検索」を選びます。

比較する値をキーボードから入力します。

比較する値が11個以上になる場合，［次頁(A)］ボタンをクリックし，次ページに設定します。前ページに戻る場合は，［前頁(B)］ボタンをクリックします。

［OK］ボタンをクリックします。

［条件設定］ダイアログボックスに戻ります。設定した条件が表示されます。

IN条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(5)　LIKE条件式の設定

(a)　形式

列　{LIKE|NOT LIKE}　文字パターン

右辺に指定した文字パターンと同じデータ，又は異なるデータを抽出します。右辺の文字パターンは可変記号を設定できます。

LIKE条件式を設定するときの規則については，「8.　列と条件を設定するときの規則」を参照してください。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［条件(O)］の［▼］をクリックして，LIKEを選びます。

［条件(O)］の右辺に設定する文字パターンをキーボードから入力します。

［設定］ボタンをクリックします。

［一覧(N)］に設定した条件が表示されます。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定した条件が表示されます。

LIKE条件を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(6)　BETWEEN条件式の設定

(a)　形式

列　{BETWEEN|NOT BETWEEN}　定数1 AND 定数2

右辺に指定した定数1と定数2の間（定数1及び定数2を含む）のデータ，又は間以外（定数1及び定数2を含まない）のデータを抽出します。右辺の定数は可変記号を設定できます。

BETWEEN条件式を設定するときの規則については，「8.　列と条件を設定するときの規則」を参照してください。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列をクリックします。

［BETWEEN...］ボタンをクリックします。

［BETWEEN条件式］ダイアログボックスが表示されます。

［種別(K)］で「列の値が，値1と値2の間のデータ検索」を選びます。

値1と値2をキーボードから入力します。

［OK］ボタンをクリックします。

［条件設定］ダイアログボックスに戻ります。設定した条件が表示されます。

BETWEEN条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(7)　列演算条件式の設定

(a)　形式

列　{=|<>|>|>=|<|<=}　列

値式　{=|<>|>|>=|<|<=}　値式

値式::=　{ {+|-} 一次子|値式 {+|-|*|/} }　定数

一次子::=　{列|定数}

（凡例）

::=　は，左辺を右辺のとおりに定義することを示します。この形式では，値式，一次子をそれぞれ右辺で定義します。

「+　-　*　/　(　)」及び定数を使って条件式を設定して，左辺と右辺を比較して条件に合うデータを抽出します。

演算を用いた条件式を設定するときの規則については，「8.　列と条件を設定するときの規則」を参照してください。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［列演算...］ボタンをクリックします。

数値属性以外の列を選択した場合は，［列演算...］ボタンはクリックできません。

［列演算条件式］ダイアログボックスが表示されます。選択した列が条件式入力領域に表示されます。

演算子，数字のボタンをクリックして左辺の条件式を設定します。

比較演算子をクリックします。

右辺の列を選びます。

［選択(S)］ボタンをクリックします。選択した列をダブルクリックしても選択できます。

右辺の条件式を設定します。

条件式を修正する場合は，［後退］ボタン，［削除］ボタンを使ってください。

条件式は，キーボードから入力することもできます。

［OK］ボタンをクリックします。

［条件設定］ダイアログボックスに戻ります。設定した条件が表示されます。

演算を用いた条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(8)　条件式を直接入力する

［直接入力(E)...］ボタンをクリックすると［条件直接入力］ダイアログボックスが表示されます。［条件直接入力］ダイアログボックスでは，where句に指定できる条件を直接入力できます。

(a)　［条件直接入力］ダイアログボックス

［条件直接入力］ダイアログボックスを次に示します。

［表名(T)］コンボボックス

表名の一覧を示すエリアです。

［属性:］ラベル，［長さ:］ラベル

［列一覧］で選択した列の属性，長さを表示します。

［列一覧(F)］リストボックス

［表名(T)］で選択した表に定義されている列名の一覧を表示します。

［選択(S)］ボタン

［列一覧］で選択した列名を［条件式］に入力します。

［条件式(C):］テキストボックス

作成した条件式が表示されます。

［数式］ボタン

演算の数式を入力します。

(b)　入力例

［条件設定］ダイアログボックスの［列一覧］から，条件を設定する列を選びます。

［直接入力(E)...］ボタンをクリックします。

［条件式直接入力］ダイアログボックスが表示されます。

条件式を入力します。

ダイアログボックスのボタンを使って，又は手入力でも入力できます。

各条件の規則については，「8.3　条件を設定するときの規則」を参照してください。

［OK］ボタンをクリックします。

［条件設定］ダイアログボックスの［一覧］に条件式が表示されます。

条件式直接入力を利用したときに抽出するデータを次に示します。

注

網掛け部分のデータが抽出されます。

(c)　規則

設定した条件の構文については，DBPARTNER2で構文チェックされません。

可変記号は指定できません。

(9)　表結合条件式の設定

(a)　形式

列　{=|<>|>|>=|<|<=}　列

(b)　［表結合条件式］ダイアログボックス

［表結合条件式］ダイアログボックスを次に示します。

［表1(L)］

外表にする表名を選択します。JOIN検索の場合はすべての表名が表示されます。

［列名］

ON条件に指定する［表1(L)］の列を選択します。

［属性］

［表1(L)］の［列名］で選択された列の属性が表示されます。

［表2(R)］

内表にする表名を選択します。JOIN検索の場合はすべての表名が表示されます。

［列名］

ON条件に指定する［表2(R)］の列を選択します。

［属性］

［表2(R)］の［列名］で選択された列の属性が表示されます。

［演算子(C)］

比較演算子を指定します。

［結合の内容(1)］

WHERE句に列比較条件を使用したSQLを作成します。

［結合の内容(2)］

LEFT OUTER JOINを使用したSQLを作成します。

［結合条件］

このダイアログボックスで設定した内容から作成される，表結合条件が表示されます。

(c)　入力例

次に示す例を基に，入力例を説明します。

（例）

結合する表:仕入れ表と在庫表

結合条件　:仕入れ表の列「コード」=在庫表の列「コード」

［条件設定］ダイアログボックスの［列一覧］から条件を設定する列を選んでから，［表結合...］ボタンをクリックします。

［表結合条件式］ダイアログボックスが表示されます。

表1に外表にする表を選択し，結合条件にする列を選択します。

列名表示領域の下には列の属性が表示されます。

表2に結合する表を選択し，結合条件にする列を選択します。

列名表示領域の下には列の属性が表示されます。

条件演算子を設定します。

結合種別を選択します。

1

表1の列と表2の列を比較して条件に合う行が結合されて抽出されます（内結合）。この結合種別は「列比較条件式」と同様です。

2

表1のすべての行と，条件を満たす表2の行が抽出されます（外結合）。

結合種別を選択すると結合条件表示領域に表示されます。

（例）USER01.仕入れ.商品コード = USER01.在庫.在庫商品コード

補足

［表選択］ダイアログボックスで二つ以上の表を選択している場合，「2」は選択できません。

［OK］ボタンをクリックします。

［条件設定］ダイアログボックスに戻ります。

設定した条件が表示されます。外結合の場合，条件一覧には「*」が付いて表示されます。

1選択時：（例）USER01.仕入れ.商品コード=USER01.在庫.在庫商品コード

2選択時：（例）USER01.仕入れ　LEFT OUTER JOIN USER01.在庫 ON USER01.仕入れ.商品コード　=　USER01.在庫.在庫商品コード

一度設定した表結合条件の結合種別は変更できません。結合種別を変更するときは，条件式をいったん削除してから再設定してください。

注意

同一表の列を表結合条件式の両辺に設定した場合は，通常の列比較条件式となります。

外結合（結合種別　2:）の注意事項

表結合条件式を設定できるのは，ORACLE，HiRDB，HADBの場合です。

表結合条件式に複数の条件を設定する場合，表1と表2に指定する表の順序が同じでなければなりません。

表結合条件式は，選択された表が二つの場合だけ設定できます。

表結合条件式に複数の条件を設定する場合，各条件はすべてANDで関連付けされます。

表結合条件は，条件設定画面の条件一覧リストの先頭に表示されます。

集合関数を設定して表結合条件式を指定すると，件数を表示できないので注意してください。

(10)　複数の条件式を設定する

複数の条件式を設定できます。条件式を多く設定して，一覧に表示しきれない場合は，一覧の右端にスクロールバーが表示されます。スクロールして条件式を表示させてください。設定できる条件式は255個までです。設定の方法は，(2)〜(8)までの各条件式の設定方法を参照してください。各条件式を関連付けないと，ANDで関連付けられます。関連付けについては，「4.2.6(11)　条件式を関連付ける」を参照してください。

(a)　入力例

複数の条件式を設定すると，設定した条件式が表示されます。

複数の条件式を設定したときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

(11)　条件式を関連付ける

(a)　形式

条件関連::= { NOT {条件関連|条件} | 条件 AND {条件関連|条件}

| 条件 OR {条件関連|条件} }

（凡例）

::=　左辺を右辺のとおりに定義することを示します。この形式では，条件関連を右辺で定義します。

設定した複数の条件を関連付けることができます。関連付けは，条件式の左に付けられた番号，及び次に示す論理演算子をキーボードから入力して設定します。すべて半角で入力してください。条件式を関連付けた式が，入力領域より長い場合，領域内で式がスクロールされます。

AND：論理積を示します。

（例）

「1 AND 2」の場合，1と2の両方の条件を満たすデータを抽出対象とします。

OR：論理和を示します。

（例）

「1 OR 2」の場合，1か2のどちらかの条件を満たすデータを抽出対象とします。

NOT：条件式を否定します。

（例1）

「NOT 1」の場合，1の条件を満たさないデータを抽出対象とします。

（例2）

「NOT 1 AND 2」の場合，1の条件は満たさないで，2の条件は満たすデータを抽出対象とします。

(　)：括弧内の条件を優先します。

（例）

「1 AND (2 OR 3)」の場合，2か3のどちらかの条件を満たし，かつ1の条件を満たすデータを抽出対象とします。

AND，OR，及びNOTの前後はスペースを入力してください。

関連付けを設定しないと，ANDが仮定されます。論理演算子の優先順位は，括弧，NOT，AND，ORです。

次の条件式は，ほかの条件式と関連付けできません。

表結合条件式

(b)　入力例

［条件設定］ダイアログボックスの［条件関連］入力領域に，条件式を関連付けた式をキーボードから入力します。

条件一覧から条件式を削除した場合，「1」「2」「3」の番号も自動的に変更されますが，［条件関連(L)］の番号は変更されません。再び，条件式を関連付けてください。

条件式を関連付けたときに抽出するデータの例を次に示します。

注

網掛けの部分のデータが抽出されます。

注

網掛けの部分のデータが抽出されます。

(12)　条件を削除，又は変更する

式を誤って設定した場合，条件一覧中の条件式をクリックした後，［削除(D)］ボタンをクリックして削除するか，［変更(U)］ボタンをクリックして変更します。

(a)　比較条件式，NULL条件式，LIKE条件式，及び列比較条件式の場合

条件式を削除する場合，条件式を選んでから［削除(D)］ボタンをクリックします。

条件式を変更する場合，条件式を選んでから［変更(U)］ボタンをクリックします。その後は，変更する個所によって次のように操作方法が違います。

列名を変更する場合

［列一覧］から変更後の列名を選択して，クリックしてください。

条件を変更する場合

［条件(O)］の［▼］をクリックして，変更後の条件を選択してください。

条件値を変更する場合

変更したい値をキーボードから入力してください。

条件式を変更する場合

列名，条件，及び条件値のすべてを変更するか，又はいったん条件式を削除して設定し直してください。

列比較条件式の左辺の列名を変更する場合

列一覧から変更後の列名を選択して，クリックしてください。

列比較条件式の右辺の列名を変更する場合

［列比較］ボタンをクリックし，その後，列一覧から変更後の列名を選択してクリックしてください。

入力例

［条件設定］ダイアログボックスの［条件一覧］から，変更する条件式を選びます。

［変更(U)］ボタンをクリックします。

選択した条件式が表示されます。

条件式を変更します。

［設定(S)］ボタンをクリックします。

途中で変更をやめたい場合は，［取消(R)］ボタンをクリックしてください。［変更(U)］ボタンをクリックする前の状態に戻ります。

変更した条件式が表示されます。

(b)　比較条件式，NULL条件式，及びLIKE条件式以外の場合

入力例

［条件設定］ダイアログボックスの［条件一覧］から，変更する条件式をクリックします。

選択した条件式を変更したい場合，［変更(U)］ボタンをクリックすると，その条件式を設定したダイアログボックスが開きます。

選択した条件式を削除したい場合，［削除(D)］ボタンをクリックすると，その条件式は削除されます。

［BETWEEN条件式］ダイアログボックスが表示されます。

変更する条件をキーボードから入力します。

［OK］ボタンをクリックします。

変更した条件式が表示されます。

4.2.7　可変記号を使ったデータの抽出

データを抽出する条件を設定する条件式に，可変記号を使えます。可変記号とは，「&」で始まる文字列です。条件設定時に条件式に可変記号を設定しておくと，実行時に可変記号の部分の値を入力するだけでデータを抽出できます。

可変記号は，比較条件式，IN条件式，LIKE条件式，BETWEEN条件式に設定できます。通常は，可変記号の設定時に設定した初期値が実行値となってデータが抽出されます。実行値を変更したい場合は，［オプション設定］ダイアログボックスの［表示］タグで［手順実行時の実行値入力画面表示(E)］をオンにして［実行値入力］ダイアログボックスを表示させてください。

可変記号の操作で使う［可変記号入力］ダイアログボックスと［実行値入力］ダイアログボックスを次に示します。

(1)　［可変記号入力］ダイアログボックス

可変記号を入力します。

タイトルバー

「可変記号入力」と表示されます。

［可変記号名(V)］

可変記号名を指定します。

［初期値(D)］

可変記号に初期値を設定する場合に指定します。オプションを設定すると，実行時に初期値の代わりに実行値を入力してデータを抽出できます。

［OK］ボタン

指定した内容で条件式に可変記号を設定します。

［キャンセル］ボタン

可変記号の入力を取り消します。

(2)　［実行値入力］ダイアログボックス

可変記号に対する実行値を入力します。

タイトルバー

「実行値入力」と表示されます。

属性

可変記号を設定した列の列属性が表示されます。

長さ

可変記号を設定した列の定義長が表示されます。

可変記号

条件式に設定した可変記号の&に続く文字列が表示されます。

実行値

可変記号の部分に入力する実行値を設定します。

［OK］ボタン

設定された実行値を確定します。

［キャンセル］ボタン

実行値の入力を取り消します。

(3)　可変記号を条件式に設定する場合

可変記号を条件式に設定する方法を説明します。可変記号を条件式に設定する操作を次の図に示します。

図4‒5　可変記号を条件式に設定する操作

注※

［BETWEEN...］ボタンを押して，［BETWEEN条件式］ダイアログボックスを表示させても操作できます。

また，ここで比較演算子と［可変記号(V)...］を選択しても操作できます。

［DBPARTNER2］ウィンドウで抽出する表を選択します。

［条件設定(C)...］ボタンをクリックします。

［条件設定］ダイアログボックスが表示されます。

［条件設定］ダイアログボックスで条件を設定する列を選んでから，条件式を設定します。

比較条件式，LIKE条件式の場合は，次の手順で設定してください。

［条件(O)］で比較演算子（=，<>，>，>=，<，<=）又はLIKE条件式を選びます。

［可変記号(V)...］ボタンをクリックします。

［可変記号入力］ダイアログボックスが表示されます。

IN条件式，BETWEEN条件式の場合は，次の手順で設定してください。

［IN...］，［BETWEEN...］ボタンのどれか一つをクリックします。

各ダイアログボックスが表示されます。

各ダイアログボックスで条件を設定します。

［可変記号(V)...］ボタンをクリックします。

［可変記号入力］ダイアログボックスが表示されます。

可変記号名と初期値を設定して，［OK］ボタンをクリックします。

［条件設定］ダイアログボックスが表示されて，条件式一覧に設定した条件式が表示されます（条件式は「&可変記号名〔（初期値）〕」という形式で表示されます）。ほかに条件式が必要であれば設定してください。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。設定内容を確認してください。

これで可変記号を条件式に設定する操作が終了しました。

［抽出(E)］ボタンをクリックすると，4.で設定した初期値が実行値となり，データが抽出されます。

(4)　可変記号に対する実行値を入力して手順ファイルを実行する場合

可変記号を設定した抽出を手順ファイルに登録して，手順ファイルを実行します。

(3)での操作が終了した後に［DBPARTNER2］ウィンドウの［手順(B)］−［登録(S)...］メニューを選ぶと，(3)での操作が登録されます。

可変記号，に対する実行値を入力して手順ファイルを実行する方法を説明します。この場合，あらかじめ［オプション設定］ダイアログボックスの［表示］タグで［手順実行時の実行値入力画面表示(E)］をオンにしておきます。これで，手順ファイルの実行時に［実行値入力］ダイアログボックスを表示できます。

オプションを設定しなければ，可変記号を設定したときに設定した初期値が実行値となります。

可変記号に対する実行値を入力して手順ファイルを実行する操作を次の図に示します。

図4‒6　可変記号に対する実行値を入力して手順ファイルを実行する操作

［DBPARTNER2］ウィンドウで［ツール(X)］−［オプション(O)...］メニューを選びます。

［オプション設定］ダイアログボックスが表示されます。

［表示］タグで［手順実行時の実行値入力画面表示(E)］をクリックします。

参照：「7.1.3　手順ファイル実行時の［実行値入力］ダイアログボックス表示」

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［DBPARTNER2］ウィンドウの［手順(B)］−［実行(E)...］メニューを選びます。

［実行値入力］ダイアログボックスが表示されます。

可変記号に対する実行値を入力してから，［OK］ボタンをクリックします。

抽出が実行されます。正常に処理が終了すると自動的に閉じ，［DBPARTNER2］ウィンドウに戻ります。

これで可変記号を設定した手順ファイルの実行が終わりました。

？パラメタに対する実行値も入力できます

［SQL入力］ダイアログボックスで？パラメタを指定したSQLを手順ファイルに登録しておくと，手順ファイル実行時に［実行値入力］ダイアログボックスが表示されます。ここで？パラメタに対する実行値を入力してください。？パラメタの指定については，「7.2.1(1)　［パラメタ設定］ダイアログボックス」を参照してください。

実行値を入力するときの規則

実行値は255文字まで入力できます。

実行値の属性，長さはチェックされません

ダイアログボックスで可変記号名，列属性，定議長は変更できません。

実行値が入力されない場合はNULLが仮定されます。

(5)　規則と注意

(a)　可変記号名の規則

使える文字は，半角片仮名，半角英数字，又は全角文字です。

先頭文字は，半角片仮名，半角英字，又は全角文字です。

指定できる長さは，&を除いて254バイトまでです。

前後に指定した半角スペースは，無視されます。

指定する文字列中に半角スペースは指定できません。

可変記号を設定する場合は，カーソルが可変記号名を入力する部分に位置付けられていることを確認してください。位置付けられていないと［可変記号(V)...］ボタンは淡色で表示されて，選択できません。

可変記号は，1回の抽出に対して255個まで設定できます。

(b)　初期値の規則

指定できる属性は，文字定数，数値定数です。

指定できる定数の規則は，［条件設定］ダイアログボックスで条件式を設定するときと同じです。規則については，「8.　列と条件を設定するときの規則」を参照してください。

一つの可変記号名に対して指定できる初期値は一つです。二つ以上の初期値は指定できません。

条件式の右辺に定数が指定されているときに，［可変記号(V)...］ボタンをクリックすると，右辺の定数が初期値として表示されます。

初期値は省略できます。

(c)　実行値の規則

指定できる属性は，文字定数，数値定数です。

指定できる定数の規則は，［条件設定］ダイアログボックスで条件式を設定するときと同じです。規則については，「8.　列と条件を設定するときの規則」を参照してください。

4.2.8　抽出するデータの件数の制限

データを抽出するときに，その件数を指定できます。例に示す抽出を実行するときに，件数を制限すると便利です。ただし，転送先をデータベースにした場合は，件数を制限できません。

（例）

抽出するデータをソートして上位10件だけを抽出する

表計算ソフトに表示できるデータ量を考慮して抽出する件数を制限する

大量のデータを抽出する前に指定した件数のデータを抽出して，その内容を確認する

(1)　抽出データの件数を指定する

抽出データの件数は，［DBPARTNER2］ウィンドウの［件数制限(L):］に指定します。件数を入力する場合は，1〜999,999,999の範囲で指定してください。また，あらかじめ設定された値を選ぶ場合は，次の値から選択できます。

なし，1，2，3，4，5，6，7，8，9，10，20，30，40，50，100，200，300，400，500，1000，2000，3000，4000，5000，10000

件数を指定した後に［OK］ボタンをクリックして抽出を実行すると，限定された件数のデータが抽出されます。

抽出データの件数を制限しない場合には，［件数制限(L)］に値を指定しないで（スペース，又はなしを入力して）ください。

4.2.9　データの確認（抽出，絞り込み（条件付加），絞り込み（保存利用））

抽出条件を設定して，実際にデータを抽出する前に，メモ帳（Notepad.exe）などに抽出するデータを貼り付けて，抽出するデータを確認できます。確認後，次の操作ができます。

データの抽出

確認したデータを抽出する

絞り込み（条件付加）

抽出する条件を絞り込むために，抽出する条件を再設定する

絞り込み（保存利用）

確認したデータを利用するために表としてデータベースに保存する

データ確認で使う［データ確認］ダイアログボックスを次に示します。

タイトルバー

「データ確認」と表示されます。

件数表示領域

抽出対象となるデータの件数が表示されます。

［抽出(S)］オプションボタン

確認したデータを抽出します。

［絞り込み(P)］オプションボタン

条件付加，又は保存利用が選択できます。

［条件付加(C)］オプションボタン

［条件設定］ダイアログボックスを表示します。

［保存利用(U)］オプションボタン

［表定義］ダイアログボックスを表示します。確認したデータを表として定義します。

［OK］ボタン

指定した内容を確定して，次の操作に移ります。

［キャンセル］ボタン

可変記号の入力を取り消します。

(1)　抽出するデータを確認する

データ確認の操作を次の図に示します。

図4‒7　データ確認の操作

［DBPARTNER2］ウィンドウの［ツール(X)］−［オプション(O)...］メニューを選びます。

［オプション設定］ダイアログボックスが表示されます。

［抽出］タグを選んでから，［データ確認(I)］チェックボックスをオンにします。

確認するデータの件数を設定（初期値は5件）してから，［表示プログラム(A)］の［...］ボタンをクリックします。

［表示アプリケーション設定］ダイアログボックスが表示されます。

確認するデータを貼り付けるアプリケーションを選択してから，［OK］ボタンをクリックします。

［オプション設定］ダイアログボックスに戻ります。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［DBPARTNER2］ウィンドウで抽出する表，列，条件，転送先など抽出する条件を設定してから，［確認(P)...］ボタンをクリックします。

［データ確認］ダイアログボックスが表示されます。同時に抽出するデータが，貼り付けられたアプリケーションが表示されます。データを確認してください。

(2)　確認したデータの抽出・絞り込み（条件付加・保存利用）

データ確認後の操作は，［データ確認］ダイアログボックスから始めます。

確認したデータの抽出・絞り込み（条件付加・保存利用）の操作を次の図に示します。

図4‒8　確認したデータの抽出・絞り込み（条件付加・保存利用）の操作

(a)　確認したデータを抽出する場合

［データ確認］ダイアログボックスの［抽出(S)］オプションボタンと［条件付加(C)］オプションボタンをオンにして，［OK］ボタンをクリックします。

抽出が実行されます。正常に処理が終了すると自動的に閉じて，［DBPARTNER2］ウィンドウに戻ります。

(b)　抽出するデータを更に絞り込む場合

［データ確認］ダイアログボックスの［絞り込み(P)］オプションボタンと［条件付加(C)］オプションボタンをオンにして，［OK］ボタンをクリックします。

［条件設定］ダイアログボックスが表示されます。

再度，抽出する条件を設定します。

(c)　確認したデータを表として保存する場合

［データ確認］ダイアログボックスの［絞り込み(P)］オプションボタンと［保存利用(U)］オプションボタンをオンにして，［OK］ボタンをクリックします。

［表定義］ダイアログボックスが表示されます。

確認したデータを表として定義します。

参照：「9.1　表定義の概要」

［OK］ボタンをクリックします。

設定した内容で表が保存されます。保存処理が終了すると，［DBPARTNER2］ウィンドウが表示されます。

(3)　注意

数に表示される最大値は，4,294,967,135件です。この件数を超えると，「?」が表示されます。

該当するデータが0件の場合，［データ確認］ダイアログボックスは表示されません。

4.2.10　バイナリデータを含む表の抽出

LONG VARBINARY属性の列はバイナリデータとして抽出，更新できます。

(1)　操作

［表名(T)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

抽出する表を選択します。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［列設定(O)...］ボタンをクリックします。

LONG VARBINARY属性の列を選択します。

［種別変更(F)...］ボタンをクリックします。

［ファイル種別］ダイアログボックスが表示されます。

［ファイル種別(F)］にバイナリデータを格納するファイル種別を1〜4文字で入力，又は選択します。

［OK］ボタンをクリックします。

［列設定］ダイアログボックスに戻ります。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

抽出する条件に関しては，LONG VARBINARY属性以外の列であれば条件を設定できます。［条件設定(C)］ダイアログボックスを開いて条件を設定してください。

［転送先(O)...］ボタンをクリックします。

［転送先］ダイアログボックスが表示されます。

転送先としてデータ表示ウィンドウを選択してください。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［抽出］ボタンをクリックします。

［データ表示］ウィンドウにデータが抽出されました。

これで抽出が完了しました。

補足

ファイル種別設定ダイアログボックスで使用できない文字を次に示します。

'¥'，'/'，':'，','，';'，'*'，'?'，'''，'<'，'>'，'|'

ファイル種別は，次に示す中から選択することもできます。

・gif　・xls　・bmp　・doc　・ppt　・wav　・jpg　・mpg

(2)　注意

データの転送先は，［データ表示］ウィンドウ以外指定しないでください。

［データ表示］ウィンドウ以外を指定すると，エラーとなって抽出できません。

［列設定］ダイアログボックスは必ず開いてください。

列選択をしないと，抽出時にエラーとなります。

［列設定］ダイアログボックスの［選択列］リストに［列一覧］の内容と異なった選択をすると抽出はできますが，更新はできなくなります。

4.2.11　見出し辞書の使用

抽出する表や列の名称を，見出し辞書に登録した名称で表示できます。通常，［DBPARTNER2］ウィンドウで表示される表名や列名は，データベースで定義された名称ですが，表や列に対する任意の名称を辞書に登録しておくと，操作時に登録した名称が表示されます。任意の名称を登録する辞書を見出し辞書といいます。見出し辞書を使うと，使い慣れた表現の表名や列名で操作できます。見出し辞書に表や列を登録する操作については，「9.5　見出し辞書の編集」を参照してください。

見出し辞書を使うと，表名や列名を取得するときにサーバにアクセスしないで見出し辞書にアクセスします。このため，サーバにアクセスする分の待ち時間を短縮できます。

見出し辞書は，通常，DBPARTNER2が動作するフォルダにありますが，［オプション設定］ダイアログボックスで，見出し辞書の参照先を変更できます。

(1)　操作

見出し辞書を使用してデータを抽出する方法を説明します。見出し辞書を使ってデータを抽出する操作を次の図に示します。

図4‒9　見出し辞書を使ってデータを抽出する操作

［DBPARTNER2］ウィンドウの［ツール(X)］−［オプション(O)...］メニューを選びます。

［オプション設定］ダイアログボックスが表示されます。

参照：「7.1　オプションの設定」

［見出し辞書］タグをクリックしてから［見出し辞書(D)］チェックボックスをオンにします。

見出し辞書のコンボボックスから見出し辞書の使用を設定します（［DBPARTNER2の情報を使用する］を選ぶ）。

辞書フォルダの［...］ボタンをクリックして，見出し辞書の参照先を変更することもできます。

［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

［DBPARTNER2］ウィンドウの［表名(T)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。見出し辞書に登録されている表とその表の接続先が表示されます。

補足

接続先が異なる表は，結合できません。

抽出する表を選択して，［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

列を選択する場合は，［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスが表示されます。列一覧には，見出し辞書に登録した列名が表示されます。

抽出する列を選択して，［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。このほかに必要な条件があれば設定します。

［抽出(E)］ボタンをクリックします。

抽出が実行されます。正常に処理が終了すると自動的に閉じて，［DBPARTNER2］ウィンドウに戻ります。

これで見出し辞書を使ったデータの抽出が終わりました。

(2)　注意

見出し辞書を使うときは，［オプション設定］ダイアログボックスの［見出し辞書(D)］チェックボックスをオンにします。

4.3　Excel連携拡張機能

Excel連携は抽出処理だけで利用するとき，次のような機能が使えます。

貼付オプション機能

抽出するときのシート形式をあらかじめ設定できます。

抽出処理はDBPARTNER2からでも，Excelからでもできます。抽出したデータは自由に加工できます。抽出処理だけの場合，更新情報は作成する必要はありません。また，抽出データはExcelを終了すると保存されないので，抽出データを加工したい場合は必ず名前を付けて保存してください。

Excelに［DBPARTNER2］メニューを追加する方法については，「3.2.2(1)　Excel連携」を参照してください。

4.3.1　貼付オプション機能

Excel連携では抽出データの利用方法が決まっている場合，利用方法に合わせてデータの抽出形式を設定できます。貼り付ける場所をあらかじめ設定しておきたい場合は，［貼付オプション］メニューをチェックしておきます。これで，貼付オプション機能が有効になります。簡単に貼り付け位置を設定したいときは［貼付オプション］ダイアログボックスを使うと便利です。特に定型業務などで，抽出時に使う手順ファイルや，データを貼り付けるシート名まで設定したいときは，貼付オプションパラメタを使うと便利です。

(1)　［貼付オプション］ダイアログボックスを使った抽出

［貼付オプション］ダイアログボックスは，DBPARTNER2から抽出するときはデータを貼り付ける直前に，Excelから抽出するときは［抽出］を選択したときに表示されます。

［貼付オプション］ダイアログボックスについて説明します。

［新規ブック］チェックボタン

抽出結果を新規ブックに貼り付ける場合に使用します。

［既存シート］チェックボタン

抽出結果を既存のシートに貼り付ける場合に使用します。既存のシートとは，［抽出］メニューを押したときに表示されているシートです。

［データ貼付位置：］テキストボックス

抽出結果を貼り付けるときの貼り付け位置を指定します。

［シートの書式を引き継ぐ］チェックボックス

抽出結果を貼り付ける場合，シートの書式設定を有効にしたいときに使用します。［既存シート］チェックボタンにチェックしている場合だけ有効です。

［列名を貼り付けない］チェックボックス

抽出結果を貼り付ける場合，列名が不要なときに使用します。

［シート名変更：］テキストボックス

抽出結果を貼り付けたシートの名称を任意の名称に変更したい場合に指定します。

注意

指定したデータの貼り付け位置を基点として抽出結果を貼り付けた場合，Excelシートの制限を超えるときはDBPARTNER2のエラーとなります。

シート名の変更で，既存のシート名称を指定した場合には，Excelがシート名称を重複しない名称に変更します。どのような名称になるかは，使用するExcelのバージョンによって異なります。

(2)　貼付オプションパラメタを使った抽出

貼付オプションパラメタは，［貼付オプション］ダイアログボックスで設定する情報をExcelシートに記述しておくための機能です。

貼付オプションパラメタを記述したシートを開いて，Excel連携での抽出を実行すると，常に一定条件でデータベースからデータを抽出できます。

(a)　操作

Excelを起動します。

［貼付オプション(P)］をチェックします。

パラメタを有効にするために必要です。

パラメタシートを作成します。

パラメタシート名は，必ず「DBP2ParameterSheet」にしてください。

パラメタシートのパラメタについては「(b)パラメタの詳細」，設定の規則については「(c) 規則」を参照してください。

パラメタシート以外のシートをアクティブにします。

［DBPARTNER2］−［抽出］を選択します。

DBPARTNER2が起動して，抽出結果が指定位置に貼り付きます。

(b)　パラメタの詳細

パラメタシートで設定できるパラメタと，その内容について次の表に示します。

表4‒6　　設定できるパラメタとその内容

パラメタ名

内容

CatalogFileName

実行する手順ファイル名を指定します。省略時には，手順ファイルなしで実行します。ファイル名は完全パスで指定してください。

KeepFormat

シートに設定された書式を引き継ぐかどうかを設定します。省略時にはOFFが仮定されます。

ON　：シートに設定された書式を引き継ぎます。

OFF ：シートに設定された書式を引き継ぎません。

ColumnName

抽出結果に列名を貼り付けるかどうかを設定します。省略時にはONが仮定されます。

ON　：抽出結果に列名を貼り付けます。

OFF ：抽出結果に列名を貼り付けません。

Position

抽出結果を貼り付ける開始位置を指定します。省略時には，［抽出］メニューを選択したときのアクティブセルの位置となります。

PasteSheetName

抽出結果を貼り付けるシートの名称を指定します。省略時には［抽出］メニューを選択したときのアクティブシートの名称となります。

SheetName

抽出結果を貼り付けたシートを任意の名称に変更したい場合に指定します。省略時には，［抽出］メニューを選択したときのアクティブシートの名称となります。

アクティブシート以外の既存のシート名を指定した場合は，エラーとなりシート名は変更されません。データはアクティブシートに貼り付きます。

QueryEnd※

抽出完了後に呼び出すマクロ名を指定します。マクロは一つの引数を持つマクロを指定してください。マクロの作成例を次に示します。

　　Sub QueryEndSam (Rc As Integer)

　　End Sub

Rc As Integerは引数です。抽出が正常に終了したときはRcに0が返されます。正常に終了しなかったときはRcに-1が返されます。

注※

QueryEndで呼び出すマクロはアドイン（ファイル名：xxxx.xlam）として登録しておく必要があります。

(c)　規則

Anセルにパラメタ，Bnセルに値を設定します。

パラメタは，シートの先頭セル（A1セル）から順に設定してください。

複数のパラメタを設定する場合は，行を空けないで設定してください。空白の行があると，それまでの行を有効とし，空白行以降の行の設定は無効となります。

大文字／小文字は同一の文字として扱います。

パラメタの指定順序は任意です。

同じパラメタを複数指定した場合は，最後のパラメタが有効となります。

パラメタとして不正な文字列を設定してもエラーとなりません。

パラメタの値を省略した場合や，範囲外の値を設定した場合は，省略値が仮定されます。

(d)　Excelからの自動抽出

データベースからの抽出を自動化したいときは，ExcelのAuto_Openプロシジャと貼り付けオプションパラメタを組み合わせます。Auto_Openプロシジャに次の斜体部分を追加してください。

Sub Auto_Open()
Application.Run Macro:="'dbp2exl(64)2019.xlam'!V2MenuRTVEXL"
End Sub

Excelのブックを開くだけで手順ファイルが実行され，データベースからのデータが指定したシート位置に貼り付きます。

使用例

DBPARTNER2から抽出したデータをExcelで作成した帳票に貼り付けます。

準備

帳票形式を作成します。

ここでは"Sheet1"に作成します。

帳票を作成したシートと同じブック内に貼付オプションパラメタシート，Auto_Openプロシジャと，抽出後に呼び出すマクロ"QueryEndSam"を作成しておきます。

作成したブックに名前を付けて保存します。

Book1という名前を付けました。

実行

保存したブックを開くと次の流れで帳票が完成します。

DBPARTNER2が起動されます。

パラメタシートに指定した手順ファイルに従って，抽出データがデータベースから呼び出されます。

パラメタシートに指定したシート"Sheet1"の指定位置"B3"に，抽出データが貼り付けられます。

パラメタシートに指定したマクロ"QueryEndSam"によって，帳票の"金額"，"合計"が算出され，［抽出完了］のメッセージボックスが表示されました。

これで帳票"仕入票"が完成しました。

5　データの更新（［抽出］メニュー）

この章では，データベースから抽出したデータを更新する操作について説明します。

5.1　Excelからのデータの更新

DBPARTNER2では，Excelと連携するためのアドインマクロ（以降，DBPARTNER連携マクロと表記します）を提供しています。DBPARTNER連携マクロを使うと，Excelのアドインマネージャに登録するだけでExcelとDBPARTNER2を連携できます。DBPARTNER連携マクロをExcelのアドインマネージャに登録する操作については，「3.2.2(1)　Excel連携」を参照してください。

DBPARTNER連携マクロをExcelのアドインマネージャに登録すると，ExcelにDBPARTNER2のリボンができます。

ExcelからDBPARTNER連携マクロを使ってデータベースのデータを更新する操作を次の図に示します。

図5‒1　Excelからデータを更新する操作（1）

DBPARTNER2と連携してデータベースを更新するときは，更新するデータをデータベースから抽出する必要があります。

更新用データの抽出は，Excelからでも［DBPARTNER2］メインウィンドウからでもできます。更新用データを抽出するときに列を選択すると，更新できなくなります。表の列すべてを抽出してください。

抽出したデータは，Excelのウィンドウ上で編集します。編集したデータがデータベースの表に上書きされます。

データベースのデータの中から更新するデータを決定するときに，条件を設定できます。条件を設定して決定する方法については，「5.2.4　条件を設定して更新する行を決定する」を参照してください。

5.1.1　データの更新方法

データを更新する操作と注意について説明します。

(1)　操作

データを更新する操作を次の図に示します。

図5‒2　Excelからデータを更新する操作（2）

Excelを起動します（又はDBPARTNER2を起動します）。

手順ファイルを利用してデータを抽出する場合は，［手順ファイル利用(C)］メニュー（又は［DBPARTNER2］ウィンドウから［手順(B)］−［実行(E)］メニュー）を選びます。

［DBPARTNER2手順ファイル実行］ダイアログボックスが表示されます。

手順ファイルを利用しない場合は［抽出(R)］を選択します。［DBPARTNER2］ウィンドウが表示されるので抽出条件を設定してください。

オートフィット機能で抽出するデータの列幅を自動調整する場合は，［オートフィット(A)］を選んでおきます。また，［罫線］を選んでおくと，データを貼り付けた後で有効範囲が自動的に罫線で囲まれます。

補足

抽出するデータの転送先は「Excel連携」としてください。

利用する手順ファイルを選んでから，［OK］ボタンをクリックします。

指定された手順ファイルが実行されます。転送が完了すると，更新に必要な情報（以降，更新情報と表記します）を作成するかを確認するメッセージが出力されます。

補足

更新情報とは，DBPARTNER2が更新するデータをマッピングするために内部的に持つデータです。

［はい(Y)］ボタンをクリックします。

抽出データのシートの次にシート保護されてデータが退避されます。このシートはDBPARTNER連携で使うため，変更したり削除したりしないでください。

［いいえ(N)］ボタンをクリックすると，更新情報が作成されないため更新できなくなります。

補足

抽出処理だけの場合は［いいえ(N)］ボタンをクリックしてください。

データを編集します。

データを変更する：抽出したデータを変更してください。

データを追加する：新規行を作成してください。

データを削除する：抽出したデータから削除する行を削除してください。

補足

抽出したデータのある行をコピーして新しく行を作成した場合は，シート上で上にある方のデータが変更対象となって，そのデータ以外は追加対象となります。

［更新(U)］を選びます。

データベース上のデータが更新されます。

データベース上のデータが5.で編集したデータに変わります（変更したデータは，変更した値に変わります。追加したデータはデータベース上に追加されます。削除したデータはデータベース上から削除されます）。

補足

DBPARTNER2では，抽出したデータの行と列にそれぞれを識別するためのIDを付けています。このIDを基に更新情報と編集したデータとを比較してデータベースを更新します。IDは抽出したデータのA列のメモ情報に格納されます。このためメモ情報を変更するとデータベースが正しく更新できなくなるので注意してください。

再び更新する場合には，抽出から実行してください。Excelのシートに残っているデータを編集して，再び更新できません。

Excel側から連携した場合は，Excelを終了するとDBPARTNER2も同時に終了します。

更新処理を中断した場合

次の場合，更新処理が中断されます。

データベースを更新中に［キャンセル］ボタンをクリックする。

更新処理中にエラーが発生する。

更新処理が中断された場合，それまでの処理が有効か無効かを決定する方法を，接続先定義ファイルのパラメタによって指定できます。

接続先定義ファイルのUPDFINパラメタを指定すると，その指定によって，更新処理を有効にするかを確認するメッセージが出力され，処理の有効，無効を決定できます。ただし，UPDFINパラメタの指定を省略すると，確認のメッセージが出力されないで更新処理が無効になります。

更新処理時間を短縮するために更新するデータだけを絞り込んで抽出してください

DBPARTNER2は，更新処理時にExcelのシート上の全データをチェックしています。このため，更新対象でないデータを抽出すると不要な時間が掛かります。更新用のデータは更新するデータだけに絞り込んで抽出してください。

データ追加だけを目的とした抽出の場合

データベースへデータ追加の目的で抽出する場合は，［DBPARTNER2］ウィンドウの［抽出］−［データ追加］メニューを選択することもできます。この場合，表中の列名だけが抽出されるため，ずべてのデータを抽出する場合と比べて抽出時間が短くなります。詳細は，「5.3　データベースへのデータ追加」を参照してください。

(2)　データを更新するときの制限

DBPARTNER2の制限で，データを更新できない場合があります。

次に示す表を抽出した場合，Excelのウィンドウでデータベースを更新するコマンドが淡色で表示されて，選択できないので注意してください。

列数が256以上ある

倍精度数値又は単精度数値属性の列がある

更新条件の解除，又は接続先定義ファイルの設定で，UPDUNITパラメタをROWIDに設定することで対応できます。

列の定義長が256バイト以上の列がある

16進文字の列で列の定義長が128バイト以上の列を含む表

グループ分け，又は集合関数が設定されている

［列設定］ダイアログボックスで列を追加，削除した，又は列の順序を並べ替えた場合，抽出できません。ただし，情報ファイルで設定すれば，選択できます。詳細は，「2.5.2(8)　列選択をした状態での更新に関する設定−UpdateOptionセクション」を参照してください。

複数表が選択されている

更新条件となる列がない（［列選択］ダイアログボックスの［列一覧］ですべての列に*がついている）場合は更新できません。

貼付オプションを指定して抽出した場合は更新できません。

属性がVARBINARY，LONG VARBINARY，LONG VARCHARの列がある

DBPARTNER2の制限で，データを更新できない場合があります。

接続先定義ファイルのUPDUNITパラメタでBLOCKを指定している場合にはナル値を含むデータの変更及び削除はできないので注意してください。ただし，接続先定義ファイルの設定で対応できます。

参照：「2.4　接続先定義ファイルの作成」

Excelでデータを編集するときに，列を追加，削除，列の順序の並べ替え，空白行の挿入を実行すると更新できません。

繰り返し列を含む表は更新できません。

(3)　データを更新するときの注意

DBPARTNER2以外の制限で，データの更新には次に示す注意があります。

権限（変更，追加，削除）のない表に対しては，データベースを更新できません。

データベースを更新するコマンドが選べる状態ですが，コマンドがエラーになり更新できません。

DBPARTNER2以外の制限（データベースの制限）については，「8.4　更新処理の規則」を参照してください。

(4)　Excelでの制限

(a)　更新できるデータの範囲

データの範囲：-1E307 〜 -9.99999999999999E307，及び1E307 〜 9.99999999999999E307

文字列最大長：255バイト

最大件数：16383件

最大けた数：15けた

制限を超えた場合，文字属性のデータでは後ろが切り捨てられたり,数値属性の場合には丸められたりします。これらのデータを更新すると不正に更新されることがあるので注意してください。更新データが16383件を超える場合は，エラーとなって更新できません。

(b)　作成されるシート数

作成されるシート数は一つの処理で1シートです。

(c)　抽出したデータの属性

抽出したデータの属性は変更しないでください。

シート上でデータの属性を変更できますが，変更した場合には不正に更新されることがあるので注意してください。

(d)　メモ情報

メモ情報は変更しないでください。

1行目のメモ情報と一番左の列のメモ情報は，DBPARTNER2が更新するデータを管理するために使っています。このため，このメモ情報は変更しないでください。変更すると，不正に更新されることがあるので注意してください。

(e)　データのけた数

編集した結果，データのけた数が15けたを超えると，後ろが丸められます。

(f)　セル書式として定義されている記号（¥や%など）入力時の注意

通常Excelのセルには「G/標準」という書式が設定されています。DBPARTNER2で抽出したデータもこの「G/標準」書式となります。更新データ作成時に通貨記号「¥」や「%」などExcelでセル書式として定義されている記号を入力すると，そのセルの書式も自動的に通貨記号やパーセント記号の書式に変更されます。このため，データベースに更新されるデータが入力データと異なります。例えば，「10%」と入力したデータは「0.1」としてデータベースに更新されます。「10%」という入力データで更新したい場合は次のどちらかの方法でデータを入力してください。

セルの書式を文字属性に変更してからデータを入力する

データを入力する時に先頭に「'」を付けて入力する

(g)　日付・時刻データ入力時の注意

Excelの場合，日付はシリアルな数値，時刻は小数値として保存されます（例：入力データが「1998/10/10 11:15」の場合「19981010.1115」という値で保存されます）。このため，データベースに更新されるデータが入力データと異なります。入力データで更新したい場合は次のどちらかの方法でデータを入力してください。

セルの書式を文字属性に変更してからデータを入力する

データを入力する時に先頭に「'」を付けて入力する

1行目の項目名（列名）を変更してもデータベースには更新されません。

シートには，抽出データと一緒に項目名（列名）も抽出されます。この列名をシート上で更新してもデータベースの表の列名は更新されません。列名は「定義」メニューで変更してください。

(h)　データが入力されていない行

データが入力されていない行は更新対象となりません。

データが入力されていない行や行挿入後，データが入力されていなかった行は，更新しても更新対象となりません。空白行をデータベースに追加したい場合などは「△（空白）」などを入力してください。

(i)　Excelで更新する場合の注意

DBPARTNER2では扱える行数を16384行としています。

このため，16385行目以降にデータを入力して更新した場合は，エラーとなって更新できません。1〜16384行の範囲内にデータを入力して更新してください。

5.2　DBPARTNER2からのデータの更新

更新用に抽出したデータをDBPARTNER2のウィンドウで編集してデータベースを更新します。

データベースのデータを更新する場合，更新するデータをデータベースから抽出する必要があります。抽出する表，列，抽出条件は，［DBPARTNER2］ウィンドウで設定します。抽出する条件を設定して実行すると，抽出されたデータが［データ表示］ウィンドウに表示されます。［データ表示］ウィンドウで抽出したデータを編集し，更新するデータを作成します。更新するデータを作成したら，［データ表示］ウィンドウの［更新］メニューで，データベースの更新種別を選択します。更新種別には次の三つがあります。

DBPARTNER2からデータを更新する操作（更新用データの抽出→更新データの作成→データベースの更新）を次の図に示します。

データベースのデータの中から更新するデータを決定するときに，条件を設定できます。条件を設定して決定する方法については，「5.2.4　条件を設定して更新する行を決定する」を参照してください。この方法はDBPARTNER2からの更新だけでなくExcelからのデータの更新でもできます。

図5‒3　DBPARTNER2からデータを更新する操作

5.2.1　操作

(1)　操作の流れ

DBPARTNER2のウィンドウでデータを更新する操作について説明します。

入力例を次に示します。

更新するデータを抽出します。

抽出する表，抽出する列，抽出条件を設定します。ソート条件と件数制限は必要に応じて設定します。

転送先は「［データ表示］ウィンドウ」にします。

設定したら［抽出(E)］ボタンをクリックしてデータの抽出を実行します。

［抽出経過表示］ダイアログボックスが表示され，設定した抽出条件でDBPARTNER2がデータを抽出し，転送されます。実行経過は，グラフにパーセントで表示されます。

［キャンセル］ボタンをクリックすると，データの抽出処理が中断されます。

更新するデータを編集します。

抽出が終わると［データ表示］ウィンドウが表示されます。

は抽出したデータを基にデータを編集し，データベースを更新するデータを作成します。

参照：「5.2.3　更新するデータの作成」

データベースを更新します。

［データ表示］ウィンドウで［更新(U)］−［実行(R)］メニューを選びます。

［更新経過表示］ダイアログボックスが表示され，編集した内容でDBPARTNER2がデータベース中の該当するデータが更新されます。実行経過は，グラフにパーセントで表示されます。

［キャンセル］ボタンをクリックするとデータの更新処理が中断されます。

正常に終了すると，［更新経過表示］ダイアログボックスが閉じて，［DBPARTNER2］ウィンドウに戻ります。

これで，データの更新が終わりました。

抽出処理を中断した場合

ODBC接続で他社データベースにアクセスしている場合は，中断できないことがあります。

更新処理を中断した場合

次の場合，更新処理が中断されます。

データベースを更新中に［キャンセル］ボタンをクリックする

更新処理中にエラーが発生する

更新処理が中断された場合，それまでの処理が有効か無効かを決定する方法を，接続先定義ファイルのパラメタによって指定できます。

接続先定義ファイルのUPDFINパラメタを指定すると，その指定によって，更新処理を有効にするかを確認するメッセージが出力されるので，そこで処理の有効・無効を決定できます。ただし，UPDFINパラメタの指定を省略すると，確認のメッセージが出力されないで，更新処理が無効になります。

(2)　データを更新するときの制限

DBPARTNER2の制限で，更新するデータを抽出できない場合があります。

(a)　更新用データ抽出時の制限

次に示す表は，更新できません。

倍精度数値又は単精度数値属性の列を含む表

更新条件の解除，又は接続先定義ファイルの設定で，UPDUNITパラメタをROWIDに設定することで対応できます。

列の定義長が4097バイト以上の列を含む表

16進文字の列で列の定義長が2048バイト以上の列を含む表

属性が，VARBINARY，LONG VARCHARの列がある

列数が256以上ある

グループ分け，又は集合関数が設定されている

［列設定］ダイアログボックスで列を追加，削除した，又は列の順序を並べ替えた場合，抽出できません。ただし，情報ファイルで設定すれば，選択できます。詳細は，「2.5.2(8)　列選択をした状態での更新に関する設定−UpdateOptionセクション」を参照してください。

複数表が選択されている

更新条件となる列がない（［列選択］ダイアログボックスの［列一覧］ですべての列に*がついている）場合は更新できません。

抽出したデータを表示する［DBPARTNER更新］ウィンドウの領域によって，抽出できる行に次の制限があります。

20,000行以上ある表の場合，20,000行以降は，切り捨てられ表示されません。

20,000行以降のデータが必要な場合は，抽出条件を変更して再度抽出してください。

(b)　更新時の制限

データベースの表のデータを変更するときは，次に示す制限があります。

抽出データを編集しデータベースを更新した後，再度，同じ抽出データを編集してデータベースを更新できません。同じ抽出データを更新したい場合は，抽出し直してください。ただし，データ編集時に抽出データを全く変更しなければ，データベースは更新されないので，抽出し直す必要はありません。

接続先定義ファイルのUPDUNITパラメタでBLOCKを指定している場合には，ナル値を含むデータの変更と削除はできないので注意してください。ただし，接続先定義ファイルの設定で対応できます。

参照： 「2.4　接続先定義ファイルの作成」のUPDUNIT

更新するデータを編集する領域によって，更新できる行には次に示す制限があります。

一度の更新操作では，データベース19,999行分のデータが更新できます。20,000行以上のデータを更新する場合は，データベースへの更新が終了後，再度抽出し，［データ表示］ウィンドウで更新するデータを作成し，データベースを更新してください。

(3)　データを更新するときの注意

DBPARTNER2以外の制限によって，データの更新には次に示す注意があります。

権限（変更，追加）のない表に対して［更新］メニューの変更，追加は選択できません。ODBC接続の場合，権限のないコマンドでも選べる状態ですが，コマンドはエラーになるので注意してください。

権限（並び替え，削除）のない表に関しては，情報ファイルの設定に応じて並び替え，削除ができます。

参照：「2.5　情報ファイルの作成」のUpdateOption

DBPARTNER2以外の制限（データベースの制限）については，「8.4　更新処理の規則」を参照してください。

5.2.2　更新するデータの抽出

データベースを更新するときは，更新するデータを抽出する必要があります。抽出する表，列，及び条件は，［DBPARTNER2］ウィンドウで設定します。更新するデータを抽出するときの詳細な設定については，「4.　データの抽出（［抽出］メニュー）」を参照してください。

5.2.3　更新するデータの作成

DBPARTNER2のウィンドウで，更新するデータを作成する方法を説明します。

［DBPARTNER2］ウィンドウで抽出したデータは［データ表示］ウィンドウに表示されます。このデータを編集して，データベースを更新するためのデータを作成します。

［データ表示］ウィンドウの構成と機能を次に示します。

(1)　［データ表示］ウィンドウ

［データ表示］ウィンドウは，抽出したデータを表形式で表示する画面です。画面に表示されているデータに対して，行の追加（以降「追加」と表記），行の削除（以降「削除」と表記）及びデータの変更（以降「変更」と表記）を実行して，データベースのデータを更新できます。

ツールバー

［データ表示］ウィンドウのツールバーには，次のメニューコマンドと同じ機能があります。ボタンを使うと，メニューをプルダウンする必要がないので便利です。

[図データ]：［編集(E)］−［行回復(U)］

[図データ]：［編集(E)］−［行追加(A)］−［行数指定(N)...］

[図データ]：［編集(E)］−［行追加(A)］−［ファイルから(F)...］

[図データ]：［編集(E)］−［行削除(D)］

[図データ]：［編集(E)］−［行更新(U)］

[図データ]：［編集(E)］−［行選択解除(R)］

[図データ]：［抽出(S)］−［次データ表示(N)］

[図データ]：［抽出(S)］−［一括表示(A)］

[図データ]：［抽出(S)］−［ファイルへ出力(O)...］

[図データ]：［抽出(S)］−［中断(C)］

[図データ]：［更新(U)］−［実行(R)］

[図データ]：［バイナリ(B)］−［開く(V)］

[図データ]：［バイナリ(B)］−［ファイル名入力(I)］

[図データ]：［ファイル(F)］−［エクスプローラ起動(E)］

項目行

項目行には，行の番号を表示する列のタイトルと，抽出したデータの各列の名称が表示されます。この行のセルに対して編集はできません。各列の境界をドラッグすることで，列幅を変更できます。列数が1,000列以上の表は切り捨てられます。

データ行

データ行には，行の番号を表示する列と，抽出したデータが表示されます。データが表示されているセルは編集ができます。行番号を表示するセルは編集できません。抽出データが20,000行以上ある場合は切り捨てが発生します。

行番号を表示するセルには，抽出したデータの先頭行を1として昇順に表示されます。行番号セルの上で右クリックすると，［編集］メニューと同じコマンドがポップアップします。

[図データ]：変更マーク（抽出した後で内容が変更された行を示します）

[図データ]：追加マーク（抽出した後で追加された行を示します）

[図データ]：削除マーク（抽出した後で削除された行を示します）

データセル

データセルには，抽出したデータが表示されます。データを表示するときに文字属性の列は左詰め，数値属性のデータは右詰めになります。バイナリ属性のデータはデータが格納されているファイル名を表示します。データセルをクリックすると，入力できる状態になります。クリックしたときの列幅より表示する文字列の多い場合は，列幅が自動的に拡張されます。4,097バイト以上のデータがある場合は，更新ができなくなります。

セルの数（(データの行数＋1)×(データの列数＋1)）が350,000以上ある場合は切り捨てが発生します。

バイナリ属性のデータは，バイナリデータを格納したファイル名で表示されます。バイナリ属性のデータはドラッグ＆ドロップできます。

参照：「5.2.5　バイナリデータを含む表の更新」

更新データの指定方法

更新データを作成するときは，列の属性に合ったデータを作成してください。列の属性は，［条件設定］ダイアログボックスで確認できます。［条件設定］ダイアログボックスは，［DBPARTNER2］ウィンドウの［条件設定(C)...］ボタンをクリックすると表示されます。確認した属性に対応する定数の種類を確認し，その指定方法，指定範囲に従ってデータを作成してください。

(2)　更新操作の流れ

［データ表示］ウィンドウを使った，更新操作の流れについて説明します。

(a)　データを変更する

データベースのデータを変更する手順を次に示します。

変更したいデータセルに新しいデータを入力します。データを変えた行番号の部分に変更マークが表示されます。

［更新(U)］−［実行(R)］をクリックします。

一度変更したデータを，キーボードから元のデータに入力し直しても，変更マークは消えません。変更したデータを元の状態に戻したいときは，行を選択して［編集(E)］−［行回復(U)］をクリックします。選択した行のデータだけが抽出直後の状態に戻り，変更マークが消えます。

(b)　行を追加する（［データ表示］ウィンドウで追加データを作成）

データベースに新しいデータを追加する手順を次に示します。追加データの作成方法には，［データ表示］ウィンドウでデータを作成する方法と，ファイルから読み込む方法があります。ここでは，［データ表示］ウィンドウでデータを作成する方法を説明します。

［編集(E)］−［行追加(A)］−［行数指定(N)...］をクリックします。

［行追加］ダイアログボックスが表示されます。

追加する行数を入力し，［OK］ボタンを押します。

最終行以降に新しい行が追加されます。列番号の部分に追加マークが表示されます。

作成した行の各データセルにデータを入力します。

［更新(U)］−［実行(R)］をクリックします。

追加した行を削除したいときは，行を選択して［編集(E)］−［行回復(U)］をクリックします。追加した行が画面から消えます。

(c)　行を追加する（追加データをファイルから読み込む）

データベースに新しいデータを追加する手順を次に示します。ここでは，ファイルから読み込む方法を説明します。

［編集(E)］−［行追加(A)］−［ファイルから(F)...］をクリックします。

［ファイルから入力］ダイアログボックスが表示されます。

ファイル名を設定し，［OK］ボタンを押します。

最後の行以降にデータが追加されます。列番号の部分に「追加マーク」が表示されます。

［更新(U)］−［実行(R)］をクリックします。

行を追加したら，データを設定してください。データが設定されていない行は，更新されません。

追加した行を削除したいときは，行を選択して［編集(E)］−［行回復(U)］をクリックします。追加した行が画面から消えます。

(d)　行を削除する

データベースのデータを削除する手順を次に示します。

データベース上から削除したい行を選択します。

［編集(E)］−［行削除(D)］をクリックします。

行番号の所に「削除マーク」が表示されます。

［更新(U)］−［実行(R)］をクリックします。

削除したい行の設定を解除したい場合は，行を選択して［編集(E)］−［行回復(U)］をクリックします。選択した行の「削除マーク」が消えます。

(3)　データセルのデータを変更する操作

データセルのデータを変更する操作を次に示します。

カーソルキー，又はマウスで，変更したいデータセルを選択します。

新しいデータを入力し，［Enter］を押します。

カーソルキーで変更したいデータセルを選択し［Enter］を押すか，データセルをマウスでダブルクリックすると，選択したデータセルが編集できる状態になります。

「削除マーク」が付いている行のデータセルは編集できる状態になりますが，入力はできません。

文字を入力した後［Enter］を押すと，フォーカスが下のデータセルに移動します。

文字を入力した後［Tab］を押すと，フォーカスが右のデータセルに移動します。

文字入力できる状態を解除したい場合は，［Esc］を押すか，データセルをマウスでダブルクリックするか，又はほかのセルをクリックします。

(4)　操作対象となる行を選択する操作

行のコピーや編集操作の取り消しをする場合に使用する，行を選択する操作を次に示します。

行番号をマウスでクリックします。

行番号部分が反転表示され，選択状態になります。

行番号をマウスでクリックすると，以前に選択していた個所が解除されます。複数の行を選択したい場合は，［Ctrl］を押しながら行番号をマウスでクリックします。複数の行が選択されている状態で，特定の行の選択を解除したい場合は，［Ctrl］を押しながら行番号をマウスでクリックします。

すべての行を選択したい場合は，"行番号"をマウスでクリックします。

連続した行を選択する場合は，先頭の行番号をマウスでクリックした後，［Shift］を押しながら最終の行番号をマウスでクリックします。

すべての選択を解除する場合は，［編集(E)］−［行選択解除(R)］をクリックします。

(5)　行のコピー・貼り付けの操作

行のコピー・貼り付けの操作を次に示します。

行を選択し，［編集(E)］−［行コピー(C)］をクリックします。

貼り付けを開始する行を選択し，［編集(E)］−［行貼り付け(P)］をクリックします。

貼り付けた行には，「変更マーク」が付けられます。

貼り付ける行数が足りない場合は，自動的に行が追加されます。追加された行には，「追加マーク」が付けられます。

連続していない複数の行をまとめてコピーすることもできます。貼り付けたときは，連続した行として貼り付けられます。

「削除マーク」が付いている行には貼り付けられません。

(6)　逐次探索中又は検索完了表示中のデータを一括でファイルに格納する操作

逐次探索中又は検索完了表示中のデータを，一括でファイルに格納します。

逐次探索中又は検索完了表示中に［抽出］−［ファイルへ出力］をクリックします。

［ファイルへ出力］画面（コモンダイアログボックス）が表示されます。

ファイル名と，ファイルの種類を入力します。

ファイル名を設定し,［OK］ボタンをクリックします。

逐次探索中は表示されているデータと残りすべてのデータ，検索完了表示中は画面に表示されているすべてのデータがファイルに格納されます。

変更マークなど，データベースを更新する情報は格納されません。

(7)　［データ表示］ウィンドウを終了させる操作

［データ表示］ウィンドウを終了する操作を次に示します。

［ファイル(F)］−［終了(X)］をクリックします。

DBPARTNER2を終了させると，［データ表示］ウィンドウも同時に終了します。

5.2.4　条件を設定して更新する行を決定する

データベースのデータの中から更新するデータを決定するときに，条件を設定できます。

通常，DBPARTNER2は更新行の全列のデータをチェックして，データベース中のどの行を更新するかを決定しています。このため，外字※列を含む行は，「更新データが見つからない」というメッセージが返され，更新できません。

このような場合には，その列だけをチェック対象外にできます。つまり，DBPARTNER2がチェックする列を設定しておいて，その設定した列を条件として更新する行を決定します。

通常と更新条件を設定した場合の更新行の決定方法を次の図に示します。

図5‒4　更新行の決定方法

注※

外字を含むデータは，抽出時にクライアントPC側で対応する外字に変換されます。クライアントPC側に対応する外字がない場合，データベースの外字は外字（(889E)₁₆）に変換されます。このような外字は，元の外字に変換できないため，更新行が決定できなくなります。

ただし，コードマッピングによって対応付けた外字は更新できます。コードマッピングでも，対応付けられなかった外字はこの機能を利用すると便利です。

外字列をチェック対象外にする場合は，［列設定］ダイアログボックスの［更新条件(U)...］ボタンをクリックしてください。［更新条件の列の設定］ダイアログボックスが表示されるので，チェック対象外にする列を設定してください。

［更新条件の列の設定］ダイアログボックスを示します。

タイトルバー

「更新条件の列の設定」と表示されます。

［設定内容(C)］

更新条件とする列には「設定」，更新条件から解除する列には「*」と表示されます。オプションでインデクス情報の表示を指定している場合は，列に定義されているインデクスの種別も表示されます。表示される内容については，「7.1.9　インデクス情報の表示」を参照してください。

［列属性］，［インデクス名］

［設定内容(C)］の設定内容で選択されている列の属性が表示されます。オプションでインデクス情報の表示を指定している場合は，選択した列に定義されているインデクス名が表示されます。表示される内容については，「7.1.9　インデクス情報の表示」を参照してください。

［設定(S)］ボタン

［設定内容(C)］の設定内容で選択されている列を更新条件に設定します。

［解除(D)］ボタン

［設定内容(C)］の設定内容で選択されている列を更新条件から解除します。

［OK］ボタン

更新条件の列を確定して，［列設定］ダイアログボックスを表示します。

［キャンセル］ボタン

更新条件の列の設定を取り消して，［列設定］ダイアログボックスに戻ります。

(1)　操作

更新条件の列を設定する方法を説明します。表計算ソフトから更新する場合とDBPARTNER2から更新する場合との操作に変わりはありません。

［DBPARTNER2］ウィンドウの［表名(T)...］ボタンで抽出する表を選択します。

［DBPARTNER2］ウィンドウの［列設定(U)...］ボタンをクリックします。

［列設定］ダイアログボックスが表示されます。

［更新条件(U)...］ボタンをクリックします。

［更新条件の列の設定］ダイアログボックスが表示されます。全列が更新条件になっているため，全列に「設定」と表示されます。

更新行決定時にチェック対象外にする列を設定します。

［OK］ボタンをクリックします。

［列設定］ダイアログボックスに戻ります。

更新条件から解除した列には，「*」が表示されます。

(2)　規則と注意

チェック対象外にした列のデータが異なっていても，チェック対象とする列のデータが同じである行は更新されます。チェック対象のデータが同じ場合，DBPARTNER2は更新する行であると認識します。このため，更新したくない行も更新されることがあるので注意してください。

5.2.5　バイナリデータを含む表の更新

バイナリデータ（列名の属性がLONG VARBINARY）を含む表に関しては，［データ表示］ウィンドウに抽出する場合だけ，更新ができます。バイナリデータを含む表の更新する操作を次に示します。

(1)　バイナリのデータ内容を編集して更新する

変更するデータを含むセルをクリックします。

セルを選択状態にします。

［バイナリ(B)］−［開く(V)］を選択します。

又は，右クリックで［開く］を選択します。

バイナリデータを開くアプリケーションは，抽出時に［ファイル種別］ダイアログボックスで設定された属性によって決められます。

データを編集します。

編集が終わったら，アプリケーション内の［上書き］メニューでデータを上書き保存します。

変更したセルの行番号をクリックします。

変更したセルの行が選択状態になります。

［編集(E)］−［行更新(U)］をクリックします。

変更した行の行番号に更新のマークが付きます。この操作をしない場合は変更内容は更新できません。

［更新(U)］−［実行(R)］をクリックします。

(2)　バイナリのデータをほかのデータに置き換える，又は追加による更新

バイナリ属性のデータの変更，追加には次の2通りの方法があります。

［ファイル名入力(I)］ボタンを使う

変更するデータを含むセルをクリックします。

セルを選択状態にします。

［バイナリ(B)］−［ファイル名入力(I)］をクリックします。又は右クリックで［ファイル名入力］を選択します。

［ファイル名称入力］ダイアログボックスが表示されます。

置き換えるバイナリのデータを選択します。

［保存(S)］ボタンをクリックします。

［データ表示］ウィンドウに戻り，選択したセルに置き換えたデータの保存先のパスが設定されました。

［更新(U)］−［実行(R)］をクリックします。

［エクスプローラ］ボタンを使って，ドラッグ＆ドロップする

［ファイル(F)］−［エクスプローラ起動(E)］，又はツールバーの［エクスプローラ起動］ボタンをクリックします。

エクスプローラが起動します。

変更（又は追加）するファイルを選択してドラッグ＆ドロップします。

［更新(U)］−［実行(R)］をクリックします。

バイナリ属性のデータが変更（又は追加）されます。

規則と注意

接続先定義ファイルのUPDUNITパラメタにSINGLEを指定しないでください。SINGLEを指定した場合，LONG VARBINARY属性を含む列は更新できなくなります。

5.3　データベースへのデータ追加

データベースに，データを追加するという目的での更新について説明します。データを追加する操作を次の図に示します。

図5‒5　 データを追加する操作

DBPARTNER2を起動します。

［抽出］−［データ追加］メニューを選択します。

［転送先(O)...］ボタンをクリックします。

転送先を選択します。

Excelに転送する場合は，Excel連携の［貼付オプション］がチェックされていないことを確認してください。

［抽出(E)］ボタンをクリックします。

転送先のアプリケーションが起動され，転送先のメインウィンドウが表示されます。

転送先ウィンドウに列情報だけが抽出されます。

データを追加します。

［データ表示］ウィンドウでは，［編集］，又は右クリックで［行追加］メニューを選択して追加する行数を設定します。

転送先の［更新］−［実行］メニューをクリックします。

追加したデータはデータベース上に追加されました。

制限

LONG VARBINARY属性のデータを追加する場合は，転送先としてデータ表示ウィンドウを選択してください。Excelとは連携できません。

6　定型業務の登録と実行（［手順］メニュー）

この章では，データを抽出するときの操作や設定内容をファイルに登録して実行する方法について説明します。

6.1　手順ファイル

データを抽出するときに指定した表名，列名，条件などを手順ファイルに登録します。毎日同じ表に対して同じ条件でデータを抽出する場合などは，このファイルを利用すれば作業効率を向上できます。一部を変更して実行することもできます。また，手順ファイルを利用して更新するデータを抽出したり，データベースへ表を定義したりできます。さらに，抽出したデータをデータベースに保存する操作や抽出内容を，データを確認した後に絞り込む操作もできます。

手順ファイルの使い方の例を次の図に示します。

図6‒1　手順ファイルの使い方の例

手順ファイルを操作するときは，［DBPARTNER2］ウィンドウの［手順(B)］メニューのコマンドを使います。

［手順(B)］メニュー中の手順ファイルの操作に関するコマンドとその機能を次の表に示します。

表6‒1　手順ファイルの操作に関するコマンド

コマンド名

機能

参照先

登録(S)...

ユーザが設定した値を手順ファイルに登録します。

6.1.1

実行(E)...

ユーザが設定した値で処理を実行します。

6.1.2

参照(R)...

ユーザが設定した値を参照，又は変更して処理を実行します。

6.1.3

削除(D)...

手順ファイルを削除します。

6.1.4

変更(C)

手順ファイルのコメントを変更します。

6.1.5

印刷(P)

手順ファイルの内容を印刷します。

6.2

実行履歴(L)

以前，実行した手順ファイルから実行します。

6.1.2

参照履歴(O)

以前，参照した手順ファイルから参照します。

6.1.3

履歴削除(A)

履歴で表示される内容を削除します。

6.1.2，

6.1.3

6.1.1　手順ファイルの登録

ユーザが設定した値を手順ファイルに登録します。

(1)　手順ファイルに登録できる項目

手順ファイルに登録できる項目を次の表に示します。

表6‒2　手順ファイルに登録できる項目

値を設定するダイアログボックス

登録する内容

［手順の登録］

コメント

［接続先設定］

接続先

［DBPARTNER2］

件数制限

［表選択］

表名

［列設定］

列の設定

列の順序※

ソート設定

集合関数

更新条件の列の設定

ファイル種別の設定

［条件設定］

条件式

条件式の関連付け

［転送先設定］

転送先

ファイル名

フォルダ

［表定義］

表名，表見出し，表注釈

［列定義］

列名，列見出し，列情報

［列詳細定義］

列注釈

［格納領域設定］

表の格納領域の設定

［インデクス定義］

表のインデクス

［表削除］

削除する表名

［SQL入力］

SQL，可変値，省略値

注※

データが抽出されるときの列の順番（［データ表示］ウィンドウに表示される順番）のことです。

(2)　手順ファイルに登録するタイミング

設定した値を手順ファイルに登録するタイミングは次のとおりです。

すべての情報を登録する

データを抽出する場合は，データの抽出／転送が終了した後，［DBPARTNER2］ウィンドウに戻った時点で登録してください。一つ前で入力したデータ抽出に関するすべての情報が登録されます。

途中の段階での情報を登録する

すべての情報を登録するのではなく，条件を設定した時点までの情報だけを登録します。この場合は，登録したい情報を指定した時点で登録してください。［データ表示］ウィンドウ，［表定義］ダイアログボックス，又は［表削除］ダイアログボックスだけが表示されていれば登録できます。

SQLを登録する

SQLを入力した後，登録してください。

(3)　操作

［DBPARTNER2］ウィンドウの［手順(B)］メニューの［手順ファイルの登録］ダイアログボックスで，手順ファイルに登録します。

(a)　ファイル名の入力又は選択

登録するファイル名をキーボードから入力します。ファイル名はユーザが任意に決められます。また，ファイル名の一覧から選択することもできます。一覧中のファイル名をダブルクリックすると，手順ファイルを登録して，［手順ファイルの登録］ダイアログボックスが閉じます。

(b)　フォルダの選択

フォルダの一覧から選択してください。フォルダを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先フォルダになります。

(c)　ドライブの選択

ドライブの一覧から選択してください。ドライブを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先のドライブになります。

(d)　コメントの入力

ほかの手順ファイルと区別できるようコメントを付ける場合は，コメントを入力してください。コメントに使える文字は，全角文字，半角文字です。指定できる長さは，最大255バイトです。

付けたコメントを変更する場合は，［手順(B)］−［変更(C)］−［コメント(M)...］メニューで変更してください。コメントを付ける場合は，あらかじめ［ツール］−［オプション(O)］メニューで設定してください。

［ツール(X)］−［オプション(O)...］メニューを選択して，［オプション設定］ダイアログボックスを表示します。

［手順の一覧にファイル情報を表示(M)］チェックボックスをオンにします。

［OK］ボタンをクリックします。

［手順(B)］−［参照(R)...］メニューで手順ファイルを参照・実行します。

［手順(B)］−［登録(S)...］メニューを選択し，［手順ファイルの登録］ダイアログボックスを表示します。

4.で実行した操作を登録します。

コメントを付けて，登録します。

コメントなしの既存の手順ファイルは，必要に応じて,［手順(B)］−［削除(D)...］メニューで削除してください。

(e)　入力例

［DBPARTNER2］ウィンドウの［手順(B)］−［登録(S)...］メニューを選びます。

［手順ファイルの登録］ダイアログボックスが表示されます。

オプションでファイル情報を表示する設定をしていない場合は，ファイル情報は表示されません。

ファイル名，ファイルの種類，フォルダ，及びドライブを入力します。

［OK］ボタンをクリックします。

［手順ファイルの登録］ダイアログボックスが閉じて，登録されます。

既存のファイルに再登録する場合

登録時に既存のファイル名を入力した場合，置き換えてよいかどうかを確認するダイアログボックスが表示されます。

既存のファイルと置き換える場合は，［はい(Y)］ボタンをクリックします。

新規にファイルを作成する場合は，［いいえ(N)］ボタンをクリックした後，［手順(B)］メニューから［手順ファイルの登録］ダイアログボックスを開いて，新しいファイル名を入力してください。

SQLを登録する場合

SQLを入力した後，［SQL入力］ダイアログボックスの［手順登録］ボタンをクリックすると［手順ファイルの登録］ダイアログボックスが表示されます。

ダイアログボックス表示中の登録方法

［DBPARTNER2］，［表定義］ダイアログボックス表示中にマウスを右クリックすると，［手順ファイルの登録］メニューが表示されます。選択すると［手順ファイルの登録］ダイアログボックスが表示されるので，それまでの操作を登録できます。

Client32形式の手順ファイルの登録方法

情報ファイルの［CatalogOption］セクションにConvertエントリを設定すると，DBPARTNER/Client32（02-04）で参照できる手順ファイルを作成できます。

参照：「2.5　情報ファイルの作成」のCatalogOption

DBPARTNER2で作成した手順ファイル名を印刷するときの注意

ファイル名及び拡張子によっては次のように印刷されます。

ファイル名が半角9文字以上の場合：システムが自動的に設定した名称

拡張子が半角4文字以上の場合：4文字目以降切り捨て

(4)　注意

絞り込み表を含む操作を手順ファイルに登録する場合，最後の条件だけが登録されます。絞り込んでいく過程で設定した条件や作成される表は登録されないので注意してください。

DBPARTNER/Client（03-00）より前に作成した既存の手順ファイル（設定値ファイル）にコメントを付ける場合は，手順ファイルを再登録する必要があります。コメントを付ける手順については，「6.1.1(3)(d)　コメントの入力」を参照してください。

可変記号に対する実行値を入力して手順ファイルを実行した後に，再度その操作を手順ファイルに登録すると，実行値は登録されません。

SQLを手順ファイルに登録するときの規則

？パラメタを指定したSQL文を手順ファイルに登録できるのは，接続先が次に示すデータベースのときだけです。

HiRDB

ORACLE

VOS3 XDM/RD E2（DBS経由）

VOS3 XDM/SD E2（DBS経由）

HADB

？パラメタの値にバイナリ形式のデータは設定できません。

6.1.2　手順ファイルの実行

手順ファイルに登録した値で処理を実行します。このとき，登録内容は表示しないで処理を実行します。実行した手順ファイルは，［手順(B)］−［実行履歴(L)］で表示されるので，そこから選択して実行することもできます。実行履歴，又は参照履歴で表示される内容を削除したい場合は，［手順(B)］−［履歴削除(A)］を実行してください。

手順ファイルの実行では，手順ファイルに登録している内容で実行されます。ただし，未登録の内容がある場合は，次の表に従って実行されます。

表6‒3　手順ファイルの実行時の動作内容

ダイアログボックス

項目

登録状況

動作内容

［手順ファイルの実行］

コメント

未登録

実行には影響ありません。

登録済み

実行には影響ありません。

［接続先設定］

接続先

未登録

ありえません。

登録済み

登録されている接続先で実行されます。その後の動作は登録内容に従います。

［DBPARTNER2］

表名

未登録

表名を選択してください。

登録済み

登録されている表名で実行されます。

件数制限

未登録

ありえません。

登録済み

登録されている件数で実行されます。

［列設定］

列の設定

未登録

すべての列が仮定され実行されます。

登録済み

登録されている列で実行されます。

列の順序

未登録

データベース中の列の順序で実行されます。

登録済み

登録されている列の順序で実行されます。

ソート設定

未登録

ソートは設定されていないものとして実行されます。

登録済み

登録されているソート設定で実行されます。

集合関数

未登録

集合関数は設定されていないものとして実行されます。

登録済み

登録されている集合関数で実行されます。

更新条件の列

未登録

すべての列を条件として実行されます。

登録済み

登録されている条件で実行されます。

ファイル種別の設定

未登録

指定なしとして動作されます。

登録済み

登録されているファイル種別で抽出が行われます。

［条件設定］

条件式

未登録

条件式の指定は設定されていないものとして実行されます。

登録済み

登録されている条件式で実行されます。

条件式の関連付け

未登録

ANDが仮定され実行されます。

登録済み

登録されている条件式の関連付けで実行されます。

［転送先設定］

転送先

未登録

ありえません。

登録済み

登録されている転送先で実行されます。

ファイル名※2

未登録

ありえません。

登録済み

登録されているファイル名で実行されます。

フォルダ※2

未登録

ありえません。

登録済み

登録されているフォルダで実行されます。

［表定義］

表名

未登録

表名は設定されていないものとして実行されます。

※1

登録済み

登録されている表名で実行されます。

表見出し，表注釈

未登録

表見出し，表注釈は設定されていないものとして実行されます。

登録済み

登録されている内容で実行されます。

［列定義］

列名，列情報

未登録

列名，列情報は設定されていないものとして実行されます。※1

登録済み

登録されている内容で実行されます。

列見出し

未登録

列見出しは設定されていないものとして実行されます。

登録済み

登録されている列見出しで実行されます。

［列詳細定義］

列注釈

未登録

列注釈は設定されていないものとして実行されます。

登録済み

登録されている内容で実行されます。

［格納領域設定］

表の格納領域の設定

未登録

格納領域は設定されていないものとして実行されます。

登録済み

登録されている格納領域で実行されます。

［インデクス定義］

インデクス設定

未登録

インデクスは設定されていないものとして実行されます。

登録済み

登録されているインデクスで実行されます。

［表削除］

削除する表名

未登録

表名は設定されていないものとして実行されます。※1

登録済み

登録されている表名で実行されます。

［SQL入力］

SQL入力

未登録

手順の登録ができません。

登録済み

登録されている内容で実行されます。

可変値

未登録

可変値を使用しないで実行されます。

登録済み

指定した可変値で実行されます。

注※1

手順ファイルを参照して該当する項目を設定してから実行してください。設定しない場合は，エラーになります。

注※2

転送先がファイルの場合です（転送先がシート又はデータベースの場合，ファイル名やフォルダなどは設定しないため）。

(1)　操作

［手順(B)］−［実行(E)...］メニューを選んで，［手順ファイルの実行］ダイアログボックスを開きます。このダイアログボックスで，手順ファイルを実行します。

(a)　ファイル名の入力又は選択

実行するファイル名をキーボードから入力します。また，ファイル名の一覧から選択することもできます。一覧中のファイル名をダブルクリックすると，手順ファイルを実行して，［手順ファイルの実行］ダイアログボックスが閉じます。

(b)　フォルダの選択

フォルダの一覧から選択してください。フォルダを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先フォルダになります。

(c)　ドライブの選択

ドライブの一覧から選択してください。ドライブを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先のドライブになります。

(d)　入力例

［DBPARTNER2］ウィンドウの［手順(B)］−［実行(E)...］メニューを選びます。

以前，実行した手順ファイルを実行する場合は［実行履歴(L)］メニューを選んで，手順ファイルを選択してください。

［手順ファイルの実行］ダイアログボックスが表示されます。

ファイル名，ファイルの種類，フォルダ，及びドライブを入力します。

［OK］ボタンをクリックします。

［手順ファイルの実行］ダイアログボックスが閉じ，実行されます。可変記号を設定したファイルの場合，オプションの設定によって［実行値入力］ダイアログボックスを表示できます。可変記号に対する実行値を入力してください。［実行値入力］ダイアログボックスを表示しない場合は，可変記号を設定するときに設定した初期値が実行値となります。

ユーザIDとパスワードの入力が必要な場合は，キーボードから入力してください。

コマンドラインからの手順ファイルの実行

コマンドラインに手順ファイル名（格納先のフォルダのパスを含む）を指定して［OK］ボタンをクリックしてください。DBPARTNER2が起動され，指定した手順ファイルが実行されます。例えば，C:¥Program Files¥HITACHI¥DBP2CL¥GUIにあるshiire.dpcという手順ファイルを実行したい場合には，コマンドラインに「C:¥Program Files¥HITACHI¥DBP2CL¥GUI¥Dbpart2.exe C:¥Program Files¥HITACHI¥DBP2CL¥GUI¥shiire.dpc」と設定してください。手順ファイルをコマンドラインから実行した場合，処理終了後にDBPARTNER2も終了します。

(2)　注意

表定義の操作を登録した手順ファイルを実行するときに，手順ファイルに登録されている表名と同じ名称の表がデータベースに存在すると，エラーになります。同じ名称の表がデータベースに存在しないことを確認してから，実行してください。

可変記号に対する実行値を入力して手順ファイルを実行した後に，再度その操作を手順ファイルに登録しても，実行値は登録されません。

6.1.3　手順ファイルの参照

手順ファイルに登録した値を参照しながら処理を実行します。また，設定した値を変更して処理を実行することもできます。変更後，同じ手順ファイルに登録すれば，変更後の情報に置き換わります（登録しなければ置き換わりません）。

参照した手順ファイルは，［参照履歴(O)］メニューで表示できるので，そこから選択して実行することもできます。参照履歴で表示される内容を削除したい場合は，［手順(B)］−［履歴削除(A)］を実行してください。

(1)　最初に参照するダイアログボックス

手順ファイルを参照すると設定した内容によって，［DBPARTNER2］ウィンドウ，［表定義］ダイアログボックス，［表削除］ダイアログボックス，又は［SQL入力］ダイアログボックスが表示されます。

(2)　変更できる手順ファイルの内容

手順ファイルを参照するときに，設定内容を変更できます。変更できる設定内容を次の表に示します。

表6‒4　手順ファイルの参照時に変更できる内容

ダイアログボックス名

変更できる内容

［接続先設定］

接続先（ただし，変更すると［DBPARTNER2］ウィンドウで設定した項目はすべて無効となって，消去されます）

［DBPARTNER2］

ウィンドウ

表名（ただし，変更すると［列設定］ダイアログボックス及び［条件設定］ダイアログボックスで設定した項目はすべて無効となり，消去されます），件数制限

［列設定］

選択した列，列の順序※，ソート設定，集合関数，更新条件の列の設定，ファイル種別の設定

［条件設定］

条件式，条件式の関連付け

［転送先設定］

転送先，ファイル名，フォルダ

［表定義］

表名，表見出し，表注釈

［列定義］

列名，列見出し，列情報

［列詳細定義］

列注釈

［格納領域設定］

表の格納領域の設定

［インデクス定義］

表のインデクス

［表削除］

削除する表名

［SQL入力］

SQL，可変値，省略値

注※

データが抽出されるときの列の順番（［データ表示］ウィンドウに表示されている順番）のことです。

(3)　操作

［DBPARTNER2］ウィンドウの［手順(B)］−［参照(R)］メニューを選んで，［手順ファイルの参照］ダイアログボックスを開きます。このダイアログボックスで手順ファイルの値を参照しながら処理を実行します。

(a)　ファイル名の選択

参照するファイル名をファイル名の一覧から選択してください。一覧中のファイル名をダブルクリックすると，手順ファイルの内容を表示した［DBPARTNER2］ウィンドウ，［表定義］ダイアログボックス，又は［表削除］ダイアログボックスを呼び出し，［手順ファイルの参照］ダイアログボックスが閉じます。

(b)　フォルダの選択

フォルダの一覧から選択してください。フォルダを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先フォルダになります。

(c)　ドライブの選択

ドライブの一覧から選択してください。ドライブを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先のドライブになります。

(d)　入力例

［DBPARTNER2］ウィンドウの［手順(B)］−［参照(R)...］メニューを選びます。

以前，参照した手順ファイルを参照する場合は［参照履歴(O)］メニューを選んで，手順ファイルを選択してください。

［手順ファイルの参照］ダイアログボックスが表示されます。

ファイル名，ファイルの種類，フォルダ，及びドライブを選択します。

［OK］ボタンをクリックします。

［手順ファイルの参照］ダイアログボックスが閉じます。

ユーザIDとパスワードの入力が必要な場合は，キーボードから入力してください。

［DBPARTNER2］ウィンドウが表示されるので，内容を変更したい場合は，対応するダイアログボックスを開いてください。

例えば条件式を変更する場合，［条件設定(C)...］ボタンをクリックして［条件設定］ダイアログボックスを開き，条件式を変更し直してください。

変更した条件をすべて削除して初期状態に戻したい場合は，［抽出(S)］−［列情報の最新(N)］メニューを選択すると最新の列情報を取得できます。

参照：「4.1.4　最新列情報の取得」

［抽出］ボタンをクリックします。

手順ファイルに登録された値（一部変更した場合は変更した値）でデータを抽出します。処理が正常に終了すると，［DBPARTNER2］ウィンドウに戻ります。

変更した値で手順ファイルに再登録したい場合は，「6.1.1　手順ファイルの登録」を参照してください。

6.1.4　手順ファイルの削除

登録済みの手順ファイルを削除します。削除するときは，［DBPARTNER2］ウィンドウの［手順(B)］−［削除(D)...］メニューを選んで，［手順ファイルの削除］ダイアログボックスを開きます。

(1)　操作

(a)　ファイル名の入力又は選択

削除するファイル名をキーボードから入力します。また，ファイル名の一覧から選択することもできます。一覧中のファイル名をダブルクリックすると，削除の確認メッセージが表示されます。

(b)　フォルダの選択

フォルダの一覧から選択してください。フォルダを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先フォルダになります。

(c)　ドライブの選択

ドライブの一覧から選択してください。ドライブを選択しないと，表示されている，インストール時に設定した手順ファイルの格納先のドライブになります。

(d)　入力例

［DBPARTNER2］ウィンドウの［手順(B)］−［削除(D)...］メニューを選びます。

［手順ファイルの削除］ダイアログボックスが表示されるので，ファイル名，ファイルの種類，フォルダ，及びドライブを入力します。

［OK］ボタンをクリックします。

削除の確認メッセージが表示されます。これは，指定した手順ファイルを本当に削除してよいかどうかを確認するメッセージです。

［はい］ボタンをクリックします。

［手順ファイルの削除］ダイアログボックスと削除を確認するメッセージが閉じます。処理が正常に終了すると，［DBPARTNER2］ウィンドウに戻ります。

6.1.5　手順ファイルの変更

登録した手順ファイルの内容（コメント）を変更します。変更には［DBPARTNER2］ウィンドウの［手順(B)］−［変更(C)］−［コメント(M)...］メニューで開く［手順ファイルのコメント変更］ダイアログボックスを使います。コメントは，このダイアログボックスだけでしか変更できません。

(1)　操作

［DBPARTNER2］ウィンドウの［手順(B)］−［変更(C)］−［コメント(M)...］メニューを選びます。

［手順ファイルのコメント変更］ダイアログボックスが表示されます。

変更する手順ファイルを選択します。

コメント編集領域でコメントを変更した後，［変更］ボタンをクリックします。

コメントが変更されます。

［閉じる］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

コメントが付いていない手順ファイルについては，ファイル名だけが表示されます。

6.2　手順ファイルの登録内容の変更と印刷

作成した手順ファイルの登録内容を変更する方法と，手順ファイルの内容を印刷する方法について説明します。

6.2.1　手順ファイルの登録内容の変更

DBPARTNER2では，登録した手順ファイルの内容を変更する場合，すべての操作をやり直さなくても，手順ファイルに登録された，接続先のサーバの名称，表名を変更できます。

「既存の手順ファイルを別の所でも利用したいが，接続先のサーバの名称だけが異なるため，利用できなかった」という場合などに利用すると便利です。

(1)　操作

［DBPARTNER2］ウィンドウの［手順(B)］−［変更(C)］−［内容(C)...］を選びます。

［手順ファイルの内容変更］ダイアログボックスが表示されます。

登録内容を変更する手順ファイルを選択し，［OK］ボタンをクリックします。

［手順ファイルの内容変更］ダイアログボックスが表示されます。

選択した手順ファイルのファイル名が表示され，登録内容が表示されます。さらに，現在表示されている表情報が，全登録情報の何番目かが「n番目/全表情報数」という形式で表示されます。

登録内容を変更します。

接続先名称

接続先定義ファイルに定義されている接続先の中から，変更したい接続先名称を選択してください。

表情報

手順ファイルに登録されている表情報が表示されます。表所有者，表名（データベースに定義されている表名），表見出しを変更してください。複数表を登録している場合には［前表(B)］，［次表(N)］でほかの情報を表示させてください。

［OK］ボタンをクリックします。

手順ファイルに変更内容が反映されて，［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

この機能で変更できるのは，DBPARTNER/Clientのバージョン03-00以降に登録した手順ファイル（設定値ファイル）の内容だけです。

接続先定義ファイルの設定内容が同じであることを確認してください。

変更前と変更後の接続先名称に対応する接続先定義ファイルの内容が異なると，手順ファイルが正しく実行できなくなる場合があります。接続先名称を変更するときは，接続先定義ファイルを同じ設定にしてください。

次の場合は変更できません。

定数として記述されている所有者，表名，表見出しを含む表情報

抽出表以外の登録内容

表情報入力時の規則

入力できる最大文字数は次のとおりです。前後の「△」（空白）及び「"」（ダブルクォーテーション）を含めると，半角文字で128文字まで入力できます。

表所有者名：半角文字で32文字

表名：半角文字で30文字

表見出し：半角文字で46文字

「△」（空白），「"」（ダブルクォーテーション）を入力する場合は，文字列全体を「"」で囲んでください。

「"」を文字として入力する場合は，2個続けて（「""」）入力してください。

文字列の前後に「△」「"」がある場合は，文字列全体を「"」で囲んでください。

6.2.2　手順ファイルの印刷

手順ファイルに登録されている，表名や列名を印刷できます。

手順ファイルの登録内容の印刷例を次の図に示します。

図6‒2　手順ファイルの登録内容の印刷例

（凡例）

xxxxxxxx.DPC：手順ファイルの名称

yyyy/mm/dd hh:mm:ss：印刷日時(年/月/日　時:分:秒)

Page=xxx：ページ番号

(1)　操作

［DBPARTNER2］ウィンドウの［手順(B)］−［印刷(P)］−［表示(V)...］を選びます。

［手順ファイルの表示］ダイアログボックスが表示されます。

補足

手順ファイルの内容を表示する必要がなければ，［手順(B)］−［印刷(P)］−［印刷(P)...］を選んでください。

登録内容を印刷する手順ファイルを選択します。

［手順(B)］−［印刷(P)］−［印刷(P)...］を選ぶと，複数の手順ファイルを選択できます。

［OK］ボタンをクリックします。

［手順の内容］ダイアログボックスが表示されます。

補足

［手順(B)］−［印刷(P)］−［印刷(P)...］を選ぶと，［手順の内容］ダイアログボックスは表示されないで，［印刷設定］ダイアログボックスが表示されます。

内容を確認して，［印刷］ボタンをクリックします。

［印刷設定］ダイアログボックスが表示されます。

［OK］ボタンをクリックします。

印刷を実行して，［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

この機能で印刷できるのは，DBPARTNER/Clientのバージョン03-00以降に登録した手順ファイル（設定値ファイル）の内容だけです。

［手順の内容］ダイアログボックスには，手順ファイルの先頭から最大30,000バイトまでのデータが表示されます。

<表>というヘッダの下には，抽出対象の表が表示されます。このとき，表ごとにアルファベットが付加され，以降，表はそのアルファベットで表されます。

（例）抽出対象の表が「KOKYAKU」である場合

<表>

A:KOKYAKU

...

<抽出列>

A.NAME ←表「KOKYAKU」の列「NAME」を表す

表名と列名は，表定義時の表名と列名が印刷されます。見出しを設定している場合，見出しは，表名と列名の後ろの括弧の中に印刷されます。

（例）表名「KOKYAKU」に見出し「顧客」を設定している場合の印刷例

A.KOKYAKU（顧客）

ただし，列演算条件式の中の列名は，DBPARTNER2で指定したものがそのまま印刷されます。

7　オプション（［ツール］メニュー）

この章では，DBPARTNER2の各操作で利用できるオプションについて説明します。

7.1　オプションの設定

DBPARTNER2を操作するときのオプションの設定方法について説明します。

7.1.1　指定できるオプション

DBPARTNER2では，次に示すオプションが設定できます。

(1)　抽出に関するオプション

抽出時間の上限の設定

あらかじめ，データを抽出する時間の上限を設定できます。

データ確認の使用

実際にデータを抽出する前に，抽出するデータをメモ帳（Notepad. exe）などに表示させて確認できます。

転送先ファイルの設定

抽出したデータを転送するファイルを設定します。

(2)　表示に関するオプション

手順ファイル実行時の［実行値入力］ダイアログボックスの表示

可変記号を設定した手順ファイル実行時に，可変記号に対する実行値を入力する場合に設定します。このオプションを設定しないと，可変記号の設定時に設定した初期値で実行されます。

可変記号のソート設定

［実行値入力］ダイアログボックスの可変記号をソートして表示する場合に設定します。

手順ファイル一覧表示時のファイル情報の表示

手順ファイルの一覧にファイル情報（コメント）を表示する場合に設定します。

転送先ファイルの上書きメッセージを表示

抽出データを抽出データ格納ファイルに転送するときに，上書きメッセージを表示するかどうかを設定できます。

集合関数を指定した項目名の見出し表示

集合関数を指定した場合に抽出結果に表示する列名を，列見出しを使って表示するときに設定します。

インデクス情報を表示

列がインデクスとして定義されているかどうかを表示する場合に設定します。

表一覧情報の表示方法

抽出する表を選択するときに，表一覧情報に表示する方法を設定できます。

(3)　見出し辞書に関するオプション

見出し辞書の使用

抽出する表や列を選択するときに，見出し辞書を使えます。

(4)　［オプション設定］ダイアログボックス

オプションの設定で使う［オプション設定］ダイアログボックスを次に示します。

ここでは，［抽出］タブを選んだときの表示例で示します。

タイトルバー

「オプション設定」と表示されます。

［抽出］タブ

抽出に関するオプションが表示されます。

［表示］タブ

表示に関するオプションが設定されます。

［見出し辞書］タブ

見出し辞書に関するオプションが設定されます。

［OK］ボタン

設定したオプションを確定します。

［キャンセル］ボタン

オプションの設定を取り消します。

(5)　操作

オプションを設定する操作を次の図に示します。

図7‒1　オプションを設定する操作

［DBPARTNER2］ウィンドウの［ツール(X)］−［オプション(O)...］メニューを選びます。

［オプション設定］ダイアログボックスが表示されます。

各オプションを設定します。

次のオプションが設定できます。

抽出時間の上限の設定

参照：「7.1.2　抽出時間の上限の設定」

手順ファイル実行時の実行値入力画面の表示

参照：「7.1.3　手順ファイル実行時の［実行値入力］ダイアログボックス表示」

データの確認

参照：「7.1.4　抽出データの確認」

見出し辞書の使用

参照：「7.1.5　見出し辞書の指定」

表一覧情報の表示方法

参照：「7.1.6　表一覧情報の表示方法」

手順ファイルの一覧にファイル情報を表示

参照：「7.1.7　手順ファイルのファイル情報の表示」

転送先ファイルの上書きメッセージの表示

参照：「7.1.8　転送先ファイルの上書きメッセージの表示」

インデクス情報の表示

参照：「7.1.9　インデクス情報の表示」

集合関数を指定した項目名の見出し表示

参照：「7.1.10　集合関数指定時の列の見出し表示」

転送先ファイルの設定

参照：「7.1.11　転送先ファイルの設定」

可変記号のソート設定

参照：「7.1.12　可変記号のソート設定」

設定後，［OK］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(6)　注意

DBPARTNER2の終了時オプションの設定内容が，再起動時も引き継がれます。

表定義で表見出し及び列見出しを定義すると，自動的に見出し辞書に登録されます。また，定義した表見出し及び列見出しを編集又は削除した場合も同様です。

7.1.2　抽出時間の上限の設定

抽出するデータが多く，サーバを占有する時間が長くなるとサーバへの負荷が大きくなります。このようなサーバへの負荷を少なくしたい場合や運用に応じた稼働条件を設定したい場合に，抽出時間の上限を設定します。

抽出時間は，データの抽出を開始してからカウントされます。［DBPARTNER2］ウィンドウで件数表示を設定している場合は，［件数表示］ダイアログボックスが表示されて，そこで［OK］ボタンをクリックしてからの時間がカウントされます。サーバからデータを抽出中に中断した場合，中断している間の時間はカウントされません。

オプションを設定後，［抽出］メニューでデータを抽出する操作をしてください。

サーバからデータの抽出中に設定した時間を超えると，メッセージのダイアログボックスが表示されて，データの抽出が中断されます。転送先がファイルの場合，それまでに抽出されたデータは，転送されます。

(1)　操作

［オプション設定］ダイアログボックスの［抽出］タブをクリックして，［抽出時間の上限］の［設定する］オプションボタンをオンにします。そして，上限とする時間を設定します。キーボードから入力する場合は，1〜999の範囲で指定してください。

(2)　注意

抽出時間の上限の時間を超えると，データの抽出は中断されますが，タイミングによっては，設定した時間と実際に中断される時間がずれることがあります。

7.1.3　手順ファイル実行時の［実行値入力］ダイアログボックス表示

可変記号を設定した手順ファイルを実行するときに実行値を入力します。通常，手順ファイルを実行すると，可変記号の初期値が実行値となります。このオプションを設定すると，実行時に［実行値入力］ダイアログボックスが表示されるので，可変記号に対する実行値を入力できます。

可変記号を設定した手順ファイルの実行方法については，「4.2.7　可変記号を使ったデータの抽出」を参照してください。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［手順実行時の実行値入力画面表示(E)］チェックボックスをオンにします。

7.1.4　抽出データの確認

データを抽出する前に，内容をメモ帳（Notepad. exe）などに表示させて，抽出するデータを確認できます。このオプションでは，確認するデータを表示させるアプリケーションと表示させるデータの件数を指定します。

データ確認の操作については，「4.2.9　データの確認（抽出，絞り込み（条件付加），絞り込み（保存利用））」を参照してください。

(1)　操作

データ確認のオプションを設定する操作を次に示します。

［オプション設定］ダイアログボックスの［抽出］タブをクリックして，［データ確認(I)］チェックボックスをオンにします。

確認するデータの件数を設定します（初期値は5件です）。

キーボードから入力する場合は，1〜32767の範囲で指定してください。

［表示プログラム(A)］テキストボックスに，データを表示させるプログラムが格納されているドライブ，フォルダ，ファイル名を設定します。

ファイルの種類は拡張子が「.exe」でなければなりません。

［表示プログラム(A)］テキストボックスには，今までに選択したプログラムのうち最新の5個が表示されます。この中から選択することもできます。

［…］ボタンを押すと，［表示アプリケーション設定］ダイアログボックスが表示されます。ここでプログラムが格納されているドライブ，フォルダ，ファイル名を設定することもできます。

［OK］ボタンをクリックします。

［オプション設定］ダイアログボックスに戻ります。

(2)　注意

確認するデータはTEXT形式で出力されるので，表示させるアプリケーションにはTEXT形式をサポートしているアプリケーションを指定してください。

7.1.5　見出し辞書の指定

抽出する表や列を選ぶときに，あらかじめ登録した表名や列名で表示できます。表示する表名や列名は，見出し辞書に登録します。

表名や列名を見出し辞書を使って表示するときは，見出し辞書の内容だけを表示することも，見出し辞書とDBの情報（データベースに定義してある表名や列名）を組み合わせて表示することもできます。

見出し辞書を使う操作の手順については「4.2.11　見出し辞書の使用」を，見出し辞書を編集する方法については「9.5　見出し辞書の編集」参照してください。

(1)　操作

見出し辞書を指定する操作を次に示します。

［オプション設定］ダイアログボックスの［見出し辞書］タブをクリックして，［見出し辞書(D)］チェックボックスをオンにします。

見出し辞書だけを使うかデータベースの情報と組み合わせるかを，コンボボックスで選びます。

DBPARTNER2の情報を使用する

見出し辞書に登録した情報だけを表示します。

DBPARTNER2とDBの情報を使用する

見出し辞書に登録した情報とデータベースの情報を組み合わせて表示します。

オプションボタンは淡色表示されて，選べません。

見出し辞書の参照フォルダを変更するときは，［辞書フォルダ］に参照するフォルダを設定します。

フォルダの設定は，直接，又は参照入力できます。参照入力の場合，［…］ボタンを押すと，［辞書の指定］ダイアログボックスが表示されます。ここで見出し辞書の参照フォルダを指定すると，［辞書フォルダ］に表示できます。

(2)　注意

見出し辞書とDBの情報を組み合わせて表示する場合に，見出し辞書に登録していない表や列があるときは，データベースに定義してある情報だけが表示されます。

見出し辞書だけを使う指定（データベースの情報を組み合わせない指定）のときは，見出し辞書に登録していない表名は，表を選ぶときに表示されないで使えなくなります。

見出し辞書だけを使う指定をすると，接続先に関係なく，見出し辞書に登録されている表がすべて表示されます。

7.1.6　表一覧情報の表示方法

データを抽出する表を選択するときに，表一覧情報の表示方法を選択します。

最新を常に表示する

［DBPARTNER2］ウィンドウの［表名(T)...］ボタンを押すと，常に最新の表一覧情報を表示します。

1回目の情報を表示する

［DBPARTNER2］ウィンドウの［表名(T)...］ボタンを押すと，2回目からは，最初に［表選択］ダイアログボックスに表示した表一覧情報を表示します。

「最新を常に表示する」場合，データベースの最新の表が利用できます。「1回目の情報を表示する」場合，1回目は，サーバにアクセスして表一覧を取得しますが，2回目以降は，アクセスしません。このため，サーバにアクセスしている間の待ち時間がありません。

表一覧情報は，ソートして表示することもできます。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［表一覧情報を毎回サーバから取得して表示(P)］チェックボックスのオン・オフを切り替えます。

最新を常に表示する場合

［表一覧情報を毎回サーバから取得して表示(P)］チェックボックスをオンにします。

1回目の情報を表示する場合

［表一覧情報を毎回サーバから取得して表示(P)］チェックボックスをオフにします。

表定義及び見出し編集をすると，次の操作では，オプションの設定にかかわらず最初の表一覧情報が表示されます。

表一覧情報をソートして表示したい場合は，［表一覧情報をソートして表示(O)］チェックボックスをオンにします。

(2)　注意

1回目の情報を表示する場合，DBPARTNER2を終了するか接続形態を変更するまで同じ表一覧を表示します。

7.1.7　手順ファイルのファイル情報の表示

手順ファイルの一覧を表示するときに，ファイル情報（コメント）を表示できます。手順ファイルにコメントを付けている場合には，表示するとコメントから手順ファイルを選択できるので便利です。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［手順の一覧にファイル情報を表示(M)］チェックボックスをオンにします。

注意

DBPARTNER/Client32（02-04）形式で手順ファイルを登録したいときは，チェックボックスをオフにしてください。オンの状態では登録できません。

7.1.8　転送先ファイルの上書きメッセージの表示

抽出データを抽出データ格納ファイルに転送するときに，上書きメッセージを表示するかどうかを設定できます。誤って必要なファイルを上書きしないようにメッセージを出力できます。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［転送先ファイルの上書きメッセージを表示(W)］チェックボックスをオンにします。

7.1.9　インデクス情報の表示

表の列を一覧表示するときに，列に定義されているインデクスの情報も同時に表示するかどうかを設定できます。表示する設定をした場合，インデクス情報は次のダイアログボックスに表示されます。

［条件設定］ダイアログボックス

［更新条件の列の設定］ダイアログボックス

表示されるインデクス情報は，次のとおりです。

インデクス種別

表内の列にインデクスが定義されている場合，［条件設定］ダイアログボックス及び［更新条件の列の設定］ダイアログボックスを開くと，列表示領域に次のどれかの文字列が表示されます。

UNQ：列にユニークインデクスが定義されていることを示します

DUP：列に重複インデクスが定義されていることを示します

表示時の規則は次のとおりです。

文字列が［　］で囲んで表示されている列は，一つのインデクスが複数の列から構成されている場合の2列目以降であることを示します。

1列に複数のインデクスが定義されている場合は，ユニークインデクス（UNQ），重複インデクス（DUP）の優先順位で，一つだけ表示されます。

繰り返し列にインデクスがある場合は，繰り返し列の要素の先頭列に表示されます。

インデクス名

［更新条件の列の設定］ダイアログボックスで選択した列にインデクスが定義されている場合，インデクス名がインデクス名表示領域に表示されます（インデクス種別も同時に表示されます）。

1列に複数のインデクスが定義されている場合は，空白で区切ってすべてのインデクス名が表示されます。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［インデクス情報を表示(X)］チェックボックスをオンにします。

7.1.10　集合関数指定時の列の見出し表示

通常，列に集合関数を指定して抽出した場合，抽出結果の1行目には見出し辞書オプションの指定にかかわらずデータベースでの列名が表示されてしまいます。

この集合関数指定項目の見出し表示オプションを使うと，列に集合関数を指定した場合でも，抽出結果では見出し辞書オプションの指定に従って，データベースの列見出し（列ヘッダ）や見出し辞書の列見出しが表示できます。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［集合関数を指定した項目名の見出し表示(F)］チェックボックスをオンにします。

(2)　注意

集合関数の項目と列の表示形式は，接続形態によって異なります。表示形式を次に示します。

接続形態

集合関数指定項目の見出し表示

オプション指定なし

オプション指定あり

ODBC接続時

英字集合関数名（列名）

漢字集合関数名({列名|列ヘッダ|列見出し})

注

英字集合関数名とは，「MAX」（最大），「MIN」（最小），「AVG」（平均），「SUM」（合計）又は「COUNT」（件数）です。

ODBC接続時，漢字集合関数名とは，「最大」，「最小」，「平均」，「合計」又は「件数」です。

7.1.11　転送先ファイルの設定

抽出するデータの転送先は，［DBPARTNER2］ウィンドウの転送先で設定します。オプションであらかじめ，転送先ファイルを設定しておくと［DBPARTNER2］ウィンドウを表示したときに設定したファイル名が表示されます。また，通常は［DBPARTNER2］ウィンドウで転送先を変更すると，その次に［DBPARTNER2］ウィンドウで表示されるのは変更後のファイル名ですが，「毎回有効」を設定しておくと，毎回オプションで設定したファイル名が［DBPARTNER2］ウィンドウに表示されます。

(1)　操作

［オプション設定］ダイアログボックスの［抽出］タブをクリックして，［転送先(R)］テキストボックスに，データを転送するファイル名を設定します。

［…］ボタンを押すと，［転送先のファイル名の設定］ダイアログボックスが表示されます。ここでデータを転送するファイル名を設定することもできます。

［OK］ボタンをクリックします。

［オプション設定］ダイアログボックスが表示されます。

有効範囲を設定します。

起動時のみ有効(S)

DBPARTNER2の起動時に転送先ファイルが有効になります。起動後，転送先ファイルを変更すると，変更後のファイル名が有効になり，次に［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンで［転送先設定］ダイアログボックスを表示したときには，変更後のファイル名が表示されます。

毎回有効(E)

［DBPARTNER2］ウィンドウの［転送先(O)...］ボタンで［転送先設定］ダイアログボックスを表示するときは，毎回このオプションで設定したファイル名が表示されます。

(2)　注意

転送先ファイル名は，絶対パス名で指定してください。

ファイル名を設定しないか，又は空白を指定した場合は，［転送先設定］ダイアログボックスの転送先に何も表示されないので，毎回，転送先を設定する必要があります。

7.1.12　可変記号のソート設定

通常，［実行値入力］ダイアログボックスに表示される可変記号は，可変記号を指定した順に表示されます。オプションで設定しておくと，可変記号を可変記号名でソートして表示できます。

(1)　操作

［オプション設定］ダイアログボックスの［表示］タブをクリックして，［可変記号のソート(S)］チェックボックスをオンにします。

7.2　DBPARTNER2からのSQL文の入力と実行

データベースに対して，直接SQL文を入力してアクセスできます。また，作成したSQL文は，テキスト形式でファイルに保存できます。

この機能は，ODBC接続の場合だけ使えます。

SQL文は，［DBPARTNER2］ウィンドウの［SQL(Q)］−［SQL入力実行(S)...］メニューで開く［SQL入力］ダイアログボックスで入力又は実行します。

7.2.1　［SQL入力］ダイアログボックス

［SQL入力］ダイアログボックスを次に示します。

タイトルバー

「SQL入力」と表示されます。

［転送先(O)...］ボタン

抽出したデータの転送先を設定するための，［転送先設定］ダイアログボックスが表示されます。

［SQL(S)］

ここにSQL文を入力します。

［実行履歴(I)］

実行されたSQL文が表示されます。

［コピー(P)］ボタン

［実行履歴(I)］で選択したSQL文が，［SQL(S)］の入力エリアに表示されます。

［開く(F)...］ボタン

保存されているSQL文のファイルを開くときに指定します。［SQLのファイルを開く］ダイアログボックスが表示されます。

［保存(V)...］ボタン

［SQL(S)］の入力エリアに入力したSQL文をファイルに保存するときに指定します。

［SQLのファイルに保存］ダイアログボックスが表示されます。

［クリア(C)］ボタン

［SQL(S)］の入力エリアに表示されているSQL文が消去されます。

［パラメタ(R)...］

［パラメタ設定］ダイアログボックスが表示されます。？パラメタを指定したSQLを手順ファイルに登録するときは，必ず［パラメタ設定］ダイアログボックスで？パラメタの情報を設定してください。

［手順登録(A)...］ボタン

SQL入力エリアに入力されたSQL文を手順ファイルに登録するボタンです。［手順ファイルの登録］ダイアログボックスが表示されます。

［実行(U)］ボタン

［SQL(S)］の入力エリアに表示されているSQL文が実行されます。

［終了(X)］ボタン

このダイアログボックスが閉じて，［DBPARTNER2］ウィンドウに戻ります。

(1)　［パラメタ設定］ダイアログボックス

［パラメタ設定］ダイアログボックスでは，？パラメタの情報を設定します。？パラメタの情報を設定して手順ファイルに登録すると，手順ファイル実行時に実行値を入力できます。？パラメタの実行値入力については，「4.2.7　可変記号を使ったデータの抽出」を参照してください。

［パラメタ設定］ダイアログボックスは，［SQL入力］ダイアログボックスの［パラメタ(R)...］ボタンをクリックすると表示されます。［パラメタ設定］ダイアログボックスを次に示します。

［可変記号名］入力エリア

可変記号名を入力するエリアです。

［初期値入力］エリア

初期値を入力するエリアです。

［設定］ボタン

入力した可変記号名と初期値を設定するボタンです。

［パラメタ一覧］エリア

？パラメタ情報を一覧で表示するエリアです。

［OK］ボタン

設定を有効にしてダイアログボックスを閉じます。

［キャンセル］ボタン

設定を無効にしてダイアログボックスを閉じます。

規則

可変記号名で使用できる文字は全角文字，半角片仮名，及び半角英数字です。

可変記号名は＆（アンパサンド）文字を除いて254文字まで指定できます。

可変記号名の前後の半角スペースはサプレスされます。

可変記号名の文字列中に半角スペースは指定できません。

可変記号名には初期値が設定できます。初期値は手順ファイル実行時に［実行値入力］ダイアログボックスで実行値を入力しない場合に実行値として処理されます。

初期値は，255バイトまで指定できます。

同一可変記号名は指定できません。

7.2.2　操作

［DBPARTNER2］ウィンドウで，［SQL(Q)］−［SQL入力実行(S)...］を選びます。

［SQL入力］ダイアログボックスが表示されます。

補足

一度ファイルに保存したSQL文を，［SQL入力］ダイアログボックスを表示しないで実行する場合は，［ファイルから実行(F)...］ボタンを選んでください。［SQLをファイルから実行］ダイアログボックスが表示されます。ファイルを選択して［OK］ボタンをクリックすると，保存されているSQL文が実行されます。

SQL文を入力します。

補足

ファイルに保存してあるSQL文を読み込む場合は，［開く(E)...］ボタンをクリックしてください。

入力したSQL文をファイルに保存する場合は，［保存(V)...］ボタンをクリックしてください。SQL文はテキスト形式で保存されるので，エディタなどで編集できます。

転送先にはDBPARTNER2で指定されている転送先が表示されます。変更する場合は，［転送先(O)...］ボタンをクリックしてください。［転送先設定］ダイアログボックスが表示されます。ただし，［SQL入力］ダイアログボックスから呼び出した［転送先設定］ダイアログボックスでは，転送先をデータベースにできません。

［実行(U)］ボタンをクリックします。

指定したSQL文がデータベースで実行されます。

SELECT文を指定した場合は，［転送経過表示］ダイアログボックスが表示され，転送先にデータが抽出されます。SELECT文以外を指定した場合は，実行結果のメッセージダイアログボックスが表示されます。

SQL文の処理が終了すると，［SQL入力］ダイアログボックスに戻ります。実行されたSQL文が，実行履歴の先頭に表示されています。

補足

一度実行したSQL文をもう一度実行したいときは，実行履歴に表示されているSQL文を選択して，［コピー(P)］ボタンをクリックしてください。選択されたSQL文が，SQL入力エリアに表示されて，［実行(U)］ボタンをクリックすることで実行できます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

7.2.3　注意

SQL入力エリアには，改行コードを入力できます。SQL文の実行時には，改行コードは削除されて，1行のSQL文として実行されます。

入力できるSQL文の最大長は，改行コード（2バイト）を含めて30,000バイトです。

この機能を使う場合，接続先定義ファイルの次のパラメタは無効になります。

UPDUNIT

UPDFIN

SQL文実行時には，次に示す機能が使えません。

見出し辞書

Excelからのデータの更新

SQL文の保存又は読み込みをするときの，ファイルを格納するフォルダの仮定値は，DBPARTNER2をインストールしたフォルダです。

実行履歴に表示されるSQL文が長くなり過ぎると，データの右側が表示されない，又はデータの一部が消えてしまう場合があります。そのような場合は，SQL入力エリアに表示して確認してください。

SELECT（大文字小文字は区別しません）で始まるSQL文を指定した場合だけSELECT文として扱います。

8　列と条件を設定するときの規則

この章では，データを抽出するときの，列と条件の設定方法と設定するときの規則について説明します。

説明中の列属性は，DBPARTNER2のダイアログボックスで表示する列の属性です。それぞれのデータベースのデータ型との対応については，「付録D　DBPARTNER2の列属性」を参照してください。

8.1　表を設定するときの規則

同時に選択できる表の数は15までです。

VOS3 XDM/SD E2を使用する場合は，複数の表を選択するとエラーになります。

項目

内容

所有者

ジョブを実行したユーザID

表名

'ジョブ通し番号'，'ファイル通し番号'を連結した文字列

表見出し

ジョブの名称

作成日付

'YYMMDDhhmmss'

（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

コメント

ジョブに付けたコメント情報

8.2　列を設定するときの規則

VOS3 XDM/SD E2を使用する場合は，仮想列を設定するとエラーになります。

8.2.1　集合関数の規則

グループは，255列まで設定できます。

集合関数の設定は，列属性によっては使用できない集合関数があります。列属性と使用できる集合関数を次の表に示します。

表8‒1　列属性と使用できる集合関数の組み合わせ（ODBC）

DBPARTNER2の表示

グループ

最大

最小

平均

合計

件数

NUMERIC

○

○

○

○

○

○

UNSIGNED_NUMERIC

○

○

○

○

○

○

DECIMAL

○

○

○

○

○

○

SMALLINT

○

○

○

○

○

○

INTEGER

○

○

○

○

○

○

REAL

○

○

○

○

○

○

FLOAT

○

○

○

○

○

○

BIT

○

○

○

○

○

○

TINYINT

○

○

○

○

○

○

BIGINT

○

○

○

○

○

○

DOUBLE

○

○

○

○

○

○

CHAR

○

○

○

×

×

○

VARCHAR

○

○

○

×

×

○

LONG VARCHAR

○

○

○

×

×

○

NCHAR

○

○

○

×

×

○

NVARCHAR

○

○

○

×

×

○

LONG NVARCHAR

○

○

○

×

×

○

MCHAR

○

○

○

×

×

○

MVARCHAR

○

○

○

×

×

○

LONG MVARCHAR

○

○

○

×

×

○

DATE

○

○

○

×

×

○

TIME

○

○

○

×

×

○

TIMESTAMP

○

○

○

×

×

○

BINARY

○

○

○

×

×

○

VARBINARY

○

○

○

×

×

○

（凡例）

○：設定できます。

×：設定できません。

VOS3 XDM/SD E2を使用する場合は，集合関数を設定するとエラーになります。

8.2.2　ソートの規則

ソートは，255列まで設定できます。

VOS3 XDM/SD E2を使用する場合は，ソートを設定するとエラーになります。

8.3　条件を設定するときの規則

表結合（LEFT OUTER JOIN）は，SQLGetInfoでSQL_OUTER_JOINSが'N'以外で返された場合だけ抽出ができます。'N'の場合は，抽出実行時にエラーになります。

VARBINARY，LONG VARBINARYの列には列と列の比較以外の条件は設定できません。

VOS3 XDM/SD E2を使用する場合は，表結合条件を設定するとエラーになります。

8.3.1　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使用できない定数があります。列属性と使用できる定数の組み合わせを次の表に示します。

表8‒2　列属性と使用する定数（ODBC）

列属性

使用する定数

CHAR

文字

VARCHAR

文字

LONG VARCHAR

文字

MCHAR

文字

MVARCHAR

文字

LONG MVARCHAR

文字

NCHAR

日本語文字

NVARCHAR

日本語文字

LONG NVARCHAR

日本語文字

NUMERIC

10進数

UNSIGNED_NUMERIC

10進数

DECIMAL

10進数

SMALLINT

整数

INTEGER

整数

BIT

整数

TINYINT

整数

BIGINT

整数

REAL

浮動小数点

FLOAT

浮動小数点

DOUBLE

浮動小数点

DATE

日付の文字表現

TIME

時間の文字表現

TIMESTAMP

タイムスタンプ

BINARY

16進数

VOS3 XDM/SD E2を使用する場合は，演算子の'<>'を設定するとエラーになります。

8.3.2　NULL条件の規則

VOS3 XDM/SD E2を使用する場合は，NULL条件を設定するとエラーになります。

8.3.3　IN条件の規則

定数の設定規則は，「表8-2　列属性と使用する定数（ODBC）」に従ってください。

定数は，255個まで設定できます。

VOS3 XDM/SD E2を使用する場合は，IN条件を設定するとエラーになります。

8.3.4　LIKE条件の規則条件で指定する定数の規則

LIKE条件が設定できる列属性を次に示します。

CHAR，VARCHAR，LONG VARCHAR，NCHAR，NVARCHAR，LONG NVARCHAR，MCHAR，MVARCHAR，LONG MVARCHAR

VOS3 XDM/SD E2を使用する場合は，LIKE条件を設定するとエラーになります。

列と文字パターン（定数）の規則は，「表8-2　列属性と使用する定数（ODBC）」に従ってください。

・'_'，'%'は，指定できる定数に応じて，全角又は半角を使用してください。

使用する定数

文字種別

文字

半角文字の'_'，'%'

日本語文字

全角文字の'＿'，'％'

文字パターンの指定方法を次の表に示します。

表8‒3　文字パターンの指定方法（ODBC）

項目

指定例

意味

前方一致

ABC%

文字列の先頭がABCであり，以降の文字は任意である。

後方一致

%ABC

文字列の最後がABCであり，以前の文字は任意である。

任意一致

%ABC%

文字列中の任意の部分がABCである。

完全一致

ABC

文字列がABCと等しい。

部分一致

_ _ABC_

6文字の文字列のうち，3〜5文字目がABCであり，ほかの部分は任意の文字である。

その他

ABC%DE

文字列の先頭がABCであり，最後がDEである。

%ABC%DE%

文字列中の任意の部分にABCを含み，以降の任意の部分にDEを含む。

ABC_ _DE%

文字列の先頭がABCであり，2文字の任意の文字列を挟んでDEである。

8.3.5　BETWEEN条件の規則

列と定数の規則は，「表8-2　列属性と使用する定数（ODBC）」に従ってください。

VOS3 XDM/SD E2を使用する場合は，BETWEEN条件を設定するとエラーになります。

8.3.6　列と列の比較条件の規則

列と列の比較は，列属性によっては使用できない組み合わせがあります。比較できる列属性の組み合わせを次の表に示します。

表8‒4　比較できる列属性の組み合わせ（ODBC）

左辺

右辺

CHAR，VARCHAR，LONG VARCHAR，MCHAR，MVARCHAR，LONG MVARCHAR，NCHAR，NVARCHAR，LONG NVARCHAR

CHAR，VARCHAR，LONG VARCHAR，MCHAR，MVARCHAR，LONG MVARCHAR，NCHAR，NVARCHAR，LONG NVARCHAR

NUMERIC，UNSIGNED_NUMERIC，DECIMAL，SMALLINT，INTEGER，REAL，FLOAT，BIT，TINYINT，BIGINT，DOUBLE

NUMERIC，UNSIGNED_NUMERIC，DECIMAL，SMALLINT，INTEGER，REAL，FLOAT，BIT，TINYINT，BIGINT，DOUBLE

DATE

DATE

TIME

TIME

BINARY，VARBINARY，

LONG VARBINARY

BINARY，VARBINARY，

LONG VARBINARY

TIMESTAMP

TIMESTAMP

VOS3 XDM/SD E2を使用する場合は，演算子の'<>'を設定するとエラーになります。

8.3.7　列演算条件の規則

演算は，各辺の「+」，「−」，「*」，「/」，又は「(」，「)」の総和が64個まで指定できます。

四則演算で除算子（/）の後ろに0は指定できません。

演算子（*，+，/，−）の合計は255までです。

演算を指定できる定数を次に示します。

整数，10進数，浮動小数点

演算を指定できる列属性を次に示します。

NUMERIC，UNSIGNED_NUMERIC，DECIMAL，SMALLINT，INTEGER，REAL，FLOAT，BIT，TINYINT，BIGINT，DOUBLE

列と定数を比較するときは，「表8-2　列属性と使用する定数（ODBC）」に従ってください。

VOS3 XDM/SD E2を使用する場合は，列演算条件を設定するとエラーになります。

8.3.8　条件関連の規則

NOT，AND及びORを組み合わせて，255個まで指定できます。

括弧，NOT，AND及びORの優先順位は，括弧>NOT>AND>ORです。

括弧，NOT，AND及びORは，すべて半角文字で指定してください。

NOT，AND及びORの前後には空白を入力してください。

VOS3 XDM/SD E2を使用する場合は，NOTを設定するとエラーになります。

8.3.9　件数確認の規則

VOS3 XDM/SD E2を使用する場合は件数確認を設定するとエラーになります。

8.3.10　各条件で指定する定数の規則

各条件で指定する定数の規則を次の表に示します。

表8‒5　定数の指定方法（ODBC）

定数の種類

指定方法

指定範囲

指定例

整数

［符号］符号なし整数

−（10³⁰−1）〜（10³⁰−1）

123，−123

10進数

［符号］整数部．小数部

10⁻²⁹〜（10³⁰−1），

−（10³⁰−1）〜−10⁻²⁹，及び0

45.6，−45.6

浮動小数点

［符号］仮数E［符号］指数

約1.7E−308〜1.7E+308，

約−1.7E+308〜−1.7E−308，及び0

5.1E3，

−5.1E−3

文字

［'］全角及び半角の文字列［'］

1〜255バイト

ABC，テレビ

日本語文字

［'］全角の文字列［'］

1〜127文字

テレビ

16進

［'］0〜9，A〜Fの半角の文字列［'］

1〜254バイト

9F

日付の文字表現

［'］YYYY-MM-DD［'］

年（YYYY），月（MM），日（DD）をハイフンで結ぶ

YYYY：0001〜9999

MM：01〜12

DD：01〜その月の最終日

1998-05-05

時間の文字表現

［'］HH:MM:SS［'］

時（HH），分（MM），秒（SS）をコロンで結ぶ

HH：00〜23

MM：00〜59

SS：00〜59

15:32:52

タイムスタンプ

（16けた）

［'］YYYY-MM-DD△HH:MM［'］

日付の文字表現と時間の文字表現の時分をスペースで結ぶ

YYYY，MM，DDは，日付の文字表現参照

HH，MMは，時間の文字表現参照

1998-05-05 15:32

タイムスタンプ

（19けた）

［'］YYYY-MM-DD△HH:MM:SS［'］

日付の文字表現と時間の文字表現をスペースで結ぶ

YYYY，MM，DDは，日付の文字表現参照

HH，MM，SSは，時間の文字表現参照

1998-05-05 15:32:52

タイムスタンプ

（23けた）

［'］YYYY-MM-DD△HH:MM:SS［.XXX［'］］

日付の文字表現と時間の文字表現をスペースで結び，コンマの後ろにミリ秒（XXX）を付ける

YYYY，MM，DDは，日付の文字表現参照

HH，MM，SSは，時間の文字表現参照

XXX：000〜999

1998-05-05 15:32:52.092

タイムスタンプ

（26けた）

［'］YYYY-MM-DD△HH:MM:SS

［.XXXXXX［'］］

日付の文字表現と時間の文字表現をスペースで結び，コンマの後ろにミリ秒（XXXXXX）を付ける

YYYY，MM，DDは，日付の文字表現参照

HH，MM，SSは，時間の文字表現参照

XXXXXX：000000〜999999

1998-05-05 15:32:52.092856

（凡例）

△：半角の空白

8.4　更新処理の規則

更新処理の規則について説明します。

8.4.1　連携先と更新できる列の属性と定義長

特定の列属性のデータは，連携先に抽出する過程で更新できない状態になります。連携先と列属性の制限と定義長を次の表に示します。

表8‒6　 連携先と列属性の制限と定義長

DBPARTNERの列属性

［データ表示］ウィンドウ，

Excel 65536行対応

Excel

SINGLE

SINGLE以外

CHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

NUMERIC

○

○

○

DECIMAL

○

○

○

INTEGER

○

○

○

SMALLINT

○

○

○

FLOAT

○

○

○

REAL

○

○

○

DOUBLE

○

○

○

DATE

○

○

○

TIME

○

○

○

TIMESTAMP

○

○

○

VARCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

LONG VARCHAR

○※1（255バイト以下）

○※1（4096バイト以下）

○※1（255バイト以下）

BINARY

○（2048バイト以下）

○（2048バイト以下）

○（127バイト以下）

VARBINARY

×

×

×

LONG VARBINARY

×

○※2

×

BIGINT

○

○

○

TINYINT

○

○

○

BIT

○

○

○

NCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

NVARCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

LONG NVARCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

MCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

MVARCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

LONG MVARCHAR

○（255バイト以下）

○（4096バイト以下）

○（255バイト以下）

UNSIGNED_NUMERIC

○

○

○

（凡例）

○：更新できます。

×：更新できません。

（ ）：定義長の制限です。括弧がないものは定義長の制限がありません。

注※1

ORACLEの場合は更新できません。

注※2

データ表示ウィンドウの場合だけ更新できます。

8.4.2　列の定義長の制限

定義長が4096バイトを超える列は更新できません。

8.4.3　データベースごとの制限

ORACLE

表名／列名の変更はできません。

8.4.4　LONG VARBINARY属性の規則

LONG VARBINARY属性の列はバイナリデータとして抽出，更新ができます。

データ表示ウィンドウと連携する場合だけ，抽出，更新ができます。

抽出した，LONG VARBINARY属性のデータは一時ファイルに出力します。

LONG VARBINARY属性の列は更新条件になりません。LONG VARBINARY属性の列だけを抽出した場合，更新はできません。

接続先定義ファイルのUPDINITパラメタにSINGLEを指定した場合，LONG VARBINARY属性の列を更新することはできません。

LONG VARBINARY属性のデータを抽出するときは，列選択が必要となります。列選択されていない場合はエラーになります。

8.4.5　UPDUNIT = ROWIDでの更新の規則

接続先定義ファイルでUPDUNIT = ROWIDを使用した更新（変更，削除）を実行できるのは，次に示すデータベースの場合だけです。

HiRDB

VOS3 XDM/RD E2

ORACLE

9　定義（［定義］メニュー）

DBPARTNER2からデータベースへ表を定義する方法と，見出し辞書を編集する方法について説明します。

9.1　表定義の概要

DBPARTNER2からデータベースへの表定義の概要について説明します。

DBPARTNER2のGUIを使うと，SQLを使わなくても，画面に定義情報を入力して表を定義できます。また，定義した表は編集したり削除したりできます。

9.1.1　操作

データベースに表を定義するときは，［表定義］ダイアログボックスを使います。操作の手順を次に示します。

［表定義］ダイアログボックスから表名，表見出し及び表注釈を定義します。

参照：「9.2.1　表定義」

［列定義］ダイアログボックスから列名，列見出し，列属性，データ長及び小数点以下のけた数を定義します。

参照：「9.2.2　列定義」

補足

［列定義］ダイアログボックスで必要な項目を入力したら，定義した表に対する詳細情報を定義できます。

定義できる詳細情報と参照個所を次の表に示します。

表9‒1　列定義の終了後に定義できる詳細情報

定義情報

参照個所

列注釈

「9.2.3　列詳細定義」

NULL抑止の指定

表の格納領域

「9.2.4　格納領域設定」

表の格納条件

インデクス

「9.2.5　インデクス定義」

既存の表を削除することもできます。参照：「9.3　表の削除」

また，HiRDBにアクセスしている場合は，既存の表の表名・列名を変更できます。参照：「9.4　表名・列名変更」

データベースへ表を定義する処理を中断した場合

［表定義］ダイアログボックスで表定義をして，データベースへ表を作成する処理中にエラーが発生するか，又は［キャンセル］ボタンをクリックすると，処理が中断されます。処理が中断された場合，タイミングによってはデータベースに表が作成されることがあります。その場合は［定義］メニューの［表削除(D)］で作成した表を削除してください。

9.1.2　注意

サーバにはDABrokerをインストールしてください。

表を定義又は削除する場合は，定義先（定義元）サーバにDABrokerがインストールされている必要があります。

定義版のDBPARTNER2をインストールしてください。

表の定義，編集及び削除の機能を利用する場合は，クライアントPCに定義版のDBPARTNER2をインストールしてください。定義版がインストールされていないと［DBPARTNER2］ウィンドウの［定義］プルダウンメニューのうち［表定義・更新(C)...］及び［表削除(D)...］は淡色表示され，使えません。

見出し辞書を使用する場合，「DBPARTNER2とDBの情報を使用する」を選択してください。

見出し辞書を使用し，かつ表の定義，編集及び削除の機能を利用する場合は，見出し辞書は「DBPARTNER2とDBの情報を使用する」を選択してください。「DBPARTNER2の情報を使用する」を選択すると，［DBPARTNER2］ウィンドウの［定義］プルダウンメニューのうち［表定義・更新(C)...］，［表削除(D)...］及び［表名・列名変更(A)...］が淡色表示され，使えません。

9.2　表の定義

データベースへ表を定義する方法について，HiRDBへ表を定義する方法を中心に説明します。定義する表について次に示します。表見出し，及び列見出しを設定する場合は，見出し辞書を使用します。見出し辞書の設定については，「7.1.5　見出し辞書の指定」を参照してください。

表情報

表所有者名：USER01

表名：SHIIRE

表見出し：仕入れ

表注釈：仕入れ管理マスタ表

列情報

列名

列見出し

属性

データ長

列注釈

CODE

商品コード

CHAR

8けた（8バイト）

原価が1000円以下の商品

NAME

商品名

NCHAR

6けた（12バイト）

（列注釈を指定しない）

SPRICE

定価

INTEGER

−

OPRICE

原価

INTEGER

QUANTITY

数量

INTEGER

仕入れ数が100個以上の商品については，表「SHIIRE2」を参照

（凡例）

−：指定できません。

定義する表の内容

商品コード

商品名

定価

原価

数量

A01

色鉛筆

100

80

12

C02

ペン

300

250

48

B01

色紙

150

100

24

A02

色鉛筆

150

120

48

D01

手帳

800

600

50

C01

ペン

450

400

12

C03

ペン

350

250

30

表の格納領域

表を格納する領域名（RDエリア名）：RDAREA1

インデクス情報

インデクス名：INDEX1（ユニーク指定）

対象列名：CODE

ソート順：昇順

9.2.1　表定義

DBPARTNER2からデータベースへ表を定義できます。さらに，既にデータベースに定義されている表を編集することもできます。

データベースへの表定義は，［表定義］ダイアログボックスから実行します。

(1)　［表定義］ダイアログボックス

［表定義］ダイアログボックスを次に示します。

タイトルバー

「表定義」と表示されます。

［表所有者名］

データベースにアクセスしているユーザ名を表示します。

［表一覧取得(G)］ボタン，［▼］

既存の表の一覧情報を取得します。取得した表の一覧情報は，［▼］をクリックして表示させます。

情報表示領域

［表名(N)］の後に，定義する表特有の情報を表示します。

保存：定義する表が抽出データを絞り込んだ保存用の表であることを示します。

一時：定義する表が抽出データを絞り込んだ一時的な表であることを示します。

新規に表を定義する場合は，情報表示領域には何も表示されません。

［表名(N)］

定義する表の名称を指定します。［表一覧取得(G)］ボタンをクリックすると，既存の表の一覧情報が登録されます。既存の表を編集する場合は，［▼］をクリックして，取得した表の一覧情報から編集する表を選択します。

［表見出し(L)］

［表名(N)］に定義した表に対する表見出しを指定します。既存の表の一覧情報から表を選択した場合は，選択した表に設定されている表見出しが表示されます。

［表注釈(A)］

定義した表に対する表注釈（コメント）を指定します。既存の表の一覧情報から表を選択した場合は，選択した表に設定されている表注釈が表示されます。

［列(C)...］ボタン

［列定義］ダイアログボックスを表示します。

［列詳細(P)...］ ボタン

［列詳細定義］ダイアログボックスを表示します。

［領域(R)...］ボタン

［格納領域設定］ダイアログボックスを表示します。

［インデクス(I)...］ボタン

［インデクス定義］ダイアログボックスを表示します。

［OK］ボタン

指定した定義情報で表を定義します。

［キャンセル］ボタン

表の定義を取り消します。

ガイダンス領域

ダイアログボックスの一番下に，［表定義］ダイアログボックスの領域やボタンの簡単な操作方法が表示されます。操作方法を知りたいときは，マウスポインタを目的の領域やボタンなどに合わせてクリックしてください。

［表定義］ダイアログボックスから定義する項目を次の表に示します。

表9‒2　定義項目の一覧（［表定義］ダイアログボックス）

定義項目

最大長（バイト）

省略値

使える文字

表名※1

128※2

省略できない

※3

表見出し

30

表見出しは設定されない

半角文字，全角文字

表注釈

255※4

表注釈は設定されない

※3

注※1

表名の前後に指定した空白は無視されます。

注※2

HiRDBへ表を定義するとき，2バイトコードの文字列を使う場合は，最大長は15文字です。

注※3

定義項目に使える文字については，データベースのマニュアルを参照してください。

注※4

ORACLEの場合は指定できません。

(2)　操作

表定義の操作について，例題に沿って説明します。

（例題）　次に示す表を定義します。

表名：SHIIRE

表見出し：仕入れ

表注釈：仕入れ管理マスタ表

［DBPARTNER2］ウィンドウの［定義］−［表定義・更新(C)...］メニューを選びます。

［表定義］ダイアログボックスが表示されます。

補足

［DBPARTNER2］ウィンドウから抽出したデータをデータベースに転送する場合は，［表定義］ダイアログボックスが表示されます。抽出したデータは「表」として定義して格納してください。情報表示領域には「保存」と表示されます。

参照：「4.1.3　抽出したデータの転送先の設定」

また，［表定義］ダイアログボックスは［データ確認］ダイアログボックスからも表示できます。データ確認後，抽出したデータをデータベースに保存する場合は表として定義します。情報表示領域には「一時」と表示されます。

参照：「4.2.9　データの確認（抽出，絞り込み（条件付加），絞り込み（保存利用））」

表名，表見出し及び表注釈を指定します。

ここでは，例題に従って表名「SHIIRE」，表見出し「仕入れ」，表注釈「仕入れ管理マスタ表」と指定します。表見出しと表注釈の指定は任意です。

補足

既存の表を選択して，定義情報を編集できます。また，別表として定義することもできます。次の順で操作してください。

［表定義］ダイアログボックスの［表一覧取得(G)］ボタンをクリックします。

既存の表一覧が取得されます。

［▼］をクリックします。

取得した表一覧が，［表名(N)］に表示されます。

表一覧から目的の表を選択します。

選択した表の表定義情報が［表定義］ダイアログボックスに反映されます。必要に応じて，表名，表見出し及び表注釈を変更してください。

表定義情報を入力したら，列を定義します。列定義については，「9.2.2　列定義」を参照してください。

(3)　規則と注意

HiRDBに表を定義する場合は，HiRDBに次の定義をしておいてください。

定義した表を格納するRDエリア

RDエリアを定義する方法については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

表を定義するスキーマ

スキーマを定義する方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

HiRDBに表を定義する場合，一つのRDエリアに定義できる表は，500個までです。

ORACLEの場合，既存の表（元からデータベースにあった表，又は一度定義した表）を編集する場合，「表見出し」以外の項目は変更できないので注意してください。

表見出しを指定する場合，あらかじめ［オプション設定］ダイアログボックスで見出し辞書の使用を設定してください。表見出しは［オプション設定］ダイアログボックスに指定されている見出し辞書に自動的に格納されます。使用する見出し辞書の設定については，「7.1　オプションの設定」を参照してください。

HiRDBに表を定義する場合，表名，列名，インデクス名に「%」「_」は使えません。また，半角と全角の混在した名称は指定できません。

ORACLEに表を定義する場合，表注釈，列注釈は指定できません。

9.2.2　列定義

表名，表見出し及び表注釈を定義した後，表を構成する列を定義します。列定義は，［列定義］ダイアログボックスから実行します。

(1)　［列定義］ダイアログボックス

［列定義］ダイアログボックスを次に示します。

タイトルバー

「列定義」と表示されます。

編集領域

指定した列情報を複写したり，削除したりするときに使います。

列情報を複写する場合は，次の操作をしてください。

複写元の列情報に対応する領域をクリックする

メニューが表示されたら［単・複行選択］をクリックする。範囲指定をする場合は，［複行指定開始］をクリックし，範囲指定終了位置へマウスポインタを移動しクリックする

複写先の編集領域にマウスポインタを移動して，クリックする

編集メニューが表示されたら，［挿入］をクリックする

列情報を削除する場合は，次の操作をしてください。

削除する列情報に対応する編集領域をクリックする

編集メニューが表示されたら，［単・複行選択］をクリックする。範囲指定をする場合は，［複行指定開始］をクリック，範囲指定終了位置へマウスポインタを移動して，クリックする

メニューが表示されたら［削除］をクリックする

［列名(C)］

列名を指定します。列名の指定は省略できません。

［見出し(E)］

列に対する見出しを指定します。

［属性(A)］

列の属性（データ型）を指定します。［▼］をクリックすると，選択できる属性が一覧表示されます。

DBPARTNER2とデータベースのデータ型の対応と制限値については，「付録D　DBPARTNER2の列属性」を参照してください。

［データ長(L)］

定義した列のデータ長（文字列のけた数）を指定します。［▼］をクリックすると，数値が一覧表示されます。

［小数(D)］

小数点以下のけた数を指定します。小数点以下の値を設定できる列属性を選択したときだけ指定できます。［▼］をクリックすると，数値が一覧表示されます。最大値は29です。

情報

各列の最後に，設定されているインデクスの状態を示すアイコンが表示されます。

[図データ]：インデクスは定義されていない

[図データ]：昇順のインデクスが定義されている

[図データ]：降順のインデクスが定義されている

また，アイコンをクリックすると［インデクス定義］ダイアログボックスが表示されます。

［=］，［△］，［▽］，［=］

データをスクロールするときに使います。

［=］（上）：先頭の列定義情報を一番上にして表示する

［△］：表示中の先頭の列定義情報を1行分残し，1画面分上にスクロールする

［▽］：表示中の最後の列定義情報を1行分残し，1画面分下にスクロールする

［=］（下）：最後の列定義情報を下から2番目に表示する

［設定(S)］ボタン

設定された列定義情報を確定し，［表定義］ダイアログボックスに戻ります。

［列詳細(P)...］ボタン

［列詳細定義］ダイアログボックスを表示します。

［領域(R)...］ボタン

［格納領域設定］ダイアログボックスを表示します。

［インデクス(I)...］ボタン

［インデクス定義］ダイアログボックスを表示します。

X／Y

X：表示されている先頭行が何行目かを表示する

Y：指定した最終行の行数を表示する

ガイダンス領域

ダイアログボックスの一番下に，［列定義］ダイアログボックスの領域やボタンの簡単な操作方法などを表示します。操作方法を知りたい場合は，マウスポインタを目的の領域やボタンなどに合わせてクリックしてください。

［列定義］ダイアログボックスから定義する項目を次の表に示します。

表9‒3　定義項目の一覧（［列定義］ダイアログボックス）

定義項目

最大長（バイト）

省略値

使える文字

列名※1

128※2

省略できない

※3

列見出し

46

列見出しは設定されない

半角文字，全角文字

列属性

※4

省略できない

［属性(A)］に一覧表示されるデータ型※4から選択

データ長※5

1が仮定される※6

［データ長(L)］に一覧表示されるデータ長から選択

小数※5

0が仮定される

［小数(D)］に一覧表示される数値から選択

注※1

列名の前後に指定した空白は，無視されます。

注※2

HiRDBへ表を定義するときに，2バイトコードの文字列を使うときは，最大長は15文字です。

ORACLE，HiRDBの場合は30バイトです。

注※3

定義項目に使える文字については，データベースのマニュアルを参照してください。

注※4

「付録D　DBPARTNER2の列属性」を参照してください。

注※5

文字データ（CHAR及びVARCHAR），各国文字データ（NCHAR及びNVARCHAR），混在文字データ（MCHAR及びMVARCHAR），長大データ（LONG VARBINARY）及び固定小数点数（DECIMAL）以外のデータ型を持つ列には，データ長及び小数を指定できません。

注※6

長大データ（LONG VARBINARY）のデータ長を省略した場合，2147483647が仮定されます。

(2)　操作

列定義の操作について，例題に沿って説明します。

（例題）

「9.2.1　表定義」で定義した表に対して，表9-4に示す列を定義します。［小数(D)］には何も指定しません。

表9‒4　例題で定義する列情報

列名

列見出し

属性

データ長

CODE

商品コード

CHAR

8けた（8バイト）

NAME

商品名

NCHAR

6けた（12バイト）

SPRICE

定価

INTEGER

−

OPRICE

原価

QUANTITY

数量

（凡例）

−：指定できません。

表名，表見出し及び表注釈を定義した後，［表定義］ダイアログボックスの［列(C)...］ボタンをクリックします。

［列定義］ダイアログボックスが表示されます。

列名，列見出し，列属性，データ長及び小数を指定します。

ここでは，例題に従って，表9-4に示したデータを入力します。各項目のデータ入力領域にマウスポインタを合わせ，データを入力します。

データ長と小数（小数点の位置）の指定は任意です。

補足

既存の表を編集する場合，「列見出し」，「列注釈」以外の項目は変更できません。

列定義情報を入力した後，［設定(S)］ボタンをクリックします。

定義した内容が確定されて，［表定義］ダイアログボックスに戻ります。

表の定義を終了する場合は，［OK］ボタンをクリックします。

補足

定義した列に対して列注釈を定義する場合は，［列詳細(P)...］ボタンをクリックします。

参照：「9.2.3　列詳細定義」

定義した表を格納する領域を指定する場合は，［領域(R)...］ボタンをクリックします。HiRDBへ表を定義する場合は，表を異なるRDエリアに分割して格納するための格納条件も定義できます。

参照：「9.2.4　格納領域設定」

定義した列に対してインデクスを定義する場合は，［インデクス(I)...］ボタンをクリックします。

参照：「9.2.5　インデクス定義」

(3)　規則と注意

一つの表に定義できる列数は30,000列までです。

既存の表（元からデータベースにあった表又は一度定義した表）の更新

一度定義した表を［定義］−［表定義・更新(C)...］メニューで更新する場合は，次の制限事項があります。

HiRDBの場合「列見出し」「列注釈」以外の項目は変更できません。

ORACLEの場合「列見出し」以外の項目は変更できません。

誤って変更した場合は，各画面のシステムメニューの「表定義情報を中断する(Q)」を選択して中断してください。

保存操作中に列名，列見出し，列注釈以外の項目変更はできません。

抽出したデータを「一時」表又は「保存」表として保存する操作中に「列名」「列見出し」「列注釈」以外の項目は変更できません。誤って変更した場合は，各画面のシステムメニューの［表定義情報を中断する(Q)］を選択して中断してください。

抽出するデータを「一時」表，又は「保存」表として定義する時に，次の操作をするとエラーとなるので注意してください。

抽出するデータに新しく列を追加する

抽出するデータから列を削除する

列見出しを指定する場合，あらかじめ［オプション設定］ダイアログボックスで見出し辞書の使用を設定してください。列見出しは，［オプションの設定］ダイアログボックスで指定されている見出し辞書に自動的に格納されます。見出し辞書の設定については，「7.1.5　見出し辞書の指定」を参照してください。

ORACLEに表を定義する場合，列属性に「NUMBER」を指定できます。ただし，表定義終了後，DBPARTNER2からデータを抽出すると列属性は「NUMERIC」として表示されるので注意してください。

9.2.3　列詳細定義

定義した列に対して列注釈（列に対するコメント）を指定できます。列注釈は，［列詳細定義］ダイアログボックスで定義します。

(1)　［列詳細定義］ダイアログボックス

［列詳細定義］ダイアログボックスを次に示します。

タイトルバー

「列詳細定義」と表示されます。

編集領域

指定した列詳細情報を複写したり，削除したりするときに使います。

列詳細情報を複写する場合は，次の操作をしてください。

複写元の列情報に対応する領域をクリックする。

メニューが表示されたら［単・複行選択］をクリックする。範囲指定をする場合は，［複行指定開始］をクリックし，範囲指定終了位置へマウスポインタを移動しクリックする。

複写先の編集領域にマウスポインタを移動して，クリックする。

編集メニューが表示されたら，［挿入］をクリックする。

列詳細情報を削除する場合は，次の操作をしてください。

削除する列情報に対応する編集領域をクリックする。

編集メニューが表示されたら，［単・複行選択］をクリックする。範囲指定をする場合は，［複行指定開始］をクリック，範囲指定終了位置へマウスポインタを移動して，クリックする。

メニューが表示されたら［削除］をクリックする。

［列名(C)］

［列定義］ダイアログボックスで定義した列名が表示されます。入力はできません。

［列注釈(A)］

列に対する列注釈（コメント）を入力します。

［NULL(D)］

NULL値の使用を禁止する列に対して指定します。

［=］，［△］，［▽］，［=］

データをスクロールする場合に使用します。

［=］（上）：先頭の列詳細定義情報を一番上にして表示する

［△］：表示中の先頭の列詳細定義情報を1行分残し，1画面分上にスクロールする

［▽］：表示中の最後の列詳細定義情報を1行分残し，1画面分下にスクロールする

［=］（下）：最後の列詳細定義情報を下から2番目に表示する

［設定(S)］ボタン

設定された列詳細定義情報を確定し，［表定義］ダイアログボックスに戻ります。ただし，表を削除する場合，ボタン名は［OK］と表示されます。

［列(L)...］ボタン

［列定義］ダイアログボックスを表示します。

［領域(R)...］ボタン

［格納領域設定］ダイアログボックスを表示します。

［インデクス(I)...］ボタン

［インデクス定義］ダイアログボックスを表示します。

X／Y

X：表示されている先頭行が何行目かを表示する

Y：指定した最終行の行数を表示する

ガイダンス領域

［列詳細定義］ダイアログボックスの領域やボタンの簡単な操作方法や定義内容などを表示します。操作方法を知りたい場合は，マウスポインタを目的の領域やボタンなどに合わせてクリックしてください。

［列詳細定義］ダイアログボックスから定義する項目については，「表9-3　定義項目の一覧（［列定義］ダイアログボックス）」を参照してください。

(2)　操作

列詳細定義の操作について，例題に沿って説明します。

（例題）

「9.2.2　列定義」で定義した列に対して，表9-5に示す列注釈を定義します。

表9‒5　例題で定義する列注釈

列名

列見出し

列注釈

NAME

商品名

原価が1000円以下の商品

QUANTITY

数量

仕入れ数100個以上の商品については，表「仕入れ2」を参照

列を定義した後，［列定義］ダイアログボックスの［列詳細(P)...］ボタンをクリックします。

［列詳細定義］ダイアログボックスが表示されます。

補足

［列詳細定義］ダイアログボックスは列が定義されていれば，［表定義］［格納領域設定］及び［インデクス定義］ダイアログボックスから表示できます。

［列詳細(P)...］ボタンをクリックしてください。

列注釈及びNULL抑止を指定します。

ここでは，例題に従って，表9-5に示したデータを入力します。各項目のデータ入力領域にマウスポインタを合わせ，データを入力します。

既存の表一覧から選択した表に対して列の詳細情報を定義する場合，［NULL(D)］の指定は変更できません。

列の詳細情報を入力した後，［設定(S)］ボタンをクリックします。

定義した内容が確定されて，［表定義］ダイアログボックスに戻ります。

補足

列の詳細情報を定義した後，定義した表を格納する領域を指定する場合は，［領域(R)...］ボタンをクリックします。HiRDBへ表を定義する場合は，表を異なるRDエリアに分割して格納するための格納条件も定義できます。

参照：「9.2.4　格納領域設定」

定義した列に対してインデクスを定義する場合は，［インデクス(I)...］ボタンをクリックします。

参照：「9.2.5　インデクス定義」

(3)　規則と注意

HiRDBに表を定義する場合，列注釈は255バイト以内で指定してください。使える文字については，マニュアル「HiRDB SQLリファレンス」を参照してください。

ORACLEに表を定義する場合は，列注釈は指定できません。

9.2.4　格納領域設定

定義した表を格納する領域を指定できます。さらに，HiRDBに表を定義する場合は，表の任意の列をキーに表を分割して異なるRDエリアに格納できます。表を格納する領域及びRDエリアへの表の格納条件は［格納領域設定］ダイアログボックスから定義します。

(1)　［格納領域設定］ダイアログボックス

［格納領域設定］ダイアログボックスを次に示します。

タイトルバー

「格納領域設定」と表示されます。

［格納領域名・条件(R)］

HiRDBに表を定義する場合は，表を格納するRDエリア名を指定します。

ORACLEに表を定義する場合は，表を格納するテーブルスペース名を指定します。

HiRDBに表を定義する場合，任意の列をキーにして表を分割し，異なるRDエリアへ格納できます。このとき，表を分割するための条件式（格納条件）もこの領域に指定します。格納条件の指定方法については，「9.2.4(3)　規則と注意」を参照してください。

［列名(C)］

HiRDBの場合，LONG VARBINARY属性の列名が表示されます。

［LOB列格納領域(O)］

HiRDBの場合，列名に対するLOB列格納領域名を指定します。

［設定(S)］ボタン

指定された表の格納領域及び格納条件を確定し，［表定義］ダイアログボックスに戻ります。表を削除する場合，ボタン名は［OK］と表示されます。

［列(L)...］ボタン

［列定義］ダイアログボックスを表示します。

［列詳細(P)...］ボタン

［列詳細定義］ダイアログボックスを表示します。

［インデクス(I)...］ボタン

［インデクス定義］ダイアログボックスを表示します。

ガイダンス領域

ダイアログボックスの一番下に，［格納領域設定］ダイアログボックスの領域やボタンの簡単な操作方法や定義内容などを表示します。操作方法を知りたいときは，マウスポインタを目的の領域やボタンなどに合わせてクリックしてください。

(2)　操作

表を格納する領域の指定と，RDエリアへの表の格納条件の指定方法について，例題に沿って説明します。

（例題）定義した表「SHIIRE」をRDエリア「RDAREA1」に格納します。

列を定義した後，［列定義］ダイアログボックスの［領域(R)...］ボタンをクリックします。

［格納領域設定］ダイアログボックスが表示されます。

補足

［格納領域設定］ダイアログボックスは列が定義されていれば，［表定義］ダイアログボックス，［列詳細定義］ダイアログボックス及び［インデクス定義］ダイアログボックスから表示できます。

［領域(R)...］ボタンをクリックしてください。

［格納領域(R)］に表を格納するRDエリア名を指定します。

ここでは，例題に従って次のように指定します。

（例）（RDAREA1）

ORACLEの場合は，テーブルスペース名を指定します。

補足

HiRDBに定義した表を，異なるRDエリアに分割して格納する場合は，RDエリア名の後ろに格納条件を指定します。格納条件の指定方法については，「9.2.4(3)　規則と注意」を参照してください。

（例）

SPRICE（定価）に300以上の値を持つ行データをRDAREA1

に格納します。300未満の値を持つ行データをRDAREA2に格納します。

指定例

（RDAREA1）SPRICE△＞=△300，（RDAREA2）SPRICE△＜△300

定義が終了したら，［設定(S)］ボタンをクリックします。

定義情報が確定されて，［表定義］ダイアログボックスに戻ります。

(3)　規則と注意

(a)　格納領域を指定するときの注意（HiRDBの場合）

表を格納するRDエリアは，HiRDBの初期設定ユティリティであらかじめ定義しておきます。RDエリアの定義については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

HiRDBの場合，LONG VARBINARY属性の列名は［LOB列格納領域］の［列名］に表示されます。列名を選択して［LOB列格納領域］で列名の格納領域を指定してください。

(b)　格納条件の指定方法

HiRDBへ表を定義する場合，任意の列をキーにして表を分割し，異なるRDエリアへ格納できます。格納条件は，表格納用RDエリア名の後ろに次の形式で指定します。

格納条件：：=列名△※1比較演算子△{ 定数 | ( 定数 ［ ,定数 ］・・・)※2 }

注※1

△は半角の空白を示します。

注※2

定数を複数個指定する場合，比較演算子には「=」を使います。また，指定する定数の値は重複しないように指定してください。

比較演算子の指定方法は次のとおりです。

比較演算子：：= { = | <> | < | <= | > | >= }

注

比較演算できる列は次に示すデータ型を持つ列です。

DECIMAL，INTEGER，SMALLINT，FLOAT，SMALLFLT，CHAR，DATE，TIME

ただし，CHARはデータ長が32バイト以下の列に対して指定できます。

(c)　格納条件を指定するときの注意

一つの表を格納するときは，格納条件を512個まで指定できます。ただし，一つの格納条件は，一つのRDエリア名と対応している必要があります。したがって，RDエリア名は重複しないように指定してください。

格納条件には，同じ列名を指定してください。ただし，格納条件を省略すると，それ以前に指定した格納条件に当てはまらないデータが，指定したRDエリアに格納されます。例えば，格納領域と格納条件を次のように指定します。

（例）（RDAREA1）SPRICE△＞=△300，

（RDAREA2）

このとき，SPRICEが300以上の値を持つ行データはRDエリア「RDAREA1」に格納されます。しかし，この条件に当てはまらない行データは，すべてRDエリア「RDAREA2」に格納されます。

また，格納条件に間違いがある場合は，表の定義ができなくなります。

すべての格納条件で指定されている定数の総数が512個以下となるようにしてください。格納条件を省略した場合も，定数を一つ指定したことになります。

9.2.5　インデクス定義

定義した表に対してインデクスを定義できます。インデクスは［インデクス定義］ダイアログボックスで定義します。

(1)　［インデクス定義］ダイアログボックス

［インデクス定義］ダイアログボックスを次に示します。

タイトルバー

「インデクス定義」と表示されます。

［インデクス名(I)］

定義するインデクス名を指定します。定義済みインデクスの一覧は，［▼］をクリックして表示させます。

［ユニーク(U)］チェックボックス

定義するインデクスに対してユニーク指定をする場合にオンにします。ただし，重複するキー値を持つ列に対して指定するとエラーになるので注意してください。

既存表示エリア

［表定義］ダイアログボックスで表を定義する場合，表一覧から表を選択したときに，その表に対してインデクスが設定されていると，［インデクス名(I)］の下に「既存」と表示されます。

［種別］欄

［作成(D)］： 選択している表にインデクスを追加する場合に指定します。

［更新(T)］： 選択している表に設定されているインデクスを更新する場合に指定します。この場合，既存のインデクスを削除してから新たにインデクスを追加します。

［削除(E)］： 選択している表に設定されているインデクスを削除する場合に指定します。

［対象列名(O)］

インデクスの対象とする列名を表示します。インデクスを定義する表の列名一覧は，［▼］をクリックして表示させます。

［昇順・降順(A)］

ソート順を指定します。デフォルトは「昇順」です。ただし，ORACLEにインデクスを定義する場合は指定できません。

［△］，［▽］

対象列名の表示エリアをスクロールします。

［設定(S)］ボタン

インデクスの定義情報及び削除指定を確定し，［表定義］ダイアログボックスに戻ります。表を削除する場合，このボタンは［OK］と表示されます。

［設定解除(C)］ボタン

一度設定したインデクスの定義情報を無効にします。

［列(L)...］ボタン

［列定義］ダイアログボックスを表示します。

［列詳細(P)...］ボタン

［列詳細定義］ダイアログボックスを表示します。

［領域(R)...］ボタン

［格納領域設定］ダイアログボックスを表示します。

ガイダンス領域

ダイアログボックスの一番下に，［インデクス定義］ダイアログボックスのエリアやボタンの簡単な操作方法や定義内容などを表示します。操作方法を知りたいときは，マウスポインタを目的のエリアやボタンなどに合わせてクリックしてください。

(2)　操作

インデクス定義の操作について，例題に沿って説明します。

（例題）

「9.2.1　表定義」で定義した表「SHIIRE」に対してインデクスを定義します。

インデクス名：INDEX1

対象列名：CODE

そのほかの設定は，すべてデフォルトで設定します。

列を定義した後，［列定義］ダイアログボックスの［インデクス(I)...］ボタンをクリックします。

［インデクス定義］ダイアログボックスが表示されます。

補足

［インデクス定義］ダイアログボックスは，列が定義されていれば［表定義］，［列詳細定義］及び［格納領域設定］ダイアログボックスからでも表示できます。［インデクス(I)...］ボタンをクリックしてください。

インデクス名を指定します。

ここでは例題に従って，「INDEX1」を指定します。定義済みのインデクスの一覧は［▼］をクリックして表示させます。定義済みのインデクスを編集する場合には，この一覧から目的のインデクス名を選択してください。

インデクスの対象列名を指定します。

［▼］をクリックすると，表を構成する列名が一覧表示されます。ここでは例題に従って，「CODE」を指定します。

ソート順を指定します。

［▼］をクリックすると，ソート順が一覧表示されます。「昇順」又は「降順」を選択します。デフォルトは「昇順」です。

定義が終了したら，［設定(S)］ボタンをクリックします。

定義情報が確定されて，［表定義］ダイアログボックスに戻ります。

(3)　規則と注意

インデクス名は30バイト以内で指定します。使える文字については，データベースのマニュアルを参照してください。

一つの表に対して定義できるインデクスは255個までです。

一つのインデクスに対して指定できる列は16列までです。ただし，各列のデータ長の合計が255バイト以下の場合にだけ有効です。

次に示す列にはインデクスを定義できません。

データ長が255バイトを超えるデータ型を持つ列

データ型が可変長文字列（VARCHAR）又は可変長各国文字列（NVARCHAR）である列

データ型がLONG型である列

インデクスを設定する列のキー値がすべて異なる場合は，ユニーク指定（［ユニーク(U)］のチェックボックスをオンにする）ができます。

同じ所有者が定義するインデクス名は重複しないように定義してください。

9.3　表の削除

定義した表を削除する方法について説明します。

表を削除すると，その表に定義されている情報（注釈やインデクスなど）は自動的に削除されます。また，削除する表に対応する見出し辞書内の定義情報（表注釈及び列注釈）も削除されます。

9.3.1　操作

定義した表は，［表削除］ダイアログボックスを使って削除します。表を削除する操作について，例題に沿って説明します。

（例題）「9.2　表の定義」で定義した表「SHIIRE」を削除します。

［DBPARTNER2］ウィンドウの［定義(D)］−［表削除(D)...］メニューを選びます。

［表削除］ダイアログボックスが表示されます。

［表一覧取得(G)］ボタンをクリックします。

既存の表の一覧情報が取得されます。

［▼］をクリックします。

取得した表一覧が，［表名(N)］に一覧表示されます。

削除する表を選びます。

ここでは，例題に従って表「SHIIRE」をクリックします。

［OK］ボタンをクリックします。

選択した表が削除されます。

9.3.2　規則と注意

表を削除するときは，ダイアログボックスに表示される定義情報は変更できません。

9.4　表名・列名変更

定義した表の表名・列名を変更する方法について説明します。

定義した表の表名・列名は，HiRDBにアクセスしている場合にだけ，変更できます。

9.4.1　操作

表名・列名は［表名変更］ダイアログボックス又は［列名変更］ダイアログボックスで変更します。

（例題）「9.2　表の定義」で定義した表「SHIIRE」を変更します。

表名「SHIIRE」→「TOKYO-SHIIRE」

列名「SPRICE」→「GROSS-QUANTITY」

［DBPARTNER2］ウィンドウの［定義］−［表名・列名変更(A)］メニューを選びます。

［表名変更］ダイアログボックスが表示されます。

［表一覧取得(G)］ボタンをクリックします。

既存の表の一覧情報が取得されます。

［▼］をクリックします。

取得した表一覧が［表名(N)］に一覧表示されます。

補足

表名・列名を変更できるのは，接続した所有者の実表だけです。このため，接続した所有者の実表だけしか表示されません。

変更する表名を選択します。

ここでは，例題に従って「SHIIRE」をクリックします。

変更後の表名を入力します。

［変更後表名入力］領域に「TOKYO-SHIIRE」と入力します。

［列(C)...］ボタンをクリックします。

［列名変更］ダイアログボックスが表示されます。さらに，ダイアログボックス中に表示されている一番上の列が何列目かが「n／全列数」の形式で表示されます。

列名を変更します。

［変更後列名入力］領域に「GROSS-QUANTITY」と入力します。

［設定(S)］ボタンをクリックします。

［表名変更］ダイアログボックスに戻ります。

補足

いったん選択した表は，列名変更後は表名を変更できません。別の表の表名を変更したい場合は，1.から操作し直してください。

［OK］ボタンをクリックします。

表名，列名が変更されて，［DBPARTNER2］ウィンドウに戻ります。

9.4.2　規則と注意

変更できるのは所有者の実表だけです。

所有者は変更できません。

表名・列名を変更した場合は，見出し辞書，手順ファイルの表名・列名も変更してください。

表名・列名を変更できるのは，HiRDBにアクセスしている場合だけです。

表名・列名に指定する名称は，表定義時の規則に従って指定してください。

9.5　見出し辞書の編集

データベース内の表や列に，データベースの定義中の表名や列名に依存しない使い慣れた任意の名称を使うときには，見出し辞書に名称を登録します。通常，表や列を［DBPARTNER2］ウィンドウなどに表示するときにはサーバにアクセスしていますが，見出し辞書を使うときは見出し辞書にアクセスします。見出し辞書を使うとサーバにアクセスしないため，サーバにアクセスしている間の待ち時間がありません。

ここでは，見出し辞書の編集方法について説明します。見出し辞書を作成した後には，オプションを設定してください。見出し辞書に関するオプションを設定する方法については，「7.1.5　見出し辞書の指定」を参照してください。

9.5.1　見出し辞書の設定方法

見出しは，一つの表に対して一つ作成します。1表ごとに，データベースの定義中の表名や列名に対応する表見出し，列見出しを設定します。設定した内容は，接続先名，所有者名などの情報と合わせて見出し辞書に登録されます。見出し辞書に登録される情報を見出し情報といいます。

見出し辞書の編集では，次のことができます。

見出し情報の作成

新規にデータベースの表に見出し情報を作成します。

見出し辞書の編集

見出し辞書に登録されている見出し情報の表見出し又は列見出しを変更します。

格納先を指定して見出し情報を格納する

見出し情報を別のドライブ又はフォルダに格納します。

別のドライブ又はフォルダの見出し情報を読み込む

別のドライブ又はフォルダにある見出し情報を読み込みます。

見出し情報の削除

不要な見出し情報を削除します。

見出し情報の一括作成

複数の表の見出し情報を見出し辞書に一括登録できます。

見出し辞書の編集で使う［見出し編集］ダイアログボックス，［見出し選択］ダイアログボックス，［格納先の指定］ダイアログボックス，［読み込み先の指定］ダイアログボックスを次に示します。

(1)　［見出し編集］ダイアログボックス

見出し辞書を編集します。

タイトルバー

「見出し編集」と表示されます。

［接続先名］

選択した表が格納されているサーバに対応する接続先が表示されます。

［所有者名］

データベースにアクセスしているユーザ名が表示されます。

［表名］

データベースに定義されている表名が表示されます。

［表見出し］入力領域

表名に対応する表見出しを指定します。

［グループ名］入力領域

表に設定するグループを選択，又は入力します。

列名

表の列が一覧で表示されます。

列見出し入力領域

列名に対応する列見出しを指定します。

［見出し一覧(L)...］ボタン

［見出し選択］ダイアログボックスを表示します。

［新規作成(N)...］ボタン

［表選択］ダイアログボックスを表示します。

［一括作成(M)...］ボタン

複数の表の見出し情報を一括して見出し辞書に登録できます。

［読み込み(R)...］ボタン

［読み込み先の指定］ダイアログボックスを表示します。

［登録(G)］ボタン

作成した見出し情報を見出し辞書に登録します。

補足

DBPARTNER2が動作するフォルダ下にある見出し辞書に登録されます。この見出し辞書ではなく別のドライブ又はフォルダに格納することもできます。この場合，［見出し選択］ダイアログボックスの［格納(U)］ボタンをクリックして，格納するドライブ又はフォルダを指定します。

［削除(D)］ボタン

表示している見出し情報を削除します。

［終了(X)］ボタン

見出し編集を終了して［DBPARTNER2］ウィンドウに戻ります。

(2)　［見出し選択］ダイアログボックス

見出し辞書に登録されている見出し情報を表示します。

タイトルバー

「見出し選択」と表示されます。

［登録表一覧(T)］リストボックス

見出し辞書に登録している表を一覧表示します。表示する項目は，［辞書一覧表示方法の設定］ダイアログボックスで設定します。項目をクリックすると，その項目について表がソートされます。

［表示設定(I)］ボタン

［辞書一覧表示方法の設定］ダイアログボックスが表示されます。

設定方法，表示項目については，「9.5.1(3)　［辞書一覧表示方法の設定］ダイアログボックス」を参照してください。

［グループ名(G):］コンボボックス

表に設定するグループを選択，又は入力します。

［設定(S)］ボタン

［登録表一覧］で設定した表に，グループを設定します。

［編集(E)］ボタン

［見出し編集］ダイアログボックスを表示します。

［格納(U)...］ボタン

［格納先の指定］ダイアログボックスを表示します。

［削除(D)］ボタン

選択されている見出し情報を削除します。

［閉じる］ボタン

［見出し選択］ダイアログボックスを閉じます。

(3)　［辞書一覧表示方法の設定］ダイアログボックス

［見出し選択］ダイアログボックスに表示される表の表示方法を設定します。

［表示項目(I):］リストボックス

［見出し選択］に表示できる項目と各項目の表示の有無を表示します。

「表名」，又は「表見出し」のどちらかは必ず「表示」を設定してください。どちらも「非表示」を設定した場合はエラーとなります。

［表示(A)］ボタン

［表示項目］で選択した項目を"表示"にします。

［非表示(D)］ボタン

［表示項目］で選択した項目を"非表示"にします。

［OK］ボタン

設定した表示項目を有効にし，ダイアログボックスを閉じます。

［キャンセル］ボタン

設定した表示項目を無効にし，ダイアログボックスを閉じます。

(4)　［格納先の指定］ダイアログボックス，［読み込み先の指定］ダイアログボックス

見出し情報を格納する先と，見出し情報を読み込む先を指定します。

タイトルバー

「格納先の指定」又は「読み込み先の指定」と表示されます。

［フォルダ(F)］

見出し情報を格納するフォルダ又は見出し情報を読み込むフォルダを指定します。

［..］

一つ上のフォルダを示します。選択すると，一つ上のフォルダを表示します。ドライブ直下の場合は，表示されません。

［api］，［samples］

下位のフォルダを示します。

選択すると，さらに下位にあるフォルダを表示します。

［−a−］，［−c−］

ドライブを指定します。

選択すると，ドライブ下にあるフォルダを表示します。

［OK］ボタン

指定したフォルダへ見出し情報を格納します。又は指定したフォルダから見出し情報を読み込みます。

［キャンセル］ボタン

格納先の指定又は読み込み先の指定を取り消します。

(5)　操作

見出し辞書を編集する操作を次の図に示します。

図9‒1　見出し辞書を編集する操作

［DBPARTNER2］ウィンドウの［定義(D)］−［見出し編集(E)...］メニューを選びます。

［見出し編集］ダイアログボックスが表示されます。

見出し情報の作成や編集などの操作をしてください。

次の操作ができます。

新規に見出し情報を作成する

参照：「9.5.2　見出し情報の作成」

見出し辞書に登録されている見出し情報を編集する

参照：「9.5.3　見出し情報の編集」

見出し情報を別のドライブ又はフォルダに格納する

参照：「9.5.4　格納先を指定して見出し情報を格納する」

見出し情報を見出し辞書に一括登録する

参照：「9.5.5　見出し情報の一括登録」

見出し辞書にグループを設定する

参照：「9.5.6　見出し辞書のグループ設定」

別のドライブ又はフォルダに格納した見出し情報を読み込む

参照：「9.5.7　別のドライブ又はフォルダの見出し情報を読み込む」

不要な見出し情報を見出し辞書から削除する

参照：「9.5.8　見出し情報の削除」

操作が終了したら，［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(6)　注意

［表定義］ダイアログボックスで表を定義すると，自動的に定義した内容が見出し辞書に登録されます。［表定義］ダイアログボックスで，定義した表を編集又は削除した場合も同様です。

9.5.2　見出し情報の作成

サーバ上の表で，見出し辞書に登録されていない表に対して見出し情報を作成します。見出し情報を作成したい表に対して，表見出しと列見出しを設定します。設定した内容は，表の情報と合わせて見出し辞書に登録されます。

(1)　操作

見出し情報を作成する操作は，［見出し編集］ダイアログボックスから始めます。見出し情報を作成する操作を次の図に示します。

図9‒2　見出し情報を作成する操作

［見出し編集］ダイアログボックスの［新規作成(N)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

サーバと接続されていない場合は，［ユーザID・パスワード設定］ダイアログボックスが表示されます。その場合は，ユーザIDとパスワードを設定してください。

補足

ワイルドカードを使って表一覧に表示する表を絞り込めます。その場合，［表選択］ダイアログボックスの［絞り込み(F)...］ボタンをクリックしてください。［表の絞り込み条件設定］ダイアログボックスが表示されるので，条件を設定して絞り込んでください。

表一覧から，見出し情報を作成する表を選択します。

［OK］ボタンをクリックします。

［見出し編集］ダイアログボックスに戻ります。

2.で選択した表の接続先名，所有者名，表名と列名が表示されます。

表に対する表見出しとグループ名，列に対する列見出しを設定した後，［登録(G)］ボタンをクリックします。

設定した内容が見出し辞書に登録されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　規則と注意

見出し情報を作成する場合に定義する項目の一覧を次の表に示します。

表9‒6　見出し情報作成時に定義する項目の一覧

定義項目

最大長（バイト）

省略値

使える文字

表見出し

0〜30

表見出しは設定されない※

半角文字，全角文字

列見出し

0〜46

列見出しは設定されない※

半角文字，全角文字

注※

データベースで表見出し又は列見出しを定義している場合は，データベースで定義した表見出し又は列見出しが表示されます。

［表選択］ダイアログボックスで選択できる表は一つです。二つ以上は選択できません。

データベースの表・列情報を変更した場合は，見出し情報を再作成してください。

表見出しは，複数の表に対し同じ名称を指定できます。また，列見出しは，複数の列に対し同じ名称を指定できます。

表見出しや列見出しに同じ名称を指定した見出し辞書を使用した場合，仮想列の設定，列演算条件式の設定，条件式直接入力の設定などで，意図したとおりの列を選択できないときがあります。表見出し，列見出しには，重複しない名称を指定してください。

9.5.3　見出し情報の編集

既に作成して見出し辞書に登録されている見出し情報を編集します。見出し情報を編集するには，まず見出し辞書から見出し情報を呼び出します。次に，呼び出した見出し情報の内容を変更します。最後に見出し辞書に格納します。

(1)　操作

見出し情報を編集する操作は，［見出し編集］ダイアログボックスから始めます。

見出し情報を編集する操作を次の図に示します。

図9‒3　見出し情報を編集する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されて，見出し辞書に登録されている見出し情報が表示されます。

編集したい表見出しの行を選択します。

［編集(E)］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示されます。

2.で選択した表見出しの見出し情報が表示されます。

表見出しやグループ名，列見出しを変更します。

編集後，［登録(G)］ボタンをクリックします。

変更した内容が見出し辞書に登録されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］が淡色で表示されて，選択できません。

9.5.4　格納先を指定して見出し情報を格納する

通常，見出し辞書はDBPARTNER2が動作するフォルダにあります（見出し情報一覧はファイル名Dptindex.dpdに，グループの情報はファイル名Dptindex2.dpdに，見出し情報はファイル名Dpt00001.dpd〜Dpt65535.dpdに格納されます）。このため，作成又は編集した見出し情報は，特に格納先を指定しなければこの見出し辞書に登録されます。この見出し辞書の中ではなく別の場所に格納したい場合には，格納するドライブ又はフォルダを指定できます。

作成した見出し辞書をほかの使用者に配布する場合や，現在使っている見出し辞書の内容を別のDBPARTNER2で使う場合などに利用すると便利です。

(1)　操作

見出し情報を作成又は編集して別のドライブ又はフォルダに格納する操作は，［見出し編集］ダイアログボックスから始めます。別のドライブ又はフォルダに見出し情報を格納する操作を次の図に示します。

図9‒4　別のドライブ又はフォルダに格納する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

格納したい表見出しの行を選択します。

複数選択できます。

［格納(U)...］ボタンをクリックします。

［格納先の指定］ダイアログボックスが表示されます。

2.で選択した表見出しを格納するドライブ又はフォルダを設定した後，［OK］ボタンをクリックします。

見出し情報が指定したドライブ又はフォルダに格納されます。格納後，［見出し選択］ダイアログボックスが表示されます。

［閉じる］ボタンをクリックします。

［見出し編集］ダイアログボックスに戻ります。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

9.5.5　見出し情報の一括登録

複数の表の見出し情報を，見出し辞書に一括登録できます。

(1)　操作

図9‒5　 見出し情報を見出し辞書に一括登録する操作

［見出し編集］ダイアログボックスから［一括作成(M)］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

一括登録したい表を選択して［OK］ボタンをクリックします。

［登録経過］ダイアログボックスが表示されます。

補足

［登録経過］ダイアログボックスでは，辞書登録が完了した表名が順に表示されていきます。［キャンセル］ボタンをクリックすると，現在の辞書登録完了後に，残りの辞書登録がキャンセルされます。

既に見出し情報が見出し辞書に登録されている表を登録する場合には，［上書き］ダイアログボックスが表示されます。

［はい］ボタンをクリックした場合は，現在の辞書ファイルに上書きします。

［いいえ］ボタンをクリックした場合は，現在の表の登録を中止して次の表の登録に進みます。

［すべて上書き］ボタンをクリックした場合は，これ以降の表で既に辞書登録されている表についても，メッセージを表示することなく上書きします。

補足

見出し辞書を上書きしても，グループ名の情報は変更されません。

［OK］ボタンをクリックします

［見出し編集］ダイアログボックスに戻ります。

9.5.6　見出し辞書のグループ設定

見出し辞書には，それぞれの表名にグループを設定できます。グループを設定すると，見出し辞書を使った抽出でグループ名を目安にして，表が選択できます。

グループを設定する操作を次に説明します。

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

［登録表一覧(T):］リストから，グループ名を設定したい表を選択します。

一度に複数の表を選択することもできます。

選択した表に設定するグループ名を，［グループ名(G):］コンボボックスに入力，又はリストから選択します。

［設定(S)］ボタンをクリックします。

グループ名の設定（変更，又は削除）を確認するメッセージが表示されます。

［はい］ボタンをクリックすると，グループ名が設定されます。

9.5.7　別のドライブ又はフォルダの見出し情報を読み込む

通常，見出し辞書はDBPARTNER2が動作するフォルダにあります。このため，既に作成した見出し情報を編集したり削除したりする場合には，特に指定しなければこの見出し辞書から読み込まれます。この見出し辞書の中ではなく別のドライブ又はフォルダにある見出し情報を読み込む場合には，ドライブ又はフォルダを指定して読み込みます。

一つの見出し辞書をマスタ辞書として，必要な見出し情報だけを読み込んで編集して個人用の見出し辞書に登録する場合などに利用すると便利です。

(1)　操作

見出し情報を別のドライブ又はフォルダから読み込む操作は，［見出し編集］ダイアログボックスから始めます。別のドライブ又はフォルダにある見出し情報を読み込む操作を次の図に示します。

図9‒6　 別のドライブ又はフォルダから読み込む操作

［見出し編集］ダイアログボックスの［読み込み(R)...］ボタンをクリックします。

［読み込み先の指定］ダイアログボックスが表示されます。

読み込む見出し情報が格納されているドライブ又はフォルダを指定します。

［OK］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

2.で選択したフォルダにある表見出しの一覧が表示されます。

読み込む見出し情報を選んでから，［編集(E)］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示され，選択した見出し情報が表示されます。

これで読み込みは終了しました。読み込んだ見出し情報を編集又は削除してください。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］ボタンが淡色で表示されて，選択できません。

9.5.8　見出し情報の削除

不要な見出し情報を，見出し辞書から削除します。

(1)　操作

見出し辞書に登録した見出し情報を見出し辞書から削除します。見出し情報の削除は，［見出し編集］ダイアログボックスから始めます。見出し情報を削除する操作を次の図に示します。

図9‒7　見出し情報を削除する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

削除する見出し情報の行を選んでから，［削除(D)］ボタンをクリックします。

見出し辞書から見出し情報が削除されます。

補足

見出し情報を確認したい場合は，［編集(E)］ボタンをクリックして［見出し編集］ダイアログボックスを表示してください。内容を確認後，［見出し編集］ダイアログボックスの［削除(D)］ボタンで削除できます。

［閉じる］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］ボタンが淡色で表示されて，選択できません。

第4編　エラーの対処

10　トラブルが起こったときは

この章では，DBPARTNER2でトラブルが起こったときの対処について説明します。

10.1　トラブルの原因と対処

トラブルの原因と対処を，次の形式で説明しています。

現象．．．

対処．．．

10.1.1　データベースと接続するときに起こるトラブル

エラーメッセージ「DBP3000E」が表示された。

接続先定義ファイルにデータソース名と関連付けた接続先名称を登録していないときは，接続先名称を登録してください。接続先名称については，「2.4.2　パラメタに指定する値」のHOSTNAMEオペランドの説明を参照してください。

10.1.2　DBPARTNER2の操作時に起こるトラブル

機能を選ぶメニューが不活性になっている。

インストールしているDBPARTNER2の型名（参照版／更新版／定義版）が正しいかどうかを確認してください。

表一覧に表が表示されない。

ログインしたユーザで扱える表が存在するかどうかを確認してください。

見出し辞書の指定を変更してみてください。［DBPARTNERメイン］ウィンドウのメニューで［オプション設定］ダイアログボックスを開いて，［見出し辞書］タブを選んでから見出し辞書の［DBPARTNERとDBの情報を使用する］を選んでください。見出し辞書の指定については，「7.1.5　見出し辞書の指定」を参照してください。

表一覧に選択したい表が表示されない。

表示最大件数を超えているときは，接続先定義ファイルのTBLMAXCNTパラメタの値を増やしてください。表示最大件数については，「2.4.2　パラメタに指定する値」のTBLMAXCNTオペランドの説明を参照してください。

絞り込み表示を指定しないでください。絞り込み表示を解除する方法については，「2.5　情報ファイルの作成」を参照してください。

Excelから更新できない。

抽出時に「更新に必要な情報を作成しますか？」で［はい］を選んでください。

Excelがセルへのデータ入力待ち状態のときは，入力を確定してください。

更新権限がない表を更新している場合があります。抽出時に更新権限がない表は選ばないでください。

Excel連携で，Excelにデータを貼り付けられない。

Excel連携の［抽出］を選択し，抽出操作を行ってください。

ODBCドライバでエラーが表示される。

SQLCODEが表示されているときは，接続しているデータベースのメッセージマニュアルを参照してください。

10.1.3　システムに関するトラブル

処理中にDBPARTNER2によって勝手にセッションが切られてしまった。

ODBC接続の場合は，応答監視時間の設定を確認してください。

11　メッセージの一覧

この章では，DBPARTNER2から出力されるメッセージの見方とその意味について説明します。

11.1　メッセージの形式と見方

DBPARTNER2のメッセージの形式と見方について説明します。

11.1.1　メッセージの形式

DBPARTNER2で表示されるメッセージは，メッセージのダイアログボックスに表示されます。形式を次に示します。

シンボルマーク：メッセージの種類を表したマークです。T（タイプコード）に対応しています。

XXX：メッセージを表示した製品を示します。

DBP：DBPARTNER2 Clientのメッセージを示します。

DPOD：DBPARTNER ODBC 3.0 Driverのメッセージを示します。

INS：DBPARTNER2 Clientのインストール時のメッセージを示します。

nnnn：メッセージの通し番号です。

T：タイプコードです。次のように対応しています。

E（エラー）：情報の誤りが通知されるメッセージです。

I（インフォメーション）：情報が通知されるメッセージです。

W（ワーニング）：警告が通知されるメッセージです。

メッセージのダイアログボックスに表示されるボタン名は，メッセージによって［はい(Y)］　［いいえ(N)］の場合と［OK］ボタンの場合があります。

11.1.2　メッセージの見方

このマニュアルでは，メッセージを次の形式で説明しています。

XXXnnnnT：メッセージID

メッセージテキスト：メッセージのダイアログボックスに表示されるテキスト

要因：メッセージが表示された原因

処理：DBPARTNER2の処理

対処：ユーザの処置

11.1.3　注意

「保守担当者に連絡してください」とは，システム管理者が購入時の契約に基づき当社問い合わせ窓口へ連絡することを示します。

エラーコード，シグナル番号などは，保守担当者が使う情報です。

サーバプログラムから通知されたメッセージについては，マニュアル「DABroker」又は「VOS3 データマネジメントシステム XDM E2系 メッセージ（XDM/RD E2）」を参照してください。

データベースから通知されたメッセージについては，該当するデータベース（DBMS）のマニュアルを参照してください。

11.2　メッセージの詳細

メッセージの意味と要因について説明します。

11.2.1　DBPARTNER2のメッセージ

DBPARTNER2のメッセージを示します。一部のメッセージは，このマニュアルには掲載していません。

DBP0001E

DBPARTNER2の稼働に必要なメモリがありません。他のプログラムを終了して，再実行してください。

要因：メモリの確保に失敗しました。次の原因が考えられます。

複数のアプリケーションが起動されている。

Windowsシステムが使用できるメモリ又はリソースが不足している。

対処：他のアプリケーションプログラムを終了して，再実行してください。

DBP0002E

DBPARTNER2の実行中に異常が発生しました。DBPARTNER2を終了します（nnn）。

nnn：詳細コード

要因：DBPARTNER2の実行中に異常が発生しました。

対処：詳細コードをシステム管理者に連絡してください。

DBP0003E

メッセージファイルDBPART2.ERRが不正です。DBPARTNER2を正しくインストールし直してから，再実行してください。

要因：メッセージファイルDBPART2.ERRが不正です。

対処：DBPARTNER2を再インストールしてください。

DBP0004E

メッセージファイルDBPART2.ERRがありません。DBPARTNER2を正しくインストールし直してから，再実行してください。

要因：メッセージファイルDBPART2.ERRが作成されていません。

対処：DBPARTNER2を再インストールしてください。

DBP0005W

処理を中断しますか？

要因：処理の中断が選択されました。

対処：次の処置をしてください。

処理を中断する場合は，［はい］をクリックしてください。

処理を続行する場合は，［いいえ］をクリックしてください。

DBP0006W

抽出するデータがnnn件あります。抽出しますか？

nnn：抽出件数

要因：抽出するデータがnnn件あります。件数を確認してください。

対処：次の処置をしてください。

抽出する場合は，［はい］をクリックしてください。

抽出しない場合は，［いいえ］をクリックしてください。

DBP0007E

起動パラメタの指定が誤っています。

要因：指定されたコマンドラインのパラメタに誤りがあります。

対処：パラメタを正しく指定してください。

DBP0010W

ファイルの書き込み中にエラーが発生しました。

要因：次の原因が考えられます。

ファイルが見つからない，オープンされているファイルが多いなどの理由で，ファイルの書き込み中にエラーが発生しました。

ファイルが書き込み保護されています。

ドライブの容量不足が発生しました。

対処：ファイルが使用できる状態か調査し，使用できない場合，要因を取り除いて，再実行してください。

DBP0011W

ファイルの読み込み中にエラーが発生しました。

要因：ファイルが見つからない，オープンされているファイルが多い，ファイルが破壊されているなどの理由で，ファイルの読み込み中にエラーが発生しました。

対処：ファイルが使用できる状態か調査し，使用できない場合，要因を取り除いて，再実行してください。

DBP0012W

ファイルのオープン又は作成に失敗しました。

要因：ファイルが見つからない，オープンされているファイルが多いなどの理由で，指定されたファイルのオープン又は作成に失敗しました。

対処：ファイルが使用できる状態か調査し，使用できない場合，要因を取り除いて，再実行してください。

DBP0013W

ファイルの削除に失敗しました。

要因：ファイルが見つからない，オープンされているファイルが多いなどの理由で，指定されたファイルの削除に失敗しました。

対処：ファイルが使用できる状態か調査し，使用できない場合，要因を取り除いて，再実行してください。

DBP0014W

更新データの長さがシステムの制限を超えました。（nnn）

nnn：詳細コード

要因：設定された更新データは，接続先定義ファイルのUPDUNITパラメタでBLOCKを指定している場合に更新できるシステムの制限を超えています。

対処：詳細コードによって次の処置をしてください。

1：１度に更新するデータを少なくしてください。

2：列数を減らして表を再定義してください。

DBP0018W

絞り込み条件の指定に誤りがあります。

要因：絞り込み条件に，「.」（ピリオド）が指定されています。

対処：絞り込み条件を正しく指定して，再実行してください。

DBP0019I

絞り込み条件に一致する表はありません。

要因：絞り込み条件に合う表が見つかりませんでした。次の原因が考えられます。

絞り込み条件に指定された文字列を含む表がありませんでした。

全角／半角文字，英字の大文字／小文字を正しく指定していない。

空白文字で始まる所有者名／表名を探す条件として，前方一致，完全一致の条件を指定した。

空白文字で終わる所有者名／表名を探す条件として，後方一致，完全一致の条件を指定した。

対処：絞り込み条件を指定し直して，再実行してください。

DBP0020W

絞り込み条件に指定された文字数が多すぎます。

要因：所有者と表名の最大文字数が，半角254文字を超えています。

対処：絞り込み条件を正しく指定して，再実行してください。

DBP0021W

転送先で指定したファイル（aa...aa）に抽出データを上書きしますか？

aa...aa：ファイル名

要因：転送先で指定したファイルは既に存在します。

対処：次の処置をしてください。

既存のファイルに置き換えたい場合は，［はい］をクリックしてください。既存のファイルに抽出データを上書きします。

既存のファイルを保存したい場合は，［いいえ］ボタンをクリックした後，ファイル名を変更してください。

処理を中止したい場合は，［キャンセル］ボタンをクリックしてください。

DBP0022I

DBPARTNER2を終了できません。

要因：DBPARTNER2が終了できる状態ではありません。

対処：DBPARTNER2の状態を確認してください。

DBP0025W

指定したファイルまたはフォルダのパスが長すぎます。

要因：ロングファイル名で256バイトより長いパスを選択しました。

対処：ファイル名もしくはフォルダ名を短く改名した後，再度実行してください。

DBP0400W

指定されたファイル（aa...aa）は手順ファイルではないため処理を中止しました。

aa...aa：ファイル名

要因：次の原因が考えられます。

拡張子が「.DPC」以外のファイルが指定されています。

手順ファイル以外で，拡張子が「.DPC」のファイルが作成されています。

DBPARTNER2で生成した手順ファイルの内容が書き換えられています。

対処：次の処置をしてください。

拡張子が「.DPC」以外のファイルを指定した場合は，正しいファイル（拡張子が「.DPC」のファイル）を指定してください。

上記以外の場合は，指定した手順ファイルの実行及び参照はできません。

DBP0401W

指定されたファイル（aa...aa）は既に存在します。上書きしますか？エラーになった処理を登録する場合は，画面で内容を確認してください。

aa...aa：上書きする手順ファイル名

要因：手順ファイルの登録で指定されたファイルは既存のファイルです。手順ファイルの実行時のエラーなど，エラーが発生した後に手順ファイルを登録する場合は，内容を確認してください。

対処：次の処置をしてください。

既存のファイルを新しい内容で上書きする場合は，［はい］をクリックしてください。

上書きしない場合は，［いいえ］をクリック後，ファイル名を変更してください。

DBP0402W

手順ファイル（aa...aa）を削除しますか？

aa...aa：ファイル名

要因：指定された手順ファイルを削除します。削除してよいか確認してください。

対処：次の処置をしてください。

手順ファイルを削除する場合は，［はい］をクリックしてください。

手順ファイルを削除しない場合は，［いいえ］をクリックしてください。

DBP0403W

指定されたファイル（aa...aa）の接続先名称（bb...bb）は接続先定義ファイルにありません。

aa...aa：手順ファイル名

bb...bb：接続先名称

要因：手順ファイルの実行又は参照に指定されたファイルに登録されている接続先名称が，接続先定義ファイルに定義されていません。

対処：次のどちらかの処置をしてください。

見つからなかった接続先名称を接続先定義ファイルに指定してください。

［手順ファイルの内容変更］画面（［手順］−［変更］−［内容］）で接続先名称を変更してください。

DBP0404I

上書きする手順ファイル（aa...aa）にはコメントが付加されています。コメントを残しますか？コメント：bb...bb

aa...aa：ファイル名

bb...bb：コメント

要因：［手順の一覧にファイル情報を表示］オプションがチェックされていない(ファイル情報を表示しない)状態で，コメントが付加されている手順ファイルを上書きしようとしています。

対処：次の処置をしてください。

コメントを残す場合は，［はい］をクリックしてください。

コメントを削除する場合は，［いいえ］をクリックしてください。

処理を中止する場合は，［キャンセル］をクリックしてください。

DBP0405W

Client32形式で登録できません。（nnn）

nnn：詳細コード

要因：DBPARTNER/Client32形式でサポートされていない情報があるため登録できません。

詳細コードに示された要因によって，登録できません。

01：転送先がEURになっています。

02：転送先がデータ表示ウィンドウになっています。

03：転送先がOFIS/POLになっています。

04：転送先がBiff4形式のクリップボードになっています。

05：仮想列が指定されています。

06：BLOB列が指定されています。

08：条件式直接入力が指定されています。

09：ODBC繰り返し列が指定されています。

10：SQLが指定されています。

対処：原因を取り除いてから，再度実行してください。

DBP0500W

指定された値は列の属性と合っていません。

要因：列の属性と定数の組み合わせに誤りがあります。

対処：列属性と指定する定数は，使用するデータベースによって異なります。詳しくは，各DBMSの規則を参照してください。

DBP0501W

括弧の指定方法に誤りがあります。

要因：条件関連式の左括弧と右括弧の数が一致しません。

対処：左括弧と右括弧の数を合わせて指定してください。

DBP0502W

条件関連式に指定できない文字があります。

要因：条件関連式に指定できない文字があります。

対処：条件関連式に指定できる文字は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0503W

条件一覧に存在しない番号が指定されています。

要因：条件一覧にない番号が条件関連式に指定されています。

対処：条件一覧にない番号を削除してください。

DBP0504W

指定された値は指定できる有効範囲を超えています。

要因：定数の有効範囲を超える値が指定されました。

対処：定数の有効範囲は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0505W

数値データのけた落ちが発生しました。

要因：有効範囲を超える定数が指定されました。

対処：定数の有効範囲は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0506W

指定された値は日間隔属性の有効範囲を超えています。

要因：指定された値は，有効範囲（-99，991，199〜99，991，199）を超えています。

対処：有効範囲内の値を入力して，再実行してください。

DBP0507W

SQL文の長さがシステムの制限を超えました。

要因：生成されたSQL文の長さがシステムの制限を超えています。

対処：SQL文の長さを減らすために，次の処理を一つ以上実行してください。

指定した列の数を減らしてください。

指定した条件の数を減らしてください。

指定した条件関連式を短くしてください。

DBP0508W

条件関連式のネスト数が64を超えました。

要因：条件関連式のネスト数が64を超えています。

対処：条件関連式のネスト数を減らすために，次の処理を一つ以上実行してください。

括弧内の検索条件を減らしてください。

括弧の数を減らしてください。

論理式がOR，ANDの順に指定している数を減らしてください。

DBP0509W

AND，OR，及びNOTの総数が255個を超えました。

要因：条件関連式のAND，OR，及びNOTの総数が255個を超えました。

対処：AND，OR，及びNOTの総数が255個以下となるよう変更して，再実行してください。

DBP0510W

文字パターンの指定に誤りがあります。

要因：指定できない文字パターンが設定されました。

対処：文字パターンの規則は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0511W

アポストロフィの指定方法に誤りがあります。

要因：文字定数の中のアポストロフィが2個続けて指定されていません。

対処：アポストロフィを文字データとして使う場合は，2個続けて指定してください。

DBP0512W

条件関連式の構文が誤っています。

要因：条件関連式の構文が誤っています。

対処：条件関連式の構文を正しく指定し再実行してください。

DBP0513W

比較できない属性の列を指定しています。

要因：比較できない属性の列を比較しようとしました。

対処：列比較の規則は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0514W

文字データの列又は定数に四則演算を指定しています。

要因：文字データの列又は定数に四則演算は指定できません。

対処：四則演算の指定を削除してください。

DBP0515W

列記号の指定に誤りがあります。

要因：列記号の指定が誤っています。

対処：列記号を正しく指定して，再実行してください。

DBP0516W

条件式の数値の指定に誤りがあります。

要因：数値の指定が誤っています。

対処：数値を正しく指定して，再実行してください。

DBP0517W

列演算条件式の演算子の指定に誤りがあります。

要因：次の原因が考えられます。

演算子を2個続けて指定しています。

列名と列名の間又は数値の間に，演算子がありません。

演算子の後ろに列名又は数値がありません。

対処：演算子を正しく指定して，再実行してください。

DBP0518W

括弧の指定方法に誤りがあります。

要因：次の原因が考えられます。

列演算条件式の左括弧と右括弧の数が一致しません。

左括弧の前に右括弧を指定しています。

対処：括弧を正しく指定して，再実行してください。

DBP0519W

列演算条件式のネスト数が64を超えました。

要因：列演算条件式のネスト数が64を超えています。

対処：列演算条件式中の演算子又は括弧の数を減らしてください。

DBP0520W

条件式に不正な文字があります。

要因：条件式に指定できない文字（数値，文字定数，演算子，「(」，「)」以外）があります。

対処：条件式の構文を正しく指定して，再実行してください。

DBP0521W

指定された列が見つかりません。

要因：列一覧にない列が指定されています。

対処：列一覧にある列を指定してください。

DBP0522W

条件式に列が指定されていません。

要因：左辺又は右辺に，列が指定されていません。

対処：左辺又は右辺に列を指定して，再実行してください。

DBP0523W

列の指定方法に誤りがあります。

要因：列の指定方法に誤りがあります。

対処：列を正しく指定して，再実行してください。列名に予約語又は区切り記号を使用している場合は「“」（ダブルクォーテーション）で囲んでください。

DBP0524W

条件式に誤りがあります。

要因：次の原因が考えられます。

条件式に誤りがあります。

［列演算条件式］画面に，NULL，IN，LIKE，BETWEEN条件式が指定されています。

対処：条件式を正しく指定して，再実行してください。

DBP0525W

指定された値は列の属性と合っていません。

要因：指定された値は列の属性と合っていません。

対処：列属性と定数の組み合わせは，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0526W

指定された値は指定できる有効範囲を超えています。

要因：有効範囲を超えた値が指定されました。

対処：定数の有効範囲は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0527W

指定された値は列の定義長を超えています。

要因：指定された値は列の定義長を超えています。

対処：列の定義長を確認し，値を定義以内で入力して，再実行してください。

DBP0528W

四則演算は指定できません。

要因：VOS3 XDM/SD E2を使用する場合は，条件式に演算は指定できません。

対処：四則演算の指定を削除して，再実行してください。

DBP0529W

演算できない列が指定されています。

要因：演算できない列が条件式に指定されています。

対処：演算できる属性の列を指定してください。

DBP0530W

四則演算を使用していない条件式は指定できません。

要因：四則演算を使用していない条件式は，［列演算条件式］画面に指定できません。

対処：四則演算を使用した条件式を指定してください。四則演算を使用しない場合は，［条件設定］画面で指定してください。

DBP0532W

指定された値は指定できる有効範囲を超えています。

要因：有効範囲を超えた値が指定されました。

対処：定数の有効範囲は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0533W

条件関連式の括弧の数が64を超えました。

要因：条件関連式に指定した括弧の対の総数が64を超えています。

対処：条件関連式の括弧の数を64以内にして，再実行してください。

DBP0534W

AND，及びORの総数が254を超えました。

要因：条件関連式のAND及びORの総数が254を超えました。

対処：AND，及びORの総数を254以内にして，再実行してください。

DBP0535W

抽出条件を設定できない属性の列が含まれています。

要因：抽出条件の中に，条件を設定できない列が設定されています。

対処：条件を設定できる列属性は，使用するデータベースによって異なります。詳しくは，「8.　列と条件を設定するときの規則」を参照してください。

DBP0550E

サポートしていない属性の列が含まれています。

要因：選択した表にはDBPARTNER2がサポートしていない列が含まれています。

対処：表を構成する列の属性をDBPARTNER2がサポートしているか確認してください。詳しくは，「付録D　DBPARTNER2の列属性」を参照してください。

DBP0707W

表示できる表の最大数を超えました。処理を続行しますか？

要因：表一覧に表示できる表の最大数が，接続先定義ファイルに指定した値を超えました。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。接続先定義ファイルに指定した値までの表で処理が続行されます。

処理を中止する場合は，［いいえ］をクリックしてください。そのあと，接続先定義ファイルの値を変更したい場合は，システム管理者に連絡してください。

DBP0708W

列数が指定された最大数を超えました。処理を続行しますか？

要因：列数が，接続先定義ファイルのCLMMAXCNTパラメタに指定された値を超えました。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。接続先定義ファイルに指定した値までの列で処理が続行されます。

処理を中止する場合は，［いいえ］をクリックしてください。

注意事項：繰り返し列又は配列列の一番目の要素分しか取得できていない場合は，処理を中止して，接続先定義ファイルのCLMMAXCNTパラメタの値を変更してください。

DBP0711I

抽出するデータがないため，データの変更はできなくなります。処理を続行しますか？

要因：選択した表には抽出するデータがありません。又は設定された条件に合うデータがありません。このため，指定された表に対してデータの変更はできません。ただし，データの追加はできます。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。データ表示ウィンドウが表示されます。追加するデータを作成してください

処理を中止する場合は，［いいえ］をクリックしてください。

DBP0712W

変更又は削除するデータが見つかりません。

要因：変更又は削除するデータがデータベース中にないため，更新処理ができません。

対処：再度，更新のため抽出し，変更又は削除するデータがあるかどうかを確認してから更新処理を実行してください。

VOS3 XDM/RD E2の場合は，次の点に注意してください。

XDM/RD E2は，RD環境定義にKEIS CODE SPACE LEVELオペランドを指定していない（又は0を指定している）状態で，埋め字が必要な場合は，NCHAR列に対して，X'4040'を定義長まで埋めます。そのため，NCHAR（4文字）に対して「A」を追加した場合は，列の空白をX'4040'で3文字分を埋めます。

検索時，上記のデータはXDM/RD E2の文字コード変換によって空白部も変換（X'4040'→X'8140'）されるため，結果として「Ａ△△△」（すべて全角）が返されます。

再び「Ａ△△△」（すべて全角）を条件に検索すると，シフトJIS→KEIS変換によって，X'8140'はX'A1A1'に変換されるため，DB内データの空白（X'4040'）とアンマッチとなり，ヒットしません。

上記の条件付き検索をヒットさせる場合は，XDM/RD E2のRD環境定義のKEIS CODE SPACE LEVELオペランドに「2」を指定してください。このオペランドを指定することで，DB内データの空白がX'4040'でも検索が可能となります（検索条件のデータの空白がX'A1A1'でもヒットします）。詳細はマニュアル「VOS3　データマネジメントシステム XDM E2系 XDM/RD E2 使用の手引 −RD環境定義文・空間起動制御文・運用コマンド編−」を参照してください。

既にDB内にX'A1A1'で埋め字がされているデータがある場合や，空白データとしてX'A1A1'とX'4040'が混在している場合は，データの変更や，表の再作成が必要となります。DBPARTNER2でデータを修正する場合は更新条件の解除機能を使用し変更してください。NCHAR属性の項目を更新条件から外すことで，データの変更が可能になります。

DBP0713E

aa...aaのファイルサイズが定義長を超えています。

aa...aa：ファイル名

要因：LONG VARBINARY属性のファイル容量が定義長を超えています。

対処：データベースの定義長以下のデータに修正してください。

DBP0900E

データ変換中に不正なデータが発生しました。

要因：サーバから受け取った抽出データでは処理できません。次の原因が考えられます。

サーバから受け取ったデータの中に処理できない文字が含まれています。

サーバから受け取った抽出データの中に，形式の誤ったデータがあります。

対処：次の処置をしてください。

列数が245個を超えたデータの場合は，［列設定］画面で，列数を245個以内に設定し直したあと，再実行してください。

表定義情報，又は抽出データの中にDBPARTNER2では処理できない文字があるおそれがあります。次に示す文字（EBCDIKコード）を削除してください。

(00)16〜(3F)16，(B2)16〜(B9)16，(CA)16〜(CF)16，

(DA)16〜(DF)16，(E1)16，(EA)16〜(EF)16，(FA)16〜(FF)16

DBP0903W

抽出する列数がXLS形式で作成できる制限を超えているため，XLS形式での抽出はできません。

要因：抽出データの列数が，XLS形式で作成可能な最大列数の256を超えています。

対処：抽出データの列数を，256以下にして再実行してください。

DBP0905W

抽出する列数が257列以上あるため，抽出処理を中止しました。

要因：一度に抽出できる最大の列数は256列です。最大列数を超えると抽出処理は実行されません。

対処：列数が256列以下になるよう，列を選択してください。

DBP0906W

抽出するデータ件数が16385件以上あるため，抽出処理を中止しました。

要因：一度に抽出できる最大データ件数は16384件です。最大データ件数を超えると抽出処理は実行されません。

対処：データ件数が16384件以下になるよう，件数制限又は抽出条件を設定してください。

DBP0907I

抽出したデータの中に文字として処理できないデータがあります。抽出を続行しますか？

要因：抽出しているデータの中に文字として処理できない（画面で表示できない）データを見つけました。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP0908W

抽出する列数がXLSX形式またはXLSB形式で作成できる制限を超えているため，XLSX形式またはXLSB形式での抽出はできません。

要因：抽出データの列数が，XLSX形式又はXLSB形式で作成可能な最大列数の999を超えています。

対処：抽出データの列数を，999以下にして再実行してください。

DBP0909W

抽出する列数が999列以上あるため，抽出処理を中止しました。

要因：一度に抽出できる最大の列数は999列です。最大列数を超えると抽出処理は実行されません。

対処：列数が999列以下になるよう，列を選択してください。

DBP1005W

グループを設定できない属性の列（aa...aa）を選択しているため，集合関数の設定はできません。

aa...aa：列名

要因：選択された列の中にグループ分けを設定できない属性の列があります。そのため，集合関数を設定できません。

対処：集合関数を設定する場合，グループ分けを設定できない属性の列を削除して，再実行してください。

DBP1007E

接続先定義ファイルに，接続先名称（aa...aa）が重複して指定されています。

aa...aa：接続先名称

要因：接続先定義ファイル中に，メッセージで示す接続先名称が重複して指定されています。

対処：接続先定義ファイルの接続先名称には，ユニークな名称を設定してください。

DBP1008E

接続先定義ファイルの接続パラメタ名（nnn行目）の指定が誤っています。

nnn：行数

要因：次の原因が考えられます。

nnn行目にある接続パラメタ名の指定に誤りがあります

接続パラメタ名が1カラム目から指定されていません。

接続パラメタ名が一つの接続先に重複して指定されています。

対処：接続パラメタ名を1カラム目から正しく指定して再実行してください。一つの接続先に対して同じパラメタを複数指定している場合は，一つに訂正してください。

DBP1009E

接続先定義ファイルの接続先の名称が32バイトを超えています。（nnn行目）

nnn：行数

要因：nnn行目にある接続先の名称が，32バイトを超えて指定されています。

対処：接続先の名称を32バイト以内に指定し直してください。

DBP1010E

接続先定義ファイルの先頭に接続先が指定されていません。

要因：接続先定義ファイルの先頭に接続先（HOSTNAME：パラメタ）が指定されていません。

対処：HOSTNAME:パラメタを使用して，接続先定義ファイルの先頭に接続先を指定してください。

DBP1012E

接続先定義ファイルのパラメタの指定値に誤りがあります。（nnn行目）

nnn：行数

要因：nnn行目にある接続先定義ファイルのパラメタの指定値に誤りがあります。

対処：パラメタ指定値を正しくして，再実行してください。

DBP1013E

接続先定義ファイルがありません。

要因：接続先定義ファイルがありません。

対処：接続先定義ファイルを作成してください。その後，インストーラで正しく接続先定義ファイルを指定して，DBPARTNER2を再起動してください。

DBP1015W

値が指定されていません。

要因：［IN条件式］画面で，値が指定されていません。

対処：IN条件式の値を指定してください。

DBP1019W

条件を設定できる属性の列がありません。

要因：条件を設定できる属性の列が設定されていません。

対処：条件は設定できません。［キャンセル］をクリックして［条件設定］画面を閉じてください。別の処理があれば操作を続けてください。

DBP1023E

接続先定義ファイルで，接続先（aa...aa）に必要なパラメタ（bb...bb）が指定されていません。

aa...aa：接続先名称

bb...bb：パラメタ名

要因：接続先定義ファイルに，メッセージで示す接続先に必要なパラメタが指定されていません。

対処：接続先にメッセージで示すパラメタを指定してください。

DBP1024W

これ以上ソートは設定できません。

要因：ソートの数が多いため，これ以上は設定できません。

対処：ソートの数を255以内に設定し直して ください。

DBP1025W

グループ分けの列が多過ぎます。

要因：グループ分けの列が多いため，集合関数は設定できません。

対処：グループ分けの数を2555以内に設定し直してください。

DBP1029W

データの転送を中断します。中断するまでに検索したデータを転送しますか？

要因：データの転送の中断が指定されたため，処理を中断しています。

対処：次の処置をしてください。

転送を中断するまでに検索したデータを使用する場合は，［はい］をクリックしてください。

転送を中断する場合は，［いいえ］をクリックしてください。

処理を取り消す場合は，［キャンセル］をクリックしてください。

DBP1030W

データの転送を中断しますか?

要因：データの転送の中断を指定したため，処理を中断しています。

対処：次の処置をしてください。

データの転送を中断する場合は，［はい］をクリックしてください。

データの転送を続行する場合は，［いいえ］をクリックしてください。

DBP1032W

抽出データの件数は取得できませんでした。処理を続行しますか？

要因：抽出データの件数の取得に失敗しました。次の原因が考えられます。

データベースがHiRDB，ORACLE，VOS3 XDM/RD E2の場合

抽出条件に外結合条件と集合関数が指定されています。

データベースがVOS3 XDM/SD E2の場合

抽出データの件数取得はできません。

上記以外のデータベースの場合

抽出条件に集合関数が指定されています。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。

処理を中断する場合は，［いいえ］をクリックしてください。

DBP1033E

接続先定義ファイルの一行の長さが256バイトを超えています。（nnn行目）

nnn：行数

要因：nnn行目の接続先定義ファイルの一行の長さが256バイトを超えています。

対処：一行の長さを256バイト以内に変更して，再実行してください。

DBP1035E

接続先定義ファイルの読み込み中にエラーが発生しました。

要因：接続先定義ファイルの読み込み中にエラーが発生しました。

対処：DBPARTNER2を終了して，再実行してください。なお，その後も同じエラーが発生する場合は，保守担当者に連絡してください。

DBP1036E

ファイル（aa...aa）の拡張子に誤りがあります。

aa...aa：ファイル名

要因：メッセージで示すファイル名の拡張子に誤りがあります。

転送先ファイルに，拡張子が「.DAT」，「.TXT」，「.CSV」,「.XLSX」又は「XLSB」以外のファイルを指定しています。

手順ファイルに，拡張子が「.DPC」のファイルを指定しています。

コマンドラインで指定した手順ファイル名を「“」（ダブルクォーテーション）で囲っています。

対処：ファイル名又は拡張子を正しく指定して，再実行してください。

DBP1037E

初期値ファイルに指定した，接続先定義ファイルの絶対パス名が誤っています。接続先定義ファイルの拡張子は"DPL"でなければなりません。

要因：初期値ファイルに設定されている，接続先定義ファイルの絶対パス名に，「DPL」以外の拡張子が指定されています。

対処：拡張子に「DPL」を指定して再インストールした後，再実行してください。

DBP1038W

選択された表に，表示できる列がありません。

要因：選択された表がすべてFILLERフィールドのため，列を表示できません。

対処：表示できる列が無いため，列の選択や条件の設定はできません。

DBP1039W

同一の列に対して，グループ分けを2回以上設定できません。

要因：VOS3 XDM/RD E2の場合に，同一の列に対してグループ分けが2回以上設定されています。

対処：同一の列に対するグループ分けの設定を1回にして，再実行してください。

DBP1040W

グループ分けのできない列は，グループ分けされている設定内容の中に追加又は挿入できません。

要因：グループ分けのできない列を，グループ分けされている設定内容の中に追加・挿入しようとしています。

対処：［集合関数設定］画面で，グループ分けの設定を取り消した後に追加・挿入するか，又はグループ分けを設定できる列を選択して，再実行してください。

DBP1043W

指定されたファイル（aa...aa）は更新処理の手順ファイルであるため実行できません。

aa...aa：ファイル名

要因：更新機能をインストールしていない環境では，指定したファイルは実行できません。

対処：更新機能をインストールしてください。

DBP1045I

条件表示リストボックスに結合条件を設定していない表があるため，抽出データが大量になることがあります。処理を続行しますか？

要因：複数の表が選択された状態で，表の結合条件を設定していない表があります。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。結合条件を設定している表の各行に，結合条件を設定していない表の全行を付けた形でデータが抽出されます。この場合，抽出データが大量になることがあります。

処理を中止する場合は，［いいえ］をクリックしてください。条件設定で抽出する表に結合条件を設定してください。

DBP1046I

結合条件を設定できない表があります。処理を続行しますか？

要因：選択した表を結合するときに，結合条件を設定できない表があります。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。［条件設定］画面を表示します。

処理を中止する場合は，［いいえ］をクリックしてください。

複数の表を結合して抽出する場合は，結合条件を設定できる表だけを選択してください。

DBP1048I

設定した抽出時間の上限を超えました。転送を中断します。

要因：［オプション］メニューで設定された抽出時間の上限を超えたため，転送を中断しました。

対処：なし。

DBP1049W

［抽出時間の上限］の値が，設定可能な範囲（1〜nnn分）を超えています。

nnn：［抽出時間の上限］に設定できる最大の値

要因：［抽出時間の上限］に設定した値に誤りがあります。

対処：メッセージに示す範囲の値を設定してください。

DBP1050W

aa...aa属性の列があるため，処理できません。

aa...aa：列属性

要因：メッセージに示す属性の列があるため，処理を中止しました。

対処：［列設定］ダイアログボックスで，メッセージに示す属性の列を削除してください。

DBP1053W

1列目から，ソートまたはグループ分けを指定した列までにある列の定義長の合計がnnnバイトを超えています。

nnn：バイト数

要因：抽出する列の1列目(左端)から，ソート又はグループ分けを設定した列までにある列の定義長の合計が制限を超えました。

対処：列の定義長の合計をメッセージ中に表示されたバイト数以下にして，再実行してください。ただし，数値属性の列は，1けたを1バイトとします。

DBP1054W

ソートまたはグループ分けを指定した列の定義長の合計がnnnバイトを超えています。

nnn：バイト数

要因：ソート又はグループ分けを指定した列の定義長の合計が制限を超えました。

対処：列の定義長の合計をメッセージ中に表示されたバイト数以下にして，再実行してください。ただし，数値属性の列は，1けたを1バイトとします。

DBP1055W

抽出する列がnnn列を超えています。

nnn：列数

要因：抽出する列の数が制限を超えました。

対処：抽出する列の数をメッセージ中に表示された列数以下にしてください。

DBP1056W

抽出する列の定義長の合計がnnnバイトを超えています。

nnn：バイト数

要因：抽出する列の定義長の合計が制限を超えました。

対処：列の定義長の合計をメッセージ中に表示されたバイト数以下にして，再実行してください。ただし，数値属性の列は，1けたを1バイトとします。

DBP1057W

連携中のプログラムからの更新はできなくなります。抽出を続行しますか？（nnn）

nnn：詳細コード

要因：詳細コードで示された理由によって，抽出したデータは更新できません。

01：表結合されています。

02：表を更新する権限がありません。

03：集合関数が設定されています。

04：列を追加，削除した，又は列の順序を並べ替えています。

05：繰り返し列を選択しています。

06：列定義長が制限を超えています。

ODBC接続を使用して［データ表示］ウィンドウと連携し，接続先定義ファイルのUPDUNITにSINGLE以外を指定している時の制限

定義長4096バイト以内。BINARY属性の列は，定義長2048バイト以内。

ODBC接続を使用して，［データ表示］ウィンドウ以外と連携する時又は，接続先定義ファイルのUPDUNITにSINGLEを指定している時の制限

定義長255バイト以内。BINARY属性の列は，定義長127バイト以内。

07：以下に示す属性の列が含まれています。

REAL，FLOAT，DOUBLE属性の列が含まれています。REAL，FLOAT，DOUBLE属性のデータを更新する場合は，更新条件から解除してください。又は接続先定義ファイルのUPDUNITパラメタにROWIDを設定してください。

VARBINARY属性の列が含まれています。VARBINARY属性のデータは更新できません。

LONG VARBINARY属性の列が含まれています。LONG VARBINARY属性のデータを更新する場合は，接続先定義ファイルのUPDUNITパラメタにSINGLE以外を設定してください。

ORACLEにアクセスする場合は，LONG VARCHAR属性のデータは更新できません。

08：抽出する列数が255列を超えています。

10：仮想列が設定されています。

11：更新条件が設定されている列を一つも選択していません。

12：配列列の要素番号が昇順に並んでいません。又は，要素番号に抜けがあります。

13：同じ列が選択されています。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。データを抽出します。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP1058W

ソートまたはグループ分けを設定した列がnnn列を超えています。

nnn：列数

要因：ソートを設定した列とグループ分けを設定した列の合計が制限を超えました。

対処：ソート又はグループ分けを設定した列の合計をメッセージ中に表示された列数以下にして再実行してください。ただし，同じ列にソートとグループ分けを設定している場合は，列数は1と数えます。

DBP1059W

パスワードに指定できない文字があります。

要因：パスワードとして指定した文字列に，次のどれかの文字が含まれています。

全角文字

半角文字の括弧

不正文字

対処：パスワードを正しく指定して，再実行してください。

DBP1063E

接続先定義ファイルで，接続先（aa...aa）のパラメタの指定に誤りがあります。パラメタにbb...bb:cc...ccを指定した場合，dd...dd:ee...eeは指定できません。

aa...aa：接続先名称

bb...bb：パラメタ

cc...cc：設定内容

dd...dd：パラメタ

ee...ee：設定内容

要因：パラメタ間の指定内容に矛盾があります

対処：接続先定義ファイルのパラメタを正しく指定して，DBPARTNER2を再起動してください。

DBP1064W

列情報が不足しているため，データを抽出できません。

要因：接続先定義ファイルに指定したCLMMAXCNTパラメタの制限を超えたため，すべての列情報を取得できませんでした。

対処：CLMMAXCNTパラメタの値を大きくして，DBPARTNER2を再起動してください。又は，［列選択］画面で抽出する列を指定してください。

DBP1065E

指定されたファイル（aa...aa）は定義機能を使用した手順ファイルであり，参照・実行できません。

aa...aa：ファイル名

要因：定義機能をインストールしていない環境では，指定したファイルを参照・実行できません。

対処：定義機能をインストールして，参照・実行してください。

DBP1066W

指定されたアプリケーションプログラムは，起動できません。

要因：次の理由によってアプリケーションプログラムは起動できません。

オプション設定画面で指定した表示アプリケーションプログラムが見つかりませんでした。

表示アプリケーションプログラムを起動するためのメモリが不足しています。

対処：オプション設定画面で表示アプリケーションプログラムを正しく指定して，再実行してください。

DBP1067W

指定された表示アプリケーションプログラムのパス名又は，ファイル名が正しくありません。

要因：指定した表示アプリケーションプログラムのパス名又は，ファイル名が正しくありません。

対処：表示アプリケーションプログラムのパス名又は，ファイル名を正しく指定して再実行してください。

DBP1069W

［データ確認］の値が，設定可能な範囲（1〜32767件）を超えています。

要因：［抽出時間の上限］に設定した値に誤りがあります。

対処：メッセージに示す範囲の値を設定してください。

DBP1070W

この環境ではデータベースに転送できません。転送先をaa...aaに変更します。

aa...aa：転送先種別

要因：定義機能が使用できない環境では，データベースに転送できません。

対処：次のどちらかの処置をしてください。

定義機能が使用できる環境に変更してください。

変更された転送先で処理を続行してください。

DBP1071W

保存するデータは，nnn件です。処理を続行しますか？

nnn：保存するデータ件数

要因：保存するデータはnnn件です。保存してよいか確認してください。

対処：次の処置をしてください。

データを保存する場合は，[はい]をクリックしてください。

データを保存しない場合は，[いいえ]をクリックしてください。

DBP1072W

選択された表（aa...aa）がありません。

aa...aa：表名

要因：次の原因が考えられます。

抽出結果を保存する処理で，抽出元に指定した表名は存在しません。

対処：次の処置をしてください。

表を選択し直して，再実行してください。

DBP1077I

SQLの処理が正常に終了しました。

要因：SQLの処理が正常に終了しました。

対処：なし。

DBP1078E

ファイルが大きすぎます。

要因：指定されたファイルに格納されているSQL文が30000バイトを超えています。

対処：SQLの長さを30000バイト以下に編集してください。

DBP1079W

転送先がデータベースになっているため，aa...aaに変更します。

aa...aa：転送先種別

要因：SQL実行では，実行結果をデータベースに転送できません。

対処：変更された転送先で処理を続行してください。

DBP1080E

ファイルに文字列がありません。

要因：指定されたファイル中に，スペース及び改行コード以外の有効な文字列がありません。

対処：正しいSQLの格納されたファイルを指定して，再実行してください。

DBP1081E

入力エリアに文字列がありません。

要因：SQL入力エリアに，スペース及び改行コード以外の有効な文字列がありません。

対処：正しいSQLを入力して，再実行してください。

DBP1082I

複数の表を使用しているため，条件の指定方法によりデータが大量になることがあります。処理を続行しますか？

要因：複数表からの抽出は，データが大量になることがあります。結合条件だけでは，十分にデータを絞り込めません。結合条件とは別に「データを絞り込むための条件」の指定をお薦めします。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。現在の条件で抽出します。

処理を中止する場合は，［いいえ］をクリックしてください。条件設定で条件を設定してください。

DBP1083W

ソートが設定できない列がありました。

要因：ソートが設定できない列がありました。次の原因が考えられます。

別の種類のソートが既に設定されています。

同じ列に対して，既にソートが設定されています。

対処：ソートの設定内容を確認してください。

DBP1084W

集合関数が設定できない列がありました。

要因：集合関数が設定できない列がありました。次の原因が考えられます。

数値属性ではない列に平均，合計の設定がされました。

選択された列は，集合関数が設定できません。

対処：集合関数の設定内容を確認してください。

DBP1085W

すべての表の列を表示することができませんでした。続行しますか？

要因：次の原因が考えられます。

列一覧表示領域の最大文字数を超えました。

メモリ不足が発生しました。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。列一覧に先頭の表の列を表示します。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP1086W

結合の内容2を選択した場合，同じ表の列は指定できません。

要因：表結合条件画面で，結合の内容2を選択した場合，同じ表の列は指定できません。

対処：結合の内容を変更するか，条件に指定する表を変更して，再実行してください。

DBP1087W

ALIAS表とALIAS表以外の結合はできません。

要因：表種別が「ALIAS」の場合は，ALIAS表としか結合できません。

対処：表の選択を変更して再実行してください。

DBP1089W

この環境では，外結合の指定はできません。

要因：外結合できない接続先が設定されています。

対処：外結合の条件を削除するか，表を選択し直して，再実行してください。

DBP1090W

外結合条件が設定されているため，表は追加できません。外結合条件を削除して続行しますか？

要因：表結合条件画面で，外結合条件（結合の内容2）が設定されているため，表は追加できません。

対処：次の処置をしてください。

外結合条件を削除して表を追加する場合は，［はい］をクリックしてください。

表を追加しない場合は，［いいえ］をクリックしてください。

DBP1091W

転送先にaa...aaは指定できません。

aa...aa：Excel連携

要因：転送先をExcel連携に設定して抽出処理が実行されました。

対処：Excel連携を使用する場合は，連携するプログラムのメニューから操作を開始してください。

Excel連携は，Excelの［DBPARTNER2］メニューの［抽出］をクリックしてからデータを抽出してください。

DBP1093W

転送先のパス名又は，ファイル名が正しくありません。

要因：次の原因が考えられます。

転送先ファイル名が絶対パス名で指定されていません。

転送先ファイル名の指定が誤っています。

対処：転送先ファイル名を正しく指定して，再実行してください。

DBP1094W

転送先ファイル名が指定されていません。

要因：転送先ファイル名が指定されていません。

対処：転送先ファイル名を指定して，再実行してください。

DBP1095W

実行中の手順ファイルと転送先ファイルが同一ディスクです。転送用のディスクに入れ替えてください。

要因：実行中の手順ファイルと転送先ファイルが同一ディスクです。

対処：転送用のディスクに入れ替えて［OK］ボタンをクリックしてください。

DBP1096W

現在設定されている転送先ファイル名を置き換えますか？

要因：現在設定されている転送先ファイル名と［オプション設定］画面で設定されている，転送先ファイル名が異なっています。

対処：次の処置をしてください。

現在設定されている転送先ファイル名を［オプション設定］画面で設定されている転送先ファイル名に置き換える場合は，［はい］をクリックしてください。転送先ファイル名を置き換えます。

現在設定されている転送先ファイル名を［オプション設定］画面で設定されている転送先ファイル名に置き換えない場合は，［いいえ］をクリックしてください。

処理を中止する場合は，［キャンセル］をクリックしてください。

DBP1097W

外結合条件式の指定に誤りがあります。

要因：既に設定されている外結合条件式と異なる並びの外結合条件式を設定しています。

対処：外結合条件式を設定し直して，再実行してください。

DBP1098W

手順ファイルの履歴を削除しますか？

要因：手順ファイルの履歴を削除します。削除してよいか確認してください。

対処：次の処置をしてください。

手順ファイルの履歴を削除する場合は，［はい］をクリックしてください。

手順ファイルの履歴を削除しない場合は，［いいえ］をクリックしてください。

DBP1099W

接続先定義ファイルのUPDUNITパラメタの指定に誤りがあります。

要因：UPDUNITパラメタに「ROWID」が設定されています。使用するデータベースによってUPDUNITパラメタに「ROWID」が指定できない場合があります。

対処：接続先定義ファイルのUPDUNITパラメタの指定を見直してください。

DBP1106W

ファイル一覧表示領域に表示できる容量を超えました。

要因：容量が不足しているため，カレントフォルダにある全ファイル情報をファイル一覧表示領域に表示できません。

対処：ワイルドカードでファイルを限定するか，必要なファイルを別フォルダに移動して，再実行してください。

DBP1107W

ドライブ（aa...aa）からファイルを開けません。再試行しますか？

aa...aa：ドライブ名

要因：有効でないドライブが指定されました。

対処：正しいドライブ名を指定してください。

DBP1108W

aa...aaは扱えません。パス及びファイル名を確認してください。

aa...aa：パス名又はファイル名

要因：処理できないパス名，又はファイル名が指定されました。

対処：指定したパス名及びファイル名を確認して，再実行してください。

DBP1109W

aa...aaが見つかりません。パス及びファイル名を確認してください。

aa...aa：パス名又はファイル名

要因：指定したパス又は，ファイルがありません。

対処：パス名，及びファイル名を確認して，再実行してください。

DBP1110W

DBPARTNER/Client 03-00より前のバージョンで作成した手順ファイル（aa...aa）は変更できません。

aa...aa：ファイル名

要因：DBPARTNER/Client 03-00より前のバージョンで作成した手順ファイルは，変更できません。

対処：変更したい手順ファイルを一度参照した後，再登録してから変更してください。

DBP1111W

手順ファイル（aa...aa）の内容を変更します。

aa...aa：内容を変更する手順ファイル名

対処：手順ファイルの内容を変更します。内容を変更する場合は次の点に注意してください。手順ファイルが正しく実行できなくなる場合があります。

変更前と変更後の接続先名称で定義されている接続先定義ファイルのパラメタは，同じ値を使用してください。

変更前と変更後の表名は，列の構成が同じ表を指定してください。

変更後の表名，表所有者，表見出しの長さは，手順実行時に使用するシステムの制限を超えないようにしてください。

次の処置をしてください。

手順の内容を変更する場合は，［OK］ボタンをクリックしてください。

手順の内容の変更を取り消す場合は，［キャンセル］をクリックしてください。

DBP1115W

指定されたパス名，又はファイル名が長すぎます。

要因：指定されたパス名又はファイル名が30000バイトを超えています。

対処：パス名又はファイル名を短くして再実行してください。

DBP1117W

［件数制限］の値が，設定可能な範囲（1〜nnn件）を超えています。最大の件数に変更して処理を続行しますか？

nnn：［件数制限］で設定可能な最大件数

要因：［件数制限］に設定した値が，設定可能な最大の件数を超えています。

対処：次のどちらかの処置をしてください。

［件数制限］の値を，メッセージで示す最大の件数にして処理を続行する場合は，［はい］を選択してください。

［件数制限］の値を範囲内の値に変更する場合は，［いいえ］を選択してください。

DBP1118W

仮想列の指定に誤りがあります。

要因：仮想列の指定に誤りがあります。

仮想列の所有者，表名，列名が「“」（ダブルクォーテーション）で正しく囲まれていません。

「“」（ダブルクォーテーション）で囲まれている文字列が256バイトを超えています。

対処：仮想列を正しく指定してください。

DBP1119W

指定された列が見つかりません。

要因：選択された表にない列が指定されています。

対処：仮想列を正しく指定してください。

DBP1120W

データ表示ウィンドウと連携できません。

要因：データ表示ウィンドウが連携できる状態ではありません。

対処：データ表示ウィンドウが表示しているダイアログをすべて閉じてください。

DBP1121W

aa...aaセクションのbb...bbキーの値に誤りがあります。

aa...aa：セクション名

bb...bb：キー名

要因：aa...aaセクションのbb...bbキーの値に誤りがあります。

対処：aa...aaセクションのbb...bbキーの値を正しく指定してください。

DBP1122W

区切り件数の値が誤っています。

要因：指定された値は，有効範囲（1〜999）を超えています。

対処：区切り件数の値を正しく指定してください。

DBP1123W

条件式（aa...aa）は設定できません。

aa...aa：条件式

要因：使用できない条件式を設定しようとしました。又は条件式の設定に誤りがあります。

対処：条件式を見直してください。

DBP1124W

aa...aaは使用できません。

aa...aa：使用できない条件式又は機能

要因：メッセージに示される条件式又は機能は使用できません。

対処：条件式又は機能を見直してください。

DBP1125W

ファイル種別の指定に誤りがあります。

要因：ファイル種別に使用できない文字が含まれています。ファイル種別には，「/」（スラッシュ），「¥」（円記号），「.」ピリオド ，「>」や「<」（不等号），「*」（アスタリスク），「?」（疑問符），「"」（ダブルクォーテーション），「|」（パイプ記号），「:」（コロン），及び「;」（セミコロン）を含めることはできません。

対処：ファイル種別を正しく指定してください。

DBP1126W

データの追加処理はできません。（nnn）

nnn：詳細コード

要因：詳細コードで示された理由によって，データの追加処理はできません。

01：表結合されています。

02：表を更新する権限がありません。

03：集合関数が設定されています。

04：列を追加，削除した，又は列の順序を並べ替えています。

05：繰り返し列を選択しています。

06：列定義長が制限を超えています。

［データ表示］ウィンドウと連携し，接続先定義ファイルのUPDUNITにSINGLE以外を指定している時の制限

定義長4096バイト以内。BINARY属性の列は，定義長2048バイト以内。

［データ表示］ウィンドウ以外と連携する時又は，接続先定義ファイルのUPDUNITにSINGLEを指定している時の制限

定義長255バイト以内。BINARY属性の列は，定義長127バイト以内。

07：以下に示す属性の列が含まれています。

VARBINARY属性の列が含まれています。VARBINARY属性のデータは更新できません。

LONG VARBINARY属性の列が含まれています。LONG VARBINARY属性のデータを更新する場合は，接続先定義ファイルのUPDUNITパラメタにSINGLE以外を設定してください。

ORACLEにアクセスする場合は，LONG VARCHAR属性のデータは更新できません。

08：抽出する列数が255を超えています。

10：仮想列が設定されています。

11：更新条件が設定されている列を一つも選択していません。

12：配列列の要素番号が昇順に並んでいません。又は，要素番号に抜けがあります。

13：同じ列が選択されています。

14：更新機能が使用できない転送先が指定されています。

対処：抽出条件を見直してください。

DBP1127W

LONG VARBINARYを含む抽出方法に誤りがあります。

要因：次の原因が考えられます。

［SQL入力］ダイアログボックスから抽出を実行しました。

［列設定］ダイアログボックスで，LONG VARBINARYの列が選択されていません。

［オプション設定］ダイアログボックスの［データ確認］がチェックされています。

転送先にデータ表示ウィンドウ以外が設定されています。

対処：次の処置をしてください。

LONG VARBINARYの列を含む抽出は，［SQL入力］ダイアログボックスから実行できません。［DBPARTNER2］ウィンドウからの抽出に変えてください。

［列設定］ダイアログボックスで，LONG VARBINARYの列を［選択列］に設定してください。

［転送先設定］ダイアログボックスで，「データ表示ウィンドウ」を選択してください。

DBP1128W

選択できる列の最大数を超えました。処理を続行しますか？

要因：選択している列数が10000列を超えています。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。選択列を10000列にして処理が続行されます。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP1129W

選択できる列の最大数を超えました。

要因：選択している列数が10000列を超えています。

対処：選択している列を減らしてください。

DBP1130E

項目の追加に失敗しました。

要因：項目が多いため，リストボックスやコンボボックスへの追加に失敗しました。

対処：項目数を減らしてください。

DBP1131E

Excel連携プロセスが残っているため，終了できません。

要因：Excel連携のプロセスが終了していないため，DBPARTNER2の終了に失敗しました。次の原因が考えられます。

Excelがダイアログ又はメッセージを表示中です。

Excel連携プロセスの終了よりもDBPARTNER2の終了処理が先に実行されました。

対処：［OK］ボタンをクリックする前に，次の操作をしてください。

Excelがダイアログやメッセージを表示している場合は，先にダイアログやメッセージを閉じてからDBPARTNER2を終了させてください。

Excelがダイアログやメッセージを表示していない場合は，［OK］ボタンをクリックしてください。

DBP1132W

aa...aaが指定されていません。

aa...aa：レポートファイル又はオプション記述ファイル

要因：レポートファイル又はオプション記述ファイルが指定されていません。

対処：次の処置をしてください。

レポートファイルを指定してください。

「オプション記述ファイルを使用する」をチェックしている場合は，オプション記述ファイルを指定してください。

DBP1133W

条件式の指定に誤りがあります。

要因：条件式の指定に誤りがあります。

条件式の所有者，表名，列名が「“」（ダブルクォーテーション）で正しく囲まれていません。

「“」（ダブルクォーテーション）で囲まれている文字列が256バイトを超えています。

対処：条件式を正しく指定して，再実行してください。

DBP1137W

aa...aaは非表示にできません。

要因：メッセージに示される項目名が「非表示」の設定になっています。

対処：メッセージに示される項目名を「表示」の設定にしてください。

DBP1138W

辞書フォルダが指定されていません。

要因：辞書フォルダが指定されていません。

対処：辞書フォルダを指定してください。

DBP1139I

抽出するデータ件数が65536件の制限を超えました。制限を超えたデータは切り捨てました。

要因：抽出するデータ件数が65536件の制限を超えました。制限を超えたデータは切り捨てました。抽出できるデータ件数の制限は次のとおりです。

［項目名］をチェックしない場合は，65536件

［項目名］をチェックした場合は，65535件

Excel連携の場合は，65535件

対処：なし。

DBP1140W

抽出するデータnnn件あり，上限のデータ件数mmm件を超えました。抽出処理を中止します。

nnn：抽出件数

mmm：上限のデータ件数

要因：抽出するデータ件数が制限を超えました。

対処：件数制限又は条件を設定して，抽出データの件数を制限内にして再実行してください。

DBP1141W

抽出するデータnnn件あり，上限のデータ件数mmm件を超えました。抽出処理を続行しますか？

nnn：抽出件数

mmm：上限のデータ件数

要因：抽出するデータ件数が制限を超えました。

対処：次の処置をしてください。

抽出する場合は，［はい］をクリックしてください。

抽出しない場合は，［いいえ］をクリックしてください。

DBP1142W

抽出するデータ件数が65536件の制限を超えました。制限を超えたデータは抽出されません。処理を続行しますか？

要因：抽出するデータ件数が65536件の制限を超えました。制限を超えたデータは切り捨てました。抽出できるデータ件数の制限は次のとおりです。

［項目名］をチェックしない場合は，65536件

［項目名］をチェックした場合は，65535件

Excel連携の場合は，65535件

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。65536件のデータが抽出されます。

処理を中止する場合は，［いいえ］をクリックしてください。件数制限又は抽出条件を設定して，データ件数を65536件以下にしてください。

DBP1143W

抽出するセル数がnnnを超えるため，抽出処理を中止します。

nnn：上限のセル数

要因：抽出するデータのセル数が制限を超えました。セル数の制限値は，DBPART2.infの［SelectOption］セクションで指定されたMaxCellキーの値です。

対処：件数制限又は条件を設定して，抽出データのセル数を制限内にして再実行してください。

DBP1144W

抽出するセル数がnnnを超えます。抽出処理を続行しますか？

nnn：上限のセル数

要因：抽出するデータのセル数が制限を超えました。セル数の制限値は，DBPART2.infの［SelectOption］セクションで指定されたWarningCellキーの値です。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。

処理を中止する場合は，［いいえ］をクリックしてください。件数制限又は抽出条件を設定して，抽出データのセル数を制限内にしてください。

DBP1145W

パラメタが正しく設定されていません。

要因：次の原因が考えられます。

SQL文に?パラメタを指定して，パラメタを設定していない。

SQL文を変更した後，パラメタを設定していない。

表定義を変更した後，パラメタを設定していない。

対処：パラメタを設定してください。

DBP1146W

パラメタを設定した後にSQL文が変更されています。可変値名と初期値を引き継ぎますか？

要因：パラメタを設定した後，SQL文が変更されています。

対処：次の処置をしてください。

設定されている可変値名と初期値を引き継ぐ場合は，［はい］をクリックしてください。

前回設定された可変値名と初期値を先頭から引き継ぎます。

設定されている可変値名と初期値をクリアする場合は，［いいえ］をクリックしてください。

処理を中止する場合は，［キャンセル］をクリックしてください。

DBP1147W

パラメタを設定した後にSQL文が変更されています。パラメタ情報をそのまま使用しますか？

要因：パラメタを設定した後，SQL文が変更されています。

対処：次の処置をしてください。

設定されている可変値名を初期値で実行する場合は，［はい］をクリックしてください。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP1148W

SQL文中のパラメタ数を取得することができませんでした。

要因：次の原因が考えられます。

SQL文に?パラメタの指定がない。

パラメタ数を取得できないデータベースに接続している。

対処：指定しているSQL文に誤りがないか確認してください。

DBP1149W

MaxCellキーの値がWarningCellキーの値を超えていません。

要因：DBPART2.infの［SelectOption］セクションで指定された，MaxCellキーの値がWarningCellキーの値を超えていません。

対処：WarningCellキーの値よりも，MaxCellキーの値を大きくしてください。

DBP1150W

この環境ではパラメタのあるSQL文を実行することはできません。

要因：現在接続しているデータベースでは，パラメタのあるSQL文を実行できません。

対処：選択している接続先に誤りがないか確認してください。

DBP1151W

抽出データの件数が取得できません。

要因：抽出データの件数の取得に失敗しました。抽出条件に外結合条件と集合関数を指定しています。

対処：選択している接続先と抽出条件に誤りがないか確認してください。

DBP1152I

抽出するデータ件数が1048576件の制限を超えました。制限を超えたデータは切り捨てました。

要因：抽出するデータ件数が1048576件の制限を超えました。制限を超えたデータは切り捨てました。

抽出できるデータ件数の制限は次のとおりです。

［項目名］をチェックしない場合は，1048576件

［項目名］をチェックした場合は，1048575件

Excel連携の場合は，1048575件

対処：なし。

DBP1153W

抽出するデータ件数が1048576件の制限を超えました。制限を超えたデータは抽出されません。処理を続行しますか？

要因：抽出するデータ件数が1048576件の制限を超えました。制限を超えたデータは切り捨てました。抽出できるデータ件数の制限は次のとおりです。

［項目名］をチェックしない場合は，1048576件

［項目名］をチェックした場合は，1048575件

Excel連携の場合は，1048575件

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。1048576件のデータが抽出されます。

処理を中止する場合は，［いいえ］をクリックしてください。件数制限又は抽出条件を設定して，データ件数を1048576件以下にしてください。

DBP1154E

クリップボードへの格納形式に誤りがあります。

要因：クリップボードへ格納できない形式が指定されています。

クリップボードへ格納する場合，Excel形式で「16384行まで格納できるExcel形式」又は「65536行まで格納できるExcel形式」だけ指定できます。

対処：Excel形式で「16384行まで格納できるExcel形式」又は「65536行まで格納できるExcel形式」を選択してください。

DBP1155E

Excelの拡張子とExcel形式の組み合わせに誤りがあります。

要因：指定されたExcelの拡張子とExcel形式の組み合わせに誤りがあります。

対処：次の処置をしてください。

拡張子に「.XLS」を指定した場合，Excel形式で「16384行まで格納できるExcel形式」又は「65536行まで格納できるExcel形式」を選択してください。

拡張子に「.XLSX」又は「.XLSB」を指定した場合，Excel形式で「1048576行まで格納できるExcel形式」を選択してください。

DBP1156E

指定されたファイル（aa...aa）はEUR連携機能を登録した手順ファイルであるため，参照・実行できません。

aa...aa：ファイル名

要因：EUR連携機能が使用できないため，手順ファイルの参照・実行できません。

対処：64ビット版のDBPARTNER2 Client(64)ではEUR連携機能が使用できません。EUR連携機能を実行するには，32ビット版のDBPARTNER2 Clientを使用してください。

DBP1157E

指定されたファイル（aa...aa）は転送先にXLS形式のクリップボードを指定した手順ファイルであるため，参照・実行できません。

aa...aa：ファイル名

要因：XLS形式のクリップボード連携機能が使用できないため，手順ファイルの参照・実行ができません。

対処：64ビット版のDBPARTNER2 Client(64)ではXLS形式が使用できません。

XLS形式のクリップボード連携機能を実行するには，32ビット版のDBPARTNER2 Clientを使用してください。

DBP2001W

表示可能セル数を超えたため，行の追加又はデータの表示を中止しました。

要因：データ表示ウィンドウで表示できるセル数(35万セル)を超えたため，行の追加又はデータの表示を中止しました。

対処：列数又は行数を少なくし，次の計算式を満たしてください。

(列数+1)×(行数+1)＜350000

DBP2002E

ファイルのオープンに失敗しました。（nnn，mmm）

nnn，mmm：詳細コード

要因：ファイルのオープン処理に失敗しました。

対処：ファイルが使用できる状態か調査し，使用できない場合，要因を取り除いて，再実行してください。

DBP2005E

データベースを更新するときに，対象となるデータがありません。

要因：更新するデータが指定されていません。次の原因が考えられます。

抽出したデータの内容をまったく変更せずに更新を実行した。

変更したデータを元のデータに戻して更新を実行した。

行を追加した後，値を設定しないで更新を実行した。

対処：データ表示ウィンドウで更新データを作成してから更新を実行してください。

DBP2007W

20000行目以降，1000列目以降のデータは切り捨てました。

要因：抽出したデータが，20000行以上又は1000列以上ありました。20000行目以降又は1000列目以降のデータを切り捨てました。

対処：なし。

DBP2008W

20000行目以降のデータは切り捨てました。

要因：ファイルからの行追加したデータが20000行以上ありました。20000行目以降のデータを切り捨てました。

対処：なし。

DBP2009W

1000列目以降のデータは切り捨てました。

要因：抽出したデータが，1000列以上ありました。1000列目以降のデータを切り捨てました。

対処：なし。

DBP2010E

ドライブの容量が不足しています。（nnn，mmm）

nnn，mmm：詳細コード

要因：データをファイルに格納しようとしましたが，容量が不足しているため，格納できません。以下のドライブの容量を確認してください。

WindowsのTempフォルダがあるドライブ

［抽出］メニューの［ファイルへ出力...］で，データを出力するドライブ

対処：不要なファイルを削除してください。

DBP2011E

既に19999行あるため追加することができません。

要因：既にデータ表示ウィンドウに19999行あるため，行を追加する操作はできません。

対処：なし。

DBP2012W

追加行数の指定が間違っています。

要因：追加行数の指定方法が間違っています。

対処：行数に指定できる文字は半角数字で1〜19999までです。

DBP2013W

DBPARTNER2がダイアログ表示中のため，更新できません。

要因：DBPARTNER2がダイアログを表示しているため，更新できません。

対処：DBPARTNER2のダイアログをすべて閉じた後，更新を再実行してください。

DBP2017E

データ表示ウィンドウが起動できません。

要因：次の原因が考えられます。

エクスプローラなどからデータ表示ウィンドウを起動しました。

DBPARTNER2以外からデータ表示ウィンドウが起動されました。

対処：なし

DBP2018W

更新しますか？

要因：更新処理を開始します。

対処：次の処置をしてください。

更新を開始する場合は，［はい］をクリックしてください。

更新を取りやめる場合は，［いいえ］をクリックしてください。

DBP2019E

データの表示に失敗しました。（nnn）

nnn：詳細コード

要因：LONG VARBINARY属性のデータの表示に失敗しました。次の原因が考えられます。

0：システムに，メモリ又はリソースが足りません。

2：指定されたファイルが見つかりませんでした。

3：指定されたパスが見つかりませんでした。

11：EXEファイルが無効です（in32.EXEではないか，EXEイメージ内のエラーです）。

26：共有違反が発生しました。

27：ファイル名の関連づけが不完全，又は無効です。

28：要求タイムアウトのためにDDEトランザクションを完了できませんでした。

29：DDEトランザクションが失敗しました。

30：ほかのDDEトランザクションが処理されているために，DDEトランザクションを完了できませんでした。

31：指定されたファイル名拡張子には，アプリケーションが関連づけられていません。

対処：ファイル名に誤りがないか確認してください。誤りがない場合は，ファイル タイプが設定されているかしてください。ファイルタイプの設定については，Windowsのオンラインヘルプを参照してください。

DBP2020E

処理できないデータがあります。更新処理を終了します。

要因：データベースから抽出したデータに処理できないデータがあります。DBPARTNER2で扱える文字は次のとおりです。

1バイト文字でX'20'〜X'7E'，又はX'A1'〜X'DF'である

2バイト文字で１バイト目が，X'81'〜X'9F'，又はX'E0'〜X'FC'である

2バイト文字で２バイト目が，X'40'〜X'7E'，又はX'80'〜X'FC'である

対処：システム管理者に連絡してください。

DBP2021E

表定義が変更されているため，更新処理はできません。

要因：抽出する表を選択してから更新を実行するまでの間にデータベースの表定義が変更されているため，更新処理はできません。

対処：［表選択］画面でいったん別の表を選択してから再度抽出する表を選択して，再実行してください。

DBP2022W

更新処理が終了しました。この処理を有効にしますか？

要因：指定されたデータに対する更新処理が正常に終了しました。

対処：次の処置をしてください。

更新処理を有効にする場合は，［はい］をクリックしてください。

更新処理を無効にする場合は，［いいえ］をクリックしてください。

DBP2025E

更新終了処理中にエラーが発生しました。

要因：更新終了処理中にエラーが発生しました。

対処：［OK］ボタンを選択すると，サーバとの接続を切断します。再実行してください。なお，その後も同じエラーが発生する場合は，保守担当者に連絡してください。

DBP2027E

nnn行，mmm列目（名:aa...aa）のデータがデータベースの定義長を超えています。

nnn：エラーとなったデータの行番号

mmm：エラーとなったデータの列番号

aa...aa：エラーとなったデータの列名

要因：指定されたデータが，データベースの定義長を超えています。

対処：データベースの定義長以下のデータに修正して，再実行してください。

DBP2028E

nnn行，mmm列目（名:aa...aa）データがデータベースの列属性と合いません。

nnn：エラーとなったデータの行番号

mmm：エラーとなったデータの列番号

aa...aa：エラーとなったデータの列名

要因：更新処理に失敗しました。次の原因が考えられます。

列属性に合わないデータが指定されました。又は，範囲を超えたデータが指定されました。

Excel連携からの更新の場合，抽出したデータの中に16けた以上の数値がある。

対処：列属性と定数の組み合わせは，データベースによって異なります。詳しくは，各DBMSの規則を参照してください。16けた以上の数値を含む行は，Excelからは更新できません。更新する場合は，データ表示ウィンドウを使用してください。

DBP2029W

連携プログラムに転送したデータでの更新処理はできなくなります。処理を続行しますか？

要因：次に示す場合，連携プログラムに転送したデータでの更新処理はできなくなります。

接続先，ユーザID，又はパスワードを変更した場合

新たに抽出処理を開始した場合

見出し辞書オプションを変更した場合

列を追加，削除した，又は列の順序を並べ替えた場合

列に集合関数を設定した場合

更新条件をすべて解除した場合

手順ファイルを実行／参照した場合

表定義機能を使用した場合

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP2031W

更新処理中にエラーが発生しました。エラーが発生した行より前の処理を有効にしますか？

要因：更新処理中にエラーが発生しました。

対処：次の処置をしてください。

エラーが発生した行より前の更新処理を有効にする場合は，［はい］をクリックしてください。

エラーが発生した行より前の更新処理を無効にする場合は，［いいえ］をクリックしてください。

DBP2032W

更新処理を中断しました。中断行までの処理を有効にしますか？

要因：更新処理が中断されました。

対処：次の処置をしてください。

キャンセル行までの更新処理を有効にする場合は，［はい］をクリックしてください。

キャンセル行までの更新処理を無効にする場合は，［いいえ］をクリックしてください。

DBP2035E

更新できない属性の列が含まれています。

要因：抽出した列の中に，更新できない属性の列が含まれているため，更新処理ができせん。

対処：更新処理が行える列の属性は，使用するデータベースによって異なります。詳しくは，「付録D　DBPARTNER2の列属性」を参照してください。

DBP2036E

列（aa...aa）のデータは，変更できません。

aa...aa：列名

要因：データの変更が許されていない列のデータを加工して更新処理を実行しました。

対処：もう一度，抽出処理を実行した後，メッセージで示された列のデータを加工しないで更新処理を実行してください。

DBP2037E

列（aa...aa）は，変更条件に指定できません。

aa...aa：列名

要因：変更条件に指定できない列に，更新条件を設定して更新処理を実行しました。

対処：メッセージで示された列の更新条件を解除して更新処理を実行してください。

DBP2038E

nnn行目のデータは，他のユーザにより変更されているため更新できません。

nnn：エラーとなった行番号

要因：接続先定義ファイルのUPDUNITパラメタに「ROWID」を指定した更新に失敗しました。次の原因が考えられます。

更新する行が他のユーザによって更新されている。

Excel連携からの更新の場合，抽出したデータの中に16けた以上の数値がある。

対処：もう一度，抽出処理を実行した後，更新処理を実行してください。16けた以上の数値を含む行は，Excelからは更新できません。更新する場合は，データ表示ウィンドウを使用してください。

DBP2039E

ExcelとDBPARTNER2の連携中に異常が発生しました。（nn....nn）

nn....nn：詳細コード

要因：ExcelとDBPARTNER2の連携中に異常が発生しました。

1007：Excelがインストールされていません。

1009：Excelでダイアログ表示中又は，セルやブック名の編集中です。

1024：最後にインストールしたExcelは古いバージョンです。

1025：Excelが中間ファイルのOPENに失敗しました。

1026：Excelが中間ファイルの出力に失敗しました。

1027：Excelが中間ファイルのCLOSEに失敗しました。

1028：最後にインストールしたExcelは古いバージョンです。

10xx：Excel起動インタフェースが不正です。

対処：Excelが正しく使用できることを確認してください。64ビット版のDBPARTNER2からExcel連携する際は64ビット版のExcelを使用してください。

詳細コードが1025，1026，1027の場合は，メモリの不足やTempフォルダの容量不足のおそれがあります。

DBP2040W

抽出するデータ件数が制限を超えました。

要因：出力するデータ件数が1048576件の制限を超えました。制限を超えたデータは切り捨てます。

対処：なし。

DBP2041W

データの削除と更新を一度に行えません。

要因：接続先定義ファイルのUPDUNITパラメタに「ROWID」を指定した更新に失敗しました。データの削除と更新を一度に実行しています。

対処：次の処置をしてください。

接続先定義ファイルのUPDUNITパラメタに「ROWID」を指定する場合は，データの削除と更新を別々に実行してください。

データの削除と更新を一度に実行する場合は，接続先定義ファイルのUPDUNITパラメタに「ROWID」以外を使用してください。

DBP3000W

ODBCドライバでデータベースにアクセス中にエラーが発生しました。 メッセージ：nnn SQLState：mmm SQLサーバエラー：aa...aa

nnn：ODBCドライバから出力されるメッセージ

mmm：メッセージID

aa...aa：詳細コード

要因：ODBCドライバでデータベースにアクセス中にエラーが発生しました。

対処：使用しているODBCドライバ又はODBCマネージャーのメッセージに従い対処してください。

DBP3001E

表又は列がありません。

要因：表又は表の列がありません。

対処：サーバ側で表又は列の有無を確認してください。

DBP3007E

ODBC32.DLLのロードに失敗しました。

要因：ODBC32.DLLが削除されている又は，壊れているおそれがあります。

対処：DBPARTNER2を再インストールしてください。

DBP3008E

抽出するデータがありません。

要因：選択した表には，抽出するデータがありません。又は設定された条件に合うデータがありません。

対処：条件を変更して再実行してください。

DBP3009E

選択した列の数と，抽出データの列数が一致していないため処理を中断しました。

要因：抽出する列数と，実際に取得したデータの列数が一致していないため，正しく処理ができません。

対処：仮想列として次の設定が無いか確認してください。

"表名".*

"列名","列名"

DBP3501E

表名の指定が誤っています。

要因：表名の指定が誤っています。次の原因が考えられます。

表名の長さが制限を超えています。

使用できない文字を使用しています。

対処：表名を正しく入力してください。

DBP3502E

表名の指定がありません。

要因：表名の指定がありません。

対処：表名を入力し，処理を続行してください。

DBP3503E

表見出しの指定が誤っています。

要因：表見出しの指定が誤っています。次の原因が考えられます。

表見出しの長さが制限を超えています。

使用できない文字を使用しています。

対処：表見出しを修正し，再度実行してください。

DBP3504E

表注釈の指定が誤っています。

要因：表注釈の指定が誤っています。次の原因が考えられます。

表注釈の長さが制限を超えています。

使用できない文字を使用しています。

対処：表注釈を修正し，再度実行してください。

DBP3505E

列名の指定がありません。

要因：列名の指定がないため，表が定義できません。

対処：列名を入力し，再度実行してください。

DBP3506E

列名の指定が誤っています。

要因：列名の指定が誤っています。次の原因が考えられます。

列名の長さが制限を超えています。

使用できない文字を使用しています。

対処：列名を修正し，再度入力してください。

DBP3507E

列見出しの指定が誤っています。

要因：列見出しの指定が誤っています。次の原因が考えられます。

列見出しの長さが制限を超えています。

使用できない文字を使用しています。

対処：列見出しを修正し，再度実行してください。

DBP3508E

属性の指定が誤っています。

要因：指定された列の属性が誤っています。

対処：列属性を修正し，再度実行してください。

DBP3509E

長さの指定が誤っています。

要因：長さの指定が誤っています。次の原因が考えられます。

列属性に対して指定された長さが制限を超えています。

数字以外を使用しています。

32000を超える数値が入力されています。

対処：長さを修正し，再度実行してください。

DBP3510E

小数点の指定が誤っています。

要因：小数点の指定が誤っています。次の原因が考えられます。

小数点に指定した数値が長さを超えています。

数字以外を使用しています。

対処：小数点を修正し，再度実行してください。

DBP3511E

列注釈の指定が誤っています。

要因：列注釈の指定が誤っています。次の原因が考えられます。

列注釈の長さが制限を超えています。

対処：列注釈を修正し，再度実行してください。

DBP3512E

RDエリア名の指定が誤っています。

要因：RDエリア名の指定が誤っています。次の原因が考えられます。

RDエリアが定義されていません。

使用できない文字が使用されています。

対処：RDエリア名を修正し，再度実行してください。

DBP3513E

インデクス名の指定が誤っています。

要因：インデクス名の指定が誤っています。次の原因が考えられます。

インデクス名の長さが制限を超えています。

使用できない文字を使用しています。

対処：インデクス名を修正し，再度実行してください。

DBP3514E

インデクスに指定された列数の合計が制限を超えています。

要因：インデクスとして定義された列数の合計が制限を超えています。

HiRDBの場合，16が制限となります。

ORACLEの場合，16が制限となります。

対処：インデクスとして定義する列数を確認してください。

DBP3515E

インデクスに指定された列のデータ長の合計長が制限を超えています。

要因：インデクスとして定義する列の長さの合計長が制限を超えています。HiRDB使用の場合，255バイトが制限となります。

対処：インデクスとして定義する列を選択し直して再度実行してください。

DBP3516E

インデクス名の変更なしにユニーク指定の変更はできません。

要因：既存のインデクスのユニーク指定は変更できません。ユニーク指定を変更する場合は，インデクス名を変更してください。

対処：インデクス名を修正するか，ユニーク指定を修正し再度実行してください。

DBP3517E

インデクス名の変更なしに昇順･降順の変更はできません。

要因：既存のインデクスの昇順・降順は変更できません。昇順・降順を変更する場合は，インデクス名を変更してください。

対処：インデクス名を修正するか，昇順・降順を修正し再度実行してください。

DBP3518E

可変長文字属性を持つ列にはインデクスの定義はできません。

要因：可変長文字属性を持つ列をインデクスとして定義できません。

対処：インデクスとして定義する列を選択し直し，再度実行してください。

DBP3519E

1つの表に対して定義できるインデクス数の合計が制限を超えています。

要因：一つの表に対し定義できるインデクスの合計が255を超えています。

対処：既存のインデクスを削除するか，インデクス定義を中止してください。

DBP3520E

1つの表に対して定義できる列数の合計が制限を超えています。

要因：一つの表に対して定義できる列数の合計が制限を超えています。

HiRDB使用の場合，30000が制限となります。

ORACLE使用の場合，254が制限となります。

対処：前にある列を削除するか，列定義情報の追加を中止してください。

DBP3521W

表（aa...aa）を削除しますか?

aa...aa：表名

要因：表定義処理で削除が選択されました。

対処：削除する場合は［はい］を，削除しない場合は［いいえ］を応答してください。

DBP3522E

表の定義で列の追加・削除はできません。

要因：既存の表を編集する場合，列の追加・削除はできません。

対処：列数の増減をなくし，再実行してください。

DBP3523E

表の保存で列の追加・削除はできません。

要因：抽出したデータをデータベースに保存する場合，列の追加・削除はできません。

対処：列数の増減をなくし，再実行してください。

DBP3524E

属性が指定されていません。

要因：属性が指定されていません。

対処：属性を正しく指定して，再実行してください。

DBP3525E

インデクス名が指定されていません。

要因：インデクス名が指定されていません。

対処：インデクス名を正しく入力して，再実行してください。

DBP3528E

列情報が定義されていません。

要因：指定した表名に対して列名，列見出し，列注釈など，列の情報が定義されていません。

対処：列情報を入力して，再実行してください。

DBP3529E

列名（aa...aa）が重複して指定されています。

aa...aa：列名

要因：指定された列情報の中で同一の列名が重複して指定されています。

対処：列名を修正し，再実行してください。

DBP3531I

所有者名の異なる表名を選択しました。

要因：表情報取得で，所有者名の異なる表が選ばれています。

対処：他の所有者の表を参照する場合は続行してください。

DBP3532E

この環境では定義機能は使用できません。

要因：現在使用している接続先は，次の理由によって定義機能は使用できません。

接続するデータベースがHiRDB，ORACLE以外

ODBCドライバがDBPARTNER ODBC 3.0 Driver以外

対処：選択している接続先に誤りがないか確認してください。

DBP3533E

インデクス名（aa...aa）の対象列名が指定されていません。

aa...aa：インデクス名

要因：aa...aaのインデクス名の対象列名が指定されていません。

対処：［インデクス定義］ダイアログボックスを表示し，aa...aaで示されたインデクスの対象列名を指定してください。又は，インデクス名を削除してください。

DBP3534E

列名は変更できません。

要因：既存の表を変更する場合，列名は変更できません。

対処：列名を正しく指定して，再実行してください。

DBP3535E

属性は変更できません。

要因：既存の表を編集する場合，属性は変更できません。

対処：属性を正しく指定して，再実行してください。

DBP3536E

表の保存で属性は変更できません。

要因：抽出したデータをデータベースに保存する場合，属性は変更できません。

対処：属性の変更を修正して，再実行してください。

DBP3537E

表の保存で長さは変更できません。

要因：抽出したデータをデータベースに保存する場合，長さは変更できません。

対処：長さの変更を修正して，再実行してください。

DBP3538E

表の保存で小数点は変更できません。

要因：抽出したデータをデータベースに保存する場合，小数点は変更できません。

対処：小数点の変更を修正して，再実行してください。

DBP3539W

表定義情報の変更が無いため，表の定義･更新はできません。

要因：表定義の変更がなかったため，データベースへの表定義又は，データベース内の表の更新をしません。

対処：次の処置をしてください。

新規に表を定義する場合は，表名，表見出し，列名などの表定義情報を入力してください。

既存の表を更新する場合は，既存の表の編集をしてください。

DBP3540E

インデクスに指定された列名（aa...aa）が重複しています。

aa...aa：列名

要因：インデクスの対象列として指定された列名が重複しています。

対処：列名を変更して，再実行してください。

DBP3541W

表（aa...aa）を定義しますか？

aa...aa：表名

要因：表定義処理で設定された内容で表を定義します。

対処：次の処置をしてください。

定義する場合は，［はい］をクリックしてください。

定義しない場合は，［いいえ］をクリックしてください。

DBP3542E

指定した列数が制限値を超えています。

要因：指定された列数の合計が30000を超えているため処理の続行ができません。

対処：指定した列を削除して再実行してください。

DBP3543W

表定義の更新では格納条件の変更はできません。

要因：表定義の更新では，格納条件の変更はできません。

対処：表の格納条件を参照してください。

DBP3544E

NULL抑止の指定は変更できません。

要因：表定義の更新でNULL抑止指定の変更はできません。

対処：NULL抑止指定を修正し，再実行してください。

DBP3545W

表が見つかりません。

要因：入力又は選択した表は存在しません。

対処：表名を正しく指定し，再実行してください。

DBP3546W

列名変更で列の追加はできません。

要因：列名変更で列を追加しようとしています。

対処：列を追加したい場合は表を再作成してください。

DBP3547W

この環境では表名・列名の変更はできません。

要因：現在使用している接続先は，次の理由によって表名・列名の変更はできません。

接続するデータベースがHiRDB以外

ODBCドライバがDBPARTNER ODBC 3.0 Driver以外

対処：選択している接続先に誤りがないか確認してください。

DBP3548W

表（aa...aa）の表名・列名を変更しますか？

aa...aa：表名

要因：表名・列名の変更で設定された内容で表名・列名を変更します。

対処：次の処置をしてください。

定義する場合は，［はい］をクリックしてください。

定義しない場合は，［いいえ］をクリックしてください。

DBP3549W

LONG VARBINARYの列を含む表は処理できません。

要因：指定した表にはHiRDBのLONG VARBINARY属性の列（BLOB）が定義されているため，列の表示又は定義処理はできません。

対処：なし。

DBP3550W

指定された表（aa...aa）は既に存在します。既存の表を削除しますか？

aa...aa：表名

要因：表定義画面で指定した表名は，データベースに既に存在します。既に存在する表を削除し，同じ表名で表を作成してよいか確認してください。

対処：次の処置をしてください。

既存の表を削除し，同じ表名で表を作成する場合は，［はい］をクリックしてください。

別の表名に変更する場合は，［いいえ］をクリックしてください。

DBP3551W

データを抽出する表と同じ表名は指定できません。

要因：データを抽出する表として選択している表名を表定義画面に指定しました。

対処：表定義画面に指定する表名を変更してください。

DBP3552W

指定された表（aa...aa）と同じ表名が別の格納領域に存在します。

aa...aa：表名

要因：表定義画面で指定した表名と同じ表名の表が，別の格納領域に存在しています。

対処：次の処置をしてください。

表定義画面で指定する表名を変更してください。

既存の表を削除し，新たに同じ表名で表を作成する場合は，格納領域名を削除したい表の名称と合わせてください。

DBP3553W

LOB格納領域が指定されていません。

要因：LONG VARBINARYの列にLOB格納領域が指定されていません。

対処：LOB格納領域を指定して，再実行してください。

DBP3600E

指定された見出し辞書ファイルは使用できません。

要因：指定された見出し辞書ファイルの内容と，サーバ上の内容が一致しないため，見出し辞書ファイルは使用できません。

対処：見出し辞書ファイルを削除して，再実行してください。

DBP3601E

指定されたフォルダには，見出し辞書ファイルがありません。

要因：見出し辞書ファイルの読み込み先に指定されたフォルダに，見出し辞書ファイルはありません。

対処：見出し辞書ファイルを格納するフォルダを指定して，再実行してください。

DBP3602E

見出し辞書ファイルが一杯です。

要因：見出し情報は65536個以上作成できません。

対処：不要な見出し情報を削除し，再実行してください。

DBP3603I

編集した見出し情報は辞書登録されていません。破棄してもよろしいですか?

要因：編集した見出し情報は，見出し辞書に登録されていません。

対処：次の処置をしてください。

見出し辞書ファイルを破棄し，処理を続行する場合［はい］をクリックしてください。

見出し辞書ファイルを破棄しない場合［いいえ］をクリックしてください。

DBP3604I

表（aa...aa）の見出しは既に辞書ファイルに存在します。上書きしますか?

aa...aa：表名

要因：新規に作成した見出し辞書ファイルと同じ内容のファイルが既にあります。

対処：次の処置をしてください。

上書きする場合［はい］をクリックしてください。

上書きしない場合［いいえ］をクリックしてください。

DBP3605W

見出し辞書ファイルから削除しますか?

要因：指定された見出し辞書ファイルを削除します。

対処：次の処置をしてください。

削除する場合［はい］をクリックしてください。

削除しない場合［いいえ］をクリックしてください。

DBP3606E

DBP2DIC.DLLのロードに失敗しました。（nnn）

nnn：詳細コード

02：必要なDLLがありません。

08：DLLのロードに必要なメモリがありません。

要因：見出し辞書の処理に必要なDLLのロードに失敗しました。

対処：詳細コードによって次の対策を実施してください。

02：DBPARTNER2を正しくインストールして，再実行してください。

08：不要なアプリケーションを終了して再実行してください

DBP3607I

見出し辞書への登録が完了しました。

要因：見出し情報を見出し辞書に登録しました。

対処：なし。

DBP3608I

見出し辞書の一括登録が完了しました。

要因：見出し辞書の一括登録が完了しました。

対処：なし。

DBP3609E

指定された表は見出し辞書ファイル中にないため，列情報が取得できません。

要因：指定された表は，見出し辞書ファイル中に登録されていないため，列情報が取得できません。

対処：次の処置をしてください。

列設定又は条件設定しないで抽出又は更新用抽出を実行してください。

列設定又は条件設定する場合は，オプション設定で「見出し辞書を使用しない」に設定して，再実行してください。

DBP3610I

見出し辞書の一括登録を中止しました。

要因：［キャンセル］がクリックされた，又は登録処理中にエラーが発生したため，一括登録処理を中止しました。

対処：［キャンセル］をクリックして処理を中止した場合は，［キャンセル］クリックまでに処理した辞書は登録されます。辞書を削除したい場合は，［見出し選択］ダイアログボックスを使用してください。

DBP3611I

表（aa...aa）は既に辞書登録されています。上書きした場合は，現在の表見出し，列見出しを削除します。上書きしますか？

aa...aa：表名

要因：一括作成で選択した表aa...aaの見出し辞書が既にあります。

対処：次の処置をしてください。

辞書を上書きする場合は「はい」を選択してください。

辞書を上書きしない場合は「いいえ」を選択してください。

一括作成で選択したすべての表の上書きを許可する場合は「すべて上書き」を選択してください。

辞書の一括作成を中止する場合には「キャンセル」を選択してください。

DBP3612I

選択したnnn表について，グループ名をaa...aaに設定します。よろしいですか?

nnn：選択した表数

aa...aa：グループ名

要因：見出し選択画面で選択した表のグループ名を設定します。

対処：次の処置をしてください。

グループ名をaa...aaに設定する場合は［はい］をクリックしてください。

グループ名をaa...aaに設定しない場合は［いいえ］をクリックしてください。

DBP3613I

選択したnnn表のグループ名を削除します。よろしいですか?

nnn：選択した表数

要因：見出し選択画面で選択した表に設定しているグループ名を削除します。

対処：次の処置をしてください。

グループ名を削除する場合は［はい］をクリックしてください。

グループ名削除しない場合は［いいえ］をクリックしてください。

DBP3614W

見出し選択画面で表名と表見出しの両方を非表示に設定できません。

要因：辞書一覧表示項目の設定で表名と表見出しの両方を非表示には設定できません。

対処：表名か表見出しのどちらか一方は，表示に設定してください。

DBP3615W

辞書の接続先を指定した場合は，異なる接続先の辞書は作成できません。

要因：DBPART2.infで［DicFilter］セクションのHostNameを指定している場合には，HostNameと異なる接続先では，辞書の新規作成及び一括作成はできません。

対処：DBPART2.infで［DicFilter］セクションのHostNameに現在の接続先名を指定するか，削除してください。削除した場合は，すべての接続先で辞書の新規作成及び一括作成ができます。

DBP3701W

可変記号名の指定に誤りがあります。

要因：可変記号名の指定に誤りがあります。次の原因が考えられます。

可変記号名の長さが制限を超えています。

使用できない文字を使用しています。

対処：可変記号名を修正し，再度実行してください。

DBP3702W

初期値の指定に誤りがあります。

要因：初期値の指定に誤りがあります。次の原因が考えられます。

初期値の長さが制限を超えています。

使用できない文字を使用しています。

対処：初期値を修正し，再度実行してください。

DBP3703W

実行値の指定に誤りがあります。

要因：実行値の指定に誤りがあります。次の原因が考えられます。

実行値の長さが制限を超えています。

使用できない文字を使用しています。

実行値の省略はできません。

対処：実行値を修正し，再度実行してください。

DBP3704W

同一可変記号が存在します。

要因：既に使用している可変記号を指定しました。

対処：可変記号名を変更し，再実行してください。

DBP3706W

可変記号の総数が255個を超えました。

要因：可変記号の総数が制限の255個を超えました。

対処：可変記号を削除し，総数を255個以下にし，再度実行してください。

DBP3707E

指定されたファイル（aa...aa）は省略値のない可変値があるため実行できません。

aa...aa：ファイル名

要因：指定されたファイルに設定された可変値には省略値(初期値)がないため，実行できません。このエラーは，オプション設定時に手順実行時の実行値入力画面表示をチェックしていないと発生します。

対処：次の処置をしてください。

［可変記号入力］画面で可変記号の省略値(初期値)を設定して，再実行してください。

オプション設定の手順実行時の実行値入力画面表示をチェックして再実行してください。

DBP3708W

可変記号名が指定されていません。

要因：パラメタの可変記号名が指定されていません。

対処：可変記号名を指定してください。

DBP3904W

接続先が異なる表は結合できません。

要因：選択されている表の接続先と異なる接続先の表を結合しようとしました。

対処：同じ接続先の表を指定して再実行してください。

DBP5601W

DBPARTNER/Client 03-00より前のバージョンで作成した手順ファイル（aa...aa）は印刷できません。

aa...aa：ファイル名

要因：DBPARTNER/Client 03-00より前のバージョンで作成した手順ファイルは，印刷できるフォーマットではないため，印刷できません。

対処：印刷したい手順ファイルを一度DBPARTNER2で参照した後，登録すると印刷できます。

DBP5602W

プリンタのエラーが発生しました。再試行しますか?

要因：手順ファイルを印刷中に，エラーが発生しました。次の原因が考えられます。

プリンタの用紙がない。

プリンタが接続されていない。

対処：次の処置をしてください。

再試行する場合は，プリンタケーブルやネットワークの接続を確認し，用紙を補給してから，［はい］をクリックしてください。

中止する場合は，［いいえ］をクリックしてください。

DBP5603W

ファイル（aa...aa）は手順ファイルではないため印刷できません。

aa...aa：ファイル名称

要因：印刷する手順ファイルとして指定されたaa...aaに対する処理が続行できません。次の原因が考えられます。

手順ファイルではないファイルを指定した。

DBPARTNER2で生成した手順ファイルの内容がエディタなどで書き換えられている。

対処：指定したファイルの印刷はできません。手順のファイルの内容がエディタなどで書き換えられている場合は，手順ファイルを再登録，再実行してください。

DBP5604W

表示データが大きすぎます。すべてを表示できません。

要因：手順ファイルのデータが30000バイト（SQLの手順の場合は32000バイト）を超えているため，すべてを表示できませんでした。

対処：なし。

DBP5605W

手順ファイル（aa...aa）の印刷を中止しましたが，まだ印刷する手順ファイルが残っています。残りを印刷しますか?

aa...aa：ファイル名

要因：手順ファイルの印刷を中止しましたが，まだ印刷する手順ファイルが残っています。

対処：次の処置をしてください。

残りの手順ファイルを印刷する場合は，［はい］をクリックしてください。

残りの手順ファイルを印刷しない場合は，［いいえ］をクリックしてください。

DBP5703W

ファイル（aa...aa）は手順ファイルではないため変更できません。

aa...aa：ファイル名

要因：変更する手順ファイルとして指定されたaa...aaに対する処理が続行できません。次の原因が考えられます。

手順ファイルではないファイルを指定した。

DBPARTNER2で生成した手順ファイルの内容がエディタなどで書き換えられている。

対処：指定したファイルの変更はできません。手順ファイルの内容がエディタなどで書き換えられている場合は，手順ファイルを再登録，再実行してください。

DBP5704W

「"」（ダブルクォーテーション）の指定方法に誤りがあります。

要因：次の原因が考えられます。

文字列中の「“」（ダブルクォーテーション）が2個続けて指定されていません。

文字列を囲む「“」（ダブルクォーテーション）が対に指定されていません。

対処：「“」（ダブルクォーテーション）は文字列の最初と最後に一つずつ対に指定し，かつ文字列中に「“」（ダブルクォーテーション）を指定するときは，2個続けて一つの「“」（ダブルクォーテーション）として指定してください。

DBP5705W

表名が重複して指定されています。

要因：変更した表名が，既にあるため，指定できません。

対処：表名称，もしくは表所有者を修正し，再実行してください。

DBP5706W

手順ファイル中の列演算式の長さが制限を超えました。

要因：手順ファイル中の列演算式を変更しようとしましたが，合計長が30000バイトを超えたため，変更できませんでした。

対処：表所有者，表名を短くして，再実行してください。

DBP5707W

表所有者の指定が誤っています。

要因：表所有者の指定が誤っています。次の原因が考えられます。

表所有者の長さが32を超えています。

使用できない文字を指定しています。

対処：表所有者を修正し，再実行してください。

DBP5708W

表名の指定が誤っています。

要因：表名の指定が誤っています。次の原因が考えられます。

表名の長さが30バイトを超えています。

使用できない文字を使用しています。

対処：表名を修正し，再実行してください。

DBP5709W

表見出しの指定が誤っています。

要因：表見出しの指定が誤っています。次の原因が考えられます。

表見出しの長さが46バイトを超えています。

使用できない文字を使用しています。

対処：表見出しを修正し，再実行してください。

DBP6000W

更新に必要な情報を作成しますか？

要因：抽出したデータを編集してデータを更新するためには，更新に必要な情報を作成しておく必要があります。

対処：次の処置をしてください。

抽出結果を基に，データベースを更新する場合は，［はい］をクリックしてください。

データベースを更新する必要がない場合は，［いいえ］をクリックしてください。

DBP6001E

DBPARTNER2の稼動に必要なメモリがありません。他のアプリケーションを終了してください。

要因：DBPARTNER2の稼働に必要なメモリが不足しています。

対処：他のアプリケーションを終了して，再実行してください。

DBP6002E

DBPARTNER2を起動できません。

要因：DBPARTNER2の起動に失敗しました。

対処：DBPARTNER2を正しくインストールしてください。32ビット版のExcelを使用する場合は32ビット版のDBPARTNER2をインストールしてください。

DBP6003E

一度に複数のExcelからDBPARTNER2連携を行うことはできません。

要因：既にDBPARTNER2は他のExcelと連携しています。

対処：既にDBPARTNER2と連携しているExcelを使用して処理してください。又は，現在起動中のすべてのExcelを終了させてから，Excelを再起動させて連携を開始してください。

DBP6004E

DBPARTNER2がExcelとの連携に失敗しました。（nn....nn）

nn....nn：詳細コード

要因：DBPARTNER2が連携可能な状態になっていないため，ExcelとDBPARTNER2の連携に失敗しました。

0002：連携の初期化処理に失敗しました。

0003：連携中にシステムエラーが発生しました。

0004：DBPARTNER2がダイアログ表示中又は他のPPと連携中に抽出処理を開始しました。

0005：DBPARTNER2がダイアログ表示中又は他のPPと連携中に手順ファイルを実行しました。

0006：DBPARTNER2がダイアログ表示中又は，Excelにデータ表示後，表や列を変えたり，抽出処理を実行したりしました（設定を変更した時に表示されるDBP6015Wメッセージに［はい］を応答しました）。

対処：次の処置の後，処理を実行してください。

DBPARTNER2が表示しているダイアログをすべて閉じてください。

他のアプリケーションを閉じてください。

不要なExcelのシートを閉じてください。

DBP6005E

抽出データの表示ができません。（aa...aa）

aa...aa：Excelの詳細メッセージ

要因：詳細メッセージの要因によって，抽出データを表示するためのシートを開くことができませんでした。メモリ不足やTempフォルダの容量不足のおそれがあります。

対処：詳細メッセージに該当する要因がないか確認してください。

DBP6008E

列の削除や，入替が行われているため，更新処理が実行できません。

要因：次の操作が実行されているため，更新処理が実行できません。

列を削除した。

列の順序を変更した。

複写などによって，列が重複した。

列のメモ情報が変更/削除された。

対処：要因となった操作を元に戻すか，又は再度，抽出処理から実行してください。

DBP6009W

選択されているシートからは更新できません。更新は，シート（aa...aa）を選択して行ってください。

aa...aa：シート名

要因：選択されているシートは，抽出したシートと異なっています。このため，更新処理ができません。

対処：抽出を実行したシート（aa...aa）を選択してください。

DBP6010E

ExcelとDBPARTNER2の連携で使用するファイルへのアクセスに失敗しました。

要因：ExcelとDBPARTNER2の連携で使用するファイルからの読み込みや，書き込みができませんでした。

対処：次の処置をしてください。

Windowsフォルダの不要なファイルを削除してください。

他のアプリケーションプログラムを終了させてください。

DBP6011E

メニューから選択された手順ファイルは，削除されているか，壊れている可能性があります。

要因：メニューから選択された手順ファイルは，使用できません。以下の原因が考えられます。

選択された手順ファイルは削除されている。

選択した手順ファイルが他のフォルダに移動されている。

手順ファイルの内容が，すべて消されている。

対処：手順ファイルを移動した場合は，メニューの［手順ファイル利用］を選択し，利用したい手順ファイルをファイルオープンダイアログで確認後，選択してください。

DBP6013E

ExcelとDBPARTNER2の連携中に異常が発生しました。処理を終了します。（nn....nn）

nn....nn：詳細コード

要因：ExcelとDBPARTNER2の連携中に異常が発生しました。

0001：マクロが不正です。

0003：DBPARTNER2起動インタフェースが不正です。

0004：抽出インタフェースが不正です。

0005：更新インタフェースが不正です。

1007：Excelがインストールされていません。

1009：Excelでダイアログを表示中又は，セルやブック名の編集中です。

1012：Excel連携用のアドインプログラムが正しくアドインされていません。

1021：Excelでダイアログを表示中です。

1024：最後にインストールしたExcelは古いバージョンです。

1025：Excelが中間ファイルのOPENに失敗しました。

1026：Excelが中間ファイルの出力に失敗しました。

1027：Excelが中間ファイルのCLOSEに失敗しました。

1028：最後にインストールしたExcelは古いバージョンです。

10xx：Excel起動インタフェースが不正です。

対処：詳細コードを控えて，DBPARTNER2を終了させてください。詳細コードが10xxの場合，Excelが正しく使用でき，DBPARTNER2連携アドインが正常に使用できることを確認してください。64ビット版のDBPARTNER2からExcel連携する際は64ビット版のExcelを使用してください。

詳細コードが1025，1026，1027の場合は，メモリ不足やTempフォルダの容量不足のおそれがあります。

DBP6014E

更新に必要な情報が削除されています。更新処理は行えません。

要因：DBP6000Wメッセージで作成した，更新に必要な情報シートが削除されています。変更確認ができないため，更新処理が実行できません。

対処：再度，抽出処理から実行してください。

DBP6015W

シート（aa...aa）からの更新処理ができなくなります。処理を続行しますか？

aa...aa：シート名

要因：抽出処理を実行すると，シート（aa...aa）のデータでの更新処理はできなくなります。

対処：次の処置をしてください。

処理を続行する場合は，［はい］をクリックしてください。

処理を中止する場合は，［いいえ］をクリックしてください。

DBP6016E

行を識別するためのIDが変更されているため，更新処理が実行できません。

要因：次の操作が実行されているため，更新処理が実行できません。

DBPARTNER2が抽出したデータのA列のメモ情報に格納しているIDが，数字以外の文字に変更されている。

DBPARTNER2が抽出したデータのA列のメモ情報に格納しているIDが，抽出データ件数以上の数値になっている。

対処：再度，抽出処理から実行してください。

DBP6017W

更新するデータがありません。

要因：更新対象となっているシートのデータ領域に更新するデータがありません。又は抽出したデータの内容をまったく変更せずに更新要求が実行されました。

対処：更新対象となっているシートでデータを編集し，更新要求を再実行してください。

DBP6018E

16385行目以降にデータが指定されています。更新処理は行えません。

要因：16385行以降にデータが指定されています。

対処：16385行目以降に指定されているデータを取り除いて再実行してください。

DBP6019E

指定した位置にデータを貼り付けることができません。

要因：抽出したデータをシートに貼り付けることができませんでした。次の原因が考えられます。

抽出したデータがシートの行又は列範囲を超えた。

シートが保護されている。

対処：次の処置をしてください。

抽出したデータが張り付く範囲で位置を指定してください。

シートの保護を解除してください。

DBP6020E

同じ名称のシートが存在するため，シート名称を変更することができません。

要因：貼り付けオプションを使用してシート名称の変更を実行しましたが，指定したシート名称と同じシートがあるため，変更できませんでした。

対処：ブック内で一意になるシート名称を指定してください。

DBP6021E

データの貼り付けに失敗しました。（貼り付け位置：nnn）

nnn：データ貼り付け位置

要因：データの貼り付け位置の指定に誤りがあるため，データを貼り付けることができません。次の原因が考えられます。

A1参照形式に準じない文字列を指定しています。

範囲を示す文字列を指定しています。例："A1:D5"

対処：貼り付け位置の指定を見直してください。A1参照形式については，Excelのオンラインヘルプを参照してください。

DBP6022E

シート名称が正しくありません。

要因：シート名称として使用できない文字列が指定されています。

対処：シート名称を見直してください。シート名称の規則については，Excelのオンラインへルプを参照してください。

DBP6023W

手順ファイルの履歴を削除しますか？

要因：手順ファイルの履歴を削除します。削除してよいか確認してください。

対処：次の処置をしてください。

手順ファイルの履歴を削除する場合は，［はい］をクリックしてください。

手順ファイルの履歴を削除しない場合は，［いいえ］をクリックしてください。

DBP6024E

貼り付け位置の指定に誤りがあります。

要因：貼り付け位置を指定する文字にA1参照形式に準じない文字列を指定しています。

対処：貼り付け位置の指定を見直してください。A1参照形式については，Excelのオンラインヘルプを参照してください。

INS0101E

インストールで使用するメディア中のファイル（Setup.ini）が見つかりませんでした。メディアの内容を確認してください。インストールを中止します。

要因：インストールで使うメディア中のファイルに誤りがあるか，又はファイルがありません。

対処：正しいインストール用のメディアを使って，インストールを再実行してください。

INS0102W

ディレクトリaaaaを作成することができません。

要因：フォルダ（aaaa）を作成できません。

対処：フォルダと同名のファイルがあるおそれがあります。その場合，指定するフォルダを変更してください。その後も同じエラーが発生する場合は，保守担当者に連絡してください。

INS0104E

新しいDBPARTNER2 Client(64)がインストールされています。インストールを終了します。

要因：インストール先に，現在インストール中のDBPARTNER2 Client(64)よりも新しいバージョンのものがインストールされています。

対処：古いバージョンのDBPARTNER2 Client(64)はインストールできません。同じ，又は新しいバージョンのDBPARTNER2 Client(64)をインストールしてください。

INS0105W

指定されたディレクトリが正しくありません。

要因：フォルダ名の指定が間違っています。

対処：フォルダ名を正しく指定して，再実行してください。

INS0106W

ドライブaaに，DBPARTNER2 Client(64) nnnnをインストールするだけの容量がありません。インストールにはmmmmmバイトの容量を確保してください。

要因：aaで示すインストール先のドライブに，DBPARTNER2 Client(64)をインストールするための容量が不足しています。mmmmmバイト以上を確保してください。

nnnn：DBPARTNER2 Client(64)のバージョン番号

対処：インストール先ドライブの不要なファイルの削除などで，DBPARTNER2をインストールするために必要な容量を確保して，インストールを再実行してください。

INS0107W

ドライブの指定が誤っています。正しいドライブを指定してください。

要因：指定されたパスのドライブの指定に間違いがあります。

対処：存在するドライブ名を正しく英字で指定して，再実行してください。

INS0108E

Windows又はインストールプログラムに異常があります。インストールを終了します（nnnn）。

要因：Windowsのシステム又はインストールプログラムで異常が発生しました。

nnnn：保守コード

対処：DBPARTNER2 Clientを終了して，保守担当者に連絡してください。

INS0110W

ディレクトリの長さがnnnnバイトを超えています。

要因：フォルダ名の長さ（絶対パス名から¥ファイル名を除いたもの）が，nnnnバイトを超えています。

対処：フォルダ名の長さをnnnnバイト以内で指定し直してください。

INS0111E

本プログラムはnnnnでは動作しません。mmmmで実行してください。

要因：現在起動しているOS（nnnn）では動作しません。このプログラムはOS（mmmm）で動作します。

nnnn：動作できないOS

mmmm：動作できるOS

対処：このプログラムではmmmmのどれかのOSで起動して，実行してください。

INS0112E

このプログラムはVGAか，それ以上の解像度で実行してください。

要因：解像度がVGA以上でないため，インストールが実行できません。

対処：VGAか，それ以上の解像度に変更して，再実行してください。

INS0113I

いくつかのファイルを他のプログラムが使用しているため，インストールすることができませんでした。システムを再起動するとファイルを更新します。

要因：一部のファイルをほかのプログラムが使っているため，インストールできませんでした。

対処：インストールできなかったファイルを更新するためには，システムを再起動してください。

INS0114W

ActiveXコントロールの登録ができません。

要因：ActiveXコントロールの登録に失敗しました。

対処：インストールを再実行してください。

INS0116E

DBPARTNER2が起動されています。起動中のDBPARTNER2を終了してからインストールをしなおしてください。

要因：DBPARTNER2起動時にインストールしようとしました。

対処：起動中のDBPARTNER2を終了してからインストールをし直してください。

INS0117W

接続先定義ファイルの拡張子は「.DPL」でなければなりません。

要因：接続先定義ファイルの絶対パス名に，「.DPL」以外の拡張子が指定されています。

対処：絶対パス名の拡張子に「.DPL」を指定して，再実行してください。

INS0118W

ドライブのパス名の指定が誤っています。ドライブがある事を確認してパス名を指定してください。

要因：指定されたパスのドライブの指定に誤りがあります。

対処：存在するドライブを正しく英字で指定して，再実行してください。

INS0119W

更新機能又は定義機能をインストールする場合は，抽出機能も必ず選択してください。

要因：抽出機能を選択していない場合は，更新機能，又は定義機能を選択できません。

対処：更新機能，又は定義機能を選択する場合は，抽出機能を必ず選択してください。

INS0120E

既にDBPARTNER2 Client vvrrssがインストールされています。アンインストールしてからDBPARTNER2 Client(64) をインストールしてください。インストールを中止します。

要因：インストール先に，DBPARTNER2 Clientが既にインストールされています。vvrrss（バージョン情報）は，表示されないことがあります。

対処：DBPARTNER2 Clientをアンインストールしてから，DBPARTNER2 Client(64) をインストールしてください。また，DBPARTNER ODBC Driverを使用しない場合は削除してください。

INS0121E

再配布ファイルのインストール時，エラーが発生し，インストールに失敗しました。エラーコード=nnnn エラーコードは，GetLastError関数で取得しています。インストールを中止します。

nnnn：エラーコード

要因：再配布ファイルのインストール時に，エラーが発生しました。

対処：表示されたメッセージの内容を，エラーコードを含め，保守担当者に連絡してください。

INS0122W

DBPARTNER2 Client(64) 以外のプログラムが動作しているため，再配布ファイルの更新を完了できませんでした。更新を完了するには，コンピュータを再起動する必要があります。

要因：動作中である他プログラムの影響(例:再配布ファイルを使用中)により，再配布ファイルの更新を完了できませんでした。

対処：DBPARTNER2 Client(64)のインストール完了後に，コンピュータを再起動してください。

INS0123E

Administrators権限を持つユーザではありません。インストールは，Administrators権限を持つユーザで実行してください。

要因：Administrators権限を持たないユーザでインストールを実行しました。

対処：Administrators権限を持つユーザでインストールを実行してください。

INS0124W

指定された接続先定義ファイルが正しくありません。

要因：接続先定義ファイルの指定が間違っています。

次の原因が考えられます。

フォルダ名，ファイル名として使用できない文字を含んでいる。

ファイル名と同じ名前を持つフォルダが存在する。

フォルダ名と同じ名前を持つファイルが存在する。

対処：接続先定義ファイル名を正しく指定して，再実行してください。

INS0201E

DBPARTNER ODBC 3.0 DriverのDLLファイル（aaaa）は，現在使用中のためインストールすることができません。

aaaa：ファイル名

要因：aaaaで示すファイルが使用中のため，インストールできません。

対処：aaaaで示すファイルを使用しているプログラムを終了して，インストールを再実行してください。

INS0202E

ドライバに関する情報のレジストリ登録に失敗しました。

要因：ドライバに関する情報のレジストリ登録に失敗しました。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

11.3　DBPARTNER ODBC 3.0 Driverのメッセージ

DBPARTNER ODBC 3.0 Driverから出力されるメッセージの見方とその意味について説明します。

11.3.1　エラーメッセージに付くODBC関数のプリフィックス

エラーメッセージはSQLGetDiagField，又はSQLGetDiagRecによって診断メッセージとして取得できます。

[ ]内の値は，エラー元を識別できるように表示されます。

DBPARTNER ODBC 3.0 Driverが返すプリフィックスの一覧を次の表に示します。

表11‒1　DBPARTNER ODBC 3.0 Driverが返すプリフィックスの一覧

エラー発生元

プリフィックスに設定される値

[vender]

[ODBC-component]

[data-source]

DBPARTNER ODBC 3.0 Driver

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

−

DABroker

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

[DABroker]

DBS

XDM/RD E2

XDM/SD E2

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

[DBS]

HiRDB

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

[HiRDB]

ORACLE

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

[ORACLE]

不明

[HITACHI]

[DBPARTNER ODBC 3.0 Driver]

[SERVER_UNKNOWN]

（凡例）

−：プリフィックスは設定されません。

11.3.2　DBPARTNER ODBC 3.0 Driverのメッセージ一覧

DBPARTNER ODBC 3.0 Driverのメッセージを示します。

DPOD0001-E

DBPARTNER ODBC 3.0 Driverの実行中に異常が発生しました。（nnnn）

nnnn：内部矛盾コード

要因：DBPARTNER ODBC 3.0 Driverで異常が発生しました。

処理：関数の実行を中断します。

対処：システム管理者に連絡してください。

DPOD0002-E

動作環境が不正です。DBPARTNER ODBC 3.0 Driverをインストールし直してください。

要因：動作環境に関する情報の取得に失敗しました。

処理：関数の実行を中断します。

対処：DBPARTNER ODBC 3.0 Driverをインストールし直してください。

DPOD0003-E

ユーザ外字ファイルのアクセスでI/Oエラーが発生しました。[errno=nnnn]

nnnn：エラーコード

要因：ユーザ外字変換ファイルアクセス時にI/Oエラーが発生しました。

処理：関数の実行を中断します。

対処：次に示す内容を確認し，再実行してください。

ファイル名，パス名の設定を確認してください。

必要なディスク容量を確保してください。

アクセス権限を確認してください。

DPOD0004-E

ユーザ外字ファイルのnnn行目が不正です。

nnn：記述個所

要因：ユーザ外字変換ファイルの記述内容に誤りがあります。

処理：関数の実行を中断します。

対処：ユーザ外字変換ファイルの記述内容を見直してください。

DPOD0005-E

システムコールでエラーが発生しました。[aa...aa(),errno=nnnn]

aa...aa：エラー発生関数

nnnn：エラーコード

要因：システム関数でエラーが発生しました。

処理：関数の実行を中断します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合には，システム管理者に連絡してください。

DPOD0006-E

受信データ領域が不足しました。

要因：サーバとの通信での受信データ領域が不足しました。

処理：関数の実行を中断します。

対処：ODBCセットアップ，又は接続時に指定した受信バッファサイズを変更し，再実行してください。

DPOD0007-E

通信時のエラーです。

要因：サーバとの通信でエラーが発生しました。

処理：関数の実行を中断します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DPOD0008-E

指定されたサービス名，又はポート番号が不正です。[errno=nnnn]

nnnn：エラーコード

要因：指定されたサービス名，又はポート番号が不正です。

処理：関数の実行を中断します。

対処：サービス名，又はポート番号の指定を確認し，再実行してください。

DPOD0009-E

コネクション確立時，ソケットのオープンに失敗しました。[errno=nnnn]

nnnn：エラーコード

要因：サーバとのコネクション確立時，ソケットのオープンに失敗しました。

処理：関数の実行を中断します

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DPOD0010-E

コネクション確立時，TCPコネクション確立処理に失敗しました。[errno=nnnn]

nnnn：エラーコード

要因：サーバとのコネクション確立時，TCPコネクション確立処理に失敗しました。

処理：関数の実行を中断します。

対処：次に示す内容を確認し，再実行してください。

ホスト名，又はIPアドレスの指定を確認してください。

サービス名，又はポート名の指定を確認してください。

サーバが起動されているか，確認してください。

通信環境の設定を確認してください。

DPOD0011-E

コネクションが切断されました。[errno=nnnn]

nnnn：エラーコード

要因：サーバとのコネクションが切断されました。

処理：関数の実行を中断します。

対処：再接続してください。

DPOD0012-E

応答監視時間を超えました。[errno=nnnn]

nnnn：エラーコード

要因：指定されたサーバの応答監視時間を超えました。

処理：関数の実行を中断します。

対処：ODBCセットアップ，又は接続時に指定した応答監視時間を変更し，再実行してください。

DPOD0013-E

指定されたホスト名，又はIPアドレスが不正です。[errno=nnnn]

nnnn：エラーコード

要因：指定されたホスト名，又はIPアドレスが不正です。

処理：関数の実行を中断します。

対処：ホスト名，又はIPアドレスの指定を確認し，再実行してください。

DPOD0014-E

通信時に異常が発生しました。[errno=nnnn]

nnnn：エラーコード

要因：サーバとの通信時に異常が発生しました。

処理：関数の実行を中断します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DPOD0015-E

未サポートのデータ型が含まれています。

要因：サーバから取得したデータ中に未サポートのデータ型が含まれています。

処理：関数の実行を中断します。

対処：表の指定を確認し，再実行してください。

DPOD0016-E

接続に必要な情報が不足しています。

要因：接続時のユーザIDは省略できません。

処理：関数の実行を中断します。

対処：ユーザIDの指定を確認し，再実行してください。

DPOD0017-E

接続するサーバプログラムまたはそのバージョンが不正です。

要因：接続するサーバがDABroker，又はDatabase Connection Serverではない，又はDBPARTNER ODBC 3.0 Driverの前提バージョンではありません。

処理：関数の実行を中断します。

対処：接続するサーバとそのバージョンを確認してください。

DPOD0018-E

カーソル数の上限を超えました。

要因：サーバのカーソル数の上限を超えました。

処理：関数の実行を中断します。

対処：使用中のステートメントハンドル数を減らして再実行してください。

DPOD0019-E

ドライバでは本関数を実装していますが，当該データベースではサポートしていません。

要因：DBPARTNER ODBC 3.0 Driverではこの関数はサポートしていますが，該当するデータベースではサポートしていません。

処理：関数の実行を中断します。

対処：この関数はこのデータベースでは使用しないでください。

DPOD0031-E

送信データ領域が不足しました。

要因：サーバとの通信での送信データ領域が不足しました。

処理：関数の実行を中断します。

対処：ODBCセットアップ，又は接続時に指定した送信バッファサイズを変更し，再実行してください。

DPOD0034-E

エージェント機能は当該データベースではサポートしていません。(nnnn)

nnnn：内部エラーコード

要因：エージェント機能はそのデータベースではサポートしていません。

処理：関数の実行を中断します。

対処：エージェント機能はそのデータベースでは使用しないでください。

DPOD0035-E

パラメタ配列は当該サーバプログラムのバージョンまたはデータベースではサポートしていません。

要因：DBPARTNER ODBC 3.0 Driverではパラメタ配列をサポートしていますが，そのサーバプログラムのバージョン又はデータベースでは使用できません。

処理：関数の実行を中断します。

対処：パラメタ配列はそのサーバプログラムのバージョン又はデータベースでは使用しないでください。

付録

付録A　DBPARTNER2の予約語

DBPARTNER2の予約語の一覧を次の表に示します。

表A‒1　DBPARTNER2の予約語の一覧

先頭文字

予約語

A

AND，and，ASC，AVG

B

BETWEEN，BIGINT，BINARY，BIT

C

Cn（n=1〜2147483647），CHAR，CHARACTER，CNT，COUNT，CPT

D

DAT，DATE，DAY，DAYS，DBPstring（stringは任意の文字列）

DEC，DECIMAL，DESC，DIGITS，DOUBLE

F

FLOAT

G

GROUP，GRP

H

HEX

I

IN，INTEGER，INTERVAL，IS

L

LARGE，LENGTH，LIKE，LONG，LONG MVARCHAR，LONG　NVARCHAR，LONG VARBINARY，LONG VARCHAR

M

MAX，MCHAR，MIN，MINUTE，MONTH，MVARCHAR

N

NCHAR，NOT，not，NULL，NUMERIC，NVARCHAR

O

OR，or

P

POL

R

REAL

S

SECOND，SMALLFLT，SMALLINT，SQLstring（stringは任意の文字列）

SQL_string（stringは任意の文字列），SUBSTR，SUM

T

Tn（n=1〜2048），TCm（m=1〜2048），TIME，TIMESTAMP，TINYINT，TO，TXT

V

VALUE，VARBINARY，VARCHAR

W

WJ2

X

XLS

Y

YEAR

注

接続するデータベース側の予約語については，それぞれのデータベースの規則に従ってください。

付録B　ファイル出力するデータ形式のフォーマット

付録B.1　CSV形式・DAT形式

CSV形式とDAT形式は，データと制御記号で構成されます。CSV形式とDAT形式のフォーマットを次の図に示します。

図B‒1　CSV形式とDAT形式のフォーマット

（凡例）

(2C)16：,（コンマ）

(0D)16(0A)16：改行

(1A)16：EOF

注

データは文字データと，数値データに分かれています。

文字データは「”」（引用符）で囲み，数値データは囲みません。

CSV形式の場合，文字列中の「"」（引用符）は二重になります。

DAT形式の場合，文字列中の「"」（引用符）は「'」（シングルクォーテーション）に変換されます。

付録B.2　TEXT形式

TEXT形式は，データと制御記号で構成されます。TEXT形式のフォーマットを次の図に示します。

図B‒2　TEXT形式のフォーマット

（凡例）

(09)16：Tab又は→

(0D)16(0A)16：改行

注

データに，文字データと数値データの区別はありません。

英数字は文字データ，数字は数値データと解釈します。

付録B.3　Excel形式

一つのExcel形式のファイルに作成するシートは一つです。シートの属性は，Excelで新規にシートを作成する場合の標準的なテンプレートに従います。

Excel形式のファイルに転送できるのは次のようなデータです。

行：1048576行まで

列：256列まで

セル内のデータ：256バイトまで

付録C　データベースとDBPARTNER2で使える機能の関係

接続するデータベースによって，DBPARTNER2で使える機能に制限があります。データベースとDBPARTNER2で使える機能の関係を，データベースごとに，表に示します。

表C‒1　データベースとDBPARTNER2で使える機能（HiRDBの場合）

DBPARTNER2の機能

HiRDB

HiRDB ODBC 3.0 Diver

DBPARTNER ODBC 3.0 Driver

表選択

表選択

15表

15表

絞り込み

所有者名，表名

所有者名，表名

詳細表示

○

○

列設定

集合関数

最大，最小，平均，合計，件数

最大，最小，平均，合計，件数

ソート

昇順，降順

昇順，降順

仮想列

○

○

条件設定

インデクス表示

○

○

比較条件

=，<>，<，>，=<，=>

=，<>，<，>，=<，=>

IN条件

○

○

BETWEEN条件

○

○

NULL条件

○

○

LIKE条件

○

○

列比較条件

○

○

表結合条件

内結合，外結合

内結合，外結合

列演算条件

○

○

条件関連式

AND，OR，NOT

AND，OR，NOT

条件の直接入力

○

○

件数制限

○

○

件数確認

○

○

転送先

ファイル，PP連携，クリップボード

ファイル，PP連携，クリップボード，データベース

表定義

×

○

SQL入力

○

○

更新

更新種別

SINGLE，

BLOCK，

BLOCK2，

ROWID

SINGLE，

BLOCK，

BLOCK2，

ROWID

更新条件の解除

○

○

手順

登録，参照，実行

登録，参照，実行

見出し辞書

登録，編集

登録，編集

繰り返し列の操作

×

×

（凡例）

〇：機能を使えます。

×：機能を使えません。

表C‒2　データベースとDBPARTNER2で使える機能（HADBの場合）

DBPARTNER2の機能

HADB

表選択

表選択

15表

絞り込み

所有者名，表名

詳細表示

○

列設定

集合関数

最大，最小，平均，合計，件数

ソート

昇順，降順

仮想列

○

条件設定

インデクス表示

○

比較条件

=，<>，<，>，=<，=>

IN条件

○

BETWEEN条件

○

NULL条件

○

LIKE条件

○

列比較条件

○

表結合条件

内結合，外結合

列演算条件

○

条件関連式

AND，OR，NOT

条件の直接入力

○

件数制限

○

件数確認

○

転送先

ファイル，PP連携，クリップボード

表定義

×

SQL入力

○

更新

更新種別

SINGLE，

BLOCK，

BLOCK2

更新条件の解除

○

手順

登録，参照，実行

見出し辞書

登録，編集

（凡例）

〇：機能を使えます。

×：機能を使えません。

表C‒3　データベースとDBPARTNER2で使える機能（ORACLEの場合）

DBPARTNER2の機能

ORACLE

ORACLE ODBC Diver

DBPARTNER ODBC 3.0 Driver

表選択

表選択

15表

15表

絞り込み

所有者名，表名

所有者名，表名

詳細表示

○

○

列設定

集合関数

最大，最小，平均，合計，件数

最大，最小，平均，合計，件数

ソート

昇順，降順

昇順，降順

仮想列

○

○

条件設定

インデクス表示

○

○

比較条件

=，<>，<，>，=<，=>

=，<>，<，>，=<，=>

IN条件

○

○

BETWEEN条件

○

○

NULL条件

○

○

LIKE条件

○

○

列比較条件

○

○

表結合条件

内結合，外結合

内結合，外結合

列演算条件

○

○

条件関連式

AND，OR，NOT

AND，OR，NOT

条件の直接入力

○

○

件数制限

○

○

件数確認

○

○

転送先

ファイル，PP連携，クリップボード

ファイル，PP連携，クリップボード，データベース

表定義

×

○

SQL入力

○

○

更新

更新種別

SINGLE，

BLOCK，

BLOCK2，

ROWID

SINGLE，

BLOCK，

BLOCK2，

ROWID

更新条件の解除

○

○

手順

登録，参照，実行

登録，参照，実行

見出し辞書

登録，編集

登録，編集

繰り返し列の操作

×

×

（凡例）

〇：機能を使えます。

×：機能を使えません。

表C‒4　データベースとDBPARTNER2で使える機能（VOS3 XDM/RD E2の場合）

DBPARTNER2の機能

VOS3 XDM/RD E2

表選択

表選択

15表

絞り込み

所有者名，表名

詳細表示

○

列設定

集合関数

最大，最小，平均，合計，件数

ソート

昇順，降順

仮想列

○

条件設定

インデクス表示

○

比較条件

=，<>，<，>，=<，=>

IN条件

○

BETWEEN条件

○

NULL条件

○

LIKE条件

○

列比較条件

○

表結合条件

内結合，外結合

列演算条件

○

条件関連式

AND，OR，NOT

条件の直接入力

○

件数制限

○

件数確認

○

転送先

ファイル，PP連携，クリップボード

表定義

×

SQL入力

○

更新

更新種別

SINGLE，

BLOCK，

BLOCK2，

ROWID

更新条件の解除

○

手順

登録，参照，実行

見出し辞書

登録，編集

（凡例）

〇：機能を使えます。

×：機能を使えません。

表C‒5　データベースとDBPARTNER2で使える機能（VOS3 XDM/SD E2の場合）

DBPARTNER2の機能

VOS3 XDM/SD E2

表選択

表選択

1表

絞り込み

所有者名，表名

詳細表示

○

列設定

集合関数

×

ソート

×

仮想列

×

条件設定

インデクス表示

○

比較条件

=，<，>，=<，=>

IN条件

×

BETWEEN条件

×

NULL条件

×

LIKE条件

×

列比較条件

○

表結合条件

×

列演算条件

×

条件関連式

AND，OR

条件の直接入力

×

件数制限

○

件数確認

×

転送先

ファイル，PP連携，クリップボード

表定義

×

SQL入力

○

更新

更新種別

SINGLE，

BLOCK，

BLOCK2

更新条件の解除

○

手順

登録，参照，実行

見出し辞書

登録，編集

（凡例）

〇：機能を使えます。

×：機能を使えません。

付録D　DBPARTNER2の列属性

抽出条件などを設定する画面で列を選択すると，その列の属性と長さ（定義長）が表示されます。DBPARTNER2で表示する定義長は，1〜32767バイトです。これを超える列の場合，正しい長さが表示されないので注意してください。また，アプリケーションにも正しい列の長さが返らないので注意してください。

DBPARTNER2の列属性とデータベースのデータ型の対応，及びその値の範囲などを，接続形態とデータベースごとに示します。

付録D.1　ODBC接続の場合の列属性

DBPARTNER2の［条件設定］ダイアログボックスで，列を選択すると，その列の属性が表示されます。表示される列の属性の長さ及び列属性と，ODBCのデータ型との対応を次の表に示します。

表D‒1　列の属性と長さ及びデータ型との対応（ODBC接続の場合）

DBPARTNER2で扱う内容

ODBCの標準データ型

属性

長さ

CHAR

バイト数

SQL_CHAR

VARCHAR

SQL_VARCHAR

DECIMAL

（m.n）※

SQL_DECIMAL

NUMERIC

SQL_NUMERIC

SMALLINT

バイト数

SQL_SMALLINT

INTEGER

SQL_INTEGER

REAL

SQL_REAL

SMALLFLT

SQL_REAL

FLOAT

SQL_FLOAT

DOUBLE

SQL_DOUBLE

LONG VARCHAR

SQL_LONGVARCHAR

BIT

SQL_BIT

TINYINT

SQL_TINYINT

BIGINT

SQL_BIGINT

BINARY

SQL_BINARY

VARBINARY

SQL_VARBINARY

LONG VARBINARY

SQL_LONGVARBINARY

DATE

SQL_DATE

TIME

SQL_TIME

TIMESTAMP

けた数

SQL_TIMESTAMP

NCHAR

バイト数

ODBCには該当する標準のデータ型はありませんが，DBPARTNER2でサポートしています。

NVARCHAR

LONG NVARCHAR

MCHAR

MVARCHAR

LONG MVARCHAR

注※

mはけた数，nは小数点以下のけた数を表します。

(1)　HiRDBの場合

列の属性とHiRDBのデータ型との対応を次の表に示します。

表D‒2　列属性に対応するデータ型（HiRDB）

項番

DBPARTNER2での属性

HiRDB ODBC 3.0 Diver

DBPARTNER ODBC 3.0 Driver

HiRDBの属性

抽出

条件

更新※

HiRDBの属性

抽出

条件

更新※

定義

1

INTEGER

INTEGER

○

○

○

INTEGER

○

○

○

○

2

SMALLINT

SMALINT

○

○

○

SMALINT

○

○

○

○

3

DECIMAL

DECIMAL

○

○

○

DECIMAL

○

○

○

○

4

CHARACTER

CHARACTER

NCHAR

MCHAR

○

○

○

CHARACTER

○

○

○

○

5

NCHAR

−

−

−

−

NCHAR

○

○

○

○

6

MCHAR

−

−

−

−

MCHAR

○

○

○

○

7

VARCHAR

VARCHAR

○

○

○

VARCHAR

○

○

○

○

NVARCHAR

○

○

○

○

○

○

○

MVARCHAR

○

○

○

○

○

○

○

8

NVARCHAR

−

−

−

−

NVARCHAR

○

○

○

○

9

MVARCHAR

−

−

−

−

MVARCHAR

○

○

○

○

10

SMALLFLT

REAL

○

○

○

REAL

○

○

○

○

11

FLOAT

DOUBLE PRECISION

○

○

○

DOUBLE PRECISION

○

○

○

○

12

DATE

DATE

○

○

○

DATE

○

○

○

○

13

TIME

TIME

○

○

○

TIME

○

○

○

○

14

TIMESTAMP

TIMESTAMP

○

○

○

TIMESTAMP

○

○

○

○

15

LONG VARBINARY

BLOB

BINARY

○

×

○

BLOB

○

×

○

○

BINARY

×

×

×

×

16

−

INTERVAL YEAR TO DAY

×

×

×

INTERVAL YEAR TO DAY

×

×

×

×

17

−

INTERVAL HOUR TO SECOND

×

×

×

INTERVAL HOUR TO SECOND

×

×

×

×

（凡例）

−：該当する属性はありません。

○：機能を使えます。

×：機能を使えません。

注※

更新不可の場合は該当属性が含まれるだけで表全体の更新ができません。

(2)　HADBの場合

列の属性とHADBのデータ型との対応を次の表に示します。

表D‒3　列属性に対応するデータ型（HADB）

項番

DBPARTNER2での属性

HiRDBの属性

抽出

条件

更新※

1

BIGINT

INTEGER

○

○

○

2

INTEGER

SMALLINT

○

○

○

3

DECIMAL

DECIMAL

○

○

○

4

CHARACTER

CHARACTER

○

○

○

5

VARCHAR

VARCHAR

○

○

○

6

DOUBLE

DOUBLE PRECISION

○

○

○

7

DATE

DATE

○

○

○

8

TIME

TIME

○

○

○

9

TIMESTAMP

TIMESTAMP

○

○

○

10

BINARY

BINARY

○

○

○

11

VARBINARY

VARBINARY

○

×

×

（凡例）

〇：機能を使えます。

×：機能を使えません。

注※

更新不可の場合は該当属性が含まれるだけで表全体の更新ができません。

(3)　ORACLEの場合

列の属性とORACLEのデータ型との対応を次の表に示します。

表D‒4　列属性に対応するデータ型（ORACLE）

項番

DBPARTNER2での属性

ORACLE ODBC Driver

DBPARTNER ODBC 3.0 Driver

ORACLEの属性

抽出

条件

更新※1

ORACLEの属性

抽出

条件

更新※1

定義

1

CHAR

CHAR

NCHAR

○

○

○

CHAR

○

○

○

○

NCHAR

○

○

○

×※2

2

VARCHAR

VARCHAR2

NVARCHAR2

○

○

○

VARCHAR2

○

○

○

○

NVARCHAR2

○

○

○

×※2

3

DECIMAL

NUMBER

○

○

○

−

−

−

−

−

4

NUMERIC

−

−

−

−

NUMBER

○

○

○

○

5

REAL

BINARY_FLOAT

○

○

○

BINARY_FLOAT

×

×

×

×

6

DOUBLE

BINARY_DOUBULE

○

○

○

BINARY_DOUBULE

×

×

×

×

7

FLOAT

FLOAT

○

○

○

FLOAT

○

○

○

○

8

TIMESTAMP

DATE

TIMESTAMP

○

○

○

DATE

○

○

○

○

TIMESTAMP

×

×

×

×

9

LONG VARCHAR

LONG

CLOB

○

×

×

LONG

○

×

×

○

NCLOB

×

×

×

CLOB

NCLOB

×

×

×

×

10

VARBINARY

RAW

○

×

×

RAW

○

×

×

○

11

LONG VARBINARY

LONG RAW

BLOB

○

×

○

LONG RAW

○

×

○

○

BFILE

×

×

×

BLOB

BFILE

×

×

×

×

12

−

INTERVAL YEAR TO MONTH

×

×

×

INTERVAL YEAR TO MONTH

×

×

×

×

13

−

INTERVAL DAY TO SECOND

×

×

×

INTERVAL DAY TO SECOND

×

×

×

×

（凡例）

−：該当する属性はありません。

〇：機能を使えます。

×：機能を使えません。

注※1

更新不可の場合は該当属性が含まれるだけで表全体の更新ができません。

注※2

データベースに保存した場合は，それぞれCHAR，VARCHARで保存します。

(4)　VOS3 XDM/RD E2の場合

列の属性と，VOS3 XDM/RD E2のデータ型の対応を次の表に示します。

表D‒5　列属性に対応するデータ型（VOS3 XDM/RD E2）

項番

DBPARTNER2での属性

VOS3 XDM/RD E2の属性

抽出

条件

更新※

1

CHAR

CHAR

○

○

○

2

VARCHAR

VARCHAR

○

○

○

3

LONG VARCHAR

LONG VARCHAR

○

×

×

4

NCHAR

NCHAR

○

○

○

5

NVARCHAR

NVARCHAR

○

○

○

6

LONG NVARCHAR

LONG NVARCHAR

○

×

×

7

MCHAR

MCHAR

○

○

○

8

MVARCHAR

MVARCHAR

○

○

○

9

LONG MVARCHAR

LONG MVARCHAR

○

×

×

10

SMALLINT

SMALLINT

○

○

○

11

INTEGER

INTEGER

○

○

○

12

DECIMAL

DECIMAL

○

○

○

13

REAL

SMALLFLT

REAL

○

○

○

14

FLOAT

FLOAT

DOUBLE PRECISION

○

○

○

15

DATE

DATE

○

○

○

16

DECIMAL

LARGE DECIMAL

○

○

○

17

LONG VARBINARY

BLOB

×

×

×

18

LONG VARCHAR

CLOB

×

×

×

19

TIME

TIME

○

○

○

20

TIMESTAMP

TIMESTAMP

×

×

×

21

BIT

BOOLEAN

×

×

×

22

−

INTERVAL YEAR TODAY

×

×

×

23

−

INTERVAL HOUR TOSECOND

×

×

×

24

−

INTERVAL YEAR TOSECOND

×

×

×

（凡例）

−：該当する属性はありません。

〇：機能を使えます。

×：機能を使えません。

注※

更新不可の場合は該当属性が含まれるだけで表全体の更新ができません。

(5)　VOS3 XDM/SD E2の場合

列の属性と，VOS3 XDM/SD E2のデータ型の対応を次の表に示します。

表D‒6　列属性に対応するデータ型（VOS3 XDM/SD E2）

項番

DBPARTNER2での属性

VOS3 XDM/SD E2の属性

抽出

条件

更新※

1

CHAR

CHAR

○

○

○

2

NCHAR

NCHAR

○

○

○

3

INTEGER

COMP

○

○

○

4

SMALLINT

○

○

○

5

DECIMAL

PACKED DECIMAL FIXED

UNPACKED DECIMAL FIXED

PACKED DECIMAL FIXED WITH NO SIGN

UNPACKED DECIMAL FIXED WITH NO SIGN

○

○

○

6

BINARY

BIT

○

○

○

（凡例）

〇：機能を使えます。

注※

更新不可の場合は該当属性が含まれるだけで表全体の更新ができません。

付録E　見出し変更ツール

見出し変更ツールとは，TEXT形式で記述されている表見出しや列見出し（以下，「見出しテキスト」とします）を見出し辞書に反映するツールです。

見出し変更ツールを使うと，見出しテキストに記述されている表見出しや列見出しを自動的に見出し辞書に反映できるため，表定義の変更に伴う見出し辞書の再登録を簡単にできます。

付録E.1　見出し変更ツールの操作手順

見出し変更ツールは，Windowsの［スタート］メニューから起動します。

(1)　［辞書フォルダ］ダイアログボックス

ファイルの場所

見出し辞書を格納しているドライブを選択します。

フォルダツリー

［ファイルの場所］で選択したドライブにあるフォルダをツリー形式で表示します。フォルダを選択し［Enter］キー，又はダブルクリックすると［フォルダ名］に選択したフォルダのパスを表示します。

フォルダ名ラベル

フォルダツリーで選択したフォルダのパスを表示します。前回の操作で指定してある場合は，前回のパスが表示されます。

［見出し辞書変更(U)］

［OK］をクリックしたときに［見出し辞書変更］ダイアログボックスが表示されます。

［見出しテキスト作成(C)］

［OK］をクリックしたときに，［見出しテキスト作成］ダイアログボックスを表示します。

［OK］ボタン

［見出し辞書変更(U)］，［見出しテキスト作成(C)］のどちらかのダイアログボックスを表示します。

［終了(X)］ボタン

見出し変更ツールを終了します。

(2)　［見出しテキスト作成］ダイアログボックス，［見出し辞書変更］ダイアログボックス

［辞書一覧］グリッド

登録されている見出し辞書を表示します。見出しテキストを出力する見出し辞書の選択は，目的の見出し辞書を表示している行をクリック，又は［スペース］キーで選択します。一度に複数の行を選択できます。

カーソル

グリッド内でカーソルがある位置を示します。カーソルがある行はセルが赤くなります。

接続先名

所有者

表名

表見出し

情報ファイル有無

見出し辞書に対応した見出しテキストが作成されているかどうかを，○/×で表示します。見出しテキストが作成されている場合は○，作成されていない場合は×を示します。

セル内容テキスト

グリッド内でクリックしたセルの文字列を表示します。クリックするセルによって，表示内容が異なります。

カーソル位置を示すセルをクリックした場合

カーソル位置を示すセル以外をクリックした場合

［行番号］

分母には見出し辞書の総数を表示します。分子にはカーソルのある行番号を表示します。

［実行(E)］ボタン

［見出しテキスト作成］ダイアログボックスでは，［辞書一覧］グリッドで選択した見出し辞書の，見出しテキストを出力します。出力が完了すると，［処理確認］ダイアログボックスを表示します。

［見出し辞書変更］ダイアログボックスでは，［辞書一覧］グリッドで選択した見出し辞書の見出しを変更します。出力が完了すると，［処理確認］ダイアログボックスを表示します。

［閉じる(C)］ボタン

［見出しテキスト作成］ダイアログボックス，又は［見出し辞書変更］ダイアログボックスを閉じます。

(3)　［結果確認］ダイアログボックス

(a)　見出しテキスト作成の場合

出力先

出力先には，見出しテキストを出力したバスが表示されます。

結果リスト

見出しテキストを出力したファイル名を表示します。

記号：ファイル名

記号には○又は×を表示します。

○：正常に見出しテキストを出力しました。

×：見出しテキストの作成に失敗しました。

(b)　見出し辞書変更の場合

結果リスト

辞書名称：変更した見出し辞書のファイル名を表示します。

接続先：見出し辞書の接続先を表示します。

表名：見出し辞書の表名を表示します。

結果：変更した結果を表示します。結果を表示するフォーマットを次に示します。

記号：表名＞見出し

記号：列名＞列見出し

　　　　　　：

記号には，○／×／△を表示します。

○：正常に見出しを置き換えました。

×：見出し辞書に存在しない列がありました。

△：見出しテキストの中に同じ列名がありました。

付録E.2　見出しテキストの作成

見出しテキストは，見出し辞書に登録してある表見出しや列見出しから作成できます。見出し変更ツールで見出しテキストを作成する方法を次に示します。

［見出し変更ツール］を起動します。

［辞書フォルダ］ダイアログボックスが表示されます。

見出し辞書を格納しているフォルダを選択して，［見出しテキスト作成］にチェックして［OK］ボタンをクリックします。

［見出しテキスト作成］ダイアログボックスが表示されます。

見出し辞書一覧の中から見出しテキストを作成する辞書を選択して，［実行］ボタンをクリックします。

見出しテキストが作成され，［結果確認］ダイアログボックスが表示されます。

［OK］ボタンをクリックします。

これで見出しテキストが作成されました。

注意

接続先，所有者，表名が次に示す文字列を含むとき，見出しテキストは作成できません。

¥ / : , ; ? " < > |

見出しテキストを作成する場合，ファイル名がパスを含めて257バイト以上となるときは，見出しテキストを作成できません。

見出しテキストの詳細

見出しテキストは「接続先_所有者名_表名.txt」という名称で，「見出し変更ツールをインストールしたディレクトリ¥Infotext」下に格納されます。

DBP2DICUTL 01-00

見出しテキストを識別するためのもので，固定です。

CON = "xxx"

xxxは，見出し辞書に登録されている接続先名称です。目的の辞書を決めるために使います。

TBL = "xxx"."yyy","zzz"

見出し辞書に登録されている所有者（xxx），表名（yyy），表見出し（zzz）を示します。所有者と表名は，目的の見出し辞書を決める条件に使います。見出し辞書を変更すると，見出し辞書の表見出しが，表見出し（zzz）に置き換わります。

CLM = "xxx","yyy"

見出し辞書に登録されている列名（xxx），列見出し（yyy）を示します。列名は，列見出しを置き換える条件に使います。見出し辞書の変更を実行すると，見出し辞書の列見出しが，列見出し（yyy）に置き換わります。

規則

接続先，所有者，表名，表見出し，列名，列見出しは"（ダブルクォーテーション）で囲みます。

文字列中に"（ダブルクォーテーション）を使う場合は"（ダブルクォーテーション）を二つ続けて記述します。

CLMオペランドの並びは順不同です。

見出しテキストで指定した列名が見出し辞書にない場合は，列見出しは更新されません。

表見出しは30バイト以下の文字列を指定し，列見出しは46バイト以下の文字列を指定してください。

見出しテキストをユーザが作成する場合は，パスを含めて256バイト以内のファイル名を付けてください。

表見出し，又は列見出しとしてタブや改行は使えません。表見出し，列見出しに使える文字の範囲を次に示します。

上記の範囲外の文字を記述すると，見出しが正しく表示されません。

付録E.3　見出し辞書の変更

見出し辞書の内容を変更した場合，見出しテキストも変更する必要があります。見出し辞書を変更する作業を次に示します。

見出し変更ツールを起動します。

［格納辞書フォルダ］が表示されます。

見出し変更する辞書を選択して，［見出し辞書変更］チェックボタンにチェックし，［OK］ボタンをクリックします。

［見出し辞書変更］ダイアログボックスが表示されます。

変更する辞書フォルダを選択して，［実行］ボタンをクリックします。

見出し辞書が変更され，［処理結果］ダイアログボックスが表示されます。

［OK］ボタンをクリックします。

これで見出し辞書の変更が完了しました。

付録F　JP1連携機能

JP1連携機能を使うと，次のことができます。

データベースからのデータ検索の自動化

データベースの検索を，手順ファイルを利用し，JP1を使って自動化できます。

付録F.1　動作概要

JP1連携機能は次の順序で動作します。

DBPARTNER2 Clientを起動後，手順ファイルを実行します。

DBUidとDBPwdの値でデータベースにログインします。

メッセージボックスが表示されると，その内容をJP1LINK.LOGに出力して処理を続行します。

メールPPに，MailUidとMailPwdで自動的にログインします。

ログインに失敗すると，キャンセルを自動的に選択します。

DBPARTNER2 Clientを終了します。

戻り値は，メッセージボックスを表示しなかった場合は0，それ以外は1になります。

付録F.2　環境設定

JP1連携機能を使う場合は，次の手順で環境を設定します。

メール連携を使う場合は，DBPARTNER2 Clientのインストールフォルダ下に次の内容をJP1LINK.INFとして作成します。

[DPEXEC]
DBUid=xxx
DBPwd=xxx
MailUid=xxx
MailPwd=xxx

DBUid

［接続先設定］ダイアログボックスの［ユーザID］に自動設定するユーザID。接続先定義ファイルにユーザIDが設定されている場合は無視されます。

DBPwd

［接続先設定］ダイアログボックスの［パスワード］に自動設定するユーザID。接続先定義ファイルにパスワードが設定されている場合は無視されます。

MailUid

［メールログイン］ダイアログボックスに自動設定するユーザID，［プロファイル選択］ダイアログボックスに自動設定するプロファイル名，又は［ユーザID選択］ダイアログボックスに自動設定するユーザIDファイル名。

MailPwd

［メールログイン］ダイアログボックス，又は［ユーザID選択］ダイアログボックスに自動設定するパスワード。

自動化したい手順ファイルを作成します。

JP1/Automatic Job Schedulerで，DBPART2.EXEを登録します。［ジョブの設定］ダイアログボックスで次のように設定します。

［コマンド］エディットボックス：DBPART2.EXE

［パラメータ］エディットボックス：手順ファイル名

注意

DBPART2.EXEと手順ファイル名は絶対パスで指定してください。その際，スペースを含むフォルダ名やファイル名は使用しないでください。

付録F.3　注意事項

手順ファイル実行中に，次に示す画面が表示される場合，処理が停止します。実行させたい手順ファイルは，事前にDBPARTNER2 Clientで実行させて，次に示す画面が出ないことを確認してから使用してください。

［実行値一覧］ダイアログボックス

［表定義］ダイアログボックス

［データ表示］ウィンドウ

メッセージボックス

JP1LINK.INFは正確に記述してください。また，このファイルにはパスワードを記述するため，セキュリティ上問題が発生する場合は使用しないでください。

付録F.4　Netexecコマンドの利用

Windows環境下（サービス）で動作しない場合でも，JP1/ScriptのNetexecコマンドを利用すると動作する場合があります。操作手順を次に示します。

ODBCセットアップの変更

Windowsのサービスで動作させるためには，ODBCセットアップでシステムDSNに従来のユーザDSNで設定した内容を追加します。

JP1/Scriptの作成

JP1/Scriptのマネージャの「ファイル」で新規作成を選択します。

「ツール」の「エディタの関連付け」で編集に使用するエディタ（Notepad.exeなど）を指定します。

「ツール」の「簡易入力の起動」で簡易入力ダイアログボックスを表示します。

一覧からNetexecを選択し，「表示」ボタンで引数入力画面を表示させ，次の引数を設定します。

［コンピュータ名］：実行するコンピュータ名

［実行ファイル名］：DBPART2.EXE

［終了待ちフラグ］：True ［終了待ちをする］

［実行空間］：True ［サービス空間で実行］

［パラメタ1］：手順ファイル名

注意

スプールファイルのデータをダウンロードする場合は，「-JP1 ジョブ情報ファイル名 手順ファイル名」を指定してください（操作方法の（6）参照）。

設定完了後，「クリップボード」ボタンで内容をクリップボードにコピーします。

エディタに戻り，クリップボードから2.で設定したスクリプトを貼り付け，保存します。

JP1/AJSの登録

JP1/Automatic Job Schedulerの［ジョブの設定］の［コマンド］に，2.で保存したスクリプト（XXXXXX.spt）を指定します。

付録G　見出し辞書の編集

データベース内の表や列に，データベースの定義中の表名や列名に依存しない使い慣れた任意の名称を使うときには，見出し辞書に名称を登録します。通常，表や列を［DBPARTNER2］ウィンドウなどに表示するときにはサーバにアクセスしていますが，見出し辞書を使うときは見出し辞書にアクセスします。見出し辞書を使うとサーバにアクセスしないため，サーバにアクセスしている間の待ち時間がありません。

ここでは，見出し辞書の編集方法について説明します。見出し辞書を作成した後には，オプションを設定してください。見出し辞書に関するオプションを設定する方法については，「7.1.5　見出し辞書の指定」を参照してください。

付録G.1　見出し辞書の設定方法

見出しは，一つの表に対して一つ作成します。1表ごとに，データベースの定義中の表名や列名に対応する表見出し，列見出しを設定します。設定した内容は，接続先名，所有者名などの情報と合わせて見出し辞書に登録されます。見出し辞書に登録される情報を見出し情報といいます。

見出し辞書の編集では，次のことができます。

見出し情報の作成

新規にデータベースの表に見出し情報を作成します。

見出し辞書の編集

見出し辞書に登録されている見出し情報の表見出し又は列見出しを変更します。

格納先を指定して見出し情報を格納する

見出し情報を別のドライブ又はフォルダに格納します。

別のドライブ又はフォルダの見出し情報を読み込む

別のドライブ又はフォルダにある見出し情報を読み込みます。

見出し情報の削除

不要な見出し情報を削除します。

見出し情報の一括作成

複数の表の見出し情報を見出し辞書に一括登録できます。

見出し辞書の編集で使う［見出し編集］ダイアログボックス，［見出し選択］ダイアログボックス，［格納先の指定］ダイアログボックス，［読み込み先の指定］ダイアログボックスを次に示します。

(1)　［見出し編集］ダイアログボックス

見出し辞書を編集します。

タイトルバー

「見出し編集」と表示されます。

［接続先名］

選択した表が格納されているサーバに対応する接続先が表示されます。

［所有者名］

データベースにアクセスしているユーザ名が表示されます。

［表名］

データベースに定義されている表名が表示されます。

［表見出し］入力領域

表名に対応する表見出しを指定します。

［グループ名］入力領域

表に設定するグループを選択，又は入力します。

列名

表の列が一覧で表示されます。

列見出し入力領域

列名に対応する列見出しを指定します。

［見出し一覧(L)...］ボタン

［見出し選択］ダイアログボックスを表示します。

［新規作成(N)...］ボタン

［表選択］ダイアログボックスを表示します。

［一括作成(M)...］ボタン

複数の表の見出し情報を一括して見出し辞書に登録できます。

［読み込み(R)...］ボタン

［読み込み先の指定］ダイアログボックスを表示します。

［登録(G)］ボタン

作成した見出し情報を見出し辞書に登録します。

補足

DBPARTNER2が動作するフォルダ下にある見出し辞書に登録されます。この見出し辞書ではなく別のドライブ又はフォルダに格納することもできます。この場合，［見出し選択］ダイアログボックスの［格納(U)］ボタンをクリックして，格納するドライブ又はフォルダを指定します。

［削除(D)］ボタン

表示している見出し情報を削除します。

［終了(X)］ボタン

見出し編集を終了して［DBPARTNER2］ウィンドウに戻ります。

(2)　［見出し選択］ダイアログボックス

見出し辞書に登録されている見出し情報を表示します。

タイトルバー

「見出し選択」と表示されます。

［登録表一覧(T)］リストボックス

見出し辞書に登録している表を一覧表示します。表示する項目は，［辞書一覧表示方法の設定］ダイアログボックスで設定します。項目をクリックすると，その項目について表がソートされます。

［表示設定(I)］ボタン

［辞書一覧表示方法の設定］ダイアログボックスが表示されます。

設定方法，表示項目については，「付録G.1(3)　［辞書一覧表示方法の設定］ダイアログボックス」を参照してください。

［グループ名(G):］コンボボックス

表に設定するグループを選択，又は入力します。

［設定(S)］ボタン

［登録表一覧］で設定した表に，グループを設定します。

［編集(E)］ボタン

［見出し編集］ダイアログボックスを表示します。

［格納(U)...］ボタン

［格納先の指定］ダイアログボックスを表示します。

［削除(D)］ボタン

選択されている見出し情報を削除します。

［閉じる］ボタン

［見出し選択］ダイアログボックスを閉じます。

(3)　［辞書一覧表示方法の設定］ダイアログボックス

［見出し選択］ダイアログボックスに表示される表の表示方法を設定します。

［表示項目(I):］リストボックス

［見出し選択］に表示できる項目と各項目の表示の有無を表示します。

「表名」，又は「表見出し」のどちらかは必ず「表示」を設定してください。どちらも「非表示」を設定した場合はエラーとなります。

［表示(A)］ボタン

［表示項目］で選択した項目を"表示"にします。

［非表示(D)］ボタン

［表示項目］で選択した項目を"非表示"にします。

［OK］ボタン

設定した表示項目を有効にし，ダイアログボックスを閉じます。

［キャンセル］ボタン

設定した表示項目を無効にし，ダイアログボックスを閉じます。

(4)　［格納先の指定］ダイアログボックス，［読み込み先の指定］ダイアログボックス

見出し情報を格納する先と，見出し情報を読み込む先を指定します。

タイトルバー

「格納先の指定」又は「読み込み先の指定」と表示されます。

［フォルダ(F)］

見出し情報を格納するフォルダ又は見出し情報を読み込むフォルダを指定します。

［..］

一つ上のフォルダを示します。選択すると，一つ上のフォルダを表示します。ドライブ直下の場合は，表示されません。

［api］，［samples］

下位のフォルダを示します。

選択すると，さらに下位にあるフォルダを表示します。

［−a−］，［−c−］

ドライブを指定します。

選択すると，ドライブ下にあるフォルダを表示します。

［OK］ボタン

指定したフォルダへ見出し情報を格納します。又は指定したフォルダから見出し情報を読み込みます。

［キャンセル］ボタン

格納先の指定又は読み込み先の指定を取り消します。

(5)　操作

見出し辞書を編集する操作を次の図に示します。

図G‒1　見出し辞書を編集する操作

［DBPARTNER2］ウィンドウの［定義(D)］−［見出し編集(E)...］メニューを選びます。

［見出し編集］ダイアログボックスが表示されます。

見出し情報の作成や編集などの操作をしてください。

次の操作ができます。

新規に見出し情報を作成する

参照：「付録G.2　見出し情報の作成」

見出し辞書に登録されている見出し情報を編集する

参照：「付録G.3　見出し情報の編集」

見出し情報を別のドライブ又はフォルダに格納する

参照：「付録G.4　格納先を指定して見出し情報を格納する」

見出し情報を見出し辞書に一括登録する

参照：「付録G.5　見出し情報の一括登録」

見出し辞書にグループを設定する

参照：「付録G.6　見出し辞書のグループ設定」

別のドライブ又はフォルダに格納した見出し情報を読み込む

参照：「付録G.7　別のドライブ又はフォルダの見出し情報を読み込む」

不要な見出し情報を見出し辞書から削除する

参照：「付録G.8　見出し情報の削除」

操作が終了したら，［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(6)　注意

［表定義］ダイアログボックスで表を定義すると，自動的に定義した内容が見出し辞書に登録されます。［表定義］ダイアログボックスで，定義した表を編集又は削除した場合も同様です。

付録G.2　見出し情報の作成

サーバ上の表で，見出し辞書に登録されていない表に対して見出し情報を作成します。見出し情報を作成したい表に対して，表見出しと列見出しを設定します。設定した内容は，表の情報と合わせて見出し辞書に登録されます。

(1)　操作

見出し情報を作成する操作は，［見出し編集］ダイアログボックスから始めます。見出し情報を作成する操作を次の図に示します。

図G‒2　見出し情報を作成する操作

［見出し編集］ダイアログボックスの［新規作成(N)...］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

サーバと接続されていない場合は，［ユーザID・パスワード設定］ダイアログボックスが表示されます。その場合は，ユーザIDとパスワードを設定してください。

補足

ワイルドカードを使って表一覧に表示する表を絞り込めます。その場合，［表選択］ダイアログボックスの［絞り込み(F)...］ボタンをクリックしてください。［表の絞り込み条件設定］ダイアログボックスが表示されるので，条件を設定して絞り込んでください。

表一覧から，見出しを作成する表を選択します。

［OK］ボタンをクリックします。

［見出し編集］ダイアログボックスに戻ります。

2.で選択した表の接続先名，所有者名，表名と列名が表示されます。

表に対する表見出しとグループ名，列に対する列見出しを設定した後，［登録(G)］ボタンをクリックします。

設定した内容が見出し辞書に登録されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　規則と注意

見出し情報を作成する場合に定義する項目の一覧を次の表に示します。

表G‒1　見出し情報作成時に定義する項目の一覧

定義項目

最大長（バイト）

省略値

使える文字

表見出し

0〜30

表見出しは設定されない※

半角文字，全角文字

列見出し

0〜46

列見出しは設定されない※

半角文字，全角文字

注※

データベースで表見出し又は列見出しを定義している場合は，データベースで定義した表見出し又は列見出しが表示されます。

［表選択］ダイアログボックスで選択できる表は一つです。二つ以上は選択できません。

データベースの表・列情報を変更した場合は，見出し情報を再作成してください。

表見出しは，複数の表に対し同じ名称を指定することができます。また，列見出しは，複数の列に対し同じ名称を指定することができます。

表見出しや列見出しに同じ名称を指定した見出し辞書を使用した場合，仮想列の設定，列演算条件式の設定，条件式直接入力の設定などで，意図したとおりの列を選択できないときがあります。表見出し，列見出しには，重複しない名称を指定してください。

付録G.3　見出し情報の編集

既に作成して見出し辞書に登録されている見出し情報を編集します。見出し情報を編集するには，まず見出し辞書から見出し情報を呼び出します。次に，呼び出した見出し情報の内容を変更します。最後に見出し辞書に格納します。

(1)　操作

見出し情報を編集する操作は，［見出し編集］ダイアログボックスから始めます。

見出し情報を編集する操作を次の図に示します。

図G‒3　見出し情報を編集する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されて，見出し辞書に登録されている見出し情報が表示されます。

編集したい表見出しの行を選択します。

［編集(E)］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示されます。

2.で選択した表見出しの見出し情報が表示されます。

表見出しやグループ名，列見出しを変更します。

編集後，［登録(G)］ボタンをクリックします。

変更した内容が見出し辞書に登録されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］が淡色で表示されて，選択できません。

付録G.4　格納先を指定して見出し情報を格納する

通常，見出し辞書はDBPARTNER2が動作するフォルダにあります（見出し情報一覧はファイル名Dptindex.dpdに，グループの情報はファイル名Dptindex2.dpdに，見出し情報はファイル名Dpt00001.dpd〜Dpt65535.dpdに格納されます）。このため，作成又は編集した見出し情報は，特に格納先を指定しなければこの見出し辞書に登録されます。この見出し辞書の中ではなく別の場所に格納したい場合には，格納するドライブ又はフォルダを指定できます。

作成した見出し辞書をほかの使用者に配布する場合や，現在使っている見出し辞書の内容を別のDBPARTNER2で使う場合などに利用すると便利です。

(1)　操作

見出し情報を作成又は編集して別のドライブ又はフォルダに格納する操作は，［見出し編集］ダイアログボックスから始めます。別のドライブ又はフォルダに見出し情報を格納する操作を次の図に示します。

図G‒4　別のドライブ又はフォルダに格納する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

格納したい表見出しの行を選択します。

複数選択できます。

［格納(U)...］ボタンをクリックします。

［格納先の指定］ダイアログボックスが表示されます。

2.で選択した表見出しを格納するドライブ又はフォルダを設定した後，［OK］ボタンをクリックします。

見出し情報が指定したドライブ又はフォルダに格納されます。格納後，［見出し選択］ダイアログボックスが表示されます。

［閉じる］ボタンをクリックします。

［見出し編集］ダイアログボックスに戻ります。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

付録G.5　見出し情報の一括登録

複数の表の見出し情報を，見出し辞書に一括登録できます。

(1)　操作

複数の表の見出し情報を見出し辞書に一括登録する操作は，［見出し編集］ダイアログボックスから始めます。

見出し情報を，見出し辞書に一括登録する操作を次の図に示します。

図G‒5　 見出し情報を見出し辞書に一括登録する操作

［見出し編集］ダイアログボックスから［一括作成(M)］ボタンをクリックします。

［表選択］ダイアログボックスが表示されます。

一括登録したい表を選択して［OK］ボタンをクリックします。

［登録経過］ダイアログボックスが表示されます。

補足

［登録経過］ダイアログボックスでは，辞書登録が完了した表名が順に表示されていきます。［キャンセル］ボタンをクリックすると，現在の辞書登録完了後に，残りの辞書登録がキャンセルされます。

既に見出し情報が見出し辞書に登録されている表を登録する場合には，［上書き］ダイアログボックスが表示されます。

［はい］ボタンをクリックした場合は，現在の辞書ファイルに上書きします。

［いいえ］ボタンをクリックした場合は，現在の表の登録を中止して次の表の登録に進みます。

［すべて上書き］ボタンをクリックした場合は，これ以降の表で既に辞書登録されている表についても，メッセージを表示することなく上書きします。

補足

見出し辞書を上書きしても，グループ名の情報は変更されません。

［OK］ボタンをクリックします

［見出し編集］ダイアログボックスに戻ります。

付録G.6　見出し辞書のグループ設定

見出し辞書には，それぞれの表名にグループを設定できます。グループを設定すると，見出し辞書を使った抽出でグループ名を目安にして，表が選択できます。

グループを設定する操作を次に説明します。

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

［登録表一覧(T):］リストから，グループ名を設定したい表を選択します。

一度に複数の表を選択することもできます。

選択した表に設定するグループ名を，［グループ名(G):］コンボボックスに入力，又はリストから選択します。

［設定(S)］ボタンをクリックします。

グループ名の設定（変更，又は削除）を確認するメッセージが表示されます。

［はい］ボタンをクリックすると，グループ名が設定されます。

付録G.7　別のドライブ又はフォルダの見出し情報を読み込む

通常，見出し辞書はDBPARTNER2が動作するフォルダにあります。このため，既に作成した見出し情報を編集したり削除したりする場合には，特に指定しなければこの見出し辞書から読み込まれます。この見出し辞書の中ではなく別のドライブ又はフォルダにある見出し情報を読み込む場合には，ドライブ又はフォルダを指定して読み込みます。

一つの見出し辞書をマスタ辞書として，必要な見出し情報だけを読み込んで編集して個人用の見出し辞書に登録する場合などに利用すると便利です。

(1)　操作

見出し情報を別のドライブ又はフォルダから読み込む操作は，［見出し編集］ダイアログボックスから始めます。別のドライブ又はフォルダにある見出し情報を読み込む操作を次の図に示します。

図G‒6　 別のドライブ又はフォルダから読み込む操作

［見出し編集］ダイアログボックスの［読み込み(R)...］ボタンをクリックします。

［読み込み先の指定］ダイアログボックスが表示されます。

読み込む見出し情報が格納されているドライブ又はフォルダを指定します。

［OK］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

2.で選択したフォルダにある表見出しの一覧が表示されます。

読み込む表見出しを選んでから，［編集(E)］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示され，選択した表見出しの見出し情報が表示されます。

これで読み込みは終了しました。読み込んだ見出し情報を編集又は削除してください。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］ボタンが淡色で表示されて，選択できません。

付録G.8　見出し情報の削除

不要な見出し情報を，見出し辞書から削除します。

(1)　操作

見出し辞書に登録した見出し情報を見出し辞書から削除します。見出し情報の削除は，［見出し編集］ダイアログボックスから始めます。見出し情報を削除する操作を次の図に示します。

図G‒7　見出し情報を削除する操作

［見出し編集］ダイアログボックスの［見出し一覧(L)...］ボタンをクリックします。

［見出し選択］ダイアログボックスが表示されます。

削除する表見出しの行を選んでから，［削除(D)］ボタンをクリックします。

見出し辞書から見出し情報が削除されます。

補足

見出し情報を確認したい場合は，［編集(E)］ボタンをクリックして［見出し編集］ダイアログボックスを表示してください。内容を確認後，［見出し編集］ダイアログボックスの［削除(D)］ボタンで削除できます。

［閉じる］ボタンをクリックします。

［見出し編集］ダイアログボックスが表示されます。

［終了(X)］ボタンをクリックします。

［DBPARTNER2］ウィンドウに戻ります。

(2)　注意

［見出し選択］ダイアログボックスで編集する見出し情報を選択する場合，選択できるのは一つだけです。複数選択すると，［編集(E)］ボタンが淡色で表示されて，選択できません。

付録H　ユーザ外字変換ファイル

ここではユーザ外字変換ファイルの作成方法について説明します。

ユーザ外字変換ファイルは，DBPARTNER ODBC 3.0 Driverのインストールされたマシン（クライアント）で作成された外字と，DBMS（サーバ）で作成された外字の対応付けを指定します。外字コードを変換するときは，次に示すテキスト形式のファイル（〜.txt）を作成します。

付録H.1　形式

付録H.2　規則

行の先頭に半角スペースを入れないでください。

クライアント側外字コード，サーバ側外字コードとも，16進数表記で指定してください。16進数を示す先頭の「0x」は付けないでください。

（例）「0xF040」は「F040」と記述してください。

コードに小文字は使えません。

（例）「0xf040」は「F040」と記述してください。

使える文字は，半角英数字と半角スペースです。使える文字数を次に示します。

サーバがEUCコードの場合：4文字又は6文字（例：F040，8FA1A1）

サーバがシフトJISコードの場合：4文字（例：F040）

指定できる外字コードの範囲を次に示します。範囲については，サーバのOSがサポートする外字コードの範囲を確認してください。

クライアント側外字コード：F040〜F9FC（ただし，外字エディタで使える範囲に限ります）

サーバ側外字コード：任意（指定が妥当かどうかは，チェックされません）

「=」の前後に半角スペースを記述できます。

1行に複数のコードを記述できます。複数のコードを記述するときは，「,」で区切ってください。

改行は区切りを示す「,」の直後でだけできます。

同じコードを複数回定義したときは，最後に定義したコードが有効になります。

「#」から改行するまでは，コメント行と見なされます。コメント行も，行の先頭に半角スペースを入れないでください。

付録H.3　ユーザ外字変換ファイルの記述例

付録H.4　注意

ユーザ外字変換ファイルに指定したコード範囲が妥当かどうかは，チェックされません。また，変換する外字として使える文字コードの範囲は，サーバ側のシステムに依存します。ユーザ外字変換ファイルに文字コードを指定するときは，サーバ側のシステムのOSやDBMSのマニュアルを参照して，サポートする文字コードの範囲を事前に確認してください。

ユーザ外字変換ファイルは，サーバ側のシステムとの接続を開始するときに読み込まれます。このため，ユーザ外字変換ファイルの内容を変更したときは，サーバ側のシステムをいったん切断してから，再び接続してください。

付録I　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録I.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

(1)　サーバ側

サーバのOSごとに関連するマニュアルを次に示します。

UNIX/Windowsの場合

DABroker（3020-6-031）

DABroker(64) (64Bit版)（3020-6-088）

ノンストップデータベースサーバ HiRDB Version 9 コマンドリファレンス（UNIX(R)用）（3000-6-455）

ノンストップデータベースサーバ HiRDB Version 9 コマンドリファレンス（Windows(R)用）（3020-6-455）

ノンストップデータベースサーバ HiRDB Version 9 UAP 開発ガイド（3020-6-456）

ノンストップデータベースサーバ HiRDB Version 9 SQL リファレンス（3020-6-457）

ノンストップデータベースサーバ HiRDB Version 9 メッセージ（3020-6-458）

ノンストップデータベース　HiRDB Version 10 コマンドリファレンス（UNIX(R)用）（3020-6-558）

ノンストップデータベース　HiRDB Version 10 コマンドリファレンス（Windows(R)用）（3020-6-559）

ノンストップデータベース　HiRDB Version 10 UAP開発ガイド（3020-6-560）

ノンストップデータベース　HiRDB Version 10 SQLリファレンス（3020-6-561）

ノンストップデータベース　HiRDB Version 10 メッセージ（3020-6-562）

Hitachi Advanced Data Binder　システム構築・運用ガイド（3000-6-501）

Hitachi Advanced Data Binder　AP開発ガイド（3000-6-502）

Hitachi Advanced Data Binder　コマンドリファレンス（3000-6-503）

Hitachi Advanced Data Binder　SQLリファレンス（3000-6-504）

Hitachi Advanced Data Binder　メッセージ（3000-6-505）

VOS3の場合

VOS3 データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/SD）（6190-6-652）

VOS3 データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/RD E2）（6190-6-638）

VOS3データマネジメントシステム XDM E2系 SQLリファレンス（XDM/RD E2）（6190-6-656）

VOS3 データマネジメントシステム XDM E2系 メッセージ（XDM/RD E2）（6190-6-643）

VOS3 データマネジメントシステム XDM E2系 運用の手引 -解説編-（6190-6-628）

VOS3 データマネジメントシステム XDM E2系 メッセージ（コンソール・端末出力メッセージ）（6190-6-629）

VOS3　データマネジメントシステム XDM E2系 XDM/RD E2 使用の手引 −RD環境定義文・空間起動制御文・運用コマンド編−（6190-6-661）

付録I.2　このマニュアルで使用する略称

このマニュアルでは，製品名を次に示す略称で表記しています。

品名

略称

Microsoft Excel

Excel

ORACLEのデータベース

ORACLE

VOS3/AS，VOS3/ES1，VOS3/FS，VOS3/LS，VOS3/US，VOS3/XS

VOS3

このマニュアルでは，オペレーティングシステムを次に示す略称で表記しています。

製品名

略称

Microsoft Windows 10 Pro

Windows 10

Windows

Microsoft Windows 10 Enterprise

Microsoft Windows Server 2012 Standard

Windows Server 2012

Microsoft Windows Server 2012 Datacenter

Microsoft Windows Server 2012 R2 Standard

Windows Server 2012 R2

Microsoft Windows Server 2012 R2 Datacenter

Microsoft Windows Server 2016 Standard

Windows Server 2016

Microsoft Windows Server 2016 Datacenter

Microsoft Windows Server 2019 Standard

Windows Server 2019

Microsoft Windows Server 2019 Datacenter

このマニュアルでは，データベースに接続するときに使う通信形態を次に示すように表記しています。通信形態とマニュアルでの表記を次に示します。

通信形態

マニュアルでの表記

ODBCドライバ

ODBC接続

付録I.3　略語一覧

このマニュアルで使う英略語の一覧を次に示します。

英略語

英字の表記

DB

Database

DBMS

Database Management System

DBS

Database Connection Server

DLL

Dynamic Linking Library

GUI

Graphical User Interface

HADB

Hitachi Advanced Data Binder

JIS

Japanese Industrial Standard code

KEIS

Kanji processing Extended Information System

LAN

Local Area Network

ODBC

Open Database Connectivity

OS

Operating System

PC

Personal Computer

SQL

Structured Query Language

TCP/IP

Transmission Control Protocol / Internet Protocol

VOS3

Virtual-storage Operating System 3

XDM/RD E2

Extensible Data Manager / Relational Database Extended Version 2

XDM/SD E2

Extensible Data Manager / Sequential Database Extended Version 2

付録I.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録J　用語解説

（英字）

SQL文

SQLとは，データベースの表データを操作，定義，及び制御するための言語です。DBPARTNER2では，データを抽出する場合に使います。

（カ行）

可変記号

条件式中の条件値の部分に指定する「＆」で始まる文字列です。条件値の代わりに可変記号を指定して実行時に実行値を入力します。

関連付け

NOT，AND，OR，又は（　）を使った条件式間のつながりのことです。何も指定しない場合，条件式間のつながりはANDとなります。

クライアント／サーバ

プログラムとプログラムの通信方法の一つです。業務処理を依頼する方をクライアント，要求を受けて業務を実行する方をサーバといいます。DBPARTNER2を使った業務では，DBPARTNER2がクライアント，データベースがサーバとなります。クライアント／サーバとは，プログラム間の相対的な関係を示す用語です。

更新種別

更新種別には，変更，追加，削除の3種類があります。これは，［データ表示］ウィンドウなどの［更新］メニューで，データベースへ更新データをどのように反映するかを示します。変更とは，データベースの表の行データを変更することです。追加は，データベースの表に行を追加することです。削除とは，データベースの表の行を削除することです。

（サ行）

サーバ

ほかのシステムやプログラムから要求を受けて，業務を実行するシステム又はプログラムのことです。代表的なサーバの業務は，データベース管理です。DBPARTNER2を使った業務では，HiRDBやORACLEなどのデータベースを総称してサーバといいます。

シート

抽出したデータを，ほかのアプリケーションに転送して貼り付けることです。

集合関数

抽出する列中のデータから，最大値，最小値，平均値，合計値，及び件数を抽出する関数です。

条件

データを抽出するときの，データの絞り込み方法です。条件には，＝，＞，＜，<>，>=，<=，NULL，NOT NULL，IN，NOT IN，LIKE，NOT LIKE，BETWEEN，NOT BETWEEN，列比較，列演算があります。

接続先

DBPARTNER2でアクセスするサーバ又はデータベースのことです。

接続先定義ファイル

接続するサーバの環境，起動・終了操作などを定義するファイルです。このファイルは，インストール後，ユーザが必ず作成しなければなりません。

接続先の設定

利用するデータベースが格納されているサーバとの接続を設定することです。DBPARTNER2の起動後，あるサーバに初めてアクセスする前に［接続］メニューで接続先を設定します。設定した内容は次に変更するまで引き継がれるので，同じサーバに2回目以降に接続する場合は，設定する必要はありません。

設定内容

接続先設定，列設定，及び条件設定で設定した情報のことです。

属性

データベースに定義されている列の属性です。DBPARTNER2では［条件設定］ダイアログボックスに表示されます。

（タ行）

抽出データ格納ファイル

データベースから抽出したデータを格納するファイルです。抽出したデータの転送先をファイルとした場合に，DBPARTNER2によって作成されます。拡張子はデータの形式によって決まります。

データの更新

データベースからデータを抽出し，そのデータをDBPARTNER2上で編集してデータベースを更新することです。データの更新は，［データ表示］ウィンドウなどの［更新］メニューで実行します。

データの絞り込み

抽出するデータの対象を狭めることです。データの絞り込みには，条件付加と保存利用があります。条件付加は，条件式を追加又は変更することでデータを絞り込むことです。保存利用は，抽出したデータを別の表としてデータベースに保存することです。

データの抽出

データベースからデータを取り出すことです。データの抽出は［DBPARTNER2］ウィンドウの［抽出］ボタンで実行します。抽出したデータは，抽出データ格納ファイルに転送して格納するか，表計算ソフトウェアに転送するか，又はデータベースに格納します。

データの転送

サーバにあるデータベースの内容を，ワークステーションやクライアントPC側のファイルやシートに送ることです。

データベース

論理的に関連のあるデータの集合のことです。

手順ファイル

データを抽出したときに指定した表名，列名，条件などを登録しておくファイルです。次回以降，登録した内容でデータの抽出ができます。［手順ファイルの登録］ダイアログボックスで登録先を指定した後，このファイルはDBPARTNER2によって作成されます。拡張子は「.DPC」となります。

転送先

抽出したデータの送り先のことです。

ドライブ

ファイルの記録装置のことです。A，Bなどの1文字の英字で表します。

（ナ行）

長さ

データベースに定義されているデータ長です。

（ハ行）

表

データの集まりの単位であり，データベースによっては，ファイルやテーブルに相当します。

DBPARTNER2では，表と呼びます。

表ヘッダ

サーバが表に付けた名称のことであり，データベースによっては，テーブルヘッダに相当します。

DBPARTNER2では，表名と呼びます。

表名

表ヘッダのことをDBPARTNER2のダイアログボックスでは，表名として表示します。

ファイルの種類

ファイルに格納するときのデータの形式です。利用するアプリケーションによってデータの形式は異なります。また，データの形式によってファイル名の拡張子が決まっています。

複数表からのデータの抽出（表の結合）

複数の表からデータを抽出するときに，共通する列をキーとして表と表を結び付けることを表の結合といいます。キーとした列のデータのうち同じデータである行が抽出されます。DBPARTNER2では，表と表を結び付けるキーとする列を［条件設定］ダイアログボックスの列比較条件式で設定します。列比較条件式に設定する列と列は，列比較できる属性でなければなりません。属性の組み合わせについては，「8.　列と条件を設定するときの規則」を参照してください。

（マ行）

見出し辞書

データベースの表や列に対してユーザが付けた表名や列名を登録する辞書のことです。見出し辞書を使うかどうかは，［DBPARTNER2］ウィンドウの［ツール］メニューで設定します。

見出しテキスト

見出し辞書に登録している表見出しや列見出しをテキスト形式で記述したものをいいます。見出しテキストの登録や，反映は見出し変更ツールを使います。

（ラ行）

列一覧

データベースの表を構成する列の一覧のことです。

列名

表内の列に付けられた名称のことであり，データベースによっては，カラム名，欄名に相当します。DBPARTNER2では，列名と呼びます。

（ワ行）

ワイルドカード

文字の代わりに指定する記号のことです。検索する単語の一部しか分からないとき，分からない部分をワイルドカードに置き換えて指定します。ワイルドカードは抽出する表を絞り込む操作で使えます。

索引

記号

?[1]

？パラメタに対する実行値[1]

［DBPARTNER ODBC 3.0 Driver セットアップ］ダイアログボックス[1]

［SQL入力］ダイアログボックス[1]

［インデクス定義］ダイアログボックス[1]

［オプション設定］ダイアログボックス[1]

［オプション設定］ダイアログボックスに関する設定[1]

［格納先の指定］ダイアログボックス[1]、[2]

［格納領域設定］ダイアログボックス[1]

［仮想列編集］ダイアログボックス[1]

［可変記号入力］ダイアログボックス[1]

［辞書一覧表示方法の設定］ダイアログボックス[1]、[2]

［辞書フォルダ］ダイアログボックス[1]

［実行値入力］ダイアログボックス[1]、[2]

［実行値入力］ダイアログボックス表示[1]

［集合関数設定］ダイアログボックスで設定できる集合関数[1]

［条件設定］ダイアログボックス[1]

［接続］メニュー[1]

［接続先設定］ダイアログボックスに関する設定[1]

［抽出］メニュー[1]、[2]

［ツール］メニュー[1]

［定義］メニュー[1]

［データ表示］ウィンドウ[1]

［データ表示］ウィンドウに関する設定[1]

［データ表示］ウィンドウを終了させる操作[1]

［データ表示］ウィンドウを使った抽出[1]

［手順］メニュー[1]

［手順ファイルのコメント変更］ダイアログボックス[1]

［手順ファイルの削除］ダイアログボックス[1]

［手順ファイルの参照］ダイアログボックス[1]

［手順ファイルの実行］ダイアログボックス[1]

［手順ファイルの登録］ダイアログボックス[1]

［登録表一覧］に表示する接続先名に関する設定[1]

［パラメタ設定］ダイアログボックス[1]

［貼付オプション］ダイアログボックスを使った抽出[1]

［表結合条件式］ダイアログボックス[1]

［表設定］ダイアログボックスに表示させる表の表属性に関する設定[1]

［表定義］ダイアログボックス[1]

［表の絞り込み条件設定］ダイアログボックス[1]

［見出し選択］ダイアログボックス[1]、[2]

［見出し編集］ダイアログボックス[1]、[2]

［読み込み先の指定］ダイアログボックス[1]、[2]

［列詳細定義］ダイアログボックス[1]

［列設定］ダイアログボックス[1]

［列定義］ダイアログボックス[1]

*[1]

B

BETWEEN条件式の設定[1]

C

CatalogOption[1]

CLMHEAD[1]

CLMMAXCNT[1]

CNCTOPT[1]

CntCheckTime[1]

ColumnMove[1]

COM[1]

Condition [1]

Connectセクション[1]

Convert0204[1]

CountLimit[1]

CSV形式[1]

D

DatabadseSave[1]

DataChk[1]

DATACHK[1]

DataCnt[1]

DAT形式[1]

Dbp2dict.ocx[1]

Dbp2dicutl.exe[1]

dbp2exl_img1.png[1]

dbp2exl_img2.png[1]

dbp2exl_img3.jpg[1]

dbp2exl(64)2019.xlam[1]

Dbp2upd.exe[1]

Dbpart2.err[1]

Dbpart2.exe[1]

Dbpart2.hlp[1]

Dbpart2.inf[1]、[2]

Dbpart2.ini[1]

DBPARTNER2[1]

DBPARTNER2 Client[1]

DBPARTNER2からのデータの更新[1]

DBPARTNER2からの表定義[1]

DBPARTNER2で使える文字[1]

DBPARTNER2でのデータベースの用語（ODBC接続）[1]

DBPARTNER2とサーバとの接続のタイミング[1]

DBPARTNER2とサーバを接続する形態[1]

DBPARTNER2に関連する製品[1]

DBPARTNER2のインストール[1]

DBPARTNER2のインストールの手順[1]

DBPARTNER2のウィンドウを使ってデータを更新する場合[1]

DBPARTNER2の概要[1]

DBPARTNER2の環境を設定する手順[1]

DBPARTNER2の関連製品を使ったデータベースへのアクセス[1]

DBPARTNER2の起動[1]

DBPARTNER2の機能[1]

DBPARTNER2の機能の一覧[1]

DBPARTNER2の終了[1]

DBPARTNER2の紹介[1]

DBPARTNER2の製品の種類[1]

DBPARTNER2の製品名と機能[1]

DBPARTNER2の操作時に起こるトラブル[1]

DBPARTNER2の操作の概要[1]、[2]

DBPARTNER2の抽出／更新の概要[1]

DBPARTNER2のメッセージ[1]

DBPARTNER2の予約語[1]

DBPARTNER2の列属性[1]

DBPARTNER2をインストールすると作成されるファイル[1]

DBPARTNER2をインストールすると作成されるファイルの一覧[1]

DBPARTNER2をインストールすると作成されるフォルダの構成[1]

DBPARTNER2を稼働するときに作成するファイル[1]

DBPARTNER2を使ったデータの更新[1]

DBPARTNER2を使ったデータの抽出[1]

DBPARTNER ODBC 3.0 Driverのメッセージ[1]

DBPARTNER連携マクロ[1]、[2]

Dbpcon.dpl[1]、[2]、[3]

DBPOREG3X.exe[1]

DicDirectory[1]

DicFilter[1]

Dictionary[1]

DictUsed[1]

Directory[1]

Display[1]

DUP[1]

E

Excelからの自動抽出[1]

Excelからのデータの更新[1]

Excel形式[1]

Excel連携[1]

Excel連携拡張機能[1]

EXCLUSIVE[1]

ExecOption[1]

Expandセクション[1]

F

Filterセクション[1]

FuncHead[1]

H

HADB[1]

HADBの場合のデータベース接続[1]

HiRDB[1]

HiRDBの場合のデータベース接続[1]

HOSTNAME[1]

I

INDICATE[1]

INFNAME[1]

IN条件式の設定[1]

J

JoinCheck[1]

JP1連携機能[1]

L

LIKE条件式の設定[1]

M

MaxCell[1]

MaxDataCnt[1]

MaxFileSize[1]

MenuViewセクション[1]

MessageOption[1]

MSGTrace[1]

N

NCHARTYPE[1]

Netexecコマンドの利用[1]

NULL条件式の設定[1]

NULL値禁止の指定[1]

O

ODBCCON[1]

ODBCHEAD[1]

ODBC接続[1]

ODBC接続の場合に環境を設定する手順[1]

ODBC接続の場合のアクセス形態[1]

ODBC接続の場合の列属性[1]

ODBCドライバを使ってアクセスできるデータベース[1]、[2]

Optionsセクション[1]

ORACLE[1]、[2]

ORACLEの場合のデータベース接続[1]

R

Readme.txt[1]

S

SelectOptionセクション[1]

SQL文の入力と実行[1]、[2]

SQL文〔用語解説〕[1]

SQLを手順ファイルに登録するときの規則[1]

T

TableList[1]

TableListセクション[1]

TableOrder[1]

TABLESPACE[1]

TBLMAXCNT[1]

TBLPRFIX[1]

TEXT形式[1]

Trace[1]

TrmOverWrite[1]

TrnsDef[1]

TrnsFile[1]

U

UNQ[1]

UpdateOptionセクション[1]

UPDFIN[1]

UPDINS[1]

UPDUNIT[1]

UPEXCLUSIVE[1]

V

Value[1]

ValueOrder[1]

VieApp1[1]

ViewMode[1]

ViewMode [1]

VOS3 XDM/RD E2[1]

VOS3 XDM/SD E2[1]

W

Wait[1]

WaitLimit[1]

WarningCell[1]

WarningSelectMsg[1]

where句に指定できる条件[1]

あ

アドインマクロ[1]

アンインストールする方法[1]

い

一括出力[1]

インストール後のデータベース接続の設定[1]

インデクス情報の表示[1]

インデクス定義[1]

インデクスの定義[1]

う

内結合[1]

え

英字集合関数名[1]

お

オプション[1]

オプションの設定[1]

か

確認したデータを抽出する場合[1]

確認したデータを表として保存する場合[1]

格納先を指定して見出し情報を格納する[1]、[2]

格納条件の指定方法[1]

格納条件を指定するときの注意[1]

格納領域設定[1]

格納領域を指定するときの注意（HiRDBの場合）[1]

仮想列[1]

仮想列の削除[1]

仮想列の追加[1]

仮想列の編集[1]

可変記号に対する実行値を入力して手順ファイルを実行する場合[1]

可変記号のソート設定[1]

可変記号〔用語解説〕[1]

可変記号を条件式に設定する操作[1]

可変記号を条件式に設定する場合[1]

可変記号を使ったデータの抽出[1]

環境の設定[1]

漢字集合関数名[1]

関連付け〔用語解説〕[1]

き

行のコピー・貼り付けの操作[1]

行を削除する[1]

行を追加する（［データ表示］ウィンドウで追加データを作成）[1]

行を追加する（追加データをファイルから読み込む）[1]

く

クライアント／サーバ〔用語解説〕[1]

クリップボードに転送する[1]

グループ[1]

け

結合条件[1]

結合条件を設定しなかった場合[1]

結合できる表の最大数（ODBC接続）[1]

件数表示できない場合[1]

こ

更新種別〔用語解説〕[1]

更新情報[1]

更新するデータの作成[1]

更新するデータの抽出[1]

後方一致[1]

項目行[1]

項目名を表示する設定[1]

コマンドラインからの手順ファイルの実行[1]

さ

サーバ〔用語解説〕[1]

再インストールする方法[1]

最新列情報の取得[1]

し

シート〔用語解説〕[1]

システムに関するトラブル[1]

指定できるオプション[1]

集合関数指定時の列の見出し表示[1]

集合関数の取り消し[1]

集合関数〔用語解説〕[1]

集合関数を設定する[1]

条件式を関連付ける[1]

条件式を直接入力する[1]

条件の設定で使うボタン[1]

条件〔用語解説〕[1]

条件を削除，又は変更する[1]

条件を設定したデータの抽出[1]

条件を設定して更新する行を決定する[1]

情報ファイル[1]、[2]、[3]

情報ファイルに指定できる項目[1]

情報ファイルの作成[1]

情報ファイルの作成手順[1]

せ

接続先定義ファイル[1]、[2]、[3]

接続先定義ファイルに指定するパラメタ[1]

接続先定義ファイルの作成[1]

接続先定義ファイルの作成手順[1]

接続先定義ファイル〔用語解説〕[1]

接続先のサーバと利用者の設定[1]

接続先のサーバの設定[1]

接続先の設定〔用語解説〕[1]

接続先〔用語解説〕[1]

設定内容〔用語解説〕[1]

全列を削除する[1]

そ

操作対象となる行を選択する操作[1]

ソートの設定を削除する[1]

ソートを設定する[1]

属性〔用語解説〕[1]

外結合[1]

ち

逐次出力[1]

逐次探索中又は検索完了表示中のデータを一括でファイルに格納する操作[1]

中間一致[1]

抽出[1]

抽出時間の上限の設定[1]

抽出したデータの転送先の設定[1]

抽出したデータの用途[1]、[2]

抽出したデータを編集してデータベースを更新する[1]

抽出したデータをほかのアプリケーションに転送するときの条件[1]

抽出処理を中断した場合[1]

抽出するデータの件数の制限[1]

抽出する表の選択[1]

抽出する列を設定する[1]

抽出データ格納ファイル〔用語解説〕[1]

抽出データの確認[1]

抽出で使える機能[1]、[2]

抽出で使える機能の一覧[1]、[2]

抽出に関するオプション[1]

て

定義[1]

定義項目の一覧（［表定義］ダイアログボックス）[1]

定義項目の一覧（［列定義］ダイアログボックス）[1]

定義した表に対する詳細情報の定義[1]

定型業務の登録と実行[1]

定数の指定方法（ODBC）[1]

データ行[1]

データ形式[1]

データ更新の例[1]

データセル[1]

データセルのデータを変更する操作[1]

データ抽出時のキャンセル処理に関する設定[1]

データ抽出に関する設定[1]

データの確認[1]

データの更新[1]、[2]、[3]

データの更新方法[1]

データの更新〔用語解説〕[1]

データの絞り込み〔用語解説〕[1]

データの操作[1]

データの抽出[1]、[2]、[3]

データの抽出の基本操作[1]

データの抽出〔用語解説〕[1]

データの転送〔用語解説〕[1]

データベースとDBPARTNER2で使える機能（HADBの場合）[1]

データベースとDBPARTNER2で使える機能（HiRDBの場合）[1]

データベースとDBPARTNER2で使える機能（ORACLEの場合）[1]

データベースとDBPARTNER2で使える機能の関係[1]

データベースと接続するときに起こるトラブル[1]

データベースに転送する[1]

データベースの格納に関する設定[1]

データベースのデータを抽出する[1]

データベースへのデータ追加[1]

データベースへ表を定義する[1]

データベース〔用語解説〕[1]

データを操作する手順[1]

データを抽出する操作の手順[1]

データを抽出するときに注意する項目[1]

データを抽出するときの制限[1]

データを抽出するときの注意[1]

データを変更する[1]

適用範囲（ODBC接続の場合）[1]

手順ファイル[1]

手順ファイル実行時の［DBPARTNER2］ウィンドウに関する設定[1]

手順ファイルに登録するタイミング[1]

手順ファイルに登録できる項目[1]

手順ファイルの印刷[1]

手順ファイルの削除[1]

手順ファイルの参照[1]

手順ファイルの参照時に変更できる内容[1]

手順ファイルの実行[1]

手順ファイルの実行時の動作内容[1]

手順ファイルの操作に関するコマンド[1]

手順ファイルの使い方の例[1]

手順ファイルの登録[1]

手順ファイルの登録内容の変更[1]

手順ファイルのファイル情報の表示[1]

手順ファイルの変更[1]

手順ファイル〔用語解説〕[1]

転送先のメモリが満杯になった場合[1]

転送先ファイルの上書きメッセージの表示[1]

転送先ファイルの設定[1]

転送先〔用語解説〕[1]

と

特定のメッセージ表示に関する設定[1]

特定の列のデータの抽出[1]

ドライブ〔用語解説〕[1]

トラブルが起こったときは[1]

な

長さ〔用語解説〕[1]

は

バイナリデータを含む表の更新[1]

バイナリデータを含む表の抽出[1]

貼付オプション機能[1]

貼付オプションパラメタを使った抽出[1]

ひ

比較条件式の設定[1]

比較できる列属性の組み合わせ（ODBC）[1]

表一覧情報の絞り込みに関する設定[1]

表一覧情報の表示方法[1]

表一覧表示方法の設定[1]

表計算ソフトからデータを更新する場合[1]

表結合[1]、[2]

表結合条件式の設定[1]

表示に関するオプション[1]

表選択時の絞り込み[1]

表定義の概要[1]

表の削除[1]

表の定義[1]、[2]

表の例[1]

表ヘッダ〔用語解説〕[1]

表名〔用語解説〕[1]

表名・列名変更[1]

表〔用語解説〕[1]

表を格納する領域の指定[1]

表を定義するときに指定する項目[1]

ふ

ファイル出力するデータ形式のフォーマット[1]

ファイルに転送する[1]

ファイルの種類〔用語解説〕[1]

複数の条件式を設定する[1]

複数の表からのデータの抽出[1]

複数の列をまとめて操作できます[1]

複数表からデータを抽出する操作[1]

複数表からデータを抽出するときに結合条件を設定していない表があった場合[1]

複数表からのデータの抽出（表の結合）〔用語解説〕[1]

複数表を結合してデータを抽出する場合[1]

部分一致[1]

ま

前方一致[1]

み

見出し辞書[1]、[2]、[3]、[4]、[5]

見出し辞書に関するオプション[1]

見出し辞書のグループ設定[1]、[2]

見出し辞書の指定[1]

見出し辞書の使用[1]

見出し辞書の設定方法[1]、[2]

見出し辞書の変更[1]

見出し辞書の編集[1]、[2]

見出し辞書〔用語解説〕[1]

見出し辞書を編集する操作[1]、[2]

見出し情報[1]、[2]

見出し情報作成時に定義する項目の一覧[1]、[2]

見出し情報の一括登録[1]、[2]

見出し情報の削除[1]、[2]

見出し情報の作成[1]、[2]

見出し情報の編集[1]、[2]

見出し情報を作成する操作[1]、[2]

見出し情報を編集する操作[1]、[2]

見出し情報を読み込む[1]、[2]

見出しテキストの作成[1]

見出しテキスト〔用語解説〕[1]

見出し変更ツール[1]

め

メッセージの一覧[1]

メッセージの形式[1]

メッセージの詳細[1]

メッセージのファイル出力に関する設定[1]

メニューの活性／非活性に関する設定[1]

も

文字パターンの指定方法（ODBC）[1]

ゆ

優先順位を変更する[1]

り

利用者の設定[1]

れ

列一覧〔用語解説〕[1]

列演算条件式の設定[1]

列詳細定義[1]

列選択をした状態での更新に関する設定[1]

列属性と使用する定数（ODBC）[1]

列属性と使用できる集合関数の組み合わせ（ODBC）[1]

列属性に対応するデータ型（HiRDB）[1]

列属性に対応するデータ型（ORACLE）[1]

列注釈の定義[1]

列定義[1]

列定義の終了後に定義できる詳細情報[1]

列と条件を設定するときの規則[1]

列の属性と長さ及びデータ型との対応（ODBC接続の場合）[1]

列のデータをソートする[1]

列名〔用語解説〕[1]

列を削除する[1]

列を挿入する[1]

列を追加する[1]

連携先に転送する[1]

わ

ワイルドカード〔用語解説〕[1]