sp_helparticle (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Zeigt Informationen zu einem Artikel an. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt. Für Oracle-Verleger wird diese gespeicherte Prozedur auf dem Verteiler auf jeder Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_helparticle
    [ @publication = ] N'publication'
    [ , [ @article = ] N'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist "sysname" ohne Standard.

[ @article = ] N'article'

Der Name eines Artikels in der Publikation. @article ist "sysname" mit der Standardeinstellung "%. Wenn @article nicht angegeben wird, werden Informationen zu allen Artikeln für die angegebene Publikation zurückgegeben.

[ @returnfilter = ] Returnfilter

Gibt an, ob die Filterklausel zurückgegeben werden soll. @returnfilter ist Bit mit einem Standardwert von 1, der die Filterklausel zurückgibt.

[ @publisher = ] N'publisher'

Gibt einen Nicht-SQL Server-Herausgeber an. @publisher ist "sysname" mit der Standardeinstellung "NULL.

@publisher sollte nicht angegeben werden, wenn Informationen zu einem Artikel angefordert werden, der von einem SQL Server-Herausgeber veröffentlicht wurde.

[ @found = ] ausgabe gefunden

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Resultset

Spaltenname	Datentyp	BESCHREIBUNG
`article id`	int	ID des Artikels.
`article name`	sysname	Name des Artikels.
`base object`	nvarchar(257)	Name der zugrunde liegenden Tabelle, dargestellt durch den Artikel oder die gespeicherte Prozedur.
`destination object`	sysname	Name der Zieltabelle (Abonnement).
`synchronization object`	nvarchar(257)	Name der Sicht, die den veröffentlichten Artikel definiert.
`type`	smallint	Der Artikeltyp: `1` = Protokollbasiert. `3` = Protokollbasiert mit manuellem Filter. `5` = Protokollbasiert mit manueller Ansicht. `7` = Protokollbasiert mit manueller Filter- und manueller Ansicht. `8` = Ausführung der gespeicherten Prozedur. `24` = Serialisierbare Ausführung gespeicherter Prozeduren. `32` = Gespeicherte Prozedur (nur Schema). `64` = Ansicht (nur Schema). `96` = Aggregatfunktion (nur Schema). `128` = Funktion (nur Schema). `257` = Protokollbasierte indizierte Ansicht. `259` = Protokollbasierte indizierte Ansicht mit manuellem Filter. `261` = Protokollbasierte indizierte Ansicht mit manueller Ansicht. `263` = Protokollbasierte indizierte Ansicht mit manueller Filter- und manueller Ansicht. `320` = Indizierte Ansicht (nur Schema).
`status`	tinyint	Dies kann das Ergebnis und (Bitweise UND) einer oder mehrerer artikeleigenschaften sein: `0x00` = Nur zu Informationszwecken identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. `0x01` = Artikel ist aktiv. `0x08` = Fügen Sie den Spaltennamen in Einfügeanweisungen ein. `0x16` = Parametrisierte Anweisungen verwenden. `0x32` = Verwenden Sie parametrisierte Anweisungen, und fügen Sie den Spaltennamen in Einfügeanweisungen ein.
`filter`	nvarchar(257)	Die gespeicherte Prozedur, mit der die Tabelle horizontal gefiltert wird. Diese gespeicherte Prozedur muss mithilfe der `FOR REPLICATION` Klausel erstellt werden.
`description`	nvarchar(255)	Beschreibungseintrag für den Artikel.
`insert_command`	nvarchar(255)	Der Replikationsbefehlstyp, der zur Replikation von Einfügungen bei Tabellenartikeln verwendet wird. ¹
`update_command`	nvarchar(255)	Der Replikationsbefehlstyp, der zur Replikation von Updates bei Tabellenartikeln verwendet wird. ¹
`delete_command`	nvarchar(255)	Der Replikationsbefehlstyp, der zur Replikation von Löschungen bei Tabellenartikeln verwendet wird. ¹
`creation script path`	nvarchar(255)	Pfad und Name eines Artikelschemaskripts, mit dem Zieltabellen erstellt werden.
`vertical partition`	bit	Gibt an, ob die vertikale Partitionierung für den Artikel aktiviert ist; wobei ein Wert bedeutet `1` , dass die vertikale Partitionierung aktiviert ist.
`pre_creation_cmd`	tinyint	Precreation-Befehl für `DROP TABLE`, , `DELETE TABLE`oder `TRUNCATE TABLE`.
`filter_clause`	ntext	WHERE-Klausel für das horizontale Filtern.
`schema_option`	binary(8)	Bitmuster der Option zur Schemaerstellung für den angegebenen Artikel. Eine vollständige Liste der `schema_option` Werte finden Sie unter sp_addarticle.
`dest_owner`	sysname	Name des Besitzers des Zielobjekts.
`source_owner`	sysname	Besitzer des Quellobjekts.
`unqua_source_object`	sysname	Name des Quellobjekts, ohne den Namen des Besitzers.
`sync_object_owner`	sysname	Besitzer der Sicht, die den veröffentlichten Artikel definiert.
`unqualified_sync_object`	sysname	Name der Sicht, die den veröffentlichten Artikel definiert, ohne den Namen des Besitzers.
`filter_owner`	sysname	Besitzer des Filters.
`unqua_filter`	sysname	Name des Filters, ohne den Namen des Besitzers.
`auto_identity_range`	int	Flag, das anzeigt, ob die automatische Behandlung von Identitätsbereichen für die Veröffentlichung bei ihrer Erstellung aktiviert wurde. `1` bedeutet, dass der automatische Identitätsbereich aktiviert ist; `0` bedeutet, dass sie deaktiviert ist.
`publisher_identity_range`	int	Bereichsgröße des Identitätsbereichs im Publisher, wenn der Artikel auf `auto` " festgelegt oder `auto_identity_range` auf " `true`festgelegt ist`identityrangemanagementoption`.
`identity_range`	bigint	Bereichsgröße des Identitätsbereichs am Abonnenten, wenn der Artikel `identityrangemanagementoption` auf `auto` `true`.`auto_identity_range`
`threshold`	bigint	Prozentwert, der anzeigt, wann der Verteilungs-Agent einen neuen Identitätsbereich zuweist.
`identityrangemanagementoption`	int	Gibt die für den Artikel behandelte Identitätsbereichsverwaltung an.
`fire_triggers_on_snapshot`	bit	Gibt an, ob replizierte Benutzertrigger beim Anwenden der Anfangsmomentaufnahme ausgeführt werden. `1` = Benutzertrigger werden ausgeführt. `0` = Benutzertrigger werden nicht ausgeführt.

¹ Weitere Informationen finden Sie in den Transaktionsartikeln – Angeben, wie Änderungen weitergegeben werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helparticle wird in der Momentaufnahmereplikation und Transaktionsreplikation verwendet.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin , der db_owner festen Datenbankrolle oder die Publikationszugriffsliste für die aktuelle Publikation können ausgeführt werden sp_helparticle.

Beispiele

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksProductTran';

USE [AdventureWorks2022]
EXEC sp_helparticle
  @publication = @publication;
GO

Freigeben über