データベース設定パラメータの変更

SAP HANA コックピットから Database Configuration アプリを使用して、パラメータを照会および変更することができます。設定ファイルのパラメータを変更するには、システム権限 INIFILE ADMIN が必要です。

SAP HANA には、多数の設定ファイルとパラメータがあります。そのため、パラメータ構造でパラメータを簡単に検索するには、検索機能を使用します。

検索項目にパラメータの名称またはパラメータの数文字を入力し、キーボードの Enter を選択します。

SAP HANA の新しいバージョンにアップグレードすると、最新の経験に基づく最新のパラメータ設定が自動的に反映されますが、独自に行った変更は変わりません。

デフォルト値が残っているパラメータや変更されたパラメータを簡単に区別することができます。パラメータの横にある鉛筆アイコンは変更の区分です。

さらに、データベースのパラメータの設定スナップショットを取得することができます。これらのスナップショットは、データベースが登録された時点での設定を反映したものであり、現在の設定または以前に生成された別のスナップショットと比較することができます。この方法により、時間の経過に伴う設定変更を簡単に特定することができます。

また、View Change History ボタンを使用すると、過去に変更されたデータベースパラメータについて、いつ、どれが、誰によって変更されたかが表示されます。

プラス (+) または Override Value ボタンを選択すると、パラメータ値を入力できるダイアログボックスが表示されます。

SAP HANA コックピットで Database Configuration アプリを使用する場合、評価順序に従って、いわゆるさまざまなレイヤに基づいて、パラメータ値の階層が明確に定義されます。最初に、SAP HANA カーネルからのレイヤ DEFAULT が考慮されます。次に、第 2 の場所のレイヤ SYSTEM が評価され、検出された値がすべてのテナントデータベースに継承されます。ただし、第 3 レイヤ DATABASE によって単一のデータベースに別の値が提供される場合は、それぞれの値が適用されます。第 4 (最終) レイヤ HOST は、限られた数のパラメータに対してのみ設定することができます。さらに、この値により、前のデータベースレイヤで提供された値が上書きされます。レイヤ HOST は、複数ホスト (スケールアウト) 環境でのみ使用することができます。

さらに、SAP HANA コックピットでのパラメータ変更のユーザインタフェースには、いくつかの有用な機能が用意されています (図 "SAP HANA コックピットでのパラメータ値の変更" の番号を参照)。

• 1+5: データベース再実行区分: 静的パラメータの編集時に表示

• 2+3: 値チェック: 値項目の入力が項目のタイプに従ってチェックされます。

• 4: デフォルト値の復元

• 6: レイヤの階層

変更した設定パラメータの値を編集または復元してデフォルト値に戻すには、値の横にある Edit Parameter (鉛筆) ボタンを選択します。Restore Default オプションを選択すると、変更が元に戻されます。ただし、その後必ず保存してください。

設定パラメータ値の変更は、何らかの理由で SAP HANA コックピットを使用できない場合、つまり SQL 文を実行して設定パラメータ値を変更できない場合、コンソールツール setParameter.py を使用して行うことになります。このツールは、コマンドラインから実行することも、他の管理ツールやスクリプトと統合することもできます。また、データベースがオフラインまたはオンラインの場合にも使用できます。

システムがオンラインの場合はsetParameter.py、コメントを入力して変更が行われた理由を明確にすることができます。コメントは、M_INIFILE_CONTENT_HISTORY システムビューに保存されます。

オンライン SAP HANA データベースシステムでパラメータ値を変更する場合は、同時にサービスを再設定する要求を含めることができます。

どのレイヤで変更を行う必要があるかを特定するために、以下のいずれかのレイヤを指定します。

• SYSTEM
• DATABASE:<DATABASENAME>
• HOST:<HOSTNAME>

リモートホストのパラメータを変更するには、ホストレイヤを使用します。リモートシステムはオンラインであり、ホストにアクセスできる必要があります。ホスト名を指定しなかった場合は、localhost と見なされます。

スクリプトのコンテキストで使用する場合、setParameter.py コンソールツールでは、パラメータの設定と設定解除が両方ともサポートされています。そうすることで、複数の値を同時に適用することもできます。パラメータを設定解除する場合、キー値は必要ありません。

12
python setParameter.py -set(or unset)=<LAYER>/<INIFILE_NAME>/<SECTION>/<KEY>=<VALUE>
[-comment=comment] [-reconfigure] [-sapcontrol=1]

ヘルプテキストのヘルプページを表示するには、以下のコマンドを実行します。

1
python setParameter.py --help

考えられるリターンコードは以下のとおりです。

• 0 - 正常実行
• 1 - 実行不可: 不適切な使用 (予期しないパラメータ値)
• 2 - その他のエラー: 認識されない引数など

-sapcontrol=1 スイッチを使用すると、以下のいずれかが出力されます。

• SAPCONTROL-OK
• SAPCONTROL-ERROR:<errorMsg>