Udostępnij za pośrednictwem

Transact-SQL konwencje składni (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punkt końcowy analizy SQL w usłudze Microsoft FabricMagazyn w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric (wersja zapoznawcza)

W poniższej tabeli wymieniono i opisano konwencje, które są używane na diagramach składniowych w dokumentacji Transact-SQL.

Convention Used for
WIELKIE LITERY lub UPPERCASE Transact-SQL keywords.
italic Podane przez użytkownika parametry składni Transact-SQL.
bold Wpisz nazwy baz danych, nazwy tabel, nazwy kolumn, nazwy indeksów, procedury składowane, narzędzia, nazwy typów danych i tekst dokładnie tak, jak pokazano.
| (pionowy pasek) Oddziela elementy składni ujęte w nawiasy klamrowe lub nawiasy klamrowe. Można użyć tylko jednego z elementów.
[ ] (nawiasy okrągłe) Opcjonalny element składni.
{ } (nawiasy klamrowe) Wymagane elementy składni. Nie należy wpisywać nawiasów klamrowych.
[ , ...n ] Wskazuje, że poprzedni element może być powtarzany określoną liczbę razy n. Wystąpienia są oddzielone przecinkami.
[ ...n ] Wskazuje, że poprzedni element może być powtarzany określoną liczbę razy n. Wystąpienia są oddzielone wartościami pustymi.
; terminator instrukcji Transact-SQL. Mimo że średnik nie jest wymagany dla większości instrukcji w tej wersji programu SQL Server, będzie on wymagany w przyszłej wersji.
<label> ::= Nazwa bloku składni. Ta konwencja służy do grupowania i etykietowania sekcji długiej składni lub jednostki składni, której można użyć w więcej niż jednej lokalizacji w instrukcji. Każda lokalizacja, w której można użyć bloku składni, jest wskazywana etykietą ujętą w cudzysłów: <etykieta>.

Zestaw to kolekcja wyrażeń, na przykład <zestaw> grupowania, a lista to kolekcja zestawów, na przykład <lista> elementów złożonych.

Multipart names

O ile nie określono inaczej, wszystkie Transact-SQL odwołania do nazwy obiektu bazy danych mogą być czteroczęściową nazwą w następującym formularzu:

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

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

| <schema_name>.<object_name>

| <object_name>

  • server_name

    Określa nazwę serwera połączonego lub nazwę serwera zdalnego.

  • database_name

    Określa nazwę bazy danych programu SQL Server, gdy obiekt znajduje się w lokalnym wystąpieniu programu SQL Server. Gdy obiekt znajduje się na serwerze połączonym, database_name określa katalog OLE DB.

  • schema_name

    Określa nazwę schematu, który zawiera obiekt, jeśli obiekt znajduje się w bazie danych programu SQL Server. Gdy obiekt znajduje się na serwerze połączonym, schema_name określa nazwę schematu OLE DB.

  • object_name

    Odwołuje się do nazwy obiektu.

Podczas odwoływania się do określonego obiektu nie zawsze trzeba określać serwer, bazę danych i schemat aparatu bazy danych programu SQL Server w celu zidentyfikowania obiektu. Jeśli jednak nie można odnaleźć obiektu, zwracany jest błąd.

Aby uniknąć błędów rozpoznawania nazw, zalecamy określenie nazwy schematu za każdym razem, gdy określisz obiekt o zakresie schematu.

Aby pominąć węzły pośrednie, użyj okresów, aby wskazać te pozycje. W poniższej tabeli przedstawiono prawidłowe formaty nazw obiektów.

Format odwołania do obiektu Description
<server_name>.<database_name>.<schema_name>.<object_name> Four-part name.
<server_name>.<database_name>..<object_name> Pominięto nazwę schematu.
<server_name>..<schema_name>.<object_name> Nazwa bazy danych została pominięta.
<server_name>...<object_name> Pominięto nazwę bazy danych i schematu.
<database_name>.<schema_name>.<object_name> Nazwa serwera zostanie pominięta.
<database_name>..<object_name> Pominięto nazwę serwera i schematu.
<schema_name>.<object_name> Pominięto nazwę serwera i bazy danych.
<object_name> Pominięto nazwę serwera, bazy danych i schematu.

Data types

W przypadku użycia wbudowanego w artykule typy danych są renderowane małymi literami i pogrubioną. Na przykład int, varchar(255)i bit.

W przypadku użycia w blokach kodu Transact-SQL typy danych są renderowane wielkimi literami. For example:

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

Przykładowe konwencje kodu

O ile nie określono inaczej, przykłady podane w dokumentacji Transact-SQL zostały przetestowane przy użyciu programu SQL Server Management Studio i jego domyślnych ustawień dla następujących opcji:

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

Większość przykładów kodu w dokumentacji Transact-SQL została przetestowana na serwerach, na których jest uruchamiana kolejność sortowania z uwzględnieniem wielkości liter. Serwery testowe zazwyczaj uruchamiały stronę kodową ANSI/ISO 1252.

Wiele przykładów kodu prefiksu Ciąg znaków Unicode stałe z literą N. Bez prefiksu N ciąg jest konwertowany na domyślną stronę kodową bazy danych. Ta domyślna strona kodowa może nie rozpoznawać niektórych znaków.

Odwołania "Dotyczy"

Artykuły referencyjne Transact-SQL obejmują wiele wersji programu SQL Server, począwszy od programu SQL Server 2008 (10.0.x), a także usług Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics i Analytics Platform System (PDW).

Sekcja w górnej części każdego artykułu wskazuje, które produkty obsługują temat artykułu. Jeśli produkt zostanie pominięty, funkcja opisana w artykule nie jest dostępna w tym produkcie.

Ogólny temat artykułu może być używany w produkcie, ale wszystkie argumenty nie są obsługiwane w niektórych przypadkach. Na przykład użytkownicy zawartej bazy danych zostali wprowadzeni w programie SQL Server 2012 (11.x). Użyj instrukcji CREATE USER w dowolnym produkcie programu SQL Server, ale WITH PASSWORD składnia nie może być używana ze starszymi wersjami. Dodatkowe zastosowanie do sekcji są wstawiane do odpowiednich opisów argumentów w treści artykułu.

Related content