Azure のリージョンデータベースおよびリージョン間データベースの構成ファイルの更新

ここでは、構成ファイルを作成または更新して、1 つ以上のリージョンデータベースおよび 1 つのリージョン間データベースのエントリを追加する手順を示します。

Enterprise Developer command promptを開きます。

注: Windows では、使用する ODBC データソースと同じビット体系のコマンドプロンプトを使用する必要があります。
MFDBFH_CONFIG 環境変数を設定して、作成または更新する構成ファイルの場所を指定します。
```
set MFDBFH_CONFIG=<location-and-name-of-file>
```
この変数を設定しない場合、MFDBFH.cfg という名前のファイルが現在のディレクトリにあると見なされます。

注: データストアの操作に使用するストアドプロシージャを指す MFDBFH_SCRIPT_DIR 環境変数も必要ですが、この変数は Enterprise Developer command promptを使用する場合はすでに暗黙的に設定されています。
接続するデータベースサーバーインスタンスを追加します。
```
dbfhconfig -add -server:<server-name> -provider:az
```
<server-name> は、データベースサーバーインスタンスの名前です。(local) または localhost のエントリも有効で、デフォルトでマシン名になります。MSSQL データストアで構成ファイルをすでに更新している場合、このエントリはすでに存在するため、このことを通知するメッセージが表示され、次の手順にスキップできます。

次に、インスタンス内の必要なデータベースを指定します。
最初に、master データベースへの参照を作成する必要があります。これは、Azure に付属のプライマリ構成データベースです。
注: すでにデータベースサーバーインスタンスの <server> 要素が存在している場合は、この参照もすでに存在しているため、この手順をスキップしてください。
```
dbfhconfig -add -server:<server-name> -dsn:<dsn-name> -type:database -name:master [-user:<user-name>] [-password:<password>] [-connect:<connection-string>]
```
<dsn-name> は、Azure master データベースの ODBC データソースであるか、ODBC データソースの代わりに接続文字列を使用する場合は、データベースを参照する構成内の一意の名前です。<user-name> および <password> は、インスタンスの有効な資格情報です。接続文字列を使用する場合は、これらの要素を指定する必要はありません。<connection-string> は、ODBC データソースを使用せずにデータベース接続を確立する場合のデータベース接続文字列です。データベース固有の構文については、「データベース接続文字列」を参照してください。
必要なリージョンデータベースのそれぞれについて、次の手順を繰り返します。
```
dbfhconfig -add -server:<server-name> -dsn:<dsn-name> -type:region -name:<region-name> -feature:<options> [-user:<user-name>] [-password:<password>] [-connect:<connection-string>]
```
<dsn-name> は、リージョンデータベースの ODBC データソースであるか、ODBC データソースの代わりに接続文字列を使用する場合は、リージョンデータベースを参照する構成内の一意の名前です。<region-name> は、エンタープライズサーバーリージョンの名前です。<options> は、リージョンでデータベースを使用する機能のリストです。
<options> には次のうちの 1 つまたは複数を使用できます。
- all - リージョンの使用可能なすべての機能を有効にします (デフォルト)。
- none - リージョンのすべての機能を無効にします。
- [+|-]reslocking - データベースリソースロックを有効/無効にします。
次に、単一のリージョン間データベースへの参照を追加します。
```
dbfhconfig -add -server:<server-name> -dsn:<dsn-name> -type:crossregion [-user:<user-name>] [-password:<password>] [-connect:<connection-string>] 
```
<dsn-name> は、リージョン間データベースの ODBC データソースであるか、ODBC データソースの代わりに接続文字列を使用する場合は、データベースを参照する構成内の一意の名前です。

構成ファイルの例

次の構成ファイルには、2 つのデータストアとリージョンデータベースおよびリージョン間データベースが含まれています。データベースインスタンスは、VAR2AZDB 変数で示されます。このデータベースへの接続を確立するにはログイン資格情報が必要であるため、Secrets Vault も有効になっています。詳細については、「Micro Focus データベースファイルハンドラーの Secrets Vault の構成」を参照してください。

<datastores usevault="true">
   <server name="${VAR2AZDB}" type="azuresqldb" access="odbc">
      <dsn name="AZ.MYMASTER" type="database" dbname="master" userid="azusr" password="$$vault$$"/>
      <dsn name="AZ.VSAM" type="datastore" dsname="VSAM" userid="azusr" password="$$vault$$"/>
      <dsn name="AZ.SEQ" type="datastore" dsname="SEQ" optio="+ooseq" userid="azusr" password="$$vault$$"/>
      <dsn name="AZ.CAS.ESDEMO" type="region.cas" region="ESDEMO" feature="all" userid="azusr" password="$$vault$$"/>
      <dsn name="AZ.CROSSREGION" type="crossregion.cas" userid="azusr" password="$$vault$$"/>
   </server>
</datastores>

次に、dbfhadmin コマンドラインユーティリティを使用して、リージョンデータベースおよびリージョン間データベースを作成する必要があります。

Azure のリージョン データベースおよびリージョン間データベースの構成ファイルの更新

構成ファイルの例

Azure のリージョンデータベースおよびリージョン間データベースの構成ファイルの更新