sys.sp_rda_set_query_mode (Transact-SQL)

  • Article

S’applique à : SQL Server 2016 (13.x) et versions ultérieures

Spécifie si les requêtes sur la base de données Stretch actuelle et ses tables retournent des données locales et distantes (par défaut) ou des données locales uniquement.

Important

Stretch Database est déprécié dans SQL Server 2022 (16.x) et Azure SQL Database. Cette fonctionnalité sera supprimée dans une version future de moteur de base de données. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_rda_set_query_mode
    [ @mode = ] @mode
    [ , [ @force = ] @force ]
[ ; ]

Arguments

[ @mode = ] @mode

Une des valeurs suivantes :

  • DISABLED Toutes les requêtes sur les tables stretch échouent.

  • LOCAL_ONLY Les requêtes sur les tables stretch retournent uniquement les données locales.

  • LOCAL_AND_REMOTE Les requêtes sur des tables stretch retournent des données locales et distantes. C’est le paramétrage par défaut.

[ @force = ] @force

Valeur de bits facultative que vous pouvez définir sur 1 si vous souhaitez modifier le mode de requête sans validation.

Valeurs des codes de retour

0 (réussite) ou > 0 (échec).

Autorisations

Nécessite des autorisations db_owner .

Notes

Les procédures stockées étendues suivantes définissent également le mode de requête pour une base de données Stretch.

  • sp_rda_deauthorize_db:

    Une fois que vous avez exécuté sp_rda_deauthorize_db , toutes les requêtes sur des bases de données et des tables stretch échouent. Autrement dit, le mode de requête est défini sur DISABLED. Pour quitter ce mode, effectuez l’une des opérations suivantes.

    • Exécutez sys.sp_rda_reauthorize_db (Transact-SQL) pour vous reconnecter à la base de données Azure distante. Cette opération réinitialise automatiquement le mode LOCAL_AND_REMOTEde requête , qui est le comportement par défaut pour Stretch Database. Autrement dit, les requêtes retournent des résultats à partir de données locales et distantes.

    • Exécutez sys.sp_rda_set_query_mode avec l’argument LOCAL_ONLY pour permettre aux requêtes de continuer à s’exécuter sur des données locales uniquement.

  • sp_rda_reauthorize_db:

    Lorsque vous exécutez sys.sp_rda_reauthorize_db (Transact-SQL) pour vous reconnecter à la base de données Azure distante, cette opération réinitialise automatiquement le mode LOCAL_AND_REMOTEde requête , qui est le comportement par défaut pour Stretch Database. Autrement dit, les requêtes retournent des résultats à partir de données locales et distantes.

Contenu connexe