Поделиться через


Хранимые процедуры репликации (Transact-SQL)

Область применения: SQL Server База данных SQL Azure

Системные хранимые процедуры репликации документированы и доступны для выполнения единовременных задач, таких как реализация репликации и применение пакетных файлов и скриптов.

Дополнительные сведения о программе большинства распространенных задач репликации с помощью хранимых процедур репликации см. в разделе "Основные понятия хранимых процедур системы репликации".

Внимание

Поддерживаются только хранимые процедуры репликации, описанные в электронной документации ПО SQL Server. Незадокументированные хранимые процедуры предназначены только для использования внутренних компонентов репликации и не должны использоваться для администрирования репликации.

Настройка публикации и распространения

Эти процедуры настраивают инфраструктуру репликации, в том числе распространители, издатели и базы данных распространителя.

Хранимая процедура Description
sp_adddistpublisher Регистрирует издателя на распространителю и указывает папку моментальных снимков по умолчанию для репликации.
sp_adddistributor Настраивает сервер в качестве распространителя для репликации, указав пароль для учетной записи distributor_admin .
sp_adddistributiondb Создает базу данных распространителя на распространителю с настраиваемыми периодами хранения.
sp_addlogreader_agent Создает задание агента чтения журналов для публикации транзакций.
sp_addpublication Создает новую публикацию моментальных снимков или транзакций в базе данных публикации.
sp_addpublication_snapshot Создает задание агента моментальных снимков для публикации.
sp_addqreader_agent Создает задание агента чтения очередей для распространителя, поддерживающего обновления в очереди подписки.
sp_changedistpublisher, хранимая процедура Изменяет свойства издателя, зарегистрированного на распространителю.
sp_changedistributiondb Изменяет свойства базы данных распространителя, включая периоды хранения.
sp_changedistributor_password Изменяет пароль, используемый для подключения между издателем и удаленным распространителем.
sp_changedistributor_property Изменяет свойства распространителя, такие как интервал пульса для проверок состояния агента.
sp_changepublication Изменяет свойства публикации моментальных снимков или транзакций.
sp_changepublication_snapshot Изменяет учетные данные безопасности или свойства планирования агента моментальных снимков.
sp_changelogreader_agent Изменяет свойства безопасности агента чтения журналов.
sp_changeqreader_agent Изменяет свойства безопасности агента чтения очередей.
sp_changereplicationserverpasswords Изменяет сохраненные пароли для учетной записи Windows или имени входа SQL Server, используемого агентами репликации при подключении к серверам в топологии репликации.
sp_dropdistpublisher Удаляет издателя из распространителя.
sp_dropdistributiondb Удаляет базу данных распространителя и связанные с ней задания репликации.
sp_dropdistributor Удаляет распространитель, удалив конфигурацию распространения.
sp_droppublication Удаляет публикацию и все статьи, связанные с ней.
sp_get_distributor Возвращает распространитель, установленный на сервере.
sp_get_redirected_publisher Возвращает перенаправленный издатель для базы данных издателя группы доступности.
sp_grant_publication_access Добавляет имя входа в список доступа к публикации.
sp_helpdistpublisher Возвращает свойства издателей, зарегистрированных на распространителю.
sp_helpdistributiondb Возвращает свойства указанной базы данных распространителя.
sp_helpdistributor Возвращает сведения о распространитее, базе данных распространителя и рабочем каталоге.
sp_helpdistributor_properties Возвращает свойства распространителя, такие как интервал пульса.
sp_helplogreader_agent Возвращает свойства задания агента чтения журналов.
sp_helppublication Возвращает сведения о публикации.
sp_helppublication_snapshot Возвращает сведения о задании агента моментальных снимков для публикации.
sp_helpqreader_agent Возвращает свойства агента чтения очередей.
sp_helpreplicationdboption Возвращает значение, включена ли репликация для базы данных.
sp_helpreplicationoption Возвращает параметры репликации, включенные на сервере.
sp_publisherproperty Возвращает или задает свойства издателя, отличного от SQL Server.
sp_redirect_publisher Указывает перенаправленный издатель для базы данных издателя группы доступности.
sp_replicationdboption Включает или отключает параметры публикации репликации для базы данных.
sp_revoke_publication_access Удаляет имя входа из списка доступа к публикации.
sp_validate_redirected_publisher Проверяет перенаправленный издатель для группы доступности.
sp_validate_replica_hosts_as_publishers Проверяет все узлы реплики в группе доступности для использования в качестве издателей.

