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

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

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

（凡例）

△：空白

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

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

注

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

(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

  （凡例）

  △：空白