Partager via


sys.sp_rda_reauthorize_db (Transact-SQL)

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

Restaure la connexion authentifiée entre une base de données locale activée pour Stretch et la base de données distante.

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_reauthorize_db
    [ @credential = ] credential
      , [ @with_copy = ] with_copy
    [ , [ @azure_servername = ] azure_servername
      , [ @azure_databasename = ] azure_databasename ]
[ ; ]

Arguments

[ @credential = ] N’credential'

Informations d’identification étendues à la base de données associées à la base de données Stretch locale. @credential est sysname.

[ @with_copy = ] with_copy

Spécifie s’il faut effectuer une copie des données distantes et se connecter à la copie (recommandé). @with_copy est bit.

[ @azure_servername = ] azure_servername

Spécifie le nom du serveur Azure qui contient les données distantes. @azure_servername est sysname.

[ @azure_databasename = ] azure_databasename

Spécifie le nom de la base de données Azure qui contient les données distantes. @azure_databasename est sysname.

Valeurs des codes de retour

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

autorisations

Requiert les autorisations db_owner.

Notes

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.

Exemples

L’exemple suivant restaure la connexion authentifiée entre une base de données locale activée pour Stretch et la base de données distante. Il effectue une copie des données distantes (recommandées) et se connecte à la nouvelle copie.

DECLARE @credentialName NVARCHAR(128);

SET @credentialName = N'<existing_database_scoped_credential_name>';

EXEC sp_rda_reauthorize_db
    @credential = @credentialName,
    @with_copy = 1;