Управление статьями репликации

Эти процедуры определяют, какие объекты базы данных публикуются и настраивают свойства статьи, такие как фильтрация.

Хранимая процедура Description
sp_addarticle Добавляет статью (таблицу, представление или хранимую процедуру) в публикацию моментальных снимков или транзакций.
sp_articlecolumn Определяет, какие столбцы следует включить или исключить из опубликованной статьи для вертикальной фильтрации.
sp_articlefilter Создает фильтр строк для статьи с помощью предложения WHERE.
sp_articleview Создает представление синхронизации для отфильтрованной статьи.
sp_changearticle Изменяет свойства существующей статьи в публикации.
sp_changearticlecolumndatatype Изменяет сопоставление типов данных столбца для статьи публикации Oracle.
sp_check_dynamic_filters Проверяет, использует ли публикация слияния параметризованные фильтры строк.
sp_check_for_sync_trigger Определяет, вызывается ли триггер в контексте синхронизации.
sp_check_join_filter Проверяет фильтр соединения между двумя таблицами, чтобы убедиться, что он может быть предварительно компьютирован.
sp_check_subset_filter Проверяет параметризованное предложение фильтра строк, чтобы убедиться, что он действителен.
sp_droparticle Удаляет статью из публикации моментальных снимков или транзакций.
sp_generatefilters Создает фильтры для дочерних статей на основе связей внешнего ключа.
sp_helparticle Отображает свойства статей в публикации.
sp_helparticlecolumns Возвращает все столбцы в базовой таблице для статьи.
sp_helparticledts Возвращает сведения о пользовательских именах задач, используемых с подписками DTS.

Управление подписками

Эти процедуры создают, изменяют и удаляют подписки на публикации, включая отправку и извлечение подписок.

Хранимая процедура Description
sp_addsubscription Создает подписку на публикацию моментальных снимков или транзакций на издателе.
sp_addsubscriber Регистрирует сервер в качестве подписчика и настраивает свойства подписчика.
sp_addsubscriber_schedule Добавляет расписание для агента распространителя или агента слияния.
sp_addpullsubscription Создает подписку на вытягивание на подписчике для публикации моментального снимка или публикации транзакций.
sp_addpullsubscription_agent Создает задание агента распространителя для подписки по запросу на подписчике.
sp_addpushsubscription_agent Создает задание агента распространителя для принудительной подписки на распространителю.
sp_addqueued_artinfo Добавляет сведения о статье в очередь, используемую в очереди для обновления подписок.
sp_addscriptexec Публикует скрипт SQL для выполнения на всех подписчиках публикации.
sp_addsynctriggers Создает триггеры синхронизации на подписчике для обновляемых подписок.
sp_attachsubscription Присоединяет существующую базу данных подписки к любому подписчику.
sp_change_subscription_properties Изменяет сведения о безопасности и параметры для подписки на вытягивание.
sp_changesubscriber Изменяет параметры подписчика, включая параметры подключения и расписания.
sp_changesubscriber_schedule Изменяет расписание агента распространителя или агента слияния для подписчика.
sp_changesubscription Изменяет свойства подписки моментального снимка или транзакции.
sp_changesubscriptiondtsinfo Изменяет свойства пакета DTS для подписки на отправку транзакций.
sp_changesubstatus Изменяет состояние существующей подписки на издателе.
sp_copysubscription Копирует базу данных подписки, которая содержит подписки на вытягивание, но не выполняет отправку подписок.
sp_droppullsubscription Удаляет подписку на вытягивание в базе данных подписчика.
sp_dropsubscriber Удаляет назначение подписчика с зарегистрированного сервера.
sp_dropsubscription Удаляет подписку на публикацию моментальных снимков или транзакций.
sp_expired_subscription_cleanup Удаляет истекшие анонимные подписки из публикаций.
sp_getqueuedrows Возвращает строки от подписчика, ожидающего обновления в очереди.
sp_getsubscriptiondtspackagename Возвращает имя пакета DTS для подписки.
sp_helpsubscriberinfo Возвращает сведения о подписчике.
sp_helpsubscription Возвращает сведения о подписке для публикации.
sp_helpsubscription_properties Возвращает сведения о безопасности для подписки.
sp_helppullsubscription Возвращает сведения о подписках на вытягивание на подписчике.
ссылка_на_публикацию Задает конфигурацию для немедленного обновления подписок при подключении к издателю.
sp_refreshsubscriptions Добавляет подписки в новые добавленные статьи для существующих подписок по запросу.
sp_reinitpullsubscription Помечает подписку на вытягивание для повторной инициализации при следующем запуске агента распространителя.
sp_reinitsubscription Помечает подписку push для повторной инициализации.
sp_setreplfailovermode Задает режим отработки отказа для обновляемой подписки.
sp_helpreplfailovermode Возвращает текущий режим отработки отказа подписки.
sp_subscription_cleanup Удаляет метаданные при удалении подписки с подписчика.

