CREATE PROCEDURE (języka Transact-SQL)

Argumenty

• schema_name
  The OUTPUT variable must be defined when the procedure is created and also when the variable is used.

• procedure_name
  Nazwa nowej procedury składowanej.Nazwy procedur muszą być zgodne z regułami dotyczącymi identyfikatorów i muszą być unikatowe w bazie danych i w jej schemacie.

  Firma Microsoft zdecydowanie zaleca się nie używać prefiksu sp_ w nazwie procedury.The SQL Server clause is helpful when the parameters supplied to the procedure will not be typical, and when a new execution plan should not be cached or stored in memory. Aby uzyskać więcej informacji zobaczTworzenie procedur przechowywanych (aparat bazy danych).

  Tymczasowe procedury lokalne i globalne można tworzyć używając odpowiednio znaku krzyżyka (#) przed parametrem procedure_name (#procedure_name) dla tymczasowej procedury lokalnej lub dwóch znaków krzyżyka (##) dla tymczasowej procedury globalnej (##procedure_name).Nazw tymczasowych nie można określić dla procedur składowanych CLR.

  Pełna nazwa procedury składowanej lub tymczasowej procedury składowanej globalnej (wraz ze znakami ##) może składać się z maksymalnie 128 znaków.Pełna nazwa tymczasowej procedury składowanej lokalnej (wraz ze znakiem #) może składać się z maksymalnie 116 znaków.

• **;**number
  Opcjonalna liczba całkowita używana do grupowania procedur o tej samej nazwie.Takie zgrupowane procedury można razem porzucać, używając pojedynczej instrukcji DROP PROCEDURE.Na przykład aplikacja orders może używać procedur o nazwach orderproc;1, orderproc;2 itd.Instrukcja DROP PROCEDURE orderproc porzuca całą grupę.Jeśli nazwa zawiera ograniczone identyfikatory, liczba nie powinna występować jako część ogranicznika; należy użyć odpowiednich ograniczników tylko wokół parametru procedure_name.

  However, the table must exist when the procedure is executed.

  • Nie można używać XML lub CLR typów zdefiniowanych przez użytkownika, jak typy danych.

  • Using the EXECUTE AS clause

  Uwaga

  This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

• **@**parameter
  Parametr w procedurze.W instrukcji CREATE PROCEDURE można zadeklarować jeden lub więcej parametrów.Wartość każdego zadeklarowanego parametru musi być dostarczona przez użytkownika przy wywołaniu procedury, chyba że zdefiniowano wartość domyślna parametru lub ustawiono wartość równą innemu parametrowi.Procedura składowana może mieć maksymalnie 2 100 parametrów.Jeśli procedura zawiera parametry zwracające tabele i brakuje parametru w komórce, to domyślnie przekazywana jest pusta tabela.

  Określ nazwę parametru używając @ jako jej pierwszego znaku.Nazw parametru musi być zgodna z regułami dotyczącymi identyfikatorów.Parametry są lokalne dla procedury; te same nazwy parametrów mogą być używane w różnych procedurach.Domyślnie parametry mogą zastępować tylko wyrażenia stałe; nie mogą być używane zamiast nazw tabel, kolumn lub innych obiektów bazy danych.Aby uzyskać więcej informacji, zobacz EXECUTE (Transact-SQL).

  CREATE RULE (Transact-SQL)

• [ type_schema_name**.** ] data_type
  Creates an object called a rule.Wszystkie typy danych mogą być używane jako parametr dla Transact-SQL Procedura przechowywana. Aby zadeklarować parametr wycenione tabela, aby parametr dla za pomocą tabela zdefiniowaną przez użytkownika Transact-SQL Procedura przechowywana. Check constraints are created by using the CHECK keyword of CREATE TABLE or ALTER TABLE.The cursor data type can be used only on OUTPUT parameters.Po określeniu cursor Typ danych, słowa kluczowe VARYING i Wyjście musi być także określona. Może być określona z wielu parametrów wyjściowych cursor Typ danych.

  W przypadku środowiska CLR przechowywane procedury, CHAR, varchar, tekst, ntext, obraz, kursor, user define typy tabel i Tabela Nie można określić jako parametry.Aby uzyskać więcej informacji na temat zgodności między typami środowiska CLR i SQL Server System typów danych, zobacz Mapowanie danych parametru CLR. Aby uzyskać więcej informacji na temat SQL Server System typów danych i ich składni, zobacz Data Types (Transact-SQL).

  A rule can be any expression valid in a WHERE clause and can include elements such as arithmetic operators, relational operators, and predicates (for example, IN, LIKE, BETWEEN).

  Jeśli type_schema_name nie jest określony, SQL Server Database Engine odwołania type_name w następującej kolejności:

  • The SQL Server system data types.

  • Domyślny schemat bieżącego użytkownika w bieżącej bazie danych.

  • The dbo schema in the current database.

  Numerowane procedur przechowywanych typ danych nie może być xml lub zdefiniowany przez użytkownika typ danych CLR.

• VARYING
  Określa zestaw wyników obsługiwany jako parametr wyjściowy.Ten parametr jest konstruowany dynamicznie przez procedurę składowaną i jego zawartość może być różnaTa właściwość jest stosowana tylko do parametrów , cursor, .

• default
  Liczba odczytów fizycznej wykonywane ostatniego czas wyzwalacz został wykonany.Jeśli default wartość jest określona, procedury mogą być wykonywane bez określenia wartości dla parametru. db_backupoperator Operatorzy kopii zapasowych bazy danych % _ [] and [^].

  Uwaga

  Wartości domyślne są zapisywane w sys.Parameters.default kolumna tylko w przypadku procedury środowiska CLR.Ta kolumna będzie mieć wartość NULL dla Transact-SQL Parametry procedury.

• DANE WYJŚCIOWE
  Wskazuje, że jest to parametr wyjściowy.Wartość tej opcji może być zwrócona do wywołującej instrukcji EXECUTE.Użyj parametrów OUTPUT, aby zwrócić wartości obiektowi wywołującemu procedurę.Parametry text, ntext i image nie mogą być używane jako parametry OUTPUT, chyba że jest to procedura CLR.Parametr wyjściowy używający słowa kluczowego OUTPUT może być symbolem zastępczym kursora, chyba że jest to procedura CLR.Typ tabeli zdefiniowanej przez użytkownika nie może być określony jako parametr OUTPUT procedury składowanej.

• total_logical_writes
  Moduły zapisujące dane zablokowania bazy danychW poniższej tabela przedstawiono procedury przechowywane, które są używane do modyfikowania role bazy danych.

• RECOMPILE
  Wskazuje, że Database Engine nie nie pamięci podręcznej planu dla tej procedury i procedury jest skompilowany w czasie wykonywania. Dodaje użytkownika do bazy danych stała rola bazy danych.sp_helprole

  Aby nakazać Database Engine Aby odrzucić planów wykonania poszczególnych kwerend wewnątrz procedura przechowywana, należy użyć wskazówki dotyczącej kwerendy RECOMPILE. Aby uzyskać więcej informacji zobaczQuery Hints (Transact-SQL).sp_droprolemember

• SZYFROWANIE
  Wskazuje, że SQL Server przekonwertuje oryginalny tekst instrukcja CREATE PROCEDURE na format obfuscated. Dane wyjściowe obfuscation nie jest bezpośrednio widoczne w dowolnym z widoki wykazu w SQL Server. xoffsetJednak tekst będzie miał dostęp do uprzywilejowanych użytkowników, którzy mieli dostęp tabele systemowe przez DAC port lub bezpośrednio dostęp do plików bazy danych.Pokrewne dynamicznego zarządzania widoki i funkcje języka Transact-SQL)Aby uzyskać więcej informacji na temat uzyskiwania dostępu do metadane systemu Zobacz Konfiguracja widoczność metadane.

  Nazwa klasy.

  Procedury utworzone za pomocą tej opcji nie mogą być publikowane w ramach SQL Server replikacja.

• wykonać JAKO
  Zwraca nazwę identyfikator logowania użytkownika.

  Aby uzyskać więcej informacji zobaczEXECUTE AS Clause (Transact-SQL).

• Jest numerem identyfikacyjnym logowania użytkownika.
  Określa, że procedury składowane tworzone w celu replikacji nie mogą być wykonywane dla subskrybenta.Procedura składowana utworzona z opcją FOR REPLICATION jest używana jako filtr procedur składowanych i jest wykonywana tylko podczas replikacji.Nie można deklarować parametrów, jeśli określono opcję FOR REPLICATION.Opcji FOR REPLICATION nie można określić dla procedur składowanych CLR.Opcja RECOMPILE jest ignorowana dla procedur utworzonych z opcją FOR REPLICATION.

  Procedury dotyczące replikacja ma typu obiektu RF in sys.Objects and sys.Procedures.

• <sql_statement>
  Jedna lub więcej instrukcji Transact-SQL, które mają być zawarte w procedurze.Informacje o ograniczeniach, które mogą mieć zastosowanie można znaleźć w sekcji Uwagi.

• Nazwa EXTERNAL assembly_name**.** class_name**.method_name
  Określa metodę zestawu .NET Framework, do której odwołuje się procedura składowana CLR.Parametr class_name musi być prawidłowym identyfikatorem programu SQL Server, który istnieje jako klasa w zestawie.Jeśli klasa ma nazwę kwalifikowaną w obszarze nazw, w której występuje kropka (.) oddzielająca części obszaru nazw, to nazwa klas musi być wydzielona za pomocą nawiasów kwadratowych ([]) lub cudzysłowu (""**).Określona metoda musi być statyczna w danej klasie.

  Uwaga

  W następującym przykładzie polecenie wyświetla listę numer zadania dołączony do SQL Server harmonogram. Można tworzyć, modyfikować i upuszczać obiekty bazy danych, które odwołują się do modułów środowiska wykonawczego języka wspólnego, jednak nie można wykonać te odwołania w SQL Server dopóki nie zostanie włączone Opcja CLR włączone.The sys.dm_exec_query_transformation_statsdynamiczny widok zarządzania is identified for informational purposes only.

Remarks

Tworzy wirtualne tabela, która reprezentuje dane w jednej lub wielu tabel w alternatywny sposób.

CREATE VIEW musi być pierwszą instrukcją w instancji kwerendy.Tymczasowe procedury są wyjątek od tego, ponieważ są zawsze tworzone w tempdb.To nazwa widoku.Aby uzyskać więcej informacji na temat schematów zobacz User-Schema Separation.

Instrukcja CREATE PROCEDURE nie można łączyć z innymi Transact-SQL instrukcje w jednej partia.

Określanie nazwy właściciela widoku jest opcjonalne.Jeżeli wartość parametru NULL jest przekazywana i ten parametr jest używany w instrukcja CREATE tabela lub ALTER tabela, w których kolumna odwołania nie zezwala na wartości null, Database Engine generuje błąd. Nazwa kolumny jest wymagany tylko wtedy, gdy kolumna jest określany na podstawie wyrażenie arytmetyczne, funkcja, lub stała; po dwóch lub większej liczbie kolumn w przeciwnym razie może mieć takiej samej nazwie, zazwyczaj z powodu łączyć; lub, gdy kolumna w widoku jest określona nazwa różni się od kolumny, z którego pochodzi.

Zaleca się jawne określenie wartości NULL lub NOT NULL dla każdej kolumny w tabeli tymczasowej.Opcje ANSI_DFLT_ON i ANSI_DFLT_OFF wyznaczają sposób, w jaki program Database Engine przypisuje atrybuty NULL i NOT NULL do kolumn, jeśli atrybuty te nie zostały określone w instrukcji CREATE TABLE lub ALTER TABLE.Jeśli połączenie wykonuje procedurę składowaną z innymi ustawieniami tych opcji niż połączenie, które utworzyło procedurę, to kolumny tabeli utworzonej dla drugiego połączenia mogą mieć inne ustawienia dopuszczalności wartości null i przejawiać inne zachowanie.Jeśli atrybut NULL lub NOT NULL jest jawnie podany dla każdej kolumny, to tabele tymczasowe są tworzone przy użyciu tych samych ustawień dopuszczalności wartości null dla wszystkich połączeń wykonujących procedurę składowaną.

Czy instrukcja SELECT definiująca widok.

Klauzula ORDER BY nie gwarantuje zamówione wyniki, gdy widok jest kwerenda, ORDER BY również określono w samej kwerendzie.

Uzyskiwanie informacji dotyczących procedur składowanych

USE AdventureWorks;
GO
SELECT definition 
FROM sys.sql_modules 
JOIN sys.objects ON sys.sql_modules.object_id = sys.objects.object_id AND TYPE = 'P';

Ponadto wykonywanie instrukcji ALTER tabela niepowodzenie instrukcji na tabele uczestniczące w widokach, które mają wiązanie schematu, gdy instrukcje te mają wpływ na definicję widoku.

Widok może składać się maksymalnie z 1024 kolumn.

Parametry, które korzystają z typ danych kursor

Tymczasowych procedur przechowywanych

Automatyczne wykonywanie przechowywanych procedur

Zagnieżdżanie procedura przechowywana

<sql_statement> Ograniczenia

Uprawnienia

Wymaga CREATE PROCEDURE w bazie danych i ALTER uprawnienie dla schematu, w którym tworzony jest procedurą.

Procedury przechowywane CLR wymaga własność wirtualny plik dziennika, do którego odwołuje się <method_specifier>, lub materiały referencyjne uprawnienie do tego wirtualny plik dziennika.

Przykłady

A.Za pomocą prostego procedury

B.Za pomocą prostą procedurę z parametrami

C.Za pomocą prostą procedurę z parametrami symboli wieloznacznych

D.Zwraca więcej niż jeden wynik zestaw

USE AdventureWorks;
GO
CREATE PROCEDURE uspNResults 
AS
SELECT COUNT(ContactID) FROM Person.Contact
SELECT COUNT(CustomerID) FROM Sales.Customer;
GO

E.Korzystanie z parametrów wyjście

Product                                            List Price
-------------------------------------------------- ------------------
Road-750 Black, 58                                 539.99
Mountain-500 Silver, 40                            564.99
Mountain-500 Silver, 42                            564.99
...
Road-750 Black, 48                                 539.99
Road-750 Black, 52                                 539.99

(14 row(s) affected)

These items can be purchased for less than $700.00.

F.Za pomocą opcji WITH RECOMPILE

G.Za pomocą opcji WITH szyfrowanie

EXEC sp_helptext 'HumanResources.uspEncryptThis';

The text for object 'HumanResources.uspEncryptThis' is encrypted.

USE AdventureWorks;
GO
SELECT definition FROM sys.sql_modules
WHERE object_id = OBJECT_ID('HumanResources.uspEncryptThis');

definition
----------------------
NULL

(1 row(s) affected)

H.Za pomocą rozpoznawania nazw odroczenia

definition
-----------------------------------------------------------------------
CREATE PROCEDURE uspproc1
AS
    SELECT column1, column2 FROM table_does_not_exist

(1 row(s) affected)

I.Za pomocą wykonać AS klauzula

J.Tworzenie CLR procedura przechowywana

CREATE ASSEMBLY HandlingLOBUsingCLR
FROM '\\MachineName\HandlingLOBUsingCLR\bin\Debug\HandlingLOBUsingCLR.dll';
GO
CREATE PROCEDURE dbo.GetPhotoFromDB
(
    @ProductPhotoID int,
    @CurrentDirectory nvarchar(1024),
    @FileName nvarchar(1024)
)
AS EXTERNAL NAME HandlingLOBUsingCLR.LargeObjectBinary.GetPhotoFromDB;
GO

Wiersze mogą być tak szerokie, czasami dany operator nie może przetworzyć w wierszu.Za pomocą parametru WYJŚCIOWEGO kursor

See Also

Reference

Other Resources