7.2.15　クラウドストレージ機能に関するオペランド（set形式）

クラウドストレージ機能に関するオペランドは，使用するクラウド環境によって指定要否が次のように異なります。

表7‒8　クラウドストレージ機能を使用する場合に指定するオペランド

オペランド名	使用するクラウド環境
	AWS環境の場合	Azure環境の場合
adb_sys_cld_aws_region	〇	×
adb_sys_cld_aws_bucket	〇	×
adb_sys_cld_az_storage_account	×	〇
adb_sys_cld_az_container	×	〇
adb_sys_cld_cache_path	〇	〇
adb_sys_cld_cache_total_size	△	△
adb_sys_cld_access_area_size	△	△

（凡例）

〇：指定が必要です。

△：基本的には指定不要です。デフォルト値から指定を変更する場合に指定します。

×：指定不要です。

［62］ adb_sys_cld_aws_region = S3オブジェクトの格納先リージョン名

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

このオペランドには，S3オブジェクトを格納するリージョン名を指定します。AWS環境でクラウドストレージ機能を使用する場合は，このオペランドを必ず指定してください。クラウドストレージ機能については，「2.21.2　AWS環境でHADBサーバを使用する場合」の「(2)　Amazon S3にDBエリアのデータを格納する場合（クラウドストレージ機能を使用する場合）」の「(a)　クラウドストレージ機能とは」を参照してください。

メモ

• このオペランドを指定した場合は，adb_sys_cld_aws_bucketオペランドも一緒に指定してください。

• 初期設定オプションにadb_init_cld_aws_regionオペランドを指定してadbinitコマンドを実行する場合は，このオペランドを指定してください。また，このオペランドとadb_init_cld_aws_regionオペランドには，同じリージョン名を指定することを推奨します。異なるリージョン名を指定した場合，HADBサーバが開始できないおそれがあります。

［マルチノード機能］

マルチノード機能を使用する場合は，全ノードのHADBサーバでこのオペランドの指定値を同じにしてください。

［63］ adb_sys_cld_aws_bucket = S3オブジェクトの格納先S3バケット名

〜〈文字列〉((3〜63バイト))

このオペランドには，S3オブジェクトを格納するS3バケット名を指定してください。AWS環境でクラウドストレージ機能を使用する場合は，このオペランドを必ず指定してください。

メモ

• このオペランドを指定した場合は，adb_sys_cld_aws_regionオペランドも一緒に指定してください。

• 初期設定オプションにadb_init_cld_aws_bucketオペランドを指定してadbinitコマンドを実行する場合は，このオペランドを指定してください。また，このオペランドとadb_init_cld_aws_bucketオペランドには，同じS3バケット名を指定することを推奨します。異なるS3バケット名を指定した場合，HADBサーバが開始できないおそれがあります。

［マルチノード機能］

マルチノード機能を使用する場合は，全ノードのHADBサーバでこのオペランドの指定値を同じにしてください。

［64］ adb_sys_cld_az_storage_account = BLOBの格納先ストレージアカウント名

～〈文字列〉((3～24バイト))

このオペランドには，Azure Blob Storageのストレージアカウント名を指定します。Azure環境でクラウドストレージ機能を使用する場合は，このオペランドを必ず指定してください。クラウドストレージ機能については，「2.21.3　Azure環境でHADBサーバを使用する場合」の「(2)　Azure Blob StorageにDBエリアのデータを格納する場合（クラウドストレージ機能を使用する場合）」の「(a)　クラウドストレージ機能とは」を参照してください。

メモ

• このオペランドを指定した場合は，adb_sys_cld_az_containerオペランドも一緒に指定してください。

• 初期設定オプションのadb_sys_cld_az_storage_accountオペランドを指定してadbinitコマンドを実行する場合は，このオペランドを指定してください。また，このオペランドと初期設定オプションのadb_sys_cld_az_storage_accountオペランドには，同じストレージアカウント名を指定することを推奨します。異なるストレージアカウント名を指定した場合，HADBサーバが開始できないおそれがあります。

［マルチノード機能］

マルチノード機能を使用する場合は，全ノードのHADBサーバでこのオペランドの指定値を同じにしてください。

［65］ adb_sys_cld_az_container = BLOBの格納先コンテナー名

