Freigeben über

Transact-SQL-Syntaxkonventionen (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric

In der folgenden Tabelle werden die Konventionen aufgeführt und beschrieben, die in den Syntaxdiagrammen in der Transact-SQL-Referenz verwendet werden.

Konvention Verwendung
GROßBUCHSTABEN oder UPPERCASE Transact-SQL-Schlüsselwörter.
Kursiv Vom Benutzer anzugebende Parameter der Transact-SQL-Syntax.
Fett Geben Sie Datenbanknamen, Tabellennamen, Spaltennamen, Indexnamen, gespeicherte Prozeduren, Hilfsprogramme, Datentypnamen und Text genau wie angegeben ein.
| (vertikaler Balken) Trennt in eckigen oder geschweiften Klammern eingeschlossene Syntaxelemente. Sie können nur eines der Elemente verwenden.
[ ] (eckige Klammern) Optionales Syntaxelement
{ } (geschweifte Klammern) Erforderliche Syntaxelemente. Geben Sie die geschweiften Klammern nicht mit ein.
[ , ...n ] Zeigt an, dass das vorherige Element n -mal wiederholt werden kann. Die einzelnen Vorkommen werden durch Kommas getrennt.
[ ...n ] Zeigt an, dass das vorherige Element n -mal wiederholt werden kann. Die einzelnen Vorkommen werden durch Leerzeichen voneinander getrennt.
; Abschlusszeichen für Transact-SQL-Anweisungen. Dieses Abschlusszeichen ist für die meisten Anweisungen in dieser Version von SQL Server nicht erforderlich, jedoch in einer zukünftigen Version.
<label> ::= Der Name eines Syntaxblockes. Verwenden Sie diese Konvention zur Gruppierung und Bezeichnung von Abschnitten einer langen Syntax oder einer Syntaxeinheit, die Sie an mehreren Stellen innerhalb einer Anweisung verwenden können. Jede Position, an der der Syntaxblock verwendet werden kann, wird mit der Bezeichnung angegeben, die in Chevrons eingeschlossen ist: <Bezeichnung>.

Ein Set ist eine Sammlung von Ausdrücken, z. B. <Gruppierungssatz>. Eine Liste ist eine Sammlung von Sets, z. B. <Liste zusammengesetzter Elemente>.

Mehrteilige Namen

Wenn keine anderen Angaben vorliegen, können alle Transact-SQL-Referenzen auf den Namen eines Datenbankobjekts aus vier Teilen bestehende Namen im folgenden Format sein:

<server_name>.[<database_name>].[<schema_name>].<object_name>

| <database_name>.[<schema_name>].<object_name>

| <schema_name>.<object_name>

| <object_name>

  • server_name

    Gibt den Namen eines Verbindungs- oder Remoteservers an.

  • database_name

    Gibt den Namen einer SQL Server-Datenbank an, wenn sich das Objekt in einer lokalen Instanz von SQL Server befindet. Wenn sich das Objekt auf einem verknüpften Server befindet, wird mit database_name ein OLE DB-Katalog angegeben.

  • schema_name

    Gibt den Namen des Schemas an, das das Objekt enthält, wenn sich das Objekt in einer SQL Server-Datenbank befindet. Wenn sich das Objekt auf einem Verbindungsserver befindet, wird mit schema_name ein OLE DB-Schemaname angegeben.

  • object_name

    Gibt den Namen des Objekts an.

Wenn Sie auf ein bestimmtes Objekt verweisen, müssen Sie nicht immer den Server, die Datenbank und das Schema angeben, damit das Objekt vom SQL Server-Datenbank-Engine identifiziert werden kann. Wenn das Objekt jedoch nicht gefunden werden kann, wird ein Fehler zurückgegeben.

Um Fehler bei der Namensauflösung zu vermeiden, wird empfohlen, den Schemanamen bei jeder Angabe eines Objekts anzugeben, das Schemas als Bereiche besitzt.

Um Zwischenknoten wegzulassen, verwenden Sie Punkte, um diese Positionen anzuzeigen. In der folgenden Tabelle sind die gültigen Formate für Objektnamen aufgeführt.

Objektverweisformat Beschreibung
<server_name>.<database_name>.<schema_name>.<object_name> Vierteiliger Name.
<server_name>.<database_name>..<object_name> Der Schemaname wird weggelassen.
<server_name>..<schema_name>.<object_name> Der Datenbankname wird weggelassen.
<server_name>...<object_name> Der Datenbank- und der Schemaname werden weggelassen.
<database_name>.<schema_name>.<object_name> Der Servername wird weggelassen.
<database_name>..<object_name> Der Server- und der Schemaname werden weggelassen.
<schema_name>.<object_name> Der Server- und der Datenbankname werden weggelassen.
<object_name> Der Server-, der Datenbank- und der Schemaname werden weggelassen.

Datentypen

Wenn inline in einem Artikel verwendet wird, werden Datentypen in Klein- und Fettbuchstaben gerendert. Beispiel: "int", "varchar(255)" und "bit".

Bei Verwendung in Transact-SQL-Codeblöcken werden Datentypen in Großbuchstaben gerendert. Zum Beispiel:

DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;

Konventionen für Codebeispiele

Wenn nicht anders angegeben, wurden die Beispiele in der Transact-SQL-Referenz anhand von SQL Server Management Studio und den Standardeinstellungen für die folgenden Optionen getestet:

  • ANSI_NULLS
  • ANSI_NULL_DFLT_ON
  • ANSI_PADDING
  • ANSI_WARNINGS
  • CONCAT_NULL_YIELDS_NULL
  • QUOTED_IDENTIFIER

Die meisten Codebeispiele in der Transact-SQL-Referenz wurden auf Servern getestet, auf denen eine Sortierreihenfolge mit Groß-/Kleinschreibung ausgeführt wird. Auf den Testservern wurde in der Regel die ANSI/ISO-Codepage 1252 verwendet.

Vielen Codebeispielen gehen Unicode-Zeichenfolgenkonstanten mit dem Buchstaben N voran. Ohne das N-Präfix wird die Zeichenfolge in die Standardcodepage der Datenbank konvertiert. Diese Standardcodeseite erkennt möglicherweise bestimmte Zeichen nicht.

„Gilt für“-Verweise

Die Transact-SQL-Referenz enthält Artikel zu verschiedenen Versionen von SQL Server, beginnend mit SQL Server 2008 (10.0.x), sowie zu Azure SQL-Datenbank, Azure SQL Managed Instance, Azure Synapse Analytics und Analytics Platform System (PDW).

Ein Abschnitt oben in jedem Artikel gibt an, welche Produkte das Thema des Artikels unterstützen. Wenn ein Produkt fehlt, ist das im Artikel beschriebene Feature in diesem Produkt nicht verfügbar.

Der allgemeine Betreff des Artikels könnte auf ein Produkt zutreffen, aber in einigen Fällen werden nicht alle Argumente unterstützt. Beispielsweise wurden Benutzer für eigenständige Datenbank in SQL Server 2012 (11.x)eingeführt. Verwenden Sie die CREATE USER Anweisung in einem beliebigen SQL Server-Produkt. Die WITH PASSWORD Syntax kann jedoch nicht mit älteren Versionen verwendet werden. Zusätzliche Applies to sections are inserted into the appropriate argument descriptions in the body of the article.

Zugehöriger Inhalt