Hitachi Advanced Data Binder コマンドリファレンス

3000-6-503-Q0

前書き

著作権

All Rights Reserved. Copyright (C) 2012, 2024, Hitachi, Ltd.

輸出時の注意

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

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

商標類

HITACHI，HAモニタ，HiRDB，JP1は，株式会社 日立製作所の商標または登録商標です。

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

1. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)

2. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

3. This product includes software written by Tim Hudson (tjh@cryptsoft.com).

4. 本製品には OpenSSL Toolkit ソフトウェアを OpenSSL License および Original SSLeay License に従い使用しています。OpenSSL License および Original SSLeay License は以下の通りです。

LICENSE ISSUES

==============

The OpenSSL toolkit stays under a double license, i.e. both the conditions of

the OpenSSL License and the original SSLeay license apply to the toolkit.

See below for the actual license texts.

OpenSSL License

---------------

/* ====================================================================

* Copyright (c) 1998-2019 The OpenSSL Project. All rights reserved.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

*

* 1. Redistributions of source code must retain the above copyright

* notice, this list of conditions and the following disclaimer.

*

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in

* the documentation and/or other materials provided with the

* distribution.

*

* 3. All advertising materials mentioning features or use of this

* software must display the following acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

*

* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to

* endorse or promote products derived from this software without

* prior written permission. For written permission, please contact

* openssl-core@openssl.org.

*

* 5. Products derived from this software may not be called "OpenSSL"

* nor may "OpenSSL" appear in their names without prior written

* permission of the OpenSSL Project.

*

* 6. Redistributions of any form whatsoever must retain the following

* acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit (http://www.openssl.org/)"

*

* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY

* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR

* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED

* OF THE POSSIBILITY OF SUCH DAMAGE.

* ====================================================================

*

* This product includes cryptographic software written by Eric Young

* (eay@cryptsoft.com). This product includes software written by Tim

* Hudson (tjh@cryptsoft.com).

*

*/

Original SSLeay License

-----------------------

/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)

* All rights reserved.

*

* This package is an SSL implementation written

* by Eric Young (eay@cryptsoft.com).

* The implementation was written so as to conform with Netscapes SSL.

*

* This library is free for commercial and non-commercial use as long as

* the following conditions are aheared to. The following conditions

* apply to all code found in this distribution, be it the RC4, RSA,

* lhash, DES, etc., code; not just the SSL code. The SSL documentation

* included with this distribution is covered by the same copyright terms

* except that the holder is Tim Hudson (tjh@cryptsoft.com).

*

* Copyright remains Eric Young's, and as such any Copyright notices in

* the code are not to be removed.

* If this package is used in a product, Eric Young should be given attribution

* as the author of the parts of the library used.

* This can be in the form of a textual message at program startup or

* in documentation (online or textual) provided with the package.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

* 1. Redistributions of source code must retain the copyright

* notice, this list of conditions and the following disclaimer.

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in the

* documentation and/or other materials provided with the distribution.

* 3. All advertising materials mentioning features or use of this software

* must display the following acknowledgement:

* "This product includes cryptographic software written by

* Eric Young (eay@cryptsoft.com)"

* The word 'cryptographic' can be left out if the rouines from the library

* being used are not cryptographic related :-).

* 4. If you include any Windows specific code (or a derivative thereof) from

* the apps directory (application code) you must include an acknowledgement:

* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"

*

* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND

* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE

* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

* SUCH DAMAGE.

*

* The licence and distribution terms for any publically available version or

* derivative of this code cannot be changed. i.e. this code cannot simply be

* copied and put under another distribution licence

* [including the GNU Public Licence.]

*/

■Double precision SIMD-oriented Fast Mersenne Twister (dSFMT)

Copyright (c) 2007, 2008, 2009 Mutsuo Saito, Makoto Matsumoto

and Hiroshima University.

Copyright (c) 2011, 2002 Mutsuo Saito, Makoto Matsumoto, Hiroshima

University and The University of Tokyo.

All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions are

met:

* Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above

copyright notice, this list of conditions and the following

disclaimer in the documentation and/or other materials provided

with the distribution.

* Neither the name of the Hiroshima University nor the names of

its contributors may be used to endorse or promote products

derived from this software without specific prior written

permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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

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

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Azure

Microsoft Azure

Windows

Windows 10

Windows 10 x86

Windows(R) 10 Pro 日本語版(32ビット版)

Windows(R) 10 Enterprise 日本語版(32ビット版)

Windows 10 x64

Windows(R) 10 Pro 日本語版(64ビット版)

Windows(R) 10 Enterprise 日本語版(64ビット版)

Windows 11

Windows(R) 11 Pro 日本語版

Windows(R) 11 Enterprise 日本語版

Windows Server 2012

Windows Server(R) 2012 Standard 日本語版

Windows Server(R) 2012 Datacenter 日本語版

Windows Server 2012 R2

Windows Server(R) 2012 R2 Standard 日本語版

Windows Server(R) 2012 R2 Datacenter 日本語版

Windows Server 2016

Windows Server(R) 2016 Standard 日本語版

Windows Server(R) 2016 Datacenter 日本語版

Windows Server 2019

Windows Server(R) 2019 Standard 日本語版

Windows Server(R) 2019 Datacenter 日本語版

Windows Server 2022

Windows Server(R) 2022 Standard 日本語版

Windows Server(R) 2022 Datacenter 日本語版

発行

2024年7月

変更内容

変更内容(3000-6-503-Q0)　Hitachi Advanced Data Binder　05-10

追加・変更内容

変更個所

次のコマンドの各処理で使用する処理リアルスレッド数の情報を追記しました。

adbarchivechunkコマンド

adbexportコマンド

adbgetcstコマンド

adbidxrebuildコマンド

adbimportコマンド

adbmergechunkコマンド

adbunarchivechunkコマンド

2.1.2，14.1.2，15.1.3，16.1.4，17.1.3，35.1.2，47.1.2

HADBが使用できるデータ型にBIGINT型を追加しました。

2.2.1(4)(f)，13.2.1(4)(f)，14.5.3，17.5.3，42.6.1(1)，42.6.3，42.7.2，47.2.1(4)(f)

次のコマンドの実行時に作成される作業用一時ファイルの総容量を削減しました。

adbimportコマンド

adbidxrebuildコマンド

adbmergechunkコマンド

adbunarchivechunkコマンド

adbreorgsystemdataコマンド

それに伴い，次のコマンドの再実行機能の適用範囲が変わりました。

adbimportコマンド

adbidxrebuildコマンド

16.1.3(1)，16.5.3(2)，16.5.4(2)，17.1.2(2)，17.10.3，17.10.5

クラウドストレージ機能の使用時，キャッシュファイルの格納先ディレクトリ下の領域に複数の仮想のグループ（キャッシュグループ）を定義できるようにしました。

18.3，22.3，37.5.3

AWS環境でクラウドストレージ機能を使用する場合に，adbinitコマンドに指定するS3バケット名には，汎用バケットおよびディレクトリバケットのどちらのバケット名も指定できるという説明を追加しました。

20.2.2(2)(a)

adbunarchivechunkコマンドが異常終了したときの，中断タイミングごとの表とインデクスの状態についての説明を変更しました。

47.5.2

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

はじめに

このマニュアルは，Hitachi Advanced Data Binderで使用するコマンドの文法について説明しています。

なお，このマニュアル中，および製品が出力する情報中（メッセージ，コマンドの出力結果など）では，Hitachi Advanced Data BinderをHADBと表記することがあります。

対象製品

P-8462-C611 Hitachi Advanced Data Binder 05-10　（適用OS：Red Hat Enterprise Linux Server 7（64-bit x86_64），Red Hat Enterprise Linux Server 8（64-bit x86_64））

P-8862-C811 Hitachi Advanced Data Binder 05-10　（適用OS：Red Hat Enterprise Linux Server 9（64-bit x86_64））

P-9W62-C311 Hitachi Advanced Data Binder Client 05-10　（適用OS：Red Hat Enterprise Linux Server 7（64-bit x86_64），Red Hat Enterprise Linux Server 8（64-bit x86_64），Red Hat Enterprise Linux Server 9（64-bit x86_64））

P-2462-C114 Hitachi Advanced Data Binder Client 05-10　（適用OS：Windows 10，Windows 11，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016，Windows Server 2019，Windows Server 2022）

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。

対象読者

このマニュアルは，HADBのシステム設計・構築者およびシステム管理者を対象にしています。

なお，このマニュアルは次に示す知識があることを前提に説明しています。

LinuxおよびWindowsのシステム管理の基本的な知識

RDBMSの運用管理の基本的な知識

SQLの基本的な知識

マニュアルの構成

このマニュアルは，次に示す章から構成されています。

第1章　コマンドの一覧と共通規則

HADBのコマンドの一覧，コマンドの指定形式および共通規則について説明しています。

第2章　adbarchivechunk（チャンクのアーカイブ）

adbarchivechunkコマンドの機能と使い方について説明しています。

第3章　adbaudittrail（監査証跡機能の管理）

adbaudittrailコマンドの機能と使い方について説明しています。

第4章　adbcancel（トランザクションまたはコマンドの強制終了）

adbcancelコマンドの機能と使い方について説明しています。

第5章　adbchgchunkcomment（チャンクのコメントの設定・変更・削除）

adbchgchunkcommentコマンドの機能と使い方について説明しています。

第6章　adbchgchunkstatus（チャンクの状態変更）

adbchgchunkstatusコマンドの機能と使い方について説明しています。

第7章　adbchgnodetype（HADBサーバのノード種別の変更）

adbchgnodetypeコマンドの機能と使い方について説明しています。

第8章　adbchgsqltrc（SQLトレース情報の出力開始・停止）

adbchgsqltrcコマンドの機能と使い方について説明しています。

第9章　adbchgsrvmode（HADBサーバの稼働モードの変更）

adbchgsrvmodeコマンドの機能と使い方について説明しています。

第10章　adbclientdefmang（クライアント定義の集中管理）

adbclientdefmangコマンドの機能と使い方について説明しています。

第11章　adbcolumnize（更新行のカラム化機能の管理）

adbcolumnizeコマンドの機能と使い方について説明しています。

第12章　adbconvertaudittrailfile（監査証跡ファイルの変換）

adbconvertaudittrailfileコマンドの機能と使い方について説明しています。

第13章　adbdbstatus（データベースの状態解析）

adbdbstatusコマンドの機能と使い方について説明しています。

第14章　adbexport（データのエクスポート）

adbexportコマンドの機能と使い方について説明しています。

第15章　adbgetcst（コスト情報の収集）

adbgetcstコマンドの機能と使い方について説明しています。

第16章　adbidxrebuild（インデクスの再作成）

adbidxrebuildコマンドの機能と使い方について説明しています。

第17章　adbimport（データのインポート）

adbimportコマンドの機能と使い方について説明しています。

第18章　adbinfoget（トラブルシュート情報の取得）

adbinfogetコマンドの機能と使い方について説明しています。

第19章　adbinfosweep（トラブルシュート情報の削除）

adbinfosweepコマンドの機能と使い方について説明しています。

第20章　adbinit（データベースの初期設定）

adbinitコマンドの機能と使い方について説明しています。

第21章　adbinstall（HADBサーバおよびHADBクライアントのインストール）

adbinstallコマンドの機能と使い方について説明しています。

第22章　adbls -d cfm（キャッシュファイルの情報表示）

adbls -d cfmコマンドの機能と使い方について説明しています。

第23章　adbls -d cltgrp（クライアントグループ・コマンドグループの情報表示）

adbls -d cltgrpコマンドの機能と使い方について説明しています。

第24章　adbls -d cnct（コネクションの状態表示）

adbls -d cnctコマンドの機能と使い方について説明しています。

第25章　adbls -d gbuf（グローバルバッファの情報表示）

adbls -d gbufコマンドの機能と使い方について説明しています。

第26章　adbls -d lbuf（ローカル作業表用バッファの情報表示）

adbls -d lbufコマンドの機能と使い方について説明しています。

第27章　adbls -d lock（排他資源の状態表示）

adbls -d lockコマンドの機能と使い方について説明しています。

第28章　adbls -d mem（メモリの使用状況の表示）

adbls -d memコマンドの機能と使い方について説明しています。

第29章　adbls -d node（各ノードのHADBサーバの状態表示）

adbls -d nodeコマンドの機能と使い方について説明しています。

第30章　adbls -d prl（SQLパラレル実行機能の情報表示）

adbls -d prlコマンドの機能と使い方について説明しています。

第31章　adbls -d shm（共有メモリの情報表示）

adbls -d shmコマンドの機能と使い方について説明しています。

第32章　adbls -d srv（HADBサーバの状態表示）

adbls -d srvコマンドの機能と使い方について説明しています。

第33章　adbls -d thd（スレッドの状態表示）

adbls -d thdコマンドの機能と使い方について説明しています。

第34章　adbls -d ver（HADBサーバのバージョン情報の表示）

adbls -d verコマンドの機能と使い方について説明しています。

第35章　adbmergechunk（チャンクのマージ）

adbmergechunkコマンドの機能と使い方について説明しています。

第36章　adbmkdmk（HADB暗号鍵の作成）

adbmkdmkコマンドの機能と使い方について説明しています。

第37章　adbmodarea（DBエリアの追加・変更）

adbmodareaコマンドの機能と使い方について説明しています。

第38章　adbmodbuff（バッファの変更）

adbmodbuffコマンドの機能と使い方について説明しています。

第39章　adbmonitor（HADBサーバの監視）

adbmonitorコマンドの機能と使い方について説明しています。

第40章　adboptinstall（HADBオプションのインストールおよびアンインストール）

adboptinstallコマンドの機能と使い方について説明しています。

第41章　adbreorgsystemdata（システム表の再編成）

adbreorgsystemdataコマンドの機能と使い方について説明しています。

第42章　adbsql（SQLの実行）

adbsqlコマンドの機能と使い方について説明しています。

第43章　adbstart（HADBサーバの開始）

adbstartコマンドの機能と使い方について説明しています。

第44章　adbstat（HADBサーバの統計解析）

adbstatコマンドの機能と使い方について説明しています。

第45章　adbstop（HADBサーバの終了）

adbstopコマンドの機能と使い方について説明しています。

第46章　adbsyndict（同義語辞書の管理）

adbsyndictコマンドの機能と使い方について説明しています。

第47章　adbunarchivechunk（チャンクのアンアーカイブ）

adbunarchivechunkコマンドの機能と使い方について説明しています。

第48章　adbupddmk（HADB暗号鍵の更新）

adbupddmkコマンドの機能と使い方について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

Hitachi Advanced Data Binder システム構築・運用ガイド（3000-6-501）

Hitachi Advanced Data Binder AP開発ガイド（3000-6-502）

Hitachi Advanced Data Binder SQLリファレンス（3000-6-504）

Hitachi Advanced Data Binder メッセージ（3000-6-505）

Hitachi Code Converter（UNIX編）（3020-7-358）

高信頼化システム監視機能 HAモニタ Linux(R)(x86)編（3000-9-201）

高信頼化システム監視機能 HAモニタ パブリッククラウド編（3000-9-204）

JP1 Version 11 JP1/Base 運用ガイド（3021-3-A01）

JP1 Version 11 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-B14）

JP1 Version 11 JP1/Audit Management - Manager 構築・運用ガイド（3021-3-A17）

JP1 Version 12 JP1/Base 運用ガイド（3021-3-D65）

JP1 Version 12 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-D23）

なお，Hitachi Advanced Data Binderのマニュアルを本文中で参照させる場合は，Hitachi Advanced Data BinderをHADBと表記します。

（例）　HADB　システム構築・運用ガイド

また，HAモニタのマニュアルを本文中で参照させる場合は，次のように表記します。

高信頼化システム監視機能 HAモニタ Linux(R)(x86)編をHAモニタ Linux(R)(x86)編と表記します。

（例）　HAモニタ Linux(R)(x86)編

高信頼化システム監視機能 HAモニタ パブリッククラウド編をHAモニタ パブリッククラウド編と表記します。

（例）　HAモニタ パブリッククラウド編

JP1/Baseのマニュアルを本文中で参照させる場合は，JP1 Version 11 JP1/Base 運用ガイドまたはJP1 Version 12 JP1/Base 運用ガイドをJP1/Base　運用ガイドと表記します。

（例）　JP1/Base　運用ガイド

JP1/AJS3のマニュアルを本文中で参照させる場合は，JP1 Version 11 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）またはJP1 Version 12 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）をJP1/AJS3　設計ガイド（業務設計編）と表記します。

（例）　JP1/AJS3　設計ガイド（業務設計編）

JP1/Auditのマニュアルを本文中で参照させる場合は，JP1 Version 11 JP1/Audit Management - Manager 構築・運用ガイドをJP1/Audit　構築・運用ガイドと表記します。

（例）　JP1/Audit　構築・運用ガイド

このマニュアルで使用する製品名・機能名

このマニュアルでは，製品名を次のように表記しています。

表記

製品名

HADB

HADBサーバ

Hitachi Advanced Data Binder

HADBクライアント

Hitachi Advanced Data Binder Client

Linux

RHEL 7

Red Hat Enterprise Linux Server 7（64-bit x86_64）

RHEL 8

Red Hat Enterprise Linux Server 8（64-bit x86_64）

RHEL 9

Red Hat Enterprise Linux Server 9（64-bit x86_64）

HDLM

Hitachi Dynamic Link Manager Software

Hitachi Code Converter

Hitachi Code Converter - Runtime for C/COBOL（64）

JP1/AJS3

JP1/Automatic Job Management System 3

JP1/Audit

JP1/Audit Management - Manager

このマニュアルで使用する英略語

このマニュアルで使用する英略語を次に示します。

英略語

英字での表記

AD

Active Directory

Amazon S3

Amazon Simple Storage Service

AP

Application Program

APD

Application Parameter Descriptor

API

Application Programming Interface

ARD

Application Row Descriptor

AWS

Amazon Web Services

BI

Business Intelligence

BLOB

Binary Large Object

BNF

Backus-Naur Form

BOM

Byte Order Mark

CLI

Call Level Interface

CLOB

Character Large Object

CPU

Central Processing Unit

CSV

Character-Separated Values

DB

Database

DBMS

Database Management System

DMMP

Device Mapper Multipath

DNS

Domain Name System

DRBD

Distributed Replicated Block Device

EBS

Amazon Elastic Block Store

EC2

Amazon Elastic Compute Cloud

EFS

Amazon Elastic File System

ELF

Executable and Linking Format

ER

Entity Relationship

HBA

Host Bus Adapter

HDD

Hard Disk Drive

ID

Identification number

IEF

Integrity Enhancement Facility

IP

Internet Protocol

IPD

Implementation Parameter Descriptor

IRD

Implementation Row Descriptor

JAR

Java Archive File

JDBC

Java Database Connectivity

JDK

Java Developer's Kit

JNDI

Java Naming and Directory Interface

JRE

Java Runtime Environment

JSON

JavaScript Object Notation

JTA

Java Transaction API

LDAP

Lightweight Directory Access Protocol

LOB

Large Object

LRU

Least Recently Used

LV

Logical Volume

LVM

Logical Volume Manager

LWP

Light Weight Process

MSDN

Microsoft Developer Network

NFS

Network File System

NIC

Network Interface Card

NTP

Network Time Protocol

ODBC

Open Database Connectivity

OS

Operating System

OSS

Open Source Software

PAM

Pluggable Authentication Module

PP

Program Product

PV

Physical Volume

PVC

Persistent Volume Claim

RAID

Redundant Array of Independent Disks

RDBMS

Relational Database Management System

SELinux

Security-Enhanced Linux

SSD

Solid State Drive

SSSD

System Security Services Daemon

TLB

Translation Lookaside Buffer

URL

Uniform Resource Locator

VG

Volume Group

VPC

Amazon Virtual Private Cloud

WWN

World Wide Name

XFS

Extents File System

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

サーバ定義などのオペランド，およびコマンドの説明で使用している記号を次に示します。

なお，これらの記号は説明のために使用している記号のため，オペランドまたはコマンド中に記述しないでください。

記号

意味

例

〔　〕

この記号で囲まれている項目は省略できます。

adbsql 〔-V〕

この例の場合，adbsqlと指定してもよいし，adbsql -Vと指定してもよいことを意味しています。

｛　｝

この記号で囲まれている複数の項目のうちから，1つを選択できます。

adbcancel ｛--ALL｜-u コネクションID｝

この例の場合，--ALLまたは-u コネクションIDのどちらかを指定できることを意味しています。

…

この記号の直前の項目を繰り返し指定できます。

adbbuff -n DBエリア名〔，DBエリア名〕…

この例の場合，DBエリア名を繰り返し指定できることを意味しています。

｛｛　｝｝

この記号で囲まれた複数の項目を1つの単位として，繰り返し指定できます。

｛｛adbinitdbarea -n データ用DBエリア名｝｝

この例の場合，「adbinitdbarea -n データ用DBエリア名」を繰り返し指定できることを意味しています。

＿

（下線）

この記号で示す項目は，省略時の解釈値です。

adb_import_errmsg_lv = ｛0｜1｝

この例の場合，オペランドの指定を省略したとき，0が仮定されることを意味しています。

〜

この記号のあとに，指定値の属性を説明しています。

adb_sys_max_users = 最大同時接続数

　〜〈整数〉((1〜1,024))《10》

この例の場合，1〜1,024の整数が指定できます。オペランドの指定を省略した場合は，10が仮定されます。

〈　〉

指定値の種別を説明しています。

((　))

指定値の範囲を説明しています。

《　》

省略値を説明しています。

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

構文要素記号

意味

〈パス名〉

パス名には次に示す文字が使用できます。

OSがLinuxの場合

英字，数字，#，-，/，@，_

OSがWindowsの場合

英字，数字，#，-，/，@，_，¥，:

ただし，OSによって使用できる文字が異なります。

〈OSパス名〉

OSパス名には，OSでパス名として使用できるすべての文字が使用できます。使用できる文字の詳細については，OSのマニュアルを参照してください。

〈文字列〉

任意の文字列を指定できます。

〈単位付き整数〉

数字（0～9）の末尾に，MB（メガバイト），GB（ギガバイト），またはTB（テラバイト）のどれかの単位を付けた形式で指定します。数字と単位の間に空白を入れることはできません。

指定例

1024MB

512GB

32TB

エラーになる指定例

512 GB

注　すべて半角文字を使用してください。

このマニュアルで使用する計算式の記号

このマニュアルで使用する計算式の記号の意味を次に示します。

記号

内容

↑　↑

計算結果の値を小数点以下で切り上げることを意味しています。

（例）↑34÷3↑の計算結果は12になります。

↓　↓

計算結果の値を小数点以下で切り捨てることを意味しています。

（例）↓34÷3↓の計算結果は11になります。

MAX

計算結果のうち，最も大きい値が有効になることを意味しています。

（例）MAX（3×6，4＋7）の計算結果は18になります。

MIN

計算結果のうち，最も小さい値が有効になることを意味しています。

（例）MIN（3×6，4＋7）の計算結果は11になります。

パス名の表記について

サーバディレクトリ（インストール時）のパスは，$INSTDIRと表記します。

サーバディレクトリ（運用時）のパスは，$ADBDIRと表記します。

DBディレクトリのパスは，$DBDIRと表記します。

クライアントディレクトリのパスは，%ADBCLTDIR%（HADBクライアントがWindows版の場合）または$ADBCLTDIR（HADBクライアントがLinux版の場合）と表記します。

HADB ODBCドライバトレースファイルの格納フォルダのパスは，%ADBODBTRCPATH%と表記します。

¥の表記について

本文中で使用されている¥は，Linux版の場合は半角のバックスラッシュを意味しています。

このマニュアルで使用するKB（キロバイト）などの単位表記

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト），1PB（ペタバイト），1EB（エクサバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイト，1,024⁵バイト，1,024⁶バイトです。

1　コマンドの一覧と共通規則

この章では，HADBのコマンドの一覧，コマンドの指定形式および共通規則について説明します。

1.1　コマンドの一覧

コマンドの一覧を次の2つの表に示します。

「表1‒1　コマンドの一覧（コマンドの実行条件）」

コマンドを実行できるOSユーザ，コマンドの実行時に必要な権限などを示しています。

「表1‒2　コマンドの一覧（システムデータだけのバックアップを使用したデータベースの回復）」

コマンド実行後に，システムデータだけのバックアップを使用したデータベースの回復ができるかどうかを示しています。

なお，マルチノード機能を使用している場合にコマンドを実行できるノード種別については，「1.2　マルチノード機能を使用している場合にコマンドを実行できるノード」を参照してください。

表1‒1　コマンドの一覧（コマンドの実行条件）

項番

機能

コマンド名

コマンドの実行条件

コマンドを実行できるOSユーザ

コマンドの実行時に必要な権限※1

コマンドを実行できるマシン

HADBサーバの状態

HADBサーバへの接続

1

インストール・環境設定

インストール

adbinstall

HADB管理者，およびHADBクライアントを管理するOSユーザ

−

HADBサーバ，およびHADBクライアント（Linux版）

停止中

×

2

HADBオプションのインストールおよびアンインストール

adboptinstall

HADB管理者

−

HADBサーバ

停止中

×

3

データベースの初期設定

adbinit

HADB管理者

−

HADBサーバ

停止中

×

4

DBエリアの追加・変更

adbmodarea

HADB管理者

−

HADBサーバ

稼働中

接続※2

5

バッファの変更

adbmodbuff

HADB管理者

−

HADBサーバ

稼働中

接続※2

6

HADBサーバの開始・終了

HADBサーバの開始

adbstart

HADB管理者

−

HADBサーバ

停止中

×

7

HADBサーバの終了

adbstop

HADB管理者

−

HADBサーバ

稼働中

×

8

データベースのメンテナンスとバックアップ

HADBサーバの稼働モードの変更

adbchgsrvmode

HADB管理者

−

HADBサーバ

稼働中

×

9

表データのインポートとエクスポート

実表へのデータのインポート

adbimport

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

インポート対象表に対するIMPORT TABLE権限

HADBサーバ

稼働中

接続※2

10

表のデータのエクスポート

adbexport

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

エクスポート対象表に対するEXPORT TABLE権限

HADBサーバ

稼働中

接続※2

11

インデクスのメンテナンス

インデクスの再作成

adbidxrebuild

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

インデクスが定義されている表に対するREBUILD INDEX権限

HADBサーバ

稼働中

接続※2

12

チャンクのメンテナンス

チャンクのマージ

adbmergechunk

HADB管理者，HADB管理グループに所属するOSユーザ

CONNECT権限

チャンクを定義している表に対するMERGE CHUNK権限

HADBサーバ

稼働中

接続※2

13

チャンクのアーカイブ

adbarchivechunk

HADB管理者，HADB管理グループに所属するOSユーザ

CONNECT権限

チャンクを定義している表に対するARCHIVE CHUNK権限

HADBサーバ

稼働中

接続※2

14

チャンクのアンアーカイブ

adbunarchivechunk

HADB管理者，HADB管理グループに所属するOSユーザ

CONNECT権限

チャンクを定義している表に対するUNARCHIVE CHUNK権限

HADBサーバ

稼働中

接続※2

15

チャンクの状態変更

adbchgchunkstatus

HADB管理者，HADB管理グループに所属するOSユーザ

CONNECT権限

チャンクを定義している表に対するCHANGE CHUNK STATUS権限

HADBサーバ

稼働中

接続※2

16

チャンクのコメントの設定・変更・削除

adbchgchunkcomment

HADB管理者，HADB管理グループに所属するOSユーザ

CONNECT権限

チャンクを定義している表に対するCHANGE CHUNK COMMENT権限

HADBサーバ

稼働中

接続※2

17

システム表（実表）のメンテナンス

システム表（実表）の再編成

adbreorgsystemdata

HADB管理者

−

HADBサーバ

稼働中

接続※2

18

HADBサーバの状態表示

クライアントグループ・コマンドグループの情報表示

adbls -d cltgrp

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

19

コネクションの状態表示

adbls -d cnct

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

20

グローバルバッファの情報表示

adbls -d gbuf

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

21

ローカル作業表用バッファの情報表示

adbls -d lbuf

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

22

排他資源の状態表示

adbls -d lock

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

23

メモリの使用状況の表示

adbls -d mem

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

24

共有メモリの情報表示

adbls -d shm

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

25

HADBサーバの状態表示

adbls -d srv

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

◎

×

26

スレッドの状態表示

adbls -d thd

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

27

バージョン情報の表示

adbls -d ver

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

◎

×

28

SQL文の実行

標準入力やファイルからのSQL文の実行

adbsql

制限はありません

CONNECT権限

実行するSQL文に必要なアクセス権限

HADBサーバ，およびHADBクライアント（Linux版）

稼働中

クライアント接続

29

辞書の管理

同義語辞書の登録・削除など

adbsyndict

HADB管理者

−

HADBサーバ

稼働中

接続※2

30

情報収集・解析

データベースの状態解析

adbdbstatus

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

稼働中

接続※2

31

コスト情報の収集

adbgetcst

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

コスト情報を収集する表に対するGET COSTINFO権限

HADBサーバ

稼働中

接続※2

32

HADBサーバの稼働情報の表示

adbstat

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

稼働中

×

33

SQLトレース情報の出力開始・停止

adbchgsqltrc

HADB管理者

−

HADBサーバ

稼働中

×

34

トラブルシュート

トランザクションまたはコマンドの強制終了

adbcancel

HADB管理者

−

HADBサーバ

稼働中

×

35

トラブルシュート情報の取得

adbinfoget

HADB管理者

−

HADBサーバ

◎※4

×

36

トラブルシュート情報の削除

adbinfosweep

HADB管理者

−

HADBサーバ

停止中

×

37

マルチノード機能

各ノードのHADBサーバの状態表示

adbls -d node

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

38

SQLパラレル実行機能の情報表示

adbls -d prl

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

39

ノード種別の変更

adbchgnodetype

HADB管理者

−

HADBサーバ

稼働中

×

40

HADBサーバの監視

adbmonitor

HADB管理者

−

HADBサーバ

稼働中

×

41

クライアント定義の集中管理機能

クライアント定義の集中管理

adbclientdefmang

HADB管理者

DBA権限

CONNECT権限

HADBサーバ

稼働中

接続

42

監査証跡機能

監査証跡機能の管理

adbaudittrail

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

監査管理権限

監査参照権限※3

HADBサーバ

稼働中

接続

43

監査証跡ファイルの変換

adbconvertaudittrailfile

HADB管理者，およびHADB管理グループに所属するOSユーザ

CONNECT権限

監査参照権限

HADBサーバ

稼働中

接続

44

更新行のカラム化機能

更新行のカラム化機能の管理

adbcolumnize

HADB管理者

−

HADBサーバ

稼働中

×

45

DBエリア暗号化機能

HADB暗号鍵の作成

adbmkdmk

HADB管理者

暗号管理権限

CONNECT権限

HADBサーバ

稼働中

接続※2

46

HADB暗号鍵の更新

adbupddmk

HADB管理者

暗号管理権限

CONNECT権限

HADBサーバ

稼働中

接続

47

クラウドストレージ機能

キャッシュファイルの情報表示

adbls -d cfm

HADB管理者，およびHADB管理グループに所属するOSユーザ

−

HADBサーバ

○

×

（凡例）

−：該当しません。

稼働中：HADBサーバが稼働中のときにコマンドを実行できます。

停止中：HADBサーバが停止中のときにコマンドを実行できます。

◎：HADBサーバの稼働中，停止中に関係なくコマンドを実行できます。

○：HADBサーバの稼働中，HADBサーバが異常終了してから再開始するまでの間，またはadbinfosweepコマンドでトラブルシュート情報を削除するまでの間に実行できます。

接続：コマンド実行時にHADBサーバに接続します。

クライアント接続：HADBクライアントとしてHADBサーバに接続します。

×：HADBサーバに接続しません。

注※1

各コマンドの-uオプションに，この権限を持つHADBユーザの認可識別子を指定します。

注※2

HADBクライアントだけでなく，HADBサーバに接続するコマンドについても，HADBサーバへの接続数の考慮が必要です。

HADBサーバに接続するコマンドの同時接続については，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点を参照してください。

注※3

監査管理権限を持たないで監査参照権限を持っているHADBユーザは，-dオプションを指定したadbaudittrailコマンドだけ実行できます。それ以外のオプションを指定してadbaudittrailコマンドを実行する場合は，監査管理権限が必要です。

注※4

adbinfogetコマンドに-gオプションを指定する場合は，HADBサーバの稼働中に実行してください。

システムデータだけのバックアップを使用したデータベースの回復について，次の表に示します。

表1‒2　コマンドの一覧（システムデータだけのバックアップを使用したデータベースの回復）

項番

機能

コマンド名

システムデータだけのバックアップを使用したデータベースの回復

1

インストール・環境設定

インストール

adbinstall

○

2

HADBオプションのインストールおよびアンインストール

adboptinstall

○

3

データベースの初期設定

adbinit

×

4

DBエリアの追加・変更

adbmodarea

×

5

バッファの変更

adbmodbuff

○

6

HADBサーバの開始・終了

HADBサーバの開始

adbstart

○

7

HADBサーバの終了

adbstop

○

8

データベースのメンテナンスとバックアップ

HADBサーバの稼働モードの変更

adbchgsrvmode

○

9

表データのインポートとエクスポート

実表へのデータのインポート

adbimport

×

10

表のデータのエクスポート

adbexport

○

11

インデクスのメンテナンス

インデクスの再作成

adbidxrebuild

×

12

チャンクのメンテナンス

チャンクのマージ

adbmergechunk

×

13

チャンクのアーカイブ

adbarchivechunk

×

14

チャンクのアンアーカイブ

adbunarchivechunk

×

15

チャンクの状態変更

adbchgchunkstatus

×

16

チャンクのコメントの設定・変更・削除

adbchgchunkcomment

×

17

システム表（実表）のメンテナンス

システム表（実表）の再編成

adbreorgsystemdata

○

18

HADBサーバの状態表示

クライアントグループ・コマンドグループの情報表示

adbls -d cltgrp

○

19

コネクションの状態表示

adbls -d cnct

○

20

グローバルバッファの情報表示

adbls -d gbuf

○

21

ローカル作業表用バッファの情報表示

adbls -d lbuf

○

22

排他資源の状態表示

adbls -d lock

○

23

メモリの使用状況の表示

adbls -d mem

○

24

共有メモリの情報表示

adbls -d shm

○

25

HADBサーバの状態表示

adbls -d srv

○

26

スレッドの状態表示

adbls -d thd

○

27

バージョン情報の表示

adbls -d ver

○

28

SQL文の実行

標準入力やファイルからのSQL文の実行

adbsql

△

29

辞書の管理

同義語辞書の登録・削除など

adbsyndict

×

30

情報収集・解析

データベースの状態解析

adbdbstatus

○

31

コスト情報の収集

adbgetcst

○

32

HADBサーバの稼働情報の表示

adbstat

○

33

SQLトレース情報の出力開始・停止

adbchgsqltrc

○

34

トラブルシュート

トランザクションまたはコマンドの強制終了

adbcancel

○

35

トラブルシュート情報の取得

adbinfoget

○

36

トラブルシュート情報の削除

adbinfosweep

○

37

マルチノード機能

各ノードのHADBサーバの状態表示

adbls -d node

○

38

SQLパラレル実行機能の情報表示

adbls -d prl

○

39

ノード種別の変更

adbchgnodetype

○

40

HADBサーバの監視

adbmonitor

○

41

クライアント定義の集中管理機能

クライアント定義の集中管理

adbclientdefmang

○

42

監査証跡機能

監査証跡機能の管理

adbaudittrail

○

43

監査証跡ファイルの変換

adbconvertaudittrailfile

○

44

更新行のカラム化機能

更新行のカラム化機能の管理

adbcolumnize

×

45

DBエリア暗号化機能

HADB暗号鍵の作成

adbmkdmk

○

46

HADB暗号鍵の更新

adbupddmk

×

47

クラウドストレージ機能

キャッシュファイルの情報表示

adbls -d cfm

○

（凡例）

○：HADBサーバのバージョンアップ後にこのコマンドを実行した場合でも，システムデータだけのバックアップを使用して，HADBサーバを旧バージョンに戻すことができます。

×：HADBサーバのバージョンアップ後にこのコマンドを実行した場合，システムデータだけのバックアップからではHADBサーバを旧バージョンに戻すことができません。この場合，HADBサーバを旧バージョンに戻すには，フルバックアップが必要になります。

△：次の操作だけをした場合は，システムデータだけのバックアップを使用して，HADBサーバを旧バージョンに戻すことができます。

SQL文（SELECT文，COMMIT文，ROLLBACK文）

すべてのadbsqlサブコマンド

システムデータだけのバックアップは，バージョンアップ前に取得していることを前提としています。

HADBサーバをバージョンアップする際のシステムデータだけのバックアップについては，マニュアルHADB　システム構築・運用ガイドのバージョンアップ前に実施することを参照してください。

1.2　マルチノード機能を使用している場合にコマンドを実行できるノード

マルチノード機能を使用している場合にコマンドを実行できるノードを次の表に示します。

なお，各コマンドの実行条件については，「1.1　コマンドの一覧」を参照してください。

表1‒3　マルチノード機能を使用している場合にコマンドを実行できるノード

項番

機能

コマンド名

コマンドを実行できるノード

プライマリノード

セカンダリノード

ワーカーノード

1

インストール・環境設定

インストール

adbinstall

○

○

○

2

HADBオプションのインストールおよびアンインストール

adboptinstall

○

○

○

3

データベースの初期設定

adbinit

○

○

○

4

DBエリアの追加・変更

adbmodarea

○

×

×

5

バッファの変更

adbmodbuff

○

×

×

6

HADBサーバの開始・終了

HADBサーバの開始

adbstart

○

○

○

7

HADBサーバの終了

adbstop

○

○※1

○※1

8

データベースのメンテナンスとバックアップ

HADBサーバの稼働モードの変更

adbchgsrvmode

○

×

×

9

表データのインポートとエクスポート

実表へのデータのインポート

adbimport

○

×

×

10

表のデータのエクスポート

adbexport

○

×

×

11

インデクスのメンテナンス

インデクスの再作成

adbidxrebuild

○

×

×

12

チャンクのメンテナンス

チャンクのマージ

adbmergechunk

○

×

×

13

チャンクのアーカイブ

adbarchivechunk

○

×

×

14

チャンクのアンアーカイブ

adbunarchivechunk

○

×

×

15

チャンクの状態変更

adbchgchunkstatus

○

×

×

16

チャンクのコメントの設定・変更・削除

adbchgchunkcomment

○

×

×

17

システム表（実表）のメンテナンス

システム表（実表）の再編成

adbreorgsystemdata

○

×

×

18

HADBサーバの状態表示

クライアントグループ・コマンドグループの情報表示

adbls -d cltgrp

○

○

○

19

コネクションの状態表示

adbls -d cnct

○

○

○

20

グローバルバッファの情報表示

adbls -d gbuf

○

○

○

21

ローカル作業表用バッファの情報表示

adbls -d lbuf

○

○

○

22

排他資源の状態表示

adbls -d lock

○

○

○

23

メモリの使用状況の表示

adbls -d mem

○

○

○

24

共有メモリの情報表示

adbls -d shm

○

○

○

25

HADBサーバの状態表示

adbls -d srv

○

○

○

26

スレッドの状態表示

adbls -d thd

○

○

○

27

バージョン情報の表示

adbls -d ver

○

○

○

28

SQL文の実行

標準入力やファイルからのSQL文の実行

adbsql

○

○

○

29

辞書の管理

同義語辞書の登録・削除など

adbsyndict

○

×

×

30

情報収集・解析

データベースの状態解析

adbdbstatus

○

×

×

31

コスト情報の収集

adbgetcst

○

×

×

32

HADBサーバの稼働情報の表示

adbstat

○

○

○

33

SQLトレース情報の出力開始・停止

adbchgsqltrc

○

○

○

34

トラブルシュート

トランザクションまたはコマンドの強制終了

adbcancel

○

○

○

35

トラブルシュート情報の取得

adbinfoget

○

○

○

36

トラブルシュート情報の削除

adbinfosweep

○

○

○

37

マルチノード機能

各ノードのHADBサーバの状態表示

adbls -d node

○

○

○

38

SQLパラレル実行機能の情報表示

adbls -d prl

○

○

○

39

ノード種別の変更

adbchgnodetype

×

○

×

40

HADBサーバの監視

adbmonitor

○

○

○

41

クライアント定義の集中管理機能

クライアント定義の集中管理

adbclientdefmang

○

×

×

42

監査証跡機能

監査証跡機能の管理

adbaudittrail

○

○※2

○※2

43

監査証跡ファイルの変換

adbconvertaudittrailfile

○

○

○

44

更新行のカラム化機能

更新行のカラム化機能の管理

adbcolumnize

○

×

×

45

DBエリア暗号化機能

HADB暗号鍵の作成

adbmkdmk

○

×

×

46

HADB暗号鍵の更新

adbupddmk

○

×

×

47

クラウドストレージ機能

キャッシュファイルの情報表示

adbls -d cfm

○

○

○

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※1

adbstopコマンドをセカンダリノードまたはワーカーノードで実行する場合は，--nodeオプションを指定してください。

注※2

指定するオプションによって，実行できるノードが異なります。詳細は「3.5　注意事項」の「表3‒3　指定するオプションとadbaudittrailコマンドを実行できるノードの対応」を参照してください。

1.3　コマンドの指定形式

コマンドの指定形式を次に示します。

コマンド名　オプション　コマンド引数

adbimportコマンドを例にして，コマンド名，オプション，コマンド引数を説明します。

adbimport　-u ADBUSER01　TABLE01　…
   [1]          [2]        [3]

［説明］

コマンド名です。実行するコマンドのコマンド名またはコマンドのパス名を指定します。

オプションです。オプションは1つのハイフン（-）または2つのハイフン（--）で始まる英数字の文字列です。

オプションはオプション引数を指定する必要があるオプションと，オプション引数を指定する必要がないオプションがあります。上記の例の場合，-uはオプション引数を指定する必要があるオプションで，ADBUSER01の部分がオプション引数になります。オプション引数はコンマ（ , ）で区切って指定できます。

コマンド引数です。

オプションおよびオプション引数に関する規則

オプションに指定する英大文字と英小文字は区別されます。

オプション引数を指定する必要があるオプションのオプション引数は省略できません。

オプション引数中に空白がある場合，オプション引数の前後を二重引用符（"）で囲む必要があります。

（例）adbimport -z "/home/import△option/env01.txt"

-zはパス名を指定するオプションです。パス名中に空白がある場合，上記のようにパス名を二重引用符（"）で囲みます。△は空白を意味しています。

オプション引数中に二重引用符（"）を含める場合は，前後をアポストロフィ（'）で囲む必要があります。

（例）adbsql -u '"adbuser01"'

同じオプションを2回以上指定した場合，最後に指定したオプションが有効になり，前に指定した同じオプションの指定は無効になります。

（例）adbcancel -u 1 -u 2

この場合，-u 2の指定が有効になります。

コマンドのUsageメッセージの表示方法（コマンドヘルプの表示方法）

-hまたは--helpを指定すると，コマンドの入力形式を説明するUsageメッセージが表示されます。

（例）

adbcancel -h

KFAA91250-I Usage: adbcancel {--ALL | -u <connection-identifier>}

コマンドのUsageメッセージで使用している記号の意味を次の表に示します。

表1‒4　コマンドのUsageメッセージで使用している記号の意味

項番

Usageメッセージで使用している記号

意味

1

{　}

{　}で囲まれている複数のオプションのうち，1つを選択できます。

2

｜

｜で区切られた項目はどちらかの項目を選択できます。

3

[　]

[　]で囲まれているオプションは省略できます。

4

<　>

<　>で囲まれている文字列は，オプション引数またはコマンド引数を意味しています。

5

-

オプション引数またはコマンド引数の文字列内の-は，単語間の区切り文字を意味しています。

1.4　コマンドの共通規則

1.4.1　共通規則

BOMが付いているファイルをコマンドの入力ファイルに指定できません。また，コマンドの実行によって出力されるファイルにBOMは付きません。

1.4.2　認可識別子およびパスワードの指定規則

コマンドの-uオプションに指定する認可識別子と，-pオプションに指定するパスワードの指定規則について説明します。

(1)　認可識別子の指定規則

-uオプションに指定する認可識別子の文字列中に英小文字がある場合は，認可識別子を¥"（バックスラッシュと二重引用符）で囲んでください。または，認可識別子を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲んでください。

（例1）-u ¥"ADBuser01¥"

（例2）-u '"ADBuser01"'

上記のように指定しないと，認可識別子の文字列はすべて英大文字と見なされます。例えば，「-u ADBuser01」と指定した場合，「-u ADBUSER01」と指定したと見なされます。

-uオプションに指定する認可識別子の文字列中に¥がある場合は，¥の直前にエスケープ文字（¥）を指定してください。または，認可識別子をアポストロフィ（'）で囲んでください。

（例1）-u ADBUSER¥¥01

（例2）-u 'ADBUSER¥01'

この場合，ADBUSER¥01が認可識別子として指定されます。

認可識別子の指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの認可識別子の指定規則を参照してください。

(2)　パスワードの指定規則

-uオプションオプションに指定する認可識別子とは異なり，-pオプションに指定するパスワードの指定は，英大文字と英小文字が区別されます。

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字がパスワードに含まれている場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，パスワードをアポストロフィ（'）で囲んでください。

（例1）-p Password¥|01

（例2）-p 'Password|01'

この場合，Password|01がパスワードとして指定されます。

パスワードの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドのパスワードの指定規則を参照してください。

(3)　認可識別子とパスワードの指定例

-uオプションと-pオプションでは，文字列中に英小文字が含まれているときの指定方法が異なります。指定例（adbarchivechunkコマンドの場合）を次に示します。

（例1）

認可識別子にADBUSER01，パスワードにPASSWORD01を指定する場合

adbarchivechunk -u ADBUSER01 -p PASSWORD01

（例2）

認可識別子にADBuser01，パスワードにPassword01を指定する場合

adbarchivechunk -u ¥"ADBuser01¥" -p Password01

（例3）

認可識別子にADBuser¥01，パスワードにPassword¥01を指定する場合

adbarchivechunk -u ¥"ADBuser¥¥01¥" -p Password¥¥01

1.4.3　表名の指定規則

コマンドの引数に表名を指定する際の指定規則について説明します。

(1)　表名に英小文字がある場合の指定規則

コマンドの引数に指定する表名に英小文字がある場合，次のどちらかの形式で指定してください。

スキーマ名および表識別子をそれぞれ¥"（バックスラッシュと二重引用符）で囲む

（例）表名が「ADBUser01.Table01」の場合

¥"ADBUser01¥".¥"Table01¥"

スキーマ名および表識別子をそれぞれ二重引用符（"）で囲み，さらに表名全体をアポストロフィ（'）で囲む

（例）表名が「ADBUser01.Table01」の場合

'"ADBUser01"."Table01"'

上記のように指定しないと，スキーマ名および表識別子の文字列はすべて英大文字と見なされます。例えば，「ADBUser01.Table01」と指定した場合，「ADBUSER01.TABLE01」と指定したと見なされます。

(2)　表名に¥がある場合の指定規則

コマンドの引数に指定する表名に¥（バックスラッシュ）がある場合，次のどちらかの形式で指定してください。

表名全体をアポストロフィ（'）で囲む

¥の直前にエスケープ文字（¥）を指定する

表名に英小文字がある場合は，1.の形式で指定してください。

（例1）表名が「ADBUser01.Table¥01」の場合

'"ADBUser01"."Table¥01"'

（例2）表名が「ADBUSER01.TABLE¥01」の場合

'ADBUSER01.TABLE¥01'またはADBUSER01.TABLE¥¥01

1.5　環境変数の設定

各コマンドの実行時に，必要に応じて次の表に示す環境変数を設定してください。

環境変数を設定する場合は，環境変数に設定した値がコマンド実行時のシェルで有効になるようにしてください。設定方法については，シェルのマニュアルを参照してください。

表1‒5　環境変数に設定する値

項番

環境変数

設定する値

1

ADB_DEFFILE_UNSUPPORTED_OPERAND_BEHAVIOR

この環境変数には，コマンドのオプションファイルに，サポートされていないオペランド名またはオプション名が指定されていた場合に，オプションファイルの解析処理でエラーにするかどうかを指定します。

通常は，この環境変数の指定は不要です。

この環境変数には，次のどちらかが指定できます。

ERROR：オプションファイルの解析処理をエラーにして，コマンド処理を終了します。

INFORMATION：オプションファイルの解析処理をエラーにしないで，コマンド処理を続行します。このとき，KFAA50073-Iメッセージが出力されます。

この環境変数を省略した場合，ERRORが仮定されます。

なお，一部のコマンドは，HADBサーバでオプションファイルの解析処理が行われます。その場合，コマンド処理の動作は，HADBサーバの環境変数ADB_DEFFILE_UNSUPPORTED_OPERAND_BEHAVIORの値に従います。そのため，コマンド処理の動作を一致させるために，この環境変数の値とHADBサーバの環境変数ADB_DEFFILE_UNSUPPORTED_OPERAND_BEHAVIORの値を同じにすることを推奨します。

HADBサーバの環境変数については，マニュアルHADB　システム構築・運用ガイドの環境変数の設定を参照してください。

1.6　コマンド実行時のディレクトリおよびファイルへのアクセスに関する注意事項

HADBサーバに接続するコマンドは，HADBサーバプロセスでコマンド処理が実行されます。その際，コマンド処理でディレクトリおよびファイルにアクセスするのは，HADBサーバプロセスの実行ユーザになります。そのため，コマンド処理でアクセスするディレクトリおよびファイルに対して，HADBサーバプロセスの実行ユーザがアクセスできるように権限を付与する必要があります。

メモ

HADBサーバに接続するコマンドとは，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「HADBサーバへの接続」列が「接続」になっているコマンドです。

HADBサーバプロセスの実行ユーザについては，マニュアルHADB　システム構築・運用ガイドのHADBサーバで起動するプロセスを参照してください。また，各コマンドで指定するディレクトリおよびファイルに対する権限の付与については，各コマンドの「注意事項」を参照してください。

1.7　コマンド実行時のメッセージに関する注意事項

コマンドの実行時に，コマンドの延長で実行されるSQL文が原因で，KFAA3から始まるエラーメッセージが出力されることがあります。

コマンドの実行時にKFAA3から始まるエラーメッセージが出力された場合は，出力されたメッセージの対策欄の「SQL文」を「コマンド」に読み替えて対応してください。出力されたメッセージの対策欄については，マニュアルHADB　メッセージを参照してください。

1.8　実行中のコマンドを中断（強制終了）する場合

実行中のコマンドを中断する場合は，adbcancelコマンドを実行してください。［Ctrl］＋［C］キーなどで，コマンドのコマンドプロセスを強制終了しても，コマンドの処理はサーバプロセスで続行されるため，コマンドは中断されません。

adbcancelコマンドで中断できるコマンドは，HADBサーバとコネクションを確立するコマンド（adbexportコマンドなど）だけです。

メモ

adbcancelコマンドについては，「4.　adbcancel（トランザクションまたはコマンドの強制終了）」を参照してください。

実行中のコマンドを中断する手順（adbexportコマンドを中断する例）を次に示します。

手順

adbls -d cnctコマンドを実行して，コネクションIDを確認する

実行中のadbexportコマンドのコネクションIDを確認します。

メモ

adbls -d cnctコマンドについては，「24.　adbls -d cnct（コネクションの状態表示）」を参照してください。

adbcancelコマンドを実行して，adbexportコマンドを中断する

adbcancel -u 16

-uオプションには，手順の1.で確認したコネクションIDを指定します。

重要

adbcancelコマンドを実行しても実行中のコマンドが終了しない場合は，HADBサーバを終了してください。HADBサーバを終了する手順については，マニュアルHADB　システム構築・運用ガイドのコマンドが終了しない場合の対処方法を参照してください。

2　adbarchivechunk（チャンクのアーカイブ）

この章では，adbarchivechunkコマンドの機能と使い方について説明します。

2.1　機能

adbarchivechunkコマンドの機能，および使用するスレッドについて説明します。

adbarchivechunkコマンドは，コマンド実行時にHADBサーバに接続します。

2.1.1　機能概要

adbarchivechunkコマンドを実行すると，表のデータをチャンク単位にアーカイブ（圧縮）できます。チャンク単位にデータをアーカイブする処理をチャンクのアーカイブ処理といいます。また，チャンク単位にデータをアーカイブできる表を，アーカイブマルチチャンク表といいます。

チャンクのアーカイブ処理を実行すると，対象となるチャンクのデータは圧縮されてファイル（アーカイブファイル）に格納されます。また，そのデータはDBエリアファイルから削除されます。

チャンクのアーカイブ処理の概要を次の図に示します。

図2‒1　adbarchivechunkコマンドの概要

［説明］

adbarchivechunkコマンドを実行すると，アーカイブマルチチャンク表の指定したチャンクに格納されたデータが検索されます。そのデータが，アーカイブディレクトリ下にアーカイブファイルとして格納されます。

アーカイブファイルが格納されたあと，DBエリアファイルから指定したチャンクのデータは削除されます。

なお，1回のadbarchivechunkコマンドの実行で，複数のチャンクをアーカイブすることもできます。複数のチャンクをアーカイブする場合は，チャンクの数だけ，格納処理および削除処理を繰り返します。

adbarchivechunkコマンドでアーカイブできるチャンク（アーカイブ対象のチャンク）を次に示します。

■アーカイブ対象のチャンク

通常状態のチャンク

ただし，カレントチャンクはアーカイブできません。

過去に通常状態になったことがある待機状態のチャンク

重要

チャンクをアーカイブすると，該当するチャンクのデータの検索処理の速度が低下するなどのデメリットがあります。この点をよく考慮した上で，チャンクをアーカイブするかどうかを決めてください。

チャンクのアーカイブの詳細については，マニュアルHADB　システム構築・運用ガイドのチャンクアーカイブ機能（チャンク内のデータの圧縮）を参照してください。

2.1.2　adbarchivechunkコマンドが使用するスレッドの関係

adbarchivechunkコマンドは，次の処理で処理リアルスレッドを使用します。

表データの検索

この処理では，「1～（ MAX_RTHD_NUM－1－↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，アーカイブチャンクオプションadb_arcv_rthd_numの指定値またはデフォルト値となります。アーカイブチャンクオプションadb_arcv_rthd_numのデフォルト値については，「2.2.2　アーカイブチャンクオプションの形式」の「(2)　指定形式の説明」にある，アーカイブチャンクオプションadb_arcv_rthd_numを参照してください。

アーカイブされるチャンクのデータの圧縮

この処理では，「1～（ ↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

コマンド実行時に指定したチャンクのデータの削除

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1と処理2は同時に実行されます。そのあとに，処理3が実行されます。処理4は，処理1～処理3の実行中，常に実行されます。

adbarchivechunkコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図2‒2　adbarchivechunkコマンドが処理リアルスレッドを使用する処理

2.2　adbarchivechunkコマンドの指定形式

adbarchivechunkコマンドの指定形式，およびアーカイブチャンクオプションの形式について説明します。

adbarchivechunkコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

2.2.1　指定形式およびオプションの説明

(1)　指定形式

adbarchivechunk
  -u 認可識別子
  〔-p パスワード〕
  〔-g チャンクのアーカイブ処理の経過メッセージの出力間隔〕
  〔-z アーカイブチャンクオプションファイル名〕
  〔-t〕
  ｛-c チャンクID指定〔,チャンクID指定〕…｜-r 範囲指定｝
  処理対象表

重要

処理対象表は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。adbarchivechunkコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するARCHIVE CHUNK権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbarchivechunkコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-g チャンクのアーカイブ処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

チャンクのアーカイブ処理の経過メッセージの出力間隔を指定します。

例えば，このオプションに2を指定すると，チャンクのアーカイブ処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。

なお，複数のチャンクに対してチャンクのアーカイブ処理を行う場合，経過メッセージはチャンクごとに出力されます。例えば，このオプションに2を指定していて，チャンクのアーカイブ処理を行うチャンクが3つある場合は，3つのチャンクそれぞれに対して，チャンクのアーカイブ処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。どのチャンクに対する処理かは，出力される経過メッセージでわかります。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-z アーカイブチャンクオプションファイル名

〜〈OSパス名〉((2〜510バイト))

アーカイブチャンクオプションを指定したアーカイブチャンクオプションファイルの絶対パス名を指定します。このオプションを省略すると，アーカイブチャンクオプションファイルが指定されないため，すべてのアーカイブチャンクオプションにデフォルト値が仮定されます。

アーカイブチャンクオプションについては，「2.2.2　アーカイブチャンクオプションの形式」を参照してください。

●-t

実際にチャンクのアーカイブ処理を行う前に，アーカイブされるチャンクを確認する場合に指定します。

このオプションを指定すると，-cオプション，または-rオプションで指定した範囲に該当するチャンクのうち，アーカイブされるチャンクのチャンクIDがKFAA80245-Iメッセージに出力されます。

これらのチャンクに対して，チャンクのアーカイブ処理を行う場合，-tオプション以外は同じ指定で（-tオプションを省略して）adbarchivechunkコマンドを実行してください。アーカイブするチャンクを見直す場合は，-cオプション，または-rオプションの指定値を修正したあとで，adbarchivechunkコマンドを実行してください。

重要

このオプションを指定した場合，チャンクのアーカイブ処理は実行されません。

●-c チャンクID指定〔,チャンクID指定〕…

〜〈整数〉((1〜9,223,372,036,854,775,807))

処理対象表中のチャンクのうち，アーカイブするチャンクのチャンクIDを指定します。1つ以上のチャンクIDを指定できます。

チャンクID指定は，次に示す方法で指定できます。なお，それぞれの方法を組み合わせて指定することができます。

図2‒3　-cオプションのチャンクID指定の例

チャンクIDを1つずつ指定する（単独指定）

アーカイブするチャンクのチャンクIDを1つずつ指定したい場合は，チャンクIDをコンマ（,）で区切って指定します。

重要

チャンクIDとコンマ（,）の間には空白を入れないでください。

チャンクIDの範囲を指定する（範囲指定）

アーカイブするチャンクのチャンクIDの範囲を指定したい場合は，「範囲の最小のチャンクID-範囲の最大のチャンクID」の形式で指定します（2つのチャンクIDをハイフン（-）でつなぎます）。

重要

ハイフン（-）とチャンクIDの間には空白を入れないでください。また，ハイフンの右側には，ハイフンの左側のチャンクIDより大きいチャンクIDを指定してください。

指定したチャンクIDのチャンクのうち，次に示すチャンクはアーカイブされません（処理対象表に存在するアーカイブ対象のチャンクだけ，アーカイブされます）。

処理対象表に存在しないチャンク

アーカイブ対象ではないチャンク

アーカイブ対象のチャンクについては，「2.1.1　機能概要」を参照してください。

このオプションの指定時の規則を次に示します。

チャンクIDは，最大30,000個指定できます。チャンクIDの数え方を次に示します。

・範囲指定の場合，範囲内のすべてのチャンクIDが個数に数えられます。

・指定したチャンクIDが重複している場合，重複した分も個数に数えられます。

チャンクID指定の例と数え方

（例1）-c 1,3,5：3個のチャンクID（1，3および5）を指定したと見なされます。

（例2）-c 1,3,5-8,10：7個のチャンクID（1，3，5，6，7，8および10）を指定したと見なされます。

（例3）-c 1,3,5,5-8,10：8個のチャンクID（1，3，5，5，6，7，8および10）を指定したと見なされます。

-cオプションに指定できる値の長さの上限は32キロバイトです。このため，チャンクID指定の長さが32キロバイトを超える場合は，範囲指定に変更するか，または複数回に分けて，adbarchivechunkコマンドを実行してください。

エラーとなる指定内容および指定例については，「(3)　-cオプションの指定が原因のエラー」を参照してください。

■処理対象表に存在するチャンクのチャンクIDの検索方法

処理対象表に存在するチャンクのチャンクIDの検索方法を次に示します。

システム表のSTATUS_CHUNKSを検索する

システム表のSTATUS_CHUNKSを検索し，チャンクIDを確認してください。

詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表のシステム表の検索の表名から表内の全チャンクの情報を調べる場合を参照してください。

adbdbstatusコマンドを実行する

次に示すコマンドを実行してDBエリア，表とインデクスの使用量情報を出力し，チャンクID（Chunk_ID）を確認してください（結果はCSV形式で出力されます）。DBエリア，表とインデクスの使用量情報で出力される項目の詳細については，「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」を参照してください。

adbdbstatus -d used -c table -n 処理対象表の表名

表名は「スキーマ名.表識別子」の形式で指定してください。

●-r 範囲指定

アーカイブするチャンクの範囲を指定します。-rオプションの詳細については，「(4)　-rオプション（範囲指定）の詳細」を参照してください。

●処理対象表

チャンクのアーカイブ処理の対象となるアーカイブマルチチャンク表を指定します。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

アーカイブマルチチャンク表以外の表は指定できません。

ARCHIVE CHUNK権限を持っている表を指定できます。

更新できる（更新不可状態ではない）表を指定してください。更新不可状態の表を指定するとエラーになります。

ビュー表は指定できません。

(3)　-cオプションの指定が原因のエラー

-cオプションの指定が原因でadbarchivechunkコマンドがエラーとなる場合には，次の2つが考えられます。

-cオプションの指定形式に誤りがある場合

-cオプションに不正なチャンクIDを指定している場合

どちらの場合も，指定を修正したあと，再度adbarchivechunkコマンドを実行してください。なお，-cオプションの詳細については，「(2)　オプションの説明」の「-c」を参照してください。

(a)　-cオプションの指定形式に誤りがある場合

-cオプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒1　オプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定したチャンクIDの個数が30,000個を超えている

-c 1-30001

-c 1-30000

2

ハイフン（-）の両側に同じチャンクIDを指定している

-c 3-3,7

-c 3-5,7

3

ハイフン（-）の右側に，左側のチャンクIDより小さいチャンクIDを指定している

-c 10-3

-c 3-10

4

KFAA90002-E

KFAA96830-I

チャンクIDとコンマ（,）の間に空白がある

-c 1,3,△10

-c 1,3,10

5

チャンクIDとハイフン（-）の間に空白がある

-c 1,3△-△10

-c 1,3-10

6

KFAA90003-E

指定値の長さが32キロバイトを超えている

-c 1-xxxxx

単独指定ではなく，範囲指定に変更する（コンマ（,）ではなくハイフン（-）を使用する）

（凡例）

△：空白

(b)　-cオプションに不正なチャンクIDを指定している場合

-cオプションに不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒2　不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例および対処方法

1

KFAA50284-E

指定したチャンクIDのチャンクすべてが処理対象表に存在しない

処理対象表に存在するチャンクのチャンクIDが2および6の場合

-c 3-5

-c 4,5

処理対象表に存在するチャンクのチャンクIDが2および6の場合

-c 2,6

-c 2-6

処理対象表に存在し，かつアーカイブ対象のチャンクのチャンクIDを指定してください。

注

処理対象表に存在するチャンクのチャンクIDを検索する方法については，「(2)　オプションの説明」の「-c」を参照してください。

(4)　-rオプション（範囲指定）の詳細

アーカイブするチャンクの範囲を，-rオプションで指定します。範囲指定に指定した範囲に，アーカイブレンジ列（アーカイブマルチチャンク表の検索時に，検索範囲を絞り込むために使用する列）の値の範囲が一部でも含まれている場合，該当するチャンクがアーカイブされます。ただし，指定した範囲のデータが格納されたチャンクのうち，アーカイブ対象ではないチャンクはアーカイブされません。アーカイブ対象のチャンクについては，「2.1.1　機能概要」を参照してください。

範囲指定は，アーカイブレンジ列のデータ型に基づき，解釈されます。

範囲指定の種類と詳細な説明の参照先を次の表に示します。

表2‒3　範囲指定の種類および参照先

項番

範囲指定の種類

参照先

1

日付の範囲指定

「(a)　日付の範囲指定」

2

時刻の範囲指定

「(b)　時刻の範囲指定」

3

時刻印の範囲指定

「(c)　時刻印の範囲指定」

4

固定長文字列の範囲指定

「(d)　固定長文字列の範囲指定」

5

10進数の範囲指定

「(e)　10進数の範囲指定」

6

整数の範囲指定

「(f)　整数の範囲指定」

7

浮動小数点数の範囲指定

「(g)　浮動小数点数の範囲指定」

次の条件の場合を例に，どのチャンクがアーカイブされるかについて示します。

アーカイブレンジ列のデータ型がDATE型

範囲指定に「2015/02/10〜2015/04/01」の日付の範囲を指定

図2‒4　日付の範囲指定の内容とアーカイブされるチャンクの関係

-rオプションの指定時の規則を次に示します。

範囲指定は，1つだけ指定できます。複数の範囲は指定できません。

範囲指定に1,024バイト以上指定した場合はKFAA90003-Eメッセージが出力されます。

このオプションには，シェルによる囲み文字などの解析後の値を指定してください。シェルの文字解析によっては，指定値と実際に解釈される値が異なることがあります。固定長文字列の範囲指定の例を次に示します。

オプションの指定値：-r 'abc'-'def'

実際に解釈される値：-r abc-def

実際に解釈される値はアポストロフィ（'）が取り除かれた値です。

(a)　日付の範囲指定

アーカイブするチャンクの範囲を日付で指定します。

形式

-r ｛YYYY-MM-DD｜YYYY/MM/DD｝-｛YYYY-MM-DD｜YYYY/MM/DD｝

最小値（日付指定）と最大値（日付指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

指定例

指定例1：-r 2016/01/01-2016/12/31

指定例2：-r 2016-01-01-2016-12-31

それぞれの日付は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。

指定例1の場合，2016/01/01，および2016/12/31が日付指定として扱われます。

指定例2の場合，2016-01-01，および2016-12-31が日付指定として扱われます。

日付の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」の桁数が足りない場合は，足りない分，左側に0を補ってください。

日付の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DATE型

TIMESTAMP型

日付の範囲指定では，日付だけを指定できます。アーカイブレンジ列のデータ型がTIMESTAMP型の場合，時刻の指定は省略されたものとして扱われます。そのため，次に示す表のとおりに開始時刻と終了時刻が補正されます。その結果，指定した日付の範囲指定内のデータが含まれるすべてのチャンクが，アーカイブする対象になります。

表2‒4　開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

0

0時0分0秒

23時59分59秒

2

3

0時0分0.000秒

23時59分59.999秒

3

6

0時0分0.000000秒

23時59分59.999999秒

4

9

0時0分0.000000000秒

23時59分59.999999999秒

5

12

0時0分0.000000000000秒

23時59分59.999999999999秒

日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒5　日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

日付の桁数が規定を超えている

日付の桁数が規定より不足している

-r 2015/7/1-2015/008/031

-r 2015/07/01-2015/08/31

2

範囲外の日付を指定している

-r 2015/01/01-2015/06/31

-r 2015/01/01-2015/06/30

3

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r 2015/01/11△-△2015/7/31

説明

日付指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 2015/01/11-2015/07/31

（凡例）

△：空白

(b)　時刻の範囲指定

アーカイブするチャンクの範囲を時刻で指定します。

形式

-r hh:mm:ss〔.〔nn...n〕〕-hh:mm:ss〔.〔nn...n〕〕

最小値（時刻指定）と最大値（時刻指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r 00:00:00-12:59:59

指定例2：-r 00:00:00.000-12:59:59.999

それぞれの時刻は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。

小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，00:00:00，および12:59:59が時刻指定として扱われます。

指定例2の場合，00:00:00.000，および12:59:59.999が時刻指定として扱われます。

時刻の範囲指定に関する規則を次に示します。

「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIME型

小数秒がTIME型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIME型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表2‒6　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIME型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒7　時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻の桁数が規定を超えている

時刻の桁数が規定より不足している

-r 0:0:0-012:59:59

-r 00:00:00-12:59:59

2

範囲外の時刻を指定している

-r 00:00:00-12:60:00

-r 00:00:00-12:59:59

3

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r 00:00:00△-△12:59:59

説明

時刻指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 00:00:00-12:59:59

（凡例）

△：空白

(c)　時刻印の範囲指定

アーカイブするチャンクの範囲を時刻印で指定します。

形式

-r '｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'
    -'｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'

最小値（時刻印指定）と最大値（時刻印指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

△：半角空白，またはタブ

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r '2016/01/01 00:00:00'-'2016/12/31 12:59:59'

指定例2：-r '2016/01/01 00:00:00.000'-'2016/12/31 12:59:59.999'

それぞれの時刻印は，日付指定と時刻指定を半角空白で結び，アポストロフィ（'）で囲んで指定してください。日付指定は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。時刻指定は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，2016/01/01 00:00:00，および2016/12/31 12:59:59が時刻印指定として扱われます。

指定例2の場合，2016/01/01 00:00:00.000，および2016/12/31 12:59:59.999が時刻印指定として扱われます。

時刻印の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」，「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻印の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIMESTAMP型

小数秒がTIMESTAMP型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIMESTAMP型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表2‒8　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻印指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒9　時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻印の桁数が規定を超えている

時刻印の桁数が規定より不足している

-r '2015/7/1△00:00:00'-'2015/008/031△12:59:59'

-r '2015/07/01△00:00:00'-'2015/08/31△12:59:59'

2

範囲外の時刻印を指定している

-r '2015/01/01△00:00:00'-'2015/06/31△12:60:00'

-r '2015/01/01△00:00:00'-'2015/06/30△12:59:59'

3

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r '2016/04/01△00:00:00'△-△'2016/06/30△12:59:59'

説明

時刻印指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r '2016/04/01△00:00:00'-'2016/06/30△12:59:59'

4

指定例

-r 2016/04/01△00:00:00-2016/06/30△12:59:59

説明

時刻印指定がアポストロフィ（'）で囲まれていないため，シェルが日付と時刻の間の空白でオプション引数を区切ってしまう

（凡例）

△：空白

(d)　固定長文字列の範囲指定

アーカイブするチャンクの範囲を固定長文字列で指定します。

形式

-r a...a-a...a

最小値（固定長文字列指定）と最大値（固定長文字列指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

a...a：1文字以上の文字列

指定例

-r 20160101-20161231

20160101および20161231が固定長文字列指定として扱われます。

固定長文字列の範囲指定に関する規則を次に示します。

固定長文字列指定には，1文字以上の文字列を指定します。

指定した固定長文字列指定は，英大文字と英小文字が区別されます。

固定長文字列の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

CHARACTER型

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含む固定長文字列指定を指定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，固定長文字列指定の全体をアポストロフィ（'）で囲んでください。

指定例

指定例1：-r a¥|c-def

指定例2：-r 'a|c'-def

どちらの場合も，a|c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）も固定長文字列指定として扱われます。

指定例

-r '"abc"'-def

"abc"，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にハイフン（-）を含める場合は，固定長文字列指定をアポストロフィ（'）で囲んでください。最小値と最大値の区切りと見なされるハイフン（-）と区別するためです。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'a-c¥'-def

アポストロフィ（'）で囲み，さらに二重引用符（"）で囲む場合

-r "'a-c'"-def

どちらの場合も，a-c，およびdefが固定長文字列指定として扱われます。

また，固定長文字列指定にハイフン（-）を含まない場合も，アポストロフィ（'）で囲むと，そのアポストロフィ（'）を除いた値が固定長文字列指定として扱われます。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'abc¥'-def

abc，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にアポストロフィ（'）を含む場合は，1個のアポストロフィ（'）を表すのに，2個連続してアポストロフィ（'）を指定してください。

指定例

¥'（バックスラッシュとアポストロフィ）を2個指定する場合

-r a¥'¥'c-def

アポストロフィ（'）を含む固定長文字列指定を二重引用符（"）で囲む場合

-r "a''c"-def

どちらの場合も，a'c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の文字データの比較を参照してください。

固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒10　固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

固定長文字列の範囲指定に，最小値と最大値の区切りと見なされるハイフン（-）が複数ある

-r a-c-def

-r 'a-c-def'

-r ¥'a-c¥'-def

2

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r abc△-△def

説明

固定長文字列指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r abc-def

（凡例）

△：空白

(e)　10進数の範囲指定

アーカイブするチャンクの範囲を10進数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝
    -〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝

最小値（10進数指定）と最大値（10進数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：整数部（aは0〜9）

.：小数点

b...b：小数部（bは0〜9）

DECIMAL(5,2)の場合の指定例

指定例1：-r -100-100

指定例2：-r -100.00-+100.00

-100.00および+100.00が10進数指定として扱われます。

10進数の範囲指定に関する規則を次に示します。

整数部と小数部のどちらかを指定する必要があります。小数部がない場合は，小数点を省略できます。

10進数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DECIMAL型

NUMERIC型

小数部がDECIMAL型またはNUMERIC型の位取り（小数部の桁数）より大きい場合，位取り（小数部の桁数）より下位の桁部分は切り捨てられます。

10進数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒11　10進数の範囲指定に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

指定例

-r 0-123456789012345678901234567890123456789

説明

10進数指定を39桁で指定している

指定例

-r 0-12345678901234567890123456789012345678

説明

10進数指定を38桁で指定する

2

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

10進数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(f)　整数の範囲指定

アーカイブするチャンクの範囲を整数で指定します。

形式

-r 〔｛+｜-｝〕a...a-〔｛+｜-｝〕a...a

最小値（整数指定）と最大値（整数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：数値（aは0〜9）

指定例

指定例1：-r -100-100

指定例2：-r -100-+100

-100および+100が整数指定として扱われます。

整数の範囲指定に関する規則を次に示します。

整数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

INTEGER型

BIGINT型

SMALLINT型

整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒12　整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

INTEGERまたはBIGINTの場合

-r 0-9223372036854775808

SMALLINTの場合

-r 0-2147483648

INTEGERまたはBIGINTの場合

-r 0-9223372036854775807

SMALLINTの場合

-r 0-2147483647

2

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

整数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(g)　浮動小数点数の範囲指定

アーカイブするチャンクの範囲を浮動小数点数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕
    - 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕

最小値（浮動小数点数指定）と最大値（浮動小数点数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：仮数部の整数部（aは0〜9）

.：小数点

b...b：仮数部の小数部（bは0〜9）

E，e：浮動小数点数定数

c...c：指数部（cは0〜9）

図2‒5　-rオプションの浮動小数点数の範囲指定の指定例

指定例1の場合は，-100，および100が浮動小数点数指定として扱われます。

指定例2の場合は，-1.0E2，および+1.0E2が浮動小数点数指定として扱われます。

指定例3の場合は，-100，および1.0E+2が浮動小数点数指定として扱われます。

浮動小数点数の範囲指定に関する規則を次に示します。

浮動小数点数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DOUBLE PRECISION型

FLOAT型

浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbarchivechunkコマンドを実行してください。

表2‒13　浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定できる文字数を超えている

指定例

-r 0-123…（中略）…789

説明

浮動小数点数指定を510文字で指定している

指定例

-r 0-123…（中略）…78

説明

浮動小数点数指定を509文字で指定する

2

KFAA90002-E

KFAA96830-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

浮動小数点数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

2.2.2　アーカイブチャンクオプションの形式

(1)　指定形式

〔set adb_arcv_rthd_num = adbarchivechunkコマンドが使用する処理リアルスレッド数〕
〔set adb_arcv_scan_buff_size = 表データの検索バッファサイズ〕

上記のアーカイブチャンクオプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_arcv_rthd_num = adbarchivechunkコマンドが使用する処理リアルスレッド数

〜〈整数〉((3〜4,096))

adbarchivechunkコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションには9を指定してください。このオプションの指定を省略したり，9以外の値を指定したりすると，チャンクのアーカイブ処理に掛かる時間が長くなるおそれがあります。

adbarchivechunkコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。adbarchivechunkコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「2.1.2　adbarchivechunkコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbarchivechunkコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表2‒14　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0～2の値を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに3以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに3以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbarchivechunkコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_arcv_scan_buff_size = 表データの検索バッファサイズ

〜〈整数〉((1〜2,048))《16》（単位：メガバイト）

表データの検索結果を保持するバッファのサイズをメガバイト単位で指定します。指定値を大きくすると，表データを検索する際のオーバヘッドを削減できます。

検索結果のデータ長の10,000件分程度のサイズを指定値の目安としてください。

検索結果のデータ長の求め方については，マニュアルHADB　システム構築・運用ガイドのリソースの設計のHADBサーバのメモリ所要量の見積もりの通常運用時のメモリ所要量の求め方にある表各データ型のデータ長の一覧を参照してください。

なお，1つの検索バッファに格納された検索結果は，同じアーカイブファイルに出力されます。

また，検索結果が1件も格納できないバッファサイズを指定した場合，adbarchivechunkコマンドがエラーとなります。

2.3　使用例

adbarchivechunkコマンドを使用して，表に作成されたチャンクをアーカイブする方法を，例題形式で説明します。

実行中にadbarchivechunkコマンドが異常終了した場合は，「2.5　adbarchivechunkコマンドが異常終了したときの対処方法」を参照して対処してください。

2.3.1　特定の日付の範囲のデータを含むチャンクをアーカイブする場合

次に示す条件で，表に作成された特定の日付の範囲のデータを含むチャンクをアーカイブします。

実表TABLE01はアーカイブマルチチャンク表である

実表TABLE01のアーカイブレンジ列のデータ型がDATE型である

実表TABLE01に作成されたチャンクのうち，アーカイブレンジ列の値が，2011年01月01日〜2011年12月31日の範囲のデータを含むチャンクをアーカイブする

このとき，次に示す手順でadbarchivechunkコマンドを実行します。

手順

アーカイブチャンクオプションファイルを作成する

adbarchivechunkコマンドを実行する

各手順の例を以降で説明します。

(1)　アーカイブチャンクオプションファイルを作成する

アーカイブチャンクオプションファイルを作成して，アーカイブチャンクオプションを指定します。

アーカイブチャンクオプションファイルの指定例

set adb_arcv_rthd_num = 9         ...1
set adb_arcv_scan_buff_size = 64  ...2

［説明］

adbarchivechunkコマンド実行時に使用する処理リアルスレッド数を指定します。

表データの検索結果を保持するバッファのサイズを指定します。

(2)　adbarchivechunkコマンドを実行する

adbarchivechunk -u ADBUSER01                                ...1
                -p '#HelloHADB_01'                          ...2
                -z /home/adbmanager/archive_file/env01.txt  ...3
                -r 2011/01/01-2011/12/31                    ...4
                TABLE01                                     ...5

［説明］

adbarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　アーカイブチャンクオプションファイルを作成する」で作成したアーカイブチャンクオプションファイルの絶対パス名を指定します。

アーカイブするチャンクの日付の範囲を指定します。

処理対象表を指定します。

2.3.2　チャンクのアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブされるチャンクを確認する場合

次に示す条件で，実際にチャンクのアーカイブ処理を実行する前に，指定した日付の範囲を基にどのチャンクがアーカイブされるかを確認します。

実表TABLE01はアーカイブマルチチャンク表である

実表TABLE01のアーカイブレンジ列のデータ型がDATE型である

実表TABLE01に作成されたチャンクのうち，アーカイブレンジ列の値が，2011年01月01日〜2011年12月31日の範囲のデータを含む，アーカイブ対象のチャンクのチャンクIDを確認する

このとき，次に示す手順でadbarchivechunkコマンドを実行します。

手順

adbarchivechunkコマンドを実行する

指定した日付の範囲のデータを含むチャンクをKFAA80245-Iメッセージで確認する

各手順の例を以降で説明します。

(1)　adbarchivechunkコマンドを実行する

adbarchivechunk -u ADBUSER01              ...1
                -p '#HelloHADB_01'        ...2
                -r 2011/01/01-2011/12/31  ...3
                -t                        ...4
                TABLE01                   ...5

［説明］

adbarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

アーカイブするチャンクの日付の範囲を指定します。

チャンクのアーカイブ処理を実行する前に，実際にアーカイブされるチャンクのチャンクIDを確認するために指定します。

処理対象表を指定します。

(2)　指定した日付の範囲のデータを含むチャンクをKFAA80245-Iメッセージで確認する

-tオプションを指定したadbarchivechunkコマンドを実行したあとに出力される，KFAA80245-Iメッセージを確認してください。

KFAA80245-Iメッセージには，アーカイブレンジ列の値が，日付の範囲指定で指定した範囲（2011年01月01日〜2011年12月31日）のデータを含む，アーカイブ対象のチャンクのチャンクIDが出力されます。

これらのチャンクに対して，チャンクのアーカイブ処理を行う場合は，-tオプション以外は同じ指定で（-tオプションを省略して）adbarchivechunkコマンドを実行してください。アーカイブするチャンクを見直す場合は，日付の範囲の値（-rオプションの指定値）を修正したあとで，adbarchivechunkコマンドを実行してください。

2.4　リターンコード

adbarchivechunkコマンドのリターンコードを次の表に示します。

表2‒15　adbarchivechunkコマンドのリターンコード

リターンコード

意味

0

adbarchivechunkコマンドが正常に終了しました。

4

adbarchivechunkコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbarchivechunkコマンドの指定に誤りがあり，adbarchivechunkコマンドが実行されませんでした。

adbarchivechunkコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

2.5　adbarchivechunkコマンドが異常終了したときの対処方法

adbarchivechunkコマンドが異常終了した場合は，次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されているときは，コマンドのオプションや，アーカイブチャンクオプションの指定に誤りがあります。コマンドのオプションまたはアーカイブチャンクオプションを修正したあとに，adbarchivechunkコマンドを再実行してください。

-cオプションの指定の誤りについては，「2.2.1　指定形式およびオプションの説明」の「(3)　-cオプションの指定が原因のエラー」を参照してください。

また，-rオプションの指定の誤りについては，指定した範囲指定の種類によって，次に示す個所をそれぞれ参照してください。

日付の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(a)　日付の範囲指定」の「表2‒5　日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

時刻の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(b)　時刻の範囲指定」の「表2‒7　時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

時刻印の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(c)　時刻印の範囲指定」の「表2‒9　時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

固定長文字列の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(d)　固定長文字列の範囲指定」の「表2‒10　固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

10進数の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(e)　10進数の範囲指定」の「表2‒11　10進数の範囲指定に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

整数の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(f)　整数の範囲指定」の「表2‒12　整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

浮動小数点数の範囲指定を指定した場合

「2.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(g)　浮動小数点数の範囲指定」の「表2‒13　浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

なお，異常終了したadbarchivechunkコマンドで複数のチャンクを指定していた場合は，異常発生時より前に処理されたチャンクだけがアーカイブされています。この場合，異常終了した原因を取り除いたあと，異常終了したときと同じ指定でadbarchivechunkコマンドを再実行してください。残りのチャンクに対して，チャンクのアーカイブ処理を実行します。

上記のメッセージが出力されていない場合は，異常終了した原因を取り除いたあとでadbarchivechunkコマンドを再実行してください。

なお，adbarchivechunkコマンドは表およびインデクスの内容を変更しません。そのため，adbarchivechunkコマンドが異常終了しても，表およびインデクスを回復させる必要はありません。

2.6　注意事項

adbarchivechunkコマンドは，HADBサーバが稼働中の場合にだけ実行できます。

adbarchivechunkコマンドのオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

adbarchivechunkコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

チャンクのアーカイブ処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbarchivechunkコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のチャンクのアーカイブ処理は中断されません（処理が続行されます）。チャンクのアーカイブ処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

アーカイブファイルが複数作成される場合，ファイルごとに出力されるデータ件数にばらつきが出ます。その影響で，データ件数が0件のファイルが作成されることがあります。データ件数が0件のアーカイブファイルは，削除されます。

データが1件も格納されていないチャンクをアーカイブした場合，アーカイブファイルは作成されません。

コマンドまたはAPの実行中にadbarchivechunkコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbarchivechunkコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

アーカイブチャンクオプションadb_arcv_rthd_numには9を指定してください。このオプションの指定を省略したり，9以外の値を指定したりすると，チャンクのアーカイブ処理に掛かる時間が長くなるおそれがあります。

次に示すチャンクはアーカイブできません。

カレントチャンク

待機状態としてインポートされたあと，一度も通常状態に変更されていないチャンク

削除仕掛中のチャンク

-tオプションを指定したadbarchivechunkコマンドを実行した場合，チャンクのアーカイブ処理は実行されません。-tオプションは，-rオプションまたは-cオプションで指定した範囲に該当するチャンクのうち，アーカイブされるチャンクを事前に確認するために指定します。

アーカイブされるチャンクを確認したあと，それらのチャンクに対してチャンクのアーカイブ処理を実行する場合は，-tオプション以外は同じ指定で（-tオプションを省略して）adbarchivechunkコマンドを実行してください。

暗号化されたデータ用DBエリアに格納されている表のチャンクに対して，adbarchivechunkコマンドで作成したアーカイブファイルは，暗号化されません。DBエリア暗号化機能については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を参照してください。

adbarchivechunkコマンドの実行時，次の表に示すファイルにアクセスします。adbarchivechunkコマンドを実行する前に，ファイルに次の表に示すパーミッションを設定してください。

表2‒16　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

アーカイブチャンクオプションファイル

コマンドの実行ユーザ

読み取り権限

注※

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

3　adbaudittrail（監査証跡機能の管理）

この章では，adbaudittrailコマンドの機能と使い方について説明します。

3.1　機能

adbaudittrailコマンドは，監査証跡機能の管理を行う際に実行するコマンドです。

監査証跡機能の詳細については，マニュアルHADB　システム構築・運用ガイドの監査証跡機能を参照してください。

adbaudittrailコマンドは，コマンド実行時にHADBサーバに接続します。

adbaudittrailコマンドでは，次の4つの操作を実施できます。

監査証跡機能の有効化

HADBサーバの稼働中に，監査証跡機能を有効にします。監査証跡機能の環境設定の終了後に監査証跡機能を有効にすると，監査証跡ファイルに監査証跡が出力されます。

監査証跡機能の無効化

HADBサーバの稼働中に，監査証跡機能を無効にします。監査証跡機能を無効にすると，監査証跡ファイルに監査証跡が出力されません。

監査証跡ファイルの切り替え

監査証跡の出力対象となっている監査証跡ファイル（現用の監査証跡ファイル）を切り替えます。現用の監査証跡ファイルを切り替えることで，切り替え前の現用の監査証跡ファイル中の監査証跡を検索できるようになります。

監査証跡機能の関連情報の表示

監査証跡機能に関連する情報を表示します。監査証跡機能が有効であるか無効であるかを確認できます。また，監査証跡ファイルの情報も確認できます。

3.2　adbaudittrailコマンドの指定形式

adbaudittrailコマンドの指定形式，およびオプションについて説明します。

adbaudittrailコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

3.2.1　指定形式およびオプションの説明

(1)　指定形式

adbaudittrail
    -u 認可識別子
  〔-p パスワード〕
  ｛--start 〔--write-error ｛DOWN｜FAILSOFT｝〕
  ｜--stop
  ｜--swap 〔-n ノード番号〕
  ｜-d 〔-n ノード番号〕｝

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbaudittrailコマンドを実行するHADBユーザの認可識別子を指定します。adbaudittrailコマンドを実行するときに必要な権限は，指定するオプションによって異なります。指定するオプションと必要な権限について，次の表に示します。

表3‒1　adbaudittrailコマンドの実行に必要な権限

項番

指定するオプション

必要な権限

1

--start

CONNECT権限

監査管理権限

2

--stop

CONNECT権限

監査管理権限

3

--swap

CONNECT権限

監査管理権限

4

-d

CONNECT権限

監査管理権限，または監査参照権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbaudittrailコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●--start

監査証跡機能を有効にしたい場合に指定します。

マルチノード機能を使用している場合，adbaudittrail --startコマンドを実行できるのはプライマリノードだけです。

メモ

監査証跡機能を有効にすると，新しい監査証跡ファイルが作成されます。作成された監査証跡ファイルに，監査証跡が出力されます。

●--write-error ｛DOWN｜FAILSOFT｝

ディスクの満杯やディスク障害などの原因によって，監査証跡ファイルに監査証跡を書き込めなくなったときの処理方式（HADBサーバを停止するかどうか）を指定します。このオプションを省略した場合は，DOWNが仮定されます。

DOWN：

監査証跡ファイルに監査証跡を書き込めない場合，HADBサーバを停止します。このときのHADBサーバの終了モードは，異常終了となります。

FAILSOFT：

監査証跡ファイルに監査証跡を書き込めない場合でも，HADBサーバを停止しません。監査証跡ファイルに書き込めなかった監査証跡は破棄されますが，HADBサーバは動作を継続します。

なお，監査証跡ファイルに監査証跡を書き込めない原因の対処が完了すると，次回の監査証跡の書き込みタイミングから，監査証跡ファイルへの出力が自動的に再開されます。

重要

--write-errorオプションの指定は，adbaudittrail --startコマンドを実行して監査証跡機能を有効にする際にしか変更できません。

そのため，監査証跡機能が有効な場合に，--write-errorオプションの指定を変更したいときは，いったんadbaudittrail --stopコマンドを実行して監査証跡機能を無効にしてください。そのあと，--write-errorオプションの指定を変更し，再度adbaudittrail --startコマンドを実行して監査証跡機能を有効にしてください。

●--stop

監査証跡機能を無効にしたい場合に指定します。監査証跡機能を無効にすると，監査証跡の出力を停止します。

マルチノード機能を使用している場合，adbaudittrail --stopコマンドを実行できるのはプライマリノードだけです。

メモ

監査証跡機能を無効にすると，現用だった監査証跡ファイルがリネームされます。

監査証跡ファイルのリネームについては，マニュアルHADB　システム構築・運用ガイドの監査証跡の出力先（監査証跡ファイル）を参照してください。

●--swap

監査証跡の出力対象となっている監査証跡ファイル（現用の監査証跡ファイル）を切り替える場合に指定します。

現用の監査証跡ファイル中の監査証跡を検索または変換することはできません。現用の監査証跡ファイル中の監査証跡を検索または変換したい場合は，adbaudittrail --swapコマンドを実行して，現用の監査証跡ファイルを切り替えてください。

マルチノード機能を使用している場合，-nオプションを省略したadbaudittrail --swapコマンドは，全ノードで実行できます。その際，コマンドを実行したノードで出力対象となっている監査証跡ファイルが切り替わります。

●-n ノード番号

〜〈整数〉((1〜12))

このオプションに指定したノード番号のノードで出力対象となっている監査証跡ファイルを切り替えます。

このオプションは次に示す2つの条件を満たす場合に指定できます。

マルチノード機能を使用している場合

プライマリノードでadbaudittrailコマンドを実行する場合

なお，マルチノード機能を使用していない場合は，このオプションを指定しても無視されます。

メモ

adbaudittrail --swapコマンドを実行すると，切り替え前の現用の監査証跡ファイルがリネームされます。そして，新たに現用の監査証跡ファイルが作成されます。adbaudittrail --swapコマンドの実行後，リネームされた監査証跡ファイル中の監査証跡を参照できます。

監査証跡ファイルのリネームについては，マニュアルHADB　システム構築・運用ガイドの監査証跡の出力先（監査証跡ファイル）を参照してください。

●-d

監査証跡機能に関連する情報を表示したい場合に指定します。

監査証跡機能が有効であるか無効であるかを確認できます。また，監査証跡ファイルの情報も確認できます。表示される情報の出力形式と出力内容については，「3.3.2　監査証跡機能に関連する情報を表示する場合」を参照してください。

マルチノード機能を使用している場合，-nオプションを省略したadbaudittrail -dコマンドは，全ノードで実行できます。その際，コマンドを実行したノードの監査証跡機能に関連する情報が表示されます。

●-n ノード番号

〜〈整数〉((1〜12))

このオプションに指定したノード番号のノードの監査証跡機能に関連する情報を表示します。

このオプションは次に示す2つの条件を満たす場合に指定できます。

マルチノード機能を使用している場合

プライマリノードでadbaudittrailコマンドを実行する場合

なお，マルチノード機能を使用していない場合は，このオプションを指定しても無視されます。

3.3　使用例

adbaudittrailコマンドを使用して，次の内容を実行する方法を説明します。

監査証跡機能を有効にする方法

監査証跡機能に関連する情報を表示する方法

3.3.1　監査証跡機能を有効にする場合

監査証跡機能を有効にします。

adbaudittrail -u ADBAUDITADMIN
              -p '#HelloHADB_ADMIN'
              --start --write-error DOWN

監査管理権限を持っているHADBユーザが，adbaudittrail --startコマンドを実行すると，監査証跡機能が有効になります。

この例では，監査証跡ファイルに監査証跡を書き込めなくなった場合にHADBサーバを異常終了とするため，--write-errorオプションにDOWNを指定します。

3.3.2　監査証跡機能に関連する情報を表示する場合

監査証跡機能に関連する情報を表示します。

adbaudittrail -u ADBAUDITVIEWER
              -p '#HelloHADB_VIEWER'
              -d

adbaudittrail -dコマンドを実行すると，監査証跡機能に関連する情報を確認できます。

出力例

audit   write-error audit-directory-path      audit-file-max-size audit-file-number
ACTIVE  DOWN        /home/ADBAUDITADMIN/audit 256                 100

各出力項目の説明

audit：

監査証跡機能のステータス情報が表示されます。次のどれかの情報が表示されます。

ACTIVE

監査証跡機能は有効です。

ACTIVE(NO OUTPUT)

監査証跡機能は有効です。ただし，監査証跡ファイルへの監査証跡の出力が抑止されている状態です。

INACTIVE

監査証跡機能は無効です。

write-error：

ディスクの満杯やディスク障害などの原因によって，監査証跡ファイルに監査証跡を書き込めなくなったときの処理方式が表示されます。--write-errorオプションに指定した値が表示されます。

DOWN

監査証跡ファイルへの書き込みに失敗した場合，HADBサーバを異常終了する設定になっています。

FAILSOFT

監査証跡ファイルへの書き込みに失敗した場合でも，HADBサーバは動作を継続する設定になっています。

audit-directory-path：

監査証跡の出力先ディレクトリが表示されます。サーバ定義のadb_audit_log_pathオペランドに指定したディレクトリ名が表示されます。

audit-file-max-size：

監査証跡ファイルの最大容量がメガバイト単位で表示されます。サーバ定義のadb_audit_log_max_sizeオペランドの値が表示されます。

audit-file-number：

監査証跡ファイルの最大世代数が表示されます。サーバ定義のadb_audit_log_max_numオペランドの値が表示されます。

adb_audit_log_max_numオペランドに0を指定している場合，またはadb_audit_log_max_numオペランドの指定を省略している場合は，0が表示されます。0は監査証跡ファイルの最大世代数の上限がないことを意味しています。

3.4　リターンコード

adbaudittrailコマンドのリターンコードを次の表に示します。

表3‒2　adbaudittrailコマンドのリターンコード

リターンコード

意味

0

adbaudittrailコマンドが正常に終了しました。

4

adbaudittrailコマンドは正常に終了しましたが，警告メッセージ，またはエラーメッセージが出力されました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbaudittrailコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

3.5　注意事項

監査証跡機能を有効にする場合，次のすべての条件を満たしている必要があります。満たしていない場合，adbaudittrailコマンドがエラーになります。

サーバ定義adb_audit_log_pathオペランドに，存在するディレクトリを指定している

サーバ定義adb_audit_log_pathオペランドに指定したディレクトリに対して，HADB管理者がアクセスできるように書き込み権限，読み取り権限および実行権限を設定している

サーバ定義adb_audit_log_pathオペランドに指定したディレクトリ下に格納されている監査証跡ファイルの数が，サーバ定義adb_audit_log_max_numオペランドの指定値以下である

監査証跡機能を有効にした場合，adbaudittrailコマンドが正常終了したあとに実行開始したSQL文およびコマンドから監査証跡の出力が開始されます。adbaudittrailコマンドが正常終了した時点で実行中のSQL文およびコマンドについては，監査証跡は出力されません。

監査証跡機能を無効にした場合，adbaudittrailコマンドが正常終了した時点で実行中のSQL文およびコマンドの監査証跡は出力されません。また，以降に実行されるSQL文およびコマンドの監査証跡も出力されません。

adbaudittrailコマンドは，複数同時に実行できません。複数同時に実行した場合は，adbaudittrailコマンドがエラーになります。

マルチノード機能を使用する場合，指定するオプションによってadbaudittrailコマンドを実行できるノードが異なります。指定するオプションと，adbaudittrailコマンドを実行できるノードの対応を次の表に示します。

表3‒3　指定するオプションとadbaudittrailコマンドを実行できるノードの対応

項番

指定するオプション

実行できるノード

1

--start

プライマリノード

2

--stop

プライマリノード

3

--swap※1

全ノード

4

--swap -n ノード番号

プライマリノード

5

-d※2

全ノード

6

-d -n ノード番号

プライマリノード

注※1

コマンドを実行したノードで，監査証跡の出力対象となっている監査証跡ファイルが切り替わります。

注※2

コマンドを実行したノードの監査証跡機能に関連する情報を出力します。

また，監査証跡機能を有効にするときに，有効にならないノードが1つでもあると，adbaudittrailコマンドがエラーになります。監査証跡機能を無効にするときも同様です。

マルチノード機能を使用する場合，-nオプションに指定するノード番号が，次のすべての条件を満たしている必要があります。満たしていない場合，adbaudittrailコマンドがエラーになります。

マルチノード構成のHADBサーバを構成しているノード数以下の値である

指定したノード番号のノードのHADBサーバが稼働中である

監査証跡機能は一度有効にすると，adbaudittrailコマンドで監査証跡機能を無効にするまで有効な状態のままとなります。監査証跡機能を有効にした状態でHADBサーバを終了した場合，HADBサーバの次回開始時も，監査証跡機能は有効な状態のままとなります。また，--write-errorオプションで指定した，「監査証跡ファイルに監査証跡を書き込めなくなったときの処理方式」の指定も引き継がれます。

メモ

次に示す監査証跡機能に関するサーバ定義については，HADBサーバを開始した時点の指定値が適用されます（前回のHADBサーバ終了時点の指定値は引き継がれません）。

adb_audit_log_pathオペランド（監査証跡の出力先ディレクトリ）

adb_audit_log_max_sizeオペランド（監査証跡ファイルの最大容量）

adb_audit_log_max_numオペランド（監査証跡ファイルの最大世代数）

adbaudittrailコマンドの実行時，次の表に示すディレクトリにアクセスします。adbaudittrailコマンドを実行する前に，ディレクトリに次の表に示すパーミッションを設定してください。

表3‒4　ディレクトリに設定するパーミッション

ディレクトリ

アクセスするOSユーザ※

必要な権限

サーバ定義adb_audit_log_pathオペランドに指定した監査証跡の出力先ディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

4　adbcancel（トランザクションまたはコマンドの強制終了）

この章では，adbcancelコマンドの機能と使い方について説明します。

4.1　機能

adbcancelコマンドを実行すると，APまたはコマンドからの処理要求を受けて動作しているHADBサーバの処理を強制終了し，HADBサーバからコネクションを切り離すことができます。

APまたはコマンドが異常終了などによって終了しているのに，HADBサーバの処理が終了しない場合に，adbcancelコマンドを使用します。

なお，APがトランザクションを実行しているときにadbcancelコマンドを実行した場合，トランザクションをロールバックしたあとにHADBサーバからコネクションを切り離します。

実行中のコマンドを中断（強制終了）する場合も，adbcancelコマンドを使用します。コマンドの中断（強制終了）手順については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

■マルチノード機能を使用している場合

全ノードでadbcancelコマンドを実行できます。

SQLパラレル実行機能を適用した検索系SQLを実行しているトランザクションを強制終了する場合は，SQLメインノードまたはSQLサブノードのどれかのノードでadbcancelコマンドを実行してください。

4.2　adbcancelコマンドの指定形式

adbcancelコマンドの指定形式およびオプションについて説明します。

adbcancelコマンドを実行できるOSユーザは，HADB管理者だけです。

4.2.1　指定形式およびオプションの説明

(1)　指定形式

adbcancel ｛--ALL | -u コネクションID｝

(2)　オプションの説明

●--ALL

HADBサーバに接続しているすべてのコネクションに対応するHADBサーバの処理を強制終了したあとに，HADBサーバからコネクションを切り離す場合に指定します。

なお，--ALLを指定してadbcancelコマンドを実行した場合，KFAA91251-Qメッセージが出力されます。そこで，adbcancelコマンドを実行するかどうかの最終確認に応答してください。adbcancelコマンドを実行しても問題ない場合はy（またはY）を応答してください。y（またはY）以外を応答した場合は，adbcancelコマンドの実行を中止します。

また，マルチノード機能を使用している場合，マルチノード構成の全HADBサーバに接続しているすべてのコネクションが，adbcancelコマンドの対象となります。ただし，ワーカーノードでadbcancel --ALLコマンドを実行した場合は，adbcancel --ALLコマンドを実行したワーカーノードで実行中のトランザクションとそのコネクションだけが，adbcancelコマンドの対象となります。

●-u コネクションID

〜〈整数〉((1〜1,024))

強制終了の対象とするコネクションのコネクションIDを指定します。

adbls -d cnctコマンドの実行結果のCID欄で確認したコネクションIDを指定します。adbls -d cnctコマンドについては，「24.　adbls -d cnct（コネクションの状態表示）」を参照してください。

■adbls -d cnctコマンドの実行結果の例

4.3　使用例

コネクションIDが10のAPのトランザクションを強制終了します。

adbcancel -u 10

KFAA90000-I adbcancel processing started.
KFAA90001-I adbcancel processing ended. (return code = 0)

4.4　リターンコード

adbcancelコマンドのリターンコードを次の表に示します。

表4‒1　adbcancelコマンドのリターンコード

リターンコード

意味

0

adbcancelコマンドが正常に終了しました。

4

adbcancelコマンドが警告メッセージを出力して終了しました。

HADBサーバに対する非同期キャンセル要求は完了しています。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbcancelコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

4.5　注意事項

adbcancelコマンドはHADBサーバの処理とは非同期で実行されます。そのため，処理対象のコネクションがHADBから切り離されたかどうかはadbls -d cnctコマンドの実行結果で確認してください。adbcancelコマンドに指定したコネクションIDに処理対象のコネクション情報が表示されていない場合は，コネクションがHADBから切り離されています。

adbcancelコマンドで強制終了できるコマンドは，HADBサーバとコネクションを確立するコマンド（adbimportコマンドなど）だけです。コネクションが確立されているかどうかは，adbls -d cnctコマンドの実行結果のPROGRAM欄で確認できます。コネクションが確立されている場合，PROGRAM欄にコマンド名が表示されます。

adbcancelコマンドでトランザクション実行中のAPを強制終了した場合，トランザクションをロールバックしたあとに，HADBサーバからコネクションを切り離します。対象となるAPがトランザクション実行中かどうかは，adbls -d cnctコマンドの実行結果のSTATUS欄がSTARTEDであるかどうかで判別できます。STARTEDであればトランザクションの実行中です。

異常終了したAPのトランザクションが実行中のまま終了しない場合，adbcancelコマンドを実行しなくても，該当するAPのクライアント定義のadb_clt_rpc_sql_wait_timeオペランドで指定した時間が過ぎると，トランザクションはロールバックされてHADBサーバからコネクションが切り離されます。

マルチノード機能を使用している場合，adbcancelコマンドは，ノード間で非同期に実行されます。そのため，adblsコマンドで表示される情報が，一時的にノード間で不一致になることがあります。

ワーカーノードでadbcancelコマンドを実行した場合，adbcancelコマンドを実行したワーカーノードで実行中のトランザクションだけがadbcancelコマンドの対象となります。そのため，ワーカーノードでadbcancelコマンドを実行した場合，次のトランザクションを強制終了したり，コネクションを切り離したりすることはできません。

プライマリノードまたはセカンダリノードで実行中のトランザクション

トランザクションが実行中でないコネクション

5　adbchgchunkcomment（チャンクのコメントの設定・変更・削除）

この章では，adbchgchunkcommentコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

5.1　機能

adbchgchunkcommentコマンドを実行すると，表定義時にCHUNKを指定した表（マルチチャンク表）のチャンクについて，コメントを設定，変更，および削除できます。

adbchgchunkcommentコマンドは，コマンド実行時にHADBサーバに接続します。

チャンクのコメントの設定，変更，および削除の概要を次の図に示します。

図5‒1　チャンクのコメントの設定，変更，および削除

［説明］

チャンクのコメントの設定

（例）新規のコメント（current month）をチャンクに設定します。

チャンクに設定したコメントの変更

（例）チャンクに設定したコメント（current month）を，新しいコメント（previous month）に変更します。

チャンクに設定したコメントの削除

（例）チャンクに設定したコメントを削除します。

5.2　adbchgchunkcommentコマンドの指定形式

adbchgchunkcommentコマンドの指定形式およびオプションについて説明します。

adbchgchunkcommentコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

5.2.1　指定形式およびオプションの説明

(1)　指定形式

adbchgchunkcomment
  -u 認可識別子
〔-p パスワード〕
｛-m チャンクに設定するコメント｜-d｝
〔--timeout タイムアウト時間〕
  -c チャンクID
  処理対象表

重要

処理対象表は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbchgchunkcommentコマンドを実行するHADBユーザの認可識別子を指定します。adbchgchunkcommentコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するCHANGE CHUNK COMMENT権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbchgchunkcommentコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-m チャンクに設定するコメント

〜〈文字列〉((1〜1,024バイト))

チャンクのコメントを設定および変更する場合に指定します。

マルチチャンク表に対して指定してください。シングルチャンク表に対して指定した場合，エラーとなります。

指定時の規則を次に示します。

指定したコメントは，英大文字と英小文字が区別されます。

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含むコメントを設定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，コメント全体をアポストロフィ（'）で囲んでください。

（例1）-m abc¥|def

（例2）-m 'abc|def'

どちらの場合も，コメントとしてabc|defが設定されます。

文字列を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）および文字列がコメントとして扱われます。

（例）-m '"abcdef"'

この場合，コメントとして"abcdef"が設定されます。

コメントの文字コードは，HADBサーバの環境変数のADBLANGに設定した文字コードと同じになります。

●-d

チャンクに設定したコメントを削除する場合に指定します。コメントを設定していないチャンクに対して，-dオプションを指定してadbchgchunkcommentコマンドを実行すると，コメントを削除しないで正常終了します。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbchgchunkcommentコマンドがタイムアウトになるまでの時間を指定します。

adbchgchunkcommentコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbchgchunkcommentコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbchgchunkcommentコマンドのタイムアウト時間は設定されません。adbchgchunkcommentコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbchgchunkcommentコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbchgchunkcommentコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbchgchunkcommentコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

ワーカーノードの追加処理中

他ノードで実行中のトランザクションの終了待ち中

●-c チャンクID

〜〈整数〉((1〜9,223,372,036,854,775,807))

コメントを設定，変更，および削除するチャンクのチャンクIDを指定します。

存在しないチャンクIDを指定した場合，KFAA50294-Eメッセージが出力されます。

●処理対象表

コメントを設定，変更，および削除する表を指定します。マルチチャンク表を指定してください。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

CHANGE CHUNK COMMENT権限を持っている表を指定できます。

シングルチャンク表は指定できません。

ビュー表は指定できません。

5.3　使用例

この節では，adbchgchunkcommentコマンドを実行して，チャンクに設定したコメントを変更および削除する方法を，例題形式で説明します。

5.3.1　チャンクに設定したコメントを変更する場合

次に示す条件で，チャンクに設定したコメントを，新しいコメント（previous month）に変更します。

表TABLE01の定義時にCHUNKを指定している（表TABLE01はマルチチャンク表である）

表TABLE01には，チャンクIDが10のチャンクが存在する

チャンクIDが10のチャンクに，コメント（current month）を設定している

■adbchgchunkcommentコマンドの実行例

adbchgchunkcomment -u ADBUSER01        ...1
                   -p '#HelloHADB_01'  ...2
                   -m 'previous month' ...3
                   -c 10               ...4
                   TABLE01             ...5

［説明］

adbchgchunkcommentコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

変更後のコメント（previous month）を指定します。

コメントを変更したいチャンクのチャンクID（10）を指定します。

処理対象表（TABLE01）を指定します。

5.3.2　チャンクに設定したコメントを削除する場合

次に示す条件で，チャンクに設定したコメントを削除します。

表TABLE01の定義時にCHUNKを指定している（表TABLE01はマルチチャンク表である）

表TABLE01には，チャンクIDが10のチャンクが存在する

チャンクIDが10のチャンクに，コメント（current month）を設定している

■adbchgchunkcommentコマンドの実行例

adbchgchunkcomment -u ADBUSER01        ...1
                   -p '#HelloHADB_01'  ...2
                   -d                  ...3
                   -c 10               ...4
                   TABLE01             ...5

［説明］

adbchgchunkcommentコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

コメントの削除を指定します。

コメントを削除したいチャンクのチャンクID（10）を指定します。

処理対象表（TABLE01）を指定します。

5.4　リターンコード

adbchgchunkcommentコマンドのリターンコードを次の表に示します。

表5‒1　adbchgchunkcommentコマンドのリターンコード

リターンコード

意味

0

adbchgchunkcommentコマンドが正常に終了しました。

4

adbchgchunkcommentコマンドは正常に終了しましたが，警告メッセージが出力されました。表示されたメッセージ，またはメッセージログファイルを確認して，メッセージの対処に従ってください。

8

adbchgchunkcommentコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

16

adbchgchunkcommentコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbchgchunkcommentコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，KFAA80204-Iメッセージに出力されるリターンコード（0，4または8）を参照してください。ただし，adbchgchunkcommentコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合は，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbchgchunkcommentコマンドを再実行してください。

5.5　adbchgchunkcommentコマンドが異常終了したときの対処方法

adbchgchunkcommentコマンドが異常終了した場合は，次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されているときは，コマンドのオプションの指定に誤りがあります。コマンドのオプションを修正したあとに，adbchgchunkcommentコマンドを再実行してください。

上記のメッセージが出力されていない場合は，異常終了した原因を取り除いたあとでadbchgchunkcommentコマンドを再実行してください。

なお，adbchgchunkcommentコマンドは表およびインデクスの内容を変更しません。そのため，adbchgchunkcommentコマンドが異常終了しても，表およびインデクスを回復させる必要はありません。

5.6　注意事項

adbchgchunkcommentコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

チャンクのコメントの設定，変更および削除の処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbchgchunkcommentコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中の，チャンクのコメントの設定，変更および削除の処理は中断されません（処理が続行されます）。処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

adbchgchunkcommentコマンドは，次に示す表に対して実行できません。

更新不可状態の表

adbimportコマンドまたはadbidxrebuildコマンドの実行が中断している表

6　adbchgchunkstatus（チャンクの状態変更）

この章では，adbchgchunkstatusコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

6.1　機能

adbchgchunkstatusコマンドを実行すると，チャンクの状態を通常状態から待機状態に変更したり，待機状態から通常状態に変更したりすることができます。

adbchgchunkstatusコマンドは，コマンド実行時にHADBサーバに接続します。

6.2　adbchgchunkstatusコマンドの指定形式

adbchgchunkstatusコマンドの指定形式，およびオプションの形式について説明します。

adbchgchunkstatusコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

6.2.1　指定形式およびオプションの説明

チャンクの状態を変更する表が1つの場合と，2つ以上ある場合とで指定形式が異なります。チャンクの状態を変更する表が2つ以上ある場合は，複数の表のチャンクの状態の変更内容を指定した「チャンクの状態の一括変更設定ファイル」を準備し，チャンクの状態を一括して変更します。

(1)　指定形式

■チャンクの状態を変更する表が1つの場合

adbchgchunkstatus
    -u 認可識別子
  〔-p パスワード〕
  〔--timeout タイムアウト時間〕
  〔-w 待機状態に変更するチャンクのチャンクID〔,待機状態に変更するチャンクのチャンクID〕…〕
  〔-n 通常状態に変更するチャンクのチャンクID〔,通常状態に変更するチャンクのチャンクID〕…〕
    処理対象表

重要

-wオプションまたは-nオプションのどちらかは必ず指定してください。また，両方指定することもできます。

処理対象表は，必ずオプションの最後に指定してください。

-mオプションは指定できません。

■チャンクの状態を変更する表が2つ以上ある場合

adbchgchunkstatus
    -u 認可識別子
  〔-p パスワード〕
  〔--timeout タイムアウト時間〕
    -m チャンクの状態の一括変更設定ファイル名

重要

-wオプション，-nオプション，および処理対象表は指定できません。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbchgchunkstatusコマンドを実行するHADBユーザの認可識別子を指定します。adbchgchunkstatusコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するCHANGE CHUNK STATUS権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbchgchunkstatusコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbchgchunkstatusコマンドがタイムアウトになるまでの時間を指定します。

adbchgchunkstatusコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbchgchunkstatusコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbchgchunkstatusコマンドのタイムアウト時間は設定されません。adbchgchunkstatusコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbchgchunkstatusコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbchgchunkstatusコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbchgchunkstatusコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

ワーカーノードの追加処理中

他ノードで実行中のトランザクションの終了待ち中

●-w 待機状態に変更するチャンクのチャンクID〔,待機状態に変更するチャンクのチャンクID〕…

〜〈整数〉((1〜9,223,372,036,854,775,807))

待機状態に変更するチャンクのチャンクIDを指定します。複数のチャンクIDを指定する場合は，チャンクIDをコンマ（ , ）で区切ったり，ハイフン（-）を指定したりしてください。

例1：チャンクIDが1，3，5のチャンクを待機状態にする場合

-w 1,3,5

例2：チャンクIDが1〜5のチャンクを待機状態にする場合

-w 1-5

例3：チャンクIDが1，3，5〜10，15のチャンクを待機状態にする場合

-w 1,3,5-10,15

処理対象表に存在しないチャンクIDや，通常状態でないチャンクのチャンクIDを指定した場合，その指定は無視されます（状態を変更できるチャンクだけを対象とします）。ただし，状態を変更できるチャンクが1つもない場合はエラーになります。

●-n 通常状態に変更するチャンクのチャンクID〔,通常状態に変更するチャンクのチャンクID〕…

〜〈整数〉((1〜9,223,372,036,854,775,807))

通常状態に変更するチャンクのチャンクIDを指定します。複数のチャンクIDを指定する場合は，チャンクIDをコンマ（ , ）で区切ったり，ハイフン（-）を指定したりしてください。

例1：チャンクIDが1，3，5のチャンクを通常状態にする場合

-n 1,3,5

例2：チャンクIDが1〜5のチャンクを通常状態にする場合

-n 1-5

例3：チャンクIDが1，3，5〜10，15のチャンクを通常状態にする場合

-n 1,3,5-10,15

処理対象表に存在しないチャンクIDや，待機状態でないチャンクのチャンクIDを指定した場合，その指定は無視されます（状態を変更できるチャンクだけを対象とします）。ただし，状態を変更できるチャンクが1つもない場合はエラーになります。

●処理対象表

チャンクの状態を変更する表の表名を指定します。マルチチャンク表を指定してください。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

CHANGE CHUNK STATUS権限を持っている表を指定できます。

シングルチャンク表は指定できません。

ビュー表は指定できません。

更新不可状態の表は指定できません。

adbimportコマンドまたはadbidxrebuildコマンドの実行が中断している表は指定できません。

●-m チャンクの状態の一括変更設定ファイル名

〜〈OSパス名〉((2〜510バイト))

複数の表のチャンクの状態を一括して変更したい場合に，このオプションを指定してください。

このオプションには，チャンクの状態の一括変更設定ファイルの絶対パス名を指定します。チャンクの状態の一括変更設定ファイルとは，複数の表のチャンクの状態の変更内容を指定したファイルです。チャンクの状態の一括変更設定ファイルの指定形式については，「(3)　チャンクの状態の一括変更設定ファイルの指定規則」を参照してください。

(3)　チャンクの状態の一括変更設定ファイルの指定規則

2つ以上の表のチャンクの状態を一括して変更する場合，チャンクの状態の一括変更設定ファイルを作成します。チャンクの状態の一括変更設定ファイルには，複数の表のチャンクの状態の変更内容を指定します。

■チャンクの状態の一括変更設定ファイルの指定形式

｛｛
adbchunkstatus
    -t 処理対象表
  〔-w ｛待機状態に変更するチャンクのチャンクID〔,待機状態に変更するチャンクのチャンクID〕…
        ｜ALL｝〕
  〔-n ｛通常状態に変更するチャンクのチャンクID〔,通常状態に変更するチャンクのチャンクID〕…
        ｜ALL｝〕
｝｝

上記のチャンクの状態の一括変更設定ファイルの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

■指定例

表TABLE01および表TABLE02のチャンクの状態を変更する指定例を次に示します。

adbchunkstatus ¥
  -t TABLE01 ¥
  -w 10,11,20,21

adbchunkstatus ¥
  -t TABLE02 ¥
  -w 1,2,3,10-20,30 ¥
  -n 50-59

■指定規則

指定できる表の数は，最大32です。

表を1つだけ指定して，チャンクの状態を変更することもできます。

チャンクの状態の一括変更設定ファイル中には，同じ処理対象表を2つ以上指定できません。

1つの処理対象表に対して，-wオプションまたは-nオプションのどちらかは必ず指定してください。また，両方指定することもできます。

■指定形式の説明

●adbchunkstatus

このオペランドにはチャンクの状態の変更内容を指定します。チャンクの状態を変更したい表の数だけこのオペランドを指定してください。

このオペランドは，1～32個指定できます。

●-t 処理対象表

〜〈文字列〉((1〜205バイト))

チャンクの状態を変更する表の表名を指定します。レギュラーマルチチャンク表を指定してください。

指定規則を次に示します。

表名の指定規則については，マニュアルHADB　SQLリファレンスの名前の指定を参照してください。なお，表名に英小文字がある場合は，区切り識別子の形式で表名を指定する必要がありますが，二重引用符（"）で囲むのではなく，バックスラッシュと二重引用符（¥"）で囲んでください。

（例）表名が「ADBUser.Table01」の場合

¥"ADBUser¥".¥"Table01¥"

また，表名に空白が含まれる場合は，二重引用符（"）で全体を囲んでください。

（例）表名が「ADBUser.Table△01」の場合

"¥"ADBUser¥".¥"Table△01¥""

△：半角空白

CHANGE CHUNK STATUS権限を持っている表を指定できます。

アーカイブマルチチャンク表は指定できません。

シングルチャンク表は指定できません。

ビュー表は指定できません。

更新不可状態の表は指定できません。

adbimportコマンドまたはadbidxrebuildコマンドの実行が中断している表は指定できません。

●-w ｛待機状態に変更するチャンクのチャンクID〔,待機状態に変更するチャンクのチャンクID〕…｜ALL｝

〜〈文字列〉

待機状態に変更するチャンクのチャンクIDを指定します。処理対象表に存在するすべての通常状態のチャンクを待機状態に変更する場合は，ALLを指定してください。

チャンクIDの指定規則を次に示します。

チャンクIDとして指定できる数値は，1〜9,223,372,036,854,775,807です。

複数のチャンクIDを指定する場合は，チャンクIDをコンマ（ , ）で区切ったり，ハイフン（-）を指定したりしてください。

1つの待機状態に変更するチャンクのチャンクIDに指定できる文字数は，1～39文字です。

処理対象表に存在しないチャンクIDや，通常状態でないチャンクのチャンクIDを指定した場合，その指定は無視されます（状態を変更できるチャンクだけを対象とします）。

●-n ｛通常状態に変更するチャンクのチャンクID〔,通常状態に変更するチャンクのチャンクID〕…｜ALL｝

〜〈文字列〉

通常状態に変更するチャンクのチャンクIDを指定します。処理対象表に存在するすべての待機状態のチャンクを通常状態に変更する場合は，ALLを指定してください。

チャンクIDの指定規則を次に示します。

チャンクIDとして指定できる数値は，1〜9,223,372,036,854,775,807です。

複数のチャンクIDを指定する場合は，チャンクIDをコンマ（ , ）で区切ったり，ハイフン（-）を指定したりしてください。

1つの通常状態に変更するチャンクのチャンクIDに指定できる文字数は，1～39文字です。

処理対象表に存在しないチャンクIDや，待機状態でないチャンクのチャンクIDを指定した場合，その指定は無視されます（状態を変更できるチャンクだけを対象とします）。

(4)　-wおよび-nオプションの指定規則

次に示す-wおよび-nオプションの指定規則について説明します。

チャンクの状態を変更する表が1つの場合に，adbchgchunkstatusコマンドの引数に指定する-wおよび-nオプション

チャンクの状態を変更する表が2つ以上ある場合に，チャンクの状態の一括変更設定ファイルに指定するadbchunkstatusオペランドの-wおよび-nオプション

■共通の指定規則

ハイフンを指定してチャンクIDを範囲指定する場合，例えば，3-1のように，数値が大→小になるような指定はできません。また，3-3のような指定もできません。

チャンクIDは，最大29,999個指定できます。

なお，ハイフンを指定してチャンクIDを範囲指定する場合，範囲内のすべてのチャンクIDがカウント対象になります。また，チャンクIDを重複指定した場合でも，それぞれカウントされます。

（例）

-w 1,3,5と指定した場合

チャンクIDを3個指定したと見なされます。

-w 1-10と指定した場合

チャンクIDを10個指定したと見なされます。

-n 1,3-5,5と指定した場合

チャンクIDを5個指定したと見なされます。

■チャンクの状態を変更する表が1つの場合

複数のチャンクIDを指定する場合，コンマまたはハイフンの前後に空白を入れないでください。

-wオプションに指定できる値の長さの上限，および-nオプションに指定できる値の長さの上限は両方とも32キロバイトです。このため，-wオプションまたは-nオプションの指定値の長さが32キロバイトを超える場合は，範囲指定に変更するか，またはadbchgchunkstatusコマンドを複数回に分けて実行してください。

-wおよび-nオプションの指定誤りのケースを次の表に示します。

表6‒1　-wおよび-nオプションの指定誤りのケース（チャンクの状態を変更する表が1つの場合）

adbchgchunkstatusコマンド実行時に出力されたエラーメッセージ

エラーの原因

KFAA50225-E

ハイフンを使った範囲指定の指定形式に誤りがあります。

間違った指定例

-w 3-3,4

-n 10-3

正しい指定例

-w 3,4

-n 3-10

チャンクIDを30,000個以上指定しています。

間違った指定例

-w 1-30000

正しい指定例

-w 1-29999

KFAA50235-E

-wまたは-nオプションのどちらかを指定していません。-wまたは-nオプションのどちらかを指定するか，または両方のオプションを指定してください。

状態を変更できるチャンクが1つもありません。チャンクIDに指定したチャンクが存在するかどうかを確認してください。または，チャンクの状態を確認してください。

KFAA50294-E

指定したチャンクIDが，処理対象表に存在するチャンクIDの範囲外です。処理対象表のチャンクIDを確認してください。

KFAA90002-E

KFAA96820-I

コンマまたはハイフンの前後に空白を指定しています。

間違った指定例

-w 1,△3

-n 1△-10

正しい指定例

-w 1,3

-n 1-10

KFAA90003-E

-wオプションの指定値の長さ，または-nオプションの指定値の長さが32キロバイトを超えています。-wまたは-nオプションの指定値を範囲指定にして，指定値の長さを短くしてください。

（凡例）

△：空白

■チャンクの状態を変更する表が2つ以上ある場合（チャンクの状態の一括変更設定ファイル）

複数のチャンクIDを指定する場合，コンマの前に空白を入れないでください。

複数のチャンクIDを範囲指定する場合，ハイフンの前後に空白を入れないでください。

チャンクの状態の一括変更設定ファイル内に指定した-wおよび-nオプションの指定誤りのケースを次の表に示します。

表6‒2　-wおよび-nオプションの指定誤りのケース（チャンクの状態の一括変更設定ファイル）

adbchgchunkstatusコマンド実行時に出力されたエラーメッセージ

エラーの原因

KFAA50005-E

KFAA50207-E

指定したチャンクIDの文字数が39文字を超えています。

コンマの前に空白を指定しています。

間違った指定例

-w 1,3△,10

正しい指定例

-w 1,3,10

-w 1,3,△10

チャンクIDを30,000個以上指定しています。

間違った指定例

-w 1,2,.....,30000

正しい指定例

-w 1,2,.....,29999

ハイフンの前後に空白を指定しています。

間違った指定例

-n 1△-△10

正しい指定例

-n 1-10

KFAA50207-E

チャンクIDを30,000個以上指定しています。

間違った指定例

-w 1-30000

正しい指定例

-w 1-29999

指定できるチャンクID（1～9,223,372,036,854,775,807）の範囲外の数値を指定しています。

ハイフンを使った範囲指定の指定形式に誤りがあります。

間違った指定例

-w 8-2

-n 4-4

正しい指定例

-w 2-8

-n 4

（凡例）

△：空白

6.3　使用例

adbchgchunkstatusコマンドを使用してチャンクの状態を変更する方法を，例題形式で説明します。

6.3.1　チャンクの状態を通常状態から待機状態に変更する表が1つの場合

表TABLE01の次のチャンクの状態を，通常状態から待機状態に変更します。

チャンクIDが1，3〜5，8のチャンク

(1)　チャンクの状態を確認する

チャンクの状態を変更する前に，変更対象のチャンクの状態を次のどちらかの方法で確認してください。

adbdbstatusコマンドで確認する

システム表のSTATUS_CHUNKSのCHUNK_STATUS列の情報を検索する

(2)　adbchgchunkstatusコマンドを実行する

adbchgchunkstatus -u ADBUSER01            ...1
                  -p '#HelloHADB_01'      ...2
                  -w 1,3-5,8              ...3
                  TABLE01                 ...4

［説明］

adbchgchunkstatusコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

通常状態から待機状態に変更するチャンクのチャンクIDを指定します。

処理対象表（TABLE01）を指定します。

6.3.2　通常状態および待機状態のチャンクの状態をそれぞれ変更する表が1つの場合

表TABLE01の次のチャンクの状態を，次のように変更します。

チャンクIDが1〜3のチャンクを待機状態に変更する

チャンクIDが4〜6のチャンクを通常状態に変更する

(1)　チャンクの状態を確認する

チャンクの状態を変更する前に，変更対象のチャンクの状態を次のどちらかの方法で確認してください。

adbdbstatusコマンドで確認する

システム表のSTATUS_CHUNKSのCHUNK_STATUS列の情報を検索する

(2)　adbchgchunkstatusコマンドを実行する

adbchgchunkstatus -u ADBUSER01            ...1
                  -p '#HelloHADB_01'      ...2
                  -w 1-3                  ...3
                  -n 4-6                  ...4
                  TABLE01                 ...5

［説明］

adbchgchunkstatusコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

通常状態から待機状態に変更するチャンクのチャンクIDを指定します。

待機状態から通常状態に変更するチャンクのチャンクIDを指定します。

処理対象表（TABLE01）を指定します。

6.3.3　２つ以上の表のチャンクの状態を一括して変更する場合

表TABLE01の次のチャンクの状態を，次のように変更します。

チャンクIDが10のチャンクを待機状態に変更する

チャンクIDが11のチャンクを通常状態に変更する

表TABLE02の次のチャンクの状態を，次のように変更します。

チャンクIDが1～10のチャンクを待機状態に変更する

チャンクIDが11～20のチャンクを通常状態に変更する

(1)　チャンクの状態を確認する

チャンクの状態を変更する前に，変更対象のチャンクの状態を次のどちらかの方法で確認してください。

adbdbstatusコマンドで確認する

システム表のSTATUS_CHUNKSのCHUNK_STATUS列の情報を検索する

(2)　チャンクの状態の一括変更設定ファイルを作成する

チャンクの状態の一括変更設定ファイルを作成します。ファイル名はchunk.txtとします。

チャンクの状態の一括変更設定ファイルの記述例

adbchunkstatus ¥
  -t TABLE01 ¥      ...1
  -w 10 ¥           ...2
  -n 11             ...3

adbchunkstatus ¥
  -t TABLE02 ¥      ...4
  -w 1-10 ¥         ...5
  -n 11-20          ...6

［説明］

処理対象表（TABLE01）を指定します。

通常状態から待機状態に変更するチャンクのチャンクIDを指定します。

待機状態から通常状態に変更するチャンクのチャンクIDを指定します。

処理対象表（TABLE02）を指定します。

通常状態から待機状態に変更するチャンクのチャンクIDを指定します。

待機状態から通常状態に変更するチャンクのチャンクIDを指定します。

(3)　adbchgchunkstatusコマンドを実行する

adbchgchunkstatus -u ADBUSER01                    ...1
                  -p '#HelloHADB_01'              ...2
                  -m /home/adbmanager/chunk.txt   ...3

［説明］

adbchgchunkstatusコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(2)　チャンクの状態の一括変更設定ファイルを作成する」で作成した，チャンクの状態の一括変更設定ファイル（chunk.txt）の絶対パス名を指定します。

6.4　リターンコード

adbchgchunkstatusコマンドのリターンコードを次の表に示します。

表6‒3　adbchgchunkstatusコマンドのリターンコード

リターンコード

意味

0

adbchgchunkstatusコマンドが正常に終了しました。

4

adbchgchunkstatusコマンドは正常に終了しましたが，次のどちらかの警告メッセージが出力されました。

メッセージログファイルのディスク満杯を検知しました。

上記以外の警告メッセージが出力されました。

8

adbchgchunkstatusコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

16

adbchgchunkstatusコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbchgchunkstatusコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，KFAA80204-Iメッセージに出力されるリターンコード（0，4または8）を参照してください。ただし，adbchgchunkstatusコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合は，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbchgchunkstatusコマンドを再実行してください。

6.5　adbchgchunkstatusコマンドが異常終了したときの対処方法

出力されたメッセージに従って対処してください。

なお，adbchgchunkstatusコマンドが異常終了した場合，チャンクの状態はコマンド実行前の状態のままとなります。

6.6　注意事項

adbchgchunkstatusコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。adbcancelコマンド以外を使用するときは，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

チャンクの状態変更処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbchgchunkstatusコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のチャンクの状態変更処理は中断されません（処理が続行されます）。チャンクの状態変更処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

adbchgchunkstatusコマンドの実行時，次の表に示すファイルにアクセスします。adbchgchunkstatusコマンドを実行する前に，ファイルに次の表に示すパーミッションを設定してください。

表6‒4　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

チャンクの状態の一括変更設定ファイル（２つ以上の表のチャンクの状態を一括して変更する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

7　adbchgnodetype（HADBサーバのノード種別の変更）

この章では，adbchgnodetypeコマンドの機能と使い方について説明します。

7.1　機能

adbchgnodetypeコマンドを実行すると，HADBサーバのノード種別を変更することができます。

ただし，通常はadbchgnodetypeコマンドを単体で実行して，ノード種別を変更することはできません。

adbchgnodetypeコマンドは，HAモニタのserversファイル（サーバ対応の環境を設定する定義ファイル）のactcommandオペランドに指定するシェルコマンドで使用します。

7.2　adbchgnodetypeコマンドの指定形式

adbchgnodetypeコマンドの指定形式およびオプションについて説明します。

adbchgnodetypeコマンドを実行できるOSユーザを次に示します。

HADB管理者

7.2.1　指定形式およびオプションの説明

(1)　指定形式

adbchgnodetype --primary -n HAモニタのサーバ識別名

(2)　オプションの説明

●--primary

HADBサーバのノード種別を，セカンダリノードからプライマリノードに変更する場合に指定します。

●-n HAモニタのサーバ識別名

HADBサーバを監視しているHAモニタのサーバ識別名を指定します。

7.3　リターンコード

adbchgnodetypeコマンドのリターンコードを次の表に示します。

表7‒1　adbchgnodetypeコマンドのリターンコード

リターンコード

意味

0

adbchgnodetypeコマンドが正常に終了しました。

4

adbchgnodetypeコマンドが警告メッセージを出力して終了しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbchgnodetypeコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

8　adbchgsqltrc（SQLトレース情報の出力開始・停止）

この章では，adbchgsqltrcコマンドの機能と使い方について説明します。

8.1　機能

HADBサーバ起動中に，SQLトレース情報の出力有無や，SQLトレース情報の出力内容を変更します。また，SQLトレース情報の出力状況を表示します。

マルチノード機能を使用している場合は，コマンドを実行したノードのSQLトレース情報を出力するかどうかを変更します。また，コマンドを実行したノードのSQLトレース情報の出力状況を表示します。

SQLトレース情報については，マニュアルHADB　システム構築・運用ガイドの定期運用のSQLトレース機能の運用を参照してください。

なお，adbchgsqltrcコマンドでSQLトレース情報の出力有無や，SQLトレース情報の出力内容を変更した場合，変更した内容は，HADBサーバ終了時に失われます。変更した内容を次回起動時も引き継ぐ場合は，変更した内容をサーバ定義に反映してください。

サーバ定義の変更方法については，マニュアルHADB　システム構築・運用ガイドのシステム構築のサーバ定義の作成および変更方法のサーバ定義の変更方法を参照してください。

8.2　adbchgsqltrcコマンドの指定形式

adbchgsqltrcコマンドの指定形式およびオプションについて説明します。

adbchgsqltrcコマンドを実行できるOSユーザは，HADB管理者だけです。

8.2.1　指定形式とオプションの説明

(1)　指定形式

adbchgsqltrc ｛-d
             ｜-e
             ｜-s 〔-y 出力を開始する情報〕
                  〔-n 出力を停止する情報〕
                  〔-l 変更後の出力レベル〕
             ｜-y 出力を開始する情報 〔-n 出力を停止する情報〕
                                     〔-l 変更後の出力レベル〕
             ｜-n 出力を停止する情報 〔-y 出力を開始する情報〕
                                     〔-l 変更後の出力レベル〕
             ｜-l 変更後の出力レベル 〔-y 出力を開始する情報〕
                                     〔-n 出力を停止する情報〕
             ｝

(2)　オプションの説明

●-d

SQLトレース情報の出力状況を表示します。

このオプションを指定した場合に出力される内容については，「8.3.1　SQLトレース情報の出力状況を確認したい場合」を参照してください。

●-e

SQLトレース情報の出力を停止する場合に指定します。

●-s

SQLトレース情報の出力を開始する場合に指定します。

●-y 出力を開始する情報

〜〈文字列〉((1〜16バイト))

SQLトレース情報に出力する情報の種類を指定します。

param：？パラメタの情報

SQLトレース情報に，？パラメタの情報を出力します。

accesspath：アクセスパス情報およびアクセスパスの統計情報

SQLトレース情報に，アクセスパス情報およびアクセスパスの統計情報を出力します。

指定時の規則を次に示します。

情報はコンマで区切って，複数指定できます。コンマ以外の文字で区切ることはできません。

複数の情報を指定する場合，指定する順序は関係ありません。

同じ情報は，重複して指定できません。

●-n 出力を停止する情報

〜〈文字列〉((1〜16バイト))

SQLトレース情報への出力を停止する情報の種類を指定します。

param：？パラメタの情報

SQLトレース情報に，？パラメタの情報を出力しません。

accesspath：アクセスパス情報およびアクセスパスの統計情報

SQLトレース情報に，アクセスパス情報およびアクセスパスの統計情報を出力しません。

指定時の規則を次に示します。

情報はコンマで区切って，複数指定できます。コンマ以外の文字で区切ることはできません。

複数の情報を指定する場合，指定する順序は関係ありません。

同じ情報は，重複して指定できません。

●-l 変更後の出力レベル

〜〈文字列〉((1〜4バイト))

SQLトレース情報を出力する単位を指定します。

sql：SQL文単位

SQLトレース情報を，SQL文単位で出力します。

call：コール単位

SQLトレース情報を，コール単位で出力します。

(3)　オプションとサーバ定義の関係

adbchgsqltrcコマンドの一部のオプションは，SQLトレース機能に関するサーバ定義のオペランドと対応しています。SQLトレース機能に関するサーバ定義のオペランドと，adbchgsqltrcコマンドのオプションの関係を次の表に示します。

表8‒1　SQLトレース機能に関するサーバ定義のオペランドとadbchgsqltrcコマンドのオプションの対応

項番

サーバ定義のオペランド名

サーバ定義の指定値

対応するadbchgsqltrcコマンドのオプション

1

adb_sql_trc_out

Y

-s

2

N

-e

3

adb_sql_trc_param

Y

-y param

4

N

-n param

5

adb_sql_trc_accesspath

Y

-y accesspath

6

N

-n accesspath

7

adb_sql_trc_level

SQL

-l sql

8

CALL

-l call

SQLトレース機能に関するサーバ定義については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容のSQL文に関するオペランド（set形式）を参照してください。

8.3　使用例

adbchgsqltrcコマンドを実行して次の内容を実行する方法を，例題形式で説明します。

SQLトレース情報の出力状況を確認する方法

SQLトレース情報の出力有無を変更する方法

SQLトレース情報の出力内容を変更する方法

8.3.1　SQLトレース情報の出力状況を確認したい場合

SQLトレース情報の出力状況を，標準出力に出力します。

adbchgsqltrc -d

sqltrace param    accesspath level
ACTIVE   ACTIVE   INACTIVE   SQL

各出力項目の説明

sqltrace：

SQLトレース情報が出力されているかどうかが表示されます。

ACTIVE：SQLトレース情報が出力されています。

INACTIVE：SQLトレース情報が出力されていません。

param：

SQLトレース情報に，？パラメタの情報が出力されているかどうかが表示されます。

ACTIVE：SQLトレース情報に，？パラメタの情報が出力されています。

INACTIVE：SQLトレース情報に，？パラメタの情報が出力されていません。

accesspath：

SQLトレース情報に，アクセスパス情報およびアクセスパスの統計情報が出力されているかどうかが表示されます。

ACTIVE：SQLトレース情報に，アクセスパス情報およびアクセスパスの統計情報が出力されています。

INACTIVE：SQLトレース情報に，アクセスパス情報およびアクセスパスの統計情報が出力されていません。

level：

SQLトレース情報を出力する単位が表示されます。

CALL：SQLトレース情報が，コール単位で出力されています。

SQL：SQLトレース情報が，SQL文単位で出力されています。

8.3.2　SQLトレース情報の出力を開始したい場合

SQLトレース情報の出力を開始します。

このとき，出力するSQLトレース情報の種類やSQLトレース情報の出力レベルを変更することもできます。

変更しない項目については，次のとおり動作します。

HADBサーバの開始後に初めてadbchgsqltrcコマンドを実行する場合は，サーバ定義の指定値に従います。

上記以外の場合は，前回SQLトレース情報を出力していたときの状態がそのまま引き継がれます。

メモ

出力するSQLトレース情報の種類やSQLトレース情報の出力レベルについて，現在の状況を確認したい場合は「8.3.1　SQLトレース情報の出力状況を確認したい場合」を参照してください。

(1)　SQLトレース情報の出力を開始したいとき

SQLトレース情報の出力を開始します。

出力するSQLトレース情報の種類や，SQLトレース情報を出力する単位は変更しません。

adbchgsqltrc -s

(2)　？パラメタの情報，およびアクセスパスに関する情報を出力したいとき

SQLトレース情報の出力を開始します。

このとき，出力するSQLトレース情報の種類を次のとおり変更します。

？パラメタの情報を出力する

アクセスパス情報およびアクセスパスの統計情報を出力する

SQLトレース情報を出力する単位は変更しません。

adbchgsqltrc -s -y param,accesspath

(3)　？パラメタの情報を出力しないで，アクセスパスに関する情報を出力したいとき

SQLトレース情報の出力を開始します。

このとき，出力するSQLトレース情報の種類を次のとおり変更します。

？パラメタの情報を出力しない

アクセスパス情報およびアクセスパスの統計情報を出力する

SQLトレース情報を出力する単位は変更しません。

adbchgsqltrc -s -n param -y accesspath

(4)　アクセスパスに関する情報を出力しないで，SQLトレース情報をコール単位で出力したいとき

SQLトレース情報の出力を開始します。

このとき，アクセスパス情報およびアクセスパスの統計情報は出力しません。？パラメタの情報を出力するかどうかは変更しません。

また，SQLトレース情報を出力する単位をコール単位に変更します。

adbchgsqltrc -s -n accesspath -l call

(5)　SQLトレース情報をSQL文単位で出力したいとき

SQLトレース情報の出力を開始します。

このとき，SQLトレース情報を出力する単位をSQL文単位に変更します。

出力するSQLトレース情報の種類は変更しません。

adbchgsqltrc -s -l sql

8.3.3　SQLトレース情報の出力内容を変更したい場合

SQLトレース情報が出力されている場合に，出力するSQLトレース情報の種類やSQLトレース情報を出力する単位を変更します。

メモ

出力するSQLトレース情報の種類やSQLトレース情報の出力レベルについて，現在の状況を確認したい場合は「8.3.1　SQLトレース情報の出力状況を確認したい場合」を参照してください。

(1)　？パラメタの情報，およびアクセスパスに関する情報を出力したいとき

出力するSQLトレース情報の種類を次のとおり変更します。

？パラメタの情報を出力する

アクセスパス情報およびアクセスパスの統計情報を出力する

SQLトレース情報を出力する単位は変更しません。

adbchgsqltrc -y param,accesspath

(2)　？パラメタの情報を出力しないで，アクセスパスに関する情報を出力したいとき

出力するSQLトレース情報の種類を次のとおり変更します。

？パラメタの情報を出力しない

アクセスパス情報およびアクセスパスの統計情報を出力する

SQLトレース情報を出力する単位は変更しません。

adbchgsqltrc -n param -y accesspath

(3)　アクセスパスに関する情報を出力しないで，SQLトレース情報をコール単位で出力したいとき

アクセスパス情報およびアクセスパスの統計情報の出力を停止します。？パラメタの情報を出力するかどうかは変更しません。

また，SQLトレース情報を出力する単位を，コール単位に変更します。

adbchgsqltrc -n accesspath -l call

(4)　SQLトレース情報をSQL文単位で出力したいとき

SQLトレース情報を出力する単位を，SQL文単位に変更します。

出力するSQLトレース情報の種類は変更しません。

adbchgsqltrc -l sql

8.3.4　SQLトレース情報の出力を停止したい場合

SQLトレース情報の出力を停止します。

adbchgsqltrc -e

8.4　リターンコード

adbchgsqltrcコマンドのリターンコードを次の表に示します。

表8‒2　adbchgsqltrcコマンドのリターンコード

リターンコード

意味

0

adbchgsqltrcコマンドが正常に終了しました。

4

adbchgsqltrcコマンドが警告メッセージを出力して終了しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbchgsqltrcコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8.5　注意事項

次に示す場合，adbchgsqltrcコマンドによる変更は「その時点で実行中のトランザクションの，次のトランザクション」から有効になります。

adbchgsqltrcコマンドで，SQLトレース情報の出力を開始する場合

adbchgsqltrcコマンドで，SQLトレース情報に出力されていなかった情報の出力を開始する場合

adbchgsqltrcコマンドで，SQLトレース情報を出力する単位（出力レベル）を変更する場合

次に示す場合，adbchgsqltrcコマンドによる変更は「adbchgsqltrcコマンドを実行した直後」から有効になります。

adbchgsqltrcコマンドで，SQLトレース情報の出力を停止する場合

adbchgsqltrcコマンドで，SQLトレース情報に出力されていた情報の出力を停止する場合

adbchgsqltrcコマンドに-yオプションと-nオプションを同時に指定する場合，出力を開始するSQLトレース情報と，出力を停止するSQLトレース情報に，同じ情報は指定できません。同じ情報が指定された場合は，エラーメッセージを出力後，adbchgsqltrcコマンドが終了します。

-dオプションとそのほかのオプションは，同時に指定できません。-dオプションとそのほかのオプションが同時に指定された場合は，エラーメッセージを出力後，adbchgsqltrcコマンドが終了します。

-eオプションとそのほかのオプションは，同時に指定できません。-eオプションとそのほかのオプションが同時に指定された場合は，エラーメッセージを出力後，adbchgsqltrcコマンドが終了します。

adbchgsqsltrcコマンドは，複数同時に実行できません。複数同時に実行された場合は，エラーメッセージを出力後，adbchgsqltrcコマンドが終了します。

adbchgsqltrcコマンドを実行してSQLトレース情報の出力有無や，SQLトレース情報の出力内容を変更しても，サーバ定義ファイルのオペランドに指定されている値は変更されません。adbchgsqltrcコマンドで変更した結果を次回のHADBサーバ開始以降も使用する場合は，サーバ定義を変更しておく必要があります。サーバ定義の変更方法については，マニュアルHADB　システム構築・運用ガイドのシステム構築のサーバ定義の作成および変更方法のサーバ定義の変更方法を参照してください。

HADBサーバが停止している状態でadbchgsqltrcコマンドを実行すると，エラーメッセージが出力されます。HADBサーバが停止している場合は，SQLトレース機能に関するサーバ定義のオペランドの指定値を変更してください。

9　adbchgsrvmode（HADBサーバの稼働モードの変更）

この章では，adbchgsrvmodeコマンドの機能と使い方について説明します。

9.1　機能

adbchgsrvmodeコマンドを実行すると，HADBサーバの稼働モードを変更できます。

HADBサーバの稼働モードには，次に示す4種類があります。

通常モード

静止モード

オフラインモード

メンテナンスモード

HADBサーバの稼働モードの詳細については，マニュアルHADB　システム構築・運用ガイドの定期運用のHADBサーバの開始・終了と稼働モードのHADBサーバの稼働モードを参照してください。

■マルチノード機能を使用している場合

プライマリノードのHADBサーバの稼働モードをadbchgsrvmodeコマンドで変更できます。

マルチノード構成へのノード復帰中のノードが存在する場合は，プライマリノードのHADBサーバの稼働モードを変更できません。

マルチノード構成へのワーカーノードの追加処理中は，プライマリノードのHADBサーバの稼働モードを変更できません。

セカンダリノードおよびワーカーノードのHADBサーバの稼働モードは常に変更できません（セカンダリノードおよびワーカーノードのHADBサーバの稼働モードは，常に静止モードとなるためです）。

9.2　adbchgsrvmodeコマンドの指定形式

adbchgsrvmodeコマンドの指定形式およびオプションについて説明します。

adbchgsrvmodeコマンドを実行できるOSユーザは，HADB管理者だけです。

9.2.1　指定形式とオプションの説明

(1)　指定形式

adbchgsrvmode ｛--normal｜--quiescence｜--offline｜--maintenance｝

(2)　オプションの説明

HADBサーバの稼働モードを指定します。

●--normal

HADBサーバの稼働モードを通常モードに変更する場合に指定します。

通常モードへは，静止モード，オフラインモード，およびメンテナンスモードから変更できます。

●--quiescence

HADBサーバの稼働モードを静止モードに変更する場合に指定します。

現在の稼働モードが通常モードの場合だけ，静止モードに変更できます。

●--offline

HADBサーバの稼働モードを通常モードからオフラインモードに変更する場合に指定します。

現在の稼働モードが通常モードの場合だけ，オフラインモードに変更できます。

●--maintenance

HADBサーバの稼働モードを通常モードからメンテナンスモードに変更する場合に指定します。

現在の稼働モードが通常モードの場合だけ，メンテナンスモードに変更できます。

9.3　各稼働モードで実行できるSQL文およびコマンド

HADBサーバの稼働モードによって，実行できるSQL文，およびコマンドが異なります。各稼働モードで実行できるSQL文およびコマンドについては，「43.3　各稼働モードで実行できるSQL文およびコマンド」を参照してください。

9.4　使用例

HADBサーバの稼働モードを，通常モードから静止モードに変更します。

adbchgsrvmode --quiescence

KFAA80068-I The HADB server operation mode changed from "NORMAL" to "QUIESCENCE".

9.5　リターンコード

adbchgsrvmodeコマンドのリターンコードを次の表に示します。

表9‒1　adbchgsrvmodeコマンドのリターンコード

リターンコード

意味

0

adbchgsrvmodeコマンドが正常に終了しました。

4

adbchgsrvmodeコマンドが警告メッセージを出力して終了しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbchgsrvmodeコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

9.6　注意事項

adbchgsrvmodeコマンドは，HADBサーバの稼働中に実行できます。

静止モードへの変更要求を受け付けた際，一度でも更新系SQLを実行したことがあるトランザクションが存在する場合は，そのトランザクションはキャンセルされ，トランザクションを実行中のコネクションは切り離されます。

オフラインモードへの変更要求を受け付けた際，HADBサーバがインストールされているサーバマシンとは異なるマシンからのコネクションが存在している場合は，そのコネクションのトランザクションはキャンセルされ，コネクションは切り離されます。

メンテナンスモードへの変更要求を受け付けた際，メンテナンスモードで実行できるコマンド以外のコネクションが存在している場合は，そのコネクションのトランザクションはキャンセルされ，コネクションは切り離されます。

adbchgsrvmodeコマンドの実行中（稼働モードの変更中）に実行できるSQL文およびコマンドについて，次の表に示します。

表9‒2　稼働モードの変更中に実行できるSQL文およびコマンド

項番

SQL文およびコマンド名

通常モードから静止モード

静止モードから通常モード

通常モードからオフラインモード

オフラインモードから通常モード

通常モードからメンテナンスモード

メンテナンスモードから通常モード

サーバマシンでの実行※1

サーバマシンとは異なるマシンからの実行※2

サーバマシンでの実行※1

サーバマシンとは異なるマシンからの実行※2

1

検索系SQL

○※3

○

○

×※4

○

×

×※10

×

2

更新系SQL

×※3

×

○

×※4

○

×

×※10

×

3

定義系SQL

×※3

×

○

×※4

○

×

×※10

×

4

制御系SQL

○※3

○

○

×※4

○

×

×※10

×

5

adbarchivechunkコマンド

×※5

×

○

−

○

−

×※10

×

6

adbaudittrailコマンド

×

※5，※11

×※11

○

−

○

−

○

○

7

adbcancelコマンド

○

○

○

−

○

−

○

○

8

adbchgchunkcommentコマンド

×※5

×

○

−

○

−

×※10

×

9

adbchgchunkstatusコマンド

×※5

×

○

−

○

−

×※10

×

10

adbchgnodetypeコマンド

×

×

×

−

×

−

×

×

11

adbchgsqltrcコマンド

○

○

○

−

○

−

○

○

12

adbchgsrvmodeコマンド※6

×

×

×

−

×

−

×

×

13

adbclientdefmangコマンド

○

○

○

−

○

−

○

○

14

adbcolumnizeコマンド

×

×

○

−

○

−

○

○

15

adbconvertaudittrailfileコマンド

○

○

○

−

○

−

○

○

16

adbdbstatusコマンド

○

○

○

−

○

−

×※10

×

17

adbexportコマンド

○

○

○

−

○

−

×※10

×

18

adbgetcstコマンド

×※5

×

○

−

○

−

×※10

×

19

adbidxrebuildコマンド

×※5

×

○

−

○

−

×※10

×

20

adbimportコマンド

×※5

×

○

−

○

−

×※10

×

21

adbinfogetコマンド

○

○

○

−

○

−

○

○

22

adbinfosweepコマンド※7

×

×

×

−

×

−

×

×

23

adbinitコマンド※7

×

×

×

−

×

−

×※10

×

24

adbinstallコマンド※7

×

×

×

×

×

×

×

×

25

adblsコマンド

○

○

○

−

○

−

○

○

26

adbmergechunkコマンド

×※5

×

○

−

○

−

×※10

×

27

adbmkdmkコマンド

○

○

○

−

○

−

×※10

×

28

adbmodareaコマンド

×※5

×

○

−

○

−

○

○

29

adbmodbuffコマンド

○

○

○

−

○

−

×※10

×

30

adbmonitorコマンド

○

○

○

−

○

−

○

○

31

adboptinstallコマンド※7

×

×

×

×

×

×

×

×

32

adbreorgsystemdataコマンド

×※5

×

○

−

○

−

×※10

×

33

adbsqlコマンド※8

○

○

○

×

○

×

×※10

×

34

adbstartコマンド※7

×

×

×

−

×

−

×

×

35

adbstatコマンド

○

○

○

−

○

−

○

○

36

adbstopコマンド※9

×

×

×

−

×

−

×

×

37

adbsyndictコマンド

×※5

×

○

−

○

−

×※10

×

38

adbunarchivechunkコマンド

×※5

×

○

−

○

−

×※10

×

39

adbupddmkコマンド

×

×

×

−

×

−

×

×

（凡例）

○：稼働モード変更中に実行できます。

×：稼働モード変更中に実行できません（エラーとなります）。

−：HADBサーバがインストールされているサーバマシンで実行するコマンドのため，該当しません。

注※1

サーバマシンでの実行とは，HADBサーバがインストールされているサーバマシンでの実行のことです。

注※2

サーバマシンとは異なるマシンからの実行とは，HADBサーバがインストールされているサーバマシンとは異なるマシンからの実行のことです。

注※3

静止モードに変更する際，一度でも更新系SQLを実行したことがあるトランザクションが存在する場合は，そのトランザクションはキャンセルされ，トランザクションを実行中のコネクションは切り離されます。

注※4

オフラインモードに変更する際，HADBサーバがインストールされているサーバマシンとは異なるマシンからのコネクションが存在している場合は，そのコネクションのトランザクションはキャンセルされ，コネクションは切り離されます。

注※5

静止モードに変更する際，コマンドがすでに実行されている場合は，実行中のコマンドの処理はキャンセルされます。

注※6

adbchgsrvmodeコマンドは複数同時に実行できません。

注※7

HADBサーバの稼働中には実行できないコマンドです。

注※8

実行できるSQL文については，項番1から項番4を参照してください。

注※9

adbchgsrvmodeコマンドとadbstopコマンドは同時に実行できません。

注※10

メンテナンスモードに変更する際，メンテナンスモードで実行できるコマンド以外のコネクションが存在している場合は，そのコネクションのトランザクションはキャンセルされ，コネクションは切り離されます。

注※11

--swapオプション，または-dオプションを指定した場合は，adbaudittrailコマンドを実行できます（エラーになりません）。

10　adbclientdefmang（クライアント定義の集中管理）

この章では，adbclientdefmangコマンドの機能と使い方について説明します。

10.1　機能

adbclientdefmangコマンドは，クライアント定義の集中管理機能を適用する際に使用するコマンドです。

HADBサーバの稼働中に，クライアント定義の集中管理機能の適用内容を変更したい場合にadbclientdefmangコマンドを実行します。

adbclientdefmangコマンドは，コマンド実行時にHADBサーバに接続します。

クライアント定義の集中管理機能の適用内容の変更の概要を次の図に示します。

図10‒1　クライアント定義の集中管理機能の適用内容の変更

［説明］

adbclientdefmangコマンドを実行すると，クライアント定義の集中管理の対象となるクライアント定義について，「クライアント定義の集中管理機能で使用するクライアント定義ファイル」の内容が各HADBクライアントに適用されます。

adbclientdefmangコマンドの実行前に，次に示すファイルを作成しておいてください。

クライアント管理定義ファイル

クライアント定義の集中管理機能で使用するクライアント定義ファイル

各ファイルについては，マニュアルHADB　システム構築・運用ガイドのクライアント定義の集中管理機能で必要なファイルを参照してください。

また，adbclientdefmangコマンドを実行して，「クライアント定義の集中管理機能の対象となるHADBクライアント」と，「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」の対応を確認することもできます（クライアント定義の集中管理機能の適用状況の確認）。

クライアント定義の集中管理機能の適用状況の確認の概要を次の図に示します。

図10‒2　クライアント定義の集中管理機能の適用状況の確認

［説明］

adbclientdefmangコマンドを実行すると，HADBクライアントの認可識別子と，対応する「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」が出力されます。

10.2　adbclientdefmangコマンドの指定形式

adbclientdefmangコマンドの指定形式およびオプションについて説明します。

adbclientdefmangコマンドを実行できるOSユーザは，HADB管理者だけです。

10.2.1　指定形式およびオプションの説明

(1)　指定形式

adbclientdefmang -u 認可識別子
               〔-p パスワード〕
               ｛--update ｜〔-i 出力対象の認可識別子〕｝

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbclientdefmangコマンドを実行するHADBユーザの認可識別子を指定します。adbclientdefmangコマンドを実行するには，次の2つの権限を持っている必要があります。

DBA権限

CONNECT権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbclientdefmangコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●--update

HADBサーバの稼働中に，クライアント定義の集中管理機能の適用内容を変更したい場合に指定します。

--updateオプションを指定してadbclientdefmangコマンドを実行すると，クライアント管理定義ファイル（$ADBDIR/conf/adbclientdefmang.def）の内容に従って，各HADBクライアントに「クライアント定義の集中管理機能で使用するクライアント定義ファイル」の内容が適用されます。

ただし，次の状態で--updateオプションを指定してadbclientdefmangコマンドを実行した場合は，クライアント定義の集中管理機能が無効になります。

クライアント管理定義ファイルが存在しない

クライアント管理定義ファイルに何も記載されていない

クライアント管理定義ファイルの内容がすべてコメントで記載されている

●-i 出力対象の認可識別子

〜〈文字列〉((1〜100バイト))

特定のHADBクライアントの認可識別子に適用されている「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」を確認したい場合に指定します。

-iオプションを指定してadbclientdefmangコマンドを実行すると，-iオプションに指定したHADBクライアントの認可識別子と，その認可識別子に適用されている「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」が表示されます。

このオプションに指定する出力対象の認可識別子は，1～100バイトの範囲で指定してください。ただし，出力対象の認可識別子を囲む二重引用符は，1～100バイトには含みません。

認可識別子の規則を満たさない文字列を指定した場合はエラーになります。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

HADBクライアントの認可識別子ADBUSER02に適用されている「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」を表示する例を次に示します。

実行例（-iオプションを指定した場合）

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01' -i ADBUSER02

出力例

authorization-identifier client-definition-file
ADBUSER02                client01.def

なお，-iオプションを省略した場合は，クライアント定義の集中管理機能の対象となるHADBクライアントの認可識別子と，「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」の一覧が出力されます。

実行例（-iオプションを省略した場合）

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01'

出力例

authorization-identifier client-definition-file
ADBUSER01                client01.def
ADBUSER02                client01.def
ADBUSER03                client02.def

10.2.2　クライアント管理定義の形式

クライアント管理定義とは，クライアント管理定義ファイルに指定する定義のことです。クライアント管理定義ファイルでは，「クライアント定義の集中管理機能で使用するクライアント定義ファイル」と，そのクライアント定義ファイルの内容を適用したいHADBクライアントの認可識別子を関連づけます。

クライアント管理定義の詳細については，マニュアルHADB　システム構築・運用ガイドのクライアント定義の集中管理機能で必要なファイルを参照してください。

10.3　使用例

adbclientdefmangコマンドを使用して，次の内容を実行する方法を説明します。

クライアント定義の集中管理機能の内容を適用する方法

特定のHADBクライアントに適用されているクライアント定義ファイル名を確認する方法

10.3.1　クライアント定義の集中管理機能の内容を適用する場合

クライアント定義の集中管理機能の対象となるHADBクライアントに，クライアント定義の集中管理機能の内容を適用します。

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01' --update

--updateオプションを指定してadbclientdefmangコマンドを実行すると，各HADBクライアントに「クライアント定義の集中管理機能で使用するクライアント定義ファイル」の内容が適用されます。

10.3.2　特定のHADBクライアントに適用されているクライアント定義ファイル名を確認する場合

特定のHADBクライアントに適用されている，「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」を確認します。

adbclientdefmang -u ADBUSER01 -p '#HelloHADB_01' -i ADBUSER02

出力例

authorization-identifier client-definition-file
ADBUSER02                client02.def

HADBクライアントの認可識別子ADBUSER02と対応する，「クライアント定義の集中管理機能で使用するクライアント定義ファイル名」（client02.def）が出力されます。出力されたクライアント定義ファイルの内容が，HADBクライアントの認可識別子ADBUSER02に適用されています。

10.4　リターンコード

adbclientdefmangコマンドのリターンコードを次の表に示します。

表10‒1　adbclientdefmangコマンドのリターンコード

リターンコード

意味

0

adbclientdefmangコマンドが正常に終了しました。

4

adbclientdefmangコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

adbclientdefmangコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

10.5　注意事項

adbclientdefmangコマンドは，HADBサーバが稼働中に実行できます。

--updateオプションを指定してadbclientdefmangコマンドを実行した場合，クライアント定義の集中管理機能を適用したHADBクライアントの認可識別子で，HADBサーバに接続済みのAPに変更内容は適用されません。一度APをHADBサーバから切り離して，次に接続したタイミングで，クライアント定義の集中管理機能の内容が適用されます。

クライアント定義の集中管理機能が無効な状態で，--updateオプションを省略してadbclientdefmangコマンドを実行した場合，「authorization-identifier client-definition-file」だけが出力されます。

adbclientdefmangコマンドは，複数同時に実行できません。複数同時に実行した場合は，エラーになります。

マルチノード機能を使用する場合は，プライマリノードでadbclientdefmangコマンドを実行してください。セカンダリノードおよびワーカーノードで，adbclientdefmangコマンドは実行できません。

HAモニタありのマルチノード構成の場合は，--updateオプションを指定してadbclientdefmangコマンドを実行する前に，プライマリノードおよび起動中のセカンダリノードのクライアント管理定義ファイルの内容を統一してください。

プライマリノードおよび起動中のセカンダリノードのクライアント管理定義ファイルの内容が不一致のまま，--updateオプションを指定したadbclientdefmangコマンドを実行すると，エラーになります。

HADBサーバが停止している状態で，adbclientdefmangコマンドを実行すると，エラーメッセージが出力されます。HADBサーバが停止している状態でクライアント定義の集中管理機能の内容を変更したい場合は，クライアント管理定義ファイルを変更してから，HADBサーバを起動してください。

adbclientdefmangコマンドの実行時，次の表に示すファイルにアクセスします。adbclientdefmangコマンドを実行する前に，各ファイルに次の表に示すパーミッションを設定してください。

表10‒2　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

クライアント管理定義ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

クライアント管理定義のadbclientmangオペランドの-fオプションに指定したクライアント定義の集中管理機能で使用するクライアント定義ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

11　adbcolumnize（更新行のカラム化機能の管理）

この章では，adbcolumnizeコマンドの機能と使い方について説明します。

11.1　機能

adbcolumnizeコマンドは，更新行のカラム化機能の管理を行う際に実行するコマンドです。

更新行のカラム化機能の詳細については，マニュアルHADB　システム構築・運用ガイドの更新行のカラム化機能の運用（カラムストア表の検索性能の維持）を参照してください。

adbcolumnizeコマンドでは，次の3つの操作を実施できます。

更新行のカラム化機能の有効化

更新行のカラム化機能の無効化

更新行のカラム化機能の状態の表示

11.2　adbcolumnizeコマンドの指定形式

adbcolumnizeコマンドの指定形式，およびオプションについて説明します。

adbcolumnizeコマンドを実行できるOSユーザは，HADB管理者だけです。

11.2.1　指定形式およびオプションの説明

(1)　指定形式

adbcolumnize ｛--start | --stop | -d｝

(2)　オプションの説明

●--start

更新行のカラム化機能を有効にしたい場合に指定します。

このオプションを指定すると，更新行のカラム化機能が有効になり，メンテナンス処理が開始されます。

●--stop

更新行のカラム化機能を無効にしたい場合に指定します。

このオプションを指定すると，更新行のカラム化機能が無効になり，メンテナンス処理は実行されません。なお，実行中のメンテナンス処理は中断されます。

●-d

更新行のカラム化機能の状態を確認したい場合に指定します。

このオプションを指定すると，更新行のカラム化機能が有効であるか無効であるかを確認できます。

11.3　使用例

adbcolumnizeコマンドを使用して，次の内容を実行する方法を説明します。

更新行のカラム化機能を有効にする方法

更新行のカラム化機能の状態を表示する方法

11.3.1　更新行のカラム化機能を有効にする場合

更新行のカラム化機能を有効にします。

adbcolumnize --start

adbcolumnize --startコマンドを実行すると，更新行のカラム化機能が有効になります。

11.3.2　更新行のカラム化機能の状態を表示する場合

更新行のカラム化機能の状態を表示します。

adbcolumnize -d

adbcolumnize -dコマンドを実行すると，更新行のカラム化機能の状態が標準出力に出力されます。出力結果で更新行のカラム化機能が有効であるか無効であるかを確認できます。

出力例

STATUS
ACTIVE

出力項目の説明

STATUS：

更新行のカラム化機能の状態が表示されます。次のどちらかが表示されます。

ACTIVE

更新行のカラム化機能は有効です。

INACTIVE

更新行のカラム化機能は無効です。

11.4　リターンコード

adbcolumnizeコマンドのリターンコードを次の表に示します。

表11‒1　adbcolumnizeコマンドのリターンコード

リターンコード

意味

0

adbcolumnizeコマンドが正常に終了しました。

4

adbcolumnizeコマンドの実行中に警告メッセージが出力されました。警告メッセージの内容については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

8

adbcolumnizeコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

11.5　注意事項

adbcolumnizeコマンドは，HADBサーバが稼働中に実行できます。

マルチノード機能を使用している場合，adbcolumnizeコマンドを実行できるのはプライマリノードだけです。

マルチノード機能を使用している場合，ノード復帰中のノードが存在していると，adbcolumnizeコマンドを実行できません。

マルチノード機能を使用している場合，ワーカーノードの追加処理中は，adbcolumnizeコマンドを実行できません。

HADBサーバの稼働モードが静止モードの場合，adbcolumnizeコマンドを実行できません。

adbcolumnizeコマンドを実行できるのは，サーバマシンだけです。

adbcolumnizeコマンドで変更した更新行のカラム化機能の状態は，HADBサーバを再起動したあとも引き継がれます。したがって，HADBサーバの再起動前に更新行のカラム化機能を有効にしていた場合は，HADBサーバの再起動後にadbcolumnizeコマンドで更新行のカラム化機能を再度有効にする必要はありません。

12　adbconvertaudittrailfile（監査証跡ファイルの変換）

この章では，adbconvertaudittrailfileコマンドの機能と使い方について説明します。

12.1　機能

adbconvertaudittrailfileコマンドの機能，および統一フォーマット用監査証跡ファイルの切り替えについて説明します。

adbconvertaudittrailfileコマンドは，コマンド実行時にHADBサーバに接続します。

なお，このコマンドは監査証跡機能が有効な場合にだけ実行できます。

12.1.1　機能概要

adbconvertaudittrailfileコマンドは，HADBサーバの監査証跡をJP1/Audit Management - Manager（JP1/Audit）で収集・管理する場合に，実行するコマンドです。

adbconvertaudittrailfileコマンドを実行すると，監査証跡ファイル内の監査証跡を，JP1/Auditが扱える形式（統一フォーマット形式）に変換できます。adbconvertaudittrailfileコマンドで変換した監査証跡は，統一フォーマット用監査証跡ファイルに出力されます。

adbconvertaudittrailfileコマンドの処理概要を次の図に示します。

図12‒1　adbconvertaudittrailfileコマンドの処理概要

［説明］

adbconvertaudittrailfileコマンドを実行すると，HADBサーバの監査証跡ファイル内にある監査証跡は，JP1/Auditが扱える形式（統一フォーマット形式）に変換されます。変換結果は，統一フォーマット用監査証跡の出力先ディレクトリ下にある統一フォーマット用監査証跡ファイルに出力されます。この処理を，監査証跡ファイルの変換といいます。

■統一フォーマット用監査証跡ファイル

adbconvertaudittrailfileコマンドで変換された監査証跡が出力されるファイルです。変換された監査証跡は，JP1/Auditで収集・管理できます。

統一フォーマット用監査証跡ファイルの詳細については，「12.1.2　統一フォーマット用監査証跡ファイルの切り替え」を参照してください。

監査証跡機能とJP1/Auditとの連携については，マニュアルHADB　システム構築・運用ガイドの監査証跡機能とJP1/Audit Management - Managerとの連携を参照してください。

メモ

現用の監査証跡ファイルは変換できません。現用の監査証跡ファイルを変換したい場合は，adbaudittrail --swapコマンドを実行し，現用の監査証跡ファイルを切り替える必要があります。

12.1.2　統一フォーマット用監査証跡ファイルの切り替え

adbconvertaudittrailfileコマンドで変換した監査証跡は，統一フォーマット用監査証跡の出力先ディレクトリ下の統一フォーマット用監査証跡ファイルに出力されます。

統一フォーマット用監査証跡ファイル（adbcommonauditXX.log）は，最大4つ作成されます。ファイル名のXXは通番であり，01～04のどれかになります。

変換した監査証跡が出力されている統一フォーマット用監査証跡ファイルが最大容量（512メガバイト）に達すると，HADBサーバは新たに統一フォーマット用監査証跡ファイルを作成します。そして，作成した統一フォーマット用監査証跡ファイルに切り替えて，変換した監査証跡の出力を続けます。これらの処理を，統一フォーマット用監査証跡ファイルの切り替えといいます。

すでに，切り替え先の統一フォーマット用監査証跡ファイルが存在する場合は，その統一フォーマット用監査証跡ファイルをいったん削除します。そして，同一ファイル名で新たに作成し直したあと，変換した監査証跡の出力を続けます。

統一フォーマット用監査証跡ファイルの切り替えの概要について，次の図に示します。

図12‒2　統一フォーマット用監査証跡ファイルの切り替え

［説明］

adbconvertaudittrailfileコマンドを実行すると，HADBサーバは統一フォーマット用監査証跡ファイル（adbcommonaudit01.log）を作成し，変換した監査証跡を出力します。

統一フォーマット用監査証跡ファイル（adbcommonaudit01.log）が最大容量（512メガバイト）に達すると，次の出力先となる統一フォーマット用監査証跡ファイル（adbcommonaudit02.log）を作成します。

出力先を，統一フォーマット用監査証跡ファイル（adbcommonaudit02.log）に変更して，監査証跡の出力を続けます。

1.～3.と同様の動作を繰り返します。統一フォーマット用監査証跡ファイル（adbcommonaudit04.log）が最大容量に達すると，統一フォーマット用監査証跡ファイル（adbcommonaudit01.log）をいったん削除します。そのあと，同じ名前のファイルを新たに作成します。

出力先を，統一フォーマット用監査証跡ファイル（adbcommonaudit01.log）に変更して，監査証跡の出力を続けます。

12.2　adbconvertaudittrailfileコマンドの指定形式

adbconvertaudittrailfileコマンドの指定形式およびオプションについて説明します。

adbconvertaudittrailfileコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

12.2.1　指定形式およびオプションの説明

(1)　指定形式

adbconvertaudittrailfile -u 認可識別子
                        〔-p パスワード〕
                         --common
                         -d 統一フォーマット用監査証跡の出力先ディレクトリパス
                         監査証跡ファイルパス

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbconvertaudittrailfileコマンドを実行するHADBユーザの認可識別子を指定します。adbconvertaudittrailfileコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

監査参照権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbconvertaudittrailfileコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●--common

監査証跡ファイルを，統一フォーマット用監査証跡ファイルに変換するときに指定します。

●-d 統一フォーマット用監査証跡の出力先ディレクトリパス

〜〈パス名〉((2〜510バイト))

統一フォーマット用監査証跡の出力先ディレクトリを絶対パスで指定します。

adbconvertaudittrailfileコマンドを実行する前に，統一フォーマット用監査証跡の出力先ディレクトリを作成しておいてください。詳細については，マニュアルHADB　システム構築・運用ガイドの監査証跡機能とJP1/Auditを連携する際の環境設定のHADBサーバの環境設定を参照してください。

●監査証跡ファイルパス

〜〈文字列〉((2〜1,024バイト))

変換対象の監査証跡ファイルを絶対パスで指定します。

ただし，現用の監査証跡ファイルは変換できません。現用の監査証跡ファイルを変換したい場合は，adbaudittrail --swapコマンドを実行し，現用の監査証跡ファイルを切り替えてください。そのあとで，リネームされた監査証跡ファイルの絶対パスを，このオプションに指定してください。

なお，GZIP形式で圧縮した監査証跡ファイルも変換することができます。

12.3　使用例

adbconvertaudittrailfileコマンドを実行して監査証跡ファイルを変換する方法を，例題形式で説明します。

12.3.1　最新の監査証跡ファイルを変換する場合

監査証跡ファイル内の監査証跡をadbconvertaudittrailfileコマンドで変換して，統一フォーマット用監査証跡ファイルに出力します。このとき，次に示す手順でadbconvertaudittrailfileコマンドを実行します。

なお，この手順は，統一フォーマット用監査証跡の出力先ディレクトリ（/mnt/audittrail/adbcommon/）が作成されていることを前提としています。

手順

現用の監査証跡ファイルを切り替える

リネームされた監査証跡ファイルのパスを特定する

adbconvertaudittrailfileコマンドを実行する

各手順の例を以降で説明します。

(1)　現用の監査証跡ファイルを切り替える

監査管理権限を持つHADBユーザの認可識別子を指定して，adbaudittrail --swapコマンドを実行し，現用の監査証跡ファイルを切り替えます。

adbaudittrailコマンドの指定例

adbaudittrail -u ADBAUDITADMIN -p '#HelloHADB_ADMIN' --swap

(2)　リネームされた監査証跡ファイルのパスを特定する

現用の監査証跡ファイルの切り替え時に出力されたKFAA81401-Iメッセージを確認して，リネームされた監査証跡ファイル（変換できる最新の監査証跡ファイル）のパスを特定します。リネームされた監査証跡ファイルのパスは，次に示す例の下線部分に表示されます。

KFAA81401-Iメッセージの出力例

KFAA81401-I The file to which the audit trail is output was swapped.
(file name = /mnt/audittrail/outputarea/audit/adbaud-20180101-123456-789.aud)

(3)　adbconvertaudittrailfileコマンドを実行する

adbconvertaudittrailfile
  -u ADBAUDITVIEWER                                                 ...1
  -p '#HelloHADB_VIEWER'                                            ...2
  --common                                                          ...3
  -d /mnt/audittrail/adbcommon/                                     ...4
  /mnt/audittrail/outputarea/audit/adbaud-20180101-123456-789.aud   ...5

［説明］

監査参照権限を持つHADBユーザの認可識別子を指定します。

HADBユーザの認可識別子のパスワードを指定します。

--commonオプションを指定します。

統一フォーマット用監査証跡の出力先ディレクトリのパスを指定します。

「(2)　リネームされた監査証跡ファイルのパスを特定する」で特定した，リネームされた監査証跡ファイルのパスを指定します。

12.4　リターンコード

adbconvertaudittrailfileコマンドのリターンコードを次の表に示します。

表12‒1　adbconvertaudittrailfileコマンドのリターンコード

リターンコード

意味

0

adbconvertaudittrailfileコマンドが正常に終了しました。

4

adbconvertaudittrailfileコマンドは正常に終了しましたが，警告メッセージ，またはエラーメッセージが出力されました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbconvertaudittrailfileコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

12.5　注意事項

adbconvertaudittrailfileコマンドは，監査証跡機能が有効なときに実行できます。

統一フォーマット用監査証跡ファイルの文字コードは，変換対象の監査証跡ファイルを出力したHADBサーバの文字コードと同一になります。

adbconvertaudittrailfileコマンドを実行する場合，次のすべての条件を満たしている必要があります。条件を満たしていない場合，adbconvertaudittrailfileコマンドがエラーになります。

-dオプションに，存在するディレクトリを指定している

-dオプションに指定されたディレクトリに対して，HADB管理者がアクセスできるように書き込み権限，読み取り権限および実行権限を設定している

現用の監査証跡ファイルを変換することはできません。現用の監査証跡ファイルを変換したい場合は，adbaudittrail --swapコマンドを実行して，現用の監査証跡ファイルを切り替えてください。そのあと，リネームされた監査証跡ファイルを，adbconvertaudittrailfileコマンドの監査証跡ファイルパスに指定して変換してください。

adbconvertaudittrailfileコマンドの処理は，adbcancelコマンドによって強制終了できます。

adbconvertaudittrailfileコマンドは複数同時に実行できません。複数のadbconvertaudittrailfileコマンドを同時実行した場合はエラーとなります。ただし，マルチノード機能を使用する場合，実行するノードが別であればadbconvertaudittrailfileコマンドを同時実行できます。

マルチノード機能を使用する場合，変換対象の監査証跡ファイルが存在するノードでadbconvertaudittrailfileコマンドを実行してください。

指定した監査証跡ファイルが破損している場合，ファイル内の監査証跡は変換されないおそれがあります。または，破損している個所以降の監査証跡は変換されないおそれがあります。

統一フォーマット用監査証跡ファイルは，ラウンドロビン方式で切り替わります。そのため，4つ目の統一フォーマット用監査証跡ファイルが満杯になると，1つ目の統一フォーマット用監査証跡ファイルは削除されます。そして，1つ目の統一フォーマット用監査証跡ファイルが新たに作成されます。

統一フォーマット用監査証跡ファイルが削除されると困る場合は，必要に応じて，統一フォーマット用監査証跡ファイルのバックアップを取得してください。

200万件を超える監査証跡を1回のadbconvertaudittrailfileコマンドで変換する場合，統一フォーマット用監査証跡ファイルが高速でラップアラウンドすることがあります。この場合，JP1/Auditによる監査証跡の収集が漏れるおそれがあります。監査証跡ファイル1つ当たりに出力される監査証跡が200万件を超えないように，サーバ定義adb_audit_log_max_sizeオペランドにはデフォルト値（256メガバイト）を指定することを推奨します。サーバ定義adb_audit_log_max_sizeオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義のオペランドの内容の監査証跡機能に関するオペランド（set形式）を参照してください。

adbconvertaudittrailfileコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbconvertaudittrailfileコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表12‒2　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※

必要な権限

統一フォーマット用監査証跡の出力先ディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

監査証跡ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

13　adbdbstatus（データベースの状態解析）

この章では，adbdbstatusコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。また，出力例は見やすさを考慮して項目の間隔を調整しています。実際の出力結果は左詰めで表示されます。

13.1　機能

adbdbstatusコマンドの機能，および出力結果の種類について説明します。

adbdbstatusコマンドは，コマンド実行時にHADBサーバに接続します。

13.1.1　機能概要

adbdbstatusコマンドを実行すると，データベースの使用量，状態や，カラムストア表の再編成が必要かどうかなどの情報が出力されます。adbdbstatusコマンドの対象となるDBエリアは，データ用DBエリア，ディクショナリ用DBエリアおよびシステム表用DBエリアです。

adbdbstatusコマンドの概要を次の図に示します。

図13‒1　adbdbstatusコマンドの概要

［説明］

adbdbstatusコマンドを実行すると，データ用DBエリア，ディクショナリ用DBエリアおよびシステム表用DBエリアの情報が，標準出力にCSV形式で出力されます。出力結果をリダイレクションでファイルに出力して表計算ソフトなどに転送すると，データベースの使用量，状態や，カラムストア表の再編成が必要かどうかなどを表形式で確認できます。

13.1.2　adbdbstatusコマンドの出力結果の種類

adbdbstatusコマンドの出力結果には，サマリ情報，使用量情報，再編成要否の情報の3種類があります。

各情報で出力される内容について，次に示します。

解析する対象によって，サマリ情報は，さらに4種類に分けられます。また，使用量情報は，さらに2種類に分けられます。

サマリ情報

DBエリアのサマリ情報

DBエリアの使用量が出力されます。DBエリアのサマリ情報で出力される項目の詳細については，「13.3　DBエリアのサマリ情報で出力される項目」を参照してください。

表のサマリ情報

表の使用量および状態が出力されます。表のサマリ情報で出力される項目の詳細については，「13.4　表のサマリ情報で出力される項目」を参照してください。

インデクスのサマリ情報

インデクスの使用量および状態が出力されます。インデクスのサマリ情報で出力される項目の詳細については，「13.5　インデクスのサマリ情報で出力される項目」を参照してください。

アーカイブ状態のチャンクのサマリ情報

アーカイブマルチチャンク表に作成されたチャンクの使用量および状態が出力されます。アーカイブ状態のチャンクのサマリ情報で出力される項目の詳細については，「13.6　アーカイブ状態のチャンクのサマリ情報で出力される項目」を参照してください。

使用量情報

DBエリア，表とインデクスの使用量情報

DBエリア，表およびインデクスの詳細な使用量が出力されます。

なお，マルチチャンク表の使用量は，表中のチャンクごとにそれぞれ出力されます。DBエリア，表とインデクスの使用量情報で出力される項目の詳細については，「13.7　DBエリア，表とインデクスの使用量情報で出力される項目」を参照してください。

アーカイブ状態のチャンクの使用量情報

アーカイブマルチチャンク表に作成されたアーカイブ状態のチャンクや，そのチャンクに対応するアーカイブファイル（アーカイブ状態のチャンクのデータが格納されたファイル）の詳細な使用量が出力されます。

アーカイブ状態のチャンクの使用量情報で出力される項目の詳細については，「13.8　アーカイブ状態のチャンクの使用量情報で出力される項目」を参照してください。

再編成要否の情報

カラムストア表の再編成が必要かどうかを示す情報が出力されます。

なお，マルチチャンク表かつカラムストア表の再編成要否の情報は，表中のチャンクごとにそれぞれ出力されます。ただし，削除仕掛中のチャンクの情報は出力されません。再編成要否の情報で出力される項目の詳細については，「13.9.2　再編成要否の情報で出力される項目の一覧」を参照してください。

13.2　adbdbstatusコマンドの指定形式

adbdbstatusコマンドの指定形式およびオプションについて説明します。

adbdbstatusコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

adbdbstatusコマンドは，出力する情報の種類によって指定形式が異なります。

サマリ情報を出力する場合

「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

使用量情報を出力する場合

「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

カラムストア表の再編成要否の情報を出力する場合

「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」を参照してください。

13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】

(1)　指定形式

adbdbstatusコマンドの指定形式（サマリ情報または使用量情報を出力する場合）を次に示します。

カラムストア表の再編成要否の情報を出力する場合の指定形式については，「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(1)　指定形式」を参照してください。

adbdbstatus
  〔-d ｛summary｜used｝〕
  〔-c ｛dbarea｜table｜index｜archivechunk｝〕
  〔-n ｛DBエリア名｜表名｜インデクス名｝〕
  〔-t〕
  〔-k 囲み文字〕
  〔-s ｛区切り文字｜tab｝〕
  〔-S ｛K｜M｜G｝〕
  〔-r 範囲指定〕
  〔--shared-lock〕
  〔--timeout タイムアウト時間〕

(2)　出力する情報と指定するオプションの関係

adbdbstatusコマンドでサマリ情報または使用量情報を出力する場合，次に示すオプションの組み合わせで，出力する情報の種類が決まります。

-dオプション

-cオプション

-nオプション

実行したい状態解析のパターン，出力する情報の種類，およびオプションの組み合わせの関係について，次の表に示します。各オプションの詳細については，「(3)　オプションの説明」の-dオプション，-cオプション，および-nオプションの説明を参照してください。

表13‒1　状態解析のパターン，出力する情報の種類，およびオプションの組み合わせの関係

項番

状態解析のパターン

出力する情報の種類

オプションの組み合わせ

解析の対象

解析したい内容

-dオプションの指定

-cオプションの指定

-nオプションの指定

1

データベース全体（すべてのDBエリア）

DBエリアの使用量を解析したい

DBエリアのサマリ情報

summaryまたは指定なし

dbareaまたは指定なし

−

2

DBエリアファイルやチャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

dbareaまたは指定なし

−

3

特定のDBエリア

DBエリアの使用量を解析したい

DBエリアのサマリ情報

summaryまたは指定なし

dbareaまたは指定なし

DBエリア名

4

DBエリアファイルやチャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

dbareaまたは指定なし

DBエリア名

5

すべての表

表の使用量および状態を解析したい

表のサマリ情報

summaryまたは指定なし

table

−

6

表が格納されているDBエリアのDBエリアファイルや，チャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

table

−

7

特定の表

表の使用量および状態を解析したい

表のサマリ情報

summaryまたは指定なし

table

表名

8

表が格納されているDBエリアのDBエリアファイルや，チャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

table

表名

9

すべてのインデクス

インデクスの使用量および状態を解析したい

インデクスのサマリ情報

summaryまたは指定なし

index

−

10

インデクスが格納されているDBエリアのDBエリアファイルや，チャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

index

−

11

特定のインデクス

インデクスの使用量および状態を解析したい

インデクスのサマリ情報

summaryまたは指定なし

index

インデクス名

12

インデクスが格納されているDBエリアのDBエリアファイルや，チャンクの使用量を解析したい

DBエリア，表とインデクスの使用量情報

used

index

インデクス名

13

特定の表に作成されたアーカイブ状態のチャンク

マルチチャンク表に作成されたチャンクの使用量および状態を解析したい

アーカイブ状態のチャンクのサマリ情報

summaryまたは指定なし

archivechunk

表名

14

アーカイブ状態のチャンクに対応している各アーカイブファイルの使用量を解析したい

アーカイブ状態のチャンクの使用量情報

used

archivechunk

表名

（凡例）

−：-nオプションを指定しません。

(3)　オプションの説明

adbdbstatusコマンドのオプション（サマリ情報または使用量情報を出力する場合）について説明します。カラムストア表の再編成要否の情報を出力する場合のオプションについては，「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(2)　オプションの説明」を参照してください。

●-d ｛summary｜used｝

出力結果の種類を指定します。

summary：サマリ情報

サマリ情報で出力される項目の詳細については，次に示す内容を参照してください。

「13.3　DBエリアのサマリ情報で出力される項目」

「13.4　表のサマリ情報で出力される項目」

「13.5　インデクスのサマリ情報で出力される項目」

「13.6　アーカイブ状態のチャンクのサマリ情報で出力される項目」

used：使用量情報

使用量情報で出力される項目の詳細については，次に示す内容を参照してください。

「13.7　DBエリア，表とインデクスの使用量情報で出力される項目」

「13.8　アーカイブ状態のチャンクの使用量情報で出力される項目」

●-c ｛dbarea｜table｜index｜archivechunk｝

adbdbstatusコマンドで情報を取得する範囲を指定します。

dbarea：DBエリア

DBエリアの情報を取得する場合に指定します。

table：表

表の情報を取得する場合に指定します。

index：インデクス

インデクスの情報を取得する場合に指定します。

archivechunk：表に作成されたアーカイブ状態のチャンク

表に作成されたアーカイブ状態のチャンクの情報を取得する場合に指定します。

なお，archivechunkを指定した場合は，-nオプションにアーカイブマルチチャンク表の表名を必ず指定する必要があります。

●-n ｛DBエリア名｜表名｜インデクス名｝

〜〈文字列〉

特定のDBエリア，表，またはインデクスの情報だけを取得したい場合，このオプションで名称を指定します。

DBエリア名：

情報を取得するDBエリア名を指定します。

-cオプションを省略した場合，または-cオプションにdbareaを指定した場合に指定できます。ただし，作業表用DBエリア名（ADBWRK），およびマスタディレクトリ用DBエリア名（ADBMST）は指定できません。

表名：

表名を「スキーマ名.表識別子」の形式で指定します。スキーマ名は省略できません。ビュー表を指定すると，エラーになります。

-cオプションにtableを指定した場合に指定できます。

また，-cオプションにarchivechunkを指定した場合は，アーカイブマルチチャンク表の表名を必ず指定する必要があります。

ディクショナリ表（実表）およびシステム表（実表）の表名を指定する場合は，スキーマ名に「HADB」を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

インデクス名：

インデクス名を「スキーマ名.インデクス識別子」の形式で指定します。スキーマ名は省略できません。

-cオプションにindexを指定した場合に指定できます。

なお，主キーに対応するB-treeインデクスの情報を取得する場合は，自動的に生成されたインデクス識別子（制約名と同じ）を指定する必要があります。主キーに対応するB-treeインデクスのインデクス識別子を調べる方法については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の検索を参照してください。

ディクショナリ表（実表）およびシステム表（実表）に定義されているインデクスを指定する場合は，スキーマ名に「HADB」を指定してください。

DBエリア名またはインデクス名の指定時の規則を次に示します。

指定した文字列は，すべて英大文字として扱われます。

名称の文字列中に英小文字が含まれる場合は，名称を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲んでください。二重引用符（"）およびアポストロフィ（'）で囲まないと，名称はすべて英大文字として扱われます。

（例）-n '"ADBuser01"'.'"Index01"'

DBエリア，表，およびインデクスの名称規則については，マニュアルHADB　SQLリファレンスの基本項目のSQLの記述規則の名前の指定を参照してください。

●-t

タイトル行を出力しない場合に指定します。

●-k 囲み文字

〜〈文字列〉((1バイト))《"》

CSV形式での文字列の囲み文字を指定します。このオプションを省略した場合は，囲み文字として二重引用符（"）が仮定されます。

囲み文字として指定できる文字は，1バイト文字だけです。2バイト以上の文字列は指定できません。また，次に示す文字も囲み文字として指定できません。

空白，タブ，アスタリスク（*）

区切り文字（-sオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を囲み文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を囲み文字として指定する場合の例

adbdbstatus …　-k "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を囲み文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を囲み文字として指定する場合の例

adbdbstatus …　-k "|" …

adbdbstatusコマンドで出力される列のタイトルおよび内容に含まれる文字を囲み文字に指定しないでください。adbdbstatusコマンドで出力される列については，次に示す内容を参照してください。

・「13.3.2　DBエリアのサマリ情報で出力される項目の一覧」

・「13.4.2　表のサマリ情報で出力される項目の一覧」

・「13.5.2　インデクスのサマリ情報で出力される項目の一覧」

・「13.6.2　アーカイブ状態のチャンクのサマリ情報で出力される項目の一覧」

・「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」

・「13.8.2　アーカイブ状態のチャンクの使用量情報で出力される項目の一覧」

●-s ｛区切り文字｜tab｝

〜〈文字列〉((1バイト))《 , 》

CSV形式での区切り文字を指定します。区切り文字にタブを指定する場合は，tabを指定してください。このオプションを省略した場合は，区切り文字としてコンマ（ , ）が仮定されます。

区切り文字として指定できる文字は，tabまたは1バイト文字だけです。tab以外の2バイト以上の文字列は指定できません。また，次に示す文字も区切り文字として指定できません。

英大文字（A〜Z），英小文字（a〜z），数字（0〜9），下線（_），二重引用符（"），アスタリスク（*）

囲み文字（-kオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を区切り文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を区切り文字として指定する場合の例

adbdbstatus …　-s "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を区切り文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を区切り文字として指定する場合の例

adbdbstatus …　-s "|" …

adbdbstatusコマンドで出力される列のタイトルおよび内容に含まれる文字を区切り文字に指定しないでください。adbdbstatusコマンドで出力される列については，次に示す内容を参照してください。

・「13.3.2　DBエリアのサマリ情報で出力される項目の一覧」

・「13.4.2　表のサマリ情報で出力される項目の一覧」

・「13.5.2　インデクスのサマリ情報で出力される項目の一覧」

・「13.6.2　アーカイブ状態のチャンクのサマリ情報で出力される項目の一覧」

・「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」

・「13.8.2　アーカイブ状態のチャンクの使用量情報で出力される項目の一覧」

●-S ｛K｜M｜G｝

使用量に関する出力項目を，セグメント数やページ数ではなく，キロバイト単位，メガバイト単位またはギガバイト単位で表示したい場合に指定します。

このオプションの指定を省略した場合，使用量に関する出力項目の表示単位は，セグメント数またはページ数になります。

K：キロバイト

使用量に関する出力項目を，キロバイト単位で表示したい場合に指定します。

M：メガバイト

使用量に関する出力項目を，メガバイト単位で表示したい場合に指定します。

G：ギガバイト

使用量に関する出力項目を，ギガバイト単位で表示したい場合に指定します。

このオプションを指定すると，表示単位にあわせて，該当する出力項目の列のタイトルも変更されます。このオプションの指定値と，出力項目の表示単位，および列のタイトルの関係を次の表に示します。

表13‒2　使用量に関する出力項目の表示単位と列のタイトル

項番

情報の種類

出力項目

このオプションの指定値

出力項目の表示単位

列のタイトル

1

DBエリアのサマリ情報

DBエリアの使用中セグメント数

−

セグメント数

Used_segments

2

K

キロバイト

KB_Used_segments

3

M

メガバイト

MB_Used_segments

4

G

ギガバイト

GB_Used_segments

5

DBエリアの総セグメント数

−

セグメント数

Total_segments

6

K

キロバイト

KB_Total_segments

7

M

メガバイト

MB_Total_segments

8

G

ギガバイト

GB_Total_segments

9

表のサマリ情報

表の使用中セグメント数

−

セグメント数

Used_segments

10

K

キロバイト

KB_Used_segments

11

M

メガバイト

MB_Used_segments

12

G

ギガバイト

GB_Used_segments

13

表の使用中ページ数

−

ページ数

Used_pages

14

K

キロバイト

KB_Used_pages

15

M

メガバイト

MB_Used_pages

16

G

ギガバイト

GB_Used_pages

17

インデクスのサマリ情報

インデクスの使用中セグメント数

−

セグメント数

Used_segments

18

K

キロバイト

KB_Used_segments

19

M

メガバイト

MB_Used_segments

20

G

ギガバイト

GB_Used_segments

21

インデクスの使用中ページ数

−

ページ数

Used_pages

22

K

キロバイト

KB_Used_pages

23

M

メガバイト

MB_Used_pages

24

G

ギガバイト

GB_Used_pages

25

DBエリア，表とインデクスの使用量情報

使用中セグメント数

−

セグメント数

Used_segments

26

K

キロバイト

KB_Used_segments

27

M

メガバイト

MB_Used_segments

28

G

ギガバイト

GB_Used_segments

29

使用中ページ数

−

ページ数

Used_pages

30

K

キロバイト

KB_Used_pages

31

M

メガバイト

MB_Used_pages

32

G

ギガバイト

GB_Used_pages

33

DBエリアファイル内の総セグメント数

−

セグメント数

Total_segments

34

K

キロバイト

KB_Total_segments

35

M

メガバイト

MB_Total_segments

36

G

ギガバイト

GB_Total_segments

37

DBエリアファイル内の初期化済みページ数

−

ページ数

Initialized_pages

38

K

キロバイト

KB_Initialized_pages

39

M

メガバイト

MB_Initialized_pages

40

G

ギガバイト

GB_Initialized_pages

（凡例）

−：このオプションを省略します。

●-r 範囲指定

アーカイブ状態のチャンクの情報を出力したい場合に，チャンクの情報を出力する範囲を指定します。-rオプションの詳細については，「(4)　-rオプション（範囲指定）の詳細」を参照してください。

●--shared-lock

adbdbstatusコマンドの排他制御を変更する場合に指定します。次のコマンドやSQL文とadbdbstatusコマンドを同時に実行したい場合は，このオプションを指定してください。

adbimportコマンド（バックグラウンドインポートを実行したとき）

adbmergechunkコマンド

更新系SQL（INSERT文，DELETE文，UPDATE文）

--shared-lockオプションを指定した場合の排他制御については，マニュアルHADB　システム構築・運用ガイドの確保される排他資源と排他制御モードを参照してください。

--shared-lockオプションを指定したadbdbstatusコマンドを実行すると，一部の出力項目を取得できません。また，--shared-lockオプションを指定したadbdbstatusコマンドと，データベースを更新するトランザクションを同時に実行すると，一部の出力項目の値が不整合になることがあります。詳細については，下記を参照してください。

重要

--shared-lockオプションを指定したときの出力項目の詳細については，「13.4.2　表のサマリ情報で出力される項目の一覧」，「13.5.2　インデクスのサマリ情報で出力される項目の一覧」および「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」を参照してください。

■--shared-lockオプションを指定すると取得できない出力項目

--shared-lockオプションを指定した場合，次に示す出力項目は取得できません。常にno_checkが表示されます。

表のサマリ情報

表の更新不可状態（Non-updatable），およびコマンドの終了状態（Command_status）

インデクスのサマリ情報

一意性制約違反状態（Unique_constraint_violated），およびインデクスの未完状態（Unfinished）

また，--shared-lockオプションを指定した場合，次の表やインデクスに対応する削除仕掛中のチャンクに関する情報は出力されません。

システム表（実表）

システム表（実表）に定義されたインデクス

adbmergechunkコマンド実行中の表

adbmergechunkコマンド実行中の表に定義されたインデクス

■--shared-lockオプションを指定したときの出力項目に関する制限事項

次のコマンドを実行している表に対して，--shared-lockオプションを指定してadbdbstatusコマンドを実行した場合，セグメント数，ページ数またはチャンク数に関する出力項目には，最新の値が出力されないことがあります（次のコマンドが開始されたときの値が出力されることがあります）。そのため，ほかの出力項目の値と不整合になることがあります。

adbimportコマンド（バックグラウンドインポートを実行したとき）

adbidxrebuildコマンド（バックグラウンドインポートが中断したあとに，--create-temp-fileオプションを指定して実行したとき）

adbmergechunkコマンド

adbreorgsystemdataコマンド

なお，次の情報を出力する場合に，--shared-lockオプションを指定するとadbdbstatusコマンドがエラーになります。

DBエリアのサマリ情報

-dオプションにsummaryを指定（または-dオプションを省略）して，-cオプションにdbareaを指定（または-cオプションを省略）したとき。

アーカイブ状態のチャンクのサマリ情報

-dオプションにsummaryを指定（または-dオプションを省略）して，-cオプションにarchivechunkを指定したとき。

アーカイブ状態のチャンクの使用量情報

-dオプションにusedを指定して，-cオプションにarchivechunkを指定したとき。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbdbstatusコマンドがタイムアウトになるまでの時間を指定します。

adbdbstatusコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbdbstatusコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbdbstatusコマンドのタイムアウト時間は設定されません。adbdbstatusコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbdbstatusコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbdbstatusコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbdbstatusコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

他ノードで実行中のトランザクションの終了待ち中

(4)　-rオプション（範囲指定）の詳細

アーカイブ状態のチャンクの情報を出力したい場合に，チャンクの情報を出力する範囲を，-rオプションで指定します。範囲指定に指定した範囲に，アーカイブレンジ列（アーカイブマルチチャンク表の検索時に，検索範囲を絞り込むために使用する列）の値の範囲が一部でも含まれている場合，該当するチャンクの情報が出力対象となります。該当するチャンクが存在しない場合，情報は出力されません。

範囲指定は，アーカイブレンジ列のデータ型に基づき，解釈されます。

範囲指定の種類と詳細な説明の参照先を次の表に示します。

表13‒3　範囲指定の種類および参照先

項番

範囲指定の種類

参照先

1

日付の範囲指定

「(a)　日付の範囲指定」

2

時刻の範囲指定

「(b)　時刻の範囲指定」

3

時刻印の範囲指定

「(c)　時刻印の範囲指定」

4

固定長文字列の範囲指定

「(d)　固定長文字列の範囲指定」

5

10進数の範囲指定

「(e)　10進数の範囲指定」

6

整数の範囲指定

「(f)　整数の範囲指定」

7

浮動小数点数の範囲指定

「(g)　浮動小数点数の範囲指定」

次の条件の場合を例に，どのチャンクの情報が出力対象となるかについて示します。

アーカイブレンジ列のデータ型がDATE型

範囲指定に「2015/02/10〜2015/04/01」の日付の範囲を指定

図13‒2　日付の範囲指定の内容と情報が出力対象となるチャンクの関係

-rオプションの指定時の規則を次に示します。

このオプションを指定した場合，-cオプションにarchivechunkを指定する必要があります。-cオプションにarchivechunkの指定がないときは，KFAA90002-Eメッセージが出力されます。また，-nオプションには，アーカイブマルチチャンク表の表名を指定する必要があります。指定された表名がアーカイブマルチチャンク表の表名でないときは，KFAA50280-Eメッセージが出力されます。

範囲指定は，1つだけ指定できます。複数の範囲指定は指定できません。

範囲指定に1,024バイト以上指定した場合はKFAA90003-Eメッセージが出力されます。

このオプションには，シェルによる囲み文字などの解析後の値を指定してください。シェルの文字解析によっては，指定値と実際に解釈される値が異なることがあります。固定長文字列の範囲指定の例を次に示します。

オプションの指定値：-r 'abc'-'def'

実際に解釈される値：-r abc-def

実際に解釈される値はアポストロフィ（'）が取り除かれた値です。

(a)　日付の範囲指定

チャンクの情報を出力する範囲を日付で指定します。

形式

-r ｛YYYY-MM-DD｜YYYY/MM/DD｝-｛YYYY-MM-DD｜YYYY/MM/DD｝

最小値（日付指定）と最大値（日付指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

指定例

指定例1：-r 2016/01/01-2016/12/31

指定例2：-r 2016-01-01-2016-12-31

それぞれの日付は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。

指定例1の場合，2016/01/01，および2016/12/31が日付指定として扱われます。

指定例2の場合，2016-01-01，および2016-12-31が日付指定として扱われます。

日付の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」の桁数が足りない場合は，足りない分，左側に0を補ってください。

日付の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DATE型

TIMESTAMP型

日付の範囲指定では，日付だけを指定できます。アーカイブレンジ列のデータ型がTIMESTAMP型の場合，時刻の指定は省略されたものとして扱われます。そのため，次に示す表のとおりに開始時刻と終了時刻が補正されます。その結果，指定した日付の範囲指定内のすべてのデータが，チャンクの情報を出力する範囲の対象になります。

表13‒4　開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

0

0時0分0秒

23時59分59秒

2

3

0時0分0.000秒

23時59分59.999秒

3

6

0時0分0.000000秒

23時59分59.999999秒

4

9

0時0分0.000000000秒

23時59分59.999999999秒

5

12

0時0分0.000000000000秒

23時59分59.999999999999秒

日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒5　日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

日付の桁数が規定を超えている

日付の桁数が規定より不足している

-r 2015/7/1-2015/008/031

-r 2015/07/01-2015/08/31

2

範囲外の日付を指定している

-r 2015/01/01-2015/06/31

-r 2015/01/01-2015/06/30

3

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r 2015/01/11△-△2015/7/31

説明

日付指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 2015/01/11-2015/07/31

（凡例）

△：空白

(b)　時刻の範囲指定

チャンクの情報を出力する範囲を時刻で指定します。

形式

-r hh:mm:ss〔.〔nn...n〕〕-hh:mm:ss〔.〔nn...n〕〕

最小値（時刻指定）と最大値（時刻指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r 00:00:00-12:59:59

指定例2：-r 00:00:00.000-12:59:59.999

それぞれの時刻は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。

小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，00:00:00，および12:59:59が時刻指定として扱われます。

指定例2の場合，00:00:00.000，および12:59:59.999が時刻指定として扱われます。

時刻の範囲指定に関する規則を次に示します。

「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIME型

小数秒がTIME型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIME型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表13‒6　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIME型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒7　時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻の桁数が規定を超えている

時刻の桁数が規定より不足している

-r 0:0:0-012:59:59

-r 00:00:00-12:59:59

2

範囲外の時刻を指定している

-r 00:00:00-12:60:00

-r 00:00:00-12:59:59

3

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r 00:00:00△-△12:59:59

説明

時刻指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 00:00:00-12:59:59

（凡例）

△：空白

(c)　時刻印の範囲指定

チャンクの情報を出力する範囲を時刻印で指定します。

形式

-r '｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'
    -'｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'

最小値（時刻印指定）と最大値（時刻印指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

△：半角空白，またはタブ

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r '2016/01/01 00:00:00'-'2016/12/31 12:59:59'

指定例2：-r '2016/01/01 00:00:00.000'-'2016/12/31 12:59:59.999'

それぞれの時刻印は，日付指定と時刻指定を半角空白で結び，アポストロフィ（'）で囲んで指定してください。日付指定は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。時刻指定は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，2016/01/01 00:00:00，および2016/12/31 12:59:59が時刻印指定として扱われます。

指定例2の場合，2016/01/01 00:00:00.000，および2016/12/31 12:59:59.999が時刻印指定として扱われます。

時刻印の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」，「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻印の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIMESTAMP型

小数秒がTIMESTAMP型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIMESTAMP型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表13‒8　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻印指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒9　時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻印の桁数が規定を超えている

時刻印の桁数が規定より不足している

-r '2015/7/1△00:00:00'-'2015/008/031△12:59:59'

-r '2015/07/01△00:00:00'-'2015/08/31△12:59:59'

2

範囲外の時刻印を指定している

-r '2015/01/01△00:00:00'-'2015/06/31△12:60:00'

-r '2015/01/01△00:00:00'-'2015/06/30△12:59:59'

3

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r '2016/04/01△00:00:00'△-△'2016/06/30△12:59:59'

説明

時刻印指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r '2016/04/01△00:00:00'-'2016/06/30△12:59:59'

4

指定例

-r 2016/04/01△00:00:00-2016/06/30△12:59:59

説明

時刻印指定がアポストロフィ（'）で囲まれていないため，シェルが日付と時刻の間の空白でオプション引数を区切ってしまう

（凡例）

△：空白

(d)　固定長文字列の範囲指定

チャンクの情報を出力する範囲を固定長文字列で指定します。

形式

-r a...a-a...a

最小値（固定長文字列指定）と最大値（固定長文字列指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

a...a：1文字以上の文字列

指定例

-r 20160101-20161231

20160101および20161231が固定長文字列指定として扱われます。

固定長文字列の範囲指定に関する規則を次に示します。

固定長文字列指定には，1文字以上の文字列を指定します。

指定した固定長文字列指定は，英大文字と英小文字が区別されます。

固定長文字列の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

CHARACTER型

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含む固定長文字列指定を指定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，固定長文字列指定の全体をアポストロフィ（'）で囲んでください。

指定例

指定例1：-r a¥|c-def

指定例2：-r 'a|c'-def

どちらの場合も，a|c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）も固定長文字列指定として扱われます。

指定例

-r '"abc"'-def

"abc"，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にハイフン（-）を含める場合は，固定長文字列指定をアポストロフィ（'）で囲んでください。最小値と最大値の区切りと見なされるハイフン（-）と区別するためです。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'a-c¥'-def

アポストロフィ（'）で囲み，さらに二重引用符（"）で囲む場合

-r "'a-c'"-def

どちらの場合も，a-c，およびdefが固定長文字列指定として扱われます。

また，固定長文字列指定にハイフン（-）を含まない場合も，アポストロフィ（'）で囲むと，そのアポストロフィ（'）を除いた値が固定長文字列指定として扱われます。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'abc¥'-def

abc，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にアポストロフィ（'）を含む場合は，1個のアポストロフィ（'）を表すのに，2個連続してアポストロフィ（'）を指定してください。

指定例

¥'（バックスラッシュとアポストロフィ）を2個指定する場合

-r a¥'¥'c-def

アポストロフィ（'）を含む固定長文字列指定を二重引用符（"）で囲む場合

-r "a''c"-def

どちらの場合も，a'c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の文字データの比較を参照してください。

固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒10　固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

固定長文字列の範囲指定に，最小値と最大値の区切りと見なされるハイフン（-）が複数ある

-r a-c-def

-r 'a-c-def'

-r ¥'a-c¥'-def

2

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r abc△-△def

説明

固定長文字列指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r abc-def

（凡例）

△：空白

(e)　10進数の範囲指定

チャンクの情報を出力する範囲を10進数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝
    -〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝

最小値（10進数指定）と最大値（10進数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：整数部（aは0〜9）

.：小数点

b...b：小数部（bは0〜9）

DECIMAL(5,2)の場合の指定例

指定例1：-r -100-100

指定例2：-r -100.00-+100.00

-100.00および+100.00が10進数指定として扱われます。

10進数の範囲指定に関する規則を次に示します。

整数部と小数部のどちらかを指定する必要があります。小数部がない場合は，小数点を省略できます。

10進数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DECIMAL型

NUMERIC型

小数部がDECIMAL型またはNUMERIC型の位取り（小数部の桁数）より大きい場合，位取り（小数部の桁数）より下位の桁部分は切り捨てられます。

10進数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒11　10進数の範囲指定に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

指定例

-r 0-123456789012345678901234567890123456789

説明

10進数指定を39桁で指定している

指定例

-r 0-12345678901234567890123456789012345678

説明

10進数指定を38桁で指定する

2

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

10進数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(f)　整数の範囲指定

チャンクの情報を出力する範囲を整数で指定します。

形式

-r 〔｛+｜-｝〕a...a-〔｛+｜-｝〕a...a

最小値（整数指定）と最大値（整数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：数値（aは0〜9）

指定例

指定例1：-r -100-100

指定例2：-r -100-+100

-100および+100が整数指定として扱われます。

整数の範囲指定に関する規則を次に示します。

整数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

INTEGER型

BIGINT型

SMALLINT型

整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒12　整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

INTEGERの場合またはBIGINT

-r 0-9223372036854775808

SMALLINTの場合

-r 0-2147483648

INTEGERの場合またはBIGINT

-r 0-9223372036854775807

SMALLINTの場合

-r 0-2147483647

2

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

整数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(g)　浮動小数点数の範囲指定

チャンクの情報を出力する範囲を浮動小数点数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕
    - 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕

最小値（浮動小数点数指定）と最大値（浮動小数点数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：仮数部の整数部（aは0〜9）

.：小数点

b...b：仮数部の小数部（bは0〜9）

E，e：浮動小数点数定数

c...c：指数部（cは0〜9）

図13‒3　-rオプションの浮動小数点数の範囲指定の指定例

指定例1の場合は，-100，および100が浮動小数点数指定として扱われます。

指定例2の場合は，-1.0E2，および+1.0E2が浮動小数点数指定として扱われます。

指定例3の場合は，-100，および1.0E+2が浮動小数点数指定として扱われます。

浮動小数点数の範囲指定に関する規則を次に示します。

浮動小数点数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DOUBLE PRECISION型

FLOAT型

浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbdbstatusコマンドを実行してください。

表13‒13　浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定できる文字数を超えている

指定例

-r 0-123…（中略）…789

説明

浮動小数点数指定を510文字で指定している

指定例

-r 0-123…（中略）…78

説明

浮動小数点数指定を509文字で指定する

2

KFAA90002-E

KFAA96720-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

浮動小数点数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】

(1)　指定形式

adbdbstatusコマンドの指定形式（カラムストア表の再編成要否の情報を出力する場合）を次に示します。

サマリ情報または使用量情報を出力する場合の指定形式については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(1)　指定形式」を参照してください。

adbdbstatus
    -d reorginfo
    -n 表名
  〔-c 解析対象チャンクIDリスト〕
  〔-t〕
  〔-k 囲み文字〕
  〔-s ｛区切り文字｜tab｝〕
  〔-S ｛K｜M｜G｝〕
  〔--timeout タイムアウト時間〕

(2)　オプションの説明

adbdbstatusコマンドのオプション（カラムストア表の再編成要否の情報を出力する場合）について説明します。サマリ情報または使用量情報を出力する場合のオプションについては，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」を参照してください。

●-d reorginfo

このオプションは必ず指定してください。

再編成要否の情報を出力するため，出力結果の種類としてreorginfoを指定します。

●-n 表名

〜〈文字列〉

このオプションは必ず指定してください。

情報を取得するカラムストア表の表名を「スキーマ名.表識別子」の形式で指定します。スキーマ名は省略できません。ビュー表，またはローストア表を指定するとエラーになります。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

●-c 解析対象チャンクIDリスト

〜〈文字列〉((1～32,768バイト))

-nオプションに指定した処理対象表中の，特定のチャンクの情報だけを取得したい場合に，このオプションを指定します。

このオプションを省略した場合は，処理対象表に存在するチャンクのうち，削除仕掛中のチャンクを除いたすべてのチャンクの情報が取得されます。

解析対象チャンクIDリストは，次に示す方法で指定できます。なお，それぞれの方法を組み合わせて指定することもできます。

図13‒4　解析対象チャンクIDリストの例

チャンクIDを1つずつ指定する（単独指定）

情報を取得するチャンクIDを1つずつ指定したい場合は，チャンクIDをコンマ（,）で区切って指定します。

重要

チャンクIDとコンマ（,）の間には空白を入れないでください。

チャンクIDの範囲を指定する（範囲指定）

情報を取得するチャンクIDの範囲を指定したい場合は，「範囲の最小のチャンクID-範囲の最大のチャンクID」の形式で指定します（2つのチャンクIDをハイフン（-）でつなぎます）。

重要

ハイフン（-）とチャンクIDの間には空白を入れないでください。また，ハイフンの右側には，ハイフンの左側のチャンクIDより大きいチャンクIDを指定してください。

指定したチャンクIDのチャンクのうち，次に示すチャンクの情報は取得されません。

処理対象表に存在しないチャンク

削除仕掛中のチャンク

このオプションの指定時の規則を次に示します。

チャンクIDは，最大30,000個指定できます。チャンクIDの数え方を次に示します。

・範囲指定の場合，範囲内のすべてのチャンクIDが個数に数えられます。

・指定したチャンクIDが重複している場合，重複した分も個数に数えられます。

解析対象チャンクIDリストの例と数え方

（例1）-c 1,3,5：3個のチャンクID（1，3および5）を指定したと見なされます。

（例2）-c 1,3,5-8,10：7個のチャンクID（1，3，5，6，7，8および10）を指定したと見なされます。

（例3）-c 1,3,5,5-8,10：8個のチャンクID（1，3，5，5，6，7，8および10）を指定したと見なされます。

-cオプションに指定できる値の長さの上限は32キロバイトです。このため，指定値の長さが32キロバイトを超える場合は，単独指定を範囲指定に変更するか，または複数回に分けてadbdbstatusコマンドを実行してください。

エラーとなる指定内容および指定例については，「(3)　-cオプションの指定が原因のエラー」を参照してください。

■処理対象表に存在するチャンクのチャンクIDの検索方法

システム表のSTATUS_CHUNKSを検索し，チャンクIDを確認してください。

詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表のシステム表の検索の表名から表内の全チャンクの情報を調べる場合を参照してください。

●-t

タイトル行を出力しない場合に指定します。

●-k 囲み文字

〜〈文字列〉((1バイト))《"》

CSV形式での文字列の囲み文字を指定します。このオプションを省略した場合は，囲み文字として二重引用符（"）が仮定されます。

囲み文字として指定できる文字は，1バイト文字だけです。2バイト以上の文字列は指定できません。また，次に示す文字も囲み文字として指定できません。

空白，タブ，アスタリスク（*）

区切り文字（-sオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を囲み文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を囲み文字として指定する場合の例

adbdbstatus …　-k "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を囲み文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を囲み文字として指定する場合の例

adbdbstatus …　-k "|" …

再編成要否の情報で出力される列のタイトルおよび内容に含まれる文字を囲み文字に指定しないでください。再編成要否の情報で出力される列については，「13.9.2　再編成要否の情報で出力される項目の一覧」を参照してください。

●-s ｛区切り文字｜tab｝

〜〈文字列〉((1バイト))《 , 》

CSV形式での区切り文字を指定します。区切り文字にタブを指定する場合は，tabを指定してください。このオプションを省略した場合は，区切り文字としてコンマ（ , ）が仮定されます。

区切り文字として指定できる文字は，tabまたは1バイト文字だけです。tab以外の2バイト以上の文字列は指定できません。また，次に示す文字も区切り文字として指定できません。

英大文字（A〜Z），英小文字（a〜z），数字（0〜9），下線（_），二重引用符（"），アスタリスク（*）

囲み文字（-kオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を区切り文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を区切り文字として指定する場合の例

adbdbstatus …　-s "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を区切り文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を区切り文字として指定する場合の例

adbdbstatus …　-s "|" …

再編成要否の情報で出力される列のタイトルおよび内容に含まれる文字を区切り文字に指定しないでください。再編成要否の情報で出力される列については，「13.9.2　再編成要否の情報で出力される項目の一覧」を参照してください。

●-S ｛K｜M｜G｝

再編成要否に関する出力項目を，ページ数ではなく，キロバイト単位，メガバイト単位またはギガバイト単位で表示したい場合に指定します。

このオプションの指定を省略した場合，出力項目はページ数で表示されます。

K：キロバイト

キロバイト単位で出力項目を表示したい場合に指定します。

M：メガバイト

メガバイト単位で出力項目を表示したい場合に指定します。

G：ギガバイト

ギガバイト単位で出力項目を表示したい場合に指定します。

このオプションを指定すると，表示単位にあわせて，該当する出力項目の列のタイトルも変更されます。このオプションの指定値と，出力項目の表示単位，および列のタイトルの関係を次の表に示します。

表13‒14　再編成要否に関する出力項目の表示単位と列のタイトル

項番

出力項目

このオプションの指定値

出力項目の表示単位

列のタイトル

1

ローデータ用セグメントに含まれる基本行用ページのページ数

−

ページ数

Base_row_pages

2

K

キロバイト

KB_Base_row_pages

3

M

メガバイト

MB_Base_row_pages

4

G

ギガバイト

GB_Base_row_pages

5

ローデータ用セグメントに含まれる分岐行用ページのページ数

−

ページ数

Branch_row_pages

6

K

キロバイト

KB_Branch_row_pages

7

M

メガバイト

MB_Branch_row_pages

8

G

ギガバイト

GB_Branch_row_pages

9

ローデータ用セグメントに含まれる無効情報管理用ページのページ数

−

ページ数

Invalid_row_information_pages

10

K

キロバイト

KB_Invalid_row_information_pages

11

M

メガバイト

MB_Invalid_row_information_pages

12

G

ギガバイト

GB_Invalid_row_information_pages

（凡例）

−：このオプションを省略します。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbdbstatusコマンドがタイムアウトになるまでの時間を指定します。

adbdbstatusコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbdbstatusコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbdbstatusコマンドのタイムアウト時間は設定されません。adbdbstatusコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbdbstatusコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbdbstatusコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbdbstatusコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

他ノードで実行中のトランザクションの終了待ち中

(3)　-cオプションの指定が原因のエラー

-cオプションの指定が原因でadbdbstatusコマンドがエラーとなるケースを次の表に示します。

どの場合も，-cオプションの指定を修正したあと，再度adbdbstatusコマンドを実行してください。なお，-cオプションの詳細については，「(2)　オプションの説明」の「-c」を参照してください。

表13‒15　-cオプション指定誤りの場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50205-E

指定したチャンクIDの個数が30,000個を超えている

-c 1-30001

-c 1-30000

2

範囲指定で，ハイフン（-）の両側に同じチャンクIDを指定している

-c 3-3,7

-c 3-5,7

3

範囲指定で，ハイフン（-）の右側に，左側のチャンクIDより小さいチャンクIDを指定している

-c 10-3

-c 3-10

4

チャンクIDとして不適切な値を指定している

整数以外の値

1～9,223,372,036,854,775,807の範囲外の値

-c A

-c 0

-c A-B

-c 0-3

正しいチャンクIDを指定してください。

5

KFAA90002-E

KFAA96720-I

チャンクIDとコンマ（,）の間に空白がある

-c 1,3,△10

-c 1,3,10

6

範囲指定で，チャンクIDとハイフン（-）の間に空白がある

-c 1,3△-△10

-c 1,3-10

7

KFAA90003-E

指定値の長さが32キロバイトを超えている

単独指定を使用している場合は，範囲指定に変更する（コンマ（,）ではなくハイフン（-）を使用する）

-c 1-xxxxx

複数回に分けてadbdbstatusコマンドを実行する

（凡例）

△：空白

13.3　DBエリアのサマリ情報で出力される項目

この節では，DBエリアのサマリ情報で出力される項目の詳細について説明します。

DBエリアのサマリ情報を出力するには，次に示す2つのオプションを指定します。

-dオプション

-dオプションにsummaryを指定してください。または，-dオプションを省略してください。

-cオプション

-cオプションにdbareaを指定してください。または，-cオプションを省略してください。

また，-nオプションで情報を取得するDBエリアを指定できます。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.3.1　DBエリアのサマリ情報の出力行数と出力順序

DBエリアのサマリ情報は，サマリ情報を取得するDBエリアごとに1行出力されます。したがって，出力される行数はサマリ情報を取得するDBエリアの数と同じです。列のタイトルは行数に含まれません。

各行はDBエリアIDの昇順で出力されます。

13.3.2　DBエリアのサマリ情報で出力される項目の一覧

DBエリアのサマリ情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。DBエリアのサマリ情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒16　DBエリアのサマリ情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

DBarea：DBエリアのサマリ情報

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

3

DBarea_name

DBエリア名

○

4

DBarea_ID

DBエリアID

×

5

DBarea_type

DBエリアの種類

data：データ用DBエリア

dictionary：ディクショナリ用DBエリア

system_table：システム表用DBエリア

×

6

DBarea_created_time

DBエリア作成時のタイムスタンプ

adbinitコマンドでDBエリアを作成した日時，またはadbmodareaコマンドでDBエリアを追加した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

7

DBarea_modified_time

DBエリア拡張時のタイムスタンプ

adbmodareaコマンドでDBエリアにDBエリアファイルを追加した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

DBエリアファイルを追加していない場合，この項目には値が出力されません。

○

8

Rsv

−

−

9

Page_size

ページサイズ（単位：バイト）

×

10

Segment_size

セグメントサイズ（単位：ページ数）

×

11

Top_DBarea_filename

先頭DBエリアファイルのファイルパス

DBエリアの先頭に割り当てたDBエリアファイルのファイルパスが出力されます。

レギュラーファイルの場合

DBエリアファイルの絶対パスが出力されます。

ブロックスペシャルファイルの場合

DBエリアファイルに割り当てたブロックスペシャルファイル名が出力されます。シンボリックリンクのときは，シンボリックリンクのリンク先が出力されます。

クラウドストレージ機能を使用している場合

DBエリアファイルのファイルパスは出力されません。

○

12

Number_of_files

DBエリアファイル数

DBエリアを構成するDBエリアファイルのファイル数が出力されます。

×

13

Creatable_chunks

DBエリア内に作成できるチャンク数の上限

次の値が出力されます。

DBエリア内に表またはインデクスが格納されていない場合

1つのDBエリア内に作成できるチャンク数は30,000であるため，30,000が出力されます。

DBエリア内に表またはインデクスが格納されている場合

30,000から，各表および各インデクスの「チャンク数の最大値」を引いた数が出力されます。

（例）

マルチチャンク表（表T1）を次の条件で定義したとします。

CREATE TABLE文のCHUNK（チャンク数の最大値）に1,000を指定する

表T1にインデクスを2つ定義する

DBエリアに，表T1とインデクス2つを格納する

この場合，27,000が出力されます。

30,000－1,000（表のチャンク数の最大値の分）－1,000×2（インデクスのチャンク数の最大値の分）＝27,000

このように，DBエリアに表またはインデクスを格納するたびに，この項目に出力される「DBエリア内に作成できるチャンク数の上限」の数が減っていきます。

なお，チャンク数の最大値については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアにマルチチャンク表を格納する場合の考慮点で詳細に説明されています。

また，シングルチャンク表の場合，チャンク数の最大値は1とカウントされます。

×

14

Reserved_chunks

DBエリア内に格納されている表およびインデクスのチャンク数の最大値の合計

次の値が出力されます。

DBエリア内に表またはインデクスが格納されていない場合

0が出力されます。

DBエリア内に表またはインデクスが格納されている場合

DBエリアに格納されている表およびインデクスの「チャンク数の最大値」の合計が出力されます。

（例）

マルチチャンク表（表T1）を次の条件で定義したとします。

CREATE TABLE文のCHUNK（チャンク数の最大値）に1,000を指定する

表T1にインデクスを2つ定義する

DBエリアに，表T1とインデクス2つを格納する

この場合，3,000が出力されます。

1,000（表のチャンク数の最大値の分）＋1,000×2（インデクスのチャンク数の最大値の分）＝3,000

このように，DBエリアに表またはインデクスを格納するたびに，この項目に出力される「DBエリア内に格納されている表およびインデクスのチャンク数の最大値の合計」の数が増えていきます。

なお，Creatable_chunksの値とReserved_chunksの値には，次の計算式を満たす関係があります。

Creatable_chunksの値＋Reserved_chunksの値＝30,000

×

15

Rsv

−

−

16

Used_ratio※2

DBエリアのセグメント使用率（単位：％）

DBエリアの総セグメントのうち，使用中のセグメントの割合が出力されます。計算式を次に示します。

×

17

Used_segments※2，※3

DBエリアの使用中セグメント数※4

DBエリア内で使用しているセグメント数※4が出力されます。

×

18

Total_segments※2，※3

DBエリア内の総セグメント数※4

adbdbstatusコマンドを実行した時点のDBエリアファイルのサイズで，管理できるセグメント数※4の合計が出力されます。

×

19

Rsv

−

−

20

Encrypt_status

DBエリアの暗号化状態

Encrypted：暗号化されている

None：暗号化されていない

×

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

解析対象のDBエリアを更新するトランザクションと，adbdbstatusコマンドを同時に実行した場合，実際と異なる値が出力されることがあります。

注※3

-Sオプションを指定して使用量の表示単位を変更すると，表示単位にあわせて，使用量に関する出力項目の列のタイトルが変更されます。表示単位と列のタイトルの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」を参照してください。

注※4

-Sオプションを指定すると，使用量に関する出力項目の表示単位を，キロバイト単位，メガバイト単位またはギガバイト単位に変更できます。

13.3.3　DBエリアのサマリ情報の出力例

DBエリアのサマリ情報の出力例を次に示します。なお，実際の出力結果は横に長いため，マニュアルでは分割して記載しています。

図13‒5　DBエリアのサマリ情報の出力例

注※

-Sオプションの指定によって，使用量に関する出力項目の表示単位，および列のタイトルが変更されます。-Sオプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」を参照してください。

13.4　表のサマリ情報で出力される項目

この節では，表のサマリ情報で出力される項目の詳細について説明します。

表のサマリ情報を出力するには，次に示す2つのオプションを指定します。

-dオプション

-dオプションにsummaryを指定してください。または，-dオプションを省略してください。

-cオプション

-cオプションにtableを指定してください。

また，-nオプションで情報を取得する表を指定できます。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.4.1　表のサマリ情報の出力行数と出力順序

表のサマリ情報は，サマリ情報を取得する表ごとに1行出力されます。したがって，表のサマリ情報で出力される行数は，サマリ情報を取得する表の数と同じです。列のタイトルは行数に含まれません。

各行はDBエリアIDの昇順で出力されます。DBエリアIDが同じ場合は，表名（スキーマ名.表識別子）の昇順で出力されます。

13.4.2　表のサマリ情報で出力される項目の一覧

表のサマリ情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。表のサマリ情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒17　表のサマリ情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

Table：表のサマリ情報

Table(Shared_lock)：表のサマリ情報（--shared-lockオプションを指定している場合）

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

3

DBarea_name

表が格納されているDBエリア名

○

4

DBarea_ID

表が格納されているDBエリアID

×

5

Schema_name

表のスキーマ名

ディクショナリ表（実表）およびシステム表（実表）の場合は，スキーマ名が"HADB"となります。

○

6

Table_identifier

表識別子

○

7

Table_ID

表ID

×

8

Table_type

表の種類

user：ユーザが定義した表

dictionary：ディクショナリ表（実表）

system：システム表（実表）

×

9

Rsv

−

−

10

Page_size

ページサイズ（単位：バイト）

×

11

Segment_size

セグメントサイズ（単位：ページ数）

×

12

Creatable_chunks

表に作成できるチャンク数※4

バックグラウンドインポートを実行できる回数が出力されます。

シングルチャンク表の場合は，0が出力されます。

×

13

Created_chunks

表に作成されたチャンク数※4

次に示すチャンク数を含んだ数が，表に作成されたチャンク数として出力されます。

削除仕掛中のチャンク数

adbmergechunkコマンドで一時的に使用するシステム用のチャンク数

上記は，待機状態のチャンク数を含みます。

シングルチャンク表の場合は，1が出力されます。

システム表（実表）の場合は，1または2が出力されます。

×

14

Current_chunk_ID

表のカレントチャンクのチャンクID※4

シングルチャンク表の場合は，1が出力されます。

システム表（実表）の場合は，「1＋adbreorgsystemdataコマンドの実行回数」が出力されます。

×

15

Pending_delete_chunks

表の削除仕掛中のチャンク数※4

マルチチャンク表の場合は，adbmergechunkコマンドで削除が完了していないマージ元チャンクの数が出力されます。

シングルチャンク表の場合は，0が出力されます。

システム表（実表）の場合は，0または1が出力されます（再編成前のデータの削除が完了していないときに，1が出力されます）。

×

16

Non-updatable

表の更新不可状態

non-updatable：表が更新不可状態の場合に出力されます。

no_check：--shared-lockオプションを指定している場合に出力されます。表の更新不可状態の情報を取得できません。

上記以外の場合，この項目には値が出力されません。

×

17

Command_status

コマンドの終了状態（コマンドの再実行の要否）

次に示すどちらかの場合は，abortが出力されます。

Rerun_command列にコマンド名が出力されたコマンドが，表またはインデクスの作成中に異常終了した場合

Rerun_command列にコマンド名が出力されたコマンドを再実行してください。該当するコマンドを再実行するまで，そのほかの，表およびインデクスを作成するコマンドは実行できません。表およびインデクスを作成するコマンドを次に示します。

・adbimportコマンド

・adbidxrebuildコマンド

・adbunarchivechunkコマンド

Rerun_command列にコマンド名が出力されたコマンドが，再編成前のデータの削除が完了する前に異常終了した場合

Rerun_command列にコマンド名が出力されたコマンドを再実行してください。該当するコマンドを次に示します。

・adbreorgsystemdataコマンド

--shared-lockオプションを指定している場合，コマンドの終了状態の情報を取得できないため，no_checkが出力されます。

上記以外の場合，この項目には値が出力されません。

×

18

Rerun_command

再実行するコマンド名

Command_status列がabortの場合に，再実行が必要なコマンド名が出力されます。

adbimport：adbimportコマンド

adbidxrebuild：adbidxrebuildコマンド

adbunarchivechunk：adbunarchivechunkコマンド

adbreorgsystemdata：adbreorgsystemdataコマンド

再実行が必要なコマンドがない場合，この項目には値が出力されません。

×

19

Rsv

−

−

20

Used_segments※2

表の使用中セグメント数※3，※5

各表で使用しているセグメント数※3，※5が出力されます。

×

21

Used_pages※2，※6

表の使用中ページ数※3，※5

各表で使用しているページ数※3，※5が出力されます。

×

22

Rsv

−

−

23

Wait_chunks

待機状態のチャンク数※4

シングルチャンク表の場合は，0が出力されます。

×

24

Archive_chunks

アーカイブ状態のチャンク数

シングルチャンク表，およびレギュラーマルチチャンク表の場合は，0が出力されます。

×

25

Storage_format

表データの格納形式

row：ローストア形式

column：カラムストア形式

×

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

-Sオプションを指定して使用量の表示単位を変更すると，表示単位にあわせて，使用量に関する出力項目の列のタイトルが変更されます。表示単位と列のタイトルの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」を参照してください。

注※3

-Sオプションを指定すると，使用量に関する出力項目の表示単位を，キロバイト単位，メガバイト単位またはギガバイト単位に変更できます。

注※4

--shared-lockオプションを指定したadbdbstatusコマンドと，処理対象の表を更新するトランザクション処理が同じタイミングで実行された場合，adbdbstatusコマンドの出力結果には，更新途中の値が出力されます。そのため，ほかの項目の値と不整合になることがあります。例を次に示します。

（例）

処理対象の表で，Wait_chunks（待機状態のチャンク数）の値が，Created_chunks（表に作成されたチャンク数）の値よりも大きくなる。

注※5

--shared-lockオプションを指定した場合，次に示す表のUsed_segments（表の使用中セグメント数）やUsed_pages（表の使用中ページ数）の値には，削除仕掛中のチャンクに関する値を除いた値が出力されます。

システム表（実表）

adbmergechunkコマンド実行中の表

注※6

更新行のカラム化機能で，再利用が可能になった基本行用ページのページ数も含まれます。更新行のカラム化機能については，マニュアルHADB　システム構築・運用ガイドの更新行のカラム化機能の運用（カラムストア表の検索性能の維持）を参照してください。

13.4.3　表のサマリ情報の出力例

表のサマリ情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。

図13‒6　表のサマリ情報の出力例（1列目〜6列目）

図13‒7　表のサマリ情報の出力例（7列目〜13列目）

図13‒8　表のサマリ情報の出力例（14列目〜18列目）

図13‒9　表のサマリ情報の出力例（19列目〜25列目）

注※

-Sオプションの指定によって，使用量に関する出力項目の表示単位，および列のタイトルが変更されます。-Sオプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」を参照してください。

13.5　インデクスのサマリ情報で出力される項目

この節では，インデクスのサマリ情報で出力される項目の詳細について説明します。

インデクスのサマリ情報を出力するには，次に示す2つのオプションを指定します。

-dオプション

-dオプションにsummaryを指定してください。または，-dオプションを省略してください。

-cオプション

-cオプションにindexを指定してください。

また，-nオプションで情報を取得するインデクスを指定できます。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.5.1　インデクスのサマリ情報の出力行数と出力順序

インデクスのサマリ情報は，サマリ情報を取得するインデクスごとに1行出力されます。したがって，インデクスのサマリ情報で出力される行数は，サマリ情報を取得するインデクスの数と同じです。列のタイトルは行数に含まれません。

各行はDBエリアIDの昇順で出力されます。DBエリアIDが同じ場合は，インデクス名（スキーマ名.インデクス識別子）の昇順で出力されます。

13.5.2　インデクスのサマリ情報で出力される項目の一覧

インデクスのサマリ情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。インデクスのサマリ情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒18　インデクスのサマリ情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

Index：インデクスのサマリ情報

Index(Shared_lock)：インデクスのサマリ情報（--shared-lockオプションを指定している場合）

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

3

DBarea_name

インデクスが格納されているDBエリア名

○

4

DBarea_ID

インデクスが格納されているDBエリアID

×

5

Schema_name

インデクスのスキーマ名

ディクショナリ表（実表）およびシステム表（実表）に定義されているインデクスの場合は，スキーマ名が"HADB"となります。

○

6

Index_identifier

インデクス識別子

○

7

Index_ID

インデクスID

×

8

Index_type

インデクスの種類

B-tree：B-treeインデクス

text：テキストインデクス

range：レンジインデクス

×

9

Schema_name

インデクスが定義された表のスキーマ名

○

10

Table_identifier

インデクスが定義された表の表識別子

○

11

Table_ID

インデクスが定義された表の表ID

×

12

Unique_constraint_violated

一意性制約違反状態

unique_constraint_violated：ユニークインデクスが一意性制約違反状態の場合に出力されます。

unknown：ユニークインデクスが一意性制約違反状態かどうか不明の場合に出力されます。

no_check：--shared-lockオプションを指定している場合に出力されます。一意性制約違反状態の情報を取得できません。

上記以外の場合，この項目には値が出力されません。

×

13

Page_size

ページサイズ（単位：バイト）

×

14

Segment_size

セグメントサイズ（単位：ページ数）

×

15

Unfinished

インデクスの未完状態

unfinished：インデクスが未完状態の場合に出力されます。

no_check：--shared-lockオプションを指定している場合に出力されます。インデクスの未完状態の情報を取得できません。

上記以外の場合，この項目には値が出力されません。

×

16

Pagegroup_size

レンジインデクスのページグループサイズ（単位：ページ数）

B-treeインデクスおよびテキストインデクスの場合，値が出力されません。

バージョン02-02より前のバージョンで定義したレンジインデクスの場合，セグメントサイズが出力されます。

×

17

Used_segments※2

インデクスの使用中セグメント数※3，※4

各インデクスで使用しているセグメント数※3，※4が出力されます。

×

18

Used_pages※2

インデクスの使用中ページ数※3，※4

各インデクスで使用しているページ数※3，※4が出力されます。

×

19

Rsv

−

−

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

-Sオプションを指定して使用量の表示単位を変更すると，表示単位にあわせて，使用量に関する出力項目の列のタイトルが変更されます。表示単位と列のタイトルの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」を参照してください。

注※3

-Sオプションを指定すると，使用量に関する出力項目の表示単位を，キロバイト単位，メガバイト単位またはギガバイト単位に変更できます。

注※4

--shared-lockオプションを指定した場合，次に示すインデクスのUsed_segments（インデクスの使用中セグメント数）やUsed_pages（インデクスの使用中ページ数）の値には，削除仕掛中のチャンクに関する値を除いた値が出力されます。

システム表（実表）に定義されたインデクス

adbmergechunkコマンド実行中の表に定義されたインデクス

13.5.3　インデクスのサマリ情報の出力例

インデクスのサマリ情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。

図13‒10　インデクスのサマリ情報の出力例（1列目〜7列目）

図13‒11　インデクスのサマリ情報の出力例（8列目〜13列目）

図13‒12　インデクスのサマリ情報の出力例（14列目〜19列目）

注※

-Sオプションの指定によって，使用量に関する出力項目の表示単位，および列のタイトルが変更されます。-Sオプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」を参照してください。

13.6　アーカイブ状態のチャンクのサマリ情報で出力される項目

この節では，アーカイブ状態のチャンクのサマリ情報で出力される項目の詳細について説明します。

アーカイブ状態のチャンクのサマリ情報を出力するには，次に示す3つのオプションを指定します。

-dオプション

-dオプションにsummaryを指定してください。または，-dオプションを省略してください。

-cオプション

-cオプションにarchivechunkを指定してください。

-nオプション

-nオプションに，アーカイブマルチチャンク表の表名を指定してください。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.6.1　アーカイブ状態のチャンクのサマリ情報の出力行数と出力順序

アーカイブ状態のチャンクのサマリ情報は，表に作成されたチャンクごとに1行出力されます。したがって，アーカイブ状態のチャンクのサマリ情報で出力される行数は，表に作成されたチャンクの数と同じです。列のタイトルは行数に含まれません。

なお，各行の出力順序は特に決まっていません（チャンクIDの昇順または降順に情報が出力されるわけではありません）。

13.6.2　アーカイブ状態のチャンクのサマリ情報で出力される項目の一覧

アーカイブ状態のチャンクのサマリ情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。アーカイブ状態のチャンクのサマリ情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒19　アーカイブ状態のチャンクのサマリ情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

Archive_chunk：アーカイブ状態のチャンクのサマリ情報

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※

○

3

Schema_name

表のスキーマ名

○

4

Table_identifier

表識別子

○

5

Table_ID

表ID

×

6

Chunk_ID

チャンクID

×

7

Chunk_status

チャンクの状態

Normal：通常状態

Wait：待機状態

Pending_delete：削除仕掛中

×

8

Archive_status

チャンクのアーカイブ状態

Archived：アーカイブ状態

チャンクがアーカイブ状態でない場合は，何も出力されません。

×

9

Range_min

アーカイブレンジ列の最小値

アーカイブレンジ列のデータ型で出力されます。

ただし，次に示すどれかに該当する場合は，何も出力されません。

チャンクにデータが格納されていない

削除仕掛中のチャンクである

アーカイブレンジ列に定義されたレンジインデクスが未完状態で，かつチャンクがアーカイブ状態ではない

○

10

Range_min_raw

アーカイブレンジ列の最小値（16進数）

アーカイブレンジ列のデータ型がCHARACTER型の場合だけ，16進形式のバイナリデータで出力されます。

ただし，次に示すどれかに該当する場合は，何も出力されません。

チャンクにデータが格納されていない

削除仕掛中のチャンクである

アーカイブレンジ列に定義されたレンジインデクスが未完状態で，かつチャンクがアーカイブ状態ではない

○

11

Range_max

アーカイブレンジ列の最大値

アーカイブレンジ列のデータ型で出力されます。

ただし，次に示すどれかに該当する場合は，何も出力されません。

チャンクにデータが格納されていない

削除仕掛中のチャンクである

アーカイブレンジ列に定義されたレンジインデクスが未完状態で，かつチャンクがアーカイブ状態ではない

○

12

Range_max_raw

アーカイブレンジ列の最大値（16進数）

アーカイブレンジ列のデータ型がCHARACTER型の場合だけ，16進形式のバイナリデータで出力されます。

ただし，次に示すどれかに該当する場合は，何も出力されません。

チャンクにデータが格納されていない

削除仕掛中のチャンクである

アーカイブレンジ列に定義されたレンジインデクスが未完状態で，かつチャンクがアーカイブ状態ではない

○

13

Rows

アーカイブ状態のチャンクに格納されている行数

チャンクがアーカイブ状態である場合だけ出力されます。

−

14

Archive_file_num

アーカイブ状態のチャンクに対応しているアーカイブファイル数の合計値（単位：個）

チャンクがアーカイブ状態でない場合は，0が出力されます。

−

15

Archive_file_size

アーカイブ状態のチャンクに対応している全アーカイブファイルのファイルサイズの合計値（単位：バイト）

チャンクがアーカイブ状態でない場合は，0が出力されます。

−

16

Unarchive_table_size

アーカイブ状態になる前のチャンクで，表を格納するために使用していたセグメントの容量（単位：バイト）

チャンクがアーカイブ状態でない場合は，0が出力されます。

−

17

Unarchive_index_size

アーカイブ状態になる前のチャンクで，インデクスを格納するために使用していたセグメントの容量（単位：バイト）

対象となる表にインデクスが定義されている場合に，セグメントの容量が出力されます。

チャンクがアーカイブ状態でない場合は，0が出力されます。

−

18

Compression_ratio

アーカイブ状態のチャンクの圧縮率（単位：パーセント）

チャンクがアーカイブ状態である場合だけ出力されます。ただし，チャンクがアーカイブ状態である場合でも，チャンクに格納されている行数が0件のときは，何も出力されません。

−

19

Chunk_comment

チャンクに設定されたコメント

チャンクに対してチャンクのコメントが設定されている場合にだけ，出力されます。

○

20

Rsv

−

−

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

13.6.3　アーカイブ状態のチャンクのサマリ情報の出力例

アーカイブ状態のチャンクのサマリ情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。

図13‒13　アーカイブ状態のチャンクのサマリ情報の出力例（1列目〜6列目）

図13‒14　アーカイブ状態のチャンクのサマリ情報の出力例（7列目〜12列目）

図13‒15　アーカイブ状態のチャンクのサマリ情報の出力例（13列目〜17列目）

図13‒16　アーカイブ状態のチャンクのサマリ情報の出力例（18列目〜20列目）

13.7　DBエリア，表とインデクスの使用量情報で出力される項目

この節では，DBエリア，表とインデクスの使用量情報で出力される項目の詳細について説明します。

DBエリア，表とインデクスの使用量情報を出力するには，adbdbstatusコマンドの-dオプションにusedを指定します。

また，-cオプションで情報を取得する範囲（DBエリア，表またはインデクス）を，-nオプションで情報を取得する対象の名称を指定できます。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.7.1　DBエリア，表とインデクスの使用量情報の出力順序

DBエリア，表とインデクスの使用量情報で出力される各行は，DBエリアIDの昇順で出力されます。

DBエリアIDが同じ場合，出力される情報は，該当するDBエリアに表およびインデクスが格納されているかどうかによって異なります。

次に示す場合に分けて，情報の出力順序の規則を説明します。

表およびインデクスが格納されているDBエリアの場合

表およびインデクスが格納されていないDBエリアの場合

(1)　表およびインデクスが格納されているDBエリアの場合

表およびインデクスが格納されているDBエリアの場合，DBエリアIDが同じときは，次に示す順序で情報が出力されます。

表およびインデクスの使用量

DBエリアファイルの使用量

それぞれの情報の出力順序の規則を次に示します。

表およびインデクスの使用量の出力順序

1つのDBエリアに表およびインデクスが格納されている場合は，表の使用量，インデクスの使用量の順に出力されます。

表の使用量の出力順序

同じDBエリアに格納されている表の使用量は，次の規則に従って出力されます。

DBエリアファイルが複数のブロックスペシャルファイルの場合，adbinitコマンドまたはadbmodareaコマンド実行時に指定したDBエリアファイルの定義順

DBエリアファイル名は，DBarea_filename列に出力されます。

表名（スキーマ名（Schema_name列）.表識別子（Object_identifier列））の昇順

インデクスの使用量の出力順序

同じDBエリアに格納されているインデクスの使用量は，次の規則に従って出力されます。

DBエリアファイルが複数のブロックスペシャルファイルの場合，adbinitコマンドまたはadbmodareaコマンド実行時に指定したDBエリアファイルの定義順

DBエリアファイル名は，DBarea_filename列に出力されます。

インデクス名（スキーマ名（Schema_name列）.インデクス識別子（Object_identifier列））の昇順

DBエリアファイルの使用量の出力順序

1つのDBエリアに複数のブロックスペシャルファイルのDBエリアファイルがある場合は，adbinitコマンドまたはadbmodareaコマンド実行時に指定したDBエリアファイルの定義順に出力されます（DBエリアファイル名は，DBarea_filename列に出力されます）。

(2)　表およびインデクスが格納されていないDBエリアの場合

表およびインデクスが格納されていないDBエリアの場合，DBエリアファイルの使用量だけが出力されます。表およびインデクスの使用量は出力されません。

DBエリアファイルの使用量の出力順序の規則を次に示します。

DBエリアファイルの使用量の出力順序

1つのDBエリアに複数のブロックスペシャルファイルのDBエリアファイルがある場合は，adbinitコマンドまたはadbmodareaコマンド実行時に指定したDBエリアファイルの定義順に出力されます（DBエリアファイル名は，DBarea_filename列に出力されます）。

13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧

DBエリア，表とインデクスの使用量情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。DBエリア，表とインデクスの使用量情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒20　DBエリア，表とインデクスの使用量情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類※6

Used：DBエリア，表とインデクスの使用量情報

Used(Shared_lock)：DBエリア，表とインデクスの使用量情報（--shared-lockオプションを指定している場合）

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ※6

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

3

DBarea_name

DBエリア名※6

○

4

DBarea_ID

DBエリアID※6

×

5

DBarea_type

DBエリアの種類※6

dictionary：ディクショナリ用DBエリア

system_table：システム表用DBエリア

data：データ用DBエリア

×

6

Rsv

−

−

7

Page_size

ページサイズ（単位：バイト）※6

×

8

Segment_size

セグメントサイズ（単位：ページ数）※6

×

9

DBarea_filename

DBエリアファイル名※6

DBエリアに割り当てたDBエリアファイルのファイルパスが出力されます。

レギュラーファイルの場合

DBエリアファイルの絶対パスが出力されます。

ブロックスペシャルファイルの場合

DBエリアファイルに割り当てたブロックスペシャルファイル名が出力されます。シンボリックリンクのときは，シンボリックリンクのリンク先が出力されます。

クラウドストレージ機能を使用している場合

DBエリアファイルのファイルパスは出力されません。

○

10

Rsv

−

−

11

Object_type

スキーマオブジェクトの種類※2，※6

table：表

index：インデクス

×

12

Schema_name

スキーマ名※2，※6

ディクショナリ表（実表），システム表（実表），およびそれらに定義されているインデクスの場合は，スキーマ名が"HADB"となります。

○

13

Object_identifier

スキーマオブジェクト識別子※2，※6

表識別子またはインデクス識別子が出力されます。

○

14

Object_ID

スキーマオブジェクトID※2，※6

表IDまたはインデクスIDが出力されます。

×

15

Chunk_ID

チャンクID※2，※6

×

16

Chunk_create_time

チャンク作成時のタイムスタンプ※2，※6

チャンクを作成した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

なお，次のケースに該当する場合は，出力される内容が異なります。

マージしたチャンクの場合は，マージ元チャンクの中で，最も古いチャンクを作成した日時が出力されます。

チャンクの状態変更によるカレントチャンクの切り替えによって作成されたチャンクの場合は，adbchgchunkstatusコマンドを実行した日時が出力されます。

バックグラウンドインポートで待機状態のチャンクとして作成されたあとで，adbchgchunkstatusコマンドでチャンクの状態を通常状態に変更されたチャンクの場合は，adbchgchunkstatusコマンドを実行した日時が出力されます。

バックグラウンドインポートで待機状態のチャンクとして作成されたあとで，adbchgchunkstatusコマンドでチャンクの状態を通常状態に変更されていないチャンクの場合は，この項目には値が出力されません。

システム表（実表）の場合は，adbinitコマンドを実行した日時，またはadbreorgsystemdataコマンドを最後に実行した日時が出力されます。

ただし，Chunk_status列がPending_deleteのときは，「再編成前のデータの削除まで完了したadbreorgsystemdataコマンド」を最後に実行した日時が出力されます。再編成前のデータが残ったadbreorgsystemdataコマンドの実行日時は出力されません。

○

17

Chunk_swap_time

チャンク切り替え時のタイムスタンプ※2，※6，※7

新たなチャンクが作成されてカレントチャンクが切り替わった日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

チャンクを切り替えていない場合，この項目には値が出力されません。

なお，次のケースに該当する場合は，出力される内容が異なります。

マージしたチャンクの場合は，マージ元チャンクの中で，最も新しいカレントチャンクが切り替わった日時が出力されます。

バックグラウンドインポートで待機状態のチャンクとして作成されたあとで，adbchgchunkstatusコマンドでチャンクの状態が通常状態に変更されており，かつ通常状態に変更されたときにカレントチャンクにならなかったチャンクの場合は，adbchgchunkstatusコマンドを実行した日時が出力されます。

システム表（実表）の場合は，Chunk_status列がPending_deleteのときにだけ，次に示す日時が出力されます。

・「再編成後のデータは作成されたが，再編成前のデータが削除されなかったadbreorgsystemdataコマンド」を最後に実行した日時

○

18

Chunk_status

チャンクの状態※2，※6，※7

Normal：通常状態

Wait：待機状態

Pending_delete：削除仕掛中

×

19

Segment_type

セグメントの種類※2，※6

表（ローストア形式）の場合

Base_row：基本行用セグメント

Branch_row：分岐行用セグメント

表（カラムストア形式）の場合

Column_data：カラムデータ用セグメント

Row_data：ローデータ用セグメント

B-treeインデクスの場合

Lower_page：B-treeインデクス下位ページ用セグメント

Upper_page：B-treeインデクス上位ページ用セグメント

テキストインデクスの場合

String_page：文字列管理部用のセグメント

Position_page：出現情報管理部用のセグメント

レンジインデクスの場合

Range_control：DBエリアファイル管理部用のセグメント

Range_index_control：値域情報部用のセグメント

×

20

Used_segments※3

使用中セグメント数※4，※6，※7

セグメントの種類ごと，またはDBエリアファイルごとに使用しているセグメント数※4が出力されます。

×

21

Used_pages※3，※8

使用中ページ数※2，※4，※6

セグメントの種類ごとに使用しているページ数※4が出力されます。

×

22

Total_segments※3

DBエリアファイル内の総セグメント数※4，※5，※7

adbdbstatusコマンド実行時のDBエリアファイルのサイズで，管理できるセグメント数※4が出力されます。

×

23

Initialized_pages※3

DBエリアファイル内の初期化済みページ数※4，※5，※7

このページ数には，ディレクトリページが含まれています。ディレクトリページについては，マニュアルHADB　システム構築・運用ガイドのDBエリアの構造（セグメントとページ）のページのページの種類を参照してください。

×

24

Storage_format

チャンク内のデータ格納形式※2

表の場合

row：ローストア形式

column：カラムストア形式

表以外の場合

値が出力されません。

×

25

Encrypt_status

DBエリアの暗号化状態※6

Encrypted：暗号化されている

None：暗号化されていない

×

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

表およびインデクスの使用量が出力される行で，値が出力されます。表およびインデクスの使用量が出力される行の出力行数を次に示します。

セグメントの種類×DBエリアファイル数×チャンク数

注※3

-Sオプションを指定して使用量の表示単位を変更すると，表示単位にあわせて，使用量に関する出力項目の列のタイトルが変更されます。表示単位と列のタイトルの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」を参照してください。

注※4

-Sオプションを指定すると，使用量に関する出力項目の表示単位を，キロバイト単位，メガバイト単位またはギガバイト単位に変更できます。

注※5

DBエリアファイルの使用量が出力される行で，値が出力されます。DBエリアファイルの使用量が出力される行の出力行数は，DBエリアを構成するDBエリアファイル数と同じです。

注※6

--shared-lockオプションを指定してadbdbstatusコマンドを実行した場合，次に示す表では，削除仕掛中のチャンクに関する情報が出力される行が，出力されないことがあります。

システム表（実表）

adbmergechunkコマンド実行中の表

注※7

--shared-lockオプションを指定したadbdbstatusコマンドと，処理対象の表を更新するトランザクション処理が同じタイミングで実行された場合，adbdbstatusコマンドの出力結果には，更新途中の値が出力されます。そのため，ほかの項目の値と不整合になることがあります。例を次に示します。

（例1）

同一のDBarea_filename（DBエリアファイル名）に出力されているUsed_segments（使用中セグメント数）の値の合計が，Total_segments（DBエリアファイル内の総セグメント数）の値と一致しない。

（例2）

カレントチャンクについて，Chunk_swap_time（チャンク切り替え時のタイムスタンプ）が出力される。

注※8

更新行のカラム化機能で，再利用が可能になった基本行用ページのページ数も含まれます。更新行のカラム化機能については，マニュアルHADB　システム構築・運用ガイドの更新行のカラム化機能の運用（カラムストア表の検索性能の維持）を参照してください。

13.7.3　DBエリア，表とインデクスの使用量情報の出力例

DBエリア，表とインデクスの使用量情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。また，一部の行を省略して記載しています。

図13‒17　DBエリア，表とインデクスの使用量情報の出力例（1列目〜8列目）

図13‒18　DBエリア，表とインデクスの使用量情報の出力例（9列目〜13列目）

図13‒19　DBエリア，表とインデクスの使用量情報の出力例（14列目〜18列目）

図13‒20　DBエリア，表とインデクスの使用量情報の出力例（19列目〜22列目）

図13‒21　DBエリア，表とインデクスの使用量情報の出力例（23列目〜25列目）

注※

-Sオプションの指定によって，使用量に関する出力項目の表示単位，および列のタイトルが変更されます。-Sオプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」を参照してください。

13.7.4　DBエリア，表とインデクスの使用量情報の出力行数の目安

DBエリア，表とインデクスの使用量情報で出力される行数は，情報を取得する範囲によって異なります。出力される行数の計算式を次の表に示します。ただし，計算式で求められる行数は概算であるため，あくまで目安としてください。

なお，出力結果の列のタイトルは行数に含まれません。

表13‒21　DBエリア，表とインデクスの使用量情報で情報を取得する範囲と，出力される行数

項番

DBエリア，表とインデクスの使用量情報で情報を取得する範囲

-cオプションの指定

-nオプションの指定

出力される行数（概算）

1

データベース全体（DBエリア内の表およびインデクスを含む）※

dbareaまたは省略

−

「(1)　データベース全体の使用量情報を取得する場合」を参照してください。

2

特定のDBエリア（DBエリア内の表およびインデクスを含む）※

DBエリア名

「(2)　特定のDBエリアの使用量情報を取得する場合」を参照してください。

3

すべての表※

table

−

「(3)　すべての表の使用量情報を取得する場合」を参照してください。

4

特定の表

表名

「(4)　特定の表の使用量情報を取得する場合」を参照してください。

5

すべてのインデクス※

index

−

「(5)　すべてのインデクスの使用量情報を取得する場合」を参照してください。

6

特定のインデクス

インデクス名

「(6)　特定のインデクスの使用量情報を取得する場合」を参照してください。

（凡例）

−：-nオプションを省略します。

注

マスタディレクトリ用DBエリア，および作業表用DBエリアはadbdbstatusコマンドの処理の対象外です。

注※

表およびインデクスが格納されていないDBエリアの場合，DBエリアの使用量だけが出力されます（表およびインデクスの使用量は出力されません）。また，表およびインデクスが格納されていないDBエリアに関する情報は，そのDBエリアを構成するDBエリアファイル数と同じ行数分，出力されます。

(1)　データベース全体の使用量情報を取得する場合

データベース全体（DBエリア内の表およびインデクスを含む）の使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

table_inf_num：表情報数

使用量情報を取得する表が格納されているDBエリアのDBエリアファイル数の総和を代入してください。DBエリアに複数の表が格納されている場合，表ごとにDBエリアファイル数を加算してください。

chunk_inf_num：チャンク情報数

使用量情報を出力する表ごとに，-bオプションを指定してadbimportコマンドを実行した回数−1の値を求めてください。そのあとで，求めた値の総和をchunk_inf_numに代入してください。

ただし，-bオプションを指定してadbimportコマンドを実行したことがない表は，値を求める必要はありません。

index_inf_num：インデクス情報数

使用量情報を取得するインデクスが格納されているDBエリアのDBエリアファイル数の総和を代入してください。DBエリアに複数のインデクスが格納されている場合，インデクスごとにDBエリアファイル数を加算してください。

dbarea_file_inf_num：DBエリア情報数

データ用DBエリア，ディクショナリ用DBエリアおよびシステム表用DBエリアの，DBエリアファイル数の総和を代入してください。

(2)　特定のDBエリアの使用量情報を取得する場合

特定のDBエリア（DBエリア内の表およびインデクスを含む）の使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

table_inf_num：表情報数

指定したDBエリアに表が格納されている場合，そのDBエリアのDBエリアファイル数×格納された表の数を代入してください。

chunk_inf_num：チャンク情報数

使用量情報を出力する表ごとに，-bオプションを指定してadbimportコマンドを実行した回数−1の値を求めてください。そのあとで，求めた値の総和をchunk_inf_numに代入してください。

ただし，-bオプションを指定してadbimportコマンドを実行したことがない表は，値を求める必要はありません。

index_inf_num：インデクス情報数

指定したDBエリアにインデクスが格納されている場合，そのDBエリアのDBエリアファイル数×格納されたインデクスの数を代入してください。

dbarea_file_inf_num：DBエリア情報数

指定したDBエリアのDBエリアファイル数を代入してください。

(3)　すべての表の使用量情報を取得する場合

すべての表の使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

table_inf_num：表情報数

使用量情報を取得する表が格納されているDBエリアのDBエリアファイル数の総和を代入してください。DBエリアに複数の表が格納されている場合，表ごとにDBエリアファイル数を加算してください。

chunk_inf_num：チャンク情報数

使用量情報を出力する表ごとに，-bオプションを指定してadbimportコマンドを実行した回数−1の値を求めてください。そのあとで，求めた値の総和をchunk_inf_numに代入してください。

ただし，-bオプションを指定してadbimportコマンドを実行したことがない表は，値を求める必要はありません。

dbarea_file_inf_num：DBエリア情報数

使用量情報を取得する表が格納されているDBエリアのDBエリアファイル数の総和を代入してください。

(4)　特定の表の使用量情報を取得する場合

特定の表の使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

table_inf_num：表情報数

指定した表が格納されているDBエリアのDBエリアファイル数を代入してください。

chunk_inf_num：チャンク情報数

指定した表に対して-bオプションを指定してadbimportコマンドを実行した回数−1を代入してください。

-bオプションを指定してadbimportコマンドを実行したことがない表の場合は，0を代入してください。

dbarea_file_inf_num：DBエリア情報数

指定した表が格納されているDBエリアのDBエリアファイル数を代入してください。

(5)　すべてのインデクスの使用量情報を取得する場合

すべてのインデクスの使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

index_inf_num：インデクス情報数

使用量情報を取得するインデクスが格納されているDBエリアのDBエリアファイル数の総和を代入してください。DBエリアに複数のインデクスが格納されている場合，インデクスごとにDBエリアファイル数を加算してください。

chunk_inf_num：チャンク情報数

使用量情報を取得するインデクスが定義された表ごとに，-bオプションを指定してadbimportコマンドを実行した回数−1の値を求めてください。そのあとで，求めた値の総和をchunk_inf_numに代入してください。

ただし，-bオプションを指定してadbimportコマンドを実行したことがない表は，値を求める必要はありません。

dbarea_file_inf_num：DBエリア情報数

使用量情報を取得するインデクスが格納されているDBエリアのDBエリアファイル数の総和を代入してください。

(6)　特定のインデクスの使用量情報を取得する場合

特定のインデクスの使用量情報を取得する場合，出力される行数の概算値は次に示す計算式で求められます。

計算式（単位：行数）

変数の説明

index_inf_num：インデクス情報数

指定したインデクスが格納されているDBエリアのDBエリアファイル数を代入してください。

chunk_inf_num：チャンク情報数

指定したインデクスが定義された表に対して，-bオプションを指定してadbimportコマンドを実行した回数−1を代入してください。-bオプションを指定してadbimportコマンドを実行したことがない表の場合は，0を代入してください。

dbarea_file_inf_num：DBエリア情報数

指定したインデクスが格納されているDBエリアのDBエリアファイル数の総和を代入してください。

13.8　アーカイブ状態のチャンクの使用量情報で出力される項目

この節では，アーカイブ状態のチャンクの使用量情報で出力される項目の詳細について説明します。

アーカイブ状態のチャンクの使用量情報を出力するには，次に示す3つのオプションを指定します。

-dオプション

-dオプションにusedを指定してください。

-cオプション

-cオプションにarchivechunkを指定してください。

-nオプション

-nオプションに，アーカイブマルチチャンク表の表名を指定してください。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」を参照してください。

13.8.1　アーカイブ状態のチャンクの使用量情報の出力行数と出力順序

アーカイブ状態のチャンクの使用量情報は，アーカイブファイルごとに1行出力されます。また，各チャンクに対応している全アーカイブファイルの情報が，チャンクごとに出力されます。したがって，アーカイブ状態のチャンクの使用量情報で出力される行数は，次に示す計算式で求めることができます。

■アーカイブ状態のチャンクの使用量情報で出力される行数の計算式（単位：行）

なお，このとき，列のタイトルは行数に含まれません。

また，各行の出力順序は特に決まっていません（チャンクIDの昇順または降順に情報が出力されるわけではありません）。

13.8.2　アーカイブ状態のチャンクの使用量情報で出力される項目の一覧

アーカイブ状態のチャンクの使用量情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。アーカイブ状態のチャンクの使用量情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒22　アーカイブ状態のチャンクの使用量情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

Used_chunk：アーカイブ状態のチャンクの使用量情報

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※

○

3

DBarea_name

DBエリア名

○

4

DBarea_ID

DBエリアID

×

5

Rsv

−

−

6

Object_type

スキーマオブジェクトの種類

table：表

×

7

Schema_name

表のスキーマ名

○

8

Object_identifier

表識別子

○

9

Object_ID

表ID

×

10

Chunk_ID

チャンクID

×

11

Chunk_status

チャンクの状態

Normal：通常状態

Wait：待機状態

Pending_delete：削除仕掛中

×

12

Range_min

アーカイブレンジ列の最小値

アーカイブレンジ列のデータ型で出力されます。Chunk_ID列にチャンクIDが出力されたチャンクに対するアーカイブファイルが存在する（チャンクにデータが格納されている）場合だけ，出力されます。

Archive_file_name列にアーカイブファイルのファイル名が出力されている場合

該当するアーカイブファイルのアーカイブレンジ列の最小値が出力されます。

Archive_file_name列に何も出力されていない場合

Chunk_ID列にチャンクIDが出力されたチャンクに対応している，全アーカイブファイル内でのアーカイブレンジ列の最小値が出力されます。

○

13

Range_min_raw

アーカイブレンジ列の最小値（16進数）

アーカイブレンジ列のデータ型がCHARACTER型の場合だけ，16進形式のバイナリデータで出力されます。Chunk_ID列にチャンクIDが出力されたチャンクに対するアーカイブファイルが存在する（チャンクにデータが格納されている）場合だけ，出力されます。

○

14

Range_max

アーカイブレンジ列の最大値

アーカイブレンジ列のデータ型で出力されます。Chunk_ID列にチャンクIDが出力されたチャンクに対するアーカイブファイルが存在する（チャンクにデータが格納されている）場合だけ，出力されます。

Archive_file_name列にアーカイブファイルのファイル名が出力されている場合

該当するアーカイブファイルのアーカイブレンジ列の最大値が出力されます。

Archive_file_name列に何も出力されていない場合

Chunk_ID列にチャンクIDが出力されたチャンクに対応している，全アーカイブファイル内でのアーカイブレンジ列の最大値が出力されます。

○

15

Range_max_raw

アーカイブレンジ列の最大値（16進数）

アーカイブレンジ列のデータ型がCHARACTER型の場合だけ，16進形式のバイナリデータで出力されます。Chunk_ID列にチャンクIDが出力されたチャンクに対するアーカイブファイルが存在する（チャンクにデータが格納されている）場合だけ，出力されます。

○

16

Archive_file_name

アーカイブファイルのファイル名

チャンクに対応しているアーカイブファイルのファイルパスが出力されます。

この列に何も出力されていない場合，Archive_file_size列には，Chunk_ID列にチャンクIDが出力されたチャンクに対応している，全アーカイブファイルのファイルサイズの合計値が出力されます。

○

17

Archive_file_size

アーカイブファイルのファイルサイズ（単位：バイト）

Archive_file_name列にアーカイブファイルのファイル名が出力されている場合

該当するアーカイブファイルのファイルサイズが出力されます。

Archive_file_name列に何も出力されていない場合

Chunk_ID列にチャンクIDが出力されたチャンクに対応している，全アーカイブファイルの，ファイルサイズの合計値が出力されます。

×

18

Rsv

−

−

（凡例）

−：値が出力されません。

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

13.8.3　アーカイブ状態のチャンクの使用量情報の出力例

アーカイブ状態のチャンクの使用量情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。

図13‒22　アーカイブ状態のチャンクの使用量情報の出力例（1列目〜7列目）

図13‒23　アーカイブ状態のチャンクの使用量情報の出力例（8列目〜13列目）

図13‒24　アーカイブ状態のチャンクの使用量情報の出力例（14列目〜16列目）

図13‒25　アーカイブ状態のチャンクの使用量情報の出力例（17列目〜18列目）

13.9　再編成要否の情報で出力される項目

ここでは，再編成要否の情報で出力される項目の詳細について説明します。

再編成要否の情報を出力するには，次に示す2つのオプションを指定します。

-dオプション

-dオプションにreorginfoを指定してください。

-nオプション

-nオプションに情報を取得する表の表名を指定してください。

また，-cオプションで情報を取得するチャンクを指定できます。

adbdbstatusコマンドの指定形式および各オプションの詳細については，「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」を参照してください。

13.9.1　再編成要否の情報の出力行数と出力順序

再編成要否の情報は，情報を取得するチャンクごとに1行出力されます。したがって，再編成要否の情報で出力される行数は，再編成要否の情報を取得するチャンクの数と同じです。なお，削除仕掛中のチャンクの情報は取得されません。また，列のタイトルは行数に含まれません。

各行はチャンクIDの昇順で出力されます。

13.9.2　再編成要否の情報で出力される項目の一覧

再編成要否の情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。再編成要否の情報の出力規則については，「13.12　adbdbstatusコマンドの出力規則」を参照してください。

表13‒23　再編成要否の情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

Reorg_info：再編成要否の情報

×

2

Timestamp

adbdbstatusコマンド実行時のタイムスタンプ

adbdbstatusコマンドを実行した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss"※1

○

3

DBarea_name

表が格納されているDBエリア名

○

4

DBarea_ID

表が格納されているDBエリアID

×

5

Schema_name

表のスキーマ名

○

6

Table_identifier

表識別子

○

7

Table_ID

表ID

×

8

Chunk_ID

チャンクID

×

9

Column_data_num

カラムストア形式の行数

次に示す行数の合計値が出力されます。

adbimportコマンドでカラムデータ用セグメントにインポートした行数

更新行のカラム化機能でカラムストア形式に変換した行数

×

10

Base_row_pages※2

ローデータ用セグメントに含まれる基本行用ページのページ数※3，※4

×

11

Branch_row_pages※2

ローデータ用セグメントに含まれる分岐行用ページのページ数※3

×

12

Invalid_row_information_pages※2

ローデータ用セグメントに含まれる無効情報管理用ページのページ数※3

×

13

Reorganization_necessity_index

トラブルシュート情報

×

14

Reorganization_necessity

再編成要否

Recommended：再編成を推奨します。

Not_recommended：再編成を推奨しません。

チャンクの検索性能が低下しているおそれがある場合，Recommendedが出力されます。あわせて，再編成を推奨するKFAA60200-Wメッセージがチャンクごとに出力されます。

カラムストア表の再編成が必要になる原因，およびカラムストア表の再編成の方法については，マニュアルHADB　システム構築・運用ガイドのシングルチャンク表の再編成が必要かどうかを確認する方法またはマルチチャンク表の再編成が必要かどうかを確認する方法を参照してください。

×

（凡例）

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

再編成要否に関する情報の表示単位を-Sオプションで変更すると，表示単位にあわせて，出力項目の列のタイトルが変わります。表示単位と列のタイトルの詳細については，「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(2)　オプションの説明」の「表13‒14　再編成要否に関する出力項目の表示単位と列のタイトル」を参照してください。

注※3

-Sオプションを指定すると，再編成要否に関する情報の表示単位を，キロバイト単位，メガバイト単位またはギガバイト単位に変更できます。

注※4

更新行のカラム化機能によって基本行用ページの再利用が可能になった場合，再利用が可能になったページのページ数は除かれて，Base_row_pages（ローデータ用セグメントに含まれる基本行用ページのページ数）の値が出力されます。

また，再利用が可能になったページが再利用されて満杯になったら，再利用が可能になったページのページ数は再度加えられて，Base_row_pages（ローデータ用セグメントに含まれる基本行用ページのページ数）の値が出力されます。

更新行のカラム化機能については，マニュアルHADB　システム構築・運用ガイドの更新行のカラム化機能の運用（カラムストア表の検索性能の維持）を参照してください。

13.9.3　再編成要否の情報の出力例

再編成要否の情報の出力例を次に示します。なお，実際の出力結果は横に長いため，ここでは分割して記載しています。

図13‒26　再編成要否の情報の出力例（1列目～9列目）

図13‒27　再編成要否の情報の出力例（10列目～14列目）

注※

-Sオプションの指定内容によって，出力項目の表示単位，および列のタイトルが変わります。-Sオプションの詳細については，「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(2)　オプションの説明」を参照してください。

13.10　使用例

adbdbstatusコマンドを実行してデータベースの状態を確認する方法を，例題形式で説明します。

出力例については，見やすさを考慮して区切り文字および一部の列を省略しています。

13.10.1　データベース全体の使用量を調べる（DBエリアのサマリ情報の出力）

DBエリアのサマリ情報を出力して，次の情報を調べます。

DBエリアごとの使用率

DBエリアごとの使用量（単位：メガバイト）

■adbdbstatusコマンドの実行例

adbdbstatus -S M

［説明］

-dオプション，-cオプションおよび-nオプションを省略してadbdbstatusコマンドを実行すると，すべてのDBエリアのサマリ情報が出力されます。

使用量の出力単位として，メガバイトを指定します。

出力結果を確認する方法を次に示します。

(1)　DBエリアごとの使用率を調べるとき

次の手順に従ってDBエリアごとの使用率を調べます。

DBエリア名を確認します。

DBarea_name列（出力結果の3列目）に出力されているDBエリア名を確認します。

各DBエリアのセグメント使用率を調べます。

Used_ratio列（出力結果の16列目）に出力されているDBエリアのセグメント使用率（単位：％）を調べます。セグメント使用率が100％に近い場合は，次のどれかのうち該当する対策を検討してください。

DBエリアファイルがブロックスペシャルファイルのとき

このままデータの格納を続けると，DBエリアファイルが満杯となるおそれがあります。そのため，マニュアルHADB　システム構築・運用ガイドのDBエリアファイルの容量増加が原因の場合を参照して，ブロックスペシャルファイルを格納しているディスクの空き容量を確保することを検討してください。

DBエリアファイルがレギュラーファイルのとき

このままデータの格納を続けると，DBエリアの自動増分が行われます。自動増分が行われると，DBエリアの容量が自動的に増加しますが，DBエリアファイル拡張時の更新処理の性能が低下します。もし，DBエリアの自動増分に失敗した場合は，マニュアルHADB　システム構築・運用ガイドのDBエリアの自動増分の失敗が原因の場合を参照してください。

クラウドストレージ機能を使用しているとき

このままデータの格納を続けると，DBエリアが満杯となるおそれがあります。そのため，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの容量不足に関するトラブルを参照して，DBエリアを拡張してください。

(2)　DBエリアごとの使用量（単位：メガバイト）を調べるとき

次の手順に従ってDBエリアごとの使用量（単位：メガバイト）を調べます。

DBエリア名を確認します。

DBarea_name列（出力結果の3列目）に出力されているDBエリア名を確認します。

各DBエリアの使用量（単位：メガバイト）を調べます。

MB_Used_segments列（出力結果の17列目）の値を行ごと（DBエリアごと）に調べます。

13.10.2　特定のDBエリアの使用量を調べる（DBエリアのサマリ情報の出力）

DBエリアDBAREA01のサマリ情報を出力して，次の情報を調べます。

DBエリアDBAREA01の使用率

DBエリアDBAREA01の使用量（単位：メガバイト）

■adbdbstatusコマンドの実行例

adbdbstatus  -c dbarea           ...1
             -n DBAREA01         ...2
             -S M                ...3

［説明］

サマリ情報を取得する範囲として，DBエリアを指定します。

サマリ情報を取得するDBエリア名（DBAREA01）を指定します。

使用量の出力単位として，メガバイトを指定します。

adbdbstatusコマンドを実行すると，DBエリアDBAREA01のサマリ情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　DBエリアの使用率を調べるとき

次の手順に従って，DBエリアDBAREA01の使用率を調べます。

DBエリア名を確認します。

DBエリア名（DBAREA01）が，DBarea_name列（出力結果の3列目）に出力されていることを確認します。

DBエリアの使用率を調べます。

DBエリアのセグメント使用率（単位：％）はUsed_ratio列（出力結果の16列目）に出力されます。セグメント使用率が100％に近い場合は，次のどれかのうち該当する対策を検討してください。

DBエリアファイルがブロックスペシャルファイルのとき

このままデータの格納を続けると，DBエリアファイルが満杯となるおそれがあります。そのため，マニュアルHADB　システム構築・運用ガイドのDBエリアファイルの容量増加が原因の場合を参照して，ブロックスペシャルファイルを格納しているディスクの空き容量を確保することを検討してください。

DBエリアファイルがレギュラーファイルのとき

このままデータの格納を続けると，DBエリアの自動増分が行われます。自動増分が行われると，DBエリアの容量が自動的に増加しますが，DBエリアファイル拡張時の更新処理の性能が低下します。もし，DBエリアの自動増分に失敗した場合は，マニュアルHADB　システム構築・運用ガイドのDBエリアの自動増分の失敗が原因の場合を参照してください。

クラウドストレージ機能を使用しているとき

このままデータの格納を続けると，DBエリアが満杯となるおそれがあります。そのため，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの容量不足に関するトラブルを参照して，DBエリアを拡張してください。

(2)　DBエリアの使用量（単位：メガバイト）を調べるとき

次の手順に従ってDBエリアの使用量（単位：メガバイト）を調べます。

DBエリア名を確認します。

adbdbstatusコマンドに指定したDBエリア名（DBAREA01）が，DBarea_name列（出力結果の3列目）に出力されていることを確認します。

DBエリアの使用量（単位：メガバイト）を調べます。

MB_Used_segments列（出力結果の17列目）の値を調べます。

13.10.3　特定の表の使用量を調べる（表のサマリ情報の出力）

特定の表（ADBUSER01.TABLE01）のサマリ情報を出力して，次に示す情報を調べます。

表ADBUSER01.TABLE01の使用量（単位：キロバイト）

■adbdbstatusコマンドの実行例

adbdbstatus -c table              ...1
            -n ADBUSER01.TABLE01  ...2
            -S K                  ...3
            --shared-lock         ...4

［説明］

サマリ情報を取得する範囲として，表を指定します。

サマリ情報を取得する表名（ADBUSER01.TABLE01）を指定します。

使用量の出力単位として，キロバイトを指定します。

ほかのSQL文やコマンドによってデータベースを更新しているときでも，情報を出力できるように，--shared-lockオプションを指定します。

なお，--shared-lockオプションを指定すると，システム表（実表）については，削除仕掛中のチャンクの使用量を出力できません。

adbdbstatusコマンドを実行すると，表ADBUSER01.TABLE01のサマリ情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　表の使用量（単位：キロバイト）を調べるとき

次の手順に従って，表ADBUSER01.TABLE01の使用量（単位：キロバイト）を調べます。

表のスキーマ名および表識別子を確認します。

表のスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，表識別子（TABLE01）がTable_identifier列（出力結果の6列目）に出力されていることを確認します。

表の使用量（単位：キロバイト）を調べます。

KB_Used_pages列（出力結果の21列目）の値を調べます。

13.10.4　特定の表の状態を調べる（表のサマリ情報の出力）

特定の表（ADBUSER01.TABLE01）のサマリ情報を出力して，次に示す情報を調べます。

表ADBUSER01.TABLE01が更新不可状態かどうか

表ADBUSER01.TABLE01に実行したコマンドが再実行が必要かどうか

■adbdbstatusコマンドの実行例

adbdbstatus -c table              ...1
            -n ADBUSER01.TABLE01  ...2

［説明］

サマリ情報を取得する範囲として，表を指定します。

サマリ情報を取得する表名（ADBUSER01.TABLE01）を指定します。

adbdbstatusコマンドを実行すると，表ADBUSER01.TABLE01のサマリ情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　表が更新不可状態かどうかを調べるとき

次の手順に従って，表ADBUSER01.TABLE01が更新不可状態かどうかを調べます。

表のスキーマ名および表識別子を確認します。

表のスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，表識別子（TABLE01）がTable_identifier列（出力結果の6列目）に出力されていることを確認します。

表が更新不可状態かどうかを調べます。

表が更新不可状態の場合は，Non-updatable列（出力結果の16列目）にnon-updatableが出力されます。表の更新不可状態を解除するには，Rerun_command列（出力結果の18列目）に出力されているコマンドを再実行してください。

この例では，表ADBUSER01.TABLE01の更新不可状態を解除するためにadbimportコマンドの再実行が必要です。

メモ

--shared-lockオプションを指定している場合は，Non-updatable列（出力結果の16列目）にno_checkと出力されます。表の更新不可状態に関する情報は出力されません。表が更新不可状態かどうかを調べる場合は，--shared-lockオプションを指定しないでください。

(2)　表に実行したコマンドの終了状態を調べるとき

次の手順に従って，表ADBUSER01.TABLE01に実行したコマンドの終了状態を調べます。

表のスキーマ名および表識別子を確認します。

表のスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，表識別子（TABLE01）がTable_identifier列（出力結果の6列目）に出力されていることを確認します。

表に実行したコマンドの終了状態を調べます。

表に対してコマンドの再実行が必要な場合は，Command_status列（出力結果の17列目）にabortが出力されます。abortが出力されている場合，Rerun_command列（出力結果の18列目）に出力されているコマンドを再実行してください。

この例では，表ADBUSER01.TABLE01に対してadbimportコマンドの再実行が必要です。

メモ

--shared-lockオプションを指定している場合は，Command_status列（出力結果の17列目）にno_checkが出力されます。コマンドの終了状態が出力されません。表に実行したコマンドの終了状態を調べる場合は，--shared-lockオプションを指定しないでください。

13.10.5　特定のインデクスの使用量を調べる（インデクスのサマリ情報の出力）

特定のインデクス（ADBUSER01.INDEX01）のサマリ情報を出力して，次の情報を調べます。

インデクスADBUSER01.INDEX01の使用量（単位：キロバイト）

■adbdbstatusコマンドの実行例

adbdbstatus -c index              ...1
            -n ADBUSER01.INDEX01  ...2
            -S K                  ...3
            --shared-lock         ...4

［説明］

サマリ情報を取得する範囲として，インデクスを指定します。

サマリ情報を取得するインデクス名（ADBUSER01.INDEX01）を指定します。

使用量の出力単位として，キロバイトを指定します。

ほかのSQL文やコマンドによってデータベースを更新しているときでも，情報を出力できるように，--shared-lockオプションを指定します。

なお，--shared-lockオプションを指定すると，システム表（実表）に定義されたインデクスについては，削除仕掛中のチャンクの使用量を出力できません。

adbdbstatusコマンドを実行すると，インデクスADBUSER01.INDEX01のサマリ情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　インデクスの使用量（単位：キロバイト）を調べるとき

次の手順に従って，インデクスADBUSER01.INDEX01の使用量を調べます。

インデクスのスキーマ名およびインデクス識別子を確認します。

インデクスのスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，インデクス識別子（INDEX01）がIndex_identifier列（出力結果の6列目）に出力されていることを確認します。

インデクスの使用量（単位：キロバイト）を調べます。

KB_Used_pages列（出力結果の18列目）の値を調べます。

13.10.6　特定のインデクスの状態を調べる（インデクスのサマリ情報の出力）

特定のインデクス（ADBUSER01.INDEX01）のサマリ情報を出力して，次の情報を調べます。

インデクスADBUSER01.INDEX01が未完状態かどうか

インデクスADBUSER01.INDEX01が一意性制約違反状態かどうか

■adbdbstatusコマンドの実行例

adbdbstatus -c index              ...1
            -n ADBUSER01.INDEX01  ...2

［説明］

サマリ情報を取得する範囲として，インデクスを指定します。

サマリ情報を取得するインデクス名（ADBUSER01.INDEX01）を指定します。

adbdbstatusコマンドを実行すると，インデクスADBUSER01.INDEX01のサマリ情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　インデクスが未完状態かどうかを調べるとき

次の手順に従って，インデクスADBUSER01.INDEX01が未完状態かどうかを調べます。

インデクスのスキーマ名およびインデクス識別子を確認します。

インデクスのスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，インデクス識別子（INDEX01）がIndex_identifier列（出力結果の6列目）に出力されていることを確認します。

インデクスが未完状態かどうかを調べます。

インデクスが未完状態の場合は，Unfinished列（出力結果の15列目）にunfinishedが出力されます。未完状態のインデクスの種類を確認する場合は，Index_type列（出力結果の8列目）を確認してください。

B-treeインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのB-treeインデクスが未完状態になったときの対処方法を参照してください。

テキストインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのテキストインデクスが未完状態になったときの対処方法を参照してください。

レンジインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのレンジインデクスが未完状態になったときの対処方法を参照してください。

メモ

--shared-lockオプションを指定している場合は，Unfinished列（出力結果の15列目）にno_checkと出力されます。インデクスの未完状態に関する情報は出力されません。インデクスが未完状態かどうかを調べる場合は，--shared-lockオプションを指定しないでください。

(2)　インデクスが一意性制約違反状態かどうかを調べるとき

次の手順に従って，インデクスADBUSER01.INDEX01が一意性制約違反状態かどうかを調べます。

インデクスのスキーマ名およびインデクス識別子を確認します。

インデクスのスキーマ名（ADBUSER01）がSchema_name列（出力結果の5列目）に，インデクス識別子（INDEX01）がIndex_identifier列（出力結果の6列目）に出力されていることを確認します。

インデクスが一意性制約違反状態かどうかを調べます。

インデクスが一意性制約違反状態の場合は，Unique_constraint_violated列（出力結果の12列目）にunique_constraint_violatedが出力されます。

インデクスの一意性制約違反状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドの一意性制約に違反した場合の対処方法（KFAA61205-Wメッセージが出力された場合）を参照してください。

メモ

--shared-lockオプションを指定している場合は，Unique_constraint_violated列（出力結果の12列目）にno_checkと出力されます。インデクスの一意性制約違反状態に関する情報は出力されません。インデクスが一意性制約違反状態かどうかを調べる場合は，--shared-lockオプションを指定しないでください。

13.10.7　特定の表に作成されたアーカイブ状態のチャンクに対応している，全アーカイブファイルのファイルサイズの合計値を調べる（アーカイブ状態のチャンクのサマリ情報の出力）

特定の表（ADBUSER01.TABLE01）に作成されたアーカイブ状態のチャンクのサマリ情報を出力して，アーカイブ状態のチャンクに対応している全アーカイブファイルのファイルサイズの合計値（単位：バイト）を調べます。

■adbdbstatusコマンドの実行例

adbdbstatus -c archivechunk           ...1
            -n ADBUSER01.TABLE01      ...2
            -r 2015/01/01-2015/12/31  ...3

［説明］

サマリ情報を取得する範囲として，アーカイブ状態のチャンクを指定します。

アーカイブ状態のチャンクのサマリ情報を取得する表名（ADBUSER01.TABLE01）を指定します。このとき，アーカイブマルチチャンク表を指定する必要があります。

チャンクに対応しているアーカイブレンジ列の値を基に，チャンクの情報を出力する日付の範囲（2015/01/01-2015/12/31）を指定します。

アーカイブレンジ列のデータ型はDATE型です。

adbdbstatusコマンドを実行すると，表ADBUSER01.TABLE01に作成されたアーカイブ状態のチャンクのサマリ情報が出力されます。

出力結果から，次の手順に従って，アーカイブ状態のチャンクに対応している全アーカイブファイルのファイルサイズの合計値（単位：バイト）を調べます。

手順

表のスキーマ名および表識別子を確認します。

表のスキーマ名（ADBUSER01）がSchema_name列（出力結果の3列目）に，表識別子（TABLE01）がTable_identifier列（出力結果の4列目）に出力されていることを確認します。

アーカイブ状態のチャンクに対応している全アーカイブファイルのファイルサイズの合計値（単位：バイト）を調べます。

Archive_file_size列（出力結果の15列目）の値を調べます。

13.10.8　特定のDBエリアの使用率と使用量をDBエリアファイル単位で調べる（DBエリア，表とインデクスの使用量情報の出力）

特定のDBエリア（DBAREA01）の使用量情報を出力して，次の情報を調べます。

DBAREA01のDBエリアファイル単位での使用率

DBAREA01のDBエリアファイル単位での使用量（単位：メガバイト）

DBAREA01に格納された表の，DBエリアファイル単位での使用量（単位：メガバイト）

DBAREA01に格納されたインデクスの，DBエリアファイル単位での使用量（単位：メガバイト）

■adbdbstatusコマンドの実行例

adbdbstatus -d used               ...1
            -c dbarea             ...2
            -n DBAREA01           ...3
            -S M                  ...4
            --shared-lock         ...5

［説明］

出力する情報として，使用量情報を指定します。

使用量情報を取得する範囲として，DBエリアを指定します。

使用量情報を取得するDBエリア名（DBAREA01）を指定します。

使用量の出力単位として，メガバイトを指定します。

ほかのSQL文やコマンドによってデータベースを更新しているときでも，情報を出力できるように，--shared-lockオプションを指定します。

なお，--shared-lockオプションを指定すると，システム表（実表）やシステム表（実表）に定義されたインデクスについては，削除仕掛中のチャンクの使用量を出力できません。

adbdbstatusコマンドを実行すると，DBエリアDBAREA01の使用量情報が出力されます。

出力結果を確認する方法を次に示します。

(1)　DBエリアの使用率をDBエリアファイル単位で調べるとき

次の手順に従って，DBエリアDBAREA01のDBエリアファイル単位での使用率を調べます。

使用率の計算に必要な行を確認します。

DBエリアの使用量をDBエリアファイル単位で調べるためには，MB_Total_segments列（出力結果の22列目）に値が出力されている行を参照します。

DBエリアファイル名を確認します。

DBarea_filename列（出力結果の9列目）に出力されているDBエリアファイル名を確認します。

メモ

クラウドストレージ機能を使用している場合，DBエリアファイル名は出力されません。そのため，この手順は不要です。

DBエリアファイル単位のDBエリアの使用率を求めます。

MB_Used_segments列（出力結果の20列目）およびMB_Total_segments列（出力結果の22列目）の値を行ごと（DBエリアファイルごと）に調べます。調べた値を次の計算式にそれぞれ代入して，各DBエリアファイルのセグメント使用率を求めます。

DBエリアファイルのセグメント使用率（単位：％）

MB_Used_segments÷MB_Total_segments×100

変数の説明

MB_Used_segments：MB_Used_segments列の値（単位：メガバイト）

MB_Total_segments：MB_Total_segments列の値（単位：メガバイト）

この例では，DBエリアファイル/home/adbmanager/DBDIR/DBAREA01の使用率は1,152メガバイト÷1,152メガバイト×100＝100％，DBエリアファイル/home/adbmanager/DBDIR/DBAREA01.00001の使用率は984メガバイト÷984メガバイト×100＝100％となります。

(2)　DBエリアの使用量（単位：メガバイト）をDBエリアファイル単位で調べるとき

次の手順に従って，DBエリアDBAREA01のDBエリアファイル単位での使用量（単位：メガバイト）を調べます。

使用量の計算に必要な行を確認します。

DBエリアの使用量をDBエリアファイル単位で調べるためには，MB_Total_segments列（出力結果の22列目）に値が出力されている行を参照します。

DBエリアファイル名を確認します。

DBarea_filename列（出力結果の9列目）に出力されているDBエリアファイル名を確認します。

メモ

クラウドストレージ機能を使用している場合，DBエリアファイル名は出力されません。そのため，この手順は不要です。

DBエリアファイル単位でDBエリアの使用量（単位：メガバイト）を調べます。

MB_Used_segments列（出力結果の20列目）の値を行ごと（DBエリアファイルごと）に調べます。

(3)　表の使用量（単位：メガバイト）をDBエリアファイル単位で調べるとき

次の手順に従って，表の使用量（単位：メガバイト）をDBエリアファイル単位で調べます。

使用量の計算に必要な行を確認します。

表の使用量をDBエリアファイル単位で調べるためには，Object_type列（出力結果の11列目）にtableが出力されている行を参照します。

使用量を調べる表のスキーマ名，および表識別子を確認します。

Schema_name列（出力結果の5列目）に出力されている表のスキーマ名，およびObject_identifier列（出力結果の6列目）に出力されている表識別子を確認します。

DBエリアファイル名を確認します。

DBarea_filename列（出力結果の9列目）に出力されているDBエリアファイル名を確認します。

メモ

クラウドストレージ機能を使用している場合，DBエリアファイル名は出力されません。そのため，この手順は不要です。

DBエリアファイル単位で表の使用量（単位：メガバイト）を求めます。

MB_Used_pages列（出力結果の21列目）の値を行ごとに調べます。調べた値をDBエリアファイルごとに合計すると，DBエリアファイルごとの表の使用量が求められます。

この例では，表ADBUSER01.TABLE01のDBエリアファイル/home/adbmanager/DBDIR/DBAREA01の使用量は，36メガバイト＋0メガバイト＝36メガバイトとなります。表ADBUSER01.TABLE01のDBエリアファイル/home/adbmanager/DBDIR/DBAREA01.00001の使用量は，68メガバイト＋0メガバイト＝68メガバイトとなります。

(4)　インデクスの使用量（単位：メガバイト）をDBエリアファイル単位で調べるとき

次の手順に従って，インデクスの使用量（単位：メガバイト）をDBエリアファイル単位で調べます。

使用量の計算に必要な行を確認します。

インデクスの使用量をDBエリアファイル単位で調べるためには，Object_type列（出力結果の11列目）にindexが出力されている行を参照します。

使用量を調べるインデクスのスキーマ名，およびインデクス識別子を確認します。

Schema_name列（出力結果の5列目）に出力されているインデクスのスキーマ名，およびObject_identifier列（出力結果の6列目）に出力されているインデクス識別子を確認します。

DBエリアファイル名を確認します。

DBarea_filename列（出力結果の9列目）に出力されているDBエリアファイル名を確認します。

メモ

クラウドストレージ機能を使用している場合，DBエリアファイル名は出力されません。そのため，この手順は不要です。

DBエリアファイル単位でインデクスの使用量（単位：メガバイト）を求めます。

MB_Used_pages列（出力結果の21列目）の値を行ごとに調べます。調べた値をDBエリアファイルごとに合計すると，DBエリアファイルごとのインデクスの使用量が求められます。

この例では，インデクスADBUSER01.INDEX01のDBエリアファイル/home/adbmanager/DBDIR/DBAREA01の使用量は，8メガバイト＋4メガバイト＝12メガバイトとなります。インデクスADBUSER01.INDEX01のDBエリアファイル/home/adbmanager/DBDIR/DBAREA01.00001の使用量も同様に，8メガバイト＋4メガバイト＝12メガバイトとなります。

13.10.9　特定の表に作成されたアーカイブ状態のチャンクに対応している，各アーカイブファイルのファイルサイズを調べる（アーカイブ状態のチャンクの使用量情報の出力）

特定の表（ADBUSER01.TABLE01）に作成されたアーカイブ状態のチャンクの使用量情報を出力して，アーカイブ状態のチャンクに対応している，各アーカイブファイルのファイルサイズ（単位：バイト）を調べます。

■adbdbstatusコマンドの実行例

adbdbstatus -d used                   ...1
            -c archivechunk           ...2
            -n ADBUSER01.TABLE01      ...3
            -r 2015/01/01-2015/12/31  ...4

［説明］

出力する情報として，使用量情報を指定します。

使用量情報を取得する範囲として，アーカイブ状態のチャンクを指定します。

使用量情報を取得する表名（ADBUSER01.TABLE01）を指定します。このとき，アーカイブマルチチャンク表を指定する必要があります。

チャンクに対応しているアーカイブレンジ列の値を基に，チャンクの情報を出力する日付の範囲（2015/01/01-2015/12/31）を指定します。

アーカイブレンジ列のデータ型はDATE型です。

adbdbstatusコマンドを実行すると，表ADBUSER01.TABLE01に作成されたアーカイブ状態のチャンクの使用量情報が出力されます。

出力結果から，次の手順に従って，アーカイブ状態のチャンクに対応している各アーカイブファイルのファイルサイズ（単位：バイト）を調べます。

手順

表のスキーマ名および表識別子を確認します。

表のスキーマ名（ADBUSER01）がSchema_name列（出力結果の7列目）に，表識別子（TABLE01）がObject_identifier列（出力結果の8列目）に出力されていることを確認します。

アーカイブ状態のチャンクに対応している各アーカイブファイルのファイル名を確認します。

Archive_file_name列（出力結果の16列目）に出力されたファイル名を確認します。

各アーカイブファイルのファイル名に対応するアーカイブファイルのファイルサイズ（単位：バイト）を調べます。

Archive_file_size列（出力結果の17列目）の値を確認します。

メモ

Archive_file_name列に何も出力されていない場合，Archive_file_size列に出力される値は，チャンクに対応している全アーカイブファイルのファイルサイズの合計値です。対応するチャンクのチャンクIDは，Chunk_ID列（出力結果の10列目）で確認できます。

13.10.10　カラムストア表の再編成が必要かどうかを調べる（再編成要否の情報の出力）

特定のカラムストア表（ADBUSER01.TABLE01）の再編成要否の情報を出力して，再編成が必要かどうかを調べます。

■adbdbstatusコマンドの実行例

adbdbstatus -d reorginfo              ...1
            -n ADBUSER01.TABLE01      ...2
            -c 1-3                    ...3

［説明］

出力する情報として，再編成要否の情報を指定します。

再編成要否の情報を取得するカラムストア表の表名（ADBUSER01.TABLE01）を指定します。

解析対象のチャンクIDを指定します（チャンクIDが1～3のチャンクの情報を取得します）。

adbdbstatusコマンドを実行すると，表ADBUSER01.TABLE01の再編成要否の情報が出力されます。

出力結果から，次の手順に従って，各チャンクの再編成が必要かどうかを調べます。

手順

チャンクIDを確認します。

チャンクIDがChunk_ID列（出力結果の8列目）に出力されていることを確認します。

各チャンクの再編成が必要かどうかを確認します。

チャンクの再編成が必要な場合は，Reorganization_necessity列（出力結果の14列目）にRecommendedが出力されます。また，該当するチャンクの再編成を推奨するKFAA60200-Wメッセージが出力されます。

カラムストア表を再編成する方法については，マニュアルHADB　システム構築・運用ガイドのシングルチャンク表を再編成する方法またはマルチチャンク表を再編成する方法（チャンク単位で再編成する場合）を参照してください。

13.11　リターンコード

adbdbstatusコマンドのリターンコードを次の表に示します。

表13‒24　adbdbstatusコマンドのリターンコード

リターンコード

意味

0

adbdbstatusコマンドが正常に終了しました。

4

adbdbstatusコマンドは正常に終了しましたが，警告メッセージが出力されました。表示されたメッセージ，またはメッセージログファイルを確認して，メッセージの対処に従ってください。

なお，再編成を推奨するKFAA60200-Wメッセージが出力されていても，ほかに警告メッセージやエラーメッセージが出力されていない場合は，リターンコード0が出力されます。

8

次のどちらかのエラーが発生しました。

adbdbstatusコマンドの指定に誤りがあり，adbdbstatusコマンドが実行されませんでした。

adbdbstatusコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。

16

adbdbstatusコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbdbstatusコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，最初にKFAA80204-Iメッセージが出力されているかどうかを確認してください。KFAA80204-Iメッセージが出力されていない場合は，adbdbstatusコマンドは正常に終了しています。KFAA80204-Iメッセージが出力されている場合は，KFAA80204-Iメッセージに出力されているリターンコード（4または8）を参照してください。ただし，adbdbstatusコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合も，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbdbstatusコマンドを再実行してください。

13.12　adbdbstatusコマンドの出力規則

サマリ情報，使用量情報，および再編成要否の情報の出力規則を次に示します。

出力結果の先頭の行には，各列のタイトルが出力されます。ただし，-tオプションを指定した場合，タイトルは出力されません。また，タイトルに囲み文字は付きません。

出力される情報が日時の場合，HADBサーバをインストールしたマシンの環境変数TZに設定したタイムゾーンに従います。

最後に出力された項目の末尾には，改行コード（LF）が付きます。

出力結果に出力される文字の文字コードは，HADBサーバをインストールしたマシンの環境変数ADBLANGに設定した文字コードと同じになります。

次に示す文字は表記できません。そのため，1文字につき1つの半角空白が表示されます。

文字コードがSJISの場合

0x00〜0x1F，0x7F〜0xA0，0xE0〜0xFF，およびSJISでサポートされていないバイト列

文字コードがUTF-8の場合

0x00〜0x1F，0x7F，およびUTF-8でサポートされていないバイト列

13.13　注意事項

adbdbstatusコマンドが正常終了した場合，開始メッセージ，およびリターンコードを返す終了メッセージは出力されません。adbdbstatusコマンドが異常終了した場合は，表示されたメッセージ，またはメッセージログファイルを確認して，メッセージの対処に従ってください。

adbdbstatusコマンドは，指定するオプションによって排他制御が異なります。ほかのSQL文やコマンドと，adbdbstatusコマンドを同時に実行する場合は，排他制御で競合が発生しないことを確認してください。SQL文やコマンドの排他制御については，マニュアルHADB　システム構築・運用ガイドの確保される排他資源と排他制御モード，および排他制御の例にあるadbdbstatusコマンド実行時の排他制御（データベースの状態解析）を参照してください。

DBエリアのサマリ情報を出力する場合

定義系SQLまたはadbmodareaコマンドと，adbdbstatusコマンドは同時に実行できません。

DBエリアのサマリ情報以外の情報を出力する場合

定義系SQLまたはadbmodareaコマンドと，adbdbstatusコマンドは同時に実行できません。

また，DBエリアを処理対象とするadbdbstatusコマンドと，そのDBエリアを更新するSQL文やコマンドも同時に実行できません。

さらに，表やインデクスを処理対象とするadbdbstatusコマンドと，その表やインデクスが格納されているDBエリアを更新するSQL文やコマンドも同時に実行できません。

なお，adbdbstatusコマンドに--shared-lockオプションを指定すると，ほかのSQL文やコマンドと，同時に実行できるようになります。--shared-lockオプションについては，「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「--shared-lockオプション」を参照してください。

adbdbstatusコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

データベースの状態解析の処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbdbstatusコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のデータベースの状態解析の処理は中断されません（処理が続行されます）。状態解析の処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

adbdbstatusコマンドは，DBエリア，表およびインデクスの内容を変更しません。このため，adbdbstatusコマンドが異常終了しても，表およびインデクスの回復処理は不要です。必要に応じてadbdbstatusコマンドを再実行してください。

次のコマンドが中断して表が更新不可状態となっている場合に，adbdbstatusコマンドを実行すると，ページ数，セグメント数およびチャンク数に関する項目には，最新の値が出力されないことがあります（次のコマンドが開始されたときの値が出力されることがあります）。

adbimportコマンド（バックグラウンドインポートを実行したとき）

adbidxrebuildコマンド（バックグラウンドインポートが中断したあとに，--create-temp-fileオプションを指定して実行したとき）

adbunarchivechunkコマンド

次に示す事象のあとにadbdbstatusコマンドを実行すると，出力結果のうち，使用中セグメント数，および使用中ページ数に誤差が生じる場合があります。

データベースの更新中にHADBサーバが異常終了した場合

複数のトランザクションで，データベースの更新中にグローバルバッファが不足した旨のエラー（KFAA30919-Eメッセージ）が発生した場合

セグメントを解放するコマンド，およびSQL文（定義系SQLなど）がエラーとなっている場合

adbmergechunkコマンドでマージ元チャンクの削除が完了していない場合，マージチャンク処理で一時的に使用するシステム用のチャンクが，表のサマリ情報の「表で作成されたチャンク数」に含まれます。そのため，表のサマリ情報の「表で作成されたチャンク数」が，表定義時に指定した「チャンク数の最大値」より1つ多くなることがあります。

adbmergechunkコマンドで表のセグメントがマージされた場合，再利用されないページ数が増加し，使用中ページ数が増えることがあります。そのため，adbdbstatusコマンドで使用中ページ数を確認したときに，マージチャンク処理の前後で使用中ページ数の値が変わる（増える）ことがあります。

次に示す項目をメガバイト単位またはギガバイト単位で出力する場合（-SオプションにMまたはGを指定する場合），各項目の値は小数点第1位を切り上げて，正の整数または0で出力されます。

使用量に関する出力項目（サマリ情報または使用量情報）

「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」

再編成要否に関する出力項目（再編成要否の情報）

「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(2)　オプションの説明」の「表13‒14　再編成要否に関する出力項目の表示単位と列のタイトル」

このため，各項目の値が小さいケース（メガバイト単位で出力するときは102.4キロバイト未満，ギガバイト単位で出力するときは102.4メガバイト未満）では，各項目に0が出力されます。正確な値を知りたい場合は，-SオプションにKを指定し，各項目をキロバイト単位で出力してください。

次に示す項目の表示単位は，タイトル行に出力されます。

使用量に関する出力項目（サマリ情報または使用量情報）

「13.2.1　指定形式およびオプションの説明【サマリ情報・使用量情報を出力する場合】」の「(3)　オプションの説明」の「表13‒2　使用量に関する出力項目の表示単位と列のタイトル」

再編成要否に関する出力項目（再編成要否の情報）

「13.2.2　指定形式およびオプションの説明【カラムストア表の再編成要否の情報を出力する場合】」の「(2)　オプションの説明」の「表13‒14　再編成要否に関する出力項目の表示単位と列のタイトル」

このため，各項目の表示単位を確認する場合は，-tオプションを省略して，タイトル行を出力してください。また，adbdbstatusコマンドの出力結果を保存する場合も，表示単位を確認できるようにするために，タイトル行と出力結果をあわせて保存してください。

次に示す情報を出力する場合，ディクショナリ用DBエリアおよびシステム表用DBエリアに関する行では，HADBが使用する表やインデクスに関する情報が出力されます（HADBユーザが定義した表およびインデクス以外の情報が出力されます）。

表のサマリ情報

インデクスのサマリ情報

DBエリア，表とインデクスの使用量情報

adbreorgsystemdataコマンドの実行中にエラーが発生し，再編成前のデータが残った場合，再編成前のデータは「削除仕掛中のチャンク」として出力されます。

14　adbexport（データのエクスポート）

この章では，adbexportコマンドの機能と使い方について説明します。

なお，この章の「ディクショナリ表」はディクショナリ表（ビュー表）を，「システム表」はシステム表（ビュー表）を意味しています。

14.1　機能

adbexportコマンドの機能，および使用するスレッドについて説明します。

adbexportコマンドは，コマンド実行時にHADBサーバに接続します。

14.1.1　機能概要

adbexportコマンドを実行すると，実表およびビュー表のデータをファイルに出力できます。この処理をデータエクスポート処理といいます。adbexportコマンドに表名を指定した場合は，指定した表（実表およびビュー表）のデータを出力できます。adbexportコマンドにSQL記述ファイルを指定した場合は，ファイル中に記述したSQL文（SELECT文）の検索結果を出力できます。

データエクスポート処理の概要を次の図に示します。

図14‒1　データエクスポート処理の概要

［説明］

adbexportコマンドを実行すると，表データをファイルに出力できます。SQL記述ファイルを指定した場合は，任意の検索結果を出力できます。

なお，adbexportコマンドでデータをエクスポートできる表は，次の表です。

EXPORT TABLE権限を持っている実表

EXPORT TABLE権限を持っているビュー表

ディクショナリ表

システム表

メモ

マルチチャンク表のデータをエクスポートする場合

待機状態のチャンクに含まれるデータを出力したい場合は，待機状態のチャンクのチャンクIDを出力対象に指定して，チャンク単位でデータを出力する必要があります。チャンクIDを指定しないと，待機状態のチャンクは出力対象外になります。

チャンク単位でデータを出力する方法については，「14.2.1　指定形式およびオプションの説明」の「(3)　オプションの説明」にある-cオプションの説明を参照してください。

各ファイルについて次に説明します。

出力データファイル

表データが出力されるファイルです。出力形式はCSV形式です。CSV形式については，「14.5　出力データファイルの形式（CSV形式）」を参照してください。

なお，出力データファイルを圧縮して，GZIP形式のファイルとしてエクスポートすることもできます。出力データファイルの圧縮形式の詳細については，「14.6　出力データファイルの圧縮形式」を参照してください。

出力データパスファイル

出力データファイルの出力先のパス名一覧を指定するファイルです。

エクスポートオプションファイル

adbexportコマンドの実行環境を設定するオプションを指定するファイルです。

SQL記述ファイル

任意の検索結果をエクスポートする際に，検索に使用するSELECT文を記載したファイルです。

14.1.2　adbexportコマンドが使用するスレッドの関係

adbexportコマンドは，次の処理で処理リアルスレッドを使用します。

表データの検索

この処理では，「1～（ MAX_RTHD_NUM－1－処理2で使用する処理リアルスレッド数）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，エクスポートオプションadb_export_rthd_numの指定値またはデフォルト値となります。エクスポートオプションadb_export_rthd_numのデフォルト値については，「14.2.2　エクスポートオプションの形式」の「(2)　指定形式の説明」の「(a)　性能に関するオプション」にある，エクスポートオプションadb_export_rthd_numを参照してください。

検索結果の出力

この処理では，「1～（ MIN（↓（MAX_RTHD_NUM－1）÷2↓，出力データファイルの数））」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1～処理3は，同時に実行されます。

adbexportコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図14‒2　adbexportコマンドが処理リアルスレッドを使用する処理

14.2　adbexportコマンドの指定形式

adbexportコマンドの指定形式，およびエクスポートオプションの形式について説明します。

adbexportコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

14.2.1　指定形式およびオプションの説明

(1)　指定形式

adbexport
  -u 認可識別子
  〔-p パスワード〕
  〔-k ｛囲み文字｜none｝〕
  〔-s ｛区切り文字｜tab｝〕
  〔-g データエクスポート処理の経過メッセージの出力間隔〕
  〔-z エクスポートオプションファイル名〕
  ｛-q SQL記述ファイル名｜-n 処理対象表〔 -c チャンクID〕｝
  〔--compress GZIP〕
  〔--with-column-name〕
  出力データパスファイル名

(2)　オプションの関係

adbexportコマンドでどのような情報を出力したいかによって，オプションの指定が異なります。データエクスポートの実行パターンごとのオプションの指定を次に示します。各オプションの詳細については，「(3)　オプションの説明」の「-q」「-n」「-c」それぞれの説明を参照してください。

表14‒1　データエクスポートの実行パターンごとのオプションの指定

項番

データエクスポートの実行パターン

-qオプションの指定

-nオプションの指定

-cオプションの指定

1

表の全データをエクスポートしたい※1

×

○

×

2

特定期間にインポートしたデータ（特定のチャンクのデータ）だけをエクスポートしたい※2

×

○

○

3

SELECT文の検索結果をエクスポートしたい※1

○

×

×

（凡例）

○：オプションを指定します。

×：オプションを指定しません。

注

次に示す組み合わせでオプションを指定すると，adbexportコマンドがエラーとなります。

・-qオプションと-nオプションを同時に指定した場合

・-qオプションと-cオプションを同時に指定した場合

・-cオプションを単独で指定した場合

注※1

待機状態のチャンクに含まれるデータはエクスポートされません。

注※2

マルチチャンク表に対してだけ，実行できます。

(3)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbexportコマンドを実行するHADBユーザの認可識別子を指定します。

このオプションには，次に示す権限を持つHADBユーザの認可識別子を指定してください。

ディクショナリ表またはシステム表をエクスポートする場合

CONNECT権限を持つHADBユーザの認可識別子を指定してください。

HADBユーザが定義した実表またはビュー表をエクスポートする場合

CONNECT権限，およびエクスポート対象表に対するEXPORT TABLE権限を持つHADBユーザの認可識別子を指定してください。

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbexportコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-k ｛囲み文字｜none｝

〜〈文字列〉((1バイト))《"》

出力データファイル中のフィールドデータを囲む，囲み文字を指定します。このオプションを省略した場合は，囲み文字として二重引用符（"）が仮定されます。このオプションにnoneを指定した場合は，囲み文字なしでデータが出力されます。

指定規則を次に示します。

囲み文字として指定できる文字は，1バイト文字だけです。2バイト以上の文字列は指定できません。

次に示す文字も囲み文字として指定できません。

空白，タブ，アスタリスク（*）

区切り文字（-sオプションの指定値または省略値）と同じ文字

アポストロフィ（ ' ）を囲み文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を囲み文字として指定する場合の例

adbexport …　-k "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を囲み文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を囲み文字として指定する場合の例

adbexport …　-k "|" …

エクスポート処理の対象となる表に数データまたは日時データが定義されている場合は，囲み文字に数データまたは日時データで扱う文字を指定しないでください。指定すると，出力したデータを再度インポートする際に変換エラーとなることがあります。

エクスポート処理の対象となる表に配列型の列が定義されている場合は，囲み文字に波括弧（{}）を指定しないでください。指定すると，出力したデータを再度インポートする際に変換エラーとなることがあります。

重要

文字データに囲み文字と同じ文字が含まれる場合，その文字は2つ連続で出力されます。

重要

このオプションにnoneを指定すると，出力データファイルには，すべてのデータ型で囲み文字なしの状態で，データが出力されます。囲み文字なしのデータが出力された出力データファイルは，adbimportコマンドの入力データファイルとして使用できない場合があります。例を次に示します。

（例1）CHARACTER型の列にデータ「A,B,C」が格納されている場合

出力されたデータは「A,B,C」になります。このデータを，区切り文字にコンマ（ , ）を指定してインポートすると，「A」，「B」，「C」という別々のデータとして扱われます。つまり，「A,B,C」という1つのデータとしては扱われません。そのため，表に対して想定どおりにデータが格納されなかったり，インポートエラーが発生したりするおそれがあります。

（例2）VARCHAR型の列に長さが0バイトのデータが格納されている場合

出力されたデータは，長さが0バイトの文字列になります。このデータを，囲み文字なしでインポートすると，ナル値として扱われます。そのため，元のデータとは異なったデータとして扱われてしまいます。

（例3）CHARACTER型の列に改行コード（¥n）を含むデータ「AB¥nC」が格納されている場合

出力されたデータは「AB¥nC」になります。このデータをインポートすると，「AB」，「C」という別々のデータとして扱われます。つまり，「AB¥nC」という1つのデータとしては扱われません。そのため，表に対して想定どおりにデータが格納されなかったり，インポートエラーが発生したりするおそれがあります。

●-s ｛区切り文字｜tab｝

〜〈文字列〉((1バイト))《 , 》

出力データファイル中のフィールドデータを区切る，区切り文字を指定します。区切り文字にタブを指定する場合は，tabを指定してください。このオプションを省略した場合は，区切り文字としてコンマ（ , ）が仮定されます。

指定規則を次に示します。

区切り文字として指定できる文字は，tabまたは1バイト文字だけです。tab以外の2バイト以上の文字列は指定できません。

次に示す文字も区切り文字として指定できません。

英大文字（A〜Z），英小文字（a〜z），数字（0〜9），下線（_），二重引用符（"），アスタリスク（*）

囲み文字（-kオプションの指定値または省略値）と同じ文字

次に示す文字は表データの文字コードと重なるおそれがあるため，区切り文字として適していません。

符号（+，-），スラッシュ（/），コロン（:），ピリオド（.），|，¥，[，]，(，)，{，}，~など

アポストロフィ（ ' ）を区切り文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を区切り文字として指定する場合の例

adbexport …　-s "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を区切り文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を区切り文字として指定する場合の例

adbexport …　-s "|" …

エクスポート処理の対象となる表に配列型の列が定義されている場合は，区切り文字に波括弧（{}）を指定しないでください。指定すると，出力したデータを再度インポートする際に変換エラーとなることがあります。

●-g データエクスポート処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

データエクスポート処理の経過メッセージの出力間隔を指定します。例えば，このオプションに2を指定すると，データエクスポート処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-z エクスポートオプションファイル名

〜〈OSパス名〉((2〜510バイト))

エクスポートオプションを指定したエクスポートオプションファイルの絶対パス名を指定します。このオプションを省略すると，エクスポートオプションファイルが指定されないため，すべてのエクスポートオプションにデフォルト値が仮定されます。

エクスポートオプションについては，「14.2.2　エクスポートオプションの形式」を参照してください。

なお，エクスポートオプションファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。エクスポートオプションファイル名と重複しないようにする必要があるファイルについては，「14.8　注意事項」を参照してください。

●-q SQL記述ファイル名

〜〈OSパス名〉((2〜510バイト))

SQL記述ファイルの絶対パス名を指定します。このオプションを指定した場合，-cオプションは指定できません。

SQL記述ファイルは，任意の検索結果をエクスポートする際に，検索に使用するSELECT文を記載したファイルです。

SQL記述ファイルの指定例を次に示します。

SQL記述ファイルの指定例

/*COMMENT*/ SELECT * FROM "TABLE01"
WHERE "C1" < 3000

SQL記述ファイルの指定規則を次に示します。

SQL記述ファイルに指定できるSQL文の最大サイズは，16,000,000バイトです。

SQL記述ファイル中に複数のSQL文は指定できません。

SQL記述ファイル中に？パラメタは指定できません。

SQL記述ファイルは，HADBサーバをインストールしたマシンの環境変数ADBLANGに設定した文字コードで作成してください。

X'00'〜X'1F'のコードを指定した場合，半角空白に変換されて解釈されます。

SQL文の途中で改行することができます。改行する場合の改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。SQL文の途中で改行すると，改行が半角空白に変換され，連結されて解釈されます。

SQL記述ファイル中の「/*」から，それ以降に現れる最初の「*/」までのすべての文字は注釈と見なされます。注釈の詳細については，マニュアルHADB　SQLリファレンスの基本項目のSQLの記述規則の分離符号に関する規則にある注釈を参照してください。

SQL文の終わりに，1文字分だけセミコロン（ ; ）を指定できます。指定したセミコロンは，半角空白に変換されて解釈されます。なお，指定したセミコロンの後ろに指定できる文字列は，半角空白，タブ，および改行だけです。

重要

作業表を作成する可能性がある検索（ORDER BY句，GROUP BY句，DISTINCTなどを指定した検索）の場合，adbexportコマンドを実行してから経過メッセージや出力件数のメッセージが出力されるまでに，時間が掛かることがあります。

SQL記述ファイル中に指定したSQL文で検索できる表は，次のとおりです。

EXPORT TABLE権限を持っている実表またはビュー表

自分が所有している実表またはビュー表を検索する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している実表またはビュー表を検索する場合は，スキーマ名を指定してください。

ディクショナリ表またはシステム表

ディクショナリ表またはシステム表を検索する場合は，スキーマ名に"MASTER"を指定してください。

なお，実際に実行したSQL文はメッセージログファイルに出力されます。

●-n 処理対象表

データを出力する表を「スキーマ名.表識別子」の形式で指定します。スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

マルチチャンク表のデータをチャンク単位で出力したい場合は，このオプションと同時に-cオプションを指定してください。

このオプションに指定できる表は次のとおりです。

EXPORT TABLE権限を持っている実表またはビュー表

自分が所有している実表またはビュー表を検索する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している実表またはビュー表を検索する場合は，スキーマ名を指定してください。

ディクショナリ表またはシステム表

ディクショナリ表またはシステム表を検索する場合は，スキーマ名に"MASTER"を指定してください。

●-c チャンクID

〜〈整数〉((1〜9,223,372,036,854,775,807))

マルチチャンク表のデータをチャンク単位で出力したい場合，このオプションにチャンクIDを指定します。このオプションを使用すると，指定したチャンクIDのチャンクが待機状態の場合も，対象のチャンクに含まれるデータを出力できます。

このオプションを指定する場合，必ず-nオプションにマルチチャンク表を指定してください。また，このオプションを指定する場合，-qオプションは指定できません。

指定したチャンクIDが処理対象表に存在しない場合，出力データは0件になります。

チャンクIDの検索方法を次に示します。

システム表のSTATUS_CHUNKSを検索する

システム表のSTATUS_CHUNKSを検索し，チャンクIDを確認してください。詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表のシステム表の検索の表名から表内の全チャンクの情報を調べる場合を参照してください。

adbdbstatusコマンドを実行する

次に示すコマンドを実行して，DBエリア，表とインデクスの使用量情報を出力し，チャンクID（Chunk_ID）を確認してください（結果はCSV形式で出力されます）。DBエリア，表とインデクスの使用量情報で出力される項目の詳細については，「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」を参照してください。

adbdbstatus -d used -c table -n 実表名

実表名は「スキーマ名.表識別子」の形式で指定してください。

●--compress GZIP

出力データファイルを圧縮してGZIP形式のファイルとしてエクスポートしたい場合に，このオプションを指定します。

●--with-column-name

各出力データファイルの1行目に列名を出力したい場合に，このオプションを指定します。

このオプションと同時に指定するオプションによって，出力される列名が決まります。出力される列名の規則を次の表に示します。

表14‒2　出力される列名

項番

同時に指定するオプション

出力される列名

1

-nオプション（処理対象表のデータを出力する場合）

処理対象表の列名

2

-qオプション（SQL記述ファイル中のSQL文の検索結果を出力する場合）

SQL記述ファイルに指定したSQL文の問合せ式の結果，導出される表の列名（検索項目列名）

（例）次に示すSQL文をSQL記述ファイルに指定した場合，列名として「C1」「MAX_C2」「MIN_C2」が出力されます。

SELECT "C1",MAX("C2") AS "MAX_C2",MIN("C2") AS "MIN_C2"
    FROM "T1" GROUP BY "C1"

導出される表の列名規則については，マニュアルHADB　SQLリファレンスのSELECT文の指定形式および規則にある規則を参照してください。

各列名はVARCHAR型の列のデータと同じ形式で出力されます。VARCHAR型の出力形式については，「14.5.3　フィールドデータの出力形式」を参照してください。

出力データファイルを複数指定した場合，すべての出力データファイルの1行目に列名が出力されます。ただし，データが出力されないファイルには列名が出力されません。

重要

出力データファイルをadbimportコマンドの入力データファイルとして使用する場合は，このオプションを指定しないでください。このオプションを指定して出力したファイルをadbimportコマンドの入力データファイルとして使用すると，列名も表データとして格納されてしまいます。

●出力データパスファイル名

〜〈OSパス名〉((2〜510バイト))

出力データパスファイルを絶対パス名で指定します。指定するパス名に半角空白を含む場合は，パス名全体をアポストロフィ（'）で囲んでください。

出力データパスファイルには，出力データファイルの格納場所を指定します。出力データファイルの格納場所は，2〜510バイトの絶対パスで指定してください。パス名として使用できる文字は，出力データパスファイル名と同じです。

なお，HADBサーバは，出力データファイルに拡張子を付与しません。指定した出力データファイルの絶対パスのとおりに，出力データファイルが作成されます。そのため，--compress GZIPオプションを指定する場合，出力データファイルの絶対パスの末尾に，拡張子「.gz」を指定することを推奨します。末尾に拡張子「.gz」を指定することで，エクスポートされたファイルがGZIP形式のファイルであると判別しやすくなります。

データエクスポート処理の性能を向上させるために，出力データファイルの格納場所は，複数指定することを推奨します。ただし，検索結果の並びのとおりにファイルに出力したい場合は，出力データファイルの格納場所を1個だけ指定してください。

また，1つのディレクトリ下に格納される出力データファイルに対して出力が集中すると，性能低下の原因になります。そのため，出力データファイルの格納場所として異なるディスクのディレクトリを指定して，ディスクに対する出力処理の負荷分散をすることを推奨します。

出力データパスファイルの指定例を次に示します。

■出力データパスファイルの指定例（--compress GZIPオプションを指定していない場合）

/mnt/diska/wwwww/exp1.csv
/mnt/diskb/xxxxx/exp2.csv
/mnt/diskc/yyyyy/exp3.csv
/mnt/diskd/zzzzz/exp4.csv

この例では，4つの出力データファイルに出力するとして，出力データファイルの格納場所をそれぞれ指定しています。

■出力データパスファイルの指定例（--compress GZIPオプションを指定している場合）

/mnt/diska/wwwww/exp1.csv.gz
/mnt/diskb/xxxxx/exp2.csv.gz
/mnt/diskc/yyyyy/exp3.csv.gz
/mnt/diskd/zzzzz/exp4.csv.gz

この例では，4つの出力データファイル（GZIP形式で圧縮されたファイル）に出力するとして，出力データファイルの格納場所をそれぞれ指定しています。

なお，--compress GZIPオプションを指定している場合は，上記の例のように，出力データファイルの絶対パスの末尾に，拡張子「.gz」を指定することを推奨します。末尾に拡張子「.gz」を指定することで，エクスポートされたファイルがGZIP形式のファイルであると判別しやすくなります。

重要

adbexportコマンドを実行すると，出力データパスファイルに指定した出力データファイルの格納場所すべてに，空のファイルが作成されます。そのあとで，各ファイルにデータが出力されます。このため，ファイルに出力するデータがない場合でも，0バイトのファイルが作成されます。

なお，--compress GZIPオプションを指定している場合で，ファイルに出力するデータがないときは，0バイトのファイル（GZIP形式）が作成されます。

出力データファイルを複数指定した場合，ファイルごとに出力されるデータ件数にばらつきが出ます。その影響で，データ件数が0件のファイルが作成されることがあります。

出力データパスファイルに指定した出力データファイルの格納場所に，出力データファイルと同名のファイルがすでに存在する場合，adbexportコマンドはエラーとなります。既存のファイルを移動するか削除するかしたあとで，adbexportコマンドを再実行してください。

なお，adbexportコマンド以外のプログラムで使用するファイル名と，出力データパスファイル名，およびファイル中に指定する出力データファイルの格納場所が重複しないようにしてください。重複した場合，ほかのプログラムによって，出力データパスファイルおよび出力データファイルのデータが失われるおそれがあります。出力データパスファイル名，および出力データファイルの格納場所と重複しないようにする必要があるファイルについては，「14.8　注意事項」を参照してください。

メモ

出力データファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

14.2.2　エクスポートオプションの形式

(1)　指定形式

性能に関するオプション
  〔set adb_export_rthd_num = adbexportコマンドが使用する処理リアルスレッド数〕
  〔set adb_export_scan_buff_size = 表データの検索バッファサイズ〕
  〔set adb_export_wrktbl_blk_num = ローカル作業表用バッファのページ数〕
  〔set adb_export_hashtbl_area_size = ハッシュテーブル領域サイズ〕
  〔set adb_export_hashflt_area_size = ハッシュフィルタ領域サイズ〕

出力形式に関するオプション
  〔set adb_export_order_mode = ｛BYTE｜ISO｝〕

上記のエクスポートオプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

(a)　性能に関するオプション

●adb_export_rthd_num = adbexportコマンドが使用する処理リアルスレッド数

〜〈整数〉((3〜4,096))

adbexportコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbexportコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbexportコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbexportコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「14.1.2　adbexportコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbexportコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表14‒3　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0～2の値を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに3以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに3以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbexportコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_export_scan_buff_size = 表データの検索バッファサイズ

〜〈整数〉((1〜2,048))《16》（単位：メガバイト）

表データの検索結果を保持するバッファのサイズをメガバイト単位で指定します。指定値を大きくすると，表データを検索する際のオーバヘッドを削減できます。

検索結果のデータ長の10,000件分程度のサイズを指定値の目安としてください。

検索結果のデータ長の求め方については，マニュアルHADB　システム構築・運用ガイドのリソースの設計のHADBサーバのメモリ所要量の見積もりの通常運用時のメモリ所要量の求め方にある表各データ型のデータ長の一覧を参照してください。

なお，1つの検索バッファに格納された検索結果は，同じ出力データファイルに出力されます。

また，検索結果が1件も格納できないバッファサイズを指定した場合，adbexportコマンドがエラーとなります。

●adb_export_wrktbl_blk_num = ローカル作業表用バッファのページ数

〜〈整数〉((5〜100,000,000))

通常はこのオプションを省略してください。このオプションを省略した場合，サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドに指定したローカル作業表用バッファのページ数が適用されます。

adbexportコマンドを実行する際に，ローカル作業表を作成するSQL文の実行時間を短縮したい場合は，このオプションにローカル作業表用バッファのページ数を指定します。このオプションで指定して確保されたローカル作業表用バッファは，adbexportコマンドでローカル作業表を作成するSQL文を実行したときだけ使用されます。このオプションとサーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを同時に指定すると，adbexportコマンド実行時には，このオプションに指定したローカル作業表用バッファのページ数が適用されます。

このオプションの指定値の見積もりについては，マニュアルHADB　システム構築・運用ガイドのリソースの設計の作業表に関する見積もりのローカル作業表用バッファのページ数の見積もりを参照してください。

なお，このオプションを指定して確保されたローカル作業表用バッファのページ数は，adbmodbuffコマンドで変更できません。adbmodbuffコマンドについては，「38.　adbmodbuff（バッファの変更）」を参照してください。

メモ

ローカル作業表とは，SQL文を処理するリアルスレッドごとに作成される作業表です。このため，このオプションで指定したページ数分のローカル作業表用バッファは，SQL文を処理するリアルスレッドごとに確保されます。ローカル作業表を作成するSQL文については，マニュアルHADB　AP開発ガイドのAPの性能向上に関する設計の作業表が作成されるSQLを実行する際の考慮点のSQLを実行した場合に作成される作業表についてを参照してください。

●adb_export_hashtbl_area_size = ハッシュテーブル領域サイズ

〜〈整数〉((0〜4,194,304))（単位：メガバイト）

通常はこのオプションを省略してください。このオプションを省略した場合，サーバ定義のadb_sql_exe_hashtbl_area_sizeオペランドに指定したハッシュテーブル領域サイズが適用されます。

adbexportコマンドを実行する際に，ハッシュ検索が適用されるSQL文の実行時間を短縮したい場合は，このオプションにハッシュテーブル領域サイズをメガバイト単位で指定します。このオプションの指定値の見積もりについては，マニュアルHADB　システム構築・運用ガイドのハッシュテーブル領域サイズの見直しによるSQL文の実行時間の短縮に関するチューニングを参照してください。

このオプションを指定して確保されたハッシュテーブル領域は，adbexportコマンドでハッシュ検索が適用されるSQL文を実行したときだけ使用されます。このオプションとサーバ定義のadb_sql_exe_hashtbl_area_sizeオペランドを同時に指定すると，adbexportコマンド実行時には，このオプションに指定したハッシュテーブル領域サイズが適用されます。サーバ定義のadb_sql_exe_hashtbl_area_sizeオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランドを参照してください。

●adb_export_hashflt_area_size = ハッシュフィルタ領域サイズ

〜〈整数〉((0〜419,430))（単位：メガバイト）

通常はこのオプションを省略してください。なお，エクスポートオプションadb_export_hashtbl_area_sizeを指定しているかどうかによって，このオプションを省略した場合に適用される値が変わります。

エクスポートオプションadb_export_hashtbl_area_sizeを指定している場合

次に示す値が適用されます。

↑エクスポートオプションadb_export_hashtbl_area_sizeの値÷10↑

エクスポートオプションadb_export_hashtbl_area_sizeを指定していない場合

サーバ定義adb_sql_exe_hashflt_area_sizeオペランドの値が適用されます。

adbexportコマンドを実行する際に，ハッシュフィルタが適用されるSQL文の実行時間を短縮したい場合は，このオプションにハッシュフィルタ領域サイズをメガバイト単位で指定します。このオプションの指定値の見積もりについては，マニュアルHADB　システム構築・運用ガイドのハッシュフィルタ領域サイズの見直しによるSQL文の実行時間の短縮に関するチューニングを参照してください。

このオプションを指定して確保されたハッシュフィルタ領域は，adbexportコマンドでハッシュフィルタが適用されるSQL文を実行したときだけ使用されます。このオプションとサーバ定義のadb_sql_exe_hashflt_area_sizeオペランドを同時に指定すると，adbexportコマンド実行時には，このオプションに指定したハッシュフィルタ領域サイズが適用されます。サーバ定義のadb_sql_exe_hashflt_area_sizeオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランドを参照してください。

(b)　出力結果に関するオプション

●adb_export_order_mode = ｛BYTE｜ISO｝

SQL記述ファイルに，SELECT文の最も外側の問合せ指定または問合せ式本体に指定したORDER BY句を指定した際の，文字データの並び替え順序を指定します。

このオプションは，サーバ定義のadb_sql_order_modeオペランドで指定した並び替え順序とは異なる順序で，検索結果をエクスポートしたい場合に指定します。

このオプションを省略した場合，SQL記述ファイルにSELECT文の最も外側の問合せ指定または問合せ式本体に指定したORDER BY句を指定すると，サーバ定義のadb_sql_order_modeオペランドで指定した並び替え順序でエクスポートされます。adb_sql_order_modeオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容のSQL文に関するオペランド（set形式）を参照してください。

BYTE：

文字データがバイトコード順で出力されます。

ISO：

文字データがソートコード順（ISO/IEC14651:2011準拠）で出力されます。ただし，HADBサーバの環境変数ADBLANGにSJISを指定している場合，ISOは指定できません。

14.3　使用例

adbexportコマンドを使用して表データをエクスポートする方法を，例題形式で説明します。

adbexportコマンドが異常終了した場合は，「14.7　adbexportコマンドが異常終了したときの対処方法」を参照して対処してください。

14.3.1　表内のすべてのデータをエクスポートする場合

次に示す条件で，表データのエクスポートを行います。

実表TABLE01に格納されているすべてのデータをエクスポートする

エクスポート結果を，4つの出力データファイルに出力する

このとき，次に示す手順でadbexportコマンドを実行します。

手順

出力データパスファイルを作成する

エクスポートオプションファイルを作成する

adbexportコマンドを実行する

各手順の例を以降で説明します。

(1)　出力データパスファイルを作成する

出力データパスファイルを作成して，すべての出力データファイルのパスを指定します。

出力データパスファイルの指定例

/mnt/diska/wwwww/exp1.csv
/mnt/diskb/xxxxx/exp2.csv
/mnt/diskc/yyyyy/exp3.csv
/mnt/diskd/zzzzz/exp4.csv

(2)　エクスポートオプションファイルを作成する

エクスポートオプションファイルを作成して，エクスポートオプションを指定します。

エクスポートオプションファイルの指定例

set adb_export_rthd_num = 3           ...1
set adb_export_scan_buff_size = 64    ...2

［説明］

adbexportコマンド実行時に使用する処理リアルスレッド数を指定します。

表データの検索結果を保持するバッファのサイズを指定します。

(3)　adbexportコマンドを実行する

adbexport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -z /home/adbmanager/exp_file/env01.txt   ...3
          -n TABLE01                               ...4
          /home/adbmanager/exp_file/expf01.txt     ...5

［説明］

adbexportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(2)　エクスポートオプションファイルを作成する」で作成したエクスポートオプションファイルの絶対パス名を指定します。

処理対象表を指定します。

「(1)　出力データパスファイルを作成する」で作成した出力データパスファイルの絶対パス名を指定します。

14.3.2　特定のチャンクIDのデータをエクスポートする場合

次に示す条件で，表データのエクスポートを行います。

マルチチャンク表TABLE01の，チャンクIDが10のデータをエクスポートする

エクスポート結果を，4つの出力データファイルに出力する

このとき，次に示す手順でadbexportコマンドを実行します。

手順

出力データパスファイルを作成する

エクスポートオプションファイルを作成する

adbexportコマンドを実行する

各手順の例を以降で説明します。

(1)　出力データパスファイルを作成する

出力データパスファイルを作成して，すべての出力データファイルのパスを指定します。

出力データパスファイルの指定例

/mnt/diska/wwwww/exp1.csv
/mnt/diskb/xxxxx/exp2.csv
/mnt/diskc/yyyyy/exp3.csv
/mnt/diskd/zzzzz/exp4.csv

(2)　エクスポートオプションファイルを作成する

エクスポートオプションファイルを作成して，エクスポートオプションを指定します。

エクスポートオプションファイルの指定例

set adb_export_rthd_num = 3           ...1
set adb_export_scan_buff_size = 64    ...2

［説明］

adbexportコマンド実行時に使用する処理リアルスレッド数を指定します。

表データの検索結果を保持するバッファのサイズを指定します。

(3)　adbexportコマンドを実行する

adbexport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -z /home/adbmanager/exp_file/env01.txt   ...3
          -n TABLE01                               ...4
          -c 10                                    ...5
          /home/adbmanager/exp_file/expf01.txt     ...6

［説明］

adbexportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(2)　エクスポートオプションファイルを作成する」で作成したエクスポートオプションファイルの絶対パス名を指定します。

処理対象表を指定します。

チャンクIDを指定します。

「(1)　出力データパスファイルを作成する」で作成した出力データパスファイルの絶対パス名を指定します。

14.3.3　SQL文の検索結果をエクスポートする場合

次に示す条件で，表データのエクスポートを行います。

実表TABLE01のデータをエクスポートする

SQL記述ファイルに指定したSQL文の検索結果をエクスポートする

エクスポート結果を，4つの出力データファイルに出力する

このとき，次に示す手順でadbexportコマンドを実行します。

手順

出力データパスファイルを作成する

エクスポートオプションファイルを作成する

SQL記述ファイルを作成する

adbexportコマンドを実行する

各手順の例を以降で説明します。

(1)　出力データパスファイルを作成する

出力データパスファイルを作成して，すべての出力データファイルのパスを指定します。

出力データパスファイルの指定例

/mnt/diska/wwwww/exp1.csv
/mnt/diskb/xxxxx/exp2.csv
/mnt/diskc/yyyyy/exp3.csv
/mnt/diskd/zzzzz/exp4.csv

(2)　エクスポートオプションファイルを作成する

エクスポートオプションファイルを作成して，エクスポートオプションを指定します。

エクスポートオプションファイルの指定例

set adb_export_rthd_num = 3           ...1
set adb_export_scan_buff_size = 64    ...2

［説明］

adbexportコマンド実行時に使用する処理リアルスレッド数を指定します。

表データの検索結果を保持するバッファのサイズを指定します。

(3)　SQL記述ファイルを作成する

SQL記述ファイルを作成して，出力したいデータを検索するSQL文を指定します。

SQL記述ファイルの指定例

SELECT * FROM "TABLE01"
     WHERE "C1" < 10000

(4)　adbexportコマンドを実行する

adbexport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -z /home/adbmanager/exp_file/env01.txt   ...3
          -q /home/adbmanager/exp_file/sel01.txt   ...4
          /home/adbmanager/exp_file/expf01.txt     ...5

［説明］

adbexportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(2)　エクスポートオプションファイルを作成する」で作成したエクスポートオプションファイルの絶対パス名を指定します。

「(3)　SQL記述ファイルを作成する」で作成したSQL記述ファイルの絶対パス名を指定します。

「(1)　出力データパスファイルを作成する」で作成した出力データパスファイルの絶対パス名を指定します。

14.3.4　特定のチャンクIDのデータをGZIP形式で圧縮したファイルにエクスポートする場合

次に示す条件で，表データをエクスポートします。

マルチチャンク表TABLE01の，チャンクIDが10のデータをエクスポートする

エクスポート結果を，4つの出力データファイルに出力する

出力データファイルをGZIP形式で圧縮する

このとき，次に示す手順でadbexportコマンドを実行します。

手順

出力データパスファイルを作成する

エクスポートオプションファイルを作成する

adbexportコマンドを実行する

各手順の例を以降で説明します。

(1)　出力データパスファイルを作成する

出力データパスファイルを作成して，すべての出力データファイルのパスを指定します。

出力データパスファイルの指定例

/mnt/diska/wwwww/exp1.csv.gz
/mnt/diskb/xxxxx/exp2.csv.gz
/mnt/diskc/yyyyy/exp3.csv.gz
/mnt/diskd/zzzzz/exp4.csv.gz

［説明］

表データをGZIP形式で圧縮したファイルにエクスポートする場合，出力データファイルの絶対パスの末尾に，拡張子「.gz」を指定することを推奨します。末尾に拡張子「.gz」を指定することで，エクスポートされたファイルがGZIP形式のファイルであると判別しやすくなります。

(2)　エクスポートオプションファイルを作成する

エクスポートオプションファイルを作成して，エクスポートオプションを指定します。

エクスポートオプションファイルの指定例

set adb_export_rthd_num = 3           ...1
set adb_export_scan_buff_size = 64    ...2

［説明］

adbexportコマンド実行時に使用する処理リアルスレッド数を指定します。

表データの検索結果を保持するバッファのサイズを指定します。

(3)　adbexportコマンドを実行する

adbexport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -z /home/adbmanager/exp_file/env01.txt   ...3
          -n TABLE01                               ...4
          -c 10                                    ...5
          --compress GZIP                          ...6
          /home/adbmanager/exp_file/expf01.txt     ...7

［説明］

adbexportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(2)　エクスポートオプションファイルを作成する」で作成したエクスポートオプションファイルの絶対パス名を指定します。

処理対象表を指定します。

チャンクIDを指定します。

出力データファイルを圧縮してGZIP形式のファイルにするために指定します。

「(1)　出力データパスファイルを作成する」で作成した出力データパスファイルの絶対パス名を指定します。

14.4　リターンコード

adbexportコマンドのリターンコードを次の表に示します。

表14‒4　adbexportコマンドのリターンコード

リターンコード

意味

0

adbexportコマンドが正常に終了しました。

4

adbexportコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbexportコマンドの指定に誤りがあり，adbexportコマンドが実行されませんでした。

adbexportコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

14.5　出力データファイルの形式（CSV形式）

ここでは，出力データファイルの形式について説明します。

出力データファイルの圧縮形式については，「14.6　出力データファイルの圧縮形式」を参照してください。

14.5.1　CSV形式の仕様

CSV形式とは，フィールドデータを区切り文字で区切って並べたデータ形式のことです。CSV形式の例を次の図に示します。

図14‒3　CSV形式の例

［説明］

表の1行のデータが，出力データファイルの1行に対応します。

表の列構成の順序と，出力データファイルに出力されるフィールドデータの順序は同じになります。

文字データ，日時データおよびバイナリデータは，囲み文字で囲んで出力されます。囲み文字はadbexportコマンドの-kオプションで指定できます。

なお，-kオプションにnoneを指定した場合は，囲み文字は出力されません。

フィールドデータとフィールドデータの間には，区切り文字が出力されます。区切り文字はadbexportコマンドの-sオプションで指定できます。

14.5.2　出力データの出力規則

出力データファイルは，表に格納されているデータの文字コードと同じコードで出力されます。

表の1行のデータが，ファイルの1行に出力されます。

1行の終わりには改行文字が出力されます。改行コードは，X'0A'（LF）です。

出力データの1行の最大長は512メガバイト（536,870,912バイト）です。512メガバイトを超えると，ファイル出力エラーになります。

文字データ，日時データおよびバイナリデータは，囲み文字で囲んで出力されます。

フィールドデータとフィールドデータの間には区切り文字が出力されます。

--with-column-nameオプションを指定した場合，ファイルの1行目に列名が出力されます。各列名の出力形式はVARCHAR型の列のデータと同じです。

ナル値の場合，データが出力されません（空文字列になります）。例えば，表の1行のデータが，「AAA,ナル値,BBB」の場合，出力データファイルには「AAA,,BBB」と出力されます。

14.5.3　フィールドデータの出力形式

フィールドデータのデータ型ごとの出力形式を次の表に示します。

なお，どのデータ型の場合も，ナル値はデータが出力されません。また，数データの場合，"＋"記号は出力されません。

表14‒5　フィールドデータの出力形式

項番

データ型

フィールドデータの出力形式

1

数データ

INTEGER

出力形式

整数が出力されます。

正の数の場合，"＋"符号は出力されません。負の値の場合は，"−"符号が出力されます。

ナル値の場合はデータが出力されません。

出力例

+1234 → 1234

0 → 0

-1234 → -1234

2

BIGINT

3

SMALLINT

4

DECIMAL

出力形式

「整数〔．小数〕」の形式で出力されます。

整数部：実際の桁数分が出力されます。ただし，位取りと精度が等しい場合は，0が1つ出力されます。

小数点以下：位取りが0の場合は，小数点および小数点以下の数字は出力されません。位取りが1以上の場合，小数部には実際の桁数分が出力されます。ただし，小数部がすべて0のときは，0が1つだけ出力されます。

正の数の場合，"＋"符号は出力されません。負の値の場合は，"−"符号が出力されます。

ナル値の場合はデータが出力されません。

出力例

+123.45 → 123.45

-.123 → -0.123

+123. → 123

+123.45000 → 123.45

+123.00000 → 123.0

5

NUMERIC

6

DOUBLE PRECISION

出力形式

「仮数E指数」の形式で出力されます。

仮数部：整数部，小数部ともに，実際の桁数分が出力されます。ただし，小数部がすべて0の場合は，小数点以下に0が1つだけ出力されます。

指数部：実際の桁数分が出力されます。

正の数の場合，"＋"符号は出力されません。負の値の場合は，"−"符号が出力されます。指数部の"＋"符号も出力されません。

ナル値の場合はデータが出力されません。

出力例

+1.1234567890000000E-09 → 1.123456789E-9

+0.0000000000000000E+00 → 0.0E0

-0.1230000000000000E-123 → -0.123E-123

7

FLOAT

8

文字データ

CHAR

出力形式

前後を囲み文字で囲まれた文字が出力されます。

データの右側のスペースは削除されます。ただし，データがすべてスペースの場合は，スペース1個が出力されます。

ナル値の場合はデータが出力されません。

出力例

ABCD → "ABCD"

この例では，囲み文字を二重引用符（"）としています。

9

VARCHAR

出力形式

前後を囲み文字で囲まれた文字が出力されます。

実データ長分のデータが出力されます。

長さが0バイトのデータの場合，囲み文字だけが出力されます。

ナル値の場合はデータが出力されません。

出力例

ABCD → "ABCD"

（長さが0バイトのデータ） → ""

この例では，囲み文字を二重引用符（"）としています。

10

日時データ

DATE

出力形式

前後を囲み文字で囲まれた日付が出力されます。

日付部分はYYYY-MM-DDの形式で出力されます。

年（YYYY），月（MM），日（DD）がハイフンで結ばれます。

ナル値の場合はデータが出力されません。

出力例

2013-06-10 → "2013-06-10"

この例では，囲み文字を二重引用符（"）としています。

11

TIME

出力形式

前後を囲み文字で囲まれた日時が出力されます。

時刻はhh:mm:ss.nn....nの形式で出力されます。

時（hh），分（mm），秒（ss）がコロン（ : ）で結ばれます。小数秒精度が1以上の場合，「.nn....n」の部分に小数秒が出力されます。

小数秒部分の後方の0は削除されます。小数秒がすべて0の場合，0が1つだけ出力されます。

ナル値の場合はデータが出力されません。

出力例

11:03:58 → "11:03:58"

15:36:08.580 → "15:36:08.58"

08:03:44.000000 → "08:03:44.0"

この例では，囲み文字を二重引用符（"）としています。

12

TIMESTAMP

出力形式

前後を囲み文字で囲まれた日時が出力されます。

日時はYYYY-MM-DD△hh:mm:ss.nn....nの形式で出力されます。

年（YYYY），月（MM），日（DD）がハイフンで結ばれます。半角空白（△）のあと，さらに時（hh），分（mm），秒（ss）がコロン（ : ）で結ばれます。小数秒精度が1以上の場合，「.nn....n」の部分に小数秒が出力されます。

小数秒部分の後方の0は削除されます。小数秒がすべて0の場合，0が1つだけ出力されます。

ナル値の場合はデータが出力されません。

出力例

2013-06-10 11:03:58 → "2013-06-10 11:03:58"

2014-07-15 10:11:28.330 → "2014-07-15 10:11:28.33"

2014-07-08 07:12:44.000 → "2014-07-08 07:12:44.0"

この例では，囲み文字を二重引用符（"）としています。

13

バイナリデータ

BINARY

出力形式

前後を囲み文字で囲まれた，16進形式のバイナリデータが出力されます。

ナル値の場合はデータが出力されません。

出力例

12345678 → "12345678"

90ABCDEF → "90ABCDEF"

この例では，囲み文字を二重引用符（"）としています。

14

VARBINARY

出力形式

前後を囲み文字で囲まれた，16進形式のバイナリデータが出力されます。

長さが0バイトのデータの場合，囲み文字だけが出力されます。

ナル値の場合はデータが出力されません。

出力例

12345678 → "12345678"

90ABCDEF → "90ABCDEF"

（長さが0バイトのデータ） → ""

この例では，囲み文字を二重引用符（"）としています。

15

配列データ

ARRAY

出力形式

{配列要素,配列要素,…}の形式で出力されます。

配列要素：要素データ型に該当するデータ型の出力形式に従います。

{}の前後が囲み文字で囲まれます。

配列要素の囲み文字の有無は，要素データ型に該当するデータ型の出力形式に従います。

配列要素の囲み文字は，二重引用符（"）です。

列値がナル値の場合はデータが出力されません。配列要素の値がナル値の場合は，その配列要素にはNULLが出力されます。

空の配列データの場合は，{}だけが出力されます。

出力例

要素データ型がCHAR型の場合

AAA,BBB,CCC → "{""AAA"",""BBB"",""CCC""}"

要素データ型がINTEGER型の場合

0,100,200 → "{0,100,200}"

配列要素の値にナル値が含まれる場合

"{NULL,""AAA"",""BBB""}"

1個目の配列要素がナル値の場合の例です。

この例では，配列データのフィールドデータの囲み文字を二重引用符（"）としています（下線部分が該当します）。

メモ

日時データを「YYYY/MM/DD」形式で出力したい場合は，SQL記述ファイルに記述するSELECT文の選択式に，スカラ関数CONVERTを指定してください。スカラ関数CONVERTの詳細については，マニュアルHADB　SQLリファレンスのスカラ関数を参照してください。

（例1）C1列のDATE型の日付データを「YYYY/MM/DD」形式で出力したい場合

SELECT CONVERT("C1",CHAR(10),'YYYY/MM/DD'), "C2" FROM "T1"

（例2）C1列のTIMESTAMP型の時刻印データを「YYYY/MM/DD hh:mm:ss」形式で出力したい場合

SELECT CONVERT("C1",CHAR(19),'YYYY/MM/DD HH:MI:SS'), "C2" FROM "T1"

前後を囲み文字で囲まれた2進形式のバイナリデータを出力したい場合は，SQL記述ファイルに記述するSELECT文の選択式に，スカラ関数BINを指定してください。スカラ関数BINの詳細については，マニュアルHADB　SQLリファレンスのスカラ関数を参照してください。

（例）C1列のバイナリデータを2進形式で出力したい場合

SELECT BIN("C1") FROM "T1"

14.6　出力データファイルの圧縮形式

出力データファイルの圧縮形式について説明します。

adbexportコマンドは，次に示す圧縮形式で出力データファイル（CSV形式）を圧縮して，表データをエクスポートできます。

■出力データファイルの圧縮形式

GZIP形式

adbexportコマンドに--compress GZIPオプションを指定して実行すると，GZIP形式で圧縮された出力データファイル（CSV形式）を取得できます。

メモ

出力データファイルの形式（CSV形式）については，「14.5　出力データファイルの形式（CSV形式）」を参照してください。

GZIP形式で圧縮された出力データファイル（CSV形式）のデータは，ADB_CSVREAD関数で検索できます。ADB_CSVREAD関数については，マニュアルHADB　SQLリファレンスの構成要素のシステム定義関数のADB_CSVREAD関数を参照してください。

また，GZIP形式で圧縮された出力データファイル（CSV形式）のデータは，adbimportコマンドでインポートできます。GZIP形式で圧縮された出力データファイル（CSV形式）は，GZIP形式で圧縮された入力データファイル（CSV形式）として使用できます。入力データファイルの圧縮形式については，「17.7　入力データファイルの圧縮形式」を参照してください。

メモ

GZIP形式で圧縮された出力データファイルは，次に示すOSのコマンドで伸長できます。

gzip -dコマンド

gunzipコマンド

zcatコマンド

14.7　adbexportコマンドが異常終了したときの対処方法

adbexportコマンドが異常終了した場合は，次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されているときは，コマンドのオプションや，エクスポートオプションの指定に誤りがあります。コマンドのオプションまたはエクスポートオプションを修正したあとに，adbexportコマンドを再実行してください。

上記のメッセージが出力されていない場合は，異常終了した原因を取り除いたあとでadbexportコマンドを再実行してください。

なお，adbexportコマンドは表およびインデクスの内容を変更しません。そのため，adbexportコマンドが異常終了しても，表およびインデクスを回復させる必要はありません。

14.8　注意事項

adbexportコマンドの実行中は，出力データファイルに対して，ほかのアプリケーションによる読み込みや書き込みを行わないでください。

adbexportコマンドでエクスポートできる表を次に示します。

EXPORT TABLE権限を持っている実表

EXPORT TABLE権限を持っているビュー表

ディクショナリ表

システム表

実行するSQL文の検索性能を向上する方法については，マニュアルHADB　システム構築・運用ガイドのチューニングのコマンドの実行時間の短縮に関するチューニングのadbexportコマンドの実行時間の短縮を参照してください。

なお，-nオプションを指定した場合，表データを検索するSQL文は「SELECT * FROM "スキーマ名"."表識別子"」となります。

adbexportコマンドのオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

adbexportコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

データエクスポート処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbexportコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のデータエクスポート処理は中断されません（処理が続行されます）。データエクスポート処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

出力データファイルを複数指定した場合，ファイルごとに出力されるデータ件数にばらつきが出ます。その影響で，データ件数が0件のファイルが作成されることがあります。

ORDER BY句を指定した検索の出力結果は次のとおりです。

1個の出力データファイルに出力する場合

ORDER BY句の指定どおりの順序で，出力データファイルにデータが出力されます。

2個以上の出力データファイルに出力する場合

ORDER BY句の指定どおりの順序でデータが抽出されますが，出力データファイルには何件かずつまとめて出力されます。各ファイル内でのデータの並びは，ORDER BY句の指定どおりの順序となります。

なお，検索結果の件数が少ないときなどは，1つの出力データファイルにデータが偏って出力されたり，レコードが出力されない出力データファイルができたりすることがあります。

（例）

実表T1に出力対象のデータが10件あり，列C1に1〜10の値が格納されています。adbexportコマンドを使って，列C1のデータを昇順で検索した結果を，3個の出力データファイルに出力します。

adbexportコマンドのオプションに指定する次のファイル名の絶対パスが重複しないようにしてください。該当するファイルを次に示します。

エクスポートオプションファイル（-zオプションで指定）

出力データパスファイル（コマンドオプションで指定）

出力データファイル（出力データパスファイル中に指定）

また，上記のファイルは，adbexportコマンド以外のプログラムが使用しているファイル名とも重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。

コマンドまたはAPの実行中にadbexportコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbexportコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

adbexportコマンドの-kオプションにnoneを指定すると，囲み文字なしで出力されます。長さが0バイトのデータの場合，データが出力されません。そのため，ナル値と区別できなくなります。

adbexportコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbexportコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表14‒6　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

エクスポートオプションファイル

コマンドの実行ユーザ

読み取り権限

SQL記述ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

出力データパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

出力データパスファイルに指定する出力データファイルの格納場所※2のディレクトリ

HADBサーバプロセスの実行ユーザ

書き込み権限

実行権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

adbexportコマンドの実行時，権限に664を設定した出力データファイルが作成されます。

15　adbgetcst（コスト情報の収集）

この章では，adbgetcstコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を，「インデクス」はB-treeインデクスおよびテキストインデクスを意味しています。

15.1　機能

adbgetcstコマンドの機能，および使用するスレッドについて説明します。

adbgetcstコマンドは，コマンド実行時にHADBサーバに接続します。

15.1.1　コスト情報の収集

HADBサーバが表の検索処理を最適化するために使用する情報をコスト情報といいます。adbgetcstコマンドを実行すると，表およびインデクスのコスト情報をシステム表（実表）に格納できます。コスト情報がすでにシステム表（実表）に格納されている場合は，格納されているコスト情報を更新します。これらの処理をコスト情報収集処理といいます。

コスト情報収集処理の概要を次の図に示します。

図15‒1　コスト情報収集処理の概要

［説明］

adbgetcstコマンドを実行すると，表およびインデクスからコスト情報を収集して，システム表（実表）に格納します。表およびインデクスのコスト情報がすでにシステム表（実表）に格納されている場合は，格納されているコスト情報を更新します。

なお，アーカイブ状態のチャンクに関するコスト情報は，コスト情報収集処理の対象外です。

■コスト情報の種類

adbgetcstコマンドで収集するコスト情報の種類を次に示します。

処理対象表に格納されている総行数

ローストア表の場合，この情報の収集時にB-treeインデクスが使用されます。このため，コスト情報を収集するローストア表に対しては，1つ以上の列にB-treeインデクスを定義することを推奨します。

処理対象表の各列に格納されているデータの最大値および最小値

この情報の収集時，レンジインデクスまたはB-treeインデクスが使用されます。

処理対象表に格納されているデータの特徴（重複度や出現頻度など）

コスト情報収集処理で使用するファイルについて説明します。

コスト情報収集オプションファイル

adbgetcstコマンドの実行環境を設定するオプションを指定したファイルです。

なお，次の処理のあとには，adbgetcstコマンドを実行してコスト情報をシステム表（実表）に格納することを推奨します。

adbimportコマンドを実行して表にデータを格納したあと

adbidxrebuildコマンドを実行してインデクスを再作成したあと

INSERT文を使用して大量のデータを追加したあと

UPDATE文を使用して大量のデータを更新したあと

DELETE文を使用して大量のデータを削除したあと

複数回に分けて少量のデータを追加，更新または削除したあと

15.1.2　コスト情報の削除

-dオプションを指定してadbgetcstコマンドを実行すると，システム表（実表）に格納されているコスト情報を削除できます。

コスト情報の削除について次の図に示します。

図15‒2　コスト情報の削除

15.1.3　adbgetcstコマンドが使用するスレッドの関係

adbgetcstコマンドは，次の処理で処理リアルスレッドを使用します。

表データの検索（コスト情報の収集）

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，コスト情報収集オプションadb_getcst_rthd_numの指定値またはデフォルト値となります。コスト情報収集オプションadb_getcst_rthd_numのデフォルト値については，「15.2.2　コスト情報収集オプションの形式」の「(2)　指定形式の説明」にある，コスト情報収集オプションadb_getcst_rthd_numを参照してください。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1と処理2は同時に実行されます。

adbgetcstコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図15‒3　adbgetcstコマンドが処理リアルスレッドを使用する処理

15.2　adbgetcstコマンドの指定形式

adbgetcstコマンドの指定形式，およびコスト情報収集オプションの形式について説明します。

adbgetcstコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

15.2.1　指定形式およびオプションの説明

(1)　指定形式

adbgetcst
    -u 認可識別子
  〔-p パスワード〕
  〔-t 表名〕
  〔-d〕
  〔-z コスト情報収集オプションファイル名〕
  〔-g コスト情報収集処理の経過メッセージの出力間隔〕

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbgetcstコマンドを実行するHADBユーザの認可識別子を指定します。adbgetcstコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するGET COSTINFO権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbgetcstコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-t 表名

〜〈文字列〉

コスト情報を収集する表の表名を指定します。-dオプションを指定した場合は，コスト情報をシステム表（実表）から削除する表の表名を指定します。

このオプションを省略した場合，-uオプションに指定した認可識別子のスキーマ内に定義されている全表が，adbgetcstコマンドの処理対象になります。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

GET COSTINFO権限を持っている表を指定できます。

ビュー表は指定できません。

●-d

システム表（実表）からコスト情報を削除する場合に指定します。

なお，削除対象のコスト情報がシステム表（実表）にない場合は，そのコスト情報の削除処理をスキップします。

●-z コスト情報収集オプションファイル名

〜〈OSパス名〉((2〜510バイト))

コスト情報収集オプションを指定したコスト情報収集オプションファイルの絶対パス名を指定します。このオプションを省略すると，コスト情報収集オプションファイルが指定されないため，すべてのコスト情報収集オプションにデフォルト値が仮定されます。

コスト情報収集オプションについては，「15.2.2　コスト情報収集オプションの形式」を参照してください。

●-g コスト情報収集処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

コスト情報収集処理の経過メッセージの出力間隔を指定します。例えば，このオプションに2を指定すると，コスト情報収集処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。

このオプションを指定して-tオプションを省略した場合，経過メッセージは処理対象表ごとに出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

-dオプションを指定した場合，このオプションは無視されます。

15.2.2　コスト情報収集オプションの形式

(1)　指定形式

〔set adb_getcst_rthd_num = adbgetcstコマンドが使用する処理リアルスレッド数〕
〔set adb_getcst_collect_time = コスト情報を収集する時間〕

上記のコスト情報収集オプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_getcst_rthd_num = adbgetcstコマンドが使用する処理リアルスレッド数

〜〈整数〉((2〜4,096))

adbgetcstコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbgetcstコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbgetcstコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbgetcstコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「15.1.3　adbgetcstコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbgetcstコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表15‒1　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0または1を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに2以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに2以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbgetcstコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_getcst_collect_time = コスト情報を収集する時間

〜〈整数〉((0，5～1,440))《10》（単位：分）

処理対象表のコスト情報を収集する時間を，分単位で指定します。

このオプションを指定すると，指定した時間内で収集できたコスト情報だけがシステム表に格納されます。コスト情報の収集時間に関係なく，処理対象表のすべてのコスト情報を収集したい場合は，このオプションに0を指定してください。

adbgetcstコマンドの-tオプションを省略した場合（スキーマ内の全表のコスト情報を収集する場合）は，-uオプションで指定した認可識別子のスキーマ内の各表に，このオプションの指定値が適用されます。このオプションに指定した時間内に処理対象表のコスト情報の収集が終わらないときは，その時点までに収集したコスト情報がシステム表に格納され，次の処理対象表のコスト情報の収集が始まります。

このオプションの指定値と，システム表に格納されるコスト情報の関係を次の表に示します。

表15‒2　オプションの指定値とシステム表に格納されるコスト情報の関係

項番

このオプションの指定値

処理対象表のコスト情報の収集に掛かる時間

システム表に格納されるコスト情報

1

省略，または5以上の値を指定した場合

このオプションに指定した時間（または省略したときの値）よりも長い

このオプションに指定した時間（または省略したときの値）までに収集したコスト情報※

コスト情報の収集処理中（KFAA80235-Iメッセージが出力されてからKFAA80236-Iメッセージが出力されるまでの間）に，このオプションに指定した時間が経過すると，KFAA80237-Iメッセージが出力されます。

スキーマ内の全表のコスト情報を収集する場合，このオプションに指定した時間が経過すると，次の処理対象表のコスト情報の収集が始まります。このとき，KFAA80237-Iメッセージが出力されます。

2

このオプションに指定した時間（または省略したときの値）と同じ，または短い

処理対象表のすべてのコスト情報

スキーマ内の全表のコスト情報を収集する場合，処理対象表のコスト情報の収集が完了すると，次の処理対象表のコスト情報の収集が始まります。

3

0を指定した場合

－

処理対象表のすべてのコスト情報

スキーマ内の全表のコスト情報を収集する場合，処理対象表のコスト情報の収集が完了すると，次の処理対象表のコスト情報の収集が始まります。

（凡例）

－：該当しません。コスト情報の収集時間に関係なく，処理対象表のすべてのコスト情報が収集されます。

注※

処理対象表のすべてのコスト情報を収集した場合と比較して，SQL文の最適化（アクセスパスの選択の結果）が異なることがあります。

15.3　使用例

adbgetcstコマンドを実行してコスト情報を収集または削除する方法を，例題形式で説明します。

実行中にadbgetcstコマンドが異常終了した場合は，「15.5　adbgetcstコマンドが異常終了したときの対処方法」を参照して対処してください。

15.3.1　特定の表のコスト情報を収集する場合

表（TABLE01）のコスト情報を収集します。コスト情報収集オプションファイルの絶対パス名は，/home/adbmanager/getcst_file/env01.txtとします。

手順

コスト情報収集オプションファイルを作成する

adbgetcstコマンドを実行する

各手順の例を以降で説明します。

(1)　コスト情報収集オプションファイルを作成する

コスト情報収集オプションファイルを作成して，adbgetcstコマンド実行時に使用する処理リアルスレッド数を指定します。

コスト情報収集オプションファイルの指定例

set adb_getcst_rthd_num = 10

(2)　adbgetcstコマンドを実行する

adbgetcst -u ADBUSER01                                ...1
          -p '#HelloHADB_01'                          ...2
          -t TABLE01                                  ...3
          -z /home/adbmanager/getcst_file/env01.txt   ...4

［説明］

adbgetcstコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

コスト情報を収集する表の表名を指定します。

「(1)　コスト情報収集オプションファイルを作成する」で作成したコスト情報収集オプションファイルの絶対パス名を指定します。

15.3.2　すべての表のコスト情報を収集する場合

スキーマ（ADBUSER01）内の全表のコスト情報を収集します。コスト情報収集オプションファイルの絶対パス名は，/home/adbmanager/getcst_file/env01.txtとします。

手順

コスト情報収集オプションファイルを作成する

adbgetcstコマンドを実行する

各手順の例を以降で説明します。

(1)　コスト情報収集オプションファイルを作成する

コスト情報収集オプションファイルを作成して，adbgetcstコマンド実行時に使用する処理リアルスレッド数を指定します。

コスト情報収集オプションファイルの指定例

set adb_getcst_rthd_num = 10

(2)　adbgetcstコマンドを実行する

adbgetcst -u ADBUSER01                                ...1
          -p '#HelloHADB_01'                          ...2
          -z /home/adbmanager/getcst_file/env01.txt   ...3

［説明］

adbgetcstコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　コスト情報収集オプションファイルを作成する」で作成したコスト情報収集オプションファイルの絶対パス名を指定します。

15.3.3　特定の表のコスト情報を削除する場合

表（TABLE01）のコスト情報を削除します。

(1)　adbgetcstコマンドを実行する

adbgetcst -u ADBUSER01                ...1
          -p '#HelloHADB_01'          ...2
          -t TABLE01                  ...3
          -d                          ...4

［説明］

adbgetcstコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

コスト情報をシステム表（実表）から削除する表の表名を指定します。

コスト情報の削除を指定します。

15.3.4　すべての表のコスト情報を削除する場合

スキーマ（ADBUSER01）内の全表のコスト情報を削除します。

(1)　adbgetcstコマンドを実行する

adbgetcst -u ADBUSER01                ...1
          -p '#HelloHADB_01'          ...2
          -d                          ...3

［説明］

adbgetcstコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

コスト情報の削除を指定します。

15.4　リターンコード

adbgetcstコマンドのリターンコードを次の表に示します。

表15‒3　adbgetcstコマンドのリターンコード

リターンコード

意味

0

adbgetcstコマンドが正常に終了しました。

4

adbgetcstコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

なお，KFAA50291-Wメッセージが出力された場合，次に示す理由でコスト情報の収集処理をスキップした表があります。

処理対象表が更新不可状態になっている

処理対象表に定義されているB-treeインデクス，テキストインデクス，またはレンジインデクスが未完状態になっている

処理対象表に対して実行したadbimportコマンドまたはadbidxrebuildコマンドが中断している

この場合，表の更新不可状態または該当するインデクスの未完状態を解除するか，中断したコマンドを再実行したあとに，コスト情報を収集してください。

表の更新不可状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドの実表が更新不可状態になった場合を参照してください。

B-treeインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのB-treeインデクスが未完状態になったときの対処方法を参照してください。

テキストインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのテキストインデクスが未完状態になったときの対処方法を参照してください。

レンジインデクスの未完状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのレンジインデクスが未完状態になったときの対処方法を参照してください。

中断したコマンドを確認する場合は，adbdbstatusコマンドの-cオプションにtable，-nオプションに処理対象表名を指定して，表のサマリ情報を出力してください。出力結果の「Rerun_command」列に中断したコマンド名が出力されています。adbdbstatusコマンドについては，「13.　adbdbstatus（データベースの状態解析）」を参照してください。

8

次のどちらかのエラーが発生しました。

adbgetcstコマンドの指定に誤りがあり，adbgetcstコマンドが実行されませんでした。

adbgetcstコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

15.5　adbgetcstコマンドが異常終了したときの対処方法

adbgetcstコマンドが異常終了したときの対処方法について説明します。

なお，adbgetcstコマンドは表およびインデクスの内容を変更しません。そのため，adbgetcstコマンドが異常終了しても，表およびインデクスを回復させる必要はありません。

15.5.1　adbgetcstコマンドが異常終了したときに確認すること

次の手順に従って，必要な対処を確認してください。

コマンドの指定に誤りがないかどうかを確認する

次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されている場合は，コマンドのオプションや，コスト情報収集オプションの指定に誤りがあります。コマンドのオプションまたはコスト情報収集オプションを修正したあとに，adbgetcstコマンドを再実行してください。

これらのメッセージが出力されていない場合は，次の手順に進んでください。

KFAA80204-Iメッセージが出力されているかどうかを確認する

KFAA80204-Iメッセージがリターンコード0で出力されている場合は，コスト情報の収集または削除は完了しています。対処は不要です。

KFAA80204-Iメッセージがリターンコード0で出力されていない場合は，異常終了した処理に応じた対処が必要です。異常終了した処理と対処方法の関係を次の表に示します。

表15‒4　実行した処理と対処方法の関係

項番

異常終了した処理

処理の範囲

対処方法

1

コスト情報の収集

特定の表

「15.5.2　特定の表のコスト情報を収集中に異常終了した場合」を参照してください。

2

すべての表

「15.5.3　すべての表のコスト情報を収集中に異常終了した場合」を参照してください。

3

コスト情報の削除

特定の表

「15.5.4　特定の表のコスト情報を削除中に異常終了した場合」を参照してください。

4

すべての表

「15.5.5　すべての表のコスト情報を削除中に異常終了した場合」を参照してください。

15.5.2　特定の表のコスト情報を収集中に異常終了した場合

-tオプションを指定して特定の表のコスト情報を収集していた場合の対処手順を次に示します。

KFAA80285-Iメッセージが出力されているかどうかを確認する

KFAA80285-Iメッセージ（表のコスト情報が収集された旨のメッセージ）が出力されている場合は，コスト情報は収集されています。対処は不要です。

KFAA80285-Iメッセージが出力されていない場合は，次の手順に進んでください。

コスト情報の収集日時を確認する

システム表を検索して，-tオプションに指定した表，およびその表に定義されているインデクスのコスト情報の収集日時を確認してください。

コスト情報を収集している全表の表名，およびコスト情報の収集日時を調べるSELECT文

SELECT "TABLE_SCHEMA","TABLE_NAME","COLLECT_TIME"
     FROM "MASTER"."STATUS_TABLES"

コスト情報を収集している全インデクスのインデクス名，およびコスト情報の収集日時を調べるSELECT文

SELECT "TABLE_SCHEMA","INDEX_NAME","COLLECT_TIME"
     FROM "MASTER"."STATUS_INDEXES"

重要

システム表を検索したあとはすぐにCOMMIT文を発行してください。ただし，システム表を検索したあとで，adbsqlコマンドを終了する場合は，COMMIT文の実行は不要です。

表およびインデクスのコスト情報の収集日時がadbgetcstコマンドの実行後であれば，コスト情報は収集されています。対処は不要です。

コスト情報の収集日時がadbgetcstコマンドの実行前の場合，またはシステム表（実表）にコスト情報が格納されていない場合は，次の手順に進んでください。

出力されているメッセージを確認する

メッセージの対処に従って，障害の原因を取り除いてください。

adbgetcstコマンドを再実行する

adbgetcstコマンドのオプションは変更しないで再実行してください。

15.5.3　すべての表のコスト情報を収集中に異常終了した場合

-tオプションを省略してスキーマ内の全表のコスト情報を収集していた場合の対処手順を次に示します。

KFAA80285-Iメッセージが出力されているかどうかを確認する

KFAA80285-Iメッセージ（表のコスト情報が収集された旨のメッセージ）が出力されている場合は，コスト情報は収集されています。対処は不要です。

なお，KFAA80285-Iメッセージは処理対象表ごとに出力されます。そのため，スキーマ内のすべての表に対してKFAA80285-Iメッセージが出力されているかどうかを確認してください。KFAA80285-Iメッセージが出力されていない表がある場合は，次の手順に進んでください。

コスト情報の収集日時を確認する

システム表を検索して，スキーマ内のすべての表，およびそれらの表に定義されているインデクスのコスト情報の収集日時を確認してください。

コスト情報を収集している全表の表名，およびコスト情報の収集日時を調べるSELECT文

SELECT "TABLE_SCHEMA","TABLE_NAME","COLLECT_TIME"
     FROM "MASTER"."STATUS_TABLES"

コスト情報を収集している全インデクスのインデクス名，およびコスト情報の収集日時を調べるSELECT文

SELECT "TABLE_SCHEMA","INDEX_NAME","COLLECT_TIME"
     FROM "MASTER"."STATUS_INDEXES"

重要

システム表を検索したあとはすぐにCOMMIT文を発行してください。ただし，システム表を検索したあとで，adbsqlコマンドを終了する場合は，COMMIT文の実行は不要です。

表およびインデクスのコスト情報の収集日時がadbgetcstコマンドの実行後であれば，コスト情報は収集されています。対処は不要です。

コスト情報の収集日時がadbgetcstコマンドの実行前の場合，またはシステム表（実表）にコスト情報が格納されていない場合は，次の手順に進んでください。

出力されているメッセージを確認する

メッセージの対処に従って，障害の原因を取り除いてください。

adbgetcstコマンドを再実行する

コスト情報が収集されていない表（定義されているインデクスのコスト情報が収集されていない表も含む）の表名を-tオプションに指定して，adbgetcstコマンドを再実行します。-tオプションには表名を1つしか指定できないため，コスト情報が収集されていない表が複数ある場合は，該当する表の数だけadbgetcstコマンドを実行してください。

スキーマ内の表のコスト情報が1つも収集されていない場合は，-tオプションを省略して，adbgetcstコマンドを再実行してください。

15.5.4　特定の表のコスト情報を削除中に異常終了した場合

-tオプションを指定して特定の表のコスト情報を削除していた場合の対処手順を次に示します。

KFAA80287-Iメッセージが出力されているかどうかを確認する

KFAA80287-Iメッセージ（表のコスト情報が削除された旨のメッセージ）が出力されている場合は，コスト情報は削除されています。対処は不要です。

KFAA80287-Iメッセージが出力されていない場合は，次の手順に進んでください。

出力されているメッセージを確認する

メッセージの対処に従って，障害の原因を取り除いてください。

adbgetcstコマンドを再実行する

adbgetcstコマンドのオプションは変更しないで再実行してください。

15.5.5　すべての表のコスト情報を削除中に異常終了した場合

-tオプションを省略してスキーマ内の全表のコスト情報を削除していた場合の対処手順を次に示します。

KFAA80287-Iメッセージが出力されているかどうかを確認する

KFAA80287-Iメッセージ（表のコスト情報が削除された旨のメッセージ）は，コスト情報が削除された表ごとに出力されます。そのため，スキーマ内のすべての表に対してKFAA80287-Iメッセージが出力されているかどうかを確認してください。すべての表に対してKFAA80287-Iメッセージが出力されている場合は，コスト情報は削除されています。対処は不要です。

KFAA80287-Iメッセージが出力されていない表がある場合は，次の手順に進んでください。

出力されているメッセージを確認する

メッセージの対処に従って，障害の原因を取り除いてください。

adbgetcstコマンドを再実行する

adbgetcstコマンドのオプションは変更しないで再実行してください。

15.6　注意事項

バージョン04-03より前のHADBサーバで収集したコスト情報は，バージョン04-03以降のHADBサーバでは使用できません。そのため，04-03より前のバージョンから，04-03以降のバージョンにHADBサーバをバージョンアップした場合は，adbgetcstコマンドでコスト情報を収集し直してください。

コマンドまたはAPの実行中にadbgetcstコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbgetcstコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

コスト情報を収集する場合，次のときは該当する表のコスト情報収集処理がスキップされます（KFAA50291-Wメッセージが出力されます）。

処理対象表が更新不可状態のとき

処理対象表に定義されているB-treeインデクス，テキストインデクス，またはレンジインデクスが未完状態のとき

処理対象表に対して実行したadbimportコマンドまたはadbidxrebuildコマンドが中断しているとき

コスト情報を削除する場合は，コスト情報をシステム表（実表）から削除する表，およびその表に定義されているB-treeインデクス，テキストインデクス，またはレンジインデクスの状態に関係なく，コスト情報を削除します。

コスト情報を収集する際，HADBサーバはSELECT文を使用して処理対象表を検索するため，非順序実行方式が適用される環境での実行を推奨します。非順序実行方式が適用される環境については，マニュアルHADB　システム構築・運用ガイドのデータベースの検索処理方式（非順序実行方式）を参照して確認してください。

コスト情報収集オプションファイル，およびその格納ディレクトリのパスは，adbgetcstコマンド以外のプログラムが使用しているファイルおよびディレクトリと重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定および相対パスの指定にも注意してください。

adbgetcstコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

コスト情報の収集および削除処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbgetcstコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のコスト情報の収集および削除処理は中断されません（処理が続行されます）。収集および削除処理が完了すると，KFAA81001-Iメッセージが出力されます。

このコマンドの実行時間を短縮したい場合は，マニュアルHADB　システム構築・運用ガイドのチューニングのコマンドの実行時間の短縮に関するチューニングのadbgetcstコマンドの実行時間の短縮を参照してください。

adbgetcstコマンドの実行時，次の表に示すファイルにアクセスします。adbgetcstコマンドを実行する前に，ファイルに次の表に示すパーミッションを設定してください。

表15‒5　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

コスト情報収集オプションファイル

コマンドの実行ユーザ

読み取り権限

注※

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

16　adbidxrebuild（インデクスの再作成）

この章では，adbidxrebuildコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

16.1　機能

この節では，adbidxrebuildコマンドの機能，および使用するスレッドについて説明します。

adbidxrebuildコマンドは，コマンド実行時にHADBサーバに接続します。

16.1.1　機能概要

adbidxrebuildコマンドを実行すると，表データが検索されてインデクス情報が生成されます。そのインデクス情報を基に，表に定義されたインデクスが再作成されます。この一連の処理を，インデクス再作成処理といいます。インデクス再作成処理の概要を次の図に示します。

図16‒1　インデクス再作成処理の概要

［説明］

adbidxrebuildコマンドを実行すると，表データが検索されてインデクス情報が生成されます。その情報を基に，表に定義されたインデクスが再作成されます。表にB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている場合，レンジインデクスが再作成されたあとで，B-treeインデクスおよびテキストインデクスが再作成されます。

adbidxrebuildコマンドを実行して未完状態のインデクスを再作成すると，インデクスの未完状態を解除できます。

各ファイルについて次に説明します。

インデクス識別子ファイル

adbidxrebuildコマンドで再作成するインデクス識別子を指定するファイルです。

インデクス再作成オプションファイル

adbidxrebuildコマンドの実行環境を設定するオプションを指定したファイルです。

作業用一時ファイル

インデクス再作成処理中に一時的に作成される作業用のファイルです。作成された作業用一時ファイルは，インデクス再作成処理が正常終了すると自動的に削除されます。

表にB-treeインデクスまたはテキストインデクスが定義されている場合，インデクスのデータを格納したインデクスレコードファイルや，インデクスレコードファイルのデータをソートしたソート結果用ファイルなどが作業用一時ファイルとして作成されます。

メモ

マルチチャンク表に対してadbidxrebuildコマンドを実行すると，チャンクごとにインデクス再作成処理が実行されます。インデクス再作成処理中のチャンクIDは，メッセージに表示されます。なお，アーカイブ状態のチャンクについては，インデクスが存在しないため，インデクス再作成処理は行われません。

図16‒2　マルチチャンク表のインデクス再作成処理

16.1.2　インデクス再作成の効果

adbidxrebuildコマンドを実行すると，次に示す状態のインデクスを再作成できます。

未完状態のインデクス

一意性制約違反状態のユニークインデクス

正常な状態のインデクス

それぞれのインデクスを再作成したときの効果について，次に示します。

(1)　未完状態のインデクスの再作成（インデクスの未完状態の解除）

行を格納するセグメントが割り当てられている状態の表に対してインデクスを定義すると，新しく定義したインデクスは未完状態になります。未完状態のインデクスを使用した検索はエラーとなります。

このとき，未完状態のインデクスが定義されている表に対してadbidxrebuildコマンドを実行すると，インデクスの未完状態が解除され，インデクスを使用して検索できるようになります。

図16‒3　未完状態のインデクスの再作成

行を格納するセグメントが割り当てられている状態については，マニュアルHADB　システム構築・運用ガイドのB-treeインデクスを定義する場合の注意点（B-treeインデクスの未完状態）を参照してください。

(2)　一意性制約違反状態のユニークインデクスの再作成（一意性制約違反状態の解除）

ユニークインデクスが一意性制約に違反している状態（一意性制約違反状態）の場合，一意性制約を満たしているときと比べて，検索効率が悪くなるおそれがあります。

この場合，一意性制約違反の原因となった行をSQL文で削除したあとで，adbidxrebuildコマンドでユニークインデクスを再作成すると，一意性制約違反状態を解除できます。

一意性制約違反の解除方法については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのB-treeインデクスに関するトラブルの一意性制約に違反した場合の対処方法（KFAA61205-Wメッセージが出力された場合）を参照してください。

(3)　正常な状態のインデクスの再作成

adbidxrebuildコマンドを使用して，未完状態や一意性制約違反状態ではない（正常な状態の）インデクスを再作成することもできます。この場合，次に示す効果が期待できます。

B-treeインデクスの場合

行の更新，追加，または削除を繰り返した表に定義されているB-treeインデクス（主キーに対応するB-treeインデクスを含む）を再作成すると，次に示す効果があります。

行の更新または削除によって無効となったデータをB-treeインデクスから削除できます。そのため，B-treeインデクスが格納されているDBエリアの使用量を削減できます。

行の追加または更新によって使用された，インデクスページ内の未使用領域を再度確保できます。そのため，インデクスページスプリットの発生頻度を抑えることができます。インデクスページ内の未使用領域については，マニュアルHADB　システム構築・運用ガイドのデータベースの設計のB-treeインデクスの設計のB-treeインデクスのインデクスページ内の未使用領域の確保（PCTFREE）を参照してください。

テキストインデクスの場合

行の更新，追加，または削除を繰り返した表に定義されているテキストインデクスを再作成すると，次に示す効果があります。

行の更新または削除によって発生した，実際にはデータが存在しないデータページへのリンクをテキストインデクスから削除できます。そのため，テキストインデクスを使用した検索性能が向上します。また，テキストインデクスが格納されているDBエリアの使用量を削減できます。

行の追加または更新によって使用された，インデクスページ内の未使用領域を再度確保できます。そのため，インデクスページスプリットの発生頻度を抑えることができます。インデクスページ内の未使用領域については，マニュアルHADB　システム構築・運用ガイドのデータベースの設計のテキストインデクスの設計のテキストインデクスのインデクスページ内の未使用領域の確保（PCTFREE）を参照してください。

レンジインデクスの場合

行の更新または削除を繰り返した表に定義されているレンジインデクスを再作成すると，次に示す効果があります。

レンジインデクスの値域の幅が狭くなり，検索性能が向上します。

レンジインデクスの不要な値域情報が削除されるため，レンジインデクスが格納されているDBエリアの使用量を削減できます。

16.1.3　adbidxrebuildコマンドのオプション機能

adbidxrebuildコマンドには，次に示すオプション機能があります。

再実行機能

adbimportコマンドからのインデクス作成処理の引き継ぎ

(1)　再実行機能

adbidxrebuildコマンドが異常終了するなどした場合は，adbidxrebuildコマンドの再実行時に，前回のインデクス再作成で内容が保証されている個所の続きからインデクス再作成処理を実行します。このため，インデクス再作成処理の再実行に掛かる時間を短縮できます。

次に示す条件を満たす場合，再実行機能が適用されることがあります。

再作成するインデクスの中に，次に示すどれかのインデクスが含まれている※

シングルチャンク表に定義されたB-treeインデクス

シングルチャンク表に定義されたテキストインデクス

マルチチャンク表に定義されたインデクス

注※

adbidxrebuildコマンドの再実行前に，処理対象表のインデクスをDROP INDEX文で削除した場合，削除したインデクスは再作成されません。また，adbidxrebuildコマンドの再実行前に再作成対象のインデクスをすべて削除した場合は，コマンドの終了処理だけが実行されます。

次に示すどれかの理由で処理が中断している

adbidxrebuildコマンドが異常終了した

adbcancelコマンドでadbidxrebuildコマンドを強制終了した

adbstop --forceコマンドでHADBサーバを強制終了した

OSのkillコマンド，電源断などでサーバプロセスを強制終了した

なお，次に示す場合，上記の条件を満たしていても，再実行機能は適用されません（インデクス再作成処理の初めから強制実行されます）。

--forceオプションを指定してadbidxrebuildコマンドを実行する場合

adbimportコマンドが中断したあとに--forceオプションを指定して実行したadbidxrebuildコマンドが中断した場合

adbunarchivechunkコマンドの実行時にエラーが発生した場合

再作成対象のインデクスが定義された表（処理対象表）の定義時にCHUNK を指定したかどうか（処理対象表がシングルチャンク表か，マルチチャンク表か）によって，再実行機能の適用条件，および再実行時の処理が異なります。

処理対象表がシングルチャンク表の場合

インデクス再作成処理では，表データを検索してレンジインデクスを再作成したあとに，B-treeインデクスおよびテキストインデクスを再作成します。

B-treeインデクスおよびテキストインデクスの再作成処理中にadbidxrebuildコマンドが中断した場合，再実行機能が適用されます。adbidxrebuildコマンドを再実行すると，B-treeインデクスおよびテキストインデクスの再作成処理からインデクス再作成処理が再開されます。

図16‒4　再実行機能の概要（シングルチャンク表の場合）

注※

次の順序でインデクスの作成処理が実行されます。

インデクスレコードのソート処理

1.のソート処理結果を入力情報にしてインデクスを作成

2.の処理中にadbidxrebuildコマンドが中断した場合，再実行機能が適用されます。adbidxrebuildコマンドを再実行すると，2.の処理から再開されます。

なお，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，1.の処理中にadbidxrebuildコマンドが中断したときも，再実行機能が適用されます。adbidxrebuildコマンドを再実行すると，1.の処理から再開されます。

次に示すときは，再実行機能が適用されません。

レンジインデクスだけを再作成しているとき

インデクスレコードのソート処理が完了する前（KFAA80220-Iメッセージの出力前）にadbidxrebuildコマンドが中断したとき

ただし，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，表データの検索が完了する前（KFAA80233-Iメッセージの出力前）にadbidxrebuildコマンドが中断したとき

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するとき

メモ

サーバ定義のadb_cmd_ixrec_file_useオペランドについては，マニュアルHADB　システム構築・運用ガイドのコマンドに関するオペランド（set形式）を参照してください。

処理対象表がマルチチャンク表の場合

処理対象表がマルチチャンク表の場合，インデクス再作成処理はチャンクごとに実行されます。

このため，マルチチャンク表の処理が中断したときは，adbidxrebuildコマンドを再実行すると再実行機能が適用され，処理が中断したチャンクからインデクス再作成処理が再開されます。

ただし，最初のチャンクのインデクスレコードのソート処理が完了する前（KFAA80220-Iメッセージの出力前）※にadbidxrebuildコマンドが中断したときは，再実行機能が適用されません。

注※

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合，表データの検索が完了する前（KFAA80233-Iメッセージの出力前）にadbidxrebuildコマンドが中断したときは，再実行機能が適用されません。

図16‒5　再実行機能の概要（マルチチャンク表の場合）

また，次に示す3つの条件を満たすときは，処理が中断したチャンクのB-treeインデクスおよびテキストインデクスの作成処理から，インデクス再作成処理が再開されます。

再作成するインデクスの中にB-treeインデクスまたはテキストインデクスが含まれている

処理が中断したチャンクのインデクスレコードのソート処理が完了している（ソート処理が完了するとKFAA80220-Iメッセージが出力されます）

ただし，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，処理が中断したチャンクの表データの検索が完了している（表データの検索が完了するとKFAA80233-Iメッセージが出力されます）

adbidxrebuildコマンドの再実行時に，--create-temp-fileオプションを指定していない（--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行すると，処理が中断したチャンクの表データの検索から，インデクス再作成処理が再開されます）

図16‒6　処理が中断したチャンクのB-treeインデクスおよびテキストインデクスの作成処理からの再実行

注※

次の順序でインデクスの作成処理が実行されます。

インデクスレコードのソート処理

1.のソート処理結果を入力情報にしてインデクスを作成

2.の処理中にadbidxrebuildコマンドが中断した場合，再実行機能が適用されます。adbidxrebuildコマンドを再実行すると，2.の処理から再開されます。

なお，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，1.の処理中にadbidxrebuildコマンドが中断したときも，再実行機能が適用されます。adbidxrebuildコマンドを再実行すると，1.の処理から再開されます。

メモ

サーバ定義のadb_cmd_ixrec_file_useオペランドについては，マニュアルHADB　システム構築・運用ガイドのコマンドに関するオペランド（set形式）を参照してください。

(2)　adbimportコマンドからのインデクス作成処理の引き継ぎ

adbidxrebuildコマンドは，adbimportコマンドからインデクス作成処理を引き継ぐことができます。

次に示す理由でadbimportコマンドを再実行できない場合にadbidxrebuildコマンドを実行すると，adbidxrebuildコマンドがインデクス作成処理を引き継ぎます。※

作業用一時ファイルが存在しない場合（adbimportコマンドの再実行時にKFAA50247-Eメッセージが出力された場合）

adbimportコマンドが中断した状態で作業用一時ファイルを削除してしまうと，adbimportコマンドが再実行できなくなります。この場合，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドからインデクス作成処理を引き継ぎます。

コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）が存在しない場合（adbimportコマンドの再実行時にKFAA50244-Eメッセージが出力された場合）

adbimportコマンドが中断した状態でコマンドステータスファイルを削除してしまうと，adbimportコマンドが再実行できなくなります。この場合，--forceオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドからインデクス作成処理を引き継ぎます。

adbimportコマンドが中断した状態でインデクスを定義し，インポート対象表に未完状態のインデクスが作成された場合（adbimportコマンドの再実行時にKFAA50209-Eメッセージが出力された場合）

adbimportコマンドが中断した状態でインデクスを定義すると，adbimportコマンドを再実行できなくなることがあります。この場合，--forceオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドからインデクス作成処理を引き継ぎます。

注※

adbidxrebuildコマンドの実行前に処理対象表のインデクスをDROP INDEX文で削除した場合，削除したインデクスは再作成されません。また，adbidxrebuildコマンドの実行前に作成対象のインデクスをすべて削除した場合，コマンドの終了処理だけが実行されます。

adbidxrebuildコマンドに指定するオプションによって，adbidxrebuildコマンドの処理が異なります。

■--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する場合

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行すると，adbidxrebuildコマンドの処理は，作業用一時ファイルを作成する表データの検索処理から開始されます。

図16‒7　adbimportコマンドからのインデクス作成処理の引き継ぎ（--create-temp-fileオプションを指定する場合）

なお，処理対象表がマルチチャンク表の場合，adbimportコマンドが中断したときに処理中だったチャンクが，adbidxrebuildコマンドの処理対象となります。adbidxrebuildコマンドが正常終了するまで，対象となるチャンクは変更されません。

■--forceオプションを指定してadbidxrebuildコマンドを実行する場合

--forceオプションを指定してadbidxrebuildコマンドを実行すると，adbidxrebuildコマンドがインデクス再作成処理の初めから開始されます。

図16‒8　adbimportコマンドからのインデクス作成処理の引き継ぎ（--forceオプションを指定する場合）

16.1.4　adbidxrebuildコマンドが使用するスレッドの関係

adbidxrebuildコマンドは，次の処理で処理リアルスレッドを使用します。

表データの検索，およびレンジインデクスの再作成

この処理では，「1～（ ↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，インデクス再作成オプションadb_idxrebuild_rthd_numの指定値またはデフォルト値となります。インデクス再作成オプションadb_idxrebuild_rthd_numのデフォルト値については，「16.2.2　インデクス再作成オプションの形式」の「(2)　指定形式の説明」にある，インデクス再作成オプションadb_idxrebuild_rthd_numを参照してください。

作業用一時ファイルの作成

この処理では，「1～（ ↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスのレコードのソート

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスの再作成

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1と処理2は同時に実行されます。そのあとに，処理3と処理4が順に実行されます。処理5は，処理1～処理4の実行中，常に実行されます。

adbidxrebuildコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図16‒9　adbidxrebuildコマンドが処理リアルスレッドを使用する処理

16.2　adbidxrebuildコマンドの指定形式

adbidxrebuildコマンドの指定形式，およびインデクス再作成オプションの形式について説明します。

adbidxrebuildコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

16.2.1　指定形式およびオプションの説明

(1)　指定形式

adbidxrebuild
  -u 認可識別子
  〔-p パスワード〕
  〔-g インデクス再作成処理の経過メッセージ出力間隔〕
  〔-w ｛作業用一時ファイルの格納先ディレクトリ名
       ｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕
  〔-z インデクス再作成オプションファイル名〕
  〔-i インデクス識別子ファイル名〕
  〔｛--create-temp-file｜--force｝〕
  処理対象表

重要

処理対象表は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbidxrebuildコマンドを実行するHADBユーザの認可識別子を指定します。adbidxrebuildコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するREBUILD INDEX権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

重要

adbidxrebuildコマンドの再実行機能を使用する場合，-uオプションに指定する認可識別子を変更することはできません。そのため，インデクスの再作成中に，adbidxrebuildコマンドの実行ユーザを削除したり，REBUILD INDEX権限を取り消したりしないでください。

誤って操作してしまった場合は，次のどちらかの対処をしてください。

同じユーザでadbidxrebuildコマンドを実行できる状態にして，adbidxrebuildコマンドを再実行してください。対処方法については，マニュアルHADB　システム構築・運用ガイドの非定期運用のHADBユーザの管理またはアクセス権限の管理を参照してください。

処理対象表に対するREBUILD INDEX権限を持つ別のユーザで，--forceオプションを指定してadbidxrebuildコマンドを実行してください。ただし，このとき，adbidxrebuildコマンドの再実行機能は適用されません。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbidxrebuildコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-g インデクス再作成処理の経過メッセージ出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

インデクス再作成処理の経過メッセージの出力間隔を指定します。例えば，このオプションに2を指定すると，表データが2,000行検索されるごとに経過メッセージ（KFAA80205-I）が出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝

〜〈OSパス名〉((2〜518バイト))

インデクス再作成処理時に作成される作業用一時ファイルの格納先を，次に示すどちらかの方法で指定します。

作業用一時ファイルを格納するディレクトリ名を絶対パス名で指定する

作業用一時ファイルを格納するディレクトリを指定したファイル名（ディレクトリパスファイル名）を絶対パス名で指定する

1つのディレクトリ下に格納される作業用一時ファイルに対して入出力が集中すると，性能低下の原因になります。そのため，2の方法で作業用一時ファイルを異なるディスクのディレクトリに格納して，ディスクに対する入出力処理の負荷を分散することを推奨します。2の方法の指定例（ディレクトリパスファイルの指定例）を次に示します。

ディレクトリパスファイルの指定例

/mnt/diska/wwwww
/mnt/diskb/xxxxx
/mnt/diskc/yyyyy
/mnt/diskd/zzzzz

指定するディレクトリ数の目安を次に示します。

指定するディレクトリ数の目安＝A×B

A：最大検索処理スレッド数

次の計算式で求めてください。

↓（インデクス再作成オプションadb_idxrebuild_rthd_numの値－1）÷2↓

B：再作成対象のB-treeインデクスおよびテキストインデクスの数

B-treeインデクスおよびテキストインデクスの数がわからない場合は，次に示すSQL文で表に定義されているB-treeインデクスおよびテキストインデクスの数を確認してください。

SELECT "N_INDEX"-"N_RANGE_INDEX"
    FROM "MASTER"."SQL_TABLES"
        WHERE "TABLE_SCHEMA"='認可識別子'
           AND "TABLE_NAME"='処理対象表の表名'

ディレクトリパスファイル中にディレクトリを255個まで指定できます。

ディレクトリパスファイル中に記述されている順番に，作業用一時ファイルの格納先ディレクトリとして使用されます。ディレクトリパスファイル中に記述された最後のディレクトリ（この例では/mnt/diskd/zzzzz）が使用された場合，次に使用されるディレクトリは先頭のディレクトリ（この例では/mnt/diska/wwwww）になります。

このオプションの指定規則（方法1，2の両方の指定規則）を次に示します。

パス名の末尾にスラッシュ（/）を指定しないでください。

-wオプションに指定したディレクトリ下に作成される作業用一時ファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのadbidxrebuildコマンド実行時の作業用一時ファイルの容量見積もりを参照してください。なお，このオプションを省略した場合，$DBDIR/ADBWORK下に作業用一時ファイルが作成されます。

作業用一時ファイルを格納するディレクトリは，専用のディレクトリにしてください。ほかのファイルを格納しているディレクトリと重複した場合，既存のファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。作業用一時ファイルの格納先ディレクトリ名と重複しないようにする必要があるファイルについては，「16.6　注意事項」を参照してください。

なお，作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

メモ

作業用一時ファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●-z インデクス再作成オプションファイル名

〜〈OSパス名〉((2〜510バイト))

インデクス再作成オプションを指定したインデクス再作成オプションファイルの絶対パス名を指定します。このオプションを省略すると，インデクス再作成オプションファイルが指定されないため，すべてのインデクス再作成オプションにデフォルト値が仮定されます。

インデクス再作成オプションについては，「16.2.2　インデクス再作成オプションの形式」を参照してください。

なお，インデクス再作成オプションファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。インデクス再作成オプションファイル名と重複しないようにする必要があるファイルについては，「16.6　注意事項」を参照してください。

●-i インデクス識別子ファイル名

〜〈OSパス名〉((2〜510バイト))

再作成の対象となるインデクス識別子を記載したファイルを，絶対パス名で指定します。インデクス識別子ファイルに指定したインデクスは，インデクスの状態に関係なく，すべて再作成されます。

このオプションを省略した場合，処理対象表に定義されている未完状態のインデクスだけが再作成されます。

なお，adbimportコマンドの中断後にadbidxrebuildコマンドでインデクス作成処理を引き継ぐ場合は，このオプションの指定に関係なく，処理対象表に定義したすべてのインデクスが再作成されます。

インデクス識別子ファイルの指定例を次に示します。

adbidxrebuildコマンドの例

adbidxrebuild -u ADBUSER01 -i /home/adbmanager/rebuild_file/table01_idx.txt TABLE01

インデクス識別子ファイル（/home/adbmanager/rebuild_file/table01_idx.txt）の指定例

INDEX02
INDEX03

この例では，再作成の対象となるインデクス識別子を2つ指定したインデクス識別子ファイルを，コマンドオプションとして指定しています。adbidxrebuildコマンドを実行すると，INDEX02およびINDEX03が再作成されます。

インデクス識別子ファイルの指定規則を次に示します。

処理対象表に定義されていないインデクスは指定できません。

同一のインデクス識別子を複数指定できません。

英小文字を含むインデクス識別子を指定する場合は，二重引用符（"）で囲んでください。二重引用符（"）で囲まないと，インデクス識別子はすべて英大文字として扱われます。

主キーに対応するB-treeインデクスを再作成する場合は，自動的に生成されたインデクス識別子（制約名と同じ）を指定します。主キーに対応するB-treeインデクスのインデクス識別子を調べる方法については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の検索を参照してください。

ファイル中の空行は無視されます。ただし，インデクス識別子ファイルがすべて空行の場合，adbidxrebuildコマンドがエラーとなります。

●--create-temp-file

通常は，このオプションを省略してください。

adbimportコマンドまたはadbidxrebuildコマンドを再実行した際にKFAA50247-Eメッセージが出力された場合は，このオプションを指定してください。作業用一時ファイルを作成する表データの検索から，adbidxrebuildコマンドが実行されます。adbimportコマンドの中断後に，このオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドからインデクス作成処理を引き継ぐことができます。

なお，adbimportコマンドからのインデクス作成処理の引き継ぎの概要については，「16.1.3　adbidxrebuildコマンドのオプション機能」の「(2)　adbimportコマンドからのインデクス作成処理の引き継ぎ」を参照してください。また，この場合，コマンドオプションやインデクス再作成オプションの指定などに考慮が必要です。詳細については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

重要

処理対象表が更新不可状態ではない場合は，このオプションを指定できません（メッセージログファイルにKFAA50248-Eメッセージが出力されます）。

このオプションは，再実行に必要な作業用一時ファイル（インデクスレコードファイルまたはソート結果用ファイル）が存在しない場合に指定することを想定しています。もし，作業用一時ファイルが存在する場合にadbidxrebuildコマンドを実行すると，存在するファイルは再作成されます。ただし，対象のファイルへの書き込み権限または読み取り権限がないと，adbidxrebuildコマンド実行時にアクセスエラーになることがあります（KFAA30959-Eメッセージ，KFAA40204-Eメッセージ，KFAA40205-Eメッセージ，KFAA40214-Eメッセージ，KFAA41205-Eメッセージ，またはKFAA41206-Iメッセージが出力されます。エラー番号には13(EACCES)が出力されます）。このときは，OSのrmコマンドなどで該当するファイルを削除してから，adbidxrebuildコマンドをもう一度実行してください。

このオプションを指定しないでadbidxrebuildコマンドを実行した場合，前回のインデクス再作成で内容が保証されている個所の続きからインデクス再作成処理を実行します。

一方，このオプションを指定してadbidxrebuildコマンドを実行した場合，作業用一時ファイルを作成する表データの検索からインデクス再作成処理を行います。レンジインデクスが作成済みの場合，表データの検索時に再作成されます。

●--force

通常は，このオプションを省略してください。

次に示す場合に，このオプションを指定してadbidxrebuildコマンドを実行してください。インデクス再作成処理が，初めから強制実行されます。

adbimportコマンドまたはadbidxrebuildコマンドの再実行時にKFAA50244-Eメッセージが出力された場合

・再実行に必要なコマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）が存在しない

・表の更新不可状態を解除しないで，04-00以前のバージョンのHADBサーバからバージョンアップした

adbimportコマンドが中断した状態で処理対象表にインデクスを定義し，adbimportコマンドの再実行時にKFAA50209-Eメッセージが出力された場合（未完状態のインデクスが存在する場合）

adbimportコマンドの中断後にこのオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドからインデクス作成処理を引き継ぐことができます。

このオプションを指定してadbidxrebuildコマンドを実行する前に，次に示すディレクトリ下のファイル（作業用一時ファイル）を，OSのrmコマンドなどで削除してください。書き込み権限または読み取り権限がないファイルがあると，adbidxrebuildコマンドを実行できないことがあります。

前回中断したコマンドの実行時に-wオプションを指定した場合

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ

前回中断したコマンドの実行時に-wオプションを省略した場合

$DBDIR/ADBWORKディレクトリ

なお，adbimportコマンドからのインデクス作成処理の引き継ぎの概要については，「16.1.3　adbidxrebuildコマンドのオプション機能」の「(2)　adbimportコマンドからのインデクス作成処理の引き継ぎ」を参照してください。また，この場合，コマンドオプションやインデクス再作成オプションの指定などに考慮が必要です。詳細については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

このオプションを指定しないでadbidxrebuildコマンドを実行した場合，前回のインデクス再作成で内容が保証されている個所の続きからインデクス再作成処理を実行します。

一方，このオプションを指定してadbidxrebuildコマンドを実行した場合，インデクス再作成処理を最初から行います。

●処理対象表

再作成するインデクスが定義されている表を指定します。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

REBUILD INDEX権限を持っている表を指定できます。

ビュー表は指定できません。

16.2.2　インデクス再作成オプションの形式

(1)　指定形式

〔set adb_idxrebuild_rthd_num = adbidxrebuildコマンドが使用する処理リアルスレッド数〕
〔set adb_idxrebuild_scan_buff_size = 表データの検索バッファサイズ〕
〔set adb_idxrebuild_buff_blk_num = インデクス再作成用バッファブロック数〕
〔set adb_idxrebuild_sort_buff_size = ソートバッファサイズ〕
〔set adb_idxrebuild_dvix_rdbuff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ〕
〔set adb_idxrebuild_dvix_wtbuff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ〕
〔set adb_idxrebuild_txt_buff_size = テキストインデクスの作成用バッファサイズ〕
〔set adb_idxrebuild_dvbix_rthd_use = ｛FIXED｜VARIABLE｝〕

上記のインデクス再作成オプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_idxrebuild_rthd_num = adbidxrebuildコマンドが使用する処理リアルスレッド数

〜〈整数〉((3〜4,096))

adbidxrebuildコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbidxrebuildコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbidxrebuildコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbidxrebuildコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「16.1.4　adbidxrebuildコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbidxrebuildコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表16‒1　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0～2の値を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに3以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに3以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbidxrebuildコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_idxrebuild_scan_buff_size = 表データの検索バッファサイズ

〜〈整数〉((1〜2,048))《8》（単位：メガバイト）

表データの検索結果を保持するバッファのサイズをメガバイト単位で指定します。指定値を大きくすると，表データを検索する際のオーバヘッドを削減できます。

次に示す計算式で求めた値を指定値の目安としてください。

計算式

再作成対象のB-treeインデクスのキー長×100,000

B-treeインデクスのキー長の求め方については，マニュアルHADB　システム構築・運用ガイドのデータベースの設計のデータ用DBエリアの容量見積もりのB-treeインデクスのキー長（KEYSZ）の求め方を参照してください。

●adb_idxrebuild_buff_blk_num = インデクス再作成用バッファブロック数

〜〈整数〉((5〜4,096))《64》

インデクス再作成処理で使用するバッファのブロック数を指定します。既定値のままで問題ありません。指定値を大きくするとインデクス再作成の速度が向上することがあります。

●adb_idxrebuild_sort_buff_size = ソートバッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

B-treeインデクスまたはテキストインデクスを再作成する場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用するソートバッファのサイズをメガバイト単位で指定します。

メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_idxrebuild_dvix_rdbuff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

B-treeインデクスまたはテキストインデクスを再作成する場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する入力バッファサイズをキロバイト単位で指定します。

メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_idxrebuild_dvix_wtbuff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

B-treeインデクスまたはテキストインデクスを再作成する場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する出力バッファサイズをキロバイト単位で指定します。

メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_idxrebuild_txt_buff_size = テキストインデクスの作成用バッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

テキストインデクスを再作成する場合に，このオプションの指定を検討してください。

このオプションには，テキストインデクスの作成処理時に使用するバッファサイズをメガバイト単位で指定します。

このオプションの指定値を大きくすると性能向上が見込めます。ただし，テキストインデクスを作成する全処理リアルスレッドで，このオプションで指定したバッファ分のメモリを使用します。このため，このオプションの指定値を大きくするときは注意してください。

●adb_idxrebuild_dvbix_rthd_use = ｛FIXED｜VARIABLE｝

〜《サーバ定義adb_cmd_dvbix_rthd_useオペランドの値》

B-treeインデクスを再作成する場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスを再作成する際，B-treeインデクス作成用スレッド数の調整機能を有効にするかどうかを指定します。B-treeインデクス作成用スレッド数の調整機能については，「17.1.2　adbimportコマンドのオプション機能」の「(4)　B-treeインデクス作成用スレッド数の調整機能」を参照してください。

FIXED：B-treeインデクス作成用スレッド数の調整機能を有効にしません。

B-treeインデクスの作成処理は，使用可能な処理リアルスレッドを最大限に使用して，並列に処理されます。B-treeインデクスのデータの格納効率よりも，B-treeインデクスの作成処理時間の短縮を優先する場合に指定してください。

使用される処理リアルスレッド数は，「adb_idxrebuild_rthd_numオプションの指定値※- 1」になります。

注※

adb_idxrebuild_rthd_numオプションの指定を省略した場合は，「表16‒1　コマンド実行時に使用する処理リアルスレッド数」に従ってadb_idxrebuild_rthd_numオプションの値が決まります。

VARIABLE：B-treeインデクス作成用スレッド数の調整機能を有効にします。

B-treeインデクスの作成処理は，データのサイズや件数などに応じて，使用される処理リアルスレッド数を変更して処理されます。B-treeインデクスの作成処理時間の短縮よりも，B-treeインデクスのデータの格納効率を優先する場合に指定してください。

使用される処理リアルスレッド数は，「1」または「このオプションにFIXEDを指定したときに使用される処理リアルスレッド数」のどちらかになります。

メモ

再実行機能によって，B-treeインデクスの再作成処理を再開した場合，B-treeインデクス作成用スレッド数の調整機能は有効になりません。このオプションの指定値，前回のadbidxrebuildコマンド実行時の指定値，またはサーバ定義adb_cmd_dvbix_rthd_useオペランドの値に関係なく，FIXEDが仮定されます。再実行機能については，「16.1.3　adbidxrebuildコマンドのオプション機能」の「(1)　再実行機能」を参照してください。

16.3　使用例

adbidxrebuildコマンドを使用してインデクスを再作成する方法を，例題形式で説明します。

実行中にadbidxrebuildコマンドが異常終了した場合は，「16.5　adbidxrebuildコマンドが異常終了したときの対処方法」を参照して対処してください。

16.3.1　未完状態のインデクスを再作成する場合

次に示す条件で，未完状態のインデクス（BIDX02，TIDX01，およびRIDX01）を再作成して使用できるようにします。

表TABLE01にはB-treeインデクスBIDX01が定義されている

表TABLE01にはデータが格納されている

表TABLE01にデータを格納したあとで，B-treeインデクスBIDX02，テキストインデクスTIDX01，およびレンジインデクスRIDX01の定義を表TABLE01に追加する（BIDX02，TIDX01，およびRIDX01は未完状態となる）

このとき，次に示す手順でadbidxrebuildコマンドを実行します。

手順

インデクス再作成オプションファイルを作成する

adbidxrebuildコマンドを実行する

各手順の例を以降で説明します。

(1)　インデクス再作成オプションファイルを作成する

インデクス再作成オプションファイルを作成して，インデクス再作成オプションを指定します。

インデクス再作成オプションファイルの指定例

set adb_idxrebuild_rthd_num = 3
set adb_idxrebuild_scan_buff_size = 2
      ：

(2)　adbidxrebuildコマンドを実行する

adbidxrebuild -u ADBUSER01                                            ...1
              -p '#HelloHADB_01'                                      ...2
              -g 10                                                   ...3
              -z /home/adbmanager/rebuild_file/idxrebuild_opt.txt     ...4
              TABLE01                                                 ...5

［説明］

adbidxrebuildコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

インデクス再作成処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

「(1)　インデクス再作成オプションファイルを作成する」で作成したインデクス再作成オプションファイルの絶対パス名を指定します。

処理対象表（TABLE01）を指定します。

インデクス識別子ファイルを指定していないため，処理対象表に定義されている未完状態のインデクス（BIDX02，TIDX01，およびRIDX01）が再作成処理の対象となります。

16.3.2　指定したインデクスを再作成する場合

次に示す条件で，指定したインデクス（BIDX02，TIDX01，およびRIDX01）を再作成します。

表TABLE01にはB-treeインデクスBIDX01とBIDX02，テキストインデクスTIDX01，およびレンジインデクスRIDX01が定義されている

インデクスはすべて正常な状態である

このとき，次に示す手順でadbidxrebuildコマンドを実行します。

手順

インデクス識別子ファイルを作成する

インデクス再作成オプションファイルを作成する

adbidxrebuildコマンドを実行する

各手順の例を以降で説明します。

(1)　インデクス識別子ファイルを作成する

インデクス識別子ファイルを作成して，再作成対象のインデクス識別子を指定します。

インデクス識別子ファイルの指定例

BIDX02
TIDX01
RIDX01

(2)　インデクス再作成オプションファイルを作成する

インデクス再作成オプションファイルを作成して，インデクス再作成オプションを指定します。

インデクス再作成オプションファイルの指定例

set adb_idxrebuild_rthd_num = 3
set adb_idxrebuild_scan_buff_size = 2
      ：

(3)　adbidxrebuildコマンドを実行する

adbidxrebuild -u ADBUSER01                                            ...1
              -p '#HelloHADB_01'                                      ...2
              -g 10                                                   ...3
              -z /home/adbmanager/rebuild_file/idxrebuild_opt.txt     ...4
              -i /home/adbmanager/rebuild_file/table01_idx.txt        ...5
              TABLE01                                                 ...6

［説明］

adbidxrebuildコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

インデクス再作成処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

「(2)　インデクス再作成オプションファイルを作成する」で作成したインデクス再作成オプションファイルの絶対パス名を指定します。

「(1)　インデクス識別子ファイルを作成する」で作成したインデクス識別子ファイルの絶対パス名を指定します。

処理対象表（TABLE01）を指定します。

16.4　リターンコード

adbidxrebuildコマンドのリターンコードを次の表に示します。

表16‒2　adbidxrebuildコマンドのリターンコード

リターンコード

意味

0

adbidxrebuildコマンドが正常に終了しました。

4

adbidxrebuildコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

なお，KFAA61205-Wメッセージ（重複キー値を検出した旨の警告メッセージ）が出力された場合，処理対象表とB-treeインデクスは一意性制約に違反した状態になっています（B-treeインデクスが一意性制約に違反した状態であることを，一意性制約違反状態といいます）。この場合，重複しているキー値を検索して，対象の行を削除してください。そのあとで，再度adbidxrebuildコマンドを実行してB-treeインデクスを再作成してください。対処方法の詳細については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのB-treeインデクスに関するトラブルの一意性制約に違反した場合の対処方法（KFAA61205-Wメッセージが出力された場合）を参照してください。

8

次のどちらかのエラーが発生しました。

adbidxrebuildコマンドの指定に誤りがあり，adbidxrebuildコマンドが実行されませんでした。

adbidxrebuildコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。詳細については，「16.5　adbidxrebuildコマンドが異常終了したときの対処方法」を参照してください。

16.5　adbidxrebuildコマンドが異常終了したときの対処方法

adbidxrebuildコマンドが異常終了したときの対処手順を次に示します。

16.5.1　最初に確認すること

次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されている場合は，コマンドのオプションや，インデクス再作成オプションの指定に誤りがあります。コマンドのオプションまたはインデクス再作成オプションを修正したあとに，adbidxrebuildコマンドを再実行してください。

これらのメッセージが出力されていない場合は，「16.5.2　障害原因の特定と対処」に進んでください。

16.5.2　障害原因の特定と対処

adbidxrebuildコマンドが中断したときの対処手順（フロー）を次の図に示します。

図16‒10　adbidxrebuildコマンドが異常終了したときの対処手順

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

adbidxrebuildコマンドを再実行してください。

再実行したadbidxrebuildが中断した場合は，出力されているメッセージを確認して，adbidxrebuildコマンドを実行してください。

詳細については，「16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合」を参照してください。

なお，次に示すインデクスを再作成している場合は，「16.5.3　処理対象表がシングルチャンク表の場合」を参照してください。

シングルチャンク表に定義されたB-treeインデクス

シングルチャンク表の主キーに対応するB-treeインデクスを含みます。

シングルチャンク表に定義されたテキストインデクス

また，マルチチャンク表に定義されたインデクスを再作成している場合は，「16.5.4　処理対象表がマルチチャンク表の場合」を参照してください。

■マルチノード機能を使用している場合

adbidxrebuildコマンドが中断して，処理対象表が更新不可状態となった場合，中断したadbidxrebuildコマンドを再実行して，実表の更新不可状態を解除してください。

なお，プライマリノードのHADBサーバが異常終了してプライマリノードが切り替わった場合は，新たなプライマリノードでadbidxrebuildコマンドを実行し，実表の更新不可状態を解除してください。このとき，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。

プライマリノードを別のノードに変更する方法やマルチノード機能を使用しないでHADBサーバを起動する方法については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のトラブルシュート（マルチノード機能の使用時）のマルチノード構成のHADBサーバの開始または終了に関するトラブルを参照してください。

adbidxrebuildコマンドの--create-temp-fileオプションについては，「16.2.1　指定形式およびオプションの説明」の「(2)　オプションの説明」の「--create-temp-file」を参照してください。

16.5.3　処理対象表がシングルチャンク表の場合

シングルチャンク表に定義されたB-treeインデクス（主キーに対応するB-treeインデクスを含む），またはテキストインデクスを再作成している場合，adbidxrebuildコマンドの再実行機能を使用して，B-treeインデクスおよびテキストインデクスの作成処理からインデクス再作成処理を再開できることがあります。

(1)　再実行前の注意点

adbidxrebuildコマンドが異常終了したときと同じHADBユーザでadbidxrebuildコマンドを再実行すると，再実行機能が自動的に適用されます。特別な操作はありません。

なお，adbidxrebuildコマンドの再実行時にコマンドオプションおよびインデクス再作成オプションを変更する場合は，「16.5.5　再実行時にコマンドオプションおよびインデクス再作成オプションを変更する場合」を参照してください。

重要

コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラー（KFAA50244-Eメッセージ）が発生した場合は，--forceオプションを指定してadbidxrebuildコマンドを実行し直してください（このとき，インデクス再作成処理は最初から実行されます）。

--forceオプションを指定してadbidxrebuildコマンドを実行する方法については，「16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

作業用一時ファイルに対するアクセスエラー（KFAA50247-Eメッセージ）が発生した場合は，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行し直してください（このとき，インデクス再作成処理は表データの検索から実行されます）。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する方法については，「16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合」の「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

(2)　再実行機能の適用可否（シングルチャンク表の場合）

adbidxrebuildコマンドの中断タイミングによる再実行機能の適用可否を次の表に示します。

なお，データベースの回復方法はどの時点で中断が発生しても同じになります。

表16‒3　adbidxrebuildコマンドの中断タイミングによる再実行機能の適用可否（シングルチャンク表の場合）

中断のタイミング※1

表データの検索中

ソート処理中

B-treeインデクスとテキストインデクスの作成中※2

再実行機能の適用可否

適用されません。※3

表の状態

次のどちらかの状態です。

更新不可状態

adbidxrebuildコマンド実行前の状態

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは，次のどちらかの状態です。

未完状態

adbidxrebuildコマンド実行前の状態

サーバ定義のadb_cmd_ixrec_file_useオペランドにSINGLE-USE（省略値）を指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「表データの検索中」と同じです。

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「B-treeインデクスとテキストインデクスの作成中」と同じです。

再実行機能の適用可否

適用されます。※4

表の状態

更新不可状態です。

インデクスの状態

B-treeインデクスおよびテキストインデクスは未完状態です。

レンジインデクスの再作成は完了しています（レンジインデクスの未完状態は解除されます）。

注※1

中断のタイミングは，次に示すように出力されたメッセージで確認できます。

注※2

KFAA80204-Iメッセージ（リターンコードが0または4）が出力されている場合は，インデクス再作成処理はすべて完了しています。この場合，adbidxrebuildコマンドの再実行は不要です。

KFAA80204-Iメッセージが出力されていない場合は，次のコマンドを実行して出力結果（表のサマリ情報）の2行目を確認してください（出力結果の1行目は列のタイトルです）。

adbdbstatus -c table -n adbidxrebuildコマンドが中断した表名

adbidxrebuildコマンドが中断した表名は，「スキーマ名.表識別子」の形式で指定します。

■Command_status列（17列目）の値がabort，かつRerun_command列（18列目）の値がadbidxrebuildのとき

インデクス再作成処理が完了していません。adbidxrebuildコマンドを再実行してください。

■Command_status列（17列目）およびRerun_command列（18列目）に値が出力されていないとき

インデクス再作成処理が完了しています。adbidxrebuildコマンドの再実行は不要です。

注※3

adbidxrebuildコマンドの再実行時，インデクス再作成処理を最初から行います。

ただし，adbidxrebuildコマンドの再実行前に，再作成対象のインデクスをすべて削除した場合は，コマンドの終了処理だけ実行します。

注※4

adbidxrebuildコマンドの再実行時，B-treeインデクスおよびテキストインデクスの作成処理からインデクス再作成を再開します。

ただし，次に示す場合は，表データの検索からインデクス再作成処理を再開します。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する場合

adbimportコマンド中断後に，--create-temp-fileオプションを指定して実行したadbidxrebuildコマンドが中断した場合

また，adbidxrebuildコマンドの再実行前に，再作成対象のインデクスをすべて削除した場合は，コマンドの終了処理だけ実行します。

16.5.4　処理対象表がマルチチャンク表の場合

マルチチャンク表に定義されたインデクスを再作成している場合，adbidxrebuildコマンドの再実行機能を使用して，処理が中断したチャンクからインデクス再作成処理を再開できます。

(1)　再実行前の注意点

adbidxrebuildコマンドが異常終了したときと同じHADBユーザでadbidxrebuildコマンドを再実行すると，再実行機能が自動的に適用されます。特別な操作はありません。

ただし，adbidxrebuildコマンドの再実行時に-iオプションは変更しないでください。なお，adbidxrebuildコマンドの再実行時に，ほかのコマンドオプションおよびインデクス再作成オプションを変更する場合は，「16.5.5　再実行時にコマンドオプションおよびインデクス再作成オプションを変更する場合」を参照してください。

重要

コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラー（KFAA50244-Eメッセージ）が発生した場合は，--forceオプションを指定してadbidxrebuildコマンドを実行し直してください（このとき，インデクス再作成処理は最初から実行されます）。

--forceオプションを指定してadbidxrebuildコマンドを実行する方法については，「16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

作業用一時ファイルに対するアクセスエラー（KFAA50247-Eメッセージ）が発生した場合は，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行し直してください（このとき，インデクス再作成処理は表データの検索から実行されます）。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する方法については，「16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合」の「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

メモ

インデクス再作成処理を開始したチャンクのチャンクIDはKFAA80211-Iメッセージに，処理が完了したチャンクのチャンクIDはKFAA80212-Iメッセージにそれぞれ出力されます。

(2)　再開時の処理（マルチチャンク表の場合）

マルチチャンク表に定義されたインデクスを再作成している場合，adbidxrebuildコマンドの中断タイミングによって，adbidxrebuildコマンドを再実行したときに処理がどこから再開されるかが決まります。

なお，データベースの回復方法はどの時点で中断が発生しても同じになります。

表16‒4　adbidxrebuildコマンドの中断タイミングによる再開時の処理（マルチチャンク表の場合）

中断のタイミング※1

表データの検索中

ソート処理中

B-treeインデクスとテキストインデクスの作成中※2

再開時の処理

処理が中断したチャンクの表データの検索から，インデクス再作成処理を再開します。※3

表の状態

次のどちらかの状態です。

更新不可状態

adbidxrebuildコマンド実行前の状態

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは，次のどちらかの状態です。

未完状態

adbidxrebuildコマンド実行前の状態

サーバ定義のadb_cmd_ixrec_file_useオペランドにSINGLE-USE（省略値）を指定した場合

再開時の処理，表の状態，およびインデクスの状態は，「表データの検索中」と同じです。

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合

再開時の処理，表の状態，およびインデクスの状態は，「B-treeインデクスとテキストインデクスの作成中」と同じです。

再開時の処理

処理が中断したチャンクのB-treeインデクスおよびテキストインデクスの作成処理から，インデクス再作成処理を再開します。※4

表の状態

更新不可状態です。

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは未完状態です。

ただし，最後のチャンク※5の処理中に中断した場合は，レンジインデクスの再作成が完了しています（レンジインデクスの未完状態は解除されます）。

注※1

中断のタイミングは，次に示すように出力されたメッセージで確認できます。表のチャンクIDごとに，KFAA80211-Iメッセージ〜KFAA80212-Iメッセージが出力されます。

注※2

KFAA80204-Iメッセージ（リターンコードが0または4）が出力されている場合は，インデクス再作成処理はすべて完了しています。この場合，adbidxrebuildコマンドの再実行は不要です。

KFAA80204-Iメッセージが出力されていない場合は，次のコマンドを実行して出力結果（表のサマリ情報）の2行目を確認してください（出力結果の1行目は列のタイトルです）。

adbdbstatus -c table -n adbidxrebuildコマンドが中断した表名

adbidxrebuildコマンドが中断した表名は，「スキーマ名.表識別子」の形式で指定します。

■Command_status列（17列目）の値がabort，かつRerun_command列（18列目）の値がadbidxrebuildのとき

インデクス再作成処理が完了していません。adbidxrebuildコマンドを再実行してください。

■Command_status列（17列目）およびRerun_command列（18列目）に値が出力されていないとき

インデクス再作成処理が完了しています。adbidxrebuildコマンドの再実行は不要です。

注※3

最初のチャンクの表データの検索中にadbidxrebuildコマンドが中断した場合は，adbidxrebuildコマンドの再開時に最初からインデクス再作成処理を行います（再実行機能は適用されません）。

ただし，adbidxrebuildコマンドの再実行前に，再作成対象のインデクスをすべて削除した場合は，コマンドの終了処理だけ実行します。

注※4

次に示す場合は，処理が中断したチャンクの表データの検索からインデクス再作成処理を再開します。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを再実行する場合

adbimportコマンド中断後に，--create-temp-fileオプションを指定して実行したadbidxrebuildコマンドが中断した場合

ただし，adbidxrebuildコマンドの再実行前に，再作成対象のインデクスをすべて削除した場合は，コマンドの終了処理だけ実行します。

注※5

処理対象表の最後のチャンクの処理中にadbidxrebuildコマンドが中断したことを確認するには，KFAA80211-Iメッセージに出力されている「現在処理中のチャンク数」と「全チャンク数」が等しいかどうかを確認してください。

KFAA80211-Iメッセージの出力例（処理対象表の最後のチャンクの処理中に中断した場合）

KFAA80211-I Processing for the chunk will start. (chunk id = 3) (3/3)

16.5.5　再実行時にコマンドオプションおよびインデクス再作成オプションを変更する場合

ここでは，adbidxrebuildコマンドの再実行時に，コマンドオプションおよびインデクス再作成オプションを変更する場合の動作について示します。

(1)　コマンドオプションを変更する場合

変更したコマンドオプションが有効になるかどうかは，adbidxrebuildコマンドの中断タイミングによって異なります。コマンドオプションを変更する場合の再開時の動作について，次の表に示します。

表16‒5　コマンドオプションを変更する場合の再開時の動作

項番

変更するコマンドオプション

中断のタイミング※1

表データの検索中

ソート処理中

B-treeインデクスとテキストインデクスの作成中

1

-uオプション

×

×

×

2

-pオプション

×

×

×

3

-gオプション

○

△

△

4

-wオプション

○

△

△

5

-zオプション

○

○

○

6

-iオプション※2

○※3

−

−

7

--create-temp-file

○※4

−

−

8

--force

--forceを指定すると処理の初めから強制実行されるため，該当しません。※5

9

処理対象表

×

×

×

（凡例）

○：変更が有効になります。

△：シングルチャンク表では，変更しても無視されます（変更前の指定で実行されます）。マルチチャンク表では，次のチャンクの処理から変更が有効になります。ただし，最後のチャンクの処理中にadbidxrebuildコマンドが中断したときは，変更しても無視されます。

×：変更すると，再実行となりません。

−：変更しても無視されます（変更前の指定で実行されます）。

注※1

中断のタイミングについては，次に示す項目を参照してください。

・シングルチャンク表：「表16‒3　adbidxrebuildコマンドの中断タイミングによる再実行機能の適用可否（シングルチャンク表の場合）」

・マルチチャンク表：「表16‒4　adbidxrebuildコマンドの中断タイミングによる再開時の処理（マルチチャンク表の場合）」

注※2

マルチチャンク表に対して再実行機能を使用するときは，-iオプションの指定を変更しないでください。変更すると，条件によっては変更が有効になり，再実行機能を使用できなくなることがあります。

注※3

マルチチャンク表では，最初のチャンクのデータ検索から処理を再開するときだけ，変更が有効になります。2つ目以降のチャンクの処理から再開するときは，変更が無効になります。

注※4

adbimportコマンドの中断後に，--create-temp-fileオプションを指定して実行したadbidxrebuildコマンドが中断した場合，そのあとで実行するadbidxrebuildコマンドは，--create-temp-fileオプションが指定された状態になります。このとき，インデクス再作成処理は表のデータ検索から再開されます（処理対象表がマルチチャンク表の場合は，adbimportコマンドが中断したときに処理中だったチャンクの表のデータ検索から再開されます）。

adbidxrebuildコマンドを実行し直す際に，--create-temp-fileオプションの指定を変更しても無効となります。ただし，--forceオプションを指定すると，--forceオプションの指定が有効になります。

注※5

adbimportコマンドの中断後に，--forceオプションを指定して実行したadbidxrebuildコマンドが中断した場合，そのあとで実行するadbidxrebuildコマンドは，--forceオプションが指定された状態になります。このとき，インデクス再作成処理の初めから強制実行されます（KAFF80215-Iメッセージが出力されます）。

adbidxrebuildコマンドを実行し直す際に，--forceオプションの指定を変更しても無効となります。

(2)　インデクス再作成オプションを変更する場合

変更したインデクス再作成オプションが有効になるかどうかは，adbidxrebuildコマンドの中断タイミングによって異なります。インデクス再作成オプションを変更する場合の再開時の動作について，次の表に示します。

表16‒6　インデクス再作成オプションを変更する場合の再開時の動作

項番

変更するインデクス再作成オプション

中断のタイミング※

表データの検索中

ソート処理中

B-treeインデクスとテキストインデクスの作成中

1

adb_idxrebuild_rthd_num

○

○

○

2

adb_idxrebuild_scan_buff_size

○

△

△

3

adb_idxrebuild_buff_blk_num

○

△

△

4

adb_idxrebuild_sort_buff_size

○

○

△

5

adb_idxrebuild_dvix_rdbuff_size

○

○

○

6

adb_idxrebuild_dvix_wtbuff_size

○

○

○

7

adb_idxrebuild_txt_buff_size

○

○

○

8

adb_idxrebuild_dvbix_rthd_use

×

×

×

（凡例）

○：変更が有効になります。

△：シングルチャンク表では，変更しても無視されますが，スレッド数のチェックは有効になります。マルチチャンク表では，次のチャンクの処理から変更が有効になります。ただし，最後のチャンクの処理中にadbidxrebuildコマンドが中断したときは，変更しても無視されます。

×：指定は無視されます。常にFIXEDが指定されたと仮定して実行されます。なお，サーバ定義adb_cmd_dvbix_rthd_useオペランドが指定されていても，その指定も無視されます。

注※

中断のタイミングについては，次に示す項目を参照してください。

・シングルチャンク表：「表16‒3　adbidxrebuildコマンドの中断タイミングによる再実行機能の適用可否（シングルチャンク表の場合）」

・マルチチャンク表：「表16‒4　adbidxrebuildコマンドの中断タイミングによる再開時の処理（マルチチャンク表の場合）」

16.5.6　adbidxrebuildコマンドの再実行時にエラーが発生した場合

adbidxrebuildコマンドの再実行時にエラーが発生した場合は，次に示す手順で障害原因を特定し，対処してください。

手順

KFAA50244-Eメッセージが出力されているかどうかを確認する

KFAA50244-Eメッセージが出力されている場合は，コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラーが発生しています。--forceオプションを指定してadbidxrebuildコマンドを実行してください。

詳細については，「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

KFAA50244-Eメッセージが出力されていない場合は，手順2.に進んでください。

KFAA50247-Eメッセージが出力されているかどうかを確認する

KFAA50247-Eメッセージが出力されている場合は，作業用一時ファイルに対するアクセスエラーが発生しています。--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。

詳細については，「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

KFAA50247-Eメッセージが出力されていない場合は，手順3.に進んでください。

KFAA50244-EおよびKFAA50247-Eメッセージ以外のメッセージを確認する

出力されたメッセージを確認して，障害原因を特定してください。障害原因の対処を行ったあとで，adbidxrebuildコマンドを実行してください。

(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース

adbidxrebuildコマンドの再実行時にKFAA50247-Eメッセージが出力された場合は，作業用一時ファイルに対するアクセスエラーが発生しています。--create-temp-fileオプションを指定して，adbidxrebuildコマンドを実行してください。

重要

--create-temp-fileオプションは，再実行に必要な作業用一時ファイル（インデクスレコードファイルまたはソート結果用ファイル）が存在しない場合に指定することを想定しています。もし，作業用一時ファイルが存在する場合にadbidxrebuildコマンドを実行すると，存在するファイルは再作成されます。ただし，対象のファイルへの書き込み権限または読み取り権限がないと，adbidxrebuildコマンド実行時にアクセスエラーになることがあります（KFAA30959-Eメッセージ，KFAA40204-Eメッセージ，KFAA40205-Eメッセージ，KFAA40214-Eメッセージ，KFAA41205-Eメッセージ，またはKFAA41206-Iメッセージが出力されます。エラー番号には13(EACCES)が出力されます）。このときは，OSのrmコマンドなどで該当するファイルを削除してから，adbidxrebuildコマンドをもう一度実行してください。

(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース

adbidxrebuildコマンドの再実行時にKFAA50244-Eメッセージが出力された場合は，コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラーが発生しています。

この場合は，次に示す手順で対処してください。

手順

作業用一時ファイルを削除する

次に示すディレクトリ下のファイル（作業用一時ファイル）を，OSのrmコマンドなどで削除してください。書き込み権限または読み取り権限がないファイルがあると，adbidxrebuildコマンドを実行できないことがあります。

前回中断したコマンドの実行時に-wオプションを指定した場合

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ

前回中断したコマンドの実行時に-wオプションを省略した場合

$DBDIR/ADBWORKディレクトリ

--forceオプションを指定してadbidxrebuildコマンドを実行する

--forceオプションを指定してadbidxrebuildコマンドを実行してください。

16.6　注意事項

adbidxrebuildコマンドは，表データの検索にSQL文を使用します。そのため，SQL文の非順序実行方式が適用される環境での実行を推奨します。非順序実行方式が適用される環境については，マニュアルHADB　システム構築・運用ガイドのデータベースの検索処理方式（非順序実行方式）を参照してください。

adbidxrebuildコマンドのオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

ユニークインデクス（主キーに対応するB-treeインデクス，またはCREATE INDEX 文のUNIQUE 指定をしたB-treeインデクス）のキー値の重複があった場合でも，インデクス再作成処理は続行されます。このとき，KFAA61205-Wメッセージ（重複キー値を検出した旨の警告メッセージ）が出力されます。この場合，処理対象表およびB-treeインデクスは一意性制約に違反した状態になっているため，重複しているキー値を検索して，対象の行を削除してください（B-treeインデクスが一意性制約に違反した状態であることを，一意性制約違反状態といいます）。そのあとで，adbidxrebuildコマンドを実行して該当するB-treeインデクスを再作成してください。

adbidxrebuildコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。adbcancelコマンド以外を使用するときは，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。また，adbidxrebuildコマンドを中断したあとは，「16.5　adbidxrebuildコマンドが異常終了したときの対処方法」を参照して，必要に応じてadbidxrebuildコマンドを再実行してください。

実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

インデクス再作成処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbidxrebuildコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のインデクス再作成処理は中断されません（処理が続行されます）。インデクス再作成処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

インデクス再作成処理中に作業用のファイル（作業用一時ファイル）が一時的に作成されます。作業用一時ファイルは，adbidxrebuildコマンドが正常に終了（リターンコードが0または4の場合）した場合は自動的に削除されますが，adbidxrebuildコマンドが正常に終了しなかった場合は削除されないことがあります。

作業用一時ファイルの中には，再実行機能を使用する際に必要となるファイルが含まれています。そのため，再実行機能を使用する前に作業用一時ファイルを削除しないでください。削除すると，再実行機能が正しく実行されません。

作業用一時ファイルがディスク容量を圧迫するおそれがあるため，次に示す場合は，作業用一時ファイルを定期的に削除することを推奨します。

adbidxrebuildコマンドを再実行する必要がない場合

adbimportコマンドを再実行する必要がない場合

これらの場合は，次に示すディレクトリ下に作業用一時ファイルが残っていないかを定期的に確認し，ファイルがあるときは削除してください。

$DBDIR/ADBSYS/ADBUTL

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ（-wオプションを省略した場合は$DBDIR/ADBWORK）

adbimportコマンドからのインデクス作成処理の引き継ぎについて，次の表に示します。

表16‒7　adbimportコマンドからのインデクス作成処理の引き継ぎ

項番

中断したコマンド※1

中断後に実行するコマンド

処理が引き継がれるかどうか

コマンド名

オプションの指定

--create-temp-fileオプション

--forceオプション

1

adbimport

adbidxrebuild

指定あり

指定なし

○※2，※3

2

指定なし

指定あり

○※2，※4，※5

3

指定なし

指定なし

×

（凡例）

○：インデクス作成処理を引き継ぐことができます。

×：インデクス作成処理を引き継ぐことができません（KFAA50201-Eメッセージが出力されます）。

注※1

中断したコマンドを確認する場合は，adbdbstatusコマンドで表のサマリ情報を出力してください。出力結果の「Rerun_command」列に中断したコマンド名が出力されています。adbdbstatusコマンドについては，「13.　adbdbstatus（データベースの状態解析）」を参照してください。

なお，adbimportコマンドの中断後に実行したadbidxrebuildコマンドが中断した場合は，「Rerun_command」列に「adbidxrebuild」が表示されます。中断したadbidxrebuildコマンドに--create-temp-fileオプションを指定していたときは，--create-temp-fileオプションを指定してadbidxrebuildコマンドをもう一度実行してください。このとき，コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）にはadbimportコマンドが中断したときの情報が記憶されているため，adbimportコマンドが中断したときの処理中のチャンクについて，インデクスが再作成されます。

注※2

adbidxrebuildコマンドを実行すると，処理対象表に定義したすべてのインデクスが再作成されます。adbidxrebuildコマンドの-iオプションは指定しても無視されます。

注※3

adbimportコマンドの再実行時にKFAA50247-Eメッセージが出力された場合（作業用一時ファイルが存在しない場合）は，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。そうすると，インデクス作成処理を引き継ぐことができます。

注※4

adbimportコマンドが中断した状態で処理対象表にインデクスを定義し，adbimportコマンドの再実行時にKFAA50209-Eメッセージが出力された場合（未完状態のインデクスが存在する場合）は，--forceオプションを指定してadbidxrebuildコマンドを実行すると，インデクス作成処理を引き継ぐことができます。

未完状態のインデクスを確認する場合は，adbdbstatusコマンドでインデクスのサマリ情報を出力して，出力結果の「Unfinished」列を確認してください。インデクスが未完状態の場合，出力結果の「Unfinished」列に，「unfinished」が出力されます。adbdbstatusコマンドについては，「13.　adbdbstatus（データベースの状態解析）」を参照してください。

なお，adbimportコマンドが中断していない場合は，--forceオプションを指定しないでadbidxrebuildコマンドを実行してください。

注※5

adbimportコマンドの中断時にKFAA50244-Eメッセージが出力された場合（コマンドステータスファイルが存在しない場合）は，--forceオプションを指定してadbidxrebuildコマンドを実行してください。そうすると，インデクス作成処理を引き継ぐことができます。

adbimportコマンド中断後に実行したadbidxrebuildコマンドが中断した場合の注意事項を次に示します。

adbimportコマンド中断後に，--create-temp-fileオプションを指定したadbidxrebuildコマンドが中断したとき

adbidxrebuildコマンドを実行し直すと，--create-temp-fileオプションを指定しなくても，処理が中断したチャンクの表の検索から，インデクス再作成処理が再開されます。ただし，adbidxrebuildコマンドを実行し直すときに--forceオプションを指定すると，--forceオプションの指定が有効になります。

adbimportコマンド中断後に，--forceオプションを指定したadbidxrebuildコマンドが中断したとき

adbidxrebuildコマンドを実行し直すと，--forceオプションを指定しなくてもインデクス再作成処理の初めから強制実行されます。このため，実行時に--create-temp-fileオプションを指定しても，無視されます。インデクス再作成処理の初めから強制実行されるとき，KAFF80215-Iメッセージが出力されます。

adbidxrebuildコマンドのオプションに指定する次のディレクトリおよびファイルの絶対パスが重複しないようにしてください。該当するディレクトリおよびファイルを次に示します。

作業用一時ファイルの格納先ディレクトリ（-wオプションで指定，または-wオプションに指定したディレクトリパスファイルに指定）

作業用一時ファイルの格納先を指定したディレクトリパスファイル（-wオプションで指定）

インデクス識別子ファイル（-iオプションで指定）

インデクス再作成オプションファイル（-zオプションで指定）

また，上記のディレクトリおよびファイルの絶対パスは，adbidxrebuildコマンド以外のプログラムが使用しているディレクトリおよびファイルの絶対パスとも重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。

コマンドまたはAPの実行中にadbidxrebuildコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbidxrebuildコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

このコマンドの実行時間を短縮したい場合は，マニュアルHADB　システム構築・運用ガイドのチューニングのコマンドの実行時間の短縮に関するチューニングのadbidxrebuildコマンドの実行時間の短縮を参照してください。

インデクスの再作成中に，adbidxrebuildコマンドの実行ユーザを削除したり，実行ユーザが持っているREBUILD INDEX権限を取り消したりしないでください。実行ユーザを削除してしまったり，権限を取り消してしまったりした場合，adbidxrebuildコマンドが異常終了した際に，adbidxrebuildコマンドの再実行機能を使用できません。

誤って実行ユーザを削除してしまった場合，または権限を取り消してしまった場合は，次のどちらかの対処をしてください。

同じユーザでadbidxrebuildコマンドを実行できる状態にして，adbidxrebuildコマンドを再実行してください。対処方法については，マニュアルHADB　システム構築・運用ガイドの非定期運用のHADBユーザの管理またはアクセス権限の管理を参照してください。

処理対象表に対するREBUILD INDEX権限を持つ別のユーザで，--forceオプションを指定してadbidxrebuildコマンドを実行してください。

adbidxrebuildコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbidxrebuildコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表16‒8　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

作業用一時ファイルの格納先ディレクトリ※2

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

作業用一時ファイルの格納先を指定したディレクトリパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

インデクス再作成オプションファイル

コマンドの実行ユーザ

読み取り権限

インデクス識別子ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

-wオプションに指定する場合と，作業用一時ファイルの格納先を指定したディレクトリパスファイル内に指定する場合のどちらも該当します。

17　adbimport（データのインポート）

この章では，adbimportコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

17.1　機能

adbimportコマンドの機能，および使用するスレッドについて説明します。

adbimportコマンドは，コマンド実行時にHADBサーバに接続します。

17.1.1　機能概要

adbimportコマンドを実行して表にデータをインポートします。インポート対象の表にレンジインデクスが定義されている場合は，表データのインポート中にレンジインデクスが作成されます。また，インポート対象の表にB-treeインデクスやテキストインデクスが定義されている場合は，表データのインポートが完了したあとにB-treeインデクスやテキストインデクスが作成されます（インポート対象表に主キーが定義されている場合は，表データのインポートが完了したあとに，主キーに対応するB-treeインデクスが作成されます）。

これら一連の処理をデータインポート処理といいます。データインポート処理の概要を次の図に示します。

図17‒1　データインポート処理の概要

［説明］

adbimportコマンドを実行すると，入力データファイル中のデータが表に格納されます。

インポート対象表がローストア表の場合は，入力データファイル中のデータがローストア形式でデータベースに格納されます。インポート対象表がカラムストア表の場合は，入力データファイル中のデータがカラムストア形式でデータベースに格納されます。

なお，インポート対象表がカラムストア表の場合，各列のデータは圧縮されてデータベースに格納されます。列データの圧縮方式には複数の方式があり，入力データファイル中のデータを基に，HADBサーバが自動的に圧縮方式を選択します。ただし，カラムストア表の定義時に列データの圧縮方式を指定した場合は，指定した圧縮方式で列のデータが圧縮されます。

メモ

ローストア表とカラムストア表については，マニュアルHADB　システム構築・運用ガイドのローストア表とカラムストア表を参照してください。

列データの圧縮方式の種類については，マニュアルHADB　システム構築・運用ガイドのローストア表とカラムストア表の選択基準のカラムストア表の列データの圧縮方式を参照してください。

表にレンジインデクスが定義されている場合は，セグメント内の表データの格納が完了したときにレンジインデクスが作成されます。表にB-treeインデクスまたはテキストインデクスが定義されている場合は，表データのインポートが完了したあとに続けてB-treeインデクスまたはテキストインデクスが作成されます（インポート対象表に主キーが定義されている場合は，表データのインポートが完了したあとに，主キーに対応するB-treeインデクスが作成されます）。

各ファイルについて次に説明します。

入力データファイル

インポートするデータを格納しているファイルです。入力データファイルは次のどちらかの形式で作成する必要があります。

CSV形式

固定長形式

CSV形式については，「17.5　入力データファイルの形式（CSV形式の仕様）」を参照してください。

固定長形式については，「17.6　入力データファイルの形式（固定長形式の仕様）」を参照してください。

また，入力データファイルには，次に示す圧縮したファイルも使用できます。

GZIP形式で圧縮したCSV形式のファイル

GZIP形式で圧縮した固定長形式のファイル

そのほかの形式で圧縮したファイルは，使用できません。入力データファイルの圧縮形式の詳細については，「17.7　入力データファイルの圧縮形式」を参照してください。

メモ

インポート対象表がローストア表またはカラムストア表のどちらであっても，入力データファイルの形式は同じになります。

入力データパスファイル

入力データファイルの格納場所のパス名一覧を指定するファイルです。

インポートオプションファイル

adbimportコマンドの実行環境を設定するオプションを指定したファイルです。論理エラーデータファイルの出力先などを指定します。

列構成情報ファイル

インポート対象表と入力データの関係について指定するファイルです。入力データと，インポート対象表の列定義の並び順や列数が異なる場合などに指定します。

作業用一時ファイル

データインポート処理中に一時的に作成される作業用のファイルです。作成された作業用一時ファイルは，データインポート処理が正常終了すると自動的に削除されます。

表にB-treeインデクスまたはテキストインデクスが定義されている場合，インデクスのデータを格納したインデクスレコードファイルや，インデクスレコードファイルのデータをソートしたソート結果用ファイルなどが作業用一時ファイルとして作成されます。

論理エラーデータファイル

入力データファイル中の論理エラーデータ（データ長が正しくないデータなど）を出力するファイルです。論理エラーデータファイルの詳細については，「17.1.2　adbimportコマンドのオプション機能」の「(1)　論理エラーデータの出力機能」で説明します。

17.1.2　adbimportコマンドのオプション機能

adbimportコマンドには，次に示すオプション機能があります。

論理エラーデータの出力機能

B-treeインデクスとテキストインデクス作成処理からの再実行機能

バックグラウンドインポート機能

B-treeインデクス作成用スレッド数の調整機能

(1)　論理エラーデータの出力機能

データをインポートする際，正常なデータだけがインポートされ，不正なデータ（論理エラーデータ）はインポートされません。論理エラーデータを含む行のデータは，論理エラーデータファイルに出力されます。ファイルに出力された論理エラーデータを修正したあとに，adbimportコマンドを再実行して，修正したデータをインポートできます。

論理エラーデータの出力機能の概要を次の図に示します。

図17‒2　論理エラーデータの出力機能の概要

■論理エラーデータとは

論理エラーデータとは，次に示すデータのことです。

データ長が不正なデータ

不正な囲み文字が指定されているデータ

入力データの変換処理中にエラーが発生したデータ

インポート対象の入力データが存在しない場合

入力データの列数が，表の列数より多いまたは少ない場合

非ナル値制約の列のデータに空文字列※がある場合

入力データファイルの書式が不正の場合

注※

空文字列とは，入力データ中でフィールドデータの値が存在しない空の文字列のことです。

(2)　B-treeインデクスとテキストインデクス作成処理からの再実行機能

データインポート処理では，表データのインポートが完了したあとにB-treeインデクスおよびテキストインデクスを作成します。B-treeインデクスおよびテキストインデクスの作成処理中にadbimportコマンドが異常終了するなどした場合，adbimportコマンドの再実行時にB-treeインデクスおよびテキストインデクスの作成処理からデータインポート処理を再開します。そのため，データインポート処理の再実行に掛かる時間を短縮できます。

B-treeインデクスとテキストインデクス作成処理からの再実行機能の概要を次の図に示します。

図17‒3　B-treeインデクスとテキストインデクス作成処理からの再実行機能

注※

次の順序でインデクスの作成処理が実行されます。

インデクスレコードのソート処理

1.のソート処理結果を入力情報にしてインデクスを作成

2.の処理中にadbimportコマンドが中断した場合，再実行機能が適用されます。adbimportコマンドを再実行すると，2.の処理から再開されます。

なお，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，1.の処理中にadbimportコマンドが中断したときも，再実行機能が適用されます。adbimportコマンドを再実行すると，1.の処理から再開されます。

B-treeインデクスとテキストインデクス作成処理からの再実行機能は，次に示すすべての条件を満たす場合に適用されます。

次に示すインデクスのどちらか，または両方がインポート対象表に定義されている※

B-treeインデクス（インポート対象表に主キーが定義されている場合も含む）

テキストインデクス

注※

adbimportコマンドの再実行前に，処理対象表のB-treeインデクスおよびテキストインデクスをすべて削除した場合は，コマンドの終了処理だけが実行されます。

インデクスレコードのソート処理が完了している（ソート処理が完了するとKFAA80220-Iメッセージが出力されます）

ただし，サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，表データのインポートが完了している（表データのインポートが完了するとKFAA80203-Iメッセージが出力されます）

次に示すどれかの理由で処理が中断している

adbimportコマンドが異常終了した

adbcancelコマンドでadbimportコマンドを強制終了した

adbstop --forceコマンドでHADBサーバを強制終了した

OSのkillコマンド，電源断などでサーバプロセスを強制終了した

なお，--forceオプションを指定してadbimportコマンドを再実行したときは，データインポート処理の初めから強制実行されるため，B-treeインデクスとテキストインデクス作成処理からの再実行機能は適用されません。

(3)　バックグラウンドインポート機能

バックグラウンドインポート機能を適用すると，同一の表に対してデータ検索とインポートが同時に実行できます（バックグラウンドインポート中のデータは検索の対象外となります）。

バックグラウンドインポート機能の概要を次の図に示します。

図17‒4　バックグラウンドインポート機能の概要

バックグラウンドインポート機能は，次のすべての条件を満たす場合に適用されます。

インポート対象表の定義時にCHUNKを指定している（インポート対象表はマルチチャンク表である）

データインポートを追加モードで実行している（adbimportコマンドの-dオプションを省略している）

adbimportコマンドの-bオプションを指定している

これまでに表に作成されたチャンク数，およびバックグラウンドインポートで作成されるチャンク数の合計が，表定義時のCHUNKの指定値を超えていない

注

バックグラウンドインポート実行中に，次の情報がメッセージログファイルに出力されます。

表に作成できる残りのチャンク数

バックグラウンドインポート実行中に作成されたチャンクのチャンクID

メモ

■待機状態のチャンクを作成するバックグラウンドインポート

バックグラウンドインポートで，インポートしたデータを操作系SQLの対象外としたい場合は，-bオプションだけでなく，--status waitオプションも指定してください。バックグラウンドインポートで，待機状態のチャンクに対してデータがインポートされます。

なお，待機状態のチャンクに対して，操作系SQLのPURGE CHUNK文とTRUNCATE TABLE文は実行できます。

(4)　B-treeインデクス作成用スレッド数の調整機能

B-treeインデクス作成用スレッド数の調整機能とは，B-treeインデクスの作成処理時間の短縮よりもB-treeインデクスのデータの格納効率を優先して，B-treeインデクスの作成処理を実行する機能です。

この機能を有効にすると，データのサイズや件数などに応じて，B-treeインデクスの作成処理で使用される処理リアルスレッド数がHADBサーバによって自動的に変更されます。B-treeインデクスの作成処理で使用される処理リアルスレッド数は，「使用可能な最大数」と「1」のどちらかとなります。データのサイズが小さい場合や件数が少ない場合，使用される処理リアルスレッド数は，1に調整されます。

なお，複数のB-treeインデクスの作成処理が実行される場合，インデクスごとに使用される処理リアルスレッド数をHADBサーバが決定します。

B-tree インデクス作成用スレッド数の調整機能を有効にする場合，次のコマンドオプションを指定します。

adbimportコマンドのadb_import_dvbix_rthd_useオプション

adbidxrebuildコマンドのadb_idxrebuild_dvbix_rthd_useオプション

adbmergechunkコマンドのadb_mergechunk_dvbix_rthd_useオプション

コマンドオプションの詳細については，各コマンドのオプションの説明を参照してください。

メモ

B-treeインデクスの作成処理で，B-treeインデクスごとに使用される処理リアルスレッド数は，KFAA52002-Iメッセージに出力されます（作成されるB-treeインデクスごとにメッセージが出力されます）。

この機能は，B-treeインデクスに対してだけ有効です。レンジインデクスおよびテキストインデクスの作成処理には影響しません。コマンドの動作は，この機能を有効にしなかった場合と同じです。

この機能を有効にしなかった場合，B-treeインデクスの作成処理時間の短縮を優先してB-treeインデクスを作成します。そのため，B-treeインデクスの作成処理は，データのサイズや件数に関係なく，使用可能な処理リアルスレッドを最大限に使用して並列に処理されます。この場合，データのサイズが小さかったり件数が少なかったりすると，この機能を有効にしたときと比べてB-treeインデクスの格納効率が悪くなることがあります。

■機能を有効にしたときのメリット

この機能を有効にすると，データのサイズが小さい場合や件数が少ない場合に，B-treeインデクス作成処理で使用する処理リアルスレッド数が1に調整されます。使用する処理リアルスレッド数が減ることによって，B-treeインデクスのデータを格納するセグメント数が減るため，B-treeインデクスのデータの格納効率が向上します。

メモ

この機能を有効にした場合，B-treeインデクスの作成処理の初期処理でB-treeインデクスごとに数MB程度のメモリを使用して，B-treeインデクスの容量の見積もり処理を行います。そのため，次のようにコマンドの実行時間が長くなることがあります。

adbimportコマンドまたはadbmergechunkコマンドの場合

コマンドの実行時間が，処理対象表に定義されているB-treeインデクスごとに1秒程度長くなることがあります。

adbidxrebuildコマンドの場合

コマンドの実行時間が，処理対象のチャンクそれぞれについて再作成対象であるB-treeインデクスごとに1秒程度長くなることがあります。

なお，B-treeインデクスのインデクス構成列の長さ（複数列インデクスの場合はインデクス構成列の合計長）が短い場合は，コマンドの実行時間が上記より長くなることがあります。

■機能を有効にする際の目安

データのサイズや件数などによってはB-treeインデクスのデータの格納効率が向上することがあるため，この機能を有効にすることを推奨します。

定義予定のB-treeインデクス，または既存のB-treeインデクスに効果があるかどうか詳細な目安を次に示します。

この機能は，コマンド実行時に追加するデータに対して作成されるB-treeインデクスの下位ページ用のセグメント容量が64MB以下のときに，より効果が見込めます。したがって，処理対象表に定義されているB-treeインデクスのうち，コマンドによって作成されるB-treeインデクスの下位ページ用のセグメント容量が64MBを超えないものが1つ以上ある場合が，この機能を有効にする目安となります。例えば，1日に何度もインポート処理を実行し，そのうちの何回かは，作成されるB-treeインデクスの下位ページ用のセグメントの容量が64MB以下になる場合，この機能を有効にすることでB-treeインデクスのデータの格納効率の向上が期待できます。一方で，コマンド実行時に作成される各B-treeインデクスの下位ページ用のセグメント容量が常に64MBを超える運用の場合，この機能を有効にしてもB-treeインデクスのデータの格納効率の向上はあまり期待できません。

メモ

B-treeインデクスの下位ページ用のセグメント容量については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの総ページ数の求め方の変数SGIDXおよびPGIDXの求め方（シングルチャンク表の場合）および変数SGIDXおよびPGIDXの求め方（マルチチャンク表の場合）の変数SGIDXの計算式を参考にして，下位ページ用セグメントで使用するページ数およびセグメント数を求めてください。その値を基にB-treeインデクスの下位ページ用のセグメント容量を算出してください。

すでに作成されたB-treeインデクスを基に判断する場合，adbdbstatusコマンドで出力される情報から，B-treeインデクスごとの下位ページ用セグメントの使用中ページの容量を求めてください。求めた容量のうち64MB以下のものが1つ以上ある場合を，この機能を有効にする目安としてください。

adbdbstatusコマンドで出力される情報については，「13.7　DBエリア，表とインデクスの使用量情報で出力される項目」を参照してください。

■制限事項

処理対象表がアーカイブマルチチャンク表の場合，この機能は有効になりません。

adbimportコマンドのB-treeインデクス作成処理からの再実行機能によって，B-treeインデクスの作成処理からデータインポート処理が再開した場合，この機能は有効になりません。前回のadbimportコマンド実行時に，この機能を有効にする指定をしていても有効になりません。

adbimportコマンドのB-treeインデクス作成処理からの再実行機能については，「17.1.2　adbimportコマンドのオプション機能」の「(2)　B-treeインデクスとテキストインデクス作成処理からの再実行機能」を参照してください。

adbidxrebuildコマンドの再実行機能によって，B-treeインデクスの再作成処理を再開した場合，この機能は有効になりません。前回のadbidxrebuildコマンド実行時に，この機能を有効にする指定をしていても有効になりません。

adbidxrebuildコマンドの再実行機能については，「16.1.3　adbidxrebuildコマンドのオプション機能」の「(1)　再実行機能」を参照してください。

■サーバ定義との関係

サーバ定義adb_cmd_dvbix_rthd_useオペランドの値は，この機能の対象となるコマンドオプションを省略した場合のデフォルト値となります。そのため，サーバ定義adb_cmd_dvbix_rthd_useオペランドにこの機能を有効にする指定をした場合，この機能の対象となるコマンドオプションを省略してコマンドを実行しても，この機能が有効になります。

サーバ定義adb_cmd_dvbix_rthd_useオペランドについては，マニュアルHADB　システム構築・運用ガイドのコマンドに関するオペランド（set形式）を参照してください。

この機能の対象となるコマンドオプションを指定した場合は，コマンドオプションの指定値の方が，サーバ定義adb_cmd_dvbix_rthd_useオペランドの値よりも優先されます。

■留意事項

この機能を有効にした場合，ごくまれに検索性能に軽微な影響が出ることがあります。その場合は，この機能を有効にしないで（FIXEDを指定して）B-treeインデクスを再作成してください。

B-treeインデクスの作成処理で使用される処理リアルスレッド数が1に調整されるかどうかは，データのサイズや件数によって決まります。そのため，この機能を有効にしても，すべてのB-treeインデクスの作成処理で，使用される処理リアルスレッド数に使用可能な最大数が適用されて実行されることもあります。

17.1.3　adbimportコマンドが使用するスレッドの関係

adbimportコマンドは，次の処理で処理リアルスレッドを使用します。

表データのインポート，レンジインデクスの作成・メンテナンス，および作業用一時ファイルの作成

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，インポートオプションadb_import_rthd_numの指定値またはデフォルト値となります。インポートオプションadb_import_rthd_numのデフォルト値については，「17.2.2　インポートオプションの形式」の「(2)　指定形式の説明」の「(b)　性能に関するオプション」にある，インポートオプションadb_import_rthd_numを参照してください。

B-treeインデクスおよびテキストインデクスのレコードのソート

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスの作成・メンテナンス

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1～処理3は順に実行されます。処理4は，処理1～処理3の実行中，常に実行されます。

adbimportコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図17‒5　adbimportコマンドが処理リアルスレッドを使用する処理

17.2　adbimportコマンドの指定形式

adbimportコマンドの指定形式，インポートオプションの形式，および列構成情報オプションの形式について説明します。

adbimportコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

17.2.1　指定形式およびオプションの説明

入力データファイルの形式によって，次のオプションの指定値や指定の有無が異なります。データインポートしたい入力データファイルに従って，必要なオプションを指定してください。各オプションの詳細については，「-f」，「-r」，「-k」，および「-s」を参照してください。

入力データファイルがCSV形式の場合

-fオプションを省略，または-fオプションにcsvを指定します。

インポート対象表と入力データの関係に応じて，-rオプションを指定します。

-kオプション，および-sオプションを指定できます。

入力データファイルが固定長形式の場合

-fオプションにfixを指定します。

-rオプションを必ず指定します。

-kオプション，および-sオプションは指定しないでください。

(1)　指定形式

adbimport
    -u 認可識別子
  〔-p パスワード〕
  〔-d〕
  〔-k ｛囲み文字｜none｝〕
  〔-s ｛区切り文字｜tab｝〕
  〔-g データインポート処理の経過メッセージの出力間隔〕
  〔-w ｛作業用一時ファイルの格納先ディレクトリ名
        ｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕
  〔-z インポートオプションファイル名〕
  〔-e〕
  〔--force〕
  〔-b〕
  〔--status wait〕
  〔-m チャンクに設定するコメント〕
  〔-f ｛csv｜fix｝〕
  〔-r 列構成情報ファイル名〕
  〔--timeout タイムアウト時間〕
  処理対象表
  入力データパスファイル名

重要

処理対象表および入力データパスファイル名は，必ずオプションの最後に指定してください。指定の順序も処理対象表，入力データパスファイル名の順にしてください。

(2)　データインポートの実行パターンと指定するオプションの関係（データを追加するチャンクの種類）

実行したいデータインポートのパターンによって，指定するオプションの組み合わせが異なります。

なお，マルチチャンク表に対してデータをインポートする場合，-dオプションおよび-bオプションの指定によって，データを追加するチャンクが変わります。また，-bオプションと--status waitオプションを同時に指定すると，待機状態のチャンクが作成されてデータが追加されます。

メモ

チャンクについては，マニュアルHADB　システム構築・運用ガイドのデータインポート単位のデータ管理（チャンク）を参照してください。

データインポートの実行パターンと指定するオプションの関係（データを追加するチャンクの種類）を次の表に示します。

各オプションの詳細については，「(3)　オプションの説明」の「-d」，「-b」および「--status wait」の説明を参照してください。

表17‒1　データインポートの実行パターンと指定するオプションの関係（データを追加するチャンクの種類）

項番

データインポートの実行パターン

指定するオプション

マルチチャンク表に対してデータをインポートする場合に，データを追加するチャンク※1

-dオプション

-bオプション

--status waitオプション

1

新規に定義した表に対してデータをインポートしたい

×

×

×

カレントチャンク

2

既存の表に対して，バックグラウンドインポートを適用しないでデータをインポートしたい

×

×

×

カレントチャンク

3

既存の表に対して，バックグラウンドでデータをインポートしたい※2

インポートが完了したデータのチャンクを操作系SQLの対象にしたい（通常状態のチャンクにしたい）

×

○

×

バックグラウンドインポートで新規に作成された通常状態のチャンク

4

インポートが完了したデータのチャンクを操作系SQLの対象外にしたい（待機状態のチャンクにしたい）※3

×

○

○

バックグラウンドインポートで新規に作成された待機状態のチャンク※4

5

既存の表のデータをすべて削除したあとで，新しいデータをインポートしたい

○

×

×

新規に作成されたチャンク（作成モードでデータをインポートするため，既存のチャンクはすべて削除されます）

（凡例）

○：オプションを指定します。

×：オプションを指定しません。

注

-dオプションと-bオプションを同時に指定すると，エラーになります。

また，-bオプションを指定しないで--status waitオプションを指定すると，エラーになります。

注※1

-mオプションを指定すると，データを追加するチャンクにコメントを設定できます。

注※2

シングルチャンク表の場合，エラーとなります（シングルチャンク表に対して，バックグラウンドインポートを適用できません）。

注※3

ただし，PURGE CHUNK文およびTRUNCATE TABLE文は実行できます。

注※4

待機状態のチャンクは，カレントチャンクになりません。

(3)　オプションの説明

各オプションの説明で，【マルチチャンク表】と表記されているオプションは，マルチチャンク表に対してデータをインポートする際に指定できるオプションです。シングルチャンク表に対してデータをインポートする際には指定できません。

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbimportコマンドを実行するHADBユーザの認可識別子を指定します。adbimportコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するIMPORT TABLE権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

重要

B-treeインデクスとテキストインデクス作成処理からの再実行機能を使用する場合，-uオプションに指定する認可識別子を変更することはできません。そのため，データインポート中に，adbimportコマンドの実行ユーザを削除したり，IMPORT TABLE権限を取り消したりしないでください。

誤って操作してしまった場合は，次のどちらかの対処をしてください。

同じユーザでadbimportコマンドを実行できる状態にして，adbimportコマンドを再実行してください。対処方法については，マニュアルHADB　システム構築・運用ガイドの非定期運用のHADBユーザの管理またはアクセス権限の管理を参照してください。

処理対象表に対するREBUILD INDEX権限を持つ別のユーザで，--forceオプションを指定してadbidxrebuildコマンドを実行してください。

--forceオプションを指定してadbidxrebuildコマンドを実行する方法および注意事項については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbimportコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-d

データインポート処理を作成モードで実行する場合に指定します。このオプションを省略した場合は，追加モードでデータインポート処理が行われます。

作成モードの場合は，表の既存データをすべて削除してから，入力データがインポートされます。追加モードの場合は，表の既存データを残したまま，入力データがインポートされます。

なお，新規に定義した表にデータをインポートする場合は，このオプションを指定する必要はありません。

メモ

クラウドストレージ機能を使用している場合，追加モードでデータインポート処理は実行できません。

●-k ｛囲み文字｜none｝

〜〈文字列〉((1バイト))《"》

入力データファイルのファイル形式がCSV形式の場合に，このオプションの指定を検討してください。固定長形式の場合は，このオプションを指定しないでください。

入力データファイル中のフィールドデータを囲んでいる囲み文字を指定します。このオプションを省略した場合は，囲み文字として二重引用符（"）が仮定されます。

なお，入力データファイル中のフィールドデータに囲み文字を使用していない場合は，このオプションにnoneを指定してください。

指定規則を次に示します。

囲み文字として指定できる文字は，1バイト文字だけです。2バイト以上の文字列は指定できません。

次に示す文字も囲み文字として指定できません。

空白，タブ，アスタリスク（*）

区切り文字（-sオプションの指定値または省略値）と同じ文字

アポストロフィ（ ' ）を囲み文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を囲み文字として指定する場合の例

adbimport …　-k "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を囲み文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を囲み文字として指定する場合の例

adbimport …　-k "|" …

インポート対象表に数データ，日時データまたはバイナリデータが定義されている場合，囲み文字に数データ，日時データまたはバイナリデータで扱う文字を指定しないでください。指定すると，入力データの変換エラーとなることがあります。

インポート対象表に配列型の列が定義されている場合，囲み文字に波括弧（{}）を指定しないでください。指定すると，入力データの変換エラーとなることがあります。

重要

このオプションを指定する場合，-fオプションを省略するか，csvを指定してください。-fオプションにfixを指定した場合，adbimportコマンドがエラーになります。

このオプションで囲み文字を指定した場合，囲み文字と同じ文字がフィールドデータ中にあるときは，フィールドデータの文字を2個連続で記述してください。

このオプションにnoneを指定した場合，すべてのデータ型で，入力データの囲み文字はないものとして扱われます。このため，フィールドデータの文字を2個連続で記述する必要はありません。

フィールドデータ中に区切り文字と同じ文字がある場合や，改行コードをデータとして扱いたい場合などには，このオプションにnoneを指定できません。

このオプションの指定による，入力データと格納されるデータの関係を次の表に示します。

表17‒2　入力データと格納されるデータの関係

項番

入力データ

格納されるデータ

-kオプションに囲み文字（二重引用符（"））を指定した場合

-kオプションにnoneを指定した場合

1

ABC,DEF

ABC

DEF

ABC

DEF

2

"ABC""","DEF"

ABC"

DEF

"ABC"""

"DEF"

3

"ABC,DEF"

ABC,DEF

"ABC

DEF"

4

"ABC,DEF

−

"ABC

DEF

5

"ABC","DEF¥n"

ABC

DEF¥n

"ABC"

"DEF

"

（凡例）

−：論理エラーとなります。

●-s ｛区切り文字｜tab｝

〜〈文字列〉((1バイト))《 , 》

入力データファイルのファイル形式がCSV形式の場合に，このオプションの指定を検討してください。固定長形式の場合は，このオプションを指定しないでください。

入力データファイル中のフィールドデータを区切っている区切り文字を指定します。区切り文字にタブを指定する場合は，tabを指定してください。このオプションを省略した場合は，区切り文字としてコンマ（ , ）が仮定されます。

指定規則を次に示します。

区切り文字として指定できる文字は，tabまたは1バイト文字だけです。tab以外の2バイト以上の文字列は指定できません。

次に示す文字も区切り文字として指定できません。

英大文字（A〜Z），英小文字（a〜z），数字（0〜9），下線（_），二重引用符（"），アスタリスク（*）

囲み文字（-kオプションの指定値または省略値）と同じ文字

次に示す文字は入力データの文字コードと重なるおそれがあるため，区切り文字として適していません。

符号（+，-），スラッシュ（/），コロン（:），ピリオド（.），|，¥，[，]，(，)，{，}，~など

アポストロフィ（ ' ）を区切り文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を区切り文字として指定する場合の例

adbimport …　-s "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を区切り文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を区切り文字として指定する場合の例

adbimport …　-s "|" …

インポート対象表に配列型の列が定義されている場合，区切り文字に波括弧（{}）を指定しないでください。指定すると，入力データの変換エラーとなることがあります。

重要

このオプションを指定する場合，-fオプションを省略するか，csvを指定してください。-fオプションにfixを指定した場合，adbimportコマンドがエラーになります。

●-g データインポート処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

データインポート処理の経過メッセージの出力間隔を指定します。例えば，このオプションに2を指定すると，データインポート処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝

〜〈OSパス名〉((2〜518バイト))

データインポート処理時に作成される作業用一時ファイルの格納先を，次に示すどちらかの方法で指定します。

作業用一時ファイルを格納するディレクトリ名を絶対パス名で指定する

作業用一時ファイルを格納するディレクトリを指定したファイル名（ディレクトリパスファイル名）を絶対パス名で指定する

1つのディレクトリ下に格納される作業用一時ファイルに対して入出力が集中すると，性能低下の原因になります。そのため，2の方法で作業用一時ファイルを異なるディスクのディレクトリに格納して，ディスクに対する入出力処理の負荷分散をすることを推奨します。2の方法の指定例（ディレクトリパスファイルの指定例）を次に示します。

ディレクトリパスファイルの指定例

/mnt/diska/wwwww
/mnt/diskb/xxxxx
/mnt/diskc/yyyyy
/mnt/diskd/zzzzz

指定するディレクトリ数の目安を次に示します。

指定するディレクトリ数の目安＝A×B

A：データ格納スレッド数

次の計算式で求めてください。

インポートオプションadb_import_rthd_numの値－1

B：インポート対象表に定義されているB-treeインデクスおよびテキストインデクスの数

B-treeインデクスおよびテキストインデクスの数がわからない場合は，次に示すSQL文で表に定義されているB-treeインデクスおよびテキストインデクスの数を確認してください。

SELECT "N_INDEX"-"N_RANGE_INDEX"
    FROM "MASTER"."SQL_TABLES"
        WHERE "TABLE_SCHEMA"='認可識別子'
           AND "TABLE_NAME"='インポート対象表の表名'

ディレクトリパスファイル中にディレクトリを255個まで指定できます。

ディレクトリパスファイル中に記述されている順番に，作業用一時ファイルの格納先ディレクトリとして使用されます。ディレクトリパスファイル中に記述された最後のディレクトリ（この例では/mnt/diskd/zzzzz）が使用された場合，次に使用されるディレクトリは先頭のディレクトリ（この例では/mnt/diska/wwwww）になります。

このオプションの指定規則（方法1，2の両方の指定規則）を次に示します。

パス名の末尾にスラッシュ（/）を指定しないでください。

-wオプションに指定したディレクトリ下に作成される作業用一時ファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのadbimportコマンド実行時の作業用一時ファイルの容量見積もりを参照してください。なお，このオプションを省略した場合，$DBDIR/ADBWORK下に作業用一時ファイルが作成されます。

作業用一時ファイルを格納するディレクトリは，専用のディレクトリにしてください。ほかのファイルを格納しているディレクトリと重複した場合，既存のファイル中のデータが失われるおそれがあります。作業用一時ファイルの格納先ディレクトリ名と重複しないようにする必要があるファイルについては，「17.11　注意事項」を参照してください。

なお，作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

メモ

作業用一時ファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●-z インポートオプションファイル名

〜〈OSパス名〉((2〜510バイト))

インポートオプションを指定したインポートオプションファイルの絶対パス名を指定します。このオプションを省略すると，インポートオプションファイルが指定されないため，すべてのインポートオプションにデフォルト値が仮定されます。

インポートオプションについては，「17.2.2　インポートオプションの形式」を参照してください。

なお，インポートオプションファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。インポートオプションファイル名と重複しないようにする必要があるファイルについては，「17.11　注意事項」を参照してください。

●-e

通常はこのオプションを省略してください。

入力データの論理エラーを検出した際，データインポート処理を中断する場合にこのオプションを指定します。

このオプションを指定した場合，入力データの論理エラーが検出されると，トランザクションはロールバックします（データは1件もインポートされません）。このとき，リターンコード8が返されます。

このオプションを省略した場合，入力データの論理エラーが検出されると，正常なデータだけがインポートされ，論理エラーとなったデータはインポートされません。このとき，リターンコード4が返されます。

●--force

表に格納されているデータをすべて削除してから，adbimportコマンドを強制実行する場合にこのオプションを指定します。adbimportコマンドの中断後，表のデータをすべて削除してからデータインポート処理を再実行したいとき，このオプションの使用を検討してください。

このオプションを指定しないでadbimportコマンドを再実行した場合，前回のデータインポート処理時に表に格納されたデータは有効になり，再実行時のデータインポート処理はその続きからとなります。

一方，このオプションを指定してadbimportコマンドを再実行した場合，表に格納されているデータはすべて削除され，データインポート処理を最初から行います。

重要

このオプションを指定する場合は，-dオプション（作成モード）を必ず指定してください。-dオプションの指定がない場合，adbimportコマンドがエラーになります。

このオプションと-dオプションを指定してadbimportコマンドを再実行すると，表に格納されているデータがすべて削除されます。このため，表の更新不可状態を解除したい場合に，このオプションを指定しないでください。表の更新不可状態を解除する方法については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートの実表に関するトラブルの実表が更新不可状態になった場合を参照してください。

このオプションを指定してadbimportコマンドを実行する際の手順について説明します。

表に格納されているデータを，adbexportコマンドでファイルに出力してください。

必要に応じて，チャンクごとにデータを出力してください。

adbimportコマンドの前回の実行時に作成された作業用一時ファイルを，OSのrmコマンドなどで削除してください。

次に示すディレクトリ下のファイルを削除してください。書き込み権限または読み取り権限がないファイルがあると，adbimportコマンドが実行できないことがあります。

・前回中断したコマンドの実行時に-wオプションを指定した場合：-wオプションに指定した作業用一時ファイルの格納先ディレクトリ

・前回中断したコマンドの実行時に-wオプションを省略した場合：$DBDIR/ADBWORKディレクトリ

手順1.で出力したファイルを入力データファイルとして，-dオプションと--forceオプションを指定して，adbimportコマンドを実行します。

●-b　　【マルチチャンク表】

バックグラウンドインポートでデータを追加する場合に指定します。このオプションを指定すると，新規に作成されたチャンクにデータを追加します。

このオプションだけを指定した場合，通常状態のチャンクが作成されてデータが追加されます。

このオプションと--status waitオプションを指定した場合，待機状態のチャンクが作成されてデータが追加されます。

マルチチャンク表に対して指定してください。シングルチャンク表に対して指定した場合，エラーとなります。

なお，マルチチャンク表に対する初回インポート時は，このオプションを指定しないでください。指定した場合，表定義時に作成されたチャンクではなく，新規に作成されたチャンクにデータを追加するため，チャンクが1つむだになります。

データを追加するチャンクについては，「(2)　データインポートの実行パターンと指定するオプションの関係（データを追加するチャンクの種類）」を参照してください。

●--status wait　　【マルチチャンク表】

バックグラウンドインポートで，待機状態のチャンクを作成してデータを追加する場合に指定します。待機状態のチャンクに追加されたデータは，操作系SQLの対象外となります（ただし，PURGE CHUNK文およびTRUNCATE TABLE文は実行できます）。

マルチチャンク表に対して指定してください。シングルチャンク表に対して指定した場合，エラーとなります。

重要

このオプションを指定する場合は，-bオプションを必ず指定してください。-bオプションの指定がない場合，adbimportコマンドがエラーになります。

●-m チャンクに設定するコメント　　【マルチチャンク表】

〜〈文字列〉((1〜1,024バイト))

データを追加するチャンクにコメントを設定する場合に指定します。

マルチチャンク表に対して指定してください。シングルチャンク表に対して指定した場合，エラーとなります。

データを追加するチャンクにすでにコメントが設定されている場合は，コメントを上書きします。

データを追加するチャンクについては，「(2)　データインポートの実行パターンと指定するオプションの関係（データを追加するチャンクの種類）」を参照してください。

指定時の規則を次に示します。

指定したコメントは，英大文字と英小文字が区別されます。

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含むコメントを設定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，コメント全体をアポストロフィ（'）で囲んでください。

（例1）-m abc¥|def

（例2）-m 'abc|def'

どちらの場合も，コメントとしてabc|defが設定されます。

文字列を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）および文字列がコメントとして扱われます。

（例）-m '"abcdef"'

この場合，コメントとして"abcdef"が設定されます。

コメントの文字コードは，HADBサーバの環境変数のADBLANGに設定した文字コードと同じになります。

●-f ｛csv｜fix｝

入力データファイルのファイル形式を指定します。このオプションを省略した場合，csvが仮定されます。

csv：CSV形式

fix：固定長形式

CSV形式については，「17.5　入力データファイルの形式（CSV形式の仕様）」を参照してください。

固定長形式については，「17.6　入力データファイルの形式（固定長形式の仕様）」を参照してください。

重要

入力データファイルが固定長形式の場合（このオプションにfixを指定する場合）は，必ず-rオプションを指定してください。-rオプションを省略した場合，adbimportコマンドがエラーになります。

インポート対象の表に配列型の列が定義されている場合は，このオプションにcsvを指定してください。fixを指定すると，adbimportコマンドがエラーになります（KFAA50205-Eメッセージが出力されます）。

●-r 列構成情報ファイル名

〜〈OSパス名〉((2〜510バイト))

列構成情報オプションを指定した列構成情報ファイルを絶対パスで指定します。

列構成情報ファイルとは，インポート対象表と入力データの関係について指定したファイルです。列構成情報オプションの指定形式については，「17.2.3　列構成情報オプションの形式」を参照してください。

入力データファイルのファイル形式，入力データファイル中のフィールドデータの並び順やフィールドデータの数によって，このオプションを指定する必要があるかどうか（列構成情報ファイルが必要かどうか）が異なります。入力データファイルと-rオプションの関係を次の表に示します。

表17‒3　入力データファイルと-rオプションの関係

項番

入力データファイルのファイル形式

入力データファイル中のフィールドデータ

-rオプションの指定

1

CSV形式

次に示す2つの条件を満たす

フィールドデータの並び順が，インポート対象表の列構成の順序と同じ

フィールドデータの数が，インポート対象表の列定義数と同じ

△

2

フィールドデータの並び順が，インポート対象表の列構成の順序と異なる

○

3

フィールドデータの数が，インポート対象表の列定義数と異なる

○

4

フィールドデータに，2進形式のバイナリデータが含まれている

○

5

固定長形式

次に示す2つの条件を満たす

フィールドデータの並び順が，インポート対象表の列構成の順序と同じ

フィールドデータの数が，インポート対象表の列定義数と同じ

○

6

フィールドデータの並び順が，インポート対象表の列構成の順序と異なる

○

7

フィールドデータの数が，インポート対象表の列定義数と異なる

○

8

フィールドデータに，2進形式のバイナリデータが含まれている

○

（凡例）

○：-rオプションを必ず指定してください（インポートには列構成情報ファイルが必要です）。

△：-rオプションの指定は任意です（列構成情報ファイルなしでもインポートできます）。

なお，列構成情報ファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。列構成情報ファイル名と重複しないようにする必要があるファイルについては，「17.11　注意事項」を参照してください。

重要

このオプションの指定を省略する場合，入力データファイルには，次の条件を満たすファイルを指定する必要があります。

ファイル形式がCSV形式である

インポート対象表の列構成の順序と同じ順序でフィールドデータが並んでいる

インポート対象表の列定義数と同じ数のフィールドデータが存在する

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbimportコマンドがタイムアウトになるまでの時間を指定します。

adbimportコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbimportコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbimportコマンドのタイムアウト時間は設定されません。adbimportコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbimportコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbimportコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbimportコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

ワーカーノードの追加処理中

他ノードで実行中のトランザクションの終了待ち中

●処理対象表

データをインポートする表を指定します。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

IMPORT TABLE権限を持っている表を指定できます。

ビュー表は指定できません。

●入力データパスファイル名

〜〈OSパス名〉((2〜510バイト))

入力データパスファイルを絶対パス名で指定します。指定するパス名に半角空白を含む場合は，パス名全体をアポストロフィ（'）で囲んでください。

入力データパスファイルには，入力データファイルの格納場所を指定します。入力データファイルの格納場所は，2〜510バイトの絶対パスで指定してください。パス名として使用できる文字は，入力データパスファイル名と同じです。

1つのディレクトリ下に格納された入力データファイルに対して入力が集中すると，性能低下の原因になります。そのため，入力データファイルは異なるディスクのディレクトリに格納して，ディスクに対する入力処理の負荷分散をすることを推奨します。

入力データパスファイルの指定例を次に示します。

入力データパスファイルの指定例

/mnt/diska/wwwww/imp1.csv
/mnt/diskb/xxxxx/imp2.csv
/mnt/diskc/yyyyy/imp3.csv
/mnt/diskd/zzzzz/imp4.csv

この例では，入力データファイルが4つあるとして，入力データファイルの格納場所をそれぞれ指定しています。

なお，入力データパスファイル名，およびファイル中に指定する入力データファイルの格納場所は，ほかのファイル名と重複しないようにしてください。重複した場合，入力データパスファイル，および入力データファイル中のデータが失われるおそれがあります。入力データパスファイル名，および入力データファイルの格納場所と重複しないようにする必要があるファイルについては，「17.11　注意事項」を参照してください。

メモ

入力データファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

17.2.2　インポートオプションの形式

(1)　指定形式

論理エラーデータの出力に関するオプション
  〔set adb_import_errdata_file_name = 論理エラーデータファイル名〕
  〔set adb_import_errdata_num = 論理エラーデータの出力件数の上限〕
  〔set adb_import_errmsg_lv = ｛0｜1｝〕

性能に関するオプション
  〔set adb_import_rthd_num = adbimportコマンドが使用する処理リアルスレッド数〕
  〔set adb_import_read_size = バッファサイズ〕
  〔set adb_import_buff_blk_num = バッファブロック数〕
  〔set adb_import_sort_buff_size = ソートバッファサイズ〕
  〔set adb_import_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ〕
  〔set adb_import_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ〕
  〔set adb_import_txt_buff_size = テキストインデクスの作成用バッファサイズ〕
  〔set adb_import_decompress_buff_size = GZIP形式で圧縮した入力データファイルの伸長用バッファサイズ〕
  〔set adb_import_dvbix_rthd_use = ｛FIXED｜VARIABLE｝〕

入力データに関するオプション
  〔set adb_import_null_string = ｛DEFAULT｜NULL｝〕

上記のインポートオプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

(a)　論理エラーデータの出力に関するオプション

●adb_import_errdata_file_name = 論理エラーデータファイル名

〜〈OSパス名〉((2〜510バイト))

論理エラーデータファイルのファイル名を絶対パス名で指定します。論理エラーデータファイルには，入力データの論理エラーが発生した行データが出力されます。

このオプションを省略した場合，論理エラーが発生した行データはファイルに出力されません。

なお，論理エラーデータファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。論理エラーデータファイル名と重複しないようにする必要があるファイルについては，「17.11　注意事項」を参照してください。

●adb_import_errdata_num = 論理エラーデータの出力件数の上限

〜〈整数〉((1〜4,294,967,295))《100》

論理エラーデータファイルに出力する論理エラーデータの出力件数の上限を指定します。例えば，このオプションに200を指定した場合，201個目以降の論理エラーデータはファイルに出力されません。

なお，論理エラーデータの個数が，このオプションの指定値を超えても，インポート処理は続行されます。

●adb_import_errmsg_lv = ｛0｜1｝

論理エラーの発生時，論理エラーの原因を示すメッセージを出力するかどうかを指定します。

0：メッセージを出力します。

1：メッセージを出力しません。

このオプションを省略した場合，0が仮定されるため，論理エラーの原因を示すメッセージが出力されます。

１つの論理エラーに対して１つのメッセージが出力されます。そのため，論理エラーが多い場合，出力されるメッセージの数も多くなります。

上記で説明した論理エラーデータの出力に関するオプションは，次の表を参考にして指定してください。

表17‒4　ケース別のインポートオプションの指定の目安

項番

ケース

関連するインポートオプション

説明

1

論理エラーデータを修正し，修正したデータをインポートする場合

adb_import_errdata_file_name

adb_import_errdata_num

左記に示すオプションを指定して，論理エラーデータを論理エラーデータファイルに出力してください。

2

論理エラーデータは必要ない場合（データを修正してインポートする必要がない場合）

adb_import_errdata_file_nameを省略して論理エラーデータが出力されないようにする

adb_import_errmsg_lv = 1を指定して論理エラーの原因を示すメッセージの出力を抑止する

左記に示すようにオプションを指定して，論理エラーデータに関する情報の出力を抑止してください。

論理エラーデータが大量にある場合，論理エラーデータに関する情報が大量に出力され性能に影響を及ぼすことがあります。そのため，左記のようにインポートオプションを指定して，論理エラーデータに関する情報の出力を抑止します。

3

論理エラーデータがあるときに，インポートを中断する場合

インポートオプションを指定する必要はありません。

adbimportコマンドの実行時，-eオプションを指定してください。論理エラーデータが検出された場合，インポートが中断され，トランザクションはロールバックします（入力データは1件もインポートされません）。このとき，リターンコード8が返されます。

-eオプションについては，「17.2.1　指定形式およびオプションの説明」の「(3)　オプションの説明」の「-e」オプションを参照してください。

(b)　性能に関するオプション

●adb_import_rthd_num = adbimportコマンドが使用する処理リアルスレッド数

〜〈整数〉((2〜4,096))

adbimportコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbimportコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbimportコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbimportコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「17.1.3　adbimportコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbimportコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表17‒5　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0または1を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに2以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに2以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbimportコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

重要

バックグラウンドインポートを実行する場合，adb_import_rthd_numの指定値によってデータの格納効率が変わることがあります。データの格納効率を良くするadb_import_rthd_numの指定値の求め方については，マニュアルHADB　システム構築・運用ガイドのマルチチャンク表にデータを格納する方法（バックグラウンドインポート）を参照してください。

●adb_import_read_size = バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

入力データファイルの読み込み処理で使用するバッファのサイズをキロバイト単位で指定します。次に示す値を目安としてください。

（インポートデータのレコード件数×1行当たりの入力データ長）÷10,000

●adb_import_buff_blk_num = バッファブロック数

〜〈整数〉((5〜4,096))《64》

データインポート処理で使用するバッファのブロック数を指定します。

基本的にはデフォルト値のままで問題ありませんが，このオプションの指定値を大きくすると，データインポート処理の性能が向上することがあります。

●adb_import_sort_buff_size = ソートバッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用するソートバッファサイズをメガバイト単位で指定します。

メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_import_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する入力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_import_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する出力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_import_txt_buff_size = テキストインデクスの作成用バッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

インポート対象表にテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，テキストインデクスの作成処理時に使用するバッファサイズをメガバイト単位で指定します。

このオプションの指定値を大きくすると性能向上が見込めます。ただし，テキストインデクスを作成する全処理リアルスレッドで，このオプションで指定したバッファ分のメモリを使用します。このため，このオプションの指定値を大きくするときは注意してください。

●adb_import_decompress_buff_size = GZIP形式で圧縮した入力データファイルの伸長用バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

このオプションには，GZIP形式で圧縮した入力データファイルのデータ伸長時に使用するバッファサイズをキロバイト単位で指定します。

インポートオプションadb_import_read_sizeに指定した値を，このオプションの指定値の目安としてください。

GZIP形式で圧縮した入力データファイルのデータをインポートする際，このオプションに指定した分だけ，圧縮したデータを伸長するためのバッファを使用します。

●adb_import_dvbix_rthd_use = ｛FIXED｜VARIABLE｝

〜《サーバ定義adb_cmd_dvbix_rthd_useオペランドの値》

インポート対象表にB-treeインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスを作成する際，B-treeインデクス作成用スレッド数の調整機能を有効にするかどうかを指定します。B-treeインデクス作成用スレッド数の調整機能については，「17.1.2　adbimportコマンドのオプション機能」の「(4)　B-treeインデクス作成用スレッド数の調整機能」を参照してください。

FIXED：B-treeインデクス作成用スレッド数の調整機能を有効にしません。

B-treeインデクスの作成処理は，使用可能な処理リアルスレッドを最大限に使用して，並列に処理されます。B-treeインデクスのデータの格納効率よりも，B-treeインデクスの作成処理時間の短縮を優先する場合に指定してください。

使用される処理リアルスレッド数は，「adb_import_rthd_numオプションの指定値※ - 1」になります。

注※

adb_import_rthd_numオプションの指定を省略した場合は，「表17‒5　コマンド実行時に使用する処理リアルスレッド数」に従ってadb_import_rthd_numオプションの値が決まります。

VARIABLE：B-treeインデクス作成用スレッド数の調整機能を有効にします。

B-treeインデクスの作成処理は，データのサイズや件数などに応じて，使用される処理リアルスレッド数を変更して処理されます。B-treeインデクスの作成処理時間の短縮よりも，B-treeインデクスのデータの格納効率を優先する場合に指定してください。

使用される処理リアルスレッド数は，「1」または「このオプションにFIXEDを指定したときに使用される処理リアルスレッド数」のどちらかになります。

B-treeインデクス作成用スレッド数の調整機能は，次の条件下で有効になります。

作成モードでデータインポートを実行する場合（-dオプションを指定する場合）

バックグラウンドインポートを実行する場合（-bオプションを指定する場合）

データ格納件数が0件の表に対して-dオプションを省略してデータインポートを実行する場合

CREATE TABLE文で表を定義した直後，またはTRUNCATE TABLE文で表の全データを削除した直後のデータインポートが該当します。

上記以外では，このオプションにVARIABLEを指定してもB-treeインデクス作成用スレッド数の調整機能は有効になりません。

(c)　入力データに関するオプション

●adb_import_null_string = ｛DEFAULT｜NULL｝

表定義時にDEFAULT句を指定した列に格納する入力データが空文字列の場合に，列の既定値を格納するか，またはナル値を格納するかを指定します。

DEFAULT：

列の既定値が格納されます。列の既定値については，次に示す項目を参照してください。

マニュアルHADB　SQLリファレンスの構成要素のDEFAULT句のDEFAULT句の指定形式および規則

マニュアルHADB　システム構築・運用ガイドのデータベースの設計の表の設計の列の既定値の設定（DEFAULT句）

NULL：

ナル値が格納されます。

このオプションを省略した場合，DEFAULTが仮定されるため，入力データが空文字列のときは列の既定値が格納されます。

入力データに空文字列を指定する方法については，「17.5.3　フィールドデータの記述形式（CSV形式）」または「17.6.3　フィールドデータの記述形式（固定長形式）」を参照してください。

17.2.3　列構成情報オプションの形式

列構成情報ファイルに指定する，列構成情報オプションについて説明します。

列構成情報オプションを指定する場合（列構成情報ファイルが必要な場合）は，adbimportコマンドの-rオプションに列構成情報ファイル名を指定します。-rオプションの詳細については，「-r」を参照してください。

(1)　指定形式

入力データファイルのファイル形式がCSV形式の場合

｛｛adbcolumninfo
    -n 列名
    〔-r ｛フィールドデータ番号｜empty_string｝〕
    〔-b ｛hex｜bin｝〕
｝｝

入力データファイルのファイル形式が固定長形式の場合

set adb_import_input_record_size = 入力レコード長

｛｛adbcolumninfo
    -n 列名
    -p 先頭位置,長さ
    〔-c 空文字列とするための比較値〕
    〔-b ｛hex｜bin｝〕
｝｝

上記の指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　列構成情報オプションと入力データファイルのファイル形式の関係

列構成情報ファイルに指定する列構成情報オプションは，入力データファイルのファイル形式によって異なります。列構成情報オプションと入力データファイルのファイル形式の関係を次の表に示します。

各オプションおよびオペランドの詳細については，「(3)　指定形式の説明」を参照してください。

表17‒6　列構成情報オプションと入力データファイルのファイル形式の関係

項番

オプション名またはオペランド名

入力データファイルのファイル形式

CSV形式

固定長形式

1

adb_import_input_record_sizeオペランド

×

◎

2

adbcolumninfoオペランド

○

◎

3

adbcolumninfoオペランドを指定する場合

-nオプション

◎

◎

4

-pオプション

×

◎

5

-cオプション

×

○

6

-rオプション

○

×

7

-bオプション

○

○

（凡例）

◎：オプションまたはオペランドを必ず指定します。

○：オプションまたはオペランドを指定できます。

×：オプションまたはオペランドは指定できません。

(3)　指定形式の説明

(a)　set形式

●adb_import_input_record_size = 入力レコード長

〜〈整数〉((1〜536,870,912))（単位：バイト）

入力データファイルのファイル形式がCSV形式の場合，このオプションは指定できません。

入力データファイルのファイル形式が固定長形式の場合に，入力データファイルのレコード長（1行のデータ長）を指定します。

レコードに改行コードが含まれる場合は，改行コードのバイト数も含めた値を指定してください。

(b)　コマンド形式

●adbcolumninfo

このオペランドには，処理対象表に定義してある列単位で入力データの扱い方を指定します。

入力データファイルのファイル形式がCSV形式の場合，このオペランドの指定は省略できます。

入力データファイルのファイル形式が固定長形式の場合は，このオペランドを1個以上，指定してください。

このオペランドの指定数は，処理対象表に定義してある列数以下にしてください。

ただし，処理対象表に定義してある列をすべてこのオペランドで指定する必要はありません。このオペランドで指定しない列には，次に示すデータが入力データとして仮定されます。

入力データファイルのファイル形式がCSV形式の場合

列の定義順と同じフィールドデータ番号のデータが仮定されます。

フィールドデータ番号とは，1入力レコード中のフィールドデータの並び順に割り振られる番号のことです。入力レコードの先頭のフィールドデータの番号を1として，順番にカウントします。フィールドデータが空文字列の場合も，1つとしてカウントします。

入力データファイルのファイル形式が固定長形式の場合

空文字列が仮定されます。

-n 列名

〜〈文字列〉((1〜100バイト))

処理対象表に定義している列名を指定します。

注意事項を次に示します。

列名に空白が含まれる場合は，"（二重引用符）で囲んでください。

（例）"C△1"

（凡例）△：空白

列名に英小文字が含まれる場合，¥"（バックスラッシュと二重引用符）で列名を囲んでください。¥"で囲まないと，列名の文字列はすべて英大文字と見なされます。

（例）¥"c1¥"

また，列名に英小文字および空白が含まれる場合は，¥"（バックスラッシュと二重引用符）で列名を囲み，さらに"（二重引用符）で囲んでください。

（例）"¥"c△1¥""

（凡例）△：空白

-p 先頭位置,長さ

入力データファイルのファイル形式がCSV形式の場合，このオプションは指定できません。

入力データファイルのファイル形式が固定長形式の場合は，このオプションを必ず指定してください。

先頭位置

〜〈整数〉((1〜536,870,912))（単位：バイト）

-nオプションに指定した列に格納するデータの開始位置を指定します。入力レコード中の先頭を1として，入力レコードの先頭からの位置を指定します。

長さ

〜〈整数〉((1〜536,870,912))（単位：バイト）

-nオプションに指定した列に格納するデータについて，入力レコードでの長さを指定します。

-pオプションの長さには，次の値は指定できません。

・-nオプションに指定した列名の列が文字形式で表現できる最大文字数より大きい値

・-nオプションに指定した列名の列に定義されたデータがバイナリ型の場合，奇数の値

・-bオプションにbinを指定している場合，7以下の値

重要

このオプションで指定した範囲が，ほかのadbcolumninfoオペランドに指定した-pオプションの指定値の範囲と重なっていても，エラーになりません。

入力データが囲み文字で囲まれている場合，囲み文字もデータとして格納されます。囲み文字を格納データとして扱いたくないときは，囲み文字を除いた範囲となるように，このオプションを指定してください。

-c 空文字列とするための比較値

〜〈文字列〉((1〜255バイト))

入力データファイルのファイル形式がCSV形式の場合，このオプションは指定できません。

入力データファイルのファイル形式が固定長形式の場合に，空文字列として扱うデータを指定します。入力データがこのオプションの指定値と一致する場合は，空文字列として扱われます。

このオプションの指定値の文字数は，-pオプションで指定した長さと一致させてください。なお，-pオプションで指定した長さが256バイト以上の場合は，-pオプションに指定した先頭位置から255バイト分のデータがこのオプションの指定値と一致するときに，空文字列として扱われます。

指定値に空白が含まれる場合は，"（二重引用符）で囲んでください。

-r ｛フィールドデータ番号｜empty_string｝

フィールドデータ番号

〜〈整数〉((1〜536,870,912))

入力データファイルがCSV形式の場合に，入力データのフィールドデータ番号を指定します。

入力データファイルのファイル形式が固定長形式の場合，このオプションは指定できません。

フィールドデータ番号とは，1入力レコード中のフィールドデータの並び順に割り振られる番号のことです。入力レコードの先頭のフィールドデータの番号を1として，順番にカウントします。フィールドデータが空文字列の場合も，1つとしてカウントします。

empty_string

入力データに空文字列を仮定する場合に指定します。

このオプションを省略した場合は，-nオプションに指定した列名の列の定義順と同じフィールドデータ番号のデータが，入力データとして仮定されます。

重要

このオプションに指定したフィールドデータ番号が，ほかのadbcolumninfoオペランドの-rオプションのフィールドデータ番号と同じでも，エラーになりません。同じフィールドデータが，処理対象表の複数の列に格納されます。

このオプションにフィールドデータ番号を指定した場合，該当するフィールドデータが入力レコード中に存在しないときは，エラーとなります。また，このオプションの指定を省略した場合，仮定されるフィールドデータ番号に該当するデータが入力レコード中に存在しないときは，エラーとなります。

囲み文字で囲まれていない配列型のフィールドデータをインポートの対象外にした場合，意図しないフィールドデータがインポートされたり，adbimportコマンドがエラーになったりすることがあります。

（例）

＜入力データ＞

{A,B,C},ABC,12345

＜列構成情報オプションの指定＞

adbcolumninfo -n C1 -r 3

adbcolumninfo -n C2 -r 2

C1列のデータ型がINTEGER型の場合，インポート対象のデータが下線部分の「C}」となるため，adbimportコマンドがエラーになります。

この場合，配列型のフィールドデータを囲み文字で囲むと，上記の問題の発生を回避できます。

＜入力データの修正例＞

"{A,B,C}",ABC,12345

-b ｛hex｜bin｝

adbcolumninfoオペランドの-nオプションに指定した列名にバイナリ型が定義されている場合に，入力レコード中のバイナリデータの形式を指定します。

hex

入力レコード中のバイナリデータを，16進形式のバイナリデータとして扱う場合に指定します。

bin

入力レコード中のバイナリデータを，2進形式のバイナリデータとして扱う場合に指定します。

このオプションの指定を省略した場合，hexが仮定されます。

adbcolumninfoオペランドの-nオプションに指定した列名の列に定義されたデータ型と，このオプションに指定する値の関係を次の表に示します。

表17‒7　列に定義されたデータ型と，-bオプションに指定する値の関係

項番

-nオプションに指定した列名の列に定義されたデータ型

-bオプションに指定する値

入力データのデータ形式

1

バイナリ型

−

16進形式のバイナリデータとして扱われます。

2

hex

16進形式のバイナリデータとして扱われます。

3

bin

2進形式のバイナリデータとして扱われます。

4

バイナリ型以外のデータ型

−

列に定義されたデータ型として扱われます。

5

hex

エラーとなります（KFAA50265-Eメッセージが出力されます）。

6

bin

（凡例）

−：-bオプションの指定を省略します。

(4)　列構成情報オプションの指定値が原因のエラー

列構成情報オプションの指定値が原因でadbimportコマンドがエラーとなる場合には，次の2つが考えられます。

列構成情報オプションの指定値に誤りがある場合

列構成情報オプションの指定値と処理対象表の整合性に問題がある場合

どちらの場合も，列構成情報オプションの指定値を修正したあと，再度adbimportコマンドを実行してください。

(a)　列構成情報オプションの指定値に誤りがある場合

列構成情報オプションの指定値に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbimportコマンドを実行してください。

表17‒8　列構成情報オプションの指定値に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

メッセージID

入力データファイルのファイル形式

考えられる誤り

1

KFAA50265-E

CSV形式

adbcolumninfoオペランドの-nオプションに指定した列名が重複している

-rオプションに「empty_string」を指定したadbcolumninfoオペランドに，-bオプションを指定している

2

固定長形式

adbcolumninfoオペランドの-pオプションに指定した先頭位置＋長さ−1の値が，adb_import_input_record_sizeオペランドに指定した入力レコード長の値より大きい

adbcolumninfoオペランドの-pオプションに指定した長さと，adbcolumninfoオペランドの-cオプションの指定値の長さが不一致となっている

adbcolumninfoオペランドの-nオプションに指定した列名が重複している

3

KFAA50266-E

CSV形式

固定長形式

表中の列数の最大値より多くのadbcolumninfoオペランドを指定している

表中の列数の最大値については，マニュアルHADB　システム構築・運用ガイドのHADBの最大値と最小値のデータベースに関する最大値と最小値を参照してください。

(b)　列構成情報オプションの指定値と処理対象表の整合性に問題がある場合

列構成情報オプションの指定値と処理対象表の整合性に問題がある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbimportコマンドを実行してください。

表17‒9　列構成情報オプションの指定値と処理対象表の整合性に問題がある場合に出力されるメッセージIDと，考えられる誤り

項番

メッセージID

入力データファイルのファイル形式

考えられる誤り

1

KFAA50265-E

CSV形式

adbcolumninfoオペランドの-nオプションに指定した列名が，処理対象表に存在しない

adbcolumninfoオペランドの-bオプションを指定した列に定義されたデータ型が，バイナリ型でない

adbcolumninfoオペランドの-rオプションに「empty_string」を指定した列が，非ナル値制約が定義されていて，かつDEFAULT句が未指定になっている

-rオプションの指定値が同じadbcolumninfoオペランドが複数ある場合に，各-bオプションに指定した値が一致していない（-rオプションおよび-bオプションの指定を省略した場合，仮定された値を基に，一致しているかどうかが判定されます）

2

固定長形式

adbcolumninfoオペランドの-nオプションに指定した列名が，処理対象表に存在しない

adbcolumninfoオペランドの-nオプションに指定した列が文字形式で表現できる最大文字数よりも，adbcolumninfoオペランドの-pオプションに指定した長さの方が長い

adbcolumninfoオペランドの-nオプションに指定した列が文字形式で表現できる文字数に，adbcolumninfoオペランドの-pオプションに指定した長さが達していない

adbcolumninfoオペランドの-bオプションを指定した列に定義されたデータ型がバイナリ型でない

-pオプションの指定値が同じadbcolumninfoオペランドが複数ある場合に，各-bオプションに指定した値が一致していない（-bオプションの指定を省略した場合，仮定された値を基に，一致しているかどうかが判定されます）

3

KFAA50267-E

固定長形式

adbcolumninfoオペランドの-nオプションに指定しなかった列（入力データを空文字列として扱いたい列）に，非ナル値制約が定義されていて，かつDEFAULT句が未指定になっている

17.2.4　列構成情報ファイルと入力データの関係

列構成情報ファイルの指定内容によって，入力データの一部だけを処理対象表に格納できます。

処理対象表への格納対象となる入力データのパターンと，格納対象外となる入力データの扱いについて説明します。

(1)　処理対象表の列への格納対象となる入力データ

列構成情報ファイルの指定内容によって，処理対象表の列に格納されるデータが異なります。

入力データファイルの形式ごとの列構成情報ファイルの指定内容と，格納対象となる入力データの関係について，次の2つの表に示します。

表17‒10　処理対象表への格納対象となる入力データ（CSV形式の場合）

項番

列構成情報ファイルの指定

列構成情報オプションの指定，または指定する値

使用されるフィールドデータ番号

使用されるフィールドデータ番号が示すデータが，入力レコード中に存在するかどうか

格納対象となる入力データ

adbcolumninfoオペランド

-nオプション

-rオプション

1

指定あり

指定あり

列名

フィールドデータ番号

-rオプションに指定した値

存在する

使用されるフィールドデータ番号が示すデータ

2

存在しない

×

3

empty_string

−

−

空文字列

4

指定なし

-nオプションに指定した列名の列の定義順と同じ番号

存在する

使用されるフィールドデータ番号が示すデータ

5

存在しない

×

6

指定なし

−

−

adbcolumninfoオペランドを指定しなかった列の定義順と同じ番号

存在する

使用されるフィールドデータ番号が示すデータ

7

存在しない

×

8

指定なし

−

−

−

処理対象表に定義された列の定義順と同じ番号

存在する

使用されるフィールドデータ番号が示すデータ

9

存在しない

×

（凡例）

×：論理エラーとなるため，値が格納されません。

−：該当しません。

表17‒11　処理対象表への格納対象となる入力データ（固定長形式の場合）

項番

列構成情報ファイルの指定

列構成情報オプションの指定，または指定する値

格納対象となる入力データ

adbcolumninfoオペランド

-nオプション

-pオプション

1

指定あり

指定あり

列名

入力データの位置情報

-pオプションが示す位置のデータ

2

指定なし

×

3

指定なし

−

−

空文字列

4

指定なし

−

−

−

×

（凡例）

×：列構成情報ファイルおよび-pオプションは指定必須のため，エラーとなります。

−：該当しません。

(2)　処理対象表への格納対象外となる入力データ

入力データが処理対象表への格納対象外となった場合，入力データのファイル形式と列構成情報ファイルを指定したかどうかによって，該当するデータの扱いが異なります。

処理対象表への格納対象外となる入力データの扱いについて，次の表に示します。

表17‒12　処理対象表への格納対象外となる入力データの扱い

項番

入力データファイルのファイル形式

列構成情報ファイルの指定

格納対象外となる入力データの扱い

1

CSV形式

指定あり

該当するデータは読み込まれますが，データの格納時には使用されません。

2

指定なし

入力データの列数が処理対象表の列数より多いため，論理エラーとなります。

3

固定長形式

指定あり

該当するデータは読み込まれますが，データの格納時には使用されません。

4

指定なし

列構成情報オプションは指定必須のため，エラーとなります。

注

入力データの論理エラーが発生した場合は，「17.9.1　入力データの論理エラーが発生したときの対処手順と対処方法」を参照して対処してください。

17.2.5　列構成情報オプションの指定パターン

列構成情報オプションの指定パターンについて，入力データファイルの内容と，処理対象表の列定義の関係ごとに説明します。

メモ

列構成情報オプションの具体的な指定例については，「17.3.2　CSV形式の表データをインポートする場合（列構成情報ファイルを指定する場合）」または「17.3.3　固定長形式の表データをインポートする場合」を参照してください。

(1)　入力データファイルのファイル形式がCSV形式の場合

入力データファイルのファイル形式がCSV形式の場合の，列構成情報オプションの指定パターンについて説明します。

(a)　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が一致している場合

次に示す2つが一致している場合は，列構成情報ファイルを指定する必要はありません。

入力データファイルのフィールドデータの数と，処理対象表の列定義数

入力データファイルのフィールドデータの並び順と，処理対象表の列構成の順序

図17‒6　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が一致している場合

(b)　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が異なる場合

入力データファイルのフィールドデータの並び順と，処理対象表の列定義の順序が異なる場合に，列構成情報オプションに指定する内容を示します。

図17‒7　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が異なる場合

列構成情報オプションに指定する内容

adbcolumninfo  -n C1  -r 2
adbcolumninfo  -n C2  -r 3
adbcolumninfo  -n C3  -r 1

(c)　入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合

入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合に，列構成情報オプションに指定する内容を示します。

図17‒8　入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合

注※

入力データが空文字列の場合に，対象の列に実際に格納される値については，「17.8　入力データが空文字列の場合に格納される値」を参照してください。

列構成情報オプションに指定する内容

adbcolumninfo  -n C1  -r 2
adbcolumninfo  -n C2  -r empty_string
adbcolumninfo  -n C3  -r 1

(d)　入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合

入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合に，列構成情報オプションに指定する内容を示します。

図17‒9　入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合

列構成情報オプションに指定する内容

adbcolumninfo  -n C1  -r 2
adbcolumninfo  -n C2  -r 4
adbcolumninfo  -n C3  -r 1

注

フィールドデータ3は，データインポートの対象外になります。

(e)　入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合

入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合に，列構成情報オプションに指定する内容を示します。

図17‒10　入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合

列構成情報オプションに指定する内容（例1）

adbcolumninfo  -n C1  -r 1
adbcolumninfo  -n C2  -r 1
adbcolumninfo  -n C3  -r 2

列構成情報オプションに指定する内容（例2）

adbcolumninfo  -n C1
adbcolumninfo  -n C2  -r 1
adbcolumninfo  -n C3  -r 2

注

列C1の-rオプションに1を指定した場合も，-rオプションを省略した場合も，列C1にはフィールドデータ1が格納されます。

(2)　入力データファイルのファイル形式が固定長形式の場合

入力データファイルのファイル形式が固定長形式の場合の，列構成情報オプションの指定パターンについて説明します。

(a)　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が一致している場合

入力データファイルのフィールドデータの並び順と，処理対象表の列定義の順序が一致している場合に，列構成情報オプションに指定する内容を示します。

図17‒11　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が一致している場合

列構成情報オプションに指定する内容

set adb_import_input_record_size = フィールドデータ1〜3の長さと改行コードのバイト数の合計

adbcolumninfo  -n C1  -p フィールドデータ1の先頭位置,フィールドデータ1の長さ
adbcolumninfo  -n C2  -p フィールドデータ2の先頭位置,フィールドデータ2の長さ
adbcolumninfo  -n C3  -p フィールドデータ3の先頭位置,フィールドデータ3の長さ

(b)　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が異なる場合

入力データファイルのフィールドデータの並び順と，処理対象表の列定義の順序が異なる場合に，列構成情報オプションに指定する内容を示します。

図17‒12　入力データファイルのフィールドデータの並び順と処理対象表の列定義の順序が異なる場合

列構成情報オプションに指定する内容

set adb_import_input_record_size = フィールドデータ1〜3の長さと改行コードのバイト数の合計

adbcolumninfo  -n C1  -p フィールドデータ2の先頭位置,フィールドデータ2の長さ
adbcolumninfo  -n C2  -p フィールドデータ3の先頭位置,フィールドデータ3の長さ
adbcolumninfo  -n C3  -p フィールドデータ1の先頭位置,フィールドデータ1の長さ

(c)　入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合

入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合に，列構成情報オプションに指定する内容を示します。

図17‒13　入力データファイルのフィールドデータの数が処理対象表の列定義数より少ない場合

注※

入力データが空文字列の場合に，対象の列に実際に格納される値については，「17.8　入力データが空文字列の場合に格納される値」を参照してください。

列構成情報オプションに指定する内容

set adb_import_input_record_size = フィールドデータ1〜2の長さの合計

adbcolumninfo  -n C1  -p フィールドデータ2の先頭位置,フィールドデータ2の長さ
adbcolumninfo  -n C3  -p フィールドデータ1の先頭位置,フィールドデータ1の長さ

注

C2のadbcolumninfoオペランドは指定しません。

(d)　入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合

入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合に，列構成情報オプションに指定する内容を示します。

図17‒14　入力データファイルのフィールドデータの数が処理対象表の列定義数より多い場合

列構成情報オプションに指定する内容

set adb_import_input_record_size = フィールドデータ1〜4の長さと改行コードのバイト数の合計

adbcolumninfo  -n C1  -p フィールドデータ2の先頭位置,フィールドデータ2の長さ
adbcolumninfo  -n C2  -p フィールドデータ4の先頭位置,フィールドデータ4の長さ
adbcolumninfo  -n C3  -p フィールドデータ1の先頭位置,フィールドデータ1の長さ

注

フィールドデータ3は，データインポートの対象外になります。

(e)　入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合

入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合に，列構成情報オプションに指定する内容を示します。

図17‒15　入力データファイルの特定のフィールドデータを処理対象表の複数列に格納する場合

列構成情報オプションに指定する内容

set adb_import_input_record_size = フィールドデータ1〜2の長さの合計

adbcolumninfo  -n C1  -p フィールドデータ1の先頭位置,フィールドデータ1の長さ
adbcolumninfo  -n C2  -p フィールドデータ1の先頭位置,フィールドデータ1の半分の長さ
adbcolumninfo  -n C3  -p フィールドデータ2の先頭位置,フィールドデータ2の長さ

17.3　使用例

adbimportコマンドを使用して表にデータをインポートする方法を，例題形式で説明します。

adbimportコマンドを実行した結果，入力データの論理エラーが発生した場合は，「17.9.1　入力データの論理エラーが発生したときの対処手順と対処方法」を参照して対処してください。

adbimportコマンドが異常終了した場合は，「17.10　adbimportコマンドが異常終了したときの対処方法」を参照して対処してください。

17.3.1　CSV形式の表データをインポートする場合

次に示す条件で，表データのインポートを行います。

表TABLE01に表データを新規にインポートする

TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

入力データファイル（CSV形式）は2つある

入力データファイル中の囲み文字にはアポストロフィ（ ' ）を，区切り文字にはコンマ（ , ）を使用している

入力データファイル中のフィールドデータが，次に示す2つの条件を満たす

フィールドデータの並び順が，インポート対象表の列構成の順序と同じ

フィールドデータの数が，インポート対象表の列定義数と同じ

入力データ中に論理エラーデータがあるおそれがある

論理エラーデータがあった場合，データの修正後にインポートする

このとき，次に示す手順でadbimportコマンドを実行します。

手順

入力データパスファイルを作成する

インポートオプションファイルを作成する

adbimportコマンドを実行する

各手順の例を以降で説明します。

(1)　入力データパスファイルを作成する

入力データパスファイルを作成して，すべての入力データファイルのパスを指定します。

入力データパスファイルの指定例

/mnt/diska/wwwww/imp1.csv
/mnt/diskb/xxxxx/imp2.csv

(2)　インポートオプションファイルを作成する

インポートオプションファイルを作成して，インポートオプションを指定します。

インポートオプションファイルの指定例

set adb_import_errdata_file_name = "/home/adbmanager/imp_file/errdata.csv"   ...1
set adb_import_errdata_num = 500                                             ...2
set adb_import_rthd_num = 2                                                  ...3
set adb_import_sort_buff_size = 2
           :

［説明］

論理エラーデータを出力する論理エラーデータファイルを指定します。

論理エラーデータの出力個数の上限を指定します。

そのほかの性能に関するインポートオプションを指定します。

(3)　adbimportコマンドを実行する

adbimport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -k "'"                                   ...3
          -s ,                                     ...4
          -g 10                                    ...5
          -w /home/adbmanager/tmp                  ...6
          -z /home/adbmanager/imp_file/env01.txt   ...7
          TABLE01                                  ...8
          /home/adbmanager/imp_file/inf01.txt      ...9

［説明］

adbimportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

入力データファイル中で使用している囲み文字（アポストロフィ）を指定します。囲み文字にアポストロフィを指定する場合は，アポストロフィを二重引用符（"）で囲む必要があります。

入力データファイル中で使用している区切り文字（コンマ）を指定します。

データインポート処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

データインポート処理時に作成される作業用一時ファイルを格納するディレクトリを指定します。

「(2)　インポートオプションファイルを作成する」で作成したインポートオプションファイルの絶対パス名を指定します。

インポート対象表（TABLE01）を指定します。

「(1)　入力データパスファイルを作成する」で作成した入力データパスファイルの絶対パス名を指定します。

17.3.2　CSV形式の表データをインポートする場合（列構成情報ファイルを指定する場合）

次に示す条件で，表データのインポートを行います。

表TABLE01に表データを新規にインポートする

TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

入力データファイル（CSV形式）は2つある

入力データファイル中の囲み文字にはアポストロフィ（ ' ）を，区切り文字にはコンマ（ , ）を使用している

入力データファイル中のフィールドデータの並び順や数が，インポート対象表の列構成の順序や列定義数と一致していない

入力データ中に論理エラーデータがあるおそれがある

論理エラーデータがあった場合，データの修正後にインポートする

このとき，次に示す手順でadbimportコマンドを実行します。

手順

入力データパスファイルを作成する

インポートオプションファイルを作成する

列構成情報ファイルを作成する

adbimportコマンドを実行する

各手順の例を以降で説明します。

(1)　入力データパスファイルを作成する

入力データパスファイルを作成して，すべての入力データファイルのパスを指定します。

入力データパスファイルの指定例

/mnt/diska/wwwww/imp1.csv
/mnt/diskb/xxxxx/imp2.csv

(2)　インポートオプションファイルを作成する

インポートオプションファイルを作成して，インポートオプションを指定します。

インポートオプションファイルの指定例

set adb_import_errdata_file_name = "/home/adbmanager/imp_file/errdata.csv"   ...1
set adb_import_errdata_num = 500                                             ...2
set adb_import_rthd_num = 2                                                  ...3
set adb_import_sort_buff_size = 2
           :

［説明］

論理エラーデータを出力する論理エラーデータファイルを指定します。

論理エラーデータの出力個数の上限を指定します。

そのほかの性能に関するインポートオプションを指定します。

(3)　列構成情報ファイルを作成する

列構成情報ファイルを作成して，列構成情報オプションを指定します。

列構成情報ファイルの指定例

adbcolumninfo -n C1  -r 2
adbcolumninfo -n C2  -r 3
adbcolumninfo -n C3  -r 1

［説明］

処理対象表に定義してある列単位（C1〜C3）に，入力データをどう扱うかを指定します。

入力データファイルの内容と処理対象表の列定義の関係ごとの列構成情報オプションの指定パターンについては，「17.2.5　列構成情報オプションの指定パターン」の「(1)　入力データファイルのファイル形式がCSV形式の場合」を参照してください。

(4)　adbimportコマンドを実行する

adbimport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -k "'"                                   ...3
          -s ,                                     ...4
          -g 10                                    ...5
          -w /home/adbmanager/tmp                  ...6
          -z /home/adbmanager/imp_file/env01.txt   ...7
          -r /home/adbmanager/imp_file/clm01.txt   ...8
          TABLE01                                  ...9
          /home/adbmanager/imp_file/inf01.txt      ...10

［説明］

adbimportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

入力データファイル中で使用している囲み文字（アポストロフィ）を指定します。囲み文字にアポストロフィを指定する場合は，アポストロフィを二重引用符（"）で囲む必要があります。

入力データファイル中で使用している区切り文字（コンマ）を指定します。

データインポート処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

データインポート処理時に作成される作業用一時ファイルを格納するディレクトリを指定します。

「(2)　インポートオプションファイルを作成する」で作成したインポートオプションファイルの絶対パス名を指定します。

「(3)　列構成情報ファイルを作成する」で作成した列構成情報ファイルの絶対パス名を指定します。

インポート対象表（TABLE01）を指定します。

「(1)　入力データパスファイルを作成する」で作成した入力データパスファイルの絶対パス名を指定します。

17.3.3　固定長形式の表データをインポートする場合

次に示す条件で，表データのインポートを行います。

表TABLE01に表データを新規にインポートする

TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

入力データファイル（固定長形式）は2つある

入力データ中に論理エラーデータがあるおそれがある

論理エラーデータがあった場合，データの修正後にインポートする

このとき，次に示す手順でadbimportコマンドを実行します。

手順

入力データパスファイルを作成する

インポートオプションファイルを作成する

列構成情報ファイルを作成する

adbimportコマンドを実行する

各手順の例を以降で説明します。

(1)　入力データパスファイルを作成する

入力データパスファイルを作成して，すべての入力データファイルのパスを指定します。

入力データパスファイルの指定例

/mnt/diska/wwwww/imp1
/mnt/diskb/xxxxx/imp2

(2)　インポートオプションファイルを作成する

インポートオプションファイルを作成して，インポートオプションを指定します。

インポートオプションファイルの指定例

set adb_import_errdata_file_name = "/home/adbmanager/imp_file/errdata"   ...1
set adb_import_errdata_num = 500                                         ...2
set adb_import_rthd_num = 2                                              ...3
set adb_import_sort_buff_size = 2
           :

［説明］

論理エラーデータを出力する論理エラーデータファイルを指定します。

論理エラーデータの出力個数の上限を指定します。

そのほかの性能に関するインポートオプションを指定します。

(3)　列構成情報ファイルを作成する

列構成情報ファイルを作成して，列構成情報オプションを指定します。

列構成情報ファイルの指定例

set adb_import_input_record_size = 38   ...1

adbcolumninfo -n C1  -p 1,10            ...2
adbcolumninfo -n C2  -p 11,8
adbcolumninfo -n C3  -p 19,20

［説明］

入力データファイルのレコード長を指定します。

処理対象表に定義してある列単位（C1〜C3）に，入力データをどう扱うかを指定します。

この例では，TABLE01に列C1（CHAR(10)），列C2（INT），および列C3（CHAR(20)）が定義されているものとします。

入力データファイルの内容と処理対象表の列定義の関係ごとの列構成情報オプションの指定パターンについては，「17.2.5　列構成情報オプションの指定パターン」の「(2)　入力データファイルのファイル形式が固定長形式の場合」を参照してください。

(4)　adbimportコマンドを実行する

adbimport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -g 10                                    ...3
          -w /home/adbmanager/tmp                  ...4
          -z /home/adbmanager/imp_file/env01.txt   ...5
          -f fix                                   ...6
          -r /home/adbmanager/imp_file/clm01.txt   ...7
          TABLE01                                  ...8
          /home/adbmanager/imp_file/inf01.txt      ...9

［説明］

adbimportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

データインポート処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

データインポート処理時に作成される作業用一時ファイルを格納するディレクトリを指定します。

「(2)　インポートオプションファイルを作成する」で作成したインポートオプションファイルの絶対パス名を指定します。

入力データファイルの形式に固定長形式を指定します。

「(3)　列構成情報ファイルを作成する」で作成した列構成情報ファイルの絶対パス名を指定します。

インポート対象表（TABLE01）を指定します。

「(1)　入力データパスファイルを作成する」で作成した入力データパスファイルの絶対パス名を指定します。

17.3.4　GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合

次に示す条件で，表データのインポートを行います。

表TABLE01に表データをバックグラウンドインポートする

TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

入力データファイル（CSV形式）は2つある

入力データファイルはGZIP形式で圧縮されている

入力データファイル中の囲み文字にはアポストロフィ（ ' ）を，区切り文字にはコンマ（ , ）を使用している

入力データファイル中のフィールドデータが，次に示す2つの条件を満たす

フィールドデータの並び順が，インポート対象表の列構成の順序と同じ

フィールドデータの数が，インポート対象表の列定義数と同じ

入力データ中に論理エラーデータがあるおそれがある

論理エラーデータがあった場合，データの修正後にバックグラウンドインポートする

このとき，次に示す手順でadbimportコマンドを実行します。

手順

入力データパスファイルを作成する

インポートオプションファイルを作成する

adbimportコマンドを実行する

各手順の例を以降で説明します。

(1)　入力データパスファイルを作成する

入力データパスファイルを作成して，すべての入力データファイルのパスを指定します。

入力データパスファイルの指定例

/mnt/diska/wwwww/imp1.csv.gz
/mnt/diskb/xxxxx/imp2.csv.gz

(2)　インポートオプションファイルを作成する

インポートオプションファイルを作成して，インポートオプションを指定します。

インポートオプションファイルの指定例

set adb_import_errdata_file_name = "/home/adbmanager/imp_file/errdata.csv"   ...1
set adb_import_errdata_num = 500                                             ...2
set adb_import_read_size = 1024                                              ...3
set adb_import_decompress_buff_size = 1024
           :

［説明］

論理エラーデータを出力する論理エラーデータファイルを指定します。

論理エラーデータの出力個数の上限を指定します。

そのほかの性能に関するインポートオプションを指定します。

(3)　adbimportコマンドを実行する

adbimport -u ADBUSER01                             ...1
          -p '#HelloHADB_01'                       ...2
          -k "'"                                   ...3
          -s ,                                     ...4
          -g 10                                    ...5
          -w /home/adbmanager/tmp                  ...6
          -z /home/adbmanager/imp_file/env01.txt   ...7
          -b                                       ...8
          TABLE01                                  ...9
          /home/adbmanager/imp_file/inf01.txt      ...10

［説明］

adbimportコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

入力データファイル中で使用している囲み文字（アポストロフィ）を指定します。囲み文字にアポストロフィを指定する場合は，アポストロフィを二重引用符（"）で囲む必要があります。

入力データファイル中で使用している区切り文字（コンマ）を指定します。

データインポート処理の経過メッセージ（KFAA80205-I）が10,000行ごとに出力されるように指定します。

データインポート処理時に作成される作業用一時ファイルを格納するディレクトリを指定します。

「(2)　インポートオプションファイルを作成する」で作成したインポートオプションファイルの絶対パス名を指定します。

表データがバックグラウンドインポートされるように指定します。

インポート対象表（TABLE01）を指定します。

「(1)　入力データパスファイルを作成する」で作成した入力データパスファイルの絶対パス名を指定します。

17.4　リターンコード

adbimportコマンドのリターンコードを次の表に示します。

表17‒13　adbimportコマンドのリターンコード

リターンコード

意味

0

adbimportコマンドが正常に終了しました。

4

adbimportコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

なお，次の警告メッセージが出力された場合は，制約違反が発生している，データインポートされていないデータがあるなどの問題が発生しています。

KFAA61205-Wメッセージが出力された場合

このメッセージ（重複キー値を検出した旨の警告メッセージ）が出力された場合，表とB-treeインデクスは一意性制約に違反した状態になっています（B-treeインデクスが一意性制約に違反した状態であることを，一意性制約違反状態といいます）。この場合，重複しているキー値を検索して，対象の行を削除してください。そのあとで，adbidxrebuildコマンドを実行してB-treeインデクスを再作成してください。対処方法の詳細については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのB-treeインデクスに関するトラブルの一意性制約に違反した場合の対処方法（KFAA61205-Wメッセージが出力された場合）を参照してください。

論理エラーデータが発生した旨のメッセージが出力された場合

論理エラーデータの詳細については，出力されたメッセージで確認してください。ただし，インポートオプションadb_import_errmsg_lvに1を指定した場合は，論理エラーデータの詳細を示すメッセージは出力されません。

なお，正常なデータのデータインポート処理は完了しています。論理エラーデータが発生したときの対処方法については，「17.9.1　入力データの論理エラーが発生したときの対処手順と対処方法」を参照してください。

8

次のどちらかのエラーが発生しました。

adbimportコマンドの指定に誤りがあり，adbimportコマンドが実行されませんでした。

adbimportコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。詳細については，「17.10　adbimportコマンドが異常終了したときの対処方法」を参照してください。

16

adbimportコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbimportコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，KFAA80204-Iメッセージに出力されるリターンコード（0，4または8）を参照してください。ただし，adbimportコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合は，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbimportコマンドを再実行してください。

17.5　入力データファイルの形式（CSV形式の仕様）

ここでは，入力データファイル（CSV形式）の形式について説明します。

入力データファイル（固定長形式）の形式については，「17.6　入力データファイルの形式（固定長形式の仕様）」を参照してください。

圧縮した入力データファイル（CSV形式）を使用したい場合については，「17.7　入力データファイルの圧縮形式」を参照してください。

17.5.1　CSV形式の仕様

CSV形式とは，各項目のデータを区切り文字で区切って並べたデータ形式のことです。このとき，区切られた各項目のデータのことをフィールドデータといいます。CSV形式の例を次の図に示します。

図17‒16　CSV形式の例

［説明］

入力データファイルの1行は，表の1行のデータに対応します。

入力データファイルに記述するフィールドデータの順序は，表の列構成の順序と同じでなくても問題ありません。

入力データファイルは，環境変数ADBLANGに指定した文字コードで作成してください。

フィールドデータが囲み文字で囲まれている場合は，囲み文字をadbimportコマンドの-kオプションに指定します。

フィールドデータを区切り文字で区切ります。この区切り文字をadbimportコマンドの-sオプションに指定します。

数値データ（年齢）も，文字データと同じ形式で記述します。

17.5.2　入力データの記述規則（CSV形式）

表の1行のデータをファイルの1行に記述してください。1行の終わりには改行文字を記述してください。改行コードは，X'0A'（LF），X'0D0A'（CRLF），またはX'00'としてください。

ローストア表にデータをインポートする場合，入力データの1行の最大長は512メガバイト（536,870,912バイト）です。512メガバイトを超えると，adbimportコマンドの実行時にファイル入力エラーになります。

入力データファイルにEOF制御文字は記述できません。

フィールドデータとフィールドデータの間を区切り文字で区切ってください。

囲み文字を指定する場合は，区切り文字と囲み文字を連続して指定してください。区切り文字と囲み文字の間に空白があると，空白はデータとして扱われるため，囲み文字の指定エラーになったり，囲み文字を含むデータが格納されたりすることがあります。

囲み文字と同じ文字がデータ中にある場合，データの文字を2個連続で記述してください。

（例）アポストロフィ（'）が囲み文字で，データにもアポストロフィがある場合

データの先頭が囲み文字と同じ文字の場合は，データの文字を2個連続で記述してください。その上で，フィールドデータを囲み文字で囲んでください。

（例）二重引用符（"）が囲み文字で，データが「"ABC」の場合

ただし，データの先頭に半角空白またはタブを挿入した場合は，フィールドデータを囲み文字で囲む必要はありません。

囲み文字で囲んだ個所は，すべてデータとして扱われます。

フィールドデータ中に区切り文字がある場合，フィールドデータ全体を囲み文字で囲んでください。囲み文字で囲まない場合，区切り文字として扱われ，入力データの列数不一致などの結果になります。

囲み文字が二重引用符（"）で，区切り文字がコンマ（,）の場合について，例を次に示します。

例1：次の場合は，「1」，「foo,bar」，「3」の3列のフィールドデータとして扱われます。

1,"foo,bar",3

例2：次の場合は，「1」，「foo」，「bar」，「3」の4列のフィールドデータとして扱われます。

1,foo,bar,3

■配列型のフィールドデータの記述規則

配列型の列に格納される配列型のフィールドデータの記述規則について説明します。

ここでは，基本的な規則を説明しています。そのほかの規則については，「表17‒14　フィールドデータの記述形式」の「配列データ」を参照してください。

配列型のフィールドデータは，波括弧（{ }）で囲み，各配列要素をコンマ（,）で区切ってください。

（例1）

…,{ABC,DEF,XYZ},…

下線部分が配列型のフィールドデータです。

上記の例の場合，配列型の列の各配列要素には，ABC，DEF，XYZが格納されます。

（例2）

…|{ABC,DEF,XYZ}|…

下線部分が配列型のフィールドデータです。

-sオプションを指定して，フィールドデータの区切り文字をストローク（|）に変更した場合でも，各配列要素はコンマ（,）で区切ります。上記の例の場合も，配列型の列の各配列要素には，ABC，DEF，XYZが格納されます。

各配列要素を二重引用符（"）で囲むこともできます。

（例）

…,{"ABC","DEF","XYZ"},…

上記の例の場合，配列型の列の各配列要素には，ABC，DEF，XYZが格納されます。

各配列要素を囲む二重引用符（"）には，囲み文字と同じ規則が適用されます。

配列型のフィールドデータは，囲み文字で囲むことを推奨します。配列型のフィールドデータを囲み文字で囲まないと，囲み文字に関するエラーが発生した場合，エラーが発生した個所以降の全フィールドデータがエラーと判定されることがあります。

（例）囲み文字がアポストロフィ（ ' ）の場合

…,'{ABC,DEF,XYZ}',…

配列要素に波括弧（{ }），コンマ（,），または改行コードが含まれている場合は，配列要素を二重引用符（"）で囲んでください。

（例）配列要素に波括弧（{ }）が含まれている場合

…,{ABC,"DEF{","{XYZ}"},…

上記の例の場合，配列型の列の各配列要素には，ABC，DEF{，{XYZ}が格納されます。

また，配列要素に二重引用符（"）が含まれている場合も，配列要素を二重引用符（"）で囲んでください。さらに，配列要素中の二重引用符（"）を2個連続で記述してください。

（例）配列要素に二重引用符（"）が含まれている場合

…,{ABC,"DE""F","""XYZ"""},…

上記の例の場合，配列型の列の各配列要素には，ABC，DE"F，"XYZ"が格納されます。

配列型のフィールドデータ中に区切り文字と同じ文字がある場合，区切り文字と同じ文字は配列要素の一部と見なされます。

（例）区切り文字がストローク（|）の場合

…|{ABC,D|EF,|XYZ|}|…

上記の例の場合，配列型の列の各配列要素には，ABC，D|EF，|XYZ|が格納されます。

配列型のフィールドデータ中に囲み文字と同じ文字がある場合の仕様は，次のようになります。

配列型のフィールドデータを囲み文字で囲んでいない場合

配列型のフィールドデータ中の囲み文字と同じ文字は，配列要素の一部と見なされます。

（例）囲み文字がアポストロフィ（ ' ）の場合

…,{AB'C,'DEF',XY''Z},…

上記の例の場合，配列型の列の各配列要素には，AB'C，'DEF'，XY''Zが格納されます。

配列型のフィールドデータを囲み文字で囲んでいる場合

配列型のフィールドデータ中の囲み文字と同じ文字は，2個連続で記述してください。

（例）囲み文字がアポストロフィ（ ' ）の場合

…,'{AB''C,''DEF'',XY''''Z}',…

上記の例の場合，配列型の列の各配列要素には，AB'C，'DEF'，XY''Zが格納されます。

17.5.3　フィールドデータの記述形式（CSV形式）

フィールドデータの記述形式を次の表に示します。

表17‒14　フィールドデータの記述形式

項番

データ型

フィールドデータの記述形式

形式

記述例

注意事項

空文字列の指定例※1

配列要素（ナル値，長さ0のデータの指定例）※10

1

数データ

INTEGER

〔｛+｜-｝〕a...a

+，-：符号

a...a：数値（aは0〜9）

100

-123

000

0657

符号と数値を合わせて20文字まで記述できます。

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

…,*,…

…,"*",…

…,,…

…,"",…

…,"""",…

ただし，-kオプションにnoneを指定した場合，囲み文字を使用した例は指定できません。

{…,*,…}

{…,"*",…}

{…,"",…}

{…,"""",…}

{…,NULL,…}

2

BIGINT

3

SMALLINT

〔｛+｜-｝〕a...a

+，-：符号

a...a：数値（aは0〜9）

100

-0123

0

+0657

符号と数値を合わせて11文字まで記述できます。

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

4

DECIMAL

〔｛+｜-｝〕

｛a...a〔.〔b...b〕〕｜.b...b｝

+，-：符号

a...a：整数部（aは0〜9）

b...b：小数部（bは0〜9）※3

100

-123.00

△.00

012.

-1.56

+.560

整数部と小数部を合わせて38文字（格納先の列の精度と位取りが一致している場合は，整数部（0）を省略しないときだけ39文字）まで記述できます。

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

5

NUMERIC

6

DOUBLE PRECISION

〔｛+｜-｝〕

｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔〔｛+｜-｝〕c...c〕〕

+，-：符号

a...a：仮数の整数部（aは0〜9）

b...b：仮数の小数部（bは0〜9）

c...c：指数部（cは0〜9）※4

E，e：浮動小数点数定数

100

-△123

0.△

-1.5600

.56

-02.4e+9

000e

2.4E+009

509文字まで記述できます。※5

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

7

FLOAT

8

文字データ

CHARACTER

a...a

a...a：1文字以上のデータ

abcdef△△

ABCDEF

△

格納先の列の定義長までの文字数が記述できます。

データの先頭を除き，末尾まで連続する半角空白は省略できます。※6

…,,…

…,"",…

半角空白およびタブは挿入できません。

-kオプションにnoneを指定した場合，囲み文字を使用した例は指定できません。

{…,"",…}

{…,NULL,…}

半角空白およびタブは挿入できません。

9

VARCHAR

a...a

a...a：1文字以上のデータ

abcdef△△

ABCDEF

△△

格納先の列の定義長までの文字数が記述できます。

…,,…

囲み文字は指定できません。また，半角空白およびタブは挿入できません。

■長さ0のデータを指定する場合

…,"",…

ただし，-kオプションにnoneを指定した場合，長さ0のデータは指定できません。

{…,NULL,…}

■長さ0のデータを指定する場合

{…,"",…}

10

日時データ

DATE

｛YYYY-MM-DD

｜YYYY/MM/DD｝

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜その月の最終日）

2013-06-10

2013/06/10

形式に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

11

TIME

hh:mm:ss〔.〔nn...n〕〕

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

nn...n：小数秒（nは0〜9）

11:03:58

11:03:58.

11:03:58△.1234

小数秒（nn...n）は12文字まで記述できます。※7

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

12

TIMESTAMP

｛YYYY-MM-DD

｜YYYY/MM/DD｝

△hh:mm:ss〔.〔nn...n〕〕

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜その月の最終日）

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

nn...n：小数秒（nは0〜9）

2013-06-10△11:03:58

2013-06-10△11:03:58△.1234

小数秒（nn...n）は12文字まで記述できます。※7

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

13

バイナリデータ

BINARY

16進文字列の場合

a...a

a：0〜9，A〜F，またはa〜f

12340000

90△AB

90ab△CDEF

格納先の列の定義長×2までの2の倍数の文字数を記述できます。※8

データの先頭を除き，末尾まで連続する「00」は省略できます。※9

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

14

2進文字列の場合

a...a

a：0または1

01010101

0101△0101

格納先の列の定義長×8までの8の倍数の文字数を記述できます。※8

データの先頭を除き，末尾まで連続する「00000000」は省略できます。※9

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番1と同じ。

項番1と同じ。

15

VARBINARY

16進文字列の場合

a...a

a：0〜9，A〜F，またはa〜f

12340000

90△AB

90ab△CDEF

格納先の列の定義長×2までの2の倍数の文字数を記述できます。※8

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

…,*,…

…,"*",…

…,,…

ただし，-kオプションにnoneを指定した場合，囲み文字を使用した例は指定できません。

■長さ0のデータを指定する場合

…,"",…

…,"""",…

ただし，-kオプションにnoneを指定した場合，長さ0のデータは指定できません。

{…,*,…}

{…,"*",…}

{…,NULL,…}

■長さ0のデータを指定する場合

{…,"",…}

{…,"""",…}

16

2進文字列の場合

a...a

a：0または1

01010101

0101△0101

格納先の列の定義長×8までの8の倍数の文字数を記述できます。※8

形式および文字数の制限に関係なく，すべての文字の前後に1個以上の半角空白またはタブを挿入できます。※2

項番15と同じ。

項番15と同じ。

17

配列データ

ARRAY

{a〔,a〕…}|{}

a：配列要素（要素データ型に該当するデータ型の形式に従う）

{ABC,DE,XYZ}

{"ABC","DE","XYZ"}

「17.5.2　入力データの記述規則（CSV形式）」の「■配列型のフィールドデータの記述規則」を参照してください。

…,,…

…,"",…

囲み文字は指定できません。また，半角空白およびタブは挿入できません。

要素データ型に該当するデータ型の指定例に従う。

（凡例）

△：1個以上の半角空白，またはタブ

, ：区切り文字

" ：囲み文字

注※1

空文字列を指定すると，格納先の列にDEFAULT句を指定している場合は，列の既定値が格納されます。格納先の列にDEFAULT句を指定していない場合は，ナル値が格納されます。DEFAULT句を指定している列にナル値のデータを格納したいときは，インポートオプションadb_import_null_stringの指定値をNULLにしてください。

対象の列に実際に格納される値については，「17.8　入力データが空文字列の場合に格納される値」を参照してください。

注※2

文字の前後に1個以上の半角空白（0x20）やタブ（0x09）がある場合，その半角空白およびタブは削除されます。

（例）△1△23△△4△△△ → 1234

なお，データがすべて削除された場合は，空文字列として扱われます。

注※3

格納先の位取りより下位の桁部分は切り捨てられます。

注※4

指数を省略した場合，指数として+0を仮定します。

注※5

指定する値によっては，桁落ちが生じる場合があります。

注※6

入力データが定義長に満たない場合は，半角空白が残りの部分に格納されます。

注※7

小数秒（nn...n）の桁数が表のデータ型の小数秒精度に満たない場合は，右側に0が補われます。

小数秒（nn...n）の桁数が表のデータ型の小数秒精度を超える場合は，入力データは切り捨てられます。

注※8

16進文字列の文字数が2の倍数でない場合，論理エラーとなります。

2進文字列の文字数が8の倍数でない場合，論理エラーとなります。

注※9

入力データが定義長に満たない場合は，0x00が残りの部分に格納されます。

注※10

配列要素がナル値となる場合の指定例と，配列要素が長さ0のデータとなる場合の指定例を説明しています。

17.6　入力データファイルの形式（固定長形式の仕様）

ここでは，入力データファイル（固定長形式）の形式について説明します。

入力データファイル（CSV形式）の形式については，「17.5　入力データファイルの形式（CSV形式の仕様）」を参照してください。

圧縮した入力データファイル（固定長形式）を使用したい場合については，「17.7　入力データファイルの圧縮形式」を参照してください

17.6.1　固定長形式の仕様

固定長形式とは，レコード長が固定のデータ形式のことです。固定長形式の例を次の図に示します。

図17‒17　固定長形式の例

［説明］

入力データの1行の長さは固定です。

入力データファイルに記述するフィールドデータの順序は，表の列構成の順序と同じでなくても問題ありません。

17.6.2　入力データの記述規則（固定長形式）

入力データの1行の長さは固定にしてください。

1行の終わりに改行コードを記述できます。

入力データファイルは，環境変数ADBLANGに指定した文字コードで作成してください。

各列の値の開始位置は統一してください。各データ型の開始位置を統一する方法を次の表に示します。

表17‒15　開始位置を統一する方法

項番

データ型

開始位置を統一する方法

空白およびタブの扱われ方

1

数データ

次のどれかの方法で開始位置を指定します。また，2.と3.を組み合わせることもできます。

データの前方または後方を空白（x20）で埋める

整数データの前方を0で埋める

小数データの後方を0で埋める

データを格納する前に，不要な空白（0x20）およびタブ（0x09）は削除されます。※1

2

文字データ

固定長

−

−

3

可変長

データの後方を空白（x20）で埋めて開始位置を統一します。

データを格納する前に，データの後方の空白（0x20）およびタブ（0x09）は削除されます。※2

4

日時データ

データの前方または後方を空白（x20）で埋めて開始位置を統一します。

データを格納する前に，不要な空白（0x20）およびタブ（0x09）は削除されます。※1

5

バイナリデータ

固定長

データの前方または後方を空白（x20）で埋めて開始位置を統一します。

データを格納する前に，不要な空白（0x20）およびタブ（0x09）は削除されます。※1

6

可変長

データの前方または後方を空白（x20）で埋めて開始位置を統一します。

データを格納する前に，不要な空白（0x20）およびタブ（0x09）は削除されます。※2

（凡例）

−：該当しません。

注※1

データがすべて削除された場合は，入力データが不正となります。

注※2

データがすべて削除された場合は，長さ0のデータとして扱われます。

17.6.3　フィールドデータの記述形式（固定長形式）

データをすべて文字形式で指定します。

各データ型の指定値の詳細については，「17.5.3　フィールドデータの記述形式（CSV形式）」を参照してください。

また，CSV形式とは異なる点（固定長形式に関する留意事項）を次に示します。

空文字列または列の既定値を指定する方法は，CSV形式とは異なります。

空文字列または列の既定値を指定する場合は，空文字列または列の既定値として扱いたいデータを，列構成情報オプションのadbcolumninfoオペランドの-cオプションに指定します。指定した値と入力データが一致すると，空文字列または列の既定値が格納されます。なお，このとき比較対象となる入力データは，不要な空白およびタブを取り除く前のデータです。

重要

列に非ナル値制約を定義している場合，入力データ中の該当するデータに空文字列として扱われる記述があると，adbimportコマンドの実行時に論理エラーとして扱われます。

囲み文字はそのままデータとして扱われます。

このため，データとして囲み文字が不要な場合は，列構成情報オプションのadbcolumninfoオペランドの-pオプションの先頭位置と長さに，囲み文字を除いた範囲を指定してください。

また，データとして囲み文字が含まれる場合は，CSV形式と異なり，連続させる必要はありません。

可変長データ型は，指定方法によっては長さ0のデータとして扱われることがあります。詳細については，「17.6.2　入力データの記述規則（固定長形式）」の「表17‒15　開始位置を統一する方法」を参照してください。

17.7　入力データファイルの圧縮形式

入力データファイルの圧縮形式について説明します。

adbimportコマンドは，次に示す圧縮形式で入力データファイル（CSV形式または固定長形式）を圧縮している場合でも，データをインポートできます。

■入力データファイルの圧縮形式

GZIP形式

adbimportコマンドでインポートできる，GZIP形式で圧縮されたファイルを次に示します。

OSのgzipコマンドでGZIP形式に圧縮した入力データファイル（CSV形式または固定長形式）

--compress GZIPオプションを指定したadbexportコマンドでGZIP形式に圧縮した出力データファイル（CSV形式）

出力データファイルの圧縮形式については，「14.6　出力データファイルの圧縮形式」を参照してください。

圧縮された入力データファイルをインポートする方法は，圧縮されていない入力データファイルをインポートする方法と同じです。入力データパスファイルに，圧縮された入力データファイルの格納場所を示す絶対パスを指定してadbimportコマンドを実行すると，データをインポートできます。

重要

入力データファイルに使用できるファイルの圧縮形式は，GZIP形式だけです。ほかの形式で圧縮された入力データファイルは，インポートできません。

GZIP形式以外の形式で圧縮された入力データファイルをインポートする場合は，圧縮された入力データファイルを，インポートする前に伸長しておいてください（圧縮を解除してください）。

メモ

入力データファイル（CSV形式）の形式については，「17.5　入力データファイルの形式（CSV形式の仕様）」を参照してください。

入力データファイル（固定長形式）の形式については，「17.6　入力データファイルの形式（固定長形式の仕様）」を参照してください。

17.8　入力データが空文字列の場合に格納される値

入力データが空文字列の場合に，対象の列に実際に格納される値について次の表に示します。

なお，入力データが空文字列以外の場合は，表定義時の指定やインポートオプションadb_import_null_stringの指定値に関係なく，入力データの値が格納されます。

表17‒16　入力データが空文字列の場合に格納される値

項番

表定義時の指定

インポートオプションadb_import_null_stringの指定値

実際に格納される値

非ナル値制約

DEFAULT句

1

指定なし

指定なし

DEFAULTまたはオプションを省略

ナル値

2

NULL

ナル値

3

指定あり

DEFAULTまたはオプションを省略

列の既定値※

4

NULL

ナル値

5

NOT NULL

指定なし

DEFAULTまたはオプションを省略

−

6

NULL

−

7

指定あり

DEFAULTまたはオプションを省略

列の既定値※

8

NULL

−

（凡例）

−：論理エラーとなるため，値が格納されません。

注※

列の既定値については，次に示す項目を参照してください。

・マニュアルHADB　SQLリファレンスの定義系SQLのCREATE TABLE（表の定義）のCREATE TABLE文の指定形式および規則

・マニュアルHADB　システム構築・運用ガイドのデータベースの設計の表の設計の列の既定値の設定（DEFAULT句）

17.9　入力データの論理エラーが発生したときの対処方法

入力データの論理エラーが発生したときの対処手順と対処方法について説明します。

17.9.1　入力データの論理エラーが発生したときの対処手順と対処方法

入力データの論理エラーが発生したときの対処手順（フロー）を「図17‒18　入力データの論理エラーが発生したときの対処手順」に示します。なお，この手順は，論理エラーデータファイルに論理エラーデータが出力されていることが前提となっています。

GZIP形式で圧縮した入力データファイルを使用している場合，入力データとは，伸長したデータを指しています。

図17‒18　入力データの論理エラーが発生したときの対処手順

各手順の詳細を説明します。

(1)　論理エラーデータファイルを退避する

論理エラーデータファイルを退避してください。

(2)　論理エラーデータに関するメッセージを確認する

KFAA50217-E〜KFAA50224-Eメッセージ，およびKFAA52100-Eメッセージが，論理エラーデータに関するメッセージです。これらのメッセージが出力されているかを確認してください。

(3)　論理エラーデータを修正する

論理エラーデータファイルは，次の3つの組み合わせによって出力パターンが異なります。

インポート対象表のデータ格納形式の種類

入力データファイルのファイル形式の種類

インポート時の列構成情報ファイル（adbimportコマンドの-rオプション）の指定有無

論理エラーデータファイルの出力パターンを次に示します。

論理エラーが発生した行データがそのまま出力される場合

次に示すどれかの場合は，論理エラーデータファイルには論理エラーが発生した行データがそのまま出力されます。

ローストア表にデータをインポートする際，入力データファイルのファイル形式がCSV形式の場合で，かつadbimportコマンドの-rオプションを指定しなかった場合

ローストア表にデータをインポートする際，入力データファイルのファイル形式が固定長形式の場合

カラムストア表にデータをインポートする場合

論理エラーが発生した行データのうち，処理対象表への格納対象となったフィールドデータだけが切り出される場合

次に示す条件を満たす場合は，論理エラーデータファイルには処理対象表への格納対象となったフィールドデータだけが切り出されます。

ローストア表にデータをインポートする

入力データファイルのファイル形式がCSV形式である

adbimportコマンドの-rオプションに列構成情報ファイルを指定した

それぞれの場合の対処方法を次に示します。

(a)　論理エラーが発生した行データがそのまま出力される場合

「(1)　論理エラーデータファイルを退避する」で退避した論理エラーデータファイルを開いて，論理エラーデータを修正します。

論理エラーデータの出力行と，「(2)　論理エラーデータに関するメッセージを確認する」のメッセージの出力順が一致しています。出力されたメッセージを参照して，論理エラーデータファイル中のデータを直接修正してください。

出力されたメッセージの例

KFAA50217-E  The input data length is invalid.
             (input file = 1, row = 1, column = 2, element = 0)      ...1

KFAA50222-E  The input data contains an invalid empty string.
             (input file = 1, row = 2, column = 3)                   ...2

     :

［説明］

KFAA50217-Eメッセージは，データ長に誤りがあるときに出力されるメッセージです。

論理エラーが発生したデータの入力データファイル中の位置が「input file = 1 ,row = 1, column = 2」に表示されます。この例の場合，入力データパスファイル中の1番目（input file）に指定した入力データファイルの中の，1行目（row）の2カラム目（column）のデータに論理エラーが発生したことを示しています。

KFAA50222-Eメッセージは，非ナル値制約の列のデータに空文字列がある場合に出力されるメッセージです。

論理エラーデータファイルの内容（行データがそのまま出力される場合）

(b)　処理対象表への格納対象となったデータだけが切り出される場合

論理エラーデータが，処理対象表への格納対象となったフィールドデータなのかどうかによって，対処方法が異なります。

処理対象表への格納対象となったフィールドデータが論理エラーになった場合

論理エラーデータファイルには，エラー対象のフィールドデータが出力されています。

この場合，「(1)　論理エラーデータファイルを退避する」で退避した論理エラーデータファイルを開いて，論理エラーデータを修正します。

論理エラーデータの出力行と，「(2)　論理エラーデータに関するメッセージを確認する」のメッセージの出力順が一致しています。出力されたメッセージを参照して，論理エラーデータファイル中のデータを直接修正してください。

処理対象表への格納対象外となったフィールドデータが論理エラーになった場合

論理エラーデータファイルには，エラー対象のフィールドデータが出力されません。

この場合，「(2)　論理エラーデータに関するメッセージを確認する」で確認したメッセージを参照して，入力データファイルでエラーの要因を確認します。

入力データファイルの該当する行データを確認した上で，論理エラーデータファイルに出力された内容に問題がなければ，論理エラーデータファイルを修正する必要はありません。論理エラーデータファイルに出力された内容に問題があれば，入力データファイルから該当する行データを取り出して，修正してください。

出力されるメッセージは，論理エラーが発生した行データがそのまま出力される場合と同じです。メッセージの例は，「(a)　論理エラーが発生した行データがそのまま出力される場合」を参照してください。

論理エラーデータファイルの内容（格納対象となったデータだけが切り出される場合）

メモ

格納対象となったデータだけが論理エラーデータファイルに切り出される場合，論理エラーデータファイルには，入力データファイルとフィールドデータの数が同じになるように区切り文字が切り出されます（このため，adbimportコマンドの再実行時には，オプションを変更しないで，修正後の論理エラーデータファイルを入力データファイルとして使用できます）。

ただし，処理対象表への格納対象外になったフィールドデータ番号の最大値＋1番目以降の区切り文字は切り出されません。

(4)　adbimportコマンドを再実行する

adbimportコマンドを再実行して，修正したデータをインポートします。修正したデータを格納したファイル（論理エラーデータファイル）を入力データファイルにして，adbimportコマンドを再実行してください。

論理エラーデータファイルを修正する必要がなかった場合は，出力された論理エラーデータファイルをそのまま入力データファイルにしてください。また，入力データファイルの行データを取り出して修正した場合は，取り出して修正した行データを格納したファイルを，入力データファイルにしてください。

重要

必ず追加モード（-dオプションを指定しない）でadbimportコマンドを実行してください。作成モードでadbimportコマンドを実行すると，インポート済みの正常データが削除されてしまいます。

-dオプション以外のオプションの指定は，基本的には変更しないでください。インポートオプションの指定も基本的には変更しないでください。

17.10　adbimportコマンドが異常終了したときの対処方法

adbimportコマンドが異常終了したときの対処手順を次に示します。

17.10.1　最初に確認すること

次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されている場合は，コマンドのオプションや，インポートオプションの指定に誤りがあります。コマンドのオプションまたはインポートオプションを修正したあとに，adbimportコマンドを再実行してください。

これらのメッセージが出力されていない場合は，「17.10.2　障害原因の特定と対処」に進んでください。

17.10.2　障害原因の特定と対処

adbimportコマンドが中断したときの対処手順（フロー）を次の図に示します。

図17‒19　adbimportコマンドが異常終了したときの対処手順

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

adbimportコマンドを再実行してください。

再実行したadbimportコマンドが中断した場合は，出力されているメッセージを確認して，adbidxrebuildコマンドまたはadbimportコマンドを実行してください。

詳細については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」を参照してください。

なお，インポート対象表にB-treeインデクスが定義されている場合（主キーが定義されている場合を含む），またはテキストインデクスが定義されている場合は「17.10.3　インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合」を参照してください。また，論理エラーデータを出力する設定をしている場合は「17.10.4　論理エラーデータを出力する設定をしている場合」を参照してください。

■マルチノード機能を使用している場合

adbimportコマンドが中断して，処理対象表が更新不可状態となった場合，中断したadbimportコマンドを再実行して，実表の更新不可状態を解除してください。

なお，プライマリノードのHADBサーバが異常終了してプライマリノードが切り替わった場合は，新たなプライマリノードでadbidxrebuildコマンドを実行し，実表の更新不可状態を解除してください。このとき，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。

プライマリノードを別のノードに変更する方法やマルチノード機能を使用しないでHADBサーバを起動する方法については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のトラブルシュート（マルチノード機能の使用時）のマルチノード構成のHADBサーバの開始または終了に関するトラブルを参照してください。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する方法については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

17.10.3　インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合

インポート対象表にB-treeインデクスが定義されている場合（主キーが定義されている場合を含む），またはテキストインデクスが定義されている場合は，adbimportコマンドを再実行する前に，KFAA80220-Iメッセージ※が出力されているかどうかを確認してください。KFAA80220-Iメッセージ※は，インデクスレコードのソート処理が完了したときに出力されるメッセージです。このメッセージが出力されている場合は，B-treeインデクスとテキストインデクス作成処理からの再実行機能が適用され，データインポート処理の再実行に掛かる時間を短縮できます。

注※

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合は，KFAA80203-Iメッセージが出力されているかどうかを確認してください。KFAA80203-Iメッセージは，表データのインポートが完了したときに出力されるメッセージです。このメッセージが出力されている場合は，B-treeインデクスとテキストインデクス作成処理からの再実行機能が適用されます。

このメッセージが出力されていない場合は，データインポート処理は最初から（表データのインポートから）となります。

adbimportコマンドが異常終了したときと同じHADBユーザでadbimportコマンドを再実行すると，B-treeインデクスとテキストインデクス作成処理からの再実行機能が自動的に適用されます。特別な操作はありません。

なお，adbimportコマンドの再実行時にコマンドオプションおよびインポートオプションを変更する場合は，「17.10.6　再実行時にコマンドオプションおよびインポートオプションを変更する場合」を参照してください。

重要

コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラー（KFAA50244-Eメッセージ）が発生した場合は，--forceオプションを指定してadbidxrebuildコマンドを実行してください。

また，adbimportコマンドが中断した状態で，処理対象表にインデクスを定義してKFAA50209-Eメッセージが出力された場合も，--forceオプションを指定してadbidxrebuildコマンドを実行してください。adbimportコマンドが中断していない場合は，--forceコマンドを指定しないでadbidxrebuildコマンドを実行してください。

--forceオプションを指定してadbidxrebuildコマンドを実行する方法については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

作業用一時ファイルに対するアクセスエラー（KFAA50247-Eメッセージ）が発生した場合は，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する方法については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

17.10.4　論理エラーデータを出力する設定をしている場合

「17.10.3　インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合」で説明したKFAA80203-Iメッセージが出力されている場合は，表データのインポートが完了しているため，論理エラーデータファイルに論理エラーデータが出力されています。adbimportコマンドの再実行が完了したあとに，「17.9.1　入力データの論理エラーが発生したときの対処手順と対処方法」を参照して論理エラーの対処を行ってください。

KFAA80203-Iメッセージが出力されていない場合，表データのインポートが完了していないため，論理エラーデータファイルにはすべての論理エラーデータが出力されていません。そのため，出力された情報を基に一部の論理エラーデータだけを修正するか，またはadbimportコマンドを再実行し，そのときに出力された論理エラーデータの情報を基にすべての論理エラーデータを修正してください。

17.10.5　B-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否

adbimportコマンドの中断タイミングによって，adbimportコマンドを再実行したときに，B-treeインデクスとテキストインデクス作成処理からの再実行機能が適用されるかどうかが決まります。

adbimportコマンドの中断タイミングによるB-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否を次の表に示します。

なお，データベースの回復方法はどの時点で中断が発生しても同じになります。

表17‒17　adbimportコマンドの中断タイミングによるB-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否

-dオプションの指定

中断のタイミング※1

表データ部の作成中

ソート処理中

B-treeインデクスとテキストインデクスの作成中※2

指定あり（作成モード）

再実行機能の適用可否

適用されません。※3

表の状態

次のどちらかの状態です。

データなしの状態

adbimportコマンド実行前の状態

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは，次のどちらかの状態です。

データなしの状態

adbimportコマンド実行前の状態

サーバ定義のadb_cmd_ixrec_file_useオペランドにSINGLE-USE（省略値）を指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「表データ部の作成中」と同じです。

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「B-treeインデクスとテキストインデクスの作成中」と同じです。

再実行機能の適用可否

適用されます。※4

表の状態

更新不可状態です。

インデクスの状態

レンジインデクスのインポートは完了しています。

B-treeインデクスおよびテキストインデクスは未完状態です。

指定なし（追加モード）

再実行機能の適用可否

適用されません。※3

表の状態

adbimportコマンド実行前の状態です。

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは，adbimportコマンド実行前の状態です。

サーバ定義のadb_cmd_ixrec_file_useオペランドにSINGLE-USE（省略値）を指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「表データ部の作成中」と同じです。

サーバ定義のadb_cmd_ixrec_file_useオペランドにREUSABLEを指定した場合

再実行機能の適用可否，表の状態，およびインデクスの状態は，「B-treeインデクスとテキストインデクスの作成中」と同じです。

再実行機能の適用可否

適用されます。※4

表の状態

更新不可状態です。

インデクスの状態

レンジインデクスのインポートは完了しています。

B-treeインデクスおよびテキストインデクスは，adbimportコマンド実行前の状態です。

（凡例）

再実行機能：B-treeインデクスとテキストインデクス作成処理からの再実行機能

注

B-treeインデクスには，主キーに対応するB-treeインデクスも含まれます。

注※1

中断のタイミングは，次に示すように出力されたメッセージで確認できます。

注※2

KFAA80204-Iメッセージ（リターンコードが0または4）が出力されている場合は，表およびインデクスのインポート処理が完了しています。この場合，adbimportコマンドの再実行は不要です。

KFAA80204-Iメッセージが出力されていない場合は，次のコマンドを実行して出力結果の2行目を確認してください（出力結果の1行目は列のタイトルです）。

adbdbstatus -c table -n adbimportコマンドが中断した表名

adbimportコマンドが中断した表名は，「スキーマ名.表識別子」の形式で指定します。

■Command_status列（17列目）の値がabort，かつRerun_command列（18列目）の値がadbimportのとき

インポート処理が完了していません。adbimportコマンドを再実行してください。

■Command_status列（17列目）およびRerun_command列（18列目）に値が出力されていないとき

インポート処理が完了しています。adbimportコマンドの再実行は不要です。

注※3

adbimportコマンドの再実行時，データインポート処理を最初から行います。

注※4

adbimportコマンドの再実行時，B-treeインデクスおよびテキストインデクスの作成処理からデータインポート処理を再開します。ただし，adbimportコマンドの再実行前に，処理対象表に定義されているB-treeインデクスおよびテキストインデクスをすべて削除した場合は，コマンドの終了処理だけ実行します。

17.10.6　再実行時にコマンドオプションおよびインポートオプションを変更する場合

ここでは，adbimportコマンドの再実行時に，コマンドオプションおよびインポートオプションを変更する場合の動作について示します。

(1)　コマンドオプションを変更する場合

変更したコマンドオプションが有効になるかどうかは，adbimportコマンドの中断タイミングによって異なります。コマンドオプションを変更する場合の再開時の動作について，次の表に示します。

表17‒18　コマンドオプションを変更する場合の再開時の動作

項番

変更するコマンドオプション

中断のタイミング※

表データ部の作成中

ソート処理中

B-treeインデクスとテキストインデクスの作成中

1

-uオプション

×

×

×

2

-pオプション

×

×

×

3

-dオプション

○

−

−

4

-kオプション

○

−

−

5

-sオプション

○

−

−

6

-gオプション

○

−

−

7

-wオプション

○

−

−

8

-zオプション

○

○

○

9

-eオプション

○

−

−

10

--forceオプション

--forceを指定すると処理の初めから強制実行されるため，該当しません。

11

-bオプション

○

−

−

12

--status waitオプション

○

−

−

13

-mオプション

○

○

○

14

-fオプション

○

−

−

15

-rオプション

○

−

−

16

処理対象表

×

×

×

17

入力データパスファイル名

○

−

−

（凡例）

○：変更が有効になります。

×：変更すると，再実行となりません。

−：変更しても無視されます（変更前の指定で実行されます）。

注※

中断のタイミングについては，「表17‒17　adbimportコマンドの中断タイミングによるB-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否」を参照してください。

(2)　インポートオプションを変更する場合

変更したインポートオプションが有効になるかどうかは，adbimportコマンドの中断タイミングによって異なります。インポートオプションを変更する場合の再開時の動作について，次の表に示します。

表17‒19　インポートオプションを変更する場合の再開時の動作

項番

変更するインポートオプション

中断のタイミング※

表データ部の作成中

ソート処理中

B-treeインデクスとテキストインデクスの作成中

1

adb_import_errdata_file_name

○

−

−

2

adb_import_errdata_num

○

−

−

3

adb_import_errmsg_lv

○

−

−

4

adb_import_rthd_num

○

○

○

5

adb_import_read_size

○

−

−

6

adb_import_buff_blk_num

○

−

−

7

adb_import_sort_buff_size

○

○

−

8

adb_import_dividx_rd_buff_size

○

○

○

9

adb_import_dividx_wt_buff_size

○

○

○

10

adb_import_txt_buff_size

○

○

○

11

adb_import_decompress_buff_size

○

−

−

12

adb_import_dvbix_rthd_use

×

×

×

13

adb_import_null_string

○

−

−

（凡例）

○：変更が有効になります。

−：変更しても無視されます（変更前の指定で実行されます）。

×：指定は無視されます（FIXEDが指定されたと仮定して実行されます）。なお，サーバ定義adb_cmd_dvbix_rthd_useオペランドが指定されていても，その指定も無視されます。

注※

中断のタイミングについては，「表17‒17　adbimportコマンドの中断タイミングによるB-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否」を参照してください。

17.10.7　adbimportコマンドの再実行時にエラーが発生した場合

adbimportコマンドの再実行時にエラーが発生した場合は，次に示す手順で障害原因を特定し，対処してください。

手順

KFAA50244-Eメッセージが出力されているかどうかを確認する

KFAA50244-Eメッセージが出力されている場合は，コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラーが発生しています。--forceオプションを指定してadbidxrebuildコマンドを実行してください。adbidxrebuildコマンドで，adbimportコマンドのインデクス作成処理を引き継ぐことができます。

詳細については，「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

KFAA50244-Eメッセージが出力されていない場合は，次のどちらかの手順に進んでください。

adbimportコマンドが中断した状態で処理対象表にインデクスを定義したとき

手順2.に進んでください。

adbimportコマンドが中断した状態で処理対象表にインデクスを定義していないとき

手順3.に進んでください。

KFAA50209-Eメッセージが出力されているかどうかを確認する

KFAA50209-Eメッセージが出力されている場合は，未完状態のインデクスが存在するため，adbimportコマンドを再実行できなくなっています。--forceオプションを指定してadbidxrebuildコマンドを実行してください。adbidxrebuildコマンドで，adbimportコマンドのインデクス作成処理を引き継ぐことができます。

詳細については，「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

KFAA50209-Eメッセージが出力されていない場合は，手順3.に進んでください。

KFAA50247-Eメッセージが出力されているかどうかを確認する

KFAA50247-Eメッセージが出力されている場合は，作業用一時ファイルに対するアクセスエラーが発生しています。--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。adbidxrebuildコマンドで，adbimportコマンドのインデクス作成処理を引き継ぐことができます。

詳細については，「(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

KFAA50247-Eメッセージが出力されていない場合は，手順4.に進んでください。

KFAA50209-E，KFAA50244-EおよびKFAA50247-Eメッセージ以外のメッセージを確認する

出力されたメッセージを確認して，障害原因を特定してください。障害原因の対処を行ったあとで，adbimportコマンドを実行してください。

なお，adbidxrebuildコマンドによるインデクス作成処理の引き継ぎの概要については，「16.1.3　adbidxrebuildコマンドのオプション機能」の「(2)　adbimportコマンドからのインデクス作成処理の引き継ぎ」を参照してください。

(1)　--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行するケース

KFAA50247-Eメッセージが出力された場合は，作業用一時ファイルに対するアクセスエラーが発生しています。--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。

重要

adbimportコマンドのコマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）は，実行したadbidxrebuildコマンドが正常終了するまで削除しないでください。adbidxrebuildコマンド実行時にコマンドステータスファイルが存在しない場合は，adbidxrebuildコマンドがエラーになることがあります（KFAA50244-Eメッセージが出力されます）。このときは，--create-temp-fileオプションではなく，--forceオプションを指定してadbidxrebuildコマンドを実行してください。

adbidxrebuildコマンドの--create-temp-fileオプションは，再実行に必要な作業用一時ファイル（インデクスレコードファイルまたはソート結果用ファイル）が存在しない場合に指定することを想定しています。もし，作業用一時ファイルが存在する場合にadbidxrebuildコマンドを実行すると，存在するファイルは再作成されます。ただし，対象のファイルへの書き込み権限または読み取り権限がないと，adbidxrebuildコマンド実行時にアクセスエラーになることがあります（KFAA30959-Eメッセージ，KFAA40204-Eメッセージ，KFAA40205-Eメッセージ，KFAA40214-Eメッセージ，KFAA41205-Eメッセージ，またはKFAA41206-Iメッセージが出力されます。エラー番号には13(EACCES)が出力されます）。このときは，OSのrmコマンドなどで該当するファイルを削除してから，adbidxrebuildコマンドをもう一度実行してください。

adbidxrebuildコマンドに--create-temp-fileオプションを指定すると，adbimportコマンドに指定していたオプションの内容を引き継いで，adbidxrebuildコマンドが実行されます。-bオプション，-mオプション，または--status waitオプションを指定していた場合も，指定内容が引き継がれます。

なお，これらのオプションはadbimportコマンドのオプションのため，adbidxrebuildコマンドには指定できません。あくまで，--create-temp-fileオプションを指定した場合に引き継ぐだけです。

--create-temp-fileオプションを指定したadbidxrebuildコマンドが中断した場合，中断後にadbidxrebuildコマンドを実行すると，--create-temp-fileオプションの指定に関係なく，処理が中断したチャンクの表の検索からインデクス再作成処理が再開されます。

--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行する場合の，adbidxrebuildコマンドに指定する内容を次の表に示します。

表17‒20　adbidxrebuildコマンドに指定する内容（--create-temp-fileオプションの場合）

項番

adbidxrebuildコマンドの指定形式

中断したadbimportコマンドからオプションを変更できるかどうか

備考

1

adbidxrebuild

adbidxrebuildを指定します。

−

2

-u 認可識別子

×

−

3

〔-p パスワード〕

×

−

4

〔-g インデクス再作成処理の経過メッセージ出力間隔〕

△

−

5

〔-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕

○

作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

6

〔-z インデクス再作成オプションファイル名〕

○

インデクス再作成オプションの指定値については，「表17‒21　インポートオプションと対応するインデクス再作成オプション（--create-temp-fileオプションの場合）」を参照してください。

7

〔-i インデクス識別子ファイル名〕

オプションを指定する必要はありません（指定しても無視されます）。

処理対象表に定義したインデクスが対象になります。

8

〔｛--create-temp-file｜--force｝〕

--create-temp-fileを指定します。

−

9

処理対象表

×

−

（凡例）

○：中断したadbimportコマンドのオプションから，指定値を変更できます。

△：オプションの指定は任意です。

×：中断したadbimportコマンドのオプションから，指定値を変更できません。

−：該当しません。

また，中断したadbimportコマンド実行時に指定したインポートオプションと対応するインデクス再作成オプションがある場合は，インポートオプションに指定した値と同じ値を目安として指定してください。なお，インポートオプションに指定した値と異なる値をインデクス再作成オプションに指定した場合は，インデクス再作成オプションに指定した値でadbidxrebuildコマンドが実行されます。

インポートオプションと対応するインデクス再作成オプションを次の表に示します。

表17‒21　インポートオプションと対応するインデクス再作成オプション（--create-temp-fileオプションの場合）

項番

インポートオプション

対応するインデクス再作成オプション

1

adb_import_errdata_file_name

×

2

adb_import_errdata_num

×

3

adb_import_errmsg_lv

×

4

adb_import_rthd_num

adb_idxrebuild_rthd_num※1

5

adb_import_read_size

×

6

−

adb_idxrebuild_scan_buff_size

7

adb_import_buff_blk_num

adb_idxrebuild_buff_blk_num

8

adb_import_sort_buff_size

adb_idxrebuild_sort_buff_size

9

adb_import_dividx_rd_buff_size

adb_idxrebuild_dvix_rdbuff_size

10

adb_import_dividx_wt_buff_size

adb_idxrebuild_dvix_wtbuff_size

11

adb_import_txt_buff_size

adb_idxrebuild_txt_buff_size

12

adb_import_decompress_buff_size

×

13

adb_import_dvbix_rthd_use

adb_idxrebuild_dvbix_rthd_use※2

14

adb_import_null_string

×

（凡例）

×：対応するインデクス再作成オプションはありません。

−：該当するインポートオプションはありません。インデクス再作成オプションの指定値の目安を参照して，値を設定してください。インデクス再作成オプションの指定値の目安については，「16.2.2　インデクス再作成オプションの形式」の「(2)　指定形式の説明」を参照してください。

注※1

インポートオプションadb_import_rthd_numに3未満の値を指定していた場合，インデクス再作成オプションadb_idxrebuild_rthd_numには3を指定してください。

注※2

adbimportコマンドの実行が中断したあとにadbidxrebuildコマンドを実行する場合，インデクス再作成オプションadb_idxrebuild_dvbix_rthd_useの指定は無視されます。インデクス再作成オプションadb_idxrebuild_dvbix_rthd_useにFIXEDが指定されたと仮定して，adbidxrebuildコマンドが実行されます。なお，サーバ定義adb_cmd_dvbix_rthd_useオペランドが指定されていても，その指定も無視されます。

(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース

次に示す場合は，--forceオプションを指定してadbidxrebuildコマンドを実行する必要があります。

adbimportコマンドが中断した状態で処理対象表にインデクスを定義し，adbimportコマンドの再実行時にKFAA50209-Eメッセージが出力された場合

未完状態のインデクスが存在するため，adbimportコマンドを再実行できなくなっています。

adbimportコマンドの再実行時にKFAA50244-Eメッセージが出力された場合

コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）に対するアクセスエラーが発生しています。

これらの場合は，次に示す手順で対処してください。

手順

作業用一時ファイルを削除する

次に示すディレクトリ下のファイル（作業用一時ファイル）を，OSのrmコマンドなどで削除してください。書き込み権限または読み取り権限がないファイルがあると，adbidxrebuildコマンドを実行できないことがあります。

前回中断したコマンドの実行時に-wオプションを指定した場合

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ

前回中断したコマンドの実行時に-wオプションを省略した場合

$DBDIR/ADBWORKディレクトリ

--forceオプションを指定してadbidxrebuildコマンドを実行する

--forceオプションを指定してadbidxrebuildコマンドを実行してください。

なお，前回中断したコマンドがバックグラウンドインポートを適用した（-bオプションを指定した）adbimportコマンドだった場合は，手順3.に進んでください。それ以外の場合は，手順3.を実行する必要はありません。

-bオプションを指定してadbimportコマンドを実行する

バックグラウンドインポートを適用した（-bオプションを指定した）adbimportコマンドの中断後に，--forceオプションを指定してadbidxrebuildコマンドを実行すると，adbimportコマンドで処理中だった表データの格納情報は削除されます。このため，adbidxrebuildコマンドが完了したあとに，-bオプションを指定して，中断したadbimportコマンドを再度実行してください。

重要

--forceオプションを指定したadbidxrebuildコマンドが中断した場合，中断後にadbidxrebuildコマンドを実行すると，--forceオプションを指定しなくてもインデクス再作成処理の初めから強制実行されます。このため，--create-temp-fileオプションは指定しても無視されます。インデクス再作成処理の初めから強制実行されるとき，KAFF80215-Iメッセージが出力されます。

--forceオプションを指定してadbidxrebuildコマンドを実行する場合の，adbidxrebuildコマンドに指定する内容を次の表に示します。

表17‒22　adbidxrebuildコマンドに指定する内容（--forceオプションの場合）

項番

adbidxrebuildコマンドの指定形式

中断したadbimportコマンドからオプションを変更できるかどうか

備考

1

adbidxrebuild

adbidxrebuildを指定します。

−

2

-u 認可識別子

○

adbimportコマンドの実行ユーザを削除したり，IMPORT TABLE権限を取り消したりしてadbimport実行時と同じユーザで実行できない状態になっている場合は，REBUILD INDEX権限を持つ認可識別子を指定して，adbidxrebuildコマンドを実行してください。

3

〔-p パスワード〕

○

認可識別子を変更した場合は，認可識別子に対するパスワードを指定してください。

4

〔-g インデクス再作成処理の経過メッセージ出力間隔〕

△

−

5

〔-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕

○

作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

6

〔-z インデクス再作成オプションファイル名〕

○

インデクス再作成オプションの指定値については，「表17‒23　インポートオプションと対応するインデクス再作成オプション（--forceオプションの場合）」を参照してください。

7

〔-i インデクス識別子ファイル名〕

指定する必要はありません（指定しても無視されます）。

処理対象表に定義したインデクスが対象になります。

8

〔｛--create-temp-file｜--force｝〕

--forceを指定します。

−

9

処理対象表

×

−

（凡例）

○：中断したadbimportコマンドのオプションから，指定値を変更できます。

△：オプションの指定は任意です。

×：中断したadbimportコマンドのオプションから，指定値を変更できません。

−：該当しません。

また，中断したadbimportコマンド実行時に指定したインポートオプションと対応するインデクス再作成オプションがある場合は，インポートオプションに指定した値と同じ値を目安として指定してください。なお，インポートオプションに指定した値と異なる値をインデクス再作成オプションに指定した場合は，インデクス再作成オプションに指定した値でadbidxrebuildコマンドが実行されます。

インポートオプションと対応するインデクス再作成オプションを次の表に示します。

表17‒23　インポートオプションと対応するインデクス再作成オプション（--forceオプションの場合）

項番

インポートオプション

対応するインデクス再作成オプション

1

adb_import_errdata_file_name

×

2

adb_import_errdata_num

×

3

adb_import_errmsg_lv

×

4

adb_import_rthd_num

adb_idxrebuild_rthd_num※1

5

adb_import_read_size

×

6

−

adb_idxrebuild_scan_buff_size

7

adb_import_buff_blk_num

adb_idxrebuild_buff_blk_num

8

adb_import_sort_buff_size

adb_idxrebuild_sort_buff_size

9

adb_import_dividx_rd_buff_size

adb_idxrebuild_dvix_rdbuff_size

10

adb_import_dividx_wt_buff_size

adb_idxrebuild_dvix_wtbuff_size

11

adb_import_txt_buff_size

adb_idxrebuild_txt_buff_size

12

adb_import_decompress_buff_size

×

13

adb_import_dvbix_rthd_use

adb_idxrebuild_dvbix_rthd_use※2

14

adb_import_null_string

×

（凡例）

×：対応するインデクス再作成オプションはありません。

−：該当するインポートオプションはありません。インデクス再作成オプションの指定値の目安を参照して，値を設定してください。インデクス再作成オプションの指定値の目安については，「16.2.2　インデクス再作成オプションの形式」の「(2)　指定形式の説明」を参照してください。

注※1

インポートオプションadb_import_rthd_numに3未満の値を指定していた場合，インデクス再作成オプションadb_idxrebuild_rthd_numには3を指定してください。

注※2

adbimportコマンドの実行が中断したあとにadbidxrebuildコマンドを実行する場合，インデクス再作成オプションadb_idxrebuild_dvbix_rthd_useの指定は無視されます。インデクス再作成オプションadb_idxrebuild_dvbix_rthd_useにFIXEDが指定されたと仮定してadbidxrebuildコマンドが実行されます。なお，サーバ定義adb_cmd_dvbix_rthd_useオペランドが指定されていても，その指定も無視されます。

17.11　注意事項

コマンドまたはAPの実行中にadbimportコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbimportコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

adbimportコマンドの実行中は，入力データファイルに対して，ほかのアプリケーションによる読み込みや書き込みを行わないでください。

adbimportコマンドのオプションおよびインポートオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

ユニークインデクス（主キーに対応するB-treeインデクスまたはCREATE INDEX文のUNIQUE指定をしたB-treeインデクス）のキー値の重複があった場合でも，データインポート処理は続行されます。このとき，KFAA61205-Wメッセージ（重複キー値を検出した旨の警告メッセージ）が出力されます。この場合，データインポート対象表およびB-treeインデクスは一意性制約に違反した状態になっているため，重複しているキー値を検索して，対象の行を削除してください（B-treeインデクスが一意性制約に違反した状態であることを，一意性制約違反状態といいます）。そのあとで，adbidxrebuildコマンドを実行して該当するB-treeインデクスを再作成してください。

adbimportコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

データインポート処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbimportコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のデータインポート処理は中断されません（処理が続行されます）。データインポート処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

カラムストア表にデータをインポートした場合，列データの圧縮方式とデータの格納比率に関する情報が，次に示すメッセージに出力されます。

KFAA82000-I：各列の列データの圧縮方式が出力されます。このメッセージは，データインポートを実行するスレッドごとに出力されます。

KFAA82002-I：各列のデータの格納比率が出力されます。

KFAA82003-I：表全体のデータの格納比率が出力されます。

データインポート処理中に作業用のファイル（作業用一時ファイル）が一時的に作成されます。作業用一時ファイルは，adbimportコマンドが正常に終了（リターンコードが0または4の場合）した場合は自動的に削除されますが，adbimportコマンドが正常に終了しなかった場合は削除されないことがあります。

作業用一時ファイルの中にはB-treeインデクスとテキストインデクス作成処理からの再実行機能を使用する際に必要となるファイルが含まれています。そのため，B-treeインデクスとテキストインデクス作成処理からの再実行機能を使用する前に，作業用一時ファイルを削除しないでください。削除すると，B-treeインデクスとテキストインデクス作成処理からの再実行機能を使用できません。

作業用一時ファイルがディスク容量を圧迫するおそれがあるため，次に示す場合は，作業用一時ファイルを定期的に削除することを推奨します。

adbimportコマンドを再実行する必要がない場合

adbidxrebuildコマンドを再実行する必要がない場合

これらの場合は，次に示すディレクトリ下に作業用一時ファイルが残っていないかを定期的に確認し，ファイルがあるときは削除してください。

$DBDIR/ADBSYS/ADBUTL

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ（-wオプションを省略した場合は$DBDIR/ADBWORK）

adbidxrebuildコマンドによるadbimportコマンドからのインデクス作成処理の引き継ぎについて，次の表に示します。

表17‒24　adbidxrebuildコマンドによるadbimportコマンドからのインデクス作成処理の引き継ぎ

項番

中断したコマンド※1

中断後に実行するコマンド

処理が引き継がれるかどうか

コマンド名

オプションの指定

--create-temp-fileオプション

--forceオプション

1

adbimport

adbidxrebuild

指定あり

指定なし

○※2，※3

2

指定なし

指定あり

○※2，※4，※5

3

指定なし

指定なし

×

（凡例）

○：インデクス作成処理を引き継ぐことができます。

×：インデクス作成処理を引き継ぐことができません（KFAA50201-Eメッセージが出力されます）。

注※1

中断したコマンドを確認する場合は，adbdbstatusコマンドで表のサマリ情報を出力してください。出力結果の「Rerun_command」列に中断したコマンド名が出力されています。adbdbstatusコマンドについては，「13.　adbdbstatus（データベースの状態解析）」を参照してください。

なお，adbimportコマンドの中断後に実行したadbidxrebuildコマンドが中断した場合は「Rerun_command」列に「adbidxrebuild」が表示されます。中断したadbidxrebuildコマンドに--create-temp-fileオプションを指定していたときは，--create-temp-fileオプションを指定してadbidxrebuildコマンドをもう一度実行してください。このとき，コマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）にはadbimportコマンドが中断したときの情報が記憶されているため，adbimportコマンドが中断したときの処理中のチャンクについて，インデクスが再作成されます。

注※2

adbidxrebuildコマンドを実行すると，処理対象表に定義したすべてのインデクスが再作成されます。adbidxrebuildコマンドの-iオプションは指定しても無視されます。

注※3

adbimportコマンドの再実行時にKFAA50247-Eメッセージが出力された場合（作業用一時ファイルが存在しない場合）は，--create-temp-fileオプションを指定してadbidxrebuildコマンドを実行してください。そうすると，インデクス作成処理を引き継ぐことができます。

注※4

adbimportコマンドが中断した状態で処理対象表にインデクスを定義し，adbimportコマンドの再実行時にKFAA50209-Eメッセージが出力された場合（未完状態のインデクスが存在する場合）は，--forceオプションを指定してadbidxrebuildコマンドを実行してください。そうすると，インデクス作成処理を引き継ぐことができます。

未完状態のインデクスを確認する場合は，adbdbstatusコマンドでインデクスのサマリ情報を出力して，出力結果の「Unfinished」列を確認してください。インデクスが未完状態の場合，出力結果の「Unfinished」列に，「unfinished」が出力されます。adbdbstatusコマンドについては，「13.　adbdbstatus（データベースの状態解析）」を参照してください。

なお，adbimportコマンドが中断していない場合は，--forceオプションを指定しないでadbidxrebuildコマンドを実行してください。

注※5

adbimportコマンドの中断時にKFAA50244-Eメッセージが出力された場合（コマンドステータスファイルが存在しない場合）は，--forceオプションを指定してadbidxrebuildコマンドを実行してください。そうすると，インデクス作成処理を引き継ぐことができます。

--forceオプションを指定してadbimportコマンドを強制実行する場合，-dオプション（作成モード）も同時に指定する必要があります。このため，強制実行時には表に格納されたデータはすべて削除され，表が初期状態となったあとに入力データが格納されます。adbimportコマンドを強制実行する手順については，「17.2.1　指定形式およびオプションの説明」の「(3)　オプションの説明」の「--force」を参照してください。

新規に定義した表の場合，-dオプションを省略してadbimportコマンドを実行しても，作成モードでデータがインポートされます。したがって，新規に定義した表のデータインポート中にadbimportコマンドが異常終了したときは，「表17‒17　adbimportコマンドの中断タイミングによるB-treeインデクスとテキストインデクス作成処理からの再実行機能の適用可否」の-dオプションの指定あり（作成モード）の対処法を参照してください。

なお，いったんデータを格納したあとにSQL文でデータを0件にした表の場合，-dオプションを省略すると追加モードでデータをインポートします。

adbimportコマンドのオプションまたはインポートオプションに指定する次のディレクトリおよびファイルの絶対パスが重複しないようにしてください。該当するディレクトリおよびファイルを次に示します。

作業用一時ファイルの格納先ディレクトリ（-wオプションで指定，または-wオプションに指定したディレクトリパスファイルに指定）

作業用一時ファイルの格納先を指定したディレクトリパスファイル（-wオプションで指定）

インポートオプションファイル（-zオプションで指定）

列構成情報ファイル（-rオプションで指定）

入力データパスファイル（コマンドオプションで指定）

入力データファイル（入力データパスファイル中に指定）

論理エラーデータファイル（インポートオプションadb_import_errdata_file_nameで指定）

また，上記のディレクトリおよびファイルの絶対パスは，adbimportコマンド以外のプログラムが使用しているディレクトリおよびファイルの絶対パスとも重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。

バックグラウンドインポートを適用して検索系SQLとadbimportコマンドを同時に実行する場合，次の点に注意してください。

検索対象の表およびインポート対象表が同じであるため，I/Oが競合して検索系SQLの性能が低下することがあります。

adbimportコマンドで使用するスレッド数と検索系SQLが使用するスレッド数の合計がサーバ定義のadb_sys_rthd_numオペランドの指定値より大きいときは，先発の処理が終わるまで後発の処理が開始されません（後発の処理は待ち状態になります）。

データインポート中に，adbimportコマンドの実行ユーザを削除したり，実行ユーザが持っているIMPORT TABLE権限を取り消したりしないでください。実行ユーザを削除してしまったり，権限を取り消してしまったりした場合，adbimportコマンドが異常終了した際に，B-treeインデクスとテキストインデクス作成処理からの再実行機能を使用することができません。

誤って実行ユーザを削除してしまった場合，または権限を取り消してしまった場合は，次のどちらかの対処をしてください。

同じユーザでadbimportコマンドを実行できる状態にして，adbimportコマンドを再実行してください。対処方法については，マニュアルHADB　システム構築・運用ガイドの非定期運用のHADBユーザの管理またはアクセス権限の管理を参照してください。

処理対象表に対するREBUILD INDEX権限を持つ別のユーザで，--forceオプションを指定してadbidxrebuildコマンドを実行してください。adbimportコマンドの中断後に，--forceオプションを指定してadbidxrebuildコマンドを実行する方法については，「17.10.7　adbimportコマンドの再実行時にエラーが発生した場合」の「(2)　--forceオプションを指定してadbidxrebuildコマンドを実行するケース」を参照してください。

クラウドストレージ機能を使用していない場合に，SQLパラレル実行機能の検索対象表にデータをインポートするときは，マニュアルHADB　システム構築・運用ガイドの実表の運用（マルチノード機能の使用時）の実表にデータを格納する方法（マルチノード機能の使用時）を参照してください。

クラウドストレージ機能を使用している場合，作成モードまたはバックグラウンドインポートでデータをインポートしてください。追加モードでインポートすると，KFAA52202-Eメッセージが出力され，adbimportコマンドがエラーとなります。

adbimportコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbimportコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表17‒25　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

作業用一時ファイルの格納先ディレクトリ※2

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

作業用一時ファイルの格納先を指定したディレクトリパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

インポートオプションファイル

コマンドの実行ユーザ

読み取り権限

列構成情報ファイル

コマンドの実行ユーザ

読み取り権限

入力データパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

入力データパスファイル内に指定する入力データファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

インポートオプションのadb_import_errdata_file_nameオペランドに指定する論理エラーデータファイル※3

HADBサーバプロセスの実行ユーザ

書き込み権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

-wオプションに指定する場合と，作業用一時ファイルの格納先を指定したディレクトリパスファイル内に指定する場合のどちらも該当します。

注※3

adbimportコマンドの実行時にファイルが存在しなかった場合，権限に644を設定した論理エラーデータファイルが作成されます。

18　adbinfoget（トラブルシュート情報の取得）

この章では，adbinfogetコマンドの機能と使い方について説明します。

18.1　機能

adbinfogetコマンドを実行すると，障害原因を調査するためのトラブルシュート情報ファイルを取得できます。また，トラブルシュート情報の出力や，取得するトラブルシュート情報ファイルの出力容量の算出も行えます。

重要

マルチノード機能を使用している場合，adbinfogetコマンドを実行したノードに関するトラブルシュート情報の出力，トラブルシュート情報ファイルの容量見積もり，およびトラブルシュート情報ファイルの取得を行います。そのため，マルチノード機能を使用している場合に障害が発生したときは，全ノードでadbinfogetコマンドを実行して，トラブルシュート情報ファイルを取得してください。

HADBサーバの稼働中に出力されたメッセージの対策方法に，「弊社問い合わせ窓口に連絡してください。」とある場合，このコマンドを実行してトラブルシュート情報ファイルを取得します。adbinfogetコマンドでトラブルシュート情報ファイルを取得する際の流れを次の図に示します。

図18‒1　adbinfogetコマンドでトラブルシュート情報ファイルを取得する際の流れ

トラブルシュート情報の出力（HADBサーバが稼働中の場合）

次に示すトラブルシュート情報は，HADBサーバの異常終了時に出力されます。

コアファイル

HADBダンプ

したがって，APまたはコマンドが終了しない，HADBサーバが無応答状態になったなど，HADBサーバが稼働している状態で障害が発生した場合，上記のトラブルシュート情報は出力されません。このため，障害が発生した直後にトラブルシュート情報ファイルを取得しても，必要な情報を取得できません。

HADBサーバが稼働している状態で障害が発生した場合は，まず上記のトラブルシュート情報を出力してください。そのあとで，以降の手順を実施してください。

メモ

コアファイルはdetail版トラブルシュート情報として出力されます。また，コアファイルの出力には時間が掛かるおそれがあります。このため，detail版トラブルシュート情報を取得しないことがあらかじめわかっている場合は，HADBダンプだけを出力してください。

トラブルシュート情報ファイルの出力容量の算出

トラブルシュート情報ファイルの出力容量を算出します。トラブルシュート情報ファイルには共有メモリの情報などが含まれるため，容量が非常に大きくなります。そのため，トラブルシュート情報ファイルを取得する前に，トラブルシュート情報ファイルの出力容量を確認してください。ディスクに十分な空き容量がないと，必要なトラブルシュート情報ファイルを取得できません。また，ディスク容量を圧迫することで，HADBサーバの性能に影響を及ぼすおそれがあります。

なお，算出される値は，トラブルシュート情報ファイルの取得に必要なディスク容量の最大値であり，実際に出力されるトラブルシュート情報ファイルの容量とは異なります。

トラブルシュート情報ファイルの取得

トラブルシュート情報ファイルには，次の4ファイルがあります。各ファイル名のYYYYMMDDhhmmssはadbinfogetコマンド実行時の時刻になります。

mail版トラブルシュート情報ファイル（adbinfoYYYYMMDDhhmmss_mail.tar.gz）

トラブルシュートに最低限必要な情報だけが格納されます。

light版トラブルシュート情報ファイル（adbinfoYYYYMMDDhhmmss_light.tar.gz）

コアファイルや共有メモリダンプファイルなどを除いた情報が格納されます。

detail版トラブルシュート情報ファイル（adbinfoYYYYMMDDhhmmss_detail.tar.gz）

adbinfogetコマンドで取得できるすべての情報が格納されます。

root版トラブルシュート情報ファイル（adbinfoYYYYMMDDhhmmss_root.tar.gz）

-rオプションを指定したadbinfogetコマンドをスーパユーザで実行した場合に，取得できる追加情報が格納されます。

通常は，mail版，light版，detail版およびroot版のトラブルシュート情報ファイルを取得してください。トラブルシュート情報ファイルの出力容量の算出の結果，detail版トラブルシュート情報ファイルのサイズが大きいため，トラブルシュート情報ファイルの取得に時間が掛かることが予想される場合は，mail版，light版およびroot版のトラブルシュート情報ファイルだけを取得してください。root版のトラブルシュート情報ファイルは，常に取得するようにしてください。

なお，HADBサーバが異常終了した際にこのコマンドを実行した場合，障害発生時のHADBサーバのトラブルシュート情報およびコマンド実行時のOSの状態を取得します。HADBサーバが稼働中または終了している場合，コマンド実行時のHADBサーバのトラブルシュート情報およびOSの状態を取得します。

18.2　adbinfogetコマンドの指定形式

adbinfogetコマンドの指定形式およびオプションについて説明します。

adbinfogetコマンドを実行できるOSユーザは，HADB管理者だけです。

18.2.1　指定形式およびオプションの説明

(1)　指定形式

adbinfoget ｛-g | -m | -o トラブルシュート情報ファイルの出力先ディレクトリ｝
           〔-f コアファイル名〕 〔-l〕 〔-r〕

(2)　adbinfogetコマンド実行の目的とオプションの組み合わせ

adbinfogetコマンドを実行する目的別に，指定するオプションを次の表に示します。

各オプションの詳細については，「(3)　オプションの説明」を参照してください。

表18‒1　adbinfogetコマンドに指定するオプション

項番

adbinfogetコマンド実行の目的

指定するオプション

1

HADBサーバの稼働中にトラブルシュート情報を出力する

detail版トラブルシュート情報ファイル用に情報を出力する（コアファイルおよびHADBダンプを出力する）

-g

2

mail版，light版およびroot版のトラブルシュート情報ファイル用に情報を出力する（HADBダンプだけ出力する）

-gおよび-l

3

トラブルシュート情報ファイルの出力容量を算出する

light版，detail版およびroot版のトラブルシュート情報ファイルの出力容量を算出する※1

-mおよび-r

4

light版，detail版およびroot版のトラブルシュート情報ファイルの出力容量を算出する（トラブルシュート情報ファイルの取得時に-fオプションを指定する場合）

-m，-fおよび-r

5

トラブルシュート情報ファイルを取得する

mail版，light版，detail版およびroot版のトラブルシュート情報ファイルを取得する（取得するコアファイルを指定しない場合※2）

-oおよび-r

6

mail版，light版，detail版およびroot版のトラブルシュート情報ファイルを取得する（-fオプションに指定したコアファイルを取得する場合）

-o，-fおよび-r

7

mail版，light版およびroot版のトラブルシュート情報ファイルを取得する

-o，-lおよび-r

注※1

$DBDIR/SPOOLディレクトリ下，または/var/lib/systemd/coredumpディレクトリ下（コアファイルの出力がsystemd-coredumpによって制御されている場合だけ）にあるコアファイルのうち，最新のコアファイルの容量を含めた値が算出されます。

ただし，サーバ定義のadb_core_pathオペランドを指定しているときは，このオペランドに指定したディレクトリ下，または/var/lib/systemd/coredumpディレクトリ下（コアファイルの出力がsystemd-coredumpによって制御されている場合だけ）にあるコアファイルのうち，最新のコアファイルの容量を含めた値が算出されます。

なお，/var/lib/systemd/coredumpディレクトリ下にある最新のコアファイルが圧縮されている場合は，展開したコアファイルの容量を含めた値が算出されます。

注※2

$DBDIR/SPOOLディレクトリ下，または/var/lib/systemd/coredumpディレクトリ下（コアファイルの出力がsystemd-coredumpによって制御されている場合だけ）にあるコアファイルのうち，最新のコアファイルが取得されます。

ただし，サーバ定義のadb_core_pathオペランドを指定しているときは，このオペランドに指定したディレクトリ下，または/var/lib/systemd/coredumpディレクトリ下（コアファイルの出力がsystemd-coredumpによって制御されている場合だけ）にあるコアファイルのうち，最新のコアファイルが取得されます。

なお，/var/lib/systemd/coredumpディレクトリ下にある最新のコアファイルが圧縮されている場合は，展開したコアファイルが取得されます。

(3)　オプションの説明

●-g

HADBサーバの稼働中に，次の表に示すトラブルシュート情報を出力する場合にこのオプションを指定します。このオプションと同時に-lオプションを指定するかどうかによって，出力される情報が決まります。

表18‒2　出力されるトラブルシュート情報

項番

出力されるトラブルシュート情報

-lオプションを指定しない場合

-lオプションを指定する場合

出力先ディレクトリ

1

コアファイル

○

×

$DBDIR/SPOOLディレクトリ，またはサーバ定義のadb_core_pathオペランドで指定したディレクトリ

2

HADBダンプ

○

○

$ADBDIR/spoolディレクトリ

（凡例）

○：情報が出力されます。

×：情報が出力されません。

情報を出力する間，HADBサーバの動作が一時停止します。

メモ

このオプションを指定できるのは，HADBサーバが稼働しているときだけです。

●-m

トラブルシュート情報ファイルの出力容量を算出する場合にこのオプションを指定します。このオプションを指定した場合，トラブルシュート情報ファイルは取得されません。

このオプションを指定した場合は，light版およびdetail版のトラブルシュート情報ファイルの出力容量が算出されます。

なお，mail版トラブルシュート情報ファイルは，light版トラブルシュート情報ファイルの一部を抜き出して生成します。このため，mail版トラブルシュート情報ファイルの容量見積もりは，light版トラブルシュート情報ファイルの容量見積もりに含まれます。したがって，このオプションを指定しても，mail版トラブルシュート情報ファイル単独の出力容量は算出されません。

●-o トラブルシュート情報ファイルの出力先ディレクトリ

〜〈パス名〉((2〜118バイト))

トラブルシュート情報ファイルを出力するディレクトリを絶対パスで指定します。

なお，ここで指定するディレクトリに対して，HADB管理者の書き込み権限および実行権限を設定しておいてください。

●-f コアファイル名

〜〈パス名〉((2〜510バイト))

通常はこのオプションを省略してください。

次の1.～3.のどれかに該当する場合には，このオプションを指定してください。このオプションには，adbinfogetコマンドで取得対象とするコアファイルを絶対パスで指定します。

HADBサーバ以外のプロセス（コマンドなど）が出力した障害情報（コアファイル）をトラブルシュート情報として取得したい場合

HADBサーバが異常終了したときに出力される障害情報（コアファイル）のうち，最新ではなく，過去の任意の障害情報（コアファイル）をトラブルシュート情報として取得したい場合

次の条件をすべて満たす場合

カーネルパラメタkernel.core_patternを独自に設定している

systemd-coredumpを使用していない

$DBDIR/SPOOLディレクトリ下，またはサーバ定義のadb_core_pathオペランドで指定したディレクトリ下に障害情報（コアファイル）が出力されない

このオプションには，加工されていないELF形式のコアファイルだけ指定できます。アーカイブされたコアファイル（圧縮されたものも含む）などは指定できません。ELF形式以外のコアファイルが指定された場合は，コアファイルは取得されません。

なお，このオプションを省略した場合，次のディレクトリ下にある，HADBサーバが出力したコアファイルの中で最新のコアファイルが取得されます。

$DBDIR/SPOOLディレクトリ

サーバ定義のadb_core_pathオペランドで指定したディレクトリ

/var/lib/systemd/coredumpディレクトリ

●-l

次に示す場合に，このオプションを指定します。

トラブルシュート情報の出力時（-gオプションと同時に指定する場合）

コアファイルの出力が不要な場合は，このオプションを指定してください。このオプションと-gオプションを同時に指定すると，コアファイルは出力されません（HADBダンプだけが出力されます）。

コアファイルのサイズは非常に大きいため，mail版，light版およびroot版のトラブルシュート情報ファイルではコアファイルを取得しません。そのため，detail版トラブルシュート情報を取得しないことがあらかじめわかっている場合は，このオプションと-gオプションを同時に指定してください。-gオプションを指定すると出力されるトラブルシュート情報の詳細については，「表18‒2　出力されるトラブルシュート情報」を参照してください。

-gオプションを指定し，このオプションを省略した場合は，コアファイルおよびHADBダンプが出力されます。

トラブルシュート情報ファイルの取得時（-gオプションと同時に指定しない場合）

detail版トラブルシュート情報ファイルが大き過ぎて取得できない場合は，このオプションを指定してください。このオプションを指定した場合，mail版およびlight版のトラブルシュート情報ファイルを取得します。

このオプションを省略した場合，mail版，light版およびdetail版のトラブルシュート情報ファイルを取得します。

コアファイルのサイズは非常に大きいため，mail版，light版およびroot版のトラブルシュート情報ファイルではコアファイルを取得しません。そのため，-lオプションを指定したときに-fオプションを指定しても，-fオプションに指定したコアファイルは取得されません。

●-r

次に示すどれかの場合に指定します。

light版およびdetail版のトラブルシュート情報の出力容量に加えて，root版トラブルシュート情報ファイルの出力容量を算出する場合

mail版，light版およびdetail版のトラブルシュート情報に加えて，root版トラブルシュート情報ファイルを取得する場合

mail版およびlight版のトラブルシュート情報に加えて，root版トラブルシュート情報ファイルを取得する場合

このオプションを指定してadbinfogetコマンドを実行すると，adbinfogetコマンド内部でOSのsuコマンドを実行します。そして，root権限が必要なOSのコマンドを実行したり，root権限が必要なシステムファイルを参照したりしてroot版トラブルシュート情報ファイルを取得します。このため，このオプションを指定してadbinfogetコマンドを実行した場合は，要求に応じてスーパユーザのパスワードを入力してください。

OSのsuコマンドの実行に失敗した場合，すべての（detail版，light版，mail版およびroot版）トラブルシュート情報ファイルの出力容量が算出されません。また，すべてのトラブルシュート情報ファイルが取得されません。

18.3　格納されるトラブルシュート情報の一覧

mail版，light版，detail版およびroot版のトラブルシュート情報ファイルに格納されるトラブルシュート情報について，次の表に示します。

表18‒3　格納されるトラブルシュート情報

項番

トラブルシュート情報

mail版

light版

detail版

root版

分類

内容

1

HADBのコマンドを実行して取得する情報

HADBサーバの状態

○

○

○

×

2

コネクションの状態

○

○

○

×

3

スレッドの状態

○

○

○

×

4

擬似スレッドの情報

○

○

○

×

5

エラーモジュールのトレース情報

○

○

○

×

6

メモリの使用状況

○

○

○

×

7

共有メモリ情報

○

○

○

×

8

グローバルバッファの情報

○

○

○

×

9

ローカル作業表用バッファの情報

○

○

○

×

10

HADBサーバのバージョン情報

○

○

○

×

11

排他資源の確保要求の状態

○

○

○

×

12

ノードの情報

○

○

○

×

13

クライアントグループおよびコマンドグループの情報

○

○

○

×

14

SQLパラレル実行機能の情報

○

○

○

×

15

キャッシュファイルの情報

○

○

○

×

16

共有メモリダンプ

×

×

○

×

17

バッファトレース

×

×

○

×

18

HADBダンプ

△

○

○

×

19

adbinfogetコマンドのログ

○

○

○

○

20

更新行のカラム化機能の状態

○

○

○

×

21

HADBサーバが参照する定義および出力ファイル

$ADBDIR/conf下の全ディレクトリおよびファイル

○

○

○

×

22

$ADBDIR/spool下のファイル

△

△

○

×

23

障害情報（コアファイル）

$DBDIRディレクトリ下のコアファイル

サーバ定義のadb_core_pathオペランドで指定したディレクトリ下のコアファイル

systemd-coredumpによって管理されているコアファイル

△

△

○

×

24

統計ログファイル

△

△

○

×

25

$ADBCLTDIR※1/conf下の全ディレクトリおよびファイル

○

○

○

×

26

$ADBCLTDIR※1/spool下のファイル

△

△

○

×

27

SQLトレースファイル

△

△

○

×

28

アクセスパス探索情報ログファイル

×

○

○

×

29

監査証跡ファイルの一覧情報

adb_audit_log_pathオペランドに指定したディレクトリ下のファイル一覧

○

○

○

×

30

HADBライブラリ情報

○

○

○

×

31

同義語辞書情報

adb_syndict_storage_pathオペランドに指定したディレクトリ下のファイル一覧

adb_syndict_node_storage_pathオペランドに指定したディレクトリ下のファイル一覧

○

○

○

×

32

キャッシュファイルの一覧情報

adb_sys_cld_cache_pathオペランドに指定したディレクトリ下のファイル一覧

○

○

○

×

33

OSのコマンドを実行して取得する情報

CPU利用率

○

○

○

×

34

プロセスのCPU稼働状況

○

○

○

×

35

プロセス情報

○

○

○

×

36

スレッド情報

○

○

○

×

37

メモリ状態

○

○

○

×

38

共有メモリ状態

○

○

○

×

39

ディスク情報

○

○

○

×

40

ディスク状況

○

○

○

×

41

ネットワークステータス情報

○

○

○

×

42

ネットワーク情報

○

○

○

×

43

カーネルパラメタ

○

○

○

×

44

システム情報

○

○

○

×

45

パッケージ情報

○

○

○

×

46

環境変数の情報

○

○

○

×

47

ホスト名称

○

○

○

×

48

バックトレース情報

○

○

○

×

49

コアファイル情報

○

○

○

×

50

カーネルログ

○

○

○

×

51

システムリソース制限情報

○

○

○

×

52

libc.soのバージョン情報

○

○

○

×

53

通信情報

○

○

○

×

54

ユーザ情報

○

○

○

×

55

デバイス構成情報

○

○

○

×

56

LVM構成情報

×

×

×

○

57

VG情報

×

×

×

○

58

PV情報

×

×

×

○

59

OSが参照する定義および出力ファイル

カーネル情報

○

○

○

×

60

プロセッサ情報

○

○

○

×

61

メモリ情報

○

○

○

×

62

ディスク情報

○

○

○

×

63

map情報

○

○

○

×

64

スタック情報

×

×

×

○

65

ディスクリプタ情報

○

○

○

×

66

ulimit情報

○

○

○

×

67

OS情報

○

○

○

×

68

syslog

○

○

○

○

69

systemdに関する情報

○

○

○

×

70

AWS CLIを実行して取得する情報※2

S3バケット内のS3オブジェクト名の一覧

○

○

○

×

71

Azure CLIを実行して取得する情報※3

コンテナー内のBLOB名の一覧

○

○

○

×

（凡例）

○：格納されます。

△：情報の一部が格納されます。

×：格納されません。

注※1

サーバマシンの環境変数ADBCLTDIRに指定したディレクトリパスです。なお，環境変数ADBCLTDIRを指定していない場合は，情報が格納されません。

注※2

サーバ定義にadb_sys_cld_aws_bucketオペランドを指定していない場合は，情報が格納されません。

注※3

サーバ定義にadb_sys_cld_az_storage_accountオペランドおよびadb_sys_cld_az_containerオペランドを指定していない場合は，情報が格納されません。

18.4　使用例

adbinfogetコマンドの使い方を説明します。

18.4.1　mail版，light版，detail版およびroot版のトラブルシュート情報ファイルを取得する場合

mail版，light版，detail版およびroot版のトラブルシュート情報ファイルを取得します。

トラブルシュート情報ファイルの出力容量を算出する

adbinfoget -m -r

KFAA91401-I adbinfoget processing started.
KFAA91404-I The troubleshooting information (detail) output by the adbinfoget command is 38737721219 bytes.
KFAA91404-I The troubleshooting information (light, mail) output by the adbinfoget command is 9053448 bytes.
パスワード:※
KFAA91404-I The troubleshooting information (root) output by the adbinfoget command is 7995597 bytes.
KFAA91402-I adbinfoget processing ended. (return code = 0)

下線部分に，次に示すトラブルシュート情報ファイルの出力容量が表示されます。

detail版のトラブルシュート情報ファイルの出力容量

mail版およびlight版のトラブルシュート情報ファイルの出力容量

root版のトラブルシュート情報ファイルの出力容量

注※

「パスワード:」と表示されたときに，スーパユーザのパスワードを入力してください。

なお，「パスワード:」という表示は，ロケールによって異なります。

トラブルシュート情報ファイルを取得する

1の操作で出力容量を算出した結果，ディスク容量などに問題がない場合は，トラブルシュート情報ファイルを取得します。

adbinfoget -o /home/adbmanager -r

KFAA91401-I adbinfoget processing started.
KFAA91406-I Creation of a light-version troubleshooting information file started.
KFAA91407-I Creation of a light-version troubleshooting information file is complete.
KFAA91408-I Creation of a detail-version troubleshooting information file started.
KFAA91409-I Creation of a detail-version troubleshooting information file is complete.
パスワード:※
KFAA91410-I Creation of a root-version troubleshooting information file started.
KFAA91411-I Creation of a root-version troubleshooting information file is complete.
KFAA91402-I adbinfoget processing ended. (return code = 0)

注※

「パスワード:」と表示されたときに，スーパユーザのパスワードを入力してください。

なお，「パスワード:」という表示は，ロケールによって異なります。

18.4.2　mail版，light版およびroot版のトラブルシュート情報ファイルを取得する場合

mail版，light版およびroot版のトラブルシュート情報ファイルを取得します。

トラブルシュート情報ファイルの出力容量を算出する

adbinfoget -m -r

KFAA91401-I adbinfoget processing started.
KFAA91404-I The troubleshooting information (detail) output by the adbinfoget command is 38737721219 bytes.
KFAA91404-I The troubleshooting information (light, mail) output by the adbinfoget command is 9053448 bytes.
パスワード:※
KFAA91404-I The troubleshooting information (root) output by the adbinfoget command is 7995597 bytes.
KFAA91402-I adbinfoget processing ended. (return code = 0)

下線部分に，次に示すトラブルシュート情報ファイルの出力容量が表示されます。

mail版およびlight版のトラブルシュート情報ファイルの出力容量

root版のトラブルシュート情報ファイルの出力容量

注※

「パスワード:」と表示されたときに，スーパユーザのパスワードを入力してください。

なお，「パスワード:」という表示は，ロケールによって異なります。

トラブルシュート情報ファイルを取得する

1の操作で出力容量を算出した結果，ディスク容量などに問題がない場合は，トラブルシュート情報ファイルを取得します。

adbinfoget -o /home/adbmanager -l -r

KFAA91401-I adbinfoget processing started.
KFAA91406-I Creation of a light-version troubleshooting information file started.
KFAA91407-I Creation of a light-version troubleshooting information file is complete.
パスワード:※
KFAA91410-I Creation of a root-version troubleshooting information file started.
KFAA91411-I Creation of a root-version troubleshooting information file is complete.
KFAA91402-I adbinfoget processing ended. (return code = 0)

注※

「パスワード:」と表示されたときに，スーパユーザのパスワードを入力してください。

なお，「パスワード:」という表示は，ロケールによって異なります。

18.5　リターンコード

adbinfogetコマンドのリターンコードを次の表に示します。

表18‒4　adbinfogetコマンドのリターンコード

リターンコード

意味

0

adbinfogetコマンドが正常に終了しました。

4

adbinfogetコマンドの実行中にエラーが発生しましたが，トラブルシュート情報ファイルは取得できました。エラーが発生した原因については，表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認してください。

8

adbinfogetコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

18.6　注意事項

adbinfogetコマンドを実行するには，環境変数ADBDIRが設定されている必要があります。

adbinfogetコマンドはHADBサーバの状態に関係なく実行できます。ただし，-gオプションを指定する場合は，HADBサーバの稼働中に実行してください。

adbinfogetコマンドが異常終了した場合，トラブルシュート情報ファイルの出力先ディレクトリ下に作業用のディレクトリ（ディレクトリ名：adbinfo＜コマンドの実行日時＞）が削除されないで残ることがあります。この場合，OSのrmコマンドでこの作業用のディレクトリを削除してください。

adbinfogetコマンドの延長でHADBのコマンド（adblsコマンドなど）が実行されます。このコマンドの実行に失敗した場合，標準エラー出力またはメッセージログファイルにエラーメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadbinfogetコマンドを再実行してください。

adbinitコマンドの実行中にadbinfogetコマンドを実行しないでください。実行した場合，adbinitコマンドまたはadbinfogetコマンドの延長で実行されるコマンドが異常終了したり，不正なトラブルシュート情報を取得したりすることがあります。

サーバ定義の指定内容によっては，detail版のトラブルシュート情報ファイルの取得に非常に時間が掛かることがあります。トラブルシュート情報ファイルの取得を中止する場合は，［Ctrl］＋［C］キーや，OSのkillコマンドなどでadbinfogetコマンドのプロセスを終了してください。その後，adbinfogetコマンドに-lオプションを指定し，mail版およびlight版のトラブルシュート情報ファイルを取得するようにしてください。

adbinfogetコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbinfogetコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表18‒5　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※

必要な権限

トラブルシュート情報ファイルの出力先ディレクトリ

コマンドの実行ユーザ

読み取り権限

書き込み権限

実行権限

コアファイル

コマンドの実行ユーザ

読み取り権限

注※

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

19　adbinfosweep（トラブルシュート情報の削除）

この章では，adbinfosweepコマンドの機能と使い方について説明します。

19.1　機能

adbinfosweepコマンドを実行すると，HADBサーバが出力したトラブルシュート情報を削除できます。

マルチノード機能を使用している場合は，adbinfosweepコマンドを実行したノードのHADBサーバが出力したトラブルシュート情報だけが削除されます。

削除できるトラブルシュート情報を次に示します。

障害情報（コアファイル）（$DBDIR/SPOOL/core.*またはサーバ定義のadb_core_pathオペランドで指定したパス/core.*）※1

サーバ定義格納ファイル（$ADBDIR/spool/.defrslt）

HADBダンプファイル（$ADBDIR/spool/adbdumpYYYYMMDDhhmmss.サーバプロセスのプロセスID※2，$ADBDIR/spool/adbdumperrorYYYYMMDDhhmmssSSSSSS_TTTTTTTTTTTTTTTTTTTT.サーバプロセスのプロセスID※3）

HADBサーバのプロセスID格納ファイル（$ADBDIR/spool/adbsrvd.pid）

注※1

systemd-coredumpによって管理されているコアファイル（/var/lib/systemd/coredumpディレクトリ下のコアファイル）は削除されません。

注※2

ファイル名のYYYYMMDDhhmmssは，ファイルを生成した時刻になります。

注※3

ファイル名のYYYYMMDDhhmmssSSSSSSは，ファイルを生成した時刻になります。

ファイル名のTTTTTTTTTTTTTTTTTTTTは，内部矛盾エラーが発生したリアルスレッドのスレッドIDになります。

19.2　adbinfosweepコマンドの指定形式

adbinfosweepコマンドの指定形式について説明します。

adbinfosweep

adbinfosweepコマンドを実行できるOSユーザは，HADB管理者だけです。

19.3　リターンコード

adbinfosweepコマンドのリターンコードを次の表に示します。

表19‒1　adbinfosweepコマンドのリターンコード

リターンコード

意味

0

adbinfosweepコマンドが正常に終了しました。

8

adbinfosweepコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

19.4　注意事項

adbinfosweepコマンドを実行するには，環境変数ADBDIRが設定されている必要があります。

adbinfosweepコマンドは，HADBサーバを終了させてから実行してください。

adbinfosweepコマンドの延長でOSのコマンドが実行されます。このOSのコマンドの実行に失敗した場合，標準エラー出力にエラーメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadbinfosweepコマンドを再実行してください。

adbinfosweepコマンドの延長でHADBのコマンドが実行されます。このコマンドの実行に失敗した場合，標準エラー出力またはメッセージログファイルにエラーメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadbinfosweepコマンドを再実行してください。

adbinitコマンドの実行中にadbinfosweepコマンドを実行しないでください。実行した場合，adbinitコマンドまたはadbinfosweepコマンドが異常終了することがあります。

HADBサーバの開始処理中または終了処理中にadbinfosweepコマンドを実行しないでください。実行した場合，HADBサーバまたはadbinfosweepコマンドが異常終了することがあります。

adbinfosweepコマンドを複数同時に実行しないでください。adbinfosweepコマンドが異常終了することがあります。

20　adbinit（データベースの初期設定）

この章では，adbinitコマンドの機能と使い方について説明します。

20.1　機能

adbinitコマンドは，HADBの初期設定時に実行するコマンドです。adbinitコマンドを実行すると，次の表に示すDBエリアが作成されます。

重要

特定のDBエリアの追加・変更を行いたい場合は，adbinitコマンドではなくadbmodareaコマンドを使用します。adbmodareaコマンドの詳細については，「37.　adbmodarea（DBエリアの追加・変更）」を参照してください。

表20‒1　adbinitコマンドを実行すると作成されるDBエリア

項番

作成されるDBエリア

説明

1

マスタディレクトリ用DBエリア

adbinitコマンドを実行すると自動的に作成されます。

2

ディクショナリ用DBエリア

3

作業表用DBエリア

4

システム表用DBエリア

5

データ用DBエリア

初期設定オプションのadbinitdbareaオペランドで，作成するDBエリアを定義します。

各DBエリアはDBエリアファイルで構成されます。各DBエリアのDBエリアファイルとして，DBディレクトリ下のレギュラーファイルまたはブロックスペシャルファイル，どちらも割り当てることができますが，ブロックスペシャルファイルを割り当てることを推奨します。どちらを割り当てるかはadbinitコマンドの初期設定オプションで指定します。

メモ

新しく作成するDBエリアファイルと同じパス名のファイルが存在する状態でadbinitコマンドを実行すると，そのDBエリア（データ用DBエリア以外のDBエリアも含む）は上書きされます。

■クラウドストレージ機能を使用する場合

作業表用DBエリア以外のDBエリア

AWS環境のときは，次のDBエリアのデータは，S3バケット内のS3オブジェクトに格納されます。Azure環境のときは，次のDBエリアのデータは，コンテナー内のBLOBに格納されます。

データ用DBエリア

マスタディレクトリ用DBエリア

ディクショナリ用DBエリア

システム表用DBエリア

クラウドストレージ機能を使用する場合，上記のDBエリアのDBエリアファイルは作成されませんが，HADBサーバは，上記の各DBエリアのデータを格納しているS3オブジェクト群またはBLOB群を概念的なDBエリアファイル（仮想DBエリアファイル）に格納していると仮定して動作します。クラウドストレージ機能および仮想DBエリアファイルの詳細については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

作業表用DBエリア

作業表用DBエリアの場合，作業表用DBエリアファイルが作成されます。作業表用DBエリアファイルは，DBディレクトリ下のレギュラーファイルまたはブロックスペシャルファイル，どちらも割り当てることができますが，ブロックスペシャルファイルを割り当てることを推奨します。どちらを割り当てるかはadbinitコマンドの初期設定オプションで指定します。

メモ

AWS環境の場合，S3バケット内にHADBサーバが作成したS3オブジェクトが存在する状態でadbinitコマンドを実行すると，それらのS3オブジェクトがすべて削除されます（ADBDIRPなどのプレフィックスの付いたS3オブジェクトがまとめて削除されます）。

Azure環境の場合は，S3バケットをコンテナーに読み替えてください。また，S3オブジェクトをBLOBに読み替えてください。

20.2　adbinitコマンドの指定形式

adbinitコマンドの指定形式，および初期設定オプションの形式について説明します。

adbinitコマンドを実行できるOSユーザは，HADB管理者だけです。

20.2.1　指定形式およびオプションの説明

(1)　指定形式

adbinit
    -u 認可識別子
  〔-p パスワード〕
  初期設定オプションファイル名
  DBディレクトリ名

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

HADBサーバの初期設定時に作成される，1人目のHADBユーザの認可識別子を指定します。なお，この1人目のHADBユーザには，DBA権限とCONNECT権限が自動的に付与されます。

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

指定時の規則を次に示します。

認可識別子に使用できる文字は，半角の英大文字，半角の英小文字，半角の数字，¥（バックスラッシュ），#，および@です。

認可識別子の文字列中に英小文字がある場合は，認可識別子を¥"（バックスラッシュと二重引用符）で囲んでください。または，認可識別子を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲んでください。

（例1）-u ¥"ADBuser01¥"

（例2）-u '"ADBuser01"'

上記のように指定しないと，認可識別子の文字列はすべて英大文字と見なされます。例えば，「-u ADBuser01」と指定した場合，「-u ADBUSER01」と指定したと見なされます。

認可識別子の文字列中に¥がある場合は，¥の直前にエスケープ文字（¥）を指定してください。または，認可識別子をアポストロフィ（'）で囲んでください。

（例1）-u ADBUSER¥¥01

（例2）-u 'ADBUSER¥01'

この場合，ADBUSER¥01が認可識別子として指定されます。

認可識別子の指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの認可識別子の指定規則を参照してください。

メモ

初期設定後，HADBサーバに接続するために，adbinitコマンドで指定した認可識別子およびパスワードが必要になります。

●-p パスワード

〜〈文字列〉((1〜255バイト))

HADBサーバの初期設定時に作成される，1人目のHADBユーザのパスワードを指定します。

指定時の規則を次に示します。

パスワードに使用できる文字は，半角の英大文字，半角の英小文字，半角の数字，および次に示す半角の記号です。

¥ @ ` ! " # $ % & ' ( ) * : + ; [ ] { } , = < > | - . ^ ~ / ? _

-uオプションに指定する認可識別子とは異なり，パスワードの指定は英大文字と英小文字が区別されます。

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字がパスワードに含まれる場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，パスワードをアポストロフィ（'）で囲んでください。

（例1）-p Password¥|01

（例2）-p 'Password|01'

この場合，Password|01がパスワードとして指定されます。

パスワードの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドのパスワードの指定規則を参照してください。

なお，このオプションを省略してadbinitコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。その場合は，標準入力からパスワードを入力してください。

メモ

ここで指定したパスワードは，ALTER USER文で変更できます。パスワードの変更方法については，マニュアルHADB　システム構築・運用ガイドのHADBユーザのパスワードを変更する方法を参照してください。

重要

-uオプションと-pオプションでは，文字列中に英小文字が含まれているときの指定方法が異なります。

指定例を次に示します。

（例1）認可識別子にADBUSER01，パスワードにPASSWORD01を指定する場合

adbinit -u ADBUSER01 -p PASSWORD01

（例2）認可識別子にADBuser01，パスワードにPassword01を指定する場合

adbinit -u ¥"ADBuser01¥" -p Password01

（例3）認可識別子にADBuser¥01，パスワードにPassword¥01を指定する場合

adbinit -u ¥"ADBuser¥¥01¥" -p Password¥¥01

●初期設定オプションファイル名

〜〈OSパス名〉((1〜1,023バイト))

初期設定オプションを記述したファイルの絶対パス名または相対パス名を指定します。初期設定オプションについては，「20.2.2　初期設定オプションの形式」を参照してください。

●DBディレクトリ名

〜〈パス名〉((2〜510バイト))

DBディレクトリ名を絶対パス名で指定します。サーバ定義のadb_db_pathオペランドに指定したDBディレクトリ名を指定してください。

adbinitコマンドを実行すると，ここで指定したDBディレクトリ下にDBエリアファイルの実体またはシンボリックリンクが作成されます。

メモ

クラウドストレージ機能を使用する場合，DBディレクトリ下には作業表用DBエリアファイルの実体またはシンボリックリンクだけが作成されます。

注意事項を次に示します。

DBディレクトリを複数作成することはできません。

既存のDBディレクトリを指定した場合，DBディレクトリ下のファイルのうち，上書きされるものはいったん削除されてから再作成されます。

DBディレクトリは，サーバディレクトリ下に作成しないでください。また，ルートディレクトリをDBディレクトリにすることはできません。

20.2.2　初期設定オプションの形式

(1)　指定形式

■クラウドストレージ機能を使用しない場合

〔set adb_init_dbarea_initialize = ｛Y｜N｝〕
〔set adb_init_multi_max = DBエリアファイルの作成処理を行うスレッド数の上限〕
〔set adb_init_wrk_page_size = 作業表用DBエリアのページサイズ〕
〔set adb_init_wrk_blk_path = 作業表用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_init_mst_blk_path = マスタディレクトリ用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_init_dic_blk_path = ディクショナリ用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_init_stbl_blk_path = システム表用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_init_dmkey_path = HADB暗号鍵の出力先ファイル名〕
〔set adb_init_wrk_encrypt = ｛Y｜N｝〕
〔set adb_init_dic_encrypt = ｛Y｜N｝〕
〔set adb_init_stbl_encrypt = ｛Y｜N｝〕
〔set adb_core_path = 障害情報（コアファイル）の出力先ディレクトリ名〕

｛｛adbinitdbarea
      -n データ用DBエリア名
    〔-p ｛4｜8｜16｜32｝〕
    〔-s ｛4｜16｜32｝〕
    〔-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…〕
    〔-q〕
    〔-i 初期確保サイズ〔,作成ファイル数〕〕
    〔-f データ用DBエリアファイルの格納先ディレクトリ名〕
    〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
    〔-e〕
 ｝｝

■AWS環境でクラウドストレージ機能を使用する場合

〔set adb_init_dbarea_initialize = ｛Y｜N｝〕
〔set adb_init_wrk_page_size = 作業表用DBエリアのページサイズ〕
〔set adb_init_wrk_blk_path = 作業表用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_init_cld_aws_region = S3オブジェクトの格納先リージョン名〕
〔set adb_init_cld_aws_bucket = S3オブジェクトの格納先S3バケット名〕
〔set adb_init_cld_cache_path = キャッシュファイルの格納先ディレクトリ名〕
〔set adb_init_dmkey_path = HADB暗号鍵の出力先ファイル名〕
〔set adb_init_wrk_encrypt = ｛Y｜N｝〕
〔set adb_init_dic_encrypt = ｛Y｜N｝〕
〔set adb_init_stbl_encrypt = ｛Y｜N｝〕
〔set adb_core_path = 障害情報（コアファイル）の出力先ディレクトリ名〕

｛｛adbinitdbarea
      -n データ用DBエリア名
    〔-p 32〕
    〔-s 32〕
    〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
    〔-e〕
 ｝｝

■Azure環境でクラウドストレージ機能を使用する場合

〔set adb_init_dbarea_initialize = ｛Y｜N｝〕
〔set adb_init_wrk_page_size = 作業表用DBエリアのページサイズ〕
〔set adb_init_wrk_blk_path = 作業表用DBエリアファイルとして割り当てる
                              ブロックスペシャルファイル名〕
〔set adb_sys_cld_az_storage_account = BLOBの格納先ストレージアカウント名〕
〔set adb_sys_cld_az_container = BLOBの格納先コンテナー名〕
〔set adb_init_cld_cache_path = キャッシュファイルの格納先ディレクトリ名〕
〔set adb_init_dmkey_path = HADB暗号鍵の出力先ファイル名〕
〔set adb_init_wrk_encrypt = ｛Y｜N｝〕
〔set adb_init_dic_encrypt = ｛Y｜N｝〕
〔set adb_init_stbl_encrypt = ｛Y｜N｝〕
〔set adb_core_path = 障害情報（コアファイル）の出力先ディレクトリ名〕

｛｛adbinitdbarea
      -n データ用DBエリア名
    〔-p 32〕
    〔-s 32〕
    〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
    〔-e〕
 ｝｝

上記の初期設定オプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

(a)　set形式

●adb_init_dbarea_initialize = ｛Y｜N｝

DBエリアを初期化するかどうかを指定します。このオペランドにNを指定した場合，作業表用DBエリア以外のDBエリアファイルすべてにブロックスペシャルファイルを割り当てるか，またはクラウドストレージ機能を使用する必要があります。

Y：

すべてのDBエリアを初期化します。

このオペランドの指定を省略した場合は，Yが仮定されます。

N：

DBエリアを初期化しません。DBエリアにブロックスペシャルファイルを割り当てる場合は，シンボリックリンクを作成します。ただし，作業表用DBエリアだけは初期化されます。

このオペランドにNを指定した場合，次のオプションの指定値は無視されます。

adbinitコマンドのオプション

・-uオプション

・-pオプション

初期設定オプション（set形式のオペランド）

adb_init_multi_maxオペランド

adb_init_cld_cache_pathオペランド

adb_init_dmkey_pathオペランド

adb_init_wrk_encryptオペランド

adb_init_dic_encryptオペランド

adb_init_stbl_encryptオペランド

初期設定オプション（adbinitdbareaオペランドのオプション）

・-qオプション

・-gオプション

・-pオプション

・-sオプション

・-iオプションの初期確保サイズ

・-eオプション

［マルチノード機能］

セカンダリノード用のDBディレクトリおよびワーカーノード用のDBディレクトリを作成するときは（セカンダリノードおよびワーカーノードでadbinitコマンドを実行するときは），このオペランドにNを指定してください。

マルチノード機能使用時のDBディレクトリの作成手順については，「20.3.4　DBディレクトリを作成する場合（マルチノード機能の使用時）」を参照してください。

●adb_init_multi_max = DBエリアファイルの作成処理を行うスレッド数の上限

〜〈整数〉((1〜65,535))《40》

データ用DBエリアファイルを作成するスレッド数の上限を指定します。

次に示す場合にこのオペランドを指定します。

adbinitコマンドの実行時にスレッド数やファイルオープン数関連のエラー，またはメモリ不足などが発生した場合

作成するデータ用DBエリアファイル数が多い場合，スレッド数やディスクリプタ数がシステムの上限を超えてしまい，adbinitコマンドの実行時にスレッド数やファイルオープン数関連のエラー，メモリ不足（KFAA96211-Eメッセージが出力）などが発生することがあります。このような場合に，このオペランドの指定値を小さくしてadbinitコマンドを実行すると，このようなエラーを回避できることがあります。

なお，このオペランドに1を指定した場合，データ用DBエリアファイルは1つずつ作成されます。

40個以上のブロックスペシャルファイルを使用する場合

このオペランドの指定値を増やしてスレッド数の上限を上げると，性能が向上することがあります。

データ用DBエリアの作成時，1つのデータ用DBエリアに対して1つのスレッドが生成され，1つのデータ用DBエリアファイルに対して1つのスレッドが生成されます。例えば，DBエリアA（DBエリアファイル2個）およびDBエリアB（DBエリアファイル3個）を作成する場合，7つのスレッドが生成されます。

メモ

クラウドストレージ機能を使用する場合，各DBエリアの初期化処理は逐次実行されるため，スレッドは作成されません。

●adb_init_wrk_page_size = 作業表用DBエリアのページサイズ

〜〈整数〉((32〜32,768))《256》（単位：キロバイト）

作業表用DBエリアのページサイズをキロバイト単位で指定します。作業表用DBエリアの設計時に見積もったページサイズを指定してください。作業表用DBエリアのページサイズの見積もりについては，マニュアルHADB　システム構築・運用ガイドの作業表用DBエリアの設計を参照してください。

なお，このオペランドに32で割り切れない値を指定した場合，自動的に32キロバイト単位に切り上げられます。

このオペランドに指定したページサイズに従って，作業表用DBエリアが作成されます。なお，サーバ定義のadb_dbarea_wrk_page_sizeオペランドを指定すると，HADBサーバ開始時に作業表用DBエリアのページサイズを変更できます。adb_dbarea_wrk_page_sizeオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドのシステム構成に関するオペランド（set形式）を参照してください。

●adb_init_wrk_blk_path = 作業表用DBエリアファイルとして割り当てるブロックスペシャルファイル名

〜〈パス名〉((2〜255バイト))

作業表用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合に，そのブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。このオペランドを省略した場合，DBディレクトリ下に作業表用DBエリアファイルが作成されます。

ほかのオペランドに指定するブロックスペシャルファイルと指定が重ならないようにしてください。

重要

ブロックスペシャルファイルを割り当てた方が，レギュラーファイルを割り当てたときより性能向上が期待できます。

ただし，ブロックスペシャルファイルを割り当てると，ブロックスペシャルファイル内の既存データは消去されます。データを消去してよいか判断できない場合は，ブロックスペシャルファイルを割り当てないでください。

また，OSにマウントされているブロックスペシャルファイルを割り当てることはできません。割り当てるブロックスペシャルファイルはアンマウントしておく必要があります。

●adb_init_mst_blk_path = マスタディレクトリ用DBエリアファイルとして割り当てるブロックスペシャルファイル名

〜〈パス名〉((2〜255バイト))

マスタディレクトリ用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合に，そのブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。このオペランドを省略した場合，DBディレクトリ下にマスタディレクトリ用DBエリアファイルが作成されます。

ほかのオペランドに指定するブロックスペシャルファイルと指定が重ならないようにしてください。

ブロックスペシャルファイルを指定する際の注意事項については，adb_init_wrk_blk_pathオペランドの注意事項を参照してください。

●adb_init_dic_blk_path = ディクショナリ用DBエリアファイルとして割り当てるブロックスペシャルファイル名

〜〈パス名〉((2〜255バイト))

ディクショナリ用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合に，そのブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。このオペランドを省略した場合，DBディレクトリ下にディクショナリ用DBエリアファイルが作成されます。

ほかのオペランドに指定するブロックスペシャルファイルと指定が重ならないようにしてください。

ブロックスペシャルファイルを指定する際の注意事項については，adb_init_wrk_blk_pathオペランドの注意事項を参照してください。

●adb_init_stbl_blk_path= システム表用DBエリアファイルとして割り当てるブロックスペシャルファイル名

〜〈パス名〉((2〜255バイト))

システム表用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合に，そのブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。このオペランドを省略した場合，DBディレクトリ下にシステム表用DBエリアファイルが作成されます。

ブロックスペシャルファイルを指定する際の注意事項については，adb_init_wrk_blk_pathオペランドの注意事項を参照してください。

●adb_init_cld_aws_region= S3オブジェクトの格納先リージョン名

〜〈文字列〉((1〜100バイト))

AWS環境でクラウドストレージ機能を使用する場合に指定します。このオペランドには，S3オブジェクトを格納するリージョン名（adb_init_cld_aws_bucketオペランドに指定したS3バケットが存在するリージョン名）を指定してください。

●adb_init_cld_aws_bucket= S3オブジェクトの格納先S3バケット名

〜〈文字列〉((3〜63バイト))

AWS環境でクラウドストレージ機能を使用する場合に指定します。このオペランドには，S3オブジェクトを格納するS3バケット名を指定してください。

なお，汎用バケットまたはディレクトリバケットのどちらでもS3バケットとして使用できます。

●adb_sys_cld_az_storage_account= BLOBの格納先ストレージアカウント名

〜〈文字列〉((3〜24バイト))

Azure環境でクラウドストレージ機能を使用する場合に指定します。このオペランドには，Azure Blob Storageのストレージアカウント名を指定してください。

●adb_sys_cld_az_container= BLOBの格納先コンテナー名

〜〈文字列〉((3〜63バイト))

Azure環境でクラウドストレージ機能を使用する場合に指定します。このオペランドには，BLOBを格納するコンテナー名を指定してください。

●adb_init_cld_cache_path= キャッシュファイルの格納先ディレクトリ名

〜〈OSパス名〉((2〜510バイト))

クラウドストレージ機能を使用する場合に指定します。このオペランドには，キャッシュファイルを格納するディレクトリの絶対パス名を指定してください。

●adb_init_dmkey_path = HADB暗号鍵の出力先ファイル名

〜〈OSパス名〉((2〜510バイト))

DBエリア暗号化機能を使用する場合に，作成するHADB暗号鍵の出力先ファイルの絶対パス名を指定します。このオペランドを指定する場合，暗号化するDBエリアを1つ以上指定してください。

DBエリア暗号化機能については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を参照してください。

重要

このオペランドを指定してadbinitコマンドを実行すると，HADB暗号鍵利用パスワードの設定を求めるKFAA90013-Qメッセージが出力されます。その場合は，標準入力からパスワードを設定してください。ここで入力したパスワードが，作成されるHADB暗号鍵のHADB暗号鍵利用パスワードとして設定されます。

●adb_init_wrk_encrypt = ｛Y｜N｝

作業表用DBエリアを暗号化するかどうかを指定します。

Y：

暗号化します。

N：

暗号化しません。

このオペランドの指定を省略した場合は，Nが仮定されます。

●adb_init_dic_encrypt = ｛Y｜N｝

ディクショナリ用DBエリアを暗号化するかどうかを指定します。

Y：

暗号化します。

N：

暗号化しません。

このオペランドの指定を省略した場合は，Nが仮定されます。

●adb_init_stbl_encrypt = ｛Y｜N｝

システム表用DBエリアを暗号化するかどうかを指定します。

Y：

暗号化します。

N：

暗号化しません。

このオペランドの指定を省略した場合は，Nが仮定されます。

●adb_core_path = 障害情報（コアファイル）の出力先ディレクトリ名

〜〈パス名〉((2〜510バイト))

障害情報（コアファイル）の出力先ディレクトリ名を絶対パスで指定します。adbinitコマンドが何らかの要因でプロセスダウンした際に，このオペランドで指定したディレクトリ下に，adbinitコマンドの障害情報（コアファイル）が出力されます。

このオペランドを省略した場合，障害情報（コアファイル）の出力先ディレクトリは$DBDIR/SPOOLになります。

なお，障害情報（コアファイル）は，「core.コマンドプロセスのプロセスID」のファイル名で出力されます。

重要

このオペランドの指定値は，サーバ定義adb_core_pathオペランドと同じ値にしてください。サーバ定義adb_core_pathオペランドの指定を省略した場合は，このオペランドの指定も省略してください。

サーバ定義adb_core_pathオペランドと異なる値を指定した場合，不要となったコアファイルをadbinfosweepコマンドでは削除できません。

このオペランドを指定する場合，HADB管理者にアクセス権限（読み取り権限，書き込み権限，および実行権限）が付与されたディレクトリを指定するようにしてください。

コアファイルの出力がsystemd-coredumpによって制御されている場合，コアファイルは/var/lib/systemd/coredumpディレクトリ下に出力されます。デフォルトの設定では，RHEL 7またはRHEL 8の場合はLZ4形式で，RHEL 9の場合はZstandard形式で圧縮されて出力されます。この場合，このオペランドに指定したディレクトリは，トラブルシュート情報の収集時にコアファイル展開用の一時ディレクトリとして使用されます。このオペランドを省略したときは，$DBDIR/SPOOLディレクトリがコアファイル展開用の一時ディレクトリになります。

コアファイルの出力がsystemd-coredumpによって制御されているかどうかを確認する方法については，マニュアルHADB　システム構築・運用ガイドのHADBサーバのインストール前に実施する作業の設定ファイルの変更および作成（コアファイルの出力がsystemd-coredumpで制御されている場合）を参照してください。

コアファイルの取得に関する注意事項を次に示します。

コアファイルの出力がsystemd-coredumpによって制御されている場合

次の手順でコアファイルを取得してください。

coredumpctlコマンドで，コアファイルを任意のディレクトリに保存してください。

実行例

coredumpctl -1 dump $ADBDIR/bin/adbinit >$DBDIR/SPOOL/adbinit.core

手順1.で保存したコアファイルのパス名を-fオプションに指定して，adbinfogetコマンドを実行してください。

実行例

adbinfoget -o /home/adbmanager -f $DBDIR/SPOOL/adbinit.core

adbinitコマンドが無応答状態の場合

次の手順でコアファイルを取得してください。

gcoreコマンドで，コアファイルを出力してください。

コアファイルの出力先ディレクトリには，このオペランドで指定したパス名（このオペランドを省略した場合は$DBDIR/SPOOL）を指定してください。

実行例

ps x | grep adbinit | grep -v grep | awk '{print $1}'
63076
gcore -o $DBDIR/SPOOL/core 63076

adbinfogetコマンドを実行してください。

このオペランドに，サーバ定義adb_core_pathオペランドと異なる値を指定した場合

コアファイルのパス名を-fオプションに指定して，adbinfogetコマンドを実行してください。

(b)　コマンド形式

●adbinitdbarea

このオペランドにはデータ用DBエリアの定義を指定します。作成するデータ用DBエリアの数だけこのオペランドを指定してください。

データ用DBエリアファイルとして割り当てるファイルの種類や，クラウドストレージ機能を使用するかどうかによって，指定するオプションが異なります。オプションの指定の目安を次の表に示します。

表20‒2　指定するオプションの目安

項番

オプション名

クラウドストレージ機能を使用しない場合

クラウドストレージ機能を使用する場合

オプションの説明

ブロックスペシャルファイル

レギュラーファイル

1

-n

○

○

○

データ用DBエリア名を指定するオプションです。

2

-p

○

○

△

データ用DBエリアのページサイズを指定するオプションです。

3

-s

△

△

△

データ用DBエリアの1セグメントの容量を指定するオプションです。

4

-v

○

×

×

データ用DBエリアファイルとして割り当てるブロックスペシャルファイル名を指定するオプションです。

5

-q

○

×

×

データ用DBエリアファイルをクイックモードで作成する場合に指定するオプションです。

6

-i

○

○

×

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイルの数を指定するオプションです。

7

-f

△

×

×

データ用DBエリアファイル，またはブロックスペシャルファイルへのシンボリックリンクを，DBディレクトリのサブディレクトリに格納したい場合に指定するオプションです。

8

-g

△

△

△

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔を指定するオプションです。

9

-e

△

△

△

データ用DBエリアを暗号化する場合に指定するオプションです。

（凡例）

○：必ず指定するオプション，または指定を推奨するオプションです。

△：オプションの説明を読んで指定するかどうかを決定してください。

×：指定しないオプションです。

-n データ用DBエリア名

〜〈文字列〉((1〜30バイト))

作成するデータ用DBエリアの名称を指定します。

データ用DBエリアファイルの名称は，このオプションで指定した名称と同じになります。

メモ

クラウドストレージ機能を使用する場合，データ用DBエリアファイルは作成されません。

注意事項を次に示します。

DBエリア名に使用できる文字は，半角の英数字，下線（_），およびハイフン（-）です。また，先頭の文字は英字にする必要があります。

SQL文の予約語と同じ名称をDBエリア名に使用する場合は，DBエリア名を¥"（バックスラッシュと二重引用符）で囲んでください。SQL文の予約語については，マニュアルHADB　SQLリファレンスの基本項目の予約語を参照してください。

DBエリア名に英小文字を使用する場合，¥"でDBエリア名を囲んでください。¥"で囲まないと，DBエリア名の文字列はすべて英大文字と見なされます。

（例）¥"DBarea01¥"

ほかのDBエリア名，およびDBディレクトリ下に作成されるディレクトリ名と重複した名称は指定できません。ほかのDBエリア名については，「20.5.1　作成されるDBエリアの属性」の「表20‒5　作成されるDBエリアの属性」を参照してください。DBディレクトリ下に作成されるディレクトリ名については，「20.5.2　作成されるディレクトリ」の「表20‒6　DBディレクトリ下に作成されるディレクトリ」を参照してください。

-p ｛4｜8｜16｜32｝

データ用DBエリアのページサイズをキロバイト単位で選択します。データ用DBエリアの設計時に見積もったページサイズを指定してください。データ用DBエリアのページサイズの見積もりについては，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアのページサイズを決める際の考慮点を参照してください。

重要

-sオプションでデータ用DBエリアの1セグメントの容量に16メガバイト以上を選択した場合，-pオプションの選択値に関係なく，データ用DBエリアのページサイズは32キロバイトになります。

［クラウドストレージ機能］

クラウドストレージ機能を使用する場合は，32キロバイトを指定するか，またはこのオプションの指定を省略してください。このオプションの指定を省略した場合は，32キロバイトが仮定されます。

-s ｛4｜16｜32｝

データ用DBエリアの1セグメントの容量をメガバイト単位で選択します。データ用DBエリアの設計時に見積もった1セグメントの容量を指定してください。データ用DBエリアの1セグメントの容量の見積もりについては，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの1セグメントの容量を決める際の考慮点を参照してください。

データ用DBエリアのセグメントサイズは，「1セグメントの容量÷ページサイズ」で決定されます。例えば，1セグメントの容量として32メガバイトを選択した場合のセグメントサイズは，「32,768キロバイト÷32キロバイト＝1,024ページ」になります。

［クラウドストレージ機能］

クラウドストレージ機能を使用する場合は，32メガバイトを指定するか，またはこのオプションの指定を省略してください。このオプションの指定を省略した場合は，32メガバイトが仮定されます。

このオプションの指定値が32メガバイト以外の場合，KFAA50166-Eメッセージが出力され，adbinitコマンドがエラーとなります。

-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…

〜〈パス名〉((2〜255バイト))

データ用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合にこのオプションを指定します。このオプションには，ブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。

注意事項を次に示します。

指定するブロックスペシャルファイル名は，ほかのオペランドに指定するブロックスペシャルファイル名も含めて，重複しないようにしてください。

このオプションに指定するブロックスペシャルファイルの数（1つのDBエリアを構成するLVの個数）およびサイズの目安については，マニュアルHADB　システム構築・運用ガイドのLVM設定時の考慮点を参照してください。

-iオプションに指定する作成ファイル数と同じ数のブロックスペシャルファイルを指定してください。指定したブロックスペシャルファイルの数が作成ファイル数より少ない場合，adbinitコマンドがエラーになります。

ブロックスペシャルファイルを指定する際の注意事項については，adb_init_wrk_blk_pathオペランドの注意事項を参照してください。

このオプションを指定した場合，DBディレクトリ下にはブロックスペシャルファイルへのシンボリックリンクが作成されます。

-q

データ用DBエリアファイルをクイックモードで作成する場合にこのオプションを指定します。このオプションを指定すると，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-qオプションは，初期化対象のファイルがブロックスペシャルファイルの場合に適用されます。

メモ

クイックモードでデータ用DBエリアファイルを作成した場合，管理ページ（ファイルサイズなどの情報を格納しているページ）だけを作成し，データを格納するページは作成されません。そのため，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-i 初期確保サイズ〔,作成ファイル数〕

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイル数を指定します。

初期確保サイズ：

〜〈英字および数字〉((0K〜127P))《0K》

データ用DBエリアファイルの1ファイル当たりの初期確保サイズを，K（キロバイト），M（メガバイト），G（ギガバイト），T（テラバイト），P（ペタバイト）の単位表記付きで指定します。指定した初期確保サイズに従って，データ用DBエリアファイルのファイルサイズが決まります。ただし，初期確保時のページの配置によって，このオプションに指定した初期確保サイズの値どおりに，データ用DBエリアファイルのファイルサイズが確保されないことがあります。

データ用DBエリアファイルの種類によって，初期確保サイズの目安が異なります。このため，異なる種類のデータ用DBエリアファイルを同時に作成しないでください。データ用DBエリアファイルの種類に応じた初期確保サイズの目安を次の表に示します。

表20‒3　データ用DBエリアファイルの種類と初期確保サイズの目安

項番

データ用DBエリアファイルの種類

初期確保サイズの指定値の目安

1

レギュラーファイル

「初期確保サイズ×作成ファイル数」の値が「データ用DBエリアファイルを配置するファイルシステムの空き容量」未満になる範囲で，任意の値を指定してください。具体的な数値については，ディスクの空き容量の消費量やadbinitコマンドの実行時間を考慮し，判断してください。

2

ブロックスペシャルファイル

物理ボリューム（物理ブロックが静的に割り当てられた通常のブロックスペシャルファイル）

割り当てる物理ボリュームの容量がすべて同じ場合は，1ボリューム分の容量を初期確保サイズに指定してください。

容量が異なる物理ボリュームの同時割り当ては推奨しません。しかし，もし容量が異なる物理ボリュームを同時に割り当てる必要がある場合は，いちばん小さいボリュームの容量を指定してください。

3

仮想ボリューム（シンプロビジョニング※と呼ばれるストレージ仮想化技術を適用したブロックスペシャルファイル）

仮想ボリュームを16テラバイト未満で使用する場合は，0Kを指定します。

仮想ボリュームを16テラバイト以上使用する可能性がある場合は，使用する予定の容量を指定します。ただし，16テラバイト以上の使用が想定されるケースでは，仮想ボリュームの割り当てを推奨しません。16テラバイト以上の容量を指定すると，最初から大量の物理ブロックが必要となり，仮想ボリュームのメリットである初期導入コストの削減効果を十分に得られないためです。

注※　シンプロビジョニングの詳細については，ストレージ製品のマニュアルなどを参照してください。

なお，データ用DBエリアファイルの初期確保サイズを超えてデータを格納する場合，HADBサーバは必要な領域を自動的に拡張します（DBエリアの自動増分を行います）。拡張できる領域の上限は，初期確保サイズによって異なります。詳細については，マニュアルHADB　システム構築・運用ガイドのDBエリアの自動増分を参照してください。

メモ

データ用DBエリアファイルのファイルサイズは，-iオプションの指定値のとおりに確保されないことがあります。理由を次に示します。

データ用DBエリアファイルは，次に示すページから構成されています。

ディレクトリページ

セグメント（表のデータやインデクスを格納するページ群）

-iオプションでデータ用DBエリアファイルのファイルサイズを指定すると，指定したサイズに収まるように，各ページが配置されます。ただし，ディレクトリページやセグメントの途中で，-iオプションで指定したサイズに達する場合，次のようにページ数が調整されます。

データ用DBエリアファイルの先頭部分には，連続するディレクトリページが必ず作成されます。そのため，データ用DBエリアファイルのファイルサイズの最小値（約5.4メガバイト）よりも小さい値を指定した場合は，値が切り上げられます。

セグメントを構成するページは，セグメント単位（1つのセグメントを構成するページ数の単位）で管理されます。そのため，1セグメントの途中で指定したファイルサイズを超えないよう，ページ数が調整されます。例えば，8個目のセグメントの途中で指定したファイルサイズを超える場合，8個目のセグメントは作成されません（7個のセグメントが作成されます）。

データ用DBエリアファイルのディレクトリページおよびセグメントについては，マニュアルHADB　システム構築・運用ガイドのDBエリアの構造（セグメントとページ）のページのページの種類にあるディレクトリページ群の存在とディレクトリページの配置の説明を参照してください。

作成ファイル数：

〜〈整数〉((1〜1,024))《1》（単位：個）

作成するデータ用DBエリアファイル数を指定します。

-vオプションを指定する場合は，作成ファイル数と-vオプションに指定するブロックスペシャルファイルの数を同じにしてください。

-iオプションの指定によって確保される初期確保サイズを，例を使って説明します。

（例）

adbinitdbarea -n DBAREA01 -i 2G,3

この場合，データ用DBエリア（DBAREA01）にデータ用DBエリアファイルが3つ作成され，各データ用DBエリアファイルに2ギガバイトの初期確保サイズが確保されます。したがって，DBAREA01の初期確保サイズは，合計6ギガバイトになります。

なお，-iオプションの指定に従って確保しようとした初期確保サイズが上限を超えた場合，adbinitコマンドがエラーになります。このとき，KFAA96228-Eメッセージが出力されるため，メッセージに従って-iオプションの指定を変更してください。

重要

DBエリアファイルの自動増分の上限値を超える大容量のブロックスペシャルファイルを割り当てた場合，ブロックスペシャルファイル内に使用できない領域が発生するため，adbinitコマンドの実行時に警告メッセージKFAA96244-Wが出力されます。ブロックスペシャルファイルの容量のほぼ限界まで領域を使用したい場合は，KFAA96244-Wメッセージに記載されている対策に従ってください。

DBエリアファイルの自動増分の上限値は，初期確保サイズの指定値によって決まります。初期確保サイズの指定値を16テラバイトの倍数に切り上げた値が1DBエリアファイルの自動増分の上限値になります。例えば，初期確保サイズに20テラバイトを指定した場合，そのDBエリアファイルの自動増分の上限値は32テラバイトになります。

なお，使用できない領域をあとから使用できるようにする方法はありません。

1つのDBエリアに小容量と大容量のブロックスペシャルファイルを割り当てる場合，ブロックスペシャルファイルごとに異なる初期確保サイズを指定して，ブロックスペシャルファイルを初期化してください。例を次に示します。

（例）DBエリアAREA1に次の2つのブロックスペシャルファイルを割り当てます。

/dev/mapper/vg_10TB_1（容量10テラバイト）

/dev/mapper/vg_30TB_1（容量30テラバイト）

手順

adbinitコマンドでデータベースを初期設定します。このとき，次のように初期設定オプションを指定し，/dev/mapper/vg_10TB_1のファイルを初期化します。

adbinitdbarea -n AREA1 ... -i 10T -v /dev/mapper/vg_10TB_1

adbstartコマンドでHADBサーバを開始します。

adbmodareaコマンドでDBエリアAREA1を拡張します。このとき，次のようにDBエリア追加・変更オプションを指定し，/dev/mapper/vg_30TB_1のファイルを追加します。

adbexpandarea -n AREA1 ... -i 30T -v /dev/mapper/vg_30TB_1

上記の手順1.で2つのブロックスペシャルファイルを同時に初期化した場合，初期確保サイズには10テラバイトを超える値を指定できないため，DBエリアファイルの自動増分の上限値は16テラバイトになります。この場合，30テラバイトのブロックスペシャルファイルは，DBエリアファイルの自動増分の上限値である16テラバイトまでしか使用されません。

-f データ用DBエリアファイルの格納先ディレクトリ名

〜〈パス名〉((1〜70バイト))

データ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクを格納するサブディレクトリを，DBディレクトリ直下からの相対パス名で指定します。このサブディレクトリの直下に，DBエリア名と同名のデータ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクが作成されます。

このオプションを指定しない場合，データ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクは，DBディレクトリの直下に格納されます。

このオプションの指定例を次に示します。

（例）

adbinitdbarea -n DBAREA01 -f DB01/

この場合，DBディレクトリの直下にDB01というサブディレクトリが作成され，そのサブディレクトリの直下に，ファイル名DBAREA01のデータ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクが作成されます。

このオプションを指定する際の注意事項を次に示します。

相対パス名の先頭のスラッシュ(/)は指定不要です。

半角英字で始まりスラッシュ(/)で終わる，半角の英数字，下線(_)，ハイフン(-)だけで構成されているパス名を指定してください。パス名がスラッシュで終わらない場合，末尾に自動でスラッシュが追加されます。このとき，指定できるパス名は69バイトまでになります。

DBエリアファイルの格納先ディレクトリ名に英小文字を使用する場合，¥"（バックスラッシュと二重引用符）で格納先ディレクトリ名を囲んでください。¥"で囲まないと，格納先ディレクトリ名の文字列はすべて英大文字と見なされます。

（例）¥"Db02/¥"

DBディレクトリ下に作成されるディレクトリ以下のパスは指定できません。DBディレクトリ下に作成されるディレクトリについては，「20.5.2　作成されるディレクトリ」の「表20‒6　DBディレクトリ下に作成されるディレクトリ」を参照してください。

DBエリア名と同名の中間ディレクトリを含むパスを指定していると，ディレクトリやファイルの作成に失敗する場合があります。このため，各DBエリアファイルが作成される位置に，同名のディレクトリが配置されないように注意してください。

-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔

〜〈整数〉((0〜100))《0》（単位：％）

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージを出力する場合にこのオプションを指定します。

メッセージの出力間隔を％単位で指定します。例えば，このオプションに30を指定した場合，DBエリアの作成処理が30％，60％，および90％完了したときに進捗状況を知らせるKFAA96232-Iメッセージ（クラウドストレージ機能の使用時はKFAA96249-Iメッセージ）が出力されます。

なお，このオプションを省略した場合，または0を指定した場合，進捗状況を知らせるメッセージは出力されません。

-e

データ用DBエリアを暗号化する場合にこのオプションを指定します。

(3)　初期設定オプションのひな形

初期設定オプションのひな形（$ADBDIR/sample/conf/adbinit.opt）があります。初期設定オプションを作成する場合は，このひな形を利用してください。

なお，サンプルAPを使用する場合は，データ用DBエリア（ADBUTBL01およびADBUIDX01）が必要になります。ひな形には，データ用DBエリアの定義（adbinitdbareaオペランドの指定）が記述されています。そのため，ひな形を利用する際，データ用DBエリアの定義を削除しないようにしてください。

サンプルAPについては，マニュアルHADB　AP開発ガイドのサンプルAPを参照してください。

20.3　使用例

この節では，adbinitを実行してDBエリアを作成する方法を，例題形式で説明します。

20.3.1　ブロックスペシャルファイルのDBエリアファイルを作成する場合

adbinitコマンドを実行してDBエリアを作成します。次に示すように，データ用DBエリアファイルと作業表用DBエリアファイルとして，ブロックスペシャルファイルを割り当てます。

［説明］

DBディレクトリは/HADB/dbとします。

作業表用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG00）を割り当てます。

データ用DBエリア1のデータ用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）を割り当てます。

作成するDBエリアの定義を次に示します。

DBエリア名：DBAREA01

DBエリアのページサイズ：4キロバイト

DBエリアファイル数：2

各DBエリアファイルの初期確保サイズ：500メガバイト

データ用DBエリア2のデータ用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG03〜/dev/mapper/VolG05）を割り当てます。

作成するDBエリアの定義を次に示します。

DBエリア名：DBAREA02

DBエリアのページサイズ：4キロバイト

DBエリアファイル数：3

各DBエリアファイルの初期確保サイズ：1ギガバイト

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルは存在し，アクセス権限があるものとします。

このとき，次に示す手順でadbinitコマンドを実行します。

手順

初期設定オプションファイルを作成する

adbinitコマンドを実行する

各手順の例を以降で説明します。

(1)　初期設定オプションファイルを作成する

初期設定オプションファイルを作成して，初期設定オプションを指定します。

初期設定オプションファイルの指定例

set adb_init_wrk_page_size = 32                                          ...1
set adb_init_wrk_blk_path = /dev/mapper/VolG00                           ...2

adbinitdbarea -n DBAREA01 ¥                                              ...3
              -p 4 ¥
              -v /dev/mapper/VolG01,/dev/mapper/VolG02 ¥
              -q ¥
              -i 500M,2

adbinitdbarea -n DBAREA02 ¥                                              ...4
              -p 4 ¥
              -v /dev/mapper/VolG03,/dev/mapper/VolG04,/dev/mapper/VolG05 ¥
              -q ¥
              -i 1G,3

［説明］

作業表用DBエリアのページサイズを指定します。

作業表用DBエリアファイルとして割り当てるブロックスペシャルファイル（/dev/mapper/VolG00）を指定します。

データ用DBエリア1の定義を指定します。

-n：データ用DBエリア名（DBAREA01）を指定します。

-p：データ用DBエリアのページサイズ（4キロバイト）を指定します。

-v：データ用DBエリアファイルとして割り当てるブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）を指定します。

-q：クイックモードでデータ用DBエリアファイルを作成する指定をします。

-i：データ用DBエリアファイルの初期確保サイズ（500メガバイト）と，作成するファイル数（2個）を指定します。

データ用DBエリア2の定義を指定します。

-n：データ用DBエリア名（DBAREA02）を指定します。

-p：データ用DBエリアのページサイズ（4キロバイト）を指定します。

-v：データ用DBエリアファイルとして割り当てるブロックスペシャルファイル（/dev/mapper/VolG03〜/dev/mapper/VolG05）を指定します。

-q：クイックモードでデータ用DBエリアファイルを作成する指定をします。

-i：データ用DBエリアファイルの初期確保サイズ（1ギガバイト）と，作成するファイル数（3個）を指定します。

(2)　adbinitコマンドを実行する

adbinit -u ADBUSER01                                  ...1
        -p '#HelloHADB_01'                            ...2
        /HADB/server/conf/adbinit.opt                 ...3
        /HADB/db                                      ...4

［説明］

初期設定時に作成される，1人目のHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　初期設定オプションファイルを作成する」で作成した初期設定オプションファイル名を指定します。

DBディレクトリ名を指定します。

20.3.2　AWS環境でクラウドストレージ機能を使用する場合

adbinitコマンドを実行してDBエリアを作成します。次に示すように，作業表用DBエリアファイルとして，ブロックスペシャルファイルを割り当てます。作業表用DBエリア以外のDBエリアはS3バケット内に領域（仮想DBエリアファイル）を作成します。

［説明］

DBディレクトリは/HADB/dbとします。

作業表用DBエリアファイルとしてブロックスペシャルファイル（/dev/dbarea_work/ADBWRK）を割り当てます。

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルは存在し，アクセス権限があるものとします。

データ用DBエリア1の定義内容を次に示します。

DBエリア名：ADBUTBL01

DBエリアのページサイズ：32キロバイト

DBエリアの1セグメントの容量：32メガバイト

データ用DBエリア2の定義内容を次に示します。

DBエリア名：ADBUIDX01

DBエリアのページサイズ：32キロバイト

DBエリアの1セグメントの容量：32メガバイト

メモ

各データ用DBエリアの容量は，約1ペタバイトとなります。

このとき，次に示す手順でadbinitコマンドを実行します。

手順

初期設定オプションファイルを作成する

adbinitコマンドを実行する

各手順の例を以降で説明します。

(1)　初期設定オプションファイルを作成する

初期設定オプションファイルを作成して，初期設定オプションを指定します。

初期設定オプションファイルの指定例

set adb_init_wrk_page_size = 32                             ...1
set adb_init_wrk_blk_path = /dev/dbarea_work/ADBWRK         ...2

set adb_init_cld_aws_region = ap-northeast-1                ...3
set adb_init_cld_aws_bucket = adbbucket                     ...4
set adb_init_cld_cache_path = /HADB/ADBCCH                  ...5

adbinitdbarea -n ADBUTBL01 ¥                                ...6
              -p 32 ¥
              -s 32

adbinitdbarea -n ADBUIDX01 ¥                                ...7
              -p 32 ¥
              -s 32

［説明］

作業表用DBエリアのページサイズを指定します。

作業表用DBエリアファイルとして割り当てるEBS上のブロックスペシャルファイル（/dev/dbarea_work/ADBWRK）を指定します。

S3オブジェクトの格納先リージョン名（ap-northeast-1）を指定します。

S3オブジェクトの格納先S3バケット名（adbbucket）を指定します。

キャッシュファイルの格納先ディレクトリ名（/HADB/ADBCCH）を指定します。

データ用DBエリア1の定義を指定します。

-n：データ用DBエリア名（ADBUTBL01）を指定します。

-p：データ用DBエリアのページサイズ（32キロバイト）を指定します。

-s：データ用DBエリアの1セグメントの容量（32メガバイト）を指定します。

データ用DBエリア2の定義を指定します。

-n：データ用DBエリア名（ADBUIDX01）を指定します。

-p：データ用DBエリアのページサイズ（32キロバイト）を指定します。

-s：データ用DBエリアの1セグメントの容量（32メガバイト）を指定します。

(2)　adbinitコマンドを実行する

「(1)　初期設定オプションファイルを作成する」で作成した初期設定オプションファイル名を指定して，adbinitコマンドを実行します。

詳細については，「20.3.1　ブロックスペシャルファイルのDBエリアファイルを作成する場合」の「(2)　adbinitコマンドを実行する」を参照してください。

20.3.3　Azure環境でクラウドストレージ機能を使用する場合

adbinitコマンドを実行してDBエリアを作成します。次に示すように，作業表用DBエリアファイルとして，ブロックスペシャルファイルを割り当てます。作業表用DBエリア以外のDBエリアはAzure Blob Storageのコンテナー内に領域（仮想DBエリアファイル）を作成します。

［説明］

DBディレクトリは/HADB/dbとします。

作業表用DBエリアファイルとしてブロックスペシャルファイル（/dev/dbarea_work/ADBWRK）を割り当てます。

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルは存在し，アクセス権限があるものとします。

データ用DBエリア1の定義内容を次に示します。

DBエリア名：ADBUTBL01

DBエリアのページサイズ：32キロバイト

DBエリアの1セグメントの容量：32メガバイト

データ用DBエリア2の定義内容を次に示します。

DBエリア名：ADBUIDX01

DBエリアのページサイズ：32キロバイト

DBエリアの1セグメントの容量：32メガバイト

メモ

各データ用DBエリアの容量は，約1ペタバイトとなります。

このとき，次に示す手順でadbinitコマンドを実行します。

手順

初期設定オプションファイルを作成する

adbinitコマンドを実行する

各手順の例を以降で説明します。

(1)　初期設定オプションファイルを作成する

初期設定オプションファイルを作成して，初期設定オプションを指定します。

初期設定オプションファイルの指定例

set adb_init_wrk_page_size = 32                             ...1
set adb_init_wrk_blk_path = /dev/dbarea_work/ADBWRK         ...2

set adb_sys_cld_az_storage_account = adbstorageaccount      ...3
set adb_sys_cld_az_container = adbcontainer                 ...4
set adb_init_cld_cache_path = /HADB/ADBCCH                  ...5

adbinitdbarea -n ADBUTBL01 ¥                                ...6
              -p 32 ¥
              -s 32

adbinitdbarea -n ADBUIDX01 ¥                                ...7
              -p 32 ¥
              -s 32

［説明］

作業表用DBエリアのページサイズを指定します。

作業表用DBエリアファイルとして割り当てるマネージドディスク上のブロックスペシャルファイル（/dev/dbarea_work/ADBWRK）を指定します。

BLOBの格納先ストレージアカウント名（adbstorageaccount）を指定します。

BLOBの格納先コンテナー名（adbcontainer）を指定します。

キャッシュファイルの格納先ディレクトリ名（/HADB/ADBCCH）を指定します。

データ用DBエリア1の定義を指定します。

-n：データ用DBエリア名（ADBUTBL01）を指定します。

-p：データ用DBエリアのページサイズ（32キロバイト）を指定します。

-s：データ用DBエリアの1セグメントの容量（32メガバイト）を指定します。

データ用DBエリア2の定義を指定します。

-n：データ用DBエリア名（ADBUIDX01）を指定します。

-p：データ用DBエリアのページサイズ（32キロバイト）を指定します。

-s：データ用DBエリアの1セグメントの容量（32メガバイト）を指定します。

(2)　adbinitコマンドを実行する

「(1)　初期設定オプションファイルを作成する」で作成した初期設定オプションファイル名を指定して，adbinitコマンドを実行します。

詳細については，「20.3.1　ブロックスペシャルファイルのDBエリアファイルを作成する場合」の「(2)　adbinitコマンドを実行する」を参照してください。

20.3.4　DBディレクトリを作成する場合（マルチノード機能の使用時）

マルチノード機能を使用する場合，一部のDBエリアをマルチノード構成の全HADBサーバ間で共有します。マルチノード機能については，マニュアルHADB　システム構築・運用ガイドのアーキテクチャのマルチノード機能を参照してください。また，マルチノード構成の全HADBサーバ間で共有するDBエリアについては，マニュアルHADB　システム構築・運用ガイドのアーキテクチャのDBエリア（表およびインデクスの格納領域）のDBエリアのファイル構成を参照してください。

クラウドストレージ機能を使用しない場合

DBエリアを共有するには，DBエリアファイルに割り当てるデバイスを，異なるシステム間で一意に識別する必要があります。このため，同じデバイスを識別するために，WWNを利用します。WWNはシステムに依存しない，HBAでデバイスごとに割り当てられる固有の識別子です。

マルチノード機能を使用する際にDBディレクトリを作成する場合は，共有するDBエリアすべてについて，WWNを含むブロックスペシャルファイル（/dev/disk/by-id/wwn-で始まるパス）を割り当ててください。

クラウドストレージ機能を使用する場合

AWS環境のときは，作業表用DBエリア以外のDBエリアのデータは，S3バケット内のS3オブジェクトに格納されます。Azure環境のときは，作業表用DBエリア以外のDBエリアのデータは，コンテナー内のBLOBに格納されます。格納された作業表用DBエリア以外のDBエリアのデータは，マルチノード構成の全HADBサーバ間で共有されます。

マルチノード機能を使用する際にDBディレクトリを作成する場合は，次に示す手順でadbinitコマンドを実行します。

手順

プライマリノード用の初期設定オプションファイルを作成する

プライマリノードでadbinitコマンドを実行する

セカンダリノードおよびワーカーノード用の初期設定オプションファイルを作成する

セカンダリノードおよびワーカーノードでadbinitコマンドを実行する

手順3.〜4.は，セカンダリノードおよびワーカーノードの各HADBサーバで実施します。

なお，作業表用DBエリアのブロックスペシャルファイルは，サーバ定義で指定することもできます。詳細は，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容のシステム構成に関するオペランド（set形式）にあるadb_blk_path_wrkオペランドの説明を参照してください。

各手順の例を以降で説明します。

(1)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の未使用時）

クラウドストレージ機能を使用しない場合，初期設定オプションファイルを作成して，次のように初期設定オプションを指定します。

プライマリノード用として各DBエリアの初期化が必要となるため，adb_init_dbarea_initializeオペランドにYを指定します。

マルチノード構成の全HADBサーバ間で共有するDBエリアすべてに，WWN識別子を含むブロックスペシャルファイルを割り当てます。

マルチノード構成の全HADBサーバ間で共有しないDBエリア（作業表用DBエリア）にブロックスペシャルファイルを割り当てる場合は，プライマリノード固有のブロックスペシャルファイルを割り当ててください。

プライマリノード用の初期設定オプションファイルの指定例

set adb_init_dbarea_initialize = Y
set adb_init_wrk_blk_path = /dev/mapper/adb-ADBWRK_lv
set adb_init_mst_blk_path = /dev/disk/by-id/wwn-0x600605b003a2e280172ab596258093bc
set adb_init_dic_blk_path = /dev/disk/by-id/wwn-0x600605b003a2e280172ab5962580e259
set adb_init_stbl_blk_path = /dev/disk/by-id/wwn-0x600605b003a2e280172ab5962581311b
adbinitdbarea -n DBAREA1 -i 1G,2 -v ¥
  /dev/disk/by-id/wwn-0x60060e80102172300511166300000000,¥
  /dev/disk/by-id/wwn-0x60060e80102172300511166300000001

(2)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の使用時）

クラウドストレージ機能を使用する場合，初期設定オプションファイルを作成して，次のように初期設定オプションを指定します。

■プライマリノード用の初期設定オプションファイルの指定例（AWS環境の場合）

set adb_init_dbarea_initialize = Y                               ...1
set adb_init_wrk_blk_path = /dev/mapper/adb-ADBWRK_lv            ...2
set adb_init_cld_aws_region = ap-northeast-1                     ...3
set adb_init_cld_aws_bucket = adbbucket                          ...4
set adb_init_cld_cache_path = /HADB/ADBCCH                       ...5
adbinitdbarea -n DBAREA1 -p 32 -s 32                             ...6

［説明］

プライマリノードは，DBエリアの初期化が必要なため，Yを指定します。

プライマリノードで使用する作業表用DBエリアファイルのブロックスペシャルファイル名を指定します。

S3オブジェクトの格納先リージョン名を指定します。

S3オブジェクトの格納先S3バケット名を指定します。

キャッシュファイルの格納先ディレクトリ名を指定します。

データ用DBエリアの指定をします。

■プライマリノード用の初期設定オプションファイルの指定例（Azure環境の場合）

set adb_init_dbarea_initialize = Y                               ...1
set adb_init_wrk_blk_path = /dev/mapper/adb-ADBWRK_lv            ...2
set adb_sys_cld_az_storage_account = adbstorageaccount           ...3
set adb_sys_cld_az_container = adbcontainer                      ...4
set adb_init_cld_cache_path = /HADB/ADBCCH                       ...5
adbinitdbarea -n DBAREA1 -p 32 -s 32                             ...6

［説明］

プライマリノードは，DBエリアの初期化が必要なため，Yを指定します。

プライマリノードで使用する作業表用DBエリアファイルのブロックスペシャルファイル名を指定します。

BLOBの格納先ストレージアカウント名を指定します。

BLOBの格納先コンテナー名を指定します。

キャッシュファイルの格納先ディレクトリ名を指定します。

データ用DBエリアの指定をします。

(3)　プライマリノードでadbinitコマンドを実行する

「(1)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の未使用時）」，または「(2)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の使用時）」で作成した初期設定オプションファイル名を指定して，プライマリノードでadbinitコマンドを実行します。

詳細については，「20.3.1　ブロックスペシャルファイルのDBエリアファイルを作成する場合」の「(2)　adbinitコマンドを実行する」を参照してください。

(4)　セカンダリノードおよびワーカーノード用の初期設定オプションファイルを作成する

クラウドストレージ機能を使用しない場合

「(1)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の未使用時）」で作成した初期設定オプションファイルを各セカンダリノードおよびワーカーノードにコピーし，次のように初期設定オプションの指定を変更します。

adb_init_dbarea_initializeオペランドの値をNに変更します。

プライマリノード用の初期設定オプションファイルに指定しているブロックスペシャルファイルが次に示す条件を満たす場合は，ブロックスペシャルファイル名を変更するか，該当する指定を削除します。

マルチノード構成の全HADBサーバ間で共有しないDBエリアにブロックスペシャルファイルを指定している場合

マルチノード構成の全HADBサーバ間で共有しないDBエリアに指定しているブロックスペシャルファイルと同名，かつセカンダリノードおよびワーカーノード固有のブロックスペシャルファイルがない場合

それ以外のオペランドについては，指定を変更しないでください。

セカンダリノードおよびワーカーノード用の初期設定オプションファイルの指定例

set adb_init_dbarea_initialize = N
set adb_init_mst_blk_path = /dev/disk/by-id/wwn-0x600605b003a2e280172ab596258093bc
   ：

クラウドストレージ機能を使用する場合

「(2)　プライマリノード用の初期設定オプションファイルを作成する（クラウドストレージ機能の使用時）」で作成した初期設定オプションファイルを各セカンダリノードおよびワーカーノードにコピーし，次のように初期設定オプションの指定を変更します。

adb_init_dbarea_initializeオペランドの値をNに変更します。

adb_init_wrk_blk_pathオペランドには，セカンダリノードまたはワーカーノードに割り当てる作業表用DBエリアファイルを指定します。プライマリノードとは異なる作業表用DBエリアファイルを指定します。

上記以外のオペランドについては，指定を変更しないでください。

(5)　セカンダリノードおよびワーカーノードでadbinitコマンドを実行する

「(4)　セカンダリノードおよびワーカーノード用の初期設定オプションファイルを作成する」で作成した初期設定オプションファイル名を指定して，セカンダリノードおよびワーカーノードでadbinitコマンドを実行します。

詳細については，「20.3.1　ブロックスペシャルファイルのDBエリアファイルを作成する場合」の「(2)　adbinitコマンドを実行する」を参照してください。

20.4　リターンコード

adbinitコマンドのリターンコードを次の表に示します。

表20‒4　adbinitコマンドのリターンコード

リターンコード

意味

0

adbinitコマンドが正常に終了しました。

4

adbinitコマンドは正常に終了しましたが，警告メッセージが出力されています。表示されたメッセージまたはメッセージログファイルに出力された警告メッセージを確認してください。

8

adbinitコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。

20.5　作成されるDBエリアおよびディレクトリ

この節では，adbinitコマンドを実行すると作成されるDBエリアの属性，およびディレクトリについて説明します。

20.5.1　作成されるDBエリアの属性

adbinitコマンドを実行して作成されるDBエリアの属性を次に示します。

表20‒5　作成されるDBエリアの属性

項番

DBエリアの種類

DBエリア名

DBエリアファイル名

DBエリアID

ページサイズ（キロバイト）

セグメントサイズ（ページ）

1

マスタディレクトリ用DBエリア

ADBMST

ADBMST※4

1

4

256

2

ディクショナリ用DBエリア

ADBDIC

ADBDIC※4

2

4

8

3

作業表用DBエリア

ADBWRK

ADBWRK

3

adb_init_wrk_page_sizeオペランドで指定

1

4

システム表用DBエリア

ADBSTBL

ADBSTBL※4

4

4

16

5

データ用DBエリア

-nオプション※1で指定

-nオプション※1で指定※2，※4

11〜1,024

-pオプション※1，※5で指定

「1セグメントの容量（-sオプション※1，※6で指定）÷ページサイズ」をキロバイト単位で計算した値※3

注

データ用DBエリアは1,014個まで作成できます。

その他のDBエリアは，自動的にそれぞれ1個作成されます。

注※1

adbinitdbareaオペランドのオプションです。

注※2

DBエリア名と同名のファイルとなります。また，adbinitdbareaオペランドの-fオプションでサブディレクトリを指定した場合，DBエリアファイルはサブディレクトリの直下に配置されます。

注※3

セグメントサイズは，1セグメントの容量およびページサイズによって決まります。

1セグメントの容量（キロバイト）

ページサイズ（キロバイト）

セグメントサイズ（ページ）

4,096

4

1,024

8

512

16

256

32

128

16,384

32

512

32,768

32

1,024

注※4

クラウドストレージ機能を使用する場合，DBエリアファイルは作成されません。

注※5

クラウドストレージ機能を使用する場合，-pオプションに指定できる値は32キロバイトだけです。

注※6

クラウドストレージ機能を使用する場合，-sオプションに指定できる値は32メガバイトだけです。

20.5.2　作成されるディレクトリ

adbinitコマンドを実行すると，DBディレクトリ下に次の表に示すディレクトリが作成されます。

表20‒6　DBディレクトリ下に作成されるディレクトリ

項番

ディレクトリ名

説明

1

ADBSYS

HADBが使用するファイルを格納するディレクトリです。このディレクトリ下には，システムログファイルなどが格納されます。

2

ADBWORK

HADBが使用するファイルを格納するディレクトリです。このディレクトリ下には，コマンドの実行時に作成される一時ファイルが格納されます。

3

SPOOL

HADBが使用する障害情報（コアファイル）を格納するディレクトリです。

注

項番1〜3のディレクトリのほかに，HADBが使用するディレクトリが作成されることがあります。

20.6　注意事項

ダイレクトI/Oをサポートしていないファイルシステム上にデータ用DBエリアファイルを作成できません。

adbinitコマンドを実行してデータベースの初期設定が完了したあとに，DBエリアを新規に追加したり，既存のDBエリアにDBエリアファイルを追加したりする場合は，次に示すどちらかの方法でDBエリアの構成を変更してください。

adbmodareaコマンドを実行してDBエリアやDBエリアファイルを追加する

adbinitコマンドを再実行してデータベースの初期設定をし直す

ブロックスペシャルファイルを使用する場合は，LVMで作成したブロックスペシャルファイルか，または/dev/disk/で始まる固定されたデバイス名を，HADBのパス名規則に従って指定してください。

マルチノード機能を使用する場合は，ノード間で共有するDBエリアファイルに/dev/disk/by-id/wwn-で始まるデバイス名を指定する必要があります。詳細については，「20.3.4　DBディレクトリを作成する場合（マルチノード機能の使用時）」を参照してください。

ディスクを増設した場合で，増設したディスクをOSが認識していないときは，OSをいったん再起動して，ディスクを認識させてください。ディスクをOSに認識させることで，ブロックスペシャルファイルを使用できるようにします。

マルチノード機能を使用する場合は，adbinitコマンドを実行する前に，OSのコマンドで，システムディレクトリ用のファイルシステムを初期化してください。詳細については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のマルチノード機能を使用したシステムの構築のデータベースの作成を参照してください。

AWS環境でクラウドストレージ機能を使用する場合，次の3つのオペランドを指定する必要があります。

adb_init_cld_aws_regionオペランド

adb_init_cld_aws_bucketオペランド

adb_init_cld_cache_pathオペランド

Azure環境でクラウドストレージ機能を使用する場合，次の3つのオペランドを指定する必要があります。

adb_sys_cld_az_storage_accountオペランド

adb_sys_cld_az_containerオペランド

adb_init_cld_cache_pathオペランド

クラウドストレージ機能を使用する場合，作業表用DBエリア以外のDBエリアにはブロックスペシャルファイルを割り当てられません。そのため，次のオペランドまたはオプションを指定すると，KFAA50165-Eメッセージが出力され，adbinitコマンドがエラーとなります。

adb_init_mst_blk_pathオペランド

adb_init_dic_blk_pathオペランド

adb_init_stbl_blk_pathオペランド

adbinitdbareaオペランドの-vオプション

クラウドストレージ機能を使用する場合，データ用DBエリアの数が増加すると，HADBサーバの開始，adbdbstatusコマンドの実行，チャンクの更新や削除などの各種処理時間が長くなることがあります。そのため，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの設計を参照して，データ用DBエリアは必要な数だけ作成するようにしてください。

adbinitコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbinitコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表20‒7　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

初期設定オプションファイル

コマンドの実行ユーザ

読み取り権限

初期設定オプションのadb_core_pathオペランドに指定する障害情報（コアファイル）の出力先ディレクトリ

コマンドの実行ユーザ

読み取り権限

書き込み権限

実行権限

初期設定オプションのadb_init_cld_cache_pathオペランドに指定するキャッシュファイルの格納先ディレクトリ（クラウドストレージ機能を使用する場合）

コマンドの実行ユーザ

読み取り権限

書き込み権限

実行権限

初期設定オプションのadb_init_dmkey_pathオペランドに指定するHADB暗号鍵の出力先ファイル※2を格納するディレクトリ（DBエリア暗号化機能を使用する場合）

コマンドの実行ユーザ

書き込み権限

実行権限

初期設定オプションの次のオペランドおよびオプションに指定する各DBエリアファイルとして割り当てるブロックスペシャルファイル

adb_init_wrk_blk_pathオペランド

adb_init_mst_blk_pathオペランド（クラウドストレージ機能を使用しない場合）

adb_init_dic_blk_pathオペランド（クラウドストレージ機能を使用しない場合）

adb_init_stbl_blk_pathオペランド（クラウドストレージ機能を使用しない場合）

adbinitdbareaオペランドの-vオプション（クラウドストレージ機能を使用しない場合）

コマンドの実行ユーザ

読み取り権限

書き込み権限

注※1

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

adbinitコマンドの実行時，権限に400を設定したHADB暗号鍵ファイルが作成されます。

21　adbinstall（HADBサーバおよびHADBクライアントのインストール）

この章では，adbinstallコマンドの機能と使い方について説明します。

21.1　機能

adbinstallコマンドを実行すると，HADBサーバおよびHADBクライアント（Linux版）をインストールすることができます。

21.2　adbinstallコマンドの指定形式

adbinstallコマンドの指定形式およびオプションについて説明します。

adbinstallコマンドを実行できるOSユーザを次に示します。

HADBサーバをインストールする場合

HADB管理者

HADBクライアント（Linux版）をインストールする場合

HADBクライアントを管理するOSユーザ

21.2.1　指定形式およびオプションの説明

(1)　指定形式

/install/adbinstall ｛-s サーバディレクトリのパス
                    ｜-c クライアントディレクトリのパス｝

下線部には，adbinstallコマンドの実行形式ファイルを格納したディレクトリ（インストールデータを格納するディレクトリ）を絶対パスで指定してください。

(2)　オプションの説明

HADBサーバとHADBクライアント（Linux版）のどちらをインストールするかを，オプションで指定します。

●-s サーバディレクトリのパス

〜〈パス名〉((2〜118バイト))

HADBサーバをインストールする場合に，サーバディレクトリのパスを絶対パスで指定します。

このオプションには，必ずHADB管理者が書き込みできるディレクトリを指定してください。書き込みできないディレクトリを指定した場合，KFAA91553-Eメッセージが出力されてエラーになります。

●-c クライアントディレクトリのパス

〜〈パス名〉((2〜118バイト))

HADBクライアント（Linux版）をインストールする場合に，クライアントディレクトリのパスを絶対パスで指定します。

このオプションには，必ずHADBクライアントを管理するOSユーザが書き込みできるディレクトリを指定してください。書き込みできないディレクトリを指定した場合，KFAA91553-Eメッセージが出力されてエラーになります。

21.3　リターンコード

adbinstallコマンドのリターンコードを次の表に示します。

表21‒1　adbinstallコマンドのリターンコード

リターンコード

意味

0

adbinstallコマンドが正常に終了しました。

4

adbinstallコマンドが警告メッセージを出力して終了しました。表示されたメッセージを確認して対処してください。

8

adbinstallコマンドの実行中にエラーが発生しました。表示されたメッセージを確認して対処してください。

21.4　注意事項

adbinstallコマンドは，Linux専用のコマンドです。Windowsでは使用できません。

CD-ROMファイルシステムに格納されている次のファイル（インストールデータ）は，同じディレクトリに格納してください。同じディレクトリに格納しないと，HADBサーバまたはHADBクライアントをインストールできません。

HADBサーバをインストールする場合

HADBサーバ用のtar.gz形式のファイル

adbinstallコマンドの実行形式ファイル

HADBクライアント（Linux版）をインストールする場合

HADBクライアント用のtar.gz形式のファイル

adbinstallコマンドの実行形式ファイル

HADBサーバをインストールする場合，HADB管理者が書き込みできるように，次に示すディレクトリに対して，書き込み権限を付与してください。

インストールデータを格納するディレクトリ

adbinstallコマンドの-sオプションで指定するディレクトリ

また，HADB管理者がtar.gz形式のファイルを参照できるように，このファイルに対して，読み取り権限を付与してください。

HADB管理者が書き込みできないディレクトリを指定して，adbinstallコマンドを実行すると，エラーになります（KFAA91553-Eメッセージが出力されます）。その場合，上記のディレクトリに対して書き込み権限を付与したあとで，adbinstallコマンドを再実行してください。

HADBクライアントをインストールする場合，HADBクライアントを管理するOSユーザが書き込みできるように，次に示すディレクトリに対して，書き込み権限を付与してください。

インストールデータを格納するディレクトリ

adbinstallコマンドの-cオプションで指定するディレクトリ

また，HADBクライアントを管理するOSユーザがtar.gz形式のファイルを参照できるように，このファイルに対して，読み取り権限を付与してください。

HADBクライアントを管理するOSユーザが書き込みできないディレクトリを指定して，adbinstallコマンドを実行すると，エラーになります（KFAA91553-Eメッセージが出力されます）。その場合，上記のディレクトリに対して書き込み権限を付与したあとで，adbinstallコマンドを再実行してください。

HADBサーバをインストールする場合，adbinstallコマンドを実行する前に，HADBサーバの前提となるパッケージがすべてインストールされていることを確認してください。HADBサーバの前提となるパッケージがインストールされていない状態でadbinstallコマンドを実行すると，KFAA91553-Eメッセージが出力されエラーになることがあります。HADBサーバの前提パッケージについては，マニュアルHADB　システム構築・運用ガイドのHADBサーバのインストール前に実施する作業の前提パッケージの確認を参照してください。

HADBクライアントをインストールする場合，adbinstallコマンドを実行する前に，HADBクライアントの前提となるパッケージがすべてインストールされていることを確認してください。なお，HADBクライアントの前提となるパッケージがインストールされていない状態でadbinstallコマンドを実行しても，この時点ではエラーにはなりません。HADBクライアントの前提パッケージについては，マニュアルHADB　AP開発ガイドのLinux版のHADBクライアントの場合のHADBクライアントをインストールする前の確認事項を参照してください。

HADB管理者として設定したOSユーザではなく，rootでadbinstallコマンドを実行した場合は，警告メッセージ（KFAA91558-Wメッセージ）が出力されます。通常は，HADB管理者として設定したOSユーザで，adbinstallコマンドを実行します。そのため，KFAA91558-Wメッセージが出力された場合は，rootでadbinstallコマンドを実行して問題がないかどうかを確認してください。

問題がある場合は，KFAA91558-Wメッセージが出力されたあとに出力されるKFAA91559-Qメッセージの入力要求に対して，n（またはN）を入力してください。そのあとで，HADB管理者として設定したOSユーザでadbinstallコマンドを実行してください。

なお，root以外のスーパユーザでadbinstallコマンドを実行した場合は，KFAA91558-Wメッセージは出力されません。

メモ

rootは，OSのid -uコマンドを実行して表示される値が0のユーザを指します。また，OSのsuコマンドを使用して，ほかのOSユーザからrootに切り替えたあとで，OSのid -uコマンドを実行して表示される値が0のときも含みます。

adbinstallコマンドの-sオプションに指定したサーバディレクトリ，または-cオプションに指定したクライアントディレクトリが存在しない場合は，adbinstallコマンド実行時にディレクトリが自動で作成されます。

adbinstallコマンドの延長でOSのコマンドが実行されます。このOSのコマンドの実行に失敗した場合，標準エラー出力にエラーメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadbinstallコマンドを再実行してください。

adbinstallコマンドの延長でHADBのコマンド（adblsコマンドなど）が実行されます。このHADBのコマンドの実行に失敗した場合，KFAA91553-Eメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadbinstallコマンドを再実行してください。

再インストール（修正版およびバージョンアップ時のインストールを含む）を実施する場合は，adbinstallコマンドを実行する前に，サーバディレクトリまたはクライアントディレクトリのバックアップを取得してください。

adbinstallコマンドの-sオプションに指定したサーバディレクトリ，または-cオプションに指定したクライアントディレクトリがすでに存在する場合，KFAA91554-Qメッセージ（ディレクトリを上書きしてよいかどうかの確認メッセージ）が表示されます。上書きしても問題ない場合は，y（またはY）を入力してください。y（またはY）以外を入力すると，インストール処理は中止され，adbinstallコマンドが終了します。

adbinstallコマンドの実行後，HADBサーバまたはHADBクライアントが正常にインストールされていることを確認してください。

HADBサーバをインストールした場合

サーバディレクトリ下のadbinstsv.logファイルの内容を確認してください。

詳細については，マニュアルHADB　システム構築・運用ガイドのHADBサーバのインストール手順のHADBサーバのインストールの確認を参照してください。

HADBクライアント（Linux版）をインストールした場合

クライアントディレクトリ下のadbinstcl.logファイルの内容を確認してください。

詳細については，マニュアルHADB　AP開発ガイドのLinux版のHADBクライアントの場合のHADBクライアントのインストールを参照してください。

22　adbls -d cfm（キャッシュファイルの情報表示）

この章では，adbls -d cfmコマンドの機能と使い方について説明します。

22.1　機能

クラウドストレージ機能を使用している場合，adbls -d cfmコマンドを実行すると，キャッシュファイルの情報を表示できます。

クラウドストレージ機能を使用していて，かつマルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

クラウドストレージ機能およびキャッシュファイルの詳細については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

22.2　adbls -d cfmコマンドの指定形式

adbls -d cfmコマンドの指定形式について説明します。

adbls -d cfm

adbls -d cfmコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

22.3　使用例

adbls -d cfmコマンドを実行して，キャッシュファイルの情報を表示します。

キャッシュグループを定義している場合（サーバ定義のadbcachegrpオペランドを指定している場合）

キャッシュグループを定義していない場合（サーバ定義のadbcachegrpオペランドを指定していない場合）

クラウドストレージ機能を使用していない場合，出力項目のタイトルだけが表示されます。

各出力項目の説明

キャッシュグループを定義している場合，キャッシュグループごとの情報が表示されます。

CACHE_GRP_NAME

キャッシュグループ名が表示されます。

キャッシュグループ名は，サーバ定義のadbcachegrpオペランドの-gオプションで指定しています。

なお，「##ADBCACHEGRP_OTHER」は，既定のキャッシュグループのキャッシュグループ名です。

メモ

サーバ定義のadbcachegrpオペランドでキャッシュグループを定義していない場合は，キャッシュグループ名に「##ADBCACHEGRP_OTHER」が表示されます。

キャッシュグループの詳細については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

TOTAL_LIMIT(MB)：

各キャッシュグループの容量の上限値（サーバ定義のadbcachegrpオペランドの-sオプションの指定値）が，メガバイト単位で表示されます。

サーバ定義のadbcachegrpオペランドでキャッシュグループを定義していない場合は，キャッシュファイルの総容量の上限値（サーバ定義のadb_sys_cld_cache_total_sizeオペランドの指定値）が，メガバイト単位で表示されます。

INTERNAL_TOTAL_LIMIT(MB)：

adbls -d cfmコマンドを実行した時点の，HADBサーバが決定したキャッシュファイルの総容量の上限値が，メガバイト単位で表示されます。

メモ

INTERNAL_TOTAL_LIMIT(MB)に表示された値とTOTAL_LIMIT(MB)に表示された値が異なる場合，メッセージログに警告メッセージ（KFAA51285-Wメッセージ）またはエラーメッセージ（KFAA41235-Eメッセージ）が出力されます。必要に応じて，出力されたメッセージの対策欄の説明に従って対処してください。

TOTAL_SIZE(MB)：

キャッシュファイルの格納先ディレクトリ（サーバ定義のadb_sys_cld_cache_pathオペランドの指定値）に格納されているキャッシュファイルの合計容量が，メガバイト単位で表示されます。

メモ

TOTAL_SIZE(MB)，TOTAL_SIZE_DIR(MB)，およびTOTAL_SIZE_SGMT(MB)には，メガバイト単位で切り上げた値が表示されます。そのため，TOTAL_SIZE(MB)に表示される値は，TOTAL_SIZE_DIR(MB)とTOTAL_SIZE_SGMT(MB)を加算した値と一致しないことがあります。

TOTAL_SIZE(MB)，TOTAL_SIZE_DIR(MB)，およびTOTAL_SIZE_SGMT(MB)には，キャッシュファイルへの書き込みが完了した合計容量が表示されます。書き込み中の容量は含まれないため，OSコマンドなどで確認したキャッシュファイルの合計容量と一致しないことがあります。

TOTAL_SIZE_DIR(MB)：

TOTAL_SIZE(MB)に表示されたキャッシュファイルの合計容量のうち，ディレクトリページに対応するキャッシュファイルの合計容量が，メガバイト単位で表示されます。

TOTAL_SIZE_SGMT(MB)：

TOTAL_SIZE(MB)に表示されたキャッシュファイルの合計容量のうち，セグメントに対応するキャッシュファイルの合計容量が，メガバイト単位で表示されます。

TOTAL_NUM：

キャッシュファイルの格納先ディレクトリ（サーバ定義のadb_sys_cld_cache_pathオペランドの指定値）に格納されているキャッシュファイルの合計数が表示されます。

TOTAL_NUM_DIR：

TOTAL_NUMに表示されたキャッシュファイルの合計数のうち，ディレクトリページに対応するキャッシュファイルの合計数が表示されます。

TOTAL_NUM_SGMT：

TOTAL_NUMに表示されたキャッシュファイルの合計数のうち，セグメントに対応するキャッシュファイルの合計数が表示されます。

OPEN_NUM：

TOTAL_NUMに表示されたキャッシュファイルの合計数のうち，HADBサーバがオープン中のキャッシュファイルの合計数が表示されます。

22.4　リターンコード

adbls -d cfmコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

22.5　注意事項

adbls -d cfmコマンドの注意事項については，「23.5　注意事項」を参照してください。

23　adbls -d cltgrp（クライアントグループ・コマンドグループの情報表示）

この章では，adbls -d cltgrpコマンドの機能と使い方について説明します。

23.1　機能

adbls -d cltgrpコマンドを実行すると，クライアントグループおよびコマンドグループに関する情報を表示できます。

adbls -d cltgrpコマンドで表示される情報を次に示します。

クライアントグループおよびコマンドグループの情報

無所属の（グループに所属していない）HADBクライアントおよびコマンドの情報

クライアントグループ機能については，マニュアルHADB　システム構築・運用ガイドのアーキテクチャのクライアントグループ機能を参照してください。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

23.2　adbls -d cltgrpコマンドの指定形式

adbls -d cltgrpコマンドの指定形式およびオプションについて説明します。

adbls -d cltgrpコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

23.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d cltgrp 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

23.3　使用例

adbls -d cltgrpコマンドを実行して，クライアントグループおよびコマンドグループに関する情報を表示します。

クライアントグループおよびコマンドグループに関する情報は，次に示す順序で表示されます。

クライアントグループおよびコマンドグループの情報

サーバ定義のadbcltgrpオペランドを指定した数と同じ行数分，表示されます。

無所属の（グループに所属していない）HADBクライアントおよびコマンドの情報

1行にまとめて表示されます。

各出力項目の説明

各行に出力される情報の種類によって，出力項目の内容が異なります。

■クライアントグループおよびコマンドグループの情報

CLIENT_GROUP：

クライアントグループの場合，クライアントグループ名（サーバ定義adbcltgrpオペランドの-gオプションの指定値）が表示されます。

コマンドグループの場合，「command」が表示されます。

MAX_CON：

グループの最大同時接続数（サーバ定義adbcltgrpオペランドの-mオプションの指定値）※が表示されます。

GUARANTEE_CON：

グループの接続保証数（サーバ定義adbcltgrpオペランドの-uオプションの指定値）※が表示されます。

CON：

グループに所属しているHADBクライアントおよびコマンドの，HADBサーバへの接続数が表示されます。

MAX_RTHD：

グループで使用できる処理リアルスレッドの最大数（サーバ定義adbcltgrpオペランドの-rオプションの指定値）※が表示されます。

GUARANTEE_RTHD：

グループで使用できる処理リアルスレッドの保証数（サーバ定義adbcltgrpオペランドの-eオプションの指定値）※が表示されます。

RTHD：

グループに所属しているHADBクライアントおよびコマンドで使用中の，処理リアルスレッド数が表示されます。

WRNMSG_CON：

このクライアントグループに適用されている最大同時接続数に関する警告メッセージの出力契機（サーバ定義のadbcltgrpオペランドの-wオプションの指定値）が表示されます。

RSTWRN_CON：

このクライアントグループに適用されている最大同時接続数に関する警告メッセージの出力済み状態のリセット契機（サーバ定義のadbcltgrpオペランドの-wオプションの指定値）※が表示されます。

注※

サーバ定義adbcltgrpオペランドの各オプションに指定した値と，実際に適用された値が異なる場合は，実際に適用された値が表示されます。

■無所属のHADBクライアントおよびコマンドの情報

CLIENT_GROUP：

「-----」が出力されます。

MAX_CON：

接続数の自由利用枠※が表示されます。

GUARANTEE_CON：

無所属のHADBクライアントやコマンドだけが使用できる接続数※が表示されます。

CON：

無所属のHADBクライアントおよびコマンドが使用中の，HADBサーバへの接続数の合計が表示されます。

MAX_RTHD：

処理リアルスレッド数の自由利用枠※が表示されます。

GUARANTEE_RTHD：

無所属のHADBクライアントやコマンドだけが使用できる処理リアルスレッド数※が表示されます。

RTHD：

無所属のHADBクライアントおよびコマンドが使用中の，処理リアルスレッド数の合計が表示されます。

WRNMSG_CON：

無所属のHADBクライアントおよびコマンドに適用されている最大同時接続数に関する警告メッセージの出力契機※が表示されます。

RSTWRN_CON：

無所属のHADBクライアントおよびコマンドに適用されている最大同時接続数に関する警告メッセージの出力済み状態のリセット契機が表示されます。

注※

各項目については，マニュアルHADB　システム構築・運用ガイドのリソースの設計のクライアントグループ機能を適用する際の考慮点を参照してください。

23.4　リターンコード

adblsコマンドのリターンコードを次の表に示します。adblsコマンドのリターンコードは，すべて共通です。

表23‒1　adblsコマンドのリターンコード

リターンコード

意味

0

adblsコマンドが正常に終了しました。

4

adblsコマンドが警告メッセージを出力して終了しました。adblsコマンドの実行結果は表示されています。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adblsコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

23.5　注意事項

adblsコマンドは，HADBサーバの性能に影響を及ぼさないように，HADBサーバの状態を無排他で参照しています。そのため，実行したタイミングによっては不整合な値が出力されることがあります。この場合，adblsコマンドを再実行してください。

HADBサーバが異常終了または強制終了したあとにadblsコマンド（adbls -d srvコマンドおよびadbls -d verコマンドを除く）を実行すると，異常終了直前または強制終了直前の情報が表示されます。

マルチノード機能を使用している場合，HADBサーバが異常終了または強制終了したノードでadblsコマンドを実行すると，異常終了直前または強制終了直前のHADBサーバやノードの状態が表示されます。

HADBサーバが開始処理中または終了処理中のときに，adblsコマンド（adbls -d srvコマンドおよびadbls -d verコマンドを除く）を実行した場合，正しくない情報が表示されることがあります。

HADBサーバが正常終了したあとに，adblsコマンド（adbls -d srvコマンドおよびadbls -d verコマンドを除く）を実行することはできません。

24　adbls -d cnct（コネクションの状態表示）

この章では，adbls -d cnctコマンドの機能と使い方について説明します。

24.1　機能

adbls -d cnctコマンドを実行すると，HADBサーバに接続しているコネクションの状態を表示できます。

■マルチノード機能を使用している場合

プライマリノードまたはセカンダリノードでadbls -d cnctコマンドを実行した場合，マルチノード構成のHADBサーバに接続しているすべてのコネクションの情報が表示されます。

ワーカーノードでadbls -d cnctコマンドを実行した場合，adbls -d cnctコマンドを実行したワーカーノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）のコネクション情報だけが表示されます。

24.2　adbls -d cnctコマンドの指定形式

adbls -d cnctコマンドの指定形式およびオプションについて説明します。

adbls -d cnctコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

24.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d cnct 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

24.3　使用例

adbls -d cnctコマンドを実行して，HADBサーバに接続しているコネクションの状態を表示します。

注

コネクションがない場合は，出力項目のタイトルだけが表示されます。

上記の例では，次の個所で行を分けて表示していますが，実際はすべての出力項目が横一列に並んで表示されます。

・STATUSとTRN_ISO_LVの間

・CLIENT_GROUPとSQL_ELAPSED_TIMEの間

各出力項目の説明

CID：

コネクションIDが表示されます。

CNUMBER：

HADBサーバが起動してからのコネクション通番が表示されます。

CONNECT_TIME：

コネクションを確立した時刻が表示されます。

PROGRAM：

AP識別子が表示されます。

APまたはadbsqlコマンドの場合

クライアント定義のadb_clt_ap_nameオペランドに指定されているAP識別子が表示されます。adb_clt_ap_nameオペランドを省略している場合は，********が表示されます。

コマンドの場合（adbsqlコマンドを除く）

adbimportコマンドなどによるコネクションの場合は，コマンド名（例：adbimport）が表示されます。

C-PID：

コネクションを確立したHADBクライアントのプロセスIDが表示されます。ただし，JDBCドライバからのコネクションの場合は，0が表示されます。

IP-ADDRESS：

コネクションを確立したHADBクライアントのIPアドレスが表示されます。

STATUS：

コネクションの状態が表示されます。次に示すどれかの状態が表示されます。

NOT_STARTED：トランザクション開始前

THREAD_WAITING：処理リアルスレッド確保待ち中

STARTING：トランザクション開始処理中

STARTED：トランザクション実行中

COMMITTING：コミット処理中

ROLLBACKING：ロールバック処理中

次に示す状態は，マルチノード機能を使用している場合にだけ表示されます。

SWITCH_WAITING：プライマリノードの切り替え待ち中（プライマリノードの切り替え処理中）

RETURN_WAITING：ノードの復帰待ち中（ノードの復帰処理中）

NODE_WAITING：他ノードで実行中のトランザクションの終了待ち中

ADD_WAITING：ワーカーノードの追加待ち中（ワーカーノードの追加処理中）

■マルチノード機能を使用している場合

トランザクションを実行しているノード（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードを含む）の場合は，次に示す状態が表示されることがあります（次に示す状態に変更されることがあるためです）。なお，トランザクションを実行していないノードの場合は，次に示す状態が表示されることはありません。

・THREAD_WAITING：処理リアルスレッド確保待ち中

・STARTING：トランザクション開始処理中

・COMMITTING：コミット処理中

・ROLLBACKING：ロールバック処理中

プライマリノードの場合は，次に示す状態が表示されることがあります（次に示す状態に変更されることがあるためです）。なお，セカンダリノードおよびワーカーノードの場合は，次に示す状態が表示されることはありません。

・SWITCH_WAITING：プライマリノードの切り替え待ち中（プライマリノードの切り替え処理中）

・RETURN_WAITING：ノードの復帰待ち中（ノードの復帰処理中）

・NODE_WAITING：他ノードで実行中のトランザクションの終了待ち中

・ADD_WAITING：ワーカーノードの追加待ち中（ワーカーノードの追加処理中）

TRN_ISO_LV：

トランザクションの隔離性水準が表示されます。次に示すどちらかが表示されます。

READ_COMMITTED：トランザクション隔離性水準がREAD COMMITTED

REPEATABLE_READ：トランザクション隔離性水準がREPEATABLE READ

ACCESS_MODE：

トランザクションアクセスモードが表示されます。次に示すどちらかが表示されます。

READ_ONLY：読み取り専用トランザクション

READ_WRITE：読み書き可能トランザクション

CONNECTION_INFORMATION：

コネクション情報が表示されます。ここに表示されるコネクション情報は，コネクション確立時にメッセージログファイルに出力されるKFAA81000-Iメッセージのコネクション情報と同じです。

NODE_NO：

コネクションがトランザクションを実行しているノードのノード番号が表示されます。

ただし，JDBCドライバからコネクションを確立している場合で，保持機能にHOLD_CURSORS_OVER_COMMITを指定して作成したResultSetオブジェクトがあるときは，トランザクションを正常終了しても，正常終了する前にトランザクションを実行していたノードのノード番号が表示されます。

また，SQLパラレル実行機能を適用した検索系SQLを実行中のトランザクションの場合，SQLメインノードのノード番号が表示されます。

なお，マルチノード機能を使用していない場合は，何も表示されません。

CLIENT_TYPE：

コネクションを確立したクライアントの種類が表示されます。

AP(JDBC)：APがJDBCドライバから接続している場合

AP(C Library)：APがJDBCドライバ以外から接続している場合

command：コマンドが接続している場合

CLIENT_GROUP：

APまたはadbsqlコマンドの場合

HADBクライアントが所属しているクライアントグループ名が表示されます。HADBクライアントがコマンドグループに所属しているときは，「command」が表示されます。

どのグループにも所属していないHADBクライアントの場合は，何も表示されません。

コマンドの場合（adbsqlコマンドを除く）

コマンドグループを設定しているときは，「command」が表示されます。

コマンドグループを設定していないときは，何も表示されません。

SQL_ELAPSED_TIME：

APの場合

コネクションで実行されているSQL文の中で，実行してから最も時間が経過している，SQL文の経過時間がマイクロ秒で表示されます。

なお，実行中のSQL文がない場合は，何も表示されません。

また，マルチノード機能を使用している場合は，トランザクションを実行しているノードでだけSQL文の経過時間が出力されます。

ただし，SQLパラレル実行機能を適用した検索系SQLを実行中のトランザクションの場合は，SQLメインノードでだけSQL文の経過時間が出力されます。

SQL文の実行中にHADBサーバが異常終了または強制終了したあとに，adbls -d cnctコマンドを実行すると，次に示す2つの時刻の差分が経過時間として出力されます。

実行中だったSQL文の中で，実行してから最も時間が経過しているSQL文の開始時刻

HADBサーバが異常終了または強制終了した時刻

コマンドの場合

コネクションで実行されているコマンドの，コマンドを実行してからの経過時間がマイクロ秒で表示されます。

なお，マルチノード機能を使用している場合は，コマンドを実行しているノードでだけコマンドの経過時間が出力されます。

コマンドの実行中にHADBサーバが異常終了または強制終了したあとに，adbls -d cnctコマンドを実行すると，次に示す2つの時刻の差分が経過時間として出力されます。

実行中だったコマンドの開始時刻

HADBサーバが異常終了または強制終了した時刻

24.4　リターンコード

adbls -d cnctコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

24.5　注意事項

adbls -d cnctコマンドの注意事項については，「23.5　注意事項」を参照してください。

25　adbls -d gbuf（グローバルバッファの情報表示）

この章では，adbls -d gbufコマンドの機能と使い方について説明します。

25.1　機能

adbls -d gbufコマンドを実行すると，グローバルバッファの情報を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

25.2　adbls -d gbufコマンドの指定形式

adbls -d gbufコマンドの指定形式およびオプションについて説明します。

adbls -d gbufコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

25.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d gbuf 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

25.3　使用例

adbls -d gbufコマンドを実行して，グローバルバッファの情報を表示します。

各出力項目の説明

BUFF_NAME：

サーバ定義のadbbuffオペランドの-gオプションに指定したグローバルバッファ名，またはHADBが自動的に決定したグローバルバッファ名が表示されます。

メモ

adbbuffオペランドの-oオプションを指定した場合，HADBが自動的に決定したグローバルバッファ名として「グローバルバッファ名#nnnnnnnnnn」（nはページサイズを10桁の10進数で表現したもの）が表示されます。

-oオプションを指定しなかった場合，HADBが自動的に決定したグローバルバッファ名として「##ADBOTHER#nnnnnnnnnn」（nはページサイズを10桁の10進数で表現したもの）が表示されます。

DBAREA_NAME：

サーバ定義のadbbuffオペランドの-nオプションに指定したDBエリア名，またはHADBが自動的にグローバルバッファを割り当てたDBエリア名が表示されます。

グローバルバッファに複数のDBエリアを割り当てている場合は，DBエリア名が複数行で表示されます。

PAGE_SIZE：

グローバルバッファのページサイズがキロバイト単位で表示されます。DBエリアのページサイズと同じ値になります。

サーバ定義のadb_dbarea_wrk_page_sizeオペランドを指定して，HADBサーバ開始時に作業表用DBエリアのページサイズを変更している場合，ADBWRK（グローバル作業表用のグローバルバッファ）には変更後のページサイズが表示されます。

PAGE_NUM：

サーバ定義のadbbuffオペランドの-pオプションに指定したグローバルバッファのページ数が表示されます。

ただし，ADBWRK（グローバル作業表用のグローバルバッファ）の場合は，サーバ定義のadb_dbbuff_wrktbl_glb_blk_numオペランドに指定した値が表示されます。

また，サーバ定義のadbbuffオペランドの-pオプション，またはサーバ定義のadb_dbbuff_wrktbl_glb_blk_numオペランドを指定しなかった場合は，省略値が表示されます。

グローバルバッファのページ数にどの値が適用されているかは，グローバルバッファの末尾に表示されている記号で確認できます。記号の意味を次の表に示します。

表25‒1　グローバルバッファのページ数の末尾に表示される記号の意味

項番

末尾に表示される記号

記号の意味

該当するグローバルバッファ

グローバルバッファのページ数に表示される値

1

S

サーバ定義に指定した値を使用

サーバ定義のadbbuffオペランドで定義したグローバルバッファ

サーバ定義のadbbuffオペランドの-pオプションの指定値

2

グローバル作業表用のグローバルバッファ（ADBWRK）

サーバ定義のadb_dbbuff_wrktbl_glb_blk_numオペランドの指定値

3

D

省略値を使用

サーバ定義のadbbuffオペランドで定義したグローバルバッファ，または自動的に定義されるグローバルバッファ

サーバ定義のadbbuffオペランドの-pオプションの省略値

4

グローバル作業表用のグローバルバッファ（ADBWRK）

サーバ定義のadb_dbbuff_wrktbl_glb_blk_numオペランドの省略値

5

マスタディレクトリ用グローバルバッファ（ADBMST）

ADBMST用の省略値

RANGE_IDX_PAGE_NUM：

サーバ定義のadbbuffオペランドの-aオプションに指定したレンジインデクス専用のグローバルバッファのページ数が表示されます。

サーバ定義のadbbuffオペランドの-aオプションを指定しなかった場合は，0が表示されます。

TABLE_SCAN_BUFFER_SIZE(MB)：

テーブルスキャンバッファに使用するメモリサイズが，メガバイト単位で表示されます。

表示される値は，サーバ定義のadbbuffオペランドの-vオプションまたは-kオプションの指定によって異なります。詳細を次の表に示します。

表25‒2　TABLE_SCAN_BUFFER_SIZE(MB)に表示される値

項番

テーブルスキャンバッファの指定有無

TABLE_SCAN_BUFFER_SIZE(MB)に表示される値

1

adbbuffオペランドの-vオプションを指定している場合

-vオプションのテーブルスキャンバッファに使用するメモリサイズの指定値

2

adbbuffオペランドの-kオプションを指定している場合

次の計算式で求めた値

-kオプションの指定値×4

3

adbbuffオペランドに-vオプション，および-kオプションを指定していない場合

0

TABLE_SCAN_BUFFER_THREAD_MAX_SIZE(MB)：

テーブルスキャンバッファのリアルスレッドごとに使用するメモリサイズの上限値が，メガバイト単位で表示されます。

表示される値は，サーバ定義のadbbuffオペランドの-vオプションまたは-kオプションの指定によって異なります。詳細を次の表に示します。

表25‒3　TABLE_SCAN_BUFFER_THREAD_MAX_SIZE(MB)に表示される値

項番

テーブルスキャンバッファの指定有無

-vオプションのリアルスレッドごとに使用するメモリサイズの上限値の指定有無

TABLE_SCAN_BUFFER_THREAD_MAX_SIZE(MB)に表示される値

1

adbbuffオペランドの-vオプションを指定している場合

指定している場合

-vオプションのリアルスレッドごとに使用するメモリサイズの上限値の指定値

2

指定していない場合

0

3

adbbuffオペランドの-kオプションを指定している場合

−

次の計算式で求めた値

-kオプションの指定値×4÷サーバ定義adb_sys_rthd_numオペランドの値

なお，上記の計算式で求めた値が5メガバイト未満の場合は，5メガバイトに切り上げられます。

4

adbbuffオペランドに-vオプション，および-kオプションを指定していない場合

−

0

（凡例）

−：該当しません。

メモ

サーバ定義のオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容を参照してください。

DBエリア名については，「20.5.1　作成されるDBエリアの属性」を参照してください。

25.4　リターンコード

adbls -d gbufコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

25.5　注意事項

adbls -d gbufコマンドの注意事項については，「23.5　注意事項」を参照してください。

26　adbls -d lbuf（ローカル作業表用バッファの情報表示）

この章では，adbls -d lbufコマンドの機能と使い方について説明します。

26.1　機能

adbls -d lbufコマンドを実行すると，ローカル作業表用バッファの情報を表示できます。

マルチノード機能を使用している場合は，次の情報が表示されます。

adbls -d lbufコマンドを実行したノードの，ローカル作業表用バッファのページ数，およびページサイズ※

マルチノード構成のHADBサーバに接続中のコネクションごとの，ローカル作業表用バッファのページ数，およびページサイズ（adbls -d lbufコマンドを実行したノードで，トランザクションを実行した際に使用するページ数，およびページサイズ）

注※

ページ数には，サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドに指定した値が表示されます。

ページサイズには，adbinitコマンドの初期設定オプションのadb_init_wrk_page_sizeに指定した値が表示されます。

メモ

ローカル作業表用バッファのページサイズは，作業表用DBエリアのページサイズ（adb_init_wrk_page_size）と同じ値になります。

26.2　adbls -d lbufコマンドの指定形式

adbls -d lbufコマンドの指定形式およびオプションについて説明します。

adbls -d lbufコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

26.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d lbuf 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

26.3　使用例

adbls -d lbufコマンドを実行して，ローカル作業表用バッファの情報を表示します。

adbls -d lbuf

CNUMBER    PAGE_SIZE PAGE_NUM
0          256       256 D
1          256       128 C
3          256       10 C
4          256       256 D
5          256       256 D

各出力項目の説明

CNUMBER：

HADBサーバが起動してからのコネクション通番が表示されます。

コネクション通番に対応するAP識別子またはコマンドは，adbls -d cnctコマンドで確認できます。

adbls -d cnctコマンドの実行結果の，同じコネクション通番のPROGRAM欄で確認できます。

CNUMBERの項目に0が表示された場合は，PAGE_NUMには次のどれかの値が表示されます。

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値，または省略値

バッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numの指定値

adbls -d cnctコマンドについては，「24.　adbls -d cnct（コネクションの状態表示）」を参照してください。

PAGE_SIZE：

APまたはコマンドの処理で使用しているローカル作業表用バッファのページサイズがキロバイト単位で表示されます。作業表用DBエリアのページサイズと同じ値になります。

サーバ定義のadb_dbarea_wrk_page_sizeオペランドを指定して，HADBサーバ開始時に作業表用DBエリアのページサイズを変更している場合は，変更後のページサイズが表示されます。

PAGE_NUM：

APまたはコマンドの処理で使用しているローカル作業表用バッファのページ数が表示されます。

次のどれかの値が表示されます。

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値，または省略値

クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値

エクスポートオプションadb_export_wrktbl_blk_numの指定値

バッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numの指定値

上記のうちのどの値が適用されているかは，ローカル作業表用バッファの末尾に表示されている記号で確認できます。記号の意味を次の表に示します。

表26‒1　ローカル作業表用バッファのページ数の末尾に表示される記号の意味

項番

末尾に表示される記号

記号の意味

ローカル作業表用バッファのページ数に表示される値

1

S

サーバ定義に指定した値を使用

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値

2

S*

バッファ変更オプションに指定した値を使用

バッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numの指定値

3

C

クライアント定義，またはエクスポートオプションに指定した値を使用

クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値

4

エクスポートオプションadb_export_wrktbl_blk_numの指定値

5

D

省略値を使用

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの省略値

ローカル作業表用バッファのページ数に表示される値は，サーバ定義およびクライアント定義の指定や，adbmodbuffコマンドを実行したかどうかによって異なります。詳細を次に示します。

例1：サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを省略した場合

adbls -d lbuf

CNUMBER    PAGE_SIZE PAGE_NUM
0          256       256 D
1          256       128 C
3          256       10 C
4          256       256 D
5          256       256 D

CNUMBERが0の行には，サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの省略値が表示されています。

コネクション通番1および3では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを指定しています。このため，CNUMBERが1の行，および3の行には，PAGE_NUMにクライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値が表示されています。

コネクション通番4および5では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを省略しています。このため，CNUMBERが4の行，および5の行には，PAGE_NUMにサーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの省略値が表示されています。

例2：サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを指定した場合

adbls -d lbuf

CNUMBER    PAGE_SIZE PAGE_NUM
0          256       128 S
1          256       128 C
3          256       10 C
4          256       128 S
5          256       128 S

CNUMBERが0の行には，サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値が表示されています。

コネクション通番1および3では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを指定しています。このため，CNUMBERが1の行，および3の行には，PAGE_NUMにクライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値が表示されています。

コネクション通番4および5では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを省略しています。このため，CNUMBERが4の行，および5の行には，PAGE_NUMにサーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値が表示されています。

例3：adbmodbuffコマンドを実行した場合

adbls -d lbuf

CNUMBER    PAGE_SIZE PAGE_NUM
0          256       128 S*
1          256       128 C
3          256       10 C
4          256       128 S*
5          256       128 S*

CNUMBERが0の行には，バッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numの指定値が表示されています。

コネクション通番1および3では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを指定しています。このため，CNUMBERが1の行，および3の行には，PAGE_NUMにクライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値が表示されています。

コネクション通番4および5では，クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドを省略しています。このため，CNUMBERが4の行，および5の行には，PAGE_NUMにバッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numの指定値が表示されています。

メモ

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容の性能に関するオペランド（set形式）を参照してください。

クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドについては，マニュアルHADB　AP開発ガイドのクライアント定義の設計のクライアント定義のオペランドの内容の性能に関するオペランドを参照してください。

エクスポートオプションadb_export_wrktbl_blk_numについては，「14.2.2　エクスポートオプションの形式」を参照してください。

バッファ変更オプションadb_dbbuff_wrktbl_clt_blk_numについては，「38.2.2　バッファ変更オプションの形式」を参照してください。

26.4　リターンコード

adbls -d lbufコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

26.5　注意事項

adbls -d lbufコマンドの注意事項については，「23.5　注意事項」を参照してください。

27　adbls -d lock（排他資源の状態表示）

この章では，adbls -d lockコマンドの機能と使い方について説明します。

27.1　機能

adbls -d lockコマンドを実行すると，排他資源の状態を表示できます。

マルチノード機能を使用している場合は，adbls -d lockコマンドを実行したノードでトランザクションを実行しているコネクションが取得している排他の情報が表示されます。

27.2　adbls -d lockコマンドの指定形式

adbls -d lockコマンドの指定形式およびオプションについて説明します。

adbls -d lockコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

27.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d lock 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

27.3　使用例

adbls -d lockコマンドを実行して，排他資源の状態を表示します。

各出力項目の説明

RESOURCETYPE：

APおよびコマンドが確保要求を発行した排他資源の種別が表示されます。次に示すどれかが表示されます。

SINGLE_CONNECTION：シングルコネクション

DATABASE_ACCESS：データベースアクセス

DICTIONARY：ディクショナリ

DBAREA：DBエリア

データ用DBエリア，ディクショナリ用DBエリア，およびシステム表用DBエリアが該当します。

TABLE：表

処理対象表，システム表，およびディクショナリ表が該当します。

PREPARE_TABLE：前処理表

RESOURCEID：

APおよびコマンドが確保要求を発行した排他資源のIDが表示されます。

排他資源の種別がシングルコネクション，データベースアクセス，またはディクショナリの場合

*が表示されます。

排他資源の種別がDBエリアの場合

DBエリアIDが表示されます。

排他資源の種別が表，または前処理表の場合

表IDが表示されます。

ディクショナリ表に対して排他資源の確保要求を発行している場合は，ディクショナリ表（実表）の表IDが表示されます。また，システム表に対して排他資源の確保要求を発行している場合は，システム表（実表）の表IDが表示されます。

LOCK_MODE：

排他制御モードが表示されます。次に示すどれかが表示されます。

EXCLUSIVE：占有モード（EXCLUSIVE）（EX）

PRTCT_UPD：保護更新モード（PROTECTED UPDATE）（PU）

SHARE_UPD：共有更新モード（SHARED UPDATE）（SU）

SHARE：共有参照モード（SHARED RETRIEVE）（SR）

NODE_NO：

マルチノード機能を使用している場合は，排他資源の確保要求を発行したノードのノード番号が表示されます。

マルチノード機能を使用していない場合は，何も表示されません。

CID：

排他資源の確保要求を発行したコネクションのコネクションIDが表示されます。

「更新行のカラム化機能」のメンテナンス処理が排他資源の確保要求を発行した場合は，"SYSTEM"が表示されます。

STATUS：

発行された排他資源の確保要求の状態が表示されます。次に示すどれかが表示されます。

WAITING：排他資源の確保待ち

LOCKING：排他資源の確保中

ESCALAT：排他制御モードの遷移待ち

SYSWAIT：次に示す機能またはコマンドの排他解除待ち

更新行のカラム化機能

adbmergechunkコマンド

COUNT：

同一トランザクションで排他資源を確保した回数が表示されます。

一度も排他資源を確保していない場合は，何も表示されません。

LOCK_TIME：

最初に排他資源の確保要求を発行した時刻が表示されます。

ESCALAT_MODE：

STATUS列に「ESCALAT」が出力されている場合に，現在の排他制御モードが遷移したあとに適用される排他制御モードが表示されます。

STATUS列に「ESCALAT」以外が出力されている場合は，何も表示されません。

EXCLUSIVE：占有モード（EXCLUSIVE）（EX）

PRTCT_UPD：保護更新モード（PROTECTED UPDATE）（PU）

SHARE_UPD：共有更新モード（SHARED UPDATE）（SU）

SHARE：共有参照モード（SHARED RETRIEVE）（SR）

メモ

排他資源および排他制御モードの詳細については，HADB　システム構築・運用ガイドのアーキテクチャの排他制御を参照してください。

27.4　リターンコード

adbls -d lockコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

27.5　注意事項

adbls -d lockコマンドの注意事項については，「23.5　注意事項」を参照してください。

28　adbls -d mem（メモリの使用状況の表示）

この章では，adbls -d memコマンドの機能と使い方について説明します。

28.1　機能

adbls -d memコマンドを実行すると，サーバプロセスのメモリの使用状況を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

28.2　adbls -d memコマンドの指定形式

adbls -d memコマンドの指定形式およびオプションについて説明します。

adbls -d memコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

28.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d mem 〔-a〕 〔-t〕 〔-c〕

(2)　オプションの説明

●-a

サーバプロセスが確保するメモリ（共有メモリおよびヒープメモリ）の状況を表示する場合に指定します。

このオプションを省略すると，共有メモリのうち，プロセス共通メモリとリアルスレッド固有メモリのそれぞれの使用状況を表示します。

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

28.3　使用例

adbls -d memコマンドを実行して，メモリの使用状況を表示する方法について説明します。

なお，adbls -d memコマンドを実行する際，-aオプションの指定有無によって，出力項目が異なります。

28.3.1　プロセス共通メモリとリアルスレッド固有メモリの使用状況を表示する（-aオプション指定なし）

adbls -d memコマンドを実行して，サーバプロセスが確保する共有メモリのうち，プロセス共通メモリ，およびリアルスレッド固有メモリの使用状況を表示します。

adbls -d mem

THREAD-NO   LIMIT         USE          FREE         MAX
0           1073741824    105840224    162660848    105840224
1           1073741824    901024       267600048    901056
2           1073741824    900512       267600560    900512
3           1073741824    900512       267600560    900512
4           1073741824    900512       267600560    900512
5           1073741824    900512       267600560    900512
:               :           :              :          :

各出力項目の説明

THREAD-NO：

0の行には，プロセス共通メモリに関する情報が表示されます。

1以降の行には，リアルスレッド固有メモリに関する情報が表示されます。

LIMIT：

HADBサーバが使用できるメモリ容量の上限値（単位：バイト）が表示されます。

サーバ定義のadb_sys_memory_limitオペランドを指定している場合は，アスタリスク（*）が表示されます。

USE：

現在，HADBサーバが使用しているメモリ容量（単位：バイト）が表示されます。

FREE：

空いているメモリ容量（単位：バイト）が表示されます。

MAX：

過去にHADBサーバが使用したメモリ容量（単位：バイト）の最大値が表示されます。

28.3.2　メモリの合計サイズを表示する（-aオプション指定あり）

adbls -d memコマンドを実行して，サーバプロセスが確保するメモリ（共有メモリおよびヒープメモリ）の状況を表示します。

各出力項目の説明

TOTAL_LIMIT：

HADBサーバが確保できるメモリ容量の合計の上限値（サーバ定義のadb_sys_memory_limitオペランドの指定値）（単位：メガバイト）が表示されます。

サーバ定義のadb_sys_memory_limitオペランドを指定していない場合は，アスタリスク（*）が表示されます。

TOTAL_USE：

現在，HADBサーバが確保しているメモリ容量の合計（単位：メガバイト）が表示されます。

TOTAL_USE_PER：

HADBサーバが確保できるメモリ容量の合計の上限値に対して，現在，HADBサーバが使用しているメモリ容量の合計の割合（単位：％）が表示されます。

サーバ定義のadb_sys_memory_limitオペランドを指定していない場合は，アスタリスク（*）が表示されます。

TOTAL_MAX：

HADBサーバが起動してから確保したメモリ容量の合計の最大値（単位：メガバイト）が表示されます。

TOTAL_MAX_TIME：

出力項目TOTAL_MAXの値に達した時刻が表示されます。HADBサーバが起動してからTOTAL_MAXの値に達したことが複数回ある場合は，最も古い時刻が表示されます。

TOTAL_MAX_1h：

直近1時間以内にHADBサーバが確保したメモリ容量の合計の最大値（単位：メガバイト）が表示されます。

なお，HADBサーバが異常終了したあとに，-aオプションを指定してadbls -d memコマンドを実行した場合は，HADBサーバが異常終了した時刻から1時間以内の範囲で，HADBサーバが確保したメモリ容量の合計の最大値が表示されます。

また，-aオプションを指定したadbls -d memコマンドの実行タイミングによっては，直近59分の範囲までしか最大値が表示されないことがあります。

TOTAL_MAX_TIME_1h：

出力項目TOTAL_MAX_1hの値に達した時刻が表示されます。直近1時間以内でTOTAL_MAX_1hの値に達したことが複数回ある場合は，最も古い時刻が表示されます。

TOTAL_MAX_1d：

直近1日以内にHADBサーバが確保したメモリ容量の合計の最大値（単位：メガバイト）が表示されます。

なお，HADBサーバが異常終了したあとに，-aオプションを指定してadbls -d memコマンドを実行した場合は，HADBサーバが異常終了した時刻から1日以内の範囲で，HADBサーバが確保したメモリ容量の合計の最大値が表示されます。

また，-aオプションを指定したadbls -d memコマンドの実行タイミングによっては，直近23時間の範囲までしか最大値が表示されないことがあります。

TOTAL_MAX_TIME_1d：

出力項目TOTAL_MAX_1dの値に達した時刻が表示されます。直近1日以内でTOTAL_MAX_1dの値に達したことが複数回ある場合は，最も古い時刻が表示されます。

GBUFFER_USE：

現在，HADBサーバが確保しているグローバルバッファページの合計（単位：メガバイト）が表示されます。

PROCESS_USE：

現在，HADBサーバが確保しているプロセス共通メモリの合計（単位：メガバイト）が表示されます。

なお，サーバ定義adb_sys_shm_huge_page_sizeオペランドを指定している場合は，共有メモリを確保するときに，サーバ定義adb_sys_shm_huge_page_sizeオペランドの指定値で切り上げた値の合計が表示されます。そのため，-aオプションを指定しないでadbls -d memコマンドを実行したときに表示されるプロセス共通メモリのUSEの値，およびFREEの値の合計と一致しないことがあります。

THREAD_USE：

現在，HADBサーバが確保しているリアルスレッド固有メモリの合計（単位：メガバイト）が表示されます。

なお，サーバ定義adb_sys_shm_huge_page_sizeオペランドを指定している場合は，共有メモリを確保するときに，サーバ定義adb_sys_shm_huge_page_sizeオペランドの指定値で切り上げた値の合計が表示されます。そのため，-aオプションを指定しないでadbls -d memコマンドを実行したときに表示されるリアルスレッド固有メモリのUSEの値，およびFREEの値の合計と一致しないことがあります。

HEAP_USE：

現在，HADBサーバが確保しているヒープメモリの合計（単位：メガバイト）が表示されます。

OTHER_USE：

現在，HADBサーバが確保している共有メモリ管理用のメモリの合計（単位：メガバイト）が表示されます。

28.4　リターンコード

adbls -d memコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

28.5　注意事項

adbls -d memコマンドの注意事項については，「23.5　注意事項」を参照してください。

29　adbls -d node（各ノードのHADBサーバの状態表示）

この章では，adbls -d nodeコマンドの機能と使い方について説明します。

29.1　機能

adbls -d nodeコマンドを実行すると，マルチノード構成の各HADBサーバの状態を表示できます。

ただし，ワーカーノードでadbls -d nodeコマンドを実行すると，プライマリノード，セカンダリノード，およびコマンドを実行したワーカーノードのHADBサーバの状態だけが表示されます。ほかのワーカーノードのHADBサーバの状態は表示されません。

マルチノード機能を使用していない場合は，出力項目のタイトルだけが表示されます。

29.2　adbls -d nodeコマンドの指定形式

adbls -d nodeコマンドの指定形式およびオプションについて説明します。

adbls -d nodeコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

29.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d node 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

29.3　使用例

マルチノード構成の各HADBサーバの状態を表示します。

例1（すべてのノードのHADBサーバが稼働している場合）

adbls -d node

NODE_NO NODE_TYPE SVID       IP-ADDRESS        STATUS   START_TIME
1       PRIMARY   22602      (XX.XXX.XX.14   ) ACTIVE   2021-12-05 18:03:22
2       SECONDARY 16226      (XX.XXX.XX.16   ) ACTIVE   2021-12-05 18:03:13
3       SECONDARY 7749       (XX.XXX.XX.6    ) ACTIVE   2021-12-05 18:03:19
4       WORKER    8801       (XX.XXX.XX.8    ) ACTIVE   2021-12-05 18:03:31
5       WORKER    8964       (XX.XXX.XX.9    ) ACTIVE   2021-12-05 18:03:40

例2（マルチノード構成から切り離されたノードがある場合）

adbls -d node

NODE_NO NODE_TYPE SVID       IP-ADDRESS        STATUS   START_TIME
1       PRIMARY              (XX.XXX.XX.14   ) ABORT
2       PRIMARY   16226      (XX.XXX.XX.16   ) ACTIVE   2021-12-05 18:03:13
3       SECONDARY 7749       (XX.XXX.XX.6    ) ACTIVE   2021-12-05 18:03:19
4       WORKER    8801       (XX.XXX.XX.8    ) ACTIVE   2021-12-05 18:03:31
5       WORKER    8964       (XX.XXX.XX.9    ) ACTIVE   2021-12-05 18:03:40

上記の例では，ノード番号1のノードのHADBサーバが異常終了していて，マルチノード構成から切り離されています。

メモ

マルチノード構成から切り離されたノードでadbls -d nodeコマンドを実行した場合，切り離されたノードでは異なる情報（切り離される直前の各ノードの状態）が出力されます。

各出力項目の説明

NODE_NO：

HADBサーバのノード番号が表示されます。

NODE_TYPE：

HADBサーバのノード種別が表示されます。

PRIMARY：プライマリノード

SECONDARY：セカンダリノード

WORKER：ワーカーノード

STATUS列に「ABORT」が表示されている場合，NODE_TYPE列には，HADBサーバが異常終了する直前のノード種別が表示されます。そのため，NODE_TYPE列に「PRIMARY」が複数出力されることがあります。

SVID：

HADBサーバのプロセスIDが表示されます。

HADBサーバが停止中の場合は，何も表示されません。

IP-ADDRESS：

HADBサーバのIPアドレスが表示されます。

サーバ定義adb_sys_multi_node_infoオペランドに指定されたホスト名のIPアドレスが表示されます。

STATUS：

HADBサーバの状態が表示されます。

ACTIVE：稼働中

STOP：停止中

ABORT：異常終了

START_TIME：

HADBサーバの開始時刻が表示されます。

HADBサーバが停止中の場合は，何も表示されません。

29.4　リターンコード

adbls -d nodeコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

29.5　注意事項

adbls -d nodeコマンドの注意事項については，「23.5　注意事項」を参照してください。

30　adbls -d prl（SQLパラレル実行機能の情報表示）

この章では，adbls -d prlコマンドの機能と使い方について説明します。

30.1　機能

adbls -d prlコマンドを実行すると，実行中のSQLパラレル実行機能を適用した検索系SQLのトランザクションの情報を表示できます。

なお，表示されるのは，adbls -d prlコマンドを実行したノードで実行中のトランザクションの情報だけです。

SQLパラレル実行機能の詳細については，マニュアルHADB　システム構築・運用ガイドのSQLパラレル実行機能を参照してください。

30.2　adbls -d prlコマンドの指定形式

adbls -d prlコマンドの指定形式について説明します。

adbls -d prl

adbls -d prlコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

30.3　使用例

SQLパラレル実行機能を適用した検索系SQLのトランザクションの情報を表示します。

adbls -d prl

CNUMBER    SQL_ID               NODE_NO SQL_NODE_TYPE
1          1                    3       MAIN
1          1                    2       SUB
1          1                    1       SUB
1          1                    4       SUB

注

マルチノード機能を使用していない場合，またはadbls -d prlコマンドを実行したノードでSQLパラレル実行機能を適用した検索系SQLが実行中でない場合は，出力項目のタイトルだけが表示されます。

各出力項目の説明

CNUMBER：

SQLパラレル実行機能を適用した検索系SQLを実行しているトランザクションのコネクション通番が表示されます。

SQL_ID：

SQLパラレル実行機能を適用した検索系SQLのSQL通番が表示されます。

NODE_NO：

SQLパラレル実行機能を適用した検索系SQLを実行しているノードのノード番号が表示されます。

SQL_NODE_TYPE：

SQLパラレル実行機能を適用した検索系SQLを実行しているノードのSQLノード種別が表示されます。

MAIN：SQLメインノード

SUB：SQLサブノード

30.4　リターンコード

adbls -d prlコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

30.5　注意事項

HADBサーバが異常終了したノードでadbls -d prlコマンドを実行すると，異常終了直前の各ノードのHADBサーバの状態が表示されます。

31　adbls -d shm（共有メモリの情報表示）

この章では，adbls -d shmコマンドの機能と使い方について説明します。

31.1　機能

adbls -d shmコマンドを実行すると，HADBサーバが使用している共有メモリの情報を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

31.2　adbls -d shmコマンドの指定形式

adbls -d shmコマンドの指定形式およびオプションについて説明します。

adbls -d shmコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

31.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d shm 〔-a〕 〔-t〕 〔-c〕

(2)　オプションの説明

●-a

HADBサーバが使用している共有メモリの情報を共有メモリセグメントごとに表示する場合に指定します。

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

31.3　使用例

adbls -d shmコマンドを実行して，共有メモリの情報を表示する方法について説明します。

なお，adbls -d shmコマンドを実行する際，-aオプションの指定有無によって，出力項目が異なります。

31.3.1　共有メモリの情報を表示する（-aオプション指定なし）

adbls -d shmコマンドを実行して，共有メモリの情報を表示します。

adbls -d shm

SHM_NUMBER    SHM_SIZE
7             250626988

各出力項目の説明

SHM_NUMBER：

HADBサーバが使用している共有メモリの数が表示されます。

SHM_SIZE：

HADBサーバが使用している共有メモリの合計サイズがバイト単位で表示されます。

31.3.2　共有メモリの情報を表示する（-aオプション指定あり）

adbls -d shm -aコマンドを実行して，共有メモリの情報を表示します。

adbls -d shm -a

SYSID    SHMID     SIZE
1        720906    229376
4        753675    42845080
5        786444    24
6        819213    143359
7        851982    201326591
8        884751    4198399
9        917520    1884159

各出力項目の説明

SYSID：

HADBサーバが使用している共有メモリに割り振られた通し番号が表示されます。

SHMID：

共有メモリセグメントの識別子が表示されます。

SIZE：

個々の共有メモリのサイズが表示されます。

31.4　リターンコード

adbls -d shmコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

31.5　注意事項

adbls -d shmコマンドの注意事項については，「23.5　注意事項」を参照してください。

32　adbls -d srv（HADBサーバの状態表示）

この章では，adbls -d srvコマンドの機能と使い方について説明します。

32.1　機能

adbls -d srvコマンドを実行すると，HADBサーバの状態を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

32.2　adbls -d srvコマンドの指定形式

adbls -d srvコマンドの指定形式およびオプションについて説明します。

adbls -d srvコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

32.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d srv 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

32.3　使用例

HADBサーバの状態を表示します。

例1（HADBサーバが通常モードで稼働している場合）

adbls -d srv

SVID   STATUS   START_TIME            MSGLOG_STATUS
5360   ACTIVE   2017/03/02 09:31:04   NORMAL

例2（HADBサーバが停止している場合）

adbls -d srv

SVID   STATUS   START_TIME            MSGLOG_STATUS
       STOP                           NORMAL

各出力項目の説明

SVID：

HADBサーバのプロセスIDが表示されます。

HADBサーバが停止中の場合は何も表示されません。

STATUS：

HADBサーバの状態が表示されます。

ACTIVE：稼働中（通常モード）

STOP：停止中

STARTING：開始処理中

STOPPING：終了処理中

ABORT：異常終了

マニュアルHADB　システム構築・運用ガイドの障害運用の障害発生時の対処の流れのHADBサーバが異常終了した場合の対処を参照して，対処してください。

QUIESCE：稼働中（静止モード）

OFFLINE：稼働中（オフラインモード）

MAINTNCE：稼働中（メンテナンスモード）

CHGMODE：稼働中（稼働モードの変更中）

STOPWAIT：終了待機状態

COREDUMP：コアファイル出力中

FORCE：強制終了

START_TIME：

HADBサーバの開始時刻が表示されます。

HADBサーバが停止中の場合は何も表示されません。

MSGLOG_STATUS：

HADBサーバのメッセージログファイルのステータス情報が表示されます。

NORMAL：正常状態

FALLBACK：縮退状態

メッセージログファイルを格納しているディスクの空き容量が少なくなったことをHADBサーバが検知したため，ディスクの空き容量に応じて出力可能な範囲でメッセージログを出力している状態です。この場合，メッセージログファイルを正常状態に戻す必要があります。メッセージログファイルを正常状態に戻す方法については，マニュアルHADB　システム構築・運用ガイドのメッセージログファイルの縮退状態を解除する方法を参照してください。

32.4　リターンコード

adbls -d srvコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

32.5　注意事項

adbls -d srvコマンドの注意事項については，「23.5　注意事項」を参照してください。

33　adbls -d thd（スレッドの状態表示）

この章では，adbls -d thdコマンドの機能と使い方について説明します。

33.1　機能

adbls -d thdコマンドを実行すると，リアルスレッドおよび擬似スレッドの情報を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

33.2　adbls -d thdコマンドの指定形式

adbls -d thdコマンドの指定形式およびオプションについて説明します。

adbls -d thdコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

33.2.1　指定形式およびオプションの説明

(1)　指定形式

adbls -d thd 〔-t〕 〔-c〕

(2)　オプションの説明

●-t

タイトル行の表示を抑止します。例えば，1つのファイルに対して定期的にリダイレクションで情報を追加する場合に，このオプションを指定すると，タイトル行の重複を避けることができます。

●-c

コンマ区切りで表示します。例えば，リダイレクションで出力したファイルを表計算ソフトに読み込ませたい場合に，このオプションを指定すると，コンマ区切りで情報を出力できます。

また，このオプションを指定すると，次の内容は二重引用符（"）で囲まれます。

出力項目のタイトル部分の文字列

出力項目に表示される文字列の情報

なお，出力項目に表示される数値の情報については，二重引用符（"）で囲まれません。出力項目に表示される情報がない場合も同様です。

33.3　使用例

リアルスレッドおよび擬似スレッドの情報を表示します。

各出力項目の説明

THREAD-NO：

リアルスレッド番号が表示されます。

T-ID(OS)：

リアルスレッドID（OS）が表示されます。

メッセージログファイルに出力されるリアルスレッドIDと同じ形式の値が表示されます。

TOTAL_PSEUDO_THREAD：

リアルスレッド内で動作している擬似スレッド数が表示されます。HADBで使用する擬似スレッドもカウント対象になります。

TYPE：

リアルスレッド種別が表示されます。次に示すどれかが表示されます。

SYSTEM：システムが使用しているスレッド

CONNECT：コネクションスレッド（システムで使用しているコネクションスレッドも含みます）

PROCESS：処理スレッド

CNUMBER：

リアルスレッドを使用している処理のコネクション通番が表示されます。

SQL_ID：

リアルスレッドを使用して実行中のSQL文のSQL文通番が表示されます。

CLIENT_GROUP：

SQL文を実行したHADBクライアントが所属しているクライアントグループ名が表示されます。SQL文を実行したコマンドまたはHADBクライアントが，コマンドグループに所属しているときは，「command」が表示されます。

どのグループにも所属していないときは，何も表示されません。

T-ID(LWP)：

リアルスレッドID（LWPID）が表示されます。

33.4　リターンコード

adbls -d thdコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

33.5　注意事項

adbls -d thdコマンドの注意事項については，「23.5　注意事項」を参照してください。

34　adbls -d ver（HADBサーバのバージョン情報の表示）

この章では，adbls -d verコマンドの機能と使い方について説明します。

34.1　機能

adbls -d verコマンドを実行すると，HADBサーバのバージョン情報を表示できます。

マルチノード機能を使用している場合は，コマンドを実行したノードの情報だけが表示されます。

34.2　adbls -d verコマンドの指定形式

adbls -d verコマンドの指定形式について説明します。

adbls -d ver

adbls -d verコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

34.3　使用例

HADBサーバのバージョン情報を表示します。

adbls -d ver

P-8862-C811 Hitachi Advanced Data Binder 05-08 Jul 12 2023 12:32:59

下線部に，HADBサーバのPP形名情報およびバージョンが出力されます。

34.4　リターンコード

adbls -d verコマンドのリターンコードについては，「23.4　リターンコード」を参照してください。

34.5　注意事項

adbls -d verコマンドの注意事項については，「23.5　注意事項」を参照してください。

35　adbmergechunk（チャンクのマージ）

この章では，adbmergechunkコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

35.1　機能

この節では，adbmergechunkコマンドの機能，および使用するスレッドについて説明します。

adbmergechunkコマンドは，コマンド実行時にHADBサーバに接続します。

35.1.1　機能概要

adbmergechunkコマンドを実行すると，マルチチャンク表の複数のチャンクを，1つの新規チャンクにマージできます。この処理をマージチャンク処理といいます。

マージチャンク処理を実行すると，使用しているチャンク数を削減できます。

マージチャンク処理の概要を次の図に示します。

図35‒1　マージチャンク処理の概要

［説明］

adbmergechunkコマンドを実行すると，任意の複数のチャンク（マージ元チャンク）の表データを，1つの新規チャンク（マージ先チャンク）にマージします。次に，マージ先チャンクの表データに定義されているインデクスを再作成します。そのあとで，マージ元チャンクを削除します。このことで，複数のチャンクで管理していた表データおよびインデクスを，1つのチャンクで管理できるようになります。

重要

状態が異なるチャンク（通常状態のチャンクと待機状態のチャンク）をマージすることはできません。

メモ

チャンク数が増加すると，B-treeインデクスまたはテキストインデクスを使用した検索時に性能が低下するおそれがあります。チャンクをマージしてチャンク数を減らすと，検索性能の低下を回避できます。

35.1.2　adbmergechunkコマンドが使用するスレッドの関係

adbmergechunkコマンドは，次の処理で処理リアルスレッドを使用します。

表データのマージ・検索，およびレンジインデクスの作成

この処理では，「1～（ ↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，マージチャンクオプションadb_mergechunk_rthd_numの指定値またはデフォルト値となります。マージチャンクオプションadb_mergechunk_rthd_numのデフォルト値については，「35.2.2　マージチャンクオプションの形式」の「(2)　指定形式の説明」にある，マージチャンクオプションadb_mergechunk_rthd_numを参照してください。

作業用一時ファイルの作成

この処理では，「1～（ ↓（MAX_RTHD_NUM－1）÷2↓ ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスのレコードのソート

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスの作成

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

マージ元チャンクの削除

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1と処理2は同時に実行されます。そのあとに，処理3～処理5が順に実行されます。処理6は，処理1～処理5の実行中，常に実行されます。

メモ

--concurrency-priorオプションを指定した場合は，処理1～処理3の実行順序が上記と変わりますが，各処理で使用するスレッド数は同じです。

adbmergechunkコマンドが処理リアルスレッドを使用する処理を，次の2つの図に示します。上記の番号は，図中の番号に対応しています。

図35‒2　adbmergechunkコマンドが処理リアルスレッドを使用する処理（その1）

図35‒3　adbmergechunkコマンドが処理リアルスレッドを使用する処理（その2）

35.2　adbmergechunkコマンドの指定形式

adbmergechunkコマンドの指定形式，およびマージチャンクオプションの形式について説明します。

adbmergechunkコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

35.2.1　指定形式およびオプションの説明

(1)　指定形式

adbmergechunk
  -u 認可識別子
  〔-p パスワード〕
  〔-g マージチャンク処理の経過メッセージ出力間隔〕
  〔-w ｛作業用一時ファイルの格納先ディレクトリ名
       ｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕
  〔-z マージチャンクオプションファイル名〕
  〔-m チャンクに設定するコメント〕
  〔--purge-chunk ｛WAIT｜NOWAIT｝〕
  〔--timeout タイムアウト時間〕
  〔--concurrency-prior〕
  -c ｛マージ元チャンクID指定〔,マージ元チャンクID指定〕…｜ALL｝
  処理対象表

重要

処理対象表は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbmergechunkコマンドを実行するHADBユーザの認可識別子を指定します。adbmergechunkコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するMERGE CHUNK権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbmergechunkコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-g マージチャンク処理の経過メッセージ出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

マージチャンク処理の経過メッセージの出力間隔を指定します。このオプションを指定すると，マージチャンク処理の処理経過として，インデクス再作成中の表データの検索行数が出力されます。

例えば，このオプションに2を指定すると，インデクスの再作成時に表データが2,000行検索されるごとに，経過メッセージ（KFAA80205-I）が出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝

〜〈OSパス名〉((2〜518バイト))

マージチャンク処理時に作成される作業用一時ファイルの格納先を，次に示すどちらかの方法で指定します。

作業用一時ファイルを格納するディレクトリ名を絶対パス名で指定する

作業用一時ファイルを格納するディレクトリを指定したファイル名（ディレクトリパスファイル名）を絶対パス名で指定する

1つのディレクトリ下に格納される作業用一時ファイルに対して入出力が集中すると，性能低下の原因になります。そのため，2の方法で作業用一時ファイルを異なるディスクのディレクトリに格納して，ディスクに対する入出力処理の負荷を分散することを推奨します。2の方法の指定例（ディレクトリパスファイルの指定例）を次に示します。

ディレクトリパスファイルの指定例

/mnt/diska/wwwww
/mnt/diskb/xxxxx
/mnt/diskc/yyyyy
/mnt/diskd/zzzzz

指定するディレクトリ数の目安を次に示します。

指定するディレクトリ数の目安＝A×B

A：最大検索処理スレッド数

次の計算式で求めてください。

↓（マージチャンクオプションadb_mergechunk_rthd_numの値－1）÷2↓

B：処理対象表に定義されているB-treeインデクスおよびテキストインデクスの数

B-treeインデクスおよびテキストインデクスの数がわからない場合は，次に示すSQL文で表に定義されているB-treeインデクスおよびテキストインデクスの数を確認してください。

SELECT "N_INDEX"-"N_RANGE_INDEX"
    FROM "MASTER"."SQL_TABLES"
        WHERE "TABLE_SCHEMA"='認可識別子'
           AND "TABLE_NAME"='処理対象表の表名'

ディレクトリパスファイル中にディレクトリを255個まで指定できます。

ディレクトリパスファイル中に記述されている順番に，作業用一時ファイルの格納先ディレクトリとして使用されます。ディレクトリパスファイル中に記述された最後のディレクトリ（この例では/mnt/diskd/zzzzz）が使用された場合，次に使用されるディレクトリは先頭のディレクトリ（この例では/mnt/diska/wwwww）になります。

このオプションの指定規則（方法1，2の両方の指定規則）を次に示します。

パス名の末尾にスラッシュ（/）を指定しないでください。

-wオプションに指定したディレクトリ下に作成される作業用一時ファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンド実行時の作業用一時ファイルの容量見積もりのadbmergechunkコマンド実行時の作業用一時ファイルの容量見積もりを参照してください。なお，このオプションを省略した場合，$DBDIR/ADBWORK下に作業用一時ファイルが作成されます。

作業用一時ファイルを格納するディレクトリは，専用のディレクトリにしてください。ほかのファイルを格納しているディレクトリと重複した場合，既存のファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。作業用一時ファイルの格納先ディレクトリ名と重複しないようにする必要があるファイルについては，「35.6　注意事項」を参照してください。

なお，作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

メモ

作業用一時ファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●-z マージチャンクオプションファイル名

〜〈OSパス名〉((2〜510バイト))

マージチャンクオプションを指定したマージチャンクオプションファイルの絶対パス名を指定します。このオプションを省略すると，マージチャンクオプションファイルが指定されないため，すべてのマージチャンクオプションにデフォルト値が仮定されます。

マージチャンクオプションについては，「35.2.2　マージチャンクオプションの形式」を参照してください。

なお，マージチャンクオプションファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。マージチャンクオプションファイル名と重複しないようにする必要があるファイルについては，「35.6　注意事項」を参照してください。

●-m チャンクに設定するコメント

〜〈文字列〉((1〜1,024バイト))

マージ先チャンクにコメントを設定したい場合に指定します。

指定時の規則を次に示します。

指定したコメントは，英大文字と英小文字が区別されます。

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含むコメントを設定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，コメント全体をアポストロフィ（'）で囲んでください。

（例1）-m abc¥|def

（例2）-m 'abc|def'

どちらの場合も，コメントとしてabc|defが設定されます。

文字列を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）および文字列がコメントとして扱われます。

（例）-m '"abcdef"'

この場合，コメントとして"abcdef"が設定されます。

コメントの文字コードは，HADBサーバの環境変数のADBLANGに設定した文字コードと同じになります。

●--purge-chunk ｛WAIT｜NOWAIT｝

マージ先チャンクが作成されたあとにマージ元チャンクを削除する際，ほかのSQL文やコマンドによるマージチャンク対象表を参照する処理が存在する場合に，マージ元チャンクを削除するかどうかを指定します。

WAITを指定，またはオプションを省略した場合

ほかのSQL文やコマンドによるマージチャンク対象表を参照する処理がすべて完了するまで，マージ元チャンクの削除処理を待ちます。マージチャンク対象表を参照する処理が存在しなくなったあとで，マージ元チャンクの削除処理を開始します。マージ元チャンクの削除後に，adbmergechunkコマンドは終了します。

NOWAITを指定した場合

マージ元チャンクの削除処理をスキップします。そのため，削除仕掛中の状態でマージ元チャンクが残ったまま，adbmergechunkコマンドは終了します。

この場合，手動でマージ元チャンクを削除する必要があります。削除対象のチャンクIDを，表示されるKFAA96785-Eメッセージで確認し，PURGE CHUNK文を実行してください。マージ元チャンクを削除しないと，次回adbmergechunkコマンドを実行できません。

なお，ほかのSQL文やコマンドによるマージチャンク対象表を参照する処理が存在しない場合は，--purge-chunkオプションの指定に関係なく，マージ先チャンクが作成されたあとにマージ元チャンクは削除されます。

--purge-chunkオプションの指定時の考慮点については，マニュアルHADB　システム構築・運用ガイドのチャンクをマージする方法（チャンク数を減らす方法）のadbmergechunkコマンドの--purge-chunkオプション指定時の考慮点を参照してください。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《0》（単位：秒）

adbmergechunkコマンドがタイムアウトになるまでの時間を指定します。

adbmergechunkコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbmergechunkコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，またはこのオプションに0を指定した場合，adbmergechunkコマンドのタイムアウト時間は設定されません。adbmergechunkコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbmergechunkコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbmergechunkコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbmergechunkコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

ワーカーノードの追加処理中

他ノードで実行中のトランザクションの終了待ち中

●--concurrency-prior

adbmergechunkコマンドの同時実行性を向上したい場合にこのオプションを指定します。SQL文や次に示すコマンドと，adbmergechunkコマンドを同時に実行したい場合は，このオプションを指定してください。

adbimportコマンド（バックグラウンドインポートの場合）

adbgetcstコマンド

adbchgchunkcommentコマンド

adbdbstatusコマンド

このオプションを指定する場合と指定しない場合で，確保される排他資源と排他制御モードが異なります。詳細については，マニュアルHADB　システム構築・運用ガイドの確保される排他資源と排他制御モードを参照してください。

重要

処理対象表にアーカイブマルチチャンク表を指定した場合，--concurrency-priorオプションは指定できません。

メモ

adbmergechunkコマンド（--concurrency-priorオプションの指定あり）と，次に示すコマンドやSQL文を同時に実行した場合，次に示すコマンドやSQL文が先に実行され，その結果，adbmergechunkコマンドの処理時間が長くなるおそれがあります。

adbimportコマンド

adbidxrebuildコマンド

adbmergechunkコマンド（--concurrency-priorオプションの指定なし）

INSERT文

DELETE文

UPDATE文

PURGE CHUNK文

TRUNCATE TABLE文

なお，上記のコマンドやSQL文が先に実行された場合，KFAA52204-Iメッセージが出力されます。

adbimportコマンドまたはadbidxrebuildコマンドが正常終了していない表に対して，adbmergechunkコマンドを実行すると，adbmergechunkコマンドがエラーになり，KFAA50201-Eメッセージが出力されます。ただし，--concurrency-priorオプションを指定していると，adbmergechunkコマンドがエラーになり，KFAA50201-Eメッセージが出力されるまでに時間が掛かるおそれがあります。

上記の状況を回避するには，--concurrency-priorオプションを指定しないでadbmergechunkコマンドを実行してください。

●-c ｛マージ元チャンクID指定〔,マージ元チャンクID指定〕…｜ALL｝

〜〈整数〉((1〜9,223,372,036,854,775,807))

マージチャンク処理の対象となる，マージ元チャンクを指定します。

ALLを指定した場合，処理対象表のすべてのチャンクを1つの新規チャンクにマージします。マージ元チャンクID指定を指定した場合，指定したIDのチャンクを1つの新規チャンクにマージします。

重要

状態が異なるチャンク（通常状態のチャンクと待機状態のチャンク）をマージすることはできません。

マージ元チャンクID指定を指定する場合，2つ以上のチャンクIDを指定する必要があります。マージ元チャンクID指定では，次に示す2種類の方法を混在させて指定できます。

図35‒4　-cオプションのマージ元チャンクID指定の例

チャンクIDを1つずつ指定する（単独指定）

マージ元チャンクのチャンクIDを1つずつ指定したい場合は，チャンクIDをコンマ（,）で区切って指定します。

重要

チャンクIDとコンマ（,）の間には空白を入れないでください。

チャンクIDの範囲を指定する（範囲指定）

マージ元チャンクのチャンクIDの範囲を指定したい場合は，「範囲の最小のチャンクID-範囲の最大のチャンクID」の形式で指定します（2つのチャンクIDをハイフン（-）でつなぎます）。

重要

ハイフン（-）とチャンクIDの間には空白を入れないでください。また，ハイフンの右側には，ハイフンの左側のチャンクIDより大きいチャンクIDを指定してください。

このオプションの指定時の規則を次に示します。

ALLとマージ元チャンクID指定を同時に指定しないでください。

処理対象表に存在しないチャンクIDが含まれる場合は，そのチャンクIDの指定を無視して，ほかの存在するチャンクIDをマージします。

チャンクIDは，最大30,000個指定できます。チャンクIDの数え方を次に示します。

・範囲指定の場合，範囲内のすべてのチャンクIDが個数に数えられます。

・指定したチャンクIDが重複している場合，重複した分も個数に数えられます。

マージ元チャンクID指定の例と数え方

（例1）-c 1,3,5：3個のチャンクID（1，3および5）を指定したと見なされます。

（例2）-c 1,3,5-8,10：7個のチャンクID（1，3，5，6，7，8および10）を指定したと見なされます。

（例3）-c 1,3,5,5-8,10：8個のチャンクID（1，3，5，5，6，7，8および10）を指定したと見なされます。

-cオプションに指定できる値の長さの上限は32キロバイトです。このため，マージ元チャンクID指定の長さが32キロバイトを超える場合は，範囲指定に変更するか，または複数回に分けて，adbmergechunkコマンドを実行してください。

エラーとなる指定内容および指定例については，「(3)　-cオプションの指定が原因のエラー」を参照してください。

処理対象表に存在するチャンクIDを検索する方法を次に示します。

システム表のSTATUS_CHUNKSを検索する

システム表のSTATUS_CHUNKSを検索し，チャンクIDを確認してください。詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表のシステム表の検索の表名から表内の全チャンクの情報を調べる場合を参照してください。

adbdbstatusコマンドを実行する

次に示すコマンドを実行してDBエリア，表とインデクスの使用量情報を出力し，チャンクID（Chunk_ID）を確認してください（結果はCSV形式で出力されます）。DBエリア，表とインデクスの使用量情報で出力される項目の詳細については，「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」を参照してください。

adbdbstatus -d used -c table -n 処理対象表の表名

処理対象表の表名は「スキーマ名.表識別子」の形式で指定してください。

●処理対象表

マージチャンク処理の対象となるマルチチャンク表を指定します。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

MERGE CHUNK権限を持っている表を指定できます。

マルチチャンク表以外の表は指定できません。

ビュー表は指定できません。

(3)　-cオプションの指定が原因のエラー

-cオプションの指定が原因でadbmergechunkコマンドがエラーとなる場合には，次の2つが考えられます。

-cオプションの指定形式に誤りがある場合

-cオプションに不正なチャンクIDを指定している場合

どちらの場合も，指定を修正したあと，再度adbmergechunkコマンドを実行してください。なお，-cオプションの詳細については，「(2)　オプションの説明」の「-c」を参照してください。

(a)　-cオプションの指定形式に誤りがある場合

-cオプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbmergechunkコマンドを実行してください。

表35‒1　-cオプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定したチャンクIDの個数が30,000個を超えている

-c 1-30001

-c 1-30000

2

ALLとマージ元チャンクID指定を同時に指定している

-c 1,3,ALL,10

-c ALL

-c 1,3,10

3

ハイフン（-）の両側に同じチャンクIDを指定している

-c 3-3,7

-c 3-5,7

4

ハイフン（-）の右側に，左側のチャンクIDより小さいチャンクIDを指定している

-c 10-3

-c 3-10

5

KFAA50296-E

チャンクIDを1つしか指定していない（1つのチャンクIDだけを重複して指定している場合も含む）

-c 3

-c 3,3,3

-c 3,4

6

KFAA90002-E

KFAA96780-I

チャンクIDとコンマの間に空白がある

-c 1,3,△10

-c 1,3,10

7

チャンクIDとハイフン（-）の間に空白がある

-c 1,3△-△10

-c 1,3-10

8

KFAA90003-E

指定値の長さが32キロバイトを超えている

-c 1-xxxxx

単独指定ではなく，範囲指定に変更する（コンマ（,）ではなくハイフン（-）を使用する）

（凡例）

△：空白

(b)　-cオプションに不正なチャンクIDを指定している場合

-cオプションに不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。これらの誤りを修正したあと，再度adbmergechunkコマンドを実行してください。

表35‒2　不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例および対処方法

1

KFAA50294-E

処理対象表に存在するチャンクIDの範囲（最小のチャンクID〜最大のチャンクID）外のチャンクIDを指定している

処理対象表に存在するチャンクIDが3および6の場合

-c 2-6

-c 6,7

-c 2-7

処理対象表に存在するチャンクIDが3および6の場合

-c 3,6

-c 3-6

処理対象表に存在するチャンクIDを検索して，処理対象表に存在する範囲内のチャンクIDを指定してください。

2

KFAA50296-E

処理対象表に存在しないチャンクIDを指定しているため，マージ元チャンクが複数にならない

処理対象表に存在するチャンクIDが3および6の場合

-c 3-5

-c 4,5

処理対象表に存在するチャンクIDが3および6の場合

-c 3,6

-c 3-6

処理対象表に存在するチャンクIDを検索して，マージ元チャンクが複数になるように指定を修正してください。

3

KFAA50299-E

マージ元チャンクに，通常状態のチャンクと待機状態のチャンクが混在している

通常状態のチャンクIDが1〜2で，待機状態のチャンクが3〜4の場合

-c 1,3

-c 1-3

通常状態のチャンクIDが1〜2で，待機状態のチャンクが3〜4の場合

-c 1,2

-c 3-4

マージ元チャンクは通常状態のチャンクだけにするか，または待機状態のチャンクだけになるように指定を修正してください。

4

マージ元チャンクに，アーカイブ状態のチャンクとアーカイブ状態ではないチャンクが混在している

アーカイブ状態のチャンクのチャンクIDが1〜2で，アーカイブ状態ではないチャンクのチャンクIDが3〜4の場合

-c 1,3

-c 1-3

アーカイブ状態のチャンクのチャンクIDが1〜2で，アーカイブ状態ではないチャンクのチャンクIDが3〜4の場合

-c 1,2

-c 3-4

マージ元チャンクをアーカイブ状態のチャンクだけにするか，またはアーカイブ状態ではないチャンクだけになるように指定を修正してください。

注

処理対象表に存在するチャンクIDを検索する方法については，「(2)　オプションの説明」の「-c」を参照してください。

35.2.2　マージチャンクオプションの形式

(1)　指定形式

〔set adb_mergechunk_rthd_num = adbmergechunkコマンドが使用する処理リアルスレッド数〕
〔set adb_mergechunk_scan_buff_size = 表データの検索バッファサイズ〕
〔set adb_mergechunk_buff_blk_num = マージチャンク用バッファブロック数〕
〔set adb_mergechunk_sort_buff_size = ソートバッファサイズ〕
〔set adb_mergechunk_dvix_rdbuff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ〕
〔set adb_mergechunk_dvix_wtbuff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ〕
〔set adb_mergechunk_txt_buff_size = テキストインデクスの作成用バッファサイズ〕
〔set adb_mergechunk_dvbix_rthd_use = ｛FIXED｜VARIABLE｝〕

上記のマージチャンクオプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_mergechunk_rthd_num = adbmergechunkコマンドが使用する処理リアルスレッド数

〜〈整数〉((3〜4,096))

adbmergechunkコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbmergechunkコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbmergechunkコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbmergechunkコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「35.1.2　adbmergechunkコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbmergechunkコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表35‒3　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0～2の値を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに3以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに3以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbmergechunkコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_mergechunk_scan_buff_size = 表データの検索バッファサイズ

〜〈整数〉((1〜2,048))《8》（単位：メガバイト）

表データの検索結果を保持するバッファのサイズをメガバイト単位で指定します。指定値を大きくすると，表データを検索する際のオーバヘッドを削減できます。

次に示す計算式で求めた値を指定値の目安としてください。

計算式

処理対象表に定義されているB-treeインデクスのキー長×100,000

B-treeインデクスのキー長の求め方については，マニュアルHADB　システム構築・運用ガイドのデータベースの設計のデータ用DBエリアの容量見積もりのB-treeインデクスのキー長（KEYSZ）の求め方を参照してください。

●adb_mergechunk_buff_blk_num = マージチャンク用バッファブロック数

〜〈整数〉((5〜4,096))《64》

マージチャンク処理で使用するバッファのブロック数を指定します。既定値のままで問題ありません。指定値を大きくするとマージチャンク処理の速度が向上することがあります。

●adb_mergechunk_sort_buff_size = ソートバッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用するソートバッファのサイズをメガバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_mergechunk_dvix_rdbuff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する入力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_mergechunk_dvix_wtbuff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する出力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_mergechunk_txt_buff_size = テキストインデクスの作成用バッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

処理対象表にテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，テキストインデクスの作成処理時に使用するバッファサイズをメガバイト単位で指定します。

このオプションの指定値を大きくすると性能向上が見込めます。ただし，テキストインデクスを作成する全処理リアルスレッドで，このオプションで指定したバッファ分のメモリを使用します。このため，このオプションの指定値を大きくするときは注意してください。

●adb_mergechunk_dvbix_rthd_use = ｛FIXED｜VARIABLE｝

〜《サーバ定義adb_cmd_dvbix_rthd_useオペランドの値》

処理対象表にB-treeインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスを作成する際，B-treeインデクス作成用スレッド数の調整機能を有効にするかどうかを指定します。B-treeインデクス作成用スレッド数の調整機能については，「17.1.2　adbimportコマンドのオプション機能」の「(4)　B-treeインデクス作成用スレッド数の調整機能」を参照してください。

FIXED：B-treeインデクス作成用スレッド数の調整機能を有効にしません。

B-treeインデクスの作成処理は，使用可能な処理リアルスレッドを最大限に使用して，並列に処理されます。B-treeインデクスのデータの格納効率よりも，B-treeインデクスの作成処理時間の短縮を優先する場合に指定してください。

使用される処理リアルスレッド数は，「adb_mergechunk_rthd_numオプションの指定値※ - 1」になります。

注※

adb_mergechunk_rthd_numオプションの指定を省略した場合は，「表35‒3　コマンド実行時に使用する処理リアルスレッド数」に従ってadb_mergechunk_rthd_numオプションの値が決まります。

VARIABLE：B-treeインデクス作成用スレッド数の調整機能を有効にします。

B-treeインデクスの作成処理は，データのサイズや件数などに応じて，使用される処理リアルスレッド数を変更して処理されます。B-treeインデクスの作成処理時間の短縮よりも，B-treeインデクスのデータの格納効率を優先する場合に指定してください。

使用される処理リアルスレッド数は，「1」または「このオプションにFIXEDを指定したときに使用される処理リアルスレッド数」のどちらかになります。

35.3　使用例

adbmergechunkコマンドを使用して複数のチャンクをマージする方法を，例題形式で説明します。

実行中にadbmergechunkコマンドが異常終了した場合は，「35.5　adbmergechunkコマンドが異常終了したときの対処方法」を参照して対処してください。

35.3.1　表にあるすべてのチャンクをマージする場合

次に示す条件で，表TABLE01に存在するすべてのチャンクを，新しいチャンクにマージします。

表TABLE01の定義時にCHUNKを指定している（表TABLE01はマルチチャンク表である）

表TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

表TABLE01に対して，バックグラウンドインポート機能を2回適用してデータをインポートした

表TABLE01には，チャンクIDが1，2および3のチャンクが存在する

表TABLE01のカレントチャンクのチャンクIDは3

このとき，次に示す手順でadbmergechunkコマンドを実行します。

手順

マージチャンクオプションファイルを作成する

adbmergechunkコマンドを実行する

各手順の例を以降で説明します。

(1)　マージチャンクオプションファイルを作成する

マージチャンクオプションファイルを作成して，マージチャンクオプションを指定します。

マージチャンクオプションファイルの指定例

set adb_mergechunk_rthd_num = 3
set adb_mergechunk_scan_buff_size = 2
      ：

(2)　adbmergechunkコマンドを実行する

adbmergechunk -u ADBUSER01                                       ...1
              -p '#HelloHADB_01'                                 ...2
              -z /home/adbmanager/merge_file/mergechunk_opt.txt  ...3
              -m 'January 2014'                                  ...4
              -c ALL                                             ...5
              TABLE01                                            ...6

［説明］

adbmergechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　マージチャンクオプションファイルを作成する」で作成したマージチャンクオプションファイルの絶対パス名を指定します。

マージ先チャンクに設定するコメントを指定します。

処理対象表（TABLE01）にあるすべてのチャンクをマージするため，-cオプションにALLを指定します。

この例の場合，チャンクIDが1，2および3のチャンクをマージします。adbmergechunkコマンド実行後のカレントチャンクは，マージ先チャンクになります。

処理対象表（TABLE01）を指定します。

35.3.2　任意のチャンク（カレントチャンクを含まない）をマージする場合

次に示す条件で，カレントチャンク以外の任意のチャンクを，新しいチャンクにマージします。

表TABLE01の定義時にCHUNKを指定している（表TABLE01はマルチチャンク表である）

表TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

表TABLE01に対して，バックグラウンドインポート機能を2回適用してデータをインポートした

表TABLE01には，チャンクIDが1，2および3のチャンクが存在する

表TABLE01のカレントチャンクのチャンクIDは3

このとき，次に示す手順でadbmergechunkコマンドを実行します。

手順

マージチャンクオプションファイルを作成する

adbmergechunkコマンドを実行する

各手順の例を以降で説明します。

(1)　マージチャンクオプションファイルを作成する

マージチャンクオプションファイルを作成して，マージチャンクオプションを指定します。

マージチャンクオプションファイルの指定例

set adb_mergechunk_rthd_num = 3
set adb_mergechunk_scan_buff_size = 2
      ：

(2)　adbmergechunkコマンドを実行する

adbmergechunk -u ADBUSER01                                       ...1
              -p '#HelloHADB_01'                                 ...2
              -z /home/adbmanager/merge_file/mergechunk_opt.txt  ...3
              -m 'January 2014'                                  ...4
              -c 1,2                                             ...5
              TABLE01                                            ...6

［説明］

adbmergechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　マージチャンクオプションファイルを作成する」で作成したマージチャンクオプションファイルの絶対パス名を指定します。

マージ先チャンクに設定するコメントを指定します。

マージ元チャンクIDを指定します。

この例の場合，チャンクIDが1および2のチャンクをマージします。adbmergechunkコマンド実行後のカレントチャンクは，チャンクIDが3のチャンクのままです。

処理対象表（TABLE01）を指定します。

35.3.3　任意のチャンク（カレントチャンクを含む）をマージする場合

次に示す条件で，カレントチャンクを含む任意のチャンクを，新しいチャンクにマージします。

表TABLE01の定義時にCHUNKを指定している（表TABLE01はマルチチャンク表である）

表TABLE01にはB-treeインデクス，テキストインデクス，およびレンジインデクスが定義されている

表TABLE01に対して，バックグラウンドインポート機能を2回適用してデータをインポートした

表TABLE01には，チャンクIDが1，2および3のチャンクが存在する

表TABLE01のカレントチャンクのチャンクIDは3

このとき，次に示す手順でadbmergechunkコマンドを実行します。

手順

マージチャンクオプションファイルを作成する

adbmergechunkコマンドを実行する

各手順の例を以降で説明します。

(1)　マージチャンクオプションファイルを作成する

マージチャンクオプションファイルを作成して，マージチャンクオプションを指定します。

マージチャンクオプションファイルの指定例

set adb_mergechunk_rthd_num = 3
set adb_mergechunk_scan_buff_size = 2
      ：

(2)　adbmergechunkコマンドを実行する

adbmergechunk -u ADBUSER01                                       ...1
              -p '#HelloHADB_01'                                 ...2
              -z /home/adbmanager/merge_file/mergechunk_opt.txt  ...3
              -m 'January 2014'                                  ...4
              -c 2,3                                             ...5
              TABLE01                                            ...6

［説明］

adbmergechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　マージチャンクオプションファイルを作成する」で作成したマージチャンクオプションファイルの絶対パス名を指定します。

マージ先チャンクに設定するコメントを指定します。

マージ元チャンクIDを指定します。

この例の場合，チャンクIDが2および3のチャンクをマージします。adbmergechunkコマンド実行後のカレントチャンクは，マージ先チャンクになります。

処理対象表（TABLE01）を指定します。

35.4　リターンコード

adbmergechunkコマンドのリターンコードを次の表に示します。

表35‒4　adbmergechunkコマンドのリターンコード

リターンコード

意味

0

処理が正常に終了しました。

4

処理は正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，そのメッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbmergechunkコマンドの指定に誤りがあり，adbmergechunkコマンドが実行されませんでした。

adbmergechunkコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。詳細については，「35.5　adbmergechunkコマンドが異常終了したときの対処方法」を参照してください。

16

adbmergechunkコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbmergechunkコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，KFAA80204-Iメッセージに出力されるリターンコード（0，4，8または20）を参照してください。ただし，adbmergechunkコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合は，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbmergechunkコマンドを再実行してください。

20

処理は正常に終了しましたが，マージ元チャンクが削除できませんでした。

そのため，マージ元チャンクの状態は，削除仕掛中になっています。PURGE CHUNK文で，削除仕掛中のチャンクをすべて削除してください。削除仕掛中のチャンクは，表示されたメッセージ，またはKFAA96785-Eメッセージを参照してください。

35.5　adbmergechunkコマンドが異常終了したときの対処方法

adbmergechunkコマンドが異常終了したときの対処方法について説明します。

35.5.1　最初に確認すること

次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されている場合は，コマンドのオプションや，マージチャンクオプションの指定に誤りがあります。コマンドのオプションまたはマージチャンクオプションを修正したあとに，adbmergechunkコマンドを再実行してください。

なお，-cオプションの指定の誤りについては，「35.2.1　指定形式およびオプションの説明」の「(3)　-cオプションの指定が原因のエラー」を参照してください。

これらのメッセージが出力されていない場合は，「35.5.2　障害原因の特定と対処」に進んでください。

35.5.2　障害原因の特定と対処

KFAA80242-Iメッセージ（Purge-chunk processing start.）が出力されているかどうかによって，チャンクの状態および対処方法が異なります。

中断タイミングごとのチャンクの状態および対処方法を次の表に示します。

表35‒5　adbmergechunkコマンドの中断タイミングによるチャンクの状態および対処方法

中断のタイミング※1

チャンクの状態

対処方法

チャンクのマージ中

マージ元チャンクの状態

adbmergechunkコマンド実行前の状態になります。

マージ先チャンクの状態

存在しません（adbmergechunkコマンド実行前の状態です）。

「(1)　チャンクのマージ中に中断した場合」を参照してください。

マージ元チャンクの削除中※2

マージ元チャンクの状態

削除仕掛中です。

adbexportコマンド，またはadbsqlサブコマンドの#GETDATAで，削除仕掛中のチャンクIDを指定した場合，出力結果は0件となります。また，adbsqlサブコマンドの#GETCOUNTで，削除仕掛中のチャンクIDを指定した場合，0件のデータが集計対象となるため，出力結果は0件となります。

削除仕掛中のチャンクを含む表に対して，adbmergechunkコマンドは実行できません。

削除仕掛中のチャンクを含む表に対して，バックグラウンドインポートは実行できます。ただし，チャンク数が上限に達しているときは，実行できません。

マージ先チャンクの状態

マージ処理が完了しています。

「(2)　マージ元チャンクの削除中に中断した場合」を参照してください。

注※1

中断のタイミングは，次に示すように出力されたメッセージで確認できます。

注※2

リターンコードが0または4のKFAA80243-Iメッセージ（Purge-chunk processing ended.）が出力されている場合，マージチャンク処理はすべて完了しています。この場合，対処は不要です。

(1)　チャンクのマージ中に中断した場合

KFAA80242-Iメッセージ（Purge-chunk processing start.）が出力されていない場合の対処手順を次に示します。

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

adbmergechunkコマンドを再実行してください。

(2)　マージ元チャンクの削除中に中断した場合

KFAA80242-Iメッセージ（Purge-chunk processing start.）が出力されている場合は，削除仕掛中のチャンクを削除する必要があります。対処手順を次に示します。

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

必要に応じて，削除仕掛中のチャンクを確認してください。

この操作は必須ではありません。削除仕掛中のチャンクを確認したい場合に限り実行してください。確認方法については，下記のメモを参照してください。

「削除仕掛中」のチャンクをPURGE CHUNK文で一括して削除してください。

PURGE CHUNK文の指定例

PURGE CHUNK "スキーマ名"."表識別子"
        WHERE CHUNKID=ANY(
                          SELECT "CHUNK_ID"
                            FROM "MASTER"."STATUS_CHUNKS"
                              WHERE "TABLE_SCHEMA" = 'スキーマ名'
                                AND "TABLE_NAME" = '表識別子'
                                AND "CHUNK_STATUS" = 'Pending Delete')

スキーマ名には，adbmergechunkコマンドを実行した表の所有者のスキーマ名を指定します。表識別子には，表の表識別子を指定します。

メモ

adbdbstatusコマンドのDBエリア，表とインデクスの使用量情報で，削除仕掛中のチャンクを確認できます。

adbdbstatusコマンドの実行例

adbdbstatus -d used -c table -n adbmergechunkコマンドが中断した表名

adbmergechunkコマンドが中断した表名は，「スキーマ名.表識別子」の形式で指定します。

コマンドを実行したあと，出力結果（DBエリア，表とインデクスの使用量情報）の2行目以降を確認してください（出力結果の1行目は列のタイトルです）。

Chunk_status列（18列目）の値がPending_deleteになっている行がある場合は，マージ元チャンクが削除されていません。削除仕掛中のチャンクがあります。

（例）

Chunk_status列（18列目）にPending_deleteが出力されていない場合は，マージチャンク処理が完了しています（マージ元チャンクの削除が完了しています）。

（例）

35.6　注意事項

adbmergechunkコマンドは，格納済みの表データの検索にSQL文を使用します。そのため，SQL文の非順序実行方式が適用される環境での実行を推奨します。非順序実行方式が適用される環境については，マニュアルHADB　システム構築・運用ガイドのデータベースの検索処理方式（非順序実行方式）を参照してください。

adbmergechunkコマンドのオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

adbmergechunkコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。adbcancelコマンド以外を使用するときは，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。また，adbmergechunkコマンドを中断したあとは，「35.5　adbmergechunkコマンドが異常終了したときの対処方法」を参照して，必要に応じて対処してください。

実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

マージチャンク処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbmergechunkコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のマージチャンク処理は中断されません（処理が続行されます）。マージチャンク処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

マージチャンク処理中に作業用のファイル（作業用一時ファイル）が一時的に作成されます。作業用一時ファイルは，adbmergechunkコマンドが正常に終了（リターンコードが0または4の場合）した場合は自動的に削除されますが，adbmergechunkコマンドが正常に終了しなかった場合は削除されないことがあります。

作業用一時ファイルの中には，ほかのコマンドを再実行する際に必要となるファイルが含まれています。そのため，ほかのコマンドを再実行する前に作業用一時ファイルを削除しないでください。削除すると，ほかのコマンドが正しく実行されません。

作業用一時ファイルがディスク容量を圧迫するおそれがあるため，ほかのコマンドを再実行する必要がない場合は，作業用一時ファイルを定期的に削除することを推奨します。

この場合は，次に示すディレクトリ下に作業用一時ファイルが残っていないかを定期的に確認し，ファイルがあるときは削除してください。

$DBDIR/ADBSYS/ADBUTL

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ（-wオプションを省略した場合は$DBDIR/ADBWORK）

adbmergechunkコマンドは，次に示す表に対して実行できません。

未完状態のインデクスが定義されている表

更新不可状態の表

adbimportコマンドまたはadbidxrebuildコマンドの実行が中断している表

adbmergechunkコマンドのオプションに指定する次のディレクトリおよびファイルの絶対パスが重複しないようにしてください。該当するディレクトリおよびファイルを次に示します。

作業用一時ファイルの格納先ディレクトリ（-wオプションで指定，または-wオプションに指定したディレクトリパスファイルに指定）

作業用一時ファイルの格納先を指定したディレクトリパスファイル（-wオプションで指定）

マージチャンクオプションファイル（-zオプションで指定）

また，上記のディレクトリおよびファイルの絶対パスは，adbmergechunkコマンド以外のプログラムが使用しているディレクトリおよびファイルの絶対パスとも重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。

コマンドまたはAPの実行中にadbmergechunkコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbmergechunkコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

このコマンドの実行時間を短縮したい場合は，マニュアルHADB　システム構築・運用ガイドのチューニングのコマンドの実行時間の短縮に関するチューニングのadbmergechunkコマンドの実行時間の短縮を参照してください。

adbmergechunkコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbmergechunkコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表35‒6　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

作業用一時ファイルの格納先ディレクトリ※2

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

作業用一時ファイルの格納先を指定したディレクトリパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

マージチャンクオプションファイル

コマンドの実行ユーザ

読み取り権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

-wオプションに指定する場合と，作業用一時ファイルの格納先を指定したディレクトリパスファイル内に指定する場合のどちらも該当します。

36　adbmkdmk（HADB暗号鍵の作成）

この章では，adbmkdmkコマンドの機能と使い方について説明します。

36.1　機能

adbmkdmkコマンドは，DBエリア暗号化機能で使用するHADB暗号鍵を作成し，HADB暗号鍵ファイルに出力します。

DBエリア暗号化機能については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を参照してください。

adbmkdmkコマンドは，コマンド実行時にHADBサーバに接続します。

36.2　adbmkdmkコマンドの指定形式

adbmkdmkコマンドの指定形式およびオプションについて説明します。

adbmkdmkコマンドを実行できるOSユーザは，HADB管理者だけです。

36.2.1　指定形式およびオプションの説明

(1)　指定形式

adbmkdmk
    -u 認可識別子
  〔-p パスワード〕
    HADB暗号鍵の出力先ファイル名※

注※

HADB暗号鍵の出力先ファイル名は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbmkdmkコマンドを実行するHADBユーザの認可識別子を指定します。adbmkdmkコマンドを実行するには，次の2つの権限を持っている必要があります。

暗号管理権限

CONNECT権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbmkdmkコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

● HADB暗号鍵の出力先ファイル名

〜〈OSパス名〉((2〜510バイト))

DBエリア暗号化機能で使用するHADB暗号鍵の出力先ファイルの絶対パス名を指定します。

存在しているHADB暗号鍵ファイルを上書きすることはできません。指定したHADB暗号鍵の出力先ファイル名と同じ名前のファイルが存在する場合，adbmkdmkコマンドはエラーとなります（KFAA51424-Eメッセージが出力されます）。

36.3　使用例

DBエリア暗号化機能で使用するHADB暗号鍵を作成する方法を説明します。

adbmkdmkコマンドを実行する

実行例

adbmkdmk -u CADMIN                    ...a
         -p '#HelloCADMIN_00'         ...b
         /HADB/.crypto/adb_dmkey      ...c

［説明］

adbmkdmkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

作成するHADB暗号鍵の出力先ファイルの絶対パス名を指定します。

HADB暗号鍵利用パスワードを設定する

作成するHADB暗号鍵のHADB暗号鍵利用パスワードの設定を求めるKFAA90013-Qメッセージが出力されます。標準入力からHADB暗号鍵利用パスワードを設定してください。

36.4　リターンコード

adbmkdmkコマンドのリターンコードを次の表に示します。

表36‒1　adbmkdmkコマンドのリターンコード

リターンコード

意味

0

adbmkdmkコマンドが正常に終了しました。

4

adbmkdmkコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbmkdmkコマンドの指定に誤りがあり，adbmkdmkコマンドが実行されませんでした。

adbmkdmkコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

36.5　注意事項

adbmkdmkコマンドは，HADBサーバが稼働中の場合にだけ実行できます。

［Ctrl］＋［C］キーなどでadbmkdmkコマンドのコマンドプロセスを強制終了した場合，HADB暗号鍵ファイルが正常に作成されないことがあります。その場合は，手動でHADB暗号鍵ファイルを削除してから，再度adbmkdmkコマンドを実行してください。

マルチノード機能を使用している場合，adbmkdmkコマンドを実行できるのはプライマリノードだけです。

adbmkdmkコマンドの実行時，次の表に示すディレクトリにアクセスします。adbmkdmkコマンドを実行する前に，ディレクトリに次の表に示すパーミッションを設定してください。

表36‒2　ディレクトリに設定するパーミッション

ディレクトリ

アクセスするOSユーザ※1

必要な権限

HADB暗号鍵の出力先ファイル※2を格納するディレクトリ

HADBサーバプロセスの実行ユーザ

書き込み権限

実行権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

注※2

adbmkdmkコマンドの実行時，権限に400を設定したHADB暗号鍵ファイルが作成されます。

37　adbmodarea（DBエリアの追加・変更）

この章では，adbmodareaコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

37.1　機能

adbmodareaコマンドを実行すると，データ用DBエリアを追加，削除，または拡張できます。

なお，作業表用DBエリア，マスタディレクトリ用DBエリア，ディクショナリ用DBエリア，およびシステム表用DBエリアはadbmodareaコマンドの対象外です。

adbmodareaコマンドは，コマンド実行時にHADBサーバに接続します。

重要

adbmodareaコマンドは，APおよびほかのコマンドと同時に実行できません。

マルチノード機能で共有ディスクのSCSIリザーブを使用している場合は，adbmodareaコマンドを実行する前に，「37.5.2　マルチノード機能使用時の注意事項」を確認してください。

コールドスタンバイ構成で共有ディスクのSCSIリザーブを使用している場合は，adbmodareaコマンドを実行する前に，「37.5.1　共通の注意事項」を確認してください。

メモ

データ用DBエリアを追加，削除，または拡張するときの運用手順については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの運用を参照してください。

マルチノード機能を使用している場合は，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの追加・削除・拡張（マルチノード機能の使用時）を参照してください。

37.1.1　データ用DBエリアの追加

adbmodareaコマンドを実行すると，データ用DBエリアを1つ追加できます。

データ用DBエリアの追加の概要を次の図に示します。

図37‒1　データ用DBエリアの追加

データ用DBエリアの追加で使用するファイルについて説明します。

DBエリア追加・変更オプションファイル

adbmodareaコマンドの実行環境を設定するオプションを指定するファイルです。追加するデータ用DBエリアに関する情報を指定します。

なお，追加するDBエリアのDBエリアファイルとしてブロックスペシャルファイルを割り当てることもできます。この場合，DBディレクトリ下にはブロックスペシャルファイルへのシンボリックリンクが作成されます。

図37‒2　DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合（データ用DBエリアの追加）

重要

ほかのDBエリアファイルに割り当て済みのブロックスペシャルファイルを，新しいDBエリアファイルとして割り当てることはできません。

ブロックスペシャルファイルを割り当てる場合のDBエリア追加・変更オプションの指定については，「37.2.2　DBエリア追加・変更オプションの形式」の「(2)　指定形式の説明」の「(b)　コマンド形式」のadbaddareaオペランドを参照してください。

■AWS環境でクラウドストレージ機能を使用している場合

データ用DBエリアを追加すると，そのデータ用DBエリアのデータを格納する約1ペタバイトの領域（仮想DBエリアファイル）がS3バケット内に作成されます。

図37‒3　データ用DBエリアの追加（AWS環境でクラウドストレージ機能を使用している場合）

■Azure環境でクラウドストレージ機能を使用している場合

データ用DBエリアを追加すると，そのデータ用DBエリアのデータを格納する約1ペタバイトの領域（仮想DBエリアファイル）がコンテナー内に作成されます。

図37‒4　データ用DBエリアの追加（Azure環境でクラウドストレージ機能を使用している場合）

37.1.2　データ用DBエリアの削除

adbmodareaコマンドを実行すると，データ用DBエリアを1つ削除できます。

データ用DBエリアの削除の概要を次の図に示します。

図37‒5　データ用DBエリアの削除

データ用DBエリアの削除で使用するファイルについて説明します。

DBエリア追加・変更オプションファイル

adbmodareaコマンドの実行環境を設定するオプションを指定するファイルです。削除するデータ用DBエリアに関する情報を指定します。

なお，削除するDBエリアのDBエリアファイルがブロックスペシャルファイルの場合，DBディレクトリ下のシンボリックリンクファイルが削除されます。

図37‒6　ブロックスペシャルファイルのデータ用DBエリアファイルを削除する場合

■AWS環境でクラウドストレージ機能を使用している場合

データ用DBエリアを削除すると，そのデータ用DBエリアのデータを格納している全S3オブジェクトが削除されます。

図37‒7　データ用DBエリアの削除（AWS環境でクラウドストレージ機能を使用している場合）

■Azure環境でクラウドストレージ機能を使用している場合

データ用DBエリアを削除すると，そのデータ用DBエリアのデータを格納している全BLOBが削除されます。

図37‒8　データ用DBエリアの削除（Azure環境でクラウドストレージ機能を使用している場合）

37.1.3　データ用DBエリアの拡張（データ用DBエリアファイルの追加）

adbmodareaコマンドを実行すると，1つのデータ用DBエリアの領域を拡張できます（データ用DBエリアにDBエリアファイルを追加できます）。

データ用DBエリアの拡張の概要を次の図に示します。

図37‒9　データ用DBエリアの拡張（データ用DBエリアファイルの追加）

データ用DBエリアの拡張（データ用DBエリアファイルの追加）で使用するファイルについて説明します。

DBエリア追加・変更オプションファイル

adbmodareaコマンドの実行環境を設定するオプションを指定するファイルです。拡張するデータ用DBエリアに関する情報を指定します。

なお，追加するDBエリアファイルとして，ブロックスペシャルファイルを割り当てることもできます。この場合，DBディレクトリ下にはブロックスペシャルファイルへのシンボリックリンクが作成されます。

図37‒10　DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合（データ用DBエリアの拡張）

重要

ほかのDBエリアファイルに割り当て済みのブロックスペシャルファイルを，新しいDBエリアファイルとして割り当てることはできません。

ブロックスペシャルファイルを割り当てる場合のDBエリア追加・変更オプションの指定については，「37.2.2　DBエリア追加・変更オプションの形式」の「(2)　指定形式の説明」の「(b)　コマンド形式」のadbexpandareaオペランドを参照してください。

■AWS環境でクラウドストレージ機能を使用している場合

データ用DBエリアを拡張すると，S3バケット内に約1ペタバイトの領域（仮想DBエリアファイル）が1つ追加されます。

図37‒11　データ用DBエリアの拡張（AWS環境でクラウドストレージ機能を使用している場合）

■Azure環境でクラウドストレージ機能を使用している場合

データ用DBエリアを拡張すると，コンテナー内に約1ペタバイトの領域（仮想DBエリアファイル）が1つ追加されます。

図37‒12　データ用DBエリアの拡張（Azure環境でクラウドストレージ機能を使用している場合）

37.2　adbmodareaコマンドの指定形式

adbmodareaコマンドの指定形式，およびDBエリア追加・変更オプションの形式について説明します。

adbmodareaコマンドを実行できるOSユーザは，HADB管理者だけです。

37.2.1　指定形式およびオプションの説明

(1)　指定形式

adbmodarea DBエリア追加・変更オプションファイル名

(2)　オプションの説明

●DBエリア追加・変更オプションファイル名

〜〈OSパス名〉((2〜510バイト))

DBエリア追加・変更オプションを記述したファイルのパスを，絶対パス名で指定します。DBエリア追加・変更オプションについては，「37.2.2　DBエリア追加・変更オプションの形式」を参照してください。

なお，指定したパス名にシンボリックリンクが含まれる場合，シンボリックリンクが解決されるとパス名の長さが変わることがあります。シンボリックリンクが解決されたあとのパス名の長さが2～510バイトに収まらない場合，エラーになります（KFAA96221-Eメッセージが出力されます）。

37.2.2　DBエリア追加・変更オプションの形式

(1)　指定形式

次の操作のうち，実行したい操作のオペランドを1つだけ指定します。

DBエリアの追加（adbaddareaオペランド）

DBエリアの削除（adbrmareaオペランド）

DBエリアの拡張（adbexpandareaオペランド）

■クラウドストレージ機能を使用していない場合

DBエリアを追加する場合
〔set adb_mod_area_file_rthd_num = DBエリアファイルの作成処理を行うスレッド数〕

  adbaddarea
    -n データ用DBエリア名
  〔-p ｛4｜8｜16｜32｝〕
  〔-s ｛4｜16｜32｝〕
  〔-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…〕
  〔-q〕
  〔-i 初期確保サイズ〔,作成ファイル数〕〕
  〔-f データ用DBエリアファイルの格納先ディレクトリ名〕
  〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
  〔-e〕

DBエリアを削除する場合
  adbrmarea
    -n データ用DBエリア名

DBエリアを拡張する（DBエリアファイルを追加する）場合
〔set adb_mod_area_file_rthd_num = DBエリアファイルの作成処理を行うスレッド数〕

  adbexpandarea
    -n データ用DBエリア名
  〔-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…〕
  〔-q〕
  〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
  〔-i 初期確保サイズ〔,作成ファイル数〕〕

■クラウドストレージ機能を使用している場合

DBエリアを追加する場合
  adbaddarea
    -n データ用DBエリア名
  〔-p 32〕
  〔-s 32〕
  〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕
  〔-e〕

DBエリアを削除する場合
  adbrmarea
    -n データ用DBエリア名

DBエリアを拡張する（DBエリアファイルを追加する）場合
  adbexpandarea
    -n データ用DBエリア名
  〔-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔〕

上記のDBエリア追加・変更オプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

(a)　set形式

●adb_mod_area_file_rthd_num = DBエリアファイルの作成処理を行うスレッド数

〜〈整数〉((1〜1,024))

データ用DBエリアファイルを同時に作成する処理リアルスレッド数の上限を指定します。

このオプションを省略した場合，処理リアルスレッド数は自動で決定されるため，通常はこのオプションを省略してください。

次に示す条件に当てはまる場合は，このオプションを指定して処理リアルスレッド数を制限すると，CPU切り替えのオーバヘッドを削減できることがあります。

実際に使用される処理リアルスレッド数が，サーバマシンのCPUコア数より大き過ぎる場合

なお，このオプションに1を指定した場合，または2つ以上のリアルスレッドを使用できない場合，データ用DBエリアファイルは1つずつ作成されます。

メモ

実際に使用された処理リアルスレッドの数は，メッセージログファイルに出力されるKFAA96207-Iメッセージで確認できます。実際に使用される処理リアルスレッドの数は，作成されるDBエリアファイルの数，およびHADBサーバで使用できる処理リアルスレッドの最大数以下になります。

HADBサーバで使用できる処理リアルスレッドの最大数は，クライアントグループ機能を適用しているかどうかによって異なります。

クライアントグループ機能を適用していない場合

サーバ定義のadb_sys_rthd_numオペランドの値

クライアントグループ機能を適用している場合

マニュアルHADB　システム構築・運用ガイドのリソースの設計のクライアントグループ機能を適用する際の考慮点のグループの処理リアルスレッド数を設定する際の考慮点にある，クライアントグループ機能を適用した場合の処理リアルスレッド数の求め方を参照して求めてください。

なお，クラウドストレージ機能を使用している場合，処理リアルスレッドは使用されません。

(b)　コマンド形式

実行したい操作に従って，次のようにオペランドを指定します。

データ用DBエリアを追加したい場合

adbaddareaオペランドを指定してください。

データ用DBエリアを削除したい場合

adbrmareaオペランドを指定してください。

データ用DBエリアを拡張したい（データ用DBエリアファイルを追加したい）場合

adbexpandareaオペランドを指定してください。

●adbaddarea

追加するデータ用DBエリアの定義を指定します。

追加するデータ用DBエリアファイルとして割り当てるファイルの種類や，クラウドストレージ機能を使用しているかどうかによって，指定するオプションが異なります。オプションの指定の目安を次の表に示します。

表37‒1　指定するオプションの目安

項番

オプション名

クラウドストレージ機能を使用していない場合

クラウドストレージ機能を使用している場合

オプションの説明

ブロックスペシャルファイル

レギュラーファイル

1

-n

○

○

○

データ用DBエリア名を指定するオプションです。

2

-p

○

○

△

データ用DBエリアのページサイズを指定するオプションです。

3

-s

△

△

△

データ用DBエリアの1セグメントの容量を指定するオプションです。

4

-v

○

×

×

データ用DBエリアファイルとして割り当てるブロックスペシャルファイル名を指定するオプションです。

5

-q

○

×

×

データ用DBエリアファイルをクイックモードで作成する場合に指定するオプションです。

6

-i

○

○

×

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイルの数を指定するオプションです。

7

-f

△

△

×

データ用DBエリアファイル，またはブロックスペシャルファイルへのシンボリックリンクを，DBディレクトリのサブディレクトリに格納したい場合に指定するオプションです。

8

-g

△

△

△

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔を指定するオプションです。

9

-e

△

△

△

データ用DBエリアを暗号化する場合に指定するオプションです。

（凡例）

○：必ず指定するオプション，または指定を推奨するオプションです。

△：オプションの説明を読んで指定するかどうかを決定してください。

×：指定しないオプションです。

-n データ用DBエリア名

〜〈文字列〉((1〜30バイト))

追加するデータ用DBエリアの名称を指定します。データ用DBエリアファイルの名称は，このオプションで指定した名称と同じになります。

メモ

クラウドストレージ機能を使用している場合，データ用DBエリアファイルは作成されません。

注意事項を次に示します。

DBエリア名に使用できる文字は，半角の英数字，下線（_），およびハイフン（-）です。また，先頭の文字は英字にする必要があります。

SQL文の予約語と同じ名称をDBエリア名に使用する場合は，DBエリア名を¥"（バックスラッシュと二重引用符）で囲んでください。SQL文の予約語については，マニュアルHADB　SQLリファレンスの基本項目の予約語を参照してください。

DBエリア名に英小文字を使用する場合，¥"でDBエリア名を囲んでください。¥"で囲まないと，DBエリア名の文字列はすべて英大文字と見なされます。

（例）¥"DBarea01¥"

既存のDBエリア名と重複する名称は指定できません。既存のDBエリア名を確認する場合は，HADB管理者が次に示すコマンドを実行してDBエリアのサマリ情報を出力し，DBエリア名（DBarea_name列）を確認してください。DBエリアのサマリ情報で出力される情報の詳細については，「13.3.2　DBエリアのサマリ情報で出力される項目の一覧」を参照してください。

adbdbstatus

DBディレクトリ下のディレクトリ名と重複する名称は指定できません。

-p ｛4｜8｜16｜32｝

追加するデータ用DBエリアのページサイズをキロバイト単位で選択します。データ用DBエリアの設計時に見積もったページサイズを指定してください。データ用DBエリアのページサイズの見積もりについては，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアのページサイズを決める際の考慮点を参照してください。

重要

-sオプションでデータ用DBエリアの1セグメントの容量に16メガバイト以上を選択した場合，-pオプションの選択値に関係なく，データ用DBエリアのページサイズは32キロバイトになります。

［クラウドストレージ機能］

クラウドストレージ機能を使用する場合は，32キロバイトを指定するか，またはこのオプションの指定を省略してください。このオプションの指定を省略した場合は，32キロバイトが仮定されます。

-s ｛4｜16｜32｝

データ用DBエリアの1セグメントの容量をメガバイト単位で選択します。データ用DBエリアの設計時に見積もった1セグメントの容量を指定してください。データ用DBエリアの1セグメントの容量の見積もりについては，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの1セグメントの容量を決める際の考慮点を参照してください。

なお，データ用DBエリアのセグメントサイズは，「1セグメントの容量÷ページサイズ」で決定されます。例えば，1セグメントの容量として32メガバイトを選択した場合のセグメントサイズは，「32,768キロバイト÷32キロバイト＝1,024ページ」になります。

［クラウドストレージ機能］

クラウドストレージ機能を使用する場合は，32メガバイトを指定するか，またはこのオプションの指定を省略してください。このオプションの指定を省略した場合は，32メガバイトが仮定されます。

このオプションの指定値が32メガバイト以外の場合，KFAA50166-Eメッセージが出力され，adbmodareaコマンドがエラーとなります。

-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…

〜〈パス名〉((2〜255バイト))

データ用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合にこのオプションを指定します。このオプションには，DBエリアファイルに割り当てていないブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。

注意事項を次に示します。

LVMで作成したブロックスペシャルファイルか，または/dev/disk/で始まる固定されたデバイス名を，HADBのパス名規則に従って指定してください。

指定するブロックスペシャルファイル名は重複しないようにしてください。

DBエリアファイルに割り当て済みのブロックスペシャルファイルを，新しいDBエリアファイルとして割り当てることはできません。

LVM設定時にこのオプションに指定するブロックスペシャルファイルの数（1つのDBエリアを構成するLVの個数）の目安については，マニュアルHADB　システム構築・運用ガイドのLVM設定時の考慮点を参照してください。

-iオプションに指定する作成ファイル数と同じ数のブロックスペシャルファイルを指定してください。指定したブロックスペシャルファイルの数が作成ファイル数より少ない場合，adbmodareaコマンドがエラーになります。

このオプションを指定した場合，DBディレクトリ下にはブロックスペシャルファイルへのシンボリックリンクが作成されます。

重要

ブロックスペシャルファイルを割り当てた方が，レギュラーファイルを割り当てたときより性能向上が期待できます。

ただし，ブロックスペシャルファイルを割り当てると，ブロックスペシャルファイル内の既存データは消去されます。データを消去してよいか判断できない場合は，ブロックスペシャルファイルを割り当てないでください。

また，OSにマウントされているブロックスペシャルファイルを割り当てることはできません。割り当てるブロックスペシャルファイルはアンマウントしておく必要があります。

-q

データ用DBエリアファイルをクイックモードで作成する場合にこのオプションを指定します。このオプションを指定すると，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-qオプションは，初期化対象のファイルがブロックスペシャルファイルの場合に適用されます。

メモ

クイックモードでデータ用DBエリアファイルを作成した場合，管理ページ（ファイルサイズなどの情報を格納しているページ）だけを作成し，データを格納するページは作成されません。そのため，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-i 初期確保サイズ〔,作成ファイル数〕

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイル数を指定します。

初期確保サイズ：

〜〈英字および数字〉((0K〜127P))《0K》

データ用DBエリアファイルの1ファイル当たりの初期確保サイズを，K（キロバイト），M（メガバイト），G（ギガバイト），T（テラバイト），P（ペタバイト）の単位表記付きで指定します。指定した初期確保サイズに従って，データ用DBエリアファイルのファイルサイズが決まります。ただし，初期確保時のページの配置によって，このオプションに指定した初期確保サイズの値どおりには，データ用DBエリアファイルのファイルサイズが確保されないことがあります。

データ用DBエリアファイルの種類によって，初期確保サイズの目安が異なります。このため，異なる種類のデータ用DBエリアファイルを同時に作成しないでください。データ用DBエリアファイルの種類に応じた初期確保サイズの目安を次の表に示します。

表37‒2　データ用DBエリアファイルの種類と初期確保サイズの目安

項番

データ用DBエリアファイルの種類

初期確保サイズの指定値の目安

1

レギュラーファイル

「初期確保サイズ×作成ファイル数」の値が「データ用DBエリアファイルを配置するファイルシステムの空き容量」未満になる範囲で，任意の値を指定してください。具体的な数値については，ディスクの空き容量の消費量やadbmodareaコマンドの実行時間を考慮し，判断してください。

2

ブロックスペシャルファイル

物理ボリューム（物理ブロックが静的に割り当てられた通常のブロックスペシャルファイル）

割り当てる物理ボリュームの容量がすべて同じ場合は，1ボリューム分の容量を初期確保サイズに指定してください。

容量が異なる物理ボリュームの同時割り当ては推奨しません。しかし，もし容量が異なる物理ボリュームを同時に割り当てる必要がある場合は，いちばん小さいボリュームの容量を指定してください。

3

仮想ボリューム（シンプロビジョニング※と呼ばれるストレージ仮想化技術を適用したブロックスペシャルファイル）

仮想ボリュームを16テラバイト未満で使用する場合は，0Kを指定します。

仮想ボリュームを16テラバイト以上使用する可能性がある場合は，使用する予定の容量を指定します。ただし，16テラバイト以上の使用が想定されるケースでは，仮想ボリュームの割り当てを推奨しません。16テラバイト以上の容量を指定すると，最初から大量の物理ブロックが必要となり，仮想ボリュームのメリットである初期導入コストの削減効果を十分に得られないためです。

注※　シンプロビジョニングの詳細については，ストレージ製品のマニュアルなどを参照してください。

メモ

データ用DBエリアファイルのファイルサイズは，-iオプションの指定値のとおりに確保されないことがあります。理由を次に示します。

データ用DBエリアファイルは，次に示すページから構成されています。

ディレクトリページ

セグメント（表のデータやインデクスを格納するページ群）

-iオプションでデータ用DBエリアファイルのファイルサイズを指定すると，指定したサイズに収まるように，各ページが配置されます。ただし，ディレクトリページやセグメントの途中で，-iオプションで指定したサイズに達する場合，次のようにページ数が調整されます。

データ用DBエリアファイルの先頭部分には，連続するディレクトリページが必ず作成されます。そのため，データ用DBエリアファイルのファイルサイズの最小値（約5.4メガバイト）よりも小さい値を指定した場合は，値が切り上げられます。

セグメントを構成するページは，セグメント単位（1つのセグメントを構成するページ数の単位）で管理されます。そのため，1セグメントの途中で指定したファイルサイズを超えないよう，ページ数が調整されます。例えば，8個目のセグメントの途中で指定したファイルサイズを超える場合，8個目のセグメントは作成されません（7個のセグメントが作成されます）。

データ用DBエリアファイルのディレクトリページおよびセグメントについては，マニュアルHADB　システム構築・運用ガイドのDBエリアの構造（セグメントとページ）のページのページの種類にあるディレクトリページ群の存在とディレクトリページの配置の説明を参照してください。

作成ファイル数：

〜〈整数〉((1〜1,024))《1》（単位：個）

作成するデータ用DBエリアファイル数を指定します。

-vオプションを指定する場合は，作成ファイル数と-vオプションに指定するブロックスペシャルファイルの数を同じにしてください。

-iオプションの指定によって確保される初期確保サイズを，例を使って説明します。

（例）

adbaddarea -n NEWAREA -i 2G,3

この場合，データ用DBエリア（NEWAREA）にデータ用DBエリアファイルが3つ作成され，各データ用DBエリアファイルに2ギガバイトの初期確保サイズが確保されます。したがって，NEWAREAの初期確保サイズは，合計6ギガバイトになります。

なお，-iオプションの指定に従って確保しようとした初期確保サイズが上限を超えた場合，adbmodareaコマンドがエラーになります。このとき，KFAA96228-Eメッセージが出力されるため，メッセージに従って-iオプションの指定を変更してください。

重要

DBエリアファイルの自動増分の上限値を超える大容量のブロックスペシャルファイルを割り当てた場合，ブロックスペシャルファイル内に使用できない領域が発生するため，adbmodareaコマンドの実行時に警告メッセージKFAA96244-Wが出力されます。ブロックスペシャルファイルの容量のほぼ限界まで領域を使用したい場合は，KFAA96244-Wメッセージに記載されている対策に従ってください。

DBエリアファイルの自動増分の上限値は，初期確保サイズの指定値によって決まります。初期確保サイズの指定値を16テラバイトの倍数に切り上げた値が1DBエリアファイルの自動増分の上限値になります。例えば，初期確保サイズに20テラバイトを指定した場合，そのDBエリアファイルの自動増分の上限値は32テラバイトになります。

なお，使用できない領域をあとから使用できるようにする方法はありません。

1つのDBエリアに小容量と大容量のブロックスペシャルファイルを割り当てる場合，ブロックスペシャルファイルごとに異なる初期確保サイズを指定して，ブロックスペシャルファイルを初期化してください。例を次に示します。

（例）追加するDBエリアAREA1に次の2つのブロックスペシャルファイルを割り当てます。

/dev/mapper/vg_10TB_1（容量10テラバイト）

/dev/mapper/vg_30TB_1（容量30テラバイト）

手順

adbmodareaコマンドでDBエリアAREA1を追加します。このとき，次のようにDBエリア追加・変更オプションを指定し，/dev/mapper/vg_10TB_1のファイルを初期化します。

adbaddarea -n AREA1 ... -i 10T -v /dev/mapper/vg_10TB_1

adbmodareaコマンドでDBエリアAREA1を拡張します。このとき，次のようにDBエリア追加・変更オプションを指定し，/dev/mapper/vg_30TB_1のファイルを追加します。

adbexpandarea -n AREA1 ... -i 30T -v /dev/mapper/vg_30TB_1

上記の手順1.で2つのブロックスペシャルファイルを同時に初期化した場合，初期確保サイズには10テラバイトを超える値を指定できないため，DBエリアファイルの自動増分の上限値は16テラバイトになります。この場合，30テラバイトのブロックスペシャルファイルは，DBエリアファイルの自動増分の上限値である16テラバイトまでしか使用されません。

-f データ用DBエリアファイルの格納先ディレクトリ名

〜〈パス名〉((1〜70バイト))

データ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクを格納するサブディレクトリを，DBディレクトリ直下からの相対パス名で指定します。このサブディレクトリの直下に，DBエリア名と同名のデータ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクが作成されます。

このオプションを指定しない場合，データ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクは，DBディレクトリの直下に格納されます。

このオプションの指定例を次に示します。

（例）

adbaddarea -n NEWAREA -f DB02/

この場合，DBディレクトリの直下にDB02というサブディレクトリが作成され，そのサブディレクトリの直下に，ファイル名NEWAREAのデータ用DBエリアファイルまたはブロックスペシャルファイルへのシンボリックリンクが作成されます。

このオプションを指定する際の注意事項を次に示します。

相対パス名の先頭のスラッシュ(/)は指定不要です。

半角英字で始まりスラッシュ(/)で終わる，半角の英数字，下線(_)，ハイフン(-)だけで構成されているパス名を指定してください。パス名がスラッシュで終わらない場合，末尾に自動でスラッシュが追加されます。このとき，指定できるパス名は69バイトまでになります。

DBエリアファイルの格納先ディレクトリ名に英小文字を使用する場合，ディレクトリ名を¥"（バックスラッシュと二重引用符）で囲んでください。¥"で囲まないと，DBエリアファイルの格納先ディレクトリ名の文字列は，すべて英大文字と見なされます。

（例）¥"Db02/¥"

DBディレクトリ下のディレクトリ以下のパスは指定できません。

DBエリア名と同名の中間ディレクトリを含むパスを指定していると，ディレクトリやファイルの作成に失敗する場合があります。このため，DBエリアファイルが作成される位置に，同名のディレクトリが配置されないように注意してください。

-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔

〜〈整数〉((0〜100))《0》（単位：％）

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージを出力する場合にこのオプションを指定します。

メッセージの出力間隔を％単位で指定します。例えば，このオプションに30を指定した場合，DBエリアの作成処理が30％，60％，および90％完了したときに進捗状況を知らせるKFAA96232-Iメッセージ（クラウドストレージ機能の使用時はKFAA96249-Iメッセージ）が出力されます。

なお，このオプションを省略した場合，または0を指定した場合，進捗状況を知らせるメッセージは出力されません。

-e

データ用DBエリアを暗号化する場合に指定します。

サーバ定義adb_crypto_dmkey_pathオペランドが指定されていない場合（HADB暗号鍵がない場合），このオプションを指定するとエラーとなります（KFAA50162-Eメッセージが出力されます）。

●adbrmarea

削除するDBエリアの定義を指定します。

-n データ用DBエリア名

〜〈文字列〉((1〜30バイト))

削除するデータ用DBエリアの名称を指定します。

次に示すDBエリアの名称を指定した場合は，DBエリアを削除できません。

データ用DBエリア以外のDBエリア

最後の1つであるデータ用DBエリア

表またはインデクスが格納されているデータ用DBエリア

DBエリアに格納されている表またはインデクスの調べ方については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の検索を参照してください。

注意事項を次に示します。

削除するDBエリア名がSQL文の予約語と同じ場合は，DBエリア名を¥"（バックスラッシュと二重引用符）で囲んでください。SQL文の予約語については，マニュアルHADB　SQLリファレンスの基本項目の予約語を参照してください。

削除するDBエリア名に英小文字が含まれる場合は，DBエリア名を¥"で囲んでください。¥"で囲まないと，DBエリア名の文字列はすべて英大文字と見なされます。

（例）¥"DBarea01¥"

●adbexpandarea

拡張する（データ用DBエリアファイルを追加する）DBエリアの定義を指定します。

拡張するデータ用DBエリアファイルを構成しているファイルの種類や，クラウドストレージ機能を使用しているかどうかによって，指定するオプションが異なります。オプションの指定の目安を次の表に示します。

表37‒3　指定するオプションの目安

項番

オプション名

クラウドストレージ機能を使用していない場合

クラウドストレージ機能を使用している場合

オプションの説明

ブロックスペシャルファイル

レギュラーファイル

1

-n

○

○

○

データ用DBエリア名を指定するオプションです。

2

-v

○

×

×

データ用DBエリアファイルとして割り当てるブロックスペシャルファイル名を指定するオプションです。

3

-q

○

×

×

データ用DBエリアファイルをクイックモードで作成する場合に指定するオプションです。

4

-i

○

○

×

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイルの数を指定するオプションです。

5

-g

△

△

△

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔を指定するオプションです。

（凡例）

○：必ず指定するオプション，または指定を推奨するオプションです。

△：オプションの説明を読んで指定するかどうかを決定してください。

×：指定しないオプションです。

重要

1つのDBエリア内に，レギュラーファイルとブロックスペシャルファイルを混在させないようにしてください。拡張するデータ用DBエリアに1つでもブロックスペシャルファイルのDBエリアファイルがある場合は，必ず-vオプションを指定してください。また，レギュラーファイルのDBエリアファイルだけで構成されるデータ用DBエリアには，-vオプションを指定できません。

-n データ用DBエリア名

〜〈文字列〉((1〜30バイト))

拡張する（DBエリアファイルを追加する）データ用DBエリアの名称を指定します。

注意事項を次に示します。

拡張するDBエリア名がSQL文の予約語と同じ場合は，DBエリア名を¥"（バックスラッシュと二重引用符）で囲んでください。SQL文の予約語については，マニュアルHADB　SQLリファレンスの基本項目の予約語を参照してください。

拡張するDBエリア名に英小文字が含まれる場合は，DBエリア名を¥"で囲んでください。¥"で囲まないと，DBエリア名の文字列はすべて英大文字と見なされます。

（例）¥"DBarea01¥"

-v ブロックスペシャルファイル名〔,ブロックスペシャルファイル名〕…

〜〈パス名〉((2〜255バイト))

データ用DBエリアファイルとしてブロックスペシャルファイルを割り当てる場合にこのオプションを指定します。このオプションには，DBエリアファイルに割り当てていないブロックスペシャルファイルの絶対パス名を，実体またはシンボリックリンクで指定します。

注意事項を次に示します。

拡張するデータ用DBエリアに1つでもブロックスペシャルファイルのDBエリアファイルがある場合は，必ずこのオプションを指定してください。また，レギュラーファイルのDBエリアファイルだけで構成されるデータ用DBエリアには，このオプションを指定できません。

LVMで作成したブロックスペシャルファイルか，または/dev/disk/で始まる固定されたデバイス名を，HADBのパス名規則に従って指定してください。

指定するブロックスペシャルファイル名は重複しないようにしてください。

DBエリアファイルに割り当て済みのブロックスペシャルファイルを，新しいDBエリアファイルとして割り当てることはできません。

LVM設定時にこのオプションに指定するブロックスペシャルファイルの数（1つのDBエリアを構成するLVの個数）の目安については，マニュアルHADB　システム構築・運用ガイドのLVM設定時の考慮点を参照してください。

-iオプションに指定する作成ファイルと同じ数のブロックスペシャルファイルを指定してください。指定したブロックスペシャルファイルの数が作成ファイル数より少ない場合，adbmodareaコマンドがエラーになります。

このオプションを指定した場合，DBディレクトリ下にはブロックスペシャルファイルへのシンボリックリンクが作成されます。

重要

ブロックスペシャルファイルを割り当てた方が，レギュラーファイルを割り当てたときより性能向上が期待できます。

ただし，ブロックスペシャルファイルを割り当てると，ブロックスペシャルファイル内の既存データは消去されます。データを消去してよいか判断できない場合は，ブロックスペシャルファイルを割り当てないでください。

また，OSにマウントされているブロックスペシャルファイルを割り当てることはできません。割り当てるブロックスペシャルファイルはアンマウントしておく必要があります。

-q

データ用DBエリアファイルをクイックモードで作成する場合にこのオプションを指定します。このオプションを指定すると，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-qオプションは，初期化対象のファイルがブロックスペシャルファイルの場合に適用されます。

メモ

クイックモードでデータ用DBエリアファイルを作成した場合，管理ページ（ファイルサイズなどの情報を格納しているページ）だけを作成し，データを格納するページは作成されません。そのため，データ用DBエリアファイルの作成処理に掛かる時間を短縮できます。

-i 初期確保サイズ〔,作成ファイル数〕

データ用DBエリアファイルの1ファイル当たりの初期確保サイズと，作成するデータ用DBエリアファイル数を指定します。

初期確保サイズ：

〜〈英字および数字〉((0K〜127P))《0K》

データ用DBエリアファイルの1ファイル当たりの初期確保サイズを，K（キロバイト），M（メガバイト），G（ギガバイト），T（テラバイト），P（ペタバイト）の単位表記付きで指定します。指定した初期確保サイズに従って，データ用DBエリアファイルのファイルサイズが決まります。ただし，初期確保時のページの配置によって，このオプションに指定した初期確保サイズの値どおりには，データ用DBエリアファイルのファイルサイズが確保されないことがあります。

データ用DBエリアファイルの種類によって，初期確保サイズの目安が異なります。このため，異なる種類のデータ用DBエリアファイルを同時に作成しないでください。データ用DBエリアファイルの種類に応じた初期確保サイズの目安を次の表に示します。

表37‒4　データ用DBエリアファイルの種類と初期確保サイズの目安

項番

データ用DBエリアファイルの種類

初期確保サイズの指定値の目安

1

レギュラーファイル

「初期確保サイズ×作成ファイル数」の値が「データ用DBエリアファイルを配置するファイルシステムの空き容量」未満になる範囲で，任意の値を指定してください。具体的な数値については，ディスクの空き容量の消費量やadbmodareaコマンドの実行時間を考慮し，判断してください。

2

ブロックスペシャルファイル

物理ボリューム（物理ブロックが静的に割り当てられた通常のブロックスペシャルファイル）

割り当てる物理ボリュームの容量がすべて同じ場合は，1ボリューム分の容量を初期確保サイズに指定してください。

容量が異なる物理ボリュームの同時割り当ては推奨しません。しかし，もし容量が異なる物理ボリュームを同時に割り当てる必要がある場合は，いちばん小さいボリュームの容量を指定してください。

3

仮想ボリューム（シンプロビジョニング※と呼ばれるストレージ仮想化技術を適用したブロックスペシャルファイル）

仮想ボリュームを16テラバイト未満で使用する場合は，0Kを指定します。

仮想ボリュームを16テラバイト以上使用する可能性がある場合は，使用する予定の容量を指定します。ただし，16テラバイト以上の使用が想定されるケースでは，仮想ボリュームの割り当てを推奨しません。16テラバイト以上の容量を指定すると，最初から大量の物理ブロックが必要となり，仮想ボリュームのメリットである初期導入コストの削減効果を十分に得られないためです。

注※　シンプロビジョニングの詳細については，ストレージ製品のマニュアルなどを参照してください。

メモ

データ用DBエリアファイルのファイルサイズは，-iオプションの指定値のとおりに確保されないことがあります。理由を次に示します。

データ用DBエリアファイルは，次に示すページから構成されています。

ディレクトリページ

セグメント（表のデータやインデクスを格納するページ群）

-iオプションでデータ用DBエリアファイルのファイルサイズを指定すると，指定したサイズに収まるように，各ページが配置されます。ただし，ディレクトリページやセグメントの途中で，-iオプションで指定したサイズに達する場合，次のようにページ数が調整されます。

データ用DBエリアファイルの先頭部分には，連続するディレクトリページが必ず作成されます。そのため，データ用DBエリアファイルのファイルサイズの最小値（約5.4メガバイト）よりも小さい値を指定した場合は，値が切り上げられます。

セグメントを構成するページは，セグメント単位（1つのセグメントを構成するページ数の単位）で管理されます。そのため，1セグメントの途中で指定したファイルサイズを超えないよう，ページ数が調整されます。例えば，8個目のセグメントの途中で指定したファイルサイズを超える場合，8個目のセグメントは作成されません（7個のセグメントが作成されます）。

データ用DBエリアファイルのディレクトリページおよびセグメントについては，マニュアルHADB　システム構築・運用ガイドのDBエリアの構造（セグメントとページ）のページのページの種類にあるディレクトリページ群の存在とディレクトリページの配置の説明を参照してください。

作成ファイル数：

〜〈整数〉((1〜1,023))《1》（単位：個）

作成するデータ用DBエリアファイル数を指定します。

-vオプションを指定する場合は，作成ファイル数と-vオプションに指定するブロックスペシャルファイルの数を同じにしてください。

また，次の計算式の値を超える値は指定できません。

1,024−拡張するデータ用DBエリアの現在のDBエリアファイル数

-iオプションの指定によって確保される初期確保サイズを，例を使って説明します。

（例）

adbexpandarea -n OLDAREA -i 2G,3

この場合，データ用DBエリア（OLDAREA）にデータ用DBエリアファイルが3つ追加され，各データ用DBエリアファイルに2ギガバイトの初期確保サイズが確保されます。したがって，OLDAREAに追加するDBエリアファイルの初期確保サイズは，合計6ギガバイトになります。

なお，-iオプションの指定に従って確保しようとした初期確保サイズが上限を超えた場合，adbmodareaコマンドがエラーになります。このとき，KFAA96228-Eメッセージが出力されるため，メッセージに従って-iオプションの指定を変更してください。

重要

初期確保サイズに小さい値を指定して，16テラバイトを超える大容量のブロックスペシャルファイルを追加した場合，自動増分の上限を超える領域が使用できなくなります。この領域を使用できるようにするには，追加したブロックスペシャルファイルを初期化し直す必要があります。ただし，拡張対象のDBエリアに消去したくないデータが格納されている場合，追加したブロックスペシャルファイルを初期化する手順が複雑になります。

ブロックスペシャルファイルの全領域が使用できなくなるような指定をしている場合は，adbmodareaコマンドの実行時にKFAA96246-Qメッセージ（DBエリアの拡張をこのまま実行するかどうかの確認メッセージ）が出力されます。このメッセージが出力された場合は，n（またはN）を応答してDBエリアの拡張をいったん中止し，初期確保サイズの指定値を見直すことを推奨します。

-g DBエリアファイルの作成処理の進捗状況を知らせるメッセージの出力間隔

〜〈整数〉((0〜100))《0》（単位：％）

データ用DBエリアファイルの作成処理の進捗状況を知らせるメッセージを出力する場合にこのオプションを指定します。

メッセージの出力間隔を％単位で指定します。例えば，このオプションに30を指定した場合，DBエリアの拡張処理が30％，60％，および90％完了したときに進捗状況を知らせるKFAA96232-Iメッセージ（クラウドストレージ機能の使用時はKFAA96249-Iメッセージ）が出力されます。

なお，このオプションを省略した場合，または0を指定した場合，進捗状況を知らせるメッセージは出力されません。

(3)　DBエリア追加・変更オプションのひな形

DBエリア追加・変更オプションのひな形（$ADBDIR/sample/conf/adbmodarea.opt）があります。DBエリア追加・変更オプションを作成する場合は，このひな形を利用してください。

37.3　使用例

この節では，adbmodareaコマンドを実行してデータ用DBエリアを追加，削除，または拡張する方法を，例題形式で説明します。

なお，adbmodareaコマンドはHADB管理者であるOSユーザだけが実行できます。

37.3.1　DBエリアを追加する場合（ブロックスペシャルファイルのDBエリアファイルを作成する）

adbmodareaコマンドを実行して，DBディレクトリにデータ用DBエリアを追加します。次に示すように，データ用DBエリアファイルとしてブロックスペシャルファイルを割り当てます。

［説明］

データ用DBエリアのデータ用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）を割り当てます。

追加するデータ用DBエリアの定義を次に示します。

DBエリア名：NEWAREA

DBエリアファイル数：2

各DBエリアファイルの初期確保サイズ：500メガバイト

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルは存在し，アクセス権限があるものとします。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，追加するデータ用DBエリアの定義を指定します。

DBエリア追加・変更オプションファイルの指定例

adbaddarea -n NEWAREA ¥                                  ...1
           -v /dev/mapper/VolG01,/dev/mapper/VolG02 ¥    ...2
           -q ¥                                          ...3
           -i 500M,2                                     ...4

［説明］

データ用DBエリア名（NEWAREA）を指定します。

データ用DBエリアファイルとして割り当てるブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）を指定します。

クイックモードでデータ用DBエリアファイルを作成する指定をします。

データ用DBエリアファイルの初期確保サイズ（500メガバイト）と，作成するファイル数（2個）を指定します。

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.2　DBエリアを追加する場合（レギュラーファイルのDBエリアファイルを作成する）

adbmodareaコマンドを実行して，DBディレクトリにデータ用DBエリアを追加します。次に示すように，DBエリアファイルをDBディレクトリ下に作成します。

［説明］

追加するデータ用DBエリアの定義を次に示します。

DBエリア名：NEWAREA

DBエリアファイル数：2

各DBエリアファイルの初期確保サイズ：500メガバイト

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，追加するデータ用DBエリアの定義を指定します。

DBエリア追加・変更オプションファイルの指定例

adbaddarea -n NEWAREA ¥                                  ...1
           -i 500M,2                                     ...2

［説明］

データ用DBエリア名（NEWAREA）を指定します。

データ用DBエリアファイルの初期確保サイズ（500メガバイト）と，作成するファイル数（2個）を指定します。

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.3　DBエリアを追加する場合（クラウドストレージ機能の使用時）

adbmodareaコマンドを実行して，データ用DBエリアを追加します。

［説明］

追加するデータ用DBエリアの定義を次に示します。

DBエリア名：NEWAREA

DBエリアのページサイズ：32キロバイト

DBエリアの1セグメントの容量：32メガバイト

追加されるデータ用DBエリアの容量は，約1ペタバイトになります。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，追加するデータ用DBエリアの定義を指定します。

DBエリア追加・変更オプションファイルの指定例

adbaddarea -n NEWAREA ¥                                  ...1
           -p 32 ¥                                       ...2
           -s 32                                         ...3

［説明］

データ用DBエリア名（NEWAREA）を指定します。

データ用DBエリアのページサイズ（32キロバイト）を指定します。

データ用DBエリアの1セグメントの容量（32メガバイト）を指定します。

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.4　DBエリアを削除する場合（ブロックスペシャルファイルのDBエリアファイルを削除する）

adbmodareaコマンドを実行してデータ用DBエリアを削除します。次に示すように，ブロックスペシャルファイル上のDBエリアファイルを削除します。

［説明］

データ用DBエリアOLDAREAを削除します。

OLDAREAのデータ用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）が割り当てられています。

OLDAREAには，表およびインデクスが格納されていないものとします。

OLDAREAのほかにもデータ用DBエリアが存在するものとします。

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルへのアクセス権限はあるものとします。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，削除するデータ用DBエリア名（OLDAREA）を指定します。

DBエリア追加・変更オプションファイルの指定例

adbrmarea -n OLDAREA

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.5　DBエリアを削除する場合（レギュラーファイルのDBエリアファイルを削除する）

adbmodareaコマンドを実行してデータ用DBエリアを削除します。次に示すように，DBディレクトリ下のDBエリアファイルを削除します。

［説明］

データ用DBエリアOLDAREAを削除します。

OLDAREAには，表およびインデクスが格納されていないものとします。

OLDAREAのほかにもデータ用DBエリアが存在するものとします。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，削除するデータ用DBエリア名（OLDAREA）を指定します。

DBエリア追加・変更オプションファイルの指定例

adbrmarea -n OLDAREA

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.6　DBエリアを削除する場合（クラウドストレージ機能の使用時）

adbmodareaコマンドを実行して，データ用DBエリアを削除します。

［説明］

データ用DBエリアOLDAREAを削除します。

OLDAREAには，表およびインデクスが格納されていないものとします。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，削除するデータ用DBエリア名（OLDAREA）を指定します。

DBエリア追加・変更オプションファイルの指定例

adbrmarea -n OLDAREA

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.7　DBエリアを拡張する場合（ブロックスペシャルファイルのDBエリアファイルを追加する）

adbmodareaコマンドを実行してデータ用DBエリアを拡張します（データ用DBエリアファイルを追加します）。次に示すように，データ用DBエリアファイルとしてブロックスペシャルファイルを割り当てます。

［説明］

データ用DBエリアOLDAREAでは，データ用DBエリアファイルとしてブロックスペシャルファイル（/dev/mapper/VolG01〜/dev/mapper/VolG02）が割り当てられています。

データ用DBエリアOLDAREAに追加するデータ用DBエリアファイルとして，ブロックスペシャルファイル（/dev/mapper/VolG03〜/dev/mapper/VolG04）を割り当てます。

拡張するDBエリアの定義を次に示します。

DBエリア名：OLDAREA

DBエリアファイル数：2

各DBエリアファイルの初期確保サイズ：500メガバイト

なお，シンボリックリンクのリンク先ディレクトリおよびブロックスペシャルファイルは存在し，アクセス権限があるものとします。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，拡張するデータ用DBエリアの定義を指定します。

DBエリア追加・変更オプションファイルの指定例

adbexpandarea -n OLDAREA ¥                                  ...1
              -v /dev/mapper/VolG03,/dev/mapper/VolG04 ¥    ...2
              -q ¥                                          ...3
              -i 500M,2                                     ...4

［説明］

データ用DBエリア名（OLDAREA）を指定します。

データ用DBエリアファイルとして割り当てるブロックスペシャルファイル（/dev/mapper/VolG03〜/dev/mapper/VolG04）を指定します。

クイックモードでデータ用DBエリアファイルを追加する指定をします。

データ用DBエリアファイルの初期確保サイズ（500メガバイト）と，追加するファイル数（2個）を指定します。

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.8　DBエリアを拡張する場合（レギュラーファイルのDBエリアファイルを追加する）

adbmodareaコマンドを実行してデータ用DBエリアを拡張します（データ用DBエリアファイルを追加します）。次に示すように，データ用DBエリアファイルをDBディレクトリ下に追加します。

［説明］

データ用DBエリアOLDAREAでは，データ用DBエリアファイルの実体がDBディレクトリ下に作成されています。

拡張するDBエリアの定義を次に示します。

DBエリア名：OLDAREA

追加するDBエリアファイル数：2

各DBエリアファイルの初期確保サイズ：500メガバイト

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，拡張するデータ用DBエリアの定義を指定します。

DBエリア追加・変更オプションファイルの指定例

adbexpandarea -n OLDAREA ¥                                  ...1
              -i 500M,2                                     ...2

［説明］

データ用DBエリア名（OLDAREA）を指定します。

データ用DBエリアファイルの初期確保サイズ（500メガバイト）と，追加するファイル数（2個）を指定します。

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.3.9　DBエリアを拡張する場合（クラウドストレージ機能の使用時）

adbmodareaコマンドを実行してデータ用DBエリアを拡張します。

［説明］

拡張するDBエリアの定義を次に示します。

DBエリア名：CURRENTAREA

データ用DBエリアを拡張すると，約1ペタバイトの領域（仮想DBエリアファイル）が1つ追加されます。上記の場合，データ用DBエリア（CURRENTAREA）の容量は，約2ペタバイトになります。

このとき，次に示す手順でadbmodareaコマンドを実行します。

手順

DBエリア追加・変更オプションファイルを作成する

adbmodareaコマンドを実行する

各手順の例を以降で説明します。

(1)　DBエリア追加・変更オプションファイルを作成する

DBエリア追加・変更オプションファイルを作成し，拡張するデータ用DBエリア名（CURRENTAREA）を指定します。

DBエリア追加・変更オプションファイルの指定例

adbexpandarea -n CURRENTAREA

(2)　adbmodareaコマンドを実行する

adbmodarea /HADB/server/conf/adbmodarea.opt

［説明］

「(1)　DBエリア追加・変更オプションファイルを作成する」で作成したDBエリア追加・変更オプションファイル名を指定します。

37.4　リターンコード

adbmodareaコマンドのリターンコードを次の表に示します。

表37‒5　adbmodareaコマンドのリターンコード

リターンコード

意味

0

adbmodareaコマンドが正常に終了しました。

4

adbmodareaコマンドは正常に終了しましたが，警告メッセージが出力されています。表示されたメッセージまたはメッセージログファイルに出力された警告メッセージを確認してください。

8

adbmodareaコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージまたはメッセージログファイルに出力されたメッセージを参照してください。マルチノード機能を使用している場合は，セカンダリノードおよびワーカーノードのHADBサーバでも，メッセージログファイルに出力されたメッセージを確認してください。セカンダリノードおよびワーカーノードのHADBサーバでエラーが発生したおそれがあります。

HADBサーバが異常終了していない場合，HADBサーバ内での処理結果を示すメッセージがメッセージログファイルに出力されます。

37.5　注意事項

adbmodareaコマンド実行時の注意事項を説明します。

37.5.1　共通の注意事項

adbmodareaコマンドは，APおよびほかのコマンドと同時に実行できません。

DBエリアファイルに割り当て済みのブロックスペシャルファイルを，新しいデータ用DBエリアファイルとして割り当てることはできません。

ダイレクトI/Oをサポートしていないファイルシステム上にデータ用DBエリアファイルを作成できません。

誤って削除してしまったDBエリアを回復したい場合に備えて，DBエリアの削除を実行する前に，必ずデータベースのバックアップを取得してください。バックアップについては，マニュアルHADB　システム構築・運用ガイドのデータベースのバックアップを参照してください。

adbmodareaコマンドが既存のファイルを上書きする場合，対象ファイルはいったん削除されてから再作成されます。

adbmodareaコマンドが異常終了した場合は，エラーの原因を取り除いてから，コマンドを再実行してください。

adbmodareaコマンドの実行中に，電源断などが原因でHADBサーバが異常終了した場合，ロールバックに失敗してデータベースが不正な状態になることがあります。その場合は，adbstartコマンドを実行して，HADBサーバを再開始してください。

adbmodareaコマンドの実行中に，電源断などが原因でHADBサーバが異常終了した場合，不要なDBエリアファイルが残ることがあります。ただし，DBエリアファイルが残っても問題ないため，特に削除は不要です。

もし，残ったDBエリアファイルを削除したい場合は，次に示す手順で削除できます。

手順1.

adbstartコマンドを実行して，HADBサーバを再開始してください。HADBサーバの再開始が完了するまで，DBエリアファイルは削除できません。

手順2.

-dオプションにusedを指定してadbdbstatusコマンドを実行してください。

手順3.

adbdbstatusコマンドで出力される，DBエリア，表とインデクスの使用量情報の「DBarea_filename」列に，削除したいDBエリアファイル名が出力されていないことを確認してください。

HADBサーバが使用していないDBエリアファイルは，「DBarea_filename」列に出力されません。そのため，削除できるDBエリアファイルと判断できます。ただし，「DBarea_filename」列にファイル名が出力されないが，HADBサーバが使用しているファイル（ADBMSTなど）があります。該当するファイル（ADBMSTなど）は，削除しないでください。

手順4.

HADBサーバが使用していないことを確認したあとで，削除したいDBエリアファイルをOSのrmコマンドなどで削除してください。

adbmodareaコマンドの実行中に，電源断などが原因でHADBサーバが異常終了した場合，HADBサーバ内での処理結果を示すメッセージがどこにも出力されないことがあります。メッセージが出力されていない場合は，異常終了したHADBサーバを再開始したあと，adbdbstatusコマンドを実行してください。adbdbstatusコマンドの出力結果から，DBエリアの変更が反映されているかどうかを確認できます。

adbmodareaコマンドで追加したデータ用DBエリアには，自動でグローバルバッファが割り当てられます。任意のバッファを割り当てたい場合は，サーバ定義にadbbuffオペランドを追加して，HADBサーバを再起動してください。adbbuffオペランドの指定方法については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容のグローバルバッファに関するオペランドおよびオプション（コマンド形式）を参照してください。

グローバルバッファを割り当てているデータ用DBエリアをすべて削除した場合，そのグローバルバッファが使用していた共有メモリが解放されます。

DBエリアの追加およびDBエリアの削除を実行した場合は，次に示すメモリ所要量が変化します。そのため，再見積もりしてください。変数の求め方については，マニュアルHADB　システム構築・運用ガイドのリソースの設計のHADBサーバのメモリ所要量の見積もりのHADBサーバ開始時のメモリ所要量の求め方を参照してください。

グローバルバッファページの所要量（変数SHM_BUFGLOBAL）

プロセス共通メモリの所要量（変数BUFGLOBAL）

コールドスタンバイ構成で共有ディスクのSCSIリザーブを使用している場合，次に示すときは，HAモニタのserversファイル中のオペランドの指定を変更する必要があります。

adbmodareaコマンドでDBエリアを追加するとき

adbmodareaコマンドでDBエリアを拡張するとき

adbmodareaコマンドでDBエリアを削除するとき

そのため，コールドスタンバイ構成をいったん終了する必要があります。運用手順の詳細については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの追加・削除・拡張（コールドスタンバイ構成の場合）を参照してください。

暗号化していないデータ用DBエリアを暗号化する場合，そのデータ用DBエリアをいったん削除したあとに，暗号化対象のデータ用DBエリアとして追加してください。暗号化しているデータ用DBエリアの暗号化をやめる場合も同様に，データ用DBエリアを削除したあとに追加してください。詳細については，マニュアルHADB　システム構築・運用ガイドの暗号化していないDBエリアを暗号化する場合および暗号化対象のDBエリアの暗号化をやめる場合を参照してください。

adbmodareaコマンドの実行時，次の表に示すファイルにアクセスします。adbmodareaコマンドを実行する前に，各ファイルに次の表に示すパーミッションを設定してください。

表37‒6　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

DBエリア追加・変更オプションファイル

コマンドの実行ユーザ

読み取り権限

DBエリア追加・変更オプションの-vオプションに指定するブロックスペシャルファイル（クラウドストレージ機能を使用しない場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

37.5.2　マルチノード機能使用時の注意事項

adbmodareaコマンドは，プライマリノードのHADBサーバで実行してください。

HAモニタありのマルチノード構成の場合，プライマリノードおよび全セカンダリノードが稼働中のときにデータ用DBエリアを追加または拡張できます。

ワーカーノードが停止していてもデータ用DBエリアを追加または拡張できますが，停止していたワーカーノードをマルチノード構成に追加する際，adbinitコマンドでDBディレクトリの再作成が必要になります。そのため，ワーカーノードも含めた全ノードが稼働中のときにデータ用DBエリアを追加または拡張することを推奨します。データ用DBエリアの追加または拡張手順については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの追加・削除・拡張（マルチノード機能の使用時）を参照してください。

DBエリアを追加または拡張する場合は，追加するDBエリアファイルをブロックスペシャルファイルに割り当てる必要があります。このブロックスペシャルファイルは，全ノードから同じパス名でアクセスできる必要があります。そのため，WWNを含むブロックスペシャルファイルを使用してください。詳細については，「20.3.4　DBディレクトリを作成する場合（マルチノード機能の使用時）」を参照してください。

メモ

クラウドストレージ機能を使用している場合，この注意事項は該当しません。

共有ディスクのSCSIリザーブを使用している場合，次に示すときは，HAモニタのserversファイル中のオペランドの指定を変更する必要があります。

adbmodareaコマンドでDBエリアを追加するとき

adbmodareaコマンドでDBエリアを拡張するとき

adbmodareaコマンドでDBエリアを削除するとき

そのため，マルチノード構成のHADBサーバをいったん終了する必要があります。運用手順の詳細については，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの追加・削除・拡張（マルチノード機能の使用時）を参照してください。

adbmodareaコマンドの実行中は，ワーカーノードを追加できません。

37.5.3　クラウドストレージ機能使用時の注意事項

データ用DBエリアを追加すると，HADBサーバの開始，adbdbstatusコマンドの実行，チャンクの更新や削除などの各種処理時間が長くなることがあります。そのため，データ用DBエリアの追加は，必要な場合に限り実行するようにしてください。データ用DBエリアを追加する前に，マニュアルHADB　システム構築・運用ガイドのデータ用DBエリアの設計を参照して，データ用DBエリアの追加の妥当性を検討してください。

各データ用DBエリアは，最大1,023回まで拡張できます。

データ用DBエリアを拡張すると，HADBサーバの開始，adbdbstatusコマンドの実行，チャンクの更新や削除などの各種処理時間が長くなることがあります。そのため，データ用DBエリアの容量不足が発生しそうな場合だけ，データ用DBエリアを拡張してください。

データ用DBエリアにはブロックスペシャルファイルを割り当てられません。そのため，データ用DBエリアを追加または拡張するときに-vオプションを指定すると，KFAA50165-Eメッセージが出力され，adbmodareaコマンドがエラーとなります。

AWS環境でadbmodareaコマンドの実行中に，電源断などが原因でHADBサーバが異常終了した場合，不要なS3オブジェクトが残ることがあります。その場合は，メッセージログ（マルチノード構成では全ノードのメッセージログ）を参照して，adbmodareaコマンドの実行結果を確認してください。KFAA50168-Iメッセージが出力されていて，KFAA50168-Iメッセージに対応するKFAA50169-Iメッセージが出力されていないときは，KFAA50168-Iメッセージに出力されている削除対象のS3オブジェクトがS3バケット内に残っているかどうかを確認してください。S3オブジェクトが残っている場合は，手動でそのS3オブジェクトを削除してください。

メモ

Azure環境の場合は，S3オブジェクトをBLOBに読み替えてください。また，S3バケットをコンテナーに読み替えてください。

次のすべての条件に該当する場合は，HADBサーバの再開始後にadbmodareaコマンドを再実行してください。

HADBサーバの異常終了によって，DBエリアの追加または拡張が完了していない（KFAA96205-Iメッセージが出力されていない）

KFAA50168-Iメッセージが出力されていない

KFAA96250-Iメッセージが出力されている

サーバ定義のadbcachegrpオペランドを指定してキャッシュグループを定義している場合，adbmodareaコマンドで追加したデータ用DBエリアは，既定のキャッシュグループに割り当てられます。既定のキャッシュグループ以外のキャッシュグループにデータ用DBエリアを割り当てたい場合は，サーバ定義のadbcachegrpオペランドに，追加したデータ用DBエリア名を指定してください。そのあと，HADBサーバを再起動してください。

キャッシュグループの詳細については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

サーバ定義のadbcachegrpオペランドでキャッシュグループを定義している場合，キャッシュグループに割り当てられた全データ用DBエリアが削除されると，そのキャッシュグループが使用していた領域は解放されます。

38　adbmodbuff（バッファの変更）

この章では，adbmodbuffコマンドの機能と使い方について説明します。

38.1　機能

adbmodbuffコマンドを実行すると，サーバ定義で指定した次に示すバッファのページ数を，HADBサーバ稼働中に変更できます。

ローカル作業表用バッファ

ただし，adbmodbuffコマンドで変更した内容は，HADBサーバ終了時に失われます。変更した内容を次回起動時も引き継ぐ場合は，変更した内容をサーバ定義に反映してください。

サーバ定義の変更方法については，マニュアルHADB　システム構築・運用ガイドのシステム構築のサーバ定義の作成および変更方法のサーバ定義の変更方法を参照してください。

adbmodbuffコマンドは，コマンド実行時にHADBサーバに接続します。

38.2　adbmodbuffコマンドの指定形式

adbmodbuffコマンドの指定形式，およびバッファ変更オプションの形式について説明します。

adbmodbuffコマンドを実行できるOSユーザを次に示します。

HADB管理者

38.2.1　指定形式およびオプションの説明

(1)　指定形式

adbmodbuff バッファ変更オプションファイル名

(2)　オプションの説明

●バッファ変更オプションファイル名

〜〈パス名〉((2〜510バイト))

バッファ変更オプションを指定したバッファ変更オプションファイルの絶対パス名を指定します。

バッファ変更オプションについては，「38.2.2　バッファ変更オプションの形式」を参照してください。

38.2.2　バッファ変更オプションの形式

(1)　指定形式

set adb_dbbuff_wrktbl_clt_blk_num = ローカル作業表用バッファのページ数

上記のバッファ変更オプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_dbbuff_wrktbl_clt_blk_num = ローカル作業表用バッファのページ数

〜〈整数〉((5〜100,000,000))

ローカル作業表用バッファのページ数を指定します。

このオプションを指定すると，サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドの指定値を一時的に変更できます（このオプションの指定値が優先されます）。

ただし，HADBサーバが終了すると，このオプションで指定した内容は失われます。

また，次のどれかを指定している場合，このオプションを指定しても，ローカル作業表用バッファのページ数は変更されません。

クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランド

エクスポートオプションadb_export_wrktbl_blk_num

メモ

サーバ定義のadb_dbbuff_wrktbl_clt_blk_numオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容の性能に関するオペランド（set形式）を参照してください。

クライアント定義のadb_dbbuff_wrktbl_clt_blk_numオペランドについては，マニュアルHADB　AP開発ガイドのクライアント定義の設計のクライアント定義のオペランドの内容の性能に関するオペランドを参照してください。

エクスポートオプションadb_export_wrktbl_blk_numについては，「14.2.2　エクスポートオプションの形式」を参照してください。

ローカル作業表を作成するSQL文については，マニュアルHADB　AP開発ガイドのAPの性能向上に関する設計の作業表が作成されるSQLを実行する際の考慮点のSQLを実行した場合に作成される作業表についてを参照してください。

38.3　使用例

adbmodbuffコマンドを実行してサーバ定義で指定したバッファのページ数を変更する方法を，例題形式で説明します。

38.3.1　ローカル作業表用バッファのページ数を変更する場合

次に示す手順でadbmodbuffコマンドを実行して，ローカル作業表用バッファのページ数を変更します。

手順

バッファ変更オプションファイルを作成する

adbmodbuffコマンドを実行する

各手順の例を以降で説明します。

(1)　バッファ変更オプションファイルを作成する

バッファ変更オプションファイルを作成して，バッファ変更オプションを指定します。

バッファ変更オプションファイルの指定例

set adb_dbbuff_wrktbl_clt_blk_num = 256

［説明］

ローカル作業表用バッファのページ数（256）を指定します。

(2)　adbmodbuffコマンドを実行する

adbmodbuff /home/adbmanager/adbmodbuff.opt

［説明］

「(1)　バッファ変更オプションファイルを作成する」で作成したバッファ変更オプションファイル名を指定します。

38.4　リターンコード

adbmodbuffコマンドのリターンコードを次の表に示します。

表38‒1　adbmodbuffコマンドのリターンコード

リターンコード

意味

0

adbmodbuffコマンドが正常に終了しました。

4

adbmodbuffコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbmodbuffコマンドの指定に誤りがあり，adbmodbuffコマンドが実行されませんでした。

adbmodbuffコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。

38.5　注意事項

adbmodbuffコマンドは，HADBサーバが稼働中の場合に実行できます。

実行したノードで別のadbmodbuffコマンドが実行中の場合は，adbmodbuffコマンドは実行できません。

adbmodbuffコマンドで変更した結果を次回のHADBサーバ開始以降も使用する場合は，サーバ定義を変更しておく必要があります。サーバ定義の変更方法については，マニュアルHADB　システム構築・運用ガイドのシステム構築のサーバ定義の作成および変更方法のサーバ定義の変更方法を参照してください。

マルチノード機能を使用している場合は，adbmodbuffコマンドを実行したノードのバッファだけが変更されます。

adbmodbuffコマンドの実行時，次の表に示すファイルにアクセスします。adbmodbuffコマンドを実行する前に，ファイルに次の表に示すパーミッションを設定してください。

表38‒2　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

バッファ変更オプションファイル

コマンドの実行ユーザ

読み取り権限

注※

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

39　adbmonitor（HADBサーバの監視）

この章では，adbmonitorコマンドの機能と使い方について説明します。

39.1　機能

adbmonitorコマンドを実行すると，HADBサーバの状態を監視できます。

HADBサーバの異常終了時，HADBサーバの再起動を自動的に行うようにしたい場合に，adbmonitorコマンドを実行します。運用方法については，マニュアルHADB　システム構築・運用ガイドのHADBサーバの自動再起動の設定を参照してください。

次のどれかの場合，HADBサーバの再起動を自動的に行うようにできます。

マルチノード機能を使用しない場合に，異常終了したHADBサーバを自動的に再起動したいとき

HAモニタありのマルチノード構成で，異常終了したワーカーノードのHADBサーバを自動的に再起動したいとき

HAモニタなしのマルチノード構成で，異常終了した各ノードのHADBサーバを自動的に再起動したいとき

なお，次の構成の場合，adbmonitorコマンドはHAモニタのserversファイル（サーバ対応の環境を設定する定義ファイル）に指定するシェルコマンドで使用します。

HAモニタありのマルチノード構成

コールドスタンバイ構成

39.2　adbmonitorコマンドの指定形式

adbmonitorコマンドの指定形式，およびオプションの形式について説明します。

adbmonitorコマンドを実行できるOSユーザを次に示します。

HADB管理者

39.2.1　指定形式およびオプションの説明

(1)　指定形式

adbmonitor 〔-r 〔-c 再開始のリトライ回数〕 〔-e〕〕 〔-n〕 〔-i〕

(2)　オプションの説明

●-r

監視対象のHADBサーバが異常終了した場合に，HADBサーバを自動的に再開始したいときに指定します。HADBサーバが自動的に再開始したあと，このコマンドは，再びHADBサーバの監視を継続します。

また，HADBサーバを再開始した場合に，サーバディレクトリのspoolディレクトリ下に，light版トラブルシュート情報ファイルが出力されます。このlight版トラブルシュート情報ファイルは，定期的に削除してください。削除しないと，サーバディレクトリを格納するディスクの空き容量が不足する原因になります。

このオプションの指定を省略した場合，監視対象のHADBサーバが異常終了すると，このコマンドは異常終了します（リターンコード8が返されます）。

●-c 再開始のリトライ回数

〜〈整数〉((1〜300))

-rオプションを指定する場合に，HADBサーバの開始をリトライする回数を指定します。HADBサーバの再開始に失敗した場合，指定した再開始のリトライ回数だけ，1秒間隔でHADBサーバの開始を実行します。

このオプションの指定を省略した場合，HADBサーバの再開始に失敗しても，HADBサーバの開始をリトライしません。

●-e

監視対象のHADBサーバがDBエリア暗号化機能を使用している場合に指定します。このオプションを指定すると，adbmonitorコマンド実行時に一度だけ，HADB暗号鍵利用パスワードの入力を求めるKFAA90013-Qメッセージが出力されます。KFAA90013-Qメッセージに従って，HADB暗号鍵利用パスワードを入力してください。

重要

誤ったHADB暗号鍵利用パスワードを入力した場合，HADBサーバが異常終了したときにHADBサーバの再開始に失敗します。必ず正しいHADB暗号鍵利用パスワードを入力してください。

DBエリア暗号化機能については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を参照してください。

●-n

監視対象のHADBサーバが正常終了した場合に，このコマンドを終了しないでHADBサーバの監視を続行したいときに指定します。監視対象のHADBサーバが正常終了したあとで，再び正常開始すると，このコマンドは再び監視を開始します。

このオプションの指定を省略した場合，監視対象のHADBサーバが正常終了すると，このコマンドは正常終了します（リターンコード0が返されます）。

●-i

adbmonitorコマンド実行時点のHADBサーバの状態を示すリターンコードをすぐに返したいときに指定します。

このオプションの指定を省略した場合，ほかのオプションの指定値に従い，HADBサーバの監視を継続します。

-iオプション指定時のHADBサーバの状態とリターンコードの関係を，次の表に示します。

表39‒1　-iオプション指定時のHADBサーバの状態とリターンコードの関係

項番

HADBサーバの状態

リターンコード

1

ACTIVE

0

2

STOP

4

3

STARTING

0

4

STOPPING

0

5

ABORT

8

6

QUIESCE

0

7

OFFLINE

0

8

MAINTNCE

0

9

CHGMODE

0

10

STOPWAIT

0

11

COREDUMP

0

12

FORCE

8

HADBサーバの状態とadbmonitorコマンドの各オプションの関係を，次の表に示します。

表39‒2　HADBサーバの状態とadbmonitorコマンドの各オプションの関係

項番

HADBサーバの状態

オプションの指定

オプションの指定なし

-rオプションだけを指定

-nオプションだけを指定

-rおよび-nオプションを指定

1

ACTIVE

監視を続行します。

監視を続行します。

監視を続行します。

監視を続行します。

2

STOP

adbmonitorコマンドが正常終了します。

adbmonitorコマンドが正常終了します。

監視を続行します。

監視を続行します。

3

STARTING

監視を続行します。

監視を続行します。

監視を続行します。

監視を続行します。

4

STOPPING

5

ABORT

adbmonitorコマンドが異常終了します。

HADBサーバを自動的に再開始して，監視を続行します。また，light版トラブルシュート情報を取得します。

adbmonitorコマンドが異常終了します。

HADBサーバを自動的に再開始して，監視を続行します。また，light版トラブルシュート情報を取得します。

6

QUIESCE

監視を続行します。

監視を続行します。

監視を続行します。

監視を続行します。

7

OFFLINE

8

MAINTNCE

9

CHGMODE

10

STOPWAIT

11

COREDUMP

12

FORCE

adbmonitorコマンドが異常終了します。

adbmonitorコマンドが異常終了します。

adbmonitorコマンドが異常終了します。

adbmonitorコマンドが異常終了します。

39.3　リターンコード

adbmonitorコマンドのリターンコードを次の表に示します。

表39‒3　adbmonitorコマンドのリターンコード

リターンコード

意味

0

-iオプションを指定しない場合

adbmonitorコマンドの監視対象のHADBサーバが正常終了しました。

-iオプションを指定した場合

adbmonitorコマンドの監視対象のHADBサーバが稼働中です。

4

-iオプションを指定しない場合

該当しません。

-iオプションを指定した場合

adbmonitorコマンドの監視対象のHADBサーバが正常終了しました。

8

adbmonitorコマンドの監視対象のHADBサーバが強制終了，または異常終了しました。

39.4　注意事項

監視対象のHADBサーバがDBエリア暗号化機能を使用していない場合，-eオプションを指定するとエラーとなります。

-eオプションを指定したadbmonitorコマンドで，DBエリア暗号化機能を使用しているHADBサーバを監視中に，adbupddmkコマンドで，使用中のHADB暗号鍵を新しいHADB暗号鍵に変更すると，HADBサーバが異常終了した場合のHADBサーバの再開始に失敗します。そのため，adbupddmkコマンドでHADB暗号鍵を変更したときは，監視中のadbmonitorコマンドをいったん終了してください。そのあと，再度adbmonitorコマンドを実行し，新しいHADB暗号鍵のHADB暗号鍵利用パスワードを入力してHADBサーバの監視を再開してください。adbupddmkコマンドについては「48.　adbupddmk（HADB暗号鍵の更新）」を参照してください。

40　adboptinstall（HADBオプションのインストールおよびアンインストール）

この章では，adboptinstallコマンドの機能と使い方について説明します。

40.1　機能

adboptinstallコマンドを実行すると，HADBオプションをインストールまたはアンインストールすることができます。

クラウドストレージ機能を使用する場合は，HADBオプションをインストールする必要があります。クラウドストレージ機能の詳細については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

40.2　adboptinstallコマンドの指定形式

adboptinstallコマンドの指定形式およびオプションについて説明します。

adboptinstallコマンドを実行できるOSユーザは，HADB管理者だけです。

40.2.1　指定形式およびオプションの説明

(1)　指定形式

/install/adboptinstall 〔-d〕 ｛s3option｜azoption｝

下線部には，adboptinstallコマンドの実行形式ファイルを格納したディレクトリ（インストールデータを格納するディレクトリ）を絶対パスで指定してください。

(2)　オプションの説明

●-d

HADBオプションをアンインストールする場合に指定します。

●s3option

AWS用のHADBオプションをインストールまたはアンインストールする場合に指定します。

●azoption

Azure用のHADBオプションをインストールまたはアンインストールする場合に指定します。

40.3　リターンコード

adboptinstallコマンドのリターンコードを次の表に示します。

表40‒1　adboptinstallコマンドのリターンコード

リターンコード

意味

0

adboptinstallコマンドが正常に終了しました。

4

adboptinstallコマンドが警告メッセージを出力して終了しました。表示されたメッセージを確認して対処してください。

8

adboptinstallコマンドの実行中にエラーが発生しました。表示されたメッセージを確認して対処してください。

40.4　注意事項

HADBサーバのインストールが完了したあとに，adboptinstallコマンドでHADBオプションをインストールしてください。

HADBサーバとHADBオプションのバージョンが対応している必要があります。HADBサーバとHADBオプションのバージョンの不一致によってadboptinstallコマンドがエラーとなった場合は，次のどちらかの対処をしてください。

HADBサーバのバージョンに対応しているHADBオプションをインストールしてください。

HADBオプションのバージョンに対応しているHADBサーバをインストールし直して，そのあとにHADBオプションをインストールしてください。

adboptinstallコマンドは，HADBサーバを終了させてから実行してください。

adboptinstallコマンドを実行する前に，次の作業を実施してください。

■/usr/local/lib64ディレクトリが存在しない場合

rootで/usr/local/lib64ディレクトリを作成してください。

HADB管理者がroot以外のOSユーザの場合は，HADB管理者に/usr/local/lib64ディレクトリへの読み取り権限および実行権限を付与してください。権限の付与は，rootで次のコマンドを実行してください。

HADB管理者が，rootグループに所属していないその他のOSユーザのとき

chmod o+rx /usr/local/lib64

HADB管理者が，rootグループに所属しているOSユーザのとき

chmod g+rx /usr/local/lib64

■/usr/local/lib64ディレクトリが存在する場合

次のファイルが存在するときは，ファイルのバックアップを取得してください。

＜AWS環境の場合＞

libaws-cpp-sdk-s3-crt.so
libaws-cpp-sdk-core.so

＜Azure環境の場合＞

libazure-storage-blobs.so
libazure-storage-common.so
libazure-identity.so
libazure-core.so

rootに/usr/local/lib64ディレクトリへの書き込み権限，読み取り権限および実行権限を付与してください。

HADB管理者がroot以外のOSユーザの場合は，HADB管理者に/usr/local/lib64ディレクトリへの読み取り権限および実行権限を付与してください。権限の付与は，rootで次のコマンドを実行してください。

HADB管理者が，rootグループに所属していないその他のOSユーザのとき

chmod o+rx /usr/local/lib64

HADB管理者が，rootグループに所属しているOSユーザのとき

chmod g+rx /usr/local/lib64

インストールCD-ROMに格納されている次のファイル（インストールデータ）は，同じディレクトリに格納してください。同じディレクトリに格納しないと，HADBオプションをインストールできません。

HADBオプション用のtar.gz形式のファイル

adboptinstallコマンドの実行形式ファイル

インストールデータを格納するディレクトリには，HADB管理者がアクセスできるように，書き込み権限，読み取り権限および実行権限を付与してください。

また，adboptinstallコマンドは次のディレクトリにアクセスします。

サーバディレクトリ

サーバディレクトリ下のlibディレクトリ

上記のディレクトリにアクセスできない場合，KFAA91581-EメッセージまたはKFAA91583-Eメッセージが出力され，adboptinstallコマンドがエラーとなります。その場合，上記のディレクトリに対して書き込み権限，読み取り権限および実行権限を付与したあとで，adboptinstallコマンドを再実行してください。

HADB管理者として設定したOSユーザではなく，rootでadboptinstallコマンドを実行した場合は，警告メッセージ（KFAA91558-Wメッセージ）が出力されます。通常は，HADB管理者として設定したOSユーザで，adboptinstallコマンドを実行します。そのため，KFAA91558-Wメッセージが出力された場合は，rootでadboptinstallコマンドを実行して問題がないかどうかを確認してください。

問題がある場合は，KFAA91558-Wメッセージが出力されたあとに出力されるKFAA91559-Qメッセージの入力要求に対してy（またはY）以外で応答して処理を中止してください。そのあとで，HADB管理者として設定したOSユーザでadboptinstallコマンドを実行してください。

なお，root以外のスーパユーザでadboptinstallコマンドを実行した場合は，KFAA91558-Wメッセージは出力されません。

メモ

rootは，OSのid -uコマンドを実行して表示される値が0のユーザを指します。また，OSのsuコマンドを使用して，ほかのOSユーザからrootに切り替えたあとで，OSのid -uコマンドを実行して表示される値が0のときも含みます。

adboptinstallコマンドを実行してクラウドストレージ機能をインストールすると，AWS SDK for C++ライブラリ※も同時にインストール（/usr/local/lib64ディレクトリへの書き込み）されるため，adboptinstallコマンド内部でOSのsuコマンドが実行されます。このときrootのパスワードの入力が要求されるため，adboptinstallコマンドを実行する前にrootのパスワードを設定しておいてください。

注※

Azure環境の場合は，Azure SDK for C++ライブラリになります。

adboptinstallコマンド内部でOSのsuコマンドが実行されると，rootのパスワードの入力を要求するOSメッセージが出力されます。OSメッセージの指示に従いパスワードを入力してください。なお，OSのsuコマンドに失敗した場合，adboptinstallコマンドのリターンコードは8となります。

adboptinstallコマンドを実行してクラウドストレージ機能をインストールすると，AWS SDK for C++ライブラリ※をインストール（または上書きインストール）するかどうかを確認する，KFAA91585-Qメッセージが出力されることがあります。メッセージが出力された場合は，メッセージの指示に従って応答してください。このとき，y（またはY）以外で応答すると，AWS SDK for C++ライブラリ※をインストール（または上書きインストール）しないで処理が続行されます。

注※

Azure環境の場合は，Azure SDK for C++ライブラリになります。

rootのパスワードが設定できない環境の場合，suコマンドが実行された際にrootのパスワードが入力できないため，adboptinstallコマンドによるAWS SDK for C++ライブラリ※のインストールができません。そのため，AWS SDK for C++ライブラリ※をインストール（または上書きインストール）するかどうかを確認するKFAA91585-Qメッセージが出力された際は，n（またはN）で応答して，AWS SDK for C++ライブラリ※をインストールしないで処理を続行させてください。そのあと，手動でAWS SDK for C++ライブラリ※をインストールしてください。

手動でAWS SDK for C++ライブラリまたはAzure SDK for C++ライブラリをインストールする手順については，マニュアルHADB　システム構築・運用ガイドのHADBオプションのインストール手順のAWS SDK for C++ライブラリのインストール手順またはAzure SDK for C++ライブラリのインストール手順を参照してください。

注※

Azure環境の場合は，Azure SDK for C++ライブラリになります。

adboptinstallコマンド実行時に環境変数ADBDIRに指定されたパスのサーバディレクトリが存在しない場合，KFAA91581-Eメッセージが出力され，adboptinstallコマンドがエラーとなります。

adboptinstallコマンドの延長でOSのコマンドが実行されます。このOSのコマンドの実行に失敗した場合，標準エラー出力にエラーメッセージが出力されます。この場合，出力されたエラーメッセージを参照してエラー要因を取り除いて，そのあとにadboptinstallコマンドを再実行してください。

adboptinstallコマンドの実行後，HADBオプションが正常にインストールされていることを，次の手順で確認してください。

次のファイルが格納されていることを確認してください。

＜AWS環境の場合＞

$ADBDIR/lib/libadbcldstge-aws.so
/usr/local/lib64/libaws-cpp-sdk-s3-crt.so
/usr/local/lib64/libaws-cpp-sdk-core.so

＜Azure環境の場合＞

$ADBDIR/lib/libadbcldstge-azure.so
/usr/local/lib64/libazure-storage-blobs.so
/usr/local/lib64/libazure-storage-common.so
/usr/local/lib64/libazure-identity.so
/usr/local/lib64/libazure-core.so

サーバディレクトリ下に，次のファイルがあることを確認してください。

＜AWS環境の場合＞

adboptinst_s3option.log

＜Azure環境の場合＞

adboptinst_azoption.log

adboptinst_s3option.logファイルまたはadboptinst_azoption.logファイルを開いて内容を確認してください。正常にインストールされている場合は，次のどちらかの情報が出力されています。

P-aaaa-bbbb Hitachi Advanced Data Binder vv-rr (yyyymmddhhmmss)
P-aaaa-bbbb Hitachi Advanced Data Binder vv-rr-/s (yyyymmddhhmmss)

P-aaaa-bbbbは，HADBサーバのPP形名情報を示しています。

vv-rrおよびvv-rr-/sは，HADBサーバのバージョンを示しています。

yyyymmddhhmmssは，インストールした日付および時刻を示しています。

メモ

adboptinst_s3option.logファイル※がすでにある状態でadboptinstallコマンドを実行すると，adboptinst_s3option.logファイル※の内容が更新されます。また，adboptinstallコマンドを複数回実行した場合，adboptinst_s3option.logファイル※の内容は，最後に実行した日付および時刻に更新されます。

adboptinstallコマンドのリターンコード（KFAA91552-Iメッセージに出力されるリターンコード）が0または4以外の場合，adboptinst_s3option.logファイル※の内容は更新されません。

注※

Azure環境の場合は，adboptinst_azoption.logファイルになります。

adboptinstallコマンドでHADBオプションをアンインストールした場合，アンインストール後に次の作業を実施してください。

HADB管理者であるOSユーザで，次に示すファイルを手動で削除してください。

＜AWS環境の場合＞

$ADBDIR/adboptinst_s3option.log

＜Azure環境の場合＞

$ADBDIR/adboptinst_azoption.log

＜AWS環境の場合＞

次に示すAWS SDK for C++ライブラリを手動で削除してください。なお，HADB以外でAWS SDK for C++ライブラリを使用している場合は，削除は不要です。

/usr/local/lib64/libaws-cpp-sdk-s3-crt.so
/usr/local/lib64/libaws-cpp-sdk-core.so

＜Azure環境の場合＞

次に示すAzure SDK for C++ライブラリを手動で削除してください。なお，HADB以外でAzure SDK for C++ライブラリを使用している場合は，削除は不要です。

/usr/local/lib64/libazure-storage-blobs.so
/usr/local/lib64/libazure-storage-common.so
/usr/local/lib64/libazure-identity.so
/usr/local/lib64/libazure-core.so

41　adbreorgsystemdata（システム表の再編成）

この章では，adbreorgsystemdataコマンドの機能と使い方について説明します。

なお，この章の「システム表」は「システム表（実表）」を意味しています。

41.1　機能

この節では，adbreorgsystemdataコマンドの機能について説明します。

adbreorgsystemdataコマンドは，コマンド実行時にHADBサーバに接続します。

41.1.1　機能概要

実表に対してSQL文やコマンドを実行すると，システム表に無効な行データが増加することがあります。システム表内の無効な行データが増加し続けると，次に示す影響があります。

システム表を格納するディスクの空き容量が不足する

検索時に参照するシステム表用DBエリアのページ数が増加するため，検索性能が低下する

adbreorgsystemdataコマンドを実行すると，システム表のデータが再編成され，無効な行データの領域を解放できます。この処理を，システム表の再編成処理といいます。

システム表の再編成処理の概要を次の図に示します。

図41‒1　システム表の再編成処理の概要

［説明］

システム表の再編成処理は，次に示す2つのフェーズで実行されます。

フェーズ1

無効な行データを除いたシステム表のデータが，アンロードファイルに格納されます（アンロード処理）。次に，アンロードファイルのデータが再編成後のデータとして，システム表に再格納されます（リロード処理）。

フェーズ2

再編成前のデータが削除され，システム表内の無効な行データの領域が解放されます。

各ファイルについて次に説明します。

作業用一時ファイル

システム表の再編成処理中に一時的に作成される作業用のファイルです。作成された作業用一時ファイルは，再編成処理が終了すると自動で削除されます。

アンロードファイル

システム表の再編成処理中に一時的に作成されるファイルです。無効な行データを除いたシステム表のデータが格納されます。作成されたアンロードファイルは，再編成処理が終了すると自動で削除されます。

メモ

システム表に無効な行データが増加するタイミングについては，マニュアルHADB　システム構築・運用ガイドのシステム表を再編成する理由を参照してください。

41.1.2　adbreorgsystemdataコマンドのオプション機能

adbreorgsystemdataコマンドには，次に示すオプション機能があります。

再編成前データの削除機能

(1)　再編成前データの削除機能

adbreorgsystemdataコマンドが正常に終了しなかった場合，再編成前のデータがシステム表に残ることがあります。

このとき，同じシステム表に対してadbreorgsystemdataコマンドを再実行すると，残ったデータを削除できます。この機能を，再編成前データの削除機能といいます。

再編成前データの削除機能の概要を次の図に示します。

図41‒2　再編成前データの削除機能の概要

メモ

ほかの処理が再編成前のデータを参照している場合は，adbreorgsystemdataコマンドがエラーになります。再編成前のデータは削除されません。

再編成前のデータがシステム表に残るケースについては，「41.4　リターンコード」を参照してください。

41.2　adbreorgsystemdataコマンドの指定形式

adbreorgsystemdataコマンドの指定形式およびオプションについて説明します。

adbreorgsystemdataコマンドを実行できるOSユーザを次に示します。

HADB管理者

41.2.1　指定形式およびオプションの説明

(1)　指定形式

adbreorgsystemdata 〔-g 再編成処理の経過メッセージの出力間隔〕
                   〔-w 作業用一時ファイルの格納先ディレクトリ名〕
                   〔--timeout タイムアウト時間〕
                     -c table
                     -f アンロードファイルの格納先を指定したディレクトリパスファイル名
                     -n 処理対象表

(2)　オプションの説明

●-g 再編成処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

再編成処理の経過メッセージの出力間隔を指定します。例えば，このオプションに2を指定すると，データが2,000行処理されるごとに経過メッセージ（KFAA80205-I）が出力されます。

なお，経過メッセージは，アンロード処理とリロード処理で別々に出力されます。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-w 作業用一時ファイルの格納先ディレクトリ名

〜〈OSパス名〉((2〜518バイト))《$DBDIR/ADBWORK》

再編成時に一時的に作成される作業用一時ファイルの格納先を，絶対パス名で指定します。

このオプションの指定規則を次に示します。

パス名の末尾にスラッシュ（/）を指定しないでください。

-wオプションに指定したディレクトリ下に作成される作業用一時ファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのadbreorgsystemdataコマンド実行時の作業用一時ファイルの容量見積もりを参照してください。なお，このオプションを省略した場合，$DBDIR/ADBWORK下に作業用一時ファイルが作成されます。

作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

メモ

作業用一時ファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●--timeout タイムアウト時間

〜〈整数〉((0〜65,535))《3,600》（単位：秒）

adbreorgsystemdataコマンドがタイムアウトになるまでの時間を指定します。

adbreorgsystemdataコマンドの実行時間がこのオプションで指定した時間を超えた場合，adbreorgsystemdataコマンドの処理はキャンセルされます。

このオプションの指定を省略した場合，adbreorgsystemdataコマンドは3,600秒（1時間）でタイムアウトします。

このオプションに0を指定した場合，adbreorgsystemdataコマンドのタイムアウト時間は設定されません。adbreorgsystemdataコマンドの処理に時間が掛かっても，タイムアウトしないでコマンドの処理が続行されます。

メモ

adbreorgsystemdataコマンドの実行時間が長くなるとシステムの運用に支障が出る場合は，タイムアウト時間の指定を検討してください。

■マルチノード機能を使用している場合

次に示す状態のときは，このオプションで指定したタイムアウト時間が経過しても，adbreorgsystemdataコマンドの処理はすぐにはキャンセルされません。次に示す状態が解消されたあとで，adbreorgsystemdataコマンドの処理がキャンセルされます。

プライマリノードの切り替え処理中

ノードの復帰処理中

ワーカーノードの追加処理中

他ノードで実行中のトランザクションの終了待ち中

●-c table

adbreorgsystemdataコマンドの処理対象として，表を指定します。

●-f アンロードファイルの格納先を指定したディレクトリパスファイル名

〜〈OSパス名〉((2〜510バイト))

再編成処理時に一時的に作成されるアンロードファイルの格納先を指定したファイル名（ディレクトリパスファイル名）を，絶対パス名で指定します。

アンロードファイルの格納先を指定したディレクトリパスファイルの指定例を次に示します。

ディレクトリパスファイルの指定例

/home/adbmanager/unld

ディレクトリパスファイルの指定規則を次に示します。

ディレクトリパスファイル中に，アンロードファイルの格納先ディレクトリを1つ指定できます。

アンロードファイルの格納先ディレクトリは，2〜510バイトの絶対パスで指定してください。

アンロードファイルの格納先ディレクトリのパス名として使用できる文字は，アンロードファイルの格納先を指定したディレクトリパスファイル名と同じです。

アンロードファイルの格納先ディレクトリのパス名中の空白は無視されません。パス名の先頭や末尾の空白についても，パス名の一部として扱われます。

ディレクトリパスファイル中の改行文字だけの行は無視されます。

-fオプションに指定したディレクトリ下に作成されるアンロードファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのアンロードファイルの容量見積もりを参照してください。

なお，アンロードファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。アンロードファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのアンロードファイルを格納するディスクの空き容量が不足したときの対処方法を参照してください。

メモ

アンロードファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●-n 処理対象表

再編成処理の対象となるシステム表を指定します。

処理対象表には，次に示すシステム表の表名を指定できます。

STATUS_TABLES

STATUS_COLUMNS

STATUS_INDEXES

STATUS_CHUNKS

STATUS_SYNONYM_DICTIONARIES

41.3　使用例

adbreorgsystemdataコマンドを実行してデータを再編成する方法を，例題形式で説明します。

41.3.1　システム表を再編成する場合

システム表用DBエリアに格納されているシステム表STATUS_CHUNKSを再編成します。

このとき，次に示す手順でadbreorgsystemdataコマンドを実行します。

手順

アンロードファイルの格納先を指定したディレクトリパスファイルを作成する

adbreorgsystemdataコマンドを実行する

各手順の例を以降で説明します。

(1)　アンロードファイルの格納先を指定したディレクトリパスファイルを作成する

アンロードファイルの格納先を指定したディレクトリパスファイル（/home/adbmanager/reorg_file/unldpath.txt）を作成して，アンロードファイルの格納場所を指定します。

アンロードファイルの格納先を指定したディレクトリパスファイルの指定例

/home/adbmanager/unld

(2)　adbreorgsystemdataコマンドを実行する

adbreorgsystemdata --timeout 300                                  ...1
                   -c table                                       ...2
                   -f /home/adbmanager/reorg_file/unldpath.txt    ...3
                   -n STATUS_CHUNKS                               ...4

［説明］

adbreorgsystemdataコマンドがタイムアウトするまでの時間として，300秒（5分）を指定します。

再編成処理の対象として，表を指定します。

「(1)　アンロードファイルの格納先を指定したディレクトリパスファイルを作成する」で作成した，アンロードファイルの格納先を指定したディレクトリパスファイル名を指定します。

処理対象表として，システム表STATUS_CHUNKSを指定します。

41.4　リターンコード

adbreorgsystemdataコマンドのリターンコードを次の表に示します。

表41‒1　adbreorgsystemdataコマンドのリターンコード

リターンコード

意味

0

adbreorgsystemdataコマンドが正常に終了しました。

4

adbreorgsystemdataコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

adbreorgsystemdataコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。

このとき，処理対象表はadbreorgsystemdataコマンド実行前の状態です。異常終了した原因を取り除いたあとで，adbreorgsystemdataコマンドを再実行してください。

12

adbreorgsystemdataコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。

このとき，処理対象表には，再編成前のデータおよび再編成後のデータの両方が存在しています。異常終了した原因を取り除いたあとで，adbreorgsystemdataコマンドを再実行してください。

16

adbreorgsystemdataコマンドの実行中に，HADBサーバとの通信が切断されました。

HADBサーバとの通信が切断された原因については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。なお，adbreorgsystemdataコマンドがタイムアウトした場合は，KFAA96609-Eメッセージが出力されます。

このリターンコードが出力された場合の対処については，KFAA80204-Iメッセージに出力されるリターンコード（0，4，8または12）を参照してください。ただし，adbreorgsystemdataコマンド実行中にadbstop --forceコマンドでHADBサーバを強制終了した場合は，KFAA80204-Iメッセージが出力されないことがあります。この場合は，HADBサーバを開始したあとで，adbreorgsystemdataコマンドを再実行してください。

41.5　adbreorgsystemdataコマンドが異常終了したときの対処方法

adbreorgsystemdataコマンドが異常終了した場合の対処方法は，コマンドのリターンコードによって異なります。

対処方法の詳細については，「41.4　リターンコード」を参照してください。

41.6　注意事項

adbreorgsystemdataコマンドが使用する処理リアルスレッド数は3です。コマンドまたはAPの実行中にadbreorgsystemdataコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbreorgsystemdataコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

また，使用できる処理リアルスレッドはクライアントグループ機能を適用しているかどうかによって変わります。詳細はマニュアルHADB　システム構築・運用ガイドのグループの処理リアルスレッド数を設定する際の考慮点を参照してください。

adbreorgsystemdataコマンドの実行中は，アンロードファイルに対して，ほかのアプリケーションによる読み込みや書き込みを行わないでください。

adbreorgsystemdataコマンドのオプションに指定するファイルの改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

adbreorgsystemdataコマンドの実行を中断する場合は，adbcancelコマンドで中断させてください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

システム表の再編成処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbreorgsystemdataコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のシステム表の再編成処理は中断されません（処理が続行されます）。再編成処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

システム表の再編成処理中に作業用のファイル（作業用一時ファイル）が一時的に作成されます。作業用一時ファイルは，adbreorgsystemdataコマンドが正常に終了した場合（リターンコードが0または4），および再編成前のデータの削除に失敗した場合（リターンコードが12）は自動的に削除されます。ただし，adbreorgsystemdataコマンドが正常に終了しなかった場合は，作業用一時ファイルが削除されないことがあります。

このとき，処理対象表および-wオプションを変更しないでadbreorgsystemdataコマンドを再実行すると，残った作業用一時ファイルはコマンドの正常終了時に自動で削除されます。このため，作業用一時ファイルが残っていても問題はありません。ただし，adbreorgsystemdataコマンドの再実行前にディスクの空き容量を増やしたい場合は，作業用一時ファイルを削除してください。

システム表の再編成処理中に，無効な行データを除いたシステム表のデータを格納するファイル（アンロードファイル）が一時的に作成されます。アンロードファイルは，adbreorgsystemdataコマンドが正常に終了した場合（リターンコードが0または4），および再編成前のデータの削除に失敗した場合（リターンコードが12）は自動的に削除されます。ただし，adbreorgsystemdataコマンドが正常に終了しなかった場合は，アンロードファイルが削除されないことがあります。

このとき，処理対象表および-fオプションを変更しないでadbreorgsystemdataコマンドを再実行すると，残ったアンロードファイルはコマンドの正常終了時に自動で削除されます。このため，アンロードファイルが残っていても問題はありません。

-fオプションを変更してadbreorgsystemdataコマンドを再実行する場合は，変更前のアンロードファイルの格納先ディレクトリを確認してください。アンロードファイルが残っているときは，アンロードファイルを削除してください。

なお，アンロードファイルは，処理対象表1つにつき1ファイル出力されます。アンロードファイルのファイル名を次に示します。

アンロードファイルのファイル名

reorganize-unload-[表ID]-00001

表ID：処理対象表の表IDを16進数に変換した8桁の文字列

adbreorgsystemdataコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbreorgsystemdataコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表41‒2　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※

必要な権限

作業用一時ファイルの格納先ディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

アンロードファイルの格納先を指定したディレクトリパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

アンロードファイルの格納先を指定したディレクトリパスファイルに指定するアンロードファイルの格納先ディレクトリ

HADBサーバプロセスの実行ユーザ

書き込み権限

実行権限

注※

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

42　adbsql（SQLの実行）

この章では，adbsqlコマンドの機能と使い方について説明します。

42.1　機能

adbsqlコマンドを使用すると，会話形式でSQL文を実行できます。標準入力からSQL文を入力し，その実行結果を標準出力に出力できます。

adbsqlコマンドは，HADBクライアントとしてHADBサーバに接続します。

adbsqlコマンドで実行できるSQL文を次に示します。

定義系SQL

ALTER TABLE

ALTER USER

ALTER VIEW

CREATE AUDIT

CREATE INDEX

CREATE SCHEMA

CREATE TABLE

CREATE USER

CREATE VIEW

DROP AUDIT

DROP INDEX

DROP SCHEMA

DROP TABLE

DROP USER

DROP VIEW

GRANT

REVOKE

操作系SQL

DELETE

INSERT

SELECT

UPDATE

TRUNCATE TABLE

PURGE CHUNK

SQL文中に？パラメタを指定できます。詳細については，「42.6　SQL文中に？パラメタを指定した場合の操作方法」を参照してください。

制御系SQL

COMMIT

ROLLBACK

また，adbsqlサブコマンドも実行できます。adbsqlサブコマンドを使用してHADBからの切り離しなどを行います。adbsqlサブコマンドについては，「42.5　adbsqlサブコマンド」を参照してください。

adbsqlコマンドを使用する際の前提条件

adbsqlコマンドは，クライアント定義を使用してHADBサーバに接続します。そのため，HADBクライアントの環境設定および環境変数の設定が必要になります。HADBクライアントの環境設定および環境変数の設定については，マニュアルHADB　AP開発ガイドのHADBクライアントの環境設定（ODBCドライバおよびCLI関数を使用する場合）を参照してください。

メモ

adbsqlコマンドは，既定のクライアント定義ファイル（$ADBCLTDIR/conf/client.def）を使用してHADBサーバに接続します。既定以外のクライアント定義ファイルを使用したい場合は，-zオプションで指定してください。

また，HADBサーバに接続するには，CONNECT権限を持つHADBユーザの認可識別子で接続する必要があります。

42.2　adbsqlコマンドの指定形式

adbsqlコマンドの指定形式およびオプションについて説明します。

adbsqlコマンドを実行できるOSユーザに制限はありません。

42.2.1　指定形式およびオプションの説明

(1)　指定形式

adbsql
  〔-u 認可識別子 〔-p パスワード〕〕
  〔-s 〔-b〕〕
  〔-V〕
  〔-d〕
  〔-z クライアント定義ファイル名〕

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

HADBサーバに接続する認可識別子を指定します。CONNECT権限を持つHADBユーザの認可識別子を指定してください。

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-s

SELECT文およびadbsqlサブコマンド#GETDATAの検索結果を標準出力にCSV形式で出力したい場合に指定します。リダイレクションでファイルに出力すると，adbimportコマンドで使用する入力データファイルが作成できます。

出力される項目を次に示します。

SELECT文およびadbsqlサブコマンド#GETDATAの検索結果

SELECT文およびadbsqlサブコマンド#GETDATAのエラーメッセージ

規則および注意事項を次に示します。

-sオプションを指定した場合は，-uオプションおよび-pオプションを必ず指定してください。

-sオプションと-Vオプションは同時に指定できません。

-sオプションを指定してadbsqlコマンドを開始した場合，adbsqlサブコマンドの#SET DISPLAYは実行できません。

囲み文字には二重引用符（"）が出力され，区切り文字にはコンマ（ , ）が出力されます。

検索項目列のデータ型が配列型以外の場合，検索項目列の列値全体が二重引用符（"）で囲まれて出力されます。

検索項目列の列値に二重引用符（"）が含まれている場合，二重引用符（"）が2個連続で出力されます。

出力例

"ABC"     ←列値がABCの場合

"XY""Z"   ←列値がXY"Zの場合

検索項目列のデータ型が配列型の場合，検索項目列の列値全体が波括弧（{}）で囲まれ，さらに二重引用符（"）で囲まれて出力されます。各配列要素は，二重引用符（"）2個で囲まれ，コンマ（,）で区切られます。

配列要素の値に二重引用符（"）が含まれている場合，二重引用符（"）が4個連続で出力されます。

出力例

"{""AAA"",""BBB"",""CCC""}"        ←配列要素の値がAAA，BBB，CCCの場合

"{""XXX"",""YY""""Y"",""ZZZ""}"    ←配列要素の値がXXX，YY"Y，ZZZの場合

長さ0の文字列の場合，囲み文字だけが出力されます。

ナル値の場合，囲み文字は出力されません。

配列型の列のナル値については，次のように出力されます。

列値がナル値の場合，データは出力されません。

配列要素がナル値の場合，NULLが出力されます。

SELECT文以外のSQL文は指定できません。

●-b

-sオプションを指定する場合に，バイナリデータを2進形式で出力したいときに指定します。

●-V

このオプションを指定すると，SQL文の実行結果のほかに，実行したSQL文の内容も出力されます。また，adbsqlサブコマンドを実行した場合，adbsqlサブコマンドの実行結果のほかに，実行したadbsqlサブコマンドの内容も出力されます。

このオプションを指定した場合と指定しない場合の違いを次に示します。

ファイル（infile）に記述したSQL文をリダイレクションでファイルから入力して実行する場合

（例1）

adbsql < infile

この場合，標準出力には，SQL文の実行結果だけが出力されます。

（例2）

adbsql -V < infile

この場合，標準出力には，SQL文の実行結果のほかに，実行したSQL文の内容が出力されます。

SQL文の実行結果をリダイレクションでファイル（outfile）に出力する場合

（例3）

adbsql > outfile

この場合，ファイルには，SQL文の実行結果だけが出力されます。

（例4）

adbsql -V > outfile

この場合，ファイルには，SQL文の実行結果のほかに，実行したSQL文の内容が出力されます。

●-d

10進数のデータの位取りが0の場合に，小数点を省略して実行結果を出力したいときに指定します。

（例）実行結果が10.の場合の出力例

-dオプションを指定していない場合：10.

-dオプションを指定している場合：10

●-z クライアント定義ファイル名

〜〈OSパス名〉((2〜510バイト))

adbsqlコマンドで使用するクライアント定義ファイルの絶対パス名を指定します。空白を含むパス名を指定する場合は，アポストロフィ（'）で囲んで指定してください。

このオプションは，既定以外のクライアント定義ファイルを使用してadbsqlコマンドを実行したい場合に指定します。このオプションを省略した場合，既定のクライアント定義ファイル（$ADBCLTDIR/conf/client.def）を使用してadbsqlコマンドが実行されます。

42.3　使用例

adbsqlコマンドを実行して，SQL文を実行する方法を例題形式で説明します。

重要

adbsqlコマンドでSQL文を実行する場合，SQL文の終わりにセミコロン（ ; ）が必要になります。必ず指定してください。

42.3.1　標準入力からSQL文を実行する場合

SELECT文で表T1の検索を行います。

adbsqlコマンドを開始する

adbsql

-uオプション（認可識別子）を指定した場合，手順2.はスキップされて，手順3.に進みます。-uオプション（認可識別子）および-pオプション（パスワード）を指定した場合，手順2.および手順3.はスキップされて，手順4.に進みます。

認可識別子の入力要求に応答する

USER-ID ?
ADBUSER01

CONNECT権限，および表T1に対するSELECT権限を持つHADBユーザの認可識別子を指定して，［Enter］キーを押してください。ここで指定した認可識別子でHADBサーバに接続します。

パスワードの入力要求に応答する

PASSWORD ?

HADBサーバに接続するHADBユーザの認可識別子のパスワードを指定して［Enter］キーを押してください。入力した文字は表示されません。

SELECT文を実行する

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT 'C1 = ',"C1" FROM "T1";                        ...1
 EXP0001_NO_NAME C1                                   ...2
 --------------- ----------------
           C1 =   -123456789.1234
           C1 =  ****************
KFAA96404-I 2 rows were selected.

［説明］

1．実行するSELECT文です。SQL文の終わりにセミコロン（ ; ）を記述してください。

2．この行以降は，SELECT文の実行結果です。SQL文の実行結果の表示形式については，「42.7　SQL文の実行結果の出力形式」を参照してください。

adbsqlコマンドを終了する

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
#EXIT;

adbsqlサブコマンドの#EXITを実行して，adbsqlコマンドを終了します。

表示されるプロンプトについて

adbsqlコマンドを実行すると，次の表に示すどれかのプロンプトが表示されます。

表42‒1　SQL文またはadbsqlサブコマンドの入力画面で表示されるプロンプト

項番

プロンプトの表示形式

意味

1

USER-ID ?

HADBサーバに接続する認可識別子の入力待ち状態です。adbsqlコマンドの実行後，またはadbsqlサブコマンドの#CONNECTの実行後に表示されます。ただし，adbsqlコマンドの実行時に-uオプションを指定した場合，このプロンプトは表示されません。

認可識別子に指定できる文字列の長さは1～100バイトです。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

認可識別子の入力要求の際に，認可識別子を指定しなかった場合，認可識別子としてADBUSERが仮定されます。

2

PASSWORD ?

パスワードの入力待ち状態です。ただし，adbsqlコマンドの実行時に-uオプションおよび-pオプションを指定した場合，このプロンプトは表示されません。

パスワードを入力しても，入力した文字は表示されません。

パスワードに指定できる文字列の長さは1～255バイトです。パスワードは省略できません。

3

COMMAND ?

通常の入力待ち状態です。

4

NEXT ?

継続行の入力待ち状態です。

SQL文またはadbsqlサブコマンドの終わりを示すセミコロン（ ; ）が指定されない状態で［Enter］キーを押すと，その行は継続行（SQL文またはadbsqlサブコマンドが途中である）と見なされます。このプロンプトが表示された場合，SQL文またはadbsqlサブコマンドの続きを入力してください。

5

DATA（n） ?

？パラメタに対するデータの入力待ち状態です。このあとに表示されるCOMMAND ?のあとに，？パラメタのデータを入力してください。

42.3.2　ファイルに記述したSQL文を実行する場合

CREATE TABLE文で表T1を定義します。

CREATE TABLE文をファイル（infile）に記述する

ADBUSER01                                     ...1
#HelloHADB_01                                 ...2
CREATE FIX TABLE "T1"                         ...3
  ("C1" INT,"C2" CHAR(10),"C3" CHAR(7))
  IN DBAREA01;

［説明］

1．ファイルの先頭行にはCONNECT権限およびスキーマ定義権限を持つHADBユーザの認可識別子を指定します。

2．2行目にはHADBユーザの認可識別子のパスワードを指定します。

3．CREATE TABLE文を記述します。SQL文の終わりにセミコロン（ ; ）を記述してください。

adbsqlコマンドを開始する

adbsql -V < infile

実行するSQL文を表示するために-Vオプションを指定します。

実行結果を確認する

  USER-ID ?
ADBUSER01

  PASSWORD ?
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
CREATE FIX TABLE "T1"                     ...1
NEXT ?        +----2----+----3----+----4----+----5----+----6----+----7----+
  ("C1" INT,"C2" CHAR(10),"C3" CHAR(7))   ...1
NEXT ?        +----2----+----3----+----4----+----5----+----6----+----7----+
  IN DBAREA01;                            ...1
KFAA96403-I SQL processing completed.     ...2
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+

［説明］

1．-Vオプションを指定したため，実行したSQL文が表示されます。

2．CREATE TABLE文が正常に実行されたメッセージが表示されます。

留意事項

ファイル中に記述する文字の文字コードは，環境変数ADBCLTLANGで指定した文字コードと同じにしてください。

改行コードは，X'0A'（LF）またはX'0D0A'（CRLF）としてください。

ファイル中に#EXITや#DISCONNECTを記述しなくても自動的に#EXITが実行されます。

adbsqlサブコマンドの#DISCONNECTや#EXITの記述の前にEOF制御文字がある場合，その時点でDISCONNECT処理が行われます。

パスワードに指定できる文字列の長さは1〜255バイトです。

42.3.3　SQL文の実行結果をファイルに出力する場合

SELECT文で表USERSLISTの検索を行い，実行結果をファイル（outfile）に出力します。

adbsqlコマンドを開始する

adbsql -V > outfile

実行するSQL文をファイル（outfile）に出力するために，-Vオプションを指定します。

認可識別子を指定する

adbsql -V > outfile
ADBUSER01   ←HADBユーザの認可識別子を指定してEnterキーを押してください。

CONNECT権限，および表USERSLISTに対するSELECT権限を持つHADBユーザの認可識別子を指定します。ここで指定したHADBユーザの認可識別子でHADBサーバに接続します。

パスワードを指定する

adbsql -V > outfile
ADBUSER01
         ←認可識別子のパスワードを指定してEnterキーを押してください。

HADBサーバに接続するHADBユーザの認可識別子のパスワードを指定します。入力した文字は表示されません。

SELECT文を実行する

adbsql -V > outfile
ADBUSER01
SELECT "USERID","NAME","SEX" FROM "USERSLIST";

adbsqlコマンドを終了する

adbsql -V > outfile
ADBUSER01
SELECT "USERID","NAME","SEX" FROM "USERSLIST";
#EXIT;

adbsqlサブコマンドの#EXITを実行して，adbsqlコマンドを終了します。

SELECT文の実行結果がファイル（outfile）に出力されます。

  USER-ID ?
ADBUSER01

  PASSWORD ?
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT "USERID","NAME","SEX" FROM "USERSLIST";        ...1
 USERID NAME                           SEX            ...2
 ------ ------------------------------ ---
 U00555 Mike Johnson                     M
 U00358 Nancy White                      F
 U00212 Maria Gomez                      F
 U00687 Taro Tanaka                      M
 U00869 Bob Clinton                      M
KFAA96404-I 5 rows were selected.
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
#EXIT;

［説明］

1．実行したSELECT文です。

2．この行以降は，SELECT文の実行結果です。SQL文の実行結果の表示形式については，「42.7　SQL文の実行結果の出力形式」を参照してください。

ファイルに出力される文字の文字コードは，環境変数ADBCLTLANGで指定した文字コードと同じになります。

また，adbsqlサブコマンドの入力履歴もファイルに出力されます。

42.4　リターンコード

adbsqlコマンドのリターンコードを次の表に示します。

表42‒2　adbsqlコマンドのリターンコード

リターンコード

意味

0

adbsqlコマンドが正常に終了しました。

4

SQL文またはadbsqlサブコマンドのエラーが1回以上発生しました。

8

adbsqlコマンドのオプションの指定誤りなどが原因でadbsqlコマンドが実行できませんでした。

42.5　adbsqlサブコマンド

adbsqlサブコマンドの機能と入力形式について説明します。

42.5.1　#CHUNKS（チャンク情報の表示）

機能

指定された表のチャンク情報を表示します。

形式

#CHUNKS 〔スキーマ名.〕表識別子 〔SHOW ｛ALL｜COMMENT｝〕;

〔スキーマ名.〕表識別子：

チャンク情報を表示する表名を，「スキーマ名.表識別子」の形式で指定します。スキーマ名を省略した場合は，このサブコマンドを実行するHADBユーザの認可識別子が仮定されます。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

〔SHOW ｛ALL｜COMMENT｝〕：

SHOW ALLを指定した場合

システム表のSTATUS_CHUNKS表のすべての列が表示されます。表示される内容については，マニュアルHADB　システム構築・運用ガイドのSTATUS_CHUNKSの内容を参照してください。

SHOW COMMENTを指定した場合

次の表に示す内容がすべて表示されます。

このオプションを省略した場合（SHOW ALLおよびSHOW COMMENTを指定しない場合）

次の表に示す内容が表示されます。ただし，CHUNK_COMMENT列は表示されません。

表42‒3　#CHUNKSで表示される内容（SHOW COMMENTを指定した場合，またはオプションを省略した場合）

項番

列名

内容

1

CHUNK_ID

チャンクID

2

IS_CURRENT_CHUNK

カレントチャンク

'Y'：カレントチャンクである

'N'：カレントチャンクではない

3

CHUNK_STATUS

チャンクの状態

詳細については，マニュアルHADB　システム構築・運用ガイドのSTATUS_CHUNKSの内容のCHUNK_STATUSを参照してください。

4

IS_ARCHIVE

アーカイブ状態のチャンクかどうか

'Y'：アーカイブ状態のチャンク

'N'：アーカイブ状態ではないチャンク

5

STORAGE_FORMAT

チャンク内のデータ格納形式

'COLUMN'

カラムストア形式

'ROW'

ローストア形式

6

CREATE_TIME

チャンクの作成日時

詳細については，マニュアルHADB　システム構築・運用ガイドのSTATUS_CHUNKSの内容のCREATE_TIMEを参照してください。

7

CHUNK_COMMENT

チャンクに設定されたコメント

コメントが設定されていない場合は，ナル値が格納されます。

SHOW COMMENTオプションを指定した場合だけ，表示されます。

留意事項

#CHUNKSを実行して表示される表のチャンク情報の範囲は，HADBユーザが持っている権限によって異なります。表示される表のチャンク情報の範囲を次に示します。

DBA権限を持っているHADBユーザの認可識別子で接続している場合

すべてのHADBユーザが定義した表のチャンク

上記の権限を持っていないHADBユーザの認可識別子で接続している場合

自分（HADBサーバに接続中の認可識別子のHADBユーザ）が定義した表のチャンク

ほかのHADBユーザによって付与されたアクセス権限の対象となる表のチャンク

PUBLIC指定で許可された表のチャンク

なお，#CHUNKSを実行して表示される表のチャンク情報の範囲は，システム表のSTATUS_CHUNKS表を参照できる範囲と同じです。詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表の概要のHADBユーザが参照できるシステム表の範囲を参照してください。

#CHUNKSを実行すると，システム表の排他が取得されます。#CHUNKSを実行したあと，すぐにCOMMIT文を実行してください。COMMIT文を実行しないと，システム表の排他が解放されません。ただし，#CHUNKSを実行したあとで，adbsqlコマンドを終了する場合は，システム表の排他は解放されるため，COMMIT文の実行は不要です。

存在しないスキーマ名や表識別子を指定した場合，#CHUNKSの実行結果は0行になります（エラーにはなりません）。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#CHUNKSの実行結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定していても，#CHUNKSの実行時間は出力されません。adbsqlサブコマンドの#SET EXECTIME REPORTについては，「42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）」を参照してください。

#SET OPT REPORTでON（インデクス情報，作業表情報，およびアクセスパス情報を表示する）を指定していても，#CHUNKSの実行時に，インデクス情報，作業表情報，およびアクセスパス情報は出力されません。adbsqlサブコマンドの#SET OPT REPORTについては，「42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）」を参照してください。

#SET OPT REPORTでEXEC=PREPARE（SQL文を実行しない）を指定していても，#CHUNKSの実行結果は出力されます。

42.5.2　#COLUMNS（列情報の表示）

機能

指定された表の列情報を表示します。

形式

#COLUMNS 〔スキーマ名.〕表識別子 〔SHOW ALL〕;

〔スキーマ名.〕表識別子：

列情報を表示する表名を，「スキーマ名.表識別子」の形式で指定します。スキーマ名を省略した場合は，このサブコマンドを実行するHADBユーザの認可識別子が仮定されます。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

〔SHOW ALL〕：

このオプションを指定した場合

ディクショナリ表のSQL_COLUMNS表のすべての列が表示されます。表示される内容については，マニュアルHADB　システム構築・運用ガイドのSQL_COLUMNSの内容を参照してください。

このオプションを省略した場合

次の表に示す内容が表示されます。

表42‒4　#COLUMNSで表示される内容（オプションを省略した場合）

項番

列名

内容

1

COLUMN_NAME

列名

2

DATA_TYPE

データ型

配列型の場合は，次の形式で表示されます。

要素データ型 ARRAY[最大要素数]

3

DATA_LENGTH

列の定義長

詳細については，マニュアルHADB　システム構築・運用ガイドのSQL_COLUMNSの内容のDATA_LENGTHを参照してください。

4

IS_NULLABLE

列に対する非ナル値制約定義の指定

詳細については，マニュアルHADB　システム構築・運用ガイドのSQL_COLUMNSの内容のIS_NULLABLEを参照してください。

5

IS_DEFAULT_COLUMN

DEFAULT句の指定有無

'Y'

実表の定義時にDEFAULT句を指定した列

'N'

実表の定義時にDEFAULT句を指定していない列

留意事項

#COLUMNSを実行して表示される表の列情報の範囲は，HADBユーザが持っている権限によって異なります。表示される表の列情報の範囲を次に示します。

DBA権限を持っているHADBユーザの認可識別子で接続している場合

すべてのHADBユーザが定義した表の列

スキーマ名がMASTERの表の列

上記の権限を持っていないHADBユーザの認可識別子で接続している場合

自分（HADBサーバに接続中の認可識別子のHADBユーザ）が定義した表の列

ほかのHADBユーザによって付与されたアクセス権限の対象となる表の列

PUBLIC指定で許可された表の列

スキーマ名がMASTERの表の列

なお，#COLUMNSを実行して表示される表の列情報の範囲は，ディクショナリ表のSQL_COLUMNS表を参照できる範囲と同じです。詳細については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の概要のHADBユーザが参照できるディクショナリ表の範囲を参照してください。

#COLUMNSを実行すると，ディクショナリ表の排他が取得されます。#COLUMNSを実行したあと，すぐにCOMMIT文を実行してください。COMMIT文を実行しないと，ディクショナリ表の排他が解放されません。ただし，#COLUMNSを実行したあとで，adbsqlコマンドを終了する場合は，ディクショナリ表の排他は解放されるため，COMMIT文の実行は不要です。

存在しないスキーマ名や表識別子を指定した場合，#COLUMNSの実行結果は0行になります（エラーにはなりません）。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#COLUMNSの実行結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定していても，#COLUMNSの実行時間は出力されません。adbsqlサブコマンドの#SET EXECTIME REPORTについては，「42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）」を参照してください。

#SET OPT REPORTでON（インデクス情報，作業表情報，およびアクセスパス情報を表示する）を指定していても，#COLUMNSの実行時に，インデクス情報，作業表情報，およびアクセスパス情報は出力されません。adbsqlサブコマンドの#SET OPT REPORTについては，「42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）」を参照してください。

#SET OPT REPORTでEXEC=PREPARE（SQL文を実行しない）を指定していても，#COLUMNSの実行結果は出力されます。

42.5.3　#COMMENT（注釈行の指定）

機能

セミコロンまでに記述した文字列を注釈にします。

形式

#COMMENT 注釈;

42.5.4　#CONNECT（HADBサーバへの接続）

機能

HADBサーバに接続します。

#DISCONNECTを実行してHADBサーバからの切り離しをしたあとに，HADBサーバに再度接続する際に#CONNECTを実行します。

形式

#CONNECT;

留意事項

#CONNECTを実行したあと，認可識別子およびパスワードの入力要求があります。

パスワードは省略できません。

HADBサーバに接続後，別の認可識別子でHADBサーバに接続する場合，#DISCONNECTコマンドで一度HADBサーバから切り離したあとに#CONNECTを実行してください。

42.5.5　#DISCONNECT（HADBサーバからの切り離し）

機能

実行中のトランザクションを正常終了させ，コミットします。そのあと，HADBサーバからの切り離しを実行します。

形式

#DISCONNECT;

留意事項

#DISCONNECTを実行すると，HADBサーバから切り離されますが，adbsqlコマンドは終了しません。adbsqlコマンドを終了するには，#EXITを実行してください。HADBサーバと再度接続する場合は，#CONNECTを実行してください。

42.5.6　#EXIT（adbsqlコマンドの終了）

機能

adbsqlコマンドを終了します。

形式

#EXIT;

留意事項

HADBサーバとの接続中に#EXITを実行すると，HADBサーバからの切り離し（#DISCONNECT）を実行したあとに，adbsqlコマンドを終了します。

42.5.7　#GETCOUNT（チャンクに格納されているデータの件数の取得）

機能

指定したチャンクに格納されているデータの件数を取得します。

#GETCOUNTは，マルチチャンク表に実行できます。

形式

#GETCOUNT 表名 CHUNKID=チャンクID;

表名

データの件数を取得する表名を指定します。HADBサーバに接続したHADBユーザ（認可識別子）が，SELECT権限を持つマルチチャンク表の表名だけを指定できます。

チャンクID

データの件数を取得するチャンクIDを指定します。存在するチャンクIDを指定してください。チャンクIDを調べる方法については，マニュアルHADB　システム構築・運用ガイドのシステム表の検索を参照してください。

メモ

このサブコマンドを使用すると，指定したチャンクIDのチャンクが待機状態の場合も，対象のチャンクに格納されているデータの件数を取得できます。

留意事項

#GETCOUNTの出力形式は，表名で指定した表を検索するSELECT文と同じ形式です。SELECT文の出力形式については，「42.7.2　操作系SQLの場合（SELECT文）」を参照してください。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#GETCOUNTの結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#GETCOUNTを指定している場合，#SET EXECTIME REPORTおよび#SET OPT REPORTの指定は有効になりません（常にOFFと見なされます）。

42.5.8　#GETDATA（チャンクに格納されているデータの取得）

機能

指定したチャンクに格納されているデータを取得して，標準出力に出力します。

#GETDATAは，マルチチャンク表に実行できます。

形式

#GETDATA 表名 CHUNKID=チャンクID;

表名

データを取得する表名を指定します。HADBサーバに接続したHADBユーザ（認可識別子）が，SELECT権限を持つマルチチャンク表の表名だけを指定できます。

チャンクID

データを取得するチャンクIDを指定します。存在するチャンクIDを指定してください。チャンクIDを調べる方法については，マニュアルHADB　システム構築・運用ガイドのシステム表の検索を参照してください。

メモ

このサブコマンドを使用すると，指定したチャンクIDのチャンクが待機状態の場合も，対象のチャンクに格納されているデータを出力できます。

使用例

表T1のチャンク内（チャンクIDが1のチャンク）のデータを，CSV形式でファイル（outfile）に出力する例を次に示します。

adbsql -u ADBUSER01 -p '#HelloHADB_01' -s > outfile          ...1
#GETDATA "T1" CHUNKID=1;                                     ...2
#EXIT;                                                       ...3

［説明］

-uオプション，-pオプションおよび-sオプションを指定して，adbsqlコマンドを開始します。

サブコマンドの#GETDATAを実行します。

表T1のチャンク内（チャンクIDが1のチャンク）のデータが，CSV形式でファイル（outfile）に出力されます。

adbsqlコマンドを終了します。

留意事項

#GETDATAの出力形式は，表名で指定した表を検索するSELECT文と同じ形式です。SELECT文の出力形式については，「42.7.2　操作系SQLの場合（SELECT文）」を参照してください。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#GETDATAの結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#GETDATAを指定している場合，#SET EXECTIME REPORTおよび#SET OPT REPORTの指定は有効になりません（常にOFFと見なされます）。

42.5.9　#GETUSER（認可識別子の表示）

機能

このサブコマンドを実行するHADBユーザの認可識別子を表示します。

形式

#GETUSER;

留意事項

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#GETUSERの実行結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定していても，#GETUSERの実行時間は出力されません。adbsqlサブコマンドの#SET EXECTIME REPORTについては，「42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）」を参照してください。

#SET OPT REPORTでON（インデクス情報，作業表情報，およびアクセスパス情報を表示する）を指定していても，#GETUSERの実行時に，インデクス情報，作業表情報，およびアクセスパス情報は出力されません。adbsqlサブコマンドの#SET OPT REPORTについては，「42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）」を参照してください。

#SET OPT REPORTでEXEC=PREPARE（SQL文を実行しない）を指定していても，#GETUSERの実行結果は出力されます。

42.5.10　#INDEXES（インデクス情報の表示）

機能

指定された表のインデクス情報を表示します。

形式

#INDEXES 〔〔スキーマ名.〕表識別子〕 〔SHOW ALL〕;

〔〔スキーマ名.〕表識別子〕：

インデクス情報を表示する表名を，「スキーマ名.表識別子」の形式で指定します。スキーマ名を省略した場合は，このサブコマンドを実行するHADBユーザの認可識別子が仮定されます。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

スキーマ名および表識別子を省略した場合（表名を指定しない場合）は，すべての表のインデクス情報が表示されます。ただし，表示対象の表は，HADBユーザが持っている権限の有無によって異なります。留意事項を参照してください。

〔SHOW ALL〕：

このオプションを指定した場合

ディクショナリ表のSQL_INDEXES表のすべての列が表示されます。表示される内容については，マニュアルHADB　システム構築・運用ガイドのSQL_INDEXESの内容を参照してください。

このオプションを省略した場合

次の表に示す内容が表示されます。

表42‒5　#INDEXESで表示される内容（オプションを省略した場合）

項番

列名

内容

1

TABLE_SCHEMA

スキーマ名

2

TABLE_NAME

インデクスが定義されている表の表識別子

3

INDEX_NAME

インデクス識別子

主キーに対応するインデクスの場合，制約名と同じ名称のインデクス識別子が格納されます。

4

INDEX_TYPE

インデクスの種別

'B-TREE'：B-treeインデクス

'RANGE'：レンジインデクス

'TEXT'：テキストインデクス

5

COLUMN_COUNT

インデクス構成列数

6

UNIQUE_TYPE

B-treeインデクスの種類（ユニークインデクスかどうか）

'Y'：ユニークインデクス

'N'：非ユニークインデクス

留意事項

#INDEXESを実行して表示されるインデクス情報の範囲は，HADBユーザが持っている権限によって異なります。表示されるインデクス情報の範囲を次に示します。

DBA権限または監査管理権限を持っているHADBユーザの認可識別子で接続している場合

すべてのHADBユーザが定義した表のインデクス

スキーマ名がMASTERの表のインデクス

上記の権限を持っていないHADBユーザの認可識別子で接続している場合

自分（HADBサーバに接続中の認可識別子のHADBユーザ）が定義した表のインデクス

ほかのHADBユーザによって付与されたアクセス権限の対象となる表のインデクス

PUBLIC指定で許可された表のインデクス

スキーマ名がMASTERの表のインデクス

なお，#INDEXESを実行して表示されるインデクス情報の範囲は，ディクショナリ表のSQL_INDEXES表を参照できる範囲と同じです。詳細については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の概要のHADBユーザが参照できるディクショナリ表の範囲を参照してください。

#INDEXESを実行すると，ディクショナリ表の排他が取得されます。#INDEXESを実行したあと，すぐにCOMMIT文を実行してください。COMMIT文を実行しないと，ディクショナリ表の排他が解放されません。ただし，#INDEXESを実行したあとで，adbsqlコマンドを終了する場合は，ディクショナリ表の排他は解放されるため，COMMIT文の実行は不要です。

存在しないスキーマ名や表識別子を指定した場合，#INDEXESの実行結果は0行になります（エラーにはなりません）。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#INDEXESの実行結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定していても，#INDEXESの実行時間は出力されません。adbsqlサブコマンドの#SET EXECTIME REPORTについては，「42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）」を参照してください。

#SET OPT REPORTでON（インデクス情報，作業表情報，およびアクセスパス情報を表示する）を指定していても，#INDEXESの実行時に，インデクス情報，作業表情報，およびアクセスパス情報は出力されません。adbsqlサブコマンドの#SET OPT REPORTについては，「42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）」を参照してください。

#SET OPT REPORTでEXEC=PREPARE（SQL文を実行しない）を指定していても，#INDEXESの実行結果は出力されます。

42.5.11　#SET BINARY_DISP_MODE（バイナリデータの出力形式の指定）

機能

検索結果のバイナリデータを16進形式または2進形式のどちらで表示するかを指定します。

adbsqlコマンド開始時に-bオプションを指定していない場合，初期値はHEX（バイナリデータを16進形式で表示）になります。adbsqlコマンド開始時に-bオプションを指定した場合，初期値はBIN（バイナリデータを2進形式で表示）になります。

形式

#SET BINARY_DISP_MODE ｛HEX｜BIN｝;

HEX：バイナリデータを16進形式で出力します。

BIN：バイナリデータを2進形式で出力します。

留意事項

#SET DUMPMODEでON（検索結果を16進形式で表示）を指定した場合は，BINを指定しても無視されます。

42.5.12　#SET DISPLAY（検索結果の出力）

機能

検索結果を出力するかどうかを指定します。

初期値はON（検索結果を出力）になります。

形式

#SET DISPLAY ｛ON｜OFF｝;

ON：検索結果を出力します。

OFF：検索結果を出力しません。

使用例

検索結果の加工や出力に掛かる時間を除いて，SQL文の実行時間を表示する例を次に示します。

adbsql -u ADBUSER01 -p '#HelloHADB_01'                       ...1
#SET EXECTIME REPORT ON;                                     ...2
#SET DISPLAY OFF;                                            ...3
SELECT * FROM "T1";                                          ...4
KFAA96404-I 100000000 rows were selected.
KFAA96415-I SQL processing time (Fetch) : 18.863501 sec.     ...5
#EXIT;                                                       ...6

［説明］

-uオプションおよび-pオプションを指定して，adbsqlコマンドを開始します。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力）を指定します。

#SET DISPLAYでOFF（検索結果を出力しない）を指定します。

SQL文を実行します。

検索結果の加工や出力に掛かる時間を除いた，SQL文の実行時間が表示されます。

adbsqlコマンドを終了します。

留意事項

adbsqlコマンド開始時に-sオプションを指定した場合，#SET DISPLAYは実行できません。

42.5.13　#SET DUMPMODE（検索結果の16進形式での表示）

機能

検索結果を16進形式または文字形式のどちらで表示するかを指定します。

初期値はOFF（検索結果を文字形式で表示）になります。

形式

#SET DUMPMODE ｛ON｜OFF｝;

ON：検索結果を16進形式で表示します。

OFF：検索結果を文字形式で表示します。

42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）

機能

次に示すSQL文の実行時間を出力するかどうかを指定します。

定義系SQL

操作系SQL

制御系SQL

SQL文の実行時間には，次に示す時間が出力されます。

定義系SQLの場合

a_rdb_SQLAllocStmt()の発行前から，a_rdb_SQLFreeStmt()が完了するまでの時間

SELECT文の場合

最初の行の取り出し（最初のa_rdb_SQLFetch()）から，行の取り出し終了（最後に発行するa_rdb_SQLFetch()）までの時間

SELECT文以外の操作系SQLの場合

a_rdb_SQLExecute()の発行前から，a_rdb_SQLExecute()が完了するまでの時間

制御系SQLの場合

a_rdb_SQLEndTran()の発行前から，a_rdb_SQLEndTran()が完了するまでの時間

初期値はOFF（SQL文の実行時間を出力しない）になります。

形式

#SET EXECTIME REPORT ｛ON｜OFF｝;

ON：SQL文の実行時間を出力します。

OFF：SQL文の実行時間を出力しません。

ONを指定した場合の，SQL文の実行時間の出力形式を次に示します。

KFAA96415-I SQL processing time (aa....aa) : ssssssssssss.pppppp sec.

（凡例）

aa....aa：実行した動作が表示されます。行の取り出しの場合は，Fetchが表示されます。SQL文の実行の場合は，Executeが表示されます。

ssssssssssss：秒数を表します。有効な桁数が，左詰めで表示されます。

pppppp：小数秒を表します。

留意事項

エラーが発生した場合，SQL文の実行時間は出力されません。

42.5.15　#SET NULL（ナル値の表示形式の指定）

(1)　機能

検索結果がナル値の場合に表示される文字列（ナル値表示文字列）を指定します。

ナル値の場合に表示される文字列の既定値は，環境変数ADBSQLNULLCHARの指定値になります。環境変数ADBSQLNULLCHARを設定していない場合，既定値はアスタリスク（*）になります。

(2)　指定形式

#SET NULL ｛〔ナル値の場合に表示される文字列〕
             ｜REPEAT ナル値の場合に表示される埋め字
             ｜DELETE｝;

  ナル値の場合に表示される文字列：：＝文字列定数
  ナル値の場合に表示される埋め字：：＝文字列定数

(3)　オプションの説明

ナル値の場合に表示される文字列：

検索結果がナル値の場合に，表示される文字列を指定します。

指定規則を次に示します。

文字列をアポストロフィ（ ' ）で囲んで指定します。

（例）'NULL'

0バイトから32バイトの文字列が指定できます。

このオプションを省略した場合，またはこのオプションに0バイトの文字列を指定した場合，検索結果がナル値のときには空白が表示されます。

指定する文字列中にアポストロフィ（ ' ）が含まれる場合は，1個のアポストロフィを表す際にアポストロフィを2個指定してください。例えば，ナル値の場合に表示される文字列をN'ULLにしたい場合は次のように指定します。

'N''ULL'

REPEAT ナル値の場合に表示される埋め字：

検索結果がナル値の場合に，繰り返して表示する文字（埋め字）を指定します。指定した埋め字を検索結果で表示できる幅の分だけ繰り返した文字列が，ナル値の場合に表示される文字列になります。

指定規則を次に示します。

埋め字をアポストロフィ（ ' ）で囲んで指定します。

（例）':'

指定する埋め字の長さは，1バイトにしてください。

埋め字をアポストロフィ（ ' ）にする場合は，次のように指定してください。

''''

DELETE：

検索結果がナル値の場合に表示される文字列を，既定値に戻します。

(4)　実行例

ナル値を既定値で表示する場合

SELECT CAST(NULL AS CHAR(4)) FROM "T1";     ...1

 EXP0001_NO_NAME
 ---------------
            ****                            ...2

［説明］

#SET NULLを実行しないで，SQL文を実行します。

検索結果がナル値の場合，環境変数ADBSQLNULLCHARの指定値が表示されます。環境変数ADBSQLNULLCHARを設定していないときは，アスタリスク（*）が表示されます。

ナル値を文字列で表示する場合

#SET NULL 'NULL';                            ...1
SELECT CAST(NULL AS CHAR(4)) FROM "T1";      ...2

 EXP0001_NO_NAME
 ---------------
            NULL                             ...3

［説明］

ナル値の場合に表示される文字列にNULLを指定して，#SET NULLを実行します。

SQL文を実行します。

検索結果がナル値の場合，NULLが表示されます。

ナル値を空白で表示する場合

#SET NULL '';                               ...1
SELECT CAST(NULL AS CHAR(4)) FROM "T1";     ...2

 EXP0001_NO_NAME
 ---------------
                                            ...3

［説明］

ナル値の場合に表示される文字列に0バイトの文字列を指定して，#SET NULLを実行します。

SQL文を実行します。

検索結果がナル値の場合，空白が表示されます。

ナル値をコロン（:）で表示する場合（埋め字指定の場合）

#SET NULL REPEAT ':';                       ...1
SELECT CAST(NULL AS CHAR(4)) FROM "T1";     ...2

 EXP0001_NO_NAME
 ---------------
            ::::                            ...3

［説明］

ナル値の場合に表示される埋め字にコロン（:）を指定して，#SET NULLを実行します。

SQL文を実行します。

検索結果がナル値の場合，検索結果で表示できる幅の分だけ，コロン（:）が繰り返し表示されます。

(5)　留意事項

ナル値の場合に表示される文字列にマルチバイト文字を指定すると，表示が乱れる場合があります。

ナル値の場合に表示される文字列が，検索結果で表示できる幅を超える場合は，指定した文字列のうち，検索結果で表示できる幅の分だけが表示されます。ナル値の場合に表示される文字列にマルチバイト文字を指定し，検索結果で表示できる幅がマルチバイト文字の途中となるときは，その1つ前の文字までが表示されます。

配列型の列のナル値については，次のように表示されます。

列値がナル値の場合，このサブコマンドで指定したナル値のときに表示される文字列が表示されます。

配列要素がナル値の場合，このサブコマンドで指定したナル値のときに表示される文字列に関係なく，NULLが表示されます。

42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）

(1)　機能

次に示すSQL文を実行した場合に，実行したSQL文に関するインデクス情報，作業表情報およびアクセスパス情報を表示するかどうかを指定します。

DELETE文

INSERT文

次に示す場合に，インデクス情報，作業表情報およびアクセスパス情報が表示されます。

INSERT文中に問合せ式本体を指定している場合

INSERT文中にVALUESを指定していて，かつ副問合せを指定している場合

PURGE CHUNK文

PURGE CHUNK文中に副問合せを指定している場合に，インデクス情報，作業表情報およびアクセスパス情報が表示されます。

SELECT文

UPDATE文

ただし，作業表を作成しないSQL文のときは，作業表情報は表示されません。

表参照に対してインデクス指定が指定されているときは，そのインデクス指定が適用されたかどうかがインデクス情報に表示されます。インデクス指定については，マニュアルHADB　SQLリファレンスのインデクス指定の指定形式および規則を参照してください。

アクセスパス情報については，マニュアルHADB　AP開発ガイドのAPのチューニングのアクセスパスの見方（SQL文の実行計画の見方）を参照してください。

初期値はOFF（インデクス情報，作業表情報およびアクセスパス情報を表示しない）になります。

(2)　指定形式

#SET OPT REPORT ｛ON
                   〔TYPE = ｛INDEX｜PATH｜ALL｝〕
                   〔EXEC = ｛NORMAL｜PREPARE｝〕
                ｜OFF｝;

(3)　オプションの説明

ON：

インデクス情報，作業表情報およびアクセスパス情報を表示します。

〔TYPE = ｛INDEX｜PATH｜ALL｝〕：

出力する情報の種類を指定します。

INDEX：インデクス情報，および作業表情報を表示します。

PATH：アクセスパス情報だけを表示します。

ALL：インデクス情報，作業表情報，およびアクセスパス情報を表示します。

〔EXEC = ｛NORMAL｜PREPARE｝〕：

情報を表示したあと，SQL文を実行するかどうかを指定します。

NORMAL：情報を表示したあと，SQL文を実行します。

PREPARE：次に示すSQL文の場合は，情報だけを表示して，SQL文を実行しません。

DELETE文

INSERT文

PURGE CHUNK文

SELECT文

UPDATE文

それ以外のSQL文は，EXEC = PREPAREを指定しても実行されます。

OFF：

インデクス情報，作業表情報およびアクセスパス情報を表示しません。

(4)　実行例

インデクス情報および作業表情報を表示したあとで，SQL文を実行する場合

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
#SET OPT REPORT ON;                                        ...1
KFAA96499-I OPT REPORT changed  ( OFF -> ON  )
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT * FROM "T1" WHERE "C1"=100 ORDER BY "C2";           ...2
KFAA96405-I The B-tree index "INDX01" will be used.
 (table name="ADBUSER01"."T1" as "***")                    ...2
KFAA96406-I Executing this SQL will create 1 work tables.  ...3
 検索結果                                                  ...4
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+

［説明］

インデクス情報および作業表情報の表示を指定して，#SET OPT REPORTを実行します。

SQL文を実行します。

インデクス情報および作業表情報として，メッセージが表示されます。出力されたメッセージから次に示すことがわかります。

・このSQL文を実行した際，B-treeインデクスINDX01が使用されます。

・このSQL文を実行した際，作業表が1つ作成されます。

SQL文の実行結果が表示されます。

すべての情報を表示したあとで，SQL文を実行する場合

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
#SET OPT REPORT ON TYPE = ALL EXEC = NORMAL;               ...1
KFAA96499-I OPT REPORT changed  ( OFF -> ON )
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT * FROM "T1" WHERE "C1"=100 ORDER BY "C2";           ...2
KFAA96405-I The B-tree index "INDX01" will be used.
 (table name="ADBUSER01"."T1" as "***")                    ...2
KFAA96406-I Executing this SQL will create 1 work tables.  ...3
 アクセスパス情報                                          ...4
KFAA96412-I The access path was output.                    ...5
 検索結果                                                  ...6
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+

［説明］

インデクス情報，作業表情報およびアクセスパス情報の表示を指定して，#SET OPT REPORTを実行します。

SQL文を実行します。

インデクス情報および作業表情報として，メッセージが表示されます。出力されたメッセージから次に示すことがわかります。

・このSQL文を実行した際，B-treeインデクスINDX01が使用されます。

・このSQL文を実行した際，作業表が1つ作成されます。

アクセスパス情報が表示されます。表示されたアクセスパス情報の見方については，マニュアルHADB　AP開発ガイドのAPのチューニングのアクセスパスの見方（SQL文の実行計画の見方）のアクセスパスの見方の例を参照してください。

アクセスパス情報の表示完了を示すメッセージが出力されます。

SQL文の実行結果が表示されます。

アクセスパス情報だけを表示して，SQL文を実行しない場合

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
#SET OPT REPORT ON TYPE = PATH EXEC = PREPARE;          ...1
KFAA96499-I OPT REPORT changed  ( OFF -> ON )
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT * FROM "T1" WHERE "C1"=100 ORDER BY "C2";        ...2
 アクセスパス情報                                       ...3
KFAA96412-I The access path was output.                 ...4
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+

［説明］

アクセスパス情報の表示を指定して，#SET OPT REPORTを実行します。

SQL文を実行します。

アクセスパス情報が表示されます。表示されたアクセスパス情報の見方については，マニュアルHADB　AP開発ガイドのAPのチューニングのアクセスパスの見方（SQL文の実行計画の見方）のアクセスパスの見方の例を参照してください。

アクセスパス情報の表示完了を示すメッセージが出力されます。

(5)　インデクス情報，および作業表情報として出力されるメッセージ

インデクス情報，および作業表情報として出力されるメッセージを次に示します。

インデクス情報として出力されるメッセージ

インデクス情報として出力されるメッセージを次の表に示します。なお，インデクスが使用されない場合，メッセージは出力されません。

表42‒6　インデクス情報として出力されるメッセージの一覧

項番

出力されるメッセージ

インデクス情報の内容

1

KFAA96405-I

インデクス指定を指定していない場合

B-treeインデクスが検索に使用されます。

インデクス指定（WITH INDEX）を指定した場合

インデクス指定が無効※のため，指定以外のB-treeインデクスが検索に使用されます。

2

KFAA96407-I

B-treeインデクス，テキストインデクス，およびレンジインデクスのどれも検索に使用されません。

3

KFAA96408-I

レンジインデクスが検索に使用されます。

4

KFAA96409-I

インデクス指定（WITH INDEX）が適用され，指定したB-treeインデクスが検索に使用されます。

5

KFAA96410-I

インデクス指定（WITHOUT INDEX）が適用され，指定したB-treeインデクスまたはテキストインデクスの使用が抑止されます。

6

KFAA96411-I

インデクス指定が無効です。

7

KFAA96413-I

インデクス指定を指定していない場合

テキストインデクスが検索に使用されます。

インデクス指定（WITH INDEX）を指定した場合

インデクス指定が無効※のため，指定以外のテキストインデクスが検索に使用されます。

8

KFAA96414-I

インデクス指定（WITH INDEX）が適用され，指定したテキストインデクスが検索に使用されます。

注※

インデクス指定が無効になる場合を次に示します。

存在しないインデクス名を指定した場合

ナル値除外指定があるB-treeインデクスを指定しているが，インデクスの検索範囲にナル値を含む条件が指定された場合

テキストインデクスを指定しているが，指定したテキストインデクスで評価できるLIKE述語が指定されていないなど，HADBがテキストインデクスを有効に使用できない場合

作業表情報として出力されるメッセージ

作業表が作成された場合，作業表情報としてKFAA96406-Iメッセージが出力されます。作業表が作成されない場合，メッセージは出力されません。

(6)　留意事項

結合表のFULL OUTER JOINに指定した表については，同じインデクス情報が複数表示されることがあります。インデクス情報の詳細については，アクセスパス情報で確認してください。

42.5.17　#SET TRAN_ISOLV（トランザクション隔離性水準の指定）

機能

トランザクション隔離性水準を指定します。

クライアント定義のadb_clt_trn_iso_lvオペランドの指定値が，#SET TRAN_ISOLV実行時の初期値になります。

形式

#SET TRAN_ISOLV｛READ_COMMITTED｜REPEATABLE_READ｝;

READ_COMMITTED：トランザクション隔離性水準をREAD COMMITTEDにします。

REPEATABLE_READ：トランザクション隔離性水準をREPEATABLE READにします。

トランザクション隔離性水準については，マニュアルHADB　システム構築・運用ガイドのHADBがサポートしているトランザクション隔離性水準を参照してください。

42.5.18　#TABLES（表情報の表示）

機能

表情報を表示します。

形式

#TABLES 〔スキーマ名〕 〔SHOW ALL〕;

〔スキーマ名〕：

表情報を表示するスキーマ名を指定します。

スキーマ名を省略した場合，すべての表の表情報が表示されます。ただし，表示対象の表は，HADBユーザが持っている権限の有無によって異なります。留意事項を参照してください。

〔SHOW ALL〕：

このオプションを指定した場合

ディクショナリ表のSQL_TABLES表のすべての列が表示されます。表示される内容については，マニュアルHADB　システム構築・運用ガイドのSQL_TABLESの内容を参照してください。

このオプションを省略した場合

次の表に示す内容が表示されます。

表42‒7　#TABLESで表示される内容（オプションを省略した場合）

項番

列名

内容

1

TABLE_SCHEMA

スキーマ名

2

TABLE_NAME

表識別子

3

STORAGE_FORMAT

表データの格納形式

'COLUMN'

カラムストア形式

'ROW'

ローストア形式

なお，ビュー表の場合は，ナル値が表示されます。

4

N_COLS

表の構成列数

5

N_INDEX

表に定義されているインデクス数（全インデクスの合計）

6

IS_CHUNK

チャンク指定のCHUNKの指定

'Y'：指定あり（マルチチャンク表）

'N'：指定なし（シングルチャンク表）

7

N_CHUNK

存在するチャンク数

列名IS_CHUNKで'N'が出力されている場合は，ナル値が表示されます。

8

N_CHUNK_RESERVED

作成されるチャンク数の最大値

9

CREATE_TIME

表定義時のタイムスタンプ

留意事項

#TABLESを実行して表示される表情報の範囲は，HADBユーザが持っている権限によって異なります。表示される表情報の範囲を次に示します。

DBA権限または監査管理権限を持っているHADBユーザの認可識別子で接続している場合

すべてのHADBユーザが定義した表

スキーマ名がMASTERの表

上記の権限を持っていないHADBユーザの認可識別子で接続している場合

自分（HADBサーバに接続中の認可識別子のHADBユーザ）が定義した表

ほかのHADBユーザによって付与されたアクセス権限の対象となる表

PUBLIC指定で許可された表

スキーマ名がMASTERの表

なお，#TABLESを実行して表示される表情報の範囲は，ディクショナリ表のSQL_TABLES表を参照できる範囲と同じです。詳細については，マニュアルHADB　システム構築・運用ガイドのディクショナリ表の概要のHADBユーザが参照できるディクショナリ表の範囲を参照してください。

#TABLESを実行すると，ディクショナリ表の排他が取得されます。#TABLESを実行したあと，すぐにCOMMIT文を実行してください。COMMIT文を実行しないと，ディクショナリ表の排他が解放されません。ただし，#TABLESを実行したあとで，adbsqlコマンドを終了する場合は，ディクショナリ表の排他は解放されるため，COMMIT文の実行は不要です。

存在しないスキーマ名を指定した場合，#TABLESの実行結果は0行になります（エラーにはなりません）。

#SET DISPLAYでOFF（検索結果を出力しない）を指定していても，#TABLESの実行結果は出力されます。adbsqlサブコマンドの#SET DISPLAYについては，「42.5.12　#SET DISPLAY（検索結果の出力）」を参照してください。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定していても，#TABLESの実行時間は出力されません。adbsqlサブコマンドの#SET EXECTIME REPORTについては，「42.5.14　#SET EXECTIME REPORT（SQL文の実行時間の出力）」を参照してください。

#SET OPT REPORTでON（インデクス情報，作業表情報，およびアクセスパス情報を表示する）を指定していても，#TABLESの実行時に，インデクス情報，作業表情報，およびアクセスパス情報は出力されません。adbsqlサブコマンドの#SET OPT REPORTについては，「42.5.16　#SET OPT REPORT（インデクス情報，作業表情報，およびアクセスパス情報の表示）」を参照してください。

#SET OPT REPORTでEXEC=PREPARE（SQL文を実行しない）を指定していても，#TABLESの実行結果は出力されます。

42.6　SQL文中に？パラメタを指定した場合の操作方法

SQL文中に？パラメタを指定した場合の操作方法を例題を使って説明します。

42.6.1　例題

INSERT文で行の追加を行います。その際，？パラメタを使用します。

(1)　VALUES指定で行を追加する場合

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
INSERT INTO T1 VALUES(?,?,?);                     ...1
 DATA (    1) ? : SMALLINT                        ...2
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
25000;                                            ...3
 DATA (    2) ? : VARCHAR (   10)                 ...2
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
'HITACHI';                                        ...3
 DATA (    3) ? : TIMESTAMP (    7)               ...2
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
TIMESTAMP'2011-02-23 12:00:00';                   ...3
KFAA96404-I 1 rows were inserted.
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
COMMIT;                                           ...4
KFAA96403-I SQL processing completed.

［説明］

？パラメタを指定したINSERT文を実行します。

？パラメタに対する入力データの入力要求が，次に示す形式で表示されます。

DATA (aa...aa) ?：bb...bb

aa...aa：SQL文中に指定した？パラメタの先頭からの通番が表示されます。

bb...bb：？パラメタが仮定するデータ型です。次に示すどれかが表示されます。

・INTEGER※1

・SMALLINT

・DECIMAL（精度，位取り）※2

・DOUBLE PRECISION※3

・CHAR（長さ）

・VARCHAR（長さ）

・DATE（長さ）

・TIME（長さ）

・TIMESTAMP（長さ）

・BINARY（長さ）

・VARBINARY（長さ）

注※1

BIGINT型に対する？パラメタは，データ型としてINTEGER型を仮定します。そのため，INTEGERが表示されます。

注※2

NUMERIC型に対する？パラメタは，データ型としてDECIMAL型を仮定します。そのため，DECIMAL（精度，位取り）が表示されます。

注※3

FLOAT型に対する？パラメタは，データ型としてDOUBLE PRECISION型を仮定します。そのため，DOUBLE PRECISIONが表示されます。

？パラメタが仮定するデータ型に合った定数を指定します。入力データの規則については，「42.6.2　入力データの指定規則」を参照してください。

COMMITを実行して，INSERT文による行の追加を確定します。

(2)　行単位（ROW指定）でデータを追加する場合

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
INSERT INTO "T1" (ROW) VALUES(?);                 ...1
 DATA (    1) ? : ROW (   10)                     ...2
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
X'0A000000000000003132';                          ...3
KFAA96404-I 1 rows were inserted.
COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
COMMIT;                                           ...4
KFAA96403-I SQL processing completed.

［説明］

？パラメタを指定したINSERT文を実行します。

？パラメタに対する入力データの入力要求が，次に示す形式で表示されます。

DATA (aa...aa) ?：ROW (長さ)

aa...aa：SQL文中に指定した？パラメタの先頭からの通番が表示されます。

？パラメタが仮定するデータ型に合った定数を指定します。入力データの規則については，「42.6.2　入力データの指定規則」を参照してください。

COMMITを実行して，INSERT文による行の追加を確定します。

42.6.2　入力データの指定規則

入力データには定数を指定します。定数の指定形式については，マニュアルHADB　SQLリファレンスの定数の記述形式を参照してください。

入力データの最後にはセミコロン（ ; ）の指定が必要です。

ナル値を代入する場合は，NULLと指定します。

入力データの最大長は64,000バイトです。

？パラメタが仮定するデータ型によって，入力データに指定できる定数の種類が決まります。指定できる組み合わせを次の表に示します。

表42‒8　？パラメタが仮定するデータ型と，入力データに指定できる定数の組み合わせ

？パラメタが仮定するデータ型

定数の種類

数定数

文字列定数

日付定数

時刻定数

時刻印定数

バイナリ定数※1

数データ

○

×

×

×

×

○

文字データ

×

○

×

×

×

○

日時データ

DATE

×

○※2

○

×

○

○

TIME

×

○

×

○

TIMESTAMP

○

×

○

○

バイナリデータ

BINARY

×

×

×

×

○

○

VARBINARY

×

×

×

×

○

○

ROW

×

×

×

×

×

○

（凡例）

○：指定できます。

×：指定できません。

注※1

バイナリ定数には，次のどちらかの形式が指定できます。

・16進文字列定数

・2進文字列定数

16進文字列定数の指定形式は「X'16進文字列'」，2進文字列定数の指定形式は「B'2進文字列'」となります。このとき，OSのエンディアンを意識して指定してください。指定例を次に示します。

16進文字列定数の指定例：X'A000000000000000';

2進文字列定数の指定例：B'01011100';

注※2

既定の入力表現で記述された文字列定数を指定できます。既定の入力表現については，マニュアルHADB　SQLリファレンスの既定の文字列表現を参照してください。

42.6.3　留意事項

入力データのデータ長が，？パラメタのデータ長よりも長い場合，エラーになります。ただし，入力データの小数秒精度が？パラメタの小数秒精度より長い場合は，入力データが切り捨てられます。

入力データのデータ長が，？パラメタのデータ長よりも短い場合は，次の表に示す値で初期化されたあとにデータが代入されます。

表42‒9　入力データのデータ型と初期化後の値

項番

入力データのデータ型

初期化後の値

1

CHAR

空白（X'20'）

2

INTEGER

0

3

BIGINT

0

4

SMALLINT

0

5

DECIMAL

0

6

NUMERIC

0

7

DOUBLE PRECISION

0

8

FLOAT

0

9

DATE

0

10

TIME

0

11

TIMESTAMP

0

12

BINARY

0

13

ROW

0

42.7　SQL文の実行結果の出力形式

SQL文の実行結果の出力形式を説明します。

42.7.1　定義系SQLの場合

定義系SQLを実行した場合，次に示す形式で完了のメッセージ（KFAA96403-I）が表示されます。

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
CREATE INDEX "INDX01" ON "T2"("C1") IN DBAREA01 EMPTY;
KFAA96403-I SQL processing completed.
KFAA96415-I SQL processing time (Execute) : 0.853400 sec.

KFAA96415-Iメッセージは，#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定した場合に出力されます。

42.7.2　操作系SQLの場合（SELECT文）

SELECT文を実行した場合，次に示す形式で検索結果が表示されます。

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
SELECT 'C1 = ',"C1" FROM "T1";
 EXP0001_NO_NAME C1                                      ...1
 --------------- ----------------                        ...2
           C1 =   -123456789.1234                        ...3
           C1 =  ****************                        ...4
KFAA96404-I 2 rows were selected.                        ...5
KFAA96415-I SQL processing time (Fetch) : 0.477001 sec.  ...6

［説明］

問合せ式の結果，導出される表の列名が表示されます。導出される表の列名（検索項目列名）については，マニュアルHADB　SQLリファレンスの操作系SQLのSELECT（行の検索）のSELECT文の指定形式および規則にある規則を参照してください。

選択式単位に，ハイフン（-）が連続で表示されます。#SET DUMPMODEでON（検索結果を16進形式で表示）を指定した場合は，等号（=）が連続で表示されます。

ハイフン（-）または等号（=）の数は，検索結果で表示できる幅を示します。次に示す長さのうち，長い方と同じ長さになるように，ハイフン（-）または等号（=）が表示されます。

・列のデータを文字形式で表現した場合の最大長

・検索項目列名の長さ

検索結果が表示されます。スカラ関数のデータ変換関数を選択式に指定した場合，マルチバイト文字の右側切り捨てによって，検索結果の表示が乱れることがあります。また，スカラ関数CHRの対象データが127から159の場合も，表示が乱れることがあります。データ変換関数については，マニュアルHADB　SQLリファレンスのスカラ関数のデータ変換関数を参照してください。

検索結果がナル値の場合は，ナル値表示文字列が表示されます。ただし，ナル値表示文字列の長さが検索結果のデータの最大長を超える場合は，ナル値表示文字列が途中で切り捨てられます。

ナル値表示文字列の最大長は，2.のハイフン（-）または等号（=）が表示される長さと同じです。

なお，配列型の列については，次のように表示されます。

列値がナル値の場合，2.で説明している長さのナル値表示文字列が表示されます。

配列要素がナル値の場合，各配列要素がコンマ（,）で区切られ，ナル値の配列要素にNULLが表示されます。

検索結果の行数が表示されます。表示できる行数の上限を超えた場合，アスタリスク（*）が3つ表示されます。

#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定した場合は，SQL文の実行時間が出力されます。

検索結果の表示形式を次の表に示します。

表42‒10　検索結果の表示形式

項番

検索結果のデータ型

検索結果の表示形式※1

1

INTEGER

整数データの最も短い定数形式が右詰めで表示されます。

正の数の場合，"＋"符号は表示されません。負の数の場合，"−"符号が有効データの直前に表示されます。

2

BIGINT

3

SMALLINT

4

DECIMAL※3

小数点以下は，導出される列の結果の位取り分が右詰めで表示されます。なお，導出される列の結果の位取りが0で，かつ-dオプションを指定しているときは，小数点は出力されません。

整数部分は最も短い形式で表示されます。

正の数の場合，"＋"符号は表示されません。負の数の場合，"−"符号が有効データの直前に表示されます。

5

NUMERIC※3

6

DOUBLE PRECISION

指数部は最も短い形式で表示されます。仮数部は17桁固定で表示されます。全体は右詰めで表示されます。

正の数の場合，"＋"符号は表示されません。負の数の場合，"−"符号が有効データの直前に表示されます。

7

FLOAT

8

CHARACTER※5

各データ型の定数形式からアポストロフィ（ ' ）を除いた形で表示されます。ただし，表示できない文字（X'00'〜X'1F'）はコロン（ : ）で表示されます。

9

VARCHAR※6

10

DATE※5

日付データの既定の出力表現に従った形式で表示されます。日付データの既定の出力表現については，マニュアルHADB　SQLリファレンスの既定の文字列表現を参照してください。

11

TIME※5

時刻データの既定の出力表現に従った形式で表示されます。時刻データの既定の出力表現については，マニュアルHADB　SQLリファレンスの既定の文字列表現を参照してください。

12

TIMESTAMP※5

時刻印データの既定の出力表現に従った形式で表示されます。時刻印データの既定の出力表現については，マニュアルHADB　SQLリファレンスの既定の文字列表現を参照してください。

13

BINARY※4，※5

選択式にBINARYを指定した場合は，次のどちらかの形式で表示されます。

16進形式

2進形式

14

VARBINARY※4，※6

選択式にVARBINARYを指定した場合は，次のどちらかの形式で表示されます。

16進形式

2進形式

15

ROW※2，※5

選択式にROWを指定した場合は，16進形式で表示されます。

16

ARRAY

配列データは，次の形式で表示されます。

{配列要素1,配列要素2,…,配列要素N}

表示規則を次に示します。

配列要素1～配列要素Nの表示形式は，項番1～13で説明している各データ型の表示形式に従います。表示例を次に示します。

（例）

要素データ型がINTEGER型の場合

{1,2,3}

要素データ型がVARCHAR型の場合

{ABC,DEF,GH}

要素データ型がDATE型の場合

{2020-10-01,2020-11-01,2020-12-01}

次の条件に該当する配列要素は，二重引用符（"）で囲まれて表示されます。※7

要素データ型がCHARACTER型またはVARCHAR型で，配列要素にコンマ（,）が含まれる場合

要素データ型がCHARACTER型またはVARCHAR型で，配列要素がNULLという文字列の場合※8

要素データ型がVARCHAR型またはVARBINARY型で，配列要素の長さが0バイトの場合

表示例を次に示します。

（例）

{ABC,"DE,F","NULL","",GH}

空の配列データの場合は，次のように表示されます。

{}

最大要素数が多い場合や，ARRAY_AGG集合関数を使用した場合，表示される検索結果が非常に長くなります。その場合，-sオプションを指定して，SELECT文の実行結果を標準出力にCSV形式で出力してください。

注※1

文字形式に変換できない場合は，データを文字形式で表現したときの最大長の数分の疑問符（?）が表示されます。

注※2

選択式にROWを指定した場合はこのデータ型になります。

注※3

DECIMAL型またはNUMERIC型の精度と位取りが同じ場合，先頭に0が付与されます。ただし，-sオプションを指定した場合で，精度と位取りが38の場合は0は付与されません。

注※4

どちらの形式で表示されるかは，adbsqlコマンドの-bオプション，または#SET BINARY_DISP_MODEの指定に従います。ただし，#SET DUMPMODEでON（検索結果を16進形式で表示）を指定した場合は，#SET BINARY_DISP_MODEの指定に関係なく，16進形式で表示されます。

注※5

データを文字形式で表現した場合の最大長が列の最大幅より短いとき，データは列の最大幅に対して右詰めで表示されます。それ以外のときは左詰めで表示されます。

注※6

データを文字形式で表現した場合の最大長が列の最大幅より短いとき，データを文字形式で表現した場合の最大長と列の最大幅との差分の空白が，データの左側に付与されて表示されます。それ以外のときは左詰めで表示されます。

注※7

-sオプションを指定した場合，各配列要素は二重引用符（"）2個で囲まれて出力されます。ただし，配列要素がナル値の場合は，NULL（二重引用符で囲まれない）と出力されます。

注※8

配列要素がNULLという文字列の場合は"NULL"と表示され，配列要素がナル値の場合はNULLと表示されます。

42.7.3　操作系SQLの場合（DELETE文，INSERT文およびUPDATE文）

DELETE文，INSERT文およびUPDATE文を実行した場合，次に示す形式で操作行数が表示されます。操作行数がオーバフローした場合は，アスタリスク（*）が3つ表示されます。

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
DELETE FROM "T1" WHERE "C1"=0;
KFAA96404-I            1 rows were deleted.
KFAA96415-I SQL processing time (Execute) : 40.011020 sec.

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
INSERT INTO "T1"("C1","C2") VALUES(+1520.34,'abc');
KFAA96404-I            1 rows were inserted.
KFAA96415-I SQL processing time (Execute) : 0.501823 sec.

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
UPDATE "T1" SET "C1"=0 WHERE "C1"<0;
KFAA96404-I            2 rows were updated.
KFAA96415-I SQL processing time (Execute) : 120.991024 sec.

KFAA96415-Iメッセージは，#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定した場合に出力されます。

42.7.4　操作系SQLの場合（PURGE CHUNK文およびTRUNCATE TABLE文）

PURGE CHUNK文およびTRUNCATE TABLE文を実行した場合，SQL文の実行後，次に示す形式で完了のメッセージが表示されます。

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
PURGE CHUNK "T1" WHERE CHUNKID=1;
KFAA96403-I SQL processing completed.
KFAA96415-I SQL processing time (Execute) : 0.901023 sec.

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
TRUNCATE TABLE "T1";
KFAA96403-I SQL processing completed.
KFAA96415-I SQL processing time (Execute) : 0.000865 sec.

KFAA96415-Iメッセージは，#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定した場合に出力されます。

42.7.5　制御系SQLの場合

制御系SQL，またはadbsqlサブコマンドの#DISCONNECTを実行した場合，次に示す形式で完了のメッセージが表示されます。

COMMAND ?     +----2----+----3----+----4----+----5----+----6----+----7----+
COMMIT;
KFAA96403-I SQL processing completed.
KFAA96415-I SQL processing time (Execute) : 0.000034 sec.

KFAA96415-Iメッセージは，#SET EXECTIME REPORTでON（SQL文の実行時間を出力する）を指定した場合に出力されます。

42.8　注意事項

X'00'〜X'1F'のコードを指定した場合，空白に変換されます。

SQL文およびadbsqlサブコマンドの終わりには，セミコロン（ ; ）を記述してください。セミコロン以降は，注釈として扱われます。セミコロンがない場合は，継続行（SQL文またはadbsqlサブコマンドが途中である）として扱われます。例を次に示します。

（例）

CREATE TABLE "T1" ("C1" INT,     ←継続行
"C2" CHAR(10),                   ←継続行
"C3" CHAR(10)) IN DBAREA01;      ←SQL文の終了

行を連結する場合は，改行記号を空白に置き換えたあとに連結します。

SQL文中の「/*」から，それ以降に現れる最初の「*/」までの文字は，すべて注釈として扱われます。注釈の詳細については，マニュアルHADB　SQLリファレンスの分離符号に関する規則を参照してください。

「/*」から「*/」の間にあるセミコロン（ ; ）も，注釈として扱われます。

例を次に示します。

（例）

/* COMMENT */ SELECT * FROM "T1";

HADBサーバからメモリ不足のエラーが返された場合（KFAA30000番台のエラーメッセージが出力された場合）は，メモリの上限を見直してください。ただし，KFAA96457-Eメッセージが出力された場合は，ほかのプロセスの終了を待ったあとにadbsqlコマンドを再実行してください。

adbsqlコマンドの実行時，次の表に示すファイルにアクセスします。adbsqlコマンドを実行する前に，ファイルに次の表に示すパーミッションを設定してください。

表42‒11　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※

必要な権限

クライアント定義ファイル

コマンドの実行ユーザ

読み取り権限

注※

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

43　adbstart（HADBサーバの開始）

この章では，adbstartコマンドの機能と使い方について説明します。

43.1　機能

HADBサーバを開始します。また，HAモニタありのマルチノード構成の場合，マルチノード構成から切り離されたノードでadbstartコマンドを実行すると，稼働中のマルチノード構成に復帰します。

HADBサーバを開始したときの開始モードは次のようになります。

HADBサーバの終了モードが正常終了の場合は正常開始になります。

HADBサーバの終了モードが強制終了または異常終了の場合は再開始になります。再開始の場合は，処理中のトランザクションの回復処理が行われます。

また，オプションでHADBサーバ開始時の稼働モードを指定できます。HADBサーバの稼働モードには，次に示す4種類があります。

通常モード

静止モード

オフラインモード

メンテナンスモード

HADBサーバの稼働モードの詳細については，マニュアルHADB　システム構築・運用ガイドの定期運用のHADBサーバの開始・終了と稼働モードのHADBサーバの稼働モードを参照してください。

なお，HADBサーバの稼働モードによって，実行できるSQL文，およびコマンドが異なります。詳細については，「43.3　各稼働モードで実行できるSQL文およびコマンド」を参照してください。

［マルチノード機能］

HAモニタありのマルチノード構成のHADBサーバを開始する場合は，プライマリノードおよび各セカンダリノードでadbstartコマンドを実行してください。

プライマリノードおよび全セカンダリノードの開始処理が完了したあとに，ワーカーノードでadbstartコマンドを実行し，マルチノード構成にワーカーノードを追加してください。なお，プライマリノードおよび全セカンダリノードの開始処理が完了する前に，ワーカーノードでadbstartコマンドを実行すると，マルチノード構成のHADBサーバの開始処理がエラーになります。

HAモニタなしのマルチノード構成のHADBサーバを開始する場合は，プライマリノードでadbstartコマンドを実行してください。プライマリノードの開始処理が完了したあとに，ワーカーノードでadbstartコマンドを実行し，マルチノード構成にワーカーノードを追加してください。なお，プライマリノードの開始処理が完了する前に，ワーカーノードでadbstartコマンドを実行すると，マルチノード構成のHADBサーバの開始処理がエラーになります。

マルチノード構成にワーカーノードを追加する場合，複数のワーカーノードを同時に追加できます。

マルチノード構成へのノードの復帰については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のプライマリノードまたはセカンダリノードでノード障害が発生した場合の運用（HAモニタありのマルチノード構成の場合）のマルチノード構成へのノードの復帰を参照してください。

マルチノード構成へのワーカーノードの追加については，マニュアルHADB　システム構築・運用ガイドのマルチノード構成のHADBサーバの開始方法のマルチノード構成のHADBサーバの開始手順を参照してください。

［クライアント定義の集中管理機能］

クライアント管理定義ファイル（$ADBDIR/conf/adbclientdefmang.def）が存在する状態でadbstartコマンドを実行すると，クライアント定義の集中管理機能を適用できます。

［DBエリア暗号化機能］

サーバ定義のadb_crypto_dmkey_pathオペランドにHADB暗号鍵ファイルのパス名が指定されている場合，adbstartコマンドを実行すると，HADB暗号鍵利用パスワードの入力を求めるKFAA90013-Qメッセージが出力されます。adb_crypto_dmkey_pathオペランドに指定されているHADB暗号鍵ファイルを作成したときに設定した，HADB暗号鍵利用パスワードを入力してください。

DBエリア暗号化機能については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を参照してください。

43.2　adbstartコマンドの指定形式

adbstartコマンドの指定形式およびオプションについて説明します。

adbstartコマンドを実行できるOSユーザは，HADB管理者だけです。

43.2.1　指定形式およびオプションの説明

(1)　指定形式

adbstart 〔｛--normal｜--quiescence｜--offline｜--maintenance｝〕

(2)　オプションの説明

HADBサーバ開始時の稼働モードを指定します。

オプションを何も指定しないでHADBサーバを開始した場合，前回のHADBサーバ終了時の稼働モード（通常モード，静止モード，オフラインモード，またはメンテナンスモード）が引き継がれます。例えば，前回のHADBサーバ終了時の稼働モードが静止モードであれば，次のHADBサーバ開始時の稼働モードも静止モードとなります。ただし，初めてHADBサーバを開始するときにオプションを省略すると，HADBサーバの稼働モードは通常モードになります。

マルチノード機能を使用する場合，プライマリノードのHADBサーバを開始するときには，指定した稼働モードが有効になります。ただし，セカンダリノードおよびワーカーノードのHADBサーバを開始するときには，指定した稼働モードは無視され，常に静止モードで開始されます。

●--normal

HADBサーバの稼働モードを，通常モードで開始する場合に指定します。

●--quiescence

HADBサーバの稼働モードを，静止モードで開始する場合に指定します。

●--offline

HADBサーバの稼働モードを，オフラインモードで開始する場合に指定します。

●--maintenance

HADBサーバの稼働モードを，メンテナンスモードで開始する場合に指定します。

43.3　各稼働モードで実行できるSQL文およびコマンド

HADBサーバの稼働モードによって，実行できるSQL文，およびコマンドが異なります。各稼働モードで実行できるSQL文およびコマンドについて，次の表に示します。

表43‒1　各稼働モードで実行できるSQL文およびコマンド

項番

SQL文およびコマンド名

通常モード

静止モード

オフラインモード

メンテナンスモード

サーバマシンでの実行※1

サーバマシンとは異なるマシンからの実行※2

1

検索系SQL

○

○

○

×

×

2

更新系SQL

○

×

○

×

×

3

定義系SQL

○

×

○

×

×

4

制御系SQL

○

○

○

×

×

5

adbarchivechunkコマンド

○

×

○

−

×

6

adbaudittrailコマンド

○

×※5

○

−

○

7

adbcancelコマンド

○

○

○

−

○

8

adbchgchunkcommentコマンド

○

×

○

−

×

9

adbchgchunkstatusコマンド

○

×

○

−

×

10

adbchgnodetypeコマンド

○

○

○

−

○

11

adbchgsqltrcコマンド

○

○

○

−

○

12

adbchgsrvmodeコマンド

○

○

○

−

○

13

adbclientdefmangコマンド

○

○

○

−

○

14

adbcolumnizeコマンド

○

×

○

−

○

15

adbconvertaudittrailfileコマンド

○

○

○

−

○

16

adbdbstatusコマンド

○

○

○

−

×

17

adbexportコマンド

○

○

○

−

×

18

adbgetcstコマンド

○

×

○

−

×

19

adbidxrebuildコマンド

○

×

○

−

×

20

adbimportコマンド

○

×

○

−

×

21

adbinfogetコマンド

○

○

○

−

○

22

adbinfosweepコマンド※3

×

×

×

−

×

23

adbinitコマンド※3

×

×

×

−

×

24

adbinstallコマンド※3

×

×

×

×

×

25

adblsコマンド

○

○

○

−

○

26

adbmergechunkコマンド

○

×

○

−

×

27

adbmkdmkコマンド

○

○

○

−

×

28

adbmodareaコマンド

○

×

○

−

○

29

adbmodbuffコマンド

○

○

○

−

×

30

adbmonitorコマンド

○

○

○

−

○

31

adboptinstallコマンド※3

×

×

×

×

×

32

adbreorgsystemdataコマンド

○

×

○

−

×

33

adbsqlコマンド※4

○

○

○

×

×

34

adbstartコマンド※3

×

×

×

−

×

35

adbstatコマンド

○

○

○

−

○

36

adbstopコマンド

○

○

○

−

○

37

adbsyndictコマンド

○

×

○

−

×

38

adbunarchivechunkコマンド

○

×

○

−

×

39

adbupddmkコマンド

×

×

×

−

○

（凡例）

○：実行できます。

×：実行できません（エラーになります）。

−：HADBサーバがインストールされているサーバマシンで実行するコマンドのため，該当しません。

注※1

サーバマシンでの実行とは，HADBサーバがインストールされているサーバマシンでの実行のことです。

注※2

サーバマシンとは異なるマシンからの実行とは，HADBサーバがインストールされているサーバマシンとは異なるマシンからの実行のことです。

注※3

HADBサーバの稼働中には実行できないコマンドです。

注※4

実行できるSQL文については，項番1から項番4を参照してください。

注※5

--swapオプション，または-dオプションを指定した場合は，adbaudittrailコマンドを実行できます（エラーになりません）。

43.4　使用例

HADBサーバを開始します（この例では，前回のHADBサーバ終了時の稼働モードを通常モードとしています。そのため，HADBサーバ開始時の稼働モードは通常モードになります）。

adbstart

KFAA90000-I adbstart processing started.
KFAA91105-I The HADB system was started normally. (HADB server operation mode = "NORMAL")
KFAA90001-I adbstart processing ended. (return code = 0)

43.5　リターンコード

adbstartコマンドのリターンコードを次の表に示します。

表43‒2　adbstartコマンドのリターンコード

リターンコード

意味

0

adbstartコマンドが正常に終了しました。

4

adbstartコマンドが警告メッセージ，またはエラーメッセージを出力して終了しました。HADBサーバは開始しています。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

8

adbstartコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

43.6　注意事項

前回の終了モードが異常終了の場合，HADBサーバの開始時にKFAA91104-Qメッセージ（トラブルシュート情報を削除してよいかどうかの確認メッセージ）が出力されます。adbinfogetコマンドでトラブルシュート情報をすでに取得している場合，またはadbinfogetコマンドでトラブルシュート情報を取得する必要がない場合は，KFAA91104-Qメッセージに対してy（またはY）を入力してください。y（またはY）を入力すると，トラブルシュート情報を破棄してHADBサーバを開始します。adbinfogetコマンドでトラブルシュート情報を取得していない場合は，KFAA91104-Qメッセージに対してn（またはN）を入力してください。n（またはN）を入力すると，adbstartコマンドの処理を中止します。

HADBサーバを新しいバージョンに入れ替えてからadbstartコマンドを実行すると，データベースをバージョンアップするかどうかを確認するKFAA91107-Qメッセージが出力されます。バージョンアップしても問題ない場合は，このメッセージにy（またはY）を入力してください。adbstartコマンドが正常終了すると，HADBサーバのバージョンアップが完了します。バージョンアップすると問題がある場合は，n（またはN）を入力してください。n（またはN）を入力すると，HADBサーバのバージョンアップ処理は中止され，adbstartコマンドが終了します。

HADBサーバをバージョンアップする方法については，マニュアルHADB　システム構築・運用ガイドのシステム構築のHADBサーバのバージョンアップを参照してください。

前回のHADBサーバの終了時に監査証跡機能が有効な場合，次回のHADBサーバの開始時も監査証跡機能は有効なままです。また，adbaudittrailコマンドの--write-errorオプションの指定内容も引き継がれます。adbaudittrailコマンドについては，「3.　adbaudittrail（監査証跡機能の管理）」を参照してください。

監査証跡機能が有効な場合，HADBサーバの開始時に，新たな現用の監査証跡ファイルが生成されます。なお，HADBサーバを再開始する場合は，前回のHADBサーバ終了時点で現用だった監査証跡ファイルがリネームされます。そのあとで，新たな現用の監査証跡ファイルが生成されます。

監査証跡機能が有効な場合，次のすべての条件を満たしていないと，HADBサーバを開始できません。adbstartコマンドがエラーになります。

サーバ定義adb_audit_log_pathオペランドに，存在するディレクトリを指定している

サーバ定義adb_audit_log_pathオペランドに指定したディレクトリに対して，HADB管理者がアクセスできるように書き込み権限，読み取り権限および実行権限を設定している

サーバ定義adb_audit_log_pathオペランドに指定したディレクトリ下に格納されている監査証跡ファイルの数が，サーバ定義adb_audit_log_max_numオペランドの指定値以下である

マルチノード機能を使用している場合で，マルチノード構成から切り離されたノードを，稼働中のマルチノード構成に復帰させるときは，次のことを実行してください。

adbchgsrvmodeコマンドで，プライマリノードのHADBサーバの稼働モードをメンテナンスモードにするなどして，実行中のトランザクションが存在しないようにしてください。adbchgsrvmodeコマンドについては，「9.　adbchgsrvmode（HADBサーバの稼働モードの変更）」を参照してください。

事前に，ほかのノードのHADBサーバの状態を確認してください。次に示す場合は，切り離されたノードをマルチノード構成に復帰させることはできません。

ほかのノードのHADBサーバが終了処理中の場合

マルチノード構成へのワーカーノードの追加処理中の場合

HADBサーバの状態を確認するには，各ノードでadbls -d srvコマンドを実行してください。出力結果の「STATUS」列で，コマンドを実行したノードのHADBサーバの状態を確認できます。adbls -d srvコマンドについては，「32.　adbls -d srv（HADBサーバの状態表示）」を参照してください。

マルチノード構成に復帰させたいノードが複数ある場合は，1ノードずつ復帰させてください。複数のノードを同時に復帰させることはできません。

マルチノード構成へのノードの復帰については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のプライマリノードまたはセカンダリノードでノード障害が発生した場合の運用（HAモニタありのマルチノード構成の場合）のマルチノード構成へのノードの復帰を参照してください。

マルチノード構成に復帰中のノードが存在している間は，ワーカーノードを追加できません。ノードの復帰と，ワーカーノードの追加は別々に実行してください。

また，次の場合も，マルチノード構成にワーカーノードを追加できません。

プライマリノード，またはセカンダリノードのHADBサーバが終了処理中の場合（異常終了の終了処理も含みます）

プライマリノードでadbmodareaコマンドまたはadbupddmkコマンドを実行中の場合

HADBサーバの状態を確認するには，各ノードでadbls -d srvコマンドを実行してください。出力結果の「STATUS」列で，コマンドを実行したノードのHADBサーバの状態を確認できます。adbls -d srvコマンドについては，「32.　adbls -d srv（HADBサーバの状態表示）」を参照してください。

次のトランザクションまたはコマンドをプライマリノードで実行している間は，ワーカーノードの追加処理は待ち状態になります。トランザクションまたはコマンドの処理が完了したあとに，ワーカーノードの追加処理が開始されます。

読み書き可能トランザクション

adbimportコマンド

adbidxrebuildコマンド

adbgetcstコマンド

adbmergechunkコマンド

adbchgchunkcommentコマンド

adbchgchunkstatusコマンド

adbarchivechunkコマンド

adbunarchivechunkコマンド

adbreorgsystemdataコマンド

adbsyndictコマンド

adbaudittrailコマンド（--swapオプションまたは-dオプションを指定した場合を除く）

adbcolumnizeコマンド

DBエリア暗号化機能を使用している場合，次の条件を満たしていないと，HADBサーバを開始できません。adbstartコマンドがエラーになります。

サーバ定義adb_crypto_dmkey_pathオペランドに，HADB暗号鍵ファイルの絶対パス名を指定していること

次の状態でadbstartコマンドを実行すると，HADBサーバの開始時に警告メッセージKFAA51423-Wが出力されます。その場合は，HADBサーバが開始したあとにadbmodareaコマンドを実行して，暗号化されたデータ用DBエリアを追加してください。

サーバ定義adb_crypto_dmkey_pathオペランドに，HADB暗号鍵ファイルの絶対パス名を指定している

暗号化されたDBエリアを1つも作成していない

メモ

DBエリア暗号化機能を使用するためにadb_crypto_dmkey_pathオペランドを指定しているが，暗号化しているDBエリアが1つもないときに，この警告メッセージKFAA51423-Wが出力されます。

adbstartコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbstartコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表43‒3　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

サーバ定義ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

サーバ定義adb_db_pathオペランドに指定したDBディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_core_pathオペランドに指定した障害情報（コアファイル）の出力先ディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_audit_log_pathオペランドに指定した監査証跡の出力先ディレクトリ（監査証跡機能を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_crypto_dmkey_pathオペランドに指定したHADB暗号鍵ファイル（DBエリア暗号化機能を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限※2

サーバ定義adb_auth_passwd_privkey_pathオペランドに指定したパスワードの復号に使用する秘密鍵ファイル（PAM認証を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

サーバ定義adb_cmd_passwd_pubkey_pathオペランドに指定したコマンド実行時に指定したパスワードの暗号化に使用する公開鍵ファイル（PAM認証を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

サーバ定義adb_sys_cld_cache_pathオペランドに指定したキャッシュファイルの格納先ディレクトリ（クラウドストレージ機能を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_sta_log_pathオペランドに指定した統計ログファイルの出力先ディレクトリ

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_syndict_storage_pathオペランドに指定した同義語辞書ファイルの格納ディレクトリ（同義語検索を行う場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

サーバ定義adb_syndict_node_storage_pathオペランドに指定したマルチノード機能で使用する同義語辞書ファイルの格納ディレクトリ（マルチノード機能の使用時に同義語検索を行う場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

クライアント管理定義ファイル（クライアント定義の集中管理機能を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

クライアント管理定義のadbclientmangオペランドの-fオプションに指定したクライアント定義の集中管理機能で使用するクライアント定義ファイル（クライアント定義の集中管理機能を使用する場合）

HADBサーバプロセスの実行ユーザ

読み取り権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

注※2

HADB暗号鍵ファイルの権限は，400を設定してください。また，HADB暗号鍵ファイルの保存先ディレクトリの権限は，700を設定してください。

44　adbstat（HADBサーバの統計解析）

この章では，adbstatコマンドの機能と使い方について説明します。

なお，この章の「表」は実表を意味しています。

44.1　機能

adbstatコマンドを実行すると，HADBサーバの稼働情報が出力されます。adbstatコマンドの概要を次の図に示します。

図44‒1　adbstatコマンドの概要

［説明］

adbstatコマンドを実行すると，HADBサーバの稼働情報が標準出力にCSV形式で出力されます。出力結果をリダイレクションでファイルに出力して表計算ソフトなどに転送すると，表形式でHADBサーバの稼働情報を確認できます。

統計ログファイルとは，HADBサーバの稼働情報の一部が出力されるファイルです。詳細については，マニュアルHADB　システム構築・運用ガイドの定期運用の統計解析の運用（HADBサーバの稼働情報の確認）の統計ログファイルの運用を参照してください。

adbstatコマンドで出力される情報には，次の4種類があります。

HADBサーバの統計情報

HADBサーバの稼働状況が出力されます。adbstatコマンドを実行すると，1行だけ出力されます。

コネクションの稼働情報

コネクションの稼働状況が出力されます。adbstatコマンドの実行時に，該当するAPおよびコマンドで確立されているコネクションごとに情報が出力されます。

グローバルバッファの統計情報

グローバルバッファ単位の動作状況が出力されます。adbstatコマンドを実行すると，グローバルバッファごとに情報が出力されます。

SQL文の統計情報

SQL文の動作状況が出力されます。adbstatコマンドを実行すると，統計ログファイルに出力されている統計情報から，SQL文ごとに「SQL文でアクセスしたDBエリア数」分の情報が出力されます。SQL文でDBエリアにアクセスしなかった場合は，SQL文の情報が1行出力されます。

ただし，？パラメタの値の一括転送が適用されたSQL文の統計情報は，1つのSQL文の統計情報としてまとめて出力されます。？パラメタの値の一括転送については，マニュアルHADB　AP開発ガイドのAPの性能向上に関する設計の？パラメタの値の一括転送を参照してください。

重要

アクセスパスの統計情報は，adbstatコマンドでは出力されません。アクセスパスの統計情報については，マニュアルHADB　システム構築・運用ガイドの定期運用のSQLトレース機能の運用のアクセスパスの統計情報の出力例と出力項目を参照してください。

44.2　adbstatコマンドの指定形式

adbstatコマンドの指定形式およびオプションについて説明します。

adbstatコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

44.2.1　指定形式およびオプションの説明

(1)　指定形式

adbstat
  〔-c ｛sys｜cnct｜buf｜sql｝〕
  〔-n ｛AP識別子｜グローバルバッファ名｜コネクション情報｝〕
  〔-m SQL文の統計情報の出力日時指定〕
  〔-q SQL文通番〕
  〔-t〕
  〔-k 囲み文字〕
  〔-s ｛区切り文字｜tab｝〕

(2)　出力される情報とオプションの組み合わせの関係

adbstatコマンドで出力できる情報と，指定するオプションの組み合わせの関係について，次の2つの表に示します。出力される情報の詳細については，「44.5　出力される項目」を参照してください。

■指定するオプションの組み合わせ（その1）

adbstatコマンドで出力できる情報のうち，次に示す情報を出力する場合の，出力される情報とオプションの組み合わせの関係を次の表に示します。

HADBサーバの統計情報

コネクションの稼働情報

グローバルバッファの統計情報

表44‒1　adbstatコマンドで出力される情報とオプションの組み合わせの関係（その1）

項番

出力される情報

オプションの指定

-cオプション

-nオプション

1

HADBサーバの統計情報

sysまたは指定しない

−※

2

すべての有効なコネクションの稼働情報

cnct

−

3

特定のコネクションの稼働情報

cnct

AP識別子

4

すべてのグローバルバッファの統計情報

buf

−

5

特定のグローバルバッファの統計情報

buf

グローバルバッファ名

（凡例）

−：-nオプションを指定しません。

注※

-cオプションにsysを指定した場合，または-cオプションを省略した場合，-nオプションを指定するとエラーになります。

■指定するオプションの組み合わせ（その2）

adbstatコマンドで出力できる情報のうち，SQL文の統計情報を出力する場合の，出力される情報とオプションの組み合わせの関係を次の表に示します。

メモ

ここでは，SQL文の統計情報を出力する場合の，推奨するオプションの組み合わせについて説明しています。

SQL文の統計情報をそのまま出力しようとすると，情報量が多くなることがあります。次の表に示すようにオプションを組み合わせると，出力対象を絞り込めるため，必要な情報を参照しやすくなります。

表44‒2　adbstatコマンドで出力される情報とオプションの組み合わせの関係（その2）

項番

出力される情報

オプションの指定

-cオプション

-nオプション

-mオプション

-qオプション

1

特定のSQL文に関するSQL文の統計情報のうち，特定の期間に統計ログファイルに出力された情報

sql

コネクション情報

SQL文の統計情報の出力日時指定

SQL文通番

2

特定のコネクションで実行したSQL文に関するSQL文の統計情報のうち，特定の期間に統計ログファイルに出力された情報

sql

コネクション情報

SQL文の統計情報の出力日時指定

−

3

特定の期間に統計ログファイルに出力されたSQL文の統計情報

sql

−

SQL文の統計情報の出力日時指定

−

4

特定のSQL文に関するSQL文の統計情報

sql

コネクション情報

−

SQL文通番

5

特定のコネクションで実行したSQL文に関するSQL文の統計情報

sql

コネクション情報

−

−

6

直近5分間のSQL文の統計情報

統計ログファイルに最後に出力された情報を起点として，5分間さかのぼった範囲が対象となります。

sql

−

−

−

（凡例）

−：オプションを指定しません。

(3)　オプションの説明

●-c ｛sys｜cnct｜buf｜sql｝

出力される情報の種類を指定します。

sys：HADBサーバの統計情報

cnct：コネクションの稼働情報

buf：グローバルバッファの統計情報

sql：SQL文の統計情報

●-n ｛AP識別子｜グローバルバッファ名｜コネクション情報｝

〜〈文字列〉

特定のコネクションの情報，または特定のグローバルバッファの情報を出力したい場合，このオプションを指定します。

AP識別子：

情報が出力されるAP識別子を指定します。-cオプションにcnctを指定した場合に，指定できます。

グローバルバッファ名：

情報が出力されるグローバルバッファ名を指定します。-cオプションにbufを指定した場合に，指定できます。

コネクション情報：

情報が出力されるコネクション情報を指定します。-cオプションにsqlを指定した場合に，指定できます。

コネクション情報は，SQL文の統計情報を絞り込んで参照したい場合に指定してください。指定したコネクション情報に該当する情報だけを出力できます。

メモ

出力対象をより絞り込みたいときは，このオプションでコネクション情報を指定すると同時に，-mオプションで出力日時を指定したり，-qオプションでSQL文通番を指定したりしてください。

存在しないAP識別子，グローバルバッファ，またはコネクション情報をこのオプションに指定した場合，情報は出力されません（タイトル行だけが出力されます）。-tオプションを指定している場合，情報とタイトル行のどちらも出力されません。

指定時の規則を次に示します。

AP識別子またはグローバルバッファ名に指定した文字列は，すべて英大文字として扱われます。

AP識別子またはグローバルバッファ名に英小文字が含まれる場合は，名称を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲んでください。二重引用符（"）およびアポストロフィ（'）で囲むことで，英大文字と英小文字が区別されます。

（例）-n '"ap001"'

コネクション情報は，英大文字と英小文字が区別されません。

コネクション情報には，次のどちらかの情報を指定してください。

・コネクション確立時にメッセージログファイルに出力されるKFAA81000-Iメッセージのコネクション情報

・adbls -d cnctコマンドの実行結果のCID欄で確認したコネクションID

adbls -d cnctコマンドについては，「24.　adbls -d cnct（コネクションの状態表示）」を参照してください。

●-m SQL文の統計情報の出力日時指定

SQL文の統計情報を出力する範囲を，統計ログファイルに情報が出力された日時で指定します。

指定した範囲で統計ログファイルに情報が出力されていない場合，情報は出力されません（タイトル行だけが出力されます）。-tオプションを指定している場合，情報とタイトル行のどちらも出力されません。

次の形式で指定してください。

出力開始日時〔,出力終了日時〕

指定時の規則を次に示します。

-cオプションにsqlを指定した場合だけ，このオプションを指定できます。

出力開始日時および出力終了日時は，次のどちらかの形式で指定してください。

・yyyy/mm/dd△hh:mm:ss

・yyyy-mm-dd△hh:mm:ss

（凡例）　△：空白

出力開始日時，および出力終了日時は空白を含むため，次のどれかの方法で指定してください。

（例1）出力開始日時だけ指定する場合に，出力開始日時全体をアポストロフィ（'）で囲む

-m '2014/06/06 12:00:00'

（例2）出力開始日時および出力終了日時を指定する場合に，それぞれをアポストロフィ（'）で囲む

-m '2014/06/06 12:00:00','2014/06/06 13:00:00'

（例3）出力開始日時および出力終了日時を指定する場合に，日時指定全体をアポストロフィ（'）で囲む

-m '2014/06/06 12:00:00,2014/06/06 13:00:00'

出力開始日時と出力終了日時の間のコンマ（ , ）の前後に空白を指定しないでください。

存在しない日時を指定した場合，エラーとなります。

出力終了日時が出力開始日時より前の日時となる場合，エラーとなります。

出力終了日時を省略した場合，出力開始日時以降の範囲で統計ログファイルに保持している統計情報がすべて出力対象となります。

統計情報の出力対象は，統計ログファイルへの出力日時が，このオプションに指定した出力開始日時以降，出力終了日時以前となる情報です。出力範囲の判定時には，統計ログファイルへの出力日時の小数秒部分を切り捨てた値が，出力開始日時および出力終了日時と比較されます。

●-q SQL文通番

〜〈整数〉((1〜18,446,744,073,709,551,615))

SQL文の統計情報として出力するSQL文を，SQL文通番で指定します。

存在しないSQL文通番をこのオプションに指定した場合，情報は出力されません（タイトル行だけが出力されます）。-tオプションを指定している場合，情報とタイトル行のどちらも出力されません。

指定時の規則を次に示します。

-cオプションにsqlを指定した場合だけ，このオプションを指定できます。

このオプションには，メッセージログファイルに出力されるKFAA51000-Iメッセージの「コネクションが確立してからのSQL文通番」を指定してください。

重要

メッセージログファイルにKFAA51000-Iメッセージを出力するためには，あらかじめ，サーバ定義のadb_sql_text_outオペランドでSQL文をメッセージログファイルに出力するように設定しておく必要があります。

サーバ定義のadb_sql_text_outオペランドについては，マニュアルHADB　システム構築・運用ガイドのサーバ定義の設計のサーバ定義のオペランドの内容のSQL文に関するオペランド（set形式）を参照してください。

●-t

タイトル行を出力しない場合に指定します。

●-k 囲み文字

〜〈文字列〉((1バイト))《"》

CSV形式での文字列の囲み文字を指定します。このオプションを省略した場合は，囲み文字として二重引用符（"）が仮定されます。

囲み文字として指定できる文字は，1バイト文字だけです。2バイト以上の文字列は指定できません。また，次に示す文字も囲み文字として指定できません。

空白，タブ，アスタリスク（*）

区切り文字（-sオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を囲み文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を囲み文字として指定する場合の例

adbstat …　-k "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を囲み文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を囲み文字として指定する場合の例

adbstat …　-k "|" …

adbstatコマンドで出力される列のタイトルおよび内容に含まれる文字を囲み文字に指定しないでください。adbstatコマンドで出力される列については，「44.5　出力される項目」を参照してください。

●-s ｛区切り文字｜tab｝

〜〈文字列〉((1バイト))《 , 》

CSV形式での区切り文字を指定します。区切り文字にタブを指定する場合は，tabを指定してください。このオプションを省略した場合は，区切り文字としてコンマ（ , ）が仮定されます。

区切り文字として指定できる文字は，tabと1バイト文字だけです。tab以外の2バイト以上の文字列は指定できません。また，次に示す文字も区切り文字として指定できません。

英大文字（A〜Z），英小文字（a〜z），数字（0〜9），下線（_），二重引用符（"），アスタリスク（*）

囲み文字（-kオプションの指定値または省略値）と同じ文字

重要

アポストロフィ（ ' ）を区切り文字として指定する場合は，二重引用符（"）で囲んで指定してください。

（例）アポストロフィ（ ' ）を区切り文字として指定する場合の例

adbstat …　-s "'" …

ストローク（｜）のように，シェルが別の意味で使用している特殊文字を区切り文字として指定する場合は，二重引用符（"）またはアポストロフィ（ ' ）で囲んで指定してください。

（例）ストローク（｜）を区切り文字として指定する場合の例

adbstat …　-s "|" …

adbstatコマンドで出力される列のタイトルおよび内容に含まれる文字を区切り文字に指定しないでください。adbstatコマンドで出力される列については，「44.5　出力される項目」を参照してください。

44.3　使用例

adbstatコマンドを実行してHADBサーバの稼働情報を調べる方法を例題形式で説明します。

adbstatコマンドを使用したチューニングについては，マニュアルHADB　システム構築・運用ガイドのチューニングを参照してください。

44.3.1　システム全体の稼働状況を調べる場合

システム全体の稼働状況を確認するために，HADBサーバの統計情報を出力します。

■実行するコマンド

adbstat

［説明］

adbstatコマンドを実行します。

44.3.2　特定のAPの稼働状況を調べる場合

特定のAPの稼働状況を調べるために，コネクションの稼働情報を出力します。

(1)　AP識別子を調べる

次のコマンドを実行して，稼働情報を確認するAP識別子を調べます。

■実行するコマンド

adbls -d cnct

■実行結果の例

実行結果のPROGRAM列に，稼働中のAP識別子が出力されます。

(2)　adbstatコマンドを実行する

■実行するコマンド

adbstat -c cnct                 ...1
        -n AP001                ...2

［説明］

コネクションの稼働情報の出力を指定します。

統計情報を出力するAP識別子（AP001）を指定します。

44.3.3　特定のグローバルバッファの稼働状況を調べる場合

特定のグローバルバッファの稼働状況を調べるために，グローバルバッファの統計情報を出力します。

(1)　グローバルバッファ名を調べる

次のどれかの方法で，統計情報を確認するグローバルバッファ名を調べます。

adbls -d gbufコマンドを実行し，グローバルバッファ名を調べます。adbls -d gbufコマンドについては，「25.　adbls -d gbuf（グローバルバッファの情報表示）」を参照してください。

HADBサーバ開始時のメッセージログファイルを確認し，出力されているKFAA50027-Iメッセージのサーバ定義情報から，グローバルバッファ名を調べます。

HADBサーバの開始に使用したサーバ定義ファイル（$ADBDIR/conf/server.def）を参照し，グローバルバッファ名を調べます。

(2)　adbstatコマンドを実行する

■実行するコマンド

adbstat -c buf                  ...1
        -n BUF001               ...2

［説明］

グローバルバッファの統計情報の出力を指定します。

統計情報を出力するグローバルバッファ名（BUF001）を指定します。

44.3.4　特定の日時範囲でSQL文の統計情報を調べる場合

特定の日時範囲でのSQL文の実行状況を調べるために，SQL文の統計情報を出力します。

(1)　SQL文通番を調べる

メッセージログファイルに出力されたKFAA51000-Iメッセージを確認して，出力対象とするSQL文のSQL文通番を調べます。

重要

メッセージログファイルにKFAA51000-Iメッセージを出力するためには，あらかじめ，サーバ定義のadb_sql_text_outオペランドでSQL文をメッセージログファイルに出力するように設定しておく必要があります。

(2)　adbstatコマンドを実行する

■実行するコマンド

adbstat -c sql                                           ...1
        -m '2014/09/28 13:00:00','2014/09/28 15:00:00'   ...2
        -q 4                                             ...3

［説明］

SQL文の統計情報の出力を指定します。

統計情報を出力する日時の範囲（統計ログファイルへの出力日時が，2014年9月28日13時00分00秒から2014年9月28日15時00分00秒まで）を指定します。

統計情報を出力するSQL文のSQL文通番（4）を指定します。

44.4　リターンコード

adbstatコマンドのリターンコードを次の表に示します。

表44‒3　adbstatコマンドのリターンコード

リターンコード

意味

0

adbstatコマンドが正常に終了しました。

8

adbstatコマンドの実行中にエラーが発生しました。エラーの原因については，表示されたメッセージ，またはメッセージログファイルを参照してください。

44.5　出力される項目

adbstatコマンドで出力される項目について説明します。

44.5.1　HADBサーバの統計情報で出力される項目の一覧

HADBサーバの統計情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。

表44‒4　HADBサーバの統計情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

SYS：HADBサーバの統計情報

×

2

Timestamp

HADBサーバの統計情報の出力日時

adbstatコマンドを実行してHADBサーバの統計情報を出力した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

○

3

Last_execute_time

前回の出力日時

HADBサーバの統計情報を最後に出力した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

ただし，HADBサーバを開始してから，初めてHADBサーバの統計情報を出力した場合は，HADBサーバを開始した日時が出力されます。

○

4

Total_memory_max_size

全メモリの最大使用量（単位：バイト）

HADBサーバを開始してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

5

Share_memory_size

共有メモリ管理およびグローバルバッファページで確保された領域サイズ（単位：バイト）

adbstatコマンド実行時に確保されている領域サイズが出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

6

Proc_memory_max_size

プロセス共通メモリの最大使用量（単位：バイト）

HADBサーバを開始してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

7

Rthd_memory_max_size

各リアルスレッド固有メモリの最大使用量の合計値（単位：バイト）

HADBサーバを開始してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

8

Tran_start_cnt

トランザクション開始回数※2

HADBサーバの統計情報を最後に出力したあとに，開始されたトランザクションの回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

9

Tran_commit_cnt

コミット回数※3

HADBサーバの統計情報を最後に出力したあとに，コミットされた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

10

Tran_rollback_cnt

ロールバック回数※3

HADBサーバの統計情報を最後に出力したあとに，ロールバックされた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

11

SQL_execute_wait_total_time

SQL文の実行待ち状態の合計時間（単位：秒）

HADBサーバの統計情報を最後に出力したあとに，SQL文が実行待ち状態になった時間が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

12

SQL_execute_wait_cnt

SQL文の実行待ち状態の発生回数

HADBサーバの統計情報を最後に出力したあとに，SQL文が実行待ち状態になった回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

13

Wrktbl_page_use_max

最大割り当て作業表ページ数

HADBサーバを開始してからadbstatコマンドを実行するまでの間に，割り当てられたページ数が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

14

Log_usrbuf_out_cnt

ユーザログバッファの満杯による掃き出し回数

HADBサーバの統計情報を最後に出力したあとに，掃き出された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

15

Log_usrfile_max_size

ユーザログファイルの最大使用量（単位：バイト）

HADBサーバを開始してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

16

DBarea_extension_cnt

DBエリアの自動増分の回数

HADBサーバの統計情報を最後に出力したあとで，レギュラーファイルのDBエリアファイルで自動増分が発生した回数が出力されます。※4

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

17

Log_usrfile_write_cnt

ユーザログファイルへの書き込み回数

HADBサーバの統計情報を最後に出力したあとに，書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

18

Log_usrfile_reduced_cnt

ユーザログファイルが初期化容量に縮小された回数

HADBサーバの統計情報を最後に出力したあとに，ユーザログファイルが初期化容量に縮小された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

19

Log_mstfile_max_size

システムで使用

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

20

Log_mstfile_reduced_cnt

システムで使用

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

21

Audit_file_write_cnt

監査証跡ファイルへの書き込み回数

HADBサーバの統計情報を最後に出力したあとに，書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

22

Audit_file_write_size

監査証跡ファイルへ書き込んだデータサイズ（単位：バイト）

HADBサーバの統計情報を最後に出力したあとに，書き込んだデータサイズが出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

23

Audit_file_swap_cnt

監査証跡ファイルの切り替え回数

HADBサーバの統計情報を最後に出力したあとに，ファイルを切り替えた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

24

Tbldef_req_cnt

表定義情報の取得要求回数

HADBサーバの統計情報を最後に出力したあとに，表定義情報の取得が要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

25

Tbldef_access_cnt

ディクショナリ表からの表定義情報の取得回数

HADBサーバの統計情報を最後に出力したあとに，ディクショナリ表から表定義情報が取得された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

26

Tbldef_cache_access_cnt

表定義プールからの表定義情報の取得回数

HADBサーバの統計情報を最後に出力したあとに，表定義プールから表定義情報が取得された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

27

Tbldef_cache_register_cnt

表定義プールへの表定義情報の登録回数

HADBサーバの統計情報を最後に出力したあとに，表定義情報が登録された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

28

Tbldef_cache_sweep_cnt

表定義プールからの表定義情報の掃き出し回数

HADBサーバの統計情報を最後に出力したあとに，表定義情報が掃き出された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

29

Cld_instance_type

システムで使用

〔出力形式〕

文字列で出力されます。

○

30

Cld_throughput

システムで使用

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

31

Cld_thd_num

システムで使用

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

（凡例）

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。マイクロ秒（nnnnnn）は6桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

APからの明示的なトランザクション開始回数だけでなく，HADBサーバの開始時やコマンド実行時に，システムが暗黙的に開始したトランザクションの回数も含まれます。

注※3

COMMIT文またはROLLBACK文の実行による，APからの明示的なトランザクション終了回数だけでなく，次の値も回数に含まれます。

定義系SQL文を実行したときに，暗黙的にコミットされた回数

SQLエラーになったときに，暗黙的にロールバックされた回数

HADBサーバの開始時やコマンド実行時に，システムが暗黙的にトランザクションを終了した回数

注※4

作業表用DBエリアの自動増分の回数は含まれません。作業表用DBエリアで自動増分が発生しているかどうかは，「44.5.1　HADBサーバの統計情報で出力される項目の一覧」の「表44‒4　HADBサーバの統計情報で出力される列」にある項番13のWrktbl_page_use_maxの値を基に判断してください。

44.5.2　コネクションの稼働情報で出力される項目の一覧

コネクションの稼働情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。

表44‒5　コネクションの稼働情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

CNCT：コネクションの稼働情報

×

2

Timestamp

コネクションの稼働情報の出力日時

adbstatコマンドを実行してコネクションの稼働情報を出力した日時が次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

○

3

Last_execute_time

前回の出力日時

該当するコネクションの稼働情報を最後に出力した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

ただし，該当するコネクションを確立してから，初めて稼働情報を出力した場合は，そのコネクションを確立した日時が出力されます。※2

○

4

AP_name

AP識別子

APからのコネクションの場合

クライアント定義のadb_clt_ap_nameオペランドに指定されているAP識別子が出力されます。adb_clt_ap_nameオペランドを省略している場合は，"********"が出力されます。

コマンドからのコネクションの場合

コマンド名が出力されます。

adbsqlコマンドの場合は，クライアント定義のadb_clt_ap_nameで指定されているAP識別子が出力されます。

○

5

Connection_num

コネクション通番

HADBサーバの開始後に割り振られるコネクション通番が出力されます。

〔出力形式〕

4バイトの符号あり整数で出力されます。

×

6

Connect_time

コネクション確立日時

該当するコネクションを確立した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

○

7

Tran_start_cnt

トランザクション開始回数※3

該当するコネクションの稼働情報を最後に出力したあとに，開始されたトランザクションの回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

8

Tran_commit_cnt

コミット回数※4

該当するコネクションの稼働情報を最後に出力したあとに，コミットされた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

9

Tran_rollback_cnt

ロールバック回数※4

該当するコネクションの稼働情報を最後に出力したあとに，ロールバックされた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

10

SQL_execute_wait_total_time

SQL文の実行待ち状態の合計時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，SQL文が実行待ち状態になった時間の合計が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

11

SQL_execute_wait_cnt

SQL文の実行待ち状態の発生回数

該当するコネクションの稼働情報を最後に出力したあとに，SQL文が実行待ち状態になった回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

12

Multi_stmt_insufficient_thd_cnt

複数の文ハンドルを同時実行したときの処理スレッド数不足の発生回数

該当するコネクションの稼働情報を最後に出力したあとに，スレッド数不足が発生した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

13

SELECT_cnt

SELECT文の実行回数

該当するコネクションの稼働情報を最後に出力したあとに，SELECT文を実行した回数が出力されます。

なお，SELECT文の実行回数は，カーソルのオープンが正常終了した時点でカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

14

SELECT_total_time

SELECT文の実行時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したSELECT文の実行時間が出力されます。

なお，SELECT文が異常終了した場合も，実行時間にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

15

Fetch_row_cnt

検索行数※5

該当するコネクションの稼働情報を最後に出力したあとに，検索した行数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615行を超えると，ラップアラウンドして0に戻ります。

×

16

INSERT_cnt

INSERT文の実行回数

該当するコネクションの稼働情報を最後に出力したあとに，INSERT文を実行した回数が出力されます。

なお，INSERT文が異常終了した場合は，実行回数にカウントされません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

17

INSERT_total_time

INSERT文の実行時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したINSERT文の実行時間が出力されます。

なお，INSERT文が異常終了した場合も，実行時間にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

18

UPDATE_cnt

UPDATE文の実行回数

該当するコネクションの稼働情報を最後に出力したあとに，UPDATE文を実行した回数が出力されます。

なお，UPDATE文が異常終了した場合は，実行回数にカウントされません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

19

UPDATE_total_time

UPDATE文の実行時間（秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したUPDATE文の実行時間が出力されます。

なお，UPDATE文が異常終了した場合も，実行回数にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

20

DELETE_cnt

DELETE文の実行回数

該当するコネクションの稼働情報を最後に出力したあとで，DELETE文を実行した回数が出力されます。

なお，DELETE文が異常終了した場合は，実行回数にカウントされません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

21

DELETE_total_time

DELETE文の実行時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したDELETE文の実行時間が出力されます。

なお，DELETE文が異常終了した場合も，実行時間にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

22

Update_row_cnt

更新行数※6

該当するコネクションの稼働情報を最後に出力したあとで，更新した行数が出力されます。

更新行数のカウント対象となるSQL文は，INSERT文，UPDATE文，およびDELETE文です。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615行を超えると，ラップアラウンドして0に戻ります。

×

23

TRUNCATE_TABLE_cnt

TRUNCATE TABLE文の実行回数

該当するコネクションの稼働情報を最後に出力したあとで，TRUNCATE TABLE文を実行した回数が出力されます。

なお，TRUNCATE TABLE文が異常終了した場合は，実行回数に含まれません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

24

TRUNCATE_TABLE_total_time

TRUNCATE TABLE文の実行時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したTRUNCATE TABLE文の実行時間が出力されます。

なお，TRUNCATE TABLE文が異常終了した場合も，実行時間にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

25

PURGE_CHUNK_cnt

PURGE CHUNK文の実行回数

該当するコネクションの稼働情報を最後に出力したあとで，PURGE CHUNK文を実行した回数が出力されます。

なお，PURGE CHUNK文が異常終了した場合は，実行回数に含まれません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

26

PURGE_CHUNK_total_time

PURGE CHUNK文の実行時間（単位：秒）

該当するコネクションの稼働情報を最後に出力したあとに，実行したPURGE CHUNK文の実行時間が出力されます。

なお，PURGE CHUNK文が異常終了した場合も，実行時間にカウントされます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

27

Hashgrp_area_max_size

ハッシュグループ化領域の最大使用量※7（単位：バイト）

該当するコネクションを確立してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

28

Hashgrp_area_get_cnt

ハッシュグループ化領域の確保回数※7

該当するコネクションを確立してから，adbstatコマンドを実行するまでの間に，確保した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

29

Hashtbl_area_max_size

ハッシュテーブル領域の最大使用量（単位：バイト）

該当するコネクションを確立してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

30

DBbuff_wrktbl_clt_read_cnt

ローカル作業表用バッファへのファイル読み込み回数

該当するコネクションの稼働情報を最後に出力したあとに，ファイルが読み込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

31

DBbuff_wrktbl_clt_write_cnt

ローカル作業表用バッファからのファイル書き込み回数

該当するコネクションの稼働情報を最後に出力したあとに，ファイルに書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

32

Log_usrbuf_out_cnt

ユーザログバッファの満杯による掃き出し回数

該当するコネクションの稼働情報を最後に出力したあとに，掃き出した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

33

Log_usrfile_max_size

ユーザログファイルの最大使用量（単位：バイト）

該当するコネクションを確立してからadbstatコマンドを実行するまでの間に，使用量が最も大きい値が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

34

DBarea_extension_cnt

DBエリアの自動増分の回数

該当するコネクションの稼働情報を最後に出力したあとに，レギュラーファイルのDBエリアファイルで自動増分が実行された回数が出力されます。※8

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

35

Log_usrfile_write_cnt

ユーザログファイルへの書き込み回数

該当するコネクションの稼働情報を最後に出力したあとに，書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

36

DBbuff_wrktbl_clt_request_fix_cnt

システムで使用する値です。

×

37

DBbuff_wrktbl_clt_pagein_fix_cnt

システムで使用する値です。

×

38

DBbuff_wrktbl_clt_pageout_fix_cnt

システムで使用する値です。

×

39

DBbuff_blk_pagein_cnt

システムで使用する値です。

×

40

DBbuff_blk_pageout_cnt

システムで使用する値です。

×

41

DBbuff_blk_read_cnt

システムで使用する値です。

×

42

DBbuff_blk_write_cnt

システムで使用する値です。

×

43

Directory_send_num

ディレクトリ情報を送信した回数

該当するコネクションの稼働情報を最後に出力したあとに，送信した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

44

Directory_recv_num

システムで使用する値です。

×

45

Log_send_num

システムで使用する値です。

×

46

Log_recv_num

システムで使用する値です。

×

47

DBbuff_send_num

システムで使用する値です。

×

48

DBbuff_recv_num

システムで使用する値です。

×

49

Node_com_num

ノード間の通信回数

該当するコネクションの稼働情報を最後に出力したあとに，通信した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

50

Node_com_time

ノード間の通信時間（単位：マイクロ秒）

該当するコネクションの稼働情報を最後に出力したあとに，通信した時間が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

51

Log_usrfile_reduced_cnt

ユーザログファイルが初期化容量に縮小された回数

該当するコネクションの稼働情報を最後に出力したあとに，ユーザログファイルが初期化容量に縮小された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

（凡例）

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。マイクロ秒（nnnnnn）は6桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

「前回の出力日時」として出力される日時を，次の図に示します。

コネクションAおよびコネクションBを確立してから初めてコネクションの稼働情報を出力した場合，「前回の出力日時」には，それぞれのコネクションを確立した日時が出力されます。2回目以降にコネクションの稼働情報を出力すると，「前回の出力日時」には，該当するコネクションの稼働情報を最後に出力した日時が出力されます。

注※3

APからの明示的なトランザクション開始回数だけでなく，HADBサーバの開始時やコマンド実行時に，システムが暗黙的に開始したトランザクションの回数も含まれます。

注※4

COMMIT文またはROLLBACK文の実行による，APからの明示的なトランザクション終了回数だけでなく，次の値も回数に含まれます。

定義系SQL文を実行したときに，暗黙的にコミットされた回数

SQLエラーになったときに，暗黙的にロールバックされた回数

コマンド実行時に，システムが暗黙的にトランザクションを終了した回数

注※5

検索行数は，HADBサーバでの検索行数になります。そのため，検索結果の一括転送を使用したSQL文でエラーが発生した場合，APがFETCHした行数と異なる値が出力されることがあります。

また，次に示すコマンドの実行時に検索した行数は，検索行数に含まれません。

adbarchivechunkコマンド

adbexportコマンド

adbgetcstコマンド

adbidxrebuildコマンド

adbmergechunkコマンド

adbreorgsystemdataコマンド

注※6

検索結果の一括転送を使用したSQL文でエラーが発生した場合，エラーが発生するまでの更新行数がカウントされます。暗黙的にロールバックされた場合も，更新行数に含まれます。

注※7

ローカルハッシュグループ化処理が適用されると，SQL処理リアルスレッドの本数分，ハッシュグループ化領域が確保されます。また，外への参照列を含む副問合せ内でローカルハッシュグループ化処理が適用された場合，副問合せの外側の行数分，ローカルハッシュグループ化処理が実行されます。したがって，ハッシュグループ化領域は，次の計算式で求められる値の回数だけ確保されます。

外側の問合せの行数×SQL処理リアルスレッド数

注※8

作業表用DBエリアの自動増分の回数は含まれません。作業表用DBエリアで自動増分が発生しているかどうかは，「44.5.1　HADBサーバの統計情報で出力される項目の一覧」の「表44‒4　HADBサーバの統計情報で出力される列」にある項番13のWrktbl_page_use_maxの値を基に判断してください。

44.5.3　グローバルバッファの統計情報で出力される項目の一覧

グローバルバッファの統計情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。

表44‒6　グローバルバッファの統計情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

BUF：グローバルバッファの統計情報

×

2

Timestamp

グローバルバッファの統計情報の出力日時

adbstatコマンドを実行してグローバルバッファの統計情報を出力した日時が次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

○

3

Last_execute_time

前回の出力日時

該当するグローバルバッファの統計情報を最後に出力した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

ただし，HADBサーバを開始してから，初めて該当するグローバルバッファの統計情報を出力した場合は，HADBサーバの開始日時が出力されます。※2

○

4

DBbuff_name

グローバルバッファ名

○

5

DBbuff_page_num

総グローバルバッファ面数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

adbstatコマンド実行時のバッファ面数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

6

DBbuff_page_use_cnt

割り当て済みのグローバルバッファ面数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

adbstatコマンド実行時に割り当て済みのバッファ面数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

7

DBbuff_page_request_cnt

グローバルバッファのページ要求回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

8

DBbuff_page_hit_cnt

グローバルバッファのページヒット回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間にヒットした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

9

DBbuff_page_hit_rate

グローバルバッファのページヒット率※3（単位：％）

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

adbstatコマンド実行時のヒット率が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

10

DBbuff_page_pagein_cnt

グローバルバッファのページイン回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ページインした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

11

DBbuff_page_pageout_cnt

グローバルバッファのページアウト回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ページアウトした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

12

DBbuff_page_read_cnt

グローバルバッファへのファイル読み込み回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ファイルが読み込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

13

DBbuff_page_write_cnt

グローバルバッファからのファイル書き込み回数

サーバ定義のadbbuffオペランドの-pオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ファイルに書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

14

DBbuff_page_rng_num

総レンジインデクスバッファ面数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

adbstatコマンド実行時のバッファ面数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

15

DBbuff_page_rng_use_cnt

割り当て済みのレンジインデクスバッファ面数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

adbstatコマンド実行時に割り当て済みのバッファ面数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

16

DBbuff_page_rng_request_cnt

レンジインデクスバッファのページ要求回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

17

DBbuff_page_rng_hit_cnt

レンジインデクスバッファのページヒット回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間にヒットした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

18

DBbuff_page_rng_hit_rate

レンジインデクスバッファのページヒット率※3（単位：％）

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

adbstatコマンド実行時のヒット率が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

19

DBbuff_page_rng_pagein_cnt

レンジインデクスバッファのページイン回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ページインした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

20

DBbuff_page_rng_pageout_cnt

レンジインデクスバッファのページアウト回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ページアウトした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

21

DBbuff_page_rng_read_cnt

レンジインデクスバッファへのファイル読み込み回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ファイルが読み込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

22

DBbuff_page_rng_write_cnt

レンジインデクスバッファからのファイル書き込み回数

サーバ定義のadbbuffオペランドの-aオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ファイルに書き込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

23

DBbuff_tblscan_request_cnt

テーブルスキャンバッファのページ要求回数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

24

DBbuff_tblscan_hit_cnt

テーブルスキャンバッファのページヒット回数※4

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ヒットした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

25

DBbuff_tblscan_hit_rate

テーブルスキャンバッファのページヒット率※3，※4（単位：％）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

adbstatコマンド実行時のヒット率が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

26

DBbuff_tblscan_pagein_cnt

テーブルスキャンバッファのページイン回数※4

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ページインした回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

27

DBbuff_tblscan_read_cnt

テーブルスキャンバッファへのファイル読み込み回数※5

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，ファイルが読み込まれた回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

28

DBbuff_tblscan_failed_cnt

テーブルスキャンバッファでバッファ不足が発生した回数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，バッファ不足が発生した回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

29

DBbuff_tblscan_reuse_cnt

テーブルスキャンバッファで再利用したバッファ面数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，再利用したバッファ面数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

30

DBbuff_tblscan_read_size

テーブルスキャンバッファへのファイル読み込みサイズ（単位：キロバイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，読み込まれたファイルサイズが出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

31

DBbuff_page_wait_cnt

システムで使用する値です。

×

32

DBbuff_page_read_request_cnt

グローバルバッファへのファイル読み込み要求回数

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

33

DBbuff_page_write_request_cnt

グローバルバッファからのファイル書き込み要求回数

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

34

DBbuff_page_rng_read_request_cnt

レンジインデクスバッファへのファイル読み込み要求回数

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

35

DBbuff_page_rng_write_request_cnt

レンジインデクスバッファからのファイル書き込み要求回数

HADBサーバを開始してから，adbstatコマンドを実行するまでの間に，要求された回数が出力されます。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

（凡例）

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。マイクロ秒（nnnnnn）は6桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

「前回の出力日時」として出力される日時を，次の図に示します。

HADBサーバを開始してから初めてグローバルバッファの統計情報を出力した場合，グローバルバッファAおよびグローバルバッファBの「前回の出力日時」には，HADBサーバを開始した日時が出力されます。2回目以降にグローバルバッファの統計情報を出力すると，「前回の出力日時」には，該当するグローバルバッファの統計情報を最後に出力した日時が出力されます。

注※3

小数点以下は切り上げられます。

注※4

テーブルスキャンバッファへのページ単位のアクセスに関する統計情報です。

注※5

テーブルスキャンバッファへのセグメント単位のアクセスに関する統計情報です。

44.5.4　SQL文の統計情報で出力される項目

(1)　SQL文の統計情報で出力される項目の一覧

SQL文の統計情報で出力される項目（列）のタイトル，および出力される内容を次の表に示します。各列の出力順序は，次に示す表の項番の順序と同じです。

1つのSQL文が複数のグローバルバッファや複数のDBエリアにアクセスした場合，SQL文の統計情報では，1つのSQL文に対して，グローバルバッファごと，DBエリアごとに複数行の情報が出力されます。SQL文の統計情報の出力例については，「(2)　SQL文の統計情報の出力例」を参照してください。

表44‒7　SQL文の統計情報で出力される列

項番

列のタイトル

出力される内容

囲み文字の有無

1

Type

出力される情報の種類

SQL：SQL文の統計情報

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

×

2

HADB_system_version

統計ログファイルに情報を出力したHADBサーバのバージョン

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

○

3

Timestamp

統計ログファイルへの出力日時

統計ログファイルに該当の情報を出力した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

○

4

AP_name

AP識別子

APからのコネクションの場合

クライアント定義のadb_clt_ap_nameオペランドに指定されているAP識別子が出力されます。adb_clt_ap_nameオペランドを省略している場合は，"********"が出力されます。

コマンドからのコネクションの場合

コマンド名が出力されます。

adbsqlコマンドの場合は，クライアント定義のadb_clt_ap_nameで指定されているAP識別子が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

○

5

Connection_information

コネクション情報

コネクション確立時にメッセージログファイルに出力されるKFAA81000-Iメッセージのコネクション情報が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

○

6

Connect_time

コネクション確立日時

該当するコネクションを確立した日時が，次の形式で出力されます。

"YYYY-MM-DD△hh:mm:ss.nnnnnn"※1

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

○

7

SQL_serial_number

コネクションが確立してからのSQL文通番

メッセージログファイルに出力されるKFAA51000-Iメッセージ※2およびKFAA51005-Iメッセージ※3のSQL文通番が出力されます。

このSQL文通番から，対象のSQL文を特定できます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

なお，コミット処理の統計情報の場合は，値は出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615を超えると，ラップアラウンドして0に戻ります。

×

8

SQL_type

SQL文種別※4

該当するSQL文のSQL文種別が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では同じ値が出力されます。DBエリアにアクセスしなかったSQL文の場合，通常の値が出力されます。

×

9

SQL_total_time

SQL文の実行時間※5（単位：マイクロ秒）

該当するSQL文の実行に掛かった時間が出力されます。

なお，SQL文が異常終了した場合も，実行時間にカウントされます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

10

Fetch_row_cnt

検索行数※6

該当するSQL文で検索した行数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615行を超えると，ラップアラウンドして0に戻ります。

×

11

Update_row_cnt

更新行数※7

該当するSQL文で更新した行数が出力されます。

更新行数のカウント対象となるSQL文は，INSERT文，UPDATE文，およびDELETE文です。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615行を超えると，ラップアラウンドして0に戻ります。

×

12

Hashgrp_area_max_size

ハッシュグループ化領域の最大使用量※8（単位：バイト）

該当するSQL文で使用量が最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

13

Hashgrp_area_get_cnt

ハッシュグループ化領域の確保回数※8

該当するSQL文で確保した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

14

Hashtbl_area_max_size

ハッシュテーブル領域の最大使用量（単位：バイト）

該当するSQL文で使用量が最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

15

Lock_dbarea_request_cnt

排他資源（DBエリア）の確保回数

該当するSQL文で，排他資源（データ用DBエリアおよびシステム表用DBエリア）を確保した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

16

Lock_dbarea_wait_cnt

排他資源（DBエリア）の確保待ちの発生回数

該当するSQL文で，排他資源（データ用DBエリアおよびシステム表用DBエリア）が確保待ちになった回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

17

Lock_dbarea_wait_time

排他資源（DBエリア）の確保待ちの時間（単位：マイクロ秒）

該当するSQL文で，排他資源（データ用DBエリアおよびシステム表用DBエリア）が確保待ちになった時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

18

Lock_table_request_cnt

排他資源（表）の確保回数

該当するSQL文で，排他資源（処理対象表およびシステム表）を確保した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

19

Lock_table_wait_cnt

排他資源（表）の確保待ちの発生回数

該当するSQL文で，排他資源（処理対象表およびシステム表）が確保待ちになった回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

20

Lock_table_wait_time

排他資源（表）の確保待ちの時間（単位：マイクロ秒）

該当するSQL文で，排他資源（処理対象表およびシステム表）が確保待ちになった時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

21

DBbuff_dbarea_information_num

DBエリア情報の出力番号

DBエリアの情報が複数ある場合，情報を識別するための番号が1から順に出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

22

DBbuff_information_num

グローバルバッファ情報の出力番号

1つのDBエリアに対してグローバルバッファの情報が複数ある場合，情報を識別するための番号が1から順に出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

23

DBbuff_dbarea_name

DBエリア名

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

○

24

DBbuff_name

グローバルバッファ名

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

○

25

DBbuff_page_request_cnt

グローバルバッファのページ要求回数

該当するSQL文で要求された回数が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

26

DBbuff_page_hit_cnt

グローバルバッファのページヒット回数

該当するSQL文でヒットした回数が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

27

DBbuff_page_hit_rate

グローバルバッファのページヒット率※10（単位：％）

該当するSQL文でのヒット率が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

28

DBbuff_page_put_cnt

グローバルバッファへの書き込み回数

該当するSQL文で書き込まれた回数が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

29

DBbuff_page_read_cnt

グローバルバッファへのファイル読み込み回数

該当するSQL文でファイルが読み込まれた回数が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

30

DBbuff_page_write_cnt

グローバルバッファからのファイル書き込み回数

該当するSQL文でファイルに書き込まれた回数が出力されます（レンジインデクスページは除く）。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

31

DBbuff_page_rng_request_cnt

グローバルバッファのレンジインデクスページの要求回数

該当するSQL文で要求された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

32

DBbuff_page_rng_hit_cnt

グローバルバッファのレンジインデクスページのヒット回数

該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

33

DBbuff_page_rng_hit_rate

グローバルバッファのレンジインデクスページのヒット率※10（単位：％）

該当するSQL文でのヒット率が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

34

DBbuff_page_rng_put_cnt

グローバルバッファのレンジインデクスページへの書き込み回数

該当するSQL文で書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

35

DBbuff_page_rng_read_cnt

グローバルバッファのレンジインデクスページへのファイル読み込み回数

該当するSQL文でファイルが読み込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

36

DBbuff_page_rng_write_cnt

グローバルバッファのレンジインデクスページからのファイル書き込み回数

該当するSQL文でファイルに書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

37

DBbuff_tblscan_request_cnt

テーブルスキャンバッファのページ要求回数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文で要求された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

38

DBbuff_tblscan_hit_cnt

テーブルスキャンバッファのページヒット回数※11

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

39

DBbuff_tblscan_hit_rate

テーブルスキャンバッファのページヒット率※10，※11（単位：％）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文でヒット率が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

40

DBbuff_tblscan_read_cnt

テーブルスキャンバッファへのファイル読み込み回数※12

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文でファイルが読み込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

41

DBbuff_tblscan_failed_cnt

テーブルスキャンバッファでバッファ不足が発生した回数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文でバッファ不足が発生した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

42

DBbuff_tblscan_insufficient_buff_num

テーブルスキャンバッファの不足バッファ面数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文で不足したバッファ面数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

43

DBbuff_tblscan_reset_cnt

テーブルスキャンバッファのリセット回数

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文でリセットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

44

DBbuff_wrktbl_clt_request_cnt

ローカル作業表用バッファのページ要求回数

該当するSQL文で要求された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

45

DBbuff_wrktbl_clt_hit_cnt

ローカル作業表用バッファのヒット回数

該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

46

DBbuff_wrktbl_clt_hit_rate

ローカル作業表用バッファのヒット率※10（単位：％）

該当するSQL文でのヒット率が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

47

DBbuff_wrktbl_clt_put_cnt

ローカル作業表用バッファへの書き込み回数

該当するSQL文で書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

48

DBbuff_wrktbl_clt_read_cnt

ローカル作業表用バッファへのファイル読み込み回数

該当するSQL文でファイルが読み込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

49

DBbuff_wrktbl_clt_write_cnt

ローカル作業表用バッファからのファイル書き込み回数

該当するSQL文でファイルに書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

50

DBbuff_wrktbl_clt_tbl_cnt

ローカル作業表用バッファの生成回数

該当するSQL文で生成した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

51

DBbuff_wrktbl_clt_sort_merge_cnt

ローカル作業表のソートでの最大のソート段数

該当するSQL文で最大のソート段数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

52

DBbuff_wrktbl_clt_sort_page_max_cnt

ローカル作業表のソートでの最大作業表ページ数

該当するSQL文で，作業表ページ数が最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

53

Log_usrbuf_out_cnt

ユーザログバッファの満杯による掃き出し回数

該当するSQL文で掃き出された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

54

Log_usrfile_max_size

ユーザログファイルの最大使用量（単位：バイト）

該当するSQL文で使用量が最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

55

DBarea_extension_cnt

DBエリアの自動増分の回数※13

該当するSQL文で，レギュラーファイルのDBエリアファイルで自動増分が発生した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

56

Log_usrfile_write_cnt

ユーザログファイルへの書き込み回数※14

該当するSQL文で書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

57

DBbuff_wrktbl_clt_request_fix_cnt

システムで使用する値です。※14

×

58

DBbuff_wrktbl_clt_pagein_fix_cnt

システムで使用する値です。※14

×

59

DBbuff_wrktbl_clt_pageout_fix_cnt

システムで使用する値です。※14

×

60

DBbuff_wrktbl_clt_max_used_blk_num

ローカル作業表用バッファの最大使用ページ数※14

該当するSQL文で使用ページ数が最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

61

Directory_send_num

システムで使用する値です。※14

×

62

Directory_recv_num

システムで使用する値です。※14

×

63

Log_send_num

システムで使用する値です。※14

×

64

Log_recv_num

システムで使用する値です。※14

×

65

DBbuff_send_num

システムで使用する値です。※14

×

66

DBbuff_recv_num

システムで使用する値です。※14

×

67

Node_com_num

ノード間の通信回数※14

該当するSQL文で通信した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

68

Node_com_time

ノード間の通信時間※14（単位：マイクロ秒）

該当するSQL文で通信した時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

69

Bidx_page_split_cnt

B-treeインデクスのインデクスページスプリットが発生した回数※14

該当するSQL文で，B-treeインデクスのインデクスページスプリットが発生した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

70

Tidx_page_split_cnt

テキストインデクスのインデクスページスプリットが発生した回数※14

該当するSQL文で，テキストインデクスのインデクスページスプリットが発生した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

71

Bidx_validation_check_cnt

B-treeインデクスを使用した検索で，行データが有効かどうかを判定した回数※14

該当するSQL文で判定した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

72

Ridx_sgmt_skip_cnt

レンジインデクスを使用した検索で，表のセグメントをスキップした回数※14

該当するSQL文でセグメントをスキップした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

73

Ridx_chunk_skip_cnt

レンジインデクスを使用した検索で，表のチャンクをスキップした回数※14

該当するSQL文でチャンクをスキップした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

74

Ridx_chunk_read_cnt

レンジインデクスを使用した検索で，表のチャンクをスキップしなかった回数※14

該当するSQL文でチャンクをスキップしなかった回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

75

Ridx_chunk_judge_cnt

レンジインデクスを使用した検索で，表のチャンクが探索条件を満たす値域のデータを格納しているかどうかを判定した回数※14

該当するSQL文で判定した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

76

Ridx_sgmt_read_cnt

レンジインデクスを使用した検索で，表のセグメントをスキップしなかった回数※14

該当するSQL文で，セグメントをスキップしなかった回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

77

Ridx_sgmt_judge_cnt

レンジインデクスを使用した検索で，表のセグメントが探索条件を満たす値域のデータを格納しているかどうかを判定した回数※14

該当するSQL文で判定した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

78

SegmentRel_rthd_max_num

セグメント解放時に使用した処理リアルスレッドの最大数※14

該当するSQL文でセグメント解放時に使用した処理リアルスレッド数のうち，最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

79

Csvread_file_cnt

ADB_CSVREAD関数でオープンしたファイル数※14

該当するSQL文のADB_CSVREAD関数でオープンしたファイルの数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

80

Csvread_file_read_size

ADB_CSVREAD関数で読み込んだデータサイズの合計※14（単位：バイト）

該当するSQL文のADB_CSVREAD関数で読み込んだデータサイズの合計が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

81

Hashgrp_area_shortage

ハッシュグループ化領域が不足したかどうか※14

次のどちらかの値が出力されます。

Y：該当するSQL文でハッシュグループ化領域が不足した

N：該当するSQL文でハッシュグループ化領域が不足しなかった

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

×

82

Hashgrp_area_sufficient_size

ハッシュグループ化領域が不足しない十分な領域サイズ※14（単位：キロバイト）

該当するSQL文で，ハッシュグループ化領域が不足しない領域サイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

83

Hashtbl_area_shortage

ハッシュテーブル領域が不足したかどうか※14

次のどちらかの値が出力されます。

Y：該当するSQL文でハッシュテーブル領域が不足した

N：該当するSQL文でハッシュテーブル領域が不足しなかった

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

×

84

Syndict_file_access_time

同義語辞書ファイルへのアクセス時間の合計※15（単位：マイクロ秒）

該当するSQL文で，同義語辞書ファイルへのアクセスに掛かった合計時間が出力されます。

なお，SQL文が異常終了した場合も，アクセス時間がカウントされます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

85

Auditread_file_cnt

ADB_AUDITREAD関数でオープンしたファイル数※16

該当するSQL文のADB_AUDITREAD関数でオープンしたファイルの数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

86

Auditread_file_read_size

ADB_AUDITREAD関数で読み込んだデータサイズの合計※16（単位：バイト）

該当するSQL文のADB_AUDITREAD関数で読み込んだデータサイズの合計が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

87

DBbuff_tblscan_read_size

テーブルスキャンバッファへのファイル読み込みサイズ※17（単位：キロバイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文で読み込まれたファイルサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

88

DBbuff_tblscan_rthd_min_size

各リアルスレッドがテーブルスキャンバッファで使用したメモリの最小値※17，※18（単位：バイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文の各リアルスレッドがテーブルスキャンバッファで使用したメモリのうち，最も小さい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

89

DBbuff_tblscan_rthd_max_size

各リアルスレッドがテーブルスキャンバッファで使用したメモリの最大値※17，※18（単位：バイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文の各リアルスレッドがテーブルスキャンバッファで使用したメモリのうち，最も大きい値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

90

DBbuff_tblscan_use_size

SQL文の実行時にテーブルスキャンバッファで使用したメモリの合計※17，※18（単位：バイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文の実行時にテーブルスキャンバッファで使用したメモリの合計値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

91

DBbuff_tblscan_insufficient_buff_size

SQL文の実行時にテーブルスキャンバッファで容量不足が発生した際に要求したメモリの合計※17，※18（単位：バイト）

サーバ定義のadbbuffオペランドの-k，-vオプションに関連する項目です。

該当するSQL文の実行時にテーブルスキャンバッファで容量不足が発生した際に要求したメモリの合計値が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

92

Hashflt_disabled

ハッシュフィルタが無効化されたかどうか※19

次のどちらかの値が出力されます。

Y：該当するSQL文はハッシュフィルタを適用できるSQL文だが，ハッシュフィルタが無効化された

N：上記以外

ハッシュフィルタが一部分でも無効化された場合は，Yが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

×

93

Tbldef_req_cnt

表定義情報の取得要求回数※19

該当するSQL文で表定義情報の取得が要求された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

94

Tbldef_access_cnt

ディクショナリ表からの表定義情報の取得回数※19

該当するSQL文でディクショナリ表から表定義情報が取得された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

95

Tbldef_cache_access_cnt

表定義プールからの表定義情報の取得回数※19

該当するSQL文で表定義プールから表定義情報が取得された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

96

Tbldef_cache_register_cnt

表定義プールへの表定義情報の登録回数※19

該当するSQL文で表定義情報が登録された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

97

Tbldef_cache_sweep_cnt

表定義プールからの表定義情報の掃き出し回数※19

該当するSQL文で表定義情報が掃き出された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

98

DBbuff_page_wait_cnt

システムで使用する値です。※20

×

99

Max_sql_rthd_num

最大SQL処理リアルスレッド数※21

該当するSQL文を実行したときの最大SQL処理リアルスレッド数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

100

Hashtbl_area_size

ハッシュテーブル領域サイズ※21（単位：メガバイト）

該当するSQL文を実行したときのハッシュテーブル領域サイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

101

Hashflt_area_size

ハッシュフィルタ領域サイズ※21（単位：メガバイト）

該当するSQL文を実行したときのハッシュフィルタ領域サイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

×

102

Parallel_com_send_num

SQLパラレル実行機能適用時のノード間通信の送信回数※22

該当するSQLパラレル実行機能が適用された検索系SQLを実行したときのノード間通信の送信回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

103

Parallel_com_time_sum

SQLパラレル実行機能適用時のノード間通信の合計時間※22，※23（単位：マイクロ秒）

該当するSQLパラレル実行機能が適用された検索系SQLを実行したときのノード間通信の合計時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

104

Parallel_com_time_max

SQLパラレル実行機能適用時のノード間通信の最大時間※22，※23（単位：マイクロ秒）

該当するSQLパラレル実行機能が適用された検索系SQLを実行したときのノード間通信の最大時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615マイクロ秒を超えると，ラップアラウンドして0に戻ります。

×

105

Parallel_com_recv_num

SQLパラレル実行機能適用時のノード間通信の受信回数※22

該当するSQLパラレル実行機能が適用された検索系SQLを実行したときのノード間通信の受信回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615回を超えると，ラップアラウンドして0に戻ります。

×

106

SQL_execute_wait_total_time

SQL文の実行待ち状態の合計時間※24（単位：秒）

該当するSQL文が実行待ち状態なった時間の合計が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，同じSQL文では最初の行だけ値が出力されます。2行目以降は値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

18,446,744,073,709,551,615秒を超えると，ラップアラウンドして0に戻ります。

×

107

Cld_cache_open_cnt

キャッシュファイルのファイルオープン回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でキャッシュファイルがオープンされた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

108

Cld_cache_create_cnt

キャッシュファイルのファイル作成回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でキャッシュファイルが作成された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

109

Cld_cache_delete_cnt

キャッシュファイルのファイル削除回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でキャッシュファイルが削除された回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

110

Cld_cache_dir_write_cnt

キャッシュファイル（ディレクトリページ）のファイル書き込み回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

111

Cld_cache_dir_write_hit_cnt

キャッシュファイル（ディレクトリページ）のファイル書き込みヒット回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

112

Cld_cache_dir_write_size

キャッシュファイル（ディレクトリページ）のファイル書き込みサイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で書き込まれたキャッシュファイルのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

113

Cld_cache_sgmt_write_cnt

キャッシュファイル（セグメント）のファイル書き込み回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で書き込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

114

Cld_cache_sgmt_write_hit_cnt

キャッシュファイル（セグメント）のファイル書き込みヒット回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

115

Cld_cache_sgmt_write_size

キャッシュファイル（セグメント）のファイル書き込みサイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で書き込まれたキャッシュファイルのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

116

Cld_cache_dir_read_cnt

キャッシュファイル（ディレクトリページ）のファイル読み込み回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で読み込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

117

Cld_cache_dir_read_hit_cnt

キャッシュファイル（ディレクトリページ）のファイル読み込みヒット回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

118

Cld_cache_dir_read_size

キャッシュファイル（ディレクトリページ）のファイル読み込みサイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で読み込まれたキャッシュファイルのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

119

Cld_cache_sgmt_read_cnt

キャッシュファイル（セグメント）のファイル読み込み回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で読み込まれた回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

120

Cld_cache_sgmt_read_hit_cnt

キャッシュファイル（セグメント）のファイル読み込みヒット回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文でヒットした回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

121

Cld_cache_sgmt_read_size

キャッシュファイル（セグメント）のファイル読み込みサイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で読み込まれたキャッシュファイルのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

122

Cld_object_dir_get_cnt

S3オブジェクトまたはBLOB（ディレクトリページ）の取得回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で取得した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

123

Cld_object_dir_get_size

S3オブジェクトまたはBLOB（ディレクトリページ）の取得サイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で取得したS3オブジェクトまたはBLOBのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

124

Cld_object_dir_get_total_time

S3オブジェクトまたはBLOB（ディレクトリページ）の取得時間※25（単位：マイクロ秒）

クラウドストレージ機能を使用している場合に，該当するSQL文でS3オブジェクトまたはBLOBの取得に掛かった時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

125

Cld_object_sgmt_get_cnt

S3オブジェクトまたはBLOB（セグメント）の取得回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で取得した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

126

Cld_object_sgmt_get_size

S3オブジェクトまたはBLOB（セグメント）の取得サイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で取得したS3オブジェクトまたはBLOBのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

127

Cld_object_sgmt_get_total_time

S3オブジェクトまたはBLOB（セグメント）の取得時間※25（単位：マイクロ秒）

クラウドストレージ機能を使用している場合に，該当するSQL文でS3オブジェクトまたはBLOBの取得に掛かった時間が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

128

Cld_object_dir_put_cnt

S3オブジェクトまたはBLOB（ディレクトリページ）の格納回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で格納した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

129

Cld_object_dir_put_size

S3オブジェクトまたはBLOB（ディレクトリページ）の格納サイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で格納したS3オブジェクトまたはBLOBのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

130

Cld_object_sgmt_put_cnt

S3オブジェクトまたはBLOB（セグメント）の格納回数※25

クラウドストレージ機能を使用している場合に，該当するSQL文で格納した回数が出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

131

Cld_object_sgmt_put_size

S3オブジェクトまたはBLOB（セグメント）の格納サイズ※25（単位：バイト）

クラウドストレージ機能を使用している場合に，該当するSQL文で格納したS3オブジェクトまたはBLOBのサイズが出力されます。

1つのSQL文に対してDBエリアの情報が複数ある場合，DBエリアごとの値が出力されます※9。DBエリアにアクセスしなかったSQL文の場合，値が出力されません。

〔出力形式〕

8バイトの符号なし整数で出力されます。

オーバフローした場合，18,446,744,073,709,551,615が出力されます。

×

132

Cld_object_dir_getmem_wait_cnt

システムで使用する値です。※25

×

133

Cld_object_sgmt_getmem_wait_cnt

システムで使用する値です。※25

×

134

Cld_object_dir_putmem_wait_cnt

システムで使用する値です。※25

×

135

Cld_object_sgmt_putmem_wait_cnt

システムで使用する値です。※25

×

（凡例）

○：出力される値が囲み文字で囲まれます。

×：出力される値が囲み文字で囲まれません。

注※1

年（YYYY）は4桁で出力されます。月（MM），日（DD），時（hh），分（mm），および秒（ss）は2桁で出力されます。マイクロ秒（nnnnnn）は6桁で出力されます。桁数が足りない場合は，足りない分，左側に0が補われます。△は半角空白を表します。

注※2

メッセージログファイルにKFAA51000-Iメッセージを出力するためには，あらかじめ，サーバ定義のadb_sql_text_outオペランドでSQL文がメッセージログファイルに出力されるように設定しておく必要があります。

注※3

KFAA51005-Iメッセージは，SQL文がエラーになった場合に出力されます。

注※4

表示されるSQL文種別と，その内容を次の表に示します。

表44‒8　SQL文種別

項番

SQL文種別

内容

1

ALTER_TABLE

表定義の変更

2

ALTER_USER

HADBユーザの情報変更

3

ALTER_VIEW

ビュー表の再作成

4

CREATE_AUDIT

監査対象の定義

5

CREATE_INDEX

インデクスの定義

6

CREATE_SCHEMA

スキーマの定義

7

CREATE_TABLE

表の定義

8

CREATE_USER

HADBユーザの作成

9

CREATE_VIEW

ビュー表の定義

10

DROP_AUDIT

監査対象定義の削除

11

DROP_INDEX

インデクスの削除

12

DROP_SCHEMA

スキーマの削除

13

DROP_TABLE

表の削除

14

DROP_USER

HADBユーザの削除

15

DROP_VIEW

ビュー表の削除

16

GRANT

権限の付与

17

REVOKE

権限の取り消し

18

DELETE

行の削除

19

INSERT

行の挿入

20

PURGE_CHUNK

チャンク内の全行削除

21

SELECT

行の検索

22

TRUNCATE_TABLE

実表の全行削除

23

UPDATE

行の更新

24

値が出力されない場合

上記以外，またはSQL文の前処理時にエラーとなった場合

注※5

次のSQL文の実行時間がカウントされます。

SELECT文

INSERT文

UPDATE文

DELETE文

TRUNCATE TABLE文

PURGE CHUNK文

注※6

検索行数は，HADBサーバでの検索行数になります。そのため，検索結果の一括転送を使用したSQL文でエラーが発生した場合，APがFETCHした行数と異なる値が出力されることがあります。

また，次に示すコマンドの実行時に検索した行数は，検索行数に含まれません。

adbarchivechunkコマンド

adbexportコマンド

adbgetcstコマンド

adbidxrebuildコマンド

adbmergechunkコマンド

adbreorgsystemdataコマンド

注※7

検索結果の一括転送を使用したSQL文でエラーが発生した場合，エラーが発生するまでの更新行数がカウントされます。ただし，暗黙的にロールバックされた場合は，更新行数が0となります。

注※8

ローカルハッシュグループ化処理が適用されると，SQL処理リアルスレッドの本数分，ハッシュグループ化領域が確保されます。また，外への参照列を含む副問合せ内でローカルハッシュグループ化処理が適用された場合，副問合せの外側の行数分，ローカルハッシュグループ化処理が実行されます。したがって，ハッシュグループ化領域は，次の計算式で求められる値の回数だけ確保されます。

外側の問合せの行数×SQL処理リアルスレッド数

注※9

グローバルバッファのページ要求時には，グローバルバッファの掃き出し処理が動作することがあります。このとき，掃き出し処理の対象となるページは，ページを要求したSQL文がアクセスしたページとは異なることがあります。そのため，SQL文の統計情報には，対象のSQL文ではアクセスしないDBエリアやグローバルバッファの情報が出力されることがあります。

注※10

小数点以下は切り上げられます。

注※11

テーブルスキャンバッファへのページ単位のアクセスに関する統計情報です。

注※12

テーブルスキャンバッファへのセグメント単位のアクセスに関する統計情報です。

注※13

作業表用DBエリアの自動増分の回数は含まれません。作業表用DBエリアで自動増分が発生しているかどうかは，「44.5.1　HADBサーバの統計情報で出力される項目の一覧」の「表44‒4　HADBサーバの統計情報で出力される列」にある項番13のWrktbl_page_use_maxの値を基に判断してください。

注※14

HADB_system_version列の値が03-00の場合は，値が出力されません。

HADB_system_version列の値が03-01以降の場合に，値が出力されます。

注※15

同義語辞書ファイルにアクセスするたびにアクセス時間がカウントされますが，マイクロ秒未満の時間は切り捨てられます。このため，1回のアクセス時間がすべて1マイクロ秒未満の場合は，アクセス時間の合計が0となります。

注※16

HADB_system_version列の値が03-06以前の場合は，値が出力されません。

HADB_system_version列の値が04-00以降の場合に，値が出力されます。

注※17

HADB_system_version列の値が04-00以前の場合は，値が出力されません。

HADB_system_version列の値が04-01以降の場合に，値が出力されます。

注※18

サーバ定義のadbbuffオペランドの-vオプションに指定したテーブルスキャンバッファに使用するメモリサイズには，テーブルスキャンバッファの管理に使用する領域が含まれます。このため，-vオプションに指定したサイズのメモリすべてを，各リアルスレッドに割り振ることはできません。したがって，この注釈の対象となる出力項目に出力される値は，-vオプションに指定したテーブルスキャンバッファに使用するメモリサイズやリアルスレッドごとに使用するメモリサイズの上限値とは合致しません。

注※19

HADB_system_version列の値が04-02以前の場合は，値が出力されません。

HADB_system_version列の値が04-03以降の場合に，値が出力されます。

注※20

HADB_system_version列の値が04-03以前の場合は，値が出力されません。

HADB_system_version列の値が05-00以降の場合に，値が出力されます。

注※21

HADB_system_version列の値が05-00以前の場合は，値が出力されません。

HADB_system_version列の値が05-01以降の場合に，値が出力されます。

注※22

HADB_system_version列の値が05-04以前の場合は，値が出力されません。

HADB_system_version列の値が05-05以降の場合に，値が出力されます。

注※23

SQLパラレル実行機能が適用されたときに発生するノード間通信に関する情報です。この情報は，ノード間通信の送信先ノードだけに出力されます。ノード間通信の送信元ノードには出力されません。

また，「送信先ノードでの通信の受信時刻－送信元ノードでの通信の送信時刻」で通信時間を計算しています。そのため，送信先ノードと送信元ノードで時刻が一致していない場合，計算結果（通信時間）が負の値となることがあります。計算結果が負の値の場合，その通信時間は0として扱われます。

注※24

HADB_system_version列の値が05-05以前の場合は，値が出力されません。

HADB_system_version列の値が05-06以降の場合に，値が出力されます。

注※25

HADB_system_version列の値が05-06以前の場合は，値が出力されません。

HADB_system_version列の値が05-07以降の場合に，値が出力されます。

(2)　SQL文の統計情報の出力例

SQL文の統計情報では，該当するSQL文がDBエリアにアクセスしたかどうかによって，各項目に出力される値が異なります。SQL文がDBエリアにアクセスした場合と，DBエリアにアクセスしなかった場合について，SQL文の統計情報の出力例を次に示します。

メモ

次に示す出力例は，見やすさを考慮して項目の間隔を調整しています。また，実際の出力結果は横に長いため，ここでは分割して記載しています。

出力対象となったSQL文が3つのDBエリアにアクセスした場合のSQL文の統計情報の出力例を，次の図に示します。

図44‒2　SQL文が3つのDBエリアにアクセスした場合

出力対象となったSQL文がDBエリアにアクセスしなかった場合のSQL文の統計情報の出力例を，次の図に示します。

図44‒3　SQL文がDBエリアにアクセスしなかった場合

44.6　adbstatコマンドの出力規則

adbstatコマンドの出力規則を次に示します。

出力結果の先頭の行には，各列のタイトルが出力されます。タイトルに囲み文字は付きません。

ただし，-tオプションを指定した場合，タイトルは出力されません。

adbstatコマンドを実行すると，SQL文およびAPの情報だけでなく，システムが動作する際の情報も出力されます。

出力される情報が日時の場合，HADBサーバをインストールしたマシンの環境変数TZに設定したタイムゾーンに従います。

出力される情報が数値の場合，オーバフローすると値が出力されないことがあります。

最後に出力された項目の末尾には，改行コード（LF）が付きます。

出力結果に出力される文字の文字コードは，HADBサーバをインストールしたマシンの環境変数ADBLANGに設定した文字コードと同じになります。

44.7　注意事項

adbstatコマンドでは，開始メッセージ，およびリターンコードを返す終了メッセージは出力されません。adbstatコマンドが異常終了した場合は，エラーメッセージが出力されます。表示されたメッセージ，またはメッセージログファイルを確認して，メッセージの対処に従ってください。

adbstatコマンドはHADBサーバの処理性能に影響を及ぼさないように，HADBサーバの状態を無排他で参照しています。そのため，実行したタイミングによっては不整合な値が出力されることがあります。その場合は，adbstatコマンドを再実行してください。

［Ctrl］＋［C］キー，OSのkillコマンドなどでadbstatコマンドを強制終了しないでください。コマンドプロセスを強制終了したあとで，adbstatコマンドを実行した場合，不整合な値が出力されることがあります。

adbstatコマンドは，DBエリア，表およびインデクスの内容を変更しません。このため，adbstatコマンドが異常終了しても，表およびインデクスの回復処理は不要です。

45　adbstop（HADBサーバの終了）

この章では，adbstopコマンドの機能と使い方について説明します。

45.1　機能

HADBサーバを終了します。

HADBサーバの終了方法には，正常終了と強制終了があります。オプションを指定することで，次に示す終了方法を選択できます。

正常終了

接続中のAPの切り離し，および実行中のコマンドの終了を待ってHADBサーバを終了する

処理中のトランザクションの完了，および実行中のコマンドの終了を待ってHADBサーバを終了する

処理中のトランザクション，および実行中のコマンドをキャンセルしてHADBサーバを終了する

メモ

接続中のAPおよび実行中のコマンドがないときにHADBサーバを正常終了したい場合は，オプションを何も指定しないでadbstopコマンドを実行してください。

強制終了

処理中のトランザクションの完了，および実行中のコマンドの終了を待たないで，HADBサーバを強制的に終了する

マルチノード機能を使用している場合は，プライマリノードでadbstopコマンドを実行してください。プライマリノードでadbstopコマンドを実行すると，マルチノード構成のすべてのHADBサーバが終了します。adbstopコマンドを実行したノードのHADBサーバだけを正常終了させたいときは，--nodeを指定してadbstopコマンドを実行してください。

45.2　adbstopコマンドの指定形式

adbstopコマンドの指定形式およびオプションについて説明します。

adbstopコマンドを実行できるOSユーザは，HADB管理者だけです。

45.2.1　指定形式とオプションの説明

(1)　指定形式

adbstop 〔｛--wait ｛connection｜transaction｝ 〔-t タイムアウトまでの待ち時間〕 〔--node〕
          ｜--cancel 〔--node〕
          ｜--force
          ｜--node｝〕

(2)　オプションの説明

HADBサーバの終了方法を指定します。

●--wait ｛connection｜transaction｝ 〔-t タイムアウトまでの待ち時間〕

HADBサーバに接続中のAPの切り離し，処理中のトランザクションの完了，および実行中のコマンドの終了を待ってから，HADBサーバを終了する場合に指定します。

connection：

HADBサーバに接続中のすべてのAPがHADBサーバから切り離され，かつ実行中のすべてのコマンドが完了するのを待ってから，HADBサーバを終了するときに指定します。

なお，--wait connectionを指定してadbstopコマンドを実行したあとは，HADBサーバが新規のコネクション確立要求を受け付けなくなります。ただし，新規のトランザクション開始要求は受け付けます。

transaction：

処理中のトランザクションがすべて完了し，かつ実行中のコマンドがすべて終了することを待ってから，HADBサーバに接続中のすべてのAPをHADBサーバから切り離し，HADBサーバを終了するときに指定します。

なお，--wait transactionを指定してadbstopコマンドを実行したあとは，HADBサーバが新規のコネクション確立要求，および新規のトランザクション開始要求を受け付けなくなります。

-t タイムアウトまでの待ち時間：

〜〈整数〉((1〜86,400))《3,600》（単位：秒）

--wait connectionまたは--wait transactionを指定したときだけ，このオプションを指定できます。

APの切り離し，トランザクションの完了，およびコマンドの終了を待つ時間を指定します。adbstop --waitコマンド実行中に，このオプションに指定した待ち時間を超えた（タイムアウトした）場合，HADBサーバは終了しません。この場合，HADBサーバは新規のコネクション確立要求や新規のトランザクション開始要求を受け付けられるようになります。

●--cancel

処理中のトランザクションおよび実行中のコマンドをキャンセルしたあとで，HADBサーバに接続中のすべてのAPを切り離し，HADBサーバを終了する場合に指定します。

なお，--cancelを指定してadbstopコマンドを実行したあとは，HADBサーバが新規のコネクション確立要求，および新規のトランザクション開始要求を受け付けなくなります。

●--force

処理中のトランザクションの完了，および実行中のコマンドの終了を待たないで，HADBサーバを強制的に終了する場合に指定します。HADBサーバを強制終了すると，HADBサーバを再開始したときに，トランザクションの回復処理が行われます。

なお，--forceを指定してadbstopコマンドを実行した場合，KFAA91153-Qメッセージが出力されます。KFAA91153-Qメッセージでは，HADBサーバを強制終了しても問題ないかどうかが確認されます。強制終了しても問題ない場合は，y（またはY）を入力してください。y（またはY）以外を指定した場合，adbstopコマンドの処理を中止します。

■マルチノード機能を使用している場合

--forceを指定してadbstopコマンドを実行した場合，コマンドを実行したノードのHADBサーバだけが強制終了します。コマンドを実行したノードがプライマリノードだったときは，ほかのセカンダリノードが起動しているかどうかによってコマンド実行後の動作が異なります。

ほかのセカンダリノードが起動している場合

セカンダリノードのどれかが，プライマリノードに切り替わります。

ほかのセカンダリノードが起動していない場合（HAモニタなしのマルチノード構成の場合も含む）

プライマリノードへの切り替え先のノードがないため，マルチノード構成のHADBサーバは異常終了します。

●--node

このオプションは，マルチノード機能に関するオプションです。特定のノードのHADBサーバを終了する場合に，このオプションを指定します。次に示す場合に，--nodeオプションを指定したadbstopコマンドを実行してください。

特定のセカンダリノードまたはワーカーノードのHADBサーバを終了する場合

この場合，HADBサーバを終了するセカンダリノードまたはワーカーノードで，--nodeオプションを指定したadbstopコマンドを実行してください。

プライマリノードを切り替える場合（共有ディスクのSCSIリザーブの使用時）

共有ディスクのSCSIリザーブを使用している場合に，プライマリノードを切り替えるときは，--nodeオプションを指定したadbstopコマンドをプライマリノードで実行し，プライマリノードのHADBサーバを終了させてください。プライマリノードの切り替え手順については，マニュアルHADB　システム構築・運用ガイドのコマンドによるプライマリノードの切り替えを参照してください。

重要

共有ディスクのSCSIリザーブではなく，系のリセットを使用している場合は，--nodeオプションを指定したadbstopコマンドをプライマリノードで実行しないでください。系のリセットを使用している場合に，--nodeオプションを指定したadbstopコマンドをプライマリノードで誤って実行してしまったときは，HAモニタのmonswapコマンドを実行して，プライマリノードを切り替えてください。詳細については，マニュアルHADB　システム構築・運用ガイドのマルチノード機能の運用のマルチノード構成のHADBサーバの開始と終了のマルチノード構成のHADBサーバの終了方法の特定のノードのHADBサーバの終了手順にあるプライマリノードのHADBサーバだけを正常終了させる場合を参照してください。

メモ

マルチノード機能を使用していない場合は，このオプションを指定しても無視されます。

--nodeオプションと，そのほかのオプションを同時に指定した場合のシステムの処理を次の表に示します。

表45‒1　--nodeオプションとそのほかのオプションを同時に指定した場合のシステムの処理

項番

--nodeオプションと同時に指定するオプション

システムの処理

1

なし

セカンダリノードまたはワーカーノードでadbstopコマンドを実行した場合

adbstopコマンドを実行したノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が存在するとき，エラーとなります（KFAA50021-Eメッセージが出力されます）。

プライマリノードでadbstopコマンドを実行した場合

次に示すときにエラーとなります（KFAA50021-Eメッセージが出力されます）。

プライマリノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が存在するとき

マルチノード構成のHADBサーバに接続だけしていて，トランザクションを実行していないコネクションが存在する場合

2

--wait connection

セカンダリノードまたはワーカーノードでadbstopコマンドを実行した場合

adbstopコマンドを実行したノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が終了するまで，終了処理を待ちます。トランザクションがすべて終了したあとに，終了処理を開始します。

このとき，そのノードでは，新規のトランザクションの開始要求を受け付けません。

プライマリノードでadbstopコマンドを実行した場合

プライマリノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が終了するまで，終了処理を待ちます。また，マルチノード構成のHADBサーバに接続だけしていて，トランザクションを実行していないコネクションが存在する場合は，そのコネクションが終了するまで，終了処理を待ちます。トランザクションおよびコネクションがすべて終了したあとに，終了処理を開始します。

このとき，プライマリノードでは，新規のトランザクションの開始要求，および新規のコネクションの確立要求を受け付けません。

3

--wait transaction

セカンダリノードまたはワーカーノードでadbstopコマンドを実行した場合

adbstopコマンドを実行したノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が終了するまで，終了処理を待ちます。トランザクションがすべて終了したあとに，終了処理を開始します。

このとき，そのノードでは，新規のトランザクションの開始要求を受け付けません。

プライマリノードでadbstopコマンドを実行した場合

プライマリノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）が終了するまで，終了処理を待ちます。マルチノード構成のHADBサーバに接続だけしていて，トランザクションを実行していないコネクションが存在する場合でも，プライマリノードで実行中のトランザクションが終了次第，終了処理を開始します（コネクションは強制終了します）。

このとき，プライマリノードでは，新規のトランザクションの開始要求，および新規のコネクションの確立要求を受け付けません。

4

--cancel

セカンダリノードまたはワーカーノードでadbstopコマンドを実行した場合

adbstopコマンドを実行したノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）をキャンセルし，そのトランザクションを実行していたコネクションを終了します。そのあとに，終了処理を開始します。

このとき，そのノードでは，新規のトランザクションの開始要求を受け付けません。

プライマリノードでadbstopコマンドを実行した場合

プライマリノードで実行中のトランザクション（SQLパラレル実行機能を適用した検索系SQLを実行中のSQLサブノードのトランザクションを含む）をキャンセルします。そして，そのトランザクションを実行していたコネクションを終了します。また，マルチノード構成のHADBサーバに接続だけしていて，トランザクションを実行していないコネクションが存在する場合は，そのコネクションを終了します。すべてのコネクションを終了したあとで，終了処理を開始します。

このとき，プライマリノードでは，新規のトランザクションの開始要求，および新規のコネクションの確立要求を受け付けません。

オプションを何も指定しない場合，HADBサーバの終了モードは正常終了になります。ただし，HADBサーバに接続中のAP，または実行中のコマンドがあると，KFAA91152-Eメッセージが出力され，エラーとなります（HADBサーバを終了できません）。このときは，マニュアルHADB　メッセージを参照し，KFAA91152-Eメッセージの対策の説明に従って対処してください。

45.3　使用例

HADBサーバを終了します。

adbstop

KFAA90000-I adbstop processing started.
KFAA91154-I The HADB system was terminated normally.
KFAA90001-I adbstop processing ended. (return code = 0)

45.4　リターンコード

adbstopコマンドのリターンコードを次の表に示します。

表45‒2　adbstopコマンドのリターンコード

リターンコード

意味

0

adbstopコマンドが正常に終了しました。

4

adbstopコマンドが警告メッセージを出力して終了しました。HADBサーバは終了しています。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

なお，adbstopコマンドを実行して，HADBサーバが終了処理を実施している間に，adbstop --forceコマンドを実行してHADBサーバを強制終了した場合，先発のadbstopコマンドのリターンコードは4となります。また，表示されるKFAA91154-Iメッセージでは，HADBサーバは強制終了したと示されます。

8

adbstopコマンドの実行中にエラーが発生しました。表示されたメッセージ，またはメッセージログファイルに出力されたメッセージを確認して対処してください。

45.5　注意事項

adbstop --waitコマンドの実行中には，adbstop --cancelコマンドを実行できません。adbstop --waitコマンド実行中の終了待機状態（HADBサーバに接続中のAPの切り離し，処理中のトランザクションの完了，および実行中のコマンドの終了を待っている状態）をキャンセルしたい場合は，OSのkillコマンドでadbstop --waitコマンドのコマンドプロセスを終了させてください。

次に示す場合，HADBサーバは新規のコネクション確立要求や新規のトランザクション開始要求を受け付けられるようになります（adbstop --waitコマンド実行前の状態に戻ります）。

終了待機状態中にタイムアウトした場合

注意事項1.の方法で終了待機状態をキャンセルした場合

HAモニタありのマルチノード構成の場合，ノード復帰中のノードが存在しているときは，--forceオプションを指定したadbstopコマンドだけ実行できます（オプションの指定がない場合や，ほかのオプションを指定した場合は，adbstopコマンドを実行できません）。

HAモニタありのマルチノード構成の場合，プライマリノードの切り替え中に，新たにプライマリノードになるセカンダリノードでadbstop --nodeコマンドを実行したときは，プライマリノードの切り替えが完了してから，新たなプライマリノード（adbstop --nodeコマンドを実行したノード）のHADBサーバが終了します。この場合，さらにプライマリノードの切り替えが発生し，優先度の最も高いセカンダリノードがプライマリノードになります。なお，切り替え先のノードがないときは，マルチノード構成のHADBサーバが終了します。

マルチノード構成に追加処理中のワーカーノードが存在する間は，プライマリノードおよびセカンダリノードでは，adbstop --forceコマンドだけ実行できます。オプションの指定がないadbstopコマンドや，--force以外のオプションを指定したadbstopコマンドは実行できません。なお，ワーカーノードの場合は，adbstopコマンドのオプション指定に制限はありません。

46　adbsyndict（同義語辞書の管理）

この章では，adbsyndictコマンドの機能と使い方について説明します。

46.1　機能

adbsyndictコマンドの機能について説明します。

adbsyndictコマンドは，コマンド実行時にHADBサーバに接続します。

46.1.1　同義語辞書の登録

同義語辞書を新規に追加することを同義語辞書の登録といいます。adbsyndictコマンドを実行すると，同義語一覧定義ファイルおよび辞書情報登録ファイルの指定内容を基に同義語辞書が作成されて，同義語辞書ファイルに出力されます。

adbsyndictコマンドによる同義語辞書の登録処理の概要を次の図に示します。

図46‒1　adbsyndictコマンドによる同義語辞書の登録処理の概要

同義語辞書は，同義語検索をする場合に必要になります。同義語検索については，マニュアルHADB　システム構築・運用ガイドの同義語検索を参照してください。

メモ

クラウドストレージ機能を使用している場合，同義語検索ができないため，adbsyndictコマンドは実行できません。クラウドストレージ機能については，マニュアルHADB　システム構築・運用ガイドのクラウド環境でHADBサーバを使用する場合を参照してください。

46.1.2　同義語辞書の更新

登録済みの同義語辞書の内容を更新することを同義語辞書の更新といいます。例えば，同義語の追加，削除，更新や，同義語グループの追加，削除が該当します。adbsyndictコマンドを実行すると，同義語一覧定義ファイルおよび辞書情報登録ファイルの指定内容を基に同義語辞書が再作成されて，同義語辞書ファイルに出力されます。

adbsyndictコマンドによる同義語辞書の更新処理の概要を次の図に示します。

図46‒2　adbsyndictコマンドによる同義語辞書の更新処理の概要

46.1.3　同義語辞書の削除

不要となった同義語辞書を削除できます。adbsyndictコマンドを実行すると，辞書情報削除ファイルに指定された同義語辞書が削除されます。

adbsyndictコマンドによる同義語辞書の削除処理の概要を次の図に示します。

図46‒3　adbsyndictコマンドによる同義語辞書の削除処理の概要

46.1.4　同義語辞書ファイルの同期

プライマリノードにある同義語辞書ファイルを各セカンダリノードおよびワーカーノードにコピーして，全ノードの同義語辞書ファイルを同じファイルにすることを同義語辞書ファイルの同期といいます。adbsyndict -sコマンドが実行されると，プライマリノードのadb_syndict_storage_pathオペランドに指定したディレクトリ下の同義語辞書ファイルが，全ノードのadb_syndict_node_storage_pathオペランドに指定したディレクトリ下にコピーされます。

メモ

HADBサーバは，最新の同義語辞書ファイルが，各ノードのadb_syndict_node_storage_pathオペランドに指定したディレクトリ下にあるかどうかを確認し，ない場合はプライマリノードの同義語辞書ファイルをコピーします。

マルチノード機能の使用時に同義語検索を行う場合，各ノードのadb_syndict_node_storage_pathオペランドに指定したディレクトリ下に格納されている同義語辞書ファイルが使用されます。何らかの原因によって，古い同義語辞書ファイルが格納されているセカンダリノードまたはワーカーノードがある場合，そのセカンダリノードまたはワーカーノードでは同義語検索のSQL文の処理が実行されません。そのセカンダリノードまたはワーカーノードに同義語検索のSQL文の処理が割り当てられた場合，SQL文の処理を実行するノードをセカンダリノードまたはワーカーノードからプライマリノードに切り替えます。

同義語辞書の登録，更新，削除の際は，同義語辞書ファイルの同期処理が自動的に行われます。そのため，adbsyndict -sコマンドを実行して，同義語辞書ファイルの同期を取るのは，次のような場合に限られます。

マルチノード構成にノードを復帰した場合

マルチノード構成にワーカーノードを追加した場合

マルチノード構成に新規のノードを追加した場合

同義語辞書ファイルの同期処理が正しく終了しなかった場合

46.1.5　同義語辞書に登録されている同義語の一覧の出力

同義語辞書に登録されている同義語の一覧をファイルに出力できます。ファイルに出力される同義語の一覧の出力例を次に示します。

出力例

"データベース","データバンク","database"↓
"アプリケーションサーバ","APサーバ","application server"↓

（凡例）↓：改行

同義語の一覧は，同義語一覧定義ファイルと同じ形式で出力されます。上記の例のように，1行が1同義語グループの同義語一覧になります。

同義語一覧定義ファイルを紛失してしまった場合は，adbsyndictコマンドを実行して同義語一覧定義ファイルを再作成してください。

メモ

adbsyndictコマンドで再作成される同義語一覧定義ファイルは，次の規則に従って作成されます。

各同義語に囲み文字（二重引用符）が付きます。

改行コードはX'0A'（LF）になります。

また，自分が作成した同義語一覧定義ファイルとは，次の点が異なることがあります。

同義語グループ内で同じ同義語を2つ以上指定していた場合でも，1つだけが出力されます。

同義語グループ内の同義語の指定順が異なることがあります。

46.1.6　同義語辞書ファイルの格納ディレクトリ下にある不要なファイルの削除

同義語辞書の登録や更新などをした際に，adbsyndictコマンドが正常終了しなかった場合，同義語辞書ファイルの格納ディレクトリ下（サーバ定義のadb_syndict_storage_pathオペランドに指定したディレクトリ下）に不要なファイルが残ったままになることがあります。adbsyndictコマンドを実行すると，この不要なファイルを削除※できます。

注※

次のファイルが削除対象になります。

同義語検索で使用されない同義語辞書ファイル（HADBサーバに登録されていない同義語辞書ファイル）

同義語辞書の登録時などに，何らかの要因で削除されなかった作業用一時ファイル

46.2　adbsyndictコマンドの指定形式

adbsyndictコマンドの指定形式およびオプションについて説明します。

adbsyndictコマンドを実行できるOSユーザを次に示します。

HADB管理者

46.2.1　指定形式およびオプションの説明

(1)　指定形式

adbsyndict ｛-m 辞書情報登録ファイル名
           ｜-d 辞書情報削除ファイル名
           ｜-s
           ｜-n 同義語辞書名 -o 同義語一覧の出力ファイル名
           ｜--clean｝

(2)　オプションの説明

●-m 辞書情報登録ファイル名

〜〈OSパス名〉((2〜510バイト))

同義語辞書を登録または更新する場合に指定します。辞書情報登録ファイル名は，絶対パスで指定してください。

辞書情報登録ファイルについては，マニュアルHADB　システム構築・運用ガイドの同義語検索を行うための準備をするの辞書情報登録ファイルを作成するを参照してください。

●-d 辞書情報削除ファイル名

〜〈OSパス名〉((2〜510バイト))

同義語辞書を削除する場合に指定します。辞書情報削除ファイル名は，絶対パスで指定してください。

辞書情報削除ファイルについては，マニュアルHADB　システム構築・運用ガイドの同義語辞書を削除するを参照してください。

●-s

-sオプションを指定してadbsyndictコマンドを実行すると，全ノードの同義語辞書ファイルの同期を取ります。

-sオプションは，マルチノード機能使用時に指定するオプションです。マルチノード機能を使用していない場合に-sオプションを指定したときは，adbsyndictコマンドがエラーになります。

●-n 同義語辞書名 -o 同義語一覧の出力ファイル名

同義語辞書に登録されている同義語の一覧をファイルに出力する場合に指定します。

-n 同義語辞書名

〜〈文字列〉((1〜120バイト))

同義語の一覧を出力する同義語辞書の名称を指定します。

-o 同義語一覧の出力ファイル名

〜〈OSパス名〉((2〜510バイト))

同義語一覧を出力するファイルの名称を絶対パスで指定します。

●--clean

サーバ定義のadb_syndict_storage_pathオペランドに指定した同義語辞書ファイルの格納ディレクトリ下にある不要なファイルを削除します。削除処理に失敗した同義語辞書ファイル，または作業用一時ファイルが残っている場合に，--cleanオプションを指定してadbsyndictコマンドを実行します。

46.3　使用例

adbsyndictコマンドの使用例を例題形式で説明します。

46.3.1　同義語辞書を登録する場合

次に示す2つの同義語辞書を登録します。

Dictionary1

Dictionary2

このとき，次に示す手順でadbsyndictコマンドを実行します。

手順

同義語一覧定義ファイルを作成する

辞書情報登録ファイルを作成する

adbsyndictコマンドを実行する

各手順の例を以降で説明します。

(1)　同義語一覧定義ファイルを作成する

同義語の一覧を指定した同義語一覧定義ファイルを作成します。

同義語一覧定義ファイルの指定例（Dictionary1用）

データベース,データバンク,database↓

同義語一覧定義ファイルの指定例（Dictionary2用）

アプリケーションサーバ,APサーバ,application server↓

（凡例）↓：改行

この例では，上記2つの同義語一覧定義ファイルを次のファイル名で保存したとします。

/home/adbmanager/dictionary1_synonym.txt

/home/adbmanager/dictionary2_synonym.txt

(2)　辞書情報登録ファイルを作成する

登録する同義語辞書の情報を指定した辞書情報登録ファイルを作成します。

辞書情報登録ファイルの指定例

Dictionary1,/home/adbmanager/dictionary1_synonym.txt,CORRECTIONRULE,データベースの同義語↓
Dictionary2,/home/adbmanager/dictionary2_synonym.txt,CASESENSITIVE,アプリケーションサーバの同義語↓

（凡例）↓：改行

［説明］

1列目

同義語辞書名を指定します。

2列目

「(1)　同義語一覧定義ファイルを作成する」で作成した，同義語一覧定義ファイルの絶対パス名を指定します。

3列目

表記ゆれ補正オプションを指定します。次のどちらかを指定します。

CORRECTIONRULE：表記ゆれ補正検索に対応する同義語辞書を作成する場合に指定します。

CASESENSITIVE：表記ゆれ補正検索に対応しない同義語辞書を作成する場合に指定します。

4列目

同義語辞書に対するコメントを指定します。

この例では，上記の辞書情報登録ファイルを次のファイル名で保存したとします。

/home/adbmanager/dictionary_information.txt

(3)　adbsyndictコマンドを実行する

adbsyndict -m /home/adbmanager/dictionary_information.txt

［説明］

-mオプションには，「(2)　辞書情報登録ファイルを作成する」で作成した，辞書情報登録ファイルの絶対パス名を指定します。

メモ

同義語一覧定義ファイルの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの同義語一覧定義ファイルの指定規則を参照してください。

辞書情報登録ファイルの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの辞書情報登録ファイルの指定規則を参照してください。

46.3.2　同義語辞書を更新する場合

同義語辞書Dictionary1に登録されている同義語グループに同義語を追加します。この例では，同義語に「RDB」を追加します。

このとき，次に示す手順でadbsyndictコマンドを実行します。

手順

保管している同義語一覧定義ファイルの指定を修正する

保管している辞書情報登録ファイルの指定内容を確認する

adbsyndictコマンドを実行する

各手順の例を以降で説明します。

(1)　保管している同義語一覧定義ファイルの指定を修正する

同義語一覧定義ファイルの指定例

データベース,データバンク,database,RDB↓

（凡例）↓：改行

保管しているDictionary1用の同義語一覧定義ファイルを修正します。この例では，下線部分の同義語を追加しています。

この例では，Dictionary1用の同義語一覧定義ファイルを次のファイル名で保存しているとします。

/home/adbmanager/dictionary1_synonym.txt

(2)　保管している辞書情報登録ファイルの指定内容を確認する

辞書情報登録ファイルの指定例

Dictionary1,/home/adbmanager/dictionary1_synonym.txt,CORRECTIONRULE,データベースの同義語↓

（凡例）↓：改行

保管している辞書情報登録ファイルの指定内容を確認してください。同義語の追加に伴いコメントを変更する必要がある場合は，コメントを変更してください。

この例では，辞書情報登録ファイルを次のファイル名で保存しているとします。

/home/adbmanager/dictionary1_information.txt

(3)　adbsyndictコマンドを実行する

adbsyndict -m /home/adbmanager/dictionary1_information.txt

［説明］

-mオプションには，「(2)　保管している辞書情報登録ファイルの指定内容を確認する」で確認した，辞書情報登録ファイルの絶対パス名を指定します。

メモ

同義語一覧定義ファイルの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの同義語一覧定義ファイルの指定規則を参照してください。

辞書情報登録ファイルの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの辞書情報登録ファイルの指定規則を参照してください。

46.3.3　同義語辞書を削除する場合

次に示す2つの同義語辞書を削除します。

Dictionary1

Dictionary2

このとき，次に示す手順でadbsyndictコマンドを実行します。

手順

辞書情報削除ファイルを作成する

adbsyndictコマンドを実行する

各手順の例を以降で説明します。

(1)　辞書情報削除ファイルを作成する

削除対象の同義語辞書名を指定した辞書情報削除ファイルを作成します。

辞書情報削除ファイルの指定例

Dictionary1↓
Dictionary2↓

（凡例）↓：改行

この例では，辞書情報削除ファイルを次のファイル名で保存したとします。

/home/adbmanager/dictionary_delete.txt

(2)　adbsyndictコマンドを実行する

adbsyndict -d /home/adbmanager/dictionary_delete.txt

［説明］

-dオプションには，「(1)　辞書情報削除ファイルを作成する」で作成した，辞書情報削除ファイルの絶対パス名を指定します。

メモ

辞書情報削除ファイルの指定規則の詳細については，マニュアルHADB　システム構築・運用ガイドの同義語辞書を削除するを参照してください。

46.3.4　同義語辞書ファイルの同期を取る場合

同義語辞書ファイルの同期を取ります。この場合，次に示すadbsyndictコマンドを実行します。

adbsyndict -s

46.3.5　同義語辞書に登録されている同義語の一覧を出力する場合

同義語辞書Dictionary1に登録されている同義語の一覧を，/home/adbmanager/dictionary1_output.txtに出力します。この場合，次に示すadbsyndictコマンドを実行します。

adbsyndict -n Dictionary1 -o /home/adbmanager/dictionary1_output.txt

/home/adbmanager/dictionary1_output.txtの出力例

"データベース","データバンク","database"↓
"アプリケーションサーバ","APサーバ","application server"↓

（凡例）↓：改行

同義語の一覧は，同義語一覧定義ファイルと同じ形式で出力されます。上記の例のように，1行が1同義語グループの同義語になります。

46.3.6　同義語辞書ファイルの格納ディレクトリ下にある不要なファイルを削除する場合

サーバ定義のadb_syndict_storage_pathオペランドに指定した同義語辞書ファイルの格納ディレクトリ下にある不要なファイルを削除します。この場合，次に示すadbsyndictコマンドを実行します。

adbsyndict --clean

46.4　リターンコード

adbsyndictコマンドのリターンコードを次の表に示します。

表46‒1　adbsyndictコマンドのリターンコード

リターンコード

意味

0

adbsyndictコマンドが正常に終了しました。

4

adbsyndictコマンドは正常に終了しましたが，警告メッセージが出力されました。同義語辞書の登録，更新，または削除は完了しています。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbsyndictコマンドの指定に誤りがあり，adbsyndictコマンドが実行されませんでした。

adbsyndictコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージ，またはメッセージログファイルに出力されたエラーメッセージを参照してください。

■同義語辞書を登録，更新，または削除したときに，リターンコード4が返ってきた場合の対処

KFAA51504-W，KFAA51520-Wメッセージが出力された場合

不要となった同義語辞書ファイルまたは作業用の一時ファイルの削除処理に失敗した可能性があります。出力された警告メッセージを参照して，その警告メッセージに記載されている対策に従ってください。

不要となったファイルが残っている場合は，adbsyndict --cleanコマンドで削除してください。

マルチノード機能を使用している場合は，そのあとでadbsyndict -sコマンドを実行して同義語辞書ファイルの同期を取ってください。同義語辞書ファイルの同期処理時に，不要となったファイルがセカンダリノードおよびワーカーノードから自動的に削除されます。

メモ

不要となった同義語辞書ファイルまたは作業用の一時ファイルがある状態であっても，同義語検索や，adbsyndictコマンドを実行できます。

KFAA51518-Wメッセージが出力された場合

停止中のノードがある状態で，同義語辞書の登録，更新，削除や，同義語辞書ファイルの同期を行った場合に，この警告メッセージが出力されます。停止中のノードは，同義語辞書ファイルの同期処理の対象外になるため，ノードを復帰したあとにadbsyndict -sコマンドを実行して同義語辞書ファイルの同期を取る必要があります。

KFAA51524-Wメッセージが出力された場合

不要となった同義語辞書ファイルの削除処理がキャンセルされた場合に，この警告メッセージが出力されます。不要となった同義語辞書ファイルをadbsyndict --cleanコマンドで削除してください。

マルチノード機能を使用している場合は，そのあとでadbsyndict -sコマンドを実行して同義語辞書ファイルの同期を取ってください。同義語辞書ファイルの同期処理時に，不要となった同義語辞書ファイルがセカンダリノードおよびワーカーノードから自動的に削除されます。

メモ

不要となった同義語辞書ファイルがある状態であっても，同義語検索や，adbsyndictコマンドを実行できます。

■同義語辞書ファイルの同期を取ったときに，リターンコード4が返ってきた場合の対処

次の原因が考えられます。

同期処理に失敗した同義語辞書ファイルがある

同期できていないノードが存在する

作業用の一時ファイルの削除処理に失敗したか，または削除処理がキャンセルされた

メッセージログファイルに出力された警告メッセージを参照して，その警告メッセージに記載されている対策に従ってください。そのあとで，adbsyndict -sコマンドを実行し，同義語辞書ファイルの同期を取ってください。

■同義語の一覧を出力したときに，リターンコード4が返ってきた場合の対処

KFAA51523-Wメッセージが出力された場合

同義語の一覧を出力した同義語辞書が不正な状態になっているおそれがあります。KFAA51523-Wメッセージに記載されている対策に従ってください。

■リターンコード8が返ってきたときに，KFAA51504-WまたはKFAA51520-Wメッセージが一緒に出力された場合の対処

不要となった同義語辞書ファイルまたは作業用の一時ファイルの削除処理に失敗した可能性があります。出力された警告メッセージを参照して，その警告メッセージに記載されている対策に従ってください。

不要なファイルが残っている場合は，adbsyndict --cleanコマンドで削除してください。

マルチノード機能を使用している場合は，そのあとでadbsyndict -sコマンドを実行して同義語辞書ファイルの同期を取ってください。同義語辞書ファイルの同期処理時に，不要となった同義語辞書ファイルがセカンダリノードおよびワーカーノードから自動的に削除されます。

メモ

不要な同義語辞書ファイルまたは作業用の一時ファイルがある状態であっても，adbsyndictコマンドを再実行できます。

46.5　adbsyndictコマンドが異常終了したときの対処方法

adbsyndictコマンドが異常終了した場合，同義語辞書の状態はコマンド実行前の状態のままになります。そのため，コマンドが異常終了した原因を取り除いたあとに，adbsyndictコマンドを再実行してください。

46.6　注意事項

adbsyndictコマンドは複数同時に実行できません。

adbsyndictコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

同義語辞書の登録および削除処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbsyndictコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中の同義語辞書の登録，更新，または削除処理は中断されません（処理が続行されます）。同義語辞書の登録，更新，または削除処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

同義語辞書ファイルの格納ディレクトリに同義語辞書ファイル以外のファイルを格納しないでください。

同義語辞書ファイルの格納ディレクトリ下に，HADBサーバに登録されていない同義語辞書ファイルが格納されている場合，adbsyndictコマンド（同義語辞書ファイルの同期，同義語一覧の出力時を除く）の実行時にそのファイルが削除されます。

メモ

adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了した場合，作成途中の同義語辞書ファイルが同義語辞書ファイルの格納ディレクトリ下に残ることがありますが，次回のadbsyndictコマンド実行時に自動的に削除されます。

クラウドストレージ機能を使用している場合，同義語辞書を登録することはできません。KFAA51539-Eメッセージが出力され，adbsyndictコマンドがエラーとなります。

adbsyndictコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbsyndictコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表46‒2　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

辞書情報登録ファイル

HADBサーバプロセスの実行ユーザ

コマンドの実行ユーザ

読み取り権限

辞書情報削除ファイル

HADBサーバプロセスの実行ユーザ

コマンドの実行ユーザ

読み取り権限

同義語一覧定義ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

同義語一覧の出力ファイル※2を格納するディレクトリ

HADBサーバプロセスの実行ユーザ

書き込み権限

実行権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

adbsyndictコマンドの実行時，権限に664を設定した同義語一覧の出力ファイルが作成されます。

47　adbunarchivechunk（チャンクのアンアーカイブ）

この章では，adbunarchivechunkコマンドの機能と使い方について説明します。

47.1　機能

この節では，adbunarchivechunkコマンドの機能，および使用するスレッドについて説明します。

adbunarchivechunkコマンドは，コマンド実行時にHADBサーバに接続します。

47.1.1　機能概要

adbunarchivechunkコマンドを実行すると，チャンクのアーカイブ状態を解除できます（チャンクをアンアーカイブできます）。チャンクのアーカイブ状態を解除することで，圧縮したチャンクを伸長できます。チャンクのアーカイブ状態を解除する処理をチャンクのアンアーカイブ処理といいます。

チャンクのアンアーカイブ処理を実行すると，対象となるアーカイブ状態のチャンクのデータ（アーカイブファイルのデータ）が伸長され，DBエリアファイルに格納されます。これによって，チャンクのアーカイブ状態は解除されます。

チャンクのアンアーカイブ処理の概要を次の図に示します。

図47‒1　adbunarchivechunkコマンドの概要

［説明］

adbunarchivechunkコマンドを実行すると，対象となるアーカイブされたチャンクのデータ（アーカイブファイルのデータ）が伸長され，DBエリアファイルに格納されます。これによって，アーカイブマルチチャンク表に作成されたチャンクのアーカイブ状態は解除されます。

DBエリアファイルへの格納処理の完了後，チャンクに対応するアーカイブファイルは削除されます。

なお，1回のadbunarchivechunkコマンドの実行で，複数のチャンクのアーカイブ状態を解除することもできます。複数のチャンクのアーカイブ状態を解除する場合は，チャンクの数だけ，格納処理および削除処理を繰り返します。

チャンクのアンアーカイブの詳細については，マニュアルHADB　システム構築・運用ガイドのチャンクアーカイブ機能（チャンク内のデータの圧縮）のデータの伸長（アーカイブ状態の解除）を参照してください。

47.1.2　adbunarchivechunkコマンドが使用するスレッドの関係

adbunarchivechunkコマンドは，次の処理で処理リアルスレッドを使用します。

表データの格納（アーカイブファイルの読み込み），作業用一時ファイルの作成，およびレンジインデクスの作成

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

MAX_RTHD_NUMは，アンアーカイブチャンクオプションadb_unarcv_rthd_numの指定値またはデフォルト値となります。アンアーカイブチャンクオプションadb_unarcv_rthd_numのデフォルト値については，「47.2.2　アンアーカイブチャンクオプションの形式」の「(2)　指定形式の説明」にある，アンアーカイブチャンクオプションadb_unarcv_rthd_numを参照してください。

B-treeインデクスおよびテキストインデクスのレコードのソート

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

B-treeインデクスおよびテキストインデクスの作成

この処理では，「1～（ MAX_RTHD_NUM－1 ）」の処理リアルスレッドを使用します。

コマンドの処理経過の出力

この処理では，処理リアルスレッドを１つ使用します。

なお，処理1～処理3は順に実行されます。処理4は，処理1～処理3の実行中，常に実行されます。

adbunarchivechunkコマンドが処理リアルスレッドを使用する処理を，次の図に示します。上記の番号は，図中の番号に対応しています。

図47‒2　adbunarchivechunkコマンドが処理リアルスレッドを使用する処理

47.2　adbunarchivechunkコマンドの指定形式

adbunarchivechunkコマンドの指定形式，およびアンアーカイブチャンクオプションの形式について説明します。

adbunarchivechunkコマンドを実行できるOSユーザを次に示します。

HADB管理者

HADB管理グループに所属するOSユーザ

47.2.1　指定形式およびオプションの説明

(1)　指定形式

adbunarchivechunk
  -u 認可識別子
  〔-p パスワード〕
  〔-g チャンクのアンアーカイブ処理の経過メッセージの出力間隔〕
  〔-w ｛作業用一時ファイルの格納先ディレクトリ名
        ｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝〕
  〔-z アンアーカイブチャンクオプションファイル名〕
  〔-t〕
  ｛-c チャンクID指定〔,チャンクID指定〕…｜-r 範囲指定｝
  〔--force〕
  処理対象表

重要

処理対象表は，必ずオプションの最後に指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbunarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。

adbunarchivechunkコマンドを実行するには，次の2つの権限を持っている必要があります。

CONNECT権限

処理対象表に対するUNARCHIVE CHUNK権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbunarchivechunkコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

●-g チャンクのアンアーカイブ処理の経過メッセージの出力間隔

〜〈整数〉((0〜1,000,000,000))《0》（単位：1,000行）

チャンクのアンアーカイブ処理の経過メッセージの出力間隔を指定します。

例えば，このオプションに2を指定すると，チャンクのアンアーカイブ処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。

なお，複数のチャンクに対して，チャンクのアンアーカイブ処理を行う場合，経過メッセージはチャンクごとに出力されます。例えば，このオプションに2を指定していて，チャンクのアンアーカイブ処理を行うチャンクが3つある場合は，3つのチャンクそれぞれに対して，チャンクのアンアーカイブ処理が2,000行終わるごとに経過メッセージ（KFAA80205-I）が出力されます。どのチャンクに対する処理かは，出力される経過メッセージからわかります。

このオプションを省略した場合，またはこのオプションに0を指定した場合，経過メッセージは出力されません。

●-w ｛作業用一時ファイルの格納先ディレクトリ名｜作業用一時ファイルの格納先を指定したディレクトリパスファイル名｝

〜〈OSパス名〉((2〜518バイト))

チャンクのアンアーカイブ処理時に作成される作業用一時ファイルの格納先を，次に示すどちらかの方法で指定します。

作業用一時ファイルを格納するディレクトリ名を絶対パス名で指定する

作業用一時ファイルを格納するディレクトリを指定したファイル名（ディレクトリパスファイル名）を絶対パス名で指定する

1つのディレクトリ下に格納される作業用一時ファイルに対して入出力が集中すると，性能低下の原因になります。そのため，2の方法で作業用一時ファイルを異なるディスクのディレクトリに格納して，ディスクに対する入出力処理の負荷を分散することを推奨します。2の方法の指定例（ディレクトリパスファイルの指定例）を次に示します。

ディレクトリパスファイルの指定例

/mnt/diska/wwwww
/mnt/diskb/xxxxx
/mnt/diskc/yyyyy
/mnt/diskd/zzzzz

指定するディレクトリ数の目安を次に示します。

指定するディレクトリ数の目安＝A×B

A：データ格納スレッド数

次の計算式で求めてください。

アンアーカイブチャンクオプションadb_unarcv_rthd_numの値－1

B：アンアーカイブチャンク対象表に定義されているB-treeインデクスおよびテキストインデクスの数

B-treeインデクスおよびテキストインデクスの数がわからない場合は，次に示すSQL文で表に定義されているB-treeインデクスおよびテキストインデクスの数を確認してください。

SELECT "N_INDEX"-"N_RANGE_INDEX"
    FROM "MASTER"."SQL_TABLES"
        WHERE "TABLE_SCHEMA"='認可識別子'
           AND "TABLE_NAME"='処理対象表の表名'

ディレクトリパスファイル中にディレクトリを255個まで指定できます。

ディレクトリパスファイル中に記述されている順番に，作業用一時ファイルの格納先ディレクトリとして使用されます。ディレクトリパスファイル中に記述された最後のディレクトリ（この例では/mnt/diskd/zzzzz）が使用された場合，次に使用されるディレクトリは先頭のディレクトリ（この例では/mnt/diska/wwwww）になります。

このオプションの指定規則（方法1，2の両方の指定規則）を次に示します。

パス名の末尾にスラッシュ（/）を指定しないでください。

-wオプションに指定したディレクトリ下に作成される作業用一時ファイルの容量見積もりについては，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンド実行時の作業用一時ファイルの容量見積もりのadbunarchivechunkコマンド実行時の作業用一時ファイルの容量見積もりを参照してください。なお，このオプションを省略した場合，$DBDIR/ADBWORK下に作業用一時ファイルが作成されます。

作業用一時ファイルを格納するディレクトリは，専用のディレクトリにしてください。ほかのファイルを格納しているディレクトリと重複した場合，既存のファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。作業用一時ファイルの格納先ディレクトリ名と重複しないようにする必要があるファイルについては，「47.6　注意事項」を参照してください。

なお，作業用一時ファイルを格納するディスクの空き容量が不足した場合は，容量が大きい別のディスクを格納先として指定してください。作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処については，マニュアルHADB　システム構築・運用ガイドのトラブルシュートのコマンドに関するトラブルのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法を参照してください。

メモ

作業用一時ファイルを格納するディスクには，セクターサイズが512バイトまたは4,096バイトのディスクが使用できます。

●-z アンアーカイブチャンクオプションファイル名

〜〈OSパス名〉((2〜510バイト))

アンアーカイブチャンクオプションを指定したアンアーカイブチャンクオプションファイルの絶対パス名を指定します。このオプションを省略すると，アンアーカイブチャンクオプションファイルが指定されないため，すべてのアンアーカイブチャンクオプションにデフォルト値が仮定されます。

アンアーカイブチャンクオプションについては，「47.2.2　アンアーカイブチャンクオプションの形式」を参照してください。

なお，アンアーカイブチャンクオプションファイル名は，ほかのファイル名と重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。アンアーカイブチャンクオプションファイル名と重複しないようにする必要があるファイルについては，「47.6　注意事項」を参照してください。

●-t

実際にチャンクのアンアーカイブ処理を行う前に，アーカイブ状態が解除されるチャンクを確認する場合に指定します。

このオプションを指定すると，-cオプション，または-rオプションで指定した範囲に該当するチャンクのうち，アーカイブ状態が解除されるチャンクのチャンクIDがKFAA80245-Iメッセージに出力されます。

これらのチャンクに対して，チャンクのアンアーカイブ処理を行う場合，-tオプション以外は同じ指定で（-tオプションを省略して）adbunarchivechunkコマンドを実行してください。アーカイブ状態を解除するチャンクを見直す場合は，-cオプション，または-rオプションの指定値を修正したあとで，adbunarchivechunkコマンドを実行してください。

重要

このオプションを指定した場合，チャンクのアンアーカイブ処理は実行されません。

●-c チャンクID指定〔,チャンクID指定〕…

〜〈整数〉((1〜9,223,372,036,854,775,807))

処理対象表中のチャンクのうち，アーカイブ状態を解除するチャンクのチャンクIDを指定します。1つ以上のチャンクIDを指定できます。

チャンクID指定は，次に示す方法で指定できます。なお，それぞれの方法を組み合わせて指定することもできます。

図47‒3　-cオプションのチャンクID指定の例

チャンクIDを1つずつ指定する（単独指定）

アーカイブ状態を解除するチャンクのチャンクIDを1つずつ指定したい場合は，チャンクIDをコンマ（,）で区切って指定します。

重要

チャンクIDとコンマ（,）の間には空白を入れないでください。

チャンクIDの範囲を指定する（範囲指定）

アーカイブ状態を解除するチャンクのチャンクIDの範囲を指定したい場合は，「範囲の最小のチャンクID-範囲の最大のチャンクID」の形式で指定します（2つのチャンクIDをハイフン（-）でつなぎます）。

重要

ハイフン（-）とチャンクIDの間には空白を入れないでください。また，ハイフンの右側には，ハイフンの左側のチャンクIDより大きいチャンクIDを指定してください。

指定したチャンクIDのチャンクのうち，次に示すチャンクのアーカイブ状態は解除されません（処理対象表に存在するアーカイブされたチャンクだけ，アーカイブ状態が解除されます）。

処理対象表に存在しないチャンク

アーカイブされていないチャンク

このオプションの指定時の規則を次に示します。

チャンクIDは，最大30,000個指定できます。チャンクIDの数え方を次に示します。

・範囲指定の場合，範囲内のすべてのチャンクIDが個数に数えられます。

・指定したチャンクIDが重複している場合，重複した分も個数に数えられます。

チャンクID指定の例と数え方

（例1）-c 1,3,5：3個のチャンクID（1，3および5）を指定したと見なされます。

（例2）-c 1,3,5-8,10：7個のチャンクID（1，3，5，6，7，8および10）を指定したと見なされます。

（例3）-c 1,3,5,5-8,10：8個のチャンクID（1，3，5，5，6，7，8および10）を指定したと見なされます。

-cオプションに指定できる値の長さの上限は32キロバイトです。このため，チャンクID指定の長さが32キロバイトを超える場合は，範囲指定に変更するか，または複数回に分けて，adbunarchivechunkコマンドを実行してください。

エラーとなる指定内容および指定例については，「(3)　-cオプションの指定が原因のエラー」を参照してください。

■処理対象表に存在するチャンクのチャンクIDの検索方法

処理対象表に存在するチャンクのチャンクIDを検索する方法を次に示します。

システム表のSTATUS_CHUNKSを検索する

システム表のSTATUS_CHUNKSを検索し，チャンクIDを確認してください。

詳細については，マニュアルHADB　システム構築・運用ガイドのシステム表のシステム表の検索の表名から表内の全チャンクの情報を調べる場合を参照してください。

adbdbstatusコマンドを実行する

次に示すコマンドを実行してDBエリア，表とインデクスの使用量情報を出力し，チャンクID（Chunk_ID）を確認してください（結果はCSV形式で出力されます）。DBエリア，表とインデクスの使用量情報で出力される項目の詳細については，「13.7.2　DBエリア，表とインデクスの使用量情報で出力される項目の一覧」を参照してください。

adbdbstatus -d used -c table -n 処理対象表の表名

表名は「スキーマ名.表識別子」の形式で指定してください。

●-r 範囲指定

アーカイブ状態を解除するチャンクの範囲を指定します。-rオプションの詳細については，「(4)　-rオプション（範囲指定）の詳細」を参照してください。

●--force

通常は，このオプションを省略してください。

このオプションは，次に示す場合に指定してください。

再実行したadbunarchivechunkコマンドが異常終了した場合に出力されるエラーメッセージの対策欄で，このオプションを指定してadbunarchivechunkコマンドを実行する必要があると明示されているとき

例えば，再実行に必要なコマンドステータスファイル（$DBDIR/ADBSYS/ADBUTLディレクトリ下のファイル）にアクセスできない場合などが該当します。このオプションを指定してadbunarchivechunkコマンドを実行すると，チャンクのアンアーカイブ処理を強制実行します。

このオプションを指定して，adbunarchivechunkコマンドを実行する際の手順を次に示します。

--forceオプションを指定したadbunarchivechunkコマンドを実行します。

マニュアルHADB　システム構築・運用ガイドのコマンド実行時の作業用一時ファイルを格納するディスクの空き容量が不足した場合の対処方法にあるディスクに不要な作業用一時ファイルが残っている場合を参照して，作業用一時ファイルを削除します。

●処理対象表

チャンクのアンアーカイブ処理の対象となるアーカイブマルチチャンク表を指定します。

指定規則を次に示します。

「スキーマ名.表識別子」の形式で指定します。

自分が所有している表を指定する場合は，スキーマ名を省略できます。ほかのHADBユーザが所有している表を指定する場合は，スキーマ名を指定してください。

スキーマ名または表識別子中に，英小文字または¥がある場合の指定規則については，「1.4.3　表名の指定規則」を参照してください。

アーカイブマルチチャンク表以外の表は指定できません。

UNARCHIVE CHUNK権限を持っている表を指定できます。

更新できる（更新不可状態ではない）表を指定してください。更新不可状態の表を指定するとエラーになります。

ビュー表は指定できません。

(3)　-cオプションの指定が原因のエラー

-cオプションの指定が原因でadbunarchivechunkコマンドがエラーとなる場合には，次の2つが考えられます。

-cオプションの指定形式に誤りがある場合

-cオプションに不正なチャンクIDを指定している場合

どちらの場合も，指定を修正したあと，再度adbunarchivechunkコマンドを実行してください。なお，-cオプションの詳細については，「(2)　オプションの説明」の「-c」を参照してください。

(a)　-cオプションの指定形式に誤りがある場合

-cオプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒1　オプションの指定形式に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定したチャンクIDの個数が30,000個を超えている

-c 1-30001

-c 1-30000

2

ハイフン（-）の両側に同じチャンクIDを指定している

-c 3-3,7

-c 3-5,7

3

ハイフン（-）の右側に，左側のチャンクIDより小さいチャンクIDを指定している

-c 10-3

-c 3-10

4

KFAA90002-E

KFAA96840-I

チャンクIDとコンマ（,）の間に空白がある

-c 1,3,△10

-c 1,3,10

5

チャンクIDとハイフン（-）の間に空白がある

-c 1,3△-△10

-c 1,3-10

6

KFAA90003-E

指定値の長さが32キロバイトを超えている

-c 1-xxxxx

単独指定ではなく，範囲指定に変更する（コンマ（,）ではなくハイフン（-）を使用する）

（凡例）

△：空白

(b)　-cオプションに不正なチャンクIDを指定している場合

-cオプションに不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒2　不正なチャンクIDを指定している場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例および対処方法

1

KFAA50284-E

指定したチャンクIDのチャンクすべてが処理対象表に存在しない

処理対象表に存在するチャンクのチャンクIDが2および6の場合

-c 3-5

-c 4,5

処理対象表に存在するチャンクのチャンクIDが2および6の場合

-c 2,6

-c 2-6

処理対象表に存在し，かつアーカイブされたチャンクのチャンクIDを指定してください。

注

処理対象表に存在するチャンクのチャンクIDを検索する方法については，「(2)　オプションの説明」の「-c」を参照してください。

(4)　-rオプション（範囲指定）の詳細

アーカイブ状態を解除するチャンクの範囲を，-rオプションで指定します。範囲指定に指定した範囲に，アーカイブレンジ列（アーカイブマルチチャンク表の検索時に，検索範囲を絞り込むために使用する列）の値の範囲が一部でも含まれている場合，該当するチャンクのアーカイブ状態が解除されます。ただし，指定した範囲のデータが格納されたチャンクのうち，アーカイブされていないチャンクのアーカイブ状態は解除されません。

範囲指定は，アーカイブレンジ列のデータ型に基づき，解釈されます。

範囲指定の種類と詳細な説明の参照先を次の表に示します。

表47‒3　範囲指定の種類および参照先

項番

範囲指定の種類

参照先

1

日付の範囲指定

「(a)　日付の範囲指定」

2

時刻の範囲指定

「(b)　時刻の範囲指定」

3

時刻印の範囲指定

「(c)　時刻印の範囲指定」

4

固定長文字列の範囲指定

「(d)　固定長文字列の範囲指定」

5

10進数の範囲指定

「(e)　10進数の範囲指定」

6

整数の範囲指定

「(f)　整数の範囲指定」

7

浮動小数点数の範囲指定

「(g)　浮動小数点数の範囲指定」

次の条件の場合を例に，どのチャンクがアーカイブ状態を解除されるかについて示します。

アーカイブレンジ列のデータ型がDATE型

範囲指定に「2015/02/10〜2015/04/01」の日付の範囲を指定

図47‒4　日付の範囲指定の内容とアーカイブ状態が解除されるチャンクの関係

-rオプションの指定時の規則を次に示します。

範囲指定は，1つだけ指定できます。複数の範囲は指定できません。

範囲指定に1,024バイト以上指定した場合はKFAA90003-Eメッセージが出力されます。

このオプションには，シェルによる囲み文字などの解析後の値を指定してください。シェルの文字解析によっては，指定値と実際に解釈される値が異なることがあります。固定長文字列の範囲指定の例を次に示します。

オプションの指定値：-r 'abc'-'def'

実際に解釈される値：-r abc-def

実際に解釈される値はアポストロフィ（'）が取り除かれた値です。

(a)　日付の範囲指定

アーカイブ状態を解除するチャンクの範囲を日付で指定します。

形式

-r ｛YYYY-MM-DD｜YYYY/MM/DD｝-｛YYYY-MM-DD｜YYYY/MM/DD｝

最小値（日付指定）と最大値（日付指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

指定例

指定例1：-r 2016/01/01-2016/12/31

指定例2：-r 2016-01-01-2016-12-31

それぞれの日付は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。

指定例1の場合，2016/01/01，および2016/12/31が日付指定として扱われます。

指定例2の場合，2016-01-01，および2016-12-31が日付指定として扱われます。

日付の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」の桁数が足りない場合は，足りない分，左側に0を補ってください。

日付の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DATE型

TIMESTAMP型

日付の範囲指定では，日付だけを指定できます。アーカイブレンジ列のデータ型がTIMESTAMP型の場合，時刻の指定は省略されたものとして扱われます。そのため，次に示す表のとおりに開始時刻と終了時刻が補正されます。その結果，指定した日付の範囲指定内のデータが含まれるすべてのチャンクが，アーカイブ状態を解除する対象になります。

表47‒4　開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

0

0時0分0秒

23時59分59秒

2

3

0時0分0.000秒

23時59分59.999秒

3

6

0時0分0.000000秒

23時59分59.999999秒

4

9

0時0分0.000000000秒

23時59分59.999999999秒

5

12

0時0分0.000000000000秒

23時59分59.999999999999秒

日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒5　日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

日付の桁数が規定を超えている

日付の桁数が規定より不足している

-r 2015/7/1-2015/008/031

-r 2015/07/01-2015/08/31

2

範囲外の日付を指定している

-r 2015/01/01-2015/06/31

-r 2015/01/01-2015/06/30

3

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r 2015/01/11△-△2015/7/31

説明

日付指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 2015/01/11-2015/07/31

（凡例）

△：空白

(b)　時刻の範囲指定

アーカイブ状態を解除するチャンクの範囲を時刻で指定します。

形式

-r hh:mm:ss〔.〔nn...n〕〕-hh:mm:ss〔.〔nn...n〕〕

最小値（時刻指定）と最大値（時刻指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r 00:00:00-12:59:59

指定例2：-r 00:00:00.000-12:59:59.999

それぞれの時刻は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。

小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，00:00:00，および12:59:59が時刻指定として扱われます。

指定例2の場合，00:00:00.000，および12:59:59.999が時刻指定として扱われます。

時刻の範囲指定に関する規則を次に示します。

「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIME型

小数秒がTIME型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIME型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表47‒6　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIME型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒7　時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻の桁数が規定を超えている

時刻の桁数が規定より不足している

-r 0:0:0-012:59:59

-r 00:00:00-12:59:59

2

範囲外の時刻を指定している

-r 00:00:00-12:60:00

-r 00:00:00-12:59:59

3

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r 00:00:00△-△12:59:59

説明

時刻指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 00:00:00-12:59:59

（凡例）

△：空白

(c)　時刻印の範囲指定

アーカイブ状態を解除するチャンクの範囲を時刻印で指定します。

形式

-r '｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'
    -'｛YYYY-MM-DD｜YYYY/MM/DD｝△hh:mm:ss〔.〔nn...n〕〕'

最小値（時刻印指定）と最大値（時刻印指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

YYYY：年（0001〜9999）

MM：月（01〜12）

DD：日（01〜MMに指定した月の最終日）

△：半角空白，またはタブ

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

.：小数点

nn...n：小数秒（nは0〜9）

指定例

指定例1：-r '2016/01/01 00:00:00'-'2016/12/31 12:59:59'

指定例2：-r '2016/01/01 00:00:00.000'-'2016/12/31 12:59:59.999'

それぞれの時刻印は，日付指定と時刻指定を半角空白で結び，アポストロフィ（'）で囲んで指定してください。日付指定は，「YYYY-MM-DD」または「YYYY/MM/DD」の形式で指定してください（「YYYY」，「MM」，「DD」をスラッシュ（/）またはハイフン（-）で区切ります）。時刻指定は，「hh」，「mm」，「ss」を，コロン（:）で区切ります。小数秒を指定する場合は，「ss」と「nn...n」を，小数点（.）で結んでください。

指定例1の場合，2016/01/01 00:00:00，および2016/12/31 12:59:59が時刻印指定として扱われます。

指定例2の場合，2016/01/01 00:00:00.000，および2016/12/31 12:59:59.999が時刻印指定として扱われます。

時刻印の範囲指定に関する規則を次に示します。

「YYYY」，「MM」，「DD」，「hh」，「mm」，「ss」の桁数が足りない場合は，足りない分，左側に0を補ってください。

時刻印の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

TIMESTAMP型

小数秒がTIMESTAMP型の列に定義した小数秒の桁数より大きい場合，小数秒の桁数より下位の桁部分は切り捨てられます。

小数秒を省略した場合，TIMESTAMP型の列に定義した小数秒の桁数を基に，開始時刻および終了時刻が補正されます。補正の詳細について，次の表に示します。

表47‒8　小数秒を省略した場合の，開始時刻および終了時刻の補正

項番

TIMESTAMP型の列に定義した小数秒の桁数

開始時刻

終了時刻

1

3

.000秒

.999秒

2

6

.000000秒

.999999秒

3

9

.000000000秒

.999999999秒

4

12

.000000000000秒

.999999999999秒

時刻印指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の日時データの比較を参照してください。

時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒9　時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

時刻印の桁数が規定を超えている

時刻印の桁数が規定より不足している

-r '2015/7/1△00:00:00'-'2015/008/031△12:59:59'

-r '2015/07/01△00:00:00'-'2015/08/31△12:59:59'

2

範囲外の時刻印を指定している

-r '2015/01/01△00:00:00'-'2015/06/31△12:60:00'

-r '2015/01/01△00:00:00'-'2015/06/30△12:59:59'

3

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r '2016/04/01△00:00:00'△-△'2016/06/30△12:59:59'

説明

時刻印指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r '2016/04/01△00:00:00'-'2016/06/30△12:59:59'

4

指定例

-r 2016/04/01△00:00:00-2016/06/30△12:59:59

説明

時刻印指定がアポストロフィ（'）で囲まれていないため，シェルが日付と時刻の間の空白でオプション引数を区切ってしまう

（凡例）

△：空白

(d)　固定長文字列の範囲指定

アーカイブ状態を解除するチャンクの範囲を固定長文字列で指定します。

形式

-r a...a-a...a

最小値（固定長文字列指定）と最大値（固定長文字列指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

a...a：1文字以上の文字列

指定例

-r 20160101-20161231

20160101および20161231が固定長文字列指定として扱われます。

固定長文字列の範囲指定に関する規則を次に示します。

固定長文字列指定には，1文字以上の文字列を指定します。

指定した固定長文字列指定は，英大文字と英小文字が区別されます。

固定長文字列の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

CHARACTER型

二重引用符（"），ストローク（|）など，OSやシェルが別の意味で使用している文字を含む固定長文字列指定を指定する場合は，その文字の直前にエスケープ文字（¥）を指定してください。または，固定長文字列指定の全体をアポストロフィ（'）で囲んでください。

指定例

指定例1：-r a¥|c-def

指定例2：-r 'a|c'-def

どちらの場合も，a|c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定を二重引用符（"）で囲み，さらにアポストロフィ（'）で囲むと，二重引用符（"）も固定長文字列指定として扱われます。

指定例

-r '"abc"'-def

"abc"，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にハイフン（-）を含める場合は，固定長文字列指定をアポストロフィ（'）で囲んでください。最小値と最大値の区切りと見なされるハイフン（-）と区別するためです。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'a-c¥'-def

アポストロフィ（'）で囲み，さらに二重引用符（"）で囲む場合

-r "'a-c'"-def

どちらの場合も，a-c，およびdefが固定長文字列指定として扱われます。

また，固定長文字列指定にハイフン（-）を含まない場合も，アポストロフィ（'）で囲むと，そのアポストロフィ（'）を除いた値が固定長文字列指定として扱われます。

指定例

¥'（バックスラッシュとアポストロフィ）で囲む場合

-r ¥'abc¥'-def

abc，およびdefが固定長文字列指定として扱われます。

固定長文字列指定にアポストロフィ（'）を含む場合は，1個のアポストロフィ（'）を表すのに，2個連続してアポストロフィ（'）を指定してください。

指定例

¥'（バックスラッシュとアポストロフィ）を2個指定する場合

-r a¥'¥'c-def

アポストロフィ（'）を含む固定長文字列指定を二重引用符（"）で囲む場合

-r "a''c"-def

どちらの場合も，a'c，およびdefが固定長文字列指定として扱われます。

固定長文字列指定の，最小値と最大値の比較については，マニュアルHADB　SQLリファレンスの変換，代入，比較できるデータ型の比較できるデータ型の文字データの比較を参照してください。

固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒10　固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

固定長文字列の範囲指定に，最小値と最大値の区切りと見なされるハイフン（-）が複数ある

-r a-c-def

-r 'a-c-def'

-r ¥'a-c¥'-def

2

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r abc△-△def

説明

固定長文字列指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r abc-def

（凡例）

△：空白

(e)　10進数の範囲指定

アーカイブ状態を解除するチャンクの範囲を10進数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝
    -〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜.b...b｝

最小値（10進数指定）と最大値（10進数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：整数部（aは0〜9）

.：小数点

b...b：小数部（bは0〜9）

DECIMAL(5,2)の場合の指定例

指定例1：-r -100-100

指定例2：-r -100.00-+100.00

-100.00および+100.00が10進数指定として扱われます。

10進数の範囲指定に関する規則を次に示します。

整数部と小数部のどちらかを指定する必要があります。小数部がない場合は，小数点を省略できます。

10進数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DECIMAL型

NUMERIC型

小数部がDECIMAL型またはNUMERIC型の位取り（小数部の桁数）より大きい場合，位取り（小数部の桁数）より下位の桁部分は切り捨てられます。

10進数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒11　10進数の範囲指定に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

指定例

-r 0-123456789012345678901234567890123456789

説明

10進数指定を39桁で指定している

指定例

-r 0-12345678901234567890123456789012345678

説明

10進数指定を38桁で指定する

2

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

10進数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(f)　整数の範囲指定

アーカイブ状態を解除するチャンクの範囲を整数で指定します。

形式

-r 〔｛+｜-｝〕a...a-〔｛+｜-｝〕a...a

最小値（整数指定）と最大値（整数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：数値（aは0〜9）

指定例

指定例1：-r -100-100

指定例2：-r -100-+100

-100および+100が整数指定として扱われます。

整数の範囲指定に関する規則を次に示します。

整数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

INTEGER型

BIGINT型

SMALLINT型

整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒12　整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

アーカイブレンジ列のデータ型で使用できない数値を指定している

INTEGERまたはBIGINTの場合

-r 0-9223372036854775808

SMALLINTの場合

-r 0-2147483648

INTEGERまたはBIGINTの場合

-r 0-9223372036854775807

SMALLINTの場合

-r 0-2147483647

2

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

整数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

(g)　浮動小数点数の範囲指定

アーカイブ状態を解除するチャンクの範囲を浮動小数点数で指定します。

形式

-r 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕
    - 〔｛+｜-｝〕｛a...a〔.〔b...b〕〕｜．b...b｝〔｛E｜e｝〔｛+｜-｝〕c...c〕

最小値（浮動小数点数指定）と最大値（浮動小数点数指定）をハイフン（-）でつなぎます。最小値とハイフン（-）の間，および最大値とハイフン（-）の間には空白を入れないでください。

説明

+，-：符号（"＋"符号は省略できます）

a...a：仮数部の整数部（aは0〜9）

.：小数点

b...b：仮数部の小数部（bは0〜9）

E，e：浮動小数点数定数

c...c：指数部（cは0〜9）

図47‒5　-rオプションの浮動小数点数の範囲指定の指定例

指定例1の場合は，-100，および100が浮動小数点数指定として扱われます。

指定例2の場合は，-1.0E2，および+1.0E2が浮動小数点数指定として扱われます。

指定例3の場合は，-100，および1.0E+2が浮動小数点数指定として扱われます。

浮動小数点数の範囲指定に関する規則を次に示します。

浮動小数点数の範囲指定が指定できるアーカイブレンジ列のデータ型は次のとおりです。

DOUBLE PRECISION型

FLOAT型

浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤りについて，次の表に示します。エラーとなった場合は，これらの誤りを修正したあと，再度adbunarchivechunkコマンドを実行してください。

表47‒13　浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り

項番

出力されるメッセージID

考えられる誤り

誤った指定の例

修正例

1

KFAA50225-E

指定できる文字数を超えている

指定例

-r 0-123…（中略）…789

説明

浮動小数点数指定を510文字で指定している

指定例

-r 0-123…（中略）…78

説明

浮動小数点数指定を509文字で指定する

2

KFAA90002-E

KFAA96840-I

範囲指定の形式が誤っている

指定例

-r 0△-△1

説明

浮動小数点数指定とハイフン（-）の間に空白があるため，シェルが空白でオプション引数を区切ってしまう

-r 0-1

（凡例）

△：空白

47.2.2　アンアーカイブチャンクオプションの形式

(1)　指定形式

〔set adb_unarcv_rthd_num = adbunarchivechunkコマンドが使用する処理リアルスレッド数〕
〔set adb_unarcv_read_size = バッファサイズ〕
〔set adb_unarcv_buff_blk_num = アンアーカイブチャンク用バッファブロック数〕
〔set adb_unarcv_sort_buff_size = ソートバッファサイズ〕
〔set adb_unarcv_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ〕
〔set adb_unarcv_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ〕
〔set adb_unarcv_txt_buff_size = テキストインデクスの作成用バッファサイズ〕
〔set adb_unarcv_decompress_buff_size = アーカイブファイルの伸長用バッファサイズ〕

上記のアンアーカイブチャンクオプションの指定規則は，サーバ定義と同じです。サーバ定義の指定規則については，マニュアルHADB　システム構築・運用ガイドのサーバ定義の文法規則を参照してください。

(2)　指定形式の説明

●adb_unarcv_rthd_num = adbunarchivechunkコマンドが使用する処理リアルスレッド数

〜〈整数〉((2〜4,096))

adbunarchivechunkコマンド実行時に使用する処理リアルスレッド数を指定します。

このオプションは，指定を推奨するオプションです。adbunarchivechunkコマンドは，このオプションで指定した値の処理リアルスレッド数を使用します。このため，adbunarchivechunkコマンドで使用したい処理リアルスレッド数に応じて，このオプションに適切な値を指定してください。adbunarchivechunkコマンドが処理リアルスレッドを使用する処理，および各処理で使用する処理リアルスレッド数については，「47.1.2　adbunarchivechunkコマンドが使用するスレッドの関係」を参照してください。

このオプションを省略した場合，adbunarchivechunkコマンド実行時に使用する処理リアルスレッド数は，サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と，コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。

表47‒14　コマンド実行時に使用する処理リアルスレッド数

項番

このオプションまたはサーバ定義の値

コマンド実行時に使用する処理リアルスレッド数

1

このオプションの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。

2

サーバ定義adb_sql_exe_max_rthd_numオペランドに0または1を指定した場合

－

3

サーバ定義adb_sql_exe_max_rthd_numオペランドに2以上の値を指定した場合

サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。

4

このオプションに2以上の値を指定した場合

このオプションに指定した値を使用します。

（凡例）

－：adbunarchivechunkコマンドがエラーとなります。

注

サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については，マニュアルHADB　システム構築・運用ガイドの性能に関するオペランド（set形式）を参照してください。

●adb_unarcv_read_size = バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

アーカイブファイルの読み込み処理で使用するバッファのサイズをキロバイト単位で指定します。

●adb_unarcv_buff_blk_num = アンアーカイブチャンク用バッファブロック数

〜〈整数〉((5〜4,096))《64》

チャンクのアンアーカイブ処理で使用するバッファのブロック数を指定します。

基本的にはデフォルト値のままで問題ありませんが，このオプションの指定値を大きくすると，チャンクのアンアーカイブ処理の性能が向上することがあります。

●adb_unarcv_sort_buff_size = ソートバッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用するソートバッファのサイズをメガバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_unarcv_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する入力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_unarcv_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

処理対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，B-treeインデクスおよびテキストインデクスの作成処理時に使用する出力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。

●adb_unarcv_txt_buff_size = テキストインデクスの作成用バッファサイズ

〜〈整数〉((1〜2,048))《256》（単位：メガバイト）

処理対象表にテキストインデクスが定義されている場合に，このオプションの指定を検討してください。

このオプションには，テキストインデクスの作成処理時に使用するバッファサイズをメガバイト単位で指定します。

このオプションの指定値を大きくすると性能向上が見込めます。ただし，テキストインデクスを作成する全処理リアルスレッドで，このオプションで指定したバッファ分のメモリを使用します。このため，このオプションの指定値を大きくするときは注意してください。

●adb_unarcv_decompress_buff_size = アーカイブファイルの伸長用バッファサイズ

〜〈整数〉((32〜51,200))《1,024》（単位：キロバイト）

このオプションには，アーカイブファイルのデータの伸長時に使用するバッファサイズを，キロバイト単位で指定します。

アーカイブファイルのデータを伸長する際，このオプションに指定した分だけバッファを使用します。

アンアーカイブチャンクオプションadb_unarcv_read_sizeに指定した値を，このオプションの指定値の目安としてください。

47.3　使用例

adbunarchivechunkコマンドを使用してチャンクのアーカイブ状態を解除する方法を，例題形式で説明します。

実行中にadbunarchivechunkコマンドが異常終了した場合は，「47.5　adbunarchivechunkコマンドが異常終了したときの対処方法」を参照して対処してください。

47.3.1　特定の日付の範囲のデータを含むチャンクのアーカイブ状態を解除する場合

次に示す条件で，表に作成された特定の日付の範囲のデータを含むチャンクのアーカイブ状態を解除します。

実表TABLE01がアーカイブマルチチャンク表である

実表TABLE01のアーカイブレンジ列のデータ型がDATE型である

実表TABLE01に作成されたチャンクのうち，アーカイブレンジ列の値が，2010年01月01日〜2010年12月31日の範囲のデータを含むチャンクのアーカイブ状態を解除する

このとき，次に示す手順でadbunarchivechunkコマンドを実行します。

手順

アンアーカイブチャンクオプションファイルを作成する

adbunarchivechunkコマンドを実行する

各手順の例を以降で説明します。

(1)　アンアーカイブチャンクオプションファイルを作成する

アンアーカイブチャンクオプションファイルを作成して，アンアーカイブチャンクオプションを指定します。この例では，adbunarchivechunkコマンド実行時に使用する処理リアルスレッド数を指定しています。

アンアーカイブチャンクオプションファイルの指定例

set adb_unarcv_rthd_num = 2
      ：

(2)　adbunarchivechunkコマンドを実行する

adbunarchivechunk -u ADBUSER01                                  ...1
                  -p '#HelloHADB_01'                            ...2
                  -z /home/adbmanager/unarchive_file/env01.txt  ...3
                  -r 2010/01/01-2010/12/31                      ...4
                  TABLE01                                       ...5

［説明］

adbunarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

「(1)　アンアーカイブチャンクオプションファイルを作成する」で作成したアンアーカイブチャンクオプションファイルの絶対パス名を指定します。

アーカイブ状態を解除するチャンクの日付の範囲を指定します。

処理対象表を指定します。

47.3.2　チャンクのアンアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブ状態が解除されるチャンクを確認する場合

次に示す条件で，実際にチャンクのアンアーカイブ処理を実行する前に，指定した日付の範囲を基に，どのチャンクのアーカイブ状態が解除されるかを確認します。

実表TABLE01がアーカイブマルチチャンク表である

実表TABLE01のアーカイブレンジ列のデータ型がDATE型である

実表TABLE01に作成されたチャンクのうち，アーカイブレンジ列の値が，2010年01月01日〜2010年12月31日の範囲のデータを含む，アーカイブ状態が解除されるチャンクのチャンクIDを確認する

このとき，次に示す手順でadbunarchivechunkコマンドを実行します。

手順

adbunarchivechunkコマンドを実行する

指定した日付の範囲のデータを含むチャンクをKFAA80245-Iメッセージで確認する

各手順の例を以降で説明します。

(1)　adbunarchivechunkコマンドを実行する

adbunarchivechunk -u ADBUSER01              ...1
                  -p '#HelloHADB_01'        ...2
                  -r 2010/01/01-2010/12/31  ...3
                  -t                        ...4
                  TABLE01                   ...5

［説明］

adbunarchivechunkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

アーカイブ状態を解除するチャンクの日付の範囲を指定します。

チャンクのアンアーカイブ処理を実行する前に，実際にアーカイブ状態が解除されるチャンクのチャンクIDを確認するために指定します。

処理対象表を指定します。

(2)　指定した日付の範囲のデータを含むチャンクをKFAA80245-Iメッセージで確認する

-tオプションを指定したadbunarchivechunkコマンドを実行したあとに出力される，KFAA80245-Iメッセージを確認してください。

KFAA80245-Iメッセージには，アーカイブレンジ列の値が，日付の範囲指定で指定した範囲（2010年01月01日〜2010年12月31日）のデータを含む，アーカイブ状態が解除されるチャンクのチャンクIDが出力されます。

これらのチャンクに対して，チャンクのアンアーカイブ処理を行う場合は，-tオプション以外は同じ指定で（-tオプションを省略して）adbunarchivechunkコマンドを実行してください。アーカイブ状態を解除するチャンクを見直す場合は，日付の範囲の値（-rオプションの指定値）を修正したあとで，adbunarchivechunkコマンドを実行してください。

47.4　リターンコード

adbunarchivechunkコマンドのリターンコードを次の表に示します。

表47‒15　adbunarchivechunkコマンドのリターンコード

リターンコード

意味

0

adbunarchivechunkコマンドが正常に終了しました。

4

adbunarchivechunkコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbunarchivechunkコマンドの指定に誤りがあり，adbunarchivechunkコマンドが実行されませんでした。

adbunarchivechunkコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

47.5　adbunarchivechunkコマンドが異常終了したときの対処方法

adbunarchivechunkコマンドが異常終了したときの対処方法について説明します。

47.5.1　最初に確認すること

次に示すメッセージが出力されているかどうかを確認してください。

KFAA50225-E

KFAA96606-E

これらのメッセージが出力されている場合は，コマンドのオプションや，アンアーカイブチャンクオプションの指定に誤りがあります。コマンドのオプションまたはアンアーカイブチャンクオプションを修正したあとに，adbunarchivechunkコマンドを再実行してください。

上記のメッセージが出力されていない場合は，異常終了した原因を取り除いたあとでadbunarchivechunkコマンドを再実行してください。詳細については，「47.5.2　adbunarchivechunkコマンドの中断タイミングごとの対処方法」を参照してください。

なお，-cオプションの指定の誤りについては，「47.2.1　指定形式およびオプションの説明」の「(3)　-cオプションの指定が原因のエラー」を参照してください。

また，-rオプションの指定の誤りについては，指定した範囲指定の種類によって，次に示す個所をそれぞれ参照してください。

日付の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(a)　日付の範囲指定」の「表47‒5　日付の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

時刻の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(b)　時刻の範囲指定」の「表47‒7　時刻の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

時刻印の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(c)　時刻印の範囲指定」の「表47‒9　時刻印の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

固定長文字列の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(d)　固定長文字列の範囲指定」の「表47‒10　固定長文字列の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

10進数の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(e)　10進数の範囲指定」の「表47‒11　10進数の範囲指定に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

整数の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(f)　整数の範囲指定」の「表47‒12　整数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

浮動小数点数の範囲指定を指定した場合

「47.2.1　指定形式およびオプションの説明」の「(4)　-rオプション（範囲指定）の詳細」の「(g)　浮動小数点数の範囲指定」の「表47‒13　浮動小数点数の範囲指定の指定内容に誤りがある場合に出力されるメッセージIDと，考えられる誤り」を参照してください。

重要

adbunarchivechunkコマンドの再実行時，-cオプション，および-rオプションの指定の範囲は，基本的に変更しないでください。変更すると，チャンクのアンアーカイブ処理が行われるチャンクが変更になる場合があります。この場合，異常終了したadbunarchivechunkコマンドでアーカイブ状態が解除されなかったチャンクに対して，adbunarchivechunkコマンドを再実行しても，再実行時に解除処理が行われないおそれがあります。

47.5.2　adbunarchivechunkコマンドの中断タイミングごとの対処方法

adbunarchivechunkコマンドが異常終了したときの対処方法は，adbunarchivechunkコマンドの中断タイミングによって異なります。

中断タイミングごとの表とインデクスの状態，および対処方法を次の表に示します。

表47‒16　adbunarchivechunkコマンドの中断タイミングごとの表とインデクスの状態および対処方法

中断のタイミング※1

表とインデクスの状態

対処方法

表データ部の作成中

表の状態

adbunarchivechunkコマンド実行前の状態です。

インデクスの状態

B-treeインデクス，テキストインデクス，およびレンジインデクスは，adbunarchivechunkコマンド実行前の状態です。

「(1)　表データ部の作成中に中断した場合」を参照してください。

ソート処理中

表の状態

更新不可状態です。

インデクスの状態

レンジインデクスのインポートは完了しています。

B-treeインデクスおよびテキストインデクスは，adbunarchivechunkコマンド実行前の状態です。

「(2)　ソート処理中，またはインデクスの作成中に中断した場合」を参照してください。

B-treeインデクスとテキストインデクスの作成中（更新中は除く）※2

表の状態

更新不可状態です。

インデクスの状態

レンジインデクスのインポートは完了しています。

B-treeインデクスおよびテキストインデクスは，adbunarchivechunkコマンド実行前の状態です。

注

B-treeインデクスには，主キーに対応するB-treeインデクスも含まれます。

注※1

中断のタイミングは，次に示すように出力されたメッセージで確認できます。

注※2

KFAA80204-Iメッセージ（リターンコードが0または4）が出力されている場合は，表およびインデクスのインポート処理が完了しています。この場合，adbunarchivechunkコマンドの再実行は不要です。

KFAA80204-Iメッセージが出力されていない場合は，次のコマンドを実行して出力結果の2行目を確認してください（出力結果の1行目は列のタイトルです）。

adbdbstatus -c table -n adbunarchivechunkコマンドが中断した表名

adbunarchivechunkコマンドが中断した表名は，「スキーマ名.表識別子」の形式で指定します。

■Command_status列（17列目）の値がabort，かつRerun_command列（18列目）の値がadbunarchivechunkのとき

チャンクのアンアーカイブ処理が完了していません。adbunarchivechunkコマンドを再実行してください。

■Command_status列（17列目）およびRerun_command列（18列目）に値が出力されていないとき

チャンクのアンアーカイブ処理が完了しています。adbunarchivechunkコマンドの再実行は不要です。

重要

チャンクのアンアーカイブ処理が完了した場合でも，終了処理（作業用一時ファイルの削除）が完了していないことがあります。この場合，前回adbunarchivechunkコマンドで指定した表に対して，adbunarchivechunkコマンドを実行すると，完了していない終了処理だけが行われます（process = Terminateが表示されたKFAA80216-Iメッセージが出力されます）。

終了処理を完了させるためではなく，チャンクのアンアーカイブ処理を実行するためにadbunarchivechunkコマンドを実行したが，KFAA80216-Iメッセージが出力された場合は，終了処理が完了したあとで，改めてadbunarchivechunkコマンドを実行する必要があります。

なお，終了処理を完了させるためにadbunarchivechunkコマンドを実行した場合，-cオプションまたは-rオプションの指定を変更しても無効になります（前回実行したadbunarchivechunkコマンドの-cオプションまたは-rオプションで指定した範囲に該当するチャンクに対して，チャンクのアンアーカイブ処理が行われます）。

■マルチノード機能を使用している場合

adbunarchivechunkコマンドが中断して，処理対象表が更新不可状態となった場合，中断したadbunarchivechunkコマンドを再実行して，実表の更新不可状態を解除してください。

なお，中断したadbunarchivechunkコマンドを実行したノードを使用できる場合は，同じノードでadbunarchivechunkコマンドを再実行してください。

(1)　表データ部の作成中に中断した場合

KFAA80218-Iメッセージ（ソート処理の開始時に出力されるメッセージ）が出力されていない場合の対処手順を次に示します。

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

adbunarchivechunkコマンドを再実行してください。

(2)　ソート処理中，またはインデクスの作成中に中断した場合

KFAA80218-Iメッセージ（ソート処理の開始時に出力されるメッセージ）が出力されている場合の対処手順を次に示します。

手順

出力されているメッセージを確認して，障害原因を特定してください。

障害原因の対処を行ってください。

adbunarchivechunkコマンドを再実行してください。

47.6　注意事項

adbunarchivechunkコマンドは，HADBサーバが稼働中の場合にだけ実行できます。

adbunarchivechunkコマンドの実行を中断する場合は，adbcancelコマンドで中断してください。または，adbstop --forceコマンド，OSのkillコマンドなどでサーバプロセスを強制終了してください。実行中のコマンドをadbcancelコマンドで中断する方法については，「1.8　実行中のコマンドを中断（強制終了）する場合」を参照してください。

チャンクのアンアーカイブ処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbunarchivechunkコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のチャンクのアンアーカイブ処理は中断されません（処理が続行されます）。チャンクのアンアーカイブ処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

コマンドまたはAPの実行中にadbunarchivechunkコマンドを実行した場合，必要な処理リアルスレッド数が確保できないことがあります。この場合，必要な処理リアルスレッド数が確保できるまで，adbunarchivechunkコマンドの実行を待ちます。処理リアルスレッド数の確保待ち状態が発生した場合，マニュアルHADB　システム構築・運用ガイドのリソースの設計のコマンドを同時実行する際の考慮点のコマンドの実行時に使用する処理リアルスレッド数に関する考慮点を参照して対処してください。

チャンクのアンアーカイブ処理中に作業用のファイル（作業用一時ファイル）が一時的に作成されます。作業用一時ファイルは，adbunarchivechunkコマンドが正常に終了（リターンコードが0または4の場合）した場合は自動的に削除されます。しかし，adbunarchivechunkコマンドが正常に終了しなかった場合は削除されないことがあります。

作業用一時ファイルの中には，ほかのコマンドを再実行する際に必要となるファイルが含まれています。そのため，ほかのコマンドを再実行する前に作業用一時ファイルを削除しないでください。削除すると，ほかのコマンドが正しく実行されません。

作業用一時ファイルがディスク容量を圧迫するおそれがあるため，ほかのコマンドを再実行する必要がない場合は，作業用一時ファイルを定期的に削除することを推奨します。

この場合は，次に示すディレクトリ下に作業用一時ファイルが残っていないかを定期的に確認し，ファイルがあるときは削除してください。

$DBDIR/ADBSYS/ADBUTL

-wオプションに指定した作業用一時ファイルの格納先ディレクトリ（-wオプションを省略した場合は$DBDIR/ADBWORK）

adbunarchivechunkコマンドのオプションに指定する次のディレクトリおよびファイルの絶対パスが重複しないようにしてください。該当するディレクトリおよびファイルを次に示します。

作業用一時ファイルの格納先ディレクトリ（-wオプションで指定，または-wオプションに指定したディレクトリパスファイルに指定）

作業用一時ファイルの格納先を指定したディレクトリパスファイル（-wオプションで指定）

アンアーカイブチャンクオプションファイル（-zオプションで指定）

また，上記のディレクトリおよびファイルの絶対パスは，adbunarchivechunkコマンド以外のプログラムが使用しているディレクトリおよびファイルの絶対パスとも重複しないようにしてください。重複した場合，ファイル中のデータが失われるおそれがあります。シンボリックリンクの指定や，相対パスの指定にも注意してください。

-tオプションを指定したadbunarchivechunkコマンドを実行した場合，チャンクのアンアーカイブ処理は実行されません。-tオプションは，-rオプションまたは-cオプションで指定した範囲に該当するチャンクのうち，アーカイブ状態が解除されるチャンクを事前に確認するために指定します。

アーカイブ状態が解除されるチャンクを確認したあと，それらのチャンクに対して，チャンクのアンアーカイブ処理を実行する場合は，-tオプション以外は同じ指定で（-tオプションを省略して）adbunarchivechunkコマンドを実行してください。

adbunarchivechunkコマンドの実行時，次の表に示すディレクトリおよびファイルにアクセスします。adbunarchivechunkコマンドを実行する前に，各ディレクトリおよびファイルに次の表に示すパーミッションを設定してください。

表47‒17　ディレクトリおよびファイルに設定するパーミッション

ディレクトリおよびファイル

アクセスするOSユーザ※1

必要な権限

作業用一時ファイルの格納先ディレクトリ※2

HADBサーバプロセスの実行ユーザ

読み取り権限

書き込み権限

実行権限

作業用一時ファイルの格納先を指定したディレクトリパスファイル

HADBサーバプロセスの実行ユーザ

読み取り権限

アンアーカイブチャンクオプションファイル

コマンドの実行ユーザ

読み取り権限

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

「コマンドの実行ユーザ」については，「表1‒1　コマンドの一覧（コマンドの実行条件）」の「コマンドを実行できるOSユーザ」列を参照してください。

注※2

-wオプションに指定する場合と，作業用一時ファイルの格納先を指定したディレクトリパスファイル内に指定する場合のどちらも該当します。

48　adbupddmk（HADB暗号鍵の更新）

この章では，adbupddmkコマンドの機能と使い方について説明します。

48.1　機能

adbupddmkコマンドは，DBエリア暗号化機能で現在使用中のHADB暗号鍵を，新しいHADB暗号鍵に更新します。

HADB暗号鍵を更新する際の運用については，マニュアルHADB　システム構築・運用ガイドのHADB暗号鍵を更新する場合を参照してください。

adbupddmkコマンドは，コマンド実行時にHADBサーバに接続します。

48.2　adbupddmkコマンドの指定形式

adbupddmkコマンドの指定形式およびオプションについて説明します。

adbupddmkコマンドを実行できるOSユーザは，HADB管理者だけです。

48.2.1　指定形式およびオプションの説明

(1)　指定形式

adbupddmk
    -u 認可識別子
  〔-p パスワード〕
    現在のHADB暗号鍵ファイル名※
    新しいHADB暗号鍵ファイル名※

注※

現在のHADB暗号鍵ファイル名および新しいHADB暗号鍵ファイル名は，必ずオプションの最後に，上記の順で指定してください。

(2)　オプションの説明

●-u 認可識別子

〜〈文字列〉((1〜100バイト))

adbupddmkコマンドを実行するHADBユーザの認可識別子を指定します。adbupddmkコマンドを実行するには，次の2つの権限を持っている必要があります。

暗号管理権限

CONNECT権限

このオプションに指定する認可識別子は，1～100バイトの範囲で指定してください。ただし，認可識別子を囲む二重引用符は，1～100バイトには含みません。

重要

認可識別子の文字列中に英小文字または¥がある場合は，認可識別子の指定規則を必ず確認してください。認可識別子の指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

●-p パスワード

〜〈文字列〉((1〜255バイト))

-uオプションに指定した認可識別子のパスワードを指定します。

重要

パスワードの文字列中に，二重引用符（"）やストローク（|）など，OSやシェルが別の意味で使用している文字がある場合は，パスワードの指定規則を必ず確認してください。パスワードの指定規則については，「1.4.2　認可識別子およびパスワードの指定規則」を参照してください。

なお，このオプションを省略してadbupddmkコマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。

● 現在のHADB暗号鍵ファイル名

〜〈OSパス名〉((2〜510バイト))

現在使用中のHADB暗号鍵ファイルの絶対パス名（サーバ定義adb_crypto_dmkey_pathオペランドに指定されている絶対パス名）を指定します。

指定できるのは，adbmkdmkコマンドで作成されたHADB暗号鍵ファイル，またはadbinitコマンドで作成されたHADB暗号鍵ファイルです。

● 新しいHADB暗号鍵ファイル名

〜〈OSパス名〉((2〜510バイト))

新しく使用するHADB暗号鍵ファイルの絶対パス名を指定します。

指定できるのは，adbmkdmkコマンドで作成されたHADB暗号鍵ファイル，またはadbinitコマンドで作成されたHADB暗号鍵ファイルです。

48.3　使用例

DBエリア暗号化機能で使用するHADB暗号鍵を更新する方法を説明します。

adbchgsrvmodeコマンドを実行して，HADBサーバの稼働モードを通常モードからメンテナンスモードに変更する

実行例

adbchgsrvmode --maintenance

adbupddmkコマンドを実行する

実行例

adbupddmk -u CADMIN                    ...a
          -p '#HelloCADMIN_00'         ...b
          /HADB/.crypto/adb_dmkey      ...c
          /HADB/.crypto/adb_v2_dmkey   ...d

［説明］

adbupddmkコマンドを実行するHADBユーザの認可識別子を指定します。

-uオプションに指定した認可識別子のパスワードを指定します。

現在のHADB暗号鍵ファイルの絶対パス名を指定します。

新しいHADB暗号鍵ファイルの絶対パス名を指定します。

現在のHADB暗号鍵のHADB暗号鍵利用パスワードを入力する

HADB暗号鍵利用パスワードの入力を求めるKFAA90013-Qメッセージが出力されます。標準入力から現在のHADB暗号鍵のHADB暗号鍵利用パスワードを入力してください。

新しいHADB暗号鍵のHADB暗号鍵利用パスワードを入力する

HADB暗号鍵利用パスワードの入力を求めるKFAA90013-Qメッセージが出力されます。標準入力から新しいHADB暗号鍵のHADB暗号鍵利用パスワードを入力してください。

サーバ定義のadb_crypto_dmkey_pathオペランドに指定しているHADB暗号鍵ファイルの絶対パス名を，新しいHADB暗号鍵ファイルの絶対パス名に変更する

adbchgsrvmodeコマンドを実行して，HADBサーバの稼働モードをメンテナンスモードから通常モードに変更する

実行例

adbchgsrvmode --normal

48.4　リターンコード

adbupddmkコマンドのリターンコードを次の表に示します。

表48‒1　adbupddmkコマンドのリターンコード

リターンコード

意味

0

adbupddmkコマンドが正常に終了しました。

4

adbupddmkコマンドは正常に終了しましたが，警告メッセージが出力されました。表示された警告メッセージ，またはメッセージログファイルに出力された警告メッセージを確認して，その警告メッセージの対処に従ってください。

8

次のどちらかのエラーが発生しました。

adbupddmkコマンドの指定に誤りがあり，adbupddmkコマンドが実行されませんでした。

adbupddmkコマンドの実行中にエラーが発生しました。エラーの原因と対処方法については，表示されたエラーメッセージまたはメッセージログファイルに出力されたエラーメッセージを参照してください。

48.5　注意事項

adbupddmkコマンドを実行すると，現在のHADB暗号鍵のHADB暗号鍵利用パスワード，および新しいHADB暗号鍵のHADB暗号鍵利用パスワードの入力を求めるメッセージが出力されます。誤ったHADB暗号鍵利用パスワードを入力すると，adbupddmkコマンドはエラーとなります。

adbupddmkコマンドは，HADBサーバが稼働中，かつ稼働モードがメンテナンスモードの場合にだけ実行できます。メンテナンスモードについては，マニュアルHADB　システム構築・運用ガイドの定期運用のHADBサーバの開始・終了と稼働モードのHADBサーバの稼働モードを参照してください。

DBエリア暗号化機能を使用している状態のときに，adbupddmkコマンドを実行できます。DBエリア暗号化機能を使用している状態については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能を使用している状態かどうかを確認する場合を参照してください。

HADBサーバに接続中のAP，またはコマンドがある場合，adbupddmkコマンドは実行できません。

adbupddmkコマンドを実行中の場合，ほかのコマンドは実行できません。

HADB暗号鍵の更新に失敗した場合に備えて，adbupddmkコマンドを実行する前に，データベースのバックアップを取得してください。HADB暗号鍵の更新時のバックアップの取得については，マニュアルHADB　システム構築・運用ガイドのHADB暗号鍵を更新する場合を参照してください。

HADB暗号鍵の更新処理は，サーバプロセスで実行されます。このため，［Ctrl］＋［C］キーなどでadbupddmkコマンドのコマンドプロセスを強制終了しても，サーバプロセスで実行中のHADB暗号鍵の更新処理は中断されません（処理が続行されます）。HADB暗号鍵の更新処理が完了すると，メッセージログファイルにKFAA81001-Iメッセージが出力されます。

マルチノード機能を使用している場合，adbupddmkコマンドを実行できるのはプライマリノードだけです。このときプライマリノード以外のノードは停止している必要があります。マルチノード機能使用時のHADB暗号鍵の更新の運用については，マニュアルHADB　システム構築・運用ガイドのDBエリア暗号化機能の運用（マルチノード機能使用時）のHADB暗号鍵を更新する場合を参照してください。

現在のHADB暗号鍵ファイル名，または新しいHADB暗号鍵ファイル名に指定したHADB暗号鍵ファイルが存在しない場合，KFAA51424-Eメッセージが出力され，エラーとなります。

現在のHADB暗号鍵ファイル名には，現在使用中のHADB暗号鍵ファイル以外のファイルを指定することはできません。KFAA52113-Eメッセージが出力され，エラーとなります。

使用中のHADB暗号鍵ファイル名と新しいHADB暗号鍵ファイル名に，同じHADB暗号鍵ファイルを指定することはできません。KFAA52112-EメッセージまたはKFAA96871-Eメッセージが出力され，エラーとなります。

adbupddmkコマンドの実行時，次の表に示すファイルにアクセスします。adbupddmkコマンドを実行する前に，各ファイルに次の表に示すパーミッションを設定してください。

表48‒2　ファイルに設定するパーミッション

ファイル

アクセスするOSユーザ※1

必要な権限

現在のHADB暗号鍵ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限※2

新しいHADB暗号鍵ファイル

HADBサーバプロセスの実行ユーザ

読み取り権限※2

注※1

「HADBサーバプロセスの実行ユーザ」は，HADB管理者のOSユーザです。

注※2

HADB暗号鍵ファイルの権限は，400を設定してください。また，HADB暗号鍵ファイルの保存先ディレクトリの権限は，700を設定してください。

索引

記号

--compress GZIP[1]

--concurrency-prior〔adbmergechunkコマンド〕[1]

--create-temp-file[1]

--status wait[1]

？パラメタ

adbsqlで？パラメタを使用する場合の操作方法[1]

#CHUNKS[1]

#COLUMNS[1]

#COMMENT[1]

#CONNECT[1]

#DISCONNECT[1]

#EXIT[1]

#GETCOUNT[1]

#GETDATA[1]

#GETUSER[1]

#INDEXES[1]

#SET BINARY_DISP_MODE[1]

#SET DISPLAY[1]

#SET DUMPMODE[1]

#SET EXECTIME REPORT[1]

#SET NULL[1]

#SET OPT REPORT[1]

#SET TRAN_ISOLV[1]

#TABLES[1]

数字

16進形式での表示〔adbsqlサブコマンド〕[1]

1セグメントの容量〔adbaddareaオペランド〕[1]

1セグメントの容量〔adbinitdbareaオペランド〕[1]

1つの表のチャンクの状態を通常状態から待機状態に変更する[1]

2つ以上の表のチャンクの状態を一括して変更する[1]

A

adb_arcv_rthd_num[1]

adb_arcv_scan_buff_size[1]

ADB_AUDITREAD関数でオープンしたファイル数〔SQL文の統計情報〕[1]

ADB_AUDITREAD関数で読み込んだデータサイズの合計〔SQL文の統計情報〕[1]

adb_core_path[1]

ADB_CSVREAD関数でオープンしたファイル数〔SQL文の統計情報〕[1]

ADB_CSVREAD関数で読み込んだデータサイズの合計〔SQL文の統計情報〕[1]

adb_dbbuff_wrktbl_clt_blk_num[1]

ADB_DEFFILE_UNSUPPORTED_OPERAND_BEHAVIOR〔環境変数〕[1]

adb_export_order_mode[1]

adb_export_rthd_num[1]

adb_export_scan_buff_size[1]

adb_export_wrktbl_blk_num[1]

adb_getcst_rthd_num[1]

adb_idxrebuild_buff_blk_num[1]

adb_idxrebuild_dvbix_rthd_use[1]

adb_idxrebuild_dvix_rdbuff_size[1]

adb_idxrebuild_dvix_wtbuff_size[1]

adb_idxrebuild_rthd_num[1]

adb_idxrebuild_scan_buff_size[1]

adb_idxrebuild_sort_buff_size[1]

adb_idxrebuild_txt_buff_size[1]

adb_import_buff_blk_num[1]

adb_import_decompress_buff_size[1]

adb_import_dividx_rd_buff_size[1]

adb_import_dividx_wt_buff_size[1]

adb_import_dvbix_rthd_use[1]

adb_import_errdata_file_name[1]

adb_import_errdata_num[1]

adb_import_errmsg_lv[1]

adb_import_input_record_size[1]

adb_import_null_string[1]

adb_import_read_size[1]

adb_import_rthd_num[1]

adb_import_sort_buff_size[1]

adb_import_txt_buff_size[1]

adb_init_cld_aws_bucket[1]

adb_init_cld_aws_region[1]

adb_init_dbarea_initialize[1]

adb_init_dic_blk_path[1]

adb_init_dic_encrypt[1]

adb_init_dmkey_path[1]

adb_init_mst_blk_path[1]

adb_init_multi_max[1]

adb_init_stbl_blk_path[1]

adb_init_stbl_encrypt[1]

adb_init_wrk_blk_path[1]

adb_init_wrk_encrypt[1]

adb_init_wrk_page_size[1]

adb_mergechunk_buff_blk_num[1]

adb_mergechunk_dvbix_rthd_use[1]

adb_mergechunk_dvix_rdbuff_size[1]

adb_mergechunk_dvix_wtbuff_size[1]

adb_mergechunk_rthd_num[1]

adb_mergechunk_scan_buff_size[1]

adb_mergechunk_sort_buff_size[1]

adb_mergechunk_txt_buff_size[1]

adb_mod_area_file_rthd_num[1]

adb_sys_cld_az_container[1]

adb_sys_cld_az_storage_account[1]

adb_unarcv_buff_blk_num[1]

adb_unarcv_decompress_buff_size[1]

adb_unarcv_dividx_rd_buff_size[1]

adb_unarcv_dividx_wt_buff_size[1]

adb_unarcv_read_size[1]

adb_unarcv_rthd_num[1]

adb_unarcv_sort_buff_size[1]

adb_unarcv_txt_buff_size[1]

adbaddareaオペランド[1]

adbarchivechunkコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbarchivechunkコマンドが使用するスレッド[1]

adbaudittrailコマンド[1]

指定形式[1]

使用例[1]

adbcancelコマンド[1]

指定形式[1]

使用例[1]

adbchgchunkcommentコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbchgchunkstatusコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbchgnodetypeコマンド[1]

指定形式[1]

adbchgsqltrcコマンド[1]

指定形式[1]

使用例[1]

adbchgsrvmodeコマンド[1]

指定形式[1]

使用例[1]

adbclientdefmangコマンド[1]

指定形式[1]

使用例[1]

adbcolumninfoオペランド[1]

adbcolumnizeコマンド[1]

指定形式[1]

使用例[1]

adbconvertaudittrailfileコマンド[1]

指定形式[1]

使用例[1]

adbdbstatusコマンド[1]

指定形式[1]

出力規則[1]

使用例[1]

adbexpandareaオペランド[1]

adbexportコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbexportコマンドが使用するスレッド[1]

adbgetcstコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbgetcstコマンドが使用するスレッド[1]

adbidxrebuildコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbidxrebuildコマンドが使用するスレッド[1]

adbimportコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbimportコマンドが使用するスレッド[1]

adbinfogetコマンド[1]

指定形式[1]

使用例[1]

adbinfosweepコマンド[1]

指定形式[1]

adbinitdbareaオペランド[1]

adbinitコマンド[1]

指定形式[1]

使用例[1]

adbinstallコマンド[1]

指定形式[1]

adbls -d cfmコマンド[1]

指定形式[1]

使用例[1]

adbls -d cltgrpコマンド[1]

指定形式[1]

使用例[1]

adbls -d cnctコマンド[1]

指定形式[1]

使用例[1]

adbls -d gbufコマンド[1]

指定形式[1]

使用例[1]

adbls -d lbufコマンド[1]

指定形式[1]

使用例[1]

adbls -d lockコマンド[1]

指定形式[1]

使用例[1]

adbls -d memコマンド[1]

指定形式[1]

使用例[1]

adbls -d nodeコマンド[1]

指定形式[1]

使用例[1]

adbls -d prlコマンド[1]

指定形式[1]

使用例[1]

adbls -d shmコマンド[1]

指定形式[1]

使用例[1]

adbls -d srvコマンド[1]

指定形式[1]

使用例[1]

adbls -d thdコマンド[1]

指定形式[1]

使用例[1]

adbls -d verコマンド[1]

指定形式[1]

使用例[1]

adbmergechunkコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbmergechunkコマンドが使用するスレッド[1]

adbmkdmkコマンド[1]

指定形式[1]

使用例[1]

adbmodareaコマンド[1]

指定形式[1]

使用例[1]

adbmodbuffコマンド[1]

指定形式[1]

使用例[1]

adbmonitorコマンド[1]

指定形式[1]

adboptinstallコマンド[1]

指定形式[1]

adbreorgsystemdataコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbrmareaオペランド[1]

adbsqlコマンド[1]

指定形式[1]

使用例[1]

adbsqlコマンドの終了〔adbsqlサブコマンド〕[1]

adbsqlサブコマンド[1]

adbstartコマンド[1]

指定形式[1]

使用例[1]

adbstatコマンド[1]

指定形式[1]

出力規則[1]

使用例[1]

adbstopコマンド[1]

指定形式[1]

使用例[1]

adbsyndictコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbunarchivechunkコマンド[1]

異常終了したときの対処方法[1]

指定形式[1]

使用例[1]

adbunarchivechunkコマンドが使用するスレッド[1]

adbupddmkコマンド[1]

指定形式[1]

使用例[1]

AP識別子〔SQL文の統計情報〕[1]

AP識別子〔コネクションの統計情報〕[1]

AP識別子の表示[1]

B

B-treeインデクス作成用スレッド数の調整機能[1]

B-treeインデクスとテキストインデクス作成処理からの再実行機能[1]

B-treeインデクスのインデクスページスプリットが発生した回数〔SQL文の統計情報〕[1]

B-treeインデクスを使用した検索で，行データが有効かどうかを判定した回数〔SQL文の統計情報〕[1]

BOM[1]

C

CHUNKS〔adbsqlサブコマンド〕[1]

COLUMNS〔adbsqlサブコマンド〕[1]

COMMENT〔adbsqlサブコマンド〕[1]

compress GZIP[1]

CONNECT〔adbsqlサブコマンド〕[1]

create-temp-file[1]

CSV形式

GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合[1]

CSV形式〔出力データファイル〕[1]

CSV形式の仕様〔入力データファイル〕[1]

CSV形式の表データをインポートする場合[1]

CSV形式の表データをインポートする場合（列構成情報ファイルを指定する場合）[1]

D

DBエリア，表とインデクスの使用量情報[1]

出力行数の目安[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定のDBエリアの使用率と使用量をDBエリアファイル単位で調べる〔使用例〕[1]

DBエリアID〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリアID〔アーカイブ状態のチャンクの使用量情報〕[1]

DBエリアID〔インデクスのサマリ情報〕[1]

DBエリアID〔再編成要否の情報〕[1]

DBエリアID〔表のサマリ情報〕[1]

DBエリア情報の出力番号〔SQL文の統計情報〕[1]

DBエリア追加・変更オプション[1]

DBエリア追加・変更オプションのひな形[1]

DBエリア追加・変更オプションファイル名[1]

DBエリア内に格納されている表およびインデクスのチャンク数の最大値の合計〔DBエリアのサマリ情報〕[1]

DBエリア内に作成できるチャンク数の上限〔DBエリアのサマリ情報〕[1]

DBエリア内の総セグメント数〔DBエリアのサマリ情報〕[1]

DBエリアの暗号化状態〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリアの暗号化状態〔DBエリアのサマリ情報〕[1]

DBエリアの拡張[1]

DBエリアの削除[1]

DBエリアのサマリ情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

データベース全体の使用量を調べる〔使用例〕[1]

特定のDBエリアの使用量を調べる〔使用例〕[1]

DBエリアの自動増分の回数〔HADBサーバの統計情報〕[1]

DBエリアの自動増分の回数〔SQL文の統計情報〕[1]

DBエリアの自動増分の回数〔コネクションの稼働情報〕[1]

DBエリアの種類〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリアの使用中セグメント数〔DBエリアのサマリ情報〕[1]

DBエリアの初期設定

AWS環境でクラウドストレージ機能を使用する場合[1]

Azure環境でクラウドストレージ機能を使用する場合[1]

DBディレクトリを作成する場合〔マルチノード機能〕[1]

ブロックスペシャルファイルのDBエリアファイルを作成する場合[1]

DBエリアのセグメント使用率〔DBエリアのサマリ情報〕[1]

DBエリアの追加[1]

DBエリアの追加・変更[1]

DBエリアを拡張する場合（クラウドストレージ機能使用時）[1]

DBエリアを拡張する場合（ブロックスペシャルファイルのDBエリアファイルを追加する）[1]

DBエリアを拡張する場合（レギュラーファイルのDBエリアファイルを追加する）[1]

DBエリアを削除する場合（クラウドストレージ機能使用時）[1]

DBエリアを削除する場合（ブロックスペシャルファイルのDBエリアファイルを削除する）[1]

DBエリアを削除する場合（レギュラーファイルのDBエリアファイルを削除する）[1]

DBエリアを追加する場合（クラウドストレージ機能使用時）[1]

DBエリアを追加する場合（ブロックスペシャルファイルのDBエリアファイルを作成する）[1]

DBエリアを追加する場合（レギュラーファイルのDBエリアファイルを作成する）[1]

DBエリアファイル数〔DBエリアのサマリ情報〕[1]

DBエリアファイル内の初期化済みページ数〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリアファイル内の総セグメント数〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリアファイル名〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリア名〔DBエリア，表とインデクスの使用量情報〕[1]

DBエリア名〔DBエリアのサマリ情報〕[1]

DBエリア名〔SQL文の統計情報〕[1]

DBエリア名〔アーカイブ状態のチャンクの使用量情報〕[1]

DBエリア名〔インデクスのサマリ情報〕[1]

DBエリア名〔再編成要否の情報〕[1]

DBエリア名〔表のサマリ情報〕[1]

DBディレクトリ名[1]

DBディレクトリを作成する場合〔マルチノード機能〕[1]

DELETE文の実行回数〔コネクションの稼働情報〕[1]

DELETE文の実行時間〔コネクションの稼働情報〕[1]

detail版トラブルシュート情報ファイル[1]

DISCONNECT〔adbsqlサブコマンド〕[1]

E

EXIT〔adbsqlサブコマンド〕[1]

G

GETCOUNT〔adbsqlサブコマンド〕[1]

GETDATA〔adbsqlサブコマンド〕[1]

GETUSER〔adbsqlサブコマンド〕[1]

GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合[1]

H

HADB暗号鍵の更新[1]

HADB暗号鍵の作成[1]

HADBオプションのインストールおよびアンインストール[1]

HADBクライアント（Linux版）

インストール[1]

HADBクライアントのIPアドレスの表示[1]

HADBクライアントのプロセスIDの表示[1]

HADBサーバ

インストール[1]

HADBサーバからの切り離し〔adbsqlサブコマンド〕[1]

HADBサーバの開始[1]

HADBサーバの監視[1]

HADBサーバの終了[1]

HADBサーバの状態表示[1]

HADBサーバの状態表示〔各ノード〕[1]

HADBサーバの統計情報[1]

システム全体の稼働状況を調べる場合[1]

出力される項目の一覧[1]

HADBサーバのノード種別の変更[1]

HADBサーバのバージョン情報の表示[1]

HADBサーバへの接続〔adbsqlサブコマンド〕[1]

Hashflt_area_size[1]

Hashtbl_area_size[1]

I

INDEXES〔adbsqlサブコマンド〕[1]

INSERT文の実行回数〔コネクションの稼働情報〕[1]

INSERT文の実行時間〔コネクションの稼働情報〕[1]

L

light版トラブルシュート情報ファイル[1]

M

mail版トラブルシュート情報ファイル[1]

Max_sql_rthd_num[1]

O

OSユーザ〔コマンドを実行できるOSユーザ〕[1]

P

PURGE CHUNK文の実行回数〔コネクションの稼働情報〕[1]

PURGE CHUNK文の実行時間〔コネクションの稼働情報〕[1]

R

root版トラブルシュート情報ファイル[1]

ROW指定[1]

S

SELECT文の実行回数〔コネクションの稼働情報〕[1]

SELECT文の実行時間〔コネクションの稼働情報〕[1]

adb_init_cld_cache_path[1]

SET BINARY_DISP_MODE〔adbsqlサブコマンド〕[1]

SET DISPLAY〔adbsqlサブコマンド〕[1]

SET DUMPMODE〔adbsqlサブコマンド〕[1]

SET EXECTIME REPORT〔adbsqlサブコマンド〕[1]

SET NULL〔adbsqlサブコマンド〕[1]

SET OPT REPORT〔adbsqlサブコマンド〕[1]

SET TRAN_ISOLV〔adbsqlサブコマンド〕[1]

SQL記述ファイル[1]

SQL記述ファイルの指定例[1]

SQLトレース機能

SQLトレース情報の出力開始・停止[1]

SQLトレース情報の出力状況を確認したい場合[1]

SQLトレース情報の出力内容を変更したい場合[1]

SQLトレース情報の出力を開始したい場合[1]

SQLトレース情報の出力を停止したい場合[1]

SQLパラレル実行機能

ノード間通信の合計時間〔SQL文の統計情報〕[1]

ノード間通信の最大時間〔SQL文の統計情報〕[1]

ノード間通信の受信回数〔SQL文の統計情報〕[1]

ノード間通信の送信回数〔SQL文の統計情報〕[1]

SQLパラレル実行機能の情報表示[1]

SQL文種別〔SQL文の統計情報〕[1]

SQL文の経過時間の表示[1]

SQL文の実行時間〔SQL文の統計情報〕[1]

SQL文の実行時間の出力〔adbsqlサブコマンド〕[1]

SQL文の実行時にテーブルスキャンバッファで使用したメモリの合計〔SQL文の統計情報〕[1]

SQL文の実行時にテーブルスキャンバッファで容量不足が発生した際に要求したメモリの合計〔SQL文の統計情報〕[1]

SQL文の実行待ち状態の合計時間〔HADBサーバの統計情報〕[1]

SQL文の実行待ち状態の合計時間〔SQL文の統計情報〕[1]

SQL文の実行待ち状態の合計時間〔コネクションの稼働情報〕[1]

SQL文の実行待ち状態の発生回数〔HADBサーバの統計情報〕[1]

SQL文の実行待ち状態の発生回数〔コネクションの稼働情報〕[1]

SQL文の統計情報[1]

出力される項目の一覧[1]

特定の日時範囲でSQL文の統計情報を調べる場合[1]

status wait[1]

T

TABLES〔adbsqlサブコマンド〕[1]

TRUNCATE TABLE文の実行回数〔コネクションの稼働情報〕[1]

TRUNCATE TABLE文の実行時間〔コネクションの稼働情報〕[1]

U

UPDATE文の実行回数〔コネクションの稼働情報〕[1]

UPDATE文の実行時間〔コネクションの稼働情報〕[1]

Usageメッセージ[1]

V

VALUES指定[1]

あ

アーカイブ状態になる前のチャンクでインデクスを格納するために使用していたセグメントサイズ〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態になる前のチャンクで表を格納するために使用していたセグメントサイズ〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態のチャンク数〔表のサマリ情報〕[1]

アーカイブ状態のチャンクに格納されている行数〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態のチャンクに対応しているアーカイブファイル数の合計値〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態のチャンクに対応している全アーカイブファイルのファイルサイズの合計値〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態のチャンクの圧縮率〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブ状態のチャンクのサマリ情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，全アーカイブファイルのファイルサイズの合計値を調べる〔使用例〕[1]

アーカイブ状態のチャンクの使用量情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，各アーカイブファイルのファイルサイズを調べる〔使用例〕[1]

アーカイブチャンクオプション[1]

アーカイブファイルのファイルサイズ〔アーカイブ状態のチャンクの使用量情報〕[1]

アーカイブファイルのファイル名〔アーカイブ状態のチャンクの使用量情報〕[1]

アーカイブレンジ列の最小値（16進数）〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブレンジ列の最小値（16進数）〔アーカイブ状態のチャンクの使用量情報〕[1]

アーカイブレンジ列の最小値〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブレンジ列の最小値〔アーカイブ状態のチャンクの使用量情報〕[1]

アーカイブレンジ列の最大値（16進数）〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブレンジ列の最大値（16進数）〔アーカイブ状態のチャンクの使用量情報〕[1]

アーカイブレンジ列の最大値〔アーカイブ状態のチャンクのサマリ情報〕[1]

アーカイブレンジ列の最大値〔アーカイブ状態のチャンクの使用量情報〕[1]

アクセスパス情報の表示〔adbsqlサブコマンド〕[1]

圧縮

GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合[1]

出力データファイルの圧縮形式〔adbexportコマンド〕[1]

特定のチャンクIDのデータをGZIP形式で圧縮したファイルにエクスポートする場合[1]

入力データファイルの圧縮形式〔adbimportコマンド〕[1]

アンアーカイブチャンクオプション[1]

アンロード処理[1]

アンロードファイル[1]

アンロードファイルの格納先[1]

い

異常終了したときの対処方法

adbarchivechunkコマンド[1]

adbchgchunkcommentコマンド[1]

adbchgchunkstatusコマンド[1]

adbexportコマンド[1]

adbgetcstコマンド[1]

adbidxrebuildコマンド[1]

adbimportコマンド[1]

adbmergechunkコマンド[1]

adbreorgsystemdataコマンド[1]

adbsyndictコマンド[1]

adbunarchivechunkコマンド[1]

一意性制約違反状態〔インデクスのサマリ情報〕[1]

一意性制約違反状態の解除〔adbidxrebuildコマンド〕[1]

インストール[1]

インデクスID〔インデクスのサマリ情報〕[1]

インデクスが定義された表のスキーマ名〔インデクスのサマリ情報〕[1]

インデクスが定義された表の表ID〔インデクスのサマリ情報〕[1]

インデクスが定義された表の表識別子〔インデクスのサマリ情報〕[1]

インデクス再作成オプション[1]

インデクス再作成オプションファイル[1]

インデクス再作成処理[1]

インデクス再作成処理の経過メッセージ[1]

インデクス識別子〔インデクスのサマリ情報〕[1]

インデクス識別子ファイル[1]

インデクス情報[1]

インデクス情報の表示〔adbsqlサブコマンド〕

#INDEXES[1]

#SET OPT REPORT[1]

インデクスの再作成

指定したインデクスを再作成する場合[1]

未完状態のインデクスを再作成する場合[1]

インデクスのサマリ情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定のインデクスの状態を調べる〔使用例〕[1]

特定のインデクスの使用量を調べる〔使用例〕[1]

インデクスの種類〔インデクスのサマリ情報〕[1]

インデクスの使用中セグメント数〔インデクスのサマリ情報〕[1]

インデクスの使用中ページ数〔インデクスのサマリ情報〕[1]

インデクスの未完状態の解除[1]

インポート[1]

CSV形式の表データをインポートする場合[1]

CSV形式の表データをインポートする場合（列構成情報ファイルを指定する場合）[1]

GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合[1]

固定長形式の表データをインポートする場合[1]

入力データファイルの圧縮形式〔adbimportコマンド〕[1]

入力データファイルの形式（CSV形式の仕様）[1]

入力データファイルの形式（固定長形式の仕様）[1]

インポートオプション[1]

インポートオプションファイル[1]

え

エクスポート[1]

SQL文の検索結果をエクスポートする場合[1]

出力データファイルの圧縮形式〔adbexportコマンド〕[1]

特定のチャンクIDのデータをGZIP形式で圧縮したファイルにエクスポートする場合[1]

特定のチャンクIDのデータをエクスポートする場合[1]

表内のすべてのデータをエクスポートする場合[1]

列名を出力したい場合[1]

エクスポートオプション[1]

エクスポートオプションファイル[1]

お

オプション[1]

オプション引数[1]

オフラインモード

オフラインモードで開始する場合〔adbstartコマンド〕[1]

オフラインモードに変更する場合〔adbchgsrvmodeコマンド〕[1]

か

確保された領域サイズ〔HADBサーバの統計情報〕[1]

各リアルスレッドがテーブルスキャンバッファで使用したメモリの最小値〔SQL文の統計情報〕[1]

各リアルスレッドがテーブルスキャンバッファで使用したメモリの最大値〔SQL文の統計情報〕[1]

囲み文字〔adbdbstatusコマンド（再編成要否の情報）〕[1]

囲み文字〔adbdbstatusコマンド（サマリ情報・使用量情報）〕[1]

囲み文字〔adbexportコマンド〕[1]

囲み文字〔adbimportコマンド〕[1]

囲み文字〔adbstatコマンド〕[1]

稼働モードの変更[1]

カラムストア形式の行数〔再編成要否の情報〕

adbimportコマンドでカラムデータ用セグメントにインポートした行数[1]

更新行のカラム化機能でカラムストア形式に変換した行数[1]

カラムストア表の再編成要否〔再編成要否の情報〕[1]

カラムストア表の再編成要否の情報[1]

特定のカラムストア表の再編成要否を調べる〔使用例〕[1]

空文字列[1]

カレントチャンクのチャンクID〔表のサマリ情報〕[1]

環境変数の設定[1]

監査証跡[1]

監査証跡機能[1]

監査証跡機能に関連する情報を表示する場合[1]

監査証跡機能を有効にする場合[1]

監査証跡機能の管理[1]

監査証跡機能の関連情報の表示〔adbaudittrailコマンド〕[1]

監査証跡機能の無効化〔adbaudittrailコマンド〕[1]

監査証跡機能の有効化〔adbaudittrailコマンド〕[1]

監査証跡ファイルの切り替え〔adbaudittrailコマンド〕[1]

監査証跡ファイルの切り替え回数〔HADBサーバの統計情報〕[1]

監査証跡ファイルの変換[1]

監査証跡ファイルへ書き込んだデータサイズ〔HADBサーバの統計情報〕[1]

監査証跡ファイルへの書き込み回数〔HADBサーバの統計情報〕[1]

監視〔HADBサーバ〕[1]

き

擬似スレッド数の表示[1]

キャッシュファイルの情報表示[1]

キャンセル方法〔コマンド〕[1]

強制終了〔コマンド〕[1]

強制終了〔トランザクション〕[1]

強制終了方法〔コマンド〕[1]

共有メモリの情報表示[1]

く

区切り文字〔adbdbstatusコマンド（再編成要否の情報）〕[1]

区切り文字〔adbdbstatusコマンド（サマリ情報・使用量情報）〕[1]

区切り文字〔adbexportコマンド〕[1]

区切り文字〔adbimportコマンド〕[1]

区切り文字〔adbstatコマンド〕[1]

クライアント管理定義[1]

クライアントグループの情報表示[1]

クライアントグループ名の表示[1]

クライアント定義の集中管理[1]

クライアント定義の集中管理機能[1]

クライアント定義の集中管理機能の内容を適用する場合[1]

特定のHADBクライアントに適用されているクライアント定義ファイル名を確認する場合[1]

クライアントの種類の表示[1]

クラウドストレージ機能

BLOB（セグメント）の格納回数〔SQL文の統計情報〕[1]

BLOB（セグメント）の格納サイズ〔SQL文の統計情報〕[1]

BLOB（セグメント）の取得回数〔SQL文の統計情報〕[1]

BLOB（セグメント）の取得サイズ〔SQL文の統計情報〕[1]

BLOB（セグメント）の取得時間〔SQL文の統計情報〕[1]

BLOB（ディレクトリページ）の格納回数〔SQL文の統計情報〕[1]

BLOB（ディレクトリページ）の格納サイズ〔SQL文の統計情報〕[1]

BLOB（ディレクトリページ）の取得回数〔SQL文の統計情報〕[1]

BLOB（ディレクトリページ）の取得サイズ〔SQL文の統計情報〕[1]

BLOB（ディレクトリページ）の取得時間〔SQL文の統計情報〕[1]

DBエリアを拡張する[1]

DBエリアを削除する[1]

DBエリアを追加する[1]

S3オブジェクト（セグメント）の格納回数〔SQL文の統計情報〕[1]

S3オブジェクト（セグメント）の格納サイズ〔SQL文の統計情報〕[1]

S3オブジェクト（セグメント）の取得回数〔SQL文の統計情報〕[1]

S3オブジェクト（セグメント）の取得サイズ〔SQL文の統計情報〕[1]

S3オブジェクト（セグメント）の取得時間〔SQL文の統計情報〕[1]

S3オブジェクト（ディレクトリページ）の格納回数〔SQL文の統計情報〕[1]

S3オブジェクト（ディレクトリページ）の格納サイズ〔SQL文の統計情報〕[1]

S3オブジェクト（ディレクトリページ）の取得回数〔SQL文の統計情報〕[1]

S3オブジェクト（ディレクトリページ）の取得サイズ〔SQL文の統計情報〕[1]

S3オブジェクト（ディレクトリページ）の取得時間〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル書き込み回数〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル書き込みサイズ〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル書き込みヒット回数〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル読み込み回数〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル読み込みサイズ〔SQL文の統計情報〕[1]

キャッシュファイル（セグメント）のファイル読み込みヒット回数〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル書き込み回数〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル書き込みサイズ〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル書き込みヒット回数〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル読み込み回数〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル読み込みサイズ〔SQL文の統計情報〕[1]

キャッシュファイル（ディレクトリページ）のファイル読み込みヒット回数〔SQL文の統計情報〕[1]

キャッシュファイルのファイルオープン回数〔SQL文の統計情報〕[1]

キャッシュファイルのファイル削除回数〔SQL文の統計情報〕[1]

キャッシュファイルのファイル作成回数〔SQL文の統計情報〕[1]

グローバルバッファからのファイル書き込み回数〔SQL文の統計情報〕[1]

グローバルバッファからのファイル書き込み回数〔グローバルバッファの統計情報〕[1]

グローバルバッファからのファイル書き込み要求回数〔グローバルバッファの統計情報〕[1]

グローバルバッファ情報の出力番号〔SQL文の統計情報〕[1]

グローバルバッファの情報表示[1]

グローバルバッファの統計情報[1]

出力される項目の一覧[1]

特定のグローバルバッファの稼働状況を調べる場合[1]

グローバルバッファのページアウト回数〔グローバルバッファの統計情報〕[1]

グローバルバッファのページイン回数〔グローバルバッファの統計情報〕[1]

グローバルバッファのページヒット回数〔SQL文の統計情報〕[1]

グローバルバッファのページヒット回数〔グローバルバッファの統計情報〕[1]

グローバルバッファのページヒット率〔SQL文の統計情報〕[1]

グローバルバッファのページヒット率〔グローバルバッファの統計情報〕[1]

グローバルバッファのページ要求回数〔SQL文の統計情報〕[1]

グローバルバッファのページ要求回数〔グローバルバッファの統計情報〕[1]

グローバルバッファのレンジインデクスページからのファイル書き込み回数〔SQL文の統計情報〕[1]

グローバルバッファのレンジインデクスページのヒット回数〔SQL文の統計情報〕[1]

グローバルバッファのレンジインデクスページのヒット率〔SQL文の統計情報〕[1]

グローバルバッファのレンジインデクスページの要求回数〔SQL文の統計情報〕[1]

グローバルバッファのレンジインデクスページへの書き込み回数〔SQL文の統計情報〕[1]

グローバルバッファのレンジインデクスページへのファイル読み込み回数〔SQL文の統計情報〕[1]

グローバルバッファへの書き込み回数〔SQL文の統計情報〕[1]

グローバルバッファへのファイル読み込み回数〔SQL文の統計情報〕[1]

グローバルバッファへのファイル読み込み回数〔グローバルバッファの統計情報〕[1]

グローバルバッファへのファイル読み込み要求回数〔グローバルバッファの統計情報〕[1]

グローバルバッファ名〔SQL文の統計情報〕[1]

グローバルバッファ名〔グローバルバッファの統計情報〕[1]

グローバルバッファ面数

総グローバルバッファ面数〔グローバルバッファの統計情報〕[1]

割り当て済みのグローバルバッファ面数[1]

け

検索行数〔SQL文の統計情報〕[1]

検索行数〔コネクションの稼働情報〕[1]

検索結果の出力〔adbsqlサブコマンド〕[1]

こ

更新行数〔SQL文の統計情報〕[1]

更新行数〔コネクションの稼働情報〕[1]

更新行のカラム化機能[1]

更新行のカラム化機能の状態を表示する場合[1]

更新行のカラム化機能を有効にする場合[1]

更新行のカラム化機能の管理[1]

更新行のカラム化機能の状態の表示〔adbcolumnizeコマンド〕[1]

更新行のカラム化機能の無効化〔adbcolumnizeコマンド〕[1]

更新行のカラム化機能の有効化〔adbcolumnizeコマンド〕[1]

更新不可状態〔表のサマリ情報〕[1]

コスト情報[1]

削除[1]

収集[1]

すべての表のコスト情報を削除する場合[1]

すべての表のコスト情報を収集する場合[1]

特定の表のコスト情報を削除する場合[1]

特定の表のコスト情報を収集する場合[1]

コスト情報収集オプション[1]

コスト情報収集オプションファイル[1]

コスト情報収集処理[1]

コスト情報収集処理の経過メッセージ[1]

固定長形式の仕様〔入力データファイル〕[1]

固定長形式の表データをインポートする場合[1]

コネクションIDの表示[1]

コネクションが確立してからのSQL文通番〔SQL文の統計情報〕[1]

コネクション確立日時〔SQL文の統計情報〕[1]

コネクション確立日時〔コネクションの稼働情報〕[1]

コネクション情報〔SQL文の統計情報〕[1]

コネクション情報の表示[1]

コネクション通番〔コネクションの稼働情報〕[1]

コネクション通番の表示[1]

コネクションの稼働情報[1]

出力される項目の一覧[1]

特定のAPの稼働状況を調べる場合[1]

コネクションの状態表示[1], [2]

コマンドグループの情報表示[1]

コマンド実行時のディレクトリおよびファイルへのアクセスに関する注意事項[1]

コマンド実行時のメッセージに関する注意事項[1]

コマンドステータスファイル〔adbidxrebuildコマンド〕[1]

コマンドステータスファイル〔adbimportコマンド〕[1]

コマンドのUsageメッセージの表示方法[1]

コマンドの一覧[1]

コマンドの強制終了[1]

コマンドの共通規則[1]

コマンドの経過時間の表示[1]

コマンドの指定形式[1]

コマンドの終了状態（コマンドの再実行の要否）〔表のサマリ情報〕[1]

コマンドの中断方法[1]

コマンド引数[1]

コマンドヘルプの表示方法[1]

コミット回数〔HADBサーバの統計情報〕[1]

コミット回数〔コネクションの稼働情報〕[1]

さ

再実行機能〔adbidxrebuildコマンド〕[1]

再実行するコマンド名〔表のサマリ情報〕[1]

最大SQL処理リアルスレッド数〔SQL文の統計情報〕[1]

最大使用量

各リアルスレッド固有メモリの最大使用量の合計値〔HADBサーバの統計情報〕[1]

全メモリの最大使用量〔HADBサーバの統計情報〕[1]

ハッシュグループ化領域の最大使用量〔コネクションの稼働情報〕[1]

ハッシュテーブル領域の最大使用量〔コネクションの稼働情報〕[1]

プロセス共通メモリの最大使用量〔HADBサーバの統計情報〕[1]

ユーザログファイルの最大使用量〔HADBサーバの統計情報〕[1]

ユーザログファイルの最大使用量〔SQL文の統計情報〕[1]

ユーザログファイルの最大使用量〔コネクションの稼働情報〕[1]

最大割り当て作業表ページ数〔HADBサーバの統計情報〕[1]

再編成

システム表[1]

システム表を再編成する場合[1]

再編成処理の経過メッセージ[1]

再編成前データの削除機能〔システム表の再編成〕[1]

再編成要否の情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定のカラムストア表の再編成要否を調べる〔使用例〕[1]

作業表情報[1]

作業表情報の表示〔adbsqlサブコマンド〕[1]

作業用一時ファイル〔adbidxrebuildコマンド〕[1]

作業用一時ファイル〔adbimportコマンド〕[1]

作業用一時ファイル〔adbreorgsystemdataコマンド〕[1]

作業用一時ファイルの格納先〔adbidxrebuildコマンド〕[1]

作業用一時ファイルの格納先〔adbimportコマンド〕[1]

作業用一時ファイルの格納先〔adbmergechunkコマンド〕[1]

作業用一時ファイルの格納先〔adbreorgsystemdataコマンド〕[1]

作業用一時ファイルの格納先〔adbunarchivechunkコマンド〕[1]

削除仕掛中のチャンク数〔表のサマリ情報〕[1]

作成されたチャンク数〔表のサマリ情報〕[1]

作成できるチャンク数〔表のサマリ情報〕[1]

作成ファイル数〔adbaddareaオペランド〕[1]

作成ファイル数〔adbexpandareaオペランド〕[1]

作成ファイル数〔adbinitdbareaオペランド〕[1]

作成モード[1]

サマリ情報[1]

DBエリアのサマリ情報[1]

アーカイブ状態のチャンクのサマリ情報[1]

インデクスのサマリ情報[1]

データベース全体の使用量を調べる〔使用例〕[1]

特定のDBエリアの使用量を調べる〔使用例〕[1]

特定のインデクスの状態を調べる〔使用例〕[1]

特定のインデクスの使用量を調べる〔使用例〕[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，全アーカイブファイルのファイルサイズの合計値を調べる〔使用例〕[1]

特定の表の状態を調べる〔使用例〕[1]

特定の表の使用量を調べる〔使用例〕[1]

表のサマリ情報[1]

し

システム表の再編成[1]

システム表の再編成処理[1]

システム表を再編成する場合[1]

実行できるOSユーザ〔コマンドを実行できるOSユーザ〕[1]

実行できるマシン〔コマンドを実行できるマシン〕[1]

自動増分の回数〔HADBサーバの統計情報〕[1]

自動増分の回数〔コネクションの稼働情報〕[1]

集中管理〔クライアント定義〕[1]

終了待機状態[1]

出力規則

adbdbstatusコマンド[1]

adbstatコマンド[1]

出力データパスファイル[1]

出力データパスファイルの指定例

--compress GZIPオプションを指定していない場合[1]

--compress GZIPオプションを指定している場合[1]

出力データファイル[1]

出力データファイルの圧縮形式[1]

出力データファイルの形式〔adbexportコマンド〕[1]

使用中セグメント数〔DBエリア，表とインデクスの使用量情報〕[1]

使用中セグメント数〔DBエリアのサマリ情報〕[1]

使用中セグメント数〔インデクスのサマリ情報〕[1]

使用中セグメント数〔表のサマリ情報〕[1]

使用中ページ数〔DBエリア，表とインデクスの使用量情報〕[1]

使用中ページ数〔インデクスのサマリ情報〕[1]

使用中ページ数〔表のサマリ情報〕[1]

使用率〔DBエリアのサマリ情報〕[1]

使用量情報[1]

DBエリア，表とインデクスの使用量情報[1]

アーカイブ状態のチャンクの使用量情報[1]

特定のDBエリアの使用率と使用量をDBエリアファイル単位で調べる〔使用例〕[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，各アーカイブファイルのファイルサイズを調べる〔使用例〕[1]

初期確保サイズ〔adbaddareaオペランド〕[1]

初期確保サイズ〔adbexpandareaオペランド〕[1]

初期確保サイズ〔adbinitdbareaオペランド〕[1]

初期設定オプション[1]

初期設定オプションのひな形[1]

初期設定オプションファイル[1]

す

スキーマオブジェクトID〔DBエリア，表とインデクスの使用量情報〕[1]

スキーマオブジェクト識別子〔DBエリア，表とインデクスの使用量情報〕[1]

スキーマオブジェクトの種類〔DBエリア，表とインデクスの使用量情報〕[1]

スキーマオブジェクトの種類〔アーカイブ状態のチャンクの使用量情報〕[1]

スキーマ名〔DBエリア，表とインデクスの使用量情報〕[1]

スキーマ名〔インデクスのサマリ情報〕[1]

スキーマ名〔再編成要否の情報〕[1]

スキーマ名〔表のサマリ情報〕[1]

スレッドの状態表示[1]

せ

静止モード

静止モードで開始する場合〔adbstartコマンド〕[1]

静止モードに変更する場合〔adbchgsrvmodeコマンド〕[1]

セグメント解放時に使用した処理リアルスレッドの最大数〔SQL文の統計情報〕[1]

セグメントサイズ〔DBエリア，表とインデクスの使用量情報〕[1]

セグメントサイズ〔DBエリアのサマリ情報〕[1]

セグメントサイズ〔インデクスのサマリ情報〕[1]

セグメントサイズ〔表のサマリ情報〕[1]

セグメント使用率〔DBエリアのサマリ情報〕[1]

セグメントの種類〔DBエリア，表とインデクスの使用量情報〕[1]

先頭DBエリアファイルのファイルパス〔DBエリアのサマリ情報〕[1]

全メモリの最大使用量〔HADBサーバの統計情報〕[1]

そ

総グローバルバッファ面数〔グローバルバッファの統計情報〕[1]

総セグメント数

DBエリアファイル内の総セグメント数〔DBエリア，表とインデクスの使用量情報〕[1]

総セグメント数〔DBエリアのサマリ情報〕[1]

総レンジインデクスバッファ面数〔グローバルバッファの統計情報〕[1]

ソートコード順（ISO/IEC14651:2011準拠）〔エクスポート結果〕[1]

た

待機状態に変更する〔チャンク〕[1]

待機状態のチャンク数〔表のサマリ情報〕[1]

ダイレクトI/O[1]

ち

チャンク

データを追加するチャンク〔adbimportコマンド〕[1]

チャンクID

表のカレントチャンクのチャンクID〔表のサマリ情報〕[1]

チャンクID〔DBエリア，表とインデクスの使用量情報〕[1]

チャンクID〔アーカイブ状態のチャンクのサマリ情報〕[1]

チャンクID〔アーカイブ状態のチャンクの使用量情報〕[1]

チャンクID〔再編成要否の情報〕[1]

チャンクID指定〔adbarchivechunkコマンド〕[1]

チャンクID指定〔adbunarchivechunkコマンド〕[1]

チャンク切り替え時のタイムスタンプ〔DBエリア，表とインデクスの使用量情報〕[1]

チャンク作成時のタイムスタンプ〔DBエリア，表とインデクスの使用量情報〕[1]

チャンク情報の表示〔adbsqlサブコマンド〕[1]

チャンク数

表に作成されたチャンク数〔表のサマリ情報〕[1]

表に作成できるチャンク数〔表のサマリ情報〕[1]

チャンク内のデータ格納形式〔DBエリア，表とインデクスの使用量情報〕[1]

チャンクに格納されているデータの件数の取得〔adbsqlサブコマンド〕[1]

チャンクに格納されているデータの取得〔adbsqlサブコマンド〕[1]

チャンクに設定されたコメント〔アーカイブ状態のチャンクのサマリ情報〕[1]

チャンクに設定したコメントを削除する場合[1]

チャンクに設定したコメントを変更する場合[1]

チャンクのアーカイブ[1]

チャンクのアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブされるチャンクを確認する場合[1]

特定の日付の範囲のデータを含むチャンクをアーカイブする場合[1]

チャンクのアーカイブ状態〔アーカイブ状態のチャンクのサマリ情報〕[1]

チャンクのアーカイブ処理[1]

チャンクのアーカイブ処理の経過メッセージ[1]

チャンクのアンアーカイブ[1]

チャンクのアンアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブ状態が解除されるチャンクを確認する場合[1]

特定の日付の範囲のデータを含むチャンクのアーカイブ状態を解除する場合[1]

チャンクのアンアーカイブ処理[1]

チャンクのアンアーカイブ処理の経過メッセージ[1]

チャンクのコメントの設定・変更・削除[1]

チャンクの状態〔DBエリア，表とインデクスの使用量情報〕[1]

チャンクの状態〔アーカイブ状態のチャンクのサマリ情報〕[1]

チャンクの状態〔アーカイブ状態のチャンクの使用量情報〕[1]

チャンクの状態の一括変更設定ファイルの指定規則〔adbchgchunkstatusコマンド〕[1]

チャンクの状態変更[1]

チャンクのマージ[1]

任意のチャンク（カレントチャンクを含まない）をマージする場合[1]

任意のチャンク（カレントチャンクを含む）をマージする場合[1]

表にあるすべてのチャンクをマージする場合[1]

注釈〔adbsqlコマンド〕[1]

注釈行の指定〔adbsqlサブコマンド〕[1]

中断方法〔コマンド〕[1]

つ

追加モード[1]

通常状態に変更する〔チャンク〕[1]

通常モード

通常モードで開始する場合〔adbstartコマンド〕[1]

通常モードに変更する場合〔adbchgsrvmodeコマンド〕[1]

て

ディクショナリ表からの表定義情報の取得回数〔HADBサーバの統計情報〕[1]

ディクショナリ表からの表定義情報の取得回数〔SQL文の統計情報〕[1]

ディレクトリおよびファイルへのアクセスに関する注意事項[1]

ディレクトリ情報を送信した回数〔コネクションの稼働情報〕[1]

ディレクトリパスファイル[1]

データインポート処理[1]

データインポート処理の経過メッセージ[1]

データエクスポート処理[1]

データエクスポート処理の経過メッセージ[1]

データベースの状態解析[1]

データベース全体の使用量を調べる（DBエリアのサマリ情報の出力）[1]

特定のDBエリアの使用率と使用量をDBエリアファイル単位で調べる（DBエリア，表とインデクスの使用量情報の出力）[1]

特定のDBエリアの使用量を調べる（DBエリアのサマリ情報の出力）[1]

特定のインデクスの状態を調べる（インデクスのサマリ情報の出力）[1]

特定のインデクスの使用量を調べる（インデクスのサマリ情報の出力）[1]

特定のカラムストア表の再編成要否を調べる（カラムストア表の再編成要否の情報の出力）[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，各アーカイブファイルのファイルサイズを調べる（アーカイブ状態のチャンクの使用量情報の出力）[1]

特定の表に作成されたアーカイブ状態のチャンクに対応している，全アーカイブファイルのファイルサイズの合計値を調べる（アーカイブ状態のチャンクのサマリ情報の出力）[1]

特定の表の状態を調べる（表のサマリ情報の出力）[1]

特定の表の使用量を調べる（表のサマリ情報の出力）[1]

データベースの初期設定[1]

データ用DBエリアの1セグメントの容量〔adbaddareaオペランド〕[1]

データ用DBエリアの1セグメントの容量〔adbinitdbareaオペランド〕[1]

データ用DBエリアの暗号化〔adbaddareaオペランド〕[1]

データ用DBエリアの暗号化〔adbinitdbareaオペランド〕[1]

テーブルスキャンバッファで再利用したバッファ面数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファでバッファ不足が発生した回数〔SQL文の統計情報〕[1]

テーブルスキャンバッファでバッファ不足が発生した回数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファの不足バッファ面数〔SQL文の統計情報〕[1]

テーブルスキャンバッファのページイン回数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファのページヒット回数〔SQL文の統計情報〕[1]

テーブルスキャンバッファのページヒット回数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファのページヒット率〔SQL文の統計情報〕[1]

テーブルスキャンバッファのページヒット率〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファのページ要求回数〔SQL文の統計情報〕[1]

テーブルスキャンバッファのページ要求回数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファのリセット回数〔SQL文の統計情報〕[1]

テーブルスキャンバッファへのファイル読み込み回数〔SQL文の統計情報〕[1]

テーブルスキャンバッファへのファイル読み込み回数〔グローバルバッファの統計情報〕[1]

テーブルスキャンバッファへのファイル読み込みサイズ〔SQL文の統計情報〕[1]

テーブルスキャンバッファへのファイル読み込みサイズ〔グローバルバッファの統計情報〕[1]

テキストインデクスのインデクスページスプリットが発生した回数〔SQL文の統計情報〕[1]

と

統一フォーマット用監査証跡の出力先ディレクトリ[1]

統一フォーマット用監査証跡ファイル[1]

統一フォーマット用監査証跡ファイルの切り替え[1]

同義語一覧定義ファイルの再作成[1]

同義語検索

不要なファイルを削除する場合[1]

同義語辞書の管理[1]

同義語辞書の更新[1]

同義語辞書の削除[1]

同義語辞書の登録[1]

同義語辞書ファイルの格納ディレクトリ

不要なファイルの削除[1]

同義語辞書ファイルの同期[1]

同義語辞書ファイルの同期を取る場合[1]

同義語辞書ファイルへのアクセス時間の合計〔SQL文の統計情報〕[1]

同義語辞書を更新する場合[1]

同義語辞書を削除する場合[1]

同義語辞書を登録する場合[1]

同義語の一覧の出力[1]

同義語の一覧を出力する場合[1]

統計解析

システム全体の稼働状況を調べる場合[1]

特定のAPの稼働状況を調べる場合[1]

特定のグローバルバッファの稼働状況を調べる場合[1]

特定の日時範囲でSQL文の統計情報を調べる場合[1]

統計解析〔HADBサーバ〕[1]

トラブルシュート情報

HADBサーバ稼働中にトラブルシュート情報を出力する場合[1]

削除[1]

取得[1]

トラブルシュート情報〔再編成要否の情報〕[1]

トラブルシュート情報ファイル

detail版トラブルシュート情報ファイル[1]

light版トラブルシュート情報ファイル[1]

mail版トラブルシュート情報ファイル[1]

root版トラブルシュート情報ファイル[1]

出力容量を算出する場合[1]

トランザクションアクセスモードの表示[1]

トランザクション開始回数〔HADBサーバの統計情報〕[1]

トランザクション開始回数〔コネクションの稼働情報〕[1]

トランザクション隔離性水準の指定〔adbsqlサブコマンド〕[1]

トランザクションの隔離性水準の表示[1]

トランザクションの強制終了[1]

な

ナル値の表示形式の指定〔adbsqlサブコマンド〕[1]

ナル値表示文字列[1]

に

入力データが空文字列の場合に格納される値〔adbimportコマンド〕[1]

入力データの記述規則（CSV形式）[1]

入力データの記述規則（固定長形式）[1]

入力データの指定規則〔adbsqlコマンド〕[1]

入力データの論理エラーが発生したときの対処方法[1]

入力データパスファイル[1]

入力データパスファイルの指定例[1]

入力データファイル[1]

入力データファイルの圧縮形式[1]

入力データファイルの形式

CSV形式の仕様[1]

入力データファイルの形式〔adbimportコマンド〕

固定長形式の仕様[1]

認可識別子の指定規則[1]

認可識別子の表示〔adbsqlサブコマンド〕[1]

の

ノード間の通信回数〔SQL文の統計情報〕[1]

ノード間の通信回数〔コネクションの稼働情報〕[1]

ノード間の通信時間〔SQL文の統計情報〕[1]

ノード間の通信時間〔コネクションの稼働情報〕[1]

ノード種別の変更[1]

ノード番号の表示[1]

は

排他資源（DBエリア）の確保回数〔SQL文の統計情報〕[1]

排他資源（DBエリア）の確保待ちの時間〔SQL文の統計情報〕[1]

排他資源（DBエリア）の確保待ちの発生回数〔SQL文の統計情報〕[1]

排他資源（表）の確保回数〔SQL文の統計情報〕[1]

排他資源（表）の確保待ちの時間〔SQL文の統計情報〕[1]

排他資源（表）の確保待ちの発生回数〔SQL文の統計情報〕[1]

排他資源の状態表示[1]

バイトコード順〔エクスポート結果〕[1]

バイナリデータの出力形式の指定〔adbsqlサブコマンド〕[1]

パスワードの指定規則[1]

バックグラウンドインポート[1]

GZIP形式で圧縮したCSV形式の表データをバックグラウンドインポートする場合[1]

バックグラウンドインポートを実行できる回数〔表のサマリ情報〕[1]

ハッシュグループ化領域が不足したかどうか〔SQL文の統計情報〕[1]

ハッシュグループ化領域が不足しない十分な領域サイズ〔SQL文の統計情報〕[1]

ハッシュグループ化領域の確保回数〔SQL文の統計情報〕[1]

ハッシュグループ化領域の確保回数〔コネクションの稼働情報〕[1]

ハッシュグループ化領域の最大使用量〔SQL文の統計情報〕[1]

ハッシュグループ化領域の最大使用量〔コネクションの稼働情報〕[1]

ハッシュテーブル領域が不足したかどうか〔SQL文の統計情報〕[1]

ハッシュテーブル領域サイズ〔SQL文の統計情報〕[1]

ハッシュテーブル領域の最大使用量〔SQL文の統計情報〕[1]

ハッシュテーブル領域の最大使用量〔コネクションの稼働情報〕[1]

ハッシュフィルタが無効化されたかどうか〔SQL文の統計情報〕[1]

ハッシュフィルタ領域サイズ〔SQL文の統計情報〕[1]

バッファの変更[1]

バッファ変更オプション[1]

バッファ変更オプションファイル名[1]

範囲指定〔adbarchivechunkコマンド〕[1]

チャンクのアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブされるチャンクを確認する場合[1]

特定の日付の範囲のデータを含むチャンクをアーカイブする場合[1]

範囲指定〔adbdbstatusコマンド〕[1]

範囲指定〔adbunarchivechunkコマンド〕[1]

チャンクのアンアーカイブ処理を実行する前に，指定した日付の範囲を基にアーカイブ状態が解除されるチャンクを確認する場合[1]

特定の日付の範囲のデータを含むチャンクのアーカイブ状態を解除する場合[1]

範囲指定の詳細〔adbarchivechunkコマンド〕[1]

範囲指定の詳細〔adbdbstatusコマンド〕[1]

範囲指定の詳細〔adbunarchivechunkコマンド〕[1]

ひ

表ID〔アーカイブ状態のチャンクのサマリ情報〕[1]

表ID〔アーカイブ状態のチャンクの使用量情報〕[1]

表ID〔再編成要否の情報〕[1]

表ID〔表のサマリ情報〕[1]

表識別子〔アーカイブ状態のチャンクのサマリ情報〕[1]

表識別子〔アーカイブ状態のチャンクの使用量情報〕[1]

表識別子〔再編成要否の情報〕[1]

表識別子〔表のサマリ情報〕[1]

標準入力からSQL文を実行する場合[1]

表情報の表示〔adbsqlサブコマンド〕[1]

表定義情報の取得要求回数〔SQL文の統計情報〕[1]

表定義情報の取得要求回数〔HADBサーバの統計情報〕[1]

表定義プールからの表定義情報の取得回数〔HADBサーバの統計情報〕[1]

表定義プールからの表定義情報の取得回数〔SQL文の統計情報〕[1]

表定義プールからの表定義情報の掃き出し回数〔HADBサーバの統計情報〕[1]

表定義プールからの表定義情報の掃き出し回数〔SQL文の統計情報〕[1]

表定義プールへの表定義情報の登録回数〔HADBサーバの統計情報〕[1]

表定義プールへの表定義情報の登録回数〔SQL文の統計情報〕[1]

表データの格納形式〔表のサマリ情報〕[1]

表データをインポートする場合

CSV形式[1]

CSV形式〔列構成情報ファイルを指定する場合〕[1]

固定長形式[1]

表データをバックグラウンドインポートする場合

GZIP形式で圧縮したCSVファイル[1]

表のサマリ情報[1]

出力行数[1]

出力される項目の一覧[1]

出力順序[1]

出力例[1]

特定の表の状態を調べる〔使用例〕[1]

特定の表の使用量を調べる〔使用例〕[1]

表の種類〔表のサマリ情報〕[1]

表の使用中セグメント数〔表のサマリ情報〕[1]

表の使用中ページ数〔表のサマリ情報〕[1]

表のスキーマ名〔アーカイブ状態のチャンクのサマリ情報〕[1]

表のスキーマ名〔アーカイブ状態のチャンクの使用量情報〕[1]

表名の指定規則[1]

ふ

ファイルに記述したSQL文を実行する場合[1]

ファイルに出力する場合〔SQL文の実行結果〕[1]

フィールドデータ[1]

フィールドデータの記述形式（CSV形式）[1]

フィールドデータの記述形式（固定長形式）[1]

フィールドデータ番号[1]

複数の表のチャンクの状態を一括変更する〔adbchgchunkstatusコマンド〕[1]

複数の文ハンドルを同時実行したときの処理スレッド数不足の発生回数〔コネクションの稼働情報〕[1]

プロセス共通メモリの最大使用量〔HADBサーバの統計情報〕[1]

ブロックスペシャルファイル〔DBエリアファイル〕

DBエリアを拡張する場合[1]

DBエリアを削除する場合[1]

DBエリアを追加する場合[1]

へ

ページグループサイズ〔インデクスのサマリ情報〕[1]

ページサイズ〔adbaddareaオペランド〕[1]

ページサイズ〔adbinitdbareaオペランド〕[1]

ページサイズ〔DBエリア，表とインデクスの使用量情報〕[1]

ページサイズ〔DBエリアのサマリ情報〕[1]

ページサイズ〔インデクスのサマリ情報〕[1]

ページサイズ〔表のサマリ情報〕[1]

ページ数〔再編成要否の情報〕

ローデータ用セグメントに含まれる基本行用ページのページ数[1]

ローデータ用セグメントに含まれる分岐行用ページのページ数[1]

ローデータ用セグメントに含まれる無効情報管理用ページのページ数[1]

変換〔監査証跡ファイル〕[1]

ま

マージチャンクオプション[1]

マージチャンク処理[1]

マージチャンク処理の経過メッセージ[1]

マージ元チャンクID指定[1]

マシン〔コマンドを実行できるマシン〕[1]

マルチノード機能を使用している場合にコマンドを実行できるノード[1]

み

未完状態〔インデクスのサマリ情報〕[1]

未完状態のインデクスの再作成[1]

未完状態のインデクスを再作成する場合[1]

め

メッセージに関する注意事項[1]

メモリの使用状況の表示[1]

メンテナンスモード

メンテナンスモードに変更する場合〔adbchgsrvmodeコマンド〕[1]

メンテナンスモードで開始する場合〔adbstatコマンド〕[1]

ゆ

ユーザログバッファの満杯による掃き出し回数〔HADBサーバの統計情報〕[1]

ユーザログバッファの満杯による掃き出し回数〔SQL文の統計情報〕[1]

ユーザログバッファの満杯による掃き出し回数〔コネクションの稼働情報〕[1]

ユーザログファイルが初期化容量に縮小された回数〔HADBサーバの統計情報〕[1]

ユーザログファイルが初期化容量に縮小された回数〔コネクションの稼働情報〕[1]

ユーザログファイルの最大使用量〔HADBサーバの統計情報〕[1]

ユーザログファイルの最大使用量〔SQL文の統計情報〕[1]

ユーザログファイルの最大使用量〔コネクションの稼働情報〕[1]

ユーザログファイルへの書き込み回数〔HADBサーバの統計情報〕[1]

ユーザログファイルへの書き込み回数〔SQL文の統計情報〕[1]

ユーザログファイルへの書き込み回数〔コネクションの稼働情報〕[1]

り

リアルスレッド固有メモリの最大使用量の合計値〔HADBサーバの統計情報〕[1]

リアルスレッド種別の表示[1]

リアルスレッド番号の表示[1]

リターンコード

adbarchivechunkコマンド[1]

adbaudittrailコマンド[1]

adbcancelコマンド[1]

adbchgchunkcommentコマンド[1]

adbchgchunkstatusコマンド[1]

adbchgnodetypeコマンド[1]

adbchgsqltrcコマンド[1]

adbchgsrvmodeコマンド[1]

adbclientdefmangコマンド[1]

adbcolumnizeコマンド[1]

adbconvertaudittrailfileコマンド[1]

adbdbstatusコマンド[1]

adbexportコマンド[1]

adbgetcstコマンド[1]

adbidxrebuildコマンド[1]

adbimportコマンド[1]

adbinfogetコマンド[1]

adbinfosweepコマンド[1]

adbinitコマンド[1]

adbinstallコマンド[1]

adbls -d cfmコマンド[1]

adbls -d cltgrpコマンド[1]

adbls -d cnctコマンド[1]

adbls -d gbufコマンド[1]

adbls -d lbufコマンド[1]

adbls -d lockコマンド[1]

adbls -d memコマンド[1]

adbls -d nodeコマンド[1]

adbls -d prlコマンド[1]

adbls -d shmコマンド[1]

adbls -d srvコマンド[1]

adbls -d thdコマンド[1]

adbls -d verコマンド[1]

adblsコマンド[1], [2]

adbmergechunkコマンド[1]

adbmkdmkコマンド[1]

adbmodareaコマンド[1]

adbmodbuffコマンド[1]

adbmonitorコマンド[1]

adboptinstallコマンド[1]

adbreorgsystemdataコマンド[1]

adbsqlコマンド[1]

adbstartコマンド[1]

adbstatコマンド[1]

adbstopコマンド[1]

adbsyndictコマンド[1]

adbunarchivechunkコマンド[1]

adbupddmkコマンド[1]

リロード処理[1]

れ

レギュラーファイル〔DBエリアファイル〕

DBエリアを拡張する場合[1]

DBエリアを削除する場合[1]

DBエリアを追加する場合[1]

レコード長[1]

列構成情報ファイル[1]

列情報の表示〔adbsqlサブコマンド〕[1]

レンジインデクスのページグループサイズ〔インデクスのサマリ情報〕[1]

レンジインデクスバッファからのファイル書き込み回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファからのファイル書き込み要求回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファのページアウト回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファのページイン回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファのページヒット回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファのページヒット率〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファのページ要求回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファへのファイル読み込み回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファへのファイル読み込み要求回数〔グローバルバッファの統計情報〕[1]

レンジインデクスバッファ面数

総レンジインデクスバッファ面数〔グローバルバッファの統計情報〕[1]

割り当て済みのレンジインデクスバッファ面数〔グローバルバッファの統計情報〕[1]

レンジインデクスを使用した検索で，表のセグメントが探索条件を満たす値域のデータを格納しているかどうかを判定した回数〔SQL文の統計情報〕[1]

レンジインデクスを使用した検索で，表のセグメントをスキップした回数〔SQL文の統計情報〕[1]

レンジインデクスを使用した検索で，表のセグメントをスキップしなかった回数〔SQL文の統計情報〕[1]

レンジインデクスを使用した検索で，表のチャンクが探索条件を満たす値域のデータを格納しているかどうかを判定した回数〔SQL文の統計情報〕[1]

レンジインデクスを使用した検索で，表のチャンクをスキップした回数〔SQL文の統計情報〕[1]

レンジインデクスを使用した検索で，表のチャンクをスキップしなかった回数〔SQL文の統計情報〕[1]

ろ

ローカル作業表のソートでの最大作業表ページ数〔SQL文の統計情報〕[1]

ローカル作業表のソートでの最大のソート段数〔SQL文の統計情報〕[1]

ローカル作業表用バッファからのファイル書き込み回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファからのファイル書き込み回数〔コネクションの稼働情報〕[1]

ローカル作業表用バッファの最大使用ページ数〔SQL文の統計情報〕[1]

ローカル作業表用バッファの情報表示[1]

ローカル作業表用バッファの生成回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファのヒット回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファのヒット率〔SQL文の統計情報〕[1]

ローカル作業表用バッファのページ数を変更する[1]

ローカル作業表用バッファのページ要求回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファへの書き込み回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファへのファイル読み込み回数〔SQL文の統計情報〕[1]

ローカル作業表用バッファへのファイル読み込み回数〔コネクションの稼働情報〕[1]

ロールバック回数〔HADBサーバの統計情報〕[1]

ロールバック回数〔コネクションの稼働情報〕[1]

論理エラーが発生したときの対処手順[1]

論理エラーデータの出力[1]

論理エラーデータファイル[1]

論理エラーデータファイルの内容（格納対象となったデータだけが切り出される場合）[1]

論理エラーデータファイルの内容（行データがそのまま出力される場合）[1]

わ

割り当て済みのグローバルバッファ面数〔グローバルバッファの統計情報〕[1]

割り当て済みのレンジインデクスバッファ面数〔グローバルバッファの統計情報〕[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号