sp_addpublication (języka Transact-SQL)

Argumenty

• [ @publication=] 'publication'
  Is the name of the publication to create.publication is sysname, with no default.Nazwa musi być unikatowa w bazie danych.

• [ @taskid=] taskid
  Obsługiwane zgodność z poprzednimi wersjami; Użyj sp_addpublication_snapshot (Transact-SQL).

• [ @restricted=] 'restricted'
  Obsługiwane zgodność z poprzednimi wersjami; Użyj default_access.

• [ @sync_method=] 'sync_method**'**
  Is the synchronization mode.sync_method is nvarchar(13), and can be one of the following values.

  Wartość	Description
  macierzysta	Generuje dane wyjściowe programu kopiowanie masowe trybu macierzystego wszystkich tabel.Nie jest obsługiwana dla Oracle wydawcy.
  znak	Generuje dane wyjściowe programu kopiowanie masowe tryb znakowy wszystkich tabel.Wydawca bazy danych Oracle, znak jest prawidłowa tylko w przypadku replikacja migawka.
  równoczesne	Generuje dane wyjściowe programu kopiowanie masowe trybu macierzystego wszystkich tabel, ale nie blokuje tabel podczas migawka.Obsługiwane tylko w przypadku publikacji transakcyjnych.Nie jest obsługiwana dla Oracle wydawcy.
  concurrent_c	Generuje dane wyjściowe programu kopiowanie masowe tryb znakowy wszystkich tabel, ale nie blokada tabel podczas migawka.Obsługiwane tylko w przypadku publikacji transakcyjnych.
  migawka bazy danych	Generuje dane wyjściowe programu kopiowanie masowe trybu macierzystego wszystkich tabel z migawka bazy danych.Ta opcja wymaga SQL Server Flaga.
  znak migawka bazy danych	Generuje dane wyjściowe programu kopiowanie masowe tryb znakowy wszystkich tabel z migawka bazy danych.Ta opcja wymaga SQL Server Flaga.
  NULL(default)	Defaults to native for Microsoft SQL Server Publishers.Dla innych niż-SQL Server Wydawcy, domyślnie: znak , gdy wartość repl_freq jest migawka and to concurrent_c we wszystkich innych przypadkach.

• [ @repl_freq=] 'repl_freq'
  Jest to typ częstotliwość replikacja repl_freq jest nvarchar(10), i może mieć jedną z następujących wartości.

  Wartość	Description
  ciągłe (domyślnie)	Wydawca oferuje wyjścia wszystkich opartego na dzienniku transakcji.Dla innych niż-SQL Server Wydawcy, to wymaga, aby sync_method zestaw concurrent_c.
  migawka	Wydawca tworzy tylko zdarzenia zaplanowanej synchronizacji.Dla innych niż-SQL Server Wydawcy, to wymaga, aby sync_method be zestaw to znak.

• [ @description=] 'description'
  Is an optional description for the publication.description is nvarchar(255), with a default of NULL.

• [ @status=] 'status'
  Specifies if publication data is available.status is nvarchar(8), and can be one of the following values.

  Wartość	Description
  aktywne	Dane publikacja jest dostępna dla subskrybentów natychmiast.
  nieaktywne (domyślnie)	Dane publikacja nie są dostępne dla subskrybentów, podczas tworzenia publikacja (można je subskrybować, ale subskrypcji nie są przetwarzane).

  Nie jest obsługiwana dla Oracle wydawcy.

• [ @independent_agent=] 'independent_agent'
  Specifies if there is a stand-alone Distribution Agent for this publication.independent_agent is nvarchar(5), with a default of FALSE.Jeśli wartość true, jest autonomiczny Agent dystrybucji dla tej publikacja.Jeśli FAŁSZ, publikacja wykorzystuje udostępniony agenta dystrybucji, a każda para bazy danych Wydawca bazy danych/subskrybent ma Agent jednym, udostępnionym.