Репликация слиянием

Эти процедуры относятся к репликации слиянием, включая публикации слиянием, статьи, подписки и обработку конфликтов.

Хранимая процедура Description
sp_addmergealternatepublisher Добавляет возможность для подписчиков использовать альтернативный партнер синхронизации.
sp_addmergearticle Добавляет статью в публикацию слияния с параметрами фильтрации и разрешения конфликтов.
sp_addmergefilter Определяет фильтр соединения или связь логических записей между статьями в публикации слияния.
sp_addmergepartition Создает секцию для параметризованных фильтров строк, чтобы включить предварительно созданные моментальные снимки.
sp_addmergepublication Создает новую публикацию слияния с параметрами параметризованных фильтров.
sp_addmergepullsubscription Создает подписку на вытягивание на подписчике для публикации слияния.
sp_addmergepullsubscription_agent Создает задание агента слияния для подписки на вытягивание на подписчике.
sp_addmergepushsubscription_agent Создает задание агента слияния для принудительной подписки на распространителю.
sp_addmergesubscription Создает push-подписку или подписку на вытягивание в публикацию слияния.
sp_browsemergesnapshotfolder Возвращает путь к последнему моментальному снимку, созданному для публикации слияния.
sp_changemergearticle Изменяет свойства существующей статьи в публикации Merge.
sp_changemergefilter Изменяет существующую связь соединения или логическую запись.
sp_changemergepublication Изменяет свойства публикации слияния.
sp_changemergepullsubscription Изменяет свойства подписки на вытягивание слиянием.
sp_changemergesubscription Изменяет свойства принудительной подписки слиянием.
sp_copymergesnapshot Копирует папку моментального снимка в альтернативную папку.
sp_deletemergeconflictrow Удаляет строки из таблицы конфликтов слияния.
sp_dropmergealternatepublisher Удаляет альтернативного издателя из публикации слияния.
sp_dropmergearticle Удаляет статью из публикации слияния.
sp_dropmergefilter Удаляет фильтр соединения из публикации слияния.
sp_dropmergepartition Удаляет определение секции из публикации слияния с параметризованными фильтрами.
sp_dropmergepublication Удаляет публикацию слияния и связанный с ним агент моментальных снимков.
sp_dropmergepullsubscription Удаляет подписку на вытягивание слиянием в базе данных подписчика.
sp_dropmergesubscription Удаляет подписку на публикацию слияния и удаляет связанный агент слияния.
sp_getmergedeletetype Возвращает тип операции удаления слияния.
sp_helpmergealternatepublisher Возвращает список серверов, настроенных как альтернативные издатели.
sp_helpmergearticle Возвращает свойства статей в публикации слияния.
sp_helpmergearticlecolumn Возвращает список столбцов в статье публикации слиянием.
sp_helpmergearticleconflicts Возвращает сведения о таблице конфликтов для статей, которые столкнулись с конфликтами.
sp_helpmergeconflictrows Возвращает строки в указанной таблице конфликтов.
sp_helpmergedeleteconflictrows Возвращает строки данных, которые потеряли конфликты удаления.
sp_helpmergefilter Возвращает сведения о фильтрах слияния.
sp_helpmergepartition Возвращает сведения о секции для публикации слиянием.
sp_helpmergepublication Возвращает сведения о публикации слияния.
sp_helpmergepullsubscription Возвращает сведения о подписках merge pull.
sp_helpmergesubscription Возвращает сведения о подписках слиянием.
sp_mergearticlecolumn Секционирует публикацию слиянием по вертикали путем фильтрации столбцов.
sp_mergecleanupmetadata Очищает метаданные в системных таблицах после обслуживания с использованием периодов хранения.
sp_mergedummyupdate Помечает строку для повторного выполнения во время следующей синхронизации слиянием.
sp_mergemetadataretentioncleanup Вручную очищает метаданные в системных таблицах на основе периодов хранения.
sp_mergesubscription_cleanup Удаляет метаданные после удаления принудительной подписки слиянием.
sp_reinitmergepullsubscription Помечает подписку на слияние для повторной инициализации.
sp_reinitmergesubscription Помечает подписку слиянием для повторной инициализации.
sp_resyncmergesubscription Повторно выполняет повторную синхронизацию подписки слиянием в известное состояние проверки.
sp_restoremergeidentityrange Обновляет назначения диапазонов удостоверений после восстановления базы данных.
sp_showpendingchanges Возвращает ожидающие изменения, ожидающие репликации.
sp_showrowreplicainfo Отображает сведения об отслеживании строки в статье слиянием.

