MIN_ACTIVE_ROWVERSION (Transact-SQL)

現在のデータベース内でアクティブな最小の rowversion 値を返します。rowversion 値がアクティブになるのは、まだコミットされていないトランザクションで使用される場合です。詳細については、「rowversion (Transact-SQL)」を参照してください。

注
rowversion データ型は、timestamp とも呼ばれます。

Transact-SQL 構文表記規則

構文

MIN_ACTIVE_ROWVERSION

戻り値の型

binary(8) 値を返します。

説明

MIN_ACTIVE_ROWVERSION は、現在のデータベース内でアクティブな最小の rowversion 値を返す非決定的関数です。新しい rowversion 値は、通常、rowversion 型の列を含むテーブルに対して挿入または更新が実行されたときに生成されます。データベース内にアクティブな値がない場合は、MIN_ACTIVE_ROWVERSION は @@DBTS + 1 と同じ値を返します。

MIN_ACTIVE_ROWVERSION は、データの同期など、rowversion 値を使用して一連の変更をグループ化する場合に役立ちます。アプリケーションで MIN_ACTIVE_ROWVERSION ではなく @@DBTS を使用する場合、同期が行われるときにアクティブな変更が失われる可能性があります。

例

次の例では、MIN_ACTIVE_ROWVERSION と @@DBTS を使用して rowversion 値を返します。データベース内にアクティブなトランザクションがない場合、値が異なることがわかります。

-- Create a table that has a ROWVERSION column in it.
CREATE TABLE RowVersionTestTable (rv ROWVERSION)
GO

-- Print the current values for the database.
PRINT ''
PRINT 'DBTS'
PRINT @@DBTS
PRINT 'MIN_ACTIVE_ROWVERSION'
PRINT MIN_ACTIVE_ROWVERSION() 
GO
---------------- Results ----------------
--DBTS
--0x00000000000007E2
--MIN_ACTIVE_ROWVERSION
--0x00000000000007E3

-- Insert a row.
INSERT INTO RowVersionTestTable VALUES (DEFAULT)
SELECT * FROM RowVersionTestTable
GO
---------------- Results ----------------
--rv
--0x00000000000007E3

-- Print the current values for the database.
PRINT ''
PRINT 'DBTS'
PRINT @@DBTS
PRINT 'MIN_ACTIVE_ROWVERSION'
PRINT MIN_ACTIVE_ROWVERSION()
GO
---------------- Results ----------------
--DBTS
--0x00000000000007E3
--MIN_ACTIVE_ROWVERSION
--0x00000000000007E4

-- Insert a new row inside a transaction but do not commit.
BEGIN TRAN
INSERT INTO RowVersionTestTable VALUES (DEFAULT)
SELECT * FROM RowVersionTestTable
GO
---------------- Results ----------------
--rv
--0x00000000000007E3
--0x00000000000007E4

-- Print the current values for the database.
PRINT ''
PRINT 'DBTS'
PRINT @@DBTS
PRINT 'MIN_ACTIVE_ROWVERSION'
PRINT MIN_ACTIVE_ROWVERSION() 
GO
---------------- Results ----------------
--DBTS
--0x00000000000007E4
--MIN_ACTIVE_ROWVERSION
--0x00000000000007E4

-- Commit the transaction.
COMMIT
GO

-- Print the current values for the database.
PRINT ''
PRINT 'DBTS'
PRINT @@DBTS
PRINT 'MIN_ACTIVE_ROWVERSION'
PRINT MIN_ACTIVE_ROWVERSION()
GO
---------------- Results ----------------
--DBTS
--0x00000000000007E4
--MIN_ACTIVE_ROWVERSION
--0x00000000000007E5

関連項目

参照

@@DBTS (Transact-SQL)

rowversion (Transact-SQL)