• [ @immediate_sync=] 'immediate_synchronization'
  Specifies if the synchronization files for the publication are created each time the Snapshot Agent runs.immediate_synchronization is nvarchar(5), with a default of FALSE.Jeśli wartość true, synchronizacji pliki są tworzone lub utworzony ponownie przy każdym działa migawka Agent.Subskrybenci mogą pobrać pliki synchronizacji natychmiast, jeśli migawka Agent zostało ukończone przed utworzeniem subskrypcja.New subscriptions get the newest synchronization files generated by the most recent execution of the Snapshot Agent.independent_agent must be true for immediate_synchronization to be true.Jeśli FAŁSZ, synchronizacji pliki są tworzone tylko wtedy, gdy znajduje się na nim nowej subskrypcji.Należy wywołać sp_addsubscription dla każdej subskrypcja podczas stopniowego dodawania nowego artykuł do istniejącej publikacja.Subskrybenci nie mogą odbierać pliki synchronizacji po subskrypcja, aż agentów migawka zostaną uruchomione i zakończone.

• [ @enabled_for_internet=] 'enabled_for_internet'
  Specifies if the publication is enabled for the Internet, and determines if file transfer protocol (FTP) can be used to transfer the snapshot files to a subscriber.enabled_for_internet is nvarchar(5), with a default of FALSE.Jeśli wartość true, pliki synchronizacji w publikacja są umieszczane w katalogu C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.x\Repldata\Ftp.Użytkownik musi utworzyć katalogu FTP.

• [ @allow_push=] 'allow_push'
  Specifies if push subscriptions can be created for the given publication.allow_push is nvarchar(5), with a default of TRUE, which allows push subscriptions on the publication.

• [ @allow_pull=] 'allow_pull'
  Specifies if pull subscriptions can be created for the given publication.allow_pull is nvarchar(5), with a default of FALSE.Jeśli FAŁSZ, ściągać subskrypcji nie są dozwolone w publikacja.

• [ @allow_anonymous=] 'allow_anonymous'
  Specifies if anonymous subscriptions can be created for the given publication.allow_anonymous is nvarchar(5), with a default of FALSE.Jeśli wartość true, immediate_synchronization należy również zestaw do wartość true.Jeśli FAŁSZ, anonimowe subskrypcji nie są dozwolone w publikacja.

• [ @allow_sync_tran=] 'allow_sync_tran'
  Specifies if immediate-updating subscriptions are allowed on the publication.allow_sync_tran is nvarchar(5), with a default of FALSE.true is Not supported for Oracle Publishers.

• [ @autogen_sync_procs=] 'autogen_sync_procs'
  Specifies if the synchronizing stored procedure for updating subscriptions is generated at the Publisher.autogen_sync_procs is nvarchar(5), and can be one of the following values.

  Wartość	Description
  wartość true	zestaw automatycznie podczas aktualizowania subskrypcji jest włączona.
  FAŁSZ	zestaw automatycznie podczas aktualizowania subskrypcji nie jest włączona lub wydawcy bazy danych Oracle.
  NULL(default)	Domyślnie: wartość true podczas aktualizowania subskrypcji jest włączony i FAŁSZ podczas aktualizowania subskrypcji nie jest włączona.

  Uwaga

  The user supplied value for autogen_sync_procswill be overridden depending on the values specified for allow_queued_tran and allow_sync_tran.

• [ @retention=] retention
  Is the retention period in hours for subscription activity.retention is int, with a default of 336 hours.Jeśli subskrypcja nie jest aktywny w okresie zachowywania, wygasa i jest usuwany.Wartość może być późniejsza niż okres zachowywania maksymalną baza danych dystrybucji, używane przez Wydawca.Jeśli 0, dobrze znanych subskrypcji do publikacja nigdy nie wygasa i być usuwane przez agenta oczyszczania subskrypcja wygasła.