Профили агента репликации

Эти процедуры управляют профилями агентов, определяющими параметры, используемые агентами репликации.

Хранимая процедура Description
sp_add_agent_parameter Добавляет новый параметр в существующий профиль агента репликации.
sp_add_agent_profile Создает новый профиль агента для типа агента репликации.
sp_change_agent_parameter Изменяет значение существующего параметра в профиле агента.
sp_change_agent_profile Изменяет свойства существующего профиля агента репликации.
sp_drop_agent_parameter Удаляет параметр из профиля агента репликации.
sp_drop_agent_profile Удаляет определяемый пользователем профиль агента репликации.
sp_dropanonymousagent Удаляет анонимный агент, созданный для мониторинга подписки по запросу.
sp_getagentparameterlist Возвращает список допустимых параметров для типа агента репликации.
sp_help_agent_default Извлекает идентификатор профиля по умолчанию для указанного типа агента.
sp_help_agent_parameter Возвращает все параметры указанного профиля агента.
sp_help_agent_profile Возвращает сведения о профилях агента репликации.
sp_update_agent_profile Обновляет свойства профиля агента репликации.

Управление моментальными снимками

Эти процедуры управляют созданием моментальных снимков и доставкой для репликации.

Хранимая процедура Description
sp_adddynamicsnapshot_job Создает задание агента моментальных снимков, которое создает отфильтрованный моментальный снимок данных для раздела публикации слияния.
sp_browsesnapshotfolder Возвращает путь к последнему моментальному снимку, созданному для публикации.
sp_changedynamicsnapshot_job Изменяет параметры безопасности для отфильтрованного задания моментального снимка для раздела публикации слиянием.
sp_copysnapshot Копирует папку моментального снимка в указанную папку.
sp_dropdynamicsnapshot_job Удаляет параметризованное задание моментального снимка для раздела публикации слиянием.
sp_helpdynamicsnapshot_job Возвращает сведения о параметризованных заданиях моментальных снимков.
sp_resetsnapshotdeliveryprogress Сбрасывает процесс доставки моментальных снимков для подписки на вытягивание, чтобы ее можно было перезапустить.
sp_startpublication_snapshot Запускает задание агента моментальных снимков для публикации.

