Transact-SQL-Syntaxkonventionen (Transact-SQL)
Gilt für: SQL Server
Azure SQL-Datenbank
Azure SQL verwaltete Instanz
Azure Synapse Analytics
Platform System (PDW)
SQL Analytics Platform-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric Warehouse
In der folgenden Tabelle werden die Konventionen aufgeführt und beschrieben, die in den Syntaxdiagrammen in der Transact-SQL-Referenz verwendet werden.
Konvention | Verwendung |
---|---|
GROSSBUCHSTABEN | 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. |
| (senkrechter Strich) | 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. |
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 Stelle, an der der Syntaxblock verwendet werden könnte, wird durch die in spitze Klammern eingeschlossene Bezeichnung angezeigt: <label>. 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. |
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 gilt, bei der die Groß-/Kleinschreibung beachtet 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 Standardcodepage 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).
Am oberen Rand jedes Artikels befindet sich ein Abschnitt, der angibt, welche Produkte den Betreff 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 Anweisung CREATE USER
in einem SQL Server-Produkt, die Syntax WITH PASSWORD
kann jedoch nicht mit älteren Versionen verwendet werden. Zusätzliche Applies to-Abschnitte werden in den entsprechenden Argumentbeschreibungen in den Text des Artikels eingefügt.