sp_attachsubscription (języka Transact-SQL)

Dołącza istniejący baza danych subskrypcja do dowolnego subskrybenta.Ta procedura składowana jest wykonywany nowy subskrybent na baza danych master.

Ważna informacjaWażne:

Ta funkcja jest niezalecane i zostaną usunięte w przyszłym wydaniu.Nie można użyć tej funkcji w nowych prac rozwojowych.Publikacji korespondencji seryjnej, które są podzielone na partycje przy użyciu filtrów sparametryzowana zaleca się korzystanie z nowych funkcji migawki podzielonym na partycje, które upraszczają inicjowanie dużą liczbę subskrypcji.Aby uzyskać więcej informacji, zobacz Migawki publikacji korespondencji seryjnej z filtrami sparametryzowana.Publikacje, które nie są na partycje, można zainicjować subskrypcja z kopia zapasowa.Aby uzyskać więcej informacji, zobacz Inicjowanie subskrypcji korespondencji seryjnej bez migawki i Inicjowanie transakcyjnych subskrypcję bez migawki.

Ikona łącza do tematuKonwencje składni Transact-SQL

Składnia

sp_attachsubscription [ @dbname = ] 'dbname'
        , [ @filename = ] 'filename'
    [ , [ @subscriber_security_mode = ] 'subscriber_security_mode' ]
    [ , [ @subscriber_login = ] 'subscriber_login' ]
    [ , [ @subscriber_password = ] 'subscriber_password' ]
    [ , [ @distributor_security_mode = ] distributor_security_mode ] 
    [ , [ @distributor_login = ] 'distributor_login' ] 
    [ , [ @distributor_password = ] 'distributor_password' ] 
    [ , [ @publisher_security_mode = ] publisher_security_mode ] 
    [ , [ @publisher_login = ] 'publisher_login' ] 
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ] 
    [ , [ @job_password = ] 'job_password' ] 
    [ , [ @db_master_key_password = ] 'db_master_key_password' ]

Argumenty

  • [ @dbname= ] 'dbname'
    Is the string that specifies the destination subscription database by name.dbname is sysname, with no default.

  • [ @filename= ] 'filename'
    Is the name and physical location of the primary MDF (master data file).filename is nvarchar(260), with no default.

  • [ @subscriber_security_mode= ] 'subscriber_security_mode'
    Is the security mode of the Subscriber to use when connecting to a Subscriber when synchronizing.subscriber_security_mode is int, with a default of NULL.

    Ostrzeżenie

    Należy używać uwierzytelniania systemu Windows.Jeśli subscriber_security_mode nie jest 1 (uwierzytelnianie systemu Windows), zwracany jest błąd.

  • [ @subscriber_login= ] 'subscriber_login'
    Is the Subscriber login name to use when connecting to a Subscriber when synchronizing.subscriber_login is sysname, with a default of NULL.

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywane jedynie-zgodności ze starszymi wersjami skryptów.Jeśli subscriber_security_mode nie jest 1 i subscriber_login jest określony, zostanie zwrócony błąd.

  • [ @subscriber_password= ] 'subscriber_password'
    Is the Subscriber password.subscriber_password is sysname, with a default of NULL.

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywane jedynie-zgodności ze starszymi wersjami skryptów.Jeśli subscriber_security_mode nie jest 1 i subscriber_password jest określony, zostanie zwrócony błąd.

  • [ @distributor_security_mode= ] distributor_security_mode
    Is the security mode to use when connecting to a Distributor when synchronizing.distributor_security_mode is int, with a default of 0.0 Określa SQL Server uwierzytelniania.1 Określa uwierzytelnianie systemu Windows.Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.

  • [ @distributor_login= ] 'distributor_login'
    Is the Distributor login to use when connecting to a Distributor when synchronizing.distributor_login is required if distributor_security_mode is set to 0.distributor_login is sysname, with a default of NULL.

  • [ @distributor_password= ] 'distributor_password'
    Is the Distributor password.distributor_password is required if distributor_security_mode is set to 0.distributor_password is sysname, with a default of NULL.Wartość distributor_password musi być mniejsze niż 120 znaków Unicode.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Nie należy używać pustego hasła.Należy używać silnego hasła.Jeśli to możliwe, monitują użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.

  • [ @publisher_security_mode= ] publisher_security_mode
    Is the security mode to use when connecting to a Publisher when synchronizing.publisher_security_mode is int, with a default of 1.Jeśli 0, określa SQL Server uwierzytelniania.Jeśli 1, określa uwierzytelnianie systemu Windows.Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.

  • [ @publisher_login= ] 'publisher_login'
    Is the login to use when connecting to a Publisher when synchronizing.publisher_login is sysname, with a default of NULL.

  • [ @publisher_password= ] 'publisher_password'
    Is the password used when connecting to the Publisher.publisher_password is sysname, with a default of NULL.Wartość publisher_password musi być mniejsze niż 120 znaków Unicode.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Nie należy używać pustego hasła.Należy używać silnego hasła.Jeśli to możliwe, monitują użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.

  • [ @job_login= ] 'job_login'
    Is the login for the Windows account under which the agent runs.job_login is nvarchar(257), with no default.To konto systemu Windows jest zawsze używana dla połączeń agenta do dystrybutora.

  • [ @job_password= ] 'job_password'
    Is the password for the Windows account under which the agent runs.job_password is sysname, with no default.Wartość job_password musi być mniejsze niż 120 znaków Unicode.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Jeśli to możliwe, monitują użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.

  • [ @db_master_key_password= ] 'db_master_key_password'
    Is the password of a user-defined Database Master Key.db_master_key_password is nvarchar(524), with a default value of NULL.Jeśli db_master_key_password nie jest określony, istniejącego klucza głównego bazy danych zostanie usunięty i utworzony.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Jeśli to możliwe, monitują użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

sp_attachsubscription w replikacja migawka, replikacja transakcyjna i scalania replikacji.

Jeśli do publikacja nie można dołączyć subskrypcja okres przechowywania publikacja wygasła.Jeśli określono subskrypcji z okresu czas retencji, gdy subskrypcja jest dołączony lub najpierw jest synchronizowane wystąpi błąd.Publikacje z okres przechowywania publikacja z 0 (nigdy nie wygasa) są ignorowane.

Uprawnienia

Tylko członkowie sysadmin stała rola serwera można wykonać sp_attachsubscription.