Мониторинг и проверка

Эти процедуры отслеживают производительность репликации и проверяют согласованность данных.

Хранимая процедура Description
sp_article_validation Инициирует проверку (количество строк или контрольную сумму) для одной статьи.
sp_browsereplcmds Возвращает результирующий набор реплицированных команд, хранящихся в базе данных распространителя.
sp_deletetracertokenhistory Удаляет записи журнала маркеров трассировки из базы данных распространителя.
sp_deletepeerrequesthistory Удаляет журнал запросов для запросов состояния одноранговой репликации.
sp_helptracertokenhistory Возвращает подробные сведения о задержке для маркеров трассировки.
sp_helptracertokens Возвращает сведения о маркерах трассировки, вставленных в публикацию.
sp_helpsubscriptionerrors Возвращает ошибки для репликации транзакций, хранящейся в базе данных распространителя.
sp_marksubscriptionvalidation Помечает текущую открытую транзакцию как транзакцию проверки на уровне подписки.
sp_posttracertoken Вставляет маркер трассировки в журнал транзакций для измерения задержки репликации.
sp_publication_validation Инициирует проверку для всех статей в публикации транзакций.
sp_replcounters Возвращает статистику репликации для каждой опубликованной базы данных.
sp_replmonitorchangepublicationthreshold Изменяет метрику порогового значения мониторинга для публикации.
sp_replmonitorhelpmergesession Возвращает сведения о прошлых сеансах агента слияния.
sp_replmonitorhelpmergesessiondetail Возвращает подробные сведения на уровне статьи о сеансе агента слияния.
sp_replmonitorhelppublication Возвращает сведения о мониторинге публикаций на распространителю.
sp_replmonitorhelppublicationthresholds Возвращает пороговые метрики, заданные для отслеживаемой публикации.
sp_replmonitorhelppublisher Возвращает текущие сведения о состоянии для одного или нескольких издателей.
sp_replmonitorhelpsubscription Возвращает сведения о мониторинге подписок.
sp_replmonitorsubscriptionpendingcmds Возвращает количество ожидающих команд для подписки.
sp_replqueuemonitor Возвращает сообщения очереди из очереди для подписки, обновляемой в очереди.
sp_table_validation Выполняет проверку количества строк или контрольной суммы в указанной таблице.
sp_validatemergepublication Помечает все подписки на публикацию слияния для проверки.
sp_validatemergesubscription Помечает определенную подписку слияния для проверки.

Одноранговая репликация

Эти процедуры относятся к одноранговой репликации транзакций.

Хранимая процедура Description
sp_configure_peerconflictdetection Настраивает обнаружение конфликтов для публикации одноранговых транзакций.
sp_gettopologyinfo Возвращает сведения о топологии одноранговой репликации.
sp_help_peerconflictdetection Возвращает сведения о параметре обнаружения конфликтов для публикации.
sp_helppeerrequests Возвращает сведения о запросах состояния, полученных в одноранговой топологии.
sp_helppeerresponses Возвращает все ответы на запрос состояния в одноранговой топологии.
sp_requestpeerresponse Запрашивает ответ от каждого другого узла в одноранговой топологии.
sp_requestpeertopologyinfo Собирает сведения о топологии одноранговой топологии репликации транзакций.

Изменения схемы и обслуживание

Эти процедуры обрабатывают изменения схемы, операции скриптов и обслуживания.

