6.2.1 指定形式およびオプションの説明
(1) 指定形式
adbchgchunkstatus
-u 認可識別子
〔-p パスワード〕
〔-w 待機状態に変更するチャンクのチャンクID〔,待機状態に変更するチャンクのチャンクID〕…〕
〔-n 通常状態に変更するチャンクのチャンクID〔,通常状態に変更するチャンクのチャンクID〕…〕
処理対象表
- 重要
-
-
-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コマンドを実行すると，パスワードの入力を求める応答メッセージが表示されます。バックグラウンドで実行する場合など，標準入力からパスワードを入力できない環境では，このオプションを省略しないでください。
- ●-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権限を持っている表を指定できます。
-
シングルチャンク表は指定できません。
-
ビュー表は指定できません。
-
(3) -wおよび-nオプションの指定規則
-
複数のチャンクIDを指定する場合，コンマまたはハイフンの前後に空白を入れないでください。
-
ハイフンを指定してチャンク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個指定したと見なされます。
-
-
-wオプションに指定できる値の長さの上限，および-nオプションに指定できる値の長さの上限は両方とも32キロバイトです。このため，-wオプションまたは-nオプションの指定値の長さが32キロバイトを超える場合は，範囲指定に変更するか，またはadbchgchunkstatusコマンドを複数回に分けて実行してください。
-
-wおよび-nオプションの指定誤りのケースを次の表に示します。
表6‒1 -wおよび-nオプションの指定誤りのケース 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オプションの指定値を範囲指定にして，指定値の長さを短くしてください。
- （凡例）
-
△：空白
-