sys.sp_rda_reauthorize_db (Transact-SQL)

  • Artículo

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores

Restaura la conexión autenticada entre una base de datos local habilitada para Stretch y la base de datos remota.

Importante

Stretch Database está en desuso en SQL Server 2022 (16.x) y Azure SQL Database. Esta característica se quitará en una versión futura del motor de base de datos. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_rda_reauthorize_db
    [ @credential = ] credential
      , [ @with_copy = ] with_copy
    [ , [ @azure_servername = ] azure_servername
      , [ @azure_databasename = ] azure_databasename ]
[ ; ]

Argumentos

[ @credential = ] N'credential'

Credencial con ámbito de base de datos asociada a la base de datos habilitada para Stretch local. @credential es sysname.

[ @with_copy = ] with_copy

Especifica si se va a realizar una copia de los datos remotos y conectarse a la copia (recomendado). @with_copy es bit.

[ @azure_servername = ] azure_servername

Especifica el nombre del servidor de Azure que contiene los datos remotos. @azure_servername es sysname.

[ @azure_databasename = ] azure_databasename

Especifica el nombre de la base de datos de Azure que contiene los datos remotos. @azure_databasename es sysname.

Valores de código de retorno

0 (correcto) o > 0 (erróneo).

Permisos

Requiere permisos de db_owner.

Comentarios

Al ejecutar sys.sp_rda_reauthorize_db (Transact-SQL) para volver a conectarse a la base de datos remota de Azure, esta operación restablece automáticamente el modo de consulta a LOCAL_AND_REMOTE, que es el comportamiento predeterminado de Stretch Database. Es decir, las consultas devuelven resultados de datos locales y remotos.

Ejemplos

En el ejemplo siguiente se restaura la conexión autenticada entre una base de datos local habilitada para Stretch y la base de datos remota. Realiza una copia de los datos remotos (recomendados) y se conecta a la nueva copia.

DECLARE @credentialName NVARCHAR(128);

SET @credentialName = N'<existing_database_scoped_credential_name>';

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

Contenido relacionado