Хранимая процедура Description
sp_addtabletocontents Вставляет ссылки на отслеживание строк, которые в настоящее время не включены в таблицы отслеживания слиянием.
sp_adjustpublisheridentityrange Настраивает диапазон удостоверений для публикации и перераспределяет новые диапазоны на основе порогового значения.
sp_dsninfo Возвращает данные источника данных ODBC или OLE DB из распространителя.
sp_enumcustomresolvers Возвращает список всех доступных обработчиков бизнес-логики и пользовательских сопоставителей.
sp_enumdsn Возвращает список имен источников данных ODBC и OLE DB, определенных для сервера.
sp_enumeratependingschemachanges Возвращает список всех ожидающих изменений схемы.
sp_getdefaultdatatypemapping Возвращает сопоставление по умолчанию между SQL Server и типом базы данных, отличного от SQL Server.
sp_helpdatatypemap Возвращает сведения о сопоставлении определенных типов данных между БАЗАми данных SQL Server и базами данных, не являющихся SQL Server.
sp_helpxactsetjob Возвращает расписание заданий для задания Xactset.
sp_ivindexhasnullcols Проверяет, что кластеризованный индекс в индексируемом представлении не имеет столбцов, допускающих значение NULL.
sp_lookupcustomresolver Возвращает сведения о обработчике бизнес-логики или пользовательском сопоставителье.
sp_markpendingschemachange Помечает выбранные ожидающие изменения схемы, чтобы они не реплицировались.
sp_register_custom_scripting Регистрирует хранимую процедуру для выполнения при изменении схемы.
sp_registercustomresolver Регистрирует обработчик бизнес-логики или пользовательский сопоставитель для репликации слиянием.
sp_removedbreplication Удаляет все объекты репликации из базы данных.
sp_removedistpublisherdbreplication Удаляет метаданные публикации на распространителю.
sp_repladdcolumn Добавляет столбец в существующую таблицу, опубликованную.
sp_replcmds Возвращает команды для транзакций, помеченных для репликации из журнала.
sp_repldone Обновляет запись, которая идентифицирует последнюю распределенную транзакцию сервера.
sp_repldropcolumn Удаляет столбец из существующей статьи таблицы, опубликованной.
sp_replflush Очищает кэш статей.
sp_replication_agent_checkup Проверяет каждую базу данных распространителя для агентов репликации, не зарегистрированных в журнале.
sp_replrestart Сбрасывает удаленную репликацию транзакций.
sp_replsetoriginator Запрещает активацию обратного цикла в двунаправленной репликации транзакций.
sp_replshowcmds Возвращает команды для транзакций, помеченных для репликации в доступном для чтения формате.
sp_repltrans Возвращает все ожидающие репликацию транзакций в журнале базы данных публикации.
sp_restoredbreplication Удаляет параметры репликации при восстановлении базы данных на сервере, отличном от источника.
sp_schemafilter Изменяет фильтр схемы, используемый при перечислении таблиц Oracle, доступных для публикации.
sp_script_synctran_commands Создает скрипт для sp_addsynctriggers вызовов, применяемых на подписчиках.
sp_scriptdynamicupdproc Создает инструкцию CREATE PROCEDURE для хранимых процедур динамического обновления.
sp_scriptpublicationcustomprocs Скрипты пользовательских процедур для всех статей таблицы в публикации.
sp_scriptsubconflicttable Создает скрипт для создания таблицы конфликтов на подписчике.
sp_setdefaultdatatypemapping Помечает существующее сопоставление типов данных как стандартное.
sp_setsubscriptionxactseqno Указывает последнюю доставленную транзакцию для устранения неполадок.
sp_unregister_custom_scripting Удаляет определяемую пользователем пользовательскую хранимую процедуру или файл скрипта, зарегистрированный для изменений схемы.
sp_unregistercustomresolver Отменяет регистрацию модуля бизнес-логики из репликации слиянием.
sp_vupgrade_mergeobjects Повторно создает триггеры, хранимые процедуры и представления для репликации слиянием.
sp_vupgrade_replication Обновляет метаданные репликации при обновлении SQL Server.

Внутренние процедуры Майкрософт

Эти процедуры изменяют свойства агента на распространителю и используются внутренними агентами репликации.

Хранимая процедура Description
sp_MSchange_distribution_agent_properties Изменяет свойства задания агента распространителя, выполняющегося на распространителю.
sp_MSchange_logreader_agent_properties Изменяет свойства задания агента чтения журналов, выполняемого на распространителю.
sp_MSchange_merge_agent_properties Изменяет свойства задания агента слияния, выполняемого на распространителю.
sp_MSchange_snapshot_agent_properties Изменяет свойства задания агента моментальных снимков, запущенного на распространителю.