Delen via

sp_change_log_shipping_primary_database (Transact-SQL)

Van toepassing op:SQL Server

Hiermee wijzigt u de primaire database-instellingen.

Transact-SQL syntaxis-conventies

Syntaxis

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'backup_share' ]
    [ , [ @backup_retention_period = ] 'backup_retention_period' ]
    [ , [ @monitor_server_security_mode = ] 'monitor_server_security_mode' ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @backup_threshold = ] 'backup_threshold' ]
    [ , [ @threshold_alert = ] 'threshold_alert' ]
    [ , [ @threshold_alert_enabled = ] 'threshold_alert_enabled' ]
    [ , [ @history_retention_period = ] 'history_retention_period' ]
    [ , [ @backup_compression = ] backup_compression_option ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumenten

[ @database = ] 'database'

De naam van de database op de primaire server. @primary_database is sysname, zonder standaardinstelling.

[ @backup_directory = ] N'backup_directory'

Het pad naar de back-upmap op de primaire server. @backup_directory is nvarchar(500), zonder standaardinstelling en kan dit niet zijn NULL.

[ @backup_share = ] N'backup_share'

Het netwerkpad naar de back-upmap op de primaire server. @backup_share is nvarchar(500), zonder standaardinstelling en kan dit niet zijn NULL.

[ @backup_retention_period = ] 'backup_retention_period'

De tijdsduur, in minuten, voor het bewaren van het logboekback-upbestand in de back-upmap op de primaire server. @backup_retention_period is int, zonder standaard, en kan dat niet zijn NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

De beveiligingsmodus die wordt gebruikt om verbinding te maken met de monitorserver.

  • 1 = Windows-verificatie
  • 0 = SQL Server-verificatie

@monitor_server_security_mode is bit en wordt standaard ingesteld op NULL.

[ @monitor_server_login = ] 'monitor_server_login'

De gebruikersnaam van het account dat wordt gebruikt voor toegang tot de monitorserver.

[ @monitor_server_password = ] 'monitor_server_password'

Het wachtwoord van het account dat wordt gebruikt voor toegang tot de monitorserver.

[ @backup_threshold = ] 'backup_threshold'

De tijdsduur, in minuten, na de laatste back-up voordat een @threshold_alert fout wordt gegenereerd. @backup_threshold is int, met een standaardwaarde van 60 minuten.

[ @threshold_alert = ] 'threshold_alert'

De waarschuwing die moet worden gegenereerd wanneer de drempelwaarde voor de back-up wordt overschreden. @threshold_alert is int en kan niet zijn NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Hiermee geeft u op of er een waarschuwing wordt gegenereerd wanneer @backup_threshold wordt overschreden.

  • 1:Ingeschakeld
  • 0:invalide

threshold_alert_enabled is bit en kan dat niet zijn NULL.

[ @history_retention_period = ] 'history_retention_period'

De tijdsduur in minuten waarin de geschiedenis wordt bewaard. @history_retention_period is int. Er wordt een waarde van 14420 gebruikt als er geen is opgegeven.

[ @backup_compression = ] backup_compression_option

Hiermee geeft u op of een configuratie voor logboekverzending back-upcompressie gebruikt. Deze parameter wordt ondersteund in enterprise-editie voor SQL Server 2008 (10.0.x) (en latere versies) en alle edities op SQL Server 2016 (13.x) met Service Pack 1 (en latere versies).

[ @monitor_connection_options = ] '<key_value_pairs>;[ ...]'

Van toepassing op: SQL Server 2025 (17.x) Preview en latere versies

Hiermee geeft u aanvullende connectiviteitsopties voor de gekoppelde serververbinding bij gebruik van een externe monitor, in de vorm van sleutel-waardeparen. @monitor_connection_options is nvarchar(4000) en heeft de standaardwaarde NULL.

De volgende tabel bevat de beschikbare connectiviteitsopties:

Key Value
Encrypt strict mandatory, optional, truefalse
TrustServerCertificate true,false,yes,no
ServerCertificate Pad op het bestandssysteem naar het servercertificaat. Dit heeft een maximale lengte van 260 tekens.
HostNameInCertificate Hostnaam overschrijven voor het certificaat. Dit heeft een maximale lengte van 255 tekens.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Geen.

Opmerkingen

sp_change_log_shipping_primary_database moet worden uitgevoerd vanuit de master database op de primaire server. Deze opgeslagen procedure doet het volgende:

  1. Wijzig indien nodig de instellingen in de log_shipping_primary_database record.

  2. Wijzigt de lokale record log_shipping_monitor_primary op de primaire server met behulp van opgegeven argumenten, indien nodig.

  3. Als de monitorserver verschilt van de primaire server, verandert de record log_shipping_monitor_primary op de monitorserver met behulp van opgegeven argumenten, indien nodig.

Machtigingen

Alleen leden van de vaste serverrol sysadmin kunnen deze procedure uitvoeren.

Voorbeelden

In dit voorbeeld ziet u het gebruik van het bijwerken van sp_change_log_shipping_primary_database de instellingen die zijn gekoppeld aan de primaire database AdventureWorks2022.

EXECUTE master.dbo.sp_change_log_shipping_primary_database
    @database = N'AdventureWorks',
    @backup_directory = N'c:\LogShipping',
    @backup_share = N'\\tribeca\LogShipping',
    @backup_retention_period = 1440,
    @backup_threshold = 60,
    @threshold_alert = 0,
    @threshold_alert_enabled = 1,
    @history_retention_period = 1440,
    @monitor_server_security_mode = 1,
    @backup_compression = 1;

Verwante inhoud