sys.sp_change_subscription_properties (Transact-SQL)

Dotyczy do:SQL ServerAzure SQL Managed Instance

Aktualizacje informacji o subskrypcjach pull. Ta procedura jest wykonywana przez abonenta w bazie subskrypcyjnej.

Transact-SQL konwencje składniowe

Syntax

sys.sp_change_subscription_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publication_type = ] publication_type ]
[ ; ]

Arguments

[ @publisher = ] N'publisher'

Nazwa wydawcy. @publisher to sysname, bez domyślnego ustawienia.

[ @publisher_db = ] N'publisher_db'

Nazwa bazy danych programu Publisher. @publisher_db to sysname, bez domyślnej nazwy.

[ @publication = ] N'publikacja'

Nazwa publikacji. @publication to sysname, bez domyślnego ustawienia.

[ @property = ] N'property'

Nieruchomość do zmiany. @property to sysname, bez domyślnego ustawienia.

[ @value = ] N'value'

Nowa wartość właściwości. @value to nvarchar(1000), bez domyślnego ustawienia.

[ @publication_type = ] publication_type

Określa typ replikacji publikacji. @publication_type to int, z domyślnym , NULLi może być jedną z następujących wartości:

Value Typ publikacji
0 Transakcyjny
1 Snapshot
2 Merge
NULL (domyślnie) Replikacja decyduje o rodzaju publikacji. Ponieważ procedura przechowywana musi przeglądać wiele tabel, ta opcja jest wolniejsza niż wtedy, gdy podano dokładny typ publikacji.

Ta tabela opisuje właściwości artykułów oraz wartości tych właściwości.

Property Value Opis
alt_snapshot_folder Określa lokalizację alternatywnego folderu migawki. Jeśli ustawiono na NULL, pliki migawki są pobierane z domyślnej lokalizacji określonej przez Publisher.
distrib_job_login Zaloguj się na konto Windows, na którym działa agent.
distrib_job_password Hasło do konta Windows, pod którym agent działa.
distributor_login Logowanie do dystrybutora.
distributor_password Hasło dystrybutora.
distributor_security_mode 1 Używaj uwierzytelniania Windows podczas łączenia z dystrybutorem.
0 Używaj uwierzytelniania SQL Server podczas łączenia z dystrybutorem.
dts_package_name Określa nazwę pakietu SQL Server 2000 Data Transformation Services (DTS). Wartość tę można określić tylko wtedy, gdy publikacja jest transakcyjna lub migawkowa.
dts_package_password Określa hasło na opakowaniu. dts_package_password jest sysname z domyślną wartością NULL, która określa, że właściwość hasła ma pozostać bez zmian. Wartość tę można określić tylko wtedy, gdy publikacja jest transakcyjna lub migawkowa.

Uwaga: Pakiet DTS musi mieć hasło.
dts_package_location Miejsce, gdzie przechowywany jest pakiet DTS. Wartość tę można określić tylko wtedy, gdy publikacja jest transakcyjna lub migawkowa.
dynamic_snapshot_location Określa ścieżkę do folderu, w którym zapisywane są pliki snapshotów. Wartość tę można określić tylko wtedy, gdy publikacja jest publikacją scalaną.
ftp_address Ten parametr jest wycofany i zachowany ze względu na kompatybilność wsteczną skryptów.
ftp_login Ten parametr jest wycofany i zachowany ze względu na kompatybilność wsteczną skryptów.
ftp_password Ten parametr jest wycofany i zachowany ze względu na kompatybilność wsteczną skryptów.
ftp_port Ten parametr jest wycofany i zachowany ze względu na kompatybilność wsteczną skryptów.
hostname Nazwa hosta używana podczas łączenia z Publisher.
internet_login Logowanie, którego używa Merge Agent podczas łączenia się z serwerem WWW, który hostuje synchronizację sieci za pomocą Basic Authentication.
internet_password Hasło, którego używa Merge Agent podczas łączenia się z serwerem WWW, który hostuje synchronizację sieci z wykorzystaniem Basic Authentication.
internet_security_mode 1 Użyj Windows Integrated Authentication do synchronizacji sieci. Zalecamy korzystanie z Basic Authentication z synchronizacją sieci. Więcej informacji można znaleźć w sekcji Konfiguruj synchronizację sieci.
0 Użyj Basic Authentication do synchronizacji sieci.

Uwaga: Synchronizacja sieci Web wymaga połączenia TLS z serwerem WWW.
internet_timeout Czas wygaśnięcia żądania synchronizacji sieci w sekundach.
internet_url URL, który reprezentuje lokalizację nasłuchiwacza replikacji do synchronizacji sieci.
merge_job_login Zaloguj się na konto Windows, na którym działa agent.
merge_job_password Hasło do konta Windows, pod którym agent działa.
publisher_login Logowanie Publisher. Zmiana publisher_login jest wspierana tylko w subskrypcjach łączących publikacje.
publisher_password Hasło Publisher. Zmiana publisher_password jest wspierana tylko w subskrypcjach łączących publikacje.
publisher_security_mode 5 Użyj uwierzytelniania zarządzanej tożsamości Microsoft Entra z domyślną zarządzaną tożsamością Subscriber podczas łączenia się z Publisher. Dotyczy tylko replikacji transakcyjnej, gdy zarówno Subscriber, jak i Publisher są zasobami Azure SQL Managed Instance.
1 Użyj uwierzytelniania systemu Windows podczas nawiązywania połączenia z programem Publisher. Zmiana publisher_security_mode jest wspierana tylko w subskrypcjach łączących publikacje.
0 Użyj uwierzytelniania programu SQL Server podczas nawiązywania połączenia z programem Publisher.
use_ftp true Aby odzyskać migawki, użyj FTP zamiast standardowego protokołu.
false Korzystaj ze standardowego protokołu do pobierania migawek.
use_web_sync true Włącz synchronizację sieci.
false Wyłącz synchronizację sieci.
working_directory Nazwa katalogu roboczego używanego do tymczasowego przechowywania plików danych i schematów do publikacji, gdy do transferu plików snapshot używany jest protokół File Transfer Protocol (FTP).

Zwracanie wartości kodu

0 (sukces) lub 1 (porażka).

Remarks

sp_change_subscription_properties jest stosowany we wszystkich typach replikacji.

sp_change_subscription_properties jest używany do subskrypcji pull.

Dla wydawców Oracle wartość @publisher_db jest pomijana, ponieważ Oracle pozwala tylko na jedną bazę danych na instancję serwera.

Permissions

Tylko członkowie roli stałego serwera systemowego lub stałej db_owner stałej bazy danych mogą wykonywać sp_change_subscription_properties.