| title | sys.sp_rda_reauthorize_db (Transact-SQL) | Microsoft Docs | ||
|---|---|---|---|
| ms.custom | |||
| ms.date | 06/10/2016 | ||
| ms.prod | sql-non-specified | ||
| ms.reviewer | |||
| ms.suite | |||
| ms.technology |
|
||
| ms.tgt_pltfrm | |||
| ms.topic | language-reference | ||
| f1_keywords |
|
||
| dev_langs |
|
||
| helpviewer_keywords |
|
||
| ms.assetid | f6f3e4b2-8c72-4d23-a5de-fe671ca5c5cd | ||
| caps.latest.revision | 20 | ||
| author | douglaslMS | ||
| ms.author | douglasl | ||
| manager | jhubbard |
[!INCLUDEtsql-appliesto-ss2016-xxxx-xxxx-xxx_md]
Restores the authenticated connection between a local database enabled for Stretch and the remote database.
Transact-SQL Syntax Conventions
sp_rda_reauthorize_db @credential = @credential, @with_copy = @with_copy [ , @azure_servername = @azure_servername, @azure_databasename = @azure_databasename ]
@credential = @credential
Is the database scoped credential associated with the local Stretch-enabled database.
@with_copy = @with_copy
Specifies whether to make a copy of the remote data and connect to the copy (recommended). @with_copy is bit.
@azure_servername = @azure_servername
Specifies the name of the Azure server that contains the remote data. @azure_servername is sysname.
@azure_databasename = @azure_databasename
Specifies the name of the Azure database that contains the remote data. @azure_databasename is sysname.
0 (success) or >0 (failure)
Requires db_owner permissions.
When you run sys.sp_rda_reauthorize_db (Transact-SQL) to reconnect to the remote Azure database, this operation automatically resets the query mode to LOCAL_AND_REMOTE, which is the default behavior for Stretch Database. That is, queries return results from both local and remote data.
The following example restores the authenticated connection between a local database enabled for Stretch and the remote database. It makes a copy of the remote data (recommended) and connects to the new copy.
DECLARE @credentialName nvarchar(128);
SET @credentialName = N'<existing_database_scoped_credential_name>';
EXEC sp_rda_reauthorize_db @credential = @credentialName, @with_copy = 1;