• [ @allow_queued_tran= ] 'allow_queued_updating'
  Enables or disables queuing of changes at the Subscriber until they can be applied at the Publisher.allow_queued_updating is nvarchar(5) with a default of FALSE.If false, changes at the Subscriber are not queued.true is Not supported for Oracle Publishers.

• [ @snapshot_in_defaultfolder= ] 'snapshot_in_default_folder'
  Specifies if snapshot files are stored in the default folder.snapshot_in_default_folder is nvarchar(5) with a default of TRUE.Jeśli wartość true, migawka pliki znajdują się w folderze domyślnym.Jeśli FAŁSZ, migawka pliki były przechowywane w innej lokalizacji określonej przez alternate_snapshot_folder. Alternatywnych lokalizacji może być na innym serwerze, na dysku sieciowym lub na nośniku wymiennym (np. dysku CD-ROM lub dyski wymienne).Można zapisać pliki migawkę w witrynie FTP do pobierania przez subskrybent w późniejszym czasie.Należy zauważyć, że ten parametr może mieć wartość true i nadal mieć miejsce w @ alt_snapshot_folder parametr.Określa, że ta kombinacja migawka pliki będą przechowywane w domyślnym i alternatywnych lokalizacji.

• [ @alt_snapshot_folder= ] 'alternate_snapshot_folder'
  Specifies the location of the alternate folder for the snapshot.alternate_snapshot_folder is nvarchar(255) with a default of NULL.

• [ @pre_snapshot_script= ] 'pre_snapshot_script'
  Specifies a pointer to an .sql file location.pre_snapshot_script is nvarchar(255),with a default of NULL.Agent dystrybucji uruchomi skryptu pre-migawka przed uruchomieniem tych skryptów replikowanych obiektów, stosując migawka na subskrybent.Skrypt jest wykonywany w kontekście zabezpieczeń, używana przez agenta dystrybucji podczas nawiązywania połączenia z bazą danych subskrypcja.

• [ @post_snapshot_script= ] 'post_snapshot_script'
  Specifies a pointer to an .sql file location.post_snapshot_script is nvarchar(255), with a default of NULL.Agent dystrybucji uruchomi post-migawka skryptu, po zastosowaniu wszystkich innych skryptów replikowanych obiektów i danych podczas wstępna synchronizacja.Skrypt jest wykonywany w kontekście zabezpieczeń, używana przez agenta dystrybucji podczas nawiązywania połączenia z bazą danych subskrypcja.

• [ @compress_snapshot= ] 'compress_snapshot'
  Specifies that the snapshot that is written to the @alt_snapshot_folder location is to be compressed into the Microsoft CAB format.compress_snapshot is nvarchar(5), with a default of FALSE.false specifies that the snapshot will not be compressed; true specifies that the snapshot will be compressed.Nie można skompresować pliki migawka, które są większe niż 2 gigabajty (GB).migawka skompresowane pliki są bez kompresji w miejscu, w której działa agent dystrybucji; subskrypcji ściąganej są zazwyczaj używane z migawkami skompresowany tak, aby pliki były nieskompresowanych przez subskrybent.Nie można skompresować migawkę w domyślnym folderze.

• [ @ftp_address = ] 'ftp_address'
  Is the network address of the FTP service for the Distributor.ftp_address is sysname, with a default of NULL.Określa, w którym znajdują się do dystrybucji Agent lub Scal agenta z publikacja migawka pliki subskrybent aby.Ponieważ ta właściwość jest przechowywana w każdej publikacji, każda publikacja może mieć inną ftp_address. Publikacja musi obsługiwać rozmnożeniowy migawki za pomocą protokołu FTP.

• [ @ftp_port= ] ftp_port
  Is the port number of the FTP service for the Distributor.ftp_port is int, with a default of 21.Określa, w którym znajdują się do dystrybucji Agent lub Scal agenta z pliki migawka publikacja subskrybent aby.Ponieważ ta właściwość jest przechowywana w każdej publikacja, każdą publikacja mogą mieć swoje własne ftp_port.

