sp_helpdistributiondb (Transact-SQL)
適用対象: SQL Server Azure SQL Managed Instance
指定したディストリビューション データベースのプロパティを返します。 このストアド プロシージャは、ディストリビューション データベースのディストリビューターで実行されます。
構文
sp_helpdistributiondb [ [ @database = ] N'database' ]
[ ; ]
引数
[ @database = ] N'database'
プロパティが返されるデータベース名。 @database は sysname であり、ディストリビューターに関連付けられているすべてのデータベースの既定値は %
で、ユーザーにはアクセス許可が与えられます。
結果セット
列名 | データ型 | 説明 |
---|---|---|
name |
sysname | ディストリビューション データベースの名前。 |
min_distretention |
int | トランザクションが削除されるまでの最小保有期間 (時間単位)。 |
max_distretention |
int | トランザクションが削除されるまでの最大保有期間 (時間単位)。 |
history retention |
int | 履歴を保持する時間数。 |
history_cleanup_agent |
sysname | 履歴クリーンアップ エージェントの名前。 |
distribution_cleanup_agent |
sysname | ディストリビューション クリーンアップ エージェントの名前。 |
status |
int | 内部のみで使用します。 |
data_folder |
nvarchar (255) | データベース ファイルを格納するときに使用するディレクトリの名前。 |
data_file |
nvarchar (255) | データベース ファイルの名前。 |
data_file_size |
int | データ ファイルの初期サイズ (MB 単位)。 |
log_folder |
nvarchar (255) | データベース ログ ファイルを格納するディレクトリの名前。 |
log_file |
nvarchar (255) | ログ ファイルの名前。 |
log_file_size |
int | 初期ログ ファイルのサイズ (メガバイト単位)。 |
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_helpdistributiondb
は、すべての種類のレプリケーションで使用されます。
アクセス許可
ディストリビューション データベースの db_owner 固定データベース ロールまたは replmonitor ロールのメンバーと、ディストリビューション データベースを使用してパブリケーションのパブリケーション アクセス リスト内のユーザーは、 sp_helpdistributiondb
を実行して、ファイル関連の情報を返すことができます。 public ロールのメンバーは、sp_helpdistributiondb
を実行して、アクセス権を持つディストリビューション データベースのファイル関連以外の情報を返すことができます。