～〈文字列〉((3～63バイト))

このオペランドには，BLOBを格納するコンテナー名を指定してください。Azure環境でクラウドストレージ機能を使用する場合は，このオペランドを必ず指定してください。

メモ

• このオペランドを指定した場合は，adb_sys_cld_az_storage_accountオペランドも一緒に指定してください。

• 初期設定オプションのadb_sys_cld_az_containerオペランドを指定してadbinitコマンドを実行する場合は，このオペランドを指定してください。また，このオペランドと初期設定オプションのadb_sys_cld_az_containerオペランドには，同じコンテナー名を指定することを推奨します。異なるコンテナー名を指定した場合，HADBサーバが開始できないおそれがあります。

［マルチノード機能］

マルチノード機能を使用する場合は，全ノードのHADBサーバでこのオペランドの指定値を同じにしてください。

［66］ adb_sys_cld_cache_path = キャッシュファイルの格納先ディレクトリ名

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

このオペランドには，キャッシュファイルを格納するディレクトリを絶対パス名で指定します。クラウドストレージ機能を使用する場合は，このオペランドを必ず指定してください。

メモ

• 初期設定オプションにadb_init_cld_cache_pathオペランドを指定してadbinitコマンドを実行する場合は，このオペランドを指定してください。また，このオペランドとadb_init_cld_cache_pathオペランドには，同じディレクトリ名を指定することを推奨します。異なるディレクトリ名を指定をした場合，HADBサーバが開始できないおそれがあります。

• クラウドストレージ機能を使用しない場合は，このオペランドを指定しても無視されます。

［67］ adb_sys_cld_cache_total_size = キャッシュファイルの総容量の上限

～〈整数〉((1～1,000,000))《64》（単位：ギガバイト）

このオペランドには，キャッシュファイルの総容量の上限値を指定します。通常，このオペランドの指定は不要です。

このオペランドの指定値を基にして，HADBサーバの開始時にHADBサーバがキャッシュファイルの総容量の上限値を決定します。HADBサーバが決定したキャッシュファイルの総容量の上限値を超えた場合，最後にアクセスした時間がいちばん古いキャッシュファイルを削除したあとに新しいキャッシュファイルを作成することで，キャッシュファイルの総容量の上限を超えないようにします。

adbls -d cfmコマンドを実行すると，HADBサーバが決定したキャッシュファイルの総容量の上限値（INTERNAL_TOTAL_LIMIT(MB)）を確認できます。

メモ

キャッシュファイルの作成時にストレージの容量不足を検知した場合，警告メッセージKFAA51285-Wが出力され，HADBサーバが決定したキャッシュファイルの総容量の上限値を一時的に利用可能な容量まで引き下げます。一度引き下げられた上限値は，HADBサーバの稼働中には元に戻せません。元に戻す場合は，HADBサーバを再起動してください。

■このオペランドの指定値のチューニング方法

SQL文の統計情報を確認し，キャッシュファイルのヒット率を計算してください。ヒット率が80%以下の場合は，このオペランドの指定値を大きくしてください。

キャッシュファイルのヒット率（%）＝｛（A＋B）÷（C＋D）｝×100

A：Cld_cache_sgmt_read_hit_cntの値

B：Cld_cache_dir_read_hit_cntの値

C：Cld_cache_sgmt_read_cntの値

D：Cld_cache_dir_read_cntの値

上記は，SQL文の統計情報に出力される項目です。上記の出力項目については，マニュアルHADB　コマンドリファレンスのSQL文の統計情報で出力される項目を参照してください。

［68］ adb_sys_cld_access_area_size = S3オブジェクトまたはBLOBへのアクセス用メモリのサイズ

～〈整数〉((256～131,072))《2,048》（単位：メガバイト）

このオペランドには，S3オブジェクトへのアクセス時に使用する，S3オブジェクトを一時的に保持するためのメモリのサイズを指定します。通常，このオペランドの指定は不要です。

このオペランドの指定値を大きくすると，S3オブジェクトへのアクセス性能が向上することがあります。

このオペランドの指定値を32メガバイトの倍数に切り上げた値が，このオペランドの指定値として仮定されます。

メモ

Azure環境の場合は，S3オブジェクトをBLOBと読み替えてください。

ページの先頭へ