• [ @ftp_subdirectory = ] 'ftp_subdirectory'
  Specifies where the snapshot files will be available for the Distribution Agent or Merge Agent of subscriber to pick up if the publication supports propagating snapshots using FTP.ftp_subdirectory is nvarchar(255), with a default of NULL.Ponieważ ta właściwość jest przechowywana w każdej publikacja, każdą publikacja mogą mieć swoje własne ftp_subdirctory lub wybrać opcję, aby nie podkatalogu oznaczone wartości NULL.

• [ @ftp_login = ] 'ftp_login'
  Is the username used to connect to the FTP service.ftp_login is sysname, with a default of ANONYMOUS.

• [ @ftp_password = ] 'ftp_password'
  Is the user password used to connect to the FTP service.ftp_password is sysname, with a default of NULL.

• [ @allow_dts = ] 'allow_dts'
  Określa, że publikacja umożliwia przekształcenia danych.You can specify a DTS package when creating a subscription.allow_transformable_subscriptions is nvarchar(5) with a default of FALSE, which does not allow DTS transformations.Kiedy allow_dts ma wartość true, sync_method musi być ustawiona do obu character lub concurrent_c.

  wartość true is nie jest obsługiwana dla Oracle wydawcy.

• [ @allow_subscription_copy = ] 'allow_subscription_copy'
  Enables or disables the ability to copy the subscription databases that subscribe to this publication.allow_subscription_copy isnvarchar(5), with a default of FALSE.

• [ @conflict_policy = ] 'conflict_policy'
  Specifies the conflict resolution policy followed when the queued updating subscriber option is used.conflict_policy is nvarchar(100) with a default of NULL, and can be one of the following values.

  Wartość	Description
  pub wins	Wydawca zdobywa konfliktu.
  reinit podrzędny	Ponownie zainicjować subskrypcję.
  wins podrzędny	Subskrybent zdobywa konfliktu.
  NULL(default)	Jeśli NULL i publikacja jest publikacją migawka, staje się domyślną zasadę reinit podrzędny.Jeśli wartości NULL i publikacji nie jest publikacja migawka, staje się domyślnym pub wins.

  Nie jest obsługiwana dla Oracle wydawcy.

• [ @centralized_conflicts = ] 'centralized_conflicts'
  Specifies if conflict records are stored on the Publisher.centralized_conflicts is nvarchar(5), with a default of TRUE.Jeśli wartość true, konflikt rekordy są przechowywane w Wydawca.Jeśli FAŁSZ, konflikt rekordy są przechowywane w obu wydawcę i subskrybent, która spowodowała wystąpienie konfliktu.Nie jest obsługiwana dla Oracle wydawcy.

• [ @conflict_retention = ] conflict_retention
  Określa okres zachowywania konflikt w dniach.This is the period of time that conflict metadata is stored for peer-to-peer transactional replication and queued updating subscriptions.conflict_retention is int, with a default of 14.Nie jest obsługiwana dla Oracle wydawcy.

• [ @queue_type = ] 'queue_type'
  Specifies which type of queue is used.queue_type is nvarchar(10), with a default of NULL, and can be one of these values.

  Wartość	Description
  SQL	Użycie SQL Server do przechowywania transakcji.
  NULL(default)	Domyślnie: SQL, która określa, że należy używać SQL Server do przechowywania transakcji.

  Uwaga

  Obsługa przy użyciu Microsoft kolejkowanie wiadomości nie jest już. Określanie wartości usługa MSMQ spowoduje ostrzeżenie, a replikacja będzie automatycznie zestaw wartość SQL.

  Nie jest obsługiwana dla Oracle wydawcy.

• [ @add_to_active_directory = ] 'add_to_active_directory'
  Tego parametru została zastąpiona i jest obsługiwany tylko w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Nie można dodać informacji publikacja do Microsoft Usługa Active Directory.

