アクティブ Geo レプリケーション-sp_wait_for_database_copy_syncActive Geo-Replication - sp_wait_for_database_copy_sync

適用対象:Applies to: はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance適用対象:Applies to: はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance

このプロシージャは、プライマリとセカンダリの間のアクティブな地理的レプリケーションActive Geo-Replication リレーションシップを対象としています。This procedure is scoped to an アクティブな地理的レプリケーションActive Geo-Replication relationship between a primary and secondary. Sp_wait_for_database_copy_syncを呼び出すと、コミットされたすべてのトランザクションがアクティブなセカンダリデータベースによってレプリケートおよび確認されるまで、アプリケーションは待機します。Calling the sp_wait_for_database_copy_sync causes the application to wait until all committed transactions are replicated and acknowledged by the active secondary database. プライマリデータベースのみで sp_wait_for_database_copy_sync を実行します。Run sp_wait_for_database_copy_sync on only the primary database.

適用対象: Azure SQL データベースAzure SQL DatabaseApplies to: Azure SQL データベースAzure SQL Database.

構文Syntax

sp_wait_for_database_copy_sync [ @target_server = ] 'server_name'   
     , [ @target_database = ] 'database_name'  

引数Arguments

[ @target_server =] ' server_name '[ @target_server = ] 'server_name'
アクティブなセカンダリ データベースをホストする SQL データベース サーバーの名前。The name of the SQL Database server that hosts the active secondary database. server_name は sysname であり、既定値はありません。server_name is sysname, with no default.

[ @target_database = ] 'database_name'[ @target_database = ] 'database_name'
アクティブなセカンダリデータベースの名前。The name of the active secondary database. database_name は sysname であり、既定値はありません。database_name is sysname, with no default.

リターン コードの値Return Code Values

成功した場合は 0 を、失敗した場合はエラー番号を返します。Returns 0 for success or an error number for failure.

最も可能性の高いエラー条件は次のとおりです。The most likely error conditions are as follows:

  • サーバー名またはデータベース名がない。The server name or database name is missing.

  • 指定されたサーバー名またはデータベースに対するリンクが見つからない。The link cannot be found to the specified server name or database.

  • インターリンク接続が切断されました。Interlink connectivity is lost. 接続のタイムアウト後にsp_wait_for_database_copy_syncが返されます。sp_wait_for_database_copy_sync will return after the connection timeout.

アクセス許可Permissions

プライマリ データベース内のすべてのユーザーが、このシステム ストアド プロシージャを呼び出すことができます。Any user in the primary database can call this system stored procedure. ログインは、プライマリデータベースとアクティブセカンダリデータベースの両方のユーザーである必要があります。The login must be a user in both the primary and active secondary databases.

解説Remarks

Sp_wait_for_database_copy_sync呼び出しの前にコミットされたすべてのトランザクションが、アクティブなセカンダリデータベースに送信されます。All transactions committed before a sp_wait_for_database_copy_sync call are sent to the active secondary database.

Examples

次の例では、 sp_wait_for_database_copy_sync を呼び出して、すべてのトランザクションがプライマリデータベース db0 にコミットされていることを確認します。これは、ターゲットサーバー ubfyu5ssyt 上のアクティブなセカンダリデータベースに送信されます。The following example invokes sp_wait_for_database_copy_sync to ensure that all transactions are committed to the primary database, db0, get sent to its active secondary database on the target server ubfyu5ssyt.

USE db0;  
GO  
EXEC sys.sp_wait_for_database_copy_sync @target_server = N'ubfyu5ssyt1', @target_database = N'db0';  
GO  

参照See Also

dm_continuous_copy_status (Azure SQL Database) sys.dm_continuous_copy_status (Azure SQL Database)
Geo レプリケーションの動的管理ビュー (Dmv) と関数 (Azure SQL Database) Geo-Replication Dynamic Management Views (DMVs) and Functions (Azure SQL Database)
sys.dm_geo_replication_link_statussys.dm_geo_replication_link_status