sys.sp_rda_set_query_mode (Transact-SQL)
適用対象: SQL Server 2016 (13.x) 以降のバージョン
現在の Stretch 対応データベースとそのテーブルに対するクエリで、ローカル データとリモート データ (既定値) の両方を返すか、ローカル データのみを返すかを指定します。
重要
拡張データベースは、SQL Server 2022 (16.x) および Azure SQL Database では非推奨になります。 この機能は、データベース エンジンの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。
構文
sp_rda_set_query_mode
[ @mode = ] @mode
[ , [ @force = ] @force ]
[ ; ]
引数
[ @mode = ] @mode
次のいずれかの値です。
DISABLED
Stretch 対応テーブルに対するすべてのクエリは失敗します。LOCAL_ONLY
Stretch 対応テーブルに対するクエリでは、ローカル データのみが返されます。LOCAL_AND_REMOTE
Stretch 対応テーブルに対するクエリでは、ローカル データとリモート データの両方が返されます。 これが既定の動作です。
[ @force = ] @force
検証なしでクエリ モードを変更する場合に 1 に設定できる省略可能な ビット 値。
リターン コードの値
0
(成功) または > 0
(失敗)。
アクセス許可
db_ownerのアクセス許可が必要です。
解説
次の拡張ストアド プロシージャでは、Stretch 対応データベースのクエリ モードも設定されます。
sp_rda_deauthorize_db
:実行
sp_rda_deauthorize_db
すると、Stretch 対応のデータベースとテーブルに対するすべてのクエリが失敗します。 つまり、クエリ モードは 〘 にDISABLED
設定されます。 このモードを終了するには、次のいずれかの操作を行います。sys.sp_rda_reauthorize_db (Transact-SQL) を実行して、リモート Azure データベースに再接続します。 この操作により、Stretch Database の既定の動作であるクエリ モード
LOCAL_AND_REMOTE
が自動的にリセットされます。 つまり、クエリはローカル データとリモート データの両方から結果を返します。引数を指定してsys.sp_rda_set_query_mode
LOCAL_ONLY
を実行して、ローカル データに対してのみクエリを引き続き実行できるようにします。
sp_rda_reauthorize_db
:sys.sp_rda_reauthorize_db (Transact-SQL) を実行してリモート Azure データベースに再接続すると、この操作により、Stretch Database の既定の動作であるクエリ モード
LOCAL_AND_REMOTE
が自動的にリセットされます。 つまり、クエリはローカル データとリモート データの両方から結果を返します。
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示