• [ @logreader_job_name = ] 'logreader_agent_name'
  Is the name of an existing agent job.logreader_agent_name is sysname, with a default value of NULL.Ten parametr jest określony tylko Agent odczytywania dziennika będzie korzystania z istniejącego zadanie, zamiast nowe jeden tworzony.

• [ @qreader_job_name = ] 'queue_reader_agent_name'
  Is the name of an existing agent job.queue_reader_agent_name is sysname, with a default value of NULL.Ten parametr jest określony tylko Agent Reader kolejki będzie korzystania z istniejącego zadanie, zamiast nowe jeden tworzony.

• [ @publisher = ] 'publisher'
  Specifies a non-SQL Server publisher.publisher is sysname, with a default of NULL.

  Uwaga

  Wydawca nie powinny być używane, dodając do publikacjaSQL Server Wydawca.

• [ @allow_initialize_from_backup = ] 'allow_initialize_from_backup'
  Indicates if Subscribers can initialize a subscription to this publication from a backup rather than an initial snapshot.allow_initialize_from_backup is nvarchar(5), and can be one of these values:

  Wartość	Description
  wartość true	Umożliwia zainicjowanie z kopia zapasowa.
  FAŁSZ	Wyłącza inicjowania z kopia zapasowa.
  NULL(default)	Domyślnie: wartość true do publikacja w peer-to-peer topologia replikacja i FAŁSZ dla wszystkich innych publikacja.

  Aby uzyskać więcej informacji zobacz Inicjowanie transakcji subskrypcja bez migawka.

• [ @replicate_ddl = ] replicate_ddl
  Indicates if schema replication is supported for the publication.replicate_ddl is int, with a default of 1 for SQL Server Publishers and 0 for non-SQL Server Publishers.1 wskazuje, że są replikowane instrukcji języka (DDL) definicja danych wykonane po Wydawca, a 0 wskazuje, że instrukcje DDL nie są replikowane.*Replikacja schematu nie jest obsługiwana dla Oracle wydawcy.*Aby uzyskać więcej informacji zobacz Wprowadzanie zmian schematu na bazy danych w publikacja.

• [ @enabled_for_p2p = ] 'enabled_for_p2p'
  Enables the publication to be used in a peer-to-peer replication topology.enabled_for_p2p is nvarchar(5), with a default of FALSE.true indicates that the publication supports peer-to-peer replication.Podczas ustawiania enabled_for_p2p Aby wartość true, obowiązują następujące ograniczenia:

  • allow_anonymous musi być FAŁSZ.

  • allow_dts musi być FAŁSZ.

  • allow_initialize_from_backup musi być wartość true.

  • allow_queued_tran musi być FAŁSZ.

  • allow_sync_tran musi być FAŁSZ.

  • conflict_policy musi być FAŁSZ.

  • independent_agent musi być wartość true.

  • repl_freq musi być ciągłe.

  • replicate_ddl musi być 1.

  Aby uzyskać więcej informacji zobacz Typu peer-to-peer transakcyjne replikacja.

• [ @publish_local_changes_only = ] 'publish_local_changes_only'
  Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

• [ @enabled_for_het_sub= ] 'enabled_for_het_sub'
  Enables the publication to support non-SQL Server Subscribers.enabled_for_het_sub is nvarchar(5) with a default value of FALSE.Wartość true oznacza, że nie obsługuje publikacja-SQL Server Subskrybentów. Kiedy enabled_for_het_sub jest true, obowiązują następujące ograniczenia:

  • allow_initialize_from_backup musi być false.

  • allow_push musi być true.

  • allow_queued_tran musi być false.

  • allow_subscription_copy musi być false.

  • allow_sync_tran musi być false.

  • autogen_sync_procs musi być false.

  • conflict_policy musi mieć wartość NULL.

  • enabled_for_internet musi być false.

  • enabled_for_p2p musi być false.

  • ftp_address musi mieć wartość NULL.

  • ftp_subdirectory musi mieć wartość NULL.

  • ftp_password musi mieć wartość NULL.

  • pre_snapshot_script musi mieć wartość NULL.

  • post_snapshot_script musi mieć wartość NULL.

  • replicate_ddl musi mieć wartość 0.

  • qreader_job_name musi mieć wartość NULL.

  • queue_type musi mieć wartość NULL.

  • sync_method Nie można native lub concurrent.

  Aby uzyskać więcej informacji zobacz -SQL Server subskrybentów.

