データベース コマンド
BAM 管理ユーティリティのデータベース コマンドを使用すると、BAM データベースを操作することができます。
setup-databases: BAM 固有のデータベースを作成します。
migrate-sql: BAM データベースを次の場所から移行します。
Microsoft SQL Server 2000 から Microsoft SQL Server 2008 へ
Microsoft SQL Server 2005 から Microsoft SQL Server 2008
enable-reference: 分散 BAM プライマリ インポート データベースへの参照を有効にします。
get-references: 分散 BAM プライマリ インポート データベースへの参照の一覧を取得します。
disable-reference: BAM プライマリ インポート データベースへの参照を無効にします。
Note
-Trace:on|off パラメーター スイッチを含めることで、任意の BM ユーティリティ コマンドでトレースを有効にすることができます。 Trace スイッチを使用すると、構成ファイルのトレース設定がオーバーライドされます。 このスイッチは、通常の BM コマンドと組み合わせて使用できます。
Note
ユーザー アカウント制御 (UAC) をサポートするシステムでは、管理者特権を使用してこのツールを実行することが必要な場合があります。
setup-databases コマンド
使用方法
bm.exe setup-databases-ConfigFile:<configuration file>[ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ]
パラメーター
パラメーター | 説明 |
---|---|
ConfigFile:<configuration ファイル> | データベースの作成に使用する BAM 構成ファイルです。 |
NSUser:<notifications サービスのユーザー名> | 省略可能: データベースを作成するアクセス許可を持つ通知サービス ユーザーのユーザー ID。 |
NSUserPassword | 省略可能: 指定した通知サービス ユーザーのパスワード。 |
構成ファイルに指定されたデータベース (BAM プライマリ インポート、BAM スター スキーマ、BAM アーカイブ、BAM 分析、警告の各データベース) が存在しない場合は作成します。 データベースの作成後、関連する BAM メタデータ テーブルとストアド プロシージャが作成されます。
BAM 警告を設定する場合、NSUser パラメーターおよび NSUserPassword パラメーターは省略できません。 コマンド ラインで NSUserPassword を指定しなかった場合、bm.exe により、パスワードの入力を求められます。
Note
コマンドの実行後、トレース ログを見ると、AlertModule によって、次のような例外が出力されていることがあります。
"指定したアカウントはデータベース所有者です。 データベース所有者は常にビューへのアクセス権限を持っており、ビューに追加したり、ビューから削除することはできません。"
さらに、NotificationServices #19001 により、イベントの警告が出力されていることがあります。
コマンドの実行中にエラーが報告されなければ、これらのメッセージは無視してかまいません。
重要
既に BAM 警告が構成されているとき、警告セクションを含まない BAM 構成ファイルを使って setup-database コマンドを実行すると、今後、警告が生成されないよう、bm.exe により構成が上書きされます。
BAM データベースをセットアップするには、BAMPrimaryImport データベース、BAMStarSchema データベース、および BAMArchive データベースをホストする Microsoft SQL Server に対する管理者権限を持っている必要があります。 SQL Notification Services データベースを設定するには、管理者権限を持っており、ローカルの Administrators グループのメンバーであることが必要です。また、追加で構成された他の管理者グループ (BTS Admins グループなど) のメンバーであることも必要です。
使用例
bm.exe setup-databases -ConfigFile:BamConfiguration.xml
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1
migrate-sql コマンド
使用方法
bm.exe migrate-sql -From:sql2000 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]
- または -
bm.exe migrate-sql -From:sql2005 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:server> ][ -Database:<<database> ]
パラメーター
パラメーター | 説明 |
---|---|
From: sql2000 | Microsoft SQL Server 2000 データベースからの変換であることを指定します。 |
To:sql2008 | Microsoft SQL Server 2008 データベースに変換することを指定します。 |
From: sql2005 | Microsoft SQL Server 2005 データベースから変換することを指定します。 |
To:sql2008 | Microsoft SQL Server 2008 データベースに変換することを指定します。 |
NSUser:<notifications サービスのユーザー名> | 省略可能: データベースを作成するアクセス許可を持つ Notifications Services ユーザーのユーザー ID。 |
NSUserPassword | 省略可能: 指定した Notifications Services ユーザーのパスワード。 |
Server:<server> | 省略可能: 変換されたデータベースが存在するサーバーの名前。 サーバーは、Microsoft SQL Server 2008 データベースをホストしているコンピューターと同じドメインに存在する必要があります。 サーバー名を指定しなかった場合、既定の名前 (localhost) が使用されます。 |
Database:<database> | 省略可能: 次に、変換されたデータベースの名前を指定します。 指定しなかった場合、既定の名前 (BamPrimaryImport) が使用されます。 |
BAM インフラストラクチャを Microsoft SQL Server 2000 または Microsoft SQL Server 2005 から Microsoft SQL Server 2008 に移行します。 データベース サーバーと Analysis サーバーを Microsoft SQL Server 2000 または Microsoft SQL Server 2005 から Microsoft SQL Server 2008 にアップグレードした後に、このコマンドを使用します。
BAM 警告を構成した場合、NSUser パラメーターおよび NSUserPassword パラメーターは省略できません。 コマンド ラインで NSUserPassword を指定しなかった場合、bm.exe により、パスワードの入力を求められます。
SQL Server Notification Services データベースを移行するには、管理者権限を持っており、ローカルの Administrators グループのメンバーであることが必要です。また、追加で構成された他の管理者グループ (BTS Admins グループなど) のメンバーであることも必要です。
Note
"エラー: コンピューター 'コンピューター名>'< でサービス NS$BAMAlerts を開始できません。 サービスは適切な時間内に開始要求または制御要求に応答しませんでした。」が表示される場合は、サービスを手動で開始してみます。 移行時など、SQL Server が極端なビジー状態の場合は、サービスを再開できない場合があります。
Note
Notification Services がインストールされているコンピューターで migrate-sql コマンドを実行するには、そのコンピューターのローカル管理者グループのメンバーである必要があります。
使用例
bm.exe migrate-sql -From:sql2000 -To:sql2008 -NSUser:domain\user1
bm.exe migrate-sql -From:sql2000 -To:sql2008 -Server:MyServer -Database:db1
bm.exe migrate-sql -From:sql2005 -To:sql2008 -NSUser:domain\user1
bm.exe migrate-sql -From:sql2005 -To:sql2008 -Server:MyServer -Database:db1
enable-reference コマンド
使用方法
bm.exe enable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
パラメーター
パラメーター | 説明 |
---|---|
TargetServer:<target server> | 参照を有効にするサーバーの名前です。 このサーバーは、bm.exe を実行するコンピューターと同じドメインに存在している必要があります。 |
TargetDatabase:<target データベース> | 参照を有効にするデータベースの名前です。 |
Server:<server> | 省略可能: ターゲット サーバーとデータベースへの参照が有効になるサーバーの名前。 サーバー名を指定しなかった場合、既定の名前 (localhost) が使用されます。 |
Database:<database> | 省略可能: ターゲット サーバーとデータベースへの参照が有効になるデータベースの名前。 指定しなかった場合、既定の名前 (BamPrimaryImport) が使用されます。 |
分散されている別の BAM プライマリ インポート データベースへの参照を有効にします。 対象となる BAM プライマリ インポート データベース上のビューやアクティビティのメタデータを、現在のデータベースからサブスクライブできます。 分散アクティビティを表示できるようにしたい場合に使用します。
ターゲット サーバーを SQL Server のインスタンスとして指定できます (例: 'mymachine2\myinstance')。
使用例
bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1
get-references コマンド
使用方法
get-references のbm.exe [ -Server:<server> ][ -Database:<database> ]
パラメーター
パラメーター | 説明 |
---|---|
Server:<server> | 省略可能: 参照の一覧を取得するサーバーの名前。 このサーバーは、bm.exe を実行するコンピューターと同じドメインに存在している必要があります。 サーバー名を指定しなかった場合、既定の名前 (localhost) が使用されます。 |
Database:<database> | 省略可能: 参照の一覧を取得するデータベースの名前。 指定しなかった場合、既定の名前 (BamPrimaryImport) が使用されます。 |
コマンドを実行するコンピューターで有効にされている参照を一覧表示します。
使用例
bm.exe get-references
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport
disable-reference コマンド
使用方法
bm.exe disable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
パラメーター
パラメーター | 説明 |
---|---|
TargetServer:<target server> | 参照を無効にするサーバーの名前です。 このサーバーは、bm.exe を実行するコンピューターと同じドメインに存在している必要があります。 |
TargetDatabase:<target データベース> | 参照を無効にするデータベースの名前です。 |
Server:<server> | 省略可能: ターゲット サーバーとデータベースへの参照を無効にするサーバーの名前。 このサーバーは、bm.exe を実行するコンピューターと同じドメインに存在している必要があります。 サーバー名を指定しなかった場合、既定の名前 (localhost) が使用されます。 |
Database:<database> | 省略可能: ターゲット サーバーとデータベースへの参照を無効にするデータベースの名前。 指定しなかった場合、既定の名前 (BamPrimaryImport) が使用されます。 |
ターゲット サーバー上の別の分散 BAM プライマリ インポート データベースへの参照を無効にします。
ターゲット サーバーを SQL Server のインスタンスとして指定できます (例: 'mymachine2\myinstance')。
使用例
bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1