• [ @p2p_conflictdetection= ] 'p2p_conflictdetection'
  Enables the Distribution Agent to detect conflicts if the publication is enabled for peer-to-peer replication.p2p_conflictdetection is nvarchar(5) with a default value of TRUE.Aby uzyskać więcej informacji zobacz Wykrywanie konfliktów w replikacja równorzędna.

• [ @p2p_originator_id= ] p2p_originator_id
  Specifies an ID for a node in a peer-to-peer topology.p2p_originator_id is int, with a default of NULL.Jeśli ten identyfikator jest używany do wykrywanie konfliktów p2p_conflictdetection jest zestaw na wartość TRUE. Określ identyfikator dodatnią, różną od zera, który nigdy nie został użyty w topologii.Aby wyświetlić listę identyfikatorów, które już zostały użyte wykonać sp_help_peerconflictdetection.

• [ @p2p_continue_onconflict= ] 'p2p_continue_onconflict'
  Determines whether the Distribution Agent continues to process changes after a conflict is detected.p2p_continue_onconflict is nvarchar(5) with a default value of FALSE.

  Ostrzeżenie

  Firma Microsoft zaleca korzystanie z domyślnej wartości FALSE.Ta opcja jest wartość TRUE, Agent dystrybucji próbuje zostanie uzyskana zbieżność funkcji danych topologii stosując wiersza będące w konflikcie z węzła, który ma najwyższy identyfikator autora.Ta metoda nie gwarantuje zbieżności.Należy upewnić się, że po wykryciu konflikt topologii jest zgodny.Aby uzyskać więcej informacji zobacz temat "Obsługa konflikty" w Wykrywanie konfliktów w replikacja równorzędna.

• [ @allow_partition_switch= ] 'allow_partition_switch'
  Specifies whether ALTER TABLE…SWITCH statements can be executed against the published database.allow_partition_switch is nvarchar(5) with a default value of FALSE.Aby uzyskać więcej informacji zobacz Replikowanie podzielonym na partycje, tabele oraz indeksy.

• [ @replicate_partition_switch= ] 'replicate_partition_switch'
  Specifies whether ALTER TABLE…SWITCH statements that are executed against the published database should be replicated to Subscribers.replicate_partition_switch is nvarchar(5) with a default value of FALSE.Ta opcja jest prawidłowa tylko wtedy, gdy allow_partition_switch jest ustawiona na wartość TRUE.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_addpublication jest używana w przypadku replikacja migawka i replikacji transakcyjnej.

Jeśli istnieje wiele publikacji, publikowania tego samego obiektu bazy danych (tylko publikacje z replicate_ddl wartość 1 zreplikuje instrukcji ALTER tabela, ALTER VIEW, ALTER PROCEDURE, ALTER funkcja i instrukcje ALTER TRIGGER DDL.Jednak instrukcja ALTER tabela DROP kolumna DDL będzie replikowany przez wszystkich publikacji, które publikujesz porzuconych kolumna.

W języku DDL replikacja włączona)replicate_ddl = 1) publikacja tak aby nie replikowanie DDL zmiany do publikacja i sp_changepublication musi najpierw zostać wykonane zestaw replicate_ddl Aby 0.Po wydaniu instrukcje DDL bez replikacja sp_changepublication mogą być uruchamiane ponownie, aby włączyć replikację DDL.

Uprawnienia

Tylko członkowie sysadmin Rola serwera lub db_owner stała rola bazy danych może być wykonywany sp_addpublication.

See Also

Reference

Other Resources